@ai-matrx/alchemy 0.14.0 → 0.16.0

package/dist/react-workspace.d.cts

@@ -160,10 +160,18 @@ type ContentTransferEmailPort = {
         signal: AbortSignal;
     }): Promise<TransferOutcome>;
 };
+/** The host's HTML preview (a window or overlay that renders the document); Alchemy only decides when to offer it. */
+type ContentTransferHtmlPreviewPort = {
+    open(request: {
+        content: string;
+        title: string;
+    }): void | Promise<void>;
+};
 /** A sealed, projection-safe representation of a tabular draft's declared schema and values. */
 declare const tableSchemaFormat: FormatAdapter;
 /** Flat row JSON keyed by user-facing display labels, never raw table records. */
 declare const tableDataFormat: FormatAdapter;
+type TransferHtmlPreviewAction = PageAction;
 type TransferEmailAction = PageAction & {
     prepared: true;
     group: "email";
@@ -172,6 +180,11 @@ type TransferEmailAction = PageAction & {
 declare function createTransferEmailActions(email: ContentTransferEmailPort, options?: {
     jsonFormat?: FormatAdapter;
 }): TransferEmailAction[];
+/**
+ * "HTML preview": opens the host's preview on the PREPARED text (what the person would copy, edits
+ * and thinking-strip included). Offered for Markdown and text drafts only — a table has no document.
+ */
+declare function createTransferHtmlPreviewAction(port: ContentTransferHtmlPreviewPort): TransferHtmlPreviewAction;
 
 interface AlchemyCopyVariant {
     id: string;
@@ -230,6 +243,18 @@ interface MatrxCopyMenuProps {
      * transport and offers no Copy text tile (readable text is the host's one projection).
      */
     richCopy?: (markdown: string, flavor: RichCopyFlavor) => Promise<TransferOutcome | boolean | void> | TransferOutcome | boolean | void;
+    /**
+     * Model output: every copy of `human` leaves out its reasoning blocks (`<thinking>`, `<think>`,
+     * `<reasoning>`), and when it held any the panel offers "Copy including thinking" with the full text.
+     * A function `human` is never read to decide this (opening the menu prepares nothing), so the
+     * variant is offered for a string `human` only.
+     */
+    stripThinking?: boolean;
+    /**
+     * Offer "HTML preview" for `human` (markdown) when the host bound `capabilities.htmlPreview`.
+     * Default true for `contentFlavor="markdown"`; pass false where the host's editable preview is the one action.
+     */
+    htmlPreview?: boolean;
     json?: Resolvable<unknown>;
     agent?: Resolvable<AgentPayloadInput | string>;
     aiVariants?: AlchemyCopyVariant[];
@@ -299,6 +324,8 @@ type ContentTransferCapabilities = TransferCapabilities & {
     transport?: Transport;
     reference?: ContentTransferReferencePort;
     email?: ContentTransferEmailPort;
+    /** The host's HTML preview. Bound: a menu mounted with `htmlPreview` offers the "HTML preview" action. */
+    htmlPreview?: ContentTransferHtmlPreviewPort;
     actions?: PageAction[];
     preferences?: TransferPreferenceOverrides;
     onOutcome?: (outcome: TransferOutcome) => void;
@@ -376,6 +403,8 @@ interface ContentTransferMenuProps {
     /** Named alternate sources open this same preparation workspace. */
     variants?: readonly TransferMenuVariant[];
     actions?: (PageAction & TransferMenuPresentation)[];
+    /** Offer "HTML preview" (Markdown and text only) when the host bound `capabilities.htmlPreview`. */
+    htmlPreview?: boolean;
     capabilities?: ContentTransferCapabilities;
     disabled?: boolean;
     /** Portal is the default Alchemy mark; copy-transform remains opt-in. */
@@ -438,4 +467,4 @@ type ShapedSource = Source & {
     shape?: SourceShape;
 };
 
-export { type AlchemyCopyVariant, type AlchemyCustomSource, type AlchemyDetail, type AlchemyExportItem, AlchemyGlyph, type AlchemyGroomerConfig, type AlchemyGroomerPreset, type AlchemyGroomerSection, type AlchemyOptionValues, type AlchemySourceOption, AlchemyTableCopyControls, type ContentTransferCapabilities, ContentTransferCapabilitiesProvider, type ContentTransferController, type ContentTransferEmailPort, ContentTransferMenu, type ContentTransferMenuProps, type ContentTransferReferenceAction, type ContentTransferReferencePort, ContentTransferSurfaceProvider, type EnvelopeMeta, GROOMER_LEVELS, MatrxCopyMenu, type MatrxCopyMenuProps, PALETTE_HEADINGS, type PaletteHeading, type RichCopyFlavor, type RichCopyRunner, type SerializableFormat, type ShapedSource, type SourceShape, type TransferCapabilities, type TransferMenuPresentation, type TransferMenuVariant, type WorkspaceLevers, type WorkspaceWindowHandle, type WorkspaceWindowPort, applyGroomerPreset, buildGroomerPresetPayload, createTransferEmailActions, defaultGroomerSelections, groomerPresetVariants, tableDataFormat, tableSchemaFormat, useContentTransferCapabilities, useContentTransferSurface };
+export { type AlchemyCopyVariant, type AlchemyCustomSource, type AlchemyDetail, type AlchemyExportItem, AlchemyGlyph, type AlchemyGroomerConfig, type AlchemyGroomerPreset, type AlchemyGroomerSection, type AlchemyOptionValues, type AlchemySourceOption, AlchemyTableCopyControls, type ContentTransferCapabilities, ContentTransferCapabilitiesProvider, type ContentTransferController, type ContentTransferEmailPort, type ContentTransferHtmlPreviewPort, ContentTransferMenu, type ContentTransferMenuProps, type ContentTransferReferenceAction, type ContentTransferReferencePort, ContentTransferSurfaceProvider, type EnvelopeMeta, GROOMER_LEVELS, MatrxCopyMenu, type MatrxCopyMenuProps, PALETTE_HEADINGS, type PaletteHeading, type RichCopyFlavor, type RichCopyRunner, type SerializableFormat, type ShapedSource, type SourceShape, type TransferCapabilities, type TransferMenuPresentation, type TransferMenuVariant, type WorkspaceLevers, type WorkspaceWindowHandle, type WorkspaceWindowPort, applyGroomerPreset, buildGroomerPresetPayload, createTransferEmailActions, createTransferHtmlPreviewAction, defaultGroomerSelections, groomerPresetVariants, tableDataFormat, tableSchemaFormat, useContentTransferCapabilities, useContentTransferSurface };

package/dist/react-workspace.d.ts

@@ -160,10 +160,18 @@ type ContentTransferEmailPort = {
         signal: AbortSignal;
     }): Promise<TransferOutcome>;
 };
+/** The host's HTML preview (a window or overlay that renders the document); Alchemy only decides when to offer it. */
+type ContentTransferHtmlPreviewPort = {
+    open(request: {
+        content: string;
+        title: string;
+    }): void | Promise<void>;
+};
 /** A sealed, projection-safe representation of a tabular draft's declared schema and values. */
 declare const tableSchemaFormat: FormatAdapter;
 /** Flat row JSON keyed by user-facing display labels, never raw table records. */
 declare const tableDataFormat: FormatAdapter;
+type TransferHtmlPreviewAction = PageAction;
 type TransferEmailAction = PageAction & {
     prepared: true;
     group: "email";
@@ -172,6 +180,11 @@ type TransferEmailAction = PageAction & {
 declare function createTransferEmailActions(email: ContentTransferEmailPort, options?: {
     jsonFormat?: FormatAdapter;
 }): TransferEmailAction[];
+/**
+ * "HTML preview": opens the host's preview on the PREPARED text (what the person would copy, edits
+ * and thinking-strip included). Offered for Markdown and text drafts only — a table has no document.
+ */
+declare function createTransferHtmlPreviewAction(port: ContentTransferHtmlPreviewPort): TransferHtmlPreviewAction;
 
 interface AlchemyCopyVariant {
     id: string;
@@ -230,6 +243,18 @@ interface MatrxCopyMenuProps {
      * transport and offers no Copy text tile (readable text is the host's one projection).
      */
     richCopy?: (markdown: string, flavor: RichCopyFlavor) => Promise<TransferOutcome | boolean | void> | TransferOutcome | boolean | void;
+    /**
+     * Model output: every copy of `human` leaves out its reasoning blocks (`<thinking>`, `<think>`,
+     * `<reasoning>`), and when it held any the panel offers "Copy including thinking" with the full text.
+     * A function `human` is never read to decide this (opening the menu prepares nothing), so the
+     * variant is offered for a string `human` only.
+     */
+    stripThinking?: boolean;
+    /**
+     * Offer "HTML preview" for `human` (markdown) when the host bound `capabilities.htmlPreview`.
+     * Default true for `contentFlavor="markdown"`; pass false where the host's editable preview is the one action.
+     */
+    htmlPreview?: boolean;
     json?: Resolvable<unknown>;
     agent?: Resolvable<AgentPayloadInput | string>;
     aiVariants?: AlchemyCopyVariant[];
@@ -299,6 +324,8 @@ type ContentTransferCapabilities = TransferCapabilities & {
     transport?: Transport;
     reference?: ContentTransferReferencePort;
     email?: ContentTransferEmailPort;
+    /** The host's HTML preview. Bound: a menu mounted with `htmlPreview` offers the "HTML preview" action. */
+    htmlPreview?: ContentTransferHtmlPreviewPort;
     actions?: PageAction[];
     preferences?: TransferPreferenceOverrides;
     onOutcome?: (outcome: TransferOutcome) => void;
@@ -376,6 +403,8 @@ interface ContentTransferMenuProps {
     /** Named alternate sources open this same preparation workspace. */
     variants?: readonly TransferMenuVariant[];
     actions?: (PageAction & TransferMenuPresentation)[];
+    /** Offer "HTML preview" (Markdown and text only) when the host bound `capabilities.htmlPreview`. */
+    htmlPreview?: boolean;
     capabilities?: ContentTransferCapabilities;
     disabled?: boolean;
     /** Portal is the default Alchemy mark; copy-transform remains opt-in. */
@@ -438,4 +467,4 @@ type ShapedSource = Source & {
     shape?: SourceShape;
 };
 
-export { type AlchemyCopyVariant, type AlchemyCustomSource, type AlchemyDetail, type AlchemyExportItem, AlchemyGlyph, type AlchemyGroomerConfig, type AlchemyGroomerPreset, type AlchemyGroomerSection, type AlchemyOptionValues, type AlchemySourceOption, AlchemyTableCopyControls, type ContentTransferCapabilities, ContentTransferCapabilitiesProvider, type ContentTransferController, type ContentTransferEmailPort, ContentTransferMenu, type ContentTransferMenuProps, type ContentTransferReferenceAction, type ContentTransferReferencePort, ContentTransferSurfaceProvider, type EnvelopeMeta, GROOMER_LEVELS, MatrxCopyMenu, type MatrxCopyMenuProps, PALETTE_HEADINGS, type PaletteHeading, type RichCopyFlavor, type RichCopyRunner, type SerializableFormat, type ShapedSource, type SourceShape, type TransferCapabilities, type TransferMenuPresentation, type TransferMenuVariant, type WorkspaceLevers, type WorkspaceWindowHandle, type WorkspaceWindowPort, applyGroomerPreset, buildGroomerPresetPayload, createTransferEmailActions, defaultGroomerSelections, groomerPresetVariants, tableDataFormat, tableSchemaFormat, useContentTransferCapabilities, useContentTransferSurface };
+export { type AlchemyCopyVariant, type AlchemyCustomSource, type AlchemyDetail, type AlchemyExportItem, AlchemyGlyph, type AlchemyGroomerConfig, type AlchemyGroomerPreset, type AlchemyGroomerSection, type AlchemyOptionValues, type AlchemySourceOption, AlchemyTableCopyControls, type ContentTransferCapabilities, ContentTransferCapabilitiesProvider, type ContentTransferController, type ContentTransferEmailPort, type ContentTransferHtmlPreviewPort, ContentTransferMenu, type ContentTransferMenuProps, type ContentTransferReferenceAction, type ContentTransferReferencePort, ContentTransferSurfaceProvider, type EnvelopeMeta, GROOMER_LEVELS, MatrxCopyMenu, type MatrxCopyMenuProps, PALETTE_HEADINGS, type PaletteHeading, type RichCopyFlavor, type RichCopyRunner, type SerializableFormat, type ShapedSource, type SourceShape, type TransferCapabilities, type TransferMenuPresentation, type TransferMenuVariant, type WorkspaceLevers, type WorkspaceWindowHandle, type WorkspaceWindowPort, applyGroomerPreset, buildGroomerPresetPayload, createTransferEmailActions, createTransferHtmlPreviewAction, defaultGroomerSelections, groomerPresetVariants, tableDataFormat, tableSchemaFormat, useContentTransferCapabilities, useContentTransferSurface };