@a.nemreen/dga-ui 0.2.2 → 0.2.4

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

@@ -1,27 +1,37 @@
 import * as _angular_core from '@angular/core';
-import { OnDestroy, OnInit } from '@angular/core';
+import { Type, Provider, OnDestroy, OnInit } from '@angular/core';
 import { SafeHtml } 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';
 
 type DgaButtonVariant = 'primary' | 'secondary' | 'subtle' | 'outline' | 'outlineMuted' | 'outlineInverse' | 'ghost' | 'danger' | 'inverse';
 type DgaButtonSize = 'sm' | 'md' | 'lg';
 declare class DgaButton {
     private readonly destroyRef;
+    private readonly host;
+    private readonly renderer;
     readonly variant: _angular_core.InputSignal<DgaButtonVariant>;
     readonly size: _angular_core.InputSignal<DgaButtonSize>;
     /** Square control sized to the icon (no horizontal padding). */
     readonly iconOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** When > 0, disables the host for this many ms after each click. */
+    /** 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. */
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Exposed for host bindings (Angular 22 requires public host expressions). */
     readonly cooling: _angular_core.WritableSignal<boolean>;
     private cooldownTimer;
+    private spinnerEl;
+    readonly busy: _angular_core.Signal<boolean>;
     readonly classes: _angular_core.Signal<string>;
     constructor();
     onHostClick(): void;
+    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; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DgaButton, "button[dgaButton], a[dgaButton]", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "iconOnly": { "alias": "iconOnly"; "required": false; "isSignal": true; }; "cooldownMs": { "alias": "cooldownMs"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 type DgaBadgeVariant = 'neutral' | 'primary' | 'success' | 'info' | 'warning' | 'error';
@@ -123,7 +133,7 @@ declare class DgaProgress {
     readonly circumference: number;
     readonly clamped: _angular_core.Signal<number>;
     readonly dashOffset: _angular_core.Signal<number>;
-    readonly hostClasses: _angular_core.Signal<"inline-flex" | "block w-full">;
+    readonly hostClasses: _angular_core.Signal<"block w-full" | "inline-flex">;
     readonly trackClasses: _angular_core.Signal<string>;
     readonly barClasses: _angular_core.Signal<string>;
     readonly radialWrapClasses: _angular_core.Signal<string>;
@@ -285,6 +295,28 @@ declare class DgaFormControl {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaFormControl, "dga-form-control", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "filled": { "alias": "filled"; "required": false; "isSignal": true; }; "startIcon": { "alias": "startIcon"; "required": false; "isSignal": true; }; "endIcon": { "alias": "endIcon"; "required": false; "isSignal": true; }; }, {}, never, ["[dgaStart]", "*", "[dgaEnd]"], true, never>;
 }
 
+/**
+ * Registers `component` as an `NG_VALUE_ACCESSOR`, so it can be used with
+ * `formControl` / `formControlName` / `ngModel`.
+ *
+ * Usage on a standalone component:
+ * ```ts
+ * @Component({
+ *   ...
+ *   providers: [dgaProvideValueAccessor(DgaMyControl)],
+ * })
+ * export class DgaMyControl implements ControlValueAccessor { ... }
+ * ```
+ *
+ * Each CVA component should:
+ * - keep its existing `input`/`model`/`output` two-way-binding API untouched;
+ * - implement `writeValue`, `registerOnChange`, `registerOnTouched` and,
+ *   when relevant, `setDisabledState`;
+ * - call the registered `onChange` alongside its existing `*Change` output
+ *   emit, and call `onTouched` on blur.
+ */
+declare function dgaProvideValueAccessor(component: Type<unknown>): Provider;
+
 declare class DgaLabel {
     /** Optional required indicator styling hook. */
     readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -330,7 +362,7 @@ interface DgaSelectOption {
 }
 type DgaSelectOpenMode = 'dropdown' | 'always';
 type DgaSelectSize = DgaFormControlSize;
-declare class DgaSelect {
+declare class DgaSelect implements ControlValueAccessor {
     private static nextId;
     private readonly host;
     readonly listId: string;
@@ -349,9 +381,13 @@ declare class DgaSelect {
     readonly removeLabel: _angular_core.InputSignal<string>;
     readonly clearLabel: _angular_core.InputSignal<string>;
     readonly emptyLabel: _angular_core.InputSignal<string>;
-    readonly disabled: _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 valueChange: _angular_core.OutputEmitterRef<string | string[]>;
+    private onChange;
+    private onTouched;
     readonly open: _angular_core.WritableSignal<boolean>;
     readonly query: _angular_core.WritableSignal<string>;
     readonly activeIndex: _angular_core.WritableSignal<number>;
@@ -381,11 +417,15 @@ declare class DgaSelect {
     clear(): void;
     onDocClick(event: MouseEvent): void;
     private commit;
+    writeValue(value: string | string[]): void;
+    registerOnChange(fn: (value: string | string[]) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
     private moveActive;
     private firstEnabledIndex;
     private lastEnabledIndex;
     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; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "dgaInvalid"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, 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; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "dgaInvalid"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
 /**
@@ -410,20 +450,28 @@ declare class DgaField {
 }
 
 type DgaSwitchSize = 'sm' | 'md' | 'lg';
-declare class DgaSwitch {
+declare class DgaSwitch implements ControlValueAccessor {
     readonly checked: _angular_core.ModelSignal<boolean>;
     readonly size: _angular_core.InputSignal<DgaSwitchSize>;
     readonly label: _angular_core.InputSignal<string>;
-    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly cvaDisabled;
+    readonly disabled: _angular_core.Signal<boolean>;
     readonly changed: _angular_core.OutputEmitterRef<boolean>;
+    private onChange;
+    onTouched: () => void;
     readonly trackClasses: _angular_core.Signal<string>;
     readonly thumbClasses: _angular_core.Signal<string>;
     toggle(): void;
+    writeValue(value: boolean): void;
+    registerOnChange(fn: (value: boolean) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaSwitch, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaSwitch, "dga-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "changed": "changed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaSwitch, "dga-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "changed": "changed"; }, never, never, true, never>;
 }
 
-declare class DgaNumberInput {
+declare class DgaNumberInput implements ControlValueAccessor {
     readonly valueInput: _angular_core.InputSignal<number>;
     readonly value: _angular_core.WritableSignal<number>;
     readonly min: _angular_core.InputSignal<number>;
@@ -431,12 +479,18 @@ declare class DgaNumberInput {
     readonly stepSize: _angular_core.InputSignal<number>;
     readonly size: _angular_core.InputSignal<DgaFormControlSize>;
     readonly label: _angular_core.InputSignal<string>;
+    readonly controlId: _angular_core.InputSignal<string>;
+    readonly name: _angular_core.InputSignal<string>;
     readonly incrementLabel: _angular_core.InputSignal<string>;
     readonly decrementLabel: _angular_core.InputSignal<string>;
-    readonly disabled: _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 status: _angular_core.InputSignal<DgaFormStatus>;
     readonly valueChange: _angular_core.OutputEmitterRef<number>;
+    private onChange;
+    onTouched: () => void;
     readonly resolvedStatus: _angular_core.Signal<DgaFormStatus>;
     readonly wrapClasses: _angular_core.Signal<string>;
     step(dir: 1 | -1): void;
@@ -444,8 +498,12 @@ declare class DgaNumberInput {
     finiteOrNull(n: number): number | null;
     private clamp;
     private commit;
+    writeValue(value: number): void;
+    registerOnChange(fn: (value: number) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaNumberInput, never>;
-    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; }; "incrementLabel": { "alias": "incrementLabel"; "required": false; "isSignal": true; }; "decrementLabel": { "alias": "decrementLabel"; "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<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>;
 }
 
 declare class DgaSlider {
@@ -455,43 +513,63 @@ declare class DgaSlider {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DgaSlider, "input[type=\"range\"][dgaSlider]", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-declare class DgaOtp {
+declare class DgaOtp implements ControlValueAccessor {
     private cells;
     readonly length: _angular_core.InputSignal<number>;
     readonly value: _angular_core.ModelSignal<string>;
     readonly label: _angular_core.InputSignal<string>;
-    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** When `true`, allow `A-Z0-9` instead of digits only. */
+    readonly alphanumeric: _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 completed: _angular_core.OutputEmitterRef<string>;
+    private onChange;
+    onTouched: () => void;
     get slots(): number[];
     chars(): string[];
+    private sanitize;
     cellClasses(): string;
     onInput(index: number, raw: string): void;
     onKey(index: number, event: KeyboardEvent): void;
     onPaste(event: ClipboardEvent): void;
     private commit;
+    writeValue(value: string): void;
+    registerOnChange(fn: (value: string) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaOtp, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaOtp, "dga-otp", never, { "length": { "alias": "length"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "dgaInvalid"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "completed": "completed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaOtp, "dga-otp", never, { "length": { "alias": "length"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "alphanumeric": { "alias": "alphanumeric"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "dgaInvalid"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "completed": "completed"; }, never, never, true, never>;
 }
 
-declare class DgaChipInput {
+declare class DgaChipInput implements ControlValueAccessor {
     readonly valueInput: _angular_core.InputSignal<string[]>;
     readonly value: _angular_core.WritableSignal<string[]>;
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly label: _angular_core.InputSignal<string>;
     readonly removeLabel: _angular_core.InputSignal<string>;
-    readonly disabled: _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 status: _angular_core.InputSignal<DgaFormStatus>;
     readonly valueChange: _angular_core.OutputEmitterRef<string[]>;
     draft: string;
+    private onChange;
+    onTouched: () => void;
     readonly resolvedStatus: _angular_core.Signal<DgaFormStatus>;
     readonly wrapClasses: _angular_core.Signal<string>;
     commit(event: Event): void;
     remove(tag: string): void;
     onBackspace(): void;
+    writeValue(value: string[]): void;
+    registerOnChange(fn: (value: string[]) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    private emitValue;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaChipInput, never>;
-    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; }; "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<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; }; "invalid": { "alias": "dgaInvalid"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
 interface DgaUploadFile {
@@ -500,8 +578,12 @@ interface DgaUploadFile {
     size: number;
     file?: File;
 }
+interface DgaUploadRejection {
+    file: File;
+    reason: 'maxSize';
+}
 type DgaUploadAppearance = 'zone' | 'browse';
-declare class DgaUpload {
+declare class DgaUpload implements ControlValueAccessor {
     readonly filesInput: _angular_core.InputSignal<DgaUploadFile[]>;
     readonly files: _angular_core.WritableSignal<DgaUploadFile[]>;
     readonly accept: _angular_core.InputSignal<string>;
@@ -511,10 +593,16 @@ declare class DgaUpload {
     readonly hint: _angular_core.InputSignal<string>;
     readonly browseLabel: _angular_core.InputSignal<string>;
     readonly removeLabel: _angular_core.InputSignal<string>;
-    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly cvaDisabled;
+    readonly disabled: _angular_core.Signal<boolean>;
     readonly maxSize: _angular_core.InputSignal<number>;
     readonly filesChange: _angular_core.OutputEmitterRef<DgaUploadFile[]>;
+    /** Emitted when picked/dropped files were filtered out because they exceed `maxSize`. */
+    readonly rejected: _angular_core.OutputEmitterRef<DgaUploadRejection[]>;
     readonly dragging: _angular_core.ModelSignal<boolean>;
+    private onChange;
+    onTouched: () => void;
     readonly zoneClasses: _angular_core.Signal<string>;
     onDragOver(event: DragEvent): void;
     onDrop(event: DragEvent): void;
@@ -523,8 +611,12 @@ declare class DgaUpload {
     formatSize(bytes: number): string;
     private addFiles;
     private commit;
+    writeValue(value: DgaUploadFile[]): void;
+    registerOnChange(fn: (value: DgaUploadFile[]) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaUpload, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaUpload, "dga-upload", never, { "filesInput": { "alias": "files"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "browseLabel": { "alias": "browseLabel"; "required": false; "isSignal": true; }; "removeLabel": { "alias": "removeLabel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "maxSize": { "alias": "maxSize"; "required": false; "isSignal": true; }; "dragging": { "alias": "dragging"; "required": false; "isSignal": true; }; }, { "filesChange": "filesChange"; "dragging": "draggingChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaUpload, "dga-upload", never, { "filesInput": { "alias": "files"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "browseLabel": { "alias": "browseLabel"; "required": false; "isSignal": true; }; "removeLabel": { "alias": "removeLabel"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "maxSize": { "alias": "maxSize"; "required": false; "isSignal": true; }; "dragging": { "alias": "dragging"; "required": false; "isSignal": true; }; }, { "filesChange": "filesChange"; "rejected": "rejected"; "dragging": "draggingChange"; }, never, never, true, never>;
 }
 
 interface DgaPhoneCountry {
@@ -541,7 +633,7 @@ declare const DGA_PHONE_COUNTRIES: DgaPhoneCountry[];
  * Phone field with country-code prefix select.
  * The control group is always LTR so digits and codes read correctly in RTL pages.
  */
-declare class DgaPhoneInput {
+declare class DgaPhoneInput implements ControlValueAccessor {
     readonly countries: _angular_core.InputSignal<DgaPhoneCountry[]>;
     readonly countryCode: _angular_core.ModelSignal<string>;
     readonly nationalNumber: _angular_core.ModelSignal<string>;
@@ -550,14 +642,24 @@ declare class DgaPhoneInput {
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly autocomplete: _angular_core.InputSignal<string>;
     readonly codeLabel: _angular_core.InputSignal<string>;
-    readonly disabled: _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>;
-    /** Full E.164-ish value: code + national digits. */
-    readonly value: _angular_core.Signal<string>;
+    /** Full E.164-ish combined value: country code + national digits. */
+    readonly value: _angular_core.ModelSignal<string>;
     readonly groupClasses: _angular_core.Signal<string>;
+    private onChange;
+    onTouched: () => void;
+    constructor();
+    writeValue(value: string): void;
+    registerOnChange(fn: (value: string) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    private parseValue;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaPhoneInput, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaPhoneInput, "dga-phone-input", never, { "countries": { "alias": "countries"; "required": false; "isSignal": true; }; "countryCode": { "alias": "countryCode"; "required": false; "isSignal": true; }; "nationalNumber": { "alias": "nationalNumber"; "required": false; "isSignal": true; }; "controlId": { "alias": "controlId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "codeLabel": { "alias": "codeLabel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; }, { "countryCode": "countryCodeChange"; "nationalNumber": "nationalNumberChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaPhoneInput, "dga-phone-input", never, { "countries": { "alias": "countries"; "required": false; "isSignal": true; }; "countryCode": { "alias": "countryCode"; "required": false; "isSignal": true; }; "nationalNumber": { "alias": "nationalNumber"; "required": false; "isSignal": true; }; "controlId": { "alias": "controlId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "codeLabel": { "alias": "codeLabel"; "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": { "alias": "value"; "required": false; "isSignal": true; }; }, { "countryCode": "countryCodeChange"; "nationalNumber": "nationalNumberChange"; "value": "valueChange"; }, never, never, true, never>;
 }
 
 /** @deprecated Prefer `DgaSelectOption` — alias kept for existing imports. */
@@ -569,13 +671,15 @@ declare class DgaAutocomplete {
     readonly value: _angular_core.WritableSignal<string>;
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly label: _angular_core.InputSignal<string>;
+    readonly size: _angular_core.InputSignal<_a_nemreen_dga_ui.DgaFormControlSize>;
+    readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly status: _angular_core.InputSignal<DgaFormStatus>;
     readonly valueChange: _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; }; "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; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
 /** @deprecated Prefer `DgaSelectOption` — alias kept for existing imports. */
@@ -588,13 +692,16 @@ declare class DgaMultiselect {
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly label: _angular_core.InputSignal<string>;
     readonly removeLabel: _angular_core.InputSignal<string>;
+    readonly size: _angular_core.InputSignal<_a_nemreen_dga_ui.DgaFormControlSize>;
+    readonly searchable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly status: _angular_core.InputSignal<DgaFormStatus>;
     readonly valueChange: _angular_core.OutputEmitterRef<string[]>;
     onValueChange(next: string | string[]): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaMultiselect, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaMultiselect, "dga-multiselect", 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; }; "removeLabel": { "alias": "removeLabel"; "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<DgaMultiselect, "dga-multiselect", 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; }; "removeLabel": { "alias": "removeLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "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>;
 }
 
 /** Calendar system for date values and the picker UI. */
@@ -647,7 +754,7 @@ interface DgaDateRangeValue {
     end: string;
 }
 type PanelView = DgaDatePickerMode;
-declare class DgaDatePickerComponent {
+declare class DgaDatePickerComponent implements ControlValueAccessor {
     private readonly host;
     private readonly destroyRef;
     readonly inputId: string;
@@ -656,6 +763,8 @@ declare class DgaDatePickerComponent {
     readonly value: _angular_core.WritableSignal<string>;
     readonly startValue: _angular_core.ModelSignal<string>;
     readonly endValue: _angular_core.ModelSignal<string>;
+    private onChange;
+    private onTouched;
     readonly calendar: _angular_core.InputSignal<DgaDateCalendar>;
     readonly range: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly format: _angular_core.InputSignal<string>;
@@ -669,7 +778,9 @@ declare class DgaDatePickerComponent {
     readonly controlId: _angular_core.InputSignal<string>;
     readonly name: _angular_core.InputSignal<string>;
     readonly size: _angular_core.InputSignal<DgaFormControlSize>;
-    readonly disabled: _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 clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly editable: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -771,12 +882,16 @@ declare class DgaDatePickerComponent {
     private syncDraftFromModels;
     private parseRangeFromValue;
     private emitValues;
+    writeValue(value: string): void;
+    registerOnChange(fn: (value: string) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
     private isDateDisabled;
     private isMonthDisabled;
     private isYearDisabled;
     private initialViewParts;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaDatePickerComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaDatePickerComponent, "dga-date-picker", never, { "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; "startValue": { "alias": "startValue"; "required": false; "isSignal": true; }; "endValue": { "alias": "endValue"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "yearBefore": { "alias": "yearBefore"; "required": false; "isSignal": true; }; "yearAfter": { "alias": "yearAfter"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "controlId": { "alias": "controlId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "invalid": { "alias": "dgaInvalid"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "rangeSeparator": { "alias": "rangeSeparator"; "required": false; "isSignal": true; }; "todayLabel": { "alias": "todayLabel"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; "saveLabel": { "alias": "saveLabel"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "startValue": "startValueChange"; "endValue": "endValueChange"; "valueChange": "valueChange"; "rangeChange": "rangeChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaDatePickerComponent, "dga-date-picker", never, { "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; "startValue": { "alias": "startValue"; "required": false; "isSignal": true; }; "endValue": { "alias": "endValue"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "yearBefore": { "alias": "yearBefore"; "required": false; "isSignal": true; }; "yearAfter": { "alias": "yearAfter"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "controlId": { "alias": "controlId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "invalid": { "alias": "dgaInvalid"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "rangeSeparator": { "alias": "rangeSeparator"; "required": false; "isSignal": true; }; "todayLabel": { "alias": "todayLabel"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; "saveLabel": { "alias": "saveLabel"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "startValue": "startValueChange"; "endValue": "endValueChange"; "valueChange": "valueChange"; "rangeChange": "rangeChange"; }, never, never, true, never>;
 }
 interface DayCell {
     key: string;
@@ -791,6 +906,48 @@ interface DayCell {
     label?: string;
 }
 
+type DgaTimePickerSize = DgaNativeSelectSize;
+type DgaTimePickerFormat = '24h' | '12h';
+declare function pad2(n: number): string;
+/** Normalize to `HH:mm` (24h). Empty string when incomplete. */
+declare function dgaNormalizeTime(value: string): string;
+/**
+ * Time-of-day control (hour / minute selects). Value is `HH:mm` (24h).
+ * Pair with `dga-date-picker` for appointment-style datetime flows.
+ */
+declare class DgaTimePicker {
+    /** 24h `HH:mm` string. */
+    readonly value: _angular_core.ModelSignal<string>;
+    readonly format: _angular_core.InputSignal<DgaTimePickerFormat>;
+    readonly size: _angular_core.InputSignal<_a_nemreen_dga_ui.DgaFormControlSize>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly hourLabel: _angular_core.InputSignal<string>;
+    readonly minuteLabel: _angular_core.InputSignal<string>;
+    readonly periodLabel: _angular_core.InputSignal<string>;
+    readonly amLabel: _angular_core.InputSignal<string>;
+    readonly pmLabel: _angular_core.InputSignal<string>;
+    /** Minute step (1, 5, 15, …). */
+    readonly minuteStep: _angular_core.InputSignal<number>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly status: _angular_core.InputSignal<DgaFormStatus>;
+    readonly pad: typeof pad2;
+    readonly minuteOptions: _angular_core.Signal<number[]>;
+    readonly hourOptions: _angular_core.Signal<{
+        value: string;
+        label: string;
+    }[]>;
+    hourSelect(): string;
+    minuteSelect(): string;
+    periodSelect(): string;
+    onHour(raw: string): void;
+    onMinute(raw: string): void;
+    onPeriod(raw: string): void;
+    private commit;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaTimePicker, never>;
+    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>;
+}
+
 type DgaDialogSize = 'sm' | 'md' | 'lg';
 declare class DgaDialog {
     private readonly injector;
@@ -876,7 +1033,7 @@ declare class DgaToast implements OnDestroy {
     private timer;
     readonly classes: _angular_core.Signal<string>;
     readonly iconName: _angular_core.Signal<DgaIconName>;
-    readonly iconTone: _angular_core.Signal<"success" | "warning" | "error" | "muted" | "current">;
+    readonly iconTone: _angular_core.Signal<"warning" | "error" | "success" | "muted" | "current">;
     constructor();
     ngOnDestroy(): void;
     dismiss(): void;
@@ -995,10 +1152,16 @@ declare class DgaTooltip {
 }
 
 interface DgaMenuItem {
-    label: string;
-    value: string;
+    /** Required for actionable items; optional when `divider` is true. */
+    label?: string;
+    /** Required for actionable items; optional when `divider` is true. */
+    value?: string;
     icon?: DgaIconName;
     danger?: boolean;
+    /** Skipped in keyboard nav / click selection; renders with disabled styling. */
+    disabled?: boolean;
+    /** Renders as a separator (`role="separator"`) instead of a menu item. */
+    divider?: boolean;
 }
 declare class DgaMenu {
     private readonly host;
@@ -1014,7 +1177,12 @@ declare class DgaMenu {
     readonly showChevron: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Minimum panel width (e.g. share menus). */
     readonly menuMinWidth: _angular_core.InputSignal<string>;
-    readonly selected: _angular_core.OutputEmitterRef<string>;
+    /** Emits the full selected item. */
+    readonly selected: _angular_core.OutputEmitterRef<DgaMenuItem>;
+    /** Emits `item.value` alongside `selected` — handy for quick migrations. */
+    readonly selectedValue: _angular_core.OutputEmitterRef<string>;
+    readonly opened: _angular_core.OutputEmitterRef<void>;
+    readonly closed: _angular_core.OutputEmitterRef<void>;
     /** Viewport coords - panel is portaled to body so ancestors cannot clip it. */
     readonly panelStyle: _angular_core.WritableSignal<Record<string, string>>;
     private readonly seq;
@@ -1026,6 +1194,7 @@ declare class DgaMenu {
     triggerClasses(): string;
     menuClasses(): string;
     itemId(index: number): string;
+    trackItem(item: DgaMenuItem, index: number): string;
     itemClass(item: DgaMenuItem): string;
     toggle(event: Event): void;
     openMenu(): void;
@@ -1035,12 +1204,17 @@ declare class DgaMenu {
     onMenuKey(event: KeyboardEvent): void;
     onDocumentClick(event: MouseEvent): void;
     onDocumentKeydown(event: KeyboardEvent): void;
+    private isSelectable;
+    private firstSelectableIndex;
+    private lastSelectableIndex;
+    private stepIndex;
     private portalMenuToBody;
     private detachPortaledMenu;
     private syncPanelPosition;
+    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"; }, 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; }; "menuMinWidth": { "alias": "menuMinWidth"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "selected": "selected"; "selectedValue": "selectedValue"; "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
 }
 
 type DgaDrawerSide = 'start' | 'end';
@@ -1157,7 +1331,7 @@ declare class DgaAlert {
     readonly titleClasses: _angular_core.Signal<string>;
     readonly descriptionClasses: _angular_core.Signal<string>;
     readonly iconName: _angular_core.Signal<DgaIconName>;
-    readonly iconTone: _angular_core.Signal<"success" | "warning" | "error" | "muted" | "current">;
+    readonly iconTone: _angular_core.Signal<"warning" | "error" | "success" | "muted" | "current">;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaAlert, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaAlert, "dga-alert", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "shadow": { "alias": "shadow"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "display": { "alias": "display"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; }, { "dismissed": "dismissed"; }, never, ["*", "[dgaAlertActions]"], true, never>;
 }
@@ -1275,32 +1449,107 @@ declare class DgaPageFeedback {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaPageFeedback, "dga-page-feedback", never, { "question": { "alias": "question"; "required": false; "isSignal": true; }; "yesLabel": { "alias": "yesLabel"; "required": false; "isSignal": true; }; "noLabel": { "alias": "noLabel"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; "whyLabel": { "alias": "whyLabel"; "required": false; "isSignal": true; }; "whyHint": { "alias": "whyHint"; "required": false; "isSignal": true; }; "genderLabel": { "alias": "genderLabel"; "required": false; "isSignal": true; }; "commentLabel": { "alias": "commentLabel"; "required": false; "isSignal": true; }; "commentPlaceholder": { "alias": "commentPlaceholder"; "required": false; "isSignal": true; }; "submitLabel": { "alias": "submitLabel"; "required": false; "isSignal": true; }; "statistic": { "alias": "statistic"; "required": false; "isSignal": true; }; "thankYouMessage": { "alias": "thankYouMessage"; "required": false; "isSignal": true; }; "agreementBefore": { "alias": "agreementBefore"; "required": false; "isSignal": true; }; "participationLabel": { "alias": "participationLabel"; "required": false; "isSignal": true; }; "participationHref": { "alias": "participationHref"; "required": false; "isSignal": true; }; "agreementAnd": { "alias": "agreementAnd"; "required": false; "isSignal": true; }; "rulesLabel": { "alias": "rulesLabel"; "required": false; "isSignal": true; }; "rulesHref": { "alias": "rulesHref"; "required": false; "isSignal": true; }; "agreementAfter": { "alias": "agreementAfter"; "required": false; "isSignal": true; }; "defaultAgreement": { "alias": "defaultAgreement"; "required": false; "isSignal": true; }; "yesReasons": { "alias": "yesReasons"; "required": false; "isSignal": true; }; "noReasons": { "alias": "noReasons"; "required": false; "isSignal": true; }; "genderOptions": { "alias": "genderOptions"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; }, { "submitted": "submitted"; "closed": "closed"; }, never, ["[dgaPageFeedbackAgreement]"], true, never>;
 }
 
-type DgaCookieConsent = 'accepted' | 'declined' | null;
+/** Stored consent outcome. `custom` = per-category preferences were saved. */
+type DgaCookieConsent = 'accepted' | 'declined' | 'custom' | null;
+/** Horizontal placement. Logical `start`/`end` follow reading direction. */
+type DgaCookiesAlign = 'start' | 'center' | 'end';
+/**
+ * Banner anchor on the viewport.
+ * - `start` | `center` | `end` → bottom edge + that alignment (compact)
+ * - `bottom` | `top` → that edge, centered
+ * - `bottom-start` / `top-end` / … → explicit edge + alignment
+ */
+type DgaCookiesPosition = DgaCookiesAlign | 'bottom' | 'top' | 'bottom-start' | 'bottom-center' | 'bottom-end' | 'top-start' | 'top-center' | 'top-end';
+/** Optional cookie category for granular consent (GDPR-style preferences). */
+interface DgaCookieCategory {
+    id: string;
+    label: string;
+    description?: string;
+    /** Always enabled; toggle is disabled. */
+    required?: boolean;
+    /** Initial state when no stored preference exists (ignored when `required`). */
+    defaultEnabled?: boolean;
+}
+type DgaCookiePreferences = Record<string, boolean>;
+interface DgaCookieDecision {
+    consent: Exclude<DgaCookieConsent, null>;
+    preferences: DgaCookiePreferences;
+}
 /**
  * Privacy-compliant cookie consent banner.
- * Persists choice for 365 days; optional GA gating via `gaTrackingIds`.
+ * Persists choice (default 365 days); optional category preferences and GA gating.
  */
 declare class DgaCookies implements OnInit {
     private readonly destroyRef;
+    private readonly hostRef;
+    /** Original parent before body portal (restored on destroy). */
+    private portalHome;
     readonly compact: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Viewport anchor. Use `start` / `center` / `end` for bottom placement,
+     * or compound values like `top-end`. Prefer `align` to set horizontal only.
+     */
+    readonly position: _angular_core.InputSignal<DgaCookiesPosition>;
+    /** Horizontal alignment (`start` | `center` | `end`). Overrides `position` when set. */
+    readonly align: _angular_core.InputSignal<"" | DgaCookiesAlign>;
     /** Auto-open delay when no consent is stored. `0` disables auto-show. */
     readonly delayMs: _angular_core.InputSignal<number>;
+    /** When false, never auto-opens (call `show()` manually). */
+    readonly autoShow: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Show the dismiss (X) control. Dismiss does not persist a decision. */
+    readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Show the reject / decline non-essential button. */
+    readonly showDecline: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Show policy / terms links row. */
+    readonly showLinks: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Show Customize when `categories` are provided. */
+    readonly showCustomize: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Dim the page behind the banner (modal-style overlay). */
+    readonly overlay: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * @deprecated Prefer `overlay`. Same behavior — kept for backward compatibility.
+     */
+    readonly blocking: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Close the banner when the overlay backdrop is clicked (requires dismissible). */
+    readonly overlayClose: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly termsHref: _angular_core.InputSignal<string>;
     readonly privacyHref: _angular_core.InputSignal<string>;
+    /** Optional third policy link (cookie policy). Empty hides it. */
+    readonly cookiePolicyHref: _angular_core.InputSignal<string>;
+    readonly termsLabel: _angular_core.InputSignal<string>;
+    readonly privacyLabel: _angular_core.InputSignal<string>;
+    readonly cookiePolicyLabel: _angular_core.InputSignal<string>;
     readonly title: _angular_core.InputSignal<string>;
     readonly description: _angular_core.InputSignal<string>;
     readonly acceptLabel: _angular_core.InputSignal<string>;
     readonly declineLabel: _angular_core.InputSignal<string>;
-    /** Google Analytics IDs to disable on decline. */
+    readonly customizeLabel: _angular_core.InputSignal<string>;
+    readonly saveLabel: _angular_core.InputSignal<string>;
+    readonly icon: _angular_core.InputSignal<DgaIconName>;
+    /** Google Analytics IDs to disable on decline / when analytics is off. */
     readonly gaTrackingIds: _angular_core.InputSignal<string | readonly string[]>;
+    /** Consent cookie lifetime in days. */
+    readonly consentDays: _angular_core.InputSignal<number>;
+    /** Consent cookie name (also used as localStorage key prefix). */
+    readonly consentCookieName: _angular_core.InputSignal<string>;
+    /** Extra cookies to delete when analytics/marketing is denied. */
+    readonly analyticsCookieNames: _angular_core.InputSignal<readonly string[]>;
+    /** Granular categories. When set, Customize / Save Preferences become available. */
+    readonly categories: _angular_core.InputSignal<readonly DgaCookieCategory[]>;
     readonly accepted: _angular_core.OutputEmitterRef<void>;
     readonly declined: _angular_core.OutputEmitterRef<void>;
     readonly closed: _angular_core.OutputEmitterRef<void>;
-    readonly decided: _angular_core.OutputEmitterRef<"accepted" | "declined">;
+    readonly decided: _angular_core.OutputEmitterRef<"accepted" | "declined" | "custom">;
+    readonly preferencesChange: _angular_core.OutputEmitterRef<DgaCookiePreferences>;
+    readonly decision: _angular_core.OutputEmitterRef<DgaCookieDecision>;
     /** Controls enter/exit animation state. */
     readonly visible: _angular_core.WritableSignal<boolean>;
     /** Keeps the panel in the DOM while exit animation plays. */
     readonly mounted: _angular_core.WritableSignal<boolean>;
+    /** Whether the category preferences panel is expanded. */
+    readonly customizing: _angular_core.WritableSignal<boolean>;
+    /** Draft toggles while customizing. */
+    readonly draftPrefs: _angular_core.WritableSignal<DgaCookiePreferences>;
     private readonly seq;
     readonly titleId: string;
     readonly bodyId: string;
@@ -1311,31 +1560,87 @@ declare class DgaCookies implements OnInit {
         body: string;
         terms: string;
         privacy: string;
+        cookiePolicy: string;
         accept: string;
+        acceptAll: string;
         decline: string;
+        customize: string;
+        save: string;
+        categories: string;
+        policies: string;
         close: string;
     }>;
+    readonly resolvedCategories: _angular_core.Signal<DgaCookieCategory[]>;
+    readonly resolvedLinks: _angular_core.Signal<{
+        href: string;
+        label: string;
+    }[]>;
+    /**
+     * Accept + Decline share a row; Customize / Save spans full width underneath
+     * so Arabic labels stay on one line. Actions stay pinned below the scroll body.
+     */
+    readonly actionsClasses: _angular_core.Signal<string>;
+    /** Resolved vertical edge + horizontal align (logical start/end). */
+    readonly placement: _angular_core.Signal<{
+        edge: "top" | "bottom";
+        align: DgaCookiesAlign;
+    }>;
+    /** Whether a dimmed backdrop is shown (`overlay` or legacy `blocking`). */
+    readonly hasOverlay: _angular_core.Signal<boolean>;
     readonly panelClasses: _angular_core.Signal<string>;
     constructor();
     ngOnInit(): void;
-    /** Re-open the banner (e.g. from a footer Cookie Settings link). */
+    hasCategories(): boolean;
+    hasLinks(): boolean;
+    /**
+     * Re-open the banner (e.g. from a footer Cookie Settings link).
+     * Portals to `document.body` so overflow/transform ancestors cannot clip it.
+     */
     show(): void;
     /** Hide without persisting a decision. */
     dismiss(): void;
+    /** Backdrop click — dismiss only when overlayClose + dismissible. */
+    onOverlayClick(): void;
+    openCustomize(): void;
+    onCategoryToggle(id: string, enabled: boolean): void;
     accept(): void;
     decline(): void;
+    savePreferences(): void;
+    private commit;
+    private buildDefaultPrefs;
+    private buildAllPrefs;
+    private readStored;
     private hidePanel;
     private trackingIds;
+    /** Move host to `body` so fixed positioning escapes overflow/transform ancestors. */
+    private ensureBodyPortal;
+    private restorePortal;
     private clearTimer;
     private clearCloseTimer;
-    static getConsent(): DgaCookieConsent;
-    static setConsent(value: Exclude<DgaCookieConsent, null>): void;
-    static clearConsent(): void;
+    static getConsent(cookieName?: string): DgaCookieConsent;
+    static getPreferences(cookieName?: string): DgaCookiePreferences | null;
+    static setConsent(value: Exclude<DgaCookieConsent, null>, options?: {
+        name?: string;
+        days?: number;
+        preferences?: DgaCookiePreferences;
+    }): void;
+    static clearConsent(cookieName?: string): void;
+    /** @internal */
+    static parseStored(raw: string | null): {
+        consent: DgaCookieConsent;
+        preferences: DgaCookiePreferences | null;
+    };
+    /** @internal */
+    static writeConsent(status: Exclude<DgaCookieConsent, null>, preferences: DgaCookiePreferences | null, opts: {
+        name: string;
+        days: number;
+        hasCategories: boolean;
+    }): void;
     static get(name: string): string | null;
     static set(name: string, value: string, days?: number): void;
     static delete(name: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaCookies, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaCookies, "dga-cookies", never, { "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "delayMs": { "alias": "delayMs"; "required": false; "isSignal": true; }; "termsHref": { "alias": "termsHref"; "required": false; "isSignal": true; }; "privacyHref": { "alias": "privacyHref"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "acceptLabel": { "alias": "acceptLabel"; "required": false; "isSignal": true; }; "declineLabel": { "alias": "declineLabel"; "required": false; "isSignal": true; }; "gaTrackingIds": { "alias": "gaTrackingIds"; "required": false; "isSignal": true; }; }, { "accepted": "accepted"; "declined": "declined"; "closed": "closed"; "decided": "decided"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaCookies, "dga-cookies", never, { "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "delayMs": { "alias": "delayMs"; "required": false; "isSignal": true; }; "autoShow": { "alias": "autoShow"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "showDecline": { "alias": "showDecline"; "required": false; "isSignal": true; }; "showLinks": { "alias": "showLinks"; "required": false; "isSignal": true; }; "showCustomize": { "alias": "showCustomize"; "required": false; "isSignal": true; }; "overlay": { "alias": "overlay"; "required": false; "isSignal": true; }; "blocking": { "alias": "blocking"; "required": false; "isSignal": true; }; "overlayClose": { "alias": "overlayClose"; "required": false; "isSignal": true; }; "termsHref": { "alias": "termsHref"; "required": false; "isSignal": true; }; "privacyHref": { "alias": "privacyHref"; "required": false; "isSignal": true; }; "cookiePolicyHref": { "alias": "cookiePolicyHref"; "required": false; "isSignal": true; }; "termsLabel": { "alias": "termsLabel"; "required": false; "isSignal": true; }; "privacyLabel": { "alias": "privacyLabel"; "required": false; "isSignal": true; }; "cookiePolicyLabel": { "alias": "cookiePolicyLabel"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "acceptLabel": { "alias": "acceptLabel"; "required": false; "isSignal": true; }; "declineLabel": { "alias": "declineLabel"; "required": false; "isSignal": true; }; "customizeLabel": { "alias": "customizeLabel"; "required": false; "isSignal": true; }; "saveLabel": { "alias": "saveLabel"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "gaTrackingIds": { "alias": "gaTrackingIds"; "required": false; "isSignal": true; }; "consentDays": { "alias": "consentDays"; "required": false; "isSignal": true; }; "consentCookieName": { "alias": "consentCookieName"; "required": false; "isSignal": true; }; "analyticsCookieNames": { "alias": "analyticsCookieNames"; "required": false; "isSignal": true; }; "categories": { "alias": "categories"; "required": false; "isSignal": true; }; }, { "accepted": "accepted"; "declined": "declined"; "closed": "closed"; "decided": "decided"; "preferencesChange": "preferencesChange"; "decision": "decision"; }, never, never, true, never>;
 }
 
 type DgaRatingSize = 'sm' | 'md' | 'lg';
@@ -1428,7 +1733,7 @@ declare class DgaShare {
     readonly inlineClasses: _angular_core.Signal<string>;
     resolvedUrl(): string;
     resolvedTitle(): string;
-    onMenuSelect(value: string): void;
+    onMenuSelect(item: DgaMenuItem | string): void;
     share(channel: string): void;
     copyLink(): Promise<void>;
     onCopied(): void;
@@ -1436,6 +1741,104 @@ declare class DgaShare {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaShare, "dga-share", never, { "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "url": { "alias": "url"; "required": false; "isSignal": true; }; "shareTitle": { "alias": "shareTitle"; "required": false; "isSignal": true; }; "triggerLabel": { "alias": "triggerLabel"; "required": false; "isSignal": true; }; "iconOnly": { "alias": "iconOnly"; "required": false; "isSignal": true; }; "buttonVariant": { "alias": "buttonVariant"; "required": false; "isSignal": true; }; "buttonSize": { "alias": "buttonSize"; "required": false; "isSignal": true; }; }, { "shared": "shared"; "linkCopied": "linkCopied"; }, never, never, true, never>;
 }
 
+type DgaChatbotPosition = 'end' | 'start' | 'left' | 'right';
+type DgaChatbotAnimation = 'fade' | 'slide' | 'scale' | 'none';
+type DgaChatbotSize = 'sm' | 'md' | 'lg';
+type DgaChatbotFabTone = 'primary' | 'secondary';
+interface DgaChatbotMessage {
+    id: string;
+    role: 'bot' | 'user';
+    text: string;
+}
+/**
+ * Floating live-chat launcher + panel. Place once near the app root
+ * (beside `dga-scroll-top` / `dga-accessibility`).
+ *
+ * Use `stack` so FABs share one vertical dock:
+ * a11y `0` → scroll-top `1` → chatbot `2`.
+ */
+declare class DgaChatbot {
+    private readonly destroyRef;
+    private readonly injector;
+    private readonly composerRef;
+    private readonly logRef;
+    /** Corner for FAB + panel. `end` / `start` follow reading direction. */
+    readonly position: _angular_core.InputSignal<DgaChatbotPosition>;
+    /** Panel enter animation. Honors `prefers-reduced-motion`. */
+    readonly animation: _angular_core.InputSignal<DgaChatbotAnimation>;
+    readonly size: _angular_core.InputSignal<DgaChatbotSize>;
+    readonly title: _angular_core.InputSignal<string>;
+    readonly subtitle: _angular_core.InputSignal<string>;
+    readonly fabLabel: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly fabIcon: _angular_core.InputSignal<DgaIconName>;
+    /** Prefer a directional arrow so send ≠ chat bubble. */
+    readonly sendIcon: _angular_core.InputSignal<DgaIconName>;
+    readonly agentIcon: _angular_core.InputSignal<DgaIconName>;
+    readonly fabTone: _angular_core.InputSignal<DgaChatbotFabTone>;
+    /** Dim page behind the panel. */
+    readonly overlay: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Close when clicking the overlay. */
+    readonly overlayClose: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Green online dot on the agent avatar. */
+    readonly online: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Hide launcher while the panel is open (recommended). */
+    readonly hideFabWhenOpen: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * 0-based slot in the shared FAB dock (bottom → top).
+     * Typical: a11y=0, scroll-top=1, chatbot=2.
+     */
+    readonly stack: _angular_core.InputSignalWithTransform<number, unknown>;
+    /**
+     * @deprecated Prefer `stack`. When true and `stack` is unset legacy path —
+     * kept for callers; `stack` wins.
+     */
+    readonly clearFab: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Anchor FAB/panel inside a relative parent (gallery / docs preview)
+     * instead of the viewport — avoids a second global FAB.
+     */
+    readonly embedded: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly initialMessages: _angular_core.InputSignal<readonly DgaChatbotMessage[]>;
+    readonly sent: _angular_core.OutputEmitterRef<string>;
+    readonly opened: _angular_core.OutputEmitterRef<void>;
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    readonly open: _angular_core.WritableSignal<boolean>;
+    readonly draft: _angular_core.WritableSignal<string>;
+    readonly messages: _angular_core.WritableSignal<DgaChatbotMessage[]>;
+    private readonly seq;
+    readonly panelId: string;
+    private msgSeq;
+    private seeded;
+    private prevOverflow;
+    readonly copy: _angular_core.Signal<{
+        title: string;
+        subtitle: string;
+        open: string;
+        close: string;
+        send: string;
+        input: string;
+        placeholder: string;
+        panelLabel: string;
+        welcome: string;
+    }>;
+    readonly fabBottom: _angular_core.Signal<string>;
+    readonly fabClasses: _angular_core.Signal<string>;
+    readonly panelClasses: _angular_core.Signal<string>;
+    constructor();
+    private ensureSeed;
+    toggle(): void;
+    show(): void;
+    close(): void;
+    onBackdrop(): void;
+    onSubmit(event: Event): void;
+    private scrollLogToEnd;
+    private lockScroll;
+    private unlockScroll;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaChatbot, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaChatbot, "dga-chatbot", never, { "position": { "alias": "position"; "required": false; "isSignal": true; }; "animation": { "alias": "animation"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "fabLabel": { "alias": "fabLabel"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "fabIcon": { "alias": "fabIcon"; "required": false; "isSignal": true; }; "sendIcon": { "alias": "sendIcon"; "required": false; "isSignal": true; }; "agentIcon": { "alias": "agentIcon"; "required": false; "isSignal": true; }; "fabTone": { "alias": "fabTone"; "required": false; "isSignal": true; }; "overlay": { "alias": "overlay"; "required": false; "isSignal": true; }; "overlayClose": { "alias": "overlayClose"; "required": false; "isSignal": true; }; "online": { "alias": "online"; "required": false; "isSignal": true; }; "hideFabWhenOpen": { "alias": "hideFabWhenOpen"; "required": false; "isSignal": true; }; "stack": { "alias": "stack"; "required": false; "isSignal": true; }; "clearFab": { "alias": "clearFab"; "required": false; "isSignal": true; }; "embedded": { "alias": "embedded"; "required": false; "isSignal": true; }; "initialMessages": { "alias": "initialMessages"; "required": false; "isSignal": true; }; }, { "sent": "sent"; "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
+}
+
 /** One-tap accessibility presets (compose primitives + settings). */
 type DgaA11yBundle = 'epilepsy-safe' | 'visually-impaired' | 'cognitive-disability' | 'motor-impaired' | 'colorblind' | 'dyslexia-friendly' | 'adhd-friendly';
 /** Primitive toggles stamped on `data-a11y`. */
@@ -1520,8 +1923,14 @@ type SectionOpen = SectionId | null;
 declare class DgaAccessibility {
     readonly a11y: DgaAccessibilityService;
     readonly position: _angular_core.InputSignal<DgaAccessibilityPosition>;
+    /**
+     * 0-based slot in the shared FAB dock (bottom → top).
+     * Typical: a11y=0, scroll-top=1, chatbot=2.
+     */
+    readonly stack: _angular_core.InputSignalWithTransform<number, unknown>;
     readonly panelId = "dga-accessibility-panel";
     private readonly panelRef;
+    readonly fabBottom: _angular_core.Signal<string>;
     readonly sectionOpen: _angular_core.WritableSignal<SectionOpen>;
     readonly resetArmed: _angular_core.WritableSignal<boolean>;
     readonly liveMsg: _angular_core.WritableSignal<string>;
@@ -1641,7 +2050,7 @@ declare class DgaAccessibility {
     private announce;
     private onMaskKeys;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaAccessibility, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaAccessibility, "dga-accessibility", never, { "position": { "alias": "position"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaAccessibility, "dga-accessibility", never, { "position": { "alias": "position"; "required": false; "isSignal": true; }; "stack": { "alias": "stack"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -1667,13 +2076,29 @@ declare class DgaAccordionItem {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaAccordionItem, "dga-accordion-item", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["*"], true, never>;
 }
 
+interface DgaAccordionSection {
+    id: string;
+    title: string;
+    content?: string;
+    open?: boolean;
+}
 declare class DgaAccordion {
     /** Allow multiple panels open at once. */
     readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Optional data-driven sections; when non-empty, renders items from this list instead of `<ng-content>`. */
+    readonly sections: _angular_core.InputSignal<DgaAccordionSection[]>;
     readonly items: _angular_core.Signal<readonly DgaAccordionItem[]>;
+    private readonly seq;
+    private readonly openSectionIds;
+    private sectionsInitialized;
+    constructor();
+    headerId(section: DgaAccordionSection): string;
+    panelId(section: DgaAccordionSection): string;
+    isSectionOpen(section: DgaAccordionSection): boolean;
+    toggleSection(section: DgaAccordionSection): void;
     onItemOpen(item: DgaAccordionItem): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaAccordion, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaAccordion, "dga-accordion", never, { "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; }, {}, ["items"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaAccordion, "dga-accordion", never, { "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "sections": { "alias": "sections"; "required": false; "isSignal": true; }; }, {}, ["items"], ["*"], true, never>;
 }
 
 interface DgaBreadcrumbItem {
@@ -1685,58 +2110,79 @@ declare class DgaBreadcrumb {
     readonly items: _angular_core.InputSignal<DgaBreadcrumbItem[]>;
     readonly label: _angular_core.InputSignal<string>;
     readonly separator: _angular_core.InputSignal<DgaBreadcrumbSeparator>;
+    /** Emits the clicked item for non-last links. Navigation via `href` is not prevented. */
+    readonly itemClick: _angular_core.OutputEmitterRef<DgaBreadcrumbItem>;
+    onItemClick(item: DgaBreadcrumbItem): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaBreadcrumb, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaBreadcrumb, "dga-breadcrumb", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "separator": { "alias": "separator"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaBreadcrumb, "dga-breadcrumb", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "separator": { "alias": "separator"; "required": false; "isSignal": true; }; }, { "itemClick": "itemClick"; }, never, never, true, never>;
 }
 
 declare class DgaPagination {
-    readonly pageInput: _angular_core.InputSignal<number>;
-    readonly page: _angular_core.WritableSignal<number>;
+    /** Two-way bindable via `[(page)]`; also emits the built-in `pageChange` output. */
+    readonly page: _angular_core.ModelSignal<number>;
     readonly totalPages: _angular_core.InputSignal<number>;
     readonly label: _angular_core.InputSignal<string>;
     readonly prevLabel: _angular_core.InputSignal<string>;
     readonly nextLabel: _angular_core.InputSignal<string>;
-    readonly pageChange: _angular_core.OutputEmitterRef<number>;
     readonly pages: _angular_core.Signal<(number | "…")[]>;
     btnClass(active: boolean): string;
     go(next: number): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaPagination, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaPagination, "dga-pagination", never, { "pageInput": { "alias": "page"; "required": false; "isSignal": true; }; "totalPages": { "alias": "totalPages"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "prevLabel": { "alias": "prevLabel"; "required": false; "isSignal": true; }; "nextLabel": { "alias": "nextLabel"; "required": false; "isSignal": true; }; }, { "pageChange": "pageChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaPagination, "dga-pagination", never, { "page": { "alias": "page"; "required": false; "isSignal": true; }; "totalPages": { "alias": "totalPages"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "prevLabel": { "alias": "prevLabel"; "required": false; "isSignal": true; }; "nextLabel": { "alias": "nextLabel"; "required": false; "isSignal": true; }; }, { "page": "pageChange"; }, never, never, true, never>;
 }
 
 declare class DgaTab {
     private readonly tabs;
     readonly value: _angular_core.InputSignal<string>;
     readonly label: _angular_core.InputSignal<string>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly seq: number;
     readonly tabId: string;
     readonly panelId: string;
     readonly active: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaTab, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaTab, "dga-tab", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaTab, "dga-tab", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+interface DgaTabItem {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
 declare class DgaTabs {
     private readonly host;
+    private readonly seq;
     readonly selected: _angular_core.ModelSignal<string>;
     readonly label: _angular_core.InputSignal<string>;
+    /** Optional data-driven tab headers; when non-empty, renders the tablist from this list. */
+    readonly items: _angular_core.InputSignal<DgaTabItem[]>;
     readonly tabs: _angular_core.Signal<readonly DgaTab[]>;
+    readonly headerItems: _angular_core.Signal<DgaTabItem[]>;
     constructor();
-    tabButtonClass(value: string): string;
+    tabButtonClass(value: string, disabled: boolean): string;
+    tabIdFor(value: string): string;
+    panelIdFor(value: string): string;
     select(value: string): void;
     onTablistKey(event: KeyboardEvent): void;
+    private stepIndex;
+    private lastEnabledIndex;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaTabs, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaTabs, "dga-tabs", never, { "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "selected": "selectedChange"; }, ["tabs"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaTabs, "dga-tabs", never, { "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; }, { "selected": "selectedChange"; }, ["tabs"], ["*"], true, never>;
 }
 
+type DgaStepStatus = 'pending' | 'active' | 'completed' | 'error';
 interface DgaStep {
     label: string;
     description?: string;
+    disabled?: boolean;
+    /** Overrides the status normally derived from the active index. */
+    status?: DgaStepStatus;
 }
 declare class DgaStepper {
     readonly steps: _angular_core.InputSignal<DgaStep[]>;
     readonly active: _angular_core.ModelSignal<number>;
     readonly label: _angular_core.InputSignal<string>;
+    stepStatus(index: number): DgaStepStatus;
     stepButtonClasses(index: number): string;
     indicatorClasses(index: number): string;
     go(index: number): void;
@@ -1763,31 +2209,153 @@ declare class DgaToc {
 interface DgaSideNavItem {
     label: string;
     value: string;
-    icon?: string;
+    icon?: DgaIconName;
+    disabled?: boolean;
+    /** Optional link target — when set, the item renders as an anchor. */
+    href?: string;
+    badge?: string;
+    /** Nested level-2 items (expandable on desktop). */
+    children?: DgaSideNavItem[];
+    /** Start expanded when children exist (default: true if active child). */
+    expanded?: boolean;
+}
+/** Category / section in a multi-level admin side nav. */
+interface DgaSideNavGroup {
+    id: string;
+    /** Optional section heading (hidden when sidebar is narrow). */
+    label?: string;
+    items: DgaSideNavItem[];
 }
 /**
- * Side navigation.
- * Below `lg`: horizontal scroll rail (mobile-friendly).
+ * Side navigation with optional groups and nested children.
+ * Below `lg`: horizontal scroll rail (top-level only).
  * From `lg`: vertical sidebar (optional collapse to icons).
  */
 declare class DgaSideNav {
+    /** Flat item list (backward compatible). Ignored when `groups` is set. */
     readonly items: _angular_core.InputSignal<DgaSideNavItem[]>;
+    /** Grouped / categorized navigation (preferred for admin shells). */
+    readonly groups: _angular_core.InputSignal<DgaSideNavGroup[]>;
     readonly active: _angular_core.ModelSignal<string>;
     readonly collapsible: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly label: _angular_core.InputSignal<string>;
     readonly toggleLabel: _angular_core.InputSignal<string>;
     readonly select: _angular_core.OutputEmitterRef<DgaSideNavItem>;
     readonly narrow: _angular_core.ModelSignal<boolean>;
-    itemClasses(value: string): string;
+    /** Values of parents forced open by the user. */
+    private readonly expanded;
+    /** Values of parents forced closed by the user. */
+    private readonly collapsed;
+    readonly resolvedGroups: _angular_core.Signal<DgaSideNavGroup[]>;
+    hasChildren(item: DgaSideNavItem): boolean;
+    isExpanded(item: DgaSideNavItem): boolean;
+    isActive(item: DgaSideNavItem): boolean;
+    itemClasses(item: DgaSideNavItem, depth: number): string;
     toggleNarrow(): void;
-    onSelect(item: DgaSideNavItem): void;
+    onSelect(item: DgaSideNavItem, event?: Event): void;
+    private childIsActive;
+    private toggleExpanded;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaSideNav, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaSideNav, "dga-side-nav", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "toggleLabel": { "alias": "toggleLabel"; "required": false; "isSignal": true; }; "narrow": { "alias": "narrow"; "required": false; "isSignal": true; }; }, { "active": "activeChange"; "select": "select"; "narrow": "narrowChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaSideNav, "dga-side-nav", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "groups": { "alias": "groups"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "toggleLabel": { "alias": "toggleLabel"; "required": false; "isSignal": true; }; "narrow": { "alias": "narrow"; "required": false; "isSignal": true; }; }, { "active": "activeChange"; "select": "select"; "narrow": "narrowChange"; }, never, never, true, never>;
+}
+
+/** Category block inside a dual-nav secondary panel. */
+interface DgaDualNavCategory {
+    id: string;
+    label?: string;
+    items: DgaSideNavItem[];
+}
+/** Top-level rail section (icon) + secondary panel categories. */
+interface DgaDualNavSection {
+    id: string;
+    label: string;
+    icon: DgaIconName;
+    badge?: string;
+    categories: DgaDualNavCategory[];
+}
+/**
+ * Metronic Demo 4–style dual navigation:
+ * slim icon rail + secondary panel with categorized links.
+ * @see https://keenthemes.com/metronic/tailwind/demo4/
+ */
+declare class DgaDualNav {
+    readonly sections: _angular_core.InputSignal<DgaDualNavSection[]>;
+    readonly active: _angular_core.ModelSignal<string>;
+    readonly activeSectionId: _angular_core.ModelSignal<string>;
+    readonly panelOpen: _angular_core.ModelSignal<boolean>;
+    readonly railLabel: _angular_core.InputSignal<string>;
+    readonly panelEyebrow: _angular_core.InputSignal<string>;
+    readonly closePanelLabel: _angular_core.InputSignal<string>;
+    readonly select: _angular_core.OutputEmitterRef<DgaSideNavItem>;
+    readonly activeSection: _angular_core.Signal<DgaDualNavSection>;
+    constructor();
+    selectSection(id: string): void;
+    onSelect(item: DgaSideNavItem): void;
+    linkClasses(item: DgaSideNavItem, nested?: boolean): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaDualNav, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaDualNav, "dga-dual-nav", never, { "sections": { "alias": "sections"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "activeSectionId": { "alias": "activeSectionId"; "required": false; "isSignal": true; }; "panelOpen": { "alias": "panelOpen"; "required": false; "isSignal": true; }; "railLabel": { "alias": "railLabel"; "required": false; "isSignal": true; }; "panelEyebrow": { "alias": "panelEyebrow"; "required": false; "isSignal": true; }; "closePanelLabel": { "alias": "closePanelLabel"; "required": false; "isSignal": true; }; }, { "active": "activeChange"; "activeSectionId": "activeSectionIdChange"; "panelOpen": "panelOpenChange"; "select": "select"; }, never, ["[dgaDualNavBrand]", "[dgaDualNavRailFoot]"], true, never>;
+}
+
+type DgaNavRailPosition = 'static' | 'start' | 'end' | 'left' | 'right';
+type DgaNavRailAppearance = 'plain' | 'elevated' | 'outline';
+type DgaNavRailSize = 'sm' | 'md' | 'lg';
+type DgaNavRailActiveStyle = 'soft' | 'solid' | 'ring';
+interface DgaNavRailItem {
+    /** Accessible label (also used for tooltip). */
+    label: string;
+    /** Stable id used for `active` binding / selection. */
+    value: string;
+    icon: DgaIconName;
+    disabled?: boolean;
+    /** Optional in-page or external link (`#section` for section jumps). */
+    href?: string;
+}
+/**
+ * Slim icon rail for jumping between page sections or compact app areas.
+ * Distinct from `dga-side-nav` (labeled sidebar) and `dga-toc` (text outline).
+ */
+declare class DgaNavRail {
+    readonly items: _angular_core.InputSignal<readonly DgaNavRailItem[]>;
+    readonly active: _angular_core.ModelSignal<string>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly expandLabel: _angular_core.InputSignal<string>;
+    /** `static` for in-flow layout; otherwise docks to a viewport edge. */
+    readonly position: _angular_core.InputSignal<DgaNavRailPosition>;
+    readonly appearance: _angular_core.InputSignal<DgaNavRailAppearance>;
+    readonly size: _angular_core.InputSignal<DgaNavRailSize>;
+    readonly activeStyle: _angular_core.InputSignal<DgaNavRailActiveStyle>;
+    /** Edge inset in px when `position` is fixed. */
+    readonly offset: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Show a chevron control that emits `expandChange`. */
+    readonly expandable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly expanded: _angular_core.ModelSignal<boolean>;
+    /** Smooth-scroll to `#href` targets inside the page. */
+    readonly smoothScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly select: _angular_core.OutputEmitterRef<DgaNavRailItem>;
+    readonly expandChange: _angular_core.OutputEmitterRef<boolean>;
+    readonly edgeAttr: _angular_core.Signal<"start" | "end" | "right" | "left" | null>;
+    readonly offsetCss: _angular_core.Signal<string>;
+    readonly tooltipPlacement: _angular_core.Signal<"start" | "end">;
+    readonly iconSize: _angular_core.Signal<"sm" | "md" | "lg">;
+    readonly expandIcon: _angular_core.Signal<"chevronLeft" | "chevronRight">;
+    readonly listGapClass: _angular_core.Signal<"gap-xs" | "gap-sm" | "gap-md">;
+    readonly railClasses: _angular_core.Signal<string>;
+    expandBtnClasses(): string;
+    itemClasses(item: DgaNavRailItem): string;
+    onSelect(item: DgaNavRailItem, event?: MouseEvent): void;
+    toggleExpand(): void;
+    private prefersReducedMotion;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaNavRail, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaNavRail, "dga-nav-rail", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "expandLabel": { "alias": "expandLabel"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "activeStyle": { "alias": "activeStyle"; "required": false; "isSignal": true; }; "offset": { "alias": "offset"; "required": false; "isSignal": true; }; "expandable": { "alias": "expandable"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; "smoothScroll": { "alias": "smoothScroll"; "required": false; "isSignal": true; }; }, { "active": "activeChange"; "expanded": "expandedChange"; "select": "select"; "expandChange": "expandChange"; }, never, never, true, never>;
 }
 
 interface DgaFilterItem {
     id: string;
     label: string;
+    /** Optional result count shown as a trailing badge. */
+    count?: number;
+    disabled?: boolean;
+    icon?: DgaIconName;
 }
 declare class DgaFilterBar {
     readonly filters: _angular_core.InputSignal<DgaFilterItem[]>;
@@ -1796,8 +2364,9 @@ declare class DgaFilterBar {
     readonly clearLabel: _angular_core.InputSignal<string>;
     readonly activeSet: _angular_core.Signal<Set<string>>;
     isActive(id: string): boolean;
-    chipClass(active: boolean): string;
-    toggle(id: string): void;
+    chipClass(active: boolean, disabled: boolean): string;
+    countClass(active: boolean): string;
+    toggle(id: string, disabled?: boolean): void;
     clearAll(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaFilterBar, never>;
     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>;
@@ -1829,11 +2398,16 @@ declare class DgaScrollTop {
     /** Use smooth scrolling when supported. */
     readonly smooth: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
-     * Lift the button above a typical `dga-accessibility` FAB
-     * (56px + edge margin + gap).
+     * 0-based slot in the shared FAB dock (bottom → top).
+     * Typical: a11y=0, scroll-top=1, chatbot=2.
+     */
+    readonly stack: _angular_core.InputSignalWithTransform<number, unknown>;
+    /**
+     * @deprecated Prefer `stack`. Kept for older callers.
      */
     readonly clearFab: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly visible: _angular_core.WritableSignal<boolean>;
+    readonly fabBottom: _angular_core.Signal<string>;
     private ticking;
     private readonly onScroll;
     readonly btnClasses: _angular_core.Signal<string>;
@@ -1842,7 +2416,7 @@ declare class DgaScrollTop {
     scrollToTop(): void;
     private syncVisibility;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaScrollTop, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaScrollTop, "dga-scroll-top", never, { "threshold": { "alias": "threshold"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "smooth": { "alias": "smooth"; "required": false; "isSignal": true; }; "clearFab": { "alias": "clearFab"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaScrollTop, "dga-scroll-top", never, { "threshold": { "alias": "threshold"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "smooth": { "alias": "smooth"; "required": false; "isSignal": true; }; "stack": { "alias": "stack"; "required": false; "isSignal": true; }; "clearFab": { "alias": "clearFab"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /** Maps official card surface: stroke / elevation / fill. */
@@ -2000,6 +2574,37 @@ declare class DgaExpandable {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaExpandable, "dga-expandable", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["*"], true, never>;
 }
 
+/**
+ * `content` — sticky aside inside page flow (portal templates).
+ * `viewport` — fixed full-height admin shell (Metronic-style app chrome).
+ */
+type DgaAppShellAppearance = 'content' | 'viewport';
+/**
+ * App shell: aside nav + optional header + main column.
+ *
+ * Projection hooks (class selectors — more reliable than camelCase attrs):
+ * - `.dga-app-shell-brand` — sidebar brand
+ * - `.dga-app-shell-nav` — side navigation
+ * - `.dga-app-shell-nav-foot` — sidebar footer
+ * - `.dga-app-shell-header` — main top bar
+ * - default slot — scrollable main body
+ */
+declare class DgaAppShell {
+    /** Accessible name for the nav aside. */
+    readonly navLabel: _angular_core.InputSignal<string>;
+    /** `viewport` = full-height admin shell; `content` = in-flow sticky aside. */
+    readonly appearance: _angular_core.InputSignal<DgaAppShellAppearance>;
+    /** Soften viewport body padding (default true for viewport). */
+    readonly padded: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly isViewport: _angular_core.Signal<boolean>;
+    readonly layoutClasses: _angular_core.Signal<string>;
+    readonly navClasses: _angular_core.Signal<string>;
+    readonly mainClasses: _angular_core.Signal<string>;
+    readonly bodyClasses: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaAppShell, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaAppShell, "dga-app-shell", never, { "navLabel": { "alias": "navLabel"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "padded": { "alias": "padded"; "required": false; "isSignal": true; }; }, {}, never, [".dga-app-shell-brand, [dgaAppShellBrand]", ".dga-app-shell-nav, [dgaAppShellNav]", ".dga-app-shell-nav-foot, [dgaAppShellNavFoot]", ".dga-app-shell-header, [dgaAppShellHeader]", "*"], true, never>;
+}
+
 type DgaHeaderAppearance = 'default' | 'portal';
 /**
  * Mobile / narrow navigation chrome (portal header, `md` and below):
@@ -2066,12 +2671,16 @@ interface DgaHeaderSearchSuggestion {
     icon?: DgaIconName;
 }
 /**
- * Built-in header search panel (opens from the action whose `id` matches `actionId`).
- * Pass this to `[search]` to enable the dropdown search experience.
+ * Built-in header search popup (opens from the action whose `id` matches `actionId`).
+ * Pass this to `[search]` to enable the modal search experience.
  */
 interface DgaHeaderSearchConfig {
     /** Action id that toggles the panel. Default: `'search'`. */
     actionId?: string;
+    /** Modal title. Default: `'Search'`. */
+    title?: string;
+    description?: string;
+    closeLabel?: string;
     placeholder?: string;
     submitLabel?: string;
     suggestionsLabel?: string;
@@ -2218,6 +2827,8 @@ declare class DgaHeader {
     }>;
     readonly logout: _angular_core.OutputEmitterRef<void>;
     readonly userLinkClick: _angular_core.OutputEmitterRef<DgaHeaderUserMenuLink>;
+    /** Emits on click of any top-level nav link or dropdown link (desktop + mobile). */
+    readonly navLinkClick: _angular_core.OutputEmitterRef<DgaNavLink | DgaNavItem>;
     readonly mobileOpen: _angular_core.WritableSignal<boolean>;
     readonly openDropdown: _angular_core.WritableSignal<number | null>;
     readonly searchOpen: _angular_core.WritableSignal<boolean>;
@@ -2310,6 +2921,8 @@ declare class DgaHeader {
     onMobileAction(action: DgaHeaderAction, event?: Event): void;
     closeUtilityOverlays(): void;
     toggleSearch(): void;
+    onSearchModalOpenChange(open: boolean): void;
+    focusSearchInput(): void;
     closeSearch(clearVoice?: boolean): void;
     toggleNotifications(trigger?: HTMLElement | null): void;
     closeNotifications(): void;
@@ -2337,9 +2950,10 @@ declare class DgaHeader {
     onKey(event: KeyboardEvent): void;
     onScroll(): void;
     onResize(): void;
+    onNavLinkClick(link: DgaNavLink | DgaNavItem, event: MouseEvent): void;
     onDocClick(event: MouseEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaHeader, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaHeader, "dga-header", never, { "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "brandSlogan": { "alias": "brandSlogan"; "required": false; "isSignal": true; }; "brandLogo": { "alias": "brandLogo"; "required": false; "isSignal": true; }; "brandLogoAlt": { "alias": "brandLogoAlt"; "required": false; "isSignal": true; }; "brandPlaceholder": { "alias": "brandPlaceholder"; "required": false; "isSignal": true; }; "brandHref": { "alias": "brandHref"; "required": false; "isSignal": true; }; "navLabel": { "alias": "navLabel"; "required": false; "isSignal": true; }; "menuToggleLabel": { "alias": "menuToggleLabel"; "required": false; "isSignal": true; }; "menuCloseLabel": { "alias": "menuCloseLabel"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "mobileNav": { "alias": "mobileNav"; "required": false; "isSignal": true; }; "sticky": { "alias": "sticky"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "actions": { "alias": "actions"; "required": false; "isSignal": true; }; "search": { "alias": "search"; "required": false; "isSignal": true; }; "searchQuery": { "alias": "searchQuery"; "required": false; "isSignal": true; }; "notifications": { "alias": "notifications"; "required": false; "isSignal": true; }; "login": { "alias": "login"; "required": false; "isSignal": true; }; "user": { "alias": "user"; "required": false; "isSignal": true; }; "authenticated": { "alias": "authenticated"; "required": false; "isSignal": true; }; }, { "searchQuery": "searchQueryChange"; "authenticated": "authenticatedChange"; "actionClick": "actionClick"; "searchSubmit": "searchSubmit"; "searchSuggestionSelect": "searchSuggestionSelect"; "searchVoice": "searchVoice"; "notificationAction": "notificationAction"; "loginSubmit": "loginSubmit"; "logout": "logout"; "userLinkClick": "userLinkClick"; }, never, ["[dgaHeaderBrand]", "*", "[dgaHeaderEnd]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaHeader, "dga-header", never, { "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "brandSlogan": { "alias": "brandSlogan"; "required": false; "isSignal": true; }; "brandLogo": { "alias": "brandLogo"; "required": false; "isSignal": true; }; "brandLogoAlt": { "alias": "brandLogoAlt"; "required": false; "isSignal": true; }; "brandPlaceholder": { "alias": "brandPlaceholder"; "required": false; "isSignal": true; }; "brandHref": { "alias": "brandHref"; "required": false; "isSignal": true; }; "navLabel": { "alias": "navLabel"; "required": false; "isSignal": true; }; "menuToggleLabel": { "alias": "menuToggleLabel"; "required": false; "isSignal": true; }; "menuCloseLabel": { "alias": "menuCloseLabel"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "mobileNav": { "alias": "mobileNav"; "required": false; "isSignal": true; }; "sticky": { "alias": "sticky"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "actions": { "alias": "actions"; "required": false; "isSignal": true; }; "search": { "alias": "search"; "required": false; "isSignal": true; }; "searchQuery": { "alias": "searchQuery"; "required": false; "isSignal": true; }; "notifications": { "alias": "notifications"; "required": false; "isSignal": true; }; "login": { "alias": "login"; "required": false; "isSignal": true; }; "user": { "alias": "user"; "required": false; "isSignal": true; }; "authenticated": { "alias": "authenticated"; "required": false; "isSignal": true; }; }, { "searchQuery": "searchQueryChange"; "authenticated": "authenticatedChange"; "actionClick": "actionClick"; "searchSubmit": "searchSubmit"; "searchSuggestionSelect": "searchSuggestionSelect"; "searchVoice": "searchVoice"; "notificationAction": "notificationAction"; "loginSubmit": "loginSubmit"; "logout": "logout"; "userLinkClick": "userLinkClick"; "navLinkClick": "navLinkClick"; }, never, ["[dgaHeaderBrand]", "*", "[dgaHeaderEnd]"], true, never>;
 }
 
 interface DgaStampNotice {
@@ -2591,6 +3205,100 @@ declare class DgaHero {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaHero, "dga-hero", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "primaryCta": { "alias": "primaryCta"; "required": false; "isSignal": true; }; "secondaryCta": { "alias": "secondaryCta"; "required": false; "isSignal": true; }; "primaryHref": { "alias": "primaryHref"; "required": false; "isSignal": true; }; "secondaryHref": { "alias": "secondaryHref"; "required": false; "isSignal": true; }; "imageDesktop": { "alias": "imageDesktop"; "required": false; "isSignal": true; }; "imageMobile": { "alias": "imageMobile"; "required": false; "isSignal": true; }; "imageUrl": { "alias": "imageUrl"; "required": false; "isSignal": true; }; "imageOverlay": { "alias": "imageOverlay"; "required": false; "isSignal": true; }; "imageMaskVariant": { "alias": "imageMaskVariant"; "required": false; "isSignal": true; }; "slides": { "alias": "slides"; "required": false; "isSignal": true; }; "activeIndex": { "alias": "activeIndex"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "transition": { "alias": "transition"; "required": false; "isSignal": true; }; "autoplay": { "alias": "autoplay"; "required": false; "isSignal": true; }; "autoplayMs": { "alias": "autoplayMs"; "required": false; "isSignal": true; }; "showDots": { "alias": "showDots"; "required": false; "isSignal": true; }; "showArrows": { "alias": "showArrows"; "required": false; "isSignal": true; }; "dotsLabel": { "alias": "dotsLabel"; "required": false; "isSignal": true; }; "prevLabel": { "alias": "prevLabel"; "required": false; "isSignal": true; }; "nextLabel": { "alias": "nextLabel"; "required": false; "isSignal": true; }; }, { "activeIndex": "activeIndexChange"; "primaryClick": "primaryClick"; "secondaryClick": "secondaryClick"; "slideChange": "slideChange"; }, never, ["[dgaHeroBreadcrumb]", "[dgaHeroFloat]", "*", "*"], true, never>;
 }
 
+type DgaPageHeroTone = 'faint' | 'body' | 'surface';
+/**
+ * Compact portal page header: breadcrumb + title + lede + optional actions slot.
+ * Prefer this over hand-rolled `*-hero` bands on inner portal pages.
+ */
+declare class DgaPageHero {
+    readonly title: _angular_core.InputSignal<string>;
+    readonly description: _angular_core.InputSignal<string>;
+    readonly breadcrumbs: _angular_core.InputSignal<DgaBreadcrumbItem[]>;
+    readonly breadcrumbLabel: _angular_core.InputSignal<string>;
+    readonly tone: _angular_core.InputSignal<DgaPageHeroTone>;
+    /** Extra bottom padding for denser pages. */
+    readonly compact: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly seq;
+    readonly titleId: string;
+    readonly sectionClasses: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaPageHero, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaPageHero, "dga-page-hero", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "breadcrumbs": { "alias": "breadcrumbs"; "required": false; "isSignal": true; }; "breadcrumbLabel": { "alias": "breadcrumbLabel"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; }, {}, never, ["[dgaPageHeroActions]", "*"], true, never>;
+}
+
+type DgaAnnouncementTone = 'info' | 'warning' | 'success' | 'neutral' | 'critical' | 'brand';
+type DgaAnnouncementDensity = 'compact' | 'comfortable';
+type DgaAnnouncementAlign = 'start' | 'center';
+type DgaAnnouncementActionVariant = 'link' | 'button' | 'chip';
+type DgaAnnouncementPersist = 'none' | 'session' | 'local';
+type DgaAnnouncementElevation = 'none' | 'soft';
+/**
+ * Site-wide campaign / outage strip for chrome (above or below `dga-top-bar`).
+ * Distinct from page-level `dga-alert`.
+ *
+ * Layout note: use full-bleed width + `--wrapper-padding` only.
+ * Do NOT add `max-w-(--container-*)` — that double-shrinks with wrapper padding.
+ */
+declare class DgaAnnouncementBar {
+    readonly title: _angular_core.InputSignal<string>;
+    readonly message: _angular_core.InputSignal<string>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly tone: _angular_core.InputSignal<DgaAnnouncementTone>;
+    readonly density: _angular_core.InputSignal<DgaAnnouncementDensity>;
+    readonly align: _angular_core.InputSignal<DgaAnnouncementAlign>;
+    readonly actionVariant: _angular_core.InputSignal<DgaAnnouncementActionVariant>;
+    readonly elevation: _angular_core.InputSignal<DgaAnnouncementElevation>;
+    readonly icon: _angular_core.InputSignal<DgaIconName | null>;
+    readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly dismissLabel: _angular_core.InputSignal<string>;
+    readonly actionLabel: _angular_core.InputSignal<string>;
+    readonly actionHref: _angular_core.InputSignal<string>;
+    readonly actionExternal: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Sticky under the viewport top while scrolling. */
+    readonly sticky: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Start accent stripe (alert-style). Off by default for site chrome. */
+    readonly accent: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Start dismissed (e.g. after reading storage). */
+    readonly initiallyDismissed: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Persist dismiss across reloads.
+     * Uses `persistKey` when set, otherwise a hash of title+message.
+     */
+    readonly persist: _angular_core.InputSignal<DgaAnnouncementPersist>;
+    readonly persistKey: _angular_core.InputSignal<string>;
+    readonly dismissedChange: _angular_core.OutputEmitterRef<boolean>;
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    readonly dismissed: _angular_core.WritableSignal<boolean>;
+    constructor();
+    readonly iconTone: _angular_core.Signal<DgaIconTone>;
+    readonly iconShellClasses: _angular_core.Signal<string>;
+    readonly barClasses: _angular_core.Signal<string>;
+    dismiss(): void;
+    show(): void;
+    private storageKey;
+    private storage;
+    private readPersisted;
+    private writePersisted;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaAnnouncementBar, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaAnnouncementBar, "dga-announcement-bar", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "actionVariant": { "alias": "actionVariant"; "required": false; "isSignal": true; }; "elevation": { "alias": "elevation"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "dismissLabel": { "alias": "dismissLabel"; "required": false; "isSignal": true; }; "actionLabel": { "alias": "actionLabel"; "required": false; "isSignal": true; }; "actionHref": { "alias": "actionHref"; "required": false; "isSignal": true; }; "actionExternal": { "alias": "actionExternal"; "required": false; "isSignal": true; }; "sticky": { "alias": "sticky"; "required": false; "isSignal": true; }; "accent": { "alias": "accent"; "required": false; "isSignal": true; }; "initiallyDismissed": { "alias": "initiallyDismissed"; "required": false; "isSignal": true; }; "persist": { "alias": "persist"; "required": false; "isSignal": true; }; "persistKey": { "alias": "persistKey"; "required": false; "isSignal": true; }; }, { "dismissedChange": "dismissedChange"; "closed": "closed"; }, never, ["*"], true, never>;
+}
+
+/**
+ * Centered auth / registration shell: logo, optional chrome tools, form slot.
+ * Not an IdP SDK — drop Nafath / OAuth buttons into the default slot.
+ */
+declare class DgaAuthCard {
+    readonly title: _angular_core.InputSignal<string>;
+    readonly description: _angular_core.InputSignal<string>;
+    readonly logoSrc: _angular_core.InputSignal<string>;
+    readonly logoAlt: _angular_core.InputSignal<string>;
+    readonly cardId: _angular_core.InputSignal<string>;
+    /** Full-viewport centered layout (registration pages). */
+    readonly centered: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly shellClasses: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaAuthCard, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaAuthCard, "dga-auth-card", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "logoSrc": { "alias": "logoSrc"; "required": false; "isSignal": true; }; "logoAlt": { "alias": "logoAlt"; "required": false; "isSignal": true; }; "cardId": { "alias": "cardId"; "required": false; "isSignal": true; }; "centered": { "alias": "centered"; "required": false; "isSignal": true; }; }, {}, never, ["[dgaAuthTools]", "[dgaAuthLogo]", "*"], true, never>;
+}
+
 interface DgaSideInfoItem {
     label: string;
     href?: string;
@@ -2720,6 +3428,49 @@ declare class DgaDescriptionList {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaDescriptionList, "dga-description-list", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+interface DgaInfoListItem {
+    id?: string;
+    label: string;
+    value: string;
+    icon?: DgaIconName;
+    href?: string;
+    /** Open href in a new tab. */
+    external?: boolean;
+    /** Show a copy control for the value. */
+    copyable?: boolean;
+}
+/**
+ * Icon + label + value rows for contact channels, service meta, and side panels.
+ */
+declare class DgaInfoList {
+    readonly items: _angular_core.InputSignal<readonly DgaInfoListItem[]>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly copyLabel: _angular_core.InputSignal<string>;
+    readonly compact: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly copy: _angular_core.OutputEmitterRef<DgaInfoListItem>;
+    readonly listClasses: _angular_core.Signal<string>;
+    onCopy(item: DgaInfoListItem): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaInfoList, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaInfoList, "dga-info-list", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "copyLabel": { "alias": "copyLabel"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; }, { "copy": "copy"; }, never, never, true, never>;
+}
+
+interface DgaTimelineItem {
+    title: string;
+    meta?: string;
+    description?: string;
+}
+/**
+ * Vertical timeline (dot + connector) for experience, history, and status flows.
+ */
+declare class DgaTimeline {
+    readonly items: _angular_core.InputSignal<readonly DgaTimelineItem[]>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly compact: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly listClasses: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaTimeline, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaTimeline, "dga-timeline", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
 type DgaCurrency = 'SAR' | 'USD' | 'EUR' | 'GBP' | 'JPY' | 'CNY' | 'INR' | 'KRW' | 'TRY';
 /**
  * Locale-aware number display with optional currency/unit and scroll-triggered counter.
@@ -2755,6 +3506,59 @@ declare class DgaNumber implements OnInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaNumber, "dga-number", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "unit": { "alias": "unit"; "required": false; "isSignal": true; }; "free": { "alias": "free"; "required": false; "isSignal": true; }; "counter": { "alias": "counter"; "required": false; "isSignal": true; }; "start": { "alias": "start"; "required": false; "isSignal": true; }; "duration": { "alias": "duration"; "required": false; "isSignal": true; }; "decimals": { "alias": "decimals"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Official Saudi Riyal symbol path (SAMA / Saudi Riyal Font, OFL-1.1).
+ * Unicode: U+20C1 SAUDI RIYAL SIGN
+ */
+declare const DGA_RIYAL_SVG_PATH = "M750 1119C730 1163 716 1211 711 1262L1136 1172C1156 1127 1169 1079 1174 1028L750 1119ZM1136 901C1156 857 1169 809 1174 758L843 828V693L1136 631C1156 587 1169 538 1174 488L843 558V72C793 100 748 138 711 183V586L579 614V6C528 34 483 72 447 117V642L151 705C131 750 117 798 112 849L447 777V948L88 1024C68 1068 55 1117 50 1167L425 1088C456 1081 482 1063 499 1038L568 936C575 926 579 913 579 899V749L711 721V992L1136 901Z";
+/** Tight viewBox around the official glyph (aspect ≈ 0.89). */
+declare const DGA_RIYAL_VIEWBOX = "50 0 1124 1268";
+/**
+ * Size tokens. Prefer `em` so the glyph matches surrounding text height
+ * (SAMA alignment rule). Fixed sizes are for standalone chrome use.
+ */
+type DgaRiyalSize = 'em' | 'sm' | 'md' | 'lg' | 'xl';
+type DgaRiyalTone = 'current' | 'primary' | 'muted' | 'on-color';
+/** `contained` adds circular clear-space ≈ ⅓ of the glyph height (SAMA). */
+type DgaRiyalAppearance = 'plain' | 'contained';
+/**
+ * Official Saudi Riyal currency symbol.
+ *
+ * SAMA usage rules enforced by the component:
+ * - Symbol stays to the **left** of any amount (all languages)
+ * - Single space between symbol and amount
+ * - Default height matches text (`1em`); geometry is never stretched/mirrored
+ *
+ * @example
+ * ```html
+ * <dga-riyal />
+ * <dga-riyal [amount]="1250" />
+ * <dga-riyal amount="-123" />
+ * <dga-riyal amount="123 million" />
+ * <dga-riyal appearance="contained" size="lg" />
+ * ```
+ */
+declare class DgaRiyal {
+    readonly path = "M750 1119C730 1163 716 1211 711 1262L1136 1172C1156 1127 1169 1079 1174 1028L750 1119ZM1136 901C1156 857 1169 809 1174 758L843 828V693L1136 631C1156 587 1169 538 1174 488L843 558V72C793 100 748 138 711 183V586L579 614V6C528 34 483 72 447 117V642L151 705C131 750 117 798 112 849L447 777V948L88 1024C68 1068 55 1117 50 1167L425 1088C456 1081 482 1063 499 1038L568 936C575 926 579 913 579 899V749L711 721V992L1136 901Z";
+    readonly viewBox = "50 0 1124 1268";
+    /** Glyph height. Default `em` matches accompanying text (SAMA). */
+    readonly size: _angular_core.InputSignal<DgaRiyalSize>;
+    readonly tone: _angular_core.InputSignal<DgaRiyalTone>;
+    readonly appearance: _angular_core.InputSignal<DgaRiyalAppearance>;
+    /**
+     * Numeric / formatted amount. Negative values keep the minus after the
+     * symbol (SAMA: `⃁ -123`). Written units stay after the number
+     * (e.g. `123 million`).
+     */
+    readonly amount: _angular_core.InputSignal<string | number | null>;
+    /** Accessible name when the glyph is used alone (decorative when empty). */
+    readonly label: _angular_core.InputSignal<string>;
+    readonly amountText: _angular_core.Signal<string>;
+    readonly hostClasses: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaRiyal, never>;
+    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 DgaMetricTrend = 'up' | 'down' | 'neutral';
 /** `stat` = portal home metrics (icon well, value, label, centered). */
 type DgaMetricAppearance = 'default' | 'stat';
@@ -3114,5 +3918,5 @@ declare function dgaSaudiCityOptions(locale?: 'ar' | 'en', cities?: readonly Dga
     value: string;
 }[];
 
-export { DGA_GREGORIAN_MONTHS, DGA_HIJRI_MONTHS, DGA_ICON_NAMES, DGA_ICON_SVG, DGA_LOGICAL_ICON_NAMES, DGA_PHONE_COUNTRIES, DGA_SAUDI_CITIES, DGA_WEEKDAYS, DgaAccessibility, DgaAccessibilityService, DgaAccordion, DgaAccordionItem, DgaAlert, DgaAutocomplete, DgaAvatar, DgaBadge, DgaBreadcrumb, DgaButton, DgaCard, DgaCardMedia, DgaCarousel, DgaCarouselSlideDirective, DgaChart, DgaCheckbox, DgaChip, DgaChipInput, DgaClamp, DgaCode, DgaCookies, DgaCopy, DgaDatePickerComponent as DgaDatePicker, DgaDescriptionList, DgaDialog, DgaDivider, DgaDrawer, DgaEmpty, DgaExpandable, DgaExport, DgaExportToolbar, DgaFeedback, DgaField, DgaFilterBar, DgaFooter, DgaFormControl, DgaFormEnd, DgaFormStart, DgaGrid, DgaHeader, DgaHero, DgaIcon, DgaIconBadge, DgaIconFontService, DgaImagePopup, DgaInput, DgaLabel, DgaLink, DgaList, DgaLogoTile, DgaMenu, DgaMetric, DgaModal, DgaMultiselect, DgaNativeSelect, DgaNumber, DgaNumberInput, DgaOtp, DgaPageFeedback, DgaPagination, DgaPersona, DgaPhoneInput, DgaPreloader, DgaProgress, DgaQuote, DgaRadio, DgaRating, DgaScrollTop, DgaSection, DgaSelect, DgaShare, DgaSideInfo, DgaSideNav, DgaSkeleton, DgaSkipLink, DgaSlider, DgaSpinner, DgaStepper, DgaSwitch, DgaTab, DgaTable, DgaTabs, DgaToast, DgaToastOutlet, DgaToastService, DgaToc, DgaToolbar, DgaTooltip, DgaTopBar, DgaUpload, decodePlatformscodeSvg, dgaAddMonths, dgaClampDate, dgaCoerceDate, dgaCompareDays, dgaDaysInMonth, dgaFormatDate, dgaGetCalendarParts, dgaGroupSaudiCitiesByRegion, dgaModeFromFormat, dgaMonthNames, dgaMonthStartWeekday, dgaParseDate, dgaPartsToDate, dgaSameDay, dgaSaudiCityOptions, dgaTodayUtc };
-export type { DgaA11yBundle, DgaA11yMode, DgaA11yVisualFilter, DgaAccessibilityPosition, DgaAlertDisplay, DgaAlertVariant, DgaAutocompleteOption, DgaAvatarSize, DgaBadgeSize, DgaBadgeVariant, DgaBreadcrumbItem, DgaBreadcrumbSeparator, DgaButtonSize, DgaButtonVariant, DgaCalendar, DgaCalendarParts, DgaCardActionsAlign, DgaCardAppearance, DgaCardBadge, DgaCardBorder, DgaCardPadding, DgaCardShadow, DgaCarouselSlide, DgaChartDataset, DgaChartPoint, DgaChartType, DgaCheckboxSize, DgaChipVariant, DgaCookieConsent, DgaCurrency, DgaDateCalendar, DgaDatePickerMode, DgaDateRangeValue, DgaDescriptionItem, DgaDescriptionLayout, DgaDialogSize, DgaDividerOrientation, DgaDrawerSide, DgaEmptyAppearance, DgaExportColumn, DgaExportData, DgaExportScope, DgaFeedbackSubmit, DgaFilterItem, DgaFooterAppearance, DgaFooterColumn, DgaFooterIconGroup, DgaFooterIconLink, DgaFooterLink, DgaFooterLogo, DgaFormControlSize, DgaFormStatus, DgaGridCols, DgaGridGap, DgaHeaderAction, DgaHeaderAppearance, DgaHeaderLoginConfig, DgaHeaderNotification, DgaHeaderNotificationAction, DgaHeaderNotificationTone, DgaHeaderNotificationsConfig, DgaHeaderSearchConfig, DgaHeaderSearchSuggestion, DgaHeaderUserConfig, DgaHeaderUserMenuLink, DgaHeroAppearance, DgaHeroImageMask, DgaHeroOverlayTone, DgaHeroSlide, DgaHeroTransition, DgaIconBadgeAppearance, DgaIconBadgeSize, DgaIconName, DgaIconSize, DgaIconTone, DgaImagePopupAnimation, DgaImagePopupImage, DgaImagePopupImageTransition, DgaImagePopupSource, DgaInputSize, DgaLinkVariant, DgaMenuItem, DgaMetricAppearance, DgaMetricTrend, DgaMobileNavMode, DgaModalAnimation, DgaModalSize, DgaMultiselectOption, DgaNativeSelectSize, DgaNavColumn, DgaNavDropdown, DgaNavDropdownLayout, DgaNavDropdownVariant, DgaNavFeatured, DgaNavItem, DgaNavLink, DgaPageFeedbackAgreementLink, DgaPageFeedbackAnswer, DgaPageFeedbackOption, DgaPageFeedbackPhase, DgaPageFeedbackSubmit, DgaPhoneCountry, DgaPreloaderPersist, DgaProgressAppearance, DgaProgressSize, DgaProgressTone, DgaRadioSize, DgaRatingSize, DgaSaudiCity, DgaScrollTopPosition, DgaSectionTone, DgaSectionWidth, DgaSelectOpenMode, DgaSelectOption, DgaSelectSize, DgaShareAppearance, DgaSideInfoItem, DgaSideNavItem, DgaSkeletonAnimation, DgaSkeletonRadius, DgaSkeletonShape, DgaSkeletonSize, DgaSortDir, DgaSpinnerSize, DgaSpinnerTone, DgaStampNotice, DgaStep, DgaSwitchSize, DgaTableColumn, DgaTableDensity, DgaTimeFormat, DgaToastRequest, DgaToastShowOptions, DgaToastVariant, DgaTocItem, DgaTooltipPlacement, DgaTooltipVariant, DgaUploadAppearance, DgaUploadFile };
+export { DGA_GREGORIAN_MONTHS, DGA_HIJRI_MONTHS, DGA_ICON_NAMES, DGA_ICON_SVG, DGA_LOGICAL_ICON_NAMES, DGA_PHONE_COUNTRIES, DGA_RIYAL_SVG_PATH, DGA_RIYAL_VIEWBOX, DGA_SAUDI_CITIES, DGA_WEEKDAYS, DgaAccessibility, DgaAccessibilityService, DgaAccordion, DgaAccordionItem, DgaAlert, DgaAnnouncementBar, DgaAppShell, DgaAuthCard, DgaAutocomplete, DgaAvatar, DgaBadge, DgaBreadcrumb, DgaButton, DgaCard, DgaCardMedia, DgaCarousel, DgaCarouselSlideDirective, DgaChart, DgaChatbot, DgaCheckbox, DgaChip, DgaChipInput, DgaClamp, DgaCode, DgaCookies, DgaCopy, DgaDatePickerComponent as DgaDatePicker, DgaDescriptionList, DgaDialog, DgaDivider, DgaDrawer, DgaDualNav, DgaEmpty, DgaExpandable, DgaExport, DgaExportToolbar, DgaFeedback, DgaField, DgaFilterBar, DgaFooter, DgaFormControl, DgaFormEnd, DgaFormStart, DgaGrid, DgaHeader, DgaHero, DgaIcon, DgaIconBadge, DgaIconFontService, DgaImagePopup, DgaInfoList, DgaInput, DgaLabel, DgaLink, DgaList, DgaLogoTile, DgaMenu, DgaMetric, DgaModal, DgaMultiselect, DgaNativeSelect, DgaNavRail, DgaNumber, DgaNumberInput, DgaOtp, DgaPageFeedback, DgaPageHero, DgaPagination, DgaPersona, DgaPhoneInput, DgaPreloader, DgaProgress, DgaQuote, DgaRadio, DgaRating, DgaRiyal, DgaScrollTop, DgaSection, DgaSelect, DgaShare, DgaSideInfo, DgaSideNav, DgaSkeleton, DgaSkipLink, DgaSlider, DgaSpinner, DgaStepper, DgaSwitch, DgaTab, DgaTable, DgaTabs, DgaTimePicker, DgaTimeline, DgaToast, DgaToastOutlet, DgaToastService, DgaToc, DgaToolbar, DgaTooltip, DgaTopBar, DgaUpload, decodePlatformscodeSvg, dgaAddMonths, dgaClampDate, dgaCoerceDate, dgaCompareDays, dgaDaysInMonth, dgaFormatDate, dgaGetCalendarParts, dgaGroupSaudiCitiesByRegion, dgaModeFromFormat, dgaMonthNames, dgaMonthStartWeekday, dgaNormalizeTime, dgaParseDate, dgaPartsToDate, dgaProvideValueAccessor, dgaSameDay, dgaSaudiCityOptions, dgaTodayUtc };
+export type { DgaA11yBundle, DgaA11yMode, DgaA11yVisualFilter, DgaAccessibilityPosition, DgaAccordionSection, DgaAlertDisplay, DgaAlertVariant, DgaAnnouncementActionVariant, DgaAnnouncementAlign, DgaAnnouncementDensity, DgaAnnouncementElevation, DgaAnnouncementPersist, DgaAnnouncementTone, DgaAppShellAppearance, DgaAutocompleteOption, DgaAvatarSize, DgaBadgeSize, DgaBadgeVariant, DgaBreadcrumbItem, DgaBreadcrumbSeparator, DgaButtonSize, DgaButtonVariant, DgaCalendar, DgaCalendarParts, DgaCardActionsAlign, DgaCardAppearance, DgaCardBadge, DgaCardBorder, DgaCardPadding, DgaCardShadow, DgaCarouselSlide, DgaChartDataset, DgaChartPoint, DgaChartType, DgaChatbotAnimation, DgaChatbotFabTone, DgaChatbotMessage, DgaChatbotPosition, DgaChatbotSize, DgaCheckboxSize, DgaChipVariant, DgaCookieCategory, DgaCookieConsent, DgaCookieDecision, DgaCookiePreferences, DgaCookiesAlign, DgaCookiesPosition, DgaCurrency, DgaDateCalendar, DgaDatePickerMode, DgaDateRangeValue, DgaDescriptionItem, DgaDescriptionLayout, DgaDialogSize, DgaDividerOrientation, DgaDrawerSide, DgaDualNavCategory, DgaDualNavSection, DgaEmptyAppearance, DgaExportColumn, DgaExportData, DgaExportScope, DgaFeedbackSubmit, DgaFilterItem, DgaFooterAppearance, DgaFooterColumn, DgaFooterIconGroup, DgaFooterIconLink, DgaFooterLink, DgaFooterLogo, DgaFormControlSize, DgaFormStatus, DgaGridCols, DgaGridGap, DgaHeaderAction, DgaHeaderAppearance, DgaHeaderLoginConfig, DgaHeaderNotification, DgaHeaderNotificationAction, DgaHeaderNotificationTone, DgaHeaderNotificationsConfig, DgaHeaderSearchConfig, DgaHeaderSearchSuggestion, DgaHeaderUserConfig, DgaHeaderUserMenuLink, DgaHeroAppearance, DgaHeroImageMask, DgaHeroOverlayTone, DgaHeroSlide, DgaHeroTransition, DgaIconBadgeAppearance, DgaIconBadgeSize, DgaIconName, DgaIconSize, DgaIconTone, DgaImagePopupAnimation, DgaImagePopupImage, DgaImagePopupImageTransition, DgaImagePopupSource, DgaInfoListItem, DgaInputSize, DgaLinkVariant, DgaMenuItem, DgaMetricAppearance, DgaMetricTrend, DgaMobileNavMode, DgaModalAnimation, DgaModalSize, DgaMultiselectOption, DgaNativeSelectSize, DgaNavColumn, DgaNavDropdown, DgaNavDropdownLayout, DgaNavDropdownVariant, DgaNavFeatured, DgaNavItem, DgaNavLink, DgaNavRailActiveStyle, DgaNavRailAppearance, DgaNavRailItem, DgaNavRailPosition, DgaNavRailSize, DgaPageFeedbackAgreementLink, DgaPageFeedbackAnswer, DgaPageFeedbackOption, DgaPageFeedbackPhase, DgaPageFeedbackSubmit, DgaPageHeroTone, DgaPhoneCountry, DgaPreloaderPersist, DgaProgressAppearance, DgaProgressSize, DgaProgressTone, DgaRadioSize, DgaRatingSize, DgaRiyalAppearance, DgaRiyalSize, DgaRiyalTone, DgaSaudiCity, DgaScrollTopPosition, DgaSectionTone, DgaSectionWidth, DgaSelectOpenMode, DgaSelectOption, DgaSelectSize, DgaShareAppearance, DgaSideInfoItem, DgaSideNavGroup, DgaSideNavItem, DgaSkeletonAnimation, DgaSkeletonRadius, DgaSkeletonShape, DgaSkeletonSize, DgaSortDir, DgaSpinnerSize, DgaSpinnerTone, DgaStampNotice, DgaStep, DgaStepStatus, DgaSwitchSize, DgaTabItem, DgaTableColumn, DgaTableDensity, DgaTimeFormat, DgaTimePickerFormat, DgaTimePickerSize, DgaTimelineItem, DgaToastRequest, DgaToastShowOptions, DgaToastVariant, DgaTocItem, DgaTooltipPlacement, DgaTooltipVariant, DgaUploadAppearance, DgaUploadFile, DgaUploadRejection };