@kahwee/sf-map-svg 5.1.2 → 5.1.3

package/CHANGELOG.md

@@ -4,6 +4,10 @@ User-visible changes are recorded here. Unreleased entries describe changes on `
 
 ## Unreleased
 
+## 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.

package/dist/src/configuration-controller.d.ts

@@ -0,0 +1,21 @@
+import { prepareConfiguration } from './configuration.js';
+import type { MapConfiguration } from './controller-types.js';
+import type { NeighborhoodExplorerElement } from './types.js';
+/** A prepared engine update may commit once, only while all revisions remain current. */
+export interface PreparedPresentation {
+    commit(onCommit: () => void, isCurrent: () => boolean): boolean;
+}
+export interface ConfigurationTarget extends Pick<NeighborhoodExplorerElement, 'setFeatures' | 'setLayers' | 'setControls'> {
+    preparePresentation(patch: MapConfiguration): PreparedPresentation | undefined;
+}
+/** Own the public configuration snapshot and invalidate stale updates before DOM mutation. */
+export declare function createConfigurationController(initial: ReturnType<typeof prepareConfiguration>, element: ConfigurationTarget, isDestroyed: () => boolean): {
+    configure: (patch: MapConfiguration) => boolean;
+    readonly current: {
+        features: import("./types.js").MapFeatures;
+        layers: import("./types.js").InteractiveLayers;
+        controls: import("./controller-types.js").MapControls;
+        appearance: import("./controller-types.js").MapAppearance;
+    };
+    invalidate(): void;
+};

package/dist/src/configuration-controller.js

@@ -0,0 +1,43 @@
+import { prepareConfiguration } from './configuration.js';
+import { controlKeys, layerKeys } from './features.js';
+/** Own the public configuration snapshot and invalidate stale updates before DOM mutation. */
+export function createConfigurationController(initial, element, isDestroyed) {
+    let config = initial;
+    let configurationRevision = 0;
+    function configure(patch) {
+        const revision = ++configurationRevision;
+        const next = prepareConfiguration(config, patch);
+        const hasFeatures = 'features' in patch, hasLayers = 'layers' in patch, hasControls = 'controls' in patch;
+        const layers = Object.fromEntries(layerKeys.map((key) => [key, next.layers[key]]));
+        const controls = Object.fromEntries(controlKeys.map((key) => [key, next.controls[key]]));
+        const features = patch.features === undefined
+            ? next.features
+            : Object.fromEntries(Object.keys(patch.features).map((key) => [
+                key,
+                next.features[key],
+            ]));
+        const presentation = element.preparePresentation({
+            ...patch,
+            ...('appearance' in patch ? { appearance: next.appearance } : {}),
+        });
+        const committed = presentation?.commit(() => {
+            config = next;
+            if (hasFeatures)
+                element.setFeatures(features);
+            if (hasLayers)
+                element.setLayers(layers);
+            if (hasControls)
+                element.setControls(controls);
+        }, () => !isDestroyed() && revision === configurationRevision);
+        return committed === true && !isDestroyed() && revision === configurationRevision;
+    }
+    return {
+        configure,
+        get current() {
+            return config;
+        },
+        invalidate() {
+            configurationRevision++;
+        },
+    };
+}

package/dist/src/explorer-core.d.ts

@@ -1,4 +1,5 @@
 import type { NeighborhoodSource } from '../data/types.js';
+import type { PreparedPresentation } from './configuration-controller.js';
 import type { MapConfiguration } from './controller-types.js';
 import type { InteractiveSFMapData } from './explorer-data.js';
 import type { createMapShell } from './explorer-shell.js';
@@ -7,7 +8,7 @@ import type { DistrictYear, ExplorerMode, NeighborhoodExplorerElement, Neighborh
 export type { ExplorerMode, NeighborhoodExplorerElement, NeighborhoodExplorerOptions, } from './types.js';
 /** Private bridge between the renderer and its public lifecycle controller. */
 type MapEngineElement = NeighborhoodExplorerElement & {
-    applyPresentation(patch: MapConfiguration, onCommit?: () => void, isCurrent?: () => boolean): boolean;
+    preparePresentation(patch: MapConfiguration): PreparedPresentation | undefined;
     getMapState(): {
         mode: ExplorerMode;
         source: NeighborhoodSource;

package/dist/src/explorer-core.js

@@ -860,7 +860,7 @@ export function createNeighborhoodExplorerCore(options = {}, data, ui) {
         root.dispatchEvent(new CustomEvent('mapresize', { bubbles: true }));
     };
     let presentationRevision = 0;
-    function applyPresentation(patch, onCommit, isCurrent = () => true) {
+    function preparePresentation(patch) {
         const revision = ++presentationRevision;
         const nextYear = patch.year ?? year;
         const nextMode = patch.mode ?? mode;
@@ -880,11 +880,8 @@ export function createNeighborhoodExplorerCore(options = {}, data, ui) {
         const prepared = appearance || nextYear !== year
             ? prepareDistrictStyles(data.map.districts?.[nextYear] ?? [], nextStyle)
             : districts.styles;
-        if (destroyed ||
-            !isCurrent() ||
-            revision !== presentationRevision ||
-            districtVersion !== districts.revision)
-            return false;
+        if (destroyed || revision !== presentationRevision || districtVersion !== districts.revision)
+            return undefined;
         if (nextYear !== year) {
             // Validate target paths and label coordinates before any presentation group commits.
             getLayerPathsWithData({ year: nextYear }, data.map, false);
@@ -892,103 +889,120 @@ export function createNeighborhoodExplorerCore(options = {}, data, ui) {
                 for (const point of feature.properties.labelPoints)
                     map.project(point);
         }
-        onCommit?.();
-        if (appearance) {
-            districts.invalidate();
-            const next = copyAppearance(appearance);
-            theme = next.theme ?? 'transit';
-            colors = next.colors ?? {};
-            labelStyle = next.labelStyle ?? {};
-            areaStyle = next.areaStyle ?? {};
-            styleOptions = next.style ?? {};
-            minLabelSize = next.labelSize?.min ?? 11;
-            maxLabelSize = next.labelSize?.max ?? 12;
-            markerRadius = next.markerRadius ?? 6;
-            markerHitSize = next.markerHitSize ?? 44;
-            markerColor = next.markerColor ?? colors.marker ?? '#245b61';
-            selectedMarkerColor = next.selectedMarkerColor ?? colors.selected ?? '#f04f32';
-            districtTransition.cancel();
-            const fills = districtLayers.find((layer) => layer.dataset.layer === 'district-fills');
-            const fade = layerFades.duration();
-            const stylesChanged = nextStyle !== districts.style ||
-                [...prepared].some(([id, value]) => ['fill', 'stroke', 'opacity'].some((key) => value[key] !== districts.styles.get(id)?.[key]));
-            if (fills && fade && enabled('districtFills') && nextYear === year && stylesChanged)
-                districtTransition.fade(fills, fade);
-            districts.commitStyles(nextStyle, prepared);
-            const palette = resolveMapColors(theme, colors);
-            svg.querySelector('rect')?.setAttribute('fill', palette.water);
-            svg.querySelector('[data-layer="coast"]')?.setAttribute('fill', palette.land);
-            svg.querySelector('[data-layer="coastline"]')?.setAttribute('stroke', palette.district);
-            for (const [layer, color] of [
-                ['landmarks', palette.park],
-                ['highways', palette.highway],
-                ['key-roads', palette.road],
-            ])
-                for (const node of svg.querySelectorAll(`[data-layer="${layer}"] path`)) {
-                    node.setAttribute(layer === 'landmarks' ? 'fill' : 'stroke', color);
-                    if (layer === 'highways')
-                        node.setAttribute('stroke-width', theme === 'transit' ? '2' : '1.4');
-                }
-            for (const [token, fallback, name] of [
-                ['ink', '#18364f', 'ink'],
-                ['surface', '#fff', 'surface'],
-                ['accent', '#163d61', 'accent'],
-                ['border', '#cedae3', 'border'],
-                ['focus', '#1676b8', 'focus'],
-                ['controlGap', '6px', 'control-gap'],
-                ['font', 'system-ui,sans-serif', 'font'],
-            ])
-                root.style.setProperty(`--sf-map-${name}`, styleOptions[token] ?? fallback);
-            labelLayer.setAttribute('font-family', labelStyle.fontFamily ?? styleOptions.font ?? 'system-ui,sans-serif');
-            labelCoordinator.invalidateMetrics();
-            for (const station of stationItems)
-                station.node.setAttribute('stroke', colors.bart ?? '#0073ae');
-            for (const kind of ['bart', 'park', 'highway', 'road']) {
-                const symbol = legend.querySelector(`.sf-explorer-legend-${kind}`);
-                if (symbol) {
-                    symbol.style.removeProperty(kind === 'bart' ? 'border-color' : 'background-color');
-                    if (colors[kind])
-                        symbol.style.setProperty(kind === 'bart' ? 'border-color' : 'background-color', colors[kind]);
+        let consumed = false;
+        return {
+            commit(onCommit, isCurrent) {
+                if (consumed ||
+                    destroyed ||
+                    !isCurrent() ||
+                    revision !== presentationRevision ||
+                    districtVersion !== districts.revision)
+                    return false;
+                consumed = true;
+                onCommit();
+                if (destroyed ||
+                    !isCurrent() ||
+                    revision !== presentationRevision ||
+                    districtVersion !== districts.revision)
+                    return false;
+                if (appearance) {
+                    districts.invalidate();
+                    const next = copyAppearance(appearance);
+                    theme = next.theme ?? 'transit';
+                    colors = next.colors ?? {};
+                    labelStyle = next.labelStyle ?? {};
+                    areaStyle = next.areaStyle ?? {};
+                    styleOptions = next.style ?? {};
+                    minLabelSize = next.labelSize?.min ?? 11;
+                    maxLabelSize = next.labelSize?.max ?? 12;
+                    markerRadius = next.markerRadius ?? 6;
+                    markerHitSize = next.markerHitSize ?? 44;
+                    markerColor = next.markerColor ?? colors.marker ?? '#245b61';
+                    selectedMarkerColor = next.selectedMarkerColor ?? colors.selected ?? '#f04f32';
+                    districtTransition.cancel();
+                    const fills = districtLayers.find((layer) => layer.dataset.layer === 'district-fills');
+                    const fade = layerFades.duration();
+                    const stylesChanged = nextStyle !== districts.style ||
+                        [...prepared].some(([id, value]) => ['fill', 'stroke', 'opacity'].some((key) => value[key] !== districts.styles.get(id)?.[key]));
+                    if (fills && fade && enabled('districtFills') && nextYear === year && stylesChanged)
+                        districtTransition.fade(fills, fade);
+                    districts.commitStyles(nextStyle, prepared);
+                    const palette = resolveMapColors(theme, colors);
+                    svg.querySelector('rect')?.setAttribute('fill', palette.water);
+                    svg.querySelector('[data-layer="coast"]')?.setAttribute('fill', palette.land);
+                    svg.querySelector('[data-layer="coastline"]')?.setAttribute('stroke', palette.district);
+                    for (const [layer, color] of [
+                        ['landmarks', palette.park],
+                        ['highways', palette.highway],
+                        ['key-roads', palette.road],
+                    ])
+                        for (const node of svg.querySelectorAll(`[data-layer="${layer}"] path`)) {
+                            node.setAttribute(layer === 'landmarks' ? 'fill' : 'stroke', color);
+                            if (layer === 'highways')
+                                node.setAttribute('stroke-width', theme === 'transit' ? '2' : '1.4');
+                        }
+                    for (const [token, fallback, name] of [
+                        ['ink', '#18364f', 'ink'],
+                        ['surface', '#fff', 'surface'],
+                        ['accent', '#163d61', 'accent'],
+                        ['border', '#cedae3', 'border'],
+                        ['focus', '#1676b8', 'focus'],
+                        ['controlGap', '6px', 'control-gap'],
+                        ['font', 'system-ui,sans-serif', 'font'],
+                    ])
+                        root.style.setProperty(`--sf-map-${name}`, styleOptions[token] ?? fallback);
+                    labelLayer.setAttribute('font-family', labelStyle.fontFamily ?? styleOptions.font ?? 'system-ui,sans-serif');
+                    labelCoordinator.invalidateMetrics();
+                    for (const station of stationItems)
+                        station.node.setAttribute('stroke', colors.bart ?? '#0073ae');
+                    for (const kind of ['bart', 'park', 'highway', 'road']) {
+                        const symbol = legend.querySelector(`.sf-explorer-legend-${kind}`);
+                        if (symbol) {
+                            symbol.style.removeProperty(kind === 'bart' ? 'border-color' : 'background-color');
+                            if (colors[kind])
+                                symbol.style.setProperty(kind === 'bart' ? 'border-color' : 'background-color', colors[kind]);
+                        }
+                    }
+                    for (const item of neighborhoods.items) {
+                        const active = item.feature === neighborhoods.selected;
+                        item.node.setAttribute('fill', active ? (areaStyle.selectedFill ?? '#408dbe') : 'transparent');
+                        item.node.setAttribute('stroke', active ? (areaStyle.selectedStroke ?? '#176ba2') : (colors.neighborhood ?? '#9caebc'));
+                    }
+                    for (const item of markerCatalog.items) {
+                        const visual = item.visual;
+                        if (!visual)
+                            continue;
+                        visual.dot.setAttribute('fill', item.marker.id === markers.selected
+                            ? selectedMarkerColor
+                            : (item.marker.color ?? markerColor));
+                        visual.ring.setAttribute('stroke', features.selectedMarkerRing
+                            ? (features.selectedMarkerRing.color ?? selectedMarkerColor)
+                            : selectedMarkerColor);
+                    }
+                    invalidateClusters();
+                    updateDistrictAppearance();
                 }
-            }
-            for (const item of neighborhoods.items) {
-                const active = item.feature === neighborhoods.selected;
-                item.node.setAttribute('fill', active ? (areaStyle.selectedFill ?? '#408dbe') : 'transparent');
-                item.node.setAttribute('stroke', active ? (areaStyle.selectedStroke ?? '#176ba2') : (colors.neighborhood ?? '#9caebc'));
-            }
-            for (const item of markerCatalog.items) {
-                const visual = item.visual;
-                if (!visual)
-                    continue;
-                visual.dot.setAttribute('fill', item.marker.id === markers.selected
-                    ? selectedMarkerColor
-                    : (item.marker.color ?? markerColor));
-                visual.ring.setAttribute('stroke', features.selectedMarkerRing
-                    ? (features.selectedMarkerRing.color ?? selectedMarkerColor)
-                    : selectedMarkerColor);
-            }
-            invalidateClusters();
-            updateDistrictAppearance();
-        }
-        if (nextYear !== year)
-            setDistrictYear(nextYear, {}, prepared);
-        if (destroyed || revision !== presentationRevision || !isCurrent())
-            return false;
-        commitSource?.();
-        if (destroyed || revision !== presentationRevision || !isCurrent())
-            return false;
-        if (commitSource && appearance)
-            for (const item of neighborhoods.items)
-                item.node.setAttribute('stroke', colors.neighborhood ?? '#9caebc');
-        if (patch.mode !== undefined)
-            setMode(patch.mode, false);
-        if (patch.labels !== undefined)
-            setLabels(patch.labels);
-        scheduleLabels();
-        return true;
+                if (nextYear !== year)
+                    setDistrictYear(nextYear, {}, prepared);
+                if (destroyed || revision !== presentationRevision || !isCurrent())
+                    return false;
+                commitSource?.();
+                if (destroyed || revision !== presentationRevision || !isCurrent())
+                    return false;
+                if (commitSource && appearance)
+                    for (const item of neighborhoods.items)
+                        item.node.setAttribute('stroke', colors.neighborhood ?? '#9caebc');
+                if (patch.mode !== undefined)
+                    setMode(patch.mode, false);
+                if (patch.labels !== undefined)
+                    setLabels(patch.labels);
+                scheduleLabels();
+                return true;
+            },
+        };
     }
     const explorer = Object.assign(root, {
-        applyPresentation,
+        preparePresentation,
         getMapState: () => ({ mode, source: neighborhoods.source, year, labels }),
         selectNeighborhood,
         getSelection,

package/dist/src/map.js

@@ -1,14 +1,15 @@
 import { copyAppearance } from './appearance.js';
 import { validateCameraOptions } from './camera.js';
 import { configurationPatch, expandMapOptions, prepareConfiguration } from './configuration.js';
+import { createConfigurationController } from './configuration-controller.js';
 import { createNeighborhoodExplorerCore } from './explorer-core.js';
 import { createMapShell } from './explorer-shell.js';
-import { controlKeys, layerKeys } from './features.js';
+import { layerKeys } from './features.js';
 import { assertOptions } from './validation.js';
 /** No geography is imported. Supply a preset or your own immutable data. */
 export function createMap(data, options = {}) {
     const expanded = expandMapOptions(options);
-    let config = prepareConfiguration({ features: {}, layers: {}, controls: {}, appearance: {} }, {
+    const initialConfiguration = prepareConfiguration({ features: {}, layers: {}, controls: {}, appearance: {} }, {
         features: options.features,
         layers: options.layers,
         controls: options.controls,
@@ -21,7 +22,8 @@ export function createMap(data, options = {}) {
         onOverlayActivate: () => { },
     }, data, { createShell: createMapShell });
     const subscriptions = new Set();
-    let configurationRevision = 0;
+    const configuration = createConfigurationController(initialConfiguration, element, () => destroyed);
+    const configure = configuration.configure;
     const sourceList = ['realtor', 'sf-find', 'analysis'].filter((source) => !!data.neighborhoods[source]);
     const yearList = [2002, 2012, 2022].filter((year) => !!data.map.districts?.[year] && !!data.districts?.[year]);
     const capabilities = () => ({
@@ -42,11 +44,11 @@ export function createMap(data, options = {}) {
     const snapshot = () => ({
         ...element.getMapState(),
         ...structuredClone({
-            features: config.features,
-            layers: config.layers,
-            controls: config.controls,
+            features: configuration.current.features,
+            layers: configuration.current.layers,
+            controls: configuration.current.controls,
         }),
-        appearance: copyAppearance(config.appearance),
+        appearance: copyAppearance(configuration.current.appearance),
     });
     const resolved = () => {
         const state = element.getMapState();
@@ -58,7 +60,7 @@ export function createMap(data, options = {}) {
                 key,
                 supplied[key] &&
                     (!key.endsWith('Labels') || state.labels) &&
-                    (config.layers[key] ??
+                    (configuration.current.layers[key] ??
                         (key.startsWith('district')
                             ? state.mode === 'districts'
                             : key.startsWith('neighborhood')
@@ -119,31 +121,6 @@ export function createMap(data, options = {}) {
             element.fitGeometry(geometry, padding, motion);
         }),
     });
-    function configure(patch) {
-        const revision = ++configurationRevision;
-        const next = prepareConfiguration(config, patch);
-        const hasFeatures = 'features' in patch, hasLayers = 'layers' in patch, hasControls = 'controls' in patch;
-        const layers = Object.fromEntries(layerKeys.map((key) => [key, next.layers[key]]));
-        const controls = Object.fromEntries(controlKeys.map((key) => [key, next.controls[key]]));
-        const features = patch.features === undefined
-            ? next.features
-            : Object.fromEntries(Object.keys(patch.features).map((key) => [
-                key,
-                next.features[key],
-            ]));
-        let committed = false;
-        element.applyPresentation({ ...patch, ...('appearance' in patch ? { appearance: next.appearance } : {}) }, () => {
-            committed = true;
-            config = next;
-            if (hasFeatures)
-                element.setFeatures(features);
-            if (hasLayers)
-                element.setLayers(layers);
-            if (hasControls)
-                element.setControls(controls);
-        }, () => !destroyed && revision === configurationRevision);
-        return committed && !destroyed && revision === configurationRevision;
-    }
     return Object.freeze({
         element,
         overlayElement: element.overlayElement,
@@ -152,7 +129,7 @@ export function createMap(data, options = {}) {
             return destroyed;
         },
         configure: use((patch) => {
-            configure(configurationPatch(patch, config));
+            configure(configurationPatch(patch, configuration.current));
         }),
         resetConfiguration: use((groups = ['features', 'layers', 'controls', 'appearance']) => {
             if (!Array.isArray(groups) ||
@@ -242,7 +219,7 @@ export function createMap(data, options = {}) {
         selectDistrict: use(element.selectDistrict),
         getSelectedDistrict: use(element.getSelectedDistrict),
         setDistrictYear: use((...args) => {
-            configurationRevision++;
+            configuration.invalidate();
             element.setDistrictYear(...args);
         }),
         setDistrictStyle: use((style) => {

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.3 · 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.3 · 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.3 · 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.3 · 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.3 · 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.3 · 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.3 · 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.3 · 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.3 · 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.3 · local working tree. -->
 
 # Changelog
 
@@ -1329,6 +1329,10 @@ User-visible changes are recorded here. Unreleased entries describe changes on `
 
 ## Unreleased
 
+## 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 +1725,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.3 · 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 |
 | --- | --- |

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.3 · 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.3",
   "description": "Offline SVG maps of San Francisco with district boundaries, parks, landmarks, and BART stations.",
   "type": "module",
   "main": "./dist/src/api.js",