netra-artifacts 0.1.0-alpha.0

package/dist/stream/predictiveHtmlParser.js

@@ -0,0 +1,252 @@
+/**
+ * Predictive HTML parser for streaming AI output.
+ *
+ * The core idea: keep the real streamed HTML as the immutable *truth*, but for
+ * rendering produce a temporary *projection* that predicts the missing closing
+ * tags from the current parser stack. The model can stream
+ *
+ *     <section><div><h2>Hello
+ *
+ * and the renderer receives a valid document:
+ *
+ *     <section><div><h2>Hello</h2></div></section>
+ *
+ * When the real `</h2></div></section>` arrives later, the stack matches them
+ * and nothing is duplicated — predicted closings are never written back into
+ * the committed truth.
+ *
+ * The parser is incremental: feed it chunks with {@link push}; it carries
+ * partial tokens (tags, comments, raw-text close) across chunk boundaries. It
+ * handles void elements, self-closing tags, quoted attributes containing
+ * `<`/`>`, comments, doctype, raw-text elements (`<style>`/`<script>`/… whose
+ * bodies aren't markup), implicit closing (`<li>`, `<td>`, `<p>`, …), and
+ * mis-nested close tags (`<div><p>x</div>` → closes `p` before `div`).
+ *
+ * It is purely structural — it does NOT sanitize or style. Run the output
+ * through the sanitizer before rendering (the iframe pipeline does this).
+ *
+ * Fail-open: malformed input degrades to text rather than throwing.
+ */
+const VOID_TAGS = new Set([
+    "area", "base", "br", "col", "embed", "hr", "img", "input",
+    "link", "meta", "param", "source", "track", "wbr",
+]);
+// Elements whose content is text, not markup. An unclosed one would otherwise
+// swallow everything after it; we consume to the real closer instead.
+const RAW_TEXT_TAGS = new Set(["script", "style", "textarea", "title"]);
+// When the key element is open and one of its value elements opens, the key is
+// implicitly closed first (mirrors the HTML parsing spec, pragmatically).
+const IMPLICIT_CLOSE_RULES = {
+    p: new Set([
+        "p", "div", "section", "article", "main", "header", "footer", "nav",
+        "aside", "ul", "ol", "dl", "table", "form", "blockquote", "pre",
+        "h1", "h2", "h3", "h4", "h5", "h6", "figure", "hr",
+    ]),
+    li: new Set(["li"]),
+    dt: new Set(["dt", "dd"]),
+    dd: new Set(["dt", "dd"]),
+    tr: new Set(["tr", "tbody", "tfoot", "thead"]),
+    td: new Set(["td", "th", "tr", "tbody", "tfoot", "thead"]),
+    th: new Set(["td", "th", "tr", "tbody", "tfoot", "thead"]),
+    thead: new Set(["tbody", "tfoot"]),
+    tbody: new Set(["tbody", "tfoot"]),
+    option: new Set(["option", "optgroup"]),
+};
+export class PredictiveHtmlParser {
+    committed = "";
+    pending = "";
+    stack = [];
+    insideRawText = null;
+    htmlClosed = false;
+    /** Feed a chunk; returns the current renderable projection. */
+    push(chunk) {
+        if (typeof chunk === "string" && chunk.length > 0) {
+            try {
+                this.process(this.pending + chunk);
+            }
+            catch {
+                // Fail open: keep whatever we had, treat the chunk as text.
+                this.pending = "";
+                this.committed += chunk;
+            }
+        }
+        return this.render();
+    }
+    /** The current renderable projection: committed + predicted closings. */
+    render() {
+        let html = this.committed;
+        // Only append the held tail if it's plain text (CSS/text), never a partial
+        // tag fragment like "<div cla" or "</sty".
+        if (this.pending && !this.pending.startsWith("<"))
+            html += this.pending;
+        for (let i = this.stack.length - 1; i >= 0; i--) {
+            html += `</${this.stack[i]}>`;
+        }
+        return html;
+    }
+    /** The immutable, never-predicted truth committed so far. */
+    get committedHtml() {
+        return this.committed;
+    }
+    /** True once a real `</html>` has balanced the document. */
+    get complete() {
+        return this.htmlClosed;
+    }
+    /** Is there visible body content worth rendering yet? */
+    isRenderable() {
+        const body = /<body\b[^>]*>([\s\S]*)$/i.exec(this.committed);
+        if (body)
+            return /\S/.test(body[1] ?? "");
+        return /<(?:div|section|main|header|footer|h[1-6]|p|ul|ol|li|table|article|nav|svg|img|button|form|span|a|figure|blockquote)\b/i.test(this.committed);
+    }
+    reset() {
+        this.committed = "";
+        this.pending = "";
+        this.stack = [];
+        this.insideRawText = null;
+        this.htmlClosed = false;
+    }
+    process(buf) {
+        this.pending = "";
+        const n = buf.length;
+        let i = 0;
+        while (i < n) {
+            // Inside a raw-text element: consume verbatim until its real closer.
+            if (this.insideRawText) {
+                const tag = this.insideRawText;
+                const re = new RegExp(`</${tag}\\s*>`, "i");
+                const m = re.exec(buf.slice(i));
+                if (m) {
+                    const end = i + m.index + m[0].length;
+                    this.committed += buf.slice(i, end);
+                    const idx = this.stack.lastIndexOf(tag);
+                    if (idx !== -1)
+                        this.stack.length = idx;
+                    this.insideRawText = null;
+                    i = end;
+                    continue;
+                }
+                // Closer not here yet: commit what we safely can, hold back enough to
+                // catch a closer split across the boundary (e.g. "</styl").
+                const holdback = `</${tag}>`.length - 1;
+                const safeEnd = Math.max(i, n - holdback);
+                if (safeEnd > i)
+                    this.committed += buf.slice(i, safeEnd);
+                this.pending = buf.slice(safeEnd);
+                return;
+            }
+            const lt = buf.indexOf("<", i);
+            if (lt === -1) {
+                this.committed += buf.slice(i);
+                return;
+            }
+            if (lt > i)
+                this.committed += buf.slice(i, lt);
+            // Comment.
+            if (buf.startsWith("<!--", lt)) {
+                const end = buf.indexOf("-->", lt + 4);
+                if (end === -1) {
+                    this.pending = buf.slice(lt);
+                    return;
+                }
+                this.committed += buf.slice(lt, end + 3);
+                i = end + 3;
+                continue;
+            }
+            // Doctype / declaration / processing instruction.
+            if (buf.startsWith("<!", lt) || buf.startsWith("<?", lt)) {
+                const end = buf.indexOf(">", lt + 2);
+                if (end === -1) {
+                    this.pending = buf.slice(lt);
+                    return;
+                }
+                this.committed += buf.slice(lt, end + 1);
+                i = end + 1;
+                continue;
+            }
+            const gt = findTagEnd(buf, lt);
+            if (gt === -1) {
+                // Incomplete tag at the frontier — hold it for the next chunk.
+                this.pending = buf.slice(lt);
+                return;
+            }
+            const raw = buf.slice(lt, gt + 1);
+            const name = tagName(raw);
+            if (!name) {
+                // Not a real tag ("<>" or "< x"); treat literally as text.
+                this.committed += raw;
+                i = gt + 1;
+                continue;
+            }
+            if (raw[1] === "/")
+                this.handleClose(name, raw);
+            else
+                this.handleOpen(name, raw);
+            i = gt + 1;
+        }
+    }
+    handleOpen(name, raw) {
+        this.autoCloseImplicit(name);
+        this.committed += raw;
+        const selfClosing = /\/\s*>$/.test(raw);
+        if (VOID_TAGS.has(name) || selfClosing)
+            return;
+        this.stack.push(name);
+        if (RAW_TEXT_TAGS.has(name))
+            this.insideRawText = name;
+    }
+    handleClose(name, raw) {
+        const idx = this.stack.lastIndexOf(name);
+        if (idx === -1)
+            return; // orphan close — ignore
+        // Close any unclosed descendants opened after the matched element.
+        while (this.stack.length > idx + 1) {
+            const node = this.stack.pop();
+            this.committed += `</${node}>`;
+        }
+        this.stack.pop();
+        this.committed += raw;
+        if (name === "html")
+            this.htmlClosed = true;
+    }
+    autoCloseImplicit(newTag) {
+        // A chain may close several elements (e.g. <td>…<tr> closes td then tr).
+        for (;;) {
+            const top = this.stack[this.stack.length - 1];
+            if (!top)
+                return;
+            const rule = IMPLICIT_CLOSE_RULES[top];
+            if (rule && rule.has(newTag)) {
+                this.stack.pop();
+                this.committed += `</${top}>`;
+            }
+            else {
+                return;
+            }
+        }
+    }
+}
+/** Index of the `>` ending the tag opening at `lt`, skipping quoted attrs. */
+function findTagEnd(input, lt) {
+    let quote = null;
+    for (let i = lt + 1; i < input.length; i++) {
+        const c = input[i];
+        if (quote) {
+            if (c === quote)
+                quote = null;
+        }
+        else if (c === '"' || c === "'") {
+            quote = c;
+        }
+        else if (c === ">") {
+            return i;
+        }
+    }
+    return -1;
+}
+/** Lowercase element name from a tag string, or "" if not a real tag. */
+function tagName(tag) {
+    const m = /^<\/?\s*([a-zA-Z][a-zA-Z0-9:-]*)/.exec(tag);
+    return m ? m[1].toLowerCase() : "";
+}
+//# sourceMappingURL=predictiveHtmlParser.js.map

package/dist/stream/predictiveHtmlParser.js.map

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

package/dist/stream/sse.d.ts

@@ -0,0 +1,7 @@
+import type { ArtifactStreamEvent } from "../types/stream.js";
+/**
+ * Consume a `fetch` Response body as a stream of protocol events. Yields each
+ * decoded {@link ArtifactStreamEvent} as it arrives.
+ */
+export declare function readArtifactStream(response: Response, signal?: AbortSignal): AsyncGenerator<ArtifactStreamEvent, void, unknown>;
+//# sourceMappingURL=sse.d.ts.map

package/dist/stream/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/stream/sse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;GAGG;AACH,wBAAuB,kBAAkB,CACvC,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,cAAc,CAAC,mBAAmB,EAAE,IAAI,EAAE,OAAO,CAAC,CAyBpD"}

package/dist/stream/sse.js

@@ -0,0 +1,33 @@
+import { SseDecoder } from "./decoder.js";
+/**
+ * Consume a `fetch` Response body as a stream of protocol events. Yields each
+ * decoded {@link ArtifactStreamEvent} as it arrives.
+ */
+export async function* readArtifactStream(response, signal) {
+    if (!response.body) {
+        throw new Error("Response has no readable body");
+    }
+    const reader = response.body.getReader();
+    const textDecoder = new TextDecoder();
+    const sseDecoder = new SseDecoder();
+    try {
+        while (true) {
+            if (signal?.aborted)
+                break;
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            const text = textDecoder.decode(value, { stream: true });
+            for (const event of sseDecoder.push(text)) {
+                yield event;
+            }
+        }
+        for (const event of sseDecoder.flush()) {
+            yield event;
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/stream/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/stream/sse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,kBAAkB,CACvC,QAAkB,EAClB,MAAoB;IAEpB,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;IAEpC,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,MAAM,EAAE,OAAO;gBAAE,MAAM;YAC3B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACzD,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1C,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;YACvC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/types/artifact.d.ts

@@ -0,0 +1,88 @@
+import type { ArtifactKind } from "./stream.js";
+/** Lifecycle state of a single artifact on the client. */
+export type ArtifactStatus = "idle" | "streaming" | "complete" | "error";
+/**
+ * A client-side, reconstructed view of an HTML artifact. `html` is the raw
+ * aggregated stream output; `snapshot` is the last sanitized, render-safe
+ * version actually shown in the iframe.
+ */
+export interface HtmlArtifact {
+    id: string;
+    title: string;
+    type: ArtifactKind;
+    /** Latest aggregated raw HTML received from the stream. */
+    html: string;
+    /** Last valid sanitized snapshot suitable for rendering. */
+    snapshot: string;
+    status: ArtifactStatus;
+    createdAt: number;
+    updatedAt: number;
+}
+export type ArtifactAesthetic = "minimal" | "glass" | "luxury" | "startup" | "developer" | "playful" | "enterprise" | "dark" | "editorial";
+export type ArtifactMood = "calm" | "premium" | "bold" | "friendly" | "technical" | "energetic";
+export type ArtifactDensity = "compact" | "comfortable" | "spacious";
+export type ArtifactRadius = "sm" | "md" | "xl" | "2xl" | "3xl";
+export type ArtifactFont = "system" | "serif" | "mono" | "rounded";
+export type ArtifactColorScheme = "auto" | "light" | "dark";
+export type ArtifactVisualComplexity = "simple" | "balanced" | "rich";
+/**
+ * Server-side generation hints. These are injected into the HTML generation
+ * prompt so the model produces CSS that matches the requested look and feel.
+ */
+export interface ArtifactStyleProfile {
+    aesthetic?: ArtifactAesthetic;
+    mood?: ArtifactMood;
+    density?: ArtifactDensity;
+    radius?: ArtifactRadius;
+    font?: ArtifactFont;
+    colorScheme?: ArtifactColorScheme;
+    visualComplexity?: ArtifactVisualComplexity;
+}
+/**
+ * How an artifact is presented in the host UI.
+ * - `card`: a framed, windowed iframe with a toolbar (the default).
+ * - `seamless`: a chromeless, transparent iframe that sits inline in the chat
+ *   as if it were native content — no border, no window, no background. Use this
+ *   when the host wants artifacts to blend into a consistent UI ("camouflage").
+ */
+export type ArtifactPresentation = "card" | "seamless";
+/**
+ * The host application's theme. Passed to the server it is injected into the
+ * generation prompt so the model produces artifacts that match the site exactly
+ * (instead of inventing an unrelated palette). Passed to the client it is
+ * injected into the iframe as CSS custom properties + sensible base styles, so
+ * artifacts inherit the host's colours and type — essential for seamless mode.
+ */
+export interface ArtifactTheme {
+    /** `dark` or `light` — anchors the model's contrast decisions. */
+    colorScheme?: "light" | "dark";
+    /** Page background. In seamless mode the iframe stays transparent regardless. */
+    background?: string;
+    /** Primary text colour. */
+    foreground?: string;
+    /** Brand / primary accent colour. */
+    primary?: string;
+    /** Secondary accent colour. */
+    accent?: string;
+    /** Muted/secondary text colour. */
+    muted?: string;
+    /** Hairline / border colour. */
+    border?: string;
+    /** Surface/card colour for raised elements. */
+    surface?: string;
+    /** Base corner radius, e.g. "16px". */
+    radius?: string;
+    /** Font family stack to match the host. */
+    fontFamily?: string;
+    /** Freeform extra brand guidance for the model (tone, do/don't). */
+    notes?: string;
+}
+/** Result of parsing a model envelope into an assistant message + artifact. */
+export interface ParsedArtifactEnvelope {
+    assistantMessage: string;
+    title: string;
+    html: string;
+    /** True when a well-formed `<html_artifact>` block was found. */
+    hasArtifact: boolean;
+}
+//# sourceMappingURL=artifact.d.ts.map

package/dist/types/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../src/types/artifact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,0DAA0D;AAC1D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,YAAY,CAAC;IACnB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,OAAO,GACP,QAAQ,GACR,SAAS,GACT,WAAW,GACX,SAAS,GACT,YAAY,GACZ,MAAM,GACN,WAAW,CAAC;AAEhB,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,SAAS,GACT,MAAM,GACN,UAAU,GACV,WAAW,GACX,WAAW,CAAC;AAEhB,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;AACrE,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AACnE,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAC5D,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC/B,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,+EAA+E;AAC/E,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,WAAW,EAAE,OAAO,CAAC;CACtB"}

package/dist/types/artifact.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=artifact.js.map

package/dist/types/artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../../src/types/artifact.ts"],"names":[],"mappings":""}

package/dist/types/client.d.ts

@@ -0,0 +1,98 @@
+import type { HtmlArtifact, ArtifactPresentation, ArtifactTheme } from "./artifact.js";
+import type { ArtifactMode } from "./stream.js";
+export type ChatRole = "user" | "assistant" | "system";
+/** A single chat message tracked by the client hook. */
+export interface ChatMessage {
+    id: string;
+    role: ChatRole;
+    content: string;
+    /** Present on assistant messages once the mode is known. */
+    mode?: ArtifactMode;
+    /** Links an assistant message to the artifact it produced. */
+    artifactId?: string;
+}
+/** Overall status of the streaming connection. */
+export type ArtifactStreamStatus = "idle" | "submitted" | "streaming" | "done" | "error";
+export interface UseArtifactStreamOptions {
+    /** SSE endpoint that returns the `ArtifactStreamEvent` protocol. */
+    endpoint: string;
+    /** Extra fields merged into the POST body alongside `messages`. */
+    body?: Record<string, unknown>;
+    /** Extra request headers. */
+    headers?: Record<string, string>;
+    /** Initial messages to seed the conversation. */
+    initialMessages?: ChatMessage[];
+    /** Called whenever a fatal error event or transport error occurs. */
+    onError?: (error: Error) => void;
+}
+export interface UseArtifactStreamReturn {
+    messages: ChatMessage[];
+    artifacts: Record<string, HtmlArtifact>;
+    status: ArtifactStreamStatus;
+    mode: ArtifactMode | null;
+    error: Error | null;
+    /** Append a user message and start streaming the assistant response. */
+    sendMessage: (text: string) => Promise<void>;
+    /** Abort any in-flight stream and clear all state. */
+    reset: () => void;
+    /** Abort the in-flight stream without clearing history. */
+    stop: () => void;
+}
+export type CardVariant = "plain" | "glass" | "elevated" | "minimal";
+export type CardDensity = "compact" | "comfortable" | "spacious";
+export type CardRadius = "md" | "xl" | "2xl" | "3xl";
+export type CardShadow = "none" | "soft" | "medium";
+export type ArtifactTab = "preview" | "code";
+export type PreviewFallbackMode = "last-valid-snapshot" | "static-error" | "raw-html";
+/** Per-iframe rendering options for {@link HtmlArtifactPreview}. */
+export interface HtmlArtifactPreviewOptions {
+    /** Explicit sandbox attribute. Overrides the allow* flags if provided. */
+    sandbox?: string;
+    allowForms?: boolean;
+    /** Scripts are never enabled. */
+    allowScripts?: false;
+    allowInlineStyles?: boolean;
+    allowStyleTags?: boolean;
+    allowSvg?: boolean;
+    allowExternalFonts?: boolean;
+    /** Run the sanitizer before writing srcDoc. Default true. */
+    sanitize?: boolean;
+    /** Remove iframe chrome so it blends into the card. Default true. */
+    seamless?: boolean;
+    minHeight?: number;
+    maxHeight?: number;
+    /** Auto-size the iframe to its content height. Default true. */
+    autoResize?: boolean;
+    /**
+     * Minimum interval (ms) between streamed repaints — a throttle, not a
+     * trailing debounce, so a continuous stream still renders steadily. Paints
+     * are also aligned to an animation frame. `0` means "every frame" (~60fps).
+     * Default 32 (~30fps).
+     */
+    debounceMs?: number;
+    fallbackMode?: PreviewFallbackMode;
+}
+export interface HtmlArtifactCardProps {
+    artifact: HtmlArtifact;
+    variant?: CardVariant;
+    density?: CardDensity;
+    radius?: CardRadius;
+    shadow?: CardShadow;
+    showToolbar?: boolean;
+    defaultTab?: ArtifactTab;
+    allowFullscreen?: boolean;
+    allowCopy?: boolean;
+    allowDownload?: boolean;
+    /** Show the "Download PDF" action (native print-to-PDF). Default true. */
+    allowPdf?: boolean;
+    /**
+     * `card` (default) renders a framed, windowed iframe with a toolbar.
+     * `seamless` renders a chromeless, transparent iframe inline ("camouflage").
+     */
+    presentation?: ArtifactPresentation;
+    /** Host theme injected into the iframe so the artifact matches the site. */
+    theme?: ArtifactTheme;
+    previewOptions?: HtmlArtifactPreviewOptions;
+    className?: string;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/types/client.d.ts.map

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

package/dist/types/client.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.js.map

package/dist/types/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/types/client.ts"],"names":[],"mappings":""}

package/dist/types/config.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Options that govern what the sanitizer is allowed to keep. Defaults are
+ * static-only and script-free: see `constants/defaults`.
+ */
+export interface SanitizeOptions {
+    /** Keep `<form>`, `<input>`, `<button>`, `<label>`, `<textarea>`, `<select>`. */
+    allowForms?: boolean;
+    /** Always coerced to `false`. Scripts are never permitted. */
+    allowScripts?: false;
+    /** Keep inline `style="..."` attributes. */
+    allowInlineStyles?: boolean;
+    /** Keep `<style>` tags. */
+    allowStyleTags?: boolean;
+    /** Keep inline `<svg>`. */
+    allowSvg?: boolean;
+    /** Permit `@import`/external font + stylesheet links. Off by default. */
+    allowExternalFonts?: boolean;
+}
+/** Mode resolution strategy for the server helper. */
+export type ArtifactModeOption = "auto" | "markdown" | "artifact" | "generative_ui"
+/** @deprecated Use `artifact` or `generative_ui`. */
+ | "html_artifact";
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,2BAA2B;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,sDAAsD;AACtD,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,UAAU,GACV,UAAU,GACV,eAAe;AACjB,qDAAqD;GACnD,eAAe,CAAC"}

package/dist/types/config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":""}

package/dist/types/errors.d.ts

@@ -0,0 +1,9 @@
+/** Discriminator codes for the package's typed errors. */
+export type ArtifactErrorCode = "ARTIFACT_PARSE_ERROR" | "STREAM_ERROR" | "CLASSIFICATION_ERROR";
+export interface SerializedArtifactError {
+    name: string;
+    code: ArtifactErrorCode;
+    message: string;
+    recoverable: boolean;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,MAAM,MAAM,iBAAiB,GACzB,sBAAsB,GACtB,cAAc,GACd,sBAAsB,CAAC;AAE3B,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB"}

package/dist/types/errors.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+export type * from "./stream.js";
+export type * from "./artifact.js";
+export type * from "./config.js";
+export type * from "./server.js";
+export type * from "./client.js";
+export type * from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,aAAa,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}