@oddkin/ai 0.0.0-stage → 1.0.0-beta.0

package/dist/message/message.d.ts

@@ -0,0 +1,330 @@
+import { OddkinElement, type ElementEvents } from '@oddkin/core/element';
+import type { AttemptRecord, BranchPosition, JsonValue, MessagePart, PartOf } from '../contracts/types.js';
+import type { ArtifactRenderer } from '../artifact/artifact.js';
+import type { ResponseStatus } from '../response/response.js';
+import type { ToolOutputRenderer } from '../tool-call/tool-call.js';
+import type { MarkdownOptions } from '../markdown/render.js';
+import type { Scope } from '@oddkin/core/scope';
+export declare const MESSAGE_STRINGS: {
+    user: string;
+    assistant: string;
+    system: string;
+    tool: string;
+    reasoning: string;
+    copy: string;
+    copied: string;
+    copyFailed: string;
+    regenerate: string;
+    edit: string;
+    save: string;
+    cancel: string;
+    editLabel: string;
+    unsupported: string;
+    toolMissing: string;
+    approvalMissing: string;
+    artifactMissing: string;
+    dataInvalid: string;
+    file: string;
+};
+/** A registered renderer for `data` parts: validates untrusted data before rendering it. */
+export interface DataRenderer {
+    validate(data: JsonValue): boolean;
+    render(data: JsonValue, part: PartOf<'data'>): Node;
+}
+declare const OddkinMessage_base: import("@oddkin/core/element").WithProps<typeof OddkinElement, {
+    readonly message: import("@oddkin/core/element").PropDefinition<{
+        attemptId?: string | undefined;
+        createdAt?: string | undefined;
+        id: string;
+        parentId?: string | undefined;
+        parts: ({
+            approvalId: string;
+            id: string;
+            type: "approval";
+        } | {
+            artifactId: string;
+            id: string;
+            revisionId?: string | undefined;
+            type: "artifact";
+        } | {
+            data: JsonValue;
+            id: string;
+            name: string;
+            type: "data";
+        } | {
+            id: string;
+            mediaType: string;
+            name: string;
+            size?: number | undefined;
+            type: "file";
+            url?: string | undefined;
+        } | {
+            id: string;
+            state?: "done" | "streaming" | undefined;
+            text: string;
+            type: "reasoning";
+        } | {
+            excerpt?: string | undefined;
+            id: string;
+            kind?: "document" | "file" | "other" | "web" | undefined;
+            publisher?: string | undefined;
+            sourceId: string;
+            title?: string | undefined;
+            type: "source";
+            url?: string | undefined;
+        } | {
+            id: string;
+            state?: "done" | "streaming" | undefined;
+            text: string;
+            type: "text";
+        } | {
+            id: string;
+            toolCallId: string;
+            type: "tool-call";
+        } | {
+            id: string;
+            originalType: string;
+            type: "unsupported";
+        })[];
+        provenance?: {
+            generatedAt?: string | undefined;
+            kind: "assisted" | "edited" | "generated" | "human";
+            label?: string | undefined;
+            model?: string | undefined;
+            notes?: string | undefined;
+            provider?: string | undefined;
+        } | undefined;
+        role: "assistant" | "system" | "tool" | "user";
+    } | undefined>;
+    readonly attempt: import("@oddkin/core/element").PropDefinition<AttemptRecord | undefined>;
+    readonly tools: import("@oddkin/core/element").PropDefinition<Readonly<Record<string, {
+        approvalId?: string | undefined;
+        attemptId?: string | undefined;
+        error?: {
+            code: string;
+            message: string;
+            retryable?: boolean | undefined;
+        } | undefined;
+        input?: JsonValue | undefined;
+        inputText?: string | undefined;
+        output?: JsonValue | undefined;
+        purpose?: string | undefined;
+        retryable?: boolean | undefined;
+        status: "awaiting-approval" | "cancelled" | "denied" | "executing" | "input-available" | "input-streaming" | "output-available" | "output-error";
+        title?: string | undefined;
+        toolCallId: string;
+        toolName: string;
+    }>> | undefined>;
+    readonly approvals: import("@oddkin/core/element").PropDefinition<Readonly<Record<string, {
+        approvalId: string;
+        attemptId?: string | undefined;
+        changes?: {
+            after?: string | undefined;
+            before?: string | undefined;
+            label: string;
+        }[] | undefined;
+        decision?: "approve" | "reject" | undefined;
+        error?: {
+            code: string;
+            message: string;
+            retryable?: boolean | undefined;
+        } | undefined;
+        expiresAt?: string | undefined;
+        reason?: string | undefined;
+        revision: number;
+        risk?: "high" | "low" | "medium" | undefined;
+        status: "approved" | "decision-failed" | "decision-pending" | "expired" | "rejected" | "requested" | "superseded";
+        summary?: string | undefined;
+        target?: string | undefined;
+        title: string;
+        toolCallId?: string | undefined;
+    }>> | undefined>;
+    readonly artifacts: import("@oddkin/core/element").PropDefinition<Readonly<Record<string, {
+        artifactId: string;
+        currentRevisionId: string;
+        kind: string;
+        language?: string | undefined;
+        revisions: {
+            content: string;
+            createdAt?: string | undefined;
+            number: number;
+            revisionId: string;
+            summary?: string | undefined;
+        }[];
+        title: string;
+    }>> | undefined>;
+    readonly branch: import("@oddkin/core/element").PropDefinition<BranchPosition | undefined>;
+    readonly feedback: import("@oddkin/core/element").PropDefinition<{
+        comment?: string | undefined;
+        error?: {
+            code: string;
+            message: string;
+            retryable?: boolean | undefined;
+        } | undefined;
+        messageId: string;
+        rating?: "negative" | "positive" | undefined;
+        reasons?: string[] | undefined;
+        status: "failed" | "idle" | "pending" | "submitted";
+    } | undefined>;
+    readonly capabilities: import("@oddkin/core/element").PropDefinition<{
+        attachments?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        disconnect?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        edit?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        editApproval?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        feedback?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        history?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        reconnect?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        regenerate?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        respondToApproval?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        restoreCheckpoint?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        resume?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        retry?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        send?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        stop?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        switchBranch?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        voice?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+    } | undefined>;
+    readonly markdown: import("@oddkin/core/element").PropDefinition<MarkdownOptions | undefined>;
+    readonly renderers: import("@oddkin/core/element").PropDefinition<Readonly<Record<string, DataRenderer>> | undefined>;
+    readonly artifactRenderers: import("@oddkin/core/element").PropDefinition<Readonly<Record<string, ArtifactRenderer>> | undefined>;
+    readonly renderTool: import("@oddkin/core/element").PropDefinition<{
+        render: ToolOutputRenderer;
+    } | undefined>;
+    readonly feedbackReasons: import("@oddkin/core/element").PropDefinition<string[]>;
+    readonly strings: import("@oddkin/core/element").PropDefinition<Partial<{
+        user: string;
+        assistant: string;
+        system: string;
+        tool: string;
+        reasoning: string;
+        copy: string;
+        copied: string;
+        copyFailed: string;
+        regenerate: string;
+        edit: string;
+        save: string;
+        cancel: string;
+        editLabel: string;
+        unsupported: string;
+        toolMissing: string;
+        approvalMissing: string;
+        artifactMissing: string;
+        dataInvalid: string;
+        file: string;
+    }> | undefined>;
+}>;
+/**
+ * One message: its role, structured parts in order (text, reasoning, files, sources, tools,
+ * approvals, artifacts, data), and message actions (copy, regenerate, edit, versions,
+ * feedback, provenance). Parts with unknown types or missing records render explicit fallbacks.
+ *
+ * @csspart header - Role label and provenance.
+ * @csspart content - The parts.
+ * @csspart footer - Actions, versions, and feedback.
+ * @a11y The role label is visible text. Inside `odd-conversation` the host element is a feed article. Editing moves focus into the edit field only after the user chooses Edit, and back to Edit when cancelled.
+ * @keyboard Tab through actions; Escape cancels editing.
+ * @useFor Rendering a message from a conversation record.
+ * @notFor Free-form chat bubbles without records.
+ * @customization 1 2
+ * @category AI
+ */
+export declare class OddkinMessage extends OddkinMessage_base {
+    static events: {
+        'odd-message-edit': import("@oddkin/core/element").EventDefinition<{
+            readonly messageId: string;
+            readonly text: string;
+        }>;
+        'odd-message-regenerate': import("@oddkin/core/element").EventDefinition<{
+            readonly messageId: string;
+            readonly attemptId: string;
+        }>;
+        'odd-announce': import("@oddkin/core/element").EventDefinition<import("../events.js").AnnounceDetail>;
+    };
+    readonly _events?: ElementEvents<typeof OddkinMessage>;
+    /** @internal Inline edit draft (presentation state); undefined when not editing. */
+    readonly _editing: import("@oddkin/core/reactive").Signal<string | undefined>;
+    /** @internal */
+    get _strings(): typeof MESSAGE_STRINGS;
+    /** Canonical text of the message (text parts joined), as copied. */
+    get text(): string;
+    /** @internal */
+    get _sources(): PartOf<'source'>[];
+    /** @internal Display status for a text part. */
+    _textStatus(part: MessagePart, last: boolean): ResponseStatus;
+    /** @internal */
+    _data(part: PartOf<'data'>): Node | undefined;
+    /** @internal */
+    _can(name: 'regenerate' | 'edit' | 'feedback'): boolean;
+    /** @internal */
+    readonly _copy: () => Promise<void>;
+    /** @internal */
+    readonly _regenerate: () => void;
+    /** @internal */
+    readonly _startEdit: () => void;
+    /** @internal */
+    readonly _onEditInput: (event: Event) => void;
+    /** @internal */
+    readonly _cancelEdit: () => void;
+    /** @internal */
+    readonly _saveEdit: (event: Event) => void;
+    /** @internal */
+    readonly _onEditKey: (event: KeyboardEvent) => void;
+    protected connected(scope: Scope): void;
+    /** @internal */
+    _unsupported(type: string): string;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'odd-message': OddkinMessage;
+    }
+}
+export {};
+//# sourceMappingURL=message.d.ts.map

package/dist/message/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/message/message.ts"],"names":[],"mappings":"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"}

package/dist/message/message.define.d.ts

@@ -0,0 +1,3 @@
+/// <reference path="message.d.ts" preserve="true" />
+export {};
+//# sourceMappingURL=message.define.d.ts.map

package/dist/message/message.define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.define.d.ts","sourceRoot":"","sources":["../../src/message/message.define.ts"],"names":[],"mappings":""}

package/dist/message/message.define.js

@@ -0,0 +1,5 @@
+/// <reference path="./message.ts" preserve="true" />
+import { define } from '@oddkin/core/element';
+import { messageDefinition } from './message.definition.js';
+define(messageDefinition);
+//# sourceMappingURL=message.define.js.map

package/dist/message/message.define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.define.js","sourceRoot":"","sources":["../../src/message/message.define.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/message/message.definition.d.ts

@@ -0,0 +1,3 @@
+import { OddkinMessage } from './message.js';
+export declare const messageDefinition: import("@oddkin/core/element").ElementDefinition<OddkinMessage>;
+//# sourceMappingURL=message.definition.d.ts.map

package/dist/message/message.definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.definition.d.ts","sourceRoot":"","sources":["../../src/message/message.definition.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAI7C,eAAO,MAAM,iBAAiB,iEAgB5B,CAAC"}

package/dist/message/message.definition.js

@@ -0,0 +1,32 @@
+import { buttonDefinition } from '@oddkin/components/button';
+import { compose } from '@oddkin/core/element';
+import { actionApprovalDefinition } from '../action-approval/action-approval.definition.js';
+import { aiLabelDefinition } from '../ai-label/ai-label.definition.js';
+import { artifactDefinition } from '../artifact/artifact.definition.js';
+import { aiBaseStyles } from '../internal/base.styles.js';
+import { messageBranchDefinition } from '../message-branch/message-branch.definition.js';
+import { responseFeedbackDefinition } from '../response-feedback/response-feedback.definition.js';
+import { responseDefinition } from '../response/response.definition.js';
+import { sourcesDefinition } from '../sources/sources.definition.js';
+import { toolCallDefinition } from '../tool-call/tool-call.definition.js';
+import { OddkinMessage } from './message.js';
+import { messageStyles } from './message.styles.js';
+import { messageTemplate } from './message.template.js';
+export const messageDefinition = compose({
+    name: 'odd-message',
+    element: OddkinMessage,
+    template: messageTemplate,
+    styles: [aiBaseStyles, messageStyles],
+    dependencies: {
+        button: buttonDefinition,
+        response: responseDefinition,
+        sources: sourcesDefinition,
+        toolCall: toolCallDefinition,
+        approval: actionApprovalDefinition,
+        artifact: artifactDefinition,
+        branch: messageBranchDefinition,
+        feedback: responseFeedbackDefinition,
+        label: aiLabelDefinition,
+    },
+});
+//# sourceMappingURL=message.definition.js.map

package/dist/message/message.definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.definition.js","sourceRoot":"","sources":["../../src/message/message.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,kDAAkD,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;IACvC,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,aAAa;IACtB,QAAQ,EAAE,eAAe;IACzB,MAAM,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC;IACrC,YAAY,EAAE;QACZ,MAAM,EAAE,gBAAgB;QACxB,QAAQ,EAAE,kBAAkB;QAC5B,OAAO,EAAE,iBAAiB;QAC1B,QAAQ,EAAE,kBAAkB;QAC5B,QAAQ,EAAE,wBAAwB;QAClC,QAAQ,EAAE,kBAAkB;QAC5B,MAAM,EAAE,uBAAuB;QAC/B,QAAQ,EAAE,0BAA0B;QACpC,KAAK,EAAE,iBAAiB;KACzB;CACF,CAAC,CAAC"}

package/dist/message/message.js

@@ -0,0 +1,193 @@
+import { OddkinElement, prop } from '@oddkin/core/element';
+import { signal } from '@oddkin/core/reactive';
+import { can } from '../contracts/normalize.js';
+import { announceEvent, messageEditEvent, messageRegenerateEvent } from '../events.js';
+import { revealSourceEvent } from '../citation/citation.js';
+import { format, strings } from '../internal/strings.js';
+export const MESSAGE_STRINGS = {
+    user: 'You',
+    assistant: 'Assistant',
+    system: 'System',
+    tool: 'Tool',
+    reasoning: 'Reasoning',
+    copy: 'Copy',
+    copied: 'Copied to clipboard.',
+    copyFailed: 'Copying failed.',
+    regenerate: 'Regenerate',
+    edit: 'Edit',
+    save: 'Send edited message',
+    cancel: 'Cancel',
+    editLabel: 'Edit your message',
+    unsupported: 'This message contains content ({type}) that can’t be shown here.',
+    toolMissing: 'A tool call is referenced but its record is missing.',
+    approvalMissing: 'An approval is referenced but its record is missing.',
+    artifactMissing: 'An artifact is referenced but its record is missing.',
+    dataInvalid: 'Structured content “{name}” was not shown because it did not pass validation.',
+    file: 'Attachment',
+};
+/**
+ * One message: its role, structured parts in order (text, reasoning, files, sources, tools,
+ * approvals, artifacts, data), and message actions (copy, regenerate, edit, versions,
+ * feedback, provenance). Parts with unknown types or missing records render explicit fallbacks.
+ *
+ * @csspart header - Role label and provenance.
+ * @csspart content - The parts.
+ * @csspart footer - Actions, versions, and feedback.
+ * @a11y The role label is visible text. Inside `odd-conversation` the host element is a feed article. Editing moves focus into the edit field only after the user chooses Edit, and back to Edit when cancelled.
+ * @keyboard Tab through actions; Escape cancels editing.
+ * @useFor Rendering a message from a conversation record.
+ * @notFor Free-form chat bubbles without records.
+ * @customization 1 2
+ * @category AI
+ */
+export class OddkinMessage extends OddkinElement.with({
+    message: prop.object({ description: 'The message record.' }),
+    attempt: prop.object({
+        description: 'The attempt that writes this (assistant) message.',
+    }),
+    tools: prop.object({
+        description: 'Tool call records by id.',
+    }),
+    approvals: prop.object({
+        description: 'Approval records by id.',
+    }),
+    artifacts: prop.object({
+        description: 'Artifact records by id.',
+    }),
+    branch: prop.object({ description: 'Position among alternative versions.' }),
+    feedback: prop.object({ description: 'Feedback record for this message.' }),
+    capabilities: prop.object({
+        description: 'Enables regenerate, edit, branches, feedback, approvals.',
+    }),
+    markdown: prop.object({ description: 'Markdown rendering options.' }),
+    renderers: prop.object({
+        description: 'Validated renderers for `data` parts by name.',
+    }),
+    artifactRenderers: prop.object({
+        description: 'Artifact renderers by kind.',
+    }),
+    renderTool: prop.object({
+        description: 'Renderer for tool results.',
+    }),
+    feedbackReasons: prop.array({ description: 'Reasons offered for negative feedback.' }),
+    strings: prop.object({
+        description: 'Localized string overrides.',
+    }),
+}) {
+    static events = {
+        'odd-message-edit': messageEditEvent,
+        'odd-message-regenerate': messageRegenerateEvent,
+        'odd-announce': announceEvent,
+    };
+    /** @internal Inline edit draft (presentation state); undefined when not editing. */
+    _editing = signal(undefined);
+    /** @internal */
+    get _strings() {
+        return strings(MESSAGE_STRINGS, this.strings);
+    }
+    /** Canonical text of the message (text parts joined), as copied. */
+    get text() {
+        return (this.message?.parts ?? [])
+            .filter((p) => p.type === 'text')
+            .map((p) => p.text)
+            .join('\n\n');
+    }
+    /** @internal */
+    get _sources() {
+        return (this.message?.parts ?? []).filter((p) => p.type === 'source');
+    }
+    /** @internal Display status for a text part. */
+    _textStatus(part, last) {
+        if ((part.type === 'text' || part.type === 'reasoning') && part.state === 'streaming')
+            return 'streaming';
+        const status = this.attempt?.status;
+        if (last && (status === 'interrupted' || status === 'cancelled' || status === 'failed'))
+            return status;
+        if (last && (status === 'streaming' || status === 'submitted' || status === 'accepted'))
+            return 'streaming';
+        return 'complete';
+    }
+    /** @internal */
+    _data(part) {
+        const renderer = this.renderers?.[part.name];
+        if (!renderer)
+            return undefined;
+        try {
+            return renderer.validate(part.data) ? renderer.render(part.data, part) : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /** @internal */
+    _can(name) {
+        return can(this.capabilities, name);
+    }
+    /** @internal */
+    _copy = async () => {
+        const t = this._strings;
+        try {
+            await navigator.clipboard.writeText(this.text);
+            this.emit(announceEvent, { text: t.copied, priority: 'polite', key: `copy:${Date.now()}` });
+        }
+        catch {
+            this.emit(announceEvent, {
+                text: t.copyFailed,
+                priority: 'polite',
+                key: `copy-failed:${Date.now()}`,
+            });
+        }
+    };
+    /** @internal */
+    _regenerate = () => {
+        const m = this.message;
+        if (m?.attemptId && this._can('regenerate'))
+            this.emit(messageRegenerateEvent, { messageId: m.id, attemptId: m.attemptId });
+    };
+    /** @internal */
+    _startEdit = () => {
+        this._editing.value = this.text;
+        void this.updateComplete.then(() => this.shadowRoot?.querySelector('.edit textarea')?.focus());
+    };
+    /** @internal */
+    _onEditInput = (event) => {
+        this._editing.value = event.target.value;
+    };
+    /** @internal */
+    _cancelEdit = () => {
+        this._editing.value = undefined;
+        void this.updateComplete.then(() => this.shadowRoot?.querySelector('[data-action="edit"]')?.focus());
+    };
+    /** @internal */
+    _saveEdit = (event) => {
+        event.preventDefault();
+        const m = this.message;
+        const text = this._editing.peek()?.trim();
+        if (!m || !text)
+            return;
+        this._editing.value = undefined;
+        this.emit(messageEditEvent, { messageId: m.id, text });
+    };
+    /** @internal */
+    _onEditKey = (event) => {
+        if (event.key === 'Escape') {
+            event.stopPropagation();
+            this._cancelEdit();
+        }
+    };
+    connected(scope) {
+        // Default action of an uncancelled odd-citation-open: reveal the source in this message.
+        scope.listen(this, revealSourceEvent.type, (event) => {
+            const sources = this.shadowRoot?.querySelector('odd-sources');
+            if (sources && sources.reveal(event.detail.sourceId)) {
+                event.preventDefault();
+                event.stopPropagation();
+            }
+        });
+    }
+    /** @internal */
+    _unsupported(type) {
+        return format(this._strings.unsupported, { type });
+    }
+}
+//# sourceMappingURL=message.js.map

package/dist/message/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/message/message.ts"],"names":[],"mappings":"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"}

package/dist/message/message.recipe.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Arrangement of a message (layout-recipes.md §14): header, content, and footer in a column; the
+ * header's role and status in a row that wraps; the parts of the content and the edit form in
+ * columns.
+ */
+export declare const messageRecipe: import("@oddkin/components/layout").LayoutRecipe;
+//# sourceMappingURL=message.recipe.d.ts.map

package/dist/message/message.recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.recipe.d.ts","sourceRoot":"","sources":["../../src/message/message.recipe.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,aAAa,kDAQxB,CAAC"}

package/dist/message/message.recipe.js

@@ -0,0 +1,17 @@
+import { defineLayoutRecipe, row, stack } from '@oddkin/components/layout';
+import { token } from '@oddkin/tokens/refs';
+/**
+ * Arrangement of a message (layout-recipes.md §14): header, content, and footer in a column; the
+ * header's role and status in a row that wraps; the parts of the content and the edit form in
+ * columns.
+ */
+export const messageRecipe = defineLayoutRecipe({
+    name: 'message',
+    regions: {
+        base: stack({ gap: token('space.xs') }),
+        header: row({ gap: token('space.xs'), wrap: true }),
+        content: stack({ gap: token('space.sm') }),
+        edit: stack({ gap: token('space.xs') }),
+    },
+});
+//# sourceMappingURL=message.recipe.js.map

package/dist/message/message.recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.recipe.js","sourceRoot":"","sources":["../../src/message/message.recipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,kBAAkB,CAAC;IAC9C,IAAI,EAAE,SAAS;IACf,OAAO,EAAE;QACP,IAAI,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACnD,OAAO,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,IAAI,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;KACxC;CACF,CAAC,CAAC"}

package/dist/message/message.recipe.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const messageRecipeStyles: import("@oddkin/core/styles").CSSResult;
+//# sourceMappingURL=message.recipe.styles.d.ts.map

package/dist/message/message.recipe.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.recipe.styles.d.ts","sourceRoot":"","sources":["../../src/message/message.recipe.styles.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,mBAAmB,yCAE/B,CAAC"}

package/dist/message/message.recipe.styles.js

@@ -0,0 +1,5 @@
+// Generated from ./message.recipe.ts by packages/ai/test/recipes.test.ts (UPDATE_FIXTURES=1).
+// Do not edit: change the recipe and regenerate.
+import { unsafeCSS } from '@oddkin/core/styles';
+export const messageRecipeStyles = unsafeCSS('@layer odd.layout.base {\n  .base {\n    display: flex;\n    flex-direction: column;\n    gap: var(--odd-space-xs);\n    min-inline-size: 0;\n  }\n  .header {\n    display: flex;\n    flex-direction: row;\n    align-items: center;\n    gap: var(--odd-space-xs);\n    flex-wrap: wrap;\n    min-inline-size: 0;\n  }\n  .content {\n    display: flex;\n    flex-direction: column;\n    gap: var(--odd-space-sm);\n    min-inline-size: 0;\n  }\n  .edit {\n    display: flex;\n    flex-direction: column;\n    gap: var(--odd-space-xs);\n    min-inline-size: 0;\n  }\n}\n');
+//# sourceMappingURL=message.recipe.styles.js.map

package/dist/message/message.recipe.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.recipe.styles.js","sourceRoot":"","sources":["../../src/message/message.recipe.styles.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,iDAAiD;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAC1C,qjBAAqjB,CACtjB,CAAC"}