@daltonr/pathwrite-react 0.8.0 → 0.10.0

package/dist/index.css

@@ -285,6 +285,16 @@
   content: ":";
 }
 
+/* ------------------------------------------------------------------ */
+/* Blocking error (guard-level message, not field-attached)           */
+/* ------------------------------------------------------------------ */
+.pw-shell__blocking-error {
+  margin: 0;
+  padding: 8px 16px;
+  font-size: 13px;
+  color: var(--pw-color-error);
+}
+
 /* ------------------------------------------------------------------ */
 /* Warning messages                                                    */
 /* ------------------------------------------------------------------ */
@@ -361,6 +371,7 @@
   background: var(--pw-color-primary);
   border-color: var(--pw-color-primary);
   color: #fff;
+  position: relative;
 }
 
 .pw-shell__btn--next:hover:not(:disabled) {
@@ -368,6 +379,29 @@
   border-color: #1d4ed8;
 }
 
+@keyframes pw-spin {
+  to { transform: rotate(360deg); }
+}
+
+.pw-shell__btn--next.pw-shell__btn--loading {
+  color: transparent;
+  pointer-events: none;
+}
+
+.pw-shell__btn--next.pw-shell__btn--loading::after {
+  content: "";
+  position: absolute;
+  top: 50%;
+  left: 50%;
+  width: 14px;
+  height: 14px;
+  margin: -7px 0 0 -7px;
+  border: 2px solid rgba(255, 255, 255, 0.35);
+  border-top-color: #fff;
+  border-radius: 50%;
+  animation: pw-spin 0.6s linear infinite;
+}
+
 .pw-shell__btn--back {
   background: transparent;
   border-color: var(--pw-color-primary);
@@ -388,3 +422,55 @@
   background: var(--pw-color-primary-light);
 }
 
+/* ------------------------------------------------------------------ */
+/* Error panel — replaces footer when status === "error"              */
+/* ------------------------------------------------------------------ */
+.pw-shell__error {
+  background: var(--pw-color-error-bg);
+  border: 1px solid var(--pw-color-error-border);
+  border-radius: var(--pw-shell-radius);
+  padding: 16px 20px;
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+}
+
+.pw-shell__error-title {
+  font-size: 14px;
+  font-weight: 600;
+  color: var(--pw-color-error);
+}
+
+.pw-shell__error-message {
+  font-size: 13px;
+  color: var(--pw-color-muted);
+}
+
+.pw-shell__error-actions {
+  display: flex;
+  gap: 8px;
+  align-items: center;
+  margin-top: 2px;
+}
+
+.pw-shell__btn--retry {
+  background: var(--pw-color-error);
+  border-color: var(--pw-color-error);
+  color: #fff;
+}
+
+.pw-shell__btn--retry:hover:not(:disabled) {
+  opacity: 0.9;
+}
+
+.pw-shell__btn--suspend {
+  color: var(--pw-color-muted);
+  border-color: transparent;
+  background: transparent;
+  font-size: 13px;
+}
+
+.pw-shell__btn--suspend:hover:not(:disabled) {
+  background: var(--pw-color-primary-light);
+}
+

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import type { PropsWithChildren, ReactElement, ReactNode } from "react";
+import type { ChangeEvent, PropsWithChildren, ReactElement, ReactNode } from "react";
 import { PathData, PathDefinition, PathEngine, PathEvent, PathSnapshot, ProgressLayout } from "@daltonr/pathwrite-core";
 export interface UsePathOptions {
     /**
      * An externally-managed `PathEngine` to subscribe to — for example, the engine
-     * returned by `createPersistedEngine()` from `@daltonr/pathwrite-store-http`.
+     * returned by `createPersistedEngine()` from `@daltonr/pathwrite-store`.
      *
      * When provided:
      * - `usePath` will **not** create its own engine.
@@ -37,30 +37,86 @@ export interface UsePathReturn<TData extends PathData = PathData> {
     /** Reset the current step's data to what it was when the step was entered. Useful for "Clear" or "Reset" buttons. */
     resetStep: () => void;
     /**
-     * Tear down any active path (without firing hooks) and immediately start the
-     * given path fresh. Safe to call whether or not a path is currently active.
+     * Tear down any active path (without firing hooks) and immediately restart
+     * the same path with the same initial data. Safe to call at any time.
      * Use for "Start over" / retry flows without remounting the component.
      */
-    restart: (path: PathDefinition<any>, initialData?: PathData) => void;
+    restart: () => void;
+    /**
+     * Re-runs the operation that set `snapshot.error`. Increments `snapshot.error.retryCount`
+     * on repeated failure so shells can escalate from "Try again" to "Come back later".
+     * No-op when there is no pending error.
+     */
+    retry: () => void;
+    /**
+     * Pauses the path with intent to return. Emits a `suspended` event that the application
+     * listens for to dismiss the wizard UI. All state and data are preserved.
+     */
+    suspend: () => void;
 }
 export type PathProviderProps = PropsWithChildren<{
     /** Forwarded to the internal usePath hook. */
     onEvent?: (event: PathEvent) => void;
+    /**
+     * Services object passed through context to all step components.
+     * Step components access it via `usePathContext<TData, TServices>()`.
+     * Typed as `unknown` here so `PathProvider` stays non-generic — provide a
+     * typed services interface via the `TServices` type parameter on `usePathContext`.
+     */
+    services?: unknown;
 }>;
 export declare function usePath<TData extends PathData = PathData>(options?: UsePathOptions): UsePathReturn<TData>;
 /**
  * Provides a single `usePath` instance to all descendants.
  * Consume with `usePathContext()`.
  */
-export declare function PathProvider({ children, onEvent }: PathProviderProps): ReactElement;
+export declare function PathProvider({ children, onEvent, services }: PathProviderProps): ReactElement;
 /**
- * Access the nearest `PathProvider`'s path instance.
- * Throws if used outside of a `<PathProvider>`.
+ * Access the nearest `PathProvider`'s path instance and optional services object.
+ * Throws if used outside of a `<PathProvider>` or `<PathShell>`.
  *
- * The optional generic narrows `snapshot.data` for convenience — it is a
- * **type-level assertion**, not a runtime guarantee.
+ * Both generics are type-level assertions, not runtime guarantees:
+ * - `TData` narrows `snapshot.data`
+ * - `TServices` types the `services` value — must match what was passed to `PathShell` or `PathProvider`
+ *
+ * @example
+ * ```tsx
+ * function OfficeStep() {
+ *   const { snapshot, services } = usePathContext<HiringData, HiringServices>();
+ *   // services is typed as HiringServices
+ * }
+ * ```
  */
-export declare function usePathContext<TData extends PathData = PathData>(): UsePathReturn<TData>;
+export declare function usePathContext<TData extends PathData = PathData, TServices = unknown>(): Omit<UsePathReturn<TData>, "snapshot"> & {
+    snapshot: PathSnapshot<TData>;
+    services: TServices;
+};
+/**
+ * Binding helper for a single `<input>`, `<select>`, or `<textarea>` field.
+ *
+ * Returns `{ value, onChange }` tied to `snapshot.data[field]`, so you can
+ * spread it directly onto an element and eliminate the repetitive
+ * `onChange={e => setData("field", e.target.value)}` pattern:
+ *
+ * ```tsx
+ * function NameStep() {
+ *   const name = useField<MyData, "name">("name");
+ *   return <input type="text" {...name} />;
+ * }
+ * ```
+ *
+ * - `value` is always a `string` (falls back to `""` when the data key is unset).
+ * - `onChange` calls `setData(field, e.target.value)`.
+ *
+ * For inputs that need a value transform (e.g. `.trim()`, `Number()`) keep
+ * an explicit `onChange` handler — this helper is for the no-transform case.
+ *
+ * Must be called inside a `<PathShell>` or `<PathProvider>`.
+ */
+export declare function useField<TData extends PathData, K extends string & keyof TData>(field: K): {
+    value: string;
+    onChange: (e: ChangeEvent<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement>) => void;
+};
 export interface PathShellProps {
     /** The path definition to drive. */
     path: PathDefinition<any>;
@@ -88,6 +144,8 @@ export interface PathShellProps {
     nextLabel?: string;
     /** Label for the Complete button (shown on the last step). Defaults to `"Complete"`. */
     completeLabel?: string;
+    /** Label shown on the Next/Complete button while an async operation is in progress. Defaults to `undefined` (button shows a CSS spinner but keeps its label). */
+    loadingLabel?: string;
     /** Label for the Cancel button. Defaults to `"Cancel"`. */
     cancelLabel?: string;
     /** If true, hide the Cancel button. Defaults to `false`. */
@@ -122,6 +180,26 @@ export interface PathShellProps {
      * - `"activeOnly"`: Only the active (sub-path) bar — root bar hidden.
      */
     progressLayout?: ProgressLayout;
+    /**
+     * Services object passed through context to all step components.
+     * Step components access it via `usePathContext<TData, TServices>()`.
+     *
+     * The same services object that was passed to your path factory function
+     * should be passed here so step components can call service methods directly
+     * (e.g. parameterised queries that depend on mid-step user input).
+     *
+     * @example
+     * ```tsx
+     * const svc = new LiveHiringServices();
+     * const path = createHiringPath(svc);
+     * <PathShell path={path} services={svc} steps={{ ... }} />
+     * ```
+     */
+    services?: unknown;
+}
+export interface PathShellHandle {
+    /** Restart the shell's current path with its original `initialData`, without unmounting. */
+    restart: () => void;
 }
 export interface PathShellActions {
     next: () => void;
@@ -132,6 +210,10 @@ export interface PathShellActions {
     setData: (key: string, value: unknown) => void;
     /** Restart the shell's current path with its current `initialData`. */
     restart: () => void;
+    /** Re-run the operation that set `snapshot.error`. See `PathEngine.retry()`. */
+    retry: () => void;
+    /** Pause with intent to return, preserving all state. Emits `suspended`. */
+    suspend: () => void;
 }
 /**
  * Default UI shell that renders a progress indicator, step content, and navigation
@@ -149,6 +231,6 @@ export interface PathShellActions {
  * />
  * ```
  */
-export declare function PathShell({ path: pathDef, engine: externalEngine, steps, initialData, autoStart, onComplete, onCancel, onEvent, backLabel, nextLabel, completeLabel, cancelLabel, hideCancel, hideProgress, footerLayout, className, renderHeader, renderFooter, validationDisplay, progressLayout, }: PathShellProps): ReactElement;
+export declare const PathShell: import("react").ForwardRefExoticComponent<PathShellProps & import("react").RefAttributes<PathShellHandle>>;
 export type { PathData, FieldErrors, PathDefinition, PathEvent, PathSnapshot, PathStep, PathStepContext, ProgressLayout, RootProgress, SerializedPathState, StepChoice, } from "@daltonr/pathwrite-core";
 export { PathEngine } from "@daltonr/pathwrite-core";

package/dist/index.js

@@ -1,5 +1,5 @@
-import { createContext, createElement, useCallback, useContext, useEffect, useRef, useSyncExternalStore } from "react";
-import { PathEngine } from "@daltonr/pathwrite-core";
+import { createContext, createElement, forwardRef, useCallback, useContext, useEffect, useImperativeHandle, useRef, useSyncExternalStore } from "react";
+import { PathEngine, formatFieldKey, errorPhaseMessage, } from "@daltonr/pathwrite-core";
 // ---------------------------------------------------------------------------
 // usePath hook
 // ---------------------------------------------------------------------------
@@ -51,42 +51,80 @@ export function usePath(options) {
     const goToStepChecked = useCallback((stepId) => engine.goToStepChecked(stepId), [engine]);
     const setData = useCallback((key, value) => engine.setData(key, value), [engine]);
     const resetStep = useCallback(() => engine.resetStep(), [engine]);
-    const restart = useCallback((path, initialData = {}) => engine.restart(path, initialData), [engine]);
-    return { snapshot, start, startSubPath, next, previous, cancel, goToStep, goToStepChecked, setData, resetStep, restart };
+    const restart = useCallback(() => engine.restart(), [engine]);
+    const retry = useCallback(() => engine.retry(), [engine]);
+    const suspend = useCallback(() => engine.suspend(), [engine]);
+    return { snapshot, start, startSubPath, next, previous, cancel, goToStep, goToStepChecked, setData, resetStep, restart, retry, suspend };
 }
-// ---------------------------------------------------------------------------
-// Context + Provider
-// ---------------------------------------------------------------------------
 const PathContext = createContext(null);
 /**
  * Provides a single `usePath` instance to all descendants.
  * Consume with `usePathContext()`.
  */
-export function PathProvider({ children, onEvent }) {
+export function PathProvider({ children, onEvent, services }) {
     const path = usePath({ onEvent });
-    return createElement(PathContext.Provider, { value: path }, children);
+    return createElement(PathContext.Provider, { value: { path, services: services ?? null } }, children);
 }
 /**
- * Access the nearest `PathProvider`'s path instance.
- * Throws if used outside of a `<PathProvider>`.
+ * Access the nearest `PathProvider`'s path instance and optional services object.
+ * Throws if used outside of a `<PathProvider>` or `<PathShell>`.
+ *
+ * Both generics are type-level assertions, not runtime guarantees:
+ * - `TData` narrows `snapshot.data`
+ * - `TServices` types the `services` value — must match what was passed to `PathShell` or `PathProvider`
  *
- * The optional generic narrows `snapshot.data` for convenience — it is a
- * **type-level assertion**, not a runtime guarantee.
+ * @example
+ * ```tsx
+ * function OfficeStep() {
+ *   const { snapshot, services } = usePathContext<HiringData, HiringServices>();
+ *   // services is typed as HiringServices
+ * }
+ * ```
  */
 export function usePathContext() {
     const ctx = useContext(PathContext);
     if (ctx === null) {
         throw new Error("usePathContext must be used within a <PathProvider>.");
     }
-    return ctx;
+    return {
+        ...ctx.path,
+        services: ctx.services
+    };
 }
 // ---------------------------------------------------------------------------
-// Helpers
+// useField — input binding helper
 // ---------------------------------------------------------------------------
-/** Converts a camelCase or lowercase field key to a display label.
- *  e.g. "firstName" → "First Name", "email" → "Email" */
-function formatFieldKey(key) {
-    return key.replace(/([A-Z])/g, " $1").replace(/^./, c => c.toUpperCase()).trim();
+/**
+ * Binding helper for a single `<input>`, `<select>`, or `<textarea>` field.
+ *
+ * Returns `{ value, onChange }` tied to `snapshot.data[field]`, so you can
+ * spread it directly onto an element and eliminate the repetitive
+ * `onChange={e => setData("field", e.target.value)}` pattern:
+ *
+ * ```tsx
+ * function NameStep() {
+ *   const name = useField<MyData, "name">("name");
+ *   return <input type="text" {...name} />;
+ * }
+ * ```
+ *
+ * - `value` is always a `string` (falls back to `""` when the data key is unset).
+ * - `onChange` calls `setData(field, e.target.value)`.
+ *
+ * For inputs that need a value transform (e.g. `.trim()`, `Number()`) keep
+ * an explicit `onChange` handler — this helper is for the no-transform case.
+ *
+ * Must be called inside a `<PathShell>` or `<PathProvider>`.
+ */
+export function useField(field) {
+    const { snapshot, setData } = usePathContext();
+    const onChange = useCallback((e) => {
+        setData(field, e.target.value);
+    }, 
+    // field is a string literal at the call site and never changes; setData is stable
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [field, setData]);
+    return { value: String(snapshot.data[field] ?? ""), onChange };
 }
 /**
  * Default UI shell that renders a progress indicator, step content, and navigation
@@ -104,7 +142,7 @@ function formatFieldKey(key) {
  * />
  * ```
  */
-export function PathShell({ path: pathDef, engine: externalEngine, steps, initialData = {}, autoStart = true, onComplete, onCancel, onEvent, backLabel = "Previous", nextLabel = "Next", completeLabel = "Complete", cancelLabel = "Cancel", hideCancel = false, hideProgress = false, footerLayout = "auto", className, renderHeader, renderFooter, validationDisplay = "inline", progressLayout = "merged", }) {
+export const PathShell = forwardRef(function PathShell({ path: pathDef, engine: externalEngine, steps, initialData = {}, autoStart = true, onComplete, onCancel, onEvent, backLabel = "Previous", nextLabel = "Next", completeLabel = "Complete", loadingLabel, cancelLabel = "Cancel", hideCancel = false, hideProgress = false, footerLayout = "auto", className, renderHeader, renderFooter, validationDisplay = "summary", progressLayout = "merged", services, }, ref) {
     const pathReturn = usePath({
         engine: externalEngine,
         onEvent(event) {
@@ -115,7 +153,10 @@ export function PathShell({ path: pathDef, engine: externalEngine, steps, initia
                 onCancel?.(event.data);
         }
     });
-    const { snapshot, start, next, previous, cancel, goToStep, goToStepChecked, setData, restart } = pathReturn;
+    const { snapshot, start, next, previous, cancel, goToStep, goToStepChecked, setData, restart, retry, suspend } = pathReturn;
+    useImperativeHandle(ref, () => ({
+        restart: () => restart(),
+    }));
     // Auto-start on mount — skipped when an external engine is provided since
     // the caller is responsible for starting it (e.g. via createPersistedEngine).
     const startedRef = useRef(false);
@@ -133,8 +174,9 @@ export function PathShell({ path: pathDef, engine: externalEngine, steps, initia
     const stepContent = snapshot
         ? ((snapshot.formId ? steps[snapshot.formId] : undefined) ?? steps[snapshot.stepId] ?? null)
         : null;
+    const contextValue = { path: pathReturn, services: services ?? null };
     if (!snapshot) {
-        return createElement(PathContext.Provider, { value: pathReturn }, createElement("div", { className: cls("pw-shell", className) }, createElement("div", { className: "pw-shell__empty" }, createElement("p", null, "No active path."), !autoStart && createElement("button", {
+        return createElement(PathContext.Provider, { value: contextValue }, createElement("div", { className: cls("pw-shell", className) }, createElement("div", { className: "pw-shell__empty" }, createElement("p", null, "No active path."), !autoStart && createElement("button", {
             type: "button",
             className: "pw-shell__start-btn",
             onClick: () => start(pathDef, initialData)
@@ -142,13 +184,15 @@ export function PathShell({ path: pathDef, engine: externalEngine, steps, initia
     }
     const actions = {
         next, previous, cancel, goToStep, goToStepChecked, setData,
-        restart: () => restart(pathDef, initialData)
+        restart: () => restart(),
+        retry: () => retry(),
+        suspend: () => suspend(),
     };
     const showRoot = !hideProgress && !!snapshot.rootProgress && progressLayout !== "activeOnly";
     const showActive = !hideProgress && (renderHeader
         ? true
         : (snapshot.stepCount > 1 || snapshot.nestingLevel > 0) && progressLayout !== "rootOnly");
-    return createElement(PathContext.Provider, { value: pathReturn }, createElement("div", { className: cls("pw-shell", progressLayout !== "merged" && `pw-shell--progress-${progressLayout}`, className) }, 
+    return createElement(PathContext.Provider, { value: contextValue }, createElement("div", { className: cls("pw-shell", progressLayout !== "merged" && `pw-shell--progress-${progressLayout}`, className) }, 
     // Root progress — persistent top-level bar visible during sub-paths
     showRoot && defaultRootProgress(snapshot.rootProgress), 
     // Header — progress indicator (active path)
@@ -161,13 +205,19 @@ export function PathShell({ path: pathDef, engine: externalEngine, steps, initia
     validationDisplay !== "inline" && snapshot.hasAttemptedNext && Object.keys(snapshot.fieldErrors).length > 0 && createElement("ul", { className: "pw-shell__validation" }, ...Object.entries(snapshot.fieldErrors).map(([key, msg]) => createElement("li", { key, className: "pw-shell__validation-item" }, key !== "_" && createElement("span", { className: "pw-shell__validation-label" }, formatFieldKey(key)), msg))), 
     // Warning messages — non-blocking, shown immediately (no hasAttemptedNext gate)
     validationDisplay !== "inline" && Object.keys(snapshot.fieldWarnings).length > 0 && createElement("ul", { className: "pw-shell__warnings" }, ...Object.entries(snapshot.fieldWarnings).map(([key, msg]) => createElement("li", { key, className: "pw-shell__warnings-item" }, key !== "_" && createElement("span", { className: "pw-shell__warnings-label" }, formatFieldKey(key)), msg))), 
-    // Footer — navigation buttons
-    renderFooter
-        ? renderFooter(snapshot, actions)
-        : defaultFooter(snapshot, actions, {
-            backLabel, nextLabel, completeLabel, cancelLabel, hideCancel, footerLayout
-        })));
-}
+    // Blocking error — guard returned { allowed: false, reason }
+    validationDisplay !== "inline" && snapshot.hasAttemptedNext && snapshot.blockingError &&
+        createElement("p", { className: "pw-shell__blocking-error" }, snapshot.blockingError), 
+    // Error panel — replaces footer when an async operation has failed
+    snapshot.status === "error" && snapshot.error
+        ? defaultErrorPanel(snapshot, actions)
+        // Footer — navigation buttons
+        : renderFooter
+            ? renderFooter(snapshot, actions)
+            : defaultFooter(snapshot, actions, {
+                backLabel, nextLabel, completeLabel, loadingLabel, cancelLabel, hideCancel, footerLayout
+            })));
+});
 // ---------------------------------------------------------------------------
 // Root progress (compact top-level bar visible during sub-paths)
 // ---------------------------------------------------------------------------
@@ -192,6 +242,30 @@ function defaultHeader(snapshot) {
         style: { width: `${snapshot.progress * 100}%` }
     })));
 }
+// ---------------------------------------------------------------------------
+// Default error panel
+// ---------------------------------------------------------------------------
+function defaultErrorPanel(snapshot, actions) {
+    const { error, hasPersistence } = snapshot;
+    if (!error)
+        return createElement("div", null);
+    const escalated = error.retryCount >= 2;
+    const title = escalated ? "Still having trouble." : "Something went wrong.";
+    const phaseMsg = errorPhaseMessage(error.phase);
+    return createElement("div", { className: "pw-shell__error" }, createElement("div", { className: "pw-shell__error-title" }, title), createElement("div", { className: "pw-shell__error-message" }, phaseMsg, error.message && ` ${error.message}`), createElement("div", { className: "pw-shell__error-actions" }, !escalated && createElement("button", {
+        type: "button",
+        className: "pw-shell__btn pw-shell__btn--retry",
+        onClick: actions.retry
+    }, "Try again"), hasPersistence && createElement("button", {
+        type: "button",
+        className: cls("pw-shell__btn", escalated ? "pw-shell__btn--retry" : "pw-shell__btn--suspend"),
+        onClick: actions.suspend
+    }, "Save and come back later"), escalated && !hasPersistence && createElement("button", {
+        type: "button",
+        className: "pw-shell__btn pw-shell__btn--retry",
+        onClick: actions.retry
+    }, "Try again")));
+}
 function defaultFooter(snapshot, actions, labels) {
     // Auto-detect layout: single-step top-level paths use "form", everything else uses "wizard"
     const resolvedLayout = labels.footerLayout === "auto"
@@ -203,30 +277,32 @@ function defaultFooter(snapshot, actions, labels) {
     isFormMode && !labels.hideCancel && createElement("button", {
         type: "button",
         className: "pw-shell__btn pw-shell__btn--cancel",
-        disabled: snapshot.isNavigating,
+        disabled: snapshot.status !== "idle",
         onClick: actions.cancel
     }, labels.cancelLabel), 
     // Wizard mode: Back on the left
     !isFormMode && !snapshot.isFirstStep && createElement("button", {
         type: "button",
         className: "pw-shell__btn pw-shell__btn--back",
-        disabled: snapshot.isNavigating || !snapshot.canMovePrevious,
+        disabled: snapshot.status !== "idle" || !snapshot.canMovePrevious,
         onClick: actions.previous
     }, labels.backLabel)), createElement("div", { className: "pw-shell__footer-right" }, 
     // Wizard mode: Cancel on the right
     !isFormMode && !labels.hideCancel && createElement("button", {
         type: "button",
         className: "pw-shell__btn pw-shell__btn--cancel",
-        disabled: snapshot.isNavigating,
+        disabled: snapshot.status !== "idle",
         onClick: actions.cancel
     }, labels.cancelLabel), 
     // Both modes: Submit on the right
     createElement("button", {
         type: "button",
-        className: "pw-shell__btn pw-shell__btn--next",
-        disabled: snapshot.isNavigating,
+        className: cls("pw-shell__btn pw-shell__btn--next", snapshot.status !== "idle" && "pw-shell__btn--loading"),
+        disabled: snapshot.status !== "idle",
         onClick: actions.next
-    }, snapshot.isLastStep ? labels.completeLabel : labels.nextLabel)));
+    }, snapshot.status !== "idle" && labels.loadingLabel
+        ? labels.loadingLabel
+        : snapshot.isLastStep ? labels.completeLabel : labels.nextLabel)));
 }
 // ---------------------------------------------------------------------------
 // Helpers

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daltonr/pathwrite-react",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "type": "module",
   "license": "MIT",
   "description": "React adapter for @daltonr/pathwrite-core — hooks, context provider, and optional <PathShell> default UI.",
@@ -46,7 +46,7 @@
     "react": ">=18.0.0"
   },
   "dependencies": {
-    "@daltonr/pathwrite-core": "^0.8.0"
+    "@daltonr/pathwrite-core": "^0.10.0"
   },
   "devDependencies": {
     "react": "^18.3.1",

package/src/index.ts

@@ -1,13 +1,15 @@
 import {
   createContext,
   createElement,
+  forwardRef,
   useCallback,
   useContext,
   useEffect,
+  useImperativeHandle,
   useRef,
   useSyncExternalStore
 } from "react";
-import type { PropsWithChildren, ReactElement, ReactNode } from "react";
+import type { ChangeEvent, PropsWithChildren, ReactElement, ReactNode } from "react";
 import {
   PathData,
   PathDefinition,
@@ -15,7 +17,9 @@ import {
   PathEvent,
   PathSnapshot,
   ProgressLayout,
-  RootProgress
+  RootProgress,
+  formatFieldKey,
+  errorPhaseMessage,
 } from "@daltonr/pathwrite-core";
 
 // ---------------------------------------------------------------------------
@@ -25,7 +29,7 @@ import {
 export interface UsePathOptions {
   /**
    * An externally-managed `PathEngine` to subscribe to — for example, the engine
-   * returned by `createPersistedEngine()` from `@daltonr/pathwrite-store-http`.
+   * returned by `createPersistedEngine()` from `@daltonr/pathwrite-store`.
    *
    * When provided:
    * - `usePath` will **not** create its own engine.
@@ -60,16 +64,34 @@ export interface UsePathReturn<TData extends PathData = PathData> {
   /** Reset the current step's data to what it was when the step was entered. Useful for "Clear" or "Reset" buttons. */
   resetStep: () => void;
   /**
-   * Tear down any active path (without firing hooks) and immediately start the
-   * given path fresh. Safe to call whether or not a path is currently active.
+   * Tear down any active path (without firing hooks) and immediately restart
+   * the same path with the same initial data. Safe to call at any time.
    * Use for "Start over" / retry flows without remounting the component.
    */
-  restart: (path: PathDefinition<any>, initialData?: PathData) => void;
+  restart: () => void;
+  /**
+   * Re-runs the operation that set `snapshot.error`. Increments `snapshot.error.retryCount`
+   * on repeated failure so shells can escalate from "Try again" to "Come back later".
+   * No-op when there is no pending error.
+   */
+  retry: () => void;
+  /**
+   * Pauses the path with intent to return. Emits a `suspended` event that the application
+   * listens for to dismiss the wizard UI. All state and data are preserved.
+   */
+  suspend: () => void;
 }
 
 export type PathProviderProps = PropsWithChildren<{
   /** Forwarded to the internal usePath hook. */
   onEvent?: (event: PathEvent) => void;
+  /**
+   * Services object passed through context to all step components.
+   * Step components access it via `usePathContext<TData, TServices>()`.
+   * Typed as `unknown` here so `PathProvider` stays non-generic — provide a
+   * typed services interface via the `TServices` type parameter on `usePathContext`.
+   */
+  services?: unknown;
 }>;
 
 // ---------------------------------------------------------------------------
@@ -156,55 +178,108 @@ export function usePath<TData extends PathData = PathData>(options?: UsePathOpti
 
   const resetStep = useCallback(() => engine.resetStep(), [engine]);
 
-  const restart = useCallback(
-    (path: PathDefinition<any>, initialData: PathData = {}) =>
-      engine.restart(path, initialData),
-    [engine]
-  );
+  const restart = useCallback(() => engine.restart(), [engine]);
+
+  const retry = useCallback(() => engine.retry(), [engine]);
 
-  return { snapshot, start, startSubPath, next, previous, cancel, goToStep, goToStepChecked, setData, resetStep, restart };
+  const suspend = useCallback(() => engine.suspend(), [engine]);
+
+  return { snapshot, start, startSubPath, next, previous, cancel, goToStep, goToStepChecked, setData, resetStep, restart, retry, suspend };
 }
 
 // ---------------------------------------------------------------------------
 // Context + Provider
 // ---------------------------------------------------------------------------
 
-const PathContext = createContext<UsePathReturn | null>(null);
+interface PathContextValue {
+  path: UsePathReturn;
+  services: unknown;
+}
+
+const PathContext = createContext<PathContextValue | null>(null);
 
 /**
  * Provides a single `usePath` instance to all descendants.
  * Consume with `usePathContext()`.
  */
-export function PathProvider({ children, onEvent }: PathProviderProps): ReactElement {
+export function PathProvider({ children, onEvent, services }: PathProviderProps): ReactElement {
   const path = usePath({ onEvent });
-  return createElement(PathContext.Provider, { value: path }, children);
+  return createElement(PathContext.Provider, { value: { path, services: services ?? null } }, children);
 }
 
 /**
- * Access the nearest `PathProvider`'s path instance.
- * Throws if used outside of a `<PathProvider>`.
+ * Access the nearest `PathProvider`'s path instance and optional services object.
+ * Throws if used outside of a `<PathProvider>` or `<PathShell>`.
  *
- * The optional generic narrows `snapshot.data` for convenience — it is a
- * **type-level assertion**, not a runtime guarantee.
+ * Both generics are type-level assertions, not runtime guarantees:
+ * - `TData` narrows `snapshot.data`
+ * - `TServices` types the `services` value — must match what was passed to `PathShell` or `PathProvider`
+ *
+ * @example
+ * ```tsx
+ * function OfficeStep() {
+ *   const { snapshot, services } = usePathContext<HiringData, HiringServices>();
+ *   // services is typed as HiringServices
+ * }
+ * ```
  */
-export function usePathContext<TData extends PathData = PathData>(): UsePathReturn<TData> {
+export function usePathContext<TData extends PathData = PathData, TServices = unknown>(): Omit<UsePathReturn<TData>, "snapshot"> & { snapshot: PathSnapshot<TData>; services: TServices } {
   const ctx = useContext(PathContext);
   if (ctx === null) {
     throw new Error("usePathContext must be used within a <PathProvider>.");
   }
-  return ctx as UsePathReturn<TData>;
+  return {
+    ...(ctx.path as unknown as Omit<UsePathReturn<TData>, "snapshot"> & { snapshot: PathSnapshot<TData> }),
+    services: ctx.services as TServices
+  };
 }
 
 // ---------------------------------------------------------------------------
-// Helpers
+// useField — input binding helper
 // ---------------------------------------------------------------------------
 
-/** Converts a camelCase or lowercase field key to a display label.
- *  e.g. "firstName" → "First Name", "email" → "Email" */
-function formatFieldKey(key: string): string {
-  return key.replace(/([A-Z])/g, " $1").replace(/^./, c => c.toUpperCase()).trim();
+/**
+ * Binding helper for a single `<input>`, `<select>`, or `<textarea>` field.
+ *
+ * Returns `{ value, onChange }` tied to `snapshot.data[field]`, so you can
+ * spread it directly onto an element and eliminate the repetitive
+ * `onChange={e => setData("field", e.target.value)}` pattern:
+ *
+ * ```tsx
+ * function NameStep() {
+ *   const name = useField<MyData, "name">("name");
+ *   return <input type="text" {...name} />;
+ * }
+ * ```
+ *
+ * - `value` is always a `string` (falls back to `""` when the data key is unset).
+ * - `onChange` calls `setData(field, e.target.value)`.
+ *
+ * For inputs that need a value transform (e.g. `.trim()`, `Number()`) keep
+ * an explicit `onChange` handler — this helper is for the no-transform case.
+ *
+ * Must be called inside a `<PathShell>` or `<PathProvider>`.
+ */
+export function useField<TData extends PathData, K extends string & keyof TData>(
+  field: K
+): { value: string; onChange: (e: ChangeEvent<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement>) => void } {
+  const { snapshot, setData } = usePathContext<TData>();
+  const onChange = useCallback(
+    (e: ChangeEvent<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement>) => {
+      setData(field, e.target.value as TData[K]);
+    },
+    // field is a string literal at the call site and never changes; setData is stable
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [field, setData]
+  );
+  return { value: String(snapshot.data[field] ?? ""), onChange };
 }
 
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+
 // ---------------------------------------------------------------------------
 // Default UI — PathShell
 // ---------------------------------------------------------------------------
@@ -236,6 +311,8 @@ export interface PathShellProps {
   nextLabel?: string;
   /** Label for the Complete button (shown on the last step). Defaults to `"Complete"`. */
   completeLabel?: string;
+  /** Label shown on the Next/Complete button while an async operation is in progress. Defaults to `undefined` (button shows a CSS spinner but keeps its label). */
+  loadingLabel?: string;
   /** Label for the Cancel button. Defaults to `"Cancel"`. */
   cancelLabel?: string;
   /** If true, hide the Cancel button. Defaults to `false`. */
@@ -270,6 +347,27 @@ export interface PathShellProps {
    * - `"activeOnly"`: Only the active (sub-path) bar — root bar hidden.
    */
   progressLayout?: ProgressLayout;
+  /**
+   * Services object passed through context to all step components.
+   * Step components access it via `usePathContext<TData, TServices>()`.
+   *
+   * The same services object that was passed to your path factory function
+   * should be passed here so step components can call service methods directly
+   * (e.g. parameterised queries that depend on mid-step user input).
+   *
+   * @example
+   * ```tsx
+   * const svc = new LiveHiringServices();
+   * const path = createHiringPath(svc);
+   * <PathShell path={path} services={svc} steps={{ ... }} />
+   * ```
+   */
+  services?: unknown;
+}
+
+export interface PathShellHandle {
+  /** Restart the shell's current path with its original `initialData`, without unmounting. */
+  restart: () => void;
 }
 
 export interface PathShellActions {
@@ -281,6 +379,10 @@ export interface PathShellActions {
   setData: (key: string, value: unknown) => void;
   /** Restart the shell's current path with its current `initialData`. */
   restart: () => void;
+  /** Re-run the operation that set `snapshot.error`. See `PathEngine.retry()`. */
+  retry: () => void;
+  /** Pause with intent to return, preserving all state. Emits `suspended`. */
+  suspend: () => void;
 }
 
 /**
@@ -299,7 +401,7 @@ export interface PathShellActions {
  * />
  * ```
  */
-export function PathShell({
+export const PathShell = forwardRef<PathShellHandle, PathShellProps>(function PathShell({
   path: pathDef,
   engine: externalEngine,
   steps,
@@ -311,6 +413,7 @@ export function PathShell({
   backLabel = "Previous",
   nextLabel = "Next",
   completeLabel = "Complete",
+  loadingLabel,
   cancelLabel = "Cancel",
   hideCancel = false,
   hideProgress = false,
@@ -318,9 +421,10 @@ export function PathShell({
   className,
   renderHeader,
   renderFooter,
-  validationDisplay = "inline",
+  validationDisplay = "summary",
   progressLayout = "merged",
-}: PathShellProps): ReactElement {
+  services,
+}: PathShellProps, ref): ReactElement {
   const pathReturn = usePath({
     engine: externalEngine,
     onEvent(event) {
@@ -330,7 +434,11 @@ export function PathShell({
     }
   });
 
-  const { snapshot, start, next, previous, cancel, goToStep, goToStepChecked, setData, restart } = pathReturn;
+  const { snapshot, start, next, previous, cancel, goToStep, goToStepChecked, setData, restart, retry, suspend } = pathReturn;
+
+  useImperativeHandle(ref, () => ({
+    restart: () => restart(),
+  }));
 
   // Auto-start on mount — skipped when an external engine is provided since
   // the caller is responsible for starting it (e.g. via createPersistedEngine).
@@ -351,8 +459,10 @@ export function PathShell({
     ? ((snapshot.formId ? steps[snapshot.formId] : undefined) ?? steps[snapshot.stepId] ?? null)
     : null;
 
+  const contextValue: PathContextValue = { path: pathReturn, services: services ?? null };
+
   if (!snapshot) {
-    return createElement(PathContext.Provider, { value: pathReturn },
+    return createElement(PathContext.Provider, { value: contextValue },
       createElement("div", { className: cls("pw-shell", className) },
         createElement("div", { className: "pw-shell__empty" },
           createElement("p", null, "No active path."),
@@ -368,7 +478,9 @@ export function PathShell({
 
   const actions: PathShellActions = {
     next, previous, cancel, goToStep, goToStepChecked, setData,
-    restart: () => restart(pathDef, initialData)
+    restart: () => restart(),
+    retry: () => retry(),
+    suspend: () => suspend(),
   };
 
   const showRoot = !hideProgress && !!snapshot.rootProgress && progressLayout !== "activeOnly";
@@ -376,7 +488,7 @@ export function PathShell({
     ? true
     : (snapshot.stepCount > 1 || snapshot.nestingLevel > 0) && progressLayout !== "rootOnly");
 
-  return createElement(PathContext.Provider, { value: pathReturn },
+  return createElement(PathContext.Provider, { value: contextValue },
     createElement("div", { className: cls("pw-shell", progressLayout !== "merged" && `pw-shell--progress-${progressLayout}`, className) },
       // Root progress — persistent top-level bar visible during sub-paths
       showRoot && defaultRootProgress(snapshot.rootProgress!),
@@ -404,15 +516,21 @@ export function PathShell({
           )
         )
       ),
-      // Footer — navigation buttons
-      renderFooter
-        ? renderFooter(snapshot, actions)
-        : defaultFooter(snapshot, actions, {
-            backLabel, nextLabel, completeLabel, cancelLabel, hideCancel, footerLayout
-          })
+      // Blocking error — guard returned { allowed: false, reason }
+      validationDisplay !== "inline" && snapshot.hasAttemptedNext && snapshot.blockingError &&
+        createElement("p", { className: "pw-shell__blocking-error" }, snapshot.blockingError),
+      // Error panel — replaces footer when an async operation has failed
+      snapshot.status === "error" && snapshot.error
+        ? defaultErrorPanel(snapshot, actions)
+        // Footer — navigation buttons
+        : renderFooter
+          ? renderFooter(snapshot, actions)
+          : defaultFooter(snapshot, actions, {
+              backLabel, nextLabel, completeLabel, loadingLabel, cancelLabel, hideCancel, footerLayout
+            })
     )
   );
-}
+});
 
 // ---------------------------------------------------------------------------
 // Root progress (compact top-level bar visible during sub-paths)
@@ -474,6 +592,47 @@ function defaultHeader(snapshot: PathSnapshot): ReactElement {
   );
 }
 
+// ---------------------------------------------------------------------------
+// Default error panel
+// ---------------------------------------------------------------------------
+
+
+function defaultErrorPanel(
+  snapshot: PathSnapshot,
+  actions: PathShellActions
+): ReactElement {
+  const { error, hasPersistence } = snapshot;
+  if (!error) return createElement("div", null);
+  const escalated = error.retryCount >= 2;
+  const title = escalated ? "Still having trouble." : "Something went wrong.";
+  const phaseMsg = errorPhaseMessage(error.phase);
+
+  return createElement("div", { className: "pw-shell__error" },
+    createElement("div", { className: "pw-shell__error-title" }, title),
+    createElement("div", { className: "pw-shell__error-message" },
+      phaseMsg,
+      error.message && ` ${error.message}`
+    ),
+    createElement("div", { className: "pw-shell__error-actions" },
+      !escalated && createElement("button", {
+        type: "button",
+        className: "pw-shell__btn pw-shell__btn--retry",
+        onClick: actions.retry
+      }, "Try again"),
+      hasPersistence && createElement("button", {
+        type: "button",
+        className: cls("pw-shell__btn", escalated ? "pw-shell__btn--retry" : "pw-shell__btn--suspend"),
+        onClick: actions.suspend
+      }, "Save and come back later"),
+      escalated && !hasPersistence && createElement("button", {
+        type: "button",
+        className: "pw-shell__btn pw-shell__btn--retry",
+        onClick: actions.retry
+      }, "Try again")
+    )
+  );
+}
+
 // ---------------------------------------------------------------------------
 // Default footer (navigation buttons)
 // ---------------------------------------------------------------------------
@@ -482,6 +641,7 @@ interface FooterLabels {
   backLabel: string;
   nextLabel: string;
   completeLabel: string;
+  loadingLabel?: string;
   cancelLabel: string;
   hideCancel: boolean;
   footerLayout: "wizard" | "form" | "auto";
@@ -505,14 +665,14 @@ function defaultFooter(
       isFormMode && !labels.hideCancel && createElement("button", {
         type: "button",
         className: "pw-shell__btn pw-shell__btn--cancel",
-        disabled: snapshot.isNavigating,
+        disabled: snapshot.status !== "idle",
         onClick: actions.cancel
       }, labels.cancelLabel),
       // Wizard mode: Back on the left
       !isFormMode && !snapshot.isFirstStep && createElement("button", {
         type: "button",
         className: "pw-shell__btn pw-shell__btn--back",
-        disabled: snapshot.isNavigating || !snapshot.canMovePrevious,
+        disabled: snapshot.status !== "idle" || !snapshot.canMovePrevious,
         onClick: actions.previous
       }, labels.backLabel)
     ),
@@ -521,16 +681,18 @@ function defaultFooter(
       !isFormMode && !labels.hideCancel && createElement("button", {
         type: "button",
         className: "pw-shell__btn pw-shell__btn--cancel",
-        disabled: snapshot.isNavigating,
+        disabled: snapshot.status !== "idle",
         onClick: actions.cancel
       }, labels.cancelLabel),
       // Both modes: Submit on the right
       createElement("button", {
         type: "button",
-        className: "pw-shell__btn pw-shell__btn--next",
-        disabled: snapshot.isNavigating,
+        className: cls("pw-shell__btn pw-shell__btn--next", snapshot.status !== "idle" && "pw-shell__btn--loading"),
+        disabled: snapshot.status !== "idle",
         onClick: actions.next
-      }, snapshot.isLastStep ? labels.completeLabel : labels.nextLabel)
+      }, snapshot.status !== "idle" && labels.loadingLabel
+          ? labels.loadingLabel
+          : snapshot.isLastStep ? labels.completeLabel : labels.nextLabel)
     )
   );
 }