glirastes 0.3.0 → 0.3.1

package/dist/cjs/react/hooks/use-draggable-position.d.ts

@@ -0,0 +1,25 @@
+export interface UseDraggablePositionOptions {
+    /** Enable dragging. Default: true */
+    enabled?: boolean;
+    /** Movement threshold in px before a mousedown is treated as a drag. Default: 5 */
+    dragThreshold?: number;
+    /** SessionStorage key prefix for persisting position. Falsy = no persistence. */
+    persistKey?: string | false;
+}
+export interface UseDraggablePositionReturn {
+    /** Current position, or null if at default (not yet dragged / reset). */
+    position: {
+        x: number;
+        y: number;
+    } | null;
+    /** Whether the user is currently dragging. */
+    isDragging: boolean;
+    /** Attach to onMouseDown on the draggable element. */
+    onMouseDown: (e: React.MouseEvent<HTMLElement>) => void;
+    /** Whether the last interaction was a drag (true) vs a click (false).
+     *  Reset to false on the next mousedown. Use to suppress onClick. */
+    wasDragged: boolean;
+    /** Programmatically reset to default position. */
+    resetPosition: () => void;
+}
+export declare function useDraggablePosition(options?: UseDraggablePositionOptions): UseDraggablePositionReturn;

package/dist/cjs/react/hooks/use-draggable-position.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useDraggablePosition = useDraggablePosition;
+const react_1 = require("react");
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function readPosition(key) {
+    if (typeof window === 'undefined')
+        return null;
+    try {
+        const raw = sessionStorage.getItem(key);
+        if (!raw)
+            return null;
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.x === 'number' && typeof parsed.y === 'number') {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function writePosition(key, pos) {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        if (pos) {
+            sessionStorage.setItem(key, JSON.stringify(pos));
+        }
+        else {
+            sessionStorage.removeItem(key);
+        }
+    }
+    catch {
+        // Ignore quota / private-browsing errors
+    }
+}
+function clampToViewport(x, y, elWidth, elHeight) {
+    const margin = 8;
+    return {
+        x: Math.max(margin, Math.min(x, window.innerWidth - elWidth - margin)),
+        y: Math.max(margin, Math.min(y, window.innerHeight - elHeight - margin)),
+    };
+}
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+function useDraggablePosition(options = {}) {
+    const { enabled = true, dragThreshold = 5, persistKey = false } = options;
+    const storageKey = persistKey ? `draggable-pos-${persistKey}` : null;
+    const [position, setPosition] = (0, react_1.useState)(() => (storageKey ? readPosition(storageKey) : null));
+    const [isDragging, setIsDragging] = (0, react_1.useState)(false);
+    const [wasDragged, setWasDragged] = (0, react_1.useState)(false);
+    const dragRef = (0, react_1.useRef)(null);
+    // Persist position changes
+    (0, react_1.useEffect)(() => {
+        if (storageKey) {
+            writePosition(storageKey, position);
+        }
+    }, [storageKey, position]);
+    // ------ mousedown handler ------
+    const onMouseDown = (0, react_1.useCallback)((e) => {
+        if (!enabled)
+            return;
+        if (e.button !== 0)
+            return;
+        // Don't intercept clicks on nested interactive children (but allow
+        // when the matched element is the container itself, i.e. currentTarget)
+        const interactiveEl = e.target.closest('button, a, input, [role="button"]');
+        if (interactiveEl && interactiveEl !== e.currentTarget) {
+            return;
+        }
+        const el = e.currentTarget;
+        const rect = el.getBoundingClientRect();
+        dragRef.current = {
+            startMouseX: e.clientX,
+            startMouseY: e.clientY,
+            startElX: rect.left,
+            startElY: rect.top,
+            el,
+            didMove: false,
+        };
+        setWasDragged(false);
+        // We don't preventDefault here yet — we do it once we confirm a drag
+    }, [enabled]);
+    // ------ global mousemove / mouseup ------
+    (0, react_1.useEffect)(() => {
+        const onMouseMove = (e) => {
+            const drag = dragRef.current;
+            if (!drag)
+                return;
+            const dx = e.clientX - drag.startMouseX;
+            const dy = e.clientY - drag.startMouseY;
+            if (!drag.didMove) {
+                if (Math.abs(dx) < dragThreshold && Math.abs(dy) < dragThreshold) {
+                    return; // Below threshold — not a drag yet
+                }
+                drag.didMove = true;
+                setIsDragging(true);
+                // Prevent text selection once we start dragging
+                document.body.style.userSelect = 'none';
+            }
+            const rect = drag.el.getBoundingClientRect();
+            const newX = drag.startElX + dx;
+            const newY = drag.startElY + dy;
+            const clamped = clampToViewport(newX, newY, rect.width, rect.height);
+            setPosition(clamped);
+        };
+        const onMouseUp = () => {
+            const drag = dragRef.current;
+            if (!drag)
+                return;
+            if (drag.didMove) {
+                setWasDragged(true);
+                document.body.style.userSelect = '';
+            }
+            dragRef.current = null;
+            setIsDragging(false);
+        };
+        document.addEventListener('mousemove', onMouseMove);
+        document.addEventListener('mouseup', onMouseUp);
+        return () => {
+            document.removeEventListener('mousemove', onMouseMove);
+            document.removeEventListener('mouseup', onMouseUp);
+        };
+    }, [dragThreshold]);
+    const resetPosition = (0, react_1.useCallback)(() => {
+        setPosition(null);
+        setWasDragged(false);
+    }, []);
+    return { position, isDragging, onMouseDown, wasDragged, resetPosition };
+}

package/dist/cjs/react/hooks/use-keyboard-shortcut.d.ts

@@ -0,0 +1,20 @@
+export interface UseKeyboardShortcutOptions {
+    /** Disable without removing the call site. Default: true. */
+    enabled?: boolean;
+    /**
+     * When true, the handler fires even if the event target is an editable
+     * element (input / textarea / contenteditable). Default: false — except
+     * for the `escape` key which always fires.
+     */
+    allowInEditable?: boolean;
+}
+/**
+ * Global keyboard shortcut. `mod` maps to ⌘ on Mac and Ctrl elsewhere.
+ * Escape always fires regardless of focused element so modal-style widgets
+ * can close even while an input has focus.
+ *
+ * @example
+ * useKeyboardShortcut('mod+i', () => setOpen((v) => !v));
+ * useKeyboardShortcut('escape', () => setOpen(false), { enabled: open });
+ */
+export declare function useKeyboardShortcut(combo: string | false | null | undefined, handler: () => void, options?: UseKeyboardShortcutOptions): void;

package/dist/cjs/react/hooks/use-keyboard-shortcut.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useKeyboardShortcut = useKeyboardShortcut;
+const react_1 = require("react");
+function isMac() {
+    if (typeof navigator === 'undefined')
+        return false;
+    return /Mac|iPhone|iPad|iPod/.test(navigator.platform || navigator.userAgent || '');
+}
+function parseCombo(combo) {
+    const parts = combo.toLowerCase().trim().split('+').map((p) => p.trim()).filter(Boolean);
+    if (parts.length === 0)
+        return null;
+    const result = { key: '', mod: false, shift: false, alt: false };
+    for (const part of parts) {
+        if (part === 'mod' || part === 'cmd' || part === 'ctrl' || part === 'meta' || part === 'control') {
+            result.mod = true;
+        }
+        else if (part === 'shift') {
+            result.shift = true;
+        }
+        else if (part === 'alt' || part === 'option' || part === 'opt') {
+            result.alt = true;
+        }
+        else {
+            result.key = part;
+        }
+    }
+    return result.key ? result : null;
+}
+function matches(event, combo) {
+    const wantMod = combo.mod;
+    const gotMod = isMac() ? event.metaKey : event.ctrlKey;
+    if (wantMod !== gotMod)
+        return false;
+    if (combo.shift !== event.shiftKey)
+        return false;
+    if (combo.alt !== event.altKey)
+        return false;
+    const key = event.key.toLowerCase();
+    if (combo.key === 'escape')
+        return key === 'escape' || key === 'esc';
+    return key === combo.key;
+}
+function isEditableTarget(target) {
+    if (!(target instanceof HTMLElement))
+        return false;
+    const tag = target.tagName;
+    if (tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT')
+        return true;
+    if (target.isContentEditable)
+        return true;
+    return false;
+}
+/**
+ * Global keyboard shortcut. `mod` maps to ⌘ on Mac and Ctrl elsewhere.
+ * Escape always fires regardless of focused element so modal-style widgets
+ * can close even while an input has focus.
+ *
+ * @example
+ * useKeyboardShortcut('mod+i', () => setOpen((v) => !v));
+ * useKeyboardShortcut('escape', () => setOpen(false), { enabled: open });
+ */
+function useKeyboardShortcut(combo, handler, options = {}) {
+    const { enabled = true, allowInEditable = false } = options;
+    const handlerRef = (0, react_1.useRef)(handler);
+    handlerRef.current = handler;
+    (0, react_1.useEffect)(() => {
+        if (!enabled || !combo)
+            return;
+        const parsed = parseCombo(combo);
+        if (!parsed)
+            return;
+        const listener = (event) => {
+            if (event.defaultPrevented)
+                return;
+            if (!matches(event, parsed))
+                return;
+            // Shortcuts that include ⌘/Ctrl always fire (e.g. ⌘I, ⌘K) — even
+            // inside a textarea — matching standard webapp conventions. Escape
+            // always fires so modal-style widgets can close from any focus.
+            // Bare-key shortcuts are suppressed in editable targets.
+            const isEscape = parsed.key === 'escape';
+            const skipEditableCheck = allowInEditable || isEscape || parsed.mod;
+            if (!skipEditableCheck && isEditableTarget(event.target))
+                return;
+            event.preventDefault();
+            handlerRef.current();
+        };
+        window.addEventListener('keydown', listener);
+        return () => window.removeEventListener('keydown', listener);
+    }, [combo, enabled, allowInEditable]);
+}

package/dist/cjs/react/hooks/use-mentions.d.ts

@@ -0,0 +1,23 @@
+import type { UseMentionsReturn } from '../types.js';
+/**
+ * Hook for accessing mention search and selection.
+ *
+ * @example
+ * ```tsx
+ * function MentionSearch() {
+ *   const { query, results, select, isSearching } = useMentions();
+ *
+ *   return (
+ *     <div>
+ *       {isSearching && <Spinner />}
+ *       {results.map(r => (
+ *         <button key={r.id} onClick={() => select(r)}>
+ *           {r.label}
+ *         </button>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useMentions(): UseMentionsReturn;

package/dist/cjs/react/hooks/use-mentions.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useMentions = useMentions;
+const react_1 = require("react");
+const chat_context_js_1 = require("../provider/chat-context.js");
+/**
+ * Hook for accessing mention search and selection.
+ *
+ * @example
+ * ```tsx
+ * function MentionSearch() {
+ *   const { query, results, select, isSearching } = useMentions();
+ *
+ *   return (
+ *     <div>
+ *       {isSearching && <Spinner />}
+ *       {results.map(r => (
+ *         <button key={r.id} onClick={() => select(r)}>
+ *           {r.label}
+ *         </button>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function useMentions() {
+    const ctx = (0, chat_context_js_1.useChatContext)();
+    return (0, react_1.useMemo)(() => ({
+        query: ctx.mentionQuery,
+        results: ctx.mentionResults,
+        select: ctx.selectMention,
+        activeMentions: ctx.activeMentions,
+        isSearching: ctx.isMentionSearching,
+    }), [
+        ctx.mentionQuery,
+        ctx.mentionResults,
+        ctx.selectMention,
+        ctx.activeMentions,
+        ctx.isMentionSearching,
+    ]);
+}

package/dist/cjs/react/hooks/use-suggestions.d.ts

@@ -0,0 +1,22 @@
+import type { UseSuggestionsReturn } from '../types.js';
+/**
+ * Hook for accessing followup suggestion chips.
+ *
+ * @example
+ * ```tsx
+ * function SuggestionBar() {
+ *   const { chips, select, isGenerating } = useSuggestions();
+ *
+ *   return (
+ *     <div>
+ *       {chips.map(chip => (
+ *         <button key={chip} onClick={() => select(chip)}>
+ *           {chip}
+ *         </button>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useSuggestions(): UseSuggestionsReturn;

package/dist/cjs/react/hooks/use-suggestions.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSuggestions = useSuggestions;
+const react_1 = require("react");
+const chat_context_js_1 = require("../provider/chat-context.js");
+/**
+ * Hook for accessing followup suggestion chips.
+ *
+ * @example
+ * ```tsx
+ * function SuggestionBar() {
+ *   const { chips, select, isGenerating } = useSuggestions();
+ *
+ *   return (
+ *     <div>
+ *       {chips.map(chip => (
+ *         <button key={chip} onClick={() => select(chip)}>
+ *           {chip}
+ *         </button>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function useSuggestions() {
+    const ctx = (0, chat_context_js_1.useChatContext)();
+    return (0, react_1.useMemo)(() => ({
+        chips: ctx.suggestionChips,
+        refresh: ctx.refreshSuggestions,
+        select: ctx.selectSuggestion,
+        isGenerating: ctx.isSuggestionsGenerating,
+    }), [
+        ctx.suggestionChips,
+        ctx.refreshSuggestions,
+        ctx.selectSuggestion,
+        ctx.isSuggestionsGenerating,
+    ]);
+}

package/dist/cjs/react/index.d.ts

@@ -0,0 +1,43 @@
+export type { ChatMessage, MessagePart, TextPart, ToolInvocationPart, ToolResultPart, TruncationInfo, PipelineStepUsage, PipelineStepReport, PipelineStatus, PipelineState, MentionResult, MentionData, MentionConfig, MentionSerializationConfig, SessionConfig, SessionSummary, WireChatMessage, ChatTheme, ChatThemePreset, ChatThemeOverride, ChatThemeColors, ChatLocale, ChatSize, ChatSizePreset, SuggestionsConfig, ToolLabelConfig, ToolResultDisplayMode, ToolResultDisplayConfig, VoiceInputConfig, Mention, MentionChipProps, MentionChipListProps, ChatClassNames, ChatComponents, OnBeforeSend, OnToolResult, ApprovalDescriptionFn, PipelineMessageTranslator, StepSummaryFormatter, AiChatProviderConfig, UseAiChatReturn, PendingApproval, UseApprovalsReturn, UseMentionsReturn, UseSuggestionsReturn, AiChatPanelProps, MessageListProps, MessageBubbleProps, ChatInputProps, MentionInputProps, RichMentionInputHandle, RichMentionInputProps, RichMentionInputComponents, MentionDropdownItemProps, ChatWindowHeaderRenderProps, ChatWindowProps, ApprovalCardProps, BulkApprovalCardProps, PipelineTimelineProps, SuggestionChipProps, SuggestionBarProps, AiTriggerButtonProps, ToolResultBlockProps, MarkdownProps, ChatTransport, ChatTransportConfig, ChatTransportDataPart, ChatTransportDataHandler, ChatTransportApprovalResponse, } from './types.js';
+export type { UseDeepgramTranscriptionOptions, UseDeepgramTranscriptionReturn, VoiceInputButtonProps, RecordingBarProps, } from './types.js';
+export { AiChatProvider, type AiChatProviderProps } from './provider/ai-chat-provider.js';
+export { useChatContext } from './provider/chat-context.js';
+export type { ChatContextValue } from './provider/chat-context.js';
+export { useAiChat } from './hooks/use-ai-chat.js';
+export { useApprovals } from './hooks/use-approvals.js';
+export { useMentions } from './hooks/use-mentions.js';
+export { useSuggestions } from './hooks/use-suggestions.js';
+export { useDeepgramTranscription } from './hooks/use-deepgram-transcription.js';
+export { useDragResizePanel } from './hooks/use-drag-resize-panel.js';
+export type { UseDragResizePanelOptions, UseDragResizePanelReturn, ResizeEdge, } from './hooks/use-drag-resize-panel.js';
+export { useDraggablePosition } from './hooks/use-draggable-position.js';
+export { useKeyboardShortcut } from './hooks/use-keyboard-shortcut.js';
+export type { UseKeyboardShortcutOptions } from './hooks/use-keyboard-shortcut.js';
+export type { UseDraggablePositionOptions, UseDraggablePositionReturn, } from './hooks/use-draggable-position.js';
+export { AiChatPanel } from './components/ai-chat-panel.js';
+export { FloatingChatUI, type FloatingChatUIProps } from './components/floating-chat-ui.js';
+export { MessageList } from './components/message-list.js';
+export { MessageBubble } from './components/message-bubble.js';
+export { ChatInput } from './components/chat-input.js';
+export { MentionInput } from './components/mention-input.js';
+export { RichMentionInput } from './components/rich-mention-input.js';
+export { ChatWindow } from './components/chat-window.js';
+export { ApprovalCard } from './components/approval-card.js';
+export { BulkApprovalCard } from './components/bulk-approval-card.js';
+export { PipelineTimeline } from './components/pipeline-timeline.js';
+export { SuggestionChip } from './components/suggestion-chip.js';
+export { SuggestionBar } from './components/suggestion-bar.js';
+export { MentionChip, MentionChipList } from './components/mention-chip.js';
+export { VoiceInputButton } from './components/voice-input-button.js';
+export { RecordingBar } from './components/recording-bar.js';
+export { AiTriggerButton } from './components/ai-trigger-button.js';
+export { SessionSwitcher, type SessionSwitcherProps } from './components/session-switcher.js';
+export { createRestSessionBridge, type RestSessionBridgeOptions, type HeadersResolver, } from './bridges/rest-session-bridge.js';
+export { getThemeVars, CHAT_THEME_PRESETS, DEFAULT_THEME_PRESET } from './themes.js';
+export { mergePipelineSteps } from './utils/merge-pipeline-steps.js';
+export { sanitizeStoredMessages } from './utils/sanitize-stored-messages.js';
+export { stripContextBlocks, parseMentionSegments, serializeMentionsForSend, inferMentionPrefix, normalizeMentionSlug, } from './utils/mention-markup.js';
+export { createToolResultHandler, type ToolResultHandlerConfig, } from './utils/create-tool-result-handler.js';
+export { createApprovalDescriptionGenerator, type ApprovalDescriptionConfig, } from './utils/create-approval-description.js';
+export * from './ui.js';
+export * from './template.js';

package/dist/cjs/react/index.js

@@ -0,0 +1,111 @@
+"use strict";
+// ============================================================================
+// glirastes/react
+//
+// React components, hooks, and provider for AI chat UI.
+// Styling-neutral: uses className props and data-* attributes.
+// ============================================================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createApprovalDescriptionGenerator = exports.createToolResultHandler = exports.normalizeMentionSlug = exports.inferMentionPrefix = exports.serializeMentionsForSend = exports.parseMentionSegments = exports.stripContextBlocks = exports.sanitizeStoredMessages = exports.mergePipelineSteps = exports.DEFAULT_THEME_PRESET = exports.CHAT_THEME_PRESETS = exports.getThemeVars = exports.createRestSessionBridge = exports.SessionSwitcher = exports.AiTriggerButton = exports.RecordingBar = exports.VoiceInputButton = exports.MentionChipList = exports.MentionChip = exports.SuggestionBar = exports.SuggestionChip = exports.PipelineTimeline = exports.BulkApprovalCard = exports.ApprovalCard = exports.ChatWindow = exports.RichMentionInput = exports.MentionInput = exports.ChatInput = exports.MessageBubble = exports.MessageList = exports.FloatingChatUI = exports.AiChatPanel = exports.useKeyboardShortcut = exports.useDraggablePosition = exports.useDragResizePanel = exports.useDeepgramTranscription = exports.useSuggestions = exports.useMentions = exports.useApprovals = exports.useAiChat = exports.useChatContext = exports.AiChatProvider = void 0;
+// Provider
+var ai_chat_provider_js_1 = require("./provider/ai-chat-provider.js");
+Object.defineProperty(exports, "AiChatProvider", { enumerable: true, get: function () { return ai_chat_provider_js_1.AiChatProvider; } });
+// Context (for advanced use cases)
+var chat_context_js_1 = require("./provider/chat-context.js");
+Object.defineProperty(exports, "useChatContext", { enumerable: true, get: function () { return chat_context_js_1.useChatContext; } });
+// Hooks
+var use_ai_chat_js_1 = require("./hooks/use-ai-chat.js");
+Object.defineProperty(exports, "useAiChat", { enumerable: true, get: function () { return use_ai_chat_js_1.useAiChat; } });
+var use_approvals_js_1 = require("./hooks/use-approvals.js");
+Object.defineProperty(exports, "useApprovals", { enumerable: true, get: function () { return use_approvals_js_1.useApprovals; } });
+var use_mentions_js_1 = require("./hooks/use-mentions.js");
+Object.defineProperty(exports, "useMentions", { enumerable: true, get: function () { return use_mentions_js_1.useMentions; } });
+var use_suggestions_js_1 = require("./hooks/use-suggestions.js");
+Object.defineProperty(exports, "useSuggestions", { enumerable: true, get: function () { return use_suggestions_js_1.useSuggestions; } });
+var use_deepgram_transcription_js_1 = require("./hooks/use-deepgram-transcription.js");
+Object.defineProperty(exports, "useDeepgramTranscription", { enumerable: true, get: function () { return use_deepgram_transcription_js_1.useDeepgramTranscription; } });
+var use_drag_resize_panel_js_1 = require("./hooks/use-drag-resize-panel.js");
+Object.defineProperty(exports, "useDragResizePanel", { enumerable: true, get: function () { return use_drag_resize_panel_js_1.useDragResizePanel; } });
+var use_draggable_position_js_1 = require("./hooks/use-draggable-position.js");
+Object.defineProperty(exports, "useDraggablePosition", { enumerable: true, get: function () { return use_draggable_position_js_1.useDraggablePosition; } });
+var use_keyboard_shortcut_js_1 = require("./hooks/use-keyboard-shortcut.js");
+Object.defineProperty(exports, "useKeyboardShortcut", { enumerable: true, get: function () { return use_keyboard_shortcut_js_1.useKeyboardShortcut; } });
+// Components
+var ai_chat_panel_js_1 = require("./components/ai-chat-panel.js");
+Object.defineProperty(exports, "AiChatPanel", { enumerable: true, get: function () { return ai_chat_panel_js_1.AiChatPanel; } });
+var floating_chat_ui_js_1 = require("./components/floating-chat-ui.js");
+Object.defineProperty(exports, "FloatingChatUI", { enumerable: true, get: function () { return floating_chat_ui_js_1.FloatingChatUI; } });
+var message_list_js_1 = require("./components/message-list.js");
+Object.defineProperty(exports, "MessageList", { enumerable: true, get: function () { return message_list_js_1.MessageList; } });
+var message_bubble_js_1 = require("./components/message-bubble.js");
+Object.defineProperty(exports, "MessageBubble", { enumerable: true, get: function () { return message_bubble_js_1.MessageBubble; } });
+var chat_input_js_1 = require("./components/chat-input.js");
+Object.defineProperty(exports, "ChatInput", { enumerable: true, get: function () { return chat_input_js_1.ChatInput; } });
+var mention_input_js_1 = require("./components/mention-input.js");
+Object.defineProperty(exports, "MentionInput", { enumerable: true, get: function () { return mention_input_js_1.MentionInput; } });
+var rich_mention_input_js_1 = require("./components/rich-mention-input.js");
+Object.defineProperty(exports, "RichMentionInput", { enumerable: true, get: function () { return rich_mention_input_js_1.RichMentionInput; } });
+var chat_window_js_1 = require("./components/chat-window.js");
+Object.defineProperty(exports, "ChatWindow", { enumerable: true, get: function () { return chat_window_js_1.ChatWindow; } });
+var approval_card_js_1 = require("./components/approval-card.js");
+Object.defineProperty(exports, "ApprovalCard", { enumerable: true, get: function () { return approval_card_js_1.ApprovalCard; } });
+var bulk_approval_card_js_1 = require("./components/bulk-approval-card.js");
+Object.defineProperty(exports, "BulkApprovalCard", { enumerable: true, get: function () { return bulk_approval_card_js_1.BulkApprovalCard; } });
+var pipeline_timeline_js_1 = require("./components/pipeline-timeline.js");
+Object.defineProperty(exports, "PipelineTimeline", { enumerable: true, get: function () { return pipeline_timeline_js_1.PipelineTimeline; } });
+var suggestion_chip_js_1 = require("./components/suggestion-chip.js");
+Object.defineProperty(exports, "SuggestionChip", { enumerable: true, get: function () { return suggestion_chip_js_1.SuggestionChip; } });
+var suggestion_bar_js_1 = require("./components/suggestion-bar.js");
+Object.defineProperty(exports, "SuggestionBar", { enumerable: true, get: function () { return suggestion_bar_js_1.SuggestionBar; } });
+var mention_chip_js_1 = require("./components/mention-chip.js");
+Object.defineProperty(exports, "MentionChip", { enumerable: true, get: function () { return mention_chip_js_1.MentionChip; } });
+Object.defineProperty(exports, "MentionChipList", { enumerable: true, get: function () { return mention_chip_js_1.MentionChipList; } });
+var voice_input_button_js_1 = require("./components/voice-input-button.js");
+Object.defineProperty(exports, "VoiceInputButton", { enumerable: true, get: function () { return voice_input_button_js_1.VoiceInputButton; } });
+var recording_bar_js_1 = require("./components/recording-bar.js");
+Object.defineProperty(exports, "RecordingBar", { enumerable: true, get: function () { return recording_bar_js_1.RecordingBar; } });
+var ai_trigger_button_js_1 = require("./components/ai-trigger-button.js");
+Object.defineProperty(exports, "AiTriggerButton", { enumerable: true, get: function () { return ai_trigger_button_js_1.AiTriggerButton; } });
+var session_switcher_js_1 = require("./components/session-switcher.js");
+Object.defineProperty(exports, "SessionSwitcher", { enumerable: true, get: function () { return session_switcher_js_1.SessionSwitcher; } });
+// Bridges
+var rest_session_bridge_js_1 = require("./bridges/rest-session-bridge.js");
+Object.defineProperty(exports, "createRestSessionBridge", { enumerable: true, get: function () { return rest_session_bridge_js_1.createRestSessionBridge; } });
+// Theme helpers
+var themes_js_1 = require("./themes.js");
+Object.defineProperty(exports, "getThemeVars", { enumerable: true, get: function () { return themes_js_1.getThemeVars; } });
+Object.defineProperty(exports, "CHAT_THEME_PRESETS", { enumerable: true, get: function () { return themes_js_1.CHAT_THEME_PRESETS; } });
+Object.defineProperty(exports, "DEFAULT_THEME_PRESET", { enumerable: true, get: function () { return themes_js_1.DEFAULT_THEME_PRESET; } });
+// Utilities
+var merge_pipeline_steps_js_1 = require("./utils/merge-pipeline-steps.js");
+Object.defineProperty(exports, "mergePipelineSteps", { enumerable: true, get: function () { return merge_pipeline_steps_js_1.mergePipelineSteps; } });
+var sanitize_stored_messages_js_1 = require("./utils/sanitize-stored-messages.js");
+Object.defineProperty(exports, "sanitizeStoredMessages", { enumerable: true, get: function () { return sanitize_stored_messages_js_1.sanitizeStoredMessages; } });
+var mention_markup_js_1 = require("./utils/mention-markup.js");
+Object.defineProperty(exports, "stripContextBlocks", { enumerable: true, get: function () { return mention_markup_js_1.stripContextBlocks; } });
+Object.defineProperty(exports, "parseMentionSegments", { enumerable: true, get: function () { return mention_markup_js_1.parseMentionSegments; } });
+Object.defineProperty(exports, "serializeMentionsForSend", { enumerable: true, get: function () { return mention_markup_js_1.serializeMentionsForSend; } });
+Object.defineProperty(exports, "inferMentionPrefix", { enumerable: true, get: function () { return mention_markup_js_1.inferMentionPrefix; } });
+Object.defineProperty(exports, "normalizeMentionSlug", { enumerable: true, get: function () { return mention_markup_js_1.normalizeMentionSlug; } });
+var create_tool_result_handler_js_1 = require("./utils/create-tool-result-handler.js");
+Object.defineProperty(exports, "createToolResultHandler", { enumerable: true, get: function () { return create_tool_result_handler_js_1.createToolResultHandler; } });
+var create_approval_description_js_1 = require("./utils/create-approval-description.js");
+Object.defineProperty(exports, "createApprovalDescriptionGenerator", { enumerable: true, get: function () { return create_approval_description_js_1.createApprovalDescriptionGenerator; } });
+// UI action bus + hooks (client action dispatch)
+__exportStar(require("./ui.js"), exports);
+// Pre-styled template (Tailwind wrappers around the unstyled components)
+__exportStar(require("./template.js"), exports);

package/dist/cjs/react/provider/ai-chat-provider.d.ts

@@ -0,0 +1,45 @@
+import { type ReactNode } from 'react';
+import type { AiChatProviderConfig, ChatTransport } from '../types.js';
+import type { ChatLocale } from '../types.js';
+export declare const DEFAULT_LOCALE: ChatLocale;
+export interface AiChatProviderProps extends AiChatProviderConfig {
+    /**
+     * Chat transport — required. Use one of the built-in hooks or implement
+     * the `ChatTransport` interface for a custom backend.
+     *
+     * - `useVercelAiChatTransport` from `glirastes/react/vercel`
+     * - `useLangGraphChatTransport` from `glirastes/react/langgraph`
+     */
+    transport: ChatTransport;
+    children: ReactNode;
+}
+/**
+ * Provider component that manages chat state and exposes it to child components.
+ *
+ * Transport-agnostic: pick a transport hook (Vercel, LangGraph, or your own)
+ * and pass it via the `transport` prop.
+ *
+ * Features:
+ * - Message sanitization (removes orphaned approval-requested tool parts)
+ * - Session persistence (load on mount, save on change)
+ * - Approval extraction and response handling
+ * - Truncation detection via `data-truncation` data parts
+ * - Suggestion extraction from `suggest_followups` tool output
+ * - Pagination (visible message count, loadMore)
+ *
+ * @example
+ * ```tsx
+ * import { AiChatProvider, AiChatPanel } from 'glirastes/react';
+ * import { useVercelAiChatTransport } from 'glirastes/react/vercel';
+ *
+ * function App() {
+ *   const transport = useVercelAiChatTransport({ endpoint: '/api/ai/chat' });
+ *   return (
+ *     <AiChatProvider transport={transport}>
+ *       <AiChatPanel />
+ *     </AiChatProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function AiChatProvider({ transport, mentions, toolResults: userToolResults, voice: userVoice, session, classNames: userClassNames, components: userComponents, suggestions: userSuggestions, locale: userLocale, theme: userTheme, onToolResult, onBeforeSend, approvalDescription: userApprovalDescription, continueMessage, toolLabels: userToolLabels, pipelineMessageTranslator, stepSummaryFormatter, children, }: AiChatProviderProps): import("react/jsx-runtime").JSX.Element;