@charcuterie/ui 4.24.0 → 4.26.0

package/dist/CommandPalette/commandPaletteSections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandPaletteSections.d.ts","sourceRoot":"","sources":["../../src/CommandPalette/commandPaletteSections.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,yGAAyG;IACzG,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,qGAAqG;IACrG,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAA;IACX,4EAA4E;IAC5E,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,yGAAyG;IACzG,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAA;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IACnC,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAA;IACb,gDAAgD;IAChD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,kBAAkB,CAAA;IACxB,iEAAiE;IACjE,WAAW,EAAE,SAAS,cAAc,EAAE,CAAA;CACvC,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,SAAS,iBAAiB,EAAE,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC1C,iBAAiB,EAAE,CACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,KACV,MAAM,CAAA;IACX,eAAe,CAAC,EAAE,CAChB,KAAK,EAAE,MAAM,KACV,kBAAkB,GAAG,IAAI,GAAG,SAAS,CAAA;IAC1C,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAA;IACpC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAA;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAA;IAC3C,cAAc,EAAE,MAAM,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,2BAA2B,GAAI,oIAUzC,6BAA6B,KAAG,qBAAqB,EAqGvD,CAAA"}

package/dist/CommandPalette/commandPaletteSections.js

@@ -0,0 +1,94 @@
+import { parsePrefixCommand, rankWordPrefixMatches, } from "@charcuterie/logic";
+/**
+ * What the palette lists for a query, as headed sections in order.
+ *
+ * Three cases, decided in this order:
+ *
+ * 1. **A prefix command** (`au lego`) lists one row, for that target.
+ * 2. **Nothing typed** lists the caller's `suggestions` — the shape
+ *    the palette exists for: something to choose the moment it opens.
+ * 3. **Anything else** lists the word-prefix matches from `items`,
+ *    under each item's `group`, and then the caller's fallback row.
+ *
+ * Matched groups are ordered by their best member, so the first row
+ * — the one Enter opens — is always the best match, whichever group
+ * it belongs to.
+ */
+export const buildCommandPaletteSections = ({ formatPrefixTitle, getFallbackItem, items, maxResultsPerGroup, prefixGroupLabel, prefixes, query, suggestions, ungroupedLabel, }) => {
+    const command = parsePrefixCommand(query, prefixes);
+    if (command !== null) {
+        const { query: commandQuery, target } = command;
+        return [
+            {
+                key: "prefix",
+                label: prefixGroupLabel,
+                rows: [
+                    {
+                        item: {
+                            href: target.getHref?.(commandQuery),
+                            icon: target.icon,
+                            key: `prefix-${target.prefix}`,
+                            onSelect: target.onSelect === undefined
+                                ? undefined
+                                : () => target.onSelect?.(commandQuery),
+                            title: formatPrefixTitle(target.label, commandQuery),
+                        },
+                        titleRanges: [],
+                    },
+                ],
+            },
+        ];
+    }
+    const trimmedQuery = query.trim();
+    if (trimmedQuery.length === 0) {
+        return suggestions
+            .filter((group) => group.items.length > 0)
+            .map((group) => ({
+            key: `suggestion-${group.key}`,
+            label: group.label,
+            rows: group.items.map((item) => ({
+                item,
+                titleRanges: [],
+            })),
+        }));
+    }
+    const ranked = rankWordPrefixMatches(items, trimmedQuery, (item) => ({
+        extra: [
+            ...(item.description === undefined
+                ? []
+                : [item.description]),
+            ...(item.keywords ?? []),
+        ],
+        title: item.title,
+        weight: item.weight,
+    }));
+    const sectionsByLabel = new Map();
+    for (const { item, match } of ranked) {
+        const label = item.group ?? ungroupedLabel;
+        const rows = sectionsByLabel.get(label) ?? [];
+        if (maxResultsPerGroup === undefined ||
+            rows.length < maxResultsPerGroup) {
+            rows.push({ item, titleRanges: match.titleRanges });
+        }
+        sectionsByLabel.set(label, rows);
+    }
+    const sections = [
+        ...sectionsByLabel,
+    ].map(([label, rows]) => ({
+        key: `group-${label}`,
+        label,
+        rows,
+    }));
+    const fallbackItem = getFallbackItem?.(trimmedQuery);
+    return fallbackItem == null
+        ? sections
+        : [
+            ...sections,
+            {
+                key: "fallback",
+                label: fallbackItem.group ?? ungroupedLabel,
+                rows: [{ item: fallbackItem, titleRanges: [] }],
+            },
+        ];
+};
+//# sourceMappingURL=commandPaletteSections.js.map

package/dist/CommandPalette/commandPaletteSections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandPaletteSections.js","sourceRoot":"","sources":["../../src/CommandPalette/commandPaletteSections.ts"],"names":[],"mappings":"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"}

package/dist/CommandPalette/useCommandPalette.d.ts

@@ -0,0 +1,32 @@
+import { type CommandPaletteHotkeysOptions } from "./useCommandPaletteHotkeys.ts";
+export type UseCommandPaletteOptions = Pick<CommandPaletteHotkeysOptions, "isOpenedByTyping"> & {
+    /** Register the global keys (`useCommandPaletteHotkeys`). Default `true`. */
+    hasHotkeys?: boolean;
+};
+export type UseCommandPaletteResult = {
+    close: () => void;
+    isVisible: boolean;
+    /** Open it, optionally with text already in the field. */
+    open: (initialQuery?: string) => void;
+    /** Spread onto `CommandPalette`. */
+    paletteProps: {
+        defaultQuery: string;
+        isVisible: boolean;
+        onClose: () => void;
+    };
+};
+/**
+ * The open state for one `CommandPalette`, and its global keys.
+ *
+ * ```tsx
+ * const palette = useCommandPalette()
+ *
+ * <Button onClick={() => palette.open()}>Search</Button>
+ * <CommandPalette {...palette.paletteProps} items={items} />
+ * ```
+ *
+ * The keys are off while it is open, so a second `Ctrl K` does not
+ * reset what has been typed.
+ */
+export declare const useCommandPalette: ({ hasHotkeys, isOpenedByTyping, }?: UseCommandPaletteOptions) => UseCommandPaletteResult;
+//# sourceMappingURL=useCommandPalette.d.ts.map

package/dist/CommandPalette/useCommandPalette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCommandPalette.d.ts","sourceRoot":"","sources":["../../src/CommandPalette/useCommandPalette.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,4BAA4B,EAElC,MAAM,+BAA+B,CAAA;AAEtC,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,4BAA4B,EAC5B,kBAAkB,CACnB,GAAG;IACF,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,0DAA0D;IAC1D,IAAI,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,oCAAoC;IACpC,YAAY,EAAE;QACZ,YAAY,EAAE,MAAM,CAAA;QACpB,SAAS,EAAE,OAAO,CAAA;QAClB,OAAO,EAAE,MAAM,IAAI,CAAA;KACpB,CAAA;CACF,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,GAAI,oCAG/B,wBAA6B,KAAG,uBA6BlC,CAAA"}

package/dist/CommandPalette/useCommandPalette.js

@@ -0,0 +1,40 @@
+import { useVisibility } from "@charcuterie/logic";
+import { useCallback, useState } from "react";
+import { useCommandPaletteHotkeys, } from "./useCommandPaletteHotkeys.js";
+/**
+ * The open state for one `CommandPalette`, and its global keys.
+ *
+ * ```tsx
+ * const palette = useCommandPalette()
+ *
+ * <Button onClick={() => palette.open()}>Search</Button>
+ * <CommandPalette {...palette.paletteProps} items={items} />
+ * ```
+ *
+ * The keys are off while it is open, so a second `Ctrl K` does not
+ * reset what has been typed.
+ */
+export const useCommandPalette = ({ hasHotkeys = true, isOpenedByTyping, } = {}) => {
+    const { hide, isVisible, show } = useVisibility();
+    const [initialQuery, setInitialQuery] = useState("");
+    const open = useCallback((nextInitialQuery = "") => {
+        setInitialQuery(nextInitialQuery);
+        show();
+    }, [show]);
+    useCommandPaletteHotkeys({
+        isEnabled: hasHotkeys && !isVisible,
+        isOpenedByTyping,
+        onOpen: open,
+    });
+    return {
+        close: hide,
+        isVisible,
+        open,
+        paletteProps: {
+            defaultQuery: initialQuery,
+            isVisible,
+            onClose: hide,
+        },
+    };
+};
+//# sourceMappingURL=useCommandPalette.js.map

package/dist/CommandPalette/useCommandPalette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCommandPalette.js","sourceRoot":"","sources":["../../src/CommandPalette/useCommandPalette.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAE7C,OAAO,EAEL,wBAAwB,GACzB,MAAM,+BAA+B,CAAA;AAuBtC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,EAChC,UAAU,GAAG,IAAI,EACjB,gBAAgB,MACY,EAAE,EAA2B,EAAE;IAC3D,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,aAAa,EAAE,CAAA;IAEjD,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAA;IAEpD,MAAM,IAAI,GAAG,WAAW,CACtB,CAAC,gBAAgB,GAAG,EAAE,EAAE,EAAE;QACxB,eAAe,CAAC,gBAAgB,CAAC,CAAA;QACjC,IAAI,EAAE,CAAA;IACR,CAAC,EACD,CAAC,IAAI,CAAC,CACP,CAAA;IAED,wBAAwB,CAAC;QACvB,SAAS,EAAE,UAAU,IAAI,CAAC,SAAS;QACnC,gBAAgB;QAChB,MAAM,EAAE,IAAI;KACb,CAAC,CAAA;IAEF,OAAO;QACL,KAAK,EAAE,IAAI;QACX,SAAS;QACT,IAAI;QACJ,YAAY,EAAE;YACZ,YAAY,EAAE,YAAY;YAC1B,SAAS;YACT,OAAO,EAAE,IAAI;SACd;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/CommandPalette/useCommandPaletteHotkeys.d.ts

@@ -0,0 +1,35 @@
+export type CommandPaletteHotkeysOptions = {
+    /** Off while the palette is open, or on a page that should not take the keys. Default `true`. */
+    isEnabled?: boolean;
+    /**
+     * A printable key typed outside an editable field opens the palette
+     * with that character as the query. Default `true`.
+     */
+    isOpenedByTyping?: boolean;
+    /** Receives the text the palette should open with: `""`, or the character typed. */
+    onOpen: (initialQuery: string) => void;
+};
+export declare const getIsTypingTarget: (target: EventTarget | null) => boolean;
+/**
+ * The global keys that open a command palette, as an opt-in hook.
+ *
+ * - **`Ctrl K`, `Ctrl Space`** (or `⌘` on a Mac) open it from
+ *   anywhere, a text field included — the chord types nothing.
+ * - **`/`** opens it when focus is not somewhere that types, and
+ *   the slash itself is not typed.
+ * - **Any printable key** does the same and becomes the query, so
+ *   the page is a search box without a click (`isOpenedByTyping`).
+ *
+ * It is a hook, not something `CommandPalette` does on mount,
+ * because a document-wide key listener is a page-level decision: an
+ * app with two palettes, or a page where letters already mean
+ * something (a board with its own shortcuts), must be able to say
+ * no. See
+ * `docs/decisions/2026-10-16-command-palette-hotkeys-are-an-opt-in-hook.md`.
+ *
+ * A key another handler already claimed (`defaultPrevented`), a key
+ * pressed during IME composition, and a key with `Alt` held are all
+ * left alone.
+ */
+export declare const useCommandPaletteHotkeys: ({ isEnabled, isOpenedByTyping, onOpen, }: CommandPaletteHotkeysOptions) => void;
+//# sourceMappingURL=useCommandPaletteHotkeys.d.ts.map

package/dist/CommandPalette/useCommandPaletteHotkeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCommandPaletteHotkeys.d.ts","sourceRoot":"","sources":["../../src/CommandPalette/useCommandPaletteHotkeys.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,4BAA4B,GAAG;IACzC,iGAAiG;IACjG,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,oFAAoF;IACpF,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAA;CACvC,CAAA;AAoCD,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,WAAW,GAAG,IAAI,KACzB,OAiBF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,wBAAwB,GAAI,0CAItC,4BAA4B,KAAG,IA8DjC,CAAA"}

package/dist/CommandPalette/useCommandPaletteHotkeys.js

@@ -0,0 +1,114 @@
+import { useLatestRef } from "@charcuterie/logic";
+import { useEffect } from "react";
+/**
+ * Elements that keep their keys: anything you type into, and the
+ * widgets with their own type-to-find (a focused `Listbox` or `Menu`
+ * jumps to the option you type, and stealing that key breaks it).
+ */
+const TYPEAHEAD_OWNER_SELECTOR = [
+    "input",
+    "textarea",
+    "select",
+    "[contenteditable]:not([contenteditable='false'])",
+    "[role='combobox']",
+    "[role='grid']",
+    "[role='listbox']",
+    "[role='menu']",
+    "[role='menubar']",
+    "[role='searchbox']",
+    "[role='textbox']",
+    "[role='tree']",
+    "[role='treegrid']",
+].join(",");
+/** Input types that take no text, so a letter typed on one is free to open the palette. */
+const NON_TEXT_INPUT_TYPES = new Set([
+    "button",
+    "checkbox",
+    "color",
+    "file",
+    "image",
+    "radio",
+    "range",
+    "reset",
+    "submit",
+]);
+export const getIsTypingTarget = (target) => {
+    if (!(target instanceof Element)) {
+        return false;
+    }
+    if (target instanceof HTMLInputElement &&
+        NON_TEXT_INPUT_TYPES.has(target.type)) {
+        return false;
+    }
+    return ((target instanceof HTMLElement &&
+        target.isContentEditable) ||
+        target.closest(TYPEAHEAD_OWNER_SELECTOR) !== null);
+};
+/**
+ * The global keys that open a command palette, as an opt-in hook.
+ *
+ * - **`Ctrl K`, `Ctrl Space`** (or `⌘` on a Mac) open it from
+ *   anywhere, a text field included — the chord types nothing.
+ * - **`/`** opens it when focus is not somewhere that types, and
+ *   the slash itself is not typed.
+ * - **Any printable key** does the same and becomes the query, so
+ *   the page is a search box without a click (`isOpenedByTyping`).
+ *
+ * It is a hook, not something `CommandPalette` does on mount,
+ * because a document-wide key listener is a page-level decision: an
+ * app with two palettes, or a page where letters already mean
+ * something (a board with its own shortcuts), must be able to say
+ * no. See
+ * `docs/decisions/2026-10-16-command-palette-hotkeys-are-an-opt-in-hook.md`.
+ *
+ * A key another handler already claimed (`defaultPrevented`), a key
+ * pressed during IME composition, and a key with `Alt` held are all
+ * left alone.
+ */
+export const useCommandPaletteHotkeys = ({ isEnabled = true, isOpenedByTyping = true, onOpen, }) => {
+    const onOpenRef = useLatestRef(onOpen);
+    useEffect(() => {
+        if (!isEnabled) {
+            return;
+        }
+        const handleKeyDown = (event) => {
+            if (event.defaultPrevented ||
+                event.isComposing ||
+                event.altKey) {
+                return;
+            }
+            const isChord = event.ctrlKey || event.metaKey;
+            if (isChord) {
+                if (!event.shiftKey &&
+                    (event.key.toLowerCase() === "k" ||
+                        event.key === " ")) {
+                    event.preventDefault();
+                    onOpenRef.current("");
+                }
+                return;
+            }
+            if (getIsTypingTarget(event.target)) {
+                return;
+            }
+            if (event.key === "/") {
+                event.preventDefault();
+                onOpenRef.current("");
+                return;
+            }
+            // `key` is the character for a printable key and a name
+            // ("Enter", "ArrowDown") for everything else; a space is
+            // printable but presses the focused button.
+            if (isOpenedByTyping &&
+                [...event.key].length === 1 &&
+                /\S/u.test(event.key)) {
+                event.preventDefault();
+                onOpenRef.current(event.key);
+            }
+        };
+        document.addEventListener("keydown", handleKeyDown);
+        return () => {
+            document.removeEventListener("keydown", handleKeyDown);
+        };
+    }, [isEnabled, isOpenedByTyping, onOpenRef]);
+};
+//# sourceMappingURL=useCommandPaletteHotkeys.js.map

package/dist/CommandPalette/useCommandPaletteHotkeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCommandPaletteHotkeys.js","sourceRoot":"","sources":["../../src/CommandPalette/useCommandPaletteHotkeys.ts"],"names":[],"mappings":"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"}

package/dist/GroupedList/GroupedList.d.ts

@@ -1,3 +1,4 @@
+import type { IntentName } from "@charcuterie/tokens";
 import type { ReactNode } from "react";
 export type GroupedListHeadingLevel = 2 | 3 | 4 | 5 | 6;
 export type GroupedListSize = "md" | "sm";
@@ -10,24 +11,86 @@ export type GroupedListItem = {
      * **Name a repeated action after its row.** Ten rows of "Open" are
      * ten buttons an agent cannot tell apart; `aria-label="Open Lobby"`
      * on each is one `getByRole` away.
+     *
+     * In a row with `onSelect` these stay their own targets: they sit
+     * above the whole-row button, so pressing one never selects the
+     * row.
      */
     actions?: ReactNode;
+    /**
+     * A figure that belongs beside the text rather than under it — a
+     * payout, a total, a schedule. It sits between the text and the
+     * actions in a wide list and drops under the text in a narrow one,
+     * the same content-decided wrap the actions use: it asks for at
+     * least 11rem beside the text column's 12rem. Never interactive:
+     * in a row with `onSelect` the whole-row button sits over it.
+     */
+    aside?: ReactNode;
     /** `Badge`s, drawn after the label and wrapping onto their own line when they run out of room. */
     badges?: ReactNode;
     /**
      * Anything richer than one line of help — a payout, a rule list.
      * Drawn under the description, inside the text column, and never
-     * truncated.
+     * truncated. Never interactive in a row with `onSelect`; a control
+     * belongs in `actions`.
      */
     content?: ReactNode;
     /** One muted line under the label: a path, a key, a count. Truncated like the label. */
     description?: string;
+    /**
+     * The intent `isHighlighted` rings the row in. `accent` by default;
+     * an app whose highlight means "this just paid out" passes
+     * `success`.
+     */
+    highlightIntent?: IntentName;
+    /**
+     * `true` rings the row and pulses the ring twice — "this one just
+     * changed", for a row a scan, a save or an arrival has touched.
+     * The ring stays while the flag does, so the app decides how long
+     * it lasts, usually by clearing it on a timer.
+     *
+     * **To pulse a row that is already highlighted again, change its
+     * `key`.** A new key is a new row, and a new row starts the pulse
+     * from the beginning; `` `${id}-${sequence}` `` is the usual shape.
+     *
+     * Under `prefers-reduced-motion` and on ePaper the ring does not
+     * pulse; it is simply there.
+     */
+    isHighlighted?: boolean;
+    /**
+     * `true` draws the row receded — a sunken surface and a quieter
+     * label — for an entry that exists but is switched off. It stays
+     * fully operable and every colour on it still clears AA, which is
+     * why it is a surface and a text role rather than an opacity: a
+     * faded row is not a disabled one, and only a disabled control may
+     * drop below the contrast floor. Say WHY in a badge too ("off").
+     */
+    isMuted?: boolean;
     key: string;
     /**
      * Plain text, because it is what the row is called — the thing a
      * search matched and the text a clipped row's tooltip repeats.
      */
     label: string;
+    /**
+     * Makes the whole row one native `<button>` — "open this one" for a
+     * row whose primary action is the row itself. Hover tints the row
+     * and rings its edge, a press sinks it (with motion only when the
+     * user has not asked for less), and keyboard focus draws the focus
+     * ring inside the row's edge. `actions` stay separate targets
+     * above it.
+     *
+     * The button is drawn UNDER the row's text and the text lets the
+     * pointer through, so nothing interactive is ever nested inside a
+     * button: keep `badges`, `content` and `aside` free of controls.
+     */
+    onSelect?: () => void;
+    /**
+     * The whole-row button's accessible name. Defaults to `label`.
+     * Name the verb when there is one — `"Edit Water the ferns"` —
+     * the same rule as a repeated action.
+     */
+    selectLabel?: string;
 };
 export type GroupedListGroup = {
     /** Plain text. It is the accessible name of the group's list, so `getByRole("list", { name })` finds it. */
@@ -121,6 +184,20 @@ export type GroupedListProps = {
  * know that surface, so `isHeadingSticky` reads it from a custom
  * property the host can set, falling back to `surface-base`.
  *
+ * ### A row can be the target
+ *
+ * tally-marks' card list opens a card's editor from anywhere on the
+ * card, and the owner asked for that to feel like an app: hover,
+ * press, focus, touch. `onSelect` is that, as one real `<button>`
+ * stretched under the row's text — not a click handler on an
+ * `<li>`, which no keyboard reaches and no screen reader announces.
+ * The text lets the pointer through to it; the actions sit above it
+ * and keep their own targets, so "Delete" never opens the editor.
+ *
+ * A row can also be muted (switched off but still there) and
+ * highlighted (just touched by a scan or a save) — the two other
+ * per-row states the same list drew by hand.
+ *
  * ### Not collapsible
  *
  * A group you can close is `Accordion`. This is for a list that is

package/dist/GroupedList/GroupedList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GroupedList.d.ts","sourceRoot":"","sources":["../../src/GroupedList/GroupedList.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAMtC,MAAM,MAAM,uBAAuB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAEvD,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,CAAA;AAEzC,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,kGAAkG;IAClG,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,4GAA4G;IAC5G,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,SAAS,eAAe,EAAE,CAAA;IACjC,GAAG,EAAE,MAAM,CAAA;IACX;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAA;IACnC;;;;OAIG;IACH,YAAY,CAAC,EAAE,uBAAuB,CAAA;IACtC;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,eAAe,CAAA;CACvB,CAAA;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,WAAW,GAAI,0FAQzB,gBAAgB,KAAG,SAuErB,CAAA"}
+{"version":3,"file":"GroupedList.d.ts","sourceRoot":"","sources":["../../src/GroupedList/GroupedList.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAMtC,MAAM,MAAM,uBAAuB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAEvD,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,CAAA;AAEzC,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,kGAAkG;IAClG,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,UAAU,CAAA;IAC5B;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,4GAA4G;IAC5G,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,SAAS,eAAe,EAAE,CAAA;IACjC,GAAG,EAAE,MAAM,CAAA;IACX;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAA;IACnC;;;;OAIG;IACH,YAAY,CAAC,EAAE,uBAAuB,CAAA;IACtC;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,eAAe,CAAA;CACvB,CAAA;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,eAAO,MAAM,WAAW,GAAI,0FAQzB,gBAAgB,KAAG,SAuErB,CAAA"}

package/dist/GroupedList/GroupedList.js

@@ -52,6 +52,20 @@ const HEADING_TAG = {
  * know that surface, so `isHeadingSticky` reads it from a custom
  * property the host can set, falling back to `surface-base`.
  *
+ * ### A row can be the target
+ *
+ * tally-marks' card list opens a card's editor from anywhere on the
+ * card, and the owner asked for that to feel like an app: hover,
+ * press, focus, touch. `onSelect` is that, as one real `<button>`
+ * stretched under the row's text — not a click handler on an
+ * `<li>`, which no keyboard reaches and no screen reader announces.
+ * The text lets the pointer through to it; the actions sit above it
+ * and keep their own targets, so "Delete" never opens the editor.
+ *
+ * A row can also be muted (switched off but still there) and
+ * highlighted (just touched by a scan or a save) — the two other
+ * per-row states the same list drew by hand.
+ *
  * ### Not collapsible
  *
  * A group you can close is `Accordion`. This is for a list that is

package/dist/GroupedList/GroupedList.js.map

@@ -1 +1 @@
-{"version":3,"file":"GroupedList.js","sourceRoot":"","sources":["../../src/GroupedList/GroupedList.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAGhD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAsB,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AA4FpE;;;;GAIG;AACH,MAAM,WAAW,GAGb;IACF,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;CACR,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAC1B,SAAS,EACT,UAAU,EACV,MAAM,EACN,YAAY,GAAG,CAAC,EAChB,eAAe,GAAG,KAAK,EACvB,eAAe,GAAG,IAAI,EACtB,IAAI,GAAG,IAAI,GACM,EAAa,EAAE;IAChC,MAAM,MAAM,GAAG,WAAW,EAAE,CAAA;IAE5B,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAC/B,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAClC,CAAA;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,YAAY,CAAC,CAAA;IAEzC,OAAO,CACL,cACE,SAAS,EAAE,WAAW,CACpB,eAAe,EACf,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EACjC,SAAS,CACV,YAEA,WAAW,CAAC,MAAM,KAAK,CAAC;YACvB,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC;YACtB,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBAC/B,MAAM,SAAS,GAAG,GAAG,MAAM,YAAY,KAAK,EAAE,CAAA;gBAE9C,OAAO,CACL,eACE,SAAS,EAAE,WAAW,CACpB,eAAe,EACf,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CACpC,aAGD,eACE,SAAS,EAAE,WAAW,CACpB,iDAAiD,EACjD,eAAe,IAAI,oBAAoB,CACxC,aAED,KAAC,OAAO,IACN,SAAS,EAAE,WAAW,CACpB,8DAA8D,EAC9D,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CACtC,EACD,EAAE,EAAE,SAAS,YAEZ,KAAK,CAAC,OAAO,GACN,EAET,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CACf,eAAM,SAAS,EAAC,sDAAsD,YACnE,KAAK,CAAC,OAAO,GACT,CACR,CAAC,CAAC,CAAC,IAAI,IACJ,EAEN,gCACmB,SAAS,EAC1B,SAAS,EAAC,wIAAwI,YAEjJ,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACzB,KAAC,cAAc,IACb,eAAe,EAAE,eAAe,EAChC,IAAI,EAAE,IAAI,EAEV,IAAI,EAAE,IAAI,IADL,IAAI,CAAC,GAAG,CAEb,CACH,CAAC,GACC,KArCA,KAAK,CAAC,GAAG,CAsCV,CACP,CAAA;YACH,CAAC,CAAC,GACF,CACP,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"GroupedList.js","sourceRoot":"","sources":["../../src/GroupedList/GroupedList.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAIhD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAsB,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AA0JpE;;;;GAIG;AACH,MAAM,WAAW,GAGb;IACF,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;CACR,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAC1B,SAAS,EACT,UAAU,EACV,MAAM,EACN,YAAY,GAAG,CAAC,EAChB,eAAe,GAAG,KAAK,EACvB,eAAe,GAAG,IAAI,EACtB,IAAI,GAAG,IAAI,GACM,EAAa,EAAE;IAChC,MAAM,MAAM,GAAG,WAAW,EAAE,CAAA;IAE5B,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAC/B,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAClC,CAAA;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,YAAY,CAAC,CAAA;IAEzC,OAAO,CACL,cACE,SAAS,EAAE,WAAW,CACpB,eAAe,EACf,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EACjC,SAAS,CACV,YAEA,WAAW,CAAC,MAAM,KAAK,CAAC;YACvB,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC;YACtB,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBAC/B,MAAM,SAAS,GAAG,GAAG,MAAM,YAAY,KAAK,EAAE,CAAA;gBAE9C,OAAO,CACL,eACE,SAAS,EAAE,WAAW,CACpB,eAAe,EACf,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CACpC,aAGD,eACE,SAAS,EAAE,WAAW,CACpB,iDAAiD,EACjD,eAAe,IAAI,oBAAoB,CACxC,aAED,KAAC,OAAO,IACN,SAAS,EAAE,WAAW,CACpB,8DAA8D,EAC9D,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CACtC,EACD,EAAE,EAAE,SAAS,YAEZ,KAAK,CAAC,OAAO,GACN,EAET,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CACf,eAAM,SAAS,EAAC,sDAAsD,YACnE,KAAK,CAAC,OAAO,GACT,CACR,CAAC,CAAC,CAAC,IAAI,IACJ,EAEN,gCACmB,SAAS,EAC1B,SAAS,EAAC,wIAAwI,YAEjJ,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACzB,KAAC,cAAc,IACb,eAAe,EAAE,eAAe,EAChC,IAAI,EAAE,IAAI,EAEV,IAAI,EAAE,IAAI,IADL,IAAI,CAAC,GAAG,CAEb,CACH,CAAC,GACC,KArCA,KAAK,CAAC,GAAG,CAsCV,CACP,CAAA;YACH,CAAC,CAAC,GACF,CACP,CAAA;AACH,CAAC,CAAA"}

package/dist/GroupedList/GroupedListRow.d.ts

@@ -14,16 +14,27 @@ export type GroupedListRowProps = {
  * `useIsTextClipped` is `Badge`'s: an ellipsis leaves no trace in the
  * DOM, so the only way to know a label is cut off is to measure it.
  * A `title` on every row would put a tooltip on forty short names to
- * help the one long one.
+ * help the one long one. In a selectable row the text lets the
+ * pointer through, so the clipped label's tooltip moves to the button
+ * the pointer is actually over.
  *
  * ### The actions wrap; they never squeeze the text
  *
  * The row is a wrapping flex line. The text column asks for 12rem
- * and grows into the rest, so in a wide list the actions sit at the
- * inline end of the same line, and in a list narrower than the text
- * plus the actions they drop under the text instead of crushing the
- * label to an ellipsis and nothing. No container query: the wrap is
- * decided by the content itself.
+ * and grows into the rest, and the aside asks for at least 11rem, so
+ * in a wide list the aside and the actions sit at the inline end of
+ * the same line, and in a list narrower than all of them they drop
+ * under the text instead of crushing the label to an ellipsis and
+ * nothing. No container query: the wrap is decided by the content
+ * itself.
+ *
+ * ### The layers of a selectable row
+ *
+ * In tree order, and every one of them positioned, so they paint in
+ * that order with no `z-index` to keep in step: the button (bottom),
+ * the text and the aside (pointer passes through), the actions
+ * (their own targets), and the highlight ring (top, pointer passes
+ * through) — the ring is last so a hovered row cannot paint over it.
  */
 export declare const GroupedListRow: ({ isTextTruncated, item, size, }: GroupedListRowProps) => ReactNode;
 //# sourceMappingURL=GroupedListRow.d.ts.map

package/dist/GroupedList/GroupedListRow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GroupedListRow.d.ts","sourceRoot":"","sources":["../../src/GroupedList/GroupedListRow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAChB,MAAM,mBAAmB,CAAA;AAE1B,MAAM,MAAM,mBAAmB,GAAG;IAChC,eAAe,EAAE,OAAO,CAAA;IACxB,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,eAAe,CAAA;CACtB,CAAA;AAOD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc,GAAI,kCAI5B,mBAAmB,KAAG,SAwExB,CAAA"}
+{"version":3,"file":"GroupedListRow.d.ts","sourceRoot":"","sources":["../../src/GroupedList/GroupedListRow.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAChB,MAAM,mBAAmB,CAAA;AAE1B,MAAM,MAAM,mBAAmB,GAAG;IAChC,eAAe,EAAE,OAAO,CAAA;IACxB,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,eAAe,CAAA;CACtB,CAAA;AAmDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,cAAc,GAAI,kCAI5B,mBAAmB,KAAG,SA6IxB,CAAA"}