@signality/core 0.0.1-alpha.2

package/package.json

@@ -0,0 +1,343 @@
+{
+  "name": "@signality/core",
+  "version": "0.0.1-alpha.2",
+  "license": "MIT",
+  "author": "Vyacheslav Borodin <https://github.com/vs-borodin>",
+  "description": "A foundational toolkit for Angular Signals",
+  "keywords": [
+    "signality",
+    "angular",
+    "signals",
+    "utilities",
+    "reactive",
+    "typescript",
+    "ssr",
+    "browser-api",
+    "web-api"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/signalityjs/signality"
+  },
+  "bugs": "https://github.com/signalityjs/signality/issues",
+  "homepage": "https://signality.dev",
+  "sideEffects": false,
+  "peerDependencies": {
+    "@angular/common": ">=19.2.0",
+    "@angular/core": ">=19.2.0",
+    "@angular/forms": ">=19.2.0",
+    "@angular/router": ">=19.2.0",
+    "@angular/platform-browser": ">=19.2.0",
+    "rxjs": ">=7.8.1"
+  },
+  "module": "fesm2022/signality-core.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./fesm2022/signality-core.mjs"
+    },
+    "./browser": {
+      "types": "./browser/index.d.ts",
+      "default": "./fesm2022/signality-core-browser.mjs"
+    },
+    "./elements": {
+      "types": "./elements/index.d.ts",
+      "default": "./fesm2022/signality-core-elements.mjs"
+    },
+    "./forms": {
+      "types": "./forms/index.d.ts",
+      "default": "./fesm2022/signality-core-forms.mjs"
+    },
+    "./internal": {
+      "types": "./internal/index.d.ts",
+      "default": "./fesm2022/signality-core-internal.mjs"
+    },
+    "./observers": {
+      "types": "./observers/index.d.ts",
+      "default": "./fesm2022/signality-core-observers.mjs"
+    },
+    "./reactivity": {
+      "types": "./reactivity/index.d.ts",
+      "default": "./fesm2022/signality-core-reactivity.mjs"
+    },
+    "./router": {
+      "types": "./router/index.d.ts",
+      "default": "./fesm2022/signality-core-router.mjs"
+    },
+    "./scheduling": {
+      "types": "./scheduling/index.d.ts",
+      "default": "./fesm2022/signality-core-scheduling.mjs"
+    },
+    "./types": {
+      "types": "./types/index.d.ts",
+      "default": "./fesm2022/signality-core-types.mjs"
+    },
+    "./browser/battery": {
+      "types": "./browser/battery/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-battery.mjs"
+    },
+    "./browser/bluetooth": {
+      "types": "./browser/bluetooth/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-bluetooth.mjs"
+    },
+    "./browser/breakpoints": {
+      "types": "./browser/breakpoints/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-breakpoints.mjs"
+    },
+    "./browser/broadcast-channel": {
+      "types": "./browser/broadcast-channel/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-broadcast-channel.mjs"
+    },
+    "./browser/browser-language": {
+      "types": "./browser/browser-language/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-browser-language.mjs"
+    },
+    "./browser/clipboard": {
+      "types": "./browser/clipboard/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-clipboard.mjs"
+    },
+    "./browser/device-posture": {
+      "types": "./browser/device-posture/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-device-posture.mjs"
+    },
+    "./browser/display-media": {
+      "types": "./browser/display-media/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-display-media.mjs"
+    },
+    "./browser/eye-dropper": {
+      "types": "./browser/eye-dropper/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-eye-dropper.mjs"
+    },
+    "./browser/favicon": {
+      "types": "./browser/favicon/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-favicon.mjs"
+    },
+    "./browser/fps": {
+      "types": "./browser/fps/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-fps.mjs"
+    },
+    "./browser/gamepad": {
+      "types": "./browser/gamepad/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-gamepad.mjs"
+    },
+    "./browser/geolocation": {
+      "types": "./browser/geolocation/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-geolocation.mjs"
+    },
+    "./browser/input-modality": {
+      "types": "./browser/input-modality/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-input-modality.mjs"
+    },
+    "./browser/listener": {
+      "types": "./browser/listener/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-listener.mjs"
+    },
+    "./browser/media-query": {
+      "types": "./browser/media-query/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-media-query.mjs"
+    },
+    "./browser/network": {
+      "types": "./browser/network/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-network.mjs"
+    },
+    "./browser/online": {
+      "types": "./browser/online/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-online.mjs"
+    },
+    "./browser/page-visibility": {
+      "types": "./browser/page-visibility/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-page-visibility.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"
+    },
+    "./browser/speech-recognition": {
+      "types": "./browser/speech-recognition/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-speech-recognition.mjs"
+    },
+    "./browser/speech-synthesis": {
+      "types": "./browser/speech-synthesis/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-speech-synthesis.mjs"
+    },
+    "./browser/storage": {
+      "types": "./browser/storage/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-storage.mjs"
+    },
+    "./browser/text-direction": {
+      "types": "./browser/text-direction/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-text-direction.mjs"
+    },
+    "./browser/vibration": {
+      "types": "./browser/vibration/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-vibration.mjs"
+    },
+    "./browser/wake-lock": {
+      "types": "./browser/wake-lock/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-wake-lock.mjs"
+    },
+    "./browser/web-notification": {
+      "types": "./browser/web-notification/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-web-notification.mjs"
+    },
+    "./browser/web-share": {
+      "types": "./browser/web-share/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-web-share.mjs"
+    },
+    "./browser/web-worker": {
+      "types": "./browser/web-worker/index.d.ts",
+      "default": "./fesm2022/signality-core-browser-web-worker.mjs"
+    },
+    "./elements/active-element": {
+      "types": "./elements/active-element/index.d.ts",
+      "default": "./fesm2022/signality-core-elements-active-element.mjs"
+    },
+    "./elements/dropzone": {
+      "types": "./elements/dropzone/index.d.ts",
+      "default": "./fesm2022/signality-core-elements-dropzone.mjs"
+    },
+    "./elements/element-focus": {
+      "types": "./elements/element-focus/index.d.ts",
+      "default": "./fesm2022/signality-core-elements-element-focus.mjs"
+    },
+    "./elements/element-focus-within": {
+      "types": "./elements/element-focus-within/index.d.ts",
+      "default": "./fesm2022/signality-core-elements-element-focus-within.mjs"
+    },
+    "./elements/element-hover": {
+      "types": "./elements/element-hover/index.d.ts",
+      "default": "./fesm2022/signality-core-elements-element-hover.mjs"
+    },
+    "./elements/element-size": {
+      "types": "./elements/element-size/index.d.ts",
+      "default": "./fesm2022/signality-core-elements-element-size.mjs"
+    },
+    "./elements/element-visibility": {
+      "types": "./elements/element-visibility/index.d.ts",
+      "default": "./fesm2022/signality-core-elements-element-visibility.mjs"
+    },
+    "./elements/mouse-position": {
+      "types": "./elements/mouse-position/index.d.ts",
+      "default": "./fesm2022/signality-core-elements-mouse-position.mjs"
+    },
+    "./elements/on-click-outside": {
+      "types": "./elements/on-click-outside/index.d.ts",
+      "default": "./fesm2022/signality-core-elements-on-click-outside.mjs"
+    },
+    "./elements/on-disconnect": {
+      "types": "./elements/on-disconnect/index.d.ts",
+      "default": "./fesm2022/signality-core-elements-on-disconnect.mjs"
+    },
+    "./elements/on-long-press": {
+      "types": "./elements/on-long-press/index.d.ts",
+      "default": "./fesm2022/signality-core-elements-on-long-press.mjs"
+    },
+    "./elements/pointer-swipe": {
+      "types": "./elements/pointer-swipe/index.d.ts",
+      "default": "./fesm2022/signality-core-elements-pointer-swipe.mjs"
+    },
+    "./elements/scroll-position": {
+      "types": "./elements/scroll-position/index.d.ts",
+      "default": "./fesm2022/signality-core-elements-scroll-position.mjs"
+    },
+    "./elements/swipe": {
+      "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"
+    },
+    "./observers/intersection-observer": {
+      "types": "./observers/intersection-observer/index.d.ts",
+      "default": "./fesm2022/signality-core-observers-intersection-observer.mjs"
+    },
+    "./observers/mutation-observer": {
+      "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"
+    },
+    "./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"
+    },
+    "./router/fragment": {
+      "types": "./router/fragment/index.d.ts",
+      "default": "./fesm2022/signality-core-router-fragment.mjs"
+    },
+    "./router/params": {
+      "types": "./router/params/index.d.ts",
+      "default": "./fesm2022/signality-core-router-params.mjs"
+    },
+    "./router/query-params": {
+      "types": "./router/query-params/index.d.ts",
+      "default": "./fesm2022/signality-core-router-query-params.mjs"
+    },
+    "./router/route-data": {
+      "types": "./router/route-data/index.d.ts",
+      "default": "./fesm2022/signality-core-router-route-data.mjs"
+    },
+    "./router/router-listener": {
+      "types": "./router/router-listener/index.d.ts",
+      "default": "./fesm2022/signality-core-router-router-listener.mjs"
+    },
+    "./router/title": {
+      "types": "./router/title/index.d.ts",
+      "default": "./fesm2022/signality-core-router-title.mjs"
+    },
+    "./router/url": {
+      "types": "./router/url/index.d.ts",
+      "default": "./fesm2022/signality-core-router-url.mjs"
+    },
+    "./scheduling/debounce-callback": {
+      "types": "./scheduling/debounce-callback/index.d.ts",
+      "default": "./fesm2022/signality-core-scheduling-debounce-callback.mjs"
+    },
+    "./scheduling/interval": {
+      "types": "./scheduling/interval/index.d.ts",
+      "default": "./fesm2022/signality-core-scheduling-interval.mjs"
+    },
+    "./scheduling/throttle-callback": {
+      "types": "./scheduling/throttle-callback/index.d.ts",
+      "default": "./fesm2022/signality-core-scheduling-throttle-callback.mjs"
+    }
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

package/reactivity/debounced/index.d.ts

@@ -0,0 +1,50 @@
+import { type CreateSignalOptions, type Signal, type WritableSignal } from '@angular/core';
+import type { MaybeSignal, SignalValue, WithInjector } from '@signality/core/types';
+export type DebouncedOptions<T> = CreateSignalOptions<T> & WithInjector;
+/**
+ * Creates a debounced readonly signal from a source signal.
+ * Updates to the source signal are debounced before propagating to the returned signal.
+ *
+ * @param source - Source signal to debounce
+ * @param timeMs - Debounce delay in milliseconds
+ * @param options - Optional configuration including signal options and injector
+ * @returns A readonly signal that updates after the debounce delay
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <input [(ngModel)]="query" />
+ *     <p>Debounced value: {{ debouncedQuery() }}</p>
+ *   `
+ * })
+ * class SearchInput {
+ *   readonly query = signal('');
+ *   readonly debouncedQuery = debounced(this.query, 300);
+ * }
+ * ```
+ */
+export declare function debounced<S extends Signal<any>>(source: S, timeMs: MaybeSignal<number>, options?: DebouncedOptions<SignalValue<S>>): Signal<SignalValue<S>>;
+/**
+ * Creates a debounced writable signal from an initial value.
+ * Both `set()` and `update()` calls are debounced.
+ *
+ * @param value - Initial value
+ * @param timeMs - Debounce delay in milliseconds
+ * @param options - Optional configuration including signal options and injector
+ * @returns A writable signal where updates are debounced
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <input [(ngModel)]="query" />
+ *     <p>Search results for: {{ query() }}</p>
+ *   `
+ * })
+ * class SearchInput {
+ *   readonly query = debounced('', 300);
+ * }
+ * ```
+ */
+export declare function debounced<V>(value: V, timeMs: MaybeSignal<number>, options?: DebouncedOptions<V>): WritableSignal<V>;

package/reactivity/index.d.ts

@@ -0,0 +1,3 @@
+export * from '@signality/core/reactivity/debounced';
+export * from '@signality/core/reactivity/throttled';
+export * from '@signality/core/reactivity/watcher';

package/reactivity/throttled/index.d.ts

@@ -0,0 +1,53 @@
+import { type CreateSignalOptions, type Signal, type WritableSignal } from '@angular/core';
+import type { MaybeSignal, SignalValue, WithInjector } from '@signality/core/types';
+export type ThrottledOptions<T> = CreateSignalOptions<T> & WithInjector;
+/**
+ * Creates a throttled readonly signal from a source signal.
+ * Updates to the source signal are throttled to occur at most once per time interval.
+ *
+ * @param source - Source signal to throttle
+ * @param timeMs - Throttle interval in milliseconds
+ * @param options - Optional configuration including signal options and injector
+ * @returns A readonly signal that updates at most once per throttle interval
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <div (scroll)="scrollY.set($event.target.scrollTop)">
+ *       <p>Scroll position: {{ scrollY() }}</p>
+ *       <p>Throttled position: {{ throttledScrollY() }}</p>
+ *     </div>
+ *   `
+ * })
+ * class ScrollTracker {
+ *   readonly scrollY = signal(0);
+ *   readonly throttledScrollY = throttled(this.scrollY, 100);
+ * }
+ * ```
+ */
+export declare function throttled<S extends Signal<any>>(source: S, timeMs: MaybeSignal<number>, options?: ThrottledOptions<SignalValue<S>>): Signal<SignalValue<S>>;
+/**
+ * Creates a throttled writable signal from an initial value.
+ * Both `set()` and `update()` calls are throttled.
+ *
+ * @param value - Initial value
+ * @param timeMs - Throttle interval in milliseconds
+ * @param options - Optional configuration including signal options and injector
+ * @returns A writable signal where updates are throttled
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <div (mousemove)="mousePosition.set({ x: $event.clientX, y: $event.clientY })">
+ *       <p>Mouse position: X={{ mousePosition().x }}, Y={{ mousePosition().y }}</p>
+ *     </div>
+ *   `
+ * })
+ * class MouseTracker {
+ *   readonly mousePosition = throttled({ x: 0, y: 0 }, 16);
+ * }
+ * ```
+ */
+export declare function throttled<V>(value: V, timeMs: MaybeSignal<number>, options?: ThrottledOptions<V>): WritableSignal<V>;

package/reactivity/watcher/index.d.ts

@@ -0,0 +1,68 @@
+import { type CreateEffectOptions, type EffectCleanupRegisterFn, type EffectRef, type Signal } from '@angular/core';
+import type { SignalValues } from '@signality/core/types';
+export interface CreateWatcherOptions extends Omit<CreateEffectOptions, 'allowSignalWrites'> {
+    /**
+     * If `true`, the watcher will automatically destroy itself after the first change.
+     * @default false
+     */
+    readonly once?: boolean;
+}
+export type WatcherRef = EffectRef;
+/**
+ * Watches a single signal and calls a callback when it changes, skipping the initial call.
+ * Unlike `effect()`, this responds to the fact of state change, enabling event-like orchestration of side effects.
+ *
+ * @param source - Signal to watch
+ * @param fn - Callback function called when signal changes. Receives current value, previous value, and cleanup function
+ * @param options - Optional configuration including effect options and injector
+ * @returns A WatcherRef (alias for EffectRef) that can be used to manually destroy the watcher
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <button (click)="count.set(count() + 1)">Count: {{ count() }}</button>
+ *   `
+ * })
+ * class CounterComponent {
+ *   readonly count = signal(0);
+ *
+ *   constructor() {
+ *     watcher(this.count, (curr, prev) => {
+ *       console.log('Count changed from', prev, 'to', curr);
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export declare function watcher<V>(source: Signal<V>, fn: (curr: V, prev: V, onCleanup: EffectCleanupRegisterFn) => void, options?: CreateWatcherOptions): WatcherRef;
+/**
+ * Watches multiple signals and calls a callback when any of them changes, skipping the initial call.
+ * Unlike `effect()`, this responds to the fact of state change, enabling event-like orchestration of side effects.
+ *
+ * @param sources - Array of signals to watch
+ * @param fn - Callback function called when any signal changes. Receives current values array, previous values array, and cleanup function
+ * @param options - Optional configuration including effect options and injector
+ * @returns A WatcherRef (alias for EffectRef) that can be used to manually destroy the watcher
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <input [(ngModel)]="name" />
+ *     <input [(ngModel)]="age" type="number" />
+ *   `
+ * })
+ * class UserComponent {
+ *   readonly name = signal('John');
+ *   readonly age = signal(25);
+ *
+ *   constructor() {
+ *     watcher([this.name, this.age], ([name, age], [prevName, prevAge]) => {
+ *       console.log('User changed:', { name, age });
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export declare function watcher<T extends readonly Signal<any>[]>(sources: T, fn: (curr: SignalValues<T>, prev: SignalValues<T>, onCleanup: EffectCleanupRegisterFn) => void, options?: CreateWatcherOptions): WatcherRef;

package/router/fragment/index.d.ts

@@ -0,0 +1,26 @@
+import { type CreateSignalOptions, type Signal } from '@angular/core';
+import type { WithInjector } from '@signality/core/types';
+export type FragmentOptions = CreateSignalOptions<string | null> & WithInjector;
+/**
+ * Reactive wrapper around the [Angular Router](https://angular.dev/guide/routing) URL fragment.
+ *
+ * @param options - Optional configuration including signal options and injector
+ * @returns A signal containing the current URL fragment (without #), or null
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     @if (currentFragment(); as fragment) {
+ *       <p>Current section: {{ fragment }}</p>
+ *     } @else {
+ *       <p>No fragment in URL</p>
+ *     }
+ *   `
+ * })
+ * class FragmentComponent {
+ *   readonly currentFragment = fragment();
+ * }
+ * ```
+ */
+export declare function fragment(options?: FragmentOptions): Signal<string | null>;

package/router/index.d.ts

@@ -0,0 +1,7 @@
+export * from '@signality/core/router/params';
+export * from '@signality/core/router/query-params';
+export * from '@signality/core/router/fragment';
+export * from '@signality/core/router/title';
+export * from '@signality/core/router/url';
+export * from '@signality/core/router/route-data';
+export * from '@signality/core/router/router-listener';

package/router/params/index.d.ts

@@ -0,0 +1,28 @@
+import { type CreateSignalOptions, type Signal } from '@angular/core';
+import { type Params } from '@angular/router';
+import type { WithInjector } from '@signality/core/types';
+export type ParamsOptions<T extends Params = Params> = CreateSignalOptions<T> & WithInjector;
+/**
+ * Reactive wrapper around Angular Router's route parameters.
+ * Access route parameters as a signal that updates when navigation occurs.
+ *
+ * @param options - Optional configuration including signal options and injector
+ * @returns A signal containing the current route parameters
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <div>
+ *       <p>User ID: {{ routeParams().id }}</p>
+ *       <p>Slug: {{ routeParams().slug }}</p>
+ *     </div>
+ *   `
+ * })
+ * class UserComponent {
+ *   // Route: /user/:id/:slug
+ *   readonly routeParams = params<{ id: string; slug: string }>();
+ * }
+ * ```
+ */
+export declare function params<T extends Params = Params>(options?: ParamsOptions<T>): Signal<T>;

package/router/query-params/index.d.ts

@@ -0,0 +1,80 @@
+import { type CreateSignalOptions, type Signal } from '@angular/core';
+import { type Params } from '@angular/router';
+import type { WithInjector } from '@signality/core/types';
+export interface QueryParamsValidator<T> {
+    /**
+     * Parse and validate data, throwing an error if validation fails.
+     */
+    parse(data: unknown): T;
+}
+export interface QueryParamsRef<T> {
+    /**
+     * Signal containing validated query parameters.
+     * Throws an error if validation failed. Use `isValid()` to check before reading.
+     */
+    readonly value: Signal<T>;
+    /**
+     * Signal indicating whether the current query parameters are valid.
+     * Returns `true` when validation succeeded, `false` when validation failed.
+     */
+    readonly isValid: Signal<boolean>;
+    /** Signal containing validation error, or null if valid */
+    readonly error: Signal<unknown | null>;
+}
+export type QueryParamsOptions<T extends Params = Params> = CreateSignalOptions<T> & WithInjector;
+export type QueryParamsWithSchemaOptions<T extends Params = Params> = QueryParamsOptions<T> & {
+    /** Validator schema (e.g., Zod schema) */
+    readonly schema: QueryParamsValidator<T>;
+};
+/**
+ * Reactive wrapper around the [Angular Router](https://angular.dev/guide/routing) query parameters.
+ *
+ * @param options - Optional configuration including signal options and injector
+ * @returns A signal containing the current query parameters
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <div>
+ *       <p>Search: {{ searchParams().q }}</p>
+ *       <p>Sort: {{ searchParams().sort }}</p>
+ *     </div>
+ *   `
+ * })
+ * class SearchComponent {
+ *   // Route: /search?q=angular&sort=name
+ *   readonly searchParams = queryParams<{ q: string; sort: string }>();
+ * }
+ * ```
+ */
+export declare function queryParams<T extends Params = Params>(options?: QueryParamsOptions<T>): Signal<T>;
+/**
+ * Reactive wrapper around the [Angular Router](https://angular.dev/guide/routing) query parameters with schema validation.
+ *
+ * @param options - Configuration including schema validator
+ * @returns A QueryParamsRef object with value, isValid, and error signals
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     @if (params.isValid()) {
+ *       <p>Search: {{ params.value().q }}</p>
+ *       <p>Page: {{ params.value().page }}</p>
+ *     } @else {
+ *       <p>Invalid parameters</p>
+ *     }
+ *   `
+ * })
+ * class ValidatedSearchComponent {
+ *   readonly schema = z.object({
+ *     q: z.string().min(1).optional(),
+ *     page: z.coerce.number().int().positive().default(1),
+ *   });
+ *
+ *   readonly params = queryParams({ schema: this.schema });
+ * }
+ * ```
+ */
+export declare function queryParams<T extends Params = Params>(options: QueryParamsWithSchemaOptions<T>): QueryParamsRef<T>;