@almadar/ui 5.142.0 → 5.143.0

package/dist/lib/index.d.cts

@@ -1,7 +1,7 @@
-export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseMarkdownWithCodeBlocks, B as recordServerResponse, F as recordTransition, G as registerCheck, H as registerTraitSnapshot, I as renderStateMachineToDomData, J as renderStateMachineToSvg, K as subscribeToVerification, L as updateAssetStatus, M as updateBridgeHealth, N as updateCheck, O as waitForTransition } from '../cn-rwc3svaX.cjs';
+export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseMarkdownWithCodeBlocks, B as recordServerResponse, F as recordTransition, G as registerCheck, H as registerTraitSnapshot, I as renderStateMachineToDomData, J as renderStateMachineToSvg, K as subscribeToVerification, L as updateAssetStatus, M as updateBridgeHealth, N as updateCheck, O as waitForTransition } from '../cn-CvImTgKH.cjs';
 import { FieldValue, EntityRow, EventPayload } from '@almadar/core';
 export { AssetLoadStatus, BridgeHealth, CheckStatus, EffectTrace, EventLogEntry, OrbitalVerificationAPI, ServerResponseTrace, TraitStateSnapshot, TransitionTrace, VerificationCheck, VerificationSnapshot, VerificationSummary } from '@almadar/core';
-import '../paintDispatch-BQn5Lyx1.cjs';
+import '../paintDispatch-D3-5_cOb.cjs';
 import 'clsx';
 
 /**

package/dist/lib/index.d.ts

@@ -1,7 +1,7 @@
-export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseMarkdownWithCodeBlocks, B as recordServerResponse, F as recordTransition, G as registerCheck, H as registerTraitSnapshot, I as renderStateMachineToDomData, J as renderStateMachineToSvg, K as subscribeToVerification, L as updateAssetStatus, M as updateBridgeHealth, N as updateCheck, O as waitForTransition } from '../cn-BDwC4QpH.js';
+export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseMarkdownWithCodeBlocks, B as recordServerResponse, F as recordTransition, G as registerCheck, H as registerTraitSnapshot, I as renderStateMachineToDomData, J as renderStateMachineToSvg, K as subscribeToVerification, L as updateAssetStatus, M as updateBridgeHealth, N as updateCheck, O as waitForTransition } from '../cn-DryTiahe.js';
 import { FieldValue, EntityRow, EventPayload } from '@almadar/core';
 export { AssetLoadStatus, BridgeHealth, CheckStatus, EffectTrace, EventLogEntry, OrbitalVerificationAPI, ServerResponseTrace, TraitStateSnapshot, TransitionTrace, VerificationCheck, VerificationSnapshot, VerificationSummary } from '@almadar/core';
-import '../paintDispatch-BQn5Lyx1.js';
+import '../paintDispatch-D3-5_cOb.js';
 import 'clsx';
 
 /**

package/dist/{paintDispatch-BQn5Lyx1.d.cts → paintDispatch-D3-5_cOb.d.cts}

@@ -271,42 +271,15 @@ interface DrawTextProps extends DrawableBase {
     opacity?: number;
 }
 
-/**
- * `draw-group` — the drawable CONTAINER atom (dimension-agnostic).
- *
- * Multi-shape art (a hero token = cloak + head + sword shapes) travels as ONE
- * node: the host paints the group by translating to its projected position,
- * applying `scale`/`rotate`/`opacity`, then painting each `items` descriptor
- * through the normal dispatch. `items` is a plain data prop (NOT `children`,
- * which UISlotRenderer special-cases) — same convention as the `draw-*-layer`
- * molecules. The React component renders `null`; it exists so the pattern
- * pipeline registers a `draw-group` pattern and standalone pages stay
- * inspectable. 2D-canvas only — the 3D backend skips it with a warn.
- */
-
-interface DrawGroupProps extends DrawableBase {
-    type: 'draw-group';
-    /** Logical scene position; the projector maps it to pixels / world. */
-    position: ScenePos;
-    /** Uniform scale applied to the whole group. */
-    scale?: number;
-    /** Rotation in radians (painter units). */
-    rotate?: number;
-    /** 0..1 opacity. */
-    opacity?: number;
-    /** Clip the group's items to an SVG path (`d` syntax) in world units relative to the group origin — masked reveals, meters, portraits. */
-    clip?: string;
-    /** The grouped drawables, painted through the normal dispatch. */
-    items: DrawableNode[];
-}
-
 /**
  * `draw-mesh` — the volumetric 3D drawable atom (3D-canvas backend).
  *
  * ONE descriptor (`DrawMeshProps`, grounded in core `ScenePos`) with the R3F
  * backend `Mesh3D` in `lib/drawable/three/DrawMesh3D` (kept OUT of this file so
  * the 2D path never pulls three). A parametric primitive (box, sphere, capsule,
- * cylinder, cone, torus, plane, circle) at a scene position — `position.z` is
+ * cylinder, cone, torus, plane, circle — `plane`/`circle` lie flat in the
+ * scene ground plane facing up, matching the 2D painter) or a raw-geometry `polyhedron`
+ * (`vertices` + `faces` as plain data) at a scene position — `position.z` is
  * height in cells — with a data-driven material (`standard`/`physical`/`toon`/
  * `basic`), an optional inverted-hull outline, and keyframe animation over
  * transform/material tracks. Low-poly is a knob, not a geometry rewrite:
@@ -316,7 +289,7 @@ interface DrawGroupProps extends DrawableBase {
  * pattern and standalone pages stay inspectable.
  */
 
-type MeshShapeKind = 'box' | 'sphere' | 'capsule' | 'cylinder' | 'cone' | 'torus' | 'plane' | 'circle';
+type MeshShapeKind = 'box' | 'sphere' | 'capsule' | 'cylinder' | 'cone' | 'torus' | 'plane' | 'circle' | 'polyhedron';
 type MeshMaterialKind = 'standard' | 'physical' | 'toon' | 'basic';
 type MeshMaterialSide = 'front' | 'back' | 'double';
 /**
@@ -386,6 +359,22 @@ interface DrawMeshAnimation {
     /** Keyframes ordered by `at` (0..1). */
     keyframes: DrawMeshKeyframe[];
 }
+/**
+ * Smooth-skinning data for a `polyhedron` — plain declarative data, no runtime
+ * objects. Vertices carry blended bone weights (a neck-base vertex can be 60%
+ * neck / 40% spine), so the surface stretches continuously across joints
+ * instead of cracking at rigid chunk boundaries.
+ */
+interface DrawMeshSkin {
+    /** Bone names, resolved against sibling `draw-group` `bone:` names in the same canvas. */
+    bones: string[];
+    /** One 16-float column-major inverse bind matrix per bone (model space → bone bind-local; translations in cells). */
+    inverseBindMatrices: number[][];
+    /** Per-vertex bone indices into `bones`, up to 4 each (pad with 0). */
+    indices: number[][];
+    /** Per-vertex blend weights matching `indices`, normalized to sum 1 (pad with 0). */
+    weights: number[][];
+}
 interface DrawMeshProps extends DrawableBase {
     type: 'draw-mesh';
     shape: MeshShapeKind;
@@ -407,9 +396,15 @@ interface DrawMeshProps extends DrawableBase {
     tube?: number;
     /** Curved-surface tessellation, clamped 3..64 (default 24). 4–8 + `flatShading` = low-poly. */
     segments?: number;
+    /** `polyhedron` only: raw vertices as scene-frame `[x, y, z]` triples in cells, `z` = up. */
+    vertices?: number[][];
+    /** `polyhedron` only: triangle index triples into `vertices`, wound counter-clockwise seen from OUTSIDE in the scene frame. */
+    faces?: number[][];
+    /** `polyhedron` only: smooth-skinning weights binding the vertices to named bone groups. Vertices must then be authored in BIND POSE model space; the bones' animated transforms deform them. */
+    skin?: DrawMeshSkin;
     /** Euler rotation `[x, y, z]` in radians. */
     rotation?: [number, number, number];
-    /** `bottom` (default) rests the mesh on its position's ground plane; `center` centers it there. */
+    /** `bottom` (default) rests the mesh on its position's ground plane; `center` centers it there. For `polyhedron`, `bottom` lifts by −min(z) and `center` applies no offset — the vertices are authoritative. */
     pivot?: 'bottom' | 'center';
     material?: MeshMaterial;
     outline?: MeshOutline;
@@ -421,6 +416,51 @@ interface DrawMeshProps extends DrawableBase {
     opacity?: number;
 }
 
+/**
+ * `draw-group` — the drawable CONTAINER atom (dimension-agnostic).
+ *
+ * Multi-shape art (a hero token = cloak + head + sword shapes) travels as ONE
+ * node: the host paints the group by translating to its projected position,
+ * applying `scale`/`rotate`/`opacity`, then painting each `items` descriptor
+ * through the normal dispatch. `items` is a plain data prop (NOT `children`,
+ * which UISlotRenderer special-cases) — same convention as the `draw-*-layer`
+ * molecules. The React component renders `null`; it exists so the pattern
+ * pipeline registers a `draw-group` pattern and standalone pages stay
+ * inspectable. Both backends paint it: 2D as a canvas transform, 3D as a three
+ * `<group>` — with `rotation` + `animation` a nested group chain is a skeleton
+ * bone chain (rotate the shoulder group and the forearm group follows).
+ */
+
+interface DrawGroupProps extends DrawableBase {
+    type: 'draw-group';
+    /** Logical scene position; the projector maps it to pixels / world. */
+    position: ScenePos;
+    /** Uniform scale applied to the whole group. */
+    scale?: number;
+    /** Rotation in radians (painter units). */
+    rotate?: number;
+    /** Euler rotation `[x, y, z]` in radians (world axes) — per-axis joint rotation for the 3D backend; a group placed at a joint with children authored joint-local IS a bone. The 2D painter applies only the in-plane `z` component, after `rotate`. */
+    rotation?: [number, number, number];
+    /** Skeleton bone name. A named group is addressable by a `draw-mesh` `skin`
+     *  block (smooth skinning): the skinned mesh deforms with this group's
+     *  animated transform. Names resolve within the nearest enclosing
+     *  `skeleton: true` group (falling back to the canvas), so multiple
+     *  instances of one rig never collide. Distinct from `id` (the hit-test
+     *  handle). */
+    bone?: string;
+    /** Marks this group as a skeleton SCOPE: `bone` names and `skin` bindings in
+     *  its subtree resolve against each other only — one scope per rig instance. */
+    skeleton?: boolean;
+    /** Keyframe animation over the group TRANSFORM tracks (`offsetX/Y/Z` in cells, `rotateX/Y/Z` in radians, `scale`; the 2D painter also honors `opacity`) — children inherit it, so nested animated groups form a joint chain. Material tracks belong on leaf meshes. */
+    animation?: DrawMeshAnimation;
+    /** 0..1 opacity. */
+    opacity?: number;
+    /** Clip the group's items to an SVG path (`d` syntax) in world units relative to the group origin — masked reveals, meters, portraits. */
+    clip?: string;
+    /** The grouped drawables, painted through the normal dispatch. */
+    items: DrawableNode[];
+}
+
 /**
  * `draw-sprite-layer` — batch multiple sprites in one descriptor for O(layers) rendering.
  *

package/dist/{paintDispatch-BQn5Lyx1.d.ts → paintDispatch-D3-5_cOb.d.ts}

@@ -271,42 +271,15 @@ interface DrawTextProps extends DrawableBase {
     opacity?: number;
 }
 
-/**
- * `draw-group` — the drawable CONTAINER atom (dimension-agnostic).
- *
- * Multi-shape art (a hero token = cloak + head + sword shapes) travels as ONE
- * node: the host paints the group by translating to its projected position,
- * applying `scale`/`rotate`/`opacity`, then painting each `items` descriptor
- * through the normal dispatch. `items` is a plain data prop (NOT `children`,
- * which UISlotRenderer special-cases) — same convention as the `draw-*-layer`
- * molecules. The React component renders `null`; it exists so the pattern
- * pipeline registers a `draw-group` pattern and standalone pages stay
- * inspectable. 2D-canvas only — the 3D backend skips it with a warn.
- */
-
-interface DrawGroupProps extends DrawableBase {
-    type: 'draw-group';
-    /** Logical scene position; the projector maps it to pixels / world. */
-    position: ScenePos;
-    /** Uniform scale applied to the whole group. */
-    scale?: number;
-    /** Rotation in radians (painter units). */
-    rotate?: number;
-    /** 0..1 opacity. */
-    opacity?: number;
-    /** Clip the group's items to an SVG path (`d` syntax) in world units relative to the group origin — masked reveals, meters, portraits. */
-    clip?: string;
-    /** The grouped drawables, painted through the normal dispatch. */
-    items: DrawableNode[];
-}
-
 /**
  * `draw-mesh` — the volumetric 3D drawable atom (3D-canvas backend).
  *
  * ONE descriptor (`DrawMeshProps`, grounded in core `ScenePos`) with the R3F
  * backend `Mesh3D` in `lib/drawable/three/DrawMesh3D` (kept OUT of this file so
  * the 2D path never pulls three). A parametric primitive (box, sphere, capsule,
- * cylinder, cone, torus, plane, circle) at a scene position — `position.z` is
+ * cylinder, cone, torus, plane, circle — `plane`/`circle` lie flat in the
+ * scene ground plane facing up, matching the 2D painter) or a raw-geometry `polyhedron`
+ * (`vertices` + `faces` as plain data) at a scene position — `position.z` is
  * height in cells — with a data-driven material (`standard`/`physical`/`toon`/
  * `basic`), an optional inverted-hull outline, and keyframe animation over
  * transform/material tracks. Low-poly is a knob, not a geometry rewrite:
@@ -316,7 +289,7 @@ interface DrawGroupProps extends DrawableBase {
  * pattern and standalone pages stay inspectable.
  */
 
-type MeshShapeKind = 'box' | 'sphere' | 'capsule' | 'cylinder' | 'cone' | 'torus' | 'plane' | 'circle';
+type MeshShapeKind = 'box' | 'sphere' | 'capsule' | 'cylinder' | 'cone' | 'torus' | 'plane' | 'circle' | 'polyhedron';
 type MeshMaterialKind = 'standard' | 'physical' | 'toon' | 'basic';
 type MeshMaterialSide = 'front' | 'back' | 'double';
 /**
@@ -386,6 +359,22 @@ interface DrawMeshAnimation {
     /** Keyframes ordered by `at` (0..1). */
     keyframes: DrawMeshKeyframe[];
 }
+/**
+ * Smooth-skinning data for a `polyhedron` — plain declarative data, no runtime
+ * objects. Vertices carry blended bone weights (a neck-base vertex can be 60%
+ * neck / 40% spine), so the surface stretches continuously across joints
+ * instead of cracking at rigid chunk boundaries.
+ */
+interface DrawMeshSkin {
+    /** Bone names, resolved against sibling `draw-group` `bone:` names in the same canvas. */
+    bones: string[];
+    /** One 16-float column-major inverse bind matrix per bone (model space → bone bind-local; translations in cells). */
+    inverseBindMatrices: number[][];
+    /** Per-vertex bone indices into `bones`, up to 4 each (pad with 0). */
+    indices: number[][];
+    /** Per-vertex blend weights matching `indices`, normalized to sum 1 (pad with 0). */
+    weights: number[][];
+}
 interface DrawMeshProps extends DrawableBase {
     type: 'draw-mesh';
     shape: MeshShapeKind;
@@ -407,9 +396,15 @@ interface DrawMeshProps extends DrawableBase {
     tube?: number;
     /** Curved-surface tessellation, clamped 3..64 (default 24). 4–8 + `flatShading` = low-poly. */
     segments?: number;
+    /** `polyhedron` only: raw vertices as scene-frame `[x, y, z]` triples in cells, `z` = up. */
+    vertices?: number[][];
+    /** `polyhedron` only: triangle index triples into `vertices`, wound counter-clockwise seen from OUTSIDE in the scene frame. */
+    faces?: number[][];
+    /** `polyhedron` only: smooth-skinning weights binding the vertices to named bone groups. Vertices must then be authored in BIND POSE model space; the bones' animated transforms deform them. */
+    skin?: DrawMeshSkin;
     /** Euler rotation `[x, y, z]` in radians. */
     rotation?: [number, number, number];
-    /** `bottom` (default) rests the mesh on its position's ground plane; `center` centers it there. */
+    /** `bottom` (default) rests the mesh on its position's ground plane; `center` centers it there. For `polyhedron`, `bottom` lifts by −min(z) and `center` applies no offset — the vertices are authoritative. */
     pivot?: 'bottom' | 'center';
     material?: MeshMaterial;
     outline?: MeshOutline;
@@ -421,6 +416,51 @@ interface DrawMeshProps extends DrawableBase {
     opacity?: number;
 }
 
+/**
+ * `draw-group` — the drawable CONTAINER atom (dimension-agnostic).
+ *
+ * Multi-shape art (a hero token = cloak + head + sword shapes) travels as ONE
+ * node: the host paints the group by translating to its projected position,
+ * applying `scale`/`rotate`/`opacity`, then painting each `items` descriptor
+ * through the normal dispatch. `items` is a plain data prop (NOT `children`,
+ * which UISlotRenderer special-cases) — same convention as the `draw-*-layer`
+ * molecules. The React component renders `null`; it exists so the pattern
+ * pipeline registers a `draw-group` pattern and standalone pages stay
+ * inspectable. Both backends paint it: 2D as a canvas transform, 3D as a three
+ * `<group>` — with `rotation` + `animation` a nested group chain is a skeleton
+ * bone chain (rotate the shoulder group and the forearm group follows).
+ */
+
+interface DrawGroupProps extends DrawableBase {
+    type: 'draw-group';
+    /** Logical scene position; the projector maps it to pixels / world. */
+    position: ScenePos;
+    /** Uniform scale applied to the whole group. */
+    scale?: number;
+    /** Rotation in radians (painter units). */
+    rotate?: number;
+    /** Euler rotation `[x, y, z]` in radians (world axes) — per-axis joint rotation for the 3D backend; a group placed at a joint with children authored joint-local IS a bone. The 2D painter applies only the in-plane `z` component, after `rotate`. */
+    rotation?: [number, number, number];
+    /** Skeleton bone name. A named group is addressable by a `draw-mesh` `skin`
+     *  block (smooth skinning): the skinned mesh deforms with this group's
+     *  animated transform. Names resolve within the nearest enclosing
+     *  `skeleton: true` group (falling back to the canvas), so multiple
+     *  instances of one rig never collide. Distinct from `id` (the hit-test
+     *  handle). */
+    bone?: string;
+    /** Marks this group as a skeleton SCOPE: `bone` names and `skin` bindings in
+     *  its subtree resolve against each other only — one scope per rig instance. */
+    skeleton?: boolean;
+    /** Keyframe animation over the group TRANSFORM tracks (`offsetX/Y/Z` in cells, `rotateX/Y/Z` in radians, `scale`; the 2D painter also honors `opacity`) — children inherit it, so nested animated groups form a joint chain. Material tracks belong on leaf meshes. */
+    animation?: DrawMeshAnimation;
+    /** 0..1 opacity. */
+    opacity?: number;
+    /** Clip the group's items to an SVG path (`d` syntax) in world units relative to the group origin — masked reveals, meters, portraits. */
+    clip?: string;
+    /** The grouped drawables, painted through the normal dispatch. */
+    items: DrawableNode[];
+}
+
 /**
  * `draw-sprite-layer` — batch multiple sprites in one descriptor for O(layers) rendering.
  *

package/dist/providers/index.cjs

@@ -9472,6 +9472,83 @@ var init_DrawText = __esm({
     };
   }
 });
+function isAnimatedGroup(node) {
+  return Boolean(node.animation && node.animation.durationMs > 0 && node.animation.keyframes.length > 0);
+}
+function DrawGroup(props) {
+  const register = React87.useContext(DrawableRegistryContext);
+  if (register) register({ ...props, type: "draw-group" });
+  return null;
+}
+var init_DrawGroup = __esm({
+  "components/game/atoms/DrawGroup.tsx"() {
+    "use client";
+    init_registry();
+  }
+});
+function applyMeshAnimation(node, timeMs) {
+  const anim = node.animation;
+  if (!anim || !(anim.durationMs > 0) || anim.keyframes.length === 0) return null;
+  const frames = [...anim.keyframes].sort((a, b) => a.at - b.at);
+  const cycle = timeMs / anim.durationMs;
+  const t = anim.loop === false ? Math.min(cycle, 1) : cycle - Math.floor(cycle);
+  const trackValue = (key) => {
+    const defined = frames.filter((f3) => f3[key] !== void 0);
+    if (defined.length === 0) return void 0;
+    let prev;
+    let next;
+    for (const f3 of defined) {
+      if (f3.at <= t) prev = f3;
+      else if (!next) next = f3;
+    }
+    if (!prev) return defined[0][key];
+    if (!next) return prev[key];
+    const span = next.at - prev.at;
+    const k = span > 0 ? (t - prev.at) / span : 1;
+    const a = prev[key];
+    const b = next[key];
+    if (typeof a === "number" && typeof b === "number") return lerp2(a, b, k);
+    return a;
+  };
+  const num = {};
+  for (const key of NUMERIC_TRACKS2) {
+    const v = trackValue(key);
+    if (v !== void 0) num[key] = v;
+  }
+  return {
+    offset: [num.offsetX ?? 0, num.offsetY ?? 0, num.offsetZ ?? 0],
+    rotate: [num.rotateX ?? 0, num.rotateY ?? 0, num.rotateZ ?? 0],
+    scale: num.scale ?? 1,
+    opacity: num.opacity,
+    emissiveIntensity: num.emissiveIntensity,
+    color: trackValue("color"),
+    emissive: trackValue("emissive")
+  };
+}
+function DrawMesh(props) {
+  const register = React87.useContext(DrawableRegistryContext);
+  if (register) register({ ...props, type: "draw-mesh" });
+  return null;
+}
+var lerp2, NUMERIC_TRACKS2;
+var init_DrawMesh = __esm({
+  "components/game/atoms/DrawMesh.tsx"() {
+    "use client";
+    init_registry();
+    lerp2 = (a, b, k) => a + (b - a) * k;
+    NUMERIC_TRACKS2 = [
+      "offsetX",
+      "offsetY",
+      "offsetZ",
+      "rotateX",
+      "rotateY",
+      "rotateZ",
+      "scale",
+      "opacity",
+      "emissiveIntensity"
+    ];
+  }
+});
 
 // components/game/molecules/DrawSpriteLayer.tsx
 function DrawSpriteLayer(_props) {
@@ -9538,18 +9615,22 @@ function paintDrawable(painter, node, dctx) {
       if (!isValidScenePos(node.position)) break;
       if (!Array.isArray(node.items)) break;
       const p = dctx.projector.project(node.position);
+      const anim = dctx.time > 0 && isAnimatedGroup(node) ? applyMeshAnimation(node, dctx.time) : null;
+      const tw = dctx.projector.tileWidth;
       painter.save();
-      painter.translate(p.x, p.y);
-      if (node.scale !== void 0) painter.scale(node.scale, node.scale);
-      if (node.rotate !== void 0) painter.rotate(node.rotate);
-      if (node.opacity !== void 0 && node.opacity !== 1) painter.setAlpha(node.opacity);
+      painter.translate(p.x + (anim ? anim.offset[0] * tw : 0), p.y + (anim ? anim.offset[1] * tw : 0));
+      const scale = (node.scale ?? 1) * (anim?.scale ?? 1);
+      if (scale !== 1) painter.scale(scale, scale);
+      const rotate = (node.rotate ?? 0) + (node.rotation?.[2] ?? 0) + (anim?.rotate[2] ?? 0);
+      if (rotate !== 0) painter.rotate(rotate);
+      const opacity = (node.opacity ?? 1) * (anim?.opacity ?? 1);
+      if (opacity !== 1) painter.setAlpha(opacity);
       if (node.clip) {
-        const tw = dctx.projector.tileWidth;
         painter.scale(tw, tw);
         painter.clipPath(node.clip);
         painter.scale(1 / tw, 1 / tw);
       }
-      const childCtx = node.scale !== void 0 && node.scale !== 1 ? { ...dctx, groupScale: (dctx.groupScale ?? 1) * node.scale } : dctx;
+      const childCtx = scale !== 1 ? { ...dctx, groupScale: (dctx.groupScale ?? 1) * scale } : dctx;
       for (const item of node.items) paintDrawable(painter, item, childCtx);
       painter.restore();
       break;
@@ -9575,6 +9656,8 @@ var init_paintDispatch = __esm({
     init_DrawSprite();
     init_DrawShape();
     init_DrawText();
+    init_DrawGroup();
+    init_DrawMesh();
     init_DrawSpriteLayer();
     init_DrawShapeLayer();
     init_DrawTextLayer();
@@ -9821,7 +9904,8 @@ function Canvas2D({
   const miniMapHeight = gridExtent.height || 10;
   const drawableIsAnimated = (node) => {
     if (node.type === "draw-shape") return isAnimatedShape(node);
-    if (node.type === "draw-group") return Array.isArray(node.items) && node.items.some(drawableIsAnimated);
+    if (node.type === "draw-group")
+      return isAnimatedGroup(node) || Array.isArray(node.items) && node.items.some(drawableIsAnimated);
     if (node.type === "draw-shape-layer") return Array.isArray(node.items) && node.items.some(isAnimatedShape);
     return false;
   };
@@ -10163,6 +10247,7 @@ var init_Canvas2D = __esm({
     init_projector();
     init_paintDispatch();
     init_DrawShape();
+    init_DrawGroup();
     init_registry();
     init_hitTest();
     init_isometric();
@@ -39068,28 +39153,6 @@ var init_DetailPanel = __esm({
     DetailPanel.displayName = "DetailPanel";
   }
 });
-function DrawGroup(props) {
-  const register = React87.useContext(DrawableRegistryContext);
-  if (register) register({ ...props, type: "draw-group" });
-  return null;
-}
-var init_DrawGroup = __esm({
-  "components/game/atoms/DrawGroup.tsx"() {
-    "use client";
-    init_registry();
-  }
-});
-function DrawMesh(props) {
-  const register = React87.useContext(DrawableRegistryContext);
-  if (register) register({ ...props, type: "draw-mesh" });
-  return null;
-}
-var init_DrawMesh = __esm({
-  "components/game/atoms/DrawMesh.tsx"() {
-    "use client";
-    init_registry();
-  }
-});
 function extractTitle(children) {
   if (!React87__namespace.default.isValidElement(children)) return void 0;
   const props = children.props;

package/dist/providers/index.js

@@ -9398,6 +9398,83 @@ var init_DrawText = __esm({
     };
   }
 });
+function isAnimatedGroup(node) {
+  return Boolean(node.animation && node.animation.durationMs > 0 && node.animation.keyframes.length > 0);
+}
+function DrawGroup(props) {
+  const register = useContext(DrawableRegistryContext);
+  if (register) register({ ...props, type: "draw-group" });
+  return null;
+}
+var init_DrawGroup = __esm({
+  "components/game/atoms/DrawGroup.tsx"() {
+    "use client";
+    init_registry();
+  }
+});
+function applyMeshAnimation(node, timeMs) {
+  const anim = node.animation;
+  if (!anim || !(anim.durationMs > 0) || anim.keyframes.length === 0) return null;
+  const frames = [...anim.keyframes].sort((a, b) => a.at - b.at);
+  const cycle = timeMs / anim.durationMs;
+  const t = anim.loop === false ? Math.min(cycle, 1) : cycle - Math.floor(cycle);
+  const trackValue = (key) => {
+    const defined = frames.filter((f3) => f3[key] !== void 0);
+    if (defined.length === 0) return void 0;
+    let prev;
+    let next;
+    for (const f3 of defined) {
+      if (f3.at <= t) prev = f3;
+      else if (!next) next = f3;
+    }
+    if (!prev) return defined[0][key];
+    if (!next) return prev[key];
+    const span = next.at - prev.at;
+    const k = span > 0 ? (t - prev.at) / span : 1;
+    const a = prev[key];
+    const b = next[key];
+    if (typeof a === "number" && typeof b === "number") return lerp2(a, b, k);
+    return a;
+  };
+  const num = {};
+  for (const key of NUMERIC_TRACKS2) {
+    const v = trackValue(key);
+    if (v !== void 0) num[key] = v;
+  }
+  return {
+    offset: [num.offsetX ?? 0, num.offsetY ?? 0, num.offsetZ ?? 0],
+    rotate: [num.rotateX ?? 0, num.rotateY ?? 0, num.rotateZ ?? 0],
+    scale: num.scale ?? 1,
+    opacity: num.opacity,
+    emissiveIntensity: num.emissiveIntensity,
+    color: trackValue("color"),
+    emissive: trackValue("emissive")
+  };
+}
+function DrawMesh(props) {
+  const register = useContext(DrawableRegistryContext);
+  if (register) register({ ...props, type: "draw-mesh" });
+  return null;
+}
+var lerp2, NUMERIC_TRACKS2;
+var init_DrawMesh = __esm({
+  "components/game/atoms/DrawMesh.tsx"() {
+    "use client";
+    init_registry();
+    lerp2 = (a, b, k) => a + (b - a) * k;
+    NUMERIC_TRACKS2 = [
+      "offsetX",
+      "offsetY",
+      "offsetZ",
+      "rotateX",
+      "rotateY",
+      "rotateZ",
+      "scale",
+      "opacity",
+      "emissiveIntensity"
+    ];
+  }
+});
 
 // components/game/molecules/DrawSpriteLayer.tsx
 function DrawSpriteLayer(_props) {
@@ -9464,18 +9541,22 @@ function paintDrawable(painter, node, dctx) {
       if (!isValidScenePos(node.position)) break;
       if (!Array.isArray(node.items)) break;
       const p = dctx.projector.project(node.position);
+      const anim = dctx.time > 0 && isAnimatedGroup(node) ? applyMeshAnimation(node, dctx.time) : null;
+      const tw = dctx.projector.tileWidth;
       painter.save();
-      painter.translate(p.x, p.y);
-      if (node.scale !== void 0) painter.scale(node.scale, node.scale);
-      if (node.rotate !== void 0) painter.rotate(node.rotate);
-      if (node.opacity !== void 0 && node.opacity !== 1) painter.setAlpha(node.opacity);
+      painter.translate(p.x + (anim ? anim.offset[0] * tw : 0), p.y + (anim ? anim.offset[1] * tw : 0));
+      const scale = (node.scale ?? 1) * (anim?.scale ?? 1);
+      if (scale !== 1) painter.scale(scale, scale);
+      const rotate = (node.rotate ?? 0) + (node.rotation?.[2] ?? 0) + (anim?.rotate[2] ?? 0);
+      if (rotate !== 0) painter.rotate(rotate);
+      const opacity = (node.opacity ?? 1) * (anim?.opacity ?? 1);
+      if (opacity !== 1) painter.setAlpha(opacity);
       if (node.clip) {
-        const tw = dctx.projector.tileWidth;
         painter.scale(tw, tw);
         painter.clipPath(node.clip);
         painter.scale(1 / tw, 1 / tw);
       }
-      const childCtx = node.scale !== void 0 && node.scale !== 1 ? { ...dctx, groupScale: (dctx.groupScale ?? 1) * node.scale } : dctx;
+      const childCtx = scale !== 1 ? { ...dctx, groupScale: (dctx.groupScale ?? 1) * scale } : dctx;
       for (const item of node.items) paintDrawable(painter, item, childCtx);
       painter.restore();
       break;
@@ -9501,6 +9582,8 @@ var init_paintDispatch = __esm({
     init_DrawSprite();
     init_DrawShape();
     init_DrawText();
+    init_DrawGroup();
+    init_DrawMesh();
     init_DrawSpriteLayer();
     init_DrawShapeLayer();
     init_DrawTextLayer();
@@ -9747,7 +9830,8 @@ function Canvas2D({
   const miniMapHeight = gridExtent.height || 10;
   const drawableIsAnimated = (node) => {
     if (node.type === "draw-shape") return isAnimatedShape(node);
-    if (node.type === "draw-group") return Array.isArray(node.items) && node.items.some(drawableIsAnimated);
+    if (node.type === "draw-group")
+      return isAnimatedGroup(node) || Array.isArray(node.items) && node.items.some(drawableIsAnimated);
     if (node.type === "draw-shape-layer") return Array.isArray(node.items) && node.items.some(isAnimatedShape);
     return false;
   };
@@ -10089,6 +10173,7 @@ var init_Canvas2D = __esm({
     init_projector();
     init_paintDispatch();
     init_DrawShape();
+    init_DrawGroup();
     init_registry();
     init_hitTest();
     init_isometric();
@@ -38994,28 +39079,6 @@ var init_DetailPanel = __esm({
     DetailPanel.displayName = "DetailPanel";
   }
 });
-function DrawGroup(props) {
-  const register = useContext(DrawableRegistryContext);
-  if (register) register({ ...props, type: "draw-group" });
-  return null;
-}
-var init_DrawGroup = __esm({
-  "components/game/atoms/DrawGroup.tsx"() {
-    "use client";
-    init_registry();
-  }
-});
-function DrawMesh(props) {
-  const register = useContext(DrawableRegistryContext);
-  if (register) register({ ...props, type: "draw-mesh" });
-  return null;
-}
-var init_DrawMesh = __esm({
-  "components/game/atoms/DrawMesh.tsx"() {
-    "use client";
-    init_registry();
-  }
-});
 function extractTitle(children) {
   if (!React87__default.isValidElement(children)) return void 0;
   const props = children.props;