popover machine

type PopoverChangeReason = PopoverOpenReason | PopoverCloseReason;

type PopoverCloseReason = "escape" | "outside-click" | "programmatic";

type PopoverCommand = CommandObject & {
  readonly type: "OPEN_CHANGE_REQUEST";
  readonly open: boolean;
  readonly reason: PopoverChangeReason;
};

type PopoverContext = {
  readonly mode: "controlled" | "uncontrolled";
};

export declare const PopoverDiagnosticCodes: readonly DiagnosticCatalogueEntry[];

type PopoverEvent = {
  readonly type: "TOGGLE";
  readonly reason: "trigger";
} | {
  readonly type: "OPEN";
  readonly reason: PopoverOpenReason;
} | {
  readonly type: "CLOSE";
  readonly reason: PopoverCloseReason;
};

type PopoverInput = {
  /** Controlled committed open state. Defining it fixes controlled mode at first start. */
  readonly open?: boolean;
  /** Uncontrolled initial open state. */
  readonly defaultOpen?: boolean;
  /** Styling-only placement hook; the machine never branches on it. */
  readonly side?: "top" | "bottom";
  /** Styling-only placement hook; the machine never branches on it. */
  readonly align?: "start" | "end";
};

export declare const popoverMachine: PopoverMachine;

type PopoverMachine = Machine<PopoverInput, PopoverStateValue, PopoverContext, PopoverEvent, PopoverCommand>;

type PopoverOpenReason = "trigger" | "programmatic";

export declare const popoverReplaySequence: readonly PopoverEvent[];

export declare const popoverSelectors: {
  open: (snapshot: PopoverSnapshot) => boolean;
};

type PopoverSnapshot = Snapshot<PopoverStateValue, PopoverContext>;

type PopoverStateValue = "open" | "closed";