@ojiepermana/angular 22.1.14 → 22.2.1

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

@@ -1,144 +1,185 @@
-import { Signal } from '@angular/core';
-import { UrlTree, Params, QueryParamsHandling, IsActiveMatchOptions } from '@angular/router';
-import { Observable } from 'rxjs';
-
-type NavigationOrientation = 'vertical' | 'horizontal';
-type NavigationVerticalType = 'sidebar' | 'dockbar';
-type NavigationHorizontalType = 'navbar' | 'flyout';
-type NavigationType = NavigationVerticalType | NavigationHorizontalType;
-type NavigationCollapseTree = 'stairs' | 'straight';
-type NavigationAppearance = 'flat' | 'border-rail';
-type NavigationVerticalPosition = 'left' | 'right';
-type NavigationHorizontalPosition = 'top' | 'bottom';
-type NavigationPosition = NavigationVerticalPosition | NavigationHorizontalPosition;
-type NavigationFlyoutIconPosition = 'start' | 'end';
+import { Signal } from "@angular/core";
+import { IsActiveMatchOptions, Params, QueryParamsHandling, UrlTree } from "@angular/router";
+import { Observable } from "rxjs";
+export type NavigationOrientation = 'vertical' | 'horizontal';
+export type NavigationVerticalType = 'sidebar' | 'dockbar' | 'minidock';
+export type NavigationHorizontalType = 'navbar' | 'flyout';
+export type NavigationType = NavigationVerticalType | NavigationHorizontalType;
+export type NavigationCollapseTree = 'stairs' | 'straight';
+export type NavigationAppearance = 'flat' | 'border-rail';
+export type NavigationVerticalPosition = 'left' | 'right';
+export type NavigationHorizontalPosition = 'top' | 'bottom';
+export type NavigationPosition = NavigationVerticalPosition | NavigationHorizontalPosition;
+export type NavigationFlyoutIconPosition = 'start' | 'end';
 /** Bentuk visual tombol trigger flyout: `button` (pil), `link` (gaya tautan), `plain` (ghost). */
-type NavigationFlyoutTriggerVariant = 'button' | 'link' | 'plain';
-type NavigationDockbarMode = 'drawer' | 'sticky';
+export type NavigationFlyoutTriggerVariant = 'button' | 'link' | 'plain';
+export type NavigationDockbarMode = 'drawer' | 'sticky';
 /** Icon Material Symbols bawaan ketika route aktif tidak menyediakan icon lain. */
-declare const NAVIGATION_DOCKBAR_FALLBACK_ICON = "route";
-type NavigationBadgeCount = number | null | undefined;
-type NavigationBadgeValueSource = NavigationBadgeCount | Signal<NavigationBadgeCount> | Observable<NavigationBadgeCount> | (() => NavigationBadgeCount);
-type NavigationBadgeAriaLabel = string | ((count: number) => string);
+export declare const NAVIGATION_DOCKBAR_FALLBACK_ICON = "route";
+export type NavigationBadgeCount = number | null | undefined;
+export type NavigationBadgeValueSource = NavigationBadgeCount | Signal<NavigationBadgeCount> | Observable<NavigationBadgeCount> | (() => NavigationBadgeCount);
+export type NavigationBadgeAriaLabel = string | ((count: number) => string);
 /** Sumber badge generik yang dapat direferensikan navigation item atau route metadata. */
-interface NavigationBadgeSource {
-    readonly value: NavigationBadgeValueSource;
-    readonly ariaLabel: NavigationBadgeAriaLabel;
-    readonly classes?: string;
+export interface NavigationBadgeSource {
+  readonly value: NavigationBadgeValueSource;
+  readonly ariaLabel: NavigationBadgeAriaLabel;
+  readonly classes?: string;
 }
-type NavigationBadgeContext = Readonly<Record<string, NavigationBadgeSource>>;
+export type NavigationBadgeContext = Readonly<Record<string, NavigationBadgeSource>>;
 /** Metadata resmi yang dapat diletakkan pada `Route.data`. */
-interface NavigationRouteData {
-    readonly navigationIcon?: string | null;
-    readonly navigationBadge?: string | null;
-    readonly navigationLabel?: string | null;
+export interface NavigationRouteData {
+  readonly navigationIcon?: string | null;
+  readonly navigationBadge?: string | null;
+  readonly navigationLabel?: string | null;
 }
 /** Snapshot route aktif yang dipublikasikan adapter route context library. */
-interface NavigationResolvedRouteContext {
-    readonly url: string;
-    readonly icon: string | null;
-    readonly badge: string | null;
-    readonly label: string | null;
+export interface NavigationResolvedRouteContext {
+  readonly url: string;
+  readonly icon: string | null;
+  readonly badge: string | null;
+  readonly label: string | null;
 }
 /** Override opsional untuk route context dockbar. Nilai `true` memakai Router sepenuhnya. */
-interface NavigationDockbarRouteConfig {
-    readonly url?: string | null;
-    readonly icon?: string | null;
-    readonly badge?: string | null;
-    readonly label?: string | null;
-    readonly fallbackIcon?: string;
+export interface NavigationDockbarRouteConfig {
+  readonly url?: string | null;
+  readonly icon?: string | null;
+  readonly badge?: string | null;
+  readonly label?: string | null;
+  readonly fallbackIcon?: string;
 }
-type NavigationDockbarRouteContext = boolean | NavigationDockbarRouteConfig;
-interface NavigationRegisterInput {
-    readonly id: string;
-    readonly orientation: NavigationOrientation;
-    readonly type?: NavigationType | null;
-    readonly position?: NavigationPosition | null;
-    readonly collapsed?: boolean | null;
-    readonly dockbarMode?: NavigationDockbarMode | null;
+export type NavigationDockbarRouteContext = boolean | NavigationDockbarRouteConfig;
+export interface NavigationRegisterInput {
+  readonly id: string;
+  readonly orientation: NavigationOrientation;
+  readonly type?: NavigationType | null;
+  readonly position?: NavigationPosition | null;
+  readonly collapsed?: boolean | null;
+  readonly dockbarMode?: NavigationDockbarMode | null;
 }
-interface NavigationState {
-    readonly id: string;
-    readonly orientation: NavigationOrientation;
-    readonly type: NavigationType;
-    readonly position: NavigationPosition;
-    readonly collapsed: boolean;
-    readonly dockbarMode: NavigationDockbarMode;
+export interface NavigationState {
+  readonly id: string;
+  readonly orientation: NavigationOrientation;
+  readonly type: NavigationType;
+  readonly position: NavigationPosition;
+  readonly collapsed: boolean;
+  readonly dockbarMode: NavigationDockbarMode;
 }
-type NavigationItemType = 'item' | 'basic' | 'aside' | 'group' | 'collapsible' | 'collapsable' | 'mega' | 'divider' | 'spacer';
-type NavigationNormalizedItemType = 'item' | 'group' | 'collapsible' | 'mega' | 'divider' | 'spacer';
-type NavigationLink = string | readonly unknown[] | UrlTree;
-interface NavigationItemClasses {
-    readonly title?: string;
-    readonly subtitle?: string;
-    readonly icon?: string;
-    /** Kelas untuk elemen klik (tombol/anchor) item. */
-    readonly wrapper?: string;
-    /** Kelas untuk container `<li>` group horizontal (flyout tab / navbar group). Per-group. */
-    readonly container?: string;
+export type NavigationItemType = 'item' | 'basic' | 'aside' | 'group' | 'collapsible' | 'collapsable' | 'mega' | 'divider' | 'spacer';
+export type NavigationNormalizedItemType = 'item' | 'group' | 'collapsible' | 'mega' | 'divider' | 'spacer';
+export type NavigationLink = string | readonly unknown[] | UrlTree;
+export interface NavigationItemClasses {
+  readonly title?: string;
+  readonly subtitle?: string;
+  readonly icon?: string;
+  /** Kelas untuk elemen klik (tombol/anchor) item. */
+  readonly wrapper?: string;
+  /** Kelas untuk container `<li>` group horizontal (flyout tab / navbar group). Per-group. */
+  readonly container?: string;
 }
-interface NavigationItemBadge {
-    readonly title?: string;
-    readonly classes?: string;
-    /** Key generik yang dicari pada input `dockbar-badge`. */
-    readonly source?: string;
+export interface NavigationItemBadge {
+  readonly title?: string;
+  readonly classes?: string;
+  /** Key generik yang dicari pada input `dockbar-badge`. */
+  readonly source?: string;
 }
-type NavigationVisibilityHandler = (item: NavigationItem) => boolean;
-type NavigationActionHandler = (item: NavigationItem) => void;
-interface NavigationItem {
-    readonly id?: string;
-    readonly type?: NavigationItemType;
-    readonly title?: string;
-    readonly subtitle?: string;
-    readonly active?: boolean;
-    readonly disabled?: boolean;
-    readonly tooltip?: string;
-    readonly classes?: NavigationItemClasses;
-    readonly icon?: string;
-    readonly badge?: NavigationItemBadge;
-    readonly meta?: Record<string, unknown>;
-    readonly isHidden?: NavigationVisibilityHandler;
-    readonly link?: NavigationLink;
-    readonly href?: string;
-    readonly fragment?: string;
-    readonly preserveFragment?: boolean;
-    readonly queryParams?: Params | null;
-    readonly queryParamsHandling?: QueryParamsHandling | null;
-    readonly externalLink?: boolean;
-    readonly target?: '_blank' | '_self' | '_parent' | '_top' | string;
-    readonly rel?: string;
-    readonly exactMatch?: boolean;
-    readonly isActiveMatchOptions?: IsActiveMatchOptions;
-    readonly action?: NavigationActionHandler;
-    readonly columns?: number;
-    readonly children?: readonly NavigationItem[];
+export type NavigationVisibilityHandler = (item: NavigationItem) => boolean;
+export type NavigationActionHandler = (item: NavigationItem) => void;
+export interface NavigationItem {
+  readonly id?: string;
+  readonly type?: NavigationItemType;
+  readonly title?: string;
+  readonly subtitle?: string;
+  readonly active?: boolean;
+  readonly disabled?: boolean;
+  readonly tooltip?: string;
+  readonly classes?: NavigationItemClasses;
+  readonly icon?: string;
+  readonly badge?: NavigationItemBadge;
+  readonly meta?: Record<string, unknown>;
+  readonly isHidden?: NavigationVisibilityHandler;
+  readonly link?: NavigationLink;
+  readonly href?: string;
+  readonly fragment?: string;
+  readonly preserveFragment?: boolean;
+  readonly queryParams?: Params | null;
+  readonly queryParamsHandling?: QueryParamsHandling | null;
+  readonly externalLink?: boolean;
+  readonly target?: '_blank' | '_self' | '_parent' | '_top' | string;
+  readonly rel?: string;
+  readonly exactMatch?: boolean;
+  readonly isActiveMatchOptions?: IsActiveMatchOptions;
+  readonly action?: NavigationActionHandler;
+  readonly columns?: number;
+  readonly children?: readonly NavigationItem[];
 }
-interface NavigationNormalizedItem extends Omit<NavigationItem, 'children' | 'type'> {
-    readonly key: string;
-    readonly stateId: string;
-    readonly panelId: string;
-    readonly type: NavigationNormalizedItemType;
-    readonly source: NavigationItem;
-    readonly children: readonly NavigationNormalizedItem[];
+export interface NavigationNormalizedItem extends Omit<NavigationItem, 'children' | 'type'> {
+  readonly key: string;
+  readonly stateId: string;
+  readonly panelId: string;
+  readonly type: NavigationNormalizedItemType;
+  readonly source: NavigationItem;
+  readonly children: readonly NavigationNormalizedItem[];
 }
-interface NavigationSelection {
-    readonly item: NavigationItem;
-    readonly key: string;
-    readonly type: NavigationNormalizedItemType;
-    readonly link?: NavigationLink;
-    readonly external: boolean;
+export interface NavigationSelection {
+  readonly item: NavigationItem;
+  readonly key: string;
+  readonly type: NavigationNormalizedItemType;
+  readonly link?: NavigationLink;
+  readonly external: boolean;
 }
-interface NavigationIconContext {
-    readonly $implicit: string;
-    readonly icon: string;
-    readonly item: NavigationItem;
-    readonly active: boolean;
-    readonly orientation: NavigationOrientation;
-    readonly level: number;
+export interface NavigationIconContext {
+  readonly $implicit: string;
+  readonly icon: string;
+  readonly item: NavigationItem;
+  readonly active: boolean;
+  readonly orientation: NavigationOrientation;
+  readonly level: number;
 }
-declare function normalizeUiNavItems(items: readonly NavigationItem[]): readonly NavigationNormalizedItem[];
+export declare function normalizeUiNavItems(items: readonly NavigationItem[]): readonly NavigationNormalizedItem[];
 /** Format visual count badge dockbar. Count nol atau invalid tidak dirender. */
-declare function formatNavigationBadgeCount(value: NavigationBadgeCount): string | null;
-
-export { NAVIGATION_DOCKBAR_FALLBACK_ICON, formatNavigationBadgeCount, normalizeUiNavItems };
-export type { 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 };
+export declare function formatNavigationBadgeCount(value: NavigationBadgeCount): string | null;
+/**
+ * Memadatkan divider: yang di awal, di akhir, dan yang berurutan dibuang. Dari
+ * satu deret divider berurutan, divider pertama tanpa `isHidden` yang dipertahankan
+ * (atau divider pertama bila semuanya punya `isHidden`), supaya pemisah yang selalu
+ * terlihat tidak kalah oleh pemisah yang bisa tersembunyi saat runtime.
+ *
+ * Dipakai dua kali: oleh `toMinidockItems` atas data mentah, dan oleh jalur render
+ * minidock atas item yang sudah dinormalisasi (item tersembunyi sudah hilang).
+ *
+ * @internal
+ */
+export declare function ɵcompactNavigationDividers<T extends {
+  readonly type?: string;
+  readonly isHidden?: unknown;
+}>(items: readonly T[]): T[];
+/**
+ * Melempar `Error` pertama yang ditemukan bila data minidock berisi item di luar
+ * `basic`, `item`, tanpa type, `divider`, dan `spacer`, atau item mana pun dengan
+ * `children` yang tidak kosong. Berjalan atas data mentah, termasuk item yang
+ * `isHidden`, dan tanpa `isDevMode()`: aturannya sama di dev dan production.
+ *
+ * Cukup memeriksa level atas: item apa pun yang punya children sudah ditolak,
+ * jadi item bersarang tidak pernah bisa lolos.
+ *
+ * @internal
+ */
+export declare function ɵassertMinidockItems(items: readonly NavigationItem[]): void;
+/**
+ * Meratakan data navigasi bergroup menjadi data yang selalu valid untuk
+ * `<NavigationMinidock>`:
+ *
+ * - daun (`basic`, `item`, atau tanpa type, tanpa children) dipertahankan;
+ * - `group` dan `mega` di level mana pun diganti batas divider lalu isinya
+ *   diratakan; group yang isinya kosong tidak menghasilkan divider;
+ * - `collapsible`, `collapsable`, `aside`, dan item lain yang punya children
+ *   dibuang sebagai induk, anak anaknya diratakan rekursif;
+ * - divider di awal, di akhir, atau berurutan dipadatkan; `spacer` hanya
+ *   dipertahankan di level atas;
+ * - daun dengan `id` yang sama hanya muncul sekali (kemunculan pertama).
+ *
+ * Daun dan divider yang diangkat ikut tersembunyi bila salah satu induknya
+ * tersembunyi, dan divider pengganti group ikut tersembunyi bersama group itu. Daun dikembalikan
+ * sebagai objek yang sama kecuali `isHidden` nya perlu digabung. Tidak pernah throw.
+ */
+export declare function toMinidockItems(items: readonly NavigationItem[]): NavigationItem[];