@crisp-ui-kit/crisp 0.27.0 → 0.29.0

package/dist/cjs/components/multiselect/multiselect.js

@@ -65,7 +65,11 @@ function Chip({ opt }) {
  * popover with a search field over rows of "[chip] … [checkbox]" that toggle on
  * click (the menu stays open). Keyboard: ↑/↓ move, Enter toggles, Esc closes.
  */
-function MultiSelect({ options, value: valueProp, defaultValue, onValueChange, name, placeholder = "Select…", searchable = true, searchPlaceholder = "Search…", emptyLabel = "No results", disabled, className, "aria-label": ariaLabel, ...rest }) {
+function MultiSelect({ options, value: valueProp, defaultValue, onValueChange, name, 
+// The id belongs on the trigger, not the wrapper: `<label for>` only names a
+// LABELABLE element, so an id left on the root div meant a FormField label
+// above this control named nothing (#247). Select already did this.
+id, placeholder = "Select…", searchable = true, searchPlaceholder = "Search…", emptyLabel = "No results", disabled, className, "aria-label": ariaLabel, ...rest }) {
     // Virtual focus: DOM focus stays on the trigger (or the search field) and the
     // active option is named by `aria-activedescendant`. `data-highlighted` is a
     // styling hook only -- a screen reader cannot see it.
@@ -78,6 +82,13 @@ function MultiSelect({ options, value: valueProp, defaultValue, onValueChange, n
     const [query, setQuery] = React.useState("");
     const [highlight, setHighlight] = React.useState(0);
     const rootRef = React.useRef(null);
+    // `form.reset()` restores native controls; a button + listbox holds its value
+    // in React, so it has to listen (#245). Controlled multiselects are left
+    // alone.
+    (0, core_1.useFormReset)(rootRef, () => {
+        if (valueProp === undefined)
+            setInternalValue(defaultValue ?? []);
+    });
     const triggerRef = React.useRef(null);
     const searchRef = React.useRef(null);
     const [internalValue, setInternalValue] = React.useState(defaultValue ?? []);
@@ -155,7 +166,7 @@ function MultiSelect({ options, value: valueProp, defaultValue, onValueChange, n
         return () => document.removeEventListener("pointerdown", onDown);
     }, [open]);
     return ((0, jsx_runtime_1.jsxs)("div", { ref: rootRef, className: (0, multiselect_recipe_1.multiselectRecipe)({ className }), ...rest, children: [name &&
-                value.map((v) => (0, jsx_runtime_1.jsx)("input", { type: "hidden", name: name, value: v }, v)), (0, jsx_runtime_1.jsxs)("button", { ref: triggerRef, type: "button", role: "combobox", "aria-haspopup": "listbox", "aria-expanded": open, "aria-controls": open ? listboxId : undefined, "aria-activedescendant": searchable ? undefined : activeId, "aria-label": ariaLabel, disabled: disabled, "data-open": open ? "" : undefined, className: "multiselect-trigger", onClick: () => (open ? setOpen(false) : openMenu()), onKeyDown: (e) => {
+                value.map((v) => (0, jsx_runtime_1.jsx)("input", { type: "hidden", name: name, value: v }, v)), (0, jsx_runtime_1.jsxs)("button", { ref: triggerRef, id: id, type: "button", role: "combobox", "aria-haspopup": "listbox", "aria-expanded": open, "aria-controls": open ? listboxId : undefined, "aria-activedescendant": searchable ? undefined : activeId, "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")) {

package/dist/cjs/components/quantitypicker/quantitypicker.js

@@ -1,10 +1,45 @@
 "use strict";
 "use client";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.QuantityPicker = QuantityPicker;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_quantity_picker_1 = require("@seed-design/react-quantity-picker");
 const lucide_react_1 = require("lucide-react");
+const React = __importStar(require("react"));
+const core_1 = require("../../core");
 const spinner_1 = require("../spinner");
 const quantitypicker_recipe_1 = require("./quantitypicker.recipe");
 /** seed's icon box per size, read from their stylesheet. */
@@ -57,6 +92,9 @@ function IncrementIcon({ size }) {
  * reverses its visible children rather than relying on CSS.
  */
 function QuantityPicker({ size = "medium", fill = false, className, name, decrementLabel = "Decrease quantity", incrementLabel = "Increase quantity", ...props }) {
-    return ((0, jsx_runtime_1.jsxs)(react_quantity_picker_1.QuantityPickerRoot, { ...props, className: (0, quantitypicker_recipe_1.quantitypickerRecipe)({ size, fill, className }), children: [(0, jsx_runtime_1.jsx)(react_quantity_picker_1.QuantityPickerDecrementButton, { className: "quantitypicker-button", "aria-label": decrementLabel, children: (0, jsx_runtime_1.jsx)(DecrementIcon, { size: size }) }), (0, jsx_runtime_1.jsx)("span", { className: "quantitypicker-divider" }), (0, jsx_runtime_1.jsx)(Value, {}), (0, jsx_runtime_1.jsx)("span", { className: "quantitypicker-divider" }), (0, jsx_runtime_1.jsx)(react_quantity_picker_1.QuantityPickerIncrementButton, { className: "quantitypicker-button", "aria-label": incrementLabel, children: (0, jsx_runtime_1.jsx)(IncrementIcon, { size: size }) }), name ? (0, jsx_runtime_1.jsx)(react_quantity_picker_1.QuantityPickerHiddenInput, { name: name }) : null] }));
+    // A `<label for>` cannot name a div, and this root is a role="group" (#247).
+    const rootRef = React.useRef(null);
+    (0, core_1.useLabelAssociation)(rootRef);
+    return ((0, jsx_runtime_1.jsxs)(react_quantity_picker_1.QuantityPickerRoot, { ref: rootRef, ...props, className: (0, quantitypicker_recipe_1.quantitypickerRecipe)({ size, fill, className }), children: [(0, jsx_runtime_1.jsx)(react_quantity_picker_1.QuantityPickerDecrementButton, { className: "quantitypicker-button", "aria-label": decrementLabel, children: (0, jsx_runtime_1.jsx)(DecrementIcon, { size: size }) }), (0, jsx_runtime_1.jsx)("span", { className: "quantitypicker-divider" }), (0, jsx_runtime_1.jsx)(Value, {}), (0, jsx_runtime_1.jsx)("span", { className: "quantitypicker-divider" }), (0, jsx_runtime_1.jsx)(react_quantity_picker_1.QuantityPickerIncrementButton, { className: "quantitypicker-button", "aria-label": incrementLabel, children: (0, jsx_runtime_1.jsx)(IncrementIcon, { size: size }) }), name ? (0, jsx_runtime_1.jsx)(react_quantity_picker_1.QuantityPickerHiddenInput, { name: name }) : null] }));
 }
 QuantityPicker.displayName = "QuantityPicker";

package/dist/cjs/components/radiogroup/radiogroup.js

@@ -37,6 +37,7 @@ exports.RadioGroup = RadioGroup;
 exports.Radio = Radio;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const React = __importStar(require("react"));
+const core_1 = require("../../core");
 const radiogroup_recipe_1 = require("./radiogroup.recipe");
 const radiogroup_keyboard_1 = require("./radiogroup-keyboard");
 const RadioContext = React.createContext(null);
@@ -57,6 +58,16 @@ function RadioGroup({ value, defaultValue, onValueChange, variant = "default", n
         onValueChange?.(v);
     }, [value, onValueChange]);
     const { onKeyDown, groupRef } = (0, radiogroup_keyboard_1.useRadioGroupKeyboard)({ select });
+    // `form.reset()` restores native controls; a group of role="radio" buttons
+    // holds its answer in React, so it has to listen (#245). A controlled group
+    // is left alone — the value is the consumer's.
+    // A `<label for>` cannot name a div, so a FormField above this group named
+    // nothing until now (#247).
+    (0, core_1.useLabelAssociation)(groupRef);
+    (0, core_1.useFormReset)(groupRef, () => {
+        if (value === undefined)
+            setInternal(defaultValue);
+    });
     return ((0, jsx_runtime_1.jsx)(RadioContext.Provider, { value: { value: selected, select, name: groupName, variant }, children: (0, jsx_runtime_1.jsxs)("div", { ref: groupRef, role: "radiogroup", "aria-label": ariaLabel, "data-variant": variant, className: (0, radiogroup_recipe_1.radiogroupRecipe)({ className }), ...rest, onKeyDown: onKeyDown, children: [children, name && selected && ((0, jsx_runtime_1.jsx)("input", { type: "hidden", name: name, value: selected }))] }) }));
 }
 RadioGroup.displayName = "RadioGroup";

package/dist/cjs/components/segmented/segmented.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Segmented = Segmented;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const React = __importStar(require("react"));
+const core_1 = require("../../core");
 const radiogroup_1 = require("../radiogroup");
 const segmented_recipe_1 = require("./segmented.recipe");
 /**
@@ -69,6 +70,9 @@ function Segmented({ options, value, defaultValue, onValueChange, "aria-label":
     // replaces closed over its own index, so it selected a neighbour without
     // moving focus and every press after the first recomputed the same step.
     const { onKeyDown } = (0, radiogroup_1.useRadioGroupKeyboard)({ select, groupRef: rootRef });
+    // A `<label for>` cannot name a div, and this root is a role="radiogroup"
+    // (#247).
+    (0, core_1.useLabelAssociation)(rootRef);
     return ((0, jsx_runtime_1.jsxs)("div", { ref: rootRef, className: (0, segmented_recipe_1.segmentedRecipe)({ className }), ...rest, role: "radiogroup", "aria-label": ariaLabel, onKeyDown: onKeyDown, children: [thumb && ((0, jsx_runtime_1.jsx)("span", { className: "segmented-thumb", "aria-hidden": "true", style: {
                     width: thumb.width,
                     transform: `translateX(${thumb.left}px)`,

package/dist/cjs/components/select/select.js

@@ -69,6 +69,12 @@ function Select({ options, value, defaultValue, onValueChange, name, placeholder
     const [highlight, setHighlight] = React.useState(0);
     const [query, setQuery] = React.useState("");
     const rootRef = React.useRef(null);
+    // `form.reset()` restores native controls; a button + listbox holds its value
+    // in React, so it has to listen (#245). Controlled selects are left alone.
+    (0, core_1.useFormReset)(rootRef, () => {
+        if (value === undefined)
+            setInternal(defaultValue);
+    });
     const triggerRef = React.useRef(null);
     const searchRef = React.useRef(null);
     const selectedOption = options.find((o) => o.value === selected);

package/dist/cjs/components/switch/switch.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Switch = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const React = __importStar(require("react"));
+const core_1 = require("../../core");
 const switch_recipe_1 = require("./switch.recipe");
 /**
  * An on/off toggle — the settings switch, measured from Attio. Renders a
@@ -46,7 +47,16 @@ const switch_recipe_1 = require("./switch.recipe");
 exports.Switch = React.forwardRef(({ checked, defaultChecked = false, onCheckedChange, disabled, className, onClick, name, value = "on", ...props }, ref) => {
     const [internal, setInternal] = React.useState(defaultChecked);
     const on = checked ?? internal;
-    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("button", { ref: ref, type: "button", role: "switch", "aria-checked": on, disabled: disabled, "data-checked": on ? "" : undefined, className: (0, switch_recipe_1.switchRecipe)({ className }), onClick: (e) => {
+    // `form.reset()` restores native controls; a role="switch" button holds its
+    // state in React, so it has to listen (#245). A controlled switch is left
+    // alone — the value is the consumer's.
+    const rootRef = React.useRef(null);
+    React.useImperativeHandle(ref, () => rootRef.current);
+    (0, core_1.useFormReset)(rootRef, () => {
+        if (checked === undefined)
+            setInternal(defaultChecked);
+    });
+    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("button", { ref: rootRef, type: "button", role: "switch", "aria-checked": on, disabled: disabled, "data-checked": on ? "" : undefined, className: (0, switch_recipe_1.switchRecipe)({ className }), onClick: (e) => {
                     onClick?.(e);
                     if (e.defaultPrevented)
                         return;

package/dist/cjs/core/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.usePrefersReducedMotion = exports.useFocusAfterRemoval = exports.resolveRecipe = exports.Primitive = exports.placeFloating = exports.isRtlElement = exports.withDescribedBy = exports.defineRecipe = exports.cx = void 0;
+exports.usePrefersReducedMotion = exports.useLabelAssociation = exports.useFormReset = exports.useFocusAfterRemoval = exports.resolveRecipe = exports.Primitive = exports.placeFloating = exports.isRtlElement = exports.withDescribedBy = exports.defineRecipe = exports.cx = void 0;
 var cx_1 = require("./cx");
 Object.defineProperty(exports, "cx", { enumerable: true, get: function () { return cx_1.cx; } });
 var define_1 = require("./define");
@@ -32,5 +32,9 @@ Object.defineProperty(exports, "resolveRecipe", { enumerable: true, get: functio
 __exportStar(require("./rtl"), exports);
 var use_focus_after_removal_1 = require("./use-focus-after-removal");
 Object.defineProperty(exports, "useFocusAfterRemoval", { enumerable: true, get: function () { return use_focus_after_removal_1.useFocusAfterRemoval; } });
+var use_form_reset_1 = require("./use-form-reset");
+Object.defineProperty(exports, "useFormReset", { enumerable: true, get: function () { return use_form_reset_1.useFormReset; } });
+var use_label_association_1 = require("./use-label-association");
+Object.defineProperty(exports, "useLabelAssociation", { enumerable: true, get: function () { return use_label_association_1.useLabelAssociation; } });
 var use_prefers_reduced_motion_1 = require("./use-prefers-reduced-motion");
 Object.defineProperty(exports, "usePrefersReducedMotion", { enumerable: true, get: function () { return use_prefers_reduced_motion_1.usePrefersReducedMotion; } });

package/dist/cjs/core/use-form-reset.js

@@ -0,0 +1,78 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFormReset = useFormReset;
+const React = __importStar(require("react"));
+/**
+ * Restore a control's default when the form around it is reset.
+ *
+ * `form.reset()` restores native controls — crisp's Input and Checkbox come
+ * back on their own. The controls that are buttons and listboxes hold their
+ * value in React state, which the platform cannot touch, so a Reset button
+ * used to snap half a form back and leave the other half as the user set it
+ * (#245). The hidden inputs that carry the value to `FormData` do not help:
+ * React rewrites them from the same state a moment later.
+ *
+ * Only the UNCONTROLLED case is restored here. A controlled component's value
+ * belongs to the consumer, and React already behaves this way for a controlled
+ * `<input>`: the platform resets the DOM, the next render puts the prop
+ * straight back. A consumer who wants a controlled control to follow the reset
+ * listens for the same event.
+ *
+ * The listener lives on the form the element is in, found from the element
+ * rather than passed in, because the consumer owns the markup between them.
+ *
+ * The `value === undefined` guard in each caller is deliberate and is NOT
+ * covered by a test, because it cannot be: with a controlled component the
+ * internal state is never read — `value ?? internal` — so writing to it
+ * changes nothing observable. It is kept because a component that later reads
+ * that state (a consumer switching from controlled to uncontrolled) would
+ * otherwise find a value the reset put there behind its back.
+ */
+function useFormReset(ref, onReset) {
+    // the handler is read through a ref so a fresh closure each render does not
+    // resubscribe: the listener is bound to the form, not to this render.
+    const latest = React.useRef(onReset);
+    latest.current = onReset;
+    React.useEffect(() => {
+        const el = ref.current;
+        const form = el?.closest("form");
+        if (!form)
+            return;
+        const handler = () => latest.current();
+        form.addEventListener("reset", handler);
+        return () => form.removeEventListener("reset", handler);
+    }, [ref]);
+}

package/dist/cjs/core/use-label-association.js

@@ -0,0 +1,77 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLabelAssociation = useLabelAssociation;
+const React = __importStar(require("react"));
+/**
+ * Let a `<label for=…>` name a group.
+ *
+ * `for` only associates with a LABELABLE element — button, input, select,
+ * textarea, meter, output, progress. A `role="radiogroup"` or `role="group"`
+ * is a `<div>`, so a FormField label sitting above one names nothing at all:
+ * the markup looks right, the label is clickable, and a screen reader
+ * announces "group" with no name (#247).
+ *
+ * ARIA's answer for a group is `aria-labelledby`, which is exactly what this
+ * repairs: when the element carries neither `aria-label` nor
+ * `aria-labelledby`, and a label points at its id, that label becomes its
+ * name. Done from the DOM rather than through a prop because the label is
+ * rendered by whoever wrote the markup — crisp's FormField, or a hand-written
+ * `<label>` — and neither can reach into the group's props.
+ *
+ * The label is given an id if it has none, derived from the control's own id
+ * so two groups on a page cannot collide.
+ */
+function useLabelAssociation(ref) {
+    React.useEffect(() => {
+        const el = ref.current;
+        if (!el?.id)
+            return;
+        if (el.getAttribute("aria-label") || el.getAttribute("aria-labelledby"))
+            return;
+        const label = el.ownerDocument.querySelector(`label[for="${CSS.escape(el.id)}"]`);
+        if (!label)
+            return;
+        if (!label.id)
+            label.id = `${el.id}-label`;
+        el.setAttribute("aria-labelledby", label.id);
+        return () => {
+            // only take back what this put there: a consumer who set their own
+            // aria-labelledby in the meantime keeps it
+            if (el.getAttribute("aria-labelledby") === label.id)
+                el.removeAttribute("aria-labelledby");
+        };
+    });
+}

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

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Check, ChevronDown, Search } from "lucide-react";
 import * as React from "react";
-import { placeFloating } from "../../core/index.js";
+import { placeFloating, useFormReset } from "../../core/index.js";
 import { useListboxKeyboard } from "../select/index.js";
 import { multiselectRecipe } from "./multiselect.recipe.js";
 const TONES = [
@@ -29,7 +29,11 @@ function Chip({ opt }) {
  * 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, name, placeholder = "Select…", searchable = true, searchPlaceholder = "Search…", emptyLabel = "No results", disabled, className, "aria-label": ariaLabel, ...rest }) {
+export function MultiSelect({ options, value: valueProp, defaultValue, onValueChange, name, 
+// The id belongs on the trigger, not the wrapper: `<label for>` only names a
+// LABELABLE element, so an id left on the root div meant a FormField label
+// above this control named nothing (#247). Select already did this.
+id, placeholder = "Select…", searchable = true, searchPlaceholder = "Search…", emptyLabel = "No results", disabled, className, "aria-label": ariaLabel, ...rest }) {
     // Virtual focus: DOM focus stays on the trigger (or the search field) and the
     // active option is named by `aria-activedescendant`. `data-highlighted` is a
     // styling hook only -- a screen reader cannot see it.
@@ -42,6 +46,13 @@ export function MultiSelect({ options, value: valueProp, defaultValue, onValueCh
     const [query, setQuery] = React.useState("");
     const [highlight, setHighlight] = React.useState(0);
     const rootRef = React.useRef(null);
+    // `form.reset()` restores native controls; a button + listbox holds its value
+    // in React, so it has to listen (#245). Controlled multiselects are left
+    // alone.
+    useFormReset(rootRef, () => {
+        if (valueProp === undefined)
+            setInternalValue(defaultValue ?? []);
+    });
     const triggerRef = React.useRef(null);
     const searchRef = React.useRef(null);
     const [internalValue, setInternalValue] = React.useState(defaultValue ?? []);
@@ -119,7 +130,7 @@ export function MultiSelect({ options, value: valueProp, defaultValue, onValueCh
         return () => document.removeEventListener("pointerdown", onDown);
     }, [open]);
     return (_jsxs("div", { ref: rootRef, className: multiselectRecipe({ className }), ...rest, children: [name &&
-                value.map((v) => _jsx("input", { type: "hidden", name: name, value: v }, v)), _jsxs("button", { ref: triggerRef, type: "button", role: "combobox", "aria-haspopup": "listbox", "aria-expanded": open, "aria-controls": open ? listboxId : undefined, "aria-activedescendant": searchable ? undefined : activeId, "aria-label": ariaLabel, disabled: disabled, "data-open": open ? "" : undefined, className: "multiselect-trigger", onClick: () => (open ? setOpen(false) : openMenu()), onKeyDown: (e) => {
+                value.map((v) => _jsx("input", { type: "hidden", name: name, value: v }, v)), _jsxs("button", { ref: triggerRef, id: id, type: "button", role: "combobox", "aria-haspopup": "listbox", "aria-expanded": open, "aria-controls": open ? listboxId : undefined, "aria-activedescendant": searchable ? undefined : activeId, "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")) {

package/dist/esm/components/quantitypicker/quantitypicker.js

@@ -2,6 +2,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { QuantityPickerDecrementButton, QuantityPickerHiddenInput, QuantityPickerIncrementButton, QuantityPickerRoot, useQuantityPickerContext, } from "@seed-design/react-quantity-picker";
 import { Minus, Plus, Trash2 } from "lucide-react";
+import * as React from "react";
+import { useLabelAssociation } from "../../core/index.js";
 import { Spinner } from "../spinner/index.js";
 import { quantitypickerRecipe } from "./quantitypicker.recipe.js";
 /** seed's icon box per size, read from their stylesheet. */
@@ -54,6 +56,9 @@ function IncrementIcon({ size }) {
  * reverses its visible children rather than relying on CSS.
  */
 export function QuantityPicker({ size = "medium", fill = false, className, name, decrementLabel = "Decrease quantity", incrementLabel = "Increase quantity", ...props }) {
-    return (_jsxs(QuantityPickerRoot, { ...props, className: quantitypickerRecipe({ size, fill, className }), children: [_jsx(QuantityPickerDecrementButton, { className: "quantitypicker-button", "aria-label": decrementLabel, children: _jsx(DecrementIcon, { size: size }) }), _jsx("span", { className: "quantitypicker-divider" }), _jsx(Value, {}), _jsx("span", { className: "quantitypicker-divider" }), _jsx(QuantityPickerIncrementButton, { className: "quantitypicker-button", "aria-label": incrementLabel, children: _jsx(IncrementIcon, { size: size }) }), name ? _jsx(QuantityPickerHiddenInput, { name: name }) : null] }));
+    // A `<label for>` cannot name a div, and this root is a role="group" (#247).
+    const rootRef = React.useRef(null);
+    useLabelAssociation(rootRef);
+    return (_jsxs(QuantityPickerRoot, { ref: rootRef, ...props, className: quantitypickerRecipe({ size, fill, className }), children: [_jsx(QuantityPickerDecrementButton, { className: "quantitypicker-button", "aria-label": decrementLabel, children: _jsx(DecrementIcon, { size: size }) }), _jsx("span", { className: "quantitypicker-divider" }), _jsx(Value, {}), _jsx("span", { className: "quantitypicker-divider" }), _jsx(QuantityPickerIncrementButton, { className: "quantitypicker-button", "aria-label": incrementLabel, children: _jsx(IncrementIcon, { size: size }) }), name ? _jsx(QuantityPickerHiddenInput, { name: name }) : null] }));
 }
 QuantityPicker.displayName = "QuantityPicker";

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

@@ -1,5 +1,6 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import * as React from "react";
+import { useFormReset, useLabelAssociation } from "../../core/index.js";
 import { radiogroupRecipe } from "./radiogroup.recipe.js";
 import { useRadioGroupKeyboard } from "./radiogroup-keyboard.js";
 const RadioContext = React.createContext(null);
@@ -20,6 +21,16 @@ export function RadioGroup({ value, defaultValue, onValueChange, variant = "defa
         onValueChange?.(v);
     }, [value, onValueChange]);
     const { onKeyDown, groupRef } = useRadioGroupKeyboard({ select });
+    // `form.reset()` restores native controls; a group of role="radio" buttons
+    // holds its answer in React, so it has to listen (#245). A controlled group
+    // is left alone — the value is the consumer's.
+    // A `<label for>` cannot name a div, so a FormField above this group named
+    // nothing until now (#247).
+    useLabelAssociation(groupRef);
+    useFormReset(groupRef, () => {
+        if (value === undefined)
+            setInternal(defaultValue);
+    });
     return (_jsx(RadioContext.Provider, { value: { value: selected, select, name: groupName, variant }, children: _jsxs("div", { ref: groupRef, role: "radiogroup", "aria-label": ariaLabel, "data-variant": variant, className: radiogroupRecipe({ className }), ...rest, onKeyDown: onKeyDown, children: [children, name && selected && (_jsx("input", { type: "hidden", name: name, value: selected }))] }) }));
 }
 RadioGroup.displayName = "RadioGroup";

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

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import * as React from "react";
+import { useLabelAssociation } from "../../core/index.js";
 import { useRadioGroupKeyboard } from "../radiogroup/index.js";
 import { segmentedRecipe } from "./segmented.recipe.js";
 /**
@@ -33,6 +34,9 @@ export function Segmented({ options, value, defaultValue, onValueChange, "aria-l
     // replaces closed over its own index, so it selected a neighbour without
     // moving focus and every press after the first recomputed the same step.
     const { onKeyDown } = useRadioGroupKeyboard({ select, groupRef: rootRef });
+    // A `<label for>` cannot name a div, and this root is a role="radiogroup"
+    // (#247).
+    useLabelAssociation(rootRef);
     return (_jsxs("div", { ref: rootRef, className: segmentedRecipe({ className }), ...rest, role: "radiogroup", "aria-label": ariaLabel, onKeyDown: onKeyDown, children: [thumb && (_jsx("span", { className: "segmented-thumb", "aria-hidden": "true", style: {
                     width: thumb.width,
                     transform: `translateX(${thumb.left}px)`,

package/dist/esm/components/select/select.js

@@ -1,7 +1,7 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Check, ChevronDown, Search } from "lucide-react";
 import * as React from "react";
-import { placeFloating } from "../../core/index.js";
+import { placeFloating, useFormReset } from "../../core/index.js";
 import { useListboxKeyboard } from "./listbox-keyboard.js";
 import { selectRecipe } from "./select.recipe.js";
 function optionText(o) {
@@ -33,6 +33,12 @@ export function Select({ options, value, defaultValue, onValueChange, name, plac
     const [highlight, setHighlight] = React.useState(0);
     const [query, setQuery] = React.useState("");
     const rootRef = React.useRef(null);
+    // `form.reset()` restores native controls; a button + listbox holds its value
+    // in React, so it has to listen (#245). Controlled selects are left alone.
+    useFormReset(rootRef, () => {
+        if (value === undefined)
+            setInternal(defaultValue);
+    });
     const triggerRef = React.useRef(null);
     const searchRef = React.useRef(null);
     const selectedOption = options.find((o) => o.value === selected);

package/dist/esm/components/switch/switch.js

@@ -1,5 +1,6 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import * as React from "react";
+import { useFormReset } from "../../core/index.js";
 import { switchRecipe } from "./switch.recipe.js";
 /**
  * An on/off toggle — the settings switch, measured from Attio. Renders a
@@ -10,7 +11,16 @@ import { switchRecipe } from "./switch.recipe.js";
 export const Switch = React.forwardRef(({ checked, defaultChecked = false, onCheckedChange, disabled, className, onClick, name, value = "on", ...props }, ref) => {
     const [internal, setInternal] = React.useState(defaultChecked);
     const on = checked ?? internal;
-    return (_jsxs(_Fragment, { children: [_jsx("button", { ref: ref, type: "button", role: "switch", "aria-checked": on, disabled: disabled, "data-checked": on ? "" : undefined, className: switchRecipe({ className }), onClick: (e) => {
+    // `form.reset()` restores native controls; a role="switch" button holds its
+    // state in React, so it has to listen (#245). A controlled switch is left
+    // alone — the value is the consumer's.
+    const rootRef = React.useRef(null);
+    React.useImperativeHandle(ref, () => rootRef.current);
+    useFormReset(rootRef, () => {
+        if (checked === undefined)
+            setInternal(defaultChecked);
+    });
+    return (_jsxs(_Fragment, { children: [_jsx("button", { ref: rootRef, type: "button", role: "switch", "aria-checked": on, disabled: disabled, "data-checked": on ? "" : undefined, className: switchRecipe({ className }), onClick: (e) => {
                     onClick?.(e);
                     if (e.defaultPrevented)
                         return;

package/dist/esm/core/index.js

@@ -7,4 +7,6 @@ export { Primitive } from "./primitive.js";
 export { resolveRecipe } from "./resolve.js";
 export * from "./rtl.js";
 export { useFocusAfterRemoval } from "./use-focus-after-removal.js";
+export { useFormReset } from "./use-form-reset.js";
+export { useLabelAssociation } from "./use-label-association.js";
 export { usePrefersReducedMotion } from "./use-prefers-reduced-motion.js";

package/dist/esm/core/use-form-reset.js

@@ -0,0 +1,42 @@
+import * as React from "react";
+/**
+ * Restore a control's default when the form around it is reset.
+ *
+ * `form.reset()` restores native controls — crisp's Input and Checkbox come
+ * back on their own. The controls that are buttons and listboxes hold their
+ * value in React state, which the platform cannot touch, so a Reset button
+ * used to snap half a form back and leave the other half as the user set it
+ * (#245). The hidden inputs that carry the value to `FormData` do not help:
+ * React rewrites them from the same state a moment later.
+ *
+ * Only the UNCONTROLLED case is restored here. A controlled component's value
+ * belongs to the consumer, and React already behaves this way for a controlled
+ * `<input>`: the platform resets the DOM, the next render puts the prop
+ * straight back. A consumer who wants a controlled control to follow the reset
+ * listens for the same event.
+ *
+ * The listener lives on the form the element is in, found from the element
+ * rather than passed in, because the consumer owns the markup between them.
+ *
+ * The `value === undefined` guard in each caller is deliberate and is NOT
+ * covered by a test, because it cannot be: with a controlled component the
+ * internal state is never read — `value ?? internal` — so writing to it
+ * changes nothing observable. It is kept because a component that later reads
+ * that state (a consumer switching from controlled to uncontrolled) would
+ * otherwise find a value the reset put there behind its back.
+ */
+export function useFormReset(ref, onReset) {
+    // the handler is read through a ref so a fresh closure each render does not
+    // resubscribe: the listener is bound to the form, not to this render.
+    const latest = React.useRef(onReset);
+    latest.current = onReset;
+    React.useEffect(() => {
+        const el = ref.current;
+        const form = el?.closest("form");
+        if (!form)
+            return;
+        const handler = () => latest.current();
+        form.addEventListener("reset", handler);
+        return () => form.removeEventListener("reset", handler);
+    }, [ref]);
+}

package/dist/esm/core/use-label-association.js

@@ -0,0 +1,41 @@
+import * as React from "react";
+/**
+ * Let a `<label for=…>` name a group.
+ *
+ * `for` only associates with a LABELABLE element — button, input, select,
+ * textarea, meter, output, progress. A `role="radiogroup"` or `role="group"`
+ * is a `<div>`, so a FormField label sitting above one names nothing at all:
+ * the markup looks right, the label is clickable, and a screen reader
+ * announces "group" with no name (#247).
+ *
+ * ARIA's answer for a group is `aria-labelledby`, which is exactly what this
+ * repairs: when the element carries neither `aria-label` nor
+ * `aria-labelledby`, and a label points at its id, that label becomes its
+ * name. Done from the DOM rather than through a prop because the label is
+ * rendered by whoever wrote the markup — crisp's FormField, or a hand-written
+ * `<label>` — and neither can reach into the group's props.
+ *
+ * The label is given an id if it has none, derived from the control's own id
+ * so two groups on a page cannot collide.
+ */
+export function useLabelAssociation(ref) {
+    React.useEffect(() => {
+        const el = ref.current;
+        if (!el?.id)
+            return;
+        if (el.getAttribute("aria-label") || el.getAttribute("aria-labelledby"))
+            return;
+        const label = el.ownerDocument.querySelector(`label[for="${CSS.escape(el.id)}"]`);
+        if (!label)
+            return;
+        if (!label.id)
+            label.id = `${el.id}-label`;
+        el.setAttribute("aria-labelledby", label.id);
+        return () => {
+            // only take back what this put there: a consumer who set their own
+            // aria-labelledby in the meantime keeps it
+            if (el.getAttribute("aria-labelledby") === label.id)
+                el.removeAttribute("aria-labelledby");
+        };
+    });
+}

package/dist/types/components/multiselect/multiselect.d.ts

@@ -36,7 +36,7 @@ export type MultiSelectProps = Omit<React.ComponentPropsWithoutRef<"div">, "valu
  * 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 declare function MultiSelect({ options, value: valueProp, defaultValue, onValueChange, name, placeholder, searchable, searchPlaceholder, emptyLabel, disabled, className, "aria-label": ariaLabel, ...rest }: MultiSelectProps): React.JSX.Element;
+export declare function MultiSelect({ options, value: valueProp, defaultValue, onValueChange, name, id, placeholder, searchable, searchPlaceholder, emptyLabel, disabled, className, "aria-label": ariaLabel, ...rest }: MultiSelectProps): React.JSX.Element;
 export declare namespace MultiSelect {
     var displayName: string;
 }

package/dist/types/components/quantitypicker/quantitypicker.d.ts

@@ -1,4 +1,5 @@
 import { type QuantityPickerRootProps } from "@seed-design/react-quantity-picker";
+import * as React from "react";
 /** seed's icon box per size, read from their stylesheet. */
 declare const ICON: {
     readonly small: 16;
@@ -36,7 +37,7 @@ export type QuantityPickerProps = QuantityPickerRootProps & {
  * Slider documents. Here it also decides child ORDER, since the engine
  * reverses its visible children rather than relying on CSS.
  */
-export declare function QuantityPicker({ size, fill, className, name, decrementLabel, incrementLabel, ...props }: QuantityPickerProps): import("react").JSX.Element;
+export declare function QuantityPicker({ size, fill, className, name, decrementLabel, incrementLabel, ...props }: QuantityPickerProps): React.JSX.Element;
 export declare namespace QuantityPicker {
     var displayName: string;
 }

package/dist/types/core/index.d.ts

@@ -8,4 +8,6 @@ export { resolveRecipe } from "./resolve";
 export * from "./rtl";
 export type * from "./types";
 export { useFocusAfterRemoval } from "./use-focus-after-removal";
+export { useFormReset } from "./use-form-reset";
+export { useLabelAssociation } from "./use-label-association";
 export { usePrefersReducedMotion } from "./use-prefers-reduced-motion";

package/dist/types/core/use-form-reset.d.ts

@@ -0,0 +1,28 @@
+import * as React from "react";
+/**
+ * Restore a control's default when the form around it is reset.
+ *
+ * `form.reset()` restores native controls — crisp's Input and Checkbox come
+ * back on their own. The controls that are buttons and listboxes hold their
+ * value in React state, which the platform cannot touch, so a Reset button
+ * used to snap half a form back and leave the other half as the user set it
+ * (#245). The hidden inputs that carry the value to `FormData` do not help:
+ * React rewrites them from the same state a moment later.
+ *
+ * Only the UNCONTROLLED case is restored here. A controlled component's value
+ * belongs to the consumer, and React already behaves this way for a controlled
+ * `<input>`: the platform resets the DOM, the next render puts the prop
+ * straight back. A consumer who wants a controlled control to follow the reset
+ * listens for the same event.
+ *
+ * The listener lives on the form the element is in, found from the element
+ * rather than passed in, because the consumer owns the markup between them.
+ *
+ * The `value === undefined` guard in each caller is deliberate and is NOT
+ * covered by a test, because it cannot be: with a controlled component the
+ * internal state is never read — `value ?? internal` — so writing to it
+ * changes nothing observable. It is kept because a component that later reads
+ * that state (a consumer switching from controlled to uncontrolled) would
+ * otherwise find a value the reset put there behind its back.
+ */
+export declare function useFormReset(ref: React.RefObject<HTMLElement | null>, onReset: () => void): void;

package/dist/types/core/use-label-association.d.ts

@@ -0,0 +1,21 @@
+import * as React from "react";
+/**
+ * Let a `<label for=…>` name a group.
+ *
+ * `for` only associates with a LABELABLE element — button, input, select,
+ * textarea, meter, output, progress. A `role="radiogroup"` or `role="group"`
+ * is a `<div>`, so a FormField label sitting above one names nothing at all:
+ * the markup looks right, the label is clickable, and a screen reader
+ * announces "group" with no name (#247).
+ *
+ * ARIA's answer for a group is `aria-labelledby`, which is exactly what this
+ * repairs: when the element carries neither `aria-label` nor
+ * `aria-labelledby`, and a label points at its id, that label becomes its
+ * name. Done from the DOM rather than through a prop because the label is
+ * rendered by whoever wrote the markup — crisp's FormField, or a hand-written
+ * `<label>` — and neither can reach into the group's props.
+ *
+ * The label is given an id if it has none, derived from the control's own id
+ * so two groups on a page cannot collide.
+ */
+export declare function useLabelAssociation(ref: React.RefObject<HTMLElement | null>): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crisp-ui-kit/crisp",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "description": "A lean React design system, measured pixel-for-pixel from Attio.",
   "license": "MIT",
   "type": "module",