@a.nemreen/dga-ui 0.3.13 → 0.3.15

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

@@ -1,56 +1,11 @@
 import * as _angular_core from '@angular/core';
-import { Type, Provider, Signal, OnDestroy, OnInit } from '@angular/core';
+import { InjectionToken, EnvironmentProviders, Type, Provider, Signal, OnDestroy, OnInit, TemplateRef } from '@angular/core';
 import { SafeHtml, SafeResourceUrl } from '@angular/platform-browser';
 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 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>;
-}
+import * as _a_nemreen_dga_tokens from '@a.nemreen/dga-tokens';
+import { DgaLocale } from '@a.nemreen/dga-tokens';
 
 type DgaWritingEffect = 'typewriter' | 'glow';
 /**
@@ -94,14 +49,20 @@ declare class DgaWriting {
 
 type DgaButtonVariant = 'primary' | 'secondary' | 'subtle' | 'outline' | 'outlineMuted' | 'outlineInverse' | 'ghost' | 'danger' | 'inverse';
 type DgaButtonSize = 'sm' | 'md' | 'lg';
+/** Hover / focus motion. Default `opacity` preserves legacy chrome. */
+type DgaButtonEffect = 'opacity' | 'ripple' | 'lift' | 'scale' | 'glow' | 'press' | 'bounce' | 'slide' | 'shine' | 'pulse' | 'float' | 'wobble' | 'jelly';
 declare class DgaButton {
     private readonly destroyRef;
     private readonly host;
     private readonly renderer;
     readonly variant: _angular_core.InputSignal<DgaButtonVariant>;
     readonly size: _angular_core.InputSignal<DgaButtonSize>;
+    /** Hover / focus motion. Default matches legacy opacity chrome. */
+    readonly effect: _angular_core.InputSignal<DgaButtonEffect>;
     /** Square control sized to the icon (no horizontal padding). */
     readonly iconOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Stretch to the width of the parent (adds `w-full`). */
+    readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** When > 0, disables the host for this many ms after each click and shows a spinner. */
     readonly cooldownMs: _angular_core.InputSignal<number>;
     /** Manual loading state — shows spinner and disables the control. */
@@ -118,12 +79,14 @@ declare class DgaButton {
     readonly busy: _angular_core.Signal<boolean>;
     readonly classes: _angular_core.Signal<string>;
     constructor();
+    onPointerDown(event: Event): void;
     onHostClick(): void;
+    private spawnRipple;
     private attachSpinner;
     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; }; "buttonClass": { "alias": "dgaButtonClass"; "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; }; "effect": { "alias": "effect"; "required": false; "isSignal": true; }; "iconOnly": { "alias": "iconOnly"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "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';
@@ -281,18 +244,12 @@ declare class DgaAvatar {
 }
 
 /**
- * Curated inline icons for `@a.nemreen/dga-ui` chrome (buttons, fields, menus, …).
- * SVGs are vendored at build time — no runtime `@platformscode/icons` dependency.
- *
- * Content / editorial icons: opt into `@a.nemreen/dga-tokens/styles/icon-font.css` and use
- * `<dga-icon glyph="search-01" />` (or `hgi-stroke hgi-{name}` classes).
- *
- * Regenerated by: node scripts/vendor-dga-icons.mjs
+ * Icon name union + RTL-flip set. Kept off the SVG catalog so chrome
+ * components can import names without the HugeIcons glyph map.
  */
-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';
-declare const DGA_ICON_SVG: Record<DgaIconName, string>;
-declare const DGA_ICON_NAMES: DgaIconName[];
-declare const DGA_LOGICAL_ICON_NAMES: Set<DgaIconName>;
+declare const DGA_ICON_NAMES: readonly ["access", "alertCircle", "ambulance", "apple", "arrowDown", "arrowDown02", "arrowLeft", "arrowLeft02", "arrowNext", "arrowNext02", "arrowPrev", "arrowPrev02", "arrowRight", "arrowRight02", "arrowUp", "arrowUp02", "award", "badgeCheck", "bell", "bellAlt", "book", "bookType", "brain", "building", "calendar", "calendarAlt", "cart", "check", "checkCircle", "checkCircleAlt", "chevronDown", "chevronLeft", "chevronRight", "clock", "close", "cloud", "colorPicker", "colors", "cookie", "copy", "desert", "devices", "disability", "door", "download", "droplet", "error", "external", "eye", "eyeOff", "eyeOffSlash", "facebook", "filter", "fire", "flash", "folder", "glasses", "globe", "heading", "headphones", "helpCircle", "highlighter", "home", "huawei", "idCard", "info", "instagram", "letterSpacing", "link", "linkAlt", "linkedin", "location", "lock", "lockPassword", "logout", "mail", "mask", "maximize", "menu", "menuAlt", "message", "mic", "minus", "moon", "moonAlt", "moonCloud", "moreHorizontal", "moreVertical", "paintBoard", "pause", "phone", "playStore", "plus", "plusSign", "police", "printer", "rain", "rainZap", "refresh", "riyal", "search", "share", "shrink", "smartphone", "snow", "sort", "sortDown", "sortUp", "star", "starFilled", "success", "sun", "sunAlt", "sunCloud", "textAlign", "textFont", "textUnderline", "touch", "tradeDown", "tradeUp", "translation", "upload", "user", "users", "warning", "whatsapp", "wheelchair", "wind", "x", "youtube", "zoomIn", "zoomOut"];
+type DgaIconName = (typeof DGA_ICON_NAMES)[number];
+declare const DGA_LOGICAL_ICON_NAMES: Set<"link" | "menu" | "search" | "success" | "info" | "warning" | "error" | "access" | "alertCircle" | "ambulance" | "apple" | "arrowDown" | "arrowDown02" | "arrowLeft" | "arrowLeft02" | "arrowNext" | "arrowNext02" | "arrowPrev" | "arrowPrev02" | "arrowRight" | "arrowRight02" | "arrowUp" | "arrowUp02" | "award" | "badgeCheck" | "bell" | "bellAlt" | "book" | "bookType" | "brain" | "building" | "calendar" | "calendarAlt" | "cart" | "check" | "checkCircle" | "checkCircleAlt" | "chevronDown" | "chevronLeft" | "chevronRight" | "clock" | "close" | "cloud" | "colorPicker" | "colors" | "cookie" | "copy" | "desert" | "devices" | "disability" | "door" | "download" | "droplet" | "external" | "eye" | "eyeOff" | "eyeOffSlash" | "facebook" | "filter" | "fire" | "flash" | "folder" | "glasses" | "globe" | "heading" | "headphones" | "helpCircle" | "highlighter" | "home" | "huawei" | "idCard" | "instagram" | "letterSpacing" | "linkAlt" | "linkedin" | "location" | "lock" | "lockPassword" | "logout" | "mail" | "mask" | "maximize" | "menuAlt" | "message" | "mic" | "minus" | "moon" | "moonAlt" | "moonCloud" | "moreHorizontal" | "moreVertical" | "paintBoard" | "pause" | "phone" | "playStore" | "plus" | "plusSign" | "police" | "printer" | "rain" | "rainZap" | "refresh" | "riyal" | "share" | "shrink" | "smartphone" | "snow" | "sort" | "sortDown" | "sortUp" | "star" | "starFilled" | "sun" | "sunAlt" | "sunCloud" | "textAlign" | "textFont" | "textUnderline" | "touch" | "tradeDown" | "tradeUp" | "translation" | "upload" | "user" | "users" | "whatsapp" | "wheelchair" | "wind" | "x" | "youtube" | "zoomIn" | "zoomOut">;
 
 /**
  * Platforms Code icon sizes (px):
@@ -303,17 +260,22 @@ declare const DGA_LOGICAL_ICON_NAMES: Set<DgaIconName>;
  */
 type DgaIconSize = '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl';
 type DgaIconTone = 'current' | 'primary' | 'muted' | 'success' | 'warning' | 'error';
+/** Accept curated names plus app-registered custom names (keeps autocomplete for DgaIconName). */
+type DgaIconNameInput = DgaIconName | (string & {});
 declare class DgaIcon {
     private readonly sanitizer;
     private readonly iconFont;
+    private readonly registry;
     /**
-     * Curated inline SVG name for chrome / controls.
-     * Required unless `glyph` is set.
+     * Curated HugeIcons (Stroke Rounded) / DGA SVG name for chrome / controls.
+     * Required unless `glyph` is set. App teams may pass names registered via
+     * {@link provideDgaIcons} / {@link DgaIconRegistry.register}.
      */
-    readonly name: _angular_core.InputSignal<DgaIconName | undefined>;
+    readonly name: _angular_core.InputSignal<DgaIconNameInput | undefined>;
     /**
      * HugeIcons Stroke Rounded glyph id for content icons (e.g. `search-01`).
      * Requires `@import '@a.nemreen/dga-tokens/styles/icon-font.css'`.
+     * Prefer curated `name` for chrome controls so first paint does not wait on the font.
      */
     readonly glyph: _angular_core.InputSignal<string>;
     /** Default `sm` (16px) - common dense UI size; use `xl` (24px) for standard chrome. */
@@ -345,6 +307,57 @@ declare class DgaIconFontService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<DgaIconFontService>;
 }
 
+/**
+ * Multi-provider bag of SVG markup keyed by icon name.
+ * Prefer {@link provideDgaIcons} at app bootstrap.
+ */
+declare const DGA_ICON_OVERRIDES: InjectionToken<Readonly<Record<string, string>>[]>;
+/**
+ * Register additional or overriding SVG icons for `<dga-icon name="…">`.
+ *
+ * @example
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [
+ *     provideDgaIcons({
+ *       myBrand: `<svg …>…</svg>`,
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+declare function provideDgaIcons(icons: Readonly<Record<string, string>>): EnvironmentProviders;
+
+/**
+ * Resolves SVG markup for DgaIcon: runtime register → provideDgaIcons → HugeIcons/DGA catalog → core.
+ * Non-core catalog icons load once via a shared dynamic import (HugeIcons curated subset).
+ */
+declare class DgaIconRegistry {
+    private readonly providerOverrides;
+    private readonly runtime;
+    private readonly defaults;
+    private readonly loading;
+    private readonly provided;
+    /** Synchronous lookup — empty until defaults finish loading for non-core names. */
+    get(name: string): string;
+    /** True when the name is in the first-paint core map. */
+    isCore(name: string): boolean;
+    /**
+     * Ensure the HugeIcons + DGA default catalog is loaded when `name` is not core / provided.
+     * Safe to call repeatedly; shares one import promise.
+     */
+    ensureLoaded(name: string): void;
+    /**
+     * Register or override an icon at runtime (e.g. after a lazy feature loads).
+     * Prefer {@link provideDgaIcons} for bootstrap-time icons.
+     */
+    register(name: string, svg: string): void;
+    /** Register many icons at once. */
+    registerAll(icons: Readonly<Record<string, string>>): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaIconRegistry, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<DgaIconRegistry>;
+}
+
 type DgaIconBadgeSize = 'sm' | 'md' | 'lg' | 'xl';
 type DgaIconBadgeAppearance = 'filled' | 'outline';
 /**
@@ -409,9 +422,9 @@ declare class DgaFormControl {
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly filled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Built-in leading icon (logical start). */
-    readonly startIcon: _angular_core.InputSignal<DgaIconName | null>;
+    readonly startIcon: _angular_core.InputSignal<"link" | "menu" | "search" | "success" | "info" | "warning" | "error" | "access" | "alertCircle" | "ambulance" | "apple" | "arrowDown" | "arrowDown02" | "arrowLeft" | "arrowLeft02" | "arrowNext" | "arrowNext02" | "arrowPrev" | "arrowPrev02" | "arrowRight" | "arrowRight02" | "arrowUp" | "arrowUp02" | "award" | "badgeCheck" | "bell" | "bellAlt" | "book" | "bookType" | "brain" | "building" | "calendar" | "calendarAlt" | "cart" | "check" | "checkCircle" | "checkCircleAlt" | "chevronDown" | "chevronLeft" | "chevronRight" | "clock" | "close" | "cloud" | "colorPicker" | "colors" | "cookie" | "copy" | "desert" | "devices" | "disability" | "door" | "download" | "droplet" | "external" | "eye" | "eyeOff" | "eyeOffSlash" | "facebook" | "filter" | "fire" | "flash" | "folder" | "glasses" | "globe" | "heading" | "headphones" | "helpCircle" | "highlighter" | "home" | "huawei" | "idCard" | "instagram" | "letterSpacing" | "linkAlt" | "linkedin" | "location" | "lock" | "lockPassword" | "logout" | "mail" | "mask" | "maximize" | "menuAlt" | "message" | "mic" | "minus" | "moon" | "moonAlt" | "moonCloud" | "moreHorizontal" | "moreVertical" | "paintBoard" | "pause" | "phone" | "playStore" | "plus" | "plusSign" | "police" | "printer" | "rain" | "rainZap" | "refresh" | "riyal" | "share" | "shrink" | "smartphone" | "snow" | "sort" | "sortDown" | "sortUp" | "star" | "starFilled" | "sun" | "sunAlt" | "sunCloud" | "textAlign" | "textFont" | "textUnderline" | "touch" | "tradeDown" | "tradeUp" | "translation" | "upload" | "user" | "users" | "whatsapp" | "wheelchair" | "wind" | "x" | "youtube" | "zoomIn" | "zoomOut" | null>;
     /** Built-in trailing icon (logical end). */
-    readonly endIcon: _angular_core.InputSignal<DgaIconName | null>;
+    readonly endIcon: _angular_core.InputSignal<"link" | "menu" | "search" | "success" | "info" | "warning" | "error" | "access" | "alertCircle" | "ambulance" | "apple" | "arrowDown" | "arrowDown02" | "arrowLeft" | "arrowLeft02" | "arrowNext" | "arrowNext02" | "arrowPrev" | "arrowPrev02" | "arrowRight" | "arrowRight02" | "arrowUp" | "arrowUp02" | "award" | "badgeCheck" | "bell" | "bellAlt" | "book" | "bookType" | "brain" | "building" | "calendar" | "calendarAlt" | "cart" | "check" | "checkCircle" | "checkCircleAlt" | "chevronDown" | "chevronLeft" | "chevronRight" | "clock" | "close" | "cloud" | "colorPicker" | "colors" | "cookie" | "copy" | "desert" | "devices" | "disability" | "door" | "download" | "droplet" | "external" | "eye" | "eyeOff" | "eyeOffSlash" | "facebook" | "filter" | "fire" | "flash" | "folder" | "glasses" | "globe" | "heading" | "headphones" | "helpCircle" | "highlighter" | "home" | "huawei" | "idCard" | "instagram" | "letterSpacing" | "linkAlt" | "linkedin" | "location" | "lock" | "lockPassword" | "logout" | "mail" | "mask" | "maximize" | "menuAlt" | "message" | "mic" | "minus" | "moon" | "moonAlt" | "moonCloud" | "moreHorizontal" | "moreVertical" | "paintBoard" | "pause" | "phone" | "playStore" | "plus" | "plusSign" | "police" | "printer" | "rain" | "rainZap" | "refresh" | "riyal" | "share" | "shrink" | "smartphone" | "snow" | "sort" | "sortDown" | "sortUp" | "star" | "starFilled" | "sun" | "sunAlt" | "sunCloud" | "textAlign" | "textFont" | "textUnderline" | "touch" | "tradeDown" | "tradeUp" | "translation" | "upload" | "user" | "users" | "whatsapp" | "wheelchair" | "wind" | "x" | "youtube" | "zoomIn" | "zoomOut" | null>;
     private readonly focused;
     private readonly typing;
     readonly classes: _angular_core.Signal<string>;
@@ -473,6 +486,18 @@ declare class DgaRadio {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DgaRadio, "input[type=\"radio\"][dgaRadio]", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "invalid": { "alias": "dgaInvalid"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+type DgaChoiceLayout = 'column' | 'row';
+/**
+ * Lays out checkbox or radio options in a column, a wrapping row, or a
+ * fixed column count. Narrow screens always fall back to one column.
+ */
+declare class DgaChoiceGroup {
+    readonly layout: _angular_core.InputSignal<DgaChoiceLayout>;
+    readonly columns: _angular_core.InputSignalWithTransform<number | null, unknown>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaChoiceGroup, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DgaChoiceGroup, "[dgaChoiceGroup]", never, { "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 type DgaNativeSelectSize = DgaFormControlSize;
 /** Styles a native `<select dgaSelect>` — for simple forms without search/multi. */
 declare class DgaNativeSelect {
@@ -513,6 +538,12 @@ declare class DgaSelect implements ControlValueAccessor {
     readonly removeLabel: _angular_core.InputSignal<string>;
     readonly clearLabel: _angular_core.InputSignal<string>;
     readonly emptyLabel: _angular_core.InputSignal<string>;
+    /** Show a spinner row in the list (async / remote options). */
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** When searchable query matches no option, offer a “Create …” row. */
+    readonly creatable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Prefix/label for the create row; `{q}` is replaced with the query. */
+    readonly createLabel: _angular_core.InputSignal<string>;
     readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
     private readonly cvaDisabled;
     readonly disabled: _angular_core.Signal<boolean>;
@@ -520,11 +551,16 @@ declare class DgaSelect implements ControlValueAccessor {
     readonly valueChange: _angular_core.OutputEmitterRef<string | string[]>;
     /** Emitted when the searchable query changes (remote lookup fields). */
     readonly searchChange: _angular_core.OutputEmitterRef<string>;
+    /** Emitted when the user picks the creatable “Create …” option. */
+    readonly create: _angular_core.OutputEmitterRef<string>;
     private onChange;
     private onTouched;
     readonly open: _angular_core.WritableSignal<boolean>;
     readonly query: _angular_core.WritableSignal<string>;
     readonly activeIndex: _angular_core.WritableSignal<number>;
+    private readonly uiLocale;
+    private readonly ar;
+    readonly loadingLabel: _angular_core.Signal<"جاري التحميل…" | "Loading…">;
     constructor();
     readonly resolvedStatus: _angular_core.Signal<DgaFormStatus>;
     readonly listVisible: _angular_core.Signal<boolean>;
@@ -539,6 +575,7 @@ declare class DgaSelect implements ControlValueAccessor {
     hasValue(): boolean;
     optionId(index: number): string;
     isSelected(v: string): boolean;
+    isCreateOption(opt: DgaSelectOption): boolean;
     selectedValues(): string[];
     toggleOpen(): void;
     onFocus(): void;
@@ -558,8 +595,100 @@ declare class DgaSelect implements ControlValueAccessor {
     private moveActive;
     private firstEnabledIndex;
     private lastEnabledIndex;
+    private withCreateOption;
+    private formatCreateLabel;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaSelect, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaSelect, "dga-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "openMode": { "alias": "openMode"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "removeLabel": { "alias": "removeLabel"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "dgaInvalid"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "searchChange": "searchChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaSelect, "dga-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "openMode": { "alias": "openMode"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "removeLabel": { "alias": "removeLabel"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "creatable": { "alias": "creatable"; "required": false; "isSignal": true; }; "createLabel": { "alias": "createLabel"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "dgaInvalid"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "searchChange": "searchChange"; "create": "create"; }, never, never, true, never>;
+}
+
+interface DgaTreeItem {
+    id: string;
+    label: string;
+    children?: DgaTreeItem[];
+    disabled?: boolean;
+}
+/** Flatten tree in document order (parents before children). */
+declare function dgaFlattenTree(items: DgaTreeItem[]): DgaTreeItem[];
+/** Visible nodes given expanded ids (document order). */
+declare function dgaVisibleTreeNodes(items: DgaTreeItem[], expandedIds: ReadonlySet<string> | readonly string[]): DgaTreeItem[];
+/** Ancestors of `id` (nearest parent last), or empty if not found. */
+declare function dgaTreeAncestors(items: DgaTreeItem[], id: string): DgaTreeItem[];
+declare function dgaFindTreeItem(items: DgaTreeItem[], id: string): DgaTreeItem | null;
+/** Filter tree: keep nodes matching query (and their ancestors). */
+declare function dgaFilterTree(items: DgaTreeItem[], query: string): DgaTreeItem[];
+
+type DgaTreeSelectSize = DgaFormControlSize;
+/**
+ * Field trigger + popup tree. Single or multi; optional search filter; CVA.
+ *
+ * @example
+ * ```html
+ * <dga-tree-select
+ *   [items]="org"
+ *   [(value)]="selected"
+ *   [searchable]="true"
+ * />
+ * ```
+ */
+declare class DgaTreeSelect implements ControlValueAccessor {
+    private static nextId;
+    private readonly host;
+    readonly panelId: string;
+    readonly items: _angular_core.InputSignal<DgaTreeItem[]>;
+    /** Single: `string`. Multiple: `string[]`. */
+    readonly valueInput: _angular_core.InputSignal<string | string[]>;
+    readonly value: _angular_core.WritableSignal<string | string[]>;
+    readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly searchable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly size: _angular_core.InputSignal<DgaFormControlSize>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly cvaDisabled;
+    readonly disabled: _angular_core.Signal<boolean>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly placeholderInput: _angular_core.InputSignal<string>;
+    readonly emptyLabelInput: _angular_core.InputSignal<string>;
+    /** When true, only leaf nodes can be selected. */
+    readonly onlyLeaves: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly open: _angular_core.ModelSignal<boolean>;
+    readonly expandedIds: _angular_core.ModelSignal<string[]>;
+    readonly query: _angular_core.WritableSignal<string>;
+    readonly valueChange: _angular_core.OutputEmitterRef<string | string[]>;
+    readonly selectedIdList: _angular_core.Signal<string[]>;
+    readonly filteredItems: _angular_core.Signal<DgaTreeItem[]>;
+    readonly selectedItems: _angular_core.Signal<DgaTreeItem[]>;
+    readonly resolvedStatus: _angular_core.Signal<_a_nemreen_dga_ui.DgaFormStatus>;
+    private onChange;
+    private onTouched;
+    constructor();
+    resolvedPlaceholder(): string;
+    searchPlaceholder(): string;
+    treeLabel(): string;
+    emptyLabel(): string;
+    removeLabel(): string;
+    clearLabel(): string;
+    hasValue(): boolean;
+    triggerWrapClasses(): string;
+    searchInputClasses(): string;
+    buttonClasses(): string;
+    onType(raw: string): void;
+    openPanel(): void;
+    toggleOpen(): void;
+    closePanel(): void;
+    onBlur(): void;
+    onDocClick(event: MouseEvent): void;
+    onTriggerKey(event: KeyboardEvent): void;
+    onTreeSelect(ids: string[]): void;
+    remove(id: string): void;
+    clear(): void;
+    private commit;
+    writeValue(value: string | string[]): void;
+    registerOnChange(fn: (value: string | string[]) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaTreeSelect, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaTreeSelect, "dga-tree-select", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholderInput": { "alias": "placeholder"; "required": false; "isSignal": true; }; "emptyLabelInput": { "alias": "emptyLabel"; "required": false; "isSignal": true; }; "onlyLeaves": { "alias": "onlyLeaves"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "expandedIds": "expandedIdsChange"; "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
 /**
@@ -640,9 +769,16 @@ declare class DgaNumberInput implements ControlValueAccessor {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaNumberInput, "dga-number-input", never, { "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "stepSize": { "alias": "step"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "controlId": { "alias": "controlId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "incrementLabel": { "alias": "incrementLabel"; "required": false; "isSignal": true; }; "decrementLabel": { "alias": "decrementLabel"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "dgaInvalid"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
+type DgaSliderSize = 'sm' | 'md' | 'lg';
+/**
+ * Styles a native range input: primary fill, neutral track, circular thumb.
+ * The fill length is a CSS variable updated from the current value.
+ */
 declare class DgaSlider {
-    readonly size: _angular_core.InputSignal<"sm" | "md" | "lg">;
-    readonly classes: _angular_core.Signal<string>;
+    private readonly el;
+    readonly size: _angular_core.InputSignal<DgaSliderSize>;
+    constructor();
+    paint(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaSlider, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DgaSlider, "input[type=\"range\"][dgaSlider]", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -714,6 +850,177 @@ declare class DgaChipInput implements ControlValueAccessor {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaChipInput, "dga-chip-input", never, { "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "removeLabel": { "alias": "removeLabel"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "allowDuplicates": { "alias": "allowDuplicates"; "required": false; "isSignal": true; }; "invalid": { "alias": "dgaInvalid"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
+/**
+ * Saudi IBAN helpers (ISO 13616).
+ * SA IBANs are 24 characters: `SA` + 2 check digits + 20 BBAN chars.
+ */
+declare const DGA_IBAN_COUNTRY = "SA";
+declare const DGA_IBAN_LENGTH = 24;
+/** Strip spaces and force uppercase A–Z / 0–9. */
+declare function dgaNormalizeIban(raw: string): string;
+/** Format as groups of 4: `SA03 8000 0000 6080 1016 7519`. */
+declare function dgaFormatIban(raw: string): string;
+/**
+ * ISO 13616 mod-97 check.
+ * Move first 4 chars to the end, map A=10…Z=35, interpret as integer mod 97 === 1.
+ */
+declare function dgaIsValidIban(raw: string): boolean;
+
+/**
+ * Saudi IBAN field with grouping mask and ISO 13616 checksum.
+ * Always LTR so alphanumerics read left-to-right on RTL pages.
+ *
+ * @example
+ * ```html
+ * <dga-field label="IBAN">
+ *   <dga-iban-input [(value)]="iban" />
+ * </dga-field>
+ * ```
+ */
+declare class DgaIbanInput implements ControlValueAccessor {
+    /** Compact IBAN without spaces (`SA03…`). */
+    readonly value: _angular_core.ModelSignal<string>;
+    readonly controlId: _angular_core.InputSignal<string>;
+    readonly name: _angular_core.InputSignal<string>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Fixed country prefix shown before the editable remainder (default `SA`). */
+    readonly countryCode: _angular_core.InputSignal<string>;
+    readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly cvaDisabled;
+    readonly disabled: _angular_core.Signal<boolean>;
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly prefix: _angular_core.Signal<string>;
+    /** True when length is complete and mod-97 passes. */
+    readonly checksumValid: _angular_core.Signal<boolean>;
+    readonly displayValue: _angular_core.Signal<string>;
+    readonly resolvedStatus: _angular_core.Signal<_a_nemreen_dga_ui.DgaFormStatus>;
+    readonly groupClasses: _angular_core.Signal<string>;
+    private onChange;
+    onTouched: () => void;
+    onInput(raw: string): void;
+    writeValue(value: string): void;
+    registerOnChange(fn: (value: string) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaIbanInput, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaIbanInput, "dga-iban-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "controlId": { "alias": "controlId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "countryCode": { "alias": "countryCode"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+}
+
+/**
+ * Saudi National ID / Iqama helpers.
+ * 10 digits; starts with `1` (citizen) or `2` (resident); Luhn-style checksum.
+ */
+type DgaNationalIdKind = 'citizen' | 'resident' | 'unknown';
+declare function dgaNormalizeNationalId(raw: string): string;
+declare function dgaNationalIdKind(id: string): DgaNationalIdKind;
+/**
+ * Saudi ID checksum (even indices from the left are doubled; digits of product summed).
+ * Valid when the total sum is divisible by 10.
+ */
+declare function dgaIsValidNationalId(raw: string): boolean;
+/** Soft grouping for display: `1 234 567 890`. */
+declare function dgaFormatNationalId(raw: string): string;
+
+/**
+ * Saudi National ID / Iqama field (10 digits, checksum).
+ * Always LTR so digits read left-to-right on RTL pages.
+ *
+ * @example
+ * ```html
+ * <dga-field label="هوية وطنية">
+ *   <dga-national-id [(value)]="id" />
+ * </dga-field>
+ * ```
+ */
+declare class DgaNationalId implements ControlValueAccessor {
+    /** Compact 10-digit value. */
+    readonly value: _angular_core.ModelSignal<string>;
+    readonly controlId: _angular_core.InputSignal<string>;
+    readonly name: _angular_core.InputSignal<string>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly cvaDisabled;
+    readonly disabled: _angular_core.Signal<boolean>;
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly kind: _angular_core.Signal<DgaNationalIdKind>;
+    readonly checksumValid: _angular_core.Signal<boolean>;
+    readonly displayValue: _angular_core.Signal<string>;
+    readonly resolvedStatus: _angular_core.Signal<_a_nemreen_dga_ui.DgaFormStatus>;
+    readonly groupClasses: _angular_core.Signal<string>;
+    private onChange;
+    onTouched: () => void;
+    onInput(raw: string): void;
+    writeValue(value: string): void;
+    registerOnChange(fn: (value: string) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaNationalId, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaNationalId, "dga-national-id", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "controlId": { "alias": "controlId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+}
+
+type DgaPasswordStrength = 'empty' | 'weak' | 'fair' | 'good' | 'strong';
+interface DgaPasswordStrengthResult {
+    level: DgaPasswordStrength;
+    /** 0–4 score used for the meter fill. */
+    score: number;
+    checks: {
+        length: boolean;
+        lower: boolean;
+        upper: boolean;
+        digit: boolean;
+        special: boolean;
+    };
+}
+/** Heuristic password strength (not a substitute for server-side policy). */
+declare function dgaPasswordStrength(raw: string): DgaPasswordStrengthResult;
+
+/**
+ * Password field with show/hide toggle and optional strength meter.
+ *
+ * @example
+ * ```html
+ * <dga-field label="كلمة المرور">
+ *   <dga-password [(value)]="password" meter />
+ * </dga-field>
+ * ```
+ */
+declare class DgaPassword implements ControlValueAccessor {
+    readonly meterSegments: number[];
+    readonly value: _angular_core.ModelSignal<string>;
+    readonly controlId: _angular_core.InputSignal<string>;
+    readonly name: _angular_core.InputSignal<string>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Show strength meter under the field. */
+    readonly meter: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly cvaDisabled;
+    readonly disabled: _angular_core.Signal<boolean>;
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly revealed: _angular_core.WritableSignal<boolean>;
+    readonly strength: _angular_core.Signal<DgaPasswordStrengthResult>;
+    readonly meterId: _angular_core.Signal<string>;
+    readonly resolvedStatus: _angular_core.Signal<_a_nemreen_dga_ui.DgaFormStatus>;
+    readonly groupClasses: _angular_core.Signal<string>;
+    private onChange;
+    onTouched: () => void;
+    toggleLabel(): string;
+    strengthLabel(): string;
+    toggleReveal(): void;
+    onInput(raw: string): void;
+    writeValue(value: string): void;
+    registerOnChange(fn: (value: string) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaPassword, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaPassword, "dga-password", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "controlId": { "alias": "controlId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "meter": { "alias": "meter"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+}
+
 interface DgaUploadFile {
     id: string;
     name: string;
@@ -849,10 +1156,20 @@ declare class DgaAutocomplete {
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly status: _angular_core.InputSignal<DgaFormStatus>;
+    /** Async options in flight — spinner in the list. */
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Offer a “Create …” row when the query matches no option. */
+    readonly creatable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Create-row label; `{q}` is replaced with the query. */
+    readonly createLabel: _angular_core.InputSignal<string>;
     readonly valueChange: _angular_core.OutputEmitterRef<string>;
+    /** Emitted when the search query changes (remote lookup). */
+    readonly search: _angular_core.OutputEmitterRef<string>;
+    /** Emitted when the user picks the creatable option. */
+    readonly create: _angular_core.OutputEmitterRef<string>;
     onValueChange(next: string | string[]): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaAutocomplete, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaAutocomplete, "dga-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "dgaInvalid"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaAutocomplete, "dga-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "dgaInvalid"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "creatable": { "alias": "creatable"; "required": false; "isSignal": true; }; "createLabel": { "alias": "createLabel"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "search": "search"; "create": "create"; }, never, never, true, never>;
 }
 
 /** @deprecated Prefer `DgaSelectOption` — alias kept for existing imports. */
@@ -919,6 +1236,94 @@ declare class DgaTimePicker {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaTimePicker, "dga-time-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hourLabel": { "alias": "hourLabel"; "required": false; "isSignal": true; }; "minuteLabel": { "alias": "minuteLabel"; "required": false; "isSignal": true; }; "periodLabel": { "alias": "periodLabel"; "required": false; "isSignal": true; }; "amLabel": { "alias": "amLabel"; "required": false; "isSignal": true; }; "pmLabel": { "alias": "pmLabel"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "dgaInvalid"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
 
+/**
+ * Canvas signature pad for Saudi e-services.
+ *
+ * @example
+ * ```html
+ * <dga-signature-pad [(value)]="sig" label="التوقيع" />
+ * ```
+ */
+declare class DgaSignaturePad implements ControlValueAccessor {
+    private readonly canvasRef;
+    private readonly host;
+    readonly width: _angular_core.InputSignal<number>;
+    readonly height: _angular_core.InputSignal<number>;
+    readonly penColor: _angular_core.InputSignal<string>;
+    readonly lineWidth: _angular_core.InputSignal<number>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly clearLabel: _angular_core.InputSignal<string>;
+    readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly cvaDisabled;
+    readonly disabled: _angular_core.Signal<boolean>;
+    /** PNG data URL. */
+    readonly value: _angular_core.ModelSignal<string>;
+    private readonly uiLocale;
+    private readonly ar;
+    readonly hintText: _angular_core.Signal<"وقّع هنا" | "Sign here">;
+    readonly drawing: _angular_core.WritableSignal<boolean>;
+    private readonly stroked;
+    private lastX;
+    private lastY;
+    /** Skip restoring from `value` while we own the canvas. */
+    private localWrite;
+    private onChange;
+    private onTouched;
+    constructor();
+    readonly wrapClasses: _angular_core.Signal<string>;
+    isEmpty(): boolean;
+    clear(): void;
+    onPointerDown(event: PointerEvent): void;
+    onPointerMove(event: PointerEvent): void;
+    onPointerUp(event: PointerEvent): void;
+    onPointerLeave(event: PointerEvent): void;
+    writeValue(value: string): void;
+    registerOnChange(fn: (value: string) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    private emitStroke;
+    private commit;
+    private resetCanvasSurface;
+    private coords;
+    private resolvePenColor;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaSignaturePad, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaSignaturePad, "dga-signature-pad", never, { "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "penColor": { "alias": "penColor"; "required": false; "isSignal": true; }; "lineWidth": { "alias": "lineWidth"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+}
+
+type DgaRichTextCmd = 'bold' | 'italic' | 'underline' | 'insertUnorderedList' | 'insertOrderedList';
+/**
+ * Lightweight contenteditable rich-text field (bold / italic / underline / lists).
+ */
+declare class DgaRichText {
+    private readonly editorRef;
+    readonly value: _angular_core.ModelSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly minHeight: _angular_core.InputSignal<number>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly uiLocale;
+    private readonly ar;
+    private readonly syncing;
+    private readonly activeCmds;
+    readonly toolbarLabel: _angular_core.Signal<"شريط التنسيق" | "Formatting toolbar">;
+    readonly labels: _angular_core.Signal<{
+        bold: string;
+        italic: string;
+        underline: string;
+        ul: string;
+        ol: string;
+    }>;
+    constructor();
+    isActive(cmd: DgaRichTextCmd): boolean;
+    exec(cmd: DgaRichTextCmd): void;
+    onInput(): void;
+    onBlur(): void;
+    refreshActive(): void;
+    private emitFromEditor;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaRichText, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaRichText, "dga-rich-text", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "minHeight": { "alias": "minHeight"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+}
+
 type DgaDialogSize = 'sm' | 'md' | 'lg';
 declare class DgaDialog {
     private readonly injector;
@@ -947,6 +1352,46 @@ declare class DgaDialog {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaDialog, "dga-dialog", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; }, never, ["*", "[dgaDialogActions]"], true, never>;
 }
 
+type DgaConfirmTone = 'default' | 'danger';
+/**
+ * Standardized confirm dialog preset (cancel + confirm). Use `tone="danger"` for
+ * destructive deletes.
+ *
+ * @example
+ * ```html
+ * <dga-confirm
+ *   [(open)]="open"
+ *   tone="danger"
+ *   title="حذف الطلب؟"
+ *   message="لا يمكن التراجع عن هذا الإجراء."
+ *   (confirmed)="onDelete()"
+ * />
+ * ```
+ */
+declare class DgaConfirm {
+    readonly open: _angular_core.ModelSignal<boolean>;
+    readonly title: _angular_core.InputSignal<string>;
+    readonly message: _angular_core.InputSignal<string>;
+    readonly size: _angular_core.InputSignal<DgaDialogSize>;
+    readonly tone: _angular_core.InputSignal<DgaConfirmTone>;
+    readonly confirmLabel: _angular_core.InputSignal<string>;
+    readonly cancelLabel: _angular_core.InputSignal<string>;
+    readonly closeLabel: _angular_core.InputSignal<string>;
+    readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly confirmed: _angular_core.OutputEmitterRef<void>;
+    readonly cancelled: _angular_core.OutputEmitterRef<void>;
+    readonly confirmVariant: _angular_core.Signal<"primary" | "danger">;
+    defaultCloseLabel(): string;
+    defaultCancelLabel(): string;
+    defaultConfirmLabel(): string;
+    confirm(): void;
+    cancel(): void;
+    /** Escape / backdrop / X — `closed` only fires from those paths on `dga-dialog`. */
+    onDialogClosed(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaConfirm, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaConfirm, "dga-confirm", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "confirmLabel": { "alias": "confirmLabel"; "required": false; "isSignal": true; }; "cancelLabel": { "alias": "cancelLabel"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "confirmed": "confirmed"; "cancelled": "cancelled"; }, never, ["*"], true, never>;
+}
+
 type DgaModalSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
 type DgaModalAnimation = 'fade' | 'scale' | 'slide' | 'none';
 declare class DgaModal {
@@ -1053,7 +1498,7 @@ declare class DgaToast implements OnDestroy {
     /** 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 iconName: _angular_core.Signal<"link" | "menu" | "search" | "success" | "info" | "warning" | "error" | "access" | "alertCircle" | "ambulance" | "apple" | "arrowDown" | "arrowDown02" | "arrowLeft" | "arrowLeft02" | "arrowNext" | "arrowNext02" | "arrowPrev" | "arrowPrev02" | "arrowRight" | "arrowRight02" | "arrowUp" | "arrowUp02" | "award" | "badgeCheck" | "bell" | "bellAlt" | "book" | "bookType" | "brain" | "building" | "calendar" | "calendarAlt" | "cart" | "check" | "checkCircle" | "checkCircleAlt" | "chevronDown" | "chevronLeft" | "chevronRight" | "clock" | "close" | "cloud" | "colorPicker" | "colors" | "cookie" | "copy" | "desert" | "devices" | "disability" | "door" | "download" | "droplet" | "external" | "eye" | "eyeOff" | "eyeOffSlash" | "facebook" | "filter" | "fire" | "flash" | "folder" | "glasses" | "globe" | "heading" | "headphones" | "helpCircle" | "highlighter" | "home" | "huawei" | "idCard" | "instagram" | "letterSpacing" | "linkAlt" | "linkedin" | "location" | "lock" | "lockPassword" | "logout" | "mail" | "mask" | "maximize" | "menuAlt" | "message" | "mic" | "minus" | "moon" | "moonAlt" | "moonCloud" | "moreHorizontal" | "moreVertical" | "paintBoard" | "pause" | "phone" | "playStore" | "plus" | "plusSign" | "police" | "printer" | "rain" | "rainZap" | "refresh" | "riyal" | "share" | "shrink" | "smartphone" | "snow" | "sort" | "sortDown" | "sortUp" | "star" | "starFilled" | "sun" | "sunAlt" | "sunCloud" | "textAlign" | "textFont" | "textUnderline" | "touch" | "tradeDown" | "tradeUp" | "translation" | "upload" | "user" | "users" | "whatsapp" | "wheelchair" | "wind" | "x" | "youtube" | "zoomIn" | "zoomOut">;
     readonly iconTone: _angular_core.Signal<"success" | "warning" | "error" | "muted" | "current">;
     readonly showCountdown: _angular_core.Signal<boolean>;
     readonly reduceMotion: _angular_core.WritableSignal<boolean>;
@@ -1231,8 +1676,13 @@ declare class DgaMenu {
     readonly open: _angular_core.ModelSignal<boolean>;
     readonly triggerLabel: _angular_core.InputSignal<string>;
     /** Optional leading glyph (e.g. share on page heroes). */
-    readonly leadingIcon: _angular_core.InputSignal<DgaIconName | null>;
+    readonly leadingIcon: _angular_core.InputSignal<"link" | "menu" | "search" | "success" | "info" | "warning" | "error" | "access" | "alertCircle" | "ambulance" | "apple" | "arrowDown" | "arrowDown02" | "arrowLeft" | "arrowLeft02" | "arrowNext" | "arrowNext02" | "arrowPrev" | "arrowPrev02" | "arrowRight" | "arrowRight02" | "arrowUp" | "arrowUp02" | "award" | "badgeCheck" | "bell" | "bellAlt" | "book" | "bookType" | "brain" | "building" | "calendar" | "calendarAlt" | "cart" | "check" | "checkCircle" | "checkCircleAlt" | "chevronDown" | "chevronLeft" | "chevronRight" | "clock" | "close" | "cloud" | "colorPicker" | "colors" | "cookie" | "copy" | "desert" | "devices" | "disability" | "door" | "download" | "droplet" | "external" | "eye" | "eyeOff" | "eyeOffSlash" | "facebook" | "filter" | "fire" | "flash" | "folder" | "glasses" | "globe" | "heading" | "headphones" | "helpCircle" | "highlighter" | "home" | "huawei" | "idCard" | "instagram" | "letterSpacing" | "linkAlt" | "linkedin" | "location" | "lock" | "lockPassword" | "logout" | "mail" | "mask" | "maximize" | "menuAlt" | "message" | "mic" | "minus" | "moon" | "moonAlt" | "moonCloud" | "moreHorizontal" | "moreVertical" | "paintBoard" | "pause" | "phone" | "playStore" | "plus" | "plusSign" | "police" | "printer" | "rain" | "rainZap" | "refresh" | "riyal" | "share" | "shrink" | "smartphone" | "snow" | "sort" | "sortDown" | "sortUp" | "star" | "starFilled" | "sun" | "sunAlt" | "sunCloud" | "textAlign" | "textFont" | "textUnderline" | "touch" | "tradeDown" | "tradeUp" | "translation" | "upload" | "user" | "users" | "whatsapp" | "wheelchair" | "wind" | "x" | "youtube" | "zoomIn" | "zoomOut" | null>;
     readonly showChevron: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * `default` = bordered labeled trigger.
+     * `icon` = compact ghost icon button (table row actions).
+     */
+    readonly appearance: _angular_core.InputSignal<"default" | "icon">;
     /** Minimum panel width (e.g. share menus). */
     readonly menuMinWidth: _angular_core.InputSignal<string>;
     /** Emits the full selected item. */
@@ -1272,7 +1722,7 @@ declare class DgaMenu {
     private cssLengthToPx;
     private focusItem;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaMenu, never>;
-    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>;
+    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; }; "appearance": { "alias": "appearance"; "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';
@@ -1493,6 +1943,99 @@ declare class DgaDrawer {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaDrawer, "dga-drawer", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "side": { "alias": "side"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; }, never, ["*", "[dgaDrawerActions]"], true, never>;
 }
 
+type DgaBottomSheetSnap = 'peek' | 'half' | 'full';
+declare class DgaBottomSheet {
+    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>;
+    /** Controls max-height: peek 40%, half 60%, full 85%. */
+    readonly snap: _angular_core.InputSignal<DgaBottomSheetSnap>;
+    readonly closeLabel: _angular_core.InputSignal<string>;
+    readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    readonly titleId: string;
+    readonly dragging: _angular_core.WritableSignal<boolean>;
+    private readonly dragY;
+    private dragPointerId;
+    private dragStartY;
+    private previousFocus;
+    private previousBodyOverflow;
+    private previousHtmlOverflow;
+    private scrollLocked;
+    readonly maxHeight: _angular_core.Signal<string>;
+    readonly panelTransform: _angular_core.Signal<string | null>;
+    readonly panelClasses: _angular_core.Signal<string>;
+    constructor();
+    close(): void;
+    onBackdrop(): void;
+    onKeydown(event: KeyboardEvent): void;
+    onHandlePointerDown(event: PointerEvent): void;
+    onHandlePointerMove(event: PointerEvent): void;
+    onHandlePointerUp(event: PointerEvent): void;
+    private resetDrag;
+    private portalToBody;
+    private removePortaledRoot;
+    private focusInitial;
+    private trapFocus;
+    private getFocusable;
+    private lockScroll;
+    private unlockScroll;
+    private restoreFocus;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaBottomSheet, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaBottomSheet, "dga-bottom-sheet", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "snap": { "alias": "snap"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; }, never, ["*", "[dgaBottomSheetActions]"], true, never>;
+}
+
+/** Matches tooltip placements (logical start/end for RTL). */
+type DgaPopoverPlacement = 'top' | 'bottom' | 'start' | 'end';
+/**
+ * Anchored popover: default slot = trigger; project the panel with `[dgaPopoverPanel]`.
+ *
+ * @example
+ * ```html
+ * <dga-popover [(open)]="open" placement="bottom">
+ *   <button type="button">فتح</button>
+ *   <div dgaPopoverPanel class="p-xl">محتوى اللوحة</div>
+ * </dga-popover>
+ * ```
+ */
+declare class DgaPopover {
+    private readonly host;
+    private readonly destroyRef;
+    private readonly injector;
+    private readonly triggerRef;
+    private readonly panelRef;
+    readonly open: _angular_core.ModelSignal<boolean>;
+    readonly placement: _angular_core.InputSignal<DgaPopoverPlacement>;
+    readonly closeOnOutside: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly opened: _angular_core.OutputEmitterRef<void>;
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    readonly panelStyle: _angular_core.WritableSignal<Record<string, string>>;
+    private readonly seq;
+    readonly triggerId: string;
+    readonly panelId: string;
+    private readonly onReposition;
+    constructor();
+    panelClasses(): string;
+    onTriggerClick(event: MouseEvent): void;
+    onTriggerKey(event: KeyboardEvent): void;
+    onPanelKey(event: KeyboardEvent): void;
+    toggle(): void;
+    openPanel(): void;
+    close(restoreFocus?: boolean): void;
+    onDocumentPointer(event: PointerEvent): void;
+    onDocumentKeydown(event: KeyboardEvent): void;
+    private portalPanelToBody;
+    private detachPortaledPanel;
+    private focusPanel;
+    private syncPanelPosition;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaPopover, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaPopover, "dga-popover", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "closeOnOutside": { "alias": "closeOnOutside"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "opened": "opened"; "closed": "closed"; }, never, ["*", "[dgaPopoverPanel]"], true, never>;
+}
+
 interface DgaImagePopupImage {
     src: string;
     alt?: string;
@@ -1504,8 +2047,12 @@ type DgaImagePopupAnimation = 'fade' | 'scale' | 'slide' | 'zoom' | 'none';
 /** Cross-fade when changing the active image. */
 type DgaImagePopupImageTransition = 'fade' | 'none';
 declare class DgaImagePopup {
+    private readonly doc;
     private readonly injector;
+    private readonly host;
     private readonly panel;
+    /** Marks the in-page slot while the host is moved to `document.body`. */
+    private anchor;
     readonly images: _angular_core.InputSignal<DgaImagePopupSource[]>;
     readonly open: _angular_core.ModelSignal<boolean>;
     readonly activeIndex: _angular_core.ModelSignal<number>;
@@ -1548,6 +2095,9 @@ declare class DgaImagePopup {
     onKeydown(event: KeyboardEvent): void;
     onAnimationEnd(event: AnimationEvent): void;
     private finishClose;
+    /** Lift the host out of ancestor stacking contexts (docs header / sidebar). */
+    private portalHostToBody;
+    private restoreHost;
     private focusInitial;
     private trapFocus;
     private getFocusable;
@@ -1558,6 +2108,63 @@ 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>;
 }
 
+type DgaFilePreviewKind = 'image' | 'pdf' | 'unknown';
+/** Infer preview kind from MIME type and/or file name / URL path. */
+declare function dgaDetectFilePreviewKind(src: string, opts?: {
+    fileName?: string;
+    mimeType?: string;
+}): DgaFilePreviewKind;
+
+type DgaFilePreviewPresentation = 'inline' | 'dialog' | 'drawer';
+/**
+ * File preview for images and PDFs. Use `presentation="dialog"|"drawer"` with
+ * `[(open)]` for overlay mode, or `inline` for embedded preview.
+ *
+ * @example
+ * ```html
+ * <dga-file-preview
+ *   [(open)]="open"
+ *   presentation="dialog"
+ *   [src]="url"
+ *   fileName="receipt.pdf"
+ * />
+ * ```
+ */
+declare class DgaFilePreview {
+    private readonly sanitizer;
+    /** Object URL, remote URL, or data URL to preview. */
+    readonly src: _angular_core.InputSignal<string>;
+    /** Force kind, or `auto` to detect from name/MIME/URL. */
+    readonly type: _angular_core.InputSignal<"auto" | DgaFilePreviewKind>;
+    readonly fileName: _angular_core.InputSignal<string>;
+    readonly mimeType: _angular_core.InputSignal<string>;
+    readonly alt: _angular_core.InputSignal<string>;
+    readonly title: _angular_core.InputSignal<string>;
+    readonly presentation: _angular_core.InputSignal<DgaFilePreviewPresentation>;
+    /** Overlay open state (dialog / drawer). */
+    readonly open: _angular_core.ModelSignal<boolean>;
+    readonly dialogSize: _angular_core.InputSignal<DgaDialogSize>;
+    readonly drawerSide: _angular_core.InputSignal<DgaDrawerSide>;
+    readonly showDownload: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly downloadName: _angular_core.InputSignal<string>;
+    readonly closeLabelInput: _angular_core.InputSignal<string>;
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    readonly downloaded: _angular_core.OutputEmitterRef<string>;
+    readonly resolvedKind: _angular_core.Signal<DgaFilePreviewKind>;
+    readonly safePdfSrc: _angular_core.Signal<SafeResourceUrl | null>;
+    resolvedFileName(): string;
+    resolvedTitle(): string;
+    resolvedAlt(): string;
+    closeLabel(): string;
+    downloadLabel(): string;
+    unknownTitle(): string;
+    bodyClasses(): string;
+    hostInlineClasses(): string;
+    onDownload(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaFilePreview, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaFilePreview, "dga-file-preview", never, { "src": { "alias": "src"; "required": true; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "fileName": { "alias": "fileName"; "required": false; "isSignal": true; }; "mimeType": { "alias": "mimeType"; "required": false; "isSignal": true; }; "alt": { "alias": "alt"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "presentation": { "alias": "presentation"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "dialogSize": { "alias": "dialogSize"; "required": false; "isSignal": true; }; "drawerSide": { "alias": "drawerSide"; "required": false; "isSignal": true; }; "showDownload": { "alias": "showDownload"; "required": false; "isSignal": true; }; "downloadName": { "alias": "downloadName"; "required": false; "isSignal": true; }; "closeLabelInput": { "alias": "closeLabel"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; "downloaded": "downloaded"; }, never, never, true, never>;
+}
+
 /** Logical placements (RTL-aware via inset-inline). */
 type DgaTourPlacement = 'top' | 'bottom' | 'start' | 'end' | 'auto';
 type DgaTourPersist = 'local' | 'session' | 'none';
@@ -1686,7 +2293,7 @@ declare class DgaAlert {
     readonly textClasses: _angular_core.Signal<"flex flex-col gap-xs" | "min-w-0">;
     readonly titleClasses: _angular_core.Signal<string>;
     readonly descriptionClasses: _angular_core.Signal<string>;
-    readonly iconName: _angular_core.Signal<DgaIconName>;
+    readonly iconName: _angular_core.Signal<"link" | "menu" | "search" | "success" | "info" | "warning" | "error" | "access" | "alertCircle" | "ambulance" | "apple" | "arrowDown" | "arrowDown02" | "arrowLeft" | "arrowLeft02" | "arrowNext" | "arrowNext02" | "arrowPrev" | "arrowPrev02" | "arrowRight" | "arrowRight02" | "arrowUp" | "arrowUp02" | "award" | "badgeCheck" | "bell" | "bellAlt" | "book" | "bookType" | "brain" | "building" | "calendar" | "calendarAlt" | "cart" | "check" | "checkCircle" | "checkCircleAlt" | "chevronDown" | "chevronLeft" | "chevronRight" | "clock" | "close" | "cloud" | "colorPicker" | "colors" | "cookie" | "copy" | "desert" | "devices" | "disability" | "door" | "download" | "droplet" | "external" | "eye" | "eyeOff" | "eyeOffSlash" | "facebook" | "filter" | "fire" | "flash" | "folder" | "glasses" | "globe" | "heading" | "headphones" | "helpCircle" | "highlighter" | "home" | "huawei" | "idCard" | "instagram" | "letterSpacing" | "linkAlt" | "linkedin" | "location" | "lock" | "lockPassword" | "logout" | "mail" | "mask" | "maximize" | "menuAlt" | "message" | "mic" | "minus" | "moon" | "moonAlt" | "moonCloud" | "moreHorizontal" | "moreVertical" | "paintBoard" | "pause" | "phone" | "playStore" | "plus" | "plusSign" | "police" | "printer" | "rain" | "rainZap" | "refresh" | "riyal" | "share" | "shrink" | "smartphone" | "snow" | "sort" | "sortDown" | "sortUp" | "star" | "starFilled" | "sun" | "sunAlt" | "sunCloud" | "textAlign" | "textFont" | "textUnderline" | "touch" | "tradeDown" | "tradeUp" | "translation" | "upload" | "user" | "users" | "whatsapp" | "wheelchair" | "wind" | "x" | "youtube" | "zoomIn" | "zoomOut">;
     readonly iconTone: _angular_core.Signal<"success" | "warning" | "error" | "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>;
@@ -1916,116 +2523,134 @@ declare class DgaShare {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaShare, "dga-share", never, { "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "url": { "alias": "url"; "required": false; "isSignal": true; }; "shareTitle": { "alias": "shareTitle"; "required": false; "isSignal": true; }; "triggerLabel": { "alias": "triggerLabel"; "required": false; "isSignal": true; }; "iconOnly": { "alias": "iconOnly"; "required": false; "isSignal": true; }; "buttonVariant": { "alias": "buttonVariant"; "required": false; "isSignal": true; }; "buttonSize": { "alias": "buttonSize"; "required": false; "isSignal": true; }; }, { "shared": "shared"; "linkCopied": "linkCopied"; }, never, never, true, never>;
 }
 
-type DgaChatbotPosition = 'end' | 'start' | 'left' | 'right';
-type DgaChatbotAnimation = 'fade' | 'slide' | 'scale' | 'none';
-type DgaChatbotSize = 'sm' | 'md' | 'lg';
-type DgaChatbotFabTone = 'primary' | 'secondary';
-interface DgaChatbotMessage {
-    id: string;
-    role: 'bot' | 'user';
-    text: string;
+/**
+ * Print-ready region: wraps ticket/receipt content, hides page chrome on print,
+ * and triggers `window.print()`. Pair with `dga-qr` / `dga-barcode`.
+ *
+ * Mark non-printable chrome inside the region with class `dga-print-hide`
+ * (or put the trigger outside and call `print()`).
+ *
+ * @example
+ * ```html
+ * <dga-print documentTitle="Ticket #42">
+ *   <dga-qr value="…" />
+ *   <dga-barcode value="TKT-42" />
+ * </dga-print>
+ * ```
+ */
+declare class DgaPrint {
+    private readonly host;
+    private readonly destroyRef;
+    /** Document title while the print dialog is open. */
+    readonly documentTitle: _angular_core.InputSignal<string>;
+    /** `@page` margin token (CSS length). */
+    readonly margin: _angular_core.InputSignal<string>;
+    /** Show the built-in print button. */
+    readonly showTrigger: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Override trigger label (defaults to Print / طباعة). */
+    readonly triggerLabel: _angular_core.InputSignal<string>;
+    readonly beforePrint: _angular_core.OutputEmitterRef<void>;
+    readonly afterPrint: _angular_core.OutputEmitterRef<void>;
+    private readonly onAfterPrint;
+    private previousTitle;
+    private printing;
+    private fallbackTimer;
+    constructor();
+    hostClasses(): string;
+    resolvedTriggerLabel(): string;
+    /** Open the browser print dialog for this region. */
+    print(): void;
+    private cleanup;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaPrint, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaPrint, "dga-print", never, { "documentTitle": { "alias": "documentTitle"; "required": false; "isSignal": true; }; "margin": { "alias": "margin"; "required": false; "isSignal": true; }; "showTrigger": { "alias": "showTrigger"; "required": false; "isSignal": true; }; "triggerLabel": { "alias": "triggerLabel"; "required": false; "isSignal": true; }; }, { "beforePrint": "beforePrint"; "afterPrint": "afterPrint"; }, never, ["*"], true, never>;
 }
+
+type DgaOfflineMode = 'offline' | 'online' | 'both';
 /**
- * Floating live-chat launcher + panel. Place once near the app root
- * (beside `dga-scroll-top` / `dga-accessibility`).
+ * Connection status banner for field apps. Listens to `online` / `offline`
+ * events; override with `forceOffline` in demos.
+ *
+ * Distinct from site-wide `dga-announcement-bar` — this is a page/app status strip.
  *
- * Use `stack` so FABs share one vertical dock:
- * a11y `0` → chatbot `1` → scroll-top `2`.
+ * @example
+ * ```html
+ * <dga-offline sticky />
+ * ```
  */
-declare class DgaChatbot {
+declare class DgaOffline {
     private readonly destroyRef;
-    private readonly injector;
-    private readonly composerRef;
-    private readonly logRef;
-    /** Corner for FAB + panel. `end` / `start` follow reading direction. */
-    readonly position: _angular_core.InputSignal<DgaChatbotPosition>;
-    /** Panel enter animation. Honors `prefers-reduced-motion`. */
-    readonly animation: _angular_core.InputSignal<DgaChatbotAnimation>;
-    readonly size: _angular_core.InputSignal<DgaChatbotSize>;
-    readonly title: _angular_core.InputSignal<string>;
-    readonly subtitle: _angular_core.InputSignal<string>;
-    readonly fabLabel: _angular_core.InputSignal<string>;
-    readonly placeholder: _angular_core.InputSignal<string>;
-    readonly fabIcon: _angular_core.InputSignal<DgaIconName>;
-    /** Prefer a directional arrow so send ≠ chat bubble. */
-    readonly sendIcon: _angular_core.InputSignal<DgaIconName>;
-    readonly agentIcon: _angular_core.InputSignal<DgaIconName>;
-    readonly fabTone: _angular_core.InputSignal<DgaChatbotFabTone>;
-    /** Dim page behind the panel. */
-    readonly overlay: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Close when clicking the overlay. */
-    readonly overlayClose: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Green online dot on the agent avatar. */
-    readonly online: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Hide launcher while the panel is open (recommended). */
-    readonly hideFabWhenOpen: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /**
-     * 0-based slot in the shared FAB dock (bottom → top).
-     * Typical: a11y=0, chatbot=1, scroll-top=2.
-     */
-    readonly stack: _angular_core.InputSignalWithTransform<number, unknown>;
-    /**
-     * @deprecated Prefer `stack`. When true and `stack` is unset legacy path —
-     * kept for callers; `stack` wins.
-     */
-    readonly clearFab: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /**
-     * Anchor FAB/panel inside a relative parent (gallery / docs preview)
-     * instead of the viewport — avoids a second global FAB.
-     */
-    readonly embedded: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly initialMessages: _angular_core.InputSignal<readonly DgaChatbotMessage[]>;
-    readonly sent: _angular_core.OutputEmitterRef<string>;
-    readonly opened: _angular_core.OutputEmitterRef<void>;
-    readonly closed: _angular_core.OutputEmitterRef<void>;
-    readonly open: _angular_core.WritableSignal<boolean>;
-    readonly draft: _angular_core.WritableSignal<string>;
-    readonly messages: _angular_core.WritableSignal<DgaChatbotMessage[]>;
-    private readonly seq;
-    readonly panelId: string;
-    private msgSeq;
-    private seeded;
-    private prevOverflow;
-    readonly copy: _angular_core.Signal<{
-        title: string;
-        subtitle: string;
-        open: string;
-        close: string;
-        send: string;
-        input: string;
-        placeholder: string;
-        panelLabel: string;
-        welcome: string;
-    }>;
-    readonly fabBottom: _angular_core.Signal<string>;
-    readonly fabClasses: _angular_core.Signal<string>;
-    readonly panelClasses: _angular_core.Signal<string>;
+    /** Show when offline, when back online, or both. */
+    readonly mode: _angular_core.InputSignal<DgaOfflineMode>;
+    /** Sticky top strip (uses `--z-index-banner`). */
+    readonly sticky: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Allow dismissing the current state until connectivity changes. */
+    readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly dismissLabel: _angular_core.InputSignal<string>;
+    /** Override offline copy. */
+    readonly offlineMessage: _angular_core.InputSignal<string>;
+    /** Override online recovery copy. */
+    readonly onlineMessage: _angular_core.InputSignal<string>;
+    /** Demo / test override — when set, ignores navigator.onLine. */
+    readonly forceOffline: _angular_core.InputSignal<boolean | null>;
+    readonly onlineChange: _angular_core.OutputEmitterRef<boolean>;
+    readonly dismissed: _angular_core.OutputEmitterRef<void>;
+    private readonly navigatorOnline;
+    private readonly dismissedState;
+    readonly isOffline: _angular_core.Signal<boolean>;
+    readonly visible: _angular_core.Signal<boolean>;
+    readonly barClasses: _angular_core.Signal<string>;
     constructor();
-    private ensureSeed;
-    toggle(): void;
-    show(): void;
-    close(): void;
-    onBackdrop(): void;
-    onSubmit(event: Event): void;
-    private scrollLogToEnd;
-    private lockScroll;
-    private unlockScroll;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaChatbot, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaChatbot, "dga-chatbot", never, { "position": { "alias": "position"; "required": false; "isSignal": true; }; "animation": { "alias": "animation"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "fabLabel": { "alias": "fabLabel"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "fabIcon": { "alias": "fabIcon"; "required": false; "isSignal": true; }; "sendIcon": { "alias": "sendIcon"; "required": false; "isSignal": true; }; "agentIcon": { "alias": "agentIcon"; "required": false; "isSignal": true; }; "fabTone": { "alias": "fabTone"; "required": false; "isSignal": true; }; "overlay": { "alias": "overlay"; "required": false; "isSignal": true; }; "overlayClose": { "alias": "overlayClose"; "required": false; "isSignal": true; }; "online": { "alias": "online"; "required": false; "isSignal": true; }; "hideFabWhenOpen": { "alias": "hideFabWhenOpen"; "required": false; "isSignal": true; }; "stack": { "alias": "stack"; "required": false; "isSignal": true; }; "clearFab": { "alias": "clearFab"; "required": false; "isSignal": true; }; "embedded": { "alias": "embedded"; "required": false; "isSignal": true; }; "initialMessages": { "alias": "initialMessages"; "required": false; "isSignal": true; }; }, { "sent": "sent"; "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
+    resolvedMessage(): string;
+    defaultDismissLabel(): string;
+    dismiss(): void;
+    private setOnline;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaOffline, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaOffline, "dga-offline", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "sticky": { "alias": "sticky"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "dismissLabel": { "alias": "dismissLabel"; "required": false; "isSignal": true; }; "offlineMessage": { "alias": "offlineMessage"; "required": false; "isSignal": true; }; "onlineMessage": { "alias": "onlineMessage"; "required": false; "isSignal": true; }; "forceOffline": { "alias": "forceOffline"; "required": false; "isSignal": true; }; }, { "onlineChange": "onlineChange"; "dismissed": "dismissed"; }, never, never, true, never>;
 }
 
 /**
  * Visually hidden until focused — first tab stop for keyboard users.
  * Place near the top of the document; `href` should target main content id.
  */
-declare class DgaSkipLink {
+declare class DgaSkipLink {
+    private readonly uiLocale;
+    readonly href: _angular_core.InputSignal<string>;
+    readonly label: _angular_core.InputSignal<string | undefined>;
+    readonly resolvedLabel: _angular_core.Signal<string>;
+    safeHref(href: string | undefined | null): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaSkipLink, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaSkipLink, "dga-skip-link", never, { "href": { "alias": "href"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+interface DgaNotificationItem {
+    id: string;
+    title: string;
+    body?: string;
+    time?: string;
+    read?: boolean;
+    href?: string;
+}
+/**
+ * Page-level notification inbox (distinct from header overlay config).
+ */
+declare class DgaNotificationInbox {
     private readonly uiLocale;
-    readonly href: _angular_core.InputSignal<string>;
-    readonly label: _angular_core.InputSignal<string | undefined>;
-    readonly resolvedLabel: _angular_core.Signal<string>;
-    safeHref(href: string | undefined | null): string;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaSkipLink, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaSkipLink, "dga-skip-link", never, { "href": { "alias": "href"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    private readonly ar;
+    readonly items: _angular_core.InputSignal<DgaNotificationItem[]>;
+    readonly title: _angular_core.InputSignal<string | undefined>;
+    readonly itemClick: _angular_core.OutputEmitterRef<DgaNotificationItem>;
+    readonly markRead: _angular_core.OutputEmitterRef<DgaNotificationItem>;
+    readonly markAllRead: _angular_core.OutputEmitterRef<void>;
+    readonly resolvedTitle: _angular_core.Signal<string>;
+    readonly unreadCount: _angular_core.Signal<number>;
+    readonly markAllLabel: _angular_core.Signal<"تعيين الكل كمقروء" | "Mark all as read">;
+    readonly emptyTitle: _angular_core.Signal<"لا توجد إشعارات" | "No notifications">;
+    readonly emptyBody: _angular_core.Signal<"ستظهر الإشعارات الجديدة هنا." | "New notifications will appear here.">;
+    readonly unreadLabel: _angular_core.Signal<"غير مقروء" | "Unread">;
+    itemClass(item: DgaNotificationItem): string;
+    onItem(item: DgaNotificationItem): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaNotificationInbox, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaNotificationInbox, "dga-notification-inbox", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; }, { "itemClick": "itemClick"; "markRead": "markRead"; "markAllRead": "markAllRead"; }, never, never, true, never>;
 }
 
 declare class DgaAccordionItem {
@@ -2256,6 +2881,8 @@ declare class DgaStepper {
     readonly steps: _angular_core.InputSignal<DgaStep[]>;
     readonly active: _angular_core.ModelSignal<number>;
     readonly label: _angular_core.InputSignal<string>;
+    /** Pulses the current step. Off unless set, and skipped when motion is reduced. */
+    readonly animate: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
      * Optional veto for step clicks (e.g. form wizard validation).
      * Return false to keep the current step.
@@ -2268,7 +2895,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; }; "beforeActiveChange": { "alias": "beforeActiveChange"; "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; }; "animate": { "alias": "animate"; "required": false; "isSignal": true; }; "beforeActiveChange": { "alias": "beforeActiveChange"; "required": false; "isSignal": true; }; }, { "active": "activeChange"; }, never, never, true, never>;
 }
 
 interface DgaTocItem {
@@ -2287,6 +2914,56 @@ declare class DgaToc {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaToc, "dga-toc", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "activeId": { "alias": "activeId"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "activeId": "activeIdChange"; "navigate": "navigate"; }, never, never, true, never>;
 }
 
+/**
+ * Accessible tree view (WAI-ARIA tree). Expand/collapse, keyboard navigation,
+ * optional single or multi select.
+ *
+ * @example
+ * ```html
+ * <dga-tree
+ *   [items]="org"
+ *   [(expandedIds)]="expanded"
+ *   [(selectedIds)]="selected"
+ * />
+ * ```
+ */
+declare class DgaTree {
+    private static seq;
+    private readonly host;
+    private readonly uid;
+    readonly items: _angular_core.InputSignal<DgaTreeItem[]>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly expandedIds: _angular_core.ModelSignal<string[]>;
+    readonly selectedIds: _angular_core.ModelSignal<string[]>;
+    readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly selectable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Expand a node when it becomes selected. */
+    readonly expandOnSelect: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly selectionChange: _angular_core.OutputEmitterRef<string[]>;
+    readonly expandChange: _angular_core.OutputEmitterRef<string[]>;
+    readonly focusId: _angular_core.WritableSignal<string | null>;
+    readonly expandedSet: _angular_core.Signal<Set<string>>;
+    readonly selectedSet: _angular_core.Signal<Set<string>>;
+    readonly visibleNodes: _angular_core.Signal<DgaTreeItem[]>;
+    resolvedLabel(): string;
+    nodeDomId(id: string): string;
+    hasChildren(item: DgaTreeItem): boolean;
+    isExpanded(id: string): boolean;
+    isSelected(id: string): boolean;
+    twistIcon(id: string): 'chevronDown' | 'chevronLeft' | 'chevronRight';
+    expandAria(item: DgaTreeItem): string;
+    onNodeFocus(id: string): void;
+    onNodeClick(item: DgaTreeItem, event: MouseEvent): void;
+    toggleExpand(id: string, event?: Event): void;
+    selectNode(id: string): void;
+    onTreeKey(event: KeyboardEvent): void;
+    private parentOf;
+    private moveFocus;
+    private focusNode;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaTree, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaTree, "dga-tree", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "expandOnSelect": { "alias": "expandOnSelect"; "required": false; "isSignal": true; }; }, { "expandedIds": "expandedIdsChange"; "selectedIds": "selectedIdsChange"; "selectionChange": "selectionChange"; "expandChange": "expandChange"; }, never, never, true, never>;
+}
+
 interface DgaSideNavItem {
     label: string;
     value: string;
@@ -2427,7 +3104,7 @@ 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" | "left" | "right" | null>;
+    readonly edgeAttr: _angular_core.Signal<"left" | "start" | "end" | "right" | null>;
     readonly offsetCss: _angular_core.Signal<string>;
     readonly tooltipPlacement: _angular_core.Signal<"start" | "end">;
     readonly iconSize: _angular_core.Signal<"sm" | "md" | "lg">;
@@ -2467,6 +3144,54 @@ declare class DgaFilterBar {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaFilterBar, "dga-filter-bar", never, { "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "activeIds": { "alias": "activeIds"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; }, { "activeIds": "activeIdsChange"; }, never, never, true, never>;
 }
 
+type DgaSearchBarSize = DgaFormControlSize;
+/**
+ * Composed search chrome: leading icon, field, clear, and submit.
+ * Distinct from `dga-autocomplete` (suggestion picker).
+ *
+ * @example
+ * ```html
+ * <dga-search-bar
+ *   [(value)]="q"
+ *   [placeholder]="'Search services'"
+ *   (submit)="onSearch($event)"
+ * />
+ * ```
+ */
+declare class DgaSearchBar implements ControlValueAccessor {
+    readonly value: _angular_core.ModelSignal<string>;
+    readonly controlId: _angular_core.InputSignal<string>;
+    readonly name: _angular_core.InputSignal<string>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly submitLabelInput: _angular_core.InputSignal<string>;
+    readonly size: _angular_core.InputSignal<DgaFormControlSize>;
+    readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly showSubmit: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly cvaDisabled;
+    readonly disabled: _angular_core.Signal<boolean>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly submit: _angular_core.OutputEmitterRef<string>;
+    readonly cleared: _angular_core.OutputEmitterRef<void>;
+    readonly resolvedStatus: _angular_core.Signal<_a_nemreen_dga_ui.DgaFormStatus>;
+    readonly groupClasses: _angular_core.Signal<string>;
+    private onChange;
+    onTouched: () => void;
+    resolvedLabel(): string;
+    submitLabel(): string;
+    clearAria(): string;
+    onInput(raw: string): void;
+    onClear(): void;
+    onSubmit(event: Event): void;
+    writeValue(value: string): void;
+    registerOnChange(fn: (value: string) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaSearchBar, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaSearchBar, "dga-search-bar", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "controlId": { "alias": "controlId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "submitLabelInput": { "alias": "submitLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "showSubmit": { "alias": "showSubmit"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "submit": "submit"; "cleared": "cleared"; }, never, never, true, never>;
+}
+
 declare class DgaToolbar {
     readonly label: _angular_core.InputSignal<string>;
     readonly barClasses: _angular_core.Signal<string>;
@@ -2568,7 +3293,7 @@ declare class DgaCard {
     /** Clamp description lines (0 = no clamp). */
     readonly descriptionClamp: _angular_core.InputSignal<number>;
     /** Featured logo icon (renders `dga-icon-badge` unless `[dgaCardLead]` is projected). */
-    readonly icon: _angular_core.InputSignal<DgaIconName | null>;
+    readonly icon: _angular_core.InputSignal<"link" | "menu" | "search" | "success" | "info" | "warning" | "error" | "access" | "alertCircle" | "ambulance" | "apple" | "arrowDown" | "arrowDown02" | "arrowLeft" | "arrowLeft02" | "arrowNext" | "arrowNext02" | "arrowPrev" | "arrowPrev02" | "arrowRight" | "arrowRight02" | "arrowUp" | "arrowUp02" | "award" | "badgeCheck" | "bell" | "bellAlt" | "book" | "bookType" | "brain" | "building" | "calendar" | "calendarAlt" | "cart" | "check" | "checkCircle" | "checkCircleAlt" | "chevronDown" | "chevronLeft" | "chevronRight" | "clock" | "close" | "cloud" | "colorPicker" | "colors" | "cookie" | "copy" | "desert" | "devices" | "disability" | "door" | "download" | "droplet" | "external" | "eye" | "eyeOff" | "eyeOffSlash" | "facebook" | "filter" | "fire" | "flash" | "folder" | "glasses" | "globe" | "heading" | "headphones" | "helpCircle" | "highlighter" | "home" | "huawei" | "idCard" | "instagram" | "letterSpacing" | "linkAlt" | "linkedin" | "location" | "lock" | "lockPassword" | "logout" | "mail" | "mask" | "maximize" | "menuAlt" | "message" | "mic" | "minus" | "moon" | "moonAlt" | "moonCloud" | "moreHorizontal" | "moreVertical" | "paintBoard" | "pause" | "phone" | "playStore" | "plus" | "plusSign" | "police" | "printer" | "rain" | "rainZap" | "refresh" | "riyal" | "share" | "shrink" | "smartphone" | "snow" | "sort" | "sortDown" | "sortUp" | "star" | "starFilled" | "sun" | "sunAlt" | "sunCloud" | "textAlign" | "textFont" | "textUnderline" | "touch" | "tradeDown" | "tradeUp" | "translation" | "upload" | "user" | "users" | "whatsapp" | "wheelchair" | "wind" | "x" | "youtube" | "zoomIn" | "zoomOut" | null>;
     readonly iconSize: _angular_core.InputSignal<DgaIconBadgeSize>;
     readonly iconAppearance: _angular_core.InputSignal<DgaIconBadgeAppearance>;
     readonly badges: _angular_core.InputSignal<DgaCardBadge[]>;
@@ -2607,7 +3332,7 @@ declare class DgaCardMedia {
     readonly src: _angular_core.InputSignal<string>;
     readonly alt: _angular_core.InputSignal<string>;
     /** Aspect ratio utility; default 16/10 portal news cards. */
-    readonly ratio: _angular_core.InputSignal<"video" | "wide" | "square">;
+    readonly ratio: _angular_core.InputSignal<"video" | "square" | "wide">;
     readonly classes: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaCardMedia, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaCardMedia, "dga-card-media", never, { "src": { "alias": "src"; "required": false; "isSignal": true; }; "alt": { "alias": "alt"; "required": false; "isSignal": true; }; "ratio": { "alias": "ratio"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -2972,10 +3697,15 @@ interface DgaHeroSlide {
 }
 declare class DgaHero {
     private readonly destroyRef;
+    private readonly host;
+    private readonly doc;
+    private readonly swipe;
     private autoplayTimer;
     private readonly autoplayPaused;
     /** Skip CSS transitions on first layout so slides don't animate in like a locale wipe. */
     private readonly motionReady;
+    /** First portal image already hinted in `<head>`, so later slides don't compete. */
+    private lcpPreloadHref;
     /** Single-slide API. */
     readonly title: _angular_core.InputSignal<string>;
     readonly description: _angular_core.InputSignal<string>;
@@ -3029,6 +3759,8 @@ declare class DgaHero {
     portalCtaVariant(): 'inverse' | 'primary';
     /** Secondary is always outline - inverse outline on dark portal surfaces. */
     secondaryCtaVariant(): 'outlineInverse' | 'outline';
+    /** Off-screen carousel slides stay in the DOM for the push animation. */
+    slideInactive(i: number): boolean;
     slideShellClass(i: number): string;
     clampedIndex(): number;
     activeTitle(): string;
@@ -3054,6 +3786,15 @@ declare class DgaHero {
     goSlide(i: number): void;
     nextSlide(): void;
     prevSlide(): void;
+    onPointerDown(event: PointerEvent): void;
+    onPointerMove(event: PointerEvent): void;
+    onPointerUp(event: PointerEvent): void;
+    onPointerCancel(event: PointerEvent): void;
+    private isRtl;
+    /** Portal background that should win LCP. Carousels hint the first slide only. */
+    private lcpImage;
+    private mountLcpPreload;
+    private upsertImagePreload;
     pauseAutoplay(): void;
     resumeAutoplay(): void;
     onPrimary(index?: number): void;
@@ -3110,7 +3851,7 @@ declare class DgaAnnouncementBar {
     readonly align: _angular_core.InputSignal<DgaAnnouncementAlign>;
     readonly actionVariant: _angular_core.InputSignal<DgaAnnouncementActionVariant>;
     readonly elevation: _angular_core.InputSignal<DgaAnnouncementElevation>;
-    readonly icon: _angular_core.InputSignal<DgaIconName | null>;
+    readonly icon: _angular_core.InputSignal<"link" | "menu" | "search" | "success" | "info" | "warning" | "error" | "access" | "alertCircle" | "ambulance" | "apple" | "arrowDown" | "arrowDown02" | "arrowLeft" | "arrowLeft02" | "arrowNext" | "arrowNext02" | "arrowPrev" | "arrowPrev02" | "arrowRight" | "arrowRight02" | "arrowUp" | "arrowUp02" | "award" | "badgeCheck" | "bell" | "bellAlt" | "book" | "bookType" | "brain" | "building" | "calendar" | "calendarAlt" | "cart" | "check" | "checkCircle" | "checkCircleAlt" | "chevronDown" | "chevronLeft" | "chevronRight" | "clock" | "close" | "cloud" | "colorPicker" | "colors" | "cookie" | "copy" | "desert" | "devices" | "disability" | "door" | "download" | "droplet" | "external" | "eye" | "eyeOff" | "eyeOffSlash" | "facebook" | "filter" | "fire" | "flash" | "folder" | "glasses" | "globe" | "heading" | "headphones" | "helpCircle" | "highlighter" | "home" | "huawei" | "idCard" | "instagram" | "letterSpacing" | "linkAlt" | "linkedin" | "location" | "lock" | "lockPassword" | "logout" | "mail" | "mask" | "maximize" | "menuAlt" | "message" | "mic" | "minus" | "moon" | "moonAlt" | "moonCloud" | "moreHorizontal" | "moreVertical" | "paintBoard" | "pause" | "phone" | "playStore" | "plus" | "plusSign" | "police" | "printer" | "rain" | "rainZap" | "refresh" | "riyal" | "share" | "shrink" | "smartphone" | "snow" | "sort" | "sortDown" | "sortUp" | "star" | "starFilled" | "sun" | "sunAlt" | "sunCloud" | "textAlign" | "textFont" | "textUnderline" | "touch" | "tradeDown" | "tradeUp" | "translation" | "upload" | "user" | "users" | "whatsapp" | "wheelchair" | "wind" | "x" | "youtube" | "zoomIn" | "zoomOut" | null>;
     readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly dismissLabel: _angular_core.InputSignal<string>;
     readonly actionLabel: _angular_core.InputSignal<string>;
@@ -3258,6 +3999,68 @@ declare class DgaLogoTile {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaLogoTile, "dga-logo-tile", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "src": { "alias": "src"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+type DgaThemeToggleSurface = 'default' | 'compact';
+/**
+ * Dark / light theme toggle wired to {@link DgaThemeService}.
+ * Bind icons and labels to `themeChanges` (updated when the reveal commits).
+ *
+ * @example
+ * ```html
+ * <dga-theme-toggle />
+ * <dga-theme-toggle surface="compact" />
+ * ```
+ */
+declare class DgaThemeToggle {
+    private readonly theme;
+    /** Tooltip / aria when switching *to* dark. */
+    readonly darkLabel: _angular_core.InputSignal<string>;
+    /** Tooltip / aria when switching *to* light. */
+    readonly lightLabel: _angular_core.InputSignal<string>;
+    /** Hit-target sizing. */
+    readonly surface: _angular_core.InputSignal<DgaThemeToggleSurface>;
+    readonly isDark: _angular_core.Signal<boolean>;
+    readonly label: _angular_core.Signal<string>;
+    readonly btnSize: _angular_core.Signal<"sm" | "md">;
+    readonly iconSize: _angular_core.Signal<"sm" | "md">;
+    readonly actionClass: _angular_core.Signal<string>;
+    onToggle(event: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaThemeToggle, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaThemeToggle, "dga-theme-toggle", never, { "darkLabel": { "alias": "darkLabel"; "required": false; "isSignal": true; }; "lightLabel": { "alias": "lightLabel"; "required": false; "isSignal": true; }; "surface": { "alias": "surface"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Language picker listing registered locales from {@link DgaLocaleService}.
+ * Closes on outside pointer / Escape. Dropdown is absolutely positioned.
+ *
+ * @example
+ * ```html
+ * <dga-locale-toggle />
+ * <dga-locale-toggle tooltipLabel="Language" />
+ * ```
+ */
+declare class DgaLocaleToggle {
+    private readonly localeService;
+    private readonly hostRef;
+    private readonly destroyRef;
+    /** Override the automatic “Language: …” tooltip. */
+    readonly tooltipLabel: _angular_core.InputSignal<string | undefined>;
+    readonly locales: readonly _a_nemreen_dga_tokens.DgaLocaleDefinition[];
+    readonly open: _angular_core.WritableSignal<boolean>;
+    readonly locale: _angular_core.Signal<string>;
+    private readonly seq;
+    readonly listId: string;
+    readonly triggerClass: string;
+    readonly menuClass: string;
+    readonly tooltip: _angular_core.Signal<string>;
+    constructor();
+    toggleMenu(event: Event): void;
+    pick(code: DgaLocale, event: Event): void;
+    onDocPointer(event: PointerEvent): void;
+    onEscape(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaLocaleToggle, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaLocaleToggle, "dga-locale-toggle", never, { "tooltipLabel": { "alias": "tooltipLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 declare class DgaPersona {
     readonly name: _angular_core.InputSignal<string>;
     readonly subtitle: _angular_core.InputSignal<string>;
@@ -3509,6 +4312,198 @@ declare class DgaRiyal {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaRiyal, "dga-riyal", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "amount": { "alias": "amount"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+type DgaQrErrorCorrection = 'L' | 'M' | 'Q' | 'H';
+interface DgaQrMatrix {
+    /** Modules per side (21–177). */
+    size: number;
+    /** modules[y][x] — true = dark. */
+    modules: boolean[][];
+}
+/**
+ * Encode text/URL into a QR module matrix.
+ * Throws RangeError when the payload exceeds QR capacity.
+ */
+declare function dgaEncodeQr(text: string, errorCorrection?: DgaQrErrorCorrection): DgaQrMatrix;
+
+type DgaQrView = 'svg' | 'canvas' | 'img';
+type DgaQrSizeToken = 'sm' | 'md' | 'lg' | 'xl';
+type DgaQrSize = DgaQrSizeToken | number;
+type DgaQrAnimate = 'none' | 'fade' | 'scale' | 'reveal';
+
+/**
+ * QR code generator: pass a URL/text via `value` and it renders automatically.
+ *
+ * @example
+ * ```html
+ * <dga-qr value="https://example.gov.sa" size="md" [actions]="true" />
+ * <dga-qr value="https://example.gov.sa" view="canvas" color="#006c35" animate="scale" />
+ * ```
+ */
+declare class DgaQr {
+    private readonly toasts;
+    private readonly canvasEl;
+    /** Payload to encode (URL or any text). */
+    readonly value: _angular_core.InputSignal<string>;
+    /** Render target. */
+    readonly view: _angular_core.InputSignal<DgaQrView>;
+    /** Token size or pixel length. */
+    readonly size: _angular_core.InputSignal<DgaQrSize>;
+    /** Dark module color. */
+    readonly color: _angular_core.InputSignal<string>;
+    /** Light / background color. */
+    readonly background: _angular_core.InputSignal<string>;
+    /** Error correction level. */
+    readonly errorCorrection: _angular_core.InputSignal<DgaQrErrorCorrection>;
+    /** Quiet-zone modules around the symbol. */
+    readonly margin: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Accessible label when the QR is meaningful alone. */
+    readonly label: _angular_core.InputSignal<string>;
+    /** Show Download + Copy buttons. */
+    readonly actions: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Load-in animation; replays when `value` changes. */
+    readonly animate: _angular_core.InputSignal<DgaQrAnimate>;
+    /** Download filename base (extension added automatically). */
+    readonly downloadName: _angular_core.InputSignal<string>;
+    readonly ready: _angular_core.OutputEmitterRef<DgaQrMatrix>;
+    readonly downloaded: _angular_core.OutputEmitterRef<string>;
+    readonly copied: _angular_core.OutputEmitterRef<string>;
+    readonly matrix: _angular_core.WritableSignal<DgaQrMatrix | null>;
+    readonly playTick: _angular_core.WritableSignal<number>;
+    readonly imgSrc: _angular_core.WritableSignal<string>;
+    readonly sizeToken: _angular_core.Signal<DgaQrSizeToken | null>;
+    readonly pixelSize: _angular_core.Signal<number>;
+    readonly sizeCss: _angular_core.Signal<string>;
+    readonly svgViewBox: _angular_core.Signal<string>;
+    readonly svgPath: _angular_core.Signal<string>;
+    constructor();
+    hostClasses(): string;
+    frameClasses(): string;
+    actionsLabel(): string;
+    downloadLabel(): string;
+    copyLabel(): string;
+    onCopy(): Promise<void>;
+    onDownload(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaQr, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaQr, "dga-qr", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; "view": { "alias": "view"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "background": { "alias": "background"; "required": false; "isSignal": true; }; "errorCorrection": { "alias": "errorCorrection"; "required": false; "isSignal": true; }; "margin": { "alias": "margin"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "actions": { "alias": "actions"; "required": false; "isSignal": true; }; "animate": { "alias": "animate"; "required": false; "isSignal": true; }; "downloadName": { "alias": "downloadName"; "required": false; "isSignal": true; }; }, { "ready": "ready"; "downloaded": "downloaded"; "copied": "copied"; }, never, never, true, never>;
+}
+
+/**
+ * Compact Code 128 encoder (Code Set B + Auto C for digit pairs).
+ * Patterns follow ISO/IEC 15417. Zero npm deps — same approach as dga-qr.
+ */
+interface DgaBarcodeMatrix {
+    /** Bar/space modules left→right (true = bar). Includes quiet zones. */
+    modules: boolean[];
+    /** Human-readable payload that was encoded. */
+    text: string;
+    /** Quiet-zone modules on each side. */
+    quietZone: number;
+}
+/**
+ * Encode text as Code 128 (auto B/C). Throws if a character cannot be encoded.
+ */
+declare function dgaEncodeBarcode(text: string, quietZone?: number): DgaBarcodeMatrix;
+
+type DgaBarcodeFormat = 'code128';
+/**
+ * Linear barcode (Code 128). Pair with `dga-qr` on tickets and receipts.
+ *
+ * @example
+ * ```html
+ * <dga-barcode value="TKT-2026-0042" [displayValue]="true" [actions]="true" />
+ * ```
+ */
+declare class DgaBarcode {
+    /** Payload to encode (ASCII printable). */
+    readonly value: _angular_core.InputSignal<string>;
+    /** Symbology — Code 128 only for now. */
+    readonly format: _angular_core.InputSignal<"code128">;
+    /** Bar height in CSS pixels. */
+    readonly height: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Module (bar unit) width in CSS pixels. */
+    readonly moduleWidth: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Quiet-zone modules on each side. */
+    readonly quietZone: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Show human-readable text under the bars. */
+    readonly displayValue: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Bar color. */
+    readonly color: _angular_core.InputSignal<string>;
+    /** Background / quiet-zone color. */
+    readonly background: _angular_core.InputSignal<string>;
+    /** Accessible label when the barcode is meaningful alone. */
+    readonly label: _angular_core.InputSignal<string>;
+    /** Show download action. */
+    readonly actions: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Download filename base. */
+    readonly downloadName: _angular_core.InputSignal<string>;
+    readonly ready: _angular_core.OutputEmitterRef<DgaBarcodeMatrix>;
+    readonly downloaded: _angular_core.OutputEmitterRef<string>;
+    readonly matrix: _angular_core.WritableSignal<DgaBarcodeMatrix | null>;
+    readonly barHeight: _angular_core.Signal<number>;
+    readonly modulePx: _angular_core.Signal<number>;
+    readonly svgWidth: _angular_core.Signal<number>;
+    readonly svgViewBox: _angular_core.Signal<string>;
+    readonly svgPath: _angular_core.Signal<string>;
+    constructor();
+    hostClasses(): string;
+    actionsLabel(): string;
+    downloadLabel(): string;
+    onDownload(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaBarcode, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaBarcode, "dga-barcode", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "moduleWidth": { "alias": "moduleWidth"; "required": false; "isSignal": true; }; "quietZone": { "alias": "quietZone"; "required": false; "isSignal": true; }; "displayValue": { "alias": "displayValue"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "background": { "alias": "background"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "actions": { "alias": "actions"; "required": false; "isSignal": true; }; "downloadName": { "alias": "downloadName"; "required": false; "isSignal": true; }; }, { "ready": "ready"; "downloaded": "downloaded"; }, never, never, true, never>;
+}
+
+type DgaMapEmbedAspect = 'video' | 'wide' | 'square' | 'portrait';
+/**
+ * Safe map iframe — only allowlisted embed URLs (Google / Apple / OSM / .gov.sa).
+ * Arbitrary iframes are rejected and an accessible error is shown instead.
+ *
+ * @example
+ * ```html
+ * <dga-map-embed
+ *   title="Headquarters"
+ *   src="https://www.google.com/maps/embed?pb=…"
+ *   aspect="video"
+ * />
+ * ```
+ */
+declare class DgaMapEmbed {
+    private readonly sanitizer;
+    /** Embed URL — must pass `dgaIsAllowedMapEmbedUrl`. */
+    readonly src: _angular_core.InputSignal<string>;
+    /** Required accessible name for the iframe. */
+    readonly title: _angular_core.InputSignal<string>;
+    /** Aspect-ratio token. */
+    readonly aspect: _angular_core.InputSignal<DgaMapEmbedAspect>;
+    /**
+     * Optional iframe sandbox tokens. Empty by default — Google Maps embeds break
+     * under sandbox; rely on the URL allowlist instead. Set explicitly when needed.
+     */
+    readonly sandbox: _angular_core.InputSignal<string>;
+    /** Optional fixed height in px (overrides aspect when set). */
+    readonly height: _angular_core.InputSignalWithTransform<number | null, unknown>;
+    readonly allowed: _angular_core.Signal<boolean>;
+    readonly canEmbed: _angular_core.Signal<boolean>;
+    readonly safeSrc: _angular_core.Signal<SafeResourceUrl>;
+    readonly aspectCss: _angular_core.Signal<string | null>;
+    readonly shellStyle: _angular_core.Signal<{
+        height: string | null;
+        aspectRatio: string | null;
+    }>;
+    frameClasses(): string;
+    blockedTitle(): string;
+    blockedBody(): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaMapEmbed, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaMapEmbed, "dga-map-embed", never, { "src": { "alias": "src"; "required": true; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "aspect": { "alias": "aspect"; "required": false; "isSignal": true; }; "sandbox": { "alias": "sandbox"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Allowlist check for map embed iframes — never load arbitrary URLs.
+ * Google Maps embed, Apple Maps, OpenStreetMap, and common .gov.sa GIS embeds.
+ */
+/** True when `url` is a permitted map embed (https + allowlisted host/path). */
+declare function dgaIsAllowedMapEmbedUrl(url: string): boolean;
+
 type DgaMetricTrend = 'up' | 'down' | 'neutral';
 /** `stat` = portal home metrics (icon well, value, label, centered). */
 type DgaMetricAppearance = 'default' | 'stat';
@@ -3527,23 +4522,267 @@ declare class DgaMetric {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaMetric, "dga-metric", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "delta": { "alias": "delta"; "required": false; "isSignal": true; }; "trend": { "alias": "trend"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; }, {}, never, ["[dgaMetricIcon]"], true, never>;
 }
 
+type DgaStatStripTrend = DgaMetricTrend;
+interface DgaStatStripItem {
+    id?: string;
+    label: string;
+    value: string;
+    delta?: string;
+    trend?: DgaStatStripTrend;
+}
+/**
+ * Dense horizontal KPI strip for portal dashboards.
+ * Prefer `dga-metric` when each KPI needs a full card.
+ *
+ * @example
+ * ```html
+ * <dga-stat-strip [items]="stats" />
+ * ```
+ */
+declare class DgaStatStrip {
+    private readonly uiLocale;
+    readonly items: _angular_core.InputSignal<DgaStatStripItem[]>;
+    /** Accessible name for the strip. */
+    readonly label: _angular_core.InputSignal<string>;
+    /** `divided` adds separators between items. */
+    readonly appearance: _angular_core.InputSignal<"plain" | "divided" | "card">;
+    readonly listClasses: _angular_core.Signal<string>;
+    readonly itemClasses: _angular_core.Signal<string>;
+    trackItem(item: DgaStatStripItem, index: number): string;
+    deltaClasses(trend: DgaStatStripTrend | undefined): string;
+    trendGlyph(trend: DgaStatStripTrend | undefined): string;
+    trendLabel(trend: DgaStatStripTrend | undefined): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaStatStrip, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaStatStrip, "dga-stat-strip", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+interface DgaFaqItem {
+    id: string;
+    question: string;
+    answer: string;
+    /** Open this item on first render. */
+    open?: boolean;
+}
+/**
+ * FAQ pattern on top of `dga-accordion`: Q&A sections plus optional FAQPage JSON-LD.
+ *
+ * @example
+ * ```html
+ * <dga-faq [items]="items" heading="الأسئلة الشائعة" />
+ * ```
+ */
+declare class DgaFaq {
+    private readonly document;
+    private readonly destroyRef;
+    readonly items: _angular_core.InputSignal<readonly DgaFaqItem[]>;
+    /** Optional visible heading above the accordion. */
+    readonly heading: _angular_core.InputSignal<string>;
+    /** Accessible name when heading is empty. */
+    readonly label: _angular_core.InputSignal<string>;
+    /** Allow multiple answers open at once. */
+    readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Emit FAQPage JSON-LD into `<head>` while mounted. */
+    readonly jsonLd: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly sections: _angular_core.Signal<DgaAccordionSection[]>;
+    private scriptEl;
+    constructor();
+    private writeJsonLd;
+    private removeJsonLd;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaFaq, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaFaq, "dga-faq", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "jsonLd": { "alias": "jsonLd"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/** Calendar system for date values and the picker UI. */
+type DgaDateCalendar = 'gregorian' | 'hijri';
+/** Picker UI mode — inferred from `format` tokens when not set explicitly. */
+type DgaDatePickerMode = 'day' | 'month' | 'year';
+type DgaDateLocale = string;
+interface DgaCalendarParts {
+    year: number;
+    month: number;
+    day: number;
+}
+declare const DGA_HIJRI_MONTHS: {
+    readonly ar: readonly ["محرم", "صفر", "ربيع الأول", "ربيع الثاني", "جمادى الأولى", "جمادى الآخرة", "رجب", "شعبان", "رمضان", "شوال", "ذو القعدة", "ذو الحجة"];
+    readonly en: readonly ["Muharram", "Safar", "Rabi I", "Rabi II", "Jumada I", "Jumada II", "Rajab", "Sha'ban", "Ramadan", "Shawwal", "Dhu al-Qi'dah", "Dhu al-Hijjah"];
+};
+declare const DGA_GREGORIAN_MONTHS: {
+    readonly ar: readonly ["يناير", "فبراير", "مارس", "أبريل", "مايو", "يونيو", "يوليو", "أغسطس", "سبتمبر", "أكتوبر", "نوفمبر", "ديسمبر"];
+    readonly en: readonly ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"];
+};
+declare const DGA_WEEKDAYS: {
+    readonly ar: readonly ["أحد", "إثن", "ثلا", "أرب", "خمي", "جمع", "سبت"];
+    readonly en: readonly ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+};
+/** Read calendar parts for a Date (UTC day). */
+declare function dgaGetCalendarParts(date: Date, calendar: DgaDateCalendar): DgaCalendarParts;
+/**
+ * Convert calendar parts to a Date (UTC midnight).
+ * Hijri conversion uses binary search against islamic-umalqura.
+ */
+declare function dgaPartsToDate(parts: DgaCalendarParts, calendar: DgaDateCalendar): Date;
+declare function dgaDaysInMonth(year: number, month: number, calendar: DgaDateCalendar): number;
+declare function dgaAddMonths(parts: DgaCalendarParts, delta: number, calendar: DgaDateCalendar): DgaCalendarParts;
+/** Infer mode from format tokens (YYYY / MM / DD). */
+declare function dgaModeFromFormat(format: string): DgaDatePickerMode;
+declare function dgaFormatDate(date: Date, format: string, calendar: DgaDateCalendar): string;
+declare function dgaParseDate(value: string, format: string, calendar: DgaDateCalendar): Date | null;
+declare function dgaSameDay(a: Date | null, b: Date | null, calendar?: DgaDateCalendar): boolean;
+declare function dgaCompareDays(a: Date | null, b: Date | null, calendar?: DgaDateCalendar): number;
+declare function dgaClampDate(date: Date, min?: Date | null, max?: Date | null, calendar?: DgaDateCalendar): Date;
+declare function dgaMonthNames(calendar: DgaDateCalendar, locale: string): readonly string[];
+/** First weekday (0=Sun) of the given calendar month. */
+declare function dgaMonthStartWeekday(year: number, month: number, calendar: DgaDateCalendar): number;
+declare function dgaTodayUtc(): Date;
+/** Coerce string | Date | null to UTC date using format when string. */
+declare function dgaCoerceDate(value: string | Date | null | undefined, format: string, calendar: DgaDateCalendar): Date | null;
+
+interface DgaCalendarEvent {
+    id: string;
+    title: string;
+    /** ISO Gregorian date `yyyy-mm-dd` (events stay Gregorian across calendars). */
+    date: string;
+    /** Optional accent color for the event indicator (CSS color). */
+    tone?: string;
+}
+/**
+ * Month grid with events (appointments / queues).
+ * Named `DgaEventCalendar` to avoid clashing with top-bar `DgaCalendar` type.
+ * Supports Gregorian and Hijri (Umm al-Qura) display via `calendar`.
+ */
+declare class DgaEventCalendar {
+    private readonly uiLocale;
+    private readonly ar;
+    readonly events: _angular_core.InputSignal<DgaCalendarEvent[]>;
+    /** Anchor date for the visible month (any day in that Gregorian month works). */
+    readonly month: _angular_core.ModelSignal<Date>;
+    readonly selectedDay: _angular_core.ModelSignal<string>;
+    /** Display calendar system. */
+    readonly calendar: _angular_core.ModelSignal<DgaDateCalendar>;
+    readonly daySelect: _angular_core.OutputEmitterRef<string>;
+    readonly eventSelect: _angular_core.OutputEmitterRef<DgaCalendarEvent>;
+    readonly weekdays: _angular_core.Signal<string[]>;
+    readonly monthLabel: _angular_core.Signal<string>;
+    readonly prevLabel: _angular_core.Signal<"الشهر السابق" | "Previous month">;
+    readonly nextLabel: _angular_core.Signal<"الشهر التالي" | "Next month">;
+    readonly todayLabel: _angular_core.Signal<"اليوم" | "Today">;
+    readonly eventsLabel: _angular_core.Signal<"أحداث اليوم" | "Events for day">;
+    readonly pickDayLabel: _angular_core.Signal<"الأحداث" | "Events">;
+    readonly pickDayHint: _angular_core.Signal<"اختر يوماً لعرض الأحداث" | "Select a day to view events">;
+    readonly noEventsLabel: _angular_core.Signal<"لا توجد أحداث في هذا اليوم" | "No events on this day">;
+    readonly gregorianLabel: _angular_core.Signal<"ميلادي" | "Gregorian">;
+    readonly hijriLabel: _angular_core.Signal<"هجري" | "Hijri">;
+    readonly calendarGroupLabel: _angular_core.Signal<"نظام التقويم" | "Calendar system">;
+    readonly selectedDayLabel: _angular_core.Signal<string>;
+    readonly eventsByDate: _angular_core.Signal<Map<string, DgaCalendarEvent[]>>;
+    readonly todayIso: _angular_core.Signal<string>;
+    readonly cells: _angular_core.Signal<{
+        key: string;
+        day: number;
+        iso: string;
+        inMonth: boolean;
+        count: number;
+        tones: string[];
+        isToday: boolean;
+    }[]>;
+    readonly dayEvents: _angular_core.Signal<DgaCalendarEvent[]>;
+    shiftMonth(delta: number): void;
+    goToday(): void;
+    selectDay(iso: string): void;
+    dayClass(cell: {
+        inMonth: boolean;
+        iso: string;
+        count: number;
+        isToday: boolean;
+    }): string;
+    eventCountLabel(n: number): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaEventCalendar, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaEventCalendar, "dga-event-calendar", never, { "events": { "alias": "events"; "required": false; "isSignal": true; }; "month": { "alias": "month"; "required": false; "isSignal": true; }; "selectedDay": { "alias": "selectedDay"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; }, { "month": "monthChange"; "selectedDay": "selectedDayChange"; "calendar": "calendarChange"; "daySelect": "daySelect"; "eventSelect": "eventSelect"; }, never, never, true, never>;
+}
+
+/** Cell template: `<ng-template dgaCellDef="status" let-row>…</ng-template>` */
+declare class DgaCellDef {
+    readonly dgaCellDef: _angular_core.InputSignal<string>;
+    readonly template: TemplateRef<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaCellDef, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DgaCellDef, "ng-template[dgaCellDef]", never, { "dgaCellDef": { "alias": "dgaCellDef"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/** Expandable row body: `<ng-template dgaExpandDef let-row>…</ng-template>` */
+declare class DgaExpandDef {
+    readonly template: TemplateRef<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaExpandDef, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DgaExpandDef, "ng-template[dgaExpandDef]", never, {}, {}, never, never, true, never>;
+}
+/** Row overflow actions: `<ng-template dgaRowActions let-row>…</ng-template>` */
+declare class DgaRowActionsDef {
+    readonly template: TemplateRef<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaRowActionsDef, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DgaRowActionsDef, "ng-template[dgaRowActions]", never, {}, {}, never, never, true, never>;
+}
+/** Custom mobile card: `<ng-template dgaCardDef let-row>…</ng-template>` */
+declare class DgaCardDef {
+    readonly template: TemplateRef<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaCardDef, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DgaCardDef, "ng-template[dgaCardDef]", never, {}, {}, never, never, true, never>;
+}
+interface DgaCellContext {
+    $implicit: Record<string, unknown>;
+    row: Record<string, unknown>;
+    column?: string;
+    index: number;
+}
+
 interface DgaTableColumn<T = Record<string, unknown>> {
     key: string;
     label: string;
     sortable?: boolean;
+    /** Show a text filter under the header. */
+    filterable?: boolean;
+    /** Pin column to the inline-start or inline-end edge while scrolling. */
+    pinned?: 'start' | 'end';
+    /** Optional CSS width (e.g. `8rem`, `120px`). */
+    width?: string;
+    /** Client sort strategy when not using `compare`. */
+    sortType?: 'string' | 'number' | 'date';
+    /** Custom client comparator (a, b cell values). */
+    compare?: (a: unknown, b: unknown) => number;
 }
 type DgaSortDir = 'asc' | 'desc';
 type DgaTableDensity = 'comfortable' | 'compact';
+type DgaTableViewMode = 'table' | 'cards' | 'auto';
+type DgaTableResolvedView = 'table' | 'cards';
+interface DgaTableSortEvent {
+    key: string;
+    dir: DgaSortDir;
+}
+interface DgaTableFilterEvent {
+    /** Column key → filter query (empty string clears). */
+    filters: Record<string, string>;
+}
+interface DgaTablePageEvent {
+    page: number;
+    pageSize: number;
+}
 declare class DgaTable {
+    private readonly destroyRef;
     private readonly uiLocale;
     private readonly ar;
     readonly columns: _angular_core.InputSignal<DgaTableColumn<Record<string, unknown>>[]>;
     readonly rows: _angular_core.InputSignal<Record<string, unknown>[]>;
     readonly selectable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Enables expand controls; requires an `ng-template dgaExpandDef`. */
+    readonly expandable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * When true, sort/filter/page only emit events — host owns the row list
+     * (server-driven tables).
+     */
+    readonly serverSide: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly idKey: _angular_core.InputSignal<string>;
     readonly selectedKeys: _angular_core.ModelSignal<string[]>;
     readonly sortKey: _angular_core.ModelSignal<string>;
     readonly sortDir: _angular_core.ModelSignal<DgaSortDir>;
+    readonly columnFilters: _angular_core.ModelSignal<Record<string, string>>;
+    readonly expandedKeys: _angular_core.ModelSignal<string[]>;
     readonly label: _angular_core.InputSignal<string | undefined>;
     readonly selectAllLabel: _angular_core.InputSignal<string | undefined>;
     readonly emptyLabel: _angular_core.InputSignal<string | undefined>;
@@ -3552,35 +4791,217 @@ declare class DgaTable {
     readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly stickyHeader: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly hiddenKeys: _angular_core.ModelSignal<string[]>;
+    /** 1-based page. Pagination UI shows when `pageSize > 0`. */
+    readonly page: _angular_core.ModelSignal<number>;
+    /** Page size; `0` disables pagination (show all rows). */
+    readonly pageSize: _angular_core.ModelSignal<number>;
+    /** Total rows for server-side pagination; client mode uses filtered length. */
+    readonly total: _angular_core.InputSignal<number | undefined>;
+    readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
+    /** Debounce for `filterChange` output (ms). Model updates stay immediate. */
+    readonly filterDebounceMs: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Error message; renders alert + retry when set. */
+    readonly error: _angular_core.InputSignal<string | null>;
+    /**
+     * Presentation mode. `auto` follows `cardsBreakpoint` via matchMedia.
+     */
+    readonly viewMode: _angular_core.ModelSignal<DgaTableViewMode>;
+    readonly cardsBreakpoint: _angular_core.InputSignal<string>;
+    /** Column key used as card title; defaults to first visible column. */
+    readonly cardTitleKey: _angular_core.InputSignal<string | undefined>;
+    readonly sortChange: _angular_core.OutputEmitterRef<DgaTableSortEvent>;
+    readonly filterChange: _angular_core.OutputEmitterRef<DgaTableFilterEvent>;
+    /** Emits when the page index or page size changes (includes both). */
+    readonly pagingChange: _angular_core.OutputEmitterRef<DgaTablePageEvent>;
+    readonly errorRetry: _angular_core.OutputEmitterRef<void>;
     readonly skeletonRows: number[];
+    private readonly cellDefs;
+    private readonly expandDef;
+    private readonly rowActionsDef;
+    private readonly cardDef;
+    private readonly selectAllEl;
+    private readonly cellMap;
+    private readonly mqMatches;
+    /** Cards-mode global search (matches any visible column). */
+    readonly cardsQuery: _angular_core.WritableSignal<string>;
+    private filterTimer;
+    private skipPageEmit;
     readonly resolvedLabel: _angular_core.Signal<string>;
     readonly resolvedSelectAllLabel: _angular_core.Signal<string>;
     readonly resolvedEmptyLabel: _angular_core.Signal<string>;
     readonly selectedCountLabel: _angular_core.Signal<string>;
-    private readonly selectAllEl;
+    readonly retryLabel: _angular_core.Signal<"إعادة المحاولة" | "Retry">;
+    readonly clearFiltersLabel: _angular_core.Signal<"مسح التصفية" | "Clear filters">;
+    readonly actionsLabel: _angular_core.Signal<"إجراءات" | "Actions">;
+    readonly pageSizeLabel: _angular_core.Signal<"لكل صفحة" | "Per page">;
+    readonly errorTitle: _angular_core.Signal<"تعذر التحميل" | "Failed to load">;
+    readonly cardsSearchLabel: _angular_core.Signal<"بحث" | "Search">;
+    readonly cardsSearchPlaceholder: _angular_core.Signal<"ابحث في النتائج…" | "Search results…">;
+    readonly cardsSortLabel: _angular_core.Signal<"فرز حسب" | "Sort by">;
+    readonly cardsSortPlaceholder: _angular_core.Signal<"بدون فرز" | "No sort">;
+    readonly cardsSortDirLabel: _angular_core.Signal<"تصاعدي — انقر للتبديل" | "Ascending — click to toggle" | "تنازلي — انقر للتبديل" | "Descending — click to toggle">;
+    readonly resolvedView: _angular_core.Signal<DgaTableResolvedView>;
+    readonly paginationEnabled: _angular_core.Signal<boolean>;
+    readonly filteredCount: _angular_core.Signal<number>;
+    readonly totalPages: _angular_core.Signal<number>;
+    readonly rangeLabel: _angular_core.Signal<string>;
     constructor();
+    private bindBreakpoint;
     readonly visibleColumns: _angular_core.Signal<DgaTableColumn<Record<string, unknown>>[]>;
+    readonly filterableColumns: _angular_core.Signal<DgaTableColumn<Record<string, unknown>>[]>;
+    readonly sortableColumns: _angular_core.Signal<DgaTableColumn<Record<string, unknown>>[]>;
+    readonly cardTitleColumn: _angular_core.Signal<DgaTableColumn<Record<string, unknown>>>;
+    readonly cardBodyColumns: _angular_core.Signal<DgaTableColumn<Record<string, unknown>>[]>;
     readonly selectPad: _angular_core.Signal<"w-4xl px-lg py-xs" | "w-4xl px-lg py-md">;
     readonly headerPad: _angular_core.Signal<string>;
     readonly bodyPad: _angular_core.Signal<string>;
+    readonly cardPad: _angular_core.Signal<"px-md py-sm" | "px-lg py-md">;
     readonly rowClasses: _angular_core.Signal<string>;
-    readonly sortedRows: _angular_core.Signal<Record<string, unknown>[]>;
+    /** Filter + sort (client) or raw rows (server). */
+    readonly filteredRows: _angular_core.Signal<Record<string, unknown>[]>;
+    /** Current page of rows (or all when pagination off / serverSide). */
+    readonly displayRows: _angular_core.Signal<Record<string, unknown>[]>;
     readonly allSelected: _angular_core.Signal<boolean>;
     readonly someSelected: _angular_core.Signal<boolean>;
+    hasRowActions(): boolean;
+    hasFilterOrSortChrome(): boolean;
+    hasActiveFilters(): boolean;
+    onCardsSearch(value: string): void;
+    onCardsSortKey(key: string): void;
+    emptyHint(): string;
+    cellTemplate(key: string): TemplateRef<DgaCellContext> | null;
+    expandTemplate(): TemplateRef<DgaCellContext> | null;
+    rowActionsTemplate(): TemplateRef<DgaCellContext> | null;
+    cardTemplate(): TemplateRef<DgaCellContext> | null;
+    cellContext(row: Record<string, unknown>, column: string | undefined, index: number): DgaCellContext;
+    headerCellClass(col: DgaTableColumn): string;
+    bodyCellClass(col: DgaTableColumn): string;
+    private pinClass;
+    filterPlaceholder(): string;
+    filterAria(col: DgaTableColumn): string;
     rowKey(row: Record<string, unknown>): string;
     cellValue(row: Record<string, unknown>, key: string): string;
+    cardTitle(row: Record<string, unknown>): string;
     isSelected(row: Record<string, unknown>): boolean;
+    isExpanded(row: Record<string, unknown>): boolean;
+    expandLabel(row: Record<string, unknown>): string;
     rowSelectLabel(row: Record<string, unknown>): string;
     selectAllAria(): 'true' | 'false' | 'mixed';
     emptyColspan(): number;
     ariaSort(key: string): 'ascending' | 'descending' | 'none' | null;
     sortGlyph(key: string): string;
     toggleSort(key: string): void;
+    onFilter(key: string, value: string): void;
+    clearFilters(): void;
+    onPageSizeChange(size: number): void;
+    onPageModelChange(next: number): void;
+    toggleExpand(row: Record<string, unknown>): void;
     toggleRow(row: Record<string, unknown>): void;
     toggleAll(): void;
     private rowKeys;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaTable, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaTable, "dga-table", never, { "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "idKey": { "alias": "idKey"; "required": false; "isSignal": true; }; "selectedKeys": { "alias": "selectedKeys"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDir": { "alias": "sortDir"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "selectAllLabel": { "alias": "selectAllLabel"; "required": false; "isSignal": true; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "hiddenKeys": { "alias": "hiddenKeys"; "required": false; "isSignal": true; }; }, { "selectedKeys": "selectedKeysChange"; "sortKey": "sortKeyChange"; "sortDir": "sortDirChange"; "hiddenKeys": "hiddenKeysChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaTable, "dga-table", never, { "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "expandable": { "alias": "expandable"; "required": false; "isSignal": true; }; "serverSide": { "alias": "serverSide"; "required": false; "isSignal": true; }; "idKey": { "alias": "idKey"; "required": false; "isSignal": true; }; "selectedKeys": { "alias": "selectedKeys"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDir": { "alias": "sortDir"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "expandedKeys": { "alias": "expandedKeys"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "selectAllLabel": { "alias": "selectAllLabel"; "required": false; "isSignal": true; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "hiddenKeys": { "alias": "hiddenKeys"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "filterDebounceMs": { "alias": "filterDebounceMs"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "viewMode": { "alias": "viewMode"; "required": false; "isSignal": true; }; "cardsBreakpoint": { "alias": "cardsBreakpoint"; "required": false; "isSignal": true; }; "cardTitleKey": { "alias": "cardTitleKey"; "required": false; "isSignal": true; }; }, { "selectedKeys": "selectedKeysChange"; "sortKey": "sortKeyChange"; "sortDir": "sortDirChange"; "columnFilters": "columnFiltersChange"; "expandedKeys": "expandedKeysChange"; "hiddenKeys": "hiddenKeysChange"; "page": "pageChange"; "pageSize": "pageSizeChange"; "viewMode": "viewModeChange"; "sortChange": "sortChange"; "filterChange": "filterChange"; "pagingChange": "pagingChange"; "errorRetry": "errorRetry"; }, ["cellDefs", "expandDef", "rowActionsDef", "cardDef"], ["[dgaTableToolbar]", "[dgaTableError]", "[dgaTableBulk]", "[dgaTableFooter]", "[dgaTableEmpty]"], true, never>;
+}
+
+/**
+ * Checkbox list that two-way binds `hiddenKeys` for `dga-table`.
+ * Project into `[dgaTableToolbar]` or place beside the table.
+ */
+declare class DgaTableColumnPicker {
+    private readonly uiLocale;
+    private readonly ar;
+    readonly columns: _angular_core.InputSignal<DgaTableColumn<Record<string, unknown>>[]>;
+    readonly hiddenKeys: _angular_core.ModelSignal<string[]>;
+    readonly label: _angular_core.InputSignal<string | undefined>;
+    readonly resolvedLabel: _angular_core.Signal<string>;
+    isVisible(key: string): boolean;
+    toggle(key: string): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaTableColumnPicker, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaTableColumnPicker, "dga-table-column-picker", never, { "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "hiddenKeys": { "alias": "hiddenKeys"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "hiddenKeys": "hiddenKeysChange"; }, never, never, true, never>;
+}
+
+/** Context for `ng-template dgaVirtualItem let-item let-index="index"`. */
+interface DgaVirtualItemContext<T = unknown> {
+    $implicit: T;
+    index: number;
+}
+/**
+ * Marks the item row template for {@link DgaVirtualList}.
+ *
+ * @example
+ * ```html
+ * <ng-template dgaVirtualItem let-item let-index="index">
+ *   {{ index }} — {{ item.name }}
+ * </ng-template>
+ * ```
+ */
+declare class DgaVirtualItem<T = unknown> {
+    readonly template: TemplateRef<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaVirtualItem<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DgaVirtualItem<any>, "ng-template[dgaVirtualItem]", never, {}, {}, never, never, true, never>;
+}
+interface VisibleRow {
+    item: unknown;
+    index: number;
+    track: string | number;
+}
+/**
+ * Pure Angular virtual list (no CDK). Renders a window of rows with a
+ * transform / total-height spacer. Emits `scrolledToEnd` near the bottom
+ * for infinite-scroll consumers.
+ *
+ * @example
+ * ```html
+ * <dga-virtual-list
+ *   [items]="rows"
+ *   [itemHeight]="48"
+ *   trackByKey="id"
+ *   [loadingMore]="busy"
+ *   (scrolledToEnd)="loadMore()"
+ * >
+ *   <ng-template dgaVirtualItem let-item let-index="index">
+ *     <div class="px-lg py-md">{{ item.label }}</div>
+ *   </ng-template>
+ *   <span dgaVirtualLoading>تحميل المزيد…</span>
+ * </dga-virtual-list>
+ * ```
+ */
+declare class DgaVirtualList {
+    private readonly injector;
+    private readonly viewportRef;
+    /** Projected item template (`ng-template dgaVirtualItem`). */
+    readonly itemDef: _angular_core.Signal<DgaVirtualItem<any> | undefined>;
+    /** Full data set (only the visible window is rendered). */
+    readonly items: _angular_core.InputSignal<unknown[]>;
+    /** Fixed row height in pixels. */
+    readonly itemHeight: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Extra rows above/below the viewport. */
+    readonly overscan: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** CSS height of the scroll viewport. */
+    readonly height: _angular_core.InputSignal<string>;
+    /**
+     * When set, track rows by `item[trackByKey]` (object id field).
+     * Otherwise track by index.
+     */
+    readonly trackByKey: _angular_core.InputSignal<string | undefined>;
+    /** Show the loading footer (infinite scroll). */
+    readonly loadingMore: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Fires when the user scrolls near the bottom. */
+    readonly scrolledToEnd: _angular_core.OutputEmitterRef<void>;
+    private readonly scrollTop;
+    private readonly viewportHeight;
+    private endEmittedForLength;
+    readonly totalHeight: _angular_core.Signal<number>;
+    readonly startIndex: _angular_core.Signal<number>;
+    readonly endIndex: _angular_core.Signal<number>;
+    readonly offsetY: _angular_core.Signal<number>;
+    readonly visibleRows: _angular_core.Signal<VisibleRow[]>;
+    constructor();
+    onScroll(): void;
+    private checkScrolledToEnd;
+    private trackOf;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaVirtualList, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaVirtualList, "dga-virtual-list", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": false; "isSignal": true; }; "overscan": { "alias": "overscan"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "trackByKey": { "alias": "trackByKey"; "required": false; "isSignal": true; }; "loadingMore": { "alias": "loadingMore"; "required": false; "isSignal": true; }; }, { "scrolledToEnd": "scrolledToEnd"; }, ["itemDef"], ["[dgaVirtualLoading]"], true, never>;
 }
 
 interface DgaExportColumn {
@@ -3658,6 +5079,8 @@ declare class DgaCarouselSlideDirective {
 declare class DgaCarousel {
     private readonly destroyRef;
     private readonly host;
+    private readonly swipe;
+    private drag;
     private readonly track;
     private readonly projected;
     /** Simple title/body slides (gallery). When non-empty, enables simple mode. */
@@ -3708,6 +5131,13 @@ declare class DgaCarousel {
     prevPage(): void;
     nextPage(): void;
     onTrackScroll(): void;
+    onSimplePointerDown(event: PointerEvent): void;
+    onSimplePointerMove(event: PointerEvent): void;
+    onSimplePointerUp(event: PointerEvent): void;
+    onSimplePointerCancel(event: PointerEvent): void;
+    onTrackPointerDown(event: PointerEvent): void;
+    onTrackPointerMove(event: PointerEvent): void;
+    onTrackPointerUp(event: PointerEvent): void;
     private refreshMetrics;
     private resolvePerView;
     private pageScrollAmount;
@@ -3719,176 +5149,6 @@ declare class DgaCarousel {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaCarousel, "dga-carousel", never, { "slides": { "alias": "slides"; "required": false; "isSignal": true; }; "index": { "alias": "index"; "required": false; "isSignal": true; }; "slidesMax": { "alias": "slidesMax"; "required": false; "isSignal": true; }; "slidesMid": { "alias": "slidesMid"; "required": false; "isSignal": true; }; "slidesMin": { "alias": "slidesMin"; "required": false; "isSignal": true; }; "peek": { "alias": "peek"; "required": false; "isSignal": true; }; "gap": { "alias": "gap"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "prevLabel": { "alias": "prevLabel"; "required": false; "isSignal": true; }; "nextLabel": { "alias": "nextLabel"; "required": false; "isSignal": true; }; "dotsLabel": { "alias": "dotsLabel"; "required": false; "isSignal": true; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; "isSignal": true; }; }, { "index": "indexChange"; }, ["projected"], ["*"], true, never>;
 }
 
-type DgaChartType = 'bar' | 'line' | 'pie' | 'donut';
-/** Backward-compatible single-series point: `{ label, value }`. */
-interface DgaChartPoint {
-    label: string;
-    value: number;
-}
-/** Multi-series data: one named series of values, aligned with `labels()`. */
-interface DgaChartDataset {
-    name: string;
-    data: number[];
-}
-interface DgaChartBarSlot {
-    seriesIndex: number;
-    categoryIndex: number;
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-    value: number;
-    color: string;
-    name: string;
-    category: string;
-}
-interface DgaChartLinePoint {
-    x: number;
-    y: number;
-    value: number;
-    category: string;
-}
-interface DgaChartLine {
-    name: string;
-    color: string;
-    points: DgaChartLinePoint[];
-    linePath: string;
-    areaPath: string;
-}
-interface DgaChartLegendItem {
-    name: string;
-    color: string;
-    value: number | null;
-}
-interface DgaChartTooltip {
-    x: number;
-    y: number;
-    title: string;
-    items: {
-        name: string;
-        color: string;
-        value: number;
-    }[];
-}
-declare class DgaChart {
-    readonly type: _angular_core.InputSignal<DgaChartType>;
-    /** BC single-series input: `[{ label, value }]`. */
-    readonly series: _angular_core.InputSignal<DgaChartPoint[]>;
-    /** Category names shared by all `datasets()`. */
-    readonly labels: _angular_core.InputSignal<string[]>;
-    /** Preferred multi-series input for bar/line. */
-    readonly datasets: _angular_core.InputSignal<DgaChartDataset[]>;
-    /** Shown for pie/donut and multi-series bar/line. Set `false` to force-hide. */
-    readonly legend: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly tooltip: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly grid: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly stacked: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly smooth: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly area: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly dots: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Overrides the `--dga-chart-color-1..6` token cycle. */
-    readonly colors: _angular_core.InputSignal<string[]>;
-    /** Label for the value row in pie/donut tooltips. Default: `'القيمة'`. */
-    readonly tooltipValueLabel: _angular_core.InputSignal<string>;
-    readonly height: _angular_core.InputSignal<number>;
-    readonly label: _angular_core.InputSignal<string>;
-    /** Fixed drawing width; scales via CSS `w-full`. */
-    readonly width = 400;
-    readonly pieSize = 180;
-    readonly pad: {
-        t: number;
-        r: number;
-        b: number;
-        l: number;
-    };
-    private readonly hiddenNames;
-    readonly hiddenSeries: _angular_core.Signal<Set<string>>;
-    readonly hoveredCategoryIndex: _angular_core.WritableSignal<number | null>;
-    readonly hoveredSlice: _angular_core.WritableSignal<{
-        index: number;
-        label: string;
-        value: number;
-    } | null>;
-    readonly isPieType: _angular_core.Signal<boolean>;
-    /** Category labels: explicit `labels()`, else derived from `datasets()` length, else BC `series()` labels. */
-    readonly categories: _angular_core.Signal<string[]>;
-    /** Normalized series: `datasets()` when present, else one series built from BC `series()`. */
-    readonly seriesList: _angular_core.Signal<DgaChartDataset[]>;
-    readonly visibleSeriesList: _angular_core.Signal<DgaChartDataset[]>;
-    /** Points feeding pie/donut: BC `series()`, else first dataset paired with `labels()`. */
-    readonly piePoints: _angular_core.Signal<DgaChartPoint[]>;
-    readonly visiblePiePoints: _angular_core.Signal<DgaChartPoint[]>;
-    readonly showLegend: _angular_core.Signal<boolean>;
-    readonly legendItems: _angular_core.Signal<DgaChartLegendItem[]>;
-    colorFor(index: number): string;
-    toggleSeries(name: string): void;
-    readonly ariaLabel: _angular_core.Signal<string>;
-    readonly plot: _angular_core.Signal<{
-        x: number;
-        y: number;
-        w: number;
-        h: number;
-    }>;
-    readonly gridYs: _angular_core.Signal<number[]>;
-    readonly maxValue: _angular_core.Signal<number>;
-    /** Layout for one group (category) slot shared by bars and the hover hit-rect. */
-    private readonly groupLayout;
-    readonly categoryTicks: _angular_core.Signal<{
-        index: number;
-        category: string;
-        x: number;
-        hitX: number;
-        hitW: number;
-    }[]>;
-    readonly bars: _angular_core.Signal<DgaChartBarSlot[]>;
-    readonly visibleLines: _angular_core.Signal<DgaChartLine[]>;
-    private straightPathD;
-    /** Piecewise cubic Bezier through the points (Catmull-Rom style tangents). */
-    private smoothPathD;
-    private areaPathD;
-    readonly pieSlices: _angular_core.Signal<{
-        index: number;
-        label: string;
-        value: number;
-        color: string;
-        d: string;
-        midX: number;
-        midY: number;
-    }[]>;
-    onCategoryEnter(index: number): void;
-    onCategoryLeave(): void;
-    onSliceEnter(index: number, slice: {
-        label: string;
-        value: number;
-    }): void;
-    onSliceLeave(): void;
-    categoryAriaLabel(index: number): string;
-    readonly categoryTooltip: _angular_core.Signal<DgaChartTooltip | null>;
-    readonly sliceTooltip: _angular_core.Signal<DgaChartTooltip | null>;
-    formatValue(value: number): string;
-    pieTooltipStyle(tip: DgaChartTooltip): Record<string, string>;
-    plotTooltipStyle(tip: DgaChartTooltip): Record<string, string>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaChart, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaChart, "dga-chart", never, { "type": { "alias": "type"; "required": false; "isSignal": true; }; "series": { "alias": "series"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "datasets": { "alias": "datasets"; "required": false; "isSignal": true; }; "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "grid": { "alias": "grid"; "required": false; "isSignal": true; }; "stacked": { "alias": "stacked"; "required": false; "isSignal": true; }; "smooth": { "alias": "smooth"; "required": false; "isSignal": true; }; "area": { "alias": "area"; "required": false; "isSignal": true; }; "dots": { "alias": "dots"; "required": false; "isSignal": true; }; "colors": { "alias": "colors"; "required": false; "isSignal": true; }; "tooltipValueLabel": { "alias": "tooltipValueLabel"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-interface DgaSaudiCity {
-    id: number;
-    region: string;
-    regionAr: string;
-    name: string;
-    nameAr: string;
-}
-/** Bilingual Saudi cities across all 13 administrative regions. */
-declare const DGA_SAUDI_CITIES: readonly DgaSaudiCity[];
-/** Group cities by English region name. */
-declare function dgaGroupSaudiCitiesByRegion(cities?: readonly DgaSaudiCity[]): Record<string, DgaSaudiCity[]>;
-/** Autocomplete-ready options (Arabic labels by default). */
-declare function dgaSaudiCityOptions(locale?: string, cities?: readonly DgaSaudiCity[]): {
-    label: string;
-    value: string;
-}[];
-
 declare function dgaResolveAppHref(href: string, baseHref?: string): string;
 /**
  * Safe href for config-driven links (CMS / schema).
@@ -3901,5 +5161,5 @@ declare function dgaSafeCssColor(value: string | null | undefined, fallback?: st
 /** Join truthy class names. */
 declare function dgaCx(...parts: Array<string | false | null | undefined>): string;
 
-export { 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, 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, DgaCopy, DgaDescriptionList, DgaDialog, DgaDivider, DgaDrawer, DgaDualNav, DgaEmpty, DgaExpandable, DgaExport, DgaExportToolbar, DgaFeedback, DgaField, DgaFilterBar, DgaFooter, DgaFormControl, DgaFormEnd, DgaFormStart, DgaGrid, 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, DgaVideoPlayer, DgaWriting, dgaCurrentLocale, dgaCx, dgaFormStatusFromInvalid, dgaGroupSaudiCitiesByRegion, dgaIsArabic, dgaIsRtl, dgaNormalizeTime, dgaProvideValueAccessor, dgaResolveAppHref, dgaResolveLocalized, dgaResolveVideoSource, dgaSafeCssColor, dgaSafeHref, dgaSaudiCityOptions, dgaUiLocale };
-export type { DgaAccordionSection, DgaAlertDisplay, DgaAlertVariant, DgaAnnouncementActionVariant, DgaAnnouncementAlign, DgaAnnouncementDensity, DgaAnnouncementElevation, DgaAnnouncementPersist, DgaAnnouncementTone, DgaAppShellAppearance, DgaAutocompleteOption, DgaAvatarSize, DgaBadgeSize, DgaBadgeVariant, DgaBreadcrumbItem, DgaBreadcrumbSeparator, DgaButtonSize, DgaButtonVariant, DgaCalendar, DgaCardActionsAlign, DgaCardAppearance, DgaCardBadge, DgaCardBorder, DgaCardPadding, DgaCardShadow, DgaCarouselSlide, DgaChartDataset, DgaChartPoint, DgaChartType, DgaChatbotAnimation, DgaChatbotFabTone, DgaChatbotMessage, DgaChatbotPosition, DgaChatbotSize, DgaCheckboxSize, DgaChipVariant, DgaCommandAppearance, DgaCommandGroup, DgaCommandItem, DgaContentSwitcherItem, DgaContextMenuItem, DgaContextMenuItemType, DgaCurrency, DgaDescriptionItem, DgaDescriptionLayout, DgaDialogSize, DgaDividerOrientation, DgaDrawerSide, DgaDualNavCategory, DgaDualNavSection, DgaEmptyAppearance, DgaExportColumn, DgaExportData, DgaExportScope, DgaFeedbackSubmit, DgaFilterItem, DgaFooterAppearance, DgaFooterColumn, DgaFooterIconGroup, DgaFooterIconLink, DgaFooterLink, DgaFooterLogo, DgaFormControlSize, DgaFormStatus, DgaGridCols, DgaGridGap, DgaHeroAppearance, DgaHeroImageMask, DgaHeroOverlayTone, DgaHeroSlide, DgaHeroTransition, DgaIconBadgeAppearance, DgaIconBadgeSize, DgaIconName, DgaIconSize, DgaIconTone, DgaImagePopupAnimation, DgaImagePopupImage, DgaImagePopupImageTransition, DgaImagePopupSource, DgaInfoListItem, DgaInputSize, DgaLinkVariant, DgaLocalizedString, DgaMenuItem, DgaMetricAppearance, DgaMetricTrend, DgaModalAnimation, DgaModalSize, DgaMultiselectOption, DgaNativeSelectSize, DgaNavRailActiveStyle, DgaNavRailAppearance, DgaNavRailItem, DgaNavRailPosition, DgaNavRailSize, DgaPageFeedbackAgreementLink, DgaPageFeedbackAnswer, DgaPageFeedbackOption, DgaPageFeedbackPhase, DgaPageFeedbackSubmit, DgaPageHeroTone, DgaPageTransitionName, DgaPhoneCountry, DgaPhoneCountryName, 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, DgaVideoProvider, DgaVideoRatio, DgaVideoSourceInfo, DgaWritingEffect };
+export { DGA_GREGORIAN_MONTHS, DGA_HIJRI_MONTHS, DGA_IBAN_COUNTRY, DGA_IBAN_LENGTH, DGA_ICON_NAMES, DGA_ICON_OVERRIDES, DGA_LOGICAL_ICON_NAMES, DGA_PHONE_COUNTRIES, DGA_RIYAL_SVG_PATH, DGA_RIYAL_VIEWBOX, DGA_WEEKDAYS, DgaAccordion, DgaAccordionItem, DgaAlert, DgaAnnouncementBar, DgaAppShell, DgaAuthCard, DgaAutocomplete, DgaAvatar, DgaBadge, DgaBarcode, DgaBottomSheet, DgaBreadcrumb, DgaButton, DgaCard, DgaCardDef, DgaCardMedia, DgaCarousel, DgaCarouselSlideDirective, DgaCellDef, DgaCheckbox, DgaChip, DgaChipInput, DgaChoiceGroup, DgaClamp, DgaCode, DgaCommand, DgaConfirm, DgaContentSwitcher, DgaContentSwitcherPanel, DgaContextMenu, DgaContextMenuTrigger, DgaCopy, DgaDescriptionList, DgaDialog, DgaDivider, DgaDrawer, DgaDualNav, DgaEmpty, DgaEventCalendar, DgaExpandDef, DgaExpandable, DgaExport, DgaExportToolbar, DgaFaq, DgaFeedback, DgaField, DgaFilePreview, DgaFilterBar, DgaFooter, DgaFormControl, DgaFormEnd, DgaFormStart, DgaGrid, DgaHero, DgaIbanInput, DgaIcon, DgaIconBadge, DgaIconFontService, DgaIconRegistry, DgaImagePopup, DgaInfoList, DgaInput, DgaKbd, DgaKbdGroup, DgaLabel, DgaLink, DgaList, DgaLocaleToggle, DgaLogoTile, DgaMapEmbed, DgaMenu, DgaMetric, DgaModal, DgaMultiselect, DgaNationalId, DgaNativeSelect, DgaNavRail, DgaNotificationInbox, DgaNumber, DgaNumberInput, DgaOffline, DgaOtp, DgaPageFeedback, DgaPageHero, DgaPagination, DgaPassword, DgaPersona, DgaPhoneInput, DgaPopover, DgaPreloader, DgaPrint, DgaProgress, DgaQr, DgaQuote, DgaRadio, DgaRating, DgaRichText, DgaRiyal, DgaRowActionsDef, DgaScrollTop, DgaSearchBar, DgaSection, DgaSelect, DgaShare, DgaSideInfo, DgaSideNav, DgaSignaturePad, DgaSkeleton, DgaSkipLink, DgaSlider, DgaSpinner, DgaStatStrip, DgaStepper, DgaSwitch, DgaTab, DgaTable, DgaTableColumnPicker, DgaTabs, DgaThemeToggle, DgaTimePicker, DgaTimeline, DgaToast, DgaToastOutlet, DgaToastService, DgaToc, DgaToolbar, DgaTooltip, DgaTopBar, DgaTour, DgaTree, DgaTreeSelect, DgaUpload, DgaVideoPlayer, DgaVirtualItem, DgaVirtualList, DgaWriting, dgaAddMonths, dgaClampDate, dgaCoerceDate, dgaCompareDays, dgaCurrentLocale, dgaCx, dgaDaysInMonth, dgaDetectFilePreviewKind, dgaEncodeBarcode, dgaEncodeQr, dgaFilterTree, dgaFindTreeItem, dgaFlattenTree, dgaFormStatusFromInvalid, dgaFormatDate, dgaFormatIban, dgaFormatNationalId, dgaGetCalendarParts, dgaIsAllowedMapEmbedUrl, dgaIsArabic, dgaIsRtl, dgaIsValidIban, dgaIsValidNationalId, dgaModeFromFormat, dgaMonthNames, dgaMonthStartWeekday, dgaNationalIdKind, dgaNormalizeIban, dgaNormalizeNationalId, dgaNormalizeTime, dgaParseDate, dgaPartsToDate, dgaPasswordStrength, dgaProvideValueAccessor, dgaResolveAppHref, dgaResolveLocalized, dgaResolveVideoSource, dgaSafeCssColor, dgaSafeHref, dgaSameDay, dgaTodayUtc, dgaTreeAncestors, dgaUiLocale, dgaVisibleTreeNodes, provideDgaIcons };
+export type { DgaAccordionSection, DgaAlertDisplay, DgaAlertVariant, DgaAnnouncementActionVariant, DgaAnnouncementAlign, DgaAnnouncementDensity, DgaAnnouncementElevation, DgaAnnouncementPersist, DgaAnnouncementTone, DgaAppShellAppearance, DgaAutocompleteOption, DgaAvatarSize, DgaBadgeSize, DgaBadgeVariant, DgaBarcodeFormat, DgaBarcodeMatrix, DgaBottomSheetSnap, DgaBreadcrumbItem, DgaBreadcrumbSeparator, DgaButtonEffect, DgaButtonSize, DgaButtonVariant, DgaCalendar, DgaCalendarEvent, DgaCalendarParts, DgaCardActionsAlign, DgaCardAppearance, DgaCardBadge, DgaCardBorder, DgaCardPadding, DgaCardShadow, DgaCarouselSlide, DgaCellContext, DgaCheckboxSize, DgaChipVariant, DgaChoiceLayout, DgaCommandAppearance, DgaCommandGroup, DgaCommandItem, DgaConfirmTone, DgaContentSwitcherItem, DgaContextMenuItem, DgaContextMenuItemType, DgaCurrency, DgaDateCalendar, DgaDateLocale, DgaDatePickerMode, DgaDescriptionItem, DgaDescriptionLayout, DgaDialogSize, DgaDividerOrientation, DgaDrawerSide, DgaDualNavCategory, DgaDualNavSection, DgaEmptyAppearance, DgaExportColumn, DgaExportData, DgaExportScope, DgaFaqItem, DgaFeedbackSubmit, DgaFilePreviewKind, DgaFilePreviewPresentation, DgaFilterItem, DgaFooterAppearance, DgaFooterColumn, DgaFooterIconGroup, DgaFooterIconLink, DgaFooterLink, DgaFooterLogo, DgaFormControlSize, DgaFormStatus, DgaGridCols, DgaGridGap, DgaHeroAppearance, DgaHeroImageMask, DgaHeroOverlayTone, DgaHeroSlide, DgaHeroTransition, DgaIconBadgeAppearance, DgaIconBadgeSize, DgaIconName, DgaIconNameInput, DgaIconSize, DgaIconTone, DgaImagePopupAnimation, DgaImagePopupImage, DgaImagePopupImageTransition, DgaImagePopupSource, DgaInfoListItem, DgaInputSize, DgaLinkVariant, DgaLocalizedString, DgaMapEmbedAspect, DgaMenuItem, DgaMetricAppearance, DgaMetricTrend, DgaModalAnimation, DgaModalSize, DgaMultiselectOption, DgaNationalIdKind, DgaNativeSelectSize, DgaNavRailActiveStyle, DgaNavRailAppearance, DgaNavRailItem, DgaNavRailPosition, DgaNavRailSize, DgaNotificationItem, DgaOfflineMode, DgaPageFeedbackAgreementLink, DgaPageFeedbackAnswer, DgaPageFeedbackOption, DgaPageFeedbackPhase, DgaPageFeedbackSubmit, DgaPageHeroTone, DgaPasswordStrength, DgaPasswordStrengthResult, DgaPhoneCountry, DgaPhoneCountryName, DgaPopoverPlacement, DgaPreloaderPersist, DgaProgressAppearance, DgaProgressSize, DgaProgressTone, DgaQrAnimate, DgaQrErrorCorrection, DgaQrMatrix, DgaQrSize, DgaQrSizeToken, DgaQrView, DgaRadioSize, DgaRatingSize, DgaRiyalAppearance, DgaRiyalSize, DgaRiyalTone, DgaScrollTopPosition, DgaSearchBarSize, DgaSectionTone, DgaSectionWidth, DgaSelectOpenMode, DgaSelectOption, DgaSelectSize, DgaShareAppearance, DgaSideInfoItem, DgaSideNavGroup, DgaSideNavItem, DgaSkeletonAnimation, DgaSkeletonRadius, DgaSkeletonShape, DgaSkeletonSize, DgaSliderSize, DgaSortDir, DgaSpinnerSize, DgaSpinnerTone, DgaStampNotice, DgaStatStripItem, DgaStatStripTrend, DgaStep, DgaStepStatus, DgaSwitchSize, DgaTabItem, DgaTableColumn, DgaTableDensity, DgaTableFilterEvent, DgaTablePageEvent, DgaTableResolvedView, DgaTableSortEvent, DgaTableViewMode, DgaThemeToggleSurface, DgaTimeFormat, DgaTimePickerFormat, DgaTimePickerSize, DgaTimelineItem, DgaToastAnimation, DgaToastLocation, DgaToastRequest, DgaToastShowOptions, DgaToastVariant, DgaTocItem, DgaTooltipPlacement, DgaTooltipVariant, DgaTourPersist, DgaTourPlacement, DgaTourStep, DgaTreeItem, DgaTreeSelectSize, DgaUploadAppearance, DgaUploadFile, DgaUploadRejectReason, DgaUploadRejection, DgaVideoProvider, DgaVideoRatio, DgaVideoSourceInfo, DgaVirtualItemContext, DgaWritingEffect };