@ojiepermana/angular 22.1.11 → 22.1.13

package/types/ojiepermana-angular-navigation.d.ts

@@ -1 +1,507 @@
-export * from '@ojiepermana/angular-navigation';
+import * as _ojiepermana_angular_navigation from '@ojiepermana/angular/navigation';
+import * as _angular_core from '@angular/core';
+import { Signal, TemplateRef } from '@angular/core';
+import { NavigationIconDirective } from '@ojiepermana/angular/navigation/icon';
+export { NavigationIconDirective } from '@ojiepermana/angular/navigation/icon';
+import { NavigationOrientation, NavigationType, NavigationPosition, NavigationDockbarMode, NavigationDockbarRouteContext, NavigationBadgeContext, NavigationAppearance, NavigationFlyoutIconPosition, NavigationFlyoutTriggerVariant, NavigationState, NavigationItem, NavigationCollapseTree, NavigationSelection, NavigationBadgeSource, NavigationNormalizedItem, NavigationResolvedRouteContext, NavigationIconContext, NavigationVerticalPosition, NavigationHorizontalPosition } from '@ojiepermana/angular/navigation/types';
+export { NAVIGATION_DOCKBAR_FALLBACK_ICON, NavigationActionHandler, NavigationAppearance, NavigationBadgeAriaLabel, NavigationBadgeContext, NavigationBadgeCount, NavigationBadgeSource, NavigationBadgeValueSource, NavigationCollapseTree, NavigationDockbarMode, NavigationDockbarRouteConfig, NavigationDockbarRouteContext, NavigationFlyoutIconPosition, NavigationFlyoutTriggerVariant, NavigationHorizontalPosition, NavigationHorizontalType, NavigationIconContext, NavigationItem, NavigationItemBadge, NavigationItemClasses, NavigationItemType, NavigationLink, NavigationNormalizedItem, NavigationNormalizedItemType, NavigationOrientation, NavigationPosition, NavigationRegisterInput, NavigationResolvedRouteContext, NavigationRouteData, NavigationSelection, NavigationState, NavigationType, NavigationVerticalPosition, NavigationVerticalType, NavigationVisibilityHandler, formatNavigationBadgeCount, normalizeUiNavItems } from '@ojiepermana/angular/navigation/types';
+export * from '@ojiepermana/angular/navigation/core';
+
+/**
+ * Konfigurasi yang didaftarkan komponen type (`<NavigationSidebar>`,
+ * `<NavigationDockbar>`, `<NavigationNavbar>`, `<NavigationFlyout>`) ke
+ * `<Navigation>` induknya. Satu `<Navigation>` hanya boleh memuat satu
+ * type hidup pada satu waktu.
+ */
+interface NavigationTypeConfig {
+    readonly orientation: NavigationOrientation;
+    readonly type: NavigationType;
+    readonly position?: Signal<NavigationPosition | null>;
+    readonly collapsed?: Signal<boolean | null>;
+    readonly dockbarMode?: Signal<NavigationDockbarMode | null>;
+    /** Opt-in route context dan registry badge khusus dockbar. */
+    readonly dockbarRouteContext?: Signal<NavigationDockbarRouteContext | null>;
+    readonly dockbarBadgeContext?: Signal<NavigationBadgeContext>;
+    /** Header route bawaan hanya terlihat bila consumer tidak memproyeksikan header sendiri. */
+    readonly dockbarRouteHeaderVisible?: Signal<boolean>;
+    /** Template footer aside dockbar (slot `ng-template[NavigationAsideFooter]`). */
+    readonly dockbarAsideFooter?: Signal<TemplateRef<unknown> | null>;
+    readonly sidebarCollapse?: Signal<boolean>;
+    readonly previewExpanded?: Signal<boolean>;
+    readonly typeStyle?: Signal<NavigationAppearance>;
+    readonly flyoutLabel?: Signal<string>;
+    /** Nama Material Symbols untuk trigger flyout; `null` = tanpa ikon (label saja). */
+    readonly flyoutIcon?: Signal<string | null>;
+    /** Trigger flyout hanya ikon — label pindah ke aria-label/title. */
+    readonly flyoutIconOnly?: Signal<boolean>;
+    /** Penempatan ikon relatif terhadap label trigger flyout. */
+    readonly flyoutIconPosition?: Signal<NavigationFlyoutIconPosition>;
+    /** Bentuk visual tombol trigger flyout: `button` (pil) | `link` | `plain` (ghost). */
+    readonly flyoutTriggerVariant?: Signal<NavigationFlyoutTriggerVariant>;
+    /** Trigger flyout mengambang (`fixed`) alih-alih mengalir di dalam bar/div. */
+    readonly flyoutTriggerFloating?: Signal<boolean>;
+    /** Panel floating menutup dari batas atas viewport dan memakai lebar viewport penuh. */
+    readonly flyoutPanelViewport?: Signal<boolean>;
+    /** Kelas Tailwind tambahan untuk host trigger flyout (posisi pojok floating / override wrapper). */
+    readonly flyoutTriggerClass?: Signal<string>;
+    /** Kelas tambahan khusus tombol trigger flyout. */
+    readonly flyoutTriggerButtonClass?: Signal<string>;
+}
+
+interface NavigationShellContext {
+    readonly state: Signal<NavigationState>;
+    readonly displayState: Signal<NavigationState>;
+    readonly collapseEnabled: Signal<boolean>;
+    toggleCollapsed(): void;
+}
+
+interface NavigationDockbarRouteHeaderState {
+    readonly activeEntry: NavigationNormalizedItem | null;
+    readonly panelGroup: NavigationNormalizedItem | null;
+    readonly icon: string;
+    readonly label: string;
+    readonly badge: NavigationBadgeSource | null;
+    readonly badgeClass: string;
+    readonly iconContext: NavigationIconContext;
+}
+/**
+ * Container navigasi deklaratif. Type ditentukan oleh komponen anak:
+ *
+ * ```html
+ * <Navigation id="main" [data]="items">
+ *   <NavigationSidebar>
+ *     <NavigationHeader>…</NavigationHeader>
+ *     <NavigationContent />
+ *     <NavigationFooter>…</NavigationFooter>
+ *   </NavigationSidebar>
+ * </Navigation>
+ * ```
+ *
+ * Header dan footer opsional; `NavigationContent` selalu dirender oleh
+ * type (default otomatis bila tidak diproyeksikan).
+ */
+declare class NavigationContainerComponent implements NavigationShellContext {
+    readonly navId: _angular_core.InputSignal<string>;
+    /** Id data publik dapat dipisahkan dari id state. Berguna untuk mirror mobile tanpa berbagi persistence state. */
+    readonly dataId: _angular_core.InputSignal<string | null>;
+    readonly data: _angular_core.InputSignal<readonly NavigationItem[]>;
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    readonly compact: _angular_core.InputSignal<boolean>;
+    readonly collapseTree: _angular_core.InputSignal<NavigationCollapseTree>;
+    readonly class: _angular_core.InputSignal<string>;
+    readonly itemClass: _angular_core.InputSignal<string>;
+    /** Kelas Tailwind untuk container `<li>` group horizontal (flyout tab / navbar group). */
+    readonly groupClass: _angular_core.InputSignal<string>;
+    readonly activeIds: _angular_core.InputSignal<ReadonlySet<string> | readonly string[] | null>;
+    readonly activeUrl: _angular_core.InputSignal<string | null>;
+    readonly openedIds: _angular_core.ModelSignal<readonly string[]>;
+    readonly itemSelected: _angular_core.OutputEmitterRef<NavigationSelection>;
+    private readonly nav;
+    private readonly routeContextAdapter;
+    private readonly activatedRoute;
+    private readonly dataOwner;
+    private readonly hoverPreviewExpanded;
+    /**
+     * Keyboard twin of the hover preview: a collapsed rail hides the children of
+     * every collapsible, so without this the only way into a nested route is a
+     * pointer hovering the rail.
+     */
+    private readonly focusPreviewExpanded;
+    /** Konfigurasi type aktif yang didaftarkan wrapper anak (sidebar/dockbar/navbar/flyout). */
+    private readonly typeConfig;
+    private readonly orientationPreference;
+    private readonly typePreference;
+    private readonly positionPreference;
+    private readonly collapsedPreference;
+    private readonly dockbarModePreference;
+    private readonly dockbarRouteContextPreference;
+    readonly dockbarBadgeContext: _angular_core.Signal<Readonly<Record<string, NavigationBadgeSource>>>;
+    readonly dockbarRouteHeaderVisible: _angular_core.Signal<boolean>;
+    /** Template footer aside dockbar dari slot `ng-template[NavigationAsideFooter]`. */
+    readonly dockbarAsideFooter: _angular_core.Signal<_angular_core.TemplateRef<unknown> | null>;
+    private readonly sidebarCollapse;
+    private readonly previewExpanded;
+    readonly typeStyle: _angular_core.Signal<_ojiepermana_angular_navigation.NavigationAppearance>;
+    readonly flyoutLabel: _angular_core.Signal<string>;
+    readonly flyoutIcon: _angular_core.Signal<string | null>;
+    readonly flyoutIconOnly: _angular_core.Signal<boolean>;
+    readonly flyoutIconPosition: _angular_core.Signal<_ojiepermana_angular_navigation.NavigationFlyoutIconPosition>;
+    readonly flyoutTriggerVariant: _angular_core.Signal<_ojiepermana_angular_navigation.NavigationFlyoutTriggerVariant>;
+    readonly flyoutTriggerFloating: _angular_core.Signal<boolean>;
+    readonly flyoutPanelViewport: _angular_core.Signal<boolean>;
+    readonly flyoutTriggerClass: _angular_core.Signal<string>;
+    readonly flyoutTriggerButtonClass: _angular_core.Signal<string>;
+    private readonly controller;
+    readonly iconTemplate: _angular_core.Signal<NavigationIconDirective | undefined>;
+    readonly normalizedItems: _angular_core.Signal<readonly NavigationNormalizedItem[]>;
+    readonly resolvedState: _angular_core.Signal<_ojiepermana_angular_navigation.NavigationState>;
+    readonly activeIdSet: _angular_core.Signal<ReadonlySet<string>>;
+    readonly dockbarRouteEnabled: _angular_core.Signal<boolean>;
+    readonly dockbarResolvedRouteContext: _angular_core.Signal<NavigationResolvedRouteContext>;
+    readonly dockbarActiveRouteEntry: _angular_core.Signal<NavigationNormalizedItem | null>;
+    readonly dockbarResolvedActiveIds: _angular_core.Signal<ReadonlySet<string>>;
+    readonly dockbarActiveRoutePanelGroup: _angular_core.Signal<NavigationNormalizedItem | null>;
+    readonly dockbarRouteHeader: _angular_core.Signal<NavigationDockbarRouteHeaderState | null>;
+    readonly dockbarRailItems: _angular_core.Signal<readonly NavigationNormalizedItem[]>;
+    readonly dockbarAsideId: _angular_core.Signal<string>;
+    readonly dockbarOpenGroup: _angular_core.Signal<NavigationNormalizedItem | null>;
+    readonly dockbarActiveRoutePanelExpanded: _angular_core.Signal<boolean>;
+    readonly previewRailExpanded: _angular_core.Signal<boolean>;
+    readonly previewRailOffset: _angular_core.Signal<"calc(var(--layout-sidebar-width) - var(--layout-sidebar-collapsed-width))" | "0px">;
+    readonly displayState: _angular_core.Signal<_ojiepermana_angular_navigation.NavigationState>;
+    readonly dockbarAsideOpen: _angular_core.Signal<boolean>;
+    readonly collapseEnabled: _angular_core.Signal<boolean>;
+    /** Kelas shell yang dipakai host komponen type (eks `div` shell internal). */
+    readonly shellClasses: _angular_core.Signal<string>;
+    readonly state: _angular_core.Signal<_ojiepermana_angular_navigation.NavigationState>;
+    readonly resolvedDataId: _angular_core.Signal<string>;
+    protected readonly hostClasses: _angular_core.Signal<string>;
+    constructor();
+    /**
+     * Dipanggil komponen type saat dibuat. Satu `<Navigation>` hanya boleh
+     * memuat satu type hidup — pendaftaran ganda dianggap salah konfigurasi.
+     */
+    registerType(config: NavigationTypeConfig): void;
+    unregisterType(config: NavigationTypeConfig): void;
+    toggleCollapsed(): void;
+    toggleDockbarActiveRoutePanel(): void;
+    closeDockbarPanel(): boolean;
+    restoreDockbarRoutePanel(): void;
+    protected setHoverPreview(value: boolean): void;
+    protected setFocusPreview(value: boolean, event?: FocusEvent): void;
+    private dockbarRouteConfig;
+    private cleanString;
+    private safeId;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationContainerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationContainerComponent, "Navigation", never, { "navId": { "alias": "id"; "required": false; "isSignal": true; }; "dataId": { "alias": "data-id"; "required": false; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "collapseTree": { "alias": "collapse-tree"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; "itemClass": { "alias": "itemClass"; "required": false; "isSignal": true; }; "groupClass": { "alias": "nav-group-class"; "required": false; "isSignal": true; }; "activeIds": { "alias": "activeIds"; "required": false; "isSignal": true; }; "activeUrl": { "alias": "activeUrl"; "required": false; "isSignal": true; }; "openedIds": { "alias": "openedIds"; "required": false; "isSignal": true; }; }, { "openedIds": "openedIdsChange"; "itemSelected": "itemSelected"; }, ["iconTemplate"], ["*"], true, never>;
+}
+
+/**
+ * Area konten navigasi: merender daftar item sesuai type aktif dari
+ * `<Navigation>` induk. Selalu hadir di setiap type — komponen type
+ * merender default-nya bila consumer tidak memproyeksikan `<NavigationContent />`.
+ */
+declare class NavigationContentComponent {
+    protected readonly container: NavigationContainerComponent;
+    readonly class: _angular_core.InputSignal<string>;
+    protected readonly hostClasses: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationContentComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationContentComponent, "NavigationContent", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, ["NavigationHeader", "NavigationFooter"], true, never>;
+}
+
+declare class NavigationFooterComponent {
+    private readonly shell;
+    readonly class: _angular_core.InputSignal<string>;
+    protected readonly isHorizontal: _angular_core.Signal<boolean>;
+    protected readonly displayCollapsed: _angular_core.Signal<boolean>;
+    /**
+     * Baris isi footer. Saat collapsed/dockbar (vertical) isi (inisial user) dipusatkan
+     * di tengah rail agar simetris dengan `NavigationHeader` dan ikon nav-item; selain
+     * itu rata kiri dengan `gap-3` (padding diserahkan consumer, mis. `px-3`).
+     */
+    protected readonly rowClasses: _angular_core.Signal<string>;
+    protected readonly hostClasses: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationFooterComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationFooterComponent, "NavigationFooter", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+declare class NavigationHeaderComponent {
+    private readonly shell;
+    readonly toggle: _angular_core.InputSignal<boolean>;
+    readonly class: _angular_core.InputSignal<string>;
+    protected readonly collapsed: _angular_core.Signal<boolean>;
+    protected readonly displayCollapsed: _angular_core.Signal<boolean>;
+    protected readonly isHorizontal: _angular_core.Signal<boolean>;
+    /**
+     * The toggle used to disappear once the rail collapsed, which left the
+     * collapsed rail with no control that could expand it again — nested items
+     * below a collapsible were then reachable by hover only.
+     */
+    protected readonly showToggle: _angular_core.Signal<boolean>;
+    protected readonly toggleAriaLabel: _angular_core.Signal<"Expand navigation" | "Collapse navigation">;
+    protected readonly toggleIconName: _angular_core.Signal<"left_panel_open" | "left_panel_close">;
+    /**
+     * Baris isi header. Saat collapsed/dockbar (vertical) isi (inisial/ikon) dipusatkan di tengah
+     * rail agar simetris dengan ikon nav-item di bawahnya (yang juga center di rail); selain itu kiri
+     * dengan padding `px-3`.
+     */
+    protected readonly rowClasses: _angular_core.Signal<string>;
+    protected readonly contentClasses: _angular_core.Signal<"flex min-w-0 items-center gap-3" | "flex min-w-0 items-center justify-center" | "flex min-w-0 flex-1 items-center gap-3">;
+    protected readonly hostClasses: _angular_core.Signal<string>;
+    protected toggleCollapsed(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationHeaderComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationHeaderComponent, "NavigationHeader", never, { "toggle": { "alias": "toggle"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Type sidebar vertikal untuk `<Navigation>`. Slot `NavigationHeader` dan
+ * `NavigationFooter` opsional; `NavigationContent` selalu dirender (default
+ * otomatis bila tidak diproyeksikan).
+ */
+declare class NavigationSidebarComponent {
+    private readonly container;
+    private readonly destroyRef;
+    readonly position: _angular_core.InputSignal<NavigationVerticalPosition | null>;
+    readonly collapsed: _angular_core.InputSignal<boolean | null>;
+    readonly collapse: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly previewExpanded: _angular_core.InputSignal<boolean>;
+    readonly class: _angular_core.InputSignal<string>;
+    protected readonly headerSlot: _angular_core.Signal<NavigationHeaderComponent | undefined>;
+    protected readonly contentSlot: _angular_core.Signal<NavigationContentComponent | undefined>;
+    protected readonly footerSlot: _angular_core.Signal<NavigationFooterComponent | undefined>;
+    protected readonly hostClasses: _angular_core.Signal<string>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationSidebarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationSidebarComponent, "NavigationSidebar", never, { "position": { "alias": "position"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "collapse": { "alias": "nav-sidebar-collapse"; "required": false; "isSignal": true; }; "previewExpanded": { "alias": "previewExpanded"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, ["headerSlot", "contentSlot", "footerSlot"], ["NavigationHeader", "NavigationContent", "NavigationFooter"], true, never>;
+}
+
+/**
+ * Slot footer untuk aside dockbar. Proyeksikan sebagai `ng-template` di dalam
+ * `<NavigationDockbar>`; dirender di dasar aside (h-12, border-t) setiap kali
+ * panel group terbuka — baik mode `sticky` maupun `drawer`.
+ *
+ * ```html
+ * <NavigationDockbar>
+ *   <NavigationFooter>…rail…</NavigationFooter>
+ *   <ng-template NavigationAsideFooter>…identitas user + aksi…</ng-template>
+ * </NavigationDockbar>
+ * ```
+ *
+ * Berbeda dengan `NavigationFooter` (kolom rail, selalu collapsed pada dockbar),
+ * isi template ini tampil dalam konteks lebar penuh aside — cocok untuk nama +
+ * email + tombol aksi seperti footer sidebar expanded.
+ */
+declare class NavigationAsideFooterDirective {
+    readonly templateRef: TemplateRef<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationAsideFooterDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NavigationAsideFooterDirective, "ng-template[NavigationAsideFooter]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Type dockbar vertikal (rail ikon + aside) untuk `<Navigation>`. Slot
+ * `NavigationHeader` dan `NavigationFooter` opsional; `NavigationContent`
+ * selalu dirender (default otomatis bila tidak diproyeksikan). Slot
+ * `ng-template[NavigationAsideFooter]` opsional — dirender sebagai footer di
+ * dasar aside saat panel group terbuka.
+ */
+declare class NavigationDockbarComponent {
+    protected readonly container: NavigationContainerComponent;
+    private readonly destroyRef;
+    private readonly host;
+    private readonly injector;
+    readonly mode: _angular_core.InputSignal<NavigationDockbarMode | null>;
+    readonly position: _angular_core.InputSignal<NavigationVerticalPosition | null>;
+    readonly routeContext: _angular_core.InputSignal<NavigationDockbarRouteContext | null>;
+    readonly badgeContext: _angular_core.InputSignal<Readonly<Record<string, _ojiepermana_angular_navigation.NavigationBadgeSource>>>;
+    readonly class: _angular_core.InputSignal<string>;
+    protected readonly headerSlot: _angular_core.Signal<NavigationHeaderComponent | undefined>;
+    protected readonly contentSlot: _angular_core.Signal<NavigationContentComponent | undefined>;
+    protected readonly footerSlot: _angular_core.Signal<NavigationFooterComponent | undefined>;
+    protected readonly asideFooterSlot: _angular_core.Signal<NavigationAsideFooterDirective | undefined>;
+    private readonly routeContextEnabled;
+    protected readonly hostClasses: _angular_core.Signal<string>;
+    constructor();
+    protected onPointerOut(event: PointerEvent): void;
+    protected onEscape(event: Event): void;
+    protected toggleActiveRoutePanel(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationDockbarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationDockbarComponent, "NavigationDockbar", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "routeContext": { "alias": "dockbar-route-context"; "required": false; "isSignal": true; }; "badgeContext": { "alias": "dockbar-badge"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, ["headerSlot", "contentSlot", "footerSlot", "asideFooterSlot"], ["NavigationHeader", "NavigationContent", "NavigationFooter"], true, never>;
+}
+
+/**
+ * Type navbar horizontal untuk `<Navigation>`. Slot `NavigationHeader`
+ * dan `NavigationFooter` opsional; `NavigationContent` selalu dirender
+ * (default otomatis bila tidak diproyeksikan).
+ */
+declare class NavigationNavbarComponent {
+    private readonly container;
+    private readonly destroyRef;
+    /** Posisi bar terhadap konten layout: `top` (default) atau `bottom` — panel grid membuka ke arah sebaliknya. */
+    readonly position: _angular_core.InputSignal<NavigationHorizontalPosition | null>;
+    readonly typeStyle: _angular_core.InputSignal<NavigationAppearance>;
+    readonly class: _angular_core.InputSignal<string>;
+    protected readonly headerSlot: _angular_core.Signal<NavigationHeaderComponent | undefined>;
+    protected readonly contentSlot: _angular_core.Signal<NavigationContentComponent | undefined>;
+    protected readonly footerSlot: _angular_core.Signal<NavigationFooterComponent | undefined>;
+    protected readonly hostClasses: _angular_core.Signal<string>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationNavbarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationNavbarComponent, "NavigationNavbar", never, { "position": { "alias": "nav-position"; "required": false; "isSignal": true; }; "typeStyle": { "alias": "nav-type-style"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, ["headerSlot", "contentSlot", "footerSlot"], ["NavigationHeader", "NavigationContent", "NavigationFooter"], true, never>;
+}
+
+/**
+ * Type flyout horizontal (trigger + panel menu) untuk `<Navigation>`.
+ * Slot `NavigationHeader` dan `NavigationFooter` opsional; `NavigationContent`
+ * selalu dirender (default otomatis bila tidak diproyeksikan).
+ */
+declare class NavigationFlyoutComponent {
+    private readonly container;
+    private readonly destroyRef;
+    readonly label: _angular_core.InputSignal<string>;
+    /** Nama Material Symbols untuk trigger (mis. `apps`, `menu`); `null` = label saja. */
+    readonly icon: _angular_core.InputSignal<string | null>;
+    /** Trigger hanya menampilkan ikon; label tetap dipakai sebagai aria-label/title. */
+    readonly iconOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Penempatan ikon relatif terhadap label: `start` (default) atau `end`. */
+    readonly iconPosition: _angular_core.InputSignal<NavigationFlyoutIconPosition>;
+    /** Bentuk visual tombol trigger: `button` (pil, default) | `link` | `plain` (ghost). */
+    readonly triggerVariant: _angular_core.InputSignal<NavigationFlyoutTriggerVariant>;
+    /**
+     * Trigger mengambang (`fixed`) alih-alih mengalir di dalam bar/div. Default pojok kanan-atas;
+     * pakai `trigger-class` untuk pindah pojok (mis. `bottom-6 right-6 top-auto`).
+     *
+     * Catatan: `position: fixed` ber-anchor ke viewport HANYA bila tak ada ancestor pembentuk
+     * containing block. Di dalam `<Layout>` (frame-nya memakai `backdrop-blur`), trigger ber-anchor
+     * ke kotak konten frame (bukan viewport sebenarnya) dan bisa ter-clip oleh frame `overflow-hidden`.
+     * Untuk floating sebenar-viewport, tempatkan `<Navigation>` flyout di luar frame `<Layout>`.
+     */
+    readonly triggerFloating: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Saat trigger floating dibuka, tempelkan panel ke batas atas viewport dan
+     * bentangkan sepanjang viewport. Dipakai window chrome; default popover tetap
+     * menempel ke trigger.
+     */
+    readonly panelViewport: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Kelas Tailwind untuk host trigger (posisi pojok floating / styling wrapper saat in-flow). */
+    readonly triggerClass: _angular_core.InputSignal<string>;
+    /** Kelas tambahan khusus tombol trigger, tanpa memengaruhi host atau item di dalam panel. */
+    readonly triggerButtonClass: _angular_core.InputSignal<string>;
+    /** Posisi bar terhadap konten layout: `top` (default) atau `bottom` — panel membuka ke arah sebaliknya. */
+    readonly position: _angular_core.InputSignal<NavigationHorizontalPosition | null>;
+    readonly typeStyle: _angular_core.InputSignal<NavigationAppearance>;
+    readonly class: _angular_core.InputSignal<string>;
+    protected readonly hostClasses: _angular_core.Signal<string>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationFlyoutComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationFlyoutComponent, "NavigationFlyout", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "iconOnly": { "alias": "icon-only"; "required": false; "isSignal": true; }; "iconPosition": { "alias": "icon-position"; "required": false; "isSignal": true; }; "triggerVariant": { "alias": "trigger-variant"; "required": false; "isSignal": true; }; "triggerFloating": { "alias": "trigger-floating"; "required": false; "isSignal": true; }; "panelViewport": { "alias": "panel-viewport"; "required": false; "isSignal": true; }; "triggerClass": { "alias": "trigger-class"; "required": false; "isSignal": true; }; "triggerButtonClass": { "alias": "trigger-button-class"; "required": false; "isSignal": true; }; "position": { "alias": "nav-position"; "required": false; "isSignal": true; }; "typeStyle": { "alias": "nav-type-style"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, ["NavigationHeader", "NavigationFooter"], true, never>;
+}
+
+declare class NavigationCollapseRootDirective {
+    private readonly shell;
+    protected readonly collapseEnabled: _angular_core.Signal<boolean>;
+    protected readonly displayCollapsed: _angular_core.Signal<boolean>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationCollapseRootDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NavigationCollapseRootDirective, "[NavigationCollapseRoot]", never, {}, {}, never, never, true, never>;
+}
+declare class NavigationCollapseExpandedDirective {
+    private readonly shell;
+    private readonly templateRef;
+    private readonly viewContainer;
+    private hasView;
+    private readonly shouldRender;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationCollapseExpandedDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NavigationCollapseExpandedDirective, "[NavigationCollapseExpanded]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Slot aksi di sisi kanan `NavigationFooter`. Selalu didorong ke kanan (`ml-auto`),
+ * rata tengah vertikal, dengan jarak antar-child otomatis (`gap`). Isi bebas dengan
+ * ikon, button, atau teks — mis. tombol logout.
+ *
+ * Otomatis disembunyikan saat sidebar vertical sedang collapsed (rail icon-only)
+ * agar tidak overflow; konsisten dengan `NavigationFooterTitle`.
+ */
+declare class NavigationFooterActionComponent {
+    private readonly shell;
+    readonly class: _angular_core.InputSignal<string>;
+    protected readonly collapsed: _angular_core.Signal<boolean>;
+    protected readonly hostClasses: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationFooterActionComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationFooterActionComponent, "NavigationFooterAction", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Blok avatar/inisial untuk slot `NavigationFooter` (profil user). Sama seperti
+ * `NavigationHeaderInitial` dengan bentuk identitas yang seragam (rounded-md).
+ * Consumer cukup memberi `name`; inisial diturunkan otomatis. Beri `src` untuk
+ * foto, `icon` untuk material symbol, atau `initials` untuk override.
+ *
+ * Tetap tampil saat sidebar collapsed; pasangannya `NavigationFooterTitle` yang
+ * menyembunyikan diri.
+ */
+declare class NavigationFooterInitialComponent {
+    readonly name: _angular_core.InputSignal<string>;
+    readonly src: _angular_core.InputSignal<string | null>;
+    readonly initials: _angular_core.InputSignal<string | null>;
+    readonly icon: _angular_core.InputSignal<string | null>;
+    readonly class: _angular_core.InputSignal<string>;
+    private readonly view;
+    protected readonly resolvedInitials: _angular_core.Signal<string>;
+    protected readonly hostClasses: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationFooterInitialComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationFooterInitialComponent, "NavigationFooterInitial", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "src": { "alias": "src"; "required": false; "isSignal": true; }; "initials": { "alias": "initials"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Judul + subjudul untuk slot `NavigationFooter` (mis. nama + email user).
+ * Otomatis disembunyikan saat sidebar vertical sedang collapsed (rail icon-only)
+ * dengan membaca `NAVIGATION_SHELL`.
+ */
+declare class NavigationFooterTitleComponent {
+    private readonly shell;
+    readonly title: _angular_core.InputSignal<string>;
+    readonly subtitle: _angular_core.InputSignal<string | null>;
+    readonly class: _angular_core.InputSignal<string>;
+    protected readonly collapsed: _angular_core.Signal<boolean>;
+    protected readonly hostClasses: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationFooterTitleComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationFooterTitleComponent, "NavigationFooterTitle", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Blok avatar/inisial untuk slot `NavigationHeader` (brand/logo). Consumer cukup
+ * memberi `name`; inisial diturunkan otomatis ("Ojie Permana" → "OP"). Beri `src`
+ * untuk gambar, `icon` (material symbol) sebagai ganti inisial, atau `initials`
+ * untuk override manual.
+ *
+ * Selalu tampil baik saat sidebar expanded maupun collapsed karena ukurannya muat
+ * di rail icon-only — pasangannya, `NavigationHeaderTitle`, yang menyembunyikan
+ * diri saat collapsed.
+ */
+declare class NavigationHeaderInitialComponent {
+    readonly name: _angular_core.InputSignal<string>;
+    readonly src: _angular_core.InputSignal<string | null>;
+    readonly initials: _angular_core.InputSignal<string | null>;
+    readonly icon: _angular_core.InputSignal<string | null>;
+    /** Use the rail icon token when the header is rendered in compact navigation. */
+    readonly compact: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly class: _angular_core.InputSignal<string>;
+    private readonly view;
+    protected readonly resolvedInitials: _angular_core.Signal<string>;
+    protected readonly iconClasses: _angular_core.Signal<string>;
+    protected readonly hostClasses: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationHeaderInitialComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationHeaderInitialComponent, "NavigationHeaderInitial", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "src": { "alias": "src"; "required": false; "isSignal": true; }; "initials": { "alias": "initials"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Judul + subjudul untuk slot `NavigationHeader`. Otomatis disembunyikan saat
+ * sidebar vertical sedang collapsed (rail icon-only) dengan membaca
+ * `NAVIGATION_SHELL` — consumer tidak perlu mengelola state collapse sendiri.
+ */
+declare class NavigationHeaderTitleComponent {
+    private readonly shell;
+    readonly title: _angular_core.InputSignal<string>;
+    readonly subtitle: _angular_core.InputSignal<string | null>;
+    readonly class: _angular_core.InputSignal<string>;
+    protected readonly collapsed: _angular_core.Signal<boolean>;
+    protected readonly hostClasses: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationHeaderTitleComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationHeaderTitleComponent, "NavigationHeaderTitle", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Turunkan inisial ringkas dari sebuah nama untuk avatar fallback.
+ *
+ *   "Ojie Permana" → "OP"
+ *   "Ojiepermana"  → "OJ"
+ *   ""             → ""
+ *
+ * Mengambil huruf depan kata pertama dan kata terakhir; bila hanya satu kata,
+ * memakai dua huruf pertamanya.
+ */
+declare function deriveNavigationInitials(name: string): string;
+
+export { NavigationAsideFooterDirective, NavigationCollapseExpandedDirective, NavigationCollapseRootDirective, NavigationContainerComponent, NavigationContentComponent, NavigationDockbarComponent, NavigationFlyoutComponent, NavigationFooterActionComponent, NavigationFooterComponent, NavigationFooterInitialComponent, NavigationFooterTitleComponent, NavigationHeaderComponent, NavigationHeaderInitialComponent, NavigationHeaderTitleComponent, NavigationNavbarComponent, NavigationSidebarComponent, deriveNavigationInitials };
+export type { NavigationTypeConfig };

package/types/ojiepermana-angular-sdk.d.ts

@@ -1 +1,89 @@
-export * from '@ojiepermana/angular-sdk';
+/**
+ * Public config shape for the SDK generator.
+ *
+ * Users place an `sdk.config.json` at the workspace root describing one or more
+ * generation targets. All paths are resolved relative to the workspace root
+ * (i.e. the directory containing the config file).
+ */
+type SdkOutputMode = 'standalone' | 'library' | 'secondary-entrypoint';
+interface SdkFeatureFlags {
+    /** Emit `models/*.ts` (type-only DTO interfaces). Default `true`. */
+    models?: boolean;
+    /** Emit tree-shakeable operation functions in `fn/<tag>/*.ts`. Default `true`. */
+    operations?: boolean;
+    /** Emit grouped Angular Service classes per tag. Default `true`. */
+    services?: boolean;
+    /** Emit the runtime client primitives (ApiConfiguration, BaseService, etc). Default `true`. */
+    client?: boolean;
+    /** Emit operation rules + field validators + permission helpers. Default `true`. */
+    metadata?: boolean;
+    /** Emit navigation tree derived from tags (parent, x-icon). Default `true`. */
+    navigation?: boolean;
+    /** Emit Signal-based resource helpers using rxResource(). Default `false`. */
+    resources?: boolean;
+}
+interface SdkTargetConfig {
+    /** Path to OpenAPI 3.x spec (YAML or JSON). Required. */
+    input: string;
+    /** Output directory (relative to workspace root). Required. */
+    output: string;
+    /** Output mode. Defaults to `"standalone"`. */
+    mode?: SdkOutputMode;
+    /** Optional human-readable name used for logs & the generated `Api` class. */
+    clientName?: string;
+    /** Package name used when `mode === "library"`. */
+    packageName?: string;
+    /** Package version used when `mode === "library"`. Defaults to `0.0.1`. */
+    packageVersion?: string;
+    /** Default rootUrl baked into ApiConfiguration. Defaults to an empty string for same-origin requests. */
+    rootUrl?: string;
+    /** Feature toggles. Every feature defaults to `true` except `resources` (default `false`). */
+    features?: SdkFeatureFlags;
+    /**
+     * When `true`, reorganize emitted files into one folder per domain (derived
+     * from OpenAPI tags). Models shared by multiple domains live in `shared/`,
+     * domain-owned models live inside each domain. Defaults to `true` for
+     * `mode: "library"` and `false` otherwise.
+     */
+    splitByDomain?: boolean;
+    /**
+     * Granularity of `splitByDomain`. Only meaningful when `splitByDomain` is
+     * `true`. `'service'` (default) groups every tag under its root parent — one
+     * folder per backend service (e.g. all Role/Permission/... tags collapse into
+     * `access/`). `'tag'` emits one folder per leaf tag, nested under the parent
+     * chain (e.g. `storage/gcs/`, `storage/s3/`, `access/role/`).
+     */
+    splitDepth?: 'service' | 'tag';
+    /** Custom file banner. Defaults to a short auto-generated notice. */
+    banner?: string;
+}
+interface SdkConfig {
+    targets: SdkTargetConfig[];
+}
+interface ResolvedFeatureFlags {
+    models: boolean;
+    operations: boolean;
+    services: boolean;
+    client: boolean;
+    metadata: boolean;
+    navigation: boolean;
+    resources: boolean;
+}
+interface ResolvedSdkTarget {
+    input: string;
+    output: string;
+    mode: SdkOutputMode;
+    clientName: string;
+    packageName: string;
+    packageVersion: string;
+    rootUrl: string | undefined;
+    features: ResolvedFeatureFlags;
+    splitByDomain: boolean;
+    splitDepth: 'service' | 'tag';
+    banner: string;
+}
+declare function resolveTarget(raw: SdkTargetConfig): ResolvedSdkTarget;
+declare function resolveConfig(raw: unknown): ResolvedSdkTarget[];
+
+export { resolveConfig, resolveTarget };
+export type { ResolvedFeatureFlags, ResolvedSdkTarget, SdkConfig, SdkFeatureFlags, SdkOutputMode, SdkTargetConfig };