@daltonr/pathwrite-react 0.1.1

package/LICENSE

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

package/README.md

@@ -0,0 +1,103 @@
+# @daltonr/pathwrite-react
+
+React hooks over `@daltonr/pathwrite-core`. Exposes path state as reactive React state via `useSyncExternalStore`, with stable action callbacks and an optional context provider.
+
+## Setup
+
+### Option A — `usePath` hook (component-scoped)
+
+Each call to `usePath` creates an isolated path engine instance.
+
+```tsx
+import { usePath } from "@daltonr/pathwrite-react";
+
+function MyPathHost() {
+  const { snapshot, start, next, previous, cancel, setData } = usePath({
+    onEvent(event) {
+      console.log(event);
+    }
+  });
+
+  return (
+    <div>
+      {snapshot ? (
+        <>
+          <h2>{snapshot.stepTitle ?? snapshot.stepId}</h2>
+          <p>Step {snapshot.stepIndex + 1} of {snapshot.stepCount}</p>
+          <button onClick={previous} disabled={snapshot.isNavigating}>Back</button>
+          <button onClick={next}     disabled={snapshot.isNavigating}>
+            {snapshot.isLastStep ? "Finish" : "Next"}
+          </button>
+          <button onClick={cancel}>Cancel</button>
+        </>
+      ) : (
+        <button onClick={() => start(myPath)}>Start Path</button>
+      )}
+    </div>
+  );
+}
+```
+
+### Option B — `PathProvider` + `usePathContext` (shared across components)
+
+Wrap a subtree so that multiple components can read and drive the same path instance.
+
+```tsx
+import { PathProvider, usePathContext } from "@daltonr/pathwrite-react";
+
+function App() {
+  return (
+    <PathProvider onEvent={(e) => console.log(e)}>
+      <StepDisplay />
+      <NavButtons />
+    </PathProvider>
+  );
+}
+
+function StepDisplay() {
+  const { snapshot } = usePathContext();
+  if (!snapshot) return <p>No path running.</p>;
+  return <h2>{snapshot.stepTitle ?? snapshot.stepId}</h2>;
+}
+
+function NavButtons() {
+  const { snapshot, next, previous } = usePathContext();
+  if (!snapshot) return null;
+  return (
+    <>
+      <button onClick={previous}>Back</button>
+      <button onClick={next}>Next</button>
+    </>
+  );
+}
+```
+
+## `usePath` API
+
+### Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `onEvent` | `(event: PathEvent) => void` | Called for every engine event. The callback ref is kept current — changing it does **not** re-subscribe to the engine. |
+
+### Return value
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `snapshot` | `PathSnapshot \| null` | Current snapshot. `null` when no path is active. Triggers a React re-render on change. |
+| `start(definition, data?)` | `function` | Start or re-start a path. |
+| `startSubPath(definition, data?)` | `function` | Push a sub-path. Requires an active path. |
+| `next()` | `function` | Advance one step. Completes the path on the last step. |
+| `previous()` | `function` | Go back one step. Cancels the path from the first step. |
+| `cancel()` | `function` | Cancel the active path (or sub-path). |
+| `goToStep(stepId)` | `function` | Jump directly to a step by ID. Calls `onLeave` / `onEnter` but bypasses guards and `shouldSkip`. |
+| `setData(key, value)` | `function` | Update a single data value; triggers re-render via `stateChanged`. |
+
+All action callbacks are **referentially stable** — safe to pass as props or include in dependency arrays without causing unnecessary re-renders.
+
+## Design notes
+
+- **`useSyncExternalStore`** — the hook subscribes to the core `PathEngine` using React 18's `useSyncExternalStore`, giving tear-free reads with no `useEffect` timing gaps.
+- **Ref-based callback** — `onEvent` is stored in a ref so that a new closure on every render does not cause a re-subscription.
+- **No RxJS** — unlike the Angular adapter, there is no RxJS dependency. The hook is pure React.
+

package/dist/index.d.ts

@@ -0,0 +1,102 @@
+import type { PropsWithChildren, ReactElement, ReactNode } from "react";
+import { PathData, PathDefinition, PathEvent, PathSnapshot } from "@daltonr/pathwrite-core";
+export interface UsePathOptions {
+    /** Called for every engine event (stateChanged, completed, cancelled, resumed). */
+    onEvent?: (event: PathEvent) => void;
+}
+export interface UsePathReturn {
+    /** Current path snapshot, or `null` when no path is active. Triggers a React re-render on change. */
+    snapshot: PathSnapshot | null;
+    /** Start (or restart) a path. */
+    start: (path: PathDefinition, initialData?: PathData) => void;
+    /** Push a sub-path onto the stack. Requires an active path. */
+    startSubPath: (path: PathDefinition, initialData?: PathData) => void;
+    /** Advance one step. Completes the path on the last step. */
+    next: () => void;
+    /** Go back one step. Cancels the path from the first step. */
+    previous: () => void;
+    /** Cancel the active path (or sub-path). */
+    cancel: () => void;
+    /** Jump directly to a step by ID. Calls onLeave / onEnter but bypasses guards and shouldSkip. */
+    goToStep: (stepId: string) => void;
+    /** Update a single data value; triggers a re-render via stateChanged. */
+    setData: (key: string, value: unknown) => void;
+}
+export type PathProviderProps = PropsWithChildren<{
+    /** Forwarded to the internal usePath hook. */
+    onEvent?: (event: PathEvent) => void;
+}>;
+export declare function usePath(options?: UsePathOptions): UsePathReturn;
+/**
+ * Provides a single `usePath` instance to all descendants.
+ * Consume with `usePathContext()`.
+ */
+export declare function PathProvider({ children, onEvent }: PathProviderProps): ReactElement;
+/**
+ * Access the nearest `PathProvider`'s path instance.
+ * Throws if used outside of a `<PathProvider>`.
+ */
+export declare function usePathContext(): UsePathReturn;
+export interface PathStepProps {
+    /** Must match a step `id` in the path definition. */
+    id: string;
+    children: ReactNode;
+}
+/**
+ * Wraps step content. Only renders its children when the current step matches `id`.
+ * Must be used inside a `<PathShell>`.
+ */
+export declare function PathStep(_props: PathStepProps): ReactElement | null;
+export interface PathShellProps {
+    /** The path definition to drive. */
+    path: PathDefinition;
+    /** Initial data passed to `engine.start()`. */
+    initialData?: PathData;
+    /** If true, the path is started automatically on mount. Defaults to `true`. */
+    autoStart?: boolean;
+    /** Called when the path completes. Receives the final data. */
+    onComplete?: (data: PathData) => void;
+    /** Called when the path is cancelled. Receives the data at time of cancellation. */
+    onCancel?: (data: PathData) => void;
+    /** Called for every engine event. */
+    onEvent?: (event: PathEvent) => void;
+    /** Label for the Back button. Defaults to `"Back"`. */
+    backLabel?: string;
+    /** Label for the Next button. Defaults to `"Next"`. */
+    nextLabel?: string;
+    /** Label for the Finish button (shown on the last step). Defaults to `"Finish"`. */
+    finishLabel?: string;
+    /** Label for the Cancel button. Defaults to `"Cancel"`. */
+    cancelLabel?: string;
+    /** If true, hide the Cancel button. Defaults to `false`. */
+    hideCancel?: boolean;
+    /** If true, hide the progress indicator. Defaults to `false`. */
+    hideProgress?: boolean;
+    /** Optional extra CSS class on the root element. */
+    className?: string;
+    /** Render prop to replace the entire header (progress area). Receives the snapshot. */
+    renderHeader?: (snapshot: PathSnapshot) => ReactNode;
+    /** Render prop to replace the entire footer (navigation area). Receives the snapshot and actions. */
+    renderFooter?: (snapshot: PathSnapshot, actions: PathShellActions) => ReactNode;
+    /** `<PathStep>` children. */
+    children: ReactNode;
+}
+export interface PathShellActions {
+    next: () => void;
+    previous: () => void;
+    cancel: () => void;
+    goToStep: (stepId: string) => void;
+    setData: (key: string, value: unknown) => void;
+}
+/**
+ * Default UI shell that renders a progress indicator, step content, and navigation
+ * buttons. Wrap `<PathStep>` children inside to define per-step content.
+ *
+ * ```tsx
+ * <PathShell path={myPath} initialData={{ name: "" }} onComplete={handleDone}>
+ *   <PathStep id="details"><DetailsForm /></PathStep>
+ *   <PathStep id="review"><ReviewPanel /></PathStep>
+ * </PathShell>
+ * ```
+ */
+export declare function PathShell({ path: pathDef, initialData, autoStart, onComplete, onCancel, onEvent, backLabel, nextLabel, finishLabel, cancelLabel, hideCancel, hideProgress, className, renderHeader, renderFooter, children }: PathShellProps): ReactElement;

package/dist/index.js

@@ -0,0 +1,178 @@
+import { createContext, createElement, useCallback, useContext, useEffect, useRef, useSyncExternalStore } from "react";
+import { PathEngine } from "@daltonr/pathwrite-core";
+// ---------------------------------------------------------------------------
+// usePath hook
+// ---------------------------------------------------------------------------
+export function usePath(options) {
+    // Stable engine instance for the lifetime of the hook
+    const engineRef = useRef(null);
+    if (engineRef.current === null) {
+        engineRef.current = new PathEngine();
+    }
+    const engine = engineRef.current;
+    // Keep the onEvent callback current without changing the subscribe identity
+    const onEventRef = useRef(options?.onEvent);
+    onEventRef.current = options?.onEvent;
+    // Cached snapshot — updated only inside the subscribe callback
+    const snapshotRef = useRef(null);
+    const subscribe = useCallback((callback) => engine.subscribe((event) => {
+        if (event.type === "stateChanged" || event.type === "resumed") {
+            snapshotRef.current = event.snapshot;
+        }
+        else if (event.type === "completed" || event.type === "cancelled") {
+            snapshotRef.current = null;
+        }
+        onEventRef.current?.(event);
+        callback();
+    }), [engine]);
+    const getSnapshot = useCallback(() => snapshotRef.current, []);
+    const snapshot = useSyncExternalStore(subscribe, getSnapshot);
+    // Stable action callbacks
+    const start = useCallback((path, initialData = {}) => engine.start(path, initialData), [engine]);
+    const startSubPath = useCallback((path, initialData = {}) => engine.startSubPath(path, initialData), [engine]);
+    const next = useCallback(() => engine.next(), [engine]);
+    const previous = useCallback(() => engine.previous(), [engine]);
+    const cancel = useCallback(() => engine.cancel(), [engine]);
+    const goToStep = useCallback((stepId) => engine.goToStep(stepId), [engine]);
+    const setData = useCallback((key, value) => engine.setData(key, value), [engine]);
+    return { snapshot, start, startSubPath, next, previous, cancel, goToStep, setData };
+}
+// ---------------------------------------------------------------------------
+// Context + Provider
+// ---------------------------------------------------------------------------
+const PathContext = createContext(null);
+/**
+ * Provides a single `usePath` instance to all descendants.
+ * Consume with `usePathContext()`.
+ */
+export function PathProvider({ children, onEvent }) {
+    const path = usePath({ onEvent });
+    return createElement(PathContext.Provider, { value: path }, children);
+}
+/**
+ * Access the nearest `PathProvider`'s path instance.
+ * Throws if used outside of a `<PathProvider>`.
+ */
+export function usePathContext() {
+    const ctx = useContext(PathContext);
+    if (ctx === null) {
+        throw new Error("usePathContext must be used within a <PathProvider>.");
+    }
+    return ctx;
+}
+/**
+ * Wraps step content. Only renders its children when the current step matches `id`.
+ * Must be used inside a `<PathShell>`.
+ */
+export function PathStep(_props) {
+    // Rendering is handled by PathShell — PathStep is never rendered directly.
+    // It exists purely as a typed container so PathShell can inspect its props.
+    return null;
+}
+/**
+ * Default UI shell that renders a progress indicator, step content, and navigation
+ * buttons. Wrap `<PathStep>` children inside to define per-step content.
+ *
+ * ```tsx
+ * <PathShell path={myPath} initialData={{ name: "" }} onComplete={handleDone}>
+ *   <PathStep id="details"><DetailsForm /></PathStep>
+ *   <PathStep id="review"><ReviewPanel /></PathStep>
+ * </PathShell>
+ * ```
+ */
+export function PathShell({ path: pathDef, initialData = {}, autoStart = true, onComplete, onCancel, onEvent, backLabel = "Back", nextLabel = "Next", finishLabel = "Finish", cancelLabel = "Cancel", hideCancel = false, hideProgress = false, className, renderHeader, renderFooter, children }) {
+    const pathReturn = usePath({
+        onEvent(event) {
+            onEvent?.(event);
+            if (event.type === "completed")
+                onComplete?.(event.data);
+            if (event.type === "cancelled")
+                onCancel?.(event.data);
+        }
+    });
+    const { snapshot, start, next, previous, cancel, goToStep, setData } = pathReturn;
+    // Auto-start on mount
+    const startedRef = useRef(false);
+    useEffect(() => {
+        if (autoStart && !startedRef.current) {
+            startedRef.current = true;
+            start(pathDef, initialData);
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    // Resolve which <PathStep> children to display
+    const stepContent = resolveStepContent(children, snapshot);
+    if (!snapshot) {
+        return 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)
+        }, "Start")));
+    }
+    const actions = { next, previous, cancel, goToStep, setData };
+    return createElement("div", { className: cls("pw-shell", className) }, 
+    // Header — progress indicator
+    !hideProgress && (renderHeader
+        ? renderHeader(snapshot)
+        : defaultHeader(snapshot)), 
+    // Body — step content
+    createElement("div", { className: "pw-shell__body" }, stepContent), 
+    // Footer — navigation buttons
+    renderFooter
+        ? renderFooter(snapshot, actions)
+        : defaultFooter(snapshot, actions, {
+            backLabel, nextLabel, finishLabel, cancelLabel, hideCancel
+        }));
+}
+// ---------------------------------------------------------------------------
+// Default header (progress indicator)
+// ---------------------------------------------------------------------------
+function defaultHeader(snapshot) {
+    return createElement("div", { className: "pw-shell__header" }, createElement("div", { className: "pw-shell__steps" }, ...snapshot.steps.map((step, i) => createElement("div", {
+        key: step.id,
+        className: cls("pw-shell__step", `pw-shell__step--${step.status}`)
+    }, createElement("span", { className: "pw-shell__step-dot" }, step.status === "completed" ? "✓" : String(i + 1)), createElement("span", { className: "pw-shell__step-label" }, step.title ?? step.id)))), createElement("div", { className: "pw-shell__track" }, createElement("div", {
+        className: "pw-shell__track-fill",
+        style: { width: `${snapshot.progress * 100}%` }
+    })));
+}
+function defaultFooter(snapshot, actions, labels) {
+    return createElement("div", { className: "pw-shell__footer" }, createElement("div", { className: "pw-shell__footer-left" }, !snapshot.isFirstStep && createElement("button", {
+        type: "button",
+        className: "pw-shell__btn pw-shell__btn--back",
+        disabled: snapshot.isNavigating,
+        onClick: actions.previous
+    }, labels.backLabel)), createElement("div", { className: "pw-shell__footer-right" }, !labels.hideCancel && createElement("button", {
+        type: "button",
+        className: "pw-shell__btn pw-shell__btn--cancel",
+        disabled: snapshot.isNavigating,
+        onClick: actions.cancel
+    }, labels.cancelLabel), createElement("button", {
+        type: "button",
+        className: "pw-shell__btn pw-shell__btn--next",
+        disabled: snapshot.isNavigating,
+        onClick: actions.next
+    }, snapshot.isLastStep ? labels.finishLabel : labels.nextLabel)));
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function resolveStepContent(children, snapshot) {
+    if (!snapshot || !children)
+        return null;
+    const arr = Array.isArray(children) ? children : [children];
+    for (const child of arr) {
+        if (child &&
+            typeof child === "object" &&
+            "type" in child &&
+            child.type === PathStep &&
+            child.props?.id === snapshot.stepId) {
+            return child.props.children ?? null;
+        }
+    }
+    return null;
+}
+function cls(...parts) {
+    return parts.filter(Boolean).join(" ");
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@daltonr/pathwrite-react",
+  "version": "0.1.1",
+  "type": "module",
+  "license": "MIT",
+  "description": "React adapter for @daltonr/pathwrite-core — hooks, context provider, and optional <PathShell> default UI.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/richardadalton/pathwrite.git",
+    "directory": "packages/react-adapter"
+  },
+  "keywords": [
+    "wizard",
+    "stepper",
+    "path",
+    "react",
+    "hooks",
+    "multi-step",
+    "workflow"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "dependencies": {
+    "@daltonr/pathwrite-core": "^0.1.1"
+  },
+  "devDependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "@testing-library/react": "^16.1.0",
+    "jsdom": "^25.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}