@charcuterie/ui 3.0.0 → 3.2.0

package/dist/MarkdownEditor/markdownSpans.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Markdown → coloured spans, with **every character kept**.
+ *
+ * This is the half of the live-hybrid editor that decides what a
+ * line looks like, and its one hard requirement is not a parsing
+ * requirement at all — it is a geometry one.
+ *
+ * ### The concatenation invariant
+ *
+ * The editing surface is a real `<textarea>` with a painted layer
+ * behind it, sharing one grid cell. The textarea owns the caret,
+ * the selection, the undo stack and the IME; the layer owns the
+ * colour. That only works while the two layers **wrap identically**,
+ * and they only wrap identically while they contain the *same
+ * characters in the same order*.
+ *
+ * So `toMarkdownLines(text)` is not a parser in the usual sense. It
+ * never drops a marker, never normalises whitespace, never resolves
+ * a reference, and never emits a node the source did not contain.
+ * Joining every span's text back together, with `\n` between lines,
+ * reproduces the input byte for byte — `markdownSpans.test.ts`
+ * asserts exactly that over a fixture corpus, and it is the test
+ * that stops a well-meaning "let's trim the trailing space"
+ * from silently shearing the caret away from the glyphs.
+ *
+ * ### It emits kinds, not HTML
+ *
+ * The return value is a list of `{ kind, text }` pairs. There is no
+ * HTML string anywhere in this module, no `innerHTML`, and no
+ * sanitiser — because there is nothing to sanitise. Docket's whole
+ * reason to exist is that HTML-in-the-field destroyed a previous
+ * tool's data, and the cheapest possible guarantee against that is
+ * a pipeline in which HTML is never *constructed*. React renders
+ * these spans as text nodes; a `<script>` in the source is a
+ * `<script>` on screen.
+ *
+ * ### Why it is line-based, and what that costs
+ *
+ * A CommonMark parser resolves lazy continuation, setext headings,
+ * link reference definitions and nested block containers across the
+ * whole document. This resolves one line at a time, carrying
+ * exactly one bit of cross-line state: whether we are inside a
+ * fenced code block.
+ *
+ * That is a deliberate trade. Painting is per-line and re-runs on
+ * every keystroke, so the cost has to be linear in the line, not in
+ * the document; and a mis-coloured marker is a cosmetic defect
+ * while a mis-*placed* one is a broken editor. The known gaps are
+ * written down in `MarkdownEditor.mdx` rather than hidden: setext
+ * headings, indented (four-space) code blocks, reference links, and
+ * emphasis that spans a line break all colour as plain text. They
+ * still **store** correctly, because the stored value is the
+ * textarea's, not this module's.
+ */
+export type MarkdownSpanKind = "code" | "emphasis" | "heading" | "link" | "marker" | "plain" | "strikethrough" | "strong" | "url";
+export type MarkdownSpan = {
+    kind: MarkdownSpanKind;
+    text: string;
+};
+export type MarkdownLineKind = "blockquote" | "code" | "heading" | "list" | "paragraph" | "table" | "thematicBreak";
+export type MarkdownLine = {
+    kind: MarkdownLineKind;
+    spans: MarkdownSpan[];
+};
+/**
+ * The inline scanner.
+ *
+ * `baseKind` is what unmarked text becomes — `"plain"` in a
+ * paragraph, `"heading"` inside a heading — so a heading's words
+ * carry the heading colour while the `##` in front of them stays a
+ * marker.
+ */
+export declare const toInlineSpans: (text: string, baseKind?: MarkdownSpanKind) => MarkdownSpan[];
+/**
+ * The whole document, one entry per line.
+ *
+ * `text.split("\n")` on an empty string yields `[""]` — one empty
+ * line — which is right: an empty editor still has a line for the
+ * caret to sit on, and the painted layer still needs a row so the
+ * two layers agree about where line 0 is.
+ */
+export declare const toMarkdownLines: (text: string) => MarkdownLine[];
+/**
+ * Which line the caret is on, from a character offset.
+ *
+ * The active line is the one construct in this editor that is
+ * *state* rather than syntax: its markers paint at full strength
+ * and every other line's fade back, which is the whole "raw syntax
+ * on the cursor's line" behaviour.
+ */
+export declare const toLineIndex: (text: string, offset: number) => number;
+//# sourceMappingURL=markdownSpans.d.ts.map

package/dist/MarkdownEditor/markdownSpans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownSpans.d.ts","sourceRoot":"","sources":["../../src/MarkdownEditor/markdownSpans.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,UAAU,GACV,SAAS,GACT,MAAM,GACN,QAAQ,GACR,OAAO,GACP,eAAe,GACf,QAAQ,GACR,KAAK,CAAA;AAET,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,gBAAgB,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,MAAM,GACN,SAAS,GACT,MAAM,GACN,WAAW,GACX,OAAO,GACP,eAAe,CAAA;AAEnB,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,gBAAgB,CAAA;IACtB,KAAK,EAAE,YAAY,EAAE,CAAA;CACtB,CAAA;AA2ED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GACxB,MAAM,MAAM,EACZ,WAAU,gBAA0B,KACnC,YAAY,EAkId,CAAA;AAkGD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,MAAM,KACX,YAAY,EAyBd,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,MAAM,EACZ,QAAQ,MAAM,KACb,MAYF,CAAA"}

package/dist/MarkdownEditor/markdownSpans.js

@@ -0,0 +1,303 @@
+/**
+ * Markdown → coloured spans, with **every character kept**.
+ *
+ * This is the half of the live-hybrid editor that decides what a
+ * line looks like, and its one hard requirement is not a parsing
+ * requirement at all — it is a geometry one.
+ *
+ * ### The concatenation invariant
+ *
+ * The editing surface is a real `<textarea>` with a painted layer
+ * behind it, sharing one grid cell. The textarea owns the caret,
+ * the selection, the undo stack and the IME; the layer owns the
+ * colour. That only works while the two layers **wrap identically**,
+ * and they only wrap identically while they contain the *same
+ * characters in the same order*.
+ *
+ * So `toMarkdownLines(text)` is not a parser in the usual sense. It
+ * never drops a marker, never normalises whitespace, never resolves
+ * a reference, and never emits a node the source did not contain.
+ * Joining every span's text back together, with `\n` between lines,
+ * reproduces the input byte for byte — `markdownSpans.test.ts`
+ * asserts exactly that over a fixture corpus, and it is the test
+ * that stops a well-meaning "let's trim the trailing space"
+ * from silently shearing the caret away from the glyphs.
+ *
+ * ### It emits kinds, not HTML
+ *
+ * The return value is a list of `{ kind, text }` pairs. There is no
+ * HTML string anywhere in this module, no `innerHTML`, and no
+ * sanitiser — because there is nothing to sanitise. Docket's whole
+ * reason to exist is that HTML-in-the-field destroyed a previous
+ * tool's data, and the cheapest possible guarantee against that is
+ * a pipeline in which HTML is never *constructed*. React renders
+ * these spans as text nodes; a `<script>` in the source is a
+ * `<script>` on screen.
+ *
+ * ### Why it is line-based, and what that costs
+ *
+ * A CommonMark parser resolves lazy continuation, setext headings,
+ * link reference definitions and nested block containers across the
+ * whole document. This resolves one line at a time, carrying
+ * exactly one bit of cross-line state: whether we are inside a
+ * fenced code block.
+ *
+ * That is a deliberate trade. Painting is per-line and re-runs on
+ * every keystroke, so the cost has to be linear in the line, not in
+ * the document; and a mis-coloured marker is a cosmetic defect
+ * while a mis-*placed* one is a broken editor. The known gaps are
+ * written down in `MarkdownEditor.mdx` rather than hidden: setext
+ * headings, indented (four-space) code blocks, reference links, and
+ * emphasis that spans a line break all colour as plain text. They
+ * still **store** correctly, because the stored value is the
+ * textarea's, not this module's.
+ */
+/**
+ * A fence opens or closes on any line whose first non-space run is
+ * three or more backticks or tildes. Up to three leading spaces,
+ * per CommonMark; a fourth would be an indented code block, which
+ * this module deliberately does not track.
+ */
+const FENCE_PATTERN = /^ {0,3}(?:```|~~~)/;
+const INDENT_PATTERN = /^[ \t]*/;
+const BLOCKQUOTE_PATTERN = /^(?:>[ \t]?)+/;
+const THEMATIC_BREAK_PATTERN = /^(?:\*[ \t]*){3,}$|^(?:-[ \t]*){3,}$|^(?:_[ \t]*){3,}$/;
+const HEADING_PATTERN = /^#{1,6}[ \t]+/;
+const LIST_MARKER_PATTERN = /^(?:[-*+]|\d{1,9}[.)])[ \t]+/;
+const TASK_MARKER_PATTERN = /^\[[ xX]\][ \t]*/;
+/**
+ * Sticky, because every one of these is tried at a known index
+ * rather than searched for. A non-sticky `exec` would happily match
+ * an emphasis pair fifty characters further down the line and the
+ * scanner would swallow everything in between.
+ *
+ * Order is the whole grammar here, and two orderings are
+ * load-bearing:
+ *
+ *  - **Escape first.** `\*not emphasis\*` has to lose to the
+ *    backslash, or the editor colours text the renderer will not.
+ *  - **Code before everything.** A code span suppresses every other
+ *    construct inside it, which is what makes `` `**` `` render as
+ *    two asterisks rather than an unterminated bold run.
+ *  - **Image before link**, because `![alt](url)` starts with a
+ *    valid link at index 1.
+ *  - **Strong before emphasis**, because `**` starts with `*`.
+ */
+const INLINE_PATTERNS = {
+    code: /(`+)([^\n]*?)\1/y,
+    emphasis: /([*_])(?=[^\s*_])([^\n*_]*?[^\s*_])\1/y,
+    escape: /\\([\\`*_{}[\]()#+\-.!>~|])/y,
+    image: /(!\[)([^\]\n]*)(\]\()([^)\s\n]*)(\))/y,
+    link: /(\[)([^\]\n]*)(\]\()([^)\s\n]*)(\))/y,
+    strikethrough: /(~~)(?=\S)([^\n]*?\S)\1/y,
+    strong: /(\*\*|__)(?=\S)([^\n]*?\S)\1/y,
+};
+const pushSpan = (spans, kind, text) => {
+    if (text === "") {
+        return;
+    }
+    const previous = spans.at(-1);
+    // Merged as they are pushed rather than in a second pass. The
+    // scanner emits one span per plain *character*, so without this a
+    // 200-character paragraph is 200 React elements and every
+    // keystroke reconciles all of them.
+    if (previous?.kind === kind) {
+        previous.text += text;
+        return;
+    }
+    spans.push({ kind, text });
+};
+/**
+ * The inline scanner.
+ *
+ * `baseKind` is what unmarked text becomes — `"plain"` in a
+ * paragraph, `"heading"` inside a heading — so a heading's words
+ * carry the heading colour while the `##` in front of them stays a
+ * marker.
+ */
+export const toInlineSpans = (text, baseKind = "plain") => {
+    const spans = [];
+    let index = 0;
+    while (index < text.length) {
+        INLINE_PATTERNS.escape.lastIndex = index;
+        const escaped = INLINE_PATTERNS.escape.exec(text);
+        if (escaped) {
+            pushSpan(spans, "marker", "\\");
+            pushSpan(spans, baseKind, escaped[1] ?? "");
+            index += escaped[0].length;
+            continue;
+        }
+        INLINE_PATTERNS.code.lastIndex = index;
+        const code = INLINE_PATTERNS.code.exec(text);
+        if (code) {
+            pushSpan(spans, "marker", code[1] ?? "");
+            pushSpan(spans, "code", code[2] ?? "");
+            pushSpan(spans, "marker", code[1] ?? "");
+            index += code[0].length;
+            continue;
+        }
+        INLINE_PATTERNS.image.lastIndex = index;
+        const image = INLINE_PATTERNS.image.exec(text);
+        if (image) {
+            pushSpan(spans, "marker", image[1] ?? "");
+            pushSpan(spans, "link", image[2] ?? "");
+            pushSpan(spans, "marker", image[3] ?? "");
+            pushSpan(spans, "url", image[4] ?? "");
+            pushSpan(spans, "marker", image[5] ?? "");
+            index += image[0].length;
+            continue;
+        }
+        INLINE_PATTERNS.link.lastIndex = index;
+        const link = INLINE_PATTERNS.link.exec(text);
+        if (link) {
+            pushSpan(spans, "marker", link[1] ?? "");
+            pushSpan(spans, "link", link[2] ?? "");
+            pushSpan(spans, "marker", link[3] ?? "");
+            pushSpan(spans, "url", link[4] ?? "");
+            pushSpan(spans, "marker", link[5] ?? "");
+            index += link[0].length;
+            continue;
+        }
+        INLINE_PATTERNS.strong.lastIndex = index;
+        const strong = INLINE_PATTERNS.strong.exec(text);
+        if (strong) {
+            pushSpan(spans, "marker", strong[1] ?? "");
+            pushSpan(spans, "strong", strong[2] ?? "");
+            pushSpan(spans, "marker", strong[1] ?? "");
+            index += strong[0].length;
+            continue;
+        }
+        INLINE_PATTERNS.strikethrough.lastIndex = index;
+        const struck = INLINE_PATTERNS.strikethrough.exec(text);
+        if (struck) {
+            pushSpan(spans, "marker", struck[1] ?? "");
+            pushSpan(spans, "strikethrough", struck[2] ?? "");
+            pushSpan(spans, "marker", struck[1] ?? "");
+            index += struck[0].length;
+            continue;
+        }
+        INLINE_PATTERNS.emphasis.lastIndex = index;
+        const emphasised = INLINE_PATTERNS.emphasis.exec(text);
+        if (emphasised) {
+            pushSpan(spans, "marker", emphasised[1] ?? "");
+            pushSpan(spans, "emphasis", emphasised[2] ?? "");
+            pushSpan(spans, "marker", emphasised[1] ?? "");
+            index += emphasised[0].length;
+            continue;
+        }
+        pushSpan(spans, baseKind, text[index] ?? "");
+        index += 1;
+    }
+    return spans;
+};
+const toTableSpans = (text) => {
+    const spans = [];
+    for (const part of text.split(/(\|)/)) {
+        if (part === "|") {
+            pushSpan(spans, "marker", part);
+            continue;
+        }
+        for (const span of toInlineSpans(part)) {
+            pushSpan(spans, span.kind, span.text);
+        }
+    }
+    return spans;
+};
+const toBlockLine = (line) => {
+    const spans = [];
+    const indent = INDENT_PATTERN.exec(line)?.[0] ?? "";
+    pushSpan(spans, "plain", indent);
+    let rest = line.slice(indent.length);
+    const quote = BLOCKQUOTE_PATTERN.exec(rest)?.[0];
+    if (quote !== undefined) {
+        pushSpan(spans, "marker", quote);
+        rest = rest.slice(quote.length);
+    }
+    if (THEMATIC_BREAK_PATTERN.test(rest)) {
+        pushSpan(spans, "marker", rest);
+        return { kind: "thematicBreak", spans };
+    }
+    const heading = HEADING_PATTERN.exec(rest)?.[0];
+    if (heading !== undefined) {
+        pushSpan(spans, "marker", heading);
+        for (const span of toInlineSpans(rest.slice(heading.length), "heading")) {
+            pushSpan(spans, span.kind, span.text);
+        }
+        return { kind: "heading", spans };
+    }
+    const listMarker = LIST_MARKER_PATTERN.exec(rest)?.[0];
+    if (listMarker !== undefined) {
+        pushSpan(spans, "marker", listMarker);
+        rest = rest.slice(listMarker.length);
+        const taskMarker = TASK_MARKER_PATTERN.exec(rest)?.[0];
+        if (taskMarker !== undefined) {
+            pushSpan(spans, "marker", taskMarker);
+            rest = rest.slice(taskMarker.length);
+        }
+        for (const span of toInlineSpans(rest)) {
+            pushSpan(spans, span.kind, span.text);
+        }
+        return { kind: "list", spans };
+    }
+    if (rest.startsWith("|")) {
+        for (const span of toTableSpans(rest)) {
+            pushSpan(spans, span.kind, span.text);
+        }
+        return { kind: "table", spans };
+    }
+    for (const span of toInlineSpans(rest)) {
+        pushSpan(spans, span.kind, span.text);
+    }
+    return {
+        kind: quote === undefined ? "paragraph" : "blockquote",
+        spans,
+    };
+};
+/**
+ * The whole document, one entry per line.
+ *
+ * `text.split("\n")` on an empty string yields `[""]` — one empty
+ * line — which is right: an empty editor still has a line for the
+ * caret to sit on, and the painted layer still needs a row so the
+ * two layers agree about where line 0 is.
+ */
+export const toMarkdownLines = (text) => {
+    let isInsideFence = false;
+    return text.split("\n").map((line) => {
+        if (FENCE_PATTERN.test(line)) {
+            isInsideFence = !isInsideFence;
+            return {
+                kind: "code",
+                spans: [{ kind: "marker", text: line }],
+            };
+        }
+        if (isInsideFence) {
+            return {
+                kind: "code",
+                spans: line === ""
+                    ? []
+                    : [{ kind: "code", text: line }],
+            };
+        }
+        return toBlockLine(line);
+    });
+};
+/**
+ * Which line the caret is on, from a character offset.
+ *
+ * The active line is the one construct in this editor that is
+ * *state* rather than syntax: its markers paint at full strength
+ * and every other line's fade back, which is the whole "raw syntax
+ * on the cursor's line" behaviour.
+ */
+export const toLineIndex = (text, offset) => {
+    const clamped = Math.max(0, Math.min(offset, text.length));
+    let lineIndex = 0;
+    for (let index = 0; index < clamped; index += 1) {
+        if (text[index] === "\n") {
+            lineIndex += 1;
+        }
+    }
+    return lineIndex;
+};
+//# sourceMappingURL=markdownSpans.js.map

package/dist/MarkdownEditor/markdownSpans.js.map

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

package/dist/Modal/Modal.d.ts

@@ -1,9 +1,13 @@
-import type { ReactNode } from "react";
+import type { ReactNode, RefObject } from "react";
 export type ModalProps = {
     "aria-label"?: string;
     "aria-labelledby"?: string;
     children: ReactNode;
     className?: string;
+    /** Which element takes the caret when the modal opens. Without
+     * it the focus manager takes the first tabbable element — the
+     * Close button on anything with chrome. */
+    initialFocus?: RefObject<HTMLElement | null>;
     /** Escape and a backdrop press both close. */
     isDismissable?: boolean;
     isVisible: boolean;
@@ -14,5 +18,5 @@ export type ModalProps = {
     onClose: () => void;
     role?: "alertdialog" | "dialog";
 };
-export declare const Modal: ({ "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, children, className, isDismissable, isVisible, onClose, role, }: ModalProps) => ReactNode;
+export declare const Modal: ({ "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, children, className, initialFocus, isDismissable, isVisible, onClose, role, }: ModalProps) => ReactNode;
 //# sourceMappingURL=Modal.d.ts.map

package/dist/Modal/Modal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../src/Modal/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtC,MAAM,MAAM,UAAU,GAAG;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,EAAE,SAAS,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,SAAS,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,IAAI,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAA;CAChC,CAAA;AAqCD,eAAO,MAAM,KAAK,GAAI,+HASnB,UAAU,KAAG,SAYf,CAAA"}
+{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../src/Modal/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKjD,MAAM,MAAM,UAAU,GAAG;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,EAAE,SAAS,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;+CAE2C;IAC3C,YAAY,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IAC5C,8CAA8C;IAC9C,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,SAAS,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,IAAI,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAA;CAChC,CAAA;AAqCD,eAAO,MAAM,KAAK,GAAI,6IAUnB,UAAU,KAAG,SAaf,CAAA"}

package/dist/Modal/Modal.js

@@ -34,5 +34,5 @@ import { toClassName } from "../toClassName.js";
  * and dismiss top-first.
  */
 const MODAL_BOX_CLASS = "flex max-h-[85dvh] flex-col overflow-hidden rounded-lg border border-border-default bg-surface-overlay text-content-primary shadow-high";
-export const Modal = ({ "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, children, className, isDismissable = true, isVisible, onClose, role = "dialog", }) => (_jsx(OverlayPanel, { "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, className: toClassName(MODAL_BOX_CLASS, className), isDismissable: isDismissable, isVisible: isVisible, onClose: onClose, role: role, children: children }));
+export const Modal = ({ "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, children, className, initialFocus, isDismissable = true, isVisible, onClose, role = "dialog", }) => (_jsx(OverlayPanel, { "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, className: toClassName(MODAL_BOX_CLASS, className), initialFocus: initialFocus, isDismissable: isDismissable, isVisible: isVisible, onClose: onClose, role: role, children: children }));
 //# sourceMappingURL=Modal.js.map

package/dist/Modal/Modal.js.map

@@ -1 +1 @@
-{"version":3,"file":"Modal.js","sourceRoot":"","sources":["../../src/Modal/Modal.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA6B,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAkB/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,eAAe,GACnB,yIAAyI,CAAA;AAE3I,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EACpB,YAAY,EAAE,SAAS,EACvB,iBAAiB,EAAE,cAAc,EACjC,QAAQ,EACR,SAAS,EACT,aAAa,GAAG,IAAI,EACpB,SAAS,EACT,OAAO,EACP,IAAI,GAAG,QAAQ,GACJ,EAAa,EAAE,CAAC,CAC3B,KAAC,YAAY,kBACC,SAAS,qBACJ,cAAc,EAC/B,SAAS,EAAE,WAAW,CAAC,eAAe,EAAE,SAAS,CAAC,EAClD,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,IAAI,YAET,QAAQ,GACI,CAChB,CAAA"}
+{"version":3,"file":"Modal.js","sourceRoot":"","sources":["../../src/Modal/Modal.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA6B,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAsB/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,eAAe,GACnB,yIAAyI,CAAA;AAE3I,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EACpB,YAAY,EAAE,SAAS,EACvB,iBAAiB,EAAE,cAAc,EACjC,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,aAAa,GAAG,IAAI,EACpB,SAAS,EACT,OAAO,EACP,IAAI,GAAG,QAAQ,GACJ,EAAa,EAAE,CAAC,CAC3B,KAAC,YAAY,kBACC,SAAS,qBACJ,cAAc,EAC/B,SAAS,EAAE,WAAW,CAAC,eAAe,EAAE,SAAS,CAAC,EAClD,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,IAAI,YAET,QAAQ,GACI,CAChB,CAAA"}

package/dist/Overlay/OverlayPanel.d.ts

@@ -1,4 +1,4 @@
-import type { ReactNode } from "react";
+import type { ReactNode, RefObject } from "react";
 /**
  * The portalled, backdrop-backed, focus-trapping panel that `Modal`
  * renders. No chrome — that is `Dialog`'s job — only the four things
@@ -40,11 +40,22 @@ export type OverlayPanelProps = {
     "aria-labelledby"?: string;
     children: ReactNode;
     className?: string;
+    /**
+     * Which element takes the caret when the panel opens.
+     *
+     * Without it the focus manager takes the first tabbable element,
+     * which for anything with chrome is the **Close button** — so a
+     * panel wrapping a form opens with the caret on "Close" and the
+     * first thing typed goes nowhere. A consumer cannot fix that from
+     * outside: focusing in its own effect races the manager, and the
+     * manager wins, which reads as the app ignoring you.
+     */
+    initialFocus?: RefObject<HTMLElement | null>;
     /** Escape and an outside press both close. */
     isDismissable?: boolean;
     isVisible: boolean;
     onClose: () => void;
     role?: "alertdialog" | "dialog";
 };
-export declare const OverlayPanel: ({ "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, children, className, isDismissable, isVisible, onClose, role, }: OverlayPanelProps) => ReactNode;
+export declare const OverlayPanel: ({ "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, children, className, initialFocus, isDismissable, isVisible, onClose, role, }: OverlayPanelProps) => ReactNode;
 //# sourceMappingURL=OverlayPanel.d.ts.map

package/dist/Overlay/OverlayPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OverlayPanel.d.ts","sourceRoot":"","sources":["../../src/Overlay/OverlayPanel.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAOtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,EAAE,SAAS,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,IAAI,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAA;CAChC,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,+HAS1B,iBAAiB,KAAG,SAsHtB,CAAA"}
+{"version":3,"file":"OverlayPanel.d.ts","sourceRoot":"","sources":["../../src/Overlay/OverlayPanel.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAOjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,EAAE,SAAS,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IAC5C,8CAA8C;IAC9C,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,IAAI,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAA;CAChC,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,6IAU1B,iBAAiB,KAAG,SA0HtB,CAAA"}

package/dist/Overlay/OverlayPanel.js

@@ -5,7 +5,7 @@ import { useCallback, useEffect } from "react";
 import { lockScrollBehind } from "./lockScrollBehind.js";
 import { useOverlayStack } from "./OverlayStack.js";
 import { SharedBackdrop } from "./SharedBackdrop.js";
-export const OverlayPanel = ({ "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, children, className, isDismissable = true, isVisible, onClose, role = "dialog", }) => {
+export const OverlayPanel = ({ "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, children, className, initialFocus, isDismissable = true, isVisible, onClose, role = "dialog", }) => {
     const stack = useOverlayStack();
     const id = useUniqueId();
     // A stable close, so registering it does not churn the stack as the
@@ -59,6 +59,10 @@ export const OverlayPanel = ({ "aria-label": ariaLabel, "aria-labelledby": ariaL
         return null;
     }
     return (_jsxs(_Fragment, { children: [stack.isProvided ? null : (_jsx(SharedBackdrop, { isVisible: true })), _jsx(FloatingPortal, { children: _jsx("div", { className: "fixed inset-0 z-[var(--layer-modal)] flex items-center justify-center", children: _jsx(FloatingFocusManager, { context: context, 
+                        // `undefined` keeps the manager's own default (the first
+                        // tabbable), so nothing changes for a panel that does not
+                        // ask.
+                        initialFocus: initialFocus ?? undefined, 
                         // Only the top traps focus; a lower panel is `inert`
                         // anyway, and two live traps fight over one caret.
                         disabled: !isTop, modal: true, children: _jsx("div", { ...getFloatingProps(), "aria-label": ariaLabel,

package/dist/Overlay/OverlayPanel.js.map

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

package/dist/categoricalStyles.d.ts

@@ -0,0 +1,53 @@
+/**
+ * One categorical index → class map, the twin of
+ * `intentStyles.ts`.
+ *
+ * Its own file rather than ten more entries in that one, because
+ * the two families are keyed by different things and mean different
+ * things. `intentStyles.ts` opens by explaining that it exists to
+ * delete rip-deck's duplicated `TONE_CLASS` — a *status* map, where
+ * every key is a claim about state. Nothing here is a claim about
+ * anything: an index is a user's pick for a label, and the only
+ * thing a component may do with it is paint it. Keeping them apart
+ * is also what keeps `IntentName` an exhaustive union that
+ * `getAsyncIntent` can switch over.
+ *
+ * **Every class name is written out in full, and that is not
+ * negotiable.** Tailwind v4 scans source text for *complete* class
+ * strings, so `` `bg-categorical-${index}-solid` `` generates
+ * nothing at all — the badge renders unstyled with no error, no
+ * warning, and no failing test unless something checks. Something
+ * does: `tailwindCandidates.test.ts` compiles every literal in this
+ * package through the real Tailwind and fails on any candidate it
+ * cannot generate. Forty lines of near-duplication is the price,
+ * and the alternative is the `--color-danger-9` that shipped in
+ * Docket: a token name that had never existed, resolving to
+ * nothing, painting transparent, and passing every assertion about
+ * whether the element was rendered.
+ */
+import type { CategoricalIndex } from "@charcuterie/tokens";
+import type { IntentAppearance } from "./intentStyles.ts";
+export declare const CATEGORICAL_APPEARANCE_CLASS: Record<CategoricalIndex, Record<IntentAppearance, string>>;
+/**
+ * Hover, split out for exactly the reason `INTENT_HOVER_CLASS` is:
+ * most things wearing a colour are not interactive. A label pill in
+ * a task list that lightens under the cursor is telling the user it
+ * can be clicked, and a `Badge` cannot be. So an interactive
+ * component opts in, and a static one cannot accidentally opt in.
+ *
+ * `solid` hovers toward `solidHover`, which for this family is
+ * **brighter** rather than deeper — the fill carries a near-black
+ * label, so it moves away from it in the opposite direction to an
+ * intent's white-labelled fill.
+ */
+export declare const CATEGORICAL_HOVER_CLASS: Record<CategoricalIndex, Record<IntentAppearance, string>>;
+/**
+ * The fill on its own, for the parts of a component that are a dot
+ * or a bar rather than a box — the swatch beside a label in a
+ * picker, a series marker on a chart. Same values, no border and no
+ * hover, because neither of those is a surface anyone can point at.
+ */
+export declare const CATEGORICAL_SOLID_FILL_CLASS: Record<CategoricalIndex, string>;
+/** The same ten as text, for a glyph or a dot's ring. */
+export declare const CATEGORICAL_CONTENT_CLASS: Record<CategoricalIndex, string>;
+//# sourceMappingURL=categoricalStyles.d.ts.map

package/dist/categoricalStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categoricalStyles.d.ts","sourceRoot":"","sources":["../src/categoricalStyles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAC/C,gBAAgB,EAChB,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CA4FjC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAC1C,gBAAgB,EAChB,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CA8DjC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAC/C,gBAAgB,EAChB,MAAM,CAYP,CAAA;AAED,yDAAyD;AACzD,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAC5C,gBAAgB,EAChB,MAAM,CAYP,CAAA"}