Merge branch 'master' into codex/touch-double-tap-zoom

Author: charlieforward9

AGENTS.md

@@ -0,0 +1,74 @@
+# Repository Guidance
+
+This file applies to the entire `deck.gl` repository. More specific `AGENTS.md` files in
+subdirectories may add local guidance.
+
+## Setup Commands
+
+- Install dependencies from the repo root: `yarn`
+- Build packages: `yarn build`
+- Run lint: `yarn lint`
+- Run all tests: `yarn test`
+- Run headless tests: `yarn test-headless`
+- Run render tests: `yarn test-render`
+- Run browser tests: `yarn test-browser`
+- Run website checks: `yarn test-website`
+- Use the exact script names from `package.json`; do not substitute spaced forms such as
+  `yarn test headless`.
+
+## Before Committing
+
+- Run the most relevant tests for the changed packages, integrations, examples, or docs.
+- Run `yarn lint` for JavaScript and TypeScript changes. If lint failures are unrelated existing
+  issues, call that out explicitly instead of hiding it.
+- If dependencies or package metadata changed, run `yarn` in the repo root and include any
+  `yarn.lock` updates.
+- Do not reformat files you are not otherwise changing. Keep formatting-only churn separate from
+  logic changes when practical.
+
+## Ready For Merge
+
+When asked to "get ready for merge", do a full merge-readiness pass:
+
+- Audit the public API surface touched by the change. Add or update TSDoc for every new or changed
+  public class, function, method, property, and type.
+- Do a documentation pass when behavior, public API, examples, or migration guidance changed.
+  Include relevant module docs, examples, sidebars, `docs/whats-new.md`, and upgrade or migration
+  guide content.
+- Keep upgrade guides focused on breaking changes, removals, and deprecations. Put new-feature
+  notes in the appropriate module docs or release notes instead.
+- Run `yarn` in the repo root so workspace metadata and `yarn.lock` are up to date, especially
+  after any `package.json` change.
+- Run `yarn build` as the repo-wide type, declaration, and package build gate.
+- Run `yarn lint` for the final lint and formatting gate, then review the resulting diff.
+- Run the relevant tests for the changed packages, examples, integrations, and docs/website wiring.
+  Typical commands are `yarn test`, `yarn test-headless`, `yarn test-render`, `yarn test-browser`,
+  and `yarn test-website`.
+- For website or docs changes, run the website check from the repo root with `yarn test-website`.
+- Prepare a copyable Markdown PR description based on the branch diff compared to `master`. Start
+  with the PR goals, then list the actual changes and validation.
+- In the final handoff, call out which merge-readiness gates passed, which were not run, and any
+  remaining risk or unrelated pre-existing failures.
+
+## Code Style
+
+- Prefer TypeScript and ES module syntax.
+- Match the surrounding file style. In source files, use single quotes and semicolons.
+- Never abbreviate variable names. Use camelCase for variables, functions, and fields; PascalCase
+  for types and classes; and CAPITAL_CASE for constants.
+- Prefer verb-noun names for functions and methods.
+- File names should be kebab-case unless an existing local convention differs.
+
+## Dependencies
+
+- Be conservative with new external dependencies. Add one only when it provides meaningful
+  capability, not just a small utility.
+- Prefer vis.gl ecosystem packages when they fit the layering. Lower-level math or utility modules
+  should not depend on deck.gl.
+- Prefer math.gl modules for math helpers.
+- Avoid lodash-style dependencies for simple operations.
+
+## Investigation
+
+- Do not fix problems by adding caches. Investigate why the problem occurs and address the root
+  cause.

docs/api-reference/core/deck.md

@@ -52,6 +52,8 @@ The canvas to render into. Can be either a HTMLCanvasElement or the element id.
 
 luma.gl Device used to manage the application's connection with the GPU. Will be auto-created if not supplied.
 
+When a `Device` is supplied, Deck does not destroy it when finalized. While the `Deck` instance is active, Deck owns the `device.props.onResize` callback for the active render canvas context; use `DeckProps.onResize` to observe Deck canvas resizes.
+
 #### `deviceProps` ([DeviceProps](https://luma.gl/docs/api-reference/core/device#deviceprops) | [WebGLDeviceProps](https://luma.gl/docs/api-reference/webgl/#webgldeviceprops)) {#deviceprops}
 
 Options used for creating a new luma.gl GPU [Device](https://luma.gl/docs/api-reference/core/device). 
@@ -551,6 +553,7 @@ Receives arguments:
 * `size`
   - `width` (number) - the new width of the deck canvas, in client pixels
   - `height` (number) - the new height of the deck canvas, in client pixels
+* `canvasContext` ([CanvasContext](https://luma.gl/docs/api-reference/core/canvas-context), optional) - the luma.gl canvas context that reported the resize
 
 
 #### `onBeforeRender` (Function) {#onbeforerender}

examples/basemap-browser/package.json

@@ -27,6 +27,6 @@
     "@types/react-dom": "^18.2.0",
     "@types/stats.js": "^0.17.4",
     "typescript": "^4.6.0",
-    "vite": "^7.3.1"
+    "vite": "^7.3.3"
   }
 }

examples/experimental/bezier/package.json

@@ -15,6 +15,6 @@
   },
   "devDependencies": {
     "typescript": "^4.6.0",
-    "vite": "^7.3.1"
+    "vite": "^7.3.3"
   }
 }

examples/experimental/h3-grid/package.json

@@ -17,6 +17,6 @@
   },
   "devDependencies": {
     "typescript": "^4.6.0",
-    "vite": "^7.3.1"
+    "vite": "^7.3.3"
   }
 }

examples/experimental/interleaved-buffer/package.json

@@ -14,6 +14,6 @@
   },
   "devDependencies": {
     "typescript": "^4.6.0",
-    "vite": "^7.3.1"
+    "vite": "^7.3.3"
   }
 }

examples/experimental/tfjs/package.json

@@ -14,6 +14,6 @@
   },
   "devDependencies": {
     "typescript": "^4.6.0",
-    "vite": "^7.3.1"
+    "vite": "^7.3.3"
   }
 }

examples/get-started/pure-js/apple-maps/package.json

@@ -13,6 +13,6 @@
     "@deck.gl/layers": "^9.0.0"
   },
   "devDependencies": {
-    "vite": "^7.3.1"
+    "vite": "^7.3.3"
   }
 }

examples/get-started/pure-js/arcgis/package.json

@@ -15,6 +15,6 @@
     "@deck.gl/layers": "^9.0.0"
   },
   "devDependencies": {
-    "vite": "^7.3.1"
+    "vite": "^7.3.3"
   }
 }

examples/get-started/pure-js/basic/package.json

@@ -13,6 +13,6 @@
     "@deck.gl/layers": "^9.0.0"
   },
   "devDependencies": {
-    "vite": "^7.3.1"
+    "vite": "^7.3.3"
   }
 }