@mailwoman/react 9.3.0 → 9.4.0

package/lib/map/{DemoControls.tsx → GeocoderControls.tsx}

@@ -3,22 +3,21 @@
  * @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 { LoadingIndicator } from "../common/LoadingIndicator.tsx"
@@ -30,15 +29,15 @@ import { PlaceAutocomplete } from "./PlaceAutocomplete.tsx"
 import { ResultPanel } from "./ResultPanel.tsx"
 import { VersionPicker } from "./VersionPicker.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.
 	 */
@@ -50,7 +49,7 @@ export interface DemoControlsProps {
 	/**
 	 * Host-injected panels (about, release blurb, compare, permalink, extras, failure).
 	 */
-	panels: DemoPanels
+	panels: GeocoderPanels
 	/**
 	 * Example chips.
 	 */
@@ -60,7 +59,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
 	/**
@@ -72,7 +71,7 @@ export interface DemoControlsProps {
 /**
  * The floating control panel.
  */
-export function DemoControls({
+export function GeocoderControls({
 	runtime,
 	geocode,
 	autocomplete,
@@ -82,7 +81,7 @@ export function DemoControls({
 	placeholder,
 	onSelectVersion,
 	onForceWASMChange,
-}: DemoControlsProps): ReactNode {
+}: GeocoderControlsProps): ReactNode {
 	const versions = runtime.availableVersions ?? []
 	const { busy, result, selectedCandidate } = geocode
 	const loading = runtime.loading

package/lib/map/{DemoMap.tsx → MapCanvas.tsx}

@@ -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,10 +15,10 @@
  *   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"
@@ -26,23 +26,23 @@ import { Map } from "react-map-gl/maplibre"
 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<
+export type MapCanvasExtraProps = Partial<
 	Omit<MapProps, "mapStyle" | "initialViewState" | "viewState" | "onMove" | "children" | "style" | "ref">
 >
 
-export interface DemoMapProps {
+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.
 	 */
@@ -76,9 +76,9 @@ 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
 }
 
 const FILL: CSSProperties = { width: "100%", height: "100%" }
@@ -87,7 +87,7 @@ const FILL: CSSProperties = { 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({
+export function MapCanvas({
 	mapStyle,
 	initialViewState,
 	viewState,
@@ -98,7 +98,7 @@ export function DemoMap({
 	className,
 	style,
 	mapProps,
-}: DemoMapProps): ReactNode {
+}: MapCanvasProps): ReactNode {
 	const wrapperClassName = className ? `mw-demo-map ${className}` : "mw-demo-map"
 
 	return (

package/lib/map/PlaceMarker.tsx

@@ -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/lib/map/ResolvedPlaceLayers.tsx

@@ -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
@@ -28,7 +28,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/lib/map/ResultCamera.tsx

@@ -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/lib/map/ResultPanel.tsx

@@ -7,17 +7,17 @@
  *   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 { buildParsePayload } from "#pipeline/copy"
-import type { ParseResult, ResolvedPlaceView } from "#pipeline/types"
 
 import { CopyButton } from "../common/CopyButton.tsx"
 import { KindBadge } from "../common/KindBadge.tsx"

package/lib/map/VersionPicker.tsx

@@ -5,7 +5,7 @@
  *
  *   `<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
@@ -14,13 +14,13 @@
 
 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/lib/map/fake-runtime.ts

@@ -0,0 +1,122 @@
+/**
+ * @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 { ResolvedMapPlace } from "#map/place-render"
+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 const STUB_MAP_STYLE: MapCanvasStyle = {
+	version: 8,
+	name: "demo-runtime-stub",
+	sources: {},
+	layers: [{ id: "background", type: "background", paint: { "background-color": "#dfe7ee" } }],
+}
+
+/**
+ * Canned place-autocomplete suggestions — a synchronous fake for the FST prefix-walk.
+ */
+export const FAKE_SUGGESTIONS: Suggestion[] = [
+	{ value: "New York", placetype: "locality" },
+	{ value: "New Orleans", placetype: "locality" },
+	{ value: "Newark", placetype: "locality" },
+]
+
+/**
+ * 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 function makeFakeGeocoderRuntime(overrides: Partial<GeocoderRuntime> = {}): GeocoderRuntime {
+	const base = makePipelineRuntime()
+
+	return {
+		...base,
+		mapStyle: STUB_MAP_STYLE,
+		initialCenter: [-74.006, 40.7128],
+		initialZoom: 3,
+		overlays: [],
+		runParseWithBias: (input, _bias, hooks) => base.runParse(input, hooks),
+		autocomplete: async (query: string) =>
+			FAKE_SUGGESTIONS.filter((s) => s.value.toLowerCase().startsWith(query.toLowerCase())),
+		availableVersions: [
+			{ version: "v7.2.0", label: "v7.2.0 (latest)" },
+			{ version: "v7.1.0", label: "v7.1.0" },
+			{ version: "v6.4.0", label: "v6.4.0" },
+		],
+		selectedVersion: "v7.2.0",
+		selectVersion: () => {},
+		activeBackend: "webgpu (28 MB int8)",
+		forceWASM: false,
+		setForceWASM: () => {},
+		// Enrich the selected candidate with a bbox so an outline renders (case 4: bbox → approximate circle + fit).
+		resolveMapPlace: (candidate): ResolvedMapPlace => ({
+			...candidate,
+			bbox: {
+				minLat: candidate.lat - 0.15,
+				maxLat: candidate.lat + 0.15,
+				minLon: candidate.lon - 0.15,
+				maxLon: candidate.lon + 0.15,
+			},
+		}),
+		...overrides,
+	}
+}
+
+/**
+ * A fixed, fully-populated parse+resolve result — the shared fixture behind the pipeline runtime + the result panel.
+ */
+export function makeFakeParseResult(input = "350 5th Ave, New York, NY 10118"): ParseResult {
+	return {
+		input,
+		tree: { roots: [{ tag: "locality", value: "New York" }] },
+		nodes: [
+			{ tag: "house_number", value: "350", confidence: 0.97, start: 0, end: 3 },
+			{ tag: "street", value: "5th Ave", confidence: 0.88, start: 4, end: 11 },
+			{ tag: "locality", value: "New York", confidence: 0.71 },
+		],
+		kindResult: { kind: "structured_address", confidence: 0.95, alternatives: [] },
+		timing: { shape: 0.4, classify: 12.1, resolve: 4.2 },
+		resolved: { id: 85_977_539, name: "New York", placetype: "locality", lat: 40.7128, lon: -74.006, score: 0.82 },
+		candidates: [
+			{ id: 85_977_539, name: "New York", placetype: "locality", lat: 40.7128, lon: -74.006, score: 0.82 },
+			{ id: 101_715_829, name: "New York", placetype: "region", lat: 43, lon: -75, score: 0.55 },
+		],
+		fstActive: true,
+		fstProvenance: { builtAt: "2026-07-01T00:00:00Z", stateCount: 51, placeCount: 94_000, importanceMatches: 12_000 },
+	}
+}
+
+/**
+ * A fake parse+resolve runtime that returns a fixed, fully-populated result.
+ */
+export function makePipelineRuntime(overrides: Partial<PipelineRuntime> = {}): PipelineRuntime {
+	return {
+		ready: true,
+		parseStageLabels: ["Analyzing input shape…", "Running neural classifier…", "Resolving in gazetteer…"],
+		errorMessage: null,
+		loading: null,
+		runParse: async (input, { onStage }): Promise<ParseResult> => {
+			onStage(1)
+			onStage(2)
+
+			return makeFakeParseResult(input)
+		},
+		...overrides,
+	}
+}

package/lib/map/index.ts

@@ -3,7 +3,7 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `@mailwoman/react/map` — the geocoder-demo map surface, kept behind its OWN subpath so `maplibre-gl`
+ *   `@mailwoman/react/map` — the geocoder map surface, kept behind its OWN subpath so `maplibre-gl`
  *   / `react-map-gl` (WebGL + DOM at import) never enter the package-root graph. Importing this subpath
  *   pulls the map deps; importing `@mailwoman/react` (root) does not. Consumers who only want the
  *   parse/POI explorers never pay for maplibre.
@@ -12,20 +12,20 @@
  *   `maplibre-gl/dist/maplibre-gl.css` + `@mailwoman/react/styles.css` itself.
  */
 
-export { DemoMap } from "./DemoMap.tsx"
-export type { DemoMapExtraProps, DemoMapProps, DemoMapStyle } from "./DemoMap.tsx"
+export { MapCanvas } from "./MapCanvas.tsx"
+export type { MapCanvasExtraProps, MapCanvasProps, MapCanvasStyle } from "./MapCanvas.tsx"
 
 export type {
-	DemoBackend,
-	DemoCompareContext,
-	DemoPanels,
-	DemoResultContext,
-	DemoRuntime,
-	DemoVersionOption,
+	CompareContext,
+	GeocoderPanels,
+	GeocoderRuntime,
+	InferenceBackend,
 	LngLatTuple,
 	MapBias,
 	OverlaySpec,
+	ResultContext,
 	Suggestion,
+	VersionOption,
 } from "#map/types"
 
 // ── Pure geometry + render spec (node-safe; no react-map-gl at runtime) ──────
@@ -47,23 +47,23 @@ export type { ResultCameraProps } from "./ResultCamera.tsx"
 export { ResultOverlay } from "./ResultOverlay.tsx"
 export type { ResultOverlayProps } from "./ResultOverlay.tsx"
 
-// ── Demo controls + composed demo (phase 4) ─────────────────────────────────
+// ── Geocoder controls + the composed geocoder ────────────────────────────────
 export { BackendControl } from "./BackendControl.tsx"
 export type { BackendControlProps } from "./BackendControl.tsx"
 export { CompareToggle } from "./CompareToggle.tsx"
 export type { CompareToggleProps } from "./CompareToggle.tsx"
-export { DemoControls } from "./DemoControls.tsx"
-export type { DemoControlsProps } from "./DemoControls.tsx"
-export { GeocoderDemo } from "./GeocoderDemo.tsx"
-export type { GeocoderDemoProps } from "./GeocoderDemo.tsx"
+export { Geocoder } from "./Geocoder.tsx"
+export type { GeocoderProps } from "./Geocoder.tsx"
+export { GeocoderControls } from "./GeocoderControls.tsx"
+export type { GeocoderControlsProps } from "./GeocoderControls.tsx"
 export { PlaceAutocomplete } from "./PlaceAutocomplete.tsx"
 export type { PlaceAutocompleteProps } from "./PlaceAutocomplete.tsx"
 export { ResultPanel } from "./ResultPanel.tsx"
 export type { ResultPanelProps } from "./ResultPanel.tsx"
 export { useCompareState } from "#map/useCompareState"
 export type { UseCompareState } from "#map/useCompareState"
-export { useDemoGeocode } from "#map/useDemoGeocode"
-export type { UseDemoGeocode, UseDemoGeocodeOptions } from "#map/useDemoGeocode"
+export { useGeocode } from "#map/useGeocode"
+export type { UseGeocode, UseGeocodeOptions } from "#map/useGeocode"
 export { usePlaceAutocomplete } from "#map/usePlaceAutocomplete"
 
 export type {

package/lib/map/map-debug.ts

@@ -0,0 +1,51 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file The bare MapLibre control both debug panels portal into.
+ *
+ *   `DashboardMap`'s inspector and the demo page's `_debug.tsx` panel each need an `IControl` whose
+ *   only job is to own a container element for `createPortal`. The class was duplicated in both;
+ *   the position and container class are the only differences, so they are parameters here.
+ */
+
+import type { ControlPosition } from "maplibre-gl"
+import type { IControl, MapInstance } from "react-map-gl/maplibre"
+
+export interface DebugControlBaseOptions {
+	/**
+	 * Class applied to the portal container.
+	 */
+	className?: string
+	/**
+	 * Where MapLibre docks the control. @default "bottom-left"
+	 */
+	position?: ControlPosition
+}
+
+export class DebugControlBase implements IControl {
+	public readonly container: HTMLElement
+	readonly #position: ControlPosition
+
+	constructor({ className, position = "bottom-left" }: DebugControlBaseOptions = {}) {
+		this.container = document.createElement("div")
+
+		if (className) {
+			this.container.classList.add(className)
+		}
+
+		this.#position = position
+	}
+
+	public onAdd(_map: MapInstance): HTMLElement {
+		return this.container
+	}
+
+	public onRemove(_map: MapInstance): void {
+		this.container.remove()
+	}
+
+	public getDefaultPosition(): ControlPosition {
+		return this.#position
+	}
+}

package/lib/map/place-render.ts

@@ -19,9 +19,10 @@
  *     5. bare point                       → no outline, fly to zoom 12
  */
 
+import type { ResolvedPlaceView } from "@mailwoman/core/pipeline/client-result"
+
 import { approxCircleGeometry, bboxToBounds, geomBounds, radiusCircleGeometry } from "#map/geometry"
 import type { BoundsTuple, PlaceBBox, PlaceGeometry } from "#map/geometry"
-import type { ResolvedPlaceView } from "#pipeline/types"
 
 /**
  * `[longitude, latitude]`.
@@ -167,7 +168,7 @@ export function computeMapPlaceRenderSpec(place: ResolvedMapPlace): MapPlaceRend
 }
 
 /**
- * The DECLARATIVE camera path: reshape a `center` target into a `viewState` patch a controlled `<DemoMap viewState>`
+ * The DECLARATIVE camera path: reshape a `center` target into a `viewState` patch a controlled `<MapCanvas viewState>`
  * can apply directly (a hard jump, no animation). Returns `null` for a `bounds` target — fitting a box to the viewport
  * needs the map's pixel dimensions, which only the live map has, so that case is applied imperatively by
  * `<ResultCamera>`. Pure + node-testable.