ngwr 9.1.0 → 10.1.0

package/types/ngwr-i18n.d.ts

@@ -76,6 +76,12 @@ declare class WrI18n {
     private readonly config;
     private readonly loader;
     private readonly storage;
+    /**
+     * Catalogs registered via `provideWrI18nBaseCatalogs()` — the floor under the
+     * loader's own catalogs, so ngwr's built-in strings survive an app that only
+     * ships its own keys. @internal
+     */
+    private readonly baseCatalogs;
     /** Per-(locale,scope) catalogs, populated by `loadCatalog`. @internal */
     private readonly catalogs;
     /** Bumped after each catalog write so reactive translates recompute. @internal */
@@ -106,6 +112,11 @@ declare class WrI18n {
     t(key: string, params?: WrI18nParams, scope?: string): string;
     /** Reactive translate — re-evaluates on locale or catalog updates. */
     translate(key: string, params?: WrI18nParams, scope?: string): Signal<string>;
+    /**
+     * Look a key up in the registered base catalogs, later contributions first so
+     * a feature can shadow an earlier one.
+     */
+    private walkBase;
     private initialLocale;
     private loadCatalog;
     static ɵfac: i0.ɵɵFactoryDeclaration<WrI18n, never>;
@@ -179,8 +190,52 @@ declare class WrTDirective {
 interface WrI18nLoader {
     load(locale: string, scope: string | null): Observable<WrI18nCatalog>;
 }
+/**
+ * The active loader.
+ *
+ * Defaults to one that serves an empty catalog, which is what makes
+ * `provideWrI18n()` genuinely optional: every ngwr component routes its
+ * built-in strings through `useI18nText` / `readI18nText`, those inject
+ * `WrI18n` optionally — and because `WrI18n` is `providedIn: 'root'`, an
+ * optional inject still CONSTRUCTS it. Without a default here that construction
+ * threw `NG0201: No provider found for WR_I18N_LOADER`, so an app that had
+ * simply not configured i18n could not render `<wr-alert>` at all.
+ *
+ * With the empty catalog, every lookup misses, `t()` hands back the key, and
+ * the helpers fall through to the component's own English default — the
+ * documented no-i18n behaviour.
+ */
 declare const WR_I18N_LOADER: InjectionToken<WrI18nLoader>;
 
+/**
+ * @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
+ */
+
+/** Base catalogs keyed by locale, contributed by {@link provideWrI18nBaseCatalogs}. */
+type WrI18nBaseCatalogs = Readonly<Record<string, WrI18nCatalog>>;
+/**
+ * Catalogs consulted *underneath* whatever the loader returned — the place for
+ * ngwr's own built-in strings.
+ *
+ * A loader **replaces** the catalog for a locale rather than extending it, so an
+ * app whose JSON holds only its own keys used to lose every built-in label to
+ * its hardcoded English fallback, silently. Registering `wrRu` / `wrEn` here
+ * puts them back without the app having to merge anything itself.
+ *
+ * `multi`, so several features can each contribute; later contributions win on
+ * a key collision, and anything the loader returned still wins over all of them.
+ *
+ * It has to be handed in by the consumer rather than wired up inside
+ * `provideWrI18n()`: the catalogs are their own entry points (`ngwr/i18n/ru`)
+ * and they already import from `ngwr/i18n`, so importing them back here is a
+ * circular entry-point dependency that ng-packagr rejects outright. Passing
+ * them in also keeps the locales you don't ship out of your bundle.
+ */
+declare const WR_I18N_BASE_CATALOGS: InjectionToken<readonly Readonly<Record<string, WrI18nCatalog>>[]>;
+
 /**
  * @license
  *
@@ -270,6 +325,29 @@ declare function provideWrI18n(options?: ProvideWrI18nOptions): EnvironmentProvi
  * @param scopes Optional per-scope catalogs served to `registerScope(name)`.
  */
 declare function provideWrI18nStaticLoader(catalogs: WrI18nStaticCatalogs, scopes?: WrI18nStaticScopedCatalogs): Provider;
+/**
+ * Register catalogs consulted *underneath* the loader — this is how ngwr's own
+ * built-in strings survive when you supply your own catalogs.
+ *
+ * A loader replaces the catalog for a locale instead of extending it, so a JSON
+ * file holding only your keys leaves every built-in label on its hardcoded
+ * English fallback, with nothing logged. One line fixes it, on either loader:
+ *
+ * @example
+ * ```ts
+ * import { wrRu } from 'ngwr/i18n/ru';
+ *
+ * providers: [
+ *   provideWrI18n({ defaultLocale: 'ru', availableLocales: ['ru'] }),
+ *   provideWrI18nBaseCatalogs({ ru: wrRu }),
+ *   provideWrI18nHttpLoader({ path: '/assets/i18n/{locale}.json' }),
+ * ]
+ * ```
+ *
+ * Pass only the locales you ship — the ones you leave out stay out of the
+ * bundle. Your own keys always win; this is a floor, not an override.
+ */
+declare function provideWrI18nBaseCatalogs(catalogs: WrI18nBaseCatalogs): Provider;
 /** Provide an HTTP loader — catalogs fetched from URLs. Requires `provideHttpClient`. */
 declare function provideWrI18nHttpLoader(config: WrI18nHttpLoaderConfig): Provider;
 
@@ -332,5 +410,5 @@ declare function readI18nText(key: string, fallback: string): string;
  */
 declare function useI18nFormatter(key: string, fallback: string): (params?: WrI18nParams) => string;
 
-export { DEFAULT_WR_I18N_CONFIG, WR_I18N_CONFIG, WR_I18N_LOADER, WrI18n, WrI18nHttpLoader, WrI18nStaticLoader, WrTDirective, WrTPipe, provideWrI18n, provideWrI18nHttpLoader, provideWrI18nStaticLoader, readI18nText, useI18nFormatter, useI18nText };
-export type { ProvideWrI18nOptions, WrI18nCatalog, WrI18nConfig, WrI18nConfigResolved, WrI18nHttpLoaderConfig, WrI18nLoader, WrI18nMissingHandler, WrI18nParams, WrI18nStaticCatalogs, WrI18nStaticScopedCatalogs };
+export { DEFAULT_WR_I18N_CONFIG, WR_I18N_BASE_CATALOGS, WR_I18N_CONFIG, WR_I18N_LOADER, WrI18n, WrI18nHttpLoader, WrI18nStaticLoader, WrTDirective, WrTPipe, provideWrI18n, provideWrI18nBaseCatalogs, provideWrI18nHttpLoader, provideWrI18nStaticLoader, readI18nText, useI18nFormatter, useI18nText };
+export type { ProvideWrI18nOptions, WrI18nBaseCatalogs, WrI18nCatalog, WrI18nConfig, WrI18nConfigResolved, WrI18nHttpLoaderConfig, WrI18nLoader, WrI18nMissingHandler, WrI18nParams, WrI18nStaticCatalogs, WrI18nStaticScopedCatalogs };

package/types/ngwr-icon.d.ts

@@ -18,28 +18,20 @@ declare class WrIcon {
     readonly name: i0.InputSignal<string>;
     private readonly host;
     /**
-     * Merged view of every `WR_ICONS` multi-provider visible from this
-     * injector position — element-level first overlay, environment-level
-     * (app/lazy-route bootstrap) as the base.
+     * Every icon visible from this position, walked up the whole chain of
+     * registering injector levels.
      *
-     * Angular's default `inject(WR_ICONS)` only returns the **closest**
-     * injector's contribution; if a component declares its own
-     * `provideWrIcons(...)`, the root registration is **shadowed**, not
-     * appended. That contradicts the docstring's "each call adds to the
-     * registry" promise and silently breaks any page that overrides while
-     * still relying on root-registered icons.
+     * Angular's `inject(WR_ICONS)` returns only the **closest** injector's
+     * contribution — `multi` providers are not merged across levels — so a
+     * component that registers its own icons used to shadow, not extend, what an
+     * ancestor registered. {@link WrIconRegistry} is provided once per
+     * registering level and links to its parent, so nesting any number of levels
+     * now adds up, with the nearest registration winning a name collision.
      *
-     * We work around it by also asking the environment injector directly
-     * (`envInjector.get(WR_ICONS, null, …)`). When no element-level
-     * provider exists both calls return the same array reference and we
-     * skip the redundant pass. Otherwise we lay element on top of env so
-     * a page's local icons can override a root-registered name.
-     *
-     * One known limitation: multiple element-injector levels in between
-     * still shadow each other — but the showcase doesn't nest providers
-     * that deep, and the env+local merge fixes the dominant case.
+     * Optional: with no `provideWrIcons()` anywhere the map is simply empty and
+     * every name reports as unregistered.
      */
-    private readonly iconSets;
+    private readonly iconRegistry;
     private readonly registry;
     private readonly icon;
     constructor();

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

@@ -44,6 +44,13 @@ declare class WrInputNumber implements FormValueControl<number | null> {
     readonly suffix: _angular_core.InputSignal<string>;
     /** Placeholder shown when the input is empty. */
     readonly placeholder: _angular_core.InputSignal<string>;
+    /**
+     * Accessible name for the field. Falls back to the placeholder — inside a
+     * `<wr-form-field>` the projected `wrInput` picks up the label's id and needs
+     * neither, but standalone the text field has no name at all.
+     */
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
     /** Disable interaction. @default false */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, any>;
     /** Read-only — values cannot be changed (steppers + typing disabled). @default false */
@@ -77,7 +84,7 @@ declare class WrInputNumber implements FormValueControl<number | null> {
     /** Format a value using `Intl.NumberFormat` for the active locale. */
     private format;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrInputNumber, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrInputNumber, "wr-input-number", never, { "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "decimals": { "alias": "decimals"; "required": false; "isSignal": true; }; "showSteppers": { "alias": "showSteppers"; "required": false; "isSignal": true; }; "prefix": { "alias": "prefix"; "required": false; "isSignal": true; }; "suffix": { "alias": "suffix"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrInputNumber, "wr-input-number", never, { "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "decimals": { "alias": "decimals"; "required": false; "isSignal": true; }; "showSteppers": { "alias": "showSteppers"; "required": false; "isSignal": true; }; "prefix": { "alias": "prefix"; "required": false; "isSignal": true; }; "suffix": { "alias": "suffix"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
 }
 
 export { WrInputNumber };

package/types/ngwr-input.d.ts

@@ -1,4 +1,4 @@
-import * as i0 from '@angular/core';
+import * as _angular_core from '@angular/core';
 
 /**
  * @license
@@ -7,7 +7,7 @@ import * as i0 from '@angular/core';
  * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
  */
 /**
- * Native input `type` values supported by `<wr-input>`.
+ * Native input `type` values supported by ``input[wrInput]``.
  */
 type WrInputType = 'text' | 'number' | 'password' | 'email' | 'search' | 'tel' | 'url';
 
@@ -42,16 +42,40 @@ type WrInputSize = 'sm' | 'md' | 'lg';
  * @see https://ngwr.dev/reference/components/input
  */
 declare class WrInput {
+    private readonly host;
+    private readonly field;
+    /**
+     * Read once, at construction: a static `id=""` in the template is already on
+     * the element by the time a directive is instantiated, and it must win over
+     * the field's generated one.
+     */
+    private readonly ownId;
+    /**
+     * Adopts the surrounding `<wr-form-field>`'s `controlId`, so the label it
+     * already rendered actually points at this element. Without this the `for`
+     * referenced an id that existed nowhere and the input had no label at all.
+     */
+    protected readonly resolvedId: _angular_core.Signal<string | null>;
+    /**
+     * Announced state, taken from the surrounding `<wr-form-field>`.
+     *
+     * The field renders the message but cannot reach the projected control, so
+     * the control reads back: without this the error is visible on screen and
+     * invisible to a screen reader, which never learns the field is invalid or
+     * what the message says.
+     */
+    protected readonly ariaInvalid: _angular_core.Signal<"true" | null>;
+    protected readonly describedBy: _angular_core.Signal<string | null>;
     /**
      * Control size. Named `wrSize` (not `size`) so it never clashes with the
      * native `<input size>` attribute. @default 'md'
      */
-    readonly wrSize: i0.InputSignal<WrInputSize>;
+    readonly wrSize: _angular_core.InputSignal<WrInputSize>;
     /** Pill-shaped corners. @default false */
-    readonly rounded: i0.InputSignalWithTransform<boolean, any>;
-    protected readonly classes: i0.Signal<string>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<WrInput, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<WrInput, "input[wrInput], textarea[wrInput]", never, { "wrSize": { "alias": "wrSize"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    readonly rounded: _angular_core.InputSignalWithTransform<boolean, any>;
+    protected readonly classes: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrInput, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<WrInput, "input[wrInput], textarea[wrInput]", never, { "wrSize": { "alias": "wrSize"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -68,8 +92,8 @@ declare class WrInput {
  * ```
  */
 declare class WrInputPrefix {
-    static ɵfac: i0.ɵɵFactoryDeclaration<WrInputPrefix, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<WrInputPrefix, "[wrInputPrefix]", never, {}, {}, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrInputPrefix, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<WrInputPrefix, "[wrInputPrefix]", never, {}, {}, never, never, true, never>;
 }
 
 /**
@@ -86,8 +110,8 @@ declare class WrInputPrefix {
  * ```
  */
 declare class WrInputSuffix {
-    static ɵfac: i0.ɵɵFactoryDeclaration<WrInputSuffix, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<WrInputSuffix, "[wrInputSuffix]", never, {}, {}, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrInputSuffix, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<WrInputSuffix, "[wrInputSuffix]", never, {}, {}, never, never, true, never>;
 }
 
 /**
@@ -112,10 +136,10 @@ declare class WrInputSuffix {
  */
 declare class WrInputGroup {
     /** Pill-shaped corners. @default false */
-    readonly rounded: i0.InputSignalWithTransform<boolean, any>;
-    protected readonly classes: i0.Signal<string>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<WrInputGroup, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<WrInputGroup, "wr-input-group", never, { "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    readonly rounded: _angular_core.InputSignalWithTransform<boolean, any>;
+    protected readonly classes: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrInputGroup, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrInputGroup, "wr-input-group", never, { "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 /**
@@ -133,12 +157,18 @@ declare class WrInputGroup {
  */
 declare class WrPasswordToggle {
     /** Reference to the linked password input. */
-    readonly for: i0.InputSignal<HTMLInputElement>;
-    protected readonly revealed: i0.WritableSignal<boolean>;
-    protected readonly ariaLabel: i0.Signal<"Hide password" | "Show password">;
+    readonly for: _angular_core.InputSignal<HTMLInputElement>;
+    protected readonly revealed: _angular_core.WritableSignal<boolean>;
+    /** Accessible name while the password is hidden. Falls back to `input.showPassword`. */
+    readonly showLabel: _angular_core.InputSignal<string | null>;
+    /** Accessible name while the password is revealed. Falls back to `input.hidePassword`. */
+    readonly hideLabel: _angular_core.InputSignal<string | null>;
+    private readonly resolvedShowLabel;
+    private readonly resolvedHideLabel;
+    protected readonly ariaLabel: _angular_core.Signal<string>;
     protected toggle(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<WrPasswordToggle, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<WrPasswordToggle, "wr-password-toggle", never, { "for": { "alias": "for"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrPasswordToggle, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrPasswordToggle, "wr-password-toggle", never, { "for": { "alias": "for"; "required": true; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "hideLabel": { "alias": "hideLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 export { WrInput, WrInputGroup, WrInputPrefix, WrInputSuffix, WrPasswordToggle };

package/types/ngwr-knob.d.ts

@@ -21,6 +21,9 @@ import { FormValueControl } from '@angular/forms/signals';
  * @see https://ngwr.dev/reference/components/knob
  */
 declare class WrKnob implements FormValueControl<number> {
+    /** Accessible name — the role needs one. Falls back to `knob.label`. */
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    protected readonly resolvedAriaLabel: _angular_core.Signal<string>;
     /** Minimum allowed value. @default 0 */
     readonly min: _angular_core.InputSignalWithTransform<number | undefined, unknown>;
     /** Maximum allowed value. @default 100 */
@@ -76,7 +79,7 @@ declare class WrKnob implements FormValueControl<number> {
     private commit;
     private arcPath;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrKnob, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrKnob, "wr-knob", never, { "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; "trackColor": { "alias": "trackColor"; "required": false; "isSignal": true; }; "valueColor": { "alias": "valueColor"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "required": false; "isSignal": true; }; "suffix": { "alias": "suffix"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrKnob, "wr-knob", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; "trackColor": { "alias": "trackColor"; "required": false; "isSignal": true; }; "valueColor": { "alias": "valueColor"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "required": false; "isSignal": true; }; "suffix": { "alias": "suffix"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
 }
 
 export { WrKnob };

package/types/ngwr-lightbox.d.ts

@@ -19,6 +19,9 @@ import { TemplateRef } from '@angular/core';
  * @see https://ngwr.dev/reference/components/lightbox
  */
 declare class WrLightbox {
+    /** Accessible name. Falls back to `image.close`, then `'Close preview'`. */
+    readonly closeLabel: _angular_core.InputSignal<string | null>;
+    protected readonly resolvedCloseLabel: _angular_core.Signal<string>;
     /** Image source. */
     readonly src: _angular_core.InputSignal<string>;
     /** Alt text. Required for a11y; falls back to an empty string. @default '' */
@@ -44,6 +47,9 @@ declare class WrLightbox {
     private readonly overlay;
     private readonly vcr;
     private readonly destroyRef;
+    private readonly focusTrapFactory;
+    private focusTrap;
+    private previouslyFocused;
     private overlayRef;
     constructor();
     protected onClick(): void;
@@ -57,7 +63,7 @@ declare class WrLightbox {
     private openOverlay;
     private closeOverlay;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrLightbox, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrLightbox, "wr-lightbox", never, { "src": { "alias": "src"; "required": true; "isSignal": true; }; "alt": { "alias": "alt"; "required": false; "isSignal": true; }; "preview": { "alias": "preview"; "required": false; "isSignal": true; }; "disablePreview": { "alias": "disablePreview"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "aspectRatio": { "alias": "aspectRatio"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrLightbox, "wr-lightbox", never, { "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; "src": { "alias": "src"; "required": true; "isSignal": true; }; "alt": { "alias": "alt"; "required": false; "isSignal": true; }; "preview": { "alias": "preview"; "required": false; "isSignal": true; }; "disablePreview": { "alias": "disablePreview"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "aspectRatio": { "alias": "aspectRatio"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 export { WrLightbox };

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

@@ -12,7 +12,7 @@ interface WrLineSeries {
  *
  * @example
  * ```html
- * <wr-lineChart
+ * <wr-line-chart
  *   [series]="[
  *     { label: 'Visits', data: [12, 18, 9, 22, 30, 27, 35] },
  *     { label: 'Signups', data: [3, 5, 4, 8, 11, 9, 14], color: 'var(--wr-color-success)' }

package/types/ngwr-media.d.ts

@@ -3,7 +3,7 @@ import { InjectionToken, Signal, EnvironmentProviders } from '@angular/core';
 import * as ngwr_media from 'ngwr/media';
 
 /** Named breakpoint identifiers — match the SCSS `_breakpoints.scss` keys. */
-type WrBreakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
+type WrBreakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl' | 'xga' | 'fhd' | 'rt';
 /** Map of breakpoint → minimum viewport width in pixels. */
 type WrBreakpointMap = Readonly<Record<WrBreakpoint, number>>;
 

package/types/ngwr-mention.d.ts

@@ -62,12 +62,43 @@ declare class WrMention<T extends WrMentionItem = WrMentionItem> {
     private readonly overlay;
     private readonly scrollStrategies;
     private readonly destroyRef;
+    private readonly isBrowser;
     private overlayRef;
     private panelRef;
     private state;
     private readonly activeIndex;
     private readonly filteredItems;
+    private readonly isOpen;
+    /** @internal — read by the `aria-controls` host binding. */
+    protected readonly listboxId: string;
+    private readonly listLabel;
+    private readonly availableText;
+    private readonly insertedText;
+    /**
+     * `aria-activedescendant`, or `null`.
+     *
+     * Gated hard on `isOpen()`, which is only set once the panel's options are
+     * actually in the DOM. An id that resolves to nothing is an author error, and
+     * the failure mode is silent: the browser does not complain, it simply stops
+     * firing the event that makes a screen reader speak the option. Same
+     * discipline `tree.ts` uses for its virtualized rows.
+     */
+    protected readonly activeOptionId: _angular_core.Signal<string | null>;
+    /**
+     * Polite live region, parked on `<body>`.
+     *
+     * Not inside the panel: `close()` disposes the overlay on every keystroke that
+     * leaves a mention, so a region living there would be recreated constantly —
+     * and a live region has to be in the DOM *before* its text changes to be
+     * announced at all. It also could not announce the two cases that matter most,
+     * since in both the panel is already gone: "nothing matched" and "inserted X".
+     *
+     * Not a sibling of the host either — that would land inside the consumer's
+     * markup and start matching their `+`, `~` and `:nth-child()` selectors.
+     */
+    private liveRegion;
     constructor();
+    private announce;
     /** @internal */
     protected onInput(): void;
     /** @internal */
@@ -97,13 +128,26 @@ declare class WrMentionPanel {
     readonly items: _angular_core.InputSignal<readonly WrMentionItem[]>;
     readonly activeIndex: _angular_core.InputSignal<number>;
     readonly displayWith: _angular_core.InputSignal<(item: WrMentionItem) => string>;
+    /**
+     * Id of the `<ul role="listbox">`, minted by the directive and pointed at by
+     * its `aria-controls`. Owned there rather than here because the panel is
+     * disposed and rebuilt whenever the caret leaves a mention, while the
+     * attribute on the host has to stay put.
+     *
+     * Plain `input('')`, never `input.required` — a ComponentPortal-created
+     * component throws on the first change detection if a required input is unset.
+     */
+    readonly listboxId: _angular_core.InputSignal<string>;
+    /** Accessible name for the listbox. ARIA requires one; the directive supplies it from the catalog. */
+    readonly listLabel: _angular_core.InputSignal<string>;
+    protected optionId(index: number): string;
     /** Emitted when the user picks an item (click). */
     readonly picked: _angular_core.OutputEmitterRef<WrMentionItem>;
     /** Emitted on mouseenter — used by the directive to track hover. */
     readonly hovered: _angular_core.OutputEmitterRef<number>;
     protected onPick(item: WrMentionItem, event: MouseEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrMentionPanel, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrMentionPanel, "wr-mention-panel", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "activeIndex": { "alias": "activeIndex"; "required": false; "isSignal": true; }; "displayWith": { "alias": "displayWith"; "required": false; "isSignal": true; }; }, { "picked": "picked"; "hovered": "hovered"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrMentionPanel, "wr-mention-panel", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "activeIndex": { "alias": "activeIndex"; "required": false; "isSignal": true; }; "displayWith": { "alias": "displayWith"; "required": false; "isSignal": true; }; "listboxId": { "alias": "listboxId"; "required": false; "isSignal": true; }; "listLabel": { "alias": "listLabel"; "required": false; "isSignal": true; }; }, { "picked": "picked"; "hovered": "hovered"; }, never, never, true, never>;
 }
 
 export { WrMention, WrMentionPanel };

package/types/ngwr-meter-group.d.ts

@@ -35,6 +35,9 @@ interface WrMeterSegment {
  * @see https://ngwr.dev/reference/components/meter-group
  */
 declare class WrMeterGroup {
+    /** Accessible name — the role needs one. Falls back to `meterGroup.label`. */
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    protected readonly resolvedAriaLabel: _angular_core.Signal<string>;
     readonly segments: _angular_core.InputSignal<readonly WrMeterSegment[]>;
     /** Explicit total. When `0` (default), `max = sum(values)`. @default 0 */
     readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
@@ -43,6 +46,11 @@ declare class WrMeterGroup {
     /** Show each segment's percent value in the legend. @default true */
     readonly showValues: _angular_core.InputSignalWithTransform<boolean, any>;
     protected readonly resolvedMax: _angular_core.Signal<number>;
+    /**
+     * Sum of the segments, for `aria-valuenow`. `role="progressbar"` without it
+     * announces no value at all, so the bar was invisible to assistive tech.
+     */
+    protected readonly totalValue: _angular_core.Signal<number>;
     protected readonly slices: _angular_core.Signal<{
         label: string;
         value: number;
@@ -50,7 +58,7 @@ declare class WrMeterGroup {
         percent: number;
     }[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrMeterGroup, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrMeterGroup, "wr-meter-group", never, { "segments": { "alias": "segments"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "showLegend": { "alias": "showLegend"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrMeterGroup, "wr-meter-group", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "segments": { "alias": "segments"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "showLegend": { "alias": "showLegend"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 export { WrMeterGroup };

package/types/ngwr-overlay.d.ts

@@ -1,7 +1,85 @@
-import { OverlayContainer, Overlay } from '@angular/cdk/overlay';
+import { OverlayRef, OverlayContainer, Overlay } from '@angular/cdk/overlay';
+import { Observable } from 'rxjs';
 import * as i0 from '@angular/core';
 import { EnvironmentProviders, InjectionToken } 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
+ */
+/**
+ * Appends a dismiss (✕) button to a service-opened overlay panel.
+ *
+ * `WrDialog` and `WrDrawerManager` build their panel around a component the
+ * consumer supplies, so there is no template of their own to put a corner button
+ * in — they call this instead. Component-driven overlays (`<wr-drawer>`) render
+ * the same markup in their template.
+ *
+ * Uses `host.ownerDocument` rather than the global `document`, so it carries no
+ * hidden browser-only assumption; callers still gate on the platform because
+ * they have nothing to append to on the server.
+ *
+ * @param host Panel element the button is appended to (and positioned against).
+ * @param className BEM class for the button, e.g. `wr-dialog__close`.
+ * @param label Accessible name — already localized by the caller.
+ * @param onClose Invoked on click.
+ */
+declare function wrAppendOverlayClose(host: HTMLElement, className: string, label: string, onClose: () => void): HTMLButtonElement;
+
+/**
+ * @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
+ */
+
+/**
+ * Outside-click source for overlays — a drop-in replacement for
+ * `OverlayRef.outsidePointerEvents()`.
+ *
+ * **Why this exists.** CDK's `OverlayOutsideClickDispatcher` binds its
+ * listeners to `document.body`. When page content is shorter than the viewport,
+ * a click in the empty space below it targets `<html>` — and `<html>` is
+ * `body`'s *parent*, so the event bubbles straight to the document and `body`
+ * never sees it. The overlay silently stays open. Listening on the document
+ * itself catches both cases, and costs nothing else.
+ *
+ * Semantics are otherwise identical to the CDK's, deliberately:
+ *
+ * - Emits on `click` / `auxclick` / `contextmenu`, in the capture phase, and
+ *   tracks `pointerdown` so a `click` is judged by where the press *started*
+ *   (a drag that ends outside the pane doesn't count as an outside click).
+ * - Walks watchers top-most first and stops at the first one that contains the
+ *   event, so clicking inside a stacked overlay can't close the ones beneath
+ *   it (a `wr-select` opened inside a `wr-popover`, say).
+ * - Fires for the very click that opened the overlay, which is why every caller
+ *   also ignores events landing on its own trigger.
+ *
+ * Registration is per subscription: the document listeners go up with the first
+ * watcher and come down with the last, so an app with no open overlay has none.
+ */
+declare class WrOutsideClick {
+    private readonly doc;
+    private readonly isBrowser;
+    /** In attach order — last is top-most. */
+    private readonly watchers;
+    private cleanup;
+    private pressOrigin;
+    /**
+     * Emits every `click` / `auxclick` / `contextmenu` that lands outside the
+     * given overlay's pane, for as long as the returned observable is subscribed.
+     */
+    outsidePointerEvents(overlayRef: OverlayRef): Observable<MouseEvent>;
+    private readonly onPointerDown;
+    private readonly onClick;
+    private listen;
+    private unlisten;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WrOutsideClick, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<WrOutsideClick>;
+}
+
 /**
  * @license
  *
@@ -175,4 +253,4 @@ declare const WR_OVERLAY: InjectionToken<Overlay>;
  */
 declare const WR_OVERLAY_CONTAINER: InjectionToken<OverlayContainer>;
 
-export { WR_OVERLAY, WR_OVERLAY_CONTAINER, WR_RESPONSIVE_OVERLAYS, WrOverlayContainer, provideWrOverlay, provideWrResponsiveOverlays, wrPresentAsSheet };
+export { WR_OVERLAY, WR_OVERLAY_CONTAINER, WR_RESPONSIVE_OVERLAYS, WrOutsideClick, WrOverlayContainer, provideWrOverlay, provideWrResponsiveOverlays, wrAppendOverlayClose, wrPresentAsSheet };

package/types/ngwr-page-header.d.ts

@@ -11,8 +11,8 @@ import * as _angular_core from '@angular/core';
  * <wr-page-header title="Settings" subtitle="Manage your workspace">
  *   <nav wrPageHeaderBreadcrumbs>…</nav>
  *   <div wrPageHeaderActions>
- *     <button wrButton>Invite</button>
- *     <button wrButton color="primary">Save</button>
+ *     <button wr-btn>Invite</button>
+ *     <button wr-btn color="primary">Save</button>
  *   </div>
  *   <div wrPageHeaderExtra>
  *     <wr-tag>v2.4</wr-tag>