@a.nemreen/dga-ui 0.2.9 → 0.3.1

package/types/a.nemreen-dga-ui.d.ts

@@ -5,6 +5,54 @@ import { ControlValueAccessor } from '@angular/forms';
 export { ControlValueAccessor } from '@angular/forms';
 import * as _a_nemreen_dga_ui from '@a.nemreen/dga-ui';
 
+/** Creative named page transitions for `dga-page-transition`. */
+declare const DGA_PAGE_TRANSITION_NAMES: readonly ["fade-up", "slide-stack", "curtain-wipe", "zoom-blur", "book-flip", "circle-reveal", "shared-axis", "glitch", "iris-open", "split-reveal", "stagger-cascade", "liquid-swipe", "push-depth", "skew-slide", "bounce-in", "film-strip", "portal-warp", "ripple-expand", "origami-fold", "swipe-cards", "none"];
+type DgaPageTransitionName = (typeof DGA_PAGE_TRANSITION_NAMES)[number];
+/**
+ * Easy page / content transition wrapper.
+ *
+ * ```html
+ * <dga-page-transition name="fade-up">
+ *   <router-outlet />
+ * </dga-page-transition>
+ * ```
+ *
+ * Triggers: Angular `NavigationEnd`, or a change to `key` (playground / content swap).
+ * Progressive enhancement: sets `view-transition-name: dga-page` so apps using
+ * `withViewTransitions()` get named snapshot animations. Keyframe enter runs as fallback.
+ * Honors `prefers-reduced-motion` and DGA a11y `reduce-motion`.
+ */
+declare class DgaPageTransition {
+    private readonly host;
+    private readonly doc;
+    private readonly destroyRef;
+    private readonly a11y;
+    private readonly router;
+    /** Named creative transition. Unknown values resolve to `none`. */
+    readonly name: _angular_core.InputSignal<string>;
+    /** Duration in milliseconds (also drives `--dga-pt-ms`). */
+    readonly duration: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Skip all motion. */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Bump this to re-play the enter animation (content swaps / gallery playground).
+     * For View Transition snapshots, wrap the key update in `document.startViewTransition`.
+     */
+    readonly key: _angular_core.InputSignal<string | number | null>;
+    readonly phase: _angular_core.WritableSignal<"idle" | "enter">;
+    readonly resolvedName: _angular_core.Signal<"none" | "fade-up" | "slide-stack" | "curtain-wipe" | "zoom-blur" | "book-flip" | "circle-reveal" | "shared-axis" | "glitch" | "iris-open" | "split-reveal" | "stagger-cascade" | "liquid-swipe" | "push-depth" | "skew-slide" | "bounce-in" | "film-strip" | "portal-warp" | "ripple-expand" | "origami-fold" | "swipe-cards">;
+    readonly durationCss: _angular_core.Signal<string>;
+    private htmlAttr;
+    private keyPrimed;
+    constructor();
+    /** Re-trigger the enter animation (e.g. from a Play control). */
+    play(): void;
+    protected onAnimationEnd(event: AnimationEvent): void;
+    private shouldReduceMotion;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaPageTransition, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaPageTransition, "dga-page-transition", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "duration": { "alias": "duration"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "key": { "alias": "key"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
 type DgaButtonVariant = 'primary' | 'secondary' | 'subtle' | 'outline' | 'outlineMuted' | 'outlineInverse' | 'ghost' | 'danger' | 'inverse';
 type DgaButtonSize = 'sm' | 'md' | 'lg';
 declare class DgaButton {
@@ -19,6 +67,11 @@ declare class DgaButton {
     readonly cooldownMs: _angular_core.InputSignal<number>;
     /** Manual loading state — shows spinner and disables the control. */
     readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Extra classes merged with variant styles.
+     * Prefer this over a bare `[class]` on the host — the directive owns `[class]`.
+     */
+    readonly buttonClass: _angular_core.InputSignal<string>;
     /** Exposed for host bindings (Angular 22 requires public host expressions). */
     readonly cooling: _angular_core.WritableSignal<boolean>;
     private cooldownTimer;
@@ -31,7 +84,7 @@ declare class DgaButton {
     private detachSpinner;
     private clearCooldown;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaButton, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DgaButton, "button[dgaButton], a[dgaButton]", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "iconOnly": { "alias": "iconOnly"; "required": false; "isSignal": true; }; "cooldownMs": { "alias": "cooldownMs"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DgaButton, "button[dgaButton], a[dgaButton]", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "iconOnly": { "alias": "iconOnly"; "required": false; "isSignal": true; }; "cooldownMs": { "alias": "cooldownMs"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "buttonClass": { "alias": "dgaButtonClass"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 type DgaBadgeVariant = 'neutral' | 'primary' | 'success' | 'info' | 'warning' | 'error';
@@ -55,6 +108,34 @@ declare class DgaChip {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaChip, "dga-chip", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "removeLabel": { "alias": "removeLabel"; "required": false; "isSignal": true; }; }, { "removed": "removed"; }, never, ["*"], true, never>;
 }
 
+/**
+ * Keyboard key badge — mirrors shadcn `Kbd` for shortcut hints.
+ *
+ * @see https://ui.shadcn.com/docs/components/base/kbd
+ *
+ * @example
+ * ```html
+ * <dga-kbd>Ctrl</dga-kbd>
+ * <dga-kbd-group>
+ *   <dga-kbd>⌘</dga-kbd>
+ *   <dga-kbd>K</dga-kbd>
+ * </dga-kbd-group>
+ * ```
+ */
+declare class DgaKbd {
+    readonly size: _angular_core.InputSignal<"sm" | "md">;
+    readonly classes: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaKbd, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaKbd, "dga-kbd", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+/**
+ * Groups related keyboard keys (e.g. ⌘ + K).
+ */
+declare class DgaKbdGroup {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaKbdGroup, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaKbdGroup, "dga-kbd-group", never, {}, {}, never, ["*"], true, never>;
+}
+
 type DgaDividerOrientation = 'horizontal' | 'vertical';
 declare class DgaDivider {
     readonly orientation: _angular_core.InputSignal<DgaDividerOrientation>;
@@ -155,7 +236,7 @@ declare class DgaAvatar {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaAvatar, "dga-avatar", never, { "src": { "alias": "src"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "alt": { "alias": "alt"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-type DgaIconName = 'access' | 'check' | 'close' | 'info' | 'helpCircle' | 'warning' | 'alertCircle' | 'error' | 'eye' | 'eyeOff' | 'eyeOffSlash' | 'success' | 'checkCircle' | 'checkCircleAlt' | 'chevronDown' | 'chevronLeft' | 'chevronRight' | 'arrowUp' | 'arrowDown' | 'arrowLeft' | 'arrowRight' | 'arrowUp02' | 'arrowDown02' | 'arrowLeft02' | 'arrowRight02' | 'arrowNext' | 'arrowPrev' | 'arrowNext02' | 'arrowPrev02' | 'shrink' | 'search' | 'user' | 'users' | 'menu' | 'menuAlt' | 'moreHorizontal' | 'moreVertical' | 'mic' | 'home' | 'download' | 'upload' | 'calendar' | 'calendarAlt' | 'clock' | 'star' | 'starFilled' | 'plus' | 'plusSign' | 'minus' | 'external' | 'bell' | 'bellAlt' | 'lock' | 'lockPassword' | 'logout' | 'idCard' | 'link' | 'linkAlt' | 'globe' | 'moon' | 'moonAlt' | 'sun' | 'sunAlt' | 'translation' | 'mail' | 'message' | 'phone' | 'building' | 'share' | 'refresh' | 'highlighter' | 'door' | 'zoomIn' | 'zoomOut' | 'sort' | 'sortUp' | 'sortDown' | 'tradeUp' | 'tradeDown' | 'paintBoard' | 'cloud' | 'sunCloud' | 'moonCloud' | 'rain' | 'rainZap' | 'snow' | 'wind' | 'desert' | 'cart' | 'award' | 'cookie' | 'x' | 'linkedin' | 'whatsapp' | 'book' | 'headphones' | 'devices' | 'badgeCheck' | 'riyal' | 'copy' | 'location' | 'folder' | 'printer' | 'instagram' | 'smartphone' | 'ambulance' | 'police' | 'fire' | 'facebook' | 'youtube' | 'apple' | 'playStore' | 'huawei' | 'textFont' | 'glasses' | 'heading' | 'mask' | 'pause' | 'textAlign' | 'letterSpacing' | 'textUnderline' | 'maximize' | 'colors' | 'colorPicker' | 'droplet' | 'disability' | 'wheelchair' | 'brain' | 'flash' | 'touch';
+type DgaIconName = 'access' | 'check' | 'close' | 'info' | 'helpCircle' | 'warning' | 'alertCircle' | 'error' | 'eye' | 'eyeOff' | 'eyeOffSlash' | 'filter' | 'success' | 'checkCircle' | 'checkCircleAlt' | 'chevronDown' | 'chevronLeft' | 'chevronRight' | 'arrowUp' | 'arrowDown' | 'arrowLeft' | 'arrowRight' | 'arrowUp02' | 'arrowDown02' | 'arrowLeft02' | 'arrowRight02' | 'arrowNext' | 'arrowPrev' | 'arrowNext02' | 'arrowPrev02' | 'shrink' | 'search' | 'user' | 'users' | 'menu' | 'menuAlt' | 'moreHorizontal' | 'moreVertical' | 'mic' | 'home' | 'download' | 'upload' | 'calendar' | 'calendarAlt' | 'clock' | 'star' | 'starFilled' | 'plus' | 'plusSign' | 'minus' | 'external' | 'bell' | 'bellAlt' | 'lock' | 'lockPassword' | 'logout' | 'idCard' | 'link' | 'linkAlt' | 'globe' | 'moon' | 'moonAlt' | 'sun' | 'sunAlt' | 'translation' | 'mail' | 'message' | 'phone' | 'building' | 'share' | 'refresh' | 'highlighter' | 'door' | 'zoomIn' | 'zoomOut' | 'sort' | 'sortUp' | 'sortDown' | 'tradeUp' | 'tradeDown' | 'paintBoard' | 'cloud' | 'sunCloud' | 'moonCloud' | 'rain' | 'rainZap' | 'snow' | 'wind' | 'desert' | 'cart' | 'award' | 'cookie' | 'x' | 'linkedin' | 'whatsapp' | 'book' | 'headphones' | 'devices' | 'badgeCheck' | 'riyal' | 'copy' | 'location' | 'folder' | 'printer' | 'instagram' | 'smartphone' | 'ambulance' | 'police' | 'fire' | 'facebook' | 'youtube' | 'apple' | 'playStore' | 'huawei' | 'textFont' | 'glasses' | 'heading' | 'mask' | 'pause' | 'textAlign' | 'letterSpacing' | 'textUnderline' | 'maximize' | 'colors' | 'colorPicker' | 'droplet' | 'disability' | 'wheelchair' | 'brain' | 'flash' | 'touch';
 /** Decode `@platformscode/icons` data-URI exports into inline SVG markup. */
 declare function decodePlatformscodeSvg(dataUri: string): string;
 /** Pre-decoded SVG markup keyed by friendly `DgaIconName`. */
@@ -359,6 +440,8 @@ interface DgaSelectOption {
     label: string;
     value: string;
     disabled?: boolean;
+    /** Extra text matched when `searchable` (e.g. country name). */
+    keywords?: string;
 }
 type DgaSelectOpenMode = 'dropdown' | 'always';
 type DgaSelectSize = DgaFormControlSize;
@@ -513,6 +596,10 @@ declare class DgaSlider {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DgaSlider, "input[type=\"range\"][dgaSlider]", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Multi-cell one-time password input.
+ * The control group is always LTR so digits read and fill left-to-right on RTL pages.
+ */
 declare class DgaOtp implements ControlValueAccessor {
     private cells;
     readonly length: _angular_core.InputSignal<number>;
@@ -534,6 +621,9 @@ declare class DgaOtp implements ControlValueAccessor {
     onInput(index: number, raw: string): void;
     onKey(index: number, event: KeyboardEvent): void;
     onPaste(event: ClipboardEvent): void;
+    private focusAt;
+    /** Keep native inputs in sync when autofill bypasses `maxlength`. */
+    private syncDom;
     private commit;
     writeValue(value: string): void;
     registerOnChange(fn: (value: string) => void): void;
@@ -629,13 +719,13 @@ interface DgaPhoneCountry {
     code: string;
     /** Short label shown in the prefix select. */
     label: string;
-    /** Optional longer name for option text. */
+    /** Optional longer name for option text / search. */
     name?: string;
 }
 /** GCC-first dial codes for contact forms. */
 declare const DGA_PHONE_COUNTRIES: DgaPhoneCountry[];
 /**
- * Phone field with country-code prefix select.
+ * Phone field with searchable country-code prefix select.
  * The control group is always LTR so digits and codes read correctly in RTL pages.
  */
 declare class DgaPhoneInput implements ControlValueAccessor {
@@ -654,10 +744,13 @@ declare class DgaPhoneInput implements ControlValueAccessor {
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Full E.164-ish combined value: country code + national digits. */
     readonly value: _angular_core.ModelSignal<string>;
+    readonly countryOptions: _angular_core.Signal<DgaSelectOption[]>;
+    readonly resolvedStatus: _angular_core.Signal<_a_nemreen_dga_ui.DgaFormStatus>;
     readonly groupClasses: _angular_core.Signal<string>;
     private onChange;
     onTouched: () => void;
     constructor();
+    onCountryCode(next: string | string[]): void;
     writeValue(value: string): void;
     registerOnChange(fn: (value: string) => void): void;
     registerOnTouched(fn: () => void): void;
@@ -809,7 +902,7 @@ declare class DgaDatePickerComponent implements ControlValueAccessor {
     readonly viewParts: _angular_core.WritableSignal<DgaCalendarParts>;
     readonly draftStart: _angular_core.WritableSignal<Date | null>;
     readonly draftEnd: _angular_core.WritableSignal<Date | null>;
-    readonly rangePickPhase: _angular_core.WritableSignal<"start" | "end">;
+    readonly rangePickPhase: _angular_core.WritableSignal<"end" | "start">;
     readonly typedValue: _angular_core.WritableSignal<string | null>;
     readonly effectiveStatus: _angular_core.Signal<DgaFormStatus>;
     readonly panelMode: _angular_core.Signal<DgaDatePickerMode>;
@@ -1026,7 +1119,22 @@ declare class DgaModal {
 }
 
 type DgaToastVariant = 'neutral' | 'success' | 'info' | 'warning' | 'error';
+/**
+ * Enter / exit motion:
+ * - `fade` — opacity only
+ * - `push` — drop in from the nearest vertical edge (default)
+ * - `slide` — slide in from the nearest inline edge
+ * - `scale` — fade + slight scale
+ * - `none` — instant
+ */
+type DgaToastAnimation = 'fade' | 'push' | 'slide' | 'scale' | 'none';
+/**
+ * Viewport placement (logical start/end follow `dir`).
+ * Default `top-end` matches prior fixed `end` + top chrome offset.
+ */
+type DgaToastLocation = 'top-start' | 'top-center' | 'top-end' | 'bottom-start' | 'bottom-center' | 'bottom-end';
 declare class DgaToast implements OnDestroy {
+    private readonly destroyRef;
     readonly open: _angular_core.ModelSignal<boolean>;
     readonly variant: _angular_core.InputSignal<DgaToastVariant>;
     readonly title: _angular_core.InputSignal<string>;
@@ -1034,27 +1142,83 @@ declare class DgaToast implements OnDestroy {
     readonly closeLabel: _angular_core.InputSignal<string>;
     /** Auto-dismiss after ms; `0` disables. Default 5s per a11y guidance. */
     readonly duration: _angular_core.InputSignal<number>;
+    /** Circular countdown ring on the dismiss control when `duration > 0`. */
+    readonly countdown: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Pause auto-dismiss while the pointer is over the toast. */
+    readonly pauseOnHover: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Pause auto-dismiss while focus is inside the toast. */
+    readonly pauseOnFocus: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Enter / exit motion. Default `push` (from nearest vertical edge). */
+    readonly animation: _angular_core.InputSignal<DgaToastAnimation>;
+    /** Viewport corner / edge. Default `top-end`. */
+    readonly location: _angular_core.InputSignal<DgaToastLocation>;
     readonly closed: _angular_core.OutputEmitterRef<void>;
-    private timer;
+    /** Keeps the toast mounted while the exit animation plays. */
+    readonly rendered: _angular_core.WritableSignal<boolean>;
+    readonly leaving: _angular_core.WritableSignal<boolean>;
+    /** Remaining fraction of duration (1 → 0). */
+    readonly progress: _angular_core.WritableSignal<number>;
+    readonly ringR = 10;
+    readonly ringC: number;
+    private remainingMs;
+    private totalMs;
+    private paused;
+    private hoverPaused;
+    private focusPaused;
+    private rafId;
+    private lastTick;
+    private exitTimer;
+    private readonly reduceMotionFlag;
     readonly classes: _angular_core.Signal<string>;
+    readonly hostClass: _angular_core.Signal<string>;
+    readonly isTop: _angular_core.Signal<boolean>;
+    /** Clear sticky announcement / reserved chrome, then a small gap. */
+    readonly edgeTop: _angular_core.Signal<"calc(var(--dga-announcement-offset, 0px) + 1rem)" | null>;
+    readonly edgeBottom: _angular_core.Signal<"1rem" | null>;
     readonly iconName: _angular_core.Signal<DgaIconName>;
-    readonly iconTone: _angular_core.Signal<"success" | "warning" | "error" | "muted" | "current">;
+    readonly iconTone: _angular_core.Signal<"warning" | "error" | "success" | "muted" | "current">;
+    readonly showCountdown: _angular_core.Signal<boolean>;
+    readonly reduceMotion: _angular_core.WritableSignal<boolean>;
+    readonly ringDashOffset: _angular_core.Signal<number>;
+    private readonly animClass;
     constructor();
     ngOnDestroy(): void;
     dismiss(): void;
-    private clearTimer;
+    onAnimationEnd(event: AnimationEvent): void;
+    onPointerEnter(): void;
+    onPointerLeave(): void;
+    onFocusIn(): void;
+    onFocusOut(event: FocusEvent): void;
+    private beginClose;
+    private finishClose;
+    private resetTicker;
+    private syncPaused;
+    private startTicker;
+    private stopTicker;
+    private clearExitTimer;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaToast, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaToast, "dga-toast", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; "duration": { "alias": "duration"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaToast, "dga-toast", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; "duration": { "alias": "duration"; "required": false; "isSignal": true; }; "countdown": { "alias": "countdown"; "required": false; "isSignal": true; }; "pauseOnHover": { "alias": "pauseOnHover"; "required": false; "isSignal": true; }; "pauseOnFocus": { "alias": "pauseOnFocus"; "required": false; "isSignal": true; }; "animation": { "alias": "animation"; "required": false; "isSignal": true; }; "location": { "alias": "location"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; }, never, ["*"], true, never>;
 }
 
 interface DgaToastShowOptions {
     title?: string;
     message?: string;
     variant?: DgaToastVariant;
+    /** Auto-dismiss after ms; `0` disables. Default 5000. */
     duration?: number;
     dismissible?: boolean;
-}
-interface DgaToastRequest extends Required<Pick<DgaToastShowOptions, 'title' | 'message' | 'variant' | 'duration' | 'dismissible'>> {
+    /** Circular countdown on the dismiss control. Default true when duration > 0. */
+    countdown?: boolean;
+    /** Pause auto-dismiss while hovered. Default true. */
+    pauseOnHover?: boolean;
+    /** Pause auto-dismiss while focused. Default true. */
+    pauseOnFocus?: boolean;
+    /** Enter / exit motion. Default `push`. */
+    animation?: DgaToastAnimation;
+    /** Viewport placement. Default `top-end`. */
+    location?: DgaToastLocation;
+}
+interface DgaToastRequest extends Required<Pick<DgaToastShowOptions, 'title' | 'message' | 'variant' | 'duration' | 'dismissible' | 'countdown' | 'pauseOnHover' | 'pauseOnFocus' | 'animation' | 'location'>> {
     id: number;
 }
 /**
@@ -1222,9 +1386,194 @@ declare class DgaMenu {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaMenu, "dga-menu", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "triggerLabel": { "alias": "triggerLabel"; "required": false; "isSignal": true; }; "leadingIcon": { "alias": "leadingIcon"; "required": false; "isSignal": true; }; "showChevron": { "alias": "showChevron"; "required": false; "isSignal": true; }; "menuMinWidth": { "alias": "menuMinWidth"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "selected": "selected"; "selectedValue": "selectedValue"; "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
 }
 
+type DgaContextMenuItemType = 'item' | 'checkbox' | 'radio' | 'divider' | 'label';
+interface DgaContextMenuItem {
+    /** Required for actionable items. */
+    label?: string;
+    value?: string;
+    icon?: DgaIconName;
+    /** Shortcut keys shown trailing — `"⌘K"` or `['Ctrl', 'K']`. */
+    shortcut?: string | readonly string[];
+    danger?: boolean;
+    disabled?: boolean;
+    divider?: boolean;
+    type?: DgaContextMenuItemType;
+    /** Checkbox / radio checked state. */
+    checked?: boolean;
+    /** Nested submenu items. */
+    children?: DgaContextMenuItem[];
+}
+/** Marks projected content as the context-menu trigger surface. */
+declare class DgaContextMenuTrigger {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaContextMenuTrigger, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DgaContextMenuTrigger, "[dgaContextMenuTrigger]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Right-click / long-press context menu (shadcn-style).
+ *
+ * @see https://ui.shadcn.com/docs/components/base/context-menu
+ *
+ * @example
+ * ```html
+ * <dga-context-menu [items]="items" (selected)="onSelect($event)">
+ *   <div dgaContextMenuTrigger class="rounded-md border p-3xl">
+ *     Right click here
+ *   </div>
+ * </dga-context-menu>
+ * ```
+ */
+declare class DgaContextMenu {
+    private readonly host;
+    private readonly injector;
+    private readonly destroyRef;
+    private readonly surfaceRef;
+    private readonly menuRef;
+    readonly items: _angular_core.InputSignal<DgaContextMenuItem[]>;
+    readonly open: _angular_core.ModelSignal<boolean>;
+    /** Enable long-press on touch (default true). */
+    readonly longPress: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly longPressMs: _angular_core.InputSignal<number>;
+    readonly menuMinWidth: _angular_core.InputSignal<string>;
+    readonly selected: _angular_core.OutputEmitterRef<DgaContextMenuItem>;
+    readonly selectedValue: _angular_core.OutputEmitterRef<string>;
+    readonly opened: _angular_core.OutputEmitterRef<void>;
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    readonly panelStyle: _angular_core.WritableSignal<Record<string, string>>;
+    readonly subStyle: _angular_core.WritableSignal<Record<string, string>>;
+    readonly openSubIndex: _angular_core.WritableSignal<number | null>;
+    readonly isRtl: _angular_core.WritableSignal<boolean>;
+    private readonly seq;
+    readonly listId: string;
+    private activeIndex;
+    private pointer;
+    private longPressTimer;
+    private readonly onReposition;
+    constructor();
+    menuClasses(): string;
+    itemId(index: number): string;
+    trackItem(item: DgaContextMenuItem, index: number): string;
+    shortcutKeys(item: DgaContextMenuItem): string[] | null;
+    itemClass(item: DgaContextMenuItem): string;
+    onContextMenu(event: MouseEvent): void;
+    onTouchStart(event: TouchEvent): void;
+    onTouchEnd(): void;
+    onItemClick(item: DgaContextMenuItem, event: MouseEvent): void;
+    onItemEnter(item: DgaContextMenuItem, index: number, event: PointerEvent): void;
+    selectItem(item: DgaContextMenuItem): void;
+    close(restoreFocus?: boolean): void;
+    onMenuKey(event: KeyboardEvent): void;
+    onDocumentPointer(event: PointerEvent): void;
+    onDocumentKeydown(event: KeyboardEvent): void;
+    private openAtPointer;
+    private clearLongPress;
+    private isSelectable;
+    private firstSelectableIndex;
+    private stepIndex;
+    private portalMenuToBody;
+    private detachPortaledMenu;
+    private syncPanelPosition;
+    private syncSubPosition;
+    private focusItem;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaContextMenu, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaContextMenu, "dga-context-menu", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "longPress": { "alias": "longPress"; "required": false; "isSignal": true; }; "longPressMs": { "alias": "longPressMs"; "required": false; "isSignal": true; }; "menuMinWidth": { "alias": "menuMinWidth"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "selected": "selected"; "selectedValue": "selectedValue"; "opened": "opened"; "closed": "closed"; }, never, ["*"], true, never>;
+}
+
+interface DgaCommandItem {
+    /** Stable id used for tracking / selection. */
+    id: string;
+    label: string;
+    value?: string;
+    icon?: DgaIconName;
+    /** Shortcut keys — `"⌘P"` or `['Ctrl', 'P']`. */
+    shortcut?: string | readonly string[];
+    disabled?: boolean;
+    /** Extra search tokens (labels are always searchable). */
+    keywords?: readonly string[];
+}
+interface DgaCommandGroup {
+    heading?: string;
+    items: DgaCommandItem[];
+}
+type DgaCommandAppearance = 'panel' | 'dialog';
+/**
+ * Command palette — searchable actions (cmdk / shadcn-style).
+ *
+ * Use `appearance="dialog"` for a centered modal palette, or `panel` for inline.
+ *
+ * @see https://ui.shadcn.com/docs/components/base/command
+ *
+ * @example
+ * ```html
+ * <dga-command
+ *   [(open)]="cmdOpen"
+ *   appearance="dialog"
+ *   [groups]="commandGroups"
+ *   (selected)="run($event)"
+ * />
+ * ```
+ */
+declare class DgaCommand {
+    private readonly destroyRef;
+    private readonly injector;
+    private readonly queryInput;
+    readonly groups: _angular_core.InputSignal<DgaCommandGroup[]>;
+    /** Flat items when you do not need group headings. */
+    readonly items: _angular_core.InputSignal<DgaCommandItem[]>;
+    readonly open: _angular_core.ModelSignal<boolean>;
+    readonly appearance: _angular_core.InputSignal<DgaCommandAppearance>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly emptyLabel: _angular_core.InputSignal<string>;
+    readonly clearLabel: _angular_core.InputSignal<string>;
+    readonly dialogLabel: _angular_core.InputSignal<string>;
+    readonly listLabel: _angular_core.InputSignal<string>;
+    readonly closeOnSelect: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Optional global shortcut to toggle (Ctrl/⌘+K). Dialog mode only. */
+    readonly hotkey: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly selected: _angular_core.OutputEmitterRef<DgaCommandItem>;
+    readonly selectedValue: _angular_core.OutputEmitterRef<string>;
+    readonly opened: _angular_core.OutputEmitterRef<void>;
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    readonly queryChange: _angular_core.OutputEmitterRef<string>;
+    readonly query: _angular_core.WritableSignal<string>;
+    readonly activeId: _angular_core.WritableSignal<string | null>;
+    private readonly seq;
+    readonly listId: string;
+    private previousFocus;
+    private wasOpen;
+    /** Panel is always shown; dialog only when `open`. */
+    readonly show: _angular_core.Signal<boolean>;
+    readonly filteredGroups: _angular_core.Signal<DgaCommandGroup[]>;
+    readonly flatFiltered: _angular_core.Signal<DgaCommandItem[]>;
+    readonly activeDescendant: _angular_core.Signal<string | null>;
+    constructor();
+    optionId(id: string): string;
+    shortcutKeys(item: DgaCommandItem): string[] | null;
+    onQueryInput(event: Event): void;
+    clearQuery(): void;
+    setActive(id: string): void;
+    select(item: DgaCommandItem): void;
+    close(): void;
+    onBackdrop(): void;
+    onRootKey(event: KeyboardEvent): void;
+    onInputKey(event: KeyboardEvent): void;
+    onHotkey(event: KeyboardEvent): void;
+    private moveActive;
+    private resolveGroups;
+    private matches;
+    private normalize;
+    private focusInput;
+    private restoreFocus;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaCommand, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaCommand, "dga-command", never, { "groups": { "alias": "groups"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; "dialogLabel": { "alias": "dialogLabel"; "required": false; "isSignal": true; }; "listLabel": { "alias": "listLabel"; "required": false; "isSignal": true; }; "closeOnSelect": { "alias": "closeOnSelect"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "hotkey": { "alias": "hotkey"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "selected": "selected"; "selectedValue": "selectedValue"; "opened": "opened"; "closed": "closed"; "queryChange": "queryChange"; }, never, never, true, never>;
+}
+
 type DgaDrawerSide = 'start' | 'end';
 declare class DgaDrawer {
+    private readonly doc;
+    private readonly destroyRef;
     private readonly injector;
+    private readonly rootRef;
     private readonly panel;
     readonly open: _angular_core.ModelSignal<boolean>;
     readonly title: _angular_core.InputSignal<string>;
@@ -1235,12 +1584,16 @@ declare class DgaDrawer {
     readonly closed: _angular_core.OutputEmitterRef<void>;
     readonly titleId: string;
     private previousFocus;
-    private previousOverflow;
+    private previousBodyOverflow;
+    private previousHtmlOverflow;
+    private scrollLocked;
     readonly panelClasses: _angular_core.Signal<string>;
     constructor();
     close(): void;
     onBackdrop(): void;
     onKeydown(event: KeyboardEvent): void;
+    private portalToBody;
+    private removePortaledRoot;
     private focusInitial;
     private trapFocus;
     private getFocusable;
@@ -1316,6 +1669,114 @@ declare class DgaImagePopup {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaImagePopup, "dga-image-popup", never, { "images": { "alias": "images"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "activeIndex": { "alias": "activeIndex"; "required": false; "isSignal": true; }; "animation": { "alias": "animation"; "required": false; "isSignal": true; }; "imageTransition": { "alias": "imageTransition"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; "prevLabel": { "alias": "prevLabel"; "required": false; "isSignal": true; }; "nextLabel": { "alias": "nextLabel"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "activeIndex": "activeIndexChange"; "closed": "closed"; "opened": "opened"; }, never, never, true, never>;
 }
 
+/** Logical placements (RTL-aware via inset-inline). */
+type DgaTourPlacement = 'top' | 'bottom' | 'start' | 'end' | 'auto';
+type DgaTourPersist = 'local' | 'session' | 'none';
+interface DgaTourStep {
+    /** Optional stable id for analytics. */
+    id?: string;
+    /**
+     * CSS selector for the highlighted element.
+     * Omit or leave empty for a centered intro / outro card.
+     */
+    target?: string;
+    title: string;
+    description: string;
+    placement?: DgaTourPlacement;
+    /** Scroll the target into view before measuring (default true). */
+    scroll?: boolean;
+    /** Extra padding around the spotlight hole (px). */
+    padding?: number;
+}
+interface SpotRect {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+}
+interface PopoverPos {
+    top: number;
+    left: number;
+    placement: Exclude<DgaTourPlacement, 'auto'>;
+}
+/**
+ * Multi-step onboarding tour with spotlight + coachmark.
+ *
+ * Targets elements via CSS selectors (e.g. `[data-dga-action="login"]`).
+ * Empty `target` steps render a centered welcome / finish card.
+ *
+ * @example
+ * ```html
+ * <dga-tour
+ *   [(open)]="tourOpen"
+ *   [steps]="tourSteps"
+ *   persist="local"
+ *   persistKey="portal-onboarding"
+ * />
+ * ```
+ */
+declare class DgaTour {
+    private readonly doc;
+    private readonly destroyRef;
+    private readonly injector;
+    private readonly rootRef;
+    readonly open: _angular_core.ModelSignal<boolean>;
+    readonly steps: _angular_core.InputSignal<DgaTourStep[]>;
+    readonly stepIndex: _angular_core.ModelSignal<number>;
+    readonly nextLabel: _angular_core.InputSignal<string>;
+    readonly prevLabel: _angular_core.InputSignal<string>;
+    readonly skipLabel: _angular_core.InputSignal<string>;
+    readonly doneLabel: _angular_core.InputSignal<string>;
+    /** Template: `{current}` and `{total}` */
+    readonly stepOfLabel: _angular_core.InputSignal<string>;
+    readonly allowSkip: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Auto-open on first visit when persist storage has no flag. */
+    readonly autoStart: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly persist: _angular_core.InputSignal<DgaTourPersist>;
+    readonly persistKey: _angular_core.InputSignal<string>;
+    readonly completed: _angular_core.OutputEmitterRef<void>;
+    readonly skipped: _angular_core.OutputEmitterRef<void>;
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    readonly stepChange: _angular_core.OutputEmitterRef<number>;
+    readonly titleId: string;
+    readonly spot: _angular_core.WritableSignal<SpotRect | null>;
+    readonly popover: _angular_core.WritableSignal<PopoverPos | null>;
+    private previousFocus;
+    private resizeObserver;
+    private measureRaf;
+    private unbindViewport;
+    private autoStarted;
+    readonly visible: _angular_core.Signal<boolean>;
+    readonly current: _angular_core.Signal<DgaTourStep>;
+    readonly isLast: _angular_core.Signal<boolean>;
+    readonly progressLabel: _angular_core.Signal<string>;
+    constructor();
+    next(): void;
+    prev(): void;
+    skip(): void;
+    onBackdrop(): void;
+    onKeydown(event: KeyboardEvent): void;
+    private goTo;
+    private finish;
+    private scheduleMeasure;
+    private measure;
+    private placePopover;
+    private bindObservers;
+    /** Move layer to `document.body` so sticky announcement / headers cannot sit above it. */
+    private portalToBody;
+    private removePortaledRoot;
+    private teardownObservers;
+    private focusCard;
+    private restoreFocus;
+    private clampIndex;
+    private storage;
+    private hasSeen;
+    private markSeen;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaTour, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaTour, "dga-tour", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "steps": { "alias": "steps"; "required": false; "isSignal": true; }; "stepIndex": { "alias": "stepIndex"; "required": false; "isSignal": true; }; "nextLabel": { "alias": "nextLabel"; "required": false; "isSignal": true; }; "prevLabel": { "alias": "prevLabel"; "required": false; "isSignal": true; }; "skipLabel": { "alias": "skipLabel"; "required": false; "isSignal": true; }; "doneLabel": { "alias": "doneLabel"; "required": false; "isSignal": true; }; "stepOfLabel": { "alias": "stepOfLabel"; "required": false; "isSignal": true; }; "allowSkip": { "alias": "allowSkip"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "autoStart": { "alias": "autoStart"; "required": false; "isSignal": true; }; "persist": { "alias": "persist"; "required": false; "isSignal": true; }; "persistKey": { "alias": "persistKey"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "stepIndex": "stepIndexChange"; "completed": "completed"; "skipped": "skipped"; "closed": "closed"; "stepChange": "stepChange"; }, never, never, true, never>;
+}
+
 type DgaAlertVariant = 'neutral' | 'critical' | 'error' | 'warning' | 'info' | 'success';
 /** Layout: default card alert, or compact single-line banner. */
 type DgaAlertDisplay = 'default' | 'inline';
@@ -1337,7 +1798,7 @@ declare class DgaAlert {
     readonly titleClasses: _angular_core.Signal<string>;
     readonly descriptionClasses: _angular_core.Signal<string>;
     readonly iconName: _angular_core.Signal<DgaIconName>;
-    readonly iconTone: _angular_core.Signal<"success" | "warning" | "error" | "muted" | "current">;
+    readonly iconTone: _angular_core.Signal<"warning" | "error" | "success" | "muted" | "current">;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaAlert, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaAlert, "dga-alert", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "shadow": { "alias": "shadow"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "display": { "alias": "display"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; }, { "dismissed": "dismissed"; }, never, ["*", "[dgaAlertActions]"], true, never>;
 }
@@ -1856,6 +2317,7 @@ type DgaA11yLetterSpacing = '0' | '0.04em' | '0.08em' | '0.12em';
 type DgaA11yWordSpacing = '0' | '0.16em' | '0.32em' | '0.48em';
 declare class DgaAccessibilityService {
     private readonly doc;
+    private readonly zone;
     private liveRegion;
     private opener;
     private mqMotion;
@@ -1872,15 +2334,20 @@ declare class DgaAccessibilityService {
     readonly maskBand: _angular_core.WritableSignal<number>;
     /** Center Y of the reading-mask band in px. */
     readonly maskY: _angular_core.WritableSignal<number>;
-    readonly reduceMotion: _angular_core.WritableSignal<boolean>;
-    readonly highlightLinks: _angular_core.WritableSignal<boolean>;
-    readonly highlightTitles: _angular_core.WritableSignal<boolean>;
-    readonly highContrast: _angular_core.WritableSignal<boolean>;
-    readonly dyslexia: _angular_core.WritableSignal<boolean>;
-    readonly readingMask: _angular_core.WritableSignal<boolean>;
-    readonly motorTargets: _angular_core.WritableSignal<boolean>;
-    /** Signal bumped when locale attrs change (for computed copy). */
-    readonly localeEpoch: _angular_core.WritableSignal<number>;
+    readonly reduceMotion: _angular_core.Signal<boolean>;
+    readonly highlightLinks: _angular_core.Signal<boolean>;
+    readonly highlightTitles: _angular_core.Signal<boolean>;
+    readonly highContrast: _angular_core.Signal<boolean>;
+    readonly dyslexia: _angular_core.Signal<boolean>;
+    readonly readingMask: _angular_core.Signal<boolean>;
+    readonly motorTargets: _angular_core.Signal<boolean>;
+    /**
+     * Reactive UI locale — kept in sync with `<html lang>` / `data-locale`
+     * (including when `DgaLocaleService` updates the document).
+     */
+    readonly locale: _angular_core.WritableSignal<"ar" | "en">;
+    private readonly effectiveModes;
+    private localeObserver;
     constructor();
     open(opener?: HTMLElement | null): void;
     close(): void;
@@ -1896,23 +2363,29 @@ declare class DgaAccessibilityService {
     cycleLineHeight(): void;
     cycleLetterSpacing(): void;
     cycleWordSpacing(): void;
+    /** Step font size (−1 / +1), wrapping within available levels. */
+    stepFontStep(delta: number): void;
+    stepTextAlign(delta: number): void;
+    stepLineHeight(delta: number): void;
+    stepLetterSpacing(delta: number): void;
+    stepWordSpacing(delta: number): void;
     adjustMaskBand(delta: number): void;
     setMaskY(y: number): void;
     reset(): void;
     announce(msg: string): void;
-    /** Current UI locale inferred from `<html lang>`. */
-    get locale(): 'ar' | 'en';
+    /** Current UI locale inferred from `<html lang>` / `data-locale`. */
+    private readDomLocale;
+    /** Keep `locale` reactive when portal / DgaLocaleService mutates `<html>`. */
+    private bindLocaleObserver;
     /**
      * Toggle AR/EN on `<html>` (`lang` / `dir` / `data-locale`).
      * Compatible with DgaLocaleService attribute contract.
      */
     toggleLocale(): 'ar' | 'en';
     activeModeCount(section: 'modes' | 'readable' | 'visual'): number;
+    /** Total active settings across profiles + tools + filters (for FAB badge). */
+    activeSettingCount(): number;
     private applyBundleExtras;
-    /** Primitive left on by direct toggle (not only via a bundle). */
-    private userKeptPrimitive;
-    private syncDerived;
-    /** Lazily inject OpenDyslexic (Latin). Arabic falls through to Readex Pro. */
     private ensureDyslexiaFont;
     private applyToDocument;
     private persist;
@@ -1924,8 +2397,8 @@ declare class DgaAccessibilityService {
 }
 
 type DgaAccessibilityPosition = 'end' | 'start' | 'left' | 'right';
-type SectionId = 'modes' | 'readable' | 'visual';
-type SectionOpen = SectionId | null;
+type AdjustToggleId = 'dyslexia' | 'highlight-titles' | 'highlight-links' | 'reading-mask' | 'reduce-motion';
+type AdjustStepperId = 'font' | 'align' | 'line' | 'letter' | 'word';
 declare class DgaAccessibility {
     readonly a11y: DgaAccessibilityService;
     readonly position: _angular_core.InputSignal<DgaAccessibilityPosition>;
@@ -1937,7 +2410,6 @@ declare class DgaAccessibility {
     readonly panelId = "dga-accessibility-panel";
     private readonly panelRef;
     readonly fabBottom: _angular_core.Signal<string>;
-    readonly sectionOpen: _angular_core.WritableSignal<SectionOpen>;
     readonly resetArmed: _angular_core.WritableSignal<boolean>;
     readonly liveMsg: _angular_core.WritableSignal<string>;
     private resetTimer;
@@ -1947,10 +2419,14 @@ declare class DgaAccessibility {
         close: string;
         panelLabel: string;
         title: string;
-        sectionModes: string;
-        sectionReadable: string;
-        sectionVisual: string;
-        langToggle: string;
+        sectionActive: string;
+        sectionProfiles: string;
+        sectionAdjust: string;
+        sectionFilters: string;
+        profilesHint: string;
+        chipJump: string;
+        stepDecrease: string;
+        stepIncrease: string;
         reset: string;
         resetConfirm: string;
         announcedReset: string;
@@ -2020,23 +2496,32 @@ declare class DgaAccessibility {
         label: string;
         desc: string;
     }[]>;
-    readonly readableTiles: _angular_core.Signal<{
-        id: string;
+    readonly adjustToggles: _angular_core.Signal<{
+        id: AdjustToggleId;
+        mode: DgaA11yMode;
+        icon: DgaIconName;
+        label: string;
+        active: boolean;
+    }[]>;
+    readonly adjustSteppers: _angular_core.Signal<{
+        id: AdjustStepperId;
         icon: DgaIconName;
         label: string;
-        kind: "cycle" | "toggle";
         active: boolean;
-        level: number;
         valueLabel: string;
-        ariaLabel: string;
-        onClick: () => void;
     }[]>;
     readonly visualTiles: _angular_core.Signal<{
-        value: DgaA11yVisualFilter;
+        value: Exclude<DgaA11yVisualFilter, "none">;
         label: string;
         icon: DgaIconName;
         active: boolean;
     }[]>;
+    readonly activeChips: _angular_core.Signal<{
+        id: string;
+        label: string;
+        controlId: string;
+    }[]>;
+    readonly activeBadgeCount: _angular_core.Signal<number>;
     readonly fabClasses: _angular_core.Signal<string>;
     readonly panelClasses: _angular_core.Signal<string>;
     constructor();
@@ -2044,14 +2529,13 @@ declare class DgaAccessibility {
     onPointerMove(event: PointerEvent): void;
     onPointerUp(): void;
     onFabClick(event: MouseEvent): void;
-    toggleSection(id: SectionId): void;
     onBundle(id: DgaA11yBundle, enabled: boolean): void;
-    onToggleMode(mode: DgaA11yMode): void;
+    onToggleMode(mode: DgaA11yMode, enabled?: boolean): void;
+    onStep(id: AdjustStepperId, delta: number): void;
     onFilter(value: DgaA11yVisualFilter): void;
-    onLocale(): void;
+    focusControl(controlId: string): void;
     onReset(): void;
     onMaskDragStart(event: PointerEvent): void;
-    tileClasses(active: boolean): string;
     private panelPositionClass;
     private announce;
     private onMaskKeys;
@@ -2233,6 +2717,11 @@ declare class DgaStepper {
     readonly steps: _angular_core.InputSignal<DgaStep[]>;
     readonly active: _angular_core.ModelSignal<number>;
     readonly label: _angular_core.InputSignal<string>;
+    /**
+     * Optional veto for step clicks (e.g. form wizard validation).
+     * Return false to keep the current step.
+     */
+    readonly beforeActiveChange: _angular_core.InputSignal<((next: number, current: number) => boolean) | undefined>;
     stepStatus(index: number): DgaStepStatus;
     stepButtonClasses(index: number): string;
     labelClasses(index: number): string;
@@ -2240,7 +2729,7 @@ declare class DgaStepper {
     railTone(index: number): string;
     go(index: number): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaStepper, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaStepper, "dga-stepper", never, { "steps": { "alias": "steps"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "active": "activeChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaStepper, "dga-stepper", never, { "steps": { "alias": "steps"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "beforeActiveChange": { "alias": "beforeActiveChange"; "required": false; "isSignal": true; }; }, { "active": "activeChange"; }, never, never, true, never>;
 }
 
 interface DgaTocItem {
@@ -2294,7 +2783,7 @@ declare class DgaSideNav {
     /**
      * `auto` = horizontal chips below lg; `vertical` = always sidebar (use in drawers).
      */
-    readonly layout: _angular_core.InputSignal<"vertical" | "auto">;
+    readonly layout: _angular_core.InputSignal<"auto" | "vertical">;
     readonly label: _angular_core.InputSignal<string>;
     readonly toggleLabel: _angular_core.InputSignal<string>;
     readonly select: _angular_core.OutputEmitterRef<DgaSideNavItem>;
@@ -2394,9 +2883,9 @@ declare class DgaNavRail {
     readonly smoothScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly select: _angular_core.OutputEmitterRef<DgaNavRailItem>;
     readonly expandChange: _angular_core.OutputEmitterRef<boolean>;
-    readonly edgeAttr: _angular_core.Signal<"start" | "end" | "right" | "left" | null>;
+    readonly edgeAttr: _angular_core.Signal<"end" | "start" | "right" | "left" | null>;
     readonly offsetCss: _angular_core.Signal<string>;
-    readonly tooltipPlacement: _angular_core.Signal<"start" | "end">;
+    readonly tooltipPlacement: _angular_core.Signal<"end" | "start">;
     readonly iconSize: _angular_core.Signal<"sm" | "md" | "lg">;
     readonly expandIcon: _angular_core.Signal<"chevronLeft" | "chevronRight">;
     readonly listGapClass: _angular_core.Signal<"gap-xs" | "gap-sm" | "gap-md">;
@@ -2985,6 +3474,9 @@ declare class DgaHeader {
     onAction(action: DgaHeaderAction, event?: Event): void;
     onMobileAction(action: DgaHeaderAction, event?: Event): void;
     closeUtilityOverlays(): void;
+    /** Ask demo portal font/brand menus to close so they don't stack over header panels. */
+    private closePortalChromeMenus;
+    onCloseHeaderOverlays(): void;
     toggleSearch(): void;
     onSearchModalOpenChange(open: boolean): void;
     focusSearchInput(): void;
@@ -3337,7 +3829,14 @@ declare class DgaAnnouncementBar {
     /** Fired when the action control has no `actionHref` (button / chip / link-as-button). */
     readonly action: _angular_core.OutputEmitterRef<void>;
     readonly dismissed: _angular_core.WritableSignal<boolean>;
+    private readonly doc;
+    private readonly hostEl;
+    private readonly destroyRef;
+    private resizeObserver;
     constructor();
+    private bindLayoutOffset;
+    private syncLayoutOffset;
+    private clearLayoutOffset;
     readonly iconTone: _angular_core.Signal<DgaIconTone>;
     readonly iconShellClasses: _angular_core.Signal<string>;
     readonly barClasses: _angular_core.Signal<string>;
@@ -3988,5 +4487,5 @@ declare function dgaSaudiCityOptions(locale?: 'ar' | 'en', cities?: readonly Dga
     value: string;
 }[];
 
-export { DGA_GREGORIAN_MONTHS, DGA_HIJRI_MONTHS, DGA_ICON_NAMES, DGA_ICON_SVG, DGA_LOGICAL_ICON_NAMES, DGA_PHONE_COUNTRIES, DGA_RIYAL_SVG_PATH, DGA_RIYAL_VIEWBOX, DGA_SAUDI_CITIES, DGA_WEEKDAYS, DgaAccessibility, DgaAccessibilityService, DgaAccordion, DgaAccordionItem, DgaAlert, DgaAnnouncementBar, DgaAppShell, DgaAuthCard, DgaAutocomplete, DgaAvatar, DgaBadge, DgaBreadcrumb, DgaButton, DgaCard, DgaCardMedia, DgaCarousel, DgaCarouselSlideDirective, DgaChart, DgaChatbot, DgaCheckbox, DgaChip, DgaChipInput, DgaClamp, DgaCode, DgaContentSwitcher, DgaContentSwitcherPanel, DgaCookies, DgaCopy, DgaDatePickerComponent as DgaDatePicker, DgaDescriptionList, DgaDialog, DgaDivider, DgaDrawer, DgaDualNav, DgaEmpty, DgaExpandable, DgaExport, DgaExportToolbar, DgaFeedback, DgaField, DgaFilterBar, DgaFooter, DgaFormControl, DgaFormEnd, DgaFormStart, DgaGrid, DgaHeader, DgaHero, DgaIcon, DgaIconBadge, DgaIconFontService, DgaImagePopup, DgaInfoList, DgaInput, DgaLabel, DgaLink, DgaList, DgaLogoTile, DgaMenu, DgaMetric, DgaModal, DgaMultiselect, DgaNativeSelect, DgaNavRail, DgaNumber, DgaNumberInput, DgaOtp, DgaPageFeedback, DgaPageHero, DgaPagination, DgaPersona, DgaPhoneInput, DgaPreloader, DgaProgress, DgaQuote, DgaRadio, DgaRating, DgaRiyal, DgaScrollTop, DgaSection, DgaSelect, DgaShare, DgaSideInfo, DgaSideNav, DgaSkeleton, DgaSkipLink, DgaSlider, DgaSpinner, DgaStepper, DgaSwitch, DgaTab, DgaTable, DgaTabs, DgaTimePicker, DgaTimeline, DgaToast, DgaToastOutlet, DgaToastService, DgaToc, DgaToolbar, DgaTooltip, DgaTopBar, DgaUpload, decodePlatformscodeSvg, dgaAddMonths, dgaClampDate, dgaCoerceDate, dgaCompareDays, dgaDaysInMonth, dgaFormatDate, dgaGetCalendarParts, dgaGroupSaudiCitiesByRegion, dgaModeFromFormat, dgaMonthNames, dgaMonthStartWeekday, dgaNormalizeTime, dgaParseDate, dgaPartsToDate, dgaProvideValueAccessor, dgaSameDay, dgaSaudiCityOptions, dgaTodayUtc };
-export type { DgaA11yBundle, DgaA11yMode, DgaA11yVisualFilter, DgaAccessibilityPosition, DgaAccordionSection, DgaAlertDisplay, DgaAlertVariant, DgaAnnouncementActionVariant, DgaAnnouncementAlign, DgaAnnouncementDensity, DgaAnnouncementElevation, DgaAnnouncementPersist, DgaAnnouncementTone, DgaAppShellAppearance, DgaAutocompleteOption, DgaAvatarSize, DgaBadgeSize, DgaBadgeVariant, DgaBreadcrumbItem, DgaBreadcrumbSeparator, DgaButtonSize, DgaButtonVariant, DgaCalendar, DgaCalendarParts, DgaCardActionsAlign, DgaCardAppearance, DgaCardBadge, DgaCardBorder, DgaCardPadding, DgaCardShadow, DgaCarouselSlide, DgaChartDataset, DgaChartPoint, DgaChartType, DgaChatbotAnimation, DgaChatbotFabTone, DgaChatbotMessage, DgaChatbotPosition, DgaChatbotSize, DgaCheckboxSize, DgaChipVariant, DgaContentSwitcherItem, DgaCookieCategory, DgaCookieConsent, DgaCookieDecision, DgaCookiePreferences, DgaCookiesAlign, DgaCookiesPosition, DgaCurrency, DgaDateCalendar, DgaDatePickerMode, DgaDateRangeValue, DgaDescriptionItem, DgaDescriptionLayout, DgaDialogSize, DgaDividerOrientation, DgaDrawerSide, DgaDualNavCategory, DgaDualNavSection, DgaEmptyAppearance, DgaExportColumn, DgaExportData, DgaExportScope, DgaFeedbackSubmit, DgaFilterItem, DgaFooterAppearance, DgaFooterColumn, DgaFooterIconGroup, DgaFooterIconLink, DgaFooterLink, DgaFooterLogo, DgaFormControlSize, DgaFormStatus, DgaGridCols, DgaGridGap, DgaHeaderAction, DgaHeaderAppearance, DgaHeaderLoginConfig, DgaHeaderNotification, DgaHeaderNotificationAction, DgaHeaderNotificationTone, DgaHeaderNotificationsConfig, DgaHeaderSearchConfig, DgaHeaderSearchSuggestion, DgaHeaderUserConfig, DgaHeaderUserMenuLink, DgaHeroAppearance, DgaHeroImageMask, DgaHeroOverlayTone, DgaHeroSlide, DgaHeroTransition, DgaIconBadgeAppearance, DgaIconBadgeSize, DgaIconName, DgaIconSize, DgaIconTone, DgaImagePopupAnimation, DgaImagePopupImage, DgaImagePopupImageTransition, DgaImagePopupSource, DgaInfoListItem, DgaInputSize, DgaLinkVariant, DgaMenuItem, DgaMetricAppearance, DgaMetricTrend, DgaMobileNavMode, DgaModalAnimation, DgaModalSize, DgaMultiselectOption, DgaNativeSelectSize, DgaNavColumn, DgaNavDropdown, DgaNavDropdownLayout, DgaNavDropdownVariant, DgaNavFeatured, DgaNavItem, DgaNavLink, DgaNavRailActiveStyle, DgaNavRailAppearance, DgaNavRailItem, DgaNavRailPosition, DgaNavRailSize, DgaPageFeedbackAgreementLink, DgaPageFeedbackAnswer, DgaPageFeedbackOption, DgaPageFeedbackPhase, DgaPageFeedbackSubmit, DgaPageHeroTone, DgaPhoneCountry, DgaPreloaderPersist, DgaProgressAppearance, DgaProgressSize, DgaProgressTone, DgaRadioSize, DgaRatingSize, DgaRiyalAppearance, DgaRiyalSize, DgaRiyalTone, DgaSaudiCity, DgaScrollTopPosition, DgaSectionTone, DgaSectionWidth, DgaSelectOpenMode, DgaSelectOption, DgaSelectSize, DgaShareAppearance, DgaSideInfoItem, DgaSideNavGroup, DgaSideNavItem, DgaSkeletonAnimation, DgaSkeletonRadius, DgaSkeletonShape, DgaSkeletonSize, DgaSortDir, DgaSpinnerSize, DgaSpinnerTone, DgaStampNotice, DgaStep, DgaStepStatus, DgaSwitchSize, DgaTabItem, DgaTableColumn, DgaTableDensity, DgaTimeFormat, DgaTimePickerFormat, DgaTimePickerSize, DgaTimelineItem, DgaToastRequest, DgaToastShowOptions, DgaToastVariant, DgaTocItem, DgaTooltipPlacement, DgaTooltipVariant, DgaUploadAppearance, DgaUploadFile, DgaUploadRejectReason, DgaUploadRejection };
+export { DGA_GREGORIAN_MONTHS, DGA_HIJRI_MONTHS, DGA_ICON_NAMES, DGA_ICON_SVG, DGA_LOGICAL_ICON_NAMES, DGA_PAGE_TRANSITION_NAMES, DGA_PHONE_COUNTRIES, DGA_RIYAL_SVG_PATH, DGA_RIYAL_VIEWBOX, DGA_SAUDI_CITIES, DGA_WEEKDAYS, DgaAccessibility, DgaAccessibilityService, DgaAccordion, DgaAccordionItem, DgaAlert, DgaAnnouncementBar, DgaAppShell, DgaAuthCard, DgaAutocomplete, DgaAvatar, DgaBadge, DgaBreadcrumb, DgaButton, DgaCard, DgaCardMedia, DgaCarousel, DgaCarouselSlideDirective, DgaChart, DgaChatbot, DgaCheckbox, DgaChip, DgaChipInput, DgaClamp, DgaCode, DgaCommand, DgaContentSwitcher, DgaContentSwitcherPanel, DgaContextMenu, DgaContextMenuTrigger, DgaCookies, DgaCopy, DgaDatePickerComponent as DgaDatePicker, DgaDescriptionList, DgaDialog, DgaDivider, DgaDrawer, DgaDualNav, DgaEmpty, DgaExpandable, DgaExport, DgaExportToolbar, DgaFeedback, DgaField, DgaFilterBar, DgaFooter, DgaFormControl, DgaFormEnd, DgaFormStart, DgaGrid, DgaHeader, DgaHero, DgaIcon, DgaIconBadge, DgaIconFontService, DgaImagePopup, DgaInfoList, DgaInput, DgaKbd, DgaKbdGroup, DgaLabel, DgaLink, DgaList, DgaLogoTile, DgaMenu, DgaMetric, DgaModal, DgaMultiselect, DgaNativeSelect, DgaNavRail, DgaNumber, DgaNumberInput, DgaOtp, DgaPageFeedback, DgaPageHero, DgaPageTransition, DgaPagination, DgaPersona, DgaPhoneInput, DgaPreloader, DgaProgress, DgaQuote, DgaRadio, DgaRating, DgaRiyal, DgaScrollTop, DgaSection, DgaSelect, DgaShare, DgaSideInfo, DgaSideNav, DgaSkeleton, DgaSkipLink, DgaSlider, DgaSpinner, DgaStepper, DgaSwitch, DgaTab, DgaTable, DgaTabs, DgaTimePicker, DgaTimeline, DgaToast, DgaToastOutlet, DgaToastService, DgaToc, DgaToolbar, DgaTooltip, DgaTopBar, DgaTour, DgaUpload, decodePlatformscodeSvg, dgaAddMonths, dgaClampDate, dgaCoerceDate, dgaCompareDays, dgaDaysInMonth, dgaFormatDate, dgaGetCalendarParts, dgaGroupSaudiCitiesByRegion, dgaModeFromFormat, dgaMonthNames, dgaMonthStartWeekday, dgaNormalizeTime, dgaParseDate, dgaPartsToDate, dgaProvideValueAccessor, dgaSameDay, dgaSaudiCityOptions, dgaTodayUtc };
+export type { DgaA11yBundle, DgaA11yMode, DgaA11yVisualFilter, DgaAccessibilityPosition, DgaAccordionSection, DgaAlertDisplay, DgaAlertVariant, DgaAnnouncementActionVariant, DgaAnnouncementAlign, DgaAnnouncementDensity, DgaAnnouncementElevation, DgaAnnouncementPersist, DgaAnnouncementTone, DgaAppShellAppearance, DgaAutocompleteOption, DgaAvatarSize, DgaBadgeSize, DgaBadgeVariant, DgaBreadcrumbItem, DgaBreadcrumbSeparator, DgaButtonSize, DgaButtonVariant, DgaCalendar, DgaCalendarParts, DgaCardActionsAlign, DgaCardAppearance, DgaCardBadge, DgaCardBorder, DgaCardPadding, DgaCardShadow, DgaCarouselSlide, DgaChartDataset, DgaChartPoint, DgaChartType, DgaChatbotAnimation, DgaChatbotFabTone, DgaChatbotMessage, DgaChatbotPosition, DgaChatbotSize, DgaCheckboxSize, DgaChipVariant, DgaCommandAppearance, DgaCommandGroup, DgaCommandItem, DgaContentSwitcherItem, DgaContextMenuItem, DgaContextMenuItemType, DgaCookieCategory, DgaCookieConsent, DgaCookieDecision, DgaCookiePreferences, DgaCookiesAlign, DgaCookiesPosition, DgaCurrency, DgaDateCalendar, DgaDatePickerMode, DgaDateRangeValue, DgaDescriptionItem, DgaDescriptionLayout, DgaDialogSize, DgaDividerOrientation, DgaDrawerSide, DgaDualNavCategory, DgaDualNavSection, DgaEmptyAppearance, DgaExportColumn, DgaExportData, DgaExportScope, DgaFeedbackSubmit, DgaFilterItem, DgaFooterAppearance, DgaFooterColumn, DgaFooterIconGroup, DgaFooterIconLink, DgaFooterLink, DgaFooterLogo, DgaFormControlSize, DgaFormStatus, DgaGridCols, DgaGridGap, DgaHeaderAction, DgaHeaderAppearance, DgaHeaderLoginConfig, DgaHeaderNotification, DgaHeaderNotificationAction, DgaHeaderNotificationTone, DgaHeaderNotificationsConfig, DgaHeaderSearchConfig, DgaHeaderSearchSuggestion, DgaHeaderUserConfig, DgaHeaderUserMenuLink, DgaHeroAppearance, DgaHeroImageMask, DgaHeroOverlayTone, DgaHeroSlide, DgaHeroTransition, DgaIconBadgeAppearance, DgaIconBadgeSize, DgaIconName, DgaIconSize, DgaIconTone, DgaImagePopupAnimation, DgaImagePopupImage, DgaImagePopupImageTransition, DgaImagePopupSource, DgaInfoListItem, DgaInputSize, DgaLinkVariant, DgaMenuItem, DgaMetricAppearance, DgaMetricTrend, DgaMobileNavMode, DgaModalAnimation, DgaModalSize, DgaMultiselectOption, DgaNativeSelectSize, DgaNavColumn, DgaNavDropdown, DgaNavDropdownLayout, DgaNavDropdownVariant, DgaNavFeatured, DgaNavItem, DgaNavLink, DgaNavRailActiveStyle, DgaNavRailAppearance, DgaNavRailItem, DgaNavRailPosition, DgaNavRailSize, DgaPageFeedbackAgreementLink, DgaPageFeedbackAnswer, DgaPageFeedbackOption, DgaPageFeedbackPhase, DgaPageFeedbackSubmit, DgaPageHeroTone, DgaPageTransitionName, DgaPhoneCountry, DgaPreloaderPersist, DgaProgressAppearance, DgaProgressSize, DgaProgressTone, DgaRadioSize, DgaRatingSize, DgaRiyalAppearance, DgaRiyalSize, DgaRiyalTone, DgaSaudiCity, DgaScrollTopPosition, DgaSectionTone, DgaSectionWidth, DgaSelectOpenMode, DgaSelectOption, DgaSelectSize, DgaShareAppearance, DgaSideInfoItem, DgaSideNavGroup, DgaSideNavItem, DgaSkeletonAnimation, DgaSkeletonRadius, DgaSkeletonShape, DgaSkeletonSize, DgaSortDir, DgaSpinnerSize, DgaSpinnerTone, DgaStampNotice, DgaStep, DgaStepStatus, DgaSwitchSize, DgaTabItem, DgaTableColumn, DgaTableDensity, DgaTimeFormat, DgaTimePickerFormat, DgaTimePickerSize, DgaTimelineItem, DgaToastAnimation, DgaToastLocation, DgaToastRequest, DgaToastShowOptions, DgaToastVariant, DgaTocItem, DgaTooltipPlacement, DgaTooltipVariant, DgaTourPersist, DgaTourPlacement, DgaTourStep, DgaUploadAppearance, DgaUploadFile, DgaUploadRejectReason, DgaUploadRejection };