@a.nemreen/dga-ui 0.3.7 → 0.3.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a.nemreen/dga-ui",
-  "version": "0.3.7",
+  "version": "0.3.11",
   "description": "DGA Angular UI library — standalone forms, overlays, navigation, and portal shell with RTL-first Tailwind styling",
   "license": "MIT",
   "author": {

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

@@ -258,7 +258,7 @@ declare class DgaProgress {
     readonly clamped: _angular_core.Signal<number>;
     readonly dashOffset: _angular_core.Signal<number>;
     readonly displayValue: _angular_core.Signal<string>;
-    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>;
@@ -2134,19 +2134,6 @@ declare class DgaPagination {
     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; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
-}
-
 interface DgaTabItem {
     value: string;
     label: string;
@@ -2159,7 +2146,7 @@ declare class DgaTabs {
     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 tabs: _angular_core.Signal<readonly any[]>;
     readonly headerItems: _angular_core.Signal<DgaTabItem[]>;
     constructor();
     tabButtonClass(value: string, disabled: boolean): string;
@@ -2173,8 +2160,13 @@ declare class DgaTabs {
     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>;
 }
 
-declare class DgaContentSwitcherPanel {
-    private readonly switcher;
+declare class DgaTab {
+    private readonly tabs;
+    /**
+     * Defaults instead of `input.required`: the parent reads these from
+     * `contentChildren` during the first CD cycle, before Angular has bound
+     * inputs. Required inputs throw NG0950 in that window.
+     */
     readonly value: _angular_core.InputSignal<string>;
     readonly label: _angular_core.InputSignal<string>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -2182,8 +2174,8 @@ declare class DgaContentSwitcherPanel {
     readonly tabId: string;
     readonly panelId: string;
     readonly active: _angular_core.Signal<boolean>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaContentSwitcherPanel, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaContentSwitcherPanel, "dga-content-switcher-panel", 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>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaTab, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaTab, "dga-tab", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 interface DgaContentSwitcherItem {
@@ -2202,7 +2194,7 @@ declare class DgaContentSwitcher {
     readonly selected: _angular_core.ModelSignal<string>;
     readonly label: _angular_core.InputSignal<string>;
     readonly items: _angular_core.InputSignal<DgaContentSwitcherItem[]>;
-    readonly panels: _angular_core.Signal<readonly DgaContentSwitcherPanel[]>;
+    readonly panels: _angular_core.Signal<readonly any[]>;
     readonly headerItems: _angular_core.Signal<DgaContentSwitcherItem[]>;
     constructor();
     segmentClass(value: string, disabled: boolean): string;
@@ -2216,6 +2208,24 @@ declare class DgaContentSwitcher {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaContentSwitcher, "dga-content-switcher", never, { "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; }, { "selected": "selectedChange"; }, ["panels"], ["*"], true, never>;
 }
 
+declare class DgaContentSwitcherPanel {
+    private readonly switcher;
+    /**
+     * Defaults instead of `input.required`: the parent reads these from
+     * `contentChildren` during the first CD cycle, before Angular has bound
+     * inputs. Required inputs throw NG0950 in that window.
+     */
+    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<DgaContentSwitcherPanel, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaContentSwitcherPanel, "dga-content-switcher-panel", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
 type DgaStepStatus = 'pending' | 'active' | 'completed' | 'error';
 interface DgaStep {
     label: string;
@@ -2448,7 +2458,7 @@ declare class DgaToolbar {
 
 type DgaScrollTopPosition = 'end' | 'start' | 'left' | 'right';
 /**
- * Small “back to top” control. Shows after the page scrolls past `threshold`.
+ * “Back to top” control. Shows after the page scrolls past `threshold`.
  * Shares the FAB dock with `dga-accessibility` / `dga-chatbot` via `stack`.
  */
 declare class DgaScrollTop {
@@ -2472,8 +2482,7 @@ declare class DgaScrollTop {
     readonly clearFab: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly visible: _angular_core.WritableSignal<boolean>;
     /**
-     * Same dock math as a11y/chatbot, plus a half-slot nudge so the smaller
-     * control sits centered in the large FAB slot (avoids overlap).
+     * Same dock math as a11y / chatbot so the three FABs share one column.
      */
     readonly fabBottom: _angular_core.Signal<string>;
     private ticking;
@@ -2677,6 +2686,11 @@ declare class DgaAppShell {
     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>;
 }
 
+interface DgaWeatherView {
+    icon: DgaIconName;
+    label: string;
+}
+
 interface DgaStampNotice {
     title: string;
     /** Substring of `title` rendered bold in the primary color (e.g. `gov.sa`). */
@@ -2689,12 +2703,15 @@ type DgaTimeFormat = '12' | '24';
 /**
  * Exact shell size: 40px tall, sunken fill, 14px stamp copy.
  * Expand panel uses grid-template-rows for a smooth open/close.
- * Optional date + live clock sit in the end cluster (Hijri ↔ Gregorian).
+ * End cluster: weather · compact date (Hijri ↔ Gregorian) · live clock (12h ↔ 24h) · city.
  */
 declare class DgaTopBar {
     private readonly destroyRef;
     private clockTimer;
+    private weatherAbort;
     readonly saFlagSrc: string;
+    readonly clusterBtn: string;
+    readonly clusterStatic: string;
     readonly panelId = "dga-digital-stamp";
     readonly open: _angular_core.ModelSignal<boolean>;
     /** Active calendar for the date widget. Click the date to switch. */
@@ -2703,6 +2720,15 @@ declare class DgaTopBar {
     readonly timeFormat: _angular_core.ModelSignal<DgaTimeFormat>;
     readonly showDate: _angular_core.InputSignal<boolean>;
     readonly showTime: _angular_core.InputSignal<boolean>;
+    /** WMO weather condition for the resolved city (Open-Meteo). */
+    readonly showWeather: _angular_core.InputSignal<boolean>;
+    /** City name from geolocation, falling back to Riyadh. */
+    readonly showLocation: _angular_core.InputSignal<boolean>;
+    /**
+     * When true, show an allow-location dialog once per session if the browser
+     * permission is still `prompt`. Already-granted permission is used silently.
+     */
+    readonly autoRequestLocation: _angular_core.InputSignal<boolean>;
     /** Locale code for date/time formatting and default stamp copy (`ar` vs fallback English). */
     readonly locale: _angular_core.InputSignal<string>;
     /** Overrides the locale-aware default region `aria-label`. */
@@ -2727,7 +2753,68 @@ declare class DgaTopBar {
     /** Overrides the locale-aware default gov.sa / HTTPS notices. */
     readonly notices: _angular_core.InputSignal<DgaStampNotice[] | undefined>;
     private readonly now;
-    private readonly defaults;
+    readonly defaults: _angular_core.Signal<{
+        readonly regionLabel: "شريط الهوية الحكومية";
+        readonly stampLabel: "ختم الحكومة الرقمية";
+        readonly tabTextLg: "موقع حكومي مسجّل لدى هيئة الحكومة الرقمية.";
+        readonly tabTextSm: "موقع حكومي مسجّل لدى هيئة الحكومة الرقمية";
+        readonly verifyText: "كيف تتحقق؟";
+        readonly registrationLabel: "مسجّل لدى هيئة الحكومة الرقمية برقم:";
+        readonly locationAllowTitle: "السماح بالوصول إلى الموقع";
+        readonly locationAllowBody: "لعرض حالة الطقس واسم مدينتك نحتاج إلى إذن موقعك. يمكنك الرفض وسيُعرض طقس الرياض افتراضياً.";
+        readonly locationAllow: "السماح";
+        readonly locationNotNow: "ليس الآن";
+        readonly locationClose: "إغلاق";
+        readonly locationTooltip: "السماح بالوصول إلى الموقع لعرض الطقس في مدينتك";
+        readonly locationDeniedTooltip: "تم رفض إذن الموقع. يُعرض طقس الرياض.";
+        readonly locationRefreshTooltip: "تحديث الموقع الحالي";
+        readonly weatherLabel: "حالة الطقس";
+        readonly notices: ({
+            icon: "link";
+            title: string;
+            highlight: string;
+            body: string;
+        } | {
+            icon: "lock";
+            title: string;
+            highlight: string;
+            body: string;
+        })[];
+    } | {
+        readonly regionLabel: "Government identity bar";
+        readonly stampLabel: "Digital government stamp";
+        readonly tabTextLg: "A government website registered with the Digital Government Authority.";
+        readonly tabTextSm: "A government website registered with the Digital Government Authority";
+        readonly verifyText: "How to verify?";
+        readonly registrationLabel: "Registered with the Digital Government Authority under number:";
+        readonly locationAllowTitle: "Allow location access";
+        readonly locationAllowBody: "We use your location to show local weather and your city name. You can decline and we’ll show Riyadh weather instead.";
+        readonly locationAllow: "Allow";
+        readonly locationNotNow: "Not now";
+        readonly locationClose: "Close";
+        readonly locationTooltip: "Allow location access to show weather in your city";
+        readonly locationDeniedTooltip: "Location permission denied. Showing Riyadh weather.";
+        readonly locationRefreshTooltip: "Refresh current location";
+        readonly weatherLabel: "Weather";
+        readonly notices: ({
+            icon: "link";
+            title: string;
+            highlight: string;
+            body: string;
+        } | {
+            icon: "lock";
+            title: string;
+            highlight: string;
+            body: string;
+        })[];
+    }>;
+    readonly locationPromptOpen: _angular_core.WritableSignal<boolean>;
+    private readonly geoDenied;
+    private readonly geoGranted;
+    private readonly coords;
+    private readonly weatherSnap;
+    private readonly resolvedCity;
+    readonly weather: _angular_core.Signal<DgaWeatherView | null>;
     readonly resolvedRegionLabel: _angular_core.Signal<string>;
     readonly resolvedStampLabel: _angular_core.Signal<string>;
     readonly resolvedTabTextLg: _angular_core.Signal<string>;
@@ -2737,11 +2824,21 @@ declare class DgaTopBar {
     readonly resolvedNotices: _angular_core.Signal<DgaStampNotice[]>;
     readonly dateLabel: _angular_core.Signal<string>;
     readonly timeLabel: _angular_core.Signal<string>;
+    readonly cityLabel: _angular_core.Signal<string>;
+    readonly weatherAriaLabel: _angular_core.Signal<string>;
+    readonly locationTooltip: _angular_core.Signal<"السماح بالوصول إلى الموقع لعرض الطقس في مدينتك" | "تم رفض إذن الموقع. يُعرض طقس الرياض." | "تحديث الموقع الحالي" | "Allow location access to show weather in your city" | "Location permission denied. Showing Riyadh weather." | "Refresh current location">;
     readonly calendarToggleLabel: _angular_core.Signal<"التبديل إلى التقويم الميلادي" | "Switch to Gregorian calendar" | "التبديل إلى التقويم الهجري" | "Switch to Hijri calendar">;
     readonly timeToggleLabel: _angular_core.Signal<"التبديل إلى تنسيق 24 ساعة" | "Switch to 24-hour format" | "التبديل إلى تنسيق 12 ساعة" | "Switch to 12-hour format">;
     readonly hostClasses: _angular_core.Signal<string>;
     constructor();
     private bindClock;
+    private bindWeatherAndLocation;
+    private syncGeolocation;
+    onLocationClick(): void;
+    allowLocation(): void;
+    dismissLocationPrompt(): void;
+    private requestBrowserLocation;
+    private refreshPlace;
     private tick;
     private clearClock;
     private scheduleMinuteTick;
@@ -2754,7 +2851,7 @@ declare class DgaTopBar {
     toggleTimeFormat(): void;
     safeHref(href: string | undefined | null): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaTopBar, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaTopBar, "dga-top-bar", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "timeFormat": { "alias": "timeFormat"; "required": false; "isSignal": true; }; "showDate": { "alias": "showDate"; "required": false; "isSignal": true; }; "showTime": { "alias": "showTime"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "regionLabel": { "alias": "regionLabel"; "required": false; "isSignal": true; }; "stampLabel": { "alias": "stampLabel"; "required": false; "isSignal": true; }; "tabTextLg": { "alias": "tabTextLg"; "required": false; "isSignal": true; }; "tabTextSm": { "alias": "tabTextSm"; "required": false; "isSignal": true; }; "verifyText": { "alias": "verifyText"; "required": false; "isSignal": true; }; "registrationLabel": { "alias": "registrationLabel"; "required": false; "isSignal": true; }; "registrationId": { "alias": "registrationId"; "required": false; "isSignal": true; }; "registrationHref": { "alias": "registrationHref"; "required": false; "isSignal": true; }; "notices": { "alias": "notices"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "calendar": "calendarChange"; "timeFormat": "timeFormatChange"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaTopBar, "dga-top-bar", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "timeFormat": { "alias": "timeFormat"; "required": false; "isSignal": true; }; "showDate": { "alias": "showDate"; "required": false; "isSignal": true; }; "showTime": { "alias": "showTime"; "required": false; "isSignal": true; }; "showWeather": { "alias": "showWeather"; "required": false; "isSignal": true; }; "showLocation": { "alias": "showLocation"; "required": false; "isSignal": true; }; "autoRequestLocation": { "alias": "autoRequestLocation"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "regionLabel": { "alias": "regionLabel"; "required": false; "isSignal": true; }; "stampLabel": { "alias": "stampLabel"; "required": false; "isSignal": true; }; "tabTextLg": { "alias": "tabTextLg"; "required": false; "isSignal": true; }; "tabTextSm": { "alias": "tabTextSm"; "required": false; "isSignal": true; }; "verifyText": { "alias": "verifyText"; "required": false; "isSignal": true; }; "registrationLabel": { "alias": "registrationLabel"; "required": false; "isSignal": true; }; "registrationId": { "alias": "registrationId"; "required": false; "isSignal": true; }; "registrationHref": { "alias": "registrationHref"; "required": false; "isSignal": true; }; "notices": { "alias": "notices"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "calendar": "calendarChange"; "timeFormat": "timeFormatChange"; }, never, ["*"], true, never>;
 }
 
 type DgaFooterAppearance = 'default' | 'brand';