navigation-menu machine

export declare const NAVIGATION_MENU_INTENT_KEY: "navigation-menu.intent";

type NavigationMenuChangeReason = NavigationMenuOpenReason | NavigationMenuCloseReason;

type NavigationMenuCloseReason = "leave" | "escape" | "dismiss" | "programmatic" | "trigger" | "intent";

type NavigationMenuCommand = (CommandObject & {
  readonly type: "OPEN_CHANGE_REQUEST";
  readonly open: number | null;
  readonly reason: NavigationMenuChangeReason;
}) | ScheduleCommand<NavigationMenuEvent> | CancelCommand;

type NavigationMenuContext = {
  readonly open: number | null;
  readonly mode: "controlled" | "uncontrolled";
};

export declare const NavigationMenuDiagnosticCodes: readonly DiagnosticCatalogueEntry[];

type NavigationMenuEvent = {
  readonly type: "OPEN";
  readonly index: number;
  readonly reason: NavigationMenuOpenReason;
} | {
  readonly type: "TOGGLE";
  readonly index: number;
  readonly reason: "trigger";
} | {
  readonly type: "CLOSE";
  readonly reason: NavigationMenuCloseReason;
} | {
  readonly type: "HOVER";
  readonly index: number;
  readonly intent?: NavigationMenuPointerIntent;
} | {
  readonly type: "FOCUS";
  readonly index: number;
} | {
  readonly type: "CLICK";
  readonly index: number;
} | {
  readonly type: "LEAVE";
  readonly intent?: NavigationMenuPointerIntent;
} | {
  readonly type: "ESCAPE";
} | {
  readonly type: "DISMISS";
};

type NavigationMenuInput = {
  /** Controlled committed panel index. Defining it fixes controlled mode. */
  readonly open?: number | null;
  /** Uncontrolled initial panel index. */
  readonly defaultOpen?: number | null;
  /** Panel ownership is input data, never trusted from an event payload. */
  readonly items: readonly NavigationMenuItem[];
  /** Delay for safe pointer intent transitions. Default 0 (oracle parity). */
  readonly intentDelayMs?: number;
};

interface NavigationMenuItem {
  readonly hasPanel: boolean;
}

export declare const navigationMenuMachine: NavigationMenuMachine;

type NavigationMenuMachine = Machine<NavigationMenuInput, NavigationMenuStateValue, NavigationMenuContext, NavigationMenuEvent, NavigationMenuCommand>;

type NavigationMenuOpenReason = "programmatic" | "focus" | "hover" | "intent";

type NavigationMenuPointerIntent = "enter" | "preserve" | "leave";

export declare const navigationMenuReplaySequence: readonly NavigationMenuEvent[];

export declare const navigationMenuSelectors: {
  open: (snapshot: NavigationMenuSnapshot) => number | null;
  isOpen: (snapshot: NavigationMenuSnapshot, index: number) => boolean;
};

type NavigationMenuSnapshot = Snapshot<NavigationMenuStateValue, NavigationMenuContext>;

type NavigationMenuStateValue = "ready";