aispritejs 0.1.1 → 0.1.3

package/README.md

@@ -19,6 +19,17 @@ Part of the **ai\*js** family: zero cross-package dependencies, framework-agnost
 - **Visual ≠ logic.** This is strictly a *visual* animator. It is **not** a game-logic FSM and does **not** depend on `aifsmjs`. Drive it from any logic layer (plain code, an FSM, an ECS) — they compose by convention, never by dependency.
 - **Tiny + fast.** O(1) input lookups, O(N) checks over transitions leaving the current state, no per-frame allocation.
 
+## When you DON'T need aispritejs
+
+`aispritejs` earns its keep when frame selection is **driven by runtime inputs** across **several visual states**. Below that threshold, reach for PixiJS directly — there is nothing to gain from a state machine:
+
+- **A single sprite / one static image** → a plain PixiJS [`Sprite`](https://pixijs.download/release/docs/scene.Sprite.html). No animation, no graph.
+- **One looping clip with no branching** (a coin spin, a torch flicker) → a PixiJS [`AnimatedSprite`](https://pixijs.download/release/docs/scene.AnimatedSprite.html) (`AnimatedSprite.fromFrames(...)`, `.play()`). One clip that always plays the same way needs no inputs.
+- **No texture atlas** (you aren't packing frames into a spritesheet) → load images directly; `aispritejs` reads its frames from a PixiJS-v8 atlas (`animations` / `frames`).
+- **No multi-state switching** — if your code already knows exactly which clip to play and just calls `.play()` / `.gotoAndStop()`, you don't need a transition graph.
+
+Reach for `aispritejs` when you have **input-driven, multi-state visual switching backed by a texture atlas** — e.g. `idle ⇄ walk → jump`, or a one-shot hit FX fired by a trigger — where which frame is on screen is a function of `speed` / `isGrounded` / `attack`, not a hard-coded `play()` call.
+
 ## Mental model
 
 ```
@@ -27,7 +38,7 @@ inputs ─▶ [transition graph] ─▶ active state ─▶ (Δt) ─▶ active
 
 - **Inputs** — `Number` (continuous, e.g. `speed`), `Boolean` (toggle, e.g. `isGrounded`), `Trigger` (one-shot; auto-resets after a transition consumes it, e.g. `jump` / `attack`).
 - **States** — an animation key (into the atlas `animations`) + loop / on-end behaviour + optional speed multiplier.
-- **Transitions** — from a state (or **Any State**) to another when conditions over inputs hold (`Equals` / `NotEquals` / `GreaterThan` / `LessThan`). The highest-priority satisfied transition wins.
+- **Transitions** — from a state (or **Any State**) to another when conditions over inputs hold (`Equals` / `NotEquals` / `GreaterThan` / `LessThan` / `Trigger`). The highest-priority satisfied transition wins.
 - **`update(dt)`** — advances the playback timer; evaluates transitions (switching state, firing `onStateChange`, consuming triggers); computes the current frame from the animation's per-frame durations + loop; fires `onComplete` when a non-looping clip ends.
 
 ## Quick start — core (zero-dep)
@@ -72,6 +83,50 @@ It swaps the texture only when the active frame changes, and honours per-frame `
 
 Pass a plain `Sprite` — the adapter owns frame selection. (An `AnimatedSprite` is accepted since it extends `Sprite`, but its own playback is stopped on bind so it cannot fight the adapter for the texture.)
 
+### Complete example — a 6-frame explosion (play-once FX)
+
+The most common entry: a one-shot hit/impact FX (net-splash, muzzle flash) from a **6-frame explosion sprite sheet**, driven through the `/pixi` adapter. A `Trigger` fires a **non-looping** clip that plays once and auto-returns to a resting frame via `onEnd`. The full runnable version is [`examples/02-explosion-pixi/index.ts`](examples/02-explosion-pixi/index.ts) (`pnpm example:explosion`).
+
+```ts
+import { Assets, Sprite } from "pixi.js";
+import { createPixiSpriteAnimator } from "aispritejs/pixi";
+
+// A 6-frame explosion sprite sheet (PixiJS-v8 atlas): the `animations` block
+// names the clip → its frame keys; `frames` carries per-frame durations.
+const graph = {
+  animations: {
+    explosion: ["explosion_0", "explosion_1", "explosion_2", "explosion_3", "explosion_4", "explosion_5"],
+    idle: ["explosion_0"], // a 1-frame resting clip to hold between bursts
+  },
+  frames: {
+    explosion_0: { duration: 40 }, explosion_1: { duration: 40 }, explosion_2: { duration: 40 },
+    explosion_3: { duration: 40 }, explosion_4: { duration: 40 }, explosion_5: { duration: 40 },
+  },
+  inputs: { detonate: { type: "trigger" } },
+  states: {
+    idle: { animation: "idle", loop: true },
+    boom: { animation: "explosion", loop: false, onEnd: "idle" }, // play once → back to idle
+  },
+  transitions: [
+    { from: "*", to: "boom", when: [{ input: "detonate", op: "Trigger" }], priority: 10 },
+  ],
+  initial: "idle",
+} as const;
+
+// Load the packed sheet; its `.textures` cover every frame key the graph uses.
+const sheet = await Assets.load("explosion.json"); // a PIXI.Spritesheet
+const sprite = new Sprite();
+const fx = createPixiSpriteAnimator(sprite, graph, sheet);
+
+// Fire the one-shot trigger on impact:
+fx.fireTrigger("detonate");
+
+// Drive the burst from your PixiJS render loop (e.g. `app.ticker`), advancing by
+// elapsed ms: `app.ticker.add((ticker) => fx.update(ticker.deltaMS))`.
+```
+
+`update(dt)` plays `explosion_0…explosion_5` once (honouring each frame's `duration`); on the tick that completes the clip it fires `onComplete` and, because `boom` declares `onEnd`, auto-transitions to `idle` in that **same** tick — so the last frame isn't held, and `activeState` reads `idle` right after. Re-`fireTrigger("detonate")` to replay. The same graph runs with no renderer — see [`examples/02-explosion-pixi/index.ts`](examples/02-explosion-pixi/index.ts), which exercises the real adapter headlessly with plain `Texture` / `Sprite` instances.
+
 ## Data format (atlas)
 
 `aispritejs` reads a **PixiJS v8-native** spritesheet atlas (`meta` / `frames` / `animations`) — the same shape the family's sprite pipeline emits — augmented with an `aispritejs` **input-driven** control block:
@@ -155,7 +210,7 @@ Every subscription returns an unsubscribe function and accepts `{ signal }` (an
 
 These rules are deterministic and frozen for the 1.x line once 1.0 ships:
 
-- **`update(dt)` order** — advance the timer by `dt × speed` (negative `dt` clamps to `0`); evaluate transitions; recompute the active frame; fire `onComplete` for a finished non-looping clip and then any `onEnd` auto-transition. An explicit input transition therefore wins over end-of-clip behaviour on the same frame.
+- **`update(dt)` order** — advance the timer by `dt × speed` (non-finite or non-positive `dt` clamps to `0`); evaluate transitions; recompute the active frame; fire `onComplete` for a finished non-looping clip and then any `onEnd` auto-transition. An explicit input transition therefore wins over end-of-clip behaviour on the same frame.
 - **Transition resolution** — among the transitions leaving the current state (plus **Any-State** `from: "*"`), candidates are ordered by `priority` (desc) then declared order (asc); the **first effective** one is taken. All `when` conditions must hold (logical AND).
 - **Self-transition rule** — a transition whose `to` equals the current state is *effective only if it consumes a Trigger*. A Number/Boolean self-loop is skipped, so it cannot reset the clip to frame 0 every frame. A trigger-bearing self-transition **restarts** the clip (e.g. re-attack) but does **not** fire `onStateChange` (the state name is unchanged).
 - **Triggers** — `fireTrigger(name)` marks a trigger pending; it stays pending across frames until a transition that checks it is taken, which **consumes** it. One fire → at most one transition.
@@ -195,12 +250,15 @@ Behavioural `vitest` suites cover inputs, transitions, trigger consumption, fram
 ```bash
 pnpm test        # run once
 pnpm coverage    # with thresholds
-pnpm example:platformer
+pnpm example:platformer  # renderer-free core demo
+pnpm example:explosion   # 6-frame play-once FX via the /pixi adapter
 ```
 
 ## Status
 
-**v0.1.0 — full first release.** All roadmap modules (1–4) ship together: the renderer-agnostic core (`.`), the PixiJS v8 adapter (`aispritejs/pixi`), the atlas parser (`aispritejs/atlas`), and the JSON Schema (`aispritejs/schema`). Zero runtime dependencies; the root import graph contains no `pixi.js`; `pixi.js` is an optional, type-only peer used only by the `/pixi` subpath. Versioning and release tags are cut by the maintainer.
+**v0.1.3 — docs patch.** Adds a "When you DON'T need aispritejs" threshold and a complete, runnable 6-frame explosion (play-once FX) quickstart for the `/pixi` adapter; no source or API changes. v0.1.0 shipped all roadmap modules (1–4): the renderer-agnostic core (`.`), the PixiJS v8 adapter (`aispritejs/pixi`), the atlas parser (`aispritejs/atlas`), and the JSON Schema (`aispritejs/schema`); v0.1.1 added OIDC/SLSA publish provenance and v0.1.2 hardened validation — compile-time rejection of non-finite `speed` / `duration` / `defaultFrameDuration`, plus a runtime clamp of non-finite or non-positive `dt` (`dt <= 0`) to `0` in `update()`. See [CHANGELOG.md](CHANGELOG.md) for the full history. Zero runtime dependencies; the root import graph contains no `pixi.js`; `pixi.js` is an optional, type-only peer used only by the `/pixi` subpath.
+
+`aispritejs` is the newest package in the **ai\*js** family and follows its **own independent version line** — the `0.1.x` series reflects this package's own maturation, not alignment with any sibling's version number. Low usage in a given game (e.g. one built on static sprites) is expected, not a defect.
 
 ## Roadmap
 

package/README_ZHTW.md

@@ -19,6 +19,17 @@
 - **視覺 ≠ 邏輯。** 這嚴格來說是一個*視覺*動畫器，**不是**遊戲邏輯 FSM，也**不**相依 `aifsmjs`。用任何邏輯層（純程式、FSM、ECS）來驅動它 —— 它們以慣例組合，從不以相依耦合。
 - **輕巧又快。** O(1) 的輸入查找、對離開當前狀態的轉移做 O(N) 檢查、無每幀配置。
 
+## 何時你「不需要」aispritejs
+
+`aispritejs` 的價值在於影格選擇是**由執行期輸入驅動**、且橫跨**數個視覺狀態**時才會顯現。在這個門檻之下，直接用 PixiJS 就好 —— 用狀態機並無任何好處：
+
+- **單一 sprite／一張靜態圖片** → 純 PixiJS [`Sprite`](https://pixijs.download/release/docs/scene.Sprite.html)。沒有動畫、不需要圖集。
+- **單一循環片段、無任何分支**（轉動的金幣、閃爍的火把）→ PixiJS [`AnimatedSprite`](https://pixijs.download/release/docs/scene.AnimatedSprite.html)（`AnimatedSprite.fromFrames(...)`、`.play()`）。永遠以同一種方式播放的單一片段不需要輸入。
+- **沒有 texture atlas**（你並未把影格打包成 spritesheet）→ 直接載入圖片；`aispritejs` 從 PixiJS-v8 atlas（`animations` / `frames`）讀取它的影格。
+- **沒有多狀態切換** —— 若你的程式早已確切知道要播哪個片段、只需呼叫 `.play()` / `.gotoAndStop()`，你並不需要轉移圖。
+
+當你有**由輸入驅動、以 texture atlas 為後盾的多狀態視覺切換**時，才該動用 `aispritejs` —— 例如 `idle ⇄ walk → jump`，或由 trigger 觸發的一次性受擊 FX —— 此時畫面上顯示哪一格是 `speed` / `isGrounded` / `attack` 的函數，而非寫死的 `play()` 呼叫。
+
 ## 心智模型
 
 ```
@@ -27,7 +38,7 @@ inputs ─▶ [轉移圖] ─▶ 當前狀態 ─▶ (Δt) ─▶ 當前影格
 
 - **Inputs（輸入）** —— `Number`（連續，如 `speed`）、`Boolean`（開關，如 `isGrounded`）、`Trigger`（一次性；被某個轉移消耗後自動重置，如 `jump` / `attack`）。
 - **States（狀態）** —— 一個動畫鍵（指向 atlas 的 `animations`）加上 loop / on-end 行為與選用的速度倍率。
-- **Transitions（轉移）** —— 當輸入條件成立時（`Equals` / `NotEquals` / `GreaterThan` / `LessThan`），從某狀態（或 **Any State**）轉到另一狀態。優先度最高且成立者勝出。
+- **Transitions（轉移）** —— 當輸入條件成立時（`Equals` / `NotEquals` / `GreaterThan` / `LessThan` / `Trigger`），從某狀態（或 **Any State**）轉到另一狀態。優先度最高且成立者勝出。
 - **`update(dt)`** —— 推進播放計時器；評估轉移（切換狀態、觸發 `onStateChange`、消耗 trigger）；由動畫的逐影格時長加 loop 算出當前影格；非循環片段播完時觸發 `onComplete`。
 
 ## 快速開始 —— 核心（零相依）
@@ -70,6 +81,50 @@ view.fireTrigger("jump");
 
 它只在當前影格改變時換 texture，並尊重逐影格 `duration`（透過核心）與非置中／腳底樞軸（透過 `texture.defaultAnchor`；傳 `{ applyAnchor: false }` 可自行管理 anchor）。`view.sprite` 是綁定的 sprite；`dispose()` 拆除核心但不銷毀 sprite。
 
+### 完整範例 —— 一段 6 格爆炸（play-once FX）
+
+最常見的入門場景：一次性的受擊／撞擊 FX（水花、槍口閃光），來自一張 **6 格爆炸 sprite sheet**，透過 `/pixi` 轉接器驅動。一個 `Trigger` 觸發一段**非循環**片段，播放一次後經由 `onEnd` 自動回到靜止影格。完整可執行版本在 [`examples/02-explosion-pixi/index.ts`](examples/02-explosion-pixi/index.ts)（`pnpm example:explosion`）。
+
+```ts
+import { Assets, Sprite } from "pixi.js";
+import { createPixiSpriteAnimator } from "aispritejs/pixi";
+
+// 一張 6 格爆炸 sprite sheet（PixiJS-v8 atlas）：`animations` 區塊把片段
+// 命名 → 它的影格鍵；`frames` 帶有逐影格時長。
+const graph = {
+  animations: {
+    explosion: ["explosion_0", "explosion_1", "explosion_2", "explosion_3", "explosion_4", "explosion_5"],
+    idle: ["explosion_0"], // 一段 1 格的靜止片段，在每次爆發之間維持
+  },
+  frames: {
+    explosion_0: { duration: 40 }, explosion_1: { duration: 40 }, explosion_2: { duration: 40 },
+    explosion_3: { duration: 40 }, explosion_4: { duration: 40 }, explosion_5: { duration: 40 },
+  },
+  inputs: { detonate: { type: "trigger" } },
+  states: {
+    idle: { animation: "idle", loop: true },
+    boom: { animation: "explosion", loop: false, onEnd: "idle" }, // 播放一次 → 回到 idle
+  },
+  transitions: [
+    { from: "*", to: "boom", when: [{ input: "detonate", op: "Trigger" }], priority: 10 },
+  ],
+  initial: "idle",
+} as const;
+
+// 載入打包好的 sheet；它的 `.textures` 涵蓋 graph 用到的每一個影格鍵。
+const sheet = await Assets.load("explosion.json"); // 一個 PIXI.Spritesheet
+const sprite = new Sprite();
+const fx = createPixiSpriteAnimator(sprite, graph, sheet);
+
+// 在撞擊時觸發一次性 trigger：
+fx.fireTrigger("detonate");
+
+// 從你的 PixiJS render loop（例如 `app.ticker`）驅動這段爆發，依經過的
+// 毫秒數推進：`app.ticker.add((ticker) => fx.update(ticker.deltaMS))`。
+```
+
+`update(dt)` 把 `explosion_0…explosion_5` 播放一次（尊重每一格的 `duration`）；在播完片段的那一個 tick，它會觸發 `onComplete`，並因為 `boom` 宣告了 `onEnd`，在**同一個** tick 內自動轉移回 `idle` —— 所以不會停在最後一格，呼叫之後 `activeState` 立即讀到 `idle`。再次 `fireTrigger("detonate")` 即可重播。同一份 graph 在沒有渲染器時也能跑 —— 見 [`examples/02-explosion-pixi/index.ts`](examples/02-explosion-pixi/index.ts)，它以純 `Texture` / `Sprite` 實例、在無頭環境下操練真正的轉接器。
+
 ## 資料格式（atlas）
 
 `aispritejs` 讀取 **PixiJS v8 原生**的 spritesheet atlas（`meta` / `frames` / `animations`），並額外加上一個 `aispritejs` 的**輸入驅動**控制區塊：
@@ -147,7 +202,7 @@ anim.disposed;          // boolean
 
 這些規則是決定性的，並在 1.0 推出後對 1.x 凍結：
 
-- **`update(dt)` 順序** —— 以 `dt × speed` 推進計時器（負的 `dt` 夾到 `0`）；評估轉移；重算當前影格；為播完的非循環片段觸發 `onComplete`，接著執行任何 `onEnd` 自動轉移。因此同一幀內，明確的輸入轉移優先於片段結束行為。
+- **`update(dt)` 順序** —— 以 `dt × speed` 推進計時器（非有限或非正值的 `dt` 夾到 `0`）；評估轉移；重算當前影格；為播完的非循環片段觸發 `onComplete`，接著執行任何 `onEnd` 自動轉移。因此同一幀內，明確的輸入轉移優先於片段結束行為。
 - **轉移解析** —— 在離開當前狀態的轉移（加上 **Any-State** `from: "*"`）中，候選依 `priority`（遞減）再依宣告順序（遞增）排序；取**第一個有效**者。所有 `when` 條件須全部成立（邏輯 AND）。
 - **自我轉移規則** —— `to` 等於當前狀態的轉移，*只有在它消耗一個 Trigger 時才有效*。純 Number/Boolean 的自我迴圈會被跳過，因此不會每幀把片段重置回第 0 格。帶 trigger 的自我轉移會**重啟**片段（例如連續攻擊），但**不**觸發 `onStateChange`（狀態名稱沒變）。
 - **Triggers** —— `fireTrigger(name)` 把某 trigger 標記為 pending；它跨幀保持 pending，直到某個檢查它的轉移被採用而**消耗**它。一次 fire → 至多一次轉移。
@@ -198,7 +253,9 @@ pnpm example:platformer
 
 ## 狀態
 
-**v0.1.0 —— 完整首發。** roadmap 模組 1–4 一併 ship：與渲染器無關的核心（`.`）、PixiJS v8 轉接器（`aispritejs/pixi`）、atlas parser（`aispritejs/atlas`）、JSON Schema（`aispritejs/schema`）。零執行期相依；根 import 圖不含 `pixi.js`；`pixi.js` 是選用、type-only 的 peer,僅 `/pixi` 子路徑用。版本號與發佈 tag 由維護者切。
+**v0.1.3 —— 文件修補。** 新增「何時你『不需要』aispritejs」門檻，以及一個完整、可執行、針對 `/pixi` 轉接器的 6 格爆炸（play-once FX）快速範例；原始碼與 API 無變動。v0.1.0 一併 ship 所有 roadmap 模組 1–4：與渲染器無關的核心（`.`）、PixiJS v8 轉接器（`aispritejs/pixi`）、atlas parser（`aispritejs/atlas`）、JSON Schema（`aispritejs/schema`）；v0.1.1 加上 OIDC/SLSA 發佈 provenance，v0.1.2 強化驗證 —— 在編譯期拒絕非有限的 `speed` / `duration` / `defaultFrameDuration`，並在 `update()` 執行期把非有限或非正值（`dt <= 0`）的 `dt` 夾到 `0`。完整歷史請見 [CHANGELOG.md](CHANGELOG.md)。零執行期相依；根 import 圖不含 `pixi.js`；`pixi.js` 是選用、type-only 的 peer，僅 `/pixi` 子路徑用。
+
+`aispritejs` 是 **ai\*js** 家族中最新的套件，採用**自己獨立的版本線** —— `0.1.x` 系列反映的是這個套件自身的成熟度，而非與任何手足套件的版本號對齊。在某個遊戲裡使用率低（例如以靜態 sprite 為主的遊戲）是正常現象，並非缺陷。
 
 ## Roadmap
 

package/dist/atlas/index.cjs

@@ -32,6 +32,9 @@ var InputTypeError = class extends Error {
 
 // src/sprite/compile.ts
 var DEFAULT_FRAME_DURATION = 100;
+function isObject(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
 function compileGraph(graph) {
   const stateEntries = Object.entries(graph.states);
   if (stateEntries.length === 0) {
@@ -45,32 +48,41 @@ function compileGraph(graph) {
     }
   }
   const defaultDuration = graph.defaultFrameDuration ?? DEFAULT_FRAME_DURATION;
-  if (!(defaultDuration > 0)) {
-    throw new InvalidGraphError(`defaultFrameDuration must be > 0, got ${defaultDuration}`);
+  if (!Number.isFinite(defaultDuration) || defaultDuration <= 0) {
+    throw new InvalidGraphError(
+      `defaultFrameDuration must be a finite number > 0, got ${defaultDuration}`
+    );
   }
   if (graph.frames) {
     for (const [key, timing] of Object.entries(graph.frames)) {
-      if (timing.duration !== void 0 && !(timing.duration > 0)) {
-        throw new InvalidGraphError(`frame "${key}" duration must be > 0, got ${timing.duration}`);
+      if (!isObject(timing)) {
+        throw new InvalidGraphError(`frame "${key}" timing must be an object`);
+      }
+      if (timing.duration !== void 0 && (!Number.isFinite(timing.duration) || timing.duration <= 0)) {
+        throw new InvalidGraphError(
+          `frame "${key}" duration must be a finite number > 0, got ${timing.duration}`
+        );
       }
     }
   }
   const initial = graph.initial ?? stateEntries[0][0];
-  if (!(initial in graph.states)) {
+  if (!Object.hasOwn(graph.states, initial)) {
     throw new InvalidGraphError(`initial state "${initial}" is not declared`);
   }
   const states = /* @__PURE__ */ new Map();
   for (const [name, st] of stateEntries) {
     const frameKeys = graph.animations[st.animation];
-    if (frameKeys === void 0) {
+    if (frameKeys === void 0 || !Object.hasOwn(graph.animations, st.animation)) {
       throw new InvalidGraphError(`state "${name}" references unknown animation "${st.animation}"`);
     }
     if (frameKeys.length === 0) {
       throw new InvalidGraphError(`animation "${st.animation}" (state "${name}") has no frames`);
     }
     const speed = st.speed ?? 1;
-    if (!(speed > 0)) {
-      throw new InvalidGraphError(`state "${name}" speed must be > 0, got ${speed}`);
+    if (!Number.isFinite(speed) || speed <= 0) {
+      throw new InvalidGraphError(
+        `state "${name}" speed must be a finite number > 0, got ${speed}`
+      );
     }
     const loop = st.loop === true;
     if (loop && st.onEnd !== void 0) {
@@ -78,7 +90,7 @@ function compileGraph(graph) {
         `state "${name}" loops, so onEnd "${st.onEnd}" would never fire; set loop:false or drop onEnd`
       );
     }
-    if (st.onEnd !== void 0 && !(st.onEnd in graph.states)) {
+    if (st.onEnd !== void 0 && !Object.hasOwn(graph.states, st.onEnd)) {
       throw new InvalidGraphError(`state "${name}" onEnd target "${st.onEnd}" is not declared`);
     }
     const cumulative = [];
@@ -100,17 +112,23 @@ function compileGraph(graph) {
   }
   const compiled = [];
   graph.transitions.forEach((t, order) => {
-    if (t.from !== "*" && !(t.from in graph.states)) {
+    if (!isObject(t)) {
+      throw new InvalidGraphError(`transition #${order} must be an object`);
+    }
+    if (t.when !== void 0 && !Array.isArray(t.when)) {
+      throw new InvalidGraphError(`transition #${order} "when" must be an array`);
+    }
+    if (t.from !== "*" && !Object.hasOwn(graph.states, t.from)) {
       throw new InvalidGraphError(`transition #${order} from "${t.from}" is not a declared state`);
     }
-    if (!(t.to in graph.states)) {
+    if (!Object.hasOwn(graph.states, t.to)) {
       throw new InvalidGraphError(`transition #${order} to "${t.to}" is not a declared state`);
     }
     const conditions = [];
     const triggers = [];
     for (const c of t.when ?? []) {
       const def = graph.inputs[c.input];
-      if (def === void 0) {
+      if (def === void 0 || !Object.hasOwn(graph.inputs, c.input)) {
         throw new InvalidGraphError(
           `transition #${order} condition references unknown input "${c.input}"`
         );
@@ -363,7 +381,7 @@ function createSpriteAnimator(graph) {
   }
   function update(deltaMs) {
     if (disposed) throw new SpriteAnimatorDisposedError();
-    elapsed += (deltaMs > 0 ? deltaMs : 0) * current.speed;
+    elapsed += (Number.isFinite(deltaMs) && deltaMs > 0 ? deltaMs : 0) * current.speed;
     const chosen = resolve();
     if (chosen) {
       enter(chosen.to, chosen.triggers);
@@ -449,9 +467,6 @@ var InvalidAtlasError = class extends Error {
     this.name = "InvalidAtlasError";
   }
 };
-function isObject(v) {
-  return typeof v === "object" && v !== null && !Array.isArray(v);
-}
 function isForeignStates(states) {
   return isObject(states) && typeof states.initial === "string" && isObject(states.definitions);
 }
@@ -475,6 +490,14 @@ function parseAtlas(atlas, control) {
   if (frames !== void 0 && !isObject(frames)) {
     throw new InvalidAtlasError("`frames`, if present, must be an object keyed by frame key");
   }
+  if (isObject(frames)) {
+    for (const [key, entry] of Object.entries(frames)) {
+      if (!isObject(entry)) {
+        const actualType = entry === null ? "null" : Array.isArray(entry) ? "array" : typeof entry;
+        throw new InvalidAtlasError(`frame entry "${key}" must be an object, got ${actualType}`);
+      }
+    }
+  }
   let resolved;
   if (control) {
     resolved = control;
@@ -489,10 +512,30 @@ function parseAtlas(atlas, control) {
         "atlas has no aispritejs control block (inputs/states/transitions); pass one as the second argument"
       );
     }
+    for (const [key, val] of Object.entries(atlas.inputs)) {
+      if (!isObject(val)) {
+        const actualType = val === null ? "null" : Array.isArray(val) ? "array" : typeof val;
+        throw new InvalidAtlasError(`input entry "${key}" must be an object, got ${actualType}`);
+      }
+    }
+    for (const [key, val] of Object.entries(atlas.states)) {
+      if (!isObject(val)) {
+        const actualType = val === null ? "null" : Array.isArray(val) ? "array" : typeof val;
+        throw new InvalidAtlasError(`state entry "${key}" must be an object, got ${actualType}`);
+      }
+    }
+    const rawTransitions = atlas.transitions;
+    for (let i = 0; i < rawTransitions.length; i++) {
+      const entry = rawTransitions[i];
+      if (!isObject(entry)) {
+        const actualType = entry === null ? "null" : Array.isArray(entry) ? "array" : typeof entry;
+        throw new InvalidAtlasError(`transitions[${i}] must be an object, got ${actualType}`);
+      }
+    }
     resolved = {
       inputs: atlas.inputs,
       states: atlas.states,
-      transitions: atlas.transitions,
+      transitions: rawTransitions,
       ...typeof atlas.initial === "string" ? { initial: atlas.initial } : {},
       ...typeof atlas.defaultFrameDuration === "number" ? { defaultFrameDuration: atlas.defaultFrameDuration } : {}
     };

package/dist/atlas/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/sprite/errors.ts","../../src/sprite/compile.ts","../../src/sprite/emitter.ts","../../src/sprite/inputs.ts","../../src/sprite/machine.ts","../../src/atlas/parse.ts"],"names":["v"],"mappings":"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","file":"index.cjs","sourcesContent":["// aispritejs — named error classes. Named errors instead of bare throws let\n// callers branch on failure mode (e.g. distinguish a typo'd input from a\n// post-dispose call) and keep stack traces meaningful.\n\n/**\n * Thrown by `setInput` / `fireTrigger` / `update` / `reset` after the animator\n * has been disposed.\n *\n * @public\n */\nexport class SpriteAnimatorDisposedError extends Error {\n  constructor() {\n    super(\"aispritejs: animator has been disposed; this operation is not allowed\");\n    this.name = \"SpriteAnimatorDisposedError\";\n  }\n}\n\n/**\n * Thrown by `createSpriteAnimator` when the graph fails validation — a state\n * references a missing animation, a transition points at an unknown state, a\n * condition uses an operator the input kind does not support, a duration is\n * non-positive, and so on. Fail-fast: an invalid graph never produces a\n * half-built animator.\n *\n * @public\n */\nexport class InvalidGraphError extends Error {\n  constructor(message: string) {\n    super(`aispritejs: invalid graph — ${message}`);\n    this.name = \"InvalidGraphError\";\n  }\n}\n\n/**\n * Thrown by `setInput` / `fireTrigger` when the named input is not declared in\n * the graph's `inputs` block.\n *\n * @public\n */\nexport class UnknownInputError extends Error {\n  readonly input: string;\n  constructor(input: string) {\n    super(`aispritejs: unknown input \"${input}\"; declare it in the graph's inputs block`);\n    this.name = \"UnknownInputError\";\n    this.input = input;\n  }\n}\n\n/**\n * Thrown when an input is used against its kind — `setInput` with the wrong\n * value type, `setInput` on a Trigger, or `fireTrigger` on a non-Trigger.\n *\n * @public\n */\nexport class InputTypeError extends Error {\n  readonly input: string;\n  constructor(input: string, message: string) {\n    super(`aispritejs: input \"${input}\" — ${message}`);\n    this.name = \"InputTypeError\";\n    this.input = input;\n  }\n}\n","// aispritejs — graph compiler. Validates every cross-reference the type system\n// cannot (animation existence, transition targets, operator/kind compatibility,\n// positive durations) and normalises the graph into a precomputed runtime form:\n// per-state cumulative frame timings and per-state transition candidate lists\n// sorted by (priority desc, declared-order asc). All allocation happens here,\n// once, so `update()` stays allocation-free.\n\nimport { InvalidGraphError } from \"./errors.js\";\nimport type { InputStore } from \"./inputs.js\";\nimport type { SpriteGraph } from \"./types.js\";\n\n/** A compiled condition: a closure that reads the live store and returns a boolean. */\nexport type ConditionFn = (store: InputStore) => boolean;\n\nexport interface CompiledTransition {\n  readonly from: string;\n  readonly to: string;\n  readonly priority: number;\n  /** Declared index — the deterministic tie-break when priorities are equal. */\n  readonly order: number;\n  /** AND-ed at runtime; empty means \"matches unconditionally\". */\n  readonly conditions: readonly ConditionFn[];\n  /** Trigger input names this transition consumes when taken. */\n  readonly triggers: readonly string[];\n}\n\nexport interface CompiledState {\n  readonly name: string;\n  readonly animation: string;\n  readonly loop: boolean;\n  readonly speed: number;\n  readonly onEnd: string | undefined;\n  readonly frameKeys: readonly string[];\n  /** `cumulative[i]` = summed duration of frames `0..i`; last entry === `total`. */\n  readonly cumulative: readonly number[];\n  readonly total: number;\n}\n\nexport interface CompiledGraph {\n  readonly initial: string;\n  readonly states: ReadonlyMap<string, CompiledState>;\n  readonly candidatesByState: ReadonlyMap<string, readonly CompiledTransition[]>;\n}\n\nconst DEFAULT_FRAME_DURATION = 100;\n\nexport function compileGraph(graph: SpriteGraph): CompiledGraph {\n  const stateEntries = Object.entries(graph.states);\n  if (stateEntries.length === 0) {\n    throw new InvalidGraphError(\"states must declare at least one state\");\n  }\n\n  // Inputs: types are enforced by TS, but a graph loaded from untyped JSON can\n  // still carry a bad `type`. Validate so a bad input fails here, not silently.\n  for (const [name, def] of Object.entries(graph.inputs)) {\n    if (def.type !== \"number\" && def.type !== \"boolean\" && def.type !== \"trigger\") {\n      throw new InvalidGraphError(\n        `input \"${name}\" has unknown type \"${(def as { type: string }).type}\"`,\n      );\n    }\n  }\n\n  const defaultDuration = graph.defaultFrameDuration ?? DEFAULT_FRAME_DURATION;\n  if (!(defaultDuration > 0)) {\n    throw new InvalidGraphError(`defaultFrameDuration must be > 0, got ${defaultDuration}`);\n  }\n\n  if (graph.frames) {\n    for (const [key, timing] of Object.entries(graph.frames)) {\n      if (timing.duration !== undefined && !(timing.duration > 0)) {\n        throw new InvalidGraphError(`frame \"${key}\" duration must be > 0, got ${timing.duration}`);\n      }\n    }\n  }\n\n  const initial = graph.initial ?? stateEntries[0]![0];\n  if (!(initial in graph.states)) {\n    throw new InvalidGraphError(`initial state \"${initial}\" is not declared`);\n  }\n\n  // --- compile states -----------------------------------------------------\n  const states = new Map<string, CompiledState>();\n  for (const [name, st] of stateEntries) {\n    const frameKeys = graph.animations[st.animation];\n    if (frameKeys === undefined) {\n      throw new InvalidGraphError(`state \"${name}\" references unknown animation \"${st.animation}\"`);\n    }\n    if (frameKeys.length === 0) {\n      throw new InvalidGraphError(`animation \"${st.animation}\" (state \"${name}\") has no frames`);\n    }\n    const speed = st.speed ?? 1;\n    if (!(speed > 0)) {\n      throw new InvalidGraphError(`state \"${name}\" speed must be > 0, got ${speed}`);\n    }\n    const loop = st.loop === true;\n    if (loop && st.onEnd !== undefined) {\n      throw new InvalidGraphError(\n        `state \"${name}\" loops, so onEnd \"${st.onEnd}\" would never fire; set loop:false or drop onEnd`,\n      );\n    }\n    if (st.onEnd !== undefined && !(st.onEnd in graph.states)) {\n      throw new InvalidGraphError(`state \"${name}\" onEnd target \"${st.onEnd}\" is not declared`);\n    }\n\n    const cumulative: number[] = [];\n    let running = 0;\n    for (const key of frameKeys) {\n      running += graph.frames?.[key]?.duration ?? defaultDuration;\n      cumulative.push(running);\n    }\n\n    states.set(name, {\n      name,\n      animation: st.animation,\n      loop,\n      speed,\n      onEnd: st.onEnd,\n      frameKeys,\n      cumulative,\n      total: running,\n    });\n  }\n\n  // --- compile transitions ------------------------------------------------\n  const compiled: CompiledTransition[] = [];\n  graph.transitions.forEach((t, order) => {\n    if (t.from !== \"*\" && !(t.from in graph.states)) {\n      throw new InvalidGraphError(`transition #${order} from \"${t.from}\" is not a declared state`);\n    }\n    if (!(t.to in graph.states)) {\n      throw new InvalidGraphError(`transition #${order} to \"${t.to}\" is not a declared state`);\n    }\n\n    const conditions: ConditionFn[] = [];\n    const triggers: string[] = [];\n    for (const c of t.when ?? []) {\n      const def = graph.inputs[c.input];\n      if (def === undefined) {\n        throw new InvalidGraphError(\n          `transition #${order} condition references unknown input \"${c.input}\"`,\n        );\n      }\n      compileCondition(order, c.input, c.op, c.value, def.type, conditions, triggers);\n    }\n\n    compiled.push({\n      from: t.from,\n      to: t.to,\n      priority: t.priority ?? 0,\n      order,\n      conditions,\n      triggers,\n    });\n  });\n\n  // --- group candidates per state (own + Any-State), sorted ---------------\n  const candidatesByState = new Map<string, readonly CompiledTransition[]>();\n  for (const [name] of stateEntries) {\n    const list = compiled.filter((t) => t.from === name || t.from === \"*\");\n    // Stable by construction (declared order), but make the tie-break explicit.\n    list.sort((a, b) => b.priority - a.priority || a.order - b.order);\n    candidatesByState.set(name, list);\n  }\n\n  return { initial, states, candidatesByState };\n}\n\nfunction compileCondition(\n  order: number,\n  input: string,\n  op: string,\n  value: number | boolean | undefined,\n  kind: \"number\" | \"boolean\" | \"trigger\",\n  out: ConditionFn[],\n  triggers: string[],\n): void {\n  switch (op) {\n    case \"Trigger\": {\n      if (kind !== \"trigger\") {\n        throw new InvalidGraphError(\n          `transition #${order}: op Trigger requires a trigger input, but \"${input}\" is ${kind}`,\n        );\n      }\n      if (value !== undefined) {\n        throw new InvalidGraphError(\n          `transition #${order}: Trigger condition on \"${input}\" must not carry a value`,\n        );\n      }\n      out.push((s) => s.isPending(input));\n      triggers.push(input);\n      return;\n    }\n    case \"GreaterThan\":\n    case \"LessThan\": {\n      if (kind !== \"number\") {\n        throw new InvalidGraphError(\n          `transition #${order}: op ${op} requires a number input, but \"${input}\" is ${kind}`,\n        );\n      }\n      if (typeof value !== \"number\") {\n        throw new InvalidGraphError(\n          `transition #${order}: op ${op} on \"${input}\" needs a numeric value`,\n        );\n      }\n      const v = value;\n      out.push(\n        op === \"GreaterThan\" ? (s) => s.readNumber(input) > v : (s) => s.readNumber(input) < v,\n      );\n      return;\n    }\n    case \"Equals\":\n    case \"NotEquals\": {\n      if (kind === \"trigger\") {\n        throw new InvalidGraphError(\n          `transition #${order}: op ${op} cannot apply to trigger input \"${input}\"`,\n        );\n      }\n      if (kind === \"number\") {\n        if (typeof value !== \"number\") {\n          throw new InvalidGraphError(\n            `transition #${order}: op ${op} on number input \"${input}\" needs a numeric value`,\n          );\n        }\n        const v = value;\n        out.push(\n          op === \"Equals\" ? (s) => s.readNumber(input) === v : (s) => s.readNumber(input) !== v,\n        );\n        return;\n      }\n      // kind === \"boolean\"\n      if (typeof value !== \"boolean\") {\n        throw new InvalidGraphError(\n          `transition #${order}: op ${op} on boolean input \"${input}\" needs a boolean value`,\n        );\n      }\n      const v = value;\n      out.push(\n        op === \"Equals\" ? (s) => s.readBoolean(input) === v : (s) => s.readBoolean(input) !== v,\n      );\n      return;\n    }\n    default:\n      throw new InvalidGraphError(`transition #${order}: unknown operator \"${op}\"`);\n  }\n}\n","// aispritejs — a tiny single-payload typed signal. This is the package's OWN\n// emitter; it deliberately does NOT import `aieventjs` or any sibling (P0\n// zero-cross-package rule). Two instances back `onStateChange` and\n// `onComplete`.\n\nimport type { ListenerOptions, Unsubscribe } from \"./types.js\";\n\n/**\n * A typed fan-out of one payload `P`. `emit` is allocation-free in the common\n * case; it snapshots listeners only when there is at least one, so a handler\n * that unsubscribes (or a `once` handler) cannot corrupt the in-flight\n * iteration.\n */\nexport interface Signal<P> {\n  on(handler: (payload: P) => void, options?: ListenerOptions): Unsubscribe;\n  emit(payload: P): void;\n  /** Drop every listener (used by `dispose`). */\n  clear(): void;\n}\n\nexport function createSignal<P>(): Signal<P> {\n  const listeners = new Set<(payload: P) => void>();\n\n  function on(handler: (payload: P) => void, options?: ListenerOptions): Unsubscribe {\n    // An already-aborted signal means the listener is dead on arrival.\n    if (options?.signal?.aborted) return () => {};\n\n    let detachAbort: (() => void) | undefined;\n    // One teardown shared by the unsubscribe return, the once-wrapper, and the\n    // abort handler, so every path also detaches the abort listener — a `once`\n    // handler that passed a `{ signal }` must not leave the abort listener\n    // attached after it fires.\n    const cleanup: Unsubscribe = () => {\n      listeners.delete(wrapped);\n      if (detachAbort) {\n        detachAbort();\n        detachAbort = undefined;\n      }\n    };\n\n    let wrapped: (payload: P) => void = handler;\n    if (options?.once) {\n      wrapped = (payload) => {\n        cleanup();\n        handler(payload);\n      };\n    }\n    listeners.add(wrapped);\n\n    const sig = options?.signal;\n    if (sig) {\n      const onAbort = () => cleanup();\n      sig.addEventListener(\"abort\", onAbort, { once: true });\n      detachAbort = () => sig.removeEventListener(\"abort\", onAbort);\n    }\n\n    return cleanup;\n  }\n\n  function emit(payload: P): void {\n    if (listeners.size === 0) return;\n    // Snapshot so a handler that unsubscribes (including the once-wrapper)\n    // during dispatch does not perturb this pass.\n    for (const fn of [...listeners]) fn(payload);\n  }\n\n  function clear(): void {\n    listeners.clear();\n  }\n\n  return { on, emit, clear };\n}\n","// aispritejs — the input store. Holds Number / Boolean values and Trigger\n// pending flags with O(1) lookup. All declared inputs are seeded at\n// construction so reads are total (the compiler guarantees every condition\n// references a declared input of the matching kind, so the non-null reads\n// below are sound).\n\nimport { InputTypeError, UnknownInputError } from \"./errors.js\";\nimport type { InputDef } from \"./types.js\";\n\nexport interface InputStore {\n  /** Set a Number/Boolean input. Throws on unknown name or kind mismatch. */\n  setInput(name: string, value: number | boolean): void;\n  /** Mark a Trigger pending. Throws on unknown name or non-Trigger. */\n  fireTrigger(name: string): void;\n  /** Read a Number input (caller guarantees `name` is a declared Number). */\n  readNumber(name: string): number;\n  /** Read a Boolean input (caller guarantees `name` is a declared Boolean). */\n  readBoolean(name: string): boolean;\n  /** Whether a Trigger is currently pending. */\n  isPending(name: string): boolean;\n  /** Consume (reset) a pending Trigger after a transition takes it. */\n  consume(name: string): void;\n  /** Restore every input to its declared default and clear all triggers. */\n  reset(): void;\n}\n\ntype Kind = \"number\" | \"boolean\" | \"trigger\";\n\nexport function createInputStore(inputs: Readonly<Record<string, InputDef>>): InputStore {\n  const kinds = new Map<string, Kind>();\n  const numberDefaults = new Map<string, number>();\n  const booleanDefaults = new Map<string, boolean>();\n  const numbers = new Map<string, number>();\n  const booleans = new Map<string, boolean>();\n  const triggers = new Map<string, boolean>();\n\n  for (const [name, def] of Object.entries(inputs)) {\n    kinds.set(name, def.type);\n    if (def.type === \"number\") {\n      const d = def.default ?? 0;\n      numberDefaults.set(name, d);\n      numbers.set(name, d);\n    } else if (def.type === \"boolean\") {\n      const d = def.default ?? false;\n      booleanDefaults.set(name, d);\n      booleans.set(name, d);\n    } else {\n      triggers.set(name, false);\n    }\n  }\n\n  function setInput(name: string, value: number | boolean): void {\n    const kind = kinds.get(name);\n    if (kind === undefined) throw new UnknownInputError(name);\n    if (kind === \"trigger\") {\n      throw new InputTypeError(name, \"is a Trigger; use fireTrigger()\");\n    }\n    if (kind === \"number\") {\n      if (typeof value !== \"number\") {\n        throw new InputTypeError(name, `expects a number, received ${typeof value}`);\n      }\n      if (Number.isNaN(value)) {\n        throw new InputTypeError(name, \"cannot be set to NaN\");\n      }\n      numbers.set(name, value);\n      return;\n    }\n    // kind === \"boolean\"\n    if (typeof value !== \"boolean\") {\n      throw new InputTypeError(name, `expects a boolean, received ${typeof value}`);\n    }\n    booleans.set(name, value);\n  }\n\n  function fireTrigger(name: string): void {\n    const kind = kinds.get(name);\n    if (kind === undefined) throw new UnknownInputError(name);\n    if (kind !== \"trigger\") {\n      throw new InputTypeError(name, \"is not a Trigger; use setInput()\");\n    }\n    triggers.set(name, true);\n  }\n\n  return {\n    setInput,\n    fireTrigger,\n    // `!` is sound: every declared input is seeded at construction and the\n    // compiler validates that conditions only read declared inputs of the\n    // matching kind, so these reads always hit a present entry.\n    readNumber: (name) => numbers.get(name)!,\n    readBoolean: (name) => booleans.get(name)!,\n    isPending: (name) => triggers.get(name) === true,\n    consume: (name) => {\n      triggers.set(name, false);\n    },\n    reset: () => {\n      for (const [name, d] of numberDefaults) numbers.set(name, d);\n      for (const [name, d] of booleanDefaults) booleans.set(name, d);\n      for (const name of triggers.keys()) triggers.set(name, false);\n    },\n  };\n}\n","// aispritejs — the input-driven visual state machine (the \"RiveSpriteStateMachine\"\n// engine), exposed only through the `createSpriteAnimator` factory. Implemented\n// as closures, not a class, so methods never depend on `this` and the\n// constructor surface stays hidden (family convention: public API = createX).\n//\n// Determinism: the only state advanced by `update` is `elapsed` (by `dt * speed`)\n// plus the input store; transitions are resolved over precomputed, deterministically\n// ordered candidate lists. Identical input + dt sequences therefore yield identical\n// frame sequences. The no-transition path allocates nothing.\n\nimport { type CompiledState, compileGraph } from \"./compile.js\";\nimport { createSignal } from \"./emitter.js\";\nimport { SpriteAnimatorDisposedError } from \"./errors.js\";\nimport { createInputStore } from \"./inputs.js\";\nimport type {\n  CompleteHandler,\n  ListenerOptions,\n  SpriteAnimator,\n  SpriteGraph,\n  StateChangeHandler,\n  Unsubscribe,\n} from \"./types.js\";\n\ninterface StateChangePayload {\n  readonly to: string;\n  readonly from: string;\n}\n\nconst NO_TRIGGERS: readonly string[] = [];\n\n/**\n * Build a renderer-agnostic visual animator from an input-driven graph.\n *\n * @param graph - inputs, states, transitions, animations (+ optional per-frame\n *   timings). Validated eagerly; an invalid graph throws {@link InvalidGraphError}\n *   and no animator is returned.\n * @returns a {@link SpriteAnimator}.\n *\n * @public\n */\nexport function createSpriteAnimator(graph: SpriteGraph): SpriteAnimator {\n  const compiled = compileGraph(graph);\n  const store = createInputStore(graph.inputs);\n  const stateChange = createSignal<StateChangePayload>();\n  const complete = createSignal<string>();\n\n  let current: CompiledState = mustState(compiled.initial);\n  let elapsed = 0;\n  let completed = false;\n  let activeFrameIndex = 0;\n  // Every compiled state has >= 1 frame (validated), so frame 0 always exists.\n  let activeFrameKey: string = current.frameKeys[0]!;\n  let disposed = false;\n\n  // `name` is always an initial / transition `to` / `onEnd` target, all\n  // validated to exist by compileGraph, so the lookup never misses.\n  function mustState(name: string): CompiledState {\n    return compiled.states.get(name)!;\n  }\n\n  /** Enter `to`, optionally consuming the triggers the taking transition used. */\n  function enter(to: string, consume: readonly string[]): void {\n    const from = current.name;\n    for (let i = 0; i < consume.length; i++) {\n      store.consume(consume[i]!);\n    }\n    current = mustState(to);\n    elapsed = 0;\n    completed = false;\n    activeFrameIndex = 0;\n    activeFrameKey = current.frameKeys[0]!;\n    // A self-re-entry (to === from) restarts the clip but is not a state change.\n    if (to !== from) stateChange.emit({ to, from });\n  }\n\n  /**\n   * First *effective* transition leaving `current` (own + Any-State), in\n   * (priority desc, declared order) — or `undefined`. A transition whose target\n   * equals the current state is effective only if it consumes a Trigger (a\n   * Number/Boolean self-loop would otherwise restart the clip every frame).\n   */\n  function resolve(): { to: string; triggers: readonly string[] } | undefined {\n    // Every state has a candidate list (built for all states by compileGraph).\n    const list = compiled.candidatesByState.get(current.name)!;\n    for (let i = 0; i < list.length; i++) {\n      const t = list[i]!;\n      let ok = true;\n      const conds = t.conditions;\n      for (let j = 0; j < conds.length; j++) {\n        if (!conds[j]!(store)) {\n          ok = false;\n          break;\n        }\n      }\n      if (!ok) continue;\n      if (t.to === current.name && t.triggers.length === 0) continue;\n      return { to: t.to, triggers: t.triggers };\n    }\n    return undefined;\n  }\n\n  function update(deltaMs: number): void {\n    if (disposed) throw new SpriteAnimatorDisposedError();\n\n    // Advance the playback timer (negative dt clamped to 0 for determinism).\n    elapsed += (deltaMs > 0 ? deltaMs : 0) * current.speed;\n\n    // Evaluate input-driven transitions first; an explicit transition wins over\n    // implicit end-of-clip behaviour.\n    const chosen = resolve();\n    if (chosen) {\n      enter(chosen.to, chosen.triggers);\n      return;\n    }\n\n    // Compute the active frame from accumulated time vs cumulative durations.\n    const cs = current;\n    const n = cs.frameKeys.length;\n    let ended = false;\n    if (!cs.loop && elapsed >= cs.total) {\n      activeFrameIndex = n - 1;\n      ended = true;\n    } else {\n      const t = cs.loop ? elapsed % cs.total : elapsed;\n      let i = 0;\n      // First index whose cumulative end exceeds t (i < n-1 keeps it in range,\n      // and t < total guarantees a match no later than the last frame).\n      while (i < n - 1 && t >= cs.cumulative[i]!) i++;\n      activeFrameIndex = i;\n    }\n    activeFrameKey = cs.frameKeys[activeFrameIndex]!;\n\n    // Fire onComplete once for a finished non-looping clip, then auto-transition.\n    if (ended && !completed) {\n      completed = true;\n      complete.emit(cs.name);\n      if (cs.onEnd !== undefined) enter(cs.onEnd, NO_TRIGGERS);\n    }\n  }\n\n  function reset(): void {\n    if (disposed) throw new SpriteAnimatorDisposedError();\n    const from = current.name;\n    store.reset();\n    current = mustState(compiled.initial);\n    elapsed = 0;\n    completed = false;\n    activeFrameIndex = 0;\n    activeFrameKey = current.frameKeys[0]!;\n    if (from !== compiled.initial) stateChange.emit({ to: compiled.initial, from });\n  }\n\n  function dispose(): void {\n    if (disposed) return;\n    disposed = true;\n    stateChange.clear();\n    complete.clear();\n  }\n\n  return {\n    setInput(name, value) {\n      if (disposed) throw new SpriteAnimatorDisposedError();\n      store.setInput(name, value);\n    },\n    fireTrigger(name) {\n      if (disposed) throw new SpriteAnimatorDisposedError();\n      store.fireTrigger(name);\n    },\n    update,\n    reset,\n    dispose,\n    onStateChange(handler: StateChangeHandler, options?: ListenerOptions): Unsubscribe {\n      if (disposed) return () => {};\n      return stateChange.on((p) => handler(p.to, p.from), options);\n    },\n    onComplete(handler: CompleteHandler, options?: ListenerOptions): Unsubscribe {\n      if (disposed) return () => {};\n      return complete.on(handler, options);\n    },\n    get activeState() {\n      return current.name;\n    },\n    get activeFrameKey() {\n      return activeFrameKey;\n    },\n    get activeFrameIndex() {\n      return activeFrameIndex;\n    },\n    get disposed() {\n      return disposed;\n    },\n  };\n}\n","// aispritejs/atlas — parse a PixiJS-v8-native atlas into a SpriteGraph the core\n// can consume. The atlas supplies the universal `animations` / `frames` blocks;\n// the input-driven control (`inputs` / `states` / `transitions`) comes either\n// from the atlas itself (the augmented shape in the README) or from a separate\n// `control` argument.\n//\n// A foreign, event-driven `states` block (the FSM shape `{ initial, definitions }`\n// emitted by other tools) is detected and ignored — `aispritejs` never adopts\n// it. The canonical structure is described by `schemas/aispritejs-graph.schema.json`,\n// shipped alongside this module; the checks below mirror it (fail-fast, no\n// runtime schema-validator dependency).\n//\n// Pure and zero-dependency: it imports only the core (same package) and returns\n// a plain SpriteGraph. `loadAtlas` additionally builds the animator, surfacing\n// semantic errors (InvalidGraphError) eagerly.\n\nimport {\n  type FrameTiming,\n  type InputDef,\n  type SpriteAnimator,\n  type SpriteGraph,\n  type StateDef,\n  type TransitionDef,\n  createSpriteAnimator,\n} from \"../sprite/index.js\";\n\n/**\n * Thrown when an atlas is structurally unusable — not an object, missing or\n * malformed `animations`, or carrying no `aispritejs` control block (and none\n * supplied separately). Semantic problems (unknown transition targets, etc.)\n * surface later as {@link InvalidGraphError} from the core.\n *\n * @public\n */\nexport class InvalidAtlasError extends Error {\n  constructor(message: string) {\n    super(`aispritejs/atlas: ${message}`);\n    this.name = \"InvalidAtlasError\";\n  }\n}\n\n/**\n * The `aispritejs` input-driven control block — everything in a {@link SpriteGraph}\n * except the universal `animations` / `frames` that come from the atlas. Supply\n * this as the second argument to drive an atlas whose own `states` block is\n * foreign (event-driven) or absent.\n *\n * @public\n */\nexport interface SpriteControl {\n  readonly inputs: Readonly<Record<string, InputDef>>;\n  readonly states: Readonly<Record<string, StateDef>>;\n  readonly transitions: readonly TransitionDef[];\n  readonly initial?: string;\n  readonly defaultFrameDuration?: number;\n}\n\nfunction isObject(v: unknown): v is Record<string, unknown> {\n  return typeof v === \"object\" && v !== null && !Array.isArray(v);\n}\n\n/**\n * True for the foreign, event-driven `states` shape `{ initial, definitions }`.\n * Decisive: an `aispritejs` `states` is a flat map whose values are objects, so\n * a *string* `states.initial` only ever appears in the foreign wrapper.\n */\nfunction isForeignStates(states: unknown): boolean {\n  return isObject(states) && typeof states.initial === \"string\" && isObject(states.definitions);\n}\n\nfunction assertAnimations(value: unknown): Record<string, readonly string[]> {\n  if (!isObject(value)) {\n    throw new InvalidAtlasError(\"`animations` must be an object of frame-key lists\");\n  }\n  for (const [name, list] of Object.entries(value)) {\n    if (!Array.isArray(list) || list.some((k) => typeof k !== \"string\")) {\n      throw new InvalidAtlasError(`animation \"${name}\" must be an array of frame-key strings`);\n    }\n  }\n  return value as Record<string, readonly string[]>;\n}\n\n/**\n * Parse a (possibly augmented) PixiJS-v8 atlas into a {@link SpriteGraph}.\n *\n * @param atlas - a parsed atlas object: `animations` (required) + optional\n *   `frames`, and — for the augmented shape — `inputs` / `states` / `transitions`.\n * @param control - an explicit {@link SpriteControl} that supplies (or overrides)\n *   the input-driven graph. Required when the atlas has no `aispritejs` control\n *   block or its `states` is foreign (event-driven).\n * @returns a {@link SpriteGraph} ready for `createSpriteAnimator`.\n * @throws {@link InvalidAtlasError} on a structurally unusable atlas.\n *\n * @public\n */\nexport function parseAtlas(atlas: unknown, control?: SpriteControl): SpriteGraph {\n  if (!isObject(atlas)) {\n    throw new InvalidAtlasError(\"atlas must be an object\");\n  }\n\n  const animations = assertAnimations(atlas.animations);\n  const frames = atlas.frames;\n  if (frames !== undefined && !isObject(frames)) {\n    throw new InvalidAtlasError(\"`frames`, if present, must be an object keyed by frame key\");\n  }\n\n  let resolved: SpriteControl;\n  if (control) {\n    resolved = control;\n  } else {\n    if (isForeignStates(atlas.states)) {\n      throw new InvalidAtlasError(\n        \"atlas `states` is event-driven (has `initial`/`definitions`); pass an aispritejs control block as the second argument\",\n      );\n    }\n    if (!isObject(atlas.inputs) || !isObject(atlas.states) || !Array.isArray(atlas.transitions)) {\n      throw new InvalidAtlasError(\n        \"atlas has no aispritejs control block (inputs/states/transitions); pass one as the second argument\",\n      );\n    }\n    resolved = {\n      inputs: atlas.inputs as Record<string, InputDef>,\n      states: atlas.states as Record<string, StateDef>,\n      transitions: atlas.transitions as readonly TransitionDef[],\n      ...(typeof atlas.initial === \"string\" ? { initial: atlas.initial } : {}),\n      ...(typeof atlas.defaultFrameDuration === \"number\"\n        ? { defaultFrameDuration: atlas.defaultFrameDuration }\n        : {}),\n    };\n  }\n\n  return {\n    animations,\n    ...(frames ? { frames: frames as Record<string, FrameTiming> } : {}),\n    inputs: resolved.inputs,\n    states: resolved.states,\n    transitions: resolved.transitions,\n    ...(resolved.initial !== undefined ? { initial: resolved.initial } : {}),\n    ...(resolved.defaultFrameDuration !== undefined\n      ? { defaultFrameDuration: resolved.defaultFrameDuration }\n      : {}),\n  };\n}\n\n/**\n * Parse an atlas and build a {@link SpriteAnimator} in one step — the fail-fast\n * \"load\" entry. Structural problems throw {@link InvalidAtlasError}; semantic\n * problems throw {@link InvalidGraphError} from the core.\n *\n * @public\n */\nexport function loadAtlas(atlas: unknown, control?: SpriteControl): SpriteAnimator {\n  return createSpriteAnimator(parseAtlas(atlas, control));\n}\n"]}
+{"version":3,"sources":["../../src/sprite/errors.ts","../../src/sprite/compile.ts","../../src/sprite/emitter.ts","../../src/sprite/inputs.ts","../../src/sprite/machine.ts","../../src/atlas/parse.ts"],"names":["v"],"mappings":"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","file":"index.cjs","sourcesContent":["// aispritejs — named error classes. Named errors instead of bare throws let\n// callers branch on failure mode (e.g. distinguish a typo'd input from a\n// post-dispose call) and keep stack traces meaningful.\n\n/**\n * Thrown by `setInput` / `fireTrigger` / `update` / `reset` after the animator\n * has been disposed.\n *\n * @public\n */\nexport class SpriteAnimatorDisposedError extends Error {\n  constructor() {\n    super(\"aispritejs: animator has been disposed; this operation is not allowed\");\n    this.name = \"SpriteAnimatorDisposedError\";\n  }\n}\n\n/**\n * Thrown by `createSpriteAnimator` when the graph fails validation — a state\n * references a missing animation, a transition points at an unknown state, a\n * condition uses an operator the input kind does not support, a duration is\n * non-positive, and so on. Fail-fast: an invalid graph never produces a\n * half-built animator.\n *\n * @public\n */\nexport class InvalidGraphError extends Error {\n  constructor(message: string) {\n    super(`aispritejs: invalid graph — ${message}`);\n    this.name = \"InvalidGraphError\";\n  }\n}\n\n/**\n * Thrown by `setInput` / `fireTrigger` when the named input is not declared in\n * the graph's `inputs` block.\n *\n * @public\n */\nexport class UnknownInputError extends Error {\n  readonly input: string;\n  constructor(input: string) {\n    super(`aispritejs: unknown input \"${input}\"; declare it in the graph's inputs block`);\n    this.name = \"UnknownInputError\";\n    this.input = input;\n  }\n}\n\n/**\n * Thrown when an input is used against its kind — `setInput` with the wrong\n * value type, `setInput` on a Trigger, or `fireTrigger` on a non-Trigger.\n *\n * @public\n */\nexport class InputTypeError extends Error {\n  readonly input: string;\n  constructor(input: string, message: string) {\n    super(`aispritejs: input \"${input}\" — ${message}`);\n    this.name = \"InputTypeError\";\n    this.input = input;\n  }\n}\n","// aispritejs — graph compiler. Validates every cross-reference the type system\n// cannot (animation existence, transition targets, operator/kind compatibility,\n// positive durations) and normalises the graph into a precomputed runtime form:\n// per-state cumulative frame timings and per-state transition candidate lists\n// sorted by (priority desc, declared-order asc). All allocation happens here,\n// once, so `update()` stays allocation-free.\n\nimport { InvalidGraphError } from \"./errors.js\";\nimport type { InputStore } from \"./inputs.js\";\nimport type { SpriteGraph } from \"./types.js\";\n\n/** A compiled condition: a closure that reads the live store and returns a boolean. */\nexport type ConditionFn = (store: InputStore) => boolean;\n\nexport interface CompiledTransition {\n  readonly from: string;\n  readonly to: string;\n  readonly priority: number;\n  /** Declared index — the deterministic tie-break when priorities are equal. */\n  readonly order: number;\n  /** AND-ed at runtime; empty means \"matches unconditionally\". */\n  readonly conditions: readonly ConditionFn[];\n  /** Trigger input names this transition consumes when taken. */\n  readonly triggers: readonly string[];\n}\n\nexport interface CompiledState {\n  readonly name: string;\n  readonly animation: string;\n  readonly loop: boolean;\n  readonly speed: number;\n  readonly onEnd: string | undefined;\n  readonly frameKeys: readonly string[];\n  /** `cumulative[i]` = summed duration of frames `0..i`; last entry === `total`. */\n  readonly cumulative: readonly number[];\n  readonly total: number;\n}\n\nexport interface CompiledGraph {\n  readonly initial: string;\n  readonly states: ReadonlyMap<string, CompiledState>;\n  readonly candidatesByState: ReadonlyMap<string, readonly CompiledTransition[]>;\n}\n\nconst DEFAULT_FRAME_DURATION = 100;\n\n/** @internal */\nexport function isObject(v: unknown): v is Record<string, unknown> {\n  return typeof v === \"object\" && v !== null && !Array.isArray(v);\n}\n\nexport function compileGraph(graph: SpriteGraph): CompiledGraph {\n  const stateEntries = Object.entries(graph.states);\n  if (stateEntries.length === 0) {\n    throw new InvalidGraphError(\"states must declare at least one state\");\n  }\n\n  // Inputs: types are enforced by TS, but a graph loaded from untyped JSON can\n  // still carry a bad `type`. Validate so a bad input fails here, not silently.\n  for (const [name, def] of Object.entries(graph.inputs)) {\n    if (def.type !== \"number\" && def.type !== \"boolean\" && def.type !== \"trigger\") {\n      throw new InvalidGraphError(\n        `input \"${name}\" has unknown type \"${(def as { type: string }).type}\"`,\n      );\n    }\n  }\n\n  const defaultDuration = graph.defaultFrameDuration ?? DEFAULT_FRAME_DURATION;\n  if (!Number.isFinite(defaultDuration) || defaultDuration <= 0) {\n    throw new InvalidGraphError(\n      `defaultFrameDuration must be a finite number > 0, got ${defaultDuration}`,\n    );\n  }\n\n  if (graph.frames) {\n    for (const [key, timing] of Object.entries(graph.frames)) {\n      if (!isObject(timing as unknown)) {\n        throw new InvalidGraphError(`frame \"${key}\" timing must be an object`);\n      }\n      if (\n        timing.duration !== undefined &&\n        (!Number.isFinite(timing.duration) || timing.duration <= 0)\n      ) {\n        throw new InvalidGraphError(\n          `frame \"${key}\" duration must be a finite number > 0, got ${timing.duration}`,\n        );\n      }\n    }\n  }\n\n  const initial = graph.initial ?? stateEntries[0]![0];\n  if (!Object.hasOwn(graph.states, initial)) {\n    throw new InvalidGraphError(`initial state \"${initial}\" is not declared`);\n  }\n\n  // --- compile states -----------------------------------------------------\n  const states = new Map<string, CompiledState>();\n  for (const [name, st] of stateEntries) {\n    const frameKeys = graph.animations[st.animation];\n    if (frameKeys === undefined || !Object.hasOwn(graph.animations, st.animation)) {\n      throw new InvalidGraphError(`state \"${name}\" references unknown animation \"${st.animation}\"`);\n    }\n    if (frameKeys.length === 0) {\n      throw new InvalidGraphError(`animation \"${st.animation}\" (state \"${name}\") has no frames`);\n    }\n    const speed = st.speed ?? 1;\n    if (!Number.isFinite(speed) || speed <= 0) {\n      throw new InvalidGraphError(\n        `state \"${name}\" speed must be a finite number > 0, got ${speed}`,\n      );\n    }\n    const loop = st.loop === true;\n    if (loop && st.onEnd !== undefined) {\n      throw new InvalidGraphError(\n        `state \"${name}\" loops, so onEnd \"${st.onEnd}\" would never fire; set loop:false or drop onEnd`,\n      );\n    }\n    if (st.onEnd !== undefined && !Object.hasOwn(graph.states, st.onEnd)) {\n      throw new InvalidGraphError(`state \"${name}\" onEnd target \"${st.onEnd}\" is not declared`);\n    }\n\n    const cumulative: number[] = [];\n    let running = 0;\n    for (const key of frameKeys) {\n      running += graph.frames?.[key]?.duration ?? defaultDuration;\n      cumulative.push(running);\n    }\n\n    states.set(name, {\n      name,\n      animation: st.animation,\n      loop,\n      speed,\n      onEnd: st.onEnd,\n      frameKeys,\n      cumulative,\n      total: running,\n    });\n  }\n\n  // --- compile transitions ------------------------------------------------\n  const compiled: CompiledTransition[] = [];\n  graph.transitions.forEach((t, order) => {\n    if (!isObject(t as unknown)) {\n      throw new InvalidGraphError(`transition #${order} must be an object`);\n    }\n    if (t.when !== undefined && !Array.isArray(t.when)) {\n      throw new InvalidGraphError(`transition #${order} \"when\" must be an array`);\n    }\n    if (t.from !== \"*\" && !Object.hasOwn(graph.states, t.from)) {\n      throw new InvalidGraphError(`transition #${order} from \"${t.from}\" is not a declared state`);\n    }\n    if (!Object.hasOwn(graph.states, t.to)) {\n      throw new InvalidGraphError(`transition #${order} to \"${t.to}\" is not a declared state`);\n    }\n\n    const conditions: ConditionFn[] = [];\n    const triggers: string[] = [];\n    for (const c of t.when ?? []) {\n      const def = graph.inputs[c.input];\n      if (def === undefined || !Object.hasOwn(graph.inputs, c.input)) {\n        throw new InvalidGraphError(\n          `transition #${order} condition references unknown input \"${c.input}\"`,\n        );\n      }\n      compileCondition(order, c.input, c.op, c.value, def.type, conditions, triggers);\n    }\n\n    compiled.push({\n      from: t.from,\n      to: t.to,\n      priority: t.priority ?? 0,\n      order,\n      conditions,\n      triggers,\n    });\n  });\n\n  // --- group candidates per state (own + Any-State), sorted ---------------\n  const candidatesByState = new Map<string, readonly CompiledTransition[]>();\n  for (const [name] of stateEntries) {\n    const list = compiled.filter((t) => t.from === name || t.from === \"*\");\n    // Stable by construction (declared order), but make the tie-break explicit.\n    list.sort((a, b) => b.priority - a.priority || a.order - b.order);\n    candidatesByState.set(name, list);\n  }\n\n  return { initial, states, candidatesByState };\n}\n\nfunction compileCondition(\n  order: number,\n  input: string,\n  op: string,\n  value: number | boolean | undefined,\n  kind: \"number\" | \"boolean\" | \"trigger\",\n  out: ConditionFn[],\n  triggers: string[],\n): void {\n  switch (op) {\n    case \"Trigger\": {\n      if (kind !== \"trigger\") {\n        throw new InvalidGraphError(\n          `transition #${order}: op Trigger requires a trigger input, but \"${input}\" is ${kind}`,\n        );\n      }\n      if (value !== undefined) {\n        throw new InvalidGraphError(\n          `transition #${order}: Trigger condition on \"${input}\" must not carry a value`,\n        );\n      }\n      out.push((s) => s.isPending(input));\n      triggers.push(input);\n      return;\n    }\n    case \"GreaterThan\":\n    case \"LessThan\": {\n      if (kind !== \"number\") {\n        throw new InvalidGraphError(\n          `transition #${order}: op ${op} requires a number input, but \"${input}\" is ${kind}`,\n        );\n      }\n      if (typeof value !== \"number\") {\n        throw new InvalidGraphError(\n          `transition #${order}: op ${op} on \"${input}\" needs a numeric value`,\n        );\n      }\n      const v = value;\n      out.push(\n        op === \"GreaterThan\" ? (s) => s.readNumber(input) > v : (s) => s.readNumber(input) < v,\n      );\n      return;\n    }\n    case \"Equals\":\n    case \"NotEquals\": {\n      if (kind === \"trigger\") {\n        throw new InvalidGraphError(\n          `transition #${order}: op ${op} cannot apply to trigger input \"${input}\"`,\n        );\n      }\n      if (kind === \"number\") {\n        if (typeof value !== \"number\") {\n          throw new InvalidGraphError(\n            `transition #${order}: op ${op} on number input \"${input}\" needs a numeric value`,\n          );\n        }\n        const v = value;\n        out.push(\n          op === \"Equals\" ? (s) => s.readNumber(input) === v : (s) => s.readNumber(input) !== v,\n        );\n        return;\n      }\n      // kind === \"boolean\"\n      if (typeof value !== \"boolean\") {\n        throw new InvalidGraphError(\n          `transition #${order}: op ${op} on boolean input \"${input}\" needs a boolean value`,\n        );\n      }\n      const v = value;\n      out.push(\n        op === \"Equals\" ? (s) => s.readBoolean(input) === v : (s) => s.readBoolean(input) !== v,\n      );\n      return;\n    }\n    default:\n      throw new InvalidGraphError(`transition #${order}: unknown operator \"${op}\"`);\n  }\n}\n","// aispritejs — a tiny single-payload typed signal. This is the package's OWN\n// emitter; it deliberately does NOT import `aieventjs` or any sibling (P0\n// zero-cross-package rule). Two instances back `onStateChange` and\n// `onComplete`.\n\nimport type { ListenerOptions, Unsubscribe } from \"./types.js\";\n\n/**\n * A typed fan-out of one payload `P`. `emit` is allocation-free in the common\n * case; it snapshots listeners only when there is at least one, so a handler\n * that unsubscribes (or a `once` handler) cannot corrupt the in-flight\n * iteration.\n */\nexport interface Signal<P> {\n  on(handler: (payload: P) => void, options?: ListenerOptions): Unsubscribe;\n  emit(payload: P): void;\n  /** Drop every listener (used by `dispose`). */\n  clear(): void;\n}\n\nexport function createSignal<P>(): Signal<P> {\n  const listeners = new Set<(payload: P) => void>();\n\n  function on(handler: (payload: P) => void, options?: ListenerOptions): Unsubscribe {\n    // An already-aborted signal means the listener is dead on arrival.\n    if (options?.signal?.aborted) return () => {};\n\n    let detachAbort: (() => void) | undefined;\n    // One teardown shared by the unsubscribe return, the once-wrapper, and the\n    // abort handler, so every path also detaches the abort listener — a `once`\n    // handler that passed a `{ signal }` must not leave the abort listener\n    // attached after it fires.\n    const cleanup: Unsubscribe = () => {\n      listeners.delete(wrapped);\n      if (detachAbort) {\n        detachAbort();\n        detachAbort = undefined;\n      }\n    };\n\n    let wrapped: (payload: P) => void = handler;\n    if (options?.once) {\n      wrapped = (payload) => {\n        cleanup();\n        handler(payload);\n      };\n    }\n    listeners.add(wrapped);\n\n    const sig = options?.signal;\n    if (sig) {\n      const onAbort = () => cleanup();\n      sig.addEventListener(\"abort\", onAbort, { once: true });\n      detachAbort = () => sig.removeEventListener(\"abort\", onAbort);\n    }\n\n    return cleanup;\n  }\n\n  function emit(payload: P): void {\n    if (listeners.size === 0) return;\n    // Snapshot so a handler that unsubscribes (including the once-wrapper)\n    // during dispatch does not perturb this pass.\n    for (const fn of [...listeners]) fn(payload);\n  }\n\n  function clear(): void {\n    listeners.clear();\n  }\n\n  return { on, emit, clear };\n}\n","// aispritejs — the input store. Holds Number / Boolean values and Trigger\n// pending flags with O(1) lookup. All declared inputs are seeded at\n// construction so reads are total (the compiler guarantees every condition\n// references a declared input of the matching kind, so the non-null reads\n// below are sound).\n\nimport { InputTypeError, UnknownInputError } from \"./errors.js\";\nimport type { InputDef } from \"./types.js\";\n\nexport interface InputStore {\n  /** Set a Number/Boolean input. Throws on unknown name or kind mismatch. */\n  setInput(name: string, value: number | boolean): void;\n  /** Mark a Trigger pending. Throws on unknown name or non-Trigger. */\n  fireTrigger(name: string): void;\n  /** Read a Number input (caller guarantees `name` is a declared Number). */\n  readNumber(name: string): number;\n  /** Read a Boolean input (caller guarantees `name` is a declared Boolean). */\n  readBoolean(name: string): boolean;\n  /** Whether a Trigger is currently pending. */\n  isPending(name: string): boolean;\n  /** Consume (reset) a pending Trigger after a transition takes it. */\n  consume(name: string): void;\n  /** Restore every input to its declared default and clear all triggers. */\n  reset(): void;\n}\n\ntype Kind = \"number\" | \"boolean\" | \"trigger\";\n\nexport function createInputStore(inputs: Readonly<Record<string, InputDef>>): InputStore {\n  const kinds = new Map<string, Kind>();\n  const numberDefaults = new Map<string, number>();\n  const booleanDefaults = new Map<string, boolean>();\n  const numbers = new Map<string, number>();\n  const booleans = new Map<string, boolean>();\n  const triggers = new Map<string, boolean>();\n\n  for (const [name, def] of Object.entries(inputs)) {\n    kinds.set(name, def.type);\n    if (def.type === \"number\") {\n      const d = def.default ?? 0;\n      numberDefaults.set(name, d);\n      numbers.set(name, d);\n    } else if (def.type === \"boolean\") {\n      const d = def.default ?? false;\n      booleanDefaults.set(name, d);\n      booleans.set(name, d);\n    } else {\n      triggers.set(name, false);\n    }\n  }\n\n  function setInput(name: string, value: number | boolean): void {\n    const kind = kinds.get(name);\n    if (kind === undefined) throw new UnknownInputError(name);\n    if (kind === \"trigger\") {\n      throw new InputTypeError(name, \"is a Trigger; use fireTrigger()\");\n    }\n    if (kind === \"number\") {\n      if (typeof value !== \"number\") {\n        throw new InputTypeError(name, `expects a number, received ${typeof value}`);\n      }\n      if (Number.isNaN(value)) {\n        throw new InputTypeError(name, \"cannot be set to NaN\");\n      }\n      numbers.set(name, value);\n      return;\n    }\n    // kind === \"boolean\"\n    if (typeof value !== \"boolean\") {\n      throw new InputTypeError(name, `expects a boolean, received ${typeof value}`);\n    }\n    booleans.set(name, value);\n  }\n\n  function fireTrigger(name: string): void {\n    const kind = kinds.get(name);\n    if (kind === undefined) throw new UnknownInputError(name);\n    if (kind !== \"trigger\") {\n      throw new InputTypeError(name, \"is not a Trigger; use setInput()\");\n    }\n    triggers.set(name, true);\n  }\n\n  return {\n    setInput,\n    fireTrigger,\n    // `!` is sound: every declared input is seeded at construction and the\n    // compiler validates that conditions only read declared inputs of the\n    // matching kind, so these reads always hit a present entry.\n    readNumber: (name) => numbers.get(name)!,\n    readBoolean: (name) => booleans.get(name)!,\n    isPending: (name) => triggers.get(name) === true,\n    consume: (name) => {\n      triggers.set(name, false);\n    },\n    reset: () => {\n      for (const [name, d] of numberDefaults) numbers.set(name, d);\n      for (const [name, d] of booleanDefaults) booleans.set(name, d);\n      for (const name of triggers.keys()) triggers.set(name, false);\n    },\n  };\n}\n","// aispritejs — the input-driven visual state machine (the \"RiveSpriteStateMachine\"\n// engine), exposed only through the `createSpriteAnimator` factory. Implemented\n// as closures, not a class, so methods never depend on `this` and the\n// constructor surface stays hidden (family convention: public API = createX).\n//\n// Determinism: the only state advanced by `update` is `elapsed` (by `dt * speed`)\n// plus the input store; transitions are resolved over precomputed, deterministically\n// ordered candidate lists. Identical input + dt sequences therefore yield identical\n// frame sequences. The no-transition path allocates nothing.\n\nimport { type CompiledState, compileGraph } from \"./compile.js\";\nimport { createSignal } from \"./emitter.js\";\nimport { SpriteAnimatorDisposedError } from \"./errors.js\";\nimport { createInputStore } from \"./inputs.js\";\nimport type {\n  CompleteHandler,\n  ListenerOptions,\n  SpriteAnimator,\n  SpriteGraph,\n  StateChangeHandler,\n  Unsubscribe,\n} from \"./types.js\";\n\ninterface StateChangePayload {\n  readonly to: string;\n  readonly from: string;\n}\n\nconst NO_TRIGGERS: readonly string[] = [];\n\n/**\n * Build a renderer-agnostic visual animator from an input-driven graph.\n *\n * @param graph - inputs, states, transitions, animations (+ optional per-frame\n *   timings). Validated eagerly; an invalid graph throws {@link InvalidGraphError}\n *   and no animator is returned.\n * @returns a {@link SpriteAnimator}.\n *\n * @public\n */\nexport function createSpriteAnimator(graph: SpriteGraph): SpriteAnimator {\n  const compiled = compileGraph(graph);\n  const store = createInputStore(graph.inputs);\n  const stateChange = createSignal<StateChangePayload>();\n  const complete = createSignal<string>();\n\n  let current: CompiledState = mustState(compiled.initial);\n  let elapsed = 0;\n  let completed = false;\n  let activeFrameIndex = 0;\n  // Every compiled state has >= 1 frame (validated), so frame 0 always exists.\n  let activeFrameKey: string = current.frameKeys[0]!;\n  let disposed = false;\n\n  // `name` is always an initial / transition `to` / `onEnd` target, all\n  // validated to exist by compileGraph, so the lookup never misses.\n  function mustState(name: string): CompiledState {\n    return compiled.states.get(name)!;\n  }\n\n  /** Enter `to`, optionally consuming the triggers the taking transition used. */\n  function enter(to: string, consume: readonly string[]): void {\n    const from = current.name;\n    for (let i = 0; i < consume.length; i++) {\n      store.consume(consume[i]!);\n    }\n    current = mustState(to);\n    elapsed = 0;\n    completed = false;\n    activeFrameIndex = 0;\n    activeFrameKey = current.frameKeys[0]!;\n    // A self-re-entry (to === from) restarts the clip but is not a state change.\n    if (to !== from) stateChange.emit({ to, from });\n  }\n\n  /**\n   * First *effective* transition leaving `current` (own + Any-State), in\n   * (priority desc, declared order) — or `undefined`. A transition whose target\n   * equals the current state is effective only if it consumes a Trigger (a\n   * Number/Boolean self-loop would otherwise restart the clip every frame).\n   */\n  function resolve(): { to: string; triggers: readonly string[] } | undefined {\n    // Every state has a candidate list (built for all states by compileGraph).\n    const list = compiled.candidatesByState.get(current.name)!;\n    for (let i = 0; i < list.length; i++) {\n      const t = list[i]!;\n      let ok = true;\n      const conds = t.conditions;\n      for (let j = 0; j < conds.length; j++) {\n        if (!conds[j]!(store)) {\n          ok = false;\n          break;\n        }\n      }\n      if (!ok) continue;\n      if (t.to === current.name && t.triggers.length === 0) continue;\n      return { to: t.to, triggers: t.triggers };\n    }\n    return undefined;\n  }\n\n  function update(deltaMs: number): void {\n    if (disposed) throw new SpriteAnimatorDisposedError();\n\n    // Advance the playback timer (non-finite or non-positive dt clamped to 0 for determinism).\n    // NOTE: `elapsed` accumulates without bound in looping states (intentional design choice).\n    // Drift from floating-point accumulation is sub-ULP-relevant only after continuous play\n    // on the order of years; a periodic reset (e.g. on state entry) would be premature.\n    elapsed += (Number.isFinite(deltaMs) && deltaMs > 0 ? deltaMs : 0) * current.speed;\n\n    // Evaluate input-driven transitions first; an explicit transition wins over\n    // implicit end-of-clip behaviour.\n    const chosen = resolve();\n    if (chosen) {\n      enter(chosen.to, chosen.triggers);\n      return;\n    }\n\n    // Compute the active frame from accumulated time vs cumulative durations.\n    const cs = current;\n    const n = cs.frameKeys.length;\n    let ended = false;\n    if (!cs.loop && elapsed >= cs.total) {\n      activeFrameIndex = n - 1;\n      ended = true;\n    } else {\n      const t = cs.loop ? elapsed % cs.total : elapsed;\n      let i = 0;\n      // First index whose cumulative end exceeds t (i < n-1 keeps it in range,\n      // and t < total guarantees a match no later than the last frame).\n      while (i < n - 1 && t >= cs.cumulative[i]!) i++;\n      activeFrameIndex = i;\n    }\n    activeFrameKey = cs.frameKeys[activeFrameIndex]!;\n\n    // Fire onComplete once for a finished non-looping clip, then auto-transition.\n    if (ended && !completed) {\n      completed = true;\n      complete.emit(cs.name);\n      if (cs.onEnd !== undefined) enter(cs.onEnd, NO_TRIGGERS);\n    }\n  }\n\n  function reset(): void {\n    if (disposed) throw new SpriteAnimatorDisposedError();\n    const from = current.name;\n    store.reset();\n    current = mustState(compiled.initial);\n    elapsed = 0;\n    completed = false;\n    activeFrameIndex = 0;\n    activeFrameKey = current.frameKeys[0]!;\n    if (from !== compiled.initial) stateChange.emit({ to: compiled.initial, from });\n  }\n\n  function dispose(): void {\n    if (disposed) return;\n    disposed = true;\n    stateChange.clear();\n    complete.clear();\n  }\n\n  return {\n    setInput(name, value) {\n      if (disposed) throw new SpriteAnimatorDisposedError();\n      store.setInput(name, value);\n    },\n    fireTrigger(name) {\n      if (disposed) throw new SpriteAnimatorDisposedError();\n      store.fireTrigger(name);\n    },\n    update,\n    reset,\n    dispose,\n    onStateChange(handler: StateChangeHandler, options?: ListenerOptions): Unsubscribe {\n      if (disposed) return () => {};\n      return stateChange.on((p) => handler(p.to, p.from), options);\n    },\n    onComplete(handler: CompleteHandler, options?: ListenerOptions): Unsubscribe {\n      if (disposed) return () => {};\n      return complete.on(handler, options);\n    },\n    get activeState() {\n      return current.name;\n    },\n    get activeFrameKey() {\n      return activeFrameKey;\n    },\n    get activeFrameIndex() {\n      return activeFrameIndex;\n    },\n    get disposed() {\n      return disposed;\n    },\n  };\n}\n","// aispritejs/atlas — parse a PixiJS-v8-native atlas into a SpriteGraph the core\n// can consume. The atlas supplies the universal `animations` / `frames` blocks;\n// the input-driven control (`inputs` / `states` / `transitions`) comes either\n// from the atlas itself (the augmented shape in the README) or from a separate\n// `control` argument.\n//\n// A foreign, event-driven `states` block (the FSM shape `{ initial, definitions }`\n// emitted by other tools) is detected and ignored — `aispritejs` never adopts\n// it. The canonical structure is described by `schemas/aispritejs-graph.schema.json`,\n// shipped alongside this module; the checks below mirror it (fail-fast, no\n// runtime schema-validator dependency).\n//\n// Pure and zero-dependency: it imports only the core (same package) and returns\n// a plain SpriteGraph. `loadAtlas` additionally builds the animator, surfacing\n// semantic errors (InvalidGraphError) eagerly.\n\nimport { isObject } from \"../sprite/compile.js\";\nimport {\n  type FrameTiming,\n  type InputDef,\n  type SpriteAnimator,\n  type SpriteGraph,\n  type StateDef,\n  type TransitionDef,\n  createSpriteAnimator,\n} from \"../sprite/index.js\";\n\n/**\n * Thrown when an atlas is structurally unusable — not an object, missing or\n * malformed `animations`, or carrying no `aispritejs` control block (and none\n * supplied separately). Semantic problems (unknown transition targets, etc.)\n * surface later as {@link InvalidGraphError} from the core.\n *\n * @public\n */\nexport class InvalidAtlasError extends Error {\n  constructor(message: string) {\n    super(`aispritejs/atlas: ${message}`);\n    this.name = \"InvalidAtlasError\";\n  }\n}\n\n/**\n * The `aispritejs` input-driven control block — everything in a {@link SpriteGraph}\n * except the universal `animations` / `frames` that come from the atlas. Supply\n * this as the second argument to drive an atlas whose own `states` block is\n * foreign (event-driven) or absent.\n *\n * @public\n */\nexport interface SpriteControl {\n  readonly inputs: Readonly<Record<string, InputDef>>;\n  readonly states: Readonly<Record<string, StateDef>>;\n  readonly transitions: readonly TransitionDef[];\n  readonly initial?: string;\n  readonly defaultFrameDuration?: number;\n}\n\n/**\n * True for the foreign, event-driven `states` shape `{ initial, definitions }`.\n * Decisive: an `aispritejs` `states` is a flat map whose values are objects, so\n * a *string* `states.initial` only ever appears in the foreign wrapper.\n */\nfunction isForeignStates(states: unknown): boolean {\n  return isObject(states) && typeof states.initial === \"string\" && isObject(states.definitions);\n}\n\nfunction assertAnimations(value: unknown): Record<string, readonly string[]> {\n  if (!isObject(value)) {\n    throw new InvalidAtlasError(\"`animations` must be an object of frame-key lists\");\n  }\n  for (const [name, list] of Object.entries(value)) {\n    if (!Array.isArray(list) || list.some((k) => typeof k !== \"string\")) {\n      throw new InvalidAtlasError(`animation \"${name}\" must be an array of frame-key strings`);\n    }\n  }\n  return value as Record<string, readonly string[]>;\n}\n\n/**\n * Parse a (possibly augmented) PixiJS-v8 atlas into a {@link SpriteGraph}.\n *\n * @param atlas - a parsed atlas object: `animations` (required) + optional\n *   `frames`, and — for the augmented shape — `inputs` / `states` / `transitions`.\n * @param control - an explicit {@link SpriteControl} that supplies (or overrides)\n *   the input-driven graph. Required when the atlas has no `aispritejs` control\n *   block or its `states` is foreign (event-driven).\n * @returns a {@link SpriteGraph} ready for `createSpriteAnimator`.\n * @throws {@link InvalidAtlasError} on a structurally unusable atlas.\n *\n * @public\n */\nexport function parseAtlas(atlas: unknown, control?: SpriteControl): SpriteGraph {\n  if (!isObject(atlas)) {\n    throw new InvalidAtlasError(\"atlas must be an object\");\n  }\n\n  const animations = assertAnimations(atlas.animations);\n  const frames = atlas.frames;\n  if (frames !== undefined && !isObject(frames)) {\n    throw new InvalidAtlasError(\"`frames`, if present, must be an object keyed by frame key\");\n  }\n  if (isObject(frames)) {\n    for (const [key, entry] of Object.entries(frames)) {\n      if (!isObject(entry)) {\n        const actualType = entry === null ? \"null\" : Array.isArray(entry) ? \"array\" : typeof entry;\n        throw new InvalidAtlasError(`frame entry \"${key}\" must be an object, got ${actualType}`);\n      }\n    }\n  }\n\n  let resolved: SpriteControl;\n  if (control) {\n    resolved = control;\n  } else {\n    if (isForeignStates(atlas.states)) {\n      throw new InvalidAtlasError(\n        \"atlas `states` is event-driven (has `initial`/`definitions`); pass an aispritejs control block as the second argument\",\n      );\n    }\n    if (!isObject(atlas.inputs) || !isObject(atlas.states) || !Array.isArray(atlas.transitions)) {\n      throw new InvalidAtlasError(\n        \"atlas has no aispritejs control block (inputs/states/transitions); pass one as the second argument\",\n      );\n    }\n    for (const [key, val] of Object.entries(atlas.inputs)) {\n      if (!isObject(val)) {\n        const actualType = val === null ? \"null\" : Array.isArray(val) ? \"array\" : typeof val;\n        throw new InvalidAtlasError(`input entry \"${key}\" must be an object, got ${actualType}`);\n      }\n    }\n    for (const [key, val] of Object.entries(atlas.states)) {\n      if (!isObject(val)) {\n        const actualType = val === null ? \"null\" : Array.isArray(val) ? \"array\" : typeof val;\n        throw new InvalidAtlasError(`state entry \"${key}\" must be an object, got ${actualType}`);\n      }\n    }\n    const rawTransitions = atlas.transitions as unknown[];\n    for (let i = 0; i < rawTransitions.length; i++) {\n      const entry = rawTransitions[i];\n      if (!isObject(entry)) {\n        const actualType = entry === null ? \"null\" : Array.isArray(entry) ? \"array\" : typeof entry;\n        throw new InvalidAtlasError(`transitions[${i}] must be an object, got ${actualType}`);\n      }\n    }\n    resolved = {\n      inputs: atlas.inputs as Record<string, InputDef>,\n      states: atlas.states as Record<string, StateDef>,\n      transitions: rawTransitions as readonly TransitionDef[],\n      ...(typeof atlas.initial === \"string\" ? { initial: atlas.initial } : {}),\n      ...(typeof atlas.defaultFrameDuration === \"number\"\n        ? { defaultFrameDuration: atlas.defaultFrameDuration }\n        : {}),\n    };\n  }\n\n  return {\n    animations,\n    ...(frames ? { frames: frames as Record<string, FrameTiming> } : {}),\n    inputs: resolved.inputs,\n    states: resolved.states,\n    transitions: resolved.transitions,\n    ...(resolved.initial !== undefined ? { initial: resolved.initial } : {}),\n    ...(resolved.defaultFrameDuration !== undefined\n      ? { defaultFrameDuration: resolved.defaultFrameDuration }\n      : {}),\n  };\n}\n\n/**\n * Parse an atlas and build a {@link SpriteAnimator} in one step — the fail-fast\n * \"load\" entry. Structural problems throw {@link InvalidAtlasError}; semantic\n * problems throw {@link InvalidGraphError} from the core.\n *\n * @public\n */\nexport function loadAtlas(atlas: unknown, control?: SpriteControl): SpriteAnimator {\n  return createSpriteAnimator(parseAtlas(atlas, control));\n}\n"]}