@truenas/ui-components 0.6.2 → 0.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truenas/ui-components",
-  "version": "0.6.2",
+  "version": "0.7.1",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public"

package/types/truenas-ui-components.d.ts

@@ -1055,26 +1055,6 @@ interface AutocompleteHarnessFilters extends BaseHarnessFilters {
 
 type TnDrawerMode = 'side' | 'over';
 type TnDrawerPosition = 'start' | 'end';
-/**
- * The accessible name a drawer falls back to when the caller names neither
- * `ariaLabel` nor `ariaLabelledby` (#214).
- *
- * `ariaLabel` defaults to `undefined`, so the DEFAULT rendering in `over` mode
- * was a `role="dialog"` with `aria-modal="true"` and no name — measured as an
- * `aria-dialog-name` violation. In `side` mode the same omission leaves a
- * `role="navigation"` landmark unnamed, which axe does not report while there is
- * only one of them on the page, and which stops telling them apart the moment
- * there are two.
- *
- * One fallback for both modes rather than one per mode: the drawer is the same
- * surface either way, the name answers the same question ("what is this?"), and
- * a rule that changes with the mode is one more thing for a caller to be wrong
- * about. A generic name is still a poor one, so it is paired with the dev-mode
- * warning `tnAccessibleName` raises.
- *
- * Exported so specs assert against it by name rather than by a copied literal.
- */
-declare const TN_DRAWER_DEFAULT_LABEL = "Drawer";
 /**
  * A drawer, which is two different things by `mode`: in `side` it is
  * persistent navigation beside the page's content, and in `over` it is a modal
@@ -1184,6 +1164,7 @@ declare class TnDrawerComponent implements OnDestroy {
     protected trapFocus: _angular_core.Signal<boolean>;
     /** Role depends on mode: navigation for side, dialog for over */
     protected panelRole: _angular_core.Signal<"dialog" | "navigation">;
+    private readonly fallbackName;
     /**
      * The name to render as `aria-label`, or `null` to render none — and the
      * dev-mode warning when the caller named neither input.
@@ -4736,6 +4717,12 @@ declare class TnRadioComponent implements AfterViewInit, OnDestroy, ControlValue
     name: _angular_core.InputSignal<string | undefined>;
     disabled: _angular_core.InputSignal<boolean>;
     required: _angular_core.InputSignal<boolean>;
+    /**
+     * Test-id base. The element type this composes with is `radio-button`, not `radio`: the id
+     * identifies one radio BUTTON within a `radio-group`, matching the `radio-group`/`radio-button`
+     * pair every other grouped control in this library uses (`button-toggle-group`/`button-toggle`).
+     * So `testId="email"` yields `radio-button-email`.
+     */
     testId: _angular_core.InputSignal<TnTestIdValue>;
     /** Test-id base, falling back to the bound control name when `testId` is unset. */
     protected resolvedTestId: _angular_core.Signal<TnTestIdValue>;
@@ -5002,7 +4989,7 @@ declare class TnRadioGroupComponent<T = unknown> implements ControlValueAccessor
     /**
      * Test-id base for the group and, scoped by the option label, for every option rendered from
      * `options`: base `encryption` yields `radio-group-encryption` on the group and
-     * `radio-encryption-passphrase` on its options. Falls back to the bound control name.
+     * `radio-button-encryption-passphrase` on its options. Falls back to the bound control name.
      *
      * Projected `<tn-radio>` children keep their own test-id resolution — the group does not reach
      * into content it did not render — so give each one a `testId` of its own.
@@ -11023,21 +11010,236 @@ declare function labelMarkupToHtml(value: string): string;
  */
 declare function labelMarkupToText(value: string): string;
 
-type SpinnerMode = 'determinate' | 'indeterminate';
+/**
+ * Every generic name this library falls back to when a caller names neither
+ * `ariaLabel` nor `ariaLabelledby`, in one bundle a consumer provides once.
+ *
+ * WHY A TOKEN AND NOT CONSTANTS ALONE
+ * -----------------------------------
+ * The constants below are English, and a spinner announcing "Loading" to a
+ * screen reader in a Spanish app is the same untranslated-chrome bug that
+ * `TN_SELECT_LABELS` and `TN_TABLE_LABELS` were added for: a string this
+ * library renders into a consumer's UI has to be translatable, and the only
+ * route to these was an `ariaLabel` on every single call site. In webui that
+ * came to nineteen spinners and nineteen bars each carrying an identical
+ * `[ariaLabel]="'Loading' | translate"` — the copy-on-every-instance shape
+ * those two tokens already exist to remove.
+ *
+ * A per-instance `ariaLabel` still wins, and is still the right answer wherever
+ * a name can say WHAT is loading or WHAT is open. This token is for the rest:
+ * the generic name the component would otherwise render in English.
+ *
+ * WHY ONE BUNDLE, AND WHICH NAMES ARE IN IT
+ * -----------------------------------------
+ * Exactly the fallbacks `tnAccessibleName` renders — the four progressbars and
+ * the three surfaces — because they already share one rule, and a consumer
+ * translating one of them wants all seven. Separate keys rather than one shared
+ * string, because the least-bad generic name differs by what the component is
+ * ("Progress" for a bar, "Loading" for a spinner, "Dialog" for a dialog), and
+ * `tn-branded-spinner` differs again for a reason
+ * {@link TN_BRANDED_SPINNER_DEFAULT_LABEL} sets out.
+ *
+ * Not in it: `TN_SIDE_PANEL_CONTENT_LABEL`, `TN_DRAWER_CONTENT_LABEL`,
+ * `TN_TAB_PANEL_CONTENT_LABEL` and `TN_TABLE_SCROLL_REGION_LABEL`. Those name a
+ * scrolling REGION rather than the component, each already has a per-instance
+ * input a consumer can translate through, and none of them warns — so they are
+ * a separate decision from this one rather than part of it.
+ *
+ * WHAT PROVIDING IT DOES TO THE DEV WARNING
+ * -----------------------------------------
+ * It stands the warning down for the components whose fallback it supplies.
+ * That is the same exception `tn-table-pager` already has, for the same reason,
+ * written out at `resolvedTablePaginationLabel`: a name the consumer configured
+ * is a DESIGNED name, not a last resort for one someone forgot, so warning
+ * about it fires on the ordinary case and teaches readers to ignore the warning
+ * where it means something. Registering this provider is a deliberate app-wide
+ * decision about what an unnamed spinner or surface should say; the warning has
+ * been heard, and an app that has answered it should not have every test that
+ * renders a spinner fail on the answer.
+ *
+ * The half of `tnAccessibleName` that is NOT about the warning is unchanged: an
+ * explicit `ariaLabel` still always survives, and the fallback — configured or
+ * not — is still withheld beside an `ariaLabelledby`, so a dangling IDREF still
+ * fails its axe name rule loudly instead of being masked by a name that says
+ * nothing.
+ *
+ * Unlike its neighbours in this folder (`accessible-name.ts`, `live-region.ts`),
+ * this file IS part of the public API: it is how a consumer answers the
+ * question those two only ask.
+ */
+interface TnFallbackLabels {
+    /** Fallback name for `tn-spinner`. */
+    spinner: string;
+    /** Fallback name for `tn-branded-spinner`. */
+    brandedSpinner: string;
+    /** Fallback name for `tn-progress-bar`. */
+    progressBar: string;
+    /** Fallback name for `tn-particle-progress-bar`. */
+    particleProgressBar: string;
+    /** Fallback name for the `tn-dialog-shell` surface itself, for a dialog with no `title`. */
+    dialog: string;
+    /** Fallback name for the `tn-side-panel` surface itself, for a panel with no `title`. */
+    sidePanel: string;
+    /** Fallback name for `tn-drawer`, in both of its modes. */
+    drawer: string;
+}
 /**
  * The accessible name a spinner falls back to when the caller names neither
  * `ariaLabel` nor `ariaLabelledby` (#202). Same reasoning as
- * `TN_PROGRESS_BAR_DEFAULT_LABEL`, and the case is sharper here: the spinner
- * defaults to indeterminate mode, so its unnamed default rendering reached
- * assistive technology as a progressbar with neither a name nor a value.
+ * {@link TN_PROGRESS_BAR_DEFAULT_LABEL}, and the case is sharper here: the
+ * spinner defaults to indeterminate mode, so its unnamed default rendering
+ * reached assistive technology as a progressbar with neither a name nor a
+ * value.
  *
- * `branded-spinner.component.ts` in this folder already fell back this way —
+ * `branded-spinner.component.ts` already fell back this way —
  * `ariaLabel() || "Loading..."` inline — so a fallback is the shape this
  * library had already settled on; what it lacked was the warning. It has both
- * since #206, through the same `tnAccessibleName` this component uses, which is
+ * since #206, through the same `tnAccessibleName` that component uses, which is
  * why the two constants sit side by side and differ.
  */
 declare const TN_SPINNER_DEFAULT_LABEL = "Loading";
+/**
+ * The name `tn-branded-spinner` falls back to when the caller names neither
+ * `ariaLabel` nor `ariaLabelledby`. Same reasoning as
+ * {@link TN_SPINNER_DEFAULT_LABEL} and {@link TN_PROGRESS_BAR_DEFAULT_LABEL}.
+ *
+ * It differs from `TN_SPINNER_DEFAULT_LABEL` — `"Loading..."` against
+ * `"Loading"` — only because this is the string the component already rendered,
+ * inline in its host binding, before #206 gave it the shared resolver. Aligning
+ * the two would change what a screen reader announces for every unnamed branded
+ * spinner already in the wild, which is a louder change than the consistency
+ * fix it would be part of. Exported so specs assert against it by name rather
+ * than by a copied string literal.
+ */
+declare const TN_BRANDED_SPINNER_DEFAULT_LABEL = "Loading...";
+/**
+ * The accessible name a bar falls back to when the caller names neither
+ * `ariaLabel` nor `ariaLabelledby` (#202).
+ *
+ * Deliberately generic, and deliberately not silent: the host carries
+ * `role="progressbar"` unconditionally, so without a fallback the default
+ * rendering is a progressbar assistive technology announces with no name at all
+ * — "progress bar, 40%", with nothing to say what is progressing. The
+ * alternative fix, withholding the role until there is a name for it, trades
+ * that for no announcement whatever, which is worse: a screen reader would not
+ * learn that anything is in progress, and on a determinate bar it would lose
+ * the value too.
+ *
+ * A generic name is still a poor one, so it is paired with the dev-mode warning
+ * `tnAccessibleName` raises. Exported so specs assert against it by name rather
+ * than by a copied string literal.
+ */
+declare const TN_PROGRESS_BAR_DEFAULT_LABEL = "Progress";
+/**
+ * The accessible name `tn-particle-progress-bar` falls back to when the caller
+ * names neither `ariaLabel` nor `ariaLabelledby` (#209).
+ *
+ * The same string and the same reasoning as
+ * {@link TN_PROGRESS_BAR_DEFAULT_LABEL} next door, and deliberately a separate
+ * constant rather than an alias of it: `tnAccessibleName` takes a fallback PER
+ * COMPONENT because the least-bad generic name differs by what the component is
+ * ("Progress" for a bar, "Loading" for a spinner), and sharing the binding would
+ * make a future divergence in one a silent change to the other. Exported so
+ * specs assert against it by name rather than by a copied string literal.
+ */
+declare const TN_PARTICLE_PROGRESS_BAR_DEFAULT_LABEL = "Progress";
+/**
+ * The accessible name a dialog falls back to when it renders no `title` and the
+ * caller named it through neither this component nor the `DialogConfig` (#219).
+ *
+ * `title` defaults to `''`, so the DEFAULT rendering of this component put an
+ * empty `<h2>` in the header and left the CDK container with no naming
+ * attribute at all — measured as `empty-heading` on the heading and
+ * `aria-dialog-name` on the dialog. A dialog with no name is announced as
+ * "dialog" and nothing else, which is the whole of what a screen-reader user is
+ * told about a surface that just took over the page and trapped their focus.
+ *
+ * "Dialog" is a poor name, and says almost exactly what the role already says.
+ * It is still better than the two alternatives: leaving the surface unnamed, or
+ * withholding `role="dialog"` until there is a name — the latter would move a
+ * listener into a focus trap with no announcement that anything had opened. So
+ * it is paired with the dev-mode warning `tnAccessibleName` raises, which is
+ * what keeps the fallback from becoming a quiet way to ship a nameless dialog.
+ *
+ * Exported so specs assert against it by name rather than by a copied literal.
+ */
+declare const TN_DIALOG_SHELL_DEFAULT_LABEL = "Dialog";
+/**
+ * The accessible name an open panel falls back to when it has no `title` and the
+ * caller named neither `ariaLabel` nor `ariaLabelledby` (#214).
+ *
+ * `title` defaults to `''`, so the DEFAULT rendering of this component was a
+ * `role="dialog"` with `aria-labelledby` pointing at an empty `<h2>` — measured
+ * as an `aria-dialog-name` violation, alongside `empty-heading`. A dialog with no
+ * name is announced as "dialog" and nothing else, which is the whole of what a
+ * screen-reader user gets told about a surface that just covered the page.
+ *
+ * Withholding `role="dialog"` until there is a name would be the other way to
+ * clear the rule, and it is worse: the panel traps focus either way, so a
+ * listener would be moved into a region with no announcement that anything had
+ * opened. A generic name is still a poor one, so it is paired with the dev-mode
+ * warning `tnAccessibleName` raises.
+ *
+ * Exported so specs assert against it by name rather than by a copied literal.
+ */
+declare const TN_SIDE_PANEL_DEFAULT_LABEL = "Side panel";
+/**
+ * The accessible name a drawer falls back to when the caller names neither
+ * `ariaLabel` nor `ariaLabelledby` (#214).
+ *
+ * `ariaLabel` defaults to `undefined`, so the DEFAULT rendering in `over` mode
+ * was a `role="dialog"` with `aria-modal="true"` and no name — measured as an
+ * `aria-dialog-name` violation. In `side` mode the same omission leaves a
+ * `role="navigation"` landmark unnamed, which axe does not report while there is
+ * only one of them on the page, and which stops telling them apart the moment
+ * there are two.
+ *
+ * One fallback for both modes rather than one per mode: the drawer is the same
+ * surface either way, the name answers the same question ("what is this?"), and
+ * a rule that changes with the mode is one more thing for a caller to be wrong
+ * about. A generic name is still a poor one, so it is paired with the dev-mode
+ * warning `tnAccessibleName` raises.
+ *
+ * Exported so specs assert against it by name rather than by a copied literal.
+ */
+declare const TN_DRAWER_DEFAULT_LABEL = "Drawer";
+/** English defaults used when no {@link TN_FALLBACK_LABELS} provider is registered. */
+declare const TN_DEFAULT_FALLBACK_LABELS: TnFallbackLabels;
+/**
+ * DI token for the app-wide fallback names above. Provide either a static
+ * object or a `Signal<TnFallbackLabels>` — the latter lets every component
+ * react to language changes when the consumer wires it up to an i18n service.
+ *
+ * An `ariaLabel` on a particular instance still wins over these, and is still
+ * what to reach for when a name can say what is loading or what is open.
+ */
+declare const TN_FALLBACK_LABELS: InjectionToken<TnFallbackLabels | Signal<TnFallbackLabels>>;
+/** One component's fallback name, and where it came from. */
+interface TnFallbackName {
+    /** The name to render when the caller names neither input. */
+    label: Signal<string>;
+    /**
+     * Whether that name came from a consumer's provider rather than this
+     * library's English default — which is what decides whether an unnamed
+     * instance warns. See the file comment above.
+     */
+    configured: boolean;
+}
+/**
+ * Reads one component's fallback name out of {@link TN_FALLBACK_LABELS}.
+ *
+ * Not `injectTnLabels`, which normalizes the token to a Signal and drops the
+ * value it started from: telling a configured bundle from the built-in one is an
+ * identity check against `builtInLabels`, so this needs the raw injected value.
+ * A consumer who provides a bundle equal to the defaults — the exported constant
+ * included — still counts as configured, which is the right way round: they said
+ * so on purpose.
+ *
+ * **Must be called from an injection context.**
+ */
+declare function injectTnFallbackName(key: keyof TnFallbackLabels): TnFallbackName;
+
+type SpinnerMode = 'determinate' | 'indeterminate';
 declare class TnSpinnerComponent {
     mode: _angular_core.InputSignal<SpinnerMode>;
     value: _angular_core.InputSignal<number>;
@@ -11045,6 +11247,7 @@ declare class TnSpinnerComponent {
     strokeWidth: _angular_core.InputSignal<number>;
     ariaLabel: _angular_core.InputSignal<string | null>;
     ariaLabelledby: _angular_core.InputSignal<string | null>;
+    private readonly fallbackName;
     /**
      * The name to render, or `null` to render no `aria-label` attribute — and the
      * dev-mode warning when the caller named neither input.
@@ -11066,23 +11269,10 @@ declare class TnSpinnerComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnSpinnerComponent, "tn-spinner", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "diameter": { "alias": "diameter"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "ariaLabelledby"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-/**
- * The name this spinner falls back to when the caller names neither `ariaLabel`
- * nor `ariaLabelledby`. Same reasoning as `TN_SPINNER_DEFAULT_LABEL` and
- * `TN_PROGRESS_BAR_DEFAULT_LABEL`.
- *
- * It differs from `TN_SPINNER_DEFAULT_LABEL` — `"Loading..."` against
- * `"Loading"` — only because this is the string the component already rendered,
- * inline in its host binding, before #206 gave it the shared resolver. Aligning
- * the two would change what a screen reader announces for every unnamed branded
- * spinner already in the wild, which is a louder change than the consistency
- * fix it would be part of. Exported so specs assert against it by name rather
- * than by a copied string literal.
- */
-declare const TN_BRANDED_SPINNER_DEFAULT_LABEL = "Loading...";
 declare class TnBrandedSpinnerComponent implements OnInit, OnDestroy, AfterViewInit {
     ariaLabel: _angular_core.InputSignal<string | null>;
     ariaLabelledby: _angular_core.InputSignal<string | null>;
+    private readonly fallbackName;
     /**
      * The name to render, or `null` to render no `aria-label` attribute — and the
      * dev-mode warning when the caller named neither input.
@@ -11114,30 +11304,13 @@ declare class TnBrandedSpinnerComponent implements OnInit, OnDestroy, AfterViewI
 }
 
 type ProgressBarMode = 'determinate' | 'indeterminate' | 'buffer';
-/**
- * The accessible name a bar falls back to when the caller names neither
- * `ariaLabel` nor `ariaLabelledby` (#202).
- *
- * Deliberately generic, and deliberately not silent: the host carries
- * `role="progressbar"` unconditionally, so without a fallback the default
- * rendering is a progressbar assistive technology announces with no name at all
- * — "progress bar, 40%", with nothing to say what is progressing. The
- * alternative fix, withholding the role until there is a name for it, trades
- * that for no announcement whatever, which is worse: a screen reader would not
- * learn that anything is in progress, and on a determinate bar it would lose
- * the value too.
- *
- * A generic name is still a poor one, so it is paired with the dev-mode warning
- * `tnAccessibleName` raises. Exported so specs assert against it by name rather
- * than by a copied string literal.
- */
-declare const TN_PROGRESS_BAR_DEFAULT_LABEL = "Progress";
 declare class TnProgressBarComponent {
     mode: _angular_core.InputSignal<ProgressBarMode>;
     value: _angular_core.InputSignal<number>;
     bufferValue: _angular_core.InputSignal<number>;
     ariaLabel: _angular_core.InputSignal<string | null>;
     ariaLabelledby: _angular_core.InputSignal<string | null>;
+    private readonly fallbackName;
     /**
      * The name to render, or `null` to render no `aria-label` attribute — and the
      * dev-mode warning when the caller named neither input.
@@ -11171,19 +11344,6 @@ declare class TnProgressBarComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnProgressBarComponent, "tn-progress-bar", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "bufferValue": { "alias": "bufferValue"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "ariaLabelledby"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-/**
- * The accessible name this bar falls back to when the caller names neither
- * `ariaLabel` nor `ariaLabelledby` (#209).
- *
- * The same string and the same reasoning as `TN_PROGRESS_BAR_DEFAULT_LABEL`
- * next door, and deliberately a separate constant rather than an import of it:
- * `tnAccessibleName` takes a fallback PER COMPONENT because the least-bad
- * generic name differs by what the component is ("Progress" for a bar,
- * "Loading" for a spinner), and sharing the binding would make a future
- * divergence in one a silent change to the other. Exported so specs assert
- * against it by name rather than by a copied string literal.
- */
-declare const TN_PARTICLE_PROGRESS_BAR_DEFAULT_LABEL = "Progress";
 /**
  * THE DECISION #209 ASKED FOR: THIS IS A PROGRESSBAR, NOT DECORATION
  * ------------------------------------------------------------------
@@ -11243,6 +11403,7 @@ declare class TnParticleProgressBarComponent implements AfterViewInit, OnDestroy
     canvasRef: _angular_core.Signal<ElementRef<HTMLCanvasElement>>;
     /** Exposed to the template so the rects and the ARIA value share one inset. */
     readonly trackInset = 50;
+    private readonly fallbackName;
     /**
      * The name to render, or `null` to render no `aria-label` at all — and the
      * dev-mode warning when the caller named neither input.
@@ -13150,27 +13311,6 @@ declare const TN_DIALOG_DEFAULT_CHROME_LABELS: TnDialogChromeLabels;
  * the consumer wires it up to an i18n service.
  */
 declare const TN_DIALOG_CHROME_LABELS: InjectionToken<TnDialogChromeLabels | Signal<TnDialogChromeLabels>>;
-/**
- * The accessible name a dialog falls back to when it renders no `title` and the
- * caller named it through neither this component nor the `DialogConfig` (#219).
- *
- * `title` defaults to `''`, so the DEFAULT rendering of this component put an
- * empty `<h2>` in the header and left the CDK container with no naming
- * attribute at all — measured as `empty-heading` on the heading and
- * `aria-dialog-name` on the dialog. A dialog with no name is announced as
- * "dialog" and nothing else, which is the whole of what a screen-reader user is
- * told about a surface that just took over the page and trapped their focus.
- *
- * "Dialog" is a poor name, and says almost exactly what the role already says.
- * It is still better than the two alternatives: leaving the surface unnamed, or
- * withholding `role="dialog"` until there is a name — the latter would move a
- * listener into a focus trap with no announcement that anything had opened. So
- * it is paired with the dev-mode warning `tnAccessibleName` raises, which is
- * what keeps the fallback from becoming a quiet way to ship a nameless dialog.
- *
- * Exported so specs assert against it by name rather than by a copied literal.
- */
-declare const TN_DIALOG_SHELL_DEFAULT_LABEL = "Dialog";
 declare class TnDialogShellComponent implements OnInit {
     protected readonly labels: Signal<TnDialogChromeLabels>;
     /** Accessible name for the fullscreen toggle, following its current state. */
@@ -13270,6 +13410,7 @@ declare class TnDialogShellComponent implements OnInit {
     private resolvedAriaLabelledby;
     /** An explicit label, from this component's input or from the `DialogConfig`. */
     private explicitAriaLabel;
+    private readonly fallbackName;
     /**
      * The name to render as `aria-label`, or `null` to render none — and the
      * dev-mode warning when the dialog has no name from any route.
@@ -13487,25 +13628,6 @@ declare class TnDialogTesting {
     static rootLoader(fixture: ComponentFixture<unknown>): HarnessLoader;
 }
 
-/**
- * The accessible name an open panel falls back to when it has no `title` and the
- * caller named neither `ariaLabel` nor `ariaLabelledby` (#214).
- *
- * `title` defaults to `''`, so the DEFAULT rendering of this component was a
- * `role="dialog"` with `aria-labelledby` pointing at an empty `<h2>` — measured
- * as an `aria-dialog-name` violation, alongside `empty-heading`. A dialog with no
- * name is announced as "dialog" and nothing else, which is the whole of what a
- * screen-reader user gets told about a surface that just covered the page.
- *
- * Withholding `role="dialog"` until there is a name would be the other way to
- * clear the rule, and it is worse: the panel traps focus either way, so a
- * listener would be moved into a region with no announcement that anything had
- * opened. A generic name is still a poor one, so it is paired with the dev-mode
- * warning `tnAccessibleName` raises.
- *
- * Exported so specs assert against it by name rather than by a copied literal.
- */
-declare const TN_SIDE_PANEL_DEFAULT_LABEL = "Side panel";
 /**
  * The name given to the scrolling content region once it becomes focusable
  * (#248).
@@ -13694,6 +13816,7 @@ declare class TnSidePanelComponent implements OnDestroy {
      * when there is one, the caller's IDREF otherwise.
      */
     protected resolvedAriaLabelledby: _angular_core.Signal<string | null>;
+    private readonly fallbackName;
     /**
      * The name to render as `aria-label`, or `null` to render none — and the
      * dev-mode warning when the panel has no name from any route.
@@ -15220,5 +15343,5 @@ declare const TN_THEME_DEFINITIONS: readonly TnThemeDefinition[];
  */
 declare const THEME_MAP: Map<TnTheme, TnThemeDefinition>;
 
-export { CommonShortcuts, DEFAULT_THEME, DiskIconComponent, DiskType, FileSizePipe, InputType, LIGHT_THEME, LabelMarkupPipe, LabelTextPipe, LinuxModifierKeys, LinuxShortcuts, ModifierKeys, QuickShortcuts, ShortcutBuilder, THEME_MAP, THEME_STORAGE_KEY, TN_AUTOCOMPLETE_DEFAULT_LABELS, TN_AUTOCOMPLETE_LABELS, TN_BRANDED_SPINNER_DEFAULT_LABEL, TN_CALENDAR_INTL, TN_CALENDAR_INTL_DEFAULTS, TN_DIALOG_CHROME_LABELS, TN_DIALOG_DEFAULT_CHROME_LABELS, TN_DIALOG_SHELL_DEFAULT_LABEL, TN_DRAWER_CONTENT_LABEL, TN_DRAWER_DEFAULT_LABEL, TN_FORM_FIELD_CONTEXT, TN_FORM_FIELD_DISMISSIBLE_ERRORS, TN_FORM_FIELD_ERRORS, TN_FORM_LIST_CONTEXT, TN_PARTICLE_PROGRESS_BAR_DEFAULT_LABEL, TN_PROGRESS_BAR_DEFAULT_LABEL, TN_RADIO_GROUP, TN_SELECT_DEFAULT_LABELS, TN_SELECT_LABELS, TN_SIDE_PANEL_CONTENT_LABEL, TN_SIDE_PANEL_DEFAULT_LABEL, TN_SIDE_PANEL_OVERFLOW_TOLERANCE_PX, TN_SPINNER_DEFAULT_LABEL, TN_STEPPER_STATUS_COMPLETED, TN_STEPPER_STATUS_ERROR, TN_TABLE_DEFAULT_LABELS, TN_TABLE_LABELS, TN_TABLE_PAGER_DEFAULT_LABELS, TN_TABLE_PAGER_LABELS, TN_TABLE_SCROLL_REGION_LABEL, TN_TAB_PANEL_CONTENT_LABEL, TN_TEST_ATTR, TN_THEME_DEFINITIONS, TN_TOAST_ANNOUNCE_DELAY_MS, TnAutocompleteComponent, TnAutocompleteHarness, TnBannerActionDirective, TnBannerActionHarness, TnBannerComponent, TnBannerHarness, TnBrandedSpinnerComponent, TnButtonComponent, TnButtonHarness, TnButtonToggleComponent, TnButtonToggleGroupComponent, TnButtonToggleGroupHarness, TnButtonToggleHarness, TnCalendarCellHarness, TnCalendarComponent, TnCalendarHarness, TnCalendarHeaderComponent, TnCardComponent, TnCardFooterActionsDirective, TnCardHeaderActionsDirective, TnCardHeaderDirective, TnCellDefDirective, TnCheckboxComponent, TnCheckboxHarness, TnCheckboxLabelDirective, TnChipComponent, TnChipHarness, TnChipInputComponent, TnChipInputHarness, TnConfirmDialogComponent, TnDateInputComponent, TnDateInputHarness, TnDateRangeInputComponent, TnDateRangeInputHarness, TnDetailRowDefDirective, TnDialog, TnDialogHarness, TnDialogShellComponent, TnDialogTesting, TnDividerComponent, TnDividerDirective, TnDrawerComponent, TnDrawerContainerComponent, TnDrawerContainerHarness, TnDrawerContentComponent, TnDrawerHarness, TnEmptyComponent, TnEmptyHarness, TnExpansionPanelComponent, TnExpansionPanelHarness, TnFileInputComponent, TnFileInputHarness, TnFilePickerComponent, TnFilePickerHarness, TnFilePickerPopupComponent, TnFormErrorsComponent, TnFormErrorsHarness, TnFormFieldComponent, TnFormFieldHarness, TnFormListComponent, TnFormListHarness, TnFormListItemComponent, TnFormListItemHarness, TnFormSectionComponent, TnFormSectionHarness, TnHeaderCellDefDirective, TnIconButtonComponent, TnIconButtonHarness, TnIconComponent, TnIconHarness, TnIconRegistryService, TnIconTesting, TnInputComponent, TnInputDirective, TnInputHarness, TnKeyboardShortcutComponent, TnKeyboardShortcutService, TnListAvatarDirective, TnListComponent, TnListIconDirective, TnListItemComponent, TnListItemLineDirective, TnListItemPrimaryDirective, TnListItemSecondaryDirective, TnListItemTitleDirective, TnListItemTrailingDirective, TnListOptionComponent, TnListSubheaderComponent, TnMenuActivateHoverDirective, TnMenuComponent, TnMenuHarness, TnMenuItemComponent, TnMenuTesting, TnMenuTriggerDirective, TnMonthViewComponent, TnMultiYearViewComponent, TnNestedTreeDataSource, TnNestedTreeNodeComponent, TnParticleProgressBarComponent, TnProgressBarComponent, TnRadioComponent, TnRadioGroupComponent, TnRadioGroupHarness, TnRadioHarness, TnRowActionsDefDirective, TnSelectComponent, TnSelectHarness, TnSelectionListComponent, TnSidePanelActionDirective, TnSidePanelComponent, TnSidePanelHarness, TnSidePanelHeaderActionDirective, TnSlideToggleComponent, TnSlideToggleHarness, TnSliderComponent, TnSliderThumbDirective, TnSliderWithLabelDirective, TnSpinnerComponent, TnSpriteLoaderService, TnStepComponent, TnStepperComponent, TnStepperHarness, TnStepperNextDirective, TnStepperPreviousDirective, TnTabComponent, TnTabHarness, TnTabPanelComponent, TnTabPanelHarness, TnTableColumnDirective, TnTableComponent, TnTableHarness, TnTablePagerComponent, TnTablePagerHarness, TnTableTesting, TnTabsComponent, TnTabsHarness, TnTestIdDirective, TnTheme, TnThemeService, TnTimeInputComponent, TnToastComponent, TnToastMock, TnToastPosition, TnToastRef, TnToastService, TnToastTesting, TnToastType, TnTooltipComponent, TnTooltipDirective, TnTooltipHarness, TnTooltipTesting, TnTreeComponent, TnTreeFlatDataSource, TnTreeFlattener, TnTreeHarness, TnTreeNodeComponent, TnTreeNodeHarness, TnTreeNodeOutletDirective, TnTreeVirtualScrollNodeOutletDirective, TnTreeVirtualScrollViewComponent, TnTreeVirtualScrollViewHarness, TruncatePathPipe, WindowsModifierKeys, WindowsShortcuts, allowsCurrentDirectorySelection, canonicalizeSize, composeTestId, controlTestId, createFlatTreeControl, createLucideLibrary, createNestedTreeControl, createShortcut, defaultSpriteBasePath, defaultSpriteConfigPath, defaultTreeItemSize, formatSize, formatSizeExact, formatSizeForEditing, getSelectableTypes, injectTnCalendarIntl, injectTnFormFieldAria, injectTnLabels, isPathWithinRoot, kebabTestSegment, labelMarkupToHtml, labelMarkupToText, libIconMarker, normalizeRootPath, optionTestId, parseLabelMarkup, parseSize, parseSizeParts, registerLucideIcons, resolveErrorMessage, scopeTestId, setupLucideIntegration, tnIconMarker, writeTestId };
-export type { AutocompleteHarnessFilters, BannerActionHarnessFilters, BannerHarnessFilters, ButtonHarnessFilters, ButtonToggleHarnessFilters, CalendarCell, CalendarCellFill, CalendarCellHarnessFilters, CalendarHarnessFilters, CheckboxHarnessFilters, ChipColor, ChipHarnessFilters, DateInputHarnessFilters, DateRange, DateRangeInputHarnessFilters, DialogHarnessFilters, EmptyHarnessFilters, ExpansionPanelHarnessFilters, FileInputHarnessFilters, FilePickerCallbacks, FilePickerCreateAction, FilePickerCreateActionEvent, FilePickerError, FilePickerHarnessFilters, FilePickerMode, FileSystemItem, FileSystemItemType, FlatTreeControlOptions, FormFieldHarnessFilters, FormSectionHarnessFilters, IconButtonHarnessFilters, IconHarnessFilters, IconLibrary, IconLibraryType, IconResult, IconSize, IconSource, IconTestingMockOverrides, InputHarnessFilters, KeyCombination, LabelMarkupSegment, LabelMarkupSegmentType, LabelType, LucideIconOptions, MenuHarnessFilters, MockIconRegistry, MockSpriteLoader, NestedTreeControlOptions, ParsedSize, PathSegment, PlatformType, ProgressBarMode, RadioGroupHarnessFilters, RadioHarnessFilters, ResolveErrorMessageOptions, ResolvedIcon, SelectHarnessFilters, ShortcutHandler, SidePanelHarnessFilters, SizeStandard, SlideToggleColor, SlideToggleHarnessFilters, SpinnerMode, SpriteConfig, StepperHarnessFilters, SubscriptSizing, TabChangeEvent, TabHarnessFilters, TabPanelHarnessFilters, TabsHarnessFilters, TnAutocompleteLabels, TnAutocompleteOption, TnBannerType, TnButtonToggleType, TnCalendarIntl, TnCalendarIntlInput, TnCalendarView, TnCardAction, TnCardControl, TnCardFooterLink, TnCardHeaderStatus, TnChipInputHarnessFilters, TnChipInputOption, TnConfirmDialogData, TnDialogChromeLabels, TnDialogDefaults, TnDialogOpenTarget, TnDrawerMode, TnDrawerPosition, TnEmptySize, TnFlatTreeNode, TnFormErrorsHarnessFilters, TnFormFieldAriaBindings, TnFormFieldContext, TnFormFieldErrorMessage, TnFormFieldErrorMessages, TnFormFieldErrorResolver, TnFormListContext, TnFormListHarnessFilters, TnFormListItemHarnessFilters, TnMenuItem, TnOptionTestIdSource, TnRadioGroupApi, TnRadioOption, TnSelectLabels, TnSelectOption, TnSelectOptionGroup, TnSelectionChange, TnSortEvent, TnTableDataProvider, TnTableDataSource, TnTableHarnessFilters, TnTableLabels, TnTableMobileLayout, TnTablePagerHarnessFilters, TnTablePagerLabels, TnTablePagination, TnTestAttrName, TnTestIdValue, TnThemeDefinition, TnToastCall, TnToastConfig, TnTreeExpansion, TnTreeHarnessFilters, TnTreeNodeHarnessFilters, TnTreeVirtualNodeData, TnTreeVirtualScrollViewHarnessFilters, TooltipHarnessFilters, TooltipPosition, YearCell };
+export { CommonShortcuts, DEFAULT_THEME, DiskIconComponent, DiskType, FileSizePipe, InputType, LIGHT_THEME, LabelMarkupPipe, LabelTextPipe, LinuxModifierKeys, LinuxShortcuts, ModifierKeys, QuickShortcuts, ShortcutBuilder, THEME_MAP, THEME_STORAGE_KEY, TN_AUTOCOMPLETE_DEFAULT_LABELS, TN_AUTOCOMPLETE_LABELS, TN_BRANDED_SPINNER_DEFAULT_LABEL, TN_CALENDAR_INTL, TN_CALENDAR_INTL_DEFAULTS, TN_DEFAULT_FALLBACK_LABELS, TN_DIALOG_CHROME_LABELS, TN_DIALOG_DEFAULT_CHROME_LABELS, TN_DIALOG_SHELL_DEFAULT_LABEL, TN_DRAWER_CONTENT_LABEL, TN_DRAWER_DEFAULT_LABEL, TN_FALLBACK_LABELS, TN_FORM_FIELD_CONTEXT, TN_FORM_FIELD_DISMISSIBLE_ERRORS, TN_FORM_FIELD_ERRORS, TN_FORM_LIST_CONTEXT, TN_PARTICLE_PROGRESS_BAR_DEFAULT_LABEL, TN_PROGRESS_BAR_DEFAULT_LABEL, TN_RADIO_GROUP, TN_SELECT_DEFAULT_LABELS, TN_SELECT_LABELS, TN_SIDE_PANEL_CONTENT_LABEL, TN_SIDE_PANEL_DEFAULT_LABEL, TN_SIDE_PANEL_OVERFLOW_TOLERANCE_PX, TN_SPINNER_DEFAULT_LABEL, TN_STEPPER_STATUS_COMPLETED, TN_STEPPER_STATUS_ERROR, TN_TABLE_DEFAULT_LABELS, TN_TABLE_LABELS, TN_TABLE_PAGER_DEFAULT_LABELS, TN_TABLE_PAGER_LABELS, TN_TABLE_SCROLL_REGION_LABEL, TN_TAB_PANEL_CONTENT_LABEL, TN_TEST_ATTR, TN_THEME_DEFINITIONS, TN_TOAST_ANNOUNCE_DELAY_MS, TnAutocompleteComponent, TnAutocompleteHarness, TnBannerActionDirective, TnBannerActionHarness, TnBannerComponent, TnBannerHarness, TnBrandedSpinnerComponent, TnButtonComponent, TnButtonHarness, TnButtonToggleComponent, TnButtonToggleGroupComponent, TnButtonToggleGroupHarness, TnButtonToggleHarness, TnCalendarCellHarness, TnCalendarComponent, TnCalendarHarness, TnCalendarHeaderComponent, TnCardComponent, TnCardFooterActionsDirective, TnCardHeaderActionsDirective, TnCardHeaderDirective, TnCellDefDirective, TnCheckboxComponent, TnCheckboxHarness, TnCheckboxLabelDirective, TnChipComponent, TnChipHarness, TnChipInputComponent, TnChipInputHarness, TnConfirmDialogComponent, TnDateInputComponent, TnDateInputHarness, TnDateRangeInputComponent, TnDateRangeInputHarness, TnDetailRowDefDirective, TnDialog, TnDialogHarness, TnDialogShellComponent, TnDialogTesting, TnDividerComponent, TnDividerDirective, TnDrawerComponent, TnDrawerContainerComponent, TnDrawerContainerHarness, TnDrawerContentComponent, TnDrawerHarness, TnEmptyComponent, TnEmptyHarness, TnExpansionPanelComponent, TnExpansionPanelHarness, TnFileInputComponent, TnFileInputHarness, TnFilePickerComponent, TnFilePickerHarness, TnFilePickerPopupComponent, TnFormErrorsComponent, TnFormErrorsHarness, TnFormFieldComponent, TnFormFieldHarness, TnFormListComponent, TnFormListHarness, TnFormListItemComponent, TnFormListItemHarness, TnFormSectionComponent, TnFormSectionHarness, TnHeaderCellDefDirective, TnIconButtonComponent, TnIconButtonHarness, TnIconComponent, TnIconHarness, TnIconRegistryService, TnIconTesting, TnInputComponent, TnInputDirective, TnInputHarness, TnKeyboardShortcutComponent, TnKeyboardShortcutService, TnListAvatarDirective, TnListComponent, TnListIconDirective, TnListItemComponent, TnListItemLineDirective, TnListItemPrimaryDirective, TnListItemSecondaryDirective, TnListItemTitleDirective, TnListItemTrailingDirective, TnListOptionComponent, TnListSubheaderComponent, TnMenuActivateHoverDirective, TnMenuComponent, TnMenuHarness, TnMenuItemComponent, TnMenuTesting, TnMenuTriggerDirective, TnMonthViewComponent, TnMultiYearViewComponent, TnNestedTreeDataSource, TnNestedTreeNodeComponent, TnParticleProgressBarComponent, TnProgressBarComponent, TnRadioComponent, TnRadioGroupComponent, TnRadioGroupHarness, TnRadioHarness, TnRowActionsDefDirective, TnSelectComponent, TnSelectHarness, TnSelectionListComponent, TnSidePanelActionDirective, TnSidePanelComponent, TnSidePanelHarness, TnSidePanelHeaderActionDirective, TnSlideToggleComponent, TnSlideToggleHarness, TnSliderComponent, TnSliderThumbDirective, TnSliderWithLabelDirective, TnSpinnerComponent, TnSpriteLoaderService, TnStepComponent, TnStepperComponent, TnStepperHarness, TnStepperNextDirective, TnStepperPreviousDirective, TnTabComponent, TnTabHarness, TnTabPanelComponent, TnTabPanelHarness, TnTableColumnDirective, TnTableComponent, TnTableHarness, TnTablePagerComponent, TnTablePagerHarness, TnTableTesting, TnTabsComponent, TnTabsHarness, TnTestIdDirective, TnTheme, TnThemeService, TnTimeInputComponent, TnToastComponent, TnToastMock, TnToastPosition, TnToastRef, TnToastService, TnToastTesting, TnToastType, TnTooltipComponent, TnTooltipDirective, TnTooltipHarness, TnTooltipTesting, TnTreeComponent, TnTreeFlatDataSource, TnTreeFlattener, TnTreeHarness, TnTreeNodeComponent, TnTreeNodeHarness, TnTreeNodeOutletDirective, TnTreeVirtualScrollNodeOutletDirective, TnTreeVirtualScrollViewComponent, TnTreeVirtualScrollViewHarness, TruncatePathPipe, WindowsModifierKeys, WindowsShortcuts, allowsCurrentDirectorySelection, canonicalizeSize, composeTestId, controlTestId, createFlatTreeControl, createLucideLibrary, createNestedTreeControl, createShortcut, defaultSpriteBasePath, defaultSpriteConfigPath, defaultTreeItemSize, formatSize, formatSizeExact, formatSizeForEditing, getSelectableTypes, injectTnCalendarIntl, injectTnFallbackName, injectTnFormFieldAria, injectTnLabels, isPathWithinRoot, kebabTestSegment, labelMarkupToHtml, labelMarkupToText, libIconMarker, normalizeRootPath, optionTestId, parseLabelMarkup, parseSize, parseSizeParts, registerLucideIcons, resolveErrorMessage, scopeTestId, setupLucideIntegration, tnIconMarker, writeTestId };
+export type { AutocompleteHarnessFilters, BannerActionHarnessFilters, BannerHarnessFilters, ButtonHarnessFilters, ButtonToggleHarnessFilters, CalendarCell, CalendarCellFill, CalendarCellHarnessFilters, CalendarHarnessFilters, CheckboxHarnessFilters, ChipColor, ChipHarnessFilters, DateInputHarnessFilters, DateRange, DateRangeInputHarnessFilters, DialogHarnessFilters, EmptyHarnessFilters, ExpansionPanelHarnessFilters, FileInputHarnessFilters, FilePickerCallbacks, FilePickerCreateAction, FilePickerCreateActionEvent, FilePickerError, FilePickerHarnessFilters, FilePickerMode, FileSystemItem, FileSystemItemType, FlatTreeControlOptions, FormFieldHarnessFilters, FormSectionHarnessFilters, IconButtonHarnessFilters, IconHarnessFilters, IconLibrary, IconLibraryType, IconResult, IconSize, IconSource, IconTestingMockOverrides, InputHarnessFilters, KeyCombination, LabelMarkupSegment, LabelMarkupSegmentType, LabelType, LucideIconOptions, MenuHarnessFilters, MockIconRegistry, MockSpriteLoader, NestedTreeControlOptions, ParsedSize, PathSegment, PlatformType, ProgressBarMode, RadioGroupHarnessFilters, RadioHarnessFilters, ResolveErrorMessageOptions, ResolvedIcon, SelectHarnessFilters, ShortcutHandler, SidePanelHarnessFilters, SizeStandard, SlideToggleColor, SlideToggleHarnessFilters, SpinnerMode, SpriteConfig, StepperHarnessFilters, SubscriptSizing, TabChangeEvent, TabHarnessFilters, TabPanelHarnessFilters, TabsHarnessFilters, TnAutocompleteLabels, TnAutocompleteOption, TnBannerType, TnButtonToggleType, TnCalendarIntl, TnCalendarIntlInput, TnCalendarView, TnCardAction, TnCardControl, TnCardFooterLink, TnCardHeaderStatus, TnChipInputHarnessFilters, TnChipInputOption, TnConfirmDialogData, TnDialogChromeLabels, TnDialogDefaults, TnDialogOpenTarget, TnDrawerMode, TnDrawerPosition, TnEmptySize, TnFallbackLabels, TnFallbackName, TnFlatTreeNode, TnFormErrorsHarnessFilters, TnFormFieldAriaBindings, TnFormFieldContext, TnFormFieldErrorMessage, TnFormFieldErrorMessages, TnFormFieldErrorResolver, TnFormListContext, TnFormListHarnessFilters, TnFormListItemHarnessFilters, TnMenuItem, TnOptionTestIdSource, TnRadioGroupApi, TnRadioOption, TnSelectLabels, TnSelectOption, TnSelectOptionGroup, TnSelectionChange, TnSortEvent, TnTableDataProvider, TnTableDataSource, TnTableHarnessFilters, TnTableLabels, TnTableMobileLayout, TnTablePagerHarnessFilters, TnTablePagerLabels, TnTablePagination, TnTestAttrName, TnTestIdValue, TnThemeDefinition, TnToastCall, TnToastConfig, TnTreeExpansion, TnTreeHarnessFilters, TnTreeNodeHarnessFilters, TnTreeVirtualNodeData, TnTreeVirtualScrollViewHarnessFilters, TooltipHarnessFilters, TooltipPosition, YearCell };