@signality/core 0.1.3 → 0.2.0

package/fesm2022/signality-core-internal.mjs

@@ -1,4 +1,4 @@
-import { InjectionToken, inject, PLATFORM_ID, assertInInjectionContext, INJECTOR, runInInjectionContext, DestroyRef, untracked, isSignal, ElementRef } from '@angular/core';
+import { InjectionToken, inject, PLATFORM_ID, assertInInjectionContext, INJECTOR, runInInjectionContext, DestroyRef, untracked, isSignal, effect, ElementRef } from '@angular/core';
 import { isPlatformBrowser, isPlatformServer } from '@angular/common';
 import { SIGNAL, SIGNAL_NODE } from '@angular/core/primitives/signals';
 
@@ -184,6 +184,38 @@ function createToken(factory, providedIn = 'root') {
     return new InjectionToken(ngDevMode ? factory.name : '', { factory, providedIn });
 }
 
+/**
+ * Resolves the first available value of a signal as a Promise.
+ * @internal
+ */
+function waitForValue(source, injector) {
+    const { runInContext } = setupContext(injector, waitForValue);
+    return runInContext(() => {
+        try {
+            // Try to read the signal synchronously
+            return Promise.resolve(source());
+        }
+        catch {
+            // Required signals (input, model, queries) throw when read outside a reactive context
+            // during initialization, fall back to reading the value inside an effect
+            return new Promise((resolve, reject) => {
+                const effectRef = effect(() => {
+                    try {
+                        const value = source();
+                        resolve(value);
+                    }
+                    catch (e) {
+                        reject(e);
+                    }
+                    finally {
+                        effectRef.destroy();
+                    }
+                }, ...(ngDevMode ? [{ debugName: "effectRef" }] : []));
+            });
+        }
+    });
+}
+
 /**
  * Determines if a signal is a query signal (viewChild, contentChild).
  * Query signals have a special internal structure with a `_dirtyCounter` property that tracks
@@ -287,5 +319,5 @@ function isAcceptedFile(file, accept) {
  * Generated bundle index. Do not edit.
  */
 
-export { ALWAYS_FALSE_FN, IS_BROWSER, IS_MOBILE, IS_SERVER, MOBILE_REGEX, NOOP_ASYNC_FN, NOOP_EFFECT_REF, NOOP_FN, assertElement, assertEventTarget, constSignal, createToken, getActiveElement, getEventTarget, getPipElement, getShadowRoot, isAcceptedFile, isElement, isEventTarget, isNodeWithin, isPlainObject, isQuerySignal, isWindow, proxySignal, setupContext, unrefElement };
+export { ALWAYS_FALSE_FN, IS_BROWSER, IS_MOBILE, IS_SERVER, MOBILE_REGEX, NOOP_ASYNC_FN, NOOP_EFFECT_REF, NOOP_FN, assertElement, assertEventTarget, constSignal, createToken, getActiveElement, getEventTarget, getPipElement, getShadowRoot, isAcceptedFile, isElement, isEventTarget, isNodeWithin, isPlainObject, isQuerySignal, isWindow, proxySignal, setupContext, unrefElement, waitForValue };
 //# sourceMappingURL=signality-core-internal.mjs.map

package/fesm2022/signality-core-internal.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"signality-core-internal.mjs","sources":["../../../projects/core/internal/constants/mobile-regex.ts","../../../projects/core/internal/constants/stubs.ts","../../../projects/core/internal/providers/is-browser.ts","../../../projects/core/internal/providers/is-mobile.ts","../../../projects/core/internal/providers/is-server.ts","../../../projects/core/internal/utils/bom/is-window.ts","../../../projects/core/internal/utils/dom/get-active-element.ts","../../../projects/core/internal/utils/dom/get-event-target.ts","../../../projects/core/internal/utils/dom/get-pip-element.ts","../../../projects/core/internal/utils/dom/get-shadow-root.ts","../../../projects/core/internal/utils/dom/is-element.ts","../../../projects/core/internal/utils/dom/is-event-target.ts","../../../projects/core/internal/utils/dom/is-node-within.ts","../../../projects/core/internal/utils/assert.ts","../../../projects/core/internal/utils/context.ts","../../../projects/core/internal/utils/create-token.ts","../../../projects/core/internal/utils/is-query-signal.ts","../../../projects/core/internal/utils/is-plain-object.ts","../../../projects/core/internal/utils/const-signal.ts","../../../projects/core/internal/utils/proxy-signal.ts","../../../projects/core/internal/utils/unref-element.ts","../../../projects/core/internal/utils/files/is-accepted-file.ts","../../../projects/core/internal/signality-core-internal.ts"],"sourcesContent":["export const MOBILE_REGEX = /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i;\n","/**\n * Empty synchronous function stub.\n * Used for SSR compatibility when returning method functions in Ref objects that should do nothing on the server.\n *\n * Example: `close: NOOP_FN` in {@link WebNotificationRef}\n */\nexport const NOOP_FN: (...args: any[]) => void = () => {\n  /* empty */\n};\n\n/**\n * Empty asynchronous function stub that returns a resolved Promise.\n * Used for SSR compatibility when returning async method functions in Ref objects that should do nothing on the server.\n *\n * Example: `share: NOOP_ASYNC_FN` in {@link WebShareRef}\n */\nexport const NOOP_ASYNC_FN = () => Promise.resolve();\n\n/**\n * Frozen EffectRef stub with a no-op destroy method.\n * Used for SSR compatibility when returning EffectRef from observer utilities (ResizeObserver, MutationObserver, etc.)\n * that cannot run on the server. Prevents errors when calling destroy() on server-rendered refs.\n *\n * Example: `return NOOP_EFFECT_REF` in {@link resizeObserver}\n */\nexport const NOOP_EFFECT_REF = { destroy: NOOP_FN };\n\n/**\n * Equality function that always returns false, forcing signal updates on every change.\n * Used for signals that hold mutable objects (like Selection, Range) where reference equality is not sufficient\n * and we need to detect changes even when the object structure appears the same.\n *\n * Example: `signal<Selection | null>(null, { equal: ALWAYS_FALSE_FN })` in {@link textSelection}\n */\nexport const ALWAYS_FALSE_FN = () => false;\n","import { inject, InjectionToken, PLATFORM_ID } from '@angular/core';\nimport { isPlatformBrowser } from '@angular/common';\n\nexport const IS_BROWSER = new InjectionToken<boolean>(ngDevMode ? 'IS_BROWSER' : '', {\n  providedIn: 'platform',\n  factory: () => isPlatformBrowser(inject(PLATFORM_ID)),\n});\n","import { inject, InjectionToken } from '@angular/core';\nimport { MOBILE_REGEX } from '../constants';\nimport { IS_BROWSER } from './is-browser';\n\nexport const IS_MOBILE = new InjectionToken<boolean>(ngDevMode ? 'IS_MOBILE' : '', {\n  providedIn: 'platform',\n  factory: () => {\n    return inject(IS_BROWSER) ? MOBILE_REGEX.test(navigator.userAgent) : false;\n  },\n});\n","import { inject, InjectionToken, PLATFORM_ID } from '@angular/core';\nimport { isPlatformServer } from '@angular/common';\n\nexport const IS_SERVER = new InjectionToken<boolean>(ngDevMode ? 'IS_SERVER' : '', {\n  providedIn: 'platform',\n  factory: () => isPlatformServer(inject(PLATFORM_ID)),\n});\n","export function isWindow(obj: object | null): obj is Window {\n  return !!obj && (obj as Window).window === obj;\n}\n","export function getActiveElement(document: Document): Element | null {\n  let activeElement = document.activeElement;\n\n  while (activeElement && activeElement.shadowRoot) {\n    const newActiveElement = activeElement.shadowRoot.activeElement;\n    if (newActiveElement === activeElement) {\n      break;\n    } else {\n      activeElement = newActiveElement;\n    }\n  }\n\n  return activeElement;\n}\n","export function getEventTarget<T extends EventTarget>(event: Event): T | null {\n  return (event.composedPath ? event.composedPath()[0] : event.target) as T | null;\n}\n","export function getPipElement(document: Document): Element | null {\n  let pipElement = document.pictureInPictureElement;\n\n  while (pipElement && pipElement.shadowRoot) {\n    const newPipElement = pipElement.shadowRoot.pictureInPictureElement;\n    if (newPipElement === pipElement) {\n      break;\n    } else {\n      pipElement = newPipElement;\n    }\n  }\n\n  return pipElement;\n}\n","export function getShadowRoot(element: Element | null): ShadowRoot | null {\n  const rootNode = element?.getRootNode ? element.getRootNode() : null;\n\n  if (rootNode instanceof ShadowRoot) {\n    return rootNode;\n  }\n\n  return null;\n}\n","export function isElement(value: unknown): value is Element {\n  return !!value && (value as Element).nodeType === Node.ELEMENT_NODE;\n}\n","export function isEventTarget(value: unknown): value is EventTarget {\n  return typeof (value as EventTarget)?.addEventListener === 'function';\n}\n","export function isNodeWithin(node: Node, root: Element): boolean {\n  return root === node || root.contains(node) || (root.shadowRoot?.contains(node) ?? false);\n}\n","import { isElement, isEventTarget } from './dom';\n\nexport function assertElement(value: unknown, source: string): asserts value is Element {\n  if (!isElement(value)) {\n    throw new Error(\n      `[${source}] Expected a DOM Element, ElementRef but received: ${\n        (value as object).constructor?.name ?? typeof value\n      }. ` +\n        `If you are using viewChild/contentChild, make sure to specify \"{ read: ElementRef }\" to avoid implicit directive references.`\n    );\n  }\n}\n\nexport function assertEventTarget(value: unknown, source: string): asserts value is EventTarget {\n  if (!isEventTarget(value)) {\n    throw new Error(\n      `[${source}] Expected an EventTarget, ElementRef but received: ${\n        (value as object).constructor?.name ?? typeof value\n      }. ` +\n        `If you are using viewChild/contentChild, specify \"{ read: ElementRef }\" to avoid implicit directive references.`\n    );\n  }\n}\n","import {\n  assertInInjectionContext,\n  DestroyRef,\n  inject,\n  type Injector,\n  INJECTOR,\n  isSignal,\n  runInInjectionContext,\n  type Signal,\n  untracked,\n} from '@angular/core';\nimport { SIGNAL, type SignalNode } from '@angular/core/primitives/signals';\nimport { IS_BROWSER, IS_MOBILE, IS_SERVER } from '../providers';\n\nexport interface ContextRef {\n  readonly injector: Injector;\n  readonly isServer: boolean;\n  readonly isBrowser: boolean;\n  readonly isMobile: boolean;\n  readonly onCleanup: (cleanupFn: () => void) => void;\n}\n\nexport interface SetupContextRef {\n  runInContext<T>(fn: (context: ContextRef) => T): T;\n}\n\n/**\n * @internal\n *\n * @param injector - injector to use for context\n * @param debugFn - context owner function\n */\nexport function setupContext(\n  injector?: Injector,\n  debugFn?: (...args: any[]) => any\n): SetupContextRef {\n  if (typeof ngDevMode !== 'undefined' && ngDevMode && !injector) {\n    assertInInjectionContext(debugFn || setupContext);\n  }\n\n  const ctxInjector = injector || inject(INJECTOR);\n\n  return {\n    runInContext<T>(fn: (context: ContextRef) => T): T {\n      return runInContextImpl(fn, ctxInjector, debugFn || setupContext);\n    },\n  };\n}\n\nfunction runInContextImpl<T>(\n  fn: (context: ContextRef) => T,\n  injector: Injector,\n  debugFn: (...args: any[]) => any\n): T {\n  const result = runInInjectionContext(injector, () => {\n    const isBrowser = inject(IS_BROWSER);\n    const isServer = inject(IS_SERVER);\n    const isMobile = inject(IS_MOBILE);\n    const destroyRef = inject(DestroyRef);\n\n    const onCleanup = (cleanupFn: () => void) => {\n      destroyRef.onDestroy(cleanupFn);\n    };\n\n    return untracked(() => fn({ injector, isBrowser, isServer, isMobile, onCleanup }));\n  });\n\n  if (typeof ngDevMode !== 'undefined' && ngDevMode && result != null) {\n    setupDebugInfo(result, debugFn);\n  }\n\n  return result;\n}\n\nfunction setupDebugInfo<T>(value: T, debugFn: (...args: any[]) => any): T {\n  if (isSignal(value)) {\n    setDebugName(value, debugFn);\n  } else if (value && typeof value === 'object') {\n    for (const [postfix, maybeSignal] of Object.entries(value)) {\n      if (isSignal(maybeSignal)) {\n        setDebugName(maybeSignal, debugFn, postfix);\n      }\n    }\n  }\n\n  return value;\n}\n\nfunction setDebugName(\n  signal: Signal<unknown>,\n  debugFn: (...args: any[]) => any,\n  postfix?: string\n): void {\n  const node = signal[SIGNAL] as SignalNode<unknown>;\n\n  if (node.debugName === undefined) {\n    node.debugName = debugFn.name + (postfix ? '.' + postfix : '');\n  }\n}\n","import { InjectionToken, type ProviderToken } from '@angular/core';\n\n/**\n * Creates an Angular InjectionToken with a factory function.\n * @internal\n */\nexport function createToken<T>(\n  factory: () => T,\n  providedIn: ProvidedIn = 'root'\n): ProviderToken<T> {\n  return new InjectionToken(ngDevMode ? factory.name : '', { factory, providedIn });\n}\n\ntype ProvidedIn = NonNullable<ConstructorParameters<typeof InjectionToken>[1]>['providedIn'];\n","import { isSignal, type Signal } from '@angular/core';\nimport { SIGNAL } from '@angular/core/primitives/signals';\n\n/**\n * Determines if a signal is a query signal (viewChild, contentChild).\n * Query signals have a special internal structure with a `_dirtyCounter` property that tracks\n * when query results change.\n\n * See: https://github.com/angular/angular/blob/main/packages/core/src/render3/queries/query_reactive.ts#L43\n * @internal\n */\nexport function isQuerySignal(val: unknown): val is Signal<unknown> {\n  if (!isSignal(val)) {\n    return false;\n  }\n\n  const node = val[SIGNAL] as object;\n  return '_dirtyCounter' in node;\n}\n","export function isPlainObject(value: unknown): value is Record<PropertyKey, unknown> {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n\n  const prototype = Object.getPrototypeOf(value);\n  return prototype === null || prototype === Object.prototype;\n}\n","import type { Signal } from '@angular/core';\nimport {\n  SIGNAL,\n  SIGNAL_NODE,\n  type SignalGetter,\n  type SignalNode,\n} from '@angular/core/primitives/signals';\n\n/***\n * Creates a lightweight, readonly signal.\n * This is primarily used to provide fallback values for states that cannot be\n * computed in the current environment. For example:\n * - During SSR where browser-only APIs are unavailable\n * - In environments that lack support for specific APIs\n * @internal\n */\nexport function constSignal<T>(value: T): Signal<T> {\n  const node: SignalNode<T> = Object.create(SIGNAL_NODE);\n  node.value = value;\n\n  const getter = (() => node.value) as SignalGetter<T>;\n  (getter as any)[SIGNAL] = node;\n\n  if (typeof ngDevMode !== 'undefined' && ngDevMode) {\n    const debugName = node.debugName ? ' (' + node.debugName + ')' : '';\n    getter.toString = () => `[Signal${debugName}: ${String(node.value)}]`;\n  }\n\n  return getter;\n}\n","import { type Signal, untracked, type WritableSignal } from '@angular/core';\nimport { SIGNAL, type SignalNode } from '@angular/core/primitives/signals';\n\n/**\n * @internal\n */\nexport interface SignalProxyHandler<T> {\n  get?(source: Signal<T>): T;\n  set?(value: T, source: WritableSignal<T>): void;\n}\n\n/**\n * Creates a proxy wrapper around a {@link Signal}\n * @internal\n */\nexport function proxySignal<T>(\n  source: Signal<T>,\n  handler: Omit<SignalProxyHandler<T>, 'set'>\n): Signal<T>;\n\n/**\n * Creates a proxy wrapper around a {@link WritableSignal}\n * @internal\n */\nexport function proxySignal<T>(\n  source: WritableSignal<T>,\n  handler: SignalProxyHandler<T>\n): WritableSignal<T>;\n\nexport function proxySignal<T>(\n  source: Signal<T> | WritableSignal<T>,\n  handler: SignalProxyHandler<T>\n): Signal<T> | WritableSignal<T> {\n  const node = source[SIGNAL] as SignalNode<T>;\n  const isWritable = 'set' in source && typeof source.set === 'function';\n\n  const proxy = (handler.get ? () => handler.get!(source) : () => source()) as Signal<T>;\n\n  proxy[SIGNAL] = node;\n\n  // @TODO: consider (original toString internally reads from the original getter, bypassing the proxy)\n  proxy.toString = source.toString;\n\n  if (isWritable) {\n    const set = handler.set\n      ? (value: T) => untracked(() => handler.set!(value, source))\n      : (value: T) => source.set(value);\n\n    const update = (updater: (current: T) => T) => set(updater(node.value));\n\n    (proxy as WritableSignal<T>).set = set;\n    (proxy as WritableSignal<T>).update = update;\n    (proxy as WritableSignal<T>).asReadonly = () => {\n      const getter = source.asReadonly();\n      return proxySignal(getter, { get: handler.get?.bind(handler) });\n    };\n  }\n\n  return proxy;\n}\n","import { ElementRef } from '@angular/core';\n\nexport function unrefElement<T>(value: T | ElementRef<T>): T {\n  return value instanceof ElementRef ? value.nativeElement : value;\n}\n","/**\n * Checks whether a file matches the given accept patterns.\n * Follows the native HTML\n * [`accept`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/accept) attribute format:\n * MIME types (`'image/png'`), wildcards (`'image/*'`), and file extensions (`'.pdf'`).\n *\n * @param file - File to check\n * @param accept - Comma-separated string of accepted patterns (e.g. `'image/*, .pdf'`)\n * @internal\n */\nexport function isAcceptedFile(file: File, accept: string): boolean {\n  if (accept === '*') {\n    return true;\n  }\n\n  const patterns = accept.split(',').map(s => s.trim());\n\n  if (patterns.length === 0) {\n    return true;\n  }\n\n  return patterns.some(pattern => {\n    if (pattern.startsWith('.')) {\n      return file.name.toLowerCase().endsWith(pattern.toLowerCase());\n    }\n\n    if (pattern.endsWith('/*')) {\n      return file.type.startsWith(pattern.slice(0, -1));\n    }\n\n    return file.type === pattern;\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"signality-core-internal.mjs","sources":["../../../projects/core/internal/constants/mobile-regex.ts","../../../projects/core/internal/constants/stubs.ts","../../../projects/core/internal/providers/is-browser.ts","../../../projects/core/internal/providers/is-mobile.ts","../../../projects/core/internal/providers/is-server.ts","../../../projects/core/internal/utils/bom/is-window.ts","../../../projects/core/internal/utils/dom/get-active-element.ts","../../../projects/core/internal/utils/dom/get-event-target.ts","../../../projects/core/internal/utils/dom/get-pip-element.ts","../../../projects/core/internal/utils/dom/get-shadow-root.ts","../../../projects/core/internal/utils/dom/is-element.ts","../../../projects/core/internal/utils/dom/is-event-target.ts","../../../projects/core/internal/utils/dom/is-node-within.ts","../../../projects/core/internal/utils/assert.ts","../../../projects/core/internal/utils/context.ts","../../../projects/core/internal/utils/create-token.ts","../../../projects/core/internal/utils/wait-for-value.ts","../../../projects/core/internal/utils/is-query-signal.ts","../../../projects/core/internal/utils/is-plain-object.ts","../../../projects/core/internal/utils/const-signal.ts","../../../projects/core/internal/utils/proxy-signal.ts","../../../projects/core/internal/utils/unref-element.ts","../../../projects/core/internal/utils/files/is-accepted-file.ts","../../../projects/core/internal/signality-core-internal.ts"],"sourcesContent":["export const MOBILE_REGEX = /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i;\n","/**\n * Empty synchronous function stub.\n * Used for SSR compatibility when returning method functions in Ref objects that should do nothing on the server.\n *\n * Example: `close: NOOP_FN` in {@link WebNotificationRef}\n */\nexport const NOOP_FN: (...args: any[]) => void = () => {\n  /* empty */\n};\n\n/**\n * Empty asynchronous function stub that returns a resolved Promise.\n * Used for SSR compatibility when returning async method functions in Ref objects that should do nothing on the server.\n *\n * Example: `share: NOOP_ASYNC_FN` in {@link WebShareRef}\n */\nexport const NOOP_ASYNC_FN = () => Promise.resolve();\n\n/**\n * Frozen EffectRef stub with a no-op destroy method.\n * Used for SSR compatibility when returning EffectRef from observer utilities (ResizeObserver, MutationObserver, etc.)\n * that cannot run on the server. Prevents errors when calling destroy() on server-rendered refs.\n *\n * Example: `return NOOP_EFFECT_REF` in {@link resizeObserver}\n */\nexport const NOOP_EFFECT_REF = { destroy: NOOP_FN };\n\n/**\n * Equality function that always returns false, forcing signal updates on every change.\n * Used for signals that hold mutable objects (like Selection, Range) where reference equality is not sufficient\n * and we need to detect changes even when the object structure appears the same.\n *\n * Example: `signal<Selection | null>(null, { equal: ALWAYS_FALSE_FN })` in {@link textSelection}\n */\nexport const ALWAYS_FALSE_FN = () => false;\n","import { inject, InjectionToken, PLATFORM_ID } from '@angular/core';\nimport { isPlatformBrowser } from '@angular/common';\n\nexport const IS_BROWSER = new InjectionToken<boolean>(ngDevMode ? 'IS_BROWSER' : '', {\n  providedIn: 'platform',\n  factory: () => isPlatformBrowser(inject(PLATFORM_ID)),\n});\n","import { inject, InjectionToken } from '@angular/core';\nimport { MOBILE_REGEX } from '../constants';\nimport { IS_BROWSER } from './is-browser';\n\nexport const IS_MOBILE = new InjectionToken<boolean>(ngDevMode ? 'IS_MOBILE' : '', {\n  providedIn: 'platform',\n  factory: () => {\n    return inject(IS_BROWSER) ? MOBILE_REGEX.test(navigator.userAgent) : false;\n  },\n});\n","import { inject, InjectionToken, PLATFORM_ID } from '@angular/core';\nimport { isPlatformServer } from '@angular/common';\n\nexport const IS_SERVER = new InjectionToken<boolean>(ngDevMode ? 'IS_SERVER' : '', {\n  providedIn: 'platform',\n  factory: () => isPlatformServer(inject(PLATFORM_ID)),\n});\n","export function isWindow(obj: object | null): obj is Window {\n  return !!obj && (obj as Window).window === obj;\n}\n","export function getActiveElement(document: Document): Element | null {\n  let activeElement = document.activeElement;\n\n  while (activeElement && activeElement.shadowRoot) {\n    const newActiveElement = activeElement.shadowRoot.activeElement;\n    if (newActiveElement === activeElement) {\n      break;\n    } else {\n      activeElement = newActiveElement;\n    }\n  }\n\n  return activeElement;\n}\n","export function getEventTarget<T extends EventTarget>(event: Event): T | null {\n  return (event.composedPath ? event.composedPath()[0] : event.target) as T | null;\n}\n","export function getPipElement(document: Document): Element | null {\n  let pipElement = document.pictureInPictureElement;\n\n  while (pipElement && pipElement.shadowRoot) {\n    const newPipElement = pipElement.shadowRoot.pictureInPictureElement;\n    if (newPipElement === pipElement) {\n      break;\n    } else {\n      pipElement = newPipElement;\n    }\n  }\n\n  return pipElement;\n}\n","export function getShadowRoot(element: Element | null): ShadowRoot | null {\n  const rootNode = element?.getRootNode ? element.getRootNode() : null;\n\n  if (rootNode instanceof ShadowRoot) {\n    return rootNode;\n  }\n\n  return null;\n}\n","export function isElement(value: unknown): value is Element {\n  return !!value && (value as Element).nodeType === Node.ELEMENT_NODE;\n}\n","export function isEventTarget(value: unknown): value is EventTarget {\n  return typeof (value as EventTarget)?.addEventListener === 'function';\n}\n","export function isNodeWithin(node: Node, root: Element): boolean {\n  return root === node || root.contains(node) || (root.shadowRoot?.contains(node) ?? false);\n}\n","import { isElement, isEventTarget } from './dom';\n\nexport function assertElement(value: unknown, source: string): asserts value is Element {\n  if (!isElement(value)) {\n    throw new Error(\n      `[${source}] Expected a DOM Element, ElementRef but received: ${\n        (value as object).constructor?.name ?? typeof value\n      }. ` +\n        `If you are using viewChild/contentChild, make sure to specify \"{ read: ElementRef }\" to avoid implicit directive references.`\n    );\n  }\n}\n\nexport function assertEventTarget(value: unknown, source: string): asserts value is EventTarget {\n  if (!isEventTarget(value)) {\n    throw new Error(\n      `[${source}] Expected an EventTarget, ElementRef but received: ${\n        (value as object).constructor?.name ?? typeof value\n      }. ` +\n        `If you are using viewChild/contentChild, specify \"{ read: ElementRef }\" to avoid implicit directive references.`\n    );\n  }\n}\n","import {\n  assertInInjectionContext,\n  DestroyRef,\n  inject,\n  type Injector,\n  INJECTOR,\n  isSignal,\n  runInInjectionContext,\n  type Signal,\n  untracked,\n} from '@angular/core';\nimport { SIGNAL, type SignalNode } from '@angular/core/primitives/signals';\nimport { IS_BROWSER, IS_MOBILE, IS_SERVER } from '../providers';\n\nexport interface ContextRef {\n  readonly injector: Injector;\n  readonly isServer: boolean;\n  readonly isBrowser: boolean;\n  readonly isMobile: boolean;\n  readonly onCleanup: (cleanupFn: () => void) => void;\n}\n\nexport interface SetupContextRef {\n  runInContext<T>(fn: (context: ContextRef) => T): T;\n}\n\n/**\n * @internal\n *\n * @param injector - injector to use for context\n * @param debugFn - context owner function\n */\nexport function setupContext(\n  injector?: Injector,\n  debugFn?: (...args: any[]) => any\n): SetupContextRef {\n  if (typeof ngDevMode !== 'undefined' && ngDevMode && !injector) {\n    assertInInjectionContext(debugFn || setupContext);\n  }\n\n  const ctxInjector = injector || inject(INJECTOR);\n\n  return {\n    runInContext<T>(fn: (context: ContextRef) => T): T {\n      return runInContextImpl(fn, ctxInjector, debugFn || setupContext);\n    },\n  };\n}\n\nfunction runInContextImpl<T>(\n  fn: (context: ContextRef) => T,\n  injector: Injector,\n  debugFn: (...args: any[]) => any\n): T {\n  const result = runInInjectionContext(injector, () => {\n    const isBrowser = inject(IS_BROWSER);\n    const isServer = inject(IS_SERVER);\n    const isMobile = inject(IS_MOBILE);\n    const destroyRef = inject(DestroyRef);\n\n    const onCleanup = (cleanupFn: () => void) => {\n      destroyRef.onDestroy(cleanupFn);\n    };\n\n    return untracked(() => fn({ injector, isBrowser, isServer, isMobile, onCleanup }));\n  });\n\n  if (typeof ngDevMode !== 'undefined' && ngDevMode && result != null) {\n    setupDebugInfo(result, debugFn);\n  }\n\n  return result;\n}\n\nfunction setupDebugInfo<T>(value: T, debugFn: (...args: any[]) => any): T {\n  if (isSignal(value)) {\n    setDebugName(value, debugFn);\n  } else if (value && typeof value === 'object') {\n    for (const [postfix, maybeSignal] of Object.entries(value)) {\n      if (isSignal(maybeSignal)) {\n        setDebugName(maybeSignal, debugFn, postfix);\n      }\n    }\n  }\n\n  return value;\n}\n\nfunction setDebugName(\n  signal: Signal<unknown>,\n  debugFn: (...args: any[]) => any,\n  postfix?: string\n): void {\n  const node = signal[SIGNAL] as SignalNode<unknown>;\n\n  if (node.debugName === undefined) {\n    node.debugName = debugFn.name + (postfix ? '.' + postfix : '');\n  }\n}\n","import { InjectionToken, type ProviderToken } from '@angular/core';\n\n/**\n * Creates an Angular InjectionToken with a factory function.\n * @internal\n */\nexport function createToken<T>(\n  factory: () => T,\n  providedIn: ProvidedIn = 'root'\n): ProviderToken<T> {\n  return new InjectionToken(ngDevMode ? factory.name : '', { factory, providedIn });\n}\n\ntype ProvidedIn = NonNullable<ConstructorParameters<typeof InjectionToken>[1]>['providedIn'];\n","import { effect, type Injector, type Signal } from '@angular/core';\nimport { setupContext } from './context';\n\n/**\n * Resolves the first available value of a signal as a Promise.\n * @internal\n */\nexport function waitForValue<T>(source: Signal<T>, injector?: Injector): Promise<T> {\n  const { runInContext } = setupContext(injector, waitForValue);\n\n  return runInContext(() => {\n    try {\n      // Try to read the signal synchronously\n      return Promise.resolve(source());\n    } catch {\n      // Required signals (input, model, queries) throw when read outside a reactive context\n      // during initialization, fall back to reading the value inside an effect\n      return new Promise<T>((resolve, reject) => {\n        const effectRef = effect(() => {\n          try {\n            const value = source();\n            resolve(value);\n          } catch (e) {\n            reject(e);\n          } finally {\n            effectRef.destroy();\n          }\n        });\n      });\n    }\n  });\n}\n","import { isSignal, type Signal } from '@angular/core';\nimport { SIGNAL } from '@angular/core/primitives/signals';\n\n/**\n * Determines if a signal is a query signal (viewChild, contentChild).\n * Query signals have a special internal structure with a `_dirtyCounter` property that tracks\n * when query results change.\n\n * See: https://github.com/angular/angular/blob/main/packages/core/src/render3/queries/query_reactive.ts#L43\n * @internal\n */\nexport function isQuerySignal(val: unknown): val is Signal<unknown> {\n  if (!isSignal(val)) {\n    return false;\n  }\n\n  const node = val[SIGNAL] as object;\n  return '_dirtyCounter' in node;\n}\n","export function isPlainObject(value: unknown): value is Record<PropertyKey, unknown> {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n\n  const prototype = Object.getPrototypeOf(value);\n  return prototype === null || prototype === Object.prototype;\n}\n","import type { Signal } from '@angular/core';\nimport {\n  SIGNAL,\n  SIGNAL_NODE,\n  type SignalGetter,\n  type SignalNode,\n} from '@angular/core/primitives/signals';\n\n/***\n * Creates a lightweight, readonly signal.\n * This is primarily used to provide fallback values for states that cannot be\n * computed in the current environment. For example:\n * - During SSR where browser-only APIs are unavailable\n * - In environments that lack support for specific APIs\n * @internal\n */\nexport function constSignal<T>(value: T): Signal<T> {\n  const node: SignalNode<T> = Object.create(SIGNAL_NODE);\n  node.value = value;\n\n  const getter = (() => node.value) as SignalGetter<T>;\n  (getter as any)[SIGNAL] = node;\n\n  if (typeof ngDevMode !== 'undefined' && ngDevMode) {\n    const debugName = node.debugName ? ' (' + node.debugName + ')' : '';\n    getter.toString = () => `[Signal${debugName}: ${String(node.value)}]`;\n  }\n\n  return getter;\n}\n","import { type Signal, untracked, type WritableSignal } from '@angular/core';\nimport { SIGNAL, type SignalNode } from '@angular/core/primitives/signals';\n\n/**\n * @internal\n */\nexport interface SignalProxyHandler<T> {\n  get?(source: Signal<T>): T;\n  set?(value: T, source: WritableSignal<T>): void;\n}\n\n/**\n * Creates a proxy wrapper around a {@link Signal}\n * @internal\n */\nexport function proxySignal<T>(\n  source: Signal<T>,\n  handler: Omit<SignalProxyHandler<T>, 'set'>\n): Signal<T>;\n\n/**\n * Creates a proxy wrapper around a {@link WritableSignal}\n * @internal\n */\nexport function proxySignal<T>(\n  source: WritableSignal<T>,\n  handler: SignalProxyHandler<T>\n): WritableSignal<T>;\n\nexport function proxySignal<T>(\n  source: Signal<T> | WritableSignal<T>,\n  handler: SignalProxyHandler<T>\n): Signal<T> | WritableSignal<T> {\n  const node = source[SIGNAL] as SignalNode<T>;\n  const isWritable = 'set' in source && typeof source.set === 'function';\n\n  const proxy = (handler.get ? () => handler.get!(source) : () => source()) as Signal<T>;\n\n  proxy[SIGNAL] = node;\n\n  // @TODO: consider (original toString internally reads from the original getter, bypassing the proxy)\n  proxy.toString = source.toString;\n\n  if (isWritable) {\n    const set = handler.set\n      ? (value: T) => untracked(() => handler.set!(value, source))\n      : (value: T) => source.set(value);\n\n    const update = (updater: (current: T) => T) => set(updater(node.value));\n\n    (proxy as WritableSignal<T>).set = set;\n    (proxy as WritableSignal<T>).update = update;\n    (proxy as WritableSignal<T>).asReadonly = () => {\n      const getter = source.asReadonly();\n      return proxySignal(getter, { get: handler.get?.bind(handler) });\n    };\n  }\n\n  return proxy;\n}\n","import { ElementRef } from '@angular/core';\n\nexport function unrefElement<T>(value: T | ElementRef<T>): T {\n  return value instanceof ElementRef ? value.nativeElement : value;\n}\n","/**\n * Checks whether a file matches the given accept patterns.\n * Follows the native HTML\n * [`accept`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/accept) attribute format:\n * MIME types (`'image/png'`), wildcards (`'image/*'`), and file extensions (`'.pdf'`).\n *\n * @param file - File to check\n * @param accept - Comma-separated string of accepted patterns (e.g. `'image/*, .pdf'`)\n * @internal\n */\nexport function isAcceptedFile(file: File, accept: string): boolean {\n  if (accept === '*') {\n    return true;\n  }\n\n  const patterns = accept.split(',').map(s => s.trim());\n\n  if (patterns.length === 0) {\n    return true;\n  }\n\n  return patterns.some(pattern => {\n    if (pattern.startsWith('.')) {\n      return file.name.toLowerCase().endsWith(pattern.toLowerCase());\n    }\n\n    if (pattern.endsWith('/*')) {\n      return file.type.startsWith(pattern.slice(0, -1));\n    }\n\n    return file.type === pattern;\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/forms/cva/index.d.ts

@@ -1,7 +1,16 @@
 import { type Signal, type WritableSignal } from '@angular/core';
 import { type ValidationErrors } from '@angular/forms';
 import type { WithInjector } from '@signality/core/types';
-export type CvaOptions<T> = Omit<Partial<MakeWritable<CvaRef<T>>>, 'value'> & Pick<CvaRef<T>, 'value'> & WithInjector;
+export interface CvaOptions<T> extends WithInjector {
+    readonly value: WritableSignal<T>;
+    readonly touched?: WritableSignal<boolean>;
+    readonly disabled?: WritableSignal<boolean>;
+    readonly required?: WritableSignal<boolean>;
+    readonly invalid?: WritableSignal<boolean>;
+    readonly pending?: WritableSignal<boolean>;
+    readonly dirty?: WritableSignal<boolean>;
+    readonly errors?: WritableSignal<ValidationErrors | null>;
+}
 export interface CvaRef<T> {
     readonly value: WritableSignal<T>;
     readonly touched: WritableSignal<boolean>;
@@ -54,7 +63,3 @@ export interface CvaRef<T> {
  * ```
  */
 export declare function cva<T>(options: CvaOptions<T>): CvaRef<T>;
-type MakeWritable<T extends object> = {
-    [K in keyof T]: T[K] extends Signal<infer U> ? WritableSignal<U> : never;
-};
-export {};

package/internal/utils/index.d.ts

@@ -3,6 +3,7 @@ export * from './dom';
 export * from './assert';
 export * from './context';
 export * from './create-token';
+export * from './wait-for-value';
 export * from './is-query-signal';
 export * from './is-plain-object';
 export * from './const-signal';

package/internal/utils/wait-for-value.d.ts

@@ -0,0 +1,6 @@
+import { type Injector, type Signal } from '@angular/core';
+/**
+ * Resolves the first available value of a signal as a Promise.
+ * @internal
+ */
+export declare function waitForValue<T>(source: Signal<T>, injector?: Injector): Promise<T>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signality/core",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "license": "MIT",
   "author": "Vyacheslav Borodin <https://github.com/vs-borodin>",
   "description": "A foundational toolkit for Angular Signals",
@@ -104,6 +104,10 @@
       "types": "./browser/clipboard/index.d.ts",
       "default": "./fesm2022/signality-core-browser-clipboard.mjs"
     },
+    "./browser/device-pixel-ratio": {
+      "types": "./browser/device-pixel-ratio/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-device-pixel-ratio.mjs"
+    },
     "./browser/device-posture": {
       "types": "./browser/device-posture/index.d.ts",
       "default": "./fesm2022/signality-core-browser-device-posture.mjs"