cesiumjs-anywidget 0.4.0__py3-none-any.whl → 0.6.0__py3-none-any.whl

cesiumjs_anywidget/index.js

@@ -1,18 +1,49 @@
 // Generated bundle - DO NOT EDIT DIRECTLY. Edit files in src/cesiumjs_anywidget/js/ instead.
 
 
+// src/cesiumjs_anywidget/js/logger.js
+var debugEnabled = false;
+function setDebugMode(enabled) {
+  debugEnabled = enabled;
+  if (enabled) {
+    console.log("[CesiumWidget] Debug mode enabled");
+  }
+}
+function log(prefix, ...args) {
+  if (debugEnabled) {
+    console.log(`[CesiumWidget:${prefix}]`, ...args);
+  }
+}
+function warn(prefix, ...args) {
+  console.warn(`[CesiumWidget:${prefix}]`, ...args);
+}
+function error(prefix, ...args) {
+  console.error(`[CesiumWidget:${prefix}]`, ...args);
+}
+
 // src/cesiumjs_anywidget/js/viewer-init.js
+var PREFIX = "ViewerInit";
 async function loadCesiumJS() {
+  log(PREFIX, "Loading CesiumJS...");
   if (window.Cesium) {
+    log(PREFIX, "CesiumJS already loaded, reusing existing instance");
     return window.Cesium;
   }
   const script = document.createElement("script");
   script.src = "https://cesium.com/downloads/cesiumjs/releases/1.135/Build/Cesium/Cesium.js";
+  log(PREFIX, "Loading CesiumJS from CDN...");
   await new Promise((resolve, reject) => {
-    script.onload = resolve;
-    script.onerror = reject;
+    script.onload = () => {
+      log(PREFIX, "CesiumJS script loaded successfully");
+      resolve();
+    };
+    script.onerror = (err) => {
+      error(PREFIX, "Failed to load CesiumJS script:", err);
+      reject(err);
+    };
     document.head.appendChild(script);
   });
+  log(PREFIX, "CesiumJS initialized");
   return window.Cesium;
 }
 function createLoadingIndicator(container, hasToken) {
@@ -34,6 +65,7 @@ function createLoadingIndicator(container, hasToken) {
   return loadingDiv;
 }
 function createViewer(container, model, Cesium) {
+  log(PREFIX, "Creating viewer with options...");
   const viewerOptions = {
     timeline: model.get("show_timeline"),
     animation: model.get("show_animation"),
@@ -47,17 +79,28 @@ function createViewer(container, model, Cesium) {
     shadows: false,
     shouldAnimate: false
   };
+  log(PREFIX, "Viewer options:", viewerOptions);
   if (model.get("enable_terrain")) {
     viewerOptions.terrain = Cesium.Terrain.fromWorldTerrain();
+    log(PREFIX, "Terrain enabled");
   }
   const viewer = new Cesium.Viewer(container, viewerOptions);
   viewer.scene.globe.enableLighting = model.get("enable_lighting");
+  log(PREFIX, "Viewer created, lighting:", model.get("enable_lighting"));
   return viewer;
 }
 function setupViewerListeners(viewer, model, container, Cesium) {
+  log(PREFIX, "Setting up viewer listeners");
+  let isDestroyed = false;
+  let scrubTimeout = null;
   model.on("change:enable_terrain", () => {
+    if (isDestroyed) {
+      log(PREFIX, "Skipping enable_terrain change - destroyed");
+      return;
+    }
     if (!viewer)
       return;
+    log(PREFIX, "Terrain setting changed:", model.get("enable_terrain"));
     if (model.get("enable_terrain")) {
       viewer.scene.setTerrain(Cesium.Terrain.fromWorldTerrain());
     } else {
@@ -65,32 +108,47 @@ function setupViewerListeners(viewer, model, container, Cesium) {
     }
   });
   model.on("change:enable_lighting", () => {
+    if (isDestroyed)
+      return;
     if (!viewer)
       return;
+    log(PREFIX, "Lighting setting changed:", model.get("enable_lighting"));
     viewer.scene.globe.enableLighting = model.get("enable_lighting");
   });
   model.on("change:height", () => {
+    if (isDestroyed)
+      return;
     if (!viewer)
       return;
+    log(PREFIX, "Height changed:", model.get("height"));
     container.style.height = model.get("height");
     viewer.resize();
   });
   model.on("change:show_timeline", () => {
+    if (isDestroyed)
+      return;
     if (!viewer || !viewer.timeline)
       return;
+    log(PREFIX, "Timeline visibility changed:", model.get("show_timeline"));
     viewer.timeline.container.style.visibility = model.get("show_timeline") ? "visible" : "hidden";
   });
   model.on("change:show_animation", () => {
+    if (isDestroyed)
+      return;
     if (!viewer || !viewer.animation)
       return;
+    log(PREFIX, "Animation visibility changed:", model.get("show_animation"));
     viewer.animation.container.style.visibility = model.get("show_animation") ? "visible" : "hidden";
   });
   model.on("change:atmosphere_settings", () => {
+    if (isDestroyed)
+      return;
     if (!viewer || !viewer.scene || !viewer.scene.atmosphere)
       return;
     const settings = model.get("atmosphere_settings");
     if (!settings || Object.keys(settings).length === 0)
       return;
+    log(PREFIX, "Atmosphere settings changed:", settings);
     const atmosphere = viewer.scene.atmosphere;
     if (settings.brightnessShift !== void 0) {
       atmosphere.brightnessShift = settings.brightnessShift;
@@ -129,11 +187,14 @@ function setupViewerListeners(viewer, model, container, Cesium) {
     }
   });
   model.on("change:sky_atmosphere_settings", () => {
+    if (isDestroyed)
+      return;
     if (!viewer || !viewer.scene || !viewer.scene.skyAtmosphere)
       return;
     const settings = model.get("sky_atmosphere_settings");
     if (!settings || Object.keys(settings).length === 0)
       return;
+    log(PREFIX, "Sky atmosphere settings changed:", settings);
     const skyAtmosphere = viewer.scene.skyAtmosphere;
     if (settings.show !== void 0) {
       skyAtmosphere.show = settings.show;
@@ -178,11 +239,14 @@ function setupViewerListeners(viewer, model, container, Cesium) {
     }
   });
   model.on("change:skybox_settings", () => {
+    if (isDestroyed)
+      return;
     if (!viewer || !viewer.scene || !viewer.scene.skyBox)
       return;
     const settings = model.get("skybox_settings");
     if (!settings || Object.keys(settings).length === 0)
       return;
+    log(PREFIX, "SkyBox settings changed:", settings);
     const skyBox = viewer.scene.skyBox;
     if (settings.show !== void 0) {
       skyBox.show = settings.show;
@@ -207,104 +271,155 @@ function setupViewerListeners(viewer, model, container, Cesium) {
     }
   });
   function getCameraState() {
-    const cartographic = viewer.camera.positionCartographic;
-    return {
-      latitude: Cesium.Math.toDegrees(cartographic.latitude),
-      longitude: Cesium.Math.toDegrees(cartographic.longitude),
-      altitude: cartographic.height,
-      heading: Cesium.Math.toDegrees(viewer.camera.heading),
-      pitch: Cesium.Math.toDegrees(viewer.camera.pitch),
-      roll: Cesium.Math.toDegrees(viewer.camera.roll)
-    };
+    if (!viewer || !viewer.camera || !viewer.camera.positionCartographic) {
+      warn(PREFIX, "Cannot get camera state - viewer or camera not available");
+      return null;
+    }
+    try {
+      const cartographic = viewer.camera.positionCartographic;
+      return {
+        latitude: Cesium.Math.toDegrees(cartographic.latitude),
+        longitude: Cesium.Math.toDegrees(cartographic.longitude),
+        altitude: cartographic.height,
+        heading: Cesium.Math.toDegrees(viewer.camera.heading),
+        pitch: Cesium.Math.toDegrees(viewer.camera.pitch),
+        roll: Cesium.Math.toDegrees(viewer.camera.roll)
+      };
+    } catch (error2) {
+      warn(PREFIX, "Error getting camera state:", error2);
+      return null;
+    }
   }
   function getClockState() {
-    if (!viewer.clock)
+    if (!viewer || !viewer.clock)
       return null;
-    return {
-      current_time: Cesium.JulianDate.toIso8601(viewer.clock.currentTime),
-      multiplier: viewer.clock.multiplier,
-      is_animating: viewer.clock.shouldAnimate
-    };
+    try {
+      return {
+        current_time: Cesium.JulianDate.toIso8601(viewer.clock.currentTime),
+        multiplier: viewer.clock.multiplier,
+        is_animating: viewer.clock.shouldAnimate
+      };
+    } catch (error2) {
+      warn(PREFIX, "Error getting clock state:", error2);
+      return null;
+    }
   }
   function sendInteractionEvent(type, additionalData = {}) {
+    if (isDestroyed) {
+      log(PREFIX, "Skipping interaction event - destroyed:", type);
+      return;
+    }
+    if (!viewer) {
+      warn(PREFIX, "Cannot send interaction event - viewer not available");
+      return;
+    }
+    const cameraState = getCameraState();
+    if (!cameraState) {
+      warn(PREFIX, "Skipping interaction event - camera state not available");
+      return;
+    }
     const event = {
       type,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      camera: getCameraState(),
+      camera: cameraState,
       clock: getClockState(),
       ...additionalData
     };
-    console.log("[CesiumWidget] Interaction event:", type, event);
+    log(PREFIX, "Interaction event:", type, event);
     model.set("interaction_event", event);
     model.save_changes();
   }
   const camera = viewer.camera;
   camera.moveEnd.addEventListener(() => {
+    if (isDestroyed || !viewer)
+      return;
     sendInteractionEvent("camera_move");
   });
   const scene = viewer.scene;
   const handler = new Cesium.ScreenSpaceEventHandler(scene.canvas);
   handler.setInputAction((click) => {
+    if (isDestroyed || !viewer || !viewer.scene || !viewer.camera)
+      return;
     const pickedData = {};
-    const ray = viewer.camera.getPickRay(click.position);
-    const cartesian = viewer.scene.globe.pick(ray, viewer.scene);
-    if (cartesian) {
-      const cartographic = Cesium.Cartographic.fromCartesian(cartesian);
-      pickedData.picked_position = {
-        latitude: Cesium.Math.toDegrees(cartographic.latitude),
-        longitude: Cesium.Math.toDegrees(cartographic.longitude),
-        altitude: cartographic.height
-      };
+    try {
+      const ray = viewer.camera.getPickRay(click.position);
+      if (ray && viewer.scene.globe) {
+        const cartesian = viewer.scene.globe.pick(ray, viewer.scene);
+        if (cartesian) {
+          const cartographic = Cesium.Cartographic.fromCartesian(cartesian);
+          pickedData.picked_position = {
+            latitude: Cesium.Math.toDegrees(cartographic.latitude),
+            longitude: Cesium.Math.toDegrees(cartographic.longitude),
+            altitude: cartographic.height
+          };
+        }
+      }
+    } catch (error2) {
+      warn(PREFIX, "Error picking position:", error2);
     }
-    const pickedObject = viewer.scene.pick(click.position);
-    if (Cesium.defined(pickedObject) && Cesium.defined(pickedObject.id)) {
-      const entity = pickedObject.id;
-      pickedData.picked_entity = {
-        id: entity.id,
-        name: entity.name || null
-      };
-      if (entity.properties) {
-        const props = {};
-        const propertyNames = entity.properties.propertyNames;
-        if (propertyNames && propertyNames.length > 0) {
-          propertyNames.forEach((name) => {
-            try {
-              props[name] = entity.properties[name].getValue(viewer.clock.currentTime);
-            } catch (e) {
+    try {
+      const pickedObject = viewer.scene.pick(click.position);
+      if (Cesium.defined(pickedObject) && Cesium.defined(pickedObject.id)) {
+        const entity = pickedObject.id;
+        pickedData.picked_entity = {
+          id: entity.id,
+          name: entity.name || null
+        };
+        if (entity.properties) {
+          const props = {};
+          const propertyNames = entity.properties.propertyNames;
+          if (propertyNames && propertyNames.length > 0) {
+            propertyNames.forEach((name) => {
+              try {
+                props[name] = entity.properties[name].getValue(viewer.clock.currentTime);
+              } catch (e) {
+              }
+            });
+            if (Object.keys(props).length > 0) {
+              pickedData.picked_entity.properties = props;
             }
-          });
-          if (Object.keys(props).length > 0) {
-            pickedData.picked_entity.properties = props;
           }
         }
       }
+    } catch (error2) {
+      warn(PREFIX, "Error picking entity:", error2);
     }
     sendInteractionEvent("left_click", pickedData);
   }, Cesium.ScreenSpaceEventType.LEFT_CLICK);
   handler.setInputAction((click) => {
+    if (isDestroyed || !viewer || !viewer.scene || !viewer.camera)
+      return;
     const pickedData = {};
-    const ray = viewer.camera.getPickRay(click.position);
-    const cartesian = viewer.scene.globe.pick(ray, viewer.scene);
-    if (cartesian) {
-      const cartographic = Cesium.Cartographic.fromCartesian(cartesian);
-      pickedData.picked_position = {
-        latitude: Cesium.Math.toDegrees(cartographic.latitude),
-        longitude: Cesium.Math.toDegrees(cartographic.longitude),
-        altitude: cartographic.height
-      };
+    try {
+      const ray = viewer.camera.getPickRay(click.position);
+      if (ray && viewer.scene.globe) {
+        const cartesian = viewer.scene.globe.pick(ray, viewer.scene);
+        if (cartesian) {
+          const cartographic = Cesium.Cartographic.fromCartesian(cartesian);
+          pickedData.picked_position = {
+            latitude: Cesium.Math.toDegrees(cartographic.latitude),
+            longitude: Cesium.Math.toDegrees(cartographic.longitude),
+            altitude: cartographic.height
+          };
+        }
+      }
+    } catch (error2) {
+      warn(PREFIX, "Error picking position:", error2);
     }
     sendInteractionEvent("right_click", pickedData);
   }, Cesium.ScreenSpaceEventType.RIGHT_CLICK);
   if (viewer.timeline) {
     let timelineScrubbing = false;
-    let scrubTimeout = null;
     viewer.clock.onTick.addEventListener(() => {
+      if (isDestroyed)
+        return;
       if (viewer.timeline) {
         if (scrubTimeout) {
           clearTimeout(scrubTimeout);
+          scrubTimeout = null;
         }
         scrubTimeout = setTimeout(() => {
-          if (timelineScrubbing) {
+          if (!isDestroyed && timelineScrubbing) {
             timelineScrubbing = false;
             sendInteractionEvent("timeline_scrub");
           }
@@ -313,13 +428,23 @@ function setupViewerListeners(viewer, model, container, Cesium) {
       }
     });
   }
+  log(PREFIX, "Viewer listeners setup complete");
 }
 function setupGeoJSONLoader(viewer, model, Cesium) {
+  log(PREFIX, "Setting up GeoJSON loader");
   let geojsonDataSources = [];
-  model.on("change:geojson_data", async () => {
-    if (!viewer || !viewer.dataSources)
+  let isDestroyed = false;
+  async function loadGeoJSONData(flyToData = true) {
+    if (isDestroyed) {
+      log(PREFIX, "Skipping geojson_data load - destroyed");
+      return;
+    }
+    if (!viewer || !viewer.dataSources) {
+      warn(PREFIX, "Cannot load GeoJSON - viewer or dataSources not available");
       return;
+    }
     const geojsonDataArray = model.get("geojson_data");
+    log(PREFIX, "Loading GeoJSON data, count:", geojsonDataArray?.length || 0);
     geojsonDataSources.forEach((dataSource) => {
       if (viewer && viewer.dataSources) {
         viewer.dataSources.remove(dataSource);
@@ -329,6 +454,7 @@ function setupGeoJSONLoader(viewer, model, Cesium) {
     if (geojsonDataArray && Array.isArray(geojsonDataArray)) {
       for (const geojsonData of geojsonDataArray) {
         try {
+          log(PREFIX, "Loading GeoJSON dataset...");
           const dataSource = await Cesium.GeoJsonDataSource.load(geojsonData, {
             stroke: Cesium.Color.HOTPINK,
             fill: Cesium.Color.PINK.withAlpha(0.5),
@@ -337,18 +463,28 @@ function setupGeoJSONLoader(viewer, model, Cesium) {
           if (viewer && viewer.dataSources) {
             viewer.dataSources.add(dataSource);
             geojsonDataSources.push(dataSource);
+            log(PREFIX, "GeoJSON dataset loaded successfully");
           }
-        } catch (error) {
-          console.error("Error loading GeoJSON:", error);
+        } catch (error2) {
+          error2(PREFIX, "Error loading GeoJSON:", error2);
         }
       }
-      if (geojsonDataSources.length > 0 && viewer && viewer.flyTo) {
+      if (flyToData && geojsonDataSources.length > 0 && viewer && viewer.flyTo) {
+        log(PREFIX, "Flying to GeoJSON data");
         viewer.flyTo(geojsonDataSources[0]);
       }
     }
-  });
+  }
+  model.on("change:geojson_data", () => loadGeoJSONData(true));
+  const initialData = model.get("geojson_data");
+  if (initialData && Array.isArray(initialData) && initialData.length > 0) {
+    log(PREFIX, "Loading initial GeoJSON data...");
+    loadGeoJSONData(true);
+  }
   return {
     destroy: () => {
+      log(PREFIX, "Destroying GeoJSON loader");
+      isDestroyed = true;
       geojsonDataSources.forEach((dataSource) => {
         if (viewer) {
           viewer.dataSources.remove(dataSource);
@@ -359,11 +495,20 @@ function setupGeoJSONLoader(viewer, model, Cesium) {
   };
 }
 function setupCZMLLoader(viewer, model, Cesium) {
+  log(PREFIX, "Setting up CZML loader");
   let czmlDataSources = [];
-  model.on("change:czml_data", async () => {
-    if (!viewer || !viewer.dataSources)
+  let isDestroyed = false;
+  async function loadCZMLData(flyToData = true) {
+    if (isDestroyed) {
+      log(PREFIX, "Skipping czml_data load - destroyed");
       return;
+    }
+    if (!viewer || !viewer.dataSources) {
+      warn(PREFIX, "Cannot load CZML - viewer or dataSources not available");
+      return;
+    }
     const czmlDataArray = model.get("czml_data");
+    log(PREFIX, "Loading CZML data, count:", czmlDataArray?.length || 0);
     czmlDataSources.forEach((dataSource) => {
       if (viewer && viewer.dataSources) {
         viewer.dataSources.remove(dataSource);
@@ -374,23 +519,36 @@ function setupCZMLLoader(viewer, model, Cesium) {
       for (const czmlData of czmlDataArray) {
         if (Array.isArray(czmlData) && czmlData.length > 0) {
           try {
+            log(PREFIX, "Loading CZML document with", czmlData.length, "packets...");
             const dataSource = await Cesium.CzmlDataSource.load(czmlData);
             if (viewer && viewer.dataSources) {
               viewer.dataSources.add(dataSource);
               czmlDataSources.push(dataSource);
+              log(PREFIX, "CZML document loaded successfully, entities:", dataSource.entities.values.length);
             }
-          } catch (error) {
-            console.error("Error loading CZML:", error);
+          } catch (error2) {
+            error2(PREFIX, "Error loading CZML:", error2);
           }
+        } else {
+          warn(PREFIX, "Skipping invalid CZML data (not an array or empty):", czmlData);
         }
       }
-      if (czmlDataSources.length > 0 && viewer && viewer.flyTo) {
+      if (flyToData && czmlDataSources.length > 0 && viewer && viewer.flyTo) {
+        log(PREFIX, "Flying to CZML data");
         viewer.flyTo(czmlDataSources[0]);
       }
     }
-  });
+  }
+  model.on("change:czml_data", () => loadCZMLData(true));
+  const initialData = model.get("czml_data");
+  if (initialData && Array.isArray(initialData) && initialData.length > 0) {
+    log(PREFIX, "Loading initial CZML data...");
+    loadCZMLData(true);
+  }
   return {
     destroy: () => {
+      log(PREFIX, "Destroying CZML loader");
+      isDestroyed = true;
       czmlDataSources.forEach((dataSource) => {
         if (viewer) {
           viewer.dataSources.remove(dataSource);
@@ -402,30 +560,60 @@ function setupCZMLLoader(viewer, model, Cesium) {
 }
 
 // src/cesiumjs_anywidget/js/camera-sync.js
+var PREFIX2 = "CameraSync";
 function initializeCameraSync(viewer, model) {
   const Cesium = window.Cesium;
-  let cameraUpdateTimeout;
+  let cameraUpdateTimeout = null;
+  let isDestroyed = false;
+  let syncEnabled = model.get("camera_sync_enabled") || false;
+  log(PREFIX2, "Initializing camera synchronization, sync enabled:", syncEnabled);
+  model.on("change:camera_sync_enabled", () => {
+    syncEnabled = model.get("camera_sync_enabled");
+    log(PREFIX2, "Camera sync enabled changed:", syncEnabled);
+  });
   function updateCameraFromModel() {
-    if (!viewer)
+    if (isDestroyed) {
+      log(PREFIX2, "Skipping updateCameraFromModel - module destroyed");
+      return;
+    }
+    if (!viewer) {
+      warn(PREFIX2, "updateCameraFromModel called but viewer is null");
       return;
+    }
     const lat = model.get("latitude");
     const lon = model.get("longitude");
     const alt = model.get("altitude");
     const heading = Cesium.Math.toRadians(model.get("heading"));
     const pitch = Cesium.Math.toRadians(model.get("pitch"));
     const roll = Cesium.Math.toRadians(model.get("roll"));
+    log(PREFIX2, "Updating camera from model:", { lat, lon, alt });
     viewer.camera.setView({
       destination: Cesium.Cartesian3.fromDegrees(lon, lat, alt),
       orientation: { heading, pitch, roll }
     });
   }
   function updateModelFromCamera() {
-    if (!viewer)
+    if (isDestroyed) {
+      log(PREFIX2, "Skipping updateModelFromCamera - module destroyed");
       return;
+    }
+    if (!syncEnabled) {
+      log(PREFIX2, "Skipping updateModelFromCamera - sync disabled");
+      return;
+    }
+    if (!viewer) {
+      warn(PREFIX2, "updateModelFromCamera called but viewer is null");
+      return;
+    }
     const position = viewer.camera.positionCartographic;
     const heading = viewer.camera.heading;
     const pitch = viewer.camera.pitch;
     const roll = viewer.camera.roll;
+    log(PREFIX2, "Updating model from camera:", {
+      lat: Cesium.Math.toDegrees(position.latitude),
+      lon: Cesium.Math.toDegrees(position.longitude),
+      alt: position.height
+    });
     model.set("latitude", Cesium.Math.toDegrees(position.latitude));
     model.set("longitude", Cesium.Math.toDegrees(position.longitude));
     model.set("altitude", position.height);
@@ -435,9 +623,20 @@ function initializeCameraSync(viewer, model) {
     model.save_changes();
   }
   function handleCameraChanged() {
-    clearTimeout(cameraUpdateTimeout);
+    if (isDestroyed) {
+      log(PREFIX2, "Skipping handleCameraChanged - module destroyed");
+      return;
+    }
+    if (!syncEnabled) {
+      return;
+    }
+    if (cameraUpdateTimeout) {
+      clearTimeout(cameraUpdateTimeout);
+    }
     cameraUpdateTimeout = setTimeout(() => {
-      updateModelFromCamera();
+      if (!isDestroyed && syncEnabled) {
+        updateModelFromCamera();
+      }
     }, 500);
   }
   updateCameraFromModel();
@@ -449,10 +648,15 @@ function initializeCameraSync(viewer, model) {
   model.on("change:pitch", updateCameraFromModel);
   model.on("change:roll", updateCameraFromModel);
   model.on("change:camera_command", () => {
+    if (isDestroyed) {
+      log(PREFIX2, "Skipping camera_command - module destroyed");
+      return;
+    }
     const command = model.get("camera_command");
     if (!command || !command.command || !command.timestamp)
       return;
     const cmd = command.command;
+    log(PREFIX2, "Executing camera command:", cmd, command);
     try {
       switch (cmd) {
         case "flyTo":
@@ -535,27 +739,36 @@ function initializeCameraSync(viewer, model) {
           viewer.camera.zoomOut(command.distance || 100);
           break;
         default:
-          console.warn(`Unknown camera command: ${cmd}`);
+          warn(PREFIX2, `Unknown camera command: ${cmd}`);
       }
-    } catch (error) {
-      console.error(`Error executing camera command ${cmd}:`, error);
+    } catch (err) {
+      error(PREFIX2, `Error executing camera command ${cmd}:`, err);
     }
   });
   return {
     updateCameraFromModel,
     updateModelFromCamera,
     destroy: () => {
-      clearTimeout(cameraUpdateTimeout);
+      log(PREFIX2, "Destroying camera sync module");
+      isDestroyed = true;
+      if (cameraUpdateTimeout) {
+        clearTimeout(cameraUpdateTimeout);
+        cameraUpdateTimeout = null;
+      }
       viewer.camera.changed.removeEventListener(handleCameraChanged);
+      log(PREFIX2, "Camera sync module destroyed");
     }
   };
 }
 
 // src/cesiumjs_anywidget/js/measurement-tools.js
+var PREFIX3 = "Measurements";
 function initializeMeasurementTools(viewer, model, container) {
+  log(PREFIX3, "Initializing measurement tools");
   const Cesium = window.Cesium;
   let measurementHandler = null;
   let editHandler = null;
+  let isDestroyed = false;
   let measurementState = {
     mode: null,
     points: [],
@@ -777,6 +990,7 @@ function initializeMeasurementTools(viewer, model, container) {
     };
   }
   function clearAllMeasurements() {
+    log(PREFIX3, "Clearing all measurements");
     measurementState.entities.forEach((e) => viewer.entities.remove(e));
     measurementState.labels.forEach((l) => viewer.entities.remove(l));
     measurementState.polylines.forEach((p) => viewer.entities.remove(p));
@@ -941,12 +1155,12 @@ function initializeMeasurementTools(viewer, model, container) {
     const editLatInput = document.getElementById("edit-lat");
     const editAltInput = document.getElementById("edit-alt");
     if (!applyBtn || !closeBtn || !editLonInput || !editLatInput || !editAltInput) {
-      console.warn("[CesiumWidget] Editor panel input elements not found in DOM");
+      warn(PREFIX3, "Editor panel input elements not found in DOM");
     }
     if (applyBtn) {
       applyBtn.onclick = () => {
         if (!editLonInput || !editLatInput || !editAltInput) {
-          console.warn("[CesiumWidget] Editor input fields not available");
+          warn(PREFIX3, "Editor input fields not available");
           return;
         }
         const lon = parseFloat(editLonInput.value);
@@ -1123,9 +1337,10 @@ function initializeMeasurementTools(viewer, model, container) {
   }
   function updateMeasurementsList() {
     const results = model.get("measurement_results") || [];
+    log(PREFIX3, "Updating measurements list, count:", results.length);
     const listContent = document.getElementById("measurements-list-content");
     if (!listContent) {
-      console.warn("[CesiumWidget] Measurements list content element not found in DOM");
+      warn(PREFIX3, "Measurements list content element not found in DOM");
       return;
     }
     if (results.length === 0) {
@@ -1185,7 +1400,7 @@ function initializeMeasurementTools(viewer, model, container) {
           renameMeasurement(index, name);
         };
       } else {
-        console.warn(`[CesiumWidget] Rename button not found for measurement ${index}`);
+        warn(PREFIX3, `Rename button not found for measurement ${index}`);
       }
     });
   }
@@ -1488,6 +1703,7 @@ function initializeMeasurementTools(viewer, model, container) {
     }
   }
   function enableMeasurementMode(mode) {
+    log(PREFIX3, "Enabling measurement mode:", mode);
     if (measurementHandler) {
       measurementHandler.destroy();
       measurementHandler = null;
@@ -1676,31 +1892,50 @@ function initializeMeasurementTools(viewer, model, container) {
     });
   }
   model.on("change:measurement_mode", () => {
+    if (isDestroyed) {
+      log(PREFIX3, "Skipping measurement_mode change - destroyed");
+      return;
+    }
     const mode = model.get("measurement_mode");
+    log(PREFIX3, "Measurement mode changed:", mode);
     enableMeasurementMode(mode);
   });
   model.on("change:measurement_results", () => {
+    if (isDestroyed) {
+      log(PREFIX3, "Skipping measurement_results change - destroyed");
+      return;
+    }
     const results = model.get("measurement_results") || [];
+    log(PREFIX3, "Measurement results changed, count:", results.length);
     if (results.length === 0) {
       clearAllMeasurements();
     }
     updateMeasurementsList();
   });
   model.on("change:load_measurements_trigger", () => {
+    if (isDestroyed)
+      return;
     const triggerData = model.get("load_measurements_trigger");
+    log(PREFIX3, "Load measurements trigger:", triggerData);
     if (triggerData && triggerData.measurements) {
       loadAndDisplayMeasurements(triggerData.measurements);
       updateMeasurementsList();
     }
   });
   model.on("change:focus_measurement_trigger", () => {
+    if (isDestroyed)
+      return;
     const triggerData = model.get("focus_measurement_trigger");
+    log(PREFIX3, "Focus measurement trigger:", triggerData);
     if (triggerData && typeof triggerData.index === "number") {
       focusOnMeasurement(triggerData.index);
     }
   });
   model.on("change:show_measurement_tools", () => {
+    if (isDestroyed)
+      return;
     const show = model.get("show_measurement_tools");
+    log(PREFIX3, "Show measurement tools:", show);
     toolbarDiv.style.display = show ? "flex" : "none";
     editorPanel.style.display = show ? editorPanel.style.display : "none";
     if (!show && editState.enabled) {
@@ -1709,7 +1944,10 @@ function initializeMeasurementTools(viewer, model, container) {
     }
   });
   model.on("change:show_measurements_list", () => {
+    if (isDestroyed)
+      return;
     const show = model.get("show_measurements_list");
+    log(PREFIX3, "Show measurements list:", show);
     measurementsListPanel.style.display = show ? "block" : "none";
   });
   toolbarDiv.style.display = model.get("show_measurement_tools") ? "flex" : "none";
@@ -1719,6 +1957,8 @@ function initializeMeasurementTools(viewer, model, container) {
     enableMeasurementMode,
     clearAllMeasurements,
     destroy: () => {
+      log(PREFIX3, "Destroying measurement tools");
+      isDestroyed = true;
       if (measurementHandler) {
         measurementHandler.destroy();
       }
@@ -1726,6 +1966,7 @@ function initializeMeasurementTools(viewer, model, container) {
       if (toolbarDiv.parentNode) {
         toolbarDiv.remove();
       }
+      log(PREFIX3, "Measurement tools destroyed");
     }
   };
 }
@@ -1733,15 +1974,26 @@ function initializeMeasurementTools(viewer, model, container) {
 // src/cesiumjs_anywidget/js/index.js
 window.CESIUM_BASE_URL = "https://cesium.com/downloads/cesiumjs/releases/1.135/Build/Cesium/";
 async function render({ model, el }) {
+  setDebugMode(model.get("debug_mode") || false);
+  model.on("change:debug_mode", () => {
+    setDebugMode(model.get("debug_mode"));
+  });
+  log("Main", "Starting render");
+  log("Main", "Loading CesiumJS...");
   const Cesium = await loadCesiumJS();
+  log("Main", "CesiumJS loaded successfully");
   const container = document.createElement("div");
   container.style.width = "100%";
   container.style.height = model.get("height");
   container.style.position = "relative";
   el.appendChild(container);
+  log("Main", "Container created with height:", model.get("height"));
   const ionToken = model.get("ion_access_token");
   if (ionToken) {
     Cesium.Ion.defaultAccessToken = ionToken;
+    log("Main", "Ion access token set");
+  } else {
+    warn("Main", "No Ion access token provided");
   }
   const loadingDiv = createLoadingIndicator(container, !!ionToken);
   let viewer = null;
@@ -1751,37 +2003,57 @@ async function render({ model, el }) {
   let czmlLoader = null;
   (async () => {
     try {
+      log("Main", "Creating Cesium Viewer...");
       viewer = createViewer(container, model, Cesium);
+      log("Main", "Cesium Viewer created successfully");
       if (loadingDiv.parentNode) {
         loadingDiv.remove();
       }
+      log("Main", "Initializing camera synchronization...");
       cameraSync = initializeCameraSync(viewer, model);
+      log("Main", "Camera synchronization initialized");
+      log("Main", "Initializing measurement tools...");
       measurementTools = initializeMeasurementTools(viewer, model, container);
+      log("Main", "Measurement tools initialized");
+      log("Main", "Setting up viewer listeners...");
       setupViewerListeners(viewer, model, container, Cesium);
+      log("Main", "Viewer listeners set up");
+      log("Main", "Setting up GeoJSON loader...");
       geoJsonLoader = setupGeoJSONLoader(viewer, model, Cesium);
+      log("Main", "GeoJSON loader set up");
+      log("Main", "Setting up CZML loader...");
       czmlLoader = setupCZMLLoader(viewer, model, Cesium);
-    } catch (error) {
-      console.error("Error initializing CesiumJS viewer:", error);
-      loadingDiv.textContent = `Error: ${error.message}`;
+      log("Main", "CZML loader set up");
+      log("Main", "Initialization complete");
+    } catch (err) {
+      error("Main", "Error initializing CesiumJS viewer:", err);
+      loadingDiv.textContent = `Error: ${err.message}`;
       loadingDiv.style.background = "rgba(255,0,0,0.8)";
     }
   })();
   return () => {
+    log("Main", "Starting cleanup...");
     if (cameraSync) {
+      log("Main", "Destroying camera sync...");
       cameraSync.destroy();
     }
     if (measurementTools) {
+      log("Main", "Destroying measurement tools...");
       measurementTools.destroy();
     }
     if (geoJsonLoader) {
+      log("Main", "Destroying GeoJSON loader...");
       geoJsonLoader.destroy();
     }
     if (czmlLoader) {
+      log("Main", "Destroying CZML loader...");
       czmlLoader.destroy();
     }
     if (viewer) {
+      log("Main", "Destroying viewer...");
       viewer.destroy();
     }
+    log("Main", "Cleanup complete");
   };
 }
 var js_default = { render };

cesiumjs_anywidget/widget.py

@@ -130,6 +130,17 @@ class CesiumWidget(anywidget.AnyWidget):
         default_value=True, help="Show or hide measurements list panel"
     ).tag(sync=True)
 
+    # Debug mode for JavaScript logging
+    debug_mode = traitlets.Bool(
+        default_value=False, help="Enable or disable JavaScript console logging"
+    ).tag(sync=True)
+
+    # Camera synchronization callbacks
+    camera_sync_enabled = traitlets.Bool(
+        default_value=False,
+        help="Enable or disable camera position synchronization callbacks"
+    ).tag(sync=True)
+
     def __init__(self, **kwargs):
         """Initialize the CesiumWidget.
 
@@ -774,6 +785,59 @@ class CesiumWidget(anywidget.AnyWidget):
         """Hide the measurements list panel."""
         self.show_measurements_list = False
 
+    def enable_debug(self):
+        """Enable JavaScript console logging for debugging.
+        
+        When enabled, detailed logs will be printed to the browser console
+        showing widget initialization, data loading, camera events, etc.
+        
+        Examples
+        --------
+        >>> widget.enable_debug()  # Enable logging
+        >>> # ... interact with widget, check browser console for logs
+        >>> widget.disable_debug()  # Disable logging when done
+        """
+        self.debug_mode = True
+
+    def disable_debug(self):
+        """Disable JavaScript console logging.
+        
+        Examples
+        --------
+        >>> widget.disable_debug()
+        """
+        self.debug_mode = False
+
+    def enable_camera_sync(self):
+        """Enable camera synchronization callbacks.
+        
+        When enabled, camera position changes in the Cesium viewer will be
+        synchronized back to the Python model (latitude, longitude, altitude,
+        heading, pitch, roll properties).
+        
+        Note: This is disabled by default to avoid unnecessary updates when
+        you don't need to track camera position in Python.
+        
+        Examples
+        --------
+        >>> widget.enable_camera_sync()
+        >>> # Move camera in the viewer...
+        >>> print(widget.latitude, widget.longitude)  # Updated values
+        """
+        self.camera_sync_enabled = True
+
+    def disable_camera_sync(self):
+        """Disable camera synchronization callbacks.
+        
+        When disabled, camera movements in the viewer will not update the
+        Python model properties. This is the default state.
+        
+        Examples
+        --------
+        >>> widget.disable_camera_sync()
+        """
+        self.camera_sync_enabled = False
+
     def set_atmosphere(self, 
                       brightness_shift=None, 
                       hue_shift=None, 

{cesiumjs_anywidget-0.4.0.dist-info → cesiumjs_anywidget-0.6.0.dist-info}/METADATA

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: cesiumjs-anywidget
-Version: 0.4.0
+Version: 0.6.0
 Summary: A Jupyter widget for CesiumJS 3D globe visualization using anywidget
 Project-URL: Homepage, https://github.com/Alex-PLACET/cesiumjs_anywidget
 Project-URL: Repository, https://github.com/Alex-PLACET/cesiumjs_anywidget
-Author: Alex PLACET
+Author: Alexis Placet
 License:                                  Apache License
                                    Version 2.0, January 2004
                                 http://www.apache.org/licenses/

cesiumjs_anywidget-0.6.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+cesiumjs_anywidget/__init__.py,sha256=9WVcAtreHgk6C5clPG6sZy4m7s5AIbGU1DJ4oDpx3Is,165
+cesiumjs_anywidget/styles.css,sha256=kt2i9fJuM6gaR7WkoQ2VGGoHzhqy6RpJVK2xwMKPV70,689
+cesiumjs_anywidget/widget.py,sha256=Yh_pluGI23vu-RvB1oHiZtq7ySAxPlYzIHViDFvS85k,41258
+cesiumjs_anywidget/index.js,sha256=22bGV7SzM8b69-kFEWoXhh94TQaUAM9cJmEV5Ykmmbc,78269
+cesiumjs_anywidget-0.6.0.dist-info/METADATA,sha256=D2p5Jx2HOWr-B9krknzNtGWhV53BKMjojhTCYti6SMg,24780
+cesiumjs_anywidget-0.6.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+cesiumjs_anywidget-0.6.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+cesiumjs_anywidget-0.6.0.dist-info/RECORD,,

cesiumjs_anywidget-0.4.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-cesiumjs_anywidget/__init__.py,sha256=9WVcAtreHgk6C5clPG6sZy4m7s5AIbGU1DJ4oDpx3Is,165
-cesiumjs_anywidget/styles.css,sha256=kt2i9fJuM6gaR7WkoQ2VGGoHzhqy6RpJVK2xwMKPV70,689
-cesiumjs_anywidget/widget.py,sha256=_7uXX7B3KsOg_3QrMDfV0pZ8BGA-6coFnZ7_gTI3nck,39104
-cesiumjs_anywidget/index.js,sha256=SrJ9F9xHdfvbz5CkP_ydspiDaPU6vp74vxtUv-RVimE,68405
-cesiumjs_anywidget-0.4.0.dist-info/METADATA,sha256=NwADYoiPPp4RLblmHCM5_mhak_cCB7ptC4iN0NXVZTY,24778
-cesiumjs_anywidget-0.4.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-cesiumjs_anywidget-0.4.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-cesiumjs_anywidget-0.4.0.dist-info/RECORD,,