anywidget-vector 0.4.0__tar.gz → 0.4.1__tar.gz

{anywidget_vector-0.4.0 → anywidget_vector-0.4.1}/.github/workflows/ci.yml

@@ -42,7 +42,8 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
 
-      # The ESM bundle tests parse and run the widget's JavaScript with Node
+      # The ESM bundle tests parse and run the widget's JavaScript with Node (the tsc, jsdom and stale-bundle
+      # checks need node_modules and skip here: the frontend job runs them once)
       - name: Set up Node.js
         uses: actions/setup-node@v7
         with:
@@ -54,6 +55,33 @@ jobs:
       - name: Run tests
         run: uv run --locked --extra dev pytest
 
+  frontend:
+    name: Front end
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v7
+        with:
+          node-version: "22"
+
+      # esbuild, TypeScript and the type packages, so tsc can check every module in src/ and tests/js/
+      - name: Install the front-end dependencies
+        run: npm ci --ignore-scripts
+
+      - name: Install the JavaScript test dependencies
+        run: npm ci --ignore-scripts --prefix tests/js
+
+      - name: Check that the committed bundles are built from the current sources
+        run: npm run check
+
+      - name: Type-check the front end
+        run: npm run typecheck
+
+      - name: Run the JavaScript tests
+        run: npm test
+
   build:
     name: Build
     runs-on: ubuntu-latest

{anywidget_vector-0.4.0 → anywidget_vector-0.4.1}/.github/workflows/grafeo-latest.yml

@@ -55,7 +55,7 @@ jobs:
         id: version
         run: |
           if [ "${{ matrix.release }}" = "pinned" ]; then
-            version=$(sed -n 's/^export const GRAFEO_WASM_VERSION = "\(.*\)";$/\1/p' src/anywidget_vector/backends/grafeo/embed.js)
+            version=$(sed -n 's/^export const GRAFEO_WASM_VERSION = "\(.*\)";$/\1/p' src/anywidget_vector/backends/grafeo/embed.ts)
           else
             version=$(npm view @grafeo-db/wasm versions --json | node -e 'const v = JSON.parse(require("fs").readFileSync(0, "utf8")); console.log([].concat(v).pop())')
           fi
@@ -69,4 +69,4 @@ jobs:
           tar -xzf grafeo-db-wasm-*.tgz
 
       - name: Run smoke test
-        run: node tests/js/wasm_smoke.mjs "$RUNNER_TEMP/wasm/package"
+        run: node tests/js/wasm_smoke.ts "$RUNNER_TEMP/wasm/package"

{anywidget_vector-0.4.0 → anywidget_vector-0.4.1}/.gitignore

@@ -20,7 +20,7 @@ __pycache__/
 *.so
 *.egg-info/
 *.egg
-dist/
+/dist/
 build/
 .eggs/
 .venv/

{anywidget_vector-0.4.0 → anywidget_vector-0.4.1}/CHANGELOG.md

@@ -1,6 +1,33 @@
 # Changelog
 
-## 0.4.0 (2026-10-28)
+## [0.4.1] - 2026-11-12
+
+Grafeo 0.6.2 release: the Grafeo backend moves to grafeo 0.6.2 in Python and in the browser, and the front end is TypeScript, bundled by esbuild. An environment with the `grafeo` extra upgrades grafeo to 0.6.2 or later; to keep grafeo 0.6.0 or 0.6.1, stay on anywidget-vector 0.4.0 and pin grafeo.
+
+### Changed
+
+- **Front end in TypeScript**: The widget loads `ui/dist/widget.js`, built by esbuild from the modules in `ui/` and `backends/` (`npm run build`), instead of the JavaScript modules joined as text. `to_html()` uses its own bundle, `ui/dist/export.js`, with the page template in `ui/export.html`.
+- **Release checks**: CI type-checks the front end with `tsc` (`npm run typecheck`), runs the JavaScript tests (`npm test`), and fails when a committed bundle is stale.
+- **grafeo-server version**: The README says the `server` Grafeo mode needs grafeo-server 0.6.0 or later, the Grafeo 0.6 engine, which sends decimals as `{"$decimal": "..."}` (the widget turns them into numbers).
+- **Exported pages draw points in one call**: `to_html()` and `save_html()` draw every point as an instance of one mesh instead of one mesh per point.
+
+### Fixed
+
+- **Exported point sizes match the widget**: `to_html()` scales `size_range` by the data extent, as the live view does.
+- **An exported single point is in view**: A page with one point, or with points that share a position, places the camera away from them instead of on them.
+- **The exported tooltip hides on leave**: Moving the pointer off an exported page hides the tooltip.
+- **Pinecone fetches by id show their points**: A `{"ids": [...]}` query reads the fetched records (previously it showed no points), sends the configured `namespace`, and encodes each id, so ids with `&` or `#` resolve.
+- **WASM mode creates one database**: Queries started while `@grafeo-db/wasm` loads share one database instead of each creating one.
+- **The Run button shows Python-side queries**: For backends that run in Python (Grafeo embedded, Chroma, LanceDB), the button stays in its loading state until the result arrives.
+- **A widget without WebGL leaves no listeners**: When the 3D canvas cannot be created, the view removes the model and theme listeners it had added.
+- **Neighbor names fall back to the id**: The sidebar's distance list shows the id for a point whose `label` is empty.
+
+### Dependencies
+
+- **grafeo 0.6.2** (requires `>=0.6.2,<0.7`): The `grafeo` and `dev` extras need grafeo 0.6.2, and the `wasm` mode loads `@grafeo-db/wasm` 0.6.2 (`GRAFEO_WASM_VERSION` in `backends/grafeo/embed.ts`).
+- **Locked versions refreshed**: 35 packages, among them ty 0.0.100, typer 0.29.0, pandas 3.1.1, lancedb 0.41.0, ruff 0.17.4 and python-dateutil 4.0.0. Front-end build tools: esbuild 0.28.2, TypeScript 7.0.2 and `@types/three` 0.186.0.
+
+## [0.4.0] - 2026-10-28
 
 Requires Python 3.12 or later; the Grafeo backend requires grafeo 0.6. See "Upgrading to 0.4" in the README.
 
@@ -46,7 +73,7 @@ Requires Python 3.12 or later; the Grafeo backend requires grafeo 0.6. See "Upgr
 - **HTML export sizes**: `to_html(width=..., height=...)` placed the values in the page's `<style>` unchecked; a value that is not a plain CSS size now raises `ValueError`
 - **Source distribution**: A local `uv build` packed the `.claude/` folder (agent notes and local settings) into the sdist; it is now excluded
 
-## 0.3.2 (2026-03-16)
+## [0.3.2] - 2026-03-16
 
 ### Improvements
 
@@ -62,7 +89,7 @@ Requires Python 3.12 or later; the Grafeo backend requires grafeo 0.6. See "Upgr
 - **setSelection scoping**: Moved `setSelection` helper to `createCanvas` scope so lasso/box/click handlers can access it
 - **Camera debounce variable**: Fixed `_cameraDebounce` lexical declaration error by moving it to the correct scope
 
-## 0.3.1 (2026-03-16)
+## [0.3.1] - 2026-03-16
 
 ### New Features
 
@@ -82,7 +109,7 @@ Requires Python 3.12 or later; the Grafeo backend requires grafeo 0.6. See "Upgr
 - Camera no longer resets on every point update (only on initial load)
 - Cross-widget filtering: example updated so VectorSpace lasso selection feeds back into ParallelCoordinates dimming via marimo reactivity
 
-## 0.3.0 (2026-03-16)
+## [0.3.0] - 2026-03-16
 
 ### New Features
 
@@ -93,19 +120,19 @@ Requires Python 3.12 or later; the Grafeo backend requires grafeo 0.6. See "Upgr
 
 - Improved sidebar styling and layout
 
-## 0.2.8 (2026-03-15)
+## [0.2.8] - 2026-03-15
 
 ### New Features
 
 - **6D parallel coordinates example**: Fashion-MNIST demo with PCA across 6+ dimensions, interactive axis mapping and shape mapping to categorical labels
 
-## 0.2.7 (2026-03-15)
+## [0.2.7] - 2026-03-15
 
 ### New Features
 
 - **Dark/light mode toggle**: `dark_mode` trait with real-time CSS color scheme switching and theme-aware styling across all panels
 
-## 0.2.6 (2026-03-15)
+## [0.2.6] - 2026-03-15
 
 ### New Features
 
@@ -119,7 +146,7 @@ Requires Python 3.12 or later; the Grafeo backend requires grafeo 0.6. See "Upgr
 - Coordinate normalization after projection
 - Added demo screenshot to README
 
-## 0.2.5 (2026-03-04)
+## [0.2.5] - 2026-03-04
 
 ### Bug Fixes
 
@@ -132,7 +159,7 @@ Requires Python 3.12 or later; the Grafeo backend requires grafeo 0.6. See "Upgr
 - Better visual feedback for selection modes
 - Cleaner toolbar layout with integrated mode controls
 
-## 0.2.4 (2026-03-02)
+## [0.2.4] - 2026-03-02
 
 ### New Features
 
@@ -146,7 +173,7 @@ Requires Python 3.12 or later; the Grafeo backend requires grafeo 0.6. See "Upgr
 - Updated README with comprehensive usage examples
 - Updated dependencies
 
-## 0.2.3 (2026-02-12)
+## [0.2.3] - 2026-02-12
 
 ### New Features
 
@@ -159,7 +186,7 @@ Requires Python 3.12 or later; the Grafeo backend requires grafeo 0.6. See "Upgr
 - Consistency pass across all backend modules
 - Ruff configuration tuned for marimo compatibility
 
-## 0.2.2 (2026-02-07)
+## [0.2.2] - 2026-02-07
 
 ### New Features
 
@@ -171,7 +198,7 @@ Requires Python 3.12 or later; the Grafeo backend requires grafeo 0.6. See "Upgr
 - Expanded test suite with 194 additional test cases
 - ESM bundle aggregation for widget JavaScript
 
-## 0.2.1 (2026-02-03)
+## [0.2.1] - 2026-02-03
 
 ### New Features
 
@@ -186,6 +213,6 @@ Requires Python 3.12 or later; the Grafeo backend requires grafeo 0.6. See "Upgr
 - Refactored monolithic widget into modular component architecture
 - Added README with usage examples
 
-## 0.1.0 (2026-02-03)
+## [0.1.0] - 2026-02-03
 
 - Initial release: Three.js-based interactive 3D vector visualization with instanced rendering, six shape types, continuous and categorical color mapping, orbit controls, hover tooltips, axes/grid display and raycast-based selection

{anywidget_vector-0.4.0 → anywidget_vector-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: anywidget-vector
-Version: 0.4.0
+Version: 0.4.1
 Summary: Interactive 3D vector visualization with query UI for vector databases
 Project-URL: Homepage, https://grafeo.dev/
 Project-URL: Repository, https://github.com/GrafeoDB/anywidget-vector
@@ -33,7 +33,7 @@ Provides-Extra: chroma
 Requires-Dist: chromadb==1.5.8; extra == 'chroma'
 Provides-Extra: demo
 Provides-Extra: dev
-Requires-Dist: grafeo<0.7,>=0.6.0; extra == 'dev'
+Requires-Dist: grafeo<0.7,>=0.6.2; extra == 'dev'
 Requires-Dist: marimo>=0.25.2; extra == 'dev'
 Requires-Dist: numpy>=1.24; extra == 'dev'
 Requires-Dist: packaging>=24; extra == 'dev'
@@ -43,7 +43,7 @@ Requires-Dist: ruff>=0.17.3; extra == 'dev'
 Requires-Dist: ty>=0.0.94; extra == 'dev'
 Provides-Extra: embed
 Provides-Extra: grafeo
-Requires-Dist: grafeo<0.7,>=0.6.0; extra == 'grafeo'
+Requires-Dist: grafeo<0.7,>=0.6.2; extra == 'grafeo'
 Provides-Extra: lancedb
 Requires-Dist: lancedb>=0.1; extra == 'lancedb'
 Provides-Extra: numpy
@@ -85,7 +85,7 @@ uv add anywidget-vector
 uv add "anywidget-vector[grafeo]"   # with the embedded Grafeo backend (grafeo 0.6)
 ```
 
-Requires Python 3.12 or later. The `grafeo` extra installs grafeo 0.6 (`grafeo>=0.6.0,<0.7`); the browser-side WASM mode loads the matching `@grafeo-db/wasm` from a CDN. Upgrading from 0.3 with Grafeo:
+Requires Python 3.12 or later. The `grafeo` extra installs grafeo 0.6 (`grafeo>=0.6.2,<0.7`; anywidget-vector 0.4.0 still accepts grafeo 0.6.0 and 0.6.1); the browser-side WASM mode loads the matching `@grafeo-db/wasm` from a CDN. Upgrading from 0.3 with Grafeo:
 see [Upgrading to 0.4](#upgrading-to-04).
 
 ## Quick Start
@@ -407,8 +407,8 @@ credentials in the kernel).
 | Mode | Where queries run | Setup |
 |------|-------------------|-------|
 | `embedded` (default) | In Python, on a `grafeo.GrafeoDB` | `uv add "anywidget-vector[grafeo]"` and `set_backend("grafeo", client=db)` |
-| `server` | Over HTTP, `POST /query` on [grafeo-server](https://github.com/GrafeoDB/grafeo-server) | `grafeo_server_url="http://localhost:7474"`; start the server with `--cors-origins` so the notebook's origin may call it |
-| `wasm` | In the browser, in-memory | Nothing to install: `@grafeo-db/wasm` 0.6.0 loads from the jsDelivr CDN on the first query (the only code the widget loads from a CDN) |
+| `server` | Over HTTP, `POST /query` on [grafeo-server](https://github.com/GrafeoDB/grafeo-server) | `grafeo_server_url="http://localhost:7474"`; start the server with `--cors-origins` so the notebook's origin may call it. Needs grafeo-server 0.6.0 or later (the Grafeo 0.6 engine, which sends decimals as `{"$decimal": "..."}`; the widget turns them into numbers) |
+| `wasm` | In the browser, in-memory | Nothing to install: `@grafeo-db/wasm` 0.6.2 loads from the jsDelivr CDN on the first query (the only code the widget loads from a CDN) |
 
 ```python
 import grafeo
@@ -453,8 +453,8 @@ The distance metrics of a Grafeo vector index (`cosine`, `euclidean`, `dot_produ
 same values as the widget's `distance_metric` and `compute_distances()`.
 
 The browser engine version is set in one place, `GRAFEO_WASM_VERSION` in
-`src/anywidget_vector/backends/grafeo/embed.js`, and moves in lockstep with the `grafeo` extra. Before a bump,
-run `node tests/js/wasm_smoke.mjs <unpacked @grafeo-db/wasm package>`.
+`src/anywidget_vector/backends/grafeo/embed.ts`, and moves in lockstep with the `grafeo` extra. Before a bump,
+run `node tests/js/wasm_smoke.ts <unpacked @grafeo-db/wasm package>`.
 
 ### Upgrading to 0.4
 

{anywidget_vector-0.4.0 → anywidget_vector-0.4.1}/README.md

@@ -22,7 +22,7 @@ uv add anywidget-vector
 uv add "anywidget-vector[grafeo]"   # with the embedded Grafeo backend (grafeo 0.6)
 ```
 
-Requires Python 3.12 or later. The `grafeo` extra installs grafeo 0.6 (`grafeo>=0.6.0,<0.7`); the browser-side WASM mode loads the matching `@grafeo-db/wasm` from a CDN. Upgrading from 0.3 with Grafeo:
+Requires Python 3.12 or later. The `grafeo` extra installs grafeo 0.6 (`grafeo>=0.6.2,<0.7`; anywidget-vector 0.4.0 still accepts grafeo 0.6.0 and 0.6.1); the browser-side WASM mode loads the matching `@grafeo-db/wasm` from a CDN. Upgrading from 0.3 with Grafeo:
 see [Upgrading to 0.4](#upgrading-to-04).
 
 ## Quick Start
@@ -344,8 +344,8 @@ credentials in the kernel).
 | Mode | Where queries run | Setup |
 |------|-------------------|-------|
 | `embedded` (default) | In Python, on a `grafeo.GrafeoDB` | `uv add "anywidget-vector[grafeo]"` and `set_backend("grafeo", client=db)` |
-| `server` | Over HTTP, `POST /query` on [grafeo-server](https://github.com/GrafeoDB/grafeo-server) | `grafeo_server_url="http://localhost:7474"`; start the server with `--cors-origins` so the notebook's origin may call it |
-| `wasm` | In the browser, in-memory | Nothing to install: `@grafeo-db/wasm` 0.6.0 loads from the jsDelivr CDN on the first query (the only code the widget loads from a CDN) |
+| `server` | Over HTTP, `POST /query` on [grafeo-server](https://github.com/GrafeoDB/grafeo-server) | `grafeo_server_url="http://localhost:7474"`; start the server with `--cors-origins` so the notebook's origin may call it. Needs grafeo-server 0.6.0 or later (the Grafeo 0.6 engine, which sends decimals as `{"$decimal": "..."}`; the widget turns them into numbers) |
+| `wasm` | In the browser, in-memory | Nothing to install: `@grafeo-db/wasm` 0.6.2 loads from the jsDelivr CDN on the first query (the only code the widget loads from a CDN) |
 
 ```python
 import grafeo
@@ -390,8 +390,8 @@ The distance metrics of a Grafeo vector index (`cosine`, `euclidean`, `dot_produ
 same values as the widget's `distance_metric` and `compute_distances()`.
 
 The browser engine version is set in one place, `GRAFEO_WASM_VERSION` in
-`src/anywidget_vector/backends/grafeo/embed.js`, and moves in lockstep with the `grafeo` extra. Before a bump,
-run `node tests/js/wasm_smoke.mjs <unpacked @grafeo-db/wasm package>`.
+`src/anywidget_vector/backends/grafeo/embed.ts`, and moves in lockstep with the `grafeo` extra. Before a bump,
+run `node tests/js/wasm_smoke.ts <unpacked @grafeo-db/wasm package>`.
 
 ### Upgrading to 0.4