lecodes-cli 0.16.2 → 0.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lecodes-cli",
-  "version": "0.16.2",
+  "version": "0.17.0",
   "dependencies": {
     "@letary/chisel": "^0.8.0",
     "jimp": "^1.6.1"
@@ -11,11 +11,12 @@
     "qrcode-terminal": "^0.12.0",
     "lecodes-3d-editor": "workspace:*",
     "lecodes-assets": "workspace:*",
-    "sdk": "workspace:*"
+    "sdk": "workspace:*",
+    "viewer-lite": "workspace:*"
   },
   "peerDependencies": {
     "lecodes-design": "^0.8.1",
-    "lecodes-renderer": "^0.8.4",
+    "lecodes-renderer": "^0.8.5",
     "lecodes-3d-editor": "^0.3.0",
     "lecodes-assets": "^0.1.0"
   },

package/runtime/sdk/gl/Animator.ts

@@ -394,7 +394,8 @@ export class Animator extends Aspect<"animator", Node> {
   /** Default crossfade seconds for play()/stop(). */
   fade = 0.2
   /** Root motion: strip the root bone's horizontal travel from the pose and move the NODE with it
-   *  instead (or drive its CharacterController when it has one) — for clips whose hips actually travel
+   *  instead (or drive its CharacterController — on this node or an ancestor — when it has one; the
+   *  vertical part stays on the bone, so a jump's height is the clip's) — for clips whose hips actually travel
    *  (Mixamo without "In Place", lunges, rolls). `true` = auto-detect the root bone (the shallowest bone
    *  a clip translates), or a bone name. Read at attach. */
   rootMotion?: boolean | string
@@ -528,8 +529,15 @@ export class Animator extends Aspect<"animator", Node> {
     if (this.rootMotion) this._applyRootMotion(dt)
   }
 
+  /** The CharacterController root motion feeds: on this node, or on the nearest ANCESTOR — the usual
+   *  rig is a capsule node holding Shape + CharacterController with the model parented under it,
+   *  shifted down so its feet sit at the capsule's bottom (the controller centers the shape on its node). */
   private _controller(): CharacterController | undefined {
-    return (this.node as unknown as { controller?: CharacterController }).controller
+    for (let n: Node | null = this.node; n; n = n.parent) {
+      const c = (n as unknown as { controller?: CharacterController }).controller
+      if (c) return c
+    }
+    return undefined
   }
 
   /** Root motion (last native frame's delta, node-local, horizontal): move the node, or feed the

package/runtime/sdk/gl/Node.ts

@@ -13,6 +13,7 @@ import { Mat4, type Mat4Like } from "../math/mat4"
 import type { Geometry } from "./Geometry"
 import { registerTouchEndEvent, registerTouchStartEvent } from "./touch"
 import { ensurePhysicsEvents } from "./physicsEvents"
+import { glState } from "./state"
 import type { ClickEvent, TouchStartEvent } from "../runtime/touch"
 
 /** id → Node, so host callbacks (touch hits, animation events) route back to the owning object. */
@@ -45,6 +46,7 @@ export class Node extends AspectHost<NodeEvents> {
 
   private _matrix?: Float32Array
   private _lastSync = 0
+  private _syncFrame = -1
   private _worldMatrix?: Float32Array
   private _scaleCache?: [number, number, number]
   private _boneCache?: Map<string, Node | null>
@@ -74,10 +76,13 @@ export class Node extends AspectHost<NodeEvents> {
   // hot path that returns the cache directly for cheap component reads.
   private _sync(): Float32Array {
     if (!this._matrix) this._matrix = new Float32Array(16)
-    if (this._lastSync === 0 || Date.now() - this._lastSync > 10) {
+    // stale once per render frame (glState.frame — physics/controllers/animation rewrite transforms
+    // between frames), or after 10 ms of wall time when no scene loop is running
+    if (this._lastSync === 0 || this._syncFrame !== glState.frame || Date.now() - this._lastSync > 10) {
       _creator.getMatrix(this.id, this._matrix)
       this._scaleCache = undefined
       this._lastSync = Date.now()
+      this._syncFrame = glState.frame
     }
     return this._matrix
   }