@signality/core 0.0.1-alpha.2

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

@@ -0,0 +1,103 @@
+import { signal, untracked } from '@angular/core';
+import { setupContext, NOOP_FN, constSignal, createToken } from '@signality/core/internal';
+
+/**
+ * Reactive FPS monitor using requestAnimationFrame.
+ *
+ * @param options - Configuration options
+ * @returns An FpsRef with fps signal and control methods
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <p>FPS: {{ fpsMonitor.fps() }}</p>
+ *     <button (click)="fpsMonitor.stop()">Stop</button>
+ *     <button (click)="fpsMonitor.start()">Start</button>
+ *   `
+ * })
+ * class FpsComponent {
+ *   readonly fpsMonitor = fps();
+ * }
+ * ```
+ */
+function fps(options) {
+    const { runInContext } = setupContext(options?.injector, fps);
+    return runInContext(({ isServer, onCleanup }) => {
+        if (isServer) {
+            return {
+                fps: constSignal(0),
+                isRunning: constSignal(false),
+                start: NOOP_FN,
+                stop: NOOP_FN,
+            };
+        }
+        const immediate = options?.immediate ?? true;
+        const sampleSize = options?.sampleSize ?? 60;
+        const fpsValue = signal(0, ...(ngDevMode ? [{ debugName: "fpsValue" }] : []));
+        const isRunning = signal(false, ...(ngDevMode ? [{ debugName: "isRunning" }] : []));
+        let frameId;
+        let lastTime = performance.now();
+        let frameCount = 0;
+        let frameTimes = [];
+        const loop = (currentTime) => {
+            const delta = currentTime - lastTime;
+            lastTime = currentTime;
+            if (delta > 0) {
+                frameTimes.push(1000 / delta);
+                if (frameTimes.length > sampleSize) {
+                    frameTimes.shift();
+                }
+                frameCount++;
+                if (frameCount >= 10) {
+                    const avgFps = frameTimes.reduce((a, b) => a + b, 0) / frameTimes.length;
+                    fpsValue.set(Math.round(avgFps));
+                    frameCount = 0;
+                }
+            }
+            if (untracked(isRunning)) {
+                frameId = requestAnimationFrame(loop);
+            }
+        };
+        const start = () => {
+            const running = untracked(isRunning);
+            if (running) {
+                return;
+            }
+            isRunning.set(true);
+            lastTime = performance.now();
+            frameCount = 0;
+            frameTimes = [];
+            frameId = requestAnimationFrame(loop);
+        };
+        const stop = () => {
+            const running = untracked(isRunning);
+            if (!running) {
+                return;
+            }
+            isRunning.set(false);
+            if (frameId !== undefined) {
+                cancelAnimationFrame(frameId);
+                frameId = undefined;
+            }
+        };
+        if (immediate) {
+            start();
+        }
+        onCleanup(stop);
+        return {
+            fps: fpsValue.asReadonly(),
+            isRunning: isRunning.asReadonly(),
+            start,
+            stop,
+        };
+    });
+}
+const FPS = /* @__PURE__ */ createToken(fps);
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { FPS, fps };
+//# sourceMappingURL=signality-core-browser-fps.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-fps.mjs","sources":["../../../projects/core/browser/fps/index.ts","../../../projects/core/browser/fps/signality-core-browser-fps.ts"],"sourcesContent":["import { type Signal, signal, untracked } from '@angular/core';\nimport { constSignal, createToken, NOOP_FN, setupContext } from '@signality/core/internal';\nimport type { WithInjector } from '@signality/core/types';\n\nexport interface FpsOptions extends WithInjector {\n  /**\n   * Start monitoring immediately.\n   * @default true\n   */\n  readonly immediate?: boolean;\n\n  /**\n   * Number of frames to average.\n   * @default 60\n   */\n  readonly sampleSize?: number;\n}\n\nexport interface FpsRef {\n  /** Current frames per second */\n  readonly fps: Signal<number>;\n\n  /** Whether monitoring is active */\n  readonly isRunning: Signal<boolean>;\n\n  /** Start FPS monitoring */\n  readonly start: () => void;\n\n  /** Stop FPS monitoring */\n  readonly stop: () => void;\n}\n\n/**\n * Reactive FPS monitor using requestAnimationFrame.\n *\n * @param options - Configuration options\n * @returns An FpsRef with fps signal and control methods\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <p>FPS: {{ fpsMonitor.fps() }}</p>\n *     <button (click)=\"fpsMonitor.stop()\">Stop</button>\n *     <button (click)=\"fpsMonitor.start()\">Start</button>\n *   `\n * })\n * class FpsComponent {\n *   readonly fpsMonitor = fps();\n * }\n * ```\n */\nexport function fps(options?: FpsOptions): FpsRef {\n  const { runInContext } = setupContext(options?.injector, fps);\n\n  return runInContext(({ isServer, onCleanup }) => {\n    if (isServer) {\n      return {\n        fps: constSignal(0),\n        isRunning: constSignal(false),\n        start: NOOP_FN,\n        stop: NOOP_FN,\n      };\n    }\n\n    const immediate = options?.immediate ?? true;\n    const sampleSize = options?.sampleSize ?? 60;\n\n    const fpsValue = signal(0);\n    const isRunning = signal(false);\n\n    let frameId: number | undefined;\n    let lastTime = performance.now();\n    let frameCount = 0;\n    let frameTimes: number[] = [];\n\n    const loop = (currentTime: number) => {\n      const delta = currentTime - lastTime;\n      lastTime = currentTime;\n\n      if (delta > 0) {\n        frameTimes.push(1000 / delta);\n\n        if (frameTimes.length > sampleSize) {\n          frameTimes.shift();\n        }\n\n        frameCount++;\n\n        if (frameCount >= 10) {\n          const avgFps = frameTimes.reduce((a, b) => a + b, 0) / frameTimes.length;\n          fpsValue.set(Math.round(avgFps));\n          frameCount = 0;\n        }\n      }\n\n      if (untracked(isRunning)) {\n        frameId = requestAnimationFrame(loop);\n      }\n    };\n\n    const start = () => {\n      const running = untracked(isRunning);\n\n      if (running) {\n        return;\n      }\n\n      isRunning.set(true);\n      lastTime = performance.now();\n      frameCount = 0;\n      frameTimes = [];\n      frameId = requestAnimationFrame(loop);\n    };\n\n    const stop = () => {\n      const running = untracked(isRunning);\n\n      if (!running) {\n        return;\n      }\n\n      isRunning.set(false);\n\n      if (frameId !== undefined) {\n        cancelAnimationFrame(frameId);\n        frameId = undefined;\n      }\n    };\n\n    if (immediate) {\n      start();\n    }\n\n    onCleanup(stop);\n\n    return {\n      fps: fpsValue.asReadonly(),\n      isRunning: isRunning.asReadonly(),\n      start,\n      stop,\n    };\n  });\n}\n\nexport const FPS = /* @__PURE__ */ createToken(fps);\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-gamepad.mjs

@@ -0,0 +1,93 @@
+import { signal, computed } from '@angular/core';
+import { setupContext, constSignal } from '@signality/core/internal';
+import { setupSync, listener } from '@signality/core/browser/listener';
+
+/**
+ * Signal-based wrapper around the Gamepad API.
+ *
+ * @param options - Optional injector for DI context
+ * @returns A GamepadRef with gamepad state signals
+ *
+ * @example
+ * ```typescript
+ * const gp = gamepad();
+ *
+ * // In template: @for (pad of gp.gamepads(); track pad?.index) { ... }
+ * ```
+ */
+function gamepad(options) {
+    const { runInContext } = setupContext(options?.injector, gamepad);
+    return runInContext(({ onCleanup, isBrowser }) => {
+        const isSupported = constSignal(isBrowser && 'getGamepads' in navigator);
+        if (!isSupported()) {
+            return {
+                isSupported,
+                gamepads: constSignal([]),
+                activeGamepad: constSignal(undefined),
+                axes: constSignal([]),
+                buttons: constSignal([]),
+            };
+        }
+        const getGamepads = () => {
+            try {
+                const pads = navigator.getGamepads();
+                return [...pads];
+            }
+            catch (error) {
+                if (ngDevMode) {
+                    console.warn(`[gamepad] Failed to get gamepads.`, error);
+                }
+                return [];
+            }
+        };
+        const gamepads = signal(getGamepads(), ...(ngDevMode ? [{ debugName: "gamepads" }] : []));
+        const activeGamepad = computed(() => gamepads().find(gp => gp !== null) ?? undefined, ...(ngDevMode ? [{ debugName: "activeGamepad" }] : []));
+        const axes = computed(() => activeGamepad()?.axes ?? [], ...(ngDevMode ? [{ debugName: "axes" }] : []));
+        const buttons = computed(() => activeGamepad()?.buttons ?? [], ...(ngDevMode ? [{ debugName: "buttons" }] : []));
+        let animationFrameId = null;
+        const pollGamepads = () => {
+            gamepads.set(getGamepads());
+            animationFrameId = requestAnimationFrame(pollGamepads);
+        };
+        const onGamepadConnected = () => {
+            gamepads.set(getGamepads());
+            if (animationFrameId === null) {
+                pollGamepads();
+            }
+        };
+        const onGamepadDisconnected = () => {
+            gamepads.set(getGamepads());
+            const hasGamepads = gamepads().some(gp => gp !== null);
+            if (!hasGamepads && animationFrameId !== null) {
+                cancelAnimationFrame(animationFrameId);
+                animationFrameId = null;
+            }
+        };
+        setupSync(() => {
+            listener.passive(window, 'gamepadconnected', onGamepadConnected);
+            listener.passive(window, 'gamepaddisconnected', onGamepadDisconnected);
+        });
+        if (gamepads().some(gp => gp !== null)) {
+            pollGamepads();
+        }
+        onCleanup(() => {
+            if (animationFrameId !== null) {
+                cancelAnimationFrame(animationFrameId);
+            }
+        });
+        return {
+            isSupported,
+            gamepads: gamepads.asReadonly(),
+            activeGamepad,
+            axes,
+            buttons,
+        };
+    });
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { gamepad };
+//# sourceMappingURL=signality-core-browser-gamepad.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-gamepad.mjs","sources":["../../../projects/core/browser/gamepad/index.ts","../../../projects/core/browser/gamepad/signality-core-browser-gamepad.ts"],"sourcesContent":["import { computed, signal, type 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 GamepadRef {\n  /** Whether Gamepad API is supported */\n  readonly isSupported: Signal<boolean>;\n\n  /** Array of connected gamepads */\n  readonly gamepads: Signal<(Gamepad | null)[]>;\n\n  /** First connected gamepad */\n  readonly activeGamepad: Signal<Gamepad | undefined>;\n\n  /** Axes values of active gamepad */\n  readonly axes: Signal<readonly number[]>;\n\n  /** Button states of active gamepad */\n  readonly buttons: Signal<readonly GamepadButton[]>;\n}\n\n/**\n * Signal-based wrapper around the Gamepad API.\n *\n * @param options - Optional injector for DI context\n * @returns A GamepadRef with gamepad state signals\n *\n * @example\n * ```typescript\n * const gp = gamepad();\n *\n * // In template: @for (pad of gp.gamepads(); track pad?.index) { ... }\n * ```\n */\nexport function gamepad(options?: WithInjector): GamepadRef {\n  const { runInContext } = setupContext(options?.injector, gamepad);\n\n  return runInContext(({ onCleanup, isBrowser }) => {\n    const isSupported = constSignal(isBrowser && 'getGamepads' in navigator);\n\n    if (!isSupported()) {\n      return {\n        isSupported,\n        gamepads: constSignal([]),\n        activeGamepad: constSignal(undefined),\n        axes: constSignal([]),\n        buttons: constSignal([]),\n      };\n    }\n\n    const getGamepads = () => {\n      try {\n        const pads = navigator.getGamepads();\n        return [...pads];\n      } catch (error) {\n        if (ngDevMode) {\n          console.warn(`[gamepad] Failed to get gamepads.`, error);\n        }\n        return [];\n      }\n    };\n\n    const gamepads = signal<(Gamepad | null)[]>(getGamepads());\n    const activeGamepad = computed(() => gamepads().find(gp => gp !== null) ?? undefined);\n    const axes = computed(() => activeGamepad()?.axes ?? []);\n    const buttons = computed(() => activeGamepad()?.buttons ?? []);\n\n    let animationFrameId: number | null = null;\n\n    const pollGamepads = () => {\n      gamepads.set(getGamepads());\n      animationFrameId = requestAnimationFrame(pollGamepads);\n    };\n\n    const onGamepadConnected = () => {\n      gamepads.set(getGamepads());\n\n      if (animationFrameId === null) {\n        pollGamepads();\n      }\n    };\n\n    const onGamepadDisconnected = () => {\n      gamepads.set(getGamepads());\n\n      const hasGamepads = gamepads().some(gp => gp !== null);\n\n      if (!hasGamepads && animationFrameId !== null) {\n        cancelAnimationFrame(animationFrameId);\n        animationFrameId = null;\n      }\n    };\n\n    setupSync(() => {\n      listener.passive(window, 'gamepadconnected', onGamepadConnected);\n      listener.passive(window, 'gamepaddisconnected', onGamepadDisconnected);\n    });\n\n    if (gamepads().some(gp => gp !== null)) {\n      pollGamepads();\n    }\n\n    onCleanup(() => {\n      if (animationFrameId !== null) {\n        cancelAnimationFrame(animationFrameId);\n      }\n    });\n\n    return {\n      isSupported,\n      gamepads: gamepads.asReadonly(),\n      activeGamepad,\n      axes,\n      buttons,\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-geolocation.mjs

@@ -0,0 +1,120 @@
+import { signal, untracked, computed } from '@angular/core';
+import { setupContext, constSignal, NOOP_FN } from '@signality/core/internal';
+
+/**
+ * Signal-based wrapper around the [Geolocation API](https://developer.mozilla.org/en-US/docs/Web/API/Geolocation_API).
+ *
+ * @param options - Configuration options
+ * @returns A GeolocationRef with location signals and control methods
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     @if (geo.isLoading()) {
+ *       <p>Getting your location...</p>
+ *     } @else if (geo.position()?.coords; as coords) {
+ *       <p>{{ coords.latitude }}, {{ coords.longitude }}</p>
+ *     }
+ *     <button (click)="geo.stop()">Stop</button>
+ *     <button (click)="geo.start()">Start</button>
+ * })
+ * class LocationComponent {
+ *   readonly geo = geolocation();
+ * }
+ * ```
+ */
+function geolocation(options) {
+    const { runInContext } = setupContext(options?.injector, geolocation);
+    return runInContext(({ isBrowser, onCleanup }) => {
+        const isSupported = constSignal(isBrowser && 'geolocation' in navigator);
+        if (!isSupported()) {
+            return {
+                isSupported,
+                position: constSignal(null),
+                error: constSignal(null),
+                isLoading: constSignal(false),
+                isActive: constSignal(false),
+                start: NOOP_FN,
+                stop: NOOP_FN,
+            };
+        }
+        const immediate = options?.immediate ?? true;
+        const positionOptions = {
+            enableHighAccuracy: options?.enableHighAccuracy ?? true,
+            maximumAge: options?.maximumAge ?? 0,
+            timeout: options?.timeout ?? Infinity,
+        };
+        const position = signal(null, ...(ngDevMode ? [{ debugName: "position" }] : []));
+        const error = signal(null, ...(ngDevMode ? [{ debugName: "error" }] : []));
+        const isLoading = signal(false, ...(ngDevMode ? [{ debugName: "isLoading" }] : []));
+        const watchId = signal(undefined, ...(ngDevMode ? [{ debugName: "watchId" }] : []));
+        const handleSuccess = (pos) => {
+            position.set(pos);
+            error.set(null);
+            isLoading.set(false);
+        };
+        const handleError = (err) => {
+            error.set(err);
+            isLoading.set(false);
+        };
+        const start = () => {
+            untracked(() => {
+                if (watchId() !== undefined) {
+                    return;
+                }
+                isLoading.set(true);
+                const id = navigator.geolocation.watchPosition(handleSuccess, handleError, positionOptions);
+                watchId.set(id);
+            });
+        };
+        const stop = () => {
+            untracked(() => {
+                const currentId = watchId();
+                if (currentId !== undefined) {
+                    navigator.geolocation.clearWatch(currentId);
+                    watchId.set(undefined);
+                }
+                isLoading.set(false);
+            });
+        };
+        const abortController = new AbortController();
+        onCleanup(() => {
+            abortController.abort();
+            stop();
+        });
+        navigator.permissions.query({ name: 'geolocation' }).then(status => {
+            if (abortController.signal.aborted) {
+                return;
+            }
+            const check = () => {
+                if (status.state === 'denied') {
+                    stop();
+                }
+            };
+            check();
+            status.addEventListener('change', check, {
+                signal: abortController.signal,
+            });
+        });
+        if (immediate) {
+            start();
+        }
+        return {
+            isSupported,
+            position: position.asReadonly(),
+            error: error.asReadonly(),
+            isLoading: isLoading.asReadonly(),
+            isActive: computed(() => watchId() !== undefined),
+            start,
+            stop,
+        };
+    });
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { geolocation };
+//# sourceMappingURL=signality-core-browser-geolocation.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-geolocation.mjs","sources":["../../../projects/core/browser/geolocation/index.ts","../../../projects/core/browser/geolocation/signality-core-browser-geolocation.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';\n\nexport interface GeolocationOptions extends WithInjector {\n  /**\n   * Start tracking immediately.\n   * @default true\n   */\n  readonly immediate?: boolean;\n\n  /**\n   * Use GPS for better accuracy.\n   * @default true\n   */\n  readonly enableHighAccuracy?: boolean;\n\n  /**\n   * Max age of cached position (ms).\n   * @default 0\n   */\n  readonly maximumAge?: number;\n\n  /**\n   * Request timeout (ms).\n   * @default Infinity\n   */\n  readonly timeout?: number;\n}\n\nexport interface GeolocationRef {\n  /** Whether Geolocation is supported */\n  readonly isSupported: Signal<boolean>;\n\n  /** Full position object with timestamp */\n  readonly position: Signal<GeolocationPosition | null>;\n\n  /** Last error */\n  readonly error: Signal<GeolocationPositionError | null>;\n\n  /** Whether location tracking is currently active */\n  readonly isActive: Signal<boolean>;\n\n  /** Whether currently fetching location */\n  readonly isLoading: Signal<boolean>;\n\n  /** Start/resume watching position */\n  readonly start: () => void;\n\n  /** Stop watching position */\n  readonly stop: () => void;\n}\n\n/**\n * Signal-based wrapper around the [Geolocation API](https://developer.mozilla.org/en-US/docs/Web/API/Geolocation_API).\n *\n * @param options - Configuration options\n * @returns A GeolocationRef with location signals and control methods\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     @if (geo.isLoading()) {\n *       <p>Getting your location...</p>\n *     } @else if (geo.position()?.coords; as coords) {\n *       <p>{{ coords.latitude }}, {{ coords.longitude }}</p>\n *     }\n *     <button (click)=\"geo.stop()\">Stop</button>\n *     <button (click)=\"geo.start()\">Start</button>\n * })\n * class LocationComponent {\n *   readonly geo = geolocation();\n * }\n * ```\n */\nexport function geolocation(options?: GeolocationOptions): GeolocationRef {\n  const { runInContext } = setupContext(options?.injector, geolocation);\n\n  return runInContext(({ isBrowser, onCleanup }) => {\n    const isSupported = constSignal(isBrowser && 'geolocation' in navigator);\n\n    if (!isSupported()) {\n      return {\n        isSupported,\n        position: constSignal(null),\n        error: constSignal(null),\n        isLoading: constSignal(false),\n        isActive: constSignal(false),\n        start: NOOP_FN,\n        stop: NOOP_FN,\n      };\n    }\n\n    const immediate = options?.immediate ?? true;\n\n    const positionOptions: PositionOptions = {\n      enableHighAccuracy: options?.enableHighAccuracy ?? true,\n      maximumAge: options?.maximumAge ?? 0,\n      timeout: options?.timeout ?? Infinity,\n    };\n\n    const position = signal<GeolocationPosition | null>(null);\n    const error = signal<GeolocationPositionError | null>(null);\n    const isLoading = signal(false);\n    const watchId = signal<number | undefined>(undefined);\n\n    const handleSuccess = (pos: GeolocationPosition) => {\n      position.set(pos);\n      error.set(null);\n      isLoading.set(false);\n    };\n\n    const handleError = (err: GeolocationPositionError) => {\n      error.set(err);\n      isLoading.set(false);\n    };\n\n    const start = () => {\n      untracked(() => {\n        if (watchId() !== undefined) {\n          return;\n        }\n\n        isLoading.set(true);\n        const id = navigator.geolocation.watchPosition(handleSuccess, handleError, positionOptions);\n        watchId.set(id);\n      });\n    };\n\n    const stop = () => {\n      untracked(() => {\n        const currentId = watchId();\n\n        if (currentId !== undefined) {\n          navigator.geolocation.clearWatch(currentId);\n          watchId.set(undefined);\n        }\n\n        isLoading.set(false);\n      });\n    };\n\n    const abortController = new AbortController();\n\n    onCleanup(() => {\n      abortController.abort();\n      stop();\n    });\n\n    navigator.permissions.query({ name: 'geolocation' }).then(status => {\n      if (abortController.signal.aborted) {\n        return;\n      }\n\n      const check = () => {\n        if (status.state === 'denied') {\n          stop();\n        }\n      };\n\n      check();\n\n      status.addEventListener('change', check, {\n        signal: abortController.signal,\n      });\n    });\n\n    if (immediate) {\n      start();\n    }\n\n    return {\n      isSupported,\n      position: position.asReadonly(),\n      error: error.asReadonly(),\n      isLoading: isLoading.asReadonly(),\n      isActive: computed(() => watchId() !== undefined),\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-input-modality.mjs

@@ -0,0 +1,64 @@
+import { signal } from '@angular/core';
+import { setupContext, constSignal, createToken } from '@signality/core/internal';
+import { setupSync, listener } from '@signality/core/browser/listener';
+
+const TOUCH_BUFFER_MS = 650;
+const MODIFIER_KEYS = ['Shift', 'Control', 'Alt', 'Meta', 'ContextMenu'];
+/**
+ * Reactively track the user's current input method (keyboard, mouse, or touch).
+ *
+ * @param options - Optional configuration including injector
+ * @returns A signal containing the current input modality: `'keyboard'`, `'mouse'`, `'touch'`, or `null`
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <div [class.keyboard]="modality() === 'keyboard'">
+ *       <p>Current input: {{ modality() ?? 'none' }}</p>
+ *       <button>Button with conditional focus ring</button>
+ *     </div>
+ *   `
+ * })
+ * export class ModalityComponent {
+ *   readonly modality = inputModality();
+ * }
+ * ```
+ */
+function inputModality(options) {
+    const { runInContext } = setupContext(options?.injector, inputModality);
+    return runInContext(({ isServer }) => {
+        if (isServer) {
+            return constSignal(null);
+        }
+        const modality = signal(null, ...(ngDevMode ? [{ debugName: "modality" }] : []));
+        let lastTouchMs = 0;
+        setupSync(() => {
+            listener(document, 'keydown', (event) => {
+                if (MODIFIER_KEYS.includes(event.key)) {
+                    return;
+                }
+                modality.set('keyboard');
+            });
+            listener(document, 'mousedown', () => {
+                if (Date.now() - lastTouchMs < TOUCH_BUFFER_MS) {
+                    return;
+                }
+                modality.set('mouse');
+            });
+            listener.passive(document, 'touchstart', () => {
+                lastTouchMs = Date.now();
+                modality.set('touch');
+            });
+        });
+        return modality.asReadonly();
+    });
+}
+const INPUT_MODALITY = /* @__PURE__ */ createToken(inputModality);
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { INPUT_MODALITY, inputModality };
+//# sourceMappingURL=signality-core-browser-input-modality.mjs.map

package/fesm2022/signality-core-browser-input-modality.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-input-modality.mjs","sources":["../../../projects/core/browser/input-modality/index.ts","../../../projects/core/browser/input-modality/signality-core-browser-input-modality.ts"],"sourcesContent":["import { signal, type 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 InputModality = 'keyboard' | 'mouse' | 'touch' | null;\n\nconst TOUCH_BUFFER_MS = 650;\n\nconst MODIFIER_KEYS = ['Shift', 'Control', 'Alt', 'Meta', 'ContextMenu'];\n\n/**\n * Reactively track the user's current input method (keyboard, mouse, or touch).\n *\n * @param options - Optional configuration including injector\n * @returns A signal containing the current input modality: `'keyboard'`, `'mouse'`, `'touch'`, or `null`\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <div [class.keyboard]=\"modality() === 'keyboard'\">\n *       <p>Current input: {{ modality() ?? 'none' }}</p>\n *       <button>Button with conditional focus ring</button>\n *     </div>\n *   `\n * })\n * export class ModalityComponent {\n *   readonly modality = inputModality();\n * }\n * ```\n */\nexport function inputModality(options?: WithInjector): Signal<InputModality> {\n  const { runInContext } = setupContext(options?.injector, inputModality);\n\n  return runInContext(({ isServer }) => {\n    if (isServer) {\n      return constSignal(null);\n    }\n\n    const modality = signal<InputModality>(null);\n\n    let lastTouchMs = 0;\n\n    setupSync(() => {\n      listener(document, 'keydown', (event: KeyboardEvent) => {\n        if (MODIFIER_KEYS.includes(event.key)) {\n          return;\n        }\n        modality.set('keyboard');\n      });\n\n      listener(document, 'mousedown', () => {\n        if (Date.now() - lastTouchMs < TOUCH_BUFFER_MS) {\n          return;\n        }\n        modality.set('mouse');\n      });\n\n      listener.passive(document, 'touchstart', () => {\n        lastTouchMs = Date.now();\n        modality.set('touch');\n      });\n    });\n\n    return modality.asReadonly();\n  });\n}\n\nexport const INPUT_MODALITY = /* @__PURE__ */ createToken(inputModality);\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAOA,MAAM,eAAe,GAAG,GAAG;AAE3B,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;AAoBG;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,QAAQ,EAAE,KAAI;QACnC,IAAI,QAAQ,EAAE;AACZ,YAAA,OAAO,WAAW,CAAC,IAAI,CAAC;QAC1B;AAEA,QAAA,MAAM,QAAQ,GAAG,MAAM,CAAgB,IAAI,oDAAC;QAE5C,IAAI,WAAW,GAAG,CAAC;QAEnB,SAAS,CAAC,MAAK;YACb,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,KAAoB,KAAI;gBACrD,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;oBACrC;gBACF;AACA,gBAAA,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC;AAC1B,YAAA,CAAC,CAAC;AAEF,YAAA,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAK;gBACnC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,GAAG,eAAe,EAAE;oBAC9C;gBACF;AACA,gBAAA,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;AACvB,YAAA,CAAC,CAAC;YAEF,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAK;AAC5C,gBAAA,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE;AACxB,gBAAA,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;AACvB,YAAA,CAAC,CAAC;AACJ,QAAA,CAAC,CAAC;AAEF,QAAA,OAAO,QAAQ,CAAC,UAAU,EAAE;AAC9B,IAAA,CAAC,CAAC;AACJ;AAEO,MAAM,cAAc,mBAAmB,WAAW,CAAC,aAAa;;ACrEvE;;AAEG;;;;"}

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

@@ -0,0 +1,132 @@
+import { afterRenderEffect, effect } from '@angular/core';
+import { SIGNAL } from '@angular/core/primitives/signals';
+import { setupContext, NOOP_EFFECT_REF, toElement, toValue } from '@signality/core/internal';
+
+/**
+ * Signal-based wrapper around the [addEventListener](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener) method.
+ *
+ * @param target - Event target
+ * @param event - Event type name
+ * @param handler - Event handler function
+ * @param options - Optional listener configuration
+ * @returns A ListenerRef that can be used to destroy the listener
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `<button #btn>Click me</button>`,
+ * })
+ * class ListenerComponent {
+ *   readonly btn = viewChild<ElementRef>('btn');
+ *
+ *   constructor() {
+ *     listener.capture.prevent(this.btn, 'click', event => {
+ *       console.log('Button clicked!', event);
+ *     });
+ *   }
+ * }
+ * ```
+ */
+const listener = createModifier({});
+let isSyncSetupRequired = false;
+/**
+ * By default, `listener()` registers event listeners after the render cycle completes
+ * to ensure DOM elements exist. However, global targets (window, document, navigator.*, etc.)
+ * are not tied to the render cycle. Use `setupSync()` to wrap listener calls when you need to prevent
+ * race conditions where a global event is dispatched before Angular completes its scheduled rendering tasks.
+ */
+function setupSync(listenerFactoryExecFn) {
+    isSyncSetupRequired = true;
+    try {
+        return listenerFactoryExecFn();
+    }
+    finally {
+        isSyncSetupRequired = false;
+    }
+}
+function listenerImpl(applied, ...args) {
+    const options = args[3];
+    const { runInContext } = setupContext(options?.injector, listenerImpl);
+    return runInContext(({ isServer }) => {
+        if (isServer) {
+            return NOOP_EFFECT_REF;
+        }
+        const [maybeReactiveTarget, maybeReactiveEvent, rawHandler] = args;
+        const { stop, prevent, self, ...nativeOptions } = applied;
+        const hasModifiers = stop || prevent || self;
+        const handler = hasModifiers
+            ? function (event) {
+                if (self && event.target !== event.currentTarget)
+                    return;
+                if (prevent)
+                    event.preventDefault();
+                if (stop)
+                    event.stopPropagation();
+                rawHandler.call(this, event);
+            }
+            : rawHandler;
+        const setupListener = (onCleanup) => {
+            const target = toElement(maybeReactiveTarget);
+            const event = toValue(maybeReactiveEvent);
+            if (!target) {
+                return;
+            }
+            target.addEventListener(event, handler, nativeOptions);
+            onCleanup(() => {
+                target.removeEventListener(event, handler, nativeOptions);
+            });
+        };
+        let effectRef;
+        if (isSyncSetupRequired) {
+            effectRef = syncEffect(setupListener);
+        }
+        else {
+            effectRef = afterRenderEffect({ read: setupListener });
+        }
+        return { destroy: () => effectRef.destroy() };
+    });
+}
+const MODIFIERS = new Set([
+    'capture',
+    'passive',
+    'once',
+    'stop',
+    'prevent',
+    'self',
+]);
+function createModifier(applied) {
+    const modifierFn = ((...args) => {
+        return listenerImpl(applied, ...args);
+    });
+    return new Proxy(modifierFn, {
+        get(target, prop) {
+            if (typeof prop !== 'string' || !MODIFIERS.has(prop)) {
+                return target[prop];
+            }
+            if (applied[prop]) {
+                return target;
+            }
+            return createModifier({ ...applied, [prop]: true });
+        },
+    });
+}
+function syncEffect(effectFn, options) {
+    const effectRef = effect(effectFn, options);
+    const effectNode = effectRef[SIGNAL];
+    try {
+        effectNode.run();
+    }
+    catch (error) {
+        if (ngDevMode) {
+            console.warn('[syncEffect] Failed to run effectFn synchronously', error);
+        }
+    }
+    return effectRef;
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { listener, setupSync };
+//# sourceMappingURL=signality-core-browser-listener.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-browser-listener.mjs","sources":["../../../projects/core/browser/listener/index.ts","../../../projects/core/browser/listener/signality-core-browser-listener.ts"],"sourcesContent":["import {\n  afterRenderEffect,\n  type CreateEffectOptions,\n  effect,\n  type EffectCleanupRegisterFn,\n  type EffectRef,\n} from '@angular/core';\nimport { type BaseEffectNode, SIGNAL } from '@angular/core/primitives/signals';\nimport { NOOP_EFFECT_REF, setupContext, toElement, toValue } from '@signality/core/internal';\nimport type { MaybeElementSignal, MaybeSignal, WithInjector } from '@signality/core/types';\n\nexport type ListenerOptions = WithInjector;\n\nexport interface ListenerRef {\n  readonly destroy: () => void;\n}\n\nexport interface ListenerFunction {\n  <E extends keyof WindowEventMap>(\n    target: Window,\n    event: MaybeSignal<E>,\n    handler: (this: Window, e: WindowEventMap[E]) => any,\n    options?: ListenerOptions\n  ): ListenerRef;\n\n  <E extends keyof DocumentEventMap>(\n    target: Document,\n    event: MaybeSignal<E>,\n    handler: (this: Document, e: DocumentEventMap[E]) => any,\n    options?: ListenerOptions\n  ): ListenerRef;\n\n  <E extends keyof ShadowRootEventMap>(\n    target: MaybeSignal<ShadowRoot>,\n    event: MaybeSignal<E>,\n    handler: (this: ShadowRoot, e: ShadowRootEventMap[E]) => any,\n    options?: ListenerOptions\n  ): ListenerRef;\n\n  <T extends HTMLElement, E extends keyof HTMLElementEventMap>(\n    target: MaybeElementSignal<T>,\n    event: MaybeSignal<E>,\n    handler: (this: T, e: HTMLElementEventMap[E]) => any,\n    options?: ListenerOptions\n  ): ListenerRef;\n\n  <T extends SVGElement, E extends keyof SVGElementEventMap>(\n    target: MaybeElementSignal<T>,\n    event: MaybeSignal<E>,\n    handler: (this: T, e: SVGElementEventMap[E]) => any,\n    options?: ListenerOptions\n  ): ListenerRef;\n\n  <Names extends string>(\n    target: MaybeSignal<InferEventTarget<Names>>,\n    event: MaybeSignal<Names>,\n    handler: (e: Event) => void,\n    options?: ListenerOptions\n  ): ListenerRef;\n\n  <EventType = Event>(\n    target: MaybeSignal<EventTarget> | MaybeElementSignal<Element>,\n    event: MaybeSignal<string>,\n    handler: GeneralEventListener<EventType>,\n    options?: ListenerOptions\n  ): ListenerRef;\n\n  readonly capture: ListenerFunction;\n  readonly passive: ListenerFunction;\n  readonly once: ListenerFunction;\n  readonly stop: ListenerFunction;\n  readonly prevent: ListenerFunction;\n  readonly self: ListenerFunction;\n}\n\n/**\n * Signal-based wrapper around the [addEventListener](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener) method.\n *\n * @param target - Event target\n * @param event - Event type name\n * @param handler - Event handler function\n * @param options - Optional listener configuration\n * @returns A ListenerRef that can be used to destroy the listener\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `<button #btn>Click me</button>`,\n * })\n * class ListenerComponent {\n *   readonly btn = viewChild<ElementRef>('btn');\n *\n *   constructor() {\n *     listener.capture.prevent(this.btn, 'click', event => {\n *       console.log('Button clicked!', event);\n *     });\n *   }\n * }\n * ```\n */\nexport const listener: ListenerFunction = createModifier({});\n\nlet isSyncSetupRequired = false;\n\n/**\n * By default, `listener()` registers event listeners after the render cycle completes\n * to ensure DOM elements exist. However, global targets (window, document, navigator.*, etc.)\n * are not tied to the render cycle. Use `setupSync()` to wrap listener calls when you need to prevent\n * race conditions where a global event is dispatched before Angular completes its scheduled rendering tasks.\n */\nexport function setupSync<T>(listenerFactoryExecFn: () => T): T {\n  isSyncSetupRequired = true;\n\n  try {\n    return listenerFactoryExecFn();\n  } finally {\n    isSyncSetupRequired = false;\n  }\n}\n\nfunction listenerImpl(applied: InternalListenerOptions, ...args: any[]): ListenerRef {\n  const options = args[3] as ListenerOptions | undefined;\n\n  const { runInContext } = setupContext(options?.injector, listenerImpl);\n\n  return runInContext(({ isServer }) => {\n    if (isServer) {\n      return NOOP_EFFECT_REF;\n    }\n\n    const [maybeReactiveTarget, maybeReactiveEvent, rawHandler] = args;\n    const { stop, prevent, self, ...nativeOptions } = applied;\n    const hasModifiers = stop || prevent || self;\n\n    const handler = hasModifiers\n      ? function (this: any, event: Event) {\n          if (self && event.target !== event.currentTarget) return;\n          if (prevent) event.preventDefault();\n          if (stop) event.stopPropagation();\n          rawHandler.call(this, event);\n        }\n      : rawHandler;\n\n    const setupListener = (onCleanup: EffectCleanupRegisterFn) => {\n      const target = toElement(maybeReactiveTarget);\n      const event = toValue(maybeReactiveEvent);\n\n      if (!target) {\n        return;\n      }\n\n      target.addEventListener(event, handler, nativeOptions);\n\n      onCleanup(() => {\n        target.removeEventListener(event, handler, nativeOptions);\n      });\n    };\n\n    let effectRef: EffectRef;\n\n    if (isSyncSetupRequired) {\n      effectRef = syncEffect(setupListener);\n    } else {\n      effectRef = afterRenderEffect({ read: setupListener });\n    }\n\n    return { destroy: () => effectRef.destroy() };\n  });\n}\n\nconst MODIFIERS = new Set<keyof InternalListenerOptions>([\n  'capture',\n  'passive',\n  'once',\n  'stop',\n  'prevent',\n  'self',\n]);\n\nfunction createModifier(applied: InternalListenerOptions): ListenerFunction {\n  const modifierFn = ((...args: any[]) => {\n    return listenerImpl(applied, ...args);\n  }) as ListenerFunction;\n\n  return new Proxy(modifierFn, {\n    get(target, prop) {\n      if (typeof prop !== 'string' || !MODIFIERS.has(prop as any)) {\n        return target[prop as keyof typeof target];\n      }\n\n      if (applied[prop as keyof InternalListenerOptions]) {\n        return target;\n      }\n\n      return createModifier({ ...applied, [prop]: true });\n    },\n  });\n}\n\nfunction syncEffect(\n  effectFn: (onCleanup: EffectCleanupRegisterFn) => void,\n  options?: CreateEffectOptions\n): EffectRef {\n  const effectRef = effect(effectFn, options);\n  const effectNode: BaseEffectNode = (effectRef as any)[SIGNAL];\n  try {\n    effectNode.run();\n  } catch (error) {\n    if (ngDevMode) {\n      console.warn('[syncEffect] Failed to run effectFn synchronously', error);\n    }\n  }\n  return effectRef;\n}\n\ninterface InternalListenerOptions {\n  readonly capture?: boolean;\n  readonly passive?: boolean;\n  readonly once?: boolean;\n  readonly stop?: boolean;\n  readonly prevent?: boolean;\n  readonly self?: boolean;\n}\n\ninterface InferEventTarget<Events> {\n  readonly addEventListener: (event: Events, fn?: any, options?: any) => any;\n  readonly removeEventListener: (event: Events, fn?: any, options?: any) => any;\n}\n\ninterface GeneralEventListener<E = Event> {\n  (e: E): void;\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-media-query.mjs

@@ -0,0 +1,55 @@
+import { signal, effect } from '@angular/core';
+import { setupContext, constSignal, toValue } from '@signality/core/internal';
+import { listener } from '@signality/core/browser/listener';
+
+/**
+ * Reactive wrapper around the [Window.matchMedia](https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia) method.
+ *
+ * @param query - CSS media query string (can be a signal)
+ * @param options - Optional configuration
+ * @returns A signal that is true when the media query matches
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     @if (prefersDark()) {
+ *       <p>Dark mode is preferred</p>
+ *     } @else {
+ *       <p>Light mode is preferred</p>
+ *     }
+ *   `
+ * })
+ * class ThemeComponent {
+ *   readonly prefersDark = mediaQuery('(prefers-color-scheme: dark)');
+ * }
+ * ```
+ */
+function mediaQuery(query, options) {
+    const { runInContext } = setupContext(options?.injector, mediaQuery);
+    return runInContext(({ isServer, injector }) => {
+        if (isServer) {
+            return constSignal(!!options?.initialValue);
+        }
+        const matches = signal(!!options?.initialValue, options);
+        effect(onCleanup => {
+            const queryString = toValue(query);
+            if (!queryString) {
+                matches.set(false);
+                return;
+            }
+            const mediaQueryList = window.matchMedia(queryString);
+            matches.set(mediaQueryList.matches);
+            const changeListener = listener(mediaQueryList, 'change', (e) => matches.set(e.matches), { injector });
+            onCleanup(changeListener.destroy);
+        });
+        return matches.asReadonly();
+    });
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { mediaQuery };
+//# sourceMappingURL=signality-core-browser-media-query.mjs.map