@ai-matrx/design-system 0.18.2 → 0.18.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.18.3 — 2026-09-12
+
+Reopening an Alchemy preparation now checks the current source while retaining
+manual drafts. Changed direct sources offer an explicit keep-or-regenerate
+choice, all-matching sources detect identity changes without eagerly fetching
+pages, and failed refreshes remain visible instead of silently reusing stale
+content.
+
+### Consumer action
+
+Update to 0.18.3. No host configuration changes are required.
+
 ## 0.18.2 — 2026-09-12
 
 Alchemy copy sessions now reset only when their explicit identity changes,

package/dist/content-transfer.cjs

@@ -1250,6 +1250,10 @@ function materialIdentity(material) {
   }
   return `payload:${id}`;
 }
+function snapshotContent(snapshot) {
+  const { sourceId, label, payload, coverage, unsavedChanges, omissions, sections, limits } = snapshot;
+  return JSON.stringify({ sourceId, label, payload, coverage, unsavedChanges, omissions, sections, limits });
+}
 function useFence() {
   const mounted = React8.useRef(true);
   const nextId = React8.useRef(0);
@@ -1352,7 +1356,7 @@ function ContentTransferMenuSession({ source, surface, label, projection, sectio
       const captured = await material.capture(signal);
       sourceMaterial = { id: captured.snapshot.sourceId, label: captured.snapshot.label, capture: async () => captured };
     } else if ("kind" in material) {
-      sourceMaterial = applyMenuProjection ? { id: "direct", label: sourceLabel, capture: async () => (0, import_content_transfer2.directSource)(material, { label: sourceLabel, ...projection ? { projection } : {}, ...sections ? { sections } : {} }) } : material;
+      sourceMaterial = { id: materialIdentity(material), label: sourceLabel, capture: async () => (0, import_content_transfer2.directSource)(material, { sourceId: materialIdentity(material), label: sourceLabel, ...applyMenuProjection && projection ? { projection } : {}, ...applyMenuProjection && sections ? { sections } : {} }) };
     } else if (applyMenuProjection && (projection || sections)) {
       sourceMaterial = {
         id: material.id,
@@ -1369,7 +1373,7 @@ function ContentTransferMenuSession({ source, surface, label, projection, sectio
     } else {
       sourceMaterial = material;
     }
-    const raw = "kind" in sourceMaterial ? (0, import_content_transfer2.directSource)(sourceMaterial) : await sourceMaterial.capture({ scope, signal });
+    const raw = await sourceMaterial.capture({ scope, signal });
     const constrained = (0, import_content_transfer2.resolveTransferPreferences)(providerPreferences, preferences, raw.snapshot.limits);
     const result = await (0, import_content_transfer2.capture)({ id: raw.snapshot.sourceId, label: raw.snapshot.label, capture: async () => ({ ...raw, snapshot: { ...raw.snapshot, limits: constrained.limits } }) }, signal, scope);
     if (scope !== "all-matching" || !collectPages) return result;
@@ -1429,31 +1433,117 @@ function ContentTransferMenuSession({ source, surface, label, projection, sectio
       fence.finish(controller);
     }
   }, [captureOne, capturePrimary, fence, formatSources, initialScope, preferences, providerPreferences, report, transport]);
-  const openWorkspace = React8.useCallback(async (key = primaryWorkspaceKey, variant) => {
-    const variantMaterial = variant && "kind" in variant.source ? { id: `variant:${key}`, label: variant.label, capture: async () => (0, import_content_transfer2.directSource)(variant.source, { label: variant.label }) } : variant?.source;
-    const captureWorkspace = variantMaterial ? (scope, signal) => captureOne(variantMaterial, scope, signal, true) : capturePrimary;
-    workspaceCaptures.current.set(key, captureWorkspace);
-    if (workspaces[key]) {
-      setWorkspaceKey(key);
-      setWorkspaceOpen(true);
-      return;
-    }
-    const { controller, id } = fence.begin();
-    try {
-      const result = await captureWorkspace(initialScope, controller.signal);
-      if (!fence.valid(id, controller)) return;
-      const resolved = (0, import_content_transfer2.resolveTransferPreferences)(providerPreferences, preferences, result.snapshot.limits);
-      const original = (0, import_content_transfer2.createDraft)(result.snapshot);
-      const base = { ...result, key, original, draft: original, scope: initialScope, preferences: resolved, ...result.collectionError ? { error: result.collectionError } : {} };
-      setWorkspaces((current) => ({ ...current, [key]: { ...base, draft: rebuild(base, initialControls(base)) } }));
-      setWorkspaceKey(key);
-      setWorkspaceOpen(true);
-    } catch (error) {
-      if (fence.valid(id, controller)) setNotice(errorMessage(error, "Could not capture content"));
-    } finally {
-      fence.finish(controller);
-    }
-  }, [captureOne, capturePrimary, fence, initialScope, preferences, primaryWorkspaceKey, providerPreferences, workspaces]);
+  const openWorkspace = React8.useCallback(
+    async (key = primaryWorkspaceKey, variant) => {
+      const variantMaterial = variant && "kind" in variant.source ? {
+        id: `variant:${key}`,
+        label: variant.label,
+        capture: async () => (0, import_content_transfer2.directSource)(variant.source, {
+          sourceId: `variant:${key}`,
+          label: variant.label
+        })
+      } : variant?.source;
+      const captureWorkspace = (scope, signal, collectPages = true) => captureOne(variantMaterial ?? primary, scope, signal, true, collectPages);
+      workspaceCaptures.current.set(key, captureWorkspace);
+      const existing = workspaces[key];
+      const { controller, id } = fence.begin();
+      if (existing) {
+        try {
+          const allMatching = existing.scope === "all-matching";
+          const fresh = await captureWorkspace(
+            existing.scope,
+            controller.signal,
+            !allMatching
+          );
+          if (!fence.valid(id, controller) || !workspaceCaptures.current.has(key))
+            return;
+          if (allMatching && (!existing.allMatching || !fresh.allMatching))
+            throw new Error(
+              "This source can no longer provide an all-matching snapshot."
+            );
+          const collectionIdentity = (value) => value && {
+            query: value.source.query,
+            projection: value.projection,
+            columns: value.columns,
+            limits: value.limits
+          };
+          const changed = allMatching ? JSON.stringify(collectionIdentity(existing.allMatching)) !== JSON.stringify(collectionIdentity(fresh.allMatching)) : snapshotContent(existing.snapshot) !== snapshotContent(fresh.snapshot);
+          setWorkspaces((current) => {
+            const retained = current[key];
+            if (!retained) return current;
+            return {
+              ...current,
+              [key]: {
+                ...retained,
+                error: fresh.collectionError,
+                ...allMatching ? { sourceStale: changed } : changed ? { pending: { ...fresh, scope: retained.scope } } : { pending: void 0 }
+              }
+            };
+          });
+          setWorkspaceKey(key);
+          setWorkspaceOpen(true);
+        } catch (error) {
+          if (fence.valid(id, controller) && workspaceCaptures.current.has(key)) {
+            setWorkspaces(
+              (current) => current[key] ? {
+                ...current,
+                [key]: {
+                  ...current[key],
+                  error: errorMessage(error, "Could not refresh source")
+                }
+              } : current
+            );
+            setWorkspaceKey(key);
+            setWorkspaceOpen(true);
+          }
+        } finally {
+          fence.finish(controller);
+        }
+        return;
+      }
+      try {
+        const result = await captureWorkspace(initialScope, controller.signal);
+        if (!fence.valid(id, controller)) return;
+        const resolved = (0, import_content_transfer2.resolveTransferPreferences)(
+          providerPreferences,
+          preferences,
+          result.snapshot.limits
+        );
+        const original = (0, import_content_transfer2.createDraft)(result.snapshot);
+        const base = {
+          ...result,
+          key,
+          original,
+          draft: original,
+          scope: initialScope,
+          preferences: resolved,
+          ...result.collectionError ? { error: result.collectionError } : {}
+        };
+        setWorkspaces((current) => ({
+          ...current,
+          [key]: { ...base, draft: rebuild(base, initialControls(base)) }
+        }));
+        setWorkspaceKey(key);
+        setWorkspaceOpen(true);
+      } catch (error) {
+        if (fence.valid(id, controller))
+          setNotice(errorMessage(error, "Could not capture content"));
+      } finally {
+        fence.finish(controller);
+      }
+    },
+    [
+      captureOne,
+      capturePrimary,
+      fence,
+      initialScope,
+      preferences,
+      primaryWorkspaceKey,
+      primary,
+      providerPreferences,
+      workspaces
+    ]
+  );
   React8.useImperativeHandle(controllerRef, () => ({
     focusTrigger: () => triggerRef.current?.focus(),
     prepare: async (requestedSource, options) => {
@@ -1676,7 +1766,7 @@ function PreparationWorkspace({ restoreFocus, open, state, scopes, onClose, onCh
     setBusy("capture");
     try {
       const result = await captureScope(scope, controller.signal);
-      if (fence.valid(id, controller) && latest.current.draft.revision === revision) onChange({ ...latest.current, pending: { ...result, scope }, error: result.collectionError });
+      if (fence.valid(id, controller) && latest.current.draft.revision === revision) onChange({ ...latest.current, pending: { ...result, scope }, sourceStale: false, error: result.collectionError });
     } catch (error) {
       if (fence.valid(id, controller)) onChange({ ...latest.current, error: errorMessage(error, "Refresh failed") });
     } finally {
@@ -1919,6 +2009,7 @@ function PreparationWorkspace({ restoreFocus, open, state, scopes, onClose, onCh
       /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Button, { type: "button", variant: "outline", onClick: () => setPendingControls(null), children: "Keep edited draft" }),
       /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Button, { type: "button", onClick: applyPendingControls, children: "Rebuild from source" })
     ] }) : null,
+    state.sourceStale ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { role: "alert", className: "matrx-alchemy-decision", children: "The source changed since this draft. Use Refresh source to review the latest data." }) : null,
     state.pending ? /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("div", { className: "matrx-alchemy-decision", role: "alert", children: [
       /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { children: "A fresh source snapshot is ready." }),
       /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Button, { type: "button", variant: "outline", onClick: () => resolveCapture("keep"), children: "Keep current snapshot and draft" }),