@eifi1/ui-kit 0.33.1 → 0.35.0

package/dist/components/chip-input.d.ts

@@ -0,0 +1,69 @@
+import type { ComponentPropsWithoutRef, ReactNode, Ref } from "react";
+import { type LabelOverride } from "../i18n/kit-labels.js";
+import { DEFAULT_CHIP_INPUT_LABELS } from "./chip-labels.js";
+import { type ChipSize, type ChipTone } from "./chip.js";
+export interface ChipInputLabels {
+    /** Announced after a value is added. Receives the value. */
+    added: (value: string) => string;
+    /** Announced after a value is removed. Receives the value. */
+    removed: (value: string) => string;
+    /** Accessible name for each chip's dismiss button. */
+    remove: string;
+    /** Shown when `max` is reached. Receives the limit. */
+    atLimit: (max: number) => string;
+    /** Shown when a duplicate is rejected. Receives the value. */
+    duplicate: (value: string) => string;
+}
+export { DEFAULT_CHIP_INPUT_LABELS };
+/**
+ * `onChange` is the field's own — the whole LIST, not a DOM event — so the wrapper
+ * div's `onChange` is omitted rather than shadowed. `placeholder` is likewise this
+ * component's, forwarded to the inner `<input>`; the div has none of its own.
+ */
+export interface ChipInputProps extends Omit<ComponentPropsWithoutRef<"div">, "onChange" | "placeholder" | "children"> {
+    value: string[];
+    onChange: (next: string[]) => void;
+    placeholder?: string;
+    /** Visible label, rendered above the field: a ReactNode, as on every kit field (a
+     *  string until 0.34, refactor audit 2026-10, API-9). Without one, name the field with
+     *  `aria-label`. */
+    label?: ReactNode;
+    /** Reject or rewrite a value on commit. Return a string to reject WITH that message. */
+    validate?: (raw: string) => string | null;
+    /** Characters that commit the current text, besides Enter. Default: comma. */
+    separators?: string[];
+    allowDuplicates?: boolean;
+    max?: number;
+    tone?: ChipTone;
+    size?: ChipSize;
+    disabled?: boolean;
+    invalid?: boolean;
+    /** Error text. Wires `aria-describedby` and implies `invalid`. */
+    error?: ReactNode;
+    labels?: LabelOverride<ChipInputLabels>;
+    className?: string;
+    /** The `<input>` the next value is typed into — the element that takes focus, which
+     *  react-hook-form's focus-on-error calls `focus()` on (API-3, refactor audit 2026-10).
+     *  Not the wrapper, which takes the rest of the props. */
+    ref?: Ref<HTMLInputElement>;
+}
+/**
+ * A field whose value is a LIST, entered as chips.
+ *
+ * The keyboard model is the whole component; the pills are the easy part. Per the WAI
+ * pattern for a "tag" input:
+ *
+ *   Enter, or any separator  commit the typed text
+ *   Backspace on empty text  move focus to the last chip (does NOT delete it)
+ *   ← →  while on a chip     move between chips, in reading order (mirrored in RTL)
+ *   Backspace / Delete       remove the focused chip, focus its neighbour
+ *   Escape                   clear what is typed but keep the committed chips
+ *   paste                    splits on the separators, so a pasted CSV becomes chips
+ *
+ * The Backspace-on-empty behaviour is the one worth arguing about. Deleting immediately
+ * is more common and is a trap: it is a destructive action with no feedback on a key
+ * people hit by reflex, and the value it destroys may have taken a while to type. Moving
+ * focus first makes the second Backspace a deliberate one, and it is what lets a
+ * keyboard user reach a chip at all.
+ */
+export declare function ChipInput({ value, onChange, placeholder, label, validate, separators, allowDuplicates, max, tone, size, disabled, invalid, error, labels, className, "aria-label": ariaLabelAttr, ref, ...rest }: ChipInputProps): import("react").JSX.Element;

package/dist/components/chip-input.js

@@ -0,0 +1,220 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useId, useMemo, useRef, useState } from "react";
+import { cn } from "../lib/cn.js";
+import { horizontalStep } from "../lib/direction.js";
+import { isImeEnter } from "../lib/ime.js";
+import { claimEscape } from "../hooks/use-dismiss.js";
+import { FIELD_INVALID, FIELD_TOUCH_TEXT } from "./field-base.js";
+import { FIELD_ERROR_CLASS, mergeRefs } from "./field-parts.js";
+import { useKitLabels, useKitLocale } from "../i18n/kit-labels.js";
+import { DEFAULT_CHIP_INPUT_LABELS } from "./chip-labels.js";
+import { Chip } from "./chip.js";
+function ChipInput({
+  value,
+  onChange,
+  placeholder,
+  label,
+  validate,
+  separators = [","],
+  allowDuplicates = false,
+  max,
+  tone = "neutral",
+  size = "md",
+  disabled = false,
+  invalid = false,
+  error,
+  labels,
+  className,
+  "aria-label": ariaLabelAttr,
+  ref,
+  ...rest
+}) {
+  const text = useKitLabels("chipInput", DEFAULT_CHIP_INPUT_LABELS, labels);
+  const locale = useKitLocale();
+  const [draft, setDraft] = useState("");
+  const [message, setMessage] = useState("");
+  const [rejected, setRejected] = useState(null);
+  const [focusedChip, setFocusedChip] = useState(null);
+  const inputRef = useRef(null);
+  const setInput = useMemo(() => mergeRefs(inputRef, ref), [ref]);
+  const chipRefs = useRef([]);
+  const id = useId();
+  const listId = `${id}-list`;
+  const errorId = `${id}-error`;
+  const rejectedId = `${id}-rejected`;
+  const isInvalid = invalid || !!error;
+  const describedBy = [error ? errorId : null, rejected ? rejectedId : null].filter(Boolean).join(" ");
+  const focusChip = (index) => {
+    setFocusedChip(index);
+    if (index === null) inputRef.current?.focus();
+    else chipRefs.current[index]?.focus();
+  };
+  const commitMany = (raws) => {
+    const next = [...value];
+    const added = [];
+    let rejection = null;
+    for (const raw of raws) {
+      const candidate = raw.trim();
+      if (!candidate) continue;
+      if (max !== void 0 && next.length >= max) {
+        rejection ??= text.atLimit(max);
+        break;
+      }
+      if (!allowDuplicates && next.includes(candidate)) {
+        rejection ??= text.duplicate(candidate);
+        continue;
+      }
+      const invalidReason = validate?.(candidate);
+      if (invalidReason) {
+        rejection ??= invalidReason;
+        continue;
+      }
+      next.push(candidate);
+      added.push(candidate);
+    }
+    if (added.length) onChange(next);
+    const addedList = new Intl.ListFormat(locale, { type: "conjunction", style: "long" });
+    setMessage(rejection ?? (added.length ? text.added(addedList.format(added)) : ""));
+    setRejected(rejection);
+    return { added, rejection };
+  };
+  const commit = (raw) => commitMany([raw]).added.length > 0;
+  const removeAt = (index) => {
+    const removed = value[index];
+    onChange(value.filter((_, i) => i !== index));
+    setMessage(text.removed(removed));
+    setRejected(null);
+    const next = index >= value.length - 1 ? null : index;
+    requestAnimationFrame(() => focusChip(value.length - 1 === 0 ? null : next));
+  };
+  const onInputKeyDown = (e) => {
+    if (e.key === "Enter") {
+      if (isImeEnter(e)) return;
+      if (draft.trim()) {
+        e.preventDefault();
+        if (commit(draft)) setDraft("");
+      }
+      return;
+    }
+    if (separators.includes(e.key)) {
+      e.preventDefault();
+      if (commit(draft)) setDraft("");
+      return;
+    }
+    if (e.key === "Escape" && draft) {
+      claimEscape(e);
+      setDraft("");
+      return;
+    }
+    if (e.key === "Backspace" && !draft && value.length) {
+      e.preventDefault();
+      focusChip(value.length - 1);
+    }
+  };
+  const onChipKeyDown = (e, index) => {
+    if (e.key === "Backspace" || e.key === "Delete") {
+      e.preventDefault();
+      removeAt(index);
+      return;
+    }
+    const step = horizontalStep(e.key, e.currentTarget);
+    if (step === -1 && index > 0) {
+      e.preventDefault();
+      focusChip(index - 1);
+      return;
+    }
+    if (step === 1) {
+      e.preventDefault();
+      focusChip(index === value.length - 1 ? null : index + 1);
+      return;
+    }
+    if (e.key === "Escape") {
+      claimEscape(e);
+      focusChip(null);
+    }
+  };
+  return (
+    // The rest lands on the OUTER box — the thing a `data-tour` step or a test id
+    // wants to point at — while the accessible name below goes on the `<input>`,
+    // because that is what a screen-reader user actually lands in. Spreading the two
+    // to the same element would have named a decorative wrapper and left the field
+    // anonymous.
+    /* @__PURE__ */ jsxs("div", { ...rest, className: cn("space-y-1", className), children: [
+      label && /* @__PURE__ */ jsx("label", { htmlFor: `${id}-input`, className: "block text-sm text-secondary", children: label }),
+      /* @__PURE__ */ jsxs(
+        "div",
+        {
+          className: cn(
+            "relative flex flex-wrap items-center gap-1.5 rounded-md border border-subtle bg-surface px-2 py-1.5 shadow-sm",
+            "focus-within:border-brand focus-within:ring-1 focus-within:ring-brand",
+            disabled && "cursor-default bg-surface-2",
+            isInvalid && FIELD_INVALID
+          ),
+          onClick: () => !disabled && inputRef.current?.focus(),
+          children: [
+            /* @__PURE__ */ jsx("ul", { id: listId, role: "list", className: "contents", children: value.map((v, i) => /* @__PURE__ */ jsx("li", { role: "presentation", className: "contents", children: /* @__PURE__ */ jsx(
+              Chip,
+              {
+                ref: (el) => {
+                  chipRefs.current[i] = el;
+                },
+                tone,
+                size,
+                disabled,
+                removeLabel: text.remove,
+                onRemove: disabled ? void 0 : () => removeAt(i),
+                tabIndex: focusedChip === i ? 0 : -1,
+                role: "listitem",
+                "aria-label": v,
+                onKeyDown: (e) => onChipKeyDown(e, i),
+                onFocus: () => setFocusedChip(i),
+                "data-chip-index": i,
+                children: v
+              }
+            ) }, `${v}-${i}`)) }),
+            /* @__PURE__ */ jsx(
+              "input",
+              {
+                id: `${id}-input`,
+                ref: setInput,
+                value: draft,
+                onChange: (e) => {
+                  setDraft(e.target.value);
+                  setMessage("");
+                  setRejected(null);
+                },
+                onKeyDown: onInputKeyDown,
+                onBlur: () => {
+                  if (draft.trim() && commit(draft)) setDraft("");
+                },
+                onPaste: (e) => {
+                  const pasted = e.clipboardData.getData("text");
+                  const pattern = new RegExp(`[${separators.map((s) => `\\${s}`).join("")}
+\r]`);
+                  if (!pattern.test(pasted)) return;
+                  e.preventDefault();
+                  if (commitMany(pasted.split(pattern)).added.length) setDraft("");
+                },
+                placeholder: value.length ? void 0 : placeholder,
+                disabled,
+                "aria-label": label ? void 0 : ariaLabelAttr,
+                "aria-describedby": describedBy || void 0,
+                "aria-invalid": isInvalid || !!rejected || void 0,
+                className: cn("w-0 min-w-[6rem] flex-1 bg-transparent py-0.5 text-sm text-primary outline-none placeholder:text-placeholder disabled:cursor-default", FIELD_TOUCH_TEXT)
+              }
+            ),
+            /* @__PURE__ */ jsx("span", { role: "status", "aria-live": "polite", "aria-atomic": true, className: "sr-only-fixed", children: message })
+          ]
+        }
+      ),
+      error && /* @__PURE__ */ jsx("p", { id: errorId, className: cn(FIELD_ERROR_CLASS, "mt-0"), children: error }),
+      rejected && /* @__PURE__ */ jsx("p", { id: rejectedId, className: cn(FIELD_ERROR_CLASS, "mt-0"), "data-chip-input-rejected": "", children: rejected })
+    ] })
+  );
+}
+export {
+  ChipInput,
+  DEFAULT_CHIP_INPUT_LABELS
+};
+//# sourceMappingURL=chip-input.js.map

package/dist/components/chip-input.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/chip-input.tsx"],"sourcesContent":["// A field whose value is a list, entered as chips. Moved out of chip.tsx as it was\n// (MOD-9, refactor audit 2026-10). It renders `Chip`, so chip.tsx re-exports only its\n// TYPES: re-exporting `ChipInput` itself would make chip ⇄ chip-input a runtime cycle\n// (check:graph, import-x/no-cycle). The barrel exports this module.\nimport { useId, useMemo, useRef, useState } from \"react\";\nimport type { ComponentPropsWithoutRef, KeyboardEvent, ReactNode, Ref } from \"react\";\nimport { cn } from \"../lib/cn\";\nimport { horizontalStep } from \"../lib/direction\";\nimport { isImeEnter } from \"../lib/ime\";\nimport { claimEscape } from \"../hooks/use-dismiss\";\nimport { FIELD_INVALID, FIELD_TOUCH_TEXT } from \"./field-base\";\nimport { FIELD_ERROR_CLASS, mergeRefs } from \"./field-parts\";\nimport { useKitLabels, useKitLocale, type LabelOverride } from \"../i18n/kit-labels\";\nimport { DEFAULT_CHIP_INPUT_LABELS } from \"./chip-labels\";\nimport { Chip, type ChipSize, type ChipTone } from \"./chip\";\n\n/* ── ChipInput ────────────────────────────────────────────────────────────── */\n\nexport interface ChipInputLabels {\n  /** Announced after a value is added. Receives the value. */\n  added: (value: string) => string;\n  /** Announced after a value is removed. Receives the value. */\n  removed: (value: string) => string;\n  /** Accessible name for each chip's dismiss button. */\n  remove: string;\n  /** Shown when `max` is reached. Receives the limit. */\n  atLimit: (max: number) => string;\n  /** Shown when a duplicate is rejected. Receives the value. */\n  duplicate: (value: string) => string;\n}\n\n// Defined in ./chip-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_CHIP_INPUT_LABELS };\n\n/**\n * `onChange` is the field's own — the whole LIST, not a DOM event — so the wrapper\n * div's `onChange` is omitted rather than shadowed. `placeholder` is likewise this\n * component's, forwarded to the inner `<input>`; the div has none of its own.\n */\nexport interface ChipInputProps\n  extends Omit<ComponentPropsWithoutRef<\"div\">, \"onChange\" | \"placeholder\" | \"children\"> {\n  value: string[];\n  onChange: (next: string[]) => void;\n  placeholder?: string;\n  /** Visible label, rendered above the field: a ReactNode, as on every kit field (a\n   *  string until 0.34, refactor audit 2026-10, API-9). Without one, name the field with\n   *  `aria-label`. */\n  label?: ReactNode;\n  /** Reject or rewrite a value on commit. Return a string to reject WITH that message. */\n  validate?: (raw: string) => string | null;\n  /** Characters that commit the current text, besides Enter. Default: comma. */\n  separators?: string[];\n  allowDuplicates?: boolean;\n  max?: number;\n  tone?: ChipTone;\n  size?: ChipSize;\n  disabled?: boolean;\n  invalid?: boolean;\n  /** Error text. Wires `aria-describedby` and implies `invalid`. */\n  error?: ReactNode;\n  labels?: LabelOverride<ChipInputLabels>;\n  className?: string;\n  /** The `<input>` the next value is typed into — the element that takes focus, which\n   *  react-hook-form's focus-on-error calls `focus()` on (API-3, refactor audit 2026-10).\n   *  Not the wrapper, which takes the rest of the props. */\n  ref?: Ref<HTMLInputElement>;\n}\n\n/**\n * A field whose value is a LIST, entered as chips.\n *\n * The keyboard model is the whole component; the pills are the easy part. Per the WAI\n * pattern for a \"tag\" input:\n *\n *   Enter, or any separator  commit the typed text\n *   Backspace on empty text  move focus to the last chip (does NOT delete it)\n *   ← →  while on a chip     move between chips, in reading order (mirrored in RTL)\n *   Backspace / Delete       remove the focused chip, focus its neighbour\n *   Escape                   clear what is typed but keep the committed chips\n *   paste                    splits on the separators, so a pasted CSV becomes chips\n *\n * The Backspace-on-empty behaviour is the one worth arguing about. Deleting immediately\n * is more common and is a trap: it is a destructive action with no feedback on a key\n * people hit by reflex, and the value it destroys may have taken a while to type. Moving\n * focus first makes the second Backspace a deliberate one, and it is what lets a\n * keyboard user reach a chip at all.\n */\nexport function ChipInput({\n  value,\n  onChange,\n  placeholder,\n  label,\n  validate,\n  separators = [\",\"],\n  allowDuplicates = false,\n  max,\n  tone = \"neutral\",\n  size = \"md\",\n  disabled = false,\n  invalid = false,\n  error,\n  labels,\n  className,\n  \"aria-label\": ariaLabelAttr,\n  ref,\n  ...rest\n}: ChipInputProps) {\n  // `labels` over the provider's `chipInput` over English.\n  const text = useKitLabels(\"chipInput\", DEFAULT_CHIP_INPUT_LABELS, labels);\n  // A batch of pasted values is announced as one list, joined the way the language\n  // joins a list in a sentence (\"a, b and c added\") — hence the long conjunction,\n  // where a trigger's summary would use the narrow one.\n  const locale = useKitLocale();\n  const [draft, setDraft] = useState(\"\");\n  const [message, setMessage] = useState(\"\");\n  // The last refusal, shown under the field until the next edit. The live region alone\n  // told only a screen-reader user why Enter did nothing; everyone else saw the text\n  // simply stay put.\n  const [rejected, setRejected] = useState<string | null>(null);\n  const [focusedChip, setFocusedChip] = useState<number | null>(null);\n  const inputRef = useRef<HTMLInputElement>(null);\n  // The field's own handle on its input (focus after a chip goes) and the caller's `ref`.\n  const setInput = useMemo(() => mergeRefs(inputRef, ref), [ref]);\n  const chipRefs = useRef<Array<HTMLElement | null>>([]);\n  const id = useId();\n  const listId = `${id}-list`;\n  const errorId = `${id}-error`;\n  const rejectedId = `${id}-rejected`;\n  const isInvalid = invalid || !!error;\n  const describedBy = [error ? errorId : null, rejected ? rejectedId : null]\n    .filter(Boolean)\n    .join(\" \");\n\n  const focusChip = (index: number | null) => {\n    setFocusedChip(index);\n    if (index === null) inputRef.current?.focus();\n    else chipRefs.current[index]?.focus();\n  };\n\n  /**\n   * Try to add every candidate, as ONE change.\n   *\n   * Batched rather than looped for a reason that bites immediately: `commit` closes over\n   * `value`, so calling it once per pasted item makes every call compute its result from\n   * the list as it was BEFORE the paste, and each `onChange` overwrites the last. A\n   * pasted \"one,two,three\" left only \"three\". Accumulating locally and emitting once is\n   * also the correct behaviour for an undo stack — a paste is one action.\n   */\n  const commitMany = (raws: string[]): { added: string[]; rejection: string | null } => {\n    const next = [...value];\n    const added: string[] = [];\n    let rejection: string | null = null;\n\n    for (const raw of raws) {\n      const candidate = raw.trim();\n      if (!candidate) continue;\n      if (max !== undefined && next.length >= max) {\n        rejection ??= text.atLimit(max);\n        break;\n      }\n      if (!allowDuplicates && next.includes(candidate)) {\n        rejection ??= text.duplicate(candidate);\n        continue;\n      }\n      const invalidReason = validate?.(candidate);\n      if (invalidReason) {\n        rejection ??= invalidReason;\n        continue;\n      }\n      next.push(candidate);\n      added.push(candidate);\n    }\n\n    if (added.length) onChange(next);\n    // A rejection is the more useful thing to say: \"three added\" is obvious from the\n    // chips appearing, whereas \"already in the list\" is the only sign of what did not.\n    const addedList = new Intl.ListFormat(locale, { type: \"conjunction\", style: \"long\" });\n    setMessage(rejection ?? (added.length ? text.added(addedList.format(added)) : \"\"));\n    setRejected(rejection);\n    return { added, rejection };\n  };\n\n  const commit = (raw: string): boolean => commitMany([raw]).added.length > 0;\n\n  const removeAt = (index: number) => {\n    const removed = value[index];\n    onChange(value.filter((_, i) => i !== index));\n    setMessage(text.removed(removed));\n    setRejected(null);\n    // Focus the neighbour that takes its place, or the input when the list empties —\n    // dropping focus to <body> here is how a keyboard user loses the field entirely.\n    const next = index >= value.length - 1 ? null : index;\n    requestAnimationFrame(() => focusChip(value.length - 1 === 0 ? null : next));\n  };\n\n  const onInputKeyDown = (e: KeyboardEvent<HTMLInputElement>) => {\n    if (e.key === \"Enter\") {\n      // The Enter that confirms an IME composition is the IME's: it commits no chip\n      // and submits no form (BUG-9).\n      if (isImeEnter(e)) return;\n      // Only when there is something to commit: an empty Enter belongs to the form.\n      if (draft.trim()) {\n        e.preventDefault();\n        if (commit(draft)) setDraft(\"\");\n      }\n      return;\n    }\n    if (separators.includes(e.key)) {\n      e.preventDefault();\n      if (commit(draft)) setDraft(\"\");\n      return;\n    }\n    // Clearing the draft is this field's Escape, not a dialog's around it: claimed, so\n    // the dialog stays — the same in a Modal and a FullBleedDialog, which read it\n    // differently until 0.34 (Wave 2, DUP-1). With nothing typed the key goes on.\n    if (e.key === \"Escape\" && draft) {\n      claimEscape(e);\n      setDraft(\"\");\n      return;\n    }\n    if (e.key === \"Backspace\" && !draft && value.length) {\n      e.preventDefault();\n      focusChip(value.length - 1);\n    }\n  };\n\n  const onChipKeyDown = (e: KeyboardEvent<HTMLElement>, index: number) => {\n    if (e.key === \"Backspace\" || e.key === \"Delete\") {\n      e.preventDefault();\n      removeAt(index);\n      return;\n    }\n    // ←/→ follow the reading direction, not DOM order: in RTL the previous chip is to\n    // the RIGHT, and ArrowLeft moves on towards the input.\n    const step = horizontalStep(e.key, e.currentTarget);\n    if (step === -1 && index > 0) {\n      e.preventDefault();\n      focusChip(index - 1);\n      return;\n    }\n    if (step === 1) {\n      e.preventDefault();\n      focusChip(index === value.length - 1 ? null : index + 1);\n      return;\n    }\n    // Back to the input, a step inside the field: claimed like the draft's (DUP-1).\n    if (e.key === \"Escape\") {\n      claimEscape(e);\n      focusChip(null);\n    }\n  };\n\n  return (\n    // The rest lands on the OUTER box — the thing a `data-tour` step or a test id\n    // wants to point at — while the accessible name below goes on the `<input>`,\n    // because that is what a screen-reader user actually lands in. Spreading the two\n    // to the same element would have named a decorative wrapper and left the field\n    // anonymous.\n    <div {...rest} className={cn(\"space-y-1\", className)}>\n      {label && (\n        <label htmlFor={`${id}-input`} className=\"block text-sm text-secondary\">\n          {label}\n        </label>\n      )}\n      {/* eslint-disable-next-line jsx-a11y/click-events-have-key-events, jsx-a11y/no-static-element-interactions -- a\n          pointer convenience that widens the input's hit area to the whole field; the\n          keyboard path is the <input> itself, which is in the tab order. */}\n      <div\n        // `relative` so the live region below can be `sr-only` without escaping to the\n        // initial containing block and inflating the document height.\n        className={cn(\n          \"relative flex flex-wrap items-center gap-1.5 rounded-md border border-subtle bg-surface px-2 py-1.5 shadow-sm\",\n          \"focus-within:border-brand focus-within:ring-1 focus-within:ring-brand\",\n          disabled && \"cursor-default bg-surface-2\",\n          isInvalid && FIELD_INVALID,\n        )}\n        onClick={() => !disabled && inputRef.current?.focus()}\n      >\n        {/* `display: contents` on the wrappers so the chips participate in the field's\n            own flex wrap rather than forming a nested row. The list semantics are\n            restored with explicit roles, because `contents` removes the ul/li boxes from\n            the accessibility tree in several engines. */}\n        {/* eslint-disable-next-line jsx-a11y/no-redundant-roles -- NOT redundant here: the\n            `contents` display below removes the ul and li boxes from the box tree, and\n            several engines drop the list semantics with them. The explicit role is what\n            puts \"list, 3 items\" back. */}\n        <ul id={listId} role=\"list\" className=\"contents\">\n          {value.map((v, i) => (\n            <li key={`${v}-${i}`} role=\"presentation\" className=\"contents\">\n              <Chip\n                ref={(el: HTMLElement | null) => {\n                  chipRefs.current[i] = el;\n                }}\n                tone={tone}\n                size={size}\n                disabled={disabled}\n                removeLabel={text.remove}\n                onRemove={disabled ? undefined : () => removeAt(i)}\n                // A ROVING tabIndex: only the focused chip is tabbable, so Tab leaves\n                // the field instead of walking through every value in it — the reason a\n                // list of twenty tags is otherwise a twenty-stop detour for a keyboard.\n                tabIndex={focusedChip === i ? 0 : -1}\n                role=\"listitem\"\n                aria-label={v}\n                onKeyDown={(e) => onChipKeyDown(e, i)}\n                onFocus={() => setFocusedChip(i)}\n                data-chip-index={i}\n              >\n                {v}\n              </Chip>\n            </li>\n          ))}\n        </ul>\n        <input\n          id={`${id}-input`}\n          ref={setInput}\n          value={draft}\n          onChange={(e) => {\n            setDraft(e.target.value);\n            setMessage(\"\");\n            setRejected(null);\n          }}\n          onKeyDown={onInputKeyDown}\n          onBlur={() => {\n            // Commit on blur: a value typed and then clicked away from is a value the\n            // user meant to add, and losing it silently is the commonest complaint\n            // about this pattern.\n            if (draft.trim() && commit(draft)) setDraft(\"\");\n          }}\n          onPaste={(e) => {\n            const pasted = e.clipboardData.getData(\"text\");\n            const pattern = new RegExp(`[${separators.map((s) => `\\\\${s}`).join(\"\")}\\n\\r]`);\n            if (!pattern.test(pasted)) return;\n            e.preventDefault();\n            if (commitMany(pasted.split(pattern)).added.length) setDraft(\"\");\n          }}\n          placeholder={value.length ? undefined : placeholder}\n          disabled={disabled}\n          // A visible `label` is already wired through `htmlFor`, so adding a name\n          // here would give the field two.\n          aria-label={label ? undefined : ariaLabelAttr}\n          aria-describedby={describedBy || undefined}\n          aria-invalid={isInvalid || !!rejected || undefined}\n          // `w-0` with flex-1: without a width the browser's default input size (20\n          // characters) became the field's minimum width and pushed it past a 240 px\n          // phone at 150 % (0.32's screenshot run).\n          className={cn(\"w-0 min-w-[6rem] flex-1 bg-transparent py-0.5 text-sm text-primary outline-none placeholder:text-placeholder disabled:cursor-default\", FIELD_TOUCH_TEXT)}\n        />\n        {/* Additions, removals and rejections move no focus, so nothing would announce\n            them. `sr-only-fixed` rather than `sr-only`: this sits inside a consumer's\n            markup and must not extend the document height. */}\n        <span role=\"status\" aria-live=\"polite\" aria-atomic className=\"sr-only-fixed\">\n          {message}\n        </span>\n      </div>\n      {/* Every field's error type (DUP-8: these were `text-xs`); the root's `space-y-1`\n          spaces them, so not the class's own `mt-1` as well. */}\n      {error && (\n        <p id={errorId} className={cn(FIELD_ERROR_CLASS, \"mt-0\")}>\n          {error}\n        </p>\n      )}\n      {rejected && (\n        <p id={rejectedId} className={cn(FIELD_ERROR_CLASS, \"mt-0\")} data-chip-input-rejected=\"\">\n          {rejected}\n        </p>\n      )}\n    </div>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/components/chip-labels.d.ts

@@ -0,0 +1,2 @@
+import type { ChipInputLabels } from "./chip.js";
+export declare const DEFAULT_CHIP_INPUT_LABELS: ChipInputLabels;

package/dist/components/chip-labels.js

@@ -0,0 +1,12 @@
+"use client";
+const DEFAULT_CHIP_INPUT_LABELS = {
+  added: (v) => `${v} added`,
+  removed: (v) => `${v} removed`,
+  remove: "Remove",
+  atLimit: (max) => `Limit of ${max} reached`,
+  duplicate: (v) => `${v} is already in the list`
+};
+export {
+  DEFAULT_CHIP_INPUT_LABELS
+};
+//# sourceMappingURL=chip-labels.js.map

package/dist/components/chip-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/chip-labels.ts"],"sourcesContent":["// The English words of ./chip, in a module with no component code: the English catalogue\n// (src/i18n/defaults.ts) imports them without the component, so `en` loads as one chunk\n// like the other languages (0.34, KS U8). ./chip-input re-exports them.\n\nimport type { ChipInputLabels } from \"./chip\";\n\nexport const DEFAULT_CHIP_INPUT_LABELS: ChipInputLabels = {\n  added: (v) => `${v} added`,\n  removed: (v) => `${v} removed`,\n  remove: \"Remove\",\n  atLimit: (max) => `Limit of ${max} reached`,\n  duplicate: (v) => `${v} is already in the list`,\n};\n"],"mappings":";AAMO,MAAM,4BAA6C;AAAA,EACxD,OAAO,CAAC,MAAM,GAAG,CAAC;AAAA,EAClB,SAAS,CAAC,MAAM,GAAG,CAAC;AAAA,EACpB,QAAQ;AAAA,EACR,SAAS,CAAC,QAAQ,YAAY,GAAG;AAAA,EACjC,WAAW,CAAC,MAAM,GAAG,CAAC;AACxB;","names":[]}

package/dist/components/chip.d.ts

@@ -1,12 +1,9 @@
-import * as react from 'react';
-import { ReactNode, ReactElement, KeyboardEvent, Ref, MouseEvent, ComponentPropsWithoutRef } from 'react';
-import { LucideIcon } from 'lucide-react';
-import { DisabledReasonDisplay } from './field-parts.js';
-import { CommitScope } from './write-lock.js';
-import './tooltip.js';
-import '../hooks/use-anchored-rect.js';
-import '../lib/clipping.js';
-
+import type { KeyboardEvent, MouseEvent, ReactElement, ReactNode, Ref } from "react";
+import type { LucideIcon } from "lucide-react";
+import { type DisabledReasonDisplay } from "./field-parts.js";
+import { type CommitScope } from "./write-lock.js";
+export { refreshChipEdges } from "../lib/chip-edge-snap.js";
+export type { ChipInputLabels, ChipInputProps } from "./chip-input.js";
 /**
  * A chip: a compact pill carrying one value.
  *
@@ -21,7 +18,7 @@ import '../lib/clipping.js';
  * "choose one of eight things to do" and a row of eight chips says "here are eight
  * things". Using `Button` for both is the mistake this exists to prevent.
  */
-type ChipTone = "neutral" | "brand" | "danger" | "warning" | "success" | "info" | "income" | "expense" | ChipHue;
+export type ChipTone = "neutral" | "brand" | "danger" | "warning" | "success" | "info" | "income" | "expense" | ChipHue;
 /**
  * Categorical hues (0.10.0): colour that says "a different value" and nothing more —
  * kastlan's status-badge.tsx paints ~15 enums in 9 Tailwind hues by hand. Four of those
@@ -31,11 +28,11 @@ type ChipTone = "neutral" | "brand" | "danger" | "warning" | "success" | "info"
  * meaning (overdue is `danger`), a hue when it only needs telling apart (sent vs
  * accepted vs invoiced).
  */
-type ChipHue = "blue" | "indigo" | "purple" | "teal" | "orange";
+export type ChipHue = "blue" | "indigo" | "purple" | "teal" | "orange";
 /** `lg` is the 44px touch target (`min-h-11`) a phone surface wants; `md` is ~28px.
  *  `xs` (0.10.0) is 11px type at `px-1.5` — keksdose's goal markers and budget-cell
  *  badges, which sit inside a figure's line and must not make it taller. */
-type ChipSize = "xs" | "sm" | "md" | "lg";
+export type ChipSize = "xs" | "sm" | "md" | "lg";
 /**
  * How much of the tone the chip wears.
  *
@@ -51,14 +48,14 @@ type ChipSize = "xs" | "sm" | "md" | "lg";
  *   would outshout the figures beside them (kastlan's unit picker already draws its
  *   UnitStatus this way, from a separate `dotColor` map).
  */
-type ChipVariant = "soft" | "outline" | "solid" | "dot";
+export type ChipVariant = "soft" | "outline" | "solid" | "dot";
 /** `pill` (default) is fully rounded; `square` has the small radius of a field or a
  *  button — for a chip that sits in a table cell or beside square controls. */
-type ChipShape = "pill" | "square";
+export type ChipShape = "pill" | "square";
 /** What {@link ChipProps.renderLink} is handed: everything the chip would have put on
  *  its own `<a>`. Spread it onto your router's link, mapping `href` to what the link
  *  calls it — `renderLink={({ href, ...p }) => <Link to={href} {...p} />}`. */
-interface ChipLinkProps {
+export interface ChipLinkProps {
     href: string;
     /** The chip's whole look — keep it, or the pill is a bare link. */
     className: string;
@@ -79,13 +76,6 @@ interface ChipLinkProps {
     [key: `aria-${string}`]: string | boolean | number | undefined;
     [key: `data-${string}`]: unknown;
 }
-/**
- * Re-snap every chip rendered with `snapEdges`, now. The kit already re-snaps when a
- * chip renders, resizes, or the window or the ratio changes; call this after moving
- * chips some other way (a side panel sliding in beside a table of status chips),
- * since a move is not something an observer can see.
- */
-declare function refreshChipEdges(): void;
 interface ChipBaseProps {
     children: ReactNode;
     tone?: ChipTone;
@@ -105,7 +95,7 @@ interface ChipBaseProps {
     caps?: boolean;
     /**
      * The leading glyph: a lucide component (`icon={Check}`, drawn at the chip's size), or
-     * — since 0.15.4 — a ready element (`icon={<Check className="text-[var(--success)]" />}`)
+     * — since 0.15.4 — a ready element (`icon={<Check className="text-success" />}`)
      * for a glyph whose colour or stroke carries a state; it is sized to the same box
      * (keksdose live #358 built that slot by hand inside `children`).
      */
@@ -185,6 +175,9 @@ interface ChipBaseProps {
      * nothing to snap.
      */
     snapEdges?: boolean;
+    /** The interactive element — the pill, or a split pill's body. A React 19 ref prop
+     *  since 0.34 (MOD-4, refactor audit 2026-10); it was `forwardRef`. */
+    ref?: Ref<HTMLElement>;
 }
 /**
  * A chip is a link OR a button, never both — so the types say so. Before 0.7.0 both were
@@ -194,7 +187,7 @@ interface ChipBaseProps {
  * That shape wants a definite `href` string, so a bare `onClick` is always the
  * button's, with a button's event.
  */
-type ChipProps = ChipBaseProps & ({
+export type ChipProps = ChipBaseProps & ({
     /** Renders the chip as a link. */
     href?: string;
     onClick?: never;
@@ -271,72 +264,4 @@ type ChipProps = ChipBaseProps & ({
  * focus ring is drawn on the body alone, and `ref`, `id` and the ARIA props still reach
  * the body — the interactive element.
  */
-declare const Chip: react.ForwardRefExoticComponent<ChipProps & react.RefAttributes<HTMLElement>>;
-interface ChipInputLabels {
-    /** Announced after a value is added. Receives the value. */
-    added: (value: string) => string;
-    /** Announced after a value is removed. Receives the value. */
-    removed: (value: string) => string;
-    /** Accessible name for each chip's dismiss button. */
-    remove: string;
-    /** Shown when `max` is reached. Receives the limit. */
-    atLimit: (max: number) => string;
-    /** Shown when a duplicate is rejected. Receives the value. */
-    duplicate: (value: string) => string;
-}
-declare const DEFAULT_CHIP_INPUT_LABELS: ChipInputLabels;
-declare function resolveChipInputLabels(labels?: Partial<ChipInputLabels>): ChipInputLabels;
-/**
- * `onChange` is the field's own — the whole LIST, not a DOM event — so the wrapper
- * div's `onChange` is omitted rather than shadowed. `placeholder` is likewise this
- * component's, forwarded to the inner `<input>`; the div has none of its own.
- */
-interface ChipInputProps extends Omit<ComponentPropsWithoutRef<"div">, "onChange" | "placeholder" | "children"> {
-    value: string[];
-    onChange: (next: string[]) => void;
-    placeholder?: string;
-    /** Visible label, rendered above the field. Without one, name the field with
-     *  `aria-label`. */
-    label?: string;
-    /**
-     * @deprecated Pass `aria-label` instead — the DOM spelling the rest of this kit
-     * now uses. Still honoured, and still second to `aria-label` when both are given.
-     */
-    ariaLabel?: string;
-    /** Reject or rewrite a value on commit. Return a string to reject WITH that message. */
-    validate?: (raw: string) => string | null;
-    /** Characters that commit the current text, besides Enter. Default: comma. */
-    separators?: string[];
-    allowDuplicates?: boolean;
-    max?: number;
-    tone?: ChipTone;
-    size?: ChipSize;
-    disabled?: boolean;
-    invalid?: boolean;
-    /** Error text. Wires `aria-describedby` and implies `invalid`. */
-    error?: ReactNode;
-    labels?: Partial<ChipInputLabels>;
-    className?: string;
-}
-/**
- * A field whose value is a LIST, entered as chips.
- *
- * The keyboard model is the whole component; the pills are the easy part. Per the WAI
- * pattern for a "tag" input:
- *
- *   Enter, or any separator  commit the typed text
- *   Backspace on empty text  move focus to the last chip (does NOT delete it)
- *   ← →  while on a chip     move between chips, in reading order (mirrored in RTL)
- *   Backspace / Delete       remove the focused chip, focus its neighbour
- *   Escape                   clear what is typed but keep the committed chips
- *   paste                    splits on the separators, so a pasted CSV becomes chips
- *
- * The Backspace-on-empty behaviour is the one worth arguing about. Deleting immediately
- * is more common and is a trap: it is a destructive action with no feedback on a key
- * people hit by reflex, and the value it destroys may have taken a while to type. Moving
- * focus first makes the second Backspace a deliberate one, and it is what lets a
- * keyboard user reach a chip at all.
- */
-declare function ChipInput({ value, onChange, placeholder, label, ariaLabel, validate, separators, allowDuplicates, max, tone, size, disabled, invalid, error, labels, className, "aria-label": ariaLabelAttr, ...rest }: ChipInputProps): react.JSX.Element;
-
-export { Chip, type ChipHue, ChipInput, type ChipInputLabels, type ChipInputProps, type ChipLinkProps, type ChipProps, type ChipShape, type ChipSize, type ChipTone, type ChipVariant, DEFAULT_CHIP_INPUT_LABELS, refreshChipEdges, resolveChipInputLabels };
+export declare function Chip({ ref, children, tone, size, variant, shape, caps, icon: Icon, selected, checkbox, href, renderLink, onClick, onRemove, removeLabel, removeDisabled, disabled, className, tabIndex, role, onKeyDown, onFocus, snapEdges, disabledReason: ownDisabledReason, disabledReasonDisplay, commit, ...rest }: ChipProps): import("react").JSX.Element;