cesiumjs-anywidget 0.5.0__tar.gz → 0.6.0__tar.gz

{cesiumjs_anywidget-0.5.0 → cesiumjs_anywidget-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cesiumjs-anywidget
-Version: 0.5.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

{cesiumjs_anywidget-0.5.0 → cesiumjs_anywidget-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cesiumjs-anywidget"
-version = "0.5.0"
+version = "0.6.0"
 description = "A Jupyter widget for CesiumJS 3D globe visualization using anywidget"
 readme = "README.md"
 license = { file = "LICENSE" }

{cesiumjs_anywidget-0.5.0 → cesiumjs_anywidget-0.6.0}/src/cesiumjs_anywidget/index.js

@@ -1,28 +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() {
-  console.log("[CesiumWidget:ViewerInit] Loading CesiumJS...");
+  log(PREFIX, "Loading CesiumJS...");
   if (window.Cesium) {
-    console.log("[CesiumWidget:ViewerInit] CesiumJS already loaded, reusing existing instance");
+    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";
-  console.log("[CesiumWidget:ViewerInit] Loading CesiumJS from CDN...");
+  log(PREFIX, "Loading CesiumJS from CDN...");
   await new Promise((resolve, reject) => {
     script.onload = () => {
-      console.log("[CesiumWidget:ViewerInit] CesiumJS script loaded successfully");
+      log(PREFIX, "CesiumJS script loaded successfully");
       resolve();
     };
-    script.onerror = (error) => {
-      console.error("[CesiumWidget:ViewerInit] Failed to load CesiumJS script:", error);
-      reject(error);
+    script.onerror = (err) => {
+      error(PREFIX, "Failed to load CesiumJS script:", err);
+      reject(err);
     };
     document.head.appendChild(script);
   });
-  console.log("[CesiumWidget:ViewerInit] CesiumJS initialized");
+  log(PREFIX, "CesiumJS initialized");
   return window.Cesium;
 }
 function createLoadingIndicator(container, hasToken) {
@@ -44,7 +65,7 @@ function createLoadingIndicator(container, hasToken) {
   return loadingDiv;
 }
 function createViewer(container, model, Cesium) {
-  console.log("[CesiumWidget:ViewerInit] Creating viewer with options...");
+  log(PREFIX, "Creating viewer with options...");
   const viewerOptions = {
     timeline: model.get("show_timeline"),
     animation: model.get("show_animation"),
@@ -58,28 +79,28 @@ function createViewer(container, model, Cesium) {
     shadows: false,
     shouldAnimate: false
   };
-  console.log("[CesiumWidget:ViewerInit] Viewer options:", viewerOptions);
+  log(PREFIX, "Viewer options:", viewerOptions);
   if (model.get("enable_terrain")) {
     viewerOptions.terrain = Cesium.Terrain.fromWorldTerrain();
-    console.log("[CesiumWidget:ViewerInit] Terrain enabled");
+    log(PREFIX, "Terrain enabled");
   }
   const viewer = new Cesium.Viewer(container, viewerOptions);
   viewer.scene.globe.enableLighting = model.get("enable_lighting");
-  console.log("[CesiumWidget:ViewerInit] Viewer created, lighting:", model.get("enable_lighting"));
+  log(PREFIX, "Viewer created, lighting:", model.get("enable_lighting"));
   return viewer;
 }
 function setupViewerListeners(viewer, model, container, Cesium) {
-  console.log("[CesiumWidget:ViewerInit] Setting up viewer listeners");
+  log(PREFIX, "Setting up viewer listeners");
   let isDestroyed = false;
   let scrubTimeout = null;
   model.on("change:enable_terrain", () => {
     if (isDestroyed) {
-      console.log("[CesiumWidget:ViewerInit] Skipping enable_terrain change - destroyed");
+      log(PREFIX, "Skipping enable_terrain change - destroyed");
       return;
     }
     if (!viewer)
       return;
-    console.log("[CesiumWidget:ViewerInit] Terrain setting changed:", model.get("enable_terrain"));
+    log(PREFIX, "Terrain setting changed:", model.get("enable_terrain"));
     if (model.get("enable_terrain")) {
       viewer.scene.setTerrain(Cesium.Terrain.fromWorldTerrain());
     } else {
@@ -91,7 +112,7 @@ function setupViewerListeners(viewer, model, container, Cesium) {
       return;
     if (!viewer)
       return;
-    console.log("[CesiumWidget:ViewerInit] Lighting setting changed:", model.get("enable_lighting"));
+    log(PREFIX, "Lighting setting changed:", model.get("enable_lighting"));
     viewer.scene.globe.enableLighting = model.get("enable_lighting");
   });
   model.on("change:height", () => {
@@ -99,7 +120,7 @@ function setupViewerListeners(viewer, model, container, Cesium) {
       return;
     if (!viewer)
       return;
-    console.log("[CesiumWidget:ViewerInit] Height changed:", model.get("height"));
+    log(PREFIX, "Height changed:", model.get("height"));
     container.style.height = model.get("height");
     viewer.resize();
   });
@@ -108,7 +129,7 @@ function setupViewerListeners(viewer, model, container, Cesium) {
       return;
     if (!viewer || !viewer.timeline)
       return;
-    console.log("[CesiumWidget:ViewerInit] Timeline visibility changed:", model.get("show_timeline"));
+    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", () => {
@@ -116,7 +137,7 @@ function setupViewerListeners(viewer, model, container, Cesium) {
       return;
     if (!viewer || !viewer.animation)
       return;
-    console.log("[CesiumWidget:ViewerInit] Animation visibility changed:", model.get("show_animation"));
+    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", () => {
@@ -127,7 +148,7 @@ function setupViewerListeners(viewer, model, container, Cesium) {
     const settings = model.get("atmosphere_settings");
     if (!settings || Object.keys(settings).length === 0)
       return;
-    console.log("[CesiumWidget:ViewerInit] Atmosphere settings changed:", settings);
+    log(PREFIX, "Atmosphere settings changed:", settings);
     const atmosphere = viewer.scene.atmosphere;
     if (settings.brightnessShift !== void 0) {
       atmosphere.brightnessShift = settings.brightnessShift;
@@ -173,7 +194,7 @@ function setupViewerListeners(viewer, model, container, Cesium) {
     const settings = model.get("sky_atmosphere_settings");
     if (!settings || Object.keys(settings).length === 0)
       return;
-    console.log("[CesiumWidget:ViewerInit] Sky atmosphere settings changed:", settings);
+    log(PREFIX, "Sky atmosphere settings changed:", settings);
     const skyAtmosphere = viewer.scene.skyAtmosphere;
     if (settings.show !== void 0) {
       skyAtmosphere.show = settings.show;
@@ -225,7 +246,7 @@ function setupViewerListeners(viewer, model, container, Cesium) {
     const settings = model.get("skybox_settings");
     if (!settings || Object.keys(settings).length === 0)
       return;
-    console.log("[CesiumWidget:ViewerInit] SkyBox settings changed:", settings);
+    log(PREFIX, "SkyBox settings changed:", settings);
     const skyBox = viewer.scene.skyBox;
     if (settings.show !== void 0) {
       skyBox.show = settings.show;
@@ -251,7 +272,7 @@ function setupViewerListeners(viewer, model, container, Cesium) {
   });
   function getCameraState() {
     if (!viewer || !viewer.camera || !viewer.camera.positionCartographic) {
-      console.warn("[CesiumWidget:ViewerInit] Cannot get camera state - viewer or camera not available");
+      warn(PREFIX, "Cannot get camera state - viewer or camera not available");
       return null;
     }
     try {
@@ -264,8 +285,8 @@ function setupViewerListeners(viewer, model, container, Cesium) {
         pitch: Cesium.Math.toDegrees(viewer.camera.pitch),
         roll: Cesium.Math.toDegrees(viewer.camera.roll)
       };
-    } catch (error) {
-      console.warn("[CesiumWidget:ViewerInit] Error getting camera state:", error);
+    } catch (error2) {
+      warn(PREFIX, "Error getting camera state:", error2);
       return null;
     }
   }
@@ -278,23 +299,23 @@ function setupViewerListeners(viewer, model, container, Cesium) {
         multiplier: viewer.clock.multiplier,
         is_animating: viewer.clock.shouldAnimate
       };
-    } catch (error) {
-      console.warn("[CesiumWidget:ViewerInit] Error getting clock state:", error);
+    } catch (error2) {
+      warn(PREFIX, "Error getting clock state:", error2);
       return null;
     }
   }
   function sendInteractionEvent(type, additionalData = {}) {
     if (isDestroyed) {
-      console.log("[CesiumWidget:ViewerInit] Skipping interaction event - destroyed:", type);
+      log(PREFIX, "Skipping interaction event - destroyed:", type);
       return;
     }
     if (!viewer) {
-      console.warn("[CesiumWidget:ViewerInit] Cannot send interaction event - viewer not available");
+      warn(PREFIX, "Cannot send interaction event - viewer not available");
       return;
     }
     const cameraState = getCameraState();
     if (!cameraState) {
-      console.warn("[CesiumWidget:ViewerInit] Skipping interaction event - camera state not available");
+      warn(PREFIX, "Skipping interaction event - camera state not available");
       return;
     }
     const event = {
@@ -304,7 +325,7 @@ function setupViewerListeners(viewer, model, container, Cesium) {
       clock: getClockState(),
       ...additionalData
     };
-    console.log("[CesiumWidget:ViewerInit] Interaction event:", type, event);
+    log(PREFIX, "Interaction event:", type, event);
     model.set("interaction_event", event);
     model.save_changes();
   }
@@ -333,8 +354,8 @@ function setupViewerListeners(viewer, model, container, Cesium) {
           };
         }
       }
-    } catch (error) {
-      console.warn("[CesiumWidget:ViewerInit] Error picking position:", error);
+    } catch (error2) {
+      warn(PREFIX, "Error picking position:", error2);
     }
     try {
       const pickedObject = viewer.scene.pick(click.position);
@@ -360,8 +381,8 @@ function setupViewerListeners(viewer, model, container, Cesium) {
           }
         }
       }
-    } catch (error) {
-      console.warn("[CesiumWidget:ViewerInit] Error picking entity:", error);
+    } catch (error2) {
+      warn(PREFIX, "Error picking entity:", error2);
     }
     sendInteractionEvent("left_click", pickedData);
   }, Cesium.ScreenSpaceEventType.LEFT_CLICK);
@@ -382,8 +403,8 @@ function setupViewerListeners(viewer, model, container, Cesium) {
           };
         }
       }
-    } catch (error) {
-      console.warn("[CesiumWidget:ViewerInit] Error picking position:", error);
+    } catch (error2) {
+      warn(PREFIX, "Error picking position:", error2);
     }
     sendInteractionEvent("right_click", pickedData);
   }, Cesium.ScreenSpaceEventType.RIGHT_CLICK);
@@ -407,23 +428,23 @@ function setupViewerListeners(viewer, model, container, Cesium) {
       }
     });
   }
-  console.log("[CesiumWidget:ViewerInit] Viewer listeners setup complete");
+  log(PREFIX, "Viewer listeners setup complete");
 }
 function setupGeoJSONLoader(viewer, model, Cesium) {
-  console.log("[CesiumWidget:ViewerInit] Setting up GeoJSON loader");
+  log(PREFIX, "Setting up GeoJSON loader");
   let geojsonDataSources = [];
   let isDestroyed = false;
   async function loadGeoJSONData(flyToData = true) {
     if (isDestroyed) {
-      console.log("[CesiumWidget:ViewerInit] Skipping geojson_data load - destroyed");
+      log(PREFIX, "Skipping geojson_data load - destroyed");
       return;
     }
     if (!viewer || !viewer.dataSources) {
-      console.warn("[CesiumWidget:ViewerInit] Cannot load GeoJSON - viewer or dataSources not available");
+      warn(PREFIX, "Cannot load GeoJSON - viewer or dataSources not available");
       return;
     }
     const geojsonDataArray = model.get("geojson_data");
-    console.log("[CesiumWidget:ViewerInit] Loading GeoJSON data, count:", geojsonDataArray?.length || 0);
+    log(PREFIX, "Loading GeoJSON data, count:", geojsonDataArray?.length || 0);
     geojsonDataSources.forEach((dataSource) => {
       if (viewer && viewer.dataSources) {
         viewer.dataSources.remove(dataSource);
@@ -433,7 +454,7 @@ function setupGeoJSONLoader(viewer, model, Cesium) {
     if (geojsonDataArray && Array.isArray(geojsonDataArray)) {
       for (const geojsonData of geojsonDataArray) {
         try {
-          console.log("[CesiumWidget:ViewerInit] Loading GeoJSON dataset...");
+          log(PREFIX, "Loading GeoJSON dataset...");
           const dataSource = await Cesium.GeoJsonDataSource.load(geojsonData, {
             stroke: Cesium.Color.HOTPINK,
             fill: Cesium.Color.PINK.withAlpha(0.5),
@@ -442,14 +463,14 @@ function setupGeoJSONLoader(viewer, model, Cesium) {
           if (viewer && viewer.dataSources) {
             viewer.dataSources.add(dataSource);
             geojsonDataSources.push(dataSource);
-            console.log("[CesiumWidget:ViewerInit] GeoJSON dataset loaded successfully");
+            log(PREFIX, "GeoJSON dataset loaded successfully");
           }
-        } catch (error) {
-          console.error("[CesiumWidget:ViewerInit] Error loading GeoJSON:", error);
+        } catch (error2) {
+          error2(PREFIX, "Error loading GeoJSON:", error2);
         }
       }
       if (flyToData && geojsonDataSources.length > 0 && viewer && viewer.flyTo) {
-        console.log("[CesiumWidget:ViewerInit] Flying to GeoJSON data");
+        log(PREFIX, "Flying to GeoJSON data");
         viewer.flyTo(geojsonDataSources[0]);
       }
     }
@@ -457,12 +478,12 @@ function setupGeoJSONLoader(viewer, model, Cesium) {
   model.on("change:geojson_data", () => loadGeoJSONData(true));
   const initialData = model.get("geojson_data");
   if (initialData && Array.isArray(initialData) && initialData.length > 0) {
-    console.log("[CesiumWidget:ViewerInit] Loading initial GeoJSON data...");
+    log(PREFIX, "Loading initial GeoJSON data...");
     loadGeoJSONData(true);
   }
   return {
     destroy: () => {
-      console.log("[CesiumWidget:ViewerInit] Destroying GeoJSON loader");
+      log(PREFIX, "Destroying GeoJSON loader");
       isDestroyed = true;
       geojsonDataSources.forEach((dataSource) => {
         if (viewer) {
@@ -474,20 +495,20 @@ function setupGeoJSONLoader(viewer, model, Cesium) {
   };
 }
 function setupCZMLLoader(viewer, model, Cesium) {
-  console.log("[CesiumWidget:ViewerInit] Setting up CZML loader");
+  log(PREFIX, "Setting up CZML loader");
   let czmlDataSources = [];
   let isDestroyed = false;
   async function loadCZMLData(flyToData = true) {
     if (isDestroyed) {
-      console.log("[CesiumWidget:ViewerInit] Skipping czml_data load - destroyed");
+      log(PREFIX, "Skipping czml_data load - destroyed");
       return;
     }
     if (!viewer || !viewer.dataSources) {
-      console.warn("[CesiumWidget:ViewerInit] Cannot load CZML - viewer or dataSources not available");
+      warn(PREFIX, "Cannot load CZML - viewer or dataSources not available");
       return;
     }
     const czmlDataArray = model.get("czml_data");
-    console.log("[CesiumWidget:ViewerInit] Loading CZML data, count:", czmlDataArray?.length || 0);
+    log(PREFIX, "Loading CZML data, count:", czmlDataArray?.length || 0);
     czmlDataSources.forEach((dataSource) => {
       if (viewer && viewer.dataSources) {
         viewer.dataSources.remove(dataSource);
@@ -498,22 +519,22 @@ function setupCZMLLoader(viewer, model, Cesium) {
       for (const czmlData of czmlDataArray) {
         if (Array.isArray(czmlData) && czmlData.length > 0) {
           try {
-            console.log("[CesiumWidget:ViewerInit] Loading CZML document with", czmlData.length, "packets...");
+            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);
-              console.log("[CesiumWidget:ViewerInit] CZML document loaded successfully, entities:", dataSource.entities.values.length);
+              log(PREFIX, "CZML document loaded successfully, entities:", dataSource.entities.values.length);
             }
-          } catch (error) {
-            console.error("[CesiumWidget:ViewerInit] Error loading CZML:", error);
+          } catch (error2) {
+            error2(PREFIX, "Error loading CZML:", error2);
           }
         } else {
-          console.warn("[CesiumWidget:ViewerInit] Skipping invalid CZML data (not an array or empty):", czmlData);
+          warn(PREFIX, "Skipping invalid CZML data (not an array or empty):", czmlData);
         }
       }
       if (flyToData && czmlDataSources.length > 0 && viewer && viewer.flyTo) {
-        console.log("[CesiumWidget:ViewerInit] Flying to CZML data");
+        log(PREFIX, "Flying to CZML data");
         viewer.flyTo(czmlDataSources[0]);
       }
     }
@@ -521,12 +542,12 @@ function setupCZMLLoader(viewer, model, Cesium) {
   model.on("change:czml_data", () => loadCZMLData(true));
   const initialData = model.get("czml_data");
   if (initialData && Array.isArray(initialData) && initialData.length > 0) {
-    console.log("[CesiumWidget:ViewerInit] Loading initial CZML data...");
+    log(PREFIX, "Loading initial CZML data...");
     loadCZMLData(true);
   }
   return {
     destroy: () => {
-      console.log("[CesiumWidget:ViewerInit] Destroying CZML loader");
+      log(PREFIX, "Destroying CZML loader");
       isDestroyed = true;
       czmlDataSources.forEach((dataSource) => {
         if (viewer) {
@@ -539,18 +560,24 @@ 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 = null;
   let isDestroyed = false;
-  console.log("[CesiumWidget:CameraSync] Initializing camera synchronization");
+  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 (isDestroyed) {
-      console.log("[CesiumWidget:CameraSync] Skipping updateCameraFromModel - module destroyed");
+      log(PREFIX2, "Skipping updateCameraFromModel - module destroyed");
       return;
     }
     if (!viewer) {
-      console.warn("[CesiumWidget:CameraSync] updateCameraFromModel called but viewer is null");
+      warn(PREFIX2, "updateCameraFromModel called but viewer is null");
       return;
     }
     const lat = model.get("latitude");
@@ -559,7 +586,7 @@ function initializeCameraSync(viewer, model) {
     const heading = Cesium.Math.toRadians(model.get("heading"));
     const pitch = Cesium.Math.toRadians(model.get("pitch"));
     const roll = Cesium.Math.toRadians(model.get("roll"));
-    console.log("[CesiumWidget:CameraSync] Updating camera from model:", { lat, lon, alt });
+    log(PREFIX2, "Updating camera from model:", { lat, lon, alt });
     viewer.camera.setView({
       destination: Cesium.Cartesian3.fromDegrees(lon, lat, alt),
       orientation: { heading, pitch, roll }
@@ -567,18 +594,22 @@ function initializeCameraSync(viewer, model) {
   }
   function updateModelFromCamera() {
     if (isDestroyed) {
-      console.log("[CesiumWidget:CameraSync] Skipping updateModelFromCamera - module destroyed");
+      log(PREFIX2, "Skipping updateModelFromCamera - module destroyed");
+      return;
+    }
+    if (!syncEnabled) {
+      log(PREFIX2, "Skipping updateModelFromCamera - sync disabled");
       return;
     }
     if (!viewer) {
-      console.warn("[CesiumWidget:CameraSync] updateModelFromCamera called but viewer is null");
+      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;
-    console.log("[CesiumWidget:CameraSync] Updating model from camera:", {
+    log(PREFIX2, "Updating model from camera:", {
       lat: Cesium.Math.toDegrees(position.latitude),
       lon: Cesium.Math.toDegrees(position.longitude),
       alt: position.height
@@ -593,14 +624,17 @@ function initializeCameraSync(viewer, model) {
   }
   function handleCameraChanged() {
     if (isDestroyed) {
-      console.log("[CesiumWidget:CameraSync] Skipping handleCameraChanged - module destroyed");
+      log(PREFIX2, "Skipping handleCameraChanged - module destroyed");
+      return;
+    }
+    if (!syncEnabled) {
       return;
     }
     if (cameraUpdateTimeout) {
       clearTimeout(cameraUpdateTimeout);
     }
     cameraUpdateTimeout = setTimeout(() => {
-      if (!isDestroyed) {
+      if (!isDestroyed && syncEnabled) {
         updateModelFromCamera();
       }
     }, 500);
@@ -615,14 +649,14 @@ function initializeCameraSync(viewer, model) {
   model.on("change:roll", updateCameraFromModel);
   model.on("change:camera_command", () => {
     if (isDestroyed) {
-      console.log("[CesiumWidget:CameraSync] Skipping camera_command - module destroyed");
+      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;
-    console.log("[CesiumWidget:CameraSync] Executing camera command:", cmd, command);
+    log(PREFIX2, "Executing camera command:", cmd, command);
     try {
       switch (cmd) {
         case "flyTo":
@@ -705,31 +739,32 @@ 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: () => {
-      console.log("[CesiumWidget:CameraSync] Destroying camera sync module");
+      log(PREFIX2, "Destroying camera sync module");
       isDestroyed = true;
       if (cameraUpdateTimeout) {
         clearTimeout(cameraUpdateTimeout);
         cameraUpdateTimeout = null;
       }
       viewer.camera.changed.removeEventListener(handleCameraChanged);
-      console.log("[CesiumWidget:CameraSync] Camera sync module destroyed");
+      log(PREFIX2, "Camera sync module destroyed");
     }
   };
 }
 
 // src/cesiumjs_anywidget/js/measurement-tools.js
+var PREFIX3 = "Measurements";
 function initializeMeasurementTools(viewer, model, container) {
-  console.log("[CesiumWidget:MeasurementTools] Initializing measurement tools");
+  log(PREFIX3, "Initializing measurement tools");
   const Cesium = window.Cesium;
   let measurementHandler = null;
   let editHandler = null;
@@ -955,7 +990,7 @@ function initializeMeasurementTools(viewer, model, container) {
     };
   }
   function clearAllMeasurements() {
-    console.log("[CesiumWidget:MeasurementTools] Clearing all measurements");
+    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));
@@ -1120,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);
@@ -1302,10 +1337,10 @@ function initializeMeasurementTools(viewer, model, container) {
   }
   function updateMeasurementsList() {
     const results = model.get("measurement_results") || [];
-    console.log("[CesiumWidget:MeasurementTools] Updating measurements list, count:", results.length);
+    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) {
@@ -1365,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}`);
       }
     });
   }
@@ -1668,7 +1703,7 @@ function initializeMeasurementTools(viewer, model, container) {
     }
   }
   function enableMeasurementMode(mode) {
-    console.log("[CesiumWidget:MeasurementTools] Enabling measurement mode:", mode);
+    log(PREFIX3, "Enabling measurement mode:", mode);
     if (measurementHandler) {
       measurementHandler.destroy();
       measurementHandler = null;
@@ -1858,20 +1893,20 @@ function initializeMeasurementTools(viewer, model, container) {
   }
   model.on("change:measurement_mode", () => {
     if (isDestroyed) {
-      console.log("[CesiumWidget:MeasurementTools] Skipping measurement_mode change - destroyed");
+      log(PREFIX3, "Skipping measurement_mode change - destroyed");
       return;
     }
     const mode = model.get("measurement_mode");
-    console.log("[CesiumWidget:MeasurementTools] Measurement mode changed:", mode);
+    log(PREFIX3, "Measurement mode changed:", mode);
     enableMeasurementMode(mode);
   });
   model.on("change:measurement_results", () => {
     if (isDestroyed) {
-      console.log("[CesiumWidget:MeasurementTools] Skipping measurement_results change - destroyed");
+      log(PREFIX3, "Skipping measurement_results change - destroyed");
       return;
     }
     const results = model.get("measurement_results") || [];
-    console.log("[CesiumWidget:MeasurementTools] Measurement results changed, count:", results.length);
+    log(PREFIX3, "Measurement results changed, count:", results.length);
     if (results.length === 0) {
       clearAllMeasurements();
     }
@@ -1881,7 +1916,7 @@ function initializeMeasurementTools(viewer, model, container) {
     if (isDestroyed)
       return;
     const triggerData = model.get("load_measurements_trigger");
-    console.log("[CesiumWidget:MeasurementTools] Load measurements trigger:", triggerData);
+    log(PREFIX3, "Load measurements trigger:", triggerData);
     if (triggerData && triggerData.measurements) {
       loadAndDisplayMeasurements(triggerData.measurements);
       updateMeasurementsList();
@@ -1891,7 +1926,7 @@ function initializeMeasurementTools(viewer, model, container) {
     if (isDestroyed)
       return;
     const triggerData = model.get("focus_measurement_trigger");
-    console.log("[CesiumWidget:MeasurementTools] Focus measurement trigger:", triggerData);
+    log(PREFIX3, "Focus measurement trigger:", triggerData);
     if (triggerData && typeof triggerData.index === "number") {
       focusOnMeasurement(triggerData.index);
     }
@@ -1900,7 +1935,7 @@ function initializeMeasurementTools(viewer, model, container) {
     if (isDestroyed)
       return;
     const show = model.get("show_measurement_tools");
-    console.log("[CesiumWidget:MeasurementTools] Show measurement tools:", show);
+    log(PREFIX3, "Show measurement tools:", show);
     toolbarDiv.style.display = show ? "flex" : "none";
     editorPanel.style.display = show ? editorPanel.style.display : "none";
     if (!show && editState.enabled) {
@@ -1912,7 +1947,7 @@ function initializeMeasurementTools(viewer, model, container) {
     if (isDestroyed)
       return;
     const show = model.get("show_measurements_list");
-    console.log("[CesiumWidget:MeasurementTools] Show measurements list:", show);
+    log(PREFIX3, "Show measurements list:", show);
     measurementsListPanel.style.display = show ? "block" : "none";
   });
   toolbarDiv.style.display = model.get("show_measurement_tools") ? "flex" : "none";
@@ -1922,7 +1957,7 @@ function initializeMeasurementTools(viewer, model, container) {
     enableMeasurementMode,
     clearAllMeasurements,
     destroy: () => {
-      console.log("[CesiumWidget:MeasurementTools] Destroying measurement tools");
+      log(PREFIX3, "Destroying measurement tools");
       isDestroyed = true;
       if (measurementHandler) {
         measurementHandler.destroy();
@@ -1931,7 +1966,7 @@ function initializeMeasurementTools(viewer, model, container) {
       if (toolbarDiv.parentNode) {
         toolbarDiv.remove();
       }
-      console.log("[CesiumWidget:MeasurementTools] Measurement tools destroyed");
+      log(PREFIX3, "Measurement tools destroyed");
     }
   };
 }
@@ -1939,22 +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 }) {
-  console.log("[CesiumWidget] Starting render");
-  console.log("[CesiumWidget] Loading CesiumJS...");
+  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();
-  console.log("[CesiumWidget] CesiumJS loaded successfully");
+  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);
-  console.log("[CesiumWidget] Container created with height:", model.get("height"));
+  log("Main", "Container created with height:", model.get("height"));
   const ionToken = model.get("ion_access_token");
   if (ionToken) {
     Cesium.Ion.defaultAccessToken = ionToken;
-    console.log("[CesiumWidget] Ion access token set");
+    log("Main", "Ion access token set");
   } else {
-    console.warn("[CesiumWidget] No Ion access token provided");
+    warn("Main", "No Ion access token provided");
   }
   const loadingDiv = createLoadingIndicator(container, !!ionToken);
   let viewer = null;
@@ -1964,57 +2003,57 @@ async function render({ model, el }) {
   let czmlLoader = null;
   (async () => {
     try {
-      console.log("[CesiumWidget] Creating Cesium Viewer...");
+      log("Main", "Creating Cesium Viewer...");
       viewer = createViewer(container, model, Cesium);
-      console.log("[CesiumWidget] Cesium Viewer created successfully");
+      log("Main", "Cesium Viewer created successfully");
       if (loadingDiv.parentNode) {
         loadingDiv.remove();
       }
-      console.log("[CesiumWidget] Initializing camera synchronization...");
+      log("Main", "Initializing camera synchronization...");
       cameraSync = initializeCameraSync(viewer, model);
-      console.log("[CesiumWidget] Camera synchronization initialized");
-      console.log("[CesiumWidget] Initializing measurement tools...");
+      log("Main", "Camera synchronization initialized");
+      log("Main", "Initializing measurement tools...");
       measurementTools = initializeMeasurementTools(viewer, model, container);
-      console.log("[CesiumWidget] Measurement tools initialized");
-      console.log("[CesiumWidget] Setting up viewer listeners...");
+      log("Main", "Measurement tools initialized");
+      log("Main", "Setting up viewer listeners...");
       setupViewerListeners(viewer, model, container, Cesium);
-      console.log("[CesiumWidget] Viewer listeners set up");
-      console.log("[CesiumWidget] Setting up GeoJSON loader...");
+      log("Main", "Viewer listeners set up");
+      log("Main", "Setting up GeoJSON loader...");
       geoJsonLoader = setupGeoJSONLoader(viewer, model, Cesium);
-      console.log("[CesiumWidget] GeoJSON loader set up");
-      console.log("[CesiumWidget] Setting up CZML loader...");
+      log("Main", "GeoJSON loader set up");
+      log("Main", "Setting up CZML loader...");
       czmlLoader = setupCZMLLoader(viewer, model, Cesium);
-      console.log("[CesiumWidget] CZML loader set up");
-      console.log("[CesiumWidget] Initialization complete");
-    } catch (error) {
-      console.error("[CesiumWidget] 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 () => {
-    console.log("[CesiumWidget] Starting cleanup...");
+    log("Main", "Starting cleanup...");
     if (cameraSync) {
-      console.log("[CesiumWidget] Destroying camera sync...");
+      log("Main", "Destroying camera sync...");
       cameraSync.destroy();
     }
     if (measurementTools) {
-      console.log("[CesiumWidget] Destroying measurement tools...");
+      log("Main", "Destroying measurement tools...");
       measurementTools.destroy();
     }
     if (geoJsonLoader) {
-      console.log("[CesiumWidget] Destroying GeoJSON loader...");
+      log("Main", "Destroying GeoJSON loader...");
       geoJsonLoader.destroy();
     }
     if (czmlLoader) {
-      console.log("[CesiumWidget] Destroying CZML loader...");
+      log("Main", "Destroying CZML loader...");
       czmlLoader.destroy();
     }
     if (viewer) {
-      console.log("[CesiumWidget] Destroying viewer...");
+      log("Main", "Destroying viewer...");
       viewer.destroy();
     }
-    console.log("[CesiumWidget] Cleanup complete");
+    log("Main", "Cleanup complete");
   };
 }
 var js_default = { render };

{cesiumjs_anywidget-0.5.0 → cesiumjs_anywidget-0.6.0}/src/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.5.0 → cesiumjs_anywidget-0.6.0}/uv.lock

@@ -364,7 +364,7 @@ wheels = [
 
 [[package]]
 name = "cesiumjs-anywidget"
-version = "0.5.0"
+version = "0.6.0"
 source = { editable = "." }
 dependencies = [
     { name = "anywidget" },