@mailwoman/react 7.5.0 → 7.7.0

package/out/map/GeocoderDemo.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @copyright Sister Software
+ * @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 seam 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 /
+ *   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
+ *       resolved-place marker/outline/camera ({@link ResolvedPlaceLayers}) driven by the parse state,
+ *     - the hooks that wire them: {@link useDemoGeocode} (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
+ *   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, useRef } from "react";
+import { ClientOnly } from "../common/ClientOnly.js";
+import {} from "../common/PresetChips.js";
+import { DemoControls } from "./DemoControls.js";
+import { DemoMap } from "./DemoMap.js";
+import { OverlayLayers } from "./OverlayLayers.js";
+import { ResolvedPlaceLayers } from "./ResolvedPlaceLayers.js";
+import { useCompareState } from "./useCompareState.js";
+import { useDemoGeocode } from "./useDemoGeocode.js";
+import { useMapPlaceRender } from "./useMapPlaceRender.js";
+import { usePlaceAutocomplete } from "./usePlaceAutocomplete.js";
+function GeocoderDemoInner({ runtime, panels, defaultAddress, presets, minBiasZoom, applyResultCamera, }) {
+    const mapRef = useRef(null);
+    // Read the viewport bias at submit time — through the map handle, never a threaded state value, so granting/zooming
+    // mid-session doesn't re-create the parse callback. Below the min-bias zoom, a whole-globe center is noise → null.
+    const getBias = useCallback(() => {
+        const map = mapRef.current?.getMap();
+        if (!map)
+            return null;
+        const zoom = map.getZoom();
+        if (zoom < minBiasZoom)
+            return null;
+        const center = map.getCenter();
+        return { center: [center.lng, center.lat], zoom };
+    }, [minBiasZoom]);
+    const geocode = useDemoGeocode({ runtime, defaultText: defaultAddress, getBias });
+    const compare = useCompareState();
+    const autocomplete = usePlaceAutocomplete({
+        text: geocode.text,
+        setText: geocode.setText,
+        autocomplete: runtime.autocomplete,
+    });
+    const spec = useMapPlaceRender(geocode.mapPlace);
+    const onSelectVersion = useCallback((version) => {
+        runtime.selectVersion?.(version);
+        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: {
+                        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] }));
+}
+/** The composed geocoder demo, behind a `ClientOnly` SSR boundary (the map is intrinsically a client component). */
+export function GeocoderDemo({ runtime, panels = {}, defaultAddress = "", 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 })) }));
+}
+//# sourceMappingURL=GeocoderDemo.js.map

package/out/map/GeocoderDemo.js.map

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

package/out/map/OverlayLayers.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `<OverlayLayers>` — renders the host-supplied {@link OverlaySpec}s (coverage "fog of war",
+ *   race-dots, …) as declarative `<Source>` + `<Layer>`s. This replaces the demo's imperative
+ *   `map.addSource` / `map.addLayer` overlay loops (and their `isStyleLoaded()` / `styledata` gates):
+ *   the host composes the specs, the package renders them, react-map-gl owns the add/remove lifecycle.
+ *
+ *   Each overlay's `visible` flag flips the layers' `visibility` layout property — the declarative seam a
+ *   layer-toggle control drives in a later phase. NODE-IMPORT SAFETY: imports `react-map-gl/maplibre` —
+ *   reachable only via `@mailwoman/react/map`.
+ */
+import { type ReactNode } from "react";
+import type { OverlaySpec } from "./types.ts";
+export interface OverlayLayersProps {
+    /** The overlays to render, in draw order (first is drawn first / lowest). */
+    overlays?: OverlaySpec[];
+}
+/** Render each overlay as one `<Source>` and its `<Layer>`s, honoring the `visible` flag via `visibility`. */
+export declare function OverlayLayers({ overlays }: OverlayLayersProps): ReactNode;
+//# sourceMappingURL=OverlayLayers.d.ts.map

package/out/map/OverlayLayers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayLayers.d.ts","sourceRoot":"","sources":["../../map/OverlayLayers.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAGhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,MAAM,WAAW,kBAAkB;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;CACxB;AAED,8GAA8G;AAC9G,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,kBAAkB,GAAG,SAAS,CAmBzE"}

package/out/map/OverlayLayers.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `<OverlayLayers>` — renders the host-supplied {@link OverlaySpec}s (coverage "fog of war",
+ *   race-dots, …) as declarative `<Source>` + `<Layer>`s. This replaces the demo's imperative
+ *   `map.addSource` / `map.addLayer` overlay loops (and their `isStyleLoaded()` / `styledata` gates):
+ *   the host composes the specs, the package renders them, react-map-gl owns the add/remove lifecycle.
+ *
+ *   Each overlay's `visible` flag flips the layers' `visibility` layout property — the declarative seam a
+ *   layer-toggle control drives in a later phase. NODE-IMPORT SAFETY: imports `react-map-gl/maplibre` —
+ *   reachable only via `@mailwoman/react/map`.
+ */
+import { Fragment } from "react";
+import { Layer, Source } from "react-map-gl/maplibre";
+/** Render each overlay as one `<Source>` and its `<Layer>`s, honoring the `visible` flag via `visibility`. */
+export function OverlayLayers({ overlays }) {
+    if (!overlays || overlays.length === 0)
+        return null;
+    return (_jsx(_Fragment, { children: overlays.map((overlay) => {
+            const visibility = overlay.visible === false ? "none" : "visible";
+            return (_jsxs(Fragment, { children: [_jsx(Source, { id: overlay.id, ...overlay.source }), overlay.layers.map((layer) => (_jsx(Layer, { ...layer, layout: { ...layer.layout, visibility } }, layer.id)))] }, overlay.id));
+        }) }));
+}
+//# sourceMappingURL=OverlayLayers.js.map

package/out/map/OverlayLayers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayLayers.js","sourceRoot":"","sources":["../../map/OverlayLayers.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAA;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AASrD,8GAA8G;AAC9G,MAAM,UAAU,aAAa,CAAC,EAAE,QAAQ,EAAsB;IAC7D,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAEnD,OAAO,CACN,4BACE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACzB,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;YAEjE,OAAO,CACN,MAAC,QAAQ,eACR,KAAC,MAAM,IAAC,EAAE,EAAE,OAAO,CAAC,EAAE,KAAM,OAAO,CAAC,MAAM,GAAI,EAC7C,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAC9B,KAAC,KAAK,OAAoB,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,IAA5D,KAAK,CAAC,EAAE,CAAwD,CAC5E,CAAC,KAJY,OAAO,CAAC,EAAE,CAKd,CACX,CAAA;QACF,CAAC,CAAC,GACA,CACH,CAAA;AACF,CAAC"}

package/out/map/PlaceAutocomplete.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `<PlaceAutocomplete>` — the "Did you mean" suggestion listbox from the demo (`_app.tsx:1394-1418`), as
+ *   a dumb presentational unit. It renders the current suggestions with the keyboard-highlighted active
+ *   descendant; the state + keyboard nav live in {@link usePlaceAutocomplete}. Renders `null` when there
+ *   is nothing to suggest, so the row only appears when useful. Wire the ids from the hook so the input's
+ *   `aria-controls` / `aria-activedescendant` match this listbox.
+ *
+ *   NODE-SAFE: pure React, no maplibre.
+ */
+import type { ReactNode } from "react";
+import type { Suggestion } from "./types.ts";
+export interface PlaceAutocompleteProps {
+    /** The suggestions to render (from {@link usePlaceAutocomplete}). */
+    suggestions: Suggestion[];
+    /** The keyboard-highlighted index; `-1` for none. */
+    activeIndex: number;
+    /** Fired (with the suggestion `value`) when one is clicked. */
+    onPick: (value: string) => void;
+    /** Fired with the index a pointer entered, so hover matches keyboard highlight. */
+    onHover?: (index: number) => void;
+    /** The listbox element id — pass `listboxId` from the hook (matches the input's `aria-controls`). */
+    listboxId: string;
+    /** Build the option element id — pass `optionId` from the hook. */
+    optionId: (index: number) => string;
+    /** Leading label. @default "Did you mean:" */
+    caption?: string;
+}
+/** The suggestion listbox. */
+export declare function PlaceAutocomplete({ suggestions, activeIndex, onPick, onHover, listboxId, optionId, caption, }: PlaceAutocompleteProps): ReactNode;
+//# sourceMappingURL=PlaceAutocomplete.d.ts.map

package/out/map/PlaceAutocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaceAutocomplete.d.ts","sourceRoot":"","sources":["../../map/PlaceAutocomplete.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,MAAM,WAAW,sBAAsB;IACtC,qEAAqE;IACrE,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,mFAAmF;IACnF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,qGAAqG;IACrG,SAAS,EAAE,MAAM,CAAA;IACjB,mEAAmE;IACnE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IACnC,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,8BAA8B;AAC9B,wBAAgB,iBAAiB,CAAC,EACjC,WAAW,EACX,WAAW,EACX,MAAM,EACN,OAAO,EACP,SAAS,EACT,QAAQ,EACR,OAAyB,GACzB,EAAE,sBAAsB,GAAG,SAAS,CAuBpC"}

package/out/map/PlaceAutocomplete.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cx } from "../common/cx.js";
+/** The suggestion listbox. */
+export function PlaceAutocomplete({ suggestions, activeIndex, onPick, onHover, listboxId, optionId, caption = "Did you mean:", }) {
+    if (suggestions.length === 0)
+        return null;
+    return (_jsxs("div", { className: "mw-demo-suggest", id: listboxId, role: "listbox", "aria-label": "Place suggestions", children: [_jsx("span", { className: "mw-demo-suggest__label", children: caption }), suggestions.map((s, i) => (_jsx("button", { id: optionId(i), type: "button", role: "option", "aria-selected": i === activeIndex, className: cx("mw-chip", { "mw-chip--active": i === activeIndex }), onMouseEnter: () => onHover?.(i), onClick: () => onPick(s.value), title: s.placetype, children: s.label ?? s.value }, `${s.value}-${i}`)))] }));
+}
+//# sourceMappingURL=PlaceAutocomplete.js.map

package/out/map/PlaceAutocomplete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaceAutocomplete.js","sourceRoot":"","sources":["../../map/PlaceAutocomplete.tsx"],"names":[],"mappings":";AAgBA,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AAoBpC,8BAA8B;AAC9B,MAAM,UAAU,iBAAiB,CAAC,EACjC,WAAW,EACX,WAAW,EACX,MAAM,EACN,OAAO,EACP,SAAS,EACT,QAAQ,EACR,OAAO,GAAG,eAAe,GACD;IACxB,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAEzC,OAAO,CACN,eAAK,SAAS,EAAC,iBAAiB,EAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAC,SAAS,gBAAY,mBAAmB,aAC5F,eAAM,SAAS,EAAC,wBAAwB,YAAE,OAAO,GAAQ,EACxD,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAC1B,iBAEC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,EACf,IAAI,EAAC,QAAQ,EACb,IAAI,EAAC,QAAQ,mBACE,CAAC,KAAK,WAAW,EAChC,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,EAAE,iBAAiB,EAAE,CAAC,KAAK,WAAW,EAAE,CAAC,EAClE,YAAY,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAChC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAC9B,KAAK,EAAE,CAAC,CAAC,SAAS,YAEjB,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,IAVd,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAWd,CACT,CAAC,IACG,CACN,CAAA;AACF,CAAC"}

package/out/map/PlaceMarker.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `<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>`.
+ *
+ *   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.
+ */
+import type { ReactNode } from "react";
+export interface PlaceMarkerProps {
+    /** Marker longitude. */
+    longitude: number;
+    /** Marker latitude. */
+    latitude: number;
+    /** Pin color. @default the house pink. */
+    color?: string;
+    /** Which part of the marker sits on the coordinate. @default "center" (a symmetric dot). */
+    anchor?: "center" | "top" | "bottom" | "left" | "right";
+}
+/** A single resolved-place marker. Wraps `react-map-gl`'s `<Marker>` with the demo's default color. */
+export declare function PlaceMarker({ longitude, latitude, color, anchor, }: PlaceMarkerProps): ReactNode;
+//# sourceMappingURL=PlaceMarker.d.ts.map

package/out/map/PlaceMarker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaceMarker.d.ts","sourceRoot":"","sources":["../../map/PlaceMarker.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAMtC,MAAM,WAAW,gBAAgB;IAChC,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4FAA4F;IAC5F,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;CACvD;AAED,uGAAuG;AACvG,wBAAgB,WAAW,CAAC,EAC3B,SAAS,EACT,QAAQ,EACR,KAAoB,EACpB,MAAiB,GACjB,EAAE,gBAAgB,GAAG,SAAS,CAE9B"}

package/out/map/PlaceMarker.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Marker } from "react-map-gl/maplibre";
+/** The house pink the demo has always drawn the resolved-place marker in. */
+const MARKER_COLOR = "#e0367c";
+/** A single resolved-place marker. Wraps `react-map-gl`'s `<Marker>` with the demo's default color. */
+export function PlaceMarker({ longitude, latitude, color = MARKER_COLOR, anchor = "center", }) {
+    return _jsx(Marker, { longitude: longitude, latitude: latitude, color: color, anchor: anchor });
+}
+//# sourceMappingURL=PlaceMarker.js.map

package/out/map/PlaceMarker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaceMarker.js","sourceRoot":"","sources":["../../map/PlaceMarker.tsx"],"names":[],"mappings":";AAeA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAE9C,6EAA6E;AAC7E,MAAM,YAAY,GAAG,SAAS,CAAA;AAa9B,uGAAuG;AACvG,MAAM,UAAU,WAAW,CAAC,EAC3B,SAAS,EACT,QAAQ,EACR,KAAK,GAAG,YAAY,EACpB,MAAM,GAAG,QAAQ,GACC;IAClB,OAAO,KAAC,MAAM,IAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAI,CAAA;AAC1F,CAAC"}

package/out/map/ResolvedPlaceLayers.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `<ResolvedPlaceLayers>` — the drop-in that renders a whole {@link MapPlaceRenderSpec} as `<DemoMap>`
+ *   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>`.
+ *
+ *   `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
+ *   React unmounting. NODE-IMPORT SAFETY: pulls the map components — `@mailwoman/react/map` only.
+ */
+import type { ReactNode } from "react";
+import type { MapPlaceRenderSpec } from "./place-render.ts";
+export interface ResolvedPlaceLayersProps {
+    /** The render spec (from {@link useMapPlaceRender}); `null` renders nothing. */
+    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}).
+     */
+    applyCamera?: boolean;
+    /** Animate the camera move. Forwarded to {@link ResultCamera}. @default true */
+    animateCamera?: boolean;
+    /** Source/layer id prefix for the outline. @default "mw-result" */
+    outlineId?: string;
+    /** Marker color. @default the house pink. */
+    markerColor?: string;
+}
+/** Render the marker(s), outline, and (optional) camera move for one resolved place. */
+export declare function ResolvedPlaceLayers({ spec, applyCamera, animateCamera, outlineId, markerColor, }: ResolvedPlaceLayersProps): ReactNode;
+//# sourceMappingURL=ResolvedPlaceLayers.d.ts.map

package/out/map/ResolvedPlaceLayers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResolvedPlaceLayers.d.ts","sourceRoot":"","sources":["../../map/ResolvedPlaceLayers.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAK3D,MAAM,WAAW,wBAAwB;IACxC,gFAAgF;IAChF,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAC/B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,EACnC,IAAI,EACJ,WAAkB,EAClB,aAAoB,EACpB,SAAS,EACT,WAAW,GACX,EAAE,wBAAwB,GAAG,SAAS,CAiBtC"}

package/out/map/ResolvedPlaceLayers.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { PlaceMarker } from "./PlaceMarker.js";
+import { ResultCamera } from "./ResultCamera.js";
+import { ResultOverlay } from "./ResultOverlay.js";
+/** Render the marker(s), outline, and (optional) camera move for one resolved place. */
+export function ResolvedPlaceLayers({ spec, applyCamera = true, animateCamera = true, outlineId, markerColor, }) {
+    if (!spec)
+        return null;
+    return (_jsxs(_Fragment, { children: [spec.markers.map(([longitude, latitude], index) => (_jsx(PlaceMarker, { longitude: longitude, latitude: latitude, color: markerColor }, `${longitude},${latitude},${index}`))), _jsx(ResultOverlay, { outline: spec.outline, id: outlineId, color: markerColor }), applyCamera ? _jsx(ResultCamera, { target: spec.camera, animate: animateCamera }) : null] }));
+}
+//# sourceMappingURL=ResolvedPlaceLayers.js.map

package/out/map/ResolvedPlaceLayers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResolvedPlaceLayers.js","sourceRoot":"","sources":["../../map/ResolvedPlaceLayers.tsx"],"names":[],"mappings":";AAkBA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAmB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAoB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAqB,CAAA;AAkBnD,wFAAwF;AACxF,MAAM,UAAU,mBAAmB,CAAC,EACnC,IAAI,EACJ,WAAW,GAAG,IAAI,EAClB,aAAa,GAAG,IAAI,EACpB,SAAS,EACT,WAAW,GACe;IAC1B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IAEtB,OAAO,CACN,8BACE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CACnD,KAAC,WAAW,IAEX,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,WAAW,IAHb,GAAG,SAAS,IAAI,QAAQ,IAAI,KAAK,EAAE,CAIvC,CACF,CAAC,EACF,KAAC,aAAa,IAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,GAAI,EAC1E,WAAW,CAAC,CAAC,CAAC,KAAC,YAAY,IAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,GAAI,CAAC,CAAC,CAAC,IAAI,IACjF,CACH,CAAA;AACF,CAAC"}

package/out/map/ResultCamera.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `<ResultCamera>` — applies the {@link MapCameraTarget} a {@link MapPlaceRenderSpec} computes, by
+ *   animating the live map to it. This is the ONE deliberately-imperative touch in the phase-2 overlays,
+ *   and it is justified: maplibre exposes animated camera moves (`flyTo`) and viewport-fitting
+ *   (`fitBounds`, which needs the map's PIXEL dimensions + padding) ONLY imperatively — react-map-gl has
+ *   no declarative prop for "animate to these bounds". It is applied the v8-idiomatic way, through
+ *   `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
+ *   `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
+ *   as the effect dependency re-runs the camera move exactly when the resolved place changes — no
+ *   value-key dance, no dependency-lint suppression.
+ */
+import { type ReactNode } from "react";
+import type { MapCameraTarget } from "./place-render.ts";
+export interface ResultCameraProps {
+    /** The camera target to animate to. `null` leaves the camera untouched (no result yet). */
+    target: MapCameraTarget | null;
+    /**
+     * Animate (`flyTo`/`fitBounds`) vs jump. @default true. When false, a `center` target jumps with `jumpTo`; a `bounds`
+     * target still uses `fitBounds` (no instantaneous fit exists) but with `duration: 0`.
+     */
+    animate?: boolean;
+}
+/** Drive the live map to `target`. No DOM of its own — it is a behavior mounted as a `<Map>` child. */
+export declare function ResultCamera({ target, animate }: ResultCameraProps): ReactNode;
+//# sourceMappingURL=ResultCamera.d.ts.map

package/out/map/ResultCamera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultCamera.d.ts","sourceRoot":"","sources":["../../map/ResultCamera.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,OAAO,CAAA;AAGjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,MAAM,WAAW,iBAAiB;IACjC,2FAA2F;IAC3F,MAAM,EAAE,eAAe,GAAG,IAAI,CAAA;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,uGAAuG;AACvG,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,OAAc,EAAE,EAAE,iBAAiB,GAAG,SAAS,CAsBrF"}

package/out/map/ResultCamera.js

@@ -0,0 +1,43 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `<ResultCamera>` — applies the {@link MapCameraTarget} a {@link MapPlaceRenderSpec} computes, by
+ *   animating the live map to it. This is the ONE deliberately-imperative touch in the phase-2 overlays,
+ *   and it is justified: maplibre exposes animated camera moves (`flyTo`) and viewport-fitting
+ *   (`fitBounds`, which needs the map's PIXEL dimensions + padding) ONLY imperatively — react-map-gl has
+ *   no declarative prop for "animate to these bounds". It is applied the v8-idiomatic way, through
+ *   `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
+ *   `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
+ *   as the effect dependency re-runs the camera move exactly when the resolved place changes — no
+ *   value-key dance, no dependency-lint suppression.
+ */
+import { useEffect } from "react";
+import { useMap } from "react-map-gl/maplibre";
+/** Drive the live map to `target`. No DOM of its own — it is a behavior mounted as a `<Map>` child. */
+export function ResultCamera({ target, animate = true }) {
+    const map = useMap();
+    useEffect(() => {
+        const instance = map.current?.getMap();
+        if (!instance || !target)
+            return;
+        if (target.kind === "center") {
+            if (animate) {
+                instance.flyTo({ center: target.center, zoom: target.zoom });
+            }
+            else {
+                instance.jumpTo({ center: target.center, zoom: target.zoom });
+            }
+            return;
+        }
+        instance.fitBounds(target.bounds, { padding: target.padding, duration: animate ? undefined : 0 });
+    }, [map, target, animate]);
+    return null;
+}
+//# sourceMappingURL=ResultCamera.js.map

package/out/map/ResultCamera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultCamera.js","sourceRoot":"","sources":["../../map/ResultCamera.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAkB,SAAS,EAAE,MAAM,OAAO,CAAA;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAc9C,uGAAuG;AACvG,MAAM,UAAU,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,EAAqB;IACzE,MAAM,GAAG,GAAG,MAAM,EAAE,CAAA;IAEpB,SAAS,CAAC,GAAG,EAAE;QACd,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,CAAA;QAEtC,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM;YAAE,OAAM;QAEhC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,OAAO,EAAE,CAAC;gBACb,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;YAC7D,CAAC;iBAAM,CAAC;gBACP,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;YAC9D,CAAC;YAED,OAAM;QACP,CAAC;QAED,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAClG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAE1B,OAAO,IAAI,CAAA;AACZ,CAAC"}

package/out/map/ResultOverlay.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `<ResultOverlay>` — the resolved-place outline (crisp admin polygon, or an approximate/exact-radius
+ *   circle) as a declarative `<Source>` + fill/line `<Layer>`s. This replaces the demo's imperative
+ *   `setPlaceOutline` / `drawApproxCircle` / `drawPlaceGeometry` / `clearBbox` helpers and their
+ *   `whenStyleReady` gate: react-map-gl owns the "add source/layer once the style is loaded, remove on
+ *   unmount" lifecycle, so the hand-rolled `isStyleLoaded()` / `styledata` races disappear.
+ *
+ *   Pass the `outline` straight from a {@link MapPlaceRenderSpec}; a `null` outline renders nothing (the
+ *   bare-point case). NODE-IMPORT SAFETY: imports `react-map-gl/maplibre` — `@mailwoman/react/map` only.
+ */
+import type { ReactNode } from "react";
+import type { PlaceGeometry } from "./geometry.ts";
+export interface ResultOverlayProps {
+    /** The outline geometry to draw, or `null` to draw nothing (the bare-point result). */
+    outline: PlaceGeometry | null;
+    /** Source/layer id prefix — override to render more than one outline on a map. @default "mw-result" */
+    id?: string;
+    /** Fill color. @default the house pink. */
+    color?: string;
+    /** Fill opacity. @default 0.12 */
+    fillOpacity?: number;
+    /** Outline stroke width (px). @default 2 */
+    lineWidth?: number;
+}
+/**
+ * Render the resolved-place outline. One geojson `<Source>` feeds a translucent fill `<Layer>` and a solid line
+ * `<Layer>` — the same two layers the imperative `setPlaceOutline` created, now declarative and self-cleaning.
+ */
+export declare function ResultOverlay({ outline, id, color, fillOpacity, lineWidth, }: ResultOverlayProps): ReactNode;
+//# sourceMappingURL=ResultOverlay.d.ts.map

package/out/map/ResultOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultOverlay.d.ts","sourceRoot":"","sources":["../../map/ResultOverlay.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAKlD,MAAM,WAAW,kBAAkB;IAClC,uFAAuF;IACvF,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;IAC7B,uGAAuG;IACvG,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC7B,OAAO,EACP,EAAgB,EAChB,KAAqB,EACrB,WAAkB,EAClB,SAAa,GACb,EAAE,kBAAkB,GAAG,SAAS,CAchC"}

package/out/map/ResultOverlay.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Layer, Source } from "react-map-gl/maplibre";
+/** The house pink, matched to {@link PlaceMarker}. */
+const OUTLINE_COLOR = "#e0367c";
+/**
+ * Render the resolved-place outline. One geojson `<Source>` feeds a translucent fill `<Layer>` and a solid line
+ * `<Layer>` — the same two layers the imperative `setPlaceOutline` created, now declarative and self-cleaning.
+ */
+export function ResultOverlay({ outline, id = "mw-result", color = OUTLINE_COLOR, fillOpacity = 0.12, lineWidth = 2, }) {
+    if (!outline)
+        return null;
+    const data = {
+        type: "FeatureCollection",
+        features: [{ type: "Feature", geometry: outline, properties: {} }],
+    };
+    return (_jsxs(Source, { id: id, type: "geojson", data: data, children: [_jsx(Layer, { id: `${id}-fill`, type: "fill", paint: { "fill-color": color, "fill-opacity": fillOpacity } }), _jsx(Layer, { id: `${id}-line`, type: "line", paint: { "line-color": color, "line-width": lineWidth } })] }));
+}
+//# sourceMappingURL=ResultOverlay.js.map

package/out/map/ResultOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultOverlay.js","sourceRoot":"","sources":["../../map/ResultOverlay.tsx"],"names":[],"mappings":";AAgBA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAIrD,sDAAsD;AACtD,MAAM,aAAa,GAAG,SAAS,CAAA;AAe/B;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,EAC7B,OAAO,EACP,EAAE,GAAG,WAAW,EAChB,KAAK,GAAG,aAAa,EACrB,WAAW,GAAG,IAAI,EAClB,SAAS,GAAG,CAAC,GACO;IACpB,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IAEzB,MAAM,IAAI,GAAG;QACZ,IAAI,EAAE,mBAA4B;QAClC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;KAC3E,CAAA;IAED,OAAO,CACN,MAAC,MAAM,IAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAC,SAAS,EAAC,IAAI,EAAE,IAAI,aACxC,KAAC,KAAK,IAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAC,MAAM,EAAC,KAAK,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,GAAI,EACpG,KAAC,KAAK,IAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAC,MAAM,EAAC,KAAK,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,GAAI,IACxF,CACT,CAAA;AACF,CAAC"}

package/out/map/ResultPanel.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `<ResultPanel>` — the demo's parse+resolve result block, assembled from the SHARED pipeline
+ *   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
+ *   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 { ReactNode } from "react";
+import type { ParseResult, ResolvedPlaceView } from "../pipeline/types.ts";
+export interface ResultPanelProps {
+    /** The parse+resolve result to render. */
+    result: ParseResult;
+    /** The selected candidate (falls back to the first), used for the resolved-place detail + copy payload. */
+    selectedCandidate: ResolvedPlaceView | null;
+    /** The selected candidate index, for the picker's active state. */
+    selectedCandidateIndex: number;
+    /** Fired when a candidate in the picker is chosen. */
+    onSelectCandidate: (index: number) => void;
+    /** Host-injected heavy visualizers (span highlight, tree, timing, …), rendered from the result. */
+    extras?: (result: ParseResult) => ReactNode;
+    /** Host-injected no-resolve diagnostic, rendered when nothing resolved. */
+    failure?: (result: ParseResult) => ReactNode;
+}
+/** The composed result block for the geocoder demo. */
+export declare function ResultPanel({ result, selectedCandidate, selectedCandidateIndex, onSelectCandidate, extras, failure, }: ResultPanelProps): ReactNode;
+//# sourceMappingURL=ResultPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ResultPanel.d.ts","sourceRoot":"","sources":["../../map/ResultPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAQtC,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE1E,MAAM,WAAW,gBAAgB;IAChC,0CAA0C;IAC1C,MAAM,EAAE,WAAW,CAAA;IACnB,2GAA2G;IAC3G,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC3C,mEAAmE;IACnE,sBAAsB,EAAE,MAAM,CAAA;IAC9B,sDAAsD;IACtD,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,mGAAmG;IACnG,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,CAAA;IAC3C,2EAA2E;IAC3E,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,CAAA;CAC5C;AAED,uDAAuD;AACvD,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

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { CopyButton } from "../common/CopyButton.js";
+import { KindBadge } from "../common/KindBadge.js";
+import { CandidatePicker } from "../pipeline/CandidatePicker.js";
+import { ComponentTable } from "../pipeline/ComponentTable.js";
+import { buildParsePayload } from "../pipeline/copy.js";
+import { ResolvedPlace } from "../pipeline/ResolvedPlace.js";
+/** The composed result block for the geocoder demo. */
+export function ResultPanel({ result, selectedCandidate, selectedCandidateIndex, onSelectCandidate, extras, failure, }) {
+    return (_jsxs("div", { className: "mw-result", children: [_jsxs("div", { className: "mw-result__header", children: [_jsx("h2", { children: "Parsed components" }), _jsx(CopyButton, { value: () => buildParsePayload(result, selectedCandidate), label: "Copy JSON", copiedLabel: "\u2713 Copied" })] }), result.kindResult ? _jsx(KindBadge, { kindResult: result.kindResult }) : null, extras ? extras(result) : null, _jsx(ComponentTable, { nodes: result.nodes }), selectedCandidate ? (_jsxs(_Fragment, { children: [_jsx(ResolvedPlace, { place: selectedCandidate, dualRoles: result.dualRoles }), result.candidates.length > 1 ? (_jsx(CandidatePicker, { candidates: result.candidates, selectedIndex: selectedCandidateIndex, onSelect: onSelectCandidate })) : null] })) : failure ? (failure(result)) : null] }));
+}
+//# sourceMappingURL=ResultPanel.js.map

package/out/map/ResultPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultPanel.js","sourceRoot":"","sources":["../../map/ResultPanel.tsx"],"names":[],"mappings":";AAkBA,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,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA+B,CAAA;AAkB7D,uDAAuD;AACvD,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

@@ -0,0 +1,30 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `<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
+ *   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 "./types.ts";
+export interface VersionPickerProps {
+    /** The selectable model bundles. */
+    versions: ReadonlyArray<DemoVersionOption>;
+    /** The currently-selected version tag. */
+    selected: string | null;
+    /** Fired with the chosen version tag. */
+    onSelect: (version: string) => void;
+    /** Disable the control (e.g. while a parse is running). */
+    disabled?: boolean;
+    /** Field label. @default "Model version" */
+    label?: string;
+}
+/** The model-version selector. Renders `null` when there is nothing meaningful to pick. */
+export declare function VersionPicker({ versions, selected, onSelect, disabled, label, }: VersionPickerProps): ReactNode;
+//# sourceMappingURL=VersionPicker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VersionPicker.d.ts","sourceRoot":"","sources":["../../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,oCAAoC;IACpC,QAAQ,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAA;IAC1C,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,yCAAyC;IACzC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,EAC7B,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,KAAuB,GACvB,EAAE,kBAAkB,GAAG,SAAS,CAuBhC"}

package/out/map/VersionPicker.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** The model-version selector. Renders `null` when there is nothing meaningful to pick. */
+export function VersionPicker({ versions, selected, onSelect, disabled, label = "Model version", }) {
+    if (versions.length < 2)
+        return null;
+    return (_jsxs("div", { className: "mw-demo-control", children: [_jsx("label", { className: "mw-demo-control__label", htmlFor: "mw-demo-version", children: label }), _jsx("select", { id: "mw-demo-version", className: "mw-demo-control__select", value: selected ?? "", onChange: (e) => onSelect(e.target.value), disabled: disabled, children: versions.map((v) => (_jsx("option", { value: v.version, children: v.label ?? v.version }, v.version))) })] }));
+}
+//# sourceMappingURL=VersionPicker.js.map

package/out/map/VersionPicker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionPicker.js","sourceRoot":"","sources":["../../map/VersionPicker.tsx"],"names":[],"mappings":";AA+BA,2FAA2F;AAC3F,MAAM,UAAU,aAAa,CAAC,EAC7B,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,KAAK,GAAG,eAAe,GACH;IACpB,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IAEpC,OAAO,CACN,eAAK,SAAS,EAAC,iBAAiB,aAC/B,gBAAO,SAAS,EAAC,wBAAwB,EAAC,OAAO,EAAC,iBAAiB,YACjE,KAAK,GACC,EACR,iBACC,EAAE,EAAC,iBAAiB,EACpB,SAAS,EAAC,yBAAyB,EACnC,KAAK,EAAE,QAAQ,IAAI,EAAE,EACrB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EACzC,QAAQ,EAAE,QAAQ,YAEjB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CACpB,iBAAwB,KAAK,EAAE,CAAC,CAAC,OAAO,YACtC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,IADT,CAAC,CAAC,OAAO,CAEb,CACT,CAAC,GACM,IACJ,CACN,CAAA;AACF,CAAC"}