@volter/editor-threejs 0.5.147 → 0.5.149

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@volter/editor-threejs",
   "author": "Volter AI, Inc.",
-  "version": "0.5.147",
+  "version": "0.5.149",
   "publishConfig": {
     "access": "public"
   },
@@ -135,12 +135,12 @@
     "serving": "./dist-node/serving.mjs"
   },
   "dependencies": {
-    "@volter/editor-project": "0.5.147",
+    "@volter/editor-project": "0.5.149",
     "@sparkjsdev/spark": "^2.1.0",
     "three.quarks": "^0.16.0",
     "zod": "^4.3.6",
     "typescript": "5.9.3",
-    "@volter/editor-sdk": "0.5.147",
+    "@volter/editor-sdk": "0.5.149",
     "postprocessing": "6.38.3",
     "quarks.core": "0.16.0",
     "@fortawesome/free-solid-svg-icons": "^7.2.0"

package/src/kit/components/StageHost.tsx

@@ -24,6 +24,7 @@ import {
   useSyncExternalStore,
 } from 'react';
 import * as THREE from 'three';
+import { DocumentScene } from '../../render/document-scene';
 import { registerStageTransport, StageTransport } from '@volter/editor-sdk/kit/animation/stage-transport';
 import { scanClipSubjects } from '../animation/three-clips-subject';
 import { liveGestureActive, whenLiveGestureIdle } from '@volter/editor-sdk/kit/live-gesture-lock';
@@ -410,7 +411,7 @@ interface DocumentContentBinding {
 
 /** Persistent editor state. Source revisions own only their content binding. */
 class Object3DDocumentHost {
-  readonly scene = new THREE.Scene();
+  readonly scene = new DocumentScene();
   /** This document's store, optionally supplied by its owner. */
   readonly store: EditorShellStore;
   readonly cleanups: Array<() => void> = [];
@@ -1021,7 +1022,7 @@ export function Object3DDocumentViewport({
       const studioStage = studioStageRef.current;
       const hasShell = hasShellRef.current;
       const assetSubject = assetSubjectRef.current;
-      const scene = new THREE.Scene();
+      const scene = new DocumentScene();
       // The image-based light's strength is the view presentation's (its studio preset's), set
       // on the rendered scene before every draw (`syncHostScene`). The content scene keeps
       // three's default, so a document that authors its own strength still states it here.

package/src/render/document-scene.ts

@@ -0,0 +1,17 @@
+import * as THREE from 'three';
+
+/** The document's holder has no animated pose of its own. Three recomposes a
+ * Scene on every render pass and marks it dirty even when its matrix is exactly
+ * unchanged, which forces every static descendant's world matrix to be rebuilt.
+ * Preserve genuine dirty/forced updates and Three's normal child traversal;
+ * avoid creating a new dirty state solely from an unchanged holder pose. */
+export class DocumentScene extends THREE.Scene {
+  private readonly previousMatrix = new THREE.Matrix4();
+
+  override updateMatrix(): void {
+    const dirty = this.matrixWorldNeedsUpdate;
+    this.previousMatrix.copy(this.matrix);
+    super.updateMatrix();
+    if (!dirty && this.previousMatrix.equals(this.matrix)) this.matrixWorldNeedsUpdate = false;
+  }
+}