@signality/core 0.0.1-alpha.2

package/fesm2022/signality-core-browser-broadcast-channel.mjs

@@ -0,0 +1,74 @@
+import { signal } from '@angular/core';
+import { setupContext, NOOP_FN, constSignal } from '@signality/core/internal';
+import { setupSync, listener } from '@signality/core/browser/listener';
+
+/**
+ * Signal-based wrapper around the [Broadcast Channel API](https://developer.mozilla.org/en-US/docs/Web/API/Broadcast_Channel_API).
+ *
+ * @param name - Channel name (must match across tabs)
+ * @param options - Optional configuration
+ * @returns A BroadcastChannelRef with data signal and control methods
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     @if (channel.data(); as data) {
+ *       <p>Received: {{ data }}</p>
+ *     }
+ *     <button (click)="sendMessage()">Send Message</button>
+ *   `
+ * })
+ * class ChatComponent {
+ *   readonly channel = broadcastChannel<string>('my-channel');
+ *
+ *   sendMessage() {
+ *     this.channel.post('Hello from this tab!');
+ *   }
+ * }
+ * ```
+ */
+function broadcastChannel(name, options) {
+    const { runInContext } = setupContext(options?.injector, broadcastChannel);
+    return runInContext(({ isServer, onCleanup }) => {
+        if (isServer) {
+            return {
+                data: constSignal(null),
+                error: constSignal(null),
+                isClosed: constSignal(false),
+                post: NOOP_FN,
+                close: NOOP_FN,
+            };
+        }
+        const data = signal(null, ...(ngDevMode ? [{ debugName: "data" }] : []));
+        const error = signal(null, ...(ngDevMode ? [{ debugName: "error" }] : []));
+        const isClosed = signal(false, ...(ngDevMode ? [{ debugName: "isClosed" }] : []));
+        const channel = new BroadcastChannel(name);
+        const post = (message) => {
+            channel.postMessage(message);
+        };
+        const close = () => {
+            channel.close();
+            isClosed.set(true);
+        };
+        setupSync(() => {
+            listener(channel, 'message', (e) => data.set(e.data));
+            listener(channel, 'messageerror', error.set);
+        });
+        onCleanup(close);
+        return {
+            data: data.asReadonly(),
+            error: error.asReadonly(),
+            isClosed: isClosed.asReadonly(),
+            post,
+            close,
+        };
+    });
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { broadcastChannel };
+//# sourceMappingURL=signality-core-browser-broadcast-channel.mjs.map

package/fesm2022/signality-core-browser-broadcast-channel.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-broadcast-channel.mjs","sources":["../../../projects/core/browser/broadcast-channel/index.ts","../../../projects/core/browser/broadcast-channel/signality-core-browser-broadcast-channel.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';\nimport { listener, setupSync } from '@signality/core/browser/listener';\n\nexport type BroadcastChannelOptions = WithInjector;\n\nexport interface BroadcastChannelRef<T> {\n  /** Last received data */\n  readonly data: Signal<T | null>;\n\n  /** The last error that occurred */\n  readonly error: Signal<MessageEvent | null>;\n\n  /** Whether the channel is closed */\n  readonly isClosed: Signal<boolean>;\n\n  /** Send a message to all tabs */\n  readonly post: (data: T) => void;\n\n  /** Close the channel */\n  readonly close: () => void;\n}\n\n/**\n * Signal-based wrapper around the [Broadcast Channel API](https://developer.mozilla.org/en-US/docs/Web/API/Broadcast_Channel_API).\n *\n * @param name - Channel name (must match across tabs)\n * @param options - Optional configuration\n * @returns A BroadcastChannelRef with data signal and control methods\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     @if (channel.data(); as data) {\n *       <p>Received: {{ data }}</p>\n *     }\n *     <button (click)=\"sendMessage()\">Send Message</button>\n *   `\n * })\n * class ChatComponent {\n *   readonly channel = broadcastChannel<string>('my-channel');\n *\n *   sendMessage() {\n *     this.channel.post('Hello from this tab!');\n *   }\n * }\n * ```\n */\nexport function broadcastChannel<T>(\n  name: string,\n  options?: BroadcastChannelOptions\n): BroadcastChannelRef<T> {\n  const { runInContext } = setupContext(options?.injector, broadcastChannel);\n\n  return runInContext(({ isServer, onCleanup }) => {\n    if (isServer) {\n      return {\n        data: constSignal(null),\n        error: constSignal(null),\n        isClosed: constSignal(false),\n        post: NOOP_FN,\n        close: NOOP_FN,\n      };\n    }\n\n    const data = signal<T | null>(null);\n    const error = signal<MessageEvent | null>(null);\n    const isClosed = signal(false);\n\n    const channel = new BroadcastChannel(name);\n\n    const post = (message: T) => {\n      channel.postMessage(message);\n    };\n\n    const close = () => {\n      channel.close();\n      isClosed.set(true);\n    };\n\n    setupSync(() => {\n      listener(channel, 'message', (e: MessageEvent<T>) => data.set(e.data));\n      listener(channel, 'messageerror', error.set);\n    });\n\n    onCleanup(close);\n\n    return {\n      data: data.asReadonly(),\n      error: error.asReadonly(),\n      isClosed: isClosed.asReadonly(),\n      post,\n      close,\n    };\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAwBA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;AACG,SAAU,gBAAgB,CAC9B,IAAY,EACZ,OAAiC,EAAA;AAEjC,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,CAAC;IAE1E,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAI;QAC9C,IAAI,QAAQ,EAAE;YACZ,OAAO;AACL,gBAAA,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC;AACvB,gBAAA,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC;AACxB,gBAAA,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC;AAC5B,gBAAA,IAAI,EAAE,OAAO;AACb,gBAAA,KAAK,EAAE,OAAO;aACf;QACH;AAEA,QAAA,MAAM,IAAI,GAAG,MAAM,CAAW,IAAI,gDAAC;AACnC,QAAA,MAAM,KAAK,GAAG,MAAM,CAAsB,IAAI,iDAAC;AAC/C,QAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,oDAAC;AAE9B,QAAA,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC;AAE1C,QAAA,MAAM,IAAI,GAAG,CAAC,OAAU,KAAI;AAC1B,YAAA,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;AAC9B,QAAA,CAAC;QAED,MAAM,KAAK,GAAG,MAAK;YACjB,OAAO,CAAC,KAAK,EAAE;AACf,YAAA,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;AACpB,QAAA,CAAC;QAED,SAAS,CAAC,MAAK;AACb,YAAA,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,CAAkB,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACtE,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,GAAG,CAAC;AAC9C,QAAA,CAAC,CAAC;QAEF,SAAS,CAAC,KAAK,CAAC;QAEhB,OAAO;AACL,YAAA,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE;AACvB,YAAA,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE;AACzB,YAAA,QAAQ,EAAE,QAAQ,CAAC,UAAU,EAAE;YAC/B,IAAI;YACJ,KAAK;SACN;AACH,IAAA,CAAC,CAAC;AACJ;;ACjGA;;AAEG;;;;"}

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

@@ -0,0 +1,48 @@
+import { signal } from '@angular/core';
+import { setupContext, constSignal, createToken } from '@signality/core/internal';
+import { setupSync, listener } from '@signality/core/browser/listener';
+
+/**
+ * Reactive wrapper around the [Navigator.language](https://developer.mozilla.org/en-US/docs/Web/API/Navigator/language) property.
+ *
+ * @param options - Optional configuration including signal options and injector
+ * @returns A signal containing the current browser language in BCP 47 format (e.g., 'en-US', 'fr-FR')
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <p>Current language: {{ language() }}</p>
+ *     @if (language() === 'en-US') {
+ *       <p>Welcome!</p>
+ *     } @else if (language() === 'fr-FR') {
+ *       <p>Bienvenue!</p>
+ *     }
+ *   `
+ * })
+ * class LanguageComponent {
+ *   readonly language = browserLanguage();
+ * }
+ * ```
+ */
+function browserLanguage(options) {
+    const { runInContext } = setupContext(options?.injector, browserLanguage);
+    return runInContext(({ isServer }) => {
+        if (isServer) {
+            return constSignal(options?.initialValue ?? '');
+        }
+        const language = signal(navigator.language, options);
+        setupSync(() => {
+            listener(window, 'languagechange', () => language.set(navigator.language));
+        });
+        return language.asReadonly();
+    });
+}
+const BROWSER_LANGUAGE = /* @__PURE__ */ createToken(browserLanguage);
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { BROWSER_LANGUAGE, browserLanguage };
+//# sourceMappingURL=signality-core-browser-browser-language.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-browser-language.mjs","sources":["../../../projects/core/browser/browser-language/index.ts","../../../projects/core/browser/browser-language/signality-core-browser-browser-language.ts"],"sourcesContent":["import { type CreateSignalOptions, type Signal, signal } from '@angular/core';\nimport { constSignal, createToken, setupContext } from '@signality/core/internal';\nimport type { WithInjector } from '@signality/core/types';\nimport { listener, setupSync } from '@signality/core/browser/listener';\n\nexport interface BrowserLanguageOptions extends CreateSignalOptions<string>, WithInjector {\n  /**\n   * Initial value for SSR.\n   * @default ''\n   */\n  readonly initialValue?: string;\n}\n\n/**\n * Reactive wrapper around the [Navigator.language](https://developer.mozilla.org/en-US/docs/Web/API/Navigator/language) property.\n *\n * @param options - Optional configuration including signal options and injector\n * @returns A signal containing the current browser language in BCP 47 format (e.g., 'en-US', 'fr-FR')\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <p>Current language: {{ language() }}</p>\n *     @if (language() === 'en-US') {\n *       <p>Welcome!</p>\n *     } @else if (language() === 'fr-FR') {\n *       <p>Bienvenue!</p>\n *     }\n *   `\n * })\n * class LanguageComponent {\n *   readonly language = browserLanguage();\n * }\n * ```\n */\nexport function browserLanguage(options?: BrowserLanguageOptions): Signal<string> {\n  const { runInContext } = setupContext(options?.injector, browserLanguage);\n\n  return runInContext(({ isServer }) => {\n    if (isServer) {\n      return constSignal(options?.initialValue ?? '');\n    }\n\n    const language = signal(navigator.language, options);\n\n    setupSync(() => {\n      listener(window, 'languagechange', () => language.set(navigator.language));\n    });\n\n    return language.asReadonly();\n  });\n}\n\nexport const BROWSER_LANGUAGE = /* @__PURE__ */ createToken(browserLanguage);\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAaA;;;;;;;;;;;;;;;;;;;;;;AAsBG;AACG,SAAU,eAAe,CAAC,OAAgC,EAAA;AAC9D,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC;AAEzE,IAAA,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAI;QACnC,IAAI,QAAQ,EAAE;YACZ,OAAO,WAAW,CAAC,OAAO,EAAE,YAAY,IAAI,EAAE,CAAC;QACjD;QAEA,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC;QAEpD,SAAS,CAAC,MAAK;AACb,YAAA,QAAQ,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC5E,QAAA,CAAC,CAAC;AAEF,QAAA,OAAO,QAAQ,CAAC,UAAU,EAAE;AAC9B,IAAA,CAAC,CAAC;AACJ;AAEO,MAAM,gBAAgB,mBAAmB,WAAW,CAAC,eAAe;;ACtD3E;;AAEG;;;;"}

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

@@ -0,0 +1,102 @@
+import { signal } from '@angular/core';
+import { setupContext, constSignal, NOOP_ASYNC_FN, toValue } from '@signality/core/internal';
+
+/**
+ * Signal-based wrapper around the [Clipboard API](https://developer.mozilla.org/en-US/docs/Web/API/Clipboard_API).
+ *
+ * @param options - Optional configuration
+ * @returns A ClipboardRef with text, copied, isSupported signals and copy/paste methods
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <input #input value="Hello World!" />
+ *     <button (click)="copyText(input.value)">Copy</button>
+ *     @if (cb.copied()) {
+ *       <span>Copied!</span>
+ *     }
+ *   `
+ * })
+ * class ClipboardComponent {
+ *   readonly cb = clipboard();
+ *
+ *   async copyText(text: string) {
+ *     await this.cb.copy(text);
+ *   }
+ * }
+ * ```
+ */
+function clipboard(options) {
+    const { runInContext } = setupContext(options?.injector, clipboard);
+    return runInContext(({ isBrowser, onCleanup }) => {
+        const isSupported = constSignal(isBrowser && 'clipboard' in navigator && typeof navigator.clipboard?.writeText === 'function');
+        if (!isSupported()) {
+            return {
+                isSupported,
+                text: constSignal(''),
+                copied: constSignal(false),
+                copy: NOOP_ASYNC_FN,
+                paste: () => Promise.resolve(''),
+            };
+        }
+        const copiedDuration = options?.copiedDuration ?? 1500;
+        const text = signal('', ...(ngDevMode ? [{ debugName: "text" }] : []));
+        const copied = signal(false, ...(ngDevMode ? [{ debugName: "copied" }] : []));
+        let copiedTimeout;
+        const copy = async (value) => {
+            try {
+                await navigator.clipboard.writeText(value);
+                text.set(value);
+                copied.set(true);
+                if (copiedTimeout) {
+                    clearTimeout(copiedTimeout);
+                }
+                copiedTimeout = setTimeout(() => {
+                    copied.set(false);
+                    copiedTimeout = undefined;
+                }, toValue.untracked(copiedDuration));
+            }
+            catch (error) {
+                copied.set(false);
+                if (ngDevMode) {
+                    console.warn(`[clipboard] Failed to copy text to clipboard. ` +
+                        `This may be due to permission denied or clipboard access failed.`, error);
+                }
+            }
+        };
+        const paste = async () => {
+            try {
+                const value = await navigator.clipboard.readText();
+                text.set(value);
+                return value;
+            }
+            catch (error) {
+                if (ngDevMode) {
+                    console.warn(`[clipboard] Failed to read text from clipboard. ` +
+                        `This may be due to permission denied or clipboard access failed.`, error);
+                }
+                return '';
+            }
+        };
+        onCleanup(() => {
+            if (copiedTimeout) {
+                clearTimeout(copiedTimeout);
+            }
+        });
+        return {
+            isSupported,
+            text: text.asReadonly(),
+            copied: copied.asReadonly(),
+            copy,
+            paste,
+        };
+    });
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { clipboard };
+//# sourceMappingURL=signality-core-browser-clipboard.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-clipboard.mjs","sources":["../../../projects/core/browser/clipboard/index.ts","../../../projects/core/browser/clipboard/signality-core-browser-clipboard.ts"],"sourcesContent":["import { type Signal, signal } from '@angular/core';\nimport {\n  constSignal,\n  NOOP_ASYNC_FN,\n  setupContext,\n  type Timer,\n  toValue,\n} from '@signality/core/internal';\nimport type { MaybeSignal, WithInjector } from '@signality/core/types';\n\nexport interface ClipboardOptions extends WithInjector {\n  /**\n   * How long `copied` stays `true` after copy (ms).\n   * @default 1500\n   */\n  readonly copiedDuration?: MaybeSignal<number>;\n}\n\nexport interface ClipboardRef {\n  /** Whether Clipboard API is supported */\n  readonly isSupported: Signal<boolean>;\n\n  /** Current clipboard text content */\n  readonly text: Signal<string>;\n\n  /** Whether content was recently copied (resets after timeout) */\n  readonly copied: Signal<boolean>;\n\n  /** Copy text to clipboard */\n  readonly copy: (text: string) => Promise<void>;\n\n  /** Read text from clipboard */\n  readonly paste: () => Promise<string>;\n}\n\n/**\n * Signal-based wrapper around the [Clipboard API](https://developer.mozilla.org/en-US/docs/Web/API/Clipboard_API).\n *\n * @param options - Optional configuration\n * @returns A ClipboardRef with text, copied, isSupported signals and copy/paste methods\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <input #input value=\"Hello World!\" />\n *     <button (click)=\"copyText(input.value)\">Copy</button>\n *     @if (cb.copied()) {\n *       <span>Copied!</span>\n *     }\n *   `\n * })\n * class ClipboardComponent {\n *   readonly cb = clipboard();\n *\n *   async copyText(text: string) {\n *     await this.cb.copy(text);\n *   }\n * }\n * ```\n */\nexport function clipboard(options?: ClipboardOptions): ClipboardRef {\n  const { runInContext } = setupContext(options?.injector, clipboard);\n\n  return runInContext(({ isBrowser, onCleanup }) => {\n    const isSupported = constSignal(\n      isBrowser && 'clipboard' in navigator && typeof navigator.clipboard?.writeText === 'function'\n    );\n\n    if (!isSupported()) {\n      return {\n        isSupported,\n        text: constSignal(''),\n        copied: constSignal(false),\n        copy: NOOP_ASYNC_FN,\n        paste: () => Promise.resolve(''),\n      };\n    }\n\n    const copiedDuration = options?.copiedDuration ?? 1500;\n\n    const text = signal('');\n    const copied = signal(false);\n\n    let copiedTimeout: Timer;\n\n    const copy = async (value: string): Promise<void> => {\n      try {\n        await navigator.clipboard.writeText(value);\n\n        text.set(value);\n        copied.set(true);\n\n        if (copiedTimeout) {\n          clearTimeout(copiedTimeout);\n        }\n\n        copiedTimeout = setTimeout(() => {\n          copied.set(false);\n          copiedTimeout = undefined;\n        }, toValue.untracked(copiedDuration));\n      } catch (error) {\n        copied.set(false);\n        if (ngDevMode) {\n          console.warn(\n            `[clipboard] Failed to copy text to clipboard. ` +\n              `This may be due to permission denied or clipboard access failed.`,\n            error\n          );\n        }\n      }\n    };\n\n    const paste = async (): Promise<string> => {\n      try {\n        const value = await navigator.clipboard.readText();\n        text.set(value);\n        return value;\n      } catch (error) {\n        if (ngDevMode) {\n          console.warn(\n            `[clipboard] Failed to read text from clipboard. ` +\n              `This may be due to permission denied or clipboard access failed.`,\n            error\n          );\n        }\n        return '';\n      }\n    };\n\n    onCleanup(() => {\n      if (copiedTimeout) {\n        clearTimeout(copiedTimeout);\n      }\n    });\n\n    return {\n      isSupported,\n      text: text.asReadonly(),\n      copied: copied.asReadonly(),\n      copy,\n      paste,\n    };\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;AAmCA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;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;AAC/C,QAAA,MAAM,WAAW,GAAG,WAAW,CAC7B,SAAS,IAAI,WAAW,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,SAAS,EAAE,SAAS,KAAK,UAAU,CAC9F;AAED,QAAA,IAAI,CAAC,WAAW,EAAE,EAAE;YAClB,OAAO;gBACL,WAAW;AACX,gBAAA,IAAI,EAAE,WAAW,CAAC,EAAE,CAAC;AACrB,gBAAA,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC;AAC1B,gBAAA,IAAI,EAAE,aAAa;gBACnB,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;aACjC;QACH;AAEA,QAAA,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,IAAI;AAEtD,QAAA,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,gDAAC;AACvB,QAAA,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,kDAAC;AAE5B,QAAA,IAAI,aAAoB;AAExB,QAAA,MAAM,IAAI,GAAG,OAAO,KAAa,KAAmB;AAClD,YAAA,IAAI;gBACF,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC;AAE1C,gBAAA,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;AACf,gBAAA,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;gBAEhB,IAAI,aAAa,EAAE;oBACjB,YAAY,CAAC,aAAa,CAAC;gBAC7B;AAEA,gBAAA,aAAa,GAAG,UAAU,CAAC,MAAK;AAC9B,oBAAA,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;oBACjB,aAAa,GAAG,SAAS;gBAC3B,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;YACvC;YAAE,OAAO,KAAK,EAAE;AACd,gBAAA,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;gBACjB,IAAI,SAAS,EAAE;oBACb,OAAO,CAAC,IAAI,CACV,CAAA,8CAAA,CAAgD;wBAC9C,CAAA,gEAAA,CAAkE,EACpE,KAAK,CACN;gBACH;YACF;AACF,QAAA,CAAC;AAED,QAAA,MAAM,KAAK,GAAG,YAA4B;AACxC,YAAA,IAAI;gBACF,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE;AAClD,gBAAA,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;AACf,gBAAA,OAAO,KAAK;YACd;YAAE,OAAO,KAAK,EAAE;gBACd,IAAI,SAAS,EAAE;oBACb,OAAO,CAAC,IAAI,CACV,CAAA,gDAAA,CAAkD;wBAChD,CAAA,gEAAA,CAAkE,EACpE,KAAK,CACN;gBACH;AACA,gBAAA,OAAO,EAAE;YACX;AACF,QAAA,CAAC;QAED,SAAS,CAAC,MAAK;YACb,IAAI,aAAa,EAAE;gBACjB,YAAY,CAAC,aAAa,CAAC;YAC7B;AACF,QAAA,CAAC,CAAC;QAEF,OAAO;YACL,WAAW;AACX,YAAA,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE;AACvB,YAAA,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE;YAC3B,IAAI;YACJ,KAAK;SACN;AACH,IAAA,CAAC,CAAC;AACJ;;AChJA;;AAEG;;;;"}

package/fesm2022/signality-core-browser-device-posture.mjs

@@ -0,0 +1,40 @@
+import { signal } from '@angular/core';
+import { setupContext, constSignal } from '@signality/core/internal';
+import { setupSync, listener } from '@signality/core/browser/listener';
+
+/**
+ * Signal-based wrapper around the [Device Posture API](https://developer.mozilla.org/en-US/docs/Web/API/Device_Posture_API).
+ * Track device posture state for foldable devices.
+ *
+ * @param options - Optional configuration including injector
+ * @returns A DevicePostureRef with type signal
+ *
+ */
+function devicePosture(options) {
+    const { runInContext } = setupContext(options?.injector, devicePosture);
+    return runInContext(({ isBrowser }) => {
+        const isSupported = constSignal(isBrowser && 'devicePosture' in navigator && !!navigator.devicePosture);
+        if (!isSupported()) {
+            return {
+                isSupported,
+                type: constSignal('continuous'),
+            };
+        }
+        const { devicePosture } = navigator;
+        const type = signal(devicePosture.type, ...(ngDevMode ? [{ debugName: "type" }] : []));
+        setupSync(() => {
+            listener(devicePosture, 'change', () => type.set(devicePosture.type));
+        });
+        return {
+            isSupported,
+            type: type.asReadonly(),
+        };
+    });
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { devicePosture };
+//# sourceMappingURL=signality-core-browser-device-posture.mjs.map

package/fesm2022/signality-core-browser-device-posture.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-device-posture.mjs","sources":["../../../projects/core/browser/device-posture/index.ts","../../../projects/core/browser/device-posture/signality-core-browser-device-posture.ts"],"sourcesContent":["import { type Signal, signal } from '@angular/core';\nimport { constSignal, setupContext } from '@signality/core/internal';\nimport type { WithInjector } from '@signality/core/types';\nimport { listener, setupSync } from '@signality/core/browser/listener';\n\nexport type DevicePostureType = 'continuous' | 'folded';\n\nexport interface DevicePostureRef {\n  /** Whether Device Posture API is supported */\n  readonly isSupported: Signal<boolean>;\n\n  /** Current device posture */\n  readonly type: Signal<DevicePostureType>;\n}\n\n/**\n * Signal-based wrapper around the [Device Posture API](https://developer.mozilla.org/en-US/docs/Web/API/Device_Posture_API).\n * Track device posture state for foldable devices.\n *\n * @param options - Optional configuration including injector\n * @returns A DevicePostureRef with type signal\n *\n */\nexport function devicePosture(options?: WithInjector): DevicePostureRef {\n  const { runInContext } = setupContext(options?.injector, devicePosture);\n\n  return runInContext(({ isBrowser }) => {\n    const isSupported = constSignal(\n      isBrowser && 'devicePosture' in navigator && !!navigator.devicePosture\n    );\n\n    if (!isSupported()) {\n      return {\n        isSupported,\n        type: constSignal('continuous'),\n      };\n    }\n\n    const { devicePosture } = navigator as NavigatorWithDevicePosture;\n\n    const type = signal<DevicePostureType>(devicePosture.type);\n\n    setupSync(() => {\n      listener(devicePosture, 'change', () => type.set(devicePosture.type));\n    });\n\n    return {\n      isSupported,\n      type: type.asReadonly(),\n    };\n  });\n}\n\ninterface DevicePosture extends EventTarget {\n  readonly type: DevicePostureType;\n}\n\ninterface NavigatorWithDevicePosture extends Navigator {\n  readonly devicePosture: DevicePosture;\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAeA;;;;;;;AAOG;AACG,SAAU,aAAa,CAAC,OAAsB,EAAA;AAClD,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC;AAEvE,IAAA,OAAO,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,KAAI;AACpC,QAAA,MAAM,WAAW,GAAG,WAAW,CAC7B,SAAS,IAAI,eAAe,IAAI,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC,aAAa,CACvE;AAED,QAAA,IAAI,CAAC,WAAW,EAAE,EAAE;YAClB,OAAO;gBACL,WAAW;AACX,gBAAA,IAAI,EAAE,WAAW,CAAC,YAAY,CAAC;aAChC;QACH;AAEA,QAAA,MAAM,EAAE,aAAa,EAAE,GAAG,SAAuC;QAEjE,MAAM,IAAI,GAAG,MAAM,CAAoB,aAAa,CAAC,IAAI,gDAAC;QAE1D,SAAS,CAAC,MAAK;AACb,YAAA,QAAQ,CAAC,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;AACvE,QAAA,CAAC,CAAC;QAEF,OAAO;YACL,WAAW;AACX,YAAA,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE;SACxB;AACH,IAAA,CAAC,CAAC;AACJ;;ACnDA;;AAEG;;;;"}

package/fesm2022/signality-core-browser-display-media.mjs

@@ -0,0 +1,121 @@
+import { signal, computed, untracked } from '@angular/core';
+import { setupContext, constSignal, NOOP_FN } from '@signality/core/internal';
+import { listener } from '@signality/core/browser/listener';
+
+/**
+ * Signal-based wrapper around the [Screen Capture API](https://developer.mozilla.org/en-US/docs/Web/API/Screen_Capture_API).
+ * Capture screen content with Angular signals.
+ *
+ * @param options - Optional default configuration
+ * @returns A DisplayMediaRef with isSupported, stream, error signals and control methods
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     @if (screen.isSupported()) {
+ *       <button (click)="toggleCapture()">
+ *         {{ screen.isActive() ? 'Stop' : 'Start' }} Screen Capture
+ *       </button>
+ *       @if (screen.stream(); as stream) {
+ *         <video [srcObject]="stream" autoplay></video>
+ *       }
+ *       @if (screen.error(); as error) {
+ *         <p class="error">{{ error.message }}</p>
+ *       }
+ *     } @else {
+ *       <p>Screen Capture API not supported</p>
+ *     }
+ *   `
+ * })
+ * class ScreenCaptureComponent {
+ *   readonly screen = displayMedia();
+ *
+ *   async toggleCapture() {
+ *     if (this.screen.isActive()) {
+ *       this.screen.stop();
+ *     } else {
+ *       await this.screen.start();
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom constraints
+ * const screen = displayMedia({
+ *   video: {
+ *     width: { ideal: 1920 },
+ *     height: { ideal: 1080 },
+ *   },
+ *   audio: true,
+ * });
+ * ```
+ */
+function displayMedia(options) {
+    const { runInContext } = setupContext(options?.injector, displayMedia);
+    return runInContext(({ isBrowser, injector, onCleanup }) => {
+        const isSupported = constSignal(isBrowser &&
+            'mediaDevices' in navigator &&
+            typeof navigator.mediaDevices?.getDisplayMedia === 'function');
+        if (!isSupported()) {
+            return {
+                isSupported,
+                isActive: constSignal(false),
+                stream: constSignal(null),
+                error: constSignal(null),
+                start: () => Promise.resolve(null),
+                stop: NOOP_FN,
+            };
+        }
+        const defaults = {
+            video: options?.video ?? true,
+            audio: options?.audio ?? false,
+        };
+        const stream = signal(null, ...(ngDevMode ? [{ debugName: "stream" }] : []));
+        const error = signal(null, ...(ngDevMode ? [{ debugName: "error" }] : []));
+        const isActive = computed(() => stream() !== null, ...(ngDevMode ? [{ debugName: "isActive" }] : []));
+        const start = async (overrides) => {
+            try {
+                stop();
+                const mergedOptions = { ...defaults, ...overrides };
+                const mediaStream = await navigator.mediaDevices.getDisplayMedia(mergedOptions);
+                stream.set(mediaStream);
+                error.set(null);
+                mediaStream
+                    .getTracks()
+                    .forEach(track => listener(track, 'ended', () => stop(), { injector }));
+                return mediaStream;
+            }
+            catch (err) {
+                error.set(err);
+                return null;
+            }
+        };
+        const stop = () => {
+            const currStream = untracked(stream);
+            if (currStream) {
+                currStream.getTracks().forEach(track => track.stop());
+                stream.set(null);
+            }
+            error.set(null);
+        };
+        onCleanup(stop);
+        return {
+            isSupported,
+            isActive: isActive,
+            stream: stream.asReadonly(),
+            error: error.asReadonly(),
+            start,
+            stop,
+        };
+    });
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { displayMedia };
+//# sourceMappingURL=signality-core-browser-display-media.mjs.map

package/fesm2022/signality-core-browser-display-media.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-display-media.mjs","sources":["../../../projects/core/browser/display-media/index.ts","../../../projects/core/browser/display-media/signality-core-browser-display-media.ts"],"sourcesContent":["import { computed, type Signal, signal, untracked } from '@angular/core';\nimport { constSignal, NOOP_FN, setupContext } from '@signality/core/internal';\nimport type { WithInjector } from '@signality/core/types';\nimport { listener } from '@signality/core/browser/listener';\n\nexport interface DisplayMediaOptions extends WithInjector {\n  /**\n   * Video constraints.\n   * @default true\n   */\n  readonly video?: boolean | MediaTrackConstraints;\n\n  /**\n   * Audio constraints.\n   * @default false\n   */\n  readonly audio?: boolean | MediaTrackConstraints;\n}\n\nexport interface DisplayMediaRef {\n  /** Whether Screen Capture API is supported */\n  readonly isSupported: Signal<boolean>;\n\n  /** Whether currently capturing */\n  readonly isActive: Signal<boolean>;\n\n  /** Current media stream */\n  readonly stream: Signal<MediaStream | null>;\n\n  /** Last error */\n  readonly error: Signal<Error | null>;\n\n  /** Start screen capture */\n  readonly start: (options?: DisplayMediaOptions) => Promise<MediaStream | null>;\n\n  /** Stop screen capture */\n  readonly stop: () => void;\n}\n\n/**\n * Signal-based wrapper around the [Screen Capture API](https://developer.mozilla.org/en-US/docs/Web/API/Screen_Capture_API).\n * Capture screen content with Angular signals.\n *\n * @param options - Optional default configuration\n * @returns A DisplayMediaRef with isSupported, stream, error signals and control methods\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     @if (screen.isSupported()) {\n *       <button (click)=\"toggleCapture()\">\n *         {{ screen.isActive() ? 'Stop' : 'Start' }} Screen Capture\n *       </button>\n *       @if (screen.stream(); as stream) {\n *         <video [srcObject]=\"stream\" autoplay></video>\n *       }\n *       @if (screen.error(); as error) {\n *         <p class=\"error\">{{ error.message }}</p>\n *       }\n *     } @else {\n *       <p>Screen Capture API not supported</p>\n *     }\n *   `\n * })\n * class ScreenCaptureComponent {\n *   readonly screen = displayMedia();\n *\n *   async toggleCapture() {\n *     if (this.screen.isActive()) {\n *       this.screen.stop();\n *     } else {\n *       await this.screen.start();\n *     }\n *   }\n * }\n * ```\n *\n * @example\n * ```typescript\n * // With custom constraints\n * const screen = displayMedia({\n *   video: {\n *     width: { ideal: 1920 },\n *     height: { ideal: 1080 },\n *   },\n *   audio: true,\n * });\n * ```\n */\nexport function displayMedia(options?: DisplayMediaOptions): DisplayMediaRef {\n  const { runInContext } = setupContext(options?.injector, displayMedia);\n\n  return runInContext(({ isBrowser, injector, onCleanup }) => {\n    const isSupported = constSignal(\n      isBrowser &&\n        'mediaDevices' in navigator &&\n        typeof navigator.mediaDevices?.getDisplayMedia === 'function'\n    );\n\n    if (!isSupported()) {\n      return {\n        isSupported,\n        isActive: constSignal(false),\n        stream: constSignal(null),\n        error: constSignal(null),\n        start: () => Promise.resolve(null),\n        stop: NOOP_FN,\n      };\n    }\n\n    const defaults: DisplayMediaOptions = {\n      video: options?.video ?? true,\n      audio: options?.audio ?? false,\n    };\n\n    const stream = signal<MediaStream | null>(null);\n    const error = signal<Error | null>(null);\n    const isActive = computed(() => stream() !== null);\n\n    const start = async (overrides?: DisplayMediaOptions): Promise<MediaStream | null> => {\n      try {\n        stop();\n\n        const mergedOptions = { ...defaults, ...overrides };\n        const mediaStream = await navigator.mediaDevices.getDisplayMedia(mergedOptions);\n\n        stream.set(mediaStream);\n        error.set(null);\n\n        mediaStream\n          .getTracks()\n          .forEach(track => listener(track, 'ended', () => stop(), { injector }));\n\n        return mediaStream;\n      } catch (err) {\n        error.set(err as DOMException | TypeError);\n        return null;\n      }\n    };\n\n    const stop = () => {\n      const currStream = untracked(stream);\n      if (currStream) {\n        currStream.getTracks().forEach(track => track.stop());\n        stream.set(null);\n      }\n      error.set(null);\n    };\n\n    onCleanup(stop);\n\n    return {\n      isSupported,\n      isActive: isActive,\n      stream: stream.asReadonly(),\n      error: error.asReadonly(),\n      start,\n      stop,\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-eye-dropper.mjs

@@ -0,0 +1,82 @@
+import { signal } from '@angular/core';
+import { setupContext, constSignal, NOOP_FN, NOOP_ASYNC_FN } from '@signality/core/internal';
+
+/**
+ * Signal-based wrapper around the [EyeDropper API](https://developer.mozilla.org/en-US/docs/Web/API/EyeDropper_API).
+ *
+ * @param options - Optional configuration
+ * @returns An {@link EyeDropperRef} with `isSupported`, `sRGBHex` signals and `open`/`close` methods
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     @if (eyeDropper.isSupported()) {
+ *       <button (click)="pickColor()">Pick Color</button>
+ *       <div [style.background-color]="eyeDropper.sRGBHex()">
+ *         Selected: {{ eyeDropper.sRGBHex() }}
+ *       </div>
+ *     }
+ *   `
+ * })
+ * class ColorPickerComponent {
+ *   readonly eyeDropper = eyeDropper();
+ *
+ *   async pickColor() {
+ *     await this.eyeDropper.open();
+ *   }
+ * }
+ * ```
+ */
+function eyeDropper(options) {
+    const { runInContext } = setupContext(options?.injector, eyeDropper);
+    return runInContext(({ isBrowser, onCleanup }) => {
+        const isSupported = constSignal(isBrowser && 'EyeDropper' in window);
+        if (!isSupported()) {
+            return {
+                isSupported,
+                sRGBHex: constSignal(''),
+                open: NOOP_ASYNC_FN,
+                close: NOOP_FN,
+            };
+        }
+        const sRGBHex = signal(options?.initialValue ?? '', ...(ngDevMode ? [{ debugName: "sRGBHex" }] : []));
+        let abortController = null;
+        const open = async () => {
+            close();
+            abortController = new AbortController();
+            const eyeDropper = new window.EyeDropper();
+            try {
+                const result = await eyeDropper.open({ signal: abortController.signal });
+                sRGBHex.set(result.sRGBHex);
+            }
+            catch (error) {
+                if (ngDevMode) {
+                    console.warn(`[eyeDropper] Failed to open eyedropper. ` +
+                        `This may be due to user cancellation or an error occurred.`, error);
+                }
+            }
+            finally {
+                abortController = null;
+            }
+        };
+        const close = () => {
+            abortController?.abort();
+            abortController = null;
+        };
+        onCleanup(close);
+        return {
+            isSupported,
+            sRGBHex: sRGBHex.asReadonly(),
+            open,
+            close,
+        };
+    });
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { eyeDropper };
+//# sourceMappingURL=signality-core-browser-eye-dropper.mjs.map

package/fesm2022/signality-core-browser-eye-dropper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-eye-dropper.mjs","sources":["../../../projects/core/browser/eye-dropper/index.ts","../../../projects/core/browser/eye-dropper/signality-core-browser-eye-dropper.ts"],"sourcesContent":["import { type Signal, signal } from '@angular/core';\nimport { constSignal, NOOP_ASYNC_FN, NOOP_FN, setupContext } from '@signality/core/internal';\nimport type { WithInjector } from '@signality/core/types';\n\nexport interface EyeDropperOptions extends WithInjector {\n  /**\n   * Initial color value in sRGB hex format.\n   * @default ''\n   */\n  readonly initialValue?: string;\n}\n\nexport interface EyeDropperRef {\n  /** Current selected color in sRGB hex format */\n  readonly sRGBHex: Signal<string>;\n\n  /** Whether EyeDropper API is supported */\n  readonly isSupported: Signal<boolean>;\n\n  /** Open the eyedropper tool to select a color */\n  readonly open: () => Promise<void>;\n\n  /** Cancel the active eyedropper operation */\n  readonly close: () => void;\n}\n\n/**\n * Signal-based wrapper around the [EyeDropper API](https://developer.mozilla.org/en-US/docs/Web/API/EyeDropper_API).\n *\n * @param options - Optional configuration\n * @returns An {@link EyeDropperRef} with `isSupported`, `sRGBHex` signals and `open`/`close` methods\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     @if (eyeDropper.isSupported()) {\n *       <button (click)=\"pickColor()\">Pick Color</button>\n *       <div [style.background-color]=\"eyeDropper.sRGBHex()\">\n *         Selected: {{ eyeDropper.sRGBHex() }}\n *       </div>\n *     }\n *   `\n * })\n * class ColorPickerComponent {\n *   readonly eyeDropper = eyeDropper();\n *\n *   async pickColor() {\n *     await this.eyeDropper.open();\n *   }\n * }\n * ```\n */\nexport function eyeDropper(options?: EyeDropperOptions): EyeDropperRef {\n  const { runInContext } = setupContext(options?.injector, eyeDropper);\n\n  return runInContext(({ isBrowser, onCleanup }) => {\n    const isSupported = constSignal(isBrowser && 'EyeDropper' in window);\n\n    if (!isSupported()) {\n      return {\n        isSupported,\n        sRGBHex: constSignal(''),\n        open: NOOP_ASYNC_FN,\n        close: NOOP_FN,\n      };\n    }\n\n    const sRGBHex = signal(options?.initialValue ?? '');\n\n    let abortController: AbortController | null = null;\n\n    const open = async (): Promise<void> => {\n      close();\n\n      abortController = new AbortController();\n      const eyeDropper: EyeDropper = new (window as any).EyeDropper();\n\n      try {\n        const result = await eyeDropper.open({ signal: abortController.signal });\n        sRGBHex.set(result.sRGBHex);\n      } catch (error) {\n        if (ngDevMode) {\n          console.warn(\n            `[eyeDropper] Failed to open eyedropper. ` +\n              `This may be due to user cancellation or an error occurred.`,\n            error\n          );\n        }\n      } finally {\n        abortController = null;\n      }\n    };\n\n    const close = () => {\n      abortController?.abort();\n      abortController = null;\n    };\n\n    onCleanup(close);\n\n    return {\n      isSupported,\n      sRGBHex: sRGBHex.asReadonly(),\n      open,\n      close,\n    };\n  });\n}\n\ninterface EyeDropper {\n  // eslint-disable-next-line @typescript-eslint/no-misused-new\n  new (): EyeDropper;\n  readonly open: (options?: EyeDropperOpenOptions) => Promise<{ sRGBHex: string }>;\n  [Symbol.toStringTag]: 'EyeDropper';\n}\n\ninterface EyeDropperOpenOptions {\n  /**\n   * AbortSignal to cancel the eyedropper operation.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal\n   */\n  readonly signal?: AbortSignal;\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;AA0BA;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BG;AACG,SAAU,UAAU,CAAC,OAA2B,EAAA;AACpD,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;IAEpE,OAAO,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,KAAI;QAC/C,MAAM,WAAW,GAAG,WAAW,CAAC,SAAS,IAAI,YAAY,IAAI,MAAM,CAAC;AAEpE,QAAA,IAAI,CAAC,WAAW,EAAE,EAAE;YAClB,OAAO;gBACL,WAAW;AACX,gBAAA,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;AACxB,gBAAA,IAAI,EAAE,aAAa;AACnB,gBAAA,KAAK,EAAE,OAAO;aACf;QACH;QAEA,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,YAAY,IAAI,EAAE,EAAA,IAAA,SAAA,GAAA,CAAA,EAAA,SAAA,EAAA,SAAA,EAAA,CAAA,GAAA,EAAA,CAAA,CAAC;QAEnD,IAAI,eAAe,GAA2B,IAAI;AAElD,QAAA,MAAM,IAAI,GAAG,YAA0B;AACrC,YAAA,KAAK,EAAE;AAEP,YAAA,eAAe,GAAG,IAAI,eAAe,EAAE;AACvC,YAAA,MAAM,UAAU,GAAe,IAAK,MAAc,CAAC,UAAU,EAAE;AAE/D,YAAA,IAAI;AACF,gBAAA,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,CAAC;AACxE,gBAAA,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;YAC7B;YAAE,OAAO,KAAK,EAAE;gBACd,IAAI,SAAS,EAAE;oBACb,OAAO,CAAC,IAAI,CACV,CAAA,wCAAA,CAA0C;wBACxC,CAAA,0DAAA,CAA4D,EAC9D,KAAK,CACN;gBACH;YACF;oBAAU;gBACR,eAAe,GAAG,IAAI;YACxB;AACF,QAAA,CAAC;QAED,MAAM,KAAK,GAAG,MAAK;YACjB,eAAe,EAAE,KAAK,EAAE;YACxB,eAAe,GAAG,IAAI;AACxB,QAAA,CAAC;QAED,SAAS,CAAC,KAAK,CAAC;QAEhB,OAAO;YACL,WAAW;AACX,YAAA,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE;YAC7B,IAAI;YACJ,KAAK;SACN;AACH,IAAA,CAAC,CAAC;AACJ;;AC5GA;;AAEG;;;;"}

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

@@ -0,0 +1,100 @@
+import { inject, signal, untracked } from '@angular/core';
+import { APP_BASE_HREF } from '@angular/common';
+import { setupContext, NOOP_FN, constSignal, createToken } from '@signality/core/internal';
+
+/**
+ * Reactive favicon manipulation.
+ * Dynamically change the page favicon based on application state.
+ *
+ * @param options - Optional configuration
+ * @returns A FaviconRef with favicon control methods
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <button (click)="setNotification()">Set Notification</button>
+ *     <button (click)="fav.reset()">Reset Favicon</button>
+ *     <p>Current: {{ fav.current() }}</p>
+ *   `
+ * })
+ * class FaviconComponent {
+ *   readonly fav = favicon();
+ *
+ *   setNotification() {
+ *     this.fav.setEmoji('🔴');
+ *   }
+ * }
+ * ```
+ */
+function favicon(options) {
+    const { runInContext } = setupContext(options?.injector, favicon);
+    return runInContext(({ isServer }) => {
+        if (isServer) {
+            return {
+                current: constSignal(''),
+                original: constSignal(''),
+                set: NOOP_FN,
+                setEmoji: NOOP_FN,
+                reset: NOOP_FN,
+            };
+        }
+        const appBaseHref = inject(APP_BASE_HREF, { optional: true });
+        const baseUrl = options?.baseUrl ?? appBaseHref ?? '';
+        const getLinkElement = () => {
+            let link = document.querySelector('link[rel*="icon"]');
+            if (!link) {
+                link = document.createElement('link');
+                link.rel = 'icon';
+                document.head.appendChild(link);
+            }
+            return link;
+        };
+        const { href = '' } = getLinkElement();
+        const current = signal(href, ...(ngDevMode ? [{ debugName: "current" }] : []));
+        const original = signal(href, ...(ngDevMode ? [{ debugName: "original" }] : []));
+        const set = (url) => {
+            const fullUrl = baseUrl + url;
+            const linkEl = getLinkElement();
+            linkEl.href = fullUrl;
+            current.set(fullUrl);
+        };
+        const setEmoji = (emoji) => {
+            const canvas = document.createElement('canvas');
+            canvas.width = 32;
+            canvas.height = 32;
+            const ctx = canvas.getContext('2d');
+            if (!ctx)
+                return;
+            ctx.font = '28px serif';
+            ctx.textAlign = 'center';
+            ctx.textBaseline = 'middle';
+            ctx.fillText(emoji, 16, 18);
+            const dataUrl = canvas.toDataURL('image/png');
+            const linkEl = getLinkElement();
+            linkEl.href = dataUrl;
+            current.set(dataUrl);
+        };
+        const reset = () => {
+            const linkEl = getLinkElement();
+            const originalHref = untracked(original);
+            linkEl.href = originalHref;
+            current.set(originalHref);
+        };
+        return {
+            current: current.asReadonly(),
+            original: original.asReadonly(),
+            set,
+            setEmoji,
+            reset,
+        };
+    });
+}
+const FAVICON = /* @__PURE__ */ createToken(favicon);
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { FAVICON, favicon };
+//# sourceMappingURL=signality-core-browser-favicon.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-favicon.mjs","sources":["../../../projects/core/browser/favicon/index.ts","../../../projects/core/browser/favicon/signality-core-browser-favicon.ts"],"sourcesContent":["import { inject, type Signal, signal, untracked } from '@angular/core';\nimport { APP_BASE_HREF } from '@angular/common';\nimport { constSignal, createToken, NOOP_FN, setupContext } from '@signality/core/internal';\nimport type { WithInjector } from '@signality/core/types';\n\nexport interface FaviconOptions extends WithInjector {\n  readonly baseUrl?: string;\n}\n\nexport interface FaviconRef {\n  readonly current: Signal<string>;\n  readonly original: Signal<string>;\n  readonly set: (url: string) => void;\n  readonly setEmoji: (emoji: string) => void;\n  readonly reset: () => void;\n}\n\n/**\n * Reactive favicon manipulation.\n * Dynamically change the page favicon based on application state.\n *\n * @param options - Optional configuration\n * @returns A FaviconRef with favicon control methods\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <button (click)=\"setNotification()\">Set Notification</button>\n *     <button (click)=\"fav.reset()\">Reset Favicon</button>\n *     <p>Current: {{ fav.current() }}</p>\n *   `\n * })\n * class FaviconComponent {\n *   readonly fav = favicon();\n *\n *   setNotification() {\n *     this.fav.setEmoji('🔴');\n *   }\n * }\n * ```\n */\nexport function favicon(options?: FaviconOptions): FaviconRef {\n  const { runInContext } = setupContext(options?.injector, favicon);\n\n  return runInContext(({ isServer }) => {\n    if (isServer) {\n      return {\n        current: constSignal(''),\n        original: constSignal(''),\n        set: NOOP_FN,\n        setEmoji: NOOP_FN,\n        reset: NOOP_FN,\n      };\n    }\n\n    const appBaseHref = inject(APP_BASE_HREF, { optional: true });\n    const baseUrl = options?.baseUrl ?? appBaseHref ?? '';\n\n    const getLinkElement = (): HTMLLinkElement => {\n      let link = document.querySelector<HTMLLinkElement>('link[rel*=\"icon\"]');\n\n      if (!link) {\n        link = document.createElement('link');\n        link.rel = 'icon';\n        document.head.appendChild(link);\n      }\n\n      return link;\n    };\n\n    const { href = '' } = getLinkElement();\n    const current = signal(href);\n    const original = signal(href);\n\n    const set = (url: string) => {\n      const fullUrl = baseUrl + url;\n      const linkEl = getLinkElement();\n      linkEl.href = fullUrl;\n      current.set(fullUrl);\n    };\n\n    const setEmoji = (emoji: string) => {\n      const canvas = document.createElement('canvas');\n      canvas.width = 32;\n      canvas.height = 32;\n\n      const ctx = canvas.getContext('2d');\n      if (!ctx) return;\n\n      ctx.font = '28px serif';\n      ctx.textAlign = 'center';\n      ctx.textBaseline = 'middle';\n      ctx.fillText(emoji, 16, 18);\n\n      const dataUrl = canvas.toDataURL('image/png');\n      const linkEl = getLinkElement();\n      linkEl.href = dataUrl;\n      current.set(dataUrl);\n    };\n\n    const reset = () => {\n      const linkEl = getLinkElement();\n      const originalHref = untracked(original);\n      linkEl.href = originalHref;\n      current.set(originalHref);\n    };\n\n    return {\n      current: current.asReadonly(),\n      original: original.asReadonly(),\n      set,\n      setEmoji,\n      reset,\n    };\n  });\n}\n\nexport const FAVICON = /* @__PURE__ */ createToken(favicon);\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAiBA;;;;;;;;;;;;;;;;;;;;;;;;AAwBG;AACG,SAAU,OAAO,CAAC,OAAwB,EAAA;AAC9C,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC;AAEjE,IAAA,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAI;QACnC,IAAI,QAAQ,EAAE;YACZ,OAAO;AACL,gBAAA,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;AACxB,gBAAA,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC;AACzB,gBAAA,GAAG,EAAE,OAAO;AACZ,gBAAA,QAAQ,EAAE,OAAO;AACjB,gBAAA,KAAK,EAAE,OAAO;aACf;QACH;AAEA,QAAA,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC7D,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,WAAW,IAAI,EAAE;QAErD,MAAM,cAAc,GAAG,MAAsB;YAC3C,IAAI,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAkB,mBAAmB,CAAC;YAEvE,IAAI,CAAC,IAAI,EAAE;AACT,gBAAA,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC;AACrC,gBAAA,IAAI,CAAC,GAAG,GAAG,MAAM;AACjB,gBAAA,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YACjC;AAEA,YAAA,OAAO,IAAI;AACb,QAAA,CAAC;QAED,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,cAAc,EAAE;AACtC,QAAA,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,mDAAC;AAC5B,QAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,oDAAC;AAE7B,QAAA,MAAM,GAAG,GAAG,CAAC,GAAW,KAAI;AAC1B,YAAA,MAAM,OAAO,GAAG,OAAO,GAAG,GAAG;AAC7B,YAAA,MAAM,MAAM,GAAG,cAAc,EAAE;AAC/B,YAAA,MAAM,CAAC,IAAI,GAAG,OAAO;AACrB,YAAA,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;AACtB,QAAA,CAAC;AAED,QAAA,MAAM,QAAQ,GAAG,CAAC,KAAa,KAAI;YACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC;AAC/C,YAAA,MAAM,CAAC,KAAK,GAAG,EAAE;AACjB,YAAA,MAAM,CAAC,MAAM,GAAG,EAAE;YAElB,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;AACnC,YAAA,IAAI,CAAC,GAAG;gBAAE;AAEV,YAAA,GAAG,CAAC,IAAI,GAAG,YAAY;AACvB,YAAA,GAAG,CAAC,SAAS,GAAG,QAAQ;AACxB,YAAA,GAAG,CAAC,YAAY,GAAG,QAAQ;YAC3B,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC;YAE3B,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC;AAC7C,YAAA,MAAM,MAAM,GAAG,cAAc,EAAE;AAC/B,YAAA,MAAM,CAAC,IAAI,GAAG,OAAO;AACrB,YAAA,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;AACtB,QAAA,CAAC;QAED,MAAM,KAAK,GAAG,MAAK;AACjB,YAAA,MAAM,MAAM,GAAG,cAAc,EAAE;AAC/B,YAAA,MAAM,YAAY,GAAG,SAAS,CAAC,QAAQ,CAAC;AACxC,YAAA,MAAM,CAAC,IAAI,GAAG,YAAY;AAC1B,YAAA,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;AAC3B,QAAA,CAAC;QAED,OAAO;AACL,YAAA,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE;AAC7B,YAAA,QAAQ,EAAE,QAAQ,CAAC,UAAU,EAAE;YAC/B,GAAG;YACH,QAAQ;YACR,KAAK;SACN;AACH,IAAA,CAAC,CAAC;AACJ;AAEO,MAAM,OAAO,mBAAmB,WAAW,CAAC,OAAO;;ACtH1D;;AAEG;;;;"}