@a.nemreen/dga-ui 0.2.0

package/lib/shell/header/dga-header.d.ts

@@ -0,0 +1,343 @@
+import { type DgaBadgeVariant } from '../../primitives/badge/dga-badge';
+import { type DgaIconName } from '../../primitives/icon/dga-icon';
+import * as i0 from "@angular/core";
+export type DgaHeaderAppearance = 'default' | 'portal';
+/**
+ * Mobile / narrow navigation chrome (portal header, `md` and below):
+ * - `sheet` - side drawer from the inline-end (burger) edge
+ * - `fullscreen` - full-viewport overlay panel
+ * - `push` - panel expands under the header bar (inline dropdown)
+ */
+export type DgaMobileNavMode = 'sheet' | 'fullscreen' | 'push';
+/** Panel chrome: compact under trigger, full-bleed mega, or mega + featured lead. */
+export type DgaNavDropdownVariant = 'menu' | 'mega' | 'featured';
+/** How links are arranged inside the panel. */
+export type DgaNavDropdownLayout = 'list' | 'columns' | 'rows';
+export interface DgaNavLink {
+    label: string;
+    href?: string;
+    description?: string;
+    current?: boolean;
+}
+export interface DgaNavColumn {
+    title?: string;
+    links: DgaNavLink[];
+}
+/** Lead / promo block for `variant: 'featured'`. */
+export interface DgaNavFeatured {
+    title: string;
+    description?: string;
+    href?: string;
+    cta?: string;
+    imageUrl?: string;
+}
+export interface DgaNavDropdown {
+    /**
+     * Panel width/placement:
+     * - `menu` - compact panel anchored under the trigger (default for simple lists)
+     * - `mega` - full-width under the header
+     * - `featured` - full-width mega with a lead promo column
+     */
+    variant?: DgaNavDropdownVariant;
+    /** Inner arrangement: `list` | `columns` | `rows`. */
+    layout?: DgaNavDropdownLayout;
+    columns?: DgaNavColumn[];
+    links?: DgaNavLink[];
+    featured?: DgaNavFeatured;
+}
+export interface DgaNavItem {
+    label: string;
+    href?: string;
+    current?: boolean;
+    dropdown?: DgaNavDropdown;
+}
+export interface DgaHeaderAction {
+    id: string;
+    label: string;
+    icon?: DgaIconName;
+    href?: string;
+    badge?: number;
+    iconOnly?: boolean;
+}
+/** Suggestion chip shown under the header search field. */
+export interface DgaHeaderSearchSuggestion {
+    label: string;
+    /** Value written into the query (defaults to `label`). */
+    value?: string;
+    icon?: DgaIconName;
+}
+/**
+ * Built-in header search panel (opens from the action whose `id` matches `actionId`).
+ * Pass this to `[search]` to enable the dropdown search experience.
+ */
+export interface DgaHeaderSearchConfig {
+    /** Action id that toggles the panel. Default: `'search'`. */
+    actionId?: string;
+    placeholder?: string;
+    submitLabel?: string;
+    suggestionsLabel?: string;
+    clearLabel?: string;
+    voiceLabel?: string;
+    /** Show microphone control (uses Web Speech API when available). Default: true. */
+    voice?: boolean;
+    suggestions?: DgaHeaderSearchSuggestion[];
+    /**
+     * Optional results URL. On submit, navigates to
+     * `{resultsHref}?{queryParam}={query}` when set.
+     */
+    resultsHref?: string;
+    /** Query string key. Default: `'q'`. */
+    queryParam?: string;
+}
+export type DgaHeaderNotificationTone = DgaBadgeVariant;
+/** Single item in the header notifications panel. */
+export interface DgaHeaderNotification {
+    id: string;
+    title: string;
+    message: string;
+    statusLabel?: string;
+    tone?: DgaHeaderNotificationTone;
+    icon?: DgaIconName;
+    href?: string;
+    read?: boolean;
+}
+/**
+ * Built-in notifications dropdown for the action whose `id` matches `actionId`
+ * (default `'notifications'`).
+ */
+export interface DgaHeaderNotificationsConfig {
+    actionId?: string;
+    /** Panel heading. Default: `'Notifications'`. */
+    title?: string;
+    emptyLabel?: string;
+    viewAllLabel?: string;
+    viewAllHref?: string;
+    markReadLabel?: string;
+    markAllReadLabel?: string;
+    viewLabel?: string;
+    dismissLabel?: string;
+    closeLabel?: string;
+    items?: DgaHeaderNotification[];
+}
+export type DgaHeaderNotificationAction = 'read' | 'view' | 'dismiss' | 'select';
+/** Guest login form opened from the login action. */
+export interface DgaHeaderLoginConfig {
+    actionId?: string;
+    title?: string;
+    description?: string;
+    emailLabel?: string;
+    emailPlaceholder?: string;
+    emailHint?: string;
+    passwordLabel?: string;
+    passwordPlaceholder?: string;
+    passwordHint?: string;
+    submitLabel?: string;
+    cancelLabel?: string;
+    closeLabel?: string;
+    forgotPasswordLabel?: string;
+    forgotPasswordHref?: string;
+    showPasswordLabel?: string;
+    hidePasswordLabel?: string;
+}
+export interface DgaHeaderUserMenuLink {
+    id: string;
+    label: string;
+    href?: string;
+    icon?: DgaIconName;
+    danger?: boolean;
+}
+/** Authenticated user menu shown after login (same action id as login). */
+export interface DgaHeaderUserConfig {
+    name: string;
+    role?: string;
+    email?: string;
+    avatarSrc?: string;
+    links?: DgaHeaderUserMenuLink[];
+}
+export declare class DgaHeader {
+    private readonly host;
+    private closeTimer;
+    private dropdownSyncFrame;
+    private lastDropdownStyleKey;
+    readonly collapseId = "dga-nav-collapse";
+    readonly dropLink: string;
+    readonly dropTile: string;
+    readonly mobileLink: string;
+    readonly brand: import("@angular/core").InputSignal<string>;
+    readonly brandSlogan: import("@angular/core").InputSignal<string>;
+    readonly brandLogo: import("@angular/core").InputSignal<string>;
+    readonly brandLogoAlt: import("@angular/core").InputSignal<string>;
+    /** When true and no `brandLogo`, portal headers show a home-icon placeholder beside the brand text. */
+    readonly brandPlaceholder: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    readonly brandHref: import("@angular/core").InputSignal<string>;
+    readonly navLabel: import("@angular/core").InputSignal<string>;
+    readonly menuToggleLabel: import("@angular/core").InputSignal<string>;
+    readonly menuCloseLabel: import("@angular/core").InputSignal<string>;
+    readonly appearance: import("@angular/core").InputSignal<DgaHeaderAppearance>;
+    /**
+     * Portal mobile navigation layout. Ignored for `appearance="default"`.
+     * - `sheet` - side drawer (narrow, page peeks beside)
+     * - `fullscreen` - covers the whole screen with its own close control
+     * - `push` - accordion panel under the header
+     */
+    readonly mobileNav: import("@angular/core").InputSignal<DgaMobileNavMode>;
+    readonly sticky: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    readonly items: import("@angular/core").InputSignal<DgaNavItem[]>;
+    readonly actions: import("@angular/core").InputSignal<DgaHeaderAction[]>;
+    /**
+     * When set, the header action matching `search.actionId` (default `'search'`)
+     * opens a full-width search panel with suggestions instead of a no-op click.
+     */
+    readonly search: import("@angular/core").InputSignal<DgaHeaderSearchConfig | null>;
+    /** Bound query for the header search panel. */
+    readonly searchQuery: import("@angular/core").ModelSignal<string>;
+    /**
+     * When set, the header action matching `notifications.actionId`
+     * (default `'notifications'`) opens the notifications dropdown.
+     */
+    readonly notifications: import("@angular/core").InputSignal<DgaHeaderNotificationsConfig | null>;
+    /**
+     * Guest login panel config. Opens from the action matching `login.actionId`
+     * (default `'login'`). After auth, the same action opens the user menu.
+     */
+    readonly login: import("@angular/core").InputSignal<DgaHeaderLoginConfig | null>;
+    /** Authenticated user profile shown in the account menu. */
+    readonly user: import("@angular/core").InputSignal<DgaHeaderUserConfig | null>;
+    /** Whether the user is signed in (two-way). */
+    readonly authenticated: import("@angular/core").ModelSignal<boolean>;
+    readonly actionClick: import("@angular/core").OutputEmitterRef<DgaHeaderAction>;
+    readonly searchSubmit: import("@angular/core").OutputEmitterRef<string>;
+    readonly searchSuggestionSelect: import("@angular/core").OutputEmitterRef<DgaHeaderSearchSuggestion>;
+    readonly searchVoice: import("@angular/core").OutputEmitterRef<void>;
+    readonly notificationAction: import("@angular/core").OutputEmitterRef<{
+        item: DgaHeaderNotification;
+        action: DgaHeaderNotificationAction;
+    }>;
+    readonly loginSubmit: import("@angular/core").OutputEmitterRef<{
+        email: string;
+        password: string;
+    }>;
+    readonly logout: import("@angular/core").OutputEmitterRef<void>;
+    readonly userLinkClick: import("@angular/core").OutputEmitterRef<DgaHeaderUserMenuLink>;
+    readonly mobileOpen: import("@angular/core").WritableSignal<boolean>;
+    readonly openDropdown: import("@angular/core").WritableSignal<number | null>;
+    readonly searchOpen: import("@angular/core").WritableSignal<boolean>;
+    readonly notificationsOpen: import("@angular/core").WritableSignal<boolean>;
+    readonly loginOpen: import("@angular/core").WritableSignal<boolean>;
+    readonly userMenuOpen: import("@angular/core").WritableSignal<boolean>;
+    readonly voiceListening: import("@angular/core").WritableSignal<boolean>;
+    readonly expandedNotificationId: import("@angular/core").WritableSignal<string | null>;
+    readonly loginEmail: import("@angular/core").WritableSignal<string>;
+    readonly loginPassword: import("@angular/core").WritableSignal<string>;
+    readonly showLoginPassword: import("@angular/core").WritableSignal<boolean>;
+    readonly loginSubmitting: import("@angular/core").WritableSignal<boolean>;
+    /** Fixed coords for notifications / login / user panels (anchored to trigger). */
+    readonly dropdownPanelStyle: import("@angular/core").WritableSignal<Record<string, string>>;
+    private readonly dismissedNotificationIds;
+    private readonly readNotificationIds;
+    private dropdownTrigger;
+    private dropdownActionId;
+    private readonly injector;
+    private readonly searchInputRef;
+    readonly searchPanelId = "dga-header-search-panel";
+    readonly notificationsPanelId = "dga-header-notifications-panel";
+    readonly loginPanelId = "dga-header-login-panel";
+    readonly userPanelId = "dga-header-user-panel";
+    readonly isPortal: import("@angular/core").Signal<boolean>;
+    readonly searchConfig: import("@angular/core").Signal<DgaHeaderSearchConfig | null>;
+    readonly searchActionId: import("@angular/core").Signal<string>;
+    readonly notificationsConfig: import("@angular/core").Signal<DgaHeaderNotificationsConfig | null>;
+    readonly notificationsActionId: import("@angular/core").Signal<string>;
+    readonly loginConfig: import("@angular/core").Signal<DgaHeaderLoginConfig | null>;
+    readonly loginActionId: import("@angular/core").Signal<string>;
+    readonly userConfig: import("@angular/core").Signal<DgaHeaderUserConfig | null>;
+    readonly utilityOverlayOpen: import("@angular/core").Signal<boolean>;
+    readonly visibleNotifications: import("@angular/core").Signal<{
+        read: boolean;
+        id: string;
+        title: string;
+        message: string;
+        statusLabel?: string;
+        tone?: DgaHeaderNotificationTone;
+        icon?: DgaIconName;
+        href?: string;
+    }[]>;
+    readonly unreadNotificationCount: import("@angular/core").Signal<number>;
+    constructor();
+    /** Compact under-trigger menus are rendered inside the `<li>` (desktop only). */
+    readonly activeWideDropdown: import("@angular/core").Signal<{
+        index: number;
+        item: DgaNavItem;
+        variant: "mega" | "featured";
+    } | null>;
+    readonly hostClasses: import("@angular/core").Signal<string>;
+    readonly innerClasses: import("@angular/core").Signal<string>;
+    readonly desktopNavClasses: import("@angular/core").Signal<string>;
+    readonly actionsClasses: import("@angular/core").Signal<string>;
+    mobilePanelClass(): string;
+    hoverMenus(): boolean;
+    isMobileViewport(): boolean;
+    resolveVariant(item: DgaNavItem): DgaNavDropdownVariant;
+    resolveLayout(item: DgaNavItem): DgaNavDropdownLayout;
+    colCount(item: DgaNavItem): number;
+    flatLinks(item: DgaNavItem): DgaNavLink[];
+    columnsGridClass(count: number): string;
+    featuredGridClass(variant: DgaNavDropdownVariant, hasFeatured: boolean): string;
+    navItemClass(current: boolean, open?: boolean): string;
+    mobileItemClass(current: boolean, open?: boolean): string;
+    indicatorClass(active: boolean): string;
+    actionClass(_action: DgaHeaderAction): string;
+    badgeClass(): string;
+    isIconOnly(action: DgaHeaderAction): boolean;
+    isSearchAction(action: DgaHeaderAction): boolean;
+    isNotificationsAction(action: DgaHeaderAction): boolean;
+    isLoginAction(action: DgaHeaderAction): boolean;
+    actionTooltip(action: DgaHeaderAction): string;
+    actionAriaLabel(action: DgaHeaderAction): string;
+    actionExpanded(action: DgaHeaderAction): boolean | null;
+    actionControls(action: DgaHeaderAction): string | null;
+    actionIndicatorActive(action: DgaHeaderAction): boolean;
+    private clearCloseTimer;
+    private scheduleClose;
+    private setBodyScrollLocked;
+    onItemEnter(i: number): void;
+    onPanelEnter(): void;
+    onHostLeave(event: MouseEvent): void;
+    toggleMobile(): void;
+    toggleDropdown(i: number, event: Event): void;
+    closeAll(): void;
+    onAction(action: DgaHeaderAction, event?: Event): void;
+    onMobileAction(action: DgaHeaderAction, event?: Event): void;
+    closeUtilityOverlays(): void;
+    toggleSearch(): void;
+    closeSearch(clearVoice?: boolean): void;
+    toggleNotifications(trigger?: HTMLElement | null): void;
+    closeNotifications(): void;
+    toggleLogin(trigger?: HTMLElement | null): void;
+    closeLogin(): void;
+    toggleUserMenu(trigger?: HTMLElement | null): void;
+    closeUserMenu(): void;
+    onLoginSubmit(event: Event): void;
+    onUserLink(link: DgaHeaderUserMenuLink): void;
+    toggleNotificationExpand(item: DgaHeaderNotification): void;
+    onNotificationAction(item: DgaHeaderNotification, action: DgaHeaderNotificationAction): void;
+    markAllNotificationsRead(): void;
+    clearSearchQuery(): void;
+    applySearchSuggestion(item: DgaHeaderSearchSuggestion): void;
+    onSearchFormSubmit(event: Event): void;
+    onSearchVoice(): void;
+    private speechRecognition;
+    private stopVoice;
+    private triggerFromEvent;
+    private scheduleDropdownSync;
+    private requestDropdownSync;
+    private clearDropdownAnchor;
+    private findActionTrigger;
+    private syncDropdownPanel;
+    onKey(event: KeyboardEvent): void;
+    onScroll(): void;
+    onResize(): void;
+    onDocClick(event: MouseEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DgaHeader, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DgaHeader, "dga-header", never, { "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "brandSlogan": { "alias": "brandSlogan"; "required": false; "isSignal": true; }; "brandLogo": { "alias": "brandLogo"; "required": false; "isSignal": true; }; "brandLogoAlt": { "alias": "brandLogoAlt"; "required": false; "isSignal": true; }; "brandPlaceholder": { "alias": "brandPlaceholder"; "required": false; "isSignal": true; }; "brandHref": { "alias": "brandHref"; "required": false; "isSignal": true; }; "navLabel": { "alias": "navLabel"; "required": false; "isSignal": true; }; "menuToggleLabel": { "alias": "menuToggleLabel"; "required": false; "isSignal": true; }; "menuCloseLabel": { "alias": "menuCloseLabel"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "mobileNav": { "alias": "mobileNav"; "required": false; "isSignal": true; }; "sticky": { "alias": "sticky"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "actions": { "alias": "actions"; "required": false; "isSignal": true; }; "search": { "alias": "search"; "required": false; "isSignal": true; }; "searchQuery": { "alias": "searchQuery"; "required": false; "isSignal": true; }; "notifications": { "alias": "notifications"; "required": false; "isSignal": true; }; "login": { "alias": "login"; "required": false; "isSignal": true; }; "user": { "alias": "user"; "required": false; "isSignal": true; }; "authenticated": { "alias": "authenticated"; "required": false; "isSignal": true; }; }, { "searchQuery": "searchQueryChange"; "authenticated": "authenticatedChange"; "actionClick": "actionClick"; "searchSubmit": "searchSubmit"; "searchSuggestionSelect": "searchSuggestionSelect"; "searchVoice": "searchVoice"; "notificationAction": "notificationAction"; "loginSubmit": "loginSubmit"; "logout": "logout"; "userLinkClick": "userLinkClick"; }, never, ["[dgaHeaderBrand]", "*", "[dgaHeaderEnd]"], true, never>;
+}

package/lib/shell/hero/dga-hero.d.ts

@@ -0,0 +1,128 @@
+import * as i0 from "@angular/core";
+/**
+ * `default` / `portal` - original full page headers.
+ * `sub` / `flat` - compact page-header band (breadcrumb + optional float/actions slot).
+ * `aside` - text + side media, two columns.
+ * `brief` - shorter title/description density, same layout as `default`.
+ */
+export type DgaHeroAppearance = 'default' | 'portal' | 'sub' | 'flat' | 'aside' | 'brief';
+/** Carousel motion between slides. */
+export type DgaHeroTransition = 'fade' | 'push';
+/** Overlay tint drawn above the hero image. `none` skips the overlay entirely. */
+export type DgaHeroOverlayTone = 'primary' | 'dark' | 'none';
+/** Decorative edge mask applied to the hero image (CSS mask / clip-path). */
+export type DgaHeroImageMask = 'none' | 'fade' | 'angle' | 'wave';
+export interface DgaHeroSlide {
+    /** Main headline. */
+    title: string;
+    /** Supporting copy - prefer over legacy `subtitle`. */
+    description?: string;
+    /** @deprecated Prefer `description`. */
+    subtitle?: string;
+    /** Primary / main action label. */
+    primaryCta?: string;
+    /** Secondary action label. */
+    secondaryCta?: string;
+    primaryHref?: string;
+    secondaryHref?: string;
+    /** Desktop / large viewport image. Falls back to `imageUrl`. */
+    imageDesktop?: string;
+    /** Mobile image - falls back to desktop. */
+    imageMobile?: string;
+    /** @deprecated Prefer `imageDesktop`. */
+    imageUrl?: string;
+    /** Per-slide overlay tint - falls back to the hero's `imageOverlay` input. */
+    overlay?: DgaHeroOverlayTone;
+}
+export declare class DgaHero {
+    private readonly destroyRef;
+    private autoplayTimer;
+    private readonly autoplayPaused;
+    /** Skip CSS transitions on first layout so slides don't animate in like a locale wipe. */
+    private readonly motionReady;
+    /** Single-slide API. */
+    readonly title: import("@angular/core").InputSignal<string>;
+    readonly description: import("@angular/core").InputSignal<string>;
+    /** @deprecated Prefer `description`. */
+    readonly subtitle: import("@angular/core").InputSignal<string>;
+    readonly primaryCta: import("@angular/core").InputSignal<string>;
+    readonly secondaryCta: import("@angular/core").InputSignal<string>;
+    readonly primaryHref: import("@angular/core").InputSignal<string>;
+    readonly secondaryHref: import("@angular/core").InputSignal<string>;
+    readonly imageDesktop: import("@angular/core").InputSignal<string>;
+    readonly imageMobile: import("@angular/core").InputSignal<string>;
+    /** @deprecated Prefer `imageDesktop`. */
+    readonly imageUrl: import("@angular/core").InputSignal<string>;
+    /** Overlay tint drawn above the single (non-carousel) hero image. */
+    readonly imageOverlay: import("@angular/core").InputSignal<DgaHeroOverlayTone>;
+    /** Decorative edge mask applied to the hero image(s). */
+    readonly imageMaskVariant: import("@angular/core").InputSignal<DgaHeroImageMask>;
+    /**
+     * Portal carousel slides. When length > 0, each slide supplies its own
+     * title / description / CTAs / images.
+     */
+    readonly slides: import("@angular/core").InputSignal<DgaHeroSlide[]>;
+    readonly activeIndex: import("@angular/core").ModelSignal<number>;
+    readonly appearance: import("@angular/core").InputSignal<DgaHeroAppearance>;
+    /** Carousel motion - default `push`. Also `fade`. */
+    readonly transition: import("@angular/core").InputSignal<DgaHeroTransition>;
+    readonly autoplay: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    readonly autoplayMs: import("@angular/core").InputSignal<number>;
+    /** Dot pagination under the carousel. Default `true`. */
+    readonly showDots: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    /** Prev / next arrow controls. Default `false`. */
+    readonly showArrows: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    readonly dotsLabel: import("@angular/core").InputSignal<string>;
+    readonly prevLabel: import("@angular/core").InputSignal<string>;
+    readonly nextLabel: import("@angular/core").InputSignal<string>;
+    readonly primaryClick: import("@angular/core").OutputEmitterRef<number | void>;
+    readonly secondaryClick: import("@angular/core").OutputEmitterRef<number | void>;
+    readonly slideChange: import("@angular/core").OutputEmitterRef<number>;
+    readonly slideCount: import("@angular/core").Signal<number>;
+    readonly isCarousel: import("@angular/core").Signal<boolean>;
+    /** Compact page-header band variants (breadcrumb + float/actions slot, no media column). */
+    readonly isCompactBand: import("@angular/core").Signal<boolean>;
+    readonly slideIndexes: import("@angular/core").Signal<number[]>;
+    readonly hostClasses: import("@angular/core").Signal<string>;
+    readonly innerClasses: import("@angular/core").Signal<string>;
+    readonly titleClasses: import("@angular/core").Signal<string>;
+    readonly subtitleClasses: import("@angular/core").Signal<string>;
+    /** Precomputed inline `mask-image` / `clip-path` for the current `imageMaskVariant`. */
+    readonly imageMaskStyle: import("@angular/core").Signal<Record<string, string>>;
+    constructor();
+    portalCtaVariant(): 'inverse' | 'primary';
+    /** Secondary is always outline - inverse outline on dark portal surfaces. */
+    secondaryCtaVariant(): 'outlineInverse' | 'outline';
+    slideShellClass(i: number): string;
+    clampedIndex(): number;
+    activeTitle(): string;
+    activeDescription(): string;
+    singleDesktopImage(): string;
+    singleMobileImage(): string;
+    slideTitle(slide: DgaHeroSlide): string;
+    slideDescription(slide: DgaHeroSlide): string;
+    slideDesktop(slide: DgaHeroSlide): string;
+    slideMobile(slide: DgaHeroSlide): string;
+    ctaPrimary(slide: DgaHeroSlide): string;
+    ctaSecondary(slide: DgaHeroSlide): string;
+    ctaPrimaryHref(slide: DgaHeroSlide): string;
+    ctaSecondaryHref(slide: DgaHeroSlide): string;
+    dotLabel(i: number): string;
+    dotClass(i: number): string;
+    /** Overlay class for the given tone (falls back to `imageOverlay`); `''` renders no overlay. */
+    overlayClass(tone?: DgaHeroOverlayTone): string;
+    /** Per-slide overlay - falls back to the hero-level `imageOverlay` input. */
+    slideOverlayClass(slide: DgaHeroSlide): string;
+    /** Push direction follows document direction (RTL slides the other way). */
+    pushOffset(i: number): string;
+    goSlide(i: number): void;
+    nextSlide(): void;
+    prevSlide(): void;
+    pauseAutoplay(): void;
+    resumeAutoplay(): void;
+    onPrimary(index?: number): void;
+    onSecondary(index?: number): void;
+    private clearAutoplay;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DgaHero, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DgaHero, "dga-hero", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "primaryCta": { "alias": "primaryCta"; "required": false; "isSignal": true; }; "secondaryCta": { "alias": "secondaryCta"; "required": false; "isSignal": true; }; "primaryHref": { "alias": "primaryHref"; "required": false; "isSignal": true; }; "secondaryHref": { "alias": "secondaryHref"; "required": false; "isSignal": true; }; "imageDesktop": { "alias": "imageDesktop"; "required": false; "isSignal": true; }; "imageMobile": { "alias": "imageMobile"; "required": false; "isSignal": true; }; "imageUrl": { "alias": "imageUrl"; "required": false; "isSignal": true; }; "imageOverlay": { "alias": "imageOverlay"; "required": false; "isSignal": true; }; "imageMaskVariant": { "alias": "imageMaskVariant"; "required": false; "isSignal": true; }; "slides": { "alias": "slides"; "required": false; "isSignal": true; }; "activeIndex": { "alias": "activeIndex"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "transition": { "alias": "transition"; "required": false; "isSignal": true; }; "autoplay": { "alias": "autoplay"; "required": false; "isSignal": true; }; "autoplayMs": { "alias": "autoplayMs"; "required": false; "isSignal": true; }; "showDots": { "alias": "showDots"; "required": false; "isSignal": true; }; "showArrows": { "alias": "showArrows"; "required": false; "isSignal": true; }; "dotsLabel": { "alias": "dotsLabel"; "required": false; "isSignal": true; }; "prevLabel": { "alias": "prevLabel"; "required": false; "isSignal": true; }; "nextLabel": { "alias": "nextLabel"; "required": false; "isSignal": true; }; }, { "activeIndex": "activeIndexChange"; "primaryClick": "primaryClick"; "secondaryClick": "secondaryClick"; "slideChange": "slideChange"; }, never, ["[dgaHeroBreadcrumb]", "[dgaHeroFloat]", "*", "*"], true, never>;
+}

package/lib/shell/logo-tile/dga-logo-tile.d.ts

@@ -0,0 +1,11 @@
+import * as i0 from "@angular/core";
+/**
+ * Partner / logo tile used in portal “قسم الشركاء” carousels.
+ */
+export declare class DgaLogoTile {
+    readonly label: import("@angular/core").InputSignal<string>;
+    readonly src: import("@angular/core").InputSignal<string>;
+    readonly classes: import("@angular/core").Signal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DgaLogoTile, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DgaLogoTile, "dga-logo-tile", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "src": { "alias": "src"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/lib/shell/preloader/dga-preloader.d.ts

@@ -0,0 +1,55 @@
+import { OnInit } from '@angular/core';
+import * as i0 from "@angular/core";
+export type DgaPreloaderPersist = 'local' | 'session' | 'none';
+/**
+ * Optional full-screen first-load preloader.
+ *
+ * Brand mark + soft fade exit.
+ * Auto-hides once the document is ready and `minDuration` has elapsed.
+ * By default shows once per visitor (`once` + `persist="local"`); returning visits skip it.
+ * Drop it near the app root - omit the element entirely if unused.
+ *
+ * @example
+ * ```html
+ * <dga-preloader brand="بوابة الخدمات" [minDuration]="1000" />
+ * ```
+ */
+export declare class DgaPreloader implements OnInit {
+    private readonly doc;
+    private readonly destroyRef;
+    /** Brand / product name under the mark. */
+    readonly brand: import("@angular/core").InputSignal<string>;
+    /** Optional logo image (overrides the default geometric mark). */
+    readonly logoSrc: import("@angular/core").InputSignal<string | undefined>;
+    /** Accessible status label. */
+    readonly label: import("@angular/core").InputSignal<string>;
+    /** Minimum time on screen before exit (ms). */
+    readonly minDuration: import("@angular/core").InputSignal<number>;
+    /** Skip after the first visit (persist in storage). */
+    readonly once: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    /** Storage used when `once` is true. */
+    readonly persist: import("@angular/core").InputSignal<DgaPreloaderPersist>;
+    /** Storage key for the seen flag. */
+    readonly storageKey: import("@angular/core").InputSignal<string>;
+    /** Fires after the exit animation finishes and the overlay is removed. */
+    readonly closed: import("@angular/core").OutputEmitterRef<void>;
+    readonly active: import("@angular/core").WritableSignal<boolean>;
+    readonly exiting: import("@angular/core").WritableSignal<boolean>;
+    private startedAt;
+    private ready;
+    private exitArmed;
+    private timers;
+    ngOnInit(): void;
+    /** Force an exit (e.g. from the host after data is ready). */
+    dismiss(): void;
+    onAnimEnd(event: AnimationEvent): void;
+    private watchReady;
+    private tryExit;
+    private finish;
+    private shouldSkip;
+    private markSeen;
+    private lockScroll;
+    private clearTimers;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DgaPreloader, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DgaPreloader, "dga-preloader", never, { "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "logoSrc": { "alias": "logoSrc"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "minDuration": { "alias": "minDuration"; "required": false; "isSignal": true; }; "once": { "alias": "once"; "required": false; "isSignal": true; }; "persist": { "alias": "persist"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, never, true, never>;
+}

package/lib/shell/side-info/dga-side-info.d.ts

@@ -0,0 +1,19 @@
+import * as i0 from "@angular/core";
+export interface DgaSideInfoItem {
+    label: string;
+    href?: string;
+    value?: string;
+}
+export declare class DgaSideInfo {
+    readonly title: import("@angular/core").InputSignal<string>;
+    readonly items: import("@angular/core").InputSignal<DgaSideInfoItem[]>;
+    readonly active: import("@angular/core").ModelSignal<string>;
+    readonly label: import("@angular/core").InputSignal<string>;
+    readonly select: import("@angular/core").OutputEmitterRef<DgaSideInfoItem>;
+    trackItem(item: DgaSideInfoItem, index: number): string;
+    isActive(item: DgaSideInfoItem): boolean;
+    itemClasses(item: DgaSideInfoItem): string;
+    onSelect(item: DgaSideInfoItem): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DgaSideInfo, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DgaSideInfo, "dga-side-info", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "active": "activeChange"; "select": "select"; }, never, ["*"], true, never>;
+}

package/lib/shell/top-bar/dga-top-bar.d.ts

@@ -0,0 +1,63 @@
+import { OnInit } from '@angular/core';
+import * as i0 from "@angular/core";
+export interface DgaStampNotice {
+    title: string;
+    /** Substring of `title` rendered bold in the primary color (e.g. `gov.sa`). */
+    highlight?: string;
+    body: string;
+    icon: 'link' | 'lock' | 'info';
+}
+export type DgaCalendar = 'hijri' | 'gregorian';
+export 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).
+ */
+export declare class DgaTopBar implements OnInit {
+    private readonly destroyRef;
+    readonly saFlagSrc: string;
+    readonly panelId = "dga-digital-stamp";
+    readonly open: import("@angular/core").ModelSignal<boolean>;
+    /** Active calendar for the date widget. Click the date to switch. */
+    readonly calendar: import("@angular/core").ModelSignal<DgaCalendar>;
+    /** Clock display. Click the time to switch 12h ↔ 24h. */
+    readonly timeFormat: import("@angular/core").ModelSignal<DgaTimeFormat>;
+    readonly showDate: import("@angular/core").InputSignal<boolean>;
+    readonly showTime: import("@angular/core").InputSignal<boolean>;
+    /** `ar` → Arabic labels; `en` → English. */
+    readonly locale: import("@angular/core").InputSignal<"ar" | "en">;
+    readonly regionLabel: import("@angular/core").InputSignal<string>;
+    readonly stampLabel: import("@angular/core").InputSignal<string>;
+    readonly tabTextLg: import("@angular/core").InputSignal<string>;
+    readonly tabTextSm: import("@angular/core").InputSignal<string>;
+    readonly verifyText: import("@angular/core").InputSignal<string>;
+    readonly registrationLabel: import("@angular/core").InputSignal<string>;
+    /** DGA platform registration / license number shown in the expanded stamp. */
+    readonly registrationId: import("@angular/core").InputSignal<string>;
+    /**
+     * License page on raqmi.dga.gov.sa (opens in a new tab).
+     * @example https://raqmi.dga.gov.sa/platforms/platforms/…/platform-license
+     */
+    readonly registrationHref: import("@angular/core").InputSignal<string>;
+    readonly notices: import("@angular/core").InputSignal<DgaStampNotice[]>;
+    private readonly now;
+    readonly dateLabel: import("@angular/core").Signal<string>;
+    readonly timeLabel: import("@angular/core").Signal<string>;
+    readonly calendarToggleLabel: import("@angular/core").Signal<"التبديل إلى التقويم الميلادي" | "Switch to Gregorian calendar" | "التبديل إلى التقويم الهجري" | "Switch to Hijri calendar">;
+    readonly timeToggleLabel: import("@angular/core").Signal<"التبديل إلى تنسيق 24 ساعة" | "Switch to 24-hour format" | "التبديل إلى تنسيق 12 ساعة" | "Switch to 12-hour format">;
+    readonly hostClasses: import("@angular/core").Signal<string>;
+    ngOnInit(): void;
+    private clockTimer;
+    private tick;
+    private scheduleMinuteTick;
+    titleParts(n: DgaStampNotice): {
+        text: string;
+        hl: boolean;
+    }[];
+    toggle(): void;
+    toggleCalendar(): void;
+    toggleTimeFormat(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DgaTopBar, never>;
+    static ɵcmp: i0.ɵɵ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>;
+}