@happyvertical/smrt-svelte 0.30.0

package/dist/state/context.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Svelte context helpers for app state
+ */
+import type { SmrtAppStateManager } from './app-state.svelte.js';
+/**
+ * Context key for app state
+ */
+export declare const APP_STATE_KEY: unique symbol;
+/**
+ * Set app state in context (used by SmrtProvider)
+ */
+export declare function setAppStateContext(state: SmrtAppStateManager): void;
+/**
+ * Get app state from context
+ * @throws If called outside of SmrtProvider
+ */
+export declare function getAppStateContext(): SmrtAppStateManager;
+/**
+ * Try to get app state from context
+ * Returns null if not available (doesn't throw)
+ */
+export declare function tryGetAppStateContext(): SmrtAppStateManager | null;
+//# sourceMappingURL=context.d.ts.map

package/dist/state/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/state/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,aAAa,eAA2B,CAAC;AAEtD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAEnE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,mBAAmB,CAUxD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,mBAAmB,GAAG,IAAI,CAElE"}

package/dist/state/context.js

@@ -0,0 +1,32 @@
+/**
+ * Svelte context helpers for app state
+ */
+import { getContext, setContext } from 'svelte';
+/**
+ * Context key for app state
+ */
+export const APP_STATE_KEY = Symbol('smrt-app-state');
+/**
+ * Set app state in context (used by SmrtProvider)
+ */
+export function setAppStateContext(state) {
+    setContext(APP_STATE_KEY, state);
+}
+/**
+ * Get app state from context
+ * @throws If called outside of SmrtProvider
+ */
+export function getAppStateContext() {
+    const state = getContext(APP_STATE_KEY);
+    if (!state) {
+        throw new Error('App state not found. Make sure to wrap your app with <SmrtProvider>');
+    }
+    return state;
+}
+/**
+ * Try to get app state from context
+ * Returns null if not available (doesn't throw)
+ */
+export function tryGetAppStateContext() {
+    return getContext(APP_STATE_KEY) ?? null;
+}

package/dist/state/form-context.d.ts

@@ -0,0 +1,59 @@
+/**
+ * SMRT Form context for field registration and coordination
+ */
+/**
+ * Field definition for form registration
+ */
+/** All supported form field types */
+export type FormFieldType = 'text' | 'email' | 'datetime' | 'number' | 'address' | 'checkbox' | 'daterange' | 'measurement' | 'money' | 'phone' | 'select' | 'textarea';
+export interface FieldDefinition {
+    /** Field name (used as key for LLM extraction) */
+    name: string;
+    /** Field type */
+    type: FormFieldType;
+    /** Human-readable label */
+    label?: string;
+    /** Description to help LLM understand field purpose */
+    description?: string;
+    /** Set the field value */
+    setValue: (value: unknown) => void;
+    /** Get current field value */
+    getValue: () => unknown;
+}
+/**
+ * SMRT Form context interface
+ */
+export interface SMRTFormContext {
+    /** Current mode */
+    readonly mode: 'smrt' | 'default';
+    /** Register a field with the form */
+    registerField: (field: FieldDefinition) => void;
+    /** Unregister a field */
+    unregisterField: (name: string) => void;
+    /** Get all registered fields schema (for LLM prompt) */
+    getFieldSchema: () => FieldDefinition[];
+    /** Whether form-level listening is active */
+    readonly isFormListening: boolean;
+    /** Whether currently extracting from speech */
+    readonly isExtracting: boolean;
+    /** Toggle form-level listening on/off */
+    toggleListening: () => void;
+}
+/**
+ * Context key for SMRT form
+ */
+export declare const SMRT_FORM_KEY: unique symbol;
+/**
+ * Set form context (used by SMRTForm)
+ */
+export declare function setFormContext(ctx: SMRTFormContext): void;
+/**
+ * Get form context
+ * @throws If called outside of SMRTForm
+ */
+export declare function getFormContext(): SMRTFormContext;
+/**
+ * Try to get form context (returns null if not available)
+ */
+export declare function tryGetFormContext(): SMRTFormContext | null;
+//# sourceMappingURL=form-context.d.ts.map

package/dist/state/form-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-context.d.ts","sourceRoot":"","sources":["../../src/state/form-context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,qCAAqC;AACrC,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,OAAO,GACP,UAAU,GACV,QAAQ,GACR,SAAS,GACT,UAAU,GACV,WAAW,GACX,aAAa,GACb,OAAO,GACP,OAAO,GACP,QAAQ,GACR,UAAU,CAAC;AAEf,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,IAAI,EAAE,aAAa,CAAC;IACpB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,qCAAqC;IACrC,aAAa,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAChD,yBAAyB;IACzB,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,wDAAwD;IACxD,cAAc,EAAE,MAAM,eAAe,EAAE,CAAC;IACxC,6CAA6C;IAC7C,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,yCAAyC;IACzC,eAAe,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,eAAsB,CAAC;AAEjD;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAEzD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,eAAe,CAUhD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,eAAe,GAAG,IAAI,CAE1D"}

package/dist/state/form-context.js

@@ -0,0 +1,31 @@
+/**
+ * SMRT Form context for field registration and coordination
+ */
+import { getContext, setContext } from 'svelte';
+/**
+ * Context key for SMRT form
+ */
+export const SMRT_FORM_KEY = Symbol('smrt-form');
+/**
+ * Set form context (used by SMRTForm)
+ */
+export function setFormContext(ctx) {
+    setContext(SMRT_FORM_KEY, ctx);
+}
+/**
+ * Get form context
+ * @throws If called outside of SMRTForm
+ */
+export function getFormContext() {
+    const ctx = getContext(SMRT_FORM_KEY);
+    if (!ctx) {
+        throw new Error('Form context not found. Make sure to wrap your inputs with <SMRTForm>');
+    }
+    return ctx;
+}
+/**
+ * Try to get form context (returns null if not available)
+ */
+export function tryGetFormContext() {
+    return getContext(SMRT_FORM_KEY) ?? null;
+}

package/dist/state/form-group-context.d.ts

@@ -0,0 +1,13 @@
+export interface FormGroupContextValue {
+    /** Stable id for the field control; matches the FormGroup label's `for`. */
+    inputId: string;
+    /** Space-joined ids of the visible hint/error text, or undefined if none. */
+    describedBy: string | undefined;
+    /** Whether the field is currently showing an error. */
+    invalid: boolean;
+}
+export declare function setFormGroupContext(get: () => FormGroupContextValue): void;
+export declare function tryGetFormGroupContext(): (() => FormGroupContextValue) | undefined;
+/** Deterministic, collision-resistant id for a FormGroup that wasn't given one. */
+export declare function nextFieldId(): string;
+//# sourceMappingURL=form-group-context.d.ts.map

package/dist/state/form-group-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-group-context.d.ts","sourceRoot":"","sources":["../../src/state/form-group-context.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;CAClB;AAID,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,qBAAqB,GAAG,IAAI,CAE1E;AAED,wBAAgB,sBAAsB,IAClC,CAAC,MAAM,qBAAqB,CAAC,GAC7B,SAAS,CAEZ;AAID,mFAAmF;AACnF,wBAAgB,WAAW,IAAI,MAAM,CAGpC"}

package/dist/state/form-group-context.js

@@ -0,0 +1,28 @@
+/**
+ * FormGroup accessibility context (Sweep L1, #1420).
+ *
+ * `FormGroup` publishes the wiring a wrapped input needs to be programmatically
+ * accessible — the input's `id` (so the `<label for>` resolves), the
+ * space-joined ids of the hint/error text (for `aria-describedby`), and whether
+ * the field is currently in an error state (`aria-invalid`). The base form
+ * primitives (`Input`, `Select`, `Textarea`) read this and auto-apply those
+ * attributes when the consumer hasn't set them explicitly, so an input dropped
+ * inside a `<FormGroup>` is accessible with no extra wiring.
+ *
+ * The value is a getter so the consuming input always reads the *current*
+ * reactive state (id is stable; describedBy/invalid change as hint/error do).
+ */
+import { getContext, setContext } from 'svelte';
+const FORM_GROUP_KEY = Symbol('smrt-form-group');
+export function setFormGroupContext(get) {
+    setContext(FORM_GROUP_KEY, get);
+}
+export function tryGetFormGroupContext() {
+    return getContext(FORM_GROUP_KEY);
+}
+let autoIdCounter = 0;
+/** Deterministic, collision-resistant id for a FormGroup that wasn't given one. */
+export function nextFieldId() {
+    autoIdCounter += 1;
+    return `smrt-field-${autoIdCounter}`;
+}

package/dist/state/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * App state management
+ */
+export * from './app-state.js';
+export * from './app-state.svelte.js';
+export * from './context.js';
+export * from './form-context.js';
+export * from './warm-clients.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}

package/dist/state/index.js

@@ -0,0 +1,8 @@
+/**
+ * App state management
+ */
+export * from './app-state.js';
+export * from './app-state.svelte.js';
+export * from './context.js';
+export * from './form-context.js';
+export * from './warm-clients.js';

package/dist/state/warm-clients.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Module-level warm client cache for AI adapters
+ *
+ * This cache persists across Svelte component lifecycle, surviving
+ * navigation between pages (SPA) and remounts of SmrtProvider.
+ *
+ * ## Key Benefits
+ * - Avoids re-downloading WASM/models on every navigation
+ * - Keeps WebGPU contexts warm (avoiding cold start delays)
+ * - Enables pre-initialization during idle time
+ *
+ * ## How It Works
+ * The cache is a simple Map at module scope. When SmrtProvider mounts,
+ * it checks the cache before creating new adapters. Adapters stay cached
+ * until explicitly cleared or the page is refreshed.
+ *
+ * ## Usage
+ * ```typescript
+ * import { getCachedSTT, getCacheStats, clearAllCaches } from '@happyvertical/smrt-svelte';
+ *
+ * // Check if whisper-cpp is already loaded
+ * const cached = getCachedSTT('whisper-cpp');
+ * if (cached?.initState === 'ready') {
+ *   console.log('STT already initialized!');
+ * }
+ *
+ * // Debug cache status
+ * const stats = getCacheStats();
+ * console.log('Cached adapters:', stats);
+ *
+ * // Clear cache to free memory
+ * await clearAllCaches();
+ * ```
+ *
+ * @module warm-clients
+ */
+import type { DownloadProgressInfo, InitState, LLMAdapter, STTAdapter, TTSAdapter } from '../browser-ai/index.js';
+/**
+ * Adapter cache entry with metadata
+ */
+export interface CachedAdapter<T> {
+    /** The adapter instance */
+    adapter: T;
+    /** When the adapter was cached */
+    cachedAt: number;
+    /** Initialization state */
+    initState: InitState;
+    /** Current download progress (if initializing) */
+    downloadProgress: DownloadProgressInfo | null;
+    /** Error if initialization failed */
+    error: Error | null;
+    /** Adapter type identifier (for cache key matching) */
+    type: string;
+}
+/**
+ * STT adapter types that can be cached
+ */
+export type STTType = 'browser-speech' | 'whisper-cpp' | 'whisper-wasm';
+/**
+ * TTS adapter types that can be cached
+ */
+export type TTSType = 'browser-synthesis';
+/**
+ * LLM adapter types that can be cached
+ */
+export type LLMType = 'webllm' | 'transformers-llm';
+/**
+ * Get a cached STT adapter
+ */
+export declare function getCachedSTT(type: STTType): CachedAdapter<STTAdapter> | undefined;
+/**
+ * Cache an STT adapter
+ */
+export declare function setCachedSTT(type: STTType, adapter: STTAdapter, initState?: InitState, error?: Error | null): void;
+/**
+ * Update STT cache entry state (for progress tracking)
+ */
+export declare function updateSTTCacheState(type: STTType, updates: Partial<Pick<CachedAdapter<STTAdapter>, 'initState' | 'downloadProgress' | 'error'>>): void;
+/**
+ * Remove an STT adapter from cache
+ */
+export declare function removeCachedSTT(type: STTType): void;
+/**
+ * Get a cached TTS adapter
+ */
+export declare function getCachedTTS(type: TTSType): CachedAdapter<TTSAdapter> | undefined;
+/**
+ * Cache a TTS adapter
+ */
+export declare function setCachedTTS(type: TTSType, adapter: TTSAdapter, initState?: InitState, error?: Error | null): void;
+/**
+ * Update TTS cache entry state
+ */
+export declare function updateTTSCacheState(type: TTSType, updates: Partial<Pick<CachedAdapter<TTSAdapter>, 'initState' | 'downloadProgress' | 'error'>>): void;
+/**
+ * Remove a TTS adapter from cache
+ */
+export declare function removeCachedTTS(type: TTSType): void;
+/**
+ * Get a cached LLM adapter
+ */
+export declare function getCachedLLM(type: LLMType, modelId?: string): CachedAdapter<LLMAdapter> | undefined;
+/**
+ * Cache an LLM adapter
+ */
+export declare function setCachedLLM(type: LLMType, adapter: LLMAdapter, modelId?: string, initState?: InitState, error?: Error | null): void;
+/**
+ * Update LLM cache entry state
+ */
+export declare function updateLLMCacheState(type: LLMType, modelId: string | undefined, updates: Partial<Pick<CachedAdapter<LLMAdapter>, 'initState' | 'downloadProgress' | 'error'>>): void;
+/**
+ * Remove an LLM adapter from cache
+ */
+export declare function removeCachedLLM(type: LLMType, modelId?: string): void;
+/**
+ * Clear all cached adapters
+ */
+export declare function clearAllCaches(): Promise<void>;
+/**
+ * Get cache statistics for debugging
+ */
+export declare function getCacheStats(): {
+    stt: {
+        count: number;
+        types: STTType[];
+    };
+    tts: {
+        count: number;
+        types: TTSType[];
+    };
+    llm: {
+        count: number;
+        keys: string[];
+    };
+};
+//# sourceMappingURL=warm-clients.d.ts.map

package/dist/state/warm-clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warm-clients.d.ts","sourceRoot":"","sources":["../../src/state/warm-clients.ts"],"names":[],"mappings":"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"}

package/dist/state/warm-clients.js

@@ -0,0 +1,231 @@
+/**
+ * Module-level warm client cache for AI adapters
+ *
+ * This cache persists across Svelte component lifecycle, surviving
+ * navigation between pages (SPA) and remounts of SmrtProvider.
+ *
+ * ## Key Benefits
+ * - Avoids re-downloading WASM/models on every navigation
+ * - Keeps WebGPU contexts warm (avoiding cold start delays)
+ * - Enables pre-initialization during idle time
+ *
+ * ## How It Works
+ * The cache is a simple Map at module scope. When SmrtProvider mounts,
+ * it checks the cache before creating new adapters. Adapters stay cached
+ * until explicitly cleared or the page is refreshed.
+ *
+ * ## Usage
+ * ```typescript
+ * import { getCachedSTT, getCacheStats, clearAllCaches } from '@happyvertical/smrt-svelte';
+ *
+ * // Check if whisper-cpp is already loaded
+ * const cached = getCachedSTT('whisper-cpp');
+ * if (cached?.initState === 'ready') {
+ *   console.log('STT already initialized!');
+ * }
+ *
+ * // Debug cache status
+ * const stats = getCacheStats();
+ * console.log('Cached adapters:', stats);
+ *
+ * // Clear cache to free memory
+ * await clearAllCaches();
+ * ```
+ *
+ * @module warm-clients
+ */
+/**
+ * Module-level cache - survives component remounts
+ */
+const sttCache = new Map();
+const ttsCache = new Map();
+const llmCache = new Map(); // key = type:modelId
+/**
+ * Get a cached STT adapter
+ */
+export function getCachedSTT(type) {
+    return sttCache.get(type);
+}
+/**
+ * Cache an STT adapter
+ */
+export function setCachedSTT(type, adapter, initState = 'ready', error = null) {
+    sttCache.set(type, {
+        adapter,
+        cachedAt: Date.now(),
+        initState,
+        downloadProgress: null,
+        error,
+        type,
+    });
+}
+/**
+ * Update STT cache entry state (for progress tracking)
+ */
+export function updateSTTCacheState(type, updates) {
+    const entry = sttCache.get(type);
+    if (entry) {
+        Object.assign(entry, updates);
+    }
+}
+/**
+ * Remove an STT adapter from cache
+ */
+export function removeCachedSTT(type) {
+    const entry = sttCache.get(type);
+    if (entry) {
+        const disposeResult = entry.adapter.dispose?.();
+        disposeResult?.catch?.((error) => {
+            console.error('Error disposing STT adapter:', type, error);
+        });
+        sttCache.delete(type);
+    }
+}
+/**
+ * Get a cached TTS adapter
+ */
+export function getCachedTTS(type) {
+    return ttsCache.get(type);
+}
+/**
+ * Cache a TTS adapter
+ */
+export function setCachedTTS(type, adapter, initState = 'ready', error = null) {
+    ttsCache.set(type, {
+        adapter,
+        cachedAt: Date.now(),
+        initState,
+        downloadProgress: null,
+        error,
+        type,
+    });
+}
+/**
+ * Update TTS cache entry state
+ */
+export function updateTTSCacheState(type, updates) {
+    const entry = ttsCache.get(type);
+    if (entry) {
+        Object.assign(entry, updates);
+    }
+}
+/**
+ * Remove a TTS adapter from cache
+ */
+export function removeCachedTTS(type) {
+    const entry = ttsCache.get(type);
+    if (entry) {
+        const disposeResult = entry.adapter.dispose?.();
+        disposeResult?.catch?.((error) => {
+            console.error('Error disposing TTS adapter:', type, error);
+        });
+        ttsCache.delete(type);
+    }
+}
+/**
+ * Get a cached LLM adapter
+ */
+export function getCachedLLM(type, modelId) {
+    const key = modelId ? `${type}:${modelId}` : type;
+    return llmCache.get(key);
+}
+/**
+ * Cache an LLM adapter
+ */
+export function setCachedLLM(type, adapter, modelId, initState = 'ready', error = null) {
+    const key = modelId ? `${type}:${modelId}` : type;
+    llmCache.set(key, {
+        adapter,
+        cachedAt: Date.now(),
+        initState,
+        downloadProgress: null,
+        error,
+        type,
+    });
+}
+/**
+ * Update LLM cache entry state
+ */
+export function updateLLMCacheState(type, modelId, updates) {
+    const key = modelId ? `${type}:${modelId}` : type;
+    const entry = llmCache.get(key);
+    if (entry) {
+        Object.assign(entry, updates);
+    }
+}
+/**
+ * Remove an LLM adapter from cache
+ */
+export function removeCachedLLM(type, modelId) {
+    const key = modelId ? `${type}:${modelId}` : type;
+    const entry = llmCache.get(key);
+    if (entry) {
+        const disposeResult = entry.adapter.dispose?.();
+        disposeResult?.catch?.((error) => {
+            console.error('Error disposing LLM adapter:', key, error);
+        });
+        llmCache.delete(key);
+    }
+}
+/**
+ * Clear all cached adapters
+ */
+export async function clearAllCaches() {
+    const errors = [];
+    // Dispose all STT adapters
+    for (const [type, entry] of sttCache.entries()) {
+        try {
+            await entry.adapter.dispose?.();
+        }
+        catch (error) {
+            console.error('Error disposing STT adapter:', type, error);
+            errors.push(error);
+        }
+    }
+    sttCache.clear();
+    // Dispose all TTS adapters
+    for (const [type, entry] of ttsCache.entries()) {
+        try {
+            await entry.adapter.dispose?.();
+        }
+        catch (error) {
+            console.error('Error disposing TTS adapter:', type, error);
+            errors.push(error);
+        }
+    }
+    ttsCache.clear();
+    // Dispose all LLM adapters
+    for (const [key, entry] of llmCache.entries()) {
+        try {
+            await entry.adapter.dispose?.();
+        }
+        catch (error) {
+            console.error('Error disposing LLM adapter:', key, error);
+            errors.push(error);
+        }
+    }
+    llmCache.clear();
+    // Throw the first error after all caches are cleared
+    if (errors.length > 0) {
+        throw errors[0];
+    }
+}
+/**
+ * Get cache statistics for debugging
+ */
+export function getCacheStats() {
+    return {
+        stt: {
+            count: sttCache.size,
+            types: Array.from(sttCache.keys()),
+        },
+        tts: {
+            count: ttsCache.size,
+            types: Array.from(ttsCache.keys()),
+        },
+        llm: {
+            count: llmCache.size,
+            keys: Array.from(llmCache.keys()),
+        },
+    };
+}