@enigmax/primitives 0.22.0 → 0.23.0

package/dist/keys-D2zJs1uB.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Keyboard shortcuts as data: parsed from a string, matched against an event, and written
+ * back out the way the platform writes them.
+ *
+ * Two components need the same three things and would otherwise each get their own half of
+ * them - the context menu prints a shortcut beside an action, and the selection list matches
+ * one against a key press. A menu whose label says `Ctrl+A` while the list listens for
+ * `Meta+A` is the defect that shape produces, so both read this file.
+ *
+ * `Mod` is the whole point of the spec being a string. It means Command on an Apple keyboard
+ * and Control everywhere else, which is what every one of these shortcuts actually means -
+ * hardcoding either one is wrong on half the machines.
+ */
+/** One shortcut, normalized. `mod` and `ctrl`/`meta` are exclusive: `Mod` sets only `mod`. */
+interface Shortcut {
+    /** The `KeyboardEvent.key` to match, lowercased for letters (`a`, `f2`, `delete`, ` `). */
+    key: string;
+    /** Command on an Apple platform, Control elsewhere. */
+    mod?: boolean;
+    ctrl?: boolean;
+    meta?: boolean;
+    shift?: boolean;
+    alt?: boolean;
+}
+/** The parts of a key press a shortcut reads. A real KeyboardEvent satisfies it. */
+interface ShortcutEvent {
+    key: string;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+}
+/**
+ * A shortcut as written: `"Mod+A"`, `"Shift+F10"`, `"Delete"`, `"Ctrl+Shift+N"`. A list means
+ * several presses do the same thing, and `false` means the command has no binding at all.
+ */
+type ShortcutSpec = string | Shortcut | readonly (string | Shortcut)[] | false;
+/**
+ * Whether this is an Apple keyboard, and so whether `Mod` is Command.
+ *
+ * `navigator.platform` is deprecated and still the only reliable answer where it exists, so
+ * it is tried first and the user agent is the fallback. A server has neither and gets `false`,
+ * which is the right guess: a label rendered on the server is corrected on hydration, and a
+ * key press cannot happen there at all.
+ */
+declare function isApplePlatform(): boolean;
+/** `"Mod+Shift+A"` -> the shortcut it stands for. Unknown words are treated as the key. */
+declare function parseShortcut(spec: string | Shortcut): Shortcut;
+/** A spec as a list, so one binding and several read the same downstream. */
+declare function shortcutList(spec: ShortcutSpec): Shortcut[];
+/**
+ * Whether a key press is this shortcut.
+ *
+ * Every modifier is checked, including the ones the shortcut does NOT ask for: `Delete` must
+ * not fire on `Ctrl+Delete`, which means something else in every file manager there is. Shift
+ * is the one exception the caller can waive, because a shifted letter arrives as a different
+ * `key` on some layouts.
+ */
+declare function matchesShortcut(event: ShortcutEvent, spec: ShortcutSpec, apple?: boolean): boolean;
+/**
+ * The shortcut written the way this platform writes it, as tokens.
+ *
+ * Tokens rather than a string because that is what a menu renders: one `<kbd>` per key, so
+ * `Ctrl` and `A` can be spaced and styled apart. `shortcutText` joins them for anything that
+ * only has room for a string.
+ */
+declare function shortcutTokens(spec: string | Shortcut, apple?: boolean): string[];
+/** One string, for a `title`, an `aria-keyshortcuts` neighbour, or a menu with no room. */
+declare function shortcutText(spec: string | Shortcut, apple?: boolean): string;
+/**
+ * How long a typeahead buffer survives. Long enough to type a word, short enough to reset
+ * before the next thing you meant.
+ */
+declare const TYPEAHEAD_MS = 600;
+/** The buffer between two presses: what has been typed, and when. */
+interface TypeaheadState {
+    typed: string;
+    at: number;
+}
+interface TypeaheadStep extends TypeaheadState {
+    /** What to look for. The buffer, or its one repeated character - see below. */
+    needle: string;
+    /**
+     * Whether this press CYCLES through the rows starting with the letter rather than refining
+     * what the last one found. True for a single letter and for the same letter pressed again,
+     * which is the rule every desktop list follows: "rrr" is not a word anybody is typing, it
+     * is someone walking through the Rs.
+     */
+    cycle: boolean;
+}
+/**
+ * Advance a typeahead buffer.
+ *
+ * Shared because two lists in this package do the same thing with it - a select with no filter
+ * and a menu - and a buffer that timed out differently in the two would be felt as one of them
+ * being broken.
+ */
+declare function typeaheadStep(state: TypeaheadState, character: string, now?: number, windowMs?: number): TypeaheadStep;
+
+export { type Shortcut as S, TYPEAHEAD_MS as T, type ShortcutEvent as a, type ShortcutSpec as b, type TypeaheadState as c, type TypeaheadStep as d, shortcutText as e, shortcutTokens as f, isApplePlatform as i, matchesShortcut as m, parseShortcut as p, shortcutList as s, typeaheadStep as t };

package/dist/next/index.d.ts

@@ -5,9 +5,9 @@ export { M as MarqueeHover, a as MarqueeInstance, b as MarqueeOptions } from '..
 export { PasswordStrength, PasswordStrengthProps, UseButtonResult, UseInputResult, getLinkComponent, setLinkComponent, useButton, useInput } from '../react/index.js';
 export { UseSearchResult, useSearch } from '../react/search.js';
 export { I as InputAction, b as InputIcon, d as InputOptions } from '../input-BwXjFenq.js';
-export { F as FuseConstructor, a as FuseLike, S as SearchInstance, b as SearchMatch, c as SearchOptions } from '../search-BD9-5O5U.js';
+export { F as FuseConstructor, a as FuseLike, S as SearchInstance, b as SearchMatch, c as SearchOptions, s as shortenQuery } from '../search-DYgqRp37.js';
 export { c as ButtonOptions, d as ButtonState } from '../button-CaXaqG_K.js';
-export { B as BreachChecker, a as BreachState, b as BreachStatus, F as FieldAction, I as Input, c as InputBaseProps, d as InputProps, e as InputType, P as PasswordOnlyProps, g as PlainOnlyProps, S as SearchOnlyProps } from '../index-BHpOZncw.js';
+export { B as BreachChecker, a as BreachState, b as BreachStatus, F as FieldAction, I as Input, c as InputBaseProps, d as InputProps, e as InputType, P as PasswordOnlyProps, g as PlainOnlyProps, S as SearchOnlyProps } from '../index-DQNnohoo.js';
 export { Slot, SlotProps, mergeSlotProps } from '../react/slot.js';
 export { E as EstimateOptions, G as GeneratePasswordOptions, a as PasswordScore, b as PasswordStrengthReport, e as estimatePasswordStrength, g as generatePassword } from '../password-C8lG4Zm9.js';
 export { UseNotificationsResult, createNotificationQueue, defaultQueue, useNotifications } from '../react/notifications.js';
@@ -21,6 +21,13 @@ export { Flag, FlagProps } from '../react/flag.js';
 export { c as FlagFormat, d as FlagOptions, e as FlagShape, f as FlagSource, h as configureFlags, i as flagAttributes, k as flagName, l as flagSrc, m as flagView, n as normalizeFlagCode } from '../flags-BQU1V9rE.js';
 export { PaletteContent, PaletteContextValue, PaletteField, PaletteFooter, PaletteItem, PaletteList, PaletteListProps, PaletteRoot, PaletteRootProps, PaletteRow, PaletteSection, PaletteTrigger, SearchPalette, SearchPaletteProps, usePaletteContext } from '../react/palette.js';
 export { R as RecentEntry, b as RecentStore, e as createRecentStore, g as groupRows, i as isPaletteShortcut, m as moveActive, r as recentKey, s as shortcutLabel } from '../palette-D7iuQh_T.js';
+export { Select, SelectContent, SelectContextValue, SelectItem, SelectList, SelectMultipleProps, SelectOptionRow, SelectProps, SelectRoot, SelectRootProps, SelectSearch, SelectSingleProps, SelectTrigger, SelectValue, useSelectContext } from '../react/select.js';
+export { a as SelectInstance, c as SelectOption, d as SelectOptions, e as SelectState, f as createSelect } from '../select-ClSy-J1f.js';
+export { ContextMenu, ContextMenuContent, ContextMenuContentProps, ContextMenuContextValue, ContextMenuItem, ContextMenuList, ContextMenuNode, ContextMenuPanel, ContextMenuProps, ContextMenuRoot, ContextMenuRootProps, ContextMenuRow, ContextMenuSearch, ContextMenuTrigger, ContextMenuTriggerProps, useContextMenuContext } from '../react/context-menu.js';
+export { a as ContextMenuAction, b as ContextMenuEntry, c as ContextMenuInstance, g as ContextMenuOptions, j as ContextMenuState, k as createContextMenu, l as isAction } from '../context-menu-D3FtTn7v.js';
+export { MarqueeRect, SelectionList, SelectionListProps, SelectionRenderer, SelectionRowRender, UseSelectionOptions, UseSelectionResult, useSelection } from '../react/selection.js';
+export { D as DEFAULT_SELECTION_SHORTCUTS, a as SelectionCommand, b as SelectionCommandEvent, c as SelectionCommandName, d as SelectionInstance, e as SelectionOptions, f as SelectionShortcuts, g as SelectionState, h as createSelection } from '../selection-B_pmzHpy.js';
+export { S as Shortcut, b as ShortcutSpec, i as isApplePlatform, m as matchesShortcut, p as parseShortcut, e as shortcutText, f as shortcutTokens } from '../keys-D2zJs1uB.js';
 
 /**
  * The Next.js entry. Same components, wired to `next/link`.

package/dist/next/index.js

@@ -1,29 +1,36 @@
 "use client";
-export { useInput } from '../chunk-U3V4EHOB.js';
+export { useInput } from '../chunk-3HDEZ2E7.js';
+export { RelativeTime } from '../chunk-OCMI7R6H.js';
 export { PasswordStrength } from '../chunk-XQHCZAPJ.js';
+export { ContextMenu, ContextMenuContent, ContextMenuList, ContextMenuPanel, ContextMenuRoot, ContextMenuRow, ContextMenuSearch, ContextMenuTrigger, useContextMenuContext } from '../chunk-DSBYVA7V.js';
+export { SelectionList, useSelection } from '../chunk-N6PDHMAX.js';
+import { Button } from '../chunk-6BGBYUSZ.js';
+export { getLinkComponent, setLinkComponent, useButton } from '../chunk-6BGBYUSZ.js';
 export { Flag } from '../chunk-NPHRS2Q7.js';
 export { Toaster, toast, useSonner } from '../chunk-WPTBURIC.js';
+export { createNotificationQueue, defaultQueue, useNotifications } from '../chunk-QYMUIW5I.js';
 export { useMarquee } from '../chunk-ZWR2EXHQ.js';
-export { useSearch } from '../chunk-QQFNAKMY.js';
+export { useSearch } from '../chunk-45UHLZYT.js';
 export { useNetworkState } from '../chunk-S653GLSF.js';
-export { createNotificationQueue, defaultQueue, useNotifications } from '../chunk-QYMUIW5I.js';
-export { RelativeTime } from '../chunk-OCMI7R6H.js';
 import '../chunk-KJINGUQN.js';
+import '../chunk-IXVMRVD4.js';
 export { estimatePasswordStrength, generatePassword } from '../chunk-HC2ME5PU.js';
+export { createContextMenu, isAction } from '../chunk-3BQVOOAM.js';
+export { DEFAULT_SELECTION_SHORTCUTS, createSelection } from '../chunk-WSQC3PCC.js';
+import '../chunk-MMQPZGSU.js';
 export { configureFlags, flagAttributes, flagName, flagSrc, flagView, normalizeFlagCode } from '../chunk-LMZJBOZG.js';
+import '../chunk-SNYUBXWQ.js';
 import '../chunk-UOSSNUSC.js';
 import '../chunk-2QFTRNAZ.js';
-import '../chunk-SNYUBXWQ.js';
-import '../chunk-IXVMRVD4.js';
-export { Input } from '../chunk-R4ZAEE7V.js';
+export { Input } from '../chunk-KEVZ5XQV.js';
 import '../chunk-F25CGNQC.js';
-export { PaletteContent, PaletteField, PaletteFooter, PaletteItem, PaletteList, PaletteRoot, PaletteTrigger, SearchPalette, usePaletteContext } from '../chunk-FWVWX67R.js';
-export { createRecentStore, groupRows, isPaletteShortcut, moveActive, recentKey, shortcutLabel } from '../chunk-DTWZDONY.js';
-import '../chunk-D5A2ZMAG.js';
-import { Button } from '../chunk-6BGBYUSZ.js';
-export { getLinkComponent, setLinkComponent, useButton } from '../chunk-6BGBYUSZ.js';
-import '../chunk-MMQPZGSU.js';
+export { PaletteContent, PaletteField, PaletteFooter, PaletteItem, PaletteList, PaletteRoot, PaletteTrigger, SearchPalette, usePaletteContext } from '../chunk-FGBIZDV2.js';
+export { Select, SelectContent, SelectList, SelectOptionRow, SelectRoot, SelectSearch, SelectTrigger, SelectValue, useSelectContext } from '../chunk-VKL3DEIQ.js';
+export { createSelect } from '../chunk-NONGREXC.js';
+export { isApplePlatform, matchesShortcut, parseShortcut, shortcutText, shortcutTokens } from '../chunk-4VUHQFAT.js';
 export { Slot, mergeSlotProps } from '../chunk-HS3X3XCW.js';
+export { createRecentStore, groupRows, isPaletteShortcut, moveActive, recentKey, shortcutLabel } from '../chunk-DTWZDONY.js';
+export { shortenQuery } from '../chunk-4ZPMP47J.js';
 import Link from 'next/link';
 import { forwardRef, createElement } from 'react';
 

package/dist/react/context-menu.d.ts

@@ -0,0 +1,202 @@
+import { ReactNode, RefObject, ComponentPropsWithoutRef } from 'react';
+import { a as ContextMenuAction, b as ContextMenuEntry, c as ContextMenuInstance, j as ContextMenuState, h as ContextMenuPoint, g as ContextMenuOptions } from '../context-menu-D3FtTn7v.js';
+export { C as CONTEXT_MENU_SEARCH_KEYS, d as ContextMenuLabel, e as ContextMenuLevel, f as ContextMenuMoveKey, i as ContextMenuSeparator, k as createContextMenu, l as isAction } from '../context-menu-D3FtTn7v.js';
+export { S as Shortcut, b as ShortcutSpec, m as matchesShortcut, p as parseShortcut, e as shortcutText, f as shortcutTokens } from '../keys-D2zJs1uB.js';
+import '../search-DYgqRp37.js';
+
+/**
+ * One row, as React draws it. The core carries `icon` as `unknown` because it cannot know
+ * what a node is; here it is one.
+ */
+interface ContextMenuItem extends Omit<ContextMenuAction, "icon" | "items"> {
+    icon?: ReactNode;
+    items?: readonly ContextMenuNode[];
+}
+/** Anything that can appear in a menu, with React's icon type. */
+type ContextMenuNode = ContextMenuItem | Exclude<ContextMenuEntry, ContextMenuAction>;
+interface ContextMenuContextValue {
+    instance: ContextMenuInstance;
+    state: ContextMenuState;
+    /** Open at a point. False when there was nothing to show, so the press is left alone. */
+    open: (point: ContextMenuPoint) => boolean;
+    close: () => void;
+    /** ids the parts need to point at each other. */
+    ids: {
+        trigger: string;
+    };
+    panelId: (level: number) => string;
+    itemId: (level: number, index: number) => string;
+    triggerRef: RefObject<HTMLElement | null>;
+    /** Which panel the keyboard is in. Always the deepest open one. */
+    onMenuKeyDown: (event: React.KeyboardEvent) => void;
+    /** How long the pointer must rest on a row before its submenu opens, and before one closes. */
+    delays: {
+        open: number;
+        close: number;
+    };
+    /** Drop the pending close, wherever it was scheduled. Called wherever the pointer lands. */
+    cancelClose: () => void;
+    /** Close everything below `level`, after the beat - replacing any close already waiting. */
+    scheduleClose: (level: number) => void;
+    /** Draw a row instead of the default icon / label / shortcut. */
+    renderItem?: (item: ContextMenuItem, level: number, index: number) => ReactNode;
+    /** Shown while a fetched submenu has not answered. */
+    loadingLabel: ReactNode;
+    /** Shown when a filter matched nothing, or a fetched submenu came back with nothing. */
+    emptyLabel: ReactNode;
+}
+declare function useContextMenuContext(part: string): ContextMenuContextValue;
+
+interface ContextMenuRootProps {
+    /** The rows. A list with nothing selectable in it opens no menu at all. */
+    items: readonly ContextMenuNode[];
+    /** A heading over the rows, naming what the menu is acting on. */
+    title?: string;
+    /** A row was invoked. The menu has already closed by the time this runs. */
+    onSelect?: (item: ContextMenuItem, path: string[]) => void;
+    onOpenChange?: (open: boolean) => void;
+    /** Nothing opens, and the press is left to the browser. For a disabled row or a read-only view. */
+    disabled?: boolean;
+    /** Fuse.js's constructor, for fuzzy filtering. Omit it for the built-in matcher. */
+    fuse?: ContextMenuOptions["fuse"];
+    fuseOptions?: Record<string, unknown>;
+    matcher?: ContextMenuOptions["matcher"];
+    searchKeys?: string[];
+    /** How long a fetched submenu stays cached. 0 refetches every time. Default 5 minutes. */
+    cacheMs?: number;
+    /** Hover timings, in ms. Leave them alone unless the design genuinely needs otherwise. */
+    openDelay?: number;
+    closeDelay?: number;
+    /** Draw a row instead of the default icon / label / shortcut. */
+    renderItem?: (item: ContextMenuItem, level: number, index: number) => ReactNode;
+    loadingLabel?: ReactNode;
+    emptyLabel?: ReactNode;
+    /** Inject the baseline stylesheet. See the note above. */
+    styles?: boolean;
+    children?: ReactNode;
+}
+declare function ContextMenuRoot(props: ContextMenuRootProps): ReactNode;
+interface ContextMenuTriggerProps extends ComponentPropsWithoutRef<"div"> {
+    /** Put the behaviour on your own element instead of a wrapper div. */
+    asChild?: boolean;
+    /** Open on a long press as well, which is what a right-click is on a touch screen. */
+    longPress?: boolean;
+}
+/**
+ * The area a right-click opens the menu over.
+ *
+ * It is `tabIndex={0}` and answers Shift+F10 and the Menu key, because a context menu reached
+ * only by right-clicking is one a keyboard user cannot open at all - and those two are the
+ * shortcuts the platform already assigns to it. Opened that way it appears at the element's
+ * own corner rather than at a pointer that was never there.
+ */
+declare function ContextMenuTrigger({ asChild, longPress, children, ...props }: ContextMenuTriggerProps): ReactNode;
+interface ContextMenuContentProps extends ComponentPropsWithoutRef<"div"> {
+    /** How many rows to put in the document at once. `Infinity` renders the lot. */
+    chunk?: number;
+    /** Render the panels where they are instead of in `<body>`. See the note on Root. */
+    portal?: boolean;
+}
+/** The whole open branch: the root panel, then one panel per open submenu. */
+declare function ContextMenuContent({ chunk, portal, ...props }: ContextMenuContentProps): ReactNode;
+interface ContextMenuPanelProps extends ComponentPropsWithoutRef<"div"> {
+    level: number;
+    chunk?: number;
+}
+/**
+ * One level: its heading, its filter and its rows, placed against the thing that opened it.
+ *
+ * The root panel is placed at the pointer; a submenu is placed against the ROW that opened
+ * it. Both flip rather than overflow - a menu opened near the right edge of the window opens
+ * leftwards, and one near the bottom opens upwards, because the alternative is a panel whose
+ * rows are off the screen and unreachable.
+ */
+declare function ContextMenuPanel({ level, chunk, ...props }: ContextMenuPanelProps): ReactNode;
+interface ContextMenuSearchProps extends Omit<ComponentPropsWithoutRef<"input">, "value" | "onChange" | "type"> {
+    level: number;
+    placeholder?: string;
+}
+declare function ContextMenuSearch({ level, placeholder, onKeyDown, ...props }: ContextMenuSearchProps): ReactNode;
+interface ContextMenuListProps extends ComponentPropsWithoutRef<"div"> {
+    level: number;
+    chunk?: number;
+}
+/**
+ * The rows of one level, rendered a window at a time.
+ *
+ * A menu is usually short and this costs nothing there. It stops costing nothing the moment a
+ * submenu is a list of files, a branch, a tag or a device - which is exactly the submenu that
+ * is fetched, and the one that would otherwise put five hundred subtrees in the document for
+ * the eight rows anybody sees.
+ */
+declare function ContextMenuList({ level, chunk, ...props }: ContextMenuListProps): ReactNode;
+interface ContextMenuRowProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
+    level: number;
+    /** Its position in the level's VISIBLE list, which is what the keyboard moves through. */
+    index: number;
+    entry: ContextMenuEntry;
+    children?: ReactNode;
+}
+declare function ContextMenuRow({ level, index, entry, children, ...props }: ContextMenuRowProps): ReactNode;
+
+/**
+ * The context menu's baseline look.
+ *
+ * A string rather than a stylesheet because `<ContextMenu.Root>` injects it, for the same
+ * reason the select does: a popup with no styles is not a plain-looking control, it is
+ * transparent text lying on top of the page - and this one is drawn at the pointer, over
+ * whatever happens to be under it. `scripts/sync-recipes.mjs` generates
+ * `recipes/context-menu/styles.css` from here, and CI fails when the two drift.
+ *
+ * Everything below is either a custom property or an attribute selector: override the
+ * properties on `:root` for a different-looking menu without writing one selector. The sheet
+ * is PREPENDED to `<head>`, so anything the document already has wins on source order at
+ * equal specificity.
+ */
+declare const CONTEXT_MENU_STYLES = "\n:root {\n    --enigma-menu-bg: #1c1c1c;\n    --enigma-menu-border: #333333;\n    --enigma-menu-radius: 0.625rem;\n    --enigma-menu-shadow: 0 12px 32px rgba(0, 0, 0, 0.45);\n    --enigma-menu-text: #f5f5f5;\n    --enigma-menu-muted: #a3a3a3;\n    --enigma-menu-font-size: 0.8125rem;\n    --enigma-menu-min-width: 12rem;\n    --enigma-menu-max-height: 20rem;\n\n    --enigma-menu-active-bg: #2a2a2a;\n    --enigma-menu-accent: #fbbf24;\n    --enigma-menu-danger: #f87171;\n    --enigma-menu-danger-bg: rgba(248, 113, 113, 0.12);\n}\n\n@media (prefers-color-scheme: light) {\n    :root {\n        --enigma-menu-bg: #ffffff;\n        --enigma-menu-border: #e5e5e5;\n        --enigma-menu-shadow: 0 12px 32px rgba(0, 0, 0, 0.12);\n        --enigma-menu-text: #171717;\n        --enigma-menu-muted: #737373;\n        --enigma-menu-active-bg: #f5f5f5;\n        --enigma-menu-accent: #b45309;\n        --enigma-menu-danger: #b91c1c;\n        --enigma-menu-danger-bg: rgba(185, 28, 28, 0.08);\n    }\n}\n\n/* Every panel is positioned in VIEWPORT coordinates, which is what a pointer event reports\n   and what a menu opened at the pointer needs. Fixed rather than absolute so a scrolling\n   ancestor cannot drag it away from the place it was opened. */\n[data-enigma-menu-panel] {\n    position: fixed; z-index: 60;\n    box-sizing: border-box;\n    min-width: var(--enigma-menu-min-width);\n    max-width: min(22rem, calc(100vw - 1rem));\n    padding: 0.25rem;\n    color: var(--enigma-menu-text);\n    background: var(--enigma-menu-bg);\n    border: 1px solid var(--enigma-menu-border);\n    border-radius: var(--enigma-menu-radius);\n    box-shadow: var(--enigma-menu-shadow);\n    font-size: var(--enigma-menu-font-size);\n    animation: enigma-menu-in 90ms ease-out;\n    /* Measured before it is placed, and placed before it is seen: without this the panel is\n       painted at 0,0 for one frame and jumps to the pointer on the next. */\n    visibility: hidden;\n}\n[data-enigma-menu-panel][data-placed] { visibility: visible; }\n@keyframes enigma-menu-in {\n    from { opacity: 0; transform: scale(0.98); }\n    to { opacity: 1; transform: none; }\n}\n@media (prefers-reduced-motion: reduce) {\n    [data-enigma-menu-panel] { animation: none; }\n}\n\n/* The heading: what the menu is acting ON. A long file name is cut rather than allowed to\n   set the panel's width, and the full one stays reachable through its title attribute. */\n[data-enigma-menu-title] {\n    margin: 0; padding: 0.375rem 0.5rem 0.25rem;\n    font-size: 0.6875rem; font-weight: 600;\n    color: var(--enigma-menu-muted);\n    overflow: hidden; white-space: nowrap; text-overflow: ellipsis;\n}\n\n[data-enigma-menu-search] {\n    width: 100%; box-sizing: border-box;\n    padding: 0.375rem 0.5rem 0.5rem;\n    font: inherit; font-size: var(--enigma-menu-font-size);\n    color: var(--enigma-menu-text); background: transparent;\n    border: 0; border-bottom: 1px solid var(--enigma-menu-border);\n    outline: none;\n}\n[data-enigma-menu-search]::-webkit-search-cancel-button,\n[data-enigma-menu-search]::-webkit-search-decoration { -webkit-appearance: none; appearance: none; }\n\n[data-enigma-menu-list] {\n    max-height: var(--enigma-menu-max-height);\n    overflow-y: auto; overscroll-behavior: contain;\n}\n\n[data-enigma-menu-item] {\n    display: flex; align-items: center; gap: 0.5rem;\n    padding: 0.3125rem 0.5rem; border-radius: 0.375rem;\n    line-height: 1.4;\n    color: var(--enigma-menu-text);\n    /* The hand, not the arrow. A native menu uses the arrow because the whole surface is\n       drawn by the OS and nothing on a page looks like it; here the rows sit on a web page,\n       where the hand is what says \"this is a thing you press\". */\n    cursor: pointer; user-select: none;\n}\n[data-enigma-menu-item][data-active] { background: var(--enigma-menu-active-bg); }\n[data-enigma-menu-item][data-disabled] { opacity: 0.45; cursor: not-allowed; }\n[data-enigma-menu-item][data-destructive] { color: var(--enigma-menu-danger); }\n[data-enigma-menu-item][data-destructive][data-active] { background: var(--enigma-menu-danger-bg); }\n\n[data-enigma-menu-item-text] { display: grid; min-width: 0; }\n[data-enigma-menu-item-label] { overflow: hidden; white-space: nowrap; text-overflow: ellipsis; }\n[data-enigma-menu-item-description] {\n    font-size: 0.6875rem; color: var(--enigma-menu-muted);\n    overflow: hidden; white-space: nowrap; text-overflow: ellipsis;\n}\n\n[data-enigma-menu-icon] { display: inline-flex; align-items: center; flex: none; width: 1rem; max-height: 1.25em; line-height: 0; }\n\n/* The shortcut, on the right, the way every desktop menu prints it. margin-left: auto is\n   what pushes it there, and flex: none is what stops a long label squashing it. */\n[data-enigma-menu-shortcut] {\n    display: flex; align-items: center; gap: 0.125rem;\n    flex: none; margin-left: auto; padding-left: 1.5rem;\n    font-size: 0.6875rem; color: var(--enigma-menu-muted);\n    font-variant-numeric: tabular-nums;\n}\n[data-enigma-menu-shortcut] kbd { font: inherit; }\n\n/* The submenu arrow shares the shortcut's slot, so a row never has both pushed apart. */\n[data-enigma-menu-arrow] {\n    flex: none; margin-left: auto;\n    width: 0.35rem; height: 0.35rem;\n    border-right: 1.5px solid currentColor; border-top: 1.5px solid currentColor;\n    transform: rotate(45deg);\n    opacity: 0.6;\n}\n[data-enigma-menu-shortcut] + [data-enigma-menu-arrow] { margin-left: 0.5rem; }\n\n/* Check and radio: drawn rather than loaded, and reserving their space either way so\n   choosing a row does not shift the label under the pointer. */\n[data-enigma-menu-check] {\n    flex: none; width: 1rem; height: 1rem;\n    display: grid; place-items: center;\n    color: var(--enigma-menu-accent);\n}\n[data-enigma-menu-check]::after { content: \"\"; width: 0.35rem; height: 0.6rem; opacity: 0; }\n[data-enigma-menu-item][aria-checked=\"true\"] [data-enigma-menu-check]::after {\n    opacity: 1;\n    border-right: 2px solid currentColor; border-bottom: 2px solid currentColor;\n    transform: rotate(45deg) translate(-0.05rem, -0.05rem);\n}\n[data-enigma-menu-item][role=\"menuitemradio\"] [data-enigma-menu-check]::after {\n    width: 0.4rem; height: 0.4rem; border-radius: 999px; background: currentColor;\n    transform: none; border: 0;\n}\n\n[data-enigma-menu-separator] {\n    height: 1px; margin: 0.25rem 0.25rem;\n    background: var(--enigma-menu-border);\n}\n\n[data-enigma-menu-label] {\n    margin: 0.375rem 0 0.125rem; padding: 0 0.5rem;\n    font-size: 0.6875rem; font-weight: 600; text-transform: uppercase; letter-spacing: 0.08em;\n    color: var(--enigma-menu-muted);\n}\n\n[data-enigma-menu-status] {\n    margin: 0; padding: 0.625rem 0.5rem;\n    font-size: var(--enigma-menu-font-size); color: var(--enigma-menu-muted);\n    /* The quoted query is cut in the text as well, but a pasted string with no spaces has no\n       break opportunity at all - so this is what stops it stretching the panel. */\n    overflow-wrap: anywhere;\n}\n[data-enigma-menu-status][data-error] { color: var(--enigma-menu-danger); }\n\n/* The end-of-window marker: one pixel, so it has a box to be scrolled into. */\n[data-enigma-menu-more] { height: 1px; }\n";
+
+type ContextMenuProps = ContextMenuRootProps & {
+    /** How many rows to put in the document at once. `Infinity` renders the lot. */
+    chunk?: ContextMenuContentProps["chunk"];
+    /** Open on a long press as well, which is what a right-click is on a touch screen. */
+    longPress?: boolean;
+    triggerProps?: ContextMenuTriggerProps;
+    contentProps?: ContextMenuContentProps;
+};
+/**
+ * The context menu, assembled.
+ *
+ * ```tsx
+ * <ContextMenu
+ *     title={file.name}
+ *     items={[
+ *         { id: "rename", label: "Rename", shortcut: "F2", icon: <Pencil /> },
+ *         { type: "separator" },
+ *         { id: "delete", label: "Delete", shortcut: "Delete", destructive: true }
+ *     ]}
+ *     onSelect={(item) => run(item.id)}
+ * >
+ *     <FileRow file={file} />
+ * </ContextMenu>
+ * ```
+ *
+ * Everything it renders is a part you can render yourself instead - see `ContextMenu.Root`
+ * for the anatomy. This is those parts in the order they belong in, not a different
+ * component: the children become the area a right-click opens the menu over.
+ *
+ * A menu with no rows to show does not open, and the press falls through to the browser's own
+ * menu - an empty box at the pointer tells the reader nothing, and swallowing the press to
+ * show one tells them less.
+ */
+declare function ContextMenu(props: ContextMenuProps): ReactNode;
+declare namespace ContextMenu {
+    var Root: typeof ContextMenuRoot;
+    var Trigger: typeof ContextMenuTrigger;
+    var Content: typeof ContextMenuContent;
+    var Panel: typeof ContextMenuPanel;
+    var Search: typeof ContextMenuSearch;
+    var List: typeof ContextMenuList;
+    var Item: typeof ContextMenuRow;
+}
+
+export { CONTEXT_MENU_STYLES, ContextMenu, ContextMenuAction, ContextMenuContent, type ContextMenuContentProps, type ContextMenuContextValue, ContextMenuEntry, ContextMenuInstance, type ContextMenuItem, ContextMenuList, type ContextMenuListProps, type ContextMenuNode, ContextMenuOptions, ContextMenuPanel, type ContextMenuPanelProps, ContextMenuPoint, type ContextMenuProps, ContextMenuRoot, type ContextMenuRootProps, ContextMenuRow, type ContextMenuRowProps, ContextMenuSearch, type ContextMenuSearchProps, ContextMenuState, ContextMenuTrigger, type ContextMenuTriggerProps, useContextMenuContext };

package/dist/react/context-menu.js

@@ -0,0 +1,6 @@
+"use client";
+export { CONTEXT_MENU_STYLES, ContextMenu, ContextMenuContent, ContextMenuList, ContextMenuPanel, ContextMenuRoot, ContextMenuRow, ContextMenuSearch, ContextMenuTrigger, useContextMenuContext } from '../chunk-DSBYVA7V.js';
+export { CONTEXT_MENU_SEARCH_KEYS, createContextMenu, isAction } from '../chunk-3BQVOOAM.js';
+export { matchesShortcut, parseShortcut, shortcutText, shortcutTokens } from '../chunk-4VUHQFAT.js';
+import '../chunk-HS3X3XCW.js';
+import '../chunk-4ZPMP47J.js';

package/dist/react/index.d.ts

@@ -4,11 +4,11 @@ import { d as InputOptions } from '../input-BwXjFenq.js';
 export { I as InputAction, b as InputIcon } from '../input-BwXjFenq.js';
 import { RefObject, ElementType, ComponentPropsWithoutRef, ReactNode } from 'react';
 export { UseSearchResult, useSearch } from './search.js';
-export { F as FuseConstructor, a as FuseLike, S as SearchInstance, b as SearchMatch, c as SearchOptions } from '../search-BD9-5O5U.js';
+export { F as FuseConstructor, a as FuseLike, S as SearchInstance, b as SearchMatch, c as SearchOptions, s as shortenQuery } from '../search-DYgqRp37.js';
 import { d as ButtonState, c as ButtonOptions } from '../button-CaXaqG_K.js';
 export { Button, ButtonProps } from './button.js';
-import { f as PasswordStrengthClassNames } from '../index-BHpOZncw.js';
-export { B as BreachChecker, a as BreachState, b as BreachStatus, F as FieldAction, I as Input, c as InputBaseProps, d as InputProps, e as InputType, P as PasswordOnlyProps, g as PlainOnlyProps, S as SearchOnlyProps } from '../index-BHpOZncw.js';
+import { f as PasswordStrengthClassNames } from '../index-DQNnohoo.js';
+export { B as BreachChecker, a as BreachState, b as BreachStatus, F as FieldAction, I as Input, c as InputBaseProps, d as InputProps, e as InputType, P as PasswordOnlyProps, g as PlainOnlyProps, S as SearchOnlyProps } from '../index-DQNnohoo.js';
 import { b as PasswordStrengthReport } from '../password-C8lG4Zm9.js';
 export { E as EstimateOptions, G as GeneratePasswordOptions, a as PasswordScore, e as estimatePasswordStrength, g as generatePassword } from '../password-C8lG4Zm9.js';
 export { Slot, SlotProps, mergeSlotProps } from './slot.js';
@@ -23,6 +23,13 @@ export { Flag, FlagProps } from './flag.js';
 export { c as FlagFormat, d as FlagOptions, e as FlagShape, f as FlagSource, h as configureFlags, i as flagAttributes, k as flagName, l as flagSrc, m as flagView, n as normalizeFlagCode } from '../flags-BQU1V9rE.js';
 export { PaletteContent, PaletteContextValue, PaletteField, PaletteFooter, PaletteItem, PaletteList, PaletteListProps, PaletteRoot, PaletteRootProps, PaletteRow, PaletteSection, PaletteTrigger, SearchPalette, SearchPaletteProps, usePaletteContext } from './palette.js';
 export { R as RecentEntry, b as RecentStore, e as createRecentStore, g as groupRows, i as isPaletteShortcut, m as moveActive, r as recentKey, s as shortcutLabel } from '../palette-D7iuQh_T.js';
+export { Select, SelectContent, SelectContextValue, SelectItem, SelectList, SelectMultipleProps, SelectOptionRow, SelectProps, SelectRoot, SelectRootProps, SelectSearch, SelectSingleProps, SelectTrigger, SelectValue, useSelectContext } from './select.js';
+export { a as SelectInstance, c as SelectOption, d as SelectOptions, e as SelectState, f as createSelect } from '../select-ClSy-J1f.js';
+export { ContextMenu, ContextMenuContent, ContextMenuContentProps, ContextMenuContextValue, ContextMenuItem, ContextMenuList, ContextMenuNode, ContextMenuPanel, ContextMenuProps, ContextMenuRoot, ContextMenuRootProps, ContextMenuRow, ContextMenuSearch, ContextMenuTrigger, ContextMenuTriggerProps, useContextMenuContext } from './context-menu.js';
+export { a as ContextMenuAction, b as ContextMenuEntry, c as ContextMenuInstance, g as ContextMenuOptions, j as ContextMenuState, k as createContextMenu, l as isAction } from '../context-menu-D3FtTn7v.js';
+export { MarqueeRect, SelectionList, SelectionListProps, SelectionRenderer, SelectionRowRender, UseSelectionOptions, UseSelectionResult, useSelection } from './selection.js';
+export { D as DEFAULT_SELECTION_SHORTCUTS, a as SelectionCommand, b as SelectionCommandEvent, c as SelectionCommandName, d as SelectionInstance, e as SelectionOptions, f as SelectionShortcuts, g as SelectionState, h as createSelection } from '../selection-B_pmzHpy.js';
+export { S as Shortcut, b as ShortcutSpec, i as isApplePlatform, m as matchesShortcut, p as parseShortcut, e as shortcutText, f as shortcutTokens } from '../keys-D2zJs1uB.js';
 
 interface UseInputResult {
     /** Attach to the `<input>`. */

package/dist/react/index.js

@@ -1,25 +1,32 @@
 "use client";
-export { useInput } from '../chunk-U3V4EHOB.js';
+export { useInput } from '../chunk-3HDEZ2E7.js';
+export { RelativeTime } from '../chunk-OCMI7R6H.js';
 export { PasswordStrength } from '../chunk-XQHCZAPJ.js';
+export { ContextMenu, ContextMenuContent, ContextMenuList, ContextMenuPanel, ContextMenuRoot, ContextMenuRow, ContextMenuSearch, ContextMenuTrigger, useContextMenuContext } from '../chunk-DSBYVA7V.js';
+export { SelectionList, useSelection } from '../chunk-N6PDHMAX.js';
+export { Button, getLinkComponent, setLinkComponent, useButton } from '../chunk-6BGBYUSZ.js';
 export { Flag } from '../chunk-NPHRS2Q7.js';
 export { Toaster, toast, useSonner } from '../chunk-WPTBURIC.js';
+export { createNotificationQueue, defaultQueue, useNotifications } from '../chunk-QYMUIW5I.js';
 export { useMarquee } from '../chunk-ZWR2EXHQ.js';
-export { useSearch } from '../chunk-QQFNAKMY.js';
+export { useSearch } from '../chunk-45UHLZYT.js';
 export { useNetworkState } from '../chunk-S653GLSF.js';
-export { createNotificationQueue, defaultQueue, useNotifications } from '../chunk-QYMUIW5I.js';
-export { RelativeTime } from '../chunk-OCMI7R6H.js';
 import '../chunk-KJINGUQN.js';
+import '../chunk-IXVMRVD4.js';
 export { estimatePasswordStrength, generatePassword } from '../chunk-HC2ME5PU.js';
+export { createContextMenu, isAction } from '../chunk-3BQVOOAM.js';
+export { DEFAULT_SELECTION_SHORTCUTS, createSelection } from '../chunk-WSQC3PCC.js';
+import '../chunk-MMQPZGSU.js';
 export { configureFlags, flagAttributes, flagName, flagSrc, flagView, normalizeFlagCode } from '../chunk-LMZJBOZG.js';
+import '../chunk-SNYUBXWQ.js';
 import '../chunk-UOSSNUSC.js';
 import '../chunk-2QFTRNAZ.js';
-import '../chunk-SNYUBXWQ.js';
-import '../chunk-IXVMRVD4.js';
-export { Input } from '../chunk-R4ZAEE7V.js';
+export { Input } from '../chunk-KEVZ5XQV.js';
 import '../chunk-F25CGNQC.js';
-export { PaletteContent, PaletteField, PaletteFooter, PaletteItem, PaletteList, PaletteRoot, PaletteTrigger, SearchPalette, usePaletteContext } from '../chunk-FWVWX67R.js';
-export { createRecentStore, groupRows, isPaletteShortcut, moveActive, recentKey, shortcutLabel } from '../chunk-DTWZDONY.js';
-import '../chunk-D5A2ZMAG.js';
-export { Button, getLinkComponent, setLinkComponent, useButton } from '../chunk-6BGBYUSZ.js';
-import '../chunk-MMQPZGSU.js';
+export { PaletteContent, PaletteField, PaletteFooter, PaletteItem, PaletteList, PaletteRoot, PaletteTrigger, SearchPalette, usePaletteContext } from '../chunk-FGBIZDV2.js';
+export { Select, SelectContent, SelectList, SelectOptionRow, SelectRoot, SelectSearch, SelectTrigger, SelectValue, useSelectContext } from '../chunk-VKL3DEIQ.js';
+export { createSelect } from '../chunk-NONGREXC.js';
+export { isApplePlatform, matchesShortcut, parseShortcut, shortcutText, shortcutTokens } from '../chunk-4VUHQFAT.js';
 export { Slot, mergeSlotProps } from '../chunk-HS3X3XCW.js';
+export { createRecentStore, groupRows, isPaletteShortcut, moveActive, recentKey, shortcutLabel } from '../chunk-DTWZDONY.js';
+export { shortenQuery } from '../chunk-4ZPMP47J.js';

package/dist/react/input.d.ts

@@ -1,4 +1,4 @@
-export { B as BreachChecker, a as BreachState, b as BreachStatus, F as FieldAction, I as Input, c as InputBaseProps, d as InputProps, e as InputType, P as PasswordOnlyProps, g as PlainOnlyProps, S as SearchOnlyProps } from '../index-BHpOZncw.js';
+export { B as BreachChecker, a as BreachState, b as BreachStatus, F as FieldAction, I as Input, c as InputBaseProps, d as InputProps, e as InputType, P as PasswordOnlyProps, g as PlainOnlyProps, S as SearchOnlyProps } from '../index-DQNnohoo.js';
 import 'react';
-import '../search-BD9-5O5U.js';
+import '../search-DYgqRp37.js';
 import '../password-C8lG4Zm9.js';

package/dist/react/input.js

@@ -1,3 +1,3 @@
 "use client";
-export { Input } from '../chunk-R4ZAEE7V.js';
+export { Input } from '../chunk-KEVZ5XQV.js';
 import '../chunk-F25CGNQC.js';

package/dist/react/palette.d.ts

@@ -1,5 +1,5 @@
 import { ComponentPropsWithoutRef, ReactNode } from 'react';
-import { b as SearchMatch, c as SearchOptions } from '../search-BD9-5O5U.js';
+import { b as SearchMatch, c as SearchOptions } from '../search-DYgqRp37.js';
 import { R as RecentEntry } from '../palette-D7iuQh_T.js';
 
 /** One line in the palette, whatever it came from. */

package/dist/react/palette.js

@@ -1,5 +1,5 @@
 "use client";
-export { PaletteContent, PaletteField, PaletteFooter, PaletteItem, PaletteList, PaletteRoot, PaletteTrigger, SearchPalette, usePaletteContext } from '../chunk-FWVWX67R.js';
-import '../chunk-DTWZDONY.js';
-import '../chunk-D5A2ZMAG.js';
+export { PaletteContent, PaletteField, PaletteFooter, PaletteItem, PaletteList, PaletteRoot, PaletteTrigger, SearchPalette, usePaletteContext } from '../chunk-FGBIZDV2.js';
 import '../chunk-HS3X3XCW.js';
+import '../chunk-DTWZDONY.js';
+import '../chunk-4ZPMP47J.js';

package/dist/react/search.d.ts

@@ -1,5 +1,5 @@
 import { RefObject } from 'react';
-import { b as SearchMatch, c as SearchOptions } from '../search-BD9-5O5U.js';
+import { b as SearchMatch, c as SearchOptions } from '../search-DYgqRp37.js';
 
 interface UseSearchResult<T> {
     /** Attach to the search field, or drive it yourself with `search`. */

package/dist/react/search.js

@@ -1,3 +1,3 @@
 "use client";
-export { useSearch } from '../chunk-QQFNAKMY.js';
-import '../chunk-D5A2ZMAG.js';
+export { useSearch } from '../chunk-45UHLZYT.js';
+import '../chunk-4ZPMP47J.js';