@kahwee/sf-map-svg 5.1.3 → 5.1.4

package/CHANGELOG.md

@@ -4,6 +4,10 @@ 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.

package/dist/src/cluster-renderer.d.ts

@@ -1,5 +1,5 @@
 import type { normalizeFeatures } from './features.js';
-import type { MarkerItem, MarkerVisual } from './marker-layer.js';
+import type { MarkerItem, MarkerVisual } from './interactive/marker-renderer.js';
 import type { createMarkerNavigation } from './marker-navigation.js';
 import type { MapViewport } from './types.js';
 interface ClusterState {

package/dist/src/district-layer.d.ts

@@ -1,4 +1,4 @@
-import type { DistrictRowData } from './map-core.js';
+import type { DistrictRowData } from './rendering/svg-map-renderer.js';
 import type { DistrictStyle, DistrictYear, SFMapOptions } from './types.js';
 /** Apply prepared styles and interaction state without invoking consumer callbacks. */
 export declare function renderDistrictAppearance({ svg, rows, styles, selectedDistrict, hoveredDistrict, year, theme, colors, fills, lines, }: {

package/dist/src/district-layer.js

@@ -1,4 +1,4 @@
-import { districtColors } from './map-core.js';
+import { districtColors } from './rendering/svg-map-renderer.js';
 /** Apply prepared styles and interaction state without invoking consumer callbacks. */
 export function renderDistrictAppearance({ svg, rows, styles, selectedDistrict, hoveredDistrict, year, theme, colors, fills, lines, }) {
     for (const row of rows) {

package/dist/src/district-style.d.ts

@@ -1,4 +1,4 @@
-import type { DistrictRowData } from './map-core.js';
+import type { DistrictRowData } from './rendering/svg-map-renderer.js';
 import type { DistrictStyle, SFMapOptions } from './types.js';
 /** Evaluate user code once and copy its result before changing the map. */
 export declare function prepareDistrictStyles(rows: readonly DistrictRowData[], callback: SFMapOptions['districtStyle']): ReadonlyMap<number, DistrictStyle>;

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

@@ -1,5 +1,5 @@
 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 {

package/dist/src/guide-map.js

@@ -1,7 +1,7 @@
 import { expandMapOptions, prepareConfiguration } from './configuration.js';
-import { createNeighborhoodExplorerCore } from './explorer-core.js';
-import { createMapShell } from './explorer-shell.js';
 import { guideMapData } from './guide-data.js';
+import { createMapEngine } from './interactive/map-engine.js';
+import { createMapShell } from './interactive/map-shell.js';
 import { createMap } from './map.js';
 import { guideOptions } from './presets.js';
 import { validateExplorerOptions } from './validation.js';
@@ -62,7 +62,7 @@ function mountFrame(frame, map) {
 /** Element-based compatibility API. Prefer createGuideController for new integrations. */
 export function createGuideMap(options = {}) {
     validateExplorerOptions(options);
-    return createNeighborhoodExplorerCore({
+    return createMapEngine({
         mode: 'neighborhoods',
         ...options,
         layers: {

package/dist/src/{configuration-controller.d.ts → interactive/configuration-controller.d.ts}

@@ -1,6 +1,6 @@
-import { prepareConfiguration } from './configuration.js';
-import type { MapConfiguration } from './controller-types.js';
-import type { NeighborhoodExplorerElement } from './types.js';
+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;
@@ -12,10 +12,10 @@ export interface ConfigurationTarget extends Pick<NeighborhoodExplorerElement, '
 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;
+        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 → interactive/configuration-controller.js}

@@ -1,5 +1,5 @@
-import { prepareConfiguration } from './configuration.js';
-import { controlKeys, layerKeys } from './features.js';
+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;

package/dist/src/{district-controller.d.ts → interactive/district-controller.d.ts}

@@ -1,9 +1,9 @@
-import type { Geometry, Position } from '../data/types.js';
-import { prepareDistrictStyles } from './district-style.js';
-import type { InteractiveSFMapData } from './explorer-data.js';
-import type { normalizeFeatures } from './features.js';
-import type { LabelItem } from './label-candidates.js';
-import type { CameraOptions, DistrictSelection, DistrictYear, NeighborhoodExplorerOptions } from './types.js';
+import type { Geometry, Position } from '../../data/types.js';
+import { prepareDistrictStyles } from '../district-style.js';
+import type { InteractiveSFMapData } from '../explorer-data.js';
+import type { normalizeFeatures } from '../features.js';
+import type { LabelItem } from '../label-candidates.js';
+import type { CameraOptions, DistrictSelection, DistrictYear, NeighborhoodExplorerOptions } from '../types.js';
 type Host = {
     root: HTMLElement;
     svg: SVGSVGElement;
@@ -23,12 +23,12 @@ type Host = {
     fitGeometry(geometry: Geometry, padding: undefined, options: CameraOptions): void;
     project(point: Position): [number, number];
     setLabels(items: LabelItem[]): void;
-    updateComposition(): void;
+    syncLayerComposition(): void;
     scheduleLabels(): void;
 };
 /** Owns district selection, styles, revisions and cancellable motion. */
 export declare function createDistrictController(host: Host, initialDistrictStyle: NeighborhoodExplorerOptions['districtStyle']): {
-    districtRow: (id: number) => import("./map-core.js").DistrictRowData | undefined;
+    districtRow: (id: number) => import("../rendering/svg-map-renderer.js").DistrictRowData | undefined;
     districtSelection: (id: number | null) => DistrictSelection | {
         id: null;
         year: DistrictYear;
@@ -40,7 +40,7 @@ export declare function createDistrictController(host: Host, initialDistrictStyl
         fit?: boolean;
     } & CameraOptions) => boolean;
     activateDistrict: (id: number) => boolean;
-    setDistrictStyle: (style: ((district: import('./map-core.js').DistrictRowData) => import("./types.js").DistrictStyle) | undefined) => void;
+    setDistrictStyle: (style: ((district: import("../rendering/svg-map-renderer.js").DistrictRowData) => import("../types.js").DistrictStyle) | undefined) => void;
     setDistrictYear: (next: DistrictYear, options?: CameraOptions, preparedStyles?: ReturnType<typeof prepareDistrictStyles>) => void;
     transition: {
         cancel(): void;
@@ -56,9 +56,9 @@ export declare function createDistrictController(host: Host, initialDistrictStyl
     };
     readonly revision: number;
     invalidate(): void;
-    readonly style: ((district: import('./map-core.js').DistrictRowData) => import("./types.js").DistrictStyle) | undefined;
-    readonly styles: ReadonlyMap<number, import("./types.js").DistrictStyle>;
-    commitStyles(style: ((district: import('./map-core.js').DistrictRowData) => import("./types.js").DistrictStyle) | undefined, styles: ReadonlyMap<number, import("./types.js").DistrictStyle>): void;
+    readonly style: ((district: import("../rendering/svg-map-renderer.js").DistrictRowData) => import("../types.js").DistrictStyle) | undefined;
+    readonly styles: ReadonlyMap<number, import("../types.js").DistrictStyle>;
+    commitStyles(style: ((district: import("../rendering/svg-map-renderer.js").DistrictRowData) => import("../types.js").DistrictStyle) | undefined, styles: ReadonlyMap<number, import("../types.js").DistrictStyle>): void;
     hovered: number | null;
 };
 export {};

package/dist/src/{district-controller.js → interactive/district-controller.js}

@@ -1,13 +1,13 @@
-import { validateCameraOptions } from './camera.js';
-import { renderDistrictAppearance } from './district-layer.js';
-import { createDistrictMorph } from './district-morph.js';
-import { prepareDistrictStyles } from './district-style.js';
-import { createDistrictTransition } from './district-transition.js';
-import { svgElement } from './dom.js';
-import { getLayerPathsWithData } from './map-core.js';
+import { validateCameraOptions } from '../camera.js';
+import { renderDistrictAppearance } from '../district-layer.js';
+import { createDistrictMorph } from '../district-morph.js';
+import { prepareDistrictStyles } from '../district-style.js';
+import { createDistrictTransition } from '../district-transition.js';
+import { svgElement } from '../dom.js';
+import { getLayerPathsWithData } from '../rendering/svg-map-renderer.js';
 /** Owns district selection, styles, revisions and cancellable motion. */
 export function createDistrictController(host, initialDistrictStyle) {
-    const { root, svg, status, data, districtLayers, reducedMotion, enabled, fitGeometry, updateComposition, scheduleLabels, } = host;
+    const { root, svg, status, data, districtLayers, reducedMotion, enabled, fitGeometry, syncLayerComposition, scheduleLabels, } = host;
     const districtMorph = createDistrictMorph();
     let selectedDistrict = null;
     let hoveredDistrict = null;
@@ -160,7 +160,7 @@ export function createDistrictController(host, initialDistrictStyle) {
         if (selectedDistrict === null)
             delete root.dataset.selectedDistrict;
         updateDistrictAppearance();
-        updateComposition();
+        syncLayerComposition();
         if (morph && lineLayer && previousOutlines)
             districtMorph.start(lineLayer, previousOutlines, {
                 duration: morph.duration,

package/dist/src/{explorer-sidebar.d.ts → interactive/explorer-sidebar.d.ts}

@@ -1,7 +1,7 @@
-import type { NeighborhoodFeature, NeighborhoodSource } from '../data/types.js';
-import type { InteractiveSFMapData } from './explorer-data.js';
-import type { createExplorerShell } from './explorer-shell.js';
-import type { DistrictYear, ExplorerMode } from './types.js';
+import type { NeighborhoodFeature, NeighborhoodSource } from '../../data/types.js';
+import type { InteractiveSFMapData } from '../explorer-data.js';
+import type { DistrictYear, ExplorerMode } from '../types.js';
+import type { createExplorerShell } from './map-shell.js';
 interface SidebarState {
     mode: ExplorerMode;
     year: DistrictYear;
@@ -13,8 +13,8 @@ export declare function createExplorerSidebar({ detail, results, search, count,
     id: string;
     canonicalName: string;
 }[]): {
-    updateDetail: ({ mode, year, source, selected }: SidebarState) => void;
-    updateResults: ({ source, selected }: SidebarState) => void;
+    updateSelectionDetail: ({ mode, year, source, selected }: SidebarState) => void;
+    updateNeighborhoodResults: ({ source, selected }: SidebarState) => void;
     destroy: () => void;
 };
 export {};

package/dist/src/{explorer-sidebar.js → interactive/explorer-sidebar.js}

@@ -1,4 +1,4 @@
-import { element } from './dom.js';
+import { element } from '../dom.js';
 /** Render sidebar snapshots and own every download URL until replacement or disposal. */
 export function createExplorerSidebar({ detail, results, search, count, }, data, chrome, emptyResults, searchNeighborhoods) {
     const downloads = new Set();
@@ -15,7 +15,7 @@ export function createExplorerSidebar({ detail, results, search, count, }, data,
         link.download = filename;
         return link;
     }
-    function updateDetail({ mode, year, source, selected }) {
+    function updateSelectionDetail({ mode, year, source, selected }) {
         releaseDownloads();
         if (chrome === 'map')
             return;
@@ -53,7 +53,7 @@ export function createExplorerSidebar({ detail, results, search, count, }, data,
         provenance.append(element('summary', 'About these boundaries'), element('p', collection.definition.description));
         detail.append(provenance);
     }
-    function updateResults({ source, selected }) {
+    function updateNeighborhoodResults({ source, selected }) {
         if (chrome === 'map')
             return;
         const activeElement = document.activeElement;
@@ -75,5 +75,5 @@ export function createExplorerSidebar({ detail, results, search, count, }, data,
         if (!matches.length)
             results.append(element('p', emptyResults ?? 'No matches. Try another name or definition source.', 'sf-explorer-note'));
     }
-    return { updateDetail, updateResults, destroy: releaseDownloads };
+    return { updateSelectionDetail, updateNeighborhoodResults, destroy: releaseDownloads };
 }

package/dist/src/{label-coordinator.d.ts → interactive/label-coordinator.d.ts}

@@ -1,11 +1,11 @@
-import type { View } from './explorer-layout.js';
-import type { normalizeFeatures } from './features.js';
-import { type LabelItem } from './label-candidates.js';
-import type { createMarkerCatalog } from './marker-catalog.js';
+import type { View } from '../explorer-layout.js';
+import type { normalizeFeatures } from '../features.js';
+import { type LabelItem } from '../label-candidates.js';
+import type { createMarkerCatalog } from '../marker-catalog.js';
+import type { createNeighborhoodLayer } from '../neighborhood-layer.js';
+import type { ExplorerMode, InteractiveLayers, NeighborhoodExplorerOptions } from '../types.js';
 import type { createMarkerController } from './marker-controller.js';
-import type { MarkerItem, MarkerVisual } from './marker-layer.js';
-import type { createNeighborhoodLayer } from './neighborhood-layer.js';
-import type { ExplorerMode, InteractiveLayers, NeighborhoodExplorerOptions } from './types.js';
+import type { MarkerItem, MarkerVisual } from './marker-renderer.js';
 interface LabelHost {
     root: HTMLElement;
     canvas: HTMLElement;

package/dist/src/{label-coordinator.js → interactive/label-coordinator.js}

@@ -1,5 +1,5 @@
-import { setAttributeIfChanged } from './dom.js';
-import { labelCandidates, styleLabels, } from './label-candidates.js';
+import { setAttributeIfChanged } from '../dom.js';
+import { labelCandidates, styleLabels, } from '../label-candidates.js';
 import { createLabelRenderer } from './label-renderer.js';
 /** Own candidate caching, screen-space collision layout and label metrics invalidation. */
 export function createLabelCoordinator(host) {

package/dist/src/{label-renderer.d.ts → interactive/label-renderer.d.ts}

@@ -1,5 +1,5 @@
-import type { Bounds } from '../data/types.js';
-import type { RenderLabel } from './label-candidates.js';
+import type { Bounds } from '../../data/types.js';
+import type { RenderLabel } from '../label-candidates.js';
 /** Reuse text nodes and screen-space metrics throughout a camera animation. */
 export declare function createLabelRenderer(layer: SVGGElement): {
     invalidateMetrics(): void;

package/dist/src/{label-renderer.js → interactive/label-renderer.js}

@@ -1,5 +1,5 @@
-import { setAttributeIfChanged } from './dom.js';
-import { layoutLabels } from './explorer-layout.js';
+import { setAttributeIfChanged } from '../dom.js';
+import { layoutLabels } from '../explorer-layout.js';
 /** Reuse text nodes and screen-space metrics throughout a camera animation. */
 export function createLabelRenderer(layer) {
     const entries = new Map();

package/dist/src/{explorer-controls.d.ts → interactive/map-controls.d.ts}

@@ -1,5 +1,5 @@
-import type { createExplorerShell } from './explorer-shell.js';
-import type { MapViewport, NeighborhoodExplorerElement, NeighborhoodExplorerOptions } from './types.js';
+import type { MapViewport, NeighborhoodExplorerElement, NeighborhoodExplorerOptions } from '../types.js';
+import type { createExplorerShell } from './map-shell.js';
 type Controls = NonNullable<NeighborhoodExplorerOptions['controls']>;
 type Shell = Pick<ReturnType<typeof createExplorerShell>, 'root' | 'toolbar' | 'canvas' | 'hint' | 'status' | 'modeSelect' | 'sourceSelect' | 'search' | 'results' | 'neighborhoodSelect' | 'markerSelect'>;
 type Commands = Pick<NeighborhoodExplorerElement, 'getViewport' | 'zoomBy' | 'resetView' | 'setLabels' | 'stopAnimation' | 'setMode' | 'setSource' | 'selectNeighborhood' | 'selectMarker'> & {
@@ -10,13 +10,13 @@ type Commands = Pick<NeighborhoodExplorerElement, 'getViewport' | 'zoomBy' | 're
     getLabels(): boolean;
     moveView(view: MapViewport): void;
     setView(view: MapViewport): void;
-    updateResults(): void;
+    updateNeighborhoodResults(): void;
     search(query: string): string | undefined;
 };
 /** Own toolbar and form events, touch navigation and control visibility.
  * Commands read current map state; all listeners share the map's disposal signal.
  */
-export declare function createExplorerControls({ root, toolbar, canvas, hint, status, modeSelect, sourceSelect, search, results, neighborhoodSelect, markerSelect, }: Shell, { svg, signal, strings, isDestroyed, getLabels, getViewport, moveView, zoomBy, resetView, setLabels, stopAnimation, setView, setMode, setSource, selectNeighborhood, selectMarker, updateResults, search: findNeighborhood, }: Commands): {
+export declare function createMapControls({ root, toolbar, canvas, hint, status, modeSelect, sourceSelect, search, results, neighborhoodSelect, markerSelect, }: Shell, { svg, signal, strings, isDestroyed, getLabels, getViewport, moveView, zoomBy, resetView, setLabels, stopAnimation, setView, setMode, setSource, selectNeighborhood, selectMarker, updateNeighborhoodResults, search: findNeighborhood, }: Commands): {
     setTouchNavigation: (enabled: boolean) => void;
     cancelNavigation: () => void;
     update(controls: Controls): void;

package/dist/src/{explorer-controls.js → interactive/map-controls.js}

@@ -1,9 +1,9 @@
-import { element } from './dom.js';
-import { attachNavigation } from './navigation.js';
+import { element } from '../dom.js';
+import { attachNavigation } from '../navigation.js';
 /** Own toolbar and form events, touch navigation and control visibility.
  * Commands read current map state; all listeners share the map's disposal signal.
  */
-export function createExplorerControls({ root, toolbar, canvas, hint, status, modeSelect, sourceSelect, search, results, neighborhoodSelect, markerSelect, }, { svg, signal, strings, isDestroyed, getLabels, getViewport, moveView, zoomBy, resetView, setLabels, stopAnimation, setView, setMode, setSource, selectNeighborhood, selectMarker, updateResults, search: findNeighborhood, }) {
+export function createMapControls({ root, toolbar, canvas, hint, status, modeSelect, sourceSelect, search, results, neighborhoodSelect, markerSelect, }, { svg, signal, strings, isDestroyed, getLabels, getViewport, moveView, zoomBy, resetView, setLabels, stopAnimation, setView, setMode, setSource, selectNeighborhood, selectMarker, updateNeighborhoodResults, search: findNeighborhood, }) {
     function listen(node, event, handler) {
         node.addEventListener(event, (incoming) => handler(incoming), { signal });
     }
@@ -63,7 +63,7 @@ export function createExplorerControls({ root, toolbar, canvas, hint, status, mo
         if (next === 'neighborhoods' || next === 'districts' || next === 'basemap')
             setMode(next);
     });
-    listen(search, 'input', updateResults);
+    listen(search, 'input', updateNeighborhoodResults);
     listen(search, 'keydown', (event) => {
         if (event.key === 'Enter') {
             const match = findNeighborhood(search.value);

package/dist/src/{explorer-core.d.ts → interactive/map-engine.d.ts}

@@ -1,11 +1,11 @@
-import type { NeighborhoodSource } from '../data/types.js';
+import type { NeighborhoodSource } from '../../data/types.js';
+import type { MapConfiguration } from '../controller-types.js';
+import type { InteractiveSFMapData } from '../explorer-data.js';
+import type { DistrictYear, ExplorerMode, NeighborhoodExplorerElement, NeighborhoodExplorerOptions } from '../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';
 import type { createExplorerSidebar } from './explorer-sidebar.js';
-import type { DistrictYear, ExplorerMode, NeighborhoodExplorerElement, NeighborhoodExplorerOptions } from './types.js';
-export type { ExplorerMode, NeighborhoodExplorerElement, NeighborhoodExplorerOptions, } from './types.js';
+import type { createMapShell } from './map-shell.js';
+export type { ExplorerMode, NeighborhoodExplorerElement, NeighborhoodExplorerOptions, } from '../types.js';
 /** Private bridge between the renderer and its public lifecycle controller. */
 type MapEngineElement = NeighborhoodExplorerElement & {
     preparePresentation(patch: MapConfiguration): PreparedPresentation | undefined;
@@ -17,7 +17,7 @@ type MapEngineElement = NeighborhoodExplorerElement & {
     };
 };
 /** Create an offline, browser-only neighborhood explorer. Call destroy() before disposal. */
-export declare function createNeighborhoodExplorerCore(options: NeighborhoodExplorerOptions | undefined, data: InteractiveSFMapData, ui: {
+export declare function createMapEngine(options: NeighborhoodExplorerOptions | undefined, data: InteractiveSFMapData, ui: {
     createShell: typeof createMapShell;
     createSidebar?: typeof createExplorerSidebar;
 }): MapEngineElement;

package/dist/src/{explorer-core.js → interactive/map-engine.js}

@@ -1,28 +1,28 @@
-import { copyAppearance } from './appearance.js';
-import { createCamera, validateCameraOptions } from './camera.js';
-import { createClusterLayer } from './cluster-layer.js';
-import { clusterPoints } from './clusters.js';
+import { copyAppearance } from '../appearance.js';
+import { createCamera, validateCameraOptions } from '../camera.js';
+import { createClusterLayer } from '../cluster-layer.js';
+import { clusterPoints } from '../clusters.js';
+import { prepareDistrictStyles } from '../district-style.js';
+import { element, svgElement } from '../dom.js';
+import { fitBounds, projectedBounds } from '../explorer-layout.js';
+import { controlKeys, layerKeys, normalizeFeatures, validateSwitchPatch } from '../features.js';
+import { createFrameScheduler } from '../frame-scheduler.js';
+import { createLayerTransitions } from '../layer-transition.js';
+import { createMarkerCatalog } from '../marker-catalog.js';
+import { createMarkerChooser } from '../marker-chooser.js';
+import { createMarkerNavigation } from '../marker-navigation.js';
+import { createNeighborhoodLayer, createNeighborhoodLookup, formatSourceLabel, } from '../neighborhood-layer.js';
+import { createOverlayLayer } from '../overlay-layer.js';
+import { createSFMapWithData, districtColors, getLayerPathsWithData, resolveMapColors, } from '../rendering/svg-map-renderer.js';
+import { validateExplorerOptions } from '../validation.js';
+import { fitViewport, validateViewport } from '../viewport.js';
 import { createDistrictController } from './district-controller.js';
-import { prepareDistrictStyles } from './district-style.js';
-import { element, svgElement } from './dom.js';
-import { createExplorerControls } from './explorer-controls.js';
-import { fitBounds, projectedBounds } from './explorer-layout.js';
-import { controlKeys, layerKeys, normalizeFeatures, validateSwitchPatch } from './features.js';
-import { createFrameScheduler } from './frame-scheduler.js';
 import { createLabelCoordinator } from './label-coordinator.js';
-import { createLayerTransitions } from './layer-transition.js';
-import { createSFMapWithData, districtColors, getLayerPathsWithData, resolveMapColors, } from './map-core.js';
-import { createMarkerCatalog } from './marker-catalog.js';
-import { createMarkerChooser } from './marker-chooser.js';
+import { createMapControls } from './map-controls.js';
 import { createMarkerController } from './marker-controller.js';
-import { createMarkerLayer } from './marker-layer.js';
-import { createMarkerNavigation } from './marker-navigation.js';
-import { createNeighborhoodLayer, createNeighborhoodLookup, formatSourceLabel, } from './neighborhood-layer.js';
-import { createOverlayLayer } from './overlay-layer.js';
-import { validateExplorerOptions } from './validation.js';
-import { fitViewport, validateViewport } from './viewport.js';
+import { createMarkerRenderer } from './marker-renderer.js';
 /** Create an offline, browser-only neighborhood explorer. Call destroy() before disposal. */
-export function createNeighborhoodExplorerCore(options = {}, data, ui) {
+export function createMapEngine(options = {}, data, ui) {
     validateExplorerOptions(options);
     let { source = 'realtor', mode = 'neighborhoods', labels = true, neighborhood, year = 2022, theme = 'transit', colors = {}, labelStyle = {}, areaStyle = {}, districtStyle: initialDistrictStyle, motion = false, markerEntrance = false, selectedMarkerRing, clustering = false, legend: legendOptions = {}, attribution: attributionMode = 'full', northArrow = false, scaleBar = false, layerTransitions = false, districtMorph: districtMorphOption = false, interface: chrome = 'explorer', layers = {}, selectableNeighborhoods = true, labelSize = {}, fitPadding = 24, markers: initialMarkers = [], markerRadius = 6, markerHitSize = 44, markerColor = colors.marker ?? '#245b61', selectedMarkerColor = colors.selected ?? '#f04f32', onMarkerActivate, overlays: initialOverlays = [], onOverlayActivate, style: styleOptions = {}, strings = {}, controls = {}, } = options;
     if (!['neighborhoods', 'districts', 'basemap'].includes(mode))
@@ -188,7 +188,7 @@ export function createNeighborhoodExplorerCore(options = {}, data, ui) {
         reducedMotion,
         enabled,
         fitGeometry,
-        updateComposition,
+        syncLayerComposition,
         scheduleLabels,
         get year() {
             return year;
@@ -229,7 +229,7 @@ export function createNeighborhoodExplorerCore(options = {}, data, ui) {
         cancel: (id) => cancelAnimationFrame(id),
         render: drawLabels,
     });
-    const markerRenderer = createMarkerLayer();
+    const markerRenderer = createMarkerRenderer();
     const cancelEntrances = markerRenderer.cancelEntrances;
     const camera = createCamera({
         read: getViewport,
@@ -271,13 +271,13 @@ export function createNeighborhoodExplorerCore(options = {}, data, ui) {
         refresh: {
             selection() {
                 scheduleLabels();
-                updateResults();
-                updateDetail();
+                updateNeighborhoodResults();
+                updateSelectionDetail();
             },
             source() {
-                updateResults();
-                updateDetail();
-                updateComposition();
+                updateNeighborhoodResults();
+                updateSelectionDetail();
+                syncLayerComposition();
             },
         },
         moveView,
@@ -466,7 +466,7 @@ export function createNeighborhoodExplorerCore(options = {}, data, ui) {
         isDestroyed: () => destroyed,
     });
     const setOverlays = overlays.set;
-    const mapControls = createExplorerControls(shell, {
+    const mapControls = createMapControls(shell, {
         svg,
         signal: controller.signal,
         strings,
@@ -483,7 +483,7 @@ export function createNeighborhoodExplorerCore(options = {}, data, ui) {
         setSource,
         selectNeighborhood,
         selectMarker,
-        updateResults,
+        updateNeighborhoodResults,
         search(query) {
             const exact = getNeighborhood(query, neighborhoods.source);
             const matches = searchNeighborhoods(query, neighborhoods.source);
@@ -604,16 +604,16 @@ export function createNeighborhoodExplorerCore(options = {}, data, ui) {
         labelCoordinator.draw();
     }
     const sidebar = ui.createSidebar?.(shell, data, chrome, strings.emptyResults, searchNeighborhoods);
-    function updateDetail() {
-        sidebar?.updateDetail({
+    function updateSelectionDetail() {
+        sidebar?.updateSelectionDetail({
             mode,
             year,
             source: neighborhoods.source,
             selected: neighborhoods.selected,
         });
     }
-    function updateResults() {
-        sidebar?.updateResults({
+    function updateNeighborhoodResults() {
+        sidebar?.updateNeighborhoodResults({
             mode,
             year,
             source: neighborhoods.source,
@@ -629,9 +629,9 @@ export function createNeighborhoodExplorerCore(options = {}, data, ui) {
         validateSwitchPatch(patch, layerKeys);
         const next = { ...layers, ...patch };
         layers = next;
-        updateComposition();
+        syncLayerComposition();
     }
-    function updateComposition() {
+    function syncLayerComposition() {
         for (const [name, key] of [
             ['landmarks', 'landmarks'],
             ['highways', 'highways'],
@@ -715,7 +715,7 @@ export function createNeighborhoodExplorerCore(options = {}, data, ui) {
         controls = next;
         mapControls.update(controls);
         markerLabel.hidden = !markerCatalog.items.length || controls.markerPicker === false;
-        updateComposition();
+        syncLayerComposition();
     }
     function setMode(next, reset = true) {
         if (destroyed)
@@ -734,8 +734,8 @@ export function createNeighborhoodExplorerCore(options = {}, data, ui) {
         const districts = mode !== 'neighborhoods';
         for (const node of [sourceLabel, searchLabel, count, results])
             node.hidden = districts;
-        updateComposition();
-        updateDetail();
+        syncLayerComposition();
+        updateSelectionDetail();
         status.textContent =
             mode === 'basemap'
                 ? 'San Francisco basemap.'
@@ -755,7 +755,7 @@ export function createNeighborhoodExplorerCore(options = {}, data, ui) {
         labels = visible;
         mapControls.updateLabels(labels);
         root.dataset.labels = String(labels);
-        updateComposition();
+        syncLayerComposition();
         if (!labels) {
             labelLayer.replaceChildren();
             root.dataset.visibleLabels = '0';

package/dist/src/{explorer-shell.d.ts → interactive/map-shell.d.ts}

@@ -1,5 +1,5 @@
-import type { NeighborhoodSource } from '../data/types.js';
-import type { NeighborhoodExplorerOptions } from './types.js';
+import type { NeighborhoodSource } from '../../data/types.js';
+import type { NeighborhoodExplorerOptions } from '../types.js';
 /** Construct shared map chrome; optional explorer content has its own factory below. */
 export declare function createMapShell({ chrome, styleOptions, strings, legendOptions, colors, attributionMode, }: {
     source: NeighborhoodSource;

package/dist/src/{explorer-shell.js → interactive/map-shell.js}

@@ -1,5 +1,5 @@
-import { element } from './dom.js';
-import { sourceNames } from './neighborhood-layer.js';
+import { element } from '../dom.js';
+import { sourceNames } from '../neighborhood-layer.js';
 let explorerCount = 0;
 /** Construct shared map chrome; optional explorer content has its own factory below. */
 export function createMapShell({ chrome, styleOptions, strings, legendOptions, colors, attributionMode, }) {

package/dist/src/{marker-controller.d.ts → interactive/marker-controller.d.ts}

@@ -1,11 +1,11 @@
-import type { Position } from '../data/types.js';
-import { type View } from './explorer-layout.js';
-import type { normalizeFeatures } from './features.js';
-import type { createMarkerCatalog } from './marker-catalog.js';
-import type { createMarkerChooser } from './marker-chooser.js';
-import type { MarkerItem, MarkerVisual } from './marker-layer.js';
-import type { createMarkerNavigation } from './marker-navigation.js';
-import type { CameraOptions, MapMarker, NeighborhoodExplorerOptions } from './types.js';
+import type { Position } from '../../data/types.js';
+import { type View } from '../explorer-layout.js';
+import type { normalizeFeatures } from '../features.js';
+import type { createMarkerCatalog } from '../marker-catalog.js';
+import type { createMarkerChooser } from '../marker-chooser.js';
+import type { createMarkerNavigation } from '../marker-navigation.js';
+import type { CameraOptions, MapMarker, NeighborhoodExplorerOptions } from '../types.js';
+import type { MarkerItem, MarkerVisual } from './marker-renderer.js';
 interface MarkerHost {
     root: HTMLElement;
     canvas: HTMLElement;

package/dist/src/{marker-controller.js → interactive/marker-controller.js}

@@ -1,6 +1,6 @@
-import { validateCameraOptions } from './camera.js';
-import { fitBounds } from './explorer-layout.js';
-import { fitViewport } from './viewport.js';
+import { validateCameraOptions } from '../camera.js';
+import { fitBounds } from '../explorer-layout.js';
+import { fitViewport } from '../viewport.js';
 /** Own selection revisions, activation and focus recovery independently of marker rendering. */
 export function createMarkerController(host) {
     const { root, canvas, svg, markerLayer, markerSelect, markerLabel, markerCatalog, markerNavigation, strings, fitPadding, onMarkerActivate, invalidateClusters, drawClusters, materializeMarker, scheduleLabels, syncFeatureControls, moveView, } = host;

package/dist/src/{marker-layer.d.ts → interactive/marker-renderer.d.ts}

@@ -1,5 +1,5 @@
-import type { normalizeFeatures } from './features.js';
-import type { MapMarker } from './types.js';
+import type { normalizeFeatures } from '../features.js';
+import type { MapMarker } from '../types.js';
 export interface MarkerVisual {
     node: SVGGElement;
     dot: SVGCircleElement;
@@ -15,7 +15,7 @@ export interface MarkerItem {
     visual: MarkerVisual | undefined;
 }
 /** Own marker visuals and entrances; selection/events remain with the controller. */
-export declare function createMarkerLayer(): {
+export declare function createMarkerRenderer(): {
     cancelEntrances: () => void;
     remove(item: MarkerItem): void;
     update(item: MarkerItem, marker: MapMarker, point: [number, number], index: number): void;

package/dist/src/{marker-layer.js → interactive/marker-renderer.js}

@@ -1,6 +1,6 @@
-import { svgElement } from './dom.js';
+import { svgElement } from '../dom.js';
 /** Own marker visuals and entrances; selection/events remain with the controller. */
-export function createMarkerLayer() {
+export function createMarkerRenderer() {
     const records = new Set();
     const animations = new Map();
     function cancelEntrances() {

package/dist/src/map.js

@@ -1,10 +1,10 @@
 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 { layerKeys } from './features.js';
+import { createConfigurationController } from './interactive/configuration-controller.js';
+import { createMapEngine } from './interactive/map-engine.js';
+import { createMapShell } from './interactive/map-shell.js';
 import { assertOptions } from './validation.js';
 /** No geography is imported. Supply a preset or your own immutable data. */
 export function createMap(data, options = {}) {
@@ -15,7 +15,7 @@ export function createMap(data, options = {}) {
         controls: options.controls,
         appearance: options.appearance,
     });
-    const element = createNeighborhoodExplorerCore({
+    const element = createMapEngine({
         mode: 'basemap',
         ...expanded,
         interface: 'map',

package/dist/src/marker-catalog.d.ts

@@ -1,7 +1,7 @@
-import type { createMarkerLayer, MarkerItem } from './marker-layer.js';
+import type { createMarkerRenderer, MarkerItem } from './interactive/marker-renderer.js';
 import type { MapMarker } from './types.js';
 /** Own ordered records and picker reconciliation; prepare before committing DOM changes. */
-export declare function createMarkerCatalog(renderer: ReturnType<typeof createMarkerLayer>, picker: HTMLSelectElement, project: (point: import('../data/types.js').Position) => [number, number]): {
+export declare function createMarkerCatalog(renderer: ReturnType<typeof createMarkerRenderer>, picker: HTMLSelectElement, project: (point: import('../data/types.js').Position) => [number, number]): {
     readonly items: MarkerItem[];
     prepare(markers: readonly MapMarker[], selected: string | null): {
         selection: string | null;

package/dist/src/{layers.d.ts → rendering/svg-layers.d.ts}

@@ -1,8 +1,8 @@
-import type { Geometry } from '../data/types.js';
-import type { DistrictRow } from './data.js';
-import type { Project } from './geometry.js';
-import type { BartStation, KeyRoad, Landmark } from './overlays.js';
-import type { MapMarker, SFMapOptions } from './types.js';
+import type { Geometry } from '../../data/types.js';
+import type { DistrictRow } from '../data.js';
+import type { Project } from '../geometry.js';
+import type { BartStation, KeyRoad, Landmark } from '../overlays.js';
+import type { MapMarker, SFMapOptions } from '../types.js';
 interface LayerContext {
     labels: boolean;
     /** Animated static maps index items for staggering and measure lines for drawing. */

package/dist/src/{layers.js → rendering/svg-layers.js}

@@ -1,4 +1,4 @@
-import { escapeXml, number, overlayLabel, stroke } from './svg.js';
+import { escapeXml, number, overlayLabel, stroke } from './svg-primitives.js';
 /** Custom JavaScript/JSON rows must not introduce markup or CSS through numeric IDs. */
 function districtId(id) {
     if (!Number.isFinite(id))

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.3 · 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.3 · 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.3 · 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.3 · 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.3 · 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.3 · 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.3 · 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.3 · 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.3 · 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.3 · local working tree. -->
+<!-- Generated from CHANGELOG.md; @kahwee/sf-map-svg 5.1.4 · local working tree. -->
 
 # Changelog
 
@@ -1329,6 +1329,10 @@ 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.
@@ -1725,7 +1729,7 @@ consistent home, and makes animation and subscription ownership predictable.
 
 # Published type contracts
 
-@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.
+@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 |
 | --- | --- |
@@ -2111,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;
@@ -2156,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;
@@ -2378,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 {
@@ -2388,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[]>>>;
@@ -2516,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.3 · 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.3",
+  "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",