@daltonr/pathwrite-core 0.3.0 → 0.4.0

package/README.md

@@ -2,6 +2,39 @@
 
 Headless path engine with zero dependencies. Manages step navigation, navigation guards, lifecycle hooks, and stack-based sub-path orchestration. Works equally well driving a UI wizard or a backend document lifecycle — no framework required.
 
+## Quick Reference: Common Patterns
+
+### ✅ Write Defensive Guards
+```typescript
+// Guards run BEFORE onEnter - always handle undefined data
+canMoveNext: (ctx) => (ctx.data.name ?? "").trim().length > 0  // ✅ Safe
+canMoveNext: (ctx) => ctx.data.name.trim().length > 0          // ❌ Crashes!
+```
+
+### ✅ Use `isFirstEntry` to Prevent Data Reset
+```typescript
+onEnter: (ctx) => {
+  if (ctx.isFirstEntry) {
+    return { items: [], status: "pending" };  // Initialize only on first visit
+  }
+  // Don't reset when user navigates back
+}
+```
+
+### ✅ Correlate Sub-Paths with `meta`
+```typescript
+// Starting sub-path
+engine.startSubPath(subPath, initialData, { itemIndex: i });
+
+// In parent step
+onSubPathComplete: (_id, subData, ctx, meta) => {
+  const index = meta?.itemIndex;  // Correlate back to collection item
+  // ...
+}
+```
+
+---
+
 ## Key types
 
 ```typescript
@@ -38,6 +71,7 @@ const path: PathDefinition<CourseData> = {
 const engine = new PathEngine();
 
 engine.start(definition, initialData?);    // start or re-start a path
+engine.restart(definition, initialData?);  // tear down stack and start fresh (no hooks, no cancelled event)
 engine.startSubPath(definition, data?);    // push sub-path onto the stack (requires active path)
 engine.next();
 engine.previous();
@@ -47,6 +81,10 @@ engine.goToStep(stepId);                   // jump to step by ID; bypasses guard
 engine.goToStepChecked(stepId);            // jump to step by ID; checks canMoveNext / canMovePrevious first
 engine.snapshot();                         // returns PathSnapshot | null
 
+// Serialization API (for persistence)
+const state = engine.exportState();        // returns SerializedPathState | null
+const restoredEngine = PathEngine.fromState(state, pathDefinitions);
+
 const unsubscribe = engine.subscribe((event) => { ... });
 unsubscribe(); // remove the listener
 ```
@@ -60,36 +98,318 @@ All hooks are optional. Hooks that want to update data **return a partial patch*
 | `onEnter` | On arrival at a step (start, next, previous, resume) | ✅ |
 | `onLeave` | On departure from a step (only when the guard allows) | ✅ |
 | `onSubPathComplete` | On the parent step when a sub-path finishes | ✅ |
+| `onSubPathCancel` | On the parent step when a sub-path is cancelled | ✅ |
 | `canMoveNext` | Before advancing — return `false` to block | — |
 | `canMovePrevious` | Before going back — return `false` to block | — |
 | `validationMessages` | On every snapshot — return `string[]` explaining why the step is not yet valid | — |
 
+### Using `isFirstEntry` to Avoid Data Reset
+
+**Problem:** `onEnter` fires EVERY time you enter a step, including when navigating backward. If you initialize data in `onEnter`, you'll overwrite user input when they return to the step.
+
+**Solution:** Use `ctx.isFirstEntry` to distinguish first visit from re-entry:
+
+```typescript
+{
+  id: "user-details",
+  onEnter: (ctx) => {
+    // Only initialize on first entry, not on re-entry
+    if (ctx.isFirstEntry) {
+      return {
+        name: "",
+        email: "",
+        preferences: { newsletter: true }
+      };
+    }
+    // On re-entry (e.g., user pressed Back), keep existing data
+  }
+}
+```
+
+**Common Patterns:**
+
+```typescript
+// Initialize empty collection on first entry only
+onEnter: (ctx) => {
+  if (ctx.isFirstEntry) {
+    return { approvals: [], comments: [] };
+  }
+}
+
+// Fetch data from API only once
+onEnter: async (ctx) => {
+  if (ctx.isFirstEntry) {
+    const userData = await fetchUserProfile(ctx.data.userId);
+    return { ...userData };
+  }
+}
+
+// Set defaults but preserve user changes on re-entry
+onEnter: (ctx) => {
+  if (ctx.isFirstEntry) {
+    return {
+      reviewStatus: "pending",
+      lastModified: new Date().toISOString()
+    };
+  }
+}
+```
+
 ### Snapshot guard booleans
 
 The snapshot includes `canMoveNext` and `canMovePrevious` booleans — the evaluated results of the current step's guards. Use them to proactively disable navigation buttons. Sync guards reflect their real value; async guards default to `true` (optimistic). Both update automatically when data changes via `setData`.
 
-### Example — sub-path result merged into parent data
+### ⚠️ IMPORTANT: Guards Run Before `onEnter`
+
+**Guards are evaluated BEFORE `onEnter` runs on first entry.** This is critical to understand:
+
+1. When a path starts, the engine creates the first snapshot immediately
+2. Guards (`canMoveNext`, `validationMessages`) are evaluated to populate that snapshot
+3. Only THEN does `onEnter` run to initialize data
+
+**This means guards see `initialData`, not data that `onEnter` would set.**
+
+#### Defensive Guard Patterns
+
+Always write guards defensively to handle undefined/missing data:
 
 ```typescript
+// ❌ WRONG - Crashes on first snapshot when initialData = {}
 {
-  id: "subjects-list",
-  onSubPathComplete: (_id, subData, ctx) => ({
-    subjects: [...(ctx.data.subjects ?? []), { name: subData.name, teacher: subData.teacher }]
-  })
+  id: "user-details",
+  canMoveNext: (ctx) => ctx.data.name.trim().length > 0,  // TypeError!
+  onEnter: () => ({ name: "" })  // Too late - guard already ran
+}
+
+// ✅ CORRECT - Use nullish coalescing
+{
+  id: "user-details",
+  canMoveNext: (ctx) => (ctx.data.name ?? "").trim().length > 0,
+  onEnter: () => ({ name: "" })
 }
+
+// ✅ ALSO CORRECT - Provide initialData so fields exist from the start
+engine.start(path, { name: "", email: "" });
 ```
 
-## Sub-path flow
+#### More Defensive Patterns
+
+```typescript
+// Arrays
+canMoveNext: (ctx) => (ctx.data.items ?? []).length > 0
+
+// Numbers
+canMoveNext: (ctx) => (ctx.data.age ?? 0) >= 18
 
+// Complex objects
+canMoveNext: (ctx) => {
+  const address = ctx.data.address ?? {};
+  return (address.street ?? "").length > 0 && (address.city ?? "").length > 0;
+}
+
+// Validation messages
+validationMessages: (ctx) => {
+  const messages = [];
+  if (!(ctx.data.email ?? "").includes("@")) {
+    messages.push("Please enter a valid email");
+  }
+  return messages;
+}
 ```
+
+#### Error Handling
+
+If a guard or `validationMessages` hook throws, Pathwrite catches the error, emits a `console.warn` (with the step ID and thrown value), and returns the safe default (`true` / `[]`) so the UI remains operable. However, **relying on error handling is not recommended** — write defensive guards instead.
+
+### Sub-path example with meta correlation
+
+```typescript
+{
+  id: "subjects-list",
+  onSubPathComplete: (_id, subData, ctx, meta) => {
+    // meta contains the correlation object passed to startSubPath
+    const index = meta?.index as number;
+    return {
+      subjects: [...(ctx.data.subjects ?? []), { 
+        index,
+        name: subData.name, 
+        teacher: subData.teacher 
+      }]
+    };
+  },
+  onSubPathCancel: (_id, ctx, meta) => {
+    // Called when user cancels sub-path (e.g., Back on first step)
+    const index = meta?.index as number;
+    console.log(`User skipped subject ${index}`);
+    // Return patch to record the skip, or return nothing to ignore
+  }
+}
+```
+
+## Sub-Paths: Comprehensive Guide
+
+Sub-paths let you nest workflows — for example, running a mini-wizard for each item in a collection.
+
+### Basic Flow
+
+```typescript
 engine.start(mainPath)          → stack: []         active: main
 engine.startSubPath(subPath)    → stack: [main]     active: sub
 engine.next()  // sub finishes
   → onSubPathComplete fires on the parent step
-  → stack: []                                       active: main
+  → stack: []                   active: main (resumed)
+```
+
+### Complete Example: Document Approval Workflow
+
+```typescript
+interface ApprovalData extends PathData {
+  documentTitle: string;
+  approvers: Array<{ name: string; email: string }>;
+  approvals: Array<{ approverIndex: number; decision: string; comments: string }>;
+}
+
+interface ApproverReviewData extends PathData {
+  documentTitle: string;  // Passed from parent
+  decision?: "approve" | "reject";
+  comments?: string;
+}
+
+// Main path
+const approvalPath: PathDefinition<ApprovalData> = {
+  id: "approval-workflow",
+  steps: [
+    {
+      id: "setup",
+      onEnter: (ctx) => {
+        if (ctx.isFirstEntry) {
+          return { approvers: [], approvals: [] };
+        }
+      }
+    },
+    {
+      id: "run-approvals",
+      // Block next until all approvers have completed
+      canMoveNext: (ctx) => {
+        const approversCount = (ctx.data.approvers ?? []).length;
+        const approvalsCount = (ctx.data.approvals ?? []).length;
+        return approversCount > 0 && approvalsCount === approversCount;
+      },
+      validationMessages: (ctx) => {
+        const approversCount = (ctx.data.approvers ?? []).length;
+        const approvalsCount = (ctx.data.approvals ?? []).length;
+        const remaining = approversCount - approvalsCount;
+        if (remaining > 0) {
+          return [`${remaining} approver(s) still need to complete their review`];
+        }
+        return [];
+      },
+      // Called when each approver sub-path completes
+      onSubPathComplete: (_subPathId, subData, ctx, meta) => {
+        const reviewData = subData as ApproverReviewData;
+        const approverIndex = meta?.approverIndex as number;
+        
+        return {
+          approvals: [
+            ...(ctx.data.approvals ?? []),
+            {
+              approverIndex,
+              decision: reviewData.decision!,
+              comments: reviewData.comments ?? ""
+            }
+          ]
+        };
+      },
+      // Called when approver cancels (presses Back on first step)
+      onSubPathCancel: (_subPathId, ctx, meta) => {
+        const approverIndex = meta?.approverIndex as number;
+        console.log(`Approver ${approverIndex} declined to review`);
+        // Could add to a "skipped" list or just ignore
+      }
+    },
+    { id: "summary" }
+  ]
+};
+
+// Sub-path for each approver
+const approverReviewPath: PathDefinition<ApproverReviewData> = {
+  id: "approver-review",
+  steps: [
+    { id: "review-document" },
+    {
+      id: "make-decision",
+      canMoveNext: (ctx) => ctx.data.decision !== undefined
+    },
+    { id: "add-comments" }
+  ]
+};
+
+// Usage in UI component
+function ReviewStep() {
+  const approvers = snapshot.data.approvers ?? [];
+  const approvals = snapshot.data.approvals ?? [];
+  
+  const startReview = (approverIndex: number) => {
+    const approver = approvers[approverIndex];
+    
+    // Start sub-path with meta correlation
+    engine.startSubPath(
+      approverReviewPath,
+      {
+        documentTitle: snapshot.data.documentTitle,  // Pass context from parent
+        // decision and comments will be filled during sub-path
+      },
+      { approverIndex }  // Meta: correlates completion back to this approver
+    );
+  };
+  
+  return (
+    <div>
+      {approvers.map((approver, i) => (
+        <div key={i}>
+          {approver.name}
+          {approvals.some(a => a.approverIndex === i) ? (
+            <span>✓ Reviewed</span>
+          ) : (
+            <button onClick={() => startReview(i)}>Start Review</button>
+          )}
+        </div>
+      ))}
+    </div>
+  );
+}
 ```
 
-Cancelling a sub-path pops it off the stack silently — `onSubPathComplete` is **not** called.
+### Sub-Path Key Concepts
+
+1. **Stack-based**: Sub-paths push onto a stack. Parent is paused while sub-path is active.
+
+2. **Meta correlation**: Pass a `meta` object to `startSubPath()` to identify which collection item triggered the sub-path. It's passed back unchanged to `onSubPathComplete` and `onSubPathCancel`.
+
+3. **Data isolation**: Sub-path data is separate from parent data. Pass needed context (like `documentTitle`) in `initialData`.
+
+4. **Completion vs Cancellation**:
+   - **Complete**: User reaches the last step → `onSubPathComplete` fires
+   - **Cancel**: User presses Back on first step → `onSubPathCancel` fires
+   - `onSubPathComplete` is NOT called on cancellation
+
+5. **Parent remains on same step**: After sub-path completes/cancels, parent resumes at the same step (not advanced automatically).
+
+6. **Guards still apply**: Parent step's `canMoveNext` is evaluated when resuming. Use it to block until all sub-paths complete.
+
+### What the Shell Renders During Sub-Paths
+
+When a sub-path is active:
+- Progress bar shows sub-path steps (parent steps disappear)
+- Back button on sub-path's first step cancels the sub-path
+- Completing the sub-path returns to parent (parent step re-renders)
+
+### Nesting Levels
+
+Sub-paths can themselves start sub-paths (unlimited nesting). Use `snapshot.nestingLevel` to determine depth:
+- `0` = top-level path
+- `1` = first-level sub-path
+- `2+` = deeper nesting
 
 ## Events
 
@@ -103,3 +423,48 @@ engine.subscribe((event) => {
   }
 });
 ```
+
+## State Persistence
+
+The engine supports exporting and restoring state for persistence scenarios (e.g., saving wizard progress to a server or localStorage).
+
+### exportState()
+
+Returns a plain JSON-serializable object (`SerializedPathState`) containing the current state:
+- Current path ID and step index
+- Path data
+- Visited step IDs
+- Sub-path stack (if nested paths are active)
+- Navigation flags
+
+Returns `null` if no path is active.
+
+```typescript
+const state = engine.exportState();
+if (state) {
+  const json = JSON.stringify(state);
+  // Save to localStorage, send to server, etc.
+}
+```
+
+### PathEngine.fromState()
+
+Restores a PathEngine from previously exported state. **Important:** You must provide the same path definitions that were active when the state was exported.
+
+```typescript
+const state = JSON.parse(savedJson);
+const engine = PathEngine.fromState(state, {
+  "main-path": mainPathDefinition,
+  "sub-path": subPathDefinition
+});
+
+// Engine is restored to the exact step and state
+const snapshot = engine.snapshot();
+```
+
+Throws if:
+- State references a path ID not in `pathDefinitions`
+- State version is unsupported
+
+The restored engine is fully functional — you can continue navigation, modify data, complete or cancel paths normally.
+```

package/dist/index.d.ts

@@ -1,4 +1,20 @@
 export type PathData = Record<string, unknown>;
+export interface SerializedPathState {
+    version: 1;
+    pathId: string;
+    currentStepIndex: number;
+    data: PathData;
+    visitedStepIds: string[];
+    subPathMeta?: Record<string, unknown>;
+    pathStack: Array<{
+        pathId: string;
+        currentStepIndex: number;
+        data: PathData;
+        visitedStepIds: string[];
+        subPathMeta?: Record<string, unknown>;
+    }>;
+    _isNavigating: boolean;
+}
 export interface PathStepContext<TData extends PathData = PathData> {
     readonly pathId: string;
     readonly stepId: string;
@@ -101,8 +117,36 @@ export declare class PathEngine {
     private readonly pathStack;
     private readonly listeners;
     private _isNavigating;
+    /**
+     * Restores a PathEngine from previously exported state.
+     *
+     * **Important:** You must provide the same path definitions that were
+     * active when the state was exported. The path IDs in `state` are used
+     * to match against the provided definitions.
+     *
+     * @param state           The serialized state from `exportState()`.
+     * @param pathDefinitions A map of path ID → definition. Must include the
+     *                        active path and any paths in the stack.
+     * @returns A new PathEngine instance with the restored state.
+     * @throws If `state` references a path ID not present in `pathDefinitions`,
+     *         or if the state format is invalid.
+     */
+    static fromState(state: SerializedPathState, pathDefinitions: Record<string, PathDefinition>): PathEngine;
     subscribe(listener: (event: PathEvent) => void): () => void;
     start(path: PathDefinition<any>, initialData?: PathData): Promise<void>;
+    /**
+     * Tears down any active path (and the entire sub-path stack) without firing
+     * lifecycle hooks or emitting `cancelled`, then immediately starts the given
+     * path from scratch.
+     *
+     * Safe to call at any time — whether a path is running, already completed,
+     * or has never been started. Use this to implement a "Start over" button or
+     * to retry a path after completion without remounting the host component.
+     *
+     * @param path        The path definition to (re)start.
+     * @param initialData Data to seed the fresh path with. Defaults to `{}`.
+     */
+    restart(path: PathDefinition<any>, initialData?: PathData): Promise<void>;
     /**
      * Starts a sub-path on top of the currently active path. Throws if no path
      * is running.
@@ -137,6 +181,18 @@ export declare class PathEngine {
      */
     goToStepChecked(stepId: string): Promise<void>;
     snapshot(): PathSnapshot | null;
+    /**
+     * Exports the current engine state as a plain JSON-serializable object.
+     * Use with storage adapters (e.g. `@daltonr/pathwrite-store-http`) to
+     * persist and restore wizard progress.
+     *
+     * Returns `null` if no path is active.
+     *
+     * **Important:** This only exports the _state_ (data, step position, etc.),
+     * not the path definition. When restoring, you must provide the same
+     * `PathDefinition` to `fromState()`.
+     */
+    exportState(): SerializedPathState | null;
     private _startAsync;
     private _nextAsync;
     private _previousAsync;
@@ -159,12 +215,27 @@ export declare class PathEngine {
      * Evaluates a guard function synchronously for inclusion in the snapshot.
      * If the guard is absent, returns `true`.
      * If the guard returns a `Promise`, returns `true` (optimistic default).
+     *
+     * **Note:** Guards are evaluated on every snapshot, including the very first one
+     * emitted at the start of a path — _before_ `onEnter` has run on that step.
+     * This means `data` will still reflect the `initialData` passed to `start()`.
+     * Write guards defensively (e.g. `(data.name ?? "").trim().length > 0`) so they
+     * do not throw when optional fields are absent on first entry.
+     *
+     * If a guard throws, the error is caught, a `console.warn` is emitted, and the
+     * safe default (`true`) is returned so the UI remains operable.
      */
     private evaluateGuardSync;
     /**
      * Evaluates a validationMessages function synchronously for inclusion in the snapshot.
      * If the hook is absent, returns `[]`.
      * If the hook returns a `Promise`, returns `[]` (async hooks are not supported in snapshots).
+     *
+     * **Note:** Like guards, `validationMessages` is evaluated before `onEnter` runs on first
+     * entry. Write it defensively so it does not throw when fields are absent.
+     *
+     * If the function throws, the error is caught, a `console.warn` is emitted, and `[]`
+     * is returned so validation messages do not block the UI unexpectedly.
      */
     private evaluateValidationMessagesSync;
 }

package/dist/index.js

@@ -3,6 +3,57 @@ export class PathEngine {
     pathStack = [];
     listeners = new Set();
     _isNavigating = false;
+    /**
+     * Restores a PathEngine from previously exported state.
+     *
+     * **Important:** You must provide the same path definitions that were
+     * active when the state was exported. The path IDs in `state` are used
+     * to match against the provided definitions.
+     *
+     * @param state           The serialized state from `exportState()`.
+     * @param pathDefinitions A map of path ID → definition. Must include the
+     *                        active path and any paths in the stack.
+     * @returns A new PathEngine instance with the restored state.
+     * @throws If `state` references a path ID not present in `pathDefinitions`,
+     *         or if the state format is invalid.
+     */
+    static fromState(state, pathDefinitions) {
+        if (state.version !== 1) {
+            throw new Error(`Unsupported SerializedPathState version: ${state.version}`);
+        }
+        const engine = new PathEngine();
+        // Restore the path stack (sub-paths)
+        for (const stackItem of state.pathStack) {
+            const definition = pathDefinitions[stackItem.pathId];
+            if (!definition) {
+                throw new Error(`Cannot restore state: path definition "${stackItem.pathId}" not found. ` +
+                    `Provide all path definitions that were active when state was exported.`);
+            }
+            engine.pathStack.push({
+                definition,
+                currentStepIndex: stackItem.currentStepIndex,
+                data: { ...stackItem.data },
+                visitedStepIds: new Set(stackItem.visitedStepIds),
+                subPathMeta: stackItem.subPathMeta ? { ...stackItem.subPathMeta } : undefined
+            });
+        }
+        // Restore the active path
+        const activeDefinition = pathDefinitions[state.pathId];
+        if (!activeDefinition) {
+            throw new Error(`Cannot restore state: active path definition "${state.pathId}" not found.`);
+        }
+        engine.activePath = {
+            definition: activeDefinition,
+            currentStepIndex: state.currentStepIndex,
+            data: { ...state.data },
+            visitedStepIds: new Set(state.visitedStepIds),
+            // Active path's subPathMeta is not serialized (it's transient metadata
+            // from the parent when this path was started). On restore, it's undefined.
+            subPathMeta: undefined
+        };
+        engine._isNavigating = state._isNavigating;
+        return engine;
+    }
     subscribe(listener) {
         this.listeners.add(listener);
         return () => this.listeners.delete(listener);
@@ -14,6 +65,25 @@ export class PathEngine {
         this.assertPathHasSteps(path);
         return this._startAsync(path, initialData);
     }
+    /**
+     * Tears down any active path (and the entire sub-path stack) without firing
+     * lifecycle hooks or emitting `cancelled`, then immediately starts the given
+     * path from scratch.
+     *
+     * Safe to call at any time — whether a path is running, already completed,
+     * or has never been started. Use this to implement a "Start over" button or
+     * to retry a path after completion without remounting the host component.
+     *
+     * @param path        The path definition to (re)start.
+     * @param initialData Data to seed the fresh path with. Defaults to `{}`.
+     */
+    restart(path, initialData = {}) {
+        this.assertPathHasSteps(path);
+        this._isNavigating = false;
+        this.activePath = null;
+        this.pathStack.length = 0;
+        return this._startAsync(path, initialData);
+    }
     /**
      * Starts a sub-path on top of the currently active path. Throws if no path
      * is running.
@@ -47,8 +117,10 @@ export class PathEngine {
             return Promise.resolve();
         const cancelledPathId = active.definition.id;
         const cancelledData = { ...active.data };
-        const cancelledMeta = active.subPathMeta;
         if (this.pathStack.length > 0) {
+            // Get meta from the parent in the stack
+            const parent = this.pathStack[this.pathStack.length - 1];
+            const cancelledMeta = parent.subPathMeta;
             return this._cancelSubPathAsync(cancelledPathId, cancelledData, cancelledMeta);
         }
         this.activePath = null;
@@ -125,6 +197,38 @@ export class PathEngine {
             data: { ...active.data }
         };
     }
+    /**
+     * Exports the current engine state as a plain JSON-serializable object.
+     * Use with storage adapters (e.g. `@daltonr/pathwrite-store-http`) to
+     * persist and restore wizard progress.
+     *
+     * Returns `null` if no path is active.
+     *
+     * **Important:** This only exports the _state_ (data, step position, etc.),
+     * not the path definition. When restoring, you must provide the same
+     * `PathDefinition` to `fromState()`.
+     */
+    exportState() {
+        if (this.activePath === null) {
+            return null;
+        }
+        const active = this.activePath;
+        return {
+            version: 1,
+            pathId: active.definition.id,
+            currentStepIndex: active.currentStepIndex,
+            data: { ...active.data },
+            visitedStepIds: Array.from(active.visitedStepIds),
+            pathStack: this.pathStack.map((p) => ({
+                pathId: p.definition.id,
+                currentStepIndex: p.currentStepIndex,
+                data: { ...p.data },
+                visitedStepIds: Array.from(p.visitedStepIds),
+                subPathMeta: p.subPathMeta ? { ...p.subPathMeta } : undefined
+            })),
+            _isNavigating: this._isNavigating
+        };
+    }
     // ---------------------------------------------------------------------------
     // Private async helpers
     // ---------------------------------------------------------------------------
@@ -132,14 +236,19 @@ export class PathEngine {
         if (this._isNavigating)
             return;
         if (this.activePath !== null) {
-            this.pathStack.push(this.activePath);
+            // Store the meta on the parent before pushing to stack
+            const parentWithMeta = {
+                ...this.activePath,
+                subPathMeta
+            };
+            this.pathStack.push(parentWithMeta);
         }
         this.activePath = {
             definition: path,
             currentStepIndex: 0,
             data: { ...initialData },
             visitedStepIds: new Set(),
-            subPathMeta
+            subPathMeta: undefined
         };
         this._isNavigating = true;
         await this.skipSteps(1);
@@ -297,10 +406,11 @@ export class PathEngine {
         const finished = this.requireActivePath();
         const finishedPathId = finished.definition.id;
         const finishedData = { ...finished.data };
-        const finishedMeta = finished.subPathMeta;
         if (this.pathStack.length > 0) {
-            this.activePath = this.pathStack.pop();
-            const parent = this.activePath;
+            const parent = this.pathStack.pop();
+            // The meta is stored on the parent, not the sub-path
+            const finishedMeta = parent.subPathMeta;
+            this.activePath = parent;
             const parentStep = this.getCurrentStep(parent);
             if (parentStep.onSubPathComplete) {
                 const ctx = {
@@ -433,6 +543,15 @@ export class PathEngine {
      * Evaluates a guard function synchronously for inclusion in the snapshot.
      * If the guard is absent, returns `true`.
      * If the guard returns a `Promise`, returns `true` (optimistic default).
+     *
+     * **Note:** Guards are evaluated on every snapshot, including the very first one
+     * emitted at the start of a path — _before_ `onEnter` has run on that step.
+     * This means `data` will still reflect the `initialData` passed to `start()`.
+     * Write guards defensively (e.g. `(data.name ?? "").trim().length > 0`) so they
+     * do not throw when optional fields are absent on first entry.
+     *
+     * If a guard throws, the error is caught, a `console.warn` is emitted, and the
+     * safe default (`true`) is returned so the UI remains operable.
      */
     evaluateGuardSync(guard, active) {
         if (!guard)
@@ -444,15 +563,37 @@ export class PathEngine {
             data: { ...active.data },
             isFirstEntry: !active.visitedStepIds.has(step.id)
         };
-        const result = guard(ctx);
-        if (typeof result === "boolean")
-            return result;
-        return true;
+        try {
+            const result = guard(ctx);
+            if (typeof result === "boolean")
+                return result;
+            // Async guard detected - warn and return optimistic default
+            if (result && typeof result.then === "function") {
+                console.warn(`[pathwrite] Async guard detected on step "${step.id}". ` +
+                    `Guards in snapshots must be synchronous. ` +
+                    `Returning true (optimistic) as default. ` +
+                    `The async guard will still be enforced during actual navigation.`);
+            }
+            return true;
+        }
+        catch (err) {
+            console.warn(`[pathwrite] Guard on step "${step.id}" threw an error during snapshot evaluation. ` +
+                `Returning true (allow navigation) as a safe default. ` +
+                `Note: guards are evaluated before onEnter runs on first entry — ` +
+                `ensure guards handle missing/undefined data gracefully.`, err);
+            return true;
+        }
     }
     /**
      * Evaluates a validationMessages function synchronously for inclusion in the snapshot.
      * If the hook is absent, returns `[]`.
      * If the hook returns a `Promise`, returns `[]` (async hooks are not supported in snapshots).
+     *
+     * **Note:** Like guards, `validationMessages` is evaluated before `onEnter` runs on first
+     * entry. Write it defensively so it does not throw when fields are absent.
+     *
+     * If the function throws, the error is caught, a `console.warn` is emitted, and `[]`
+     * is returned so validation messages do not block the UI unexpectedly.
      */
     evaluateValidationMessagesSync(fn, active) {
         if (!fn)
@@ -464,10 +605,26 @@ export class PathEngine {
             data: { ...active.data },
             isFirstEntry: !active.visitedStepIds.has(step.id)
         };
-        const result = fn(ctx);
-        if (Array.isArray(result))
-            return result;
-        return [];
+        try {
+            const result = fn(ctx);
+            if (Array.isArray(result))
+                return result;
+            // Async validationMessages detected - warn and return empty array
+            if (result && typeof result.then === "function") {
+                console.warn(`[pathwrite] Async validationMessages detected on step "${step.id}". ` +
+                    `validationMessages in snapshots must be synchronous. ` +
+                    `Returning [] as default. ` +
+                    `Use synchronous validation or move async checks to canMoveNext.`);
+            }
+            return [];
+        }
+        catch (err) {
+            console.warn(`[pathwrite] validationMessages on step "${step.id}" threw an error during snapshot evaluation. ` +
+                `Returning [] as a safe default. ` +
+                `Note: validationMessages is evaluated before onEnter runs on first entry — ` +
+                `ensure it handles missing/undefined data gracefully.`, err);
+            return [];
+        }
     }
 }
 //# sourceMappingURL=index.js.map

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-core",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "license": "MIT",
   "description": "Headless path engine — deterministic state machine with stack-based sub-path orchestration. Zero dependencies.",

package/src/index.ts

@@ -1,5 +1,22 @@
 export type PathData = Record<string, unknown>;
 
+export interface SerializedPathState {
+  version: 1;
+  pathId: string;
+  currentStepIndex: number;
+  data: PathData;
+  visitedStepIds: string[];
+  subPathMeta?: Record<string, unknown>;
+  pathStack: Array<{
+    pathId: string;
+    currentStepIndex: number;
+    data: PathData;
+    visitedStepIds: string[];
+    subPathMeta?: Record<string, unknown>;
+  }>;
+  _isNavigating: boolean;
+}
+
 export interface PathStepContext<TData extends PathData = PathData> {
   readonly pathId: string;
   readonly stepId: string;
@@ -121,6 +138,71 @@ export class PathEngine {
   private readonly listeners = new Set<(event: PathEvent) => void>();
   private _isNavigating = false;
 
+  /**
+   * Restores a PathEngine from previously exported state.
+   *
+   * **Important:** You must provide the same path definitions that were
+   * active when the state was exported. The path IDs in `state` are used
+   * to match against the provided definitions.
+   *
+   * @param state           The serialized state from `exportState()`.
+   * @param pathDefinitions A map of path ID → definition. Must include the
+   *                        active path and any paths in the stack.
+   * @returns A new PathEngine instance with the restored state.
+   * @throws If `state` references a path ID not present in `pathDefinitions`,
+   *         or if the state format is invalid.
+   */
+  public static fromState(
+    state: SerializedPathState,
+    pathDefinitions: Record<string, PathDefinition>
+  ): PathEngine {
+    if (state.version !== 1) {
+      throw new Error(`Unsupported SerializedPathState version: ${state.version}`);
+    }
+
+    const engine = new PathEngine();
+
+    // Restore the path stack (sub-paths)
+    for (const stackItem of state.pathStack) {
+      const definition = pathDefinitions[stackItem.pathId];
+      if (!definition) {
+        throw new Error(
+          `Cannot restore state: path definition "${stackItem.pathId}" not found. ` +
+          `Provide all path definitions that were active when state was exported.`
+        );
+      }
+      engine.pathStack.push({
+        definition,
+        currentStepIndex: stackItem.currentStepIndex,
+        data: { ...stackItem.data },
+        visitedStepIds: new Set(stackItem.visitedStepIds),
+        subPathMeta: stackItem.subPathMeta ? { ...stackItem.subPathMeta } : undefined
+      });
+    }
+
+    // Restore the active path
+    const activeDefinition = pathDefinitions[state.pathId];
+    if (!activeDefinition) {
+      throw new Error(
+        `Cannot restore state: active path definition "${state.pathId}" not found.`
+      );
+    }
+
+    engine.activePath = {
+      definition: activeDefinition,
+      currentStepIndex: state.currentStepIndex,
+      data: { ...state.data },
+      visitedStepIds: new Set(state.visitedStepIds),
+      // Active path's subPathMeta is not serialized (it's transient metadata
+      // from the parent when this path was started). On restore, it's undefined.
+      subPathMeta: undefined
+    };
+
+    engine._isNavigating = state._isNavigating;
+
+    return engine;
+  }
+
   public subscribe(listener: (event: PathEvent) => void): () => void {
     this.listeners.add(listener);
     return () => this.listeners.delete(listener);
@@ -135,6 +217,26 @@ export class PathEngine {
     return this._startAsync(path, initialData);
   }
 
+  /**
+   * Tears down any active path (and the entire sub-path stack) without firing
+   * lifecycle hooks or emitting `cancelled`, then immediately starts the given
+   * path from scratch.
+   *
+   * Safe to call at any time — whether a path is running, already completed,
+   * or has never been started. Use this to implement a "Start over" button or
+   * to retry a path after completion without remounting the host component.
+   *
+   * @param path        The path definition to (re)start.
+   * @param initialData Data to seed the fresh path with. Defaults to `{}`.
+   */
+  public restart(path: PathDefinition<any>, initialData: PathData = {}): Promise<void> {
+    this.assertPathHasSteps(path);
+    this._isNavigating = false;
+    this.activePath = null;
+    this.pathStack.length = 0;
+    return this._startAsync(path, initialData);
+  }
+
   /**
    * Starts a sub-path on top of the currently active path. Throws if no path
    * is running.
@@ -171,9 +273,11 @@ export class PathEngine {
 
     const cancelledPathId = active.definition.id;
     const cancelledData = { ...active.data };
-    const cancelledMeta = active.subPathMeta;
 
     if (this.pathStack.length > 0) {
+      // Get meta from the parent in the stack
+      const parent = this.pathStack[this.pathStack.length - 1];
+      const cancelledMeta = parent.subPathMeta;
       return this._cancelSubPathAsync(cancelledPathId, cancelledData, cancelledMeta);
     }
 
@@ -258,6 +362,41 @@ export class PathEngine {
     };
   }
 
+  /**
+   * Exports the current engine state as a plain JSON-serializable object.
+   * Use with storage adapters (e.g. `@daltonr/pathwrite-store-http`) to
+   * persist and restore wizard progress.
+   *
+   * Returns `null` if no path is active.
+   *
+   * **Important:** This only exports the _state_ (data, step position, etc.),
+   * not the path definition. When restoring, you must provide the same
+   * `PathDefinition` to `fromState()`.
+   */
+  public exportState(): SerializedPathState | null {
+    if (this.activePath === null) {
+      return null;
+    }
+
+    const active = this.activePath;
+
+    return {
+      version: 1,
+      pathId: active.definition.id,
+      currentStepIndex: active.currentStepIndex,
+      data: { ...active.data },
+      visitedStepIds: Array.from(active.visitedStepIds),
+      pathStack: this.pathStack.map((p) => ({
+        pathId: p.definition.id,
+        currentStepIndex: p.currentStepIndex,
+        data: { ...p.data },
+        visitedStepIds: Array.from(p.visitedStepIds),
+        subPathMeta: p.subPathMeta ? { ...p.subPathMeta } : undefined
+      })),
+      _isNavigating: this._isNavigating
+    };
+  }
+
   // ---------------------------------------------------------------------------
   // Private async helpers
   // ---------------------------------------------------------------------------
@@ -266,7 +405,12 @@ export class PathEngine {
     if (this._isNavigating) return;
 
     if (this.activePath !== null) {
-      this.pathStack.push(this.activePath);
+      // Store the meta on the parent before pushing to stack
+      const parentWithMeta: ActivePath = {
+        ...this.activePath,
+        subPathMeta
+      };
+      this.pathStack.push(parentWithMeta);
     }
 
     this.activePath = {
@@ -274,7 +418,7 @@ export class PathEngine {
       currentStepIndex: 0,
       data: { ...initialData },
       visitedStepIds: new Set(),
-      subPathMeta
+      subPathMeta: undefined
     };
 
     this._isNavigating = true;
@@ -463,11 +607,12 @@ export class PathEngine {
     const finished = this.requireActivePath();
     const finishedPathId = finished.definition.id;
     const finishedData = { ...finished.data };
-    const finishedMeta = finished.subPathMeta;
 
     if (this.pathStack.length > 0) {
-      this.activePath = this.pathStack.pop()!;
-      const parent = this.activePath;
+      const parent = this.pathStack.pop()!;
+      // The meta is stored on the parent, not the sub-path
+      const finishedMeta = parent.subPathMeta;
+      this.activePath = parent;
       const parentStep = this.getCurrentStep(parent);
 
       if (parentStep.onSubPathComplete) {
@@ -620,6 +765,15 @@ export class PathEngine {
    * Evaluates a guard function synchronously for inclusion in the snapshot.
    * If the guard is absent, returns `true`.
    * If the guard returns a `Promise`, returns `true` (optimistic default).
+   *
+   * **Note:** Guards are evaluated on every snapshot, including the very first one
+   * emitted at the start of a path — _before_ `onEnter` has run on that step.
+   * This means `data` will still reflect the `initialData` passed to `start()`.
+   * Write guards defensively (e.g. `(data.name ?? "").trim().length > 0`) so they
+   * do not throw when optional fields are absent on first entry.
+   *
+   * If a guard throws, the error is caught, a `console.warn` is emitted, and the
+   * safe default (`true`) is returned so the UI remains operable.
    */
   private evaluateGuardSync(
     guard: ((ctx: PathStepContext) => boolean | Promise<boolean>) | undefined,
@@ -633,15 +787,41 @@ export class PathEngine {
       data: { ...active.data },
       isFirstEntry: !active.visitedStepIds.has(step.id)
     };
-    const result = guard(ctx);
-    if (typeof result === "boolean") return result;
-    return true;
+    try {
+      const result = guard(ctx);
+      if (typeof result === "boolean") return result;
+      // Async guard detected - warn and return optimistic default
+      if (result && typeof result.then === "function") {
+        console.warn(
+          `[pathwrite] Async guard detected on step "${step.id}". ` +
+          `Guards in snapshots must be synchronous. ` +
+          `Returning true (optimistic) as default. ` +
+          `The async guard will still be enforced during actual navigation.`
+        );
+      }
+      return true;
+    } catch (err) {
+      console.warn(
+        `[pathwrite] Guard on step "${step.id}" threw an error during snapshot evaluation. ` +
+        `Returning true (allow navigation) as a safe default. ` +
+        `Note: guards are evaluated before onEnter runs on first entry — ` +
+        `ensure guards handle missing/undefined data gracefully.`,
+        err
+      );
+      return true;
+    }
   }
 
   /**
    * Evaluates a validationMessages function synchronously for inclusion in the snapshot.
    * If the hook is absent, returns `[]`.
    * If the hook returns a `Promise`, returns `[]` (async hooks are not supported in snapshots).
+   *
+   * **Note:** Like guards, `validationMessages` is evaluated before `onEnter` runs on first
+   * entry. Write it defensively so it does not throw when fields are absent.
+   *
+   * If the function throws, the error is caught, a `console.warn` is emitted, and `[]`
+   * is returned so validation messages do not block the UI unexpectedly.
    */
   private evaluateValidationMessagesSync(
     fn: ((ctx: PathStepContext) => string[] | Promise<string[]>) | undefined,
@@ -655,9 +835,29 @@ export class PathEngine {
       data: { ...active.data },
       isFirstEntry: !active.visitedStepIds.has(step.id)
     };
-    const result = fn(ctx);
-    if (Array.isArray(result)) return result;
-    return [];
+    try {
+      const result = fn(ctx);
+      if (Array.isArray(result)) return result;
+      // Async validationMessages detected - warn and return empty array
+      if (result && typeof result.then === "function") {
+        console.warn(
+          `[pathwrite] Async validationMessages detected on step "${step.id}". ` +
+          `validationMessages in snapshots must be synchronous. ` +
+          `Returning [] as default. ` +
+          `Use synchronous validation or move async checks to canMoveNext.`
+        );
+      }
+      return [];
+    } catch (err) {
+      console.warn(
+        `[pathwrite] validationMessages on step "${step.id}" threw an error during snapshot evaluation. ` +
+        `Returning [] as a safe default. ` +
+        `Note: validationMessages is evaluated before onEnter runs on first entry — ` +
+        `ensure it handles missing/undefined data gracefully.`,
+        err
+      );
+      return [];
+    }
   }
 }