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

package/dist/segmented-BaU38_L4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segmented-BaU38_L4.js","names":[],"sources":["../src/segmented/segmented.ts"],"sourcesContent":["import { mergeDescriptionIds } from \"../aria-description.js\";\nimport { createMachine, type Machine, type Params, type Service } from \"@zag-js/core\";\nimport { dataAttr, getComputedStyle, getEventKey, visuallyHiddenStyle } from \"@zag-js/dom-query\";\nimport type { NormalizeProps, PropTypes } from \"@zag-js/types\";\nimport { normalizeSelectionItems, normalizeSelectionValue, selectionItemKey, toggleSelectionValue, type QwSelectionItem } from \"../selection.js\";\nimport { syncSelectionInputs, trackSelectionForm } from \"../selection-form.js\";\nimport { resolveIconState, type IconNameInput, type IconState } from \"../icon/index.js\";\n\n/** Supported single/multiple selection modes. */\nexport const SEGMENTED_MODES = [\"single\", \"multiple\"] as const;\n/** Existing T3 control-height sizes; large is the mobile default. */\nexport const SEGMENTED_SIZES = [\"sm\", \"md\", \"lg\"] as const;\n/** Stable DOM parts shared by every adapter. */\nexport const SEGMENTED_PARTS = [\"root\", \"label\", \"description\", \"items\", \"item\", \"input\", \"content\", \"icon\", \"text\", \"item-description\"] as const;\nexport type SegmentedSelectionMode = (typeof SEGMENTED_MODES)[number];\nexport type SegmentedSize = (typeof SEGMENTED_SIZES)[number];\n/** Accessible option name remains required even in icon-only presentation. */\nexport interface QwSegmentedItem extends QwSelectionItem { icon?: IconNameInput; iconOnly?: boolean }\n/** Requested ordered values; callers receive independent snapshots. */\nexport interface SegmentedValueChangeDetails { value: string[] }\n/** SSR-safe input shared by all adapters. */\nexport interface QwSegmentedProps {\n  id?: string;\n  /** Visible, nonempty accessible group name rendered as legend. */\n  label: string;\n  description?: string;\n  /** External Field help/error references, merged with the control-owned description. */\n  describedBy?: string;\n  /** Unique nonempty values and nonempty accessible labels. */\n  items: QwSegmentedItem[];\n  selectionMode?: SegmentedSelectionMode;\n  /** Defined arrays, including [], are controlled. Unknown values are retained. */\n  value?: string[];\n  /** Initial value and form reset target; defaults to []. */\n  defaultValue?: string[];\n  /** Allow a selected single item to toggle off; defaults false. */\n  allowEmpty?: boolean;\n  /** Minimum/maximum apply only to multiple-mode user removals/additions. */\n  min?: number;\n  max?: number;\n  disabled?: boolean;\n  /** Block user selection while retaining focus and native submitted values. */\n  readOnly?: boolean;\n  /** Native form validation requires an enabled rendered selection. */\n  required?: boolean;\n  invalid?: boolean;\n  name?: string;\n  form?: string;\n  orientation?: \"horizontal\" | \"vertical\";\n  /** Standard HTML direction; auto/empty inherit the input's direction. */\n  dir?: string;\n  /** Keyboard navigation wraps by default. */\n  loop?: boolean;\n  /** Single-mode arrow/Home/End selection; defaults true. Multiple only focuses. */\n  selectOnFocus?: boolean;\n  size?: SegmentedSize;\n  block?: boolean;\n  /** Horizontal content scrolls with intrinsic option widths. */\n  scrollable?: boolean;\n  onValueChange?: (details: SegmentedValueChangeDetails) => void;\n}\nexport interface QwSegmentedSchema {\n  props: QwSegmentedProps & { selectionMode: SegmentedSelectionMode; defaultValue: string[]; orientation: \"horizontal\" | \"vertical\"; loop: boolean; selectOnFocus: boolean; size: SegmentedSize };\n  context: { value: string[]; focusedValue: string | null; disabledIds: string[] };\n  state: \"ready\";\n  action: \"setValue\" | \"toggleValue\" | \"selectValue\" | \"setFocus\" | \"syncInputs\" | \"normalizeMode\";\n  effect: \"trackForm\";\n  event: { type: \"VALUE.SET\"; value: string[] } | { type: \"VALUE.TOGGLE\" | \"VALUE.SELECT\" | \"FOCUS\"; value: string };\n}\nexport type QwSegmentedMachine = Machine<QwSegmentedSchema>;\nexport type QwSegmentedService = Service<QwSegmentedSchema>;\nexport interface QwSegmentedItemProps { value: string }\nexport interface QwSegmentedItemState { selected: boolean; disabled: boolean; readOnly: boolean; iconOnly: boolean }\n\n/** Validate accessible identities and copy every caller option. */\nexport function normalizeSegmentedItems(items: readonly QwSegmentedItem[]): QwSegmentedItem[] {\n  return normalizeSelectionItems(items).map((entry) => {\n    const item = entry as QwSegmentedItem;\n    if (typeof item.label !== \"string\" || !item.label.trim()) throw new TypeError(\"Segmented item labels must be nonempty accessible text\");\n    if (item.icon !== undefined && typeof item.icon !== \"string\") throw new TypeError(\"Segmented icons must be system icon names\");\n    if (item.iconOnly && !item.icon?.trim()) throw new TypeError(\"Segmented icon-only items require an icon and accessible label\");\n    return { ...item };\n  });\n}\n/** Single selection retains the earliest unique caller value, including unknowns. */\nexport function normalizeSegmentedValue(value: readonly string[] = [], mode: SegmentedSelectionMode = \"single\"): string[] {\n  const values = normalizeSelectionValue(value);\n  return mode === \"single\" ? values.slice(0, 1) : values;\n}\nexport function createSegmentedProps(props: QwSegmentedProps): Partial<QwSegmentedSchema[\"props\"]> {\n  if (typeof props.label !== \"string\" || !props.label.trim()) throw new TypeError(\"Segmented requires a nonempty accessible group label\");\n  if (props.id !== undefined && (typeof props.id !== \"string\" || !props.id.trim())) throw new TypeError(\"Segmented requires a nonempty instance id when provided\");\n  const selectionMode = SEGMENTED_MODES.includes(props.selectionMode!) ? props.selectionMode! : \"single\";\n  return { ...props, selectionMode, items: normalizeSegmentedItems(props.items), value: props.value === undefined ? undefined : normalizeSegmentedValue(props.value, selectionMode), defaultValue: normalizeSegmentedValue(props.defaultValue, selectionMode),\n    orientation: props.orientation === \"vertical\" ? \"vertical\" : \"horizontal\", loop: props.loop ?? true, selectOnFocus: props.selectOnFocus ?? true, size: SEGMENTED_SIZES.includes(props.size!) ? props.size! : \"md\" };\n}\nconst same = (a: string[], b: string[] | undefined) => !!b && a.length === b.length && a.every((value, index) => value === b[index]);\nconst rootId = (scope: QwSegmentedService[\"scope\"]) => `segmented:${scope.id}`;\nconst inputId = (scope: QwSegmentedService[\"scope\"], value: string) => `${rootId(scope)}:input:${selectionItemKey(value)}`;\ntype GroupParams = Pick<Params<QwSegmentedSchema>, \"scope\" | \"context\" | \"prop\">;\nfunction currentValue(params: GroupParams) { return normalizeSegmentedValue(params.context.get(\"value\"), params.prop(\"selectionMode\")); }\nfunction isDisabled(params: GroupParams, item: QwSegmentedItem) { return !!params.prop(\"disabled\") || !!item.disabled || params.context.get(\"disabledIds\").includes(inputId(params.scope, item.value)); }\nfunction sync(params: GroupParams) {\n  const values = currentValue(params);\n  syncSelectionInputs(params.scope, params.prop(\"items\").map((item) => ({ id: inputId(params.scope, item.value), checked: values.includes(item.value) })));\n}\nfunction changeFor(params: GroupParams, value: string, selectOnly = false): string[] | null {\n  const item = params.prop(\"items\").find((entry) => entry.value === value);\n  if (!item || isDisabled(params, item) || params.prop(\"readOnly\")) return null;\n  const values = currentValue(params);\n  if (params.prop(\"selectionMode\") === \"single\") return values.includes(value) ? (!selectOnly && params.prop(\"allowEmpty\") ? [] : values) : [value];\n  const result = toggleSelectionValue(values, item, { min: params.prop(\"min\"), max: params.prop(\"max\") });\n  return result.blocked ? null : result.value;\n}\n\n/** One Zag bindable lifecycle; Core alone owns selection, keys and native forms. */\nexport const segmentedMachine: QwSegmentedMachine = createMachine<QwSegmentedSchema>({\n  props: ({ props }) => createSegmentedProps({ ...props, label: props.label ?? \"\", items: props.items ?? [] }) as QwSegmentedSchema[\"props\"],\n  initialState: () => \"ready\",\n  context({ prop, bindable }) {\n    return {\n      value: bindable(() => ({ defaultValue: prop(\"defaultValue\"), value: prop(\"value\"), isEqual: same, onChange: (value) => prop(\"onValueChange\")?.({ value: [...value] }) })),\n      focusedValue: bindable(() => ({ defaultValue: null as string | null })),\n      disabledIds: bindable(() => ({ defaultValue: [] as string[], isEqual: same })),\n    };\n  },\n  watch({ track, context, prop, action }) {\n    track([() => context.hash(\"value\"), () => context.hash(\"disabledIds\")], () => action([\"syncInputs\"]));\n    track([() => prop(\"selectionMode\")], () => action([\"normalizeMode\"]));\n  },\n  effects: [\"trackForm\"],\n  on: { \"VALUE.SET\": { actions: [\"setValue\"] }, \"VALUE.TOGGLE\": { actions: [\"toggleValue\"] }, \"VALUE.SELECT\": { actions: [\"selectValue\"] }, FOCUS: { actions: [\"setFocus\"] } },\n  states: { ready: {} },\n  implementations: {\n    effects: { trackForm(params) {\n      return 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: currentValue(params).includes(item.value) })),\n        onReset: () => params.context.set(\"value\", normalizeSegmentedValue(params.prop(\"defaultValue\"), params.prop(\"selectionMode\"))),\n        onDisabledChange: (ids) => params.context.set(\"disabledIds\", [...ids]),\n      }).stop;\n    } },\n    actions: {\n      syncInputs: sync,\n      normalizeMode(params) { params.context.set(\"value\", currentValue(params)); queueMicrotask(() => sync(params)); },\n      setValue(params) { if (params.event.type === \"VALUE.SET\") params.context.set(\"value\", normalizeSegmentedValue(params.event.value, params.prop(\"selectionMode\"))); queueMicrotask(() => sync(params)); },\n      toggleValue(params) { if (params.event.type === \"VALUE.TOGGLE\") { const values = changeFor(params, params.event.value); if (values) params.context.set(\"value\", values); } queueMicrotask(() => sync(params)); },\n      selectValue(params) { if (params.event.type === \"VALUE.SELECT\") { const values = changeFor(params, params.event.value, true); if (values) params.context.set(\"value\", values); } queueMicrotask(() => sync(params)); },\n      setFocus(params) { if (params.event.type === \"FOCUS\") params.context.set(\"focusedValue\", params.event.value); },\n    },\n  },\n});\n\nexport interface QwSegmentedApi<T extends PropTypes = PropTypes> {\n  value: string[]; items: QwSegmentedItem[]; label: string; description: string;\n  setValue(value: string[]): void;\n  toggleValue(value: string): void;\n  getRootProps(): T[\"element\"];\n  getLabelProps(): T[\"element\"];\n  getDescriptionProps(): T[\"element\"];\n  getItemsProps(): T[\"element\"];\n  getItemState(item: QwSegmentedItemProps): QwSegmentedItemState;\n  getItemProps(item: QwSegmentedItemProps): T[\"label\"];\n  getInputProps(item: QwSegmentedItemProps): T[\"input\"];\n  getContentProps(item: QwSegmentedItemProps): T[\"element\"];\n  getItemIconProps(item: QwSegmentedItemProps): T[\"element\"];\n  getItemIconState(item: QwSegmentedItemProps): IconState;\n  getTextProps(item: QwSegmentedItemProps): T[\"element\"];\n  getItemDescriptionProps(item: QwSegmentedItemProps): T[\"element\"];\n}\n/** Getters are SSR-pure; only client events/effects use the existing Zag DOM scope. */\nexport function connect<T extends PropTypes>(service: QwSegmentedService, normalize: NormalizeProps<T>): QwSegmentedApi<T> {\n  const id = rootId(service.scope), values = currentValue(service), items = service.prop(\"items\");\n  const single = service.prop(\"selectionMode\") === \"single\";\n  const enabled = items.filter((item) => !isDisabled(service, item));\n  const focused = service.context.get(\"focusedValue\");\n  const tabAnchor = enabled.find((item) => item.value === focused) ?? enabled.find((item) => values.includes(item.value)) ?? enabled[0];\n  const requiredAnchor = service.prop(\"required\") && !enabled.some((item) => values.includes(item.value)) ? enabled[0]?.value : undefined;\n  const resolve = ({ value }: QwSegmentedItemProps) => { const item = items.find((entry) => entry.value === value); if (!item) throw new RangeError(\"Segmented item is not present in items\"); return item; };\n  const part = (name: string) => ({ \"data-scope\": \"segmented\", \"data-part\": name });\n  const data = (item: QwSegmentedItem) => ({ \"data-state\": values.includes(item.value) ? \"checked\" : \"unchecked\", \"data-disabled\": dataAttr(isDisabled(service, item)), \"data-readonly\": dataAttr(service.prop(\"readOnly\")), \"data-invalid\": dataAttr(service.prop(\"invalid\")), \"data-icon-only\": dataAttr(item.iconOnly) });\n  return {\n    value: [...values], items: items.map((item) => ({ ...item })), label: service.prop(\"label\"), description: service.prop(\"description\") ?? \"\",\n    setValue: (value) => service.send({ type: \"VALUE.SET\", value: normalizeSegmentedValue(value, service.prop(\"selectionMode\")) }),\n    toggleValue: (value) => service.send({ type: \"VALUE.TOGGLE\", value }),\n    getRootProps: () => normalize.element({ ...part(\"root\"), id, role: single ? \"radiogroup\" : \"group\", disabled: !!service.prop(\"disabled\"), form: service.prop(\"form\"), dir: service.prop(\"dir\"),\n      \"aria-labelledby\": `${id}:label`, \"aria-describedby\": mergeDescriptionIds(service.prop(\"description\") ? `${id}:description` : undefined, service.prop(\"describedBy\")),\n      \"aria-required\": single && service.prop(\"required\") || undefined, \"aria-readonly\": single && service.prop(\"readOnly\") || undefined,\n      \"aria-disabled\": service.prop(\"disabled\") || (items.length > 0 && !enabled.length) || undefined, \"aria-invalid\": service.prop(\"invalid\") || undefined,\n      \"data-selection-mode\": service.prop(\"selectionMode\"), \"data-orientation\": service.prop(\"orientation\"), \"data-size\": service.prop(\"size\"),\n      \"data-block\": dataAttr(service.prop(\"block\")), \"data-scrollable\": dataAttr(service.prop(\"scrollable\")), \"data-disabled\": dataAttr(service.prop(\"disabled\")), \"data-readonly\": dataAttr(service.prop(\"readOnly\")), \"data-invalid\": dataAttr(service.prop(\"invalid\")) }),\n    getLabelProps: () => normalize.element({ ...part(\"label\"), id: `${id}:label` }),\n    getDescriptionProps: () => normalize.element({ ...part(\"description\"), id: `${id}:description` }),\n    getItemsProps: () => normalize.element(part(\"items\")),\n    getItemState: (props) => { const item = resolve(props); return { selected: values.includes(item.value), disabled: isDisabled(service, item), readOnly: !!service.prop(\"readOnly\"), iconOnly: !!item.iconOnly }; },\n    getItemProps: (props) => { const item = resolve(props); return normalize.label({ ...part(\"item\"), ...data(item), htmlFor: inputId(service.scope, item.value) }); },\n    getInputProps(props) {\n      const item = resolve(props), disabled = isDisabled(service, item);\n      return normalize.input({ ...part(\"input\"), ...data(item), id: inputId(service.scope, item.value), type: single ? \"radio\" : \"checkbox\", value: item.value,\n        checked: values.includes(item.value), disabled: !!service.prop(\"disabled\") || !!item.disabled, readOnly: !!service.prop(\"readOnly\"),\n        name: disabled ? undefined : service.prop(\"name\") || (single ? service.scope.id : undefined), form: service.prop(\"form\"),\n        required: single ? !!service.prop(\"required\") && !disabled : requiredAnchor === item.value, tabIndex: single ? (tabAnchor?.value === item.value ? 0 : -1) : 0,\n        \"aria-checked\": values.includes(item.value), \"aria-readonly\": !single && service.prop(\"readOnly\") || undefined, \"aria-invalid\": service.prop(\"invalid\") || undefined,\n        \"aria-labelledby\": `${id}:text:${selectionItemKey(item.value)}`, \"aria-describedby\": item.description ? `${id}:description:${selectionItemKey(item.value)}` : undefined,\n        style: visuallyHiddenStyle, onChange() {},\n        onFocus() { service.send({ type: \"FOCUS\", value: item.value }); },\n        onClick(event) {\n          if (event.defaultPrevented) return;\n          if (!changeFor(service, item.value)) event.preventDefault();\n          service.send({ type: \"VALUE.TOGGLE\", value: item.value }); queueMicrotask(() => sync(service));\n        },\n        onKeyDown(event) {\n          if (event.defaultPrevented || event.ctrlKey || event.altKey || event.metaKey) return;\n          if (event.key === \" \" || event.key === \"Enter\") { event.preventDefault(); if (!event.repeat) service.send({ type: \"VALUE.TOGGLE\", value: item.value }); queueMicrotask(() => sync(service)); return; }\n          if (![\"ArrowLeft\", \"ArrowRight\", \"ArrowUp\", \"ArrowDown\", \"Home\", \"End\"].includes(event.key)) return;\n          event.preventDefault();\n          const candidates = service.prop(\"items\").filter((entry) => !isDisabled(service, entry));\n          if (!candidates.length || isDisabled(service, item)) return;\n          const direction = service.prop(\"dir\");\n          const dir = direction === \"rtl\" || direction === \"ltr\" ? direction : getComputedStyle(event.currentTarget).direction === \"rtl\" ? \"rtl\" : \"ltr\";\n          const key = getEventKey(event, { dir }), index = candidates.findIndex((entry) => entry.value === item.value);\n          let target = key === \"Home\" ? 0 : key === \"End\" ? candidates.length - 1 : index + (key === \"ArrowRight\" || key === \"ArrowDown\" ? 1 : -1);\n          if (service.prop(\"loop\")) target = (target + candidates.length) % candidates.length;\n          const next = candidates[target]; if (!next) return;\n          service.scope.getById<HTMLInputElement>(inputId(service.scope, next.value))?.focus();\n          service.send({ type: \"FOCUS\", value: next.value });\n          if (service.prop(\"selectionMode\") === \"single\" && service.prop(\"selectOnFocus\")) service.send({ type: \"VALUE.SELECT\", value: next.value });\n        },\n      });\n    },\n    getContentProps: (props) => normalize.element({ ...part(\"content\"), ...data(resolve(props)) }),\n    getItemIconProps: (props) => { const item = resolve(props); return normalize.element({ ...part(\"icon\"), hidden: !item.icon, \"aria-hidden\": true }); },\n    getItemIconState: (props) => { const item = resolve(props); return resolveIconState({ id: `${id}:icon:${selectionItemKey(item.value)}`, name: item.icon || \"component\" }); },\n    getTextProps: (props) => { const item = resolve(props); return normalize.element({ ...part(\"text\"), id: `${id}:text:${selectionItemKey(item.value)}`, style: item.iconOnly ? visuallyHiddenStyle : undefined }); },\n    getItemDescriptionProps: (props) => { const item = resolve(props); return normalize.element({ ...part(\"item-description\"), id: `${id}:description:${selectionItemKey(item.value)}` }); },\n  };\n}\n"],"mappings":"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"}

package/dist/selection-form-BOM_odUk.js

@@ -0,0 +1,88 @@
+import { addDomEvent, getAncestorElements, getNodeName, isHTMLElement, isInputElement, observeAttributes, observeChildren, queryAll, setProperty } from "@zag-js/dom-query";
+//#region src/selection-form.ts
+/** Assign properties through Zag; do not overwrite native defaultChecked. */
+function syncSelectionInputs(scope, states) {
+	for (const state of states) {
+		const input = scope.getById(state.id);
+		if (!isInputElement(input)) continue;
+		setProperty(input, "checked", state.checked);
+		setProperty(input, "indeterminate", state.indeterminate ?? false);
+	}
+}
+/** All listeners belong to one machine lifecycle, including deferred reset work. */
+function trackSelectionForm(options) {
+	let stopped = false;
+	let refreshQueued = false;
+	let disabledIds;
+	const cleanups = [];
+	const pendingResets = /* @__PURE__ */ new Set();
+	const release = () => {
+		cleanups.splice(0).forEach((cleanup) => cleanup());
+	};
+	const sync = () => {
+		if (!stopped) syncSelectionInputs(options.scope, options.getState());
+	};
+	const queueRefresh = () => {
+		if (stopped || refreshQueued) return;
+		refreshQueued = true;
+		queueMicrotask(() => {
+			refreshQueued = false;
+			refresh();
+		});
+	};
+	const reportDisabled = () => {
+		const nativeDisabled = new Set(queryAll(options.scope.getRootNode(), "input:disabled"));
+		const next = options.getState().filter((state) => nativeDisabled.has(options.scope.getById(state.id))).map((state) => state.id);
+		if (disabledIds?.length === next.length && disabledIds.every((id, index) => id === next[index])) return;
+		disabledIds = next;
+		options.onDisabledChange([...next]);
+	};
+	function refresh() {
+		if (stopped) return;
+		release();
+		const inputs = options.getState().map((state) => options.scope.getById(state.id)).filter(isInputElement);
+		const root = options.scope.getById(options.rootId);
+		const anchor = inputs[0] ?? root;
+		const ancestors = anchor ? getAncestorElements(anchor) : [];
+		const formId = options.form?.();
+		const form = formId !== void 0 ? options.scope.getById(formId) : inputs.length ? inputs[0].form : ancestors.find((element) => getNodeName(element) === "form");
+		if (form && getNodeName(form) === "form") cleanups.push(addDomEvent(form, "reset", (event) => {
+			const pending = setTimeout(() => {
+				pendingResets.delete(pending);
+				if (stopped || event.defaultPrevented) return;
+				options.onReset();
+				sync();
+				reportDisabled();
+			}, 0);
+			pendingResets.add(pending);
+		}));
+		const fieldsets = new Set(inputs.flatMap((input) => getAncestorElements(input)).filter((element) => isHTMLElement(element) && getNodeName(element) === "fieldset"));
+		for (const fieldset of fieldsets) cleanups.push(observeAttributes(fieldset, {
+			attributes: ["disabled"],
+			callback: queueRefresh
+		}));
+		for (const input of inputs) cleanups.push(observeAttributes(input, {
+			attributes: ["disabled", "form"],
+			callback: queueRefresh
+		}));
+		const roots = new Set([root, root ? getAncestorElements(root)[1] : void 0].filter(isHTMLElement));
+		for (const node of roots) cleanups.push(observeChildren(node, { callback: queueRefresh }));
+		sync();
+		reportDisabled();
+	}
+	refresh();
+	return {
+		sync,
+		refresh,
+		stop() {
+			stopped = true;
+			release();
+			pendingResets.forEach(clearTimeout);
+			pendingResets.clear();
+		}
+	};
+}
+//#endregion
+export { trackSelectionForm as n, syncSelectionInputs as t };
+
+//# sourceMappingURL=selection-form-BOM_odUk.js.map

package/dist/selection-form-BOM_odUk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-form-BOM_odUk.js","names":[],"sources":["../src/selection-form.ts"],"sourcesContent":["import { addDomEvent, getAncestorElements, getNodeName, isHTMLElement, isInputElement, observeAttributes, observeChildren, queryAll, setProperty } from \"@zag-js/dom-query\";\n\n/** Client effects receive a Zag scope; imports and SSR getters never create one. */\nexport interface SelectionFormScope {\n  getRootNode(): Document | Element | ShadowRoot;\n  getById<T extends Element = HTMLElement>(id: string): T | null;\n}\nexport interface SelectionNativeState { id: string; checked: boolean; indeterminate?: boolean }\nexport interface SelectionFormOptions {\n  scope: SelectionFormScope;\n  rootId: string;\n  getState(): readonly SelectionNativeState[];\n  form?: () => string | undefined;\n  onReset(): void;\n  onDisabledChange(ids: readonly string[]): void;\n}\nexport interface SelectionFormTracker { sync(): void; refresh(): void; stop(): void }\n\n/** Assign properties through Zag; do not overwrite native defaultChecked. */\nexport function syncSelectionInputs(scope: SelectionFormScope, states: readonly SelectionNativeState[]): void {\n  for (const state of states) {\n    const input = scope.getById<HTMLInputElement>(state.id);\n    if (!isInputElement(input)) continue;\n    setProperty(input, \"checked\", state.checked);\n    setProperty(input, \"indeterminate\", state.indeterminate ?? false);\n  }\n}\n\n/** All listeners belong to one machine lifecycle, including deferred reset work. */\nexport function trackSelectionForm(options: SelectionFormOptions): SelectionFormTracker {\n  let stopped = false;\n  let refreshQueued = false;\n  let disabledIds: string[] | undefined;\n  const cleanups: Array<() => void> = [];\n  const pendingResets = new Set<ReturnType<typeof setTimeout>>();\n  const release = () => { cleanups.splice(0).forEach((cleanup) => cleanup()); };\n  const sync = () => { if (!stopped) syncSelectionInputs(options.scope, options.getState()); };\n  const queueRefresh = () => {\n    if (stopped || refreshQueued) return;\n    refreshQueued = true;\n    queueMicrotask(() => { refreshQueued = false; refresh(); });\n  };\n  const reportDisabled = () => {\n    const nativeDisabled = new Set(queryAll(options.scope.getRootNode(), \"input:disabled\"));\n    const next = options.getState().filter((state) => nativeDisabled.has(options.scope.getById(state.id)!)).map((state) => state.id);\n    if (disabledIds?.length === next.length && disabledIds.every((id, index) => id === next[index])) return;\n    disabledIds = next;\n    options.onDisabledChange([...next]);\n  };\n  function refresh() {\n    if (stopped) return;\n    release();\n    const inputs = options.getState().map((state) => options.scope.getById<HTMLInputElement>(state.id)).filter(isInputElement);\n    const root = options.scope.getById(options.rootId);\n    const anchor = inputs[0] ?? root;\n    const ancestors = anchor ? getAncestorElements(anchor) : [];\n    const formId = options.form?.();\n    const form = formId !== undefined ? options.scope.getById(formId) : inputs.length ? inputs[0]!.form : ancestors.find((element) => getNodeName(element) === \"form\");\n    if (form && getNodeName(form) === \"form\") {\n      cleanups.push(addDomEvent(form, \"reset\", (event) => {\n        // Native button dispatch can checkpoint microtasks before a later canceling listener.\n        const pending = setTimeout(() => {\n          pendingResets.delete(pending);\n          if (stopped || event.defaultPrevented) return;\n          options.onReset();\n          sync();\n          reportDisabled();\n        }, 0);\n        pendingResets.add(pending);\n      }));\n    }\n    const fieldsets = new Set(inputs.flatMap((input) => getAncestorElements(input)).filter((element): element is HTMLElement => isHTMLElement(element) && getNodeName(element) === \"fieldset\"));\n    for (const fieldset of fieldsets) cleanups.push(observeAttributes(fieldset, { attributes: [\"disabled\"], callback: queueRefresh }));\n    for (const input of inputs) cleanups.push(observeAttributes(input, { attributes: [\"disabled\", \"form\"], callback: queueRefresh }));\n    // Observe the rendered subtree and its parent so list changes/reparenting rebind.\n    const roots = new Set([root, root ? getAncestorElements(root)[1] : undefined].filter(isHTMLElement));\n    for (const node of roots) cleanups.push(observeChildren(node, { callback: queueRefresh }));\n    sync();\n    reportDisabled();\n  }\n  refresh();\n  return { sync, refresh, stop() { stopped = true; release(); pendingResets.forEach(clearTimeout); pendingResets.clear(); } };\n}\n"],"mappings":"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"}

package/dist/selection-form.d.ts

@@ -0,0 +1,27 @@
+/** Client effects receive a Zag scope; imports and SSR getters never create one. */
+export interface SelectionFormScope {
+    getRootNode(): Document | Element | ShadowRoot;
+    getById<T extends Element = HTMLElement>(id: string): T | null;
+}
+export interface SelectionNativeState {
+    id: string;
+    checked: boolean;
+    indeterminate?: boolean;
+}
+export interface SelectionFormOptions {
+    scope: SelectionFormScope;
+    rootId: string;
+    getState(): readonly SelectionNativeState[];
+    form?: () => string | undefined;
+    onReset(): void;
+    onDisabledChange(ids: readonly string[]): void;
+}
+export interface SelectionFormTracker {
+    sync(): void;
+    refresh(): void;
+    stop(): void;
+}
+/** Assign properties through Zag; do not overwrite native defaultChecked. */
+export declare function syncSelectionInputs(scope: SelectionFormScope, states: readonly SelectionNativeState[]): void;
+/** All listeners belong to one machine lifecycle, including deferred reset work. */
+export declare function trackSelectionForm(options: SelectionFormOptions): SelectionFormTracker;

package/dist/selection-ivXqO1eu.js

@@ -0,0 +1,55 @@
+//#region src/selection.ts
+function normalizeSelectionItems(items) {
+	const seen = /* @__PURE__ */ new Set();
+	return items.map((item) => {
+		if (typeof item.value !== "string" || item.value.length === 0) throw new TypeError("Selection item values must be non-empty strings");
+		if (seen.has(item.value)) throw new TypeError("Selection item values must be unique");
+		seen.add(item.value);
+		return { ...item };
+	});
+}
+function normalizeSelectionValue(value = []) {
+	if (value.some((item) => typeof item !== "string" || item.length === 0)) throw new TypeError("Selection values must be non-empty strings");
+	return [...new Set(value)];
+}
+function resolveSelectionLimits(min, max) {
+	const lower = typeof min === "number" && Number.isFinite(min) ? Math.max(0, Math.floor(min)) : 0;
+	return {
+		min: lower,
+		max: typeof max === "number" && Number.isFinite(max) ? Math.max(lower, Math.floor(max), 0) : Infinity
+	};
+}
+/** Caller values are preserved; limits apply only to a user addition/removal. */
+function toggleSelectionValue(value, item, restrictions = {}) {
+	const values = normalizeSelectionValue(value);
+	const { min, max } = resolveSelectionLimits(restrictions.min, restrictions.max);
+	if (restrictions.disabled || item.disabled) return {
+		value: values,
+		blocked: "disabled"
+	};
+	if (restrictions.readOnly) return {
+		value: values,
+		blocked: "readonly"
+	};
+	const selected = values.includes(item.value);
+	if (selected && values.length <= min) return {
+		value: values,
+		blocked: "min"
+	};
+	if (!selected && values.length >= max) return {
+		value: values,
+		blocked: "max"
+	};
+	return {
+		value: selected ? values.filter((entry) => entry !== item.value) : [...values, item.value],
+		blocked: null
+	};
+}
+/** Injective UTF-16 identity for native item ids, including unmatched surrogates. */
+function selectionItemKey(value) {
+	return value.split("").map((unit) => unit.charCodeAt(0).toString(16)).join("-");
+}
+//#endregion
+export { toggleSelectionValue as i, normalizeSelectionValue as n, selectionItemKey as r, normalizeSelectionItems as t };
+
+//# sourceMappingURL=selection-ivXqO1eu.js.map

package/dist/selection-ivXqO1eu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-ivXqO1eu.js","names":[],"sources":["../src/selection.ts"],"sourcesContent":["/** Shared identity and value rules for selection machines. */\nexport interface QwSelectionItem {\n  value: string;\n  label: string;\n  description?: string;\n  disabled?: boolean;\n}\n\nexport interface SelectionLimits { min: number; max: number }\nexport interface SelectionRestrictions { min?: number; max?: number; disabled?: boolean; readOnly?: boolean }\nexport type SelectionBlockedReason = \"disabled\" | \"readonly\" | \"min\" | \"max\";\nexport interface SelectionChange { value: string[]; blocked: SelectionBlockedReason | null }\n\nexport function normalizeSelectionItems(items: readonly QwSelectionItem[]): QwSelectionItem[] {\n  const seen = new Set<string>();\n  return items.map((item) => {\n    if (typeof item.value !== \"string\" || item.value.length === 0) throw new TypeError(\"Selection item values must be non-empty strings\");\n    if (seen.has(item.value)) throw new TypeError(\"Selection item values must be unique\");\n    seen.add(item.value);\n    return { ...item };\n  });\n}\n\nexport function normalizeSelectionValue(value: readonly string[] = []): string[] {\n  if (value.some((item) => typeof item !== \"string\" || item.length === 0)) throw new TypeError(\"Selection values must be non-empty strings\");\n  return [...new Set(value)];\n}\n\nexport function resolveSelectionLimits(min?: number, max?: number): SelectionLimits {\n  const lower = typeof min === \"number\" && Number.isFinite(min) ? Math.max(0, Math.floor(min)) : 0;\n  const upper = typeof max === \"number\" && Number.isFinite(max) ? Math.max(lower, Math.floor(max), 0) : Infinity;\n  return { min: lower, max: upper };\n}\n\n/** Caller values are preserved; limits apply only to a user addition/removal. */\nexport function toggleSelectionValue(value: readonly string[], item: QwSelectionItem, restrictions: SelectionRestrictions = {}): SelectionChange {\n  const values = normalizeSelectionValue(value);\n  const { min, max } = resolveSelectionLimits(restrictions.min, restrictions.max);\n  if (restrictions.disabled || item.disabled) return { value: values, blocked: \"disabled\" };\n  if (restrictions.readOnly) return { value: values, blocked: \"readonly\" };\n  const selected = values.includes(item.value);\n  if (selected && values.length <= min) return { value: values, blocked: \"min\" };\n  if (!selected && values.length >= max) return { value: values, blocked: \"max\" };\n  return { value: selected ? values.filter((entry) => entry !== item.value) : [...values, item.value], blocked: null };\n}\n\n/** Injective UTF-16 identity for native item ids, including unmatched surrogates. */\nexport function selectionItemKey(value: string): string {\n  return value.split(\"\").map(unit => unit.charCodeAt(0).toString(16)).join(\"-\");\n}\n"],"mappings":";AAaA,SAAgB,wBAAwB,OAAsD;CAC5F,MAAM,uBAAO,IAAI,IAAY;CAC7B,OAAO,MAAM,KAAK,SAAS;EACzB,IAAI,OAAO,KAAK,UAAU,YAAY,KAAK,MAAM,WAAW,GAAG,MAAM,IAAI,UAAU,iDAAiD;EACpI,IAAI,KAAK,IAAI,KAAK,KAAK,GAAG,MAAM,IAAI,UAAU,sCAAsC;EACpF,KAAK,IAAI,KAAK,KAAK;EACnB,OAAO,EAAE,GAAG,KAAK;CACnB,CAAC;AACH;AAEA,SAAgB,wBAAwB,QAA2B,CAAC,GAAa;CAC/E,IAAI,MAAM,MAAM,SAAS,OAAO,SAAS,YAAY,KAAK,WAAW,CAAC,GAAG,MAAM,IAAI,UAAU,4CAA4C;CACzI,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC;AAC3B;AAEA,SAAgB,uBAAuB,KAAc,KAA+B;CAClF,MAAM,QAAQ,OAAO,QAAQ,YAAY,OAAO,SAAS,GAAG,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,GAAG,CAAC,IAAI;CAE/F,OAAO;EAAE,KAAK;EAAO,KADP,OAAO,QAAQ,YAAY,OAAO,SAAS,GAAG,IAAI,KAAK,IAAI,OAAO,KAAK,MAAM,GAAG,GAAG,CAAC,IAAI;CACtE;AAClC;;AAGA,SAAgB,qBAAqB,OAA0B,MAAuB,eAAsC,CAAC,GAAoB;CAC/I,MAAM,SAAS,wBAAwB,KAAK;CAC5C,MAAM,EAAE,KAAK,QAAQ,uBAAuB,aAAa,KAAK,aAAa,GAAG;CAC9E,IAAI,aAAa,YAAY,KAAK,UAAU,OAAO;EAAE,OAAO;EAAQ,SAAS;CAAW;CACxF,IAAI,aAAa,UAAU,OAAO;EAAE,OAAO;EAAQ,SAAS;CAAW;CACvE,MAAM,WAAW,OAAO,SAAS,KAAK,KAAK;CAC3C,IAAI,YAAY,OAAO,UAAU,KAAK,OAAO;EAAE,OAAO;EAAQ,SAAS;CAAM;CAC7E,IAAI,CAAC,YAAY,OAAO,UAAU,KAAK,OAAO;EAAE,OAAO;EAAQ,SAAS;CAAM;CAC9E,OAAO;EAAE,OAAO,WAAW,OAAO,QAAQ,UAAU,UAAU,KAAK,KAAK,IAAI,CAAC,GAAG,QAAQ,KAAK,KAAK;EAAG,SAAS;CAAK;AACrH;;AAGA,SAAgB,iBAAiB,OAAuB;CACtD,OAAO,MAAM,MAAM,EAAE,CAAC,CAAC,KAAI,SAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG;AAC9E"}

package/dist/selection.d.ts

@@ -0,0 +1,29 @@
+/** Shared identity and value rules for selection machines. */
+export interface QwSelectionItem {
+    value: string;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+}
+export interface SelectionLimits {
+    min: number;
+    max: number;
+}
+export interface SelectionRestrictions {
+    min?: number;
+    max?: number;
+    disabled?: boolean;
+    readOnly?: boolean;
+}
+export type SelectionBlockedReason = "disabled" | "readonly" | "min" | "max";
+export interface SelectionChange {
+    value: string[];
+    blocked: SelectionBlockedReason | null;
+}
+export declare function normalizeSelectionItems(items: readonly QwSelectionItem[]): QwSelectionItem[];
+export declare function normalizeSelectionValue(value?: readonly string[]): string[];
+export declare function resolveSelectionLimits(min?: number, max?: number): SelectionLimits;
+/** Caller values are preserved; limits apply only to a user addition/removal. */
+export declare function toggleSelectionValue(value: readonly string[], item: QwSelectionItem, restrictions?: SelectionRestrictions): SelectionChange;
+/** Injective UTF-16 identity for native item ids, including unmatched surrogates. */
+export declare function selectionItemKey(value: string): string;

package/dist/selector/choice-group.d.ts

@@ -0,0 +1,114 @@
+import { type Machine, type Service } from "@zag-js/core";
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
+import { type QwSelectionItem } from "../selection.js";
+import { type IconState } from "../icon/index.js";
+export interface ChoiceGroupItem extends QwSelectionItem {
+    /** Item-level read-only: focusable and submitted, but cannot change. */
+    readOnly?: boolean;
+    /** Supporting trailing text, read after the description. */
+    extra?: string;
+}
+export interface ChoiceGroupValueChangeDetails<I extends ChoiceGroupItem = ChoiceGroupItem> {
+    /** Requested ordered values (independent copy). */
+    value: string[];
+    /** Known items for the requested values, in value order (copies). */
+    items: I[];
+}
+export interface ChoiceGroupProps {
+    id?: string;
+    label: string;
+    hideLabel?: boolean;
+    description?: string;
+    describedBy?: string;
+    items: ChoiceGroupItem[];
+    multiple?: boolean;
+    value?: string[];
+    defaultValue?: string[];
+    required?: boolean;
+    min?: number;
+    max?: number;
+    disabled?: boolean;
+    readOnly?: boolean;
+    invalid?: boolean;
+    name?: string;
+    form?: string;
+    dir?: string;
+    loop?: boolean;
+    onValueChange?: (details: ChoiceGroupValueChangeDetails) => void;
+}
+export interface ChoiceGroupSchema {
+    props: ChoiceGroupProps & {
+        multiple: boolean;
+        defaultValue: string[];
+        loop: boolean;
+    } & Record<string, unknown>;
+    context: {
+        value: string[];
+        focusedValue: string | null;
+        disabledIds: string[];
+    };
+    state: "ready";
+    action: "setValue" | "toggleValue" | "selectValue" | "setFocus" | "syncInputs" | "normalizeMode";
+    effect: "trackForm";
+    event: {
+        type: "VALUE.SET";
+        value: string[];
+    } | {
+        type: "VALUE.TOGGLE" | "VALUE.SELECT" | "FOCUS";
+        value: string;
+    };
+}
+export type ChoiceGroupMachine = Machine<ChoiceGroupSchema>;
+export type ChoiceGroupService = Service<ChoiceGroupSchema>;
+export interface ChoiceGroupItemState {
+    selected: boolean;
+    disabled: boolean;
+    readOnly: boolean;
+}
+export declare function normalizeChoiceItems<I extends ChoiceGroupItem>(items: readonly I[], family: string): I[];
+export declare function normalizeChoiceValue(value?: readonly string[], multiple?: boolean): string[];
+export declare function createChoiceGroupProps(props: ChoiceGroupProps, family: string): ChoiceGroupSchema["props"];
+/** One machine per family; `family` is the data-scope and id prefix. */
+export declare function createChoiceGroupMachine(family: string): ChoiceGroupMachine;
+export interface ChoiceGroupApi<T extends PropTypes = PropTypes> {
+    value: string[];
+    items: ChoiceGroupItem[];
+    label: string;
+    description: string;
+    setValue(value: string[]): void;
+    toggleValue(value: string): void;
+    clearValue(): void;
+    getRootProps(extra?: Record<string, unknown>): T["element"];
+    getLabelProps(): T["element"];
+    getDescriptionProps(): T["element"];
+    getGroupProps(part: string): T["element"];
+    getItemState(item: {
+        value: string;
+    }): ChoiceGroupItemState;
+    getItemProps(item: {
+        value: string;
+    }, part: string): T["label"];
+    getInputProps(item: {
+        value: string;
+    }): T["input"];
+    getItemPartProps(item: {
+        value: string;
+    }, part: string): T["element"];
+    getTextProps(item: {
+        value: string;
+    }, part: string): T["element"];
+    getItemDescriptionProps(item: {
+        value: string;
+    }, part: string): T["element"];
+    getExtraProps(item: {
+        value: string;
+    }, part: string): T["element"];
+    getCheckProps(item: {
+        value: string;
+    }, part: string): T["element"];
+    getCheckIconState(item: {
+        value: string;
+    }): IconState;
+}
+/** SSR-pure getters; client handlers use the Zag DOM scope only inside events. */
+export declare function connectChoiceGroup<T extends PropTypes>(family: string, service: ChoiceGroupService, normalize: NormalizeProps<T>): ChoiceGroupApi<T>;

package/dist/selector/index.d.ts

@@ -0,0 +1,2 @@
+export { SELECTOR_PARTS, SELECTOR_COLUMNS, resolveSelectorColumns, normalizeSelectorOptions, normalizeSelectorValue, createSelectorProps, selectorMachine, connectSelector } from "./selector.js";
+export type { SelectorPart, QwSelectorOption, SelectorValueChangeDetails, QwSelectorProps, QwSelectorSchema, QwSelectorMachine, QwSelectorService, QwSelectorOptionState, QwSelectorOptionProps, QwSelectorApi } from "./selector.js";

package/dist/selector/index.js

@@ -0,0 +1,2 @@
+import { a as normalizeSelectorOptions, c as selectorMachine, i as createSelectorProps, n as SELECTOR_PARTS, o as normalizeSelectorValue, r as connectSelector, s as resolveSelectorColumns, t as SELECTOR_COLUMNS } from "../selector-BU2MMJ4N.js";
+export { SELECTOR_COLUMNS, SELECTOR_PARTS, connectSelector, createSelectorProps, normalizeSelectorOptions, normalizeSelectorValue, resolveSelectorColumns, selectorMachine };

package/dist/selector/selector.d.ts

@@ -0,0 +1,90 @@
+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 "./choice-group.js";
+/** Stable DOM parts shared by every adapter. */
+export declare const SELECTOR_PARTS: readonly ["root", "label", "description", "options", "option", "input", "content", "text", "option-description", "check"];
+/** Supported fixed column counts; anything else uses the auto-wrapping flow. */
+export declare const SELECTOR_COLUMNS: readonly [1, 2, 3, 4, 5, 6];
+export type SelectorPart = (typeof SELECTOR_PARTS)[number];
+/** One tile. `label` is the accessible option name. */
+export interface QwSelectorOption {
+    value: string;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+}
+export type SelectorValueChangeDetails = ChoiceGroupValueChangeDetails<QwSelectorOption>;
+export interface QwSelectorProps {
+    id?: string;
+    /** Required nonempty group name rendered as the fieldset legend. */
+    label: string;
+    /** Visually hide the legend while it still names the group. */
+    hideLabel?: boolean;
+    description?: string;
+    /** External Field help/error references merged with the own description. */
+    describedBy?: string;
+    /** Ordered tiles with unique nonempty values and labels. */
+    options: QwSelectorOption[];
+    /** Multiple checkboxes instead of single radios. Defaults false. */
+    multiple?: boolean;
+    /** Defined arrays (including []) are controlled; user actions only request changes. */
+    value?: string[];
+    /** Initial value and form reset target. Defaults []. */
+    defaultValue?: string[];
+    /** Native validation; in single mode it also blocks clearing the selected tile. */
+    required?: boolean;
+    /** Multiple-mode limits for user removal/addition. */
+    min?: number;
+    max?: number;
+    disabled?: boolean;
+    readOnly?: boolean;
+    invalid?: boolean;
+    name?: string;
+    form?: string;
+    dir?: string;
+    /** Arrow-key wrapping; defaults true. */
+    loop?: boolean;
+    /** Equal column count 1–6; otherwise tiles wrap by content. */
+    columns?: number;
+    /** Corner check mark on selected tiles (non-color cue). Defaults true. */
+    showCheckMark?: boolean;
+    onValueChange?: (details: SelectorValueChangeDetails) => void;
+}
+export type QwSelectorSchema = ChoiceGroupSchema;
+export type QwSelectorMachine = ChoiceGroupMachine;
+export type QwSelectorService = ChoiceGroupService;
+export type QwSelectorOptionState = ChoiceGroupItemState;
+export interface QwSelectorOptionProps {
+    value: string;
+}
+/** Resolve columns to a supported integer or undefined (auto flow). */
+export declare function resolveSelectorColumns(columns: unknown): number | undefined;
+export declare function normalizeSelectorOptions(options: readonly QwSelectorOption[]): QwSelectorOption[];
+export declare function normalizeSelectorValue(value?: readonly string[], multiple?: boolean): string[];
+/** Map public props to the shared choice-group machine props. */
+export declare function createSelectorProps(props: QwSelectorProps): QwSelectorSchema["props"];
+export declare const selectorMachine: QwSelectorMachine;
+export interface QwSelectorApi<T extends PropTypes = PropTypes> {
+    value: string[];
+    options: QwSelectorOption[];
+    label: string;
+    description: string;
+    showCheckMark: boolean;
+    setValue(value: string[]): void;
+    toggleValue(value: string): void;
+    clearValue(): void;
+    getRootProps(): T["element"];
+    getLabelProps(): T["element"];
+    getDescriptionProps(): T["element"];
+    getOptionsProps(): T["element"];
+    getOptionState(option: QwSelectorOptionProps): QwSelectorOptionState;
+    getOptionProps(option: QwSelectorOptionProps): T["label"];
+    getInputProps(option: QwSelectorOptionProps): T["input"];
+    getContentProps(option: QwSelectorOptionProps): T["element"];
+    getTextProps(option: QwSelectorOptionProps): T["element"];
+    getOptionDescriptionProps(option: QwSelectorOptionProps): T["element"];
+    getCheckProps(option: QwSelectorOptionProps): T["element"];
+    getCheckIconState(option: QwSelectorOptionProps): IconState;
+}
+/** Mechanical part mapping over the shared kernel. */
+export declare function connectSelector<T extends PropTypes>(service: QwSelectorService, normalize: NormalizeProps<T>): QwSelectorApi<T>;

package/dist/selector-BU2MMJ4N.js

@@ -0,0 +1,93 @@
+import { a as normalizeChoiceValue, i as normalizeChoiceItems, n as createChoiceGroupMachine, r as createChoiceGroupProps, t as connectChoiceGroup } from "./choice-group-C4c9m0qe.js";
+//#region src/selector/selector.ts
+/** Stable DOM parts shared by every adapter. */
+const SELECTOR_PARTS = [
+	"root",
+	"label",
+	"description",
+	"options",
+	"option",
+	"input",
+	"content",
+	"text",
+	"option-description",
+	"check"
+];
+/** Supported fixed column counts; anything else uses the auto-wrapping flow. */
+const SELECTOR_COLUMNS = [
+	1,
+	2,
+	3,
+	4,
+	5,
+	6
+];
+/** Resolve columns to a supported integer or undefined (auto flow). */
+function resolveSelectorColumns(columns) {
+	return typeof columns === "number" && SELECTOR_COLUMNS.includes(columns) ? columns : void 0;
+}
+function normalizeSelectorOptions(options) {
+	return normalizeChoiceItems(options, "Selector");
+}
+function normalizeSelectorValue(value = [], multiple = false) {
+	return normalizeChoiceValue(value, multiple);
+}
+/** Map public props to the shared choice-group machine props. */
+function createSelectorProps(props) {
+	const { options, onValueChange, ...rest } = props;
+	return {
+		...createChoiceGroupProps({
+			...rest,
+			items: options ?? [],
+			onValueChange
+		}, "Selector"),
+		columns: resolveSelectorColumns(props.columns),
+		showCheckMark: props.showCheckMark ?? true
+	};
+}
+const selectorMachine = createChoiceGroupMachine("selector");
+/** Mechanical part mapping over the shared kernel. */
+function connectSelector(service, normalize) {
+	const api = connectChoiceGroup("selector", service, normalize);
+	const columns = resolveSelectorColumns(service.prop("columns")), showCheckMark = service.prop("showCheckMark") !== false;
+	return {
+		value: api.value,
+		options: api.items.map(({ value, label, description, disabled }) => ({
+			value,
+			label,
+			description,
+			disabled
+		})),
+		label: api.label,
+		description: api.description,
+		showCheckMark,
+		setValue: api.setValue,
+		toggleValue: api.toggleValue,
+		clearValue: api.clearValue,
+		getRootProps: () => api.getRootProps({
+			"data-columns": columns,
+			"data-check-mark": showCheckMark ? "" : void 0
+		}),
+		getLabelProps: api.getLabelProps,
+		getDescriptionProps: api.getDescriptionProps,
+		getOptionsProps: () => api.getGroupProps("options"),
+		getOptionState: api.getItemState,
+		getOptionProps: (option) => api.getItemProps(option, "option"),
+		getInputProps: api.getInputProps,
+		getContentProps: (option) => api.getItemPartProps(option, "content"),
+		getTextProps: (option) => api.getTextProps(option, "text"),
+		getOptionDescriptionProps: (option) => api.getItemDescriptionProps(option, "option-description"),
+		getCheckProps: (option) => {
+			const props = api.getCheckProps(option, "check");
+			return showCheckMark ? props : {
+				...props,
+				hidden: true
+			};
+		},
+		getCheckIconState: api.getCheckIconState
+	};
+}
+//#endregion
+export { normalizeSelectorOptions as a, selectorMachine as c, createSelectorProps as i, SELECTOR_PARTS as n, normalizeSelectorValue as o, connectSelector as r, resolveSelectorColumns as s, SELECTOR_COLUMNS as t };
+
+//# sourceMappingURL=selector-BU2MMJ4N.js.map

package/dist/selector-BU2MMJ4N.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-BU2MMJ4N.js","names":[],"sources":["../src/selector/selector.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 \"./choice-group.js\";\n\n/** Stable DOM parts shared by every adapter. */\nexport const SELECTOR_PARTS = [\"root\", \"label\", \"description\", \"options\", \"option\", \"input\", \"content\", \"text\", \"option-description\", \"check\"] as const;\n/** Supported fixed column counts; anything else uses the auto-wrapping flow. */\nexport const SELECTOR_COLUMNS = [1, 2, 3, 4, 5, 6] as const;\nexport type SelectorPart = (typeof SELECTOR_PARTS)[number];\n/** One tile. `label` is the accessible option name. */\nexport interface QwSelectorOption { value: string; label: string; description?: string; disabled?: boolean }\nexport type SelectorValueChangeDetails = ChoiceGroupValueChangeDetails<QwSelectorOption>;\nexport interface QwSelectorProps {\n  id?: string;\n  /** Required nonempty group name rendered as the fieldset legend. */\n  label: string;\n  /** Visually hide the legend while it still names the group. */\n  hideLabel?: boolean;\n  description?: string;\n  /** External Field help/error references merged with the own description. */\n  describedBy?: string;\n  /** Ordered tiles with unique nonempty values and labels. */\n  options: QwSelectorOption[];\n  /** Multiple checkboxes instead of single radios. Defaults false. */\n  multiple?: boolean;\n  /** Defined arrays (including []) are controlled; user actions only request changes. */\n  value?: string[];\n  /** Initial value and form reset target. Defaults []. */\n  defaultValue?: string[];\n  /** Native validation; in single mode it also blocks clearing the selected tile. */\n  required?: boolean;\n  /** Multiple-mode limits for user removal/addition. */\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  /** Arrow-key wrapping; defaults true. */\n  loop?: boolean;\n  /** Equal column count 1–6; otherwise tiles wrap by content. */\n  columns?: number;\n  /** Corner check mark on selected tiles (non-color cue). Defaults true. */\n  showCheckMark?: boolean;\n  onValueChange?: (details: SelectorValueChangeDetails) => void;\n}\nexport type QwSelectorSchema = ChoiceGroupSchema;\nexport type QwSelectorMachine = ChoiceGroupMachine;\nexport type QwSelectorService = ChoiceGroupService;\nexport type QwSelectorOptionState = ChoiceGroupItemState;\nexport interface QwSelectorOptionProps { value: string }\n\n/** Resolve columns to a supported integer or undefined (auto flow). */\nexport function resolveSelectorColumns(columns: unknown): number | undefined {\n  return typeof columns === \"number\" && (SELECTOR_COLUMNS as readonly number[]).includes(columns) ? columns : undefined;\n}\nexport function normalizeSelectorOptions(options: readonly QwSelectorOption[]): QwSelectorOption[] { return normalizeChoiceItems(options, \"Selector\"); }\nexport function normalizeSelectorValue(value: readonly string[] = [], multiple = false): string[] { return normalizeChoiceValue(value, multiple); }\n/** Map public props to the shared choice-group machine props. */\nexport function createSelectorProps(props: QwSelectorProps): QwSelectorSchema[\"props\"] {\n  const { options, onValueChange, ...rest } = props;\n  return { ...createChoiceGroupProps({ ...rest, items: options ?? [], onValueChange: onValueChange as QwSelectorSchema[\"props\"][\"onValueChange\"] }, \"Selector\"),\n    columns: resolveSelectorColumns(props.columns), showCheckMark: props.showCheckMark ?? true };\n}\nexport const selectorMachine: QwSelectorMachine = createChoiceGroupMachine(\"selector\");\n\nexport interface QwSelectorApi<T extends PropTypes = PropTypes> {\n  value: string[];\n  options: QwSelectorOption[];\n  label: string;\n  description: string;\n  showCheckMark: boolean;\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  getOptionsProps(): T[\"element\"];\n  getOptionState(option: QwSelectorOptionProps): QwSelectorOptionState;\n  getOptionProps(option: QwSelectorOptionProps): T[\"label\"];\n  getInputProps(option: QwSelectorOptionProps): T[\"input\"];\n  getContentProps(option: QwSelectorOptionProps): T[\"element\"];\n  getTextProps(option: QwSelectorOptionProps): T[\"element\"];\n  getOptionDescriptionProps(option: QwSelectorOptionProps): T[\"element\"];\n  getCheckProps(option: QwSelectorOptionProps): T[\"element\"];\n  getCheckIconState(option: QwSelectorOptionProps): IconState;\n}\n/** Mechanical part mapping over the shared kernel. */\nexport function connectSelector<T extends PropTypes>(service: QwSelectorService, normalize: NormalizeProps<T>): QwSelectorApi<T> {\n  const api = connectChoiceGroup(\"selector\", service, normalize);\n  const columns = resolveSelectorColumns(service.prop(\"columns\")), showCheckMark = service.prop(\"showCheckMark\") !== false;\n  return {\n    value: api.value, options: api.items.map(({ value, label, description, disabled }) => ({ value, label, description, disabled })), label: api.label, description: api.description, showCheckMark,\n    setValue: api.setValue, toggleValue: api.toggleValue, clearValue: api.clearValue,\n    getRootProps: () => api.getRootProps({ \"data-columns\": columns, \"data-check-mark\": showCheckMark ? \"\" : undefined }),\n    getLabelProps: api.getLabelProps, getDescriptionProps: api.getDescriptionProps,\n    getOptionsProps: () => api.getGroupProps(\"options\"),\n    getOptionState: api.getItemState,\n    getOptionProps: (option) => api.getItemProps(option, \"option\"),\n    getInputProps: api.getInputProps,\n    getContentProps: (option) => api.getItemPartProps(option, \"content\"),\n    getTextProps: (option) => api.getTextProps(option, \"text\"),\n    getOptionDescriptionProps: (option) => api.getItemDescriptionProps(option, \"option-description\"),\n    getCheckProps: (option) => { const props = api.getCheckProps(option, \"check\") as Record<string, unknown>; return (showCheckMark ? props : { ...props, hidden: true }) as T[\"element\"]; },\n    getCheckIconState: api.getCheckIconState,\n  };\n}\n"],"mappings":";;;AAKA,MAAa,iBAAiB;CAAC;CAAQ;CAAS;CAAe;CAAW;CAAU;CAAS;CAAW;CAAQ;CAAsB;AAAO;;AAE7I,MAAa,mBAAmB;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;;AAgDjD,SAAgB,uBAAuB,SAAsC;CAC3E,OAAO,OAAO,YAAY,YAAa,iBAAuC,SAAS,OAAO,IAAI,UAAU,KAAA;AAC9G;AACA,SAAgB,yBAAyB,SAA0D;CAAE,OAAO,qBAAqB,SAAS,UAAU;AAAG;AACvJ,SAAgB,uBAAuB,QAA2B,CAAC,GAAG,WAAW,OAAiB;CAAE,OAAO,qBAAqB,OAAO,QAAQ;AAAG;;AAElJ,SAAgB,oBAAoB,OAAmD;CACrF,MAAM,EAAE,SAAS,eAAe,GAAG,SAAS;CAC5C,OAAO;EAAE,GAAG,uBAAuB;GAAE,GAAG;GAAM,OAAO,WAAW,CAAC;GAAkB;EAA4D,GAAG,UAAU;EAC1J,SAAS,uBAAuB,MAAM,OAAO;EAAG,eAAe,MAAM,iBAAiB;CAAK;AAC/F;AACA,MAAa,kBAAqC,yBAAyB,UAAU;;AAyBrF,SAAgB,gBAAqC,SAA4B,WAAgD;CAC/H,MAAM,MAAM,mBAAmB,YAAY,SAAS,SAAS;CAC7D,MAAM,UAAU,uBAAuB,QAAQ,KAAK,SAAS,CAAC,GAAG,gBAAgB,QAAQ,KAAK,eAAe,MAAM;CACnH,OAAO;EACL,OAAO,IAAI;EAAO,SAAS,IAAI,MAAM,KAAK,EAAE,OAAO,OAAO,aAAa,gBAAgB;GAAE;GAAO;GAAO;GAAa;EAAS,EAAE;EAAG,OAAO,IAAI;EAAO,aAAa,IAAI;EAAa;EAClL,UAAU,IAAI;EAAU,aAAa,IAAI;EAAa,YAAY,IAAI;EACtE,oBAAoB,IAAI,aAAa;GAAE,gBAAgB;GAAS,mBAAmB,gBAAgB,KAAK,KAAA;EAAU,CAAC;EACnH,eAAe,IAAI;EAAe,qBAAqB,IAAI;EAC3D,uBAAuB,IAAI,cAAc,SAAS;EAClD,gBAAgB,IAAI;EACpB,iBAAiB,WAAW,IAAI,aAAa,QAAQ,QAAQ;EAC7D,eAAe,IAAI;EACnB,kBAAkB,WAAW,IAAI,iBAAiB,QAAQ,SAAS;EACnE,eAAe,WAAW,IAAI,aAAa,QAAQ,MAAM;EACzD,4BAA4B,WAAW,IAAI,wBAAwB,QAAQ,oBAAoB;EAC/F,gBAAgB,WAAW;GAAE,MAAM,QAAQ,IAAI,cAAc,QAAQ,OAAO;GAA8B,OAAQ,gBAAgB,QAAQ;IAAE,GAAG;IAAO,QAAQ;GAAK;EAAoB;EACvL,mBAAmB,IAAI;CACzB;AACF"}

package/dist/share-sheet/index.d.ts

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