Rename IfcViewerFull to Bonsai Viewer

Directory src/ifcviewer-full -> src/bonsaiviewer, CMake target IfcViewerFull -> BonsaiViewer, namespace ifcviewerfull -> bonsaiviewer, QApplication / window titles / connector path now use the new brand. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-09-12 06:32:09 +00:00 · 2026-05-20 09:38:10 +10:00
parent fcae3d90af
commit 59e5b2b1b8
125 changed files with 308 additions and 308 deletions
@@ -0,0 +1,671 @@
+// This file was generated with the assistance of an AI coding tool.
+/********************************************************************************
+ *                                                                              *
+ * This file is part of IfcOpenShell.                                           *
+ *                                                                              *
+ * IfcOpenShell is free software: you can redistribute it and/or modify         *
+ * it under the terms of the Lesser GNU General Public License as published by  *
+ * the Free Software Foundation, either version 3.0 of the License, or          *
+ * (at your option) any later version.                                          *
+ *                                                                              *
+ * IfcOpenShell is distributed in the hope that it will be useful,              *
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of               *
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the                 *
+ * Lesser GNU General Public License for more details.                          *
+ *                                                                              *
+ * You should have received a copy of the Lesser GNU General Public License     *
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.         *
+ *                                                                              *
+ ********************************************************************************/
+
+#include "Commands.h"
+
+#include "SaveProjectDialog.h"
+
+#include "../../ElementRegistry.h"
+#include "../../SessionState.h"
+#include "../connectors/PickerDialog.h"
+#include "../connectors/Process.h"
+#include "../connectors/Registry.h"
+#include "../models/Commands.h"
+#include "../../../ifcviewer/Federation.h"
+#include "../../../ifcviewer/SceneLoader.h"
+#include "../../../ifcviewer/ViewportWindow.h"
+
+#include <QDebug>
+#include <QDir>
+#include <QFileDialog>
+#include <QFileInfo>
+#include <QHash>
+#include <QJsonArray>
+#include <QJsonObject>
+#include <QJsonValue>
+#include <QMessageBox>
+#include <QPointer>
+#include <QTemporaryDir>
+
+#include <memory>
+
+namespace bonsaiviewer::modules::project::commands {
+
+namespace {
+
+// Pure helper — clears the loaded scene without emitting any signals. The
+// caller (newProject / openProject) emits projectReset / projectOpened once
+// the whole flow finishes.
+void clearScene(SessionState& s, ViewportWindow& vp) {
+    vp.setSelectedObjectId(0);
+    s.setSelectedObjectId(0);
+    for (uint32_t mid : s.modelIds()) {
+        vp.removeModel(mid);
+        s.loader()->removeModel(mid);
+    }
+    s.clearModelMappings();
+    s.elementRegistry()->clear();
+}
+
+// Returns false if the user cancelled (i.e. don't proceed with the destructive
+// op). Handles the Save → Discard → Cancel branch including a follow-on save.
+bool confirmDiscardIfDirty(SessionState& s, QWidget& host) {
+    if (!s.federation()->isDirty()) return true;
+    const auto result = QMessageBox::question(
+        &host, "Unsaved Project",
+        "The current project has unsaved changes. Save before continuing?",
+        QMessageBox::Save | QMessageBox::Discard | QMessageBox::Cancel,
+        QMessageBox::Save);
+    if (result == QMessageBox::Cancel) return false;
+    if (result == QMessageBox::Save) return saveProject(s, host);
+    return true;
+}
+
+// Fire-and-forget async resolution of any non-local models in the
+// federation. Groups by source_connector and issues one pull_models per
+// group. For each returned entry:
+//   - if the fed_id already has a scene entry pointed at the same path,
+//     just refresh cloud metadata (no reload, preserves view state);
+//   - if the path differs, tear down the stale scene entry and queue a
+//     fresh load (federation entry is preserved either way);
+//   - if no scene entry exists yet (initial open), queue a load.
+// Per spec, connector errors are not surfaced to the user; the connector
+// has already shown its own UI.
+void resolveCloudModels(SessionState& s, ViewportWindow& vp) {
+    auto* fed = s.federation();
+    QHash<QString, QStringList> connector_to_fed_ids;
+    for (const auto& m : fed->models()) {
+        if (m.source_connector == "local") continue;
+        connector_to_fed_ids[m.source_connector].push_back(m.id);
+    }
+    if (connector_to_fed_ids.isEmpty()) return;
+
+    auto* registry = s.connectorRegistry();
+    QPointer<SessionState> sguard(&s);
+    QPointer<ViewportWindow> vguard(&vp);
+
+    for (auto it = connector_to_fed_ids.constBegin();
+              it != connector_to_fed_ids.constEnd(); ++it) {
+        const QString connector_id = it.key();
+        const QStringList fed_ids = it.value();
+
+        auto* proc = registry->get(connector_id);
+        if (!proc) {
+            qWarning() << "resolveCloudModels: cannot launch connector"
+                       << connector_id << ":" << registry->lastError();
+            continue;
+        }
+
+        QJsonArray params;
+        for (const QString& fed_id : fed_ids) {
+            const Federation::Model* m = fed->findById(fed_id);
+            if (!m) continue;
+            QJsonObject source = m->source_data;
+            source["connector"] = m->source_connector;
+            QJsonObject entry;
+            entry["display_name"] = m->display_name;
+            entry["id"] = m->id;
+            entry["source"] = source;
+            params.append(entry);
+        }
+
+        proc->call("pull_models", params,
+            [sguard, vguard, fed_ids](const QJsonValue& result) {
+                if (!sguard) return;
+                const QJsonArray arr = result.toArray();
+                QStringList paths_to_load;
+                QStringList fed_ids_to_load;
+                bool any_detached = false;
+                for (int i = 0; i < arr.size() && i < fed_ids.size(); ++i) {
+                    if (arr[i].isNull()) continue;
+                    const QJsonObject obj = arr[i].toObject();
+                    const QString new_path = obj.value("path").toString();
+                    if (new_path.isEmpty()) continue;
+                    const QString fed_id = fed_ids[i];
+                    const QJsonObject meta = obj.value("metadata").toObject();
+
+                    const uint32_t existing_mid = sguard->modelIdForFedId(fed_id);
+                    if (existing_mid != 0 && sguard->loader()) {
+                        const QString existing_path = sguard->loader()->filePath(existing_mid);
+                        if (QDir::cleanPath(existing_path) == QDir::cleanPath(new_path)) {
+                            sguard->setCloudMetadata(fed_id, meta.toVariantMap());
+                            continue;
+                        }
+                        // Path changed (new revision lives in a fresh cache dir).
+                        // Detach the stale scene entry; federation entry stays.
+                        if (vguard) vguard->removeModel(existing_mid);
+                        sguard->loader()->removeModel(existing_mid);
+                        sguard->elementRegistry()->removeModel(existing_mid);
+                        sguard->removeModelMappingByFedId(fed_id);
+                        any_detached = true;
+                    }
+
+                    sguard->setCloudMetadata(fed_id, meta.toVariantMap());
+                    paths_to_load << new_path;
+                    fed_ids_to_load << fed_id;
+                }
+                if (any_detached) {
+                    if (vguard) vguard->setSelectedObjectId(0);
+                    sguard->setSelectedObjectId(0);
+                    sguard->notifySelectionChanged();
+                }
+                if (!paths_to_load.isEmpty()) {
+                    modules::models::commands::detail::loadModels(
+                        *sguard, paths_to_load, fed_ids_to_load);
+                    sguard->notifyModelsChanged();
+                }
+            },
+            [sguard, connector_id](int code, const QString& message) {
+                qWarning() << "pull_models from" << connector_id
+                           << "failed:" << code << message;
+                if (sguard) {
+                    sguard->setStatusMessage("Cloud",
+                        QString("%1 reported an error (see connector UI)").arg(connector_id));
+                }
+            });
+    }
+
+    int total = 0;
+    for (auto it = connector_to_fed_ids.constBegin();
+              it != connector_to_fed_ids.constEnd(); ++it) {
+        total += it.value().size();
+    }
+    s.setStatusMessage("Cloud", QString("Resolving %1 model(s)...").arg(total));
+}
+
+// Byte-equality check for "is this .ifcfed the same as what we have loaded?"
+// — used by Sync From Cloud to skip the full reload when the connector
+// served an unchanged revision.
+bool isIfcfedUnchanged(const QString& current_path, const QString& candidate_path) {
+    if (current_path.isEmpty() || candidate_path.isEmpty()) return false;
+    if (QDir::cleanPath(current_path) == QDir::cleanPath(candidate_path)) return true;
+    QFile a(current_path);
+    QFile b(candidate_path);
+    if (!a.open(QIODevice::ReadOnly) || !b.open(QIODevice::ReadOnly)) return false;
+    if (a.size() != b.size()) return false;
+    return a.readAll() == b.readAll();
+}
+
+bool openProjectAt(SessionState& s, QWidget& host, ViewportWindow& vp, const QString& path) {
+    SceneLoader* loader = s.loader();
+    if (loader && loader->isLoading()) {
+        QMessageBox::information(
+            &host, "Open Project",
+            "Wait until the current model load finishes before opening another project.");
+        return false;
+    }
+    if (!confirmDiscardIfDirty(s, host)) return false;
+
+    QStringList warnings;
+    QString err;
+    if (!s.federation()->load(path, &warnings, &err)) {
+        QMessageBox::warning(&host, "Open Project",
+                             QString("Could not open project:\n%1").arg(err));
+        return false;
+    }
+
+    clearScene(s, vp);
+
+    QStringList paths;
+    QStringList fed_ids;
+    for (const auto& model : s.federation()->models()) {
+        if (model.source_connector != "local") continue;
+        if (!QFileInfo::exists(model.source_path)) {
+            warnings << QString("Source not found, kept in project: %1").arg(model.source_path);
+            continue;
+        }
+        paths << model.source_path;
+        fed_ids << model.id;
+    }
+    modules::models::commands::detail::loadModels(s, paths, fed_ids);
+
+    if (!warnings.isEmpty()) {
+        QMessageBox::warning(&host, "Open Project",
+                             "Project opened with warnings:\n\n" + warnings.join("\n"));
+    }
+
+    s.federation()->markClean();
+    if (s.federation()->hasHomeView()) {
+        const auto& hv = s.federation()->homeView();
+        vp.setCamera(hv.target.x(), hv.target.y(), hv.target.z(),
+                     hv.distance, hv.yaw, hv.pitch);
+    }
+    s.setStatusMessage("Project", QFileInfo(path).fileName());
+    s.notifyProjectOpened(path);
+
+    resolveCloudModels(s, vp);
+    return true;
+}
+
+bool saveProjectTo(SessionState& s, QWidget& host, const QString& path) {
+    QString err;
+    if (!s.federation()->save(path, &err)) {
+        QMessageBox::warning(&host, "Save Project",
+                             QString("Could not save project:\n%1").arg(err));
+        return false;
+    }
+    s.setStatusMessage("Project", QFileInfo(path).fileName());
+    s.notifyProjectSaved(path);
+    return true;
+}
+
+} // namespace
+
+bool newProject(SessionState& s, QWidget& host, ViewportWindow& vp) {
+    SceneLoader* loader = s.loader();
+    if (loader && loader->isLoading()) {
+        QMessageBox::information(
+            &host, "New Project",
+            "Wait until the current model load finishes before creating a new project.");
+        return false;
+    }
+    if (!confirmDiscardIfDirty(s, host)) return false;
+
+    clearScene(s, vp);
+    s.federation()->clear();
+    s.setStatusMessage("Project", "Untitled");
+    s.notifyProjectReset();
+    return true;
+}
+
+bool openProject(SessionState& s, QWidget& host, ViewportWindow& vp) {
+    QFileDialog file_dialog(&host, "Open Project");
+    file_dialog.setFileMode(QFileDialog::ExistingFile);
+    file_dialog.setNameFilter("IFC Federation (*.ifcfed);;All Files (*)");
+    file_dialog.setOption(QFileDialog::DontUseNativeDialog, true);
+    if (file_dialog.exec() != QDialog::Accepted) return false;
+
+    const QString path = file_dialog.selectedFiles().value(0);
+    if (path.isEmpty()) return false;
+    return openProjectAt(s, host, vp, path);
+}
+
+bool openCloudProject(SessionState& s, QWidget& host, ViewportWindow& vp) {
+    SceneLoader* loader = s.loader();
+    if (loader && loader->isLoading()) {
+        QMessageBox::information(
+            &host, "Open from Cloud",
+            "Wait until the current model load finishes before opening another project.");
+        return false;
+    }
+    if (!confirmDiscardIfDirty(s, host)) return false;
+
+    auto* registry = s.connectorRegistry();
+    const auto& manifests = registry->available();
+    if (manifests.empty()) {
+        QMessageBox::information(&host, "Open from Cloud",
+            "No connectors are installed. Install one under your user connectors "
+            "directory.");
+        return false;
+    }
+
+    modules::connectors::ConnectorPickerDialog picker(
+        manifests, "Open from Cloud",
+        "Pick a connector to browse a project on.", &host);
+    if (picker.exec() != QDialog::Accepted) return false;
+    const QString connector_id = picker.selectedId();
+    if (connector_id.isEmpty()) return false;
+
+    auto* proc = registry->get(connector_id);
+    if (!proc) {
+        QMessageBox::warning(&host, "Open from Cloud",
+            QString("Could not launch connector '%1':\n%2")
+                .arg(connector_id, registry->lastError()));
+        return false;
+    }
+
+    s.beginProgress(QString("Opening project from %1...").arg(connector_id));
+    s.setStatusMessage("Cloud", QString("Browsing %1...").arg(connector_id));
+
+    QPointer<SessionState> sguard(&s);
+    QPointer<QWidget> hguard(&host);
+    QPointer<ViewportWindow> vguard(&vp);
+
+    proc->call("pull_ifcfed_interactive", QJsonValue(),
+        [sguard, hguard, vguard, connector_id](const QJsonValue& result) {
+            if (!sguard) return;
+            sguard->endProgress();
+            const QString path = result.toObject().value("path").toString();
+            if (path.isEmpty()) {
+                if (hguard) {
+                    QMessageBox::warning(hguard, "Open from Cloud",
+                        QString("Connector '%1' returned no path.").arg(connector_id));
+                }
+                return;
+            }
+            if (hguard && vguard) {
+                openProjectAt(*sguard, *hguard, *vguard, path);
+            }
+        },
+        [sguard, connector_id](int code, const QString& message) {
+            qWarning() << "pull_ifcfed_interactive from" << connector_id
+                       << "failed:" << code << message;
+            if (sguard) {
+                sguard->endProgress();
+                sguard->setStatusMessage("Cloud",
+                    QString("%1 reported an error (see connector UI)").arg(connector_id));
+            }
+        });
+    return true;
+}
+
+bool syncCloudProject(SessionState& s, QWidget& host, ViewportWindow& vp) {
+    auto* fed = s.federation();
+
+    // Per spec, sync has two independent phases — refreshing the .ifcfed
+    // (requires manifest) and refreshing cloud models (requires any
+    // non-local source). Either is sufficient.
+    const bool has_manifest = fed->hasManifest();
+    bool has_cloud_models = false;
+    for (const auto& m : fed->models()) {
+        if (m.source_connector != "local") { has_cloud_models = true; break; }
+    }
+    if (!has_manifest && !has_cloud_models) {
+        QMessageBox::information(&host, "Sync From Cloud",
+            "Nothing to sync — this project has no cloud resources.");
+        return false;
+    }
+
+    SceneLoader* loader = s.loader();
+    if (loader && loader->isLoading()) {
+        QMessageBox::information(&host, "Sync From Cloud",
+            "Wait until the current model load finishes before syncing.");
+        return false;
+    }
+
+    // No manifest: skip the pull_ifcfed phase entirely (spec step 2-4
+    // skipped). Just refresh cloud-sourced models against the .ifcfed
+    // already on disk. Federation state is preserved, so no dirty prompt.
+    if (!has_manifest) {
+        s.setStatusMessage("Cloud", "Refreshing cloud models...");
+        resolveCloudModels(s, vp);
+        return true;
+    }
+
+    // Manifest path: the .ifcfed itself may be replaced. Confirm dirty —
+    // even though we'll attempt to preserve the session if the returned
+    // .ifcfed is byte-equal, that's not known until after the round-trip.
+    if (!confirmDiscardIfDirty(s, host)) return false;
+
+    const QString connector_id = fed->manifestConnectorId();
+    if (connector_id.isEmpty()) {
+        QMessageBox::warning(&host, "Sync From Cloud",
+            "The project's manifest does not name a connector.");
+        return false;
+    }
+    auto* registry = s.connectorRegistry();
+    auto* proc = registry->get(connector_id);
+    if (!proc) {
+        QMessageBox::warning(&host, "Sync From Cloud",
+            QString("Could not launch connector '%1':\n%2")
+                .arg(connector_id, registry->lastError()));
+        return false;
+    }
+
+    s.beginProgress(QString("Syncing from %1...").arg(connector_id));
+    s.setStatusMessage("Cloud", QString("Syncing from %1...").arg(connector_id));
+
+    QPointer<SessionState> sguard(&s);
+    QPointer<QWidget> hguard(&host);
+    QPointer<ViewportWindow> vguard(&vp);
+    const QString current_path = fed->filePath();
+
+    proc->call("pull_ifcfed", fed->manifest(),
+        [sguard, hguard, vguard, connector_id, current_path](const QJsonValue& result) {
+            if (!sguard) return;
+            sguard->endProgress();
+            const QString new_path = result.toObject().value("path").toString();
+            if (new_path.isEmpty()) {
+                if (hguard) {
+                    QMessageBox::warning(hguard, "Sync From Cloud",
+                        QString("Connector '%1' returned no path.").arg(connector_id));
+                }
+                return;
+            }
+            // Per spec: if the returned .ifcfed is unchanged from the one
+            // already loaded, preserve the current session — just repoint
+            // if the cache path moved and resync models.
+            if (isIfcfedUnchanged(current_path, new_path)) {
+                if (QDir::cleanPath(current_path) != QDir::cleanPath(new_path)) {
+                    sguard->federation()->repointTo(new_path);
+                }
+                sguard->setStatusMessage("Cloud",
+                    "Project up to date; refreshing cloud models...");
+                if (vguard) resolveCloudModels(*sguard, *vguard);
+                return;
+            }
+            // Content differs — fall through to the standard open path,
+            // which clears the scene and triggers resolveCloudModels for
+            // any cloud-sourced models in the freshly loaded federation.
+            if (hguard && vguard) {
+                openProjectAt(*sguard, *hguard, *vguard, new_path);
+            }
+        },
+        [sguard, connector_id](int code, const QString& message) {
+            qWarning() << "pull_ifcfed from" << connector_id
+                       << "failed:" << code << message;
+            if (sguard) {
+                sguard->endProgress();
+                sguard->setStatusMessage("Cloud",
+                    QString("%1 reported an error (see connector UI)").arg(connector_id));
+            }
+        });
+    return true;
+}
+
+bool saveProject(SessionState& s, QWidget& host) {
+    if (s.federation()->filePath().isEmpty()) return saveProjectAs(s, host);
+    return saveProjectTo(s, host, s.federation()->filePath());
+}
+
+bool saveProjectAs(SessionState& s, QWidget& host) {
+    QString suggested = s.federation()->filePath();
+    if (suggested.isEmpty()) suggested = "project.ifcfed";
+
+    QFileDialog file_dialog(&host, "Save Project As", suggested);
+    file_dialog.setAcceptMode(QFileDialog::AcceptSave);
+    file_dialog.setFileMode(QFileDialog::AnyFile);
+    file_dialog.setNameFilter("IFC Federation (*.ifcfed);;All Files (*)");
+    file_dialog.setOption(QFileDialog::DontUseNativeDialog, true);
+    if (file_dialog.exec() != QDialog::Accepted) return false;
+
+    QString path = file_dialog.selectedFiles().value(0);
+    if (path.isEmpty()) return false;
+    if (!path.endsWith(".ifcfed", Qt::CaseInsensitive)) path += ".ifcfed";
+    return saveProjectTo(s, host, path);
+}
+
+namespace {
+
+// Writes the current federation to a fresh QTemporaryDir as a `.ifcfed`
+// without touching Federation's state, returning the temp dir (so callers
+// can keep it alive through the async RPC) and the resolved file path.
+struct TempProjectFile {
+    std::shared_ptr<QTemporaryDir> dir;
+    QString path;
+};
+
+TempProjectFile writeProjectToTemp(SessionState& s, QWidget& host, const QString& op_title) {
+    TempProjectFile out;
+    out.dir = std::make_shared<QTemporaryDir>();
+    if (!out.dir->isValid()) {
+        QMessageBox::warning(&host, op_title,
+            QString("Could not create a temporary directory:\n%1")
+                .arg(out.dir->errorString()));
+        out.dir.reset();
+        return out;
+    }
+    const QString name = s.federation()->filePath().isEmpty()
+        ? "project.ifcfed"
+        : QFileInfo(s.federation()->filePath()).fileName();
+    const QString tmp_path = QDir(out.dir->path()).filePath(name);
+    QString err;
+    if (!s.federation()->writeCopyTo(tmp_path, &err)) {
+        QMessageBox::warning(&host, op_title,
+            QString("Failed to write temporary project:\n%1").arg(err));
+        out.dir.reset();
+        return out;
+    }
+    out.path = tmp_path;
+    return out;
+}
+
+// Shared continuation for push_ifcfed[_interactive]: on success, repoint
+// Federation to the returned path and notify; on error, log + status.
+void onPushIfcfedResult(SessionState& s,
+                        QWidget& host,
+                        const QString& op_title,
+                        const QString& connector_id,
+                        const QJsonValue& result) {
+    s.endProgress();
+    const QString new_path = result.toObject().value("path").toString();
+    if (new_path.isEmpty()) {
+        QMessageBox::warning(&host, op_title,
+            QString("Connector '%1' returned no path.").arg(connector_id));
+        return;
+    }
+    QStringList warnings;
+    s.federation()->repointTo(new_path, &warnings);
+    s.setStatusMessage("Cloud",
+        QString("Saved to %1 via %2")
+            .arg(QFileInfo(new_path).fileName(), connector_id));
+    s.notifyProjectSaved(new_path);
+}
+
+} // namespace
+
+bool saveCloudProject(SessionState& s, QWidget& host) {
+    auto* fed = s.federation();
+    if (!fed->hasManifest()) {
+        QMessageBox::information(&host, "Save To Cloud",
+            "This project has no cloud target. Use \"Save As To Cloud\" first.");
+        return false;
+    }
+    const QString connector_id = fed->manifestConnectorId();
+    auto* registry = s.connectorRegistry();
+    auto* proc = registry->get(connector_id);
+    if (!proc) {
+        QMessageBox::warning(&host, "Save To Cloud",
+            QString("Could not launch connector '%1':\n%2")
+                .arg(connector_id, registry->lastError()));
+        return false;
+    }
+
+    auto tmp = writeProjectToTemp(s, host, "Save To Cloud");
+    if (!tmp.dir) return false;
+
+    QJsonObject params;
+    params["path"] = tmp.path;
+    params["manifest"] = fed->manifest();
+
+    s.beginProgress(QString("Saving to %1...").arg(connector_id));
+    s.setStatusMessage("Cloud", QString("Saving to %1...").arg(connector_id));
+
+    QPointer<SessionState> sguard(&s);
+    QPointer<QWidget> hguard(&host);
+
+    proc->call("push_ifcfed", params,
+        [sguard, hguard, connector_id, tmp_keepalive = tmp.dir](const QJsonValue& result) {
+            (void)tmp_keepalive;
+            if (!sguard || !hguard) return;
+            onPushIfcfedResult(*sguard, *hguard, "Save To Cloud", connector_id, result);
+        },
+        [sguard, connector_id, tmp_keepalive = tmp.dir](int code, const QString& message) {
+            (void)tmp_keepalive;
+            qWarning() << "push_ifcfed to" << connector_id
+                       << "failed:" << code << message;
+            if (sguard) {
+                sguard->endProgress();
+                sguard->setStatusMessage("Cloud",
+                    QString("%1 reported an error (see connector UI)").arg(connector_id));
+            }
+        });
+    return true;
+}
+
+bool saveAsCloudProject(SessionState& s, QWidget& host) {
+    auto* registry = s.connectorRegistry();
+    const auto& manifests = registry->available();
+    if (manifests.empty()) {
+        QMessageBox::information(&host, "Save As To Cloud",
+            "No connectors are installed.");
+        return false;
+    }
+
+    modules::connectors::ConnectorPickerDialog picker(
+        manifests, "Save As To Cloud",
+        "Pick a connector to push this project to.", &host);
+    if (picker.exec() != QDialog::Accepted) return false;
+    const QString connector_id = picker.selectedId();
+    if (connector_id.isEmpty()) return false;
+
+    auto* proc = registry->get(connector_id);
+    if (!proc) {
+        QMessageBox::warning(&host, "Save As To Cloud",
+            QString("Could not launch connector '%1':\n%2")
+                .arg(connector_id, registry->lastError()));
+        return false;
+    }
+
+    auto tmp = writeProjectToTemp(s, host, "Save As To Cloud");
+    if (!tmp.dir) return false;
+
+    QJsonObject params;
+    params["path"] = tmp.path;
+
+    s.beginProgress(QString("Pushing to %1...").arg(connector_id));
+    s.setStatusMessage("Cloud", QString("Pushing to %1...").arg(connector_id));
+
+    QPointer<SessionState> sguard(&s);
+    QPointer<QWidget> hguard(&host);
+
+    proc->call("push_ifcfed_interactive", params,
+        [sguard, hguard, connector_id, tmp_keepalive = tmp.dir](const QJsonValue& result) {
+            (void)tmp_keepalive;
+            if (!sguard || !hguard) return;
+            onPushIfcfedResult(*sguard, *hguard, "Save As To Cloud", connector_id, result);
+        },
+        [sguard, connector_id, tmp_keepalive = tmp.dir](int code, const QString& message) {
+            (void)tmp_keepalive;
+            qWarning() << "push_ifcfed_interactive to" << connector_id
+                       << "failed:" << code << message;
+            if (sguard) {
+                sguard->endProgress();
+                sguard->setStatusMessage("Cloud",
+                    QString("%1 reported an error (see connector UI)").arg(connector_id));
+            }
+        });
+    return true;
+}
+
+bool saveProjectDialog(SessionState& s, QWidget& host) {
+    SaveProjectDialog dialog(s.federation()->hasManifest(), &host);
+    if (dialog.exec() != QDialog::Accepted) return false;
+    switch (dialog.selectedTarget()) {
+    case SaveTarget::Local:   return saveProject(s, host);
+    case SaveTarget::LocalAs: return saveProjectAs(s, host);
+    case SaveTarget::Cloud:   return saveCloudProject(s, host);
+    case SaveTarget::CloudAs: return saveAsCloudProject(s, host);
+    case SaveTarget::None:    return false;
+    }
+    return false;
+}
+
+} // namespace bonsaiviewer::modules::project::commands
@@ -0,0 +1,63 @@
+// This file was generated with the assistance of an AI coding tool.
+/********************************************************************************
+ *                                                                              *
+ * This file is part of IfcOpenShell.                                           *
+ *                                                                              *
+ * IfcOpenShell is free software: you can redistribute it and/or modify         *
+ * it under the terms of the Lesser GNU General Public License as published by  *
+ * the Free Software Foundation, either version 3.0 of the License, or          *
+ * (at your option) any later version.                                          *
+ *                                                                              *
+ * IfcOpenShell is distributed in the hope that it will be useful,              *
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of               *
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the                 *
+ * Lesser GNU General Public License for more details.                          *
+ *                                                                              *
+ * You should have received a copy of the Lesser GNU General Public License     *
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.         *
+ *                                                                              *
+ ********************************************************************************/
+
+#ifndef IFCINTERFACE_MODULES_PROJECT_COMMANDS_H
+#define IFCINTERFACE_MODULES_PROJECT_COMMANDS_H
+
+#include <QString>
+
+class QWidget;
+class ViewportWindow;
+namespace bonsaiviewer { class SessionState; }
+
+namespace bonsaiviewer::modules::project::commands {
+
+// User-facing commands. Each owns its own dialogs and confirmations; each
+// emits exactly one notify() at the end (projectReset / projectOpened /
+// projectSaved) so views refresh once per command.
+bool newProject(SessionState& s, QWidget& host, ViewportWindow& vp);
+bool openProject(SessionState& s, QWidget& host, ViewportWindow& vp);
+// Pick a connector, then call pull_ifcfed_interactive and open the resulting
+// .ifcfed as a fresh project. Non-local models in the loaded federation are
+// resolved asynchronously via pull_models.
+bool openCloudProject(SessionState& s, QWidget& host, ViewportWindow& vp);
+// pull_ifcfed using the current project's .ifcfed.manifest. Re-downloads
+// the .ifcfed from the same cloud target it came from (typically without
+// user interaction), then opens it like a fresh project — discarding any
+// local edits after the usual dirty-check prompt.
+bool syncCloudProject(SessionState& s, QWidget& host, ViewportWindow& vp);
+bool saveProject(SessionState& s, QWidget& host);
+bool saveProjectAs(SessionState& s, QWidget& host);
+// Push the current federation to the cloud target named in its manifest
+// (push_ifcfed). No user prompt for destination. Caller is responsible for
+// gating this on Federation::hasManifest.
+bool saveCloudProject(SessionState& s, QWidget& host);
+// Pick a connector and push the current federation to a fresh cloud target
+// (push_ifcfed_interactive). The connector returns a new path + manifest;
+// Federation repoints to that location.
+bool saveAsCloudProject(SessionState& s, QWidget& host);
+// Show the four-way Save dialog (Local / Save As Local / To Cloud / Save
+// As To Cloud) and dispatch to one of the above. This is what the "Save
+// Project" ribbon button is wired to.
+bool saveProjectDialog(SessionState& s, QWidget& host);
+
+} // namespace bonsaiviewer::modules::project::commands
+
+#endif
@@ -0,0 +1,148 @@
+// This file was generated with the assistance of an AI coding tool.
+/********************************************************************************
+ *                                                                              *
+ * This file is part of IfcOpenShell.                                           *
+ *                                                                              *
+ * IfcOpenShell is free software: you can redistribute it and/or modify         *
+ * it under the terms of the Lesser GNU General Public License as published by  *
+ * the Free Software Foundation, either version 3.0 of the License, or          *
+ * (at your option) any later version.                                          *
+ *                                                                              *
+ * IfcOpenShell is distributed in the hope that it will be useful,              *
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of               *
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the                 *
+ * Lesser GNU General Public License for more details.                          *
+ *                                                                              *
+ * You should have received a copy of the Lesser GNU General Public License     *
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.         *
+ *                                                                              *
+ ********************************************************************************/
+
+#include "SaveProjectDialog.h"
+
+#include "../../components/Buttons.h"
+#include "../../components/Section.h"
+#include "../../components/Style.h"
+
+#include <QEvent>
+#include <QHBoxLayout>
+#include <QLabel>
+#include <QToolButton>
+#include <QVBoxLayout>
+
+namespace bonsaiviewer::modules::project {
+
+namespace {
+
+class HoverDescriptionFilter : public QObject {
+public:
+    HoverDescriptionFilter(QLabel* label, QString hover_text, QString default_text)
+        : label_(label), hover_text_(std::move(hover_text)), default_text_(std::move(default_text)) {}
+
+protected:
+    bool eventFilter(QObject*, QEvent* event) override {
+        if (event->type() == QEvent::Enter) label_->setText(hover_text_);
+        else if (event->type() == QEvent::Leave) label_->setText(default_text_);
+        return false;
+    }
+
+private:
+    QLabel* label_ = nullptr;
+    QString hover_text_;
+    QString default_text_;
+};
+
+} // namespace
+
+SaveProjectDialog::SaveProjectDialog(bool has_manifest, QWidget* parent)
+    : components::Dialog(parent)
+{
+    setObjectName("appDialog");
+    setWindowTitle("Save Project");
+    setModal(true);
+    setupUi(has_manifest);
+}
+
+void SaveProjectDialog::setupUi(bool has_manifest) {
+    if (auto* root = qobject_cast<QVBoxLayout*>(layout())) {
+        root->setSizeConstraint(QLayout::SetFixedSize);
+    }
+
+    const QString default_description = "Choose where to save this project";
+    auto* description_section = new components::Section("", components::SectionHeaderMode::Hidden, this);
+    auto* description = new QLabel(default_description, description_section);
+    description->setProperty("textRole", "secondary");
+    description->setWordWrap(true);
+    description->setAlignment(Qt::AlignCenter);
+    description->setMinimumWidth((90 * 4) + (components::style::metrics::padding * 3));
+    description->setMinimumHeight(description->fontMetrics().lineSpacing() * 2 + 4);
+    description_section->addBodyWidget(description);
+
+    auto* choices_section = new components::Section("", components::SectionHeaderMode::Hidden, this);
+    auto* choices = new QWidget(choices_section);
+    auto* row = new QHBoxLayout(choices);
+    row->setContentsMargins(0, 0, 0, 0);
+    row->setSpacing(components::style::metrics::padding);
+
+    auto* save_local = components::buttons::makeButton(
+        "Save Local", ":/icons/floppy-disk.svg", choices);
+    connect(save_local, &QToolButton::clicked, this, [this]() {
+        selected_target_ = SaveTarget::Local;
+        accept();
+    });
+    save_local->installEventFilter(new HoverDescriptionFilter(
+        description,
+        "Save to the project's current file on disk (prompts for a path if none).",
+        default_description));
+
+    auto* save_as_local = components::buttons::makeButton(
+        "Save As\nLocal", ":/icons/floppy-disk-arrow-in.svg", choices);
+    connect(save_as_local, &QToolButton::clicked, this, [this]() {
+        selected_target_ = SaveTarget::LocalAs;
+        accept();
+    });
+    save_as_local->installEventFilter(new HoverDescriptionFilter(
+        description,
+        "Save the project to a new file on disk.",
+        default_description));
+
+    auto* save_cloud = components::buttons::makeButton(
+        "Save To\nCloud", ":/icons/cloud-square.svg", choices);
+    save_cloud->setEnabled(has_manifest);
+    if (!has_manifest) {
+        save_cloud->setToolTip(
+            "This project has no cloud target yet. Use \"Save As To Cloud\" first.");
+    }
+    connect(save_cloud, &QToolButton::clicked, this, [this]() {
+        selected_target_ = SaveTarget::Cloud;
+        accept();
+    });
+    save_cloud->installEventFilter(new HoverDescriptionFilter(
+        description,
+        has_manifest
+            ? "Push back to the cloud location this project came from."
+            : "Disabled until this project has a cloud target (use Save As To Cloud).",
+        default_description));
+
+    auto* save_as_cloud = components::buttons::makeButton(
+        "Save As\nTo Cloud", ":/icons/cloud-square.svg", choices);
+    connect(save_as_cloud, &QToolButton::clicked, this, [this]() {
+        selected_target_ = SaveTarget::CloudAs;
+        accept();
+    });
+    save_as_cloud->installEventFilter(new HoverDescriptionFilter(
+        description,
+        "Pick a connector and push this project to a fresh cloud location.",
+        default_description));
+
+    row->addWidget(components::buttons::makeButtonGroup(
+        "LOCAL", {save_local, save_as_local}, choices, true, 8));
+    row->addWidget(components::buttons::makeButtonGroup(
+        "CLOUD", {save_cloud, save_as_cloud}, choices, false, 8));
+    choices_section->addBodyWidget(choices);
+
+    addBodyWidget(description_section);
+    addBodyWidget(choices_section);
+}
+
+} // namespace bonsaiviewer::modules::project
@@ -0,0 +1,54 @@
+// This file was generated with the assistance of an AI coding tool.
+/********************************************************************************
+ *                                                                              *
+ * This file is part of IfcOpenShell.                                           *
+ *                                                                              *
+ * IfcOpenShell is free software: you can redistribute it and/or modify         *
+ * it under the terms of the Lesser GNU General Public License as published by  *
+ * the Free Software Foundation, either version 3.0 of the License, or          *
+ * (at your option) any later version.                                          *
+ *                                                                              *
+ * IfcOpenShell is distributed in the hope that it will be useful,              *
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of               *
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the                 *
+ * Lesser GNU General Public License for more details.                          *
+ *                                                                              *
+ * You should have received a copy of the Lesser GNU General Public License     *
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.         *
+ *                                                                              *
+ ********************************************************************************/
+
+#ifndef IFCINTERFACE_MODULES_PROJECT_SAVEPROJECTDIALOG_H
+#define IFCINTERFACE_MODULES_PROJECT_SAVEPROJECTDIALOG_H
+
+#include "../../components/Dialog.h"
+
+namespace bonsaiviewer::modules::project {
+
+enum class SaveTarget {
+    None,
+    Local,    // saveProject:      write to current file_path_ (or fall through to LocalAs)
+    LocalAs,  // saveProjectAs:    pick file with QFileDialog
+    Cloud,    // saveCloudProject: push_ifcfed using existing manifest
+    CloudAs,  // saveAsCloudProject: connector picker + push_ifcfed_interactive
+};
+
+// "Save Project" dispatch dialog, modelled on AddModelDialog. Always shows
+// all four buttons; "Save to Cloud" is disabled when the project has no
+// .ifcfed.manifest (there is no cloud target to push to).
+class SaveProjectDialog : public components::Dialog {
+    Q_OBJECT
+public:
+    explicit SaveProjectDialog(bool has_manifest, QWidget* parent = nullptr);
+
+    SaveTarget selectedTarget() const { return selected_target_; }
+
+private:
+    void setupUi(bool has_manifest);
+
+    SaveTarget selected_target_ = SaveTarget::None;
+};
+
+} // namespace bonsaiviewer::modules::project
+
+#endif