pydeck: bump frontend to ~9.3.*, fix widget JSON registration, add widget gallery examples (#10242)

* Prepare pydeck 0.9.3 release

Bump pydeck version 0.9.2 → 0.9.3 and lock frontend to deck.gl ~9.3.*.
Update bump_version.py to generate tilde-range semver (~X.Y.*) from lerna.json.

https://claude.ai/code/session_012C1gkGaLFxk6HMvN4VMrST

* Fix quote style to double quotes per Black formatter

https://claude.ai/code/session_012C1gkGaLFxk6HMvN4VMrST

* Add PopupWidget and InfoWidget to pydeck widget gallery example

Demonstrates the two new 9.3 widgets:
- PopupWidget: static HTML popup anchored at Heathrow Airport coordinates
- InfoWidget: hover-mode widget (getTooltip callback must be set on the JS side)

https://claude.ai/code/session_012C1gkGaLFxk6HMvN4VMrST

* Fix InfoWidget JSON registration and use @@= for getTooltip in example

create-deck.js was overwriting InfoWidget, ThemeWidget, and LoadingWidget
with undefined by referencing non-existent _-prefixed exports; those widgets
are already captured by extractElements. Removed the incorrect entries.

Update the widgets example to use @@= expression syntax for InfoWidget's
getTooltip, and drop "new in 9.3" labels.

https://claude.ai/code/session_012C1gkGaLFxk6HMvN4VMrST

* Register TimelineWidget in JSON converter configuration

https://claude.ai/code/session_012C1gkGaLFxk6HMvN4VMrST

* Revert pydeck version bump to 0.9.2

Not ready for release yet; keep frontend locked to ~9.3.* but hold
the Python package version at 0.9.2.

https://claude.ai/code/session_012C1gkGaLFxk6HMvN4VMrST

* fix(widgets): handle negative DMS degrees and guard InfoWidget tooltip expression

The dmsToDecimal function miscalculated when degrees were negative with
non-zero minutes/seconds (e.g. -37°48'00" → -36.2 instead of -37.8).
Also guard the InfoWidget example's @@= expression against undefined
object when hovering empty space.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(pydeck): add 0.9.3 changelog, whats-new section, and playground link

Add pydeck 0.9.3 entry to CHANGELOG.rst, a pydeck subsection under
deck.gl v9.3 whats-new, and link to the new pydeck playground from the
pydeck docs index page.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: remove pydeck section from deck.gl whats-new

pydeck has its own docs site with CHANGELOG.rst as the canonical
release notes location.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: move DMS fix to deck.gl whats-new patch notes

The negative DMS parsing fix is a deck.gl core change, not a pydeck
change. Move it to the v9.3 patch releases section in whats-new.md.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: remove patch release note from whats-new

Patch fixes aren't historically documented in this file on master.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore(deps): bump bleach to 6.4.0 and jupyter-server to 2.20.0

Security updates for pydeck lockfile:
- bleach 6.4.0: XSS fixes in URI/formaction sanitization (GHSA-8rfp-98v4-mmr6)
- jupyter-server 2.20.0: CVE-2026-44727 (GHSA-fcw5-x6j4-ccmp)

Supersedes #10390 and #10391.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: chrisgervang

bindings/pydeck/bump_version.py

@@ -31,7 +31,7 @@ def bump(release_type):
 
 def rewrite_version_file(semver):
     with open("pydeck/_version.py", "w+") as f:
-        t = jinja2.Template("__version__ = '{{semver_str}}'")
+        t = jinja2.Template('__version__ = "{{semver_str}}"')
         contents = t.render(semver_str=str(semver))
         f.write(contents)
 
@@ -58,11 +58,13 @@ def rewrite_frontend_version_file():
     """Current associated version of NPM modules deck.gl and @deck.gl/jupyter-widget"""
     with open("../../lerna.json") as f:
         lerna_version = json.loads(f.read())["version"]
+    version_info = semver.parse_version_info(lerna_version)
+    semver_range = "~{}.{}.*".format(version_info.major, version_info.minor)
     with open("pydeck/frontend_semver.py", "w+") as f:
-        t = jinja2.Template("DECKGL_SEMVER = '{{semver_str}}'")
-        contents = t.render(semver_str=str(lerna_version))
+        t = jinja2.Template('DECKGL_SEMVER = "{{semver_str}}"')
+        contents = t.render(semver_str=semver_range)
         f.write(contents)
-    return lerna_version
+    return semver_range
 
 
 parser = argparse.ArgumentParser(description="Bump semver for pydeck. Modifies pydeck/_version.py directly.")

bindings/pydeck/docs/CHANGELOG.rst

@@ -6,6 +6,12 @@ Releases and associated GitHub PRs for pydeck are documented here.
 0.9 Releases
 ------------
 
+0.9.3 - Jul 2026
+^^^^^^^^^^^^^^^^^^^
+- Update to deck.gl v9.3 (#10242)
+- Add PopupWidget and InfoWidget to widget gallery example
+- Add pydeck playground at `deck.gl/pydeck <https://deck.gl/pydeck>`__
+
 0.9.2 - Apr 16 2026
 ^^^^^^^^^^^^^^^^^^^
 - Update to deck.gl v9.2 (#9895)

bindings/pydeck/docs/index.rst

@@ -16,6 +16,11 @@ Gallery
 Overview
 ^^^^^^^^
 
+`pydeck Playground <https://deck.gl/pydeck>`__
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Try pydeck scripts directly in the browser with the `pydeck playground <https://deck.gl/pydeck>`__. No installation needed — edit Python code and see the visualization update in real time.
+
 `pydeck in Jupyter <jupyter.html>`__
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 

bindings/pydeck/examples/widgets.py

@@ -9,6 +9,8 @@
 - FullscreenWidget and ScreenshotWidget for utility
 - ScaleWidget for displaying map scale
 - StatsWidget for rendering performance stats
+- PopupWidget for anchored geographic popups
+- InfoWidget for hover/click-activated feature popups
 """
 
 import pydeck as pdk
@@ -54,6 +56,17 @@
     pdk.Widget("ScreenshotWidget"),
     pdk.Widget("ScaleWidget", placement="bottom-right"),
     pdk.Widget("StatsWidget", statsType="luma", placement="bottom-left"),
+    # PopupWidget: static popup anchored to a geographic coordinate.
+    # content accepts a string (plain text) or a dict with "text", "html", or "element".
+    pdk.Widget(
+        "PopupWidget",
+        position=[-0.4543, 51.4775],  # Heathrow Airport, London
+        content={"html": "<strong>Heathrow Airport</strong><br/>London, United Kingdom"},
+        placement="right",
+    ),
+    # InfoWidget: popup triggered by hovering over pickable features.
+    # getTooltip uses the @@= expression syntax from @deck.gl/json to access feature properties.
+    pdk.Widget("InfoWidget", mode="hover", getTooltip="@@=object && object.properties && object.properties.name"),
 ]
 
 deck = pdk.Deck(

bindings/pydeck/pydeck/frontend_semver.py

@@ -1 +1 @@
-DECKGL_SEMVER = "~9.2.*"
+DECKGL_SEMVER = "~9.3.*"

bindings/pydeck/uv.lock

@@ -42,15 +42,12 @@ function extractElements(library = {}, filter) {
 const JSON_CONVERTER_CONFIGURATION = {
   classes: {
     ...extractElements(deckExports, classesFilter),
-    // Add experimental widgets (exported with _ prefix)
-    FpsWidget: deckExports._FpsWidget,
+    // Register widgets exported with _ prefix under their canonical names
     StatsWidget: deckExports._StatsWidget,
     ScaleWidget: deckExports._ScaleWidget,
     GeocoderWidget: deckExports._GeocoderWidget,
     SplitterWidget: deckExports._SplitterWidget,
-    InfoWidget: deckExports._InfoWidget,
-    ThemeWidget: deckExports._ThemeWidget,
-    LoadingWidget: deckExports._LoadingWidget
+    TimelineWidget: deckExports._TimelineWidget
   },
   // Will be resolved as `<enum-name>.<enum-value>`
   enumerations: {

modules/jupyter-widget/src/playground/create-deck.js

@@ -195,9 +195,12 @@ function dmsToDecimal(s: string): number {
   const minutes = parseFloat(match[2]) || 0;
   const seconds = parseFloat(match[3]) || 0;
   const direction = match[4] || '';
-  let dec = degrees + minutes / 60 + seconds / 3600;
+  const sign = degrees < 0 ? -1 : 1;
+  let dec = Math.abs(degrees) + minutes / 60 + seconds / 3600;
   if (/[SW]/i.test(direction)) {
     dec = -dec;
+  } else {
+    dec = sign * dec;
   }
   return dec;
 }

modules/widgets/src/lib/geocode/geocoders.ts

@@ -51,6 +51,25 @@ test('CoordinatesGeocoder.geocode - Handles DMS format correctly', async () => {
   }
 });
 
+test('CoordinatesGeocoder.geocode - Handles negative DMS degrees correctly', async () => {
+  const cases = [
+    {
+      input: '-37°48\'00\", 144°57\'47\"',
+      expected: {latitude: -37.8, longitude: 144.96305555555556}
+    },
+    {
+      input: '-33°51\'36\", -70°40\'12\"',
+      expected: {latitude: -33.86, longitude: -70.67}
+    }
+  ];
+
+  for (const {input, expected} of cases) {
+    const result = await CoordinatesGeocoder.geocode(input);
+    expect(result?.latitude, `geocode(${input}) latitude`).toBeCloseTo(expected.latitude, 4);
+    expect(result?.longitude, `geocode(${input}) longitude`).toBeCloseTo(expected.longitude, 4);
+  }
+});
+
 test('CoordinatesGeocoder.geocode - Returns null for invalid inputs', async () => {
   const cases = [
     {input: 'not a coordinate', expected: null},