@kahwee/sf-map-svg 5.1.2 → 5.1.4

package/dist/src/{map-core.d.ts → rendering/svg-map-renderer.d.ts}

@@ -1,7 +1,7 @@
-import type { Geometry, Position } from '../data/types.js';
-import type { DistrictYear, SFMapOptions } from './types.js';
-export type { DistrictYear, MapMarker, MapOverlay, SFMapOptions } from './types.js';
-import { type Project } from './geometry.js';
+import type { Geometry, Position } from '../../data/types.js';
+import type { DistrictYear, SFMapOptions } from '../types.js';
+export type { DistrictYear, MapMarker, MapOverlay, SFMapOptions } from '../types.js';
+import { type Project } from '../geometry.js';
 export interface SFMapData {
     coast: Geometry;
     districts?: Readonly<Partial<Record<DistrictYear, readonly DistrictRowData[]>>>;

package/dist/src/{map-core.js → rendering/svg-map-renderer.js}

@@ -1,9 +1,9 @@
-import { validateMarkers, validateOverlays } from './validation.js';
-import { prepareDistrictStyles } from './district-style.js';
-import { geometryPath, positions, rawProject } from './geometry.js';
-import * as layers from './layers.js';
-import { normalizeStaticAnimation, staticAnimationStyle } from './static-animation.js';
-import { escapeXml, stroke } from './svg.js';
+import { validateMarkers, validateOverlays } from '../validation.js';
+import { prepareDistrictStyles } from '../district-style.js';
+import { geometryPath, positions, rawProject } from '../geometry.js';
+import { normalizeStaticAnimation, staticAnimationStyle } from '../static-animation.js';
+import * as layers from './svg-layers.js';
+import { escapeXml, stroke } from './svg-primitives.js';
 export const districtYears = Object.freeze([2002, 2012, 2022]);
 export const districtColors = Object.freeze([
     '#c8dce5',

package/dist/src/static-labels.d.ts

@@ -1,5 +1,5 @@
 import type { Project } from './geometry.js';
-import type { SFMapData } from './map-core.js';
+import type { SFMapData } from './rendering/svg-map-renderer.js';
 import type { SFMapOptions } from './types.js';
 /** Conservative portable metrics; the browser refines these with its actual font. */
 export declare function estimateLabelWidth(text: string, fontSize: number): number;

package/dist/src/static-labels.js

@@ -1,7 +1,7 @@
 import { interiorAnchor, layoutLabels, projectedBounds } from './explorer-layout.js';
 import { labelCandidates, styleLabels } from './label-candidates.js';
 import { spreadLabels } from './label-spread.js';
-import { escapeXml, number } from './svg.js';
+import { escapeXml, number } from './rendering/svg-primitives.js';
 /** Conservative portable metrics; the browser refines these with its actual font. */
 export function estimateLabelWidth(text, fontSize) {
     return Array.from(text).reduce((width, char) => width +

package/dist/src/static.d.ts

@@ -1,9 +1,9 @@
 import type { InteractiveSFMapData } from './explorer-data.js';
-import { type SFMapData } from './map-core.js';
+import { type SFMapData } from './rendering/svg-map-renderer.js';
 import type { SFMapOptions } from './types.js';
 /** Either compact static geography or the same source-aware geography used by createMap. */
 export type StaticMapInput = SFMapData | InteractiveSFMapData;
-export type { DistrictRowData, SFMapData as StaticMapData } from './map-core.js';
+export type { DistrictRowData, SFMapData as StaticMapData } from './rendering/svg-map-renderer.js';
 export type { DistrictStyle, DistrictYear, SFMapOptions as StaticMapOptions, StaticMapAppearance, StaticMapLayers, } from './types.js';
 /** Server-safe SVG rendering with explicit data; returns SVG plus projection helpers. */
 export declare function renderMap(data: StaticMapInput, options?: SFMapOptions): {

package/dist/src/static.js

@@ -1,6 +1,6 @@
 import { prepareAppearance } from './appearance.js';
 import { validateSwitchPatch } from './features.js';
-import { createSFMapWithData, getLayerPathsWithData } from './map-core.js';
+import { createSFMapWithData, getLayerPathsWithData, } from './rendering/svg-map-renderer.js';
 import { normalizeStaticAnimation } from './static-animation.js';
 import { staticLabels } from './static-labels.js';
 import { assertOptions, validateMarkers, validateOverlays } from './validation.js';

package/dist/src/transit.js

@@ -2,7 +2,7 @@ import stations from '../data/bart-stations.json' with { type: 'json' };
 import coast from '../data/coast.json' with { type: 'json' };
 import districts from '../data/districts-2022.json' with { type: 'json' };
 import parks from '../data/landmarks.json' with { type: 'json' };
-import { createSFMapWithData } from './map-core.js';
+import { createSFMapWithData } from './rendering/svg-map-renderer.js';
 const districtData = districts;
 const parkData = parks;
 const stationData = stations;

package/dist/src/types.d.ts

@@ -11,7 +11,7 @@ export type DistrictYear = 2002 | 2012 | 2022;
 export interface DistrictSelection {
     id: number;
     year: DistrictYear;
-    district: import('./map-core.js').DistrictRowData;
+    district: import('./rendering/svg-map-renderer.js').DistrictRowData;
 }
 export interface DistrictStyle {
     fill?: string;
@@ -56,7 +56,7 @@ export interface SFMapOptions {
     neighborhoodLabels?: boolean;
     districtFills?: boolean;
     /** Evaluated once per district at construction/style/year updates; call setDistrictStyle again when external data changes. */
-    districtStyle?: (district: import('./map-core.js').DistrictRowData) => DistrictStyle;
+    districtStyle?: (district: import('./rendering/svg-map-renderer.js').DistrictRowData) => DistrictStyle;
     districtLabels?: boolean;
     /** Hide all visible text labels while retaining geographic symbols and accessible titles. */
     labels?: boolean;

package/llms-full.txt

@@ -2,13 +2,13 @@
 
 > Offline San Francisco SVG maps with explicit geographic imports, no runtime dependencies, static rendering, and a browser controller.
 
-@kahwee/sf-map-svg 5.1.2 · local working tree. Node >=24.0.0 for server rendering; browsers need a DOM and a JSON-capable bundler.
+@kahwee/sf-map-svg 5.1.4 · local working tree. Node >=24.0.0 for server rendering; browsers need a DOM and a JSON-capable bundler.
 
 These are working-tree docs. Unreleased changelog entries may describe APIs absent from npm; verify the installed version before copying them.
 
 Use renderMap(data, options) for SVG strings; createMap(data, options) returns a controller. Mount map.element and destroy it on unmount. Choose mode explicitly: createMap defaults to basemap. Geography is separate; staticMapData and fullMapData have different shapes.
 
-<!-- Generated from README.md; @kahwee/sf-map-svg 5.1.2 · local working tree. -->
+<!-- Generated from README.md; @kahwee/sf-map-svg 5.1.4 · local working tree. -->
 
 # SF Map SVG
 
@@ -267,7 +267,7 @@ for raw samples, output-equivalence checks, and reproducible commands.
 
 ---
 
-<!-- Generated from docs/developer-guide.md; @kahwee/sf-map-svg 5.1.2 · local working tree. -->
+<!-- Generated from docs/developer-guide.md; @kahwee/sf-map-svg 5.1.4 · local working tree. -->
 
 # Developer guide
 
@@ -433,7 +433,7 @@ See [API options](https://github.com/kahwee/sf-map-svg/blob/main/docs/API.md), [
 
 ---
 
-<!-- Generated from docs/API.md; @kahwee/sf-map-svg 5.1.2 · local working tree. -->
+<!-- Generated from docs/API.md; @kahwee/sf-map-svg 5.1.4 · local working tree. -->
 
 # Map options and lifecycle
 
@@ -619,7 +619,7 @@ Call `binding.setMarkers(next)` after `map.setMarkers(next)` when the catalog ch
 
 ---
 
-<!-- Generated from docs/EXAMPLES.md; @kahwee/sf-map-svg 5.1.2 · local working tree. -->
+<!-- Generated from docs/EXAMPLES.md; @kahwee/sf-map-svg 5.1.4 · local working tree. -->
 
 # Examples
 
@@ -760,7 +760,7 @@ See [query semantics and limitations](https://github.com/kahwee/sf-map-svg/blob/
 
 ---
 
-<!-- Generated from docs/consumer-integration.md; @kahwee/sf-map-svg 5.1.2 · local working tree. -->
+<!-- Generated from docs/consumer-integration.md; @kahwee/sf-map-svg 5.1.4 · local working tree. -->
 
 # Embedding and progressive enhancement
 
@@ -938,7 +938,7 @@ keyboard, focus, and dismissal behavior. See [coordinates and units](https://git
 
 ---
 
-<!-- Generated from docs/migration-v5.md; @kahwee/sf-map-svg 5.1.2 · local working tree. -->
+<!-- Generated from docs/migration-v5.md; @kahwee/sf-map-svg 5.1.4 · local working tree. -->
 
 # Migrating to v5
 
@@ -1043,7 +1043,7 @@ collections. Shared edges can match more than one feature. See the
 
 ---
 
-<!-- Generated from docs/migration-v3.md; @kahwee/sf-map-svg 5.1.2 · local working tree. -->
+<!-- Generated from docs/migration-v3.md; @kahwee/sf-map-svg 5.1.4 · local working tree. -->
 
 # Migrate to version 3
 
@@ -1084,7 +1084,7 @@ District styles are now prepared once per district on construction and style/yea
 
 ---
 
-<!-- Generated from SOURCES.md; @kahwee/sf-map-svg 5.1.2 · local working tree. -->
+<!-- Generated from SOURCES.md; @kahwee/sf-map-svg 5.1.4 · local working tree. -->
 
 # Geometry and provenance
 
@@ -1321,7 +1321,7 @@ Report-history points preserve only actual validated source counts and their dis
 
 ---
 
-<!-- Generated from CHANGELOG.md; @kahwee/sf-map-svg 5.1.2 · local working tree. -->
+<!-- Generated from CHANGELOG.md; @kahwee/sf-map-svg 5.1.4 · local working tree. -->
 
 # Changelog
 
@@ -1329,6 +1329,14 @@ User-visible changes are recorded here. Unreleased entries describe changes on `
 
 ## Unreleased
 
+## 5.1.4 — 2026-11-05
+
+- Group internal browser controllers, renderers and shells under `src/interactive`, and SVG generation under `src/rendering`. Rename the general map engine, controls and marker renderer to match their responsibilities; clarify selection-detail, neighborhood-results and layer-composition operations. Keep public package entry points unchanged.
+
+## 5.1.3 — 2026-11-05
+
+- Give configuration snapshots and revisions a dedicated internal owner. Split presentation preparation from a guarded, single-use commit, rejecting stale or disposed updates before mutating presentation. Preserve public configuration and reset behavior.
+
 ## 5.1.2 — 2026-11-05
 
 - Separate marker selection, activation and focus recovery into an internal controller; separate label candidate caching, screen-space collision layout and metrics invalidation into a label coordinator. Preserve the public API and shared animation frame scheduling.
@@ -1721,7 +1729,7 @@ consistent home, and makes animation and subscription ownership predictable.
 
 # Published type contracts
 
-@kahwee/sf-map-svg 5.1.2 · local working tree. These declarations are generated by TypeScript. Use package export paths, not the internal filenames below. Imported relative contracts are included for context, not as additional public entry points.
+@kahwee/sf-map-svg 5.1.4 · local working tree. These declarations are generated by TypeScript. Use package export paths, not the internal filenames below. Imported relative contracts are included for context, not as additional public entry points.
 
 | Public import | Declaration |
 | --- | --- |
@@ -2107,7 +2115,7 @@ export type DistrictYear = 2002 | 2012 | 2022;
 export interface DistrictSelection {
     id: number;
     year: DistrictYear;
-    district: import('./map-core.js').DistrictRowData;
+    district: import('./rendering/svg-map-renderer.js').DistrictRowData;
 }
 export interface DistrictStyle {
     fill?: string;
@@ -2152,7 +2160,7 @@ export interface SFMapOptions {
     neighborhoodLabels?: boolean;
     districtFills?: boolean;
     /** Evaluated once per district at construction/style/year updates; call setDistrictStyle again when external data changes. */
-    districtStyle?: (district: import('./map-core.js').DistrictRowData) => DistrictStyle;
+    districtStyle?: (district: import('./rendering/svg-map-renderer.js').DistrictRowData) => DistrictStyle;
     districtLabels?: boolean;
     /** Hide all visible text labels while retaining geographic symbols and accessible titles. */
     labels?: boolean;
@@ -2374,7 +2382,7 @@ export type { MapAppearance, MapCamera, MapCapabilities, MapConfiguration, MapCo
 
 ```ts
 import type { DistrictProperties, FeatureCollection, NeighborhoodProperties, NeighborhoodSource } from '../data/types.js';
-import type { SFMapData } from './map-core.js';
+import type { SFMapData } from './rendering/svg-map-renderer.js';
 import type { DistrictYear } from './types.js';
 /** Geographic inputs for the data-injected interactive map entry point. */
 export interface InteractiveSFMapData {
@@ -2384,13 +2392,13 @@ export interface InteractiveSFMapData {
 }
 ```
 
-### dist/src/map-core.d.ts
+### dist/src/rendering/svg-map-renderer.d.ts
 
 ```ts
-import type { Geometry, Position } from '../data/types.js';
-import type { DistrictYear, SFMapOptions } from './types.js';
-export type { DistrictYear, MapMarker, MapOverlay, SFMapOptions } from './types.js';
-import { type Project } from './geometry.js';
+import type { Geometry, Position } from '../../data/types.js';
+import type { DistrictYear, SFMapOptions } from '../types.js';
+export type { DistrictYear, MapMarker, MapOverlay, SFMapOptions } from '../types.js';
+import { type Project } from '../geometry.js';
 export interface SFMapData {
     coast: Geometry;
     districts?: Readonly<Partial<Record<DistrictYear, readonly DistrictRowData[]>>>;
@@ -2512,11 +2520,11 @@ export declare function geometryContainsPoint(geometry: Geometry | null | undefi
 
 ```ts
 import type { InteractiveSFMapData } from './explorer-data.js';
-import { type SFMapData } from './map-core.js';
+import { type SFMapData } from './rendering/svg-map-renderer.js';
 import type { SFMapOptions } from './types.js';
 /** Either compact static geography or the same source-aware geography used by createMap. */
 export type StaticMapInput = SFMapData | InteractiveSFMapData;
-export type { DistrictRowData, SFMapData as StaticMapData } from './map-core.js';
+export type { DistrictRowData, SFMapData as StaticMapData } from './rendering/svg-map-renderer.js';
 export type { DistrictStyle, DistrictYear, SFMapOptions as StaticMapOptions, StaticMapAppearance, StaticMapLayers, } from './types.js';
 /** Server-safe SVG rendering with explicit data; returns SVG plus projection helpers. */
 export declare function renderMap(data: StaticMapInput, options?: SFMapOptions): {

package/llms.txt

@@ -2,7 +2,7 @@
 
 > Offline San Francisco SVG maps with explicit geographic imports, no runtime dependencies, static rendering, and a browser controller.
 
-@kahwee/sf-map-svg 5.1.2 · local working tree. Node >=24.0.0 for server rendering; browsers need a DOM and a JSON-capable bundler.
+@kahwee/sf-map-svg 5.1.4 · local working tree. Node >=24.0.0 for server rendering; browsers need a DOM and a JSON-capable bundler.
 
 These are working-tree docs. Unreleased changelog entries may describe APIs absent from npm; verify the installed version before copying them.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kahwee/sf-map-svg",
-  "version": "5.1.2",
+  "version": "5.1.4",
   "description": "Offline SVG maps of San Francisco with district boundaries, parks, landmarks, and BART stations.",
   "type": "module",
   "main": "./dist/src/api.js",