@statewalker/fsm 0.37.0 → 0.38.1

package/src/{orchestrator/start-process.ts → start-process.ts}

@@ -1,74 +1,49 @@
-import { FsmProcess, type FsmProcessDump } from "../core/fsm-process.ts";
-import type { FsmState } from "../core/fsm-state.ts";
-import type { FsmStateConfig } from "../core/fsm-state-config.ts";
-import type { FsmStateDescriptor } from "../core/fsm-state-descriptor.ts";
-import type { StageHandler } from "./handler-registry.ts";
-
+import { FsmProcess, type FsmProcessDump } from "./core/fsm-process.ts";
+import type { FsmState } from "./core/fsm-state.ts";
+import type { FsmStateConfig } from "./core/fsm-state-config.ts";
+import { isStateTransitionEnabled } from "./core/fsm-transitions.ts";
+
+/**
+ * Per-state behaviour contract used by `startProcess`. One function shape expresses
+ * what to do while in a state, and its *return value* wires up the rest, so a state's
+ * setup and teardown live together. The handler runs on entry with the shared
+ * `context` and may return:
+ * - nothing — no teardown;
+ * - a cleanup `function` — registered as this state's `onExit`;
+ * - an async/sync generator — run concurrently, each yielded string dispatched back
+ *   into the machine (self-driving/reactive states), auto-`return()`ed on exit.
+ */
+export type StageHandler<C = Record<string, unknown>> = (
+  context: C,
+) =>
+  | void
+  | (() => void | Promise<void>)
+  | Promise<void | (() => void | Promise<void>)>
+  | AsyncGenerator<string, void, unknown>
+  | Generator<string, void, unknown>;
+
+/**
+ * The caller's remote control returned by `startProcess`: stop the machine and
+ * snapshot/rehydrate it without holding a reference to the underlying `FsmProcess`.
+ */
 export interface ProcessHandle {
   shutdown(): Promise<void>;
   dump(...args: unknown[]): Promise<FsmProcessDump>;
   restore(dump: FsmProcessDump, ...args: unknown[]): Promise<void>;
 }
 
-// Context keys for binding FSM functions into the shared context object.
+// Context keys under which `startProcess` binds the machine into the shared context
+// object. Why via context (not closures): handlers reach the running machine
+// uniformly — `(ctx[KEY_DISPATCH])(event)` — regardless of where they are defined.
+/** Context key: `(event) => Promise<void>` that dispatches an event (guarded). */
 export const KEY_DISPATCH = "fsm:dispatch";
+/** Context key: `() => Promise<void>` that shuts the machine down. */
 export const KEY_TERMINATE = "fsm:terminate";
+/** Context key: the current state-key stack (root→leaf), refreshed on every transition. */
 export const KEY_STATES = "fsm:states";
+/** Context key: the last dispatched event. */
 export const KEY_EVENT = "fsm:event";
 
-// ---------------------------------------------------------------------------
-// Transition introspection
-// ---------------------------------------------------------------------------
-
-export function getStateTransitions(
-  state?: FsmState,
-): [from: string, event: string, to: string][] {
-  const result: [from: string, event: string, to: string][] = [];
-  const index: Record<string, boolean> = {};
-  if (state) {
-    let prevStateKey = state.key;
-    for (let parent = state.parent; parent; parent = parent.parent) {
-      if (!parent.descriptor) continue;
-      result.push(
-        ...getTransitionsFromDescriptor(parent.descriptor, prevStateKey, index),
-      );
-      prevStateKey = parent.key;
-    }
-  }
-  return result.reverse();
-}
-
-function getTransitionsFromDescriptor(
-  descriptor: FsmStateDescriptor,
-  prevStateKey: string,
-  index: Record<string, boolean>,
-): [from: string, event: string, to: string][] {
-  const result: [from: string, event: string, to: string][] = [];
-  const prevStateKeys = [prevStateKey, "*"];
-  for (const prevKey of prevStateKeys) {
-    const targets = descriptor.transitions[prevKey];
-    if (targets) {
-      for (const [event, target] of Object.entries(targets)) {
-        if (index[event]) continue;
-        if (target) index[event] = true;
-        result.push([prevStateKey, event, target]);
-      }
-    }
-  }
-  return result;
-}
-
-export function isStateTransitionEnabled(
-  process: FsmProcess,
-  event: string,
-): boolean {
-  const transitions = getStateTransitions(process.state);
-  for (const [, ev] of transitions) {
-    if (ev === event) return true;
-  }
-  return false;
-}
-
 // ---------------------------------------------------------------------------
 // Generator detection
 // ---------------------------------------------------------------------------
@@ -90,6 +65,24 @@ function isGenerator(
 // startProcess (also exported as startFsmProcess for backward compat)
 // ---------------------------------------------------------------------------
 
+/**
+ * Ergonomic runner: build a machine, attach behaviour via one `load` callback, and
+ * bind the machine into `context`.
+ *
+ * Doing this by hand (`new FsmProcess` + `onStateCreate` + `onEnter` + a loader +
+ * context wiring) is boilerplate every consumer repeats, so `startProcess` does it
+ * once — most callers use this instead of the raw engine. It creates the process; on
+ * each state entry calls `load(stateKey, event)` and installs the returned
+ * `StageHandler`s (their return values become `onExit` cleanups or event-yielding
+ * generators — see `StageHandler`); binds `KEY_DISPATCH` / `KEY_TERMINATE` /
+ * `KEY_STATES` / `KEY_EVENT` into `context`; dispatches `startEvent` to enter the
+ * initial state; and returns a `ProcessHandle`.
+ *
+ * @param context shared object handlers read/write and the machine is bound into
+ * @param config the declarative machine definition
+ * @param load returns the handler(s) to run for a given `(stateKey, event)`
+ * @param startEvent initial event (default `""`, the eventless start)
+ */
 export async function startProcess<C = unknown>(
   context: C,
   config: FsmStateConfig,
@@ -126,8 +119,12 @@ export async function startProcess<C = unknown>(
                 await dispatch(event);
                 if (stateExited || terminated) break;
               }
-            } catch {
-              // Swallow generator errors after return()
+            } catch (error) {
+              // A generator `return()` during state exit / termination throws an
+              // abort we intentionally swallow; a genuine error thrown by the
+              // generator body must surface through the state's error handling
+              // rather than vanish.
+              if (!stateExited && !terminated) await state._handleError(error);
             }
           })();
         } else if (typeof result === "function") {
@@ -184,5 +181,5 @@ export async function startProcess<C = unknown>(
   };
 }
 
-/** @deprecated Use `startProcess` instead */
+/** Permanent equal alias of {@link startProcess} — the name existing consumers import. */
 export const startFsmProcess = startProcess;

package/src/{utils → trace}/printer.ts

@@ -1,5 +1,13 @@
 import type { FsmProcess } from "../core/fsm-process.ts";
+
+/** A sink for trace output — anything shaped like `console.log`. */
 export type Printer = (...args: unknown[]) => void;
+/**
+ * Tuning for a `Printer`.
+ * - `prefix` — string prepended to every line (e.g. a process tag).
+ * - `print` — the underlying sink (defaults to `console.log`).
+ * - `lineNumbers` — prepend an incrementing `[n]` counter.
+ */
 export type PrinterConfig = {
   prefix?: string;
   print?: (...args: unknown[]) => void;
@@ -8,6 +16,11 @@ export type PrinterConfig = {
 
 const printerStore = new WeakMap<object, Printer>();
 
+/**
+ * Build a `Printer` bound to `process` that indents each line by the current state
+ * nesting depth (two spaces per level), so log output visually mirrors the state
+ * tree — hierarchical indentation makes enter/exit traces readable at a glance.
+ */
 export function preparePrinter(
   process: FsmProcess,
   { prefix = "", print = console.log, lineNumbers = false }: PrinterConfig,
@@ -25,6 +38,11 @@ export function preparePrinter(
   return printer;
 }
 
+/**
+ * Attach a printer to `process` (stored in a weak map so it is GC'd with the
+ * process). Handlers/tracers then reach it via {@link getProcessPrinter} /
+ * {@link getPrinter} rather than threading a logger through every call.
+ */
 export function setProcessPrinter(
   process: FsmProcess,
   config: PrinterConfig = {},
@@ -33,10 +51,12 @@ export function setProcessPrinter(
   printerStore.set(process, printer);
 }
 
+/** The printer attached to `process`, or `console.log` if none was set. */
 export function getProcessPrinter(process: FsmProcess): Printer {
   return printerStore.get(process) || console.log;
 }
 
+/** The printer for a state — its own if set, else its process's (see {@link getProcessPrinter}). */
 export function getPrinter(state: { process: FsmProcess }): Printer {
   return printerStore.get(state) || getProcessPrinter(state.process);
 }

package/src/{utils → trace}/tracer.ts

@@ -2,12 +2,23 @@ import type { FsmProcess } from "../core/fsm-process.ts";
 import type { FsmState } from "../core/fsm-state.ts";
 import { getPrinter, type Printer } from "./printer.ts";
 
+/**
+ * Trace every state of `process`: as each state is created, attach a state tracer —
+ * so you can watch the machine move as a readable stream of enter/exit markers
+ * without editing any handler. Hooks `onStateCreate` and delegates to
+ * {@link setStateTracer}; pass a `print` sink to override the process printer.
+ */
 export function setProcessTracer(process: FsmProcess, print?: Printer) {
   return process.onStateCreate((state: FsmState) => {
     setStateTracer(state, print);
   });
 }
 
+/**
+ * Trace one state's lifecycle: emit `<key event="…">` on enter and `</key>` on exit
+ * (XML-like, so nested states read as nested tags). Falls back to the state's
+ * printer ({@link getPrinter}) when no `print` sink is given.
+ */
 export function setStateTracer(state: FsmState, print?: Printer) {
   state.onEnter(() => {
     const printLine = print || getPrinter(state);

package/bin/cli.js

@@ -1,5 +0,0 @@
-#!/usr/bin/env node
-
-import { startNodeProcesses } from "../dist/bin/node-runner.js";
-
-startNodeProcesses();

package/dist/bin/node-runner-UJp8T_oP.d.ts

@@ -1,16 +0,0 @@
-import { n as LauncherConfig } from "../launcher-6VUDviTj.js";
-
-//#region src/bin/node-runner.d.ts
-declare function startProcesses({
-  onExit,
-  modules,
-  context
-}: {
-  onExit?: () => Promise<void> | void;
-  modules: unknown[];
-  context?: LauncherConfig["context"];
-}): Promise<() => Promise<void>>;
-declare function startNodeProcesses(modules?: string[]): Promise<void>;
-//#endregion
-export { startNodeProcesses as default, startNodeProcesses, startProcesses };
-//# sourceMappingURL=node-runner-UJp8T_oP.d.ts.map

package/dist/bin/node-runner-UJp8T_oP.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"node-runner-UJp8T_oP.d.ts","names":[],"sources":["../../src/bin/node-runner.ts"],"mappings":";;;iBAOsB,cAAA;;;;;iBAKL;EALK,OAAA,EAAA,OAAA,EAAc;EAAA,OAAA,CAAA,EAOxB,cAPwB,CAAA,SAAA,CAAA;IAQnC,OAPC,CAAA,GAAA,GAOD,OAPC,CAAA,IAAA,CAAA,CAAA;AACA,iBA6BoB,kBAAA,CA7BpB,OAAA,CAAA,EAAA,MAAA,EAAA,CAAA,EA6B4D,OA7B5D,CAAA,IAAA,CAAA"}

package/dist/bin/node-runner.js

@@ -1,40 +0,0 @@
-import { n as launcher } from "../launcher-CASrMAOa.js";
-//#region src/bin/node-runner.ts
-function resolveModulesPaths(baseUrl, ...refs) {
-	return refs.map((ref) => new URL(ref, baseUrl).pathname);
-}
-async function startProcesses({ onExit, modules, context }) {
-	const processDefs = [];
-	for (const mod of modules) {
-		const imported = typeof mod === "string" || mod instanceof URL ? await import(String(mod)) : mod;
-		if (imported && typeof imported === "object") processDefs.push(imported);
-	}
-	if (onExit) processDefs.push({
-		name: "Exit",
-		config: { key: "Exit" },
-		handlers: [() => onExit]
-	});
-	return await launcher({
-		processes: processDefs,
-		context
-	});
-}
-async function startNodeProcesses(modules) {
-	try {
-		if (!modules) modules = process.argv.slice(2);
-		const terminate = await startProcesses({
-			modules: resolveModulesPaths(`file://${process.cwd()}/`, ...modules),
-			onExit: () => process.exit(0)
-		});
-		process.on("SIGINT", terminate);
-		process.on("SIGTERM", terminate);
-		process.stdin.resume();
-	} catch (err) {
-		console.error("Fatal error:", err);
-		process.exit(1);
-	}
-}
-//#endregion
-export { startNodeProcesses as default, startNodeProcesses, startProcesses };
-
-//# sourceMappingURL=node-runner.js.map

package/dist/bin/node-runner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"node-runner.js","names":[],"sources":["../../src/bin/node-runner.ts"],"sourcesContent":["import type { LauncherConfig, ProcessDef } from \"../orchestrator/launcher.ts\";\nimport { launcher } from \"../orchestrator/launcher.ts\";\n\nfunction resolveModulesPaths(baseUrl: string, ...refs: string[]): string[] {\n  return refs.map((ref) => new URL(ref, baseUrl).pathname);\n}\n\nexport async function startProcesses({\n  onExit,\n  modules,\n  context,\n}: {\n  onExit?: () => Promise<void> | void;\n  modules: unknown[];\n  context?: LauncherConfig[\"context\"];\n}) {\n  const processDefs: ProcessDef[] = [];\n  for (const mod of modules) {\n    const imported =\n      typeof mod === \"string\" || mod instanceof URL\n        ? await import(String(mod))\n        : mod;\n    if (imported && typeof imported === \"object\") {\n      processDefs.push(imported as ProcessDef);\n    }\n  }\n\n  if (onExit) {\n    processDefs.push({\n      name: \"Exit\",\n      config: { key: \"Exit\" },\n      handlers: [() => onExit],\n    });\n  }\n\n  return await launcher({ processes: processDefs, context });\n}\n\nexport async function startNodeProcesses(modules?: string[]): Promise<void> {\n  try {\n    if (!modules) {\n      modules = process.argv.slice(2);\n    }\n    const terminate = await startProcesses({\n      modules: resolveModulesPaths(`file://${process.cwd()}/`, ...modules),\n      onExit: () => process.exit(0),\n    });\n    process.on(\"SIGINT\", terminate);\n    process.on(\"SIGTERM\", terminate);\n    process.stdin.resume();\n  } catch (err) {\n    console.error(\"Fatal error:\", err);\n    process.exit(1);\n  }\n}\n\nexport default startNodeProcesses;\n"],"mappings":";;AAGA,SAAS,oBAAoB,SAAiB,GAAG,MAA0B;AACzE,QAAO,KAAK,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,CAAC,SAAS;;AAG1D,eAAsB,eAAe,EACnC,QACA,SACA,WAKC;CACD,MAAM,cAA4B,EAAE;AACpC,MAAK,MAAM,OAAO,SAAS;EACzB,MAAM,WACJ,OAAO,QAAQ,YAAY,eAAe,MACtC,MAAM,OAAO,OAAO,IAAI,IACxB;AACN,MAAI,YAAY,OAAO,aAAa,SAClC,aAAY,KAAK,SAAuB;;AAI5C,KAAI,OACF,aAAY,KAAK;EACf,MAAM;EACN,QAAQ,EAAE,KAAK,QAAQ;EACvB,UAAU,OAAO,OAAO;EACzB,CAAC;AAGJ,QAAO,MAAM,SAAS;EAAE,WAAW;EAAa;EAAS,CAAC;;AAG5D,eAAsB,mBAAmB,SAAmC;AAC1E,KAAI;AACF,MAAI,CAAC,QACH,WAAU,QAAQ,KAAK,MAAM,EAAE;EAEjC,MAAM,YAAY,MAAM,eAAe;GACrC,SAAS,oBAAoB,UAAU,QAAQ,KAAK,CAAC,IAAI,GAAG,QAAQ;GACpE,cAAc,QAAQ,KAAK,EAAE;GAC9B,CAAC;AACF,UAAQ,GAAG,UAAU,UAAU;AAC/B,UAAQ,GAAG,WAAW,UAAU;AAChC,UAAQ,MAAM,QAAQ;UACf,KAAK;AACZ,UAAQ,MAAM,gBAAgB,IAAI;AAClC,UAAQ,KAAK,EAAE"}

package/dist/index-vTjnkbGW.d.ts

@@ -1,129 +0,0 @@
-import { a as HandlerRegistry, c as toStageHandlers, d as FsmEventKey, f as FsmStateConfig, g as STATE_INITIAL, h as STATE_FINAL, i as launcher, l as EVENT_ANY, m as STATE_ANY, n as LauncherConfig, o as StageHandler, p as FsmStateKey, r as ProcessDef, s as createHandlerRegistry, t as KEY_LAUNCH_PROCESS, u as EVENT_EMPTY } from "./launcher-6VUDviTj.js";
-
-//#region src/core/fsm-base-class.d.ts
-type Handler<P extends unknown[] = unknown[], R = unknown> = (...args: P) => R;
-declare class FsmBaseClass {
-  handlers: Record<string, Handler[]>;
-  protected _addHandler<T>(type: string, handler: T, direct?: boolean): () => void;
-  protected _removeHandler<T>(type: string, handler: T): void;
-  _runHandler(type: string, ...args: unknown[]): Promise<void>;
-  _handleError(error: Error | unknown): Promise<void>;
-}
-declare function bindMethods<T>(obj: T, ...methods: (string | symbol)[]): T;
-//#endregion
-//#region src/core/fsm-state-descriptor.d.ts
-declare class FsmStateDescriptor {
-  transitions: Record<string, Record<string, string>>;
-  states: Record<string, FsmStateDescriptor>;
-  static build(config: FsmStateConfig): FsmStateDescriptor;
-  getTargetStateKey(stateKey: string, eventKey: string): string;
-}
-//# sourceMappingURL=fsm-state-descriptor.d.ts.map
-//#endregion
-//#region src/core/fsm-state.d.ts
-type FsmStateDump = Record<string, unknown> & {
-  key: string;
-  data: Record<string, unknown>;
-};
-type FsmStateHandler = (state: FsmState, ...args: unknown[]) => void | Promise<void>;
-type FsmStateDumpHandler = (state: FsmState, dump: FsmStateDump) => void | Promise<void>;
-type FsmStateErrorHandler = (state: FsmState, error: unknown) => void | Promise<void>;
-declare class FsmState extends FsmBaseClass {
-  process: FsmProcess;
-  key: string;
-  parent?: FsmState;
-  descriptor?: FsmStateDescriptor;
-  constructor(process: FsmProcess, parent: FsmState | undefined, key: string, descriptor?: FsmStateDescriptor);
-  onEnter(handler: FsmStateHandler): () => void;
-  onExit(handler: FsmStateHandler): () => void;
-  onStateError(handler: FsmStateErrorHandler): () => void;
-  dump(handler: FsmStateDumpHandler): () => void;
-  restore(handler: FsmStateDumpHandler): () => void;
-  _handleError(error: Error | unknown): Promise<void>;
-}
-//# sourceMappingURL=fsm-state.d.ts.map
-//#endregion
-//#region src/core/fsm-process.d.ts
-declare const STATUS_NONE = 0;
-declare const STATUS_FIRST = 1;
-declare const STATUS_NEXT = 2;
-declare const STATUS_LEAF = 4;
-declare const STATUS_LAST = 8;
-declare const STATUS_FINISHED = 16;
-declare const STATUS_ENTER: number;
-declare const STATUS_EXIT: number;
-type FsmProcessHandler = (process: FsmProcess, ...args: unknown[]) => void | Promise<void>;
-type FsmProcessDump = Record<string, unknown> & {
-  status: number;
-  event?: string;
-  stack: FsmStateDump[];
-};
-type FsmProcessDumpHandler = (process: FsmProcess, dump: FsmProcessDump) => void | Promise<void>;
-declare class FsmProcess extends FsmBaseClass {
-  state?: FsmState;
-  event?: string;
-  nextEvent?: string;
-  running: boolean;
-  mask: number;
-  status: number;
-  config: FsmStateConfig;
-  rootDescriptor: FsmStateDescriptor;
-  constructor(config: FsmStateConfig);
-  shutdown(event?: string): Promise<void>;
-  dispatch(event: string): Promise<boolean>;
-  dump(...args: unknown[]): Promise<FsmProcessDump>;
-  restore(dump: FsmProcessDump, ...args: unknown[]): Promise<this>;
-  onStateCreate(handler: FsmStateHandler): () => void;
-  onStateError(handler: (state: FsmState, error: unknown) => void | Promise<void>): () => void;
-  _handleStateError(state: FsmState, error: Error | unknown): Promise<void>;
-  _newState(parent: FsmState | undefined, key: string, descriptor: FsmStateDescriptor | undefined): Promise<FsmState>;
-  _getSubstate(parent: FsmState | undefined, prevStateKey: string | undefined): Promise<FsmState | undefined>;
-  _newSubstate(parent: FsmState | undefined, toState: string): Promise<FsmState>;
-  _update(): Promise<boolean>;
-}
-//# sourceMappingURL=fsm-process.d.ts.map
-//#endregion
-//#region src/orchestrator/start-process.d.ts
-interface ProcessHandle {
-  shutdown(): Promise<void>;
-  dump(...args: unknown[]): Promise<FsmProcessDump>;
-  restore(dump: FsmProcessDump, ...args: unknown[]): Promise<void>;
-}
-declare const KEY_DISPATCH = "fsm:dispatch";
-declare const KEY_TERMINATE = "fsm:terminate";
-declare const KEY_STATES = "fsm:states";
-declare const KEY_EVENT = "fsm:event";
-declare function getStateTransitions(state?: FsmState): [from: string, event: string, to: string][];
-declare function isStateTransitionEnabled(process: FsmProcess, event: string): boolean;
-declare function startProcess<C = unknown>(context: C, config: FsmStateConfig, load: (state: string, event: string | undefined) => StageHandler<C>[] | Promise<StageHandler<C>[]>, startEvent?: string): Promise<ProcessHandle>;
-/** @deprecated Use `startProcess` instead */
-declare const startFsmProcess: typeof startProcess;
-//# sourceMappingURL=start-process.d.ts.map
-//#endregion
-//#region src/utils/printer.d.ts
-type Printer = (...args: unknown[]) => void;
-type PrinterConfig = {
-  prefix?: string;
-  print?: (...args: unknown[]) => void;
-  lineNumbers?: boolean;
-};
-declare function preparePrinter(process: FsmProcess, {
-  prefix,
-  print,
-  lineNumbers
-}: PrinterConfig): Printer;
-declare function setProcessPrinter(process: FsmProcess, config?: PrinterConfig): void;
-declare function getProcessPrinter(process: FsmProcess): Printer;
-declare function getPrinter(state: {
-  process: FsmProcess;
-}): Printer;
-//# sourceMappingURL=printer.d.ts.map
-//#endregion
-//#region src/utils/tracer.d.ts
-declare function setProcessTracer(process: FsmProcess, print?: Printer): () => void;
-declare function setStateTracer(state: FsmState, print?: Printer): void;
-//# sourceMappingURL=tracer.d.ts.map
-
-//#endregion
-export { EVENT_ANY, EVENT_EMPTY, FsmBaseClass, FsmEventKey, FsmProcess, FsmProcessDump, FsmProcessDumpHandler, FsmProcessHandler, FsmState, FsmStateConfig, FsmStateDescriptor, FsmStateDump, FsmStateDumpHandler, FsmStateErrorHandler, FsmStateHandler, FsmStateKey, HandlerRegistry, KEY_DISPATCH, KEY_EVENT, KEY_LAUNCH_PROCESS, KEY_STATES, KEY_TERMINATE, LauncherConfig, Printer, PrinterConfig, ProcessDef, ProcessHandle, STATE_ANY, STATE_FINAL, STATE_INITIAL, STATUS_ENTER, STATUS_EXIT, STATUS_FINISHED, STATUS_FIRST, STATUS_LAST, STATUS_LEAF, STATUS_NEXT, STATUS_NONE, StageHandler, bindMethods, createHandlerRegistry, getPrinter, getProcessPrinter, getStateTransitions, isStateTransitionEnabled, launcher, preparePrinter, setProcessPrinter, setProcessTracer, setStateTracer, startFsmProcess, startProcess, toStageHandlers };
-//# sourceMappingURL=index-vTjnkbGW.d.ts.map

package/dist/index-vTjnkbGW.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-vTjnkbGW.d.ts","names":[],"sources":["../src/core/fsm-base-class.ts","../src/core/fsm-state-descriptor.ts","../src/core/fsm-state.ts","../src/core/fsm-process.ts","../src/orchestrator/start-process.ts","../src/utils/printer.ts","../src/utils/tracer.ts"],"mappings":"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"}

package/dist/launcher-6VUDviTj.d.ts

@@ -1,48 +0,0 @@
-//#region src/core/fsm-state-config.d.ts
-declare const STATE_ANY = "*";
-declare const STATE_INITIAL = "";
-declare const STATE_FINAL = "";
-declare const EVENT_ANY = "*";
-declare const EVENT_EMPTY = "";
-type FsmStateKey = string;
-type FsmEventKey = string;
-type FsmStateConfig = {
-  key: FsmStateKey;
-  transitions?: [from: FsmStateKey, event: FsmEventKey, to: FsmStateKey][];
-  states?: FsmStateConfig[];
-} & Record<string, unknown>;
-//# sourceMappingURL=fsm-state-config.d.ts.map
-//#endregion
-//#region src/orchestrator/handler-registry.d.ts
-/** A handler invoked when a state is entered. */
-type StageHandler<C = Record<string, unknown>> = (context: C) => void | (() => void | Promise<void>) | Promise<void | (() => void | Promise<void>)> | AsyncGenerator<string, void, unknown> | Generator<string, void, unknown>;
-/** Maps a state key to a handler module key for auto-discovery. */
-type PatternFn = (state: string) => string;
-interface HandlerRegistry {
-  register(processName: string, config: FsmStateConfig): () => void;
-  registerHandlers(processName: string, ...modules: unknown[]): () => void;
-  getConfig(processName: string): FsmStateConfig;
-  getLoader<C>(processName: string, patterns?: PatternFn[]): (state: string, event?: string) => StageHandler<C>[];
-}
-declare function createHandlerRegistry(): HandlerRegistry;
-declare function toStageHandlers<C>(value: unknown, accept: (key: string, value: unknown) => boolean): StageHandler<C>[];
-//#endregion
-//#region src/orchestrator/launcher.d.ts
-declare const KEY_LAUNCH_PROCESS = "fsm:launch";
-interface LauncherConfig {
-  processes: ProcessDef[];
-  start?: string[];
-  context?: (parent: Record<string, unknown>) => Record<string, unknown>;
-}
-interface ProcessDef {
-  name: string;
-  config: FsmStateConfig;
-  handlers?: (StageHandler | Record<string, StageHandler | StageHandler[]>)[];
-  start?: boolean;
-}
-declare function launcher(config: LauncherConfig): Promise<() => Promise<void>>;
-//# sourceMappingURL=launcher.d.ts.map
-
-//#endregion
-export { HandlerRegistry as a, toStageHandlers as c, FsmEventKey as d, FsmStateConfig as f, STATE_INITIAL as g, STATE_FINAL as h, launcher as i, EVENT_ANY as l, STATE_ANY as m, LauncherConfig as n, StageHandler as o, FsmStateKey as p, ProcessDef as r, createHandlerRegistry as s, KEY_LAUNCH_PROCESS as t, EVENT_EMPTY as u };
-//# sourceMappingURL=launcher-6VUDviTj.d.ts.map

package/dist/launcher-6VUDviTj.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"launcher-6VUDviTj.d.ts","names":[],"sources":["../src/core/fsm-state-config.ts","../src/orchestrator/handler-registry.ts","../src/orchestrator/launcher.ts"],"mappings":";cAAa,SAAA;AAAA,cACA,aAAA,GADS,EAAA;AACT,cACA,WAAA,GADa,EAAA;AACb,cACA,SAAA,GADW,GAAA;AACX,cACA,WAAA,GADS,EAAA;AACT,KAED,WAAA,GAFY,MAAA;AAEZ,KACA,WAAA,GADW,MAAA;AACX,KACA,cAAA,GADW;EACX,GAAA,EACL,WADK;EAAc,WAAA,CAAA,EAAA,CAAA,IAAA,EAEH,WAFG,EAAA,KAAA,EAEiB,WAFjB,EAAA,EAAA,EAEkC,WAFlC,CAAA,EAAA;QACnB,CAAA,EAEI,cAFJ,EAAA;IAGH,MAFmB,CAAA,MAAA,EAAA,OAAA,CAAA;;;;AAVvB;AACa,KCED,YDFc,CAAA,ICEG,MDFH,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,GAAA,CAAA,OAAA,ECGf,CDHe,EAAA,GAAA,IAAA,GAAA,CAAA,GAAA,GAAA,IAAA,GCMR,ODNQ,CAAA,IAAA,CAAA,CAAA,GCOtB,ODPsB,CAAA,IAAA,GAAA,CAAA,GAAA,GAAA,IAAA,GCOO,ODPP,CAAA,IAAA,CAAA,CAAA,CAAA,GCQtB,cDRsB,CAAA,MAAA,EAAA,IAAA,EAAA,OAAA,CAAA,GCStB,SDTsB,CAAA,MAAA,EAAA,IAAA,EAAA,OAAA,CAAA;AAC1B;AACA,KCUK,SAAA,GDViB,CAAA,KAAA,EAAA,MAAA,EAAA,GAAA,MAAA;AACT,UCkBI,eAAA,CDlBO;EAEZ,QAAA,CAAA,WAAW,EAAA,MAAA,EAAA,MAAA,ECiBiB,cDjBjB,CAAA,EAAA,GAAA,GAAA,IAAA;EACX,gBAAW,CAAA,WAAA,EAAA,MAAA,EAAA,GAAA,OAAA,EAAA,OAAA,EAAA,CAAA,EAAA,GAAA,GAAA,IAAA;EACX,SAAA,CAAA,WAAc,EAAA,MAAA,CAAA,ECiBQ,cDjBR;EAAA,SAAA,CAAA,CAAA,CAAA,CAAA,WAAA,EAAA,MAAA,EAAA,QAAA,CAAA,ECoBX,SDpBW,EAAA,CAAA,EAAA,CAAA,KAAA,EAAA,MAAA,EAAA,KAAA,CAAA,EAAA,MAAA,EAAA,GCqBc,YDrBd,CCqB2B,CDrB3B,CAAA,EAAA;;AAEH,iBCsBP,qBAAA,CAAA,CDtBO,ECsBkB,eDtBlB;AAAoB,iBCiF3B,eDjF2B,CAAA,CAAA,CAAA,CAAA,KAAA,EAAA,OAAA,EAAA,MAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAAA,OAAA,EAAA,GAAA,OAAA,CAAA,ECoFxC,YDpFwC,CCoF3B,CDpF2B,CAAA,EAAA;;;AAT9B,cEIA,kBAAA,GFJa,YAAA;AACb,UEKI,cAAA,CFLO;EACX,SAAA,EEKA,UFLS,EAAA;EACT,KAAA,CAAA,EAAA,MAAW,EAAA;EAEZ,OAAA,CAAA,EAAA,CAAA,MAAW,EEIF,MFJE,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GEI0B,MFJ1B,CAAA,MAAA,EAAA,OAAA,CAAA;AACvB;AACY,UEKK,UAAA,CFLS;EAAA,IAAA,EAAA,MAAA;QACnB,EEMG,cFNH;UACgB,CAAA,EAAA,CEMT,YFNS,GEMM,MFNN,CAAA,MAAA,EEMqB,YFNrB,GEMoC,YFNpC,EAAA,CAAA,CAAA,EAAA;OAAoB,CAAA,EAAA,OAAA;;AAChC,iBESW,QAAA,CFTX,MAAA,EEUD,cFVC,CAAA,EEWR,OFXQ,CAAA,GAAA,GEWM,OFXN,CAAA,IAAA,CAAA,CAAA"}