Method saveJsonFile

app/src/DataModel/ProjectModel.cpp:1839–1890

* @brief Validates and saves the project, optionally prompting for a path; the * path-accepted handler defers via a queued invoke because the macOS NSSavePanel * KVO callback must unwind before re-entering the model. */

 * KVO callback must unwind before re-entering the model.
 */
bool DataModel::ProjectModel::saveJsonFile(const bool askPath)
{
  if (!validateProject(m_suppressMessageBoxes))
    return false;

  if (jsonFilePath().isEmpty() || askPath) {
    auto* dialog = new QFileDialog(qApp->activeWindow(),
                                   tr("Save Serial Studio Project"),
                                   jsonProjectsPath() + "/" + title() + ".ssproj",
                                   tr("Serial Studio Project Files (*.ssproj)"));

    dialog->setAcceptMode(QFileDialog::AcceptSave);
    dialog->setFileMode(QFileDialog::AnyFile);
    dialog->setAttribute(Qt::WA_DeleteOnClose);

    auto accepted = std::make_shared<bool>(false);
    connect(dialog, &QFileDialog::fileSelected, this, [this, accepted](const QString& path) {
      if (path.isEmpty())
        return;

      *accepted = true;

      QMetaObject::invokeMethod(
        this,
        [this, path]() {
          QString finalPath = path;
          if (!finalPath.endsWith(QStringLiteral(".ssproj"), Qt::CaseInsensitive))
            finalPath += QStringLiteral(".ssproj");

          const QString chosenTitle = QFileInfo(finalPath).completeBaseName();
          if (m_title == tr("Untitled Project") && !chosenTitle.isEmpty()
              && chosenTitle != m_title) {
            m_title = chosenTitle;
            Q_EMIT titleChanged();
          }

          m_filePath = finalPath;
          (void)finalizeProjectSave();
        },
        Qt::QueuedConnection);
    });

    connect(dialog, &QFileDialog::finished, this, [this, accepted](int) {
      Q_EMIT saveDialogCompleted(*accepted);
    });

    dialog->open();
    return false;
  }

  return finalizeProjectSave();
}

/**
 * @brief Headless save to the given path (no file dialog).