@turing-machine-js/machine 6.1.0 → 6.2.0

package/dist/classes/TuringMachine.d.ts

@@ -35,11 +35,17 @@ export default class TuringMachine {
     get tapeBlock(): TapeBlock;
     run({ initialState, stepsLimit, onStep, onPause, debug, }: RunParameter & {
         /**
-         * Sync, ~free hook fired on every iteration. Use for logging/tracing —
-         * the hot loop runs this without a microtask boundary, so it must not
-         * be async.
+         * Hook fired on every iteration. Use for logging/tracing — and for
+         * yield-style coordination: returning a Promise suspends the run loop
+         * until it resolves, so a consumer can throttle the per-iter cadence
+         * (e.g. an interactive debugger awaiting a `setTimeout`-Promise between
+         * iters) without owning the loop. A sync `void` return adds one microtask
+         * boundary per iter (the engine awaits a non-Promise to keep the dispatch
+         * shape uniform); negligible for typical loops, but noted for tight ones.
+         *
+         * Awaited inline since v6.2.0 ([#158](https://github.com/mellonis/turing-machine-js/issues/158)).
          */
-        onStep?: (machineState: MachineState) => void;
+        onStep?: (machineState: MachineState) => void | Promise<void>;
         /**
          * Async hook fired when `state.debug[when]` matches at the current
          * iteration. The promise is awaited inline, so the consumer can suspend

package/dist/index.cjs

@@ -1070,7 +1070,7 @@ class TuringMachine {
                 await onPause({ ...machineState, debugBreak: { before: true } });
             }
             if (onStep instanceof Function) {
-                onStep(machineState);
+                await onStep(machineState);
             }
             if (debug && machineState.debugBreak?.after && onPause) {
                 await onPause({ ...machineState, debugBreak: { after: true } });

package/dist/index.mjs

@@ -1068,7 +1068,7 @@ class TuringMachine {
                 await onPause({ ...machineState, debugBreak: { before: true } });
             }
             if (onStep instanceof Function) {
-                onStep(machineState);
+                await onStep(machineState);
             }
             if (debug && machineState.debugBreak?.after && onPause) {
                 await onPause({ ...machineState, debugBreak: { after: true } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@turing-machine-js/machine",
-  "version": "6.1.0",
+  "version": "6.2.0",
   "description": "A convenient Turing machine",
   "engines": {
     "npm": ">=7.0.0"
@@ -23,6 +23,10 @@
     "turing",
     "machine"
   ],
+  "scripts": {
+    "build": "tsc --build --verbose tsconfig.build.json && node ../../scripts/build-node-entries.mjs --package=@turing-machine-js/machine",
+    "prepublishOnly": "npm run build"
+  },
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -34,5 +38,5 @@
       "default": "./dist/index.mjs"
     }
   },
-  "gitHead": "5a3e3ced5bacd541fefdf087f5b4301267be01d2"
+  "gitHead": "a6a51bbf2db3d4ae692431b13956d9397df0b9e0"
 }