@daltonr/pathwrite-core 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,98 @@
+# @daltonr/pathwrite-core
+
+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.
+
+## Key types
+
+```typescript
+// Define your path's data shape once
+interface CourseData extends PathData {
+  courseName: string;
+  subjects: SubjectEntry[];
+}
+
+const path: PathDefinition<CourseData> = {
+  id: "course-path",
+  steps: [
+    {
+      id: "details",
+      canMoveNext: (ctx) => ctx.data.courseName.length > 0,
+      onLeave: (ctx) => ({ courseName: ctx.data.courseName.trim() })
+    },
+    { id: "review" }
+  ]
+};
+```
+
+| Type | Description |
+|------|-------------|
+| `PathDefinition<TData>` | A path's ID, title, and ordered list of step definitions. |
+| `PathStep<TData>` | A single step: guards, lifecycle hooks. |
+| `PathStepContext<TData>` | Passed to every hook and guard. `data` is a **readonly snapshot copy** — return a patch to update state. |
+| `PathSnapshot<TData>` | Point-in-time read of the engine: step ID, index, count, flags, and a copy of data. |
+| `PathEvent` | Union of `stateChanged`, `completed`, `cancelled`, and `resumed`. |
+
+## PathEngine API
+
+```typescript
+const engine = new PathEngine();
+
+engine.start(definition, initialData?);    // start or re-start a path
+engine.startSubPath(definition, data?);    // push sub-path onto the stack (requires active path)
+engine.next();
+engine.previous();
+engine.cancel();
+engine.setData(key, value);                // update a single data value; emits stateChanged
+engine.snapshot();                         // returns PathSnapshot | null
+
+const unsubscribe = engine.subscribe((event) => { ... });
+unsubscribe(); // remove the listener
+```
+
+## Lifecycle hooks
+
+All hooks are optional. Hooks that want to update data **return a partial patch** — the engine applies it automatically. Direct mutation of `ctx.data` is a no-op; the context receives a copy.
+
+| Hook | When called | Can return 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 | ✅ |
+| `canMoveNext` | Before advancing — return `false` to block | — |
+| `canMovePrevious` | Before going back — return `false` to block | — |
+
+### Example — sub-path result merged into parent data
+
+```typescript
+{
+  id: "subjects-list",
+  onSubPathComplete: (_id, subData, ctx) => ({
+    subjects: [...(ctx.data.subjects ?? []), { name: subData.name, teacher: subData.teacher }]
+  })
+}
+```
+
+## Sub-path flow
+
+```
+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
+```
+
+Cancelling a sub-path pops it off the stack silently — `onSubPathComplete` is **not** called.
+
+## Events
+
+```typescript
+engine.subscribe((event) => {
+  switch (event.type) {
+    case "stateChanged": // event.snapshot
+    case "completed":    // event.pathId, event.data
+    case "cancelled":    // event.pathId, event.data
+    case "resumed":      // event.resumedPathId, event.fromSubPathId, event.snapshot
+  }
+});
+```

package/dist/index.d.ts

@@ -0,0 +1,96 @@
+export type PathData = Record<string, unknown>;
+export interface PathStepContext<TData extends PathData = PathData> {
+    readonly pathId: string;
+    readonly stepId: string;
+    readonly data: Readonly<TData>;
+}
+export interface PathStep<TData extends PathData = PathData> {
+    id: string;
+    title?: string;
+    meta?: Record<string, unknown>;
+    shouldSkip?: (ctx: PathStepContext<TData>) => boolean | Promise<boolean>;
+    canMoveNext?: (ctx: PathStepContext<TData>) => boolean | Promise<boolean>;
+    canMovePrevious?: (ctx: PathStepContext<TData>) => boolean | Promise<boolean>;
+    onEnter?: (ctx: PathStepContext<TData>) => Partial<TData> | void | Promise<Partial<TData> | void>;
+    onLeave?: (ctx: PathStepContext<TData>) => Partial<TData> | void | Promise<Partial<TData> | void>;
+    onSubPathComplete?: (subPathId: string, subPathData: PathData, ctx: PathStepContext<TData>) => Partial<TData> | void | Promise<Partial<TData> | void>;
+}
+export interface PathDefinition<TData extends PathData = PathData> {
+    id: string;
+    title?: string;
+    steps: PathStep<TData>[];
+}
+export type StepStatus = "completed" | "current" | "upcoming";
+export interface StepSummary {
+    id: string;
+    title?: string;
+    meta?: Record<string, unknown>;
+    status: StepStatus;
+}
+export interface PathSnapshot<TData extends PathData = PathData> {
+    pathId: string;
+    stepId: string;
+    stepTitle?: string;
+    stepMeta?: Record<string, unknown>;
+    stepIndex: number;
+    stepCount: number;
+    progress: number;
+    steps: StepSummary[];
+    isFirstStep: boolean;
+    isLastStep: boolean;
+    nestingLevel: number;
+    /** True while an async guard or hook is executing. Use to disable navigation controls. */
+    isNavigating: boolean;
+    data: TData;
+}
+export type PathEvent = {
+    type: "stateChanged";
+    snapshot: PathSnapshot;
+} | {
+    type: "completed";
+    pathId: string;
+    data: PathData;
+} | {
+    type: "cancelled";
+    pathId: string;
+    data: PathData;
+} | {
+    type: "resumed";
+    resumedPathId: string;
+    fromSubPathId: string;
+    snapshot: PathSnapshot;
+};
+export declare class PathEngine {
+    private activePath;
+    private readonly pathStack;
+    private readonly listeners;
+    private _isNavigating;
+    subscribe(listener: (event: PathEvent) => void): () => void;
+    start(path: PathDefinition, initialData?: PathData): Promise<void>;
+    /** Starts a sub-path on top of the currently active path. Throws if no path is running. */
+    startSubPath(path: PathDefinition, initialData?: PathData): Promise<void>;
+    next(): Promise<void>;
+    previous(): Promise<void>;
+    /** Cancel is synchronous (no hooks). Returns a resolved Promise for API consistency. */
+    cancel(): Promise<void>;
+    setData(key: string, value: unknown): Promise<void>;
+    /** Jumps directly to the step with the given ID. Does not check guards or shouldSkip. */
+    goToStep(stepId: string): Promise<void>;
+    snapshot(): PathSnapshot | null;
+    private _startAsync;
+    private _nextAsync;
+    private _previousAsync;
+    private _goToStepAsync;
+    private finishActivePath;
+    private requireActivePath;
+    private assertPathHasSteps;
+    private emit;
+    private emitStateChanged;
+    private getCurrentStep;
+    private applyPatch;
+    private skipSteps;
+    private enterCurrentStep;
+    private leaveCurrentStep;
+    private canMoveNext;
+    private canMovePrevious;
+}

package/dist/index.js

@@ -0,0 +1,325 @@
+export class PathEngine {
+    activePath = null;
+    pathStack = [];
+    listeners = new Set();
+    _isNavigating = false;
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    // ---------------------------------------------------------------------------
+    // Public API
+    // ---------------------------------------------------------------------------
+    start(path, initialData = {}) {
+        this.assertPathHasSteps(path);
+        return this._startAsync(path, initialData);
+    }
+    /** Starts a sub-path on top of the currently active path. Throws if no path is running. */
+    startSubPath(path, initialData = {}) {
+        this.requireActivePath();
+        return this.start(path, initialData);
+    }
+    next() {
+        const active = this.requireActivePath();
+        return this._nextAsync(active);
+    }
+    previous() {
+        const active = this.requireActivePath();
+        return this._previousAsync(active);
+    }
+    /** Cancel is synchronous (no hooks). Returns a resolved Promise for API consistency. */
+    cancel() {
+        const active = this.requireActivePath();
+        if (this._isNavigating)
+            return Promise.resolve();
+        const cancelledPathId = active.definition.id;
+        const cancelledData = { ...active.data };
+        if (this.pathStack.length > 0) {
+            this.activePath = this.pathStack.pop() ?? null;
+            this.emitStateChanged();
+            return Promise.resolve();
+        }
+        this.activePath = null;
+        this.emit({ type: "cancelled", pathId: cancelledPathId, data: cancelledData });
+        return Promise.resolve();
+    }
+    setData(key, value) {
+        const active = this.requireActivePath();
+        active.data[key] = value;
+        this.emitStateChanged();
+        return Promise.resolve();
+    }
+    /** Jumps directly to the step with the given ID. Does not check guards or shouldSkip. */
+    goToStep(stepId) {
+        const active = this.requireActivePath();
+        const targetIndex = active.definition.steps.findIndex((s) => s.id === stepId);
+        if (targetIndex === -1) {
+            throw new Error(`Step "${stepId}" not found in path "${active.definition.id}".`);
+        }
+        return this._goToStepAsync(active, targetIndex);
+    }
+    snapshot() {
+        if (this.activePath === null) {
+            return null;
+        }
+        const active = this.activePath;
+        const step = this.getCurrentStep(active);
+        const { steps } = active.definition;
+        const stepCount = steps.length;
+        return {
+            pathId: active.definition.id,
+            stepId: step.id,
+            stepTitle: step.title,
+            stepMeta: step.meta,
+            stepIndex: active.currentStepIndex,
+            stepCount,
+            progress: stepCount <= 1 ? 1 : active.currentStepIndex / (stepCount - 1),
+            steps: steps.map((s, i) => ({
+                id: s.id,
+                title: s.title,
+                meta: s.meta,
+                status: i < active.currentStepIndex ? "completed"
+                    : i === active.currentStepIndex ? "current"
+                        : "upcoming"
+            })),
+            isFirstStep: active.currentStepIndex === 0,
+            isLastStep: active.currentStepIndex === stepCount - 1 &&
+                this.pathStack.length === 0,
+            nestingLevel: this.pathStack.length,
+            isNavigating: this._isNavigating,
+            data: { ...active.data }
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // Private async helpers
+    // ---------------------------------------------------------------------------
+    async _startAsync(path, initialData) {
+        if (this._isNavigating)
+            return;
+        if (this.activePath !== null) {
+            this.pathStack.push(this.activePath);
+        }
+        this.activePath = {
+            definition: path,
+            currentStepIndex: 0,
+            data: { ...initialData }
+        };
+        this._isNavigating = true;
+        await this.skipSteps(1);
+        if (this.activePath.currentStepIndex >= path.steps.length) {
+            this._isNavigating = false;
+            await this.finishActivePath();
+            return;
+        }
+        this.emitStateChanged();
+        try {
+            this.applyPatch(await this.enterCurrentStep());
+            this._isNavigating = false;
+            this.emitStateChanged();
+        }
+        catch (err) {
+            this._isNavigating = false;
+            this.emitStateChanged();
+            throw err;
+        }
+    }
+    async _nextAsync(active) {
+        if (this._isNavigating)
+            return;
+        this._isNavigating = true;
+        this.emitStateChanged();
+        try {
+            const step = this.getCurrentStep(active);
+            if (await this.canMoveNext(active, step)) {
+                this.applyPatch(await this.leaveCurrentStep(active, step));
+                active.currentStepIndex += 1;
+                await this.skipSteps(1);
+            }
+            if (active.currentStepIndex >= active.definition.steps.length) {
+                this._isNavigating = false;
+                await this.finishActivePath();
+                return;
+            }
+            this.applyPatch(await this.enterCurrentStep());
+            this._isNavigating = false;
+            this.emitStateChanged();
+        }
+        catch (err) {
+            this._isNavigating = false;
+            this.emitStateChanged();
+            throw err;
+        }
+    }
+    async _previousAsync(active) {
+        if (this._isNavigating)
+            return;
+        this._isNavigating = true;
+        this.emitStateChanged();
+        try {
+            const step = this.getCurrentStep(active);
+            if (await this.canMovePrevious(active, step)) {
+                this.applyPatch(await this.leaveCurrentStep(active, step));
+                active.currentStepIndex -= 1;
+                await this.skipSteps(-1);
+            }
+            if (active.currentStepIndex < 0) {
+                this._isNavigating = false;
+                await this.cancel();
+                return;
+            }
+            this.applyPatch(await this.enterCurrentStep());
+            this._isNavigating = false;
+            this.emitStateChanged();
+        }
+        catch (err) {
+            this._isNavigating = false;
+            this.emitStateChanged();
+            throw err;
+        }
+    }
+    async _goToStepAsync(active, targetIndex) {
+        if (this._isNavigating)
+            return;
+        this._isNavigating = true;
+        this.emitStateChanged();
+        try {
+            const currentStep = this.getCurrentStep(active);
+            this.applyPatch(await this.leaveCurrentStep(active, currentStep));
+            active.currentStepIndex = targetIndex;
+            this.applyPatch(await this.enterCurrentStep());
+            this._isNavigating = false;
+            this.emitStateChanged();
+        }
+        catch (err) {
+            this._isNavigating = false;
+            this.emitStateChanged();
+            throw err;
+        }
+    }
+    async finishActivePath() {
+        const finished = this.requireActivePath();
+        const finishedPathId = finished.definition.id;
+        const finishedData = { ...finished.data };
+        if (this.pathStack.length > 0) {
+            this.activePath = this.pathStack.pop();
+            const parent = this.activePath;
+            const parentStep = this.getCurrentStep(parent);
+            if (parentStep.onSubPathComplete) {
+                const ctx = {
+                    pathId: parent.definition.id,
+                    stepId: parentStep.id,
+                    data: { ...parent.data }
+                };
+                this.applyPatch(await parentStep.onSubPathComplete(finishedPathId, finishedData, ctx));
+            }
+            this.emit({
+                type: "resumed",
+                resumedPathId: parent.definition.id,
+                fromSubPathId: finishedPathId,
+                snapshot: this.snapshot()
+            });
+        }
+        else {
+            this.activePath = null;
+            this.emit({ type: "completed", pathId: finishedPathId, data: finishedData });
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    requireActivePath() {
+        if (this.activePath === null) {
+            throw new Error("No active path.");
+        }
+        return this.activePath;
+    }
+    assertPathHasSteps(path) {
+        if (!path.steps || path.steps.length === 0) {
+            throw new Error(`Path "${path.id}" must have at least one step.`);
+        }
+    }
+    emit(event) {
+        for (const listener of this.listeners) {
+            listener(event);
+        }
+    }
+    emitStateChanged() {
+        this.emit({ type: "stateChanged", snapshot: this.snapshot() });
+    }
+    getCurrentStep(active) {
+        return active.definition.steps[active.currentStepIndex];
+    }
+    applyPatch(patch) {
+        if (patch && typeof patch === "object") {
+            const active = this.activePath;
+            if (active) {
+                Object.assign(active.data, patch);
+            }
+        }
+    }
+    async skipSteps(direction) {
+        const active = this.activePath;
+        if (!active)
+            return;
+        while (active.currentStepIndex >= 0 &&
+            active.currentStepIndex < active.definition.steps.length) {
+            const step = active.definition.steps[active.currentStepIndex];
+            if (!step.shouldSkip)
+                break;
+            const ctx = {
+                pathId: active.definition.id,
+                stepId: step.id,
+                data: { ...active.data }
+            };
+            const skip = await step.shouldSkip(ctx);
+            if (!skip)
+                break;
+            active.currentStepIndex += direction;
+        }
+    }
+    async enterCurrentStep() {
+        const active = this.activePath;
+        if (!active)
+            return;
+        const step = this.getCurrentStep(active);
+        if (!step.onEnter)
+            return;
+        const ctx = {
+            pathId: active.definition.id,
+            stepId: step.id,
+            data: { ...active.data }
+        };
+        return step.onEnter(ctx);
+    }
+    async leaveCurrentStep(active, step) {
+        if (!step.onLeave)
+            return;
+        const ctx = {
+            pathId: active.definition.id,
+            stepId: step.id,
+            data: { ...active.data }
+        };
+        return step.onLeave(ctx);
+    }
+    async canMoveNext(active, step) {
+        if (!step.canMoveNext)
+            return true;
+        const ctx = {
+            pathId: active.definition.id,
+            stepId: step.id,
+            data: { ...active.data }
+        };
+        return step.canMoveNext(ctx);
+    }
+    async canMovePrevious(active, step) {
+        if (!step.canMovePrevious)
+            return true;
+        const ctx = {
+            pathId: active.definition.id,
+            stepId: step.id,
+            data: { ...active.data }
+        };
+        return step.canMovePrevious(ctx);
+    }
+}
+//# 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,43 @@
+{
+  "name": "@daltonr/pathwrite-core",
+  "version": "0.1.1",
+  "type": "module",
+  "license": "MIT",
+  "description": "Headless path engine — deterministic state machine with stack-based sub-path orchestration. Zero dependencies.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/richardadalton/pathwrite.git",
+    "directory": "packages/core"
+  },
+  "keywords": [
+    "wizard",
+    "stepper",
+    "path",
+    "state-machine",
+    "multi-step",
+    "workflow",
+    "headless"
+  ],
+  "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"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}