@hanzo/ui 8.27.3 → 8.27.4

package/dist/chat/Parts.js

@@ -0,0 +1,153 @@
+'use client';
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Parts — a streamed turn, drawn by what each piece of it IS.
+ *
+ * A completion's content is a list of parts, and until now this package had one
+ * answer for all of them: `words` flattens the list to prose and DROPS every
+ * part that is not text. An image, a tool call, a citation, an artifact — all of
+ * it arrived on the wire and none of it reached the screen. Six surfaces wrote
+ * six switch statements over the same union to get it back.
+ *
+ * `MessagePart` is that union, closed, and `Parts` is the dispatcher over it.
+ * Closed is the decision: `words`'s `Part` stays OPEN because it reads the wire
+ * and must survive a type it has never heard of, while this one is the CANON —
+ * the set a surface can exhaustively handle, and the set this package promises
+ * to draw. A part whose `type` is outside it still contributes its text, exactly
+ * as `words` does, so an unknown part degrades to prose instead of vanishing.
+ *
+ * Nothing here is new furniture. Every branch dispatches to a piece this package
+ * already had: `Code` for a tool's arguments and its output, `Step` for the call
+ * itself, `Failure` for an error, `Sources` for citations, `ArtifactCard` for a
+ * produced thing. That is the whole reason a typed renderer belongs here rather
+ * than in each surface — the parts were already drawn, one per surface, with no
+ * agreement about which part got which drawing.
+ *
+ * MARKDOWN IS STILL NOT HERE. `prose` is where a surface's pipeline enters, and
+ * with none supplied the words render plainly. The plugin set is per-surface —
+ * nine plugins, one plugin, or a regex under a bundle ceiling that cannot afford
+ * a parser — so this package ships no parser and takes the rendered nodes.
+ */
+import { Image, SizableText, XStack, YStack } from '@hanzo/gui';
+import { Paperclip } from '@hanzogui/lucide-icons-2';
+import { ArtifactCard } from '../agents/Pane.js';
+import { ink } from '../backends/gui/ink.js';
+import { slot } from '../backends/gui/slot.js';
+import { Code } from './Code.js';
+import { Failure } from './Failure.js';
+import { Preview } from './Preview.js';
+import { Sources } from './Sources.js';
+import { Step } from './Step.js';
+/**
+ * Adjacent prose, put back together.
+ *
+ * The wire splits a sentence across parts — and mid-word, which is why `words`
+ * joins with no separator — so drawing each text part as its own block would
+ * break one paragraph into a dozen and hand a markdown parser fragments that are
+ * not markdown. Runs of `text` and runs of `reasoning` each collapse to one;
+ * everything else passes through untouched and in order.
+ *
+ * This is what makes `Parts` a strict improvement on `words` rather than a
+ * different-looking one: an all-text turn renders exactly the string `words`
+ * would have produced.
+ */
+export function join(parts) {
+    const out = [];
+    for (const part of parts) {
+        const last = out[out.length - 1];
+        if ((part.type === 'text' || part.type === 'reasoning') &&
+            last &&
+            last.type === part.type) {
+            out[out.length - 1] = { type: part.type, text: last.text + part.text };
+            continue;
+        }
+        out.push(part);
+    }
+    return out;
+}
+/**
+ * What a tool was asked, or answered, as text.
+ *
+ * The wire sends JSON, so a caller holding the parsed object should not have to
+ * re-serialise it at every call site — that is six copies of two lines. The
+ * fallback exists because this takes `unknown` and a value that cannot be
+ * serialised must not take the page down with it.
+ */
+export const show = (value) => {
+    if (value == null)
+        return '';
+    if (typeof value === 'string')
+        return value;
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return String(value);
+    }
+};
+/** A size a person can read. Every surface writes this one; here it is once. */
+const weigh = (bytes) => {
+    const units = ['B', 'KB', 'MB', 'GB'];
+    let n = bytes;
+    let i = 0;
+    while (n >= 1024 && i < units.length - 1) {
+        n /= 1024;
+        i += 1;
+    }
+    return `${i === 0 ? n : n.toFixed(1)} ${units[i]}`;
+};
+/**
+ * One part.
+ *
+ * It spreads no residual props and owns no box, which is the one place this
+ * package's house rule does not apply: a piece IS whichever component its type
+ * names, and giving it a wrapper of its own would put an anonymous div between
+ * every part and the column that spaces them. `Parts` is the box.
+ *
+ * Named `Piece` and not `Part` because `Part` is already the name of `words`'s
+ * open wire type on this barrel, and a module cannot export one name as both a
+ * type and a value.
+ */
+export function Piece({ part, prose, onRetry, onOpen, onSource }) {
+    switch (part.type) {
+        case 'text':
+            return _jsx(_Fragment, { children: prose ? prose(part.text, part) : ink(part.text) });
+        case 'reasoning':
+            // Dimmed rather than recoloured: a surface's markdown paints its own
+            // colours, and a token on the container would not reach inside them.
+            return (_jsx(YStack, { ...slot('reasoning'), opacity: 0.72, children: prose ? prose(part.text, part) : ink(part.text) }));
+        case 'toolCall':
+            return (_jsx(Step, { name: part.name, status: "running", detail: part.id, children: part.args == null ? undefined : _jsx(Code, { language: "json", children: show(part.args) }) }));
+        case 'toolResult':
+            return (_jsx(Step, { name: part.name, status: part.status ?? 'done', detail: part.id, children: part.result == null ? undefined : _jsx(Code, { language: "json", children: show(part.result) }) }));
+        case 'image':
+            return (_jsx(YStack, { ...slot('image'), maxW: 420, rounded: "$4", overflow: "hidden", borderWidth: 1, borderColor: "$borderColor", children: _jsx(Image, { src: part.url, alt: part.alt ?? '', style: { width: '100%', height: 'auto', display: 'block' } }) }));
+        case 'file':
+            return (_jsxs(XStack, { ...slot('file'), items: "center", gap: "$2", maxW: 420, px: "$2.5", py: "$2", rounded: "$4", borderWidth: 1, borderColor: "$borderColor", bg: "$panel", children: [_jsx(Paperclip, { size: 13, color: "$quiet" }), _jsx(SizableText, { size: "$2", color: "$ink", numberOfLines: 1, flex: 1, children: part.name }), part.size == null ? null : (_jsx(SizableText, { size: "$1", color: "$quiet", children: weigh(part.size) }))] }));
+        case 'citation':
+            return _jsx(Sources, { sources: part.sources, onOpen: onSource });
+        case 'artifact':
+            // Held, so shown. `Preview` renders it with scripting disabled, which is
+            // what makes drawing model-authored markup a different question from
+            // loading a `uiResource`'s url — see that arm, and `Preview`'s own note.
+            return part.markup ? (_jsx(Preview, { title: part.title, markup: part.markup })) : (_jsx(ArtifactCard, { title: part.title, kind: part.kind, onOpen: onOpen ? () => onOpen(part) : undefined }));
+        case 'uiResource':
+            return (_jsx(Step, { name: part.uri, detail: part.mime, children: part.text ? _jsx(Code, { language: part.mime ?? 'text', children: part.text }) : undefined }));
+        case 'error':
+            return _jsx(Failure, { onRetry: onRetry, children: part.text });
+        default: {
+            // The union is closed and the WIRE is not, which is the one place those
+            // two facts have to meet. A part this does not know contributes its text
+            // and nothing else — the same answer `words` gives, so nothing a surface
+            // sends can go missing without also having been missing before.
+            const unknown = part;
+            return _jsx(_Fragment, { children: unknown.text ? ink(unknown.text) : null });
+        }
+    }
+}
+/** A turn's parts, in order, spaced. Goes in a `Message`'s children — `Chat`
+ *  puts it there for a turn whose content is a list. */
+export function Parts({ parts, prose, onRetry, onOpen, onSource, ...props }) {
+    return (_jsx(YStack, { ...slot('parts'), width: "100%", gap: "$2", ...props, children: join(parts).map((part, i) => (_jsx(Piece, { part: part, prose: prose, onRetry: onRetry, onOpen: onOpen, onSource: onSource }, `${part.type}-${i}`))) }));
+}
+//# sourceMappingURL=Parts.js.map

package/dist/chat/Parts.js.map

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

package/dist/chat/Persona.cjs

@@ -0,0 +1,34 @@
+'use client';"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clip = void 0;
+exports.Persona = Persona;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * Persona — a face on the canvas, and what it is doing.
+ *
+ * A persona is not a new engine. It is a MAPPING: an emotion names a clip, the
+ * clip goes to `Backdrop`'s `clips` mode, and that mode's preloaded crossfade
+ * does the switching it already does — one live frame over another, never a
+ * flash of black. So a mood change is a prop change, and there is exactly one
+ * piece of machinery playing video in this package rather than two.
+ *
+ * The mapping is the whole component, and it is deliberately thin. What an
+ * emotion MEANS — when a persona is listening, when it is thinking — belongs to
+ * whatever is driving the conversation; a component that guessed would be
+ * guessing from the one place with the least information.
+ *
+ * `idle` is required and every other emotion is optional, so a persona with one
+ * clip is a legal persona and adding a mood is adding a file. `clip` is pure and
+ * exported, which is what lets a surface preload the next mood, or test the
+ * mapping, without mounting anything.
+ */
+const Backdrop_1 = require("../backdrop/Backdrop.cjs");
+/** The clip for this emotion, falling back to idle. */
+const clip = (scenes, emotion) => scenes[emotion] ?? scenes.idle;
+exports.clip = clip;
+function Persona({ scenes, emotion = 'idle', ...props }) {
+    // One clip, so it loops itself rather than ending and handing over — a mood
+    // holds until something changes it, which is what a mood is.
+    return (0, jsx_runtime_1.jsx)(Backdrop_1.Backdrop, { ...props, mode: "clips", clips: [(0, exports.clip)(scenes, emotion)] });
+}

package/dist/chat/Persona.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Persona — a face on the canvas, and what it is doing.
+ *
+ * A persona is not a new engine. It is a MAPPING: an emotion names a clip, the
+ * clip goes to `Backdrop`'s `clips` mode, and that mode's preloaded crossfade
+ * does the switching it already does — one live frame over another, never a
+ * flash of black. So a mood change is a prop change, and there is exactly one
+ * piece of machinery playing video in this package rather than two.
+ *
+ * The mapping is the whole component, and it is deliberately thin. What an
+ * emotion MEANS — when a persona is listening, when it is thinking — belongs to
+ * whatever is driving the conversation; a component that guessed would be
+ * guessing from the one place with the least information.
+ *
+ * `idle` is required and every other emotion is optional, so a persona with one
+ * clip is a legal persona and adding a mood is adding a file. `clip` is pure and
+ * exported, which is what lets a surface preload the next mood, or test the
+ * mapping, without mounting anything.
+ */
+import { type BackdropProps } from '../backdrop/Backdrop.js';
+/** What a persona is doing. The set a conversation can actually report. */
+export type Emotion = 'idle' | 'listening' | 'thinking' | 'speaking' | 'happy' | 'sad' | 'surprised';
+/** Which clip plays for each emotion. `idle` is required: it is what plays when
+ *  a persona has nothing for the emotion at hand, so there is always something
+ *  on the canvas and never a gap to design around. */
+export type Scenes = {
+    idle: string;
+} & Partial<Record<Emotion, string>>;
+/** The clip for this emotion, falling back to idle. */
+export declare const clip: (scenes: Scenes, emotion: Emotion) => string;
+export interface PersonaProps extends Omit<BackdropProps, 'mode' | 'clips'> {
+    scenes: Scenes;
+    /** What the persona is doing right now. Defaults to idle. */
+    emotion?: Emotion;
+}
+export declare function Persona({ scenes, emotion, ...props }: PersonaProps): import("react").JSX.Element;
+//# sourceMappingURL=Persona.d.ts.map

package/dist/chat/Persona.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Persona.d.ts","sourceRoot":"","sources":["../../src/chat/Persona.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEnE,2EAA2E;AAC3E,MAAM,MAAM,OAAO,GACf,MAAM,GACN,WAAW,GACX,UAAU,GACV,UAAU,GACV,OAAO,GACP,KAAK,GACL,WAAW,CAAA;AAEf;;sDAEsD;AACtD,MAAM,MAAM,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;AAExE,uDAAuD;AACvD,eAAO,MAAM,IAAI,WAAY,MAAM,WAAW,OAAO,KAAG,MAAwC,CAAA;AAEhG,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IACzE,MAAM,EAAE,MAAM,CAAA;IACd,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,OAAO,CAAC,EAAE,MAAM,EAAE,OAAgB,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,+BAI3E"}

package/dist/chat/Persona.js

@@ -0,0 +1,30 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Persona — a face on the canvas, and what it is doing.
+ *
+ * A persona is not a new engine. It is a MAPPING: an emotion names a clip, the
+ * clip goes to `Backdrop`'s `clips` mode, and that mode's preloaded crossfade
+ * does the switching it already does — one live frame over another, never a
+ * flash of black. So a mood change is a prop change, and there is exactly one
+ * piece of machinery playing video in this package rather than two.
+ *
+ * The mapping is the whole component, and it is deliberately thin. What an
+ * emotion MEANS — when a persona is listening, when it is thinking — belongs to
+ * whatever is driving the conversation; a component that guessed would be
+ * guessing from the one place with the least information.
+ *
+ * `idle` is required and every other emotion is optional, so a persona with one
+ * clip is a legal persona and adding a mood is adding a file. `clip` is pure and
+ * exported, which is what lets a surface preload the next mood, or test the
+ * mapping, without mounting anything.
+ */
+import { Backdrop } from '../backdrop/Backdrop.js';
+/** The clip for this emotion, falling back to idle. */
+export const clip = (scenes, emotion) => scenes[emotion] ?? scenes.idle;
+export function Persona({ scenes, emotion = 'idle', ...props }) {
+    // One clip, so it loops itself rather than ending and handing over — a mood
+    // holds until something changes it, which is what a mood is.
+    return _jsx(Backdrop, { ...props, mode: "clips", clips: [clip(scenes, emotion)] });
+}
+//# sourceMappingURL=Persona.js.map

package/dist/chat/Persona.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Persona.js","sourceRoot":"","sources":["../../src/chat/Persona.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,QAAQ,EAAsB,MAAM,sBAAsB,CAAA;AAiBnE,uDAAuD;AACvD,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,MAAc,EAAE,OAAgB,EAAU,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,CAAA;AAQhG,MAAM,UAAU,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,KAAK,EAAgB;IAC1E,4EAA4E;IAC5E,6DAA6D;IAC7D,OAAO,KAAC,QAAQ,OAAK,KAAK,EAAE,IAAI,EAAC,OAAO,EAAC,KAAK,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAI,CAAA;AAC7E,CAAC"}

package/dist/chat/Preview.cjs

@@ -0,0 +1,42 @@
+'use client';"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Preview = Preview;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * Preview — an interface the model wrote, shown but not run.
+ *
+ * Generative UI arrives as markup, and markup from a model is untrusted input
+ * that happens to be a document. Rendering it into the host page is
+ * cross-site scripting with extra steps; refusing to render it at all leaves
+ * the feature as a paragraph of HTML source. Neither is the answer.
+ *
+ * The answer is `sandbox=""`. An empty allow-list is the STRICTEST setting the
+ * attribute has, not a lax one: no scripts, no same-origin, no forms, no
+ * navigation, no popups, no pointer lock. The document lays out and paints —
+ * real CSS, real fonts, real layout, a real screenshot — and can do nothing
+ * else. That is exactly the shape of a mockup, so nothing is lost by taking
+ * away the half that is dangerous.
+ *
+ * This is why `Parts` can draw an `artifact` and still refuses a `uiResource`.
+ * They are not the same risk: a `uiResource` is a URL, and loading one pulls a
+ * third-party origin into the page over the network. Inline markup with
+ * scripting off reaches nothing and runs nothing.
+ *
+ * Web only, like `Backdrop` — it is an `<iframe>`, and there is no such thing
+ * off the web. A surface that runs on native sends artifacts with no `markup`
+ * and gets `ArtifactCard`, which is where that decision already lived.
+ */
+const gui_1 = require("@hanzo/gui");
+const slot_1 = require("../backends/gui/slot.cjs");
+function Preview({ markup, title, height = 320, ...props }) {
+    const named = title ?? 'Preview';
+    return ((0, jsx_runtime_1.jsxs)(gui_1.YStack, { ...(0, slot_1.slot)('preview'), width: "100%", maxW: 720, rounded: "$4", overflow: "hidden", borderWidth: 1, borderColor: "$borderColor", bg: "$panel", ...props, children: [title ? ((0, jsx_runtime_1.jsx)(gui_1.XStack, { items: "center", gap: "$2", px: "$3", py: "$2", borderBottomWidth: 1, borderColor: "$borderColor", children: (0, jsx_runtime_1.jsx)(gui_1.SizableText, { size: "$1", color: "$soft", numberOfLines: 1, children: title }) })) : null, (0, jsx_runtime_1.jsx)("iframe", { title: named, srcDoc: markup, sandbox: "", referrerPolicy: "no-referrer", style: {
+                    display: 'block',
+                    width: '100%',
+                    height,
+                    border: 0,
+                    background: '#fff',
+                    colorScheme: 'light',
+                } })] }));
+}

package/dist/chat/Preview.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Preview — an interface the model wrote, shown but not run.
+ *
+ * Generative UI arrives as markup, and markup from a model is untrusted input
+ * that happens to be a document. Rendering it into the host page is
+ * cross-site scripting with extra steps; refusing to render it at all leaves
+ * the feature as a paragraph of HTML source. Neither is the answer.
+ *
+ * The answer is `sandbox=""`. An empty allow-list is the STRICTEST setting the
+ * attribute has, not a lax one: no scripts, no same-origin, no forms, no
+ * navigation, no popups, no pointer lock. The document lays out and paints —
+ * real CSS, real fonts, real layout, a real screenshot — and can do nothing
+ * else. That is exactly the shape of a mockup, so nothing is lost by taking
+ * away the half that is dangerous.
+ *
+ * This is why `Parts` can draw an `artifact` and still refuses a `uiResource`.
+ * They are not the same risk: a `uiResource` is a URL, and loading one pulls a
+ * third-party origin into the page over the network. Inline markup with
+ * scripting off reaches nothing and runs nothing.
+ *
+ * Web only, like `Backdrop` — it is an `<iframe>`, and there is no such thing
+ * off the web. A surface that runs on native sends artifacts with no `markup`
+ * and gets `ArtifactCard`, which is where that decision already lived.
+ */
+import { YStack } from '@hanzo/gui';
+import type { ComponentProps } from 'react';
+export interface PreviewProps extends Omit<ComponentProps<typeof YStack>, 'children'> {
+    /** A self-contained HTML document. Script in it will not run. */
+    markup: string;
+    /** Named in the frame's header. Also the frame's accessible name. */
+    title?: string;
+    /** Viewport height, px. The document scrolls inside it. */
+    height?: number;
+}
+export declare function Preview({ markup, title, height, ...props }: PreviewProps): import("react").JSX.Element;
+//# sourceMappingURL=Preview.d.ts.map

package/dist/chat/Preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Preview.d.ts","sourceRoot":"","sources":["../../src/chat/Preview.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAuB,MAAM,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAI3C,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,EAAE,UAAU,CAAC;IACnF,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAA;IACd,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAY,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,+BAiD9E"}

package/dist/chat/Preview.js

@@ -0,0 +1,40 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Preview — an interface the model wrote, shown but not run.
+ *
+ * Generative UI arrives as markup, and markup from a model is untrusted input
+ * that happens to be a document. Rendering it into the host page is
+ * cross-site scripting with extra steps; refusing to render it at all leaves
+ * the feature as a paragraph of HTML source. Neither is the answer.
+ *
+ * The answer is `sandbox=""`. An empty allow-list is the STRICTEST setting the
+ * attribute has, not a lax one: no scripts, no same-origin, no forms, no
+ * navigation, no popups, no pointer lock. The document lays out and paints —
+ * real CSS, real fonts, real layout, a real screenshot — and can do nothing
+ * else. That is exactly the shape of a mockup, so nothing is lost by taking
+ * away the half that is dangerous.
+ *
+ * This is why `Parts` can draw an `artifact` and still refuses a `uiResource`.
+ * They are not the same risk: a `uiResource` is a URL, and loading one pulls a
+ * third-party origin into the page over the network. Inline markup with
+ * scripting off reaches nothing and runs nothing.
+ *
+ * Web only, like `Backdrop` — it is an `<iframe>`, and there is no such thing
+ * off the web. A surface that runs on native sends artifacts with no `markup`
+ * and gets `ArtifactCard`, which is where that decision already lived.
+ */
+import { SizableText, XStack, YStack } from '@hanzo/gui';
+import { slot } from '../backends/gui/slot.js';
+export function Preview({ markup, title, height = 320, ...props }) {
+    const named = title ?? 'Preview';
+    return (_jsxs(YStack, { ...slot('preview'), width: "100%", maxW: 720, rounded: "$4", overflow: "hidden", borderWidth: 1, borderColor: "$borderColor", bg: "$panel", ...props, children: [title ? (_jsx(XStack, { items: "center", gap: "$2", px: "$3", py: "$2", borderBottomWidth: 1, borderColor: "$borderColor", children: _jsx(SizableText, { size: "$1", color: "$soft", numberOfLines: 1, children: title }) })) : null, _jsx("iframe", { title: named, srcDoc: markup, sandbox: "", referrerPolicy: "no-referrer", style: {
+                    display: 'block',
+                    width: '100%',
+                    height,
+                    border: 0,
+                    background: '#fff',
+                    colorScheme: 'light',
+                } })] }));
+}
+//# sourceMappingURL=Preview.js.map

package/dist/chat/Preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Preview.js","sourceRoot":"","sources":["../../src/chat/Preview.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAGxD,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAW3C,MAAM,UAAU,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,GAAG,KAAK,EAAgB;IAC7E,MAAM,KAAK,GAAG,KAAK,IAAI,SAAS,CAAA;IAChC,OAAO,CACL,MAAC,MAAM,OACD,IAAI,CAAC,SAAS,CAAC,EACnB,KAAK,EAAC,MAAM,EACZ,IAAI,EAAE,GAAG,EACT,OAAO,EAAC,IAAI,EACZ,QAAQ,EAAC,QAAQ,EACjB,WAAW,EAAE,CAAC,EACd,WAAW,EAAC,cAAc,EAC1B,EAAE,EAAC,QAAQ,KACP,KAAK,aAER,KAAK,CAAC,CAAC,CAAC,CACP,KAAC,MAAM,IACL,KAAK,EAAC,QAAQ,EACd,GAAG,EAAC,IAAI,EACR,EAAE,EAAC,IAAI,EACP,EAAE,EAAC,IAAI,EACP,iBAAiB,EAAE,CAAC,EACpB,WAAW,EAAC,cAAc,YAE1B,KAAC,WAAW,IAAC,IAAI,EAAC,IAAI,EAAC,KAAK,EAAC,OAAO,EAAC,aAAa,EAAE,CAAC,YAClD,KAAK,GACM,GACP,CACV,CAAC,CAAC,CAAC,IAAI,EAMR,iBACE,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAC,EAAE,EACV,cAAc,EAAC,aAAa,EAC5B,KAAK,EAAE;oBACL,OAAO,EAAE,OAAO;oBAChB,KAAK,EAAE,MAAM;oBACb,MAAM;oBACN,MAAM,EAAE,CAAC;oBACT,UAAU,EAAE,MAAM;oBAClB,WAAW,EAAE,OAAO;iBACrB,GACD,IACK,CACV,CAAA;AACH,CAAC"}