@gusnips/react 0.9.25 → 0.9.27

package/README.md

@@ -350,6 +350,38 @@ It keeps the page and drops only a fragment carrying a credential, because the p
 worth returning to. `createRequireAuth` uses it; use it anywhere else you record where someone was:
 a dead-session redirect is the common one.
 
+## Keep the email between sign-in screens
+
+```tsx
+import { recallAuthEmail, rememberAuthEmail } from "@gusnips/react";
+
+<input
+  name="email"
+  type="email"
+  defaultValue={recallAuthEmail()}
+  onChange={(event) => rememberAuthEmail(event.currentTarget.value)}
+/>;
+```
+
+Sign in, "use a code instead", forgot password and create account are separate screens, and each
+one used to open with an empty email field. Put those two props on every one of them and the
+address follows the person. Call `forgetAuthEmail()` where your app learns a session exists, so the
+next person at this browser starts empty.
+
+It is kept in `localStorage` for 30 minutes after the last keystroke, and never in a URL, where it
+would reach `Referer`, access logs, history and analytics. It is `localStorage` and not
+`sessionStorage` because an emailed link opens in a new tab, and a new tab does not inherit
+`sessionStorage`. That tab is where a person lands on sign-in after confirming an account. Where
+the browser blocks site data, or on React Native, the address lasts in memory until the page or the
+app is left.
+
+- Read it once, when the screen opens. It is not a store: nothing re-renders when it changes. On a
+  prerendered page, read it after hydration, never while rendering.
+- Leave the field uncontrolled. A `defaultValue` and a change handler are enough. Also call
+  `rememberAuthEmail(value)` where you read the field at submit, because some password managers fill
+  a form without firing events.
+- Never put a password, a code or a token here.
+
 ## Never dead-end anyone
 
 ```ts
@@ -497,10 +529,155 @@ toast needs no `catch`. Outside a component, `copyText(text)` does the write on
 The words are yours, and so is the live region: a label that changes needs `aria-live` to be
 heard.
 
+## A busy button a person can see
+
+```tsx
+import { BusyRing, useHeldPending } from "@gusnips/react";
+
+function SaveButton({ saving, ...props }: { saving: boolean } & ButtonProps) {
+  const busy = useHeldPending(saving);
+  return (
+    <button {...props} disabled={busy} aria-busy={busy} className="relative rounded-md ...">
+      Save
+      {busy && <BusyRing />}
+    </button>
+  );
+}
+```
+
+```css
+@import "@gusnips/tokens/busy-ring.css";
+```
+
+A refresh that answers in 80 ms turns its pending flag on and off inside a frame. Nothing was
+painted, so the reader pressed "Reload", saw nothing change, and decided the press was ignored.
+A louder spinner cannot fix that, because the spinner never shows. `useHeldPending(pending)`
+keeps the flag on for at least 400 ms once it turns on. It is `true` on the very render
+`pending` turns true, so the busy look is there on the press and not a frame later, and a slow
+request is not made slower. Pass a second argument to change the 400.
+
+`<BusyRing />` is a ring that runs round the button's edge. It paints in `currentColor`, so it
+contrasts with every variant in both themes and adds nothing to your palette. The button needs
+`position: relative` and a disabled style that does not dim it (`disabled:opacity-100`), or the
+ring shows at half strength. It copies the button's `border-radius`.
+
+Tune it in your own CSS: `--busy-ring-width` (2px), `--busy-ring-duration` (900ms) and
+`--busy-ring-duration-reduced` (2400ms). Under reduced motion the ring turns slower and does not
+stop, because a frozen ring reads as a hang. The `@gusnips/tokens` base rules clamp every
+animation to one pass under reduced motion, and the ring wins that fight on purpose.
+
+There is no shared `Button`, so the two lines above live in your button once. That is also the
+place to change the look later: swap the ring for an icon or a label there, or edit the CSS for a
+different ring everywhere.
+
+## Slash commands in a text field
+
+A slash command is text like `/help` that picks an action instead of sending a message.
+
+```ts
+import { parseCommand } from "@gusnips/react/commands";
+
+parseCommand("/help");
+// { name: "help" }
+```
+
+Names have no leading slash. Give each command other names (`aliases`) and search words (`tags`):
+
+```ts
+const commands = [
+  {
+    name: "help",
+    description: "See commands",
+    aliases: ["commands", "shortcuts"],
+    tags: ["keyboard", "guide"],
+  },
+];
+```
+
+`/commands` runs `/help`. Searching for `keyboard` finds its menu row, but `/keyboard` is not an
+executable name. `matchCommands(commands, query)` searches names, aliases, tags and descriptions,
+ignoring case and accents. Exact names rank first, then aliases, name prefixes, alias prefixes,
+tags and descriptions. Equal ranks keep registry order; each name gets one row.
+
+`resolveCommand(commands, name)` answers `matched`, `unknown` or `ambiguous`. An exact name wins
+over an alias. Two commands sharing an alias are ambiguous, not a reason to run the first one.
+
+For a controlled text field, use the hook:
+
+```tsx
+import { useSlashCommands } from "@gusnips/react/commands";
+
+const slash = useSlashCommands({
+  text,
+  commands,
+  onChange: setText,
+  onExecute: runCommand,
+  onError: showCommandError,
+});
+
+function submit() {
+  if (slash.submit()) return;
+  sendMessage(text);
+}
+```
+
+The functions in that example belong to your app. `runCommand(command, arg, altKey)` gets the
+original command object, the argument and whether Alt was held. It owns permissions and action
+errors. Supply only commands allowed in this field, with descriptions and tags in the current
+language. Changing those commands or the language refreshes the menu even if `text` stays the same.
+
+Call `slash.handleKeyDown(event)` first in the field's key handler. If it returns `true`, stop
+your own handler. Arrows move the selection; Enter picks it. Tab completes the name without
+running it. Escape hides the menu until the query changes. Shift+Enter stays yours. During IME
+composition (when a keyboard combines keystrokes into a character), the hook lets the browser
+finish that character without running or sending anything.
+
+Render the rows in your own menu. Keep focus in the field with the browser's `preventDefault`
+on mouse down; use click for the action so keyboard and screen-reader clicks work too:
+
+```tsx
+return slash.open ? (
+  <div id={slash.listId} role="listbox" aria-label="Commands">
+    {slash.items.map((command, index) => (
+      <button
+        key={command.name}
+        id={slash.itemId(command)}
+        type="button"
+        role="option"
+        tabIndex={-1}
+        aria-selected={slash.index === index}
+        onMouseEnter={() => slash.highlight(index)}
+        onMouseDown={(event) => event.preventDefault()}
+        onClick={(event) => slash.pick(command, event.altKey)}
+      >
+        /{command.name}: {command.description}
+      </button>
+    ))}
+  </div>
+) : null;
+```
+
+Give the field `role="combobox"`, `aria-autocomplete="list"`, `aria-expanded={slash.open}`,
+`aria-controls={slash.open ? slash.listId : undefined}` and `aria-activedescendant={slash.activeId}`.
+Translate the menu label too. If there are no rows, explain how to find commands and offer a
+"See commands" button that calls `slash.showAll()`. It opens the full list, even after Escape.
+`onError` is required: show what was not recognized, or which names share an alias, with the
+same way back to the list.
+
+Set `takesArg: true` when a command accepts an argument. Selecting it, or submitting its bare
+alias, completes `/name ` without running it. Completion keeps arguments already typed.
+`parseCommand` leaves multiline text as a normal message.
+
+Call `submit()` before every normal send, queue or quota check, including button and imperative
+paths. It returns `true` for commands it ran, completed or rejected, so unknown commands never
+silently become model messages. It returns `false` for ordinary text. The hook never sends a
+message, clears a draft or changes attached files; those stay with the app. It also has no timer
+or scheduler: offer a repeat command only when your app has real scheduling behind it.
+
 ## Also here
 
 `ErrorBoundary`, an SSE reader split into a platform-free parser and a stream wrapper,
-`i18nInitOptions`, and `cn`.
+`i18nInitOptions`, `useHeldPending` and `BusyRing` (above), and `cn`.
 
 Pass `storageWriter: "app"` to `i18nInitOptions` when your own language control writes the stored
 locale. Leave it out and the detector writes it, which is right until you offer "follow the
@@ -577,6 +754,7 @@ lives behind a subpath, so you install a dependency only if you import the thing
 | `@gusnips/react/ui`       | the seven wrappers                       | @base-ui/react        |
 | `@gusnips/react/contract` | two prerender names                      | nothing               |
 | `@gusnips/react/theme`    | `createTheme`, `startTheme`              | react                 |
+| `@gusnips/react/commands` | slash matching and `useSlashCommands`    | react                 |
 
 The rule behind that table: **a peer marked optional must not be reachable from the main entry
 point.** An optional peer the barrel imports anyway is not optional: it is a required one whose

package/dist/busy-ring.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The ring that runs round a busy control's edge. Put it inside the control while it is busy.
+ *
+ * It draws nothing by itself: the look lives in `@gusnips/tokens/busy-ring.css`, which you import
+ * once. The control needs `position: relative` and the radius it already has (the ring copies it),
+ * and its disabled style must not dim it, or the ring is drawn at half strength and nobody sees it.
+ *
+ * Why a component for one `span`: the class name and the markup are one contract. Changing how
+ * busy looks, a second element or another shape, is then one edit here and one release, not one
+ * edit in every product's button.
+ */
+export declare function BusyRing(): import("react").JSX.Element;
+//# sourceMappingURL=busy-ring.d.ts.map

package/dist/busy-ring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"busy-ring.d.ts","sourceRoot":"","sources":["../src/busy-ring.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,gCAEvB"}

package/dist/busy-ring.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The ring that runs round a busy control's edge. Put it inside the control while it is busy.
+ *
+ * It draws nothing by itself: the look lives in `@gusnips/tokens/busy-ring.css`, which you import
+ * once. The control needs `position: relative` and the radius it already has (the ring copies it),
+ * and its disabled style must not dim it, or the ring is drawn at half strength and nobody sees it.
+ *
+ * Why a component for one `span`: the class name and the markup are one contract. Changing how
+ * busy looks, a second element or another shape, is then one edit here and one release, not one
+ * edit in every product's button.
+ */
+export function BusyRing() {
+    return _jsx("span", { "aria-hidden": "true", className: "busy-ring" });
+}
+//# sourceMappingURL=busy-ring.js.map

package/dist/busy-ring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"busy-ring.js","sourceRoot":"","sources":["../src/busy-ring.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,8BAAkB,MAAM,EAAC,SAAS,EAAC,WAAW,GAAG,CAAC;AAC3D,CAAC"}

package/dist/commands.d.ts

@@ -0,0 +1,80 @@
+export interface SlashCommand {
+    /** One token, without the leading slash. */
+    name: string;
+    description: string;
+    /** Other executable names. Tags only help search. */
+    aliases: readonly string[];
+    tags: readonly string[];
+    takesArg?: boolean;
+}
+export interface ParsedCommand {
+    name: string;
+    /** Undefined before a space; empty after a space with no argument yet. */
+    arg?: string;
+}
+/** Multiline text and a slash inside a message are not commands. */
+export declare function parseCommand(text: string): ParsedCommand | null;
+export type CommandResolution<T extends SlashCommand = SlashCommand> = {
+    kind: "matched";
+    command: T;
+} | {
+    kind: "unknown";
+    name: string;
+} | {
+    kind: "ambiguous";
+    name: string;
+    commands: readonly T[];
+};
+/** Exact names win over aliases. Search tags never execute an action. */
+export declare function resolveCommand<T extends SlashCommand>(commands: readonly T[], name: string): CommandResolution<T>;
+/** One row per name, in registry order when two results have the same rank. */
+export declare function matchCommands<T extends SlashCommand>(commands: readonly T[], query: string): T[];
+/** Replace only the name, keeping the argument already typed. */
+export declare function completeCommand(command: SlashCommand, text: string): string;
+export type CommandProblem<T extends SlashCommand = SlashCommand> = Exclude<CommandResolution<T>, {
+    kind: "matched";
+}>;
+export interface CommandOptions<T extends SlashCommand> {
+    text: string;
+    /** Supply only commands allowed here, with current translated descriptions and tags. */
+    commands: readonly T[];
+    onChange: (text: string) => void;
+    /** The app owns authorization, errors, draft cleanup and attachments. */
+    onExecute: (command: T, arg: string | undefined, altKey: boolean) => void;
+    /** Required: show a way back to the available commands, never send this text to the model. */
+    onError: (problem: CommandProblem<T>) => void;
+}
+/** Structural so React events and small test events both fit. */
+export interface CommandKeyEvent {
+    key: string;
+    shiftKey?: boolean;
+    altKey?: boolean;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    isComposing?: boolean;
+    keyCode?: number;
+    nativeEvent?: {
+        isComposing?: boolean;
+        keyCode?: number;
+    };
+    preventDefault: () => void;
+}
+export interface SlashCommandMenu<T extends SlashCommand = SlashCommand> {
+    parsed: ParsedCommand | null;
+    open: boolean;
+    items: readonly T[];
+    index: number;
+    active: T | undefined;
+    listId: string;
+    itemId: (command: T) => string;
+    activeId: string | undefined;
+    highlight: (index: number) => void;
+    close: () => void;
+    showAll: () => void;
+    pick: (command: T, altKey?: boolean) => void;
+    submit: (altKey?: boolean) => boolean;
+    handleKeyDown: (event: CommandKeyEvent) => boolean;
+}
+/** A controlled textarea menu. No UI, browser globals, timers or attachment state. */
+export declare function useSlashCommands<T extends SlashCommand>({ text, commands, onChange, onExecute, onError, }: CommandOptions<T>): SlashCommandMenu<T>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

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

package/dist/commands.js

@@ -0,0 +1,192 @@
+import { useId, useState } from "react";
+/** Multiline text and a slash inside a message are not commands. */
+export function parseCommand(text) {
+    if (/[\r\n\u{2028}\u{2029}]/u.test(text))
+        return null;
+    const match = /^\s*\/(\S*)(?:[^\S\r\n]+(.*))?$/u.exec(text);
+    if (!match)
+        return null;
+    const name = (match[1] ?? "").toLowerCase();
+    return match[2] === undefined ? { name } : { name, arg: match[2] };
+}
+/** Exact names win over aliases. Search tags never execute an action. */
+export function resolveCommand(commands, name) {
+    const token = name.toLowerCase();
+    if (!token)
+        return { kind: "unknown", name };
+    let matches = commands.filter((command) => command.name.toLowerCase() === token);
+    if (matches.length === 0) {
+        matches = commands.filter((command) => command.aliases.some((alias) => alias.toLowerCase() === token));
+    }
+    if (matches.length > 1)
+        return { kind: "ambiguous", name, commands: matches };
+    const command = matches[0];
+    return command ? { kind: "matched", command } : { kind: "unknown", name };
+}
+function searchText(text) {
+    return text.normalize("NFD").replace(/\p{M}/gu, "").toLowerCase();
+}
+function rank(command, query) {
+    if (!query)
+        return 0;
+    const name = searchText(command.name);
+    const aliases = command.aliases.map(searchText);
+    if (name === query)
+        return 0;
+    if (aliases.includes(query))
+        return 1;
+    if (name.startsWith(query))
+        return 2;
+    if (aliases.some((alias) => alias.startsWith(query)))
+        return 3;
+    if (command.tags.some((tag) => searchText(tag).includes(query)))
+        return 4;
+    if (searchText(command.description).includes(query))
+        return 5;
+    return Infinity;
+}
+/** One row per name, in registry order when two results have the same rank. */
+export function matchCommands(commands, query) {
+    const token = searchText(query.trim());
+    const names = new Set();
+    return commands
+        .filter((command) => {
+        const name = command.name.toLowerCase();
+        if (names.has(name))
+            return false;
+        names.add(name);
+        return true;
+    })
+        .map((command) => ({ command, rank: rank(command, token) }))
+        .filter((match) => Number.isFinite(match.rank))
+        .sort((a, b) => a.rank - b.rank)
+        .map((match) => match.command);
+}
+/** Replace only the name, keeping the argument already typed. */
+export function completeCommand(command, text) {
+    const arg = parseCommand(text)?.arg;
+    if (arg !== undefined)
+        return `/${command.name} ${arg}`;
+    return `/${command.name}${command.takesArg ? " " : ""}`;
+}
+/** A controlled textarea menu. No UI, browser globals, timers or attachment state. */
+export function useSlashCommands({ text, commands, onChange, onExecute, onError, }) {
+    const parsed = parseCommand(text);
+    const resolution = parsed ? resolveCommand(commands, parsed.name) : null;
+    const editingName = parsed !== null && (parsed.arg === undefined || resolution?.kind !== "matched");
+    const items = editingName ? matchCommands(commands, parsed.name) : [];
+    const key = JSON.stringify([text, items.map((command) => command.name)]);
+    const [state, setState] = useState({ key, text, index: 0, deliberate: false, dismissed: false });
+    // Reset selection on a changed result set, but keep Escape's dismissal until the draft changes.
+    if (state.key !== key) {
+        setState({
+            key,
+            text,
+            index: 0,
+            deliberate: false,
+            dismissed: state.text === text && state.dismissed,
+        });
+    }
+    const listId = `${useId()}-commands`;
+    const open = editingName && !state.dismissed;
+    const active = open ? items[state.index] : undefined;
+    const itemId = (command) => `${listId}-${encodeURIComponent(command.name)}`;
+    function close() {
+        setState((current) => ({ ...current, dismissed: true }));
+    }
+    function showAll() {
+        setState((current) => ({ ...current, index: 0, deliberate: false, dismissed: false }));
+        onChange("/");
+    }
+    function highlight(index) {
+        if (!items[index])
+            return;
+        setState((current) => ({ ...current, index, deliberate: true }));
+    }
+    function pick(command, altKey = false) {
+        // Re-resolve against current capabilities, not a descriptor retained by a caller.
+        const selected = resolveCommand(commands, command.name);
+        if (selected.kind !== "matched") {
+            onError(selected);
+            return;
+        }
+        if (selected.command.takesArg || parsed?.arg) {
+            onChange(completeCommand(selected.command, text));
+            return;
+        }
+        onExecute(selected.command, parsed?.arg, altKey);
+    }
+    /** Call before the normal send/queue/quota path, including button and imperative submits. */
+    function submit(altKey = false) {
+        if (!parsed || !resolution)
+            return false;
+        if (resolution.kind !== "matched") {
+            onError(resolution);
+            return true;
+        }
+        if (resolution.command.takesArg &&
+            parsed.arg === undefined &&
+            parsed.name !== resolution.command.name.toLowerCase()) {
+            onChange(completeCommand(resolution.command, text));
+            return true;
+        }
+        onExecute(resolution.command, parsed.arg, altKey);
+        return true;
+    }
+    /** Call first. True means skip your own key handler; IME still gets the browser's default. */
+    function handleKeyDown(event) {
+        const native = event.nativeEvent ?? event;
+        if (native.isComposing || native.keyCode === 229)
+            return true;
+        if (event.shiftKey)
+            return false;
+        if (open && event.key === "Escape") {
+            event.preventDefault();
+            close();
+            return true;
+        }
+        if (open && items.length > 0 && !event.ctrlKey && !event.metaKey) {
+            if (event.key === "ArrowDown" || event.key === "ArrowUp") {
+                event.preventDefault();
+                const step = event.key === "ArrowDown" ? 1 : -1;
+                highlight((state.index + step + items.length) % items.length);
+                return true;
+            }
+            if (active && (event.key === "Enter" || event.key === "Tab")) {
+                event.preventDefault();
+                if (event.key === "Tab") {
+                    onChange(completeCommand(active, text));
+                }
+                else if (resolution?.kind === "ambiguous" && !state.deliberate) {
+                    onError(resolution);
+                }
+                else {
+                    pick(active, event.altKey);
+                }
+                return true;
+            }
+        }
+        if (parsed && event.key === "Enter") {
+            event.preventDefault();
+            return submit(event.altKey);
+        }
+        return false;
+    }
+    return {
+        parsed,
+        open,
+        items,
+        index: state.index,
+        active,
+        listId,
+        itemId,
+        activeId: active ? itemId(active) : undefined,
+        highlight,
+        close,
+        showAll,
+        pick,
+        submit,
+        handleKeyDown,
+    };
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

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

package/dist/held-pending.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `pending`, kept on for at least `minMs` once it turns on.
+ *
+ * It answers `true` on the very render `pending` turns true, with no wait for an effect, so the
+ * busy state shows on the press and not a frame later. A slow request is not made slower: the
+ * hold only fills the gap when the request ended early, and ends within one timer tick of it
+ * otherwise.
+ *
+ * 400 ms is the floor for a busy state a person can read as "it ran". Use it for a button's busy
+ * look, a refresh icon, a save that returns at once. Do not use it to gate real work: it changes
+ * what is shown, never what the request does.
+ */
+export declare function useHeldPending(pending: boolean, minMs?: number): boolean;
+//# sourceMappingURL=held-pending.d.ts.map

package/dist/held-pending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"held-pending.d.ts","sourceRoot":"","sources":["../src/held-pending.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,SAAM,GAAG,OAAO,CAmBrE"}

package/dist/held-pending.js

@@ -0,0 +1,36 @@
+import { useEffect, useRef, useState } from "react";
+// A refresh that answers in 80 ms flips its `pending` flag on and off inside a frame or two. The
+// reader pressed the button, nothing on screen changed, and the page looks like it ignored them.
+// A louder spinner does not fix that, because the spinner is never painted. The flag itself has
+// to stay on long enough to be seen.
+/**
+ * `pending`, kept on for at least `minMs` once it turns on.
+ *
+ * It answers `true` on the very render `pending` turns true, with no wait for an effect, so the
+ * busy state shows on the press and not a frame later. A slow request is not made slower: the
+ * hold only fills the gap when the request ended early, and ends within one timer tick of it
+ * otherwise.
+ *
+ * 400 ms is the floor for a busy state a person can read as "it ran". Use it for a button's busy
+ * look, a refresh icon, a save that returns at once. Do not use it to gate real work: it changes
+ * what is shown, never what the request does.
+ */
+export function useHeldPending(pending, minMs = 400) {
+    const [held, setHeld] = useState(false);
+    const startedAt = useRef(0);
+    // Raised while rendering, not in an effect, so there is no frame where `pending` is true and the
+    // hold is not. It only ever turns on here. The timer below is the one place it turns off.
+    if (pending && !held)
+        setHeld(true);
+    useEffect(() => {
+        if (pending) {
+            startedAt.current = Date.now();
+            return;
+        }
+        const remaining = Math.max(0, startedAt.current + minMs - Date.now());
+        const timer = setTimeout(() => setHeld(false), remaining);
+        return () => clearTimeout(timer);
+    }, [pending, minMs]);
+    return pending || held;
+}
+//# sourceMappingURL=held-pending.js.map

package/dist/held-pending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"held-pending.js","sourceRoot":"","sources":["../src/held-pending.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEpD,iGAAiG;AACjG,iGAAiG;AACjG,gGAAgG;AAChG,qCAAqC;AAErC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,KAAK,GAAG,GAAG;IAC1D,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAE5B,iGAAiG;IACjG,0FAA0F;IAC1F,IAAI,OAAO,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,EAAE,CAAC;YACZ,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/B,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACtE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;QAC1D,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAErB,OAAO,OAAO,IAAI,IAAI,CAAC;AACzB,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export { cn } from "./cn.ts";
 export { copyText, useCopy, type CopyOptions, type CopyState } from "./copy.ts";
+export { BusyRing } from "./busy-ring.tsx";
+export { useHeldPending } from "./held-pending.ts";
 export { returnPathFromLocation, safeInternalPath, type PathParts } from "./internal-path.ts";
 export { forgetAuthEmail, recallAuthEmail, rememberAuthEmail } from "./auth-email.ts";
 export { ApiError, isAbortError } from "./api-error.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgCA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE9F,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEtF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,eAAe,EACf,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzE,OAAO,EACL,aAAa,EACb,SAAS,EACT,YAAY,EACZ,WAAW,EACX,KAAK,oBAAoB,EACzB,KAAK,SAAS,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,EACb,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,YAAY,EACjB,KAAK,SAAS,GACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,UAAU,GACX,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE9E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAElF,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgCA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE9F,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEtF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,eAAe,EACf,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzE,OAAO,EACL,aAAa,EACb,SAAS,EACT,YAAY,EACZ,WAAW,EACX,KAAK,oBAAoB,EACzB,KAAK,SAAS,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,EACb,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,YAAY,EACjB,KAAK,SAAS,GACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,UAAU,GACX,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE9E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAElF,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -31,6 +31,8 @@
 // identical in source.
 export { cn } from "./cn.js";
 export { copyText, useCopy } from "./copy.js";
+export { BusyRing } from "./busy-ring.js";
+export { useHeldPending } from "./held-pending.js";
 export { returnPathFromLocation, safeInternalPath } from "./internal-path.js";
 export { forgetAuthEmail, recallAuthEmail, rememberAuthEmail } from "./auth-email.js";
 export { ApiError, isAbortError } from "./api-error.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,+FAA+F;AAC/F,gGAAgG;AAChG,+FAA+F;AAC/F,iGAAiG;AACjG,0BAA0B;AAC1B,EAAE;AACF,qEAAqE;AACrE,8DAA8D;AAC9D,uEAAuE;AACvE,gEAAgE;AAChE,4EAA4E;AAC5E,4FAA4F;AAC5F,8FAA8F;AAC9F,EAAE;AACF,2FAA2F;AAC3F,iGAAiG;AACjG,+FAA+F;AAC/F,gGAAgG;AAChG,4EAA4E;AAC5E,EAAE;AACF,2FAA2F;AAC3F,iGAAiG;AACjG,qFAAqF;AACrF,6FAA6F;AAC7F,iGAAiG;AACjG,yFAAyF;AACzF,uBAAuB;AAEvB,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAoC,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAkB,MAAM,oBAAoB,CAAC;AAE9F,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEtF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,eAAe,GAMhB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAiB,MAAM,UAAU,CAAC;AAEzE,OAAO,EACL,aAAa,EACb,SAAS,EACT,YAAY,EACZ,WAAW,GAGZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,GAGd,MAAM,qBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,YAAY,GASb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,UAAU,GACX,MAAM,sBAAsB,CAAC;AAE9B,iGAAiG;AACjG,kGAAkG;AAClG,6FAA6F;AAC7F,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE9E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAwB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,+FAA+F;AAC/F,gGAAgG;AAChG,+FAA+F;AAC/F,iGAAiG;AACjG,0BAA0B;AAC1B,EAAE;AACF,qEAAqE;AACrE,8DAA8D;AAC9D,uEAAuE;AACvE,gEAAgE;AAChE,4EAA4E;AAC5E,4FAA4F;AAC5F,8FAA8F;AAC9F,EAAE;AACF,2FAA2F;AAC3F,iGAAiG;AACjG,+FAA+F;AAC/F,gGAAgG;AAChG,4EAA4E;AAC5E,EAAE;AACF,2FAA2F;AAC3F,iGAAiG;AACjG,qFAAqF;AACrF,6FAA6F;AAC7F,iGAAiG;AACjG,yFAAyF;AACzF,uBAAuB;AAEvB,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAoC,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAkB,MAAM,oBAAoB,CAAC;AAE9F,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEtF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,eAAe,GAMhB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAiB,MAAM,UAAU,CAAC;AAEzE,OAAO,EACL,aAAa,EACb,SAAS,EACT,YAAY,EACZ,WAAW,GAGZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,GAGd,MAAM,qBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,YAAY,GASb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,UAAU,GACX,MAAM,sBAAsB,CAAC;AAE9B,iGAAiG;AACjG,kGAAkG;AAClG,6FAA6F;AAC7F,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE9E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAwB,MAAM,WAAW,CAAC"}

package/dist/ui/menu.d.ts

@@ -1,6 +1,6 @@
 import { Menu as Primitive } from "@base-ui/react/menu";
 import type { ReactNode } from "react";
-export declare const Menu: <Payload>(props: Primitive.Root.Props<Payload>) => React.JSX.Element;
+export declare const Menu: typeof Primitive.Root;
 export declare const MenuTrigger: Primitive.Trigger;
 export declare const MenuPortal: import("react").ForwardRefExoticComponent<Omit<import("@base-ui/react").ContextMenuPortalProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
 export declare const MenuPositioner: import("react").ForwardRefExoticComponent<Omit<import("@base-ui/react").MenuPositionerProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;