@signality/core 0.1.2 → 0.1.3

package/fesm2022/signality-core-reactivity-debounced.mjs

@@ -1,5 +1,6 @@
 import { signal, isSignal } from '@angular/core';
-import { setupContext, toValue, proxySignal } from '@signality/core/internal';
+import { setupContext, proxySignal } from '@signality/core/internal';
+import { toValue } from '@signality/core/utilities';
 import { debounceCallback } from '@signality/core/scheduling/debounce-callback';
 import { watcher } from '@signality/core/reactivity/watcher';
 

package/fesm2022/signality-core-reactivity-debounced.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"signality-core-reactivity-debounced.mjs","sources":["../../../projects/core/reactivity/debounced/index.ts","../../../projects/core/reactivity/debounced/signality-core-reactivity-debounced.ts"],"sourcesContent":["import {\n  type CreateSignalOptions,\n  isSignal,\n  signal,\n  type Signal,\n  type WritableSignal,\n} from '@angular/core';\nimport { proxySignal, setupContext, toValue } from '@signality/core/internal';\nimport type { MaybeSignal, SignalValue, WithInjector } from '@signality/core/types';\nimport { debounceCallback } from '@signality/core/scheduling/debounce-callback';\nimport { watcher } from '@signality/core/reactivity/watcher';\n\nexport type DebouncedOptions<T> = CreateSignalOptions<T> & WithInjector;\n\n/**\n * Creates a debounced readonly signal from a source signal.\n * Updates to the source signal are debounced before propagating to the returned signal.\n *\n * @param source - Source signal to debounce\n * @param timeMs - Debounce delay in milliseconds\n * @param options - Optional configuration including signal options and injector\n * @returns A readonly signal that updates after the debounce delay\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <input [(ngModel)]=\"query\" />\n *     <p>Debounced value: {{ debouncedQuery() }}</p>\n *   `\n * })\n * export class SearchInput {\n *   readonly query = signal('');\n *   readonly debouncedQuery = debounced(this.query, 300);\n * }\n * ```\n */\nexport function debounced<S extends Signal<any>>(\n  source: S,\n  timeMs: MaybeSignal<number>,\n  options?: DebouncedOptions<SignalValue<S>>\n): Signal<SignalValue<S>>;\n\n/**\n * Creates a debounced writable signal from an initial value.\n * Both `set()` and `update()` calls are debounced.\n *\n * @param value - Initial value\n * @param timeMs - Debounce delay in milliseconds\n * @param options - Optional configuration including signal options and injector\n * @returns A writable signal where updates are debounced\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <input [(ngModel)]=\"query\" />\n *     <p>Search results for: {{ query() }}</p>\n *   `\n * })\n * export class SearchInput {\n *   readonly query = debounced('', 300);\n * }\n * ```\n */\nexport function debounced<V>(\n  value: V,\n  timeMs: MaybeSignal<number>,\n  options?: DebouncedOptions<V>\n): WritableSignal<V>;\n\nexport function debounced(\n  valueOrSignal: any,\n  timeMs: MaybeSignal<number>,\n  options?: DebouncedOptions<any>\n) {\n  const { runInContext } = setupContext(options?.injector, debounced);\n\n  return runInContext(() => {\n    const initialValue = toValue(valueOrSignal);\n    const output = signal(initialValue, options);\n    const set = debounceCallback(output.set, timeMs);\n\n    if (isSignal(valueOrSignal)) {\n      watcher(valueOrSignal, set);\n      return output.asReadonly();\n    } else {\n      return proxySignal(output, { set });\n    }\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;SAuEgB,SAAS,CACvB,aAAkB,EAClB,MAA2B,EAC3B,OAA+B,EAAA;AAE/B,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC;IAEnE,OAAO,YAAY,CAAC,MAAK;AACvB,QAAA,MAAM,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC;QAC5C,MAAM,GAAG,GAAG,gBAAgB,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC;AAEhD,QAAA,IAAI,QAAQ,CAAC,aAAa,CAAC,EAAE;AAC3B,YAAA,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;AAC3B,YAAA,OAAO,MAAM,CAAC,UAAU,EAAE;QAC5B;aAAO;YACL,OAAO,WAAW,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC;QACrC;AACF,IAAA,CAAC,CAAC;AACJ;;AC1FA;;AAEG;;;;"}
+{"version":3,"file":"signality-core-reactivity-debounced.mjs","sources":["../../../projects/core/reactivity/debounced/index.ts","../../../projects/core/reactivity/debounced/signality-core-reactivity-debounced.ts"],"sourcesContent":["import {\n  type CreateSignalOptions,\n  isSignal,\n  signal,\n  type Signal,\n  type WritableSignal,\n} from '@angular/core';\nimport { proxySignal, setupContext } from '@signality/core/internal';\nimport { toValue } from '@signality/core/utilities';\nimport type { MaybeSignal, SignalValue, WithInjector } from '@signality/core/types';\nimport { debounceCallback } from '@signality/core/scheduling/debounce-callback';\nimport { watcher } from '@signality/core/reactivity/watcher';\n\nexport type DebouncedOptions<T> = CreateSignalOptions<T> & WithInjector;\n\n/**\n * Creates a debounced readonly signal from a source signal.\n * Updates to the source signal are debounced before propagating to the returned signal.\n *\n * @param source - Source signal to debounce\n * @param timeMs - Debounce delay in milliseconds\n * @param options - Optional configuration including signal options and injector\n * @returns A readonly signal that updates after the debounce delay\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <input [(ngModel)]=\"query\" />\n *     <p>Debounced value: {{ debouncedQuery() }}</p>\n *   `\n * })\n * export class SearchInput {\n *   readonly query = signal('');\n *   readonly debouncedQuery = debounced(this.query, 300);\n * }\n * ```\n */\nexport function debounced<S extends Signal<any>>(\n  source: S,\n  timeMs: MaybeSignal<number>,\n  options?: DebouncedOptions<SignalValue<S>>\n): Signal<SignalValue<S>>;\n\n/**\n * Creates a debounced writable signal from an initial value.\n * Both `set()` and `update()` calls are debounced.\n *\n * @param value - Initial value\n * @param timeMs - Debounce delay in milliseconds\n * @param options - Optional configuration including signal options and injector\n * @returns A writable signal where updates are debounced\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <input [(ngModel)]=\"query\" />\n *     <p>Search results for: {{ query() }}</p>\n *   `\n * })\n * export class SearchInput {\n *   readonly query = debounced('', 300);\n * }\n * ```\n */\nexport function debounced<V>(\n  value: V,\n  timeMs: MaybeSignal<number>,\n  options?: DebouncedOptions<V>\n): WritableSignal<V>;\n\nexport function debounced(\n  valueOrSignal: any,\n  timeMs: MaybeSignal<number>,\n  options?: DebouncedOptions<any>\n) {\n  const { runInContext } = setupContext(options?.injector, debounced);\n\n  return runInContext(() => {\n    const initialValue = toValue(valueOrSignal);\n    const output = signal(initialValue, options);\n    const set = debounceCallback(output.set, timeMs);\n\n    if (isSignal(valueOrSignal)) {\n      watcher(valueOrSignal, set);\n      return output.asReadonly();\n    } else {\n      return proxySignal(output, { set });\n    }\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;SAwEgB,SAAS,CACvB,aAAkB,EAClB,MAA2B,EAC3B,OAA+B,EAAA;AAE/B,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC;IAEnE,OAAO,YAAY,CAAC,MAAK;AACvB,QAAA,MAAM,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC;QAC5C,MAAM,GAAG,GAAG,gBAAgB,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC;AAEhD,QAAA,IAAI,QAAQ,CAAC,aAAa,CAAC,EAAE;AAC3B,YAAA,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;AAC3B,YAAA,OAAO,MAAM,CAAC,UAAU,EAAE;QAC5B;aAAO;YACL,OAAO,WAAW,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC;QACrC;AACF,IAAA,CAAC,CAAC;AACJ;;AC3FA;;AAEG;;;;"}

package/fesm2022/signality-core-reactivity-throttled.mjs

@@ -1,5 +1,6 @@
 import { signal, isSignal } from '@angular/core';
-import { setupContext, toValue, proxySignal } from '@signality/core/internal';
+import { setupContext, proxySignal } from '@signality/core/internal';
+import { toValue } from '@signality/core/utilities';
 import { throttleCallback } from '@signality/core/scheduling/throttle-callback';
 import { watcher } from '@signality/core/reactivity/watcher';
 

package/fesm2022/signality-core-reactivity-throttled.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"signality-core-reactivity-throttled.mjs","sources":["../../../projects/core/reactivity/throttled/index.ts","../../../projects/core/reactivity/throttled/signality-core-reactivity-throttled.ts"],"sourcesContent":["import {\n  type CreateSignalOptions,\n  isSignal,\n  signal,\n  type Signal,\n  type WritableSignal,\n} from '@angular/core';\nimport { proxySignal, setupContext, toValue } from '@signality/core/internal';\nimport type { MaybeSignal, SignalValue, WithInjector } from '@signality/core/types';\nimport { throttleCallback } from '@signality/core/scheduling/throttle-callback';\nimport { watcher } from '@signality/core/reactivity/watcher';\n\nexport type ThrottledOptions<T> = CreateSignalOptions<T> & WithInjector;\n\n/**\n * Creates a throttled readonly signal from a source signal.\n * Updates to the source signal are throttled to occur at most once per time interval.\n *\n * @param source - Source signal to throttle\n * @param timeMs - Throttle interval in milliseconds\n * @param options - Optional configuration including signal options and injector\n * @returns A readonly signal that updates at most once per throttle interval\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <div (scroll)=\"scrollY.set($event.target.scrollTop)\">\n *       <p>Scroll position: {{ scrollY() }}</p>\n *       <p>Throttled position: {{ throttledScrollY() }}</p>\n *     </div>\n *   `\n * })\n * export class ScrollTracker {\n *   readonly scrollY = signal(0);\n *   readonly throttledScrollY = throttled(this.scrollY, 100);\n * }\n * ```\n */\nexport function throttled<S extends Signal<any>>(\n  source: S,\n  timeMs: MaybeSignal<number>,\n  options?: ThrottledOptions<SignalValue<S>>\n): Signal<SignalValue<S>>;\n\n/**\n * Creates a throttled writable signal from an initial value.\n * Both `set()` and `update()` calls are throttled.\n *\n * @param value - Initial value\n * @param timeMs - Throttle interval in milliseconds\n * @param options - Optional configuration including signal options and injector\n * @returns A writable signal where updates are throttled\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <div (mousemove)=\"mousePosition.set({ x: $event.clientX, y: $event.clientY })\">\n *       <p>Mouse position: X={{ mousePosition().x }}, Y={{ mousePosition().y }}</p>\n *     </div>\n *   `\n * })\n * export class MouseTracker {\n *   readonly mousePosition = throttled({ x: 0, y: 0 }, 16);\n * }\n * ```\n */\nexport function throttled<V>(\n  value: V,\n  timeMs: MaybeSignal<number>,\n  options?: ThrottledOptions<V>\n): WritableSignal<V>;\n\nexport function throttled(\n  valueOrSignal: any,\n  timeMs: MaybeSignal<number>,\n  options?: ThrottledOptions<any>\n) {\n  const { runInContext } = setupContext(options?.injector, throttled);\n\n  return runInContext(() => {\n    const initialValue = toValue(valueOrSignal);\n    const output = signal(initialValue, options);\n    const set = throttleCallback(output.set, timeMs);\n\n    if (isSignal(valueOrSignal)) {\n      watcher(valueOrSignal, set);\n      return output.asReadonly();\n    } else {\n      return proxySignal(output, { set });\n    }\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;SA0EgB,SAAS,CACvB,aAAkB,EAClB,MAA2B,EAC3B,OAA+B,EAAA;AAE/B,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC;IAEnE,OAAO,YAAY,CAAC,MAAK;AACvB,QAAA,MAAM,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC;QAC5C,MAAM,GAAG,GAAG,gBAAgB,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC;AAEhD,QAAA,IAAI,QAAQ,CAAC,aAAa,CAAC,EAAE;AAC3B,YAAA,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;AAC3B,YAAA,OAAO,MAAM,CAAC,UAAU,EAAE;QAC5B;aAAO;YACL,OAAO,WAAW,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC;QACrC;AACF,IAAA,CAAC,CAAC;AACJ;;AC7FA;;AAEG;;;;"}
+{"version":3,"file":"signality-core-reactivity-throttled.mjs","sources":["../../../projects/core/reactivity/throttled/index.ts","../../../projects/core/reactivity/throttled/signality-core-reactivity-throttled.ts"],"sourcesContent":["import {\n  type CreateSignalOptions,\n  isSignal,\n  signal,\n  type Signal,\n  type WritableSignal,\n} from '@angular/core';\nimport { proxySignal, setupContext } from '@signality/core/internal';\nimport { toValue } from '@signality/core/utilities';\nimport type { MaybeSignal, SignalValue, WithInjector } from '@signality/core/types';\nimport { throttleCallback } from '@signality/core/scheduling/throttle-callback';\nimport { watcher } from '@signality/core/reactivity/watcher';\n\nexport type ThrottledOptions<T> = CreateSignalOptions<T> & WithInjector;\n\n/**\n * Creates a throttled readonly signal from a source signal.\n * Updates to the source signal are throttled to occur at most once per time interval.\n *\n * @param source - Source signal to throttle\n * @param timeMs - Throttle interval in milliseconds\n * @param options - Optional configuration including signal options and injector\n * @returns A readonly signal that updates at most once per throttle interval\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <div (scroll)=\"scrollY.set($event.target.scrollTop)\">\n *       <p>Scroll position: {{ scrollY() }}</p>\n *       <p>Throttled position: {{ throttledScrollY() }}</p>\n *     </div>\n *   `\n * })\n * export class ScrollTracker {\n *   readonly scrollY = signal(0);\n *   readonly throttledScrollY = throttled(this.scrollY, 100);\n * }\n * ```\n */\nexport function throttled<S extends Signal<any>>(\n  source: S,\n  timeMs: MaybeSignal<number>,\n  options?: ThrottledOptions<SignalValue<S>>\n): Signal<SignalValue<S>>;\n\n/**\n * Creates a throttled writable signal from an initial value.\n * Both `set()` and `update()` calls are throttled.\n *\n * @param value - Initial value\n * @param timeMs - Throttle interval in milliseconds\n * @param options - Optional configuration including signal options and injector\n * @returns A writable signal where updates are throttled\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <div (mousemove)=\"mousePosition.set({ x: $event.clientX, y: $event.clientY })\">\n *       <p>Mouse position: X={{ mousePosition().x }}, Y={{ mousePosition().y }}</p>\n *     </div>\n *   `\n * })\n * export class MouseTracker {\n *   readonly mousePosition = throttled({ x: 0, y: 0 }, 16);\n * }\n * ```\n */\nexport function throttled<V>(\n  value: V,\n  timeMs: MaybeSignal<number>,\n  options?: ThrottledOptions<V>\n): WritableSignal<V>;\n\nexport function throttled(\n  valueOrSignal: any,\n  timeMs: MaybeSignal<number>,\n  options?: ThrottledOptions<any>\n) {\n  const { runInContext } = setupContext(options?.injector, throttled);\n\n  return runInContext(() => {\n    const initialValue = toValue(valueOrSignal);\n    const output = signal(initialValue, options);\n    const set = throttleCallback(output.set, timeMs);\n\n    if (isSignal(valueOrSignal)) {\n      watcher(valueOrSignal, set);\n      return output.asReadonly();\n    } else {\n      return proxySignal(output, { set });\n    }\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;SA2EgB,SAAS,CACvB,aAAkB,EAClB,MAA2B,EAC3B,OAA+B,EAAA;AAE/B,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC;IAEnE,OAAO,YAAY,CAAC,MAAK;AACvB,QAAA,MAAM,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC;QAC5C,MAAM,GAAG,GAAG,gBAAgB,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC;AAEhD,QAAA,IAAI,QAAQ,CAAC,aAAa,CAAC,EAAE;AAC3B,YAAA,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;AAC3B,YAAA,OAAO,MAAM,CAAC,UAAU,EAAE;QAC5B;aAAO;YACL,OAAO,WAAW,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC;QACrC;AACF,IAAA,CAAC,CAAC;AACJ;;AC9FA;;AAEG;;;;"}

package/fesm2022/signality-core-scheduling-debounce-callback.mjs

@@ -1,4 +1,5 @@
-import { setupContext, toValue } from '@signality/core/internal';
+import { setupContext } from '@signality/core/internal';
+import { toValue } from '@signality/core/utilities';
 
 /**
  * Creates a debounced version of a callback function.

package/fesm2022/signality-core-scheduling-debounce-callback.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"signality-core-scheduling-debounce-callback.mjs","sources":["../../../projects/core/scheduling/debounce-callback/index.ts","../../../projects/core/scheduling/debounce-callback/signality-core-scheduling-debounce-callback.ts"],"sourcesContent":["import type { MaybeSignal, WithInjector } from '@signality/core/types';\nimport { setupContext, type Timer, toValue } from '@signality/core/internal';\n\n/**\n * Creates a debounced version of a callback function.\n * The callback will only be executed after the specified wait time has elapsed since the last invocation.\n *\n * @param callback - The function to debounce\n * @param wait - Debounce delay in milliseconds (can be a reactive signal)\n * @param options - Optional configuration including injector\n * @returns A debounced version of the callback function\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <input (input)=\"handleInput($event.target.value)\" />\n *   `,\n * })\n * export class SearchInput {\n *   readonly debounceTime = input(300);\n *   readonly searchChange = output<string>();\n *\n *   readonly handleInput = debounceCallback(value => {\n *     this.searchChange.emit(value);\n *   }, this.debounceTime);\n * }\n * ```\n */\nexport function debounceCallback<T extends (...args: any[]) => any>(\n  callback: T,\n  wait: MaybeSignal<number>,\n  options?: WithInjector\n): T {\n  const { runInContext } = setupContext(options?.injector, debounceCallback);\n\n  return runInContext(({ isServer, onCleanup }) => {\n    if (isServer) {\n      return callback;\n    }\n\n    let timer: Timer;\n\n    onCleanup(() => {\n      if (timer !== undefined) {\n        clearTimeout(timer);\n      }\n    });\n\n    return new Proxy(callback, {\n      apply(target, thisArg, args) {\n        if (timer !== undefined) {\n          clearTimeout(timer);\n        }\n        timer = setTimeout(() => {\n          target.apply(thisArg, args);\n        }, toValue.untracked(wait));\n      },\n    });\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;AAGA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;SACa,gBAAgB,CAC9B,QAAW,EACX,IAAyB,EACzB,OAAsB,EAAA;AAEtB,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,CAAC;IAE1E,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAI;QAC9C,IAAI,QAAQ,EAAE;AACZ,YAAA,OAAO,QAAQ;QACjB;AAEA,QAAA,IAAI,KAAY;QAEhB,SAAS,CAAC,MAAK;AACb,YAAA,IAAI,KAAK,KAAK,SAAS,EAAE;gBACvB,YAAY,CAAC,KAAK,CAAC;YACrB;AACF,QAAA,CAAC,CAAC;AAEF,QAAA,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE;AACzB,YAAA,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAA;AACzB,gBAAA,IAAI,KAAK,KAAK,SAAS,EAAE;oBACvB,YAAY,CAAC,KAAK,CAAC;gBACrB;AACA,gBAAA,KAAK,GAAG,UAAU,CAAC,MAAK;AACtB,oBAAA,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC;gBAC7B,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;AACF,SAAA,CAAC;AACJ,IAAA,CAAC,CAAC;AACJ;;AC5DA;;AAEG;;;;"}
+{"version":3,"file":"signality-core-scheduling-debounce-callback.mjs","sources":["../../../projects/core/scheduling/debounce-callback/index.ts","../../../projects/core/scheduling/debounce-callback/signality-core-scheduling-debounce-callback.ts"],"sourcesContent":["import type { MaybeSignal, WithInjector } from '@signality/core/types';\nimport { setupContext, type Timer } from '@signality/core/internal';\nimport { toValue } from '@signality/core/utilities';\n\n/**\n * Creates a debounced version of a callback function.\n * The callback will only be executed after the specified wait time has elapsed since the last invocation.\n *\n * @param callback - The function to debounce\n * @param wait - Debounce delay in milliseconds (can be a reactive signal)\n * @param options - Optional configuration including injector\n * @returns A debounced version of the callback function\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <input (input)=\"handleInput($event.target.value)\" />\n *   `,\n * })\n * export class SearchInput {\n *   readonly debounceTime = input(300);\n *   readonly searchChange = output<string>();\n *\n *   readonly handleInput = debounceCallback(value => {\n *     this.searchChange.emit(value);\n *   }, this.debounceTime);\n * }\n * ```\n */\nexport function debounceCallback<T extends (...args: any[]) => any>(\n  callback: T,\n  wait: MaybeSignal<number>,\n  options?: WithInjector\n): T {\n  const { runInContext } = setupContext(options?.injector, debounceCallback);\n\n  return runInContext(({ isServer, onCleanup }) => {\n    if (isServer) {\n      return callback;\n    }\n\n    let timer: Timer;\n\n    onCleanup(() => {\n      if (timer !== undefined) {\n        clearTimeout(timer);\n      }\n    });\n\n    return new Proxy(callback, {\n      apply(target, thisArg, args) {\n        if (timer !== undefined) {\n          clearTimeout(timer);\n        }\n        timer = setTimeout(() => {\n          target.apply(thisArg, args);\n        }, toValue.untracked(wait));\n      },\n    });\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;AAIA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;SACa,gBAAgB,CAC9B,QAAW,EACX,IAAyB,EACzB,OAAsB,EAAA;AAEtB,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,CAAC;IAE1E,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAI;QAC9C,IAAI,QAAQ,EAAE;AACZ,YAAA,OAAO,QAAQ;QACjB;AAEA,QAAA,IAAI,KAAY;QAEhB,SAAS,CAAC,MAAK;AACb,YAAA,IAAI,KAAK,KAAK,SAAS,EAAE;gBACvB,YAAY,CAAC,KAAK,CAAC;YACrB;AACF,QAAA,CAAC,CAAC;AAEF,QAAA,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE;AACzB,YAAA,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAA;AACzB,gBAAA,IAAI,KAAK,KAAK,SAAS,EAAE;oBACvB,YAAY,CAAC,KAAK,CAAC;gBACrB;AACA,gBAAA,KAAK,GAAG,UAAU,CAAC,MAAK;AACtB,oBAAA,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC;gBAC7B,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;AACF,SAAA,CAAC;AACJ,IAAA,CAAC,CAAC;AACJ;;AC7DA;;AAEG;;;;"}

package/fesm2022/signality-core-scheduling-interval.mjs

@@ -1,5 +1,6 @@
 import { isSignal } from '@angular/core';
-import { setupContext, NOOP_EFFECT_REF, toValue } from '@signality/core/internal';
+import { setupContext, NOOP_EFFECT_REF } from '@signality/core/internal';
+import { toValue } from '@signality/core/utilities';
 import { watcher } from '@signality/core/reactivity/watcher';
 
 /**

package/fesm2022/signality-core-scheduling-interval.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"signality-core-scheduling-interval.mjs","sources":["../../../projects/core/scheduling/interval/index.ts","../../../projects/core/scheduling/interval/signality-core-scheduling-interval.ts"],"sourcesContent":["import { isSignal } from '@angular/core';\nimport { NOOP_EFFECT_REF, setupContext, type Timer, toValue } from '@signality/core/internal';\nimport type { MaybeSignal, WithInjector } from '@signality/core/types';\nimport { watcher, type WatcherRef } from '@signality/core/reactivity/watcher';\n\nexport interface IntervalOptions extends WithInjector {\n  /**\n   * Call the callback immediately, without waiting for the first tick.\n   *\n   * @default false\n   */\n  readonly immediate?: boolean;\n}\n\nexport interface IntervalRef {\n  /**\n   * Stop the interval permanently.\n   */\n  readonly destroy: () => void;\n}\n\n/**\n * Signal-based wrapper around [`setInterval`](https://developer.mozilla.org/en-US/docs/Web/API/Window/setInterval).\n * Creates a reactive interval that executes a callback at specified intervals.\n * The interval starts immediately upon creation and can be stopped with `destroy()`.\n *\n * @param callback - Function to execute on each interval tick\n * @param intervalMs - Interval duration in milliseconds (can be a reactive signal)\n * @param options - Optional configuration\n * @returns An IntervalRef with a `destroy` method to stop the interval\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <p>Ticks: {{ ticks() }}</p>\n *     <button (click)=\"polling.destroy()\">Stop</button>\n *   `,\n * })\n * export class PeriodicTask {\n *   readonly ticks = signal(0);\n *\n *   readonly polling = interval(() => {\n *     this.ticks.update(n => n + 1);\n *   }, 5000);\n * }\n * ```\n */\nexport function interval(\n  callback: () => void,\n  intervalMs: MaybeSignal<number>,\n  options?: IntervalOptions\n): IntervalRef {\n  const { runInContext } = setupContext(options?.injector, interval);\n\n  return runInContext(({ isServer, onCleanup }) => {\n    if (isServer) {\n      return NOOP_EFFECT_REF;\n    }\n\n    let intervalId: Timer;\n    let watcherRef: WatcherRef | null = null;\n\n    const start = () => {\n      clearInterval(intervalId);\n\n      const ms = toValue.untracked(intervalMs);\n      intervalId = ms > 0 ? setInterval(callback, ms) : undefined;\n    };\n\n    if (isSignal(intervalMs)) {\n      watcherRef = watcher(intervalMs, start);\n    }\n\n    const destroy = () => {\n      clearInterval(intervalId);\n      intervalId = undefined;\n      watcherRef?.destroy();\n    };\n\n    onCleanup(destroy);\n\n    if (options?.immediate) {\n      callback();\n    }\n\n    start();\n\n    return { destroy };\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAqBA;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BG;SACa,QAAQ,CACtB,QAAoB,EACpB,UAA+B,EAC/B,OAAyB,EAAA;AAEzB,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAElE,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAI;QAC9C,IAAI,QAAQ,EAAE;AACZ,YAAA,OAAO,eAAe;QACxB;AAEA,QAAA,IAAI,UAAiB;QACrB,IAAI,UAAU,GAAsB,IAAI;QAExC,MAAM,KAAK,GAAG,MAAK;YACjB,aAAa,CAAC,UAAU,CAAC;YAEzB,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC;AACxC,YAAA,UAAU,GAAG,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,SAAS;AAC7D,QAAA,CAAC;AAED,QAAA,IAAI,QAAQ,CAAC,UAAU,CAAC,EAAE;AACxB,YAAA,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;QACzC;QAEA,MAAM,OAAO,GAAG,MAAK;YACnB,aAAa,CAAC,UAAU,CAAC;YACzB,UAAU,GAAG,SAAS;YACtB,UAAU,EAAE,OAAO,EAAE;AACvB,QAAA,CAAC;QAED,SAAS,CAAC,OAAO,CAAC;AAElB,QAAA,IAAI,OAAO,EAAE,SAAS,EAAE;AACtB,YAAA,QAAQ,EAAE;QACZ;AAEA,QAAA,KAAK,EAAE;QAEP,OAAO,EAAE,OAAO,EAAE;AACpB,IAAA,CAAC,CAAC;AACJ;;AC1FA;;AAEG;;;;"}
+{"version":3,"file":"signality-core-scheduling-interval.mjs","sources":["../../../projects/core/scheduling/interval/index.ts","../../../projects/core/scheduling/interval/signality-core-scheduling-interval.ts"],"sourcesContent":["import { isSignal } from '@angular/core';\nimport { NOOP_EFFECT_REF, setupContext, type Timer } from '@signality/core/internal';\nimport { toValue } from '@signality/core/utilities';\nimport type { MaybeSignal, WithInjector } from '@signality/core/types';\nimport { watcher, type WatcherRef } from '@signality/core/reactivity/watcher';\n\nexport interface IntervalOptions extends WithInjector {\n  /**\n   * Call the callback immediately, without waiting for the first tick.\n   *\n   * @default false\n   */\n  readonly immediate?: boolean;\n}\n\nexport interface IntervalRef {\n  /**\n   * Stop the interval permanently.\n   */\n  readonly destroy: () => void;\n}\n\n/**\n * Signal-based wrapper around [`setInterval`](https://developer.mozilla.org/en-US/docs/Web/API/Window/setInterval).\n * Creates a reactive interval that executes a callback at specified intervals.\n * The interval starts immediately upon creation and can be stopped with `destroy()`.\n *\n * @param callback - Function to execute on each interval tick\n * @param intervalMs - Interval duration in milliseconds (can be a reactive signal)\n * @param options - Optional configuration\n * @returns An IntervalRef with a `destroy` method to stop the interval\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <p>Ticks: {{ ticks() }}</p>\n *     <button (click)=\"polling.destroy()\">Stop</button>\n *   `,\n * })\n * export class PeriodicTask {\n *   readonly ticks = signal(0);\n *\n *   readonly polling = interval(() => {\n *     this.ticks.update(n => n + 1);\n *   }, 5000);\n * }\n * ```\n */\nexport function interval(\n  callback: () => void,\n  intervalMs: MaybeSignal<number>,\n  options?: IntervalOptions\n): IntervalRef {\n  const { runInContext } = setupContext(options?.injector, interval);\n\n  return runInContext(({ isServer, onCleanup }) => {\n    if (isServer) {\n      return NOOP_EFFECT_REF;\n    }\n\n    let intervalId: Timer;\n    let watcherRef: WatcherRef | null = null;\n\n    const start = () => {\n      clearInterval(intervalId);\n\n      const ms = toValue.untracked(intervalMs);\n      intervalId = ms > 0 ? setInterval(callback, ms) : undefined;\n    };\n\n    if (isSignal(intervalMs)) {\n      watcherRef = watcher(intervalMs, start);\n    }\n\n    const destroy = () => {\n      clearInterval(intervalId);\n      intervalId = undefined;\n      watcherRef?.destroy();\n    };\n\n    onCleanup(destroy);\n\n    if (options?.immediate) {\n      callback();\n    }\n\n    start();\n\n    return { destroy };\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;AAsBA;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BG;SACa,QAAQ,CACtB,QAAoB,EACpB,UAA+B,EAC/B,OAAyB,EAAA;AAEzB,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAElE,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAI;QAC9C,IAAI,QAAQ,EAAE;AACZ,YAAA,OAAO,eAAe;QACxB;AAEA,QAAA,IAAI,UAAiB;QACrB,IAAI,UAAU,GAAsB,IAAI;QAExC,MAAM,KAAK,GAAG,MAAK;YACjB,aAAa,CAAC,UAAU,CAAC;YAEzB,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC;AACxC,YAAA,UAAU,GAAG,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,SAAS;AAC7D,QAAA,CAAC;AAED,QAAA,IAAI,QAAQ,CAAC,UAAU,CAAC,EAAE;AACxB,YAAA,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;QACzC;QAEA,MAAM,OAAO,GAAG,MAAK;YACnB,aAAa,CAAC,UAAU,CAAC;YACzB,UAAU,GAAG,SAAS;YACtB,UAAU,EAAE,OAAO,EAAE;AACvB,QAAA,CAAC;QAED,SAAS,CAAC,OAAO,CAAC;AAElB,QAAA,IAAI,OAAO,EAAE,SAAS,EAAE;AACtB,YAAA,QAAQ,EAAE;QACZ;AAEA,QAAA,KAAK,EAAE;QAEP,OAAO,EAAE,OAAO,EAAE;AACpB,IAAA,CAAC,CAAC;AACJ;;AC3FA;;AAEG;;;;"}

package/fesm2022/signality-core-scheduling-throttle-callback.mjs

@@ -1,4 +1,5 @@
-import { setupContext, toValue } from '@signality/core/internal';
+import { setupContext } from '@signality/core/internal';
+import { toValue } from '@signality/core/utilities';
 
 /**
  * Creates a throttled version of a callback function.

package/fesm2022/signality-core-scheduling-throttle-callback.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"signality-core-scheduling-throttle-callback.mjs","sources":["../../../projects/core/scheduling/throttle-callback/index.ts","../../../projects/core/scheduling/throttle-callback/signality-core-scheduling-throttle-callback.ts"],"sourcesContent":["import type { MaybeSignal, WithInjector } from '@signality/core/types';\nimport { setupContext, type Timer, toValue } from '@signality/core/internal';\n\n/**\n * Creates a throttled version of a callback function.\n * The callback will be executed at most once per specified wait interval.\n *\n * @param callback - The function to throttle\n * @param wait - Throttle interval in milliseconds (can be a reactive signal)\n * @param options - Optional configuration including injector\n * @returns A throttled version of the callback function\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <div (scroll)=\"handleScroll($event)\">\n *       Scrollable content\n *     </div>\n *   `,\n * })\n * export class ScrollComponent {\n *   readonly throttleTime = input(300);\n *   readonly scrollChange = output<Event>();\n *\n *   readonly handleScroll = throttleCallback(e => {\n *     this.scrollChange.emit(e);\n *   }, this.throttleTime);\n * }\n * ```\n */\nexport function throttleCallback<T extends (...args: any[]) => any>(\n  callback: T,\n  wait: MaybeSignal<number>,\n  options?: WithInjector\n): T {\n  const { runInContext } = setupContext(options?.injector, throttleCallback);\n\n  return runInContext(({ isServer, onCleanup }) => {\n    if (isServer) {\n      return callback;\n    }\n\n    let timer: Timer;\n    let isThrottled: boolean;\n    let lastArgs: Parameters<T>;\n\n    onCleanup(() => {\n      if (timer !== undefined) {\n        clearTimeout(timer);\n      }\n    });\n\n    return new Proxy(callback, {\n      apply(target, thisArg, args) {\n        lastArgs = args as Parameters<T>;\n\n        if (isThrottled) {\n          return;\n        }\n\n        target.apply(thisArg, lastArgs);\n        isThrottled = true;\n\n        timer = setTimeout(() => {\n          isThrottled = false;\n        }, toValue.untracked(wait));\n      },\n    });\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BG;SACa,gBAAgB,CAC9B,QAAW,EACX,IAAyB,EACzB,OAAsB,EAAA;AAEtB,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,CAAC;IAE1E,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAI;QAC9C,IAAI,QAAQ,EAAE;AACZ,YAAA,OAAO,QAAQ;QACjB;AAEA,QAAA,IAAI,KAAY;AAChB,QAAA,IAAI,WAAoB;AACxB,QAAA,IAAI,QAAuB;QAE3B,SAAS,CAAC,MAAK;AACb,YAAA,IAAI,KAAK,KAAK,SAAS,EAAE;gBACvB,YAAY,CAAC,KAAK,CAAC;YACrB;AACF,QAAA,CAAC,CAAC;AAEF,QAAA,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE;AACzB,YAAA,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAA;gBACzB,QAAQ,GAAG,IAAqB;gBAEhC,IAAI,WAAW,EAAE;oBACf;gBACF;AAEA,gBAAA,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC;gBAC/B,WAAW,GAAG,IAAI;AAElB,gBAAA,KAAK,GAAG,UAAU,CAAC,MAAK;oBACtB,WAAW,GAAG,KAAK;gBACrB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;AACF,SAAA,CAAC;AACJ,IAAA,CAAC,CAAC;AACJ;;ACtEA;;AAEG;;;;"}
+{"version":3,"file":"signality-core-scheduling-throttle-callback.mjs","sources":["../../../projects/core/scheduling/throttle-callback/index.ts","../../../projects/core/scheduling/throttle-callback/signality-core-scheduling-throttle-callback.ts"],"sourcesContent":["import type { MaybeSignal, WithInjector } from '@signality/core/types';\nimport { setupContext, type Timer } from '@signality/core/internal';\nimport { toValue } from '@signality/core/utilities';\n\n/**\n * Creates a throttled version of a callback function.\n * The callback will be executed at most once per specified wait interval.\n *\n * @param callback - The function to throttle\n * @param wait - Throttle interval in milliseconds (can be a reactive signal)\n * @param options - Optional configuration including injector\n * @returns A throttled version of the callback function\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <div (scroll)=\"handleScroll($event)\">\n *       Scrollable content\n *     </div>\n *   `,\n * })\n * export class ScrollComponent {\n *   readonly throttleTime = input(300);\n *   readonly scrollChange = output<Event>();\n *\n *   readonly handleScroll = throttleCallback(e => {\n *     this.scrollChange.emit(e);\n *   }, this.throttleTime);\n * }\n * ```\n */\nexport function throttleCallback<T extends (...args: any[]) => any>(\n  callback: T,\n  wait: MaybeSignal<number>,\n  options?: WithInjector\n): T {\n  const { runInContext } = setupContext(options?.injector, throttleCallback);\n\n  return runInContext(({ isServer, onCleanup }) => {\n    if (isServer) {\n      return callback;\n    }\n\n    let timer: Timer;\n    let isThrottled: boolean;\n    let lastArgs: Parameters<T>;\n\n    onCleanup(() => {\n      if (timer !== undefined) {\n        clearTimeout(timer);\n      }\n    });\n\n    return new Proxy(callback, {\n      apply(target, thisArg, args) {\n        lastArgs = args as Parameters<T>;\n\n        if (isThrottled) {\n          return;\n        }\n\n        target.apply(thisArg, lastArgs);\n        isThrottled = true;\n\n        timer = setTimeout(() => {\n          isThrottled = false;\n        }, toValue.untracked(wait));\n      },\n    });\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BG;SACa,gBAAgB,CAC9B,QAAW,EACX,IAAyB,EACzB,OAAsB,EAAA;AAEtB,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,CAAC;IAE1E,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAI;QAC9C,IAAI,QAAQ,EAAE;AACZ,YAAA,OAAO,QAAQ;QACjB;AAEA,QAAA,IAAI,KAAY;AAChB,QAAA,IAAI,WAAoB;AACxB,QAAA,IAAI,QAAuB;QAE3B,SAAS,CAAC,MAAK;AACb,YAAA,IAAI,KAAK,KAAK,SAAS,EAAE;gBACvB,YAAY,CAAC,KAAK,CAAC;YACrB;AACF,QAAA,CAAC,CAAC;AAEF,QAAA,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE;AACzB,YAAA,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAA;gBACzB,QAAQ,GAAG,IAAqB;gBAEhC,IAAI,WAAW,EAAE;oBACf;gBACF;AAEA,gBAAA,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC;gBAC/B,WAAW,GAAG,IAAI;AAElB,gBAAA,KAAK,GAAG,UAAU,CAAC,MAAK;oBACtB,WAAW,GAAG,KAAK;gBACrB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;AACF,SAAA,CAAC;AACJ,IAAA,CAAC,CAAC;AACJ;;ACvEA;;AAEG;;;;"}

package/fesm2022/signality-core-utilities.mjs

@@ -0,0 +1,64 @@
+import { inject, InjectionToken, isSignal, untracked } from '@angular/core';
+import { setupContext, unrefElement } from '@signality/core/internal';
+
+/**
+ * Creates a unique ID string with optional prefix.
+ *
+ * @param options - Optional configuration with prefix and injector
+ * @returns A unique ID string
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <input [id]="inputId" />
+ *   `
+ * })
+ * export class MyInput {
+ *   readonly inputId = generateId();
+ * }
+ * ```
+ */
+function generateId(options) {
+    const { runInContext } = setupContext(options?.injector, generateId);
+    return runInContext(() => {
+        const factoryFn = inject(GENERATE_ID_FACTORY);
+        return factoryFn(options?.prefix);
+    });
+}
+const GENERATE_ID_FACTORY = new InjectionToken(typeof ngDevMode !== 'undefined' && ngDevMode ? 'GENERATE_ID_FACTORY' : '', {
+    providedIn: 'platform',
+    factory: () => {
+        let i = 0;
+        return (prefix = 'app') => `${prefix}-${Date.now()}${i++}`;
+    },
+});
+
+const toValue = (() => {
+    const fn = toValueFn;
+    fn.untracked = v => toValueFn(v, true);
+    return fn;
+})();
+function toValueFn(maybeSignal, untracked$1 = false) {
+    if (isSignal(maybeSignal)) {
+        return untracked$1 ? untracked(maybeSignal) : maybeSignal();
+    }
+    return maybeSignal;
+}
+
+const toElement = (() => {
+    const fn = toElementFn;
+    fn.untracked = v => toElementFn(v, true);
+    return fn;
+})();
+function toElementFn(maybeSignal, untracked = false) {
+    const raw = untracked ? toValue.untracked(maybeSignal) : toValue(maybeSignal);
+    return unrefElement(raw);
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { GENERATE_ID_FACTORY, generateId, toElement, toValue };
+//# sourceMappingURL=signality-core-utilities.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-utilities.mjs","sources":["../../../projects/core/utilities/generate-id.ts","../../../projects/core/utilities/to-value.ts","../../../projects/core/utilities/to-element.ts","../../../projects/core/utilities/signality-core-utilities.ts"],"sourcesContent":["import { inject, InjectionToken } from '@angular/core';\nimport { setupContext } from '@signality/core/internal';\nimport type { WithInjector } from '@signality/core/types';\n\nexport interface GenerateIdOptions extends WithInjector {\n  /**\n   * Optional prefix for the generated ID.\n   * @default 'app'\n   */\n  readonly prefix?: string;\n}\n\n/**\n * Creates a unique ID string with optional prefix.\n *\n * @param options - Optional configuration with prefix and injector\n * @returns A unique ID string\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <input [id]=\"inputId\" />\n *   `\n * })\n * export class MyInput {\n *   readonly inputId = generateId();\n * }\n * ```\n */\nexport function generateId(options?: GenerateIdOptions): string {\n  const { runInContext } = setupContext(options?.injector, generateId);\n\n  return runInContext(() => {\n    const factoryFn = inject(GENERATE_ID_FACTORY);\n    return factoryFn(options?.prefix);\n  });\n}\n\nexport const GENERATE_ID_FACTORY = new InjectionToken<(prefix?: string) => string>(\n  typeof ngDevMode !== 'undefined' && ngDevMode ? 'GENERATE_ID_FACTORY' : '',\n  {\n    providedIn: 'platform',\n    factory: () => {\n      let i = 0;\n      return (prefix = 'app') => `${prefix}-${Date.now()}${i++}`;\n    },\n  }\n);\n","import { isSignal, untracked as _untracked } from '@angular/core';\nimport type { MaybeSignal } from '@signality/core/types';\n\nexport interface ToValueFn {\n  <T>(maybeSignal: MaybeSignal<T>): T;\n  untracked: <T>(maybeSignal: MaybeSignal<T>) => T;\n}\n\nexport const toValue: ToValueFn = (() => {\n  const fn = toValueFn as ToValueFn;\n  fn.untracked = v => toValueFn(v, true);\n  return fn;\n})();\n\nfunction toValueFn<T>(maybeSignal: MaybeSignal<T>, untracked = false): T {\n  if (isSignal(maybeSignal)) {\n    return untracked ? _untracked(maybeSignal) : maybeSignal();\n  }\n  return maybeSignal;\n}\n","import { type ElementRef, type Signal } from '@angular/core';\nimport { unrefElement } from '@signality/core/internal';\nimport type { MaybeElementSignal } from '@signality/core/types';\nimport { toValue } from './to-value';\n\nexport interface ToElementFn extends ToElementBase {\n  untracked: ToElementBase;\n}\n\nexport interface ToElementBase {\n  <T extends Element>(element: T | ElementRef<T>): T;\n  <T extends Element>(element: Signal<T | ElementRef<T> | null>): T | null;\n  <T extends Element>(element: Signal<T | ElementRef<T> | undefined>): T | undefined;\n  <T extends Element>(element: Signal<T | ElementRef<T> | null | undefined>): T | null | undefined;\n  <T extends Element>(element: T | ElementRef<T> | Signal<T | ElementRef<T> | null | undefined>):\n    | T\n    | null\n    | undefined;\n}\n\nexport const toElement: ToElementFn = (() => {\n  const fn = toElementFn as ToElementFn;\n  fn.untracked = v => toElementFn(v, true);\n  return fn;\n})();\n\nfunction toElementFn<T extends Element>(\n  maybeSignal: MaybeElementSignal<T>,\n  untracked = false\n): T | null | undefined {\n  const raw = untracked ? toValue.untracked(maybeSignal) : toValue(maybeSignal);\n  return unrefElement(raw);\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":["untracked","_untracked"],"mappings":";;;AAYA;;;;;;;;;;;;;;;;;AAiBG;AACG,SAAU,UAAU,CAAC,OAA2B,EAAA;AACpD,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;IAEpE,OAAO,YAAY,CAAC,MAAK;AACvB,QAAA,MAAM,SAAS,GAAG,MAAM,CAAC,mBAAmB,CAAC;AAC7C,QAAA,OAAO,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;AACnC,IAAA,CAAC,CAAC;AACJ;MAEa,mBAAmB,GAAG,IAAI,cAAc,CACnD,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,GAAG,qBAAqB,GAAG,EAAE,EAC1E;AACE,IAAA,UAAU,EAAE,UAAU;IACtB,OAAO,EAAE,MAAK;QACZ,IAAI,CAAC,GAAG,CAAC;AACT,QAAA,OAAO,CAAC,MAAM,GAAG,KAAK,KAAK,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE;IAC5D,CAAC;AACF,CAAA;;ACvCI,MAAM,OAAO,GAAc,CAAC,MAAK;IACtC,MAAM,EAAE,GAAG,SAAsB;AACjC,IAAA,EAAE,CAAC,SAAS,GAAG,CAAC,IAAI,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC;AACtC,IAAA,OAAO,EAAE;AACX,CAAC;AAED,SAAS,SAAS,CAAI,WAA2B,EAAEA,WAAS,GAAG,KAAK,EAAA;AAClE,IAAA,IAAI,QAAQ,CAAC,WAAW,CAAC,EAAE;AACzB,QAAA,OAAOA,WAAS,GAAGC,SAAU,CAAC,WAAW,CAAC,GAAG,WAAW,EAAE;IAC5D;AACA,IAAA,OAAO,WAAW;AACpB;;ACCO,MAAM,SAAS,GAAgB,CAAC,MAAK;IAC1C,MAAM,EAAE,GAAG,WAA0B;AACrC,IAAA,EAAE,CAAC,SAAS,GAAG,CAAC,IAAI,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC;AACxC,IAAA,OAAO,EAAE;AACX,CAAC;AAED,SAAS,WAAW,CAClB,WAAkC,EAClC,SAAS,GAAG,KAAK,EAAA;AAEjB,IAAA,MAAM,GAAG,GAAG,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;AAC7E,IAAA,OAAO,YAAY,CAAC,GAAG,CAAC;AAC1B;;AChCA;;AAEG;;;;"}

package/fesm2022/signality-core.mjs

@@ -6,6 +6,7 @@ export * from '@signality/core/elements';
 export * from '@signality/core/router';
 export * from '@signality/core/forms';
 export * from '@signality/core/types';
+export * from '@signality/core/utilities';
 
 /**
  * Generated bundle index. Do not edit.

package/fesm2022/signality-core.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"signality-core.mjs","sources":["../../../projects/core/signality-core.ts"],"sourcesContent":["/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;;;;AAAA;;AAEG"}
+{"version":3,"file":"signality-core.mjs","sources":["../../../projects/core/signality-core.ts"],"sourcesContent":["/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;;;;;AAAA;;AAEG"}

package/index.d.ts

@@ -6,3 +6,4 @@ export * from '@signality/core/elements';
 export * from '@signality/core/router';
 export * from '@signality/core/forms';
 export * from '@signality/core/types';
+export * from '@signality/core/utilities';

package/internal/utils/index.d.ts

@@ -7,7 +7,5 @@ export * from './is-query-signal';
 export * from './is-plain-object';
 export * from './const-signal';
 export * from './proxy-signal';
-export * from './to-element';
-export * from './to-value';
 export * from './unref-element';
 export * from './files/index';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signality/core",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "license": "MIT",
   "author": "Vyacheslav Borodin <https://github.com/vs-borodin>",
   "description": "A foundational toolkit for Angular Signals",
@@ -76,6 +76,10 @@
       "types": "./types/index.d.ts",
       "default": "./fesm2022/signality-core-types.mjs"
     },
+    "./utilities": {
+      "types": "./utilities/index.d.ts",
+      "default": "./fesm2022/signality-core-utilities.mjs"
+    },
     "./browser/battery": {
       "types": "./browser/battery/index.d.ts",
       "default": "./fesm2022/signality-core-browser-battery.mjs"
@@ -288,14 +292,14 @@
       "types": "./observers/resize-observer/index.d.ts",
       "default": "./fesm2022/signality-core-observers-resize-observer.mjs"
     },
-    "./reactivity/throttled": {
-      "types": "./reactivity/throttled/index.d.ts",
-      "default": "./fesm2022/signality-core-reactivity-throttled.mjs"
-    },
     "./reactivity/debounced": {
       "types": "./reactivity/debounced/index.d.ts",
       "default": "./fesm2022/signality-core-reactivity-debounced.mjs"
     },
+    "./reactivity/throttled": {
+      "types": "./reactivity/throttled/index.d.ts",
+      "default": "./fesm2022/signality-core-reactivity-throttled.mjs"
+    },
     "./reactivity/watcher": {
       "types": "./reactivity/watcher/index.d.ts",
       "default": "./fesm2022/signality-core-reactivity-watcher.mjs"

package/utilities/generate-id.d.ts

@@ -0,0 +1,29 @@
+import { InjectionToken } from '@angular/core';
+import type { WithInjector } from '@signality/core/types';
+export interface GenerateIdOptions extends WithInjector {
+    /**
+     * Optional prefix for the generated ID.
+     * @default 'app'
+     */
+    readonly prefix?: string;
+}
+/**
+ * Creates a unique ID string with optional prefix.
+ *
+ * @param options - Optional configuration with prefix and injector
+ * @returns A unique ID string
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <input [id]="inputId" />
+ *   `
+ * })
+ * export class MyInput {
+ *   readonly inputId = generateId();
+ * }
+ * ```
+ */
+export declare function generateId(options?: GenerateIdOptions): string;
+export declare const GENERATE_ID_FACTORY: InjectionToken<(prefix?: string) => string>;

package/utilities/index.d.ts

@@ -0,0 +1,3 @@
+export * from './generate-id';
+export * from './to-value';
+export * from './to-element';