chore: Bump to 0.4.0 (#206)

Author: kylebarron

CHANGELOG.md

@@ -1,5 +1,51 @@
 # Changelog
 
+## 0.4.0 - 2026-05-18
+
+### Breaking Changes
+
+* refactor!: Refactor layers to take in Arrow `RecordBatch` input, not `Table` by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/148
+    * **Important**: you must now iterate over the input RecordBatches of your `Table` object, passing in **one RecordBatch to each deck.gl-geoarrow layer**. This makes it explicit that one contiguous `RecordBatch` is associated to one physical deck.gl layer.
+* chore!: Rename NPM package from `@geoarrow/deck.gl-layers` to `@geoarrow/deck.gl-geoarrow` by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/191
+
+### New features
+
+* feat: Support passing in earcut worker pool to SolidPolygonLayer by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/151
+* Expose H3HexagonLayer publicly by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/160
+* feat: Add vectorized props from polygon layer to h3 hexagon layer by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/157
+* feat: Add a5 layer by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/162
+* fix: Ensure separate layer ids by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/163
+* fix: Define attributes object if not already defined by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/165
+* feat: Add simple wrappings of geohash and s2 layers by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/168
+* Freshen up `point` example by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/190
+* ci: Set up trusted publishing by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/173
+* Update README with build instructions for POINT example by @C-Loftus in https://github.com/geoarrow/deck.gl-geoarrow/pull/197
+
+### Bug fixes
+
+* fix scatterplot layer typing by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/154
+* ci: Don't publish npm package with beta string as latest tag by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/156
+* fix: H3HexagonLayer fixes by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/159
+* chore: Ensure earcut worker props are passed down from PolygonLayer by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/161
+
+### Other
+
+* ci: add Dependabot for GitHub Actions version updates by @lhoupert in https://github.com/geoarrow/deck.gl-geoarrow/pull/177
+* chore: Switch to pnpm by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/185
+* chore: Switch to biome for linting and formatting by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/186
+* chore: Update tsconfig by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/187
+* chore: Update build process to match deck.gl-raster by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/188
+* chore: Bump vitest and typescript versions by @kylebarron in https://github.com/geoarrow/deck.gl-geoarrow/pull/189
+
+
+### New Contributors
+
+* @lhoupert made their first contribution in https://github.com/geoarrow/deck.gl-geoarrow/pull/177
+* @dependabot[bot] made their first contribution in https://github.com/geoarrow/deck.gl-geoarrow/pull/181
+* @C-Loftus made their first contribution in https://github.com/geoarrow/deck.gl-geoarrow/pull/197
+
+**Full Changelog**: https://github.com/geoarrow/deck.gl-geoarrow/compare/v0.3.1...v0.4.0
+
 ## [0.3.2] - 2026-04-15
 
 - Deprecate the name `@geoarrow/deck.gl-layers` and prepare the package for renaming to `@geoarrow/deck.gl-geoarrow`.

README.md

@@ -1,7 +1,5 @@
 # @geoarrow/deck.gl-geoarrow
 
-> Note: this project is in the process of renaming from `@geoarrow/deck.gl-layers` to `@geoarrow/deck.gl-geoarrow`. It has not yet been published to NPM under `@geoarrow/deck.gl-geoarrow`.
-
 The easiest, most efficient way to render large geospatial datasets in [deck.gl](https://deck.gl), via [GeoArrow](https://geoarrow.org).
 
 This is just a _glue library_ to deck.gl. It generates the same layer objects as upstream deck.gl does, but uses a [low-level binary interface](https://deck.gl/docs/developer-guide/performance#supply-attributes-directly) for best performance. Using the binary interface directly is really easy to mess up. Instead, the layer classes exposed by `@geoarrow/deck.gl-geoarrow` focus on making the process easy to use and validating user input, and under the hood pass buffers to deck.gl's binary interface.
@@ -12,9 +10,9 @@ This is just a _glue library_ to deck.gl. It generates the same layer objects as
 
 ## Features
 
-- **Fast**: copies binary buffers directly from an [Arrow JS](https://www.npmjs.com/package/apache-arrow) [`Table`](https://arrow.apache.org/docs/js/classes/Arrow_dom.Table.html) object to the GPU using [deck.gl's binary data interface](https://deck.gl/docs/developer-guide/performance#supply-attributes-directly).
+- **Fast**: copies binary buffers directly from an [Arrow JS](https://www.npmjs.com/package/apache-arrow) [`RecordBatch`](https://arrow.apache.org/js/current/classes/Arrow.dom.Table.html#batches) object to the GPU using [deck.gl's binary data interface](https://deck.gl/docs/developer-guide/performance#supply-attributes-directly).
 - **Memory-efficient**: no intermediate data representation and no garbage-collector overhead.
-- **Full layer customization**: Use the same layer properties as in the upstream deck.gl layer documentation. Any _accessor_ (layer property prefixed with `get*`) can be passed an Arrow [`Vector`](https://arrow.apache.org/docs/js/classes/Arrow_dom.Vector.html).
+- **Full layer customization**: Use the same layer properties as in the upstream deck.gl layer documentation. Any _accessor_ (layer property prefixed with `get*`) can be passed an Arrow [`Data`](https://arrow.apache.org/js/current/classes/Arrow.dom.Data.html).
 - **Input validation**. Validation can be turned off via the `_validate` property on most layer types.
 - **Multi-threaded polygon triangulation**. When rendering polygon layers, a process called [polygon triangulation](https://en.wikipedia.org/wiki/Polygon_triangulation) must happen on the CPU before data can be copied to the GPU. Ordinarily, this can block the main thread for several seconds, but the `GeoArrowSolidPolygonLayer` will perform this process off the main thread, on up to 8 web workers.
 - **Progressive rendering support**. For streaming-capable data formats like Arrow IPC and Parquet, you can render a GeoArrow layer per chunk as the data loads.
@@ -33,20 +31,21 @@ With `@geoarrow/deck.gl-geoarrow` specifically, there are two ways to pass these
 
 ### Pre-computed Arrow columns
 
-If you have an Arrow column ([`Vector`](https://arrow.apache.org/docs/js/classes/Arrow_dom.Vector.html) in Arrow JS terminology), you can pass that directly into a layer:
+If you have an Arrow array ([`Data`](https://arrow.apache.org/js/current/classes/Arrow.dom.Data.html) in Arrow JS terminology), you can pass that directly into a layer:
 
 ```ts
 import { Table } from "apache-arrow";
 import { GeoArrowScatterplotLayer } from "@geoarrow/deck.gl-geoarrow";
 
 const table = new Table(...);
+const recordBatch = table.batches[0];
 const deckLayer = new GeoArrowScatterplotLayer({
   id: "scatterplot",
-  data: table,
+  data: recordBatch,
   /// Geometry column
-  getPosition: table.getChild("geometry")!,
+  getPosition: recordBatch.getChild("geometry")!,
   /// Column of type FixedSizeList[3] or FixedSizeList[4], with child type Uint8
-  getFillColor: table.getChild("colors")!,
+  getFillColor: recordBatch.getChild("colors")!,
 });
 ```
 
@@ -59,10 +58,9 @@ GeoArrow layers accept a callback that takes an object with `index` and `data`.
 ```ts
 const deckLayer = new GeoArrowPathLayer({
   id: "geoarrow-path",
-  data: table,
+  data: recordBatch,
   getColor: ({ index, data, target }) => {
-    const recordBatch = data.data;
-    const row = recordBatch.get(index)!;
+    const row = data.get(index)!;
     return COLORS_LOOKUP[row["scalerank"]];
   },
 }),
@@ -88,11 +86,12 @@ import { GeoArrowScatterplotLayer } from "@geoarrow/deck.gl-geoarrow";
 
 const resp = await fetch("url/to/file.arrow");
 const jsTable = await tableFromIPC(resp);
+const recordBatch = jsTable.batches[0];
 const deckLayer = new GeoArrowScatterplotLayer({
   id: "scatterplot",
-  data: jsTable,
+  data: recordBatch,
   /// Replace with the correct geometry column name
-  getPosition: jsTable.getChild("geometry")!,
+  getPosition: recordBatch.getChild("geometry")!,
 });
 ```
 
@@ -111,11 +110,12 @@ const resp = await fetch("url/to/file.parquet");
 const arrayBuffer = await resp.arrayBuffer();
 const wasmTable = readParquet(new Uint8Array(arrayBuffer));
 const jsTable = tableFromIPC(wasmTable.intoIPCStream());
+const recordBatch = jsTable.batches[0];
 const deckLayer = new GeoArrowScatterplotLayer({
   id: "scatterplot",
-  data: jsTable,
+  data: recordBatch,
   /// Replace with the correct geometry column name
-  getPosition: jsTable.getChild("geometry")!,
+  getPosition: recordBatch.getChild("geometry")!,
 });
 ```
 
@@ -134,11 +134,12 @@ const resp = await fetch("url/to/file.parquet");
 const arrayBuffer = await resp.arrayBuffer();
 const wasmTable = readGeoParquet(new Uint8Array(arrayBuffer));
 const jsTable = tableFromIPC(wasmTable.intoTable().intoIPCStream());
+const recordBatch = jsTable.batches[0];
 const deckLayer = new GeoArrowScatterplotLayer({
   id: "scatterplot",
-  data: jsTable,
+  data: recordBatch,
   /// Replace with the correct geometry column name
-  getPosition: jsTable.getChild("geometry")!,
+  getPosition: recordBatch.getChild("geometry")!,
 });
 ```
 
@@ -157,11 +158,12 @@ const resp = await fetch("url/to/file.fgb");
 const arrayBuffer = await resp.arrayBuffer();
 const wasmTable = readFlatGeobuf(new Uint8Array(arrayBuffer));
 const jsTable = tableFromIPC(wasmTable.intoTable().intoIPCStream());
+const recordBatch = jsTable.batches[0];
 const deckLayer = new GeoArrowScatterplotLayer({
   id: "scatterplot",
-  data: jsTable,
+  data: recordBatch,
   /// Replace with the correct geometry column name
-  getPosition: jsTable.getChild("geometry")!,
+  getPosition: recordBatch.getChild("geometry")!,
 });
 ```