@getrheo/flow-ui-state 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { InputDraft, InputValidity, ScreenInputDraftProvider, useScreenInputDraft, useScreenInputValidity } from './screenInputDraft.js';
+export { ScreenCheckboxAckProvider, computeCheckboxContinueBlocked, listBlockingCheckboxes, useCheckboxContinueBlocked, useScreenCheckboxAck } from './screenCheckboxAck.js';
+import 'react/jsx-runtime';
+import 'react';
+import '@getrheo/contracts/screens';
+import '@getrheo/flow-runtime/stateMachine';
+import '@getrheo/contracts/layers';

package/dist/index.js

@@ -0,0 +1,23 @@
+import {
+  ScreenInputDraftProvider,
+  useScreenInputDraft,
+  useScreenInputValidity
+} from "./screenInputDraft";
+import {
+  ScreenCheckboxAckProvider,
+  useScreenCheckboxAck,
+  useCheckboxContinueBlocked,
+  computeCheckboxContinueBlocked,
+  listBlockingCheckboxes
+} from "./screenCheckboxAck";
+export {
+  ScreenCheckboxAckProvider,
+  ScreenInputDraftProvider,
+  computeCheckboxContinueBlocked,
+  listBlockingCheckboxes,
+  useCheckboxContinueBlocked,
+  useScreenCheckboxAck,
+  useScreenInputDraft,
+  useScreenInputValidity
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export {\n  ScreenInputDraftProvider,\n  useScreenInputDraft,\n  useScreenInputValidity,\n} from './screenInputDraft';\nexport type { InputDraft, InputValidity } from './screenInputDraft';\nexport {\n  ScreenCheckboxAckProvider,\n  useScreenCheckboxAck,\n  useCheckboxContinueBlocked,\n  computeCheckboxContinueBlocked,\n  listBlockingCheckboxes,\n} from './screenCheckboxAck';\n"],"mappings":"AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/publish-exports.json

@@ -0,0 +1,14 @@
+[
+  {
+    "exportKey": ".",
+    "distFile": "./dist/index.js"
+  },
+  {
+    "exportKey": "./draft",
+    "distFile": "./dist/screenInputDraft.js"
+  },
+  {
+    "exportKey": "./checkbox",
+    "distFile": "./dist/screenCheckboxAck.js"
+  }
+]

package/dist/screenCheckboxAck.d.ts

@@ -0,0 +1,23 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { Screen } from '@getrheo/contracts/screens';
+import { CheckboxLayer } from '@getrheo/contracts/layers';
+
+/** True when any `blocking` checkbox on the screen is unchecked. */
+declare const computeCheckboxContinueBlocked: (screen: Screen, checked: Record<string, boolean>) => boolean;
+type ScreenCheckboxAckCtxValue = {
+    checked: Record<string, boolean>;
+    toggle: (fieldKey: string) => void;
+    /** Snapshot all checkbox values on this screen for `screen_commit`. */
+    snapshotValues: () => Record<string, boolean>;
+    blockingContinue: boolean;
+};
+declare const ScreenCheckboxAckProvider: ({ screen, children, }: {
+    screen: Screen;
+    children: ReactNode;
+}) => react_jsx_runtime.JSX.Element;
+declare const useScreenCheckboxAck: () => ScreenCheckboxAckCtxValue | null;
+declare const useCheckboxContinueBlocked: () => boolean;
+declare const listBlockingCheckboxes: (screen: Screen) => CheckboxLayer[];
+
+export { ScreenCheckboxAckProvider, computeCheckboxContinueBlocked, listBlockingCheckboxes, useCheckboxContinueBlocked, useScreenCheckboxAck };

package/dist/screenCheckboxAck.js

@@ -0,0 +1,80 @@
+import { jsx } from "react/jsx-runtime";
+import {
+  createContext,
+  useCallback,
+  useContext,
+  useEffect,
+  useMemo,
+  useState
+} from "react";
+import { walkScreen } from "@getrheo/flow-runtime/layers";
+const collectCheckboxFieldKeys = (screen) => {
+  const out = [];
+  walkScreen(screen, (l) => {
+    if (l.kind === "checkbox") out.push(l.fieldKey);
+  });
+  return out;
+};
+const computeCheckboxContinueBlocked = (screen, checked) => {
+  let blocked = false;
+  walkScreen(screen, (l) => {
+    if (l.kind !== "checkbox" || !l.blocking) return;
+    if (!checked[l.fieldKey]) blocked = true;
+  });
+  return blocked;
+};
+const ScreenCheckboxAckCtx = createContext(null);
+const ScreenCheckboxAckProvider = ({
+  screen,
+  children
+}) => {
+  const keys = useMemo(() => collectCheckboxFieldKeys(screen), [screen]);
+  const keysSig = keys.join("\0");
+  const [checked, setChecked] = useState(
+    () => Object.fromEntries(keys.map((k) => [k, false]))
+  );
+  useEffect(() => {
+    setChecked(Object.fromEntries(keys.map((k) => [k, false])));
+  }, [screen.id, keysSig]);
+  const blockingContinue = useMemo(
+    () => computeCheckboxContinueBlocked(screen, checked),
+    [screen, checked]
+  );
+  const toggle = useCallback((fieldKey) => {
+    setChecked((prev) => ({ ...prev, [fieldKey]: !(prev[fieldKey] ?? false) }));
+  }, []);
+  const snapshotValues = useCallback(() => {
+    const out = {};
+    walkScreen(screen, (l) => {
+      if (l.kind === "checkbox") {
+        out[l.fieldKey] = !!checked[l.fieldKey];
+      }
+    });
+    return out;
+  }, [screen, checked]);
+  const value = useMemo(
+    () => ({ checked, toggle, snapshotValues, blockingContinue }),
+    [checked, toggle, snapshotValues, blockingContinue]
+  );
+  return /* @__PURE__ */ jsx(ScreenCheckboxAckCtx.Provider, { value, children });
+};
+const useScreenCheckboxAck = () => useContext(ScreenCheckboxAckCtx);
+const useCheckboxContinueBlocked = () => {
+  const ctx = useContext(ScreenCheckboxAckCtx);
+  return ctx?.blockingContinue ?? false;
+};
+const listBlockingCheckboxes = (screen) => {
+  const out = [];
+  walkScreen(screen, (l) => {
+    if (l.kind === "checkbox" && l.blocking) out.push(l);
+  });
+  return out;
+};
+export {
+  ScreenCheckboxAckProvider,
+  computeCheckboxContinueBlocked,
+  listBlockingCheckboxes,
+  useCheckboxContinueBlocked,
+  useScreenCheckboxAck
+};
+//# sourceMappingURL=screenCheckboxAck.js.map

package/dist/screenCheckboxAck.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/screenCheckboxAck.tsx"],"sourcesContent":["import {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n  type ReactNode,\n} from 'react';\nimport type { Screen } from '@getrheo/contracts/screens';\nimport { walkScreen } from '@getrheo/flow-runtime/layers';\nimport type { CheckboxLayer } from '@getrheo/contracts/layers';\n\nconst collectCheckboxFieldKeys = (screen: Screen): string[] => {\n  const out: string[] = [];\n  walkScreen(screen, (l) => {\n    if (l.kind === 'checkbox') out.push(l.fieldKey);\n  });\n  return out;\n};\n\n/** True when any `blocking` checkbox on the screen is unchecked. */\nexport const computeCheckboxContinueBlocked = (\n  screen: Screen,\n  checked: Record<string, boolean>,\n): boolean => {\n  let blocked = false;\n  walkScreen(screen, (l) => {\n    if (l.kind !== 'checkbox' || !l.blocking) return;\n    if (!checked[l.fieldKey]) blocked = true;\n  });\n  return blocked;\n};\n\ntype ScreenCheckboxAckCtxValue = {\n  checked: Record<string, boolean>;\n  toggle: (fieldKey: string) => void;\n  /** Snapshot all checkbox values on this screen for `screen_commit`. */\n  snapshotValues: () => Record<string, boolean>;\n  blockingContinue: boolean;\n};\n\nconst ScreenCheckboxAckCtx = createContext<ScreenCheckboxAckCtxValue | null>(null);\n\nexport const ScreenCheckboxAckProvider = ({\n  screen,\n  children,\n}: {\n  screen: Screen;\n  children: ReactNode;\n}) => {\n  const keys = useMemo(() => collectCheckboxFieldKeys(screen), [screen]);\n  const keysSig = keys.join('\\0');\n\n  const [checked, setChecked] = useState<Record<string, boolean>>(() =>\n    Object.fromEntries(keys.map((k) => [k, false])),\n  );\n\n  useEffect(() => {\n    setChecked(Object.fromEntries(keys.map((k) => [k, false])));\n  }, [screen.id, keysSig]);\n\n  const blockingContinue = useMemo(\n    () => computeCheckboxContinueBlocked(screen, checked),\n    [screen, checked],\n  );\n\n  const toggle = useCallback((fieldKey: string) => {\n    setChecked((prev) => ({ ...prev, [fieldKey]: !(prev[fieldKey] ?? false) }));\n  }, []);\n\n  const snapshotValues = useCallback((): Record<string, boolean> => {\n    const out: Record<string, boolean> = {};\n    walkScreen(screen, (l) => {\n      if (l.kind === 'checkbox') {\n        out[l.fieldKey] = !!checked[l.fieldKey];\n      }\n    });\n    return out;\n  }, [screen, checked]);\n\n  const value = useMemo<ScreenCheckboxAckCtxValue>(\n    () => ({ checked, toggle, snapshotValues, blockingContinue }),\n    [checked, toggle, snapshotValues, blockingContinue],\n  );\n\n  return <ScreenCheckboxAckCtx.Provider value={value}>{children}</ScreenCheckboxAckCtx.Provider>;\n};\n\nexport const useScreenCheckboxAck = (): ScreenCheckboxAckCtxValue | null =>\n  useContext(ScreenCheckboxAckCtx);\n\nexport const useCheckboxContinueBlocked = (): boolean => {\n  const ctx = useContext(ScreenCheckboxAckCtx);\n  return ctx?.blockingContinue ?? false;\n};\n\nexport const listBlockingCheckboxes = (screen: Screen): CheckboxLayer[] => {\n  const out: CheckboxLayer[] = [];\n  walkScreen(screen, (l) => {\n    if (l.kind === 'checkbox' && l.blocking) out.push(l);\n  });\n  return out;\n};\n"],"mappings":"AAsFS;AAtFT;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAEP,SAAS,kBAAkB;AAG3B,MAAM,2BAA2B,CAAC,WAA6B;AAC7D,QAAM,MAAgB,CAAC;AACvB,aAAW,QAAQ,CAAC,MAAM;AACxB,QAAI,EAAE,SAAS,WAAY,KAAI,KAAK,EAAE,QAAQ;AAAA,EAChD,CAAC;AACD,SAAO;AACT;AAGO,MAAM,iCAAiC,CAC5C,QACA,YACY;AACZ,MAAI,UAAU;AACd,aAAW,QAAQ,CAAC,MAAM;AACxB,QAAI,EAAE,SAAS,cAAc,CAAC,EAAE,SAAU;AAC1C,QAAI,CAAC,QAAQ,EAAE,QAAQ,EAAG,WAAU;AAAA,EACtC,CAAC;AACD,SAAO;AACT;AAUA,MAAM,uBAAuB,cAAgD,IAAI;AAE1E,MAAM,4BAA4B,CAAC;AAAA,EACxC;AAAA,EACA;AACF,MAGM;AACJ,QAAM,OAAO,QAAQ,MAAM,yBAAyB,MAAM,GAAG,CAAC,MAAM,CAAC;AACrE,QAAM,UAAU,KAAK,KAAK,IAAI;AAE9B,QAAM,CAAC,SAAS,UAAU,IAAI;AAAA,IAAkC,MAC9D,OAAO,YAAY,KAAK,IAAI,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC;AAAA,EAChD;AAEA,YAAU,MAAM;AACd,eAAW,OAAO,YAAY,KAAK,IAAI,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;AAAA,EAC5D,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;AAEvB,QAAM,mBAAmB;AAAA,IACvB,MAAM,+BAA+B,QAAQ,OAAO;AAAA,IACpD,CAAC,QAAQ,OAAO;AAAA,EAClB;AAEA,QAAM,SAAS,YAAY,CAAC,aAAqB;AAC/C,eAAW,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,QAAQ,GAAG,EAAE,KAAK,QAAQ,KAAK,OAAO,EAAE;AAAA,EAC5E,GAAG,CAAC,CAAC;AAEL,QAAM,iBAAiB,YAAY,MAA+B;AAChE,UAAM,MAA+B,CAAC;AACtC,eAAW,QAAQ,CAAC,MAAM;AACxB,UAAI,EAAE,SAAS,YAAY;AACzB,YAAI,EAAE,QAAQ,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ;AAAA,MACxC;AAAA,IACF,CAAC;AACD,WAAO;AAAA,EACT,GAAG,CAAC,QAAQ,OAAO,CAAC;AAEpB,QAAM,QAAQ;AAAA,IACZ,OAAO,EAAE,SAAS,QAAQ,gBAAgB,iBAAiB;AAAA,IAC3D,CAAC,SAAS,QAAQ,gBAAgB,gBAAgB;AAAA,EACpD;AAEA,SAAO,oBAAC,qBAAqB,UAArB,EAA8B,OAAe,UAAS;AAChE;AAEO,MAAM,uBAAuB,MAClC,WAAW,oBAAoB;AAE1B,MAAM,6BAA6B,MAAe;AACvD,QAAM,MAAM,WAAW,oBAAoB;AAC3C,SAAO,KAAK,oBAAoB;AAClC;AAEO,MAAM,yBAAyB,CAAC,WAAoC;AACzE,QAAM,MAAuB,CAAC;AAC9B,aAAW,QAAQ,CAAC,MAAM;AACxB,QAAI,EAAE,SAAS,cAAc,EAAE,SAAU,KAAI,KAAK,CAAC;AAAA,EACrD,CAAC;AACD,SAAO;AACT;","names":[]}

package/dist/screenInputDraft.d.ts

@@ -0,0 +1,74 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { Screen } from '@getrheo/contracts/screens';
+import { StepResponseCore } from '@getrheo/flow-runtime/stateMachine';
+
+/**
+ * In-progress draft value for the screen's lone input layer. Mirrors the
+ * `StepResponse` variants the input layers used to emit themselves but
+ * without the `text`'s `classification` (added at submit time from the
+ * input layer's own `classification`).
+ */
+type InputDraft = {
+    kind: 'choice';
+    choiceId: string;
+} | {
+    kind: 'multiChoice';
+    choiceIds: string[];
+} | {
+    kind: 'text';
+    value: string;
+} | {
+    kind: 'scale';
+    value: number;
+};
+type InputValidity = {
+    valid: boolean;
+    reason?: string;
+};
+type ScreenInputDraftCtxValue = {
+    draft: InputDraft | null;
+    setDraft: (next: InputDraft | null) => void;
+    validity: InputValidity;
+    /**
+     * Materialise the current draft into a `StepResponseCore` ready to be
+     * fed into the host flow's state machine (or wrapped in `screen_commit`).
+     * Returns `null` when the draft is empty or the screen has no input.
+     */
+    toResponse: () => StepResponseCore | null;
+};
+/**
+ * Compute validity for a draft against the screen's input layer
+ * constraints. Centralised here so web sim and RN SDK stay in lockstep.
+ *
+ * Exported for unit tests; production code should consume validity via
+ * `useScreenInputValidity()`.
+ */
+declare const computeValidity: (screen: Screen, draft: InputDraft | null) => InputValidity;
+/**
+ * Convert a draft to a fully-populated `StepResponseCore` using the screen's
+ * input layer for context (e.g. text classification).
+ *
+ * Exported for unit tests; production code should call `toResponse()`
+ * from the context value.
+ */
+declare const draftToResponse: (screen: Screen, draft: InputDraft | null) => StepResponseCore | null;
+declare const ScreenInputDraftProvider: ({ screen, children, }: {
+    screen: Screen;
+    children: ReactNode;
+}) => react_jsx_runtime.JSX.Element;
+/**
+ * Read the screen-level input draft. Returns `null` when called outside
+ * a `ScreenInputDraftProvider` so consumers can degrade gracefully
+ * (e.g. when an input view is rendered standalone in a builder preview).
+ */
+declare const useScreenInputDraft: () => ScreenInputDraftCtxValue | null;
+/**
+ * Convenience hook for callers that only care whether the current
+ * screen's input is in a submittable state. Treats absence of a
+ * provider as "valid" so non-input screens (or standalone previews)
+ * never block submission.
+ */
+declare const useScreenInputValidity: () => InputValidity;
+
+export { type InputDraft, type InputValidity, ScreenInputDraftProvider, computeValidity, draftToResponse, useScreenInputDraft, useScreenInputValidity };

package/dist/screenInputDraft.js

@@ -0,0 +1,106 @@
+import { jsx } from "react/jsx-runtime";
+import {
+  createContext,
+  useCallback,
+  useContext,
+  useEffect,
+  useMemo,
+  useState
+} from "react";
+import { findInputLayer } from "@getrheo/flow-runtime/layers";
+import { snapScaleValue, scaleValueInRange, scaleValueIsOnStep } from "@getrheo/flow-runtime/scaleValidation";
+import { validateTextInputValue } from "@getrheo/flow-runtime/textInputValidation";
+const ScreenInputDraftCtx = createContext(null);
+const computeValidity = (screen, draft) => {
+  const input = findInputLayer(screen);
+  if (!input) return { valid: true };
+  if (!draft) return { valid: false, reason: "No input provided yet" };
+  switch (input.kind) {
+    case "text_input": {
+      if (draft.kind !== "text") return { valid: false, reason: "Wrong draft kind" };
+      const v = validateTextInputValue(input, draft.value);
+      return v.ok ? { valid: true } : { valid: false, reason: v.reason };
+    }
+    case "scale_input": {
+      if (draft.kind !== "scale") return { valid: false, reason: "Wrong draft kind" };
+      if (!scaleValueInRange(input, draft.value)) {
+        return { valid: false, reason: "Value out of range" };
+      }
+      if (!scaleValueIsOnStep(input, draft.value)) {
+        return { valid: false, reason: "Value does not align with step" };
+      }
+      return { valid: true };
+    }
+    case "multiple_choice": {
+      if (draft.kind !== "multiChoice") return { valid: false, reason: "Wrong draft kind" };
+      const min = input.minSelections ?? 1;
+      if (draft.choiceIds.length < min) {
+        return { valid: false, reason: `Select at least ${min}` };
+      }
+      const max = input.maxSelections;
+      if (max !== void 0 && draft.choiceIds.length > max) {
+        return { valid: false, reason: `Select at most ${max}` };
+      }
+      return { valid: true };
+    }
+    case "single_choice": {
+      if (draft.kind !== "choice") return { valid: false, reason: "Wrong draft kind" };
+      return { valid: true };
+    }
+  }
+};
+const draftToResponse = (screen, draft) => {
+  if (!draft) return null;
+  const input = findInputLayer(screen);
+  if (!input) return null;
+  if (draft.kind === "choice") return { kind: "choice", choiceId: draft.choiceId };
+  if (draft.kind === "multiChoice") return { kind: "multiChoice", choiceIds: draft.choiceIds };
+  if (draft.kind === "text") {
+    if (input.kind !== "text_input") return null;
+    return { kind: "text", value: draft.value, classification: input.classification };
+  }
+  if (draft.kind === "scale") {
+    if (input.kind !== "scale_input") return null;
+    return { kind: "scale", value: draft.value };
+  }
+  return null;
+};
+const initialDraftForScreen = (screen) => {
+  const input = findInputLayer(screen);
+  if (input?.kind === "scale_input") {
+    return {
+      kind: "scale",
+      value: snapScaleValue(input, input.defaultValue ?? input.min)
+    };
+  }
+  return null;
+};
+const ScreenInputDraftProvider = ({
+  screen,
+  children
+}) => {
+  const [draft, setDraft] = useState(() => initialDraftForScreen(screen));
+  useEffect(() => {
+    setDraft(initialDraftForScreen(screen));
+  }, [screen.id]);
+  const validity = useMemo(() => computeValidity(screen, draft), [screen, draft]);
+  const toResponse = useCallback(() => draftToResponse(screen, draft), [screen, draft]);
+  const value = useMemo(
+    () => ({ draft, setDraft, validity, toResponse }),
+    [draft, validity, toResponse]
+  );
+  return /* @__PURE__ */ jsx(ScreenInputDraftCtx.Provider, { value, children });
+};
+const useScreenInputDraft = () => useContext(ScreenInputDraftCtx);
+const useScreenInputValidity = () => {
+  const ctx = useContext(ScreenInputDraftCtx);
+  return ctx?.validity ?? { valid: true };
+};
+export {
+  ScreenInputDraftProvider,
+  computeValidity,
+  draftToResponse,
+  useScreenInputDraft,
+  useScreenInputValidity
+};
+//# sourceMappingURL=screenInputDraft.js.map

package/dist/screenInputDraft.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/screenInputDraft.tsx"],"sourcesContent":["import {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n} from 'react';\nimport type { ReactNode } from 'react';\nimport type { Screen } from '@getrheo/contracts/screens';\nimport { findInputLayer } from '@getrheo/flow-runtime/layers';\nimport { snapScaleValue, scaleValueInRange, scaleValueIsOnStep } from '@getrheo/flow-runtime/scaleValidation';\nimport { validateTextInputValue } from '@getrheo/flow-runtime/textInputValidation';\nimport type { StepResponseCore } from '@getrheo/flow-runtime/stateMachine';\n\n/**\n * In-progress draft value for the screen's lone input layer. Mirrors the\n * `StepResponse` variants the input layers used to emit themselves but\n * without the `text`'s `classification` (added at submit time from the\n * input layer's own `classification`).\n */\nexport type InputDraft =\n  | { kind: 'choice'; choiceId: string }\n  | { kind: 'multiChoice'; choiceIds: string[] }\n  | { kind: 'text'; value: string }\n  | { kind: 'scale'; value: number };\n\nexport type InputValidity = { valid: boolean; reason?: string };\n\ntype ScreenInputDraftCtxValue = {\n  draft: InputDraft | null;\n  setDraft: (next: InputDraft | null) => void;\n  validity: InputValidity;\n  /**\n   * Materialise the current draft into a `StepResponseCore` ready to be\n   * fed into the host flow's state machine (or wrapped in `screen_commit`).\n   * Returns `null` when the draft is empty or the screen has no input.\n   */\n  toResponse: () => StepResponseCore | null;\n};\n\nconst ScreenInputDraftCtx = createContext<ScreenInputDraftCtxValue | null>(null);\n\n/**\n * Compute validity for a draft against the screen's input layer\n * constraints. Centralised here so web sim and RN SDK stay in lockstep.\n *\n * Exported for unit tests; production code should consume validity via\n * `useScreenInputValidity()`.\n */\nexport const computeValidity = (screen: Screen, draft: InputDraft | null): InputValidity => {\n  const input = findInputLayer(screen);\n  if (!input) return { valid: true };\n  if (!draft) return { valid: false, reason: 'No input provided yet' };\n\n  switch (input.kind) {\n    case 'text_input': {\n      if (draft.kind !== 'text') return { valid: false, reason: 'Wrong draft kind' };\n      const v = validateTextInputValue(input, draft.value);\n      return v.ok ? { valid: true } : { valid: false, reason: v.reason };\n    }\n    case 'scale_input': {\n      if (draft.kind !== 'scale') return { valid: false, reason: 'Wrong draft kind' };\n      if (!scaleValueInRange(input, draft.value)) {\n        return { valid: false, reason: 'Value out of range' };\n      }\n      if (!scaleValueIsOnStep(input, draft.value)) {\n        return { valid: false, reason: 'Value does not align with step' };\n      }\n      return { valid: true };\n    }\n    case 'multiple_choice': {\n      if (draft.kind !== 'multiChoice') return { valid: false, reason: 'Wrong draft kind' };\n      const min = input.minSelections ?? 1;\n      if (draft.choiceIds.length < min) {\n        return { valid: false, reason: `Select at least ${min}` };\n      }\n      const max = input.maxSelections;\n      if (max !== undefined && draft.choiceIds.length > max) {\n        return { valid: false, reason: `Select at most ${max}` };\n      }\n      return { valid: true };\n    }\n    case 'single_choice': {\n      if (draft.kind !== 'choice') return { valid: false, reason: 'Wrong draft kind' };\n      return { valid: true };\n    }\n  }\n};\n\n/**\n * Convert a draft to a fully-populated `StepResponseCore` using the screen's\n * input layer for context (e.g. text classification).\n *\n * Exported for unit tests; production code should call `toResponse()`\n * from the context value.\n */\nexport const draftToResponse = (\n  screen: Screen,\n  draft: InputDraft | null,\n): StepResponseCore | null => {\n  if (!draft) return null;\n  const input = findInputLayer(screen);\n  if (!input) return null;\n\n  if (draft.kind === 'choice') return { kind: 'choice', choiceId: draft.choiceId };\n  if (draft.kind === 'multiChoice') return { kind: 'multiChoice', choiceIds: draft.choiceIds };\n  if (draft.kind === 'text') {\n    if (input.kind !== 'text_input') return null;\n    return { kind: 'text', value: draft.value, classification: input.classification };\n  }\n  if (draft.kind === 'scale') {\n    if (input.kind !== 'scale_input') return null;\n    return { kind: 'scale', value: draft.value };\n  }\n  return null;\n};\n\nconst initialDraftForScreen = (screen: Screen): InputDraft | null => {\n  const input = findInputLayer(screen);\n  if (input?.kind === 'scale_input') {\n    return {\n      kind: 'scale',\n      value: snapScaleValue(input, input.defaultValue ?? input.min),\n    };\n  }\n  return null;\n};\n\nexport const ScreenInputDraftProvider = ({\n  screen,\n  children,\n}: {\n  screen: Screen;\n  children: ReactNode;\n}) => {\n  const [draft, setDraft] = useState<InputDraft | null>(() => initialDraftForScreen(screen));\n\n  useEffect(() => {\n    setDraft(initialDraftForScreen(screen));\n  }, [screen.id]);\n\n  const validity = useMemo(() => computeValidity(screen, draft), [screen, draft]);\n  const toResponse = useCallback(() => draftToResponse(screen, draft), [screen, draft]);\n\n  const value = useMemo<ScreenInputDraftCtxValue>(\n    () => ({ draft, setDraft, validity, toResponse }),\n    [draft, validity, toResponse],\n  );\n\n  return <ScreenInputDraftCtx.Provider value={value}>{children}</ScreenInputDraftCtx.Provider>;\n};\n\n/**\n * Read the screen-level input draft. Returns `null` when called outside\n * a `ScreenInputDraftProvider` so consumers can degrade gracefully\n * (e.g. when an input view is rendered standalone in a builder preview).\n */\nexport const useScreenInputDraft = (): ScreenInputDraftCtxValue | null =>\n  useContext(ScreenInputDraftCtx);\n\n/**\n * Convenience hook for callers that only care whether the current\n * screen's input is in a submittable state. Treats absence of a\n * provider as \"valid\" so non-input screens (or standalone previews)\n * never block submission.\n */\nexport const useScreenInputValidity = (): InputValidity => {\n  const ctx = useContext(ScreenInputDraftCtx);\n  return ctx?.validity ?? { valid: true };\n};\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@getrheo/flow-ui-state",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./draft": {
+      "types": "./dist/screenInputDraft.d.ts",
+      "import": "./dist/screenInputDraft.js",
+      "default": "./dist/screenInputDraft.js"
+    },
+    "./checkbox": {
+      "types": "./dist/screenCheckboxAck.d.ts",
+      "import": "./dist/screenCheckboxAck.js",
+      "default": "./dist/screenCheckboxAck.js"
+    }
+  },
+  "dependencies": {
+    "@getrheo/contracts": "1.0.0",
+    "@getrheo/flow-runtime": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.1",
+    "@types/react": "^19.0.1",
+    "@types/react-dom": "^19.0.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.6",
+    "@rheo/config": "0.1.0"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/madeinusmate/onboardly.git",
+    "directory": "packages/flow-ui-state"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "build": "node ../../scripts/build-publishable-package.mjs"
+  }
+}