@needle-tools/engine 4.17.0-next.36dcae2 → 4.17.0-next.4989636

package/plugins/vite/treeshake.js

@@ -0,0 +1,216 @@
+import { existsSync, readFileSync, readdirSync, statSync } from 'fs';
+import path from 'path';
+import { tryLoadProjectConfig } from './config.js';
+import { needleLog } from './logging.js';
+
+/**
+ * Scans local GLB/glTF files to determine which engine components are actually used,
+ * then rewrites the engine's `codegen/register_types.ts` so that unused components
+ * are registered lazily via `TypeStore.addLazy()` instead of eagerly imported.
+ *
+ * @param {"build" | "serve"} command
+ * @param {import('../types/needleConfig').needleMeta | null | undefined} config
+ * @param {import('../types').userSettings} userSettings
+ * @returns {import('vite').Plugin | undefined}
+ */
+export function needleTreeshake(command, config, userSettings) {
+
+    if (command !== 'build') return;
+
+    // Temporarily disabled: the treeshake plugin's dynamic imports are ineffective
+    // because codegen/components.ts statically re-exports all components via the
+    // `export *` chain from needle-engine.ts. The dynamic import() calls in
+    // register_types cannot create split points for already-statically-imported modules.
+    // TODO: Find a way to also transform components.ts without breaking the public API.
+    return;
+
+    /** @type {Set<string>} component names found in local GLB/glTF files */
+    const usedComponents = new Set();
+
+    return {
+        name: 'needle:treeshake',
+        apply: 'build',
+
+        buildStart() {
+            const projectConfig = tryLoadProjectConfig();
+            const assetsDir = projectConfig?.assetsDirectory || 'assets';
+            const assetsPath = path.resolve(process.cwd(), assetsDir);
+
+            if (!existsSync(assetsPath)) {
+                needleLog('needle-treeshake', `Assets directory "${assetsPath}" not found — skipping component scanning`);
+                return;
+            }
+
+            const files = findGltfFiles(assetsPath);
+            needleLog('needle-treeshake', `Found ${files.length} GLB/glTF file(s) in "${assetsDir}"`);
+
+            for (const file of files) {
+                try {
+                    const names = extractComponentNames(file);
+                    for (const name of names) usedComponents.add(name);
+                }
+                catch (err) {
+                    needleLog('needle-treeshake', `Failed to parse "${file}": ${err.message}`, 'warn');
+                }
+            }
+
+            if (usedComponents.size > 0) {
+                needleLog('needle-treeshake', `Components used in local scenes: ${[...usedComponents].sort().join(', ')}`);
+            }
+            else {
+                needleLog('needle-treeshake', 'No components found in local scenes — all components will be loaded eagerly');
+            }
+        },
+
+        /**
+         * @param {string} src
+         * @param {string} id
+         */
+        transform(src, id) {
+            if (usedComponents.size === 0) return;
+
+            if (id.includes('engine/codegen/register_types')) {
+                return { code: rewriteRegisterTypes(src, usedComponents), map: null };
+            }
+        }
+    };
+}
+
+
+/**
+ * Recursively find all .glb and .gltf files in a directory
+ * @param {string} dir
+ * @returns {string[]}
+ */
+function findGltfFiles(dir) {
+    /** @type {string[]} */
+    const results = [];
+    try {
+        for (const entry of readdirSync(dir)) {
+            const full = path.join(dir, entry);
+            try {
+                const stat = statSync(full);
+                if (stat.isDirectory()) {
+                    results.push(...findGltfFiles(full));
+                }
+                else if (entry.endsWith('.glb') || entry.endsWith('.gltf')) {
+                    results.push(full);
+                }
+            }
+            catch { /* skip inaccessible entries */ }
+        }
+    }
+    catch { /* skip inaccessible directories */ }
+    return results;
+}
+
+
+/**
+ * Extract all NEEDLE_components names from a GLB or glTF file
+ * @param {string} filePath
+ * @returns {Set<string>}
+ */
+function extractComponentNames(filePath) {
+    /** @type {Set<string>} */
+    const names = new Set();
+
+    let json;
+    if (filePath.endsWith('.glb')) {
+        const buf = readFileSync(filePath);
+        if (buf.length < 20) return names;
+        const jsonLen = buf.readUInt32LE(12);
+        json = JSON.parse(buf.slice(20, 20 + jsonLen).toString('utf8'));
+    }
+    else {
+        json = JSON.parse(readFileSync(filePath, 'utf8'));
+    }
+
+    if (json.nodes) {
+        for (const node of json.nodes) {
+            const comps = node?.extensions?.NEEDLE_components?.builtin_components;
+            if (comps) {
+                for (const comp of comps) {
+                    if (comp?.name) names.add(comp.name);
+                }
+            }
+        }
+    }
+
+    return names;
+}
+
+
+/**
+ * Rewrite the engine's register_types.ts source:
+ * - Eager components: keep static imports + TypeStore.add()
+ * - Lazy components: per-file dynamic import() + TypeStore.addLazy()
+ *
+ * @param {string} src
+ * @param {Set<string>} usedComponents
+ * @returns {string}
+ */
+function rewriteRegisterTypes(src, usedComponents) {
+    /** @type {Map<string, { importPath: string, importLine: string }>} */
+    const importMap = new Map();
+    const importRegex = /^import\s*\{\s*(\w+)\s*\}\s*from\s*"([^"]+)"\s*;?\s*$/gm;
+    let match;
+    while ((match = importRegex.exec(src)) !== null) {
+        importMap.set(match[1], { importPath: match[2], importLine: match[0] });
+    }
+
+    /** @type {Map<string, string>} */
+    const addMap = new Map();
+    const addRegex = /TypeStore\.add\("(\w+)",\s*(\w+)\)/g;
+    while ((match = addRegex.exec(src)) !== null) {
+        addMap.set(match[1], match[2]);
+    }
+
+    /** @type {{ name: string, varName: string, importPath: string, importLine: string }[]} */
+    const eager = [];
+    /** @type {{ name: string, varName: string, importPath: string, importLine: string }[]} */
+    const lazy = [];
+
+    for (const [compName, varName] of addMap) {
+        const imp = importMap.get(varName);
+        if (!imp) continue;
+        if (usedComponents.has(compName)) {
+            eager.push({ name: compName, varName, ...imp });
+        }
+        else {
+            lazy.push({ name: compName, varName, ...imp });
+        }
+    }
+
+    needleLog('needle-treeshake', `Eager: ${eager.length} components, Lazy: ${lazy.length} components`);
+
+    const lines = [];
+    lines.push('/* eslint-disable */');
+    lines.push('import { TypeStore } from "./../engine_typestore.js"');
+    lines.push('');
+
+    const eagerPaths = new Set(eager.map(e => e.importLine));
+    lines.push('// Eagerly loaded components (used in local scenes)');
+    for (const importLine of eagerPaths) {
+        lines.push(importLine);
+    }
+
+    lines.push('');
+    lines.push('// Register types');
+    lines.push('export function initBuiltinTypes() {');
+
+    for (const e of eager) {
+        lines.push(`\tTypeStore.add("${e.name}", ${e.varName});`);
+    }
+
+    if (lazy.length > 0) {
+        lines.push('');
+        lines.push(`\t// Lazy-loaded components (${lazy.length} components, loaded on demand)`);
+        for (const comp of lazy) {
+            lines.push(`\tTypeStore.addLazy("${comp.name}", () => import("${comp.importPath}").then(m => m.${comp.varName}));`);
+        }
+    }
+
+    lines.push('}');
+
+    return lines.join('\n');
+}

package/src/engine/analytics/index.ts

@@ -3,7 +3,7 @@ import { LCP } from "./lcp.js";
 /**
  * @param args - The arguments to initialize the performance analytics with.
  */
-export module NeedleEnginePerformanceAnalytics {
+export namespace NeedleEnginePerformanceAnalytics {
     export function init(...args: Array<"lcp">) {
         if (args.includes("lcp"))
             LCP.observe();

package/src/engine/codegen/register_types.ts

@@ -161,160 +161,162 @@ import { PlayerState } from "../../engine-components-experimental/networking/Pla
 import { PresentationMode } from "../../engine-components-experimental/Presentation.js";
 
 // Register types
-TypeStore.add("AlignmentConstraint", AlignmentConstraint);
-TypeStore.add("Animation", Animation);
-TypeStore.add("Animator", Animator);
-TypeStore.add("AudioListener", AudioListener);
-TypeStore.add("AudioSource", AudioSource);
-TypeStore.add("Avatar_Brain_LookAt", Avatar_Brain_LookAt);
-TypeStore.add("Avatar_MouthShapes", Avatar_MouthShapes);
-TypeStore.add("Avatar_MustacheShake", Avatar_MustacheShake);
-TypeStore.add("AvatarBlink_Simple", AvatarBlink_Simple);
-TypeStore.add("AvatarEyeLook_Rotation", AvatarEyeLook_Rotation);
-TypeStore.add("AxesHelper", AxesHelper);
-TypeStore.add("BasicIKConstraint", BasicIKConstraint);
-TypeStore.add("BoxHelperComponent", BoxHelperComponent);
-TypeStore.add("Camera", Camera);
-TypeStore.add("CharacterController", CharacterController);
-TypeStore.add("CharacterControllerInput", CharacterControllerInput);
-TypeStore.add("SphereCollider", SphereCollider);
-TypeStore.add("BoxCollider", BoxCollider);
-TypeStore.add("MeshCollider", MeshCollider);
-TypeStore.add("CapsuleCollider", CapsuleCollider);
-TypeStore.add("ContactShadows", ContactShadows);
-TypeStore.add("LogStats", LogStats);
-TypeStore.add("DeleteBox", DeleteBox);
-TypeStore.add("Deletable", Deletable);
-TypeStore.add("DeviceFlag", DeviceFlag);
-TypeStore.add("DragControls", DragControls);
-TypeStore.add("DropListener", DropListener);
-TypeStore.add("Duplicatable", Duplicatable);
-TypeStore.add("EventListEvent", EventListEvent);
-TypeStore.add("EventTrigger", EventTrigger);
-TypeStore.add("GltfExportBox", GltfExportBox);
-TypeStore.add("GltfExport", GltfExport);
-TypeStore.add("VariantAction", VariantAction);
-TypeStore.add("ChangeTransformOnClick", ChangeTransformOnClick);
-TypeStore.add("ChangeMaterialOnClick", ChangeMaterialOnClick);
-TypeStore.add("SetActiveOnClick", SetActiveOnClick);
-TypeStore.add("HideOnStart", HideOnStart);
-TypeStore.add("EmphasizeOnClick", EmphasizeOnClick);
-TypeStore.add("PlayAudioOnClick", PlayAudioOnClick);
-TypeStore.add("PlayAnimationOnClick", PlayAnimationOnClick);
-TypeStore.add("PreliminaryAction", PreliminaryAction);
-TypeStore.add("PreliminaryTrigger", PreliminaryTrigger);
-TypeStore.add("VisibilityAction", VisibilityAction);
-TypeStore.add("TapGestureTrigger", TapGestureTrigger);
-TypeStore.add("USDZExporter", USDZExporter);
-TypeStore.add("Fog", Fog);
-TypeStore.add("BoxGizmo", BoxGizmo);
-TypeStore.add("GridHelper", GridHelper);
-TypeStore.add("GroundProjectedEnv", GroundProjectedEnv);
-TypeStore.add("UsageMarker", UsageMarker);
-TypeStore.add("Interactable", Interactable);
-TypeStore.add("FixedJoint", FixedJoint);
-TypeStore.add("HingeJoint", HingeJoint);
-TypeStore.add("Light", Light);
-TypeStore.add("LODGroup", LODGroup);
-TypeStore.add("LookAtConstraint", LookAtConstraint);
-TypeStore.add("NeedleMenu", NeedleMenu);
-TypeStore.add("NestedGltf", NestedGltf);
-TypeStore.add("Networking", Networking);
-TypeStore.add("OffsetConstraint", OffsetConstraint);
-TypeStore.add("CameraTargetReachedEvent", CameraTargetReachedEvent);
-TypeStore.add("OrbitControls", OrbitControls);
-TypeStore.add("ParticleSystemRenderer", ParticleSystemRenderer);
-TypeStore.add("ParticleSystem", ParticleSystem);
-TypeStore.add("Attractor", Attractor);
-TypeStore.add("PlayerColor", PlayerColor);
-TypeStore.add("Antialiasing", Antialiasing);
-TypeStore.add("BloomEffect", BloomEffect);
-TypeStore.add("ChromaticAberration", ChromaticAberration);
-TypeStore.add("ColorAdjustments", ColorAdjustments);
-TypeStore.add("DepthOfField", DepthOfField);
-TypeStore.add("EffectWrapper", EffectWrapper);
-TypeStore.add("PixelationEffect", PixelationEffect);
-TypeStore.add("ScreenSpaceAmbientOcclusion", ScreenSpaceAmbientOcclusion);
-TypeStore.add("ScreenSpaceAmbientOcclusionN8", ScreenSpaceAmbientOcclusionN8);
-TypeStore.add("SharpeningEffect", SharpeningEffect);
-TypeStore.add("TiltShiftEffect", TiltShiftEffect);
-TypeStore.add("ToneMappingEffect", ToneMappingEffect);
-TypeStore.add("Vignette", Vignette);
-TypeStore.add("Volume", Volume);
-TypeStore.add("ReflectionProbe", ReflectionProbe);
-TypeStore.add("Renderer", Renderer);
-TypeStore.add("MeshRenderer", MeshRenderer);
-TypeStore.add("SkinnedMeshRenderer", SkinnedMeshRenderer);
-TypeStore.add("Rigidbody", Rigidbody);
-TypeStore.add("SceneSwitcher", SceneSwitcher);
-TypeStore.add("ScreenCapture", ScreenCapture);
-TypeStore.add("SeeThrough", SeeThrough);
-TypeStore.add("ShadowCatcher", ShadowCatcher);
-TypeStore.add("RemoteSkybox", RemoteSkybox);
-TypeStore.add("SmoothFollow", SmoothFollow);
-TypeStore.add("SpatialTriggerReceiver", SpatialTriggerReceiver);
-TypeStore.add("SpatialTrigger", SpatialTrigger);
-TypeStore.add("SpectatorCamera", SpectatorCamera);
-TypeStore.add("SplineContainer", SplineContainer);
-TypeStore.add("SplineWalker", SplineWalker);
-TypeStore.add("SpriteRenderer", SpriteRenderer);
-TypeStore.add("SyncedCamera", SyncedCamera);
-TypeStore.add("SyncedRoom", SyncedRoom);
-TypeStore.add("SyncedTransform", SyncedTransform);
-TypeStore.add("TestRunner", TestRunner);
-TypeStore.add("TestSimulateUserData", TestSimulateUserData);
-TypeStore.add("PlayableDirector", PlayableDirector);
-TypeStore.add("SignalReceiver", SignalReceiver);
-TypeStore.add("AnimationTrackHandler", AnimationTrackHandler);
-TypeStore.add("AudioTrackHandler", AudioTrackHandler);
-TypeStore.add("MarkerTrackHandler", MarkerTrackHandler);
-TypeStore.add("SignalTrackHandler", SignalTrackHandler);
-TypeStore.add("ControlTrackHandler", ControlTrackHandler);
-TypeStore.add("TransformGizmo", TransformGizmo);
-TypeStore.add("BaseUIComponent", BaseUIComponent);
-TypeStore.add("UIRootComponent", UIRootComponent);
-TypeStore.add("Button", Button);
-TypeStore.add("Canvas", Canvas);
-TypeStore.add("CanvasGroup", CanvasGroup);
-TypeStore.add("EventSystem", EventSystem);
-TypeStore.add("Graphic", Graphic);
-TypeStore.add("MaskableGraphic", MaskableGraphic);
-TypeStore.add("Image", Image);
-TypeStore.add("RawImage", RawImage);
-TypeStore.add("InputField", InputField);
-TypeStore.add("VerticalLayoutGroup", VerticalLayoutGroup);
-TypeStore.add("HorizontalLayoutGroup", HorizontalLayoutGroup);
-TypeStore.add("GridLayoutGroup", GridLayoutGroup);
-TypeStore.add("Outline", Outline);
-TypeStore.add("ObjectRaycaster", ObjectRaycaster);
-TypeStore.add("GraphicRaycaster", GraphicRaycaster);
-TypeStore.add("SpatialGrabRaycaster", SpatialGrabRaycaster);
-TypeStore.add("RectTransform", RectTransform);
-TypeStore.add("SpatialHtml", SpatialHtml);
-TypeStore.add("Text", Text);
-TypeStore.add("EnvironmentScene", EnvironmentScene);
-TypeStore.add("LookAt", LookAt);
-TypeStore.add("OpenURL", OpenURL);
-TypeStore.add("VideoPlayer", VideoPlayer);
-TypeStore.add("Voip", Voip);
-TypeStore.add("ClickThrough", ClickThrough);
-TypeStore.add("CursorFollow", CursorFollow);
-TypeStore.add("HoverAnimation", HoverAnimation);
-TypeStore.add("ScrollFollow", ScrollFollow);
-TypeStore.add("ViewBox", ViewBox);
-TypeStore.add("Avatar", Avatar);
-TypeStore.add("XRControllerFollow", XRControllerFollow);
-TypeStore.add("XRControllerModel", XRControllerModel);
-TypeStore.add("XRControllerMovement", XRControllerMovement);
-TypeStore.add("TeleportTarget", TeleportTarget);
-TypeStore.add("WebARCameraBackground", WebARCameraBackground);
-TypeStore.add("WebARSessionRoot", WebARSessionRoot);
-TypeStore.add("WebXR", WebXR);
-TypeStore.add("AvatarMarker", AvatarMarker);
-TypeStore.add("WebXRImageTracking", WebXRImageTracking);
-TypeStore.add("WebXRPlaneTracking", WebXRPlaneTracking);
-TypeStore.add("XRRig", XRRig);
-TypeStore.add("XRFlag", XRFlag);
-TypeStore.add("PlayerSync", PlayerSync);
-TypeStore.add("PlayerState", PlayerState);
-TypeStore.add("PresentationMode", PresentationMode);
+export function initBuiltinTypes() {
+	TypeStore.add("AlignmentConstraint", AlignmentConstraint);
+	TypeStore.add("Animation", Animation);
+	TypeStore.add("Animator", Animator);
+	TypeStore.add("AudioListener", AudioListener);
+	TypeStore.add("AudioSource", AudioSource);
+	TypeStore.add("Avatar_Brain_LookAt", Avatar_Brain_LookAt);
+	TypeStore.add("Avatar_MouthShapes", Avatar_MouthShapes);
+	TypeStore.add("Avatar_MustacheShake", Avatar_MustacheShake);
+	TypeStore.add("AvatarBlink_Simple", AvatarBlink_Simple);
+	TypeStore.add("AvatarEyeLook_Rotation", AvatarEyeLook_Rotation);
+	TypeStore.add("AxesHelper", AxesHelper);
+	TypeStore.add("BasicIKConstraint", BasicIKConstraint);
+	TypeStore.add("BoxHelperComponent", BoxHelperComponent);
+	TypeStore.add("Camera", Camera);
+	TypeStore.add("CharacterController", CharacterController);
+	TypeStore.add("CharacterControllerInput", CharacterControllerInput);
+	TypeStore.add("SphereCollider", SphereCollider);
+	TypeStore.add("BoxCollider", BoxCollider);
+	TypeStore.add("MeshCollider", MeshCollider);
+	TypeStore.add("CapsuleCollider", CapsuleCollider);
+	TypeStore.add("ContactShadows", ContactShadows);
+	TypeStore.add("LogStats", LogStats);
+	TypeStore.add("DeleteBox", DeleteBox);
+	TypeStore.add("Deletable", Deletable);
+	TypeStore.add("DeviceFlag", DeviceFlag);
+	TypeStore.add("DragControls", DragControls);
+	TypeStore.add("DropListener", DropListener);
+	TypeStore.add("Duplicatable", Duplicatable);
+	TypeStore.add("EventListEvent", EventListEvent);
+	TypeStore.add("EventTrigger", EventTrigger);
+	TypeStore.add("GltfExportBox", GltfExportBox);
+	TypeStore.add("GltfExport", GltfExport);
+	TypeStore.add("VariantAction", VariantAction);
+	TypeStore.add("ChangeTransformOnClick", ChangeTransformOnClick);
+	TypeStore.add("ChangeMaterialOnClick", ChangeMaterialOnClick);
+	TypeStore.add("SetActiveOnClick", SetActiveOnClick);
+	TypeStore.add("HideOnStart", HideOnStart);
+	TypeStore.add("EmphasizeOnClick", EmphasizeOnClick);
+	TypeStore.add("PlayAudioOnClick", PlayAudioOnClick);
+	TypeStore.add("PlayAnimationOnClick", PlayAnimationOnClick);
+	TypeStore.add("PreliminaryAction", PreliminaryAction);
+	TypeStore.add("PreliminaryTrigger", PreliminaryTrigger);
+	TypeStore.add("VisibilityAction", VisibilityAction);
+	TypeStore.add("TapGestureTrigger", TapGestureTrigger);
+	TypeStore.add("USDZExporter", USDZExporter);
+	TypeStore.add("Fog", Fog);
+	TypeStore.add("BoxGizmo", BoxGizmo);
+	TypeStore.add("GridHelper", GridHelper);
+	TypeStore.add("GroundProjectedEnv", GroundProjectedEnv);
+	TypeStore.add("UsageMarker", UsageMarker);
+	TypeStore.add("Interactable", Interactable);
+	TypeStore.add("FixedJoint", FixedJoint);
+	TypeStore.add("HingeJoint", HingeJoint);
+	TypeStore.add("Light", Light);
+	TypeStore.add("LODGroup", LODGroup);
+	TypeStore.add("LookAtConstraint", LookAtConstraint);
+	TypeStore.add("NeedleMenu", NeedleMenu);
+	TypeStore.add("NestedGltf", NestedGltf);
+	TypeStore.add("Networking", Networking);
+	TypeStore.add("OffsetConstraint", OffsetConstraint);
+	TypeStore.add("CameraTargetReachedEvent", CameraTargetReachedEvent);
+	TypeStore.add("OrbitControls", OrbitControls);
+	TypeStore.add("ParticleSystemRenderer", ParticleSystemRenderer);
+	TypeStore.add("ParticleSystem", ParticleSystem);
+	TypeStore.add("Attractor", Attractor);
+	TypeStore.add("PlayerColor", PlayerColor);
+	TypeStore.add("Antialiasing", Antialiasing);
+	TypeStore.add("BloomEffect", BloomEffect);
+	TypeStore.add("ChromaticAberration", ChromaticAberration);
+	TypeStore.add("ColorAdjustments", ColorAdjustments);
+	TypeStore.add("DepthOfField", DepthOfField);
+	TypeStore.add("EffectWrapper", EffectWrapper);
+	TypeStore.add("PixelationEffect", PixelationEffect);
+	TypeStore.add("ScreenSpaceAmbientOcclusion", ScreenSpaceAmbientOcclusion);
+	TypeStore.add("ScreenSpaceAmbientOcclusionN8", ScreenSpaceAmbientOcclusionN8);
+	TypeStore.add("SharpeningEffect", SharpeningEffect);
+	TypeStore.add("TiltShiftEffect", TiltShiftEffect);
+	TypeStore.add("ToneMappingEffect", ToneMappingEffect);
+	TypeStore.add("Vignette", Vignette);
+	TypeStore.add("Volume", Volume);
+	TypeStore.add("ReflectionProbe", ReflectionProbe);
+	TypeStore.add("Renderer", Renderer);
+	TypeStore.add("MeshRenderer", MeshRenderer);
+	TypeStore.add("SkinnedMeshRenderer", SkinnedMeshRenderer);
+	TypeStore.add("Rigidbody", Rigidbody);
+	TypeStore.add("SceneSwitcher", SceneSwitcher);
+	TypeStore.add("ScreenCapture", ScreenCapture);
+	TypeStore.add("SeeThrough", SeeThrough);
+	TypeStore.add("ShadowCatcher", ShadowCatcher);
+	TypeStore.add("RemoteSkybox", RemoteSkybox);
+	TypeStore.add("SmoothFollow", SmoothFollow);
+	TypeStore.add("SpatialTriggerReceiver", SpatialTriggerReceiver);
+	TypeStore.add("SpatialTrigger", SpatialTrigger);
+	TypeStore.add("SpectatorCamera", SpectatorCamera);
+	TypeStore.add("SplineContainer", SplineContainer);
+	TypeStore.add("SplineWalker", SplineWalker);
+	TypeStore.add("SpriteRenderer", SpriteRenderer);
+	TypeStore.add("SyncedCamera", SyncedCamera);
+	TypeStore.add("SyncedRoom", SyncedRoom);
+	TypeStore.add("SyncedTransform", SyncedTransform);
+	TypeStore.add("TestRunner", TestRunner);
+	TypeStore.add("TestSimulateUserData", TestSimulateUserData);
+	TypeStore.add("PlayableDirector", PlayableDirector);
+	TypeStore.add("SignalReceiver", SignalReceiver);
+	TypeStore.add("AnimationTrackHandler", AnimationTrackHandler);
+	TypeStore.add("AudioTrackHandler", AudioTrackHandler);
+	TypeStore.add("MarkerTrackHandler", MarkerTrackHandler);
+	TypeStore.add("SignalTrackHandler", SignalTrackHandler);
+	TypeStore.add("ControlTrackHandler", ControlTrackHandler);
+	TypeStore.add("TransformGizmo", TransformGizmo);
+	TypeStore.add("BaseUIComponent", BaseUIComponent);
+	TypeStore.add("UIRootComponent", UIRootComponent);
+	TypeStore.add("Button", Button);
+	TypeStore.add("Canvas", Canvas);
+	TypeStore.add("CanvasGroup", CanvasGroup);
+	TypeStore.add("EventSystem", EventSystem);
+	TypeStore.add("Graphic", Graphic);
+	TypeStore.add("MaskableGraphic", MaskableGraphic);
+	TypeStore.add("Image", Image);
+	TypeStore.add("RawImage", RawImage);
+	TypeStore.add("InputField", InputField);
+	TypeStore.add("VerticalLayoutGroup", VerticalLayoutGroup);
+	TypeStore.add("HorizontalLayoutGroup", HorizontalLayoutGroup);
+	TypeStore.add("GridLayoutGroup", GridLayoutGroup);
+	TypeStore.add("Outline", Outline);
+	TypeStore.add("ObjectRaycaster", ObjectRaycaster);
+	TypeStore.add("GraphicRaycaster", GraphicRaycaster);
+	TypeStore.add("SpatialGrabRaycaster", SpatialGrabRaycaster);
+	TypeStore.add("RectTransform", RectTransform);
+	TypeStore.add("SpatialHtml", SpatialHtml);
+	TypeStore.add("Text", Text);
+	TypeStore.add("EnvironmentScene", EnvironmentScene);
+	TypeStore.add("LookAt", LookAt);
+	TypeStore.add("OpenURL", OpenURL);
+	TypeStore.add("VideoPlayer", VideoPlayer);
+	TypeStore.add("Voip", Voip);
+	TypeStore.add("ClickThrough", ClickThrough);
+	TypeStore.add("CursorFollow", CursorFollow);
+	TypeStore.add("HoverAnimation", HoverAnimation);
+	TypeStore.add("ScrollFollow", ScrollFollow);
+	TypeStore.add("ViewBox", ViewBox);
+	TypeStore.add("Avatar", Avatar);
+	TypeStore.add("XRControllerFollow", XRControllerFollow);
+	TypeStore.add("XRControllerModel", XRControllerModel);
+	TypeStore.add("XRControllerMovement", XRControllerMovement);
+	TypeStore.add("TeleportTarget", TeleportTarget);
+	TypeStore.add("WebARCameraBackground", WebARCameraBackground);
+	TypeStore.add("WebARSessionRoot", WebARSessionRoot);
+	TypeStore.add("WebXR", WebXR);
+	TypeStore.add("AvatarMarker", AvatarMarker);
+	TypeStore.add("WebXRImageTracking", WebXRImageTracking);
+	TypeStore.add("WebXRPlaneTracking", WebXRPlaneTracking);
+	TypeStore.add("XRRig", XRRig);
+	TypeStore.add("XRFlag", XRFlag);
+	TypeStore.add("PlayerSync", PlayerSync);
+	TypeStore.add("PlayerState", PlayerState);
+	TypeStore.add("PresentationMode", PresentationMode);
+}

package/src/engine/debug/debug.ts

@@ -1,5 +1,3 @@
-import { isLocalNetwork } from "../engine_networking_utils.js";
-import { getParam } from "../engine_utils.js";
 import { addLog, BalloonOptions, clearMessages, LogType, setAllowBalloonMessages, setAllowOverlayMessages } from "./debug_overlay.js";
 
 export {
@@ -11,10 +9,9 @@ export {
     // eslint-disable-next-line @typescript-eslint/no-deprecated
     setAllowOverlayMessages,
 };
+export { isDevEnvironment, setDevEnvironment } from "./debug_environment.js";
 export { enableSpatialConsole } from "./debug_spatial_console.js";
 
-const noDevLogs = getParam("nodevlogs");
-
 
 /** Displays a debug message on screen for a certain amount of time */
 export function showBalloonMessage(text: string, options?: Partial<BalloonOptions>): void {
@@ -28,26 +25,4 @@ export function showBalloonWarning(text: string, options?: Partial<BalloonOption
 /** Displays an error message on screen for a certain amount of time */
 export function showBalloonError(text: string, options?: Partial<BalloonOptions>): void {
     showBalloonMessage(text, { ...options, type: LogType.Error });
-}
-
-let _manuallySetDevEnvironment: boolean | undefined;
-let _cachedDevEnvironment: boolean | undefined;
-
-/** True when the application runs on a local url */
-export function isDevEnvironment(): boolean {
-    if (noDevLogs) return false;
-    if (_manuallySetDevEnvironment !== undefined) return _manuallySetDevEnvironment;
-    if (_cachedDevEnvironment !== undefined) return _cachedDevEnvironment;
-
-    let res = isLocalNetwork();
-    if (!res) {
-        // is stackblitz?
-        res = window.location.hostname.endsWith(".local-credentialless.webcontainer.io");
-    }
-    _cachedDevEnvironment = res;
-    return res;
-}
-/** Enforce the dev environment flag to be true or false */
-export function setDevEnvironment(val: boolean): void {
-    _manuallySetDevEnvironment = val;
 }

package/src/engine/debug/debug_environment.ts

@@ -0,0 +1,26 @@
+import { isLocalNetwork } from "../engine_networking_utils.js";
+import { getParam } from "../engine_utils.js";
+
+const noDevLogs = getParam("nodevlogs");
+
+let _manuallySetDevEnvironment: boolean | undefined;
+let _cachedDevEnvironment: boolean | undefined;
+
+/** True when the application runs on a local url */
+export function isDevEnvironment(): boolean {
+    if (noDevLogs) return false;
+    if (_manuallySetDevEnvironment !== undefined) return _manuallySetDevEnvironment;
+    if (_cachedDevEnvironment !== undefined) return _cachedDevEnvironment;
+
+    let res = isLocalNetwork();
+    if (!res) {
+        // is stackblitz?
+        res = window.location.hostname.endsWith(".local-credentialless.webcontainer.io");
+    }
+    _cachedDevEnvironment = res;
+    return res;
+}
+/** Enforce the dev environment flag to be true or false */
+export function setDevEnvironment(val: boolean): void {
+    _manuallySetDevEnvironment = val;
+}

package/src/engine/debug/debug_overlay.ts

@@ -245,8 +245,9 @@ export function clearMessages() {
 }
 
 
+// @import is OK here — the debug overlay is only created on errors, so this doesn't
+// add to normal page load. Keep in sync with font-urls.js if the URL changes.
 const logsContainerStyles = `
-
 @import url('https://fonts.googleapis.com/css2?family=Roboto+Flex:opsz,wght@8..144,100..1000&display=swap');
 
 div[data-needle_engine_debug_overlay] {

package/src/engine/debug/debug_spatial_console.ts

@@ -6,7 +6,7 @@ import { ContextRegistry } from "../engine_context_registry.js";
 import { OneEuroFilterXYZ } from "../engine_math.js";
 import { lookAtObject } from "../engine_three_utils.js";
 import type { IContext, IGameObject } from "../engine_types.js";
-import { isDevEnvironment } from "./debug.js";
+import { isDevEnvironment } from "./debug_environment.js";
 import { onError } from "./debug_overlay.js";