selection headless API

declare function connectSelection(service: SelectionService, scope: PartScope, options?: SelectionConnectOptions): SelectionApi;

declare function dedupeSelectionIds(ids: readonly string[]): SelectionValue;

export declare const EMPTY_SELECTION_IDS: SelectionValue;

declare function isSelectableId(id: string, input: SelectionInput): boolean;

declare function rangeSelectionIds(orderedIds: readonly string[], disabledIds: readonly string[], fromId: string | null, toId: string): SelectionValue;

declare function runSelectionCommand(command: SelectionCommand, _scope: PartScope, options?: SelectionConnectOptions): void;

declare function sameSelectionIds(left: SelectionValue, right: SelectionValue): boolean;

export declare const selectionAnatomy: {
  readonly scope: "selection";
  readonly parts: readonly ["root", "item"];
};

interface SelectionApi {
  rootProps(): PartProps;
  itemProps(id: string): PartProps;
  selectAll(selectableIds?: SelectionValue): void;
  clear(): void;
  readonly selectedIds: SelectionValue;
  readonly anchorId: string | null;
  readonly mode: SelectionMode;
}

type SelectionChangeDetail = {
  readonly selectedIds: SelectionValue;
  readonly reason: SelectionChangeReason;
};

type SelectionChangeReason = "pointer" | "keyboard" | "programmatic";

type SelectionCommand = CommandObject & {
  readonly type: "SELECTION_CHANGE_REQUEST";
  readonly selectedIds: SelectionValue;
  readonly reason: SelectionChangeReason;
};

interface SelectionConnectOptions {
  readonly onSelectedIdsChange?: (detail: SelectionChangeDetail) => void;
  readonly selectableIds?: SelectionValue;
}

type SelectionContext = {
  readonly mode: BindingMode;
  readonly selectedIds: SelectionValue;
  readonly anchorId: string | null;
};

type SelectionEvent = {
  readonly type: "SELECT";
  readonly id: string;
  readonly reason: SelectionChangeReason;
} | {
  readonly type: "TOGGLE";
  readonly id: string;
  readonly reason: SelectionChangeReason;
} | {
  readonly type: "RANGE_EXTEND";
  readonly id: string;
  readonly reason: SelectionChangeReason;
} | {
  readonly type: "SELECT_ALL";
  readonly selectableIds: readonly string[];
  readonly reason: SelectionChangeReason;
} | {
  readonly type: "CLEAR";
  readonly reason: SelectionChangeReason;
} | {
  readonly type: "REPLACE";
  readonly selectedIds: SelectionValue;
  readonly reason: SelectionChangeReason;
} | {
  readonly type: "RESET";
};

declare function selectionEventFromKeyboard(mode: SelectionMode, id: string, event: KeyboardEventLike): SelectionEvent | null;

declare function selectionEventFromPointer(mode: SelectionMode, id: string, event?: ClickLikeEvent): SelectionEvent | null;

interface SelectionInput {
  readonly mode: SelectionMode;
  readonly selectedIds?: SelectionValue;
  readonly defaultSelectedIds?: SelectionValue;
  readonly orderedIds: readonly string[];
  readonly disabledIds?: readonly string[];
}

export declare const selectionMachine: SelectionMachine;

type SelectionMode = "none" | "single" | "multiple";

type SelectionPart = (typeof selectionAnatomy.parts)[number];

export declare const selectionSelectors: {
  selectedIds: (snapshot: SelectionSnapshot) => SelectionValue;
  anchorId: (snapshot: SelectionSnapshot) => string | null;
  bindingMode: (snapshot: SelectionSnapshot) => BindingMode;
  isSelected: (snapshot: SelectionSnapshot, id: string) => boolean;
};

type SelectionService = Service<SelectionInput, SelectionStateValue, SelectionContext, SelectionEvent, SelectionCommand>;

type SelectionSnapshot = Snapshot<SelectionStateValue, SelectionContext>;

type SelectionStateValue = "ready";

type SelectionValue = readonly string[];