@qw-ui/core 0.3.0-next.40 → 0.3.0-next.43

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

@@ -0,0 +1,78 @@
+import { connect as zagConnect, type Machine as ZagMachine } from "@zag-js/radio-group";
+import type { Machine, Service } from "@zag-js/core";
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
+import { type QwSelectionItem } from "../selection.js";
+export interface QwRadioGroupProps {
+    /** Stable instance id; adapters generate an SSR-safe id when omitted. */
+    id?: string;
+    /** Accessible group name rendered as the native fieldset legend. */
+    label: string;
+    /** Supporting text associated with the group. */
+    description?: string;
+    /** External Field help/error references, merged with the control-owned description. */
+    describedBy?: string;
+    /** Ordered options with unique non-empty values. */
+    items: QwSelectionItem[];
+    /** Controlled value; explicit null means no selection. Unknown strings are retained. */
+    value?: string | null;
+    /** Initial selection and form reset target; defaults to null. */
+    defaultValue?: string | null;
+    /** Disable the group and exclude its inputs from native submission. */
+    disabled?: boolean;
+    /** Prevent user changes while retaining focus and submission. */
+    readOnly?: boolean;
+    /** Require one enabled rendered choice through native radio validation. */
+    required?: boolean;
+    /** Expose error semantics; the owner supplies error text. */
+    invalid?: boolean;
+    /** Native group field name; defaults to the instance id. Use a unique explicit name for forms. */
+    name?: string;
+    /** Associate every input with an external form id. */
+    form?: string;
+    /** Visual layout; defaults to vertical. Native arrows work in either layout. */
+    orientation?: "vertical" | "horizontal";
+    /** Layout direction; omitted direction inherits from the native input. */
+    dir?: "ltr" | "rtl";
+    /** Allow native arrow navigation to wrap around; defaults to true. */
+    loop?: boolean;
+    /** Value update request, including reset to the declared default. */
+    onValueChange?: (details: {
+        value: string | null;
+    }) => void;
+}
+type ZagSchema = ZagMachine extends Machine<infer S> ? S : never;
+export interface QwRadioGroupSchema extends ZagSchema {
+    props: ZagSchema["props"] & {
+        label?: string;
+        description?: string;
+        describedBy?: string;
+        items: QwSelectionItem[];
+        loop: boolean;
+    };
+    context: ZagSchema["context"] & {
+        disabledIds: string[];
+    };
+}
+export type QwRadioGroupMachine = Machine<QwRadioGroupSchema>;
+export type QwRadioGroupService = Service<QwRadioGroupSchema>;
+export interface QwRadioGroupItemProps {
+    value: string;
+}
+export declare function createRadioGroupProps(props: QwRadioGroupProps): Partial<QwRadioGroupSchema["props"]>;
+/** Upstream focus/pointer state with one shared native selection/form lifecycle. */
+export declare const radioGroupMachine: QwRadioGroupMachine;
+export interface QwRadioGroupApi<T extends PropTypes = PropTypes> extends Omit<ReturnType<typeof zagConnect<T>>, "setValue" | "getItemState" | "getItemProps" | "getItemTextProps" | "getItemControlProps" | "getItemHiddenInputProps"> {
+    label: string;
+    description: string;
+    items: QwSelectionItem[];
+    setValue(value: string | null): void;
+    getItemState(item: QwRadioGroupItemProps): ReturnType<ReturnType<typeof zagConnect<T>>["getItemState"]>;
+    getItemProps(item: QwRadioGroupItemProps): T["label"];
+    getItemTextProps(item: QwRadioGroupItemProps): T["element"];
+    getItemControlProps(item: QwRadioGroupItemProps): T["element"];
+    getItemHiddenInputProps(item: QwRadioGroupItemProps): T["input"];
+    getDescriptionProps(): T["element"];
+    getItemDescriptionProps(item: QwRadioGroupItemProps): T["element"];
+}
+export declare function connect<T extends PropTypes>(service: QwRadioGroupService, normalize: NormalizeProps<T>): QwRadioGroupApi<T>;
+export {};

package/dist/radio-group-BOIMuqnS.js

@@ -0,0 +1,230 @@
+import { r as selectionItemKey, t as normalizeSelectionItems } from "./selection-ivXqO1eu.js";
+import { t as mergeDescriptionIds } from "./aria-description-CimD2M_C.js";
+import { n as trackSelectionForm, t as syncSelectionInputs } from "./selection-form-BOM_odUk.js";
+import { getComputedStyle } from "@zag-js/dom-query";
+import { connect, machine } from "@zag-js/radio-group";
+//#region src/radio-group/radio-group.ts
+const normalizeValue = (value) => {
+	if (value == null) return null;
+	if (typeof value !== "string" || !value.length) throw new TypeError("RadioGroup values must be non-empty strings or null");
+	return value;
+};
+function createRadioGroupProps(props) {
+	return {
+		...props,
+		items: normalizeSelectionItems(props.items),
+		defaultValue: normalizeValue(props.defaultValue),
+		value: props.value === void 0 ? void 0 : normalizeValue(props.value),
+		loop: props.loop ?? true
+	};
+}
+const rootId = (scope) => scope.ids?.root ?? `radio-group:${scope.id}`;
+const inputId = (scope, value) => `${rootId(scope)}:radio:input:${selectionItemKey(value)}`;
+function selectionScope(scope) {
+	const id = rootId(scope);
+	const part = (name) => (value) => `${id}:radio:${name}:${selectionItemKey(value)}`;
+	return {
+		...scope,
+		ids: {
+			root: id,
+			label: `${id}:label`,
+			indicator: `${id}:indicator`,
+			item: part("item"),
+			itemLabel: part("label"),
+			itemControl: part("control"),
+			itemHiddenInput: part("input")
+		}
+	};
+}
+function sync(params) {
+	syncSelectionInputs(params.scope, params.prop("items").map((item) => ({
+		id: inputId(params.scope, item.value),
+		checked: params.context.get("value") === item.value
+	})));
+}
+const base = machine;
+/** Upstream focus/pointer state with one shared native selection/form lifecycle. */
+const radioGroupMachine = {
+	...base,
+	props(params) {
+		const props = base.props(params);
+		return {
+			...props,
+			items: normalizeSelectionItems(props.items ?? []),
+			defaultValue: normalizeValue(props.defaultValue),
+			value: props.value === void 0 ? void 0 : normalizeValue(props.value),
+			loop: props.loop ?? true
+		};
+	},
+	context(params) {
+		return {
+			...base.context(params),
+			disabledIds: params.bindable(() => ({ defaultValue: [] }))
+		};
+	},
+	implementations: {
+		...base.implementations,
+		effects: {
+			...base.implementations?.effects,
+			trackFormControlState(params) {
+				return trackSelectionForm({
+					scope: params.scope,
+					rootId: rootId(params.scope),
+					form: () => params.prop("form"),
+					getState: () => params.prop("items").map((item) => ({
+						id: inputId(params.scope, item.value),
+						checked: params.context.get("value") === item.value
+					})),
+					onReset: () => params.context.set("value", normalizeValue(params.prop("defaultValue"))),
+					onDisabledChange: (ids) => {
+						params.context.set("disabledIds", [...ids]);
+						params.context.set("fieldsetDisabled", params.prop("items").length > 0 && params.prop("items").every((item) => ids.includes(inputId(params.scope, item.value))));
+					}
+				}).stop;
+			}
+		},
+		actions: {
+			...base.implementations?.actions,
+			syncInputElements: sync,
+			syncIndicatorRect(params) {
+				base.implementations?.actions?.syncIndicatorRect?.({
+					...params,
+					scope: selectionScope(params.scope)
+				});
+			},
+			setValue(params) {
+				const item = params.prop("items").find((item) => item.value === params.event.value);
+				const blocked = params.prop("readOnly") || params.computed("isDisabled") || item?.disabled || params.context.get("disabledIds").includes(inputId(params.scope, params.event.value ?? ""));
+				if (!params.event.isTrusted || !blocked) params.context.set("value", normalizeValue(params.event.value));
+				queueMicrotask(() => sync(params));
+			},
+			dispatchChangeEvent(params) {
+				queueMicrotask(() => sync(params));
+			}
+		}
+	}
+};
+function connect$1(service, normalize) {
+	const api = connect({
+		...service,
+		scope: selectionScope(service.scope)
+	}, normalize);
+	const id = rootId(service.scope);
+	const resolve = ({ value }) => {
+		const item = service.prop("items").find((item) => item.value === value);
+		if (!item) throw new RangeError("RadioGroup item value is not present in items");
+		return item;
+	};
+	const disabled = (item) => !!service.prop("disabled") || !!item.disabled || service.context.get("disabledIds").includes(inputId(service.scope, item.value));
+	const itemProps = (props) => {
+		const item = resolve(props);
+		return {
+			...item,
+			disabled: disabled(item)
+		};
+	};
+	const stable = { "data-ssr": void 0 };
+	const describe = (item) => `${id}:description:${selectionItemKey(item.value)}`;
+	return {
+		...api,
+		label: service.prop("label") ?? "",
+		description: service.prop("description") ?? "",
+		items: service.prop("items").map((item) => ({ ...item })),
+		setValue(value) {
+			service.send({
+				type: "SET_VALUE",
+				value: normalizeValue(value),
+				isTrusted: false
+			});
+		},
+		getRootProps: () => ({
+			...api.getRootProps(),
+			...normalize.element({
+				disabled: !!service.prop("disabled"),
+				form: service.prop("form"),
+				"aria-describedby": mergeDescriptionIds(service.prop("description") ? `${id}:description` : void 0, service.prop("describedBy")),
+				"aria-invalid": service.prop("invalid") || void 0
+			})
+		}),
+		getDescriptionProps: () => normalize.element({
+			id: `${id}:description`,
+			"data-scope": "radio-group",
+			"data-part": "description"
+		}),
+		getItemDescriptionProps: (props) => normalize.element({
+			id: describe(resolve(props)),
+			"data-scope": "radio-group",
+			"data-part": "item-description"
+		}),
+		getItemState: (props) => api.getItemState(itemProps(props)),
+		getItemProps: (props) => ({
+			...api.getItemProps(itemProps(props)),
+			...normalize.label(stable)
+		}),
+		getItemTextProps: (props) => ({
+			...api.getItemTextProps(itemProps(props)),
+			...normalize.element(stable)
+		}),
+		getItemControlProps: (props) => ({
+			...api.getItemControlProps(itemProps(props)),
+			...normalize.element(stable)
+		}),
+		getItemHiddenInputProps(props) {
+			const item = resolve(props);
+			const input = { ...api.getItemHiddenInputProps(itemProps(props)) };
+			delete input.defaultChecked;
+			const originalKeyDown = input.onKeyDown;
+			return {
+				...input,
+				...normalize.input({
+					checked: service.context.get("value") === item.value,
+					disabled: !!service.prop("disabled") || !!item.disabled,
+					name: disabled(item) ? void 0 : service.prop("name") || service.scope.id,
+					readOnly: !!service.prop("readOnly"),
+					"data-scope": "radio-group",
+					"data-part": "input",
+					"aria-checked": service.context.get("value") === item.value,
+					"aria-describedby": item.description ? describe(item) : void 0,
+					onChange() {},
+					onClick(event) {
+						if (disabled(item) || service.prop("readOnly")) event.preventDefault();
+						else service.send({
+							type: "SET_VALUE",
+							value: item.value,
+							isTrusted: true
+						});
+						queueMicrotask(() => sync(service));
+					},
+					onKeyDown(event) {
+						if (event.defaultPrevented) return;
+						const arrow = [
+							"ArrowLeft",
+							"ArrowRight",
+							"ArrowUp",
+							"ArrowDown"
+						].includes(event.key);
+						if ((disabled(item) || service.prop("readOnly")) && (arrow || event.key === " ")) {
+							event.preventDefault();
+							return;
+						}
+						if (arrow && !service.prop("loop")) {
+							const rtl = (service.prop("dir") ?? getComputedStyle(event.currentTarget).direction) === "rtl";
+							const delta = event.key === "ArrowDown" ? 1 : event.key === "ArrowUp" ? -1 : event.key === "ArrowRight" ? rtl ? -1 : 1 : rtl ? 1 : -1;
+							const enabled = service.prop("items").filter((item) => !disabled(item));
+							const index = enabled.findIndex((entry) => entry.value === item.value);
+							if (index + delta < 0 || index + delta >= enabled.length) {
+								event.preventDefault();
+								return;
+							}
+						}
+						originalKeyDown?.(event);
+					}
+				})
+			};
+		}
+	};
+}
+//#endregion
+export { createRadioGroupProps as n, radioGroupMachine as r, connect$1 as t };
+
+//# sourceMappingURL=radio-group-BOIMuqnS.js.map

package/dist/radio-group-BOIMuqnS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio-group-BOIMuqnS.js","names":["zagMachine","connect","zagConnect"],"sources":["../src/radio-group/radio-group.ts"],"sourcesContent":["import { mergeDescriptionIds } from \"../aria-description.js\";\nimport { machine as zagMachine, connect as zagConnect, type Machine as ZagMachine } from \"@zag-js/radio-group\";\nimport type { Machine, Params, Service } from \"@zag-js/core\";\nimport { getComputedStyle } from \"@zag-js/dom-query\";\nimport type { NormalizeProps, PropTypes } from \"@zag-js/types\";\nimport { normalizeSelectionItems, selectionItemKey, type QwSelectionItem } from \"../selection.js\";\nimport { syncSelectionInputs, trackSelectionForm } from \"../selection-form.js\";\n\nexport interface QwRadioGroupProps {\n  /** Stable instance id; adapters generate an SSR-safe id when omitted. */\n  id?: string;\n  /** Accessible group name rendered as the native fieldset legend. */\n  label: string;\n  /** Supporting text associated with the group. */\n  description?: string;\n  /** External Field help/error references, merged with the control-owned description. */\n  describedBy?: string;\n  /** Ordered options with unique non-empty values. */\n  items: QwSelectionItem[];\n  /** Controlled value; explicit null means no selection. Unknown strings are retained. */\n  value?: string | null;\n  /** Initial selection and form reset target; defaults to null. */\n  defaultValue?: string | null;\n  /** Disable the group and exclude its inputs from native submission. */\n  disabled?: boolean;\n  /** Prevent user changes while retaining focus and submission. */\n  readOnly?: boolean;\n  /** Require one enabled rendered choice through native radio validation. */\n  required?: boolean;\n  /** Expose error semantics; the owner supplies error text. */\n  invalid?: boolean;\n  /** Native group field name; defaults to the instance id. Use a unique explicit name for forms. */\n  name?: string;\n  /** Associate every input with an external form id. */\n  form?: string;\n  /** Visual layout; defaults to vertical. Native arrows work in either layout. */\n  orientation?: \"vertical\" | \"horizontal\";\n  /** Layout direction; omitted direction inherits from the native input. */\n  dir?: \"ltr\" | \"rtl\";\n  /** Allow native arrow navigation to wrap around; defaults to true. */\n  loop?: boolean;\n  /** Value update request, including reset to the declared default. */\n  onValueChange?: (details: { value: string | null }) => void;\n}\ntype ZagSchema = ZagMachine extends Machine<infer S> ? S : never;\nexport interface QwRadioGroupSchema extends ZagSchema {\n  props: ZagSchema[\"props\"] & { label?: string; description?: string; describedBy?: string; items: QwSelectionItem[]; loop: boolean };\n  context: ZagSchema[\"context\"] & { disabledIds: string[] };\n}\nexport type QwRadioGroupMachine = Machine<QwRadioGroupSchema>;\nexport type QwRadioGroupService = Service<QwRadioGroupSchema>;\nexport interface QwRadioGroupItemProps { value: string }\nconst normalizeValue = (value: string | null | undefined): string | null => {\n  if (value == null) return null;\n  if (typeof value !== \"string\" || !value.length) throw new TypeError(\"RadioGroup values must be non-empty strings or null\");\n  return value;\n};\nexport function createRadioGroupProps(props: QwRadioGroupProps): Partial<QwRadioGroupSchema[\"props\"]> {\n  return { ...props, items: normalizeSelectionItems(props.items), defaultValue: normalizeValue(props.defaultValue), value: props.value === undefined ? undefined : normalizeValue(props.value), loop: props.loop ?? true };\n}\nconst rootId = (scope: QwRadioGroupService[\"scope\"]) => scope.ids?.root ?? `radio-group:${scope.id}`;\nconst inputId = (scope: QwRadioGroupService[\"scope\"], value: string) => `${rootId(scope)}:radio:input:${selectionItemKey(value)}`;\nfunction selectionScope(scope: QwRadioGroupService[\"scope\"]): QwRadioGroupService[\"scope\"] {\n  const id = rootId(scope);\n  const part = (name: string) => (value: string) => `${id}:radio:${name}:${selectionItemKey(value)}`;\n  return { ...scope, ids: { root: id, label: `${id}:label`, indicator: `${id}:indicator`, item: part(\"item\"), itemLabel: part(\"label\"), itemControl: part(\"control\"), itemHiddenInput: part(\"input\") } };\n}\ntype GroupParams = Pick<Params<QwRadioGroupSchema>, \"scope\" | \"context\" | \"prop\">;\nfunction sync(params: GroupParams) {\n  syncSelectionInputs(params.scope, params.prop(\"items\").map(item => ({ id: inputId(params.scope, item.value), checked: params.context.get(\"value\") === item.value })));\n}\n// The wrapper preserves every upstream field and adds Core selection metadata.\nconst base = zagMachine as unknown as QwRadioGroupMachine;\n/** Upstream focus/pointer state with one shared native selection/form lifecycle. */\nexport const radioGroupMachine: QwRadioGroupMachine = {\n  ...base,\n  props(params) {\n    const props = base.props!(params);\n    return { ...props, items: normalizeSelectionItems(props.items ?? []), defaultValue: normalizeValue(props.defaultValue), value: props.value === undefined ? undefined : normalizeValue(props.value), loop: props.loop ?? true,\n    };\n  },\n  context(params) { return { ...base.context!(params), disabledIds: params.bindable<string[]>(() => ({ defaultValue: [] })) }; },\n  implementations: {\n    ...base.implementations,\n    effects: { ...base.implementations?.effects,\n      trackFormControlState(params) {\n        const tracker = trackSelectionForm({ scope: params.scope, rootId: rootId(params.scope), form: () => params.prop(\"form\"),\n          getState: () => params.prop(\"items\").map(item => ({ id: inputId(params.scope, item.value), checked: params.context.get(\"value\") === item.value })),\n          onReset: () => params.context.set(\"value\", normalizeValue(params.prop(\"defaultValue\"))),\n          onDisabledChange: ids => { params.context.set(\"disabledIds\", [...ids]); params.context.set(\"fieldsetDisabled\", params.prop(\"items\").length > 0 && params.prop(\"items\").every(item => ids.includes(inputId(params.scope, item.value)))); },\n        }); return tracker.stop;\n      },\n    },\n    actions: { ...base.implementations?.actions, syncInputElements: sync,\n      syncIndicatorRect(params) { base.implementations?.actions?.syncIndicatorRect?.({ ...params, scope: selectionScope(params.scope) }); },\n      setValue(params) {\n        const item = params.prop(\"items\").find(item => item.value === params.event.value);\n        const blocked = params.prop(\"readOnly\") || params.computed(\"isDisabled\") || item?.disabled || params.context.get(\"disabledIds\").includes(inputId(params.scope, params.event.value ?? \"\"));\n        if (!params.event.isTrusted || !blocked) params.context.set(\"value\", normalizeValue(params.event.value));\n        queueMicrotask(() => sync(params));\n      },\n      // The final property sync owns native state; programmatic updates do not reenter click handlers.\n      dispatchChangeEvent(params) { queueMicrotask(() => sync(params)); },\n    },\n  },\n};\nexport interface QwRadioGroupApi<T extends PropTypes = PropTypes> extends Omit<ReturnType<typeof zagConnect<T>>, \"setValue\" | \"getItemState\" | \"getItemProps\" | \"getItemTextProps\" | \"getItemControlProps\" | \"getItemHiddenInputProps\"> {\n  label: string; description: string; items: QwSelectionItem[];\n  setValue(value: string | null): void;\n  getItemState(item: QwRadioGroupItemProps): ReturnType<ReturnType<typeof zagConnect<T>>[\"getItemState\"]>;\n  getItemProps(item: QwRadioGroupItemProps): T[\"label\"];\n  getItemTextProps(item: QwRadioGroupItemProps): T[\"element\"];\n  getItemControlProps(item: QwRadioGroupItemProps): T[\"element\"];\n  getItemHiddenInputProps(item: QwRadioGroupItemProps): T[\"input\"];\n  getDescriptionProps(): T[\"element\"];\n  getItemDescriptionProps(item: QwRadioGroupItemProps): T[\"element\"];\n}\nexport function connect<T extends PropTypes>(service: QwRadioGroupService, normalize: NormalizeProps<T>): QwRadioGroupApi<T> {\n  const zagService = { ...service, scope: selectionScope(service.scope) } as unknown as Service<ZagSchema>;\n  const api = zagConnect(zagService, normalize);\n  const id = rootId(service.scope);\n  const resolve = ({ value }: QwRadioGroupItemProps) => { const item = service.prop(\"items\").find(item => item.value === value); if (!item) throw new RangeError(\"RadioGroup item value is not present in items\"); return item; };\n  const disabled = (item: QwSelectionItem) => !!service.prop(\"disabled\") || !!item.disabled || service.context.get(\"disabledIds\").includes(inputId(service.scope, item.value));\n  const itemProps = (props: QwRadioGroupItemProps) => { const item = resolve(props); return { ...item, disabled: disabled(item) }; };\n  const stable = { \"data-ssr\": undefined };\n  const describe = (item: QwSelectionItem) => `${id}:description:${selectionItemKey(item.value)}`;\n  return { ...api, label: service.prop(\"label\") ?? \"\", description: service.prop(\"description\") ?? \"\", items: service.prop(\"items\").map(item => ({ ...item })),\n    setValue(value) { service.send({ type: \"SET_VALUE\", value: normalizeValue(value), isTrusted: false }); },\n    getRootProps: () => ({ ...api.getRootProps(), ...normalize.element({ disabled: !!service.prop(\"disabled\"), form: service.prop(\"form\"), \"aria-describedby\": mergeDescriptionIds(service.prop(\"description\") ? `${id}:description` : undefined, service.prop(\"describedBy\")), \"aria-invalid\": service.prop(\"invalid\") || undefined }) }),\n    getDescriptionProps: () => normalize.element({ id: `${id}:description`, \"data-scope\": \"radio-group\", \"data-part\": \"description\" }),\n    getItemDescriptionProps: props => normalize.element({ id: describe(resolve(props)), \"data-scope\": \"radio-group\", \"data-part\": \"item-description\" }),\n    getItemState: props => api.getItemState(itemProps(props)),\n    getItemProps: props => ({ ...api.getItemProps(itemProps(props)), ...normalize.label(stable) }),\n    getItemTextProps: props => ({ ...api.getItemTextProps(itemProps(props)), ...normalize.element(stable) }),\n    getItemControlProps: props => ({ ...api.getItemControlProps(itemProps(props)), ...normalize.element(stable) }),\n    getItemHiddenInputProps(props) {\n      const item = resolve(props); const input = { ...api.getItemHiddenInputProps(itemProps(props)) }; delete input.defaultChecked;\n      const originalKeyDown = input.onKeyDown;\n      return { ...input, ...normalize.input({ checked: service.context.get(\"value\") === item.value, disabled: !!service.prop(\"disabled\") || !!item.disabled,\n        // Disabled selected radios must not satisfy required for the enabled group.\n        name: disabled(item) ? undefined : service.prop(\"name\") || service.scope.id, readOnly: !!service.prop(\"readOnly\"),\n        \"data-scope\": \"radio-group\", \"data-part\": \"input\", \"aria-checked\": service.context.get(\"value\") === item.value,\n        \"aria-describedby\": item.description ? describe(item) : undefined, onChange() {},\n        onClick(event) {\n          if (disabled(item) || service.prop(\"readOnly\")) event.preventDefault();\n          else service.send({ type: \"SET_VALUE\", value: item.value, isTrusted: true });\n          queueMicrotask(() => sync(service));\n        },\n        onKeyDown(event) {\n          if (event.defaultPrevented) return;\n          const arrow = [\"ArrowLeft\", \"ArrowRight\", \"ArrowUp\", \"ArrowDown\"].includes(event.key);\n          if ((disabled(item) || service.prop(\"readOnly\")) && (arrow || event.key === \" \")) { event.preventDefault(); return; }\n          if (arrow && !service.prop(\"loop\")) {\n            const rtl = (service.prop(\"dir\") ?? getComputedStyle(event.currentTarget).direction) === \"rtl\";\n            const delta = event.key === \"ArrowDown\" ? 1 : event.key === \"ArrowUp\" ? -1 : event.key === \"ArrowRight\" ? (rtl ? -1 : 1) : (rtl ? 1 : -1);\n            const enabled = service.prop(\"items\").filter(item => !disabled(item)); const index = enabled.findIndex(entry => entry.value === item.value);\n            if (index + delta < 0 || index + delta >= enabled.length) { event.preventDefault(); return; }\n          }\n          originalKeyDown?.(event);\n        },\n      }) };\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/rate/index.d.ts

@@ -0,0 +1 @@
+export * from "./rate.js";

package/dist/rate/index.js

@@ -0,0 +1,2 @@
+import { a as getRatePointValue, c as rateMachine, i as createRateProps, l as rateTouchCoverageForGlyphFill, n as RATE_SIZES, o as normalizeRateCount, r as connect, s as normalizeRateValue, t as RATE_PARTS } from "../rate-5XsU2QkY.js";
+export { RATE_PARTS, RATE_SIZES, connect, createRateProps, getRatePointValue, normalizeRateCount, normalizeRateValue, rateMachine, rateTouchCoverageForGlyphFill };

package/dist/rate/rate-form.d.ts

@@ -0,0 +1,28 @@
+import type { SelectionFormScope } from "../selection-form.js";
+export interface RateProxyConstraints {
+    required: boolean;
+    /** Authoritative disabled prop only. Fieldset disabling stays a native :disabled match. */
+    disabled: boolean;
+    min: string;
+    max: string;
+    step: string;
+}
+export interface RateFormOptions {
+    scope: SelectionFormScope;
+    inputId: string;
+    rootId: string;
+    current(): string;
+    initial(): string;
+    constraints(): RateProxyConstraints;
+    onReset(): void;
+    onDisabledChange(disabled: boolean): void;
+}
+/**
+ * The value content attribute and the value property are the same effective form string.
+ * HTML reset reads that attribute, so defaultValue must not be a different initial string.
+ * A connected reset still requests the declared default through onReset, then syncs again.
+ * Read-only is intentionally not copied onto the proxy.
+ */
+export declare function syncRateInput(options: Pick<RateFormOptions, "scope" | "inputId" | "current" | "initial" | "constraints">): void;
+/** Actual form ownership, cancellation and native fieldset disabled rules are tracked in Core. */
+export declare function trackRateForm(options: RateFormOptions): () => void;

package/dist/rate/rate.d.ts

@@ -0,0 +1,144 @@
+import { type Machine, type Service } from "@zag-js/core";
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
+import { type IconNameInput, type IconState } from "../icon/index.js";
+export declare const RATE_SIZES: readonly ["sm", "md", "lg"];
+export declare const RATE_PARTS: readonly ["root", "label", "description", "control", "item", "empty-icon", "filled-icon", "input", "clear", "content"];
+export type RateSize = (typeof RATE_SIZES)[number];
+export type RatePart = (typeof RATE_PARTS)[number];
+export interface RateValueChangeDetails {
+    value: number;
+}
+export interface RatePreviewChangeDetails {
+    value: number | null;
+}
+export interface QwRateProps {
+    id?: string;
+    /** Nonempty visible accessible rating label. */
+    label: string;
+    description?: string;
+    /** Defined raw finite model is controlled; effective display/submission is derived. */
+    value?: number;
+    /** Initial/reset raw model; defaults zero. */
+    defaultValue?: number;
+    /** Positive safe integer 1–1000; invalid values use five. */
+    count?: number;
+    allowHalf?: boolean;
+    /** Repeated pointer tap/explicit clear only; slider Home remains zero. */
+    allowClear?: boolean;
+    disabled?: boolean;
+    readOnly?: boolean;
+    required?: boolean;
+    invalid?: boolean;
+    name?: string;
+    form?: string;
+    dir?: string;
+    touchable?: boolean;
+    size?: RateSize;
+    iconName?: IconNameInput;
+    emptyIconName?: IconNameInput;
+    /** Scalar glyph text instead of system icons; never clones caller DOM nodes. */
+    character?: string;
+    /** Explicit accessible scale text, using {value}/{count}. */
+    valueTextTemplate?: string;
+    clearLabel?: string;
+    onValueChange?: (details: RateValueChangeDetails) => void;
+    onPreviewChange?: (details: RatePreviewChangeDetails) => void;
+}
+export declare function normalizeRateCount(count: number | undefined): number;
+export declare function normalizeRateValue(value: number | undefined, count?: number, allowHalf?: boolean, readOnly?: boolean): number;
+export interface RateItemRect {
+    left: number;
+    right: number;
+}
+/** Logical item geometry includes gaps; midpoint and gap ties prefer the preceding half/item. */
+export declare function getRatePointValue(x: number, rects: readonly RateItemRect[], allowHalf: boolean, dir: "ltr" | "rtl"): number | null;
+/**
+ * Width of the touch target, measured from its inline start, that reaches `fill` of a centered glyph.
+ * Half often matches by centering; other fractions do not. Rendering must clip the glyph box instead.
+ */
+export declare function rateTouchCoverageForGlyphFill(fill: number, touch: number, glyph: number): number;
+export interface QwRateSchema {
+    props: QwRateProps & {
+        count: number;
+        defaultValue: number;
+        allowHalf: boolean;
+        allowClear: boolean;
+        touchable: boolean;
+        size: RateSize;
+        valueTextTemplate: string;
+        clearLabel: string;
+    };
+    context: {
+        value: number;
+        previewValue: number | null;
+        focused: boolean;
+        pointerId: number | null;
+        startX: number;
+        startY: number;
+        moved: boolean;
+        inheritedDisabled: boolean;
+        validationError: boolean;
+    };
+    state: "ready" | "dragging";
+    guard: "canInteract";
+    action: "setValue" | "setPreview" | "startPointer" | "movePointer" | "commitPointer" | "cancelPointer" | "setFocus" | "setDisabled" | "resetForm" | "markInvalid" | "syncInput";
+    effect: "trackForm" | "capturePointer";
+    event: {
+        type: "VALUE.SET";
+        value: number;
+    } | {
+        type: "PREVIEW.SET";
+        value: number | null;
+    } | {
+        type: "POINTER.START" | "POINTER.MOVE" | "POINTER.END";
+        pointerId: number;
+        x: number;
+        y: number;
+        value: number;
+        touch: boolean;
+    } | {
+        type: "POINTER.CANCEL";
+        pointerId?: number;
+        captureLost?: boolean;
+    } | {
+        type: "DOMAIN.CHANGED" | "FORM.RESET" | "INVALID";
+    } | {
+        type: "FOCUS.SET" | "DISABLED.SET";
+        value: boolean;
+    };
+}
+export type QwRateMachine = Machine<QwRateSchema>;
+export type QwRateService = Service<QwRateSchema>;
+export declare function createRateProps(props: QwRateProps): Partial<QwRateSchema["props"]>;
+/** One bindable owns raw models; mode/domain changes derive values without fake change callbacks. */
+export declare const rateMachine: QwRateMachine;
+export interface RateItem {
+    index: number;
+    fill: number;
+    state: "empty" | "half" | "full";
+}
+export interface QwRateApi<T extends PropTypes = PropTypes> {
+    value: number;
+    effectiveValue: number;
+    previewValue: number | null;
+    displayValue: number;
+    label: string;
+    description: string;
+    clearLabel: string;
+    character?: string;
+    items: RateItem[];
+    setValue(value: number): void;
+    setPreviewValue(value: number | null): void;
+    getRootProps(): T["element"];
+    getLabelProps(): T["element"];
+    getDescriptionProps(): T["element"];
+    getControlProps(): T["element"];
+    getItemProps(item: Pick<RateItem, "index">): T["element"];
+    getEmptyIconProps(item: Pick<RateItem, "index">): T["element"];
+    getFilledIconProps(item: Pick<RateItem, "index">): T["element"];
+    getItemIconState(item: Pick<RateItem, "index">, filled: boolean): IconState;
+    getInputProps(): T["input"];
+    getClearProps(): T["button"];
+    getContentProps(): T["element"];
+}
+export declare function connect<T extends PropTypes>(service: QwRateService, normalize: NormalizeProps<T>): QwRateApi<T>;