Method clearAll

app/src/API/Handlers/WorkspacesHandler.cpp:852–897

* @brief Wipes every workspace in one shot. Leaves customize mode on with an empty list. */

 * @brief Wipes every workspace in one shot. Leaves customize mode on with an empty list.
 */
API::CommandResponse API::Handlers::WorkspacesHandler::clearAll(const QString& id,
                                                                const QJsonObject& params)
{
  if (!inProjectFileMode())
    return CommandResponse::makeError(
      id, ErrorCode::InvalidParam, QStringLiteral("Workspace mutations require ProjectFile mode"));

  const bool isDryRun = params.value(QStringLiteral("dryRun")).toBool(false);

  auto& pm = DataModel::ProjectModel::instance();

  const auto& active = pm.activeWorkspaces();
  QJsonArray wouldDelete;
  for (const auto& ws : active) {
    QJsonObject row;
    row[QStringLiteral("id")]          = ws.workspaceId;
    row[QStringLiteral("title")]       = ws.title;
    row[QStringLiteral("widgetCount")] = static_cast<int>(ws.widgetRefs.size());
    wouldDelete.append(row);
  }

  const int previousCount = static_cast<int>(pm.editorWorkspaces().size());
  if (!isDryRun)
    pm.clearAllWorkspaces();

  QJsonObject result;
  if (isDryRun) {
    result[QStringLiteral("dryRun")] = true;
    result[QStringLiteral("warning")] =
      QStringLiteral("DRY RUN: nothing was cleared. Re-call without dryRun:true to commit. "
                     "wouldDelete[] enumerates every workspace that would be removed.");
    result[QStringLiteral("wouldDelete")] = wouldDelete;
    result[QStringLiteral("cleared")]     = 0;
    result[QStringLiteral("remaining")]   = previousCount;
  } else {
    result[QStringLiteral("cleared")]   = previousCount;
    result[QStringLiteral("remaining")] = static_cast<int>(pm.editorWorkspaces().size());
    result[QStringLiteral("deleted")]   = wouldDelete;
  }

  result[QStringLiteral("hint")] = QStringLiteral(
    "All workspaces removed; customize mode is on. Call project.workspace.autoGenerate "
    "to recreate the default Overview/AllData/per-group layout, or build a custom layout "
    "with project.workspace.add + project.workspace.addWidget.");
  return CommandResponse::makeSuccess(id, result);
}

/**
 * @brief Renames a workspace. No-op if id not found.