@a.nemreen/dga-ui 0.3.3 → 0.3.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a.nemreen/dga-ui",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "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-date-picker.d.ts

@@ -5,7 +5,6 @@ import { ControlValueAccessor, DgaFormControlSize, DgaFormStatus } from '@a.nemr
 type DgaDateCalendar = 'gregorian' | 'hijri';
 /** Picker UI mode — inferred from `format` tokens when not set explicitly. */
 type DgaDatePickerMode = 'day' | 'month' | 'year';
-type DgaDateLocale = 'ar' | 'en';
 interface DgaCalendarParts {
     year: number;
     month: number;
@@ -39,7 +38,7 @@ declare function dgaParseDate(value: string, format: string, calendar: DgaDateCa
 declare function dgaSameDay(a: Date | null, b: Date | null, calendar?: DgaDateCalendar): boolean;
 declare function dgaCompareDays(a: Date | null, b: Date | null, calendar?: DgaDateCalendar): number;
 declare function dgaClampDate(date: Date, min?: Date | null, max?: Date | null, calendar?: DgaDateCalendar): Date;
-declare function dgaMonthNames(calendar: DgaDateCalendar, locale: 'ar' | 'en'): readonly string[];
+declare function dgaMonthNames(calendar: DgaDateCalendar, locale: string): readonly string[];
 /** First weekday (0=Sun) of the given calendar month. */
 declare function dgaMonthStartWeekday(year: number, month: number, calendar: DgaDateCalendar): number;
 declare function dgaTodayUtc(): Date;
@@ -66,7 +65,7 @@ declare class DgaDatePickerComponent implements ControlValueAccessor {
     readonly range: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly format: _angular_core.InputSignal<string>;
     readonly mode: _angular_core.InputSignal<DgaDatePickerMode | null>;
-    readonly locale: _angular_core.InputSignal<DgaDateLocale>;
+    readonly locale: _angular_core.InputSignal<string>;
     readonly minDate: _angular_core.InputSignal<string | Date | null>;
     readonly maxDate: _angular_core.InputSignal<string | Date | null>;
     readonly yearBefore: _angular_core.InputSignal<number>;

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

@@ -124,6 +124,23 @@ interface DgaHeaderNotificationsConfig {
     items?: DgaHeaderNotification[];
 }
 type DgaHeaderNotificationAction = 'read' | 'view' | 'dismiss' | 'select';
+/**
+ * Built-in language picker for the action whose `id` matches `actionId`
+ * (default `'lang'`). Lists registered locales with native names.
+ */
+interface DgaHeaderLocaleOption {
+    code: string;
+    nativeName: string;
+}
+interface DgaHeaderLocaleConfig {
+    actionId?: string;
+    /** Panel heading. Default: `'Language'`. */
+    title?: string;
+    closeLabel?: string;
+    /** Active locale code. */
+    current: string;
+    options: DgaHeaderLocaleOption[];
+}
 /** Link row inside the login panel footer. */
 interface DgaHeaderLoginLink {
     id?: string;
@@ -251,6 +268,11 @@ declare class DgaHeader {
      * (default `'login'`). After auth, the same action opens the user menu.
      */
     readonly login: _angular_core.InputSignal<DgaHeaderLoginConfig | null>;
+    /**
+     * When set, the header action matching `localeMenu.actionId`
+     * (default `'lang'`) opens the language picker dropdown.
+     */
+    readonly localeMenu: _angular_core.InputSignal<DgaHeaderLocaleConfig | null>;
     /** Authenticated user profile shown in the account menu. */
     readonly user: _angular_core.InputSignal<DgaHeaderUserConfig | null>;
     /** Whether the user is signed in (two-way). */
@@ -273,12 +295,15 @@ declare class DgaHeader {
     }>;
     readonly logout: _angular_core.OutputEmitterRef<void>;
     readonly userLinkClick: _angular_core.OutputEmitterRef<DgaHeaderUserMenuLink>;
+    /** Emits when a language is chosen from the locale menu. */
+    readonly localeSelect: _angular_core.OutputEmitterRef<string>;
     /** 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>;
     readonly notificationsOpen: _angular_core.WritableSignal<boolean>;
+    readonly localeMenuOpen: _angular_core.WritableSignal<boolean>;
     readonly loginOpen: _angular_core.WritableSignal<boolean>;
     readonly userMenuOpen: _angular_core.WritableSignal<boolean>;
     readonly voiceListening: _angular_core.WritableSignal<boolean>;
@@ -303,6 +328,7 @@ declare class DgaHeader {
     private readonly utilLayerRef;
     readonly searchPanelId = "dga-header-search-panel";
     readonly notificationsPanelId = "dga-header-notifications-panel";
+    readonly localePanelId = "dga-header-locale-panel";
     readonly loginPanelId = "dga-header-login-panel";
     readonly userPanelId = "dga-header-user-panel";
     readonly isPortal: _angular_core.Signal<boolean>;
@@ -312,6 +338,8 @@ declare class DgaHeader {
     readonly searchActionId: _angular_core.Signal<string>;
     readonly notificationsConfig: _angular_core.Signal<DgaHeaderNotificationsConfig | null>;
     readonly notificationsActionId: _angular_core.Signal<string>;
+    readonly localeMenuConfig: _angular_core.Signal<DgaHeaderLocaleConfig | null>;
+    readonly localeActionId: _angular_core.Signal<string>;
     readonly loginConfig: _angular_core.Signal<DgaHeaderLoginConfig | null>;
     readonly loginActionId: _angular_core.Signal<string>;
     readonly userConfig: _angular_core.Signal<DgaHeaderUserConfig | null>;
@@ -359,6 +387,7 @@ declare class DgaHeader {
     isIconOnly(action: DgaHeaderAction): boolean;
     isSearchAction(action: DgaHeaderAction): boolean;
     isNotificationsAction(action: DgaHeaderAction): boolean;
+    isLocaleAction(action: DgaHeaderAction): boolean;
     isLoginAction(action: DgaHeaderAction): boolean;
     actionTooltip(action: DgaHeaderAction): string;
     actionAriaLabel(action: DgaHeaderAction): string;
@@ -387,6 +416,9 @@ declare class DgaHeader {
     closeSearch(clearVoice?: boolean): void;
     toggleNotifications(trigger?: HTMLElement | null): void;
     closeNotifications(): void;
+    toggleLocaleMenu(trigger?: HTMLElement | null): void;
+    closeLocaleMenu(): void;
+    onLocalePick(code: string): void;
     toggleLogin(trigger?: HTMLElement | null): void;
     closeLogin(): void;
     toggleUserMenu(trigger?: HTMLElement | null): void;
@@ -420,8 +452,8 @@ declare class DgaHeader {
     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; }; "loginSubmitting": { "alias": "loginSubmitting"; "required": false; "isSignal": true; }; "loginError": { "alias": "loginError"; "required": false; "isSignal": true; }; }, { "searchQuery": "searchQueryChange"; "authenticated": "authenticatedChange"; "loginSubmitting": "loginSubmittingChange"; "loginError": "loginErrorChange"; "actionClick": "actionClick"; "searchSubmit": "searchSubmit"; "searchSuggestionSelect": "searchSuggestionSelect"; "searchVoice": "searchVoice"; "notificationAction": "notificationAction"; "loginSubmit": "loginSubmit"; "logout": "logout"; "userLinkClick": "userLinkClick"; "navLinkClick": "navLinkClick"; }, ["customLoginForm", "customLoginFooter"], ["[dgaHeaderBrand]", "*", "[dgaHeaderEnd]", "[dgaHeaderLoginBeforeForm]", "[dgaHeaderLoginForm]", "[dgaHeaderLoginAfterFields]", "[dgaHeaderLoginFooter]"], 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; }; "localeMenu": { "alias": "localeMenu"; "required": false; "isSignal": true; }; "user": { "alias": "user"; "required": false; "isSignal": true; }; "authenticated": { "alias": "authenticated"; "required": false; "isSignal": true; }; "loginSubmitting": { "alias": "loginSubmitting"; "required": false; "isSignal": true; }; "loginError": { "alias": "loginError"; "required": false; "isSignal": true; }; }, { "searchQuery": "searchQueryChange"; "authenticated": "authenticatedChange"; "loginSubmitting": "loginSubmittingChange"; "loginError": "loginErrorChange"; "actionClick": "actionClick"; "searchSubmit": "searchSubmit"; "searchSuggestionSelect": "searchSuggestionSelect"; "searchVoice": "searchVoice"; "notificationAction": "notificationAction"; "loginSubmit": "loginSubmit"; "logout": "logout"; "userLinkClick": "userLinkClick"; "localeSelect": "localeSelect"; "navLinkClick": "navLinkClick"; }, ["customLoginForm", "customLoginFooter"], ["[dgaHeaderBrand]", "*", "[dgaHeaderEnd]", "[dgaHeaderLoginBeforeForm]", "[dgaHeaderLoginForm]", "[dgaHeaderLoginAfterFields]", "[dgaHeaderLoginFooter]"], true, never>;
 }
 
 export { DgaHeader, DgaHeaderLoginAfterFields, DgaHeaderLoginBeforeForm, DgaHeaderLoginFooter, DgaHeaderLoginForm };
-export type { DgaHeaderAction, DgaHeaderAppearance, DgaHeaderLoginConfig, DgaHeaderLoginLink, DgaHeaderNotification, DgaHeaderNotificationAction, DgaHeaderNotificationTone, DgaHeaderNotificationsConfig, DgaHeaderSearchConfig, DgaHeaderSearchSuggestion, DgaHeaderUserConfig, DgaHeaderUserMenuLink, DgaMobileNavMode, DgaNavColumn, DgaNavDropdown, DgaNavDropdownLayout, DgaNavDropdownVariant, DgaNavFeatured, DgaNavItem, DgaNavLink };
+export type { DgaHeaderAction, DgaHeaderAppearance, DgaHeaderLocaleConfig, DgaHeaderLocaleOption, DgaHeaderLoginConfig, DgaHeaderLoginLink, DgaHeaderNotification, DgaHeaderNotificationAction, DgaHeaderNotificationTone, DgaHeaderNotificationsConfig, DgaHeaderSearchConfig, DgaHeaderSearchSuggestion, DgaHeaderUserConfig, DgaHeaderUserMenuLink, DgaMobileNavMode, DgaNavColumn, DgaNavDropdown, DgaNavDropdownLayout, DgaNavDropdownVariant, DgaNavFeatured, DgaNavItem, DgaNavLink };

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

@@ -761,22 +761,37 @@ declare class DgaUpload implements ControlValueAccessor {
     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; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "dragging": { "alias": "dragging"; "required": false; "isSignal": true; }; }, { "filesChange": "filesChange"; "rejected": "rejected"; "dragging": "draggingChange"; }, never, never, true, never>;
 }
 
+/** Infer UI locale from `<html lang>` (avoids importing `@a.nemreen/dga-tokens` into ng-packagr graph). */
+declare function dgaCurrentLocale(): string;
+/** True when document writing direction is RTL. */
+declare function dgaIsRtl(): boolean;
+/** @deprecated Prefer {@link dgaCurrentLocale} or {@link dgaIsRtl} depending on intent. */
+declare function dgaIsArabic(): boolean;
+/** Localized string: plain text or a map keyed by locale code. */
+type DgaLocalizedString = string | Record<string, string>;
+/** Resolve a localized map for the active locale with en/ar fallbacks. */
+declare function dgaResolveLocalized(value: DgaLocalizedString | undefined | null, locale: string, fallbackLocales?: readonly string[]): string | undefined;
+
+type DgaPhoneCountryName = DgaLocalizedString;
 interface DgaPhoneCountry {
     /** Dial code including `+`, e.g. `+966`. */
     code: string;
     /** Short label shown in the prefix select. */
     label: string;
-    /** Optional longer name for option text / search. */
-    name?: string;
+    /** Optional longer name for option text / search (`string` or locale map). */
+    name?: DgaPhoneCountryName;
 }
-/** GCC-first dial codes for contact forms. */
+/** Default dial codes — KSA only; pass extras via `[countries]` to append. */
 declare const DGA_PHONE_COUNTRIES: DgaPhoneCountry[];
 /**
  * Phone field with searchable country-code prefix select.
  * The control group is always LTR so digits and codes read correctly in RTL pages.
  */
 declare class DgaPhoneInput implements ControlValueAccessor {
+    /** Extra dial codes appended after `DGA_PHONE_COUNTRIES` (KSA). */
     readonly countries: _angular_core.InputSignal<DgaPhoneCountry[]>;
+    /** Resolves localized `name` maps on country options. */
+    readonly locale: _angular_core.InputSignal<string>;
     readonly countryCode: _angular_core.ModelSignal<string>;
     readonly nationalNumber: _angular_core.ModelSignal<string>;
     readonly controlId: _angular_core.InputSignal<string>;
@@ -791,7 +806,10 @@ declare class DgaPhoneInput implements ControlValueAccessor {
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Full E.164-ish combined value: country code + national digits. */
     readonly value: _angular_core.ModelSignal<string>;
+    /** KSA first, then `[countries]` extras; duplicate codes are skipped. */
+    readonly resolvedCountries: _angular_core.Signal<DgaPhoneCountry[]>;
     readonly countryOptions: _angular_core.Signal<DgaSelectOption[]>;
+    readonly emptyLabel: _angular_core.Signal<"لا نتائج" | "No results">;
     readonly resolvedStatus: _angular_core.Signal<_a_nemreen_dga_ui.DgaFormStatus>;
     readonly groupClasses: _angular_core.Signal<string>;
     private onChange;
@@ -804,7 +822,7 @@ declare class DgaPhoneInput implements ControlValueAccessor {
     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; }; "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>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaPhoneInput, "dga-phone-input", never, { "countries": { "alias": "countries"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "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. */
@@ -1132,13 +1150,22 @@ declare class DgaTooltip {
     readonly hideDelay: _angular_core.InputSignal<number>;
     /** Auto-dismiss after open on touch / click toggle. `0` disables. */
     readonly dismissMs: _angular_core.InputSignal<number>;
+    /**
+     * Render the tip in `document.body` with fixed coordinates so it is not clipped
+     * by overflow containers (nav rails, sidebars).
+     */
+    readonly portaled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly open: _angular_core.WritableSignal<boolean>;
+    readonly portaledStyle: _angular_core.WritableSignal<Record<string, string>>;
     readonly tipId: string;
+    private readonly tipEl;
+    private readonly injector;
     private showTimer;
     private hideTimer;
     private dismissTimer;
     private touchPinned;
     constructor();
+    private readonly onResize;
     /** Capture-phase so overflow containers also dismiss the tip. */
     private readonly onScrollCapture;
     onDocPointer(event: PointerEvent): void;
@@ -1153,6 +1180,7 @@ declare class DgaTooltip {
     hideSoon(): void;
     show(): void;
     hide(): void;
+    private syncPortaledTip;
     toggle(): void;
     private toggleTouch;
     private scheduleDismiss;
@@ -1162,7 +1190,7 @@ declare class DgaTooltip {
     private clearDismiss;
     private clearTimers;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaTooltip, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaTooltip, "dga-tooltip", never, { "text": { "alias": "text"; "required": true; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "showIcon": { "alias": "showIcon"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "showDelay": { "alias": "showDelay"; "required": false; "isSignal": true; }; "hideDelay": { "alias": "hideDelay"; "required": false; "isSignal": true; }; "dismissMs": { "alias": "dismissMs"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaTooltip, "dga-tooltip", never, { "text": { "alias": "text"; "required": true; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "showIcon": { "alias": "showIcon"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "showDelay": { "alias": "showDelay"; "required": false; "isSignal": true; }; "hideDelay": { "alias": "hideDelay"; "required": false; "isSignal": true; }; "dismissMs": { "alias": "dismissMs"; "required": false; "isSignal": true; }; "portaled": { "alias": "portaled"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 interface DgaMenuItem {
@@ -2303,6 +2331,10 @@ declare class DgaDualNav {
     readonly closePanelLabel: _angular_core.InputSignal<string>;
     readonly select: _angular_core.OutputEmitterRef<DgaSideNavItem>;
     readonly activeSection: _angular_core.Signal<DgaDualNavSection>;
+    /** Tooltips open away from the secondary panel (outer rail edge). */
+    readonly railTooltipPlacement: _angular_core.Signal<"start" | "bottom">;
+    /** Hide rail tooltips while the secondary panel is open (labels already visible). */
+    railTooltipDisabled(): boolean;
     constructor();
     selectSection(id: string): void;
     onSelect(item: DgaSideNavItem): void;
@@ -2648,14 +2680,20 @@ declare class DgaTopBar implements OnInit {
     readonly timeFormat: _angular_core.ModelSignal<DgaTimeFormat>;
     readonly showDate: _angular_core.InputSignal<boolean>;
     readonly showTime: _angular_core.InputSignal<boolean>;
-    /** `ar` → Arabic labels; `en` → English. */
-    readonly locale: _angular_core.InputSignal<"ar" | "en">;
-    readonly regionLabel: _angular_core.InputSignal<string>;
-    readonly stampLabel: _angular_core.InputSignal<string>;
-    readonly tabTextLg: _angular_core.InputSignal<string>;
-    readonly tabTextSm: _angular_core.InputSignal<string>;
-    readonly verifyText: _angular_core.InputSignal<string>;
-    readonly registrationLabel: _angular_core.InputSignal<string>;
+    /** 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`. */
+    readonly regionLabel: _angular_core.InputSignal<string | undefined>;
+    /** Overrides the locale-aware default stamp panel `aria-label`. */
+    readonly stampLabel: _angular_core.InputSignal<string | undefined>;
+    /** Overrides the locale-aware default desktop stamp sentence. */
+    readonly tabTextLg: _angular_core.InputSignal<string | undefined>;
+    /** Overrides the locale-aware default compact stamp sentence. */
+    readonly tabTextSm: _angular_core.InputSignal<string | undefined>;
+    /** Overrides the locale-aware default "How to verify?" link. */
+    readonly verifyText: _angular_core.InputSignal<string | undefined>;
+    /** Overrides the locale-aware default registration caption. */
+    readonly registrationLabel: _angular_core.InputSignal<string | undefined>;
     /** DGA platform registration / license number shown in the expanded stamp. */
     readonly registrationId: _angular_core.InputSignal<string>;
     /**
@@ -2663,8 +2701,17 @@ declare class DgaTopBar implements OnInit {
      * @example https://raqmi.dga.gov.sa/platforms/platforms/…/platform-license
      */
     readonly registrationHref: _angular_core.InputSignal<string>;
-    readonly notices: _angular_core.InputSignal<DgaStampNotice[]>;
+    /** Overrides the locale-aware default gov.sa / HTTPS notices. */
+    readonly notices: _angular_core.InputSignal<DgaStampNotice[] | undefined>;
     private readonly now;
+    private readonly defaults;
+    readonly resolvedRegionLabel: _angular_core.Signal<string>;
+    readonly resolvedStampLabel: _angular_core.Signal<string>;
+    readonly resolvedTabTextLg: _angular_core.Signal<string>;
+    readonly resolvedTabTextSm: _angular_core.Signal<string>;
+    readonly resolvedVerifyText: _angular_core.Signal<string>;
+    readonly resolvedRegistrationLabel: _angular_core.Signal<string>;
+    readonly resolvedNotices: _angular_core.Signal<DgaStampNotice[]>;
     readonly dateLabel: _angular_core.Signal<string>;
     readonly timeLabel: _angular_core.Signal<string>;
     readonly calendarToggleLabel: _angular_core.Signal<"التبديل إلى التقويم الميلادي" | "Switch to Gregorian calendar" | "التبديل إلى التقويم الهجري" | "Switch to Hijri calendar">;
@@ -3581,6 +3628,8 @@ declare class DgaChart {
     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`. */
@@ -3656,12 +3705,11 @@ declare class DgaChart {
     categoryAriaLabel(index: number): string;
     readonly categoryTooltip: _angular_core.Signal<DgaChartTooltip | null>;
     readonly sliceTooltip: _angular_core.Signal<DgaChartTooltip | null>;
-    tooltipWidth(tip: DgaChartTooltip): number;
-    tooltipHeight(tip: DgaChartTooltip): number;
-    tooltipX(tip: DgaChartTooltip): number;
-    tooltipY(tip: DgaChartTooltip): number;
+    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; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaChart, "dga-chart", never, { "type": { "alias": "type"; "required": false; "isSignal": true; }; "series": { "alias": "series"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "datasets": { "alias": "datasets"; "required": false; "isSignal": true; }; "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "grid": { "alias": "grid"; "required": false; "isSignal": true; }; "stacked": { "alias": "stacked"; "required": false; "isSignal": true; }; "smooth": { "alias": "smooth"; "required": false; "isSignal": true; }; "area": { "alias": "area"; "required": false; "isSignal": true; }; "dots": { "alias": "dots"; "required": false; "isSignal": true; }; "colors": { "alias": "colors"; "required": false; "isSignal": true; }; "tooltipValueLabel": { "alias": "tooltipValueLabel"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 interface DgaSaudiCity {
@@ -3676,7 +3724,7 @@ 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?: 'ar' | 'en', cities?: readonly DgaSaudiCity[]): {
+declare function dgaSaudiCityOptions(locale?: string, cities?: readonly DgaSaudiCity[]): {
     label: string;
     value: string;
 }[];
@@ -3693,8 +3741,5 @@ declare function dgaSafeCssColor(value: string | null | undefined, fallback?: st
 /** Join truthy class names. */
 declare function dgaCx(...parts: Array<string | false | null | undefined>): string;
 
-/** Infer UI locale from `<html lang>` (avoids importing `@a.nemreen/dga-tokens` into ng-packagr graph). */
-declare function dgaIsArabic(): boolean;
-
-export { DGA_ICON_NAMES, DGA_ICON_SVG, DGA_LOGICAL_ICON_NAMES, DGA_PAGE_TRANSITION_NAMES, DGA_PHONE_COUNTRIES, DGA_RIYAL_SVG_PATH, DGA_RIYAL_VIEWBOX, DGA_SAUDI_CITIES, DgaAccordion, DgaAccordionItem, DgaAlert, DgaAnnouncementBar, DgaAppShell, DgaAuthCard, DgaAutocomplete, DgaAvatar, DgaBadge, DgaBreadcrumb, DgaButton, DgaCard, DgaCardMedia, DgaCarousel, DgaCarouselSlideDirective, DgaChart, DgaChatbot, DgaCheckbox, DgaChip, DgaChipInput, DgaClamp, DgaCode, DgaCommand, DgaContentSwitcher, DgaContentSwitcherPanel, DgaContextMenu, DgaContextMenuTrigger, DgaCopy, DgaDescriptionList, DgaDialog, DgaDivider, DgaDrawer, DgaDualNav, DgaEmpty, DgaExpandable, DgaExport, DgaExportToolbar, DgaFeedback, DgaField, DgaFilterBar, DgaFooter, DgaFormControl, DgaFormEnd, DgaFormStart, DgaGrid, DgaHero, DgaIcon, DgaIconBadge, DgaIconFontService, DgaImagePopup, DgaInfoList, DgaInput, DgaKbd, DgaKbdGroup, DgaLabel, DgaLink, DgaList, DgaLogoTile, DgaMenu, DgaMetric, DgaModal, DgaMultiselect, DgaNativeSelect, DgaNavRail, DgaNumber, DgaNumberInput, DgaOtp, DgaPageFeedback, DgaPageHero, DgaPageTransition, DgaPagination, DgaPersona, DgaPhoneInput, DgaPreloader, DgaProgress, DgaQuote, DgaRadio, DgaRating, DgaRiyal, DgaScrollTop, DgaSection, DgaSelect, DgaShare, DgaSideInfo, DgaSideNav, DgaSkeleton, DgaSkipLink, DgaSlider, DgaSpinner, DgaStepper, DgaSwitch, DgaTab, DgaTable, DgaTabs, DgaTimePicker, DgaTimeline, DgaToast, DgaToastOutlet, DgaToastService, DgaToc, DgaToolbar, DgaTooltip, DgaTopBar, DgaTour, DgaUpload, DgaVideoPlayer, DgaWriting, dgaCx, dgaFormStatusFromInvalid, dgaGroupSaudiCitiesByRegion, dgaIsArabic, dgaNormalizeTime, dgaProvideValueAccessor, dgaResolveAppHref, dgaResolveVideoSource, dgaSafeCssColor, dgaSafeHref, dgaSaudiCityOptions };
-export type { DgaAccordionSection, DgaAlertDisplay, DgaAlertVariant, DgaAnnouncementActionVariant, DgaAnnouncementAlign, DgaAnnouncementDensity, DgaAnnouncementElevation, DgaAnnouncementPersist, DgaAnnouncementTone, DgaAppShellAppearance, DgaAutocompleteOption, DgaAvatarSize, DgaBadgeSize, DgaBadgeVariant, DgaBreadcrumbItem, DgaBreadcrumbSeparator, DgaButtonSize, DgaButtonVariant, DgaCalendar, DgaCardActionsAlign, DgaCardAppearance, DgaCardBadge, DgaCardBorder, DgaCardPadding, DgaCardShadow, DgaCarouselSlide, DgaChartDataset, DgaChartPoint, DgaChartType, DgaChatbotAnimation, DgaChatbotFabTone, DgaChatbotMessage, DgaChatbotPosition, DgaChatbotSize, DgaCheckboxSize, DgaChipVariant, DgaCommandAppearance, DgaCommandGroup, DgaCommandItem, DgaContentSwitcherItem, DgaContextMenuItem, DgaContextMenuItemType, DgaCurrency, DgaDescriptionItem, DgaDescriptionLayout, DgaDialogSize, DgaDividerOrientation, DgaDrawerSide, DgaDualNavCategory, DgaDualNavSection, DgaEmptyAppearance, DgaExportColumn, DgaExportData, DgaExportScope, DgaFeedbackSubmit, DgaFilterItem, DgaFooterAppearance, DgaFooterColumn, DgaFooterIconGroup, DgaFooterIconLink, DgaFooterLink, DgaFooterLogo, DgaFormControlSize, DgaFormStatus, DgaGridCols, DgaGridGap, DgaHeroAppearance, DgaHeroImageMask, DgaHeroOverlayTone, DgaHeroSlide, DgaHeroTransition, DgaIconBadgeAppearance, DgaIconBadgeSize, DgaIconName, DgaIconSize, DgaIconTone, DgaImagePopupAnimation, DgaImagePopupImage, DgaImagePopupImageTransition, DgaImagePopupSource, DgaInfoListItem, DgaInputSize, DgaLinkVariant, DgaMenuItem, DgaMetricAppearance, DgaMetricTrend, DgaModalAnimation, DgaModalSize, DgaMultiselectOption, DgaNativeSelectSize, DgaNavRailActiveStyle, DgaNavRailAppearance, DgaNavRailItem, DgaNavRailPosition, DgaNavRailSize, DgaPageFeedbackAgreementLink, DgaPageFeedbackAnswer, DgaPageFeedbackOption, DgaPageFeedbackPhase, DgaPageFeedbackSubmit, DgaPageHeroTone, DgaPageTransitionName, 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, DgaToastAnimation, DgaToastLocation, DgaToastRequest, DgaToastShowOptions, DgaToastVariant, DgaTocItem, DgaTooltipPlacement, DgaTooltipVariant, DgaTourPersist, DgaTourPlacement, DgaTourStep, DgaUploadAppearance, DgaUploadFile, DgaUploadRejectReason, DgaUploadRejection, DgaVideoProvider, DgaVideoRatio, DgaVideoSourceInfo, DgaWritingEffect };
+export { DGA_ICON_NAMES, DGA_ICON_SVG, DGA_LOGICAL_ICON_NAMES, DGA_PAGE_TRANSITION_NAMES, DGA_PHONE_COUNTRIES, DGA_RIYAL_SVG_PATH, DGA_RIYAL_VIEWBOX, DGA_SAUDI_CITIES, DgaAccordion, DgaAccordionItem, DgaAlert, DgaAnnouncementBar, DgaAppShell, DgaAuthCard, DgaAutocomplete, DgaAvatar, DgaBadge, DgaBreadcrumb, DgaButton, DgaCard, DgaCardMedia, DgaCarousel, DgaCarouselSlideDirective, DgaChart, DgaChatbot, DgaCheckbox, DgaChip, DgaChipInput, DgaClamp, DgaCode, DgaCommand, DgaContentSwitcher, DgaContentSwitcherPanel, DgaContextMenu, DgaContextMenuTrigger, DgaCopy, DgaDescriptionList, DgaDialog, DgaDivider, DgaDrawer, DgaDualNav, DgaEmpty, DgaExpandable, DgaExport, DgaExportToolbar, DgaFeedback, DgaField, DgaFilterBar, DgaFooter, DgaFormControl, DgaFormEnd, DgaFormStart, DgaGrid, DgaHero, DgaIcon, DgaIconBadge, DgaIconFontService, DgaImagePopup, DgaInfoList, DgaInput, DgaKbd, DgaKbdGroup, DgaLabel, DgaLink, DgaList, DgaLogoTile, DgaMenu, DgaMetric, DgaModal, DgaMultiselect, DgaNativeSelect, DgaNavRail, DgaNumber, DgaNumberInput, DgaOtp, DgaPageFeedback, DgaPageHero, DgaPageTransition, DgaPagination, DgaPersona, DgaPhoneInput, DgaPreloader, DgaProgress, DgaQuote, DgaRadio, DgaRating, DgaRiyal, DgaScrollTop, DgaSection, DgaSelect, DgaShare, DgaSideInfo, DgaSideNav, DgaSkeleton, DgaSkipLink, DgaSlider, DgaSpinner, DgaStepper, DgaSwitch, DgaTab, DgaTable, DgaTabs, DgaTimePicker, DgaTimeline, DgaToast, DgaToastOutlet, DgaToastService, DgaToc, DgaToolbar, DgaTooltip, DgaTopBar, DgaTour, DgaUpload, DgaVideoPlayer, DgaWriting, dgaCurrentLocale, dgaCx, dgaFormStatusFromInvalid, dgaGroupSaudiCitiesByRegion, dgaIsArabic, dgaIsRtl, dgaNormalizeTime, dgaProvideValueAccessor, dgaResolveAppHref, dgaResolveLocalized, dgaResolveVideoSource, dgaSafeCssColor, dgaSafeHref, dgaSaudiCityOptions };
+export type { DgaAccordionSection, DgaAlertDisplay, DgaAlertVariant, DgaAnnouncementActionVariant, DgaAnnouncementAlign, DgaAnnouncementDensity, DgaAnnouncementElevation, DgaAnnouncementPersist, DgaAnnouncementTone, DgaAppShellAppearance, DgaAutocompleteOption, DgaAvatarSize, DgaBadgeSize, DgaBadgeVariant, DgaBreadcrumbItem, DgaBreadcrumbSeparator, DgaButtonSize, DgaButtonVariant, DgaCalendar, DgaCardActionsAlign, DgaCardAppearance, DgaCardBadge, DgaCardBorder, DgaCardPadding, DgaCardShadow, DgaCarouselSlide, DgaChartDataset, DgaChartPoint, DgaChartType, DgaChatbotAnimation, DgaChatbotFabTone, DgaChatbotMessage, DgaChatbotPosition, DgaChatbotSize, DgaCheckboxSize, DgaChipVariant, DgaCommandAppearance, DgaCommandGroup, DgaCommandItem, DgaContentSwitcherItem, DgaContextMenuItem, DgaContextMenuItemType, DgaCurrency, DgaDescriptionItem, DgaDescriptionLayout, DgaDialogSize, DgaDividerOrientation, DgaDrawerSide, DgaDualNavCategory, DgaDualNavSection, DgaEmptyAppearance, DgaExportColumn, DgaExportData, DgaExportScope, DgaFeedbackSubmit, DgaFilterItem, DgaFooterAppearance, DgaFooterColumn, DgaFooterIconGroup, DgaFooterIconLink, DgaFooterLink, DgaFooterLogo, DgaFormControlSize, DgaFormStatus, DgaGridCols, DgaGridGap, DgaHeroAppearance, DgaHeroImageMask, DgaHeroOverlayTone, DgaHeroSlide, DgaHeroTransition, DgaIconBadgeAppearance, DgaIconBadgeSize, DgaIconName, DgaIconSize, DgaIconTone, DgaImagePopupAnimation, DgaImagePopupImage, DgaImagePopupImageTransition, DgaImagePopupSource, DgaInfoListItem, DgaInputSize, DgaLinkVariant, DgaLocalizedString, DgaMenuItem, DgaMetricAppearance, DgaMetricTrend, DgaModalAnimation, DgaModalSize, DgaMultiselectOption, DgaNativeSelectSize, DgaNavRailActiveStyle, DgaNavRailAppearance, DgaNavRailItem, DgaNavRailPosition, DgaNavRailSize, DgaPageFeedbackAgreementLink, DgaPageFeedbackAnswer, DgaPageFeedbackOption, DgaPageFeedbackPhase, DgaPageFeedbackSubmit, DgaPageHeroTone, DgaPageTransitionName, DgaPhoneCountry, DgaPhoneCountryName, DgaPreloaderPersist, DgaProgressAppearance, DgaProgressSize, DgaProgressTone, DgaRadioSize, DgaRatingSize, DgaRiyalAppearance, DgaRiyalSize, DgaRiyalTone, DgaSaudiCity, DgaScrollTopPosition, DgaSectionTone, DgaSectionWidth, DgaSelectOpenMode, DgaSelectOption, DgaSelectSize, DgaShareAppearance, DgaSideInfoItem, DgaSideNavGroup, DgaSideNavItem, DgaSkeletonAnimation, DgaSkeletonRadius, DgaSkeletonShape, DgaSkeletonSize, DgaSortDir, DgaSpinnerSize, DgaSpinnerTone, DgaStampNotice, DgaStep, DgaStepStatus, DgaSwitchSize, DgaTabItem, DgaTableColumn, DgaTableDensity, DgaTimeFormat, DgaTimePickerFormat, DgaTimePickerSize, DgaTimelineItem, DgaToastAnimation, DgaToastLocation, DgaToastRequest, DgaToastShowOptions, DgaToastVariant, DgaTocItem, DgaTooltipPlacement, DgaTooltipVariant, DgaTourPersist, DgaTourPlacement, DgaTourStep, DgaUploadAppearance, DgaUploadFile, DgaUploadRejectReason, DgaUploadRejection, DgaVideoProvider, DgaVideoRatio, DgaVideoSourceInfo, DgaWritingEffect };