ngwr 14.3.1 → 14.4.0

package/types/ngwr-checkbox.d.ts

@@ -49,6 +49,16 @@ declare class WrCheckbox implements FormCheckboxControl {
      * `value`.)
      */
     readonly checkboxValue: _angular_core.InputSignal<unknown>;
+    /**
+     * `checkboxValue` as an attribute, when it can be one.
+     *
+     * A primitive round-trips through the DOM and is what a group identity is in
+     * practice. Anything else — an object, an array — has no honest attribute
+     * form, so the attribute is ABSENT rather than `[object Object]`: a harness
+     * reading it then gets `null`, which is true, instead of a string that looks
+     * like data and identifies nothing.
+     */
+    protected readonly reflectedValue: _angular_core.Signal<string | null>;
     /**
      * Accessible name for a checkbox used WITHOUT projected text — a selection
      * cell in a table, say. The wrapping `<label>` names the control whenever

package/types/ngwr-clipboard.d.ts

@@ -64,7 +64,7 @@ declare class WrClipboard {
      */
     private legacyWrite;
     static ɵfac: i0.ɵɵFactoryDeclaration<WrClipboard, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrClipboard>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 export { WrClipboard };

package/types/ngwr-confetti.d.ts

@@ -71,7 +71,7 @@ declare class WrConfetti {
     private spawn;
     private tick;
     static ɵfac: i0.ɵɵFactoryDeclaration<WrConfetti, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrConfetti>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 export { WrConfetti };

package/types/ngwr-cookie.d.ts

@@ -59,7 +59,7 @@ declare class WrCookie {
     /** Remove every cookie visible to this document. Uses `path: '/'`. */
     clear(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<WrCookie, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrCookie>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 export { WrCookie };

package/types/ngwr-date-adapters-fns.d.ts

@@ -67,7 +67,7 @@ declare class WrDateFnsAdapter extends WrDateAdapter<Date> {
     getDayOfWeekNames(style: 'narrow' | 'short' | 'long'): readonly string[];
     getMonthNames(style: 'narrow' | 'short' | 'long'): readonly string[];
     static ɵfac: i0.ɵɵFactoryDeclaration<WrDateFnsAdapter, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrDateFnsAdapter>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**

package/types/ngwr-date-adapters-luxon.d.ts

@@ -70,7 +70,7 @@ declare class WrLuxonAdapter extends WrDateAdapter<DateTime> {
     getDayOfWeekNames(style: 'narrow' | 'short' | 'long'): readonly string[];
     getMonthNames(style: 'narrow' | 'short' | 'long'): readonly string[];
     static ɵfac: i0.ɵɵFactoryDeclaration<WrLuxonAdapter, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrLuxonAdapter>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**

package/types/ngwr-date.d.ts

@@ -29,8 +29,14 @@ interface WrDateAdapterOptions {
      */
     readonly adapter?: Type<WrDateAdapter<unknown>>;
     /**
-     * BCP 47 locale tag (`'en-US'`, `'ru-RU'`, …). Default: `navigator.language`
-     * in the browser, `'en-US'` on the server.
+     * BCP 47 locale tag (`'en-US'`, `'ru-RU'`, …).
+     *
+     * Default: Angular's own `LOCALE_ID`, which is what {@link WR_DATE_LOCALE}
+     * resolves to. This line used to say `navigator.language` in the browser and
+     * `'en-US'` on the server, which was true before v14 and has been wrong since
+     * — v14 made `LOCALE_ID` the single locale source precisely so an app that
+     * sets it correctly stops formatting dates in whatever language the visitor's
+     * browser happens to be.
      */
     readonly locale?: string;
 }
@@ -272,7 +278,7 @@ declare class WrNativeDateAdapter extends WrDateAdapter<Date> {
      */
     private compose;
     static ɵfac: i0.ɵɵFactoryDeclaration<WrNativeDateAdapter, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrNativeDateAdapter>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**

package/types/ngwr-density.d.ts

@@ -57,7 +57,7 @@ declare class WrDensity {
     private readPersisted;
     private persist;
     static ɵfac: i0.ɵɵFactoryDeclaration<WrDensity, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrDensity>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**

package/types/ngwr-dialog.d.ts

@@ -181,7 +181,7 @@ declare class WrDialog {
      */
     private closeLabel;
     static ɵfac: i0.ɵɵFactoryDeclaration<WrDialog, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrDialog>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**

package/types/ngwr-donut-chart-testing.d.ts

@@ -75,7 +75,17 @@ declare class WrDonutChartHarness extends ComponentHarness {
     getCenterValue(): Promise<string | null>;
     /** The caption under the centre value, or `null`. */
     getCenterLabel(): Promise<string | null>;
-    /** The ring's diameter in pixels, as the component writes it inline. */
+    /**
+     * The chart's outer size in pixels, read off the `style` ATTRIBUTE.
+     *
+     * NOT `getCssValue()`, which is `getComputedStyle()` — the same rule this
+     * file's class note already states and this method alone broke. A computed
+     * read answers from the LAID-OUT box, so it agrees with the inline value in
+     * jsdom (which lays nothing out and echoes the declaration) and disagrees in a
+     * browser, where sub-pixel rounding turns a declared 240 into 239.5. A harness
+     * that answers differently in the two places it runs is worse than one that
+     * refuses.
+     */
     getSize(): Promise<number>;
 }
 

package/types/ngwr-drawer.d.ts

@@ -333,7 +333,7 @@ declare class WrDrawerManager {
      */
     private closeLabel;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrDrawerManager, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<WrDrawerManager>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
 }
 
 /**

package/types/ngwr-dropdown.d.ts

@@ -128,6 +128,22 @@ declare class WrDropdown {
     /** @internal */
     protected onMouseLeave(event: MouseEvent): void;
     private openOverlay;
+    /**
+     * Tear the overlay down, and tell the host — unless the host is going away
+     * with it.
+     *
+     * `notify: false` is the DESTROY path, and it is not a nicety. An `output()`
+     * belongs to the view that declares it, so emitting from `onDestroy` is
+     * refused: Angular logs `NG0953: Unexpected emit for destroyed OutputRef` and
+     * the listener never runs. Measured — a `(closed)` handler on a dropdown whose
+     * host view is removed while the menu is open fired zero times and left a
+     * console error behind. There is nobody to notify at that point, because the
+     * consumer's own view is being torn down in the same pass; `wr-popconfirm`
+     * already disposes without emitting, and this brings the other two into line.
+     *
+     * The focus hand-back is skipped for the same reason — the host element is on
+     * its way out of the document.
+     */
     private closeOverlay;
     /** @internal Trigger keydown — ArrowDown/Up/Enter/Space open the menu. */
     protected onKeydown(event: KeyboardEvent): void;

package/types/ngwr-file-upload.d.ts

@@ -72,6 +72,17 @@ declare class WrFileUpload implements FormValueControl<File | readonly File[] |
     readonly readonly: _angular_core.InputSignalWithTransform<boolean, any>;
     /** The surrounding `<wr-form-field>`'s error state. @internal */
     protected readonly fieldAria: ngwr_form.WrFormFieldAria;
+    /**
+     * The field's label names the drop zone, when there is one.
+     *
+     * The zone is a `div[role="button"]`, so `<wr-form-field>`'s `<label for>`
+     * cannot reach it and named nothing at all — the zone announced only its own
+     * generic "drop files here" copy. `aria-labelledby` is the direction that
+     * works for a role. The zone copy stays as the label when no field wraps it.
+     */
+    protected readonly labelledBy: _angular_core.Signal<string | null>;
+    /** `null` while the field's label carries the name, or both are announced. */
+    protected readonly zoneName: _angular_core.Signal<string | null>;
     /** Primary call-to-action label. Falls back to `fileUpload.browse`. */
     readonly pickLabel: _angular_core.InputSignal<string | null>;
     /** Secondary instruction below the CTA. Falls back to `fileUpload.dropZone`. */

package/types/ngwr-form.d.ts

@@ -67,6 +67,18 @@ interface WrFormFieldContext {
     readonly errorKeys: Signal<readonly string[]>;
     /** Id of the element listing the visible messages, or `null` when there are none. */
     readonly describedBy: Signal<string | null>;
+    /**
+     * Id of the field's own `<label>`, or `null` when it renders none.
+     *
+     * For the controls `<label for>` cannot reach. `for` only binds to a LABELABLE
+     * element — button, input, meter, output, progress, select, textarea — so a
+     * control whose focusable part is a `div[role="slider"]`, a `role="button"`
+     * drop zone or a radiogroup got a label pointing at nothing: measured, five of
+     * the eighteen value controls resolved `for` to no element in the document at
+     * all. Those point `aria-labelledby` back at this instead, which is the
+     * direction that works for a role.
+     */
+    readonly labelId?: Signal<string | null>;
     /**
      * Id of the field's hint, or `null` when it is showing none — including while
      * an error has replaced it, since the two never render together and an
@@ -216,6 +228,8 @@ declare class WrFormField implements WrFormFieldContext {
      * that had just left the document.
      */
     readonly hintId: _angular_core.Signal<string | null>;
+    /** @internal `WrFormFieldContext` — the id a role-based control points `aria-labelledby` at. */
+    readonly labelId: _angular_core.Signal<string | null>;
     /**
      * Render a catalog message for any error the markup does not already answer.
      *
@@ -259,6 +273,17 @@ interface WrFormFieldAria {
     readonly describedBy: Signal<string | null>;
     /** `'true'` while the field has a validation error, `null` otherwise. */
     readonly ariaInvalid: Signal<'true' | null>;
+    /**
+     * Id of the field's `<label>`, for a control `<label for>` cannot reach.
+     *
+     * `for` binds only to a LABELABLE element, so a control whose focusable part
+     * is a `div` with a role gets nothing from it — measured, `wr-rating`,
+     * `wr-knob` and `wr-file-upload` all rendered a field label whose `for` named
+     * no element in the document. Point `aria-labelledby` at this instead; a
+     * control that IS labelable should ignore it and let `for` do the work, or the
+     * name is announced twice.
+     */
+    readonly labelledBy: Signal<string | null>;
 }
 /**
  * The two attributes that make a `<wr-form-field>`'s visible text — its error

package/types/ngwr-gauge-testing.d.ts

@@ -63,7 +63,15 @@ declare class WrGaugeHarness extends ComponentHarness {
     getDisplayValue(): Promise<string | null>;
     /** The suffix alone, or `null` when there is none — or nothing is printed. */
     getSuffix(): Promise<string | null>;
-    /** The dial's width in pixels, as the component writes it inline. */
+    /**
+     * The dial's width in pixels, read off the `style` ATTRIBUTE.
+     *
+     * NOT `getCssValue()`, which is `getComputedStyle()`: a computed read answers
+     * from the LAID-OUT box, so it agrees with the inline value in jsdom — which
+     * lays nothing out and echoes the declaration — and disagrees in a browser,
+     * where sub-pixel rounding turns a declared 240 into 239.5. A harness that
+     * answers differently in the two places it runs is worse than one that refuses.
+     */
     getSize(): Promise<number>;
 }
 

package/types/ngwr-hotkey.d.ts

@@ -80,7 +80,7 @@ declare class WrHotkey {
     private detach;
     private dispatch;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrHotkey, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<WrHotkey>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
 }
 
 /**

package/types/ngwr-i18n.d.ts

@@ -202,7 +202,7 @@ declare class WrI18n {
     private warnOnLocaleIdDrift;
     private loadCatalog;
     static ɵfac: i0.ɵɵFactoryDeclaration<WrI18n, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrI18n>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**

package/types/ngwr-input-number.d.ts

@@ -36,8 +36,18 @@ declare class WrInputNumber implements FormValueControl<number | null> {
     private readonly maxValue;
     /** Step used by stepper buttons + arrow keys. @default 1 */
     readonly step: _angular_core.InputSignalWithTransform<number, unknown>;
-    /** Fixed number of decimals shown on blur. `null` keeps the entered precision. @default null */
-    readonly decimals: _angular_core.InputSignal<number | null>;
+    /**
+     * Fixed number of decimals shown on blur. `null` keeps the entered precision.
+     *
+     * Clamped to what `toFixed` accepts — 0 to 100 — because it is the one numeric
+     * input on this component that had no transform, and the value goes straight
+     * into `toFixed`, which THROWS a `RangeError` outside that range rather than
+     * degrading. A `[decimals]="-1"` bound from a config object took the whole
+     * component down on blur.
+     *
+     * @default null
+     */
+    readonly decimals: _angular_core.InputSignalWithTransform<number | null, unknown>;
     /** Render the ▲▼ stepper column. @default true */
     readonly showSteppers: _angular_core.InputSignalWithTransform<boolean, any>;
     /**

package/types/ngwr-input-otp.d.ts

@@ -43,6 +43,7 @@ type WrInputOtpSize = 'sm' | 'md' | 'lg';
  */
 declare class WrInputOtp implements FormValueControl<string> {
     private readonly dir;
+    private readonly injector;
     /** Accessible name of the whole strip. Falls back to `inputOtp.label`. */
     readonly ariaLabel: _angular_core.InputSignal<string | null>;
     protected readonly resolvedAriaLabel: _angular_core.Signal<string>;
@@ -94,6 +95,17 @@ declare class WrInputOtp implements FormValueControl<string> {
      * @internal
      */
     protected readonly fieldAria: ngwr_form.WrFormFieldAria;
+    /**
+     * The field's label names the strip, when there is one.
+     *
+     * The host is a `role="group"`, which `<wr-form-field>`'s `<label for>` cannot
+     * reach — `for` binds only to a labelable element — so a field wrapping this
+     * rendered a label that named nothing and the strip announced its own generic
+     * default instead. An explicit `ariaLabel` still wins over both.
+     */
+    protected readonly labelledBy: _angular_core.Signal<string | null>;
+    /** `null` while the field's label carries the name, or the two are announced together. */
+    protected readonly groupName: _angular_core.Signal<string | null>;
     /** Character shown in empty cells. @default '•' */
     readonly placeholder: _angular_core.InputSignal<string>;
     /** The entered code. Bound by `[formField]`, or two-way via `[(value)]`. */

package/types/ngwr-knob-testing.d.ts

@@ -91,9 +91,17 @@ declare class WrKnobHarness extends ComponentHarness {
     /**
      * Whether the dial is a tab stop.
      *
-     * The component drops it out of the tab order for BOTH disabled and read-only,
-     * which is worth knowing: a read-only slider that a keyboard user cannot reach is
-     * also one they cannot read, and this is the method that says so.
+     * `disabled` only, never `readonly` — and the distinction is deliberate, not
+     * incidental. A disabled control leaves the tab order; a READ-ONLY one stays
+     * in it, keeps announcing its value, and still submits, which is the whole
+     * difference between "you may not" and "there is nothing here". The component
+     * records that driving this off an `interactive()` that folded the two
+     * together made `readonly` unreachable, with an `aria-describedby` pointing
+     * at an element nobody could focus.
+     *
+     * This docblock used to describe exactly that fixed bug — "false while
+     * readonly or disabled" — so a reader trusting it would have asserted the
+     * behaviour the component was changed to stop having.
      */
     isFocusable(): Promise<boolean>;
     /** Move keyboard focus to the dial. */

package/types/ngwr-knob.d.ts

@@ -68,6 +68,19 @@ declare class WrKnob implements FormValueControl<number> {
     protected readonly focusable: _angular_core.Signal<boolean>;
     /** The surrounding `<wr-form-field>`'s error state. @internal */
     protected readonly fieldAria: ngwr_form.WrFormFieldAria;
+    /**
+     * The field's label wins over the built-in default, and an explicit
+     * `ariaLabel` wins over both.
+     *
+     * `<wr-form-field label="…">` renders a `<label for>` that cannot reach this
+     * control — `for` binds only to a LABELABLE element and the focusable part
+     * here carries a role instead — so the field's label named nothing and this
+     * announced its own generic default. A consumer who wrote
+     * `<wr-form-field label="Overall satisfaction">` heard "Value".
+     */
+    protected readonly labelledBy: _angular_core.Signal<string | null>;
+    /** `null` once `aria-labelledby` is carrying the name, or the two are announced together. */
+    protected readonly nameLabel: _angular_core.Signal<string | null>;
     protected readonly classes: _angular_core.Signal<string>;
     protected readonly cx = 50;
     protected readonly cy = 50;

package/types/ngwr-line-chart-testing.d.ts

@@ -85,7 +85,17 @@ declare class WrLineChartHarness extends ComponentHarness {
     getTooltipLabel(): Promise<string | null>;
     /** The tooltip's rows, one per series, or `[]` while it is closed. */
     getTooltipRows(): Promise<WrLineChartTooltipRow[]>;
-    /** The plot's height in pixels, as the component writes it inline. */
+    /**
+     * The plot's height in pixels, read off the `style` ATTRIBUTE.
+     *
+     * NOT `getCssValue()`, which is `getComputedStyle()` — the same rule this
+     * file's class note already states and this method alone broke. A computed
+     * read answers from the LAID-OUT box, so it agrees with the inline value in
+     * jsdom (which lays nothing out and echoes the declaration) and disagrees in a
+     * browser, where sub-pixel rounding turns a declared 240 into 239.5. A harness
+     * that answers differently in the two places it runs is worse than one that
+     * refuses.
+     */
     getPlotHeight(): Promise<number>;
 }
 

package/types/ngwr-line-chart.d.ts

@@ -55,8 +55,26 @@ declare class WrLineChart {
     private readonly host;
     /** Hovered point index (across all series) — null when no hover. */
     protected readonly hoveredIndex: _angular_core.WritableSignal<number | null>;
+    /**
+     * A dash pattern per series, so the lines are told apart by SHAPE and not
+     * only by hue.
+     *
+     * The default palette's colours sit within about 1.06:1 of each other in
+     * relative luminance — that is the whole nine-intent scale's constraint, and
+     * it means a reader with red-green colour blindness sees several of these
+     * strokes as one grey. A legend that pairs a coloured square with a name does
+     * not rescue it: matching the square to the line is exactly the step that
+     * needs hue. Distinguishing series by dash is the standard remedy and the
+     * only one that survives greyscale, printing and a monochrome display.
+     *
+     * The FIRST entry is solid on purpose. A single-series chart is the common
+     * case and there is nothing to tell apart in it, so it is left exactly as it
+     * was; the patterns only appear once a second series does.
+     */
+    private static readonly DASHES;
     protected readonly resolvedSeries: _angular_core.Signal<{
         label: string;
+        dash: "" | "7 4" | "2 3" | "10 4 2 4" | "1 4" | "6 3 2 3";
         data: (number | null)[];
         color: string;
     }[]>;

package/types/ngwr-loading-bar.d.ts

@@ -49,7 +49,7 @@ declare class WrLoadingBar {
     private clearHold;
     private finish;
     static ɵfac: i0.ɵɵFactoryDeclaration<WrLoadingBar, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrLoadingBar>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**

package/types/ngwr-markdown.d.ts

@@ -399,7 +399,7 @@ declare class WrMarkdownHighlight {
      */
     private evictLanguage;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrMarkdownHighlight, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<WrMarkdownHighlight>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
 }
 
 /**

package/types/ngwr-media.d.ts

@@ -46,7 +46,7 @@ declare class WrMedia {
     private resolveQuery;
     private createSignal;
     static ɵfac: i0.ɵɵFactoryDeclaration<WrMedia, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrMedia>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**

package/types/ngwr-meta.d.ts

@@ -123,7 +123,7 @@ declare class WrMeta {
     private updateProp;
     private diffLink;
     static ɵfac: i0.ɵɵFactoryDeclaration<WrMeta, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrMeta>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**

package/types/ngwr-overlay.d.ts

@@ -126,7 +126,7 @@ declare class WrOutsideClick {
     private listen;
     private unlisten;
     static ɵfac: i0.ɵɵFactoryDeclaration<WrOutsideClick, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrOutsideClick>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**
@@ -155,7 +155,7 @@ declare class WrOutsideClick {
 declare class WrOverlayContainer extends OverlayContainer {
     protected _createContainer(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<WrOverlayContainer, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrOverlayContainer>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**

package/types/ngwr-pagination.d.ts

@@ -115,6 +115,22 @@ declare class WrPagination {
     /** The nav landmark's own accessible name — was a hardcoded English literal. */
     protected readonly navLabel: _angular_core.Signal<string>;
     /** Internal: total page count. */
+    /**
+     * A page size that is not a positive number yields ONE page, not `Infinity`.
+     *
+     * `pageSize` is a `model()`, so Angular offers no `transform` to coerce it and
+     * whatever the host writes arrives raw. At 0 the division is `Infinity`,
+     * `Math.max(1, …)` keeps it, and the item list below pushes `total` as the
+     * last page — so the strip rendered a clickable cell reading "Infinity", and
+     * clicking it locked the tab. `NaN` (a `pageSize` bound to an emptied number
+     * field) came through untouched for the same reason.
+     *
+     * One page is the honest answer: a size of zero describes no paging at all.
+     * Note this is about `pageSize` and does NOT touch the recorded contract
+     * about `total` — pagination still refuses to pull the page DOWN while
+     * `total` is at or below zero, because 0 is ambiguous with "still loading".
+     */
+    private readonly usablePageSize;
     protected readonly totalPages: _angular_core.Signal<number>;
     /**
      * Internal: where the previous arrow goes. Clamped to the end of the valid

package/types/ngwr-platform.d.ts

@@ -32,7 +32,7 @@ declare class WrPlatform {
     readonly prefersReducedMotion: Signal<boolean>;
     private mediaSignal;
     static ɵfac: i0.ɵɵFactoryDeclaration<WrPlatform, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrPlatform>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**
@@ -63,7 +63,7 @@ declare class WrVisualViewport {
     readonly offsetTop: Signal<number>;
     constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<WrVisualViewport, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrVisualViewport>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /** Impact weight for {@link WrHaptics.impact}. */
@@ -122,7 +122,7 @@ declare class WrHaptics {
     /** Cancel any in-progress vibration. */
     stop(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<WrHaptics, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrHaptics>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 export { WrHaptics, WrPlatform, WrVisualViewport };

package/types/ngwr-popover.d.ts

@@ -97,6 +97,22 @@ declare class WrPopover {
     private scheduleHide;
     private clearTimers;
     private openOverlay;
+    /**
+     * Tear the overlay down, and tell the host — unless the host is going away
+     * with it.
+     *
+     * `notify: false` is the DESTROY path, and it is not a nicety. An `output()`
+     * belongs to the view that declares it, so emitting from `onDestroy` is
+     * refused: Angular logs `NG0953: Unexpected emit for destroyed OutputRef` and
+     * the listener never runs. Measured — a `(closed)` handler on a dropdown whose
+     * host view is removed while the menu is open fired zero times and left a
+     * console error behind. There is nobody to notify at that point, because the
+     * consumer's own view is being torn down in the same pass; `wr-popconfirm`
+     * already disposes without emitting, and this brings the other two into line.
+     *
+     * The focus hand-back is skipped for the same reason — the host element is on
+     * its way out of the document.
+     */
     private closeOverlay;
     private readonly onOverlayLeave;
     private readonly onOverlayEnter;

package/types/ngwr-rating-testing.d.ts

@@ -225,10 +225,19 @@ declare class WrRatingHarness extends ComponentHarness {
     /** Whether the rating refuses interaction — `aria-disabled`, for the same reason. */
     isDisabled(): Promise<boolean>;
     /**
-     * Whether the rating is in the tab order.
+     * Whether the rating is a tab stop.
      *
-     * A rating that takes no input takes itself out of it (`tabindex="-1"`), so this
-     * is `false` while readonly or disabled.
+     * `disabled` only, never `readonly` — and the distinction is deliberate, not
+     * incidental. A disabled control leaves the tab order; a READ-ONLY one stays
+     * in it, keeps announcing its value, and still submits, which is the whole
+     * difference between "you may not" and "there is nothing here". The component
+     * records that driving this off an `interactive()` that folded the two
+     * together made `readonly` unreachable, with an `aria-describedby` pointing
+     * at an element nobody could focus.
+     *
+     * This docblock used to describe exactly that fixed bug — "false while
+     * readonly or disabled" — so a reader trusting it would have asserted the
+     * behaviour the component was changed to stop having.
      */
     isFocusable(): Promise<boolean>;
     /**

package/types/ngwr-rating.d.ts

@@ -105,6 +105,19 @@ declare class WrRating implements FormValueControl<number | null> {
     private readonly directionality;
     /** The surrounding `<wr-form-field>`'s error state. @internal */
     protected readonly fieldAria: ngwr_form.WrFormFieldAria;
+    /**
+     * The field's label wins over the built-in default, and an explicit
+     * `ariaLabel` wins over both.
+     *
+     * `<wr-form-field label="…">` renders a `<label for>` that cannot reach this
+     * control — `for` binds only to a LABELABLE element and the focusable part
+     * here carries a role instead — so the field's label named nothing and this
+     * announced its own generic default. A consumer who wrote
+     * `<wr-form-field label="Overall satisfaction">` heard "Rating".
+     */
+    protected readonly labelledBy: _angular_core.Signal<string | null>;
+    /** `null` once `aria-labelledby` is carrying the name, or the two are announced together. */
+    protected readonly nameLabel: _angular_core.Signal<string | null>;
     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;

package/types/ngwr-scroll.d.ts

@@ -58,7 +58,7 @@ declare class WrScroll {
     private behavior;
     private scroll;
     static ɵfac: i0.ɵɵFactoryDeclaration<WrScroll, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WrScroll>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 export { WrScroll };