@wildmason/aegis 1.7.6 → 1.9.1

package/dist/types/wildmason-aegis.d.ts

@@ -7,8 +7,24 @@ import * as rxjs from 'rxjs';
 /**
  * WmModal — Lightweight modal backdrop with Escape key and click-outside dismissal.
  *
- * Owns the fixed backdrop, centering, and keyboard/pointer dismissal so individual
- * modal components don't need to repeat this logic or add their own HostListeners.
+ * Owns the fixed backdrop, centering, keyboard/pointer dismissal AND the focus trap,
+ * so individual modal components don't need to repeat this logic or add their own
+ * HostListeners.
+ *
+ * ## Focus is trapped here, and it has to be
+ *
+ * The trap lives on the wrapper INSIDE this component's `@if (visible())`, exactly as
+ * `wm-dialog` does. That placement is not a style preference — it is the only placement
+ * that works. `CdkTrapFocus.ngAfterContentInit` calls `attachAnchors()`, which is a
+ * no-op unless the element already has a `parentNode`. An element the consumer projects
+ * in through `<ng-content/>` does not have one at that moment, so a consumer-applied
+ * `cdkTrapFocus` attaches zero anchors and silently traps nothing — `autoCapture` still
+ * pulls focus in, which makes it look like it works, while Tab walks straight out the
+ * back of the dialog. Three Helm surfaces shipped that way before it was measured.
+ *
+ * Consumers must therefore NOT add their own `cdkTrapFocus`; nesting a second trap
+ * inside this one only creates a conflict. Consumers DO still own `role="dialog"`,
+ * `aria-modal` and the accessible name, because only they know what the dialog is.
  *
  * Usage:
  *   <wm-modal [visible]="visible()" (dismiss)="close()">
@@ -240,9 +256,20 @@ declare class WmAutoFocus implements AfterViewInit {
 
 declare class WmTab {
     readonly value: _angular_core.InputSignal<string>;
+    /**
+     * Keeps a prerequisite-gated tab discoverable while preventing activation.
+     * Unlike a native disabled button, unavailable tabs remain in the roving
+     * focus order so keyboard and assistive-technology users can learn why the
+     * destination cannot be opened yet.
+     */
+    readonly unavailable: _angular_core.InputSignal<boolean>;
+    /** Exact prerequisite guidance exposed to both pointer and AT users. */
+    readonly unavailableReason: _angular_core.InputSignal<string>;
+    /** Render a non-interactive group divider immediately before this tab. */
+    readonly separatorBefore: _angular_core.InputSignal<boolean>;
     readonly tmpl: _angular_core.Signal<TemplateRef<void>>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WmTab, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WmTab, "wm-tab", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WmTab, "wm-tab", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; "unavailable": { "alias": "unavailable"; "required": false; "isSignal": true; }; "unavailableReason": { "alias": "unavailableReason"; "required": false; "isSignal": true; }; "separatorBefore": { "alias": "separatorBefore"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 declare class WmTabs {
@@ -251,7 +278,7 @@ declare class WmTabs {
     readonly select: _angular_core.OutputEmitterRef<string>;
     protected readonly tabs: _angular_core.Signal<readonly WmTab[]>;
     protected focusedIndex: _angular_core.WritableSignal<number>;
-    protected selectTab(value: string, index: number): void;
+    protected selectTab(tab: WmTab, index: number): void;
     protected onBlur(): void;
     protected onKeyDown(event: KeyboardEvent, container: HTMLElement): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WmTabs, never>;
@@ -565,6 +592,22 @@ declare class WmCombobox implements ControlValueAccessor, OnDestroy {
     readonly allowFreeform: _angular_core.InputSignal<boolean>;
     /** Placeholder text for the input. */
     readonly placeholder: _angular_core.InputSignal<string>;
+    /**
+     * Accessible name for the combobox input.
+     *
+     * Required unless `ariaLabelledby` is supplied. The host `<wm-combobox>` is
+     * not a labelable element, so a consumer's `<label for="\u2026">` cannot reach the
+     * inner input \u2014 and the placeholder is blanked as soon as a chip is selected,
+     * so in multi-select mode there is otherwise no accessible name at all once
+     * the user picks anything.
+     */
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    /**
+     * ID of a visible element that names this combobox. Prefer this over
+     * `ariaLabel` when a visible caption exists, so the accessible name matches
+     * the visible text (WCAG 2.5.3, Label in Name).
+     */
+    readonly ariaLabelledby: _angular_core.InputSignal<string>;
     /** Disable the combobox. */
     readonly disabled: _angular_core.InputSignal<boolean>;
     /** Custom async filter function. Overrides default substring matching. */
@@ -646,7 +689,7 @@ declare class WmCombobox implements ControlValueAccessor, OnDestroy {
      *  look like a no-op after close(). */
     private syncInputToSelection;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WmCombobox, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WmCombobox, "wm-combobox", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "values": { "alias": "values"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "allowFreeform": { "alias": "allowFreeform"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "filterFn": { "alias": "filterFn"; "required": false; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": false; "isSignal": true; }; "maxPanelHeight": { "alias": "maxPanelHeight"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "values": "valuesChange"; "query": "query"; "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WmCombobox, "wm-combobox", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "values": { "alias": "values"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "allowFreeform": { "alias": "allowFreeform"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "ariaLabelledby"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "filterFn": { "alias": "filterFn"; "required": false; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": false; "isSignal": true; }; "maxPanelHeight": { "alias": "maxPanelHeight"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "values": "valuesChange"; "query": "query"; "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
 }
 
 type ToastType = 'success' | 'error' | 'info' | 'progress';