@qw-ui/core 0.3.0-next.8 → 0.3.0

package/dist/check-list/check-list.d.ts

@@ -0,0 +1,78 @@
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
+import type { IconState } from "../icon/index.js";
+import { type ChoiceGroupItemState, type ChoiceGroupMachine, type ChoiceGroupSchema, type ChoiceGroupService, type ChoiceGroupValueChangeDetails } from "../selector/choice-group.js";
+/** Stable DOM parts shared by every adapter. */
+export declare const CHECK_LIST_PARTS: readonly ["root", "label", "description", "list", "item", "input", "content", "title", "item-description", "extra", "check"];
+export type CheckListPart = (typeof CHECK_LIST_PARTS)[number];
+/** One list row. `label` is the accessible row name; long descriptions wrap. */
+export interface QwCheckListItem {
+    value: string;
+    label: string;
+    description?: string;
+    /** Trailing supporting text (price, ETA…), read after the description. */
+    extra?: string;
+    disabled?: boolean;
+    /** Row stays focusable and submitted but cannot change. */
+    readOnly?: boolean;
+}
+export type CheckListValueChangeDetails = ChoiceGroupValueChangeDetails<QwCheckListItem>;
+export interface QwCheckListProps {
+    id?: string;
+    /** Required nonempty group name rendered as the fieldset legend. */
+    label: string;
+    hideLabel?: boolean;
+    description?: string;
+    describedBy?: string;
+    items: QwCheckListItem[];
+    /** Multiple checkboxes instead of single radios. Defaults false. */
+    multiple?: boolean;
+    value?: string[];
+    defaultValue?: string[];
+    /** Native validation; in single mode it also blocks clearing the selected row. */
+    required?: boolean;
+    min?: number;
+    max?: number;
+    disabled?: boolean;
+    readOnly?: boolean;
+    invalid?: boolean;
+    name?: string;
+    form?: string;
+    dir?: string;
+    loop?: boolean;
+    onValueChange?: (details: CheckListValueChangeDetails) => void;
+}
+export type QwCheckListSchema = ChoiceGroupSchema;
+export type QwCheckListMachine = ChoiceGroupMachine;
+export type QwCheckListService = ChoiceGroupService;
+export type QwCheckListItemState = ChoiceGroupItemState;
+export interface QwCheckListItemProps {
+    value: string;
+}
+export declare function normalizeCheckListItems(items: readonly QwCheckListItem[]): QwCheckListItem[];
+export declare function normalizeCheckListValue(value?: readonly string[], multiple?: boolean): string[];
+export declare function createCheckListProps(props: QwCheckListProps): QwCheckListSchema["props"];
+export declare const checkListMachine: QwCheckListMachine;
+export interface QwCheckListApi<T extends PropTypes = PropTypes> {
+    value: string[];
+    items: QwCheckListItem[];
+    label: string;
+    description: string;
+    setValue(value: string[]): void;
+    toggleValue(value: string): void;
+    clearValue(): void;
+    getRootProps(): T["element"];
+    getLabelProps(): T["element"];
+    getDescriptionProps(): T["element"];
+    getListProps(): T["element"];
+    getItemState(item: QwCheckListItemProps): QwCheckListItemState;
+    getItemProps(item: QwCheckListItemProps): T["label"];
+    getInputProps(item: QwCheckListItemProps): T["input"];
+    getContentProps(item: QwCheckListItemProps): T["element"];
+    getTitleProps(item: QwCheckListItemProps): T["element"];
+    getItemDescriptionProps(item: QwCheckListItemProps): T["element"];
+    getExtraProps(item: QwCheckListItemProps): T["element"];
+    getCheckProps(item: QwCheckListItemProps): T["element"];
+    getCheckIconState(item: QwCheckListItemProps): IconState;
+}
+/** Mechanical list-row part mapping over the shared selection kernel. */
+export declare function connectCheckList<T extends PropTypes>(service: QwCheckListService, normalize: NormalizeProps<T>): QwCheckListApi<T>;

package/dist/check-list/index.d.ts

@@ -0,0 +1,2 @@
+export { CHECK_LIST_PARTS, normalizeCheckListItems, normalizeCheckListValue, createCheckListProps, checkListMachine, connectCheckList } from "./check-list.js";
+export type { CheckListPart, QwCheckListItem, CheckListValueChangeDetails, QwCheckListProps, QwCheckListSchema, QwCheckListMachine, QwCheckListService, QwCheckListItemState, QwCheckListItemProps, QwCheckListApi } from "./check-list.js";

package/dist/check-list/index.js

@@ -0,0 +1,2 @@
+import { a as normalizeCheckListItems, i as createCheckListProps, n as checkListMachine, o as normalizeCheckListValue, r as connectCheckList, t as CHECK_LIST_PARTS } from "../check-list-BvZHQt5w.js";
+export { CHECK_LIST_PARTS, checkListMachine, connectCheckList, createCheckListProps, normalizeCheckListItems, normalizeCheckListValue };

package/dist/check-list-BvZHQt5w.js

@@ -0,0 +1,60 @@
+import { a as normalizeChoiceValue, i as normalizeChoiceItems, n as createChoiceGroupMachine, r as createChoiceGroupProps, t as connectChoiceGroup } from "./choice-group-C4c9m0qe.js";
+//#region src/check-list/check-list.ts
+/** Stable DOM parts shared by every adapter. */
+const CHECK_LIST_PARTS = [
+	"root",
+	"label",
+	"description",
+	"list",
+	"item",
+	"input",
+	"content",
+	"title",
+	"item-description",
+	"extra",
+	"check"
+];
+function normalizeCheckListItems(items) {
+	return normalizeChoiceItems(items, "CheckList");
+}
+function normalizeCheckListValue(value = [], multiple = false) {
+	return normalizeChoiceValue(value, multiple);
+}
+function createCheckListProps(props) {
+	return createChoiceGroupProps({
+		...props,
+		items: props.items ?? [],
+		onValueChange: props.onValueChange
+	}, "CheckList");
+}
+const checkListMachine = createChoiceGroupMachine("check-list");
+/** Mechanical list-row part mapping over the shared selection kernel. */
+function connectCheckList(service, normalize) {
+	const api = connectChoiceGroup("check-list", service, normalize);
+	return {
+		value: api.value,
+		items: api.items,
+		label: api.label,
+		description: api.description,
+		setValue: api.setValue,
+		toggleValue: api.toggleValue,
+		clearValue: api.clearValue,
+		getRootProps: () => api.getRootProps(),
+		getLabelProps: api.getLabelProps,
+		getDescriptionProps: api.getDescriptionProps,
+		getListProps: () => api.getGroupProps("list"),
+		getItemState: api.getItemState,
+		getItemProps: (item) => api.getItemProps(item, "item"),
+		getInputProps: api.getInputProps,
+		getContentProps: (item) => api.getItemPartProps(item, "content"),
+		getTitleProps: (item) => api.getTextProps(item, "title"),
+		getItemDescriptionProps: (item) => api.getItemDescriptionProps(item, "item-description"),
+		getExtraProps: (item) => api.getExtraProps(item, "extra"),
+		getCheckProps: (item) => api.getCheckProps(item, "check"),
+		getCheckIconState: api.getCheckIconState
+	};
+}
+//#endregion
+export { normalizeCheckListItems as a, createCheckListProps as i, checkListMachine as n, normalizeCheckListValue as o, connectCheckList as r, CHECK_LIST_PARTS as t };
+
+//# sourceMappingURL=check-list-BvZHQt5w.js.map

package/dist/check-list-BvZHQt5w.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-list-BvZHQt5w.js","names":[],"sources":["../src/check-list/check-list.ts"],"sourcesContent":["import type { NormalizeProps, PropTypes } from \"@zag-js/types\";\nimport type { IconState } from \"../icon/index.js\";\nimport { connectChoiceGroup, createChoiceGroupMachine, createChoiceGroupProps, normalizeChoiceItems, normalizeChoiceValue, type ChoiceGroupItemState, type ChoiceGroupMachine, type ChoiceGroupSchema, type ChoiceGroupService, type ChoiceGroupValueChangeDetails } from \"../selector/choice-group.js\";\n\n/** Stable DOM parts shared by every adapter. */\nexport const CHECK_LIST_PARTS = [\"root\", \"label\", \"description\", \"list\", \"item\", \"input\", \"content\", \"title\", \"item-description\", \"extra\", \"check\"] as const;\nexport type CheckListPart = (typeof CHECK_LIST_PARTS)[number];\n/** One list row. `label` is the accessible row name; long descriptions wrap. */\nexport interface QwCheckListItem {\n  value: string;\n  label: string;\n  description?: string;\n  /** Trailing supporting text (price, ETA…), read after the description. */\n  extra?: string;\n  disabled?: boolean;\n  /** Row stays focusable and submitted but cannot change. */\n  readOnly?: boolean;\n}\nexport type CheckListValueChangeDetails = ChoiceGroupValueChangeDetails<QwCheckListItem>;\nexport interface QwCheckListProps {\n  id?: string;\n  /** Required nonempty group name rendered as the fieldset legend. */\n  label: string;\n  hideLabel?: boolean;\n  description?: string;\n  describedBy?: string;\n  items: QwCheckListItem[];\n  /** Multiple checkboxes instead of single radios. Defaults false. */\n  multiple?: boolean;\n  value?: string[];\n  defaultValue?: string[];\n  /** Native validation; in single mode it also blocks clearing the selected row. */\n  required?: boolean;\n  min?: number;\n  max?: number;\n  disabled?: boolean;\n  readOnly?: boolean;\n  invalid?: boolean;\n  name?: string;\n  form?: string;\n  dir?: string;\n  loop?: boolean;\n  onValueChange?: (details: CheckListValueChangeDetails) => void;\n}\nexport type QwCheckListSchema = ChoiceGroupSchema;\nexport type QwCheckListMachine = ChoiceGroupMachine;\nexport type QwCheckListService = ChoiceGroupService;\nexport type QwCheckListItemState = ChoiceGroupItemState;\nexport interface QwCheckListItemProps { value: string }\n\nexport function normalizeCheckListItems(items: readonly QwCheckListItem[]): QwCheckListItem[] { return normalizeChoiceItems(items, \"CheckList\"); }\nexport function normalizeCheckListValue(value: readonly string[] = [], multiple = false): string[] { return normalizeChoiceValue(value, multiple); }\nexport function createCheckListProps(props: QwCheckListProps): QwCheckListSchema[\"props\"] {\n  return createChoiceGroupProps({ ...props, items: props.items ?? [], onValueChange: props.onValueChange as QwCheckListSchema[\"props\"][\"onValueChange\"] }, \"CheckList\");\n}\nexport const checkListMachine: QwCheckListMachine = createChoiceGroupMachine(\"check-list\");\n\nexport interface QwCheckListApi<T extends PropTypes = PropTypes> {\n  value: string[];\n  items: QwCheckListItem[];\n  label: string;\n  description: string;\n  setValue(value: string[]): void;\n  toggleValue(value: string): void;\n  clearValue(): void;\n  getRootProps(): T[\"element\"];\n  getLabelProps(): T[\"element\"];\n  getDescriptionProps(): T[\"element\"];\n  getListProps(): T[\"element\"];\n  getItemState(item: QwCheckListItemProps): QwCheckListItemState;\n  getItemProps(item: QwCheckListItemProps): T[\"label\"];\n  getInputProps(item: QwCheckListItemProps): T[\"input\"];\n  getContentProps(item: QwCheckListItemProps): T[\"element\"];\n  getTitleProps(item: QwCheckListItemProps): T[\"element\"];\n  getItemDescriptionProps(item: QwCheckListItemProps): T[\"element\"];\n  getExtraProps(item: QwCheckListItemProps): T[\"element\"];\n  getCheckProps(item: QwCheckListItemProps): T[\"element\"];\n  getCheckIconState(item: QwCheckListItemProps): IconState;\n}\n/** Mechanical list-row part mapping over the shared selection kernel. */\nexport function connectCheckList<T extends PropTypes>(service: QwCheckListService, normalize: NormalizeProps<T>): QwCheckListApi<T> {\n  const api = connectChoiceGroup(\"check-list\", service, normalize);\n  return {\n    value: api.value, items: api.items as QwCheckListItem[], label: api.label, description: api.description,\n    setValue: api.setValue, toggleValue: api.toggleValue, clearValue: api.clearValue,\n    getRootProps: () => api.getRootProps(), getLabelProps: api.getLabelProps, getDescriptionProps: api.getDescriptionProps,\n    getListProps: () => api.getGroupProps(\"list\"),\n    getItemState: api.getItemState,\n    getItemProps: (item) => api.getItemProps(item, \"item\"),\n    getInputProps: api.getInputProps,\n    getContentProps: (item) => api.getItemPartProps(item, \"content\"),\n    getTitleProps: (item) => api.getTextProps(item, \"title\"),\n    getItemDescriptionProps: (item) => api.getItemDescriptionProps(item, \"item-description\"),\n    getExtraProps: (item) => api.getExtraProps(item, \"extra\"),\n    getCheckProps: (item) => api.getCheckProps(item, \"check\"),\n    getCheckIconState: api.getCheckIconState,\n  };\n}\n"],"mappings":";;;AAKA,MAAa,mBAAmB;CAAC;CAAQ;CAAS;CAAe;CAAQ;CAAQ;CAAS;CAAW;CAAS;CAAoB;CAAS;AAAO;AA6ClJ,SAAgB,wBAAwB,OAAsD;CAAE,OAAO,qBAAqB,OAAO,WAAW;AAAG;AACjJ,SAAgB,wBAAwB,QAA2B,CAAC,GAAG,WAAW,OAAiB;CAAE,OAAO,qBAAqB,OAAO,QAAQ;AAAG;AACnJ,SAAgB,qBAAqB,OAAqD;CACxF,OAAO,uBAAuB;EAAE,GAAG;EAAO,OAAO,MAAM,SAAS,CAAC;EAAG,eAAe,MAAM;CAA6D,GAAG,WAAW;AACtK;AACA,MAAa,mBAAuC,yBAAyB,YAAY;;AAyBzF,SAAgB,iBAAsC,SAA6B,WAAiD;CAClI,MAAM,MAAM,mBAAmB,cAAc,SAAS,SAAS;CAC/D,OAAO;EACL,OAAO,IAAI;EAAO,OAAO,IAAI;EAA4B,OAAO,IAAI;EAAO,aAAa,IAAI;EAC5F,UAAU,IAAI;EAAU,aAAa,IAAI;EAAa,YAAY,IAAI;EACtE,oBAAoB,IAAI,aAAa;EAAG,eAAe,IAAI;EAAe,qBAAqB,IAAI;EACnG,oBAAoB,IAAI,cAAc,MAAM;EAC5C,cAAc,IAAI;EAClB,eAAe,SAAS,IAAI,aAAa,MAAM,MAAM;EACrD,eAAe,IAAI;EACnB,kBAAkB,SAAS,IAAI,iBAAiB,MAAM,SAAS;EAC/D,gBAAgB,SAAS,IAAI,aAAa,MAAM,OAAO;EACvD,0BAA0B,SAAS,IAAI,wBAAwB,MAAM,kBAAkB;EACvF,gBAAgB,SAAS,IAAI,cAAc,MAAM,OAAO;EACxD,gBAAgB,SAAS,IAAI,cAAc,MAAM,OAAO;EACxD,mBAAmB,IAAI;CACzB;AACF"}

package/dist/checkbox/checkbox.d.ts

@@ -0,0 +1,59 @@
+import { connect as zagConnect, type CheckedState, type Machine as ZagMachine } from "@zag-js/checkbox";
+import type { Machine, Service } from "@zag-js/core";
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
+export type CheckboxCheckedState = CheckedState;
+export interface QwCheckboxProps {
+    /** Stable instance id; frameworks generate an SSR-safe id when omitted. */
+    id?: string;
+    /** Accessible text label. Keep links outside the checkbox label. */
+    label: string;
+    /** Optional supporting text linked through aria-describedby. */
+    description?: string;
+    /** External Field help/error references, merged with the control-owned description. */
+    describedBy?: string;
+    /** Controlled state; rejected updates restore the native input. */
+    checked?: CheckboxCheckedState;
+    /** Uncontrolled initial value and reset target; defaults to false. */
+    defaultChecked?: CheckboxCheckedState;
+    /** Prevent activation and omit the field from native submission. */
+    disabled?: boolean;
+    /** Prevent activation while retaining focus and submission. */
+    readOnly?: boolean;
+    /** Require a checked value through native form validation. */
+    required?: boolean;
+    /** Expose invalid ARIA and visual state; application supplies error text. */
+    invalid?: boolean;
+    /** Native form field name. Unnamed inputs submit no value. */
+    name?: string;
+    /** Native submitted value; defaults to on. Mixed state submits nothing. */
+    value?: string;
+    /** Associate the input with a form id outside its ancestor tree. */
+    form?: string;
+    /** Logical text and layout direction. */
+    dir?: "ltr" | "rtl";
+    /** Update request, including reset to the declared default. */
+    onCheckedChange?: (details: {
+        checked: CheckboxCheckedState;
+    }) => void;
+}
+type ZagSchema = ZagMachine extends Machine<infer S> ? S : never;
+export interface QwCheckboxSchema extends ZagSchema {
+    props: ZagSchema["props"] & {
+        label?: string;
+        description?: string;
+        describedBy?: string;
+    };
+}
+export type QwCheckboxMachine = Machine<QwCheckboxSchema>;
+export type QwCheckboxService = Service<QwCheckboxSchema>;
+export declare function createCheckboxProps(props: QwCheckboxProps): Partial<QwCheckboxSchema["props"]>;
+/** Upstream state/press/focus behavior; native form lifecycle is shared in Core. */
+export declare const checkboxMachine: QwCheckboxMachine;
+export interface QwCheckboxApi<T extends PropTypes = PropTypes> extends ReturnType<typeof zagConnect<T>> {
+    label: string;
+    description: string;
+    indicatorText: string;
+    getDescriptionProps(): T["element"];
+}
+export declare function connect<T extends PropTypes>(service: QwCheckboxService, normalize: NormalizeProps<T>): QwCheckboxApi<T>;
+export {};

package/dist/checkbox/index.d.ts

@@ -0,0 +1,2 @@
+export { checkboxMachine, createCheckboxProps, connect } from "./checkbox.js";
+export type { CheckboxCheckedState, QwCheckboxProps, QwCheckboxSchema, QwCheckboxMachine, QwCheckboxService, QwCheckboxApi } from "./checkbox.js";

package/dist/checkbox/index.js

@@ -0,0 +1,2 @@
+import { n as connect, r as createCheckboxProps, t as checkboxMachine } from "../checkbox-BlndJrz5.js";
+export { checkboxMachine, connect, createCheckboxProps };

package/dist/checkbox-BlndJrz5.js

@@ -0,0 +1,127 @@
+import { t as mergeDescriptionIds } from "./aria-description-CimD2M_C.js";
+import { n as trackSelectionForm, t as syncSelectionInputs } from "./selection-form-BOM_odUk.js";
+import { dataAttr } from "@zag-js/dom-query";
+import { connect, machine } from "@zag-js/checkbox";
+//#region src/checkbox/checkbox.ts
+function createCheckboxProps(props) {
+	return {
+		...props,
+		defaultChecked: props.defaultChecked ?? false,
+		value: props.value ?? "on"
+	};
+}
+const base = machine;
+const inputId = (scope) => scope.ids?.hiddenInput ?? `checkbox:${scope.id}:input`;
+const rootId = (scope) => scope.ids?.root ?? `checkbox:${scope.id}`;
+function sync(params) {
+	const checked = params.context.get("checked");
+	syncSelectionInputs(params.scope, [{
+		id: inputId(params.scope),
+		checked: checked === true,
+		indeterminate: checked === "indeterminate"
+	}]);
+}
+/** Upstream state/press/focus behavior; native form lifecycle is shared in Core. */
+const checkboxMachine = {
+	...base,
+	implementations: {
+		...base.implementations,
+		effects: {
+			...base.implementations?.effects,
+			trackFormControlState(params) {
+				return trackSelectionForm({
+					scope: params.scope,
+					rootId: rootId(params.scope),
+					form: () => params.prop("form"),
+					getState: () => [{
+						id: inputId(params.scope),
+						checked: params.context.get("checked") === true,
+						indeterminate: params.context.get("checked") === "indeterminate"
+					}],
+					onReset: () => params.context.set("checked", params.prop("defaultChecked") ?? false),
+					onDisabledChange: (ids) => params.context.set("fieldsetDisabled", ids.includes(inputId(params.scope)))
+				}).stop;
+			}
+		},
+		actions: {
+			...base.implementations?.actions,
+			syncInputElement: sync,
+			setChecked(params) {
+				if (!params.event.isTrusted || !params.computed("disabled") && !params.prop("readOnly")) params.context.set("checked", params.event.checked);
+				queueMicrotask(() => sync(params));
+			},
+			toggleChecked(params) {
+				params.context.set("checked", params.context.get("checked") !== true);
+				queueMicrotask(() => sync(params));
+			}
+		}
+	}
+};
+function connect$1(service, normalize) {
+	const api = connect(service, normalize);
+	const disabled = service.computed("disabled");
+	const descriptionId = `checkbox:${service.scope.id}:description`;
+	const data = { "data-disabled": dataAttr(disabled) };
+	return {
+		...api,
+		disabled,
+		label: service.prop("label") ?? "",
+		description: service.prop("description") ?? "",
+		indicatorText: api.indeterminate ? "−" : "✓",
+		getRootProps: () => ({
+			...api.getRootProps(),
+			...normalize.label(data)
+		}),
+		getLabelProps: () => ({
+			...api.getLabelProps(),
+			...normalize.element(data)
+		}),
+		getControlProps: () => ({
+			...api.getControlProps(),
+			...normalize.element(data)
+		}),
+		getIndicatorProps: () => ({
+			...api.getIndicatorProps(),
+			...normalize.element({
+				"aria-hidden": true,
+				...data
+			})
+		}),
+		getDescriptionProps: () => normalize.element({
+			id: descriptionId,
+			"data-scope": "checkbox",
+			"data-part": "description",
+			...data
+		}),
+		getHiddenInputProps() {
+			const input = { ...api.getHiddenInputProps() };
+			delete input.defaultChecked;
+			return {
+				...input,
+				...normalize.input({
+					checked: api.checked,
+					disabled: !!service.prop("disabled"),
+					readOnly: !!service.prop("readOnly"),
+					"aria-checked": api.indeterminate ? "mixed" : api.checked,
+					"aria-describedby": mergeDescriptionIds(service.prop("description") ? descriptionId : void 0, service.prop("describedBy")),
+					"data-scope": "checkbox",
+					"data-part": "input",
+					onChange() {},
+					onClick(event) {
+						if (disabled || service.prop("readOnly")) event.preventDefault();
+						else service.send({
+							type: "CHECKED.SET",
+							checked: event.currentTarget.checked,
+							isTrusted: true
+						});
+						queueMicrotask(() => sync(service));
+					}
+				})
+			};
+		}
+	};
+}
+//#endregion
+export { connect$1 as n, createCheckboxProps as r, checkboxMachine as t };
+
+//# sourceMappingURL=checkbox-BlndJrz5.js.map

package/dist/checkbox-BlndJrz5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox-BlndJrz5.js","names":["zagMachine","connect","zagConnect"],"sources":["../src/checkbox/checkbox.ts"],"sourcesContent":["import { mergeDescriptionIds } from \"../aria-description.js\";\nimport { machine as zagMachine, connect as zagConnect, type CheckedState, type Machine as ZagMachine } from \"@zag-js/checkbox\";\nimport type { Machine, Params, Service } from \"@zag-js/core\";\nimport { dataAttr } from \"@zag-js/dom-query\";\nimport type { NormalizeProps, PropTypes } from \"@zag-js/types\";\nimport { syncSelectionInputs, trackSelectionForm } from \"../selection-form.js\";\n\nexport type CheckboxCheckedState = CheckedState;\nexport interface QwCheckboxProps {\n  /** Stable instance id; frameworks generate an SSR-safe id when omitted. */\n  id?: string;\n  /** Accessible text label. Keep links outside the checkbox label. */\n  label: string;\n  /** Optional supporting text linked through aria-describedby. */\n  description?: string;\n  /** External Field help/error references, merged with the control-owned description. */\n  describedBy?: string;\n  /** Controlled state; rejected updates restore the native input. */\n  checked?: CheckboxCheckedState;\n  /** Uncontrolled initial value and reset target; defaults to false. */\n  defaultChecked?: CheckboxCheckedState;\n  /** Prevent activation and omit the field from native submission. */\n  disabled?: boolean;\n  /** Prevent activation while retaining focus and submission. */\n  readOnly?: boolean;\n  /** Require a checked value through native form validation. */\n  required?: boolean;\n  /** Expose invalid ARIA and visual state; application supplies error text. */\n  invalid?: boolean;\n  /** Native form field name. Unnamed inputs submit no value. */\n  name?: string;\n  /** Native submitted value; defaults to on. Mixed state submits nothing. */\n  value?: string;\n  /** Associate the input with a form id outside its ancestor tree. */\n  form?: string;\n  /** Logical text and layout direction. */\n  dir?: \"ltr\" | \"rtl\";\n  /** Update request, including reset to the declared default. */\n  onCheckedChange?: (details: { checked: CheckboxCheckedState }) => void;\n}\ntype ZagSchema = ZagMachine extends Machine<infer S> ? S : never;\nexport interface QwCheckboxSchema extends ZagSchema {\n  props: ZagSchema[\"props\"] & { label?: string; description?: string; describedBy?: string };\n}\nexport type QwCheckboxMachine = Machine<QwCheckboxSchema>;\nexport type QwCheckboxService = Service<QwCheckboxSchema>;\n\nexport function createCheckboxProps(props: QwCheckboxProps): Partial<QwCheckboxSchema[\"props\"]> {\n  return { ...props, defaultChecked: props.defaultChecked ?? false, value: props.value ?? \"on\" };\n}\nconst base = zagMachine as QwCheckboxMachine;\nconst inputId = (scope: QwCheckboxService[\"scope\"]) => scope.ids?.hiddenInput ?? `checkbox:${scope.id}:input`;\nconst rootId = (scope: QwCheckboxService[\"scope\"]) => scope.ids?.root ?? `checkbox:${scope.id}`;\nfunction sync(params: Pick<Params<QwCheckboxSchema>, \"scope\" | \"context\">) {\n  const checked = params.context.get(\"checked\");\n  syncSelectionInputs(params.scope, [{ id: inputId(params.scope), checked: checked === true, indeterminate: checked === \"indeterminate\" }]);\n}\n/** Upstream state/press/focus behavior; native form lifecycle is shared in Core. */\nexport const checkboxMachine: QwCheckboxMachine = {\n  ...base,\n  implementations: {\n    ...base.implementations,\n    effects: {\n      ...base.implementations?.effects,\n      trackFormControlState(params) {\n        const tracker = trackSelectionForm({\n          scope: params.scope, rootId: rootId(params.scope), form: () => params.prop(\"form\"),\n          getState: () => [{ id: inputId(params.scope), checked: params.context.get(\"checked\") === true, indeterminate: params.context.get(\"checked\") === \"indeterminate\" }],\n          onReset: () => params.context.set(\"checked\", params.prop(\"defaultChecked\") ?? false),\n          onDisabledChange: (ids) => params.context.set(\"fieldsetDisabled\", ids.includes(inputId(params.scope))),\n        });\n        return tracker.stop;\n      },\n    },\n    actions: {\n      ...base.implementations?.actions,\n      syncInputElement: sync,\n      setChecked(params) {\n        if (!params.event.isTrusted || (!params.computed(\"disabled\") && !params.prop(\"readOnly\"))) params.context.set(\"checked\", params.event.checked);\n        queueMicrotask(() => sync(params));\n      },\n      toggleChecked(params) {\n        params.context.set(\"checked\", params.context.get(\"checked\") !== true);\n        queueMicrotask(() => sync(params));\n      },\n    },\n  },\n};\nexport interface QwCheckboxApi<T extends PropTypes = PropTypes> extends ReturnType<typeof zagConnect<T>> {\n  label: string;\n  description: string;\n  indicatorText: string;\n  getDescriptionProps(): T[\"element\"];\n}\nexport function connect<T extends PropTypes>(service: QwCheckboxService, normalize: NormalizeProps<T>): QwCheckboxApi<T> {\n  const api = zagConnect(service, normalize);\n  const disabled = service.computed(\"disabled\");\n  const descriptionId = `checkbox:${service.scope.id}:description`;\n  const data = { \"data-disabled\": dataAttr(disabled) };\n  return {\n    ...api, disabled, label: service.prop(\"label\") ?? \"\", description: service.prop(\"description\") ?? \"\",\n    indicatorText: api.indeterminate ? \"−\" : \"✓\",\n    getRootProps: () => ({ ...api.getRootProps(), ...normalize.label(data) }),\n    getLabelProps: () => ({ ...api.getLabelProps(), ...normalize.element(data) }),\n    getControlProps: () => ({ ...api.getControlProps(), ...normalize.element(data) }),\n    getIndicatorProps: () => ({ ...api.getIndicatorProps(), ...normalize.element({ \"aria-hidden\": true, ...data }) }),\n    getDescriptionProps: () => normalize.element({ id: descriptionId, \"data-scope\": \"checkbox\", \"data-part\": \"description\", ...data }),\n    getHiddenInputProps() {\n      const input = { ...api.getHiddenInputProps() };\n      delete input.defaultChecked;\n      return { ...input, ...normalize.input({\n        checked: api.checked, disabled: !!service.prop(\"disabled\"), readOnly: !!service.prop(\"readOnly\"),\n        \"aria-checked\": api.indeterminate ? \"mixed\" : api.checked,\n        \"aria-describedby\": mergeDescriptionIds(service.prop(\"description\") ? descriptionId : undefined, service.prop(\"describedBy\")),\n        \"data-scope\": \"checkbox\", \"data-part\": \"input\",\n        // Click is reliable even when React's change tracker rejects a prior change.\n        onChange() {},\n        onClick(event) {\n          if (disabled || service.prop(\"readOnly\")) event.preventDefault();\n          else service.send({ type: \"CHECKED.SET\", checked: event.currentTarget.checked, isTrusted: true });\n          queueMicrotask(() => sync(service));\n        },\n      }) };\n    },\n  };\n}\n"],"mappings":";;;;;AA+CA,SAAgB,oBAAoB,OAA4D;CAC9F,OAAO;EAAE,GAAG;EAAO,gBAAgB,MAAM,kBAAkB;EAAO,OAAO,MAAM,SAAS;CAAK;AAC/F;AACA,MAAM,OAAOA;AACb,MAAM,WAAW,UAAsC,MAAM,KAAK,eAAe,YAAY,MAAM,GAAG;AACtG,MAAM,UAAU,UAAsC,MAAM,KAAK,QAAQ,YAAY,MAAM;AAC3F,SAAS,KAAK,QAA6D;CACzE,MAAM,UAAU,OAAO,QAAQ,IAAI,SAAS;CAC5C,oBAAoB,OAAO,OAAO,CAAC;EAAE,IAAI,QAAQ,OAAO,KAAK;EAAG,SAAS,YAAY;EAAM,eAAe,YAAY;CAAgB,CAAC,CAAC;AAC1I;;AAEA,MAAa,kBAAqC;CAChD,GAAG;CACH,iBAAiB;EACf,GAAG,KAAK;EACR,SAAS;GACP,GAAG,KAAK,iBAAiB;GACzB,sBAAsB,QAAQ;IAO5B,OANgB,mBAAmB;KACjC,OAAO,OAAO;KAAO,QAAQ,OAAO,OAAO,KAAK;KAAG,YAAY,OAAO,KAAK,MAAM;KACjF,gBAAgB,CAAC;MAAE,IAAI,QAAQ,OAAO,KAAK;MAAG,SAAS,OAAO,QAAQ,IAAI,SAAS,MAAM;MAAM,eAAe,OAAO,QAAQ,IAAI,SAAS,MAAM;KAAgB,CAAC;KACjK,eAAe,OAAO,QAAQ,IAAI,WAAW,OAAO,KAAK,gBAAgB,KAAK,KAAK;KACnF,mBAAmB,QAAQ,OAAO,QAAQ,IAAI,oBAAoB,IAAI,SAAS,QAAQ,OAAO,KAAK,CAAC,CAAC;IACvG,CACa,CAAC,CAAC;GACjB;EACF;EACA,SAAS;GACP,GAAG,KAAK,iBAAiB;GACzB,kBAAkB;GAClB,WAAW,QAAQ;IACjB,IAAI,CAAC,OAAO,MAAM,aAAc,CAAC,OAAO,SAAS,UAAU,KAAK,CAAC,OAAO,KAAK,UAAU,GAAI,OAAO,QAAQ,IAAI,WAAW,OAAO,MAAM,OAAO;IAC7I,qBAAqB,KAAK,MAAM,CAAC;GACnC;GACA,cAAc,QAAQ;IACpB,OAAO,QAAQ,IAAI,WAAW,OAAO,QAAQ,IAAI,SAAS,MAAM,IAAI;IACpE,qBAAqB,KAAK,MAAM,CAAC;GACnC;EACF;CACF;AACF;AAOA,SAAgBC,UAA6B,SAA4B,WAAgD;CACvH,MAAM,MAAMC,QAAW,SAAS,SAAS;CACzC,MAAM,WAAW,QAAQ,SAAS,UAAU;CAC5C,MAAM,gBAAgB,YAAY,QAAQ,MAAM,GAAG;CACnD,MAAM,OAAO,EAAE,iBAAiB,SAAS,QAAQ,EAAE;CACnD,OAAO;EACL,GAAG;EAAK;EAAU,OAAO,QAAQ,KAAK,OAAO,KAAK;EAAI,aAAa,QAAQ,KAAK,aAAa,KAAK;EAClG,eAAe,IAAI,gBAAgB,MAAM;EACzC,qBAAqB;GAAE,GAAG,IAAI,aAAa;GAAG,GAAG,UAAU,MAAM,IAAI;EAAE;EACvE,sBAAsB;GAAE,GAAG,IAAI,cAAc;GAAG,GAAG,UAAU,QAAQ,IAAI;EAAE;EAC3E,wBAAwB;GAAE,GAAG,IAAI,gBAAgB;GAAG,GAAG,UAAU,QAAQ,IAAI;EAAE;EAC/E,0BAA0B;GAAE,GAAG,IAAI,kBAAkB;GAAG,GAAG,UAAU,QAAQ;IAAE,eAAe;IAAM,GAAG;GAAK,CAAC;EAAE;EAC/G,2BAA2B,UAAU,QAAQ;GAAE,IAAI;GAAe,cAAc;GAAY,aAAa;GAAe,GAAG;EAAK,CAAC;EACjI,sBAAsB;GACpB,MAAM,QAAQ,EAAE,GAAG,IAAI,oBAAoB,EAAE;GAC7C,OAAO,MAAM;GACb,OAAO;IAAE,GAAG;IAAO,GAAG,UAAU,MAAM;KACpC,SAAS,IAAI;KAAS,UAAU,CAAC,CAAC,QAAQ,KAAK,UAAU;KAAG,UAAU,CAAC,CAAC,QAAQ,KAAK,UAAU;KAC/F,gBAAgB,IAAI,gBAAgB,UAAU,IAAI;KAClD,oBAAoB,oBAAoB,QAAQ,KAAK,aAAa,IAAI,gBAAgB,KAAA,GAAW,QAAQ,KAAK,aAAa,CAAC;KAC5H,cAAc;KAAY,aAAa;KAEvC,WAAW,CAAC;KACZ,QAAQ,OAAO;MACb,IAAI,YAAY,QAAQ,KAAK,UAAU,GAAG,MAAM,eAAe;WAC1D,QAAQ,KAAK;OAAE,MAAM;OAAe,SAAS,MAAM,cAAc;OAAS,WAAW;MAAK,CAAC;MAChG,qBAAqB,KAAK,OAAO,CAAC;KACpC;IACF,CAAC;GAAE;EACL;CACF;AACF"}

package/dist/checkbox-group/checkbox-group.d.ts

@@ -0,0 +1,86 @@
+import { type Machine, type Service } from "@zag-js/core";
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
+import { type QwSelectionItem } from "../selection.js";
+export interface QwCheckboxGroupProps {
+    /** Stable instance id; adapters supply an SSR-safe id when omitted. */
+    id?: string;
+    /** Accessible group name rendered as a native fieldset legend. */
+    label: string;
+    /** Optional group supporting text linked through aria-describedby. */
+    description?: string;
+    /** Ordered options with unique non-empty values and accessible text labels. */
+    items: QwSelectionItem[];
+    /** Controlled ordered values; duplicates are removed, unknown values retained. */
+    value?: string[];
+    /** Uncontrolled initial values and the requested target on form reset. */
+    defaultValue?: string[];
+    /** Minimum selected count for user removals; defaults to zero. */
+    min?: number;
+    /** Maximum selected count for user additions; defaults to unlimited. */
+    max?: number;
+    /** Disable all options and exclude them from native submission. */
+    disabled?: boolean;
+    /** Prevent user changes while retaining focus and submitted values. */
+    readOnly?: boolean;
+    /** Require at least one enabled, rendered option through native validation. */
+    required?: boolean;
+    /** Expose invalid group and input semantics; caller supplies error text. */
+    invalid?: boolean;
+    /** Native field name; selected enabled options submit repeated name/value pairs. */
+    name?: string;
+    /** Form id for inputs associated with an external form. */
+    form?: string;
+    /** Visual layout direction; native Tab order remains the option order. */
+    orientation?: "vertical" | "horizontal";
+    /** Text and layout direction. */
+    dir?: "ltr" | "rtl";
+    /** One update request for each accepted value change, including form reset. */
+    onValueChange?: (details: {
+        value: string[];
+    }) => void;
+}
+export interface QwCheckboxGroupSchema {
+    props: QwCheckboxGroupProps & {
+        defaultValue: string[];
+        orientation: "vertical" | "horizontal";
+    };
+    context: {
+        value: string[];
+        disabledIds: string[];
+    };
+    state: "ready";
+    action: "setValue" | "toggleValue" | "syncInputs";
+    effect: "trackForm";
+    event: {
+        type: "VALUE.SET";
+        value: string[];
+    } | {
+        type: "VALUE.TOGGLE";
+        value: string;
+    };
+}
+export type QwCheckboxGroupMachine = Machine<QwCheckboxGroupSchema>;
+export type QwCheckboxGroupService = Service<QwCheckboxGroupSchema>;
+export interface QwCheckboxGroupItemProps {
+    value: string;
+}
+export declare function createCheckboxGroupProps(props: QwCheckboxGroupProps): Partial<QwCheckboxGroupSchema["props"]>;
+/** Zag owns the bindable lifecycle; shared Core rules own all selection behavior. */
+export declare const checkboxGroupMachine: QwCheckboxGroupMachine;
+export interface QwCheckboxGroupApi<T extends PropTypes = PropTypes> {
+    value: string[];
+    items: QwSelectionItem[];
+    label: string;
+    description: string;
+    setValue(value: string[]): void;
+    toggleValue(value: string): void;
+    getRootProps(): T["element"];
+    getLabelProps(): T["element"];
+    getDescriptionProps(): T["element"];
+    getItemProps(item: QwCheckboxGroupItemProps): T["label"];
+    getInputProps(item: QwCheckboxGroupItemProps): T["input"];
+    getControlProps(item: QwCheckboxGroupItemProps): T["element"];
+    getTextProps(item: QwCheckboxGroupItemProps): T["element"];
+    getItemDescriptionProps(item: QwCheckboxGroupItemProps): T["element"];
+}
+export declare function connect<T extends PropTypes>(service: QwCheckboxGroupService, normalize: NormalizeProps<T>): QwCheckboxGroupApi<T>;

package/dist/checkbox-group/index.d.ts

@@ -0,0 +1,3 @@
+export { checkboxGroupMachine, createCheckboxGroupProps, connect } from "./checkbox-group.js";
+export type { QwCheckboxGroupProps, QwCheckboxGroupSchema, QwCheckboxGroupMachine, QwCheckboxGroupService, QwCheckboxGroupApi, QwCheckboxGroupItemProps } from "./checkbox-group.js";
+export type { QwSelectionItem } from "../selection.js";

package/dist/checkbox-group/index.js

@@ -0,0 +1,2 @@
+import { n as connect, r as createCheckboxGroupProps, t as checkboxGroupMachine } from "../checkbox-group-gGfsTv-e.js";
+export { checkboxGroupMachine, connect, createCheckboxGroupProps };