@zag-js/steps 0.0.0-dev-20240630000246

package/dist/index.mjs

@@ -0,0 +1,284 @@
+// src/steps.anatomy.ts
+import { createAnatomy } from "@zag-js/anatomy";
+var anatomy = createAnatomy("steps").parts(
+  "root",
+  "list",
+  "item",
+  "trigger",
+  "indicator",
+  "separator",
+  "content",
+  "title",
+  "description",
+  "nextTrigger",
+  "prevTrigger",
+  "progress"
+);
+var parts = anatomy.build();
+
+// src/steps.dom.ts
+import { createScope } from "@zag-js/dom-query";
+var dom = createScope({
+  getRootId: (ctx) => ctx.ids?.root ?? `steps:${ctx.id}`,
+  getListId: (ctx) => ctx.ids?.list ?? `steps:${ctx.id}:list`,
+  getTriggerId: (ctx, index) => ctx.ids?.triggerId?.(index) ?? `steps:${ctx.id}:trigger:${index}`,
+  getContentId: (ctx, index) => ctx.ids?.contentId?.(index) ?? `steps:${ctx.id}:content:${index}`
+});
+
+// src/steps.connect.ts
+import { dataAttr } from "@zag-js/dom-query";
+function connect(state, send, normalize) {
+  const value = state.context.step;
+  const count = state.context.count;
+  const percent = state.context.percent;
+  const hasNextStep = state.context.hasNextStep;
+  const hasPrevStep = state.context.hasPrevStep;
+  const getItemState = (props2) => ({
+    triggerId: dom.getTriggerId(state.context, props2.index),
+    contentId: dom.getContentId(state.context, props2.index),
+    current: props2.index === value,
+    completed: props2.index < value,
+    index: props2.index,
+    first: props2.index === 0,
+    last: props2.index === count - 1
+  });
+  const goToNextStep = () => {
+    send({ type: "STEP.NEXT", src: "next.trigger.click" });
+  };
+  const goToPrevStep = () => {
+    send({ type: "STEP.PREV", src: "prev.trigger.click" });
+  };
+  const resetStep = () => {
+    send({ type: "STEP.RESET", src: "reset.trigger.click" });
+  };
+  const setValue = (value2) => {
+    send({ type: "STEP.SET", value: value2, src: "api.setValue" });
+  };
+  return {
+    value,
+    count,
+    percent,
+    hasNextStep,
+    hasPrevStep,
+    goToNextStep,
+    goToPrevStep,
+    resetStep,
+    getItemState,
+    setValue,
+    getRootProps() {
+      return normalize.element({
+        ...parts.root.attrs,
+        id: dom.getRootId(state.context),
+        dir: state.context.dir,
+        "data-orientation": state.context.orientation,
+        style: {
+          "--percent": `${percent}%`
+        }
+      });
+    },
+    getListProps() {
+      return normalize.element({
+        ...parts.list.attrs,
+        dir: state.context.dir,
+        id: dom.getListId(state.context),
+        role: "tablist",
+        "aria-orientation": state.context.orientation,
+        "data-orientation": state.context.orientation
+      });
+    },
+    getItemProps(props2) {
+      const itemState = getItemState(props2);
+      return normalize.element({
+        ...parts.item.attrs,
+        dir: state.context.dir,
+        "aria-current": itemState.current ? "step" : void 0,
+        "data-orientation": state.context.orientation
+      });
+    },
+    getTriggerProps(props2) {
+      const itemState = getItemState(props2);
+      return normalize.button({
+        ...parts.trigger.attrs,
+        id: itemState.triggerId,
+        role: "tab",
+        dir: state.context.dir,
+        tabIndex: state.context.skippable || itemState.current ? 0 : -1,
+        "aria-selected": itemState.current,
+        "aria-controls": itemState.contentId,
+        "data-state": itemState.current ? "open" : "closed",
+        "data-orientation": state.context.orientation,
+        "data-complete": dataAttr(itemState.completed),
+        "data-current": dataAttr(itemState.current),
+        "data-incomplete": dataAttr(!itemState.current),
+        onClick(event) {
+          if (event.defaultPrevented) return;
+          if (!state.context.skippable) return;
+          send({ type: "STEP.SET", value: props2.index, src: "trigger.click" });
+        }
+      });
+    },
+    getContentProps(props2) {
+      const itemState = getItemState(props2);
+      return normalize.element({
+        ...parts.content.attrs,
+        dir: state.context.dir,
+        id: itemState.contentId,
+        role: "tabpanel",
+        tabIndex: 0,
+        hidden: !itemState.current,
+        "data-state": itemState.current ? "open" : "closed",
+        "data-orientation": state.context.orientation,
+        "aria-labelledby": itemState.triggerId
+      });
+    },
+    getIndicatorProps(props2) {
+      const itemState = getItemState(props2);
+      return normalize.element({
+        ...parts.indicator.attrs,
+        dir: state.context.dir,
+        "aria-hidden": true,
+        "data-complete": dataAttr(itemState.completed),
+        "data-current": dataAttr(itemState.current),
+        "data-incomplete": dataAttr(!itemState.current)
+      });
+    },
+    getSeparatorProps(props2) {
+      const itemState = getItemState(props2);
+      return normalize.element({
+        ...parts.separator.attrs,
+        dir: state.context.dir,
+        "data-orientation": state.context.orientation,
+        "data-complete": dataAttr(itemState.completed),
+        "data-current": dataAttr(itemState.current),
+        "data-incomplete": dataAttr(!itemState.current)
+      });
+    },
+    getNextTriggerProps() {
+      return normalize.button({
+        ...parts.nextTrigger.attrs,
+        dir: state.context.dir,
+        type: "button",
+        disabled: !hasNextStep,
+        onClick(event) {
+          if (event.defaultPrevented) return;
+          goToNextStep();
+        }
+      });
+    },
+    getPrevTriggerProps() {
+      return normalize.button({
+        dir: state.context.dir,
+        ...parts.prevTrigger.attrs,
+        type: "button",
+        disabled: !hasPrevStep,
+        onClick(event) {
+          if (event.defaultPrevented) return;
+          goToPrevStep();
+        }
+      });
+    },
+    getProgressProps() {
+      return normalize.element({
+        dir: state.context.dir,
+        ...parts.progress.attrs,
+        role: "progressbar",
+        "aria-valuenow": percent,
+        "aria-valuemin": 0,
+        "aria-valuemax": 100,
+        "aria-valuetext": `${percent}% complete`,
+        "data-complete": dataAttr(percent === 100)
+      });
+    }
+  };
+}
+
+// src/steps.machine.ts
+import { createMachine } from "@zag-js/core";
+import { compact, isEqual } from "@zag-js/utils";
+function machine(userContext) {
+  const ctx = compact(userContext);
+  return createMachine(
+    {
+      id: "steps",
+      initial: "idle",
+      context: {
+        step: 0,
+        count: 1,
+        ...ctx
+      },
+      computed: {
+        percent: (ctx2) => ctx2.step / ctx2.count * 100,
+        hasNextStep: (ctx2) => ctx2.step < ctx2.count,
+        hasPrevStep: (ctx2) => ctx2.step > 0
+      },
+      states: {
+        idle: {
+          on: {
+            "STEP.NEXT": {
+              actions: "goToNextStep"
+            },
+            "STEP.PREV": {
+              actions: "goToPrevStep"
+            },
+            "STEP.RESET": {
+              actions: "resetStep"
+            }
+          }
+        }
+      }
+    },
+    {
+      actions: {
+        goToNextStep(ctx2) {
+          const value = Math.min(ctx2.step + 1, ctx2.count);
+          set.value(ctx2, value);
+        },
+        goToPrevStep(ctx2) {
+          const value = Math.max(ctx2.step - 1, 0);
+          set.value(ctx2, value);
+        },
+        resetStep(ctx2) {
+          set.value(ctx2, 0);
+        },
+        setStep(ctx2, event) {
+          const value = event.value;
+          const inRange = value >= 0 && value < ctx2.count;
+          if (!inRange) throw new RangeError(`Index ${value} is out of bounds`);
+          set.value(ctx2, value);
+        }
+      }
+    }
+  );
+}
+var set = {
+  value(ctx, step) {
+    if (isEqual(ctx.step, step)) return;
+    ctx.step = step;
+    ctx.onStepChange?.({ step });
+  }
+};
+
+// src/steps.props.ts
+import { createProps } from "@zag-js/types";
+import { createSplitProps } from "@zag-js/utils";
+var props = createProps()([
+  "count",
+  "dir",
+  "getRootNode",
+  "id",
+  "ids",
+  "onStepChange",
+  "onStepComplete",
+  "orientation",
+  "skippable",
+  "step"
+]);
+var splitProps = createSplitProps(props);
+export {
+  anatomy,
+  connect,
+  machine,
+  props,
+  splitProps
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/steps.anatomy.ts","../src/steps.dom.ts","../src/steps.connect.ts","../src/steps.machine.ts","../src/steps.props.ts"],"sourcesContent":["import { createAnatomy } from \"@zag-js/anatomy\"\n\nexport const anatomy = createAnatomy(\"steps\").parts(\n  \"root\",\n  \"list\",\n  \"item\",\n  \"trigger\",\n  \"indicator\",\n  \"separator\",\n  \"content\",\n  \"title\",\n  \"description\",\n  \"nextTrigger\",\n  \"prevTrigger\",\n  \"progress\",\n)\n\nexport const parts = anatomy.build()\n","import { createScope } from \"@zag-js/dom-query\"\nimport type { MachineContext as Ctx } from \"./steps.types\"\n\nexport const dom = createScope({\n  getRootId: (ctx: Ctx) => ctx.ids?.root ?? `steps:${ctx.id}`,\n  getListId: (ctx: Ctx) => ctx.ids?.list ?? `steps:${ctx.id}:list`,\n  getTriggerId: (ctx: Ctx, index: number) => ctx.ids?.triggerId?.(index) ?? `steps:${ctx.id}:trigger:${index}`,\n  getContentId: (ctx: Ctx, index: number) => ctx.ids?.contentId?.(index) ?? `steps:${ctx.id}:content:${index}`,\n})\n","import type { NormalizeProps, PropTypes } from \"@zag-js/types\"\nimport type { State, Send, ItemProps, ItemState, MachineApi } from \"./steps.types\"\nimport { parts } from \"./steps.anatomy\"\nimport { dom } from \"./steps.dom\"\nimport { dataAttr } from \"@zag-js/dom-query\"\n\nexport function connect<T extends PropTypes>(state: State, send: Send, normalize: NormalizeProps<T>): MachineApi<T> {\n  const value = state.context.step\n  const count = state.context.count\n  const percent = state.context.percent\n  const hasNextStep = state.context.hasNextStep\n  const hasPrevStep = state.context.hasPrevStep\n\n  const getItemState = (props: ItemProps): ItemState => ({\n    triggerId: dom.getTriggerId(state.context, props.index),\n    contentId: dom.getContentId(state.context, props.index),\n    current: props.index === value,\n    completed: props.index < value,\n    index: props.index,\n    first: props.index === 0,\n    last: props.index === count - 1,\n  })\n\n  const goToNextStep = () => {\n    send({ type: \"STEP.NEXT\", src: \"next.trigger.click\" })\n  }\n\n  const goToPrevStep = () => {\n    send({ type: \"STEP.PREV\", src: \"prev.trigger.click\" })\n  }\n\n  const resetStep = () => {\n    send({ type: \"STEP.RESET\", src: \"reset.trigger.click\" })\n  }\n\n  const setValue = (value: number) => {\n    send({ type: \"STEP.SET\", value, src: \"api.setValue\" })\n  }\n\n  return {\n    value,\n    count,\n    percent,\n    hasNextStep,\n    hasPrevStep,\n    goToNextStep,\n    goToPrevStep,\n    resetStep,\n    getItemState,\n    setValue,\n\n    getRootProps() {\n      return normalize.element({\n        ...parts.root.attrs,\n        id: dom.getRootId(state.context),\n        dir: state.context.dir,\n        \"data-orientation\": state.context.orientation,\n        style: {\n          \"--percent\": `${percent}%`,\n        },\n      })\n    },\n\n    getListProps() {\n      return normalize.element({\n        ...parts.list.attrs,\n        dir: state.context.dir,\n        id: dom.getListId(state.context),\n        role: \"tablist\",\n        \"aria-orientation\": state.context.orientation,\n        \"data-orientation\": state.context.orientation,\n      })\n    },\n\n    getItemProps(props) {\n      const itemState = getItemState(props)\n      return normalize.element({\n        ...parts.item.attrs,\n        dir: state.context.dir,\n        \"aria-current\": itemState.current ? \"step\" : undefined,\n        \"data-orientation\": state.context.orientation,\n      })\n    },\n\n    getTriggerProps(props) {\n      const itemState = getItemState(props)\n      return normalize.button({\n        ...parts.trigger.attrs,\n        id: itemState.triggerId,\n        role: \"tab\",\n        dir: state.context.dir,\n        tabIndex: state.context.skippable || itemState.current ? 0 : -1,\n        \"aria-selected\": itemState.current,\n        \"aria-controls\": itemState.contentId,\n        \"data-state\": itemState.current ? \"open\" : \"closed\",\n        \"data-orientation\": state.context.orientation,\n        \"data-complete\": dataAttr(itemState.completed),\n        \"data-current\": dataAttr(itemState.current),\n        \"data-incomplete\": dataAttr(!itemState.current),\n        onClick(event) {\n          if (event.defaultPrevented) return\n          if (!state.context.skippable) return\n          send({ type: \"STEP.SET\", value: props.index, src: \"trigger.click\" })\n        },\n      })\n    },\n\n    getContentProps(props) {\n      const itemState = getItemState(props)\n      return normalize.element({\n        ...parts.content.attrs,\n        dir: state.context.dir,\n        id: itemState.contentId,\n        role: \"tabpanel\",\n        tabIndex: 0,\n        hidden: !itemState.current,\n        \"data-state\": itemState.current ? \"open\" : \"closed\",\n        \"data-orientation\": state.context.orientation,\n        \"aria-labelledby\": itemState.triggerId,\n      })\n    },\n\n    getIndicatorProps(props) {\n      const itemState = getItemState(props)\n      return normalize.element({\n        ...parts.indicator.attrs,\n        dir: state.context.dir,\n        \"aria-hidden\": true,\n        \"data-complete\": dataAttr(itemState.completed),\n        \"data-current\": dataAttr(itemState.current),\n        \"data-incomplete\": dataAttr(!itemState.current),\n      })\n    },\n\n    getSeparatorProps(props) {\n      const itemState = getItemState(props)\n      return normalize.element({\n        ...parts.separator.attrs,\n        dir: state.context.dir,\n        \"data-orientation\": state.context.orientation,\n        \"data-complete\": dataAttr(itemState.completed),\n        \"data-current\": dataAttr(itemState.current),\n        \"data-incomplete\": dataAttr(!itemState.current),\n      })\n    },\n\n    getNextTriggerProps() {\n      return normalize.button({\n        ...parts.nextTrigger.attrs,\n        dir: state.context.dir,\n        type: \"button\",\n        disabled: !hasNextStep,\n        onClick(event) {\n          if (event.defaultPrevented) return\n          goToNextStep()\n        },\n      })\n    },\n\n    getPrevTriggerProps() {\n      return normalize.button({\n        dir: state.context.dir,\n        ...parts.prevTrigger.attrs,\n        type: \"button\",\n        disabled: !hasPrevStep,\n        onClick(event) {\n          if (event.defaultPrevented) return\n          goToPrevStep()\n        },\n      })\n    },\n\n    getProgressProps() {\n      return normalize.element({\n        dir: state.context.dir,\n        ...parts.progress.attrs,\n        role: \"progressbar\",\n        \"aria-valuenow\": percent,\n        \"aria-valuemin\": 0,\n        \"aria-valuemax\": 100,\n        \"aria-valuetext\": `${percent}% complete`,\n        \"data-complete\": dataAttr(percent === 100),\n      })\n    },\n  }\n}\n","import { createMachine } from \"@zag-js/core\"\nimport { compact, isEqual } from \"@zag-js/utils\"\nimport type { MachineContext, MachineState, UserDefinedContext } from \"./steps.types\"\n\nexport function machine(userContext: UserDefinedContext) {\n  const ctx = compact(userContext)\n  return createMachine<MachineContext, MachineState>(\n    {\n      id: \"steps\",\n      initial: \"idle\",\n\n      context: {\n        step: 0,\n        count: 1,\n        ...ctx,\n      },\n\n      computed: {\n        percent: (ctx) => (ctx.step / ctx.count) * 100,\n        hasNextStep: (ctx) => ctx.step < ctx.count,\n        hasPrevStep: (ctx) => ctx.step > 0,\n      },\n\n      states: {\n        idle: {\n          on: {\n            \"STEP.NEXT\": {\n              actions: \"goToNextStep\",\n            },\n            \"STEP.PREV\": {\n              actions: \"goToPrevStep\",\n            },\n            \"STEP.RESET\": {\n              actions: \"resetStep\",\n            },\n          },\n        },\n      },\n    },\n    {\n      actions: {\n        goToNextStep(ctx) {\n          const value = Math.min(ctx.step + 1, ctx.count)\n          set.value(ctx, value)\n        },\n        goToPrevStep(ctx) {\n          const value = Math.max(ctx.step - 1, 0)\n          set.value(ctx, value)\n        },\n        resetStep(ctx) {\n          set.value(ctx, 0)\n        },\n        setStep(ctx, event) {\n          const value = event.value\n          const inRange = value >= 0 && value < ctx.count\n          if (!inRange) throw new RangeError(`Index ${value} is out of bounds`)\n          set.value(ctx, value)\n        },\n      },\n    },\n  )\n}\n\nconst set = {\n  value(ctx: MachineContext, step: number) {\n    if (isEqual(ctx.step, step)) return\n    ctx.step = step\n    ctx.onStepChange?.({ step })\n  },\n}\n","import { createProps } from \"@zag-js/types\"\nimport { createSplitProps } from \"@zag-js/utils\"\nimport type { UserDefinedContext } from \"./steps.types\"\n\nexport const props = createProps<UserDefinedContext>()([\n  \"count\",\n  \"dir\",\n  \"getRootNode\",\n  \"id\",\n  \"ids\",\n  \"onStepChange\",\n  \"onStepComplete\",\n  \"orientation\",\n  \"skippable\",\n  \"step\",\n])\n\nexport const splitProps = createSplitProps<Partial<UserDefinedContext>>(props)\n"],"mappings":";AAAA,SAAS,qBAAqB;AAEvB,IAAM,UAAU,cAAc,OAAO,EAAE;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,QAAQ,QAAQ,MAAM;;;ACjBnC,SAAS,mBAAmB;AAGrB,IAAM,MAAM,YAAY;AAAA,EAC7B,WAAW,CAAC,QAAa,IAAI,KAAK,QAAQ,SAAS,IAAI,EAAE;AAAA,EACzD,WAAW,CAAC,QAAa,IAAI,KAAK,QAAQ,SAAS,IAAI,EAAE;AAAA,EACzD,cAAc,CAAC,KAAU,UAAkB,IAAI,KAAK,YAAY,KAAK,KAAK,SAAS,IAAI,EAAE,YAAY,KAAK;AAAA,EAC1G,cAAc,CAAC,KAAU,UAAkB,IAAI,KAAK,YAAY,KAAK,KAAK,SAAS,IAAI,EAAE,YAAY,KAAK;AAC5G,CAAC;;;ACJD,SAAS,gBAAgB;AAElB,SAAS,QAA6B,OAAc,MAAY,WAA6C;AAClH,QAAM,QAAQ,MAAM,QAAQ;AAC5B,QAAM,QAAQ,MAAM,QAAQ;AAC5B,QAAM,UAAU,MAAM,QAAQ;AAC9B,QAAM,cAAc,MAAM,QAAQ;AAClC,QAAM,cAAc,MAAM,QAAQ;AAElC,QAAM,eAAe,CAACA,YAAiC;AAAA,IACrD,WAAW,IAAI,aAAa,MAAM,SAASA,OAAM,KAAK;AAAA,IACtD,WAAW,IAAI,aAAa,MAAM,SAASA,OAAM,KAAK;AAAA,IACtD,SAASA,OAAM,UAAU;AAAA,IACzB,WAAWA,OAAM,QAAQ;AAAA,IACzB,OAAOA,OAAM;AAAA,IACb,OAAOA,OAAM,UAAU;AAAA,IACvB,MAAMA,OAAM,UAAU,QAAQ;AAAA,EAChC;AAEA,QAAM,eAAe,MAAM;AACzB,SAAK,EAAE,MAAM,aAAa,KAAK,qBAAqB,CAAC;AAAA,EACvD;AAEA,QAAM,eAAe,MAAM;AACzB,SAAK,EAAE,MAAM,aAAa,KAAK,qBAAqB,CAAC;AAAA,EACvD;AAEA,QAAM,YAAY,MAAM;AACtB,SAAK,EAAE,MAAM,cAAc,KAAK,sBAAsB,CAAC;AAAA,EACzD;AAEA,QAAM,WAAW,CAACC,WAAkB;AAClC,SAAK,EAAE,MAAM,YAAY,OAAAA,QAAO,KAAK,eAAe,CAAC;AAAA,EACvD;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IAEA,eAAe;AACb,aAAO,UAAU,QAAQ;AAAA,QACvB,GAAG,MAAM,KAAK;AAAA,QACd,IAAI,IAAI,UAAU,MAAM,OAAO;AAAA,QAC/B,KAAK,MAAM,QAAQ;AAAA,QACnB,oBAAoB,MAAM,QAAQ;AAAA,QAClC,OAAO;AAAA,UACL,aAAa,GAAG,OAAO;AAAA,QACzB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IAEA,eAAe;AACb,aAAO,UAAU,QAAQ;AAAA,QACvB,GAAG,MAAM,KAAK;AAAA,QACd,KAAK,MAAM,QAAQ;AAAA,QACnB,IAAI,IAAI,UAAU,MAAM,OAAO;AAAA,QAC/B,MAAM;AAAA,QACN,oBAAoB,MAAM,QAAQ;AAAA,QAClC,oBAAoB,MAAM,QAAQ;AAAA,MACpC,CAAC;AAAA,IACH;AAAA,IAEA,aAAaD,QAAO;AAClB,YAAM,YAAY,aAAaA,MAAK;AACpC,aAAO,UAAU,QAAQ;AAAA,QACvB,GAAG,MAAM,KAAK;AAAA,QACd,KAAK,MAAM,QAAQ;AAAA,QACnB,gBAAgB,UAAU,UAAU,SAAS;AAAA,QAC7C,oBAAoB,MAAM,QAAQ;AAAA,MACpC,CAAC;AAAA,IACH;AAAA,IAEA,gBAAgBA,QAAO;AACrB,YAAM,YAAY,aAAaA,MAAK;AACpC,aAAO,UAAU,OAAO;AAAA,QACtB,GAAG,MAAM,QAAQ;AAAA,QACjB,IAAI,UAAU;AAAA,QACd,MAAM;AAAA,QACN,KAAK,MAAM,QAAQ;AAAA,QACnB,UAAU,MAAM,QAAQ,aAAa,UAAU,UAAU,IAAI;AAAA,QAC7D,iBAAiB,UAAU;AAAA,QAC3B,iBAAiB,UAAU;AAAA,QAC3B,cAAc,UAAU,UAAU,SAAS;AAAA,QAC3C,oBAAoB,MAAM,QAAQ;AAAA,QAClC,iBAAiB,SAAS,UAAU,SAAS;AAAA,QAC7C,gBAAgB,SAAS,UAAU,OAAO;AAAA,QAC1C,mBAAmB,SAAS,CAAC,UAAU,OAAO;AAAA,QAC9C,QAAQ,OAAO;AACb,cAAI,MAAM,iBAAkB;AAC5B,cAAI,CAAC,MAAM,QAAQ,UAAW;AAC9B,eAAK,EAAE,MAAM,YAAY,OAAOA,OAAM,OAAO,KAAK,gBAAgB,CAAC;AAAA,QACrE;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IAEA,gBAAgBA,QAAO;AACrB,YAAM,YAAY,aAAaA,MAAK;AACpC,aAAO,UAAU,QAAQ;AAAA,QACvB,GAAG,MAAM,QAAQ;AAAA,QACjB,KAAK,MAAM,QAAQ;AAAA,QACnB,IAAI,UAAU;AAAA,QACd,MAAM;AAAA,QACN,UAAU;AAAA,QACV,QAAQ,CAAC,UAAU;AAAA,QACnB,cAAc,UAAU,UAAU,SAAS;AAAA,QAC3C,oBAAoB,MAAM,QAAQ;AAAA,QAClC,mBAAmB,UAAU;AAAA,MAC/B,CAAC;AAAA,IACH;AAAA,IAEA,kBAAkBA,QAAO;AACvB,YAAM,YAAY,aAAaA,MAAK;AACpC,aAAO,UAAU,QAAQ;AAAA,QACvB,GAAG,MAAM,UAAU;AAAA,QACnB,KAAK,MAAM,QAAQ;AAAA,QACnB,eAAe;AAAA,QACf,iBAAiB,SAAS,UAAU,SAAS;AAAA,QAC7C,gBAAgB,SAAS,UAAU,OAAO;AAAA,QAC1C,mBAAmB,SAAS,CAAC,UAAU,OAAO;AAAA,MAChD,CAAC;AAAA,IACH;AAAA,IAEA,kBAAkBA,QAAO;AACvB,YAAM,YAAY,aAAaA,MAAK;AACpC,aAAO,UAAU,QAAQ;AAAA,QACvB,GAAG,MAAM,UAAU;AAAA,QACnB,KAAK,MAAM,QAAQ;AAAA,QACnB,oBAAoB,MAAM,QAAQ;AAAA,QAClC,iBAAiB,SAAS,UAAU,SAAS;AAAA,QAC7C,gBAAgB,SAAS,UAAU,OAAO;AAAA,QAC1C,mBAAmB,SAAS,CAAC,UAAU,OAAO;AAAA,MAChD,CAAC;AAAA,IACH;AAAA,IAEA,sBAAsB;AACpB,aAAO,UAAU,OAAO;AAAA,QACtB,GAAG,MAAM,YAAY;AAAA,QACrB,KAAK,MAAM,QAAQ;AAAA,QACnB,MAAM;AAAA,QACN,UAAU,CAAC;AAAA,QACX,QAAQ,OAAO;AACb,cAAI,MAAM,iBAAkB;AAC5B,uBAAa;AAAA,QACf;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IAEA,sBAAsB;AACpB,aAAO,UAAU,OAAO;AAAA,QACtB,KAAK,MAAM,QAAQ;AAAA,QACnB,GAAG,MAAM,YAAY;AAAA,QACrB,MAAM;AAAA,QACN,UAAU,CAAC;AAAA,QACX,QAAQ,OAAO;AACb,cAAI,MAAM,iBAAkB;AAC5B,uBAAa;AAAA,QACf;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IAEA,mBAAmB;AACjB,aAAO,UAAU,QAAQ;AAAA,QACvB,KAAK,MAAM,QAAQ;AAAA,QACnB,GAAG,MAAM,SAAS;AAAA,QAClB,MAAM;AAAA,QACN,iBAAiB;AAAA,QACjB,iBAAiB;AAAA,QACjB,iBAAiB;AAAA,QACjB,kBAAkB,GAAG,OAAO;AAAA,QAC5B,iBAAiB,SAAS,YAAY,GAAG;AAAA,MAC3C,CAAC;AAAA,IACH;AAAA,EACF;AACF;;;ACzLA,SAAS,qBAAqB;AAC9B,SAAS,SAAS,eAAe;AAG1B,SAAS,QAAQ,aAAiC;AACvD,QAAM,MAAM,QAAQ,WAAW;AAC/B,SAAO;AAAA,IACL;AAAA,MACE,IAAI;AAAA,MACJ,SAAS;AAAA,MAET,SAAS;AAAA,QACP,MAAM;AAAA,QACN,OAAO;AAAA,QACP,GAAG;AAAA,MACL;AAAA,MAEA,UAAU;AAAA,QACR,SAAS,CAACE,SAASA,KAAI,OAAOA,KAAI,QAAS;AAAA,QAC3C,aAAa,CAACA,SAAQA,KAAI,OAAOA,KAAI;AAAA,QACrC,aAAa,CAACA,SAAQA,KAAI,OAAO;AAAA,MACnC;AAAA,MAEA,QAAQ;AAAA,QACN,MAAM;AAAA,UACJ,IAAI;AAAA,YACF,aAAa;AAAA,cACX,SAAS;AAAA,YACX;AAAA,YACA,aAAa;AAAA,cACX,SAAS;AAAA,YACX;AAAA,YACA,cAAc;AAAA,cACZ,SAAS;AAAA,YACX;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IACA;AAAA,MACE,SAAS;AAAA,QACP,aAAaA,MAAK;AAChB,gBAAM,QAAQ,KAAK,IAAIA,KAAI,OAAO,GAAGA,KAAI,KAAK;AAC9C,cAAI,MAAMA,MAAK,KAAK;AAAA,QACtB;AAAA,QACA,aAAaA,MAAK;AAChB,gBAAM,QAAQ,KAAK,IAAIA,KAAI,OAAO,GAAG,CAAC;AACtC,cAAI,MAAMA,MAAK,KAAK;AAAA,QACtB;AAAA,QACA,UAAUA,MAAK;AACb,cAAI,MAAMA,MAAK,CAAC;AAAA,QAClB;AAAA,QACA,QAAQA,MAAK,OAAO;AAClB,gBAAM,QAAQ,MAAM;AACpB,gBAAM,UAAU,SAAS,KAAK,QAAQA,KAAI;AAC1C,cAAI,CAAC,QAAS,OAAM,IAAI,WAAW,SAAS,KAAK,mBAAmB;AACpE,cAAI,MAAMA,MAAK,KAAK;AAAA,QACtB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAM,MAAM;AAAA,EACV,MAAM,KAAqB,MAAc;AACvC,QAAI,QAAQ,IAAI,MAAM,IAAI,EAAG;AAC7B,QAAI,OAAO;AACX,QAAI,eAAe,EAAE,KAAK,CAAC;AAAA,EAC7B;AACF;;;ACrEA,SAAS,mBAAmB;AAC5B,SAAS,wBAAwB;AAG1B,IAAM,QAAQ,YAAgC,EAAE;AAAA,EACrD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,IAAM,aAAa,iBAA8C,KAAK;","names":["props","value","ctx"]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@zag-js/steps",
+  "version": "0.0.0-dev-20240630000246",
+  "description": "Core logic for the steps widget implemented as a state machine",
+  "keywords": [
+    "js",
+    "machine",
+    "xstate",
+    "statechart",
+    "component",
+    "chakra-ui",
+    "steps"
+  ],
+  "author": "Segun Adebayo <sage@adebayosegun.com>",
+  "homepage": "https://github.com/chakra-ui/zag#readme",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "repository": "https://github.com/chakra-ui/zag/tree/main/packages/steps",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "bugs": {
+    "url": "https://github.com/chakra-ui/zag/issues"
+  },
+  "dependencies": {
+    "@zag-js/anatomy": "0.0.0-dev-20240630000246",
+    "@zag-js/core": "0.0.0-dev-20240630000246",
+    "@zag-js/dom-query": "0.0.0-dev-20240630000246",
+    "@zag-js/utils": "0.0.0-dev-20240630000246",
+    "@zag-js/types": "0.0.0-dev-20240630000246"
+  },
+  "devDependencies": {
+    "clean-package": "2.2.0"
+  },
+  "clean-package": "../../../clean-package.config.json",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsup",
+    "lint": "eslint src --ext .ts,.tsx",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/index.ts

@@ -0,0 +1,13 @@
+export { anatomy } from "./steps.anatomy"
+export { connect } from "./steps.connect"
+export { machine } from "./steps.machine"
+export * from "./steps.props"
+export type {
+  MachineApi as Api,
+  UserDefinedContext as Context,
+  ElementIds,
+  ItemProps,
+  ItemState,
+  Service,
+  StepChangeDetails,
+} from "./steps.types"

package/src/steps.anatomy.ts

@@ -0,0 +1,18 @@
+import { createAnatomy } from "@zag-js/anatomy"
+
+export const anatomy = createAnatomy("steps").parts(
+  "root",
+  "list",
+  "item",
+  "trigger",
+  "indicator",
+  "separator",
+  "content",
+  "title",
+  "description",
+  "nextTrigger",
+  "prevTrigger",
+  "progress",
+)
+
+export const parts = anatomy.build()

package/src/steps.connect.ts

@@ -0,0 +1,186 @@
+import type { NormalizeProps, PropTypes } from "@zag-js/types"
+import type { State, Send, ItemProps, ItemState, MachineApi } from "./steps.types"
+import { parts } from "./steps.anatomy"
+import { dom } from "./steps.dom"
+import { dataAttr } from "@zag-js/dom-query"
+
+export function connect<T extends PropTypes>(state: State, send: Send, normalize: NormalizeProps<T>): MachineApi<T> {
+  const value = state.context.step
+  const count = state.context.count
+  const percent = state.context.percent
+  const hasNextStep = state.context.hasNextStep
+  const hasPrevStep = state.context.hasPrevStep
+
+  const getItemState = (props: ItemProps): ItemState => ({
+    triggerId: dom.getTriggerId(state.context, props.index),
+    contentId: dom.getContentId(state.context, props.index),
+    current: props.index === value,
+    completed: props.index < value,
+    index: props.index,
+    first: props.index === 0,
+    last: props.index === count - 1,
+  })
+
+  const goToNextStep = () => {
+    send({ type: "STEP.NEXT", src: "next.trigger.click" })
+  }
+
+  const goToPrevStep = () => {
+    send({ type: "STEP.PREV", src: "prev.trigger.click" })
+  }
+
+  const resetStep = () => {
+    send({ type: "STEP.RESET", src: "reset.trigger.click" })
+  }
+
+  const setValue = (value: number) => {
+    send({ type: "STEP.SET", value, src: "api.setValue" })
+  }
+
+  return {
+    value,
+    count,
+    percent,
+    hasNextStep,
+    hasPrevStep,
+    goToNextStep,
+    goToPrevStep,
+    resetStep,
+    getItemState,
+    setValue,
+
+    getRootProps() {
+      return normalize.element({
+        ...parts.root.attrs,
+        id: dom.getRootId(state.context),
+        dir: state.context.dir,
+        "data-orientation": state.context.orientation,
+        style: {
+          "--percent": `${percent}%`,
+        },
+      })
+    },
+
+    getListProps() {
+      return normalize.element({
+        ...parts.list.attrs,
+        dir: state.context.dir,
+        id: dom.getListId(state.context),
+        role: "tablist",
+        "aria-orientation": state.context.orientation,
+        "data-orientation": state.context.orientation,
+      })
+    },
+
+    getItemProps(props) {
+      const itemState = getItemState(props)
+      return normalize.element({
+        ...parts.item.attrs,
+        dir: state.context.dir,
+        "aria-current": itemState.current ? "step" : undefined,
+        "data-orientation": state.context.orientation,
+      })
+    },
+
+    getTriggerProps(props) {
+      const itemState = getItemState(props)
+      return normalize.button({
+        ...parts.trigger.attrs,
+        id: itemState.triggerId,
+        role: "tab",
+        dir: state.context.dir,
+        tabIndex: state.context.skippable || itemState.current ? 0 : -1,
+        "aria-selected": itemState.current,
+        "aria-controls": itemState.contentId,
+        "data-state": itemState.current ? "open" : "closed",
+        "data-orientation": state.context.orientation,
+        "data-complete": dataAttr(itemState.completed),
+        "data-current": dataAttr(itemState.current),
+        "data-incomplete": dataAttr(!itemState.current),
+        onClick(event) {
+          if (event.defaultPrevented) return
+          if (!state.context.skippable) return
+          send({ type: "STEP.SET", value: props.index, src: "trigger.click" })
+        },
+      })
+    },
+
+    getContentProps(props) {
+      const itemState = getItemState(props)
+      return normalize.element({
+        ...parts.content.attrs,
+        dir: state.context.dir,
+        id: itemState.contentId,
+        role: "tabpanel",
+        tabIndex: 0,
+        hidden: !itemState.current,
+        "data-state": itemState.current ? "open" : "closed",
+        "data-orientation": state.context.orientation,
+        "aria-labelledby": itemState.triggerId,
+      })
+    },
+
+    getIndicatorProps(props) {
+      const itemState = getItemState(props)
+      return normalize.element({
+        ...parts.indicator.attrs,
+        dir: state.context.dir,
+        "aria-hidden": true,
+        "data-complete": dataAttr(itemState.completed),
+        "data-current": dataAttr(itemState.current),
+        "data-incomplete": dataAttr(!itemState.current),
+      })
+    },
+
+    getSeparatorProps(props) {
+      const itemState = getItemState(props)
+      return normalize.element({
+        ...parts.separator.attrs,
+        dir: state.context.dir,
+        "data-orientation": state.context.orientation,
+        "data-complete": dataAttr(itemState.completed),
+        "data-current": dataAttr(itemState.current),
+        "data-incomplete": dataAttr(!itemState.current),
+      })
+    },
+
+    getNextTriggerProps() {
+      return normalize.button({
+        ...parts.nextTrigger.attrs,
+        dir: state.context.dir,
+        type: "button",
+        disabled: !hasNextStep,
+        onClick(event) {
+          if (event.defaultPrevented) return
+          goToNextStep()
+        },
+      })
+    },
+
+    getPrevTriggerProps() {
+      return normalize.button({
+        dir: state.context.dir,
+        ...parts.prevTrigger.attrs,
+        type: "button",
+        disabled: !hasPrevStep,
+        onClick(event) {
+          if (event.defaultPrevented) return
+          goToPrevStep()
+        },
+      })
+    },
+
+    getProgressProps() {
+      return normalize.element({
+        dir: state.context.dir,
+        ...parts.progress.attrs,
+        role: "progressbar",
+        "aria-valuenow": percent,
+        "aria-valuemin": 0,
+        "aria-valuemax": 100,
+        "aria-valuetext": `${percent}% complete`,
+        "data-complete": dataAttr(percent === 100),
+      })
+    },
+  }
+}

package/src/steps.dom.ts

@@ -0,0 +1,9 @@
+import { createScope } from "@zag-js/dom-query"
+import type { MachineContext as Ctx } from "./steps.types"
+
+export const dom = createScope({
+  getRootId: (ctx: Ctx) => ctx.ids?.root ?? `steps:${ctx.id}`,
+  getListId: (ctx: Ctx) => ctx.ids?.list ?? `steps:${ctx.id}:list`,
+  getTriggerId: (ctx: Ctx, index: number) => ctx.ids?.triggerId?.(index) ?? `steps:${ctx.id}:trigger:${index}`,
+  getContentId: (ctx: Ctx, index: number) => ctx.ids?.contentId?.(index) ?? `steps:${ctx.id}:content:${index}`,
+})

package/src/steps.machine.ts

@@ -0,0 +1,70 @@
+import { createMachine } from "@zag-js/core"
+import { compact, isEqual } from "@zag-js/utils"
+import type { MachineContext, MachineState, UserDefinedContext } from "./steps.types"
+
+export function machine(userContext: UserDefinedContext) {
+  const ctx = compact(userContext)
+  return createMachine<MachineContext, MachineState>(
+    {
+      id: "steps",
+      initial: "idle",
+
+      context: {
+        step: 0,
+        count: 1,
+        ...ctx,
+      },
+
+      computed: {
+        percent: (ctx) => (ctx.step / ctx.count) * 100,
+        hasNextStep: (ctx) => ctx.step < ctx.count,
+        hasPrevStep: (ctx) => ctx.step > 0,
+      },
+
+      states: {
+        idle: {
+          on: {
+            "STEP.NEXT": {
+              actions: "goToNextStep",
+            },
+            "STEP.PREV": {
+              actions: "goToPrevStep",
+            },
+            "STEP.RESET": {
+              actions: "resetStep",
+            },
+          },
+        },
+      },
+    },
+    {
+      actions: {
+        goToNextStep(ctx) {
+          const value = Math.min(ctx.step + 1, ctx.count)
+          set.value(ctx, value)
+        },
+        goToPrevStep(ctx) {
+          const value = Math.max(ctx.step - 1, 0)
+          set.value(ctx, value)
+        },
+        resetStep(ctx) {
+          set.value(ctx, 0)
+        },
+        setStep(ctx, event) {
+          const value = event.value
+          const inRange = value >= 0 && value < ctx.count
+          if (!inRange) throw new RangeError(`Index ${value} is out of bounds`)
+          set.value(ctx, value)
+        },
+      },
+    },
+  )
+}
+
+const set = {
+  value(ctx: MachineContext, step: number) {
+    if (isEqual(ctx.step, step)) return
+    ctx.step = step
+    ctx.onStepChange?.({ step })
+  },
+}

package/src/steps.props.ts

@@ -0,0 +1,18 @@
+import { createProps } from "@zag-js/types"
+import { createSplitProps } from "@zag-js/utils"
+import type { UserDefinedContext } from "./steps.types"
+
+export const props = createProps<UserDefinedContext>()([
+  "count",
+  "dir",
+  "getRootNode",
+  "id",
+  "ids",
+  "onStepChange",
+  "onStepComplete",
+  "orientation",
+  "skippable",
+  "step",
+])
+
+export const splitProps = createSplitProps<Partial<UserDefinedContext>>(props)