@happyvertical/smrt-svelte 0.30.0

package/dist/browser-ai/adapters/tts/factory.d.ts

@@ -0,0 +1,53 @@
+/**
+ * TTS adapter factory with type guards
+ *
+ * Uses discriminated unions and lazy loading following SDK patterns.
+ */
+import type { BrowserSynthesisTTSOptions, TTSAdapter } from './types.js';
+/**
+ * Options for getting a TTS adapter
+ */
+export type GetTTSOptions = (BrowserSynthesisTTSOptions & {
+    type?: 'browser-synthesis';
+}) | {
+    type: 'transformers';
+};
+/**
+ * Create a TTS adapter
+ *
+ * Uses lazy loading to only import the requested adapter.
+ *
+ * @example
+ * ```ts
+ * // Browser Speech Synthesis (default)
+ * const tts = await getTTS();
+ *
+ * // Explicit Browser Synthesis
+ * const tts = await getTTS({ type: 'browser-synthesis' });
+ *
+ * // With custom defaults
+ * const tts = await getTTS({ defaultRate: 1.2, defaultVoice: 'Google US English' });
+ * ```
+ */
+export declare function getTTS(options?: GetTTSOptions): Promise<TTSAdapter>;
+/**
+ * Auto-detect and create the best available TTS adapter
+ *
+ * Selection priority:
+ * 1. Browser Speech Synthesis (no download, instant)
+ * 2. Transformers.js TTS (requires model download)
+ *
+ * @throws {Error} If no TTS adapter is available
+ *
+ * @example
+ * ```ts
+ * const tts = await getTTSAuto();
+ * console.log(`Using ${tts.type} adapter`);
+ * ```
+ */
+export declare function getTTSAuto(options?: Partial<Omit<GetTTSOptions, 'type'>>): Promise<TTSAdapter>;
+/**
+ * Check if a specific TTS backend is available
+ */
+export declare function isTTSAvailable(type: 'browser-synthesis' | 'transformers'): boolean;
+//# sourceMappingURL=factory.d.ts.map

package/dist/browser-ai/adapters/tts/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/browser-ai/adapters/tts/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,0BAA0B,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,CAAC,0BAA0B,GAAG;IAAE,IAAI,CAAC,EAAE,mBAAmB,CAAA;CAAE,CAAC,GAC7D;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC;AAoB7B;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAgB7E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAC9B,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAM,GACjD,OAAO,CAAC,UAAU,CAAC,CAiBrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,mBAAmB,GAAG,cAAc,GACzC,OAAO,CAYT"}

package/dist/browser-ai/adapters/tts/factory.js

@@ -0,0 +1,92 @@
+/**
+ * TTS adapter factory with type guards
+ *
+ * Uses discriminated unions and lazy loading following SDK patterns.
+ */
+import { detectCapabilities, getBestTTSBackend, } from '../../capabilities/detector.js';
+import { UnsupportedAdapterError } from '../../core/errors.js';
+/**
+ * Type guard for Browser Speech Synthesis options
+ */
+function isBrowserSynthesisOptions(options) {
+    return !options.type || options.type === 'browser-synthesis';
+}
+/**
+ * Type guard for Transformers.js TTS options
+ */
+function isTransformersOptions(options) {
+    return options.type === 'transformers';
+}
+/**
+ * Create a TTS adapter
+ *
+ * Uses lazy loading to only import the requested adapter.
+ *
+ * @example
+ * ```ts
+ * // Browser Speech Synthesis (default)
+ * const tts = await getTTS();
+ *
+ * // Explicit Browser Synthesis
+ * const tts = await getTTS({ type: 'browser-synthesis' });
+ *
+ * // With custom defaults
+ * const tts = await getTTS({ defaultRate: 1.2, defaultVoice: 'Google US English' });
+ * ```
+ */
+export async function getTTS(options = {}) {
+    if (isBrowserSynthesisOptions(options)) {
+        const { BrowserSynthesisTTSAdapter } = await import('./browser-synthesis.js');
+        return new BrowserSynthesisTTSAdapter(options);
+    }
+    if (isTransformersOptions(options)) {
+        // Transformers.js TTS not yet implemented
+        throw new UnsupportedAdapterError('transformers', ['browser-synthesis']);
+    }
+    throw new UnsupportedAdapterError(options.type, [
+        'browser-synthesis',
+    ]);
+}
+/**
+ * Auto-detect and create the best available TTS adapter
+ *
+ * Selection priority:
+ * 1. Browser Speech Synthesis (no download, instant)
+ * 2. Transformers.js TTS (requires model download)
+ *
+ * @throws {Error} If no TTS adapter is available
+ *
+ * @example
+ * ```ts
+ * const tts = await getTTSAuto();
+ * console.log(`Using ${tts.type} adapter`);
+ * ```
+ */
+export async function getTTSAuto(options = {}) {
+    const caps = detectCapabilities();
+    const backend = getBestTTSBackend(caps);
+    if (!backend) {
+        throw new Error('No TTS capability available in this browser');
+    }
+    if (backend === 'browser-synthesis') {
+        return getTTS({
+            type: 'browser-synthesis',
+            ...options,
+        });
+    }
+    // Transformers.js TTS not yet implemented
+    throw new Error('Transformers.js TTS not yet implemented');
+}
+/**
+ * Check if a specific TTS backend is available
+ */
+export function isTTSAvailable(type) {
+    const caps = detectCapabilities();
+    if (type === 'browser-synthesis') {
+        return caps.tts.browserSynthesisAPI;
+    }
+    if (type === 'transformers') {
+        return caps.tts.transformersTTS;
+    }
+    return false;
+}

package/dist/browser-ai/adapters/tts/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Text-to-Speech adapters
+ */
+export { BrowserSynthesisTTSAdapter } from './browser-synthesis.js';
+export * from './factory.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser-ai/adapters/tts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/browser-ai/adapters/tts/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/browser-ai/adapters/tts/index.js

@@ -0,0 +1,6 @@
+/**
+ * Text-to-Speech adapters
+ */
+export { BrowserSynthesisTTSAdapter } from './browser-synthesis.js';
+export * from './factory.js';
+export * from './types.js';

package/dist/browser-ai/adapters/tts/types.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Text-to-Speech adapter types
+ */
+import type { InitState, OnProgress } from '../../core/types.js';
+/**
+ * Voice information
+ */
+export interface TTSVoice {
+    /** Voice identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Language code (BCP-47) */
+    language: string;
+    /** Whether this is a local voice */
+    local: boolean;
+    /** Whether this is the default voice */
+    default: boolean;
+}
+/**
+ * TTS synthesis options
+ */
+export interface TTSOptions {
+    /** Voice to use (by id or name) */
+    voice?: string;
+    /** Language code (BCP-47) */
+    language?: string;
+    /** Speech rate (0.1 to 10, default 1) */
+    rate?: number;
+    /** Pitch (0 to 2, default 1) */
+    pitch?: number;
+    /** Volume (0 to 1, default 1) */
+    volume?: number;
+}
+/**
+ * TTS adapter capabilities
+ */
+export interface TTSCapabilities {
+    /** Available voices */
+    voices: TTSVoice[];
+    /** Supports SSML markup */
+    ssml: boolean;
+    /** Supports rate adjustment */
+    rateRange: {
+        min: number;
+        max: number;
+    };
+    /** Supports pitch adjustment */
+    pitchRange: {
+        min: number;
+        max: number;
+    };
+    /** Requires download */
+    requiresDownload: boolean;
+}
+/**
+ * Browser Speech Synthesis adapter options
+ */
+export interface BrowserSynthesisTTSOptions {
+    /** Default language */
+    defaultLanguage?: string;
+    /** Default voice name */
+    defaultVoice?: string;
+    /** Default rate */
+    defaultRate?: number;
+    /** Default pitch */
+    defaultPitch?: number;
+    /** Default volume */
+    defaultVolume?: number;
+}
+/**
+ * TTS adapter interface
+ */
+export interface TTSAdapter {
+    /** Adapter type identifier */
+    readonly type: 'browser-synthesis' | 'transformers';
+    /** Current initialization state */
+    readonly initState: InitState;
+    /**
+     * Ensure the adapter is initialized
+     * @param onProgress Optional progress callback for downloads
+     */
+    ensureInitialized(onProgress?: OnProgress): Promise<void>;
+    /**
+     * Get adapter capabilities
+     */
+    getCapabilities(): TTSCapabilities;
+    /**
+     * Get available voices
+     */
+    getVoices(): TTSVoice[];
+    /**
+     * Speak text
+     * @param text Text to speak
+     * @param options Synthesis options
+     * @returns Promise that resolves when speech is complete
+     */
+    speak(text: string, options?: TTSOptions): Promise<void>;
+    /**
+     * Stop current speech
+     */
+    stop(): void;
+    /**
+     * Pause current speech
+     */
+    pause(): void;
+    /**
+     * Resume paused speech
+     */
+    resume(): void;
+    /**
+     * Check if currently speaking
+     */
+    isSpeaking(): boolean;
+    /**
+     * Check if paused
+     */
+    isPaused(): boolean;
+    /**
+     * Register callback for when speech starts
+     */
+    onStart(callback: () => void): () => void;
+    /**
+     * Register callback for when speech ends
+     */
+    onEnd(callback: () => void): () => void;
+    /**
+     * Register callback for errors
+     */
+    onError(callback: (error: Error) => void): () => void;
+    /**
+     * Register callback for word boundary events
+     */
+    onBoundary(callback: (charIndex: number, charLength: number) => void): () => void;
+    /**
+     * Dispose of resources
+     */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/browser-ai/adapters/tts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/browser-ai/adapters/tts/types.ts"],"names":[],"mappings":"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"}

package/dist/browser-ai/adapters/tts/types.js

@@ -0,0 +1,4 @@
+/**
+ * Text-to-Speech adapter types
+ */
+export {};

package/dist/browser-ai/capabilities/detector.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Browser capability detection for AI features
+ */
+import type { BrowserAICapabilities } from '../core/types.js';
+/**
+ * Detect all browser AI capabilities
+ * This is synchronous and cheap to call - no network requests
+ */
+export declare function detectCapabilities(): BrowserAICapabilities;
+/**
+ * Check if any STT capability is available
+ */
+export declare function hasSTT(caps: BrowserAICapabilities): boolean;
+/**
+ * Check if any TTS capability is available
+ */
+export declare function hasTTS(caps: BrowserAICapabilities): boolean;
+/**
+ * Check if any LLM capability is available
+ */
+export declare function hasLLM(caps: BrowserAICapabilities): boolean;
+/**
+ * Check if "smrt" mode can be enabled (at least one AI capability available)
+ */
+export declare function canEnableSmrtMode(caps: BrowserAICapabilities): boolean;
+/**
+ * Get the best available STT backend
+ */
+export declare function getBestSTTBackend(caps: BrowserAICapabilities): 'whisper-wasm' | 'browser-speech' | null;
+/**
+ * Get the best available TTS backend
+ */
+export declare function getBestTTSBackend(caps: BrowserAICapabilities): 'browser-synthesis' | 'transformers' | null;
+/**
+ * Get the best available LLM backend
+ */
+export declare function getBestLLMBackend(caps: BrowserAICapabilities): 'webllm' | 'transformers-llm' | null;
+//# sourceMappingURL=detector.d.ts.map

package/dist/browser-ai/capabilities/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/browser-ai/capabilities/detector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,qBAAqB,CAS1D;AAqJD;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAEtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,qBAAqB,GAC1B,cAAc,GAAG,gBAAgB,GAAG,IAAI,CAY1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,qBAAqB,GAC1B,mBAAmB,GAAG,cAAc,GAAG,IAAI,CAS7C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,qBAAqB,GAC1B,QAAQ,GAAG,kBAAkB,GAAG,IAAI,CAYtC"}

package/dist/browser-ai/capabilities/detector.js

@@ -0,0 +1,211 @@
+/**
+ * Browser capability detection for AI features
+ */
+/**
+ * Detect all browser AI capabilities
+ * This is synchronous and cheap to call - no network requests
+ */
+export function detectCapabilities() {
+    const browser = detectBrowserCapabilities();
+    return {
+        stt: detectSTTCapabilities(browser),
+        tts: detectTTSCapabilities(browser),
+        llm: detectLLMCapabilities(browser),
+        browser,
+    };
+}
+/**
+ * Detect general browser capabilities
+ */
+function detectBrowserCapabilities() {
+    // Check if we're in a browser environment
+    const isBrowser = typeof window !== 'undefined';
+    if (!isBrowser) {
+        return {
+            sharedArrayBuffer: false,
+            webWorkers: false,
+            indexedDB: false,
+            wasmSupport: false,
+            wasmSimd: false,
+        };
+    }
+    return {
+        sharedArrayBuffer: typeof SharedArrayBuffer !== 'undefined',
+        webWorkers: typeof Worker !== 'undefined',
+        indexedDB: typeof indexedDB !== 'undefined',
+        wasmSupport: typeof WebAssembly !== 'undefined',
+        wasmSimd: detectWasmSimd(),
+    };
+}
+/**
+ * Detect WASM SIMD support
+ */
+function detectWasmSimd() {
+    if (typeof WebAssembly === 'undefined')
+        return false;
+    try {
+        // SIMD detection via a minimal WASM module that uses SIMD
+        // This is the standard way to detect SIMD support
+        const simdTest = new Uint8Array([
+            0x00,
+            0x61,
+            0x73,
+            0x6d, // WASM magic
+            0x01,
+            0x00,
+            0x00,
+            0x00, // Version 1
+            0x01,
+            0x05,
+            0x01,
+            0x60,
+            0x00,
+            0x01,
+            0x7b, // Type section: () -> v128
+            0x03,
+            0x02,
+            0x01,
+            0x00, // Function section
+            0x0a,
+            0x0a,
+            0x01,
+            0x08,
+            0x00,
+            0xfd,
+            0x0c, // Code with v128.const
+            0x00,
+            0x00,
+            0x00,
+            0x00,
+            0x00,
+            0x00,
+            0x00,
+            0x00,
+            0x00,
+            0x00,
+            0x00,
+            0x00,
+            0x00,
+            0x00,
+            0x00,
+            0x00,
+            0x0b,
+        ]);
+        return WebAssembly.validate(simdTest);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Detect STT capabilities
+ */
+function detectSTTCapabilities(browser) {
+    const isBrowser = typeof window !== 'undefined';
+    return {
+        // Web Speech API
+        browserSpeechAPI: isBrowser &&
+            ('SpeechRecognition' in window || 'webkitSpeechRecognition' in window),
+        // Whisper WASM requires WASM support
+        // SharedArrayBuffer is nice for threading but not strictly required
+        whisperWasm: browser.wasmSupport,
+    };
+}
+/**
+ * Detect TTS capabilities
+ */
+function detectTTSCapabilities(browser) {
+    const isBrowser = typeof window !== 'undefined';
+    return {
+        // Speech Synthesis API
+        browserSynthesisAPI: isBrowser && 'speechSynthesis' in window,
+        // Transformers.js TTS requires WASM
+        transformersTTS: browser.wasmSupport,
+    };
+}
+/**
+ * Detect LLM capabilities
+ */
+function detectLLMCapabilities(browser) {
+    const isBrowser = typeof window !== 'undefined';
+    // Check for WebGPU
+    const webgpu = isBrowser && 'gpu' in navigator;
+    return {
+        // WebLLM requires WebGPU for good performance
+        // Can fall back to WASM but very slow
+        webllm: webgpu || browser.wasmSupport,
+        // Transformers.js can use WASM
+        transformersLLM: browser.wasmSupport,
+        // WebGPU for acceleration
+        webgpu,
+    };
+}
+/**
+ * Check if any STT capability is available
+ */
+export function hasSTT(caps) {
+    return caps.stt.browserSpeechAPI || caps.stt.whisperWasm;
+}
+/**
+ * Check if any TTS capability is available
+ */
+export function hasTTS(caps) {
+    return caps.tts.browserSynthesisAPI || caps.tts.transformersTTS;
+}
+/**
+ * Check if any LLM capability is available
+ */
+export function hasLLM(caps) {
+    return caps.llm.webllm || caps.llm.transformersLLM;
+}
+/**
+ * Check if "smrt" mode can be enabled (at least one AI capability available)
+ */
+export function canEnableSmrtMode(caps) {
+    return hasSTT(caps) || hasTTS(caps) || hasLLM(caps);
+}
+/**
+ * Get the best available STT backend
+ */
+export function getBestSTTBackend(caps) {
+    // Prefer Whisper for accuracy if available
+    if (caps.stt.whisperWasm && caps.llm.webgpu) {
+        return 'whisper-wasm';
+    }
+    if (caps.stt.browserSpeechAPI) {
+        return 'browser-speech';
+    }
+    if (caps.stt.whisperWasm) {
+        return 'whisper-wasm';
+    }
+    return null;
+}
+/**
+ * Get the best available TTS backend
+ */
+export function getBestTTSBackend(caps) {
+    // Prefer browser synthesis (no download, instant)
+    if (caps.tts.browserSynthesisAPI) {
+        return 'browser-synthesis';
+    }
+    if (caps.tts.transformersTTS) {
+        return 'transformers';
+    }
+    return null;
+}
+/**
+ * Get the best available LLM backend
+ */
+export function getBestLLMBackend(caps) {
+    // Prefer WebLLM with WebGPU for performance
+    if (caps.llm.webllm && caps.llm.webgpu) {
+        return 'webllm';
+    }
+    if (caps.llm.transformersLLM) {
+        return 'transformers-llm';
+    }
+    if (caps.llm.webllm) {
+        return 'webllm';
+    }
+    return null;
+}

package/dist/browser-ai/core/errors.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Error classes for browser AI capabilities
+ */
+/**
+ * Base error class for browser AI operations
+ */
+export declare class BrowserAIError extends Error {
+    code: string;
+    adapter?: string | undefined;
+    constructor(message: string, code: string, adapter?: string | undefined);
+}
+/**
+ * Thrown when an adapter fails to initialize
+ */
+export declare class InitializationError extends BrowserAIError {
+    constructor(adapter: string, reason?: string);
+}
+/**
+ * Thrown when a required capability is not available
+ */
+export declare class CapabilityNotAvailableError extends BrowserAIError {
+    constructor(capability: string, adapter?: string);
+}
+/**
+ * Thrown when a model download fails
+ */
+export declare class DownloadError extends BrowserAIError {
+    url: string;
+    constructor(url: string, reason?: string, adapter?: string);
+}
+/**
+ * Thrown when model loading fails
+ */
+export declare class ModelLoadError extends BrowserAIError {
+    model: string;
+    constructor(model: string, reason?: string, adapter?: string);
+}
+/**
+ * Thrown when an operation times out
+ */
+export declare class TimeoutError extends BrowserAIError {
+    constructor(operation: string, timeoutMs: number, adapter?: string);
+}
+/**
+ * Thrown when user denies permission (e.g., microphone access)
+ */
+export declare class PermissionDeniedError extends BrowserAIError {
+    constructor(permission: string, adapter?: string);
+}
+/**
+ * Thrown when an adapter is not in the correct state for an operation
+ */
+export declare class InvalidStateError extends BrowserAIError {
+    constructor(expectedState: string, actualState: string, adapter?: string);
+}
+/**
+ * Thrown when an adapter type is not supported
+ */
+export declare class UnsupportedAdapterError extends BrowserAIError {
+    constructor(adapterType: string, supportedTypes: string[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/browser-ai/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/browser-ai/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IAG9B,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,MAAM;gBAFvB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,YAAA;CAK1B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;gBACzC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAQ7C;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,cAAc;gBACjD,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAQjD;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAEtC,GAAG,EAAE,MAAM;gBAAX,GAAG,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM;CASnB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,cAAc;IAEvC,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM;CASnB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,cAAc;gBAClC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAQnE;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,cAAc;gBAC3C,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAIjD;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;gBACvC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAQzE;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,cAAc;gBAC7C,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE;CAO1D"}