@a.nemreen/dga-ui 0.2.6 → 0.2.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a.nemreen/dga-ui",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "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

@@ -133,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>;
@@ -809,7 +809,7 @@ declare class DgaDatePickerComponent implements ControlValueAccessor {
     readonly viewParts: _angular_core.WritableSignal<DgaCalendarParts>;
     readonly draftStart: _angular_core.WritableSignal<Date | null>;
     readonly draftEnd: _angular_core.WritableSignal<Date | null>;
-    readonly rangePickPhase: _angular_core.WritableSignal<"end" | "start">;
+    readonly rangePickPhase: _angular_core.WritableSignal<"start" | "end">;
     readonly typedValue: _angular_core.WritableSignal<string | null>;
     readonly effectiveStatus: _angular_core.Signal<DgaFormStatus>;
     readonly panelMode: _angular_core.Signal<DgaDatePickerMode>;
@@ -1038,7 +1038,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<"warning" | "error" | "success" | "muted" | "current">;
+    readonly iconTone: _angular_core.Signal<"error" | "success" | "warning" | "current" | "muted">;
     constructor();
     ngOnDestroy(): void;
     dismiss(): void;
@@ -1337,7 +1337,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<"warning" | "error" | "success" | "muted" | "current">;
+    readonly iconTone: _angular_core.Signal<"error" | "success" | "warning" | "current" | "muted">;
     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>;
 }
@@ -2113,11 +2113,13 @@ interface DgaBreadcrumbItem {
 }
 type DgaBreadcrumbSeparator = 'chevron' | 'slash';
 declare class DgaBreadcrumb {
+    private readonly baseHref;
     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>;
+    appHref(href: string | undefined | null): string;
     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; }; }, { "itemClick": "itemClick"; }, never, never, true, never>;
@@ -2233,7 +2235,9 @@ declare class DgaStepper {
     readonly label: _angular_core.InputSignal<string>;
     stepStatus(index: number): DgaStepStatus;
     stepButtonClasses(index: number): string;
+    labelClasses(index: number): string;
     indicatorClasses(index: number): string;
+    railTone(index: number): string;
     go(index: number): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaStepper, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaStepper, "dga-stepper", never, { "steps": { "alias": "steps"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "active": "activeChange"; }, never, never, true, never>;
@@ -2277,8 +2281,8 @@ interface DgaSideNavGroup {
 }
 /**
  * Side navigation with optional groups and nested children.
- * Below `lg`: horizontal scroll rail (top-level only).
- * From `lg`: vertical sidebar (optional collapse to icons).
+ * `layout="auto"` (default): horizontal scroll rail below `lg`, vertical sidebar from `lg`.
+ * `layout="vertical"`: always vertical (drawers / overlays).
  */
 declare class DgaSideNav {
     /** Flat item list (backward compatible). Ignored when `groups` is set. */
@@ -2287,6 +2291,10 @@ declare class DgaSideNav {
     readonly groups: _angular_core.InputSignal<DgaSideNavGroup[]>;
     readonly active: _angular_core.ModelSignal<string>;
     readonly collapsible: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * `auto` = horizontal chips below lg; `vertical` = always sidebar (use in drawers).
+     */
+    readonly layout: _angular_core.InputSignal<"auto" | "vertical">;
     readonly label: _angular_core.InputSignal<string>;
     readonly toggleLabel: _angular_core.InputSignal<string>;
     readonly select: _angular_core.OutputEmitterRef<DgaSideNavItem>;
@@ -2305,7 +2313,7 @@ declare class DgaSideNav {
     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; }; "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>;
+    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; }; "layout": { "alias": "layout"; "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. */
@@ -2332,6 +2340,10 @@ declare class DgaDualNav {
     readonly active: _angular_core.ModelSignal<string>;
     readonly activeSectionId: _angular_core.ModelSignal<string>;
     readonly panelOpen: _angular_core.ModelSignal<boolean>;
+    /**
+     * `rail` = desktop dual columns; `stack` = section chips + panel below (drawers / mobile).
+     */
+    readonly layout: _angular_core.InputSignal<"rail" | "stack">;
     readonly railLabel: _angular_core.InputSignal<string>;
     readonly panelEyebrow: _angular_core.InputSignal<string>;
     readonly closePanelLabel: _angular_core.InputSignal<string>;
@@ -2342,7 +2354,7 @@ declare class DgaDualNav {
     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>;
+    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; }; "layout": { "alias": "layout"; "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';
@@ -2382,9 +2394,9 @@ declare class DgaNavRail {
     readonly smoothScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly select: _angular_core.OutputEmitterRef<DgaNavRailItem>;
     readonly expandChange: _angular_core.OutputEmitterRef<boolean>;
-    readonly edgeAttr: _angular_core.Signal<"end" | "start" | "left" | "right" | null>;
+    readonly edgeAttr: _angular_core.Signal<"left" | "right" | "start" | "end" | null>;
     readonly offsetCss: _angular_core.Signal<string>;
-    readonly tooltipPlacement: _angular_core.Signal<"end" | "start">;
+    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">;
@@ -2814,6 +2826,7 @@ interface DgaHeaderUserConfig {
 }
 declare class DgaHeader {
     private readonly host;
+    private readonly baseHref;
     private closeTimer;
     private dropdownSyncFrame;
     private lastDropdownStyleKey;
@@ -2878,7 +2891,7 @@ 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 navLinkClick: _angular_core.OutputEmitterRef<DgaNavItem | DgaNavLink>;
     readonly mobileOpen: _angular_core.WritableSignal<boolean>;
     readonly openDropdown: _angular_core.WritableSignal<number | null>;
     readonly searchOpen: _angular_core.WritableSignal<boolean>;
@@ -2904,6 +2917,8 @@ declare class DgaHeader {
     readonly loginPanelId = "dga-header-login-panel";
     readonly userPanelId = "dga-header-user-panel";
     readonly isPortal: _angular_core.Signal<boolean>;
+    /** Resolve root-relative hrefs against the app base (`/dga/` on cPanel). */
+    appHref(href: string | undefined | null): string;
     readonly searchConfig: _angular_core.Signal<DgaHeaderSearchConfig | null>;
     readonly searchActionId: _angular_core.Signal<string>;
     readonly notificationsConfig: _angular_core.Signal<DgaHeaderNotificationsConfig | null>;
@@ -3099,6 +3114,7 @@ interface DgaFooterLogo {
     external?: boolean;
 }
 declare class DgaFooter {
+    private readonly baseHref;
     readonly brand: _angular_core.InputSignal<string>;
     readonly title: _angular_core.InputSignal<string>;
     readonly links: _angular_core.InputSignal<DgaFooterLink[]>;
@@ -3115,6 +3131,7 @@ declare class DgaFooter {
     readonly appearance: _angular_core.InputSignal<DgaFooterAppearance>;
     readonly navLabel: _angular_core.InputSignal<string>;
     readonly ariaLabel: _angular_core.InputSignal<string>;
+    appHref(href: string | undefined | null): string;
     readonly showBottom: _angular_core.Signal<boolean>;
     readonly hostClass: _angular_core.Signal<string>;
     readonly headingClass: _angular_core.Signal<string>;
@@ -3317,19 +3334,22 @@ declare class DgaAnnouncementBar {
     readonly persistKey: _angular_core.InputSignal<string>;
     readonly dismissedChange: _angular_core.OutputEmitterRef<boolean>;
     readonly closed: _angular_core.OutputEmitterRef<void>;
+    /** Fired when the action control has no `actionHref` (button / chip / link-as-button). */
+    readonly action: _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;
+    onAction(): 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>;
+    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"; "action": "action"; }, never, ["*"], true, never>;
 }
 
 /**