@signality/core 0.0.1-alpha.2

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

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-media-query.mjs","sources":["../../../projects/core/browser/media-query/index.ts","../../../projects/core/browser/media-query/signality-core-browser-media-query.ts"],"sourcesContent":["import { type CreateSignalOptions, effect, type Signal, signal } from '@angular/core';\nimport { constSignal, setupContext, toValue, type Union } from '@signality/core/internal';\nimport type { MaybeSignal, WithInjector } from '@signality/core/types';\nimport { listener } from '@signality/core/browser/listener';\n\nexport interface MediaQueryOptions extends CreateSignalOptions<boolean>, WithInjector {\n  /**\n   * Initial value for SSR.\n   * @default false\n   */\n  readonly initialValue?: boolean;\n}\n\n/**\n * Reactive wrapper around the [Window.matchMedia](https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia) method.\n *\n * @param query - CSS media query string (can be a signal)\n * @param options - Optional configuration\n * @returns A signal that is true when the media query matches\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     @if (prefersDark()) {\n *       <p>Dark mode is preferred</p>\n *     } @else {\n *       <p>Light mode is preferred</p>\n *     }\n *   `\n * })\n * class ThemeComponent {\n *   readonly prefersDark = mediaQuery('(prefers-color-scheme: dark)');\n * }\n * ```\n */\nexport function mediaQuery(\n  query: MaybeSignal<Union<MediaQueryFeature, string>>,\n  options?: MediaQueryOptions\n): Signal<boolean> {\n  const { runInContext } = setupContext(options?.injector, mediaQuery);\n\n  return runInContext(({ isServer, injector }) => {\n    if (isServer) {\n      return constSignal(!!options?.initialValue);\n    }\n\n    const matches = signal(!!options?.initialValue, options);\n\n    effect(onCleanup => {\n      const queryString = toValue(query);\n\n      if (!queryString) {\n        matches.set(false);\n        return;\n      }\n\n      const mediaQueryList = window.matchMedia(queryString);\n\n      matches.set(mediaQueryList.matches);\n\n      const changeListener = listener(\n        mediaQueryList,\n        'change',\n        (e: MediaQueryListEvent) => matches.set(e.matches),\n        { injector }\n      );\n\n      onCleanup(changeListener.destroy);\n    });\n\n    return matches.asReadonly();\n  });\n}\n\ntype MediaQueryFeature =\n  | `(any-hover: ${'none' | 'hover'})`\n  | `(any-pointer: ${'none' | 'coarse' | 'fine'})`\n  | `(aspect-ratio: ${string})`\n  | `(color: ${string})`\n  | `(color-gamut: ${'srgb' | 'p3' | 'rec2020'})`\n  | `(color-index: ${string})`\n  | `(device-aspect-ratio: ${string})`\n  | `(device-height: ${string})`\n  | `(device-posture: ${'flat' | 'folded' | 'continuous'})`\n  | `(device-width: ${string})`\n  | `(display-mode: ${\n      | 'fullscreen'\n      | 'standalone'\n      | 'minimal-ui'\n      | 'browser'\n      | 'picture-in-picture'\n      | 'window-controls-overlay'})`\n  | `(dynamic-range: ${'standard' | 'high'})`\n  | `(forced-colors: ${'none' | 'active'})`\n  | `(grid: ${'0' | '1'})`\n  | `(height: ${string})`\n  | `(hover: ${'none' | 'hover'})`\n  | `(inverted-colors: ${'none' | 'inverted'})`\n  | `(monochrome: ${string})`\n  | `(orientation: ${'portrait' | 'landscape'})`\n  | `(overflow-block: ${'none' | 'scroll' | 'optional-paged' | 'paged'})`\n  | `(overflow-inline: ${'none' | 'scroll'})`\n  | `(pointer: ${'none' | 'coarse' | 'fine'})`\n  | `(prefers-color-scheme: ${'light' | 'dark' | 'no-preference'})`\n  | `(prefers-contrast: ${'no-preference' | 'more' | 'less' | 'custom'})`\n  | `(prefers-reduced-data: ${'no-preference' | 'reduce'})`\n  | `(prefers-reduced-motion: ${'no-preference' | 'reduce'})`\n  | `(prefers-reduced-transparency: ${'no-preference' | 'reduce'})`\n  | `(resolution: ${string})`\n  | `(scan: ${'progressive' | 'interlace'})`\n  | `(scripting: ${'none' | 'initial-only' | 'enabled'})`\n  | `(shape: ${'rect' | 'round'})`\n  | `(update: ${'none' | 'slow' | 'fast'})`\n  | `(video-dynamic-range: ${'standard' | 'high'})`\n  | `(width: ${string})`\n  | `(min-width: ${string})`\n  | `(max-width: ${string})`\n  | `(min-height: ${string})`\n  | `(max-height: ${string})`\n  | `(min-aspect-ratio: ${string})`\n  | `(max-aspect-ratio: ${string})`\n  | `(min-resolution: ${string})`\n  | `(max-resolution: ${string})`\n  | `(min-color: ${string})`\n  | `(max-color: ${string})`\n  | `(min-color-index: ${string})`\n  | `(max-color-index: ${string})`\n  | `(min-monochrome: ${string})`\n  | `(max-monochrome: ${string})`;\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAaA;;;;;;;;;;;;;;;;;;;;;;AAsBG;AACG,SAAU,UAAU,CACxB,KAAoD,EACpD,OAA2B,EAAA;AAE3B,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;IAEpE,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAI;QAC7C,IAAI,QAAQ,EAAE;YACZ,OAAO,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC;QAC7C;AAEA,QAAA,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC;QAExD,MAAM,CAAC,SAAS,IAAG;AACjB,YAAA,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC;YAElC,IAAI,CAAC,WAAW,EAAE;AAChB,gBAAA,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;gBAClB;YACF;YAEA,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC;AAErD,YAAA,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC;YAEnC,MAAM,cAAc,GAAG,QAAQ,CAC7B,cAAc,EACd,QAAQ,EACR,CAAC,CAAsB,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAClD,EAAE,QAAQ,EAAE,CACb;AAED,YAAA,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC;AACnC,QAAA,CAAC,CAAC;AAEF,QAAA,OAAO,OAAO,CAAC,UAAU,EAAE;AAC7B,IAAA,CAAC,CAAC;AACJ;;ACzEA;;AAEG;;;;"}

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

@@ -0,0 +1,76 @@
+import { inject, signal } from '@angular/core';
+import { setupContext, constSignal, createToken } from '@signality/core/internal';
+import { setupSync, listener } from '@signality/core/browser/listener';
+import { ONLINE } from '@signality/core/browser/online';
+
+/**
+ * Signal-based wrapper around the Network Information API and online/offline events.
+ *
+ * @param options - Optional configuration including injector
+ * @returns A NetworkRef with network status signals
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <p>{{ net.isOnline() ? 'Online' : 'Offline' }}</p>
+ *     @if (net.effectiveType()) {
+ *       <p>Connection: {{ net.effectiveType() }}</p>
+ *     }
+ *   `
+ * })
+ * class NetworkComponent {
+ *   readonly net = network();
+ * }
+ * ```
+ */
+function network(options) {
+    const { runInContext } = setupContext(options?.injector, network);
+    return runInContext(({ isBrowser }) => {
+        const isSupported = constSignal(isBrowser && 'connection' in navigator);
+        if (!isSupported()) {
+            return {
+                isSupported,
+                isOnline: constSignal(true),
+                effectiveType: constSignal(undefined),
+                downlink: constSignal(undefined),
+                rtt: constSignal(undefined),
+                saveData: constSignal(false),
+                type: constSignal(undefined),
+            };
+        }
+        const { connection } = navigator;
+        const isOnline = inject(ONLINE);
+        const effectiveType = signal(connection.effectiveType, ...(ngDevMode ? [{ debugName: "effectiveType" }] : []));
+        const downlink = signal(connection.downlink, ...(ngDevMode ? [{ debugName: "downlink" }] : []));
+        const rtt = signal(connection.rtt, ...(ngDevMode ? [{ debugName: "rtt" }] : []));
+        const saveData = signal(!!connection.saveData, ...(ngDevMode ? [{ debugName: "saveData" }] : []));
+        const type = signal(connection.type, ...(ngDevMode ? [{ debugName: "type" }] : []));
+        setupSync(() => {
+            listener(connection, 'change', () => {
+                effectiveType.set(connection.effectiveType);
+                downlink.set(connection.downlink);
+                rtt.set(connection.rtt);
+                saveData.set(!!connection.saveData);
+                type.set(connection.type);
+            });
+        });
+        return {
+            isSupported,
+            isOnline,
+            effectiveType: effectiveType.asReadonly(),
+            downlink: downlink.asReadonly(),
+            rtt: rtt.asReadonly(),
+            saveData: saveData.asReadonly(),
+            type: type.asReadonly(),
+        };
+    });
+}
+const NETWORK = /* @__PURE__ */ createToken(network);
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { NETWORK, network };
+//# sourceMappingURL=signality-core-browser-network.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-network.mjs","sources":["../../../projects/core/browser/network/index.ts","../../../projects/core/browser/network/signality-core-browser-network.ts"],"sourcesContent":["import { inject, 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';\nimport { ONLINE } from '@signality/core/browser/online';\n\nexport type EffectiveConnectionType = 'slow-2g' | '2g' | '3g' | '4g';\n\nexport type ConnectionType =\n  | 'bluetooth'\n  | 'cellular'\n  | 'ethernet'\n  | 'wifi'\n  | 'wimax'\n  | 'none'\n  | 'other'\n  | 'unknown';\n\nexport type NetworkOptions = WithInjector;\n\nexport interface NetworkRef {\n  /** Whether Network Information API is supported */\n  readonly isSupported: Signal<boolean>;\n\n  /** Whether the browser is online */\n  readonly isOnline: Signal<boolean>;\n\n  /** Effective connection type */\n  readonly effectiveType: Signal<EffectiveConnectionType | undefined>;\n\n  /** Downlink speed in Mbps */\n  readonly downlink: Signal<number | undefined>;\n\n  /** Round-trip time in ms */\n  readonly rtt: Signal<number | undefined>;\n\n  /** Whether user has data saver enabled */\n  readonly saveData: Signal<boolean>;\n\n  /** Connection type (wifi, cellular, etc.) */\n  readonly type: Signal<ConnectionType | undefined>;\n}\n\n/**\n * Signal-based wrapper around the Network Information API and online/offline events.\n *\n * @param options - Optional configuration including injector\n * @returns A NetworkRef with network status signals\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <p>{{ net.isOnline() ? 'Online' : 'Offline' }}</p>\n *     @if (net.effectiveType()) {\n *       <p>Connection: {{ net.effectiveType() }}</p>\n *     }\n *   `\n * })\n * class NetworkComponent {\n *   readonly net = network();\n * }\n * ```\n */\nexport function network(options?: NetworkOptions): NetworkRef {\n  const { runInContext } = setupContext(options?.injector, network);\n\n  return runInContext(({ isBrowser }) => {\n    const isSupported = constSignal(isBrowser && 'connection' in navigator);\n\n    if (!isSupported()) {\n      return {\n        isSupported,\n        isOnline: constSignal(true),\n        effectiveType: constSignal(undefined),\n        downlink: constSignal(undefined),\n        rtt: constSignal(undefined),\n        saveData: constSignal(false),\n        type: constSignal(undefined),\n      };\n    }\n\n    const { connection } = navigator as NavigatorWithConnection;\n\n    const isOnline = inject(ONLINE);\n    const effectiveType = signal(connection.effectiveType);\n    const downlink = signal(connection.downlink);\n    const rtt = signal(connection.rtt);\n    const saveData = signal(!!connection.saveData);\n    const type = signal(connection.type);\n\n    setupSync(() => {\n      listener(connection, 'change', () => {\n        effectiveType.set(connection.effectiveType);\n        downlink.set(connection.downlink);\n        rtt.set(connection.rtt);\n        saveData.set(!!connection.saveData);\n        type.set(connection.type);\n      });\n    });\n\n    return {\n      isSupported,\n      isOnline,\n      effectiveType: effectiveType.asReadonly(),\n      downlink: downlink.asReadonly(),\n      rtt: rtt.asReadonly(),\n      saveData: saveData.asReadonly(),\n      type: type.asReadonly(),\n    };\n  });\n}\n\nexport const NETWORK = /* @__PURE__ */ createToken(network);\n\ninterface NetworkInformation extends EventTarget {\n  readonly effectiveType?: EffectiveConnectionType;\n  readonly downlink?: number;\n  readonly rtt?: number;\n  readonly saveData?: boolean;\n  readonly type?: ConnectionType;\n}\n\ninterface NavigatorWithConnection extends Navigator {\n  readonly connection: NetworkInformation;\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;AA2CA;;;;;;;;;;;;;;;;;;;;AAoBG;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,SAAS,EAAE,KAAI;QACpC,MAAM,WAAW,GAAG,WAAW,CAAC,SAAS,IAAI,YAAY,IAAI,SAAS,CAAC;AAEvE,QAAA,IAAI,CAAC,WAAW,EAAE,EAAE;YAClB,OAAO;gBACL,WAAW;AACX,gBAAA,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC;AAC3B,gBAAA,aAAa,EAAE,WAAW,CAAC,SAAS,CAAC;AACrC,gBAAA,QAAQ,EAAE,WAAW,CAAC,SAAS,CAAC;AAChC,gBAAA,GAAG,EAAE,WAAW,CAAC,SAAS,CAAC;AAC3B,gBAAA,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC;AAC5B,gBAAA,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC;aAC7B;QACH;AAEA,QAAA,MAAM,EAAE,UAAU,EAAE,GAAG,SAAoC;AAE3D,QAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;QAC/B,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,aAAa,yDAAC;QACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,oDAAC;QAC5C,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,+CAAC;QAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAA,IAAA,SAAA,GAAA,CAAA,EAAA,SAAA,EAAA,UAAA,EAAA,CAAA,GAAA,EAAA,CAAA,CAAC;QAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,gDAAC;QAEpC,SAAS,CAAC,MAAK;AACb,YAAA,QAAQ,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAK;AAClC,gBAAA,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC;AAC3C,gBAAA,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC;AACjC,gBAAA,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;gBACvB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;AACnC,gBAAA,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;AAC3B,YAAA,CAAC,CAAC;AACJ,QAAA,CAAC,CAAC;QAEF,OAAO;YACL,WAAW;YACX,QAAQ;AACR,YAAA,aAAa,EAAE,aAAa,CAAC,UAAU,EAAE;AACzC,YAAA,QAAQ,EAAE,QAAQ,CAAC,UAAU,EAAE;AAC/B,YAAA,GAAG,EAAE,GAAG,CAAC,UAAU,EAAE;AACrB,YAAA,QAAQ,EAAE,QAAQ,CAAC,UAAU,EAAE;AAC/B,YAAA,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE;SACxB;AACH,IAAA,CAAC,CAAC;AACJ;AAEO,MAAM,OAAO,mBAAmB,WAAW,CAAC,OAAO;;ACjH1D;;AAEG;;;;"}

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

@@ -0,0 +1,49 @@
+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.onLine](https://developer.mozilla.org/en-US/docs/Web/API/Navigator/onLine) property.
+ *
+ * @param options - Optional configuration including signal options and injector
+ * @returns A signal containing the current online status (`true` for online, `false` for offline)
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     @if (isOnline()) {
+ *       <p>You're online</p>
+ *     } @else {
+ *       <p>You're offline</p>
+ *     }
+ *   `
+ * })
+ * class NetworkStatusComponent {
+ *   readonly isOnline = online();
+ * }
+ * ```
+ */
+function online(options) {
+    const { runInContext } = setupContext(options?.injector, online);
+    return runInContext(({ isServer }) => {
+        if (isServer) {
+            return constSignal(true);
+        }
+        const isOnline = signal(navigator.onLine, options);
+        const update = () => isOnline.set(navigator.onLine);
+        setupSync(() => {
+            listener(window, 'online', update);
+            listener(window, 'offline', update);
+        });
+        return isOnline.asReadonly();
+    });
+}
+const ONLINE = /* @__PURE__ */ createToken(online);
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { ONLINE, online };
+//# sourceMappingURL=signality-core-browser-online.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-online.mjs","sources":["../../../projects/core/browser/online/index.ts","../../../projects/core/browser/online/signality-core-browser-online.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 type OnlineOptions = CreateSignalOptions<boolean> & WithInjector;\n\n/**\n * Reactive wrapper around the [Navigator.onLine](https://developer.mozilla.org/en-US/docs/Web/API/Navigator/onLine) property.\n *\n * @param options - Optional configuration including signal options and injector\n * @returns A signal containing the current online status (`true` for online, `false` for offline)\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     @if (isOnline()) {\n *       <p>You're online</p>\n *     } @else {\n *       <p>You're offline</p>\n *     }\n *   `\n * })\n * class NetworkStatusComponent {\n *   readonly isOnline = online();\n * }\n * ```\n */\nexport function online(options?: OnlineOptions): Signal<boolean> {\n  const { runInContext } = setupContext(options?.injector, online);\n\n  return runInContext(({ isServer }) => {\n    if (isServer) {\n      return constSignal(true);\n    }\n\n    const isOnline = signal(navigator.onLine, options);\n\n    const update = () => isOnline.set(navigator.onLine);\n\n    setupSync(() => {\n      listener(window, 'online', update);\n      listener(window, 'offline', update);\n    });\n\n    return isOnline.asReadonly();\n  });\n}\n\nexport const ONLINE = /* @__PURE__ */ createToken(online);\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAOA;;;;;;;;;;;;;;;;;;;;;AAqBG;AACG,SAAU,MAAM,CAAC,OAAuB,EAAA;AAC5C,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC;AAEhE,IAAA,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAI;QACnC,IAAI,QAAQ,EAAE;AACZ,YAAA,OAAO,WAAW,CAAC,IAAI,CAAC;QAC1B;QAEA,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC;AAElD,QAAA,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC;QAEnD,SAAS,CAAC,MAAK;AACb,YAAA,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC;AAClC,YAAA,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC;AACrC,QAAA,CAAC,CAAC;AAEF,QAAA,OAAO,QAAQ,CAAC,UAAU,EAAE;AAC9B,IAAA,CAAC,CAAC;AACJ;AAEO,MAAM,MAAM,mBAAmB,WAAW,CAAC,MAAM;;AClDxD;;AAEG;;;;"}

package/fesm2022/signality-core-browser-page-visibility.mjs

@@ -0,0 +1,47 @@
+import { signal } from '@angular/core';
+import { setupContext, constSignal, createToken } from '@signality/core/internal';
+import { setupSync, listener } from '@signality/core/browser/listener';
+
+/**
+ * Signal-based wrapper around the [Page Visibility API](https://developer.mozilla.org/en-US/docs/Web/API/Page_Visibility_API).
+ *
+ * @param options - Optional configuration including signal options and injector
+ * @returns A signal containing the current DocumentVisibilityState ('visible' or 'hidden')
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     @if (visibility() === 'hidden') {
+ *       <p>Page is hidden</p>
+ *     } @else {
+ *       <p>Page is visible</p>
+ *     }
+ *   `
+ * })
+ * class VisibilityComponent {
+ *   readonly visibility = pageVisibility();
+ * }
+ * ```
+ */
+function pageVisibility(options) {
+    const { runInContext } = setupContext(options?.injector, pageVisibility);
+    return runInContext(({ isServer }) => {
+        if (isServer) {
+            return constSignal('visible');
+        }
+        const visibilityState = signal(document.visibilityState, options);
+        setupSync(() => {
+            listener(document, 'visibilitychange', () => visibilityState.set(document.visibilityState));
+        });
+        return visibilityState.asReadonly();
+    });
+}
+const PAGE_VISIBILITY = /* @__PURE__ */ createToken(pageVisibility);
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { PAGE_VISIBILITY, pageVisibility };
+//# sourceMappingURL=signality-core-browser-page-visibility.mjs.map

package/fesm2022/signality-core-browser-page-visibility.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-page-visibility.mjs","sources":["../../../projects/core/browser/page-visibility/index.ts","../../../projects/core/browser/page-visibility/signality-core-browser-page-visibility.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 type PageVisibilityOptions = CreateSignalOptions<DocumentVisibilityState> & WithInjector;\n\n/**\n * Signal-based wrapper around the [Page Visibility API](https://developer.mozilla.org/en-US/docs/Web/API/Page_Visibility_API).\n *\n * @param options - Optional configuration including signal options and injector\n * @returns A signal containing the current DocumentVisibilityState ('visible' or 'hidden')\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     @if (visibility() === 'hidden') {\n *       <p>Page is hidden</p>\n *     } @else {\n *       <p>Page is visible</p>\n *     }\n *   `\n * })\n * class VisibilityComponent {\n *   readonly visibility = pageVisibility();\n * }\n * ```\n */\nexport function pageVisibility(options?: PageVisibilityOptions): Signal<DocumentVisibilityState> {\n  const { runInContext } = setupContext(options?.injector, pageVisibility);\n\n  return runInContext(({ isServer }) => {\n    if (isServer) {\n      return constSignal('visible');\n    }\n\n    const visibilityState = signal(document.visibilityState, options);\n\n    setupSync(() => {\n      listener(document, 'visibilitychange', () => visibilityState.set(document.visibilityState));\n    });\n\n    return visibilityState.asReadonly();\n  });\n}\n\nexport const PAGE_VISIBILITY = /* @__PURE__ */ createToken(pageVisibility);\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAOA;;;;;;;;;;;;;;;;;;;;;AAqBG;AACG,SAAU,cAAc,CAAC,OAA+B,EAAA;AAC5D,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC;AAExE,IAAA,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAI;QACnC,IAAI,QAAQ,EAAE;AACZ,YAAA,OAAO,WAAW,CAAC,SAAS,CAAC;QAC/B;QAEA,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;QAEjE,SAAS,CAAC,MAAK;AACb,YAAA,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AAC7F,QAAA,CAAC,CAAC;AAEF,QAAA,OAAO,eAAe,CAAC,UAAU,EAAE;AACrC,IAAA,CAAC,CAAC;AACJ;AAEO,MAAM,eAAe,mBAAmB,WAAW,CAAC,cAAc;;AC/CzE;;AAEG;;;;"}

package/fesm2022/signality-core-browser-picture-in-picture.mjs

@@ -0,0 +1,93 @@
+import { signal, untracked } from '@angular/core';
+import { setupContext, constSignal, NOOP_ASYNC_FN, toElement, getPipElement } from '@signality/core/internal';
+import { listener } from '@signality/core/browser/listener';
+import { onDisconnect } from '@signality/core/elements/on-disconnect';
+
+/**
+ * Signal-based wrapper around the [Picture-in-Picture API](https://developer.mozilla.org/en-US/docs/Web/API/Picture-in-Picture_API).
+ *
+ * Automatically exits Picture-in-Picture when the target element is disconnected from the DOM.
+ *
+ * @param target - Video element
+ * @param options - Optional configuration
+ * @returns A {@link PictureInPictureRef} with `isSupported`, `isActive` signals and `enter`/`exit`/`toggle` methods
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     @if (pip.isSupported()) {
+ *       <video #video src="video.mp4"></video>
+ *       <button (click)="pip.toggle()">Toggle PiP</button>
+ *       <p>Active: {{ pip.isActive() }}</p>
+ *     }
+ *   `
+ * })
+ * class PiPComponent {
+ *   readonly video = viewChild<HTMLVideoElement>('video');
+ *   readonly pip = pictureInPicture(this.video);
+ * }
+ * ```
+ */
+function pictureInPicture(target, options) {
+    const { runInContext } = setupContext(options?.injector, pictureInPicture);
+    return runInContext(({ isBrowser }) => {
+        const isSupported = constSignal(isBrowser &&
+            'pictureInPictureEnabled' in document &&
+            document.pictureInPictureEnabled !== false);
+        if (!isSupported()) {
+            return {
+                isSupported,
+                isActive: constSignal(false),
+                enter: NOOP_ASYNC_FN,
+                exit: NOOP_ASYNC_FN,
+                toggle: NOOP_ASYNC_FN,
+            };
+        }
+        const isActive = signal(false, ...(ngDevMode ? [{ debugName: "isActive" }] : []));
+        const enter = async () => {
+            const el = toElement.untracked(target);
+            if (el) {
+                await el.requestPictureInPicture();
+            }
+        };
+        const exit = async () => {
+            const el = toElement.untracked(target);
+            const pipEl = getPipElement(document);
+            if (el && pipEl && el === pipEl) {
+                await document.exitPictureInPicture();
+            }
+        };
+        const toggle = async () => {
+            if (untracked(isActive)) {
+                await exit();
+            }
+            else {
+                await enter();
+            }
+        };
+        listener(target, 'enterpictureinpicture', () => isActive.set(true));
+        listener(target, 'leavepictureinpicture', () => isActive.set(false));
+        onDisconnect(target, async (el) => {
+            const pipEl = getPipElement(document);
+            if (pipEl && el === pipEl) {
+                await document.exitPictureInPicture();
+                isActive.set(false);
+            }
+        });
+        return {
+            isSupported,
+            isActive,
+            enter,
+            exit,
+            toggle,
+        };
+    });
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { pictureInPicture };
+//# sourceMappingURL=signality-core-browser-picture-in-picture.mjs.map

package/fesm2022/signality-core-browser-picture-in-picture.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-picture-in-picture.mjs","sources":["../../../projects/core/browser/picture-in-picture/index.ts","../../../projects/core/browser/picture-in-picture/signality-core-browser-picture-in-picture.ts"],"sourcesContent":["import { signal, type Signal, untracked } from '@angular/core';\nimport {\n  constSignal,\n  getPipElement,\n  NOOP_ASYNC_FN,\n  setupContext,\n  toElement,\n} from '@signality/core/internal';\nimport type { MaybeElementSignal, WithInjector } from '@signality/core/types';\nimport { listener } from '@signality/core/browser/listener';\nimport { onDisconnect } from '@signality/core/elements/on-disconnect';\n\nexport type PictureInPictureOptions = WithInjector;\n\nexport interface PictureInPictureRef {\n  /** Whether Picture-in-Picture API is supported */\n  readonly isSupported: Signal<boolean>;\n\n  /** Whether Picture-in-Picture is active */\n  readonly isActive: Signal<boolean>;\n\n  /** Enter Picture-in-Picture mode */\n  readonly enter: () => Promise<void>;\n\n  /** Exit Picture-in-Picture mode */\n  readonly exit: () => Promise<void>;\n\n  /** Toggle Picture-in-Picture mode */\n  readonly toggle: () => Promise<void>;\n}\n\n/**\n * Signal-based wrapper around the [Picture-in-Picture API](https://developer.mozilla.org/en-US/docs/Web/API/Picture-in-Picture_API).\n *\n * Automatically exits Picture-in-Picture when the target element is disconnected from the DOM.\n *\n * @param target - Video element\n * @param options - Optional configuration\n * @returns A {@link PictureInPictureRef} with `isSupported`, `isActive` signals and `enter`/`exit`/`toggle` methods\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     @if (pip.isSupported()) {\n *       <video #video src=\"video.mp4\"></video>\n *       <button (click)=\"pip.toggle()\">Toggle PiP</button>\n *       <p>Active: {{ pip.isActive() }}</p>\n *     }\n *   `\n * })\n * class PiPComponent {\n *   readonly video = viewChild<HTMLVideoElement>('video');\n *   readonly pip = pictureInPicture(this.video);\n * }\n * ```\n */\nexport function pictureInPicture(\n  target: MaybeElementSignal<HTMLVideoElement>,\n  options?: PictureInPictureOptions\n): PictureInPictureRef {\n  const { runInContext } = setupContext(options?.injector, pictureInPicture);\n\n  return runInContext(({ isBrowser }) => {\n    const isSupported = constSignal(\n      isBrowser &&\n        'pictureInPictureEnabled' in document &&\n        document.pictureInPictureEnabled !== false\n    );\n\n    if (!isSupported()) {\n      return {\n        isSupported,\n        isActive: constSignal(false),\n        enter: NOOP_ASYNC_FN,\n        exit: NOOP_ASYNC_FN,\n        toggle: NOOP_ASYNC_FN,\n      };\n    }\n\n    const isActive = signal(false);\n\n    const enter = async (): Promise<void> => {\n      const el = toElement.untracked(target);\n      if (el) {\n        await el.requestPictureInPicture();\n      }\n    };\n\n    const exit = async (): Promise<void> => {\n      const el = toElement.untracked(target);\n      const pipEl = getPipElement(document);\n\n      if (el && pipEl && el === pipEl) {\n        await document.exitPictureInPicture();\n      }\n    };\n\n    const toggle = async (): Promise<void> => {\n      if (untracked(isActive)) {\n        await exit();\n      } else {\n        await enter();\n      }\n    };\n\n    listener(target, 'enterpictureinpicture', () => isActive.set(true));\n    listener(target, 'leavepictureinpicture', () => isActive.set(false));\n\n    onDisconnect(target, async el => {\n      const pipEl = getPipElement(document);\n\n      if (pipEl && el === pipEl) {\n        await document.exitPictureInPicture();\n        isActive.set(false);\n      }\n    });\n\n    return {\n      isSupported,\n      isActive,\n      enter,\n      exit,\n      toggle,\n    };\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;AA+BA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;AACG,SAAU,gBAAgB,CAC9B,MAA4C,EAC5C,OAAiC,EAAA;AAEjC,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,CAAC;AAE1E,IAAA,OAAO,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,KAAI;AACpC,QAAA,MAAM,WAAW,GAAG,WAAW,CAC7B,SAAS;AACP,YAAA,yBAAyB,IAAI,QAAQ;AACrC,YAAA,QAAQ,CAAC,uBAAuB,KAAK,KAAK,CAC7C;AAED,QAAA,IAAI,CAAC,WAAW,EAAE,EAAE;YAClB,OAAO;gBACL,WAAW;AACX,gBAAA,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC;AAC5B,gBAAA,KAAK,EAAE,aAAa;AACpB,gBAAA,IAAI,EAAE,aAAa;AACnB,gBAAA,MAAM,EAAE,aAAa;aACtB;QACH;AAEA,QAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,oDAAC;AAE9B,QAAA,MAAM,KAAK,GAAG,YAA0B;YACtC,MAAM,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;YACtC,IAAI,EAAE,EAAE;AACN,gBAAA,MAAM,EAAE,CAAC,uBAAuB,EAAE;YACpC;AACF,QAAA,CAAC;AAED,QAAA,MAAM,IAAI,GAAG,YAA0B;YACrC,MAAM,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;AACtC,YAAA,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC;YAErC,IAAI,EAAE,IAAI,KAAK,IAAI,EAAE,KAAK,KAAK,EAAE;AAC/B,gBAAA,MAAM,QAAQ,CAAC,oBAAoB,EAAE;YACvC;AACF,QAAA,CAAC;AAED,QAAA,MAAM,MAAM,GAAG,YAA0B;AACvC,YAAA,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE;gBACvB,MAAM,IAAI,EAAE;YACd;iBAAO;gBACL,MAAM,KAAK,EAAE;YACf;AACF,QAAA,CAAC;AAED,QAAA,QAAQ,CAAC,MAAM,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACnE,QAAA,QAAQ,CAAC,MAAM,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAEpE,QAAA,YAAY,CAAC,MAAM,EAAE,OAAM,EAAE,KAAG;AAC9B,YAAA,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC;AAErC,YAAA,IAAI,KAAK,IAAI,EAAE,KAAK,KAAK,EAAE;AACzB,gBAAA,MAAM,QAAQ,CAAC,oBAAoB,EAAE;AACrC,gBAAA,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;YACrB;AACF,QAAA,CAAC,CAAC;QAEF,OAAO;YACL,WAAW;YACX,QAAQ;YACR,KAAK;YACL,IAAI;YACJ,MAAM;SACP;AACH,IAAA,CAAC,CAAC;AACJ;;AC9HA;;AAEG;;;;"}

package/fesm2022/signality-core-browser-pointer-lock-element.mjs

@@ -0,0 +1,43 @@
+import { signal } from '@angular/core';
+import { setupContext, constSignal } from '@signality/core/internal';
+import { setupSync, listener } from '@signality/core/browser/listener';
+
+/**
+ * Reactive wrapper around the [Pointer Lock API](https://developer.mozilla.org/en-US/docs/Web/API/Pointer_Lock_API).
+ * Returns a signal that tracks the element that currently has pointer lock.
+ *
+ * @param options - Optional configuration including signal options and injector
+ * @returns A signal containing the element with pointer lock, or `null` if no element has lock
+ *
+ * @example
+ * ```typescript
+ * const lockedElement = pointerLockElement();
+ *
+ * effect(() => {
+ *   if (lockedElement()) {
+ *     console.log('Pointer locked on:', lockedElement());
+ *   }
+ * });
+ * ```
+ */
+function pointerLockElement(options) {
+    const { runInContext } = setupContext(options?.injector, pointerLockElement);
+    return runInContext(({ isServer }) => {
+        if (isServer) {
+            return constSignal(null);
+        }
+        const element = signal(document.pointerLockElement, options);
+        setupSync(() => {
+            listener(document, 'pointerlockchange', () => element.set(document.pointerLockElement));
+            listener(document, 'pointerlockerror', () => element.set(null));
+        });
+        return element.asReadonly();
+    });
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { pointerLockElement };
+//# sourceMappingURL=signality-core-browser-pointer-lock-element.mjs.map

package/fesm2022/signality-core-browser-pointer-lock-element.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-pointer-lock-element.mjs","sources":["../../../projects/core/browser/pointer-lock-element/index.ts","../../../projects/core/browser/pointer-lock-element/signality-core-browser-pointer-lock-element.ts"],"sourcesContent":["import { type CreateSignalOptions, 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 PointerLockElementOptions = CreateSignalOptions<Element | null> & WithInjector;\n\n/**\n * Reactive wrapper around the [Pointer Lock API](https://developer.mozilla.org/en-US/docs/Web/API/Pointer_Lock_API).\n * Returns a signal that tracks the element that currently has pointer lock.\n *\n * @param options - Optional configuration including signal options and injector\n * @returns A signal containing the element with pointer lock, or `null` if no element has lock\n *\n * @example\n * ```typescript\n * const lockedElement = pointerLockElement();\n *\n * effect(() => {\n *   if (lockedElement()) {\n *     console.log('Pointer locked on:', lockedElement());\n *   }\n * });\n * ```\n */\nexport function pointerLockElement(options?: PointerLockElementOptions): Signal<Element | null> {\n  const { runInContext } = setupContext(options?.injector, pointerLockElement);\n\n  return runInContext(({ isServer }) => {\n    if (isServer) {\n      return constSignal(null);\n    }\n\n    const element = signal(document.pointerLockElement, options);\n\n    setupSync(() => {\n      listener(document, 'pointerlockchange', () => element.set(document.pointerLockElement));\n      listener(document, 'pointerlockerror', () => element.set(null));\n    });\n\n    return element.asReadonly();\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAOA;;;;;;;;;;;;;;;;;AAiBG;AACG,SAAU,kBAAkB,CAAC,OAAmC,EAAA;AACpE,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,kBAAkB,CAAC;AAE5E,IAAA,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAI;QACnC,IAAI,QAAQ,EAAE;AACZ,YAAA,OAAO,WAAW,CAAC,IAAI,CAAC;QAC1B;QAEA,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;QAE5D,SAAS,CAAC,MAAK;AACb,YAAA,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AACvF,YAAA,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACjE,QAAA,CAAC,CAAC;AAEF,QAAA,OAAO,OAAO,CAAC,UAAU,EAAE;AAC7B,IAAA,CAAC,CAAC;AACJ;;AC1CA;;AAEG;;;;"}

package/fesm2022/signality-core-browser-screen-orientation.mjs

@@ -0,0 +1,43 @@
+import { signal } from '@angular/core';
+import { setupContext, constSignal } from '@signality/core/internal';
+import { setupSync, listener } from '@signality/core/browser/listener';
+
+/**
+ * Reactive wrapper around the [Screen Orientation API](https://developer.mozilla.org/en-US/docs/Web/API/Screen_Orientation_API).
+ * Returns a signal that tracks the current screen orientation.
+ *
+ * @param options - Optional configuration including signal options and injector
+ * @returns A signal containing the current orientation type (`'portrait-primary'`, `'portrait-secondary'`, `'landscape-primary'`, or `'landscape-secondary'`)
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <p>Orientation: {{ orientation() }}</p>
+ *   `
+ * })
+ * class OrientationComponent {
+ *   readonly orientation = screenOrientation();
+ * }
+ * ```
+ */
+function screenOrientation(options) {
+    const { runInContext } = setupContext(options?.injector, screenOrientation);
+    return runInContext(({ isServer }) => {
+        if (isServer) {
+            return constSignal(options?.initialValue || 'portrait-primary');
+        }
+        const orientation = signal(screen.orientation.type, options);
+        setupSync(() => {
+            listener(screen.orientation, 'change', () => orientation.set(screen.orientation.type));
+        });
+        return orientation.asReadonly();
+    });
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { screenOrientation };
+//# sourceMappingURL=signality-core-browser-screen-orientation.mjs.map

package/fesm2022/signality-core-browser-screen-orientation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-screen-orientation.mjs","sources":["../../../projects/core/browser/screen-orientation/index.ts","../../../projects/core/browser/screen-orientation/signality-core-browser-screen-orientation.ts"],"sourcesContent":["import { type CreateSignalOptions, 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 interface ScreenOrientationOptions\n  extends CreateSignalOptions<OrientationType>,\n    WithInjector {\n  /**\n   * Initial value for SSR.\n   * @default 'portrait-primary'\n   */\n  readonly initialValue?: OrientationType;\n}\n\n/**\n * Reactive wrapper around the [Screen Orientation API](https://developer.mozilla.org/en-US/docs/Web/API/Screen_Orientation_API).\n * Returns a signal that tracks the current screen orientation.\n *\n * @param options - Optional configuration including signal options and injector\n * @returns A signal containing the current orientation type (`'portrait-primary'`, `'portrait-secondary'`, `'landscape-primary'`, or `'landscape-secondary'`)\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <p>Orientation: {{ orientation() }}</p>\n *   `\n * })\n * class OrientationComponent {\n *   readonly orientation = screenOrientation();\n * }\n * ```\n */\nexport function screenOrientation(options?: ScreenOrientationOptions): Signal<OrientationType> {\n  const { runInContext } = setupContext(options?.injector, screenOrientation);\n\n  return runInContext(({ isServer }) => {\n    if (isServer) {\n      return constSignal(options?.initialValue || 'portrait-primary');\n    }\n\n    const orientation = signal(screen.orientation.type, options);\n\n    setupSync(() => {\n      listener(screen.orientation, 'change', () => orientation.set(screen.orientation.type));\n    });\n\n    return orientation.asReadonly();\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAeA;;;;;;;;;;;;;;;;;;AAkBG;AACG,SAAU,iBAAiB,CAAC,OAAkC,EAAA;AAClE,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,iBAAiB,CAAC;AAE3E,IAAA,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAI;QACnC,IAAI,QAAQ,EAAE;YACZ,OAAO,WAAW,CAAC,OAAO,EAAE,YAAY,IAAI,kBAAkB,CAAC;QACjE;AAEA,QAAA,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC;QAE5D,SAAS,CAAC,MAAK;YACb,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AACxF,QAAA,CAAC,CAAC;AAEF,QAAA,OAAO,WAAW,CAAC,UAAU,EAAE;AACjC,IAAA,CAAC,CAAC;AACJ;;AClDA;;AAEG;;;;"}

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

@@ -0,0 +1,171 @@
+import { signal, untracked, isSignal } from '@angular/core';
+import { setupContext, constSignal, NOOP_FN, toValue } from '@signality/core/internal';
+import { watcher } from '@signality/core/reactivity/watcher';
+
+/**
+ * Signal-based wrapper around the [Speech Recognition API](https://developer.mozilla.org/en-US/docs/Web/API/SpeechRecognition).
+ *
+ * @param options - Optional configuration
+ * @returns A SpeechRecognitionRef with isSupported, isListening, text, interimText, error signals and control methods
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     @if (recognition.isSupported()) {
+ *       <button (click)="toggleRecognition()">
+ *         {{ recognition.isListening() ? 'Stop' : 'Start' }} Recording
+ *       </button>
+ *       <p>{{ recognition.text() }}</p>
+ *       @if (recognition.interimText()) {
+ *         <p><em>{{ recognition.interimText() }}</em></p>
+ *       }
+ *     }
+ *   `
+ * })
+ * class SpeechComponent {
+ *   readonly recognition = speechRecognition();
+ *
+ *   toggleRecognition() {
+ *     if (this.recognition.isListening()) {
+ *       this.recognition.stop();
+ *     } else {
+ *       this.recognition.start();
+ *     }
+ *   }
+ * }
+ * ```
+ */
+function speechRecognition(options) {
+    const { runInContext } = setupContext(options?.injector, speechRecognition);
+    return runInContext(({ isBrowser, onCleanup }) => {
+        const isSupported = constSignal(isBrowser && ('SpeechRecognition' in window || 'webkitSpeechRecognition' in window));
+        if (!isSupported()) {
+            return {
+                isSupported,
+                isListening: constSignal(false),
+                text: constSignal(''),
+                interimText: constSignal(''),
+                error: constSignal(null),
+                start: NOOP_FN,
+                stop: NOOP_FN,
+                abort: NOOP_FN,
+            };
+        }
+        const SpeechRecognitionClass = window.SpeechRecognition || window.webkitSpeechRecognition;
+        const recognition = new SpeechRecognitionClass();
+        const abortController = new AbortController();
+        const { lang = 'en-US', interimResults = false, continuous = false, maxAlternatives = 1, } = options ?? {};
+        recognition.lang = toValue(lang);
+        recognition.continuous = continuous;
+        recognition.interimResults = interimResults;
+        recognition.maxAlternatives = maxAlternatives;
+        const isListening = signal(false, ...(ngDevMode ? [{ debugName: "isListening" }] : []));
+        const text = signal('', ...(ngDevMode ? [{ debugName: "text" }] : []));
+        const interimText = signal('', ...(ngDevMode ? [{ debugName: "interimText" }] : []));
+        const error = signal(null, ...(ngDevMode ? [{ debugName: "error" }] : []));
+        const handleResult = (event) => {
+            let finalTranscript = '';
+            let interimTranscript = '';
+            for (let i = event.resultIndex; i < event.results.length; i++) {
+                const result = event.results[i];
+                const transcript = result[0]?.transcript || result.item(0)?.transcript || '';
+                if (result.isFinal) {
+                    finalTranscript += transcript;
+                }
+                else {
+                    interimTranscript += transcript;
+                }
+            }
+            if (finalTranscript) {
+                text.update(t => (t ? t + ' ' : '') + finalTranscript);
+                interimText.set('');
+            }
+            else if (interimTranscript) {
+                interimText.set(interimTranscript);
+            }
+        };
+        const handleError = (event) => {
+            error.set(event);
+            isListening.set(false);
+        };
+        const handleStart = () => {
+            isListening.set(true);
+            error.set(null);
+            if (!continuous) {
+                text.set('');
+                interimText.set('');
+            }
+        };
+        const handleEnd = () => {
+            isListening.set(false);
+            recognition.lang = toValue(lang);
+        };
+        recognition.onstart = handleStart;
+        recognition.onend = handleEnd;
+        recognition.onerror = handleError;
+        recognition.onresult = handleResult;
+        const start = () => {
+            try {
+                if (!untracked(isListening)) {
+                    recognition.start();
+                }
+            }
+            catch (err) {
+                error.set(err);
+            }
+        };
+        const stop = () => {
+            if (untracked(isListening)) {
+                recognition.stop();
+            }
+        };
+        const abort = () => {
+            if (untracked(isListening)) {
+                recognition.abort();
+            }
+        };
+        onCleanup(() => {
+            abortController.abort();
+            abort();
+        });
+        if (isSignal(lang)) {
+            watcher(lang, newLang => {
+                if (!isListening()) {
+                    recognition.lang = newLang;
+                }
+            });
+        }
+        navigator.permissions.query({ name: 'microphone' }).then(result => {
+            if (abortController.signal.aborted) {
+                return;
+            }
+            const check = () => {
+                if (result.state === 'denied') {
+                    abort();
+                }
+            };
+            check();
+            result.addEventListener('change', check, {
+                signal: abortController.signal,
+            });
+        });
+        return {
+            isSupported,
+            isListening: isListening.asReadonly(),
+            text: text.asReadonly(),
+            interimText: interimText.asReadonly(),
+            error: error.asReadonly(),
+            start,
+            stop,
+            abort,
+        };
+    });
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { speechRecognition };
+//# sourceMappingURL=signality-core-browser-speech-recognition.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-speech-recognition.mjs","sources":["../../../projects/core/browser/speech-recognition/index.ts","../../../projects/core/browser/speech-recognition/signality-core-browser-speech-recognition.ts"],"sourcesContent":["import { isSignal, type Signal, signal, untracked } from '@angular/core';\nimport { constSignal, NOOP_FN, setupContext, toValue } from '@signality/core/internal';\nimport type { MaybeSignal, WithInjector } from '@signality/core/types';\nimport { watcher } from '@signality/core/reactivity/watcher';\n\nexport interface SpeechRecognitionOptions extends WithInjector {\n  /**\n   * Language for speech recognition.\n   * @default 'en-US'\n   */\n  readonly lang?: MaybeSignal<string>;\n\n  /**\n   * Whether to return interim results.\n   * @default false\n   */\n  readonly interimResults?: boolean;\n\n  /**\n   * Whether to continue recognition after speech ends.\n   * @default false\n   */\n  readonly continuous?: boolean;\n\n  /**\n   * Maximum number of alternative transcripts.\n   * @default 1\n   */\n  readonly maxAlternatives?: number;\n}\n\nexport interface SpeechRecognitionRef {\n  /** Whether Speech Recognition API is supported */\n  readonly isSupported: Signal<boolean>;\n\n  /** Whether recognition is currently active */\n  readonly isListening: Signal<boolean>;\n\n  /** Final transcript text */\n  readonly text: Signal<string>;\n\n  /** Interim transcript text */\n  readonly interimText: Signal<string>;\n\n  /** Error if recognition failed */\n  readonly error: Signal<SpeechRecognitionErrorEvent | Error | null>;\n\n  /** Start speech recognition */\n  readonly start: () => void;\n\n  /** Stop speech recognition */\n  readonly stop: () => void;\n\n  /** Abort speech recognition */\n  readonly abort: () => void;\n}\n\n/**\n * Signal-based wrapper around the [Speech Recognition API](https://developer.mozilla.org/en-US/docs/Web/API/SpeechRecognition).\n *\n * @param options - Optional configuration\n * @returns A SpeechRecognitionRef with isSupported, isListening, text, interimText, error signals and control methods\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     @if (recognition.isSupported()) {\n *       <button (click)=\"toggleRecognition()\">\n *         {{ recognition.isListening() ? 'Stop' : 'Start' }} Recording\n *       </button>\n *       <p>{{ recognition.text() }}</p>\n *       @if (recognition.interimText()) {\n *         <p><em>{{ recognition.interimText() }}</em></p>\n *       }\n *     }\n *   `\n * })\n * class SpeechComponent {\n *   readonly recognition = speechRecognition();\n *\n *   toggleRecognition() {\n *     if (this.recognition.isListening()) {\n *       this.recognition.stop();\n *     } else {\n *       this.recognition.start();\n *     }\n *   }\n * }\n * ```\n */\nexport function speechRecognition(options?: SpeechRecognitionOptions): SpeechRecognitionRef {\n  const { runInContext } = setupContext(options?.injector, speechRecognition);\n\n  return runInContext(({ isBrowser, onCleanup }) => {\n    const isSupported = constSignal(\n      isBrowser && ('SpeechRecognition' in window || 'webkitSpeechRecognition' in window)\n    );\n\n    if (!isSupported()) {\n      return {\n        isSupported,\n        isListening: constSignal(false),\n        text: constSignal(''),\n        interimText: constSignal(''),\n        error: constSignal(null),\n        start: NOOP_FN,\n        stop: NOOP_FN,\n        abort: NOOP_FN,\n      };\n    }\n\n    const SpeechRecognitionClass = window.SpeechRecognition || window.webkitSpeechRecognition;\n\n    const recognition = new SpeechRecognitionClass();\n    const abortController = new AbortController();\n\n    const {\n      lang = 'en-US',\n      interimResults = false,\n      continuous = false,\n      maxAlternatives = 1,\n    } = options ?? {};\n\n    recognition.lang = toValue(lang);\n    recognition.continuous = continuous;\n    recognition.interimResults = interimResults;\n    recognition.maxAlternatives = maxAlternatives;\n\n    const isListening = signal(false);\n    const text = signal('');\n    const interimText = signal('');\n    const error = signal<SpeechRecognitionErrorEvent | Error | null>(null);\n\n    const handleResult = (event: SpeechRecognitionEvent) => {\n      let finalTranscript = '';\n      let interimTranscript = '';\n\n      for (let i = event.resultIndex; i < event.results.length; i++) {\n        const result = event.results[i];\n        const transcript = result[0]?.transcript || result.item(0)?.transcript || '';\n\n        if (result.isFinal) {\n          finalTranscript += transcript;\n        } else {\n          interimTranscript += transcript;\n        }\n      }\n\n      if (finalTranscript) {\n        text.update(t => (t ? t + ' ' : '') + finalTranscript);\n        interimText.set('');\n      } else if (interimTranscript) {\n        interimText.set(interimTranscript);\n      }\n    };\n\n    const handleError = (event: SpeechRecognitionErrorEvent) => {\n      error.set(event);\n      isListening.set(false);\n    };\n\n    const handleStart = () => {\n      isListening.set(true);\n      error.set(null);\n\n      if (!continuous) {\n        text.set('');\n        interimText.set('');\n      }\n    };\n\n    const handleEnd = () => {\n      isListening.set(false);\n      recognition.lang = toValue(lang);\n    };\n\n    recognition.onstart = handleStart;\n    recognition.onend = handleEnd;\n    recognition.onerror = handleError;\n    recognition.onresult = handleResult;\n\n    const start = () => {\n      try {\n        if (!untracked(isListening)) {\n          recognition.start();\n        }\n      } catch (err) {\n        error.set(err as Error);\n      }\n    };\n\n    const stop = () => {\n      if (untracked(isListening)) {\n        recognition.stop();\n      }\n    };\n\n    const abort = () => {\n      if (untracked(isListening)) {\n        recognition.abort();\n      }\n    };\n\n    onCleanup(() => {\n      abortController.abort();\n      abort();\n    });\n\n    if (isSignal(lang)) {\n      watcher(lang, newLang => {\n        if (!isListening()) {\n          recognition.lang = newLang;\n        }\n      });\n    }\n\n    navigator.permissions.query({ name: 'microphone' }).then(result => {\n      if (abortController.signal.aborted) {\n        return;\n      }\n\n      const check = () => {\n        if (result.state === 'denied') {\n          abort();\n        }\n      };\n\n      check();\n\n      result.addEventListener('change', check, {\n        signal: abortController.signal,\n      });\n    });\n\n    return {\n      isSupported,\n      isListening: isListening.asReadonly(),\n      text: text.asReadonly(),\n      interimText: interimText.asReadonly(),\n      error: error.asReadonly(),\n      start,\n      stop,\n      abort,\n    };\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}