@artkit-ai/react 0.0.0-stage → 0.2.0

package/dist/toolbar.js

@@ -0,0 +1,233 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { COLOR_TOKENS } from '@artkit-ai/core';
+import { Check, ChevronDown, X } from 'lucide-react';
+import { useCallback, useEffect, useId, useRef, useState, } from 'react';
+/*
+ * Standard editor toolbar shared by every kind editor (document, sheet, slides, diagram) so all of them
+ * look and behave the same: icon buttons with tooltips and shortcuts, grouped with dividers, selects,
+ * dropdown menus and theme color palettes. Keyboard model follows the WAI-ARIA toolbar pattern: one tab
+ * stop, arrows/Home/End move between controls, menus open with Enter/Space/ArrowDown and close with Escape.
+ */
+const ITEM = '[data-ak-tb-item]:not([disabled])';
+function cx(...classes) {
+    return classes.filter(Boolean).join(' ');
+}
+/** Keeps the editor selection (text, cells) when a toolbar control is clicked with the mouse. */
+function keepSelection(event) {
+    event.preventDefault();
+}
+export function Toolbar({ label, children, className, sticky = true }) {
+    const ref = useRef(null);
+    // Roving tab index: only the active control is tabbable.
+    const sync = useCallback((focusIndex) => {
+        const items = [...(ref.current?.querySelectorAll(ITEM) ?? [])].filter((item) => !item.closest('[data-ak-tb-popover]'));
+        const active = focusIndex ?? Math.max(0, items.indexOf(document.activeElement));
+        items.forEach((item, index) => {
+            item.tabIndex = index === active ? 0 : -1;
+        });
+        return items;
+    }, []);
+    useEffect(() => {
+        sync(0);
+    });
+    const onKeyDown = (event) => {
+        if (event.target.closest('[data-ak-tb-popover]'))
+            return;
+        if (event.target.tagName === 'SELECT' &&
+            (event.key === 'ArrowUp' || event.key === 'ArrowDown'))
+            return;
+        const items = sync();
+        const current = items.indexOf(event.target);
+        if (current < 0)
+            return;
+        let next = -1;
+        if (event.key === 'ArrowRight')
+            next = (current + 1) % items.length;
+        else if (event.key === 'ArrowLeft')
+            next = (current - 1 + items.length) % items.length;
+        else if (event.key === 'Home')
+            next = 0;
+        else if (event.key === 'End')
+            next = items.length - 1;
+        if (next < 0)
+            return;
+        event.preventDefault();
+        sync(next);
+        items[next]?.focus();
+    };
+    return (_jsx("div", { ref: ref, role: "toolbar", "aria-label": label, className: cx('ak-tb', sticky && 'ak-tb--sticky', className), onKeyDown: onKeyDown, onFocus: (event) => {
+            if (event.target.matches(ITEM))
+                sync([...sync()].indexOf(event.target));
+        }, children: children }));
+}
+export function ToolbarGroup({ label, children }) {
+    return (_jsxs("fieldset", { className: "ak-tb-group", children: [label ? _jsx("legend", { className: "ak-tb-sr-only", children: label }) : null, children] }));
+}
+export function ToolbarSpacer() {
+    return _jsx("span", { className: "ak-tb-spacer", "aria-hidden": "true" });
+}
+function tooltip(label, shortcut) {
+    return shortcut ? `${label} (${shortcut})` : label;
+}
+export function ToolbarButton({ icon: Icon, label, onClick, pressed, disabled, shortcut, showLabel, variant = 'default', keepFocus = true, }) {
+    return (_jsxs("button", { type: "button", "data-ak-tb-item": "", className: cx('ak-tb-button', (showLabel || !Icon) && 'ak-tb-button--text'), "data-variant": variant === 'default' ? undefined : variant, "aria-label": showLabel ? undefined : label, title: tooltip(label, shortcut), "aria-pressed": pressed, "aria-keyshortcuts": shortcut?.replace(/Ctrl/g, 'Control'), disabled: disabled, onMouseDown: keepFocus ? keepSelection : undefined, onClick: onClick, children: [Icon ? _jsx(Icon, { "aria-hidden": "true" }) : null, showLabel || !Icon ? _jsx("span", { children: label }) : null] }));
+}
+export function ToolbarSelect({ label, value, options, onChange, disabled, width, }) {
+    return (_jsx("select", { "data-ak-tb-item": "", className: "ak-tb-select", "aria-label": label, title: label, value: value, disabled: disabled, style: width ? { width } : undefined, onChange: (event) => onChange(event.target.value), children: options.map((option) => (_jsx("option", { value: option.value, children: option.label }, option.value))) }));
+}
+/** Popover anchored under a toolbar trigger; closes on Escape, outside click and selection. */
+function usePopover() {
+    const [open, setOpen] = useState(false);
+    const root = useRef(null);
+    const trigger = useRef(null);
+    useEffect(() => {
+        if (!open)
+            return;
+        const onDown = (event) => {
+            if (!root.current?.contains(event.target))
+                setOpen(false);
+        };
+        document.addEventListener('mousedown', onDown);
+        return () => document.removeEventListener('mousedown', onDown);
+    }, [open]);
+    const close = (refocus = true) => {
+        setOpen(false);
+        if (refocus)
+            trigger.current?.focus();
+    };
+    return { open, setOpen, root, trigger, close };
+}
+function focusItems(container, index) {
+    const items = [...(container?.querySelectorAll('[role^="menuitem"]:not([disabled])') ?? [])];
+    if (items.length === 0)
+        return;
+    const target = index === 'first' ? 0 : index === 'last' ? items.length - 1 : (index + items.length) % items.length;
+    items[target]?.focus();
+}
+function menuKeys(event, close) {
+    const items = [...event.currentTarget.querySelectorAll('[role^="menuitem"]:not([disabled])')];
+    const current = items.indexOf(document.activeElement);
+    const columns = Number(event.currentTarget.dataset.columns ?? 1);
+    const step = {
+        ArrowDown: columns,
+        ArrowUp: -columns,
+        ArrowRight: columns > 1 ? 1 : 0,
+        ArrowLeft: columns > 1 ? -1 : 0,
+    }[event.key];
+    if (event.key === 'Escape') {
+        event.preventDefault();
+        event.stopPropagation();
+        close();
+    }
+    else if (step) {
+        event.preventDefault();
+        focusItems(event.currentTarget, current + step);
+    }
+    else if (event.key === 'Home' || event.key === 'End') {
+        event.preventDefault();
+        focusItems(event.currentTarget, event.key === 'Home' ? 'first' : 'last');
+    }
+}
+export function ToolbarMenu({ icon: Icon, label, items, disabled, showLabel, keepFocus = true, }) {
+    const { open, setOpen, root, trigger, close } = usePopover();
+    const list = useRef(null);
+    const id = useId();
+    useEffect(() => {
+        if (open)
+            focusItems(list.current, 'first');
+    }, [open]);
+    const hasChecks = items.some((item) => item !== 'separator' && item.checked !== undefined);
+    return (_jsxs("span", { ref: root, className: "ak-tb-anchor", children: [_jsxs("button", { ref: trigger, type: "button", "data-ak-tb-item": "", className: cx('ak-tb-button', 'ak-tb-button--menu', (showLabel || !Icon) && 'ak-tb-button--text'), "aria-label": showLabel ? undefined : label, title: label, "aria-haspopup": "menu", "aria-expanded": open, "aria-controls": open ? id : undefined, disabled: disabled, onMouseDown: keepFocus ? keepSelection : undefined, onClick: () => setOpen(!open), onKeyDown: (event) => {
+                    if (event.key === 'ArrowDown' && !open) {
+                        event.preventDefault();
+                        setOpen(true);
+                    }
+                }, children: [Icon ? _jsx(Icon, { "aria-hidden": "true" }) : null, showLabel || !Icon ? _jsx("span", { children: label }) : null, _jsx(ChevronDown, { "aria-hidden": "true", className: "ak-tb-caret" })] }), open ? (_jsx("div", { ref: list, id: id, role: "menu", "aria-label": label, className: "ak-tb-popover", "data-ak-tb-popover": "", onKeyDown: (event) => menuKeys(event, () => close()), children: items.map((item, index) => item === 'separator' ? (_jsx("hr", { className: "ak-tb-separator" }, `sep-${index}`)) : (_jsxs("button", { type: "button", ...(item.checked === undefined
+                        ? { role: 'menuitem' }
+                        : { role: 'menuitemradio', 'aria-checked': item.checked }), tabIndex: -1, className: "ak-tb-menu-item", "data-danger": item.danger ? '' : undefined, disabled: item.disabled, onMouseDown: keepFocus ? keepSelection : undefined, onClick: () => {
+                        close(!keepFocus);
+                        item.onSelect();
+                    }, children: [hasChecks ? (_jsx("span", { className: "ak-tb-check", "aria-hidden": "true", children: item.checked ? _jsx(Check, {}) : null })) : null, item.icon ? _jsx(item.icon, { "aria-hidden": "true" }) : null, _jsx("span", { className: "ak-tb-menu-label", children: item.label }), item.shortcut ? _jsx("kbd", { className: "ak-tb-kbd", children: item.shortcut }) : null] }, item.key))) })) : null] }));
+}
+/** Swatches for the theme color tokens (labels in pt-BR or English). */
+export function themeSwatches(theme, locale = 'en') {
+    const pt = locale.toLowerCase().startsWith('pt');
+    const names = {
+        text: ['Text', 'Texto'],
+        muted: ['Muted', 'Suave'],
+        accent: ['Accent', 'Destaque'],
+        background: ['Background', 'Fundo'],
+        surface: ['Surface', 'Superfície'],
+        info: ['Info', 'Informação'],
+        warning: ['Warning', 'Atenção'],
+        success: ['Success', 'Sucesso'],
+        danger: ['Danger', 'Perigo'],
+    };
+    return COLOR_TOKENS.map((token) => ({
+        value: token,
+        label: names[token][pt ? 1 : 0],
+        swatch: theme.colors[token],
+    }));
+}
+export function ToolbarColor({ icon: Icon, label, value, colors, onChange, noneLabel, disabled, keepFocus = true, }) {
+    const { open, setOpen, root, trigger, close } = usePopover();
+    const grid = useRef(null);
+    const id = useId();
+    const current = colors.find((color) => color.value === value);
+    useEffect(() => {
+        if (open)
+            focusItems(grid.current, 'first');
+    }, [open]);
+    return (_jsxs("span", { ref: root, className: "ak-tb-anchor", children: [_jsxs("button", { ref: trigger, type: "button", "data-ak-tb-item": "", className: "ak-tb-button ak-tb-button--menu ak-tb-button--color", "aria-label": `${label}${current ? `: ${current.label}` : ''}`, title: label, "aria-haspopup": "menu", "aria-expanded": open, "aria-controls": open ? id : undefined, disabled: disabled, onMouseDown: keepFocus ? keepSelection : undefined, onClick: () => setOpen(!open), children: [_jsxs("span", { className: "ak-tb-color-icon", children: [_jsx(Icon, { "aria-hidden": "true" }), _jsx("span", { className: "ak-tb-color-bar", style: { background: current?.swatch ?? 'transparent' } })] }), _jsx(ChevronDown, { "aria-hidden": "true", className: "ak-tb-caret" })] }), open ? (_jsxs("div", { ref: grid, id: id, role: "menu", "aria-label": label, className: "ak-tb-popover ak-tb-palette", "data-ak-tb-popover": "", "data-columns": "5", onKeyDown: (event) => menuKeys(event, () => close()), children: [colors.map((color) => (_jsx("button", { type: "button", role: "menuitemradio", "aria-checked": color.value === value, "aria-label": color.label, title: color.label, tabIndex: -1, className: "ak-tb-swatch", style: { background: color.swatch }, onMouseDown: keepFocus ? keepSelection : undefined, onClick: () => {
+                            close(!keepFocus);
+                            onChange(color.value);
+                        } }, color.value))), noneLabel ? (_jsxs("button", { type: "button", role: "menuitemradio", "aria-checked": !value, tabIndex: -1, className: "ak-tb-menu-item ak-tb-palette-none", onMouseDown: keepFocus ? keepSelection : undefined, onClick: () => {
+                            close(!keepFocus);
+                            onChange(null);
+                        }, children: [_jsx(X, { "aria-hidden": "true" }), _jsx("span", { className: "ak-tb-menu-label", children: noneLabel })] })) : null] })) : null] }));
+}
+/** Toolbar styles (Mouts design system); embedded in `artkitCss` and in every kind editor CSS. */
+export const toolbarCss = `
+.ak-tb{display:flex;flex-wrap:wrap;align-items:center;gap:4px;padding:6px;background:var(--ak-color-background,#fff);color:var(--ak-color-text,#1d2f3c);border:1px solid var(--ak-color-border,#dde0e2);border-radius:var(--ak-radius-md,8px);font-family:var(--ak-font-body,"Sora",system-ui,sans-serif);font-size:13px;line-height:1}
+.ak-tb--sticky{position:sticky;top:0;z-index:5}
+.ak-tb-group{display:inline-flex;align-items:center;gap:2px;margin:0;padding:0 0 0 6px;border:0;border-left:1px solid var(--ak-color-border,#dde0e2);min-inline-size:0}
+.ak-tb-group:first-child{padding-left:0;border-left:0}
+.ak-tb-spacer{flex:1}
+.ak-tb-sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap;border:0}
+.ak-tb-button{display:inline-flex;align-items:center;justify-content:center;gap:6px;min-width:32px;height:32px;padding:0 6px;border:1px solid transparent;border-radius:var(--ak-radius-sm,6px);background:none;color:var(--ak-color-muted,#56636d);font:inherit;font-weight:600;cursor:pointer;white-space:nowrap;transition:background-color .15s,color .15s,border-color .15s}
+.ak-tb-button svg{width:16px;height:16px;flex-shrink:0}
+.ak-tb-button--text{padding:0 10px;color:var(--ak-color-text,#1d2f3c)}
+.ak-tb-button:hover:not(:disabled){background:var(--ak-color-hover,#f2f3f4);color:var(--ak-color-text,#1d2f3c)}
+.ak-tb-button:active:not(:disabled){background:var(--ak-color-active,#e8eaec)}
+.ak-tb-button[aria-pressed="true"],.ak-tb-button[aria-expanded="true"]{background:var(--ak-color-fill-accent,#e7f2ef);color:var(--ak-color-accent,#0f7a5a);border-color:var(--ak-color-accent,#0f7a5a)}
+.ak-tb-button[data-variant="primary"]{background:var(--ak-gradient-button);color:var(--ak-color-on-primary,#1d2f3c);border-color:transparent}
+.ak-tb-button[data-variant="primary"]:hover:not(:disabled){background:var(--ak-gradient-button-hover)}
+.ak-tb-button[data-variant="danger"]{color:var(--ak-color-danger,#9f343a)}
+.ak-tb-button[data-variant="danger"]:hover:not(:disabled){background:var(--ak-color-fill-danger,#f5ebeb)}
+.ak-tb-button:disabled,.ak-tb-select:disabled{opacity:.4;cursor:not-allowed}
+.ak-tb-button:focus-visible,.ak-tb-select:focus-visible,.ak-tb-menu-item:focus-visible,.ak-tb-swatch:focus-visible{outline:2px solid var(--ak-color-focus,#0f7a5a);outline-offset:2px}
+.ak-tb-button--menu{padding:0 4px 0 6px;gap:2px}
+.ak-tb-button--menu.ak-tb-button--text{padding:0 6px 0 10px}
+.ak-tb-button .ak-tb-caret{width:12px;height:12px;opacity:.7}
+.ak-tb-color-icon{position:relative;display:inline-flex;flex-direction:column;align-items:center;gap:1px}
+.ak-tb-color-bar{display:block;width:16px;height:3px;border-radius:2px;border:1px solid var(--ak-color-border,#dde0e2)}
+.ak-tb-select{height:32px;max-width:200px;padding:0 8px;font:inherit;font-size:13px;color:var(--ak-color-text,#1d2f3c);background:var(--ak-color-background,#fff);border:1px solid var(--ak-color-border-strong,#8e979d);border-radius:var(--ak-radius-sm,6px);cursor:pointer}
+.ak-tb-anchor{position:relative;display:inline-flex}
+.ak-tb-popover{position:absolute;top:calc(100% + 4px);left:0;z-index:30;display:flex;flex-direction:column;min-width:200px;max-height:360px;overflow:auto;padding:4px;background:var(--ak-color-background,#fff);border:1px solid var(--ak-color-border-strong,#8e979d);border-radius:var(--ak-radius-md,8px)}
+.ak-tb-menu-item{display:flex;align-items:center;gap:8px;width:100%;min-height:32px;padding:0 10px;border:0;border-radius:var(--ak-radius-sm,6px);background:none;color:var(--ak-color-text,#1d2f3c);font:inherit;font-size:13px;text-align:left;cursor:pointer}
+.ak-tb-menu-item svg{width:16px;height:16px;flex-shrink:0;color:var(--ak-color-muted,#56636d)}
+.ak-tb-menu-item:hover:not(:disabled),.ak-tb-menu-item:focus{background:var(--ak-color-hover,#f2f3f4)}
+.ak-tb-menu-item:disabled{opacity:.4;cursor:not-allowed}
+.ak-tb-menu-item[data-danger]{color:var(--ak-color-danger,#9f343a)}
+.ak-tb-menu-item[aria-checked="true"]{color:var(--ak-color-accent,#0f7a5a);font-weight:600}
+.ak-tb-menu-label{flex:1}
+.ak-tb-check{display:inline-flex;width:16px}
+.ak-tb-check svg{color:var(--ak-color-accent,#0f7a5a)}
+.ak-tb-kbd{font-family:var(--ak-font-mono,ui-monospace,monospace);font-size:11px;color:var(--ak-color-muted,#56636d)}
+.ak-tb-separator{width:100%;height:1px;margin:4px 0;border:0;background:var(--ak-color-border,#dde0e2)}
+.ak-tb-palette{display:grid;grid-template-columns:repeat(5,28px);gap:6px;min-width:0;padding:8px}
+.ak-tb-swatch{width:28px;height:28px;padding:0;border:1px solid var(--ak-color-border-strong,#8e979d);border-radius:var(--ak-radius-sm,6px);cursor:pointer}
+.ak-tb-swatch[aria-checked="true"]{box-shadow:inset 0 0 0 2px var(--ak-color-background,#fff);border:2px solid var(--ak-color-accent,#0f7a5a)}
+.ak-tb-palette-none{grid-column:1/-1}
+`;
+//# sourceMappingURL=toolbar.js.map

package/dist/toolbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.js","sourceRoot":"","sources":["../src/toolbar.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAA+B,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,KAAK,EAAE,WAAW,EAAmB,CAAC,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAIL,WAAW,EACX,SAAS,EACT,KAAK,EACL,MAAM,EACN,QAAQ,GACT,MAAM,OAAO,CAAC;AAEf;;;;;GAKG;AAEH,MAAM,IAAI,GAAG,mCAAmC,CAAC;AAEjD,SAAS,EAAE,CAAC,GAAG,OAA8C;IAC3D,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,iGAAiG;AACjG,SAAS,aAAa,CAAC,KAAiB;IACtC,KAAK,CAAC,cAAc,EAAE,CAAC;AACzB,CAAC;AAUD,MAAM,UAAU,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAgB;IACjF,MAAM,GAAG,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IACzC,yDAAyD;IACzD,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,UAAmB,EAAE,EAAE;QAC/C,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAc,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAChF,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAChD,CAAC;QACF,MAAM,MAAM,GAAG,UAAU,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,aAA4B,CAAC,CAAC,CAAC;QAC/F,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC5B,IAAI,CAAC,QAAQ,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QACH,OAAO,KAAK,CAAC;IACf,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,CAAC,CAAC,CAAC;IACV,CAAC,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,CAAC,KAAoC,EAAE,EAAE;QACzD,IAAK,KAAK,CAAC,MAAsB,CAAC,OAAO,CAAC,sBAAsB,CAAC;YAAE,OAAO;QAC1E,IACG,KAAK,CAAC,MAAsB,CAAC,OAAO,KAAK,QAAQ;YAClD,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,WAAW,CAAC;YAEtD,OAAO;QACT,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAqB,CAAC,CAAC;QAC3D,IAAI,OAAO,GAAG,CAAC;YAAE,OAAO;QACxB,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;QACd,IAAI,KAAK,CAAC,GAAG,KAAK,YAAY;YAAE,IAAI,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;aAC/D,IAAI,KAAK,CAAC,GAAG,KAAK,WAAW;YAAE,IAAI,GAAG,CAAC,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;aAClF,IAAI,KAAK,CAAC,GAAG,KAAK,MAAM;YAAE,IAAI,GAAG,CAAC,CAAC;aACnC,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK;YAAE,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACtD,IAAI,IAAI,GAAG,CAAC;YAAE,OAAO;QACrB,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,CAAC;QACX,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;IACvB,CAAC,CAAC;IACF,OAAO,CACL,cACE,GAAG,EAAE,GAAG,EACR,IAAI,EAAC,SAAS,gBACF,KAAK,EACjB,SAAS,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,SAAS,CAAC,EAC5D,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,IAAK,KAAK,CAAC,MAAsB,CAAC,OAAO,CAAC,IAAI,CAAC;gBAC7C,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAqB,CAAC,CAAC,CAAC;QAC3D,CAAC,YAEA,QAAQ,GACL,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAE,KAAK,EAAE,QAAQ,EAA2C;IACvF,OAAO,CACL,oBAAU,SAAS,EAAC,aAAa,aAC9B,KAAK,CAAC,CAAC,CAAC,iBAAQ,SAAS,EAAC,eAAe,YAAE,KAAK,GAAU,CAAC,CAAC,CAAC,IAAI,EACjE,QAAQ,IACA,CACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,eAAM,SAAS,EAAC,cAAc,iBAAa,MAAM,GAAG,CAAC;AAC9D,CAAC;AAED,SAAS,OAAO,CAAC,KAAa,EAAE,QAAiB;IAC/C,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,QAAQ,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AACrD,CAAC;AAkBD,MAAM,UAAU,aAAa,CAAC,EAC5B,IAAI,EAAE,IAAI,EACV,KAAK,EACL,OAAO,EACP,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,OAAO,GAAG,SAAS,EACnB,SAAS,GAAG,IAAI,GACG;IACnB,OAAO,CACL,kBACE,IAAI,EAAC,QAAQ,qBACG,EAAE,EAClB,SAAS,EAAE,EAAE,CAAC,cAAc,EAAE,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,kBAC7D,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,gBAC7C,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EACzC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,kBACjB,OAAO,uBACF,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,EACxD,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,EAClD,OAAO,EAAE,OAAO,aAEf,IAAI,CAAC,CAAC,CAAC,KAAC,IAAI,mBAAa,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EACzC,SAAS,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,yBAAO,KAAK,GAAQ,CAAC,CAAC,CAAC,IAAI,IAC1C,CACV,CAAC;AACJ,CAAC;AAiBD,MAAM,UAAU,aAAa,CAAmB,EAC9C,KAAK,EACL,KAAK,EACL,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,KAAK,GACiB;IACtB,OAAO,CACL,oCACkB,EAAE,EAClB,SAAS,EAAC,cAAc,gBACZ,KAAK,EACjB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,EACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,KAAU,CAAC,YAErD,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACvB,iBAA2B,KAAK,EAAE,MAAM,CAAC,KAAK,YAC3C,MAAM,CAAC,KAAK,IADF,MAAM,CAAC,KAAK,CAEhB,CACV,CAAC,GACK,CACV,CAAC;AACJ,CAAC;AAED,+FAA+F;AAC/F,SAAS,UAAU;IACjB,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,CAAkB,IAAI,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,MAAM,CAAoB,IAAI,CAAC,CAAC;IAChD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,MAAM,MAAM,GAAG,CAAC,KAA4B,EAAE,EAAE;YAC9C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAc,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACpE,CAAC,CAAC;QACF,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC/C,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACX,MAAM,KAAK,GAAG,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;QAC/B,OAAO,CAAC,KAAK,CAAC,CAAC;QACf,IAAI,OAAO;YAAE,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;IACxC,CAAC,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,SAAS,UAAU,CAAC,SAA6B,EAAE,KAAgC;IACjF,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,gBAAgB,CAAc,oCAAoC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1G,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC/B,MAAM,MAAM,GACV,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IACtG,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAiC,EAAE,KAAiB;IACpE,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,gBAAgB,CAAc,oCAAoC,CAAC,CAAC,CAAC;IAC3G,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,aAA4B,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG;QACX,SAAS,EAAE,OAAO;QAClB,OAAO,EAAE,CAAC,OAAO;QACjB,UAAU,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,SAAS,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAChC,CAAC,KAAK,CAAC,GAAkB,CAAC,CAAC;IAC5B,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC3B,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,KAAK,CAAC,eAAe,EAAE,CAAC;QACxB,KAAK,EAAE,CAAC;IACV,CAAC;SAAM,IAAI,IAAI,EAAE,CAAC;QAChB,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,UAAU,CAAC,KAAK,CAAC,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC;IAClD,CAAC;SAAM,IAAI,KAAK,CAAC,GAAG,KAAK,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;QACvD,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,UAAU,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAuBD,MAAM,UAAU,WAAW,CAAC,EAC1B,IAAI,EAAE,IAAI,EACV,KAAK,EACL,KAAK,EACL,QAAQ,EACR,SAAS,EACT,SAAS,GAAG,IAAI,GACC;IACjB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,UAAU,EAAE,CAAC;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAC1C,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,IAAI;YAAE,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACX,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC;IAC3F,OAAO,CACL,gBAAM,GAAG,EAAE,IAAI,EAAE,SAAS,EAAC,cAAc,aACvC,kBACE,GAAG,EAAE,OAAO,EACZ,IAAI,EAAC,QAAQ,qBACG,EAAE,EAClB,SAAS,EAAE,EAAE,CAAC,cAAc,EAAE,oBAAoB,EAAE,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,gBACrF,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EACzC,KAAK,EAAE,KAAK,mBACE,MAAM,mBACL,IAAI,mBACJ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EACpC,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,EAClD,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAC7B,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;oBACnB,IAAI,KAAK,CAAC,GAAG,KAAK,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC;wBACvC,KAAK,CAAC,cAAc,EAAE,CAAC;wBACvB,OAAO,CAAC,IAAI,CAAC,CAAC;oBAChB,CAAC;gBACH,CAAC,aAEA,IAAI,CAAC,CAAC,CAAC,KAAC,IAAI,mBAAa,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EACzC,SAAS,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,yBAAO,KAAK,GAAQ,CAAC,CAAC,CAAC,IAAI,EACjD,KAAC,WAAW,mBAAa,MAAM,EAAC,SAAS,EAAC,aAAa,GAAG,IACnD,EACR,IAAI,CAAC,CAAC,CAAC,CACN,cACE,GAAG,EAAE,IAAI,EACT,EAAE,EAAE,EAAE,EACN,IAAI,EAAC,MAAM,gBACC,KAAK,EACjB,SAAS,EAAC,eAAe,wBACN,EAAE,EACrB,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,YAEnD,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACzB,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,CAErB,aAAyB,SAAS,EAAC,iBAAiB,IAA3C,OAAO,KAAK,EAAE,CAAgC,CACxD,CAAC,CAAC,CAAC,CACF,kBAEE,IAAI,EAAC,QAAQ,KACT,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS;wBAC7B,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE;wBACtB,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,cAAc,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,EAC5D,QAAQ,EAAE,CAAC,CAAC,EACZ,SAAS,EAAC,iBAAiB,iBACd,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EACzC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EACvB,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,EAClD,OAAO,EAAE,GAAG,EAAE;wBACZ,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC;wBAClB,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAClB,CAAC,aAEA,SAAS,CAAC,CAAC,CAAC,CACX,eAAM,SAAS,EAAC,aAAa,iBAAa,MAAM,YAC7C,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAC,KAAK,KAAG,CAAC,CAAC,CAAC,IAAI,GAC3B,CACR,CAAC,CAAC,CAAC,IAAI,EACP,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAC,IAAI,CAAC,IAAI,mBAAa,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EACpD,eAAM,SAAS,EAAC,kBAAkB,YAAE,IAAI,CAAC,KAAK,GAAQ,EACrD,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAK,SAAS,EAAC,WAAW,YAAE,IAAI,CAAC,QAAQ,GAAO,CAAC,CAAC,CAAC,IAAI,KAtBnE,IAAI,CAAC,GAAG,CAuBN,CACV,CACF,GACG,CACP,CAAC,CAAC,CAAC,IAAI,IACH,CACR,CAAC;AACJ,CAAC;AAUD,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAAC,KAAY,EAAE,MAAM,GAAG,IAAI;IACvD,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,KAAK,GAAyC;QAClD,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;QACvB,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;QACzB,MAAM,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;QAC9B,UAAU,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC;QACnC,OAAO,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC;QAClC,IAAI,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC;QAC5B,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;QAC/B,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;QAC/B,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;KAC7B,CAAC;IACF,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAClC,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;KAC5B,CAAC,CAAC,CAAC;AACN,CAAC;AAcD,MAAM,UAAU,YAAY,CAAC,EAC3B,IAAI,EAAE,IAAI,EACV,KAAK,EACL,KAAK,EACL,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,SAAS,GAAG,IAAI,GACE;IAClB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,UAAU,EAAE,CAAC;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAC1C,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IAC9D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,IAAI;YAAE,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACX,OAAO,CACL,gBAAM,GAAG,EAAE,IAAI,EAAE,SAAS,EAAC,cAAc,aACvC,kBACE,GAAG,EAAE,OAAO,EACZ,IAAI,EAAC,QAAQ,qBACG,EAAE,EAClB,SAAS,EAAC,qDAAqD,gBACnD,GAAG,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAC5D,KAAK,EAAE,KAAK,mBACE,MAAM,mBACL,IAAI,mBACJ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EACpC,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,EAClD,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,aAE7B,gBAAM,SAAS,EAAC,kBAAkB,aAChC,KAAC,IAAI,mBAAa,MAAM,GAAG,EAC3B,eAAM,SAAS,EAAC,iBAAiB,EAAC,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,GAAI,IACxF,EACP,KAAC,WAAW,mBAAa,MAAM,EAAC,SAAS,EAAC,aAAa,GAAG,IACnD,EACR,IAAI,CAAC,CAAC,CAAC,CACN,eACE,GAAG,EAAE,IAAI,EACT,EAAE,EAAE,EAAE,EACN,IAAI,EAAC,MAAM,gBACC,KAAK,EACjB,SAAS,EAAC,6BAA6B,wBACpB,EAAE,kBACR,GAAG,EAChB,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,aAEnD,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CACrB,iBAEE,IAAI,EAAC,QAAQ,EACb,IAAI,EAAC,eAAe,kBACN,KAAK,CAAC,KAAK,KAAK,KAAK,gBACvB,KAAK,CAAC,KAAK,EACvB,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,QAAQ,EAAE,CAAC,CAAC,EACZ,SAAS,EAAC,cAAc,EACxB,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,EACnC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,EAClD,OAAO,EAAE,GAAG,EAAE;4BACZ,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC;4BAClB,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;wBACxB,CAAC,IAbI,KAAK,CAAC,KAAK,CAchB,CACH,CAAC,EACD,SAAS,CAAC,CAAC,CAAC,CACX,kBACE,IAAI,EAAC,QAAQ,EACb,IAAI,EAAC,eAAe,kBACN,CAAC,KAAK,EACpB,QAAQ,EAAE,CAAC,CAAC,EACZ,SAAS,EAAC,oCAAoC,EAC9C,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,EAClD,OAAO,EAAE,GAAG,EAAE;4BACZ,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC;4BAClB,QAAQ,CAAC,IAAI,CAAC,CAAC;wBACjB,CAAC,aAED,KAAC,CAAC,mBAAa,MAAM,GAAG,EACxB,eAAM,SAAS,EAAC,kBAAkB,YAAE,SAAS,GAAQ,IAC9C,CACV,CAAC,CAAC,CAAC,IAAI,IACJ,CACP,CAAC,CAAC,CAAC,IAAI,IACH,CACR,CAAC;AACJ,CAAC;AAED,kGAAkG;AAClG,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CzB,CAAC"}

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@artkit-ai/react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "React host for artkit artifacts: provider, view, editor, panel, card, approval, version diff, hooks and streaming preview.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "keywords": [
+    "artkit",
+    "ai",
+    "agents",
+    "artifacts"
+  ],
+  "exports": {
+    ".": {
+      "@artkit/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gustavonpco/artkit.git",
+    "directory": "packages/react"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "lucide-react": "^1.68.0",
+    "@artkit-ai/core": "^0.2.0"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "zod": "^4.6.7"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  }
 }

package/src/cache.ts

@@ -0,0 +1,109 @@
+import type { Artifact } from '@artkit-ai/core';
+import type { ArtifactClient } from './client.js';
+
+export interface CacheEntry {
+  artifact?: Artifact;
+  error?: unknown;
+  loading: boolean;
+}
+
+const EMPTY: CacheEntry = Object.freeze({ loading: false }) as CacheEntry;
+
+/**
+ * Artifact cache shared by the hooks under one provider (spec §13.2). One entry per artifact: the current content the
+ * application last loaded or saved. The library keeps no older versions, so there is nothing else to cache.
+ */
+export class ArtifactCache {
+  private readonly entries = new Map<string, CacheEntry>();
+  private readonly inflight = new Map<string, Promise<Artifact>>();
+  private readonly listeners = new Map<string, Set<() => void>>();
+
+  constructor(private readonly client: ArtifactClient) {}
+
+  entry(id: string): CacheEntry {
+    return this.entries.get(id) ?? EMPTY;
+  }
+
+  latest(id: string): Artifact | undefined {
+    return this.entries.get(id)?.artifact;
+  }
+
+  subscribe(id: string, listener: () => void): () => void {
+    const set = this.listeners.get(id) ?? new Set();
+    set.add(listener);
+    this.listeners.set(id, set);
+    return () => {
+      set.delete(listener);
+      if (set.size === 0) this.listeners.delete(id);
+    };
+  }
+
+  private notify(id: string): void {
+    for (const listener of [...(this.listeners.get(id) ?? [])]) listener();
+  }
+
+  /**
+   * Records an artifact the application loaded or saved. An older version never replaces a newer one; a newer
+   * `updatedAt` of the same version replaces it.
+   */
+  put(artifact: Artifact): void {
+    const current = this.latest(artifact.id);
+    if (current) {
+      const older = artifact.version < current.version;
+      const sameVersionOlder =
+        artifact.version === current.version && artifact.meta.updatedAt <= current.meta.updatedAt;
+      if (older || sameVersionOlder) return;
+    }
+    this.entries.set(artifact.id, { artifact, loading: false });
+    this.notify(artifact.id);
+  }
+
+  /** Loads the artifact unless it is cached. `force` fetches it again. */
+  load(id: string, force = false): Promise<Artifact> {
+    const existing = this.entries.get(id);
+    if (existing?.artifact && !force) return Promise.resolve(existing.artifact);
+    const pending = this.inflight.get(id);
+    if (pending) return pending;
+    this.entries.set(id, { ...(existing ?? {}), loading: true });
+    this.notify(id);
+    const promise = this.client.get(id).then(
+      (artifact) => {
+        this.inflight.delete(id);
+        // A save may have landed while the request was in flight; never move the cache backwards.
+        const current = this.latest(id);
+        if (current && current.version > artifact.version) {
+          this.entries.set(id, { artifact: current, loading: false });
+          this.notify(id);
+          return current;
+        }
+        this.entries.set(id, { artifact, loading: false });
+        this.notify(id);
+        return artifact;
+      },
+      (error: unknown) => {
+        this.inflight.delete(id);
+        const previous = this.entries.get(id);
+        this.entries.set(id, {
+          ...(previous?.artifact ? { artifact: previous.artifact } : {}),
+          error,
+          loading: false,
+        });
+        this.notify(id);
+        throw error;
+      },
+    );
+    this.inflight.set(id, promise);
+    return promise;
+  }
+}
+
+const caches = new WeakMap<ArtifactClient, ArtifactCache>();
+
+export function cacheFor(client: ArtifactClient): ArtifactCache {
+  let cache = caches.get(client);
+  if (!cache) {
+    cache = new ArtifactCache(client);
+    caches.set(client, cache);
+  }
+  return cache;
+}