aispritejs 0.1.1 → 0.1.2

package/dist/{types-DKMFvfx9.d.cts → types-BS72pefJ.d.cts}

@@ -234,9 +234,15 @@ interface SpriteAnimator {
     reset(): void;
     /** Release all listeners. Idempotent; subsequent mutators throw. */
     dispose(): void;
-    /** Subscribe to state changes. Returns an unsubscribe. */
+    /**
+     * Subscribe to state changes. Returns an unsubscribe.
+     * @remarks After `dispose()` this returns a no-op unsubscribe and registers no listener.
+     */
     onStateChange(handler: StateChangeHandler, options?: ListenerOptions): Unsubscribe;
-    /** Subscribe to non-looping clip completions. Returns an unsubscribe. */
+    /**
+     * Subscribe to non-looping clip completions. Returns an unsubscribe.
+     * @remarks After `dispose()` this returns a no-op unsubscribe and registers no listener.
+     */
     onComplete(handler: CompleteHandler, options?: ListenerOptions): Unsubscribe;
     /** Current state name. */
     readonly activeState: string;

package/dist/{types-DKMFvfx9.d.ts → types-BS72pefJ.d.ts}

@@ -234,9 +234,15 @@ interface SpriteAnimator {
     reset(): void;
     /** Release all listeners. Idempotent; subsequent mutators throw. */
     dispose(): void;
-    /** Subscribe to state changes. Returns an unsubscribe. */
+    /**
+     * Subscribe to state changes. Returns an unsubscribe.
+     * @remarks After `dispose()` this returns a no-op unsubscribe and registers no listener.
+     */
     onStateChange(handler: StateChangeHandler, options?: ListenerOptions): Unsubscribe;
-    /** Subscribe to non-looping clip completions. Returns an unsubscribe. */
+    /**
+     * Subscribe to non-looping clip completions. Returns an unsubscribe.
+     * @remarks After `dispose()` this returns a no-op unsubscribe and registers no listener.
+     */
     onComplete(handler: CompleteHandler, options?: ListenerOptions): Unsubscribe;
     /** Current state name. */
     readonly activeState: string;

package/llms-full.txt

@@ -40,7 +40,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)
@@ -213,7 +213,7 @@ pnpm example:platformer
 
 ## 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.1 — OIDC/SLSA publish.** The npm tarball now carries SLSA build provenance (OIDC trusted-publisher pipeline). No source or API changes from v0.1.0, which 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`). 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.
 
 ## Roadmap
 
@@ -236,6 +236,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.2] - 2026-06-05
+
+### Changed
+
+- JSON Schema: `animations` now requires at least one entry (`minProperties: 1`), matching `states`
+  and the runtime (which already rejects an empty animations map via `InvalidGraphError`).
+
+### Fixed
+
+- Reject non-finite (`Infinity`/`NaN`) `speed`, `duration`, and `defaultFrameDuration` at compile
+  time (`InvalidGraphError`); clamp non-finite `dt` to 0 in `update()` — previously these silently
+  corrupted looping playback (frame stuck at 0 / `NaN` accumulation).
+
 ## [0.1.1] - 2026-06-03
 
 First release published through the OIDC `publish.yml` pipeline (npm trusted

package/llms.txt

@@ -12,7 +12,7 @@ Key guarantees: deterministic `update(dt)` (identical inputs + Δt ⇒ identical
 - [README_ZHTW.md](README_ZHTW.md): Traditional Chinese mirror of the canonical README.
 - [ROADMAP.md](ROADMAP.md): phased plan (v0.1.0 core → v0.2.0 PixiJS adapter → v0.3.0 atlas parser + JSON Schema → 1.0 freeze) and design invariants.
 - [STABILITY.md](STABILITY.md): stability tier of every public symbol plus the pinned behavioural contract.
-- [CHANGELOG.md](CHANGELOG.md): Keep a Changelog format; the 0.1.0 entry covers the core surface and CI guarantees.
+- [CHANGELOG.md](CHANGELOG.md): Keep a Changelog format; the 0.1.1 entry notes SLSA build provenance (OIDC publish); the 0.1.0 entry covers the full core surface and CI guarantees.
 - [CONTRIBUTING.md](CONTRIBUTING.md): quick-start commands, design principles, commit & PR style.
 - [llms-full.txt](llms-full.txt): README + CHANGELOG + CONTRIBUTING + examples index concatenated into one file — load this when an AI agent needs the full context in a single fetch.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aispritejs",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Input-driven, renderer-agnostic 2D sprite animation runtime — a tiny, Rive-like visual state machine driven by Number / Boolean / Trigger inputs. JSON transition graph, deterministic update(dt), zero runtime dependencies. Browser / Node / Bun / Deno / WebView / Worker friendly.",
   "keywords": [
     "sprite",

package/schemas/aispritejs-graph.schema.json

@@ -11,8 +11,9 @@
       "type": "object"
     },
     "animations": {
-      "description": "Animation name -> ordered list of frame keys (each non-empty).",
+      "description": "Animation name -> ordered list of frame keys (each non-empty). Must declare at least one animation.",
       "type": "object",
+      "minProperties": 1,
       "additionalProperties": {
         "type": "array",
         "items": { "type": "string" },