@artkit-ai/react 0.0.0-stage → 0.2.0

package/dist/components/panel.js

@@ -0,0 +1,132 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ChevronDown, Copy, Download, X } from 'lucide-react';
+import { useCallback, useEffect, useId, useMemo, useRef, useState, } from 'react';
+import { useArtkit } from '../context.js';
+import { useArtifact, useArtifactExport } from '../hooks.js';
+import { ArtifactEditor } from './editor.js';
+import { cx, ErrorMessage, formatLabel, Loading, rootAttributes, slot, useAnnouncer, } from './shared.js';
+import { ArtifactView } from './view.js';
+const TABS = ['view', 'edit', 'code'];
+const TAB_LABEL = { view: 'tabView', edit: 'tabEdit', code: 'tabCode' };
+/**
+ * Side panel of one artifact: View, Edit and Code tabs and the export menu (spec §13.1). There is no history, approval
+ * or archive here: the application owns versions and publication.
+ */
+export function ArtifactPanel(props) {
+    const ctx = useArtkit();
+    const { t } = ctx;
+    const id = props.id ?? props.artifact?.id;
+    const latestQuery = useArtifact(id, props.artifact ? { initial: props.artifact } : {});
+    const latest = latestQuery.artifact;
+    const [ownTab, setOwnTab] = useState(props.defaultTab ?? 'view');
+    const tab = props.tab ?? ownTab;
+    const selectTab = (next) => {
+        setOwnTab(next);
+        props.onTabChange?.(next);
+    };
+    const exporter = useArtifactExport(id ?? '', latest?.format);
+    const [live, announce] = useAnnouncer();
+    const baseId = useId();
+    if (!latest || !id) {
+        return (_jsx("aside", { className: cx('ak-root ak-panel', props.className), ...rootAttributes(ctx), children: latestQuery.error ? (_jsx(ErrorMessage, { error: latestQuery.error, onRetry: () => void latestQuery.refresh().catch(() => undefined) })) : (_jsx(Loading, {})) }));
+    }
+    async function exportAs(format) {
+        try {
+            const result = await exporter.exportArtifact(format, {});
+            announce(t('exported', { filename: result.filename }));
+        }
+        catch {
+            // The hook keeps the error; it is rendered below.
+        }
+    }
+    const tabId = (name) => `${baseId}-tab-${name}`;
+    const panelId = (name) => `${baseId}-panel-${name}`;
+    const onTabKeyDown = (event) => {
+        const index = TABS.indexOf(tab);
+        let next;
+        if (event.key === 'ArrowRight')
+            next = TABS[(index + 1) % TABS.length];
+        else if (event.key === 'ArrowLeft')
+            next = TABS[(index + TABS.length - 1) % TABS.length];
+        else if (event.key === 'Home')
+            next = TABS[0];
+        else if (event.key === 'End')
+            next = TABS[TABS.length - 1];
+        if (!next)
+            return;
+        event.preventDefault();
+        selectTab(next);
+        document.getElementById(tabId(next))?.focus();
+    };
+    const exportFormats = props.exportFormats ?? exporter.formats;
+    return (_jsxs("aside", { className: cx('ak-root ak-panel', props.className), ...rootAttributes(ctx, latest.themeId), "aria-labelledby": `${baseId}-title`, "data-format": latest.format, children: [live, _jsxs("header", { ...slot(props.slots, 'header', 'ak-panel-header'), children: [_jsx("h2", { id: `${baseId}-title`, ...slot(props.slots, 'title', 'ak-panel-title'), children: latest.title }), _jsx("span", { className: "ak-history-meta", children: formatLabel(ctx, latest.format) }), _jsx("span", { className: "ak-badge", children: t('versionShort', { version: latest.version }) }), props.headerActions, _jsx(ExportMenu, { formats: exportFormats, pending: exporter.pending, onOpen: () => void exporter.loadFormats(), onSelect: (format) => void exportAs(format) }), props.onClose ? (_jsx("button", { type: "button", className: "ak-button", "data-variant": "quiet", onClick: props.onClose, "aria-label": t('close'), children: _jsx(X, { "aria-hidden": "true" }) })) : null] }), exporter.error ? _jsx(ErrorMessage, { error: exporter.error, className: "ak-panel-notice" }) : null, _jsx("div", { role: "tablist", "aria-label": latest.title, ...slot(props.slots, 'tabs', 'ak-tabs'), children: TABS.map((name) => (_jsx("button", { id: tabId(name), type: "button", role: "tab", className: "ak-tab", "aria-selected": tab === name, "aria-controls": panelId(name), tabIndex: tab === name ? 0 : -1, onClick: () => selectTab(name), onKeyDown: onTabKeyDown, children: t(TAB_LABEL[name]) }, name))) }), _jsxs("div", { id: panelId(tab), role: "tabpanel", "aria-labelledby": tabId(tab), ...slot(props.slots, 'body', 'ak-panel-body'), children: [tab === 'view' ? _jsx(ArtifactView, { artifact: latest }) : null, tab === 'edit' ? (_jsx(ArtifactEditor, { artifact: latest, ...(props.onSave ? { onSave: props.onSave } : {}), ...(props.onChange ? { onChange: props.onChange } : {}) })) : null, tab === 'code' ? _jsx(CodeTab, { artifact: latest, slots: props.slots }) : null] })] }));
+}
+function CodeTab({ artifact, slots, }) {
+    const { t } = useArtkit();
+    const [copied, setCopied] = useState(false);
+    const text = useMemo(() => (artifact ? JSON.stringify(artifact.content, null, 2) : ''), [artifact]);
+    if (!artifact)
+        return _jsx(Loading, {});
+    const clipboard = typeof navigator === 'undefined' ? undefined : navigator.clipboard;
+    return (_jsxs("div", { className: "ak-code-tab", children: [clipboard ? (_jsxs("button", { type: "button", className: "ak-button", onClick: () => {
+                    clipboard.writeText(text).then(() => setCopied(true), () => setCopied(false));
+                }, children: [_jsx(Copy, { "aria-hidden": "true" }), copied ? t('copied') : t('copy')] })) : null, _jsx("pre", { ...slot(slots, 'code', 'ak-code'), children: _jsx("code", { children: text }) })] }));
+}
+function ExportMenu(props) {
+    const { t } = useArtkit();
+    const [open, setOpen] = useState(false);
+    const button = useRef(null);
+    const list = useRef(null);
+    const menuId = useId();
+    const items = useCallback(() => [...(list.current?.querySelectorAll('[role="menuitem"]') ?? [])], []);
+    useEffect(() => {
+        if (open)
+            items()[0]?.focus();
+    }, [open, items]);
+    const close = (refocus) => {
+        setOpen(false);
+        if (refocus)
+            button.current?.focus();
+    };
+    const onMenuKeyDown = (event) => {
+        const all = items();
+        const index = all.indexOf(document.activeElement);
+        let next;
+        if (event.key === 'ArrowDown')
+            next = all[(index + 1) % all.length];
+        else if (event.key === 'ArrowUp')
+            next = all[(index - 1 + all.length) % all.length];
+        else if (event.key === 'Home')
+            next = all[0];
+        else if (event.key === 'End')
+            next = all[all.length - 1];
+        else if (event.key === 'Escape') {
+            event.preventDefault();
+            close(true);
+            return;
+        }
+        else if (event.key === 'Tab') {
+            close(false);
+            return;
+        }
+        if (next) {
+            event.preventDefault();
+            next.focus();
+        }
+    };
+    return (_jsxs("div", { className: "ak-menu", children: [_jsxs("button", { ref: button, type: "button", className: "ak-button", "aria-haspopup": "menu", "aria-expanded": open, "aria-controls": open ? menuId : undefined, disabled: props.pending !== undefined, onClick: () => {
+                    if (!open)
+                        props.onOpen();
+                    setOpen(!open);
+                }, onKeyDown: (event) => {
+                    if (event.key === 'ArrowDown' && !open) {
+                        event.preventDefault();
+                        props.onOpen();
+                        setOpen(true);
+                    }
+                }, children: [_jsx(Download, { "aria-hidden": "true" }), props.pending ? t('exporting') : t('export'), _jsx(ChevronDown, { "aria-hidden": "true" })] }), open ? (_jsx("div", { ref: list, id: menuId, role: "menu", className: "ak-menu-list", "aria-label": t('export'), tabIndex: -1, onKeyDown: onMenuKeyDown, children: props.formats.length === 0 ? (_jsx("p", { className: "ak-menu-item", children: t('noExportFormats') })) : (props.formats.map((format) => (_jsx("button", { type: "button", role: "menuitem", className: "ak-menu-item", tabIndex: -1, "aria-label": t('exportAs', { format: format.toUpperCase() }), onClick: () => {
+                        close(true);
+                        props.onSelect(format);
+                    }, children: format.toUpperCase() }, format)))) })) : null] }));
+}
+//# sourceMappingURL=panel.js.map

package/dist/components/panel.js.map

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

package/dist/components/shared.d.ts

@@ -0,0 +1,67 @@
+import type { ChangeSummary } from '@artkit-ai/core';
+import { Component, type CSSProperties, type ErrorInfo, type ReactNode } from 'react';
+import { type ArtkitContextValue } from '../context.js';
+/**
+ * Customization without forking (spec §13.5): each named part of a component accepts extra classes and
+ * inline styles. Base classes (`ak-*`) stay, so overrides compose with the default CSS.
+ */
+export type Slots<Part extends string> = Partial<Record<Part, {
+    className?: string;
+    style?: CSSProperties;
+}>>;
+export declare function cx(...classes: (string | false | null | undefined)[]): string;
+export declare function slot<Part extends string>(slots: Slots<Part> | undefined, part: Part, base: string): {
+    className: string;
+    style?: CSSProperties;
+};
+/** Attributes of every artkit root element: theme scope and forced light/dark. */
+export declare function rootAttributes(ctx: ArtkitContextValue, themeId?: string): Record<string, string>;
+export declare function errorMessage(error: unknown, fallback: string): string;
+export declare function ErrorMessage({ error, onRetry, onDismiss, className, style, }: {
+    error: unknown;
+    onRetry?: () => void;
+    onDismiss?: () => void;
+    className?: string;
+    style?: CSSProperties;
+}): import("react").JSX.Element;
+export declare function Loading({ label, className, style, }: {
+    label?: string;
+    className?: string;
+    style?: CSSProperties;
+}): import("react").JSX.Element;
+/**
+ * Polite live region for screen readers (spec §18.2). The text is cleared first so repeating the same
+ * message is announced again.
+ */
+export declare function useAnnouncer(): [ReactNode, (message: string) => void];
+export declare function ChangeList({ changes, className, style, }: {
+    changes: ChangeSummary[];
+    className?: string;
+    style?: CSSProperties;
+}): import("react").JSX.Element;
+interface BoundaryProps {
+    fallback: (error: unknown, reset: () => void) => ReactNode;
+    onReset?: () => void;
+    children?: ReactNode;
+}
+/** Catches loader and renderer failures so one broken kind does not take the page down. */
+export declare class ErrorBoundary extends Component<BoundaryProps, {
+    error: unknown;
+    failed: boolean;
+}> {
+    state: {
+        error: unknown;
+        failed: boolean;
+    };
+    static getDerivedStateFromError(error: unknown): {
+        error: unknown;
+        failed: boolean;
+    };
+    componentDidCatch(_error: unknown, _info: ErrorInfo): void;
+    reset: () => void;
+    render(): ReactNode;
+}
+export declare function formatDate(value: string, locale: string): string;
+export declare function formatLabel(ctx: ArtkitContextValue, format: string): string;
+export {};
+//# sourceMappingURL=shared.d.ts.map

package/dist/components/shared.d.ts.map

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

package/dist/components/shared.js

@@ -0,0 +1,100 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { isArtifactError } from '@artkit-ai/core';
+import { RotateCw } from 'lucide-react';
+import { Component, useCallback, useEffect, useRef, useState, } from 'react';
+import { useArtkit } from '../context.js';
+export function cx(...classes) {
+    return classes.filter(Boolean).join(' ');
+}
+export function slot(slots, part, base) {
+    const custom = slots?.[part];
+    return { className: cx(base, custom?.className), ...(custom?.style ? { style: custom.style } : {}) };
+}
+/** Attributes of every artkit root element: theme scope and forced light/dark. */
+export function rootAttributes(ctx, themeId) {
+    return {
+        ...(themeId ? { 'data-ak-theme': themeId } : {}),
+        ...(ctx.colorScheme !== 'system' ? { 'data-theme': ctx.colorScheme } : {}),
+    };
+}
+export function errorMessage(error, fallback) {
+    if (isArtifactError(error)) {
+        const hint = error.issues.find((issue) => issue.hint)?.hint;
+        return hint ? `${error.message} ${hint}` : error.message;
+    }
+    return fallback;
+}
+export function ErrorMessage({ error, onRetry, onDismiss, className, style, }) {
+    const { t } = useArtkit();
+    return (_jsxs("div", { role: "alert", className: cx('ak-alert', className), style: style, children: [_jsx("span", { children: errorMessage(error, t('loadFailed')) }), ' ', onRetry ? (_jsxs("button", { type: "button", className: "ak-button", onClick: onRetry, children: [_jsx(RotateCw, { "aria-hidden": "true" }), t('retry')] })) : null, onDismiss ? (_jsx("button", { type: "button", className: "ak-button", onClick: onDismiss, children: t('dismiss') })) : null] }));
+}
+export function Loading({ label, className, style, }) {
+    const { t } = useArtkit();
+    return (_jsx("div", { className: cx('ak-loading', className), style: style, role: "status", "aria-busy": "true", children: label ?? t('loading') }));
+}
+/**
+ * Polite live region for screen readers (spec §18.2). The text is cleared first so repeating the same
+ * message is announced again.
+ */
+export function useAnnouncer() {
+    const [message, setMessage] = useState('');
+    const frame = useRef(undefined);
+    useEffect(() => () => clearTimeout(frame.current), []);
+    const announce = useCallback((text) => {
+        setMessage('');
+        clearTimeout(frame.current);
+        frame.current = setTimeout(() => setMessage(text), 30);
+    }, []);
+    const node = (_jsx("div", { className: "ak-sr-only", role: "status", "aria-live": "polite", "aria-atomic": "true", children: message }));
+    return [node, announce];
+}
+export function ChangeList({ changes, className, style, }) {
+    const { t } = useArtkit();
+    if (changes.length === 0)
+        return _jsx("p", { className: "ak-notice", children: t('noChanges') });
+    return (_jsx("ul", { className: cx('ak-changes', className), style: style, children: withKeys(changes).map(({ change, key }) => (_jsxs("li", { className: "ak-change", "data-type": change.type, children: [_jsx("span", { className: "ak-change-type", children: t(`change_${change.type}`) }), _jsx("span", { className: "ak-change-target", children: change.target }), _jsx("span", { className: "ak-change-summary", children: change.summary })] }, key))) }));
+}
+// Targets can repeat (changed + moved); a per-target counter keeps keys stable across renders.
+function withKeys(changes) {
+    const seen = new Map();
+    return changes.map((change) => {
+        const base = `${change.type}:${change.target}`;
+        const count = seen.get(base) ?? 0;
+        seen.set(base, count + 1);
+        return { change, key: count === 0 ? base : `${base}#${count}` };
+    });
+}
+/** Catches loader and renderer failures so one broken kind does not take the page down. */
+export class ErrorBoundary extends Component {
+    state = { error: undefined, failed: false };
+    static getDerivedStateFromError(error) {
+        return { error, failed: true };
+    }
+    componentDidCatch(_error, _info) {
+        // Rendering the fallback is enough; the host app can wrap its own reporting boundary around us.
+    }
+    reset = () => {
+        this.props.onReset?.();
+        this.setState({ error: undefined, failed: false });
+    };
+    render() {
+        if (this.state.failed)
+            return this.props.fallback(this.state.error, this.reset);
+        return this.props.children;
+    }
+}
+export function formatDate(value, locale) {
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return value;
+    try {
+        return new Intl.DateTimeFormat(locale, { dateStyle: 'short', timeStyle: 'short' }).format(date);
+    }
+    catch {
+        return date.toISOString();
+    }
+}
+export function formatLabel(ctx, format) {
+    return ctx.registry.has(format) ? ctx.registry.get(format).label : format;
+}
+//# sourceMappingURL=shared.js.map

package/dist/components/shared.js.map

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

package/dist/components/view.d.ts

@@ -0,0 +1,39 @@
+import type { Artifact, RenderContext } from '@artkit-ai/core';
+import { type ArtkitContextValue } from '../context.js';
+import { type Slots } from './shared.js';
+export type ArtifactViewPart = 'body' | 'badge' | 'loading' | 'error';
+export interface ArtifactViewProps {
+    /** Committed artifact to show. */
+    artifact?: Artifact;
+    /** Alternatively, load the artifact by id. */
+    id?: string;
+    /**
+     * Content still being streamed by the model: a partial object or the raw JSON text so far. It goes
+     * through `format.parsePartial` and shows as a provisional preview until a newer committed version
+     * arrives (spec §13.4).
+     */
+    partial?: unknown;
+    /** Kind of the partial content when no artifact exists yet. */
+    format?: string;
+    /** Theme and locale of the partial content when no artifact exists yet. */
+    themeId?: string;
+    locale?: string;
+    mode?: RenderContext['mode'];
+    className?: string;
+    slots?: Slots<ArtifactViewPart>;
+}
+/** Turns streamed content into renderable content, or undefined while nothing complete arrived yet. */
+export declare function previewContent(ctx: ArtkitContextValue, format: string, partial: unknown): unknown;
+export declare function renderContext(ctx: ArtkitContextValue, themeId: string | undefined, locale: string, mode: RenderContext['mode'], provisional: boolean): RenderContext;
+/** Read-only view of any artifact by kind (spec §13.1). */
+export declare function ArtifactView(props: ArtifactViewProps): import("react").JSX.Element;
+interface FormatRendererProps {
+    format: string;
+    content: unknown;
+    ctx: RenderContext;
+    className?: string;
+}
+/** Lazy kind renderer with a JSON fallback when the kind has no renderer loader. */
+export declare function FormatRenderer(props: FormatRendererProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=view.d.ts.map

package/dist/components/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/components/view.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE/D,OAAO,EAAE,KAAK,kBAAkB,EAAa,MAAM,eAAe,CAAC;AAInE,OAAO,EAA4D,KAAK,KAAK,EAAQ,MAAM,aAAa,CAAC;AAEzG,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,8CAA8C;IAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;CACjC;AAED,uGAAuG;AACvG,wBAAgB,cAAc,CAAC,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAUjG;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,kBAAkB,EACvB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAC3B,WAAW,EAAE,OAAO,GACnB,aAAa,CAQf;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,+BAuFpD;AAED,UAAU,mBAAmB;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,aAAa,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,+BAsBxD"}

package/dist/components/view.js

@@ -0,0 +1,76 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Suspense, use, useMemo, useRef } from 'react';
+import { useArtkit } from '../context.js';
+import { useArtifact } from '../hooks.js';
+import { parsePartialJson } from '../partial-json.js';
+import { hashString } from '../styles.js';
+import { cx, ErrorBoundary, ErrorMessage, Loading, rootAttributes, slot } from './shared.js';
+/** Turns streamed content into renderable content, or undefined while nothing complete arrived yet. */
+export function previewContent(ctx, format, partial) {
+    if (!ctx.registry.has(format))
+        return undefined;
+    const raw = typeof partial === 'string' && /^\s*[[{]/.test(partial) ? parsePartialJson(partial) : partial;
+    if (raw === undefined)
+        return undefined;
+    try {
+        // Adapters take the streamed text; structured partials (e.g. a workbook JSON) are serialized first.
+        return ctx.registry.get(format).parsePartial(typeof raw === 'string' ? raw : JSON.stringify(raw));
+    }
+    catch {
+        return undefined;
+    }
+}
+export function renderContext(ctx, themeId, locale, mode, provisional) {
+    return {
+        theme: ctx.themeFor(themeId),
+        locale,
+        mode,
+        ...(provisional ? { provisional: true } : {}),
+        ...(ctx.resolveAssetUrl ? { resolveAssetUrl: ctx.resolveAssetUrl } : {}),
+    };
+}
+/** Read-only view of any artifact by kind (spec §13.1). */
+export function ArtifactView(props) {
+    const ctx = useArtkit();
+    const { t } = ctx;
+    const loaded = useArtifact(props.artifact ? undefined : props.id);
+    const committed = props.artifact ?? loaded.artifact;
+    // Remember which committed version was on screen when streaming started: any other version arriving
+    // afterwards is the commit that replaces the preview, even if the caller still passes `partial`.
+    const streamStart = useRef(null);
+    const stillLoading = !props.artifact && props.id !== undefined && loaded.loading;
+    if (props.partial === undefined)
+        streamStart.current = null;
+    else if (streamStart.current === null && !stillLoading)
+        streamStart.current = { version: committed?.version };
+    const showPartial = props.partial !== undefined &&
+        (streamStart.current === null || committed?.version === streamStart.current.version);
+    const format = props.format ?? committed?.format;
+    const partialContent = useMemo(() => (showPartial && format ? previewContent(ctx, format, props.partial) : undefined), [ctx, format, props.partial, showPartial]);
+    const themeId = committed?.themeId ?? props.themeId;
+    const locale = committed?.locale ?? props.locale ?? ctx.locale;
+    const mode = props.mode ?? 'screen';
+    const rootClass = cx('ak-root ak-view', props.className);
+    const attrs = rootAttributes(ctx, themeId);
+    if (showPartial) {
+        return (_jsxs("div", { className: rootClass, ...attrs, "data-provisional": "true", lang: locale, "aria-busy": "true", children: [_jsx("span", { ...slot(props.slots, 'badge', 'ak-badge ak-view-badge'), "data-variant": "provisional", role: "status", children: t('provisional') }), partialContent === undefined || !format ? (_jsx(Loading, { label: t('generating'), ...slot(props.slots, 'loading', '') })) : (_jsx("div", { ...slot(props.slots, 'body', 'ak-view-body'), children: _jsx(FormatRenderer, { format: format, content: partialContent, ctx: renderContext(ctx, themeId, locale, mode, true) }) }))] }));
+    }
+    if (!committed) {
+        return (_jsx("div", { className: rootClass, ...attrs, children: loaded.error ? (_jsx(ErrorMessage, { error: loaded.error, onRetry: () => void loaded.refresh().catch(() => undefined), ...slot(props.slots, 'error', '') })) : (_jsx(Loading, { ...slot(props.slots, 'loading', '') })) }));
+    }
+    return (_jsx("div", { className: rootClass, ...attrs, lang: committed.locale, "data-format": committed.format, "data-version": committed.version, children: _jsx("div", { ...slot(props.slots, 'body', 'ak-view-body'), children: _jsx(FormatRenderer, { format: committed.format, content: committed.content, ctx: renderContext(ctx, themeId, locale, mode, false) }) }) }));
+}
+/** Lazy kind renderer with a JSON fallback when the kind has no renderer loader. */
+export function FormatRenderer(props) {
+    const ctx = useArtkit();
+    if (!ctx.hasRenderer(props.format)) {
+        return (_jsxs("div", { className: props.className, children: [_jsx("p", { className: "ak-notice", children: ctx.t('noRenderer', { format: props.format }) }), _jsx("pre", { className: "ak-code", children: _jsx("code", { children: JSON.stringify(props.content, null, 2) }) })] }));
+    }
+    return (_jsx(ErrorBoundary, { onReset: () => ctx.resetLoad('renderer', props.format), fallback: (error, reset) => _jsx(ErrorMessage, { error: error, onRetry: reset }), children: _jsx(Suspense, { fallback: _jsx(Loading, {}), children: _jsx(LoadedRenderer, { ...props }) }) }));
+}
+function LoadedRenderer({ format, content, ctx: renderCtx, className }) {
+    const ctx = useArtkit();
+    const { Renderer, css } = use(ctx.loadRenderer(format));
+    return (_jsxs(_Fragment, { children: [css ? (_jsx("style", { href: `artkit-kind-${format}-${hashString(css)}`, precedence: "artkit", nonce: ctx.nonce, children: css })) : null, _jsx(Renderer, { content: content, ctx: renderCtx, ...(className ? { className } : {}) })] }));
+}
+//# sourceMappingURL=view.js.map

package/dist/components/view.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,64 @@
+import type { AnyArtifactExporter, ArtifactRegistry, AssetResolver, EditorBindings, RenderContext, Theme } from '@artkit-ai/core';
+import { type ComponentType } from 'react';
+import type { ArtifactCache } from './cache.js';
+import type { ArtifactClient } from './client.js';
+import type { Translate } from './i18n.js';
+export interface RendererProps<Content = unknown> {
+    content: Content;
+    ctx: RenderContext;
+    className?: string;
+}
+/** What a kind's `/react` entry provides. */
+export interface RendererModule {
+    Renderer: ComponentType<RendererProps<any>>;
+    css?: string;
+}
+/** What a kind's `/edit` entry provides. */
+export interface EditorModule {
+    Editor: ComponentType<EditorBindings<any, any>>;
+    css?: string;
+    /**
+     * Who draws the undo, redo and save controls. `host` (default): the editor host shows them above the format editor.
+     * `format`: the format editor receives `actions` and draws them inside its own toolbar.
+     */
+    toolbar?: 'host' | 'format';
+}
+/**
+ * Lazy loaders per format, so the bundle only pulls what is shown (spec §13.6). Typical use:
+ * `renderers: { document: () => import('@artkit-ai/kind-document/react').then((m) => ({ Renderer: m.DocumentRenderer, css: m.documentCss })) }`.
+ */
+export interface ArtifactLoaders {
+    renderers?: Record<string, () => Promise<RendererModule>>;
+    editors?: Record<string, () => Promise<EditorModule>>;
+    exporters?: Record<string, () => Promise<AnyArtifactExporter[]>>;
+}
+export type ColorScheme = 'light' | 'dark' | 'system';
+export interface ArtkitContextValue {
+    registry: ArtifactRegistry;
+    client: ArtifactClient;
+    cache: ArtifactCache;
+    locale: string;
+    t: Translate;
+    appTheme: Theme;
+    colorScheme: ColorScheme;
+    /** Theme of an artifact: provider themes, then registry themes, then the application theme. */
+    themeFor(themeId: string | undefined): Theme;
+    resolveAssetUrl?: (ref: string) => string | undefined;
+    assets?: AssetResolver;
+    /** Formats the server can export, per format. */
+    exportFormats: Record<string, readonly string[]>;
+    hasRenderer(format: string): boolean;
+    hasEditor(format: string): boolean;
+    hasExporters(format: string): boolean;
+    loadRenderer(format: string): Promise<RendererModule>;
+    loadEditor(format: string): Promise<EditorModule>;
+    loadExporters(format: string): Promise<AnyArtifactExporter[]>;
+    /** Forgets a failed load so it can be retried. */
+    resetLoad(type: 'renderer' | 'editor' | 'exporters', format: string): void;
+    nonce?: string;
+}
+export declare const ArtkitContext: import("react").Context<ArtkitContextValue | null>;
+/** The artkit context, or null outside `<ArtifactProvider>` (for components that also work standalone). */
+export declare function useOptionalArtkit(): ArtkitContextValue | null;
+export declare function useArtkit(): ArtkitContextValue;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,aAAa,EACb,KAAK,EACN,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,aAAa,EAA6B,MAAM,OAAO,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,WAAW,aAAa,CAAC,OAAO,GAAG,OAAO;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,aAAa,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAE7B,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAE3B,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;CAClE;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,SAAS,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;IAC7C,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACtD,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACjD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACtD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAClD,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC9D,kDAAkD;IAClD,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,aAAa,oDAAiD,CAAC;AAE5E,2GAA2G;AAC3G,wBAAgB,iBAAiB,IAAI,kBAAkB,GAAG,IAAI,CAE7D;AAED,wBAAgB,SAAS,IAAI,kBAAkB,CAI9C"}

package/dist/context.js

@@ -0,0 +1,13 @@
+import { createContext, useContext } from 'react';
+export const ArtkitContext = createContext(null);
+/** The artkit context, or null outside `<ArtifactProvider>` (for components that also work standalone). */
+export function useOptionalArtkit() {
+    return useContext(ArtkitContext);
+}
+export function useArtkit() {
+    const value = useContext(ArtkitContext);
+    if (!value)
+        throw new Error('artkit components and hooks must be rendered inside <ArtifactProvider>.');
+    return value;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsB,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAmEtE,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAA4B,IAAI,CAAC,CAAC;AAE5E,2GAA2G;AAC3G,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,CAAC,aAAa,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,KAAK,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IACvG,OAAO,KAAK,CAAC;AACf,CAAC"}