@cdevhub/ngx-tw 0.4.0 → 0.6.0

package/types/cdevhub-ngx-tw-file-upload-testing.d.ts

@@ -0,0 +1,120 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Filters accepted by `FileUploadFileHarness.with`. */
+interface FileUploadFileHarnessFilters extends BaseHarnessFilters {
+    /** Match by the attached file's name. */
+    name?: string | RegExp;
+}
+/**
+ * Harness for a single attached file in a `tw-file-upload`'s list.
+ *
+ * Reach these through {@link FileUploadHarness.getFiles}.
+ *
+ * Everything here reads the *default* row rendering. A consumer who projects a
+ * `*twFileUploadItem` template replaces the row wholesale — including the
+ * remove control this harness drives — so {@link getName} and {@link remove}
+ * apply only to the built-in row.
+ */
+declare class FileUploadFileHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly removeButton;
+    /** Predicate for `locatorFor` / `locatorForAll`. */
+    static with(options?: FileUploadFileHarnessFilters): HarnessPredicate<FileUploadFileHarness>;
+    /**
+     * The attached file's name, read from the remove control's accessible name
+     * (`Remove <name>`). That is the one place the name is exposed through an
+     * accessibility contract rather than through presentational markup.
+     */
+    getName(): Promise<string>;
+    /**
+     * The row's full rendered text, whitespace-collapsed.
+     *
+     * The name and the meta line sit in adjacent `<span>`s with only a
+     * whitespace-only text node between them, which Angular strips, so they run
+     * together here (`notes.txt10 B`). Prefer {@link getName} and
+     * {@link getMetaText} for the parts; this is the raw read that still says
+     * something about a row rendered from a projected template.
+     */
+    getText(): Promise<string>;
+    /**
+     * The row's meta line — the formatted size, plus the status and error text
+     * once the item leaves `pending` (`10 B`, `10 B · Uploading`,
+     * `10 B · Failed — <error>`).
+     *
+     * This string is the only place per-item status and error surface in the
+     * DOM: there is no `data-status` hook, and the status otherwise shows up
+     * only in Tailwind classes, which a harness must not read. Derived by
+     * subtracting {@link getName} from {@link getText} for the same reason.
+     */
+    getMetaText(): Promise<string>;
+    /**
+     * Clicks the row's remove control.
+     *
+     * The component retargets focus in an `afterNextRender` — deliberately, so
+     * that the list has re-rendered before focus moves — so the focus assertion
+     * a caller makes after this resolves is the post-render one.
+     */
+    remove(): Promise<void>;
+}
+
+/** Filters accepted by `FileUploadHarness.with`. */
+interface FileUploadHarnessFilters extends BaseHarnessFilters {
+    /** Match by the control's accessible name (its `aria-label`). */
+    label?: string | RegExp;
+    /** Match disabled / enabled controls. */
+    disabled?: boolean;
+}
+/**
+ * Harness for `tw-file-upload`.
+ *
+ * ## What this harness deliberately cannot do
+ *
+ * It cannot attach a file. Selecting a file means populating
+ * `HTMLInputElement.files`, which is read-only to script and which CDK's
+ * `TestElement` — the whole reason a harness runs unchanged against a real
+ * browser — has no operation for. The only way to do it is
+ * `Object.defineProperty` on the raw DOM node, which exists solely in the
+ * Testbed environment. Exposing that would make the harness silently
+ * unusable in every other environment, so attaching stays the caller's job:
+ * seed files through the bound form control (`writeValue` takes a `File[]`),
+ * or through the component's own API, and use this harness for everything
+ * downstream of the attachment.
+ *
+ * Nothing here needs a CDK overlay, so the ordinary fixture loader is enough.
+ *
+ * Note where the ARIA lives: the host is a `role="group"`, which ARIA 1.2 does
+ * not allow to carry `aria-required` / `aria-invalid`, so both sit on the
+ * hidden `<input type="file">` — the element that actually owns the value.
+ * {@link isRequired} and {@link isInvalid} read them from there;
+ * {@link isDisabled} reads `aria-disabled` from the group, which is allowed.
+ */
+declare class FileUploadHarness extends ComponentHarness {
+    static hostSelector: string;
+    /** The hidden native control. It carries the value-owning ARIA and state. */
+    private readonly nativeInput;
+    /** Predicate for `locatorFor` / `locatorForAll`. */
+    static with(options?: FileUploadHarnessFilters): HarnessPredicate<FileUploadHarness>;
+    /** The control's accessible name, from `aria-label` when one is set. */
+    getLabel(): Promise<string | null>;
+    /** Whether the group reports `aria-disabled="true"`. */
+    isDisabled(): Promise<boolean>;
+    /** Whether the native file input is marked required. */
+    isRequired(): Promise<boolean>;
+    /** Whether the native file input reports `aria-invalid="true"`. */
+    isInvalid(): Promise<boolean>;
+    /**
+     * Every attached file, in list order. Returns `[]` when nothing is attached
+     * — the list element is always rendered, just empty.
+     */
+    getFiles(filters?: FileUploadFileHarnessFilters): Promise<FileUploadFileHarness[]>;
+    /** The name of every attached file, in list order. */
+    getFileNames(): Promise<string[]>;
+    /**
+     * Removes the first attached file whose name matches. Throws when nothing
+     * matches, rather than failing silently.
+     */
+    removeFile(name: string | RegExp): Promise<void>;
+}
+
+export { FileUploadFileHarness, FileUploadHarness };
+export type { FileUploadFileHarnessFilters, FileUploadHarnessFilters };

package/types/cdevhub-ngx-tw-file-upload.d.ts

@@ -65,17 +65,17 @@ declare class FileUploadComponent extends FormFieldControl<File[]> implements Co
     readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Marks the control as required. Mirrors to `aria-required`. Also inferred from `Validators.required` on a bound `NgControl`. Defaults to `false`. */
     readonly requiredInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Headline text rendered inside the drop zone (e.g., `'Drag files here'`). Projected `[twFileUploadHeadline]` content takes precedence over this input. */
+    /** Headline text rendered inside the drop zone (e.g., `'Drag files here'`). Projected `[twFileUploadHeadline]` content takes precedence over this input. Defaults to `undefined`. */
     readonly label: _angular_core.InputSignal<string | undefined>;
-    /** Secondary text rendered under the label (e.g., `'PDF up to 10MB'`). Projected `[twFileUploadDescription]` content takes precedence. */
+    /** Secondary text rendered under the label (e.g., `'PDF up to 10MB'`). Projected `[twFileUploadDescription]` content takes precedence. Defaults to `undefined`. */
     readonly description: _angular_core.InputSignal<string | undefined>;
     /** Label rendered inside the trigger button. Defaults to `'Choose files'`. Use `'Choose file'` when `multiple` is `false` (consumer responsibility). */
     readonly triggerLabel: _angular_core.InputSignal<string>;
-    /** Accessible name applied to the host when no visible label is projected. Mirrored to `aria-label`. */
+    /** Accessible name applied to the host when no visible label is projected. Mirrored to `aria-label`. Defaults to `undefined`. */
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
-    /** ID of an external element that labels the control. Mirrored to `aria-labelledby`. */
+    /** ID of an external element that labels the control. Mirrored to `aria-labelledby`. Defaults to `undefined`. */
     readonly ariaLabelledby: _angular_core.InputSignal<string | undefined>;
-    /** ID of an external element that describes the control. Form-field merges its hint/error ids alongside. */
+    /** ID of an external element that describes the control. Form-field merges its hint/error ids alongside. Defaults to `undefined`. Alias: `aria-describedby`. */
     readonly ariaDescribedby: _angular_core.InputSignal<string | undefined>;
     /** Optional `name` attribute on the hidden `<input type="file">` for native form submissions. */
     readonly name: _angular_core.InputSignal<string | undefined>;
@@ -92,20 +92,18 @@ declare class FileUploadComponent extends FormFieldControl<File[]> implements Co
     /** Fires when all files are cleared at once via programmatic `clear()`. Does not fire on `writeValue`, even when the new value is empty. */
     readonly cleared: _angular_core.OutputEmitterRef<void>;
     private readonly elementRef;
+    private readonly injector;
     private readonly focusMonitor;
     private readonly liveAnnouncer;
     private readonly destroyRef;
     private readonly ngControl;
-    private readonly parentForm;
-    private readonly parentFormGroup;
-    private readonly defaultMatcher;
     private readonly itemsSignal;
     private readonly cvaDisabled;
     private readonly isDraggingSignal;
     private readonly dragHasInvalidFilesSignal;
     private readonly _focused;
-    private readonly _ngControlRev;
-    private readonly _formSubmitRev;
+    /** @internal Shared `errorState` / `required` / `errors` derivation — see `wireErrorState`. */
+    private readonly errorWiring;
     private readonly describedByIdsSignal;
     private readonly labelledByIdsSignal;
     private dragCounter;

package/types/cdevhub-ngx-tw-flip-card.d.ts

@@ -1,7 +1,13 @@
 import * as _angular_core from '@angular/core';
 
 /** Visual style of the flip card chrome. Mirrors `tw-card`. */
-type FlipCardVariant = 'outlined' | 'elevated' | 'ghost';
+type FlipCardVariant = 'outline' | 'elevated' | 'ghost' | FlipCardVariantLegacy;
+/**
+ * Legacy `variant` spellings, kept so existing templates keep compiling.
+ * @deprecated `'outlined'` is an alias for `'outline'` and renders identically.
+ * It will be removed in the next major — prefer `'outline'`.
+ */
+type FlipCardVariantLegacy = 'outlined';
 /** Axis of rotation for the flip animation. */
 type FlipCardDirection = 'horizontal' | 'vertical';
 /** Which user interaction flips the card. */
@@ -22,8 +28,9 @@ type FlipCardTrigger = 'hover' | 'click' | 'manual' | 'both';
 declare class FlipCardComponent {
     /**
      * Visual style of the card chrome. Mirrors `tw-card`'s variant vocabulary.
-     * Defaults to `'outlined'` (vs `tw-card`'s `'elevated'` default) so the flip
+     * Defaults to `'outline'` (vs `tw-card`'s `'elevated'` default) so the flip
      * animation reads more clearly without a baseline shadow underneath.
+     * `'outlined'` is a deprecated alias for `'outline'` and renders identically.
      */
     readonly variant: _angular_core.InputSignal<FlipCardVariant>;
     /** Axis of rotation. `'horizontal'` rotates around the Y axis (left/right flip); `'vertical'` rotates around the X axis (top/bottom flip). Defaults to `'horizontal'`. */
@@ -35,12 +42,12 @@ declare class FlipCardComponent {
     /** Whether the back face is currently visible. Two-way bindable via `[(flipped)]`. Defaults to `false`. The `flippedChange` event fires on every toggle. */
     readonly flipped: _angular_core.ModelSignal<boolean>;
     /**
-     * Accessible name for the host element. Required when `trigger` is
-     * `'manual'` (the host renders as `role="region"`, which AXE requires to
-     * have an accessible name); a default of `'Flip card'` is used in that
-     * mode if no value is provided. In interactive modes the host's accessible
-     * name is normally derived from the visible face's content — set this
-     * input to override.
+     * Accessible name for the host element, mirrored to `aria-label`. Required
+     * when `trigger` is `'manual'` (the host renders as `role="region"`, which
+     * AXE requires to have an accessible name); a default of `'Flip card'` is
+     * used in that mode if no value is provided. In interactive modes the host's
+     * accessible name is normally derived from the visible face's content — set
+     * this input to override. Defaults to `undefined`.
      */
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     private readonly liveAnnouncer;
@@ -58,8 +65,6 @@ declare class FlipCardComponent {
     /** @internal */
     readonly ariaPressed: _angular_core.Signal<string | null>;
     /** @internal */
-    readonly ariaLive: _angular_core.Signal<"polite" | null>;
-    /** @internal */
     readonly ariaDisabled: _angular_core.Signal<"true" | null>;
     /** @internal */
     readonly hostAriaLabel: _angular_core.Signal<string | null>;
@@ -71,6 +76,8 @@ declare class FlipCardComponent {
     readonly frontInert: _angular_core.Signal<"" | null>;
     /** @internal */
     readonly backInert: _angular_core.Signal<"" | null>;
+    /** @internal Canonical variant with legacy spellings folded in. */
+    private readonly resolvedVariant;
     private readonly variantResult;
     readonly rootClasses: _angular_core.Signal<string>;
     readonly innerClasses: _angular_core.Signal<string>;
@@ -88,7 +95,7 @@ declare class FlipCardComponent {
     private toggle;
     private setFlipped;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FlipCardComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FlipCardComponent, "tw-flip-card", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "direction": { "alias": "direction"; "required": false; "isSignal": true; }; "trigger": { "alias": "trigger"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "flipped": { "alias": "flipped"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "flipped": "flippedChange"; }, never, ["[slot='front']", "[slot='back']"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FlipCardComponent, "tw-flip-card", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "direction": { "alias": "direction"; "required": false; "isSignal": true; }; "trigger": { "alias": "trigger"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "flipped": { "alias": "flipped"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; }, { "flipped": "flippedChange"; }, never, ["[slot='front']", "[slot='back']"], true, never>;
 }
 
 export { FlipCardComponent };

package/types/cdevhub-ngx-tw-form-field.d.ts

@@ -28,7 +28,24 @@ declare abstract class FormFieldControl<T = unknown> {
     abstract readonly required: Signal<boolean>;
     /** Whether the control should be rendered as invalid. Usually derived from `NgControl.invalid` combined with `touched`/`submitted`. */
     abstract readonly errorState: Signal<boolean>;
-    /** Active validation errors map keyed by validator name (e.g. `{ required: true, email: true }`). Returns `null` when the control has no validation errors. Drives `[twError match="…"]` filtering inside the form-field. Optional — controls without a backing `NgControl` may omit it. */
+    /**
+     * Active validation errors map keyed by validator name (e.g. `{ required: true, email: true }`).
+     * Returns `null` when the control has no validation errors.
+     *
+     * This is the *only* source the form-field consults for `[twError match="…"]` filtering: it
+     * feeds `FormFieldComponent.activeErrorKeys`, and an error with a `match` renders only while
+     * that key is present. A control that leaves this undefined therefore reports an empty key set,
+     * and **every `match`-targeted message under it is permanently hidden** — in all three form
+     * strategies, with no warning. Unmatched `[twError]` messages are unaffected; they follow
+     * `errorState` alone.
+     *
+     * Optional only so the member can be added to existing controls without a breaking change. Any
+     * control that resolves an `NgControl` should implement it — typically as
+     * `computed(() => ngControl?.control?.errors ?? null)`, reading whatever revision signal the
+     * control already uses to invalidate `errorState`, so the map tracks validator transitions that
+     * do not flip `VALID`/`INVALID`. Omit it only for a control that genuinely has no validation
+     * errors to report.
+     */
     readonly errors?: Signal<Record<string, unknown> | null>;
     /** Optional control-type identifier (e.g. `'input'`, `'select'`). When set, the form-field appends `tw-form-field-type-{controlType}` to its host for styling hooks. */
     abstract readonly controlType?: string;
@@ -141,7 +158,7 @@ declare class SuffixIconDirective extends SuffixDirective {
 declare class FormFieldComponent implements AfterContentInit, TwFormFieldParent {
     /** Visual appearance of the field container. `'outline'` draws a full border around the control; `'filled'` uses a filled surface with a bottom border. Defaults to `'outline'`. */
     readonly appearance: i0.InputSignal<FormFieldAppearance>;
-    /** Density of the field container. Maps to the inline-padding scale (`px-2 py-1` xs … `px-5 py-3` xl) and the floating-label font scale. Defaults to `'md'`. */
+    /** Density of the field container. Maps to the inline-padding scale (`px-2 py-1` xs … `px-5 py-3` xl), the control-row font scale (`text-xs` xs, `text-sm` sm/md, `text-base` lg/xl — inherited by the nested control and by prefix/suffix adornments), the label font scale, and a `min-h-*` floor on the control row from the control-height scale (24/32/36/44/48px). The floor is a minimum, not a fixed height: the row grows for a textarea or any other multi-line control. Defaults to `'md'`. */
     readonly size: i0.InputSignal<TwSize>;
     /** Floating label behavior. `'auto'` floats when focused or non-empty; `'always'` stays floated; `'never'` disables floating entirely (the label wrapper is not rendered and the wrapped control's placeholder is always visible). Defaults to `'auto'`. */
     readonly floatLabel: i0.InputSignal<FloatLabel>;

package/types/cdevhub-ngx-tw-icon.d.ts

@@ -38,7 +38,7 @@ interface TwIconSvgConfig {
  * ```html
  * <tw-icon name="star" />
  * <tw-icon name="check" color="success" size="lg" />
- * <tw-icon name="alert-triangle" color="warning" ariaLabel="Warning" />
+ * <tw-icon name="alert-triangle" color="warning" aria-label="Warning" />
  * <tw-icon name="star" [svg]="{ strokeWidth: 1.5, absoluteStrokeWidth: true }" />
  * ```
  */
@@ -56,7 +56,7 @@ declare class IconComponent {
     readonly color: _angular_core.InputSignal<TwIconColor>;
     /** Icon size. Defaults to `'md'` (20px). */
     readonly size: _angular_core.InputSignal<TwSize>;
-    /** Accessible label. When set, removes `aria-hidden` and applies `aria-label` to the SVG. Defaults to `undefined` (icon is decorative, `aria-hidden="true"`). */
+    /** Accessible label, supplied as the plain `aria-label` attribute. When set, the generated SVG takes `role="img"` plus the label instead of `aria-hidden="true"`. Defaults to `undefined` (icon is decorative, `aria-hidden="true"`). */
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     /**
      * SVG-author configuration: `strokeWidth`, `absoluteStrokeWidth`, `viewBox`.
@@ -82,7 +82,7 @@ declare class IconComponent {
     constructor();
     private renderSvg;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<IconComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<IconComponent, "tw-icon", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "img": { "alias": "img"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "svg": { "alias": "svg"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<IconComponent, "tw-icon", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "img": { "alias": "img"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "svg": { "alias": "svg"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**

package/types/cdevhub-ngx-tw-input.d.ts

@@ -23,7 +23,7 @@ declare const TW_INPUT_VALUE_ACCESSOR: InjectionToken<{
  *   and provide under `TW_FORM_FIELD_CONTROL`.
  * - Swap value storage for an existing `<input twInput>` (masked input,
  *   date parser, etc.) → provide {@link TW_INPUT_VALUE_ACCESSOR}.
- * - Change when errors show → override {@link TW_ERROR_STATE_MATCHER} at any
+ * - Change when errors show → override `TW_ERROR_STATE_MATCHER` at any
  *   injector level, or pass `errorStateMatcher` per instance.
  *
  * Forms integration is inherited: Angular's native value accessors attach to
@@ -38,9 +38,6 @@ declare class InputDirective extends FormFieldControl<string> implements OnInit
     private readonly destroyRef;
     private readonly formField;
     private readonly ngControl;
-    private readonly parentForm;
-    private readonly parentFormGroup;
-    private readonly defaultMatcher;
     private readonly valueAccessor;
     /** @internal */
     readonly _isTextarea: boolean;
@@ -51,7 +48,7 @@ declare class InputDirective extends FormFieldControl<string> implements OnInit
     readonly idInput: _angular_core.InputSignal<string | undefined>;
     /** Native HTML input `type`. Defaults to `'text'`. Dev-mode throws on unsupported values (`checkbox`, `radio`, `submit`, etc.) — use the dedicated component instead. Ignored on `<textarea>`. */
     readonly type: _angular_core.InputSignal<string>;
-    /** Density of a standalone field. Maps to the inline-padding scale (`px-2 py-1` xs … `px-6 py-3` xl) and font scale (`text-xs` xs, `text-sm` sm/md, `text-base` lg/xl). Ignored inside a `<tw-form-field>` — the wrapper's `size` carries density. Defaults to `'md'`. */
+    /** Density of a standalone field. Maps to the pinned control-height scale (24/32/36/44/48px, `h-6` xs … `h-12` xl), the horizontal-padding scale (`px-2` xs … `px-6` xl), and the font scale (`text-xs` xs, `text-sm` sm/md, `text-base` lg/xl). On a `<textarea>` the height becomes a `min-h-*` floor and the vertical padding is retained. Ignored inside a `<tw-form-field>` — the wrapper's `size` carries density. Defaults to `'md'`. */
     readonly size: _angular_core.InputSignal<TwSize>;
     /** Disables the control. Also reflects `ngControl.disabled` when the element is bound to a reactive form. Defaults to `false`. */
     readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -68,8 +65,8 @@ declare class InputDirective extends FormFieldControl<string> implements OnInit
     private readonly _value;
     private readonly _focused;
     private readonly _autofilled;
-    private readonly _ngControlRev;
-    private readonly _formSubmitRev;
+    /** @internal Shared `errorState` / `required` / `errors` derivation — see `wireErrorState`. */
+    private readonly errorWiring;
     /** @internal */
     readonly id: Signal<string>;
     /** @internal */
@@ -84,7 +81,7 @@ declare class InputDirective extends FormFieldControl<string> implements OnInit
     readonly required: Signal<boolean>;
     /** @internal */
     readonly errorState: Signal<boolean>;
-    /** @internal Active validation errors map from the bound `NgControl` (or `null` when the control reports none / is unbound). Recomputes on every `_ngControlRev` tick so `[twError match="…"]` reacts to validator transitions, including rules that fire/clear without flipping `VALID`/`INVALID`. */
+    /** @internal Active validation errors map from the bound `NgControl`, for `[twError match="…"]` filtering. */
     readonly errors: Signal<Record<string, unknown> | null>;
     /** @internal */
     readonly classes: Signal<string>;

package/types/cdevhub-ngx-tw-item.d.ts

@@ -36,7 +36,9 @@ declare class ItemComponent implements OnInit {
     readonly descriptionClasses: _angular_core.Signal<string>;
     readonly trailingClasses: _angular_core.Signal<string>;
     ngOnInit(): void;
+    /** @internal Emits `selected` on click when the item is interactive and enabled. */
     onActivate(event: Event): void;
+    /** @internal Emits `selected` on Enter/Space when the item is interactive and enabled. */
     onKeydown(event: KeyboardEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ItemComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ItemComponent, "tw-item", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "current": { "alias": "current"; "required": false; "isSignal": true; }; }, { "selected": "selected"; }, never, ["[twItemLeading]", "[twItemTitle]", "[twItemDescription]", "[twItemTrailing]"], true, never>;

package/types/cdevhub-ngx-tw-menu-testing.d.ts

@@ -0,0 +1,131 @@
+import { BaseHarnessFilters, ComponentHarness, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Filters accepted by `MenuItemHarness.with`. */
+interface MenuItemHarnessFilters extends BaseHarnessFilters {
+    /** Match by the item's visible text. */
+    text?: string | RegExp;
+    /** Match disabled / enabled items. */
+    disabled?: boolean;
+    /** Match checked / unchecked checkbox and radio items. Never matches a plain item. */
+    checked?: boolean;
+}
+/**
+ * Harness for a single item inside an open `tw-menu` panel.
+ *
+ * Hosts on the ARIA role rather than on the `twMenuItem*` attribute selectors,
+ * so one harness covers plain items, checkbox items and radio items — the roles
+ * are contributed by the CDK directives `tw-menu` composes and are the same
+ * thing assistive technology reads.
+ *
+ * Items render into the CDK overlay, not inside the trigger, so they are reached
+ * through {@link MenuHarness} rather than located directly against a fixture.
+ */
+declare class MenuItemHarness extends ComponentHarness {
+    static hostSelector: string;
+    /** Predicate for `locatorFor` / `locatorForAll`. */
+    static with(options?: MenuItemHarnessFilters): HarnessPredicate<MenuItemHarness>;
+    /** The item's rendered text, trimmed. Includes any projected description or shortcut text. */
+    getText(): Promise<string>;
+    /**
+     * The item's ARIA role — `'menuitem'`, `'menuitemcheckbox'` or
+     * `'menuitemradio'`. Lets a test tell the three kinds apart.
+     */
+    getRole(): Promise<string | null>;
+    /** Whether the item reports `aria-disabled="true"`. */
+    isDisabled(): Promise<boolean>;
+    /**
+     * Checked state of a checkbox or radio item, or `null` for a plain item,
+     * which carries no `aria-checked` at all.
+     */
+    isChecked(): Promise<boolean | null>;
+    /** Clicks the item. A disabled item ignores the click, as in the browser. */
+    click(): Promise<void>;
+}
+
+/** Filters accepted by `MenuHarness.with`. */
+interface MenuHarnessFilters extends BaseHarnessFilters {
+    /** Match by the text rendered in the trigger. */
+    triggerText?: string | RegExp;
+}
+/**
+ * Harness for a `[twMenuTrigger]` and the `tw-menu` panel it opens.
+ *
+ * ## Why this is a parallel harness and not a delegating one
+ *
+ * `tw-menu` composes `CdkMenu` / `CdkMenuItem` through `hostDirectives`, so a
+ * thin harness delegating to a CDK one would be preferable — except that
+ * `@angular/cdk` ships **no component harnesses at all**. Its only testing
+ * entry points are `@angular/cdk/testing`, `@angular/cdk/testing/testbed` and
+ * `@angular/cdk/testing/selenium-webdriver`, all of which are harness
+ * *infrastructure*; the component harnesses live in `@angular/material/*\/testing`,
+ * and `@angular/material` is not a dependency of this library. There is nothing
+ * to delegate to. What composition does buy us is that the locators below are
+ * ARIA roles and attributes CDK guarantees (`role="menuitem"`,
+ * `aria-expanded`, `aria-controls`), not ngx-tw class names.
+ *
+ * ## Why the host selector is not `[twMenuTrigger]`
+ *
+ * `twMenuTrigger` takes a required `TemplateRef`, so it is always written as a
+ * property binding — `[twMenuTrigger]="menu"` — and Angular renders **no
+ * attribute** for a bound input. `[twMenuTrigger]` therefore matches nothing in
+ * the DOM. `MenuTriggerDirective` adds no host class or attribute of its own
+ * (contrast Material, whose `MatMenuTrigger` adds `.mat-mdc-menu-trigger`
+ * precisely so its harness can find it), so the only durable marker is the one
+ * CDK contributes: `aria-haspopup="menu"`, bound unconditionally by
+ * `CdkMenuTrigger` whenever it has a template. Nothing else in ngx-tw renders
+ * that value — `[twContextMenuTrigger]` deliberately renders none — so the match
+ * is exact today. If `MenuTriggerDirective` ever grows a host marker, widening
+ * this selector to it is a non-breaking change.
+ *
+ * ## Loading it
+ *
+ * The host is the trigger, which lives in the fixture, so the ordinary
+ * `TestbedHarnessEnvironment.loader(fixture)` is correct. The panel renders into
+ * the CDK overlay container outside the fixture, and this harness resolves it
+ * internally via `documentRootLocatorFactory()` — a consumer never needs
+ * `documentRootLoader`.
+ *
+ * The panel is located by the id in the trigger's `aria-controls`, so a fixture
+ * holding several menus (or an open submenu) still resolves each trigger to its
+ * own panel.
+ *
+ * Only `[twMenuTrigger]` is covered. `[twContextMenuTrigger]` opens on a
+ * `contextmenu` event at pointer coordinates and exposes neither `aria-expanded`
+ * nor `aria-haspopup`; it is deliberately out of scope.
+ */
+declare class MenuHarness extends ComponentHarness {
+    static hostSelector: string;
+    /** Predicate for `locatorFor` / `locatorForAll`. */
+    static with(options?: MenuHarnessFilters): HarnessPredicate<MenuHarness>;
+    /** The text currently rendered in the trigger, trimmed. */
+    getTriggerText(): Promise<string>;
+    /** Whether the menu is open, read from the trigger's `aria-expanded`. */
+    isOpen(): Promise<boolean>;
+    /** Opens the menu by clicking the trigger. No-op when already open. */
+    open(): Promise<void>;
+    /** Closes the menu by clicking the trigger again. No-op when already closed. */
+    close(): Promise<void>;
+    /**
+     * Every item in the open panel — plain, checkbox and radio alike. Returns an
+     * empty array when the menu is closed, because CDK removes the panel from the
+     * DOM rather than hiding it.
+     */
+    getItems(filters?: MenuItemHarnessFilters): Promise<MenuItemHarness[]>;
+    /**
+     * Opens the menu if needed and clicks the first item whose text matches.
+     * Throws when nothing matches, rather than failing silently.
+     *
+     * CDK closes the menu when an item is activated, so a `getItems()` chained
+     * after this returns an empty array — call {@link open} again before
+     * re-reading item state.
+     */
+    clickItem(text: string | RegExp): Promise<void>;
+    /**
+     * A loader rooted at this trigger's own panel, or `null` when the menu is
+     * closed. Scoping by `aria-controls` keeps sibling menus and submenus apart.
+     */
+    private getPanelLoader;
+}
+
+export { MenuHarness, MenuItemHarness };
+export type { MenuHarnessFilters, MenuItemHarnessFilters };

package/types/cdevhub-ngx-tw-menu.d.ts

@@ -6,9 +6,9 @@ import { TwSize, TwColor } from '@cdevhub/ngx-tw/core';
 declare class MenuComponent {
     /** Controls item density and padding. Defaults to `'md'`. */
     readonly size: i0.InputSignal<TwSize>;
-    /** Accessible label for the menu panel. Use when no visible heading describes the menu (e.g. a kebab-icon trigger). */
+    /** Accessible label for the menu panel. Use when no visible heading describes the menu (e.g. a kebab-icon trigger). Defaults to `undefined`. Alias: `aria-label`. */
     readonly ariaLabel: i0.InputSignal<string | undefined>;
-    /** ID of an element that labels the menu panel. Ignored when `ariaLabel` is set. */
+    /** ID of an element that labels the menu panel. Ignored when `ariaLabel` is set. Defaults to `undefined`. Alias: `aria-labelledby`. */
     readonly ariaLabelledBy: i0.InputSignal<string | undefined>;
     readonly classes: i0.Signal<string>;
     static ɵfac: i0.ɵɵFactoryDeclaration<MenuComponent, never>;

package/types/cdevhub-ngx-tw-number-input.d.ts

@@ -42,6 +42,26 @@ declare class NumberInputDirective implements ControlValueAccessor {
     readonly disabled: _angular_core.Signal<boolean>;
     /** True when the host input carries the `readonly` attribute (static / declarative, seeded after render). A runtime toggle of the bare `readonly` attribute is not reactively tracked (v2). Read by the companion stepper so its buttons disable in lock-step. */
     readonly readonly: _angular_core.Signal<boolean>;
+    /**
+     * @internal `aria-disabled` for the host `<input>`.
+     *
+     * Derived from the CVA disabled state ALONE, deliberately not from
+     * {@link disabled}. Three reasons, in order of weight:
+     *
+     * 1. It is the only case that needs the attribute. When the element is
+     *    natively disabled (`el.disabled`, whether from a static attribute or
+     *    from the sibling `InputDirective`'s `[disabled]` binding) assistive tech
+     *    already has the state. The gap is `setDisabledState(true)` on a
+     *    standalone `input[twNumberInput]` — no sibling directive, so nothing
+     *    writes the native property and the spinbutton looked enabled.
+     * 2. `disabled` reads the non-reactive `el.disabled`. Read from a host
+     *    binding it would memoize during the host-binding phase, so its value
+     *    would depend on which of the two directives on the element runs first —
+     *    and could latch a stale `true` across a `control.enable()`.
+     * 3. `[disabled]` itself is not an option: `InputDirective` already binds it,
+     *    and this directive's `disabled` reads the very property it would write.
+     */
+    readonly ariaDisabled: _angular_core.Signal<"true" | null>;
     /** @internal Mobile-keyboard hint: `'numeric'` for integer-only formats, else `'decimal'`. */
     readonly inputMode: _angular_core.Signal<"numeric" | "decimal">;
     /** @internal Locale group / decimal separators, memoized per `locale()`. */