@frame-kit/ui-ng 0.0.1

package/types/frame-kit-ui-ng-ui-tabs.d.ts

@@ -0,0 +1,266 @@
+import * as _frame_kit_ui_ng_ui_tabs from '@frame-kit/ui-ng/ui/tabs';
+import * as _angular_core from '@angular/core';
+import { OnInit, OnChanges, TemplateRef, SimpleChanges, InjectionToken, AfterViewInit, ElementRef } from '@angular/core';
+
+declare class FkTabComponent implements OnInit, OnChanges {
+    private readonly service;
+    private readonly elementRef;
+    private readonly destroyRef;
+    readonly className: _angular_core.InputSignal<string>;
+    /** Unique value that identifies this tab and links it to its `fk-tab-panel`. */
+    readonly value: _angular_core.InputSignal<string>;
+    /** When true, the tab is non-interactive and cannot be selected. */
+    readonly disabled: _angular_core.InputSignal<boolean>;
+    /** When true, renders a close button on the tab trigger. */
+    readonly closable: _angular_core.InputSignal<boolean>;
+    /** Optional badge content (string or number) rendered in the top-right corner of the trigger. */
+    readonly badge: _angular_core.InputSignal<string | number | undefined>;
+    /** Optional icon — either an icon name string or a `TemplateRef` — shown before the label. */
+    readonly icon: _angular_core.InputSignal<string | TemplateRef<unknown> | undefined>;
+    readonly closeIconRef: _angular_core.Signal<_frame_kit_ui_ng_ui_tabs.FkTabCloseIconDirective | undefined>;
+    readonly tabId: _angular_core.WritableSignal<string>;
+    readonly panelId: _angular_core.WritableSignal<string>;
+    readonly isActive: _angular_core.Signal<boolean>;
+    readonly classes: _angular_core.Signal<string>;
+    get hostClass(): string;
+    readonly role = "tab";
+    get hostId(): string;
+    get ariaSelected(): boolean;
+    get ariaControls(): string;
+    get tabIndex(): 0 | -1;
+    get ariaDisabled(): true | null;
+    onClick(): void;
+    onFocus(): void;
+    private initialized;
+    constructor();
+    ngOnInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    isTemplateRef(val: unknown): val is TemplateRef<unknown>;
+    onClose(event: MouseEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FkTabComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FkTabComponent, "fk-tab", never, { "className": { "alias": "className"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; }, {}, ["closeIconRef"], ["*", "[fkTabCloseIcon]"], true, never>;
+}
+
+declare const FK_TAB_CLOSE_ICON: InjectionToken<FkTabCloseIconDirective>;
+declare const FK_TAB_SCROLL_START_ICON: InjectionToken<FkTabScrollStartIconDirective>;
+declare const FK_TAB_SCROLL_END_ICON: InjectionToken<FkTabScrollEndIconDirective>;
+declare class FkTabCloseIconDirective {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FkTabCloseIconDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FkTabCloseIconDirective, "[fkTabCloseIcon]", never, {}, {}, never, never, true, never>;
+}
+declare class FkTabScrollStartIconDirective {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FkTabScrollStartIconDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FkTabScrollStartIconDirective, "[fkTabScrollStartIcon]", never, {}, {}, never, never, true, never>;
+}
+declare class FkTabScrollEndIconDirective {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FkTabScrollEndIconDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FkTabScrollEndIconDirective, "[fkTabScrollEndIcon]", never, {}, {}, never, never, true, never>;
+}
+
+type FkTabsOrientation = 'horizontal' | 'vertical';
+type FkTabsActivationMode = 'automatic' | 'manual';
+type FkTabsVariant = 'underline' | 'pill' | 'contained';
+type FkTabsSize = 'sm' | 'md' | 'lg';
+interface FkTabRegistration {
+    value: string;
+    disabled: boolean;
+    element: HTMLElement;
+    tabId: string;
+    panelId: string;
+}
+interface FkPanelRegistration {
+    value: string;
+    panelId: string;
+    tabId: string;
+}
+interface FkTabChangeEvent {
+    previousValue: string | null;
+    value: string;
+}
+interface FkTabCloseEvent {
+    value: string;
+}
+interface FkTabIndicatorState {
+    visible: boolean;
+    offset: number;
+    size: number;
+}
+
+declare class TabsService {
+    private tabIdCounter;
+    createTabIds(value: string): {
+        tabId: string;
+        panelId: string;
+    };
+    private _orientationFn;
+    private _activationModeFn;
+    private _variantFn;
+    private _lazyFn;
+    private _keepMountedFn;
+    private _scrollableFn;
+    private _showScrollButtonsFn;
+    readonly orientation: _angular_core.Signal<FkTabsOrientation>;
+    readonly activationMode: _angular_core.Signal<FkTabsActivationMode>;
+    readonly variant: _angular_core.Signal<FkTabsVariant>;
+    readonly lazy: _angular_core.Signal<boolean>;
+    readonly keepMounted: _angular_core.Signal<boolean>;
+    readonly scrollable: _angular_core.Signal<boolean>;
+    readonly showScrollButtons: _angular_core.Signal<boolean>;
+    setConfig(config: {
+        orientation: () => FkTabsOrientation;
+        activationMode: () => FkTabsActivationMode;
+        variant: () => FkTabsVariant;
+        lazy: () => boolean;
+        keepMounted: () => boolean;
+        scrollable: () => boolean;
+        showScrollButtons: () => boolean;
+    }): void;
+    private _controlledValueFn;
+    setControlledValue(fn: () => string | undefined): void;
+    private readonly _internalActiveValue;
+    readonly activeValue: _angular_core.Signal<string | null>;
+    setActiveValue(value: string | null): void;
+    readonly focusedValue: _angular_core.WritableSignal<string | null>;
+    readonly tabs: _angular_core.WritableSignal<FkTabRegistration[]>;
+    readonly panels: _angular_core.WritableSignal<FkPanelRegistration[]>;
+    readonly activatedPanels: _angular_core.WritableSignal<Set<string>>;
+    readonly enabledTabs: _angular_core.Signal<FkTabRegistration[]>;
+    readonly activeTab: _angular_core.Signal<FkTabRegistration | undefined>;
+    onTabChange: ((event: FkTabChangeEvent) => void) | null;
+    onValueChange: ((value: string) => void) | null;
+    onTabClose: ((value: string) => void) | null;
+    registerTab(reg: FkTabRegistration): void;
+    unregisterTab(value: string): void;
+    registerPanel(reg: FkPanelRegistration): void;
+    unregisterPanel(value: string): void;
+    selectTab(value: string): void;
+    focusTab(value: string): void;
+    handleKeydown(event: KeyboardEvent): void;
+    fallbackSelect(): void;
+    private getNextIndex;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabsService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<TabsService>;
+}
+
+declare class FkTabListComponent implements AfterViewInit {
+    readonly service: TabsService;
+    private readonly ngZone;
+    private readonly destroyRef;
+    private readonly platformId;
+    readonly className: _angular_core.InputSignal<string>;
+    /** Accessible label for the `tablist` role element. */
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    readonly scrollStartIconRef: _angular_core.Signal<_frame_kit_ui_ng_ui_tabs.FkTabScrollStartIconDirective | undefined>;
+    readonly scrollEndIconRef: _angular_core.Signal<_frame_kit_ui_ng_ui_tabs.FkTabScrollEndIconDirective | undefined>;
+    readonly scrollContainer: _angular_core.Signal<ElementRef<HTMLElement> | undefined>;
+    readonly indicatorState: _angular_core.WritableSignal<FkTabIndicatorState>;
+    readonly canScrollStart: _angular_core.WritableSignal<boolean>;
+    readonly canScrollEnd: _angular_core.WritableSignal<boolean>;
+    readonly classes: _angular_core.Signal<string>;
+    get hostClass(): string;
+    readonly role = "tablist";
+    get ariaOrientation(): _frame_kit_ui_ng_ui_tabs.FkTabsOrientation;
+    get hostAriaLabel(): string | null;
+    readonly indicatorStyles: _angular_core.Signal<{
+        opacity: string;
+        height?: undefined;
+        transform?: undefined;
+        width?: undefined;
+    } | {
+        opacity: string;
+        height: string;
+        transform: string;
+        width?: undefined;
+    } | {
+        opacity: string;
+        width: string;
+        transform: string;
+        height?: undefined;
+    }>;
+    readonly showIndicator: _angular_core.Signal<boolean>;
+    private resizeObserver;
+    private activeTabResizeObserver;
+    onKeydown(event: KeyboardEvent): void;
+    constructor();
+    ngAfterViewInit(): void;
+    /** Scrolls the active tab into view inside the scroll container. */
+    scrollToActiveTab(): void;
+    /** Scrolls the tab list by 80% of its visible width in the given direction (+1 or −1). */
+    scrollBy(direction: number): void;
+    onScroll(): void;
+    /** Recalculates the sliding indicator position and size based on the active tab element. */
+    updateIndicator(): void;
+    private updateScrollState;
+    private setupResizeObservers;
+    private observeActiveTab;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FkTabListComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FkTabListComponent, "fk-tab-list", never, { "className": { "alias": "className"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, ["scrollStartIconRef", "scrollEndIconRef"], ["[fkTabScrollStartIcon]", "*", "[fkTabScrollEndIcon]"], true, never>;
+}
+
+declare class FkTabPanelComponent implements OnInit {
+    private readonly service;
+    private readonly destroyRef;
+    readonly className: _angular_core.InputSignal<string>;
+    /** Unique value matching the corresponding `fk-tab`'s value; determines which panel to show. */
+    readonly value: _angular_core.InputSignal<string>;
+    readonly panelId: _angular_core.WritableSignal<string>;
+    readonly tabId: _angular_core.WritableSignal<string>;
+    readonly isActive: _angular_core.Signal<boolean>;
+    readonly shouldRender: _angular_core.Signal<boolean>;
+    readonly classes: _angular_core.Signal<string>;
+    get hostClass(): string;
+    readonly role = "tabpanel";
+    get hostId(): string;
+    get ariaLabelledby(): string;
+    get isHidden(): true | null;
+    readonly tabindex = 0;
+    constructor();
+    ngOnInit(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FkTabPanelComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FkTabPanelComponent, "fk-tab-panel", never, { "className": { "alias": "className"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+declare class FkTabsComponent implements OnInit {
+    private readonly service;
+    private readonly destroyRef;
+    readonly className: _angular_core.InputSignal<string>;
+    /** Controlled active tab value; when set, the parent owns the active state. */
+    readonly value: _angular_core.InputSignal<string | undefined>;
+    /** Initial active tab value used in uncontrolled mode. */
+    readonly defaultValue: _angular_core.InputSignal<string | undefined>;
+    /** Layout direction of the tab list. */
+    readonly orientation: _angular_core.InputSignal<FkTabsOrientation>;
+    /** Whether tabs activate on focus (automatic) or only on click/Enter (manual). */
+    readonly activationMode: _angular_core.InputSignal<FkTabsActivationMode>;
+    /** Visual style of the tab strip. */
+    readonly variant: _angular_core.InputSignal<FkTabsVariant>;
+    /** Size of the tab triggers. */
+    readonly size: _angular_core.InputSignal<FkTabsSize>;
+    /** When true, tab panels are not rendered until first activated. */
+    readonly lazy: _angular_core.InputSignal<boolean>;
+    /** When true (and `lazy` is true), panels remain mounted in the DOM after their first activation. */
+    readonly keepMounted: _angular_core.InputSignal<boolean>;
+    /** When true, each tab trigger stretches to fill an equal share of the tab list. */
+    readonly stretch: _angular_core.InputSignal<boolean>;
+    /** When true, the tab list spans the full width of its container. */
+    readonly fullWidth: _angular_core.InputSignal<boolean>;
+    /** When true, the tab list scrolls horizontally/vertically when tabs overflow. */
+    readonly scrollable: _angular_core.InputSignal<boolean>;
+    /** When true (and `scrollable` is true), arrow buttons appear at the edges of the tab list. */
+    readonly showScrollButtons: _angular_core.InputSignal<boolean>;
+    /** Fires when the active tab changes, emitting the new tab value. */
+    readonly valueChange: _angular_core.OutputEmitterRef<string>;
+    /** Fires when the active tab changes, emitting the full change event including previous and next values. */
+    readonly tabChange: _angular_core.OutputEmitterRef<FkTabChangeEvent>;
+    /** Fires when a closable tab's close button is clicked, emitting the tab value. */
+    readonly tabClose: _angular_core.OutputEmitterRef<FkTabCloseEvent>;
+    readonly classes: _angular_core.Signal<string>;
+    get hostClass(): string;
+    constructor();
+    ngOnInit(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FkTabsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FkTabsComponent, "fk-tabs", never, { "className": { "alias": "className"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "defaultValue": { "alias": "defaultValue"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "activationMode": { "alias": "activationMode"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "keepMounted": { "alias": "keepMounted"; "required": false; "isSignal": true; }; "stretch": { "alias": "stretch"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "scrollable": { "alias": "scrollable"; "required": false; "isSignal": true; }; "showScrollButtons": { "alias": "showScrollButtons"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "tabChange": "tabChange"; "tabClose": "tabClose"; }, never, ["*"], true, never>;
+}
+
+export { FK_TAB_CLOSE_ICON, FK_TAB_SCROLL_END_ICON, FK_TAB_SCROLL_START_ICON, FkTabCloseIconDirective, FkTabComponent, FkTabListComponent, FkTabPanelComponent, FkTabScrollEndIconDirective, FkTabScrollStartIconDirective, FkTabsComponent, TabsService };
+export type { FkPanelRegistration, FkTabChangeEvent, FkTabCloseEvent, FkTabIndicatorState, FkTabRegistration, FkTabsActivationMode, FkTabsOrientation, FkTabsSize, FkTabsVariant };

package/types/frame-kit-ui-ng-ui-timeline.d.ts

@@ -0,0 +1,42 @@
+import * as _angular_core from '@angular/core';
+
+type TimelineOrientation = 'vertical' | 'horizontal';
+type TimelineAlign = 'start' | 'end' | 'alternate';
+type TimelineSize = 'sm' | 'md' | 'lg';
+type TimelineItemStatus = 'default' | 'active' | 'completed' | 'error' | 'warning';
+interface TimelineItemData {
+    id?: string;
+    title?: string;
+    description?: string;
+    timestamp?: string;
+    icon?: string;
+    status?: TimelineItemStatus;
+}
+
+declare class TimelineComponent {
+    /** Array of timeline item data objects rendered in order. */
+    readonly items: _angular_core.InputSignal<TimelineItemData[]>;
+    /** Direction the timeline runs — vertical stacks items top-to-bottom, horizontal left-to-right. */
+    readonly orientation: _angular_core.InputSignal<TimelineOrientation>;
+    /** Alignment of the item content relative to the connector line. */
+    readonly align: _angular_core.InputSignal<TimelineAlign>;
+    /** Size variant controlling the dot and spacing of each item. */
+    readonly size: _angular_core.InputSignal<TimelineSize>;
+    /** When true, the items array is rendered in reverse order. */
+    readonly reverse: _angular_core.InputSignal<boolean>;
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    readonly className: _angular_core.InputSignal<string>;
+    readonly id: _angular_core.InputSignal<string | null>;
+    readonly orderedItems: _angular_core.Signal<TimelineItemData[]>;
+    readonly classes: _angular_core.Signal<string>;
+    get hostClass(): string;
+    get hostRole(): string;
+    get hostAriaLabel(): string | null;
+    get hostAriaOrientation(): TimelineOrientation;
+    get hostId(): string | null;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TimelineComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimelineComponent, "fk-timeline", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "reverse": { "alias": "reverse"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "className": { "alias": "className"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+export { TimelineComponent };
+export type { TimelineAlign, TimelineItemData, TimelineItemStatus, TimelineOrientation, TimelineSize };

package/types/frame-kit-ui-ng-ui-toast.d.ts

@@ -0,0 +1,56 @@
+import * as _angular_platform_browser from '@angular/platform-browser';
+import * as _angular_core from '@angular/core';
+import { OnDestroy } from '@angular/core';
+import { ToastSeverity, ToastService, Toast } from '@frame-kit/ui-ng/services/toast';
+
+declare class ToastComponent {
+    private readonly registry;
+    private readonly config;
+    /** Severity level that drives the toast icon and color. */
+    readonly severity: _angular_core.InputSignal<ToastSeverity>;
+    /** Primary message text shown in the toast. */
+    readonly summary: _angular_core.InputSignal<string>;
+    /** Optional secondary detail text shown below the summary. */
+    readonly detail: _angular_core.InputSignal<string | undefined>;
+    /** When true, renders the dismiss button so the user can close the toast. */
+    readonly dismissible: _angular_core.InputSignal<boolean>;
+    readonly className: _angular_core.InputSignal<string>;
+    readonly id: _angular_core.InputSignal<string | null>;
+    /** Fires when the user clicks the dismiss button. */
+    readonly dismiss: _angular_core.OutputEmitterRef<void>;
+    readonly classes: _angular_core.Signal<string>;
+    readonly iconSvg: _angular_core.Signal<_angular_platform_browser.SafeHtml | null>;
+    readonly role: _angular_core.Signal<"alert" | "status">;
+    get hostClass(): string;
+    get hostId(): string | null;
+    get hostRole(): "alert" | "status";
+    onDismiss(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToastComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToastComponent, "fk-toast", never, { "severity": { "alias": "severity"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "detail": { "alias": "detail"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "className": { "alias": "className"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; }, { "dismiss": "dismiss"; }, never, never, true, never>;
+}
+
+type ToastPosition = 'top-right' | 'top-center' | 'top-left' | 'bottom-right' | 'bottom-center' | 'bottom-left';
+declare class ToastContainerComponent implements OnDestroy {
+    protected readonly toastService: ToastService;
+    private readonly appRef;
+    private readonly injector;
+    private readonly elRef;
+    private readonly customRefs;
+    /** Screen position where toasts are stacked. */
+    readonly position: _angular_core.InputSignal<ToastPosition>;
+    readonly className: _angular_core.InputSignal<string>;
+    readonly id: _angular_core.InputSignal<string | null>;
+    readonly defaultToasts: _angular_core.Signal<Toast[]>;
+    readonly classes: _angular_core.Signal<string>;
+    get hostClass(): string;
+    get hostId(): string | null;
+    constructor();
+    ngOnDestroy(): void;
+    onDismiss(id: string): void;
+    private createCustomToast;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToastContainerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToastContainerComponent, "fk-toast-container", never, { "position": { "alias": "position"; "required": false; "isSignal": true; }; "className": { "alias": "className"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { ToastComponent, ToastContainerComponent };
+export type { ToastPosition };

package/types/frame-kit-ui-ng-ui-user-menu.d.ts

@@ -0,0 +1,87 @@
+import * as _angular_core from '@angular/core';
+import { AvatarStatus, AvatarSize } from '@frame-kit/ui-ng/ui/avatar';
+import { DropdownMenuComponent } from '@frame-kit/ui-ng/ui/dropdown-menu';
+
+interface MenuItem {
+    label: string;
+    value: string;
+    icon?: string;
+    disabled?: boolean;
+    danger?: boolean;
+    separator?: boolean;
+}
+type UserMenuVariant = 'dropdown' | 'popover';
+type MenuPlacement = 'bottom-start' | 'bottom-end';
+type InfoPlacement = 'start' | 'end';
+
+declare class UserMenuComponent {
+    /** Full display name of the user shown in the avatar and optional info section. */
+    readonly name: _angular_core.InputSignal<string>;
+    /** User's email address shown in the optional info section. */
+    readonly email: _angular_core.InputSignal<string | null>;
+    /** URL of the user's avatar image. */
+    readonly avatarUrl: _angular_core.InputSignal<string | null>;
+    /** Explicit two-character initials that override the name-derived fallback. */
+    readonly initials: _angular_core.InputSignal<string | null>;
+    /** Optional user ID displayed in the info section for debugging or display. */
+    readonly userId: _angular_core.InputSignal<string | null>;
+    /** Online/offline/away status reflected on the avatar indicator dot. */
+    readonly status: _angular_core.InputSignal<AvatarStatus | null>;
+    /** When true, renders the status indicator dot on the avatar. */
+    readonly showStatus: _angular_core.InputSignal<boolean>;
+    /** Array of menu item configurations rendered in the dropdown. */
+    readonly menuItems: _angular_core.InputSignal<MenuItem[]>;
+    /** Preferred placement of the dropdown panel relative to the trigger. */
+    readonly placement: _angular_core.InputSignal<MenuPlacement>;
+    /** Size of the avatar trigger. */
+    readonly size: _angular_core.InputSignal<AvatarSize>;
+    /** Layout variant — "dropdown" renders a full avatar menu, "compact" renders a minimal trigger. */
+    readonly variant: _angular_core.InputSignal<UserMenuVariant>;
+    /** When true, renders the user's display name next to the avatar. */
+    readonly showName: _angular_core.InputSignal<boolean>;
+    /** When true, renders the user's email next to the avatar. */
+    readonly showEmail: _angular_core.InputSignal<boolean>;
+    /** When true, renders a chevron indicator showing the menu is expandable. */
+    readonly showChevron: _angular_core.InputSignal<boolean>;
+    /** Side where the name/email info block appears relative to the avatar. */
+    readonly infoPlacement: _angular_core.InputSignal<InfoPlacement>;
+    /** Optional badge text overlaid on the avatar. */
+    readonly badge: _angular_core.InputSignal<string | null>;
+    /** When true, prevents the menu from opening. */
+    readonly disabled: _angular_core.InputSignal<boolean>;
+    /** When true, shows a loading state on the trigger. */
+    readonly loading: _angular_core.InputSignal<boolean>;
+    readonly className: _angular_core.InputSignal<string>;
+    readonly id: _angular_core.InputSignal<string | null>;
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    /** Fires when the user clicks the avatar trigger to open the menu. */
+    readonly avatarClick: _angular_core.OutputEmitterRef<void>;
+    /** Fires when the dropdown menu opens. */
+    readonly menuOpen: _angular_core.OutputEmitterRef<void>;
+    /** Fires when the dropdown menu closes. */
+    readonly menuClose: _angular_core.OutputEmitterRef<void>;
+    /** Fires when the user selects a menu item, emitting the selected `MenuItem`. */
+    readonly menuItemClick: _angular_core.OutputEmitterRef<MenuItem>;
+    /** Fires when the user selects the item with `value === "logout"`. */
+    readonly logoutClick: _angular_core.OutputEmitterRef<void>;
+    readonly dropdownRef: _angular_core.Signal<DropdownMenuComponent | undefined>;
+    readonly isOpen: _angular_core.Signal<boolean>;
+    readonly classes: _angular_core.Signal<string>;
+    get hostClass(): string;
+    get hostId(): string | null;
+    /** Emits `menuItemClick` (and `logoutClick` when applicable) for the given menu item. */
+    selectItem(item: MenuItem): void;
+    onMenuOpen(): void;
+    onMenuClose(): void;
+    /** Opens the user-menu dropdown programmatically. */
+    open(): void;
+    /** Closes the user-menu dropdown programmatically. */
+    close(): void;
+    /** Toggles the user-menu dropdown programmatically. */
+    toggle(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<UserMenuComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UserMenuComponent, "fk-user-menu", never, { "name": { "alias": "name"; "required": true; "isSignal": true; }; "email": { "alias": "email"; "required": false; "isSignal": true; }; "avatarUrl": { "alias": "avatarUrl"; "required": false; "isSignal": true; }; "initials": { "alias": "initials"; "required": false; "isSignal": true; }; "userId": { "alias": "userId"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "showStatus": { "alias": "showStatus"; "required": false; "isSignal": true; }; "menuItems": { "alias": "menuItems"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "showName": { "alias": "showName"; "required": false; "isSignal": true; }; "showEmail": { "alias": "showEmail"; "required": false; "isSignal": true; }; "showChevron": { "alias": "showChevron"; "required": false; "isSignal": true; }; "infoPlacement": { "alias": "infoPlacement"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "className": { "alias": "className"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "avatarClick": "avatarClick"; "menuOpen": "menuOpen"; "menuClose": "menuClose"; "menuItemClick": "menuItemClick"; "logoutClick": "logoutClick"; }, never, never, true, never>;
+}
+
+export { UserMenuComponent };
+export type { InfoPlacement, MenuItem, MenuPlacement, UserMenuVariant };

package/types/frame-kit-ui-ng-ui-wizard-dialog.d.ts

@@ -0,0 +1,116 @@
+import * as _angular_core from '@angular/core';
+import { Type, AfterViewInit } from '@angular/core';
+import { DialogConfig, DialogRef } from '@frame-kit/ui-ng/ui/dialog';
+import { Observable } from 'rxjs';
+
+interface WizardDialogStep {
+    /** Step title shown in the stepper. */
+    title: string;
+    /** Key to match a `<ng-template fkWizardStepContent="key">` for custom content. */
+    contentKey: string;
+    /** Whether this step is optional (shown in stepper). */
+    optional?: boolean;
+}
+interface WizardDialogConfig<TData = unknown> extends Pick<DialogConfig<TData>, 'size' | 'closable' | 'closeOnEscape' | 'closeOnBackdrop' | 'animation' | 'header' | 'fullscreenMobile' | 'className' | 'ariaLabel' | 'ariaDescribedBy' | 'data'> {
+    /** Wizard step definitions. */
+    steps: WizardDialogStep[];
+    /** Enforce sequential step navigation. Default: `true`. */
+    linear?: boolean;
+    /** Label for the final submit button. Default: `"Submit"`. */
+    submitLabel?: string;
+    /** Label for the cancel button (first step). Default: `"Cancel"`. */
+    cancelLabel?: string;
+    /** Label for the next button. Default: `"Next"`. */
+    nextLabel?: string;
+    /** Label for the back button. Default: `"Back"`. */
+    backLabel?: string;
+}
+
+/**
+ * Optional extra footer button the consumer can surface on any step
+ * — typically a "View X" jump-off on the results/last step. Sits
+ * between Back and Submit in the wizard's footer. Set via
+ * `WizardDialogRef.extraAction.set(...)` on step entry; clear with
+ * `null` on step exit (or just rely on swapping it out).
+ */
+interface WizardExtraAction {
+    /** Button label, e.g. "View Identities". */
+    label: string;
+    /** Visual variant. Defaults to `"outline"` so the extra action
+     *  doesn't compete with the primary Submit button. */
+    variant?: 'primary' | 'outline' | 'secondary' | 'danger';
+    /** Click handler — typically closes the wizard with a sentinel. */
+    onClick: () => void;
+}
+declare const WIZARD_DIALOG_REF: unique symbol;
+declare class WizardDialogRef<TResult = unknown, TData = unknown> {
+    private dialogRef;
+    private readonly consumerData;
+    private readonly submitSubject;
+    private readonly stepChangeSubject;
+    readonly steps: WizardDialogStep[];
+    readonly linear: boolean;
+    readonly submitLabel: string;
+    readonly cancelLabel: string;
+    readonly nextLabel: string;
+    readonly backLabel: string;
+    readonly currentIndex: _angular_core.WritableSignal<number>;
+    readonly highestVisitedIndex: _angular_core.WritableSignal<number>;
+    readonly totalSteps: _angular_core.Signal<number>;
+    readonly isFirstStep: _angular_core.Signal<boolean>;
+    readonly isLastStep: _angular_core.Signal<boolean>;
+    readonly currentStep: _angular_core.Signal<WizardDialogStep>;
+    readonly submitDisabled: _angular_core.WritableSignal<boolean>;
+    readonly nextDisabled: _angular_core.WritableSignal<boolean>;
+    readonly chromeVisible: _angular_core.WritableSignal<boolean>;
+    /**
+     * Optional third footer button. When non-null, the wizard chrome
+     * renders an additional `<fk-button>` between Back and Submit
+     * using this metadata. Consumers typically wire this in an
+     * `effect` keyed on `currentIndex` so the button only appears on
+     * the step(s) that need it.
+     */
+    readonly extraAction: _angular_core.WritableSignal<WizardExtraAction | null>;
+    readonly submitted: Observable<void>;
+    readonly stepChanged: Observable<number>;
+    constructor(config: WizardDialogConfig<TData>);
+    get data(): TData | undefined;
+    next(): boolean;
+    previous(): boolean;
+    goTo(index: number): boolean;
+    private updateHighestVisited;
+    close(result?: TResult): void;
+    afterClosed(): Observable<TResult | undefined>;
+    /** @internal Called by container when submit button is clicked. */
+    emitSubmit(): void;
+    /** @internal Called by WizardDialogService after dialog is opened. */
+    setDialogRef(ref: DialogRef<TResult>): void;
+}
+
+interface WizardDialogContainerData {
+    wizardRef: WizardDialogRef;
+    contentComponent: Type<unknown>;
+}
+declare class WizardDialogService {
+    private readonly dialogService;
+    open<TResult = unknown, TData = unknown>(content: Type<unknown>, config: WizardDialogConfig<TData>): WizardDialogRef<TResult, TData>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WizardDialogService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<WizardDialogService>;
+}
+
+declare class WizardDialogContainerComponent implements AfterViewInit {
+    private readonly data;
+    private readonly injector;
+    private readonly bodyOutlet;
+    readonly ref: WizardDialogRef;
+    readonly classes: _angular_core.Signal<string>;
+    get hostClass(): string;
+    ngAfterViewInit(): void;
+    onCancel(): void;
+    onSubmit(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WizardDialogContainerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WizardDialogContainerComponent, "fk-wizard-dialog-container", never, {}, {}, never, never, true, never>;
+}
+
+export { WIZARD_DIALOG_REF, WizardDialogContainerComponent, WizardDialogRef, WizardDialogService };
+export type { WizardDialogConfig, WizardDialogContainerData, WizardDialogStep, WizardExtraAction };

package/types/frame-kit-ui-ng.d.ts

@@ -0,0 +1,53 @@
+export * from '@frame-kit/ui-ng/core/headline';
+export * from '@frame-kit/ui-ng/core/icon';
+export * from '@frame-kit/ui-ng/core/image';
+export * from '@frame-kit/ui-ng/core/link';
+export * from '@frame-kit/ui-ng/core/separator';
+export * from '@frame-kit/ui-ng/core/text';
+export * from '@frame-kit/ui-ng/directives/infinite-scroll';
+export * from '@frame-kit/ui-ng/directives/spotlight';
+export * from '@frame-kit/ui-ng/directives/tooltip';
+export * from '@frame-kit/ui-ng/docs/endpoint-link';
+export * from '@frame-kit/ui-ng/docs/method-badge';
+export * from '@frame-kit/ui-ng/forms';
+export * from '@frame-kit/ui-ng/layouts/app-shell';
+export * from '@frame-kit/ui-ng/layouts/content-split';
+export * from '@frame-kit/ui-ng/services/overlay-orchestrator';
+export * from '@frame-kit/ui-ng/services/spotlight';
+export * from '@frame-kit/ui-ng/services/toast';
+export * from '@frame-kit/ui-ng/ui/accordion';
+export * from '@frame-kit/ui-ng/ui/alert';
+export * from '@frame-kit/ui-ng/ui/avatar';
+export * from '@frame-kit/ui-ng/ui/avatar-stack';
+export * from '@frame-kit/ui-ng/ui/badge';
+export * from '@frame-kit/ui-ng/ui/breadcrumb';
+export * from '@frame-kit/ui-ng/ui/button';
+export * from '@frame-kit/ui-ng/ui/callout';
+export * from '@frame-kit/ui-ng/ui/card';
+export * from '@frame-kit/ui-ng/ui/copyable-field';
+export * from '@frame-kit/ui-ng/ui/data-table';
+export * from '@frame-kit/ui-ng/ui/dialog';
+export * from '@frame-kit/ui-ng/ui/drawer';
+export * from '@frame-kit/ui-ng/ui/dropdown-menu';
+export * from '@frame-kit/ui-ng/ui/editable-field';
+export * from '@frame-kit/ui-ng/ui/icon-badge';
+export * from '@frame-kit/ui-ng/ui/icon-list';
+export * from '@frame-kit/ui-ng/ui/inline-edit';
+export * from '@frame-kit/ui-ng/ui/list-editor';
+export * from '@frame-kit/ui-ng/ui/loader';
+export * from '@frame-kit/ui-ng/ui/menu-item';
+export * from '@frame-kit/ui-ng/ui/nav-brand';
+export * from '@frame-kit/ui-ng/ui/nav-group';
+export * from '@frame-kit/ui-ng/ui/nav-separator';
+export * from '@frame-kit/ui-ng/ui/node-tree';
+export * from '@frame-kit/ui-ng/ui/node-tree-breadcrumb';
+export * from '@frame-kit/ui-ng/ui/note';
+export * from '@frame-kit/ui-ng/ui/numbered-list';
+export * from '@frame-kit/ui-ng/ui/pagination';
+export * from '@frame-kit/ui-ng/ui/progress-bar';
+export * from '@frame-kit/ui-ng/ui/sidenav-link';
+export * from '@frame-kit/ui-ng/ui/tabs';
+export * from '@frame-kit/ui-ng/ui/timeline';
+export * from '@frame-kit/ui-ng/ui/toast';
+export * from '@frame-kit/ui-ng/ui/user-menu';
+export * from '@frame-kit/ui-ng/ui/wizard-dialog';