policyengine-household-wizard 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PolicyEngine
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,116 @@
+# policyengine-household-wizard
+
+Shared wizard primitives and a US household draft contract for PolicyEngine
+apps (cliff-watch, Coverage Compass, app-v2, and standalone calculators).
+
+The package ships two surfaces:
+
+- **Wizard primitives** — copy-neutral React primitives for step state, progress,
+  navigation, option cards, and review screens. No household-specific code.
+- **US household model** — a draft type that starts blank for state, age, and
+  marital status (issue #1044), validation rules, URL serialization,
+  state-filtered counties, and adapters to the PolicyEngine API V1 household
+  payload.
+
+## Install
+
+```bash
+bun add policyengine-household-wizard
+# or
+npm install policyengine-household-wizard
+```
+
+React 19 is a peer dependency.
+
+If you want the default look, import the stylesheet once:
+
+```ts
+import 'policyengine-household-wizard/styles.css';
+```
+
+The CSS uses ui-kit CSS variables (`--primary`, `--border`, `--accent`, …) when
+they're present, with safe fallbacks otherwise. Apps already on
+`@policyengine/ui-kit` will inherit the teal theme automatically.
+
+## Quick start
+
+```tsx
+import {
+  useWizardSteps,
+  WizardProgress,
+  WizardNavigation,
+  WizardOptionCard,
+  WizardReviewList,
+  createBlankDraft,
+  applyMaritalStatusChange,
+  validate,
+  toV1HouseholdPayload,
+  US_STATES,
+  getCountiesByState,
+  type USHouseholdDraft,
+} from 'policyengine-household-wizard';
+
+const steps = [
+  { id: 'location', label: 'Location', isComplete: (d: USHouseholdDraft) => !!d.state },
+  { id: 'marital', label: 'Marital status', isComplete: (d: USHouseholdDraft) => !!d.maritalStatus },
+  { id: 'review', label: 'Review' },
+];
+
+function MyWizard() {
+  const [draft, setDraft] = useState(createBlankDraft());
+  const wizard = useWizardSteps({ steps, state: draft });
+
+  // ...render WizardProgress, step bodies, WizardNavigation
+}
+```
+
+See [`docs/api.md`](docs/api.md) for the full API and [`docs/migration.md`](docs/migration.md)
+for migrating from each app's local wizard.
+
+## Design decisions
+
+- **Marital status, not filing status.** The wizard asks users marital status
+  in plain English; apps derive filing status (single, head of household,
+  married filing jointly, …) in their own model adapters.
+- **No defaults for state, age, or marital status.** `createBlankDraft()`
+  returns a draft with all three set to `null`/empty. The wizard explicitly
+  surfaces those fields rather than picking a quiet default like California or
+  age 30.
+- **State-filtered counties.** Counties come from a bundled JSON generated
+  from PolicyEngine US metadata. Use `getCountiesByState('CA')` to get the
+  options for the chosen state. Refresh with `bun run regenerate-counties`.
+- **Adapters, not a UI shell.** Apps render their own form layouts and pass
+  the draft through `validate()` and `toV1HouseholdPayload()` (or their own
+  app-specific adapter) at submit time.
+
+## Repository structure
+
+```
+src/
+  primitives/        useWizardSteps, WizardProgress, WizardNavigation, …
+  us-household/      types, draft, validate, normalize, serialize, counties
+    adapters/        toV1HouseholdPayload — PolicyEngine API V1 envelope
+    data/            counties-by-state.json
+tests/               vitest unit and round-trip tests
+scripts/             generate-counties.ts
+```
+
+## Development
+
+```bash
+bun install
+bun run test
+bun run typecheck
+bun run build
+```
+
+Changes follow the towncrier convention used by `@policyengine/ui-kit`. Add a
+fragment in `changelog.d/` before opening a PR:
+
+```bash
+echo "Describe your change." > changelog.d/your-branch.added.md
+```
+
+Fragment types: `added` (minor), `changed` (patch), `fixed` (patch),
+`removed` (minor), `breaking` (major). The release workflow on `main` bumps
+the version, builds the changelog, publishes to npm, and commits the bump.

package/dist/WizardReviewList-De9RTK_4.js

@@ -0,0 +1,245 @@
+import { useMemo as N, useState as P, useEffect as W, useRef as R, useCallback as b } from "react";
+import { jsxs as m, jsx as l, Fragment as V } from "react/jsx-runtime";
+function C(r, s) {
+  return r.filter((a) => a.isVisible ? a.isVisible(s) : !0);
+}
+function S(r) {
+  return { id: r.id, label: r.label };
+}
+function B(r, s) {
+  return r.length === 0 ? null : s && r.some((a) => a.id === s) ? s : r[0].id;
+}
+function D(r) {
+  const { steps: s, state: a, initialStepId: i, onStepChange: t } = r, e = N(
+    () => C(s, a),
+    [s, a]
+  ), o = N(
+    () => e.map(S),
+    [e]
+  ), u = N(
+    () => B(e, i),
+    // Only recompute when explicit initialStepId or the set of step ids changes.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [i]
+  ), [c, d] = P(u);
+  W(() => {
+    if (e.length === 0) {
+      c !== null && d(null);
+      return;
+    }
+    e.some((w) => w.id === c) || d(e[0].id);
+  }, [e, c]);
+  const f = R(t);
+  W(() => {
+    f.current = t;
+  }, [t]);
+  const v = b((p) => {
+    d((w) => {
+      var k;
+      return w === p ? w : ((k = f.current) == null || k.call(f, p), p);
+    });
+  }, []), n = N(
+    () => e.findIndex((p) => p.id === c),
+    [e, c]
+  ), h = n >= 0 ? e[n] : null, x = h ? S(h) : null, z = e.length, g = n <= 0, y = z === 0 ? !0 : n === z - 1, j = h != null && h.isComplete ? h.isComplete(a) : !0, M = b(() => {
+    n < 0 || n >= e.length - 1 || v(e[n + 1].id);
+  }, [n, e, v]), $ = b(() => {
+    n <= 0 || v(e[n - 1].id);
+  }, [n, e, v]), E = b(
+    (p) => {
+      e.some((w) => w.id === p) && v(p);
+    },
+    [e, v]
+  ), I = b(() => {
+    const p = B(e, i);
+    p && v(p);
+  }, [e, i, v]);
+  return {
+    visibleSteps: o,
+    currentStep: x,
+    currentStepIndex: n,
+    totalSteps: z,
+    isFirstStep: g,
+    isLastStep: y,
+    canAdvance: j,
+    goNext: M,
+    goBack: $,
+    goToStep: E,
+    reset: I
+  };
+}
+function O({
+  totalSteps: r,
+  currentStepIndex: s,
+  currentStepLabel: a,
+  className: i,
+  ...t
+}) {
+  const e = Math.max(r, 0), o = Math.max(0, Math.min(s, e - 1)), u = e > 0 ? (o + 1) / e * 100 : 0, c = e > 0 ? o + 1 : 0, d = { width: `${u}%` };
+  return /* @__PURE__ */ m(
+    "div",
+    {
+      role: "group",
+      "aria-label": t["aria-label"] ?? "Wizard progress",
+      className: ["pe-wizard-progress", i].filter(Boolean).join(" "),
+      ...t,
+      children: [
+        /* @__PURE__ */ m("div", { className: "pe-wizard-progress-topline", children: [
+          /* @__PURE__ */ m("span", { "data-testid": "pe-wizard-progress-step", children: [
+            "Step ",
+            c,
+            " of ",
+            e
+          ] }),
+          a ? /* @__PURE__ */ l("span", { "data-testid": "pe-wizard-progress-label", children: a }) : null
+        ] }),
+        /* @__PURE__ */ l(
+          "div",
+          {
+            className: "pe-wizard-progress-track",
+            role: "progressbar",
+            "aria-valuemin": 0,
+            "aria-valuemax": e,
+            "aria-valuenow": c,
+            "aria-valuetext": a,
+            children: /* @__PURE__ */ l("div", { className: "pe-wizard-progress-bar", style: d })
+          }
+        )
+      ]
+    }
+  );
+}
+function q({
+  selected: r = !1,
+  title: s,
+  description: a,
+  onSelect: i,
+  onClick: t,
+  className: e,
+  type: o,
+  disabled: u,
+  ...c
+}) {
+  const d = ["pe-wizard-option-card"];
+  return r && d.push("pe-wizard-option-card--selected"), e && d.push(e), /* @__PURE__ */ m(
+    "button",
+    {
+      type: o ?? "button",
+      role: "radio",
+      "aria-checked": r,
+      "aria-disabled": u ? !0 : void 0,
+      disabled: u,
+      className: d.join(" "),
+      onClick: (f) => {
+        u || (t == null || t(f), f.defaultPrevented || i == null || i());
+      },
+      ...c,
+      children: [
+        /* @__PURE__ */ l("span", { className: "pe-wizard-option-card-title", children: s }),
+        a ? /* @__PURE__ */ l("span", { className: "pe-wizard-option-card-description", children: a }) : null
+      ]
+    }
+  );
+}
+function A({
+  canAdvance: r,
+  isFirstStep: s,
+  isLastStep: a,
+  backLabel: i = "Back",
+  continueLabel: t = "Continue",
+  submitLabel: e = "Submit",
+  busyLabel: o,
+  busy: u = !1,
+  onBack: c,
+  onContinue: d,
+  onSubmit: f,
+  leadingActions: v,
+  trailingActions: n,
+  hideBack: h = !1,
+  className: x,
+  ...z
+}) {
+  const g = u || !r, y = u && o ? o : a ? e : t, j = () => {
+    g || (a ? f == null || f() : d == null || d());
+  };
+  return /* @__PURE__ */ m(
+    "div",
+    {
+      className: ["pe-wizard-nav", x].filter(Boolean).join(" "),
+      ...z,
+      children: [
+        v ? /* @__PURE__ */ l("div", { className: "pe-wizard-nav-leading", children: v }) : null,
+        h ? null : /* @__PURE__ */ l(
+          "button",
+          {
+            type: "button",
+            className: "pe-wizard-nav-back",
+            onClick: c,
+            disabled: s || u,
+            "aria-label": typeof i == "string" ? i : void 0,
+            children: i
+          }
+        ),
+        /* @__PURE__ */ l(
+          "button",
+          {
+            type: "button",
+            className: "pe-wizard-nav-primary",
+            onClick: j,
+            disabled: g,
+            "aria-disabled": g,
+            children: y
+          }
+        ),
+        n ? /* @__PURE__ */ l("div", { className: "pe-wizard-nav-trailing", children: n }) : null
+      ]
+    }
+  );
+}
+function G({ items: r, className: s, ...a }) {
+  return /* @__PURE__ */ l(
+    "div",
+    {
+      className: ["pe-wizard-review-list", s].filter(Boolean).join(" "),
+      role: "list",
+      ...a,
+      children: r.map((i) => {
+        const t = ["pe-wizard-review-item"];
+        i.missing && t.push("pe-wizard-review-item--missing");
+        const e = typeof i.onEdit == "function", o = /* @__PURE__ */ m(V, { children: [
+          /* @__PURE__ */ l("span", { className: "pe-wizard-review-item-label", children: i.label }),
+          /* @__PURE__ */ l("span", { className: "pe-wizard-review-item-value", children: i.missing && (i.value === null || i.value === void 0 || i.value === "") ? "Missing" : i.value })
+        ] });
+        return e ? /* @__PURE__ */ l(
+          "button",
+          {
+            type: "button",
+            role: "listitem",
+            className: t.join(" "),
+            "data-testid": `pe-wizard-review-${i.id}`,
+            onClick: i.onEdit,
+            "aria-label": typeof i.label == "string" ? `${i.editLabel ?? "Edit"} ${i.label}` : void 0,
+            children: o
+          },
+          i.id
+        ) : /* @__PURE__ */ l(
+          "div",
+          {
+            role: "listitem",
+            className: t.join(" "),
+            "data-testid": `pe-wizard-review-${i.id}`,
+            children: o
+          },
+          i.id
+        );
+      })
+    }
+  );
+}
+export {
+  A as W,
+  q as a,
+  O as b,
+  G as c,
+  D as u
+};

package/dist/WizardReviewList-tfP9LcqU.cjs

@@ -0,0 +1 @@
+"use strict";const o=require("react"),s=require("react/jsx-runtime");function B(r,t){return r.filter(a=>a.isVisible?a.isVisible(t):!0)}function k(r){return{id:r.id,label:r.label}}function y(r,t){return r.length===0?null:t&&r.some(a=>a.id===t)?t:r[0].id}function E(r){const{steps:t,state:a,initialStepId:i,onStepChange:n}=r,e=o.useMemo(()=>B(t,a),[t,a]),c=o.useMemo(()=>e.map(k),[e]),f=o.useMemo(()=>y(e,i),[i]),[u,d]=o.useState(f);o.useEffect(()=>{if(e.length===0){u!==null&&d(null);return}e.some(h=>h.id===u)||d(e[0].id)},[e,u]);const v=o.useRef(n);o.useEffect(()=>{v.current=n},[n]);const w=o.useCallback(p=>{d(h=>{var N;return h===p?h:((N=v.current)==null||N.call(v,p),p)})},[]),l=o.useMemo(()=>e.findIndex(p=>p.id===u),[e,u]),z=l>=0?e[l]:null,g=z?k(z):null,m=e.length,x=l<=0,j=m===0?!0:l===m-1,b=z!=null&&z.isComplete?z.isComplete(a):!0,W=o.useCallback(()=>{l<0||l>=e.length-1||w(e[l+1].id)},[l,e,w]),M=o.useCallback(()=>{l<=0||w(e[l-1].id)},[l,e,w]),C=o.useCallback(p=>{e.some(h=>h.id===p)&&w(p)},[e,w]),S=o.useCallback(()=>{const p=y(e,i);p&&w(p)},[e,i,w]);return{visibleSteps:c,currentStep:g,currentStepIndex:l,totalSteps:m,isFirstStep:x,isLastStep:j,canAdvance:b,goNext:W,goBack:M,goToStep:C,reset:S}}function R({totalSteps:r,currentStepIndex:t,currentStepLabel:a,className:i,...n}){const e=Math.max(r,0),c=Math.max(0,Math.min(t,e-1)),f=e>0?(c+1)/e*100:0,u=e>0?c+1:0,d={width:`${f}%`};return s.jsxs("div",{role:"group","aria-label":n["aria-label"]??"Wizard progress",className:["pe-wizard-progress",i].filter(Boolean).join(" "),...n,children:[s.jsxs("div",{className:"pe-wizard-progress-topline",children:[s.jsxs("span",{"data-testid":"pe-wizard-progress-step",children:["Step ",u," of ",e]}),a?s.jsx("span",{"data-testid":"pe-wizard-progress-label",children:a}):null]}),s.jsx("div",{className:"pe-wizard-progress-track",role:"progressbar","aria-valuemin":0,"aria-valuemax":e,"aria-valuenow":u,"aria-valuetext":a,children:s.jsx("div",{className:"pe-wizard-progress-bar",style:d})})]})}function $({selected:r=!1,title:t,description:a,onSelect:i,onClick:n,className:e,type:c,disabled:f,...u}){const d=["pe-wizard-option-card"];return r&&d.push("pe-wizard-option-card--selected"),e&&d.push(e),s.jsxs("button",{type:c??"button",role:"radio","aria-checked":r,"aria-disabled":f?!0:void 0,disabled:f,className:d.join(" "),onClick:v=>{f||(n==null||n(v),v.defaultPrevented||i==null||i())},...u,children:[s.jsx("span",{className:"pe-wizard-option-card-title",children:t}),a?s.jsx("span",{className:"pe-wizard-option-card-description",children:a}):null]})}function I({canAdvance:r,isFirstStep:t,isLastStep:a,backLabel:i="Back",continueLabel:n="Continue",submitLabel:e="Submit",busyLabel:c,busy:f=!1,onBack:u,onContinue:d,onSubmit:v,leadingActions:w,trailingActions:l,hideBack:z=!1,className:g,...m}){const x=f||!r,j=f&&c?c:a?e:n,b=()=>{x||(a?v==null||v():d==null||d())};return s.jsxs("div",{className:["pe-wizard-nav",g].filter(Boolean).join(" "),...m,children:[w?s.jsx("div",{className:"pe-wizard-nav-leading",children:w}):null,z?null:s.jsx("button",{type:"button",className:"pe-wizard-nav-back",onClick:u,disabled:t||f,"aria-label":typeof i=="string"?i:void 0,children:i}),s.jsx("button",{type:"button",className:"pe-wizard-nav-primary",onClick:b,disabled:x,"aria-disabled":x,children:j}),l?s.jsx("div",{className:"pe-wizard-nav-trailing",children:l}):null]})}function P({items:r,className:t,...a}){return s.jsx("div",{className:["pe-wizard-review-list",t].filter(Boolean).join(" "),role:"list",...a,children:r.map(i=>{const n=["pe-wizard-review-item"];i.missing&&n.push("pe-wizard-review-item--missing");const e=typeof i.onEdit=="function",c=s.jsxs(s.Fragment,{children:[s.jsx("span",{className:"pe-wizard-review-item-label",children:i.label}),s.jsx("span",{className:"pe-wizard-review-item-value",children:i.missing&&(i.value===null||i.value===void 0||i.value==="")?"Missing":i.value})]});return e?s.jsx("button",{type:"button",role:"listitem",className:n.join(" "),"data-testid":`pe-wizard-review-${i.id}`,onClick:i.onEdit,"aria-label":typeof i.label=="string"?`${i.editLabel??"Edit"} ${i.label}`:void 0,children:c},i.id):s.jsx("div",{role:"listitem",className:n.join(" "),"data-testid":`pe-wizard-review-${i.id}`,children:c},i.id)})})}exports.WizardNavigation=I;exports.WizardOptionCard=$;exports.WizardProgress=R;exports.WizardReviewList=P;exports.useWizardSteps=E;

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./WizardReviewList-tfP9LcqU.cjs"),e=require("./us-household.cjs"),a=require("./us-household-adapters.cjs");exports.WizardNavigation=t.WizardNavigation;exports.WizardOptionCard=t.WizardOptionCard;exports.WizardProgress=t.WizardProgress;exports.WizardReviewList=t.WizardReviewList;exports.useWizardSteps=t.useWizardSteps;exports.DEFAULT_HOUSEHOLD_YEAR=e.DEFAULT_HOUSEHOLD_YEAR;exports.US_STATES=e.US_STATES;exports.addPerson=e.addPerson;exports.applyMaritalStatusChange=e.applyMaritalStatusChange;exports.cloneDraft=e.cloneDraft;exports.createBlankDraft=e.createBlankDraft;exports.createPerson=e.createPerson;exports.deserializeDraft=e.deserializeDraft;exports.getAdults=e.getAdults;exports.getCountiesByState=e.getCountiesByState;exports.getCountyName=e.getCountyName;exports.getDependents=e.getDependents;exports.getStateFromZip=e.getStateFromZip;exports.getStateName=e.getStateName;exports.isComplete=e.isComplete;exports.isCountyCode=e.isCountyCode;exports.isUSStateCode=e.isUSStateCode;exports.normalizeLegacyDraft=e.normalizeLegacyDraft;exports.removePerson=e.removePerson;exports.resolveCountyCode=e.resolveCountyCode;exports.serializeDraft=e.serializeDraft;exports.updatePerson=e.updatePerson;exports.validate=e.validate;exports.toV1HouseholdPayload=a.toV1HouseholdPayload;exports.toV1HouseholdSituation=a.toV1HouseholdSituation;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './primitives';
+export * from './us-household';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,35 @@
+import { W as t, a as o, b as r, c as s, u as i } from "./WizardReviewList-De9RTK_4.js";
+import { DEFAULT_HOUSEHOLD_YEAR as n, US_STATES as l, addPerson as u, applyMaritalStatusChange as S, cloneDraft as p, createBlankDraft as g, createPerson as C, deserializeDraft as m, getAdults as f, getCountiesByState as z, getCountyName as D, getDependents as y, getStateFromZip as P, getStateName as W, isComplete as c, isCountyCode as v, isUSStateCode as A, normalizeLegacyDraft as E, removePerson as H, resolveCountyCode as L, serializeDraft as U, updatePerson as h, validate as x } from "./us-household.js";
+import { toV1HouseholdPayload as O, toV1HouseholdSituation as T } from "./us-household-adapters.js";
+export {
+  n as DEFAULT_HOUSEHOLD_YEAR,
+  l as US_STATES,
+  t as WizardNavigation,
+  o as WizardOptionCard,
+  r as WizardProgress,
+  s as WizardReviewList,
+  u as addPerson,
+  S as applyMaritalStatusChange,
+  p as cloneDraft,
+  g as createBlankDraft,
+  C as createPerson,
+  m as deserializeDraft,
+  f as getAdults,
+  z as getCountiesByState,
+  D as getCountyName,
+  y as getDependents,
+  P as getStateFromZip,
+  W as getStateName,
+  c as isComplete,
+  v as isCountyCode,
+  A as isUSStateCode,
+  E as normalizeLegacyDraft,
+  H as removePerson,
+  L as resolveCountyCode,
+  U as serializeDraft,
+  O as toV1HouseholdPayload,
+  T as toV1HouseholdSituation,
+  h as updatePerson,
+  i as useWizardSteps,
+  x as validate
+};

package/dist/primitives/WizardNavigation.d.ts

@@ -0,0 +1,19 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+export interface WizardNavigationProps extends HTMLAttributes<HTMLDivElement> {
+    canAdvance: boolean;
+    isFirstStep: boolean;
+    isLastStep: boolean;
+    backLabel?: ReactNode;
+    continueLabel?: ReactNode;
+    submitLabel?: ReactNode;
+    busyLabel?: ReactNode;
+    busy?: boolean;
+    onBack?: () => void;
+    onContinue?: () => void;
+    onSubmit?: () => void;
+    leadingActions?: ReactNode;
+    trailingActions?: ReactNode;
+    hideBack?: boolean;
+}
+export declare function WizardNavigation({ canAdvance, isFirstStep, isLastStep, backLabel, continueLabel, submitLabel, busyLabel, busy, onBack, onContinue, onSubmit, leadingActions, trailingActions, hideBack, className, ...rest }: WizardNavigationProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WizardNavigation.d.ts.map

package/dist/primitives/WizardNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WizardNavigation.d.ts","sourceRoot":"","sources":["../../src/primitives/WizardNavigation.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvD,MAAM,WAAW,qBAAsB,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC3E,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,UAAU,EACV,WAAW,EACX,UAAU,EACV,SAAkB,EAClB,aAA0B,EAC1B,WAAsB,EACtB,SAAS,EACT,IAAY,EACZ,MAAM,EACN,UAAU,EACV,QAAQ,EACR,cAAc,EACd,eAAe,EACf,QAAgB,EAChB,SAAS,EACT,GAAG,IAAI,EACR,EAAE,qBAAqB,2CAgDvB"}

package/dist/primitives/WizardOptionCard.d.ts

@@ -0,0 +1,9 @@
+import type { ButtonHTMLAttributes, ReactNode } from 'react';
+export interface WizardOptionCardProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'title' | 'onSelect'> {
+    selected?: boolean;
+    title: ReactNode;
+    description?: ReactNode;
+    onSelect?: () => void;
+}
+export declare function WizardOptionCard({ selected, title, description, onSelect, onClick, className, type, disabled, ...rest }: WizardOptionCardProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WizardOptionCard.d.ts.map

package/dist/primitives/WizardOptionCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WizardOptionCard.d.ts","sourceRoot":"","sources":["../../src/primitives/WizardOptionCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE7D,MAAM,WAAW,qBACf,SAAQ,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,QAAgB,EAChB,KAAK,EACL,WAAW,EACX,QAAQ,EACR,OAAO,EACP,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,GAAG,IAAI,EACR,EAAE,qBAAqB,2CAkCvB"}

package/dist/primitives/WizardProgress.d.ts

@@ -0,0 +1,8 @@
+import type { HTMLAttributes } from 'react';
+export interface WizardProgressProps extends HTMLAttributes<HTMLDivElement> {
+    totalSteps: number;
+    currentStepIndex: number;
+    currentStepLabel?: string;
+}
+export declare function WizardProgress({ totalSteps, currentStepIndex, currentStepLabel, className, ...rest }: WizardProgressProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WizardProgress.d.ts.map

package/dist/primitives/WizardProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WizardProgress.d.ts","sourceRoot":"","sources":["../../src/primitives/WizardProgress.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,OAAO,CAAC;AAE3D,MAAM,WAAW,mBAAoB,SAAQ,cAAc,CAAC,cAAc,CAAC;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,cAAc,CAAC,EAC7B,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,GAAG,IAAI,EACR,EAAE,mBAAmB,2CAmCrB"}

package/dist/primitives/WizardReviewList.d.ts

@@ -0,0 +1,14 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+export interface WizardReviewItem {
+    id: string;
+    label: ReactNode;
+    value: ReactNode;
+    missing?: boolean;
+    onEdit?: () => void;
+    editLabel?: ReactNode;
+}
+export interface WizardReviewListProps extends HTMLAttributes<HTMLDivElement> {
+    items: WizardReviewItem[];
+}
+export declare function WizardReviewList({ items, className, ...rest }: WizardReviewListProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WizardReviewList.d.ts.map

package/dist/primitives/WizardReviewList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WizardReviewList.d.ts","sourceRoot":"","sources":["../../src/primitives/WizardReviewList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,qBAAsB,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC3E,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,qBAAqB,2CAyDpF"}

package/dist/primitives/index.d.ts

@@ -0,0 +1,11 @@
+export { useWizardSteps } from './useWizardSteps';
+export { WizardProgress } from './WizardProgress';
+export type { WizardProgressProps } from './WizardProgress';
+export { WizardOptionCard } from './WizardOptionCard';
+export type { WizardOptionCardProps } from './WizardOptionCard';
+export { WizardNavigation } from './WizardNavigation';
+export type { WizardNavigationProps } from './WizardNavigation';
+export { WizardReviewList } from './WizardReviewList';
+export type { WizardReviewItem, WizardReviewListProps } from './WizardReviewList';
+export type { ResolvedWizardStep, UseWizardStepsOptions, UseWizardStepsResult, WizardStepConfig, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/primitives/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/primitives/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAClF,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/dist/primitives/types.d.ts

@@ -0,0 +1,30 @@
+export interface WizardStepConfig<TState> {
+    id: string;
+    label: string;
+    isComplete?: (state: TState) => boolean;
+    isVisible?: (state: TState) => boolean;
+}
+export interface ResolvedWizardStep {
+    id: string;
+    label: string;
+}
+export interface UseWizardStepsOptions<TState> {
+    steps: ReadonlyArray<WizardStepConfig<TState>>;
+    state: TState;
+    initialStepId?: string;
+    onStepChange?: (stepId: string) => void;
+}
+export interface UseWizardStepsResult {
+    visibleSteps: ResolvedWizardStep[];
+    currentStep: ResolvedWizardStep | null;
+    currentStepIndex: number;
+    totalSteps: number;
+    isFirstStep: boolean;
+    isLastStep: boolean;
+    canAdvance: boolean;
+    goNext: () => void;
+    goBack: () => void;
+    goToStep: (stepId: string) => void;
+    reset: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/primitives/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/primitives/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB,CAAC,MAAM;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACxC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB,CAAC,MAAM;IAC3C,KAAK,EAAE,aAAa,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,WAAW,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB"}

package/dist/primitives/useWizardSteps.d.ts

@@ -0,0 +1,3 @@
+import type { UseWizardStepsOptions, UseWizardStepsResult } from './types';
+export declare function useWizardSteps<TState>(options: UseWizardStepsOptions<TState>): UseWizardStepsResult;
+//# sourceMappingURL=useWizardSteps.d.ts.map

package/dist/primitives/useWizardSteps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWizardSteps.d.ts","sourceRoot":"","sources":["../../src/primitives/useWizardSteps.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,qBAAqB,EACrB,oBAAoB,EAErB,MAAM,SAAS,CAAC;AA4BjB,wBAAgB,cAAc,CAAC,MAAM,EACnC,OAAO,EAAE,qBAAqB,CAAC,MAAM,CAAC,GACrC,oBAAoB,CAiHtB"}

package/dist/primitives.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./WizardReviewList-tfP9LcqU.cjs");exports.WizardNavigation=i.WizardNavigation;exports.WizardOptionCard=i.WizardOptionCard;exports.WizardProgress=i.WizardProgress;exports.WizardReviewList=i.WizardReviewList;exports.useWizardSteps=i.useWizardSteps;

package/dist/primitives.d.ts

@@ -0,0 +1 @@
+export * from './primitives/index';

package/dist/primitives.js

@@ -0,0 +1,8 @@
+import { W as r, a as s, b as d, c as e, u as W } from "./WizardReviewList-De9RTK_4.js";
+export {
+  r as WizardNavigation,
+  s as WizardOptionCard,
+  d as WizardProgress,
+  e as WizardReviewList,
+  W as useWizardSteps
+};

package/dist/us-household/adapters/index.d.ts

@@ -0,0 +1,2 @@
+export { toV1HouseholdPayload, toV1HouseholdSituation, type V1EntityCollection, type V1EntityRecord, type V1FieldValue, type V1GroupCollection, type V1GroupRecord, type V1HouseholdEnvelope, type V1HouseholdSituation, type V1PersonCollection, type V1PersonRecord, type V1ValueMap, type ToV1PayloadOptions, } from './v1Payload';
+//# sourceMappingURL=index.d.ts.map

package/dist/us-household/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/us-household/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC"}