Merge branch 'main' into kyle/rfc

Author: kylebarron

.env.example

@@ -0,0 +1,2 @@
+# Stately Inspector is enabled when this is set to true
+XSTATE_INSPECT=false

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/workflows/build-binder-image.yml

@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: cache binder build on mybinder.org
-        uses: jupyterhub/repo2docker-action@b3cd89ff99f95b00abb5b4db27ec49bb4d3f8c85
+        uses: jupyterhub/repo2docker-action@c26a270c5694cd5b7f6121d6360da321d114ddc5
         with:
           NO_PUSH: true
           MYBINDERORG_TAG: ${{ github.event.ref }} # This builds the container on mybinder.org with the branch that was pushed on.

.github/workflows/test-js.yml

@@ -3,14 +3,13 @@ name: CI
 on:
   push:
     branches:
-      - 'main'
+      - "main"
   pull_request:
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
-
 jobs:
   lint-and-test:
     runs-on: ubuntu-latest
@@ -39,10 +38,10 @@ jobs:
         run: npm install
 
       - name: Prettier check
-        run: npm run fmt:check
+        run: npm run prettier:check
 
-      - name: Type check
-        run: npm run typecheck
+      - name: Lint check
+        run: npm run lint
 
       - name: Test
         run: npm run test

.github/workflows/test.yml

@@ -79,6 +79,16 @@ jobs:
       - name: Run tests
         run: poetry run pytest
 
+      - name: Run tests (all deps)
+        run: |
+          poetry install -E geopandas -E cli
+          poetry run pytest
+
+      # Ensure docs build without warnings
+      - name: Check docs
+        if: matrix.python-version == 3.9
+        run: poetry run mkdocs build --strict
+
       - name: Cache pre-commit virtualenvs
         uses: actions/cache@v4
         if: matrix.python-version == 3.9

.gitignore

@@ -24,3 +24,8 @@ static
 .pnp.loader.mjs
 node_modules
 *.h5
+
+# Ignore environment variable files
+.env
+.env.local
+.env.*.local

.pre-commit-config.yaml

@@ -15,11 +15,11 @@ repos:
       - id: trailing-whitespace
       - id: end-of-file-fixer
       - id: check-added-large-files
-        args: ['--maxkb=5500']
+        args: ["--maxkb=5500"]
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.1.3
+    rev: v0.3.4
     hooks:
       - id: ruff
-        args: ['--fix']
+        args: ["--fix"]
       - id: ruff-format

CHANGELOG.md

@@ -1,44 +1,176 @@
 # Changelog
 
+## [0.9.3] - 2024-05-27
+
+### Fixes :bug:
+
+- Fix reprojecting GeoArrow input by @kylebarron in https://github.com/developmentseed/lonboard/pull/532
+
+**Full Changelog**: https://github.com/developmentseed/lonboard/compare/v0.9.2...v0.9.3
+
+## [0.9.2] - 2024-05-14
+
+### Fixes :bug:
+
+- Reverse the layer order for automatically split geometry by @RaczeQ in https://github.com/developmentseed/lonboard/pull/516
+
+### What's Changed
+
+- Perf: Use ravel, not flatten, for numpy to pyarrow by @kylebarron in https://github.com/developmentseed/lonboard/pull/512
+- Update docstring in as_html by @kylebarron in https://github.com/developmentseed/lonboard/pull/519
+- Add type checks to fly_to by @kylebarron in https://github.com/developmentseed/lonboard/pull/521
+- Add pypi classifiers by @kylebarron in https://github.com/developmentseed/lonboard/pull/523
+
+### New Contributors
+
+- @RaczeQ made their first contribution in https://github.com/developmentseed/lonboard/pull/516
+
+**Full Changelog**: https://github.com/developmentseed/lonboard/compare/v0.9.1...v0.9.2
+
+## [0.9.1] - 2024-05-07
+
+### Fixes :bug:
+
+- Fix parquet-wasm WASM version mismatch by @kylebarron in https://github.com/developmentseed/lonboard/pull/508
+
+**Full Changelog**: https://github.com/developmentseed/lonboard/compare/v0.9.0...v0.9.1
+
+## [0.9.0] - 2024-05-06
+
+### New! :sparkles:
+
+- Direct [DuckDB Spatial](https://duckdb.org/docs/extensions/spatial.html) integration. Refer to the [DuckDB example notebook](https://developmentseed.org/lonboard/latest/examples/duckdb/) and the [DuckDB page](https://developmentseed.org/lonboard/latest/ecosystem/duckdb/) in the documentation. by @kylebarron in https://github.com/developmentseed/lonboard/pull/498
+- Add [overture buildings notebook](https://developmentseed.org/lonboard/latest/examples/overture-maps/) by @kylebarron in https://github.com/developmentseed/lonboard/pull/479
+- Adding [PathStyleExtension](https://developmentseed.org/lonboard/latest/api/layer-extensions/path-style-extension/) code by @shriv in https://github.com/developmentseed/lonboard/pull/487
+- Handle mixed geometry types in `viz` by @kylebarron in https://github.com/developmentseed/lonboard/pull/495
+- Render map as static HTML file by @kylebarron in https://github.com/developmentseed/lonboard/pull/474. You can use `Map.as_html` to render a map in notebook environments that support HTML but not widgets.
+- Improved integration with [geoarrow-pyarrow](https://geoarrow.org/geoarrow-python/main/pyarrow.html) by @kylebarron in https://github.com/developmentseed/lonboard/pull/470
+
+### Fixes :bug:
+
+- Updated Map keyword arguments by @kylebarron in https://github.com/developmentseed/lonboard/pull/496
+- validate basemap style is a url by @kylebarron in https://github.com/developmentseed/lonboard/pull/497
+
+### New Contributors
+
+- @willemarcel made their first contribution in https://github.com/developmentseed/lonboard/pull/486
+- @shriv made their first contribution in https://github.com/developmentseed/lonboard/pull/487
+
+**Full Changelog**: https://github.com/developmentseed/lonboard/compare/v0.8.0...v0.9.0
+
+## [0.8.0] - 2024-04-05
+
+### New! :sparkles:
+
+- A new [`PolygonLayer`](https://developmentseed.org/lonboard/v0.8.0/api/layers/polygon-layer/)! This layer renders polygon outlines for easier visibility. @kylebarron in https://github.com/developmentseed/lonboard/pull/330
+- An example using `PolygonLayer` by @naomatheus in https://github.com/developmentseed/lonboard/pull/351
+- Sync view state between JS and Python by @kylebarron in https://github.com/developmentseed/lonboard/pull/448
+- Support geoarrow array input into `viz()` by @kylebarron in https://github.com/developmentseed/lonboard/pull/427
+- Internal architecture documentation by @kylebarron in https://github.com/developmentseed/lonboard/pull/450
+
+### Fixes :bug:
+
+- Fix CLI with unset `geometry_name` by @kylebarron in https://github.com/developmentseed/lonboard/pull/451
+
+**Full Changelog**: https://github.com/developmentseed/lonboard/compare/v0.7.1...v0.8.0
+
+## [0.7.1] - 2024-03-22
+
+### Fixes :bug:
+
+- Fix CLI with geopackage files by @kylebarron in https://github.com/developmentseed/lonboard/pull/434
+
+**Full Changelog**: https://github.com/developmentseed/lonboard/compare/v0.7.0...v0.7.1
+
+## [0.7.0] - 2024-03-21
+
+### New! :sparkles:
+
+- There's a [new command-line interface (CLI)](https://developmentseed.org/lonboard/v0.7.0/cli)! Use the `lonboard` command to quickly visualize one or more data files readable by GDAL! For example: `lonboard admins.geojson features.gpkg`. By @kylebarron in https://github.com/developmentseed/lonboard/pull/379
+- Type hinting for constructors and `from_geopandas` method. This should make it easier to pass the correct parameters into layers. This has been tested to work in IDEs like VSCode, but unfortunately appears not to work in JupyterLab. By @kylebarron in https://github.com/developmentseed/lonboard/pull/399
+
+  ![Type hints are now supported in constructors.](assets/type-hints-constructor.jpg)
+
+- Warn on missing CRS. One of the most common reasons that you might see an empty map is from accidentally visualizing data that is not in EPSG 4326 (longitude-latitude). We now emit a warning for data that doesn't have a CRS defined on the data. By @kylebarron in https://github.com/developmentseed/lonboard/pull/395.
+- Lonboard is [now on `conda-forge`](https://prefix.dev/channels/conda-forge/packages/lonboard)! Install with `conda install -c conda-forge lonboard`. By @giswqs in https://github.com/developmentseed/lonboard/pull/223
+- Add [PointCloudLayer](https://developmentseed.org/lonboard/v0.7.0/api/layers/point-cloud-layer/). By @kylebarron in https://github.com/developmentseed/lonboard/pull/396
+- Add [fly-to map action](https://developmentseed.org/lonboard/v0.7.0/api/map/#lonboard.Map.fly_to) to "fly" the map to a new location. By @kylebarron in https://github.com/developmentseed/lonboard/pull/408
+- [Docs showcase page](https://developmentseed.org/lonboard/v0.7.0/examples/) by @kylebarron in https://github.com/developmentseed/lonboard/pull/401
+- Improve default colors in [`viz`](https://developmentseed.org/lonboard/v0.7.0/api/viz/). We now attempt to apply some basic styling onto data passed into `viz`. This will likely further improve in the future. By @kylebarron in https://github.com/developmentseed/lonboard/pull/389
+
+### Fixes :bug:
+
+- Set exported HTML height to 100% by @kylebarron in https://github.com/developmentseed/lonboard/pull/377
+- Raise error on single input to MultiRangeSlider by @kylebarron in https://github.com/developmentseed/lonboard/pull/367
+- Fix pandas `to_numeric` FutureWarning by @kylebarron in https://github.com/developmentseed/lonboard/pull/368
+- Fix viewing polygons in local html files by @kylebarron in https://github.com/developmentseed/lonboard/pull/387
+- Fix: fix sliced array input for reprojection by @kylebarron in https://github.com/developmentseed/lonboard/pull/391
+- Fix: Don't reproject for epsg:4326 input by @kylebarron in https://github.com/developmentseed/lonboard/pull/392
+- Fix: Fix weighted centroid calculation by @kylebarron in https://github.com/developmentseed/lonboard/pull/393
+- Fix `viz()` with `__geo_interface__` input by @kylebarron in https://github.com/developmentseed/lonboard/pull/426
+- Add DataFilterExtension notebook to website by @kylebarron in https://github.com/developmentseed/lonboard/pull/362
+- Allow non-compliant geoarrow CRS metadata by @kylebarron in https://github.com/developmentseed/lonboard/pull/369
+- Automatically parse geoarrow.wkb to native geoarrow by @kylebarron in https://github.com/developmentseed/lonboard/pull/372
+- Parse GeoParquet metadata by @kylebarron in https://github.com/developmentseed/lonboard/pull/407
+- CLI: 'crs' in geoparquet metadata should be optional. by @jwass in https://github.com/developmentseed/lonboard/pull/411
+
+### Other changes
+
+- Creating a new user bug report by @emmalu in https://github.com/developmentseed/lonboard/pull/386
+- Update epic template by @emmalu in https://github.com/developmentseed/lonboard/pull/382
+- NormalAccessor by @naomatheus in https://github.com/developmentseed/lonboard/pull/376
+- Conda: Try including `manifest.in` file for `static` folder inclusion by @kylebarron in https://github.com/developmentseed/lonboard/pull/421
+- Switch to animated hero image by @kylebarron in https://github.com/developmentseed/lonboard/pull/423
+- Add CRS to GeoDataFrame in notebook examples by @kylebarron in https://github.com/developmentseed/lonboard/pull/419
+
+## New Contributors
+
+- @emmalu made their first contribution in https://github.com/developmentseed/lonboard/pull/382
+- @naomatheus made their first contribution in https://github.com/developmentseed/lonboard/pull/376
+- @jwass made their first contribution in https://github.com/developmentseed/lonboard/pull/411
+- @giswqs made their first contribution in https://github.com/developmentseed/lonboard/pull/223
+
+**Full Changelog**: https://github.com/developmentseed/lonboard/compare/v0.6.0...v0.7.0
+
 ## [0.6.0] - 2024-02-13
 
 ### New! :sparkles:
 
-* DataFilterExtension by @kylebarron in https://github.com/developmentseed/lonboard/pull/278
-* Multi-range sliders for DataFilterExtension by @kylebarron in https://github.com/developmentseed/lonboard/pull/340
-* BitmapLayer and BitmapTileLayer by @kylebarron in https://github.com/developmentseed/lonboard/pull/288
-* Improved GeoArrow interop by @kylebarron in https://github.com/developmentseed/lonboard/pull/308
-* Allow passing a positional `layers` object into `Map` by @kylebarron in https://github.com/developmentseed/lonboard/pull/319
-* GeoArrow-based multithreaded coordinate reprojection by @kylebarron in https://github.com/developmentseed/lonboard/pull/337
-* Support `pyarrow.Table` with `geoarrow.pyarrow` extension types as geometry columns by @jorisvandenbossche in https://github.com/developmentseed/lonboard/pull/218
-* Add ecosystem/integrations documentation by @kylebarron in https://github.com/developmentseed/lonboard/pull/350
+- DataFilterExtension by @kylebarron in https://github.com/developmentseed/lonboard/pull/278
+- Multi-range sliders for DataFilterExtension by @kylebarron in https://github.com/developmentseed/lonboard/pull/340
+- BitmapLayer and BitmapTileLayer by @kylebarron in https://github.com/developmentseed/lonboard/pull/288
+- Improved GeoArrow interop by @kylebarron in https://github.com/developmentseed/lonboard/pull/308
+- Allow passing a positional `layers` object into `Map` by @kylebarron in https://github.com/developmentseed/lonboard/pull/319
+- GeoArrow-based multithreaded coordinate reprojection by @kylebarron in https://github.com/developmentseed/lonboard/pull/337
+- Support `pyarrow.Table` with `geoarrow.pyarrow` extension types as geometry columns by @jorisvandenbossche in https://github.com/developmentseed/lonboard/pull/218
+- Add ecosystem/integrations documentation by @kylebarron in https://github.com/developmentseed/lonboard/pull/350
 
 ### Fixes :bug:
 
-* Add font to index.css to fix static HTML export by @jtmiclat in https://github.com/developmentseed/lonboard/pull/284
-* Fix displaying tooltip for first row by @kylebarron in https://github.com/developmentseed/lonboard/pull/287
-* accept matplotlib colormap input to apply_cmap by @kylebarron in https://github.com/developmentseed/lonboard/pull/289
-* Use preferred OSM tile url by @kylebarron in https://github.com/developmentseed/lonboard/pull/290
-* set max zoom on osm layer by @kylebarron in https://github.com/developmentseed/lonboard/pull/291
-* Update contributor docs by @kylebarron in https://github.com/developmentseed/lonboard/pull/316
-* Check epsg:4326 bounds in layer creation by @kylebarron in https://github.com/developmentseed/lonboard/pull/317
-* add reference for installing from source by @kylebarron in https://github.com/developmentseed/lonboard/pull/318
-* Fix inferring number of rows per chunk by @kylebarron in https://github.com/developmentseed/lonboard/pull/327
-* Fix null checks by @kylebarron in https://github.com/developmentseed/lonboard/pull/331
-* Set max number of chunks per layer by @kylebarron in https://github.com/developmentseed/lonboard/pull/332
-* Move accessor length validation to serialization by @kylebarron in https://github.com/developmentseed/lonboard/pull/333
-* Deduplicate serialization for accessors by @kylebarron in https://github.com/developmentseed/lonboard/pull/334
-* Multi-dimensional GPU-based data filtering by @kylebarron in https://github.com/developmentseed/lonboard/pull/335
-* Bump anywidget to 0.9 & simplify Wasm initialization by @kylebarron in https://github.com/developmentseed/lonboard/pull/344
-* Fix null checks by @kylebarron in https://github.com/developmentseed/lonboard/pull/348
-* docs fixes by @kylebarron in https://github.com/developmentseed/lonboard/pull/354
-* Add `DataFilterExtension` example by @kylebarron in https://github.com/developmentseed/lonboard/pull/358
-* fix arc layer default arguments by @kylebarron in https://github.com/developmentseed/lonboard/pull/359
+- Add font to index.css to fix static HTML export by @jtmiclat in https://github.com/developmentseed/lonboard/pull/284
+- Fix displaying tooltip for first row by @kylebarron in https://github.com/developmentseed/lonboard/pull/287
+- accept matplotlib colormap input to apply_cmap by @kylebarron in https://github.com/developmentseed/lonboard/pull/289
+- Use preferred OSM tile url by @kylebarron in https://github.com/developmentseed/lonboard/pull/290
+- set max zoom on osm layer by @kylebarron in https://github.com/developmentseed/lonboard/pull/291
+- Update contributor docs by @kylebarron in https://github.com/developmentseed/lonboard/pull/316
+- Check epsg:4326 bounds in layer creation by @kylebarron in https://github.com/developmentseed/lonboard/pull/317
+- add reference for installing from source by @kylebarron in https://github.com/developmentseed/lonboard/pull/318
+- Fix inferring number of rows per chunk by @kylebarron in https://github.com/developmentseed/lonboard/pull/327
+- Fix null checks by @kylebarron in https://github.com/developmentseed/lonboard/pull/331
+- Set max number of chunks per layer by @kylebarron in https://github.com/developmentseed/lonboard/pull/332
+- Move accessor length validation to serialization by @kylebarron in https://github.com/developmentseed/lonboard/pull/333
+- Deduplicate serialization for accessors by @kylebarron in https://github.com/developmentseed/lonboard/pull/334
+- Multi-dimensional GPU-based data filtering by @kylebarron in https://github.com/developmentseed/lonboard/pull/335
+- Bump anywidget to 0.9 & simplify Wasm initialization by @kylebarron in https://github.com/developmentseed/lonboard/pull/344
+- Fix null checks by @kylebarron in https://github.com/developmentseed/lonboard/pull/348
+- docs fixes by @kylebarron in https://github.com/developmentseed/lonboard/pull/354
+- Add `DataFilterExtension` example by @kylebarron in https://github.com/developmentseed/lonboard/pull/358
+- fix arc layer default arguments by @kylebarron in https://github.com/developmentseed/lonboard/pull/359
 
 ## New Contributors
 
-* @jtmiclat made their first contribution in https://github.com/developmentseed/lonboard/pull/284
-* @jorisvandenbossche made their first contribution in https://github.com/developmentseed/lonboard/pull/218
+- @jtmiclat made their first contribution in https://github.com/developmentseed/lonboard/pull/284
+- @jorisvandenbossche made their first contribution in https://github.com/developmentseed/lonboard/pull/218
 
 **Full Changelog**: https://github.com/developmentseed/lonboard/compare/v0.5.0...v0.6.0
 

DEVELOP.md

@@ -56,10 +56,26 @@ We use ESBuild to bundle into an ES Module, which the Jupyter Widget will then l
 npm run build:watch
 ```
 
+### Environment Variables
+
+To use custom environment variables, copy the example environment file:
+
+```sh
+cp .env.example .env
+```
+
+This file contains the list of environment variables for the JavaScript component, and the build task will use them when available.
+
+**Note: `.env` is in `.gitignore` and should never be committed.**
+
+### Architectural notes
+
 All models on the TypeScript side are combined into a single entry point, which is compiled by ESBuild and loaded by the Python `Map` class. (Refer to the `_esm` key on the `Map` class, which tells Jupyter/ipywidgets where to load the JavaScript bundle.)
 
 Anywidget and its dependency ipywidgets handles the serialization from Python into JS, automatically keeping each side in sync.
 
+State management is implemented using [XState](https://stately.ai/docs/xstate). The app is instrumented with [Stately Inspector](https://stately.ai/docs/inspector), and the use of the [VS Code extension](https://stately.ai/docs/xstate-vscode-extension) is highly recommended.
+
 ## Publishing
 
 Push a new tag to the main branch of the format `v*`. A new version will be published to PyPI automatically.

MANIFEST.in

@@ -0,0 +1 @@
+recursive-include lonboard/static *