@crisp-ui-kit/crisp 0.2.0 → 0.7.0

package/dist/esm/components/multiselect/multiselect.js

@@ -0,0 +1,125 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Check, ChevronDown, Search } from "lucide-react";
+import * as React from "react";
+import { multiselectRecipe } from "./multiselect.recipe.js";
+const TONES = [
+    "brand",
+    "success",
+    "warning",
+    "danger",
+    "purple",
+    "cyan",
+    "orange",
+];
+// deterministic pastel per value (a value keeps its colour), matching the table
+function toneFor(t) {
+    let h = 0;
+    for (let i = 0; i < t.length; i++)
+        h = (h * 31 + t.charCodeAt(i)) >>> 0;
+    return TONES[h % TONES.length];
+}
+function Chip({ opt }) {
+    return (_jsx("span", { className: "recordstable-tag", "data-tone": opt.tone ?? toneFor(opt.value), children: opt.label }));
+}
+/**
+ * A multi-select / tag editor — measured from Attio's cell tag picker. The
+ * outlined trigger shows the selected values as coloured chips; it opens a
+ * popover with a search field over rows of "[chip] … [checkbox]" that toggle on
+ * click (the menu stays open). Keyboard: ↑/↓ move, Enter toggles, Esc closes.
+ */
+export function MultiSelect({ options, value: valueProp, defaultValue, onValueChange, placeholder = "Select…", searchable = true, searchPlaceholder = "Search…", disabled, className, "aria-label": ariaLabel, ...rest }) {
+    const [open, setOpen] = React.useState(false);
+    const [up, setUp] = React.useState(false);
+    const [pos, setPos] = React.useState({});
+    const [query, setQuery] = React.useState("");
+    const [highlight, setHighlight] = React.useState(0);
+    const rootRef = React.useRef(null);
+    const triggerRef = React.useRef(null);
+    const searchRef = React.useRef(null);
+    const [internalValue, setInternalValue] = React.useState(defaultValue ?? []);
+    const value = valueProp ?? internalValue;
+    const selectedSet = React.useMemo(() => new Set(value), [value]);
+    const selectedOptions = options.filter((o) => selectedSet.has(o.value));
+    const q = query.trim().toLowerCase();
+    const filtered = searchable && q
+        ? options.filter((o) => o.label.toLowerCase().includes(q))
+        : options;
+    const openMenu = () => {
+        if (disabled)
+            return;
+        const rect = triggerRef.current?.getBoundingClientRect();
+        if (rect) {
+            const flipUp = window.innerHeight - rect.bottom < 300;
+            setUp(flipUp);
+            setPos({
+                left: rect.left,
+                minWidth: rect.width,
+                ...(flipUp
+                    ? { bottom: window.innerHeight - rect.top + 4 }
+                    : { top: rect.bottom + 4 }),
+            });
+        }
+        setQuery("");
+        setHighlight(0);
+        setOpen(true);
+        if (searchable)
+            requestAnimationFrame(() => searchRef.current?.focus({ preventScroll: true }));
+    };
+    const close = () => {
+        setOpen(false);
+        triggerRef.current?.focus({ preventScroll: true });
+    };
+    const toggle = (v) => {
+        const next = selectedSet.has(v)
+            ? value.filter((x) => x !== v)
+            : [...value, v];
+        if (valueProp === undefined)
+            setInternalValue(next);
+        onValueChange?.(next);
+    };
+    const onNavKeys = (e) => {
+        if (e.key === "ArrowDown") {
+            e.preventDefault();
+            setHighlight((h) => Math.min(h + 1, filtered.length - 1));
+        }
+        else if (e.key === "ArrowUp") {
+            e.preventDefault();
+            setHighlight((h) => Math.max(h - 1, 0));
+        }
+        else if (e.key === "Enter") {
+            e.preventDefault();
+            const opt = filtered[highlight];
+            if (opt)
+                toggle(opt.value);
+        }
+        else if (e.key === "Escape") {
+            e.preventDefault();
+            close();
+        }
+    };
+    React.useEffect(() => {
+        if (!open)
+            return;
+        const onDown = (e) => {
+            if (!rootRef.current?.contains(e.target))
+                setOpen(false);
+        };
+        document.addEventListener("pointerdown", onDown);
+        return () => document.removeEventListener("pointerdown", onDown);
+    }, [open]);
+    return (_jsxs("div", { ref: rootRef, className: multiselectRecipe({ className }), ...rest, children: [_jsxs("button", { ref: triggerRef, type: "button", "aria-haspopup": "listbox", "aria-expanded": open, "aria-label": ariaLabel, disabled: disabled, "data-open": open ? "" : undefined, className: "multiselect-trigger", onClick: () => (open ? setOpen(false) : openMenu()), onKeyDown: (e) => {
+                    if (open && !searchable)
+                        onNavKeys(e);
+                    else if (!open && (e.key === "ArrowDown" || e.key === "Enter")) {
+                        e.preventDefault();
+                        openMenu();
+                    }
+                }, children: [_jsx("span", { className: "multiselect-chips", children: selectedOptions.length === 0 ? (_jsx("span", { className: "multiselect-placeholder", children: placeholder })) : (selectedOptions.map((o) => _jsx(Chip, { opt: o }, o.value))) }), _jsx(ChevronDown, { className: "multiselect-chevron", size: 16, strokeWidth: 1.75 })] }), open && (_jsxs("div", { className: "multiselect-listbox", role: "listbox", "aria-multiselectable": "true", "aria-label": ariaLabel, "data-up": up ? "" : undefined, style: pos, children: [searchable && (_jsxs("div", { className: "multiselect-search", children: [_jsx(Search, { size: 15, strokeWidth: 1.75 }), _jsx("input", { ref: searchRef, type: "text", placeholder: searchPlaceholder, "aria-label": searchPlaceholder, value: query, onChange: (e) => {
+                                    setQuery(e.target.value);
+                                    setHighlight(0);
+                                }, onKeyDown: onNavKeys })] })), filtered.length === 0 ? (_jsx("div", { className: "multiselect-empty", children: "No results" })) : (filtered.map((opt, i) => {
+                        const sel = selectedSet.has(opt.value);
+                        return (_jsxs("button", { type: "button", role: "option", "aria-selected": sel, "data-highlighted": i === highlight ? "" : undefined, className: "multiselect-option", onClick: () => toggle(opt.value), onMouseEnter: () => setHighlight(i), children: [_jsx("span", { className: "multiselect-option-chip", children: _jsx(Chip, { opt: opt }) }), _jsx("span", { className: "multiselect-check", children: sel && _jsx(Check, { size: 12, strokeWidth: 3 }) })] }, opt.value));
+                    }))] }))] }));
+}
+MultiSelect.displayName = "MultiSelect";

package/dist/esm/components/multiselect/multiselect.recipe.js

@@ -0,0 +1,68 @@
+import { defineRecipe, resolveRecipe } from "../../core/index.js";
+import { contract as c, elevation as e } from "../../tokens/index.js";
+// A multi-select / tag editor — measured from Attio's cell tag picker: an
+// outlined trigger showing the selected values as coloured chips, opening a
+// popover with a search field over rows of "[coloured chip] … [checkbox]" that
+// toggle on click. The popover keeps these nested styles by rendering inside
+// this relative root.
+const config = defineRecipe({
+    name: "multiselect",
+    base: `
+    position: relative; display: inline-flex; width: 100%; font-family: ${c.font.sans};
+    -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale;
+
+    & .multiselect-trigger {
+      box-sizing: border-box; display: flex; align-items: center; gap: ${c.space["1"]}; width: 100%; min-width: 0; min-height: ${c.size.menuRow};
+      margin: 0; padding: ${c.space["0.5"]} ${c.space["1.5"]} ${c.space["0.5"]} ${c.space["2"]};
+      border: none; border-radius: ${c.radius.md}; background: transparent; box-shadow: inset 0 0 0 1px color-mix(in srgb, ${c.fgPrimary} 7%, transparent);
+      font-family: inherit; font-size: ${c.text.lg}; color: ${c.fgPrimary}; cursor: pointer; text-align: start;
+      transition: background-color .12s ease, box-shadow .12s ease;
+    }
+    & .multiselect-trigger:hover { background: ${c.bgRaised}; }
+    & .multiselect-trigger[data-open], & .multiselect-trigger:focus-visible { outline: none; box-shadow: inset 0 0 0 1px ${c.bgBrandSolid}; background: ${c.bgSurface}; }
+    & .multiselect-trigger:disabled { opacity: 0.5; cursor: not-allowed; }
+    & .multiselect-chips { flex: 1; min-width: 0; display: flex; flex-wrap: wrap; align-items: center; gap: ${c.space["1"]}; }
+    & .multiselect-placeholder { color: ${c.fgMuted}; }
+    & .multiselect-chevron { flex-shrink: 0; color: ${c.fgMuted}; transition: transform .15s ease; }
+    & .multiselect-trigger[data-open] .multiselect-chevron { transform: rotate(180deg); }
+
+    & .multiselect-listbox {
+      position: fixed; z-index: 60; box-sizing: border-box; display: flex; flex-direction: column; gap: ${c.space.px};
+      max-height: 300px; overflow-y: auto; padding: ${c.space["1"]};
+      border-radius: ${c.radius.xl}; background: ${c.bgPopover};
+      box-shadow: ${e.floating};
+      transform-origin: top left; opacity: 1; transform: none; transition: opacity .08s ease, transform .08s ease;
+    }
+    & .multiselect-listbox[data-up] { transform-origin: bottom left; }
+    & .multiselect-listbox { @starting-style { opacity: 0; transform: scale(0.97) translateY(-1px); } }
+    & .multiselect-search { display: flex; align-items: center; gap: ${c.space["2"]}; height: 34px; flex-shrink: 0; margin: calc(-1 * ${c.space["1"]}) calc(-1 * ${c.space["1"]}) ${c.space["1"]}; padding: 0 ${c.space["2.5"]}; border-bottom: 1px solid ${c.borderSubtle}; color: ${c.fgMuted}; }
+    & .multiselect-search svg { flex-shrink: 0; }
+    & .multiselect-search input { flex: 1; min-width: 0; border: none; outline: none; background: none; font-family: inherit; font-size: ${c.text.lg}; color: ${c.fgPrimary}; }
+    & .multiselect-search input::placeholder { color: ${c.fgMuted}; }
+    & .multiselect-option {
+      box-sizing: border-box; display: flex; align-items: center; gap: ${c.space["2"]}; height: ${c.size.menuRow}; flex-shrink: 0;
+      padding: 0 ${c.space["2"]}; margin: 0; border: none; background: none; border-radius: ${c.radius.md}; font-family: inherit; cursor: pointer; text-align: start;
+    }
+    & .multiselect-option[data-highlighted] { background: ${c.bgRaised}; }
+    & .multiselect-option-chip { flex: 0 1 auto; min-width: 0; overflow: hidden; }
+    & .multiselect-check { flex-shrink: 0; margin-inline-start: auto; display: inline-flex; align-items: center; justify-content: center; width: 16px; height: 16px; border-radius: ${c.radius.sm}; box-shadow: inset 0 0 0 1.5px ${c.borderDefault}; color: transparent; }
+    & .multiselect-option[aria-selected="true"] .multiselect-check { background: ${c.bgBrandSolid}; box-shadow: none; color: #fff; }
+    & .multiselect-empty { padding: ${c.space["3"]} ${c.space["2"]}; text-align: center; font-size: ${c.text.md}; color: ${c.fgMuted}; }
+
+    & .recordstable-tag { display: inline-flex; align-items: center; height: ${c.size.chip}; padding: 0 ${c.space["1"]}; border-radius: ${c.radius.chip}; font-size: ${c.text.lg}; line-height: 20px; font-weight: ${c.weight.medium}; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; background: color-mix(in srgb, ${c.fgPrimary} 6%, transparent); color: color-mix(in srgb, ${c.fgPrimary} 82%, transparent); }
+    & .recordstable-tag[data-tone="brand"] { background: color-mix(in srgb, ${c.bgBrandSolid} 14%, transparent); color: color-mix(in srgb, ${c.bgBrandSolid} 82%, ${c.fgPrimary}); }
+    & .recordstable-tag[data-tone="success"] { background: color-mix(in srgb, ${c.bgSuccess} 16%, transparent); color: color-mix(in srgb, ${c.bgSuccess} 78%, ${c.fgPrimary}); }
+    & .recordstable-tag[data-tone="warning"] { background: color-mix(in srgb, ${c.bgWarning} 18%, transparent); color: color-mix(in srgb, ${c.bgWarning} 82%, ${c.fgPrimary}); }
+    & .recordstable-tag[data-tone="danger"] { background: color-mix(in srgb, ${c.bgDanger} 15%, transparent); color: color-mix(in srgb, ${c.bgDanger} 80%, ${c.fgPrimary}); }
+    & .recordstable-tag[data-tone="purple"] { background: color-mix(in srgb, ${c.bgPurple} 16%, transparent); color: color-mix(in srgb, ${c.bgPurple} 80%, ${c.fgPrimary}); }
+    & .recordstable-tag[data-tone="cyan"] { background: color-mix(in srgb, ${c.bgCyan} 18%, transparent); color: color-mix(in srgb, ${c.bgCyan} 82%, ${c.fgPrimary}); }
+    & .recordstable-tag[data-tone="orange"] { background: color-mix(in srgb, ${c.bgOrange} 16%, transparent); color: color-mix(in srgb, ${c.bgOrange} 82%, ${c.fgPrimary}); }
+  `,
+    variants: {},
+    defaultVariants: {},
+    compoundVariants: [],
+});
+export const multiselectRecipe = Object.assign(resolveRecipe(config), {
+    config,
+});
+export default config;

package/dist/esm/components/popover/index.js

@@ -0,0 +1,2 @@
+export { Popover } from "./popover.js";
+export { popoverRecipe } from "./popover.recipe.js";

package/dist/esm/components/popover/popover.js

@@ -0,0 +1,70 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { popoverRecipe } from "./popover.recipe.js";
+/**
+ * A generic anchored popover — the Menu/Select surface holding arbitrary
+ * content. Opens below the trigger (flipping up when there's no room),
+ * closes on outside pointer-down and Escape. Controlled or self-managed.
+ */
+export function Popover({ trigger, children, align = "start", open: openProp, defaultOpen, onOpenChange, "aria-label": ariaLabel, className, }) {
+    const [internalOpen, setInternalOpen] = React.useState(defaultOpen ?? false);
+    const open = openProp ?? internalOpen;
+    const rootRef = React.useRef(null);
+    const triggerRef = React.useRef(null);
+    const [pos, setPos] = React.useState({});
+    const [up, setUp] = React.useState(false);
+    const setOpen = React.useCallback((next) => {
+        if (openProp === undefined)
+            setInternalOpen(next);
+        onOpenChange?.(next);
+    }, [openProp, onOpenChange]);
+    const place = () => {
+        const el = triggerRef.current;
+        if (!el)
+            return;
+        const rect = el.getBoundingClientRect();
+        const gap = 6;
+        const flipUp = window.innerHeight - rect.bottom < 280;
+        const style = flipUp
+            ? { bottom: window.innerHeight - rect.top + gap }
+            : { top: rect.bottom + gap };
+        if (align === "end")
+            style.right = window.innerWidth - rect.right;
+        else
+            style.left = rect.left;
+        setUp(flipUp);
+        setPos(style);
+    };
+    // Position when opening (before paint so it never flashes at 0,0).
+    // biome-ignore lint/correctness/useExhaustiveDependencies: reposition each time it opens
+    React.useLayoutEffect(() => {
+        if (open)
+            place();
+    }, [open]);
+    React.useEffect(() => {
+        if (!open)
+            return;
+        const onDown = (e) => {
+            if (!rootRef.current?.contains(e.target))
+                setOpen(false);
+        };
+        document.addEventListener("pointerdown", onDown);
+        return () => document.removeEventListener("pointerdown", onDown);
+    }, [open, setOpen]);
+    const triggerEl = React.cloneElement(trigger, {
+        ref: triggerRef,
+        "aria-haspopup": "dialog",
+        "aria-expanded": open,
+        onClick: (e) => {
+            trigger.props.onClick?.(e);
+            setOpen(!open);
+        },
+    });
+    return (_jsxs("div", { ref: rootRef, className: popoverRecipe({ className }), children: [triggerEl, open && (_jsx("div", { className: "popover-content", role: "dialog", "aria-label": ariaLabel, "data-align": align, "data-up": up ? "" : undefined, style: pos, onKeyDown: (e) => {
+                    if (e.key === "Escape") {
+                        e.preventDefault();
+                        setOpen(false);
+                    }
+                }, children: children }))] }));
+}
+Popover.displayName = "Popover";

package/dist/esm/components/popover/popover.recipe.js

@@ -0,0 +1,18 @@
+import { defineRecipe, resolveRecipe } from "../../core/index.js";
+import { contract as c, elevation as e } from "../../tokens/index.js";
+// A generic anchored popover — the same measured surface as Menu / Select
+// (radius 12, 4px padding, layered soft shadow, inset border), but holding
+// arbitrary content. Rendered inside a display:contents root and lifted out of
+// flow with position:fixed, so its styles survive while it floats.
+const config = defineRecipe({
+    name: "popover",
+    base: `display: contents; font-family: ${c.font.sans};
+    & .popover-content { position: fixed; z-index: 60; box-sizing: border-box; min-width: 200px; max-width: min(360px, 92vw); padding: ${c.space["1"]}; border-radius: ${c.radius.xl}; background: ${c.bgPopover}; color: ${c.fgPrimary}; box-shadow: ${e.floating}; opacity: 1; transform: none; transition: opacity 0.08s ease, transform 0.08s ease; transform-origin: top left; @starting-style { opacity: 0; transform: scale(0.97) translateY(-1px); } }
+    & .popover-content[data-align="end"] { transform-origin: top right; }
+    & .popover-content[data-up] { transform-origin: bottom left; }`,
+    variants: {},
+    defaultVariants: {},
+    compoundVariants: [],
+});
+export const popoverRecipe = resolveRecipe(config);
+export default config;

package/dist/esm/components/progress/index.js

@@ -0,0 +1,2 @@
+export { Progress } from "./progress.js";
+export { progressRecipe } from "./progress.recipe.js";

package/dist/esm/components/progress/progress.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { progressRecipe } from "./progress.recipe.js";
+/**
+ * A progress bar — a continuous brand fill, or a segmented row of pills when
+ * `segments` is set (the "Getting started 3/6" pattern). Reports its state via
+ * `role="progressbar"` and the ARIA value attributes.
+ */
+export function Progress({ value, max = 100, segments, "aria-label": ariaLabel, className, ...rest }) {
+    const pct = Math.max(0, Math.min(100, (value / max) * 100));
+    const aria = {
+        role: "progressbar",
+        "aria-valuenow": value,
+        "aria-valuemin": 0,
+        "aria-valuemax": max,
+        "aria-label": ariaLabel,
+    };
+    if (segments && segments > 0) {
+        const filled = Math.round((pct / 100) * segments);
+        return (_jsx("div", { ...aria, className: progressRecipe({ className }), ...rest, "data-segmented": "", children: Array.from({ length: segments }, (_, i) => (_jsx("span", { className: "progress-seg", "data-filled": i < filled ? "" : undefined }, i))) }));
+    }
+    return (_jsx("div", { ...aria, className: progressRecipe({ className }), ...rest, children: _jsx("span", { className: "progress-fill", style: { width: `${pct}%` } }) }));
+}
+Progress.displayName = "Progress";

package/dist/esm/components/progress/progress.recipe.js

@@ -0,0 +1,17 @@
+import { defineRecipe, resolveRecipe } from "../../core/index.js";
+import { contract as c } from "../../tokens/index.js";
+// A progress indicator — a continuous brand-filled track, or a segmented row of
+// pills (Attio's "Getting started 3/6" bar).
+const config = defineRecipe({
+    name: "progress",
+    base: `display: block; box-sizing: border-box; height: 6px; border-radius: ${c.radius.full}; background: color-mix(in srgb, ${c.fgPrimary} 8%, transparent); overflow: hidden;
+    & .progress-fill { display: block; height: 100%; border-radius: ${c.radius.full}; background: ${c.bgBrandSolid}; transition: width 0.25s ease; }
+    &[data-segmented] { display: flex; gap: ${c.space["1"]}; background: transparent; overflow: visible; }
+    &[data-segmented] .progress-seg { flex: 1; height: 100%; border-radius: ${c.radius.full}; background: color-mix(in srgb, ${c.fgPrimary} 8%, transparent); transition: background 0.2s; }
+    &[data-segmented] .progress-seg[data-filled] { background: ${c.bgBrandSolid}; }`,
+    variants: {},
+    defaultVariants: {},
+    compoundVariants: [],
+});
+export const progressRecipe = resolveRecipe(config);
+export default config;

package/dist/esm/components/radiogroup/index.js

@@ -0,0 +1,2 @@
+export { Radio, RadioGroup, } from "./radiogroup.js";
+export { radiogroupRecipe } from "./radiogroup.recipe.js";

package/dist/esm/components/radiogroup/radiogroup.js

@@ -0,0 +1,46 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { radiogroupRecipe } from "./radiogroup.recipe.js";
+const RadioContext = React.createContext(null);
+/**
+ * A radio group — measured from Attio's settings. `default` renders rows (a ring
+ * that fills brand when selected + a label); `card` renders a row of bordered
+ * preview cards whose border turns brand when picked (the Theme picker). Arrow
+ * keys move between options (roving focus). Controlled or uncontrolled.
+ */
+export function RadioGroup({ value, defaultValue, onValueChange, variant = "default", name, className, "aria-label": ariaLabel, children, ...rest }) {
+    const [internal, setInternal] = React.useState(defaultValue);
+    const selected = value ?? internal;
+    const generatedName = React.useId();
+    const groupName = name ?? generatedName;
+    const select = React.useCallback((v) => {
+        if (value === undefined)
+            setInternal(v);
+        onValueChange?.(v);
+    }, [value, onValueChange]);
+    const onKeyDown = (e) => {
+        if (!["ArrowDown", "ArrowRight", "ArrowUp", "ArrowLeft"].includes(e.key))
+            return;
+        const radios = Array.from(e.currentTarget.querySelectorAll('[role="radio"]:not([disabled])'));
+        const idx = radios.indexOf(document.activeElement);
+        const fwd = e.key === "ArrowDown" || e.key === "ArrowRight";
+        const next = radios[(idx + (fwd ? 1 : -1) + radios.length) % radios.length];
+        if (next) {
+            e.preventDefault();
+            next.focus();
+            next.dataset.value && select(next.dataset.value);
+        }
+    };
+    return (_jsx(RadioContext.Provider, { value: { value: selected, select, name: groupName, variant }, children: _jsx("div", { role: "radiogroup", "aria-label": ariaLabel, "data-variant": variant, className: radiogroupRecipe({ className }), ...rest, onKeyDown: onKeyDown, children: children }) }));
+}
+RadioGroup.displayName = "RadioGroup";
+export function Radio({ value, label, children, disabled }) {
+    const ctx = React.useContext(RadioContext);
+    if (!ctx)
+        throw new Error("Radio must be used within a RadioGroup");
+    const checked = ctx.value === value;
+    return (_jsx("button", { type: "button", role: "radio", "aria-checked": checked, name: ctx.name, disabled: disabled, "data-value": value, "data-checked": checked ? "" : undefined, 
+        // roving tabindex: the selected (or first, when none) radio is tabbable
+        tabIndex: checked ? 0 : -1, className: "radio", onClick: () => ctx.select(value), children: ctx.variant === "card" ? (_jsxs(_Fragment, { children: [_jsx("span", { className: "radio-preview", children: children }), _jsx("span", { className: "radio-cardfoot", children: _jsx("span", { className: "radio-label", children: label }) })] })) : (_jsxs(_Fragment, { children: [_jsx("span", { className: "radio-dot" }), _jsx("span", { className: "radio-label", children: label ?? children })] })) }));
+}
+Radio.displayName = "Radio";

package/dist/esm/components/radiogroup/radiogroup.recipe.js

@@ -0,0 +1,37 @@
+import { defineRecipe, resolveRecipe } from "../../core/index.js";
+import { contract as c } from "../../tokens/index.js";
+// A radio group with two shapes, measured from Attio's settings: the default is
+// a column of rows (a 16px ring that fills brand when selected + a label); the
+// `card` variant is a row of bordered preview cards (radius 16) whose border
+// turns brand (#266df0) when selected — the Appearance "Theme" picker.
+const config = defineRecipe({
+    name: "radiogroup",
+    base: `
+    display: flex; flex-direction: column; gap: ${c.space["1"]}; font-family: ${c.font.sans};
+    -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale;
+
+    & .radio { display: flex; align-items: center; gap: ${c.space["2"]}; margin: 0; padding: ${c.space["1"]} ${c.space["1"]}; border: none; background: none; border-radius: ${c.radius.md}; font-family: inherit; font-size: ${c.text.lg}; color: ${c.fgPrimary}; text-align: start; cursor: pointer; }
+    & .radio:disabled { opacity: 0.5; cursor: not-allowed; }
+    & .radio:focus-visible { outline: none; }
+    & .radio-dot { position: relative; flex-shrink: 0; width: 16px; height: 16px; border-radius: ${c.radius.full}; box-shadow: inset 0 0 0 1.5px ${c.borderDefault}; transition: box-shadow .12s ease; }
+    & .radio:hover .radio-dot { box-shadow: inset 0 0 0 1.5px color-mix(in srgb, ${c.fgPrimary} 40%, transparent); }
+    & .radio[data-checked] .radio-dot { box-shadow: inset 0 0 0 1.5px ${c.bgBrandSolid}; }
+    & .radio[data-checked] .radio-dot::after { content: ""; position: absolute; inset: 0; margin: auto; width: 8px; height: 8px; border-radius: ${c.radius.full}; background: ${c.bgBrandSolid}; }
+    & .radio:focus-visible .radio-dot { outline: 2px solid ${c.bgBrandSolid}; outline-offset: 2px; }
+    & .radio-label { min-width: 0; }
+
+    &[data-variant="card"] { flex-direction: row; flex-wrap: wrap; gap: ${c.space["3"]}; }
+    &[data-variant="card"] .radio { flex: 1 1 150px; min-width: 150px; flex-direction: column; align-items: stretch; gap: 0; padding: 0; border-radius: ${c.radius["2xl"]}; box-shadow: inset 0 0 0 1px ${c.borderDefault}; overflow: hidden; transition: box-shadow .12s ease; }
+    &[data-variant="card"] .radio:hover { box-shadow: inset 0 0 0 1px color-mix(in srgb, ${c.fgPrimary} 22%, transparent); }
+    &[data-variant="card"] .radio[data-checked] { box-shadow: inset 0 0 0 1px ${c.bgBrandSolid}; }
+    &[data-variant="card"] .radio-preview { flex: 1; min-height: 0; background: ${c.bgRaised}; }
+    &[data-variant="card"] .radio-cardfoot { display: flex; align-items: center; gap: ${c.space["2"]}; padding: ${c.space["2"]} ${c.space["2.5"]}; border-top: 1px solid ${c.borderSubtle}; font-size: ${c.text.md}; font-weight: ${c.weight.medium}; }
+  `,
+    variants: {},
+    defaultVariants: {},
+    compoundVariants: [],
+});
+export const radiogroupRecipe = Object.assign(resolveRecipe(config), {
+    config,
+});
+export default config;

package/dist/esm/components/resizablepanel/index.js

@@ -0,0 +1,2 @@
+export { computeDragWidth, percentToWidth, ResizablePanel, readStoredPercent, widthToPercent, writeStoredPercent, } from "./resizablepanel.js";
+export { resizablepanelRecipe } from "./resizablepanel.recipe.js";

package/dist/esm/components/resizablepanel/resizablepanel.js

@@ -0,0 +1,135 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { resizablepanelRecipe } from "./resizablepanel.recipe.js";
+/**
+ * Drag delta -> next width, in px, signed by which edge of the panel the
+ * handle drags from. A left-side panel's handle sits at its *right* edge, so
+ * dragging right (positive dx) grows it; a right-side panel's handle sits at
+ * its *left* edge, so dragging right shrinks it. Pure so drag math can be
+ * unit-tested without a DOM.
+ */
+export function computeDragWidth(startWidth, startX, clientX, side) {
+    const dx = clientX - startX;
+    return side === "left" ? startWidth + dx : startWidth - dx;
+}
+/** width (px) -> percentage of the container's width. Pure, unrounded. */
+export function widthToPercent(width, containerWidth) {
+    if (!(containerWidth > 0))
+        return 0;
+    return (width / containerWidth) * 100;
+}
+/** percentage of the container's width -> width (px). Pure, unrounded. */
+export function percentToWidth(percent, containerWidth) {
+    return (percent / 100) * containerWidth;
+}
+/**
+ * Reads a persisted width percentage, wrapped in try/catch: `localStorage`
+ * can throw (private browsing, storage disabled), and a resizable panel
+ * failing to *render* over a persistence error would be worse than the
+ * panel simply forgetting its width. `storage` defaults to
+ * `window.localStorage` and exists as a seam for tests — dropping the
+ * try/catch here is the exact failure this must catch.
+ */
+export function readStoredPercent(key, storage = window.localStorage) {
+    try {
+        const raw = storage.getItem(key);
+        if (raw == null)
+            return null;
+        const n = Number(raw);
+        return Number.isFinite(n) ? n : null;
+    }
+    catch {
+        // private mode / storage disabled — behave as if nothing is stored
+        return null;
+    }
+}
+/** Writes a persisted width percentage, wrapped in try/catch — see {@link readStoredPercent}. */
+export function writeStoredPercent(key, percent, storage = window.localStorage) {
+    try {
+        storage.setItem(key, String(percent));
+    }
+    catch {
+        // private mode / quota exceeded — persistence is best-effort
+    }
+}
+/**
+ * Attio's adjustable-panel primitive: a spacer that reserves layout width
+ * plus a panel that overlays it, so the panel can move between docked
+ * (in-flow) and floating (`position: fixed`, an overlay) without a reflow
+ * glitch. Drag the edge handle to resize; constraints are CSS `min-width`/
+ * `max-width`, never re-clamped in JS.
+ */
+export function ResizablePanel({ side = "left", size, defaultSize = 280, onSizeChange, min = 200, max, floating = false, handleVariant = "panel", storageKey, className, children, ...rest }) {
+    const controlled = size != null;
+    const [uncontrolledSize, setUncontrolledSize] = React.useState(defaultSize);
+    const width = controlled ? size : uncontrolledSize;
+    const containerRef = React.useRef(null);
+    const panelRef = React.useRef(null);
+    const dragRef = React.useRef(null);
+    const [dragging, setDragging] = React.useState(false);
+    // Restore a persisted percentage on mount (uncontrolled + storageKey only).
+    // biome-ignore lint/correctness/useExhaustiveDependencies: restore the persisted width once, on mount only
+    React.useEffect(() => {
+        if (controlled || !storageKey)
+            return;
+        const percent = readStoredPercent(storageKey);
+        if (percent == null)
+            return;
+        const containerWidth = containerRef.current?.getBoundingClientRect().width;
+        if (!containerWidth)
+            return;
+        setUncontrolledSize(percentToWidth(percent, containerWidth));
+    }, []);
+    const commitSize = React.useCallback((next) => {
+        if (!controlled)
+            setUncontrolledSize(next);
+        onSizeChange?.(next);
+        if (!controlled && storageKey) {
+            const containerWidth = containerRef.current?.getBoundingClientRect().width;
+            if (containerWidth) {
+                writeStoredPercent(storageKey, widthToPercent(next, containerWidth));
+            }
+        }
+    }, [controlled, onSizeChange, storageKey]);
+    function onHandlePointerDown(e) {
+        e.preventDefault();
+        e.target.setPointerCapture?.(e.pointerId);
+        dragRef.current = { startX: e.clientX, startWidth: width, moved: false };
+    }
+    function onHandlePointerMove(e) {
+        const drag = dragRef.current;
+        if (!drag)
+            return;
+        if (!drag.moved) {
+            drag.moved = true;
+            setDragging(true);
+        }
+        const next = computeDragWidth(drag.startWidth, drag.startX, e.clientX, side);
+        if (!controlled)
+            setUncontrolledSize(next);
+        onSizeChange?.(next);
+    }
+    function onHandlePointerUp(e) {
+        const drag = dragRef.current;
+        dragRef.current = null;
+        setDragging(false);
+        e.target.releasePointerCapture?.(e.pointerId);
+        if (!drag)
+            return;
+        // Never re-clamp here: read back the panel's actual, CSS-clamped
+        // rendered width after layout, and commit *that* value.
+        const rect = panelRef.current?.getBoundingClientRect();
+        const finalWidth = rect ? Math.round(rect.width) : width;
+        commitSize(finalWidth);
+    }
+    const maxStyle = max == null ? undefined : typeof max === "number" ? `${max}px` : max;
+    const panelSizeStyle = {
+        width,
+        minWidth: min,
+        maxWidth: maxStyle,
+    };
+    return (_jsxs("div", { ref: containerRef, className: resizablepanelRecipe({ className }), ...rest, children: [_jsx("div", { className: "resizablepanel-spacer", style: floating ? { width: 0 } : { width, minWidth: min, maxWidth: maxStyle } }), _jsxs("div", { ref: panelRef, className: "resizablepanel-panel", "data-side": side, "data-floating": floating ? "true" : "false", style: panelSizeStyle, children: [_jsx("div", { className: "resizablepanel-inner", children: children }), _jsx("div", { className: handleVariant === "column"
+                            ? "resizablepanel-handle resizablepanel-handle--column"
+                            : "resizablepanel-handle", "data-side": side, "data-dragging": dragging ? "true" : undefined, "data-handle": "", onPointerDown: onHandlePointerDown, onPointerMove: onHandlePointerMove, onPointerUp: onHandlePointerUp, children: handleVariant === "column" && (_jsx("span", { className: "resizablepanel-handle-inner", "aria-hidden": "true" })) })] })] }));
+}
+ResizablePanel.displayName = "ResizablePanel";

package/dist/esm/components/resizablepanel/resizablepanel.recipe.js

@@ -0,0 +1,66 @@
+import { defineRecipe, resolveRecipe } from "../../core/index.js";
+import { contract as c, elevation as e } from "../../tokens/index.js";
+// Attio's adjustable-panel primitive (measured live — see
+// docs/study/attio-panels.md §1-2). Two elements carry the layout: an
+// invisible SPACER that reserves flow width (it alone animates `width`, a
+// cheap reflow of a leaf node) and the PANEL, taken out of flow with
+// `position: absolute` and drawn on top of the spacer. That split is what
+// lets the panel move between docked (in-flow, hairline divider, no
+// elevation) and floating (position: fixed, 8px gutter, r10, the measured
+// tier-1 elevation) without a reflow glitch on the rest of the layout.
+//
+// Per Lesson 27, the floating panel rests at `transform: none` — the
+// measured off-canvas value (`translateX(calc(-100% - space-2))`, identical
+// to Drawer's left-side value) lives in `@starting-style` as the enter
+// transform only, never as a permanent resting position.
+const config = defineRecipe({
+    name: "resizablepanel",
+    base: `
+    position: relative; display: flex; height: 100%;
+    & .resizablepanel-spacer { flex: 0 0 auto; height: 100%; transition: width 0.14s; }
+    & .resizablepanel-panel { position: absolute; top: 0; bottom: 0; box-sizing: border-box; overflow: hidden; background: ${c.bgSurface}; }
+    & .resizablepanel-panel[data-side="left"] { left: 0; }
+    & .resizablepanel-panel[data-side="right"] { right: 0; }
+
+    /* docked */
+    & .resizablepanel-panel[data-floating="false"] { border-radius: 0; box-shadow: none; }
+    & .resizablepanel-panel[data-floating="false"][data-side="left"] { border-inline-end: 1px solid ${c.borderSubtle}; }
+    & .resizablepanel-panel[data-floating="false"][data-side="right"] { border-inline-start: 1px solid ${c.borderSubtle}; }
+
+    /* floating — position: fixed, 8px gutter, r10, the measured floating elevation.
+       Rest is transform: none (Lesson 27); the off-canvas value is the @starting-style enter only. */
+    & .resizablepanel-panel[data-floating="true"] { position: fixed; top: ${c.space["2"]}; bottom: ${c.space["2"]}; border-inline-end: none; border-inline-start: none; border-radius: 10px; box-shadow: ${e.floating}; transform: none; transition: transform 0.14s, padding 0.14s; }
+    & .resizablepanel-panel[data-floating="true"][data-side="left"] { padding: ${c.space["2"]} 0 ${c.space["2"]} ${c.space["2"]}; @starting-style { transform: translateX(calc(-100% - ${c.space["2"]})); } }
+    & .resizablepanel-panel[data-floating="true"][data-side="right"] { padding: ${c.space["2"]} ${c.space["2"]} ${c.space["2"]} 0; @starting-style { transform: translateX(calc(100% + ${c.space["2"]})); } }
+
+    & .resizablepanel-inner { height: 100%; opacity: 1; }
+    & .resizablepanel-panel[data-floating="true"] .resizablepanel-inner { opacity: 1; transition: opacity 0.14s; @starting-style { opacity: 0; } }
+
+    /* handle — variant "panel" (default): a 10px hit target, its ::before the
+       only visible divider (1px rest -> 2px on hover/drag, brand-solid). */
+    & .resizablepanel-handle { position: absolute; top: 0; width: 10px; height: 100%; z-index: 2; cursor: col-resize; background: transparent; touch-action: none; }
+    & .resizablepanel-handle[data-side="left"] { right: 0; }
+    & .resizablepanel-handle[data-side="right"] { left: 0; }
+    & .resizablepanel-handle::before { content: ""; position: absolute; top: 0; width: 1px; height: 100%; background: ${c.borderSubtle}; transition: background-color 0.16s, height 0.16s; }
+    & .resizablepanel-handle[data-side="left"]::before { right: 0; }
+    & .resizablepanel-handle[data-side="right"]::before { left: 0; }
+    & .resizablepanel-handle:hover::before, & .resizablepanel-handle[data-dragging="true"]::before { width: 2px; background: ${c.bgBrandSolid}; }
+
+    /* handle — variant "column": a wider 7px hit target straddling a 1px
+       divider (table column edges), with a real 3px inner bar whose opacity
+       comes in on a 100ms DELAY — distinct from the panel variant's instant
+       ::before swap. */
+    /* .resizablepanel-handle.resizablepanel-handle--column (both classes) to
+       out-specificity the base [data-side] left/right rules above, which
+       otherwise tie-break by source order alone and would win. */
+    & .resizablepanel-handle.resizablepanel-handle--column { display: flex; align-items: center; justify-content: center; width: 7px; left: -3px; right: -3px; z-index: 1; cursor: col-resize; }
+    & .resizablepanel-handle--column::before { content: none; }
+    & .resizablepanel-handle-inner { width: 3px; height: 100%; border-radius: 3px; background: ${c.bgBrandSolid}; opacity: 0; transition: opacity 0.1s 0.1s; }
+    & .resizablepanel-handle--column:hover .resizablepanel-handle-inner, & .resizablepanel-handle--column[data-dragging="true"] .resizablepanel-handle-inner { opacity: 1; }
+  `,
+    variants: {},
+    defaultVariants: {},
+    compoundVariants: [],
+});
+export const resizablepanelRecipe = resolveRecipe(config);
+export default config;

package/dist/esm/components/segmented/index.js

@@ -0,0 +1,2 @@
+export { Segmented, } from "./segmented.js";
+export { segmentedRecipe } from "./segmented.recipe.js";