@grundyjs/algiviz 0.11.0 → 0.11.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.11.1 — 2026-11-05
+
+- Validate both numeric positions in array swap/shift before reading or mutating
+  the trace, rejecting invalid JavaScript arguments without losing item identities
+  or changing snapshots, counters, markers or the next step index.
+- Allow explicitly undefined sorted-region inputs with exactOptionalPropertyTypes,
+  matching the existing runtime behavior of preserving the current marker.
+- Document array guarantees in English and Russian: fixed length, one held item,
+  trace-local IDs, immutable snapshots, counters and author-supplied sorted markers.
+- Add an application-owned object lifecycle example and expand playback completion,
+  strict type and installed-package consumer checks. No new public exports.
+
 ## 0.11.0 — 2026-11-02
 
 - Add createStatePlayer() for lazy playback of plain immutable states without

package/README.md

@@ -102,8 +102,8 @@ the [local setup instructions](https://github.com/urffin/algiviz/blob/master/doc
 - **Scene:** describes objects with stable IDs, types and application-owned data.
 - **Handler:** chooses geometry and drawing behavior, including interpolation.
 
-Do not mutate emitted states. Players require an explicit terminal step;
-call `dispose()` when removing a visualization. Algorithms, layouts and animation
+Do not mutate emitted states. `createStatePlayer` completes on source exhaustion;
+`createPlayer` requires an explicit terminal step. Call `dispose()` when removing a visualization. Algorithms, layouts and animation
 scheduling belong to the application.
 
 ## Playback modes

package/dist/array/trace.d.ts

@@ -1,7 +1,8 @@
 import type { Item, ArrayStep } from "./types.js";
+/** Omitted or undefined markers preserve their current values. */
 export interface SortedRegions {
-    readonly sortedPrefixLength?: number;
-    readonly sortedSuffixLength?: number;
+    readonly sortedPrefixLength?: number | undefined;
+    readonly sortedSuffixLength?: number | undefined;
 }
 export interface ArrayTrace {
     readonly length: number;

package/dist/array/trace.js

@@ -54,6 +54,8 @@ export function createArrayTrace(values) {
         },
         swap(left, right, update) {
             active();
+            index(left);
+            index(right);
             const a = item(left), b = item(right);
             if (left === right)
                 throw new RangeError("Swap requires distinct positions");
@@ -74,8 +76,9 @@ export function createArrayTrace(values) {
         },
         shift(from, to, update) {
             active();
-            const moved = item(from);
+            index(from);
             index(to);
+            const moved = item(from);
             if (slots[to] !== null)
                 throw new Error("Shift destination must be empty");
             regions(update);

package/package.json

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

package/ru/README.md

@@ -100,7 +100,8 @@ document.querySelector('#next').onclick = () => player.nextStep();
 - **Сцена** описывает объекты: стабильный `id`, тип и собственные данные.
 - **Обработчик** выбирает геометрию и способ рисования. Плавность — его решение.
 
-Состояния после выдачи нельзя изменять. Плееру нужен явный завершающий шаг;
+Состояния после выдачи нельзя изменять. `createStatePlayer` завершается при исчерпании
+источника; `createPlayer` требует явного завершающего шага;
 при удалении визуализации вызовите `dispose()`. Алгоритмы, раскладка и цикл
 анимации принадлежат приложению.