@kahwee/sf-map-svg 3.0.0 → 3.0.1

package/CHANGELOG.md

@@ -4,6 +4,13 @@ User-visible changes are recorded here. Unreleased entries describe changes on `
 
 ## Unreleased
 
+## 3.0.1 — 2026-09-27
+
+- Narrow the complete-data presets to their direct geographic modules without changing rendered SVGs or public API behavior.
+- Correct stale contributing and example documentation links, add a local Markdown link check to `pnpm check`, and show the v3 controller API on the Pages homepage.
+- Skip the early push-triggered Pages build while a new package version is still processing on npm; the successful release workflow deploys that version from the registry.
+- Serve local visual snapshots with the same streaming Node HTTP approach as the Pages browser check, avoiding intermittent resets while loading large optional map data.
+
 ## 3.0.0 — 2026-09-27
 
 Version 3 removes the deprecated compatibility APIs. Applications must migrate before upgrading. The data-free root API introduced in version 2 remains the supported API.

package/README.md

@@ -16,16 +16,16 @@ Node 22.12+ is required for server rendering. Browser maps need a DOM and a bund
 
 ```ts
 import { renderMap } from '@kahwee/sf-map-svg';
-import { fullMapData } from '@kahwee/sf-map-svg/data/full';
+import { staticMapData } from '@kahwee/sf-map-svg/data/static';
 
-const { svg, project, viewBox } = renderMap(fullMapData.map, {
+const { svg, project, viewBox } = renderMap(staticMapData, {
   year: 2022,
   landmarks: true,
   bartStations: true,
 });
 ```
 
-`renderMap(data, options)` returns SVG markup and matching projection helpers. Import `/data/full` only when all packaged geography is needed. For static rendering without interactive lookup collections, import `staticMapData` from `/data/static`. Small maps can compose selected JSON exports from `/data/*` and pass them as `StaticMapData`. `getLayerPaths(data, options)` returns fitted geographic paths without SVG markup.
+`renderMap(data, options)` returns SVG markup and matching projection helpers. `/data/static` includes the complete static map without interactive lookup collections. Small maps can compose selected JSON exports from `/data/*` and pass them as `StaticMapData`. `getLayerPaths(data, options)` returns fitted geographic paths without SVG markup.
 
 Static options include `theme`, `width`, `height`, `padding`, `year` (2002, 2012, 2022), `districtLines`, `districtFills`, `districtStyle`, `districtLabels`, `neighborhoodLines`, `labels`, `highways`, `keyRoads`, `roadLabels`, `landmarks`, `bartStations`, `markers`, `overlays`, `title`, `idPrefix`, and `colors`. Each optional layer is independent. User-supplied text and attributes are escaped in SVG output.
 

package/dist/src/full-data.js

@@ -1,4 +1,5 @@
-import { districtMaps, neighborhoodCollections } from '../data/index.js';
+import { districtMaps } from '../data/districts.js';
+import { neighborhoodCollections } from '../data/lookup.js';
 import { deepFreeze } from './immutable.js';
 import { staticMapData } from './static-data.js';
 /** Complete, explicit geographic preset. Import this only when all datasets are needed. */

package/dist/src/static-data.js

@@ -1,4 +1,6 @@
-import { bartStations, keyRoads, landmarks } from '../data/index.js';
+import { landmarks } from '../data/landmarks.js';
+import { keyRoads } from '../data/roads.js';
+import { bartStations } from '../data/stations.js';
 import data from './data.js';
 import { deepFreeze } from './immutable.js';
 /** Complete data for static rendering, without interactive lookup collections. */

package/docs/EXAMPLES.md

@@ -17,9 +17,9 @@ Choose by task. All snippets use the public package API; browser examples need a
 ```ts
 import { writeFile } from 'node:fs/promises';
 import { renderMap } from '@kahwee/sf-map-svg';
-import { fullMapData } from '@kahwee/sf-map-svg/data/full';
+import { staticMapData } from '@kahwee/sf-map-svg/data/static';
 
-const svg = renderMap(fullMapData.map, {
+const svg = renderMap(staticMapData, {
   year: 2022,
   landmarks: true,
   bartStations: true,
@@ -28,14 +28,13 @@ const svg = renderMap(fullMapData.map, {
 await writeFile('districts.svg', svg);
 ```
 
-The full preset imports all packaged geography. For smaller bundles, pass selected data to the root or `/static` renderer. See the [static recipe](../README.md#static-svg).
+The static preset includes the packaged map layers without interactive lookup collections. For smaller bundles, pass selected data to the root or `/static` renderer. See the [static recipe](../README.md#static-svg).
 
 For an election choropleth, use `renderMap(data, { year, districtStyle })` or
 `createMap({ map: data, districts: districtMaps, neighborhoods: {} }, options)`.
 The controller exposes `setDistrictYear`, `setDistrictStyle`, `selectDistrict`, and typed
 district events; `getLayerPaths(data, { year })` returns fitted paths without SVG markup.
-See the [complete election recipe](../README.md#election-district-api) and the Storybook
-“Election choropleth” example.
+See the [Storybook election choropleth](../stories/ElectionMap.stories.ts) for a working example.
 
 ## Lightweight interactive guide
 
@@ -46,7 +45,7 @@ const map = createGuideMap({ layers: { roadLabels: false } });
 document.querySelector('#map')?.append(map);
 ```
 
-The guide includes selected coast, SFAR neighborhoods, parks, roads, and stations. Detailed geography loads only when explicitly requested; see the [guide recipe](../README.md#render-a-static-map).
+The guide includes selected coast, SFAR neighborhoods, parks, roads, and stations. Detailed geography loads only when explicitly requested; see the [consumer guide recipe](consumer-integration.md).
 
 ## Selected geography
 

package/docs/consumer-integration.md

@@ -15,4 +15,4 @@ document.querySelector('#map')?.append(map.element);
 map.destroy();
 ```
 
-For server rendering, import `renderMap` from the root and pass `guideMapData.map` or another explicit `StaticMapData`. Import `/data/full` only if the complete packaged geography is required. All rendering stays offline and has zero runtime dependencies. The guide's detailed geography loads only when `loadGuideDetailedData()` is called.
+For server rendering, import `renderMap` from the root and pass `guideMapData.map`, `staticMapData` from `/data/static`, or another explicit `StaticMapData`. Import `/data/full` when interactive lookup collections are also required. All rendering stays offline and has zero runtime dependencies. The guide's detailed geography loads only when `loadGuideDetailedData()` is called.

package/docs/migration-v3.md

@@ -4,14 +4,14 @@ Version 3 removes the deprecated compatibility entry points and their bundled-da
 
 | Version 2 import or call | Version 3 replacement |
 | --- | --- |
-| `/legacy` `renderSFMap(options)` | `renderMap(fullMapData.map, options).svg` |
-| `/legacy` `createSFMap(options)` | `renderMap(fullMapData.map, options)` |
+| `/legacy` `renderSFMap(options)` | `renderMap(staticMapData, options).svg` |
+| `/legacy` `createSFMap(options)` | `renderMap(staticMapData, options)` |
 | `/custom-map` `createSFMapWithData(options, data)` | `renderMap(data, options)` |
 | `/explorer` `createNeighborhoodExplorer(options)` | `createMap(fullMapData, options)`; mount `.element` |
 | `/interactive` `createInteractiveSFMap(options)` | `createMap(fullMapData, { mode: 'basemap', ...options })`; mount `.element` |
 | `/interactive-data` `createInteractiveSFMapWithData(data, options)` | `createMap(data, options)`; mount `.element` |
 
-`fullMapData` comes from `@kahwee/sf-map-svg/data/full`. It is an explicit import of all packaged geography. For smaller bundles, use `staticMapData` from `/data/static` for SVGs, construct data from individual `/data/*` modules, or use `guideMapData` from `/guide/data`. There is no implicit geographic data in the root import.
+`staticMapData` comes from `@kahwee/sf-map-svg/data/static` and includes the complete static map. `fullMapData` comes from `/data/full` and adds the interactive lookup collections. For smaller bundles, construct data from individual `/data/*` modules or use `guideMapData` from `/guide/data`. There is no implicit geographic data in the root import.
 
 ```ts
 import { createMap, renderMap } from '@kahwee/sf-map-svg';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kahwee/sf-map-svg",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Offline SVG maps of San Francisco with district boundaries, parks, landmarks, and BART stations.",
   "type": "module",
   "main": "./dist/src/api.js",
@@ -171,7 +171,8 @@
     "demo": "pnpm build && node examples/build.mjs",
     "format": "biome check --write .",
     "format:check": "biome format .",
-    "check": "pnpm peers check && pnpm lint && pnpm data:check && pnpm typecheck && pnpm typecheck:stories && pnpm test && pnpm test:bundle",
+    "check": "pnpm peers check && pnpm lint && pnpm check:docs && pnpm data:check && pnpm typecheck && pnpm typecheck:stories && pnpm test && pnpm test:bundle",
+    "check:docs": "node scripts/check-docs.mjs",
     "storybook": "pnpm build && storybook dev -p 6006 --host 127.0.0.1 --no-open",
     "build-storybook": "pnpm build && storybook build",
     "data:catalog": "node scripts/build-data-catalog.mjs",