@grundyjs/algiviz 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -1,6 +1,15 @@
 # Changelog
 
-## 0.9.0 � 2026-10-27
+## 0.10.0 — 2026-10-27
+
+- Default finalHoldMs to zero for generic and array players.
+- Make stepDurationMs optional for manual nextStep playback; advance(0) redraws,
+  while positive timed advancement requires an explicit duration.
+- Allow array players to omit the options object entirely.
+- Simplify the minimal example and both READMEs; refresh the highlighted GIF.
+- Preserve explicit timing behavior and timeline requirements.
+
+## 0.9.0 — 2026-10-27
 
 - Add player.nextStep() for exact manual stepping in generic and array players.
 - Finish an in-progress transition without reading another snapshot; at a boundary,

package/README.md

@@ -74,7 +74,6 @@ const renderer = createSceneRenderer({
     },
 });
 const player = createPlayer(steps(), {
-    stepDurationMs: 1000, finalHoldMs: 0,
     isTerminal: step => step.event === 'done',
     render(frame) {
         ctx.clearRect(0, 0, 600, 160);

package/dist/array/player.d.ts

@@ -3,8 +3,8 @@ import type { ArrayStep, ArraySnapshot, ArrayEvent } from "./types.js";
 import type { ArrayFrame } from "./timeline.js";
 export type ArrayPlayer = Player<ArraySnapshot, ArrayEvent>;
 /** Array playback adapter for array steps ending in done. */
-export declare function createArrayPlayer(steps: Iterable<ArrayStep>, options: {
-    stepDurationMs: number;
-    finalHoldMs: number;
+export declare function createArrayPlayer(steps: Iterable<ArrayStep>, options?: {
+    stepDurationMs?: number | undefined;
+    finalHoldMs?: number | undefined;
     render?: (frame: ArrayFrame) => void;
 }): ArrayPlayer;

package/dist/array/player.js

@@ -1,5 +1,5 @@
 import { createPlayer } from "../playback/index.js";
 /** Array playback adapter for array steps ending in done. */
-export function createArrayPlayer(steps, options) {
+export function createArrayPlayer(steps, options = {}) {
     return createPlayer(steps, { ...options, isTerminal: step => step.event.type === "done" });
 }

package/dist/playback/player.d.ts

@@ -13,8 +13,10 @@ export interface Player<S, E> {
 }
 /** Forward-only playback. The source must reach a step accepted by isTerminal. */
 export declare function createPlayer<S, E>(steps: Iterable<Step<S, E>>, options: {
-    stepDurationMs: number;
-    finalHoldMs: number;
+    /** Omit for manual playback; positive advance requires a duration. */
+    stepDurationMs?: number | undefined;
+    /** Final hold duration, default 0. */
+    finalHoldMs?: number | undefined;
     isTerminal: (step: Step<S, E>) => boolean;
     /** Called initially and on each advance or nextStep, including after completion. */
     render?: (frame: Frame<S, E>) => void;

package/dist/playback/player.js

@@ -1,6 +1,8 @@
 /** Forward-only playback. The source must reach a step accepted by isTerminal. */
 export function createPlayer(steps, options) {
-    const { stepDurationMs, finalHoldMs } = options;
+    const manual = options.stepDurationMs === undefined;
+    // Unit endpoint for manual steps; positive timed advancement is disallowed.
+    const { stepDurationMs = 1, finalHoldMs = 0 } = options;
     if (!Number.isFinite(stepDurationMs) || stepDurationMs <= 0 ||
         !Number.isFinite(finalHoldMs) || finalHoldMs < 0) {
         throw new RangeError("Expected positive step duration and non-negative final hold");
@@ -97,6 +99,9 @@ export function createPlayer(steps, options) {
             if (!Number.isFinite(deltaMs) || deltaMs < 0) {
                 throw new RangeError("Expected finite non-negative playback time");
             }
+            if (manual && deltaMs > 0) {
+                throw new Error("Set stepDurationMs to use advance with positive time; use nextStep for manual playback");
+            }
             try {
                 let remaining = deltaMs;
                 while (remaining > 0 && !finished) {

package/package.json

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

package/ru/README.md

@@ -73,7 +73,6 @@ const renderer = createSceneRenderer({
     },
 });
 const player = createPlayer(steps(), {
-    stepDurationMs: 1000, finalHoldMs: 0,
     isTerminal: step => step.event === 'done',
     render(frame) {
         ctx.clearRect(0, 0, 600, 160);