@memoreco/ui 0.2.10 → 0.2.12

package/dist/ui/src/components/chat/ChatPanel.d.ts

@@ -0,0 +1,4 @@
+import { ChatPanelProps } from './types';
+
+export declare function ChatPanel({ transport, language, storageKey, persist, playerReady, onPlayMoment, onAddToNotes, followUps, emptyStateTitle, emptyStateSubtitle, inputPlaceholder, variant, className, }: ChatPanelProps): import("react/jsx-runtime").JSX.Element;
+export default ChatPanel;

package/dist/ui/src/components/chat/MarkdownText.d.ts

@@ -0,0 +1,10 @@
+export interface MarkdownTextProps {
+    /** Markdown content to render */
+    markdown: string;
+    /** Callback when a time reference is clicked */
+    onSeekToMoment: (seconds: number, endSeconds?: number) => void;
+    /** Size variant */
+    size?: "sm" | "md";
+}
+export declare function MarkdownText({ markdown, onSeekToMoment, size, }: MarkdownTextProps): import("react/jsx-runtime").JSX.Element;
+export default MarkdownText;

package/dist/ui/src/components/chat/TimecodeTag.d.ts

@@ -0,0 +1,16 @@
+export interface TimecodeTagProps {
+    /** Display label (formatted timecode) */
+    label: string;
+    /** Start time in seconds */
+    seconds: number;
+    /** Optional end time in seconds (for time ranges) */
+    endSeconds?: number;
+    /** Whether the tag is disabled */
+    disabled?: boolean;
+    /** Click handler */
+    onClick: (seconds: number, endSeconds?: number) => void;
+    /** Size variant */
+    size?: "sm" | "md";
+}
+export declare function TimecodeTag({ label, seconds, endSeconds, disabled, onClick, size, }: TimecodeTagProps): import("react/jsx-runtime").JSX.Element;
+export default TimecodeTag;

package/dist/ui/src/components/chat/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Chat Component Module
+ *
+ * Unified chat UI component for use across dashboard and web apps.
+ */
+export { ChatPanel } from './ChatPanel';
+export { default as ChatPanelDefault } from './ChatPanel';
+export { TimecodeTag } from './TimecodeTag';
+export { MarkdownText } from './MarkdownText';
+export { safeReadChatFromStorage, safeWriteChatToStorage, safeRemoveChatFromStorage, messagesToStored, storedToMessages, } from './storage';
+export { parseSseEvent, readSseStream } from './sse';
+export { parseTimecodeToSeconds, formatSecondsAsTimecode, linkifyTimeReferencesInMarkdown, } from './time-utils';
+export { getDefaultSuggestions, getBrowserLanguage, DEFAULT_SUGGESTIONS } from './suggestions';
+export type { ChatPanelProps, ChatTransport, ChatStreamRequest, ChatMessage, ChatResponse, ChatAnswerItem, ChatMoment, ChatSuggestion, StoredChatMessage, } from './types';
+export type { TimecodeTagProps } from './TimecodeTag';
+export type { MarkdownTextProps } from './MarkdownText';
+export type { SSEEvent, SSEChunkEvent, SSECompleteEvent, SSEErrorEvent } from './sse';

package/dist/ui/src/components/chat/sse.d.ts

@@ -0,0 +1,25 @@
+/**
+ * SSE (Server-Sent Events) Parser
+ *
+ * Utilities for parsing SSE streams from chat endpoints.
+ */
+export interface SSEChunkEvent {
+    type: "chunk";
+    token: string;
+}
+export interface SSECompleteEvent {
+    type: "complete";
+}
+export interface SSEErrorEvent {
+    type: "error";
+    message: string;
+}
+export type SSEEvent = SSEChunkEvent | SSECompleteEvent | SSEErrorEvent;
+/**
+ * Parse a raw SSE event string into a structured event.
+ */
+export declare function parseSseEvent(rawEvent: string): SSEEvent | null;
+/**
+ * Read an SSE stream and yield parsed events.
+ */
+export declare function readSseStream(response: Response, signal: AbortSignal): AsyncGenerator<SSEEvent>;

package/dist/ui/src/components/chat/storage.d.ts

@@ -0,0 +1,22 @@
+import { StoredChatMessage, ChatMessage } from './types';
+
+/**
+ * Safely read chat history from localStorage.
+ */
+export declare function safeReadChatFromStorage(key: string): StoredChatMessage[] | null;
+/**
+ * Safely write chat history to localStorage.
+ */
+export declare function safeWriteChatToStorage(key: string, value: StoredChatMessage[]): void;
+/**
+ * Safely remove chat history from localStorage.
+ */
+export declare function safeRemoveChatFromStorage(key: string): void;
+/**
+ * Convert ChatMessage array to StoredChatMessage array for persistence.
+ */
+export declare function messagesToStored(messages: ChatMessage[]): StoredChatMessage[];
+/**
+ * Convert StoredChatMessage array to ChatMessage array.
+ */
+export declare function storedToMessages(stored: StoredChatMessage[]): ChatMessage[];

package/dist/ui/src/components/chat/suggestions.d.ts

@@ -0,0 +1,12 @@
+import { ChatSuggestion } from './types';
+
+export declare const DEFAULT_SUGGESTIONS: Record<string, ChatSuggestion[]>;
+/**
+ * Get default suggestions for a language.
+ * Falls back to English if the language is not supported.
+ */
+export declare function getDefaultSuggestions(language: string): ChatSuggestion[];
+/**
+ * Get browser language code (first two characters).
+ */
+export declare function getBrowserLanguage(): string;

package/dist/ui/src/components/chat/time-utils.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Time/Timecode Utilities
+ *
+ * Parse and format timecodes for chat time references.
+ */
+/**
+ * Parse a timecode string (MM:SS or HH:MM:SS) to seconds.
+ * Returns null if the timecode is invalid.
+ */
+export declare function parseTimecodeToSeconds(timecode: string): number | null;
+/**
+ * Format seconds as a timecode string (MM:SS or H:MM:SS).
+ */
+export declare function formatSecondsAsTimecode(totalSeconds: number): string;
+/**
+ * Convert time references in markdown text to hash links.
+ * Converts "00:33" to "[00:33](#t=33)" and "00:33 - 00:53" to "[00:33](#t=33&e=53)".
+ */
+export declare function linkifyTimeReferencesInMarkdown(markdown: string): string;

package/dist/ui/src/components/chat/types.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Shared Chat Component Types
+ *
+ * Types shared across all chat implementations (dashboard, share, collection).
+ */
+export interface ChatMoment {
+    startSeconds: number;
+    endSeconds: number;
+    label: string;
+    modality?: "transcript" | "vision";
+}
+export interface ChatAnswerItem {
+    text: string;
+    moments: ChatMoment[];
+}
+export interface ChatResponse {
+    title?: string;
+    items: ChatAnswerItem[];
+    followUps: string[];
+    grounding: "embeddings" | "transcript_only";
+    language: string;
+}
+export interface ChatMessage {
+    role: "user" | "assistant";
+    content: string;
+    response?: ChatResponse;
+    status?: "thinking" | "streaming" | "complete";
+    timestamp: Date;
+}
+export interface ChatSuggestion {
+    id: string;
+    label: string;
+    prompt: string;
+}
+export interface StoredChatMessage {
+    role: "user" | "assistant";
+    content: string;
+    response?: ChatResponse;
+    status?: "thinking" | "streaming" | "complete";
+    timestamp: string;
+}
+export interface ChatStreamRequest {
+    prompt: string;
+    language: string;
+    history: Array<{
+        role: "user" | "assistant";
+        content: string;
+    }>;
+    regenerate: boolean;
+}
+export interface ChatTransport {
+    /**
+     * Stream chat response via SSE.
+     * Returns a Response object with a readable body that emits SSE events.
+     */
+    stream: (request: ChatStreamRequest, signal: AbortSignal) => Promise<Response>;
+    /**
+     * Optional: Get hydrated response with structured data (follow-ups, moments).
+     * Called after streaming completes to enhance the response.
+     */
+    hydrate?: (request: ChatStreamRequest, signal: AbortSignal) => Promise<ChatResponse | null>;
+    /**
+     * Optional: Fetch dynamic suggestions for the chat.
+     */
+    suggestions?: (language: string) => Promise<ChatSuggestion[]>;
+}
+export interface ChatPanelProps {
+    /**
+     * Chat transport for API communication.
+     * Injected by the wrapper component to allow different backends.
+     */
+    transport: ChatTransport;
+    /**
+     * Language code for localization (e.g., "en", "es", "fr").
+     */
+    language: string;
+    /**
+     * Unique key for localStorage persistence.
+     * If not provided or persist is false, chat history won't be saved.
+     */
+    storageKey?: string;
+    /**
+     * Whether to persist chat history to localStorage.
+     * @default true if storageKey is provided
+     */
+    persist?: boolean;
+    /**
+     * Whether the media player is ready for seeking.
+     * Disables time tag clicks when false.
+     */
+    playerReady?: boolean;
+    /**
+     * Callback when a time moment is clicked.
+     * Receives the start time in seconds.
+     */
+    onPlayMoment?: (params: {
+        startSeconds: number;
+        endSeconds?: number;
+    }) => void;
+    /**
+     * Optional callback to add answer text to notes.
+     * If provided, shows "Add to notes" button.
+     */
+    onAddToNotes?: (markdown: string) => void;
+    /**
+     * Configuration for follow-up suggestions.
+     */
+    followUps?: {
+        enabled: boolean;
+        max: number;
+    };
+    /**
+     * Empty state title.
+     * @default "Ask about this recording"
+     */
+    emptyStateTitle?: string;
+    /**
+     * Empty state subtitle.
+     * @default "Get insights grounded in the transcript and visual content"
+     */
+    emptyStateSubtitle?: string;
+    /**
+     * Input placeholder text.
+     * @default "Ask about the video..."
+     */
+    inputPlaceholder?: string;
+    /**
+     * CSS class variant for styling.
+     * - "default": Dashboard styling (larger, more spacious)
+     * - "compact": Share/embed styling (smaller, more compact)
+     * @default "default"
+     */
+    variant?: "default" | "compact";
+    /**
+     * Optional CSS class name for the container.
+     */
+    className?: string;
+}

package/dist/ui/src/components/toast.d.ts

@@ -2,5 +2,5 @@ import { Toaster as Sonner, toast } from 'sonner';
 
 import * as React from "react";
 type ToasterProps = React.ComponentProps<typeof Sonner>;
-declare const Toaster: ({ ...props }: ToasterProps) => import("react/jsx-runtime").JSX.Element;
+declare const Toaster: ({ closeButton, ...props }: ToasterProps) => import("react/jsx-runtime").JSX.Element;
 export { Toaster, toast };

package/dist/ui/src/index.d.ts

@@ -22,6 +22,7 @@ export { ThumbnailCard } from './components/thumbnail-card';
 export { ThumbnailPreviewOverlay } from './components/thumbnail-preview';
 export { ThumbnailStrip } from './components/thumbnail-strip';
 export { Squircle } from './components/squircle';
+export { ChatPanel, TimecodeTag, MarkdownText, safeReadChatFromStorage, safeWriteChatToStorage, safeRemoveChatFromStorage, messagesToStored, storedToMessages, parseSseEvent, readSseStream, parseTimecodeToSeconds, formatSecondsAsTimecode, linkifyTimeReferencesInMarkdown, getDefaultSuggestions, getBrowserLanguage, DEFAULT_SUGGESTIONS, } from './components/chat';
 export type { ButtonProps } from './components/button';
 export type { CardProps } from './components/card';
 export type { InputProps } from './components/input';
@@ -35,5 +36,6 @@ export type { LinkCopyButtonProps } from './components/link-copy-button';
 export type { ThumbnailCardProps } from './components/thumbnail-card';
 export type { ThumbnailPreviewOverlayProps } from './components/thumbnail-preview';
 export type { ThumbnailStripProps, ThumbnailData as UIThumbnailData } from './components/thumbnail-strip';
+export type { ChatPanelProps, ChatTransport, ChatStreamRequest, ChatMessage, ChatResponse, ChatAnswerItem, ChatMoment, ChatSuggestion, StoredChatMessage, TimecodeTagProps, MarkdownTextProps, SSEEvent, SSEChunkEvent, SSECompleteEvent, SSEErrorEvent, } from './components/chat';
 export { cn } from './lib/utils';
-export declare const UI_LIBRARY_VERSION = "0.2.10";
+export declare const UI_LIBRARY_VERSION = "0.2.12";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memoreco/ui",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "Memoreco shared UI components with Shadcn",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -16,19 +16,6 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "dev": "vite build --watch",
-    "build": "vite build",
-    "lint": "eslint src/ --ext .ts,.tsx",
-    "lint:fix": "eslint src/ --ext .ts,.tsx --fix",
-    "type-check": "tsc --noEmit",
-    "test": "vitest --run --passWithNoTests",
-    "test:ui": "vitest --ui",
-    "clean": "rimraf dist",
-    "release:check": "pnpm run lint && pnpm run type-check && pnpm run test && pnpm run build",
-    "release:publish": "node scripts/publish.mjs",
-    "prepublishOnly": "pnpm run release:check"
-  },
   "dependencies": {
     "@monokai/monoco": "^0.3.2",
     "@radix-ui/react-accordion": "^1.2.11",
@@ -41,13 +28,13 @@
     "class-variance-authority": "^0.7.0",
     "clsx": "^2.1.0",
     "lucide-react": "^0.542.0",
+    "react-markdown": "^10.1.0",
+    "remark-gfm": "^4.0.1",
     "sonner": "^2.0.7",
     "tailwind-merge": "^2.2.1"
   },
   "devDependencies": {
-    "@memoreco/types": "workspace:*",
-    "@memoreco/utils": "workspace:*",
-    "@types/node": "^20.19.17",
+    "@types/node": "^22.19.0",
     "@types/react": "^19.1.12",
     "@types/react-dom": "^19.1.9",
     "@vitejs/plugin-react": "^4.2.1",
@@ -60,11 +47,25 @@
     "typescript": "^5.9.2",
     "vite": "^5.0.12",
     "vite-plugin-dts": "^3.7.2",
-    "vitest": "^1.2.2"
+    "vitest": "^1.2.2",
+    "@memoreco/utils": "0.2.0",
+    "@memoreco/types": "0.2.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0"
   },
-  "sideEffects": false
+  "sideEffects": false,
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build",
+    "lint": "eslint src/ --ext .ts,.tsx",
+    "lint:fix": "eslint src/ --ext .ts,.tsx --fix",
+    "type-check": "tsc --noEmit",
+    "test": "vitest --run --passWithNoTests",
+    "test:ui": "vitest --ui",
+    "clean": "rimraf dist",
+    "release:check": "pnpm run lint && pnpm run type-check && pnpm run test && pnpm run build",
+    "release:publish": "node scripts/publish.mjs"
+  }
 }