@signality/core 0.0.1-alpha.2 → 0.0.1-alpha.3

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

@@ -1 +1 @@
-{"version":3,"file":"signality-core-router-router-listener.mjs","sources":["../../../projects/core/router/router-listener/index.ts","../../../projects/core/router/router-listener/signality-core-router-router-listener.ts"],"sourcesContent":["import { inject } from '@angular/core';\nimport {\n  ActivationEnd,\n  ActivationStart,\n  ChildActivationEnd,\n  ChildActivationStart,\n  type Event as RouterEvent,\n  GuardsCheckEnd,\n  GuardsCheckStart,\n  NavigationCancel,\n  NavigationEnd,\n  NavigationError,\n  NavigationSkipped,\n  NavigationStart,\n  ResolveEnd,\n  ResolveStart,\n  RouteConfigLoadEnd,\n  RouteConfigLoadStart,\n  Router,\n  RoutesRecognized,\n  Scroll,\n} from '@angular/router';\nimport { filter } from 'rxjs';\nimport { setupContext } from '@signality/core/internal';\nimport type { WithInjector } from '@signality/core/types';\n\nexport interface RouterListenerOptions extends WithInjector {\n  /** If true, automatically unsubscribe after the first event */\n  readonly once?: boolean;\n}\n\nexport interface RouterListenerRef {\n  /** Manually unsubscribe from router events */\n  readonly destroy: () => void;\n}\n\nexport type RouterEventType =\n  | 'navigationstart'\n  | 'navigationend'\n  | 'navigationcancel'\n  | 'navigationerror'\n  | 'navigationskipped'\n  | 'routesrecognized'\n  | 'guardscheckstart'\n  | 'guardscheckend'\n  | 'resolvestart'\n  | 'resolveend'\n  | 'routeconfigloadstart'\n  | 'routeconfigloadend'\n  | 'childactivationstart'\n  | 'childactivationend'\n  | 'activationstart'\n  | 'activationend'\n  | 'scroll';\n\n/**\n * Event-driven listener for [Angular Router](https://angular.dev/guide/routing) events.\n *\n * @param event - Router event name in lowercase (e.g., 'navigationstart') or array of event names\n * @param handler - Type-safe handler function for the specific event(s)\n * @param options - Optional configuration\n * @returns RouterListenerRef with destroy method for manual unsubscribe\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     @if (isLoading()) {\n *       <p>Navigation in progress...</p>\n *     }\n *   `\n * })\n * class NavigationComponent {\n *   readonly isLoading = signal(false);\n *\n *   constructor() {\n *     routerListener('navigationstart', event => {\n *       this.isLoading.set(true);\n *     });\n *\n *     routerListener('navigationend', event => {\n *       this.isLoading.set(false);\n *     });\n *   }\n * }\n * ```\n */\nexport function routerListener(\n  event: 'navigationstart',\n  handler: (event: NavigationStart) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'navigationend',\n  handler: (event: NavigationEnd) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'navigationcancel',\n  handler: (event: NavigationCancel) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'navigationerror',\n  handler: (event: NavigationError) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'navigationskipped',\n  handler: (event: NavigationSkipped) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'routesrecognized',\n  handler: (event: RoutesRecognized) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'guardscheckstart',\n  handler: (event: GuardsCheckStart) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'guardscheckend',\n  handler: (event: GuardsCheckEnd) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'resolvestart',\n  handler: (event: ResolveStart) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'resolveend',\n  handler: (event: ResolveEnd) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'routeconfigloadstart',\n  handler: (event: RouteConfigLoadStart) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'routeconfigloadend',\n  handler: (event: RouteConfigLoadEnd) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'childactivationstart',\n  handler: (event: ChildActivationStart) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'childactivationend',\n  handler: (event: ChildActivationEnd) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'activationstart',\n  handler: (event: ActivationStart) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'activationend',\n  handler: (event: ActivationEnd) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'scroll',\n  handler: (event: Scroll) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener<T extends readonly [RouterEventType, ...RouterEventType[]]>(\n  events: T,\n  handler: (event: RouterEventTypeArrayToUnion<T>) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: RouterEventType | readonly RouterEventType[],\n  handler: (event: any) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef {\n  const { runInContext } = setupContext(options?.injector, routerListener);\n\n  return runInContext(({ onCleanup }) => {\n    const router = inject(Router);\n    const events = Array.isArray(event) ? event : [event];\n    const EventClasses = events.map(\n      (e): new (...args: any[]) => RouterEvent => EVENT_CLASSES[e as RouterEventType]\n    );\n\n    const subscription = router.events\n      .pipe(\n        filter((routerEvent: RouterEvent): routerEvent is RouterEvent =>\n          EventClasses.some(EventClass => routerEvent instanceof EventClass)\n        )\n      )\n      .subscribe(e => {\n        handler(e);\n\n        if (options?.once) {\n          subscription.unsubscribe();\n        }\n      });\n\n    const destroy = subscription.unsubscribe.bind(subscription);\n\n    onCleanup(destroy);\n\n    return { destroy };\n  });\n}\n\nconst EVENT_CLASSES: Record<RouterEventType, new (...args: any[]) => RouterEvent> = {\n  navigationstart: NavigationStart,\n  navigationend: NavigationEnd,\n  navigationcancel: NavigationCancel,\n  navigationerror: NavigationError,\n  navigationskipped: NavigationSkipped,\n  routesrecognized: RoutesRecognized,\n  guardscheckstart: GuardsCheckStart,\n  guardscheckend: GuardsCheckEnd,\n  resolvestart: ResolveStart,\n  resolveend: ResolveEnd,\n  routeconfigloadstart: RouteConfigLoadStart,\n  routeconfigloadend: RouteConfigLoadEnd,\n  childactivationstart: ChildActivationStart,\n  childactivationend: ChildActivationEnd,\n  activationstart: ActivationStart,\n  activationend: ActivationEnd,\n  scroll: Scroll,\n};\n\ntype RouterEventTypeMap = {\n  navigationstart: NavigationStart;\n  navigationend: NavigationEnd;\n  navigationcancel: NavigationCancel;\n  navigationerror: NavigationError;\n  navigationskipped: NavigationSkipped;\n  routesrecognized: RoutesRecognized;\n  guardscheckstart: GuardsCheckStart;\n  guardscheckend: GuardsCheckEnd;\n  resolvestart: ResolveStart;\n  resolveend: ResolveEnd;\n  routeconfigloadstart: RouteConfigLoadStart;\n  routeconfigloadend: RouteConfigLoadEnd;\n  childactivationstart: ChildActivationStart;\n  childactivationend: ChildActivationEnd;\n  activationstart: ActivationStart;\n  activationend: ActivationEnd;\n  scroll: Scroll;\n};\n\ntype RouterEventTypeToEventType<T extends RouterEventType> = RouterEventTypeMap[T];\n\ntype RouterEventTypeArrayToUnion<T extends readonly RouterEventType[]> = T[number] extends infer U\n  ? U extends RouterEventType\n    ? RouterEventTypeToEventType<U>\n    : never\n  : never;\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;SAiLgB,cAAc,CAC5B,KAAmD,EACnD,OAA6B,EAC7B,OAA+B,EAAA;AAE/B,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC;AAExE,IAAA,OAAO,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,KAAI;AACpC,QAAA,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;AAC7B,QAAA,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC;AACrD,QAAA,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAC7B,CAAC,CAAC,KAA0C,aAAa,CAAC,CAAoB,CAAC,CAChF;AAED,QAAA,MAAM,YAAY,GAAG,MAAM,CAAC;aACzB,IAAI,CACH,MAAM,CAAC,CAAC,WAAwB,KAC9B,YAAY,CAAC,IAAI,CAAC,UAAU,IAAI,WAAW,YAAY,UAAU,CAAC,CACnE;aAEF,SAAS,CAAC,CAAC,IAAG;YACb,OAAO,CAAC,CAAC,CAAC;AAEV,YAAA,IAAI,OAAO,EAAE,IAAI,EAAE;gBACjB,YAAY,CAAC,WAAW,EAAE;YAC5B;AACF,QAAA,CAAC,CAAC;QAEJ,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC;QAE3D,SAAS,CAAC,OAAO,CAAC;QAElB,OAAO,EAAE,OAAO,EAAE;AACpB,IAAA,CAAC,CAAC;AACJ;AAEA,MAAM,aAAa,GAAiE;AAClF,IAAA,eAAe,EAAE,eAAe;AAChC,IAAA,aAAa,EAAE,aAAa;AAC5B,IAAA,gBAAgB,EAAE,gBAAgB;AAClC,IAAA,eAAe,EAAE,eAAe;AAChC,IAAA,iBAAiB,EAAE,iBAAiB;AACpC,IAAA,gBAAgB,EAAE,gBAAgB;AAClC,IAAA,gBAAgB,EAAE,gBAAgB;AAClC,IAAA,cAAc,EAAE,cAAc;AAC9B,IAAA,YAAY,EAAE,YAAY;AAC1B,IAAA,UAAU,EAAE,UAAU;AACtB,IAAA,oBAAoB,EAAE,oBAAoB;AAC1C,IAAA,kBAAkB,EAAE,kBAAkB;AACtC,IAAA,oBAAoB,EAAE,oBAAoB;AAC1C,IAAA,kBAAkB,EAAE,kBAAkB;AACtC,IAAA,eAAe,EAAE,eAAe;AAChC,IAAA,aAAa,EAAE,aAAa;AAC5B,IAAA,MAAM,EAAE,MAAM;CACf;;ACvOD;;AAEG;;;;"}
+{"version":3,"file":"signality-core-router-router-listener.mjs","sources":["../../../projects/core/router/router-listener/index.ts","../../../projects/core/router/router-listener/signality-core-router-router-listener.ts"],"sourcesContent":["import { inject } from '@angular/core';\nimport {\n  ActivationEnd,\n  ActivationStart,\n  ChildActivationEnd,\n  ChildActivationStart,\n  type Event as RouterEvent,\n  GuardsCheckEnd,\n  GuardsCheckStart,\n  NavigationCancel,\n  NavigationEnd,\n  NavigationError,\n  NavigationSkipped,\n  NavigationStart,\n  ResolveEnd,\n  ResolveStart,\n  RouteConfigLoadEnd,\n  RouteConfigLoadStart,\n  Router,\n  RoutesRecognized,\n  Scroll,\n} from '@angular/router';\nimport { filter } from 'rxjs';\nimport { setupContext } from '@signality/core/internal';\nimport type { WithInjector } from '@signality/core/types';\n\nexport interface RouterListenerOptions extends WithInjector {\n  /** If true, automatically unsubscribe after the first event */\n  readonly once?: boolean;\n}\n\nexport interface RouterListenerRef {\n  /** Manually unsubscribe from router events */\n  readonly destroy: () => void;\n}\n\nexport type RouterEventType =\n  | 'navigationstart'\n  | 'navigationend'\n  | 'navigationcancel'\n  | 'navigationerror'\n  | 'navigationskipped'\n  | 'routesrecognized'\n  | 'guardscheckstart'\n  | 'guardscheckend'\n  | 'resolvestart'\n  | 'resolveend'\n  | 'routeconfigloadstart'\n  | 'routeconfigloadend'\n  | 'childactivationstart'\n  | 'childactivationend'\n  | 'activationstart'\n  | 'activationend'\n  | 'scroll';\n\n/**\n * Event-driven listener for [Angular Router](https://angular.dev/guide/routing) events.\n *\n * @param event - Router event name in lowercase (e.g., 'navigationstart') or array of event names\n * @param handler - Type-safe handler function for the specific event(s)\n * @param options - Optional configuration\n * @returns RouterListenerRef with destroy method for manual unsubscribe\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     @if (isLoading()) {\n *       <p>Navigation in progress...</p>\n *     }\n *   `\n * })\n * export class NavigationDemo {\n *   readonly isLoading = signal(false);\n *\n *   constructor() {\n *     routerListener('navigationstart', event => {\n *       this.isLoading.set(true);\n *     });\n *\n *     routerListener('navigationend', event => {\n *       this.isLoading.set(false);\n *     });\n *   }\n * }\n * ```\n */\nexport function routerListener(\n  event: 'navigationstart',\n  handler: (event: NavigationStart) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'navigationend',\n  handler: (event: NavigationEnd) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'navigationcancel',\n  handler: (event: NavigationCancel) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'navigationerror',\n  handler: (event: NavigationError) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'navigationskipped',\n  handler: (event: NavigationSkipped) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'routesrecognized',\n  handler: (event: RoutesRecognized) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'guardscheckstart',\n  handler: (event: GuardsCheckStart) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'guardscheckend',\n  handler: (event: GuardsCheckEnd) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'resolvestart',\n  handler: (event: ResolveStart) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'resolveend',\n  handler: (event: ResolveEnd) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'routeconfigloadstart',\n  handler: (event: RouteConfigLoadStart) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'routeconfigloadend',\n  handler: (event: RouteConfigLoadEnd) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'childactivationstart',\n  handler: (event: ChildActivationStart) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'childactivationend',\n  handler: (event: ChildActivationEnd) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'activationstart',\n  handler: (event: ActivationStart) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'activationend',\n  handler: (event: ActivationEnd) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: 'scroll',\n  handler: (event: Scroll) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener<T extends readonly [RouterEventType, ...RouterEventType[]]>(\n  events: T,\n  handler: (event: RouterEventTypeArrayToUnion<T>) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef;\nexport function routerListener(\n  event: RouterEventType | readonly RouterEventType[],\n  handler: (event: any) => void,\n  options?: RouterListenerOptions\n): RouterListenerRef {\n  const { runInContext } = setupContext(options?.injector, routerListener);\n\n  return runInContext(({ onCleanup }) => {\n    const router = inject(Router);\n    const events = Array.isArray(event) ? event : [event];\n    const EventClasses = events.map(\n      (e): new (...args: any[]) => RouterEvent => EVENT_CLASSES[e as RouterEventType]\n    );\n\n    const subscription = router.events\n      .pipe(\n        filter((routerEvent: RouterEvent): routerEvent is RouterEvent =>\n          EventClasses.some(EventClass => routerEvent instanceof EventClass)\n        )\n      )\n      .subscribe(e => {\n        handler(e);\n\n        if (options?.once) {\n          subscription.unsubscribe();\n        }\n      });\n\n    const destroy = subscription.unsubscribe.bind(subscription);\n\n    onCleanup(destroy);\n\n    return { destroy };\n  });\n}\n\nconst EVENT_CLASSES: Record<RouterEventType, new (...args: any[]) => RouterEvent> = {\n  navigationstart: NavigationStart,\n  navigationend: NavigationEnd,\n  navigationcancel: NavigationCancel,\n  navigationerror: NavigationError,\n  navigationskipped: NavigationSkipped,\n  routesrecognized: RoutesRecognized,\n  guardscheckstart: GuardsCheckStart,\n  guardscheckend: GuardsCheckEnd,\n  resolvestart: ResolveStart,\n  resolveend: ResolveEnd,\n  routeconfigloadstart: RouteConfigLoadStart,\n  routeconfigloadend: RouteConfigLoadEnd,\n  childactivationstart: ChildActivationStart,\n  childactivationend: ChildActivationEnd,\n  activationstart: ActivationStart,\n  activationend: ActivationEnd,\n  scroll: Scroll,\n};\n\ntype RouterEventTypeMap = {\n  navigationstart: NavigationStart;\n  navigationend: NavigationEnd;\n  navigationcancel: NavigationCancel;\n  navigationerror: NavigationError;\n  navigationskipped: NavigationSkipped;\n  routesrecognized: RoutesRecognized;\n  guardscheckstart: GuardsCheckStart;\n  guardscheckend: GuardsCheckEnd;\n  resolvestart: ResolveStart;\n  resolveend: ResolveEnd;\n  routeconfigloadstart: RouteConfigLoadStart;\n  routeconfigloadend: RouteConfigLoadEnd;\n  childactivationstart: ChildActivationStart;\n  childactivationend: ChildActivationEnd;\n  activationstart: ActivationStart;\n  activationend: ActivationEnd;\n  scroll: Scroll;\n};\n\ntype RouterEventTypeToEventType<T extends RouterEventType> = RouterEventTypeMap[T];\n\ntype RouterEventTypeArrayToUnion<T extends readonly RouterEventType[]> = T[number] extends infer U\n  ? U extends RouterEventType\n    ? RouterEventTypeToEventType<U>\n    : never\n  : never;\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;SAiLgB,cAAc,CAC5B,KAAmD,EACnD,OAA6B,EAC7B,OAA+B,EAAA;AAE/B,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC;AAExE,IAAA,OAAO,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,KAAI;AACpC,QAAA,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;AAC7B,QAAA,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC;AACrD,QAAA,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAC7B,CAAC,CAAC,KAA0C,aAAa,CAAC,CAAoB,CAAC,CAChF;AAED,QAAA,MAAM,YAAY,GAAG,MAAM,CAAC;aACzB,IAAI,CACH,MAAM,CAAC,CAAC,WAAwB,KAC9B,YAAY,CAAC,IAAI,CAAC,UAAU,IAAI,WAAW,YAAY,UAAU,CAAC,CACnE;aAEF,SAAS,CAAC,CAAC,IAAG;YACb,OAAO,CAAC,CAAC,CAAC;AAEV,YAAA,IAAI,OAAO,EAAE,IAAI,EAAE;gBACjB,YAAY,CAAC,WAAW,EAAE;YAC5B;AACF,QAAA,CAAC,CAAC;QAEJ,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC;QAE3D,SAAS,CAAC,OAAO,CAAC;QAElB,OAAO,EAAE,OAAO,EAAE;AACpB,IAAA,CAAC,CAAC;AACJ;AAEA,MAAM,aAAa,GAAiE;AAClF,IAAA,eAAe,EAAE,eAAe;AAChC,IAAA,aAAa,EAAE,aAAa;AAC5B,IAAA,gBAAgB,EAAE,gBAAgB;AAClC,IAAA,eAAe,EAAE,eAAe;AAChC,IAAA,iBAAiB,EAAE,iBAAiB;AACpC,IAAA,gBAAgB,EAAE,gBAAgB;AAClC,IAAA,gBAAgB,EAAE,gBAAgB;AAClC,IAAA,cAAc,EAAE,cAAc;AAC9B,IAAA,YAAY,EAAE,YAAY;AAC1B,IAAA,UAAU,EAAE,UAAU;AACtB,IAAA,oBAAoB,EAAE,oBAAoB;AAC1C,IAAA,kBAAkB,EAAE,kBAAkB;AACtC,IAAA,oBAAoB,EAAE,oBAAoB;AAC1C,IAAA,kBAAkB,EAAE,kBAAkB;AACtC,IAAA,eAAe,EAAE,eAAe;AAChC,IAAA,aAAa,EAAE,aAAa;AAC5B,IAAA,MAAM,EAAE,MAAM;CACf;;ACvOD;;AAEG;;;;"}

package/fesm2022/signality-core-router-title.mjs

@@ -21,7 +21,7 @@ import { setupContext, proxySignal } from '@signality/core/internal';
  *     </div>
  *   `
  * })
- * class PageComponent {
+ * export class Page {
  *   readonly pageTitle = title();
  *
  *   updateTitle() {

package/fesm2022/signality-core-router-title.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"signality-core-router-title.mjs","sources":["../../../projects/core/router/title/index.ts","../../../projects/core/router/title/signality-core-router-title.ts"],"sourcesContent":["import { type CreateSignalOptions, inject, linkedSignal, type WritableSignal } from '@angular/core';\nimport { ActivatedRoute } from '@angular/router';\nimport { Title } from '@angular/platform-browser';\nimport { toSignal } from '@angular/core/rxjs-interop';\nimport { filter } from 'rxjs';\nimport { proxySignal, setupContext } from '@signality/core/internal';\nimport type { WithInjector } from '@signality/core/types';\n\nexport type TitleOptions = CreateSignalOptions<string> & WithInjector;\n\n/**\n * Reactive wrapper around the [Angular Router](https://angular.dev/guide/routing) route title.\n *\n * @param options - Optional configuration\n * @returns A writable signal containing the current route title (string)\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <div>\n *       <h1>{{ pageTitle() }}</h1>\n *       <button (click)=\"updateTitle()\">Update Title</button>\n *     </div>\n *   `\n * })\n * class PageComponent {\n *   readonly pageTitle = title();\n *\n *   updateTitle() {\n *     this.pageTitle.set('New Page Title');\n *   }\n * }\n * ```\n */\nexport function title(options?: TitleOptions): WritableSignal<string> {\n  const { runInContext } = setupContext(options?.injector, title);\n\n  return runInContext(() => {\n    const route = inject(ActivatedRoute);\n    const html = inject(Title);\n\n    return proxySignal(\n      linkedSignal(\n        toSignal<string, string>(route.title.pipe(filter(Boolean)), {\n          initialValue: route.snapshot.title || html.getTitle(),\n        }),\n        { ...options }\n      ),\n      {\n        set: (value, source) => {\n          html.setTitle(value);\n          source.set(value);\n        },\n      }\n    );\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;;AAUA;;;;;;;;;;;;;;;;;;;;;;;;AAwBG;AACG,SAAU,KAAK,CAAC,OAAsB,EAAA;AAC1C,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC;IAE/D,OAAO,YAAY,CAAC,MAAK;AACvB,QAAA,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC;AACpC,QAAA,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;AAE1B,QAAA,OAAO,WAAW,CAChB,YAAY,CACV,QAAQ,CAAiB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE;YAC1D,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE;AACtD,SAAA,CAAC,EACF,EAAE,GAAG,OAAO,EAAE,CACf,EACD;AACE,YAAA,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAI;AACrB,gBAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;AACpB,gBAAA,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;YACnB,CAAC;AACF,SAAA,CACF;AACH,IAAA,CAAC,CAAC;AACJ;;ACzDA;;AAEG;;;;"}
+{"version":3,"file":"signality-core-router-title.mjs","sources":["../../../projects/core/router/title/index.ts","../../../projects/core/router/title/signality-core-router-title.ts"],"sourcesContent":["import { type CreateSignalOptions, inject, linkedSignal, type WritableSignal } from '@angular/core';\nimport { ActivatedRoute } from '@angular/router';\nimport { Title } from '@angular/platform-browser';\nimport { toSignal } from '@angular/core/rxjs-interop';\nimport { filter } from 'rxjs';\nimport { proxySignal, setupContext } from '@signality/core/internal';\nimport type { WithInjector } from '@signality/core/types';\n\nexport type TitleOptions = CreateSignalOptions<string> & WithInjector;\n\n/**\n * Reactive wrapper around the [Angular Router](https://angular.dev/guide/routing) route title.\n *\n * @param options - Optional configuration\n * @returns A writable signal containing the current route title (string)\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <div>\n *       <h1>{{ pageTitle() }}</h1>\n *       <button (click)=\"updateTitle()\">Update Title</button>\n *     </div>\n *   `\n * })\n * export class Page {\n *   readonly pageTitle = title();\n *\n *   updateTitle() {\n *     this.pageTitle.set('New Page Title');\n *   }\n * }\n * ```\n */\nexport function title(options?: TitleOptions): WritableSignal<string> {\n  const { runInContext } = setupContext(options?.injector, title);\n\n  return runInContext(() => {\n    const route = inject(ActivatedRoute);\n    const html = inject(Title);\n\n    return proxySignal(\n      linkedSignal(\n        toSignal<string, string>(route.title.pipe(filter(Boolean)), {\n          initialValue: route.snapshot.title || html.getTitle(),\n        }),\n        { ...options }\n      ),\n      {\n        set: (value, source) => {\n          html.setTitle(value);\n          source.set(value);\n        },\n      }\n    );\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;;AAUA;;;;;;;;;;;;;;;;;;;;;;;;AAwBG;AACG,SAAU,KAAK,CAAC,OAAsB,EAAA;AAC1C,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC;IAE/D,OAAO,YAAY,CAAC,MAAK;AACvB,QAAA,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC;AACpC,QAAA,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;AAE1B,QAAA,OAAO,WAAW,CAChB,YAAY,CACV,QAAQ,CAAiB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE;YAC1D,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE;AACtD,SAAA,CAAC,EACF,EAAE,GAAG,OAAO,EAAE,CACf,EACD;AACE,YAAA,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAI;AACrB,gBAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;AACpB,gBAAA,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;YACnB,CAAC;AACF,SAAA,CACF;AACH,IAAA,CAAC,CAAC;AACJ;;ACzDA;;AAEG;;;;"}

package/fesm2022/signality-core-router-url.mjs

@@ -19,7 +19,7 @@ import { routerListener } from '@signality/core/router/router-listener';
  *     </div>
  *   `
  * })
- * class UrlComponent {
+ * export class UrlDemo {
  *   readonly currentUrl = url();
  *   readonly absoluteUrl = url({ absolute: true });
  * }

package/fesm2022/signality-core-router-url.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"signality-core-router-url.mjs","sources":["../../../projects/core/router/url/index.ts","../../../projects/core/router/url/signality-core-router-url.ts"],"sourcesContent":["import { type CreateSignalOptions, inject, signal, type Signal } from '@angular/core';\nimport { Router } from '@angular/router';\nimport { constSignal, setupContext } from '@signality/core/internal';\nimport type { WithInjector } from '@signality/core/types';\nimport { routerListener } from '@signality/core/router/router-listener';\n\nexport interface UrlOptions extends CreateSignalOptions<string>, WithInjector {\n  /**\n   * Include origin (protocol + host) for absolute URL.\n   * @default false\n   */\n  readonly absolute?: boolean;\n}\n\n/**\n * Reactive wrapper around the [Angular Router](https://angular.dev/guide/routing) current URL.\n *\n * @param options - Optional configuration\n * @returns A signal containing the current URL\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <div>\n *       <p>Current URL: {{ currentUrl() }}</p>\n *       <p>Absolute URL: {{ absoluteUrl() }}</p>\n *     </div>\n *   `\n * })\n * class UrlComponent {\n *   readonly currentUrl = url();\n *   readonly absoluteUrl = url({ absolute: true });\n * }\n * ```\n */\nexport function url(options?: UrlOptions): Signal<string> {\n  const { runInContext } = setupContext(options?.injector, url);\n\n  return runInContext(({ isServer }) => {\n    const router = inject(Router);\n\n    if (isServer) {\n      return constSignal(router.url);\n    }\n\n    const getUrl = () => {\n      const relativeUrl = router.url;\n\n      if (options?.absolute) {\n        return location.origin + relativeUrl;\n      }\n\n      return relativeUrl;\n    };\n\n    const result = signal(getUrl(), options);\n\n    routerListener('navigationend', () => result.set(getUrl()));\n\n    return result.asReadonly();\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;AAcA;;;;;;;;;;;;;;;;;;;;;AAqBG;AACG,SAAU,GAAG,CAAC,OAAoB,EAAA;AACtC,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC;AAE7D,IAAA,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAI;AACnC,QAAA,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAE7B,IAAI,QAAQ,EAAE;AACZ,YAAA,OAAO,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC;QAChC;QAEA,MAAM,MAAM,GAAG,MAAK;AAClB,YAAA,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG;AAE9B,YAAA,IAAI,OAAO,EAAE,QAAQ,EAAE;AACrB,gBAAA,OAAO,QAAQ,CAAC,MAAM,GAAG,WAAW;YACtC;AAEA,YAAA,OAAO,WAAW;AACpB,QAAA,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,OAAO,CAAC;AAExC,QAAA,cAAc,CAAC,eAAe,EAAE,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;AAE3D,QAAA,OAAO,MAAM,CAAC,UAAU,EAAE;AAC5B,IAAA,CAAC,CAAC;AACJ;;AC9DA;;AAEG;;;;"}
+{"version":3,"file":"signality-core-router-url.mjs","sources":["../../../projects/core/router/url/index.ts","../../../projects/core/router/url/signality-core-router-url.ts"],"sourcesContent":["import { type CreateSignalOptions, inject, signal, type Signal } from '@angular/core';\nimport { Router } from '@angular/router';\nimport { constSignal, setupContext } from '@signality/core/internal';\nimport type { WithInjector } from '@signality/core/types';\nimport { routerListener } from '@signality/core/router/router-listener';\n\nexport interface UrlOptions extends CreateSignalOptions<string>, WithInjector {\n  /**\n   * Include origin (protocol + host) for absolute URL.\n   * @default false\n   */\n  readonly absolute?: boolean;\n}\n\n/**\n * Reactive wrapper around the [Angular Router](https://angular.dev/guide/routing) current URL.\n *\n * @param options - Optional configuration\n * @returns A signal containing the current URL\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <div>\n *       <p>Current URL: {{ currentUrl() }}</p>\n *       <p>Absolute URL: {{ absoluteUrl() }}</p>\n *     </div>\n *   `\n * })\n * export class UrlDemo {\n *   readonly currentUrl = url();\n *   readonly absoluteUrl = url({ absolute: true });\n * }\n * ```\n */\nexport function url(options?: UrlOptions): Signal<string> {\n  const { runInContext } = setupContext(options?.injector, url);\n\n  return runInContext(({ isServer }) => {\n    const router = inject(Router);\n\n    if (isServer) {\n      return constSignal(router.url);\n    }\n\n    const getUrl = () => {\n      const relativeUrl = router.url;\n\n      if (options?.absolute) {\n        return location.origin + relativeUrl;\n      }\n\n      return relativeUrl;\n    };\n\n    const result = signal(getUrl(), options);\n\n    routerListener('navigationend', () => result.set(getUrl()));\n\n    return result.asReadonly();\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;AAcA;;;;;;;;;;;;;;;;;;;;;AAqBG;AACG,SAAU,GAAG,CAAC,OAAoB,EAAA;AACtC,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC;AAE7D,IAAA,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAI;AACnC,QAAA,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAE7B,IAAI,QAAQ,EAAE;AACZ,YAAA,OAAO,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC;QAChC;QAEA,MAAM,MAAM,GAAG,MAAK;AAClB,YAAA,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG;AAE9B,YAAA,IAAI,OAAO,EAAE,QAAQ,EAAE;AACrB,gBAAA,OAAO,QAAQ,CAAC,MAAM,GAAG,WAAW;YACtC;AAEA,YAAA,OAAO,WAAW;AACpB,QAAA,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,OAAO,CAAC;AAExC,QAAA,cAAc,CAAC,eAAe,EAAE,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;AAE3D,QAAA,OAAO,MAAM,CAAC,UAAU,EAAE;AAC5B,IAAA,CAAC,CAAC;AACJ;;AC9DA;;AAEG;;;;"}

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

@@ -16,7 +16,7 @@ import { setupContext, toValue } from '@signality/core/internal';
  *     <input (input)="handleInput($event.target.value)" />
  *   `,
  * })
- * export class SearchComponent {
+ * export class SearchInput {
  *   readonly debounceTime = input(300);
  *   readonly searchChange = output<string>();
  *

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 SearchComponent {\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, 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;;;;"}

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

@@ -1,33 +1,31 @@
-import { signal, untracked, isSignal } from '@angular/core';
-import { setupContext, NOOP_FN, constSignal, toValue } from '@signality/core/internal';
+import { isSignal } from '@angular/core';
+import { setupContext, NOOP_EFFECT_REF, toValue } from '@signality/core/internal';
 import { watcher } from '@signality/core/reactivity/watcher';
 
 /**
- * Creates a reactive interval that executes a callback function at specified intervals.
- * Automatically handles cleanup and supports reactive interval duration.
+ * Signal-based wrapper around [`setInterval`](https://developer.mozilla.org/en-US/docs/Web/API/Window/setInterval).
+ * Creates a reactive interval that executes a callback at specified intervals.
+ * The interval starts immediately upon creation and can be stopped with `destroy()`.
  *
- * @param callback - Function to execute on each interval tick, receives current counter value
+ * @param callback - Function to execute on each interval tick
  * @param intervalMs - Interval duration in milliseconds (can be a reactive signal)
- * @param options - Optional configuration including immediate start and injector
- * @returns An IntervalRef with control methods and state signals
+ * @param options - Optional configuration
+ * @returns An IntervalRef with a `destroy` method to stop the interval
  *
  * @example
  * ```typescript
  * @Component({
  *   template: `
- *     <p>Status: {{ polling.isActive() ? 'Polling' : 'Stopped' }}</p>
- *     <button (click)="polling.pause()">Stop</button>
- *     <button (click)="polling.resume()">Start</button>
+ *     <p>Ticks: {{ ticks() }}</p>
+ *     <button (click)="polling.destroy()">Stop</button>
  *   `,
  * })
  * export class PeriodicTask {
- *   readonly polling = interval(async () => {
- *     await this.checkStatus();
- *   }, 5000);
+ *   readonly ticks = signal(0);
  *
- *   async checkStatus() {
- *     // async operation
- *   }
+ *   readonly polling = interval(() => {
+ *     this.ticks.update(n => n + 1);
+ *   }, 5000);
  * }
  * ```
  */
@@ -35,70 +33,27 @@ function interval(callback, intervalMs, options) {
     const { runInContext } = setupContext(options?.injector, interval);
     return runInContext(({ isServer, onCleanup }) => {
         if (isServer) {
-            return {
-                isActive: constSignal(false),
-                counter: constSignal(0),
-                pause: NOOP_FN,
-                resume: NOOP_FN,
-                reset: NOOP_FN,
-            };
+            return NOOP_EFFECT_REF;
         }
-        const isActive = signal(false, ...(ngDevMode ? [{ debugName: "isActive" }] : []));
-        const counter = signal(0, ...(ngDevMode ? [{ debugName: "counter" }] : []));
         let intervalId;
         const start = () => {
-            untracked(() => {
-                if (intervalId !== undefined || !isActive()) {
-                    return;
-                }
-                const ms = toValue(intervalMs);
-                intervalId = setInterval(() => {
-                    const currentCounter = counter() + 1;
-                    counter.set(currentCounter);
-                    callback(currentCounter);
-                }, ms);
-            });
-        };
-        const pause = () => {
-            cleanup();
-            isActive.set(false);
-        };
-        const cleanup = () => {
-            if (intervalId !== undefined) {
-                clearInterval(intervalId);
-                intervalId = undefined;
-            }
-        };
-        const resume = () => {
-            if (intervalId !== undefined) {
-                return;
-            }
-            isActive.set(true);
-            start();
-        };
-        const reset = () => {
-            counter.set(0);
+            clearInterval(intervalId);
+            const ms = toValue.untracked(intervalMs);
+            intervalId = ms > 0 ? setInterval(callback, ms) : undefined;
         };
         if (isSignal(intervalMs)) {
-            watcher(intervalMs, newMs => {
-                if (isActive() && newMs !== undefined) {
-                    cleanup();
-                    start();
-                }
-            });
+            watcher(intervalMs, start);
         }
-        onCleanup(cleanup);
+        const destroy = () => {
+            clearInterval(intervalId);
+            intervalId = undefined;
+        };
+        onCleanup(destroy);
         if (options?.immediate) {
-            isActive.set(true);
-            start();
+            callback();
         }
-        return {
-            isActive: isActive.asReadonly(),
-            counter: counter.asReadonly(),
-            pause,
-            resume,
-            reset,
-        };
+        start();
+        return { destroy };
     });
 }
 

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, signal, type Signal, untracked } from '@angular/core';\nimport { constSignal, NOOP_FN, setupContext, type Timer, toValue } from '@signality/core/internal';\nimport type { MaybeSignal, WithInjector } from '@signality/core/types';\nimport { watcher } from '@signality/core/reactivity/watcher';\n\nexport interface IntervalOptions extends WithInjector {\n  /**\n   * Whether to start the interval immediately.\n   * @default false\n   */\n  readonly immediate?: boolean;\n}\n\nexport interface IntervalRef {\n  /** Whether the interval is currently active */\n  readonly isActive: Signal<boolean>;\n\n  /** Number of times the callback has been executed */\n  readonly counter: Signal<number>;\n\n  /** Pause the interval */\n  readonly pause: () => void;\n\n  /** Resume the interval */\n  readonly resume: () => void;\n\n  /** Reset the counter to 0 */\n  readonly reset: () => void;\n}\n\n/**\n * Creates a reactive interval that executes a callback function at specified intervals.\n * Automatically handles cleanup and supports reactive interval duration.\n *\n * @param callback - Function to execute on each interval tick, receives current counter value\n * @param intervalMs - Interval duration in milliseconds (can be a reactive signal)\n * @param options - Optional configuration including immediate start and injector\n * @returns An IntervalRef with control methods and state signals\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <p>Status: {{ polling.isActive() ? 'Polling' : 'Stopped' }}</p>\n *     <button (click)=\"polling.pause()\">Stop</button>\n *     <button (click)=\"polling.resume()\">Start</button>\n *   `,\n * })\n * export class PeriodicTask {\n *   readonly polling = interval(async () => {\n *     await this.checkStatus();\n *   }, 5000);\n *\n *   async checkStatus() {\n *     // async operation\n *   }\n * }\n * ```\n */\nexport function interval(\n  callback: (counter: number) => 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 {\n        isActive: constSignal(false),\n        counter: constSignal(0),\n        pause: NOOP_FN,\n        resume: NOOP_FN,\n        reset: NOOP_FN,\n      };\n    }\n\n    const isActive = signal(false);\n    const counter = signal(0);\n\n    let intervalId: Timer;\n\n    const start = () => {\n      untracked(() => {\n        if (intervalId !== undefined || !isActive()) {\n          return;\n        }\n\n        const ms = toValue(intervalMs);\n\n        intervalId = setInterval(() => {\n          const currentCounter = counter() + 1;\n          counter.set(currentCounter);\n          callback(currentCounter);\n        }, ms);\n      });\n    };\n\n    const pause = () => {\n      cleanup();\n      isActive.set(false);\n    };\n\n    const cleanup = () => {\n      if (intervalId !== undefined) {\n        clearInterval(intervalId);\n        intervalId = undefined;\n      }\n    };\n\n    const resume = () => {\n      if (intervalId !== undefined) {\n        return;\n      }\n\n      isActive.set(true);\n      start();\n    };\n\n    const reset = () => {\n      counter.set(0);\n    };\n\n    if (isSignal(intervalMs)) {\n      watcher(intervalMs, newMs => {\n        if (isActive() && newMs !== undefined) {\n          cleanup();\n          start();\n        }\n      });\n    }\n\n    onCleanup(cleanup);\n\n    if (options?.immediate) {\n      isActive.set(true);\n      start();\n    }\n\n    return {\n      isActive: isActive.asReadonly(),\n      counter: counter.asReadonly(),\n      pause,\n      resume,\n      reset,\n    };\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AA8BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BG;SACa,QAAQ,CACtB,QAAmC,EACnC,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;YACZ,OAAO;AACL,gBAAA,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC;AAC5B,gBAAA,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;AACvB,gBAAA,KAAK,EAAE,OAAO;AACd,gBAAA,MAAM,EAAE,OAAO;AACf,gBAAA,KAAK,EAAE,OAAO;aACf;QACH;AAEA,QAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,oDAAC;AAC9B,QAAA,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,mDAAC;AAEzB,QAAA,IAAI,UAAiB;QAErB,MAAM,KAAK,GAAG,MAAK;YACjB,SAAS,CAAC,MAAK;gBACb,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,QAAQ,EAAE,EAAE;oBAC3C;gBACF;AAEA,gBAAA,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;AAE9B,gBAAA,UAAU,GAAG,WAAW,CAAC,MAAK;AAC5B,oBAAA,MAAM,cAAc,GAAG,OAAO,EAAE,GAAG,CAAC;AACpC,oBAAA,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;oBAC3B,QAAQ,CAAC,cAAc,CAAC;gBAC1B,CAAC,EAAE,EAAE,CAAC;AACR,YAAA,CAAC,CAAC;AACJ,QAAA,CAAC;QAED,MAAM,KAAK,GAAG,MAAK;AACjB,YAAA,OAAO,EAAE;AACT,YAAA,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;AACrB,QAAA,CAAC;QAED,MAAM,OAAO,GAAG,MAAK;AACnB,YAAA,IAAI,UAAU,KAAK,SAAS,EAAE;gBAC5B,aAAa,CAAC,UAAU,CAAC;gBACzB,UAAU,GAAG,SAAS;YACxB;AACF,QAAA,CAAC;QAED,MAAM,MAAM,GAAG,MAAK;AAClB,YAAA,IAAI,UAAU,KAAK,SAAS,EAAE;gBAC5B;YACF;AAEA,YAAA,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;AAClB,YAAA,KAAK,EAAE;AACT,QAAA,CAAC;QAED,MAAM,KAAK,GAAG,MAAK;AACjB,YAAA,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AAChB,QAAA,CAAC;AAED,QAAA,IAAI,QAAQ,CAAC,UAAU,CAAC,EAAE;AACxB,YAAA,OAAO,CAAC,UAAU,EAAE,KAAK,IAAG;AAC1B,gBAAA,IAAI,QAAQ,EAAE,IAAI,KAAK,KAAK,SAAS,EAAE;AACrC,oBAAA,OAAO,EAAE;AACT,oBAAA,KAAK,EAAE;gBACT;AACF,YAAA,CAAC,CAAC;QACJ;QAEA,SAAS,CAAC,OAAO,CAAC;AAElB,QAAA,IAAI,OAAO,EAAE,SAAS,EAAE;AACtB,YAAA,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;AAClB,YAAA,KAAK,EAAE;QACT;QAEA,OAAO;AACL,YAAA,QAAQ,EAAE,QAAQ,CAAC,UAAU,EAAE;AAC/B,YAAA,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE;YAC7B,KAAK;YACL,MAAM;YACN,KAAK;SACN;AACH,IAAA,CAAC,CAAC;AACJ;;ACnJA;;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, toValue } from '@signality/core/internal';\nimport type { MaybeSignal, WithInjector } from '@signality/core/types';\nimport { watcher } 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\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      watcher(intervalMs, start);\n    }\n\n    const destroy = () => {\n      clearInterval(intervalId);\n      intervalId = undefined;\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;QAErB,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,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;QAC5B;QAEA,MAAM,OAAO,GAAG,MAAK;YACnB,aAAa,CAAC,UAAU,CAAC;YACzB,UAAU,GAAG,SAAS;AACxB,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;;ACxFA;;AAEG;;;;"}

package/internal/utils/assert.d.ts

@@ -0,0 +1,2 @@
+export declare function assertElement(value: unknown, source: string): asserts value is Element;
+export declare function assertEventTarget(value: unknown, source: string): asserts value is EventTarget;

package/internal/utils/dom/index.d.ts

@@ -3,4 +3,5 @@ export * from './get-event-target';
 export * from './get-pip-element';
 export * from './get-shadow-root';
 export * from './is-element';
+export * from './is-event-target';
 export * from './is-node-within';

package/internal/utils/dom/is-element.d.ts

@@ -1 +1 @@
-export declare function isElement(obj: Element | EventTarget | Node | object | null): obj is Element;
+export declare function isElement(value: unknown): value is Element;

package/internal/utils/dom/is-event-target.d.ts

@@ -0,0 +1 @@
+export declare function isEventTarget(value: unknown): value is EventTarget;

package/internal/utils/files/index.d.ts

@@ -0,0 +1 @@
+export * from './is-accepted-file';

package/internal/utils/files/is-accepted-file.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Checks whether a file matches the given accept patterns.
+ * Follows the native HTML
+ * [`accept`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/accept) attribute format:
+ * MIME types (`'image/png'`), wildcards (`'image/*'`), and file extensions (`'.pdf'`).
+ *
+ * @param file - File to check
+ * @param accept - Comma-separated string of accepted patterns (e.g. `'image/*, .pdf'`)
+ * @internal
+ */
+export declare function isAcceptedFile(file: File, accept: string): boolean;

package/internal/utils/index.d.ts

@@ -1,5 +1,6 @@
 export * from './bom';
 export * from './dom';
+export * from './assert';
 export * from './context';
 export * from './create-token';
 export * from './is-query-signal';
@@ -8,3 +9,5 @@ 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/internal/utils/to-element.d.ts

@@ -1,4 +1,4 @@
-import { ElementRef, type Signal } from '@angular/core';
+import { type ElementRef, type Signal } from '@angular/core';
 export interface ToElementFn extends ToElementBase {
     untracked: ToElementBase;
 }

package/internal/utils/unref-element.d.ts

@@ -0,0 +1,2 @@
+import { ElementRef } from '@angular/core';
+export declare function unrefElement<T>(value: T | ElementRef<T>): T;

package/observers/index.d.ts

@@ -1,4 +1,3 @@
 export * from '@signality/core/observers/intersection-observer';
 export * from '@signality/core/observers/mutation-observer';
-export * from '@signality/core/observers/performance-observer';
 export * from '@signality/core/observers/resize-observer';

package/observers/intersection-observer/index.d.ts

@@ -1,11 +1,32 @@
 import { type CreateEffectOptions } from '@angular/core';
 import type { MaybeElementSignal, MaybeSignal } from '@signality/core/types';
 export interface IntersectionObserverInitOptions extends Omit<CreateEffectOptions, 'allowSignalWrites'> {
+    /**
+     * Scrollable ancestor used as the intersection viewport.
+     * `null` or `undefined` defaults to the browser viewport.
+     *
+     * @see [IntersectionObserver: root on MDN](https://developer.mozilla.org/en-US/docs/Web/API/IntersectionObserver/root)
+     */
     readonly root?: MaybeElementSignal<Element> | Document | null;
+    /**
+     * CSS margin applied around the root before computing intersections.
+     * Accepts values in the same format as the CSS `margin` property (e.g. `'10px 0px'`).
+     *
+     * @see [IntersectionObserver: rootMargin on MDN](https://developer.mozilla.org/en-US/docs/Web/API/IntersectionObserver/rootMargin)
+     */
     readonly rootMargin?: MaybeSignal<string>;
+    /**
+     * Fraction(s) of the target element that must be visible to trigger the callback.
+     * A single number or an array of thresholds, each between `0` and `1`.
+     *
+     * @see [IntersectionObserver: thresholds on MDN](https://developer.mozilla.org/en-US/docs/Web/API/IntersectionObserver/thresholds)
+     */
     readonly threshold?: MaybeSignal<number | number[]>;
 }
 export interface IntersectionObserverRef {
+    /**
+     * Stop observing all targets and disconnect the underlying `IntersectionObserver`.
+     */
     readonly destroy: () => void;
 }
 /**
@@ -27,7 +48,7 @@ export interface IntersectionObserverRef {
  *     }
  *   `
  * })
- * class IntersectionComponent {
+ * export class IntersectionDemo {
  *   readonly section = viewChild<ElementRef>('section');
  *   readonly isVisible = signal(false);
  *

package/observers/mutation-observer/index.d.ts

@@ -1,15 +1,57 @@
 import { type CreateEffectOptions } from '@angular/core';
 import type { MaybeElementSignal, MaybeSignal } from '@signality/core/types';
 export interface MutationObserverInitOptions extends Omit<CreateEffectOptions, 'allowSignalWrites'> {
+    /**
+     * Whether to observe additions and removals of child nodes.
+     *
+     * @see [MutationObserver.observe(): childList on MDN](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver/observe#childlist)
+     */
     readonly childList?: MaybeSignal<boolean>;
+    /**
+     * Whether to observe attribute changes on the target element.
+     * Use `attributeFilter` to limit which attributes are observed.
+     *
+     * @see [MutationObserver.observe(): attributes on MDN](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver/observe#attributes)
+     */
     readonly attributes?: MaybeSignal<boolean>;
+    /**
+     * Whether to observe changes to the text content (`CharacterData`) of the target.
+     *
+     * @see [MutationObserver.observe(): characterData on MDN](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver/observe#characterdata)
+     */
     readonly characterData?: MaybeSignal<boolean>;
+    /**
+     * Whether to extend observation to the entire subtree of the target element.
+     *
+     * @see [MutationObserver.observe(): subtree on MDN](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver/observe#subtree)
+     */
     readonly subtree?: MaybeSignal<boolean>;
+    /**
+     * Whether to record the previous attribute value in each `MutationRecord`.
+     * Implicitly sets `attributes` to `true` if not already set.
+     *
+     * @see [MutationObserver.observe(): attributeOldValue on MDN](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver/observe#attributeoldvalue)
+     */
     readonly attributeOldValue?: MaybeSignal<boolean>;
+    /**
+     * Whether to record the previous character data value in each `MutationRecord`.
+     * Implicitly sets `characterData` to `true` if not already set.
+     *
+     * @see [MutationObserver.observe(): characterDataOldValue on MDN](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver/observe#characterdataoldvalue)
+     */
     readonly characterDataOldValue?: MaybeSignal<boolean>;
+    /**
+     * Array of attribute local names to observe. Only mutations to listed attributes are reported.
+     * Implicitly sets `attributes` to `true` if not already set.
+     *
+     * @see [MutationObserver.observe(): attributeFilter on MDN](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver/observe#attributefilter)
+     */
     readonly attributeFilter?: MaybeSignal<string[]>;
 }
 export interface MutationObserverRef {
+    /**
+     * Stop observing all targets and disconnect the underlying `MutationObserver`.
+     */
     readonly destroy: () => void;
 }
 /**
@@ -30,7 +72,7 @@ export interface MutationObserverRef {
  *     </div>
  *   `
  * })
- * class MutationComponent {
+ * export class MutationComponent {
  *   readonly container = viewChild<ElementRef>('container');
  *   readonly childCount = signal(0);
  *

package/observers/resize-observer/index.d.ts

@@ -1,9 +1,21 @@
 import { type CreateEffectOptions } from '@angular/core';
 import type { MaybeElementSignal, MaybeSignal } from '@signality/core/types';
 export interface ResizeObserverInitOptions extends Omit<CreateEffectOptions, 'allowSignalWrites'> {
+    /**
+     * Box model to measure when reporting size changes.
+     *
+     * - `'content-box'` — size of the content area, excluding padding and border (default).
+     * - `'border-box'` — size including padding and border.
+     * - `'device-pixel-content-box'` — content-box size in physical device pixels.
+     *
+     * @see [ResizeObserver.observe(): box on MDN](https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver/observe#box)
+     */
     readonly box?: MaybeSignal<ResizeObserverBoxOptions>;
 }
 export interface ResizeObserverRef {
+    /**
+     * Stop observing all targets and disconnect the underlying `ResizeObserver`.
+     */
     readonly destroy: () => void;
 }
 /**
@@ -24,7 +36,7 @@ export interface ResizeObserverRef {
  *     </div>
  *   `
  * })
- * class ResizeComponent {
+ * export class ResizeComponent {
  *   readonly resizable = viewChild<ElementRef>('resizable');
  *   readonly size = signal({ width: 0, height: 0 });
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signality/core",
-  "version": "0.0.1-alpha.2",
+  "version": "0.0.1-alpha.3",
   "license": "MIT",
   "author": "Vyacheslav Borodin <https://github.com/vs-borodin>",
   "description": "A foundational toolkit for Angular Signals",
@@ -116,10 +116,18 @@
       "types": "./browser/favicon/index.d.ts",
       "default": "./fesm2022/signality-core-browser-favicon.mjs"
     },
+    "./browser/file-dialog": {
+      "types": "./browser/file-dialog/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-file-dialog.mjs"
+    },
     "./browser/fps": {
       "types": "./browser/fps/index.d.ts",
       "default": "./fesm2022/signality-core-browser-fps.mjs"
     },
+    "./browser/fullscreen": {
+      "types": "./browser/fullscreen/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-fullscreen.mjs"
+    },
     "./browser/gamepad": {
       "types": "./browser/gamepad/index.d.ts",
       "default": "./fesm2022/signality-core-browser-gamepad.mjs"
@@ -152,14 +160,14 @@
       "types": "./browser/page-visibility/index.d.ts",
       "default": "./fesm2022/signality-core-browser-page-visibility.mjs"
     },
+    "./browser/permission-state": {
+      "types": "./browser/permission-state/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-permission-state.mjs"
+    },
     "./browser/picture-in-picture": {
       "types": "./browser/picture-in-picture/index.d.ts",
       "default": "./fesm2022/signality-core-browser-picture-in-picture.mjs"
     },
-    "./browser/pointer-lock-element": {
-      "types": "./browser/pointer-lock-element/index.d.ts",
-      "default": "./fesm2022/signality-core-browser-pointer-lock-element.mjs"
-    },
     "./browser/screen-orientation": {
       "types": "./browser/screen-orientation/index.d.ts",
       "default": "./fesm2022/signality-core-browser-screen-orientation.mjs"
@@ -180,6 +188,10 @@
       "types": "./browser/text-direction/index.d.ts",
       "default": "./fesm2022/signality-core-browser-text-direction.mjs"
     },
+    "./browser/text-selection": {
+      "types": "./browser/text-selection/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-text-selection.mjs"
+    },
     "./browser/vibration": {
       "types": "./browser/vibration/index.d.ts",
       "default": "./fesm2022/signality-core-browser-vibration.mjs"
@@ -200,6 +212,14 @@
       "types": "./browser/web-worker/index.d.ts",
       "default": "./fesm2022/signality-core-browser-web-worker.mjs"
     },
+    "./browser/window-focus": {
+      "types": "./browser/window-focus/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-window-focus.mjs"
+    },
+    "./browser/window-size": {
+      "types": "./browser/window-size/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-window-size.mjs"
+    },
     "./elements/active-element": {
       "types": "./elements/active-element/index.d.ts",
       "default": "./fesm2022/signality-core-elements-active-element.mjs"
@@ -256,14 +276,6 @@
       "types": "./elements/swipe/index.d.ts",
       "default": "./fesm2022/signality-core-elements-swipe.mjs"
     },
-    "./elements/text-selection": {
-      "types": "./elements/text-selection/index.d.ts",
-      "default": "./fesm2022/signality-core-elements-text-selection.mjs"
-    },
-    "./elements/window-size": {
-      "types": "./elements/window-size/index.d.ts",
-      "default": "./fesm2022/signality-core-elements-window-size.mjs"
-    },
     "./forms/cva": {
       "types": "./forms/cva/index.d.ts",
       "default": "./fesm2022/signality-core-forms-cva.mjs"
@@ -276,10 +288,6 @@
       "types": "./observers/mutation-observer/index.d.ts",
       "default": "./fesm2022/signality-core-observers-mutation-observer.mjs"
     },
-    "./observers/performance-observer": {
-      "types": "./observers/performance-observer/index.d.ts",
-      "default": "./fesm2022/signality-core-observers-performance-observer.mjs"
-    },
     "./observers/resize-observer": {
       "types": "./observers/resize-observer/index.d.ts",
       "default": "./fesm2022/signality-core-observers-resize-observer.mjs"

package/reactivity/debounced/index.d.ts

@@ -18,7 +18,7 @@ export type DebouncedOptions<T> = CreateSignalOptions<T> & WithInjector;
  *     <p>Debounced value: {{ debouncedQuery() }}</p>
  *   `
  * })
- * class SearchInput {
+ * export class SearchInput {
  *   readonly query = signal('');
  *   readonly debouncedQuery = debounced(this.query, 300);
  * }
@@ -42,7 +42,7 @@ export declare function debounced<S extends Signal<any>>(source: S, timeMs: Mayb
  *     <p>Search results for: {{ query() }}</p>
  *   `
  * })
- * class SearchInput {
+ * export class SearchInput {
  *   readonly query = debounced('', 300);
  * }
  * ```