@mailwoman/react 9.3.0 → 9.4.0

package/out/map/{GeocoderDemo.d.ts → Geocoder.d.ts}

@@ -3,33 +3,33 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `<GeocoderDemo>` — the WHOLE geocoder demo, composed. It is the map analogue of `PipelineExplorer`
- *   and takes the SAME DI shape: an injected {@link DemoRuntime} (the host owns ONNX / httpvfs / R2 /
- *   the composed map style) plus a {@link DemoPanels} bag (the host's ModelVisualizer / VersionCompare /
+ *   `<Geocoder>` — the WHOLE geocoder, composed. It is the map analogue of `PipelineExplorer`
+ *   and takes the SAME DI shape: an injected {@link GeocoderRuntime} (the host owns ONNX / httpvfs / R2 /
+ *   the composed map style) plus a {@link GeocoderPanels} bag (the host's ModelVisualizer / VersionCompare /
  *   About / Permalink). Everything here is composition + a `ClientOnly` boundary:
  *
- *     - the floating {@link DemoControls} panel (version / compare / backend / query+autocomplete / result),
- *     - the declarative {@link DemoMap} with the phase-2 overlays ({@link OverlayLayers}) and the
+ *     - the floating {@link GeocoderControls} panel (version / compare / backend / query+autocomplete / result),
+ *     - the declarative {@link MapCanvas} with the phase-2 overlays ({@link OverlayLayers}) and the
  *       resolved-place marker/outline/camera ({@link ResolvedPlaceLayers}) driven by the parse state,
- *     - the hooks that wire them: {@link useDemoGeocode} (parse + viewport bias + map place),
+ *     - the hooks that wire them: {@link useGeocode} (parse + viewport bias + map place),
  *       {@link usePlaceAutocomplete}, {@link useCompareState}.
  *
- *   Because it pulls {@link DemoMap} (→ `react-map-gl` → `maplibre-gl`, WebGL + DOM at import), it lives on
+ *   Because it pulls {@link MapCanvas} (→ `react-map-gl` → `maplibre-gl`, WebGL + DOM at import), it lives on
  *   the `@mailwoman/react/map` subpath ONLY — never the package root. The whole thing renders in Storybook
  *   over a fake runtime (offline stub style + canned geocode) with no network, no ONNX, no gazetteer.
  */
 import { type ReactNode } from "react";
-import type { DemoPanels, DemoRuntime } from "#map/types";
+import type { GeocoderPanels, GeocoderRuntime } from "#map/types";
 import type { Preset } from "../common/PresetChips.tsx";
-export interface GeocoderDemoProps {
+export interface GeocoderProps {
     /**
-     * The injected demo runtime (map style + overlays + parse + version/backend).
+     * The injected geocoder runtime (map style + overlays + parse + version/backend).
      */
-    runtime: DemoRuntime;
+    runtime: GeocoderRuntime;
     /**
      * Host-injected panels (about, release blurb, compare, permalink, debug drawer, map controls, …).
      */
-    panels?: DemoPanels;
+    panels?: GeocoderPanels;
     /**
      * Address to pre-fill.
      */
@@ -40,18 +40,18 @@ export interface GeocoderDemoProps {
     presets?: ReadonlyArray<Preset>;
     /**
      * Only hint the viewport bias once the visitor has zoomed past the global view — a whole-globe center is noise.
-     * Matches the demo's `map.getZoom() >= 4` threshold. @default 4
+     * Matches the `map.getZoom() >= 4` threshold. @default 4
      */
     minBiasZoom?: number;
     /**
      * Fly/fit the map to the resolved place on each result (via {@link ResolvedPlaceLayers}). @default true. Set false
-     * for a host that drives the camera itself (a controlled `<DemoMap viewState>`), or to keep a headless test
+     * for a host that drives the camera itself (a controlled `<MapCanvas viewState>`), or to keep a headless test
      * deterministic — the marker + outline still render, only the animated camera move is skipped.
      */
     applyResultCamera?: boolean;
 }
 /**
- * The composed geocoder demo, behind a `ClientOnly` SSR boundary (the map is intrinsically a client component).
+ * The composed geocoder, behind a `ClientOnly` SSR boundary (the map is intrinsically a client component).
  */
-export declare function GeocoderDemo({ runtime, panels, defaultAddress, presets, minBiasZoom, applyResultCamera, }: GeocoderDemoProps): ReactNode;
-//# sourceMappingURL=GeocoderDemo.d.ts.map
+export declare function Geocoder({ runtime, panels, defaultAddress, presets, minBiasZoom, applyResultCamera, }: GeocoderProps): ReactNode;
+//# sourceMappingURL=Geocoder.d.ts.map

package/out/map/Geocoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Geocoder.d.ts","sourceRoot":"","sources":["../../lib/map/Geocoder.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAkC,MAAM,OAAO,CAAA;AAGtE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAW,MAAM,YAAY,CAAA;AAO1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAMvD,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,OAAO,EAAE,eAAe,CAAA;IACxB;;OAEG;IACH,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC/B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC3B;AA0HD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EACxB,OAAO,EACP,MAAkB,EAClB,cAAmB,EACnB,OAAoB,EACpB,WAAe,EACf,iBAAwB,GACxB,EAAE,aAAa,GAAG,SAAS,CAqB3B"}

package/out/map/{GeocoderDemo.js → Geocoder.js}

@@ -4,50 +4,50 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `<GeocoderDemo>` — the WHOLE geocoder demo, composed. It is the map analogue of `PipelineExplorer`
- *   and takes the SAME DI shape: an injected {@link DemoRuntime} (the host owns ONNX / httpvfs / R2 /
- *   the composed map style) plus a {@link DemoPanels} bag (the host's ModelVisualizer / VersionCompare /
+ *   `<Geocoder>` — the WHOLE geocoder, composed. It is the map analogue of `PipelineExplorer`
+ *   and takes the SAME DI shape: an injected {@link GeocoderRuntime} (the host owns ONNX / httpvfs / R2 /
+ *   the composed map style) plus a {@link GeocoderPanels} bag (the host's ModelVisualizer / VersionCompare /
  *   About / Permalink). Everything here is composition + a `ClientOnly` boundary:
  *
- *     - the floating {@link DemoControls} panel (version / compare / backend / query+autocomplete / result),
- *     - the declarative {@link DemoMap} with the phase-2 overlays ({@link OverlayLayers}) and the
+ *     - the floating {@link GeocoderControls} panel (version / compare / backend / query+autocomplete / result),
+ *     - the declarative {@link MapCanvas} with the phase-2 overlays ({@link OverlayLayers}) and the
  *       resolved-place marker/outline/camera ({@link ResolvedPlaceLayers}) driven by the parse state,
- *     - the hooks that wire them: {@link useDemoGeocode} (parse + viewport bias + map place),
+ *     - the hooks that wire them: {@link useGeocode} (parse + viewport bias + map place),
  *       {@link usePlaceAutocomplete}, {@link useCompareState}.
  *
- *   Because it pulls {@link DemoMap} (→ `react-map-gl` → `maplibre-gl`, WebGL + DOM at import), it lives on
+ *   Because it pulls {@link MapCanvas} (→ `react-map-gl` → `maplibre-gl`, WebGL + DOM at import), it lives on
  *   the `@mailwoman/react/map` subpath ONLY — never the package root. The whole thing renders in Storybook
  *   over a fake runtime (offline stub style + canned geocode) with no network, no ONNX, no gazetteer.
  */
 import { useCallback, useEffect, useRef } from "react";
 import { useCompareState } from "#map/useCompareState";
-import { useDemoGeocode } from "#map/useDemoGeocode";
+import { useGeocode } from "#map/useGeocode";
 import { useMapPlaceRender } from "#map/useMapPlaceRender";
 import { usePlaceAutocomplete } from "#map/usePlaceAutocomplete";
 import { ClientOnly } from "../common/ClientOnly.js";
-import { DemoControls } from "./DemoControls.js";
-import { DemoMap } from "./DemoMap.js";
+import { GeocoderControls } from "./GeocoderControls.js";
+import { MapCanvas } from "./MapCanvas.js";
 import { OverlayLayers } from "./OverlayLayers.js";
 import { ResolvedPlaceLayers } from "./ResolvedPlaceLayers.js";
-function GeocoderDemoInner({ runtime, panels, defaultAddress, presets, minBiasZoom, applyResultCamera, }) {
+function GeocoderInner({ runtime, panels, defaultAddress, presets, minBiasZoom, applyResultCamera, }) {
     const mapRef = useRef(null);
     // TEST INJECTION POINT: the e2e viewport-bias suite drives the REAL map (pan + zoom past the bias threshold)
     // before submitting, and a browser test cannot reach a React ref — so the live map handle is
-    // republished on `globalThis.__mailwomanDemoMap`, the same global the pre-port demo carried. The
-    // ref fills only after react-map-gl instantiates the map, hence the short poll; cleared on
-    // unmount so a torn-down demo never leaves a stale handle behind.
+    // republished on `globalThis.__mailwomanMapCanvas`. The ref fills only after react-map-gl instantiates
+    // the map, hence the short poll; cleared on unmount so a torn-down geocoder never leaves a stale
+    // handle behind.
     useEffect(() => {
         const host = globalThis;
         const timer = setInterval(() => {
             const map = mapRef.current?.getMap();
             if (map) {
-                host.__mailwomanDemoMap = map;
+                host.__mailwomanMapCanvas = map;
                 clearInterval(timer);
             }
         }, 250);
         return () => {
             clearInterval(timer);
-            delete host.__mailwomanDemoMap;
+            delete host.__mailwomanMapCanvas;
         };
     }, []);
     // Read the viewport bias at submit time — through the map handle, never a threaded state value, so granting/zooming
@@ -62,7 +62,7 @@ function GeocoderDemoInner({ runtime, panels, defaultAddress, presets, minBiasZo
         const center = map.getCenter();
         return { center: [center.lng, center.lat], zoom };
     }, [minBiasZoom]);
-    const geocode = useDemoGeocode({ runtime, defaultText: defaultAddress, getBias });
+    const geocode = useGeocode({ runtime, defaultText: defaultAddress, getBias });
     const compare = useCompareState();
     const autocomplete = usePlaceAutocomplete({
         text: geocode.text,
@@ -75,14 +75,14 @@ function GeocoderDemoInner({ runtime, panels, defaultAddress, presets, minBiasZo
         compare.clearIfPrimary(version);
     }, [runtime, compare]);
     const onForceWASMChange = useCallback((forceWASM) => runtime.setForceWASM?.(forceWASM), [runtime]);
-    return (_jsxs("div", { className: "mw-geocoder-demo", children: [_jsx("div", { className: "mw-geocoder-demo__map", children: _jsxs(DemoMap, { mapStyle: runtime.mapStyle, mapRef: mapRef, initialViewState: {
+    return (_jsxs("div", { className: "mw-geocoder-demo", children: [_jsx("div", { className: "mw-geocoder-demo__map", children: _jsxs(MapCanvas, { mapStyle: runtime.mapStyle, mapRef: mapRef, initialViewState: {
                         longitude: runtime.initialCenter[0],
                         latitude: runtime.initialCenter[1],
                         zoom: runtime.initialZoom ?? 3,
                     }, style: { width: "100%", height: "100%" }, 
-                    // Match the live demo's chrome: one compact attribution pill (the map's own default is a wide, always-open
-                    // "MapLibre | © …" bar), no maplibre wordmark logo.
-                    mapProps: { attributionControl: { compact: true }, maplibreLogo: false }, children: [_jsx(OverlayLayers, { overlays: runtime.overlays }), _jsx(ResolvedPlaceLayers, { spec: spec, applyCamera: applyResultCamera }), panels.mapControls] }) }), _jsx(DemoControls, { runtime: runtime, geocode: geocode, autocomplete: autocomplete, compare: compare, panels: panels, presets: presets, placeholder: defaultAddress, onSelectVersion: onSelectVersion, onForceWASMChange: onForceWASMChange }), panels.debugDrawer ? panels.debugDrawer({ result: geocode.result }) : null] }));
+                    // One compact attribution pill (the map's own default is a wide, always-open "MapLibre | © …" bar), no
+                    // maplibre wordmark logo.
+                    mapProps: { attributionControl: { compact: true }, maplibreLogo: false }, children: [_jsx(OverlayLayers, { overlays: runtime.overlays }), _jsx(ResolvedPlaceLayers, { spec: spec, applyCamera: applyResultCamera }), panels.mapControls] }) }), _jsx(GeocoderControls, { runtime: runtime, geocode: geocode, autocomplete: autocomplete, compare: compare, panels: panels, presets: presets, placeholder: defaultAddress, onSelectVersion: onSelectVersion, onForceWASMChange: onForceWASMChange }), panels.debugDrawer ? panels.debugDrawer({ result: geocode.result }) : null] }));
 }
 /**
  * Stable empty defaults — a fresh `{}`/`[]` per render would churn every downstream memo dep.
@@ -90,9 +90,9 @@ function GeocoderDemoInner({ runtime, panels, defaultAddress, presets, minBiasZo
 const NO_PANELS = {};
 const NO_PRESETS = [];
 /**
- * The composed geocoder demo, behind a `ClientOnly` SSR boundary (the map is intrinsically a client component).
+ * The composed geocoder, behind a `ClientOnly` SSR boundary (the map is intrinsically a client component).
  */
-export function GeocoderDemo({ runtime, panels = NO_PANELS, defaultAddress = "", presets = NO_PRESETS, minBiasZoom = 4, applyResultCamera = true, }) {
-    return (_jsx(ClientOnly, { fallback: _jsx("div", { className: "mw-geocoder-demo", children: _jsx("p", { children: "Loading demo\u2026" }) }), children: () => (_jsx(GeocoderDemoInner, { runtime: runtime, panels: panels, defaultAddress: defaultAddress, presets: presets, minBiasZoom: minBiasZoom, applyResultCamera: applyResultCamera })) }));
+export function Geocoder({ runtime, panels = NO_PANELS, defaultAddress = "", presets = NO_PRESETS, minBiasZoom = 4, applyResultCamera = true, }) {
+    return (_jsx(ClientOnly, { fallback: _jsx("div", { className: "mw-geocoder-demo", children: _jsx("p", { children: "Loading the geocoder\u2026" }) }), children: () => (_jsx(GeocoderInner, { runtime: runtime, panels: panels, defaultAddress: defaultAddress, presets: presets, minBiasZoom: minBiasZoom, applyResultCamera: applyResultCamera })) }));
 }
-//# sourceMappingURL=GeocoderDemo.js.map
+//# sourceMappingURL=Geocoder.js.map

package/out/map/Geocoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Geocoder.js","sourceRoot":"","sources":["../../lib/map/Geocoder.tsx"],"names":[],"mappings":"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"}

package/out/map/{DemoControls.d.ts → GeocoderControls.d.ts}

@@ -3,31 +3,30 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `<DemoControls>` — the geocoder demo's floating control panel, assembled from the demo-specific units
+ *   `<GeocoderControls>` — the geocoder's floating control panel, assembled from the geocoder-specific units
  *   (VersionPicker / CompareToggle / BackendControl / PlaceAutocomplete / ResultPanel) and the REUSED
- *   pipeline units (QueryForm / PresetChips / LoadingIndicator). It is the presentational composition the
- *   `_app.tsx` control `<section>` (`:1222-1514`) becomes — it reads the injected {@link DemoRuntime} for
- *   ready/version/backend/loading state and threads the {@link useDemoGeocode} + {@link usePlaceAutocomplete}
- *   + {@link useCompareState} hooks into the controls. Host-specific visualizers arrive via {@link DemoPanels}.
+ *   pipeline units (QueryForm / PresetChips / LoadingIndicator). It reads the injected {@link GeocoderRuntime}
+ *   for ready/version/backend/loading state and threads the {@link useGeocode} + {@link usePlaceAutocomplete}
+ *   + {@link useCompareState} hooks into the controls. Host-specific visualizers arrive via {@link GeocoderPanels}.
  *
- *   NODE-SAFE: pure React + the shared/demo units, no maplibre. It rides `@mailwoman/react/map` as a
- *   demo-specific control, not for WebGL.
+ *   NODE-SAFE: pure React + the shared/geocoder units, no maplibre. It rides `@mailwoman/react/map` as a
+ *   geocoder-specific control, not for WebGL.
  */
 import type { ReactNode } from "react";
-import type { DemoPanels, DemoRuntime } from "#map/types";
+import type { GeocoderPanels, GeocoderRuntime } from "#map/types";
 import type { UseCompareState } from "#map/useCompareState";
-import type { UseDemoGeocode } from "#map/useDemoGeocode";
+import type { UseGeocode } from "#map/useGeocode";
 import type { UsePlaceAutocomplete } from "#map/usePlaceAutocomplete";
 import { type Preset } from "../common/PresetChips.tsx";
-export interface DemoControlsProps {
+export interface GeocoderControlsProps {
     /**
-     * The injected demo runtime.
+     * The injected geocoder runtime.
      */
-    runtime: DemoRuntime;
+    runtime: GeocoderRuntime;
     /**
      * The parse+resolve state machine.
      */
-    geocode: UseDemoGeocode;
+    geocode: UseGeocode;
     /**
      * The place-autocomplete combobox state.
      */
@@ -39,7 +38,7 @@ export interface DemoControlsProps {
     /**
      * Host-injected panels (about, release blurb, compare, permalink, extras, failure).
      */
-    panels: DemoPanels;
+    panels: GeocoderPanels;
     /**
      * Example chips.
      */
@@ -49,7 +48,7 @@ export interface DemoControlsProps {
      */
     placeholder: string;
     /**
-     * Select a model version (the composed demo also clears a now-colliding compare selection).
+     * Select a model version (the composed geocoder also clears a now-colliding compare selection).
      */
     onSelectVersion: (version: string) => void;
     /**
@@ -60,5 +59,5 @@ export interface DemoControlsProps {
 /**
  * The floating control panel.
  */
-export declare function DemoControls({ runtime, geocode, autocomplete, compare, panels, presets, placeholder, onSelectVersion, onForceWASMChange, }: DemoControlsProps): ReactNode;
-//# sourceMappingURL=DemoControls.d.ts.map
+export declare function GeocoderControls({ runtime, geocode, autocomplete, compare, panels, presets, placeholder, onSelectVersion, onForceWASMChange, }: GeocoderControlsProps): ReactNode;
+//# sourceMappingURL=GeocoderControls.d.ts.map

package/out/map/GeocoderControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeocoderControls.d.ts","sourceRoot":"","sources":["../../lib/map/GeocoderControls.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAGrE,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAQpE,MAAM,WAAW,qBAAqB;IACrC;;OAEG;IACH,OAAO,EAAE,eAAe,CAAA;IACxB;;OAEG;IACH,OAAO,EAAE,UAAU,CAAA;IACnB;;OAEG;IACH,YAAY,EAAE,oBAAoB,CAAA;IAClC;;OAEG;IACH,OAAO,EAAE,eAAe,CAAA;IACxB;;OAEG;IACH,MAAM,EAAE,cAAc,CAAA;IACtB;;OAEG;IACH,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC9B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C;;OAEG;IACH,iBAAiB,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAA;CAC/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAChC,OAAO,EACP,OAAO,EACP,YAAY,EACZ,OAAO,EACP,MAAM,EACN,OAAO,EACP,WAAW,EACX,eAAe,EACf,iBAAiB,GACjB,EAAE,qBAAqB,GAAG,SAAS,CA6GnC"}

package/out/map/{DemoControls.js → GeocoderControls.js}

@@ -10,7 +10,7 @@ import { VersionPicker } from "./VersionPicker.js";
 /**
  * The floating control panel.
  */
-export function DemoControls({ runtime, geocode, autocomplete, compare, panels, presets, placeholder, onSelectVersion, onForceWASMChange, }) {
+export function GeocoderControls({ runtime, geocode, autocomplete, compare, panels, presets, placeholder, onSelectVersion, onForceWASMChange, }) {
     const versions = runtime.availableVersions ?? [];
     const { busy, result, selectedCandidate } = geocode;
     const loading = runtime.loading;
@@ -27,4 +27,4 @@ export function DemoControls({ runtime, geocode, autocomplete, compare, panels,
                 ? panels.compare({ result, compareMode: compare.compareMode, compareVersion: compare.compareVersion })
                 : null, panels.footer] }));
 }
-//# sourceMappingURL=DemoControls.js.map
+//# sourceMappingURL=GeocoderControls.js.map

package/out/map/GeocoderControls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeocoderControls.js","sourceRoot":"","sources":["../../lib/map/GeocoderControls.tsx"],"names":[],"mappings":"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"}

package/out/map/{DemoMap.d.ts → MapCanvas.d.ts}

@@ -3,7 +3,7 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `<DemoMap>` — the declarative map shell for the geocoder demo, over `react-map-gl/maplibre` (v8).
+ *   `<MapCanvas>` — the declarative map shell for the geocoder demo, over `react-map-gl/maplibre` (v8).
  *   Phase 1 is the shell only: a `<Map>` that takes a host-composed `mapStyle`, an initial (or
  *   controlled) view state, and a `children` slot for the overlays/markers that land in later phases.
  *   No overlay/marker/camera logic lives here yet.
@@ -15,27 +15,27 @@
  *   the root barrel.
  *
  *   CSS: the package imports no CSS from its modules (the node-safe invariant), so a host that renders
- *   `<DemoMap>` must import `maplibre-gl/dist/maplibre-gl.css` itself (plus `@mailwoman/react/styles.css`
- *   for the `.mw-demo-map` container). `<DemoMap>` is intrinsically a client component — a host that
+ *   `<MapCanvas>` must import `maplibre-gl/dist/maplibre-gl.css` itself (plus `@mailwoman/react/styles.css`
+ *   for the `.mw-demo-map` container). `<MapCanvas>` is intrinsically a client component — a host that
  *   server-renders should wrap it in a client boundary (the package's `ClientOnly`), exactly as the
- *   composed `GeocoderDemo` will in a later phase.
+ *   composed `Geocoder` will in a later phase.
  */
 import type { CSSProperties, ReactNode, Ref } from "react";
 import type { MapProps, MapRef, ViewStateChangeEvent } from "react-map-gl/maplibre";
 /**
- * The style a `<DemoMap>` renders — a style URL or an inline/composed `StyleSpecification`.
+ * The style a `<MapCanvas>` renders — a style URL or an inline/composed `StyleSpecification`.
  */
-export type DemoMapStyle = NonNullable<MapProps["mapStyle"]>;
+export type MapCanvasStyle = NonNullable<MapProps["mapStyle"]>;
 /**
- * Override for the `<Map>` props `<DemoMap>` does not surface explicitly (e.g. `minZoom`, `attributionControl`,
- * `maplibreLogo`). The controlled fields DemoMap owns are omitted so they can't be set twice.
+ * Override for the `<Map>` props `<MapCanvas>` does not surface explicitly (e.g. `minZoom`, `attributionControl`,
+ * `maplibreLogo`). The controlled fields MapCanvas owns are omitted so they can't be set twice.
  */
-export type DemoMapExtraProps = Partial<Omit<MapProps, "mapStyle" | "initialViewState" | "viewState" | "onMove" | "children" | "style" | "ref">>;
-export interface DemoMapProps {
+export type MapCanvasExtraProps = Partial<Omit<MapProps, "mapStyle" | "initialViewState" | "viewState" | "onMove" | "children" | "style" | "ref">>;
+export interface MapCanvasProps {
     /**
      * The map style — host-composed `StyleSpecification` or a style URL.
      */
-    mapStyle: DemoMapStyle;
+    mapStyle: MapCanvasStyle;
     /**
      * Uncontrolled initial camera. Use this OR `viewState`, not both.
      */
@@ -69,13 +69,13 @@ export interface DemoMapProps {
      */
     style?: CSSProperties;
     /**
-     * Remaining `<Map>` props DemoMap does not surface explicitly.
+     * Remaining `<Map>` props MapCanvas does not surface explicitly.
      */
-    mapProps?: DemoMapExtraProps;
+    mapProps?: MapCanvasExtraProps;
 }
 /**
  * The controlled-viewport map shell. Renders a sized wrapper around a `react-map-gl/maplibre` `<Map>`; everything
  * host-specific (the composed `mapStyle`, the initial center) is injected, and overlays ride in as `children`.
  */
-export declare function DemoMap({ mapStyle, initialViewState, viewState, onMove, projection, mapRef, children, className, style, mapProps, }: DemoMapProps): ReactNode;
-//# sourceMappingURL=DemoMap.d.ts.map
+export declare function MapCanvas({ mapStyle, initialViewState, viewState, onMove, projection, mapRef, children, className, style, mapProps, }: MapCanvasProps): ReactNode;
+//# sourceMappingURL=MapCanvas.d.ts.map

package/out/map/MapCanvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapCanvas.d.ts","sourceRoot":"","sources":["../../lib/map/MapCanvas.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAE1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAEnF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAA;AAE9D;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,CACxC,IAAI,CAAC,QAAQ,EAAE,UAAU,GAAG,kBAAkB,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,KAAK,CAAC,CACvG,CAAA;AAED,MAAM,WAAW,cAAc;IAC9B;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAA;IACxB;;OAEG;IACH,gBAAgB,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAA;IAC/C;;OAEG;IACH,SAAS,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAA;IACjC;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAA;IAC9C;;OAEG;IACH,UAAU,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAA;IACnC;;OAEG;IACH,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,mBAAmB,CAAA;CAC9B;AAID;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EACzB,QAAQ,EACR,gBAAgB,EAChB,SAAS,EACT,MAAM,EACN,UAAoB,EACpB,MAAM,EACN,QAAQ,EACR,SAAS,EACT,KAAK,EACL,QAAQ,GACR,EAAE,cAAc,GAAG,SAAS,CAmB5B"}

package/out/map/{DemoMap.js → MapCanvas.js}

@@ -5,8 +5,8 @@ const FILL = { width: "100%", height: "100%" };
  * The controlled-viewport map shell. Renders a sized wrapper around a `react-map-gl/maplibre` `<Map>`; everything
  * host-specific (the composed `mapStyle`, the initial center) is injected, and overlays ride in as `children`.
  */
-export function DemoMap({ mapStyle, initialViewState, viewState, onMove, projection = "globe", mapRef, children, className, style, mapProps, }) {
+export function MapCanvas({ mapStyle, initialViewState, viewState, onMove, projection = "globe", mapRef, children, className, style, mapProps, }) {
     const wrapperClassName = className ? `mw-demo-map ${className}` : "mw-demo-map";
     return (_jsx("div", { className: wrapperClassName, style: style, children: _jsx(Map, { ...mapProps, ref: mapRef, mapStyle: mapStyle, initialViewState: initialViewState, viewState: viewState, onMove: onMove, projection: projection, style: FILL, children: children }) }));
 }
-//# sourceMappingURL=DemoMap.js.map
+//# sourceMappingURL=MapCanvas.js.map

package/out/map/MapCanvas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapCanvas.js","sourceRoot":"","sources":["../../lib/map/MapCanvas.tsx"],"names":[],"mappings":";AAwBA,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AA2D3C,MAAM,IAAI,GAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AAE7D;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,EACzB,QAAQ,EACR,gBAAgB,EAChB,SAAS,EACT,MAAM,EACN,UAAU,GAAG,OAAO,EACpB,MAAM,EACN,QAAQ,EACR,SAAS,EACT,KAAK,EACL,QAAQ,GACQ;IAChB,MAAM,gBAAgB,GAAG,SAAS,CAAC,CAAC,CAAC,eAAe,SAAS,EAAE,CAAC,CAAC,CAAC,aAAa,CAAA;IAE/E,OAAO,CACN,cAAK,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,YAC7C,KAAC,GAAG,OACC,QAAQ,EACZ,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,EAClC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,IAAI,YAEV,QAAQ,GACJ,GACD,CACN,CAAA;AACF,CAAC"}

package/out/map/PlaceMarker.d.ts

@@ -6,7 +6,7 @@
  *   `<PlaceMarker>` — the resolved-place pin, as a declarative `react-map-gl/maplibre` `<Marker>`. This
  *   replaces the old imperative `new maplibre.Marker(...).setLngLat(...).addTo(map)` (+ the manual
  *   `markerRef.current.remove()` teardown) from the demo's redraw effect: mounting/unmounting the marker
- *   is now React's job, keyed on the resolved candidate. Renders as a child of `<DemoMap>`.
+ *   is now React's job, keyed on the resolved candidate. Renders as a child of `<MapCanvas>`.
  *
  *   NODE-IMPORT SAFETY: imports `react-map-gl/maplibre` at module scope, so it is reachable ONLY through
  *   the `@mailwoman/react/map` subpath, never the package root.

package/out/map/ResolvedPlaceLayers.d.ts

@@ -3,10 +3,10 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `<ResolvedPlaceLayers>` — the drop-in that renders a whole {@link MapPlaceRenderSpec} as `<DemoMap>`
+ *   `<ResolvedPlaceLayers>` — the drop-in that renders a whole {@link MapPlaceRenderSpec} as `<MapCanvas>`
  *   children: the marker(s), the outline, and (optionally) the camera move. This is the declarative
  *   replacement for the demo's imperative marker/bbox/camera redraw effect — a consumer computes the spec
- *   with `useMapPlaceRender(place)` and drops `<ResolvedPlaceLayers spec={spec} />` inside `<DemoMap>`.
+ *   with `useMapPlaceRender(place)` and drops `<ResolvedPlaceLayers spec={spec} />` inside `<MapCanvas>`.
  *
  *   `spec = null` (no result / no candidate) renders nothing, which also unmounts the previous marker +
  *   outline — the teardown the old effect did by hand (`markerRef.remove()`, `clearBbox`) is now just
@@ -21,7 +21,7 @@ export interface ResolvedPlaceLayersProps {
     spec: MapPlaceRenderSpec | null;
     /**
      * Apply the computed camera target via {@link ResultCamera}. @default true. Set false when the consumer drives the
-     * camera itself (e.g. a controlled `<DemoMap viewState>` fed by {@link cameraToViewState}).
+     * camera itself (e.g. a controlled `<MapCanvas viewState>` fed by {@link cameraToViewState}).
      */
     applyCamera?: boolean;
     /**

package/out/map/ResultCamera.d.ts

@@ -11,7 +11,7 @@
  *   `useMap()` (exactly as `DashboardMap`/`GeoJSONClipboardLayer` reach the map), never a threaded handle.
  *
  *   A consumer that prefers a hard, declarative jump can instead feed the target through
- *   {@link cameraToViewState} into a controlled `<DemoMap viewState>` and skip this component — the
+ *   {@link cameraToViewState} into a controlled `<MapCanvas viewState>` and skip this component — the
  *   `center` case has that declarative path; only `bounds` strictly requires this. Renders nothing.
  *
  *   `target` is expected to be the STABLE, memoized `camera` off a `useMapPlaceRender` spec, so listing it

package/out/map/ResultCamera.js

@@ -11,7 +11,7 @@
  *   `useMap()` (exactly as `DashboardMap`/`GeoJSONClipboardLayer` reach the map), never a threaded handle.
  *
  *   A consumer that prefers a hard, declarative jump can instead feed the target through
- *   {@link cameraToViewState} into a controlled `<DemoMap viewState>` and skip this component — the
+ *   {@link cameraToViewState} into a controlled `<MapCanvas viewState>` and skip this component — the
  *   `center` case has that declarative path; only `bounds` strictly requires this. Renders nothing.
  *
  *   `target` is expected to be the STABLE, memoized `camera` off a `useMapPlaceRender` spec, so listing it

package/out/map/ResultPanel.d.ts

@@ -7,14 +7,14 @@
  *   presentational units (it does not re-implement any of them): `KindBadge`, `ComponentTable`,
  *   `ResolvedPlace`, `CandidatePicker`, plus the `CopyButton` + `buildParsePayload` copy affordance. This
  *   is the standalone, story-testable unit the demo's floating panel renders (the map analogue of the
- *   result block PipelineExplorer inlines), so `GeocoderDemo` composes ONE panel instead of duplicating
+ *   result block PipelineExplorer inlines), so `Geocoder` composes ONE panel instead of duplicating
  *   the marker/table/candidate glue. Heavy host visualizers (span highlight, tree, timing) slot in via
  *   `extras`; the no-resolve diagnostic via `failure`.
  *
  *   NODE-SAFE: pure React + the shared units, no maplibre.
  */
+import type { ParseResult, ResolvedPlaceView } from "@mailwoman/core/pipeline/client-result";
 import type { ReactNode } from "react";
-import type { ParseResult, ResolvedPlaceView } from "#pipeline/types";
 export interface ResultPanelProps {
     /**
      * The parse+resolve result to render.

package/out/map/ResultPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ResultPanel.d.ts","sourceRoot":"","sources":["../../lib/map/ResultPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAQrE,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,MAAM,EAAE,WAAW,CAAA;IACnB;;OAEG;IACH,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC3C;;OAEG;IACH,sBAAsB,EAAE,MAAM,CAAA;IAC9B;;OAEG;IACH,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,CAAA;IAC3C;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,CAAA;CAC5C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAC3B,MAAM,EACN,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,MAAM,EACN,OAAO,GACP,EAAE,gBAAgB,GAAG,SAAS,CAkC9B"}
+{"version":3,"file":"ResultPanel.d.ts","sourceRoot":"","sources":["../../lib/map/ResultPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC5F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAUtC,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,MAAM,EAAE,WAAW,CAAA;IACnB;;OAEG;IACH,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC3C;;OAEG;IACH,sBAAsB,EAAE,MAAM,CAAA;IAC9B;;OAEG;IACH,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,CAAA;IAC3C;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,CAAA;CAC5C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAC3B,MAAM,EACN,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,MAAM,EACN,OAAO,GACP,EAAE,gBAAgB,GAAG,SAAS,CAkC9B"}

package/out/map/ResultPanel.js.map

@@ -1 +1 @@
-{"version":3,"file":"ResultPanel.js","sourceRoot":"","sources":["../../lib/map/ResultPanel.tsx"],"names":[],"mappings":";AAkBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGlD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAA0B,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAyB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAiC,CAAA;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAAgC,CAAA;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA+B,CAAA;AA6B7D;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,EAC3B,MAAM,EACN,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,MAAM,EACN,OAAO,GACW;IAClB,OAAO,CACN,eAAK,SAAS,EAAC,WAAW,aACzB,eAAK,SAAS,EAAC,mBAAmB,aACjC,6CAA0B,EAC1B,KAAC,UAAU,IACV,KAAK,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACzD,KAAK,EAAC,WAAW,EACjB,WAAW,EAAC,eAAU,GACrB,IACG,EAEL,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAC,SAAS,IAAC,UAAU,EAAE,MAAM,CAAC,UAAU,GAAI,CAAC,CAAC,CAAC,IAAI,EAEvE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAE/B,KAAC,cAAc,IAAC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAI,EAEtC,iBAAiB,CAAC,CAAC,CAAC,CACpB,8BACC,KAAC,aAAa,IAAC,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,GAAI,EACvE,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAC/B,KAAC,eAAe,IACf,UAAU,EAAE,MAAM,CAAC,UAAU,EAC7B,aAAa,EAAE,sBAAsB,EACrC,QAAQ,EAAE,iBAAiB,GAC1B,CACF,CAAC,CAAC,CAAC,IAAI,IACN,CACH,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CACb,OAAO,CAAC,MAAM,CAAC,CACf,CAAC,CAAC,CAAC,IAAI,IACH,CACN,CAAA;AACF,CAAC"}
+{"version":3,"file":"ResultPanel.js","sourceRoot":"","sources":["../../lib/map/ResultPanel.tsx"],"names":[],"mappings":";AAmBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAA0B,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAyB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAiC,CAAA;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAAgC,CAAA;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA+B,CAAA;AA6B7D;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,EAC3B,MAAM,EACN,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,MAAM,EACN,OAAO,GACW;IAClB,OAAO,CACN,eAAK,SAAS,EAAC,WAAW,aACzB,eAAK,SAAS,EAAC,mBAAmB,aACjC,6CAA0B,EAC1B,KAAC,UAAU,IACV,KAAK,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACzD,KAAK,EAAC,WAAW,EACjB,WAAW,EAAC,eAAU,GACrB,IACG,EAEL,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAC,SAAS,IAAC,UAAU,EAAE,MAAM,CAAC,UAAU,GAAI,CAAC,CAAC,CAAC,IAAI,EAEvE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAE/B,KAAC,cAAc,IAAC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAI,EAEtC,iBAAiB,CAAC,CAAC,CAAC,CACpB,8BACC,KAAC,aAAa,IAAC,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,GAAI,EACvE,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAC/B,KAAC,eAAe,IACf,UAAU,EAAE,MAAM,CAAC,UAAU,EAC7B,aAAa,EAAE,sBAAsB,EACrC,QAAQ,EAAE,iBAAiB,GAC1B,CACF,CAAC,CAAC,CAAC,IAAI,IACN,CACH,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CACb,OAAO,CAAC,MAAM,CAAC,CACf,CAAC,CAAC,CAAC,IAAI,IACH,CACN,CAAA;AACF,CAAC"}

package/out/map/VersionPicker.d.ts

@@ -5,19 +5,19 @@
  *
  *   `<VersionPicker>` — the model-version `<select>` from the demo's control panel (`_app.tsx:1230-1254`),
  *   as a dumb presentational unit: the available bundles + current selection come in as props, the choice
- *   goes out through `onSelect`. No load state, no manifest fetch — the host (via `useDemoRuntime`) owns
+ *   goes out through `onSelect`. No load state, no manifest fetch — the host (via `useReleaseRuntime`) owns
  *   that. Renders nothing when there is fewer than two versions to choose between.
  *
  *   NODE-SAFE: pure React + a `<select>`, no maplibre. It rides the `@mailwoman/react/map` subpath only
  *   because it is a demo-specific control, not because it needs WebGL.
  */
 import type { ReactNode } from "react";
-import type { DemoVersionOption } from "#map/types";
+import type { VersionOption } from "#map/types";
 export interface VersionPickerProps {
     /**
      * The selectable model bundles.
      */
-    versions: ReadonlyArray<DemoVersionOption>;
+    versions: ReadonlyArray<VersionOption>;
     /**
      * The currently-selected version tag.
      */

package/out/map/VersionPicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VersionPicker.d.ts","sourceRoot":"","sources":["../../lib/map/VersionPicker.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnD,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,QAAQ,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAA;IAC1C;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB;;OAEG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAC7B,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,KAAuB,GACvB,EAAE,kBAAkB,GAAG,SAAS,CAuBhC"}
+{"version":3,"file":"VersionPicker.d.ts","sourceRoot":"","sources":["../../lib/map/VersionPicker.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IACtC;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB;;OAEG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAC7B,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,KAAuB,GACvB,EAAE,kBAAkB,GAAG,SAAS,CAuBhC"}

package/out/map/fake-runtime.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   A fake geocoder runtime: canned parse + resolve, an offline stub map style, canned autocomplete, a version list.
+ *   No network, no ONNX, no maplibre at run time — everything is data. It is what the stories and component tests
+ *   mount, and what a host mounts to show the UI without the model.
+ */
+import type { ParseResult } from "@mailwoman/core/pipeline/client-result";
+import type { GeocoderRuntime, Suggestion } from "#map/types";
+import type { PipelineRuntime } from "#pipeline/types";
+import type { MapCanvasStyle } from "./MapCanvas.tsx";
+/**
+ * An offline stub map style — one solid `background` layer, zero sources, zero network. Safe for headless Storybook.
+ */
+export declare const STUB_MAP_STYLE: MapCanvasStyle;
+/**
+ * Canned place-autocomplete suggestions — a synchronous fake for the FST prefix-walk.
+ */
+export declare const FAKE_SUGGESTIONS: Suggestion[];
+/**
+ * A fake DEMO runtime — the map analogue of {@link makePipelineRuntime}. It composes the pipeline fake (canned
+ * parse+resolve) with the map surface: the offline stub style, a version list, a backend, an injected autocomplete, and
+ * a `resolveMapPlace` that hands the selected candidate a bbox so the declarative overlays draw a marker + outline. No
+ * network, no ONNX, no maplibre-at-runtime — everything is data. `runParseWithBias` delegates to the base parse (the
+ * bias is ignored by the fake but present so the parameter is exercised).
+ */
+export declare function makeFakeGeocoderRuntime(overrides?: Partial<GeocoderRuntime>): GeocoderRuntime;
+/**
+ * A fixed, fully-populated parse+resolve result — the shared fixture behind the pipeline runtime + the result panel.
+ */
+export declare function makeFakeParseResult(input?: string): ParseResult;
+/**
+ * A fake parse+resolve runtime that returns a fixed, fully-populated result.
+ */
+export declare function makePipelineRuntime(overrides?: Partial<PipelineRuntime>): PipelineRuntime;
+//# sourceMappingURL=fake-runtime.d.ts.map

package/out/map/fake-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-runtime.d.ts","sourceRoot":"","sources":["../../lib/map/fake-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAA;AAGzE,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,cAK5B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAAU,EAIxC,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,eAAe,CAkCjG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,SAAoC,GAAG,WAAW,CAmB1F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,eAAe,CAc7F"}