@aura3d/engine 1.3.2 → 1.4.0

package/README.md

@@ -5,27 +5,134 @@
 [![license: MIT](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-browser%203D-3178c6.svg)](https://www.typescriptlang.org/)
 
-Aura3D is an AI-native TypeScript 3D SDK for browser 3D apps, prompt-to-code scenes, GLB/glTF product viewers, browser-native game routes, Vite templates, typed asset workflows, diagnostics, screenshots, and static deployment checks.
+Aura3D is an AI-native TypeScript 3D SDK for browser 3D apps, prompt-to-code scenes, GLB/glTF product viewers, browser-native game prototypes, Vite templates, typed asset workflows, diagnostics, screenshots, and static deployment checks.
 
 Describe the scene. Keep the TypeScript. Ship the browser app.
 
-Aura3D is built for developers and AI coding agents that need real 3D software, not a blank canvas and renderer glue. It gives agents maintained scene kits, typed GLB/glTF assets, product-viewer workflows, browser-game workflows, route-health diagnostics, screenshot evidence, and deployment checks through a public TypeScript API.
-
-Use Aura3D when you are building agent-written browser 3D apps, prompt-authored scenes, product configurators, GLB viewers, browser-native game-route proofs, static-deployed interactive websites, or AI-generated 3D scene tooling.
-
-## Current release
-
-`@aura3d/engine@1.3.2` is the prepared release. It carries everything from 1.1.0 — browser-native game routes, visible GLB animation runtime evidence, prompt-animation playback, AuraVoice timing packages, typed assets, diagnostics, screenshots, and readiness evidence — and adds the **Animation Engine**, the **Believable-Motion** track, and the **Animation Studio** (all below). It runs on Aura's own WebGL2 + WebGPU renderer; migrating an existing project is covered by the separately installed `@aura3d/three-compat` package.
-
-Animation Engine (in 1.3.2): `@aura3d/animation` gains a locomotion state-graph + kit (`createLocomotionAnimationStateGraph`, `createLocomotionKit`), a generic `validateAnimationClipMap`, a shared fighter-animation adapter, and per-clip bone-mask blending in `applyClips` (layered playback). New CLI: `aura3d assets validate-animation`. New starter templates: `animation-studio` (typed character → plan/preview/profile/package/verify + kit-driven skinned preview render) and `character-controller` (input → locomotion kit), plus a browser visual editor wired to the headless editor-runtime controllers. The deployed **Aura Clash** arena gained a real motion upgrade — crossfaded state transitions, hit reactions that vary by attack weight and grounded/airborne state, and attacks layered on an upper-body bone mask over a walking lower body — all browser-verified with deterministic combat replay stable.
-
-Believable-Motion (in 1.3.2): `@aura3d/animation` adds **critically-damped, momentum-preserving state transitions** (a drop-in replacement for the linear crossfade across the mixer, state machine, locomotion kit, and Aura Clash move swaps — motion carries through instead of dissolving), runtime two-bone **foot IK with a foot-lock** that grounds feet on uneven terrain and keeps a planted foot from sliding, **spring-bone secondary dynamics** for weighty body/accessory motion, and **animation event tracks** (named lanes of typed markers — hitbox active-frames, footsteps, VFX — with a browser editor authoring lane). `@aura3d/rendering` gains a **texture-backed morph-target path** that lifts the old 4-target/64-vertex GPU cap for real facial blendshape rigs, **morphs normals so lighting follows the deformation**, and a first-class `node.morphInfluence(name, weight)` API with **viseme-driven lip-sync**, plus **WebGPU character skinning at 96-joint parity** with WebGL2. The deployed **Aura Clash** arena now runs these live — critically-damped move transitions, foot-IK foot-lock with footsteps, spring body-sway, and authored clip-event hit/footstep/VFX frames — with deterministic combat replay still stable. Each feature is gate-backed (`pnpm animation-engine:believable-motion`) and documented in `docs/animation/believable-motion.md`.
+Aura3D is built for developers and AI coding agents that need real 3D software, not a blank canvas and renderer glue. It gives agents maintained scene kits, typed GLB/glTF assets, product-viewer workflows, source-level game prototype workflows, route-health diagnostics, screenshot evidence, and deployment checks through a public TypeScript API.
+
+Use Aura3D when you are building agent-written browser 3D apps, prompt-authored scenes, product configurators, GLB viewers, browser-native game-route prototypes, static-deployed interactive websites, or AI-generated 3D scene tooling.
+
+## Public claim boundary
+
+Aura3D has multiple capability paths. Public claims must name the path they are
+proving:
+
+- root safe API: `@aura3d/engine` through `createAuraApp`;
+- production runtime: `@aura3d/engine/production-runtime`;
+- rendering internals: `@aura3d/rendering` and explicit renderer packages;
+- CLI asset pipeline: `@aura3d/cli` typed asset acquisition and validation;
+- templates and showcase routes.
+
+The root `createAuraApp` path is the API that AI coding agents should use for
+browser examples. A feature is not public-route proof just because a lower-level
+package exports it. For release-facing docs, screenshots, or marketing pages,
+claim only what the mounted route proves with typed assets, browser evidence,
+and route-health output. Unsupported capabilities must be labeled as
+`production-runtime`, `internal`, `prototype`, or `planned`.
+
+Do not use primitives as the primary subject for named real-world objects,
+characters, vehicles, worlds, products, or game environments. Resolve real
+GLB/glTF assets through the Aura3D CLI, import generated `assets` from
+`src/aura-assets.ts`, and render with `model(assets.x)`. Do not use raw string
+asset ids, invented URLs, `GLTFLoader`, direct `three` imports, CSS particles,
+DOM scene effects, or route-local hacks to make a public example appear more
+capable than the Aura3D API path actually is.
+
+## Showcase integrity
+
+The showcase routes must use Aura3D for scene content. CSS and DOM are allowed
+for layout, HUDs, buttons, panels, responsive sizing, and accessibility text
+only. They must not be used as a substitute for 3D content, particles, motion,
+track scenery, city scenery, data visuals, robots, vehicles, beams, scanlines,
+vignettes, or other effects that are claimed as part of the 3D scene.
+
+The current release-candidate showcase classification is:
+
+- Public release candidates: `apps/showcase-product-configurator/`,
+  `apps/showcase-material-asset-inspector/`,
+  `apps/showcase-smart-city-control/`,
+  `apps/showcase-cinematic-architecture/`,
+  `apps/showcase-digital-twin-ops/`, and
+  `apps/showcase-blockfall-reactor/`.
+- Internal diagnostics retained for evidence only:
+  `apps/showcase-data-galaxy/` and
+  `apps/showcase-webgpu-particle-lab/`.
+- Prototype-blocked game diagnostics, intentionally removed from public
+  examples: `apps/showcase-turbo-drift-circuit/` and
+  `apps/showcase-skyline-runner/`.
+
+`node tools/showcase-library/build-and-check.mjs` is the release gate for this
+classification. The current public release status is 6/6 public candidates
+passing, with two internal diagnostics and two prototype-blocked game routes
+retained outside the public showcase path.
+
+For those routes, the implementation boundary is:
+
+- Use public `@aura3d/engine` APIs such as `createAuraApp`,
+  `createGameApp`, `scene`, `sceneKits`, `model`, `camera`, `lights`,
+  `material`, `primitives`, `effects`, `particles`, `labels`, `charts`,
+  `game`, `interactions`, and `timeline`.
+- Use typed assets from `src/aura-assets.ts` with `model(assets.x)`.
+  Do not write string asset ids such as `model("asset")`, invented URLs, raw
+  GLB URLs, or direct loader code.
+- Use Aura3D particles through `effects.particles(...)`,
+  `particles.fountain(...)`, or the explicit WebGPU rendering path when it is
+  actually supported. Do not create particle clouds with DOM nodes, CSS
+  animations, pseudo-elements, or background gradients.
+- Use Aura3D runtime movement through `app.onFrame(...)`,
+  `.runtime(game.runtimeNode("id"))`, and runtime node mutation. Do not fake
+  scene motion with CSS keyframes or DOM transforms.
+- Use CSS only for UI chrome and layout. A screenshot should still show the
+  3D scene, particles, motion targets, and typed assets when CSS decorative
+  backgrounds are removed.
+- Keep claims honest: native WebGPU, typed asset usage, game runtime,
+  animation, particles, screenshots, and deployment readiness must each map to
+  a named API, route evidence global, test, screenshot, or report.
+
+Current renderer boundary: the `createAuraApp` WebGL2 agent runtime used by the
+showcase routes renders typed GLB meshes, glTF base-color textures, non-skinned
+glTF node animation clips, Aura primitives, Aura particle effects,
+runtime-node transforms, and basic scene effects. It is still not the full
+production renderer path: it does not yet render skinned GLB animation mixer
+playback, full PBR material stacks, image-based lighting, shadow maps, or
+postprocess passes in pixels on that route. Do not claim visible skinned
+character animation or Three.js-grade production material parity from a
+`createAuraApp` screenshot until the agent renderer adapter is wired to the
+production animation/skinning and material runtime; publish unsupported
+capabilities as metadata only.
+
+Release-facing showcase PRs must pass `assets validate --source --release`,
+route-health collection, browser screenshots, visual review, and game input
+tests where applicable. If any route uses primitive-only primary subjects, fake
+CSS/DOM particles, unsupported WebGPU/PBR/skinning claims, or screenshots where
+the primary subject is hidden, tiny, clipped, or unreadable, the route must be
+classified as prototype, internal diagnostic, or blocked instead of public.
+
+## Current Release And Release Candidate
+
+`@aura3d/engine@1.3.3` is the published release, live on npm `latest`. It carries everything from 1.1.0 -- browser-native game-route foundations, GLB animation/runtime evidence where renderer-backed, prompt-animation playback, AuraVoice timing packages, typed assets, diagnostics, screenshots, and readiness evidence -- and adds the **Animation Engine**, the **Believable-Motion** track, and the **Animation Studio** (all below). Public examples still need to distinguish root `createAuraApp` proof from production-runtime or rendering-internal capability. Migrating an existing project is covered by the separately installed `@aura3d/three-compat` package.
+
+The next release candidate is being prepared from the current repository state.
+Its release-facing scope is the corrected showcase and asset-evidence pipeline:
+role-aware release asset validation, rendered-probe rejection for fake/stale
+proof, AST source validation, package/dist parity checks, resolver-backed
+showcase-spec repair, route-primary probes, gameplay proof where appropriate,
+and visual review as a hard public-release gate. The public showcase path now
+contains six bounded, visually accepted release candidates. Data Galaxy and
+WebGPU Particle Lab stay internal diagnostics. Turbo Drift Circuit and Skyline
+Runner stay prototype-blocked until the game layer has certified racing
+topology and platformer playable-surface support.
+
+Animation Engine (in 1.3.3): `@aura3d/animation` gains a locomotion state-graph + kit (`createLocomotionAnimationStateGraph`, `createLocomotionKit`), a generic `validateAnimationClipMap`, a shared fighter-animation adapter, and per-clip bone-mask blending in `applyClips` (layered playback). New CLI: `aura3d assets validate-animation`. New starter templates: `animation-studio` (typed character → plan/preview/profile/package/verify + kit-driven skinned preview render) and `character-controller` (input → locomotion kit), plus a browser visual editor wired to the headless editor-runtime controllers. The deployed **Aura Clash** arena gained a real motion upgrade — crossfaded state transitions, hit reactions that vary by attack weight and grounded/airborne state, and attacks layered on an upper-body bone mask over a walking lower body — all browser-verified with deterministic combat replay stable.
+
+Believable-Motion (in 1.3.3): `@aura3d/animation` adds **critically-damped, momentum-preserving state transitions** (a drop-in replacement for the linear crossfade across the mixer, state machine, locomotion kit, and Aura Clash move swaps — motion carries through instead of dissolving), runtime two-bone **foot IK with a foot-lock** that grounds feet on uneven terrain and keeps a planted foot from sliding, **spring-bone secondary dynamics** for weighty body/accessory motion, and **animation event tracks** (named lanes of typed markers — hitbox active-frames, footsteps, VFX — with a browser editor authoring lane). `@aura3d/rendering` gains a **texture-backed morph-target path** that lifts the old 4-target/64-vertex GPU cap for real facial blendshape rigs, **morphs normals so lighting follows the deformation**, and a first-class `node.morphInfluence(name, weight)` API with **viseme-driven lip-sync**, plus **WebGPU character skinning at 96-joint parity** with WebGL2. The deployed **Aura Clash** arena now runs these live — critically-damped move transitions, foot-IK foot-lock with footsteps, spring body-sway, and authored clip-event hit/footstep/VFX frames — with deterministic combat replay still stable. Each feature is gate-backed (`pnpm animation-engine:believable-motion`) and documented in `docs/animation/believable-motion.md`.
 
 The **Animation Studio** turns a natural-language prompt into a deterministic, rendered animated short: a generated **EpisodeDocument** (cast/set/dialogue/blocking/camera) played by a generic renderer, directed by your own coding agent through a validated Scene-Tool CLI (no bundled LLM), with a shared retargeted motion library, speech-duration caption timing, a 10-gate quality suite, a web studio app, and silent WebM export (AuraVoice owns the voice). Scaffold it with `npx create-aura3d@latest my-app --template animation-studio`; full docs in [`docs/animation-studio/`](docs/animation-studio/README.md).
 
 Aura3D ships a real animation engine: critically-damped, momentum-preserving transitions, two-bone foot IK with a foot-lock, spring-bone secondary dynamics, animation event tracks, texture-backed facial morph targets with viseme lip-sync, and 96-joint character skinning on both WebGL2 and WebGPU — each gate-backed and running live in Aura Clash. Aura Clash uses starter-grade fighter assets with **no new fighter art this release** (the rigs carry no facial blendshapes, so the morph/viseme work is showcased in Animation Studio and the morph proofs), so it stays a development showcase of the engine rather than a finished commercial game.
 
-Registry status: npm `latest` serves `1.3.2` across all 26 packages (`@aura3d/engine`, `@aura3d/asset-index`, `@aura3d/cli`, `create-aura3d`, …). The `animation-studio` / `character-controller` templates and the new APIs above are live for `npx ...@latest` users, and the showcase is deployed at https://aura3d.auraone.ai.
+Registry status: npm `latest` still serves `1.3.3` across all 26 packages (`@aura3d/engine`, `@aura3d/asset-index`, `@aura3d/cli`, `create-aura3d`, …) until the next package publication completes. The `animation-studio` / `character-controller` templates and the 1.3.3 APIs above are live for `npx ...@latest` users, and the showcase is deployed at https://aura3d.auraone.ai.
 
 ## Aura3D 1.1.0 asset catalog
 
@@ -49,9 +156,9 @@ npx @aura3d/cli@latest assets validate-game --profile fighting-character --asset
 `--profile fighting-character` requires animated GLB candidates from verified CC0/CC-BY sources, applies a browser-sized triangle budget, and writes source URL, license, author/attribution, and source family into `aura.assets.json` during `assets resolve`.
 ## Aura3D 1.1.0 runtime launch track
 
-Aura3D 1.1.0 is the active runtime and animation evidence foundation for the next public showcase wave:
+Aura3D 1.1.0 introduced the runtime and animation evidence foundation; 1.3.3 is the current published release that carries it forward:
 
-- `game runtime`: mutable runtime nodes, app-owned frame loops, input, kinematic bodies, hitboxes, combat events, camera direction, effects, and evidence for browser-native game routes.
+- `game runtime`: mutable runtime nodes, app-owned frame loops, input, kinematic bodies, hitboxes, combat events, camera direction, effects, and evidence for browser-native game prototypes.
 - `fighting-game template`: `npx create-aura3d@latest my-fighter --template fighting-game` scaffolds a public-API playable starter using typed assets, `app.input(...)`, `app.onFrame(...)`, `game.kinematicBody(...)`, `game.combatWorld(...)`, and `app.evidence(...)`.
 - `prompt animation`: `npx create-aura3d@latest my-episode --template prompt-animation-channel` scaffolds structured episode plans, storyboards, shot timelines, captions, visemes, render queues, and evidence for prompt-authored animation/video workflows. The shorter `animation-channel` template name remains supported.
 - `AuraVoice bridge`: AuraVoice owns script/audio/caption/viseme timing; Aura3D owns typed scene generation, character performance, camera choreography, rendering, screenshots, and visual evidence.
@@ -91,7 +198,7 @@ import { createAuraApp, sceneKits } from "@aura3d/engine";
 - AI-generated 3D scenes that remain editable TypeScript.
 - Browser 3D apps built with a stable SDK instead of improvised renderer glue.
 - Typed GLB/glTF product viewers, product configurators, and model showcases.
-- Browser-native games with playable routes, HUDs, input, evidence, tests, and deploy-ready output.
+- Browser-native game prototypes with playable routes, HUDs, input, evidence, tests, and deploy-ready output. Public racing/platformer examples require the certified game-geometry layer described in `docs/project/aura3d-game-layer-rebuild-plan.md`.
 - Prompt-to-3D workflows for AI coding agents, Cursor, Claude, Codex, and other assistants.
 - WebGL/WebGPU-ready examples with maintained scene kits and diagnostics.
 - Vite 3D starter apps with route health, screenshot tests, and deploy checks.
@@ -453,9 +560,9 @@ Maintained scene-kit families include physics playgrounds, particle fountains, s
 
 ## Production browser 3D workflow
 
-Aura3D is built for the AI-assisted browser 3D era. It gives teams a source-code-first TypeScript workflow where agents generate maintainable scenes, game routes, product viewers, and deployable interactive websites.
+Aura3D is built for the AI-assisted browser 3D era. It gives teams a source-code-first TypeScript workflow where agents generate maintainable scenes, game prototypes, product viewers, and deployable interactive websites.
 
-Aura3D combines scene kits, GLB/glTF asset typing, product viewers, browser-game runtime helpers, a believable-motion animation engine, physics scenes, particles, material labs, data worlds, route diagnostics, screenshot workflows, and static deployment into one agent-ready SDK.
+Aura3D combines scene kits, GLB/glTF asset typing, product viewers, browser-game runtime helpers, a believable-motion animation engine, physics scenes, particles, material labs, data worlds, route diagnostics, screenshot workflows, and static deployment into one agent-ready SDK. Route-level game proofs are not public-quality game examples until visual review and game-geometry evidence pass.
 
 ## Documentation
 
@@ -501,7 +608,7 @@ Aura3D 1.1.0 game-engine/showcase readiness is stricter:
 pnpm aura3d110:readiness
 ```
 
-Expected current state — The scoped 1.3.2 gates pass.
+Expected current state — The scoped package gates pass for the published 1.3.3 baseline, and the release-candidate showcase gate passes for six public examples while retaining two internal diagnostics and two prototype-blocked game routes outside the public path.
 
 ## Contributing
 

package/dist/animation/library/performanceStateGraph.d.ts

@@ -18,20 +18,28 @@ export declare const PERFORMANCE_GRAPH_PARAMETERS: {
     readonly gesture: "gesture";
     readonly point: "point";
     readonly nod: "nod";
+    readonly wave: "wave";
     readonly react: "react";
     readonly walk: "isMoving";
     readonly run: "isRunning";
+    readonly sit: "sit";
+    readonly shrug: "shrug";
+    readonly cross_arms: "crossArms";
+    readonly salute: "salute";
+    readonly shake_head: "shakeHead";
 };
 /**
- * State graph over the 8 standard performance clip ids ({@link STANDARD_CLIP_IDS}) with `idle` as the
+ * State graph over the 14 standard performance clip ids ({@link STANDARD_CLIP_IDS}) with `idle` as the
  * default state. The studio requests a state per beat and the machine crossfades via the inertialized
  * {@link AnimationStateMachine.stateBlend}.
  *
  * Topology:
- *  - `idle` (default) can go to `talk`, `gesture`, `point`, `nod`, `react`, `walk`, `run`.
+ *  - `idle` (default) can go to any performance or locomotion state.
  *  - `talk` is a held loop (while `isSpeaking`) that returns to idle when the flag clears; from talk
  *    you can still fire one-shots and start moving.
- *  - `gesture` / `point` / `nod` / `react` are one-shots that auto-return to idle on completion.
+ *  - `gesture` / `point` / `nod` / `wave` / `react` / `shrug` / `salute` / `shake_head` are one-shots
+ *    that auto-return to idle on completion.
+ *  - `sit` and `cross_arms` are held loops that return to idle when their flag clears.
  *  - `walk` <-> `run` <-> `idle` form the locomotion blend (`isMoving` / `isRunning`).
  *
  * Priorities: locomotion-stop/one-shots take precedence so a requested beat wins over the held loop.

package/dist/animation/library/performanceStateGraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"performanceStateGraph.d.ts","sourceRoot":"","sources":["../../../../../packages/animation/src/library/performanceStateGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAA6C,MAAM,6BAA6B,CAAC;AAC/G,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEpF,MAAM,WAAW,4BAA4B;IAC3C,4FAA4F;IAC5F,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,6FAA6F;IAC7F,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;CAQmB,CAAC;AA6B7D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,4BAAiC,GAAG,qBAAqB,CA6C7G;AAED,uGAAuG;AACvG,eAAO,MAAM,wBAAwB,EAAE,SAAS,cAAc,EAAsB,CAAC"}
+{"version":3,"file":"performanceStateGraph.d.ts","sourceRoot":"","sources":["../../../../../packages/animation/src/library/performanceStateGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAA6C,MAAM,6BAA6B,CAAC;AAC/G,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEpF,MAAM,WAAW,4BAA4B;IAC3C,4FAA4F;IAC5F,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,6FAA6F;IAC7F,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;CAcmB,CAAC;AA6B7D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,4BAAiC,GAAG,qBAAqB,CA6F7G;AAED,uGAAuG;AACvG,eAAO,MAAM,wBAAwB,EAAE,SAAS,cAAc,EAAsB,CAAC"}

package/dist/animation/library/performanceStateGraph.js

@@ -12,9 +12,15 @@ export const PERFORMANCE_GRAPH_PARAMETERS = {
     gesture: "gesture",
     point: "point",
     nod: "nod",
+    wave: "wave",
     react: "react",
     walk: "isMoving",
-    run: "isRunning"
+    run: "isRunning",
+    sit: "sit",
+    shrug: "shrug",
+    cross_arms: "crossArms",
+    salute: "salute",
+    shake_head: "shakeHead"
 };
 function trigger(to, parameter, priority, consume = false, expected = true) {
     return {
@@ -40,15 +46,17 @@ function truthy(value) {
     return false;
 }
 /**
- * State graph over the 8 standard performance clip ids ({@link STANDARD_CLIP_IDS}) with `idle` as the
+ * State graph over the 14 standard performance clip ids ({@link STANDARD_CLIP_IDS}) with `idle` as the
  * default state. The studio requests a state per beat and the machine crossfades via the inertialized
  * {@link AnimationStateMachine.stateBlend}.
  *
  * Topology:
- *  - `idle` (default) can go to `talk`, `gesture`, `point`, `nod`, `react`, `walk`, `run`.
+ *  - `idle` (default) can go to any performance or locomotion state.
  *  - `talk` is a held loop (while `isSpeaking`) that returns to idle when the flag clears; from talk
  *    you can still fire one-shots and start moving.
- *  - `gesture` / `point` / `nod` / `react` are one-shots that auto-return to idle on completion.
+ *  - `gesture` / `point` / `nod` / `wave` / `react` / `shrug` / `salute` / `shake_head` are one-shots
+ *    that auto-return to idle on completion.
+ *  - `sit` and `cross_arms` are held loops that return to idle when their flag clears.
  *  - `walk` <-> `run` <-> `idle` form the locomotion blend (`isMoving` / `isRunning`).
  *
  * Priorities: locomotion-stop/one-shots take precedence so a requested beat wins over the held loop.
@@ -63,19 +71,29 @@ export function createPerformanceStateGraph(options = {}) {
     const toGesture = trigger("gesture", P.gesture, 80, true);
     const toPoint = trigger("point", P.point, 80, true);
     const toNod = trigger("nod", P.nod, 80, true);
+    const toWave = trigger("wave", P.wave, 80, true);
     const toReact = trigger("react", P.react, 90, true);
+    const toShrug = trigger("shrug", P.shrug, 80, true);
+    const toSalute = trigger("salute", P.salute, 80, true);
+    const toShakeHead = trigger("shake_head", P.shake_head, 80, true);
+    const toSit = trigger("sit", P.sit, 35);
+    const toCrossArms = trigger("cross_arms", P.cross_arms, 35);
     const states = [
         {
             name: idle,
-            transitions: [toReact, toGesture, toPoint, toNod, toRun, toWalk, toTalk]
+            transitions: [toReact, toShakeHead, toSalute, toShrug, toGesture, toPoint, toNod, toWave, toCrossArms, toSit, toRun, toWalk, toTalk]
         },
         {
             name: "talk",
             transitions: [
                 toReact,
+                toShakeHead,
+                toSalute,
+                toShrug,
                 toGesture,
                 toPoint,
                 toNod,
+                toWave,
                 toRun,
                 toWalk,
                 trigger(idle, P.talk, 0, false, false)
@@ -84,7 +102,45 @@ export function createPerformanceStateGraph(options = {}) {
         { name: "gesture", duration: oneShot, oneShot: true, onComplete: idle },
         { name: "point", duration: oneShot, oneShot: true, onComplete: idle },
         { name: "nod", duration: oneShot, oneShot: true, onComplete: idle },
+        { name: "wave", duration: oneShot, oneShot: true, onComplete: idle },
         { name: "react", duration: oneShot, oneShot: true, onComplete: idle },
+        { name: "shrug", duration: oneShot, oneShot: true, onComplete: idle },
+        { name: "salute", duration: oneShot, oneShot: true, onComplete: idle },
+        { name: "shake_head", duration: oneShot, oneShot: true, onComplete: idle },
+        // Held loops: stay in the state while the flag is truthy, return to idle when it
+        // clears. One-shots/locomotion keep higher priority so a requested beat wins.
+        {
+            name: "sit",
+            transitions: [
+                toReact,
+                toShakeHead,
+                toSalute,
+                toShrug,
+                toGesture,
+                toPoint,
+                toNod,
+                toWave,
+                toRun,
+                toWalk,
+                trigger(idle, P.sit, 0, false, false)
+            ]
+        },
+        {
+            name: "cross_arms",
+            transitions: [
+                toReact,
+                toShakeHead,
+                toSalute,
+                toShrug,
+                toGesture,
+                toPoint,
+                toNod,
+                toWave,
+                toRun,
+                toWalk,
+                trigger(idle, P.cross_arms, 0, false, false)
+            ]
+        },
         {
             name: "walk",
             transitions: [toRun, trigger(idle, P.walk, 0, false, false)]

package/dist/animation/library/performanceStateGraph.js.map

@@ -1 +1 @@
-{"version":3,"file":"performanceStateGraph.js","sourceRoot":"","sources":["../../../../../packages/animation/src/library/performanceStateGraph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"performanceStateGraph.js","sourceRoot":"","sources":["../../../../../packages/animation/src/library/performanceStateGraph.ts"],"names":[],"mappings":"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"}

package/dist/animation/library/standardHumanoidClips.d.ts

@@ -1,10 +1,10 @@
 import { AnimationClipRegistry, type AnimationClipDefinition } from "../AnimationClipRegistry.js";
 import { type HumanoidRigDefinition } from "../HumanoidRetargeting.js";
 /**
- * The STANDARD performance vocabulary (Phase 2.4). These 8 ids are the contract the Animation
+ * The STANDARD performance vocabulary (Phase 2.4). These 14 ids are the contract the Animation
  * Studio drives — every shared library, retarget target, and state graph speaks exactly these.
  */
-export declare const STANDARD_CLIP_IDS: readonly ["idle", "talk", "gesture", "point", "nod", "walk", "run", "react"];
+export declare const STANDARD_CLIP_IDS: readonly ["idle", "talk", "gesture", "point", "nod", "wave", "walk", "run", "react", "sit", "shrug", "cross_arms", "salute", "shake_head"];
 export type StandardClipId = typeof STANDARD_CLIP_IDS[number];
 /** Locomotion subset of the vocabulary (used by the locomotion blend / studio clip-map check). */
 export declare const STANDARD_LOCOMOTION_CLIP_IDS: readonly ["idle", "walk", "run"];
@@ -17,7 +17,7 @@ export declare const STANDARD_LIBRARY_RIG: HumanoidRigDefinition;
 /** Ordered list of all standard library clip definitions (idle first). */
 export declare function createStandardHumanoidClipDefinitions(): readonly AnimationClipDefinition<StandardClipId>[];
 /**
- * Shared, rig-neutral {@link AnimationClipRegistry} populated with the 8 standard performance clips
+ * Shared, rig-neutral {@link AnimationClipRegistry} populated with the 14 standard performance clips
  * authored on {@link STANDARD_LIBRARY_RIG} (canonical {@link HUMANOID_BONES}). The clips are COMPACT
  * procedural keyframe loops/one-shots — real, samplable {@link AnimationTrack} data, not mocap and
  * not placeholders. They give the studio a guaranteed, retargetable performance vocabulary even when

package/dist/animation/library/standardHumanoidClips.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standardHumanoidClips.d.ts","sourceRoot":"","sources":["../../../../../packages/animation/src/library/standardHumanoidClips.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EAErB,KAAK,uBAAuB,EAC7B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAyC,KAAK,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAE9G;;;GAGG;AACH,eAAO,MAAM,iBAAiB,8EAA+E,CAAC;AAC9G,MAAM,MAAM,cAAc,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAE9D,kGAAkG;AAClG,eAAO,MAAM,4BAA4B,kCAAmC,CAAC;AAO7E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,qBAalC,CAAC;AAyXF,0EAA0E;AAC1E,wBAAgB,qCAAqC,IAAI,SAAS,uBAAuB,CAAC,cAAc,CAAC,EAAE,CAW1G;AAED;;;;;;GAMG;AACH,wBAAgB,kCAAkC,IAAI,qBAAqB,CAAC,cAAc,CAAC,CAE1F"}
+{"version":3,"file":"standardHumanoidClips.d.ts","sourceRoot":"","sources":["../../../../../packages/animation/src/library/standardHumanoidClips.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EAErB,KAAK,uBAAuB,EAC7B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAyC,KAAK,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAE9G;;;GAGG;AACH,eAAO,MAAM,iBAAiB,4IAIpB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAE9D,kGAAkG;AAClG,eAAO,MAAM,4BAA4B,kCAAmC,CAAC;AAO7E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,qBAalC,CAAC;AAwkBF,0EAA0E;AAC1E,wBAAgB,qCAAqC,IAAI,SAAS,uBAAuB,CAAC,cAAc,CAAC,EAAE,CAiB1G;AAED;;;;;;GAMG;AACH,wBAAgB,kCAAkC,IAAI,qBAAqB,CAAC,cAAc,CAAC,CAE1F"}

package/dist/animation/library/standardHumanoidClips.js

@@ -2,10 +2,14 @@ import { AnimationTrack } from "../AnimationTrack.js";
 import { AnimationClipRegistry, createAnimationClipRegistry } from "../AnimationClipRegistry.js";
 import { HUMANOID_BONES } from "../HumanoidRetargeting.js";
 /**
- * The STANDARD performance vocabulary (Phase 2.4). These 8 ids are the contract the Animation
+ * The STANDARD performance vocabulary (Phase 2.4). These 14 ids are the contract the Animation
  * Studio drives — every shared library, retarget target, and state graph speaks exactly these.
  */
-export const STANDARD_CLIP_IDS = ["idle", "talk", "gesture", "point", "nod", "walk", "run", "react"];
+export const STANDARD_CLIP_IDS = [
+    "idle", "talk", "gesture", "point", "nod", "wave",
+    "walk", "run", "react",
+    "sit", "shrug", "cross_arms", "salute", "shake_head"
+];
 /** Locomotion subset of the vocabulary (used by the locomotion blend / studio clip-map check). */
 export const STANDARD_LOCOMOTION_CLIP_IDS = ["idle", "walk", "run"];
 const FRAME_RATE = 30;
@@ -331,6 +335,171 @@ function walkClip() {
 function runClip() {
     return legCycle("run", 0.6, 0.9, 1.1, 0.07);
 }
+// --- wave: one-shot greeting wave (right arm) ---------------------------------------------------
+function waveClip() {
+    const d = 1.2;
+    return clip("wave", d, [
+        rotationTrack("rightUpperArm", d, [
+            { t: 0, e: [0, 0, -0.2] },
+            { t: 0.3, e: [0.5, -0.2, -1.4] },
+            { t: 0.5, e: [0.6, -0.1, -1.55] },
+            { t: 0.7, e: [0.5, -0.2, -1.4] },
+            { t: 0.9, e: [0.6, -0.1, -1.55] },
+            { t: 1.1, e: [0.4, -0.15, -1.3] }
+        ]),
+        rotationTrack("rightLowerArm", d, [
+            { t: 0, e: [0, 0, -0.3] },
+            { t: 0.3, e: [0, -0.3, -0.8] },
+            { t: 0.5, e: [0, -0.2, -0.9] },
+            { t: 0.7, e: [0, -0.3, -0.8] },
+            { t: 0.9, e: [0, -0.2, -0.9] },
+            { t: 1.1, e: [0, -0.25, -0.7] }
+        ]),
+        rotationTrack("head", d, [
+            { t: 0, e: [0, 0, 0] },
+            { t: 0.3, e: [0.05, 0.12, 0] },
+            { t: 1.1, e: [0, 0.08, 0] }
+        ])
+    ], false, ["wave", "performance", "one-shot", "upper-body"]);
+}
+// --- sit: seated resting pose loop ---------------------------------------------------------------
+function sitClip() {
+    const d = 3;
+    return clip("sit", d, [
+        translationTrack("hips", d, [
+            { t: 0, p: [0, -0.45, 0] },
+            { t: 1.5, p: [0, -0.42, 0] },
+            { t: 3, p: [0, -0.45, 0] }
+        ]),
+        rotationTrack("hips", d, [
+            { t: 0, e: [0.35, 0, 0] },
+            { t: 1.5, e: [0.38, 0, 0] },
+            { t: 3, e: [0.35, 0, 0] }
+        ]),
+        rotationTrack("leftUpperLeg", d, [
+            { t: 0, e: [-1.1, 0, 0] },
+            { t: 1.5, e: [-1.05, 0, 0] },
+            { t: 3, e: [-1.1, 0, 0] }
+        ]),
+        rotationTrack("rightUpperLeg", d, [
+            { t: 0, e: [-1.1, 0, 0] },
+            { t: 1.5, e: [-1.15, 0, 0] },
+            { t: 3, e: [-1.1, 0, 0] }
+        ]),
+        rotationTrack("leftLowerLeg", d, [
+            { t: 0, e: [1.6, 0, 0] },
+            { t: 1.5, e: [1.55, 0, 0] },
+            { t: 3, e: [1.6, 0, 0] }
+        ]),
+        rotationTrack("rightLowerLeg", d, [
+            { t: 0, e: [1.6, 0, 0] },
+            { t: 1.5, e: [1.65, 0, 0] },
+            { t: 3, e: [1.6, 0, 0] }
+        ]),
+        rotationTrack("spine", d, [
+            { t: 0, e: [0.18, 0, 0] },
+            { t: 1.5, e: [0.0, 0, 0] },
+            { t: 3, e: [0.18, 0, 0] }
+        ]),
+        rotationTrack("leftUpperArm", d, [
+            { t: 0, e: [0.15, 0, 0.1] },
+            { t: 1.5, e: [0.12, 0, 0.08] },
+            { t: 3, e: [0.15, 0, 0.1] }
+        ])
+    ], true, ["sit", "performance", "loop", "full-body"]);
+}
+// --- shrug: one-shot shoulder shrug -------------------------------------------------------------
+function shrugClip() {
+    const d = 0.9;
+    return clip("shrug", d, [
+        rotationTrack("leftUpperArm", d, [
+            { t: 0, e: [0, 0, 0.2] },
+            { t: 0.3, e: [0, 0, 0.9] },
+            { t: 0.6, e: [0, 0, 0.3] }
+        ]),
+        rotationTrack("rightUpperArm", d, [
+            { t: 0, e: [0, 0, -0.2] },
+            { t: 0.3, e: [0, 0, -0.9] },
+            { t: 0.6, e: [0, 0, -0.3] }
+        ]),
+        rotationTrack("spine", d, [
+            { t: 0, e: [0, 0, 0] },
+            { t: 0.3, e: [0.06, 0, 0] },
+            { t: 0.6, e: [0, 0, 0] }
+        ])
+    ], false, ["shrug", "performance", "one-shot", "upper-body"]);
+}
+// --- cross_arms: standing arms-crossed pose loop ------------------------------------------------
+function crossArmsClip() {
+    const d = 3;
+    return clip("cross_arms", d, [
+        rotationTrack("leftUpperArm", d, [
+            { t: 0, e: [0, 0, 0.5] },
+            { t: 1.5, e: [0, 0, 0.7] },
+            { t: 3, e: [0, 0, 0.5] }
+        ]),
+        rotationTrack("leftLowerArm", d, [
+            { t: 0, e: [0, 0, 1.35] },
+            { t: 1.5, e: [0, 0, 1.6] },
+            { t: 3, e: [0, 0, 1.35] }
+        ]),
+        rotationTrack("rightUpperArm", d, [
+            { t: 0, e: [0, 0, -0.5] },
+            { t: 1.5, e: [0, 0, -0.7] },
+            { t: 3, e: [0, 0, -0.5] }
+        ]),
+        rotationTrack("rightLowerArm", d, [
+            { t: 0, e: [0, 0, -1.35] },
+            { t: 1.5, e: [0, 0, -1.6] },
+            { t: 3, e: [0, 0, -1.35] }
+        ])
+    ], true, ["cross_arms", "performance", "loop", "upper-body"]);
+}
+// --- salute: one-shot hand-to-forehead ----------------------------------------------------------
+function saluteClip() {
+    const d = 1;
+    return clip("salute", d, [
+        rotationTrack("rightUpperArm", d, [
+            { t: 0, e: [0, 0, -0.2] },
+            { t: 0.35, e: [1.3, -0.5, -1.2] },
+            { t: 0.7, e: [1.3, -0.5, -1.2] },
+            { t: 1, e: [0.4, -0.2, -0.8] }
+        ]),
+        rotationTrack("rightLowerArm", d, [
+            { t: 0, e: [0, 0, -0.3] },
+            { t: 0.35, e: [0, -0.4, -1.3] },
+            { t: 0.7, e: [0, -0.4, -1.3] },
+            { t: 1, e: [0, -0.2, -0.7] }
+        ]),
+        rotationTrack("head", d, [
+            { t: 0, e: [0, 0, 0] },
+            { t: 0.35, e: [0.08, -0.1, 0] },
+            { t: 1, e: [0, 0, 0] }
+        ])
+    ], false, ["salute", "performance", "one-shot", "upper-body"]);
+}
+// --- shake_head: one-shot side-to-side "no" -----------------------------------------------------
+function shakeHeadClip() {
+    const d = 0.8;
+    return clip("shake_head", d, [
+        rotationTrack("head", d, [
+            { t: 0, e: [0, 0, 0] },
+            { t: 0.15, e: [0, -0.45, 0] },
+            { t: 0.3, e: [0, 0.45, 0] },
+            { t: 0.45, e: [0, -0.45, 0] },
+            { t: 0.6, e: [0, 0.45, 0] },
+            { t: 0.75, e: [0, 0, 0] }
+        ]),
+        rotationTrack("neck", d, [
+            { t: 0, e: [0, 0, 0] },
+            { t: 0.15, e: [0, -0.25, 0] },
+            { t: 0.3, e: [0, 0.25, 0] },
+            { t: 0.45, e: [0, -0.25, 0] },
+            { t: 0.6, e: [0, 0.25, 0] },
+            { t: 0.75, e: [0, 0, 0] }
+        ])
+    ], false, ["shake_head", "performance", "one-shot"]);
+}
 /** Ordered list of all standard library clip definitions (idle first). */
 export function createStandardHumanoidClipDefinitions() {
     return [
@@ -339,13 +508,19 @@ export function createStandardHumanoidClipDefinitions() {
         gestureClip(),
         pointClip(),
         nodClip(),
+        waveClip(),
         walkClip(),
         runClip(),
-        reactClip()
+        reactClip(),
+        sitClip(),
+        shrugClip(),
+        crossArmsClip(),
+        saluteClip(),
+        shakeHeadClip()
     ];
 }
 /**
- * Shared, rig-neutral {@link AnimationClipRegistry} populated with the 8 standard performance clips
+ * Shared, rig-neutral {@link AnimationClipRegistry} populated with the 14 standard performance clips
  * authored on {@link STANDARD_LIBRARY_RIG} (canonical {@link HUMANOID_BONES}). The clips are COMPACT
  * procedural keyframe loops/one-shots — real, samplable {@link AnimationTrack} data, not mocap and
  * not placeholders. They give the studio a guaranteed, retargetable performance vocabulary even when