@a.nemreen/dga-ui 0.3.13 → 0.3.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a.nemreen/dga-ui",
-  "version": "0.3.13",
+  "version": "0.3.14",
   "description": "DGA Angular UI library — standalone forms, overlays, navigation, and portal shell with RTL-first Tailwind styling",
   "license": "MIT",
   "author": {
@@ -67,6 +67,14 @@
       "types": "./types/a.nemreen-dga-ui.d.ts",
       "default": "./fesm2022/a.nemreen-dga-ui.mjs"
     },
+    "./chart": {
+      "types": "./types/a.nemreen-dga-ui-chart.d.ts",
+      "default": "./fesm2022/a.nemreen-dga-ui-chart.mjs"
+    },
+    "./chatbot": {
+      "types": "./types/a.nemreen-dga-ui-chatbot.d.ts",
+      "default": "./fesm2022/a.nemreen-dga-ui-chatbot.mjs"
+    },
     "./cookies": {
       "types": "./types/a.nemreen-dga-ui-cookies.d.ts",
       "default": "./fesm2022/a.nemreen-dga-ui-cookies.mjs"
@@ -78,6 +86,14 @@
     "./header": {
       "types": "./types/a.nemreen-dga-ui-header.d.ts",
       "default": "./fesm2022/a.nemreen-dga-ui-header.mjs"
+    },
+    "./page-transition": {
+      "types": "./types/a.nemreen-dga-ui-page-transition.d.ts",
+      "default": "./fesm2022/a.nemreen-dga-ui-page-transition.mjs"
+    },
+    "./saudi-cities": {
+      "types": "./types/a.nemreen-dga-ui-saudi-cities.d.ts",
+      "default": "./fesm2022/a.nemreen-dga-ui-saudi-cities.mjs"
     }
   },
   "type": "module"

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

@@ -0,0 +1,157 @@
+import * as _angular_core from '@angular/core';
+
+type DgaChartType = 'bar' | 'line' | 'pie' | 'donut';
+/** Backward-compatible single-series point: `{ label, value }`. */
+interface DgaChartPoint {
+    label: string;
+    value: number;
+}
+/** Multi-series data: one named series of values, aligned with `labels()`. */
+interface DgaChartDataset {
+    name: string;
+    data: number[];
+}
+interface DgaChartBarSlot {
+    seriesIndex: number;
+    categoryIndex: number;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    value: number;
+    color: string;
+    name: string;
+    category: string;
+}
+interface DgaChartLinePoint {
+    x: number;
+    y: number;
+    value: number;
+    category: string;
+}
+interface DgaChartLine {
+    name: string;
+    color: string;
+    points: DgaChartLinePoint[];
+    linePath: string;
+    areaPath: string;
+}
+interface DgaChartLegendItem {
+    name: string;
+    color: string;
+    value: number | null;
+}
+interface DgaChartTooltip {
+    x: number;
+    y: number;
+    title: string;
+    items: {
+        name: string;
+        color: string;
+        value: number;
+    }[];
+}
+declare class DgaChart {
+    readonly type: _angular_core.InputSignal<DgaChartType>;
+    /** BC single-series input: `[{ label, value }]`. */
+    readonly series: _angular_core.InputSignal<DgaChartPoint[]>;
+    /** Category names shared by all `datasets()`. */
+    readonly labels: _angular_core.InputSignal<string[]>;
+    /** Preferred multi-series input for bar/line. */
+    readonly datasets: _angular_core.InputSignal<DgaChartDataset[]>;
+    /** Shown for pie/donut and multi-series bar/line. Set `false` to force-hide. */
+    readonly legend: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly tooltip: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly grid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly stacked: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly smooth: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly area: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly dots: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Overrides the `--dga-chart-color-1..6` token cycle. */
+    readonly colors: _angular_core.InputSignal<string[]>;
+    /** Label for the value row in pie/donut tooltips. Default: `'القيمة'`. */
+    readonly tooltipValueLabel: _angular_core.InputSignal<string>;
+    readonly height: _angular_core.InputSignal<number>;
+    readonly label: _angular_core.InputSignal<string>;
+    /** Fixed drawing width; scales via CSS `w-full`. */
+    readonly width = 400;
+    readonly pieSize = 180;
+    readonly pad: {
+        t: number;
+        r: number;
+        b: number;
+        l: number;
+    };
+    private readonly hiddenNames;
+    readonly hiddenSeries: _angular_core.Signal<Set<string>>;
+    readonly hoveredCategoryIndex: _angular_core.WritableSignal<number | null>;
+    readonly hoveredSlice: _angular_core.WritableSignal<{
+        index: number;
+        label: string;
+        value: number;
+    } | null>;
+    readonly isPieType: _angular_core.Signal<boolean>;
+    /** Category labels: explicit `labels()`, else derived from `datasets()` length, else BC `series()` labels. */
+    readonly categories: _angular_core.Signal<string[]>;
+    /** Normalized series: `datasets()` when present, else one series built from BC `series()`. */
+    readonly seriesList: _angular_core.Signal<DgaChartDataset[]>;
+    readonly visibleSeriesList: _angular_core.Signal<DgaChartDataset[]>;
+    /** Points feeding pie/donut: BC `series()`, else first dataset paired with `labels()`. */
+    readonly piePoints: _angular_core.Signal<DgaChartPoint[]>;
+    readonly visiblePiePoints: _angular_core.Signal<DgaChartPoint[]>;
+    readonly showLegend: _angular_core.Signal<boolean>;
+    readonly legendItems: _angular_core.Signal<DgaChartLegendItem[]>;
+    colorFor(index: number): string;
+    toggleSeries(name: string): void;
+    readonly ariaLabel: _angular_core.Signal<string>;
+    readonly plot: _angular_core.Signal<{
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>;
+    readonly gridYs: _angular_core.Signal<number[]>;
+    readonly maxValue: _angular_core.Signal<number>;
+    /** Layout for one group (category) slot shared by bars and the hover hit-rect. */
+    private readonly groupLayout;
+    readonly categoryTicks: _angular_core.Signal<{
+        index: number;
+        category: string;
+        x: number;
+        hitX: number;
+        hitW: number;
+    }[]>;
+    readonly bars: _angular_core.Signal<DgaChartBarSlot[]>;
+    readonly visibleLines: _angular_core.Signal<DgaChartLine[]>;
+    private straightPathD;
+    /** Piecewise cubic Bezier through the points (Catmull-Rom style tangents). */
+    private smoothPathD;
+    private areaPathD;
+    readonly pieSlices: _angular_core.Signal<{
+        index: number;
+        label: string;
+        value: number;
+        color: string;
+        d: string;
+        midX: number;
+        midY: number;
+    }[]>;
+    onCategoryEnter(index: number): void;
+    onCategoryLeave(): void;
+    onSliceEnter(index: number, slice: {
+        label: string;
+        value: number;
+    }): void;
+    onSliceLeave(): void;
+    categoryAriaLabel(index: number): string;
+    readonly categoryTooltip: _angular_core.Signal<DgaChartTooltip | null>;
+    readonly sliceTooltip: _angular_core.Signal<DgaChartTooltip | null>;
+    formatValue(value: number): string;
+    pieTooltipStyle(tip: DgaChartTooltip): Record<string, string>;
+    plotTooltipStyle(tip: DgaChartTooltip): Record<string, string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaChart, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaChart, "dga-chart", never, { "type": { "alias": "type"; "required": false; "isSignal": true; }; "series": { "alias": "series"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "datasets": { "alias": "datasets"; "required": false; "isSignal": true; }; "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "grid": { "alias": "grid"; "required": false; "isSignal": true; }; "stacked": { "alias": "stacked"; "required": false; "isSignal": true; }; "smooth": { "alias": "smooth"; "required": false; "isSignal": true; }; "area": { "alias": "area"; "required": false; "isSignal": true; }; "dots": { "alias": "dots"; "required": false; "isSignal": true; }; "colors": { "alias": "colors"; "required": false; "isSignal": true; }; "tooltipValueLabel": { "alias": "tooltipValueLabel"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { DgaChart };
+export type { DgaChartDataset, DgaChartPoint, DgaChartType };

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

@@ -0,0 +1,102 @@
+import * as _angular_core from '@angular/core';
+
+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` → chatbot `1` → scroll-top `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<"user" | "access" | "check" | "close" | "info" | "helpCircle" | "warning" | "alertCircle" | "error" | "eye" | "eyeOff" | "eyeOffSlash" | "filter" | "success" | "checkCircle" | "checkCircleAlt" | "chevronDown" | "chevronLeft" | "chevronRight" | "arrowUp" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp02" | "arrowDown02" | "arrowLeft02" | "arrowRight02" | "arrowNext" | "arrowPrev" | "arrowNext02" | "arrowPrev02" | "shrink" | "search" | "users" | "menu" | "menuAlt" | "moreHorizontal" | "moreVertical" | "mic" | "home" | "download" | "upload" | "calendar" | "calendarAlt" | "clock" | "star" | "starFilled" | "plus" | "plusSign" | "minus" | "external" | "bell" | "bellAlt" | "lock" | "lockPassword" | "logout" | "idCard" | "link" | "linkAlt" | "globe" | "moon" | "moonAlt" | "sun" | "sunAlt" | "translation" | "mail" | "message" | "phone" | "building" | "share" | "refresh" | "highlighter" | "door" | "zoomIn" | "zoomOut" | "sort" | "sortUp" | "sortDown" | "tradeUp" | "tradeDown" | "paintBoard" | "cloud" | "sunCloud" | "moonCloud" | "rain" | "rainZap" | "snow" | "wind" | "desert" | "cart" | "award" | "cookie" | "x" | "linkedin" | "whatsapp" | "book" | "headphones" | "devices" | "badgeCheck" | "riyal" | "copy" | "location" | "folder" | "printer" | "instagram" | "smartphone" | "ambulance" | "police" | "fire" | "facebook" | "youtube" | "apple" | "playStore" | "huawei" | "textFont" | "glasses" | "heading" | "mask" | "pause" | "textAlign" | "letterSpacing" | "textUnderline" | "maximize" | "colors" | "colorPicker" | "droplet" | "disability" | "wheelchair" | "brain" | "flash" | "touch">;
+    /** Prefer a directional arrow so send ≠ chat bubble. */
+    readonly sendIcon: _angular_core.InputSignal<"user" | "access" | "check" | "close" | "info" | "helpCircle" | "warning" | "alertCircle" | "error" | "eye" | "eyeOff" | "eyeOffSlash" | "filter" | "success" | "checkCircle" | "checkCircleAlt" | "chevronDown" | "chevronLeft" | "chevronRight" | "arrowUp" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp02" | "arrowDown02" | "arrowLeft02" | "arrowRight02" | "arrowNext" | "arrowPrev" | "arrowNext02" | "arrowPrev02" | "shrink" | "search" | "users" | "menu" | "menuAlt" | "moreHorizontal" | "moreVertical" | "mic" | "home" | "download" | "upload" | "calendar" | "calendarAlt" | "clock" | "star" | "starFilled" | "plus" | "plusSign" | "minus" | "external" | "bell" | "bellAlt" | "lock" | "lockPassword" | "logout" | "idCard" | "link" | "linkAlt" | "globe" | "moon" | "moonAlt" | "sun" | "sunAlt" | "translation" | "mail" | "message" | "phone" | "building" | "share" | "refresh" | "highlighter" | "door" | "zoomIn" | "zoomOut" | "sort" | "sortUp" | "sortDown" | "tradeUp" | "tradeDown" | "paintBoard" | "cloud" | "sunCloud" | "moonCloud" | "rain" | "rainZap" | "snow" | "wind" | "desert" | "cart" | "award" | "cookie" | "x" | "linkedin" | "whatsapp" | "book" | "headphones" | "devices" | "badgeCheck" | "riyal" | "copy" | "location" | "folder" | "printer" | "instagram" | "smartphone" | "ambulance" | "police" | "fire" | "facebook" | "youtube" | "apple" | "playStore" | "huawei" | "textFont" | "glasses" | "heading" | "mask" | "pause" | "textAlign" | "letterSpacing" | "textUnderline" | "maximize" | "colors" | "colorPicker" | "droplet" | "disability" | "wheelchair" | "brain" | "flash" | "touch">;
+    readonly agentIcon: _angular_core.InputSignal<"user" | "access" | "check" | "close" | "info" | "helpCircle" | "warning" | "alertCircle" | "error" | "eye" | "eyeOff" | "eyeOffSlash" | "filter" | "success" | "checkCircle" | "checkCircleAlt" | "chevronDown" | "chevronLeft" | "chevronRight" | "arrowUp" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp02" | "arrowDown02" | "arrowLeft02" | "arrowRight02" | "arrowNext" | "arrowPrev" | "arrowNext02" | "arrowPrev02" | "shrink" | "search" | "users" | "menu" | "menuAlt" | "moreHorizontal" | "moreVertical" | "mic" | "home" | "download" | "upload" | "calendar" | "calendarAlt" | "clock" | "star" | "starFilled" | "plus" | "plusSign" | "minus" | "external" | "bell" | "bellAlt" | "lock" | "lockPassword" | "logout" | "idCard" | "link" | "linkAlt" | "globe" | "moon" | "moonAlt" | "sun" | "sunAlt" | "translation" | "mail" | "message" | "phone" | "building" | "share" | "refresh" | "highlighter" | "door" | "zoomIn" | "zoomOut" | "sort" | "sortUp" | "sortDown" | "tradeUp" | "tradeDown" | "paintBoard" | "cloud" | "sunCloud" | "moonCloud" | "rain" | "rainZap" | "snow" | "wind" | "desert" | "cart" | "award" | "cookie" | "x" | "linkedin" | "whatsapp" | "book" | "headphones" | "devices" | "badgeCheck" | "riyal" | "copy" | "location" | "folder" | "printer" | "instagram" | "smartphone" | "ambulance" | "police" | "fire" | "facebook" | "youtube" | "apple" | "playStore" | "huawei" | "textFont" | "glasses" | "heading" | "mask" | "pause" | "textAlign" | "letterSpacing" | "textUnderline" | "maximize" | "colors" | "colorPicker" | "droplet" | "disability" | "wheelchair" | "brain" | "flash" | "touch">;
+    readonly fabTone: _angular_core.InputSignal<DgaChatbotFabTone>;
+    /** Dim page behind the panel. */
+    readonly overlay: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Close when clicking the overlay. */
+    readonly overlayClose: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Green online dot on the agent avatar. */
+    readonly online: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Hide launcher while the panel is open (recommended). */
+    readonly hideFabWhenOpen: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * 0-based slot in the shared FAB dock (bottom → top).
+     * Typical: a11y=0, chatbot=1, scroll-top=2.
+     */
+    readonly stack: _angular_core.InputSignalWithTransform<number, unknown>;
+    /**
+     * @deprecated Prefer `stack`. When true and `stack` is unset legacy path —
+     * kept for callers; `stack` wins.
+     */
+    readonly clearFab: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Anchor FAB/panel inside a relative parent (gallery / docs preview)
+     * instead of the viewport — avoids a second global FAB.
+     */
+    readonly embedded: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly initialMessages: _angular_core.InputSignal<readonly DgaChatbotMessage[]>;
+    readonly sent: _angular_core.OutputEmitterRef<string>;
+    readonly opened: _angular_core.OutputEmitterRef<void>;
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    readonly open: _angular_core.WritableSignal<boolean>;
+    readonly draft: _angular_core.WritableSignal<string>;
+    readonly messages: _angular_core.WritableSignal<DgaChatbotMessage[]>;
+    private readonly seq;
+    readonly panelId: string;
+    private msgSeq;
+    private seeded;
+    private prevOverflow;
+    readonly copy: _angular_core.Signal<{
+        title: string;
+        subtitle: string;
+        open: string;
+        close: string;
+        send: string;
+        input: string;
+        placeholder: string;
+        panelLabel: string;
+        welcome: string;
+    }>;
+    readonly fabBottom: _angular_core.Signal<string>;
+    readonly fabClasses: _angular_core.Signal<string>;
+    readonly panelClasses: _angular_core.Signal<string>;
+    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>;
+}
+
+export { DgaChatbot };
+export type { DgaChatbotAnimation, DgaChatbotFabTone, DgaChatbotMessage, DgaChatbotPosition, DgaChatbotSize };

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

@@ -1,6 +1,5 @@
 import * as _angular_core from '@angular/core';
 import { OnInit } from '@angular/core';
-import { DgaIconName } from '@a.nemreen/dga-ui';
 
 /** Stored consent outcome. `custom` = per-category preferences were saved. */
 type DgaCookieConsent = 'accepted' | 'declined' | 'custom' | null;
@@ -78,7 +77,7 @@ declare class DgaCookies implements OnInit {
     readonly declineLabel: _angular_core.InputSignal<string>;
     readonly customizeLabel: _angular_core.InputSignal<string>;
     readonly saveLabel: _angular_core.InputSignal<string>;
-    readonly icon: _angular_core.InputSignal<DgaIconName>;
+    readonly icon: _angular_core.InputSignal<"access" | "check" | "close" | "info" | "helpCircle" | "warning" | "alertCircle" | "error" | "eye" | "eyeOff" | "eyeOffSlash" | "filter" | "success" | "checkCircle" | "checkCircleAlt" | "chevronDown" | "chevronLeft" | "chevronRight" | "arrowUp" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp02" | "arrowDown02" | "arrowLeft02" | "arrowRight02" | "arrowNext" | "arrowPrev" | "arrowNext02" | "arrowPrev02" | "shrink" | "search" | "user" | "users" | "menu" | "menuAlt" | "moreHorizontal" | "moreVertical" | "mic" | "home" | "download" | "upload" | "calendar" | "calendarAlt" | "clock" | "star" | "starFilled" | "plus" | "plusSign" | "minus" | "external" | "bell" | "bellAlt" | "lock" | "lockPassword" | "logout" | "idCard" | "link" | "linkAlt" | "globe" | "moon" | "moonAlt" | "sun" | "sunAlt" | "translation" | "mail" | "message" | "phone" | "building" | "share" | "refresh" | "highlighter" | "door" | "zoomIn" | "zoomOut" | "sort" | "sortUp" | "sortDown" | "tradeUp" | "tradeDown" | "paintBoard" | "cloud" | "sunCloud" | "moonCloud" | "rain" | "rainZap" | "snow" | "wind" | "desert" | "cart" | "award" | "cookie" | "x" | "linkedin" | "whatsapp" | "book" | "headphones" | "devices" | "badgeCheck" | "riyal" | "copy" | "location" | "folder" | "printer" | "instagram" | "smartphone" | "ambulance" | "police" | "fire" | "facebook" | "youtube" | "apple" | "playStore" | "huawei" | "textFont" | "glasses" | "heading" | "mask" | "pause" | "textAlign" | "letterSpacing" | "textUnderline" | "maximize" | "colors" | "colorPicker" | "droplet" | "disability" | "wheelchair" | "brain" | "flash" | "touch">;
     /** Google Analytics IDs to disable on decline / when analytics is off. */
     readonly gaTrackingIds: _angular_core.InputSignal<string | readonly string[]>;
     /** Consent cookie lifetime in days. */

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

@@ -0,0 +1,51 @@
+import * as _angular_core from '@angular/core';
+
+/** Creative named page transitions for `dga-page-transition`. */
+declare const DGA_PAGE_TRANSITION_NAMES: readonly ["fade-up", "slide-stack", "curtain-wipe", "zoom-blur", "book-flip", "circle-reveal", "shared-axis", "glitch", "iris-open", "split-reveal", "stagger-cascade", "liquid-swipe", "push-depth", "skew-slide", "bounce-in", "film-strip", "portal-warp", "ripple-expand", "origami-fold", "swipe-cards", "none"];
+type DgaPageTransitionName = (typeof DGA_PAGE_TRANSITION_NAMES)[number];
+/**
+ * Easy page / content transition wrapper.
+ *
+ * ```html
+ * <dga-page-transition name="fade-up">
+ *   <router-outlet />
+ * </dga-page-transition>
+ * ```
+ *
+ * Triggers: Angular `NavigationEnd`, or a change to `key` (playground / content swap).
+ * Progressive enhancement: sets `view-transition-name: dga-page` so apps using
+ * `withViewTransitions()` get named snapshot animations. Keyframe enter runs as fallback.
+ * Honors `prefers-reduced-motion` and DGA a11y `reduce-motion`.
+ */
+declare class DgaPageTransition {
+    private readonly host;
+    private readonly doc;
+    private readonly destroyRef;
+    private readonly router;
+    /** Named creative transition. Unknown values resolve to `none`. */
+    readonly name: _angular_core.InputSignal<string>;
+    /** Duration in milliseconds (also drives `--dga-pt-ms`). */
+    readonly duration: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Skip all motion. */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Bump this to re-play the enter animation (content swaps / gallery playground).
+     * For View Transition snapshots, wrap the key update in `document.startViewTransition`.
+     */
+    readonly key: _angular_core.InputSignal<string | number | null>;
+    readonly phase: _angular_core.WritableSignal<"idle" | "enter">;
+    readonly resolvedName: _angular_core.Signal<"fade-up" | "slide-stack" | "curtain-wipe" | "zoom-blur" | "book-flip" | "circle-reveal" | "shared-axis" | "glitch" | "iris-open" | "split-reveal" | "stagger-cascade" | "liquid-swipe" | "push-depth" | "skew-slide" | "bounce-in" | "film-strip" | "portal-warp" | "ripple-expand" | "origami-fold" | "swipe-cards" | "none">;
+    readonly durationCss: _angular_core.Signal<string>;
+    private htmlAttr;
+    private keyPrimed;
+    constructor();
+    /** Re-trigger the enter animation (e.g. from a Play control). */
+    play(): void;
+    protected onAnimationEnd(event: AnimationEvent): void;
+    private shouldReduceMotion;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaPageTransition, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaPageTransition, "dga-page-transition", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "duration": { "alias": "duration"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "key": { "alias": "key"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+export { DGA_PAGE_TRANSITION_NAMES, DgaPageTransition };
+export type { DgaPageTransitionName };

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

@@ -0,0 +1,19 @@
+interface DgaSaudiCity {
+    id: number;
+    region: string;
+    regionAr: string;
+    name: string;
+    nameAr: string;
+}
+/** Bilingual Saudi cities across all 13 administrative regions. */
+declare const DGA_SAUDI_CITIES: readonly DgaSaudiCity[];
+/** Group cities by English region name. */
+declare function dgaGroupSaudiCitiesByRegion(cities?: readonly DgaSaudiCity[]): Record<string, DgaSaudiCity[]>;
+/** Autocomplete-ready options (Arabic labels by default). */
+declare function dgaSaudiCityOptions(locale?: string, cities?: readonly DgaSaudiCity[]): {
+    label: string;
+    value: string;
+}[];
+
+export { DGA_SAUDI_CITIES, dgaGroupSaudiCitiesByRegion, dgaSaudiCityOptions };
+export type { DgaSaudiCity };