@ai-matrx/design-system 0.18.1 → 0.18.3

package/dist/content-transfer.d.cts

@@ -103,6 +103,8 @@ interface MatrxCopyMenuProps {
     label: string;
     /** Stable record identity when this mounted control can switch between records. */
     sourceId?: string;
+    /** Prepare the tabular view while keeping raw JSON and human copy formats. */
+    primarySource?: "table";
     human?: Resolvable<string>;
     json?: Resolvable<unknown>;
     agent?: Resolvable<AgentPayloadInput | string>;
@@ -141,6 +143,8 @@ declare function groomerPresetVariants(getConfig: () => AlchemyGroomerConfig): A
 
 declare function AlchemyGlyph(props: React.SVGAttributes<SVGSVGElement>): React.JSX.Element;
 type ContentTransferCapabilities = TransferCapabilities & {
+    /** Opaque host session boundary. It is used only to reset local menu state. */
+    identityKey?: string;
     transport?: Transport;
     actions?: PageAction[];
     preferences?: TransferPreferenceOverrides;
@@ -203,6 +207,6 @@ interface ContentTransferController {
         label?: string;
     }): Promise<void>;
 }
-declare function ContentTransferMenu({ source, surface, label, projection, sections, preferences, table, formatSources, variants, actions, capabilities: local, disabled, enabled, className, stopPropagation, hide, controllerRef }: ContentTransferMenuProps): React.JSX.Element | null;
+declare function ContentTransferMenu(props: ContentTransferMenuProps): React.JSX.Element;
 
 export { type AlchemyCopyVariant, type AlchemyCustomSource, type AlchemyDetail, type AlchemyExportItem, AlchemyGlyph, type AlchemyGroomerConfig, type AlchemyGroomerPreset, type AlchemyGroomerSection, type AlchemyOptionValues, type AlchemySourceOption, type ContentTransferCapabilities, ContentTransferCapabilitiesProvider, type ContentTransferController, ContentTransferMenu, type ContentTransferMenuProps, ContentTransferSurfaceProvider, GROOMER_LEVELS, MatrxCopyMenu, type MatrxCopyMenuProps, type SerializableFormat, type TransferMenuPresentation, type TransferMenuVariant, applyGroomerPreset, buildGroomerPresetPayload, defaultGroomerSelections, groomerPresetVariants, useContentTransferCapabilities, useContentTransferSurface };

package/dist/content-transfer.d.ts

@@ -103,6 +103,8 @@ interface MatrxCopyMenuProps {
     label: string;
     /** Stable record identity when this mounted control can switch between records. */
     sourceId?: string;
+    /** Prepare the tabular view while keeping raw JSON and human copy formats. */
+    primarySource?: "table";
     human?: Resolvable<string>;
     json?: Resolvable<unknown>;
     agent?: Resolvable<AgentPayloadInput | string>;
@@ -141,6 +143,8 @@ declare function groomerPresetVariants(getConfig: () => AlchemyGroomerConfig): A
 
 declare function AlchemyGlyph(props: React.SVGAttributes<SVGSVGElement>): React.JSX.Element;
 type ContentTransferCapabilities = TransferCapabilities & {
+    /** Opaque host session boundary. It is used only to reset local menu state. */
+    identityKey?: string;
     transport?: Transport;
     actions?: PageAction[];
     preferences?: TransferPreferenceOverrides;
@@ -203,6 +207,6 @@ interface ContentTransferController {
         label?: string;
     }): Promise<void>;
 }
-declare function ContentTransferMenu({ source, surface, label, projection, sections, preferences, table, formatSources, variants, actions, capabilities: local, disabled, enabled, className, stopPropagation, hide, controllerRef }: ContentTransferMenuProps): React.JSX.Element | null;
+declare function ContentTransferMenu(props: ContentTransferMenuProps): React.JSX.Element;
 
 export { type AlchemyCopyVariant, type AlchemyCustomSource, type AlchemyDetail, type AlchemyExportItem, AlchemyGlyph, type AlchemyGroomerConfig, type AlchemyGroomerPreset, type AlchemyGroomerSection, type AlchemyOptionValues, type AlchemySourceOption, type ContentTransferCapabilities, ContentTransferCapabilitiesProvider, type ContentTransferController, ContentTransferMenu, type ContentTransferMenuProps, ContentTransferSurfaceProvider, GROOMER_LEVELS, MatrxCopyMenu, type MatrxCopyMenuProps, type SerializableFormat, type TransferMenuPresentation, type TransferMenuVariant, applyGroomerPreset, buildGroomerPresetPayload, defaultGroomerSelections, groomerPresetVariants, useContentTransferCapabilities, useContentTransferSurface };

package/dist/content-transfer.js

@@ -641,7 +641,17 @@ var sourceFor = (id, label, build) => ({
   }
 });
 function MatrxCopyMenu(props) {
-  return /* @__PURE__ */ jsx7(MatrxCopyMenuSession, { ...props }, props.sourceId ?? props.label);
+  const inherited = useContentTransferCapabilities();
+  return /* @__PURE__ */ jsx7(
+    MatrxCopyMenuSession,
+    {
+      ...props
+    },
+    JSON.stringify([
+      inherited.identityKey ?? null,
+      props.sourceId ?? props.label
+    ])
+  );
 }
 function MatrxCopyMenuSession(props) {
   const instance = React7.useId();
@@ -669,7 +679,7 @@ function MatrxCopyMenuSession(props) {
   })) : void 0;
   const agent = aiVisible && props.agent !== void 0 ? make("agent", () => asPayload(resolve(props.agent))) : void 0;
   const structuredAgent = aiVisible && props.agent !== void 0 ? make("structured-agent", () => structuredPayload(resolve(props.agent))) : void 0;
-  const table = exportVisible && props.export?.sheetRows ? make("rows", () => {
+  const table = (exportVisible || props.primarySource === "table") && props.export?.sheetRows ? make("rows", () => {
     const value = normalizeTransferJson(props.export.sheetRows());
     if (!Array.isArray(value) || value.some(
       (row) => row === null || typeof row !== "object" || Array.isArray(row)
@@ -816,7 +826,7 @@ function MatrxCopyMenuSession(props) {
         return props.sendToSheet(draft.payload.rows, props.label);
       }
     });
-  const source = json ?? table ?? structuredAgent ?? human ?? builderVariants[0]?.source;
+  const source = (props.primarySource === "table" ? table : void 0) ?? json ?? table ?? structuredAgent ?? human ?? builderVariants[0]?.source;
   if (!source && !actions.length) return null;
   const target = source ?? make("actions", () => ({ kind: "text", text: props.label }));
   return /* @__PURE__ */ jsxs4(Fragment, { children: [
@@ -836,7 +846,7 @@ function MatrxCopyMenuSession(props) {
         formatSources: {
           ...human ? { plain: human, markdown: humanMarkdown, html: humanMarkdown } : {},
           ...json ? { json, "compact-json": json } : {},
-          ...table ? { csv: table, tsv: table } : {}
+          ...table && exportVisible ? { csv: table, tsv: table } : {}
         },
         ...props.disabled !== void 0 ? { disabled: props.disabled } : {},
         className: cn(
@@ -1221,6 +1231,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);
@@ -1269,7 +1283,12 @@ async function buildArtifact(draft, format, label) {
   const extension = format === "plain" ? "txt" : format === "compact-json" ? "json" : format;
   return serialize(draft, format, { spreadsheetSafe: format === "csv" || format === "tsv", filename: `${filenameFor(label)}.${extension}` });
 }
-function ContentTransferMenu({ source, surface, label, projection, sections, preferences, table, formatSources, variants = EMPTY_VARIANTS, actions = [], capabilities: local, disabled, enabled = true, className, stopPropagation = true, hide = [], controllerRef }) {
+function ContentTransferMenu(props) {
+  const inherited = React8.useContext(CapabilityContext);
+  const identityKey = props.capabilities?.identityKey ?? inherited.identityKey;
+  return /* @__PURE__ */ jsx8(ContentTransferMenuSession, { ...props }, identityKey ?? "anonymous");
+}
+function ContentTransferMenuSession({ source, surface, label, projection, sections, preferences, table, formatSources, variants = EMPTY_VARIANTS, actions = [], capabilities: local, disabled, enabled = true, className, stopPropagation = true, hide = [], controllerRef }) {
   const triggerRef = React8.useRef(null);
   const inherited = React8.useContext(CapabilityContext);
   const nearestSurface = React8.useContext(SurfaceContext);
@@ -1318,7 +1337,7 @@ function ContentTransferMenu({ source, surface, label, projection, sections, pre
       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 () => directSource2(material, { label: sourceLabel, ...projection ? { projection } : {}, ...sections ? { sections } : {} }) } : material;
+      sourceMaterial = { id: materialIdentity(material), label: sourceLabel, capture: async () => directSource2(material, { sourceId: materialIdentity(material), label: sourceLabel, ...applyMenuProjection && projection ? { projection } : {}, ...applyMenuProjection && sections ? { sections } : {} }) };
     } else if (applyMenuProjection && (projection || sections)) {
       sourceMaterial = {
         id: material.id,
@@ -1335,7 +1354,7 @@ function ContentTransferMenu({ source, surface, label, projection, sections, pre
     } else {
       sourceMaterial = material;
     }
-    const raw = "kind" in sourceMaterial ? directSource2(sourceMaterial) : await sourceMaterial.capture({ scope, signal });
+    const raw = await sourceMaterial.capture({ scope, signal });
     const constrained = resolveTransferPreferences(providerPreferences, preferences, raw.snapshot.limits);
     const result = await 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;
@@ -1395,31 +1414,117 @@ function ContentTransferMenu({ source, surface, label, projection, sections, pre
       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 () => directSource2(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 = resolveTransferPreferences(providerPreferences, preferences, result.snapshot.limits);
-      const original = 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 () => directSource2(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 = resolveTransferPreferences(
+          providerPreferences,
+          preferences,
+          result.snapshot.limits
+        );
+        const original = 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) => {
@@ -1562,6 +1667,9 @@ function PreparationWorkspace({ restoreFocus, open, state, scopes, onClose, onCh
   const [instruction, setInstruction] = React8.useState("");
   const [busy, setBusy] = React8.useState(null);
   const [aiFailed, setAiFailed] = React8.useState(false);
+  React8.useEffect(() => {
+    setAiFailed(false);
+  }, [state.snapshot.id, state.draft.revision]);
   const activeAi = React8.useRef(null);
   const activeCapture = React8.useRef(null);
   React8.useEffect(() => {
@@ -1639,7 +1747,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 {
@@ -1872,7 +1980,7 @@ function PreparationWorkspace({ restoreFocus, open, state, scopes, onClose, onCh
           activeCapture.current = null;
           setBusy(null);
         }, children: "Stop loading rows" }) : null,
-        ai && aiSession.current?.recover && busy !== "ai" ? /* @__PURE__ */ jsx8(Button, { type: "button", variant: "outline", onClick: () => void runAi(true), children: aiFailed ? "Retry or rejoin AI run" : "Rejoin AI run" }) : null,
+        ai && aiFailed && aiSession.current?.recover && busy !== "ai" ? /* @__PURE__ */ jsx8(Button, { type: "button", variant: "outline", onClick: () => void runAi(true), children: aiFailed ? "Retry or rejoin AI run" : "Rejoin AI run" }) : null,
         ai ? /* @__PURE__ */ jsx8("p", { className: "matrx-alchemy-meta", children: "AI creates a preview. It never copies automatically. Closing detaches this view without cancelling server work." }) : null,
         state.error ? /* @__PURE__ */ jsx8("p", { role: "alert", className: "matrx-alchemy-error", children: state.error }) : null
       ] }) : null
@@ -1882,6 +1990,7 @@ function PreparationWorkspace({ restoreFocus, open, state, scopes, onClose, onCh
       /* @__PURE__ */ jsx8(Button, { type: "button", variant: "outline", onClick: () => setPendingControls(null), children: "Keep edited draft" }),
       /* @__PURE__ */ jsx8(Button, { type: "button", onClick: applyPendingControls, children: "Rebuild from source" })
     ] }) : null,
+    state.sourceStale ? /* @__PURE__ */ jsx8("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__ */ jsxs5("div", { className: "matrx-alchemy-decision", role: "alert", children: [
       /* @__PURE__ */ jsx8("p", { children: "A fresh source snapshot is ready." }),
       /* @__PURE__ */ jsx8(Button, { type: "button", variant: "outline", onClick: () => resolveCapture("keep"), children: "Keep current snapshot and draft" }),