@kahwee/sf-map-svg 5.1.1 → 5.1.3

package/CHANGELOG.md

@@ -4,6 +4,14 @@ 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.
+
 ## 5.1.1 — 2026-11-05
 
 - Reserve precinct report controls and status space during loading to prevent phone layout shifts when multiple reports are available.

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;