@zag-js/radio-group 0.1.11 → 0.2.0

package/dist/{chunk-F57UWPRI.mjs → chunk-57ZUFOAP.mjs}

@@ -3,31 +3,11 @@ import {
 } from "./chunk-MGLN5L3R.mjs";
 import {
   dom
-} from "./chunk-CYVZAWTC.mjs";
-
-// ../../utilities/dom/src/attrs.ts
-var dataAttr = (guard) => {
-  return guard ? "" : void 0;
-};
-var ariaAttr = (guard) => {
-  return guard ? "true" : void 0;
-};
-
-// ../../utilities/dom/src/visually-hidden.ts
-var visuallyHiddenStyle = {
-  border: "0",
-  clip: "rect(0 0 0 0)",
-  height: "1px",
-  margin: "-1px",
-  overflow: "hidden",
-  padding: "0",
-  position: "absolute",
-  width: "1px",
-  whiteSpace: "nowrap",
-  wordWrap: "normal"
-};
+} from "./chunk-ITVKBCBK.mjs";
 
 // src/radio-group.connect.ts
+import { ariaAttr, dataAttr } from "@zag-js/dom-query";
+import { visuallyHiddenStyle } from "@zag-js/visually-hidden";
 function connect(state, send, normalize) {
   const isGroupDisabled = state.context.disabled;
   const isGroupReadOnly = state.context.readOnly;
@@ -67,11 +47,29 @@ function connect(state, send, normalize) {
     firstEnabledInput?.focus();
   };
   return {
+    /**
+     * The current value of the radio group
+     */
     value: state.context.value,
+    /**
+     * Function to set the value of the radio group
+     */
     setValue(value) {
       send({ type: "SET_VALUE", value, manual: true });
     },
+    /**
+     * Function to clear the value of the radio group
+     */
+    clearValue() {
+      send({ type: "SET_VALUE", value: null, manual: true });
+    },
+    /**
+     * Function to focus the radio group
+     */
     focus,
+    /**
+     * Function to blur the currently focused radio input in the radio group
+     */
     blur() {
       const focusedElement = dom.getActiveElement(state.context);
       const inputEls = dom.getInputEls(state.context);
@@ -79,10 +77,15 @@ function connect(state, send, normalize) {
       if (radioInputIsFocused)
         focusedElement?.blur();
     },
+    /**
+     * Returns the state details of a radio input
+     */
+    getRadioState,
     rootProps: normalize.element({
       ...parts.root.attrs,
       role: "radiogroup",
       id: dom.getRootId(state.context),
+      "aria-labelledby": dom.getLabelId(state.context),
       "data-orientation": state.context.orientation,
       "aria-orientation": state.context.orientation,
       dir: state.context.dir

package/dist/chunk-DYVEYVKH.mjs

@@ -0,0 +1,97 @@
+import {
+  dom
+} from "./chunk-ITVKBCBK.mjs";
+
+// src/radio-group.machine.ts
+import { createMachine } from "@zag-js/core";
+import { dispatchInputCheckedEvent, trackFormControl } from "@zag-js/form-utils";
+import { compact } from "@zag-js/utils";
+function machine(userContext) {
+  const ctx = compact(userContext);
+  return createMachine(
+    {
+      id: "radio",
+      initial: "idle",
+      context: {
+        value: null,
+        initialValue: null,
+        activeId: null,
+        focusedId: null,
+        hoveredId: null,
+        ...ctx
+      },
+      activities: ["trackFormControlState"],
+      on: {
+        SET_VALUE: {
+          actions: ["setValue"]
+        },
+        SET_HOVERED: {
+          actions: "setHovered"
+        },
+        SET_ACTIVE: {
+          actions: "setActive"
+        },
+        SET_FOCUSED: {
+          actions: "setFocused"
+        }
+      },
+      watch: {
+        value: ["dispatchChangeEvent", "invokeOnChange", "syncInputElements"]
+      },
+      entry: ["checkValue"],
+      states: {
+        idle: {}
+      }
+    },
+    {
+      activities: {
+        trackFormControlState(ctx2, _evt, { send }) {
+          return trackFormControl(dom.getRootEl(ctx2), {
+            onFieldsetDisabled() {
+              ctx2.disabled = true;
+            },
+            onFormReset() {
+              send({ type: "SET_VALUE", value: ctx2.initialValue });
+            }
+          });
+        }
+      },
+      actions: {
+        checkValue(ctx2) {
+          ctx2.initialValue = ctx2.value;
+        },
+        setValue(ctx2, evt) {
+          ctx2.value = evt.value;
+        },
+        setHovered(ctx2, evt) {
+          ctx2.hoveredId = evt.value;
+        },
+        setActive(ctx2, evt) {
+          ctx2.activeId = evt.value;
+        },
+        setFocused(ctx2, evt) {
+          ctx2.focusedId = evt.value;
+        },
+        invokeOnChange(ctx2, evt) {
+          ctx2.onChange?.({ value: evt.value });
+        },
+        dispatchChangeEvent(ctx2, evt) {
+          if (!evt.manual)
+            return;
+          const el = dom.getRadioInputEl(ctx2, evt.value);
+          dispatchInputCheckedEvent(el, !!evt.value);
+        },
+        syncInputElements(ctx2) {
+          const inputs = dom.getInputEls(ctx2);
+          inputs.forEach((input) => {
+            input.checked = input.value === ctx2.value;
+          });
+        }
+      }
+    }
+  );
+}
+
+export {
+  machine
+};

package/dist/{chunk-CYVZAWTC.mjs → chunk-ITVKBCBK.mjs}

@@ -1,41 +1,6 @@
-// ../../utilities/dom/src/query.ts
-function isDocument(el) {
-  return el.nodeType === Node.DOCUMENT_NODE;
-}
-function isWindow(value) {
-  return value?.toString() === "[object Window]";
-}
-function getDocument(el) {
-  if (isWindow(el))
-    return el.document;
-  if (isDocument(el))
-    return el;
-  return el?.ownerDocument ?? document;
-}
-function getWindow(el) {
-  return el?.ownerDocument.defaultView ?? window;
-}
-function defineDomHelpers(helpers) {
-  const dom2 = {
-    getRootNode: (ctx) => ctx.getRootNode?.() ?? document,
-    getDoc: (ctx) => getDocument(dom2.getRootNode(ctx)),
-    getWin: (ctx) => dom2.getDoc(ctx).defaultView ?? window,
-    getActiveElement: (ctx) => dom2.getDoc(ctx).activeElement,
-    getById: (ctx, id) => dom2.getRootNode(ctx).getElementById(id)
-  };
-  return {
-    ...dom2,
-    ...helpers
-  };
-}
-
-// ../../utilities/dom/src/nodelist.ts
-function queryAll(root, selector) {
-  return Array.from(root?.querySelectorAll(selector) ?? []);
-}
-
 // src/radio-group.dom.ts
-var dom = defineDomHelpers({
+import { createScope, queryAll } from "@zag-js/dom-query";
+var dom = createScope({
   getRootId: (ctx) => ctx.ids?.root ?? `radio-group:${ctx.id}`,
   getLabelId: (ctx) => ctx.ids?.label ?? `radio-group:${ctx.id}:label`,
   getRadioId: (ctx, value) => ctx.ids?.radio?.(value) ?? `radio-group:${ctx.id}:radio:${value}`,
@@ -54,6 +19,5 @@ var dom = defineDomHelpers({
 });
 
 export {
-  getWindow,
   dom
 };

package/dist/index.js

@@ -38,96 +38,13 @@ var anatomy = (0, import_anatomy.createAnatomy)("radio-group").parts(
 );
 var parts = anatomy.build();
 
-// ../../utilities/dom/src/attrs.ts
-var dataAttr = (guard) => {
-  return guard ? "" : void 0;
-};
-var ariaAttr = (guard) => {
-  return guard ? "true" : void 0;
-};
-
-// ../../utilities/core/src/guard.ts
-var isArray = (v) => Array.isArray(v);
-var isObject = (v) => !(v == null || typeof v !== "object" || isArray(v));
-
-// ../../utilities/core/src/object.ts
-function compact(obj) {
-  if (obj === void 0)
-    return obj;
-  return Object.fromEntries(
-    Object.entries(obj).filter(([, value]) => value !== void 0).map(([key, value]) => [key, isObject(value) ? compact(value) : value])
-  );
-}
-
-// ../../utilities/dom/src/query.ts
-function isDocument(el) {
-  return el.nodeType === Node.DOCUMENT_NODE;
-}
-function isWindow(value) {
-  return value?.toString() === "[object Window]";
-}
-function getDocument(el) {
-  if (isWindow(el))
-    return el.document;
-  if (isDocument(el))
-    return el;
-  return el?.ownerDocument ?? document;
-}
-function getWindow(el) {
-  return el?.ownerDocument.defaultView ?? window;
-}
-function defineDomHelpers(helpers) {
-  const dom2 = {
-    getRootNode: (ctx) => ctx.getRootNode?.() ?? document,
-    getDoc: (ctx) => getDocument(dom2.getRootNode(ctx)),
-    getWin: (ctx) => dom2.getDoc(ctx).defaultView ?? window,
-    getActiveElement: (ctx) => dom2.getDoc(ctx).activeElement,
-    getById: (ctx, id) => dom2.getRootNode(ctx).getElementById(id)
-  };
-  return {
-    ...dom2,
-    ...helpers
-  };
-}
-
-// ../../utilities/dom/src/mutation-observer.ts
-function observeAttributes(node, attributes, fn) {
-  if (!node)
-    return;
-  const attrs = Array.isArray(attributes) ? attributes : [attributes];
-  const win = node.ownerDocument.defaultView || window;
-  const obs = new win.MutationObserver((changes) => {
-    for (const change of changes) {
-      if (change.type === "attributes" && change.attributeName && attrs.includes(change.attributeName)) {
-        fn(change);
-      }
-    }
-  });
-  obs.observe(node, { attributes: true, attributeFilter: attrs });
-  return () => obs.disconnect();
-}
-
-// ../../utilities/dom/src/nodelist.ts
-function queryAll(root, selector) {
-  return Array.from(root?.querySelectorAll(selector) ?? []);
-}
-
-// ../../utilities/dom/src/visually-hidden.ts
-var visuallyHiddenStyle = {
-  border: "0",
-  clip: "rect(0 0 0 0)",
-  height: "1px",
-  margin: "-1px",
-  overflow: "hidden",
-  padding: "0",
-  position: "absolute",
-  width: "1px",
-  whiteSpace: "nowrap",
-  wordWrap: "normal"
-};
+// src/radio-group.connect.ts
+var import_dom_query2 = require("@zag-js/dom-query");
+var import_visually_hidden = require("@zag-js/visually-hidden");
 
 // src/radio-group.dom.ts
-var dom = defineDomHelpers({
+var import_dom_query = require("@zag-js/dom-query");
+var dom = (0, import_dom_query.createScope)({
   getRootId: (ctx) => ctx.ids?.root ?? `radio-group:${ctx.id}`,
   getLabelId: (ctx) => ctx.ids?.label ?? `radio-group:${ctx.id}:label`,
   getRadioId: (ctx, value) => ctx.ids?.radio?.(value) ?? `radio-group:${ctx.id}:radio:${value}`,
@@ -141,7 +58,7 @@ var dom = defineDomHelpers({
   getInputEls: (ctx) => {
     const ownerId = CSS.escape(dom.getRootId(ctx));
     const selector = `input[type=radio][data-ownedby='${ownerId}']:not([disabled])`;
-    return queryAll(dom.getRootEl(ctx), selector);
+    return (0, import_dom_query.queryAll)(dom.getRootEl(ctx), selector);
   }
 });
 
@@ -167,12 +84,12 @@ function connect(state, send, normalize) {
   function getRadioDataSet(props) {
     const radioState = getRadioState(props);
     return {
-      "data-focus": dataAttr(radioState.isFocused),
-      "data-disabled": dataAttr(radioState.isDisabled),
-      "data-checked": dataAttr(radioState.isChecked),
-      "data-hover": dataAttr(radioState.isHovered),
-      "data-invalid": dataAttr(radioState.isInvalid),
-      "data-readonly": dataAttr(radioState.isReadOnly)
+      "data-focus": (0, import_dom_query2.dataAttr)(radioState.isFocused),
+      "data-disabled": (0, import_dom_query2.dataAttr)(radioState.isDisabled),
+      "data-checked": (0, import_dom_query2.dataAttr)(radioState.isChecked),
+      "data-hover": (0, import_dom_query2.dataAttr)(radioState.isHovered),
+      "data-invalid": (0, import_dom_query2.dataAttr)(radioState.isInvalid),
+      "data-readonly": (0, import_dom_query2.dataAttr)(radioState.isReadOnly)
     };
   }
   const focus = () => {
@@ -185,11 +102,29 @@ function connect(state, send, normalize) {
     firstEnabledInput?.focus();
   };
   return {
+    /**
+     * The current value of the radio group
+     */
     value: state.context.value,
+    /**
+     * Function to set the value of the radio group
+     */
     setValue(value) {
       send({ type: "SET_VALUE", value, manual: true });
     },
+    /**
+     * Function to clear the value of the radio group
+     */
+    clearValue() {
+      send({ type: "SET_VALUE", value: null, manual: true });
+    },
+    /**
+     * Function to focus the radio group
+     */
     focus,
+    /**
+     * Function to blur the currently focused radio input in the radio group
+     */
     blur() {
       const focusedElement = dom.getActiveElement(state.context);
       const inputEls = dom.getInputEls(state.context);
@@ -197,10 +132,15 @@ function connect(state, send, normalize) {
       if (radioInputIsFocused)
         focusedElement?.blur();
     },
+    /**
+     * Returns the state details of a radio input
+     */
+    getRadioState,
     rootProps: normalize.element({
       ...parts.root.attrs,
       role: "radiogroup",
       id: dom.getRootId(state.context),
+      "aria-labelledby": dom.getLabelId(state.context),
       "data-orientation": state.context.orientation,
       "aria-orientation": state.context.orientation,
       dir: state.context.dir
@@ -253,7 +193,7 @@ function connect(state, send, normalize) {
       return normalize.element({
         ...parts.radioControl.attrs,
         id: dom.getRadioControlId(state.context, props.value),
-        "data-active": dataAttr(controlState.isActive),
+        "data-active": (0, import_dom_query2.dataAttr)(controlState.isActive),
         "aria-hidden": true,
         ...getRadioDataSet(props)
       });
@@ -297,14 +237,14 @@ function connect(state, send, normalize) {
         disabled: trulyDisabled,
         required: isRequired,
         defaultChecked: inputState.isChecked,
-        "data-disabled": dataAttr(inputState.isDisabled),
-        "aria-required": ariaAttr(isRequired),
-        "aria-invalid": ariaAttr(inputState.isInvalid),
+        "data-disabled": (0, import_dom_query2.dataAttr)(inputState.isDisabled),
+        "aria-required": (0, import_dom_query2.ariaAttr)(isRequired),
+        "aria-invalid": (0, import_dom_query2.ariaAttr)(inputState.isInvalid),
         readOnly: inputState.isReadOnly,
-        "data-readonly": dataAttr(inputState.isReadOnly),
-        "aria-disabled": ariaAttr(trulyDisabled),
-        "aria-checked": ariaAttr(inputState.isChecked),
-        style: visuallyHiddenStyle
+        "data-readonly": (0, import_dom_query2.dataAttr)(inputState.isReadOnly),
+        "aria-disabled": (0, import_dom_query2.ariaAttr)(trulyDisabled),
+        "aria-checked": (0, import_dom_query2.ariaAttr)(inputState.isChecked),
+        style: import_visually_hidden.visuallyHiddenStyle
       });
     }
   };
@@ -312,70 +252,10 @@ function connect(state, send, normalize) {
 
 // src/radio-group.machine.ts
 var import_core = require("@zag-js/core");
-
-// ../../utilities/form-utils/src/input-event.ts
-function getDescriptor(el, options) {
-  const { type, property = "value" } = options;
-  const proto = getWindow(el)[type].prototype;
-  return Object.getOwnPropertyDescriptor(proto, property) ?? {};
-}
-function dispatchInputCheckedEvent(el, checked) {
-  if (!el)
-    return;
-  const win = getWindow(el);
-  if (!(el instanceof win.HTMLInputElement))
-    return;
-  const desc = getDescriptor(el, { type: "HTMLInputElement", property: "checked" });
-  desc.set?.call(el, checked);
-  const event = new win.Event("click", { bubbles: true });
-  el.dispatchEvent(event);
-}
-
-// ../../utilities/form-utils/src/form.ts
-function getClosestForm(el) {
-  if (isFormElement(el))
-    return el.form;
-  else
-    return el.closest("form");
-}
-function isFormElement(el) {
-  return el.matches("textarea, input, select, button");
-}
-function trackFormReset(el, callback) {
-  if (!el)
-    return;
-  const form = getClosestForm(el);
-  form?.addEventListener("reset", callback, { passive: true });
-  return () => {
-    form?.removeEventListener("reset", callback);
-  };
-}
-function trackFieldsetDisabled(el, callback) {
-  const fieldset = el?.closest("fieldset");
-  if (!fieldset)
-    return;
-  callback(fieldset.disabled);
-  return observeAttributes(fieldset, ["disabled"], () => callback(fieldset.disabled));
-}
-function trackFormControl(el, options) {
-  if (!el)
-    return;
-  const { onFieldsetDisabled, onFormReset } = options;
-  const cleanups = [
-    trackFormReset(el, onFormReset),
-    trackFieldsetDisabled(el, (disabled) => {
-      if (disabled)
-        onFieldsetDisabled();
-    })
-  ];
-  return () => {
-    cleanups.forEach((cleanup) => cleanup?.());
-  };
-}
-
-// src/radio-group.machine.ts
+var import_form_utils = require("@zag-js/form-utils");
+var import_utils = require("@zag-js/utils");
 function machine(userContext) {
-  const ctx = compact(userContext);
+  const ctx = (0, import_utils.compact)(userContext);
   return (0, import_core.createMachine)(
     {
       id: "radio",
@@ -404,7 +284,7 @@ function machine(userContext) {
         }
       },
       watch: {
-        value: ["dispatchChangeEvent", "invokeOnChange"]
+        value: ["dispatchChangeEvent", "invokeOnChange", "syncInputElements"]
       },
       entry: ["checkValue"],
       states: {
@@ -414,7 +294,7 @@ function machine(userContext) {
     {
       activities: {
         trackFormControlState(ctx2, _evt, { send }) {
-          return trackFormControl(dom.getRootEl(ctx2), {
+          return (0, import_form_utils.trackFormControl)(dom.getRootEl(ctx2), {
             onFieldsetDisabled() {
               ctx2.disabled = true;
             },
@@ -447,7 +327,13 @@ function machine(userContext) {
           if (!evt.manual)
             return;
           const el = dom.getRadioInputEl(ctx2, evt.value);
-          dispatchInputCheckedEvent(el, !!evt.value);
+          (0, import_form_utils.dispatchInputCheckedEvent)(el, !!evt.value);
+        },
+        syncInputElements(ctx2) {
+          const inputs = dom.getInputEls(ctx2);
+          inputs.forEach((input) => {
+            input.checked = input.value === ctx2.value;
+          });
         }
       }
     }

package/dist/index.mjs

@@ -1,13 +1,13 @@
 import {
   connect
-} from "./chunk-F57UWPRI.mjs";
+} from "./chunk-57ZUFOAP.mjs";
 import {
   anatomy
 } from "./chunk-MGLN5L3R.mjs";
 import {
   machine
-} from "./chunk-IKYBQJIH.mjs";
-import "./chunk-CYVZAWTC.mjs";
+} from "./chunk-DYVEYVKH.mjs";
+import "./chunk-ITVKBCBK.mjs";
 export {
   anatomy,
   connect,

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

@@ -3,10 +3,39 @@ import { State, Send, RadioProps, InputProps } from './radio-group.types.js';
 import '@zag-js/core';
 
 declare function connect<T extends PropTypes>(state: State, send: Send, normalize: NormalizeProps<T>): {
+    /**
+     * The current value of the radio group
+     */
     value: string | null;
+    /**
+     * Function to set the value of the radio group
+     */
     setValue(value: string): void;
+    /**
+     * Function to clear the value of the radio group
+     */
+    clearValue(): void;
+    /**
+     * Function to focus the radio group
+     */
     focus: () => void;
+    /**
+     * Function to blur the currently focused radio input in the radio group
+     */
     blur(): void;
+    /**
+     * Returns the state details of a radio input
+     */
+    getRadioState: <T_1 extends RadioProps>(props: T_1) => {
+        isInteractive: boolean;
+        isReadOnly: boolean | undefined;
+        isInvalid: boolean | undefined;
+        isDisabled: boolean | undefined;
+        isChecked: boolean;
+        isFocused: boolean;
+        isHovered: boolean;
+        isActive: boolean;
+    };
     rootProps: T["element"];
     labelProps: T["element"];
     getRadioProps(props: RadioProps): T["label"];

package/dist/radio-group.connect.js

@@ -23,61 +23,8 @@ __export(radio_group_connect_exports, {
   connect: () => connect
 });
 module.exports = __toCommonJS(radio_group_connect_exports);
-
-// ../../utilities/dom/src/attrs.ts
-var dataAttr = (guard) => {
-  return guard ? "" : void 0;
-};
-var ariaAttr = (guard) => {
-  return guard ? "true" : void 0;
-};
-
-// ../../utilities/dom/src/query.ts
-function isDocument(el) {
-  return el.nodeType === Node.DOCUMENT_NODE;
-}
-function isWindow(value) {
-  return value?.toString() === "[object Window]";
-}
-function getDocument(el) {
-  if (isWindow(el))
-    return el.document;
-  if (isDocument(el))
-    return el;
-  return el?.ownerDocument ?? document;
-}
-function defineDomHelpers(helpers) {
-  const dom2 = {
-    getRootNode: (ctx) => ctx.getRootNode?.() ?? document,
-    getDoc: (ctx) => getDocument(dom2.getRootNode(ctx)),
-    getWin: (ctx) => dom2.getDoc(ctx).defaultView ?? window,
-    getActiveElement: (ctx) => dom2.getDoc(ctx).activeElement,
-    getById: (ctx, id) => dom2.getRootNode(ctx).getElementById(id)
-  };
-  return {
-    ...dom2,
-    ...helpers
-  };
-}
-
-// ../../utilities/dom/src/nodelist.ts
-function queryAll(root, selector) {
-  return Array.from(root?.querySelectorAll(selector) ?? []);
-}
-
-// ../../utilities/dom/src/visually-hidden.ts
-var visuallyHiddenStyle = {
-  border: "0",
-  clip: "rect(0 0 0 0)",
-  height: "1px",
-  margin: "-1px",
-  overflow: "hidden",
-  padding: "0",
-  position: "absolute",
-  width: "1px",
-  whiteSpace: "nowrap",
-  wordWrap: "normal"
-};
+var import_dom_query2 = require("@zag-js/dom-query");
+var import_visually_hidden = require("@zag-js/visually-hidden");
 
 // src/radio-group.anatomy.ts
 var import_anatomy = require("@zag-js/anatomy");
@@ -92,7 +39,8 @@ var anatomy = (0, import_anatomy.createAnatomy)("radio-group").parts(
 var parts = anatomy.build();
 
 // src/radio-group.dom.ts
-var dom = defineDomHelpers({
+var import_dom_query = require("@zag-js/dom-query");
+var dom = (0, import_dom_query.createScope)({
   getRootId: (ctx) => ctx.ids?.root ?? `radio-group:${ctx.id}`,
   getLabelId: (ctx) => ctx.ids?.label ?? `radio-group:${ctx.id}:label`,
   getRadioId: (ctx, value) => ctx.ids?.radio?.(value) ?? `radio-group:${ctx.id}:radio:${value}`,
@@ -106,7 +54,7 @@ var dom = defineDomHelpers({
   getInputEls: (ctx) => {
     const ownerId = CSS.escape(dom.getRootId(ctx));
     const selector = `input[type=radio][data-ownedby='${ownerId}']:not([disabled])`;
-    return queryAll(dom.getRootEl(ctx), selector);
+    return (0, import_dom_query.queryAll)(dom.getRootEl(ctx), selector);
   }
 });
 
@@ -132,12 +80,12 @@ function connect(state, send, normalize) {
   function getRadioDataSet(props) {
     const radioState = getRadioState(props);
     return {
-      "data-focus": dataAttr(radioState.isFocused),
-      "data-disabled": dataAttr(radioState.isDisabled),
-      "data-checked": dataAttr(radioState.isChecked),
-      "data-hover": dataAttr(radioState.isHovered),
-      "data-invalid": dataAttr(radioState.isInvalid),
-      "data-readonly": dataAttr(radioState.isReadOnly)
+      "data-focus": (0, import_dom_query2.dataAttr)(radioState.isFocused),
+      "data-disabled": (0, import_dom_query2.dataAttr)(radioState.isDisabled),
+      "data-checked": (0, import_dom_query2.dataAttr)(radioState.isChecked),
+      "data-hover": (0, import_dom_query2.dataAttr)(radioState.isHovered),
+      "data-invalid": (0, import_dom_query2.dataAttr)(radioState.isInvalid),
+      "data-readonly": (0, import_dom_query2.dataAttr)(radioState.isReadOnly)
     };
   }
   const focus = () => {
@@ -150,11 +98,29 @@ function connect(state, send, normalize) {
     firstEnabledInput?.focus();
   };
   return {
+    /**
+     * The current value of the radio group
+     */
     value: state.context.value,
+    /**
+     * Function to set the value of the radio group
+     */
     setValue(value) {
       send({ type: "SET_VALUE", value, manual: true });
     },
+    /**
+     * Function to clear the value of the radio group
+     */
+    clearValue() {
+      send({ type: "SET_VALUE", value: null, manual: true });
+    },
+    /**
+     * Function to focus the radio group
+     */
     focus,
+    /**
+     * Function to blur the currently focused radio input in the radio group
+     */
     blur() {
       const focusedElement = dom.getActiveElement(state.context);
       const inputEls = dom.getInputEls(state.context);
@@ -162,10 +128,15 @@ function connect(state, send, normalize) {
       if (radioInputIsFocused)
         focusedElement?.blur();
     },
+    /**
+     * Returns the state details of a radio input
+     */
+    getRadioState,
     rootProps: normalize.element({
       ...parts.root.attrs,
       role: "radiogroup",
       id: dom.getRootId(state.context),
+      "aria-labelledby": dom.getLabelId(state.context),
       "data-orientation": state.context.orientation,
       "aria-orientation": state.context.orientation,
       dir: state.context.dir
@@ -218,7 +189,7 @@ function connect(state, send, normalize) {
       return normalize.element({
         ...parts.radioControl.attrs,
         id: dom.getRadioControlId(state.context, props.value),
-        "data-active": dataAttr(controlState.isActive),
+        "data-active": (0, import_dom_query2.dataAttr)(controlState.isActive),
         "aria-hidden": true,
         ...getRadioDataSet(props)
       });
@@ -262,14 +233,14 @@ function connect(state, send, normalize) {
         disabled: trulyDisabled,
         required: isRequired,
         defaultChecked: inputState.isChecked,
-        "data-disabled": dataAttr(inputState.isDisabled),
-        "aria-required": ariaAttr(isRequired),
-        "aria-invalid": ariaAttr(inputState.isInvalid),
+        "data-disabled": (0, import_dom_query2.dataAttr)(inputState.isDisabled),
+        "aria-required": (0, import_dom_query2.ariaAttr)(isRequired),
+        "aria-invalid": (0, import_dom_query2.ariaAttr)(inputState.isInvalid),
         readOnly: inputState.isReadOnly,
-        "data-readonly": dataAttr(inputState.isReadOnly),
-        "aria-disabled": ariaAttr(trulyDisabled),
-        "aria-checked": ariaAttr(inputState.isChecked),
-        style: visuallyHiddenStyle
+        "data-readonly": (0, import_dom_query2.dataAttr)(inputState.isReadOnly),
+        "aria-disabled": (0, import_dom_query2.ariaAttr)(trulyDisabled),
+        "aria-checked": (0, import_dom_query2.ariaAttr)(inputState.isChecked),
+        style: import_visually_hidden.visuallyHiddenStyle
       });
     }
   };

package/dist/radio-group.connect.mjs

@@ -1,8 +1,8 @@
 import {
   connect
-} from "./chunk-F57UWPRI.mjs";
+} from "./chunk-57ZUFOAP.mjs";
 import "./chunk-MGLN5L3R.mjs";
-import "./chunk-CYVZAWTC.mjs";
+import "./chunk-ITVKBCBK.mjs";
 export {
   connect
 };

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

@@ -15,9 +15,12 @@ declare const dom: {
     getActiveElement: (ctx: {
         getRootNode?: (() => Node | Document | ShadowRoot) | undefined;
     }) => HTMLElement | null;
-    getById: <T = HTMLElement>(ctx: {
+    getById: <T extends HTMLElement = HTMLElement>(ctx: {
         getRootNode?: (() => Node | Document | ShadowRoot) | undefined;
     }, id: string) => T | null;
+    queryById: <T_1 extends HTMLElement = HTMLElement>(ctx: {
+        getRootNode?: (() => Node | Document | ShadowRoot) | undefined;
+    }, id: string) => T_1;
 } & {
     getRootId: (ctx: MachineContext) => string;
     getLabelId: (ctx: MachineContext) => string;
@@ -29,7 +32,7 @@ declare const dom: {
     getRadioInputEl: (ctx: MachineContext, value: string) => HTMLInputElement | null;
     getFirstEnabledInputEl: (ctx: MachineContext) => HTMLInputElement | null | undefined;
     getFirstEnabledAndCheckedInputEl: (ctx: MachineContext) => HTMLInputElement | null | undefined;
-    getInputEls: (ctx: MachineContext) => HTMLElement[];
+    getInputEls: (ctx: MachineContext) => HTMLInputElement[];
 };
 
 export { dom };

package/dist/radio-group.dom.js

@@ -23,42 +23,8 @@ __export(radio_group_dom_exports, {
   dom: () => dom
 });
 module.exports = __toCommonJS(radio_group_dom_exports);
-
-// ../../utilities/dom/src/query.ts
-function isDocument(el) {
-  return el.nodeType === Node.DOCUMENT_NODE;
-}
-function isWindow(value) {
-  return value?.toString() === "[object Window]";
-}
-function getDocument(el) {
-  if (isWindow(el))
-    return el.document;
-  if (isDocument(el))
-    return el;
-  return el?.ownerDocument ?? document;
-}
-function defineDomHelpers(helpers) {
-  const dom2 = {
-    getRootNode: (ctx) => ctx.getRootNode?.() ?? document,
-    getDoc: (ctx) => getDocument(dom2.getRootNode(ctx)),
-    getWin: (ctx) => dom2.getDoc(ctx).defaultView ?? window,
-    getActiveElement: (ctx) => dom2.getDoc(ctx).activeElement,
-    getById: (ctx, id) => dom2.getRootNode(ctx).getElementById(id)
-  };
-  return {
-    ...dom2,
-    ...helpers
-  };
-}
-
-// ../../utilities/dom/src/nodelist.ts
-function queryAll(root, selector) {
-  return Array.from(root?.querySelectorAll(selector) ?? []);
-}
-
-// src/radio-group.dom.ts
-var dom = defineDomHelpers({
+var import_dom_query = require("@zag-js/dom-query");
+var dom = (0, import_dom_query.createScope)({
   getRootId: (ctx) => ctx.ids?.root ?? `radio-group:${ctx.id}`,
   getLabelId: (ctx) => ctx.ids?.label ?? `radio-group:${ctx.id}:label`,
   getRadioId: (ctx, value) => ctx.ids?.radio?.(value) ?? `radio-group:${ctx.id}:radio:${value}`,
@@ -72,7 +38,7 @@ var dom = defineDomHelpers({
   getInputEls: (ctx) => {
     const ownerId = CSS.escape(dom.getRootId(ctx));
     const selector = `input[type=radio][data-ownedby='${ownerId}']:not([disabled])`;
-    return queryAll(dom.getRootEl(ctx), selector);
+    return (0, import_dom_query.queryAll)(dom.getRootEl(ctx), selector);
   }
 });
 // Annotate the CommonJS export names for ESM import in node:

package/dist/radio-group.dom.mjs

@@ -1,6 +1,6 @@
 import {
   dom
-} from "./chunk-CYVZAWTC.mjs";
+} from "./chunk-ITVKBCBK.mjs";
 export {
   dom
 };

package/dist/radio-group.machine.js

@@ -24,135 +24,12 @@ __export(radio_group_machine_exports, {
 });
 module.exports = __toCommonJS(radio_group_machine_exports);
 var import_core = require("@zag-js/core");
-
-// ../../utilities/core/src/guard.ts
-var isArray = (v) => Array.isArray(v);
-var isObject = (v) => !(v == null || typeof v !== "object" || isArray(v));
-
-// ../../utilities/core/src/object.ts
-function compact(obj) {
-  if (obj === void 0)
-    return obj;
-  return Object.fromEntries(
-    Object.entries(obj).filter(([, value]) => value !== void 0).map(([key, value]) => [key, isObject(value) ? compact(value) : value])
-  );
-}
-
-// ../../utilities/dom/src/query.ts
-function isDocument(el) {
-  return el.nodeType === Node.DOCUMENT_NODE;
-}
-function isWindow(value) {
-  return value?.toString() === "[object Window]";
-}
-function getDocument(el) {
-  if (isWindow(el))
-    return el.document;
-  if (isDocument(el))
-    return el;
-  return el?.ownerDocument ?? document;
-}
-function getWindow(el) {
-  return el?.ownerDocument.defaultView ?? window;
-}
-function defineDomHelpers(helpers) {
-  const dom2 = {
-    getRootNode: (ctx) => ctx.getRootNode?.() ?? document,
-    getDoc: (ctx) => getDocument(dom2.getRootNode(ctx)),
-    getWin: (ctx) => dom2.getDoc(ctx).defaultView ?? window,
-    getActiveElement: (ctx) => dom2.getDoc(ctx).activeElement,
-    getById: (ctx, id) => dom2.getRootNode(ctx).getElementById(id)
-  };
-  return {
-    ...dom2,
-    ...helpers
-  };
-}
-
-// ../../utilities/dom/src/mutation-observer.ts
-function observeAttributes(node, attributes, fn) {
-  if (!node)
-    return;
-  const attrs = Array.isArray(attributes) ? attributes : [attributes];
-  const win = node.ownerDocument.defaultView || window;
-  const obs = new win.MutationObserver((changes) => {
-    for (const change of changes) {
-      if (change.type === "attributes" && change.attributeName && attrs.includes(change.attributeName)) {
-        fn(change);
-      }
-    }
-  });
-  obs.observe(node, { attributes: true, attributeFilter: attrs });
-  return () => obs.disconnect();
-}
-
-// ../../utilities/dom/src/nodelist.ts
-function queryAll(root, selector) {
-  return Array.from(root?.querySelectorAll(selector) ?? []);
-}
-
-// ../../utilities/form-utils/src/input-event.ts
-function getDescriptor(el, options) {
-  const { type, property = "value" } = options;
-  const proto = getWindow(el)[type].prototype;
-  return Object.getOwnPropertyDescriptor(proto, property) ?? {};
-}
-function dispatchInputCheckedEvent(el, checked) {
-  if (!el)
-    return;
-  const win = getWindow(el);
-  if (!(el instanceof win.HTMLInputElement))
-    return;
-  const desc = getDescriptor(el, { type: "HTMLInputElement", property: "checked" });
-  desc.set?.call(el, checked);
-  const event = new win.Event("click", { bubbles: true });
-  el.dispatchEvent(event);
-}
-
-// ../../utilities/form-utils/src/form.ts
-function getClosestForm(el) {
-  if (isFormElement(el))
-    return el.form;
-  else
-    return el.closest("form");
-}
-function isFormElement(el) {
-  return el.matches("textarea, input, select, button");
-}
-function trackFormReset(el, callback) {
-  if (!el)
-    return;
-  const form = getClosestForm(el);
-  form?.addEventListener("reset", callback, { passive: true });
-  return () => {
-    form?.removeEventListener("reset", callback);
-  };
-}
-function trackFieldsetDisabled(el, callback) {
-  const fieldset = el?.closest("fieldset");
-  if (!fieldset)
-    return;
-  callback(fieldset.disabled);
-  return observeAttributes(fieldset, ["disabled"], () => callback(fieldset.disabled));
-}
-function trackFormControl(el, options) {
-  if (!el)
-    return;
-  const { onFieldsetDisabled, onFormReset } = options;
-  const cleanups = [
-    trackFormReset(el, onFormReset),
-    trackFieldsetDisabled(el, (disabled) => {
-      if (disabled)
-        onFieldsetDisabled();
-    })
-  ];
-  return () => {
-    cleanups.forEach((cleanup) => cleanup?.());
-  };
-}
+var import_form_utils = require("@zag-js/form-utils");
+var import_utils = require("@zag-js/utils");
 
 // src/radio-group.dom.ts
-var dom = defineDomHelpers({
+var import_dom_query = require("@zag-js/dom-query");
+var dom = (0, import_dom_query.createScope)({
   getRootId: (ctx) => ctx.ids?.root ?? `radio-group:${ctx.id}`,
   getLabelId: (ctx) => ctx.ids?.label ?? `radio-group:${ctx.id}:label`,
   getRadioId: (ctx, value) => ctx.ids?.radio?.(value) ?? `radio-group:${ctx.id}:radio:${value}`,
@@ -166,13 +43,13 @@ var dom = defineDomHelpers({
   getInputEls: (ctx) => {
     const ownerId = CSS.escape(dom.getRootId(ctx));
     const selector = `input[type=radio][data-ownedby='${ownerId}']:not([disabled])`;
-    return queryAll(dom.getRootEl(ctx), selector);
+    return (0, import_dom_query.queryAll)(dom.getRootEl(ctx), selector);
   }
 });
 
 // src/radio-group.machine.ts
 function machine(userContext) {
-  const ctx = compact(userContext);
+  const ctx = (0, import_utils.compact)(userContext);
   return (0, import_core.createMachine)(
     {
       id: "radio",
@@ -201,7 +78,7 @@ function machine(userContext) {
         }
       },
       watch: {
-        value: ["dispatchChangeEvent", "invokeOnChange"]
+        value: ["dispatchChangeEvent", "invokeOnChange", "syncInputElements"]
       },
       entry: ["checkValue"],
       states: {
@@ -211,7 +88,7 @@ function machine(userContext) {
     {
       activities: {
         trackFormControlState(ctx2, _evt, { send }) {
-          return trackFormControl(dom.getRootEl(ctx2), {
+          return (0, import_form_utils.trackFormControl)(dom.getRootEl(ctx2), {
             onFieldsetDisabled() {
               ctx2.disabled = true;
             },
@@ -244,7 +121,13 @@ function machine(userContext) {
           if (!evt.manual)
             return;
           const el = dom.getRadioInputEl(ctx2, evt.value);
-          dispatchInputCheckedEvent(el, !!evt.value);
+          (0, import_form_utils.dispatchInputCheckedEvent)(el, !!evt.value);
+        },
+        syncInputElements(ctx2) {
+          const inputs = dom.getInputEls(ctx2);
+          inputs.forEach((input) => {
+            input.checked = input.value === ctx2.value;
+          });
         }
       }
     }

package/dist/radio-group.machine.mjs

@@ -1,7 +1,7 @@
 import {
   machine
-} from "./chunk-IKYBQJIH.mjs";
-import "./chunk-CYVZAWTC.mjs";
+} from "./chunk-DYVEYVKH.mjs";
+import "./chunk-ITVKBCBK.mjs";
 export {
   machine
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zag-js/radio-group",
-  "version": "0.1.11",
+  "version": "0.2.0",
   "description": "Core logic for the radio group widget implemented as a state machine",
   "keywords": [
     "js",
@@ -27,15 +27,16 @@
     "url": "https://github.com/chakra-ui/zag/issues"
   },
   "dependencies": {
+    "@zag-js/dom-query": "0.1.3",
     "@zag-js/anatomy": "0.1.4",
-    "@zag-js/core": "0.2.8",
+    "@zag-js/core": "0.2.10",
+    "@zag-js/form-utils": "0.2.5",
+    "@zag-js/visually-hidden": "0.0.1",
+    "@zag-js/utils": "0.3.3",
     "@zag-js/types": "0.3.4"
   },
   "devDependencies": {
-    "clean-package": "2.2.0",
-    "@zag-js/dom-utils": "0.2.4",
-    "@zag-js/form-utils": "0.2.4",
-    "@zag-js/utils": "0.3.3"
+    "clean-package": "2.2.0"
   },
   "clean-package": "../../../clean-package.config.json",
   "main": "dist/index.js",

package/dist/chunk-IKYBQJIH.mjs

@@ -1,182 +0,0 @@
-import {
-  dom,
-  getWindow
-} from "./chunk-CYVZAWTC.mjs";
-
-// src/radio-group.machine.ts
-import { createMachine } from "@zag-js/core";
-
-// ../../utilities/core/src/guard.ts
-var isArray = (v) => Array.isArray(v);
-var isObject = (v) => !(v == null || typeof v !== "object" || isArray(v));
-
-// ../../utilities/core/src/object.ts
-function compact(obj) {
-  if (obj === void 0)
-    return obj;
-  return Object.fromEntries(
-    Object.entries(obj).filter(([, value]) => value !== void 0).map(([key, value]) => [key, isObject(value) ? compact(value) : value])
-  );
-}
-
-// ../../utilities/dom/src/mutation-observer.ts
-function observeAttributes(node, attributes, fn) {
-  if (!node)
-    return;
-  const attrs = Array.isArray(attributes) ? attributes : [attributes];
-  const win = node.ownerDocument.defaultView || window;
-  const obs = new win.MutationObserver((changes) => {
-    for (const change of changes) {
-      if (change.type === "attributes" && change.attributeName && attrs.includes(change.attributeName)) {
-        fn(change);
-      }
-    }
-  });
-  obs.observe(node, { attributes: true, attributeFilter: attrs });
-  return () => obs.disconnect();
-}
-
-// ../../utilities/form-utils/src/input-event.ts
-function getDescriptor(el, options) {
-  const { type, property = "value" } = options;
-  const proto = getWindow(el)[type].prototype;
-  return Object.getOwnPropertyDescriptor(proto, property) ?? {};
-}
-function dispatchInputCheckedEvent(el, checked) {
-  if (!el)
-    return;
-  const win = getWindow(el);
-  if (!(el instanceof win.HTMLInputElement))
-    return;
-  const desc = getDescriptor(el, { type: "HTMLInputElement", property: "checked" });
-  desc.set?.call(el, checked);
-  const event = new win.Event("click", { bubbles: true });
-  el.dispatchEvent(event);
-}
-
-// ../../utilities/form-utils/src/form.ts
-function getClosestForm(el) {
-  if (isFormElement(el))
-    return el.form;
-  else
-    return el.closest("form");
-}
-function isFormElement(el) {
-  return el.matches("textarea, input, select, button");
-}
-function trackFormReset(el, callback) {
-  if (!el)
-    return;
-  const form = getClosestForm(el);
-  form?.addEventListener("reset", callback, { passive: true });
-  return () => {
-    form?.removeEventListener("reset", callback);
-  };
-}
-function trackFieldsetDisabled(el, callback) {
-  const fieldset = el?.closest("fieldset");
-  if (!fieldset)
-    return;
-  callback(fieldset.disabled);
-  return observeAttributes(fieldset, ["disabled"], () => callback(fieldset.disabled));
-}
-function trackFormControl(el, options) {
-  if (!el)
-    return;
-  const { onFieldsetDisabled, onFormReset } = options;
-  const cleanups = [
-    trackFormReset(el, onFormReset),
-    trackFieldsetDisabled(el, (disabled) => {
-      if (disabled)
-        onFieldsetDisabled();
-    })
-  ];
-  return () => {
-    cleanups.forEach((cleanup) => cleanup?.());
-  };
-}
-
-// src/radio-group.machine.ts
-function machine(userContext) {
-  const ctx = compact(userContext);
-  return createMachine(
-    {
-      id: "radio",
-      initial: "idle",
-      context: {
-        value: null,
-        initialValue: null,
-        activeId: null,
-        focusedId: null,
-        hoveredId: null,
-        ...ctx
-      },
-      activities: ["trackFormControlState"],
-      on: {
-        SET_VALUE: {
-          actions: ["setValue"]
-        },
-        SET_HOVERED: {
-          actions: "setHovered"
-        },
-        SET_ACTIVE: {
-          actions: "setActive"
-        },
-        SET_FOCUSED: {
-          actions: "setFocused"
-        }
-      },
-      watch: {
-        value: ["dispatchChangeEvent", "invokeOnChange"]
-      },
-      entry: ["checkValue"],
-      states: {
-        idle: {}
-      }
-    },
-    {
-      activities: {
-        trackFormControlState(ctx2, _evt, { send }) {
-          return trackFormControl(dom.getRootEl(ctx2), {
-            onFieldsetDisabled() {
-              ctx2.disabled = true;
-            },
-            onFormReset() {
-              send({ type: "SET_VALUE", value: ctx2.initialValue });
-            }
-          });
-        }
-      },
-      actions: {
-        checkValue(ctx2) {
-          ctx2.initialValue = ctx2.value;
-        },
-        setValue(ctx2, evt) {
-          ctx2.value = evt.value;
-        },
-        setHovered(ctx2, evt) {
-          ctx2.hoveredId = evt.value;
-        },
-        setActive(ctx2, evt) {
-          ctx2.activeId = evt.value;
-        },
-        setFocused(ctx2, evt) {
-          ctx2.focusedId = evt.value;
-        },
-        invokeOnChange(ctx2, evt) {
-          ctx2.onChange?.({ value: evt.value });
-        },
-        dispatchChangeEvent(ctx2, evt) {
-          if (!evt.manual)
-            return;
-          const el = dom.getRadioInputEl(ctx2, evt.value);
-          dispatchInputCheckedEvent(el, !!evt.value);
-        }
-      }
-    }
-  );
-}
-
-export {
-  machine
-};