@vobs/ui 0.3.0 → 1.1.0

package/dist/navigation.d.ts

@@ -1,609 +0,0 @@
-/** @license MIT
- * Copyright (c) 2026 vobsjs
- * @vobs/ui
- */
-import { type DialogPlanOptions, type DialogSize, type OverlayPlacement, type OverlayPlans, type ProductDialogPlans } from './overlay.js';
-import { type UiAttributes, type UiDomPlan } from './primitives.js';
-export type TabsOrientation = 'horizontal' | 'vertical';
-export type TabsOverflowState = 'empty' | 'expanded' | 'overflow';
-export type TabsPersistenceState = 'clean' | 'empty' | 'dirty' | 'restored';
-export type CommandPaletteItemKind = 'action' | 'page' | 'recent';
-export type CommandPalettePermission = 'allowed' | 'denied';
-export type CommandPalettePermissionRecentState = 'empty' | 'filtered' | 'permission-limited' | 'ready';
-export type MenuPermissionRemoteState = 'empty' | 'permission-limited' | 'remote-pending' | 'submenu-error' | 'ready';
-export type MenuItemRemoteActionState = 'available' | 'disabled' | 'pending';
-export type MenuItemSubmenuState = 'closed' | 'error' | 'loading' | 'open' | 'ready';
-export type MenuSubmenuPortalState = 'closed' | 'mounted' | 'open' | 'portal-missing';
-export type MenuSubmenuPortalContractState = 'closed' | 'empty' | 'mounted' | 'open' | 'portal-missing';
-export type MenuItemKind = 'checkbox' | 'item' | 'radio' | 'section' | 'separator' | 'submenu';
-export type DrawerSide = 'bottom' | 'left' | 'right';
-export type DrawerSize = DialogSize | 'full';
-export type DrawerNestedOverlayCoordinationState = 'action-pending' | 'focus-return-ready' | 'idle' | 'nested-overlay-open';
-export type DrawerPinnedActionState = 'available' | 'disabled' | 'pending';
-export type StepStatus = 'complete' | 'current' | 'disabled' | 'error' | 'pending';
-export type StepTimelineState = 'current' | 'future' | 'past';
-export type StepValidationState = 'blocked' | 'invalid' | 'unchecked' | 'valid' | 'warning';
-export type StepReturnState = 'current' | 'locked' | 'returnable';
-export type StepsTimelineValidationState = 'blocked' | 'empty' | 'invalid' | 'ready' | 'warning';
-export type CollapseMode = 'accordion' | 'multiple';
-export type CollapseLazyState = 'idle' | 'loading' | 'loaded' | 'error';
-export type CollapsePersistenceState = 'clean' | 'empty' | 'dirty' | 'restored';
-export type CollapseAdvancedState = 'disabled-limited' | 'lazy-error' | 'loading' | 'ready';
-export interface NavigationItem {
-    readonly id: string;
-    readonly label: string;
-    readonly disabled?: boolean;
-    readonly disabledReason?: string;
-    readonly overflow?: boolean;
-    readonly persistedActive?: boolean;
-}
-export interface CommandPaletteGroup {
-    readonly id: string;
-    readonly label: string;
-}
-export interface CommandPaletteItem {
-    readonly id: string;
-    readonly label: string;
-    readonly description?: string;
-    readonly groupId?: string;
-    readonly kind?: CommandPaletteItemKind;
-    readonly href?: string;
-    readonly shortcut?: string;
-    readonly keywords?: readonly string[];
-    readonly disabled?: boolean;
-    readonly disabledReason?: string;
-    readonly permission?: CommandPalettePermission;
-    readonly recent?: boolean;
-}
-export interface CommandPalettePermissionRecentContractOptions {
-    readonly items: readonly CommandPaletteItem[];
-    readonly groups?: readonly CommandPaletteGroup[];
-    readonly query?: string;
-    readonly allowedIds?: ReadonlySet<string> | readonly string[];
-    readonly deniedIds?: ReadonlySet<string> | readonly string[];
-    readonly disabledReasons?: Readonly<Record<string, string | undefined>>;
-    readonly recentIds?: readonly string[];
-    readonly selectedId?: string;
-    readonly maxRecent?: number;
-    readonly hideDenied?: boolean;
-    readonly recentGroup?: CommandPaletteGroup;
-}
-export interface CommandPalettePermissionRecentItemContract {
-    readonly id: string;
-    readonly item: CommandPaletteItem;
-    readonly permission: CommandPalettePermission;
-    readonly recent: boolean;
-    readonly disabledReason: string;
-    readonly attrs: UiAttributes;
-}
-export interface CommandPalettePermissionRecentContract {
-    readonly state: CommandPalettePermissionRecentState;
-    readonly query: string;
-    readonly totalCount: number;
-    readonly visibleCount: number;
-    readonly allowedCount: number;
-    readonly deniedCount: number;
-    readonly recentCount: number;
-    readonly disabledReasonCount: number;
-    readonly recentIds: readonly string[];
-    readonly nextRecentIds: readonly string[];
-    readonly groups: readonly CommandPaletteGroup[];
-    readonly items: readonly CommandPalettePermissionRecentItemContract[];
-    readonly attrs: UiAttributes;
-}
-export interface CommandPalettePlanOptions {
-    readonly id: string;
-    readonly items: readonly CommandPaletteItem[];
-    readonly groups?: readonly CommandPaletteGroup[];
-    readonly query?: string;
-    readonly open?: boolean;
-    readonly activeId?: string;
-    readonly selectedId?: string;
-    readonly labelId?: string;
-    readonly describedBy?: string;
-    readonly placeholder?: string;
-}
-export interface CommandPalettePlans {
-    readonly root: UiDomPlan<'div'>;
-    readonly input: UiDomPlan<'input'>;
-    readonly listbox: UiDomPlan<'div'>;
-    readonly groups: readonly UiDomPlan<'div'>[];
-    readonly groupLabels: readonly UiDomPlan<'div'>[];
-    readonly items: readonly UiDomPlan<'div'>[];
-    readonly shortcuts: readonly UiDomPlan<'kbd'>[];
-    readonly empty: UiDomPlan<'div'> | undefined;
-}
-export interface TabsPlanOptions {
-    readonly id: string;
-    readonly items: readonly NavigationItem[];
-    readonly activeId: string;
-    readonly orientation?: TabsOrientation;
-    readonly attrs?: UiAttributes;
-}
-export interface TabsPlans {
-    readonly root: UiDomPlan<'div'>;
-    readonly tabs: readonly UiDomPlan<'button'>[];
-    readonly panels: readonly UiDomPlan<'div'>[];
-}
-export interface TabsOverflowPersistenceContractOptions {
-    readonly items: readonly NavigationItem[];
-    readonly activeId: string;
-    readonly overflowIds?: ReadonlySet<string> | readonly string[];
-    readonly persistedActiveId?: string;
-    readonly disabledReasons?: Readonly<Record<string, string | undefined>>;
-    readonly orientation?: TabsOrientation;
-    readonly maxVisible?: number;
-}
-export interface TabsOverflowPersistenceItemContract {
-    readonly id: string;
-    readonly item: NavigationItem;
-    readonly active: boolean;
-    readonly overflow: boolean;
-    readonly persistedActive: boolean;
-    readonly disabledReason: string;
-    readonly attrs: UiAttributes;
-}
-export interface TabsOverflowPersistenceContract {
-    readonly overflowState: TabsOverflowState;
-    readonly persistenceState: TabsPersistenceState;
-    readonly activeId: string;
-    readonly persistedActiveId: string;
-    readonly orientation: TabsOrientation;
-    readonly itemCount: number;
-    readonly visibleCount: number;
-    readonly overflowCount: number;
-    readonly disabledReasonCount: number;
-    readonly overflowIds: readonly string[];
-    readonly visibleIds: readonly string[];
-    readonly disabledReasonIds: readonly string[];
-    readonly items: readonly TabsOverflowPersistenceItemContract[];
-    readonly attrs: UiAttributes;
-}
-export interface BreadcrumbItem {
-    readonly id?: string;
-    readonly label: string;
-    readonly href?: string;
-    readonly current?: boolean;
-    readonly icon?: boolean | string;
-    readonly collapsed?: boolean;
-    readonly overflow?: boolean;
-    readonly pathIndex?: number;
-    readonly pathSummary?: string;
-}
-export interface BreadcrumbPlans {
-    readonly root: UiDomPlan<'nav'>;
-    readonly list: UiDomPlan<'ol'>;
-    readonly items: readonly UiDomPlan<'li'>[];
-}
-export type BreadcrumbResponsiveState = 'collapsed' | 'empty' | 'expanded' | 'overflow';
-export interface BreadcrumbResponsiveStateContractOptions {
-    readonly items: readonly BreadcrumbItem[];
-    readonly collapsedIds?: ReadonlySet<string> | readonly string[];
-    readonly iconIds?: ReadonlySet<string> | readonly string[];
-    readonly overflowId?: string;
-    readonly maxVisible?: number;
-}
-export interface BreadcrumbResponsiveItemContract {
-    readonly id: string;
-    readonly item: BreadcrumbItem;
-    readonly collapsed: boolean;
-    readonly icon: boolean;
-    readonly overflow: boolean;
-    readonly pathIndex: number;
-    readonly pathSummary: string;
-    readonly attrs: UiAttributes;
-}
-export interface BreadcrumbResponsiveStateContract {
-    readonly state: BreadcrumbResponsiveState;
-    readonly itemCount: number;
-    readonly visibleCount: number;
-    readonly collapsedCount: number;
-    readonly iconCount: number;
-    readonly overflowId: string;
-    readonly currentPathSummary: string;
-    readonly collapsedIds: readonly string[];
-    readonly iconIds: readonly string[];
-    readonly visibleIds: readonly string[];
-    readonly items: readonly BreadcrumbResponsiveItemContract[];
-    readonly attrs: UiAttributes;
-}
-export interface MenuItem extends NavigationItem {
-    readonly kind?: MenuItemKind;
-    readonly checked?: boolean;
-    readonly danger?: boolean;
-    readonly shortcut?: string;
-    readonly sectionId?: string;
-    readonly expanded?: boolean;
-    readonly disabledReason?: string;
-    readonly permission?: CommandPalettePermission;
-    readonly remoteAction?: boolean;
-    readonly remoteActionDisabled?: boolean;
-    readonly remoteActionDisabledReason?: string;
-    readonly remoteActionError?: string;
-    readonly remoteActionLoading?: boolean;
-    readonly submenuError?: string;
-    readonly submenuItemCount?: number;
-    readonly submenuLoading?: boolean;
-    readonly submenuPortalState?: MenuSubmenuPortalState;
-    readonly submenuPortalTargetId?: string;
-    readonly submenuOpenPathIndex?: number;
-    readonly submenuFocusReturnId?: string;
-    readonly submenuParentOverlayId?: string;
-    readonly submenuPlacement?: OverlayPlacement;
-}
-export interface MenuPlanOptions {
-    readonly id: string;
-    readonly items: readonly MenuItem[];
-    readonly activeId?: string;
-    readonly label?: string;
-    readonly orientation?: TabsOrientation;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface MenuPlans {
-    readonly root: UiDomPlan<'div'>;
-    readonly items: readonly UiDomPlan<'div'>[];
-    readonly shortcuts: readonly (UiDomPlan<'kbd'> | undefined)[];
-}
-export interface MenuPermissionRemoteActionContractOptions {
-    readonly items: readonly MenuItem[];
-    readonly allowedIds?: ReadonlySet<string> | readonly string[];
-    readonly deniedIds?: ReadonlySet<string> | readonly string[];
-    readonly disabledReasons?: Readonly<Record<string, string | undefined>>;
-    readonly remoteActionIds?: ReadonlySet<string> | readonly string[];
-    readonly remoteActionDisabledIds?: ReadonlySet<string> | readonly string[];
-    readonly remoteActionDisabledReasons?: Readonly<Record<string, string | undefined>>;
-    readonly remoteActionLoadingIds?: ReadonlySet<string> | readonly string[];
-    readonly remoteActionErrors?: Readonly<Record<string, string | undefined>>;
-    readonly submenuLoadingIds?: ReadonlySet<string> | readonly string[];
-    readonly submenuErrors?: Readonly<Record<string, string | undefined>>;
-    readonly submenuItemCounts?: Readonly<Record<string, number | undefined>>;
-    readonly disabled?: boolean;
-}
-export interface MenuPermissionRemoteActionItemContract {
-    readonly id: string;
-    readonly item: MenuItem;
-    readonly permission: CommandPalettePermission;
-    readonly disabled: boolean;
-    readonly disabledReason: string;
-    readonly remoteAction: boolean;
-    readonly remoteActionState: MenuItemRemoteActionState;
-    readonly remoteActionDisabledReason: string;
-    readonly remoteActionError: string;
-    readonly submenuState: MenuItemSubmenuState | undefined;
-    readonly submenuError: string;
-    readonly submenuItemCount: number | undefined;
-    readonly attrs: UiAttributes;
-}
-export interface MenuPermissionRemoteActionContract {
-    readonly state: MenuPermissionRemoteState;
-    readonly disabled: boolean;
-    readonly itemCount: number;
-    readonly allowedCount: number;
-    readonly deniedCount: number;
-    readonly disabledReasonCount: number;
-    readonly remoteActionCount: number;
-    readonly remoteActionDisabledCount: number;
-    readonly remoteActionLoadingCount: number;
-    readonly remoteActionErrorCount: number;
-    readonly submenuLoadingCount: number;
-    readonly submenuErrorCount: number;
-    readonly allowedIds: readonly string[];
-    readonly deniedIds: readonly string[];
-    readonly remoteActionIds: readonly string[];
-    readonly remoteActionDisabledIds: readonly string[];
-    readonly remoteActionLoadingIds: readonly string[];
-    readonly remoteActionErrorIds: readonly string[];
-    readonly submenuLoadingIds: readonly string[];
-    readonly submenuErrorIds: readonly string[];
-    readonly items: readonly MenuPermissionRemoteActionItemContract[];
-    readonly attrs: UiAttributes;
-}
-export interface MenuSubmenuPortalStateContractOptions {
-    readonly items: readonly MenuItem[];
-    readonly openPathIds?: readonly string[];
-    readonly mountedIds?: ReadonlySet<string> | readonly string[];
-    readonly portalTargetIds?: Readonly<Record<string, string | undefined>>;
-    readonly focusReturnIds?: Readonly<Record<string, string | undefined>>;
-    readonly parentOverlayIds?: Readonly<Record<string, string | undefined>>;
-    readonly placements?: Readonly<Record<string, OverlayPlacement | undefined>>;
-}
-export interface MenuSubmenuPortalItemContract {
-    readonly id: string;
-    readonly item: MenuItem;
-    readonly state: MenuSubmenuPortalState;
-    readonly open: boolean;
-    readonly mounted: boolean;
-    readonly portalTargetId: string;
-    readonly focusReturnId: string;
-    readonly parentOverlayId: string;
-    readonly placement: OverlayPlacement | undefined;
-    readonly openPathIndex: number | undefined;
-    readonly attrs: UiAttributes;
-}
-export interface MenuSubmenuPortalStateContract {
-    readonly state: MenuSubmenuPortalContractState;
-    readonly submenuCount: number;
-    readonly openCount: number;
-    readonly mountedCount: number;
-    readonly portalMissingCount: number;
-    readonly openPathIds: readonly string[];
-    readonly mountedIds: readonly string[];
-    readonly portalMissingIds: readonly string[];
-    readonly portalTargetIds: readonly string[];
-    readonly items: readonly MenuSubmenuPortalItemContract[];
-    readonly attrs: UiAttributes;
-}
-export interface DrawerPlanOptions extends Omit<DialogPlanOptions, 'modal'> {
-    readonly side?: DrawerSide;
-    readonly size?: DrawerSize;
-    readonly descriptionId?: string;
-    readonly closeLabel?: string;
-    readonly longContent?: boolean;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface DrawerPlans extends ProductDialogPlans {
-    readonly side: DrawerSide;
-}
-export interface DrawerPinnedAction {
-    readonly id: string;
-    readonly label?: string;
-    readonly disabled?: boolean;
-    readonly disabledReason?: string;
-    readonly pending?: boolean;
-}
-export interface DrawerNestedOverlayCoordinationContractOptions {
-    readonly nestedOverlayIds?: readonly string[];
-    readonly nestedModalIds?: readonly string[];
-    readonly activeOverlayId?: string;
-    readonly focusReturnId?: string;
-    readonly scrollContainerId?: string;
-    readonly scrollContained?: boolean;
-    readonly pinnedActions?: readonly DrawerPinnedAction[];
-    readonly pendingActionIds?: ReadonlySet<string> | readonly string[];
-    readonly disabledActionIds?: ReadonlySet<string> | readonly string[];
-    readonly disabledReasons?: Readonly<Record<string, string | undefined>>;
-}
-export interface DrawerPinnedActionContract {
-    readonly id: string;
-    readonly action: DrawerPinnedAction;
-    readonly state: DrawerPinnedActionState;
-    readonly disabledReason: string;
-    readonly attrs: UiAttributes;
-}
-export interface DrawerNestedOverlayCoordinationContract {
-    readonly state: DrawerNestedOverlayCoordinationState;
-    readonly nestedOverlayCount: number;
-    readonly nestedModalCount: number;
-    readonly pinnedActionCount: number;
-    readonly pendingActionCount: number;
-    readonly disabledActionCount: number;
-    readonly activeOverlayId: string;
-    readonly focusReturnId: string;
-    readonly scrollContainerId: string;
-    readonly scrollContained: boolean;
-    readonly nestedOverlayIds: readonly string[];
-    readonly nestedModalIds: readonly string[];
-    readonly pinnedActionIds: readonly string[];
-    readonly pendingActionIds: readonly string[];
-    readonly disabledActionIds: readonly string[];
-    readonly actions: readonly DrawerPinnedActionContract[];
-    readonly attrs: UiAttributes;
-}
-export interface StepItem {
-    readonly id: string;
-    readonly label: string;
-    readonly description?: string;
-    readonly status?: StepStatus;
-    readonly disabled?: boolean;
-    readonly href?: string;
-    readonly timelineIndex?: number;
-    readonly timelineState?: StepTimelineState;
-    readonly validationState?: StepValidationState;
-    readonly blockingReason?: string;
-    readonly returnState?: StepReturnState;
-    readonly returnable?: boolean;
-    readonly previousStepId?: string;
-    readonly nextStepId?: string;
-}
-export interface StepsTimelineValidationContractOptions {
-    readonly items: readonly StepItem[];
-    readonly currentId?: string;
-    readonly completedIds?: ReadonlySet<string> | readonly string[];
-    readonly returnableIds?: ReadonlySet<string> | readonly string[];
-    readonly validationStates?: Readonly<Record<string, StepValidationState | undefined>>;
-    readonly blockingReasons?: Readonly<Record<string, string | undefined>>;
-}
-export interface StepsTimelineValidationItemContract {
-    readonly id: string;
-    readonly item: StepItem;
-    readonly timelineIndex: number;
-    readonly timelineState: StepTimelineState;
-    readonly validationState: StepValidationState;
-    readonly blockingReason: string;
-    readonly returnState: StepReturnState;
-    readonly previousStepId: string;
-    readonly nextStepId: string;
-    readonly attrs: UiAttributes;
-}
-export interface StepsTimelineValidationContract {
-    readonly state: StepsTimelineValidationState;
-    readonly currentId: string;
-    readonly stepCount: number;
-    readonly completedCount: number;
-    readonly returnableCount: number;
-    readonly blockedCount: number;
-    readonly invalidCount: number;
-    readonly warningCount: number;
-    readonly completedIds: readonly string[];
-    readonly returnableIds: readonly string[];
-    readonly blockedIds: readonly string[];
-    readonly invalidIds: readonly string[];
-    readonly warningIds: readonly string[];
-    readonly items: readonly StepsTimelineValidationItemContract[];
-    readonly attrs: UiAttributes;
-}
-export interface StepsPlanOptions {
-    readonly id?: string;
-    readonly items: readonly StepItem[];
-    readonly currentId?: string;
-    readonly orientation?: TabsOrientation;
-    readonly clickable?: boolean;
-    readonly label?: string;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface StepsPlans {
-    readonly root: UiDomPlan<'nav'>;
-    readonly list: UiDomPlan<'ol'>;
-    readonly items: readonly UiDomPlan<'li'>[];
-    readonly indicators: readonly UiDomPlan<'span'>[];
-    readonly triggers: readonly UiDomPlan<'a' | 'button' | 'span'>[];
-    readonly descriptions: readonly (UiDomPlan<'p'> | undefined)[];
-}
-export interface CollapseItem {
-    readonly id: string;
-    readonly title: string;
-    readonly disabled?: boolean;
-    readonly description?: string;
-    readonly lazyState?: CollapseLazyState;
-    readonly lazyError?: string;
-    readonly persistedOpen?: boolean;
-    readonly nestedLevel?: number;
-    readonly parentPanelId?: string;
-    readonly disabledReason?: string;
-}
-export interface CollapseLazyPersistenceContractOptions {
-    readonly items: readonly CollapseItem[];
-    readonly openIds?: ReadonlySet<string> | readonly string[];
-    readonly persistedOpenIds?: ReadonlySet<string> | readonly string[];
-    readonly lazyLoadingIds?: ReadonlySet<string> | readonly string[];
-    readonly lazyLoadedIds?: ReadonlySet<string> | readonly string[];
-    readonly lazyErrors?: Readonly<Record<string, string | undefined>>;
-    readonly disabledReasons?: Readonly<Record<string, string | undefined>>;
-    readonly nestedParents?: Readonly<Record<string, string | undefined>>;
-    readonly nestedLevels?: Readonly<Record<string, number | undefined>>;
-}
-export interface CollapseLazyPersistenceItemContract {
-    readonly id: string;
-    readonly item: CollapseItem;
-    readonly lazyState: CollapseLazyState;
-    readonly lazyError: string;
-    readonly persistedOpen: boolean;
-    readonly disabledReason: string;
-    readonly nestedLevel: number;
-    readonly parentPanelId: string;
-    readonly attrs: UiAttributes;
-}
-export interface CollapseLazyPersistenceContract {
-    readonly state: CollapseAdvancedState;
-    readonly persistenceState: CollapsePersistenceState;
-    readonly itemCount: number;
-    readonly lazyLoadingCount: number;
-    readonly lazyLoadedCount: number;
-    readonly lazyErrorCount: number;
-    readonly persistedOpenCount: number;
-    readonly disabledReasonCount: number;
-    readonly nestedCount: number;
-    readonly openIds: readonly string[];
-    readonly persistedOpenIds: readonly string[];
-    readonly lazyLoadingIds: readonly string[];
-    readonly lazyLoadedIds: readonly string[];
-    readonly lazyErrorIds: readonly string[];
-    readonly disabledReasonIds: readonly string[];
-    readonly nestedIds: readonly string[];
-    readonly items: readonly CollapseLazyPersistenceItemContract[];
-    readonly attrs: UiAttributes;
-}
-export interface CollapsePlanOptions {
-    readonly id: string;
-    readonly items: readonly CollapseItem[];
-    readonly openIds?: ReadonlySet<string> | readonly string[];
-    readonly mode?: CollapseMode;
-    readonly label?: string;
-    readonly animated?: boolean;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface CollapsePlans {
-    readonly root: UiDomPlan<'div'>;
-    readonly items: readonly UiDomPlan<'div'>[];
-    readonly triggers: readonly UiDomPlan<'button'>[];
-    readonly indicators: readonly UiDomPlan<'span'>[];
-    readonly panels: readonly UiDomPlan<'div'>[];
-}
-export declare function createTabsPlans(options: TabsPlanOptions): TabsPlans;
-export declare function createTabsOverflowPersistenceContract(options: TabsOverflowPersistenceContractOptions): TabsOverflowPersistenceContract;
-export declare function createCommandPalettePlans(options: CommandPalettePlanOptions): CommandPalettePlans;
-export declare function createCommandPalettePermissionRecentContract(options: CommandPalettePermissionRecentContractOptions): CommandPalettePermissionRecentContract;
-export declare function getNextTabId(items: readonly NavigationItem[], activeId: string, key: string, orientation?: TabsOrientation): string;
-export declare function filterCommandPaletteItems(items: readonly CommandPaletteItem[], query: string, limit?: number): readonly CommandPaletteItem[];
-export declare function getNextCommandPaletteItemId(items: readonly CommandPaletteItem[], activeId: string | undefined, key: string): string | undefined;
-export declare function shouldOpenCommandPaletteForKey(key: string, metaKey?: boolean, ctrlKey?: boolean): boolean;
-export declare function shouldCloseCommandPaletteForKey(key: string): boolean;
-export declare function shouldSelectCommandPaletteItem(key: string): boolean;
-export declare function createBreadcrumbPlans(items: readonly BreadcrumbItem[]): BreadcrumbPlans;
-export declare function createBreadcrumbResponsiveStateContract(options: BreadcrumbResponsiveStateContractOptions): BreadcrumbResponsiveStateContract;
-export declare function createMenuPlans(options: MenuPlanOptions): MenuPlans;
-export declare function createMenuPermissionRemoteActionContract(options: MenuPermissionRemoteActionContractOptions): MenuPermissionRemoteActionContract;
-export declare function createMenuSubmenuPortalStateContract(options: MenuSubmenuPortalStateContractOptions): MenuSubmenuPortalStateContract;
-export declare function getNextMenuItemId(items: readonly MenuItem[], activeId: string, key: string): string;
-export declare function createDrawerOverlayPlans(options: DrawerPlanOptions): OverlayPlans;
-export declare function createDrawerPlans(options: DrawerPlanOptions): DrawerPlans;
-export declare function createDrawerNestedOverlayCoordinationContract(options: DrawerNestedOverlayCoordinationContractOptions): DrawerNestedOverlayCoordinationContract;
-export declare function createStepsPlans(options: StepsPlanOptions): StepsPlans;
-export declare function getNextStepId(items: readonly StepItem[], activeId: string, key: string, orientation?: TabsOrientation): string;
-export declare function createStepsTimelineValidationContract(options: StepsTimelineValidationContractOptions): StepsTimelineValidationContract;
-export declare function createCollapsePlans(options: CollapsePlanOptions): CollapsePlans;
-export declare function createCollapseLazyPersistenceContract(options: CollapseLazyPersistenceContractOptions): CollapseLazyPersistenceContract;
-export declare function getNextCollapseTriggerId(items: readonly CollapseItem[], activeId: string, key: string): string;
-export declare function getNextAccordionOpenIds(openIds: ReadonlySet<string>, itemId: string): ReadonlySet<string>;
-export declare function getNextCollapseOpenIds(openIds: ReadonlySet<string>, itemId: string): ReadonlySet<string>;
-/**
- * Nav List plans — sidebar navigation: groups (title + items); items carry icon/label/badge/active state.
- * Spec source: UIStyle/preview/component-nav-list.html (ds-navlist).
- */
-export type NavListItemState = 'active' | 'disabled' | 'idle';
-export interface NavListNavItem {
-    readonly id: string;
-    readonly label: string;
-    /** Icon identifier (mapped to an icon source/URL at render time). */
-    readonly icon?: string;
-    /** Badge text (number or string). */
-    readonly badge?: string | number;
-    readonly active?: boolean;
-    readonly disabled?: boolean;
-    /** When provided, renders as an <a>; otherwise a <button>. */
-    readonly href?: string;
-}
-export interface NavListGroupInput {
-    readonly id: string;
-    readonly title: string;
-    readonly items: readonly NavListNavItem[];
-}
-export interface NavListPlanOptions {
-    readonly id: string;
-    readonly groups: readonly NavListGroupInput[];
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface NavListNavItemPlan extends UiDomPlan<'a' | 'button'> {
-    readonly itemId: string;
-    /** Derived state (active > disabled > idle). */
-    readonly state: NavListItemState;
-    /** Icon (data-icon identifier, mapped at render time). */
-    readonly icon?: UiDomPlan<'img'>;
-    readonly label: UiDomPlan<'span'>;
-    readonly badge?: UiDomPlan<'span'>;
-}
-export interface NavListGroupPlan extends UiDomPlan<'div'> {
-    readonly groupId: string;
-    readonly title: UiDomPlan<'div'>;
-    readonly items: readonly NavListNavItemPlan[];
-}
-export interface NavListPlans {
-    readonly root: UiDomPlan<'nav'>;
-    readonly groups: readonly NavListGroupPlan[];
-}
-export declare function createNavListPlans(options: NavListPlanOptions): NavListPlans;