@grundyjs/algiviz 0.8.2 → 0.9.0

package/dist/playback/player.d.ts

@@ -5,6 +5,9 @@ export interface Player<S, E> {
     readonly finished: boolean;
     /** Advance by playback time; pass zero to redraw without consuming steps. */
     advance(deltaMs: number): Frame<S, E>;
+    /** Finish the current transition, or consume one next step at a boundary.
+     * At the terminal boundary, finish the hold. Renders once, even if finished. */
+    nextStep(): Frame<S, E>;
     /** Close the source early. The last frame remains readable. */
     dispose(): void;
 }
@@ -13,6 +16,6 @@ export declare function createPlayer<S, E>(steps: Iterable<Step<S, E>>, options:
     stepDurationMs: number;
     finalHoldMs: number;
     isTerminal: (step: Step<S, E>) => boolean;
-    /** Called initially and on each advance, including advance(0). */
+    /** Called initially and on each advance or nextStep, including after completion. */
     render?: (frame: Frame<S, E>) => void;
 }): Player<S, E>;

package/dist/playback/player.js

@@ -59,6 +59,38 @@ export function createPlayer(steps, options) {
     return Object.freeze({
         get frame() { return frame(); },
         get finished() { return finished; },
+        nextStep() {
+            if (disposed)
+                throw new Error("Player has been disposed");
+            try {
+                if (!finished) {
+                    if (elapsed === stepDurationMs) {
+                        if (options.isTerminal(current)) {
+                            hold = finalHoldMs;
+                        }
+                        else {
+                            const next = iterator.next();
+                            if (next.done)
+                                throw new RangeError("Step source ended without a terminal step");
+                            previous = current;
+                            current = next.value;
+                        }
+                    }
+                    // Assign the endpoint directly: time arithmetic can undershoot or
+                    // spill a rounding remainder into an unwanted additional step.
+                    elapsed = stepDurationMs;
+                    complete();
+                }
+                const result = frame();
+                options.render?.(result);
+                return result;
+            }
+            catch (error) {
+                disposed = true;
+                closeAfterFailure();
+                throw error;
+            }
+        },
         advance(deltaMs) {
             if (disposed)
                 throw new Error("Player has been disposed");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grundyjs/algiviz",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "description": "TypeScript toolkit for custom algorithm visualizations with step-by-step playback and extensible rendering",
   "type": "module",
   "files": [