@kahwee/sf-map-svg 3.1.0 → 4.0.0

package/CHANGELOG.md

@@ -4,6 +4,11 @@ User-visible changes are recorded here. Unreleased entries describe changes on `
 
 ## Unreleased
 
+## 4.0.0 — 2026-09-28
+
+- Breaking: require Node 24 or newer for server rendering and development. Validate the minimum supported major alongside Node 26 in CI; browser runtime requirements are unchanged.
+- No map API, geographic data, rendering, or animation changes. Existing v3 integrations only need a supported Node runtime to upgrade.
+
 ## 3.1.0 — 2026-09-28
 
 - Add `createGuideController` and `mountGuideController` with the grouped options, camera, subscriptions, and lifecycle of `createMap`; preserve existing element-based guide factories.
@@ -236,7 +241,7 @@ consistent home, and makes animation and subscription ownership predictable.
 - Add overlay color options, TypeScript declarations, source records, and SVG checks.
 - Add Storybook 10.6 with eight interactive examples and API controls.
 - Add usage examples, contributor instructions, and AGENTS.md.
-- Update GitHub Actions and validate Storybook and package builds on Node 22 and 26.
+- Update GitHub Actions and validate Storybook and package builds across supported Node versions.
 - Configure weekly Dependabot updates for development dependencies and Actions.
 - Keep existing layer defaults unchanged, runtime dependencies at zero, and distribution private.
 

package/README.md

@@ -10,7 +10,9 @@ Offline, self-contained San Francisco SVG maps. The package has no runtime depen
 pnpm add @kahwee/sf-map-svg
 ```
 
-Node 22.12+ is required for server rendering. Browser maps need a DOM and a bundler that supports JSON imports.
+Node 24+ is required for server rendering. Browser maps need a DOM and a bundler that supports JSON imports.
+
+Upgrading from v3 to v4: update your Node runtime to 24 or newer. The map API, browser requirements, rendering, and animations are unchanged.
 
 ## Static SVG
 

package/dist/data/README.md

@@ -37,7 +37,7 @@ const mission = neighborhoods.features.find((f) => f.id === 'inner-mission');
 console.log(mission.properties.canonicalName, mission.geometry);
 ```
 
-Node 22.12+ supports this syntax. Bundlers may also support JSON imports without the import attribute. Files are included in the package archive; non-JavaScript consumers can parse the same JSON files directly. These are package entry points, not a hosted API. The public repository and GitHub Pages explorer also provide access to the source data. Consumers who need only one dataset can import its JSON subpath or a typed, frozen leaf module.
+Node 24+ supports this syntax. Bundlers may also support JSON imports without the import attribute. Files are included in the package archive; non-JavaScript consumers can parse the same JSON files directly. These are package entry points, not a hosted API. The public repository and GitHub Pages explorer also provide access to the source data. Consumers who need only one dataset can import its JSON subpath or a typed, frozen leaf module.
 
 ## Import only the data you need
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kahwee/sf-map-svg",
-  "version": "3.1.0",
+  "version": "4.0.0",
   "description": "Offline SVG maps of San Francisco with district boundaries, parks, landmarks, and BART stations.",
   "type": "module",
   "main": "./dist/src/api.js",
@@ -128,7 +128,7 @@
   },
   "license": "MIT",
   "engines": {
-    "node": ">=22.12.0"
+    "node": ">=24.0.0"
   },
   "devDependencies": {
     "@biomejs/biome": "2.5.14",