chore: Prepare for 0.5 release (#431)

* changelog for 0.5

* bump version to 0.5.0

* update changelog

* bump 0.5

* fix link

* add old/new material

* wip blog

* include changelog

* include changelog

* fix headings

* improved sentinel example text

* Add more screenshots

* add sentinel images to readme

* rename

* wording

Author: kylebarron

.release-please-manifest.json

@@ -1,6 +1,6 @@
 {
-  ".": "0.3.0",
-  "packages/affine": "0.3.0",
-  "packages/geotiff": "0.3.0",
-  "packages/morecantile": "0.3.0"
+  ".": "0.5.0",
+  "packages/affine": "0.5.0",
+  "packages/geotiff": "0.5.0",
+  "packages/morecantile": "0.5.0"
 }

CHANGELOG.md

@@ -1,8 +1,68 @@
 # Changelog
 
+
+## Unreleased
+
+* feat: Create `@developmentseed/geozarr` package and define zod schema by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/395
+* feat: Create zarr-tileset as implementation of generic tile traversal by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/397
+* feat: Initial, most basic GeoZarr example by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/399
+* feat: Web Mercator axis-aligned cutline support by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/424
+
+## v0.5.0 - 2026-05-16
+
+### Breaking Changes
+
+* refactor!: Generalize tile traversal interface by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/391 and refactor(deck.gl-raster)!: Finish generalizing tile traversal by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/394
+    * This is only a breaking change if you were using the low-level tile traversal primitives exported by `@developmentseed/deck.gl-raster`. There were no breaking changes to the `COGLayer`.
+
+### New Features
+
+- New `MultiCOGLayer`:
+    * feat: Initial work for `MultiCOGLayer`: cross-resolution tileset for sentinel/landsat by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/408
+    * feat: Debug view for MultiCOGLayer by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/410
+    * fix: Fix edge tile rendering in MultiCOGLayer by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/411
+    * fix: Define `byteLength` on MultiCOG internal tile data by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/413
+    * fix: Ensure we reset state when changing sources in MultiCOGLayer by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/414
+    * fix: Filter out nodata pixels in Sentinel-2 example by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/415
+* feat: Pass any `TextureSource` to `MeshTextureLayer` by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/369
+* feat(geotiff): Support multi-tile fetching by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/406
+
+### Fixes
+
+* fix: Turn off lighting/`material` by default by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/423
+* fix: Remove alignment workarounds, bump to deck/luma 9.3 by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/419
+* fix: Move `lerc` to non-dev dependencies by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/367
+* fix: Fix black flash when panning by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/377
+
+### Performance
+
+* perf: Avoid unnecessary mesh recomputation by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/370
+* perf: Cache the result of bounding volume computation per RasterTileNode by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/371
+
+### Other
+
+* feat: Print tile xyz index in COG Layer debug mode by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/378
+* ci: pin GitHub Actions to SHA digests (fix zizmor unpinned-uses) by @lhoupert in https://github.com/developmentseed/deck.gl-raster/pull/390
+* refactor: move projection utils from `deck.gl-geotiff` to `proj` package by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/398
+* fix: Use `MapboxOverlayProps` instead of `DeckProps` in example to fix type check by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/400
+* chore: deduplicate tsconfigs in examples folder by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/426
+* ci: Ensure we typecheck examples by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/427
+* ci: Apply typechecking to source packages on CI by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/430
+* ci: deploy docs only on release tags by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/433
+* feat: Clean up sentinel-2 example by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/437
+* docs: Add link from example cards to code source by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/439
+* docs: Update screenshots in docs by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/440
+* docs: Update examples to link back to docs website by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/441
+
+### New Contributors
+
+* @lhoupert made their first contribution in https://github.com/developmentseed/deck.gl-raster/pull/390
+
+**Full Changelog**: https://github.com/developmentseed/deck.gl-raster/compare/v0.4.0...v0.5.0
+
 ## v0.4.0 - 2026-03-20
 
-## What's Changed
+### What's Changed
 
 * feat: expose maxRequests on COGLayer by @maxrjones in https://github.com/developmentseed/deck.gl-raster/pull/333
 * fix: Bump proj4 to fix web mercator projection by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/346
@@ -13,7 +73,8 @@
 * fix: Support TileLayer refinement strategies by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/354
 * feat: add ndvi filter slider to NAIP-mosaic example by @kylebarron in https://github.com/developmentseed/deck.gl-raster/pull/357
 
-## New Contributors
+### New Contributors
+
 * @maxrjones made their first contribution in https://github.com/developmentseed/deck.gl-raster/pull/333
 * @aboydnw made their first contribution in https://github.com/developmentseed/deck.gl-raster/pull/348
 

README.md

@@ -15,3 +15,19 @@ Fully client-side with direct image loading, no server required.
 
 <p align="center"><em><b>1.3GB</b> Land Cover COG rendered in the browser with <b>no server</b></em>: <a href="https://developmentseed.org/deck.gl-raster/examples/land-cover/">Live demo.</a></p>
 
+[![](docs/static/img/sentinel-2-examples-card.jpg)][sentinel-2-example]
+Torres del Paine, Chile: Sentinel-2 Infrared False Color composite
+
+[![](docs/static/img/sentinel-2-sossusvlei.jpg)][sentinel-2-example]
+Sossusvlei, Namibia: Sentinel-2 Agriculture composite
+
+[![](docs/static/img/sentinel-2-kamchatka.jpg)][sentinel-2-example]
+Kamchatka, Russia: Sentinel-2 Vegetation composite
+
+[![](docs/static/img/sentinel-2-mt-etna.jpg)][sentinel-2-example]
+Mt Etna, Italy: Sentinel-2 SWIR composite
+
+[![](docs/static/img/sentinel-2-nile-delta.jpg)][sentinel-2-example]
+Nile Delta, Egypt: Sentinel-2 Agriculture composite
+
+[sentinel-2-example]: https://developmentseed.org/deck.gl-raster/examples/sentinel-2/

docs/.gitignore

@@ -1,4 +1,5 @@
 api/*
+guides/changelog.md
 
 # Dependencies
 /node_modules

docs/blog/multi-band-cog.md

@@ -0,0 +1,69 @@
+---
+slug: multi-band-cog
+title: Multi-band COG support
+authors:
+  - kylebarron
+tags: [release]
+image: ../static/img/sentinel-2-examples-card.jpg
+---
+
+deck.gl-raster now supports rendering multi-band [Cloud-Optimized GeoTIFFs][cogeo] (COGs), commonly found for satellite imagery data like Landsat or Sentinel-2.
+
+[cogeo]: https://cogeo.org/
+
+![](../static/img/sentinel-2-examples-card.jpg)
+
+<!-- truncate -->
+
+## Multi-band COG support
+
+Many COGs are distributed as a collection of multiple inter-related files, where they all represent the same scene with the same spatial extent. For example, [Sentinel-2][s2-aws-bucket] or [Landsat](https://registry.opendata.aws/usgs-landsat/) images are distributed in this type of COG layout.
+
+We have a new [`MultiCOGLayer`] to support rendering this type of COG source. This layer is intended to be used whenever multiple separate COG files represent **one single composite image**. If you want to render multiple image sources as a mosaic, use the [`MosaicLayer`].
+
+[s2-aws-bucket]: https://registry.opendata.aws/sentinel-2-l2a-cogs/
+[`MultiCOGLayer`]: https://developmentseed.org/deck.gl-raster/api/deck-gl-geotiff/classes/MultiCOGLayer/
+[`MosaicLayer`]: https://developmentseed.org/deck.gl-raster/api/deck-gl-geotiff/classes/MosaicLayer/
+
+The `MultiCOGLayer` abstracts many technical implementation details away from the end user. When the source has bands at different resolutions, it will automatically resample across mixed band resolutions — _all on the GPU_.
+
+For example, consider rendering a Sentinel-2 vegetation composite with the near-infrared, short-wave infrared, and red bands. The short-wave band's finest pixel resolution is 20 meters while the other bands have a finest pixel resolution of 10 meters. The `MultiCOGLayer` will _automatically upsample_ the short-wave infrared band up to 10m so that the three can be rendered together at full resolution.
+
+We have a [new example application][sentinel-2-example] to visualize various selected Sentinel-2 scenes, directly from the [Sentinel-2 AWS Open Data bucket][s2-aws-bucket]. Below are screenshots from this example application.
+
+[![](../static/img/sentinel-2-examples-card.jpg)][sentinel-2-example]
+Torres del Paine, Chile: Infrared False Color composite
+
+[![](../static/img/sentinel-2-sossusvlei.jpg)][sentinel-2-example]
+Sossusvlei, Namibia: Agriculture composite
+
+[![](../static/img/sentinel-2-kamchatka.jpg)][sentinel-2-example]
+Kamchatka, Russia: Vegetation composite
+
+[![](../static/img/sentinel-2-mt-etna.jpg)][sentinel-2-example]
+Mt Etna, Italy: SWIR composite
+
+[![](../static/img/sentinel-2-nile-delta.jpg)][sentinel-2-example]
+Nile Delta, Egypt: Agriculture composite
+
+[sentinel-2-example]: https://developmentseed.org/deck.gl-raster/examples/sentinel-2/
+
+## Fix "muted" colors
+
+Previously we had unintentionally been "muting" colors. This is now fixed to default to rendering input colors as-is without any additional post-processing.
+
+| Before                                      | After                                       |
+| ------------------------------------------- | ------------------------------------------- |
+| ![](../static/img/material-default-old.jpg) | ![](../static/img/material-default-new.jpg) |
+
+This was happening because deck.gl applied a default [`Material`](https://deck.gl/docs/developer-guide/using-effects#material-settings) to renderings. This is useful for 3D visualizations, but in our case it makes more sense to turn the material off by default.
+
+## Support deck.gl v9.3
+
+In order to support the recent [deck.gl v9.3 release](https://deck.gl/docs/whats-new#deckgl-v93), we removed some previous workarounds around WebGL texture byte alignment. See [#419](https://github.com/developmentseed/deck.gl-raster/pull/419) for more information.
+
+## Internal refactors for future Zarr & GeoZarr support
+
+Previously, the internal "tile traversal" code, which tells deck.gl where to render each tile loaded from an image source, was tied to Cloud-Optimized GeoTIFFs and the [Tile Matrix Set specification](https://www.ogc.org/standards/tms).
+
+We performed some [internal](https://github.com/developmentseed/deck.gl-raster/pull/391) [refactors](https://github.com/developmentseed/deck.gl-raster/pull/394) to generalize this interface. We now have an initial functional prototype of [GeoZarr](https://geozarr.org/) rendering, which will be properly released soon.

docs/docusaurus.config.ts

@@ -90,6 +90,7 @@ const crossPackageLinks: Record<string, Record<string, string>> = {
     COGLayer: `${BASE_DECK_GL_GEOTIFF}/classes/COGLayer/`,
     MosaicLayer: `${BASE_DECK_GL_GEOTIFF}/classes/MosaicLayer/`,
     MosaicTileset2D: `${BASE_DECK_GL_GEOTIFF}/classes/MosaicTileset2D/`,
+    MultiCOGLayer: `${BASE_DECK_GL_GEOTIFF}/classes/MultiCOGLayer/`,
   },
   "@developmentseed/deck.gl-raster": {
     RasterLayer: `${BASE_DECK_GL_RASTER}/classes/RasterLayer/`,
@@ -104,7 +105,6 @@ const crossPackageLinks: Record<string, Record<string, string>> = {
     Decoder: `${BASE_GEOTIFF}/type-aliases/Decoder/`,
     DecoderMetadata: `${BASE_GEOTIFF}/type-aliases/DecoderMetadata/`,
     DecoderPoolOptions: `${BASE_GEOTIFF}/type-aliases/DecoderPoolOptions/`,
-    ProjJson: `${BASE_GEOTIFF}/type-aliases/ProjJson/`,
     parseColormap: `${BASE_GEOTIFF}/functions/parseColormap/`,
   },
   "@developmentseed/morecantile": {
@@ -222,6 +222,7 @@ const config: Config = {
     ...typedocPlugins,
     ...contentDocsPlugins,
     "@cmfcmf/docusaurus-search-local",
+    "./plugins/changelog.js",
   ],
 
   presets: [

docs/plugins/changelog.js

@@ -0,0 +1,28 @@
+const { readFileSync, writeFileSync } = require("node:fs");
+const { resolve } = require("node:path");
+
+const FRONTMATTER = `\
+---
+sidebar_position: 100
+sidebar_label: Changelog
+slug: /changelog
+---
+
+`;
+
+/**
+ * Docusaurus plugin that copies the root CHANGELOG.md into the guides
+ * directory with Docusaurus frontmatter prepended. This keeps the changelog
+ * on the docs site without requiring manual sync.
+ */
+module.exports = function changelogPlugin(_context, _options) {
+  return {
+    name: "changelog",
+    async loadContent() {
+      const src = resolve(__dirname, "../../CHANGELOG.md");
+      const dest = resolve(__dirname, "../guides/changelog.md");
+      const content = readFileSync(src, "utf-8");
+      writeFileSync(dest, FRONTMATTER + content);
+    },
+  };
+};