aispritejs 0.5.8 → 0.6.0

package/README.md

@@ -2,7 +2,7 @@
 
 Input-driven, renderer-agnostic 2D sprite animation runtime. A JSON graph maps Number/Boolean/Trigger inputs to visual states and frames; adapters bind the chosen frame to a renderer.
 
-> **Status: 0.5.8 - stable family-aligned surface.** Core, PixiJS adapter, atlas parser, and JSON Schema subpath are shipped.
+> **Status: 0.6.0 - stable family-aligned surface.** Core, PixiJS adapter, atlas parser, and JSON Schema subpath are shipped.
 
 ## Install
 
@@ -25,8 +25,8 @@ const anim = createSpriteAnimator({
   },
   initial: "idle",
   states: {
-    idle: { animation: "idle" },
-    run: { animation: "run", speed: 1 },
+    idle: { animation: "idle", loop: true },
+    run: { animation: "run", loop: true, speed: 1 },
     jump: { animation: "jump", loop: false, onEnd: "idle" },
   },
   transitions: [
@@ -64,13 +64,14 @@ view.dispose(); // disposes core animator; does not destroy the Pixi sprite
 - `loadAtlas(atlas, control?)` parses and creates a `SpriteAnimator`.
 - `aispritejs/schema` exports `schemas/aispritejs-graph.schema.json` for editor/CI validation.
 - Parser validation is structural (`InvalidAtlasError`); compiler validation is semantic (`InvalidGraphError`).
+- An explicit `control` gets the same structural checks as a control block inside the atlas, and its `initial` / `defaultFrameDuration` must be a string / number (an atlas's own block drops wrong-typed ones).
 
 ## Core API
 
-- `createSpriteAnimator(graph)` returns a `SpriteAnimator`.
+- `createSpriteAnimator(graph)` returns a `SpriteAnimator`; a malformed or invalid graph throws `InvalidGraphError` and builds nothing.
 - `setInput(name, value)` accepts Number/Boolean inputs.
 - `fireTrigger(name)` consumes Trigger inputs on transition.
-- `update(deltaMs)` advances time, transitions, frame index, and `onEnd`.
+- `update(deltaMs)` advances time, transitions, frame index, and `onEnd`. A negative, non-finite, or overflowing step is clamped to no progress.
 - `reset()` returns to the initial state.
 - `dispose()` is idempotent; mutators throw `SpriteAnimatorDisposedError` afterward.
 - `onStateChange(handler, options?)` and `onComplete(handler, options?)` support `once` and `signal`.
@@ -78,10 +79,12 @@ view.dispose(); // disposes core animator; does not destroy the Pixi sprite
 ## Sharp Edges
 
 - Non-looping states with `onEnd` transition during the same `update()` tick that completes the clip.
+- `reset()`/`update()` called from inside `onStateChange`/`onComplete` run after the current update finishes (including its `onEnd` auto-transition); a `reset()` from `onComplete` therefore yields `onStateChange(onEndTarget, from)` then `onStateChange(initial, onEndTarget)`, ending in the initial state; `dispose()` from a listener stops the update immediately.
 - `AnimatedSprite` is accepted by the Pixi adapter because it extends `Sprite`, but playback is stopped on bind so it cannot fight the adapter.
-- Every reachable frame key must exist in the texture map/spritesheet; missing keys throw `MissingTextureError`.
+- Every frame key in every declared animation must exist in the texture map/spritesheet — including an animation no state references — or the adapter throws `MissingTextureError` at construction. A `null` / `undefined` entry counts as missing.
+- A texture map with an object under the key `textures` is read as a `Spritesheet`; if a frame is literally named `textures`, pass the `Spritesheet` (or `{ textures: map }`) instead of the bare map.
 - `duration`, `defaultFrameDuration`, and state `speed` must be finite numbers greater than zero.
-- Current schema backlog: add `minProperties` for `animations` and optional finite numeric maximums to mirror runtime guards.
+- `initial`, state `animation` / `onEnd`, transition `from` / `to`, and condition `input` / `op` must be strings, and a transition `priority` must be an integer.
 
 ## AI Context
 

package/README_ZHTW.md

@@ -2,7 +2,7 @@
 
 Input-driven、renderer-agnostic 的 2D sprite animation runtime。JSON graph 會把 Number/Boolean/Trigger inputs 對應到 visual states 與 frames；adapter 再把選到的 frame 綁到 renderer。
 
-> **狀態：0.5.8 - 穩定 family-aligned API。** Core、PixiJS adapter、atlas parser、JSON Schema subpath 都已發布。
+> **狀態：0.6.0 - 穩定 family-aligned API。** Core、PixiJS adapter、atlas parser、JSON Schema subpath 都已發布。
 
 ## 安裝
 
@@ -25,8 +25,8 @@ const anim = createSpriteAnimator({
   },
   initial: "idle",
   states: {
-    idle: { animation: "idle" },
-    run: { animation: "run", speed: 1 },
+    idle: { animation: "idle", loop: true },
+    run: { animation: "run", loop: true, speed: 1 },
     jump: { animation: "jump", loop: false, onEnd: "idle" },
   },
   transitions: [
@@ -64,13 +64,14 @@ view.dispose(); // dispose core animator；不 destroy Pixi sprite
 - `loadAtlas(atlas, control?)` parse 後直接建立 `SpriteAnimator`。
 - `aispritejs/schema` 匯出 `schemas/aispritejs-graph.schema.json`，可用於 editor/CI validation。
 - Parser 做 structural validation（`InvalidAtlasError`）；compiler 做 semantic validation（`InvalidGraphError`）。
+- 明確傳入的 `control` 會套用與 atlas 內嵌 control block 相同的 structural 檢查，且 `initial` / `defaultFrameDuration` 必須分別是 string / number（atlas 自己的 block 則會略過型別錯誤的欄位）。
 
 ## 核心 API
 
-- `createSpriteAnimator(graph)` 回傳 `SpriteAnimator`。
+- `createSpriteAnimator(graph)` 回傳 `SpriteAnimator`；graph 結構錯誤或無效時丟出 `InvalidGraphError`，不會建立任何 animator。
 - `setInput(name, value)` 接受 Number/Boolean inputs。
 - `fireTrigger(name)` 觸發 Trigger input，transition 後會消耗。
-- `update(deltaMs)` 推進時間、transition、frame index 與 `onEnd`。
+- `update(deltaMs)` 推進時間、transition、frame index 與 `onEnd`。負數、非 finite 或會溢位的 step 一律視為不前進。
 - `reset()` 回到 initial state。
 - `dispose()` 可重複呼叫；dispose 後 mutators 會丟 `SpriteAnimatorDisposedError`。
 - `onStateChange(handler, options?)` 與 `onComplete(handler, options?)` 支援 `once` 與 `signal`。
@@ -78,10 +79,13 @@ view.dispose(); // dispose core animator；不 destroy Pixi sprite
 ## 注意事項
 
 - 非 loop state 若有 `onEnd`，會在 clip 完成的同一個 `update()` tick 轉場。
+- 在 `onStateChange`/`onComplete` 內呼叫的 `reset()`/`update()` 會排入佇列，等目前這次 update（包含其 `onEnd` 自動轉場）結束後才執行；因此在 `onComplete` 呼叫 `reset()` 會先觸發 `onStateChange(onEndTarget, from)`，再觸發 `onStateChange(initial, onEndTarget)`，最後停在 initial state；在 listener 內呼叫 `dispose()` 則會立刻停止這次 update。
 - Pixi adapter 接受 `AnimatedSprite`，因為它 extends `Sprite`；bind 時會 stop playback，避免跟 adapter 搶 texture。
-- 所有 reachable frame keys 都必須存在於 texture map/spritesheet；缺少時丟 `MissingTextureError`。
+- 每個 animation（即使沒有任何 state 參照到它）裡的每個 frame key 都必須存在於 texture map/spritesheet，否則 adapter 會在 construction 時丟 `MissingTextureError`。值為 `null` / `undefined` 的 entry 也視為缺少。
+- texture map 若在 `textures` key 下放了物件，會被當成 `Spritesheet` 讀取；若真的有 frame 叫 `textures`，請傳入 `Spritesheet`（或 `{ textures: map }`），不要直接傳 map。
 - `duration`、`defaultFrameDuration`、state `speed` 都必須是 finite 且大於 0。
-- 目前 schema backlog：替 `animations` 加 `minProperties`，並考慮用 finite numeric maximums 對齊 runtime guards。
+- `initial`、state 的 `animation` / `onEnd`、transition 的 `from` / `to`、condition 的 `input` / `op` 都必須是 string，transition `priority` 必須是整數。
+- `animations` 不可為空物件（`minProperties: 1`）；`duration`、`defaultFrameDuration` 上限為 86,400,000 ms（24 小時），state `speed` 上限為 1000——schema 與 runtime 已一致。
 
 ## AI Context
 

package/dist/atlas/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkQF5N7LOI_cjs = require('../chunk-QF5N7LOI.cjs');
+var chunkGEQWS7FY_cjs = require('../chunk-GEQWS7FY.cjs');
 
 // src/atlas/parse.ts
 var InvalidAtlasError = class extends Error {
@@ -10,10 +10,16 @@ var InvalidAtlasError = class extends Error {
   }
 };
 function isForeignStates(states) {
-  return chunkQF5N7LOI_cjs.isObject(states) && typeof states.initial === "string" && chunkQF5N7LOI_cjs.isObject(states.definitions);
+  return chunkGEQWS7FY_cjs.isObject(states) && typeof states.initial === "string" && chunkGEQWS7FY_cjs.isObject(states.definitions);
+}
+function typeName(v) {
+  return v === null ? "null" : Array.isArray(v) ? "array" : typeof v;
+}
+function assertEntry(v, what) {
+  if (!chunkGEQWS7FY_cjs.isObject(v)) throw new InvalidAtlasError(`${what} must be an object, got ${typeName(v)}`);
 }
 function assertAnimations(value) {
-  if (!chunkQF5N7LOI_cjs.isObject(value)) {
+  if (!chunkGEQWS7FY_cjs.isObject(value)) {
     throw new InvalidAtlasError("`animations` must be an object of frame-key lists");
   }
   for (const [name, list] of Object.entries(value)) {
@@ -23,25 +29,44 @@ function assertAnimations(value) {
   }
   return value;
 }
+function assertControlShape(src, p) {
+  if (!chunkGEQWS7FY_cjs.isObject(src.inputs)) throw new InvalidAtlasError(`${p}inputs must be an object`);
+  if (!chunkGEQWS7FY_cjs.isObject(src.states)) throw new InvalidAtlasError(`${p}states must be an object`);
+  if (!Array.isArray(src.transitions)) {
+    throw new InvalidAtlasError(`${p}transitions must be an array`);
+  }
+  for (const [key, val] of Object.entries(src.inputs)) assertEntry(val, `${p}input entry "${key}"`);
+  for (const [key, val] of Object.entries(src.states)) assertEntry(val, `${p}state entry "${key}"`);
+  src.transitions.forEach((entry, i) => {
+    assertEntry(entry, `${p}transitions[${i}]`);
+    const when = entry.when;
+    if (Array.isArray(when)) {
+      when.forEach((cond, j) => assertEntry(cond, `${p}transitions[${i}].when[${j}]`));
+    }
+  });
+}
 function parseAtlas(atlas, control) {
-  if (!chunkQF5N7LOI_cjs.isObject(atlas)) {
+  if (!chunkGEQWS7FY_cjs.isObject(atlas)) {
     throw new InvalidAtlasError("atlas must be an object");
   }
   const animations = assertAnimations(atlas.animations);
   const frames = atlas.frames;
-  if (frames !== void 0 && !chunkQF5N7LOI_cjs.isObject(frames)) {
+  if (frames !== void 0 && !chunkGEQWS7FY_cjs.isObject(frames)) {
     throw new InvalidAtlasError("`frames`, if present, must be an object keyed by frame key");
   }
-  if (chunkQF5N7LOI_cjs.isObject(frames)) {
-    for (const [key, entry] of Object.entries(frames)) {
-      if (!chunkQF5N7LOI_cjs.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}`);
-      }
-    }
+  if (chunkGEQWS7FY_cjs.isObject(frames)) {
+    for (const [key, entry] of Object.entries(frames)) assertEntry(entry, `frame entry "${key}"`);
   }
   let resolved;
-  if (control) {
+  if (control != null) {
+    if (!chunkGEQWS7FY_cjs.isObject(control)) throw new InvalidAtlasError("control must be an object");
+    assertControlShape(control, "control.");
+    if (control.initial !== void 0 && typeof control.initial !== "string") {
+      throw new InvalidAtlasError("control.initial must be a string");
+    }
+    if (control.defaultFrameDuration !== void 0 && typeof control.defaultFrameDuration !== "number") {
+      throw new InvalidAtlasError("control.defaultFrameDuration must be a number");
+    }
     resolved = control;
   } else {
     if (isForeignStates(atlas.states)) {
@@ -49,47 +74,16 @@ function parseAtlas(atlas, control) {
         "atlas `states` is event-driven (has `initial`/`definitions`); pass an aispritejs control block as the second argument"
       );
     }
-    if (!chunkQF5N7LOI_cjs.isObject(atlas.inputs) || !chunkQF5N7LOI_cjs.isObject(atlas.states) || !Array.isArray(atlas.transitions)) {
+    if (!chunkGEQWS7FY_cjs.isObject(atlas.inputs) || !chunkGEQWS7FY_cjs.isObject(atlas.states) || !Array.isArray(atlas.transitions)) {
       throw new InvalidAtlasError(
         "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 (!chunkQF5N7LOI_cjs.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 (!chunkQF5N7LOI_cjs.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 (!chunkQF5N7LOI_cjs.isObject(entry)) {
-        const actualType = entry === null ? "null" : Array.isArray(entry) ? "array" : typeof entry;
-        throw new InvalidAtlasError(`transitions[${i}] must be an object, got ${actualType}`);
-      }
-      if (Array.isArray(entry.when)) {
-        const rawWhen = entry.when;
-        for (let j = 0; j < rawWhen.length; j++) {
-          const cond = rawWhen[j];
-          if (!chunkQF5N7LOI_cjs.isObject(cond)) {
-            const actualType = cond === null ? "null" : Array.isArray(cond) ? "array" : typeof cond;
-            throw new InvalidAtlasError(
-              `transitions[${i}].when[${j}] must be an object, got ${actualType}`
-            );
-          }
-        }
-      }
-    }
+    assertControlShape(atlas, "");
     resolved = {
       inputs: atlas.inputs,
       states: atlas.states,
-      transitions: rawTransitions,
+      transitions: atlas.transitions,
       ...typeof atlas.initial === "string" ? { initial: atlas.initial } : {},
       ...typeof atlas.defaultFrameDuration === "number" ? { defaultFrameDuration: atlas.defaultFrameDuration } : {}
     };
@@ -105,7 +99,7 @@ function parseAtlas(atlas, control) {
   };
 }
 function loadAtlas(atlas, control) {
-  return chunkQF5N7LOI_cjs.createSpriteAnimator(parseAtlas(atlas, control));
+  return chunkGEQWS7FY_cjs.createSpriteAnimator(parseAtlas(atlas, control));
 }
 
 exports.InvalidAtlasError = InvalidAtlasError;

package/dist/atlas/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/atlas/parse.ts"],"names":["isObject","createSpriteAnimator"],"mappings":";;;;;AAmCO,IAAM,iBAAA,GAAN,cAAgC,KAAA,CAAM;AAAA,EAC3C,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,CAAA,kBAAA,EAAqB,OAAO,CAAA,CAAE,CAAA;AACpC,IAAA,IAAA,CAAK,IAAA,GAAO,mBAAA;AAAA,EACd;AACF;AAuBA,SAAS,gBAAgB,MAAA,EAA0B;AACjD,EAAA,OAAOA,0BAAA,CAAS,MAAM,CAAA,IAAK,OAAO,OAAO,OAAA,KAAY,QAAA,IAAYA,0BAAA,CAAS,MAAA,CAAO,WAAW,CAAA;AAC9F;AAEA,SAAS,iBAAiB,KAAA,EAAmD;AAC3E,EAAA,IAAI,CAACA,0BAAA,CAAS,KAAK,CAAA,EAAG;AACpB,IAAA,MAAM,IAAI,kBAAkB,mDAAmD,CAAA;AAAA,EACjF;AACA,EAAA,KAAA,MAAW,CAAC,IAAA,EAAM,IAAI,KAAK,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,EAAG;AAChD,IAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA,IAAK,IAAA,CAAK,IAAA,CAAK,CAAC,CAAA,KAAM,OAAO,CAAA,KAAM,QAAQ,CAAA,EAAG;AACnE,MAAA,MAAM,IAAI,iBAAA,CAAkB,CAAA,WAAA,EAAc,IAAI,CAAA,uCAAA,CAAyC,CAAA;AAAA,IACzF;AAAA,EACF;AACA,EAAA,OAAO,KAAA;AACT;AAeO,SAAS,UAAA,CAAW,OAAgB,OAAA,EAAsC;AAC/E,EAAA,IAAI,CAACA,0BAAA,CAAS,KAAK,CAAA,EAAG;AACpB,IAAA,MAAM,IAAI,kBAAkB,yBAAyB,CAAA;AAAA,EACvD;AAEA,EAAA,MAAM,UAAA,GAAa,gBAAA,CAAiB,KAAA,CAAM,UAAU,CAAA;AACpD,EAAA,MAAM,SAAS,KAAA,CAAM,MAAA;AACrB,EAAA,IAAI,MAAA,KAAW,MAAA,IAAa,CAACA,0BAAA,CAAS,MAAM,CAAA,EAAG;AAC7C,IAAA,MAAM,IAAI,kBAAkB,4DAA4D,CAAA;AAAA,EAC1F;AACA,EAAA,IAAIA,0BAAA,CAAS,MAAM,CAAA,EAAG;AACpB,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAAG;AACjD,MAAA,IAAI,CAACA,0BAAA,CAAS,KAAK,CAAA,EAAG;AACpB,QAAA,MAAM,UAAA,GAAa,UAAU,IAAA,GAAO,MAAA,GAAS,MAAM,OAAA,CAAQ,KAAK,CAAA,GAAI,OAAA,GAAU,OAAO,KAAA;AACrF,QAAA,MAAM,IAAI,iBAAA,CAAkB,CAAA,aAAA,EAAgB,GAAG,CAAA,yBAAA,EAA4B,UAAU,CAAA,CAAE,CAAA;AAAA,MACzF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,IAAI,QAAA;AACJ,EAAA,IAAI,OAAA,EAAS;AACX,IAAA,QAAA,GAAW,OAAA;AAAA,EACb,CAAA,MAAO;AACL,IAAA,IAAI,eAAA,CAAgB,KAAA,CAAM,MAAM,CAAA,EAAG;AACjC,MAAA,MAAM,IAAI,iBAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AACA,IAAA,IAAI,CAACA,0BAAA,CAAS,KAAA,CAAM,MAAM,KAAK,CAACA,0BAAA,CAAS,KAAA,CAAM,MAAM,KAAK,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAA,CAAM,WAAW,CAAA,EAAG;AAC3F,MAAA,MAAM,IAAI,iBAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AACA,IAAA,KAAA,MAAW,CAAC,KAAK,GAAG,CAAA,IAAK,OAAO,OAAA,CAAQ,KAAA,CAAM,MAAM,CAAA,EAAG;AACrD,MAAA,IAAI,CAACA,0BAAA,CAAS,GAAG,CAAA,EAAG;AAClB,QAAA,MAAM,UAAA,GAAa,QAAQ,IAAA,GAAO,MAAA,GAAS,MAAM,OAAA,CAAQ,GAAG,CAAA,GAAI,OAAA,GAAU,OAAO,GAAA;AACjF,QAAA,MAAM,IAAI,iBAAA,CAAkB,CAAA,aAAA,EAAgB,GAAG,CAAA,yBAAA,EAA4B,UAAU,CAAA,CAAE,CAAA;AAAA,MACzF;AAAA,IACF;AACA,IAAA,KAAA,MAAW,CAAC,KAAK,GAAG,CAAA,IAAK,OAAO,OAAA,CAAQ,KAAA,CAAM,MAAM,CAAA,EAAG;AACrD,MAAA,IAAI,CAACA,0BAAA,CAAS,GAAG,CAAA,EAAG;AAClB,QAAA,MAAM,UAAA,GAAa,QAAQ,IAAA,GAAO,MAAA,GAAS,MAAM,OAAA,CAAQ,GAAG,CAAA,GAAI,OAAA,GAAU,OAAO,GAAA;AACjF,QAAA,MAAM,IAAI,iBAAA,CAAkB,CAAA,aAAA,EAAgB,GAAG,CAAA,yBAAA,EAA4B,UAAU,CAAA,CAAE,CAAA;AAAA,MACzF;AAAA,IACF;AACA,IAAA,MAAM,iBAAiB,KAAA,CAAM,WAAA;AAC7B,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,cAAA,CAAe,QAAQ,CAAA,EAAA,EAAK;AAC9C,MAAA,MAAM,KAAA,GAAQ,eAAe,CAAC,CAAA;AAC9B,MAAA,IAAI,CAACA,0BAAA,CAAS,KAAK,CAAA,EAAG;AACpB,QAAA,MAAM,UAAA,GAAa,UAAU,IAAA,GAAO,MAAA,GAAS,MAAM,OAAA,CAAQ,KAAK,CAAA,GAAI,OAAA,GAAU,OAAO,KAAA;AACrF,QAAA,MAAM,IAAI,iBAAA,CAAkB,CAAA,YAAA,EAAe,CAAC,CAAA,yBAAA,EAA4B,UAAU,CAAA,CAAE,CAAA;AAAA,MACtF;AAIA,MAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,KAAA,CAAM,IAAI,CAAA,EAAG;AAC7B,QAAA,MAAM,UAAU,KAAA,CAAM,IAAA;AACtB,QAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,OAAA,CAAQ,QAAQ,CAAA,EAAA,EAAK;AACvC,UAAA,MAAM,IAAA,GAAO,QAAQ,CAAC,CAAA;AACtB,UAAA,IAAI,CAACA,0BAAA,CAAS,IAAI,CAAA,EAAG;AACnB,YAAA,MAAM,UAAA,GAAa,SAAS,IAAA,GAAO,MAAA,GAAS,MAAM,OAAA,CAAQ,IAAI,CAAA,GAAI,OAAA,GAAU,OAAO,IAAA;AACnF,YAAA,MAAM,IAAI,iBAAA;AAAA,cACR,CAAA,YAAA,EAAe,CAAC,CAAA,OAAA,EAAU,CAAC,4BAA4B,UAAU,CAAA;AAAA,aACnE;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AACA,IAAA,QAAA,GAAW;AAAA,MACT,QAAQ,KAAA,CAAM,MAAA;AAAA,MACd,QAAQ,KAAA,CAAM,MAAA;AAAA,MACd,WAAA,EAAa,cAAA;AAAA,MACb,GAAI,OAAO,KAAA,CAAM,OAAA,KAAY,QAAA,GAAW,EAAE,OAAA,EAAS,KAAA,CAAM,OAAA,EAAQ,GAAI,EAAC;AAAA,MACtE,GAAI,OAAO,KAAA,CAAM,oBAAA,KAAyB,QAAA,GACtC,EAAE,oBAAA,EAAsB,KAAA,CAAM,oBAAA,EAAqB,GACnD;AAAC,KACP;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,UAAA;AAAA,IACA,GAAI,MAAA,GAAS,EAAE,MAAA,KAAkD,EAAC;AAAA,IAClE,QAAQ,QAAA,CAAS,MAAA;AAAA,IACjB,QAAQ,QAAA,CAAS,MAAA;AAAA,IACjB,aAAa,QAAA,CAAS,WAAA;AAAA,IACtB,GAAI,SAAS,OAAA,KAAY,MAAA,GAAY,EAAE,OAAA,EAAS,QAAA,CAAS,OAAA,EAAQ,GAAI,EAAC;AAAA,IACtE,GAAI,SAAS,oBAAA,KAAyB,MAAA,GAClC,EAAE,oBAAA,EAAsB,QAAA,CAAS,oBAAA,EAAqB,GACtD;AAAC,GACP;AACF;AASO,SAAS,SAAA,CAAU,OAAgB,OAAA,EAAyC;AACjF,EAAA,OAAOC,sCAAA,CAAqB,UAAA,CAAW,KAAA,EAAO,OAAO,CAAC,CAAA;AACxD","file":"index.cjs","sourcesContent":["// 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      // Validate each `when` item is an object (sibling of F-5).\n      // A null/non-object item here would otherwise cause a bare TypeError at\n      // compile.ts when it attempts to destructure `c.input`.\n      if (Array.isArray(entry.when)) {\n        const rawWhen = entry.when as unknown[];\n        for (let j = 0; j < rawWhen.length; j++) {\n          const cond = rawWhen[j];\n          if (!isObject(cond)) {\n            const actualType = cond === null ? \"null\" : Array.isArray(cond) ? \"array\" : typeof cond;\n            throw new InvalidAtlasError(\n              `transitions[${i}].when[${j}] must be an object, got ${actualType}`,\n            );\n          }\n        }\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"]}
+{"version":3,"sources":["../../src/atlas/parse.ts"],"names":["isObject","createSpriteAnimator"],"mappings":"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","file":"index.cjs","sourcesContent":["// 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\n/** `typeof`, but naming `null` and arrays, for \"got <type>\" messages. */\nfunction typeName(v: unknown): string {\n  return v === null ? \"null\" : Array.isArray(v) ? \"array\" : typeof v;\n}\n\nfunction assertEntry(v: unknown, what: string): void {\n  if (!isObject(v)) throw new InvalidAtlasError(`${what} must be an object, got ${typeName(v)}`);\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 * Structural checks shared by the atlas's own control block (`p` = `\"\"`) and an\n * explicit `control` argument (`p` = `\"control.\"`): object `inputs` / `states`,\n * array `transitions`, and object entries / `when` items, so a malformed block\n * is an {@link InvalidAtlasError} on either path. Semantic checks stay with the\n * compiler ({@link InvalidGraphError}).\n */\nfunction assertControlShape(src: Record<string, unknown>, p: string): void {\n  if (!isObject(src.inputs)) throw new InvalidAtlasError(`${p}inputs must be an object`);\n  if (!isObject(src.states)) throw new InvalidAtlasError(`${p}states must be an object`);\n  if (!Array.isArray(src.transitions)) {\n    throw new InvalidAtlasError(`${p}transitions must be an array`);\n  }\n  for (const [key, val] of Object.entries(src.inputs)) assertEntry(val, `${p}input entry \"${key}\"`);\n  for (const [key, val] of Object.entries(src.states)) assertEntry(val, `${p}state entry \"${key}\"`);\n  src.transitions.forEach((entry: unknown, i) => {\n    assertEntry(entry, `${p}transitions[${i}]`);\n    // A null/non-object `when` item would otherwise reach the compiler as a\n    // malformed condition (sibling of F-5).\n    const when = (entry as { when?: unknown }).when;\n    if (Array.isArray(when)) {\n      when.forEach((cond: unknown, j) => assertEntry(cond, `${p}transitions[${i}].when[${j}]`));\n    }\n  });\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). When supplied (not\n *   `undefined` / `null`) it gets the same structural checks as an embedded\n *   block, and a wrong-typed `initial` / `defaultFrameDuration` is rejected\n *   rather than dropped.\n * @returns a {@link SpriteGraph} ready for `createSpriteAnimator`.\n * @throws {@link InvalidAtlasError} on a structurally unusable atlas or control.\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)) assertEntry(entry, `frame entry \"${key}\"`);\n  }\n\n  let resolved: SpriteControl;\n  if (control != null) {\n    // Same structural checks as the embedded block, plus typed optional\n    // fields: an explicit control is never silently trimmed.\n    if (!isObject(control)) throw new InvalidAtlasError(\"control must be an object\");\n    assertControlShape(control, \"control.\");\n    if (control.initial !== undefined && typeof control.initial !== \"string\") {\n      throw new InvalidAtlasError(\"control.initial must be a string\");\n    }\n    if (\n      control.defaultFrameDuration !== undefined &&\n      typeof control.defaultFrameDuration !== \"number\"\n    ) {\n      throw new InvalidAtlasError(\"control.defaultFrameDuration must be a number\");\n    }\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    assertControlShape(atlas, \"\");\n    // Wrong-typed optional fields in the atlas itself are dropped (lenient).\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"]}

package/dist/atlas/index.d.cts

@@ -1,4 +1,4 @@
-import { I as InputDef, S as StateDef, T as TransitionDef, a as SpriteAnimator, b as SpriteGraph } from '../types-BS72pefJ.cjs';
+import { I as InputDef, S as StateDef, T as TransitionDef, a as SpriteAnimator, b as SpriteGraph } from '../types-Dr7yXTRQ.cjs';
 
 /**
  * Thrown when an atlas is structurally unusable — not an object, missing or
@@ -33,9 +33,12 @@ interface SpriteControl {
  *   `frames`, and — for the augmented shape — `inputs` / `states` / `transitions`.
  * @param control - an explicit {@link SpriteControl} that supplies (or overrides)
  *   the input-driven graph. Required when the atlas has no `aispritejs` control
- *   block or its `states` is foreign (event-driven).
+ *   block or its `states` is foreign (event-driven). When supplied (not
+ *   `undefined` / `null`) it gets the same structural checks as an embedded
+ *   block, and a wrong-typed `initial` / `defaultFrameDuration` is rejected
+ *   rather than dropped.
  * @returns a {@link SpriteGraph} ready for `createSpriteAnimator`.
- * @throws {@link InvalidAtlasError} on a structurally unusable atlas.
+ * @throws {@link InvalidAtlasError} on a structurally unusable atlas or control.
  *
  * @public
  */

package/dist/atlas/index.d.ts

@@ -1,4 +1,4 @@
-import { I as InputDef, S as StateDef, T as TransitionDef, a as SpriteAnimator, b as SpriteGraph } from '../types-BS72pefJ.js';
+import { I as InputDef, S as StateDef, T as TransitionDef, a as SpriteAnimator, b as SpriteGraph } from '../types-Dr7yXTRQ.js';
 
 /**
  * Thrown when an atlas is structurally unusable — not an object, missing or
@@ -33,9 +33,12 @@ interface SpriteControl {
  *   `frames`, and — for the augmented shape — `inputs` / `states` / `transitions`.
  * @param control - an explicit {@link SpriteControl} that supplies (or overrides)
  *   the input-driven graph. Required when the atlas has no `aispritejs` control
- *   block or its `states` is foreign (event-driven).
+ *   block or its `states` is foreign (event-driven). When supplied (not
+ *   `undefined` / `null`) it gets the same structural checks as an embedded
+ *   block, and a wrong-typed `initial` / `defaultFrameDuration` is rejected
+ *   rather than dropped.
  * @returns a {@link SpriteGraph} ready for `createSpriteAnimator`.
- * @throws {@link InvalidAtlasError} on a structurally unusable atlas.
+ * @throws {@link InvalidAtlasError} on a structurally unusable atlas or control.
  *
  * @public
  */

package/dist/atlas/index.js

@@ -1,4 +1,4 @@
-import { isObject, createSpriteAnimator } from '../chunk-6E4ILDBY.js';
+import { isObject, createSpriteAnimator } from '../chunk-NBMU2UNJ.js';
 
 // src/atlas/parse.ts
 var InvalidAtlasError = class extends Error {
@@ -10,6 +10,12 @@ var InvalidAtlasError = class extends Error {
 function isForeignStates(states) {
   return isObject(states) && typeof states.initial === "string" && isObject(states.definitions);
 }
+function typeName(v) {
+  return v === null ? "null" : Array.isArray(v) ? "array" : typeof v;
+}
+function assertEntry(v, what) {
+  if (!isObject(v)) throw new InvalidAtlasError(`${what} must be an object, got ${typeName(v)}`);
+}
 function assertAnimations(value) {
   if (!isObject(value)) {
     throw new InvalidAtlasError("`animations` must be an object of frame-key lists");
@@ -21,6 +27,22 @@ function assertAnimations(value) {
   }
   return value;
 }
+function assertControlShape(src, p) {
+  if (!isObject(src.inputs)) throw new InvalidAtlasError(`${p}inputs must be an object`);
+  if (!isObject(src.states)) throw new InvalidAtlasError(`${p}states must be an object`);
+  if (!Array.isArray(src.transitions)) {
+    throw new InvalidAtlasError(`${p}transitions must be an array`);
+  }
+  for (const [key, val] of Object.entries(src.inputs)) assertEntry(val, `${p}input entry "${key}"`);
+  for (const [key, val] of Object.entries(src.states)) assertEntry(val, `${p}state entry "${key}"`);
+  src.transitions.forEach((entry, i) => {
+    assertEntry(entry, `${p}transitions[${i}]`);
+    const when = entry.when;
+    if (Array.isArray(when)) {
+      when.forEach((cond, j) => assertEntry(cond, `${p}transitions[${i}].when[${j}]`));
+    }
+  });
+}
 function parseAtlas(atlas, control) {
   if (!isObject(atlas)) {
     throw new InvalidAtlasError("atlas must be an object");
@@ -31,15 +53,18 @@ function parseAtlas(atlas, control) {
     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}`);
-      }
-    }
+    for (const [key, entry] of Object.entries(frames)) assertEntry(entry, `frame entry "${key}"`);
   }
   let resolved;
-  if (control) {
+  if (control != null) {
+    if (!isObject(control)) throw new InvalidAtlasError("control must be an object");
+    assertControlShape(control, "control.");
+    if (control.initial !== void 0 && typeof control.initial !== "string") {
+      throw new InvalidAtlasError("control.initial must be a string");
+    }
+    if (control.defaultFrameDuration !== void 0 && typeof control.defaultFrameDuration !== "number") {
+      throw new InvalidAtlasError("control.defaultFrameDuration must be a number");
+    }
     resolved = control;
   } else {
     if (isForeignStates(atlas.states)) {
@@ -52,42 +77,11 @@ 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}`);
-      }
-      if (Array.isArray(entry.when)) {
-        const rawWhen = entry.when;
-        for (let j = 0; j < rawWhen.length; j++) {
-          const cond = rawWhen[j];
-          if (!isObject(cond)) {
-            const actualType = cond === null ? "null" : Array.isArray(cond) ? "array" : typeof cond;
-            throw new InvalidAtlasError(
-              `transitions[${i}].when[${j}] must be an object, got ${actualType}`
-            );
-          }
-        }
-      }
-    }
+    assertControlShape(atlas, "");
     resolved = {
       inputs: atlas.inputs,
       states: atlas.states,
-      transitions: rawTransitions,
+      transitions: atlas.transitions,
       ...typeof atlas.initial === "string" ? { initial: atlas.initial } : {},
       ...typeof atlas.defaultFrameDuration === "number" ? { defaultFrameDuration: atlas.defaultFrameDuration } : {}
     };

package/dist/atlas/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/atlas/parse.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// 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      // Validate each `when` item is an object (sibling of F-5).\n      // A null/non-object item here would otherwise cause a bare TypeError at\n      // compile.ts when it attempts to destructure `c.input`.\n      if (Array.isArray(entry.when)) {\n        const rawWhen = entry.when as unknown[];\n        for (let j = 0; j < rawWhen.length; j++) {\n          const cond = rawWhen[j];\n          if (!isObject(cond)) {\n            const actualType = cond === null ? \"null\" : Array.isArray(cond) ? \"array\" : typeof cond;\n            throw new InvalidAtlasError(\n              `transitions[${i}].when[${j}] must be an object, got ${actualType}`,\n            );\n          }\n        }\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"]}
+{"version":3,"sources":["../../src/atlas/parse.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// 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\n/** `typeof`, but naming `null` and arrays, for \"got <type>\" messages. */\nfunction typeName(v: unknown): string {\n  return v === null ? \"null\" : Array.isArray(v) ? \"array\" : typeof v;\n}\n\nfunction assertEntry(v: unknown, what: string): void {\n  if (!isObject(v)) throw new InvalidAtlasError(`${what} must be an object, got ${typeName(v)}`);\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 * Structural checks shared by the atlas's own control block (`p` = `\"\"`) and an\n * explicit `control` argument (`p` = `\"control.\"`): object `inputs` / `states`,\n * array `transitions`, and object entries / `when` items, so a malformed block\n * is an {@link InvalidAtlasError} on either path. Semantic checks stay with the\n * compiler ({@link InvalidGraphError}).\n */\nfunction assertControlShape(src: Record<string, unknown>, p: string): void {\n  if (!isObject(src.inputs)) throw new InvalidAtlasError(`${p}inputs must be an object`);\n  if (!isObject(src.states)) throw new InvalidAtlasError(`${p}states must be an object`);\n  if (!Array.isArray(src.transitions)) {\n    throw new InvalidAtlasError(`${p}transitions must be an array`);\n  }\n  for (const [key, val] of Object.entries(src.inputs)) assertEntry(val, `${p}input entry \"${key}\"`);\n  for (const [key, val] of Object.entries(src.states)) assertEntry(val, `${p}state entry \"${key}\"`);\n  src.transitions.forEach((entry: unknown, i) => {\n    assertEntry(entry, `${p}transitions[${i}]`);\n    // A null/non-object `when` item would otherwise reach the compiler as a\n    // malformed condition (sibling of F-5).\n    const when = (entry as { when?: unknown }).when;\n    if (Array.isArray(when)) {\n      when.forEach((cond: unknown, j) => assertEntry(cond, `${p}transitions[${i}].when[${j}]`));\n    }\n  });\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). When supplied (not\n *   `undefined` / `null`) it gets the same structural checks as an embedded\n *   block, and a wrong-typed `initial` / `defaultFrameDuration` is rejected\n *   rather than dropped.\n * @returns a {@link SpriteGraph} ready for `createSpriteAnimator`.\n * @throws {@link InvalidAtlasError} on a structurally unusable atlas or control.\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)) assertEntry(entry, `frame entry \"${key}\"`);\n  }\n\n  let resolved: SpriteControl;\n  if (control != null) {\n    // Same structural checks as the embedded block, plus typed optional\n    // fields: an explicit control is never silently trimmed.\n    if (!isObject(control)) throw new InvalidAtlasError(\"control must be an object\");\n    assertControlShape(control, \"control.\");\n    if (control.initial !== undefined && typeof control.initial !== \"string\") {\n      throw new InvalidAtlasError(\"control.initial must be a string\");\n    }\n    if (\n      control.defaultFrameDuration !== undefined &&\n      typeof control.defaultFrameDuration !== \"number\"\n    ) {\n      throw new InvalidAtlasError(\"control.defaultFrameDuration must be a number\");\n    }\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    assertControlShape(atlas, \"\");\n    // Wrong-typed optional fields in the atlas itself are dropped (lenient).\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"]}