@ojiepermana/angular 21.2.4 → 21.3.3

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

@@ -1,393 +0,0 @@
-import * as _angular_core from '@angular/core';
-import { Params, QueryParamsHandling, IsActiveMatchOptions } from '@angular/router';
-import { ClassValue } from 'clsx';
-
-type NavigationItemType = 'aside' | 'basic' | 'collapsable' | 'divider' | 'group' | 'mega' | 'spacer';
-interface NavigationItemClasses {
-    title?: string;
-    subtitle?: string;
-    icon?: string;
-    wrapper?: string;
-}
-interface NavigationItemBadge {
-    title?: string;
-    classes?: string;
-}
-type NavigationVisibilityHandler = (item: NavigationItem) => boolean;
-type NavigationActionHandler = (item: NavigationItem) => void;
-interface NavigationItemBase {
-    /** Unique identifier untuk item navigasi */
-    id?: string;
-    /** Judul/label yang ditampilkan */
-    title?: string;
-    /** Subtitle/deskripsi tambahan */
-    subtitle?: string;
-    /** Status aktif item */
-    active?: boolean;
-    /** Status disabled item */
-    disabled?: boolean;
-    /** Tooltip text saat hover */
-    tooltip?: string;
-    /** Custom CSS classes */
-    classes?: NavigationItemClasses;
-    /** Material Symbols icon name (ligature, e.g. `dashboard`, `menu_book`) */
-    icon?: string;
-    /** Badge configuration */
-    badge?: NavigationItemBadge;
-    /** Additional metadata */
-    meta?: Record<string, unknown>;
-    /** Function untuk hide/show item secara dinamis */
-    isHidden?: NavigationVisibilityHandler;
-}
-interface NavigationRoutableItemBase extends NavigationItemBase {
-    /** Angular router link */
-    link?: string;
-    /** URL fragment (#anchor) */
-    fragment?: string;
-    /** Preserve fragment saat navigasi */
-    preserveFragment?: boolean;
-    /** Query parameters untuk routing */
-    queryParams?: Params | null;
-    /** Cara handle query params */
-    queryParamsHandling?: QueryParamsHandling | null;
-    /** Flag untuk external link */
-    externalLink?: boolean;
-    /** Target untuk external link */
-    target?: '_blank' | '_self' | '_parent' | '_top' | string;
-    /** Exact match untuk active route */
-    exactMatch?: boolean;
-    /** Options untuk active match detection */
-    isActiveMatchOptions?: IsActiveMatchOptions;
-    /** Custom action yang dipanggil saat item diklik */
-    action?: NavigationActionHandler;
-}
-interface NavigationBasicItem extends NavigationRoutableItemBase {
-    type: 'basic';
-    children?: never;
-}
-interface NavigationAsideItem extends NavigationRoutableItemBase {
-    type: 'aside';
-    children: NavigationItem[];
-}
-interface NavigationCollapsableItem extends NavigationRoutableItemBase {
-    type: 'collapsable';
-    children: NavigationItem[];
-}
-interface NavigationGroupItem extends NavigationItemBase {
-    type: 'group';
-    children: NavigationItem[];
-}
-/**
- * Mega menu branch — dirender sebagai panel full-width multi-kolom pada topbar.
- * Children biasanya berupa `NavigationGroupItem` (per kolom) berisi `basic` items.
- */
-interface NavigationMegaItem extends NavigationItemBase {
-    type: 'mega';
-    /** Jumlah kolom saat viewport >= md (default: 4) */
-    columns?: number;
-    children: NavigationItem[];
-}
-interface NavigationDividerItem extends NavigationItemBase {
-    type: 'divider';
-    children?: never;
-}
-interface NavigationSpacerItem extends NavigationItemBase {
-    type: 'spacer';
-    children?: never;
-}
-type NavigationBranchItem = NavigationAsideItem | NavigationCollapsableItem | NavigationGroupItem | NavigationMegaItem;
-type NavigationLeafItem = NavigationBasicItem | NavigationDividerItem | NavigationSpacerItem;
-type NavigationItem = NavigationBranchItem | NavigationLeafItem;
-/**
- * Navigation Item Interface
- *
- * Interface ini mendefinisikan struktur data untuk setiap item navigasi
- * Mendukung berbagai tipe item dan konfigurasi routing Angular
- */
-type NavigationStructuredItem = NavigationItem;
-/**
- * Sidebar Appearance
- * - default: full width (lebar penuh) dengan label + icon
- * - thin: icon-only, expand overlay saat hover
- */
-type SidebarAppearance = 'default' | 'thin';
-/**
- * Topbar Appearance
- * - default: horizontal dengan dropdown untuk collapsable
- * - megamenu: full-width panel multi-kolom untuk item `mega`
- */
-type TopbarAppearance = 'default' | 'megamenu';
-/** Sidebar desktop border ownership */
-type SidebarBorderSource = 'component' | 'layout';
-/** Sidebar position */
-type SidebarPosition = 'left' | 'right';
-/** Sidebar display mode */
-type SidebarMode = 'over' | 'side';
-type VerticalNavigationAppearance = SidebarAppearance;
-type VerticalNavigationBorderSource = SidebarBorderSource;
-type VerticalNavigationMode = SidebarMode;
-type VerticalNavigationPosition = SidebarPosition;
-
-/** Default registry key used when no id is specified. */
-declare const DEFAULT_NAVIGATION_ID = "main";
-/**
- * Signal-based global state untuk navigation (sidebar/topbar).
- *
- * Items disimpan dalam registry ber-key. Key default adalah `'main'`.
- * Komponen `sidebar` / `topbar` memilih registry via input `navigationId`.
- */
-declare class NavigationService {
-    private readonly doc;
-    private readonly router;
-    private readonly destroyRef;
-    private readonly persistedSidebarCollapsed;
-    /** Internal version counter — incremented on every registry mutation. */
-    private readonly _version;
-    /** Internal map of registered navigation trees. */
-    private readonly _registry;
-    private readonly _collapsed;
-    private readonly _hasStoredSidebarCollapse;
-    /**
-     * Backward-compatible accessor — returns items for the default (`'main'`) key.
-     * Prefer `getItems(id)` when working with named registries.
-     */
-    readonly items: _angular_core.Signal<readonly NavigationItem[]>;
-    /** Sidebar appearance preference (`default` or `thin`). */
-    readonly sidebarAppearance: _angular_core.Signal<SidebarAppearance>;
-    readonly hasStoredSidebarCollapse: _angular_core.Signal<boolean>;
-    /** Sidebar collapsed (default ↔ thin) toggle untuk desktop. */
-    readonly collapsed: _angular_core.Signal<boolean>;
-    /** Sheet drawer terbuka di mobile. */
-    readonly mobileOpen: _angular_core.WritableSignal<boolean>;
-    /** Set id grup / collapsable yang sedang terbuka. */
-    readonly openGroups: _angular_core.WritableSignal<ReadonlySet<string>>;
-    /** URL aktif terakhir. Update otomatis dari Router `NavigationEnd`. */
-    readonly activeUrl: _angular_core.WritableSignal<string>;
-    /** Trail id item yang sedang match dengan URL aktif (across ALL registries). */
-    readonly activeTrail: _angular_core.Signal<ReadonlySet<string>>;
-    constructor();
-    /**
-     * Register items di registry.
-     *
-     * Overload:
-     * - `registerItems(items)` → key `'main'`
-     * - `registerItems(id, items)` → key spesifik
-     */
-    registerItems(items: NavigationItem[]): void;
-    registerItems(id: string, items: NavigationItem[]): void;
-    /** Remove a named registry entry. */
-    removeItems(id: string): void;
-    /**
-     * Computed yang mengembalikan items untuk key tertentu.
-     * Reactive terhadap perubahan registry.
-     */
-    getItems(id: string): () => readonly NavigationItem[];
-    setSidebarAppearance(value: SidebarAppearance): void;
-    toggleSidebarAppearance(currentAppearance?: SidebarAppearance): void;
-    /** Toggle sidebar collapsed (default ↔ thin). */
-    toggleCollapsed(): void;
-    setCollapsed(value: boolean): void;
-    openMobile(): void;
-    closeMobile(): void;
-    toggleMobile(): void;
-    isGroupOpen(id: string): boolean;
-    toggleGroup(id: string): void;
-    setGroupOpen(id: string, open: boolean): void;
-    /** Apakah id termasuk dalam active trail saat ini. */
-    isActive(id: string | undefined): boolean;
-    private readPersistedSidebarCollapsed;
-    private persistSidebarCollapsed;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<NavigationService>;
-}
-
-/**
- * Material Symbols icon renderer.
- * Menyuntikkan stylesheet font sekali saat dipakai agar consumer tidak perlu
- * menambahkan `<link>` manual di `index.html`.
- */
-declare class UiNavIconComponent {
-    private readonly doc;
-    private readonly platformId;
-    readonly name: _angular_core.InputSignal<string>;
-    readonly class: _angular_core.InputSignal<string>;
-    readonly size: _angular_core.InputSignal<number | null>;
-    protected readonly fontVariationSettings = "\"FILL\" 0, \"wght\" 400, \"GRAD\" 0, \"opsz\" 24";
-    constructor();
-    protected readonly classes: _angular_core.Signal<string>;
-    private ensureFontStylesheet;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<UiNavIconComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UiNavIconComponent, "ui-nav-icon", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-/** Concatenate and dedupe Tailwind class names. */
-declare function cn(...inputs: ClassValue[]): string;
-
-/**
- * Recursive navigation item renderer (vertical context).
- *
- * Menerima item polymorphic dan delegasi ke template sesuai `type`.
- * Mega dirender sebagai group biasa saat muncul di konteks vertical.
- */
-declare class UiNavItemComponent {
-    private readonly nav;
-    protected readonly cn: typeof cn;
-    readonly item: _angular_core.InputSignal<NavigationItem>;
-    readonly level: _angular_core.InputSignal<number>;
-    /** Compact / icon-only rendering (sidebar `thin`). */
-    readonly compact: _angular_core.InputSignal<boolean>;
-    /** True when this branch sits inside a collapsable rail and can draw a connector back to it. */
-    readonly railConnector: _angular_core.InputSignal<boolean>;
-    protected readonly railConnectorDotClasses = "pointer-events-none absolute -left-[11px] top-1/2 z-10 h-1 w-1 -translate-x-1/2 -translate-y-1/2 rounded-full bg-foreground/80";
-    protected readonly exactMatch: {
-        readonly exact: true;
-        readonly paths: "exact";
-        readonly queryParams: "exact";
-        readonly fragment: "exact";
-        readonly matrixParams: "exact";
-    };
-    protected readonly inexactMatch: {
-        readonly paths: "subset";
-        readonly queryParams: "subset";
-        readonly fragment: "ignored";
-        readonly matrixParams: "ignored";
-    };
-    protected readonly type: _angular_core.Signal<"aside" | "basic" | "collapsable" | "divider" | "group" | "mega" | "spacer">;
-    protected readonly groupItem: _angular_core.Signal<NavigationGroupItem>;
-    protected readonly collapsableItem: _angular_core.Signal<NavigationCollapsableItem>;
-    protected readonly megaItem: _angular_core.Signal<NavigationMegaItem>;
-    protected readonly asideItem: _angular_core.Signal<NavigationAsideItem>;
-    protected readonly basicItem: _angular_core.Signal<NavigationBasicItem>;
-    protected readonly headingId: _angular_core.Signal<string>;
-    protected isGroupOpen(): boolean;
-    protected isTrailActive(): boolean;
-    protected railConnectorClasses(active: boolean): string;
-    protected showRailConnector(active: boolean): boolean;
-    protected toggleGroup(): void;
-    protected runAction(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<UiNavItemComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UiNavItemComponent, "ui-nav-item", never, { "item": { "alias": "item"; "required": true; "isSignal": true; }; "level": { "alias": "level"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "railConnector": { "alias": "railConnector"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-/**
- * Vertical navigation (sidebar) — shadcn-styled.
- *
- * Variants:
- * - `default`: 17.5rem, label + icon
- * - `thin`: 4rem icon-only; hover memunculkan overlay expand (tidak push konten)
- *
- * Mobile (`< md`): saat `autoMobile=true` (default), host desktop disembunyikan
- * dan konten dirender lewat CDK Overlay drawer dengan focus trap. State buka
- * dikontrol lewat `NavigationService.mobileOpen`.
- */
-declare class SidebarComponent {
-    private readonly nav;
-    private readonly bp;
-    private readonly overlay;
-    private readonly vcr;
-    private readonly focusTrapFactory;
-    private readonly doc;
-    private readonly destroyRef;
-    readonly items: _angular_core.InputSignal<NavigationItem[]>;
-    /** Registry key di `NavigationService`. Default `'main'`. */
-    readonly navigationId: _angular_core.InputSignal<string>;
-    readonly appearance: _angular_core.InputSignal<SidebarAppearance>;
-    /** Desktop border can be owned by the sidebar or by the surrounding layout shell. */
-    readonly borderSource: _angular_core.InputSignal<SidebarBorderSource>;
-    readonly position: _angular_core.InputSignal<SidebarPosition>;
-    readonly ariaLabel: _angular_core.InputSignal<string>;
-    readonly header: _angular_core.InputSignal<boolean>;
-    readonly class: _angular_core.InputSignal<string>;
-    /** Auto switch ke CDK overlay drawer saat viewport `< md`. */
-    readonly autoMobile: _angular_core.InputSignal<boolean>;
-    /** Auto-register `items` ke `NavigationService` agar `activeTrail` bekerja. */
-    readonly autoRegister: _angular_core.InputSignal<boolean>;
-    /** Resolved items: input jika disediakan, fallback ke registry NavigationService. */
-    protected readonly resolvedItems: _angular_core.Signal<readonly NavigationItem[]>;
-    private readonly hovered;
-    private readonly suppressHoverUntilLeave;
-    private readonly drawerTpl;
-    private drawerRef;
-    private focusTrap;
-    private previouslyFocused;
-    /** True saat viewport `< md` (767.98px). */
-    protected readonly isMobileMedia: _angular_core.Signal<boolean>;
-    protected readonly isMobile: _angular_core.Signal<boolean>;
-    protected readonly resolvedCollapsed: _angular_core.Signal<boolean>;
-    protected readonly resolvedAppearance: _angular_core.Signal<SidebarAppearance>;
-    protected readonly hoverActive: _angular_core.Signal<boolean>;
-    protected readonly isExpanded: _angular_core.Signal<boolean>;
-    protected readonly isCompact: _angular_core.Signal<boolean>;
-    protected readonly toggleButtonLabel: _angular_core.Signal<"Expand sidebar" | "Collapse sidebar">;
-    constructor();
-    protected readonly hostClasses: _angular_core.Signal<string>;
-    protected readonly headerClasses: _angular_core.Signal<string>;
-    protected readonly headerSlotClasses: _angular_core.Signal<string>;
-    protected readonly navClasses: _angular_core.Signal<string>;
-    protected readonly scrollViewportClasses: _angular_core.Signal<string>;
-    protected readonly footerClasses: _angular_core.Signal<string>;
-    protected readonly footerSlotClasses: _angular_core.Signal<string>;
-    protected readonly innerClasses: _angular_core.Signal<string>;
-    protected onHoverEnter(): void;
-    protected onHoverLeave(): void;
-    protected toggleAppearance(event: MouseEvent): void;
-    /** Touch fallback: tap pada strip thin (ketika belum expanded) untuk expand. */
-    protected onHostClick(event: MouseEvent): void;
-    private openDrawer;
-    private closeDrawer;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidebarComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidebarComponent, "sidebar", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "navigationId": { "alias": "navigationId"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "borderSource": { "alias": "borderSource"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "header": { "alias": "header"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; "autoMobile": { "alias": "autoMobile"; "required": false; "isSignal": true; }; "autoRegister": { "alias": "autoRegister"; "required": false; "isSignal": true; }; }, {}, never, ["[sidebar-header]", "[sidebar-footer]"], true, never>;
-}
-
-/**
- * Horizontal navigation (topbar) — shadcn-styled.
- */
-declare class TopbarComponent {
-    protected readonly nav: NavigationService;
-    private readonly overlay;
-    private readonly vcr;
-    private readonly host;
-    private readonly destroyRef;
-    readonly items: _angular_core.InputSignal<NavigationItem[]>;
-    /** Registry key di `NavigationService`. Default `'main'`. */
-    readonly navigationId: _angular_core.InputSignal<string>;
-    readonly appearance: _angular_core.InputSignal<TopbarAppearance>;
-    readonly ariaLabel: _angular_core.InputSignal<string>;
-    readonly class: _angular_core.InputSignal<string>;
-    /** Auto-register `items` ke `NavigationService` agar `activeTrail` bekerja. */
-    readonly autoRegister: _angular_core.InputSignal<boolean>;
-    /** Tampilkan hamburger di `< md` yang men-toggle mobile drawer sidebar. */
-    readonly showHamburger: _angular_core.InputSignal<boolean>;
-    readonly hamburgerLabel: _angular_core.InputSignal<string>;
-    /** Resolved items: input jika disediakan, fallback ke registry NavigationService. */
-    protected readonly resolvedItems: _angular_core.Signal<readonly NavigationItem[]>;
-    protected readonly openId: _angular_core.WritableSignal<string | null>;
-    private active;
-    private readonly dropdownTpl;
-    constructor();
-    protected readonly hostClasses: _angular_core.Signal<string>;
-    protected readonly endSlotClasses: _angular_core.Signal<string>;
-    protected asBasic(i: NavigationItem): NavigationBasicItem;
-    protected asCollapsable(i: NavigationItem): NavigationCollapsableItem;
-    protected asGroup(i: NavigationItem): NavigationGroupItem;
-    protected isItemActive(id: string | undefined): boolean;
-    protected toggleDropdown(trigger: HTMLElement, item: NavigationItem): void;
-    protected openDropdown(trigger: HTMLElement, item: NavigationItem): void;
-    private attach;
-    protected closeAll(): void;
-    /** Menubar keyboard navigation: ArrowLeft/Right antar trigger, Home/End, ArrowDown fokus panel. */
-    protected onMenubarKeydown(event: KeyboardEvent): void;
-    /** Arrow-key navigation dalam dropdown panel. */
-    protected onPanelKeydown(event: KeyboardEvent): void;
-    private collectPanelFocusables;
-    private focusFirstInPanel;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TopbarComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TopbarComponent, "topbar", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "navigationId": { "alias": "navigationId"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; "autoRegister": { "alias": "autoRegister"; "required": false; "isSignal": true; }; "showHamburger": { "alias": "showHamburger"; "required": false; "isSignal": true; }; "hamburgerLabel": { "alias": "hamburgerLabel"; "required": false; "isSignal": true; }; }, {}, never, ["[topbar-start]", "[topbar-end]"], true, never>;
-}
-
-declare const DemoNavigationData: NavigationItem[];
-
-declare const NAVIGATION_VERSION = "0.0.1";
-
-export { DEFAULT_NAVIGATION_ID, DemoNavigationData, NAVIGATION_VERSION, NavigationService, SidebarComponent, TopbarComponent, UiNavIconComponent, UiNavItemComponent };
-export type { NavigationActionHandler, NavigationAsideItem, NavigationBasicItem, NavigationBranchItem, NavigationCollapsableItem, NavigationDividerItem, NavigationGroupItem, NavigationItem, NavigationItemBadge, NavigationItemBase, NavigationItemClasses, NavigationItemType, NavigationLeafItem, NavigationMegaItem, NavigationRoutableItemBase, NavigationSpacerItem, NavigationStructuredItem, NavigationVisibilityHandler, SidebarAppearance, SidebarBorderSource, SidebarMode, SidebarPosition, TopbarAppearance, VerticalNavigationAppearance, VerticalNavigationBorderSource, VerticalNavigationMode, VerticalNavigationPosition };