@ai-matrx/design-system 0.21.1 → 0.21.3

package/dist/data-table/copy-helpers.d.cts

@@ -1,8 +1,9 @@
 import { AgentPayloadInput } from './copy-types.cjs';
-import { f as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-B99KFITZ.cjs';
-import '../extensions-DCHtNwG3.cjs';
-import '@ai-matrx/kit/content-transfer';
+import { f as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-BarjBFyG.cjs';
+import '../content-transfer.cjs';
 import 'react';
+import '@ai-matrx/kit/content-transfer';
+import '../content-transfer/icon.cjs';
 
 /**
  * Typed, declared-column capture for MatrxDataTable's built-in Alchemy source.

package/dist/data-table/copy-helpers.d.ts

@@ -1,8 +1,9 @@
 import { AgentPayloadInput } from './copy-types.js';
-import { f as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-CryQuMmz.js';
-import '../extensions-DCHtNwG3.js';
-import '@ai-matrx/kit/content-transfer';
+import { f as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-JFlsIv-0.js';
+import '../content-transfer.js';
 import 'react';
+import '@ai-matrx/kit/content-transfer';
+import '../content-transfer/icon.js';
 
 /**
  * Typed, declared-column capture for MatrxDataTable's built-in Alchemy source.

package/dist/data-table/copy-types.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/data-table/copy-types.ts"],"sourcesContent":["import type { ContentTransferReference } from \"../content-transfer/extensions\";\nimport type { ComponentType, ReactNode } from \"react\";\n\nexport type CopyResolvable<T> = T | (() => T);\nexport type CopyScalar = string | number | boolean | null | undefined;\nexport interface AgentPayloadInput { kind: string; location: string; description: string; data: unknown; summary?: string; context?: Record<string, CopyScalar>; attributes?: Record<string, CopyScalar>; }\nexport type AiIcon = ComponentType<{ className?: string }>;\nexport interface AiVariant { id: string; label: string; hint?: string; icon?: AiIcon; section?: \"copy\" | \"ai\"; ariaLabel?: string; successMessage?: string; build?: () => AgentPayloadInput | string | Promise<AgentPayloadInput | string>; onSelect?: () => void; modal?: (props: { open: boolean; onOpenChange: (open: boolean) => void }) => ReactNode; }\nexport type AiCustomOption =\n  | { kind: \"toggle\"; key: string; label: string; hint?: string; default: boolean }\n  | { kind: \"preset\"; key: string; label: string; options: { label: string; value: number }[]; default: number }\n  | { kind: \"slider\"; key: string; label: string; hint?: string; stops: number[]; default: number; formatValue: (value: number) => string }\n  | { kind: \"number\"; key: string; label: string; hint?: string; min?: number; step?: number; presets?: { label: string; value: number }[]; default: number };\nexport type AiOptionValues = Record<string, boolean | number>;\nexport interface AiCustomSource { label?: string; hint?: string; options: AiCustomOption[]; build: (options: AiOptionValues) => { text: string; meta?: Record<string, string | number | boolean | undefined> }; wrap: (text: string, options: AiOptionValues, meta?: Record<string, string | number | boolean | undefined>) => AgentPayloadInput; dialogTitle?: string; dialogDescription?: string; }\nexport interface ExportItem { id: string; label: string; build?: () => { content: BlobPart; extension: string; mime: string; filename?: string }; onSelect?: () => void | Promise<void>; }\nexport interface CopyExportConfig { items: ExportItem[]; sheetRows?: () => Array<Record<string, unknown>>; sheetColumns?: () => Array<{ id: string; label: string }>; }\n/** Exact portable table-copy API. Host adapters import this, never recreate it. */\nexport interface CopyControlProps {\n  references?: readonly ContentTransferReference[];\n  triggerVariant?: \"transparent\" | \"glass\" | \"outline\";\n  /** Changes reset the preparation session when a mounted control changes record. */\n  sourceId?: string;\n  /** Canonical table controls opt into row preparation when sheet rows exist. */\n  primarySource?: \"table\";\n  human?: CopyResolvable<string>;\n  agent?: CopyResolvable<AgentPayloadInput | string>;\n  json?: CopyResolvable<unknown>;\n  label: string;\n  size?: \"xs\" | \"icon\" | \"sm\" | \"toolbar\";\n  /** Accepted for direct compatibility; package chrome has no application groomer engine. */\n  appearance?: \"segmented\" | \"bare\";\n  disabled?: boolean;\n  stopPropagation?: boolean;\n  className?: string;\n  /** Legacy source compatibility; controls are already grouped by default. */\n  grouped?: boolean;\n  aiVariants?: AiVariant[];\n  agentVariant?: { id?: string; label?: string; hint?: string; position?: \"first\" | \"last\" };\n  aiCustom?: AiCustomSource;\n  export?: CopyExportConfig;\n  hide?: Array<\"copy\" | \"ai\" | \"export\">;\n}\nexport interface CopySubsetColumn<T> { id: string; header: string; accessorKey?: keyof T & string; accessorFn?: (row: T) => unknown; hidden?: boolean; }\nexport interface CopySubsetSource<T> { label: string; location: string; kind: string; rows: T[]; columns: CopySubsetColumn<T>[]; getRowId: (row: T) => string; serializer?: (rows: T[]) => AgentPayloadInput; }\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/data-table/copy-types.ts"],"sourcesContent":["import type { ContentTransferReference } from \"../content-transfer/extensions\";\nimport type { ContentTransferController } from \"../content-transfer\";\nimport type { ComponentType, ReactNode, Ref } from \"react\";\n\nexport type CopyResolvable<T> = T | (() => T);\nexport type CopyScalar = string | number | boolean | null | undefined;\nexport interface AgentPayloadInput { kind: string; location: string; description: string; data: unknown; summary?: string; context?: Record<string, CopyScalar>; attributes?: Record<string, CopyScalar>; }\nexport type AiIcon = ComponentType<{ className?: string }>;\nexport interface AiVariant { id: string; label: string; hint?: string; icon?: AiIcon; section?: \"copy\" | \"ai\"; ariaLabel?: string; successMessage?: string; build?: () => AgentPayloadInput | string | Promise<AgentPayloadInput | string>; onSelect?: () => void; modal?: (props: { open: boolean; onOpenChange: (open: boolean) => void }) => ReactNode; }\nexport type AiCustomOption =\n  | { kind: \"toggle\"; key: string; label: string; hint?: string; default: boolean }\n  | { kind: \"preset\"; key: string; label: string; options: { label: string; value: number }[]; default: number }\n  | { kind: \"slider\"; key: string; label: string; hint?: string; stops: number[]; default: number; formatValue: (value: number) => string }\n  | { kind: \"number\"; key: string; label: string; hint?: string; min?: number; step?: number; presets?: { label: string; value: number }[]; default: number };\nexport type AiOptionValues = Record<string, boolean | number>;\nexport interface AiCustomSource { label?: string; hint?: string; options: AiCustomOption[]; build: (options: AiOptionValues) => { text: string; meta?: Record<string, string | number | boolean | undefined> }; wrap: (text: string, options: AiOptionValues, meta?: Record<string, string | number | boolean | undefined>) => AgentPayloadInput; dialogTitle?: string; dialogDescription?: string; }\nexport interface ExportItem { id: string; label: string; build?: () => { content: BlobPart; extension: string; mime: string; filename?: string }; onSelect?: () => void | Promise<void>; }\nexport interface CopyExportConfig { items: ExportItem[]; sheetRows?: () => Array<Record<string, unknown>>; sheetColumns?: () => Array<{ id: string; label: string }>; }\n/** Exact portable table-copy API. Host adapters import this, never recreate it. */\nexport interface CopyControlProps {\n  references?: readonly ContentTransferReference[];\n  triggerVariant?: \"transparent\" | \"glass\" | \"outline\";\n  /** Changes reset the preparation session when a mounted control changes record. */\n  sourceId?: string;\n  /** Canonical table controls opt into row preparation when sheet rows exist. */\n  primarySource?: \"table\";\n  human?: CopyResolvable<string>;\n  agent?: CopyResolvable<AgentPayloadInput | string>;\n  json?: CopyResolvable<unknown>;\n  label: string;\n  size?: \"xs\" | \"icon\" | \"sm\" | \"toolbar\";\n  /** Accepted for direct compatibility; package chrome has no application groomer engine. */\n  appearance?: \"segmented\" | \"bare\";\n  disabled?: boolean;\n  stopPropagation?: boolean;\n  className?: string;\n  /** Legacy source compatibility; controls are already grouped by default. */\n  grouped?: boolean;\n  aiVariants?: AiVariant[];\n  agentVariant?: { id?: string; label?: string; hint?: string; position?: \"first\" | \"last\" };\n  aiCustom?: AiCustomSource;\n  export?: CopyExportConfig;\n  hide?: Array<\"copy\" | \"ai\" | \"export\">;\n  /** Programmatic host port for an existing menu; never uses a DOM click. */\n  controllerRef?: Ref<ContentTransferController>;\n  /** The host supplies the visible command. */\n  triggerHidden?: boolean;\n}\nexport interface CopySubsetColumn<T> { id: string; header: string; accessorKey?: keyof T & string; accessorFn?: (row: T) => unknown; hidden?: boolean; }\nexport interface CopySubsetSource<T> { label: string; location: string; kind: string; rows: T[]; columns: CopySubsetColumn<T>[]; getRowId: (row: T) => string; serializer?: (rows: T[]) => AgentPayloadInput; }\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/data-table/copy-types.d.cts

@@ -1,6 +1,7 @@
-import { C as ContentTransferReference } from '../extensions-DCHtNwG3.cjs';
-import { ComponentType, ReactNode } from 'react';
+import { ContentTransferReference, ContentTransferController } from '../content-transfer.cjs';
+import { ComponentType, ReactNode, Ref } from 'react';
 import '@ai-matrx/kit/content-transfer';
+import '../content-transfer/icon.cjs';
 
 type CopyResolvable<T> = T | (() => T);
 type CopyScalar = string | number | boolean | null | undefined;
@@ -129,6 +130,10 @@ interface CopyControlProps {
     aiCustom?: AiCustomSource;
     export?: CopyExportConfig;
     hide?: Array<"copy" | "ai" | "export">;
+    /** Programmatic host port for an existing menu; never uses a DOM click. */
+    controllerRef?: Ref<ContentTransferController>;
+    /** The host supplies the visible command. */
+    triggerHidden?: boolean;
 }
 interface CopySubsetColumn<T> {
     id: string;

package/dist/data-table/copy-types.d.ts

@@ -1,6 +1,7 @@
-import { C as ContentTransferReference } from '../extensions-DCHtNwG3.js';
-import { ComponentType, ReactNode } from 'react';
+import { ContentTransferReference, ContentTransferController } from '../content-transfer.js';
+import { ComponentType, ReactNode, Ref } from 'react';
 import '@ai-matrx/kit/content-transfer';
+import '../content-transfer/icon.js';
 
 type CopyResolvable<T> = T | (() => T);
 type CopyScalar = string | number | boolean | null | undefined;
@@ -129,6 +130,10 @@ interface CopyControlProps {
     aiCustom?: AiCustomSource;
     export?: CopyExportConfig;
     hide?: Array<"copy" | "ai" | "export">;
+    /** Programmatic host port for an existing menu; never uses a DOM click. */
+    controllerRef?: Ref<ContentTransferController>;
+    /** The host supplies the visible command. */
+    triggerHidden?: boolean;
 }
 interface CopySubsetColumn<T> {
     id: string;

package/dist/data-table/data-row-inspector.cjs

@@ -1353,8 +1353,9 @@ function ContentTransferMenu(props) {
   const identityKey = props.capabilities?.identityKey ?? inherited.identityKey;
   return /* @__PURE__ */ (0, import_jsx_runtime10.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 = React9.useRef(null);
+  const restoreFocusRef = React9.useRef(null);
   const inherited = React9.useContext(CapabilityContext);
   const nearestSurface = React9.useContext(SurfaceContext);
   const fence = useFence();
@@ -1604,13 +1605,21 @@ function ContentTransferMenuSession({ references = [], referenceActions = [], so
   );
   React9.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 = React9.useCallback(async (action) => {
     const { controller, id } = fence.begin();
     try {
@@ -1693,7 +1702,7 @@ function ContentTransferMenuSession({ references = [], referenceActions = [], so
     ] }, id);
   };
   return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("span", { className: cn("matrx-alchemy", className), onClick: stopPropagation ? (event) => event.stopPropagation() : void 0, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(Popover, { open: paletteOpen, onOpenChange: (open) => {
+    !triggerHidden ? /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(Popover, { open: paletteOpen, onOpenChange: (open) => {
       setPaletteOpen(open);
       if (open) {
         setMode("copy");
@@ -1802,13 +1811,13 @@ function ContentTransferMenuSession({ references = [], referenceActions = [], so
           ] }, group) : null;
         })
       ] })
-    ] }),
+    ] }) : null,
     notice && triggerRef.current ? (0, import_react_dom.createPortal)(/* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "matrx-alchemy-feedback", children: [
       /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("span", { role: "status", children: notice }),
       /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(ReceiptLink, { target: receiptTarget }),
       /* @__PURE__ */ (0, import_jsx_runtime10.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_runtime10.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_runtime10.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
   ] });
 }
@@ -2615,7 +2624,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,
@@ -2913,6 +2927,9 @@ var HostContext = hostRegistry[HOST_SLOT] ??= (0, import_react2.createContext)({
 function useMatrxDataTableHost() {
   return (0, import_react2.useContext)(HostContext);
 }
+var ROW_ALCHEMY_SLOT = /* @__PURE__ */ Symbol.for("ai-matrx.design-system.table-row-alchemy-context");
+var rowAlchemyRegistry = globalThis;
+var RowAlchemyContext = rowAlchemyRegistry[ROW_ALCHEMY_SLOT] ??= (0, import_react2.createContext)(null);
 
 // src/data-table/copy.tsx
 var import_jsx_runtime13 = require("react/jsx-runtime");