@a.nemreen/dga-ui 0.3.14 → 0.3.16

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

@@ -1,9 +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';
+import * as _a_nemreen_dga_tokens from '@a.nemreen/dga-tokens';
+import { DgaLocale } from '@a.nemreen/dga-tokens';
 
 type DgaWritingEffect = 'typewriter' | 'glow';
 /**
@@ -47,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. */
@@ -71,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';
@@ -234,12 +244,12 @@ declare class DgaAvatar {
 }
 
 /**
- * Icon name union + RTL-flip set. Kept off the SVG registry so chrome
- * components can import names without the full glyph map.
+ * Icon name union + RTL-flip set. Kept off the SVG catalog so chrome
+ * components can import names without the HugeIcons glyph map.
  */
-declare const DGA_ICON_NAMES: readonly ["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_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<"success" | "info" | "warning" | "error" | "access" | "check" | "close" | "helpCircle" | "alertCircle" | "eye" | "eyeOff" | "eyeOffSlash" | "filter" | "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_LOGICAL_ICON_NAMES: Set<"link" | "close" | "copy" | "error" | "pause" | "menu" | "search" | "filter" | "mask" | "success" | "info" | "warning" | "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" | "cloud" | "colorPicker" | "colors" | "cookie" | "desert" | "devices" | "disability" | "door" | "download" | "droplet" | "external" | "eye" | "eyeOff" | "eyeOffSlash" | "facebook" | "fire" | "flash" | "folder" | "glasses" | "globe" | "heading" | "headphones" | "helpCircle" | "highlighter" | "home" | "huawei" | "idCard" | "instagram" | "letterSpacing" | "linkAlt" | "linkedin" | "location" | "lock" | "lockPassword" | "logout" | "mail" | "maximize" | "menuAlt" | "message" | "mic" | "minus" | "moon" | "moonAlt" | "moonCloud" | "moreHorizontal" | "moreVertical" | "paintBoard" | "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):
@@ -250,18 +260,22 @@ declare const DGA_LOGICAL_ICON_NAMES: Set<"success" | "info" | "warning" | "erro
  */
 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 extraIcons;
+    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<"success" | "info" | "warning" | "error" | "access" | "check" | "close" | "helpCircle" | "alertCircle" | "eye" | "eyeOff" | "eyeOffSlash" | "filter" | "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" | 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. */
@@ -293,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';
 /**
@@ -357,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<"success" | "info" | "warning" | "error" | "access" | "check" | "close" | "helpCircle" | "alertCircle" | "eye" | "eyeOff" | "eyeOffSlash" | "filter" | "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" | null>;
+    readonly startIcon: _angular_core.InputSignal<"link" | "close" | "copy" | "error" | "pause" | "menu" | "search" | "filter" | "mask" | "success" | "info" | "warning" | "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" | "cloud" | "colorPicker" | "colors" | "cookie" | "desert" | "devices" | "disability" | "door" | "download" | "droplet" | "external" | "eye" | "eyeOff" | "eyeOffSlash" | "facebook" | "fire" | "flash" | "folder" | "glasses" | "globe" | "heading" | "headphones" | "helpCircle" | "highlighter" | "home" | "huawei" | "idCard" | "instagram" | "letterSpacing" | "linkAlt" | "linkedin" | "location" | "lock" | "lockPassword" | "logout" | "mail" | "maximize" | "menuAlt" | "message" | "mic" | "minus" | "moon" | "moonAlt" | "moonCloud" | "moreHorizontal" | "moreVertical" | "paintBoard" | "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<"success" | "info" | "warning" | "error" | "access" | "check" | "close" | "helpCircle" | "alertCircle" | "eye" | "eyeOff" | "eyeOffSlash" | "filter" | "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" | null>;
+    readonly endIcon: _angular_core.InputSignal<"link" | "close" | "copy" | "error" | "pause" | "menu" | "search" | "filter" | "mask" | "success" | "info" | "warning" | "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" | "cloud" | "colorPicker" | "colors" | "cookie" | "desert" | "devices" | "disability" | "door" | "download" | "droplet" | "external" | "eye" | "eyeOff" | "eyeOffSlash" | "facebook" | "fire" | "flash" | "folder" | "glasses" | "globe" | "heading" | "headphones" | "helpCircle" | "highlighter" | "home" | "huawei" | "idCard" | "instagram" | "letterSpacing" | "linkAlt" | "linkedin" | "location" | "lock" | "lockPassword" | "logout" | "mail" | "maximize" | "menuAlt" | "message" | "mic" | "minus" | "moon" | "moonAlt" | "moonCloud" | "moreHorizontal" | "moreVertical" | "paintBoard" | "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>;
@@ -421,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 {
@@ -461,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>;
@@ -468,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>;
@@ -487,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;
@@ -506,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>;
 }
 
 /**
@@ -588,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>;
 }
@@ -662,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;
@@ -797,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. */
@@ -867,6 +1236,144 @@ 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 DgaRichTool = 'bold' | 'italic' | 'underline' | 'strike' | 'h2' | 'h3' | 'ul' | 'ol' | 'quote' | 'alignStart' | 'alignCenter' | 'alignEnd' | 'link' | 'clear';
+/**
+ * Contenteditable rich-text field: inline styles, headings, lists, quote,
+ * alignment, and links. `value` is sanitized HTML.
+ *
+ * @example
+ * ```html
+ * <dga-rich-text [(value)]="html" label="الوصف" />
+ * ```
+ */
+declare class DgaRichText {
+    private readonly destroyRef;
+    private readonly editorRef;
+    private readonly linkInputRef;
+    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 active;
+    private readonly block;
+    /** Last HTML this component published. External writes differ from this. */
+    private owned;
+    private range;
+    readonly empty: _angular_core.WritableSignal<boolean>;
+    readonly linkOpen: _angular_core.WritableSignal<boolean>;
+    readonly linkUrl: _angular_core.WritableSignal<string>;
+    readonly labelId: string;
+    readonly toolbarLabel: _angular_core.Signal<"شريط التنسيق" | "Formatting toolbar">;
+    readonly labels: _angular_core.Signal<{
+        bold: string;
+        italic: string;
+        underline: string;
+        strike: string;
+        h2: string;
+        h3: string;
+        ul: string;
+        ol: string;
+        quote: string;
+        alignStart: string;
+        alignCenter: string;
+        alignEnd: string;
+        link: string;
+        clear: string;
+        linkUrl: string;
+        apply: string;
+        cancel: string;
+    }>;
+    readonly tools: _angular_core.Signal<{
+        id: DgaRichTool;
+        label: string;
+        text: boolean;
+        sep: boolean;
+    }[]>;
+    constructor();
+    pressed(id: DgaRichTool): boolean;
+    keepSelection(event: Event): void;
+    onTool(id: DgaRichTool): void;
+    onInput(): void;
+    onBlur(): void;
+    onCaret(): void;
+    onKeydown(event: KeyboardEvent): void;
+    openLink(): void;
+    closeLink(): void;
+    applyLink(): void;
+    private exec;
+    private formatBlock;
+    private clearFormat;
+    private explicitAlign;
+    private alignCommand;
+    private refreshActive;
+    private publish;
+    private restoreSelection;
+    private captureRange;
+    private rangeIsCollapsed;
+    private anchorFromSelection;
+    private direction;
+    private editorEl;
+    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;
@@ -895,6 +1402,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 {
@@ -1001,8 +1548,8 @@ 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<"success" | "info" | "warning" | "error" | "access" | "check" | "close" | "helpCircle" | "alertCircle" | "eye" | "eyeOff" | "eyeOffSlash" | "filter" | "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">;
-    readonly iconTone: _angular_core.Signal<"success" | "warning" | "error" | "muted" | "current">;
+    readonly iconName: _angular_core.Signal<"link" | "close" | "copy" | "error" | "pause" | "menu" | "search" | "filter" | "mask" | "success" | "info" | "warning" | "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" | "cloud" | "colorPicker" | "colors" | "cookie" | "desert" | "devices" | "disability" | "door" | "download" | "droplet" | "external" | "eye" | "eyeOff" | "eyeOffSlash" | "facebook" | "fire" | "flash" | "folder" | "glasses" | "globe" | "heading" | "headphones" | "helpCircle" | "highlighter" | "home" | "huawei" | "idCard" | "instagram" | "letterSpacing" | "linkAlt" | "linkedin" | "location" | "lock" | "lockPassword" | "logout" | "mail" | "maximize" | "menuAlt" | "message" | "mic" | "minus" | "moon" | "moonAlt" | "moonCloud" | "moreHorizontal" | "moreVertical" | "paintBoard" | "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<"error" | "success" | "warning" | "muted" | "current">;
     readonly showCountdown: _angular_core.Signal<boolean>;
     readonly reduceMotion: _angular_core.WritableSignal<boolean>;
     private readonly animClass;
@@ -1179,8 +1726,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<"success" | "info" | "warning" | "error" | "access" | "check" | "close" | "helpCircle" | "alertCircle" | "eye" | "eyeOff" | "eyeOffSlash" | "filter" | "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" | null>;
+    readonly leadingIcon: _angular_core.InputSignal<"link" | "close" | "copy" | "error" | "pause" | "menu" | "search" | "filter" | "mask" | "success" | "info" | "warning" | "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" | "cloud" | "colorPicker" | "colors" | "cookie" | "desert" | "devices" | "disability" | "door" | "download" | "droplet" | "external" | "eye" | "eyeOff" | "eyeOffSlash" | "facebook" | "fire" | "flash" | "folder" | "glasses" | "globe" | "heading" | "headphones" | "helpCircle" | "highlighter" | "home" | "huawei" | "idCard" | "instagram" | "letterSpacing" | "linkAlt" | "linkedin" | "location" | "lock" | "lockPassword" | "logout" | "mail" | "maximize" | "menuAlt" | "message" | "mic" | "minus" | "moon" | "moonAlt" | "moonCloud" | "moreHorizontal" | "moreVertical" | "paintBoard" | "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. */
@@ -1220,7 +1772,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';
@@ -1441,6 +1993,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;
@@ -1452,8 +2097,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>;
@@ -1496,6 +2145,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;
@@ -1506,6 +2158,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';
@@ -1634,8 +2343,8 @@ 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<"success" | "info" | "warning" | "error" | "access" | "check" | "close" | "helpCircle" | "alertCircle" | "eye" | "eyeOff" | "eyeOffSlash" | "filter" | "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">;
-    readonly iconTone: _angular_core.Signal<"success" | "warning" | "error" | "muted" | "current">;
+    readonly iconName: _angular_core.Signal<"link" | "close" | "copy" | "error" | "pause" | "menu" | "search" | "filter" | "mask" | "success" | "info" | "warning" | "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" | "cloud" | "colorPicker" | "colors" | "cookie" | "desert" | "devices" | "disability" | "door" | "download" | "droplet" | "external" | "eye" | "eyeOff" | "eyeOffSlash" | "facebook" | "fire" | "flash" | "folder" | "glasses" | "globe" | "heading" | "headphones" | "helpCircle" | "highlighter" | "home" | "huawei" | "idCard" | "instagram" | "letterSpacing" | "linkAlt" | "linkedin" | "location" | "lock" | "lockPassword" | "logout" | "mail" | "maximize" | "menuAlt" | "message" | "mic" | "minus" | "moon" | "moonAlt" | "moonCloud" | "moreHorizontal" | "moreVertical" | "paintBoard" | "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<"error" | "success" | "warning" | "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>;
 }
@@ -1864,6 +2573,91 @@ 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>;
 }
 
+/**
+ * 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';
+/**
+ * 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.
+ *
+ * @example
+ * ```html
+ * <dga-offline sticky />
+ * ```
+ */
+declare class DgaOffline {
+    private readonly destroyRef;
+    /** 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();
+    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.
@@ -1878,6 +2672,37 @@ declare class DgaSkipLink {
     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;
+    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 {
     private readonly accordion;
     readonly title: _angular_core.InputSignal<string>;
@@ -2106,6 +2931,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.
@@ -2118,7 +2945,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 {
@@ -2137,6 +2964,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;
@@ -2277,7 +3154,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<"right" | "left" | "start" | "end" | null>;
     readonly offsetCss: _angular_core.Signal<string>;
     readonly tooltipPlacement: _angular_core.Signal<"start" | "end">;
     readonly iconSize: _angular_core.Signal<"sm" | "md" | "lg">;
@@ -2317,6 +3194,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>;
@@ -2418,7 +3343,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<"success" | "info" | "warning" | "error" | "access" | "check" | "close" | "helpCircle" | "alertCircle" | "eye" | "eyeOff" | "eyeOffSlash" | "filter" | "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" | null>;
+    readonly icon: _angular_core.InputSignal<"link" | "close" | "copy" | "error" | "pause" | "menu" | "search" | "filter" | "mask" | "success" | "info" | "warning" | "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" | "cloud" | "colorPicker" | "colors" | "cookie" | "desert" | "devices" | "disability" | "door" | "download" | "droplet" | "external" | "eye" | "eyeOff" | "eyeOffSlash" | "facebook" | "fire" | "flash" | "folder" | "glasses" | "globe" | "heading" | "headphones" | "helpCircle" | "highlighter" | "home" | "huawei" | "idCard" | "instagram" | "letterSpacing" | "linkAlt" | "linkedin" | "location" | "lock" | "lockPassword" | "logout" | "mail" | "maximize" | "menuAlt" | "message" | "mic" | "minus" | "moon" | "moonAlt" | "moonCloud" | "moreHorizontal" | "moreVertical" | "paintBoard" | "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[]>;
@@ -2457,7 +3382,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>;
@@ -2823,11 +3748,14 @@ 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>;
@@ -2881,6 +3809,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;
@@ -2911,6 +3841,10 @@ declare class DgaHero {
     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;
@@ -2967,7 +3901,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<"success" | "info" | "warning" | "error" | "access" | "check" | "close" | "helpCircle" | "alertCircle" | "eye" | "eyeOff" | "eyeOffSlash" | "filter" | "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" | null>;
+    readonly icon: _angular_core.InputSignal<"link" | "close" | "copy" | "error" | "pause" | "menu" | "search" | "filter" | "mask" | "success" | "info" | "warning" | "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" | "cloud" | "colorPicker" | "colors" | "cookie" | "desert" | "devices" | "disability" | "door" | "download" | "droplet" | "external" | "eye" | "eyeOff" | "eyeOffSlash" | "facebook" | "fire" | "flash" | "folder" | "glasses" | "globe" | "heading" | "headphones" | "helpCircle" | "highlighter" | "home" | "huawei" | "idCard" | "instagram" | "letterSpacing" | "linkAlt" | "linkedin" | "location" | "lock" | "lockPassword" | "logout" | "mail" | "maximize" | "menuAlt" | "message" | "mic" | "minus" | "moon" | "moonAlt" | "moonCloud" | "moreHorizontal" | "moreVertical" | "paintBoard" | "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>;
@@ -3115,6 +4049,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>;
@@ -3366,6 +4362,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';
@@ -3384,23 +4572,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>;
@@ -3409,35 +4841,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 {
@@ -3597,5 +5211,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_LOGICAL_ICON_NAMES, DGA_PHONE_COUNTRIES, DGA_RIYAL_SVG_PATH, DGA_RIYAL_VIEWBOX, DgaAccordion, DgaAccordionItem, DgaAlert, DgaAnnouncementBar, DgaAppShell, DgaAuthCard, DgaAutocomplete, DgaAvatar, DgaBadge, DgaBreadcrumb, DgaButton, DgaCard, DgaCardMedia, DgaCarousel, DgaCarouselSlideDirective, 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, 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, dgaIsArabic, dgaIsRtl, dgaNormalizeTime, dgaProvideValueAccessor, dgaResolveAppHref, dgaResolveLocalized, dgaResolveVideoSource, dgaSafeCssColor, dgaSafeHref, 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, 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, DgaPhoneCountry, DgaPhoneCountryName, DgaPreloaderPersist, DgaProgressAppearance, DgaProgressSize, DgaProgressTone, DgaRadioSize, DgaRatingSize, DgaRiyalAppearance, DgaRiyalSize, DgaRiyalTone, 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 };