@solidxai/core-ui 0.1.20-beta.0 → 0.1.20-beta.1

package/dist/components/core/module/ModulePackageDialog.js

@@ -48,23 +48,53 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { useDropzone } from "react-dropzone";
-import { FileArchive, FolderTree, RefreshCw, Sparkles, UploadCloud, X } from "lucide-react";
-import { useConfirmModulePackageImportMutation, useDismissModulePackageImportMutation, useLazyGetModulePackageImportStatusQuery, useRunModulePackageBuildMutation, useRunModulePackageSeedMutation, useValidateModulePackageImportMutation, } from "../../../redux/api/moduleApi";
+import { ArrowRight, FileArchive, FolderTree, RefreshCw, RotateCcw, Sparkles, UploadCloud, X } from "lucide-react";
+import { useConfirmModulePackageImportMutation, useDismissModulePackageImportMutation, useLazyGetModulePackageImportStatusQuery, useRestoreModulePackageImportMutation, useRunModulePackageBuildMutation, useRunModulePackageSeedMutation, useValidateModulePackageImportMutation, } from "../../../redux/api/moduleApi";
 import { showToast } from "../../../redux/features/toastSlice";
 import { useDispatch } from "react-redux";
 import { SolidButton, SolidCheckbox, SolidDialog, SolidDialogBody, SolidDialogDescription, SolidDialogHeader, SolidDialogSeparator, SolidDialogTitle, SolidIcon, SolidSpinner, } from "../../shad-cn-ui";
 import "./ModulePackageDialog.css";
 var STEP_ORDER = ["preview", "import", "build", "seed"];
-function createInitialSteps() {
+var VERSION_COMPARISONS = {
+    new: { label: "New install", tone: "neutral" },
+    upgrade: { label: "Upgrade", tone: "neutral" },
+    first_version: { label: "First versioned release", tone: "neutral" },
+    same: { label: "Reinstall", tone: "warning" },
+    downgrade: { label: "Downgrade", tone: "danger" },
+    legacy_package: { label: "Unversioned package", tone: "danger" },
+};
+function formatVersionLabel(version) {
+    return version ? "v".concat(version) : "unversioned";
+}
+function getPackageMode(transaction, fallbackMode) {
+    var _a, _b, _c;
+    if (fallbackMode === void 0) { fallbackMode = "install"; }
+    return (_c = (_a = transaction === null || transaction === void 0 ? void 0 : transaction.mode) !== null && _a !== void 0 ? _a : (_b = transaction === null || transaction === void 0 ? void 0 : transaction.preview) === null || _b === void 0 ? void 0 : _b.mode) !== null && _c !== void 0 ? _c : fallbackMode;
+}
+function getWorkflowLabels(transaction, fallbackMode) {
+    if (fallbackMode === void 0) { fallbackMode = "install"; }
+    if (transaction === null || transaction === void 0 ? void 0 : transaction.restoredFromBackup)
+        return { noun: "restore", past: "restored" };
+    return getPackageMode(transaction, fallbackMode) === "update"
+        ? { noun: "update", past: "updated" }
+        : { noun: "import", past: "imported" };
+}
+function createInitialSteps(mode) {
+    if (mode === void 0) { mode = "install"; }
+    var isUpdate = mode === "update";
     return {
         preview: {
             title: "Preview",
-            description: "Upload a `.sldx` archive to validate it and preview its contents automatically.",
+            description: isUpdate
+                ? "Upload a `.sldx` archive of the new version to compare it with the installed module."
+                : "Upload a `.sldx` archive to validate it and preview its contents automatically.",
             status: "pending",
         },
         import: {
-            title: "Import",
-            description: "Import the files locally. This may restart the UI and API, dismiss the popup, and require a page refresh before you continue.",
+            title: isUpdate ? "Update" : "Import",
+            description: isUpdate
+                ? "Replace the module folders with the new version. The current folders are backed up first. This may restart the UI and API, dismiss the popup, and require a page refresh before you continue."
+                : "Import the files locally. This may restart the UI and API, dismiss the popup, and require a page refresh before you continue.",
             status: "pending",
         },
         build: {
@@ -74,7 +104,9 @@ function createInitialSteps() {
         },
         seed: {
             title: "Seed",
-            description: "Seed the imported module after the build step completes.",
+            description: isUpdate
+                ? "Seed the updated module after the build step completes."
+                : "Seed the imported module after the build step completes.",
             status: "pending",
         },
     };
@@ -110,6 +142,7 @@ function isResumableModulePackageStatus(status) {
         "build_succeeded",
         "seed_running",
         "seed_failed",
+        "restore_running",
     ].includes(String(status !== null && status !== void 0 ? status : ""));
 }
 function getBuildStepStatusFromTransaction(transaction) {
@@ -121,18 +154,27 @@ function getBuildStepStatusFromTransaction(transaction) {
     }
     return "pending";
 }
-function hydrateStepsFromTransaction(transaction) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
-    var nextSteps = createInitialSteps();
+function hydrateStepsFromTransaction(transaction, fallbackMode) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+    if (fallbackMode === void 0) { fallbackMode = "install"; }
+    var mode = getPackageMode(transaction, fallbackMode);
+    var nextSteps = createInitialSteps(mode);
     var status = String((_a = transaction === null || transaction === void 0 ? void 0 : transaction.status) !== null && _a !== void 0 ? _a : "");
+    var noun = getWorkflowLabels(transaction, fallbackMode).noun;
     if ((transaction === null || transaction === void 0 ? void 0 : transaction.preview) || (transaction === null || transaction === void 0 ? void 0 : transaction.validation)) {
         nextSteps.preview = __assign(__assign({}, nextSteps.preview), { status: ((_b = transaction === null || transaction === void 0 ? void 0 : transaction.validation) === null || _b === void 0 ? void 0 : _b.valid) ? "success" : "warning", description: ((_c = transaction === null || transaction === void 0 ? void 0 : transaction.validation) === null || _c === void 0 ? void 0 : _c.valid)
                 ? "Archive validated and ready for import."
                 : "Archive preview loaded, but the package has validation issues to fix first." });
     }
-    if (((_d = transaction === null || transaction === void 0 ? void 0 : transaction.outputs) === null || _d === void 0 ? void 0 : _d.import) ||
-        ["awaiting_restart", "build_running", "build_failed", "build_succeeded", "seed_running", "seed_failed", "completed"].includes(status)) {
-        nextSteps.import = __assign(__assign({}, nextSteps.import), { status: "success", description: "Archive extracted. Wait for the UI and API to finish restarting, then refresh this page to continue.", output: (_f = (_e = transaction === null || transaction === void 0 ? void 0 : transaction.outputs) === null || _e === void 0 ? void 0 : _e.import) !== null && _f !== void 0 ? _f : undefined });
+    if (status !== "restore_running" &&
+        (((_d = transaction === null || transaction === void 0 ? void 0 : transaction.outputs) === null || _d === void 0 ? void 0 : _d.import) ||
+            ["awaiting_restart", "build_running", "build_failed", "build_succeeded", "seed_running", "seed_failed", "completed"].includes(status))) {
+        nextSteps.import = __assign(__assign({}, nextSteps.import), { status: "success", description: (transaction === null || transaction === void 0 ? void 0 : transaction.restoredFromBackup)
+                ? "Previous version restored. Wait for the UI and API to finish restarting, then refresh this page to continue."
+                : "Archive extracted. Wait for the UI and API to finish restarting, then refresh this page to continue.", output: [(_e = transaction === null || transaction === void 0 ? void 0 : transaction.outputs) === null || _e === void 0 ? void 0 : _e.import, (_f = transaction === null || transaction === void 0 ? void 0 : transaction.outputs) === null || _f === void 0 ? void 0 : _f.restore].filter(Boolean).join("\n\n") || undefined });
+    }
+    else if (status === "restore_running") {
+        nextSteps.import = __assign(__assign({}, nextSteps.import), { status: "warning", description: "Restoring the previous version did not finish. Use Restore again to complete it.", output: (_h = (_g = transaction === null || transaction === void 0 ? void 0 : transaction.outputs) === null || _g === void 0 ? void 0 : _g.import) !== null && _h !== void 0 ? _h : undefined });
     }
     var buildStatus = getBuildStepStatusFromTransaction(transaction);
     if (buildStatus !== "pending") {
@@ -140,19 +182,19 @@ function hydrateStepsFromTransaction(transaction) {
                 ? "Build was previously started. Use Build Now to run it again once you are ready."
                 : buildStatus === "warning"
                     ? (transaction === null || transaction === void 0 ? void 0 : transaction.errorMessage) || "The build step completed with warnings."
-                    : "Both build targets completed successfully.", output: (_h = (_g = transaction === null || transaction === void 0 ? void 0 : transaction.outputs) === null || _g === void 0 ? void 0 : _g.build) !== null && _h !== void 0 ? _h : undefined });
+                    : "Both build targets completed successfully.", output: (_k = (_j = transaction === null || transaction === void 0 ? void 0 : transaction.outputs) === null || _j === void 0 ? void 0 : _j.build) !== null && _k !== void 0 ? _k : undefined });
     }
     else if (status === "awaiting_restart") {
-        nextSteps.build = __assign(__assign({}, nextSteps.build), { status: "pending", description: "Import completed. Once the UI and API are back, refresh this module list page and continue with Build Now." });
+        nextSteps.build = __assign(__assign({}, nextSteps.build), { status: "pending", description: "".concat(noun.charAt(0).toUpperCase()).concat(noun.slice(1), " completed. Once the UI and API are back, refresh this module list page and continue with Build Now.") });
     }
     if (status === "seed_running") {
-        nextSteps.seed = __assign(__assign({}, nextSteps.seed), { status: "warning", description: "Seed was previously started. Use Seed to run it again once you are ready.", output: (_k = (_j = transaction === null || transaction === void 0 ? void 0 : transaction.outputs) === null || _j === void 0 ? void 0 : _j.seed) !== null && _k !== void 0 ? _k : undefined });
+        nextSteps.seed = __assign(__assign({}, nextSteps.seed), { status: "warning", description: "Seed was previously started. Use Seed to run it again once you are ready.", output: (_m = (_l = transaction === null || transaction === void 0 ? void 0 : transaction.outputs) === null || _l === void 0 ? void 0 : _l.seed) !== null && _m !== void 0 ? _m : undefined });
     }
     else if (status === "seed_failed") {
-        nextSteps.seed = __assign(__assign({}, nextSteps.seed), { status: "warning", description: (transaction === null || transaction === void 0 ? void 0 : transaction.errorMessage) || "The seed step finished with warnings.", output: (_m = (_l = transaction === null || transaction === void 0 ? void 0 : transaction.outputs) === null || _l === void 0 ? void 0 : _l.seed) !== null && _m !== void 0 ? _m : undefined });
+        nextSteps.seed = __assign(__assign({}, nextSteps.seed), { status: "warning", description: (transaction === null || transaction === void 0 ? void 0 : transaction.errorMessage) || "The seed step finished with warnings.", output: (_p = (_o = transaction === null || transaction === void 0 ? void 0 : transaction.outputs) === null || _o === void 0 ? void 0 : _o.seed) !== null && _p !== void 0 ? _p : undefined });
     }
     else if (status === "completed") {
-        nextSteps.seed = __assign(__assign({}, nextSteps.seed), { status: "success", description: "Module metadata seeding completed successfully.", output: (_p = (_o = transaction === null || transaction === void 0 ? void 0 : transaction.outputs) === null || _o === void 0 ? void 0 : _o.seed) !== null && _p !== void 0 ? _p : undefined });
+        nextSteps.seed = __assign(__assign({}, nextSteps.seed), { status: "success", description: "Module metadata seeding completed successfully.", output: (_r = (_q = transaction === null || transaction === void 0 ? void 0 : transaction.outputs) === null || _q === void 0 ? void 0 : _q.seed) !== null && _r !== void 0 ? _r : undefined });
     }
     return nextSteps;
 }
@@ -190,24 +232,30 @@ export function ModulePackageDialog(_a) {
 }
 export function ModulePackageImportContent(_a) {
     var _this = this;
-    var _b, _c, _d, _e;
-    var onClose = _a.onClose, onImported = _a.onImported, _f = _a.initialTransactionKey, initialTransactionKey = _f === void 0 ? null : _f, _g = _a.autoResume, autoResume = _g === void 0 ? false : _g;
+    var _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
+    var onClose = _a.onClose, onImported = _a.onImported, _u = _a.initialTransactionKey, initialTransactionKey = _u === void 0 ? null : _u, _v = _a.autoResume, autoResume = _v === void 0 ? false : _v, _w = _a.targetModuleName, targetModuleName = _w === void 0 ? null : _w;
     var dispatch = useDispatch();
-    var _h = useState(null), selectedFile = _h[0], setSelectedFile = _h[1];
-    var _j = useState(null), previewResponse = _j[0], setPreviewResponse = _j[1];
-    var _k = useState(null), transactionKey = _k[0], setTransactionKey = _k[1];
-    var _l = useState(false), overwriteExisting = _l[0], setOverwriteExisting = _l[1];
-    var _m = useState(function () { return createInitialSteps(); }), steps = _m[0], setSteps = _m[1];
-    var _o = useState("preview"), selectedStep = _o[0], setSelectedStep = _o[1];
-    var _p = useState(null), finalSummary = _p[0], setFinalSummary = _p[1];
-    var _q = useState(false), isPreviewing = _q[0], setIsPreviewing = _q[1];
-    var _r = useState(false), isProcessing = _r[0], setIsProcessing = _r[1];
+    var fallbackMode = targetModuleName ? "update" : "install";
+    var _x = useState(null), selectedFile = _x[0], setSelectedFile = _x[1];
+    var _y = useState(null), previewResponse = _y[0], setPreviewResponse = _y[1];
+    var _z = useState(null), transactionKey = _z[0], setTransactionKey = _z[1];
+    var _0 = useState(false), overwriteExisting = _0[0], setOverwriteExisting = _0[1];
+    var _1 = useState(false), acknowledgeVersionChange = _1[0], setAcknowledgeVersionChange = _1[1];
+    var _2 = useState(false), pruneOnSeed = _2[0], setPruneOnSeed = _2[1];
+    var _3 = useState(false), showAllFiles = _3[0], setShowAllFiles = _3[1];
+    var _4 = useState(false), isRestoreConfirmOpen = _4[0], setRestoreConfirmOpen = _4[1];
+    var _5 = useState(function () { return createInitialSteps(fallbackMode); }), steps = _5[0], setSteps = _5[1];
+    var _6 = useState("preview"), selectedStep = _6[0], setSelectedStep = _6[1];
+    var _7 = useState(null), finalSummary = _7[0], setFinalSummary = _7[1];
+    var _8 = useState(false), isPreviewing = _8[0], setIsPreviewing = _8[1];
+    var _9 = useState(false), isProcessing = _9[0], setIsProcessing = _9[1];
     var validateModulePackageImport = useValidateModulePackageImportMutation()[0];
     var confirmModulePackageImport = useConfirmModulePackageImportMutation()[0];
     var dismissModulePackageImport = useDismissModulePackageImportMutation()[0];
     var fetchModulePackageImportStatus = useLazyGetModulePackageImportStatusQuery()[0];
     var runModulePackageBuild = useRunModulePackageBuildMutation()[0];
     var runModulePackageSeed = useRunModulePackageSeedMutation()[0];
+    var restoreModulePackageImport = useRestoreModulePackageImportMutation()[0];
     var hasResumedTransactionRef = useRef(false);
     var lastAutoPreviewFileRef = useRef(null);
     var updateStep = useCallback(function (key, nextState) {
@@ -216,7 +264,7 @@ export function ModulePackageImportContent(_a) {
             return (__assign(__assign({}, current), (_a = {}, _a[key] = __assign(__assign({}, current[key]), nextState), _a)));
         });
     }, []);
-    var _s = useDropzone({
+    var _10 = useDropzone({
         accept: {
             "application/octet-stream": [".sldx"],
             "application/x-zip-compressed": [".sldx"],
@@ -230,11 +278,24 @@ export function ModulePackageImportContent(_a) {
                 setSelectedFile(acceptedFiles[0]);
             }
         },
-    }), getRootProps = _s.getRootProps, getInputProps = _s.getInputProps, openFilePicker = _s.open, isDragActive = _s.isDragActive;
+    }), getRootProps = _10.getRootProps, getInputProps = _10.getInputProps, openFilePicker = _10.open, isDragActive = _10.isDragActive;
     var isArchiveValid = Boolean((_b = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.validation) === null || _b === void 0 ? void 0 : _b.valid);
     var hasConflicts = ((_d = (_c = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.conflicts) === null || _c === void 0 ? void 0 : _c.length) !== null && _d !== void 0 ? _d : 0) > 0;
     var suggestedStep = getSuggestedStepFromSteps(steps, Boolean(previewResponse), isArchiveValid);
-    var canImport = steps.preview.status !== "pending" && isArchiveValid && steps.import.status !== "success" && !isProcessing && !isPreviewing;
+    var packageMode = getPackageMode(previewResponse, fallbackMode);
+    var isUpdate = packageMode === "update";
+    var workflowLabels = getWorkflowLabels(previewResponse, fallbackMode);
+    var packageModuleName = ((_f = (_e = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _e === void 0 ? void 0 : _e.module) === null || _f === void 0 ? void 0 : _f.name) || (previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.moduleName) || targetModuleName || "this module";
+    var installedVersion = (_j = (_g = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.installedVersion) !== null && _g !== void 0 ? _g : (_h = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _h === void 0 ? void 0 : _h.installedVersion) !== null && _j !== void 0 ? _j : null;
+    var incomingVersion = (_m = (_k = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.incomingVersion) !== null && _k !== void 0 ? _k : (_l = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _l === void 0 ? void 0 : _l.incomingVersion) !== null && _m !== void 0 ? _m : null;
+    var versionComparison = (_q = (_o = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.versionComparison) !== null && _o !== void 0 ? _o : (_p = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _p === void 0 ? void 0 : _p.versionComparison) !== null && _q !== void 0 ? _q : null;
+    var requiresVersionAcknowledgement = Boolean((_r = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _r === void 0 ? void 0 : _r.requiresVersionAcknowledgement);
+    // Clicking the Update button approves the shown version; risky updates also need an explicit acknowledgement.
+    var isUpdateApproved = !isUpdate || !requiresVersionAcknowledgement || acknowledgeVersionChange;
+    var backup = (_s = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.backup) !== null && _s !== void 0 ? _s : null;
+    var canImport = steps.preview.status !== "pending" && isArchiveValid && isUpdateApproved && steps.import.status !== "success" && !isProcessing && !isPreviewing;
+    var canRestore = Boolean(backup && transactionKey) && steps.import.status !== "pending" && !isProcessing;
+    var isRestoreInterrupted = (previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.status) === "restore_running";
     var canRunBuild = steps.import.status === "success" && !isProcessing;
     var canRunSeed = (steps.build.status === "success" || steps.build.status === "warning") && !isProcessing;
     var canContinueFromPreview = Boolean(previewResponse) && isArchiveValid && !isPreviewing;
@@ -278,6 +339,9 @@ export function ModulePackageImportContent(_a) {
                     }
                     formData = new FormData();
                     formData.append("modulePackage", selectedFile);
+                    if (targetModuleName) {
+                        formData.append("expectedModuleName", targetModuleName);
+                    }
                     _e.label = 1;
                 case 1:
                     _e.trys.push([1, 3, 4, 5]);
@@ -288,15 +352,17 @@ export function ModulePackageImportContent(_a) {
                     setPreviewResponse(response);
                     setTransactionKey((_a = response === null || response === void 0 ? void 0 : response.transactionKey) !== null && _a !== void 0 ? _a : null);
                     setOverwriteExisting(false);
+                    setAcknowledgeVersionChange(false);
+                    setShowAllFiles(false);
                     setFinalSummary(null);
-                    setSteps(hydrateStepsFromTransaction(response));
+                    setSteps(hydrateStepsFromTransaction(response, fallbackMode));
                     setSelectedStep("preview");
                     dispatch(showToast({
                         severity: ((_b = response === null || response === void 0 ? void 0 : response.validation) === null || _b === void 0 ? void 0 : _b.valid) ? "success" : "warn",
                         summary: ((_c = response === null || response === void 0 ? void 0 : response.validation) === null || _c === void 0 ? void 0 : _c.valid) ? "Archive validated" : "Archive needs attention",
                         detail: ((_d = response === null || response === void 0 ? void 0 : response.validation) === null || _d === void 0 ? void 0 : _d.valid)
-                            ? "Review the preview and continue with the import when you are ready."
-                            : "The uploaded archive is missing one or more required SolidX validation markers.",
+                            ? "Review the preview and continue with the ".concat(getWorkflowLabels(response, fallbackMode).noun, " when you are ready.")
+                            : "The uploaded archive has validation issues. Review them below.",
                     }));
                     return [3 /*break*/, 5];
                 case 3:
@@ -309,7 +375,7 @@ export function ModulePackageImportContent(_a) {
                 case 5: return [2 /*return*/];
             }
         });
-    }); }, [dispatch, selectedFile, validateModulePackageImport]);
+    }); }, [dispatch, fallbackMode, selectedFile, targetModuleName, validateModulePackageImport]);
     useEffect(function () {
         if (!selectedFile) {
             lastAutoPreviewFileRef.current = null;
@@ -359,11 +425,12 @@ export function ModulePackageImportContent(_a) {
                 case 0:
                     updateStep("seed", {
                         status: "running",
-                        description: "Running `solidctl seed --modules-to-seed` for the imported module.",
+                        description: "Running `solidctl seed --modules-to-seed".concat(pruneOnSeed ? " --prune" : "", "` for the ").concat(workflowLabels.past, " module."),
                     });
                     return [4 /*yield*/, runModulePackageSeed({
                             transactionKey: activeTransactionKey,
                             seedGlobalMetadata: false,
+                            prune: pruneOnSeed,
                         }).unwrap()];
                 case 1:
                     seedResponse = _b.sent();
@@ -378,7 +445,7 @@ export function ModulePackageImportContent(_a) {
                     return [2 /*return*/, seedResponse];
             }
         });
-    }); }, [runModulePackageSeed, updateStep]);
+    }); }, [pruneOnSeed, runModulePackageSeed, updateStep, workflowLabels.past]);
     var handleRunBuild = useCallback(function () { return __awaiter(_this, void 0, void 0, function () {
         var buildResponse, error_2;
         return __generator(this, function (_a) {
@@ -440,14 +507,14 @@ export function ModulePackageImportContent(_a) {
                         onImported === null || onImported === void 0 ? void 0 : onImported();
                     }
                     if (buildFailed && !seedFailed) {
-                        setFinalSummary("Module imported and seeded successfully, but the build step reported errors.");
+                        setFinalSummary("Module ".concat(workflowLabels.past, " and seeded successfully, but the build step reported errors."));
                         return [2 /*return*/];
                     }
                     if (seedFailed) {
-                        setFinalSummary("Module imported, but the seed step needs attention.");
+                        setFinalSummary("Module ".concat(workflowLabels.past, ", but the seed step needs attention."));
                         return [2 /*return*/];
                     }
-                    setFinalSummary("Module import completed successfully.");
+                    setFinalSummary("Module ".concat(workflowLabels.noun, " completed successfully."));
                     return [3 /*break*/, 4];
                 case 3:
                     error_3 = _c.sent();
@@ -461,14 +528,14 @@ export function ModulePackageImportContent(_a) {
                 case 4: return [2 /*return*/];
             }
         });
-    }); }, [dispatch, executeSeedStep, onImported, (_e = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.outputs) === null || _e === void 0 ? void 0 : _e.build, steps.build.status, transactionKey, updateStep]);
+    }); }, [dispatch, executeSeedStep, onImported, (_t = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.outputs) === null || _t === void 0 ? void 0 : _t.build, steps.build.status, transactionKey, updateStep, workflowLabels.noun, workflowLabels.past]);
     useEffect(function () {
         if (!initialTransactionKey || hasResumedTransactionRef.current) {
             return;
         }
         hasResumedTransactionRef.current = true;
         var loadTransaction = function () { return __awaiter(_this, void 0, void 0, function () {
-            var transaction, hydratedSteps, error_4;
+            var transaction, hydratedSteps, labels, error_4;
             var _a, _b;
             return __generator(this, function (_c) {
                 switch (_c.label) {
@@ -477,17 +544,19 @@ export function ModulePackageImportContent(_a) {
                         return [4 /*yield*/, fetchModulePackageImportStatus({ transactionKey: initialTransactionKey }).unwrap()];
                     case 1:
                         transaction = _c.sent();
-                        hydratedSteps = hydrateStepsFromTransaction(transaction);
+                        hydratedSteps = hydrateStepsFromTransaction(transaction, fallbackMode);
+                        labels = getWorkflowLabels(transaction, fallbackMode);
                         setPreviewResponse(transaction);
                         setTransactionKey((_a = transaction === null || transaction === void 0 ? void 0 : transaction.transactionKey) !== null && _a !== void 0 ? _a : null);
                         setSteps(hydratedSteps);
+                        setPruneOnSeed(Boolean(transaction === null || transaction === void 0 ? void 0 : transaction.restoredFromBackup));
                         setSelectedStep(getSuggestedStepFromSteps(hydratedSteps, Boolean((transaction === null || transaction === void 0 ? void 0 : transaction.preview) || (transaction === null || transaction === void 0 ? void 0 : transaction.validation)), Boolean((_b = transaction === null || transaction === void 0 ? void 0 : transaction.validation) === null || _b === void 0 ? void 0 : _b.valid)));
                         if ((transaction === null || transaction === void 0 ? void 0 : transaction.status) === "completed") {
-                            setFinalSummary("Module import completed successfully.");
+                            setFinalSummary("Module ".concat(labels.noun, " completed successfully."));
                             return [2 /*return*/];
                         }
                         if ((transaction === null || transaction === void 0 ? void 0 : transaction.status) === "seed_failed") {
-                            setFinalSummary("Module imported, but the seed step needs attention.");
+                            setFinalSummary("Module ".concat(labels.past, ", but the seed step needs attention."));
                             return [2 /*return*/];
                         }
                         if (!autoResume || !isResumableModulePackageStatus(transaction === null || transaction === void 0 ? void 0 : transaction.status)) {
@@ -503,7 +572,7 @@ export function ModulePackageImportContent(_a) {
             });
         }); };
         void loadTransaction();
-    }, [autoResume, dispatch, fetchModulePackageImportStatus, initialTransactionKey]);
+    }, [autoResume, dispatch, fallbackMode, fetchModulePackageImportStatus, initialTransactionKey]);
     var handleStartImport = function () { return __awaiter(_this, void 0, void 0, function () {
         var response, error_5;
         var _a;
@@ -521,12 +590,13 @@ export function ModulePackageImportContent(_a) {
                     setFinalSummary(null);
                     updateStep("import", {
                         status: "running",
-                        description: "Extracting the archive and placing files into `solid-api` and `solid-ui`.",
+                        description: isUpdate
+                            ? "Backing up the current module folders and placing the new version into `solid-api` and `solid-ui`."
+                            : "Extracting the archive and placing files into `solid-api` and `solid-ui`.",
                     });
-                    return [4 /*yield*/, confirmModulePackageImport({
-                            transactionKey: transactionKey,
-                            overwriteExisting: overwriteExisting,
-                        }).unwrap()];
+                    return [4 /*yield*/, confirmModulePackageImport(isUpdate
+                            ? { transactionKey: transactionKey, confirmedVersion: incomingVersion, acknowledgeVersionChange: acknowledgeVersionChange }
+                            : { transactionKey: transactionKey, overwriteExisting: overwriteExisting }).unwrap()];
                 case 2:
                     response = _b.sent();
                     updateStep("import", {
@@ -538,8 +608,10 @@ export function ModulePackageImportContent(_a) {
                     setIsProcessing(false);
                     dispatch(showToast({
                         severity: "success",
-                        summary: "Module imported",
-                        detail: "The module files were placed locally. Wait for the UI and API to restart, then refresh this module list page to continue with build and seed.",
+                        summary: isUpdate ? "Module updated" : "Module imported",
+                        detail: isUpdate
+                            ? "".concat(packageModuleName, " was updated to ").concat(formatVersionLabel(incomingVersion), ". Wait for the UI and API to restart, then refresh this module list page to continue with build and seed.")
+                            : "The module files were placed locally. Wait for the UI and API to restart, then refresh this module list page to continue with build and seed.",
                     }));
                     onClose();
                     return [3 /*break*/, 4];
@@ -549,13 +621,50 @@ export function ModulePackageImportContent(_a) {
                         status: "error",
                         description: getErrorMessage(error_5),
                     });
-                    setFinalSummary("The module import could not be completed.");
+                    setFinalSummary("The module ".concat(workflowLabels.noun, " could not be completed."));
                     setIsProcessing(false);
                     return [3 /*break*/, 4];
                 case 4: return [2 /*return*/];
             }
         });
     }); };
+    var handleRestore = function () { return __awaiter(_this, void 0, void 0, function () {
+        var response, error_6;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!transactionKey || !backup) {
+                        return [2 /*return*/];
+                    }
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 3, , 4]);
+                    setIsProcessing(true);
+                    setFinalSummary(null);
+                    return [4 /*yield*/, restoreModulePackageImport({ transactionKey: transactionKey }).unwrap()];
+                case 2:
+                    response = _a.sent();
+                    setPreviewResponse(response);
+                    setSteps(hydrateStepsFromTransaction(response, fallbackMode));
+                    setPruneOnSeed(true);
+                    setRestoreConfirmOpen(false);
+                    setIsProcessing(false);
+                    dispatch(showToast({
+                        severity: "success",
+                        summary: "Previous version restored",
+                        detail: "".concat(packageModuleName, " ").concat(formatVersionLabel(backup.version), " was put back. Wait for the UI and API to restart, then refresh this module list page to continue with build and seed."),
+                    }));
+                    onClose();
+                    return [3 /*break*/, 4];
+                case 3:
+                    error_6 = _a.sent();
+                    setIsProcessing(false);
+                    dispatch(showToast({ severity: "error", summary: "Restore failed", detail: getErrorMessage(error_6) }));
+                    return [3 /*break*/, 4];
+                case 4: return [2 /*return*/];
+            }
+        });
+    }); };
     var handleClose = function () {
         if (isProcessing)
             return;
@@ -564,8 +673,37 @@ export function ModulePackageImportContent(_a) {
         }
         onClose();
     };
+    var renderVersionApproval = function () {
+        var _a, _b;
+        var comparison = (_a = VERSION_COMPARISONS[versionComparison !== null && versionComparison !== void 0 ? versionComparison : ""]) !== null && _a !== void 0 ? _a : { label: "Update", tone: "neutral" };
+        var identicalContent = Boolean((_b = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _b === void 0 ? void 0 : _b.identicalContent);
+        var acknowledgementLabel = identicalContent
+            ? "Reinstall anyway, even though the content is identical"
+            : versionComparison === "same"
+                ? "I understand this reinstalls ".concat(formatVersionLabel(installedVersion))
+                : versionComparison === "downgrade"
+                    ? "I understand this downgrades ".concat(packageModuleName, " to ").concat(formatVersionLabel(incomingVersion))
+                    : "I understand this package has no version";
+        return (_jsxs("div", { className: "solid-module-package-notice".concat(comparison.tone === "danger" ? " is-danger" : comparison.tone === "warning" ? " is-warning" : ""), children: [_jsx("div", { className: "solid-module-package-notice__title", children: "Version change" }), _jsxs("div", { className: "solid-module-package-version", children: [_jsx("span", { className: "solid-module-package-version__value", children: formatVersionLabel(installedVersion) }), _jsx(ArrowRight, { size: 14, "aria-label": "to" }), _jsx("span", { className: "solid-module-package-version__value", children: formatVersionLabel(incomingVersion) }), _jsx("span", { className: "solid-module-package-version__badge is-".concat(comparison.tone), children: comparison.label })] }), isArchiveValid && requiresVersionAcknowledgement ? (_jsx(SolidCheckbox, { checked: acknowledgeVersionChange, onChange: function (event) { return setAcknowledgeVersionChange(event.currentTarget.checked); }, label: acknowledgementLabel })) : null] }));
+    };
+    var renderChangeSummary = function () {
+        var _a, _b;
+        var changeSet = (_a = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _a === void 0 ? void 0 : _a.changeSet;
+        if (!changeSet)
+            return null;
+        var sides = [["solid-api", changeSet.solidApi], ["solid-ui", changeSet.solidUi]];
+        return (_jsxs("div", { className: "solid-module-package-checklist__section", children: [_jsx("div", { className: "solid-module-package-checklist__title", children: "Files that will change" }), ((_b = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _b === void 0 ? void 0 : _b.identicalContent) ? (_jsx("p", { className: "solid-module-package-diff__empty", children: "No file changes. The package content matches the installed module." })) : null, sides.map(function (_a) {
+                    var _b, _c, _d, _e;
+                    var label = _a[0], diff = _a[1];
+                    var added = (_b = diff === null || diff === void 0 ? void 0 : diff.added) !== null && _b !== void 0 ? _b : [];
+                    var modified = (_c = diff === null || diff === void 0 ? void 0 : diff.modified) !== null && _c !== void 0 ? _c : [];
+                    var removed = (_d = diff === null || diff === void 0 ? void 0 : diff.removed) !== null && _d !== void 0 ? _d : [];
+                    var hasChanges = added.length + modified.length + removed.length > 0;
+                    return (_jsxs("details", { className: "solid-module-package-diff", children: [_jsxs("summary", { children: [_jsx("span", { className: "solid-module-package-diff__side", children: label }), _jsxs("span", { className: "is-added", children: ["+", added.length] }), _jsxs("span", { className: "is-modified", children: ["~", modified.length] }), _jsxs("span", { className: "is-removed", children: ["\u2212", removed.length] }), _jsxs("span", { className: "solid-module-package-diff__unchanged", children: [(_e = diff === null || diff === void 0 ? void 0 : diff.unchangedCount) !== null && _e !== void 0 ? _e : 0, " unchanged"] })] }), _jsxs("ul", { className: "solid-module-package-diff__list", children: [added.map(function (file) { return _jsxs("li", { className: "is-added", children: ["+ ", file] }, "a:".concat(file)); }), modified.map(function (file) { return _jsxs("li", { className: "is-modified", children: ["~ ", file] }, "m:".concat(file)); }), removed.map(function (file) { return _jsxs("li", { className: "is-removed", children: ["\u2212 ", file] }, "r:".concat(file)); }), !hasChanges ? _jsx("li", { children: "No changes" }) : null] })] }, label));
+                })] }));
+    };
     var renderPreviewContent = function () {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0;
         return (_jsxs("div", { className: "solid-module-package-preview", children: [!selectedFile ? (_jsxs("div", __assign({}, getRootProps({
                     className: "solid-module-package-dropzone".concat(isDragActive ? " is-active" : ""),
                 }), { children: [_jsx("input", __assign({}, getInputProps())), _jsx("div", { className: "solid-module-package-dropzone__icon", children: _jsx(UploadCloud, { size: 22 }) }), _jsxs("div", { className: "solid-module-package-dropzone__copy", children: [_jsx("div", { className: "solid-module-package-dropzone__title", children: "Upload `.sldx` archive" }), _jsx("p", { children: "Choose a packaged SolidX module archive from the local file system. Preview starts automatically after upload." })] }), _jsx("div", { className: "solid-module-package-dropzone__actions", children: _jsx(SolidButton, { type: "button", size: "small", variant: "outline", onClick: function (event) {
@@ -576,25 +714,30 @@ export function ModulePackageImportContent(_a) {
                                 setPreviewResponse(null);
                                 setTransactionKey(null);
                                 setOverwriteExisting(false);
+                                setAcknowledgeVersionChange(false);
                                 setFinalSummary(null);
                                 setSelectedStep("preview");
-                                setSteps(createInitialSteps());
+                                setSteps(createInitialSteps(fallbackMode));
                             }, disabled: isProcessing, children: "Remove" })] })), !previewResponse ? (_jsxs("div", { className: "solid-module-package-empty", children: [isPreviewing ? _jsx(SolidSpinner, { size: 18 }) : _jsx(FolderTree, { size: 18 }), _jsx("p", { children: isPreviewing
                                 ? "Reading the archive and validating the SolidX markers."
-                                : "Upload an archive to start the automatic preview and validation flow." })] })) : (_jsxs(_Fragment, { children: [_jsxs("div", { className: "solid-module-package-metrics", children: [_jsxs("div", { className: "solid-module-package-metric", children: [_jsx("span", { className: "solid-module-package-metric__label", children: "Module" }), _jsx("span", { className: "solid-module-package-metric__value", children: ((_b = (_a = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _a === void 0 ? void 0 : _a.module) === null || _b === void 0 ? void 0 : _b.name) || "Unknown" })] }), _jsxs("div", { className: "solid-module-package-metric", children: [_jsx("span", { className: "solid-module-package-metric__label", children: "solid-api files" }), _jsx("span", { className: "solid-module-package-metric__value", children: (_e = (_d = (_c = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _c === void 0 ? void 0 : _c.contentsSummary) === null || _d === void 0 ? void 0 : _d.solidApiEntries) !== null && _e !== void 0 ? _e : 0 })] }), _jsxs("div", { className: "solid-module-package-metric", children: [_jsx("span", { className: "solid-module-package-metric__label", children: "solid-ui files" }), _jsx("span", { className: "solid-module-package-metric__value", children: (_h = (_g = (_f = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _f === void 0 ? void 0 : _f.contentsSummary) === null || _g === void 0 ? void 0 : _g.solidUiEntries) !== null && _h !== void 0 ? _h : 0 })] })] }), _jsxs("div", { className: "solid-module-package-checklist", children: [_jsxs("div", { className: "solid-module-package-checklist__section", children: [_jsx("div", { className: "solid-module-package-checklist__title", children: "Required markers" }), _jsxs("ul", { className: "solid-module-package-inline-list", children: [_jsx("li", { children: (_k = (_j = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _j === void 0 ? void 0 : _j.requiredPaths) === null || _k === void 0 ? void 0 : _k.metadataPath }), _jsx("li", { children: (_m = (_l = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _l === void 0 ? void 0 : _l.requiredPaths) === null || _m === void 0 ? void 0 : _m.apiModulePath }), _jsx("li", { children: (_p = (_o = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _o === void 0 ? void 0 : _o.requiredPaths) === null || _p === void 0 ? void 0 : _p.uiModulePath })] })] }), ((_s = (_r = (_q = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.validation) === null || _q === void 0 ? void 0 : _q.warnings) === null || _r === void 0 ? void 0 : _r.length) !== null && _s !== void 0 ? _s : 0) > 0 ? (_jsxs("div", { className: "solid-module-package-notice is-warning", children: [_jsx("div", { className: "solid-module-package-notice__title", children: "Warnings" }), _jsx("ul", { className: "solid-module-package-inline-list", children: previewResponse.validation.warnings.map(function (warning) { return (_jsx("li", { children: warning }, warning)); }) })] })) : null, ((_v = (_u = (_t = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.validation) === null || _t === void 0 ? void 0 : _t.errors) === null || _u === void 0 ? void 0 : _u.length) !== null && _v !== void 0 ? _v : 0) > 0 ? (_jsxs("div", { className: "solid-module-package-notice is-danger", children: [_jsx("div", { className: "solid-module-package-notice__title", children: "Validation issues" }), _jsx("ul", { className: "solid-module-package-inline-list", children: previewResponse.validation.errors.map(function (error) { return (_jsx("li", { children: error }, error)); }) })] })) : null, hasConflicts ? (_jsxs("div", { className: "solid-module-package-notice is-warning", children: [_jsx("div", { className: "solid-module-package-notice__title", children: "Existing files detected" }), _jsx("ul", { className: "solid-module-package-inline-list", children: previewResponse.conflicts.map(function (conflict) { return (_jsx("li", { children: conflict }, conflict)); }) }), _jsx(SolidCheckbox, { checked: overwriteExisting, onChange: function (event) { return setOverwriteExisting(event.currentTarget.checked); }, label: "Overwrite the existing module folders during import" })] })) : null] }), _jsx("div", { className: "solid-module-package-tree", children: ((_x = (_w = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _w === void 0 ? void 0 : _w.fileTree) !== null && _x !== void 0 ? _x : []).map(function (entry) { return (_jsx("div", { className: "solid-module-package-tree__row", children: entry }, entry)); }) })] }))] }));
+                                : "Upload an archive to start the automatic preview and validation flow." })] })) : (_jsxs(_Fragment, { children: [_jsxs("div", { className: "solid-module-package-metrics", children: [_jsxs("div", { className: "solid-module-package-metric", children: [_jsx("span", { className: "solid-module-package-metric__label", children: "Module" }), _jsx("span", { className: "solid-module-package-metric__value", children: ((_b = (_a = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _a === void 0 ? void 0 : _a.module) === null || _b === void 0 ? void 0 : _b.name) || "Unknown" })] }), _jsxs("div", { className: "solid-module-package-metric", children: [_jsx("span", { className: "solid-module-package-metric__label", children: "solid-api files" }), _jsx("span", { className: "solid-module-package-metric__value", children: (_e = (_d = (_c = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _c === void 0 ? void 0 : _c.contentsSummary) === null || _d === void 0 ? void 0 : _d.solidApiEntries) !== null && _e !== void 0 ? _e : 0 })] }), _jsxs("div", { className: "solid-module-package-metric", children: [_jsx("span", { className: "solid-module-package-metric__label", children: "solid-ui files" }), _jsx("span", { className: "solid-module-package-metric__value", children: (_h = (_g = (_f = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _f === void 0 ? void 0 : _f.contentsSummary) === null || _g === void 0 ? void 0 : _g.solidUiEntries) !== null && _h !== void 0 ? _h : 0 })] })] }), _jsxs("div", { className: "solid-module-package-checklist", children: [isUpdate ? renderVersionApproval() : null, isUpdate ? renderChangeSummary() : null, _jsxs("div", { className: "solid-module-package-checklist__section", children: [_jsx("div", { className: "solid-module-package-checklist__title", children: "Required markers" }), _jsxs("ul", { className: "solid-module-package-inline-list", children: [_jsx("li", { children: (_k = (_j = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _j === void 0 ? void 0 : _j.requiredPaths) === null || _k === void 0 ? void 0 : _k.metadataPath }), _jsx("li", { children: (_m = (_l = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _l === void 0 ? void 0 : _l.requiredPaths) === null || _m === void 0 ? void 0 : _m.apiModulePath }), _jsx("li", { children: (_p = (_o = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _o === void 0 ? void 0 : _o.requiredPaths) === null || _p === void 0 ? void 0 : _p.uiModulePath })] })] }), ((_s = (_r = (_q = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.validation) === null || _q === void 0 ? void 0 : _q.warnings) === null || _r === void 0 ? void 0 : _r.length) !== null && _s !== void 0 ? _s : 0) > 0 ? (_jsxs("div", { className: "solid-module-package-notice is-warning", children: [_jsx("div", { className: "solid-module-package-notice__title", children: "Warnings" }), _jsx("ul", { className: "solid-module-package-inline-list", children: previewResponse.validation.warnings.map(function (warning) { return (_jsx("li", { children: warning }, warning)); }) })] })) : null, ((_v = (_u = (_t = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.validation) === null || _t === void 0 ? void 0 : _t.errors) === null || _u === void 0 ? void 0 : _u.length) !== null && _v !== void 0 ? _v : 0) > 0 ? (_jsxs("div", { className: "solid-module-package-notice is-danger", children: [_jsx("div", { className: "solid-module-package-notice__title", children: "Validation issues" }), _jsx("ul", { className: "solid-module-package-inline-list", children: previewResponse.validation.errors.map(function (error) { return (_jsx("li", { children: error }, error)); }) })] })) : null, hasConflicts && !isUpdate ? (_jsxs("div", { className: "solid-module-package-notice is-warning", children: [_jsx("div", { className: "solid-module-package-notice__title", children: "Existing files detected" }), _jsx("ul", { className: "solid-module-package-inline-list", children: previewResponse.conflicts.map(function (conflict) { return (_jsx("li", { children: conflict }, conflict)); }) }), _jsx(SolidCheckbox, { checked: overwriteExisting, onChange: function (event) { return setOverwriteExisting(event.currentTarget.checked); }, label: "Overwrite the existing module folders during import" })] })) : null] }), isUpdate ? (_jsx("div", { children: _jsx(SolidButton, { type: "button", size: "small", variant: "ghost", onClick: function () { return setShowAllFiles(function (current) { return !current; }); }, children: showAllFiles ? "Hide package files" : "Show all package files (".concat((_y = (_x = (_w = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _w === void 0 ? void 0 : _w.fileTree) === null || _x === void 0 ? void 0 : _x.length) !== null && _y !== void 0 ? _y : 0, ")") }) })) : null, !isUpdate || showAllFiles ? (_jsx("div", { className: "solid-module-package-tree", children: ((_0 = (_z = previewResponse === null || previewResponse === void 0 ? void 0 : previewResponse.preview) === null || _z === void 0 ? void 0 : _z.fileTree) !== null && _0 !== void 0 ? _0 : []).map(function (entry) { return (_jsx("div", { className: "solid-module-package-tree__row", children: entry }, entry)); }) })) : null] }))] }));
     };
     var renderActiveStepCta = function () {
         if (activeStep === "preview") {
-            return (_jsx(SolidButton, { type: "button", size: "small", onClick: function () { return setSelectedStep("import"); }, disabled: !canContinueFromPreview, rightIcon: _jsx(Sparkles, { size: 14 }), children: "Continue to import" }));
+            return (_jsx(SolidButton, { type: "button", size: "small", onClick: function () { return setSelectedStep("import"); }, disabled: !canContinueFromPreview || !isUpdateApproved, rightIcon: _jsx(Sparkles, { size: 14 }), children: isUpdate ? "Continue to update" : "Continue to import" }));
+        }
+        var restoreButton = backup && !isRestoreConfirmOpen ? (_jsxs(SolidButton, { type: "button", size: "small", variant: "ghost", onClick: function () { return setRestoreConfirmOpen(true); }, disabled: !canRestore, leftIcon: _jsx(RotateCcw, { size: 14 }), children: ["Restore ", formatVersionLabel(backup.version)] })) : null;
+        if (activeStep === "import" && isRestoreInterrupted) {
+            return restoreButton;
         }
         if (activeStep === "import") {
-            return (_jsx(SolidButton, { type: "button", size: "small", onClick: handleStartImport, disabled: !canImport, loading: isProcessing && steps.import.status === "running", leftIcon: _jsx(Sparkles, { size: 14 }), children: "Import Module" }));
+            return (_jsx(SolidButton, { type: "button", size: "small", onClick: handleStartImport, disabled: !canImport, loading: isProcessing && steps.import.status === "running", leftIcon: _jsx(Sparkles, { size: 14 }), children: isUpdate ? "Update to ".concat(formatVersionLabel(incomingVersion)) : "Import Module" }));
         }
         if (activeStep === "build") {
-            return (_jsx(SolidButton, { type: "button", size: "small", variant: "outline", onClick: handleRunBuild, disabled: !canRunBuild, loading: isProcessing && steps.build.status === "running", children: steps.build.status === "success" || steps.build.status === "warning" ? "Build Again" : "Build Now" }));
+            return (_jsxs(_Fragment, { children: [restoreButton, _jsx(SolidButton, { type: "button", size: "small", variant: "outline", onClick: handleRunBuild, disabled: !canRunBuild, loading: isProcessing && steps.build.status === "running", children: steps.build.status === "success" || steps.build.status === "warning" ? "Build Again" : "Build Now" })] }));
         }
         if (activeStep === "seed") {
-            return (_jsx(SolidButton, { type: "button", size: "small", variant: "outline", onClick: handleRunSeed, disabled: !canRunSeed, loading: isProcessing && steps.seed.status === "running", children: steps.seed.status === "success" || steps.seed.status === "warning" ? "Seed Again" : "Seed" }));
+            return (_jsxs(_Fragment, { children: [restoreButton, _jsx(SolidButton, { type: "button", size: "small", variant: "outline", onClick: handleRunSeed, disabled: !canRunSeed, loading: isProcessing && steps.seed.status === "running", children: steps.seed.status === "success" || steps.seed.status === "warning" ? "Seed Again" : "Seed" })] }));
         }
         return null;
     };
@@ -602,18 +745,23 @@ export function ModulePackageImportContent(_a) {
         if (activeStep === "preview") {
             return renderPreviewContent();
         }
+        var restoreConfirm = isRestoreConfirmOpen && backup ? (_jsxs("div", { className: "solid-module-package-notice is-danger", children: [_jsxs("div", { className: "solid-module-package-notice__title", children: ["Restore ", formatVersionLabel(backup.version), "?"] }), _jsxs("ul", { className: "solid-module-package-inline-list", children: [_jsxs("li", { children: ["This puts back the ", packageModuleName, " folders from before this update (", formatVersionLabel(backup.version), ")."] }), _jsx("li", { children: "When the API restarts, the database schema is synced to that code: columns added by the newer version are dropped along with their data, and tables it added are left in place." }), _jsx("li", { children: "Back up the database first if this module has data you care about." }), _jsx("li", { children: "After the restart, refresh this page and run build and seed again. Prune is turned on for that seed." })] }), _jsxs("div", { className: "solid-module-package-notice__actions", children: [_jsx(SolidButton, { type: "button", size: "small", variant: "ghost", onClick: function () { return setRestoreConfirmOpen(false); }, disabled: isProcessing, children: "Cancel" }), _jsxs(SolidButton, { type: "button", size: "small", variant: "destructive", onClick: handleRestore, disabled: !canRestore, loading: isProcessing, leftIcon: _jsx(RotateCcw, { size: 14 }), children: ["Restore ", formatVersionLabel(backup.version)] })] })] })) : null;
         if (activeStep === "import") {
-            return (_jsxs("div", { className: "solid-module-package-step-stack", children: [_jsxs("div", { className: "solid-module-package-notice is-warning", children: [_jsx("div", { className: "solid-module-package-notice__title", children: "What happens after import" }), _jsxs("ul", { className: "solid-module-package-inline-list", children: [_jsx("li", { children: "Depending on the files in this archive, both the UI and API services may restart immediately." }), _jsx("li", { children: "This popup may get dismissed as part of that restart." }), _jsx("li", { children: "Wait for both services to come back, then refresh this module list page to continue with build and seed." })] })] }), steps.import.output ? _jsx("pre", { className: "solid-module-package-step__output", children: steps.import.output }) : null] }));
+            return (_jsxs("div", { className: "solid-module-package-step-stack", children: [_jsxs("div", { className: "solid-module-package-notice is-warning", children: [_jsx("div", { className: "solid-module-package-notice__title", children: isUpdate ? "What happens during the update" : "What happens after import" }), _jsxs("ul", { className: "solid-module-package-inline-list", children: [isUpdate ? (_jsxs(_Fragment, { children: [_jsxs("li", { children: ["The current ", packageModuleName, " folders in solid-api and solid-ui are backed up, then replaced with ", formatVersionLabel(incomingVersion), ". Files the new version no longer has are removed."] }), _jsx("li", { children: "Local changes made inside these folders are kept only in the backup." })] })) : null, _jsx("li", { children: "Depending on the files in this archive, both the UI and API services may restart immediately." }), _jsx("li", { children: "This popup may get dismissed as part of that restart." }), _jsx("li", { children: "Wait for both services to come back, then refresh this module list page to continue with build and seed." })] })] }), restoreConfirm, steps.import.output ? _jsx("pre", { className: "solid-module-package-step__output", children: steps.import.output }) : null] }));
         }
-        if (activeStep === "build" && steps.build.output) {
-            return _jsx("pre", { className: "solid-module-package-step__output", children: steps.build.output });
+        if (activeStep === "build") {
+            if (!restoreConfirm && !steps.build.output)
+                return null;
+            return (_jsxs("div", { className: "solid-module-package-step-stack", children: [restoreConfirm, steps.build.output ? _jsx("pre", { className: "solid-module-package-step__output", children: steps.build.output }) : null] }));
         }
-        if (activeStep === "seed" && steps.seed.output) {
-            return _jsx("pre", { className: "solid-module-package-step__output", children: steps.seed.output });
+        if (activeStep === "seed") {
+            return (_jsxs("div", { className: "solid-module-package-step-stack", children: [restoreConfirm, isUpdate ? (_jsx(SolidCheckbox, { checked: pruneOnSeed, onChange: function (event) { return setPruneOnSeed(event.currentTarget.checked); }, disabled: isProcessing, label: "Remove metadata this module no longer defines (prune). This also removes permissions for endpoints that no longer exist." })) : null, steps.seed.output ? _jsx("pre", { className: "solid-module-package-step__output", children: steps.seed.output }) : null] }));
         }
         return null;
     };
-    return (_jsxs(_Fragment, { children: [_jsxs(SolidDialogHeader, { className: "solid-filter-dialog-head solid-module-package-dialog__header", children: [_jsxs("div", { children: [_jsx(SolidDialogTitle, { className: "solid-filter-dialog-title m-0", children: "Import Module Package" }), _jsx(SolidDialogDescription, { className: "solid-filter-dialog-subtitle m-0", children: "Upload a `.sldx` archive, let SolidX preview it automatically, then move through import, build, and seed." })] }), !isProcessing ? (_jsx("button", { type: "button", className: "solid-filter-dialog-close solid-radix-dialog-close", "aria-label": "Close", onClick: handleClose, children: _jsx(X, { size: 16 }) })) : null] }), _jsx(SolidDialogSeparator, { className: "solid-filter-dialog-sep" }), _jsx(SolidDialogBody, { className: "solid-filter-dialog-body solid-module-package-dialog__body", children: _jsx("section", { className: "solid-module-package-shell", children: _jsxs("div", { className: "solid-module-package-panel solid-module-package-panel--wizard", children: [_jsx("div", { className: "solid-module-package-stepper", children: STEP_ORDER.map(function (stepKey, index) {
+    return (_jsxs(_Fragment, { children: [_jsxs(SolidDialogHeader, { className: "solid-filter-dialog-head solid-module-package-dialog__header", children: [_jsxs("div", { children: [_jsx(SolidDialogTitle, { className: "solid-filter-dialog-title m-0", children: isUpdate ? "Update ".concat(targetModuleName || packageModuleName) : "Import Module Package" }), _jsx(SolidDialogDescription, { className: "solid-filter-dialog-subtitle m-0", children: isUpdate
+                                    ? "Upload a `.sldx` archive of the new version, review the version change and the files that will change, then move through update, build, and seed."
+                                    : "Upload a `.sldx` archive, let SolidX preview it automatically, then move through import, build, and seed." })] }), !isProcessing ? (_jsx("button", { type: "button", className: "solid-filter-dialog-close solid-radix-dialog-close", "aria-label": "Close", onClick: handleClose, children: _jsx(X, { size: 16 }) })) : null] }), _jsx(SolidDialogSeparator, { className: "solid-filter-dialog-sep" }), _jsx(SolidDialogBody, { className: "solid-filter-dialog-body solid-module-package-dialog__body", children: _jsx("section", { className: "solid-module-package-shell", children: _jsxs("div", { className: "solid-module-package-panel solid-module-package-panel--wizard", children: [_jsx("div", { className: "solid-module-package-stepper", children: STEP_ORDER.map(function (stepKey, index) {
                                     var step = steps[stepKey];
                                     var isCurrent = activeStep === stepKey;
                                     var isDone = step.status === "success";