ngwr 7.3.0 → 9.0.0

package/types/ngwr-checkbox.d.ts

@@ -1,31 +1,39 @@
 import * as _angular_core from '@angular/core';
 import { InjectionToken, Signal } from '@angular/core';
-import { ControlValueAccessor } from '@angular/forms';
+import { FormCheckboxControl, FormValueControl } from '@angular/forms/signals';
 
 /**
  * Two-state checkbox.
  *
- * **Standalone mode** — boolean value, works as a `ControlValueAccessor`:
+ * A signal-forms native control: it implements `FormCheckboxControl`, so
+ * `[formField]` binds straight to its `checked` model — no
+ * `ControlValueAccessor` in between. `[(checked)]` works standalone, and
+ * classic `[(ngModel)]` / reactive forms keep working through Angular's bridge.
  *
  * @example
  * ```html
- * <wr-checkbox [(ngModel)]="agree">I agree</wr-checkbox>
+ * <wr-checkbox [(checked)]="agree">I agree</wr-checkbox>
+ * <wr-checkbox [formField]="form.agree">I agree</wr-checkbox>
  * ```
  *
- * **Inside `<wr-checkbox-group>`** — the checkbox's `value` is added to
- * or removed from the group's array. The standalone CVA is ignored.
+ * **Inside `<wr-checkbox-group>`** — the checkbox's `checkboxValue` is added to
+ * or removed from the group's array, and the group is the native form control.
+ * (The identity input is `checkboxValue`, not `value`, because
+ * `FormCheckboxControl` reserves `value` — its form state is the boolean
+ * `checked`.)
  *
  * @example
  * ```html
- * <wr-checkbox-group [(ngModel)]="features">
- *   <wr-checkbox value="autosave">Autosave</wr-checkbox>
- *   <wr-checkbox value="notifications">Notifications</wr-checkbox>
+ * <wr-checkbox-group [formField]="form.features">
+ *   <wr-checkbox checkboxValue="autosave">Autosave</wr-checkbox>
+ *   <wr-checkbox checkboxValue="notifications">Notifications</wr-checkbox>
  * </wr-checkbox-group>
  * ```
  *
- * @see https://ngwr.dev/components/checkbox
+ * @see https://ngwr.dev/reference/components/checkbox
  */
-declare class WrCheckbox implements ControlValueAccessor {
+type WrCheckboxSize = 'sm' | 'md' | 'lg';
+declare class WrCheckbox implements FormCheckboxControl {
     /**
      * Stable id used to associate the native input with its label.
      *
@@ -33,39 +41,53 @@ declare class WrCheckbox implements ControlValueAccessor {
      */
     readonly id: _angular_core.InputSignal<string>;
     /**
-     * Per-checkbox value used only when inside a `<wr-checkbox-group>`.
-     * Ignored in standalone mode.
+     * This checkbox's identity when inside a `<wr-checkbox-group>` — the value
+     * added to / removed from the group's array. Ignored in standalone mode.
+     * (Named `checkboxValue`, not `value`, because `FormCheckboxControl` reserves
+     * `value`.)
      */
-    readonly value: _angular_core.InputSignal<unknown>;
+    readonly checkboxValue: _angular_core.InputSignal<unknown>;
     /**
-     * Disable the checkbox. Also set automatically by Angular forms.
+     * Checked state — the form value. Bound by `[formField]`, two-way via
+     * `[(checked)]`, or `[(ngModel)]`. Ignored inside a `<wr-checkbox-group>`,
+     * where the group's array is the source of truth.
+     */
+    readonly checked: _angular_core.ModelSignal<boolean>;
+    /** Emitted on blur so a bound field can mark itself touched. */
+    readonly touch: _angular_core.OutputEmitterRef<void>;
+    /**
+     * Disable the checkbox. Bound automatically from the field's disabled state
+     * when used with `[formField]`.
      *
      * @default false
      */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Control size — shares the `--wr-control-*` contract. @default 'md' */
+    readonly size: _angular_core.InputSignal<WrCheckboxSize>;
     /**
      * Optional icon name rendered inside the box when checked, in place of the
      * default checkmark. Use any registered NGWR icon.
      */
     readonly icon: _angular_core.InputSignal<string | null>;
+    /**
+     * Show the indeterminate ("mixed") state — a dash instead of a check. Visual
+     * only and controlled: set it yourself for a parent "select all" whose
+     * children are partly checked, and clear it on the next toggle. Takes visual
+     * precedence over `checked`; the native input reports `aria-checked="mixed"`.
+     *
+     * @default false
+     */
+    readonly indeterminate: _angular_core.InputSignalWithTransform<boolean, any>;
     private readonly group;
-    protected readonly standaloneChecked: _angular_core.WritableSignal<boolean>;
-    protected readonly standaloneDisabledFromCva: _angular_core.WritableSignal<boolean>;
-    /** Derived "is checked". Reads from group when grouped, else local state. */
-    protected readonly checked: _angular_core.Signal<boolean>;
-    /** Effective disabled — input wins, then group, then CVA. */
+    /** Rendered "is checked" — reads the group when grouped, else the `checked` model. */
+    protected readonly isChecked: _angular_core.Signal<boolean>;
+    /** Effective disabled — the `disabled` input wins, then the group. */
     protected readonly effectiveDisabled: _angular_core.Signal<boolean>;
     protected readonly classes: _angular_core.Signal<string>;
-    private onChange;
-    private onTouched;
-    writeValue(value: boolean | null): void;
-    registerOnChange(fn: (value: boolean) => void): void;
-    registerOnTouched(fn: () => void): void;
-    setDisabledState(isDisabled: boolean): void;
     protected onInputChange(event: Event): void;
     protected onInputBlur(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrCheckbox, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrCheckbox, "wr-checkbox", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrCheckbox, "wr-checkbox", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "checkboxValue": { "alias": "checkboxValue"; "required": false; "isSignal": true; }; "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "touch": "touch"; }, never, ["*"], true, never>;
 }
 
 /**
@@ -100,40 +122,41 @@ declare const WR_CHECKBOX_GROUP: InjectionToken<WrCheckboxGroupContext>;
  * Manages a group of `<wr-checkbox>` children as a single form value
  * (an array of the checked items' `value` inputs).
  *
+ * A signal-forms native control: it implements `FormValueControl<unknown[]>`,
+ * so `[formField]` binds to its `value` model. `[(value)]` works standalone,
+ * and classic `[(ngModel)]` / reactive forms keep working through the bridge.
+ *
  * @example
  * ```html
- * <wr-checkbox-group [(ngModel)]="features">
- *   <wr-checkbox value="autosave">Autosave</wr-checkbox>
- *   <wr-checkbox value="notifications">Notifications</wr-checkbox>
- *   <wr-checkbox value="darkmode">Dark mode</wr-checkbox>
+ * <wr-checkbox-group [formField]="form.features">
+ *   <wr-checkbox checkboxValue="autosave">Autosave</wr-checkbox>
+ *   <wr-checkbox checkboxValue="notifications">Notifications</wr-checkbox>
+ *   <wr-checkbox checkboxValue="darkmode">Dark mode</wr-checkbox>
  * </wr-checkbox-group>
  * ```
  *
- * @see https://ngwr.dev/components/checkbox
+ * @see https://ngwr.dev/reference/components/checkbox
  */
-declare class WrCheckboxGroup implements ControlValueAccessor, WrCheckboxGroupContext {
+declare class WrCheckboxGroup implements FormValueControl<unknown[]>, WrCheckboxGroupContext {
     /**
-     * Disable every child checkbox. Also set by Angular forms via
-     * `setDisabledState`.
+     * Disable every child checkbox. Bound automatically from the field's
+     * disabled state when used with `[formField]`.
      *
      * @default false
      */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** The checked items' values. Bound by `[formField]`, or two-way via `[(value)]`. */
+    readonly value: _angular_core.ModelSignal<unknown[]>;
+    /** Emitted when a child toggles so a bound field can mark itself touched. */
+    readonly touch: _angular_core.OutputEmitterRef<void>;
     private readonly selected;
-    private readonly disabledFromCva;
-    /** Effective disabled state — input wins, CVA second. */
+    /** Effective disabled state (WrCheckboxGroupContext). */
     readonly isDisabled: _angular_core.Signal<boolean>;
-    private onChange;
-    private onTouched;
     isSelected(value: unknown): boolean;
     toggle(value: unknown): void;
-    writeValue(value: unknown): void;
-    registerOnChange(fn: (value: unknown[]) => void): void;
-    registerOnTouched(fn: () => void): void;
-    setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrCheckboxGroup, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrCheckboxGroup, "wr-checkbox-group", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrCheckboxGroup, "wr-checkbox-group", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, ["*"], true, never>;
 }
 
 export { WR_CHECKBOX_GROUP, WrCheckbox, WrCheckboxGroup };
-export type { WrCheckboxGroupContext };
+export type { WrCheckboxGroupContext, WrCheckboxSize };

package/types/ngwr-click-spark.d.ts

@@ -19,7 +19,12 @@ type WrClickSparkEasing = 'linear' | 'ease-in' | 'ease-in-out' | 'ease-out';
  * @see https://www.reactbits.dev/animations/click-spark
  */
 declare class WrClickSpark {
-    /** Spark line colour. @default '#fff' */
+    /**
+     * Spark line colour. Accepts any CSS colour, or a `var(--wr-…)` token which is
+     * resolved against the host so it tracks the theme. The default flips with the
+     * theme — dark sparks in light mode, light sparks in dark.
+     * @default 'var(--wr-color-dark)'
+     */
     readonly sparkColor: _angular_core.InputSignal<string>;
     /** Length of each spark line in pixels (at t=0; tapers to 0 at t=1). @default 10 */
     readonly sparkSize: _angular_core.InputSignalWithTransform<number, unknown>;
@@ -41,6 +46,13 @@ declare class WrClickSpark {
     private sparks;
     constructor();
     protected onClick(event: MouseEvent): void;
+    /**
+     * Canvas `strokeStyle` can't read CSS custom properties, so a `var(--wr-…)`
+     * token is resolved against the host's computed style here. Plain colours
+     * pass through untouched. Falls back to a dark literal if the custom
+     * property resolves to nothing.
+     */
+    private resolveColor;
     private syncCanvasSize;
     private watchResize;
     private startLoop;

package/types/ngwr-clipboard.d.ts

@@ -25,7 +25,7 @@ type WrClipboardPermission = 'granted' | 'denied' | 'prompt' | 'unsupported';
  * await clip.permission('write');      // 'granted' | 'denied' | 'prompt' | 'unsupported'
  * ```
  *
- * @see https://ngwr.dev/services/clipboard
+ * @see https://ngwr.dev/reference/services/clipboard
  */
 declare class WrClipboard {
     private readonly doc;
@@ -41,7 +41,18 @@ declare class WrClipboard {
      * when the user denied the permission prompt.
      */
     read(): Promise<string | null>;
-    /** Probe the Permissions API for `clipboard-read` / `clipboard-write`. */
+    /**
+     * Report whether clipboard read / write is available and, when the
+     * browser exposes it, what the user has granted.
+     *
+     * The answer is grounded in the actual Clipboard API capability
+     * (`writeText` / `readText`), then refined by the Permissions API when
+     * it can speak for the requested name. `clipboard-read` / `clipboard-write`
+     * are not recognised everywhere — Firefox and Safari throw on the query —
+     * so a missing or throwing Permissions API is treated as "supported,
+     * will resolve at use time" (`'prompt'`), not `'unsupported'`. We only
+     * return `'unsupported'` when the capability genuinely isn't there.
+     */
     permission(name: 'read' | 'write'): Promise<WrClipboardPermission>;
     /** Hidden-textarea + `execCommand('copy')` write. Synchronous, no permissions. */
     private legacyWrite;

package/types/ngwr-collapse.d.ts

@@ -18,7 +18,7 @@ import { InjectionToken, Signal } from '@angular/core';
  * </wr-collapse-group>
  * ```
  *
- * @see https://ngwr.dev/components/collapse
+ * @see https://ngwr.dev/reference/components/collapse
  */
 declare class WrCollapse {
     /** Header text. */
@@ -89,7 +89,7 @@ interface Member$1 {
  * Visual + behavioral grouping of `<wr-collapse>` children. When
  * `accordion` is true, opening one child closes the others.
  *
- * @see https://ngwr.dev/components/collapse
+ * @see https://ngwr.dev/reference/components/collapse
  */
 declare class WrCollapseGroup implements WrCollapseGroupContext {
     /** When true, only one child may be open at a time. @default false */
@@ -122,7 +122,7 @@ interface Member {
  * </wr-accordion>
  * ```
  *
- * @see https://ngwr.dev/components/collapse
+ * @see https://ngwr.dev/reference/components/collapse
  */
 declare class WrAccordion implements WrCollapseGroupContext {
     /** Always behaves as an accordion. Provided for context-interface symmetry. */

package/types/ngwr-color-picker.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { ControlValueAccessor } from '@angular/forms';
+import { FormValueControl } from '@angular/forms/signals';
 import { WrSegmentedOption } from 'ngwr/segmented';
 
 /**
@@ -169,33 +169,41 @@ type Tab = 'hex' | 'rgb' | 'hsl';
 type Edges = 'sv' | 'hue' | 'alpha';
 /**
  * Inline colour picker — HSV canvas, hue slider, optional alpha slider, HEX
- * input. Implements `ControlValueAccessor`, so it binds with `[(ngModel)]`,
- * `[formControl]`, or `formControlName`. Output is always a string in the
- * format chosen via `[format]`.
+ * input.
+ *
+ * A signal-forms native control: it implements `FormValueControl<string>`, so
+ * `[formField]` binds straight to its `value` model — no
+ * `ControlValueAccessor` in between. `[(value)]` works standalone. Output is
+ * always a hex string.
  *
  * @example
  * ```html
- * <wr-color-picker [(ngModel)]="brandColor" />
- * <wr-color-picker [(ngModel)]="brandColor" [alpha]="false" />
+ * <!-- signal forms -->
+ * <wr-color-picker [formField]="form.brandColor" />
+ *
+ * <!-- standalone two-way binding -->
+ * <wr-color-picker [(value)]="brandColor" [alpha]="false" />
  * ```
  *
- * @see https://ngwr.dev/components/color-picker
+ * @see https://ngwr.dev/reference/components/color-picker
  */
-declare class WrColorPicker implements ControlValueAccessor {
+declare class WrColorPicker implements FormValueControl<string> {
     /** Render the alpha slider and emit 8-digit hex / `rgba()`. @default true */
     readonly alpha: _angular_core.InputSignalWithTransform<boolean, any>;
     /** Disable interaction. @default false */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, any>;
-    /** Output format produced through the CVA. @default 'hex' */
+    /** Output format produced by the control. @default 'hex' */
     readonly format: _angular_core.InputSignal<WrColorFormat>;
     /** Preset hex colours rendered as a clickable row beneath the inputs. Empty = no row. @default [] */
     readonly swatches: _angular_core.InputSignal<readonly string[]>;
+    /** The selected colour as a string. Bound by `[formField]`, or two-way via `[(value)]`. */
+    readonly value: _angular_core.ModelSignal<string>;
+    /** Emitted on blur so a bound field can mark itself touched. */
+    readonly touch: _angular_core.OutputEmitterRef<void>;
     protected readonly h: _angular_core.WritableSignal<number>;
     protected readonly s: _angular_core.WritableSignal<number>;
     protected readonly v: _angular_core.WritableSignal<number>;
     protected readonly a: _angular_core.WritableSignal<number>;
-    private readonly disabledFromCva;
-    protected readonly effectiveDisabled: _angular_core.Signal<boolean>;
     /** RGB view of the current colour, computed lazily. */
     protected readonly rgb: _angular_core.Signal<WrRgb>;
     /** Canonical hex (used by the input field and by drag emits). */
@@ -219,12 +227,9 @@ declare class WrColorPicker implements ControlValueAccessor {
     protected readonly alphaPercent: _angular_core.Signal<number>;
     protected readonly tabOptions: readonly WrSegmentedOption<Tab>[];
     protected readonly classes: _angular_core.Signal<string>;
-    private onChange;
-    private onTouched;
-    writeValue(value: string | null): void;
-    registerOnChange(fn: (value: string) => void): void;
-    registerOnTouched(fn: () => void): void;
-    setDisabledState(isDisabled: boolean): void;
+    /** Last hex we pushed into `value`; lets the sync effect ignore our own writes. */
+    private lastEmittedHex;
+    constructor();
     protected onPointerDown(event: PointerEvent, surface: Edges): void;
     private updateFromEvent;
     protected onHexInput(event: Event): void;
@@ -239,7 +244,7 @@ declare class WrColorPicker implements ControlValueAccessor {
     /** Push an RGB triple into the HSV source of truth (preserving the current alpha if the swap removes it). */
     private applyRgb;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrColorPicker, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrColorPicker, "wr-color-picker", never, { "alpha": { "alias": "alpha"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "swatches": { "alias": "swatches"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrColorPicker, "wr-color-picker", never, { "alpha": { "alias": "alpha"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "swatches": { "alias": "swatches"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
 }
 
 /**
@@ -262,7 +267,7 @@ declare class WrColorPicker implements ControlValueAccessor {
  * </button>
  * ```
  *
- * @see https://ngwr.dev/components/color-picker
+ * @see https://ngwr.dev/reference/components/color-picker
  */
 declare class WrColorPickerTrigger {
     /** Two-way bindable colour value (hex string). */

package/types/ngwr-command-palette.d.ts

@@ -53,7 +53,7 @@ interface Bucket {
  * <wr-command-palette [items]="commands" trigger="mod+k" (picked)="onPicked($event)" />
  * ```
  *
- * @see https://ngwr.dev/components/command-palette
+ * @see https://ngwr.dev/reference/components/command-palette
  */
 declare class WrCommandPalette {
     /** Items shown in the palette. */

package/types/ngwr-compare.d.ts

@@ -19,7 +19,7 @@ import * as _angular_core from '@angular/core';
  * </wr-compare>
  * ```
  *
- * @see https://ngwr.dev/components/compare
+ * @see https://ngwr.dev/reference/components/compare
  */
 declare class WrCompare {
     /** Divider position as a percentage (0–100). Two-way bindable. @default 50 */

package/types/ngwr-context-menu.d.ts

@@ -24,9 +24,9 @@ declare class WrContextMenuPanel {
 
 /**
  * Attach to any element to show a `<wr-context-menu>` at the pointer
- * position when the user right-clicks, long-presses on touch, or otherwise
- * sends a `contextmenu` event (Shift+F10, etc.). The native browser menu is
- * suppressed for the host element.
+ * position when the user right-clicks or otherwise sends a `contextmenu`
+ * event (Shift+F10, etc.). The native browser menu is suppressed for the
+ * host element.
  *
  * @example
  * ```html
@@ -37,7 +37,7 @@ declare class WrContextMenuPanel {
  * </wr-context-menu>
  * ```
  *
- * @see https://ngwr.dev/components/context-menu
+ * @see https://ngwr.dev/reference/components/context-menu
  */
 declare class WrContextMenu {
     /** Menu to open. Pass a `<wr-context-menu>` template reference. */
@@ -50,6 +50,13 @@ declare class WrContextMenu {
     private overlayRef;
     private closingTimer;
     private leaveTimer;
+    private pressTimer;
+    private pressX;
+    private pressY;
+    private pressPageX;
+    private pressPageY;
+    private lastLongPressAt;
+    private cancelPressScroll;
     /**
      * Single open root menu at a time. Submenu items use this to signal
      * chain-level hover state: when the cursor enters ANY pane in the
@@ -64,6 +71,13 @@ declare class WrContextMenu {
     static keepChainAlive(): void;
     /** Called from a submenu pane's mouseleave when the cursor left ALL menus. */
     static scheduleChainClose(): void;
+    /**
+     * Called from a `<wr-context-menu-item>` click — selecting an item
+     * dismisses the whole chain (root + any open submenus). Items live in
+     * a detached overlay portal, so they reach their owning root through
+     * this static handle rather than DI.
+     */
+    static closeActive(): void;
     /**
      * Open/close animation duration in ms. Matches the longest SCSS
      * transition on `.wr-context-menu-overlay` (the spring-scale curve).
@@ -79,31 +93,26 @@ declare class WrContextMenu {
      * on a deliberate hover-out.
      */
     private static readonly LEAVE_DELAY;
-    /** Hold duration (ms) before a stationary touch press opens the menu. */
+    /** Hold duration before a touch long-press opens the menu. */
     private static readonly LONG_PRESS_MS;
-    /** Movement (px) that reclassifies a press as a scroll and cancels it. */
-    private static readonly LONG_PRESS_MOVE_TOLERANCE;
-    private longPressTimer;
-    private touchStartX;
-    private touchStartY;
-    private longPressFired;
-    private suppressContextMenuUntil;
+    /** Finger travel (px) that turns a pending long-press into a scroll/drag. */
+    private static readonly PRESS_MOVE_TOLERANCE;
     constructor();
     /** @internal Right-click handler — opens at the pointer (or re-positions if already open). */
     protected onContextMenu(event: MouseEvent): void;
     /**
-     * @internal Touch long-press → open the menu. Native `contextmenu` is
-     * unreliable on touch (iOS doesn't fire it, Android's timing varies), so we
-     * detect the press ourselves: a stationary hold for `LONG_PRESS_MS` opens
-     * the menu at the touch point; moving the finger reclassifies it as a
-     * scroll and cancels.
+     * @internal Touch/pen long-press → open the menu at the press point. Desktop
+     * right-click stays on `(contextmenu)`; this path is filtered to non-mouse
+     * pointers. Deliberately does NOT `preventDefault`/`setPointerCapture` or set
+     * `touch-action` — a press that turns into a scroll must still scroll, so the
+     * open is cancelled on movement (> tolerance), on scroll, and on early lift.
      */
-    protected onTouchStart(event: TouchEvent): void;
-    /** @internal Cancel a pending long-press once the finger travels (a scroll). */
-    protected onTouchMove(event: TouchEvent): void;
-    /** @internal Release — drop a pending press; swallow the synthetic click a fired press would emit. */
-    protected onTouchEnd(event: TouchEvent): void;
-    private clearLongPress;
+    protected onPointerDown(event: PointerEvent): void;
+    /** @internal Finger moved too far before the hold fired — it's a scroll/drag. */
+    protected onPointerMove(event: PointerEvent): void;
+    /** @internal Lifted (or the browser claimed the gesture) before the hold fired. */
+    protected onPointerUp(): void;
+    private cancelPress;
     /** Close the menu. */
     close(): void;
     private openOverlay;
@@ -168,6 +177,16 @@ declare class WrContextMenuItem {
      */
     static disposeAll(immediate: boolean): void;
     constructor();
+    /**
+     * @internal Pointer activation — selecting a leaf item dismisses the
+     * whole menu chain. The consumer's own `(click)` binding on the host
+     * runs in the same event; we defer the close to a microtask so that
+     * handler (the actual "select") always completes before the overlay
+     * tears down, regardless of listener registration order. Items that
+     * own a submenu (or are disabled) don't dismiss — clicking them just
+     * drills into / ignores the row.
+     */
+    protected onClick(): void;
     /** @internal Keyboard activation — Enter / Space. */
     protected activate(event: Event): void;
     /** @internal Right-arrow opens the submenu. */

package/types/ngwr-cookie.d.ts

@@ -36,10 +36,16 @@ interface WrCookieOptions {
  * cookies.keys();                                                // readonly string[]
  * ```
  *
- * @see https://ngwr.dev/services/cookie
+ * @see https://ngwr.dev/reference/services/cookie
  */
 declare class WrCookie {
     private readonly doc;
+    /**
+     * `document.cookie`, or `''` when it cannot be read. Mirrors the guard on
+     * `set()`: under SSR the server DOM has no cookie support and throws on the
+     * getter, and sandboxed iframes reject access too.
+     */
+    private read;
     /** Is `key` present (regardless of value)? */
     has(key: string): boolean;
     /** Read `key`. Returns `fallback` (default `null`) when the key is missing. */

package/types/ngwr-counter.d.ts

@@ -46,7 +46,7 @@ type Cell = {
  * <wr-counter [value]="9.99" mode="tween" [decimals]="2" prefix="$" />
  * ```
  *
- * @see https://ngwr.dev/components/counter
+ * @see https://ngwr.dev/reference/components/counter
  */
 declare class WrCounter {
     /** Target value. */
@@ -71,6 +71,13 @@ declare class WrCounter {
     private rafId;
     /** Tween-mode formatted output. */
     protected readonly tweenText: _angular_core.Signal<string>;
+    /**
+     * Odometer-mode text for assistive tech and prerendered output. The strip
+     * renders every digit 0-9 per column and picks one with a transform, so its
+     * markup carries no usable text — screen readers would announce all ten, and
+     * static HTML would ship the same noise. This node holds the real value.
+     */
+    protected readonly odoText: _angular_core.Signal<string>;
     /** Odometer cells — one per character in the formatted target string. */
     protected readonly cells: _angular_core.Signal<readonly Cell[]>;
     constructor();
@@ -106,7 +113,7 @@ declare class WrCounter {
  * <wr-count-up [from]="60" [to]="0" direction="down" />
  * ```
  *
- * @see https://ngwr.dev/components/counter
+ * @see https://ngwr.dev/reference/components/counter
  */
 declare class WrCountUp {
     /** Starting value. @default 0 */