@ai-matrx/design-system 0.19.18 → 0.20.0

package/dist/content-transfer.css

@@ -19,6 +19,11 @@
   border: 1px solid hsl(var(--border));
   box-shadow: none;
 }
+[data-alchemy-size="compact"] { width: 1.75rem; height: 1.75rem; }
+[data-alchemy-size="compact"] .matrx-tap-icon { width: .875rem; height: .875rem; color: inherit; stroke-width: 2; }
+/* Dense outline toolbars use the same package Button as their neighbors. */
+[data-alchemy-trigger="outline"] { width: 1.75rem; height: 1.75rem; padding: 0; }
+[data-alchemy-trigger="outline"] > svg { width: .875rem; height: .875rem; stroke-width: 2; }
 @media (pointer: coarse) {
   [data-alchemy-trigger] { width: 2.75rem; height: 2.75rem; }
 }
@@ -448,3 +453,13 @@ body:has(.matrx-alchemy-workspace[data-state="open"]) > .matrx-alchemy-feedback
 .matrx-alchemy-palette-destinations > summary > span { font-size: 0.6875rem; color: hsl(var(--muted-foreground)); }
 .matrx-alchemy-palette-destinations > summary:hover { background: hsl(var(--accent)); }
 .matrx-alchemy-palette-destinations > summary:focus-visible { outline: none; box-shadow: inset 0 0 0 2px hsl(var(--ring)); }
+
+.matrx-alchemy-scope { display: grid; gap: .375rem; padding: .5rem; font-size: .75rem; }
+.matrx-alchemy-scope select { width: 100%; min-width: 0; padding: .375rem; border: 1px solid hsl(var(--border)); border-radius: .375rem; color: inherit; background: hsl(var(--background)); }
+
+/* Email review shares the preparation chrome, including hosts without Tailwind. */
+.matrx-alchemy-email-review { max-height: 85dvh; overflow: auto; }
+.matrx-alchemy-email-review .matrx-alchemy-preview { min-height: 12rem; max-height: 45dvh; resize: vertical; }
+.matrx-alchemy-email-adjustments { font-size: .8125rem; overflow-wrap: anywhere; }
+.matrx-alchemy-email-adjustments ul { margin: .5rem 0 0; padding-left: 1.25rem; }
+@media (min-width: 768px) { .matrx-alchemy-email-review { width: min(32rem, calc(100vw - 2rem)); } }

package/dist/content-transfer.d.cts

@@ -2,6 +2,8 @@ import * as React from 'react';
 import { AgentPayloadInput, TransferOutcome, TransferCapabilities, Transport, PageAction, TransferPreferenceOverrides, Source, Payload, ExportProjection, Section, SurfaceHandle, TransferScope } from '@ai-matrx/kit/content-transfer';
 import { AlchemyIcon } from './content-transfer/icon.cjs';
 export { ALCHEMY_COPY_TRANSFORM_SVG, ALCHEMY_GLYPH_SVG } from './content-transfer/icon.cjs';
+import { C as ContentTransferReference, a as ContentTransferReferencePort, b as ContentTransferEmailPort } from './extensions-DCHtNwG3.cjs';
+export { c as createTransferEmailActions, t as tableDataFormat, d as tableSchemaFormat } from './extensions-DCHtNwG3.cjs';
 
 type AlchemyOptionValues = Record<string, boolean | number>;
 type AlchemySourceOption = {
@@ -106,6 +108,8 @@ interface MatrxCopyMenuProps {
     label: string;
     /** Stable record identity when this mounted control can switch between records. */
     sourceId?: string;
+    references?: readonly ContentTransferReference[];
+    referenceActions?: readonly ContentTransferReferenceAction[];
     /** Prepare the tabular view while keeping raw JSON and human copy formats. */
     primarySource?: "table";
     human?: Resolvable<string>;
@@ -139,7 +143,7 @@ interface MatrxCopyMenuProps {
     unified?: boolean;
     grouped?: boolean;
     icon?: AlchemyIcon;
-    triggerVariant?: "transparent" | "glass";
+    triggerVariant?: "transparent" | "glass" | "outline";
 }
 /** Opinionated bridge for Matrx's existing content builders, with one transfer UI. */
 declare function MatrxCopyMenu(props: MatrxCopyMenuProps): React.JSX.Element;
@@ -150,6 +154,11 @@ declare function defaultGroomerSelections(sections: AlchemyGroomerSection[]): Re
 declare function buildGroomerPresetPayload(config: AlchemyGroomerConfig, preset: AlchemyGroomerPreset): AgentPayloadInput;
 declare function groomerPresetVariants(getConfig: () => AlchemyGroomerConfig): AlchemyCopyVariant[];
 
+type ContentTransferReferenceAction = {
+    id: string;
+    label: string;
+    run(): void | Promise<void>;
+};
 declare function AlchemyGlyph({ icon, ...props }: React.SVGAttributes<SVGSVGElement> & {
     icon?: AlchemyIcon;
 }): React.JSX.Element;
@@ -157,6 +166,8 @@ type ContentTransferCapabilities = TransferCapabilities & {
     /** Opaque host session boundary. It is used only to reset local menu state. */
     identityKey?: string;
     transport?: Transport;
+    reference?: ContentTransferReferencePort;
+    email?: ContentTransferEmailPort;
     actions?: PageAction[];
     preferences?: TransferPreferenceOverrides;
     onOutcome?: (outcome: TransferOutcome) => void;
@@ -173,7 +184,7 @@ declare function ContentTransferSurfaceProvider({ handle, children }: {
 declare const useContentTransferSurface: () => SurfaceHandle | null;
 type SerializableFormat = "plain" | "markdown" | "html" | "json" | "compact-json" | "csv" | "tsv";
 interface TransferMenuPresentation {
-    group?: "save" | "chat";
+    group?: "save" | "chat" | "email";
     prepared?: boolean;
     hint?: string;
     icon?: React.ComponentType<{
@@ -202,7 +213,10 @@ interface ContentTransferMenuProps {
     table?: {
         availableScopes: TransferScope[];
         initialScope: TransferScope;
+        scopeLabels?: Partial<Record<TransferScope, string>>;
     };
+    references?: readonly ContentTransferReference[];
+    referenceActions?: readonly ContentTransferReferenceAction[];
     /** A quick format may explicitly capture a different representation. */
     formatSources?: Partial<Record<SerializableFormat, Source | Payload>>;
     /** Set false for action-only hosts; source formats and adapters are then omitted. */
@@ -215,7 +229,8 @@ interface ContentTransferMenuProps {
     /** Portal is the default Alchemy mark; copy-transform remains opt-in. */
     icon?: AlchemyIcon;
     /** Uses the canonical TapTargetButton presentation. */
-    triggerVariant?: "transparent" | "glass";
+    triggerVariant?: "transparent" | "glass" | "outline";
+    triggerSize?: "default" | "compact";
     className?: string;
     stopPropagation?: boolean;
     hide?: readonly ("copy" | "prepare" | "download")[];
@@ -230,4 +245,4 @@ interface ContentTransferController {
 }
 declare function ContentTransferMenu(props: ContentTransferMenuProps): React.JSX.Element;
 
-export { type AlchemyCopyVariant, type AlchemyCustomSource, type AlchemyDetail, type AlchemyExportItem, AlchemyGlyph, type AlchemyGroomerConfig, type AlchemyGroomerPreset, type AlchemyGroomerSection, AlchemyIcon, 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 };
+export { type AlchemyCopyVariant, type AlchemyCustomSource, type AlchemyDetail, type AlchemyExportItem, AlchemyGlyph, type AlchemyGroomerConfig, type AlchemyGroomerPreset, type AlchemyGroomerSection, AlchemyIcon, type AlchemyOptionValues, type AlchemySourceOption, type ContentTransferCapabilities, ContentTransferCapabilitiesProvider, type ContentTransferController, ContentTransferEmailPort, ContentTransferMenu, type ContentTransferMenuProps, ContentTransferReference, type ContentTransferReferenceAction, ContentTransferReferencePort, ContentTransferSurfaceProvider, GROOMER_LEVELS, MatrxCopyMenu, type MatrxCopyMenuProps, type SerializableFormat, type TransferMenuPresentation, type TransferMenuVariant, applyGroomerPreset, buildGroomerPresetPayload, defaultGroomerSelections, groomerPresetVariants, useContentTransferCapabilities, useContentTransferSurface };

package/dist/content-transfer.d.ts

@@ -2,6 +2,8 @@ import * as React from 'react';
 import { AgentPayloadInput, TransferOutcome, TransferCapabilities, Transport, PageAction, TransferPreferenceOverrides, Source, Payload, ExportProjection, Section, SurfaceHandle, TransferScope } from '@ai-matrx/kit/content-transfer';
 import { AlchemyIcon } from './content-transfer/icon.js';
 export { ALCHEMY_COPY_TRANSFORM_SVG, ALCHEMY_GLYPH_SVG } from './content-transfer/icon.js';
+import { C as ContentTransferReference, a as ContentTransferReferencePort, b as ContentTransferEmailPort } from './extensions-DCHtNwG3.js';
+export { c as createTransferEmailActions, t as tableDataFormat, d as tableSchemaFormat } from './extensions-DCHtNwG3.js';
 
 type AlchemyOptionValues = Record<string, boolean | number>;
 type AlchemySourceOption = {
@@ -106,6 +108,8 @@ interface MatrxCopyMenuProps {
     label: string;
     /** Stable record identity when this mounted control can switch between records. */
     sourceId?: string;
+    references?: readonly ContentTransferReference[];
+    referenceActions?: readonly ContentTransferReferenceAction[];
     /** Prepare the tabular view while keeping raw JSON and human copy formats. */
     primarySource?: "table";
     human?: Resolvable<string>;
@@ -139,7 +143,7 @@ interface MatrxCopyMenuProps {
     unified?: boolean;
     grouped?: boolean;
     icon?: AlchemyIcon;
-    triggerVariant?: "transparent" | "glass";
+    triggerVariant?: "transparent" | "glass" | "outline";
 }
 /** Opinionated bridge for Matrx's existing content builders, with one transfer UI. */
 declare function MatrxCopyMenu(props: MatrxCopyMenuProps): React.JSX.Element;
@@ -150,6 +154,11 @@ declare function defaultGroomerSelections(sections: AlchemyGroomerSection[]): Re
 declare function buildGroomerPresetPayload(config: AlchemyGroomerConfig, preset: AlchemyGroomerPreset): AgentPayloadInput;
 declare function groomerPresetVariants(getConfig: () => AlchemyGroomerConfig): AlchemyCopyVariant[];
 
+type ContentTransferReferenceAction = {
+    id: string;
+    label: string;
+    run(): void | Promise<void>;
+};
 declare function AlchemyGlyph({ icon, ...props }: React.SVGAttributes<SVGSVGElement> & {
     icon?: AlchemyIcon;
 }): React.JSX.Element;
@@ -157,6 +166,8 @@ type ContentTransferCapabilities = TransferCapabilities & {
     /** Opaque host session boundary. It is used only to reset local menu state. */
     identityKey?: string;
     transport?: Transport;
+    reference?: ContentTransferReferencePort;
+    email?: ContentTransferEmailPort;
     actions?: PageAction[];
     preferences?: TransferPreferenceOverrides;
     onOutcome?: (outcome: TransferOutcome) => void;
@@ -173,7 +184,7 @@ declare function ContentTransferSurfaceProvider({ handle, children }: {
 declare const useContentTransferSurface: () => SurfaceHandle | null;
 type SerializableFormat = "plain" | "markdown" | "html" | "json" | "compact-json" | "csv" | "tsv";
 interface TransferMenuPresentation {
-    group?: "save" | "chat";
+    group?: "save" | "chat" | "email";
     prepared?: boolean;
     hint?: string;
     icon?: React.ComponentType<{
@@ -202,7 +213,10 @@ interface ContentTransferMenuProps {
     table?: {
         availableScopes: TransferScope[];
         initialScope: TransferScope;
+        scopeLabels?: Partial<Record<TransferScope, string>>;
     };
+    references?: readonly ContentTransferReference[];
+    referenceActions?: readonly ContentTransferReferenceAction[];
     /** A quick format may explicitly capture a different representation. */
     formatSources?: Partial<Record<SerializableFormat, Source | Payload>>;
     /** Set false for action-only hosts; source formats and adapters are then omitted. */
@@ -215,7 +229,8 @@ interface ContentTransferMenuProps {
     /** Portal is the default Alchemy mark; copy-transform remains opt-in. */
     icon?: AlchemyIcon;
     /** Uses the canonical TapTargetButton presentation. */
-    triggerVariant?: "transparent" | "glass";
+    triggerVariant?: "transparent" | "glass" | "outline";
+    triggerSize?: "default" | "compact";
     className?: string;
     stopPropagation?: boolean;
     hide?: readonly ("copy" | "prepare" | "download")[];
@@ -230,4 +245,4 @@ interface ContentTransferController {
 }
 declare function ContentTransferMenu(props: ContentTransferMenuProps): React.JSX.Element;
 
-export { type AlchemyCopyVariant, type AlchemyCustomSource, type AlchemyDetail, type AlchemyExportItem, AlchemyGlyph, type AlchemyGroomerConfig, type AlchemyGroomerPreset, type AlchemyGroomerSection, AlchemyIcon, 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 };
+export { type AlchemyCopyVariant, type AlchemyCustomSource, type AlchemyDetail, type AlchemyExportItem, AlchemyGlyph, type AlchemyGroomerConfig, type AlchemyGroomerPreset, type AlchemyGroomerSection, AlchemyIcon, type AlchemyOptionValues, type AlchemySourceOption, type ContentTransferCapabilities, ContentTransferCapabilitiesProvider, type ContentTransferController, ContentTransferEmailPort, ContentTransferMenu, type ContentTransferMenuProps, ContentTransferReference, type ContentTransferReferenceAction, ContentTransferReferencePort, ContentTransferSurfaceProvider, GROOMER_LEVELS, MatrxCopyMenu, type MatrxCopyMenuProps, type SerializableFormat, type TransferMenuPresentation, type TransferMenuVariant, applyGroomerPreset, buildGroomerPresetPayload, defaultGroomerSelections, groomerPresetVariants, useContentTransferCapabilities, useContentTransferSurface };