@charcuterie/ui 3.11.0 → 3.13.0

package/dist/Avatar/Avatar.d.ts

@@ -0,0 +1,163 @@
+import type { CategoricalIndex } from "@charcuterie/tokens";
+import type { ComponentPropsWithRef, ReactNode } from "react";
+import type { IntentAppearance } from "../intentStyles.ts";
+export type AvatarSize = keyof typeof AVATAR_SIZE_CLASS;
+export type AvatarProps = Omit<ComponentPropsWithRef<"span">, "children"> & {
+    /**
+     * The same three the rest of the categorical family wears, minus
+     * `ghost` — a chip with no fill and no border is a floating
+     * letter, and the whole job here is to be a **shape** the eye
+     * finds in a list.
+     */
+    appearance?: Exclude<IntentAppearance, "ghost">;
+    /**
+     * The colour, when somebody has chosen one. Omitted, it is derived
+     * — see `categoricalKey` — so an avatar always has a colour and
+     * never has to be given one.
+     */
+    categorical?: CategoricalIndex;
+    /**
+     * What the derived colour is hashed from when `categorical` is
+     * absent. Defaults to `name`.
+     *
+     * Pass the **user's id** wherever one exists. `getCategoricalIndex`
+     * does no normalization on purpose, so hashing the name means a
+     * rename — or a trailing space — silently repaints a person the
+     * reader had already learned to recognise. An id does not move.
+     */
+    categoricalKey?: string;
+    /**
+     * A glyph instead of the initials — a robot for an agent account,
+     * a lock for a service account. The library ships **no icons**, so
+     * this is the app's own
+     * ([decision](../../../docs/decisions/2026-07-29-ship-no-icons-and-no-symbol-glyphs.md)).
+     * It is decoration: the name still travels in `aria-label`, and a
+     * glyph the font cannot render must not be the only thing
+     * carrying who this is.
+     */
+    icon?: ReactNode;
+    /**
+     * A photo. Optional, and **it is never the only thing** — a
+     * request that 404s, a signed URL that expired, or an app that
+     * simply has no photos falls back to the initials with no empty
+     * box in between.
+     */
+    imageUrl?: string;
+    /**
+     * The letters, when the derivation is wrong. Derived from `name`
+     * otherwise: the first character of each of the first two
+     * whitespace-separated words, upper-cased.
+     *
+     * Worth passing for a name the split gets wrong — a mononym that
+     * wants two letters, a name whose family part comes first, a
+     * handle with punctuation in it.
+     */
+    initials?: string;
+    /**
+     * Who this is. Read by assistive technology and shown on hover;
+     * **never printed as visible text**, which is the entire point of
+     * the component.
+     *
+     * Nullable, and that is a decision rather than a loose type — see
+     * the note on the component about what an unassigned row draws.
+     */
+    name: string | null | undefined;
+    size?: AvatarSize;
+};
+/**
+ * One rule: **the circle is 1.9 x its own type size**, and `size`
+ * picks which step of the type scale that is.
+ *
+ * 1.9 rather than a tighter number because a circle only offers its
+ * full width on the centre line. Two capitals measure about 1.25em
+ * in this face, and a chord taken at the cap height of a 1.75em
+ * circle is barely wider than that — measured, not guessed.
+ *
+ * It is em-based rather than a fixed `size-5` / `size-7` / `size-9`,
+ * and that is the whole of the design. Every length in this token
+ * set moves with the density axis — `--font-size-xs` is 0.88rem
+ * compact, 0.94rem at desktop and 1.11rem on the kiosk — so a chip
+ * pinned to 20px holds two letters at one density and clips them at
+ * the next. `controlStyles.ts` says the same thing about badges and
+ * dots: non-control sizing is type-relative on purpose, because a
+ * chip that stays 20px while the kiosk scales the prose around it
+ * reads as a rendering fault.
+ *
+ * The hand-rolled avatar this replaces is the worked example. It was
+ * `size-5` with `text-[0.625rem]` — a 10px font, which is **not a
+ * step of this type scale at any density**, because 20px is not
+ * enough room for two characters at the smallest size the tokens
+ * actually offer. A component that has to invent a font size to fit
+ * its own box has the wrong box.
+ */
+declare const AVATAR_SIZE_CLASS: {
+    readonly sm: "size-[1.9em] text-xs";
+    readonly md: "size-[1.9em] text-md";
+    readonly lg: "size-[1.9em] text-xl";
+};
+/**
+ * A person, as a coloured chip — a glyph or an initial, with the
+ * name attached where only assistive technology and a hover can
+ * reach it.
+ *
+ * It exists to delete a printed name. Docket's board put the word
+ * *"Owner"* on most of its cards, which is a column of identical
+ * text doing the work of a colour; the fleet's boards all want the
+ * same chip, and `Board.stories.tsx` had already hand-rolled one
+ * inside a story file.
+ *
+ * ### Unassigned draws **nothing**, and the component owns that
+ *
+ * `name` accepts `null` and `undefined`, and either renders `null`.
+ * A grey *"None"* placeholder is a decision the design system makes
+ * against the reader: it is a chip that says a fact nobody needed,
+ * repeated down every unassigned row, at the same weight as the
+ * chips that mean something.
+ *
+ * The alternative is a ternary at every call site, and the call
+ * sites are the whole problem — a board, a table, a card footer, a
+ * detail pane, each written on a different day. The one that forgets
+ * is the one that ships the grey circle. Absence is expressed once,
+ * here, which is the same call `Board` makes with `onMove`: no
+ * handler means no affordance, rather than a disabled one.
+ *
+ * A consumer that genuinely wants to *say* "unassigned" still can —
+ * that is text, or an `EmptyState`, and neither of them is an
+ * avatar.
+ *
+ * ### The name is never visible text
+ *
+ * `role="img"` with an `aria-label`, exactly as `Swatch` does, so
+ * `getByRole("img", { name })` is the one handle whether the chip is
+ * showing a photo, a glyph or two letters. `title` carries the same
+ * string for a pointer, which is the only channel a person browsing
+ * with their eyes has — the letters `KG` are not a name.
+ *
+ * That is also why there is no `isNameVisible`: an avatar whose name
+ * is printed beside it is a name with a decoration in front of it,
+ * and the layout that wants one should print the name and skip the
+ * chip.
+ *
+ * ### The colour is derived, never invented
+ *
+ * `categorical` is the ten-wide non-semantic scale — the same one
+ * `Badge` takes — and **not** an `intent`. An intent is a claim the
+ * design system makes; a person is not `danger`. With no
+ * `categorical` the index comes from `getCategoricalIndex`, which is
+ * a pure function of the key, so the same person is the same colour
+ * on every machine, every reload, and in a server render. Ten
+ * colours means collisions past ten people, and that is a property
+ * of the palette rather than a fault in the hash: the colour helps
+ * you *scan*, and the accessible name is what identifies.
+ *
+ * ### There is no `AvatarGroup`
+ *
+ * Deliberately. A stack of overlapping chips with a `+3` needs
+ * answers to which three survive, in what order, and what the
+ * overflow announces — and no consumer has asked the question yet. A
+ * row of `Avatar`s in a flex box is what a multi-assignee list looks
+ * like until one does.
+ */
+export declare const Avatar: ({ appearance, categorical, categoricalKey, className, icon, imageUrl, initials, name, size, title, ...spanProps }: AvatarProps) => ReactNode;
+export {};
+//# sourceMappingURL=Avatar.d.ts.map

package/dist/Avatar/Avatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../../src/Avatar/Avatar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAE3D,OAAO,KAAK,EACV,qBAAqB,EACrB,SAAS,EACV,MAAM,OAAO,CAAA;AAId,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAG1D,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,iBAAiB,CAAA;AAEvD,MAAM,MAAM,WAAW,GAAG,IAAI,CAC5B,qBAAqB,CAAC,MAAM,CAAC,EAC7B,UAAU,CACX,GAAG;IACF;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAA;IAC/C;;;;OAIG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAA;IAC9B;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;;OAOG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAC/B,IAAI,CAAC,EAAE,UAAU,CAAA;CAClB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,QAAA,MAAM,iBAAiB;;;;CAIb,CAAA;AAkBV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,eAAO,MAAM,MAAM,GAAI,mHAYpB,WAAW,KAAG,SAkEhB,CAAA"}

package/dist/Avatar/Avatar.js

@@ -0,0 +1,139 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { getCategoricalIndex } from "@charcuterie/tokens";
+import { useState } from "react";
+import { CATEGORICAL_APPEARANCE_CLASS } from "../categoricalStyles.js";
+import { toClassName } from "../toClassName.js";
+/**
+ * One rule: **the circle is 1.9 x its own type size**, and `size`
+ * picks which step of the type scale that is.
+ *
+ * 1.9 rather than a tighter number because a circle only offers its
+ * full width on the centre line. Two capitals measure about 1.25em
+ * in this face, and a chord taken at the cap height of a 1.75em
+ * circle is barely wider than that — measured, not guessed.
+ *
+ * It is em-based rather than a fixed `size-5` / `size-7` / `size-9`,
+ * and that is the whole of the design. Every length in this token
+ * set moves with the density axis — `--font-size-xs` is 0.88rem
+ * compact, 0.94rem at desktop and 1.11rem on the kiosk — so a chip
+ * pinned to 20px holds two letters at one density and clips them at
+ * the next. `controlStyles.ts` says the same thing about badges and
+ * dots: non-control sizing is type-relative on purpose, because a
+ * chip that stays 20px while the kiosk scales the prose around it
+ * reads as a rendering fault.
+ *
+ * The hand-rolled avatar this replaces is the worked example. It was
+ * `size-5` with `text-[0.625rem]` — a 10px font, which is **not a
+ * step of this type scale at any density**, because 20px is not
+ * enough room for two characters at the smallest size the tokens
+ * actually offer. A component that has to invent a font size to fit
+ * its own box has the wrong box.
+ */
+const AVATAR_SIZE_CLASS = {
+    sm: "size-[1.9em] text-xs",
+    md: "size-[1.9em] text-md",
+    lg: "size-[1.9em] text-xl",
+};
+/**
+ * The first character of each of the first two words.
+ *
+ * `Array.from` rather than `charAt`, so a name that starts outside
+ * the BMP contributes a whole character instead of half a surrogate
+ * pair and a replacement glyph.
+ */
+const toInitials = (name) => name
+    .trim()
+    .split(/\s+/)
+    .slice(0, 2)
+    .map((word) => Array.from(word)[0] ?? "")
+    .join("")
+    .toLocaleUpperCase();
+/**
+ * A person, as a coloured chip — a glyph or an initial, with the
+ * name attached where only assistive technology and a hover can
+ * reach it.
+ *
+ * It exists to delete a printed name. Docket's board put the word
+ * *"Owner"* on most of its cards, which is a column of identical
+ * text doing the work of a colour; the fleet's boards all want the
+ * same chip, and `Board.stories.tsx` had already hand-rolled one
+ * inside a story file.
+ *
+ * ### Unassigned draws **nothing**, and the component owns that
+ *
+ * `name` accepts `null` and `undefined`, and either renders `null`.
+ * A grey *"None"* placeholder is a decision the design system makes
+ * against the reader: it is a chip that says a fact nobody needed,
+ * repeated down every unassigned row, at the same weight as the
+ * chips that mean something.
+ *
+ * The alternative is a ternary at every call site, and the call
+ * sites are the whole problem — a board, a table, a card footer, a
+ * detail pane, each written on a different day. The one that forgets
+ * is the one that ships the grey circle. Absence is expressed once,
+ * here, which is the same call `Board` makes with `onMove`: no
+ * handler means no affordance, rather than a disabled one.
+ *
+ * A consumer that genuinely wants to *say* "unassigned" still can —
+ * that is text, or an `EmptyState`, and neither of them is an
+ * avatar.
+ *
+ * ### The name is never visible text
+ *
+ * `role="img"` with an `aria-label`, exactly as `Swatch` does, so
+ * `getByRole("img", { name })` is the one handle whether the chip is
+ * showing a photo, a glyph or two letters. `title` carries the same
+ * string for a pointer, which is the only channel a person browsing
+ * with their eyes has — the letters `KG` are not a name.
+ *
+ * That is also why there is no `isNameVisible`: an avatar whose name
+ * is printed beside it is a name with a decoration in front of it,
+ * and the layout that wants one should print the name and skip the
+ * chip.
+ *
+ * ### The colour is derived, never invented
+ *
+ * `categorical` is the ten-wide non-semantic scale — the same one
+ * `Badge` takes — and **not** an `intent`. An intent is a claim the
+ * design system makes; a person is not `danger`. With no
+ * `categorical` the index comes from `getCategoricalIndex`, which is
+ * a pure function of the key, so the same person is the same colour
+ * on every machine, every reload, and in a server render. Ten
+ * colours means collisions past ten people, and that is a property
+ * of the palette rather than a fault in the hash: the colour helps
+ * you *scan*, and the accessible name is what identifies.
+ *
+ * ### There is no `AvatarGroup`
+ *
+ * Deliberately. A stack of overlapping chips with a `+3` needs
+ * answers to which three survive, in what order, and what the
+ * overflow announces — and no consumer has asked the question yet. A
+ * row of `Avatar`s in a flex box is what a multi-assignee list looks
+ * like until one does.
+ */
+export const Avatar = ({ appearance = "soft", categorical, categoricalKey, className, icon, imageUrl, initials, name, size = "md", title, ...spanProps }) => {
+    /**
+     * The URL that failed, rather than a `hasFailed` boolean.
+     *
+     * A boolean has to be *reset* when `imageUrl` changes, which is an
+     * effect syncing a prop into state — the shape this library
+     * refuses everywhere else
+     * ([decision](../../../docs/decisions/2026-07-29-logic-hooks-are-uncontrolled.md)).
+     * Storing the URL makes the comparison below derive the answer, so
+     * a second photo gets its own attempt and a re-render never
+     * resurrects a dead one.
+     */
+    const [failedImageUrl, setFailedImageUrl] = useState(undefined);
+    const hasImageError = imageUrl !== undefined && failedImageUrl === imageUrl;
+    const trimmedName = name?.trim();
+    if (!trimmedName) {
+        return null;
+    }
+    const resolvedInitials = initials ?? toInitials(trimmedName);
+    const resolvedCategorical = categorical ??
+        getCategoricalIndex(categoricalKey ?? trimmedName);
+    return (_jsx("span", { ...spanProps, "aria-label": trimmedName, className: toClassName("inline-grid shrink-0 place-items-center overflow-hidden rounded-full border font-medium leading-none", AVATAR_SIZE_CLASS[size], CATEGORICAL_APPEARANCE_CLASS[resolvedCategorical][appearance], className), role: "img", title: title ?? trimmedName, children: imageUrl !== undefined && !hasImageError ? (_jsx("img", { alt: "", className: "size-full object-cover", onError: () => {
+                setFailedImageUrl(imageUrl);
+            }, src: imageUrl })) : (_jsx("span", { "aria-hidden": "true", children: icon ?? resolvedInitials })) }));
+};
+//# sourceMappingURL=Avatar.js.map

package/dist/Avatar/Avatar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Avatar.js","sourceRoot":"","sources":["../../src/Avatar/Avatar.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAKzD,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEhC,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAA;AAEtE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAsE/C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,iBAAiB,GAAG;IACxB,EAAE,EAAE,sBAAsB;IAC1B,EAAE,EAAE,sBAAsB;IAC1B,EAAE,EAAE,sBAAsB;CAClB,CAAA;AAEV;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE,CAC1C,IAAI;KACD,IAAI,EAAE;KACN,KAAK,CAAC,KAAK,CAAC;KACZ,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;KACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;KACxC,IAAI,CAAC,EAAE,CAAC;KACR,iBAAiB,EAAE,CAAA;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,EACrB,UAAU,GAAG,MAAM,EACnB,WAAW,EACX,cAAc,EACd,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,IAAI,GAAG,IAAI,EACX,KAAK,EACL,GAAG,SAAS,EACA,EAAa,EAAE;IAC3B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAElD,SAAS,CAAC,CAAA;IAEZ,MAAM,aAAa,GACjB,QAAQ,KAAK,SAAS,IAAI,cAAc,KAAK,QAAQ,CAAA;IAEvD,MAAM,WAAW,GAAG,IAAI,EAAE,IAAI,EAAE,CAAA;IAEhC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,gBAAgB,GACpB,QAAQ,IAAI,UAAU,CAAC,WAAW,CAAC,CAAA;IAErC,MAAM,mBAAmB,GACvB,WAAW;QACX,mBAAmB,CAAC,cAAc,IAAI,WAAW,CAAC,CAAA;IAEpD,OAAO,CACL,kBACM,SAAS,gBACD,WAAW,EACvB,SAAS,EAAE,WAAW,CACpB,sGAAsG,EACtG,iBAAiB,CAAC,IAAI,CAAC,EACvB,4BAA4B,CAAC,mBAAmB,CAAC,CAC/C,UAAU,CACX,EACD,SAAS,CACV,EACD,IAAI,EAAC,KAAK,EACV,KAAK,EAAE,KAAK,IAAI,WAAW,YAE1B,QAAQ,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAI1C,cACE,GAAG,EAAC,EAAE,EACN,SAAS,EAAC,wBAAwB,EAClC,OAAO,EAAE,GAAG,EAAE;gBACZ,iBAAiB,CAAC,QAAQ,CAAC,CAAA;YAC7B,CAAC,EACD,GAAG,EAAE,QAAQ,GACb,CACH,CAAC,CAAC,CAAC,CACF,8BAAkB,MAAM,YACrB,IAAI,IAAI,gBAAgB,GACpB,CACR,GACI,CACR,CAAA;AACH,CAAC,CAAA"}

package/dist/Board/BoardLaneList.d.ts

@@ -12,6 +12,23 @@ export type BoardLane = {
      * requirement and an empty lane is the one a person sees most.
      */
     emptyState?: ReactNode;
+    /**
+     * Where the lane's own heading navigates — a route showing this
+     * lane and nothing else.
+     *
+     * **A link inside the heading, never a heading replaced by a
+     * link.** The `<h3>` keeps its level, its id and its place in the
+     * document outline, so the lane stays a named `group` and the
+     * screen-reader outline is unchanged; the anchor sits inside it.
+     * Routed through `RouterLinkProvider` like every other `href` in
+     * this library, so an app with a client-side router navigates
+     * without a full page load and one without it still gets a real
+     * `<a href>`.
+     *
+     * Absent means the heading is plain text, which is what every
+     * existing consumer gets.
+     */
+    href?: string;
     /**
      * The **true** size of the lane, when `items` is a truncated page
      * of it. This is what the count badge shows, and the difference
@@ -23,6 +40,18 @@ export type BoardLane = {
     itemCount?: number;
     items: readonly BoardItem[];
     key: string;
+    /**
+     * The lane's name, and it stays a **string** rather than widening
+     * to a `ReactNode`.
+     *
+     * It is not only a heading: the same value names the lane in the
+     * move menu on every card, in the Narrow View's segmented control,
+     * in the "+ n more in Todo" line, and in the sentence the live
+     * region reads out after a move. A `ReactNode` is not something
+     * any of those four can put in a string, so widening this would
+     * trade one linkable heading for four places that can no longer
+     * say which lane they mean. `href` buys the link without that.
+     */
     label: string;
     /**
      * What "+ n more in this lane" does. With no handler the line is

package/dist/Board/BoardLaneList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BoardLaneList.d.ts","sourceRoot":"","sources":["../../src/Board/BoardLaneList.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAMtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGhD,MAAM,MAAM,SAAS,GAAG;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,SAAS,SAAS,EAAE,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;;;OAMG;IACH,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC;;;;;;OAMG;IACH,YAAY,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC3B,mBAAmB,EAAE,OAAO,CAAA;IAC5B,IAAI,EAAE,SAAS,CAAA;IACf,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,WAAW,EAAE,SAAS;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACtD,YAAY,CAAC,EAAE,CACb,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,KACd,IAAI,CAAA;IACT,WAAW,CAAC,EAAE,CACZ,YAAY,EAAE;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,aAAa,EAAE,WAAW,GAAG,OAAO,CAAA;QACpC,SAAS,EAAE,MAAM,CAAA;KAClB,EACD,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAC3C,IAAI,CAAA;IACT,mBAAmB,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;CAC3D,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,aAAa,GAAI,0IAU3B,kBAAkB,KAAG,SAyJvB,CAAA"}
+{"version":3,"file":"BoardLaneList.d.ts","sourceRoot":"","sources":["../../src/Board/BoardLaneList.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAOtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGhD,MAAM,MAAM,SAAS,GAAG;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,SAAS,SAAS,EAAE,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX;;;;;;;;;;;OAWG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;;;OAMG;IACH,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC;;;;;;OAMG;IACH,YAAY,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC3B,mBAAmB,EAAE,OAAO,CAAA;IAC5B,IAAI,EAAE,SAAS,CAAA;IACf,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,WAAW,EAAE,SAAS;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACtD,YAAY,CAAC,EAAE,CACb,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,KACd,IAAI,CAAA;IACT,WAAW,CAAC,EAAE,CACZ,YAAY,EAAE;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,aAAa,EAAE,WAAW,GAAG,OAAO,CAAA;QACpC,SAAS,EAAE,MAAM,CAAA;KAClB,EACD,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAC3C,IAAI,CAAA;IACT,mBAAmB,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;CAC3D,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,aAAa,GAAI,0IAU3B,kBAAkB,KAAG,SA8KvB,CAAA"}

package/dist/Board/BoardLaneList.js

@@ -3,6 +3,7 @@ import { useUniqueId } from "@charcuterie/logic";
 import { Badge } from "../Badge/Badge.js";
 import { Button } from "../Button/Button.js";
 import { EmptyState } from "../EmptyState/EmptyState.js";
+import { TextLink } from "../TextLink/TextLink.js";
 import { toClassName } from "../toClassName.js";
 import { BoardCard } from "./BoardCard.js";
 /**
@@ -48,7 +49,7 @@ export const BoardLaneList = ({ dropIndicatorOffset, headingLevel, isVisibleWhen
         // queries the **board**, not the list below — an element
         // carrying `container-type` still resolves its own container
         // queries against its nearest ancestor container.
-        isVisibleWhenNarrow ? "flex" : "hidden cq-lg:flex"), children: _jsx("div", { className: "@container", children: _jsxs("div", { className: "flex flex-col gap-2 rounded-lg border border-border-subtle bg-surface-raised px-3 py-2 cq-lg:border-0 cq-lg:bg-transparent cq-lg:p-0", children: [_jsxs("header", { className: "flex items-center gap-2", children: [_jsx(Heading, { className: "font-semibold text-content-primary text-sm", id: headingId, children: lane.label }), _jsx(Badge, { appearance: "soft", intent: "neutral", size: "sm", children: String(itemCount) }), _jsx("span", { className: "flex-1" }), lane.actions] }), _jsxs("ul", { className: "relative flex flex-col", ref: registerListElement, children: [lane.items.length === 0 ? (_jsx("li", { children: lane.emptyState ?? (_jsx(EmptyState, { description: "Nothing is waiting here.", heading: "Nothing here", headingLevel: 
+        isVisibleWhenNarrow ? "flex" : "hidden cq-lg:flex"), children: _jsx("div", { className: "@container", children: _jsxs("div", { className: "flex flex-col gap-2 rounded-lg border border-border-subtle bg-surface-raised px-3 py-2 cq-lg:border-0 cq-lg:bg-transparent cq-lg:p-0", children: [_jsxs("header", { className: "flex items-center gap-2", children: [_jsx(Heading, { className: "font-semibold text-content-primary text-sm", id: headingId, children: lane.href ? (_jsx(TextLink, { appearance: "standalone", className: "font-semibold text-inherit", href: lane.href, children: lane.label })) : (lane.label) }), _jsx(Badge, { appearance: "soft", intent: "neutral", size: "sm", children: String(itemCount) }), _jsx("span", { className: "flex-1" }), lane.actions] }), _jsxs("ul", { className: "relative flex flex-col", ref: registerListElement, children: [lane.items.length === 0 ? (_jsx("li", { children: lane.emptyState ?? (_jsx(EmptyState, { description: "Nothing is waiting here.", heading: "Nothing here", headingLevel: 
                                     // One below the lane's own, so the outline
                                     // stays whole wherever the board is mounted.
                                     (headingLevel + 1), size: "sm" })) })) : (lane.items.map((item, index) => (_jsx(BoardCard, { item: item, laneLabel: lane.label, moveIcon: moveIcon, moveTargets: moveTargets, onMoveToLane: onMoveToLane

package/dist/Board/BoardLaneList.js.map

@@ -1 +1 @@
-{"version":3,"file":"BoardLaneList.js","sourceRoot":"","sources":["../../src/Board/BoardLaneList.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"BoardLaneList.js","sourceRoot":"","sources":["../../src/Board/BoardLaneList.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAGhD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAoB,CAAA;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAsB,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA8B,CAAA;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAA0B,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAiB,CAAA;AAoG3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAC5B,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,WAAW,EACX,mBAAmB,GACA,EAAa,EAAE;IAClC,MAAM,SAAS,GAAG,WAAW,EAAE,CAAA;IAE/B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;IAErD,MAAM,WAAW,GAAG,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;IAEjD,MAAM,OAAO,GAAG,IAAI,YAAY,EAAW,CAAA;IAE3C,OAAO,CAqBL,iCACmB,SAAS,EAC1B,IAAI,EAAC,OAAO,EACZ,SAAS,EAAE,WAAW,CACpB,+BAA+B;QAC/B,2DAA2D;QAC3D,6DAA6D;QAC7D,yDAAyD;QACzD,6DAA6D;QAC7D,kDAAkD;QAClD,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAmB,CACnD,YAUD,cAAK,SAAS,EAAC,YAAY,YACzB,eAAK,SAAS,EAAC,sIAAsI,aACnJ,kBAAQ,SAAS,EAAC,yBAAyB,aACzC,KAAC,OAAO,IACN,SAAS,EAAC,4CAA4C,EACtD,EAAE,EAAE,SAAS,YAEZ,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAYX,KAAC,QAAQ,IACP,UAAU,EAAC,YAAY,EACvB,SAAS,EAAC,4BAA4B,EACtC,IAAI,EAAE,IAAI,CAAC,IAAI,YAEd,IAAI,CAAC,KAAK,GACF,CACZ,CAAC,CAAC,CAAC,CACF,IAAI,CAAC,KAAK,CACX,GACO,EAEV,KAAC,KAAK,IACJ,UAAU,EAAC,MAAM,EACjB,MAAM,EAAC,SAAS,EAChB,IAAI,EAAC,IAAI,YAER,MAAM,CAAC,SAAS,CAAC,GACZ,EAER,eAAM,SAAS,EAAC,QAAQ,GAAG,EAE1B,IAAI,CAAC,OAAO,IACN,EAET,cACE,SAAS,EAAC,wBAAwB,EAClC,GAAG,EAAE,mBAAmB,aAEvB,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CACzB,uBACG,IAAI,CAAC,UAAU,IAAI,CAClB,KAAC,UAAU,IACT,WAAW,EAAC,0BAA0B,EACtC,OAAO,EAAC,cAAc,EACtB,YAAY;oCACV,2CAA2C;oCAC3C,6CAA6C;oCAC7C,CAAC,YAAY,GAAG,CAAC,CAAkB,EAErC,IAAI,EAAC,IAAI,GACT,CACH,GACE,CACN,CAAC,CAAC,CAAC,CACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAC9B,KAAC,SAAS,IACR,IAAI,EAAE,IAAI,EAEV,SAAS,EAAE,IAAI,CAAC,KAAK,EACrB,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,EACxB,YAAY,EACV,YAAY;oCACV,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE;wCACZ,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;oCACnC,CAAC;oCACH,CAAC,CAAC,SAAS,EAEf,WAAW,EACT,WAAW;oCACT,CAAC,CAAC,CAAC,YAAY,EAAE,EAAE;wCACf,WAAW,CAAC,YAAY,EAAE;4CACxB,SAAS,EAAE,KAAK;4CAChB,OAAO,EAAE,IAAI,CAAC,GAAG;yCAClB,CAAC,CAAA;oCACJ,CAAC;oCACH,CAAC,CAAC,SAAS,IAnBV,IAAI,CAAC,GAAG,CAqBb,CACH,CAAC,CACH,EAEA,mBAAmB,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACrC,4BACc,MAAM,EAClB,SAAS,EAAC,sFAAsF,EAChG,KAAK,EAAE;oCACL,eAAe,EAAE,GAAG,mBAAmB,IAAI;iCAC5C,GACD,CACH,IACE,EAEJ,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CACjB,YAAG,SAAS,EAAC,4BAA4B,YACtC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CACjB,KAAC,MAAM,IACL,UAAU,EAAC,OAAO,EAClB,MAAM,EAAC,SAAS,EAChB,OAAO,EAAE,IAAI,CAAC,UAAU,EACxB,IAAI,EAAC,IAAI,YAER,KAAK,WAAW,YAAY,IAAI,CAAC,KAAK,EAAE,GAClC,CACV,CAAC,CAAC,CAAC,CACF,KAAK,WAAW,YAAY,IAAI,CAAC,KAAK,EAAE,CACzC,GACC,CACL,CAAC,CAAC,CAAC,IAAI,IACJ,GACF,GACF,CACP,CAAA;AACH,CAAC,CAAA"}

package/dist/CopyButton/CopyButton.d.ts

@@ -0,0 +1,67 @@
+import type { ReactNode } from "react";
+import type { ButtonProps } from "../Button/Button.tsx";
+/** Where the button is in the one action it performs. */
+export type CopyStatus = "copied" | "failed" | "idle";
+export type CopyButtonProps = Omit<ButtonProps, "children" | "isLoading" | "loadingLabel" | "onCopy"> & {
+    /**
+     * How long the confirmation stays up, in milliseconds.
+     *
+     * Long enough to be read after the eye has moved back to the form
+     * being filled in, short enough that a second copy of a *different*
+     * value is not mistaken for the first one's tick.
+     */
+    confirmDuration?: number;
+    /** Resting label. A word, not a glyph — this library ships no icons. */
+    children?: ReactNode;
+    /** Shown while the copy is confirmed. */
+    copiedLabel?: ReactNode;
+    /**
+     * The clipboard write, injected. Swapped in tests and in a host
+     * that owns its own clipboard bridge (Electron, a kiosk shell).
+     */
+    copy?: (value: string) => Promise<boolean> | boolean;
+    /** Shown when the clipboard refused. */
+    failedLabel?: ReactNode;
+    /**
+     * Told what actually happened, every press.
+     *
+     * `isCopied` is the point of the callback rather than a detail: a
+     * consumer that files the mail away on a copy must not file it away
+     * on a copy the browser refused.
+     */
+    onCopy?: (isCopied: boolean, value: string) => void;
+    /** The string that goes on the clipboard. */
+    value: string;
+};
+/**
+ * A button that puts a string on the clipboard and says so.
+ *
+ * From a consumer, like `Alert` and `BadgeButton` before it: four
+ * repos spell this shape by hand — mux-magic's YAML dialog flips its
+ * own label on a `setTimeout`, spoolbuddy carries a 15-line
+ * `copyToClipboard` with the `execCommand` fallback inline, bambuddy
+ * copies a download link from two menus, and mail-sifter's
+ * verification-code banner is the fourth. None of the four agree on
+ * what happens when the clipboard says no, and three of them cannot
+ * tell.
+ *
+ * **The confirmation is the button, not a toast.** The press and the
+ * proof are the same object, so the eye does not travel; a toast is
+ * right for something that happened *elsewhere*. A consumer that
+ * wants both still gets `onCopy`.
+ *
+ * **The label is a word.** `Copy` → `Copied`, and the intent goes
+ * with it, because a colour change alone is not a message and a tick
+ * glyph is an icon this library does not ship.
+ *
+ * **It announces.** A screen reader is not reliably told that a
+ * focused button's own name changed, so the outcome is also written
+ * into a `role="status"` region — and the failure says what to do
+ * next rather than only that it went wrong.
+ *
+ * **The timer is cancelled on unmount and on a re-press**, which is
+ * the bug in two of the four hand-rolled copies: press, navigate
+ * away, and a `setState` lands on nothing.
+ */
+export declare const CopyButton: ({ appearance, children, confirmDuration, copiedLabel, copy, failedLabel, intent, onClick, onCopy, value, ...buttonProps }: CopyButtonProps) => ReactNode;
+//# sourceMappingURL=CopyButton.d.ts.map

package/dist/CopyButton/CopyButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopyButton.d.ts","sourceRoot":"","sources":["../../src/CopyButton/CopyButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAKvD,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAA;AAErD,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,WAAW,EACX,UAAU,GAAG,WAAW,GAAG,cAAc,GAAG,QAAQ,CACrD,GAAG;IACF;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,yCAAyC;IACzC,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;IACpD,wCAAwC;IACxC,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACnD,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,UAAU,GAAI,2HAYxB,eAAe,KAAG,SAmEpB,CAAA"}

package/dist/CopyButton/CopyButton.js

@@ -0,0 +1,76 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { Button } from "../Button/Button.js";
+import { VisuallyHidden } from "../VisuallyHidden/VisuallyHidden.js";
+import { copyText as defaultCopyText } from "./copyText.js";
+/**
+ * A button that puts a string on the clipboard and says so.
+ *
+ * From a consumer, like `Alert` and `BadgeButton` before it: four
+ * repos spell this shape by hand — mux-magic's YAML dialog flips its
+ * own label on a `setTimeout`, spoolbuddy carries a 15-line
+ * `copyToClipboard` with the `execCommand` fallback inline, bambuddy
+ * copies a download link from two menus, and mail-sifter's
+ * verification-code banner is the fourth. None of the four agree on
+ * what happens when the clipboard says no, and three of them cannot
+ * tell.
+ *
+ * **The confirmation is the button, not a toast.** The press and the
+ * proof are the same object, so the eye does not travel; a toast is
+ * right for something that happened *elsewhere*. A consumer that
+ * wants both still gets `onCopy`.
+ *
+ * **The label is a word.** `Copy` → `Copied`, and the intent goes
+ * with it, because a colour change alone is not a message and a tick
+ * glyph is an icon this library does not ship.
+ *
+ * **It announces.** A screen reader is not reliably told that a
+ * focused button's own name changed, so the outcome is also written
+ * into a `role="status"` region — and the failure says what to do
+ * next rather than only that it went wrong.
+ *
+ * **The timer is cancelled on unmount and on a re-press**, which is
+ * the bug in two of the four hand-rolled copies: press, navigate
+ * away, and a `setState` lands on nothing.
+ */
+export const CopyButton = ({ appearance = "solid", children = "Copy", confirmDuration = 2000, copiedLabel = "Copied", copy = defaultCopyText, failedLabel = "Copy failed", intent = "accent", onClick, onCopy, value, ...buttonProps }) => {
+    const [status, setStatus] = useState("idle");
+    const timerRef = useRef(undefined);
+    // One cleanup covers both the unmount and the re-press: every path
+    // that starts a timer clears the previous one first.
+    useEffect(() => () => {
+        clearTimeout(timerRef.current);
+    }, []);
+    const settle = (next) => {
+        setStatus(next);
+        clearTimeout(timerRef.current);
+        timerRef.current = setTimeout(() => {
+            setStatus("idle");
+        }, confirmDuration);
+    };
+    const handleClick = (event) => {
+        onClick?.(event);
+        if (event.defaultPrevented)
+            return;
+        void (async () => {
+            const isCopied = await copy(value);
+            settle(isCopied ? "copied" : "failed");
+            onCopy?.(isCopied, value);
+        })();
+    };
+    const label = status === "copied"
+        ? copiedLabel
+        : status === "failed"
+            ? failedLabel
+            : children;
+    return (_jsxs(_Fragment, { children: [_jsx(Button, { ...buttonProps, appearance: appearance, intent: status === "copied"
+                    ? "success"
+                    : status === "failed"
+                        ? "danger"
+                        : intent, onClick: handleClick, children: label }), _jsx(VisuallyHidden, { role: "status", children: status === "copied"
+                    ? "Copied to the clipboard."
+                    : status === "failed"
+                        ? "The clipboard refused. Select the value and press Control C."
+                        : "" })] }));
+};
+//# sourceMappingURL=CopyButton.js.map

package/dist/CopyButton/CopyButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopyButton.js","sourceRoot":"","sources":["../../src/CopyButton/CopyButton.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEnD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAsB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAsC,CAAA;AACrE,OAAO,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,eAAe,CAAA;AAwC3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EACzB,UAAU,GAAG,OAAO,EACpB,QAAQ,GAAG,MAAM,EACjB,eAAe,GAAG,IAAI,EACtB,WAAW,GAAG,QAAQ,EACtB,IAAI,GAAG,eAAe,EACtB,WAAW,GAAG,aAAa,EAC3B,MAAM,GAAG,QAAQ,EACjB,OAAO,EACP,MAAM,EACN,KAAK,EACL,GAAG,WAAW,EACE,EAAa,EAAE;IAC/B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAa,MAAM,CAAC,CAAA;IACxD,MAAM,QAAQ,GACZ,MAAM,CAAgC,SAAS,CAAC,CAAA;IAElD,mEAAmE;IACnE,qDAAqD;IACrD,SAAS,CACP,GAAG,EAAE,CAAC,GAAG,EAAE;QACT,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAChC,CAAC,EACD,EAAE,CACH,CAAA;IAED,MAAM,MAAM,GAAG,CAAC,IAAgB,EAAE,EAAE;QAClC,SAAS,CAAC,IAAI,CAAC,CAAA;QACf,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QAC9B,QAAQ,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YACjC,SAAS,CAAC,MAAM,CAAC,CAAA;QACnB,CAAC,EAAE,eAAe,CAAC,CAAA;IACrB,CAAC,CAAA;IAED,MAAM,WAAW,GAAwC,CACvD,KAAK,EACL,EAAE;QACF,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;QAChB,IAAI,KAAK,CAAC,gBAAgB;YAAE,OAAM;QAElC,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAA;YAClC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;YACtC,MAAM,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAC3B,CAAC,CAAC,EAAE,CAAA;IACN,CAAC,CAAA;IAED,MAAM,KAAK,GACT,MAAM,KAAK,QAAQ;QACjB,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,MAAM,KAAK,QAAQ;YACnB,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,QAAQ,CAAA;IAEhB,OAAO,CACL,8BACE,KAAC,MAAM,OACD,WAAW,EACf,UAAU,EAAE,UAAU,EACtB,MAAM,EACJ,MAAM,KAAK,QAAQ;oBACjB,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,MAAM,KAAK,QAAQ;wBACnB,CAAC,CAAC,QAAQ;wBACV,CAAC,CAAC,MAAM,EAEd,OAAO,EAAE,WAAW,YAEnB,KAAK,GACC,EACT,KAAC,cAAc,IAAC,IAAI,EAAC,QAAQ,YAC1B,MAAM,KAAK,QAAQ;oBAClB,CAAC,CAAC,0BAA0B;oBAC5B,CAAC,CAAC,MAAM,KAAK,QAAQ;wBACnB,CAAC,CAAC,8DAA8D;wBAChE,CAAC,CAAC,EAAE,GACO,IAChB,CACJ,CAAA;AACH,CAAC,CAAA"}

package/dist/CopyButton/copyText.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Put a string on the clipboard, and say whether it landed.
+ *
+ * Three routes, tried in order, because the fleet runs in all three
+ * conditions:
+ *
+ *  1. **`navigator.clipboard.writeText`.** The real API. It exists
+ *     only in a *secure context*, which a `devshare` URL and
+ *     `localhost` both are — and a plain `http://storeman.octen:8080`
+ *     dev server is not.
+ *  2. **A hidden `<textarea>` plus `document.execCommand("copy")`.**
+ *     Deprecated, and kept anyway: it is the only thing that works in
+ *     an insecure context, spoolbuddy already hand-rolls exactly this
+ *     block, and the alternative is a Copy button that silently does
+ *     nothing on the household's own LAN.
+ *  3. **Give up and report it.** A caller that marks mail done on a
+ *     copy must not mark it done on a copy that never happened.
+ *
+ * Never throws. The boolean is the whole result, so a call site is an
+ * `if` rather than a `try`.
+ */
+export declare const copyText: (value: string) => Promise<boolean>;
+//# sourceMappingURL=copyText.d.ts.map

package/dist/CopyButton/copyText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copyText.d.ts","sourceRoot":"","sources":["../../src/CopyButton/copyText.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,QAAQ,GACnB,OAAO,MAAM,KACZ,OAAO,CAAC,OAAO,CAWjB,CAAA"}

package/dist/CopyButton/copyText.js

@@ -0,0 +1,65 @@
+/**
+ * Put a string on the clipboard, and say whether it landed.
+ *
+ * Three routes, tried in order, because the fleet runs in all three
+ * conditions:
+ *
+ *  1. **`navigator.clipboard.writeText`.** The real API. It exists
+ *     only in a *secure context*, which a `devshare` URL and
+ *     `localhost` both are — and a plain `http://storeman.octen:8080`
+ *     dev server is not.
+ *  2. **A hidden `<textarea>` plus `document.execCommand("copy")`.**
+ *     Deprecated, and kept anyway: it is the only thing that works in
+ *     an insecure context, spoolbuddy already hand-rolls exactly this
+ *     block, and the alternative is a Copy button that silently does
+ *     nothing on the household's own LAN.
+ *  3. **Give up and report it.** A caller that marks mail done on a
+ *     copy must not mark it done on a copy that never happened.
+ *
+ * Never throws. The boolean is the whole result, so a call site is an
+ * `if` rather than a `try`.
+ */
+export const copyText = async (value) => {
+    try {
+        // `writeText` rejects on a denied permission and on a document
+        // that is not focused — both real, both recoverable below.
+        await globalThis.navigator?.clipboard?.writeText(value);
+        return true;
+    }
+    catch {
+        // Fall through to the legacy route.
+    }
+    return copyBySelection(value);
+};
+/**
+ * The pre-Clipboard-API route.
+ *
+ * The textarea is positioned off-screen rather than hidden: a
+ * `display: none` element has no selection to copy, and
+ * `visibility: hidden` is no better. `readOnly` stops the mobile
+ * keyboard appearing for the frame it is in the document.
+ */
+const copyBySelection = (value) => {
+    const owner = globalThis.document;
+    if (!owner?.body)
+        return false;
+    const field = owner.createElement("textarea");
+    field.value = value;
+    field.readOnly = true;
+    field.setAttribute("aria-hidden", "true");
+    field.style.position = "fixed";
+    field.style.insetInlineStart = "-9999px";
+    field.style.top = "0";
+    owner.body.append(field);
+    try {
+        field.select();
+        return owner.execCommand("copy");
+    }
+    catch {
+        return false;
+    }
+    finally {
+        field.remove();
+    }
+};
+//# sourceMappingURL=copyText.js.map