@preference-sl/pref-viewer 2.10.0-beta.20 → 2.10.0-beta.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@preference-sl/pref-viewer",
-  "version": "2.10.0-beta.20",
+  "version": "2.10.0-beta.22",
   "description": "Web Component to preview GLTF models with Babylon.js",
   "author": "Alex Moreno Palacio <amoreno@preference.es>",
   "scripts": {

package/src/index.js

@@ -131,11 +131,13 @@ class PrefViewer extends HTMLElement {
 
     constructor() {
         super();
+        console.log("PrefViewer: constructor()");
         this.attachShadow({ mode: "open" });
         this.#createCanvas();
         this.#wrapCanvas();
         // Point to whichever version you packaged or want to use:
         const DRACO_BASE = "https://www.gstatic.com/draco/versioned/decoders/1.5.7";
+        console.log("PrefViewer: DRACO config base =", DRACO_BASE);
         DracoCompression.Configuration.decoder = {
             // loader for the “wrapper” that pulls in the real WASM
             wasmUrl: `${DRACO_BASE}/draco_wasm_wrapper_gltf.js`,
@@ -151,6 +153,7 @@ class PrefViewer extends HTMLElement {
     }
 
     attributeChangedCallback(name, _old, value) {
+        console.log("PrefViewer: attributeChangedCallback()", { name, old: _old, value });
         let data = null;
         switch (name) {
             case "config":
@@ -165,6 +168,7 @@ class PrefViewer extends HTMLElement {
             case "show-model":
                 data = value.toLowerCase?.() === "true";
                 if (this.initialized) {
+                    console.log("PrefViewer: toggling model visibility (attr)", data);
                     data ? this.showModel() : this.hideModel();
                 } else {
                     this.#data.containers.model.show = data;
@@ -173,6 +177,7 @@ class PrefViewer extends HTMLElement {
             case "show-scene":
                 data = value.toLowerCase?.() === "true";
                 if (this.initialized) {
+                    console.log("PrefViewer: toggling scene visibility (attr)", data);
                     data ? this.showScene() : this.hideScene();
                 } else {
                     this.#data.containers.environment.show = data;
@@ -182,6 +187,7 @@ class PrefViewer extends HTMLElement {
     }
 
     connectedCallback() {
+        console.log("PrefViewer: connectedCallback()");
         if (!this.hasAttribute("config")) {
             const error = 'PrefViewer: provide "models" as array of model and environment';
             console.error(error);
@@ -198,16 +204,19 @@ class PrefViewer extends HTMLElement {
 
         this.#initializeBabylon();
         this.initialized = true;
+        console.log("PrefViewer: initialized = true, loading containers…");
         this.#loadContainers(true, true, true);
     }
 
     disconnectedCallback() {
+        console.log("PrefViewer: disconnectedCallback()");
         this.#disposeEngine();
         this.#canvasResizeObserver.disconnect();
     }
 
     // Web Component
     #createCanvas() {
+        console.log("PrefViewer: #createCanvas()");
         this.#canvas = document.createElement("canvas");
         Object.assign(this.#canvas.style, {
             width: "100%",
@@ -218,6 +227,7 @@ class PrefViewer extends HTMLElement {
     }
 
     #wrapCanvas() {
+        console.log("PrefViewer: #wrapCanvas()");
         this.#wrapper = document.createElement("div");
         Object.assign(this.#wrapper.style, {
             width: "100%",
@@ -229,6 +239,7 @@ class PrefViewer extends HTMLElement {
     }
 
     #setStatusSceneLoading() {
+        console.log("PrefViewer: #setStatusSceneLoading()");
         this.loaded = false;
         this.loading = true;
         if (this.hasAttribute("loaded")) {
@@ -245,6 +256,7 @@ class PrefViewer extends HTMLElement {
     }
 
     #setStatusSceneLoaded() {
+        console.log("PrefViewer: #setStatusSceneLoaded()");
         this.loaded = true;
         this.loading = false;
 
@@ -286,9 +298,11 @@ class PrefViewer extends HTMLElement {
                 detail: detail,
             })
         );
+        console.log("PrefViewer: scene-loaded detail =", detail);
     }
 
     #setStatusOptionsLoading() {
+        console.log("PrefViewer: #setStatusOptionsLoading()");
         this.dispatchEvent(
             new CustomEvent("options-loading", {
                 bubbles: true,
@@ -299,6 +313,7 @@ class PrefViewer extends HTMLElement {
     }
 
     #setStatusOptionsLoaded() {
+        console.log("PrefViewer: #setStatusOptionsLoaded()");
         const toLoadDetail = {
             innerWallMaterial: !!this.#data.options.materials.innerWall.changed,
             outerWallMaterial: !!this.#data.options.materials.outerWall.changed,
@@ -325,6 +340,7 @@ class PrefViewer extends HTMLElement {
                 detail: detail,
             })
         );
+        console.log("PrefViewer: options-loaded detail =", detail);
     }
 
     // Data
@@ -332,8 +348,8 @@ class PrefViewer extends HTMLElement {
         if (!options || !options.camera) {
             return false;
         }
-
         const changed = options.camera !== this.#data.options.camera.value;
+        console.log("PrefViewer: #checkCameraChanged()", { incoming: options.camera, previous: this.#data.options.camera.value, changed });
         this.#data.options.camera.changed = changed ? { oldValue: this.#data.options.camera.value, oldLocked: this.#data.options.camera.locked, success: false } : false;
         if (changed) this.#data.options.camera.value = options.camera;
 
@@ -348,6 +364,7 @@ class PrefViewer extends HTMLElement {
         Object.keys(this.#data.options.materials).forEach((material) => {
             const key = `${material}Material`;
             const materialChanged = options[key] && options[key] !== this.#data.options.materials[material].value ? true : false;
+            console.log("PrefViewer: #checkMaterialsChanged()", { key, incoming: options[key], previous: this.#data.options.materials[material].value, materialChanged });
             this.#data.options.materials[material].changed = materialChanged ? { oldValue: this.#data.options.materials[material].value, success: false } : false;
             this.#data.options.materials[material].value = materialChanged ? options[key] : this.#data.options.materials[material].value;
             someChanged = someChanged || this.#data.options.materials[material].changed;
@@ -356,12 +373,14 @@ class PrefViewer extends HTMLElement {
     }
 
     #storeChangedFlagsForContainer(container) {
+        console.log("PrefViewer: #storeChangedFlagsForContainer()", { name: container.name, changed: container.changed });
         container.timeStamp = container.changed.timeStamp;
         container.size = container.changed.size;
         container.changed.success = true;
     }
 
     #resetChangedFlags() {
+        console.log("PrefViewer: #resetChangedFlags()");
         Object.values(this.#data.containers).forEach((container) => (container.changed = false));
         Object.values(this.#data.options.materials).forEach((material) => (material.changed = false));
         this.#data.options.camera.changed = false;
@@ -369,22 +388,30 @@ class PrefViewer extends HTMLElement {
 
     // Babylon.js
     async #initializeBabylon() {
+        console.log("PrefViewer: #initializeBabylon() START");
         this.#engine = new Engine(this.#canvas, true, { alpha: true });
         this.#engine.disableUniformBuffers = true; // <- evita el límite de GL_MAX_*_UNIFORM_BUFFERS  // PROVISIONAL, YA QUE ESTO ES UN POCO OVERKILL
+        console.log("PrefViewer: Engine created", { disableUBO: this.#engine.disableUniformBuffers });
 
         this.#scene = new Scene(this.#engine);
         this.#scene.clearColor = new Color4(1, 1, 1, 1);
+        console.log("PrefViewer: Scene created, clearColor set to white");
+
         this.#createCamera();
         this.#createLights();
         this.#setupInteraction();
 
         this.#engine.runRenderLoop(() => this.#scene && this.#scene.render());
+        console.log("PrefViewer: runRenderLoop started");
         this.#canvasResizeObserver.observe(this.#canvas);
+        console.log("PrefViewer: ResizeObserver attached");
 
         await this.#createXRExperience();
+        console.log("PrefViewer: #initializeBabylon() END");
     }
 
     addStylesToARButton() {
+        console.log("PrefViewer: addStylesToARButton()");
         const css = '.babylonVRicon { color: #868686; border-color: #868686; border-style: solid; margin-left: 10px; height: 50px; width: 80px; background-color: rgba(51,51,51,0.7); background-image: url(data:image/svg+xml;charset=UTF-8,%3Csvg%20xmlns%3D%22http%3A//www.w3.org/2000/svg%22%20width%3D%222048%22%20height%3D%221152%22%20viewBox%3D%220%200%202048%201152%22%20version%3D%221.1%22%3E%3Cpath%20transform%3D%22rotate%28180%201024%2C576.0000000000001%29%22%20d%3D%22m1109%2C896q17%2C0%2030%2C-12t13%2C-30t-12.5%2C-30.5t-30.5%2C-12.5l-170%2C0q-18%2C0%20-30.5%2C12.5t-12.5%2C30.5t13%2C30t30%2C12l170%2C0zm-85%2C256q59%2C0%20132.5%2C-1.5t154.5%2C-5.5t164.5%2C-11.5t163%2C-20t150%2C-30t124.5%2C-41.5q23%2C-11%2042%2C-24t38%2C-30q27%2C-25%2041%2C-61.5t14%2C-72.5l0%2C-257q0%2C-123%20-47%2C-232t-128%2C-190t-190%2C-128t-232%2C-47l-81%2C0q-37%2C0%20-68.5%2C14t-60.5%2C34.5t-55.5%2C45t-53%2C45t-53%2C34.5t-55.5%2C14t-55.5%2C-14t-53%2C-34.5t-53%2C-45t-55.5%2C-45t-60.5%2C-34.5t-68.5%2C-14l-81%2C0q-123%2C0%20-232%2C47t-190%2C128t-128%2C190t-47%2C232l0%2C257q0%2C68%2038%2C115t97%2C73q54%2C24%20124.5%2C41.5t150%2C30t163%2C20t164.5%2C11.5t154.5%2C5.5t132.5%2C1.5zm939%2C-298q0%2C39%20-24.5%2C67t-58.5%2C42q-54%2C23%20-122%2C39.5t-143.5%2C28t-155.5%2C19t-157%2C11t-148.5%2C5t-129.5%2C1.5q-59%2C0%20-130%2C-1.5t-148%2C-5t-157%2C-11t-155.5%2C-19t-143.5%2C-28t-122%2C-39.5q-34%2C-14%20-58.5%2C-42t-24.5%2C-67l0%2C-257q0%2C-106%2040.5%2C-199t110%2C-162.5t162.5%2C-109.5t199%2C-40l81%2C0q27%2C0%2052%2C14t50%2C34.5t51%2C44.5t55.5%2C44.5t63.5%2C34.5t74%2C14t74%2C-14t63.5%2C-34.5t55.5%2C-44.5t51%2C-44.5t50%2C-34.5t52%2C-14l14%2C0q37%2C0%2070%2C0.5t64.5%2C4.5t63.5%2C12t68%2C23q71%2C30%20128.5%2C78.5t98.5%2C110t63.5%2C133.5t22.5%2C149l0%2C257z%22%20fill%3D%22white%22%20/%3E%3C/svg%3E%0A); background-size: 80%; background-repeat:no-repeat; background-position: center; border: none; outline: none; transition: transform 0.125s ease-out } .babylonVRicon:hover { transform: scale(1.05) } .babylonVRicon:active {background-color: rgba(51,51,51,1) } .babylonVRicon:focus {background-color: rgba(51,51,51,1) }.babylonVRicon.vrdisplaypresenting { background-image: none;} .vrdisplaypresenting::after { content: "EXIT"} .xr-error::after { content: "ERROR"}';
         const style = document.createElement("style");
         style.appendChild(document.createTextNode(css));
@@ -392,12 +419,15 @@ class PrefViewer extends HTMLElement {
     }
 
     async #createXRExperience() {
+        console.log("PrefViewer: #createXRExperience() START");
         if (this.#XRExperience) {
+            console.log("PrefViewer: XR already exists, skipping.");
             return true;
         }
 
         const sessionMode = "immersive-ar";
         const sessionSupported = await WebXRSessionManager.IsSessionSupportedAsync(sessionMode);
+        console.log("PrefViewer: WebXR session supported =", sessionSupported);
         if (!sessionSupported) {
             console.info("PrefViewer: WebXR in mode AR is not supported");
             return false;
@@ -418,6 +448,7 @@ class PrefViewer extends HTMLElement {
             };
 
             this.#XRExperience = await WebXRDefaultExperience.CreateAsync(this.#scene, options);
+            console.log("PrefViewer: XR experience created");
 
             const featuresManager = this.#XRExperience.baseExperience.featuresManager;
             featuresManager.enableFeature(WebXRFeatureName.TELEPORTATION, "stable", {
@@ -427,6 +458,7 @@ class PrefViewer extends HTMLElement {
             });
 
             this.#XRExperience.baseExperience.sessionManager.onXRReady.add(() => {
+                console.log("PrefViewer: onXRReady - syncing camera pose");
                 // Set the initial position of xrCamera: use nonVRCamera, which contains a copy of the original this.#scene.activeCamera before entering XR
                 this.#XRExperience.baseExperience.camera.setTransformationFromNonVRCamera(this.#XRExperience.baseExperience._nonVRCamera);
                 this.#XRExperience.baseExperience.camera.setTarget(Vector3.Zero());
@@ -438,11 +470,13 @@ class PrefViewer extends HTMLElement {
             console.warn("PrefViewer: failed to create WebXR experience", error);
             this.#XRExperience = null;
         }
+        console.log("PrefViewer: #createXRExperience() END");
     }
 
     #canvasResizeObserver = new ResizeObserver(() => this.#engine && this.#engine.resize());
 
     #createCamera() {
+        console.log("PrefViewer: #createCamera()");
         this.#camera = new ArcRotateCamera("camera", (3 * Math.PI) / 2, Math.PI * 0.47, 10, Vector3.Zero(), this.#scene);
         this.#camera.upperBetaLimit = Math.PI * 0.48;
         this.#camera.lowerBetaLimit = Math.PI * 0.25;
@@ -451,9 +485,16 @@ class PrefViewer extends HTMLElement {
         this.#camera.metadata = { locked: false }
         this.#camera.attachControl(this.#canvas, true);
         this.#scene.activeCamera = this.#camera;
+        console.log("PrefViewer: camera configured", {
+            upperBetaLimit: this.#camera.upperBetaLimit,
+            lowerBetaLimit: this.#camera.lowerBetaLimit,
+            lowerRadiusLimit: this.#camera.lowerRadiusLimit,
+            upperRadiusLimit: this.#camera.upperRadiusLimit
+        });
     }
 
     #createLights() {
+        console.log("PrefViewer: #createLights()");
         // 1) Stronger ambient fill
         this.#hemiLight = new HemisphericLight("hemiLight", new Vector3(-10, 10, -10), this.#scene);
         this.#hemiLight.intensity = 0.6;
@@ -473,15 +514,21 @@ class PrefViewer extends HTMLElement {
         this.#cameraLight = new PointLight("pl", this.#camera.position, this.#scene);
         this.#cameraLight.parent = this.#camera;
         this.#cameraLight.intensity = 0.3;
+
+        console.log("PrefViewer: lights created", {
+            hemiIntensity: this.#hemiLight.intensity,
+            dirIntensity: this.#dirLight.intensity,
+            shadowMapSize: 1024,
+            pointIntensity: this.#cameraLight.intensity
+        });
     }
 
     #setupInteraction() {
+        console.log("PrefViewer: #setupInteraction()");
         this.#canvas.addEventListener("wheel", (event) => {
             if (!this.#scene || !this.#camera) {
                 return false;
             }
-            //const pick = this.#scene.pick(this.#scene.pointerX, this.#scene.pointerY);
-            //this.#camera.target = pick.hit ? pick.pickedPoint.clone() : this.#camera.target;
             if (!this.#scene.activeCamera.metadata?.locked) {
                 this.#scene.activeCamera.inertialRadiusOffset -= event.deltaY * this.#scene.activeCamera.wheelPrecision * 0.001;
             }
@@ -490,6 +537,7 @@ class PrefViewer extends HTMLElement {
     }
 
     #disposeEngine() {
+        console.log("PrefViewer: #disposeEngine()");
         if (!this.#engine) return;
         this.#shadowGen?.dispose();
         this.#scene?.lights?.slice().forEach(l => l.dispose());
@@ -501,6 +549,7 @@ class PrefViewer extends HTMLElement {
 
     // Utility methods for loading gltf/glb
     async #getServerFileDataHeader(uri) {
+        console.log("PrefViewer: #getServerFileDataHeader()", uri);
         return new Promise((resolve) => {
             const xhr = new XMLHttpRequest();
             xhr.open("HEAD", uri, true);
@@ -509,12 +558,15 @@ class PrefViewer extends HTMLElement {
                 if (xhr.status === 200) {
                     const size = parseInt(xhr.getResponseHeader("Content-Length"));
                     const timeStamp = new Date(xhr.getResponseHeader("Last-Modified")).toISOString();
+                    console.log("PrefViewer: HEAD ok", { size, timeStamp });
                     resolve([size, timeStamp]);
                 } else {
+                    console.warn("PrefViewer: HEAD failed", xhr.status);
                     resolve([0, null]);
                 }
             };
             xhr.onerror = () => {
+                console.warn("PrefViewer: HEAD network error");
                 resolve([0, null]);
             };
             xhr.send();
@@ -523,11 +575,14 @@ class PrefViewer extends HTMLElement {
 
     #transformUrl(url) {
         return new Promise((resolve) => {
-            resolve(url.replace(/^blob:[^/]+\//i, "").replace(/\\/g, "/"));
+            const transformed = url.replace(/^blob:[^/]+\//i, "").replace(/\\/g, "/");
+            console.log("PrefViewer: #transformUrl()", { in: url, out: transformed });
+            resolve(transformed);
         });
     }
 
     #decodeBase64(base64) {
+        console.log("PrefViewer: #decodeBase64() START");
         const [, payload] = base64.split(",");
         const raw = payload || base64;
         let decoded = "";
@@ -537,6 +592,7 @@ class PrefViewer extends HTMLElement {
         try {
             decoded = atob(raw);
         } catch {
+            console.warn("PrefViewer: base64 decode failed (not base64?)");
             return { blob, extension, size };
         }
         let isJson = false;
@@ -548,33 +604,43 @@ class PrefViewer extends HTMLElement {
         const type = isJson ? "model/gltf+json" : "model/gltf-binary";
         const array = Uint8Array.from(decoded, (c) => c.charCodeAt(0));
         blob = new Blob([array], { type });
+        console.log("PrefViewer: #decodeBase64() END", { extension, size, type });
         return { blob, extension, size };
     }
 
     async #initStorage(db, table) {
+        console.log("PrefViewer: #initStorage()", { db, table });
         if (window.gltfDB && window.gltfDB.name === db && window.gltfDB.objectStoreNames.contains(table)) {
+            console.log("PrefViewer: existing DB connection reused");
             return true;
         }
         await initDb(db, table);
+        console.log("PrefViewer: DB initialized");
     }
 
     // Methods for managing Asset Containers
     #setVisibilityOfWallAndFloorInModel(show) {
+        console.log("PrefViewer: #setVisibilityOfWallAndFloorInModel()", { incomingShow: show });
         if (!this.#data.containers.model.assetContainer || !this.#data.containers.model.visible) {
+            console.log("PrefViewer: no model assetContainer or not visible, skip visibility set");
             return false;
         }
         show = show !== undefined ? show : this.#data.containers.environment.visible;
         const prefixes = Object.values(this.#data.options.materials).map((material) => material.prefix);
+        console.log("PrefViewer: toggling meshes with prefixes", prefixes, "->", show);
         this.#data.containers.model.assetContainer.meshes.filter((meshToFilter) => prefixes.some((prefix) => meshToFilter.name.startsWith(prefix))).forEach((mesh) => mesh.setEnabled(show));
     }
 
     #setOptionsMaterial(optionMaterial) {
+        console.log("PrefViewer: #setOptionsMaterial()", { optionMaterial });
         if (!optionMaterial || !optionMaterial.prefix || !optionMaterial.value) {
+            console.log("PrefViewer: optionMaterial incomplete, skipping");
             return false;
         }
 
         const material = this.#data.containers.materials.assetContainer?.materials.find((mat) => mat.name === optionMaterial.value) || null;
         if (!material) {
+            console.warn("PrefViewer: material not found", optionMaterial.value);
             return false;
         }
 
@@ -586,6 +652,7 @@ class PrefViewer extends HTMLElement {
             containers.push(this.#data.containers.environment.assetContainer);
         }
         if (containers.length === 0) {
+            console.log("PrefViewer: no containers require material update");
             return false;
         }
 
@@ -599,6 +666,8 @@ class PrefViewer extends HTMLElement {
                 })
         );
 
+        console.log("PrefViewer: material assignment result", { prefix: optionMaterial.prefix, material: optionMaterial.value, someSetted });
+
         if (someSetted) {
             optionMaterial.changed.success = true;
         } else {
@@ -609,15 +678,23 @@ class PrefViewer extends HTMLElement {
     }
 
     #setOptionsMaterials() {
+        console.log("PrefViewer: #setOptionsMaterials() START");
         let someSetted = false;
         Object.values(this.#data.options.materials).forEach((material) => {
             let settedMaterial = this.#setOptionsMaterial(material);
             someSetted = someSetted || settedMaterial;
         });
+        console.log("PrefViewer: #setOptionsMaterials() END", { someSetted });
         return someSetted;
     }
 
     #setOptionsCamera() {
+        console.log("PrefViewer: #setOptionsCamera()", {
+            requested: this.#data.options.camera.value,
+            changed: this.#data.options.camera.changed,
+            modelChanged: this.#data.containers.model.changed,
+            envChanged: this.#data.containers.environment.changed
+        });
         if (!this.#data.options.camera.value || (!this.#data.options.camera.changed && !this.#data.containers.model.changed && !this.#data.containers.environment.changed)) {
             return false;
         }
@@ -644,29 +721,36 @@ class PrefViewer extends HTMLElement {
             camera.attachControl(this.#canvas, true);
         }
         this.#scene.activeCamera = camera;
+        console.log("PrefViewer: active camera set", { name: camera.name, locked: camera.metadata?.locked });
         return true;
     }
 
     #addContainer(container) {
+        console.log("PrefViewer: #addContainer()", { name: container.name, hasContainer: !!container.assetContainer, visible: container.visible, show: container.show });
         if (container.assetContainer && !container.visible && container.show) {
             container.assetContainer.addAllToScene();
             container.visible = true;
+            console.log("PrefViewer: container added to scene", container.name);
         }
     }
 
     #removeContainer(container) {
+        console.log("PrefViewer: #removeContainer()", { name: container.name, hasContainer: !!container.assetContainer, visible: container.visible });
         if (container.assetContainer && container.visible) {
             container.assetContainer.removeAllFromScene();
             container.visible = false;
+            console.log("PrefViewer: container removed from scene", container.name);
         }
     }
 
     #replaceContainer(container, newAssetContainer) {
+        console.log("PrefViewer: #replaceContainer()", { name: container.name, hadContainer: !!container.assetContainer });
         // 1) quita y destruye el anterior si existía
         const old = container.assetContainer;
         if (old) {
             if (container.visible) { old.removeAllFromScene(); }
             old.dispose(); // <- importante
+            console.log("PrefViewer: old container disposed", container.name);
         }
 
         // 2) asigna el nuevo y prepara
@@ -690,12 +774,15 @@ class PrefViewer extends HTMLElement {
 
         // 5) fuerza recompilación con defines correctos del nuevo estado
         this.#scene.getEngine().releaseEffects();
+        console.log("PrefViewer: container replaced and effects released", container.name);
     }
 
     async #loadAssetContainer(container) {
+        console.log("PrefViewer: #loadAssetContainer() START", { name: container?.name, storage: container?.storage });
         let storage = container?.storage;
 
         if (!storage) {
+            console.log("PrefViewer: no storage, skipping", container?.name);
             return false;
         }
 
@@ -706,13 +793,16 @@ class PrefViewer extends HTMLElement {
             const object = await loadModel(storage.id, storage.table);
             source = object.data;
             if (object.timeStamp === container.timeStamp) {
+                console.log("PrefViewer: DB entry unchanged, skipping", container.name);
                 return false;
             } else {
                 container.changed = { timeStamp: object.timeStamp, size: object.size, success: false };
+                console.log("PrefViewer: DB entry changed", container.changed);
             }
         }
 
         if (!source) {
+            console.log("PrefViewer: no source after storage resolution", container.name);
             return false;
         }
 
@@ -725,19 +815,23 @@ class PrefViewer extends HTMLElement {
             });
             if (!container.changed) {
                 if (container.timeStamp === null && container.size === size) {
+                    console.log("PrefViewer: same base64 size and null timestamp, skipping", container.name);
                     return false;
                 } else {
                     container.changed = { timeStamp: null, size: size, success: false };
                 }
             }
+            console.log("PrefViewer: prepared File from base64", { name: file.name, size: file.size, type: file.type });
         } else {
             const extMatch = source.match(/\.(gltf|glb)(\?|#|$)/i);
             extension = extMatch ? `.${extMatch[1].toLowerCase()}` : ".gltf";
             const [fileSize, fileTimeStamp] = await this.#getServerFileDataHeader(source);
             if (container.size === fileSize && container.timeStamp === fileTimeStamp) {
+                console.log("PrefViewer: remote file unchanged, skipping", container.name);
                 return false;
             } else {
                 container.changed = { timeStamp: fileTimeStamp, size: fileSize, success: false };
+                console.log("PrefViewer: remote file changed", container.changed);
             }
         }
 
@@ -751,10 +845,12 @@ class PrefViewer extends HTMLElement {
             },
         };
 
+        console.log("PrefViewer: calling LoadAssetContainerAsync()", { extension });
         return LoadAssetContainerAsync(file || source, this.#scene, options);
     }
 
     async #loadContainers(loadModel = true, loadEnvironment = true, loadMaterials = true) {
+        console.log("PrefViewer: #loadContainers()", { loadModel, loadEnvironment, loadMaterials });
         const promiseArray = [];
         promiseArray.push(loadModel ? this.#loadAssetContainer(this.#data.containers.model) : false);
         promiseArray.push(loadEnvironment ? this.#loadAssetContainer(this.#data.containers.environment) : false);
@@ -764,27 +860,33 @@ class PrefViewer extends HTMLElement {
 
         Promise.allSettled(promiseArray)
             .then(async (values) => {
+                console.log("PrefViewer: Promise.allSettled results", values);
                 const modelContainer = values[0];
                 const environmentContainer = values[1];
                 const materialsContainer = values[2];
 
                 if (modelContainer.status === "fulfilled" && modelContainer.value) {
+                    console.log("PrefViewer: model container fulfilled, applying");
                     this.#stripImportedLights(modelContainer.value);
                     this.#replaceContainer(this.#data.containers.model, modelContainer.value);
                     this.#storeChangedFlagsForContainer(this.#data.containers.model);
                 } else {
+                    console.log("PrefViewer: model container not fulfilled or unchanged; ensuring visibility state");
                     this.#data.containers.model.show ? this.#addContainer(this.#data.containers.model) : this.#removeContainer(this.#data.containers.model);
                 }
 
                 if (environmentContainer.status === "fulfilled" && environmentContainer.value) {
+                    console.log("PrefViewer: environment container fulfilled, applying");
                     this.#stripImportedLights(environmentContainer.value);
                     this.#replaceContainer(this.#data.containers.environment, environmentContainer.value);
                     this.#storeChangedFlagsForContainer(this.#data.containers.environment);
                 } else {
+                    console.log("PrefViewer: environment container not fulfilled or unchanged; ensuring visibility state");
                     this.#data.containers.environment.show ? this.#addContainer(this.#data.containers.environment) : this.#removeContainer(this.#data.containers.environment);
                 }
 
                 if (materialsContainer.status === "fulfilled" && materialsContainer.value) {
+                    console.log("PrefViewer: materials container fulfilled, applying");
                     this.#stripImportedLights(materialsContainer.value);
                     this.#replaceContainer(this.#data.containers.materials, materialsContainer.value);
                     this.#storeChangedFlagsForContainer(this.#data.containers.materials);
@@ -811,17 +913,21 @@ class PrefViewer extends HTMLElement {
     }
 
     #stripImportedLights(container) {
+        console.log("PrefViewer: #stripImportedLights()", { lights: container?.lights?.length || 0 });
         // El glTF puede traer KHR_lights_punctual: bórralas antes de añadir a la escena
         if (container?.lights?.length) {
             // Clonar para no mutar mientras iteras
             container.lights.slice().forEach(l => l.dispose());
+            console.log("PrefViewer: stripped punctual lights from imported asset");
         }
     }
 
     // Public Methods
     loadConfig(config) {
+        console.log("PrefViewer: loadConfig()", config);
         config = typeof config === "string" ? JSON.parse(config) : config;
         if (!config) {
+            console.warn("PrefViewer: loadConfig() no config provided");
             return false;
         }
 
@@ -842,6 +948,7 @@ class PrefViewer extends HTMLElement {
     }
 
     setOptions(options) {
+        console.log("PrefViewer: setOptions()", options);
         if (!options) {
             return false;
         }
@@ -863,8 +970,10 @@ class PrefViewer extends HTMLElement {
     }
 
     loadModel(model) {
+        console.log("PrefViewer: loadModel()", model);
         model = typeof model === "string" ? JSON.parse(model) : model;
         if (!model) {
+            console.warn("PrefViewer: loadModel() no model provided");
             return false;
         }
         this.#data.containers.model.storage = model.storage || null;
@@ -873,8 +982,10 @@ class PrefViewer extends HTMLElement {
     }
 
     loadScene(scene) {
+        console.log("PrefViewer: loadScene()", scene);
         scene = typeof scene === "string" ? JSON.parse(scene) : scene;
         if (!scene) {
+            console.warn("PrefViewer: loadScene() no scene provided");
             return false;
         }
         this.#data.containers.environment.storage = scene.storage || null;
@@ -883,33 +994,39 @@ class PrefViewer extends HTMLElement {
     }
 
     showModel() {
+        console.log("PrefViewer: showModel()");
         this.#data.containers.model.show = true;
         this.#addContainer(this.#data.containers.model);
     }
 
     hideModel() {
+        console.log("PrefViewer: hideModel()");
         this.#data.containers.model.show = false;
         this.#removeContainer(this.#data.containers.model);
     }
 
     showScene() {
+        console.log("PrefViewer: showScene()");
         this.#data.containers.environment.show = true;
         this.#addContainer(this.#data.containers.environment);
         this.#setVisibilityOfWallAndFloorInModel();
     }
 
     hideScene() {
+        console.log("PrefViewer: hideScene()");
         this.#data.containers.environment.show = false;
         this.#removeContainer(this.#data.containers.environment);
         this.#setVisibilityOfWallAndFloorInModel();
     }
 
     downloadModelGLB() {
+        console.log("PrefViewer: downloadModelGLB()");
         const fileName = "model";
         GLTF2Export.GLBAsync(this.#data.containers.model.assetContainer, fileName, { exportWithoutWaitingForScene: true }).then((glb) => glb.downloadFiles());
     }
 
     downloadModelUSDZ() {
+        console.log("PrefViewer: downloadModelUSDZ()");
         const fileName = "model";
         USDZExportAsync(this.#data.containers.model.assetContainer).then((response) => {
             if (response) {
@@ -919,6 +1036,7 @@ class PrefViewer extends HTMLElement {
     }
 
     downloadModelAndSceneUSDZ() {
+        console.log("PrefViewer: downloadModelAndSceneUSDZ()");
         const fileName = "scene";
         USDZExportAsync(this.#scene).then((response) => {
             if (response) {
@@ -928,6 +1046,7 @@ class PrefViewer extends HTMLElement {
     }
 
     downloadModelAndSceneGLB() {
+        console.log("PrefViewer: downloadModelAndSceneGLB()");
         const fileName = "scene";
         GLTF2Export.GLBAsync(this.#scene, fileName, { exportWithoutWaitingForScene: true }).then((glb) => glb.downloadFiles());
     }