@ai-matrx/design-system 0.21.1 → 0.21.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.21.3
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/design-system/v0.21.2..npm/design-system/v0.21.3 -- apps/shared/design-system`).
+No source changes intended and no consumer action required.
+
+## 0.21.2
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/design-system/v0.21.1..npm/design-system/v0.21.2 -- apps/shared/design-system`).
+No source changes intended and no consumer action required.
+
 ## 0.21.1
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/content-transfer.cjs

@@ -1512,7 +1512,12 @@ function MatrxCopyMenuSession(props) {
         ...props.referenceActions ? { referenceActions: props.referenceActions } : {},
         ...props.icon !== void 0 ? { icon: props.icon } : {},
         ...props.triggerVariant !== void 0 ? { triggerVariant: props.triggerVariant } : {},
-        controllerRef: controller,
+        controllerRef: (value) => {
+          controller.current = value;
+          if (typeof props.controllerRef === "function") props.controllerRef(value);
+          else if (props.controllerRef) props.controllerRef.current = value;
+        },
+        ...props.triggerHidden ? { triggerHidden: true } : {},
         label: props.label,
         variants,
         actions,
@@ -2068,8 +2073,9 @@ function ContentTransferMenu(props) {
   const identityKey = props.capabilities?.identityKey ?? inherited.identityKey;
   return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(ContentTransferMenuSession, { ...props }, identityKey ?? "anonymous");
 }
-function ContentTransferMenuSession({ references = [], referenceActions = [], source, surface, label, projection, sections, preferences, table, formatSources, sourceFormats = true, variants = EMPTY_VARIANTS, actions = [], capabilities: local, disabled, enabled = true, className, stopPropagation = true, hide = [], controllerRef, icon = "portal", triggerVariant = "transparent", triggerSize = "default" }) {
+function ContentTransferMenuSession({ references = [], referenceActions = [], source, surface, label, projection, sections, preferences, table, formatSources, sourceFormats = true, variants = EMPTY_VARIANTS, actions = [], capabilities: local, disabled, enabled = true, className, stopPropagation = true, hide = [], controllerRef, icon = "portal", triggerVariant = "transparent", triggerSize = "default", triggerHidden = false }) {
   const triggerRef = React10.useRef(null);
+  const restoreFocusRef = React10.useRef(null);
   const inherited = React10.useContext(CapabilityContext);
   const nearestSurface = React10.useContext(SurfaceContext);
   const fence = useFence();
@@ -2319,13 +2325,21 @@ function ContentTransferMenuSession({ references = [], referenceActions = [], so
   );
   React10.useImperativeHandle(controllerRef, () => ({
     focusTrigger: () => triggerRef.current?.focus(),
+    preparePrimary: async (options) => {
+      if (!enabled) throw new Error("Alchemy is not enabled for this record.");
+      if (disabled) throw new Error("Alchemy is disabled for this record.");
+      if (hide.includes("prepare")) throw new Error("Alchemy preparation is unavailable for this record.");
+      if (!primary) throw new Error("Alchemy has no source to prepare.");
+      restoreFocusRef.current = options?.restoreFocus ?? null;
+      await openWorkspace(primaryWorkspaceKey, { source: primary, label: sourceLabel });
+    },
     prepare: async (requestedSource, options) => {
       const requestedLabel = options?.label ?? ("label" in requestedSource ? requestedSource.label : "content");
       const requestedKey = `controller:${options?.id ?? "source"}:${materialIdentity(requestedSource)}`;
       externalWorkspaceKeys.current.add(requestedKey);
       await openWorkspace(requestedKey, { source: requestedSource, label: requestedLabel });
     }
-  }), [openWorkspace]);
+  }), [disabled, enabled, hide, openWorkspace, primary, primaryWorkspaceKey, sourceLabel]);
   const runAction = React10.useCallback(async (action) => {
     const { controller, id } = fence.begin();
     try {
@@ -2408,7 +2422,7 @@ function ContentTransferMenuSession({ references = [], referenceActions = [], so
     ] }, id);
   };
   return /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)("span", { className: cn("matrx-alchemy", className), onClick: stopPropagation ? (event) => event.stopPropagation() : void 0, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)(Popover, { open: paletteOpen, onOpenChange: (open) => {
+    !triggerHidden ? /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)(Popover, { open: paletteOpen, onOpenChange: (open) => {
       setPaletteOpen(open);
       if (open) {
         setMode("copy");
@@ -2517,13 +2531,13 @@ function ContentTransferMenuSession({ references = [], referenceActions = [], so
           ] }, group) : null;
         })
       ] })
-    ] }),
+    ] }) : null,
     notice && triggerRef.current ? (0, import_react_dom.createPortal)(/* @__PURE__ */ (0, import_jsx_runtime11.jsxs)("div", { className: "matrx-alchemy-feedback", children: [
       /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("span", { role: "status", children: notice }),
       /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(ReceiptLink, { target: receiptTarget }),
       /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("button", { type: "button", "aria-label": "Dismiss Alchemy feedback", onClick: () => setNotice(null), children: "\xD7" })
     ] }), triggerRef.current.ownerDocument.body) : null,
-    Object.values(workspaces).map((saved) => /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(PreparationWorkspace, { restoreFocus: () => triggerRef.current?.focus(), open: workspaceOpen && workspaceKey === saved.key, state: saved, scopes, scopeLabels: table?.scopeLabels, onClose: () => setWorkspaceOpen(false), onChange: (next) => setWorkspaces((current) => ({ ...current, [saved.key]: next })), transport, adapters, actions: preparedActions, captureScope: workspaceCaptures.current.get(saved.key) ?? capturePrimary, ...ai ? { ai } : {}, onOutcome: report }, saved.key)),
+    Object.values(workspaces).map((saved) => /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(PreparationWorkspace, { restoreFocus: () => restoreFocusRef.current?.() ?? triggerRef.current?.focus(), open: workspaceOpen && workspaceKey === saved.key, state: saved, scopes, scopeLabels: table?.scopeLabels, onClose: () => setWorkspaceOpen(false), onChange: (next) => setWorkspaces((current) => ({ ...current, [saved.key]: next })), transport, adapters, actions: preparedActions, captureScope: workspaceCaptures.current.get(saved.key) ?? capturePrimary, ...ai ? { ai } : {}, onOutcome: report }, saved.key)),
     emailReview
   ] });
 }