@umicat/three-sdk 0.17.0 → 0.17.1

package/dist/editor/EditorDesignPlayer3D.js

@@ -21,6 +21,7 @@ import { loadScene3D } from '../SceneLoader3D.js';
  * real game.
  */
 export async function runEditorDesignPlayer3D(renderer, opts = {}) {
+    hideNonCanvasStaticMarkup(renderer.domElement);
     const camera = new THREE.PerspectiveCamera(50, window.innerWidth / window.innerHeight, 0.05, 2000);
     const controls = new OrbitControls(camera, renderer.domElement);
     controls.enableDamping = true;
@@ -126,3 +127,42 @@ export async function runEditorDesignPlayer3D(renderer, opts = {}) {
         window.parent.postMessage({ type: 'umicat:editor:scene3dLoaded', sceneId, error: true }, '*');
     }
 }
+/**
+ * Hides every other top-level DOM node the game shipped, keeping only the
+ * canvas. Mirrors `@umicat/phaser-sdk`'s edit-mode markup hider (`UmicatGame.ts`)
+ * exactly, including its `data-umicat-keep` opt-out — same bug, same fix,
+ * different renderer.
+ *
+ * Two distinct problems, one cause: `index.html` markup has no owner in edit
+ * mode, because none of the game's own code runs to manage it. A static score
+ * HUD just clutters a scene that's supposed to read as empty of gameplay. A
+ * game with its own full-screen input-capturing overlay (a drawing surface
+ * that "the whole screen collects strokes" is a real, shipped example) is
+ * worse: that overlay sits ABOVE the canvas and silently swallows every
+ * pointer event meant for OrbitControls — confirmed live, orbit/zoom did
+ * nothing at all until this ran, with zero console errors, because the events
+ * simply never reached the renderer's own `domElement`.
+ */
+function hideNonCanvasStaticMarkup(canvas) {
+    if (typeof document === 'undefined' || !document.body)
+        return;
+    const hidden = [];
+    for (const el of Array.from(document.body.children)) {
+        if (!(el instanceof HTMLElement))
+            continue;
+        const tag = el.tagName;
+        if (tag === 'SCRIPT' || tag === 'STYLE' || tag === 'LINK' || tag === 'NOSCRIPT')
+            continue;
+        if (el === canvas)
+            continue;
+        if (el.hasAttribute('data-umicat-keep'))
+            continue; // opt OUT, for markup that IS design-time content
+        if (el.style.display === 'none')
+            continue;
+        el.style.display = 'none';
+        hidden.push(el.id ? `#${el.id}` : tag.toLowerCase());
+    }
+    if (hidden.length > 0) {
+        console.info(`[umicat/editor] hid ${hidden.join(', ')} — index.html markup with no game code running to remove it. Add data-umicat-keep to keep one visible in Edit.`);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umicat/three-sdk",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "description": "Three.js runtime for Umicat games: the scene3d design format, its loader with physics, a kinematic character controller, and the Umicat platform via @umicat/platform-sdk.",
   "type": "module",
   "main": "dist/index.js",