ngwr 6.0.0 → 7.0.0

package/types/ngwr-pipes.d.ts

@@ -0,0 +1,177 @@
+import * as i0 from '@angular/core';
+import { PipeTransform } from '@angular/core';
+import { WrDateFormat } from 'ngwr/date-adapter';
+import { SafeHtml } from '@angular/platform-browser';
+
+/**
+ * Humanise a byte count using binary (1024-based) units.
+ *
+ * @example
+ * ```html
+ * {{ 1234 | wrBytes }}            <!-- "1.2 KB"   -->
+ * {{ 1234567 | wrBytes: 0 }}      <!-- "1 MB"     -->
+ * {{ 0 | wrBytes }}               <!-- "0 B"      -->
+ * ```
+ */
+declare class WrBytes implements PipeTransform {
+    transform(value: number | string | null | undefined, decimals?: number): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WrBytes, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<WrBytes, "wrBytes", true>;
+}
+
+/**
+ * Locale-aware date formatting. Delegates to `WrDateAdapter` when
+ * `provideWrDateAdapter()` is in the provider tree (giving access to named
+ * format keys like `'shortDate'` and `'longDate'`), otherwise falls back to
+ * a minimal `Intl.DateTimeFormat`-based formatter so the pipe still works
+ * without the date-adapter package wired up.
+ *
+ * @example
+ * ```html
+ * {{ now | wrDate }}                          <!-- shortDate            -->
+ * {{ now | wrDate: 'mediumDateTime' }}        <!-- named key            -->
+ * {{ now | wrDate: 'dd.MM.yyyy' }}            <!-- raw token string     -->
+ * ```
+ */
+declare class WrDate implements PipeTransform {
+    private readonly adapter;
+    private readonly locale;
+    transform(value: Date | string | number | null | undefined, format?: WrDateFormat | (string & {})): string;
+    /** Tiny fallback for the named keys when no adapter is provided. */
+    private fallback;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WrDate, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<WrDate, "wrDate", true>;
+}
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+
+/**
+ * Wrap every occurrence of `query` in `<mark>` tags. Useful for highlighting
+ * search-term matches in autocomplete results, lists, and table cells.
+ *
+ * The output is `SafeHtml` — bind with `[innerHTML]`. Input is escaped first
+ * so user-supplied values can't inject markup.
+ *
+ * @example
+ * ```html
+ * <span [innerHTML]="row.name | wrMark: query()"></span>
+ *
+ * <!-- Case-sensitive: -->
+ * <span [innerHTML]="row.name | wrMark: query() : true"></span>
+ * ```
+ */
+declare class WrMark implements PipeTransform {
+    private readonly sanitizer;
+    /**
+     * @param value Source text.
+     * @param query Search term to highlight. Empty/null skips the wrap.
+     * @param caseSensitive Match exactly. @default false
+     */
+    transform(value: string | null | undefined, query: string | null | undefined, caseSensitive?: boolean): SafeHtml;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WrMark, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<WrMark, "wrMark", true>;
+}
+
+/** Word forms keyed by CLDR plural category. Only `other` is required. */
+type WrPluralForms = Partial<Record<Intl.LDMLPluralRule, string>> & {
+    readonly other: string;
+};
+interface WrPluralOptions {
+    /** Prefix the formatted count before the word. @default true */
+    readonly includeValue?: boolean;
+    /** Locale override; defaults to Angular's `LOCALE_ID`. */
+    readonly locale?: string;
+}
+/** Built-in style shortcuts — pick a sensible `Intl.NumberFormat` preset by name. */
+type WrNumberStyle = 'decimal' | 'percent' | 'currency';
+
+/**
+ * Locale-aware number formatting via `Intl.NumberFormat`. Uses Angular's
+ * `LOCALE_ID` as the default locale.
+ *
+ * Accepts either a style shortcut (with optional currency code) or a full
+ * `Intl.NumberFormatOptions` object for fine-grained control.
+ *
+ * @example
+ * ```html
+ * {{ 1234.5 | wrNumber }}                       <!-- "1,234.5"   -->
+ * {{ 0.875  | wrNumber: 'percent' }}            <!-- "88%"       -->
+ * {{ 19.99  | wrNumber: 'currency': 'USD' }}    <!-- "$19.99"    -->
+ * {{ 19.99  | wrNumber: { minimumFractionDigits: 2 } }}
+ * ```
+ */
+declare class WrNumber implements PipeTransform {
+    private readonly locale;
+    transform(value: number | string | null | undefined, styleOrOptions?: WrNumberStyle | Intl.NumberFormatOptions, currency?: string): string;
+    private toOptions;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WrNumber, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<WrNumber, "wrNumber", true>;
+}
+
+/**
+ * Locale-aware pluralization via `Intl.PluralRules`. Picks the right word
+ * form for the count — including languages with more than two forms
+ * (Russian, Polish, Arabic, …) — without hand-rolled `n % 10` rules.
+ *
+ * Categories follow CLDR: `zero` / `one` / `two` / `few` / `many` /
+ * `other`. Missing categories fall back to `other`.
+ *
+ * @example
+ * ```html
+ * {{ 1 | wrPlural: { one: 'comment', other: 'comments' } }}
+ * <!-- "1 comment" -->
+ *
+ * {{ 5 | wrPlural: { one: 'файл', few: 'файла', other: 'файлов' } }}
+ * <!-- "5 файлов" (with LOCALE_ID = ru) -->
+ *
+ * {{ count() | wrPlural: forms : { includeValue: false } }}
+ * <!-- word only -->
+ * ```
+ */
+declare class WrPlural implements PipeTransform {
+    private readonly locale;
+    transform(value: number | null | undefined, forms: WrPluralForms, options?: WrPluralOptions): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WrPlural, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<WrPlural, "wrPlural", true>;
+}
+
+/**
+ * Creates an array of sequential indices `[0, 1, 2, ..., n-1]`.
+ *
+ * Useful for repeating template blocks a fixed number of times.
+ *
+ * @example
+ * ```html
+ * @for (i of (5 | wrRange); track i) {
+ *   <div>Item {{ i }}</div>
+ * }
+ * ```
+ */
+declare class WrRange implements PipeTransform {
+    transform(length: number): number[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<WrRange, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<WrRange, "wrRange", true>;
+}
+
+/**
+ * Clamp a string to `length` characters, appending `ellipsis` when truncated.
+ *
+ * @example
+ * ```html
+ * {{ 'Hello, world' | wrTruncate: 5 }}           <!-- "Hello…"      -->
+ * {{ 'Hello, world' | wrTruncate: 8: '...' }}    <!-- "Hello, w..." -->
+ * ```
+ */
+declare class WrTruncate implements PipeTransform {
+    transform(value: string | null | undefined, length?: number, ellipsis?: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WrTruncate, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<WrTruncate, "wrTruncate", true>;
+}
+
+export { WrBytes, WrDate, WrMark, WrNumber, WrPlural, WrRange, WrTruncate };
+export type { WrNumberStyle, WrPluralForms, WrPluralOptions };

package/types/ngwr-platform.d.ts

@@ -0,0 +1,38 @@
+import * as i0 from '@angular/core';
+import { Signal } from '@angular/core';
+
+/**
+ * SSR-safe environment probes. Use to gate browser-only code paths and
+ * react to user preferences without scattering `matchMedia` calls around.
+ *
+ * - `isBrowser` / `isServer` — synchronous platform check.
+ * - `userAgent` — `navigator.userAgent` or `null` on the server.
+ * - `prefersDark` — signal mirroring `(prefers-color-scheme: dark)`.
+ * - `prefersReducedMotion` — signal mirroring `(prefers-reduced-motion: reduce)`.
+ *
+ * @example
+ * ```ts
+ * private readonly platform = inject(WrPlatform);
+ * if (this.platform.isBrowser) {
+ *   localStorage.setItem('theme', 'dark');
+ * }
+ *
+ * protected readonly dark = this.platform.prefersDark;
+ * ```
+ *
+ * @see https://ngwr.dev/services/platform
+ */
+declare class WrPlatform {
+    private readonly destroyRef;
+    private readonly doc;
+    readonly isBrowser: boolean;
+    readonly isServer: boolean;
+    readonly userAgent: string | null;
+    readonly prefersDark: Signal<boolean>;
+    readonly prefersReducedMotion: Signal<boolean>;
+    private mediaSignal;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WrPlatform, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<WrPlatform>;
+}
+
+export { WrPlatform };

package/types/ngwr-popconfirm.d.ts

@@ -0,0 +1,79 @@
+import * as _angular_core from '@angular/core';
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+
+type WrPopconfirmPosition = 'top' | 'bottom' | 'left' | 'right';
+
+/**
+ * Small "Are you sure?" panel anchored to its trigger. Fires `confirmed`
+ * or `cancelled` and closes automatically. Built on CDK Overlay.
+ *
+ * @example
+ * ```html
+ * <wr-btn
+ *   color="danger"
+ *   [wrPopconfirm]="'Delete this item?'"
+ *   confirmColor="danger"
+ *   confirmText="Delete"
+ *   (confirmed)="remove()"
+ * >Delete</wr-btn>
+ * ```
+ *
+ * @see https://ngwr.dev/components/popconfirm
+ */
+declare class WrPopconfirm {
+    /** Confirmation message. */
+    readonly message: _angular_core.InputSignal<string>;
+    /** Anchor side. @default 'top' */
+    readonly position: _angular_core.InputSignal<WrPopconfirmPosition>;
+    /** Label for the confirm button. @default 'Confirm' */
+    readonly confirmText: _angular_core.InputSignal<string>;
+    /** Label for the cancel button. @default 'Cancel' */
+    readonly cancelText: _angular_core.InputSignal<string>;
+    /** Color of the confirm button. @default 'primary' */
+    readonly confirmColor: _angular_core.InputSignal<"primary" | "secondary" | "success" | "warning" | "danger" | "light" | "medium" | "dark">;
+    /** Fires when the user clicks confirm. */
+    readonly confirmed: _angular_core.OutputEmitterRef<void>;
+    /** Fires when the user clicks cancel or dismisses the overlay. */
+    readonly cancelled: _angular_core.OutputEmitterRef<void>;
+    private readonly host;
+    private readonly overlay;
+    private readonly vcr;
+    private readonly scrollStrategies;
+    private readonly destroyRef;
+    private overlayRef;
+    constructor();
+    /** @internal */
+    protected toggle(event: MouseEvent): void;
+    open(): void;
+    close(): void;
+    private dismiss;
+    private dispose;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrPopconfirm, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<WrPopconfirm, "[wrPopconfirm]", never, { "message": { "alias": "wrPopconfirm"; "required": true; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "confirmText": { "alias": "confirmText"; "required": false; "isSignal": true; }; "cancelText": { "alias": "cancelText"; "required": false; "isSignal": true; }; "confirmColor": { "alias": "confirmColor"; "required": false; "isSignal": true; }; }, { "confirmed": "confirmed"; "cancelled": "cancelled"; }, never, never, true, never>;
+}
+
+/**
+ * Confirmation panel rendered inside the popconfirm overlay. Not part
+ * of the public template API — use `[wrPopconfirm]` instead.
+ *
+ * @internal
+ */
+declare class WrPopconfirmPanel {
+    readonly message: _angular_core.InputSignal<string>;
+    readonly confirmText: _angular_core.InputSignal<string>;
+    readonly cancelText: _angular_core.InputSignal<string>;
+    readonly confirmColor: _angular_core.InputSignal<"primary" | "secondary" | "success" | "warning" | "danger" | "light" | "medium" | "dark">;
+    readonly confirmed: _angular_core.OutputEmitterRef<void>;
+    readonly cancelled: _angular_core.OutputEmitterRef<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrPopconfirmPanel, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrPopconfirmPanel, "wr-popconfirm", never, { "message": { "alias": "message"; "required": true; "isSignal": true; }; "confirmText": { "alias": "confirmText"; "required": false; "isSignal": true; }; "cancelText": { "alias": "cancelText"; "required": false; "isSignal": true; }; "confirmColor": { "alias": "confirmColor"; "required": false; "isSignal": true; }; }, { "confirmed": "confirmed"; "cancelled": "cancelled"; }, never, never, true, never>;
+}
+
+export { WrPopconfirm, WrPopconfirmPanel };
+export type { WrPopconfirmPosition };

package/types/ngwr-popover.d.ts

@@ -0,0 +1,90 @@
+import * as _angular_core from '@angular/core';
+import { TemplateRef } from '@angular/core';
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+
+type WrPopoverPosition = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'right';
+
+declare class WrPopover {
+    /**
+     * Content to render inside the panel.
+     * - In **popover** mode (default): pass a `TemplateRef`.
+     * - In **tooltip** mode: pass a plain string.
+     */
+    readonly content: _angular_core.InputSignal<string | TemplateRef<unknown>>;
+    /**
+     * Shape preset.
+     *
+     * - `'popover'` (default) — template content, click trigger, dialog
+     *   semantics.
+     * - `'tooltip'` — text content, hover+focus trigger, `role="tooltip"`,
+     *   `aria-describedby` on the host.
+     */
+    readonly mode: _angular_core.InputSignal<"tooltip" | "popover">;
+    /**
+     * How the popover opens. Ignored in tooltip mode — tooltips are always
+     * hover+focus. @default 'click'
+     */
+    readonly trigger: _angular_core.InputSignal<"click" | "hover">;
+    /** Anchor side. @default 'bottom' for popover, 'top' for tooltip */
+    readonly position: _angular_core.InputSignal<WrPopoverPosition | null>;
+    /** Tooltip only — delay before showing, in ms. @default 120 */
+    readonly showDelay: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Tooltip only — delay before hiding, in ms. @default 60 */
+    readonly hideDelay: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Fires after the panel opens. */
+    readonly opened: _angular_core.OutputEmitterRef<void>;
+    /** Fires after the panel closes. */
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    private readonly host;
+    private readonly overlay;
+    private readonly vcr;
+    private readonly scrollStrategies;
+    private readonly destroyRef;
+    /** @internal */
+    readonly isOpen: _angular_core.WritableSignal<boolean>;
+    /** @internal */
+    protected readonly isTooltip: _angular_core.Signal<boolean>;
+    /** Auto-generated id for `aria-controls` / `aria-describedby`. */
+    protected readonly panelId: string;
+    private readonly resolvedPosition;
+    private overlayRef;
+    private hoverCloseTimer;
+    private showTimer;
+    private hideTimer;
+    constructor();
+    open(): void;
+    close(): void;
+    toggle(): void;
+    /** @internal */
+    protected onClick(event: MouseEvent): void;
+    /** @internal */
+    protected onMouseEnter(): void;
+    /** @internal */
+    protected onMouseLeave(event: MouseEvent): void;
+    /** @internal */
+    protected onFocus(): void;
+    /** @internal */
+    protected onBlur(): void;
+    /** @internal */
+    protected onEscape(): void;
+    private scheduleShow;
+    private scheduleHide;
+    private clearTimers;
+    private openOverlay;
+    private closeOverlay;
+    private readonly onOverlayLeave;
+    private readonly onOverlayEnter;
+    private scheduleHoverClose;
+    private clearHoverClose;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrPopover, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<WrPopover, "[wrPopover]", never, { "content": { "alias": "wrPopover"; "required": true; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "trigger": { "alias": "trigger"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "showDelay": { "alias": "showDelay"; "required": false; "isSignal": true; }; "hideDelay": { "alias": "hideDelay"; "required": false; "isSignal": true; }; }, { "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
+}
+
+export { WrPopover };
+export type { WrPopoverPosition };

package/types/ngwr-progress.d.ts

@@ -0,0 +1,33 @@
+import * as _angular_core from '@angular/core';
+
+/**
+ * Horizontal progress bar.
+ *
+ * @example
+ * ```html
+ * <wr-progress [value]="42" />
+ * <wr-progress color="success" [value]="80" />
+ * ```
+ *
+ * @see https://ngwr.dev/components/progress
+ */
+declare class WrProgress {
+    /**
+     * Bar color.
+     *
+     * @default 'primary'
+     */
+    readonly color: _angular_core.InputSignal<"primary" | "secondary" | "success" | "warning" | "danger" | "light" | "medium" | "dark">;
+    /**
+     * Progress value, clamped to `[0, 100]`.
+     *
+     * @default 0
+     */
+    readonly value: _angular_core.InputSignalWithTransform<number, unknown>;
+    protected readonly clamped: _angular_core.Signal<number>;
+    protected readonly classes: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrProgress, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrProgress, "wr-progress", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { WrProgress };

package/types/ngwr-qr.d.ts

@@ -0,0 +1,56 @@
+import * as _angular_core from '@angular/core';
+import { ElementRef } from '@angular/core';
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+/**
+ * QR code error correction level.
+ *
+ * - `'L'` — Low (~7%)
+ * - `'M'` — Medium (~15%)
+ * - `'Q'` — Quartile (~25%)
+ * - `'H'` — High (~30%) — needed if overlaying a center icon
+ */
+type WrQrErrorLevel = 'L' | 'M' | 'Q' | 'H';
+
+/**
+ * Renders a QR code on a `<canvas>`.
+ *
+ * @example
+ * ```html
+ * <wr-qr value="https://ngwr.dev" [size]="200" level="H" />
+ * <wr-qr value="..." iconUrl="/logo.png" [iconSize]="48" level="H" />
+ * ```
+ *
+ * @see https://ngwr.dev/components/qrcode
+ */
+declare class WrQr {
+    /** Text or URL to encode. Required. */
+    readonly value: _angular_core.InputSignal<string>;
+    /** Error correction level. Use `'H'` if you overlay an icon. @default 'M' */
+    readonly level: _angular_core.InputSignal<WrQrErrorLevel>;
+    /** Side length of the rendered canvas, in pixels. @default 160 */
+    readonly size: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Outer quiet-zone padding in pixels. @default 10 */
+    readonly padding: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Module (dot) color. @default '#000000' */
+    readonly color: _angular_core.InputSignal<string>;
+    /** Background color of the canvas + host. @default '#ffffff' */
+    readonly bgColor: _angular_core.InputSignal<string>;
+    /** Optional image URL or data URL to overlay in the center. */
+    readonly iconUrl: _angular_core.InputSignal<string | null>;
+    /** Center icon size in logical pixels. @default 42 */
+    readonly iconSize: _angular_core.InputSignalWithTransform<number, unknown>;
+    protected readonly canvas: _angular_core.Signal<ElementRef<HTMLCanvasElement> | undefined>;
+    protected readonly isBrowser: boolean;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrQr, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrQr, "wr-qr", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; "level": { "alias": "level"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "padding": { "alias": "padding"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "bgColor": { "alias": "bgColor"; "required": false; "isSignal": true; }; "iconUrl": { "alias": "iconUrl"; "required": false; "isSignal": true; }; "iconSize": { "alias": "iconSize"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { WrQr };
+export type { WrQrErrorLevel };

package/types/ngwr-radio.d.ts

@@ -0,0 +1,120 @@
+import * as _angular_core from '@angular/core';
+import { InjectionToken, Signal } from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+
+/**
+ * Single-choice option. Must be a child of `<wr-radio-group>`.
+ *
+ * @example
+ * ```html
+ * <wr-radio-group [(ngModel)]="size">
+ *   <wr-radio value="sm">Small</wr-radio>
+ *   <wr-radio value="md">Medium</wr-radio>
+ *   <wr-radio value="lg">Large</wr-radio>
+ * </wr-radio-group>
+ * ```
+ *
+ * @see https://ngwr.dev/components/radio
+ */
+declare class WrRadio {
+    /** Stable id used to associate the native input with its label. */
+    readonly id: _angular_core.InputSignal<string>;
+    /** Value selected when this radio is checked. */
+    readonly value: _angular_core.InputSignal<unknown>;
+    /**
+     * Optional icon name rendered inside the dot when checked, in place of the
+     * default solid circle. Use any registered NGWR icon.
+     */
+    readonly icon: _angular_core.InputSignal<string | null>;
+    private readonly group;
+    constructor();
+    protected readonly name: _angular_core.Signal<string>;
+    protected readonly checked: _angular_core.Signal<boolean>;
+    protected readonly disabled: _angular_core.Signal<boolean>;
+    protected readonly classes: _angular_core.Signal<string>;
+    protected onSelect(): void;
+    protected onBlur(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrRadio, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrRadio, "wr-radio", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+
+/**
+ * Contract a radio uses to talk to its parent `<wr-radio-group>`.
+ *
+ * @internal
+ */
+interface WrRadioGroupContext {
+    /** Shared `name` attribute applied to every native input in the group. */
+    readonly name: Signal<string>;
+    /** Currently selected value. */
+    readonly value: Signal<unknown>;
+    /** Whether the entire group is disabled. */
+    readonly isDisabled: Signal<boolean>;
+    /** Select the given value. */
+    select(value: unknown): void;
+    /** Mark the group as touched (called on blur from any child). */
+    touch(): void;
+}
+/**
+ * Token a `<wr-radio>` injects to participate in its parent `<wr-radio-group>`
+ * — reads the selected value, shares the `name` attribute, and signals
+ * selection / blur back up.
+ *
+ * @internal
+ */
+declare const WR_RADIO_GROUP: InjectionToken<WrRadioGroupContext>;
+
+/**
+ * Hosts a group of `<wr-radio>` children as a single-value selection.
+ *
+ * Implements `ControlValueAccessor` — the group's `value` is the
+ * currently selected radio's `value`.
+ *
+ * @example
+ * ```html
+ * <wr-radio-group [(ngModel)]="size">
+ *   <wr-radio value="sm">Small</wr-radio>
+ *   <wr-radio value="md">Medium</wr-radio>
+ *   <wr-radio value="lg">Large</wr-radio>
+ * </wr-radio-group>
+ * ```
+ *
+ * @see https://ngwr.dev/components/radio
+ */
+declare class WrRadioGroup implements ControlValueAccessor, WrRadioGroupContext {
+    /**
+     * Shared `name` attribute. Defaults to a random id so multiple groups
+     * on the same page don't collide.
+     */
+    readonly name: _angular_core.InputSignal<string>;
+    /**
+     * Disable the whole group. Also set by Angular forms via `setDisabledState`.
+     *
+     * @default false
+     */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, any>;
+    readonly value: _angular_core.WritableSignal<unknown>;
+    private readonly disabledFromCva;
+    /** Effective disabled state — true if either source disables. */
+    readonly isDisabled: _angular_core.Signal<boolean>;
+    private onChange;
+    private onTouched;
+    select(value: unknown): void;
+    touch(): void;
+    writeValue(value: unknown): void;
+    registerOnChange(fn: (value: unknown) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrRadioGroup, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrRadioGroup, "wr-radio-group", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+export { WR_RADIO_GROUP, WrRadio, WrRadioGroup };
+export type { WrRadioGroupContext };

package/types/ngwr-rating.d.ts

@@ -0,0 +1,62 @@
+import * as _angular_core from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+
+/**
+ * Star rating input. Click or hover to set a value; supports half-star
+ * increments via `step="0.5"`. Implements `ControlValueAccessor` — value
+ * is `number | null` (clamped to `[0, count]`).
+ *
+ * Keyboard: `←` / `→` bump by `step`, `Home` / `End` jump to 0 / max.
+ * Clicking the current value clears it (toggle off).
+ *
+ * @example
+ * ```html
+ * <wr-rating [(ngModel)]="score" />
+ * <wr-rating [(ngModel)]="score" [count]="10" step="0.5" />
+ * <wr-rating [ngModel]="4.5" [readonly]="true" />
+ * ```
+ *
+ * @see https://ngwr.dev/components/rating
+ */
+declare class WrRating implements ControlValueAccessor {
+    /** Total number of slots. @default 5 */
+    readonly count: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Step granularity — `1` for whole stars, `0.5` for halves. @default 1 */
+    readonly step: _angular_core.InputSignalWithTransform<1 | 0.5, unknown>;
+    /** Read-only — value is displayed but not interactive. @default false */
+    readonly readonly: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Disable interaction. @default false */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Accessible label. @default 'Rating' */
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    /** Last committed value (mirrored from the CVA). */
+    protected readonly value: _angular_core.WritableSignal<number | null>;
+    /** Transient hover preview — overrides `value` for display when set. */
+    protected readonly hoverValue: _angular_core.WritableSignal<number | null>;
+    private readonly disabledFromCva;
+    protected readonly effectiveDisabled: _angular_core.Signal<boolean>;
+    protected readonly interactive: _angular_core.Signal<boolean>;
+    /** What we actually render — hover wins while hovering. */
+    protected readonly displayValue: _angular_core.Signal<number>;
+    protected readonly slots: _angular_core.Signal<number[]>;
+    protected readonly classes: _angular_core.Signal<string>;
+    /** Fill ratio for slot `i` in `[0, 1]` — drives the CSS clip width. */
+    protected fillFor(i: number): number;
+    private onChange;
+    private onTouched;
+    writeValue(value: number | null): void;
+    registerOnChange(fn: (value: number | null) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    protected onSlotMove(event: MouseEvent, index: number): void;
+    protected onLeave(): void;
+    protected onSlotClick(event: MouseEvent, index: number): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    /** Convert a mouse position over slot `index` to a snapped value. */
+    private computeValue;
+    private commit;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrRating, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrRating, "wr-rating", never, { "count": { "alias": "count"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { WrRating };