@signality/core 0.0.1-alpha.2

package/fesm2022/signality-core-browser-speech-synthesis.mjs

@@ -0,0 +1,146 @@
+import { signal } from '@angular/core';
+import { setupContext, constSignal, NOOP_FN } from '@signality/core/internal';
+
+/**
+ * Signal-based wrapper around the [Speech Synthesis API](https://developer.mozilla.org/en-US/docs/Web/API/SpeechSynthesis).
+ *
+ * @param options - Optional configuration
+ * @returns A SpeechSynthesisRef with isSupported, isSpeaking, isPaused, voices signals and control methods
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     @if (synthesis.isSupported()) {
+ *       <button (click)="speakText()" [disabled]="synthesis.isSpeaking()">
+ *         {{ synthesis.isSpeaking() ? 'Speaking...' : 'Speak' }}
+ *       </button>
+ *       <button (click)="synthesis.stop()">Stop</button>
+ *     }
+ *   `
+ * })
+ * class TextToSpeechComponent {
+ *   readonly synthesis = speechSynthesis();
+ *
+ *   speakText() {
+ *     this.synthesis.speak('Hello, world!');
+ *   }
+ * }
+ * ```
+ */
+function speechSynthesis(options) {
+    const { runInContext } = setupContext(options?.injector, speechSynthesis);
+    return runInContext(({ onCleanup, isBrowser }) => {
+        const isSupported = constSignal(isBrowser && 'speechSynthesis' in window && typeof window.speechSynthesis !== 'undefined');
+        if (!isSupported()) {
+            return {
+                isSupported,
+                isSpeaking: constSignal(false),
+                isPaused: constSignal(false),
+                voices: constSignal([]),
+                currentText: constSignal(''),
+                speak: NOOP_FN,
+                stop: NOOP_FN,
+                pause: NOOP_FN,
+                resume: NOOP_FN,
+            };
+        }
+        const { speechSynthesis } = window;
+        const { lang: defaultLang, rate: defaultRate = 1, pitch: defaultPitch = 1, volume: defaultVolume = 1, voice: defaultVoice, } = options ?? {};
+        const isSpeaking = signal(false, ...(ngDevMode ? [{ debugName: "isSpeaking" }] : []));
+        const isPaused = signal(false, ...(ngDevMode ? [{ debugName: "isPaused" }] : []));
+        const voices = signal(speechSynthesis.getVoices(), ...(ngDevMode ? [{ debugName: "voices" }] : []));
+        const currentText = signal('', ...(ngDevMode ? [{ debugName: "currentText" }] : []));
+        const loadVoices = () => {
+            const availableVoices = speechSynthesis.getVoices();
+            voices.set(availableVoices);
+        };
+        const updateSpeakingState = () => {
+            isSpeaking.set(speechSynthesis.speaking);
+            isPaused.set(speechSynthesis.paused);
+        };
+        const handleStart = () => {
+            isSpeaking.set(true);
+            isPaused.set(false);
+        };
+        const handleEnd = () => {
+            isSpeaking.set(false);
+            isPaused.set(false);
+            currentText.set('');
+        };
+        const handleError = () => {
+            isSpeaking.set(false);
+            isPaused.set(false);
+            currentText.set('');
+        };
+        const handlePause = () => {
+            isPaused.set(true);
+        };
+        const handleResume = () => {
+            isPaused.set(false);
+        };
+        const speak = (text, speakOptions) => {
+            if (!text) {
+                return;
+            }
+            speechSynthesis.cancel();
+            const utterance = new SpeechSynthesisUtterance(text);
+            const { lang = defaultLang, rate = defaultRate, pitch = defaultPitch, volume = defaultVolume, voice = defaultVoice, } = speakOptions ?? {};
+            if (lang)
+                utterance.lang = lang;
+            utterance.rate = rate;
+            utterance.pitch = pitch;
+            utterance.volume = volume;
+            if (voice)
+                utterance.voice = voice;
+            utterance.onstart = handleStart;
+            utterance.onend = handleEnd;
+            utterance.onerror = handleError;
+            utterance.onpause = handlePause;
+            utterance.onresume = handleResume;
+            currentText.set(text);
+            speechSynthesis.speak(utterance);
+            updateSpeakingState();
+        };
+        const stop = () => {
+            speechSynthesis.cancel();
+            isSpeaking.set(false);
+            isPaused.set(false);
+            currentText.set('');
+        };
+        const pause = () => {
+            if (speechSynthesis.speaking && !speechSynthesis.paused) {
+                speechSynthesis.pause();
+                isPaused.set(true);
+            }
+        };
+        const resume = () => {
+            if (speechSynthesis.paused) {
+                speechSynthesis.resume();
+                isPaused.set(false);
+            }
+        };
+        onCleanup(stop);
+        if (speechSynthesis.onvoiceschanged !== undefined) {
+            speechSynthesis.onvoiceschanged = loadVoices;
+        }
+        return {
+            isSupported,
+            isSpeaking: isSpeaking.asReadonly(),
+            isPaused: isPaused.asReadonly(),
+            voices: voices.asReadonly(),
+            currentText: currentText.asReadonly(),
+            speak,
+            stop,
+            pause,
+            resume,
+        };
+    });
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { speechSynthesis };
+//# sourceMappingURL=signality-core-browser-speech-synthesis.mjs.map

package/fesm2022/signality-core-browser-speech-synthesis.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-speech-synthesis.mjs","sources":["../../../projects/core/browser/speech-synthesis/index.ts","../../../projects/core/browser/speech-synthesis/signality-core-browser-speech-synthesis.ts"],"sourcesContent":["import { type Signal, signal } from '@angular/core';\nimport { constSignal, NOOP_FN, setupContext } from '@signality/core/internal';\nimport type { WithInjector } from '@signality/core/types';\n\nexport interface SpeechSynthesisSpeakOptions {\n  /** Text to speak */\n  readonly text: string;\n\n  /** Language code (e.g., 'en-US') */\n  readonly lang?: string;\n\n  /** Speech rate (0.1 to 10) */\n  readonly rate?: number;\n\n  /** Speech pitch (0 to 2) */\n  readonly pitch?: number;\n\n  /** Speech volume (0 to 1) */\n  readonly volume?: number;\n\n  /** Voice to use */\n  readonly voice?: SpeechSynthesisVoice;\n}\n\nexport interface SpeechSynthesisOptions extends WithInjector {\n  /** Default language */\n  readonly lang?: string;\n\n  /** Default speech rate */\n  readonly rate?: number;\n\n  /** Default pitch */\n  readonly pitch?: number;\n\n  /** Default volume */\n  readonly volume?: number;\n\n  /** Default voice */\n  readonly voice?: SpeechSynthesisVoice;\n}\n\nexport interface SpeechSynthesisRef {\n  /** Whether Speech Synthesis API is supported */\n  readonly isSupported: Signal<boolean>;\n\n  /** Whether speech is currently playing */\n  readonly isSpeaking: Signal<boolean>;\n\n  /** Whether speech is currently paused */\n  readonly isPaused: Signal<boolean>;\n\n  /** Available voices */\n  readonly voices: Signal<SpeechSynthesisVoice[]>;\n\n  /** Current speaking text */\n  readonly currentText: Signal<string>;\n\n  /** Speak text */\n  readonly speak: (text: string, options?: Partial<SpeechSynthesisSpeakOptions>) => void;\n\n  /** Stop speaking */\n  readonly stop: () => void;\n\n  /** Pause speaking */\n  readonly pause: () => void;\n\n  /** Resume speaking */\n  readonly resume: () => void;\n}\n\n/**\n * Signal-based wrapper around the [Speech Synthesis API](https://developer.mozilla.org/en-US/docs/Web/API/SpeechSynthesis).\n *\n * @param options - Optional configuration\n * @returns A SpeechSynthesisRef with isSupported, isSpeaking, isPaused, voices signals and control methods\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     @if (synthesis.isSupported()) {\n *       <button (click)=\"speakText()\" [disabled]=\"synthesis.isSpeaking()\">\n *         {{ synthesis.isSpeaking() ? 'Speaking...' : 'Speak' }}\n *       </button>\n *       <button (click)=\"synthesis.stop()\">Stop</button>\n *     }\n *   `\n * })\n * class TextToSpeechComponent {\n *   readonly synthesis = speechSynthesis();\n *\n *   speakText() {\n *     this.synthesis.speak('Hello, world!');\n *   }\n * }\n * ```\n */\nexport function speechSynthesis(options?: SpeechSynthesisOptions): SpeechSynthesisRef {\n  const { runInContext } = setupContext(options?.injector, speechSynthesis);\n\n  return runInContext(({ onCleanup, isBrowser }) => {\n    const isSupported = constSignal(\n      isBrowser && 'speechSynthesis' in window && typeof window.speechSynthesis !== 'undefined'\n    );\n\n    if (!isSupported()) {\n      return {\n        isSupported,\n        isSpeaking: constSignal(false),\n        isPaused: constSignal(false),\n        voices: constSignal([]),\n        currentText: constSignal(''),\n        speak: NOOP_FN,\n        stop: NOOP_FN,\n        pause: NOOP_FN,\n        resume: NOOP_FN,\n      };\n    }\n\n    const { speechSynthesis } = window;\n\n    const {\n      lang: defaultLang,\n      rate: defaultRate = 1,\n      pitch: defaultPitch = 1,\n      volume: defaultVolume = 1,\n      voice: defaultVoice,\n    } = options ?? {};\n\n    const isSpeaking = signal(false);\n    const isPaused = signal(false);\n    const voices = signal<SpeechSynthesisVoice[]>(speechSynthesis.getVoices());\n    const currentText = signal('');\n\n    const loadVoices = () => {\n      const availableVoices = speechSynthesis.getVoices();\n      voices.set(availableVoices);\n    };\n\n    const updateSpeakingState = () => {\n      isSpeaking.set(speechSynthesis.speaking);\n      isPaused.set(speechSynthesis.paused);\n    };\n\n    const handleStart = () => {\n      isSpeaking.set(true);\n      isPaused.set(false);\n    };\n\n    const handleEnd = () => {\n      isSpeaking.set(false);\n      isPaused.set(false);\n      currentText.set('');\n    };\n\n    const handleError = () => {\n      isSpeaking.set(false);\n      isPaused.set(false);\n      currentText.set('');\n    };\n\n    const handlePause = () => {\n      isPaused.set(true);\n    };\n\n    const handleResume = () => {\n      isPaused.set(false);\n    };\n\n    const speak = (text: string, speakOptions?: Partial<SpeechSynthesisSpeakOptions>) => {\n      if (!text) {\n        return;\n      }\n\n      speechSynthesis.cancel();\n\n      const utterance = new SpeechSynthesisUtterance(text);\n\n      const {\n        lang = defaultLang,\n        rate = defaultRate,\n        pitch = defaultPitch,\n        volume = defaultVolume,\n        voice = defaultVoice,\n      } = speakOptions ?? {};\n\n      if (lang) utterance.lang = lang;\n\n      utterance.rate = rate;\n      utterance.pitch = pitch;\n      utterance.volume = volume;\n\n      if (voice) utterance.voice = voice;\n\n      utterance.onstart = handleStart;\n      utterance.onend = handleEnd;\n      utterance.onerror = handleError;\n      utterance.onpause = handlePause;\n      utterance.onresume = handleResume;\n\n      currentText.set(text);\n      speechSynthesis.speak(utterance);\n\n      updateSpeakingState();\n    };\n\n    const stop = () => {\n      speechSynthesis.cancel();\n      isSpeaking.set(false);\n      isPaused.set(false);\n      currentText.set('');\n    };\n\n    const pause = () => {\n      if (speechSynthesis.speaking && !speechSynthesis.paused) {\n        speechSynthesis.pause();\n        isPaused.set(true);\n      }\n    };\n\n    const resume = () => {\n      if (speechSynthesis.paused) {\n        speechSynthesis.resume();\n        isPaused.set(false);\n      }\n    };\n\n    onCleanup(stop);\n\n    if (speechSynthesis.onvoiceschanged !== undefined) {\n      speechSynthesis.onvoiceschanged = loadVoices;\n    }\n\n    return {\n      isSupported,\n      isSpeaking: isSpeaking.asReadonly(),\n      isPaused: isPaused.asReadonly(),\n      voices: voices.asReadonly(),\n      currentText: currentText.asReadonly(),\n      speak,\n      stop,\n      pause,\n      resume,\n    };\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/fesm2022/signality-core-browser-storage.mjs

@@ -0,0 +1,261 @@
+import { signal, isSignal } from '@angular/core';
+import { setupContext, isPlainObject, toValue, proxySignal } from '@signality/core/internal';
+import { setupSync, listener } from '@signality/core/browser/listener';
+import { watcher } from '@signality/core/reactivity/watcher';
+
+/**
+ * Signal-based wrapper around the [Web Storage API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Storage_API) (localStorage/sessionStorage).
+ *
+ * @param key - Storage key (can be a signal for dynamic keys)
+ * @param initialValue - Default value if key doesn't exist
+ * @param options - Configuration options
+ * @returns A WritableSignal that automatically syncs with storage
+ *
+ * @example
+ * Basic usage with automatic serialization:
+ * ```typescript
+ * @Component({
+ *   template: '
+ *     <input [(ngModel)]="username" />
+ *     <p>Count: {{ count() }}</p>
+ *     <button (click)="count.set(count() + 1)">Increment</button>
+ *   '
+ * })
+ * class UserComponent {
+ *   readonly username = storage('username', '');
+ *   readonly count = storage('counter', 0); // number serialization inferred
+ *   readonly lastVisit = storage('lastVisit', new Date()); // Date serialization inferred
+ * }
+ * ```
+ *
+ * @example
+ * With options:
+ * ```typescript
+ * const preferences = storage('prefs', defaultPrefs, {
+ *   type: 'session',
+ *   mergeWithInitial: true,
+ * });
+ * ```
+ */
+function storage(key, initialValue, options) {
+    const { runInContext } = setupContext(options?.injector, storage);
+    return runInContext(({ isServer }) => {
+        if (isServer) {
+            return signal(initialValue, options);
+        }
+        const storageType = options?.type ?? 'local';
+        const serializer = resolveSerializer(initialValue, options);
+        const getStorage = () => {
+            const type = storageType === 'local' ? 'localStorage' : 'sessionStorage';
+            if (!storageAvailable(type)) {
+                if (ngDevMode) {
+                    console.warn(`[storage] ${type} is not available or accessible`);
+                }
+                return null;
+            }
+            return window[type];
+        };
+        const mergeWithInitial = (storedValue) => {
+            if (options?.mergeResolver) {
+                return options.mergeResolver(storedValue, initialValue);
+            }
+            if (isPlainObject(initialValue)) {
+                return { ...initialValue, ...storedValue };
+            }
+            return storedValue;
+        };
+        const readValue = (storageKey) => {
+            const storage = getStorage();
+            if (storage === null) {
+                return initialValue;
+            }
+            try {
+                const raw = storage.getItem(storageKey);
+                if (raw === null) {
+                    if (initialValue != null) {
+                        writeValue(initialValue);
+                    }
+                    return initialValue;
+                }
+                const parsed = serializer.read(raw);
+                return mergeWithInitial(parsed);
+            }
+            catch (error) {
+                if (ngDevMode) {
+                    console.warn(`[storage] Failed to deserialize value for key "${key}"`, error);
+                }
+                return initialValue;
+            }
+        };
+        const writeValue = (value) => {
+            const storage = getStorage();
+            const storageKey = toValue(key);
+            if (storage === null) {
+                return;
+            }
+            try {
+                if (value == null) {
+                    storage.removeItem(storageKey);
+                }
+                else {
+                    const serialized = serializer.write(value);
+                    storage.setItem(storageKey, serialized);
+                }
+            }
+            catch (error) {
+                if (ngDevMode) {
+                    console.warn(`[storage] Failed to write value for key "${storageKey}". ` +
+                        `This may be due to storage quota exceeded or serialization error.`, error);
+                }
+            }
+        };
+        const state = signal(readValue(toValue(key)), options);
+        if (storageType === 'local') {
+            setupSync(() => {
+                listener(window, 'storage', event => {
+                    const currentKey = toValue(key);
+                    if (event.key === currentKey && event.storageArea === window.localStorage) {
+                        try {
+                            const newValue = event.newValue === null
+                                ? initialValue
+                                : mergeWithInitial(serializer.read(event.newValue));
+                            state.set(newValue);
+                        }
+                        catch (error) {
+                            if (ngDevMode) {
+                                console.warn(`[storage] Failed to sync value from other tab for key "${event.key}"`, error);
+                            }
+                        }
+                    }
+                });
+            });
+        }
+        if (isSignal(key)) {
+            watcher(key, newKey => state.set(readValue(newKey)));
+        }
+        return proxySignal(state, {
+            set: (value) => {
+                state.set(value);
+                writeValue(value);
+            },
+        });
+    });
+}
+const Serializers = {
+    string: {
+        read: (v) => v,
+        write: (v) => v,
+    },
+    number: {
+        read: (v) => {
+            if (v === 'Infinity')
+                return Infinity;
+            if (v === '-Infinity')
+                return -Infinity;
+            if (v === 'NaN')
+                return NaN;
+            return Number.parseFloat(v);
+        },
+        write: (v) => {
+            if (Number.isNaN(v))
+                return 'NaN';
+            if (v === Infinity)
+                return 'Infinity';
+            if (v === -Infinity)
+                return '-Infinity';
+            return String(v);
+        },
+    },
+    boolean: {
+        read: (v) => v === 'true',
+        write: (v) => (v ? 'true' : 'false'),
+    },
+    bigint: {
+        read: (v) => BigInt(v),
+        write: (v) => v.toString(),
+    },
+    /*
+     * Date serializer - uses ISO 8601 format for maximum compatibility.
+     */
+    date: {
+        read: (v) => new Date(v),
+        write: (v) => v.toISOString(),
+    },
+    object: {
+        read: (v) => JSON.parse(v),
+        write: (v) => JSON.stringify(v),
+    },
+    map: {
+        read: (v) => new Map(JSON.parse(v)),
+        write: (v) => JSON.stringify([...v.entries()]),
+    },
+    set: {
+        read: (v) => new Set(JSON.parse(v)),
+        write: (v) => JSON.stringify([...v]),
+    },
+    /*
+     * Any serializer - fallback that treats everything as string.
+     */
+    any: {
+        read: (v) => v,
+        write: (v) => String(v),
+    },
+};
+function resolveSerializer(initialValue, options) {
+    if (options?.serializer) {
+        return options.serializer;
+    }
+    const type = inferSerializerType(initialValue);
+    return Serializers[type];
+}
+function inferSerializerType(value) {
+    if (value === null || value === undefined) {
+        return 'any';
+    }
+    if (value instanceof Map) {
+        return 'map';
+    }
+    if (value instanceof Set) {
+        return 'set';
+    }
+    if (value instanceof Date) {
+        return 'date';
+    }
+    switch (typeof value) {
+        case 'string':
+            return 'string';
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'bigint':
+            return 'bigint';
+        case 'object':
+            return 'object';
+        default:
+            return 'any';
+    }
+}
+function storageAvailable(type) {
+    let storage;
+    try {
+        storage = window[type];
+        const testKey = '__storage_test__';
+        storage.setItem(testKey, testKey);
+        storage.removeItem(testKey);
+        return true;
+    }
+    catch (e) {
+        return (e instanceof DOMException &&
+            e.name === 'QuotaExceededError' &&
+            storage !== undefined &&
+            storage.length !== 0);
+    }
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { Serializers, storage };
+//# sourceMappingURL=signality-core-browser-storage.mjs.map

package/fesm2022/signality-core-browser-storage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-storage.mjs","sources":["../../../projects/core/browser/storage/index.ts","../../../projects/core/browser/storage/signality-core-browser-storage.ts"],"sourcesContent":["import { type CreateSignalOptions, isSignal, signal, type WritableSignal } from '@angular/core';\nimport { isPlainObject, proxySignal, setupContext, toValue } from '@signality/core/internal';\nimport type { MaybeSignal, WithInjector } from '@signality/core/types';\nimport { listener, setupSync } from '@signality/core/browser/listener';\nimport { watcher } from '@signality/core/reactivity/watcher';\n\nexport interface StorageOptions<T> extends CreateSignalOptions<T>, WithInjector {\n  /**\n   * Storage type to use.\n   * @default 'local'\n   */\n  readonly type?: 'local' | 'session';\n\n  /**\n   * Custom serializer for read/write operations.\n   *\n   * If not provided, the serializer is automatically inferred from the initial value type:\n   * - `string` → pass-through (no transformation)\n   * - `number` → handles Infinity, -Infinity, NaN\n   * - `boolean` → strict true/false conversion\n   * - `bigint` → string representation\n   * - `Date` → ISO 8601 format\n   * - `Map` → JSON array of entries\n   * - `Set` → JSON array\n   * - `object/array` → JSON serialization\n   *\n   * @example\n   * ```typescript\n   * // Use built-in serializers\n   * import { Serializers } from '@signality/core';\n   *\n   * const counter = storage('count', 0, {\n   *   serializer: Serializers.number,\n   * });\n   *\n   * // or create a custom serializer\n   * const userSettings = storage('settings', defaultSettings, {\n   *   serializer: {\n   *     write: (v) => JSON.stringify(v),\n   *     read: (s) => ({ ...defaultSettings, ...JSON.parse(s) }),\n   *   },\n   * });\n   * ```\n   */\n  readonly serializer?: Serializer<T>;\n\n  /**\n   * Merge resolver function when reading from storage.\n   *\n   * Receives stored value and default value, returns the final value.\n   * Default: shallow merge for objects ({ ...initialValue, ...stored })\n   *\n   * Useful for handling schema migrations when default has new properties.\n   *\n   * @example\n   * ```typescript\n   * const settings = storage('settings', { theme: 'dark', fontSize: 14 }, {\n   *   mergeResolver: (stored, initial) => ({ ...initial, ...stored }),\n   * });\n   *\n   * // Or with custom merge\n   * const settings = storage('settings', defaultSettings, {\n   *   mergeResolver: (stored, initial) => deepMerge(stored, initial),\n   * });\n   * ```\n   */\n  readonly mergeResolver?: (storedValue: T, initialValue: T) => T;\n}\n\n/**\n * Serializer interface for converting values to/from strings for storage.\n */\nexport interface Serializer<T> {\n  readonly write: (value: T) => string;\n  readonly read: (raw: string) => T;\n}\n\n/**\n * Signal-based wrapper around the [Web Storage API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Storage_API) (localStorage/sessionStorage).\n *\n * @param key - Storage key (can be a signal for dynamic keys)\n * @param initialValue - Default value if key doesn't exist\n * @param options - Configuration options\n * @returns A WritableSignal that automatically syncs with storage\n *\n * @example\n * Basic usage with automatic serialization:\n * ```typescript\n * @Component({\n *   template: '\n *     <input [(ngModel)]=\"username\" />\n *     <p>Count: {{ count() }}</p>\n *     <button (click)=\"count.set(count() + 1)\">Increment</button>\n *   '\n * })\n * class UserComponent {\n *   readonly username = storage('username', '');\n *   readonly count = storage('counter', 0); // number serialization inferred\n *   readonly lastVisit = storage('lastVisit', new Date()); // Date serialization inferred\n * }\n * ```\n *\n * @example\n * With options:\n * ```typescript\n * const preferences = storage('prefs', defaultPrefs, {\n *   type: 'session',\n *   mergeWithInitial: true,\n * });\n * ```\n */\nexport function storage<T>(\n  key: MaybeSignal<string>,\n  initialValue: T,\n  options?: StorageOptions<T>\n): WritableSignal<T> {\n  const { runInContext } = setupContext(options?.injector, storage);\n\n  return runInContext(({ isServer }) => {\n    if (isServer) {\n      return signal(initialValue, options);\n    }\n\n    const storageType = options?.type ?? 'local';\n    const serializer = resolveSerializer(initialValue, options);\n\n    const getStorage = (): Storage | null => {\n      const type = storageType === 'local' ? 'localStorage' : 'sessionStorage';\n\n      if (!storageAvailable(type)) {\n        if (ngDevMode) {\n          console.warn(`[storage] ${type} is not available or accessible`);\n        }\n        return null;\n      }\n\n      return window[type];\n    };\n\n    const mergeWithInitial = (storedValue: T) => {\n      if (options?.mergeResolver) {\n        return options.mergeResolver(storedValue, initialValue);\n      }\n\n      if (isPlainObject(initialValue)) {\n        return { ...initialValue, ...storedValue };\n      }\n\n      return storedValue;\n    };\n\n    const readValue = (storageKey: string): T => {\n      const storage = getStorage();\n\n      if (storage === null) {\n        return initialValue;\n      }\n\n      try {\n        const raw = storage.getItem(storageKey);\n\n        if (raw === null) {\n          if (initialValue != null) {\n            writeValue(initialValue);\n          }\n          return initialValue;\n        }\n\n        const parsed = serializer.read(raw);\n        return mergeWithInitial(parsed);\n      } catch (error) {\n        if (ngDevMode) {\n          console.warn(`[storage] Failed to deserialize value for key \"${key}\"`, error);\n        }\n\n        return initialValue;\n      }\n    };\n\n    const writeValue = (value: T): void => {\n      const storage = getStorage();\n      const storageKey = toValue(key);\n\n      if (storage === null) {\n        return;\n      }\n\n      try {\n        if (value == null) {\n          storage.removeItem(storageKey);\n        } else {\n          const serialized = serializer.write(value);\n          storage.setItem(storageKey, serialized);\n        }\n      } catch (error) {\n        if (ngDevMode) {\n          console.warn(\n            `[storage] Failed to write value for key \"${storageKey}\". ` +\n              `This may be due to storage quota exceeded or serialization error.`,\n            error\n          );\n        }\n      }\n    };\n\n    const state = signal<T>(readValue(toValue(key)), options);\n\n    if (storageType === 'local') {\n      setupSync(() => {\n        listener(window, 'storage', event => {\n          const currentKey = toValue(key);\n\n          if (event.key === currentKey && event.storageArea === window.localStorage) {\n            try {\n              const newValue =\n                event.newValue === null\n                  ? initialValue\n                  : mergeWithInitial(serializer.read(event.newValue));\n\n              state.set(newValue);\n            } catch (error) {\n              if (ngDevMode) {\n                console.warn(\n                  `[storage] Failed to sync value from other tab for key \"${event.key}\"`,\n                  error\n                );\n              }\n            }\n          }\n        });\n      });\n    }\n\n    if (isSignal(key)) {\n      watcher(key, newKey => state.set(readValue(newKey)));\n    }\n\n    return proxySignal(state, {\n      set: (value: T) => {\n        state.set(value);\n        writeValue(value);\n      },\n    });\n  });\n}\n\nexport const Serializers = {\n  string: {\n    read: (v: string): string => v,\n    write: (v: string): string => v,\n  } satisfies Serializer<string>,\n\n  number: {\n    read: (v: string): number => {\n      if (v === 'Infinity') return Infinity;\n      if (v === '-Infinity') return -Infinity;\n      if (v === 'NaN') return NaN;\n      return Number.parseFloat(v);\n    },\n    write: (v: number): string => {\n      if (Number.isNaN(v)) return 'NaN';\n      if (v === Infinity) return 'Infinity';\n      if (v === -Infinity) return '-Infinity';\n      return String(v);\n    },\n  } satisfies Serializer<number>,\n\n  boolean: {\n    read: (v: string): boolean => v === 'true',\n    write: (v: boolean): string => (v ? 'true' : 'false'),\n  } satisfies Serializer<boolean>,\n\n  bigint: {\n    read: (v: string): bigint => BigInt(v),\n    write: (v: bigint): string => v.toString(),\n  } satisfies Serializer<bigint>,\n\n  /*\n   * Date serializer - uses ISO 8601 format for maximum compatibility.\n   */\n  date: {\n    read: (v: string): Date => new Date(v),\n    write: (v: Date): string => v.toISOString(),\n  } satisfies Serializer<Date>,\n\n  object: {\n    read: <T>(v: string): T => JSON.parse(v) as T,\n    write: <T>(v: T): string => JSON.stringify(v),\n  } satisfies Serializer<unknown>,\n\n  map: {\n    read: <K, V>(v: string): Map<K, V> => new Map(JSON.parse(v)),\n    write: <K, V>(v: Map<K, V>): string => JSON.stringify([...v.entries()]),\n  } satisfies Serializer<Map<unknown, unknown>>,\n\n  set: {\n    read: <T>(v: string): Set<T> => new Set(JSON.parse(v)),\n    write: <T>(v: Set<T>): string => JSON.stringify([...v]),\n  } satisfies Serializer<Set<unknown>>,\n\n  /*\n   * Any serializer - fallback that treats everything as string.\n   */\n  any: {\n    read: <T>(v: string): T => v as T,\n    write: (v: unknown): string => String(v),\n  } satisfies Serializer<unknown>,\n} as const;\n\nfunction resolveSerializer<T>(initialValue: T, options?: StorageOptions<T>): Serializer<T> {\n  if (options?.serializer) {\n    return options.serializer;\n  }\n  const type = inferSerializerType(initialValue);\n  return Serializers[type] as Serializer<T>;\n}\n\nfunction inferSerializerType<T>(value: T): keyof typeof Serializers {\n  if (value === null || value === undefined) {\n    return 'any';\n  }\n\n  if (value instanceof Map) {\n    return 'map';\n  }\n\n  if (value instanceof Set) {\n    return 'set';\n  }\n\n  if (value instanceof Date) {\n    return 'date';\n  }\n\n  switch (typeof value) {\n    case 'string':\n      return 'string';\n    case 'number':\n      return 'number';\n    case 'boolean':\n      return 'boolean';\n    case 'bigint':\n      return 'bigint';\n    case 'object':\n      return 'object';\n    default:\n      return 'any';\n  }\n}\n\nfunction storageAvailable(type: 'localStorage' | 'sessionStorage'): boolean {\n  let storage: Storage | undefined;\n\n  try {\n    storage = window[type];\n    const testKey = '__storage_test__';\n    storage.setItem(testKey, testKey);\n    storage.removeItem(testKey);\n    return true;\n  } catch (e) {\n    return (\n      e instanceof DOMException &&\n      e.name === 'QuotaExceededError' &&\n      storage !== undefined &&\n      storage.length !== 0\n    );\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/fesm2022/signality-core-browser-text-direction.mjs

@@ -0,0 +1,62 @@
+import { signal } from '@angular/core';
+import { setupContext, toElement, proxySignal, createToken } from '@signality/core/internal';
+import { mutationObserver } from '@signality/core/observers/mutation-observer';
+
+/**
+ * Reactive read/write wrapper around an element's `dir` attribute for detecting and controlling
+ * [text directionality](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/dir).
+ *
+ * Returns a `WritableSignal` that reflects the current `dir` attribute value and updates the DOM
+ * when written to. Changes made to the attribute externally are picked up via `MutationObserver`.
+ *
+ * @param options - Optional configuration including target element, initial value and injector
+ * @returns A writable signal of the current text direction
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <p>Current direction: {{ dir() }}</p>
+ *     <button (click)="dir.set('rtl')">Set RTL</button>
+ *     <button (click)="dir.set('ltr')">Set LTR</button>
+ *   `
+ * })
+ * class TextDirectionComponent {
+ *   readonly dir = textDirection();
+ * }
+ * ```
+ */
+function textDirection(options) {
+    const { runInContext } = setupContext(options?.injector, textDirection);
+    const initialValue = options?.initialValue ?? 'ltr';
+    return runInContext(({ isServer }) => {
+        if (isServer) {
+            return signal(initialValue, options);
+        }
+        const target = options?.target ?? document.documentElement;
+        const readDir = () => {
+            const el = toElement(target);
+            return el?.getAttribute('dir') || initialValue;
+        };
+        const dir = signal(readDir(), ...(ngDevMode ? [{ debugName: "dir" }] : []));
+        mutationObserver(target, () => dir.set(readDir()), {
+            attributes: true,
+            attributeFilter: ['dir'],
+        });
+        return proxySignal(dir, {
+            set: value => {
+                const el = toElement(target);
+                el?.setAttribute('dir', value);
+                dir.set(value);
+            },
+        });
+    });
+}
+const TEXT_DIRECTION = /* @__PURE__ */ createToken(textDirection);
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { TEXT_DIRECTION, textDirection };
+//# sourceMappingURL=signality-core-browser-text-direction.mjs.map

package/fesm2022/signality-core-browser-text-direction.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-text-direction.mjs","sources":["../../../projects/core/browser/text-direction/index.ts","../../../projects/core/browser/text-direction/signality-core-browser-text-direction.ts"],"sourcesContent":["import { CreateSignalOptions, signal, WritableSignal } from '@angular/core';\nimport { createToken, proxySignal, setupContext, toElement } from '@signality/core/internal';\nimport type { MaybeElementSignal, WithInjector } from '@signality/core/types';\nimport { mutationObserver } from '@signality/core/observers/mutation-observer';\n\n/**\n * Possible text direction values matching the HTML `dir` attribute.\n */\nexport type TextDirection = 'ltr' | 'rtl' | 'auto';\n\nexport interface TextDirectionOptions extends CreateSignalOptions<TextDirection>, WithInjector {\n  /**\n   * Element to observe. Defaults to `document.documentElement` (`<html>`).\n   */\n  readonly target?: MaybeElementSignal<HTMLElement>;\n\n  /**\n   * Initial direction value used during SSR or before the DOM is read.\n   * @default 'ltr'\n   */\n  readonly initialValue?: TextDirection;\n}\n\n/**\n * Reactive read/write wrapper around an element's `dir` attribute for detecting and controlling\n * [text directionality](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/dir).\n *\n * Returns a `WritableSignal` that reflects the current `dir` attribute value and updates the DOM\n * when written to. Changes made to the attribute externally are picked up via `MutationObserver`.\n *\n * @param options - Optional configuration including target element, initial value and injector\n * @returns A writable signal of the current text direction\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <p>Current direction: {{ dir() }}</p>\n *     <button (click)=\"dir.set('rtl')\">Set RTL</button>\n *     <button (click)=\"dir.set('ltr')\">Set LTR</button>\n *   `\n * })\n * class TextDirectionComponent {\n *   readonly dir = textDirection();\n * }\n * ```\n */\nexport function textDirection(options?: TextDirectionOptions): WritableSignal<TextDirection> {\n  const { runInContext } = setupContext(options?.injector, textDirection);\n  const initialValue = options?.initialValue ?? 'ltr';\n\n  return runInContext(({ isServer }) => {\n    if (isServer) {\n      return signal(initialValue, options);\n    }\n\n    const target = options?.target ?? document.documentElement;\n\n    const readDir = (): TextDirection => {\n      const el = toElement(target);\n      return (el?.getAttribute('dir') as TextDirection) || initialValue;\n    };\n\n    const dir = signal<TextDirection>(readDir());\n\n    mutationObserver(target, () => dir.set(readDir()), {\n      attributes: true,\n      attributeFilter: ['dir'],\n    });\n\n    return proxySignal(dir, {\n      set: value => {\n        const el = toElement(target);\n        el?.setAttribute('dir', value);\n        dir.set(value);\n      },\n    });\n  });\n}\n\nexport const TEXT_DIRECTION = /* @__PURE__ */ createToken(textDirection);\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAuBA;;;;;;;;;;;;;;;;;;;;;;;AAuBG;AACG,SAAU,aAAa,CAAC,OAA8B,EAAA;AAC1D,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC;AACvE,IAAA,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,KAAK;AAEnD,IAAA,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAI;QACnC,IAAI,QAAQ,EAAE;AACZ,YAAA,OAAO,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC;QACtC;QAEA,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,QAAQ,CAAC,eAAe;QAE1D,MAAM,OAAO,GAAG,MAAoB;AAClC,YAAA,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC;YAC5B,OAAQ,EAAE,EAAE,YAAY,CAAC,KAAK,CAAmB,IAAI,YAAY;AACnE,QAAA,CAAC;AAED,QAAA,MAAM,GAAG,GAAG,MAAM,CAAgB,OAAO,EAAE,+CAAC;AAE5C,QAAA,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE;AACjD,YAAA,UAAU,EAAE,IAAI;YAChB,eAAe,EAAE,CAAC,KAAK,CAAC;AACzB,SAAA,CAAC;QAEF,OAAO,WAAW,CAAC,GAAG,EAAE;YACtB,GAAG,EAAE,KAAK,IAAG;AACX,gBAAA,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC;AAC5B,gBAAA,EAAE,EAAE,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC;AAC9B,gBAAA,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;YAChB,CAAC;AACF,SAAA,CAAC;AACJ,IAAA,CAAC,CAAC;AACJ;AAEO,MAAM,cAAc,mBAAmB,WAAW,CAAC,aAAa;;AChFvE;;AAEG;;;;"}

package/fesm2022/signality-core-browser-vibration.mjs

@@ -0,0 +1,94 @@
+import { signal } from '@angular/core';
+import { setupContext, constSignal, NOOP_FN, toValue } from '@signality/core/internal';
+
+/**
+ * Signal-based wrapper around the Vibration API.
+ *
+ * @param options - Optional configuration including default pattern and injector
+ * @returns A VibrationRef with vibration control methods
+ *
+ * @example
+ * ```typescript
+ * const vib = vibration();
+ *
+ * vib.vibrate(100); // Vibrate for 100ms
+ * vib.vibrate([100, 50, 100]); // Pattern: vibrate, pause, vibrate
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const vib = vibration({ pattern: 200 });
+ *
+ * vib.vibrate(); // Uses default 200ms pattern
+ * ```
+ */
+function vibration(options) {
+    const { runInContext } = setupContext(options?.injector, vibration);
+    return runInContext(({ isBrowser, onCleanup }) => {
+        const isSupported = constSignal(isBrowser && 'vibrate' in navigator);
+        if (!isSupported()) {
+            return {
+                isSupported,
+                isVibrating: constSignal(false),
+                vibrate: NOOP_FN,
+                stop: NOOP_FN,
+            };
+        }
+        const isVibrating = signal(false, ...(ngDevMode ? [{ debugName: "isVibrating" }] : []));
+        let vibrateTimeout;
+        const vibrate = (vibratePattern) => {
+            const resolvedPattern = vibratePattern ?? toValue.untracked(options?.pattern) ?? 200;
+            try {
+                const result = navigator.vibrate(resolvedPattern);
+                isVibrating.set(result);
+                const duration = Array.isArray(resolvedPattern)
+                    ? resolvedPattern.reduce((a, b) => a + b, 0)
+                    : resolvedPattern;
+                if (result && duration > 0) {
+                    if (vibrateTimeout) {
+                        clearTimeout(vibrateTimeout);
+                    }
+                    vibrateTimeout = setTimeout(() => {
+                        isVibrating.set(false);
+                        vibrateTimeout = undefined;
+                    }, duration);
+                }
+            }
+            catch (error) {
+                isVibrating.set(false);
+                if (ngDevMode) {
+                    console.warn(`[vibration] Failed to vibrate device.`, error);
+                }
+            }
+        };
+        const stop = () => {
+            try {
+                navigator.vibrate(0);
+                isVibrating.set(false);
+            }
+            catch (error) {
+                if (ngDevMode) {
+                    console.warn(`[vibration] Failed to stop vibration.`, error);
+                }
+            }
+            if (vibrateTimeout) {
+                clearTimeout(vibrateTimeout);
+                vibrateTimeout = undefined;
+            }
+        };
+        onCleanup(stop);
+        return {
+            isSupported,
+            isVibrating: isVibrating.asReadonly(),
+            vibrate,
+            stop,
+        };
+    });
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { vibration };
+//# sourceMappingURL=signality-core-browser-vibration.mjs.map

package/fesm2022/signality-core-browser-vibration.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-vibration.mjs","sources":["../../../projects/core/browser/vibration/index.ts","../../../projects/core/browser/vibration/signality-core-browser-vibration.ts"],"sourcesContent":["import { type Signal, signal } from '@angular/core';\nimport { constSignal, NOOP_FN, setupContext, type Timer, toValue } from '@signality/core/internal';\nimport type { MaybeSignal, WithInjector } from '@signality/core/types';\n\nexport interface VibrationOptions extends WithInjector {\n  readonly pattern?: MaybeSignal<number | number[]>;\n}\n\nexport interface VibrationRef {\n  /** Whether Vibration API is supported */\n  readonly isSupported: Signal<boolean>;\n\n  /** Whether currently vibrating */\n  readonly isVibrating: Signal<boolean>;\n\n  /** Start vibration */\n  readonly vibrate: (pattern?: number | number[]) => void;\n\n  /** Stop vibration */\n  readonly stop: () => void;\n}\n\n/**\n * Signal-based wrapper around the Vibration API.\n *\n * @param options - Optional configuration including default pattern and injector\n * @returns A VibrationRef with vibration control methods\n *\n * @example\n * ```typescript\n * const vib = vibration();\n *\n * vib.vibrate(100); // Vibrate for 100ms\n * vib.vibrate([100, 50, 100]); // Pattern: vibrate, pause, vibrate\n * ```\n *\n * @example\n * ```typescript\n * const vib = vibration({ pattern: 200 });\n *\n * vib.vibrate(); // Uses default 200ms pattern\n * ```\n */\nexport function vibration(options?: VibrationOptions): VibrationRef {\n  const { runInContext } = setupContext(options?.injector, vibration);\n\n  return runInContext(({ isBrowser, onCleanup }) => {\n    const isSupported = constSignal(isBrowser && 'vibrate' in navigator);\n\n    if (!isSupported()) {\n      return {\n        isSupported,\n        isVibrating: constSignal(false),\n        vibrate: NOOP_FN,\n        stop: NOOP_FN,\n      };\n    }\n\n    const isVibrating = signal(false);\n\n    let vibrateTimeout: Timer;\n\n    const vibrate = (vibratePattern?: number | number[]) => {\n      const resolvedPattern = vibratePattern ?? toValue.untracked(options?.pattern) ?? 200;\n\n      try {\n        const result = navigator.vibrate(resolvedPattern);\n\n        isVibrating.set(result);\n\n        const duration = Array.isArray(resolvedPattern)\n          ? resolvedPattern.reduce((a, b) => a + b, 0)\n          : resolvedPattern;\n\n        if (result && duration > 0) {\n          if (vibrateTimeout) {\n            clearTimeout(vibrateTimeout);\n          }\n\n          vibrateTimeout = setTimeout(() => {\n            isVibrating.set(false);\n            vibrateTimeout = undefined;\n          }, duration);\n        }\n      } catch (error) {\n        isVibrating.set(false);\n        if (ngDevMode) {\n          console.warn(`[vibration] Failed to vibrate device.`, error);\n        }\n      }\n    };\n\n    const stop = () => {\n      try {\n        navigator.vibrate(0);\n        isVibrating.set(false);\n      } catch (error) {\n        if (ngDevMode) {\n          console.warn(`[vibration] Failed to stop vibration.`, error);\n        }\n      }\n\n      if (vibrateTimeout) {\n        clearTimeout(vibrateTimeout);\n        vibrateTimeout = undefined;\n      }\n    };\n\n    onCleanup(stop);\n\n    return {\n      isSupported,\n      isVibrating: isVibrating.asReadonly(),\n      vibrate,\n      stop,\n    };\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;AAsBA;;;;;;;;;;;;;;;;;;;;AAoBG;AACG,SAAU,SAAS,CAAC,OAA0B,EAAA;AAClD,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC;IAEnE,OAAO,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,KAAI;QAC/C,MAAM,WAAW,GAAG,WAAW,CAAC,SAAS,IAAI,SAAS,IAAI,SAAS,CAAC;AAEpE,QAAA,IAAI,CAAC,WAAW,EAAE,EAAE;YAClB,OAAO;gBACL,WAAW;AACX,gBAAA,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC;AAC/B,gBAAA,OAAO,EAAE,OAAO;AAChB,gBAAA,IAAI,EAAE,OAAO;aACd;QACH;AAEA,QAAA,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,uDAAC;AAEjC,QAAA,IAAI,cAAqB;AAEzB,QAAA,MAAM,OAAO,GAAG,CAAC,cAAkC,KAAI;AACrD,YAAA,MAAM,eAAe,GAAG,cAAc,IAAI,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,GAAG;AAEpF,YAAA,IAAI;gBACF,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,eAAe,CAAC;AAEjD,gBAAA,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC;AAEvB,gBAAA,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe;AAC5C,sBAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;sBACzC,eAAe;AAEnB,gBAAA,IAAI,MAAM,IAAI,QAAQ,GAAG,CAAC,EAAE;oBAC1B,IAAI,cAAc,EAAE;wBAClB,YAAY,CAAC,cAAc,CAAC;oBAC9B;AAEA,oBAAA,cAAc,GAAG,UAAU,CAAC,MAAK;AAC/B,wBAAA,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC;wBACtB,cAAc,GAAG,SAAS;oBAC5B,CAAC,EAAE,QAAQ,CAAC;gBACd;YACF;YAAE,OAAO,KAAK,EAAE;AACd,gBAAA,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC;gBACtB,IAAI,SAAS,EAAE;AACb,oBAAA,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,KAAK,CAAC;gBAC9D;YACF;AACF,QAAA,CAAC;QAED,MAAM,IAAI,GAAG,MAAK;AAChB,YAAA,IAAI;AACF,gBAAA,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;AACpB,gBAAA,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC;YACxB;YAAE,OAAO,KAAK,EAAE;gBACd,IAAI,SAAS,EAAE;AACb,oBAAA,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,KAAK,CAAC;gBAC9D;YACF;YAEA,IAAI,cAAc,EAAE;gBAClB,YAAY,CAAC,cAAc,CAAC;gBAC5B,cAAc,GAAG,SAAS;YAC5B;AACF,QAAA,CAAC;QAED,SAAS,CAAC,IAAI,CAAC;QAEf,OAAO;YACL,WAAW;AACX,YAAA,WAAW,EAAE,WAAW,CAAC,UAAU,EAAE;YACrC,OAAO;YACP,IAAI;SACL;AACH,IAAA,CAAC,CAAC;AACJ;;ACrHA;;AAEG;;;;"}