@truenas/ui-components 0.7.0 → 0.7.2

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.
@@ -4723,6 +4704,294 @@ interface CheckboxHarnessFilters extends BaseHarnessFilters {
     testId?: string;
 }
 
+/** One option of a `tn-checkbox-group`, rendered as a single `tn-checkbox`. */
+interface TnCheckboxOption<T = unknown> {
+    value: T;
+    label: string;
+    disabled?: boolean;
+}
+/**
+ * A `role="group"` wrapper that owns the selection for a set of `tn-checkbox`es, as one control
+ * whose value is the ARRAY of checked option values.
+ *
+ * `tn-checkbox` is a boolean `ControlValueAccessor` — one control per box. A multi-select field
+ * ("which USB devices to pass through", "which catalog trains to offer") has a single
+ * array-valued control instead, and nothing in the library spoke that shape: consumers either
+ * exploded it into one boolean control per option and reassembled the array by hand on submit, or
+ * kept a bespoke component outside the library. This is that shape, with the same
+ * `options`/`compareWith`/`testId` surface as {@link TnRadioGroupComponent} so the single-select
+ * and multi-select forms of the same field read alike.
+ *
+ * ```html
+ * <tn-form-field label="USB Devices" tooltip="Devices to pass through to the container">
+ *   <tn-checkbox-group formControlName="usb_devices" [options]="usbOptions" />
+ * </tn-form-field>
+ * ```
+ *
+ * Inside a `tn-form-field` the group is a normal control: the field names it via
+ * `aria-labelledby`, infers the required indicator from its validators, and renders its validation
+ * message — none of which a loose pile of checkboxes gets.
+ *
+ * Options come from the `options` input only. Unlike `tn-radio`, `tn-checkbox` is not group-aware,
+ * so a projected child would render as an independent boolean control that silently ignores the
+ * group's value; the group therefore projects nothing rather than accepting content it cannot
+ * drive.
+ */
+declare class TnCheckboxGroupComponent<T = unknown> implements ControlValueAccessor {
+    /**
+     * Options to render, one checkbox each.
+     *
+     * Options are tracked by `value`, so object values must be referentially stable — rebuilding
+     * them as fresh literals on every change detection pass re-creates the whole list. Same
+     * requirement the `compareWith` case implies; hold the objects in a field.
+     */
+    options: _angular_core.InputSignal<TnCheckboxOption<T>[]>;
+    /**
+     * Lays the options out in a wrapping row of equal columns instead of stacking them. Column width
+     * comes from `--tn-checkbox-group-inline-basis` (default `50%`), and collapses to one column on
+     * a narrow viewport.
+     */
+    inline: _angular_core.InputSignal<boolean>;
+    /**
+     * Explicit accessible name for the group. Inside a `tn-form-field` with a label this is
+     * unnecessary — the field names the group automatically — but a group with neither is announced
+     * as an unlabeled group.
+     *
+     * A required group appends "required" to whatever this says, since that is the only channel
+     * `role="group"` leaves open for it — see the `required` input.
+     */
+    ariaLabel: _angular_core.InputSignal<string | undefined>;
+    disabled: _angular_core.InputSignal<boolean>;
+    /**
+     * Whether the group announces itself as required.
+     *
+     * Deliberately NOT propagated to the options' native `required`, which is the opposite of the
+     * choice `tn-radio-group` makes — and the difference is in the HTML, not in taste. A required
+     * radio is satisfied by any one option in the `name` group; a required checkbox is satisfied
+     * only by ITSELF being checked, so propagating it here would have the browser demand every box.
+     * "At least one" is a validator's job.
+     *
+     * Nor does it become `aria-required`, which is the OTHER place `tn-radio-group` cannot be
+     * copied: WAI-ARIA 1.2 supports only the globals plus `aria-activedescendant`/`aria-disabled`
+     * on `role="group"`, so an `aria-required` there is dropped by assistive tech and flagged by
+     * axe, whereas `role="radiogroup"` genuinely supports it. The state instead rides in the
+     * group's accessible NAME, as a "required" suffix — see {@link labelledBy}.
+     */
+    required: _angular_core.InputSignal<boolean>;
+    /**
+     * Test-id base for the group and, scoped by the option label, for every option: base
+     * `usb_devices` yields `checkbox-group-usb-devices` on the group and
+     * `checkbox-usb-devices-web-cam` on its options. Falls back to the bound control name.
+     */
+    testId: _angular_core.InputSignal<TnTestIdValue>;
+    /**
+     * Custom comparator for matching option values against the selected ones. Provide it when option
+     * values are objects — the default is identity, so a structurally-equal-but-distinct object
+     * would leave the group rendering nothing as checked.
+     *
+     * Called with an option value on the right and a currently-selected value on the left, and must
+     * tolerate `null`/`undefined` on either side rather than dereferencing straight into a property.
+     *
+     * @example
+     * ```ts
+     * compareWith = (a, b) => a?.id === b?.id;
+     * ```
+     */
+    compareWith: _angular_core.InputSignal<((a: T | null, b: T | null) => boolean) | undefined>;
+    /** Emits the new value array on every user toggle (not on programmatic writes). */
+    change: _angular_core.OutputEmitterRef<T[]>;
+    /**
+     * ARIA wiring from an enclosing `tn-form-field` (label, error/hint, invalid, required).
+     * All-null standalone, or when `ariaLabel` overrides the field's label.
+     */
+    protected readonly fieldAria: _truenas_ui_components.TnFormFieldAriaBindings;
+    /** Test-id base, falling back to the bound control name when `testId` is unset. */
+    protected readonly resolvedTestId: _angular_core.Signal<TnTestIdValue>;
+    private readonly selectedValues;
+    private readonly formDisabled;
+    /**
+     * Combined disabled state (own input plus a disabled bound control). The native `disabled` on
+     * each option is what blocks interaction; `aria-disabled` on the group is what tells a screen
+     * reader landing on the container about it, and gives styling a hook for the group as a whole.
+     */
+    readonly isDisabled: _angular_core.Signal<boolean>;
+    /** Whether the group announces itself as required: its own input, or the field's inferred state. */
+    protected readonly ariaRequired: _angular_core.Signal<boolean>;
+    /** Id of the visually hidden "required" text this group contributes to its own name. */
+    protected readonly requiredTextId: string;
+    /**
+     * `aria-label` for the group: the `ariaLabel` input with the required-ness folded in, since
+     * `role="group"` gives it nowhere else to go (see the `required` input).
+     */
+    protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
+    /**
+     * `aria-labelledby` for the group: the enclosing field's label, plus this group's own hidden
+     * "required" text when required. A multi-id `aria-labelledby` concatenates, so the field keeps
+     * naming the group and the required-ness reaches a screen reader as part of that name.
+     *
+     * Null when the name comes from `ariaLabel` instead — that path carries the suffix itself,
+     * because `aria-labelledby` would otherwise win over the very label it is meant to extend.
+     */
+    protected readonly labelledBy: _angular_core.Signal<string | null>;
+    private onChange;
+    private onTouched;
+    /** Whether `value` is among the currently selected values. */
+    protected isSelected(value: T): boolean;
+    /**
+     * Adds or removes an option's value.
+     *
+     * The emitted array is rebuilt in `options` order rather than appended to in click order, so the
+     * value a given set of checked boxes produces is the same however the user got there — which is
+     * what makes a payload diff (and a spec asserting one) stable.
+     *
+     * Ordering is all the rebuild changes: an already-selected value is re-emitted as the object the
+     * consumer wrote, not as the equal-under-`compareWith` object the option holds. A control loaded
+     * with `{ id: 2, name: 'usb-cam' }` against an option of `{ id: 2 }` keeps its `name` when an
+     * unrelated box is toggled; only a newly checked option contributes the option's own value.
+     */
+    protected toggle(value: T, checked: boolean): void;
+    private matches;
+    writeValue(value: T[] | null | undefined): void;
+    registerOnChange(fn: (value: T[]) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    /**
+     * Marks the control touched when focus leaves the group. `focusout` also fires while moving
+     * between the group's own options, which is harmless — the user has interacted either way — and
+     * it is the only blur signal available, since a checkbox's blur does not bubble.
+     */
+    protected onFocusOut(): void;
+    /** Per-option test-id segments: the group's base scoped by the option label. */
+    protected optionTestId(option: TnCheckboxOption<T>): TnTestIdValue;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnCheckboxGroupComponent<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnCheckboxGroupComponent<any>, "tn-checkbox-group", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "inline": { "alias": "inline"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; }, { "change": "change"; }, never, never, true, never>;
+}
+
+/**
+ * Harness for interacting with `tn-checkbox-group` in tests.
+ * Drives the group as a whole — reading the checked set, replacing it wholesale, toggling one
+ * option by label — rather than reaching for each `tn-checkbox` individually.
+ *
+ * @example
+ * ```typescript
+ * const group = await loader.getHarness(TnCheckboxGroupHarness.with({ testId: 'checkbox-group-trains' }));
+ * // Labels, not option values — the DOM only carries what the user can read.
+ * await group.setValue(['Stable', 'Enterprise']);
+ * expect(await group.getValue()).toEqual(['Stable', 'Enterprise']);
+ * ```
+ */
+declare class TnCheckboxGroupHarness extends ComponentHarness {
+    /** The selector for the host element of a `TnCheckboxGroupComponent` instance. */
+    static hostSelector: string;
+    private _root;
+    private _checkboxes;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a checkbox group with specific
+     * attributes.
+     *
+     * @param options Options for filtering which checkbox group instances are considered a match.
+     * @returns A `HarnessPredicate` configured with the given options.
+     *
+     * @example
+     * ```typescript
+     * // Find by accessible name
+     * const group = await loader.getHarness(TnCheckboxGroupHarness.with({ ariaLabel: 'USB Devices' }));
+     *
+     * // Find by testId
+     * const group = await loader.getHarness(TnCheckboxGroupHarness.with({ testId: 'checkbox-group-usb-devices' }));
+     * ```
+     */
+    static with(options?: CheckboxGroupHarnessFilters): HarnessPredicate<TnCheckboxGroupHarness>;
+    /**
+     * Gets the harnesses for the group's options, in DOM order.
+     *
+     * @example
+     * ```typescript
+     * const options = await group.getOptions();
+     * expect(options).toHaveLength(3);
+     * ```
+     */
+    getOptions(): Promise<TnCheckboxHarness[]>;
+    /**
+     * Gets the label text of every option, in DOM order.
+     *
+     * @example
+     * ```typescript
+     * expect(await group.getOptionLabels()).toEqual(['Stable', 'Enterprise']);
+     * ```
+     */
+    getOptionLabels(): Promise<string[]>;
+    /**
+     * Gets the labels of the currently checked options, in DOM order.
+     *
+     * Labels rather than values, because the values live in the bound control and the DOM only ever
+     * carries what the user can read.
+     *
+     * @example
+     * ```typescript
+     * expect(await group.getValue()).toEqual(['Stable']);
+     * ```
+     */
+    getValue(): Promise<string[]>;
+    /**
+     * Makes the checked set exactly the options with the given labels — checking the ones listed and
+     * unchecking every other.
+     *
+     * @param labels Label text of the options that should end up checked.
+     *
+     * @example
+     * ```typescript
+     * await group.setValue(['Stable']);
+     * ```
+     */
+    setValue(labels: string[]): Promise<void>;
+    /**
+     * Toggles the option with the given label. Throws when the group has no such option, so a
+     * renamed or missing option fails loudly instead of silently leaving the selection unchanged.
+     *
+     * @param label Label text of the option to toggle.
+     *
+     * @example
+     * ```typescript
+     * await group.toggle('Enterprise');
+     * ```
+     */
+    toggle(label: string): Promise<void>;
+    /**
+     * Checks whether every option is disabled — the state a disabled group or a disabled bound form
+     * control produces. Use {@link getOptions} to inspect a single per-option `disabled`.
+     *
+     * @example
+     * ```typescript
+     * expect(await group.isDisabled()).toBe(true);
+     * ```
+     */
+    isDisabled(): Promise<boolean>;
+    /**
+     * Gets the group's accessible name as written by the `ariaLabel` input, or null when the name
+     * comes from an enclosing `tn-form-field` (see {@link getAriaLabelledBy}).
+     */
+    getAriaLabel(): Promise<string | null>;
+    /** Gets the id the group's accessible name is delegated to, or null. */
+    getAriaLabelledBy(): Promise<string | null>;
+    /**
+     * Gets the test ID attribute value of the group root.
+     *
+     * @example
+     * ```typescript
+     * expect(await group.getTestId()).toBe('checkbox-group-trains');
+     * ```
+     */
+    getTestId(): Promise<string | null>;
+}
+/** A set of criteria that can be used to filter a list of `TnCheckboxGroupHarness` instances. */
+interface CheckboxGroupHarnessFilters extends BaseHarnessFilters {
+    /** Filters by the group's `aria-label`. Supports string or regex matching. */
+    ariaLabel?: string | RegExp;
+    /** Filters by the resolved test-id attribute on the group root. */
+    testId?: string;
+}
+
 declare class TnRadioComponent implements AfterViewInit, OnDestroy, ControlValueAccessor {
     radioEl: _angular_core.Signal<ElementRef<HTMLInputElement>>;
     label: _angular_core.InputSignal<string>;
@@ -11029,21 +11298,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>;
@@ -11051,6 +11535,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.
@@ -11072,23 +11557,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.
@@ -11120,30 +11592,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.
@@ -11177,19 +11632,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
  * ------------------------------------------------------------------
@@ -11249,6 +11691,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.
@@ -13156,27 +13599,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. */
@@ -13276,6 +13698,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.
@@ -13493,25 +13916,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).
@@ -13700,6 +14104,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.
@@ -15226,5 +15631,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, TnCheckboxGroupComponent, TnCheckboxGroupHarness, 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, CheckboxGroupHarnessFilters, 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, TnCheckboxOption, 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 };