@xemahq/ui-kernel 0.9.0 → 0.9.1

package/dist/vista/SurfaceFallbackCard.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { AlertTriangle, ChevronDown, ChevronRight } from 'lucide-react';
+import { useState } from 'react';
+import { ContributionFallbackReason } from '../lib/contribution-registry';
+const REASON_LABEL = {
+    [ContributionFallbackReason.UnknownKind]: "This view isn't available in your client.",
+    [ContributionFallbackReason.InvalidPayload]: "This view couldn't be displayed (its data didn't match the expected shape).",
+    [ContributionFallbackReason.UnsupportedVersion]: 'This view needs a newer client — refresh to see it.',
+};
+export function SurfaceFallbackCard({ kind, reason, payload, title, }) {
+    const [open, setOpen] = useState(false);
+    let raw;
+    try {
+        raw = JSON.stringify(payload, null, 2);
+    }
+    catch {
+        raw = String(payload);
+    }
+    return (_jsxs("div", { style: {
+            margin: 9,
+            border: '1px solid hsl(var(--rule))',
+            borderRadius: 9,
+            background: 'hsl(var(--paper-elev))',
+            overflow: 'hidden',
+        }, children: [_jsxs("button", { type: "button", onClick: () => setOpen((v) => !v), style: {
+                    display: 'flex',
+                    alignItems: 'center',
+                    gap: 9,
+                    width: '100%',
+                    padding: '9px 11px',
+                    textAlign: 'left',
+                    cursor: 'pointer',
+                }, children: [_jsx(AlertTriangle, { size: 14, style: { color: 'hsl(var(--warning))', flexShrink: 0 } }), _jsxs("div", { style: { flex: 1, minWidth: 0 }, children: [_jsx("div", { style: { fontSize: 12.5, fontWeight: 600, color: 'hsl(var(--ink-2))' }, children: title ?? 'Unsupported view' }), _jsx("div", { style: { fontSize: 11.5, color: 'hsl(var(--ink-4))', marginTop: 1 }, children: REASON_LABEL[reason] })] }), _jsx("span", { className: "mono", style: { fontSize: 10.5, color: 'hsl(var(--ink-4))', flexShrink: 0 }, children: kind }), open ? _jsx(ChevronDown, { size: 12 }) : _jsx(ChevronRight, { size: 12 })] }), open && (_jsx("pre", { className: "mono", style: {
+                    margin: 0,
+                    padding: '8px 11px',
+                    borderTop: '1px solid hsl(var(--rule))',
+                    fontSize: 11,
+                    lineHeight: 1.55,
+                    color: 'hsl(var(--ink-3))',
+                    whiteSpace: 'pre-wrap',
+                    overflowX: 'auto',
+                }, children: raw }))] }));
+}
+//# sourceMappingURL=SurfaceFallbackCard.js.map

package/dist/vista/SurfaceFallbackCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SurfaceFallbackCard.js","sourceRoot":"","sources":["../../src/vista/SurfaceFallbackCard.tsx"],"names":[],"mappings":";AAWA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAqB,MAAM,OAAO,CAAC;AAEpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE1E,MAAM,YAAY,GAA+C;IAC/D,CAAC,0BAA0B,CAAC,WAAW,CAAC,EACtC,2CAA2C;IAC7C,CAAC,0BAA0B,CAAC,cAAc,CAAC,EACzC,6EAA6E;IAC/E,CAAC,0BAA0B,CAAC,kBAAkB,CAAC,EAC7C,qDAAqD;CACxD,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,EAClC,IAAI,EACJ,MAAM,EACN,OAAO,EACP,KAAK,GAOL;IACA,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,CACL,eACE,KAAK,EAAE;YACL,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,4BAA4B;YACpC,YAAY,EAAE,CAAC;YACf,UAAU,EAAE,wBAAwB;YACpC,QAAQ,EAAE,QAAQ;SACnB,aAED,kBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EACjC,KAAK,EAAE;oBACL,OAAO,EAAE,MAAM;oBACf,UAAU,EAAE,QAAQ;oBACpB,GAAG,EAAE,CAAC;oBACN,KAAK,EAAE,MAAM;oBACb,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,MAAM;oBACjB,MAAM,EAAE,SAAS;iBAClB,aAED,KAAC,aAAa,IACZ,IAAI,EAAE,EAAE,EACR,KAAK,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,CAAC,EAAE,GACtD,EACF,eAAK,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,aAClC,cACE,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,mBAAmB,EAAE,YAErE,KAAK,IAAI,kBAAkB,GACxB,EACN,cAAK,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,CAAC,EAAE,YACrE,YAAY,CAAC,MAAM,CAAC,GACjB,IACF,EACN,eACE,SAAS,EAAC,MAAM,EAChB,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,CAAC,EAAE,YAEnE,IAAI,GACA,EACN,IAAI,CAAC,CAAC,CAAC,KAAC,WAAW,IAAC,IAAI,EAAE,EAAE,GAAI,CAAC,CAAC,CAAC,KAAC,YAAY,IAAC,IAAI,EAAE,EAAE,GAAI,IACvD,EACR,IAAI,IAAI,CACP,cACE,SAAS,EAAC,MAAM,EAChB,KAAK,EAAE;oBACL,MAAM,EAAE,CAAC;oBACT,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,4BAA4B;oBACvC,QAAQ,EAAE,EAAE;oBACZ,UAAU,EAAE,IAAI;oBAChB,KAAK,EAAE,mBAAmB;oBAC1B,UAAU,EAAE,UAAU;oBACtB,SAAS,EAAE,MAAM;iBAClB,YAEA,GAAG,GACA,CACP,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/vista/VistaPanel.d.ts

@@ -0,0 +1,21 @@
+import { type ReactElement, type ReactNode } from 'react';
+import type { VistaTab } from './vista-model';
+export interface VistaPanelProps {
+    readonly tabs: readonly VistaTab[];
+    readonly activeTabId: string | null;
+    readonly onActivate: (tabId: string) => void;
+    readonly onClose?: (tabId: string) => void;
+    readonly tabBarAction?: ReactNode;
+    readonly indicatorTabIds?: readonly string[];
+    readonly emptyState?: ReactNode;
+    readonly className?: string;
+}
+export declare function VistaPanel({ tabs, activeTabId, onActivate, onClose, tabBarAction, indicatorTabIds, emptyState, className, }: VistaPanelProps): ReactElement;
+export type VistaTabBarProps = Omit<VistaPanelProps, 'emptyState' | 'className'> & {
+    readonly className?: string;
+};
+export declare function VistaTabBar({ tabs, activeTabId, onActivate, onClose, tabBarAction, indicatorTabIds, className, }: VistaTabBarProps): ReactElement;
+export declare function VistaSurfaceBody({ tab, }: Readonly<{
+    tab: VistaTab;
+}>): ReactElement;
+//# sourceMappingURL=VistaPanel.d.ts.map

package/dist/vista/VistaPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VistaPanel.d.ts","sourceRoot":"","sources":["../../src/vista/VistaPanel.tsx"],"names":[],"mappings":"AAgBA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAQ1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,eAAe;IAE9B,QAAQ,CAAC,IAAI,EAAE,SAAS,QAAQ,EAAE,CAAC;IAEnC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAK7C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAE3C,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC;IAMlC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE7C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,WAAW,EACX,UAAU,EACV,OAAO,EACP,YAAY,EACZ,eAAe,EACf,UAAU,EACV,SAAS,GACV,EAAE,eAAe,GAAG,YAAY,CA0BhC;AAED,MAAM,MAAM,gBAAgB,GAAG,IAAI,CACjC,eAAe,EACf,YAAY,GAAG,WAAW,CAC3B,GAAG;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AASpC,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,WAAW,EACX,UAAU,EACV,OAAO,EACP,YAAY,EACZ,eAAe,EACf,SAAS,GACV,EAAE,gBAAgB,GAAG,YAAY,CA4BjC;AAMD,wBAAgB,gBAAgB,CAAC,EAC/B,GAAG,GACJ,EAAE,QAAQ,CAAC;IAAE,GAAG,EAAE,QAAQ,CAAA;CAAE,CAAC,GAAG,YAAY,CAW5C"}

package/dist/vista/VistaPanel.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { surfaceKindIcon } from './surface-icons';
+import { vistaSurfaceRegistry } from './surface-registry';
+import { SurfaceFallbackCard } from './SurfaceFallbackCard';
+import { cn } from '../ui/cn';
+import { OverflowTabs } from '../ui/primitives/overflow-tabs';
+export function VistaPanel({ tabs, activeTabId, onActivate, onClose, tabBarAction, indicatorTabIds, emptyState, className, }) {
+    const active = tabs.find((t) => t.tabId === activeTabId) ?? null;
+    return (_jsxs("div", { className: cn('flex h-full min-h-0 min-w-0 flex-1 flex-col overflow-hidden', className), children: [_jsx(VistaTabBar, { tabs: tabs, activeTabId: activeTabId, onActivate: onActivate, ...(onClose ? { onClose } : {}), ...(tabBarAction === undefined ? {} : { tabBarAction }), ...(indicatorTabIds === undefined ? {} : { indicatorTabIds }) }), _jsx("div", { className: "min-h-0 flex-1 overflow-hidden", children: active === null ? (_jsx(_Fragment, { children: emptyState ?? null })) : (_jsx(VistaSurfaceBody, { tab: active })) })] }));
+}
+export function VistaTabBar({ tabs, activeTabId, onActivate, onClose, tabBarAction, indicatorTabIds, className, }) {
+    const overflowTabs = tabs.map((tab) => {
+        const entry = { value: tab.tabId, label: tab.title };
+        if (tab.pinned === true)
+            entry.pinned = true;
+        if (indicatorTabIds?.includes(tab.tabId) === true)
+            entry.indicator = true;
+        const icon = surfaceKindIcon(tab.kind);
+        if (icon !== undefined)
+            entry.icon = icon;
+        return entry;
+    });
+    return (_jsxs("div", { className: cn('flex shrink-0 items-end gap-2 px-2', className), children: [_jsx("div", { className: "min-w-0 flex-1", children: _jsx(OverflowTabs, { tabs: overflowTabs, value: activeTabId ?? '', onChange: onActivate, ...(onClose ? { onClose } : {}) }) }), tabBarAction] }));
+}
+export function VistaSurfaceBody({ tab, }) {
+    const resolution = vistaSurfaceRegistry.resolve(tab);
+    if (resolution.matched)
+        return resolution.rendered;
+    return (_jsx(SurfaceFallbackCard, { kind: resolution.kind, reason: resolution.reason, payload: tab.payload, title: tab.title }));
+}
+//# sourceMappingURL=VistaPanel.js.map

package/dist/vista/VistaPanel.js.map

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

package/dist/vista/html/CustomUiFrame.d.ts

@@ -0,0 +1,20 @@
+import { type ReactElement } from 'react';
+import { type CustomUiComponentProps } from './custom-ui-frame-contract';
+import { type CustomUiIntentSet } from './custom-ui-intents';
+export type CustomUiFrameContent = {
+    readonly compiledOutput: string;
+    readonly integrity: string;
+} | {
+    readonly document: string;
+};
+export interface CustomUiFrameProps<TIntent> {
+    readonly content: CustomUiFrameContent;
+    readonly componentProps?: CustomUiComponentProps;
+    readonly intents: CustomUiIntentSet<TIntent>;
+    readonly styleCss?: string;
+    readonly title: string;
+    readonly className?: string;
+}
+export declare function CustomUiFrame<TIntent>({ content, componentProps, intents, styleCss, title, className, }: CustomUiFrameProps<TIntent>): ReactElement;
+export default CustomUiFrame;
+//# sourceMappingURL=CustomUiFrame.d.ts.map

package/dist/vista/html/CustomUiFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CustomUiFrame.d.ts","sourceRoot":"","sources":["../../../src/vista/html/CustomUiFrame.tsx"],"names":[],"mappings":"AA4BA,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAGhF,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAS7D,MAAM,MAAM,oBAAoB,GAC5B;IAEE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,GACD;IAEE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEN,MAAM,WAAW,kBAAkB,CAAC,OAAO;IAEzC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IAEvC,QAAQ,CAAC,cAAc,CAAC,EAAE,sBAAsB,CAAC;IAEjD,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAM7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAID,wBAAgB,aAAa,CAAC,OAAO,EAAE,EACrC,OAAO,EACP,cAA4B,EAC5B,OAAO,EACP,QAAoC,EACpC,KAAK,EACL,SAAS,GACV,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAAG,YAAY,CAsH5C;AAED,eAAe,aAAa,CAAC"}

package/dist/vista/html/CustomUiFrame.js

@@ -0,0 +1,69 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { AlertTriangle } from 'lucide-react';
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { classifyFrameMessage } from './custom-ui-frame-bridge';
+import { hostPropsMessage, } from './custom-ui-frame-contract';
+import { CUSTOM_UI_FRAME_RESET_CSS, buildCustomUiSrcDoc, buildUntrustedHtmlSrcDoc, } from './custom-ui-srcdoc';
+import { cn } from '../../ui/cn';
+const EMPTY_PROPS = {};
+export function CustomUiFrame({ content, componentProps = EMPTY_PROPS, intents, styleCss = CUSTOM_UI_FRAME_RESET_CSS, title, className, }) {
+    const iframeRef = useRef(null);
+    const [frameError, setFrameError] = useState(null);
+    const propsRef = useRef(componentProps);
+    propsRef.current = componentProps;
+    const intentsRef = useRef(intents);
+    intentsRef.current = intents;
+    const readyRef = useRef(false);
+    const isCompiled = 'compiledOutput' in content;
+    const compiledOutput = isCompiled ? content.compiledOutput : null;
+    const integrity = isCompiled ? content.integrity : null;
+    const document = isCompiled ? null : content.document;
+    const srcDoc = useMemo(() => {
+        try {
+            return compiledOutput !== null && integrity !== null
+                ? buildCustomUiSrcDoc({ compiledOutput, integrity, styleCss })
+                : buildUntrustedHtmlSrcDoc({ document: document ?? '', styleCss });
+        }
+        catch {
+            return null;
+        }
+    }, [compiledOutput, integrity, document, styleCss]);
+    useEffect(() => {
+        readyRef.current = false;
+        setFrameError(null);
+    }, [srcDoc]);
+    useEffect(() => {
+        function onMessage(event) {
+            const frameWindow = iframeRef.current?.contentWindow ?? null;
+            const classified = classifyFrameMessage(event, frameWindow, intentsRef.current.parse);
+            switch (classified.kind) {
+                case 'ready':
+                    readyRef.current = true;
+                    setFrameError(null);
+                    frameWindow?.postMessage(hostPropsMessage(propsRef.current), '*');
+                    return;
+                case 'intent':
+                    intentsRef.current.perform(classified.intent);
+                    return;
+                case 'error':
+                    setFrameError(classified.message);
+                    return;
+                case 'ignored':
+                    return;
+            }
+        }
+        window.addEventListener('message', onMessage);
+        return () => window.removeEventListener('message', onMessage);
+    }, []);
+    useEffect(() => {
+        if (!readyRef.current)
+            return;
+        iframeRef.current?.contentWindow?.postMessage(hostPropsMessage(componentProps), '*');
+    }, [componentProps]);
+    if (srcDoc === null) {
+        return (_jsx("div", { className: className, children: _jsxs("div", { role: "alert", className: "flex items-start gap-2 rounded border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive", children: [_jsx(AlertTriangle, { className: "mt-0.5 h-4 w-4 shrink-0" }), _jsx("span", { children: "This custom view could not be prepared safely and was not rendered." })] }) }));
+    }
+    return (_jsxs("div", { className: cn('flex h-full min-h-0 flex-col', className), children: [frameError !== null ? (_jsxs("div", { role: "alert", className: "mb-2 flex items-start gap-2 rounded border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive", children: [_jsx(AlertTriangle, { className: "mt-0.5 h-4 w-4 shrink-0" }), _jsxs("span", { children: ["This custom view failed to render: ", frameError] })] })) : null, _jsx("iframe", { ref: iframeRef, title: title, sandbox: "allow-scripts", srcDoc: srcDoc, className: "min-h-[24rem] w-full flex-1 rounded border border-rule bg-paper" })] }));
+}
+export default CustomUiFrame;
+//# sourceMappingURL=CustomUiFrame.js.map

package/dist/vista/html/CustomUiFrame.js.map

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

package/dist/vista/html/custom-ui-frame-bridge.d.ts

@@ -0,0 +1,13 @@
+export type ClassifiedFrameMessage<TIntent> = {
+    readonly kind: 'ready';
+} | {
+    readonly kind: 'intent';
+    readonly intent: TIntent;
+} | {
+    readonly kind: 'error';
+    readonly message: string;
+} | {
+    readonly kind: 'ignored';
+};
+export declare function classifyFrameMessage<TIntent>(event: Pick<MessageEvent, 'source' | 'data'>, frameWindow: Window | null, parseIntent: (raw: unknown) => TIntent | null): ClassifiedFrameMessage<TIntent>;
+//# sourceMappingURL=custom-ui-frame-bridge.d.ts.map

package/dist/vista/html/custom-ui-frame-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-ui-frame-bridge.d.ts","sourceRoot":"","sources":["../../../src/vista/html/custom-ui-frame-bridge.ts"],"names":[],"mappings":"AAgCA,MAAM,MAAM,sBAAsB,CAAC,OAAO,IACtC;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAWjC,wBAAgB,oBAAoB,CAAC,OAAO,EAC1C,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,MAAM,CAAC,EAC5C,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,WAAW,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI,GAC5C,sBAAsB,CAAC,OAAO,CAAC,CAwCjC"}

package/dist/vista/html/custom-ui-frame-bridge.js

@@ -0,0 +1,30 @@
+import { CUSTOM_UI_FRAME_PROTOCOL, CustomUiFrameMessageType, } from './custom-ui-frame-contract';
+const IGNORED = { kind: 'ignored' };
+export function classifyFrameMessage(event, frameWindow, parseIntent) {
+    if (frameWindow === null || event.source !== frameWindow)
+        return IGNORED;
+    const data = event.data;
+    if (data === null || typeof data !== 'object')
+        return IGNORED;
+    const envelope = data;
+    if (envelope.protocol !== CUSTOM_UI_FRAME_PROTOCOL)
+        return IGNORED;
+    switch (envelope.type) {
+        case CustomUiFrameMessageType.FrameReady:
+            return { kind: 'ready' };
+        case CustomUiFrameMessageType.FrameIntent: {
+            const intent = parseIntent(envelope.intent);
+            return intent === null ? IGNORED : { kind: 'intent', intent };
+        }
+        case CustomUiFrameMessageType.FrameError:
+            return {
+                kind: 'error',
+                message: typeof envelope.message === 'string'
+                    ? envelope.message
+                    : 'The custom view failed to render.',
+            };
+        default:
+            return IGNORED;
+    }
+}
+//# sourceMappingURL=custom-ui-frame-bridge.js.map

package/dist/vista/html/custom-ui-frame-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-ui-frame-bridge.js","sourceRoot":"","sources":["../../../src/vista/html/custom-ui-frame-bridge.ts"],"names":[],"mappings":"AA0BA,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AASpC,MAAM,OAAO,GAAkC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AASnE,MAAM,UAAU,oBAAoB,CAClC,KAA4C,EAC5C,WAA0B,EAC1B,WAA6C;IAI7C,IAAI,WAAW,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,OAAO,CAAC;IAEzE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAC9D,MAAM,QAAQ,GAAG,IAKhB,CAAC;IAGF,IAAI,QAAQ,CAAC,QAAQ,KAAK,wBAAwB;QAAE,OAAO,OAAO,CAAC;IAGnE,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,wBAAwB,CAAC,UAAU;YACtC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC3B,KAAK,wBAAwB,CAAC,WAAW,CAAC,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAG5C,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAChE,CAAC;QACD,KAAK,wBAAwB,CAAC,UAAU;YACtC,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,OAAO,EACL,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ;oBAClC,CAAC,CAAC,QAAQ,CAAC,OAAO;oBAClB,CAAC,CAAC,mCAAmC;aAC1C,CAAC;QACJ;YAGE,OAAO,OAAO,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/vista/html/custom-ui-frame-contract.d.ts

@@ -0,0 +1,29 @@
+export declare const CUSTOM_UI_FRAME_PROTOCOL: 1;
+export declare enum CustomUiFrameMessageType {
+    FrameReady = "xema.customui.frameReady",
+    HostProps = "xema.customui.hostProps",
+    FrameIntent = "xema.customui.frameIntent",
+    FrameError = "xema.customui.frameError"
+}
+export interface FrameReadyMessage {
+    readonly type: CustomUiFrameMessageType.FrameReady;
+    readonly protocol: typeof CUSTOM_UI_FRAME_PROTOCOL;
+}
+export interface HostPropsMessage {
+    readonly type: CustomUiFrameMessageType.HostProps;
+    readonly protocol: typeof CUSTOM_UI_FRAME_PROTOCOL;
+    readonly props: CustomUiComponentProps;
+}
+export interface FrameIntentMessage {
+    readonly type: CustomUiFrameMessageType.FrameIntent;
+    readonly protocol: typeof CUSTOM_UI_FRAME_PROTOCOL;
+    readonly intent: unknown;
+}
+export interface FrameErrorMessage {
+    readonly type: CustomUiFrameMessageType.FrameError;
+    readonly protocol: typeof CUSTOM_UI_FRAME_PROTOCOL;
+    readonly message: string;
+}
+export type CustomUiComponentProps = Record<string, unknown>;
+export declare function hostPropsMessage(props: CustomUiComponentProps): HostPropsMessage;
+//# sourceMappingURL=custom-ui-frame-contract.d.ts.map

package/dist/vista/html/custom-ui-frame-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-ui-frame-contract.d.ts","sourceRoot":"","sources":["../../../src/vista/html/custom-ui-frame-contract.ts"],"names":[],"mappings":"AAwBA,eAAO,MAAM,wBAAwB,EAAG,CAAU,CAAC;AAWnD,oBAAY,wBAAwB;IAClC,UAAU,6BAA6B;IACvC,SAAS,4BAA4B;IACrC,WAAW,8BAA8B;IACzC,UAAU,6BAA6B;CACxC;AAGD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC,UAAU,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,OAAO,wBAAwB,CAAC;CACpD;AAGD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC,SAAS,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,OAAO,wBAAwB,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;CACxC;AAGD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC,WAAW,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,OAAO,wBAAwB,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAGD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC,UAAU,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,OAAO,wBAAwB,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AASD,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAG7D,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,sBAAsB,GAC5B,gBAAgB,CAMlB"}

package/dist/vista/html/custom-ui-frame-contract.js

@@ -0,0 +1,16 @@
+export const CUSTOM_UI_FRAME_PROTOCOL = 1;
+export var CustomUiFrameMessageType;
+(function (CustomUiFrameMessageType) {
+    CustomUiFrameMessageType["FrameReady"] = "xema.customui.frameReady";
+    CustomUiFrameMessageType["HostProps"] = "xema.customui.hostProps";
+    CustomUiFrameMessageType["FrameIntent"] = "xema.customui.frameIntent";
+    CustomUiFrameMessageType["FrameError"] = "xema.customui.frameError";
+})(CustomUiFrameMessageType || (CustomUiFrameMessageType = {}));
+export function hostPropsMessage(props) {
+    return {
+        type: CustomUiFrameMessageType.HostProps,
+        protocol: CUSTOM_UI_FRAME_PROTOCOL,
+        props,
+    };
+}
+//# sourceMappingURL=custom-ui-frame-contract.js.map

package/dist/vista/html/custom-ui-frame-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-ui-frame-contract.js","sourceRoot":"","sources":["../../../src/vista/html/custom-ui-frame-contract.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAU,CAAC;AAWnD,MAAM,CAAN,IAAY,wBAKX;AALD,WAAY,wBAAwB;IAClC,mEAAuC,CAAA;IACvC,iEAAqC,CAAA;IACrC,qEAAyC,CAAA;IACzC,mEAAuC,CAAA;AACzC,CAAC,EALW,wBAAwB,KAAxB,wBAAwB,QAKnC;AAuCD,MAAM,UAAU,gBAAgB,CAC9B,KAA6B;IAE7B,OAAO;QACL,IAAI,EAAE,wBAAwB,CAAC,SAAS;QACxC,QAAQ,EAAE,wBAAwB;QAClC,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/vista/html/custom-ui-intents.d.ts

@@ -0,0 +1,20 @@
+export interface CustomUiIntentSet<TIntent> {
+    parse(raw: unknown): TIntent | null;
+    perform(intent: TIntent): void;
+}
+export declare enum CustomUiIntentKind {
+    Navigate = "navigate"
+}
+export interface NavigateIntent {
+    readonly kind: CustomUiIntentKind.Navigate;
+    readonly href: string;
+}
+export type CustomUiIntent = NavigateIntent;
+export interface CustomUiIntentHandlers {
+    readonly [CustomUiIntentKind.Navigate]: (intent: NavigateIntent) => void;
+}
+export declare function parseCustomUiIntent(raw: unknown): CustomUiIntent | null;
+export declare function performCustomUiIntent(intent: CustomUiIntent, handlers: CustomUiIntentHandlers): void;
+export declare function createNavigateIntentSet(handlers: CustomUiIntentHandlers): CustomUiIntentSet<CustomUiIntent>;
+export declare const NO_CUSTOM_UI_INTENTS: CustomUiIntentSet<never>;
+//# sourceMappingURL=custom-ui-intents.d.ts.map

package/dist/vista/html/custom-ui-intents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-ui-intents.d.ts","sourceRoot":"","sources":["../../../src/vista/html/custom-ui-intents.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,iBAAiB,CAAC,OAAO;IACxC,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAChC;AAGD,oBAAY,kBAAkB;IAE5B,QAAQ,aAAa;CACtB;AAOD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC,QAAQ,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAGD,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC;AAQ5C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;CAC1E;AA0CD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAWvE;AAQD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,sBAAsB,GAC/B,IAAI,CAUN;AAGD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,sBAAsB,GAC/B,iBAAiB,CAAC,cAAc,CAAC,CAKnC;AAQD,eAAO,MAAM,oBAAoB,EAAE,iBAAiB,CAAC,KAAK,CAGzD,CAAC"}

package/dist/vista/html/custom-ui-intents.js

@@ -0,0 +1,57 @@
+export var CustomUiIntentKind;
+(function (CustomUiIntentKind) {
+    CustomUiIntentKind["Navigate"] = "navigate";
+})(CustomUiIntentKind || (CustomUiIntentKind = {}));
+function isHostRelativePath(href) {
+    if (!href.startsWith('/'))
+        return false;
+    if (href.includes('\\'))
+        return false;
+    if (/[\u0000-\u0020\u007f]/.test(href))
+        return false;
+    let resolved;
+    try {
+        resolved = new URL(href, window.location.origin);
+    }
+    catch {
+        return false;
+    }
+    return resolved.origin === window.location.origin;
+}
+export function parseCustomUiIntent(raw) {
+    if (raw === null || typeof raw !== 'object')
+        return null;
+    const candidate = raw;
+    switch (candidate.kind) {
+        case CustomUiIntentKind.Navigate:
+            if (typeof candidate.href !== 'string')
+                return null;
+            if (!isHostRelativePath(candidate.href))
+                return null;
+            return { kind: CustomUiIntentKind.Navigate, href: candidate.href };
+        default:
+            return null;
+    }
+}
+export function performCustomUiIntent(intent, handlers) {
+    switch (intent.kind) {
+        case CustomUiIntentKind.Navigate:
+            handlers[CustomUiIntentKind.Navigate](intent);
+            return;
+        default: {
+            const exhaustive = intent.kind;
+            throw new Error(`Unhandled custom-UI intent kind: ${String(exhaustive)}`);
+        }
+    }
+}
+export function createNavigateIntentSet(handlers) {
+    return {
+        parse: parseCustomUiIntent,
+        perform: (intent) => performCustomUiIntent(intent, handlers),
+    };
+}
+export const NO_CUSTOM_UI_INTENTS = {
+    parse: () => null,
+    perform: () => undefined,
+};
+//# sourceMappingURL=custom-ui-intents.js.map

package/dist/vista/html/custom-ui-intents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-ui-intents.js","sourceRoot":"","sources":["../../../src/vista/html/custom-ui-intents.ts"],"names":[],"mappings":"AA6BA,MAAM,CAAN,IAAY,kBAGX;AAHD,WAAY,kBAAkB;IAE5B,2CAAqB,CAAA;AACvB,CAAC,EAHW,kBAAkB,KAAlB,kBAAkB,QAG7B;AAwCD,SAAS,kBAAkB,CAAC,IAAY;IAEtC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAIxC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAEtC,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,QAAa,CAAC;IAClB,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;AACpD,CAAC;AAQD,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzD,MAAM,SAAS,GAAG,GAAyC,CAAC;IAC5D,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,kBAAkB,CAAC,QAAQ;YAC9B,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACpD,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;YACrD,OAAO,EAAE,IAAI,EAAE,kBAAkB,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;QACrE;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAQD,MAAM,UAAU,qBAAqB,CACnC,MAAsB,EACtB,QAAgC;IAEhC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,kBAAkB,CAAC,QAAQ;YAC9B,QAAQ,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;YAC9C,OAAO;QACT,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,MAAM,CAAC,IAAI,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,oCAAoC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;AACH,CAAC;AAGD,MAAM,UAAU,uBAAuB,CACrC,QAAgC;IAEhC,OAAO;QACL,KAAK,EAAE,mBAAmB;QAC1B,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC;KAC7D,CAAC;AACJ,CAAC;AAQD,MAAM,CAAC,MAAM,oBAAoB,GAA6B;IAC5D,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI;IACjB,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;CACzB,CAAC"}

package/dist/vista/html/custom-ui-srcdoc.d.ts

@@ -0,0 +1,17 @@
+export declare const CUSTOM_UI_FRAME_RESET_CSS = "\n*, *::before, *::after { box-sizing: border-box; }\nhtml, body { margin: 0; padding: 0; }\nbody {\n  font-family: ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", Roboto, sans-serif;\n  color: hsl(var(--foreground, 228 14% 11%));\n  background: transparent;\n}\n#root { min-height: 100%; }\n";
+export declare function buildCustomUiFrameCsp(integrity: string): string;
+export declare function buildUntrustedHtmlFrameCsp(): string;
+export interface CustomUiSrcDocInput {
+    readonly compiledOutput: string;
+    readonly integrity: string;
+    readonly styleCss: string;
+}
+export declare class CustomUiSrcDocError extends Error {
+}
+export declare function buildCustomUiSrcDoc({ compiledOutput, integrity, styleCss, }: CustomUiSrcDocInput): string;
+export interface UntrustedHtmlSrcDocInput {
+    readonly document: string;
+    readonly styleCss: string;
+}
+export declare function buildUntrustedHtmlSrcDoc({ document, styleCss, }: UntrustedHtmlSrcDocInput): string;
+//# sourceMappingURL=custom-ui-srcdoc.d.ts.map

package/dist/vista/html/custom-ui-srcdoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-ui-srcdoc.d.ts","sourceRoot":"","sources":["../../../src/vista/html/custom-ui-srcdoc.ts"],"names":[],"mappings":"AAkCA,eAAO,MAAM,yBAAyB,gTASrC,CAAC;AAwBF,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/D;AAMD,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAGD,MAAM,WAAW,mBAAmB;IAElC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAM3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAMD,qBAAa,mBAAoB,SAAQ,KAAK;CAAG;AA+BjD,wBAAgB,mBAAmB,CAAC,EAClC,cAAc,EACd,SAAS,EACT,QAAQ,GACT,EAAE,mBAAmB,GAAG,MAAM,CAiB9B;AAGD,MAAM,WAAW,wBAAwB;IAEvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAgBD,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,QAAQ,GACT,EAAE,wBAAwB,GAAG,MAAM,CAgBnC"}

package/dist/vista/html/custom-ui-srcdoc.js

@@ -0,0 +1,70 @@
+export const CUSTOM_UI_FRAME_RESET_CSS = `
+*, *::before, *::after { box-sizing: border-box; }
+html, body { margin: 0; padding: 0; }
+body {
+  font-family: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
+  color: hsl(var(--foreground, 228 14% 11%));
+  background: transparent;
+}
+#root { min-height: 100%; }
+`;
+function buildFrameCsp(scriptSource) {
+    return [
+        `default-src 'none'`,
+        `script-src ${scriptSource}`,
+        `style-src 'unsafe-inline'`,
+        `base-uri 'none'`,
+        `form-action 'none'`,
+    ].join('; ');
+}
+export function buildCustomUiFrameCsp(integrity) {
+    return buildFrameCsp(`'${integrity}'`);
+}
+export function buildUntrustedHtmlFrameCsp() {
+    return buildFrameCsp(`'none'`);
+}
+export class CustomUiSrcDocError extends Error {
+}
+function assertNoScriptTerminator(source, what) {
+    if (/<\/script/i.test(source)) {
+        throw new CustomUiSrcDocError(`${what} contains a literal "</script" — it would truncate the inline ` +
+            'module. The producer must emit escaped bytes; refusing to build a ' +
+            'mis-rendered frame.');
+    }
+}
+export function buildCustomUiSrcDoc({ compiledOutput, integrity, styleCss, }) {
+    assertNoScriptTerminator(compiledOutput, 'compiled custom-UI chunk');
+    const csp = buildCustomUiFrameCsp(integrity);
+    return [
+        `<!doctype html>`,
+        `<html>`,
+        `<head>`,
+        `<meta charset="utf-8" />`,
+        `<meta http-equiv="Content-Security-Policy" content="${csp}" />`,
+        `<style>${styleCss}</style>`,
+        `</head>`,
+        `<body>`,
+        `<div id="root"></div>`,
+        `<script type="module">${compiledOutput}</script>`,
+        `</body>`,
+        `</html>`,
+    ].join('\n');
+}
+export function buildUntrustedHtmlSrcDoc({ document, styleCss, }) {
+    assertNoScriptTerminator(document, 'untrusted HTML document');
+    const csp = buildUntrustedHtmlFrameCsp();
+    return [
+        `<!doctype html>`,
+        `<html>`,
+        `<head>`,
+        `<meta charset="utf-8" />`,
+        `<meta http-equiv="Content-Security-Policy" content="${csp}" />`,
+        `<style>${styleCss}</style>`,
+        `</head>`,
+        `<body>`,
+        document,
+        `</body>`,
+        `</html>`,
+    ].join('\n');
+}
+//# sourceMappingURL=custom-ui-srcdoc.js.map

package/dist/vista/html/custom-ui-srcdoc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-ui-srcdoc.js","sourceRoot":"","sources":["../../../src/vista/html/custom-ui-srcdoc.ts"],"names":[],"mappings":"AAkCA,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;CASxC,CAAC;AAQF,SAAS,aAAa,CAAC,YAAoB;IACzC,OAAO;QACL,oBAAoB;QACpB,cAAc,YAAY,EAAE;QAC5B,2BAA2B;QAC3B,iBAAiB;QACjB,oBAAoB;KACrB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAQD,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,OAAO,aAAa,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC;AACzC,CAAC;AAMD,MAAM,UAAU,0BAA0B;IACxC,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAoBD,MAAM,OAAO,mBAAoB,SAAQ,KAAK;CAAG;AAWjD,SAAS,wBAAwB,CAAC,MAAc,EAAE,IAAY;IAC5D,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,mBAAmB,CAC3B,GAAG,IAAI,gEAAgE;YACrE,oEAAoE;YACpE,qBAAqB,CACxB,CAAC;IACJ,CAAC;AACH,CAAC;AAYD,MAAM,UAAU,mBAAmB,CAAC,EAClC,cAAc,EACd,SAAS,EACT,QAAQ,GACY;IACpB,wBAAwB,CAAC,cAAc,EAAE,0BAA0B,CAAC,CAAC;IACrE,MAAM,GAAG,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO;QACL,iBAAiB;QACjB,QAAQ;QACR,QAAQ;QACR,0BAA0B;QAC1B,uDAAuD,GAAG,MAAM;QAChE,UAAU,QAAQ,UAAU;QAC5B,SAAS;QACT,QAAQ;QACR,uBAAuB;QACvB,yBAAyB,cAAc,WAAW;QAClD,SAAS;QACT,SAAS;KACV,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAwBD,MAAM,UAAU,wBAAwB,CAAC,EACvC,QAAQ,EACR,QAAQ,GACiB;IACzB,wBAAwB,CAAC,QAAQ,EAAE,yBAAyB,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,0BAA0B,EAAE,CAAC;IACzC,OAAO;QACL,iBAAiB;QACjB,QAAQ;QACR,QAAQ;QACR,0BAA0B;QAC1B,uDAAuD,GAAG,MAAM;QAChE,UAAU,QAAQ,UAAU;QAC5B,SAAS;QACT,QAAQ;QACR,QAAQ;QACR,SAAS;QACT,SAAS;KACV,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/vista/html/index.d.ts

@@ -0,0 +1,6 @@
+export * from './custom-ui-frame-contract';
+export * from './custom-ui-intents';
+export * from './custom-ui-srcdoc';
+export * from './custom-ui-frame-bridge';
+export * from './CustomUiFrame';
+//# sourceMappingURL=index.d.ts.map

package/dist/vista/html/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/vista/html/index.ts"],"names":[],"mappings":"AAQA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC"}

package/dist/vista/html/index.js

@@ -0,0 +1,6 @@
+export * from './custom-ui-frame-contract';
+export * from './custom-ui-intents';
+export * from './custom-ui-srcdoc';
+export * from './custom-ui-frame-bridge';
+export * from './CustomUiFrame';
+//# sourceMappingURL=index.js.map

package/dist/vista/html/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/vista/html/index.ts"],"names":[],"mappings":"AAQA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC"}

package/dist/vista/index.d.ts

@@ -0,0 +1,18 @@
+export * from './surface-registry';
+export * from './surface-catalogue';
+export * from './surface-icons';
+export * from './GenericCatalogueSurface';
+export * from './SurfaceFallbackCard';
+export * from './vista-model';
+export * from './vista-payloads';
+export * from './vista-tabs-manifest';
+export * from './vista-file-source';
+export * from './vista-form-host';
+export * from './vista-code-renderer';
+export * from './vista-open-context';
+export * from './use-vista-tabs';
+export * from './VistaPanel';
+export * from './vista-tools';
+export * from './html';
+export * from './surfaces';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vista/index.ts"],"names":[],"mappings":"AA6BA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AAGvB,cAAc,YAAY,CAAC"}

package/dist/vista/index.js

@@ -0,0 +1,18 @@
+export * from './surface-registry';
+export * from './surface-catalogue';
+export * from './surface-icons';
+export * from './GenericCatalogueSurface';
+export * from './SurfaceFallbackCard';
+export * from './vista-model';
+export * from './vista-payloads';
+export * from './vista-tabs-manifest';
+export * from './vista-file-source';
+export * from './vista-form-host';
+export * from './vista-code-renderer';
+export * from './vista-open-context';
+export * from './use-vista-tabs';
+export * from './VistaPanel';
+export * from './vista-tools';
+export * from './html';
+export * from './surfaces';
+//# sourceMappingURL=index.js.map

package/dist/vista/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vista/index.ts"],"names":[],"mappings":"AA6BA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AAGvB,cAAc,YAAY,CAAC"}

package/dist/vista/surface-catalogue.d.ts

@@ -0,0 +1,5 @@
+import { type SurfaceKindCatalogueEntry } from '@xemahq/kernel-contracts/surface';
+export type SurfaceCatalogueFetcher = () => Promise<readonly SurfaceKindCatalogueEntry[]>;
+export declare function __resetSurfaceCatalogueSyncForTests(): void;
+export declare function syncSurfaceCatalogue(fetchCatalogue: SurfaceCatalogueFetcher): Promise<void>;
+//# sourceMappingURL=surface-catalogue.d.ts.map

package/dist/vista/surface-catalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-catalogue.d.ts","sourceRoot":"","sources":["../../src/vista/surface-catalogue.ts"],"names":[],"mappings":"AA6BA,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,kCAAkC,CAAC;AAM1C,MAAM,MAAM,uBAAuB,GAAG,MAAM,OAAO,CACjD,SAAS,yBAAyB,EAAE,CACrC,CAAC;AAKF,wBAAgB,mCAAmC,IAAI,IAAI,CAE1D;AAOD,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,uBAAuB,GACtC,OAAO,CAAC,IAAI,CAAC,CA2Bf"}