glirastes 0.1.0

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

@@ -0,0 +1,40 @@
+import { useMemo } from 'react';
+import { useChatContext } from '../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>
+ *   );
+ * }
+ * ```
+ */
+export function useMentions() {
+    const ctx = useChatContext();
+    return 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,
+    ]);
+}
+//# sourceMappingURL=use-mentions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-mentions.js","sourceRoot":"","sources":["../../../src/react/hooks/use-mentions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;IAE7B,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,KAAK,EAAE,GAAG,CAAC,YAAY;QACvB,OAAO,EAAE,GAAG,CAAC,cAAc;QAC3B,MAAM,EAAE,GAAG,CAAC,aAAa;QACzB,cAAc,EAAE,GAAG,CAAC,cAAc;QAClC,WAAW,EAAE,GAAG,CAAC,kBAAkB;KACpC,CAAC,EACF;QACE,GAAG,CAAC,YAAY;QAChB,GAAG,CAAC,cAAc;QAClB,GAAG,CAAC,aAAa;QACjB,GAAG,CAAC,cAAc;QAClB,GAAG,CAAC,kBAAkB;KACvB,CACF,CAAC;AACJ,CAAC"}

package/dist/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/react/hooks/use-suggestions.js

@@ -0,0 +1,37 @@
+import { useMemo } from 'react';
+import { useChatContext } from '../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>
+ *   );
+ * }
+ * ```
+ */
+export function useSuggestions() {
+    const ctx = useChatContext();
+    return useMemo(() => ({
+        chips: ctx.suggestionChips,
+        refresh: ctx.refreshSuggestions,
+        select: ctx.selectSuggestion,
+        isGenerating: ctx.isSuggestionsGenerating,
+    }), [
+        ctx.suggestionChips,
+        ctx.refreshSuggestions,
+        ctx.selectSuggestion,
+        ctx.isSuggestionsGenerating,
+    ]);
+}
+//# sourceMappingURL=use-suggestions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-suggestions.js","sourceRoot":"","sources":["../../../src/react/hooks/use-suggestions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;IAE7B,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,KAAK,EAAE,GAAG,CAAC,eAAe;QAC1B,OAAO,EAAE,GAAG,CAAC,kBAAkB;QAC/B,MAAM,EAAE,GAAG,CAAC,gBAAgB;QAC5B,YAAY,EAAE,GAAG,CAAC,uBAAuB;KAC1C,CAAC,EACF;QACE,GAAG,CAAC,eAAe;QACnB,GAAG,CAAC,kBAAkB;QACtB,GAAG,CAAC,gBAAgB;QACpB,GAAG,CAAC,uBAAuB;KAC5B,CACF,CAAC;AACJ,CAAC"}

package/dist/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/react/index.js

@@ -0,0 +1,53 @@
+// ============================================================================
+// glirastes/react
+//
+// React components, hooks, and provider for AI chat UI.
+// Styling-neutral: uses className props and data-* attributes.
+// ============================================================================
+// Provider
+export { AiChatProvider } from './provider/ai-chat-provider.js';
+// Context (for advanced use cases)
+export { useChatContext } from './provider/chat-context.js';
+// Hooks
+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 { useDraggablePosition } from './hooks/use-draggable-position.js';
+export { useKeyboardShortcut } from './hooks/use-keyboard-shortcut.js';
+// Components
+export { AiChatPanel } from './components/ai-chat-panel.js';
+export { FloatingChatUI } 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 } from './components/session-switcher.js';
+// Bridges
+export { createRestSessionBridge, } from './bridges/rest-session-bridge.js';
+// Theme helpers
+export { getThemeVars, CHAT_THEME_PRESETS, DEFAULT_THEME_PRESET } from './themes.js';
+// Utilities
+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, } from './utils/create-tool-result-handler.js';
+export { createApprovalDescriptionGenerator, } from './utils/create-approval-description.js';
+// UI action bus + hooks (client action dispatch)
+export * from './ui.js';
+// Pre-styled template (Tailwind wrappers around the unstyled components)
+export * from './template.js';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kBAAkB;AAClB,EAAE;AACF,wDAAwD;AACxD,+DAA+D;AAC/D,+EAA+E;AAiG/E,WAAW;AACX,OAAO,EAAE,cAAc,EAA4B,MAAM,gCAAgC,CAAC;AAE1F,mCAAmC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,QAAQ;AACR,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAMtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAOvE,aAAa;AACb,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAA4B,MAAM,kCAAkC,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,eAAe,EAA6B,MAAM,kCAAkC,CAAC;AAE9F,UAAU;AACV,OAAO,EACL,uBAAuB,GAGxB,MAAM,kCAAkC,CAAC;AAE1C,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAErF,YAAY;AACZ,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,uBAAuB,GAExB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,kCAAkC,GAEnC,MAAM,wCAAwC,CAAC;AAEhD,iDAAiD;AACjD,cAAc,SAAS,CAAC;AAExB,yEAAyE;AACzE,cAAc,eAAe,CAAC"}

package/dist/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;