@daltonr/pathwrite-angular 0.3.0 → 0.5.0

package/README.md

@@ -2,6 +2,32 @@
 
 Angular `@Injectable` facade over `@daltonr/pathwrite-core`. Exposes path state and events as RxJS observables that work seamlessly with Angular signals, the `async` pipe, and `takeUntilDestroyed`.
 
+## Installation
+
+```bash
+npm install @daltonr/pathwrite-core @daltonr/pathwrite-angular
+```
+
+## Exported Types
+
+For convenience, this package re-exports core types so you don't need to import from `@daltonr/pathwrite-core`:
+
+```typescript
+import { 
+  PathFacade,           // Angular-specific
+  PathEngine,           // Re-exported from core (value + type)
+  PathData,             // Re-exported from core
+  PathDefinition,       // Re-exported from core
+  PathEvent,            // Re-exported from core
+  PathSnapshot,         // Re-exported from core
+  PathStep,             // Re-exported from core
+  PathStepContext,      // Re-exported from core
+  SerializedPathState   // Re-exported from core
+} from "@daltonr/pathwrite-angular";
+```
+
+---
+
 ## Setup
 
 Provide `PathFacade` at the component level so each component gets its own isolated path instance, and Angular handles cleanup automatically via `ngOnDestroy`.
@@ -40,7 +66,9 @@ export class MyComponent {
 
 | Method | Description |
 |--------|-------------|
+| `adoptEngine(engine)` | Adopt an externally-managed `PathEngine` (e.g. from `restoreOrStart()`). The facade immediately reflects the engine's current state and forwards all subsequent events. The caller is responsible for the engine's lifecycle. |
 | `start(definition, data?)` | Start or re-start a path. |
+| `restart(definition, data?)` | Tear down any active path (without firing hooks) and start the given path fresh. Safe to call at any time. Use for "Start over" / retry flows. |
 | `startSubPath(definition, data?, meta?)` | Push a sub-path. Requires an active path. `meta` is returned unchanged to `onSubPathComplete` / `onSubPathCancel`. |
 | `next()` | Advance one step. Completes the path on the last step. |
 | `previous()` | Go back one step. No-op when already on the first step of a top-level path. |
@@ -273,9 +301,9 @@ export class MyComponent {
 | `path` | `PathDefinition` | *required* | The path definition to drive. |
 | `initialData` | `PathData` | `{}` | Initial data passed to `facade.start()`. |
 | `autoStart` | `boolean` | `true` | Start the path automatically on `ngOnInit`. |
-| `backLabel` | `string` | `"Back"` | Back button label. |
+| `backLabel` | `string` | `"Previous"` | Previous button label. |
 | `nextLabel` | `string` | `"Next"` | Next button label. |
-| `finishLabel` | `string` | `"Finish"` | Finish button label (last step). |
+| `completeLabel` | `string` | `"Complete"` | Complete button label (last step). |
 | `cancelLabel` | `string` | `"Cancel"` | Cancel button label. |
 | `hideCancel` | `boolean` | `false` | Hide the Cancel button. |
 | `hideProgress` | `boolean` | `false` | Hide the progress indicator. |
@@ -320,7 +348,7 @@ export class MyComponent { ... }
       <ng-template pwShellFooter let-s let-actions="actions">
         <button (click)="actions.previous()" [disabled]="s.isFirstStep || s.isNavigating">Back</button>
         <button (click)="actions.next()"     [disabled]="!s.canMoveNext || s.isNavigating">
-          {{ s.isLastStep ? 'Finish' : 'Next' }}
+          {{ s.isLastStep ? 'Complete' : 'Next' }}
         </button>
       </ng-template>
       <ng-template pwStep="details"><app-details-form /></ng-template>
@@ -330,12 +358,357 @@ export class MyComponent { ... }
 export class MyComponent { ... }
 ```
 
-`actions` (`PathShellActions`) contains: `next`, `previous`, `cancel`, `goToStep`, `goToStepChecked`, `setData`. All return `Promise<void>`.
+`actions` (`PathShellActions`) contains: `next`, `previous`, `cancel`, `goToStep`, `goToStepChecked`, `setData`, `restart`. All return `Promise<void>`.
+
+`restart()` restarts the shell's own `[path]` input with its own `[initialData]` input — useful for a "Start over" button in a custom footer.
 
 Both directives can be combined. Only the sections you override are replaced — a custom header still shows the default footer, and vice versa.
 
 ---
 
+## Sub-Paths
+
+Sub-paths allow you to nest multi-step workflows. Common use cases include:
+- Running a child workflow per collection item (e.g., approve each document)
+- Conditional drill-down flows (e.g., "Add payment method" modal)
+- Reusable wizard components
+
+### Basic Sub-Path Flow
+
+When a sub-path is active:
+- The shell switches to show the sub-path's steps
+- The progress bar displays sub-path steps (not main path steps)
+- Pressing Back on the first sub-path step **cancels** the sub-path and returns to the parent
+- The `PathFacade` (and thus `state$`, `stateSignal`) reflects the **sub-path** snapshot, not the parent's
+
+### Complete Example: Approver Collection
+
+```typescript
+import { PathData, PathDefinition, PathFacade } from "@daltonr/pathwrite-angular";
+
+// Sub-path data shape
+interface ApproverReviewData extends PathData {
+  decision: "approve" | "reject" | "";
+  comments: string;
+}
+
+// Main path data shape
+interface ApprovalWorkflowData extends PathData {
+  documentTitle: string;
+  approvers: string[];
+  approvals: Array<{ approver: string; decision: string; comments: string }>;
+}
+
+// Define the sub-path (approver review wizard)
+const approverReviewPath: PathDefinition<ApproverReviewData> = {
+  id: "approver-review",
+  steps: [
+    { id: "review", title: "Review Document" },
+    {
+      id: "decision",
+      title: "Make Decision",
+      canMoveNext: ({ data }) =>
+        data.decision === "approve" || data.decision === "reject",
+      validationMessages: ({ data }) =>
+        !data.decision ? ["Please select Approve or Reject"] : []
+    },
+    { id: "comments", title: "Add Comments" }
+  ]
+};
+
+// Define the main path
+const approvalWorkflowPath: PathDefinition<ApprovalWorkflowData> = {
+  id: "approval-workflow",
+  steps: [
+    {
+      id: "setup",
+      title: "Setup Approval",
+      canMoveNext: ({ data }) =>
+        (data.documentTitle ?? "").trim().length > 0 &&
+        data.approvers.length > 0
+    },
+    {
+      id: "run-approvals",
+      title: "Collect Approvals",
+      // Block "Next" until all approvers have completed their reviews
+      canMoveNext: ({ data }) =>
+        data.approvals.length === data.approvers.length,
+      validationMessages: ({ data }) => {
+        const remaining = data.approvers.length - data.approvals.length;
+        return remaining > 0
+          ? [`${remaining} approver(s) pending review`]
+          : [];
+      },
+      // When an approver finishes their sub-path, record the result
+      onSubPathComplete(subPathId, subPathData, ctx, meta) {
+        const approverName = meta?.approverName as string;
+        const result = subPathData as ApproverReviewData;
+        return {
+          approvals: [
+            ...ctx.data.approvals,
+            {
+              approver: approverName,
+              decision: result.decision,
+              comments: result.comments
+            }
+          ]
+        };
+      },
+      // If an approver cancels (presses Back on first step), you can track it
+      onSubPathCancel(subPathId, subPathData, ctx, meta) {
+        console.log(`${meta?.approverName} cancelled their review`);
+        // Optionally return data changes, or just log
+      }
+    },
+    { id: "summary", title: "Summary" }
+  ]
+};
+
+// Component
+@Component({
+  selector: 'app-approval-workflow',
+  standalone: true,
+  imports: [PathShellComponent, PathStepDirective],
+  providers: [PathFacade],
+  template: `
+    <pw-shell [path]="approvalWorkflowPath" [initialData]="initialData">
+      <!-- Main path steps -->
+      <ng-template pwStep="setup">
+        <input [(ngModel)]="facade.snapshot()!.data.documentTitle" placeholder="Document title" />
+        <!-- approver selection UI here -->
+      </ng-template>
+
+      <ng-template pwStep="run-approvals">
+        <h3>Approvers</h3>
+        <ul>
+          @for (approver of facade.snapshot()!.data.approvers; track $index) {
+            <li>
+              {{ approver }}
+              @if (!hasApproval(approver)) {
+                <button (click)="launchReviewForApprover(approver, $index)">
+                  Start Review
+                </button>
+              } @else {
+                <span>✓ {{ getApproval(approver)?.decision }}</span>
+              }
+            </li>
+          }
+        </ul>
+      </ng-template>
+
+      <ng-template pwStep="summary">
+        <h3>All Approvals Collected</h3>
+        <ul>
+          @for (approval of facade.snapshot()!.data.approvals; track approval.approver) {
+            <li>{{ approval.approver }}: {{ approval.decision }}</li>
+          }
+        </ul>
+      </ng-template>
+
+      <!-- Sub-path steps (must be co-located in the same pw-shell) -->
+      <ng-template pwStep="review">
+        <p>Review the document: "{{ facade.snapshot()!.data.documentTitle }}"</p>
+      </ng-template>
+
+      <ng-template pwStep="decision">
+        <label><input type="radio" value="approve" [(ngModel)]="facade.snapshot()!.data.decision" /> Approve</label>
+        <label><input type="radio" value="reject" [(ngModel)]="facade.snapshot()!.data.decision" /> Reject</label>
+      </ng-template>
+
+      <ng-template pwStep="comments">
+        <textarea [(ngModel)]="facade.snapshot()!.data.comments" placeholder="Optional comments"></textarea>
+      </ng-template>
+    </pw-shell>
+  `
+})
+export class ApprovalWorkflowComponent {
+  protected readonly facade = inject(PathFacade) as PathFacade<ApprovalWorkflowData>;
+  protected readonly approvalWorkflowPath = approvalWorkflowPath;
+  protected readonly initialData = { documentTitle: '', approvers: [], approvals: [] };
+
+  protected launchReviewForApprover(approverName: string, index: number): void {
+    // Pass correlation data via `meta` — it's echoed back to onSubPathComplete
+    void this.facade.startSubPath(
+      approverReviewPath,
+      { decision: "", comments: "" },
+      { approverName, approverIndex: index }
+    );
+  }
+
+  protected hasApproval(approver: string): boolean {
+    return this.facade.snapshot()!.data.approvals.some(a => a.approver === approver);
+  }
+
+  protected getApproval(approver: string) {
+    return this.facade.snapshot()!.data.approvals.find(a => a.approver === approver);
+  }
+}
+```
+
+### Key Notes
+
+**1. Sub-path steps must be co-located with main path steps**  
+All `pwStep` templates (main path + sub-path steps) live in the same `<pw-shell>`. When a sub-path is active, the shell renders the sub-path's step templates. This means:
+- Parent and sub-path step IDs **must not collide** (e.g., don't use `summary` in both)
+- The shell matches step IDs from the current path only (main or sub), but all templates are registered globally
+
+**2. The `meta` correlation field**  
+`startSubPath` accepts an optional third argument (`meta`) that is returned unchanged to `onSubPathComplete` and `onSubPathCancel`. Use it to correlate which collection item triggered the sub-path:
+
+```typescript
+facade.startSubPath(subPath, initialData, { itemIndex: 3, itemId: "abc" });
+
+// In the parent step:
+onSubPathComplete(subPathId, subPathData, ctx, meta) {
+  const itemIndex = meta?.itemIndex; // 3
+}
+```
+
+**3. Progress bar switches during sub-paths**  
+When `snapshot.nestingLevel > 0`, you're in a sub-path. The `steps` array in the snapshot contains the sub-path's steps, not the main path's. The default PathShell progress bar shows sub-path progress. You can check `nestingLevel` to show a breadcrumb or "back to main flow" indicator.
+
+**4. Accessing parent path data from sub-path components**  
+There is currently no way to inject a "parent facade" in sub-path step components. If a sub-path step needs parent data (e.g., the document title), pass it via `initialData` when calling `startSubPath`:
+
+```typescript
+facade.startSubPath(approverReviewPath, {
+  decision: "",
+  comments: "",
+  documentTitle: facade.snapshot()!.data.documentTitle // copy from parent
+});
+```
+
+---
+
+## Guards and Lifecycle Hooks
+
+### Defensive Guards (Important!)
+
+**Guards and `validationMessages` are evaluated *before* `onEnter` runs on first entry.**
+
+If you access fields in a guard that `onEnter` is supposed to initialize, the guard will throw a `TypeError` on startup. Write guards defensively using nullish coalescing:
+
+```typescript
+// ✗ Unsafe — crashes if data.name is undefined
+canMoveNext: ({ data }) => data.name.trim().length > 0
+
+// ✓ Safe — handles undefined gracefully
+canMoveNext: ({ data }) => (data.name ?? "").trim().length > 0
+```
+
+Alternatively, pass `initialData` to `start()` / `<pw-shell>` so all fields are present from the first snapshot:
+
+```typescript
+<pw-shell [path]="myPath" [initialData]="{ name: '', age: 0 }" />
+```
+
+If a guard throws, the engine catches it, logs a warning, and returns `true` (allow navigation) as a safe default.
+
+### Async Guards and Validation Messages
+
+Guards and `validationMessages` must be **synchronous** for inclusion in snapshots. Async functions are detected and warned about:
+- Async `canMoveNext` / `canMovePrevious` default to `true` (optimistic)
+- Async `validationMessages` default to `[]`
+
+The async version is still enforced during actual navigation (when you call `next()` / `previous()`), but the snapshot won't reflect the pending state. If you need async validation, perform it in the guard and store the result in `data` so the guard can read it synchronously.
+
+### `isFirstEntry` Flag
+
+The `PathStepContext` passed to all hooks includes an `isFirstEntry: boolean` flag. It's `true` the first time a step is visited, `false` on re-entry (e.g., after navigating back then forward again).
+
+Use it to distinguish initialization from re-entry:
+
+```typescript
+{
+  id: "details",
+  onEnter: ({ isFirstEntry, data }) => {
+    if (isFirstEntry) {
+      // Only pre-fill on first visit, not when returning via Back
+      return { name: "Default Name" };
+    }
+  }
+}
+```
+
+**Important:** `onEnter` fires every time you enter the step. If you want "initialize once" behavior, either:
+1. Use `isFirstEntry` to conditionally return data
+2. Provide `initialData` to `start()` instead of using `onEnter`
+
+---
+
+## Persistence
+
+Use with [@daltonr/pathwrite-store-http](../store-http) for automatic state persistence. The engine is created externally via `restoreOrStart()`, then handed to the facade via `adoptEngine()`.
+
+### Simple persistence example
+
+```typescript
+import { Component, inject, OnInit } from '@angular/core';
+import { PathFacade, PathShellComponent, PathStepDirective } from '@daltonr/pathwrite-angular';
+import { HttpStore, restoreOrStart, httpPersistence } from '@daltonr/pathwrite-store-http';
+import { signupPath } from './signup-path';
+
+@Component({
+  selector: 'app-signup-wizard',
+  standalone: true,
+  imports: [PathShellComponent, PathStepDirective],
+  providers: [PathFacade],
+  template: `
+    @if (ready) {
+      <pw-shell [path]="path" [autoStart]="false" (completed)="onComplete($event)">
+        <ng-template pwStep="details"><app-details-form /></ng-template>
+        <ng-template pwStep="review"><app-review-panel /></ng-template>
+      </pw-shell>
+    } @else {
+      <p>Loading…</p>
+    }
+  `
+})
+export class SignupWizardComponent implements OnInit {
+  private readonly facade = inject(PathFacade);
+
+  path = signupPath;
+  ready = false;
+
+  async ngOnInit() {
+    const store = new HttpStore({ baseUrl: '/api/wizard' });
+    const key = 'user:signup';
+
+    const { engine, restored } = await restoreOrStart({
+      store,
+      key,
+      path: this.path,
+      initialData: { name: '', email: '' },
+      observers: [
+        httpPersistence({ store, key, strategy: 'onNext' })
+      ]
+    });
+
+    // Hand the running engine to the facade — it immediately
+    // reflects the engine's current state and forwards all events.
+    this.facade.adoptEngine(engine);
+    this.ready = true;
+
+    if (restored) {
+      console.log('Progress restored — resuming from', engine.snapshot()?.stepId);
+    }
+  }
+
+  onComplete(data: any) {
+    console.log('Wizard completed:', data);
+  }
+}
+```
+
+### Key points
+
+- **`adoptEngine()`** connects the facade to an externally-created engine. No `@ViewChild` or shell reference needed — inject `PathFacade` directly.
+- **`[autoStart]="false"`** prevents the shell from calling `start()` on its own — the engine is already running.
+- **The facade is the same one the shell uses** (provided in the component's `providers`), so the shell's template bindings, progress indicator, and navigation buttons all work automatically.
+- **`restoreOrStart()`** handles the load-or-create logic: if saved state exists on the server, it restores the engine mid-flow; otherwise it starts fresh.
+
+---
+
 ## Styling
 
 Import the optional stylesheet for sensible default styles. All visual values are CSS custom properties (`--pw-*`) so you can theme without overriding selectors.
@@ -365,3 +738,36 @@ Override any `--pw-*` variable to customise the appearance:
   --pw-shell-radius: 12px;
 }
 ```
+
+### Available CSS Custom Properties
+
+**Layout:**
+- `--pw-shell-max-width` — Maximum width of the shell (default: `720px`)
+- `--pw-shell-padding` — Internal padding (default: `24px`)
+- `--pw-shell-gap` — Gap between header, body, footer (default: `20px`)
+- `--pw-shell-radius` — Border radius for cards (default: `10px`)
+
+**Colors:**
+- `--pw-color-bg` — Background color (default: `#ffffff`)
+- `--pw-color-border` — Border color (default: `#dbe4f0`)
+- `--pw-color-text` — Primary text color (default: `#1f2937`)
+- `--pw-color-muted` — Muted text color (default: `#5b677a`)
+- `--pw-color-primary` — Primary/accent color (default: `#2563eb`)
+- `--pw-color-primary-light` — Light primary for backgrounds (default: `rgba(37, 99, 235, 0.12)`)
+- `--pw-color-btn-bg` — Button background (default: `#f8fbff`)
+- `--pw-color-btn-border` — Button border (default: `#c2d0e5`)
+
+**Validation:**
+- `--pw-color-error` — Error text color (default: `#dc2626`)
+- `--pw-color-error-bg` — Error background (default: `#fef2f2`)
+- `--pw-color-error-border` — Error border (default: `#fecaca`)
+
+**Progress Indicator:**
+- `--pw-dot-size` — Step dot size (default: `32px`)
+- `--pw-dot-font-size` — Font size inside dots (default: `13px`)
+- `--pw-track-height` — Progress track height (default: `4px`)
+
+**Buttons:**
+- `--pw-btn-padding` — Button padding (default: `8px 16px`)
+- `--pw-btn-radius` — Button border radius (default: `6px`)
+

package/dist/index.css

@@ -250,6 +250,16 @@
   border-color: #1d4ed8;
 }
 
+.pw-shell__btn--back {
+  background: transparent;
+  border-color: var(--pw-color-primary);
+  color: var(--pw-color-primary);
+}
+
+.pw-shell__btn--back:hover:not(:disabled) {
+  background: var(--pw-color-primary-light);
+}
+
 .pw-shell__btn--cancel {
   color: var(--pw-color-muted);
   border-color: transparent;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { OnDestroy, DestroyRef, Signal } from "@angular/core";
 import { Observable } from "rxjs";
-import { PathData, PathDefinition, PathEvent, PathSnapshot } from "@daltonr/pathwrite-core";
+import { PathData, PathDefinition, PathEngine, PathEvent, PathSnapshot } from "@daltonr/pathwrite-core";
 import * as i0 from "@angular/core";
 /**
  * Angular facade over PathEngine. Provide at component level for an isolated
@@ -17,18 +17,40 @@ import * as i0 from "@angular/core";
  * ```
  */
 export declare class PathFacade<TData extends PathData = PathData> implements OnDestroy {
-    private readonly engine;
+    private _engine;
     private readonly _state$;
     private readonly _events$;
-    private readonly unsubscribeFromEngine;
+    private _unsubscribeFromEngine;
     private readonly _stateSignal;
     readonly state$: Observable<PathSnapshot<TData> | null>;
     readonly events$: Observable<PathEvent>;
     /** Signal version of state$. Updates on every path state change. Requires Angular 16+. */
     readonly stateSignal: Signal<PathSnapshot<TData> | null>;
     constructor();
+    /**
+     * Adopt an externally-managed `PathEngine` — for example, the engine returned
+     * by `restoreOrStart()` from `@daltonr/pathwrite-store-http`.
+     *
+     * The facade immediately reflects the engine's current state and forwards all
+     * subsequent events. The **caller** is responsible for the engine's lifecycle
+     * (starting, cleanup); the facade only subscribes to it.
+     *
+     * ```typescript
+     * const { engine } = await restoreOrStart({ store, key, path, initialData, observers: [...] });
+     * facade.adoptEngine(engine);
+     * ```
+     */
+    adoptEngine(engine: PathEngine): void;
+    private connectEngine;
     ngOnDestroy(): void;
     start(path: PathDefinition<any>, initialData?: PathData): Promise<void>;
+    /**
+     * Tears down any active path (without firing lifecycle hooks) and immediately
+     * starts the given path fresh. Safe to call whether or not a path is running.
+     * Use for "Start over" / retry flows without destroying and re-creating the
+     * component that provides this facade.
+     */
+    restart(path: PathDefinition<any>, initialData?: PathData): Promise<void>;
     startSubPath(path: PathDefinition<any>, initialData?: PathData, meta?: Record<string, unknown>): Promise<void>;
     next(): Promise<void>;
     previous(): Promise<void>;
@@ -84,3 +106,5 @@ export interface FormGroupLike {
  * ```
  */
 export declare function syncFormGroup<TData extends PathData = PathData>(facade: PathFacade<TData>, formGroup: FormGroupLike, destroyRef?: DestroyRef): () => void;
+export type { PathData, PathDefinition, PathEvent, PathSnapshot, PathStep, PathStepContext, SerializedPathState } from "@daltonr/pathwrite-core";
+export { PathEngine } from "@daltonr/pathwrite-core";

package/dist/index.js

@@ -18,15 +18,43 @@ import * as i0 from "@angular/core";
  */
 export class PathFacade {
     constructor() {
-        this.engine = new PathEngine();
+        this._engine = new PathEngine();
         this._state$ = new BehaviorSubject(null);
         this._events$ = new Subject();
+        this._unsubscribeFromEngine = () => { };
         this._stateSignal = signal(null);
         this.state$ = this._state$.asObservable();
         this.events$ = this._events$.asObservable();
         /** Signal version of state$. Updates on every path state change. Requires Angular 16+. */
         this.stateSignal = this._stateSignal.asReadonly();
-        this.unsubscribeFromEngine = this.engine.subscribe((event) => {
+        this.connectEngine(this._engine);
+    }
+    /**
+     * Adopt an externally-managed `PathEngine` — for example, the engine returned
+     * by `restoreOrStart()` from `@daltonr/pathwrite-store-http`.
+     *
+     * The facade immediately reflects the engine's current state and forwards all
+     * subsequent events. The **caller** is responsible for the engine's lifecycle
+     * (starting, cleanup); the facade only subscribes to it.
+     *
+     * ```typescript
+     * const { engine } = await restoreOrStart({ store, key, path, initialData, observers: [...] });
+     * facade.adoptEngine(engine);
+     * ```
+     */
+    adoptEngine(engine) {
+        // Disconnect from whatever engine we're currently listening to
+        this._unsubscribeFromEngine();
+        this._engine = engine;
+        this.connectEngine(engine);
+    }
+    connectEngine(engine) {
+        // Seed state immediately — critical when restoring a persisted path since
+        // the engine is already running before the facade connects to it.
+        const current = engine.snapshot();
+        this._state$.next(current);
+        this._stateSignal.set(current);
+        this._unsubscribeFromEngine = engine.subscribe((event) => {
             this._events$.next(event);
             if (event.type === "stateChanged" || event.type === "resumed") {
                 this._state$.next(event.snapshot);
@@ -39,36 +67,45 @@ export class PathFacade {
         });
     }
     ngOnDestroy() {
-        this.unsubscribeFromEngine();
+        this._unsubscribeFromEngine();
         this._events$.complete();
         this._state$.complete();
     }
     start(path, initialData = {}) {
-        return this.engine.start(path, initialData);
+        return this._engine.start(path, initialData);
+    }
+    /**
+     * Tears down any active path (without firing lifecycle hooks) and immediately
+     * starts the given path fresh. Safe to call whether or not a path is running.
+     * Use for "Start over" / retry flows without destroying and re-creating the
+     * component that provides this facade.
+     */
+    restart(path, initialData = {}) {
+        return this._engine.restart(path, initialData);
     }
     startSubPath(path, initialData = {}, meta) {
-        return this.engine.startSubPath(path, initialData, meta);
+        return this._engine.startSubPath(path, initialData, meta);
     }
     next() {
-        return this.engine.next();
+        return this._engine.next();
     }
     previous() {
-        return this.engine.previous();
+        return this._engine.previous();
     }
     cancel() {
-        return this.engine.cancel();
+        return this._engine.cancel();
     }
     setData(key, value) {
-        return this.engine.setData(key, value);
+        return this._engine.setData(key, value);
     }
     goToStep(stepId) {
-        return this.engine.goToStep(stepId);
+        return this._engine.goToStep(stepId);
     }
     /** Jump to a step by ID, checking the current step's canMoveNext (forward) or
      *  canMovePrevious (backward) guard first. Navigation is blocked if the guard
      *  returns false. Throws if the step ID does not exist. */
     goToStepChecked(stepId) {
-        return this.engine.goToStepChecked(stepId);
+        return this._engine.goToStepChecked(stepId);
     }
     snapshot() {
         return this._state$.getValue();
@@ -122,4 +159,5 @@ export function syncFormGroup(facade, formGroup, destroyRef) {
     destroyRef?.onDestroy(cleanup);
     return cleanup;
 }
+export { PathEngine } from "@daltonr/pathwrite-core";
 //# 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":"AAAA,OAAO,EAAE,UAAU,EAAyB,MAAM,EAAU,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,eAAe,EAAc,OAAO,EAAE,MAAM,MAAM,CAAC;AAC5D,OAAO,EAGL,UAAU,EAGX,MAAM,yBAAyB,CAAC;;AAEjC;;;;;;;;;;;;;GAaG;AAEH,MAAM,OAAO,UAAU;IAYrB;QAXQ,YAAO,GAAG,IAAI,UAAU,EAAE,CAAC;QAClB,YAAO,GAAG,IAAI,eAAe,CAA6B,IAAI,CAAC,CAAC;QAChE,aAAQ,GAAG,IAAI,OAAO,EAAa,CAAC;QAC7C,2BAAsB,GAAe,GAAG,EAAE,GAAE,CAAC,CAAC;QACrC,iBAAY,GAAG,MAAM,CAA6B,IAAI,CAAC,CAAC;QAEzD,WAAM,GAA2C,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAC7E,YAAO,GAA0B,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;QAC9E,0FAA0F;QAC1E,gBAAW,GAAuC,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC;QAG/F,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,WAAW,CAAC,MAAkB;QACnC,+DAA+D;QAC/D,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAEO,aAAa,CAAC,MAAkB;QACtC,0EAA0E;QAC1E,kEAAkE;QAClE,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAgC,CAAC;QAChE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAE/B,IAAI,CAAC,sBAAsB,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;YACvD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC9D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAA+B,CAAC,CAAC;gBACzD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,QAA+B,CAAC,CAAC;YAC/D,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACpE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,WAAW;QAChB,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,IAAyB,EAAE,cAAwB,EAAE;QAChE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACI,OAAO,CAAC,IAAyB,EAAE,cAAwB,EAAE;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;IAEM,YAAY,CAAC,IAAyB,EAAE,cAAwB,EAAE,EAAE,IAA8B;QACvG,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;IAEM,IAAI;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAEM,QAAQ;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;IAEM,MAAM;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;IAC/B,CAAC;IAEM,OAAO,CAAiC,GAAM,EAAE,KAAe;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,KAAgB,CAAC,CAAC;IACrD,CAAC;IAEM,QAAQ,CAAC,MAAc;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED;;+DAE2D;IACpD,eAAe,CAAC,MAAc;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAEM,QAAQ;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;+GA5GU,UAAU;mHAAV,UAAU;;4FAAV,UAAU;kBADtB,UAAU;;AAkIX;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAyB,EACzB,SAAwB,EACxB,UAAuB;IAEvB,MAAM,UAAU,GAAG,MAA8B,CAAC;IAElD,SAAS,WAAW;QAClB,IAAI,UAAU,CAAC,QAAQ,EAAE,KAAK,IAAI;YAAE,OAAO,CAAC,mCAAmC;QAC/E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YACnE,KAAK,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,WAAW,EAAE,CAAC;IAEd,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAE3E,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IACjD,UAAU,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/B,OAAO,OAAO,CAAC;AACjB,CAAC;AAaD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/shell.d.ts

@@ -14,6 +14,8 @@ export interface PathShellActions {
     goToStep: (stepId: string) => Promise<void>;
     goToStepChecked: (stepId: string) => Promise<void>;
     setData: (key: string, value: unknown) => Promise<void>;
+    /** Restart the shell's current path with its current `initialData`. */
+    restart: () => Promise<void>;
 }
 /**
  * Structural directive that associates a template with a step ID.
@@ -106,7 +108,7 @@ export declare class PathShellComponent implements OnInit, OnDestroy {
     /** Label for the Next navigation button. */
     nextLabel: string;
     /** Label for the Next button when on the last step. */
-    finishLabel: string;
+    completeLabel: string;
     /** Label for the Cancel button. */
     cancelLabel: string;
     /** Hide the Cancel button entirely. */
@@ -131,5 +133,5 @@ export declare class PathShellComponent implements OnInit, OnDestroy {
     ngOnDestroy(): void;
     doStart(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PathShellComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PathShellComponent, "pw-shell", never, { "path": { "alias": "path"; "required": true; }; "initialData": { "alias": "initialData"; "required": false; }; "autoStart": { "alias": "autoStart"; "required": false; }; "backLabel": { "alias": "backLabel"; "required": false; }; "nextLabel": { "alias": "nextLabel"; "required": false; }; "finishLabel": { "alias": "finishLabel"; "required": false; }; "cancelLabel": { "alias": "cancelLabel"; "required": false; }; "hideCancel": { "alias": "hideCancel"; "required": false; }; "hideProgress": { "alias": "hideProgress"; "required": false; }; }, { "completed": "completed"; "cancelled": "cancelled"; "pathEvent": "pathEvent"; }, ["customHeader", "customFooter", "stepDirectives"], never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PathShellComponent, "pw-shell", never, { "path": { "alias": "path"; "required": true; }; "initialData": { "alias": "initialData"; "required": false; }; "autoStart": { "alias": "autoStart"; "required": false; }; "backLabel": { "alias": "backLabel"; "required": false; }; "nextLabel": { "alias": "nextLabel"; "required": false; }; "completeLabel": { "alias": "completeLabel"; "required": false; }; "cancelLabel": { "alias": "cancelLabel"; "required": false; }; "hideCancel": { "alias": "hideCancel"; "required": false; }; "hideProgress": { "alias": "hideProgress"; "required": false; }; }, { "completed": "completed"; "cancelled": "cancelled"; "pathEvent": "pathEvent"; }, ["customHeader", "customFooter", "stepDirectives"], never, true, never>;
 }

package/dist/shell.js

@@ -110,11 +110,11 @@ export class PathShellComponent {
         /** Start the path automatically on ngOnInit. Set to false to call doStart() manually. */
         this.autoStart = true;
         /** Label for the Back navigation button. */
-        this.backLabel = "Back";
+        this.backLabel = "Previous";
         /** Label for the Next navigation button. */
         this.nextLabel = "Next";
         /** Label for the Next button when on the last step. */
-        this.finishLabel = "Finish";
+        this.completeLabel = "Complete";
         /** Label for the Cancel button. */
         this.cancelLabel = "Cancel";
         /** Hide the Cancel button entirely. */
@@ -137,6 +137,7 @@ export class PathShellComponent {
             goToStep: (id) => this.facade.goToStep(id),
             goToStepChecked: (id) => this.facade.goToStepChecked(id),
             setData: (key, value) => this.facade.setData(key, value),
+            restart: () => this.facade.restart(this.path, this.initialData),
         };
         this.destroy$ = new Subject();
     }
@@ -161,7 +162,7 @@ export class PathShellComponent {
         this.facade.start(this.path, this.initialData);
     }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "17.3.12", ngImport: i0, type: PathShellComponent, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "17.3.12", type: PathShellComponent, isStandalone: true, selector: "pw-shell", inputs: { path: "path", initialData: "initialData", autoStart: "autoStart", backLabel: "backLabel", nextLabel: "nextLabel", finishLabel: "finishLabel", cancelLabel: "cancelLabel", hideCancel: "hideCancel", hideProgress: "hideProgress" }, outputs: { completed: "completed", cancelled: "cancelled", pathEvent: "pathEvent" }, providers: [PathFacade], queries: [{ propertyName: "customHeader", first: true, predicate: PathShellHeaderDirective, descendants: true }, { propertyName: "customFooter", first: true, predicate: PathShellFooterDirective, descendants: true }, { propertyName: "stepDirectives", predicate: PathStepDirective }], ngImport: i0, template: `
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "17.3.12", type: PathShellComponent, isStandalone: true, selector: "pw-shell", inputs: { path: "path", initialData: "initialData", autoStart: "autoStart", backLabel: "backLabel", nextLabel: "nextLabel", completeLabel: "completeLabel", cancelLabel: "cancelLabel", hideCancel: "hideCancel", hideProgress: "hideProgress" }, outputs: { completed: "completed", cancelled: "cancelled", pathEvent: "pathEvent" }, providers: [PathFacade], queries: [{ propertyName: "customHeader", first: true, predicate: PathShellHeaderDirective, descendants: true }, { propertyName: "customFooter", first: true, predicate: PathShellFooterDirective, descendants: true }, { propertyName: "stepDirectives", predicate: PathStepDirective }], ngImport: i0, template: `
     <!-- Empty state -->
     <div class="pw-shell" *ngIf="!(facade.state$ | async)">
       <div class="pw-shell__empty" *ngIf="!started">
@@ -236,7 +237,7 @@ export class PathShellComponent {
               class="pw-shell__btn pw-shell__btn--next"
               [disabled]="s.isNavigating || !s.canMoveNext"
               (click)="facade.next()"
-            >{{ s.isLastStep ? finishLabel : nextLabel }}</button>
+            >{{ s.isLastStep ? completeLabel : nextLabel }}</button>
           </div>
         </div>
       </ng-template>
@@ -326,7 +327,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "17.3.12", ngImpo
               class="pw-shell__btn pw-shell__btn--next"
               [disabled]="s.isNavigating || !s.canMoveNext"
               (click)="facade.next()"
-            >{{ s.isLastStep ? finishLabel : nextLabel }}</button>
+            >{{ s.isLastStep ? completeLabel : nextLabel }}</button>
           </div>
         </div>
       </ng-template>
@@ -344,7 +345,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "17.3.12", ngImpo
                 type: Input
             }], nextLabel: [{
                 type: Input
-            }], finishLabel: [{
+            }], completeLabel: [{
                 type: Input
             }], cancelLabel: [{
                 type: Input

package/dist/shell.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daltonr/pathwrite-angular",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "type": "module",
   "license": "MIT",
   "description": "Angular adapter for @daltonr/pathwrite-core — RxJS observables, signal-friendly, with optional <pw-shell> default UI.",
@@ -60,7 +60,7 @@
     "@angular/compiler-cli": "^17.0.0"
   },
   "dependencies": {
-    "@daltonr/pathwrite-core": "^0.3.0"
+    "@daltonr/pathwrite-core": "^0.5.0"
   },
   "publishConfig": {
     "access": "public"

package/src/index.ts

@@ -24,10 +24,10 @@ import {
  */
 @Injectable()
 export class PathFacade<TData extends PathData = PathData> implements OnDestroy {
-  private readonly engine = new PathEngine();
+  private _engine = new PathEngine();
   private readonly _state$ = new BehaviorSubject<PathSnapshot<TData> | null>(null);
   private readonly _events$ = new Subject<PathEvent>();
-  private readonly unsubscribeFromEngine: () => void;
+  private _unsubscribeFromEngine: () => void = () => {};
   private readonly _stateSignal = signal<PathSnapshot<TData> | null>(null);
 
   public readonly state$: Observable<PathSnapshot<TData> | null> = this._state$.asObservable();
@@ -36,7 +36,37 @@ export class PathFacade<TData extends PathData = PathData> implements OnDestroy
   public readonly stateSignal: Signal<PathSnapshot<TData> | null> = this._stateSignal.asReadonly();
 
   public constructor() {
-    this.unsubscribeFromEngine = this.engine.subscribe((event) => {
+    this.connectEngine(this._engine);
+  }
+
+  /**
+   * Adopt an externally-managed `PathEngine` — for example, the engine returned
+   * by `restoreOrStart()` from `@daltonr/pathwrite-store-http`.
+   *
+   * The facade immediately reflects the engine's current state and forwards all
+   * subsequent events. The **caller** is responsible for the engine's lifecycle
+   * (starting, cleanup); the facade only subscribes to it.
+   *
+   * ```typescript
+   * const { engine } = await restoreOrStart({ store, key, path, initialData, observers: [...] });
+   * facade.adoptEngine(engine);
+   * ```
+   */
+  public adoptEngine(engine: PathEngine): void {
+    // Disconnect from whatever engine we're currently listening to
+    this._unsubscribeFromEngine();
+    this._engine = engine;
+    this.connectEngine(engine);
+  }
+
+  private connectEngine(engine: PathEngine): void {
+    // Seed state immediately — critical when restoring a persisted path since
+    // the engine is already running before the facade connects to it.
+    const current = engine.snapshot() as PathSnapshot<TData> | null;
+    this._state$.next(current);
+    this._stateSignal.set(current);
+
+    this._unsubscribeFromEngine = engine.subscribe((event) => {
       this._events$.next(event);
       if (event.type === "stateChanged" || event.type === "resumed") {
         this._state$.next(event.snapshot as PathSnapshot<TData>);
@@ -49,44 +79,54 @@ export class PathFacade<TData extends PathData = PathData> implements OnDestroy
   }
 
   public ngOnDestroy(): void {
-    this.unsubscribeFromEngine();
+    this._unsubscribeFromEngine();
     this._events$.complete();
     this._state$.complete();
   }
 
   public start(path: PathDefinition<any>, initialData: PathData = {}): Promise<void> {
-    return this.engine.start(path, initialData);
+    return this._engine.start(path, initialData);
+  }
+
+  /**
+   * Tears down any active path (without firing lifecycle hooks) and immediately
+   * starts the given path fresh. Safe to call whether or not a path is running.
+   * Use for "Start over" / retry flows without destroying and re-creating the
+   * component that provides this facade.
+   */
+  public restart(path: PathDefinition<any>, initialData: PathData = {}): Promise<void> {
+    return this._engine.restart(path, initialData);
   }
 
   public startSubPath(path: PathDefinition<any>, initialData: PathData = {}, meta?: Record<string, unknown>): Promise<void> {
-    return this.engine.startSubPath(path, initialData, meta);
+    return this._engine.startSubPath(path, initialData, meta);
   }
 
   public next(): Promise<void> {
-    return this.engine.next();
+    return this._engine.next();
   }
 
   public previous(): Promise<void> {
-    return this.engine.previous();
+    return this._engine.previous();
   }
 
   public cancel(): Promise<void> {
-    return this.engine.cancel();
+    return this._engine.cancel();
   }
 
   public setData<K extends string & keyof TData>(key: K, value: TData[K]): Promise<void> {
-    return this.engine.setData(key, value as unknown);
+    return this._engine.setData(key, value as unknown);
   }
 
   public goToStep(stepId: string): Promise<void> {
-    return this.engine.goToStep(stepId);
+    return this._engine.goToStep(stepId);
   }
 
   /** Jump to a step by ID, checking the current step's canMoveNext (forward) or
    *  canMovePrevious (backward) guard first. Navigation is blocked if the guard
    *  returns false. Throws if the step ID does not exist. */
   public goToStepChecked(stepId: string): Promise<void> {
-    return this.engine.goToStepChecked(stepId);
+    return this._engine.goToStepChecked(stepId);
   }
 
   public snapshot(): PathSnapshot<TData> | null {
@@ -162,3 +202,17 @@ export function syncFormGroup<TData extends PathData = PathData>(
   destroyRef?.onDestroy(cleanup);
   return cleanup;
 }
+
+// Re-export core types for convenience (users don't need to import from @daltonr/pathwrite-core)
+export type {
+  PathData,
+  PathDefinition,
+  PathEvent,
+  PathSnapshot,
+  PathStep,
+  PathStepContext,
+  SerializedPathState
+} from "@daltonr/pathwrite-core";
+
+export { PathEngine } from "@daltonr/pathwrite-core";
+

package/src/shell.ts

@@ -41,6 +41,8 @@ export interface PathShellActions {
   goToStep: (stepId: string) => Promise<void>;
   goToStepChecked: (stepId: string) => Promise<void>;
   setData: (key: string, value: unknown) => Promise<void>;
+  /** Restart the shell's current path with its current `initialData`. */
+  restart: () => Promise<void>;
 }
 
 // ---------------------------------------------------------------------------
@@ -210,7 +212,7 @@ export class PathShellFooterDirective {
               class="pw-shell__btn pw-shell__btn--next"
               [disabled]="s.isNavigating || !s.canMoveNext"
               (click)="facade.next()"
-            >{{ s.isLastStep ? finishLabel : nextLabel }}</button>
+            >{{ s.isLastStep ? completeLabel : nextLabel }}</button>
           </div>
         </div>
       </ng-template>
@@ -225,11 +227,11 @@ export class PathShellComponent implements OnInit, OnDestroy {
   /** Start the path automatically on ngOnInit. Set to false to call doStart() manually. */
   @Input() autoStart = true;
   /** Label for the Back navigation button. */
-  @Input() backLabel = "Back";
+  @Input() backLabel = "Previous";
   /** Label for the Next navigation button. */
   @Input() nextLabel = "Next";
   /** Label for the Next button when on the last step. */
-  @Input() finishLabel = "Finish";
+  @Input() completeLabel = "Complete";
   /** Label for the Cancel button. */
   @Input() cancelLabel = "Cancel";
   /** Hide the Cancel button entirely. */
@@ -259,6 +261,7 @@ export class PathShellComponent implements OnInit, OnDestroy {
     goToStep: (id) => this.facade.goToStep(id),
     goToStepChecked: (id) => this.facade.goToStepChecked(id),
     setData: (key, value) => this.facade.setData(key, value as never),
+    restart: () => this.facade.restart(this.path, this.initialData),
   };
 
   private readonly destroy$ = new Subject<void>();