@funstack/ui 0.0.0-stage → 0.1.0-alpha.1

package/dist/checkbox/checkbox.mjs

@@ -0,0 +1,82 @@
+"use client";
+import { useTransitionBoundary } from "../internal/transition-boundary.mjs";
+import { createActionDetails } from "../internal/action-details.mjs";
+import { dataAttr } from "../internal/data-attr.mjs";
+import { transitionTypes } from "../internal/transition-types.mjs";
+import { useControllableAction } from "../internal/use-controllable-action.mjs";
+import { useRender } from "../internal/use-render.mjs";
+import { guardCheckableChange, useNativeChecked } from "../internal/use-native-checked.mjs";
+//#region src/checkbox/checkbox.tsx
+/**
+* A checkbox (WAI-ARIA "Checkbox" pattern, dual- and mixed-state). Renders
+* `<input type="checkbox">` whose DOM `checked` is the optimistic state; the input carries
+* `data-pending` while `checkedChangeAction` is in flight and takes part in forms natively.
+*
+* Owned keys (a `render` element's value is overridden): `type`, `checked`, `defaultChecked`,
+* `indeterminate` (stripped), `aria-checked` (always removed), `disabled`, `data-checked`,
+* `data-indeterminate`, `data-pending`, `data-disabled`. `role` passes through. Event handlers
+* are merged rather than owned: a `render` element's own `onChange` (or `onClick`) runs first,
+* then the library's; an `onClick` that calls `preventDefault()` cancels the change (nothing is
+* dispatched).
+*/
+function Checkbox({ checked, defaultChecked, indeterminate = false, checkedChangeAction, disabled = false, transition, className, style, render, ...rest }) {
+	const { optimistic, pending, dispatch, latestInFlight } = useControllableAction({
+		controlled: checked,
+		defaultValue: defaultChecked,
+		initialValue: false,
+		action: checkedChangeAction,
+		transitionTypes: (next) => transitionTypes("checkbox", next ? "check" : "uncheck"),
+		warn: {
+			component: "Checkbox",
+			prop: "checked"
+		}
+	});
+	const shownIndeterminate = indeterminate && !pending;
+	const inputRef = useNativeChecked({
+		type: "checkbox",
+		component: "Checkbox",
+		checked: optimistic,
+		defaultChecked: checked === void 0 ? defaultChecked ?? false : void 0,
+		indeterminate: shownIndeterminate,
+		latestInFlight,
+		onPlatformChange: (next, event) => dispatch(next, createActionDetails(event, { reason: "platform" }))
+	});
+	const element = useRender({
+		defaultElement: "input",
+		render,
+		state: {
+			checked: optimistic,
+			indeterminate: shownIndeterminate,
+			pending,
+			disabled
+		},
+		className,
+		style,
+		children: void 0,
+		ref: inputRef,
+		props: rest,
+		libraryProps: {
+			type: "checkbox",
+			checked: optimistic,
+			defaultChecked: void 0,
+			indeterminate: void 0,
+			"aria-checked": void 0,
+			disabled,
+			"data-checked": dataAttr(optimistic),
+			"data-indeterminate": dataAttr(shownIndeterminate),
+			"data-pending": dataAttr(pending),
+			"data-disabled": dataAttr(disabled),
+			onChange: (event) => {
+				if (disabled) return;
+				const nativeEvent = event.nativeEvent;
+				guardCheckableChange(nativeEvent, () => dispatch(!optimistic, createActionDetails(nativeEvent, { reason: "activate" })), "Checkbox");
+			}
+		}
+	});
+	return useTransitionBoundary("Checkbox", transition, element);
+}
+Checkbox.displayName = "Checkbox";
+//#endregion
+export { Checkbox };
+
+//# sourceMappingURL=checkbox.mjs.map

package/dist/checkbox/checkbox.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox.mjs","names":[],"sources":["../../src/checkbox/checkbox.tsx"],"sourcesContent":["\"use client\";\nimport type { ChangeEvent, ComponentPropsWithRef, CSSProperties, ViewTransitionClass } from \"react\";\nimport { useTransitionBoundary } from \"../internal/transition-boundary.js\";\nimport { createActionDetails } from \"../internal/action-details.js\";\nimport { dataAttr } from \"../internal/data-attr.js\";\nimport { transitionTypes } from \"../internal/transition-types.js\";\nimport type {\n  ActionDetails,\n  ChangeAction,\n  ChangeReason,\n  RenderProp,\n  StateValue,\n} from \"../internal/types.js\";\nimport { useControllableAction } from \"../internal/use-controllable-action.js\";\nimport { guardCheckableChange, useNativeChecked } from \"../internal/use-native-checked.js\";\nimport { useRender } from \"../internal/use-render.js\";\n\nexport interface CheckboxState {\n  /** Optimistic checked state: what the user sees, including an in-flight change. */\n  readonly checked: boolean;\n  /**\n   * The `indeterminate` prop, suspended while an action is in flight: `false` whenever `pending`\n   * is true, so that the attribute, the DOM property and `:indeterminate` always agree.\n   */\n  readonly indeterminate: boolean;\n  /** An action dispatched by this Checkbox is in flight (including the resulting render). */\n  readonly pending: boolean;\n  /** The `disabled` prop. */\n  readonly disabled: boolean;\n}\n\n/** Details passed as the second argument of `checkedChangeAction`. */\nexport interface CheckboxCheckedChangeDetails extends ActionDetails {\n  /**\n   * `\"activate\"`: the user toggled the box (click, Space, label click); `event` is the native\n   * `click` event. `\"platform\"`: the browser changed the value itself: a form reset (`event` is\n   * the `reset` event) or a click before hydration / Firefox form-state restoration found on\n   * mount (`event` is `undefined`).\n   */\n  readonly reason: ChangeReason;\n}\n\nexport interface CheckboxProps extends Omit<\n  ComponentPropsWithRef<\"input\">,\n  | \"type\"\n  | \"checked\"\n  | \"defaultChecked\"\n  | \"onChange\"\n  | \"aria-checked\"\n  | \"className\"\n  | \"style\"\n  | \"children\"\n> {\n  /** Controlled checked state. `undefined` means uncontrolled. */\n  checked?: boolean;\n  /**\n   * Initial checked state in uncontrolled mode (default `false`). Also the value a form reset\n   * returns to: the latest prop value is mirrored into the input's `defaultChecked`.\n   */\n  defaultChecked?: boolean;\n  /**\n   * Controlled-only mixed state (APG tri-state checkbox), derived by the parent from other state;\n   * there is no `defaultIndeterminate` and no action. Rendered as `el.indeterminate`,\n   * `data-indeterminate` and `:indeterminate`, except while an action is pending. Clicking a\n   * mixed box dispatches `checked: true` (for the usual unchecked + mixed representation). Does\n   * not affect what the form submits.\n   */\n  indeterminate?: boolean;\n  /**\n   * Called with the next checked state on every change. Runs inside the Checkbox's transition;\n   * may be sync or async (also a Server Function). Rejections reach the nearest Error Boundary.\n   * Also called with `details.reason === \"platform\"` for a form reset or a pre-hydration click.\n   *\n   * A `setState` placed after your own `await` is not a Transition update; wrap it in\n   * `startTransition` (React limitation). `details.event.preventDefault()` is not a veto and is\n   * unsupported here; use controlled mode to veto a change.\n   */\n  checkedChangeAction?: ChangeAction<boolean, CheckboxCheckedChangeDetails>;\n  /** Renders a natively disabled input; never dispatches. Default `false`. */\n  disabled?: boolean;\n  /** Submitted as the input's value when checked. Default `\"on\"` (platform). */\n  value?: string;\n  /**\n   * Forwarded as `default` to the Checkbox's `<ViewTransition>`. Default: no boundary. Animates the\n   * commit that ends an action, not the optimistic flip; animate the flip with CSS on `:checked`.\n   *\n   * Static: without `transition` the part renders no `<ViewTransition>`; changing it between\n   * `undefined` and a value remounts the element. Any value, `\"none\"` included, makes a mount or\n   * `<Activity>` reveal of this part inside a transition start a document view transition: the\n   * page cross-fades for about 250 ms and the next transition commit waits for it (issue #35).\n   */\n  transition?: ViewTransitionClass;\n  className?: StateValue<string | undefined, CheckboxState>;\n  style?: StateValue<CSSProperties | undefined, CheckboxState>;\n  /**\n   * Replace the rendered element (element form) or take over rendering (function form). Must keep\n   * an `<input type=\"checkbox\">`.\n   */\n  render?: RenderProp<ComponentPropsWithRef<\"input\">, CheckboxState>;\n}\n\n/**\n * A checkbox (WAI-ARIA \"Checkbox\" pattern, dual- and mixed-state). Renders\n * `<input type=\"checkbox\">` whose DOM `checked` is the optimistic state; the input carries\n * `data-pending` while `checkedChangeAction` is in flight and takes part in forms natively.\n *\n * Owned keys (a `render` element's value is overridden): `type`, `checked`, `defaultChecked`,\n * `indeterminate` (stripped), `aria-checked` (always removed), `disabled`, `data-checked`,\n * `data-indeterminate`, `data-pending`, `data-disabled`. `role` passes through. Event handlers\n * are merged rather than owned: a `render` element's own `onChange` (or `onClick`) runs first,\n * then the library's; an `onClick` that calls `preventDefault()` cancels the change (nothing is\n * dispatched).\n */\nexport function Checkbox({\n  checked,\n  defaultChecked,\n  indeterminate = false,\n  checkedChangeAction,\n  disabled = false,\n  transition,\n  className,\n  style,\n  render,\n  ...rest\n}: CheckboxProps) {\n  const { optimistic, pending, dispatch, latestInFlight } = useControllableAction<\n    boolean,\n    CheckboxCheckedChangeDetails\n  >({\n    controlled: checked,\n    defaultValue: defaultChecked,\n    initialValue: false,\n    action: checkedChangeAction,\n    transitionTypes: (next) => transitionTypes(\"checkbox\", next ? \"check\" : \"uncheck\"),\n    warn: { component: \"Checkbox\", prop: \"checked\" },\n  });\n\n  // Suspended while pending (conventions 4.1): the browser clears the property on the click, and\n  // the parent may not have recomputed yet. Restored on settle if the parent still says mixed.\n  const shownIndeterminate = indeterminate && !pending;\n\n  const inputRef = useNativeChecked({\n    type: \"checkbox\",\n    component: \"Checkbox\",\n    checked: optimistic,\n    // Uncontrolled: the latest prop is the reset target. Controlled: React's mount-time value.\n    defaultChecked: checked === undefined ? (defaultChecked ?? false) : undefined,\n    indeterminate: shownIndeterminate,\n    latestInFlight,\n    onPlatformChange: (next, event) =>\n      dispatch(next, createActionDetails(event, { reason: \"platform\" })),\n  });\n\n  const state: CheckboxState = {\n    checked: optimistic,\n    indeterminate: shownIndeterminate,\n    pending,\n    disabled,\n  };\n\n  const element = useRender<ComponentPropsWithRef<\"input\">, CheckboxState>({\n    defaultElement: \"input\",\n    render,\n    state,\n    className,\n    style,\n    children: undefined,\n    ref: inputRef,\n    // Pass-through layer: a `render` element's own props win over these (`role` included).\n    props: rest,\n    // Library-controlled layer (owned keys, conventions 1.2).\n    libraryProps: {\n      type: \"checkbox\",\n      // The DOM state is the optimistic state (conventions 3.2).\n      checked: optimistic,\n      defaultChecked: undefined,\n      // Not a DOM attribute; the hook sets the property. Owned so a `render` element's own\n      // `indeterminate` prop (which react-dom would warn about) is stripped.\n      ...({ indeterminate: undefined } as object),\n      \"aria-checked\": undefined,\n      // Owned so that native disabledness, `data-disabled` and the click guard always agree: a\n      // `render` element cannot re-enable (`disabled={false}`) or disable the input on its own.\n      disabled,\n      \"data-checked\": dataAttr(optimistic),\n      \"data-indeterminate\": dataAttr(shownIndeterminate),\n      \"data-pending\": dataAttr(pending),\n      \"data-disabled\": dataAttr(disabled),\n      onChange: (event: ChangeEvent<HTMLInputElement>) => {\n        // A natively disabled input fires no click; this covers `render` elements that do not\n        // honour `disabled`.\n        if (disabled) return;\n        const nativeEvent = event.nativeEvent;\n        // `indeterminate` plays no part: the platform's rule is \"flip checked, clear mixed\".\n        guardCheckableChange(\n          nativeEvent,\n          () => dispatch(!optimistic, createActionDetails(nativeEvent, { reason: \"activate\" })),\n          \"Checkbox\",\n        );\n      },\n    },\n  });\n\n  return useTransitionBoundary(\"Checkbox\", transition, element);\n}\n\nCheckbox.displayName = \"Checkbox\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAiHA,SAAgB,SAAS,EACvB,SACA,gBACA,gBAAgB,OAChB,qBACA,WAAW,OACX,YACA,WACA,OACA,QACA,GAAG,QACa;CAChB,MAAM,EAAE,YAAY,SAAS,UAAU,mBAAmB,sBAGxD;EACA,YAAY;EACZ,cAAc;EACd,cAAc;EACd,QAAQ;EACR,kBAAkB,SAAS,gBAAgB,YAAY,OAAO,UAAU,SAAS;EACjF,MAAM;GAAE,WAAW;GAAY,MAAM;EAAU;CACjD,CAAC;CAID,MAAM,qBAAqB,iBAAiB,CAAC;CAE7C,MAAM,WAAW,iBAAiB;EAChC,MAAM;EACN,WAAW;EACX,SAAS;EAET,gBAAgB,YAAY,KAAA,IAAa,kBAAkB,QAAS,KAAA;EACpE,eAAe;EACf;EACA,mBAAmB,MAAM,UACvB,SAAS,MAAM,oBAAoB,OAAO,EAAE,QAAQ,WAAW,CAAC,CAAC;CACrE,CAAC;CASD,MAAM,UAAU,UAAyD;EACvE,gBAAgB;EAChB;EACA,OAAA;GATA,SAAS;GACT,eAAe;GACf;GACA;EAMI;EACJ;EACA;EACA,UAAU,KAAA;EACV,KAAK;EAEL,OAAO;EAEP,cAAc;GACZ,MAAM;GAEN,SAAS;GACT,gBAAgB,KAAA;GAGV,eAAe,KAAA;GACrB,gBAAgB,KAAA;GAGhB;GACA,gBAAgB,SAAS,UAAU;GACnC,sBAAsB,SAAS,kBAAkB;GACjD,gBAAgB,SAAS,OAAO;GAChC,iBAAiB,SAAS,QAAQ;GAClC,WAAW,UAAyC;IAGlD,IAAI,UAAU;IACd,MAAM,cAAc,MAAM;IAE1B,qBACE,mBACM,SAAS,CAAC,YAAY,oBAAoB,aAAa,EAAE,QAAQ,WAAW,CAAC,CAAC,GACpF,UACF;GACF;EACF;CACF,CAAC;CAED,OAAO,sBAAsB,YAAY,YAAY,OAAO;AAC9D;AAEA,SAAS,cAAc"}

package/dist/checkbox/index.d.mts

@@ -0,0 +1,3 @@
+import "../internal/platform-attributes.mjs";
+import { Checkbox, CheckboxCheckedChangeDetails, CheckboxProps, CheckboxState } from "./checkbox.mjs";
+export { Checkbox, type CheckboxCheckedChangeDetails, type CheckboxProps, type CheckboxState };

package/dist/checkbox/index.mjs

@@ -0,0 +1 @@
+export { Checkbox } from "./checkbox.mjs";

package/dist/checkbox-group/checkbox-group-context.mjs

@@ -0,0 +1,24 @@
+"use client";
+import { createContext, use } from "react";
+//#region src/checkbox-group/checkbox-group-context.ts
+/**
+* The values a Parent over `values` acts on and derives from: those not in `disabledItems`
+* (values with no Item included). When that leaves nothing (every value has only disabled
+* Items), all of `values`: a Parent the consumer left enabled over disabled Items still shows and
+* changes their state (disable the Parent to make it inert).
+*/
+function enabledValues(values, disabledItems) {
+	if (disabledItems.size === 0) return values;
+	const enabled = values.filter((v) => !disabledItems.has(v));
+	return enabled.length > 0 ? enabled : values;
+}
+const CheckboxGroupContext = createContext(null);
+function useCheckboxGroupContext(part) {
+	const context = use(CheckboxGroupContext);
+	if (context === null) throw new Error(`${part} must be rendered inside a CheckboxGroup.Root.`);
+	return context;
+}
+//#endregion
+export { CheckboxGroupContext, enabledValues, useCheckboxGroupContext };
+
+//# sourceMappingURL=checkbox-group-context.mjs.map

package/dist/checkbox-group/checkbox-group-context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox-group-context.mjs","names":[],"sources":["../../src/checkbox-group/checkbox-group-context.ts"],"sourcesContent":["\"use client\";\nimport { createContext, use } from \"react\";\n\n/** A change to the group's set of checked values (design/components/checkbox-group.md 5.2). */\nexport interface CheckboxGroupPatch {\n  readonly added: readonly string[];\n  readonly removed: readonly string[];\n}\n\nexport interface CheckboxGroupContextValue {\n  /** The `name` shared by every Item of the group (prop or `useId()`). */\n  readonly name: string;\n  readonly form: string | undefined;\n  /**\n   * The Root's `required` while no value of an enabled Item is checked (design section 7):\n   * rendered as native `required` on every Item. Before the Items have registered (server render,\n   * hydration render) it is `required && optimistic.size === 0`, which is what the server can\n   * compute.\n   */\n  readonly required: boolean;\n  /** Optimistic checked values: Items and Parents render from it. */\n  readonly optimistic: ReadonlySet<string>;\n  /** Committed checked values. For per-part pending and the Parent's restore memory only. */\n  readonly committed: ReadonlySet<string>;\n  readonly pending: boolean;\n  /** `Root disabled` (reaches the boxes natively through `<fieldset disabled>`). */\n  readonly disabled: boolean;\n  /**\n   * Uncontrolled mode: the latest `defaultValue` as a set, mirrored by each Item into\n   * `el.defaultChecked` (and by each Parent, derived) so that a form reset returns to it.\n   * `undefined` in controlled mode, where React's mount-time value stays the reset target\n   * (conventions 3.8 rule 6).\n   */\n  readonly defaultValue: ReadonlySet<string> | undefined;\n  /**\n   * Item click. No-op when `optimistic.has(value) === checked`. Checks neither `disabled` nor\n   * `defaultPrevented` (the Item's `guardCheckableChange` does).\n   */\n  readonly toggle: (value: string, checked: boolean, event: Event) => void;\n  /** Parent click: a whole patch. No-op when it changes nothing against the optimistic set. */\n  readonly apply: (patch: CheckboxGroupPatch, event: Event) => void;\n  /**\n   * Values whose every mounted Item has its own `disabled` prop (`Root disabled` is not counted).\n   * A Parent leaves them alone (design 6.2). Empty until the Items registered.\n   */\n  readonly disabledItems: ReadonlySet<string>;\n  /**\n   * Stable. Each Item calls it from a layout effect with its value and its own `disabled` prop;\n   * returns the unregister function.\n   */\n  readonly registerItem: (value: string, disabled: boolean) => () => void;\n  /** From `useNativeGroupReconciliation`; Items and Parents call it from their mount layout effect. */\n  readonly onItemMounted: (element: HTMLInputElement | null) => void;\n  /**\n   * A Parent mounted with a DOM `checked` that differs from its derivation (a click before\n   * hydration). Folded into the Root's next mount read as \"check all\" / \"uncheck all\" of\n   * `values` (design 8.1). Call before `onItemMounted`.\n   */\n  readonly reportParent: (values: readonly string[], checked: boolean) => void;\n  /**\n   * The optimistic set as the Root state's `value`: an array in the Items' document order as of\n   * the Root's last render (see `CheckboxGroupRootState.value`).\n   */\n  readonly value: readonly string[];\n  /**\n   * Sorts values by the current document order of the group's Items (a DOM read); values with no\n   * Item keep their iteration order, after them. Call from handlers and effects only.\n   */\n  readonly sortByDocument: (values: Iterable<string>) => string[];\n}\n\n/**\n * The values a Parent over `values` acts on and derives from: those not in `disabledItems`\n * (values with no Item included). When that leaves nothing (every value has only disabled\n * Items), all of `values`: a Parent the consumer left enabled over disabled Items still shows and\n * changes their state (disable the Parent to make it inert).\n */\nexport function enabledValues(\n  values: readonly string[],\n  disabledItems: ReadonlySet<string>,\n): readonly string[] {\n  if (disabledItems.size === 0) return values;\n  const enabled = values.filter((v) => !disabledItems.has(v));\n  return enabled.length > 0 ? enabled : values;\n}\n\nexport const CheckboxGroupContext = createContext<CheckboxGroupContextValue | null>(null);\n\nexport function useCheckboxGroupContext(part: string): CheckboxGroupContextValue {\n  const context = use(CheckboxGroupContext);\n  if (context === null) {\n    throw new Error(`${part} must be rendered inside a CheckboxGroup.Root.`);\n  }\n  return context;\n}\n"],"mappings":";;;;;;;;;AA6EA,SAAgB,cACd,QACA,eACmB;CACnB,IAAI,cAAc,SAAS,GAAG,OAAO;CACrC,MAAM,UAAU,OAAO,QAAQ,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC;CAC1D,OAAO,QAAQ,SAAS,IAAI,UAAU;AACxC;AAEA,MAAa,uBAAuB,cAAgD,IAAI;AAExF,SAAgB,wBAAwB,MAAyC;CAC/E,MAAM,UAAU,IAAI,oBAAoB;CACxC,IAAI,YAAY,MACd,MAAM,IAAI,MAAM,GAAG,KAAK,+CAA+C;CAEzE,OAAO;AACT"}

package/dist/checkbox-group/checkbox-group-item.d.mts

@@ -0,0 +1,55 @@
+import { RenderProp, StateValue } from "../internal/types.mjs";
+import { CSSProperties, ComponentPropsWithRef, ViewTransitionClass } from "react";
+//#region src/checkbox-group/checkbox-group-item.d.ts
+export interface CheckboxGroupItemState {
+  readonly value: string;
+  /** Optimistic: true as soon as the user checks this box, before the action settles. */
+  readonly checked: boolean;
+  /** The Root is pending and this box's optimistic state differs from its committed state. */
+  readonly pending: boolean;
+  /** Disabled by its own prop or by `Root disabled`. */
+  readonly disabled: boolean;
+}
+export interface CheckboxGroupItemProps extends Omit<ComponentPropsWithRef<"input">, "type" | "name" | "value" | "checked" | "defaultChecked" | "defaultValue" | "form" | "required" | "aria-checked" | "onChange" | "className" | "style" | "children"> {
+  /** The value this box contributes when checked. Must be unique within the Root. */
+  value: string;
+  /**
+   * Native `disabled`: unfocusable, never dispatches, barred from constraint validation. A
+   * `Parent` leaves a disabled Item's value alone and derives its state without it; a checked
+   * disabled Item does not satisfy the group's `required`.
+   */
+  disabled?: boolean;
+  /**
+   * Forwarded to the Item's `<ViewTransition default>`. Default: no boundary. Fires only on the
+   * commit that settles the action (or rolls it back), never on the optimistic check; animate the
+   * check itself with CSS on `:checked`.
+   *
+   * Static: without `transition` the part renders no `<ViewTransition>`; changing it between
+   * `undefined` and a value remounts the element. Any value, `"none"` included, makes a mount or
+   * `<Activity>` reveal of this part inside a transition start a document view transition: the
+   * page cross-fades for about 250 ms and the next transition commit waits for it (issue #35).
+   */
+  transition?: ViewTransitionClass;
+  className?: StateValue<string | undefined, CheckboxGroupItemState>;
+  style?: StateValue<CSSProperties | undefined, CheckboxGroupItemState>;
+  /** Replace the rendered element. Must keep an `<input>`; the library sets `type="checkbox"`. */
+  render?: RenderProp<ComponentPropsWithRef<"input">, CheckboxGroupItemState>;
+}
+/**
+ * One `<input type="checkbox">` of the group, checked while its `value` is in the group's set.
+ * Its DOM `checked` is the optimistic state (`checked={optimistic.has(value)}`): react-dom
+ * restores a controlled input to its props after every event, and only the sync-lane optimistic
+ * value survives that restore.
+ *
+ * Owned keys (conventions 1.2; a `render` element's value is overridden): `type`, `name`,
+ * `value`, `checked`, `defaultChecked` (never rendered), `disabled`, `form`, `required`
+ * (computed by the Root from its `required` prop), `aria-checked` (removed), `data-checked`,
+ * `data-pending`, `data-disabled`. `onChange` is merged: a `render` element's own handler runs
+ * first, then the library's. `role` passes through.
+ */
+export declare function CheckboxGroupItem({ value, disabled: disabledProp, transition, className, style, render, ...rest }: CheckboxGroupItemProps): import("react").ReactNode;
+export declare namespace CheckboxGroupItem {
+  var displayName: string;
+}
+//#endregion
+//# sourceMappingURL=checkbox-group-item.d.mts.map

package/dist/checkbox-group/checkbox-group-item.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox-group-item.d.mts","names":[],"sources":["../../src/checkbox-group/checkbox-group-item.tsx"],"mappings":";;;iBAWiB;WACN;;WAEA;;WAEA;;WAEA;;iBAGM,+BAA+B,KAC9C;;EAgBA;;;;;;EAMA;;;;;;;;;;;EAWA,aAAa;EACb,YAAY,+BAA+B;EAC3C,QAAQ,WAAW,2BAA2B;;EAE9C,SAAS,WAAW,gCAAgC;;;;;;;;;;;;;;wBAetC,oBACd,OACA,UAAU,cACV,YACA,WACA,OACA,WACG,QACF,yCAAsB;yBART"}

package/dist/checkbox-group/checkbox-group-item.mjs

@@ -0,0 +1,90 @@
+"use client";
+import { useTransitionBoundary } from "../internal/transition-boundary.mjs";
+import { dataAttr } from "../internal/data-attr.mjs";
+import { useRender } from "../internal/use-render.mjs";
+import { guardCheckableChange, useNativeChecked } from "../internal/use-native-checked.mjs";
+import { syncPresence } from "../internal/sync-presence.mjs";
+import { useCheckboxGroupContext } from "./checkbox-group-context.mjs";
+import { useLayoutEffect } from "react";
+//#region src/checkbox-group/checkbox-group-item.tsx
+/**
+* One `<input type="checkbox">` of the group, checked while its `value` is in the group's set.
+* Its DOM `checked` is the optimistic state (`checked={optimistic.has(value)}`): react-dom
+* restores a controlled input to its props after every event, and only the sync-lane optimistic
+* value survives that restore.
+*
+* Owned keys (conventions 1.2; a `render` element's value is overridden): `type`, `name`,
+* `value`, `checked`, `defaultChecked` (never rendered), `disabled`, `form`, `required`
+* (computed by the Root from its `required` prop), `aria-checked` (removed), `data-checked`,
+* `data-pending`, `data-disabled`. `onChange` is merged: a `render` element's own handler runs
+* first, then the library's. `role` passes through.
+*/
+function CheckboxGroupItem({ value, disabled: disabledProp = false, transition, className, style, render, ...rest }) {
+	const ctx = useCheckboxGroupContext("CheckboxGroup.Item");
+	const checked = ctx.optimistic.has(value);
+	const pending = ctx.pending && checked !== ctx.committed.has(value);
+	const disabled = ctx.disabled || disabledProp;
+	const required = ctx.required;
+	const { registerItem } = ctx;
+	useLayoutEffect(() => registerItem(value, disabledProp), [
+		registerItem,
+		value,
+		disabledProp
+	]);
+	const inputRef = useNativeChecked({
+		type: "checkbox",
+		component: "CheckboxGroup.Item",
+		checked,
+		group: true,
+		onItemMounted: (el) => {
+			if (el !== null) {
+				syncPresence(el, "data-checked", checked);
+				syncPresence(el, "data-pending", pending);
+				syncPresence(el, "data-disabled", disabled);
+				syncPresence(el, "required", required);
+			}
+			ctx.onItemMounted(el);
+		},
+		defaultChecked: ctx.defaultValue === void 0 ? void 0 : ctx.defaultValue.has(value)
+	});
+	const element = useRender({
+		defaultElement: "input",
+		render,
+		state: {
+			value,
+			checked,
+			pending,
+			disabled
+		},
+		className,
+		style,
+		children: void 0,
+		ref: inputRef,
+		props: rest,
+		libraryProps: {
+			type: "checkbox",
+			name: ctx.name,
+			value,
+			checked,
+			defaultChecked: void 0,
+			"aria-checked": void 0,
+			disabled: disabledProp,
+			form: ctx.form,
+			required,
+			"data-checked": dataAttr(checked),
+			"data-pending": dataAttr(pending),
+			"data-disabled": dataAttr(disabled),
+			onChange: (event) => {
+				if (disabled) return;
+				const nativeEvent = event.nativeEvent;
+				guardCheckableChange(nativeEvent, () => ctx.toggle(value, !checked, nativeEvent), "CheckboxGroup.Item");
+			}
+		}
+	});
+	return useTransitionBoundary("CheckboxGroup.Item", transition, element);
+}
+CheckboxGroupItem.displayName = "CheckboxGroupItem";
+//#endregion
+export { CheckboxGroupItem };
+
+//# sourceMappingURL=checkbox-group-item.mjs.map

package/dist/checkbox-group/checkbox-group-item.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox-group-item.mjs","names":[],"sources":["../../src/checkbox-group/checkbox-group-item.tsx"],"sourcesContent":["\"use client\";\nimport { useLayoutEffect } from \"react\";\nimport type { ChangeEvent, ComponentPropsWithRef, CSSProperties, ViewTransitionClass } from \"react\";\nimport { useTransitionBoundary } from \"../internal/transition-boundary.js\";\nimport { dataAttr } from \"../internal/data-attr.js\";\nimport type { RenderProp, StateValue } from \"../internal/types.js\";\nimport { guardCheckableChange, useNativeChecked } from \"../internal/use-native-checked.js\";\nimport { useRender } from \"../internal/use-render.js\";\nimport { useCheckboxGroupContext } from \"./checkbox-group-context.js\";\nimport { syncPresence } from \"../internal/sync-presence.js\";\n\nexport interface CheckboxGroupItemState {\n  readonly value: string;\n  /** Optimistic: true as soon as the user checks this box, before the action settles. */\n  readonly checked: boolean;\n  /** The Root is pending and this box's optimistic state differs from its committed state. */\n  readonly pending: boolean;\n  /** Disabled by its own prop or by `Root disabled`. */\n  readonly disabled: boolean;\n}\n\nexport interface CheckboxGroupItemProps extends Omit<\n  ComponentPropsWithRef<\"input\">,\n  | \"type\"\n  | \"name\"\n  | \"value\"\n  | \"checked\"\n  | \"defaultChecked\"\n  | \"defaultValue\"\n  | \"form\"\n  | \"required\"\n  | \"aria-checked\"\n  | \"onChange\"\n  | \"className\"\n  | \"style\"\n  | \"children\"\n> {\n  /** The value this box contributes when checked. Must be unique within the Root. */\n  value: string;\n  /**\n   * Native `disabled`: unfocusable, never dispatches, barred from constraint validation. A\n   * `Parent` leaves a disabled Item's value alone and derives its state without it; a checked\n   * disabled Item does not satisfy the group's `required`.\n   */\n  disabled?: boolean;\n  /**\n   * Forwarded to the Item's `<ViewTransition default>`. Default: no boundary. Fires only on the\n   * commit that settles the action (or rolls it back), never on the optimistic check; animate the\n   * check itself with CSS on `:checked`.\n   *\n   * Static: without `transition` the part renders no `<ViewTransition>`; changing it between\n   * `undefined` and a value remounts the element. Any value, `\"none\"` included, makes a mount or\n   * `<Activity>` reveal of this part inside a transition start a document view transition: the\n   * page cross-fades for about 250 ms and the next transition commit waits for it (issue #35).\n   */\n  transition?: ViewTransitionClass;\n  className?: StateValue<string | undefined, CheckboxGroupItemState>;\n  style?: StateValue<CSSProperties | undefined, CheckboxGroupItemState>;\n  /** Replace the rendered element. Must keep an `<input>`; the library sets `type=\"checkbox\"`. */\n  render?: RenderProp<ComponentPropsWithRef<\"input\">, CheckboxGroupItemState>;\n}\n\n/**\n * One `<input type=\"checkbox\">` of the group, checked while its `value` is in the group's set.\n * Its DOM `checked` is the optimistic state (`checked={optimistic.has(value)}`): react-dom\n * restores a controlled input to its props after every event, and only the sync-lane optimistic\n * value survives that restore.\n *\n * Owned keys (conventions 1.2; a `render` element's value is overridden): `type`, `name`,\n * `value`, `checked`, `defaultChecked` (never rendered), `disabled`, `form`, `required`\n * (computed by the Root from its `required` prop), `aria-checked` (removed), `data-checked`,\n * `data-pending`, `data-disabled`. `onChange` is merged: a `render` element's own handler runs\n * first, then the library's. `role` passes through.\n */\nexport function CheckboxGroupItem({\n  value,\n  disabled: disabledProp = false,\n  transition,\n  className,\n  style,\n  render,\n  ...rest\n}: CheckboxGroupItemProps) {\n  const ctx = useCheckboxGroupContext(\"CheckboxGroup.Item\");\n  const checked = ctx.optimistic.has(value);\n  const pending = ctx.pending && checked !== ctx.committed.has(value);\n  const disabled = ctx.disabled || disabledProp;\n  const required = ctx.required;\n\n  // The Root needs every Item's own `disabled` for the Parents and `required` (design 6.2, 7).\n  const { registerItem } = ctx;\n  useLayoutEffect(() => registerItem(value, disabledProp), [registerItem, value, disabledProp]);\n\n  // Group mode: element check and re-apply only; the Root reports the residual paths once.\n  const inputRef = useNativeChecked({\n    type: \"checkbox\",\n    component: \"CheckboxGroup.Item\",\n    checked,\n    group: true,\n    onItemMounted: (el) => {\n      // Hydration keeps server attributes that differ from the client render (React only warns).\n      // An Item hydrating after its Root can render a different state than the server did (a\n      // click on an already hydrated box), and stale attributes would stay until the next change.\n      if (el !== null) {\n        syncPresence(el, \"data-checked\", checked);\n        syncPresence(el, \"data-pending\", pending);\n        syncPresence(el, \"data-disabled\", disabled);\n        syncPresence(el, \"required\", required);\n      }\n      ctx.onItemMounted(el);\n    },\n    defaultChecked: ctx.defaultValue === undefined ? undefined : ctx.defaultValue.has(value),\n  });\n\n  const state: CheckboxGroupItemState = { value, checked, pending, disabled };\n\n  const element = useRender<ComponentPropsWithRef<\"input\">, CheckboxGroupItemState>({\n    defaultElement: \"input\",\n    render,\n    state,\n    className,\n    style,\n    children: undefined,\n    ref: inputRef,\n    // Pass-through layer: a `render` element's own props win over these.\n    props: rest,\n    libraryProps: {\n      type: \"checkbox\",\n      name: ctx.name,\n      value,\n      checked,\n      defaultChecked: undefined,\n      \"aria-checked\": undefined,\n      // Owned (Switch precedent) so that native disabledness, `data-disabled` and the click guard\n      // agree. Only the Item's own prop: `Root disabled` reaches the box through the fieldset.\n      disabled: disabledProp,\n      form: ctx.form,\n      required,\n      \"data-checked\": dataAttr(checked),\n      \"data-pending\": dataAttr(pending),\n      \"data-disabled\": dataAttr(disabled),\n      onChange: (event: ChangeEvent<HTMLInputElement>) => {\n        // A natively disabled box fires no click; this covers `render` elements that do not\n        // honour `disabled`.\n        if (disabled) return;\n        const nativeEvent = event.nativeEvent;\n        guardCheckableChange(\n          nativeEvent,\n          () => ctx.toggle(value, !checked, nativeEvent),\n          \"CheckboxGroup.Item\",\n        );\n      },\n    },\n  });\n\n  return useTransitionBoundary(\"CheckboxGroup.Item\", transition, element);\n}\n\nCheckboxGroupItem.displayName = \"CheckboxGroupItem\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA0EA,SAAgB,kBAAkB,EAChC,OACA,UAAU,eAAe,OACzB,YACA,WACA,OACA,QACA,GAAG,QACsB;CACzB,MAAM,MAAM,wBAAwB,oBAAoB;CACxD,MAAM,UAAU,IAAI,WAAW,IAAI,KAAK;CACxC,MAAM,UAAU,IAAI,WAAW,YAAY,IAAI,UAAU,IAAI,KAAK;CAClE,MAAM,WAAW,IAAI,YAAY;CACjC,MAAM,WAAW,IAAI;CAGrB,MAAM,EAAE,iBAAiB;CACzB,sBAAsB,aAAa,OAAO,YAAY,GAAG;EAAC;EAAc;EAAO;CAAY,CAAC;CAG5F,MAAM,WAAW,iBAAiB;EAChC,MAAM;EACN,WAAW;EACX;EACA,OAAO;EACP,gBAAgB,OAAO;GAIrB,IAAI,OAAO,MAAM;IACf,aAAa,IAAI,gBAAgB,OAAO;IACxC,aAAa,IAAI,gBAAgB,OAAO;IACxC,aAAa,IAAI,iBAAiB,QAAQ;IAC1C,aAAa,IAAI,YAAY,QAAQ;GACvC;GACA,IAAI,cAAc,EAAE;EACtB;EACA,gBAAgB,IAAI,iBAAiB,KAAA,IAAY,KAAA,IAAY,IAAI,aAAa,IAAI,KAAK;CACzF,CAAC;CAID,MAAM,UAAU,UAAkE;EAChF,gBAAgB;EAChB;EACA,OAAA;GALsC;GAAO;GAAS;GAAS;EAK3D;EACJ;EACA;EACA,UAAU,KAAA;EACV,KAAK;EAEL,OAAO;EACP,cAAc;GACZ,MAAM;GACN,MAAM,IAAI;GACV;GACA;GACA,gBAAgB,KAAA;GAChB,gBAAgB,KAAA;GAGhB,UAAU;GACV,MAAM,IAAI;GACV;GACA,gBAAgB,SAAS,OAAO;GAChC,gBAAgB,SAAS,OAAO;GAChC,iBAAiB,SAAS,QAAQ;GAClC,WAAW,UAAyC;IAGlD,IAAI,UAAU;IACd,MAAM,cAAc,MAAM;IAC1B,qBACE,mBACM,IAAI,OAAO,OAAO,CAAC,SAAS,WAAW,GAC7C,oBACF;GACF;EACF;CACF,CAAC;CAED,OAAO,sBAAsB,sBAAsB,YAAY,OAAO;AACxE;AAEA,kBAAkB,cAAc"}

package/dist/checkbox-group/checkbox-group-label.d.mts

@@ -0,0 +1,21 @@
+import { RenderProp, StateValue } from "../internal/types.mjs";
+import { CheckboxGroupRootState } from "./checkbox-group-root.mjs";
+import { CSSProperties, ComponentPropsWithRef, ReactNode } from "react";
+//#region src/checkbox-group/checkbox-group-label.d.ts
+export interface CheckboxGroupLabelProps extends Omit<ComponentPropsWithRef<"legend">, "className" | "style" | "children"> {
+  className?: StateValue<string | undefined, CheckboxGroupRootState>;
+  style?: StateValue<CSSProperties | undefined, CheckboxGroupRootState>;
+  /** Receives the Root's state: a group-level pending indicator goes here. */
+  children?: StateValue<ReactNode, CheckboxGroupRootState>;
+  render?: RenderProp<ComponentPropsWithRef<"legend">, CheckboxGroupRootState>;
+}
+/**
+ * The group's `<legend>`, which names the fieldset natively. Optional; must be the **first child**
+ * of `CheckboxGroup.Root` (HTML content model). Its state is the Root's state. Owns no keys.
+ */
+export declare function CheckboxGroupLabel({ className, style, children, render, ...rest }: CheckboxGroupLabelProps): ReactNode;
+export declare namespace CheckboxGroupLabel {
+  var displayName: string;
+}
+//#endregion
+//# sourceMappingURL=checkbox-group-label.d.mts.map

package/dist/checkbox-group/checkbox-group-label.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox-group-label.d.mts","names":[],"sources":["../../src/checkbox-group/checkbox-group-label.tsx"],"mappings":";;;;iBAOiB,gCAAgC,KAC/C;EAGA,YAAY,+BAA+B;EAC3C,QAAQ,WAAW,2BAA2B;;EAE9C,WAAW,WAAW,WAAW;EACjC,SAAS,WAAW,iCAAiC;;;;;;wBAOvC,qBACd,WACA,OACA,UACA,WACG,QACF,0BAAuB;yBANV"}

package/dist/checkbox-group/checkbox-group-label.mjs

@@ -0,0 +1,30 @@
+"use client";
+import { useRender } from "../internal/use-render.mjs";
+import { useCheckboxGroupContext } from "./checkbox-group-context.mjs";
+//#region src/checkbox-group/checkbox-group-label.tsx
+/**
+* The group's `<legend>`, which names the fieldset natively. Optional; must be the **first child**
+* of `CheckboxGroup.Root` (HTML content model). Its state is the Root's state. Owns no keys.
+*/
+function CheckboxGroupLabel({ className, style, children, render, ...rest }) {
+	const ctx = useCheckboxGroupContext("CheckboxGroup.Label");
+	const state = {
+		value: ctx.value,
+		pending: ctx.pending,
+		disabled: ctx.disabled
+	};
+	return useRender({
+		defaultElement: "legend",
+		render,
+		state,
+		className,
+		style,
+		children,
+		props: rest
+	});
+}
+CheckboxGroupLabel.displayName = "CheckboxGroupLabel";
+//#endregion
+export { CheckboxGroupLabel };
+
+//# sourceMappingURL=checkbox-group-label.mjs.map

package/dist/checkbox-group/checkbox-group-label.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox-group-label.mjs","names":[],"sources":["../../src/checkbox-group/checkbox-group-label.tsx"],"sourcesContent":["\"use client\";\nimport type { ComponentPropsWithRef, CSSProperties, ReactNode } from \"react\";\nimport type { RenderProp, StateValue } from \"../internal/types.js\";\nimport { useRender } from \"../internal/use-render.js\";\nimport { useCheckboxGroupContext } from \"./checkbox-group-context.js\";\nimport type { CheckboxGroupRootState } from \"./checkbox-group-root.js\";\n\nexport interface CheckboxGroupLabelProps extends Omit<\n  ComponentPropsWithRef<\"legend\">,\n  \"className\" | \"style\" | \"children\"\n> {\n  className?: StateValue<string | undefined, CheckboxGroupRootState>;\n  style?: StateValue<CSSProperties | undefined, CheckboxGroupRootState>;\n  /** Receives the Root's state: a group-level pending indicator goes here. */\n  children?: StateValue<ReactNode, CheckboxGroupRootState>;\n  render?: RenderProp<ComponentPropsWithRef<\"legend\">, CheckboxGroupRootState>;\n}\n\n/**\n * The group's `<legend>`, which names the fieldset natively. Optional; must be the **first child**\n * of `CheckboxGroup.Root` (HTML content model). Its state is the Root's state. Owns no keys.\n */\nexport function CheckboxGroupLabel({\n  className,\n  style,\n  children,\n  render,\n  ...rest\n}: CheckboxGroupLabelProps) {\n  const ctx = useCheckboxGroupContext(\"CheckboxGroup.Label\");\n  const state: CheckboxGroupRootState = {\n    value: ctx.value,\n    pending: ctx.pending,\n    disabled: ctx.disabled,\n  };\n  return useRender<ComponentPropsWithRef<\"legend\">, CheckboxGroupRootState>({\n    defaultElement: \"legend\",\n    render,\n    state,\n    className,\n    style,\n    children,\n    props: rest,\n  });\n}\n\nCheckboxGroupLabel.displayName = \"CheckboxGroupLabel\";\n"],"mappings":";;;;;;;;AAsBA,SAAgB,mBAAmB,EACjC,WACA,OACA,UACA,QACA,GAAG,QACuB;CAC1B,MAAM,MAAM,wBAAwB,qBAAqB;CACzD,MAAM,QAAgC;EACpC,OAAO,IAAI;EACX,SAAS,IAAI;EACb,UAAU,IAAI;CAChB;CACA,OAAO,UAAmE;EACxE,gBAAgB;EAChB;EACA;EACA;EACA;EACA;EACA,OAAO;CACT,CAAC;AACH;AAEA,mBAAmB,cAAc"}

package/dist/checkbox-group/checkbox-group-parent.d.mts

@@ -0,0 +1,68 @@
+import { RenderProp, StateValue } from "../internal/types.mjs";
+import { CSSProperties, ComponentPropsWithRef, ViewTransitionClass } from "react";
+//#region src/checkbox-group/checkbox-group-parent.d.ts
+export interface CheckboxGroupParentState {
+  readonly values: readonly string[];
+  /** Every value in `values` is optimistically checked (`false` when `values` is empty). */
+  readonly checked: boolean;
+  /**
+   * Some but not all of `values` are optimistically checked. Never true together with
+   * `checked`. Not suspended while pending (it is derived from optimistic state).
+   */
+  readonly indeterminate: boolean;
+  /** The Root is pending and at least one of `values` differs between optimistic and committed. */
+  readonly pending: boolean;
+  /** Disabled by its own prop or by `Root disabled`. */
+  readonly disabled: boolean;
+}
+export interface CheckboxGroupParentProps extends Omit<ComponentPropsWithRef<"input">, "type" | "name" | "value" | "checked" | "defaultChecked" | "defaultValue" | "form" | "required" | "autoComplete" | "aria-checked" | "onChange" | "className" | "style" | "children"> {
+  /**
+   * The Item values this Parent controls (usually every Item of the group). Its checked and
+   * mixed states are derived from them; its click checks or unchecks all of them. Values with
+   * no Item are still added to / removed from the group's value.
+   *
+   * Values whose Items are disabled (their own `disabled` prop) are left alone: the click does
+   * not change them and the derivation ignores them, so the Parent shows checked when every
+   * enabled Item is. When every value has only disabled Items, the Parent acts on all of them
+   * (disable the Parent to make it inert). Before hydration the server-rendered state counts
+   * disabled Items too; it settles when the Items hydrate.
+   */
+  values: string[];
+  /** Native `disabled`: unfocusable, never dispatches. */
+  disabled?: boolean;
+  /**
+   * Forwarded to the Parent's `<ViewTransition default>`. Default: no boundary. Fires only on the
+   * commit that settles the action (or rolls it back), never on the optimistic flip; animate the
+   * flip itself with CSS on `:checked` / `:indeterminate`.
+   *
+   * Static: without `transition` the part renders no `<ViewTransition>`; changing it between
+   * `undefined` and a value remounts the element. Any value, `"none"` included, makes a mount or
+   * `<Activity>` reveal of this part inside a transition start a document view transition: the
+   * page cross-fades for about 250 ms and the next transition commit waits for it (issue #35).
+   */
+  transition?: ViewTransitionClass;
+  className?: StateValue<string | undefined, CheckboxGroupParentState>;
+  style?: StateValue<CSSProperties | undefined, CheckboxGroupParentState>;
+  /** Replace the rendered element. Must keep an `<input>`; the library sets `type="checkbox"`. */
+  render?: RenderProp<ComponentPropsWithRef<"input">, CheckboxGroupParentState>;
+}
+/**
+ * The mixed-state "select all" checkbox of a group (WAI-ARIA APG "Checkbox (Mixed-State)"):
+ * `<input type="checkbox">` checked when every value in `values` is in the group's optimistic
+ * set, mixed (`el.indeterminate`, `data-indeterminate`) when some are. A click checks every value
+ * when mixed, unchecks every value when checked, and from unchecked restores the last partial
+ * combination of its values the group committed (seeded at mount), else checks every value. Each
+ * click is one dispatch through the Root's `valueChangeAction`. Never submitted (no `name`).
+ * "Its values" are those whose Items are enabled: disabled Items are left alone (see `values`).
+ *
+ * Owned keys (conventions 1.2): `type`, `name` (removed), `value` (removed), `checked`,
+ * `defaultChecked`, `indeterminate` (stripped; the property is set), `required` (removed), `form`
+ * (removed), `autoComplete` (`"off"`), `disabled`, `aria-checked` (removed), `data-checked`, `data-indeterminate`,
+ * `data-pending`, `data-disabled`. `onChange` is merged.
+ */
+export declare function CheckboxGroupParent({ values, disabled: disabledProp, transition, className, style, render, ...rest }: CheckboxGroupParentProps): import("react").ReactNode;
+export declare namespace CheckboxGroupParent {
+  var displayName: string;
+}
+//#endregion
+//# sourceMappingURL=checkbox-group-parent.d.mts.map

package/dist/checkbox-group/checkbox-group-parent.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox-group-parent.d.mts","names":[],"sources":["../../src/checkbox-group/checkbox-group-parent.tsx"],"mappings":";;;iBAaiB;WACN;;WAEA;;;;;WAKA;;WAEA;;WAEA;;iBAGM,iCAAiC,KAChD;;;;;;;;;;;;EA2BA;;EAEA;;;;;;;;;;;EAWA,aAAa;EACb,YAAY,+BAA+B;EAC3C,QAAQ,WAAW,2BAA2B;;EAE9C,SAAS,WAAW,gCAAgC;;;;;;;;;;;;;;;;wBA2BtC,sBACd,QACA,UAAU,cACV,YACA,WACA,OACA,WACG,QACF,2CAAwB;yBARX"}

package/dist/checkbox-group/checkbox-group-parent.mjs

@@ -0,0 +1,145 @@
+"use client";
+import { useTransitionBoundary } from "../internal/transition-boundary.mjs";
+import { dataAttr } from "../internal/data-attr.mjs";
+import { useRender } from "../internal/use-render.mjs";
+import { useFormReset } from "../internal/use-form-reset.mjs";
+import { guardCheckableChange, useNativeChecked } from "../internal/use-native-checked.mjs";
+import { syncPresence } from "../internal/sync-presence.mjs";
+import { enabledValues, useCheckboxGroupContext } from "./checkbox-group-context.mjs";
+import { useCallback, useLayoutEffect, useMemo, useRef, useSyncExternalStore } from "react";
+//#region src/checkbox-group/checkbox-group-parent.tsx
+const subscribeNothing = () => () => {};
+/** `checked` / `indeterminate` of a Parent over `values` against `set` (design 6.1). */
+function derive(values, set) {
+	let inSet = 0;
+	for (const v of values) if (set.has(v)) inSet += 1;
+	const checked = values.length > 0 && inSet === values.length;
+	return {
+		checked,
+		indeterminate: inSet > 0 && !checked
+	};
+}
+/**
+* The mixed-state "select all" checkbox of a group (WAI-ARIA APG "Checkbox (Mixed-State)"):
+* `<input type="checkbox">` checked when every value in `values` is in the group's optimistic
+* set, mixed (`el.indeterminate`, `data-indeterminate`) when some are. A click checks every value
+* when mixed, unchecks every value when checked, and from unchecked restores the last partial
+* combination of its values the group committed (seeded at mount), else checks every value. Each
+* click is one dispatch through the Root's `valueChangeAction`. Never submitted (no `name`).
+* "Its values" are those whose Items are enabled: disabled Items are left alone (see `values`).
+*
+* Owned keys (conventions 1.2): `type`, `name` (removed), `value` (removed), `checked`,
+* `defaultChecked`, `indeterminate` (stripped; the property is set), `required` (removed), `form`
+* (removed), `autoComplete` (`"off"`), `disabled`, `aria-checked` (removed), `data-checked`, `data-indeterminate`,
+* `data-pending`, `data-disabled`. `onChange` is merged.
+*/
+function CheckboxGroupParent({ values, disabled: disabledProp = false, transition, className, style, render, ...rest }) {
+	const ctx = useCheckboxGroupContext("CheckboxGroup.Parent");
+	const hydrating = useSyncExternalStore(subscribeNothing, () => false, () => true);
+	const { disabledItems } = ctx;
+	const effective = useMemo(() => hydrating ? values : enabledValues(values, disabledItems), [
+		hydrating,
+		values,
+		disabledItems
+	]);
+	const { checked, indeterminate } = derive(effective, ctx.optimistic);
+	const pending = ctx.pending && values.some((v) => ctx.optimistic.has(v) !== ctx.committed.has(v));
+	const disabled = ctx.disabled || disabledProp;
+	const memory = useRef(null);
+	const { committed } = ctx;
+	useLayoutEffect(() => {
+		const inCommitted = effective.filter((v) => committed.has(v));
+		if (inCommitted.length > 0 && inCommitted.length < effective.length) memory.current = inCommitted;
+	}, [committed, effective]);
+	const inputRef = useNativeChecked({
+		type: "checkbox",
+		component: "CheckboxGroup.Parent",
+		checked,
+		indeterminate,
+		group: true,
+		onItemMounted: (el) => {
+			if (el !== null) {
+				if (el.checked !== checked) ctx.reportParent(values, el.checked);
+				syncPresence(el, "data-checked", checked);
+				syncPresence(el, "data-indeterminate", indeterminate);
+				syncPresence(el, "data-pending", pending);
+				syncPresence(el, "data-disabled", disabled);
+			}
+			ctx.onItemMounted(el);
+		},
+		defaultChecked: ctx.defaultValue === void 0 ? void 0 : derive(effective, ctx.defaultValue).checked
+	});
+	const node = useRef(null);
+	const ref = useCallback((el) => {
+		node.current = el;
+		const cleanup = inputRef(el);
+		return () => {
+			node.current = null;
+			if (typeof cleanup === "function") cleanup();
+		};
+	}, [inputRef]);
+	useFormReset(node, () => {
+		const el = node.current;
+		if (el !== null && el.checked !== checked) el.checked = checked;
+	});
+	/** The click cycle of design 6.2. */
+	const cyclePatch = () => {
+		if (checked) return {
+			added: [],
+			removed: [...effective]
+		};
+		if (indeterminate) return {
+			added: effective.filter((v) => !ctx.optimistic.has(v)),
+			removed: []
+		};
+		const restore = memory.current?.filter((v) => effective.includes(v)) ?? [];
+		return {
+			added: restore.length > 0 ? restore : [...effective],
+			removed: []
+		};
+	};
+	const element = useRender({
+		defaultElement: "input",
+		render,
+		state: {
+			values,
+			checked,
+			indeterminate,
+			pending,
+			disabled
+		},
+		className,
+		style,
+		children: void 0,
+		ref,
+		props: rest,
+		libraryProps: {
+			type: "checkbox",
+			name: void 0,
+			value: void 0,
+			required: void 0,
+			form: void 0,
+			autoComplete: "off",
+			checked,
+			defaultChecked: void 0,
+			indeterminate: void 0,
+			"aria-checked": void 0,
+			disabled: disabledProp,
+			"data-checked": dataAttr(checked),
+			"data-indeterminate": dataAttr(indeterminate),
+			"data-pending": dataAttr(pending),
+			"data-disabled": dataAttr(disabled),
+			onChange: (event) => {
+				if (disabled) return;
+				const nativeEvent = event.nativeEvent;
+				guardCheckableChange(nativeEvent, () => ctx.apply(cyclePatch(), nativeEvent), "CheckboxGroup.Parent");
+			}
+		}
+	});
+	return useTransitionBoundary("CheckboxGroup.Parent", transition, element);
+}
+CheckboxGroupParent.displayName = "CheckboxGroupParent";
+//#endregion
+export { CheckboxGroupParent };
+
+//# sourceMappingURL=checkbox-group-parent.mjs.map