aifsmjs 0.5.9 → 0.6.0

package/dist/{chunk-TPCDOVU4.cjs → chunk-YK25NVFC.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkI354FONA_cjs = require('./chunk-I354FONA.cjs');
-var chunkCDK25FTD_cjs = require('./chunk-CDK25FTD.cjs');
+var chunkVGLF5NQH_cjs = require('./chunk-VGLF5NQH.cjs');
+var chunkQCTA2X4J_cjs = require('./chunk-QCTA2X4J.cjs');
 
 // src/fsm/types.ts
 var RESET_EVENT_TYPE = "@@aifsmjs/RESET";
@@ -13,13 +13,16 @@ var InvalidDefinitionError = class extends Error {
     this.name = "InvalidDefinitionError";
   }
 };
+function assertObject(value, subject) {
+  if (value === null || typeof value !== "object") {
+    throw new InvalidDefinitionError(`${subject} must be an object`);
+  }
+}
 function validateDefinition(def, seen = /* @__PURE__ */ new WeakSet()) {
   if (!def.id || typeof def.id !== "string") {
     throw new InvalidDefinitionError("definition must have a non-empty string `id`");
   }
-  if (!def.states || typeof def.states !== "object") {
-    throw new InvalidDefinitionError("definition must have a `states` object");
-  }
+  assertObject(def.states, "definition states");
   const stateKeys = Object.keys(def.states);
   if (stateKeys.length === 0) {
     throw new InvalidDefinitionError("`states` must declare at least one state");
@@ -30,6 +33,7 @@ function validateDefinition(def, seen = /* @__PURE__ */ new WeakSet()) {
     );
   }
   for (const [stateName, stateDef] of Object.entries(def.states)) {
+    assertObject(stateDef, `state "${stateName}"`);
     if (stateDef.sub !== void 0) {
       const sub = stateDef.sub;
       const subStates = sub.states;
@@ -48,14 +52,15 @@ function validateDefinition(def, seen = /* @__PURE__ */ new WeakSet()) {
     }
     if (!stateDef.on) continue;
     for (const [evtType, entry] of Object.entries(stateDef.on)) {
-      const transitions = chunkI354FONA_cjs.normalizeTransitions(entry);
+      const transitions = chunkVGLF5NQH_cjs.normalizeTransitions(entry);
       for (const t of transitions) {
+        assertObject(t, `transition ${stateName} -[${evtType}]->`);
         if (t.target !== void 0 && !stateKeys.includes(t.target)) {
           throw new InvalidDefinitionError(
             `transition ${stateName} -[${evtType}]-> "${String(t.target)}" targets an unknown state`
           );
         }
-        if (t.guard !== void 0 && chunkCDK25FTD_cjs.isAsyncGuardFn(t.guard)) {
+        if (t.guard !== void 0 && chunkQCTA2X4J_cjs.isAsyncGuardFn(t.guard)) {
           throw new InvalidDefinitionError(
             `transition ${stateName} -[${evtType}]-> uses an async guard. Guards must be sync; move I/O into an effect.`
           );
@@ -63,24 +68,30 @@ function validateDefinition(def, seen = /* @__PURE__ */ new WeakSet()) {
       }
     }
   }
+  const path = /* @__PURE__ */ new Set();
+  let d = def;
+  while (d) {
+    if (path.has(d)) {
+      throw new InvalidDefinitionError(
+        `sub-machine cycle through initial states: "${d.id}" is re-entered via initial-state subs`
+      );
+    }
+    path.add(d);
+    d = d.states[d.initial]?.sub;
+  }
 }
 function defineMachine(def) {
-  const normalized = !("context" in def) ? { ...def, context: {} } : def;
+  assertObject(def, "definition");
+  const normalized = def.context === void 0 ? { ...def, context: {} } : def;
   validateDefinition(normalized);
   return normalized;
 }
 function setup() {
-  return {
-    defineMachine: (def) => {
-      const cast = !("context" in def) ? { ...def, context: {} } : def;
-      validateDefinition(cast);
-      return cast;
-    }
-  };
+  return { defineMachine };
 }
 function initialSnapshot(def) {
   const isFinal = def.states[def.initial]?.final === true;
-  return chunkI354FONA_cjs.freezeSnapshot({
+  return chunkVGLF5NQH_cjs.freezeSnapshot({
     value: def.initial,
     context: def.context,
     status: isFinal ? "final" : "active"
@@ -126,15 +137,29 @@ function composeMiddleware(middleware) {
     dispatch(0);
   };
 }
+function assertListener(listener) {
+  if (typeof listener !== "function") {
+    throw new InvalidDefinitionError("listener must be a function");
+  }
+}
 function createRuntime(def, impl, opts = {}) {
+  assertObject(def, "definition");
+  assertObject(def.states, "definition states");
+  assertObject(impl, "implementations");
+  assertObject(opts, "options");
+  const middleware = opts.middleware;
+  if (middleware !== void 0 && !(Array.isArray(middleware) && middleware.every((fn) => typeof fn === "function"))) {
+    throw new InvalidDefinitionError("options.middleware must be an array of functions");
+  }
   let snapshot = initialSnapshot(def);
   const listeners = /* @__PURE__ */ new Set();
-  const middlewareChain = opts.middleware && opts.middleware.length > 0 ? composeMiddleware(opts.middleware) : void 0;
+  const middlewareChain = middleware && middleware.length > 0 ? composeMiddleware(middleware) : void 0;
   const shouldDispatch = opts.dispatchEffects !== false;
   const controller = new AbortController();
   let disposed = false;
+  let dispatching = false;
+  const mailbox = [];
   let childRuntime;
-  let childAbortCleanup;
   const eventListeners = {
     transition: /* @__PURE__ */ new Set(),
     error: /* @__PURE__ */ new Set(),
@@ -142,162 +167,131 @@ function createRuntime(def, impl, opts = {}) {
   };
   const externalAbortCleanups = /* @__PURE__ */ new Set();
   function emit(type, payload) {
-    for (const fn of Array.from(eventListeners[type])) fn(payload);
-  }
-  function notify(committed) {
-    const captured = committed ?? snapshot;
-    for (const l of Array.from(listeners)) l(captured);
-  }
-  function runMiddleware(prev, event, effects, changed) {
-    if (!middlewareChain) return;
-    middlewareChain(chunkI354FONA_cjs.deepFreeze({ prev, next: snapshot, event, effects, changed }), () => {
-    });
+    const set = eventListeners[type];
+    let failed = false;
+    let firstError;
+    for (const fn of Array.from(set)) {
+      if (!set.has(fn)) continue;
+      try {
+        fn(payload);
+      } catch (err) {
+        if (!failed) {
+          failed = true;
+          firstError = err;
+        }
+      }
+    }
+    if (failed) throw firstError;
   }
   function dispatchEffects(effects, context, event) {
     if (!impl.effects || effects.length === 0) return;
     for (const eff of effects) {
-      const handler = impl.effects[eff.type];
+      const handler = chunkQCTA2X4J_cjs.ownValue(impl.effects, eff.type);
       if (!handler) continue;
       const r = handler(eff, { context, event, signal: controller.signal });
-      if (chunkCDK25FTD_cjs.isThenable(r)) {
+      if (chunkQCTA2X4J_cjs.isThenable(r)) {
         Promise.resolve(r).catch((err) => {
-          emit("error", { error: err, event });
+          if (eventListeners.error.size > 0) emit("error", { error: err, event });
+          else if (chunkVGLF5NQH_cjs.IS_DEV) {
+            console.warn(
+              'aifsmjs: unhandled async effect rejection; register runtime.on("error", ...)',
+              err
+            );
+          }
         });
       }
     }
   }
-  function wireChildAbort(child) {
-    if (controller.signal.aborted) {
+  function swapChild(prevValue, nextValue) {
+    const stateDef = def.states[nextValue];
+    let next;
+    if (stateDef?.sub) {
       try {
-        child.dispose();
-      } catch {
-      }
-      return () => {
-      };
-    }
-    const onAbort = () => {
-      try {
-        child.dispose();
-      } catch {
-      }
-    };
-    controller.signal.addEventListener("abort", onAbort, { once: true });
-    return () => controller.signal.removeEventListener("abort", onAbort);
-  }
-  function initChildFor(stateValue) {
-    const stateDef = def.states[stateValue];
-    const sub = stateDef?.sub;
-    if (sub === void 0) return;
-    let newChild;
-    try {
-      newChild = createRuntime(sub, stateDef.subImpl ?? {});
-    } catch (cause) {
-      throw new SubMachineError(stateValue, "init", cause);
-    }
-    childRuntime = newChild;
-    childAbortCleanup = wireChildAbort(newChild);
-  }
-  function findChosenIsExternal(value, event, context) {
-    const state = def.states[value];
-    if (!state?.on) return false;
-    const list = chunkI354FONA_cjs.normalizeTransitions(state.on[event.type]);
-    if (list.length === 0) return false;
-    for (const t of list) {
-      if (!t.guard || chunkCDK25FTD_cjs.evalGuard(t.guard, context, event, impl, value)) {
-        return t.target !== void 0;
+        next = createRuntime(stateDef.sub, stateDef.subImpl ?? {});
+      } catch (cause) {
+        throw new SubMachineError(nextValue, "init", cause);
       }
     }
-    return false;
-  }
-  function applySubLifecycle(prevValue, nextValue) {
-    const prevStateDef = def.states[prevValue];
-    const nextStateDef = def.states[nextValue];
-    if (prevStateDef?.sub !== void 0 && childRuntime !== void 0) {
-      const child = childRuntime;
+    const old = childRuntime;
+    if (old) {
       childRuntime = void 0;
-      childAbortCleanup?.();
-      childAbortCleanup = void 0;
       try {
-        child.dispose();
+        old.dispose();
       } catch (cause) {
+        next?.dispose();
         throw new SubMachineError(prevValue, "dispose", cause);
       }
     }
-    if (nextStateDef?.sub !== void 0) {
-      initChildFor(nextValue);
-    }
+    if (disposed) next?.dispose();
+    else childRuntime = next;
   }
-  function send(event) {
-    if (disposed) throw new RuntimeDisposedError();
-    const prev = snapshot;
-    const result = chunkI354FONA_cjs.step(def, prev, event, impl);
-    const isExternal = result.changed && (prev.value !== result.snapshot.value || findChosenIsExternal(prev.value, event, prev.context));
-    if (result.changed && isExternal) applySubLifecycle(prev.value, result.snapshot.value);
-    snapshot = result.snapshot;
-    const committed = result.snapshot;
-    runMiddleware(prev, event, result.effects, result.changed);
-    if (shouldDispatch) dispatchEffects(result.effects, committed.context, event);
-    if (result.changed) {
-      notify(committed);
+  function commit(prev, next, event, effects, changed) {
+    snapshot = next;
+    middlewareChain?.(
+      Object.freeze({ prev, next, event, effects: chunkVGLF5NQH_cjs.deepFreeze(effects), changed }),
+      () => {
+      }
+    );
+    if (shouldDispatch) dispatchEffects(effects, next.context, event);
+    if (changed) {
+      for (const l of Array.from(listeners)) if (listeners.has(l)) l(next);
       emit("transition", {
         prev,
-        next: committed,
+        next,
         event,
-        effects: result.effects,
+        effects,
         changed: true
       });
     }
-    return snapshot;
   }
-  function reset(event) {
-    if (disposed) throw new RuntimeDisposedError();
+  function processSend(event) {
     const prev = snapshot;
-    const nextSnap = initialSnapshot(def);
-    const changed = prev.value !== nextSnap.value;
-    if (childRuntime) {
-      const child = childRuntime;
-      childRuntime = void 0;
-      childAbortCleanup?.();
-      childAbortCleanup = void 0;
-      try {
-        child.dispose();
-      } catch (cause) {
-        throw new SubMachineError(prev.value, "dispose", cause);
-      }
+    const { result, external } = chunkVGLF5NQH_cjs.stepWithMeta(def, prev, event, impl);
+    if (result.changed && (prev.value !== result.snapshot.value || external)) {
+      swapChild(prev.value, result.snapshot.value);
     }
-    const initStateDef = def.states[nextSnap.value];
-    if (initStateDef?.sub) {
-      initChildFor(nextSnap.value);
+    commit(prev, result.snapshot, event, result.effects, result.changed);
+  }
+  function processReset(event) {
+    const prev = snapshot;
+    const next = initialSnapshot(def);
+    swapChild(prev.value, next.value);
+    commit(
+      prev,
+      next,
+      event ?? RESET_EVENT,
+      [],
+      prev.value !== next.value || prev.status !== next.status || prev.context !== next.context
+    );
+  }
+  function run(entry) {
+    if (disposed) throw new RuntimeDisposedError();
+    if ((entry.kind === "send" || entry.event !== void 0) && typeof entry.event?.type !== "string") {
+      throw new InvalidDefinitionError(
+        `${entry.kind}() event must be an object with a string type`
+      );
     }
-    snapshot = nextSnap;
-    const committed = nextSnap;
-    const triggerEvent = event ?? RESET_EVENT;
-    runMiddleware(prev, triggerEvent, [], changed);
-    if (changed) {
-      notify(committed);
-      emit("transition", {
-        prev,
-        next: committed,
-        event: triggerEvent,
-        effects: [],
-        changed: true
-      });
+    if (dispatching) {
+      mailbox.push(entry);
+      return snapshot;
     }
-    return snapshot;
-  }
-  function can(event) {
-    if (disposed || snapshot.status === "final") return false;
-    const state = def.states[snapshot.value];
-    if (!state) return false;
-    const list = chunkI354FONA_cjs.normalizeTransitions(state.on?.[event.type]);
-    if (list.length === 0) return false;
-    for (const t of list) {
-      if (!t.guard) return true;
-      if (chunkCDK25FTD_cjs.evalGuard(t.guard, snapshot.context, event, impl, snapshot.value)) return true;
+    dispatching = true;
+    try {
+      for (let m = entry; m && !disposed; m = mailbox.shift()) {
+        if (m.kind === "send") processSend(m.event);
+        else processReset(m.event);
+      }
+    } finally {
+      dispatching = false;
+      mailbox.length = 0;
     }
-    return false;
+    return snapshot;
   }
   function on(type, listener, options) {
+    if (!Object.hasOwn(eventListeners, type)) {
+      throw new InvalidDefinitionError('on() type must be "transition", "error" or "dispose"');
+    }
+    assertListener(listener);
     if (disposed || options?.signal?.aborted) return () => {
     };
     const target = eventListeners[type];
@@ -329,14 +323,12 @@ function createRuntime(def, impl, opts = {}) {
   function dispose() {
     if (disposed) return;
     disposed = true;
-    if (childRuntime) {
-      childAbortCleanup?.();
-      childAbortCleanup = void 0;
-      try {
-        childRuntime.dispose();
-      } catch {
-      }
-      childRuntime = void 0;
+    mailbox.length = 0;
+    const child = childRuntime;
+    childRuntime = void 0;
+    try {
+      child?.dispose();
+    } catch {
     }
     controller.abort();
     listeners.clear();
@@ -352,9 +344,10 @@ function createRuntime(def, impl, opts = {}) {
   const runtime = {
     getSnapshot: () => snapshot,
     snapshot: () => snapshot,
-    send,
-    can,
-    reset,
+    send: (event) => run({ kind: "send", event }),
+    // Same candidate resolution as step(), without running any action.
+    can: (event) => !disposed && chunkVGLF5NQH_cjs.chooseTransition(def, snapshot, event, impl) !== void 0,
+    reset: (event) => run({ kind: "reset", event }),
     dispose,
     on,
     get disposed() {
@@ -364,6 +357,7 @@ function createRuntime(def, impl, opts = {}) {
       return controller.signal;
     },
     subscribe(listener) {
+      assertListener(listener);
       if (disposed) return () => {
       };
       listeners.add(listener);
@@ -372,10 +366,7 @@ function createRuntime(def, impl, opts = {}) {
     subRuntime: () => childRuntime,
     onTransition: (handler, options) => on("transition", handler, options)
   };
-  const bootStateDef = def.states[snapshot.value];
-  if (bootStateDef?.sub) {
-    initChildFor(snapshot.value);
-  }
+  swapChild(snapshot.value, snapshot.value);
   return runtime;
 }
 
@@ -388,5 +379,5 @@ exports.createRuntime = createRuntime;
 exports.defineMachine = defineMachine;
 exports.initialSnapshot = initialSnapshot;
 exports.setup = setup;
-//# sourceMappingURL=chunk-TPCDOVU4.cjs.map
-//# sourceMappingURL=chunk-TPCDOVU4.cjs.map
+//# sourceMappingURL=chunk-YK25NVFC.cjs.map
+//# sourceMappingURL=chunk-YK25NVFC.cjs.map

package/dist/chunk-YK25NVFC.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fsm/types.ts","../src/fsm/definition.ts","../src/fsm/runtime.ts"],"names":["normalizeTransitions","isAsyncGuardFn","freezeSnapshot","ownValue","isThenable","IS_DEV","deepFreeze","stepWithMeta","chooseTransition"],"mappings":"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","file":"chunk-YK25NVFC.cjs","sourcesContent":["// All public types live here so AI agents and humans can read the entire\n// public surface in one file.\n\nexport type Effect = Readonly<{ type: string; payload?: unknown }>;\n\nexport type Enqueuer = Readonly<{\n  effect: (type: string, payload?: unknown) => void;\n}>;\n\nexport type GuardArgs<Ctx, Evt> = Readonly<{\n  context: Ctx;\n  event: Evt;\n  /**\n   * Optional guard registry, threaded by `evalGuard` so combinators can resolve\n   * string refs nested inside `and / or / not`. Inline user guards may safely\n   * ignore this field — it is `undefined` when guards are evaluated outside of\n   * `evalGuard` (e.g. in unit tests calling the function directly).\n   */\n  guards?: Readonly<Record<string, Guard<Ctx, Evt>>>;\n  /**\n   * Current state value, threaded by `evalGuard` from the live snapshot. Used\n   * by the `stateIn` combinator. `undefined` when guards are called outside of\n   * a lifecycle evaluation.\n   */\n  value?: string;\n}>;\n\nexport type Guard<Ctx, Evt> = (args: GuardArgs<Ctx, Evt>) => boolean;\n\nexport type Action<Ctx, Evt> = (args: {\n  context: Ctx;\n  event: Evt;\n  enqueue: Enqueuer;\n}) => Partial<Ctx> | void;\n\nexport type EffectHandler<Ctx, Evt> = (\n  effect: Effect,\n  args: { context: Ctx; event: Evt; signal: AbortSignal },\n) => void | Promise<void>;\n\nexport type GuardRef<Ctx, Evt> = string | Guard<Ctx, Evt>;\nexport type ActionRef<Ctx, Evt> = string | Action<Ctx, Evt>;\n\nexport type TransitionDef<Ctx, Evt, States extends string> = Readonly<{\n  target?: States;\n  guard?: GuardRef<Ctx, Evt>;\n  actions?: readonly ActionRef<Ctx, Evt>[];\n}>;\n\n/**\n * A single transition as written in a `StateDef.on` map. Either the full\n * {@link TransitionDef} object form, or the string shorthand `\"targetState\"`\n * (à la XState) which the resolver normalizes to `{ target: \"targetState\" }`\n * before processing. The shorthand carries no guard or actions.\n *\n * @since 0.5.3\n */\nexport type TransitionConfig<Ctx, Evt, States extends string> =\n  | States\n  | TransitionDef<Ctx, Evt, States>;\n\n/**\n * @experimental v0.3.0\n *\n * A nested machine definition attachable to StateDef.sub. The type parameters\n * are independent from the parent machine's <Ctx, Evt, States>; sub-machines\n * may have entirely unrelated context and event shapes.\n *\n * This is an alias for MachineDef — sub-machines have the same definition\n * shape as top-level machines. The relationship is purely lifecycle:\n * a sub-machine instance is created when its parent state becomes active\n * and disposed when the parent state exits.\n */\nexport type SubMachineDef<\n  SubCtx,\n  SubEvt extends { type: string },\n  SubStates extends string,\n> = MachineDef<SubCtx, SubEvt, SubStates>;\n\nexport type StateDef<Ctx, Evt, States extends string> = Readonly<{\n  on?: Readonly<\n    Record<\n      string,\n      TransitionConfig<Ctx, Evt, States> | readonly TransitionConfig<Ctx, Evt, States>[]\n    >\n  >;\n  entry?: readonly ActionRef<Ctx, Evt>[];\n  exit?: readonly ActionRef<Ctx, Evt>[];\n  final?: boolean;\n  /**\n   * Optional sub-machine. When the runtime enters a state with `sub`,\n   * the sub-machine is lazily instantiated; when it exits, the sub-machine\n   * is disposed. See STABILITY.md for the experimental contract.\n   *\n   * The generic parameters are erased to `any` because sub-machine type\n   * parameters are intentionally independent from the parent's `Ctx` / `Evt`\n   * / `States`. `MachineDef`'s generics are invariant (guards / actions\n   * consume them), so the storage position must use `any` rather than\n   * `unknown`. Caller narrows via `runtime.subRuntime() as Runtime<...>`.\n   *\n   * @experimental since 0.3.0\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: see JSDoc — invariant generic escape hatch\n  sub?: MachineDef<any, any, any>;\n  /**\n   * Implementations for `sub`. Ignored if `sub` is absent. Defaults to `{}`\n   * (sub-machine must rely on inline guards / actions / effects only).\n   *\n   * @experimental since 0.3.0\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: same reason as `sub` above\n  subImpl?: Implementations<any, any>;\n}>;\n\nexport type MachineDef<Ctx, Evt extends { type: string }, States extends string> = Readonly<{\n  id: string;\n  initial: States;\n  context: Ctx;\n  states: Readonly<Record<States, StateDef<Ctx, Evt, States>>>;\n}>;\n\n/**\n * Input shape accepted by `defineMachine` / `setup().defineMachine`. Identical\n * to {@link MachineDef} except `context` is **optional** — when omitted it\n * defaults to `{}` (paired with the `Ctx = Record<string, never>` default type\n * parameter). The returned value is always a fully-normalized\n * {@link MachineDef} with `context` present, so downstream consumers are\n * unaffected.\n *\n * @since 0.5.3\n */\nexport type MachineConfig<Ctx, Evt extends { type: string }, States extends string> = Readonly<{\n  id: string;\n  initial: States;\n  states: Readonly<Record<States, StateDef<Ctx, Evt, States>>>;\n}> &\n  // `context` may be omitted only when `Ctx` has no required properties (e.g. the\n  // default `Record<string, never>`). If `Ctx` has required fields it must be\n  // supplied, so omitting it can't silently default to `{}` and crash at runtime.\n  (Record<string, never> extends Ctx ? { readonly context?: Ctx } : { readonly context: Ctx });\n\nexport type Snapshot<Ctx, States extends string> = Readonly<{\n  value: States;\n  context: Ctx;\n  status: \"active\" | \"final\";\n}>;\n\nexport type Implementations<Ctx, Evt> = Readonly<{\n  guards?: Readonly<Record<string, Guard<Ctx, Evt>>>;\n  actions?: Readonly<Record<string, Action<Ctx, Evt>>>;\n  effects?: Readonly<Record<string, EffectHandler<Ctx, Evt>>>;\n}>;\n\nexport type StepResult<Ctx, States extends string> = Readonly<{\n  snapshot: Snapshot<Ctx, States>;\n  effects: readonly Effect[];\n  changed: boolean;\n}>;\n\n/**\n * Sentinel event type that `Runtime.reset()` synthesises when the caller does\n * not pass an explicit event. Middleware receives it through\n * `MiddlewareContext.event`. Exposed so user code can discriminate.\n */\nexport const RESET_EVENT_TYPE = \"@@aifsmjs/RESET\" as const;\nexport type ResetEvent = Readonly<{ type: typeof RESET_EVENT_TYPE }>;\n\nexport type MiddlewareContext<Ctx, Evt, States extends string> = Readonly<{\n  prev: Snapshot<Ctx, States>;\n  next: Snapshot<Ctx, States>;\n  /**\n   * The triggering event. May be the user's `Evt` (from `send()` or an\n   * explicit `reset(event)`) or the `ResetEvent` sentinel emitted by a\n   * `reset()` with no event argument. This is the caller's event object,\n   * passed unfrozen; treat it as read-only.\n   */\n  event: Evt | ResetEvent;\n  /** Deep-frozen effect descriptors (payloads included) about to be dispatched. */\n  effects: readonly Effect[];\n  changed: boolean;\n}>;\n\nexport type Middleware<Ctx, Evt, States extends string> = (\n  ctx: MiddlewareContext<Ctx, Evt, States>,\n  next: () => void,\n) => void;\n\n/**\n * Payload of the `'transition'` runtime event — emitted whenever a transition\n * fired (`changed === true`), including an internal transition whose state\n * `value` did not change (only its `context` did).\n */\nexport type RuntimeTransitionEvent<Ctx, Evt, States extends string> = Readonly<{\n  prev: Snapshot<Ctx, States>;\n  next: Snapshot<Ctx, States>;\n  event: Evt | ResetEvent;\n  effects: readonly Effect[];\n  changed: boolean;\n}>;\n\n/**\n * Payload of the `'error'` runtime event — currently emitted for async effect\n * handler rejections (which would otherwise become unhandled). With no\n * `'error'` listener (none registered, or cleared by `dispose()`) a rejection\n * is discarded; outside production (`NODE_ENV !== \"production\"`) it is also\n * reported via `console.warn`. Synchronous throws from effect handlers and\n * middleware still propagate to the caller of `send()` / `reset()`.\n */\nexport type RuntimeErrorEvent<Evt> = Readonly<{\n  error: unknown;\n  event: Evt | ResetEvent | undefined;\n}>;\n\nexport type RuntimeEventMap<Ctx, Evt, States extends string> = {\n  transition: RuntimeTransitionEvent<Ctx, Evt, States>;\n  error: RuntimeErrorEvent<Evt>;\n  dispose: void;\n};\n\nexport interface Runtime<Ctx, Evt extends { type: string }, States extends string> {\n  getSnapshot(): Snapshot<Ctx, States>;\n  /** Alias for `getSnapshot()`. */\n  snapshot(): Snapshot<Ctx, States>;\n  /**\n   * Process `event`: `step()` -> sub-machine lifecycle -> commit ->\n   * middleware -> effects -> `subscribe` listeners -> `'transition'`\n   * listeners, then return the committed snapshot.\n   *\n   * Run-to-completion: a `send()`/`reset()` made while this runtime is already\n   * processing an event (from middleware, an effect handler, a listener, or a\n   * child runtime's listener) is queued FIFO and processed after the current\n   * event's last notification, with the same full sequence. Such a nested\n   * call returns the snapshot committed at the time of the call, not the\n   * outcome of its own event — read `getSnapshot()` after the outermost call\n   * returns (or subscribe). A throw from any queued event discards the rest\n   * of the queue and propagates from the outermost call.\n   *\n   * Throws `RuntimeDisposedError` after `dispose()`, and\n   * `InvalidDefinitionError` when `event` is not an object with a string\n   * `type`.\n   */\n  send(event: Evt): Snapshot<Ctx, States>;\n  /**\n   * Predict whether sending `event` would fire a transition. Reuses\n   * `resolveTransitions` + `evalGuard` without applying any actions. Guards\n   * are expected to be pure; `can` then matches `send` for the same input.\n   */\n  can(event: Evt): boolean;\n  /**\n   * Call `listener` with the committed snapshot after every event that fired\n   * a transition (`changed === true`), after middleware and effects and before\n   * `'transition'` listeners. A listener removed during a notification round\n   * is skipped for the rest of it; one added waits for the next event.\n   * Throws `InvalidDefinitionError` if `listener` is not a function. Returns\n   * an unsubscribe function (a no-op after `dispose()`).\n   */\n  subscribe(listener: (snap: Snapshot<Ctx, States>) => void): () => void;\n  /**\n   * EventTarget-like typed listener API. Returns an unsubscribe function.\n   * `options.signal` removes the listener when aborted; `options.once`\n   * removes the listener before its first invocation. A listener removed\n   * while an event is being dispatched (by its unsubscribe, `once`, its\n   * signal, or `dispose()`) is skipped for the rest of that dispatch; one\n   * added waits for the next event. Throws `InvalidDefinitionError` for an\n   * unknown event `type` or a non-function `listener`. After `dispose()`,\n   * `on()` is a no-op and returns a no-op unsubscribe.\n   */\n  on<K extends keyof RuntimeEventMap<Ctx, Evt, States>>(\n    type: K,\n    listener: (payload: RuntimeEventMap<Ctx, Evt, States>[K]) => void,\n    options?: { signal?: AbortSignal; once?: boolean },\n  ): () => void;\n  /**\n   * Re-initialise the runtime to the definition's initial snapshot. Does NOT\n   * run entry actions (reset = re-birth, not \"transition into initial\"); the\n   * current sub-machine child is always replaced. Notifies subscribers,\n   * middleware (`changed: true`) and `'transition'` listeners whenever the\n   * value, status, or context reference differs from the initial snapshot.\n   * Throws RuntimeDisposedError if disposed. If an `event` is supplied (an\n   * object with a string `type`, else `InvalidDefinitionError`), middleware\n   * sees it as the trigger; otherwise a sentinel\n   * `{ type: \"@@aifsmjs/RESET\" }` is synthesised. Run-to-completion like\n   * `send()`: a nested call is queued.\n   */\n  reset(event?: Evt): Snapshot<Ctx, States>;\n  /**\n   * Tear down: abort the internal AbortController (effect handlers see signal\n   * fire), clear listeners, and mark this runtime as disposed. Subsequent\n   * send()/reset() calls throw RuntimeDisposedError. Idempotent and never\n   * throws. Never queued: called during a dispatch it runs at once, drops any\n   * queued send()/reset() calls, and the outer call returns the last\n   * committed snapshot.\n   */\n  dispose(): void;\n  /**\n   * True after `dispose()` has been called.\n   */\n  readonly disposed: boolean;\n  /**\n   * AbortSignal scoped to this runtime's lifetime. Fires once on dispose().\n   * Threaded to every EffectHandler invocation; external integrations\n   * (e.g. component teardown) can also attach `signal.addEventListener(\"abort\", ...)`.\n   */\n  readonly signal: AbortSignal;\n  /**\n   * @experimental v0.3.0\n   *\n   * Returns the currently active sub-Runtime for the current parent state,\n   * or undefined if:\n   *   - the current state has no `sub` definition, OR\n   *   - the previous child's `dispose()` threw during a transition\n   *     (SubMachineError phase \"dispose\"; the parent stays in its state and\n   *     the child is recreated when the state is re-entered), OR\n   *   - the parent runtime has been disposed.\n   *\n   * When a transition's new child fails to initialise (SubMachineError phase\n   * \"init\"), the previous child is left untouched and is still returned. A\n   * child that fails to initialise at `createRuntime` bootstrap makes\n   * `createRuntime` itself throw, so there is no runtime to ask.\n   *\n   * The returned Runtime is typed at the loosest sub-machine signature.\n   * Caller casts to the concrete sub type.\n   *\n   * Re-entry: when the parent leaves and re-enters a state with `sub`, a\n   * fresh sub-Runtime is constructed. Previous sub-Runtime references held\n   * by the caller are stale and MUST NOT be used (disposed).\n   */\n  subRuntime(): Runtime<unknown, { type: string }, string> | undefined;\n  /**\n   * Semantic sugar for `runtime.on('transition', handler, opts)`. Returns\n   * the same unsubscribe function. Sharing the same listener Set with\n   * `on('transition', ...)` means registration order determines invocation\n   * order across both APIs.\n   *\n   * @since 0.3.0\n   */\n  onTransition(\n    handler: (payload: RuntimeTransitionEvent<Ctx, Evt, States>) => void,\n    options?: { signal?: AbortSignal; once?: boolean },\n  ): () => void;\n}\n\nexport type RuntimeOptions<Ctx, Evt, States extends string> = Readonly<{\n  middleware?: readonly Middleware<Ctx, Evt, States>[];\n  /**\n   * If false, do not dispatch effects through the effect handler map.\n   * Useful for replay / dry-run modes. Defaults to true.\n   */\n  dispatchEffects?: boolean;\n}>;\n","import { isAsyncGuardFn } from \"./evaluator.js\";\nimport { normalizeTransitions } from \"./resolver.js\";\nimport { createRuntime } from \"./runtime.js\";\nimport { freezeSnapshot } from \"./snapshot.js\";\nimport type {\n  Implementations,\n  MachineConfig,\n  MachineDef,\n  Runtime,\n  RuntimeOptions,\n  Snapshot,\n  StateDef,\n} from \"./types.js\";\n\n/**\n * Thrown for an invalid machine definition and, since 0.6.0, for argument\n * misuse at the definition/runtime boundary (`defineMachine`,\n * `setup().defineMachine`, `createMachine`, `createRuntime`, and the\n * `send` / `reset` / `subscribe` / `on` / `onTransition` runtime methods).\n * Messages read `aifsmjs: <subject> must be <constraint>`.\n */\nexport class InvalidDefinitionError extends Error {\n  constructor(message: string) {\n    super(`aifsmjs: ${message}`);\n    this.name = \"InvalidDefinitionError\";\n  }\n}\n\n/** Throw `InvalidDefinitionError(\"<subject> must be an object\")` unless `value` is a non-null object. */\nexport function assertObject(value: unknown, subject: string): void {\n  if (value === null || typeof value !== \"object\") {\n    throw new InvalidDefinitionError(`${subject} must be an object`);\n  }\n}\n\nfunction validateDefinition<Ctx, Evt extends { type: string }, States extends string>(\n  def: MachineDef<Ctx, Evt, States>,\n  // Cycle guard: subs may reference each other (or themselves) by object\n  // identity. We validate each distinct definition object at most once so a\n  // self/mutually-referential sub graph terminates instead of recursing\n  // forever (C2). Seeded by the public entry points below.\n  seen: WeakSet<object> = new WeakSet(),\n): void {\n  if (!def.id || typeof def.id !== \"string\") {\n    throw new InvalidDefinitionError(\"definition must have a non-empty string `id`\");\n  }\n  assertObject(def.states, \"definition states\");\n  const stateKeys = Object.keys(def.states) as States[];\n  if (stateKeys.length === 0) {\n    throw new InvalidDefinitionError(\"`states` must declare at least one state\");\n  }\n  if (!def.initial || !stateKeys.includes(def.initial)) {\n    throw new InvalidDefinitionError(\n      `\\`initial\\` \"${String(def.initial)}\" is not declared in states (${stateKeys.join(\", \")})`,\n    );\n  }\n  for (const [stateName, stateDef] of Object.entries(def.states) as [\n    States,\n    (typeof def.states)[States],\n  ][]) {\n    assertObject(stateDef, `state \"${stateName}\"`);\n    // §4 sub-shape check + deep recursion (C2). The shallow shape check rejects\n    // a malformed sub; recursing validateDefinition into the sub then rejects an\n    // unknown transition target or a declared-async guard at construction\n    // instead of leaving it to blow up at child.send(). Closes the FSM-07 sub\n    // async-guard discrepancy (same root). The cycle guard makes this safe for\n    // self/mutually-referential subs.\n    if (stateDef.sub !== undefined) {\n      const sub = stateDef.sub;\n      const subStates = (sub as { states?: unknown }).states;\n      const subInitial = (sub as { initial?: unknown }).initial;\n      if (\n        typeof sub !== \"object\" ||\n        sub === null ||\n        typeof subStates !== \"object\" ||\n        subStates === null ||\n        typeof subInitial !== \"string\" ||\n        // initial must name one of the sub's own states — otherwise the child\n        // boots pointing at a non-existent state and no-ops forever (FSM-S-02).\n        !Object.hasOwn(subStates as object, subInitial)\n      ) {\n        throw new InvalidDefinitionError(\n          `state \"${stateName}\".sub is not a valid sub-machine definition (missing states or initial)`,\n        );\n      }\n      // Recurse — but only once per distinct sub object (cycle guard).\n      if (!seen.has(sub as object)) {\n        seen.add(sub as object);\n        validateDefinition(sub as MachineDef<unknown, { type: string }, string>, seen);\n      }\n    }\n    if (!stateDef.on) continue;\n    for (const [evtType, entry] of Object.entries(stateDef.on)) {\n      const transitions = normalizeTransitions(entry);\n      for (const t of transitions) {\n        assertObject(t, `transition ${stateName} -[${evtType}]->`);\n        if (t.target !== undefined && !stateKeys.includes(t.target)) {\n          throw new InvalidDefinitionError(\n            `transition ${stateName} -[${evtType}]-> \"${String(t.target)}\" targets an unknown state`,\n          );\n        }\n        if (t.guard !== undefined && isAsyncGuardFn(t.guard)) {\n          throw new InvalidDefinitionError(\n            `transition ${stateName} -[${evtType}]-> uses an async guard. Guards must be sync; move I/O into an effect.`,\n          );\n        }\n      }\n    }\n  }\n  // Initial-state sub chain (C2 cycle guard does not cover it): createRuntime\n  // boots the child of every initial state eagerly, so a chain of initial-state\n  // subs that revisits a definition would recurse until the stack overflows.\n  // Runs once per distinct definition (root + each sub reached above). Subs\n  // reachable only through non-initial states may still be self-referential.\n  const path = new Set<object>();\n  let d = def as MachineDef<unknown, { type: string }, string> | undefined;\n  while (d) {\n    if (path.has(d)) {\n      throw new InvalidDefinitionError(\n        `sub-machine cycle through initial states: \"${d.id}\" is re-entered via initial-state subs`,\n      );\n    }\n    path.add(d);\n    d = d.states[d.initial]?.sub;\n  }\n}\n\n/**\n * Validate a machine definition shape and return it. When `context` is\n * provided the same reference is returned; when it is omitted a shallow copy\n * with `context: {}` is returned. Validation is intentionally shallow.\n *\n * Two call forms:\n *\n *   defineMachine<Ctx, Evt, States>({ ... })\n *     Explicit generics. Use when you need full control (e.g. union event\n *     types). Required because TypeScript cannot otherwise infer `Evt`.\n *\n *   setup<Ctx, Evt>().defineMachine({ ... })\n *     Curried form. Lets `States` be inferred from `keyof states`, so you\n *     can omit it. Recommended for typical usage.\n */\nexport function defineMachine<\n  Ctx = Record<string, never>,\n  Evt extends { type: string } = { type: string },\n  States extends string = string,\n>(def: MachineConfig<Ctx, Evt, States>): MachineDef<Ctx, Evt, States> {\n  assertObject(def, \"definition\");\n  const normalized = (\n    def.context === undefined ? { ...def, context: {} as Ctx } : def\n  ) as MachineDef<Ctx, Evt, States>;\n  validateDefinition(normalized);\n  return normalized;\n}\n\n/**\n * Curried builder so `States` can be inferred from `keyof states` without\n * `initial` or a transition `target` collapsing it to a single literal. Pass\n * `Ctx` and `Evt` as the type arguments; pass the def to the returned\n * `defineMachine`.\n *\n *   const machine = setup<MyCtx, MyEvt>().defineMachine({\n *     id: \"m\",\n *     initial: \"a\",\n *     context: { ... },\n *     states: { a: {...}, b: {...} },  // States inferred as \"a\" | \"b\"\n *   });\n */\nexport function setup<\n  Ctx = Record<string, never>,\n  Evt extends { type: string } = { type: string },\n>(): {\n  defineMachine: <const States extends string>(\n    def: Readonly<{\n      id: string;\n      initial: NoInfer<States>;\n      states: Readonly<{ [K in States]: StateDef<Ctx, Evt, NoInfer<States>> }>;\n    }> &\n      (Record<string, never> extends Ctx ? { readonly context?: Ctx } : { readonly context: Ctx }),\n  ) => MachineDef<Ctx, Evt, States>;\n} {\n  // Same normalisation + validation as defineMachine; only the type-level\n  // signature differs (States inferred from `keyof states`).\n  return { defineMachine: defineMachine as never };\n}\n\n/**\n * Build the initial snapshot for a machine.\n */\nexport function initialSnapshot<Ctx, Evt extends { type: string }, States extends string>(\n  def: MachineDef<Ctx, Evt, States>,\n): Snapshot<Ctx, States> {\n  const isFinal = def.states[def.initial]?.final === true;\n  return freezeSnapshot({\n    value: def.initial,\n    context: def.context,\n    status: isFinal ? (\"final\" as const) : (\"active\" as const),\n  });\n}\n\n/**\n * Convenience factory that composes `defineMachine` and `createRuntime` in\n * one call for the common case where you do not need to keep the machine\n * definition around for serialization or sharing.\n *\n * For type inference over `States` from `keyof states`, prefer\n * `setup<Ctx, Evt>().defineMachine(...)` then pass the result to\n * `createRuntime` separately. `createMachine` is the spec-style entry point\n * documented in the ai*js ecosystem review.\n */\nexport function createMachine<Ctx, Evt extends { type: string }, States extends string>(\n  def: MachineDef<Ctx, Evt, States>,\n  impl: Implementations<Ctx, Evt>,\n  opts?: RuntimeOptions<Ctx, Evt, States>,\n): Runtime<Ctx, Evt, States> {\n  return createRuntime(defineMachine(def), impl, opts ?? {});\n}\n","import { InvalidDefinitionError, assertObject, initialSnapshot } from \"./definition.js\";\nimport { isThenable, ownValue } from \"./evaluator.js\";\nimport { chooseTransition, stepWithMeta } from \"./lifecycle.js\";\nimport { IS_DEV, deepFreeze } from \"./snapshot.js\";\nimport {\n  type Effect,\n  type Implementations,\n  type MachineDef,\n  type Middleware,\n  RESET_EVENT_TYPE,\n  type ResetEvent,\n  type Runtime,\n  type RuntimeEventMap,\n  type RuntimeOptions,\n  type RuntimeTransitionEvent,\n  type Snapshot,\n} from \"./types.js\";\n\nexport class RuntimeDisposedError extends Error {\n  constructor() {\n    super(\"aifsmjs: runtime has been disposed; send()/reset() are not allowed\");\n    this.name = \"RuntimeDisposedError\";\n  }\n}\n\n/**\n * Thrown by `send()` / `reset()` when a sub-machine init or dispose throws.\n *\n * Prepare-then-commit: the new child is constructed before the previous one\n * is disposed. Invariants:\n * - `phase: \"init\"` — the new child's constructor threw. The parent snapshot\n *   is not committed and the previous child (if any) is untouched: still live\n *   and still returned by `subRuntime()`. No middleware ran, no `'transition'`\n *   was emitted, no effects were dispatched.\n * - `phase: \"dispose\"` — the previous child's `dispose()` threw. The new\n *   child (if any) was discarded, the parent snapshot is not committed, and\n *   `subRuntime()` returns `undefined` until the sub state is re-entered.\n * - Never thrown from `runtime.dispose()` cascade (never-throws contract).\n *\n * @since 0.3.0\n */\nexport class SubMachineError extends Error {\n  readonly parentState: string;\n  readonly phase: \"init\" | \"dispose\";\n  override readonly cause: unknown;\n\n  constructor(parentState: string, phase: \"init\" | \"dispose\", cause: unknown) {\n    super(`aifsmjs: sub-machine ${phase} failed at parent state \"${parentState}\"`, { cause });\n    this.name = \"SubMachineError\";\n    this.parentState = parentState;\n    this.phase = phase;\n    this.cause = cause; // belt-and-suspenders: legacy bundlers ignore ES2022 cause option\n  }\n}\n\nconst RESET_EVENT: ResetEvent = Object.freeze({ type: RESET_EVENT_TYPE });\n\nfunction composeMiddleware<Ctx, Evt, States extends string>(\n  middleware: readonly Middleware<Ctx, Evt, States>[],\n): Middleware<Ctx, Evt, States> {\n  return (ctx, finalNext) => {\n    let index = -1;\n    const dispatch = (i: number): void => {\n      if (i <= index) throw new Error(\"aifsmjs: next() called multiple times in middleware\");\n      index = i;\n      const fn = middleware[i];\n      if (!fn) {\n        finalNext();\n        return;\n      }\n      fn(ctx, () => dispatch(i + 1));\n    };\n    dispatch(0);\n  };\n}\n\ntype Queued<Evt> = { kind: \"send\"; event: Evt } | { kind: \"reset\"; event?: Evt | undefined };\n\nfunction assertListener(listener: unknown): void {\n  if (typeof listener !== \"function\") {\n    throw new InvalidDefinitionError(\"listener must be a function\");\n  }\n}\n\n/**\n * Build a thin stateful runtime around a machine. `send()` calls `step()`,\n * commits, runs the read-only middleware pipeline, dispatches effects, and\n * notifies subscribers then `'transition'` listeners. `send()`/`reset()` are\n * run-to-completion: a call made while the runtime is already dispatching\n * (from middleware, an effect handler, a listener, or a child runtime) is\n * queued FIFO and processed after the current event's last notification.\n * The runtime owns an `AbortController`; `dispose()` aborts it and clears all\n * state.\n *\n * Arguments are validated before anything is created: a non-object `def`,\n * `def.states`, `impl` or `opts`, or a `middleware` option that is not an\n * array of functions, throws `InvalidDefinitionError`. The rest of `def` is\n * trusted (build it with `defineMachine` / `setup().defineMachine`).\n */\nexport function createRuntime<Ctx, Evt extends { type: string }, States extends string>(\n  def: MachineDef<Ctx, Evt, States>,\n  impl: Implementations<Ctx, Evt>,\n  opts: RuntimeOptions<Ctx, Evt, States> = {},\n): Runtime<Ctx, Evt, States> {\n  assertObject(def, \"definition\");\n  assertObject(def.states, \"definition states\");\n  assertObject(impl, \"implementations\");\n  assertObject(opts, \"options\");\n  const middleware = opts.middleware;\n  if (\n    middleware !== undefined &&\n    !(Array.isArray(middleware) && middleware.every((fn) => typeof fn === \"function\"))\n  ) {\n    throw new InvalidDefinitionError(\"options.middleware must be an array of functions\");\n  }\n  let snapshot: Snapshot<Ctx, States> = initialSnapshot(def);\n  const listeners = new Set<(snap: Snapshot<Ctx, States>) => void>();\n  const middlewareChain =\n    middleware && middleware.length > 0 ? composeMiddleware(middleware) : undefined;\n  const shouldDispatch = opts.dispatchEffects !== false;\n  const controller = new AbortController();\n  let disposed = false;\n  // Run-to-completion (ai*js state-owning dispatcher rule): while one event is\n  // being processed, nested send()/reset() calls land in this FIFO mailbox.\n  let dispatching = false;\n  const mailbox: Queued<Evt>[] = [];\n  // §3.1 The live child of the current state's `sub`, if any. Replaced only by\n  // swapChild(); cleared by dispose().\n  let childRuntime: Runtime<unknown, { type: string }, string> | undefined;\n\n  type EventListeners = {\n    [K in keyof RuntimeEventMap<Ctx, Evt, States>]: Set<\n      (payload: RuntimeEventMap<Ctx, Evt, States>[K]) => void\n    >;\n  };\n  const eventListeners: EventListeners = {\n    transition: new Set(),\n    error: new Set(),\n    dispose: new Set(),\n  };\n  const externalAbortCleanups = new Set<() => void>();\n\n  function emit<K extends keyof RuntimeEventMap<Ctx, Evt, States>>(\n    type: K,\n    payload: RuntimeEventMap<Ctx, Evt, States>[K],\n  ): void {\n    // Snapshot-before-iterate (ai*js fan-out rule): a listener added during\n    // dispatch first fires on the next event, and one removed meanwhile\n    // (unsubscribe, `once`, signal abort, dispose) is skipped for the rest of\n    // this dispatch. Per-listener isolation: a throwing listener must not skip\n    // the ones after it (a 'dispose' cleanup hook would leak). The first error\n    // is rethrown once every listener has run, so it still surfaces.\n    const set = eventListeners[type];\n    let failed = false;\n    let firstError: unknown;\n    for (const fn of Array.from(set)) {\n      if (!set.has(fn)) continue;\n      try {\n        fn(payload);\n      } catch (err) {\n        if (!failed) {\n          failed = true;\n          firstError = err;\n        }\n      }\n    }\n    if (failed) throw firstError;\n  }\n\n  function dispatchEffects(effects: readonly Effect[], context: Ctx, event: Evt): void {\n    if (!impl.effects || effects.length === 0) return;\n    for (const eff of effects) {\n      const handler = ownValue(impl.effects, eff.type);\n      if (!handler) continue;\n      const r = handler(eff, { context, event, signal: controller.signal });\n      // isThenable (not instanceof Promise) so cross-realm Promises and\n      // user-defined PromiseLike results also have their rejections routed to\n      // the 'error' channel; Promise.resolve() normalises them (FSM-B-03).\n      if (isThenable(r)) {\n        Promise.resolve(r).catch((err: unknown) => {\n          // Never re-thrown: an unhandledRejection would crash Node >= 15 and\n          // break fire-and-forget. With no 'error' listener (none registered,\n          // or cleared by dispose()) it is discarded, with a dev-only warning.\n          if (eventListeners.error.size > 0) emit(\"error\", { error: err, event });\n          else if (IS_DEV) {\n            console.warn(\n              'aifsmjs: unhandled async effect rejection; register runtime.on(\"error\", ...)',\n              err,\n            );\n          }\n        });\n      }\n    }\n  }\n\n  // §3.1 Prepare-then-commit child swap for a move from `prevValue` into\n  // `nextValue` (transitions, reset() and bootstrap). Throws SubMachineError;\n  // the caller must NOT commit the parent snapshot on throw.\n  //   1. Construct the new child first: an init failure leaves the old child\n  //      live and untouched.\n  //   2. Dispose the old child: a failure discards the new child.\n  //   3. Adopt the new child — or discard it when a listener run by step 2\n  //      disposed this runtime meanwhile.\n  function swapChild(prevValue: States, nextValue: States): void {\n    const stateDef = def.states[nextValue];\n    let next: Runtime<unknown, { type: string }, string> | undefined;\n    if (stateDef?.sub) {\n      try {\n        next = createRuntime(stateDef.sub, stateDef.subImpl ?? {});\n      } catch (cause) {\n        throw new SubMachineError(nextValue, \"init\", cause);\n      }\n    }\n    const old = childRuntime;\n    if (old) {\n      childRuntime = undefined;\n      try {\n        old.dispose();\n      } catch (cause) {\n        next?.dispose(); // a freshly built runtime's dispose() never throws\n        throw new SubMachineError(prevValue, \"dispose\", cause);\n      }\n    }\n    if (disposed) next?.dispose();\n    else childRuntime = next;\n  }\n\n  // Commit, then middleware -> effects -> subscribers -> 'transition'.\n  function commit(\n    prev: Snapshot<Ctx, States>,\n    next: Snapshot<Ctx, States>,\n    event: Evt | ResetEvent,\n    effects: readonly Effect[],\n    changed: boolean,\n  ): void {\n    snapshot = next;\n    // Middleware gets the caller's event by reference, never frozen (the\n    // caller owns it). The wrapper is frozen, prev/next are already frozen to\n    // the NODE_ENV depth (STABILITY.md), and effects are deep-frozen so no\n    // middleware can alter a payload before dispatch.\n    middlewareChain?.(\n      Object.freeze({ prev, next, event, effects: deepFreeze(effects), changed }),\n      () => {},\n    );\n    // reset() commits no effects, so its sentinel event never reaches a handler.\n    if (shouldDispatch) dispatchEffects(effects, next.context, event as Evt);\n    if (changed) {\n      // Same snapshot-before-iterate / skip-removed rule as emit().\n      for (const l of Array.from(listeners)) if (listeners.has(l)) l(next);\n      emit(\"transition\", {\n        prev,\n        next,\n        event,\n        effects,\n        changed: true,\n      } as RuntimeTransitionEvent<Ctx, Evt, States>);\n    }\n  }\n\n  function processSend(event: Evt): void {\n    const prev = snapshot;\n    const { result, external } = stepWithMeta(def, prev, event, impl);\n    // Sub lifecycle BEFORE snapshot commit (§3.4), decided from the same guard\n    // pass as the snapshot; throws SubMachineError on failure → no commit.\n    if (result.changed && (prev.value !== result.snapshot.value || external)) {\n      swapChild(prev.value, result.snapshot.value);\n    }\n    commit(prev, result.snapshot, event, result.effects, result.changed);\n  }\n\n  function processReset(event: Evt | undefined): void {\n    const prev = snapshot;\n    const next = initialSnapshot(def);\n    // reset() is re-birth: the current child is always replaced (§3.5).\n    swapChild(prev.value, next.value);\n    commit(\n      prev,\n      next,\n      event ?? RESET_EVENT,\n      [],\n      prev.value !== next.value || prev.status !== next.status || prev.context !== next.context,\n    );\n  }\n\n  function run(entry: Queued<Evt>): Snapshot<Ctx, States> {\n    if (disposed) throw new RuntimeDisposedError();\n    if (\n      (entry.kind === \"send\" || entry.event !== undefined) &&\n      typeof entry.event?.type !== \"string\"\n    ) {\n      throw new InvalidDefinitionError(\n        `${entry.kind}() event must be an object with a string type`,\n      );\n    }\n    if (dispatching) {\n      // Nested call: queue it and hand back what is committed right now.\n      mailbox.push(entry);\n      return snapshot;\n    }\n    dispatching = true;\n    try {\n      // dispose() empties the mailbox, so the drain stops there too.\n      for (let m: Queued<Evt> | undefined = entry; m && !disposed; m = mailbox.shift()) {\n        if (m.kind === \"send\") processSend(m.event);\n        else processReset(m.event);\n      }\n    } finally {\n      // A throw discards whatever is still queued; the error propagates from\n      // this (outermost) call and the snapshot stays at the last commit.\n      dispatching = false;\n      mailbox.length = 0;\n    }\n    return snapshot;\n  }\n\n  function on<K extends keyof RuntimeEventMap<Ctx, Evt, States>>(\n    type: K,\n    listener: (payload: RuntimeEventMap<Ctx, Evt, States>[K]) => void,\n    options?: { signal?: AbortSignal; once?: boolean },\n  ): () => void {\n    if (!Object.hasOwn(eventListeners, type)) {\n      throw new InvalidDefinitionError('on() type must be \"transition\", \"error\" or \"dispose\"');\n    }\n    assertListener(listener);\n    if (disposed || options?.signal?.aborted) return () => {};\n    const target = eventListeners[type];\n    let detachAbort: (() => void) | undefined;\n    // Full teardown shared by the once-wrapper, the abort handler, and the\n    // returned unsubscribe so every path detaches the abort listener too — a\n    // once-handler that also passed a { signal } previously left the abort\n    // listener attached until dispose()/abort (memory leak).\n    const cleanup = (): void => {\n      target.delete(wrapped);\n      if (detachAbort) {\n        detachAbort();\n        externalAbortCleanups.delete(detachAbort);\n      }\n    };\n    let wrapped: (payload: RuntimeEventMap<Ctx, Evt, States>[K]) => void = listener;\n    if (options?.once) {\n      // Inert before its first call: removed first, then invoked.\n      wrapped = (payload) => {\n        cleanup();\n        listener(payload);\n      };\n    }\n    target.add(wrapped);\n    const signal = options?.signal;\n    if (signal) {\n      const onAbort = () => cleanup();\n      signal.addEventListener(\"abort\", onAbort, { once: true });\n      detachAbort = () => signal.removeEventListener(\"abort\", onAbort);\n      externalAbortCleanups.add(detachAbort);\n    }\n    return cleanup;\n  }\n\n  function dispose(): void {\n    if (disposed) return;\n    disposed = true;\n    // Never queued: runs at once, even mid-dispatch, and drops queued events.\n    mailbox.length = 0;\n    // Cascade child dispose; swallow exceptions (dispose contract) (§3.6)\n    const child = childRuntime;\n    childRuntime = undefined;\n    try {\n      child?.dispose();\n    } catch {\n      /* swallow */\n    }\n    controller.abort();\n    listeners.clear();\n    // §3.6 dispose() is contractually never-throws + idempotent (README,\n    // STABILITY.md). emit('dispose') runs user listeners; a throwing one\n    // must neither escape dispose() nor abort the remaining teardown (which\n    // would leak external-signal abort listeners, since a second dispose()\n    // short-circuits on `if (disposed) return`). The try/finally guarantees\n    // the listener-set clear + externalAbortCleanups loop ALWAYS run.\n    try {\n      emit(\"dispose\", undefined as RuntimeEventMap<Ctx, Evt, States>[\"dispose\"]);\n    } catch {\n      /* swallow — never-throws contract */\n    } finally {\n      for (const set of Object.values(eventListeners)) set.clear();\n      for (const cleanup of externalAbortCleanups) cleanup();\n      externalAbortCleanups.clear();\n    }\n  }\n\n  const runtime: Runtime<Ctx, Evt, States> = {\n    getSnapshot: () => snapshot,\n    snapshot: () => snapshot,\n    send: (event) => run({ kind: \"send\", event }),\n    // Same candidate resolution as step(), without running any action.\n    can: (event) => !disposed && chooseTransition(def, snapshot, event, impl) !== undefined,\n    reset: (event) => run({ kind: \"reset\", event }),\n    dispose,\n    on,\n    get disposed() {\n      return disposed;\n    },\n    get signal() {\n      return controller.signal;\n    },\n    subscribe(listener) {\n      assertListener(listener);\n      if (disposed) return () => {};\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n    subRuntime: () => childRuntime,\n    onTransition: (handler, options) => on(\"transition\", handler, options),\n  };\n\n  // §2 Bootstrap: if the initial state has a sub, instantiate the child BEFORE\n  // returning. Failure throws SubMachineError(initialState, \"init\", cause).\n  swapChild(snapshot.value, snapshot.value);\n\n  return runtime;\n}\n"]}

package/dist/effects/index.cjs

@@ -1,8 +1,7 @@
 'use strict';
 
 var chunk3B2USJ3H_cjs = require('../chunk-3B2USJ3H.cjs');
-var chunkCDK25FTD_cjs = require('../chunk-CDK25FTD.cjs');
-require('../chunk-Q7SFCCGT.cjs');
+var chunkQCTA2X4J_cjs = require('../chunk-QCTA2X4J.cjs');
 
 // src/effects/dispatcher.ts
 var NEVER_SIGNAL;
@@ -16,10 +15,10 @@ function runEffects(effects, handlers, args) {
   const handlerArgs = { context: args.context, event: args.event, signal };
   const promises = [];
   for (const eff of effects) {
-    const h = handlers[eff.type];
+    const h = chunkQCTA2X4J_cjs.ownValue(handlers, eff.type);
     if (!h) continue;
     const r = h(eff, handlerArgs);
-    if (chunkCDK25FTD_cjs.isThenable(r)) promises.push(Promise.resolve(r));
+    if (chunkQCTA2X4J_cjs.isThenable(r)) promises.push(Promise.resolve(r));
   }
   return promises;
 }

package/dist/effects/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/effects/dispatcher.ts"],"names":["isThenable"],"mappings":";;;;;;;AAKA,IAAI,YAAA;AACJ,SAAS,WAAA,GAA2B;AAClC,EAAA,IAAI,CAAC,YAAA,EAAc,YAAA,GAAe,IAAI,iBAAgB,CAAE,MAAA;AACxD,EAAA,OAAO,YAAA;AACT;AAgBO,SAAS,UAAA,CACd,OAAA,EACA,QAAA,EACA,IAAA,EAC0B;AAC1B,EAAA,IAAI,CAAC,QAAA,IAAY,OAAA,CAAQ,MAAA,KAAW,CAAA,SAAU,EAAC;AAC/C,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,MAAA,IAAU,WAAA,EAAY;AAC1C,EAAA,MAAM,WAAA,GAAc,EAAE,OAAA,EAAS,IAAA,CAAK,SAAS,KAAA,EAAO,IAAA,CAAK,OAAO,MAAA,EAAO;AACvE,EAAA,MAAM,WAA4B,EAAC;AACnC,EAAA,KAAA,MAAW,OAAO,OAAA,EAAS;AACzB,IAAA,MAAM,CAAA,GAAI,QAAA,CAAS,GAAA,CAAI,IAAI,CAAA;AAC3B,IAAA,IAAI,CAAC,CAAA,EAAG;AACR,IAAA,MAAM,CAAA,GAAI,CAAA,CAAE,GAAA,EAAK,WAAW,CAAA;AAI5B,IAAA,IAAIA,4BAAA,CAAW,CAAC,CAAA,EAAG,QAAA,CAAS,KAAK,OAAA,CAAQ,OAAA,CAAQ,CAAC,CAAC,CAAA;AAAA,EACrD;AACA,EAAA,OAAO,QAAA;AACT","file":"index.cjs","sourcesContent":["import { isThenable } from \"../fsm/evaluator.js\";\nimport type { Effect, EffectHandler } from \"../fsm/types.js\";\n\n// Lazily-built never-aborting signal for callers who don't supply one. Reused\n// across runEffects() invocations to avoid allocating a controller per call.\nlet NEVER_SIGNAL: AbortSignal | undefined;\nfunction neverSignal(): AbortSignal {\n  if (!NEVER_SIGNAL) NEVER_SIGNAL = new AbortController().signal;\n  return NEVER_SIGNAL;\n}\n\n/**\n * Dispatch a batch of effects through the supplied handler map. Effects whose\n * `type` has no handler are silently skipped (the runtime treats unhandled\n * effects as informational).\n *\n * Returns the array of Promise results (if any handler is async) so callers\n * can `await Promise.all(...)` when they need flushing — the default runtime\n * is fire-and-forget and discards them.\n *\n * Each handler receives an `AbortSignal`. When called from `createRuntime`,\n * the signal is the runtime's own controller. Stand-alone callers may omit\n * `args.signal` (a never-aborting placeholder is supplied) or pass their own\n * (e.g. `AbortSignal.timeout(5000)`, `AbortSignal.any([...])`).\n */\nexport function runEffects<Ctx, Evt>(\n  effects: readonly Effect[],\n  handlers: Readonly<Record<string, EffectHandler<Ctx, Evt>>> | undefined,\n  args: { context: Ctx; event: Evt; signal?: AbortSignal },\n): readonly Promise<void>[] {\n  if (!handlers || effects.length === 0) return [];\n  const signal = args.signal ?? neverSignal();\n  const handlerArgs = { context: args.context, event: args.event, signal };\n  const promises: Promise<void>[] = [];\n  for (const eff of effects) {\n    const h = handlers[eff.type];\n    if (!h) continue;\n    const r = h(eff, handlerArgs);\n    // isThenable (not instanceof Promise) so cross-realm Promises and\n    // user-defined PromiseLike results are also awaitable by callers;\n    // Promise.resolve() normalises them to a real Promise (FSM-B-03).\n    if (isThenable(r)) promises.push(Promise.resolve(r));\n  }\n  return promises;\n}\n"]}
+{"version":3,"sources":["../../src/effects/dispatcher.ts"],"names":["ownValue","isThenable"],"mappings":";;;;;;AAKA,IAAI,YAAA;AACJ,SAAS,WAAA,GAA2B;AAClC,EAAA,IAAI,CAAC,YAAA,EAAc,YAAA,GAAe,IAAI,iBAAgB,CAAE,MAAA;AACxD,EAAA,OAAO,YAAA;AACT;AAgBO,SAAS,UAAA,CACd,OAAA,EACA,QAAA,EACA,IAAA,EAC0B;AAC1B,EAAA,IAAI,CAAC,QAAA,IAAY,OAAA,CAAQ,MAAA,KAAW,CAAA,SAAU,EAAC;AAC/C,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,MAAA,IAAU,WAAA,EAAY;AAC1C,EAAA,MAAM,WAAA,GAAc,EAAE,OAAA,EAAS,IAAA,CAAK,SAAS,KAAA,EAAO,IAAA,CAAK,OAAO,MAAA,EAAO;AACvE,EAAA,MAAM,WAA4B,EAAC;AACnC,EAAA,KAAA,MAAW,OAAO,OAAA,EAAS;AACzB,IAAA,MAAM,CAAA,GAAIA,0BAAA,CAAS,QAAA,EAAU,GAAA,CAAI,IAAI,CAAA;AACrC,IAAA,IAAI,CAAC,CAAA,EAAG;AACR,IAAA,MAAM,CAAA,GAAI,CAAA,CAAE,GAAA,EAAK,WAAW,CAAA;AAI5B,IAAA,IAAIC,4BAAA,CAAW,CAAC,CAAA,EAAG,QAAA,CAAS,KAAK,OAAA,CAAQ,OAAA,CAAQ,CAAC,CAAC,CAAA;AAAA,EACrD;AACA,EAAA,OAAO,QAAA;AACT","file":"index.cjs","sourcesContent":["import { isThenable, ownValue } from \"../fsm/evaluator.js\";\nimport type { Effect, EffectHandler } from \"../fsm/types.js\";\n\n// Lazily-built never-aborting signal for callers who don't supply one. Reused\n// across runEffects() invocations to avoid allocating a controller per call.\nlet NEVER_SIGNAL: AbortSignal | undefined;\nfunction neverSignal(): AbortSignal {\n  if (!NEVER_SIGNAL) NEVER_SIGNAL = new AbortController().signal;\n  return NEVER_SIGNAL;\n}\n\n/**\n * Dispatch a batch of effects through the supplied handler map. Effects whose\n * `type` has no handler are silently skipped (the runtime treats unhandled\n * effects as informational).\n *\n * Returns the array of Promise results (if any handler is async) so callers\n * can `await Promise.all(...)` when they need flushing — the default runtime\n * is fire-and-forget and discards them.\n *\n * Each handler receives an `AbortSignal`. When called from `createRuntime`,\n * the signal is the runtime's own controller. Stand-alone callers may omit\n * `args.signal` (a never-aborting placeholder is supplied) or pass their own\n * (e.g. `AbortSignal.timeout(5000)`, `AbortSignal.any([...])`).\n */\nexport function runEffects<Ctx, Evt>(\n  effects: readonly Effect[],\n  handlers: Readonly<Record<string, EffectHandler<Ctx, Evt>>> | undefined,\n  args: { context: Ctx; event: Evt; signal?: AbortSignal },\n): readonly Promise<void>[] {\n  if (!handlers || effects.length === 0) return [];\n  const signal = args.signal ?? neverSignal();\n  const handlerArgs = { context: args.context, event: args.event, signal };\n  const promises: Promise<void>[] = [];\n  for (const eff of effects) {\n    const h = ownValue(handlers, eff.type);\n    if (!h) continue;\n    const r = h(eff, handlerArgs);\n    // isThenable (not instanceof Promise) so cross-realm Promises and\n    // user-defined PromiseLike results are also awaitable by callers;\n    // Promise.resolve() normalises them to a real Promise (FSM-B-03).\n    if (isThenable(r)) promises.push(Promise.resolve(r));\n  }\n  return promises;\n}\n"]}

package/dist/effects/index.d.cts

@@ -1,4 +1,4 @@
-import { c as Enqueuer, E as Effect, b as EffectHandler } from '../types-DIM7QTtf.cjs';
+import { c as Enqueuer, E as Effect, b as EffectHandler } from '../types-CrDxFfBx.cjs';
 
 /**
  * Build a closure-based Enqueuer that pushes effects into the supplied sink.

package/dist/effects/index.d.ts

@@ -1,4 +1,4 @@
-import { c as Enqueuer, E as Effect, b as EffectHandler } from '../types-DIM7QTtf.js';
+import { c as Enqueuer, E as Effect, b as EffectHandler } from '../types-CrDxFfBx.js';
 
 /**
  * Build a closure-based Enqueuer that pushes effects into the supplied sink.

package/dist/effects/index.js

@@ -1,6 +1,5 @@
 export { createEnqueuer } from '../chunk-JKZAOPQC.js';
-import { isThenable } from '../chunk-A7U7QQL5.js';
-import '../chunk-PZ5AY32C.js';
+import { ownValue, isThenable } from '../chunk-SSNKGEVB.js';
 
 // src/effects/dispatcher.ts
 var NEVER_SIGNAL;
@@ -14,7 +13,7 @@ function runEffects(effects, handlers, args) {
   const handlerArgs = { context: args.context, event: args.event, signal };
   const promises = [];
   for (const eff of effects) {
-    const h = handlers[eff.type];
+    const h = ownValue(handlers, eff.type);
     if (!h) continue;
     const r = h(eff, handlerArgs);
     if (isThenable(r)) promises.push(Promise.resolve(r));