@ai-matrx/design-system 0.18.1 → 0.18.2

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/data-table/copy-types.ts"],"sourcesContent":["import 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 }; onSelect?: () => void | Promise<void>; }\nexport interface CopyExportConfig { items: ExportItem[]; sheetRows?: () => Array<Record<string, unknown>>; }\n/** Exact portable table-copy API. Host adapters import this, never recreate it. */\nexport interface CopyControlProps {\n  /** Changes reset the preparation session when a mounted control changes record. */\n  sourceId?: string;\n  human?: CopyResolvable<string>;\n  agent?: CopyResolvable<AgentPayloadInput | string>;\n  json?: CopyResolvable<unknown>;\n  label: string;\n  size?: \"xs\" | \"icon\" | \"sm\";\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 { 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 }; onSelect?: () => void | Promise<void>; }\nexport interface CopyExportConfig { items: ExportItem[]; sheetRows?: () => Array<Record<string, unknown>>; }\n/** Exact portable table-copy API. Host adapters import this, never recreate it. */\nexport interface CopyControlProps {\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\";\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":[]}

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

@@ -96,6 +96,8 @@ interface CopyExportConfig {
 interface CopyControlProps {
     /** Changes reset the preparation session when a mounted control changes record. */
     sourceId?: string;
+    /** Canonical table controls opt into row preparation when sheet rows exist. */
+    primarySource?: "table";
     human?: CopyResolvable<string>;
     agent?: CopyResolvable<AgentPayloadInput | string>;
     json?: CopyResolvable<unknown>;

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

@@ -96,6 +96,8 @@ interface CopyExportConfig {
 interface CopyControlProps {
     /** Changes reset the preparation session when a mounted control changes record. */
     sourceId?: string;
+    /** Canonical table controls opt into row preparation when sheet rows exist. */
+    primarySource?: "table";
     human?: CopyResolvable<string>;
     agent?: CopyResolvable<AgentPayloadInput | string>;
     json?: CopyResolvable<unknown>;

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

@@ -705,7 +705,12 @@ async function buildArtifact(draft, format, label) {
   const extension = format === "plain" ? "txt" : format === "compact-json" ? "json" : format;
   return (0, import_content_transfer.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 = React7.useContext(CapabilityContext);
+  const identityKey = props.capabilities?.identityKey ?? inherited.identityKey;
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(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 = React7.useRef(null);
   const inherited = React7.useContext(CapabilityContext);
   const nearestSurface = React7.useContext(SurfaceContext);
@@ -998,6 +1003,9 @@ function PreparationWorkspace({ restoreFocus, open, state, scopes, onClose, onCh
   const [instruction, setInstruction] = React7.useState("");
   const [busy, setBusy] = React7.useState(null);
   const [aiFailed, setAiFailed] = React7.useState(false);
+  React7.useEffect(() => {
+    setAiFailed(false);
+  }, [state.snapshot.id, state.draft.revision]);
   const activeAi = React7.useRef(null);
   const activeCapture = React7.useRef(null);
   React7.useEffect(() => {
@@ -1308,7 +1316,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__ */ (0, import_jsx_runtime7.jsx)(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__ */ (0, import_jsx_runtime7.jsx)(Button, { type: "button", variant: "outline", onClick: () => void runAi(true), children: aiFailed ? "Retry or rejoin AI run" : "Rejoin AI run" }) : null,
         ai ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("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__ */ (0, import_jsx_runtime7.jsx)("p", { role: "alert", className: "matrx-alchemy-error", children: state.error }) : null
       ] }) : null
@@ -1435,7 +1443,17 @@ var sourceFor = (id, label, build) => ({
   }
 });
 function MatrxCopyMenu(props) {
-  return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(MatrxCopyMenuSession, { ...props }, props.sourceId ?? props.label);
+  const inherited = useContentTransferCapabilities();
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+    MatrxCopyMenuSession,
+    {
+      ...props
+    },
+    JSON.stringify([
+      inherited.identityKey ?? null,
+      props.sourceId ?? props.label
+    ])
+  );
 }
 function MatrxCopyMenuSession(props) {
   const instance = React8.useId();
@@ -1463,7 +1481,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 = (0, import_content_transfer2.normalizeTransferJson)(props.export.sheetRows());
     if (!Array.isArray(value) || value.some(
       (row) => row === null || typeof row !== "object" || Array.isArray(row)
@@ -1610,7 +1628,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__ */ (0, import_jsx_runtime8.jsxs)(import_jsx_runtime8.Fragment, { children: [
@@ -1630,7 +1648,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(
@@ -1913,8 +1931,9 @@ function useMatrxDataTableHost() {
 var import_jsx_runtime10 = require("react/jsx-runtime");
 function CopyButtons(props) {
   const { CopyControls } = useMatrxDataTableHost();
-  if (CopyControls) return /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(CopyControls, { ...props });
-  return /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(MatrxCopyMenu, { ...props });
+  const copyProps = props.export?.sheetRows ? { ...props, primarySource: "table" } : props;
+  if (CopyControls) return /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(CopyControls, { ...copyProps });
+  return /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(MatrxCopyMenu, { ...copyProps });
 }
 
 // src/data-table/MatrxUuidCell.tsx