glirastes 0.3.2 → 0.5.0

package/dist/embed/glirastes-chat-element.js

@@ -0,0 +1,278 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef } from 'react';
+import { createRoot } from 'react-dom/client';
+import { parseChatInteractions, } from '../contracts/chat-interactions.js';
+import { AiChatPanel } from '../react/components/ai-chat-panel.js';
+import { defineChatCommand, defineChatEntity, } from '../react/interactions/definitions.js';
+import { AiChatProvider } from '../react/provider/ai-chat-provider.js';
+import { useChatContext } from '../react/provider/chat-context.js';
+import { VercelAiChat } from '../react/transports/vercel/vercel-ai-chat.js';
+import { CHAT_STYLES } from './chat-styles.generated.js';
+import { embedThemeCss, isChatThemePreset } from './theme.js';
+export const GLIRASTES_CHAT_TAG = 'glirastes-chat';
+function EmbedBridge({ emit, onSendReady, }) {
+    const { send, mentionEntity, isLoading, error } = useChatContext();
+    const previous = useRef(null);
+    const state = error ? 'error' : isLoading ? 'busy' : 'idle';
+    useEffect(() => {
+        onSendReady({ send: (text) => send(text), mentionEntity });
+        return () => onSendReady(null);
+    }, [send, mentionEntity, onSendReady]);
+    useEffect(() => {
+        emit('glirastes-chat:ready', {});
+    }, [emit]);
+    useEffect(() => {
+        if (previous.current === state)
+            return;
+        previous.current = state;
+        emit('glirastes-chat:status', { state });
+    }, [state, emit]);
+    return null;
+}
+function EmbeddedChat({ endpoint, transport, config, theme, welcomeMessage, emit, onSendReady, }) {
+    const { headers, bodyExtras, onToolResult, ...providerConfig } = config;
+    const shared = {
+        ...providerConfig,
+        // Colours come from the shadow-root CSS (`themeScope: 'inherit'` skips the
+        // inline variables); the preset still drives effects such as glass blur.
+        theme,
+        themeScope: 'inherit',
+        onToolResult: (toolName, result) => {
+            onToolResult?.(toolName, result);
+            emit('glirastes-chat:tool-result', { toolName, result });
+        },
+    };
+    const body = (_jsxs(_Fragment, { children: [_jsx(EmbedBridge, { emit: emit, onSendReady: onSendReady }), _jsx(AiChatPanel, { welcomeMessage: welcomeMessage })] }));
+    if (transport) {
+        return _jsx(AiChatProvider, { transport: transport, ...shared, children: body });
+    }
+    return (_jsx(VercelAiChat, { endpoint: endpoint, headers: headers, bodyExtras: bodyExtras, ...shared, children: body }));
+}
+// Importing on a server (SSR) must not touch DOM globals.
+const BaseElement = (typeof HTMLElement === 'undefined'
+    ? class {
+    }
+    : HTMLElement);
+/**
+ * `<glirastes-chat endpoint="/api/chat">`: the React chat UI inside a Shadow
+ * DOM for Vue, Angular, Svelte or plain HTML hosts.
+ *
+ * Attributes: `endpoint` (required unless `transport` is set), `theme`
+ * (preset name), `placeholder`, `welcome-message`, `voice`, `voice-language`,
+ * `interactions` (load `@` entities and `/` commands with a GET from the
+ * endpoint or the given URL; labels follow the nearest `lang`).
+ * Properties: `config`, `transport`, `interactions`. Methods: `send(text)`,
+ * `defineEntity(definition)`, `defineCommand(definition)`,
+ * `mentionEntity(type, id)`.
+ * Events (bubbling, composed): `glirastes-chat:ready`, `:status`,
+ * `:tool-result`, `:error`. Styling: `--glirastes-chat-*` CSS variables.
+ * Removing the element unmounts React and releases the microphone.
+ */
+export class GlirastesChatElement extends BaseElement {
+    static get observedAttributes() {
+        return ['endpoint', 'theme', 'placeholder', 'welcome-message', 'voice', 'voice-language', 'interactions', 'lang'];
+    }
+    #root = null;
+    #style = null;
+    #config = {};
+    #transport;
+    #api = null;
+    #pendingUnmount = false;
+    #entities = [];
+    #commands = [];
+    #interactions;
+    #interactionsFromProperty = false;
+    #interactionsLoad = null;
+    #emit = (name, detail) => {
+        this.dispatchEvent(new CustomEvent(name, { detail, bubbles: true, composed: true }));
+    };
+    #onSendReady = (api) => {
+        this.#api = api;
+    };
+    get config() {
+        return this.#config;
+    }
+    set config(value) {
+        this.#config = value ?? {};
+        this.#render();
+    }
+    get transport() {
+        return this.#transport;
+    }
+    set transport(value) {
+        this.#transport = value;
+        this.#render();
+    }
+    /** Derived `@` entities and `/` commands, e.g. the generated module's `chatInteractions`. */
+    get interactions() {
+        return this.#interactions;
+    }
+    set interactions(value) {
+        this.#interactionsLoad?.abort();
+        this.#interactions = value ? parseChatInteractions(value) : undefined;
+        this.#interactionsFromProperty = Boolean(value);
+        this.#render();
+    }
+    /** Adds or replaces (same type) an `@` entity; same definition as `defineChatEntity`. */
+    defineEntity(definition) {
+        const entity = defineChatEntity(definition);
+        this.#entities = [...this.#entities.filter((entry) => entry.type !== entity.type), entity];
+        this.#render();
+    }
+    /** Adds or replaces (same id) a `/` command; same definition as `defineChatCommand`. */
+    defineCommand(definition) {
+        const command = defineChatCommand(definition);
+        this.#commands = [...this.#commands.filter((entry) => entry.id !== command.id), command];
+        this.#render();
+    }
+    /** Adds a reference to an entity, resolved by id, to the composer. False before mount or when refused. */
+    async mentionEntity(type, id) {
+        return this.#api ? this.#api.mentionEntity(type, id) : false;
+    }
+    /** Sends a user message through the embedded chat. False before mount. */
+    send(text) {
+        if (!this.#api || !text.trim())
+            return false;
+        return this.#api.send(text);
+    }
+    connectedCallback() {
+        this.#pendingUnmount = false;
+        this.#loadInteractions();
+        if (!this.#root) {
+            const shadow = this.shadowRoot ?? this.attachShadow({ mode: 'open' });
+            const style = document.createElement('style');
+            const mount = document.createElement('div');
+            mount.setAttribute('data-part', 'mount');
+            shadow.replaceChildren(style, mount);
+            this.#style = style;
+            this.#root = createRoot(mount);
+        }
+        this.#render();
+    }
+    disconnectedCallback() {
+        // A move (disconnect + connect in one task) keeps the mounted chat.
+        this.#pendingUnmount = true;
+        queueMicrotask(() => {
+            if (!this.#pendingUnmount || this.isConnected)
+                return;
+            this.#pendingUnmount = false;
+            const root = this.#root;
+            this.#root = null;
+            this.#style = null;
+            this.#api = null;
+            this.#interactionsLoad?.abort();
+            root?.unmount();
+            this.shadowRoot?.replaceChildren();
+        });
+    }
+    attributeChangedCallback(name) {
+        if (name === 'interactions' || name === 'endpoint')
+            this.#loadInteractions();
+        this.#render();
+    }
+    #locale() {
+        const lang = this.closest('[lang]')?.getAttribute('lang') ?? '';
+        return lang.toLowerCase().startsWith('de') ? 'de' : 'en';
+    }
+    /** `interactions` attribute: GET the data from its URL, or from the endpoint when empty. */
+    #loadInteractions() {
+        if (this.#interactionsFromProperty || !this.isConnected)
+            return;
+        this.#interactionsLoad?.abort();
+        this.#interactionsLoad = null;
+        const attribute = this.getAttribute('interactions');
+        const url = attribute === null ? '' : attribute || this.getAttribute('endpoint') || '';
+        if (!url)
+            return;
+        const controller = new AbortController();
+        this.#interactionsLoad = controller;
+        void (async () => {
+            try {
+                const response = await fetch(url, {
+                    method: 'GET',
+                    credentials: 'same-origin',
+                    headers: { accept: 'application/json' },
+                    signal: controller.signal,
+                });
+                if (!response.ok)
+                    throw new Error(`HTTP ${response.status}`);
+                const data = parseChatInteractions(await response.json());
+                if (controller.signal.aborted)
+                    return;
+                this.#interactions = data;
+                this.#render();
+            }
+            catch {
+                if (!controller.signal.aborted)
+                    this.#emit('glirastes-chat:error', { message: 'Chat interactions unavailable' });
+            }
+        })();
+    }
+    #chatInteractions() {
+        const base = this.#config.chatInteractions;
+        const data = this.#interactions ?? base?.data;
+        if (!base && !data && this.#entities.length === 0 && this.#commands.length === 0)
+            return undefined;
+        return {
+            ...base,
+            locale: base?.locale ?? this.#locale(),
+            ...(data ? { data } : {}),
+            entities: [...(base?.entities ?? []), ...this.#entities],
+            commands: [...(base?.commands ?? []), ...this.#commands],
+        };
+    }
+    #render() {
+        if (!this.#root || !this.#style)
+            return;
+        const themeAttribute = this.getAttribute('theme');
+        const theme = isChatThemePreset(themeAttribute) ? themeAttribute : undefined;
+        this.#style.textContent = `${CHAT_STYLES}\n${embedThemeCss(theme)}`;
+        const endpoint = this.getAttribute('endpoint') ?? '';
+        if (!endpoint && !this.#transport) {
+            this.#root.render(null);
+            this.#emit('glirastes-chat:error', { message: 'Missing endpoint attribute' });
+            return;
+        }
+        const placeholder = this.getAttribute('placeholder');
+        const voiceLanguage = this.getAttribute('voice-language');
+        const chatInteractions = this.#chatInteractions();
+        const config = {
+            ...this.#config,
+            ...(chatInteractions ? { chatInteractions } : {}),
+            ...(placeholder
+                ? { locale: { ...(this.#config.locale ?? {}), placeholder } }
+                : {}),
+            ...(this.hasAttribute('voice')
+                ? {
+                    voice: {
+                        ...(this.#config.voice ?? {}),
+                        enabled: true,
+                        ...(voiceLanguage ? { language: voiceLanguage } : {}),
+                    },
+                }
+                : {}),
+        };
+        this.#root.render(_jsx(EmbeddedChat, { endpoint: endpoint, transport: this.#transport, config: config, theme: theme, welcomeMessage: this.getAttribute('welcome-message') ?? undefined, emit: this.#emit, onSendReady: this.#onSendReady }));
+    }
+}
+/**
+ * Registers the element once per tag name and returns its class. Each tag
+ * gets its own subclass, so a page may register several names.
+ */
+export function defineGlirastesChatElement(tagName = GLIRASTES_CHAT_TAG) {
+    if (typeof customElements === 'undefined') {
+        throw new Error('glirastes/embed needs a browser with Custom Elements support');
+    }
+    const existing = customElements.get(tagName);
+    if (existing) {
+        if (!(existing.prototype instanceof GlirastesChatElement)) {
+            throw new Error(`<${tagName}> is already defined by another element`);
+        }
+        return existing;
+    }
+    const ElementClass = class extends GlirastesChatElement {
+    };
+    customElements.define(tagName, ElementClass);
+    return ElementClass;
+}
+//# sourceMappingURL=glirastes-chat-element.js.map

package/dist/embed/glirastes-chat-element.js.map

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

package/dist/embed/index.d.ts

@@ -0,0 +1,4 @@
+export { GLIRASTES_CHAT_TAG, GlirastesChatElement, defineGlirastesChatElement, type GlirastesChatElementConfig, type GlirastesChatEventMap, type GlirastesChatEventName, } from './glirastes-chat-element.js';
+export { EMBED_CSS_VARIABLES, embedThemeCss } from './theme.js';
+export { defineChatCommand, defineChatEntity, type ChatCommandDefinition, type ChatEntityAction, type ChatEntityCard, type ChatEntityDefinition, type ChatEntityItem, type ChatEntitySearchContext, } from '../react/interactions/definitions.js';
+export type { ChatInteractionArg, ChatInteractionsData, ChatLocaleCode, ChatText, } from '../contracts/chat-interactions.js';

package/dist/embed/index.js

@@ -0,0 +1,11 @@
+// ============================================================================
+// glirastes/embed
+//
+// Framework-neutral chat embedding: <glirastes-chat> wraps the React chat UI
+// in a Shadow DOM for non-React hosts (Vue, Angular, Svelte, plain HTML).
+// Peer requirements: react, react-dom, @ai-sdk/react and ai.
+// ============================================================================
+export { GLIRASTES_CHAT_TAG, GlirastesChatElement, defineGlirastesChatElement, } from './glirastes-chat-element.js';
+export { EMBED_CSS_VARIABLES, embedThemeCss } from './theme.js';
+export { defineChatCommand, defineChatEntity, } from '../react/interactions/definitions.js';
+//# sourceMappingURL=index.js.map

package/dist/embed/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/embed/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kBAAkB;AAClB,EAAE;AACF,6EAA6E;AAC7E,0EAA0E;AAC1E,6DAA6D;AAC7D,+EAA+E;AAE/E,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,GAI3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EACL,iBAAiB,EACjB,gBAAgB,GAOjB,MAAM,sCAAsC,CAAC"}

package/dist/embed/theme.d.ts

@@ -0,0 +1,10 @@
+import type { ChatThemePreset } from '../react/types.js';
+/** Public CSS custom properties a host page may set on `<glirastes-chat>`. */
+export declare const EMBED_CSS_VARIABLES: readonly ["--glirastes-chat-primary", "--glirastes-chat-primary-soft", "--glirastes-chat-primary-tint", "--glirastes-chat-bg", "--glirastes-chat-bg-muted", "--glirastes-chat-bubble-user", "--glirastes-chat-bubble-assistant", "--glirastes-chat-text", "--glirastes-chat-text-muted", "--glirastes-chat-border", "--glirastes-chat-danger", "--glirastes-chat-radius", "--glirastes-chat-radius-sm", "--glirastes-chat-font"];
+export declare function isChatThemePreset(value: string | null | undefined): value is ChatThemePreset;
+/**
+ * Shadow-root theme rules. Host CSS variables (`--glirastes-chat-*`) win;
+ * the selected preset supplies the fallback. Inline panel variables are
+ * disabled in the embed (`themeScope: 'inherit'`) so these rules apply.
+ */
+export declare function embedThemeCss(preset?: ChatThemePreset): string;

package/dist/embed/theme.js

@@ -0,0 +1,41 @@
+import { CHAT_THEME_PRESETS, getThemeVars } from '../react/themes.js';
+/** Public CSS custom properties a host page may set on `<glirastes-chat>`. */
+export const EMBED_CSS_VARIABLES = Object.freeze([
+    '--glirastes-chat-primary',
+    '--glirastes-chat-primary-soft',
+    '--glirastes-chat-primary-tint',
+    '--glirastes-chat-bg',
+    '--glirastes-chat-bg-muted',
+    '--glirastes-chat-bubble-user',
+    '--glirastes-chat-bubble-assistant',
+    '--glirastes-chat-text',
+    '--glirastes-chat-text-muted',
+    '--glirastes-chat-border',
+    '--glirastes-chat-danger',
+    '--glirastes-chat-radius',
+    '--glirastes-chat-radius-sm',
+    '--glirastes-chat-font',
+]);
+export function isChatThemePreset(value) {
+    return typeof value === 'string' && Object.hasOwn(CHAT_THEME_PRESETS, value);
+}
+/**
+ * Shadow-root theme rules. Host CSS variables (`--glirastes-chat-*`) win;
+ * the selected preset supplies the fallback. Inline panel variables are
+ * disabled in the embed (`themeScope: 'inherit'`) so these rules apply.
+ */
+export function embedThemeCss(preset) {
+    const declarations = Object.entries(getThemeVars(preset))
+        .map(([name, value]) => {
+        const publicName = name.replace(/^--cm-/, '--glirastes-chat-');
+        return `  ${name}: var(${publicName}, ${value});`;
+    })
+        .join('\n');
+    return [
+        ':host { display: block; position: relative; height: 100%; min-height: 0; }',
+        ':host([hidden]) { display: none; }',
+        '[data-part="mount"] { height: 100%; }',
+        `[data-component="ai-chat-panel"] {\n${declarations}\n}`,
+    ].join('\n');
+}
+//# sourceMappingURL=theme.js.map

package/dist/embed/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/embed/theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGtE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,0BAA0B;IAC1B,+BAA+B;IAC/B,+BAA+B;IAC/B,qBAAqB;IACrB,2BAA2B;IAC3B,8BAA8B;IAC9B,mCAAmC;IACnC,uBAAuB;IACvB,6BAA6B;IAC7B,yBAAyB;IACzB,yBAAyB;IACzB,yBAAyB;IACzB,4BAA4B;IAC5B,uBAAuB;CACf,CAAC,CAAC;AAEZ,MAAM,UAAU,iBAAiB,CAAC,KAAgC;IAChE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;AAC/E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAwB;IACpD,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;SACtD,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;QACrB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;QAC/D,OAAO,KAAK,IAAI,SAAS,UAAU,KAAK,KAAK,IAAI,CAAC;IACpD,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO;QACL,4EAA4E;QAC5E,oCAAoC;QACpC,uCAAuC;QACvC,uCAAuC,YAAY,KAAK;KACzD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -1 +1,2 @@
 export * from './types.js';
+export * from './diagnostics/index.js';

package/dist/index.js

@@ -5,4 +5,5 @@
 // Subpath exports (`glirastes/server`, `glirastes/react`, etc.) remain the
 // primary API surface for runtime functionality.
 export * from './types.js';
+export * from './diagnostics/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,2EAA2E;AAC3E,iDAAiD;AACjD,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,2EAA2E;AAC3E,iDAAiD;AACjD,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC"}

package/dist/react/assistant/assistant-layout.d.ts

@@ -0,0 +1,55 @@
+import { type ReactNode } from 'react';
+/** Docked on the right of the page, or a detached window above it. */
+export type AssistantLayoutMode = 'sidebar' | 'floating';
+export interface AssistantLayoutState {
+    open: boolean;
+    mode: AssistantLayoutMode;
+    /**
+     * The layout the assistant opens in. Detaching or docking the open
+     * assistant updates it, so a closed window comes back as a window.
+     */
+    defaultMode: AssistantLayoutMode;
+    /** Sidebar folded to a narrow rail. */
+    collapsed: boolean;
+    /** Sidebar width in pixels. */
+    width: number;
+}
+export interface AssistantLayoutLimits {
+    minWidth: number;
+    maxWidth: number;
+    defaultWidth: number;
+    defaultMode: AssistantLayoutMode;
+}
+export declare const DEFAULT_ASSISTANT_LAYOUT_KEY = "glirastes:assistant-layout:v1";
+export declare const DEFAULT_ASSISTANT_LAYOUT_LIMITS: AssistantLayoutLimits;
+export declare function clampAssistantWidth(width: number, limits?: Partial<AssistantLayoutLimits>): number;
+export declare function defaultAssistantLayout(limits?: Partial<AssistantLayoutLimits>): AssistantLayoutState;
+/** Reads a stored layout; anything invalid falls back to the defaults. */
+export declare function parseAssistantLayout(raw: string | null, limits?: Partial<AssistantLayoutLimits>): AssistantLayoutState;
+export interface AssistantLayout extends AssistantLayoutState {
+    limits: AssistantLayoutLimits;
+    openChat(): void;
+    closeChat(): void;
+    toggleChat(): void;
+    /** Switches the layout and remembers it for the next opening. */
+    setMode(mode: AssistantLayoutMode): void;
+    /** Sets the layout the next opening uses, without moving an open assistant. */
+    setDefaultMode(mode: AssistantLayoutMode): void;
+    setCollapsed(value: boolean): void;
+    toggleCollapsed(): void;
+    setWidth(width: number): void;
+}
+export interface AssistantLayoutProviderProps extends Partial<AssistantLayoutLimits> {
+    children: ReactNode;
+    /** localStorage key; `null` keeps the layout in memory only. Scope it per user when several share a browser. */
+    storageKey?: string | null;
+}
+/**
+ * Open state, layout and sidebar width of the assistant, persisted per
+ * browser. Storage is read after hydration, so server and client render
+ * the same closed assistant first.
+ */
+export declare function AssistantLayoutProvider({ children, storageKey, minWidth, maxWidth, defaultWidth, defaultMode, }: AssistantLayoutProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useAssistantLayout(): AssistantLayout;
+/** The surrounding layout, or null outside an `AssistantLayoutProvider`. */
+export declare function useOptionalAssistantLayout(): AssistantLayout | null;

package/dist/react/assistant/assistant-layout.js

@@ -0,0 +1,99 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useState } from 'react';
+export const DEFAULT_ASSISTANT_LAYOUT_KEY = 'glirastes:assistant-layout:v1';
+export const DEFAULT_ASSISTANT_LAYOUT_LIMITS = Object.freeze({
+    minWidth: 400,
+    maxWidth: 800,
+    defaultWidth: 420,
+    defaultMode: 'sidebar',
+});
+function limitsOf(limits) {
+    return { ...DEFAULT_ASSISTANT_LAYOUT_LIMITS, ...limits };
+}
+export function clampAssistantWidth(width, limits) {
+    const { minWidth, maxWidth, defaultWidth } = limitsOf(limits);
+    return Math.max(minWidth, Math.min(maxWidth, Number.isFinite(width) ? width : defaultWidth));
+}
+export function defaultAssistantLayout(limits) {
+    const { defaultMode, defaultWidth } = limitsOf(limits);
+    return { open: false, mode: defaultMode, defaultMode, collapsed: false, width: clampAssistantWidth(defaultWidth, limits) };
+}
+/** Reads a stored layout; anything invalid falls back to the defaults. */
+export function parseAssistantLayout(raw, limits) {
+    const fallback = defaultAssistantLayout(limits);
+    try {
+        const value = JSON.parse(raw ?? 'null');
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            return fallback;
+        const mode = value.mode === 'floating' || value.mode === 'sidebar' ? value.mode : fallback.mode;
+        const defaultMode = value.defaultMode === 'floating' || value.defaultMode === 'sidebar'
+            ? value.defaultMode
+            : value.mode === 'floating' || value.mode === 'sidebar' ? value.mode : fallback.defaultMode;
+        return {
+            open: typeof value.open === 'boolean' ? value.open : false,
+            mode,
+            defaultMode,
+            collapsed: typeof value.collapsed === 'boolean' ? value.collapsed : false,
+            width: typeof value.width === 'number' ? clampAssistantWidth(value.width, limits) : fallback.width,
+        };
+    }
+    catch {
+        return fallback;
+    }
+}
+const AssistantLayoutContext = createContext(null);
+/**
+ * Open state, layout and sidebar width of the assistant, persisted per
+ * browser. Storage is read after hydration, so server and client render
+ * the same closed assistant first.
+ */
+export function AssistantLayoutProvider({ children, storageKey = DEFAULT_ASSISTANT_LAYOUT_KEY, minWidth, maxWidth, defaultWidth, defaultMode, }) {
+    const limits = useMemo(() => limitsOf(Object.fromEntries(Object.entries({ minWidth, maxWidth, defaultWidth, defaultMode }).filter(([, v]) => v !== undefined))), [minWidth, maxWidth, defaultWidth, defaultMode]);
+    const [state, setState] = useState(() => defaultAssistantLayout(limits));
+    const [ready, setReady] = useState(false);
+    useEffect(() => {
+        if (!storageKey) {
+            setReady(true);
+            return;
+        }
+        const frame = requestAnimationFrame(() => {
+            try {
+                setState(parseAssistantLayout(localStorage.getItem(storageKey), limits));
+            }
+            catch { /* Storage disabled */ }
+            setReady(true);
+        });
+        return () => cancelAnimationFrame(frame);
+    }, [storageKey, limits]);
+    useEffect(() => {
+        if (ready && storageKey)
+            try {
+                localStorage.setItem(storageKey, JSON.stringify(state));
+            }
+            catch { /* Storage full */ }
+    }, [ready, state, storageKey]);
+    const openChat = useCallback(() => setState(s => ({ ...s, open: true, mode: s.open ? s.mode : s.defaultMode, collapsed: false })), []);
+    const closeChat = useCallback(() => setState(s => ({ ...s, open: false })), []);
+    const toggleChat = useCallback(() => setState(s => s.open && s.collapsed && s.mode === 'sidebar'
+        ? { ...s, collapsed: false }
+        : { ...s, open: !s.open, mode: s.open ? s.mode : s.defaultMode, collapsed: false }), []);
+    const setMode = useCallback((mode) => setState(s => ({ ...s, mode, defaultMode: mode })), []);
+    const setDefaultMode = useCallback((mode) => setState(s => ({ ...s, defaultMode: mode, mode: s.open ? s.mode : mode })), []);
+    const setCollapsed = useCallback((collapsed) => setState(s => ({ ...s, collapsed })), []);
+    const toggleCollapsed = useCallback(() => setState(s => ({ ...s, collapsed: !s.collapsed })), []);
+    const setWidth = useCallback((width) => setState(s => ({ ...s, width: clampAssistantWidth(width, limits) })), [limits]);
+    const value = useMemo(() => ({ ...state, limits, openChat, closeChat, toggleChat, setMode, setDefaultMode, setCollapsed, toggleCollapsed, setWidth }), [state, limits, openChat, closeChat, toggleChat, setMode, setDefaultMode, setCollapsed, toggleCollapsed, setWidth]);
+    return _jsx(AssistantLayoutContext.Provider, { value: value, children: children });
+}
+export function useAssistantLayout() {
+    const value = useContext(AssistantLayoutContext);
+    if (!value)
+        throw new Error('useAssistantLayout must be used inside <AssistantLayoutProvider>');
+    return value;
+}
+/** The surrounding layout, or null outside an `AssistantLayoutProvider`. */
+export function useOptionalAssistantLayout() {
+    return useContext(AssistantLayoutContext);
+}
+//# sourceMappingURL=assistant-layout.js.map

package/dist/react/assistant/assistant-layout.js.map

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