@kahwee/sf-map-svg 4.3.1 → 4.4.0

package/dist/src/static-labels.js

@@ -0,0 +1,100 @@
+import { interiorAnchor, layoutLabels, projectedBounds } from './explorer-layout.js';
+import { labelCandidates, styleLabels } from './label-candidates.js';
+import { escapeXml, number } from './svg.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 +
+        (/[\u0300-\u036f]/u.test(char)
+            ? 0
+            : /[\s.,:;'!|ilI]/u.test(char)
+                ? 0.32
+                : /[MW@%]/u.test(char)
+                    ? 0.95
+                    : (char.codePointAt(0) ?? 0) > 0x024f
+                        ? 1
+                        : /[A-Z]/u.test(char)
+                            ? 0.72
+                            : 0.6) *
+            fontSize, 0);
+}
+/** Interactive overview rules, expressed entirely in screen pixels before serialization. */
+export function staticLabels(data, options, project) {
+    const width = options.labelLayout?.width ?? options.width ?? 800;
+    const unit = (options.width ?? 800) / width;
+    const height = (options.height ?? 800) / unit;
+    const point = (coordinates) => {
+        const [x, y] = project(coordinates);
+        return [x / unit, y / unit];
+    };
+    const markers = options.markers ?? [];
+    const marker = markers.find((item) => item.selected);
+    const neighborhoods = options.neighborhoodLabels
+        ? (data.neighborhoods ?? [])
+            .map((item) => {
+            const bounds = projectedBounds(item.geometry, point);
+            return {
+                ...item,
+                point: interiorAnchor(item.geometry, point),
+                area: (bounds[2] - bounds[0]) * (bounds[3] - bounds[1]),
+            };
+        })
+            .sort((a, b) => b.area - a.area || (a.id ?? a.name).localeCompare(b.id ?? b.name))
+        : [];
+    const districts = options.districtLabels !== false ? (data.districts?.[options.year ?? 2022] ?? []) : [];
+    for (const district of districts)
+        if (!Number.isFinite(district.id))
+            throw new TypeError('District IDs must be finite numbers.');
+    const candidates = styleLabels(labelCandidates({
+        selected: marker
+            ? [
+                {
+                    point: point([marker.lng, marker.lat]),
+                    name: marker.label ?? marker.id,
+                    kind: 'selected-marker',
+                },
+            ]
+            : [],
+        districts: options.districtLabels !== false
+            ? districts.flatMap((district) => (district.labelPoints.length ? district.labelPoints : [district.label]).map((label) => ({ point: point(label), name: String(district.id), kind: 'district' })))
+            : [],
+        stations: [], // Station names appear only after zooming; symbols remain at overview.
+        parks: options.landmarks
+            ? (data.landmarks ?? []).map((item) => ({
+                point: point(item.label),
+                name: item.name,
+                kind: 'park',
+            }))
+            : [],
+        roads: (options.roadLabels ?? options.keyRoads)
+            ? (data.keyRoads ?? []).map((item) => ({
+                point: point(item.label),
+                name: item.name,
+                level: item.level ?? 'primary',
+                kind: 'road',
+            }))
+            : [],
+        neighborhoods: neighborhoods.flatMap((item) => item.point ? [{ point: item.point, name: item.name, kind: 'neighborhood' }] : []),
+    }, width, 1), { colors: options.colors, markerRadius: marker?.radius ?? 6 });
+    const obstacles = [
+        ...(options.bartStations
+            ? (data.bartStations ?? []).map((item) => {
+                const [x, y] = point(item.coordinates);
+                return [x - 6, y - 6, x + 6, y + 6];
+            })
+            : []),
+        ...markers.map((item) => {
+            const [x, y] = point([item.lng, item.lat]);
+            // Also cover the legacy SVG marker when it is larger than its interactive counterpart.
+            const radius = Math.max(item.radius ?? 6, (item.radius ?? (item.selected ? 8 : 5)) / unit) + 3;
+            return [x - radius, y - radius, x + radius, y + radius];
+        }),
+    ];
+    const placed = layoutLabels(candidates.map((item) => ({
+        ...item,
+        x: item.point[0],
+        y: item.point[1],
+        textWidth: estimateLabelWidth(item.name, item.fontSize),
+        textHeight: item.fontSize * 1.25,
+    })), width, height, obstacles);
+    return `<g data-layer="overview-labels" font-family="system-ui,sans-serif">${placed.map((item) => `<text data-label-kind="${escapeXml(item.kind)}" text-anchor="middle" x="${number((item.left + item.textWidth / 2) * unit)}" y="${number((item.top + item.fontSize) * unit)}" font-size="${number(item.fontSize * unit)}" font-weight="${item.fontWeight}" fill="${escapeXml(item.fill)}" stroke="${escapeXml(item.halo)}" stroke-width="${number(3 * unit)}" stroke-linejoin="round" paint-order="stroke">${escapeXml(item.name)}</text>`).join('')}</g>`;
+}

package/dist/src/static.js

@@ -2,12 +2,13 @@ import { prepareAppearance } from './appearance.js';
 import { validateSwitchPatch } from './features.js';
 import { createSFMapWithData, getLayerPathsWithData } from './map-core.js';
 import { normalizeStaticAnimation } from './static-animation.js';
+import { staticLabels } from './static-labels.js';
 import { assertOptions, validateMarkers, validateOverlays } from './validation.js';
 /** Server-safe SVG rendering with explicit data; returns SVG plus projection helpers. */
 export function renderMap(data, options = {}) {
     const prepared = expandStaticOptions(options);
     const { map, source } = staticInput(data, prepared);
-    return createSFMapWithData({ ...prepared, source }, map);
+    return createSFMapWithData({ ...prepared, source }, map, prepared.labelLayout ? (project) => staticLabels(map, prepared, project) : undefined);
 }
 /** Project canonical layer geometry without constructing an SVG string. */
 export function getLayerPaths(data, options = {}) {
@@ -34,8 +35,9 @@ function staticInput(data, options) {
         source,
         map: {
             ...data.map,
-            neighborhoods: collection.features.map(({ geometry, properties }) => ({
-                name: properties.sourceName,
+            neighborhoods: collection.features.map(({ id, geometry, properties }) => ({
+                id,
+                name: options.labelLayout ? properties.canonicalName : properties.sourceName,
                 geometry,
             })),
         },
@@ -46,6 +48,7 @@ const staticLayerKeys = [
     'districtLines',
     'districtLabels',
     'neighborhoodLines',
+    'neighborhoodLabels',
     'landmarks',
     'bartStations',
     'highways',
@@ -67,6 +70,7 @@ function expandStaticOptions(options) {
         'year',
         'source',
         'labels',
+        'labelLayout',
         'markers',
         'overlays',
         'title',
@@ -79,6 +83,11 @@ function expandStaticOptions(options) {
     for (const key of ['title', 'idPrefix'])
         if (options[key] !== undefined && typeof options[key] !== 'string')
             throw new TypeError(`${key} must be a string.`);
+    if (options.labelLayout !== undefined) {
+        assertOptions(options.labelLayout, 'label layout', ['width']);
+        if (!Number.isFinite(options.labelLayout.width) || options.labelLayout.width <= 0)
+            throw new RangeError('Label layout width must be positive and finite.');
+    }
     if (options.markers !== undefined)
         validateMarkers(options.markers);
     if (options.overlays !== undefined)

package/dist/src/types.d.ts

@@ -45,12 +45,18 @@ export interface SFMapOptions {
     source?: NeighborhoodSource;
     districtLines?: boolean;
     neighborhoodLines?: boolean;
+    /** Neighborhood names in the opt-in collision layout. */
+    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;
     districtLabels?: boolean;
     /** Hide all visible text labels while retaining geographic symbols and accessible titles. */
     labels?: boolean;
+    /** Opt into interactive overview label priorities/collisions at this CSS display width. Uses estimated system-font metrics without a DOM. */
+    labelLayout?: {
+        width: number;
+    };
     highways?: boolean;
     keyRoads?: boolean;
     roadLabels?: boolean;
@@ -73,7 +79,7 @@ export interface SFMapOptions {
     colors?: Partial<Record<'water' | 'land' | 'district' | 'neighborhood' | 'highway' | 'road' | 'park' | 'landmark' | 'bart' | 'label' | 'marker' | 'selected', string>>;
 }
 /** Presentation supported by both the static and interactive renderers. */
-export type StaticMapLayers = Omit<InteractiveLayers, 'neighborhoodLabels'>;
+export type StaticMapLayers = InteractiveLayers;
 export type StaticMapAppearance = Pick<SFMapOptions, 'theme' | 'colors' | 'districtStyle'>;
 /** Serializable viewport in the interactive map's fixed 800 × 800 projected space. */
 export type MapViewport = readonly [x: number, y: number, size: number];
@@ -240,7 +246,7 @@ export interface NeighborhoodExplorerElement extends HTMLElement {
     fitGeometry(geometry: Geometry, padding?: number | MapPadding, options?: CameraOptions): void;
     /** Explicitly engage map touch gestures; false restores page gestures. */
     setTouchNavigation(enabled: boolean): void;
-    /** Reconcile stable IDs; retained markers preserve nodes, focus, and entrance animations. */
+    /** Reconcile stable IDs; preserve existing nodes and focus. Pin visuals allocate on first visibility/selection. */
     setMarkers(markers: readonly MapMarker[]): void;
     setOverlays(overlays: readonly MapOverlay[]): void;
     selectMarker(id: string | null, options?: {

package/docs/API.md

@@ -19,9 +19,9 @@ const { svg } = renderMap(staticMapData, presentation);
 const map = createMap(fullMapData, presentation);
 ```
 
-Static `layers` supports every interactive layer switch except `neighborhoodLabels`. Static `appearance` supports `theme`, `colors`, and `districtStyle`; browser typography, area interaction styles, and screen-space marker sizing remain interactive settings. Unknown keys and invalid values are rejected for both flat and grouped options. Supplied grouped keys override flat compatibility keys; omitted or `undefined` grouped keys preserve the flat value or renderer default. Undefined color tokens use the theme default instead of entering SVG attributes. The two renderers retain their existing defaults. Marker arrays accept readonly inputs.
+Static `layers` supports every interactive layer switch. `neighborhoodLabels` applies to the opt-in `labelLayout` described below. Static `appearance` supports `theme`, `colors`, and `districtStyle`; browser typography, area interaction styles, and screen-space marker sizing remain interactive settings. Unknown keys and invalid values are rejected for both flat and grouped options. Supplied grouped keys override flat compatibility keys; omitted or `undefined` grouped keys preserve the flat value or renderer default. Undefined color tokens use the theme default instead of entering SVG attributes. The two renderers retain their existing defaults. Marker arrays accept readonly inputs.
 
-Flat compatibility options include `theme`, `width`, `height`, `padding`, `year` (2002, 2012, 2022), `districtLines`, `districtFills`, `districtStyle`, `districtLabels`, `neighborhoodLines`, `labels`, `highways`, `keyRoads`, `roadLabels`, `landmarks`, `bartStations`, `markers`, `overlays`, `title`, `idPrefix`, `colors`, and `animation`. Each optional layer is independent. User-supplied text and attributes are escaped in SVG output.
+Flat compatibility options include `theme`, `width`, `height`, `padding`, `year` (2002, 2012, 2022), `districtLines`, `districtFills`, `districtStyle`, `districtLabels`, `neighborhoodLines`, `neighborhoodLabels`, `labels`, `labelLayout`, `highways`, `keyRoads`, `roadLabels`, `landmarks`, `bartStations`, `markers`, `overlays`, `title`, `idPrefix`, `colors`, and `animation`. Each optional layer is independent. User-supplied text and attributes are escaped in SVG output.
 
 Custom district IDs must be finite numbers. An empty `labelPoints` array uses the district's primary `label` position.
 
@@ -29,6 +29,10 @@ The SVG description names the selected neighborhood source for source-aware data
 
 `animation: true` (or `{ duration, delay }`) makes a static map draw itself with self-contained, scoped CSS: land fades in, the coast and lines draw, districts grow, then labels and points appear. It plays when the SVG is inserted into a page or loaded as an image, needs no JavaScript, and stays still under `prefers-reduced-motion`. Re-insert the markup to replay it. Default output is unchanged.
 
+Static `labelLayout: { width: 390 }` opts into shared interactive **overview** label priorities, sizes, anchors and collision rules. `width` must be a positive finite CSS canvas width; it does not alter the SVG viewBox. Set `neighborhoodLabels: true` (flat or under `layers`) to add area names in this layout. Guide SVGs and shells enable neighborhood names by default only when opting into `labelLayout`. `labels: false` remains the master switch. Default static output is unchanged.
+
+Static placement uses estimated system-font metrics without browser globals. Interactive placement measures actual fonts and includes live selection and HTML furniture, so exact glyph positions and the visible label set can differ. See the [integration recipe](consumer-integration.md#keep-overview-labels-consistent) for width and progressive-enhancement guidance.
+
 ## Interactive maps
 
 `createMap` defaults to `mode: 'basemap'` and `appearance.theme: 'transit'`. Set the mode explicitly for neighborhood or district exploration. District and neighborhood layer defaults follow the mode; other supplied layers default on. The [developer guide](developer-guide.md) compares static and interactive defaults and explains configuration resets, coordinates, and cleanup.
@@ -39,7 +43,13 @@ The controller also supports marker, neighborhood, and district selection; distr
 
 If a district callback destroys the map or selects a newer district, the interrupted activation stops without moving keyboard focus or sending a stale event.
 
-`setMarkers()` reconciles by stable marker `id`: retained markers keep their DOM nodes, focus, and in-progress entrance animations; only new IDs animate in. Identical ordered marker updates are a visual no-op. Camera state and `viewportchange` events remain synchronous, while animated camera steps and their dependent label/marker layout commit in the same browser frame.
+`setMarkers()` reconciles by stable marker `id`: retained markers keep any previously created nodes, focus, and in-progress entrance animations. New pin entrances start when the pin first becomes visible; a cached pin does not animate again merely because it returns to the viewport. Disabling entrances, reduced-motion changes, and destruction cancel pending and active entrances. Identical ordered marker updates are a visual no-op. Camera state and `viewportchange` events remain synchronous, while animated camera steps and their dependent label/marker layout commit in the same browser frame.
+
+Interactive maps create individual pin nodes only on first visibility or selection, then cache them for reuse. Record and style updates before first visibility apply to the eventual node. They mount only pins and cluster symbols intersecting a padded viewport; clustered member pins detach. All records remain in the native picker and selectable through the API. Selected and keyboard-focused pins stay mounted, even outside the viewport, and retained nodes return when panning back. Cluster membership uses the complete catalog and stays stable during pan at the same zoom. Static SVG exports are unaffected.
+
+Visible markers and clusters share one tab stop. Use `[` and `]` to move focus, Enter or Space to activate, and Tab to leave the group. Arrow keys retain map panning. Marker replacement preserves the focused ID when available and moves focus to a surviving marker when it is removed.
+
+Activating coincident pins opens a place chooser, including when compact embeds hide the native marker picker. Clusters zoom when their members can separate at maximum zoom; otherwise they open the chooser. Escape or Close returns focus to the originating pin or cluster when it remains visible. Choosing a place selects its marker; replacing markers or destroying the map closes the chooser. `clusteractivate` still reports the activated cluster's markers.
 
 For a small guide, import `guideMapData` from `/guide/data` and pass it to `createMap`. The optional `/guide` entry also provides `createGuideMap`, `mountGuideMap`, and detailed-data loading for existing guide layouts. `/transit` provides the standalone schematic transit animation. See [examples](EXAMPLES.md) and [consumer integration](consumer-integration.md).
 
@@ -96,6 +106,6 @@ Neighborhood IDs are exact source-scoped feature IDs, rather than display names
 
 ## Coordinates and units
 
-GeoJSON and static projection inputs use `[longitude, latitude]` in WGS84; markers use `{ lng, lat }`. Static `project` returns SVG units. `projectToScreen(lng, lat)` returns pixels relative to the mounted canvas. Camera viewports and pan deltas use the fixed 800 × 800 projected map space, independent of canvas size. Marker radius uses screen pixels in browser maps and SVG units in static output.
+GeoJSON and static projection inputs use `[longitude, latitude]` in WGS84; markers use `{ lng, lat }`. Static `project` returns SVG units. `projectToScreen(lng, lat)` returns pixels relative to the mounted canvas. Camera viewports use the fixed 800 × 800 projected map space, independent of canvas size. Pan deltas use screen pixels, converted using the mounted canvas width. Marker radius uses screen pixels in browser maps and SVG units in static output.
 
 Explore presentation options in the [live map design playground](https://kahwee.github.io/sf-map-svg/playground.html). The page identifies its package version; released builds use compatible options for that installed version.

package/docs/EXAMPLES.md

@@ -7,6 +7,7 @@ Choose by task. All snippets use the public package API; browser examples need a
 | I want to… | Start here |
 | --- | --- |
 | Render an SVG on a server | [Static map](#static-svg) |
+| Show labels before JavaScript loads | [Static-to-interactive guide](consumer-integration.md#keep-overview-labels-consistent) |
 | Add a small map to a browser | [Lightweight guide](#lightweight-interactive-guide) |
 | Bundle only selected geography | [Selected data](#selected-geography) |
 | Draw a route over the city | [Route overlay](#route-overlay) |

package/docs/api-audit.md

@@ -16,8 +16,9 @@ unbounded geographic data can never fail.
 | A new camera request during animation | The new request cancels the prior generation. A callback cannot revive it after cancellation/disposal. |
 | Selection callback selecting another item | Newer selection wins. The old selection cannot subsequently move the camera or send a stale activation callback. |
 | `selectNeighborhood(..., {fit:false})` in basemap mode | Selection can change presentation, but preserves the camera. Explicit layer overrides remain authoritative. |
-| Clustering and selected/focused markers | Selected/focused pins remain individually reachable. Coincident alternatives remain available through the chooser. |
-| Marker entrance and reduced motion | Entrances are optional, independent of camera motion, and cancel on preference changes or disposal. Stable IDs avoid repeated entrances on filtering. |
+| Clustering and selected/focused markers | Selected/focused pins remain individually reachable. Coincident pins and clusters that cannot separate at maximum zoom open a place chooser, including compact shells with hidden native pickers. Visible pins and clusters share one tab stop with bracket-key navigation. |
+| Viewport marker rendering | Individual pin visuals allocate on first visibility or selection; offscreen pins and cluster symbols detach with screen-space overscan. Uncreated records receive current labels/styles on first materialization. Full catalog/picker and cached node identities remain available; selected/focused pins stay mounted. Pan reuses global cluster membership and nodes until zoom, data, selection, focus, or clustering changes. |
+| Marker entrance and reduced motion | Entrances begin on first visibility, are independent of camera motion, and cancel on preference changes or disposal, including pending entrances. Cached pins do not restart entrances on reentry. Stable IDs avoid repeated entrances on filtering. |
 | Hiding touch control while gestures are enabled | Returns touch scrolling to the page. Other toolbar controls remain independent. |
 | Convenience mode/source setters | Share the atomic configuration path. `{ resetView: false }` preserves the camera; omitted options retain the historic reset. Invalid options and unavailable geography leave state unchanged. |
 | Runtime patch omitted/false/undefined | Omitted retains; false disables boolean switches; undefined removes group/key overrides. Top-level mode/source/year/labels set to undefined retain their current values. Nested feature objects replace, rather than deep-merge. |
@@ -45,7 +46,7 @@ Live appearance patches prepare values, district styles and source replacement b
 | Accessibility | Feature round trips, keyboard activation, focus recovery after removal/clustering, independent controls, touch names, and reduced motion have browser regressions. Hiding every alternative chooser is a consumer accessibility decision. |
 | Output safety | SVG text and attributes are escaped. This is not a security sandbox for CSS tokens or caller-provided DOM. Keep untrusted callout content in `textContent`; the consumer controls CSS/resource policy. |
 | Packaging | Clean tarball install exercises entrypoints and emitted declarations, including `LineString` overlays. No runtime dependencies or embedded geographic coordinate blobs were added. |
-| Performance | Production bundle checks enforce the guide and renderer ceilings and inspect dataset inclusion. Grouping has a 2,000-marker regression; millions of markers are outside this guide-oriented design. |
+| Performance | Production bundle checks enforce the guide and renderer ceilings and inspect dataset inclusion. Viewport culling, focus, reattachment, and cluster reuse have 2,000-marker regressions across three engines and two widths; millions of markers are outside this guide-oriented design. |
 
 Regression sources: `test/api-contract.test.js`, `test/camera.test.js`,
 `test/viewport.test.js`, `stories/Robustness.stories.ts`,
@@ -61,7 +62,7 @@ Static grouped layers and appearance reject unknown keys, while flat compatibili
 interactive option-key validation is not a claim that all static options share the
 same schema. Host layout, delayed images, fonts, and application cards need their
 own CLS tests. The scale bar is an approximate local Mercator scale, not survey
-instrumentation. Clustering does not spiderfy coincident locations. Geographic
+instrumentation. Coincident locations use a place chooser rather than spiderfying. Geographic
 source correctness remains governed by SOURCES.md and existing topology tests.
 
 ## Extending the contract

package/docs/consumer-integration.md

@@ -15,6 +15,46 @@ const markup = createGuideShell({ title: 'Explore San Francisco' });
 
 The shell uses an 800 × 800 projection with 28 units of padding, matching the interactive map. Use `createGuideSVG()` for custom dimensions. Rendering is offline, with zero runtime dependencies.
 
+## Keep overview labels consistent
+
+Opt into the browser's overview label priorities and collision rules with a target **canvas width in CSS pixels**:
+
+```ts
+const labeledMarkup = createGuideShell({
+  title: 'Explore San Francisco',
+  labelLayout: { width: 390 },
+});
+```
+
+This keeps the 800 × 800 projection. It sizes and places text for a 390 px canvas, prioritizes major parks and primary roads, includes neighborhood names, and avoids label, marker, and BART-symbol collisions. BART names and smaller parks remain deferred until interactive zoom. Use the same geography, colors, markers and layer switches when mounting. Set `layers.neighborhoodLabels: false` on both renderers to omit neighborhood names.
+
+The width is a rendering hint, not a responsive script. Generate an appropriate variant for your known embed width; an SVG displayed at another width scales its labels with the artwork. Static layout uses conservative estimated system-font widths, while the browser measures actual fonts and recalculates on resize. Font metrics, custom browser label styles, selection, clustering and HTML overlays can therefore change the final label set or position. This reduces the transition without promising pixel-identical hydration. Existing calls without `labelLayout` keep their original fixed labels.
+
+For a fixed-width embed, use shared inputs on the server and in the browser:
+
+```ts
+// Shared inputs: coordinates, IDs, radii, colors and layer choices must match.
+const guideMarkers = [
+  { id: 'ferry', label: 'Ferry Building', lng: -122.3937, lat: 37.7955, radius: 7 },
+];
+const guideLayers = { neighborhoodLabels: true, roadLabels: true };
+const guideColors = { label: '#183e58', landmark: '#426641' };
+
+// Server: place this HTML in a canvas that is 390 CSS pixels wide.
+const labeledPlacesMarkup = createGuideShell({
+  labelLayout: { width: 390 },
+  markers: guideMarkers,
+  layers: guideLayers,
+  appearance: { colors: guideColors },
+});
+```
+
+After inserting that markup, pass `markers: guideMarkers`, `layers: guideLayers`, and `appearance: { colors: guideColors }` to `mountGuideController()` as shown below. The static-only `labelLayout` option is not a browser option: the controller measures the actual canvas and font. The shell border is outside the canvas, so a default shell with a 390 px outer width has a 388 px canvas.
+
+For responsive layouts whose canvas width is unknown at build time, choose a representative width and accept text scaling until enhancement, or serve independently rendered SVG variants through your application's responsive markup. The package does not detect a device on the server. Keep `labels: false` if your design requires no visible text change at enhancement.
+
+For `renderMap()`, also enable `neighborhoodLabels` explicitly; it defaults off outside the guide preset. `labels: false` hides all text in either layout while preserving symbols and accessible titles.
+
 ## Enhance the existing frame
 
 In your browser entry, mount the controller into that shell:
@@ -27,7 +67,9 @@ if (!shell) throw new Error('Missing guide shell');
 const guide = mountGuideController(shell, {
   attribution: 'compact',
   features: { motion: { duration: 400 }, markerEntrance: true },
-  appearance: { theme: 'transit' },
+  markers: guideMarkers,
+  layers: guideLayers,
+  appearance: { theme: 'transit', colors: guideColors },
 });
 
 // Call before your application removes the containing view.

package/docs/guide-bundle-report.md

@@ -1,12 +1,12 @@
 # Guide bundle size report
 
-Generated 2026-10-01 by `pnpm report:guide` with Vite production minification and gzip compression. Each emitted JS chunk is compressed independently. The report measures the explicit-data root and the optional `@kahwee/sf-map-svg/guide` preset.
+Generated 2026-10-13 by `pnpm report:guide` with Vite production minification and gzip compression. Each emitted JS chunk is compressed independently. The report measures the explicit-data root and the optional `@kahwee/sf-map-svg/guide` preset.
 
 | Entry | Initial JS, raw | Initial JS, gzip | Explicit detail JS, gzip |
 | --- | ---: | ---: | ---: |
-| Renderer root (explicit data) | 99.3 KB | 29.1 KB | — |
-| Static renderer | 18.2 KB | 5.8 KB | — |
-| Guide preset | 489.1 KB | 116.8 KB | 467.0 KB |
+| Renderer root (explicit data) | 122.2 KB | 35.7 KB | — |
+| Static renderer | 31.4 KB | 9.7 KB | — |
+| Guide preset | 508.3 KB | 122.1 KB | 467.0 KB |
 
 **500 KB target:** met.