@mailwoman/react 8.1.0 → 8.2.0

package/map/ResultOverlay.tsx

@@ -18,19 +18,31 @@ import { Layer, Source } from "react-map-gl/maplibre"
 
 import type { PlaceGeometry } from "./geometry.ts"
 
-/** The house pink, matched to {@link PlaceMarker}. */
+/**
+ * The house pink, matched to {@link PlaceMarker}.
+ */
 const OUTLINE_COLOR = "#e0367c"
 
 export interface ResultOverlayProps {
-	/** The outline geometry to draw, or `null` to draw nothing (the bare-point result). */
+	/**
+	 * 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" */
+	/**
+	 * 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. */
+	/**
+	 * Fill color. @default the house pink.
+	 */
 	color?: string
-	/** Fill opacity. @default 0.12 */
+	/**
+	 * Fill opacity. @default 0.12
+	 */
 	fillOpacity?: number
-	/** Outline stroke width (px). @default 2 */
+	/**
+	 * Outline stroke width (px). @default 2
+	 */
 	lineWidth?: number
 }
 

package/map/ResultPanel.tsx

@@ -25,21 +25,35 @@ import { ResolvedPlace } from "../pipeline/ResolvedPlace.tsx"
 import type { ParseResult, ResolvedPlaceView } from "../pipeline/types.ts"
 
 export interface ResultPanelProps {
-	/** The parse+resolve result to render. */
+	/**
+	 * The parse+resolve result to render.
+	 */
 	result: ParseResult
-	/** The selected candidate (falls back to the first), used for the resolved-place detail + copy payload. */
+	/**
+	 * 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. */
+	/**
+	 * The selected candidate index, for the picker's active state.
+	 */
 	selectedCandidateIndex: number
-	/** Fired when a candidate in the picker is chosen. */
+	/**
+	 * 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. */
+	/**
+	 * 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. */
+	/**
+	 * Host-injected no-resolve diagnostic, rendered when nothing resolved.
+	 */
 	failure?: (result: ParseResult) => ReactNode
 }
 
-/** The composed result block for the geocoder demo. */
+/**
+ * The composed result block for the geocoder demo.
+ */
 export function ResultPanel({
 	result,
 	selectedCandidate,

package/map/VersionPicker.tsx

@@ -17,19 +17,31 @@ import type { ReactNode } from "react"
 import type { DemoVersionOption } from "./types.ts"
 
 export interface VersionPickerProps {
-	/** The selectable model bundles. */
+	/**
+	 * The selectable model bundles.
+	 */
 	versions: ReadonlyArray<DemoVersionOption>
-	/** The currently-selected version tag. */
+	/**
+	 * The currently-selected version tag.
+	 */
 	selected: string | null
-	/** Fired with the chosen version tag. */
+	/**
+	 * Fired with the chosen version tag.
+	 */
 	onSelect: (version: string) => void
-	/** Disable the control (e.g. while a parse is running). */
+	/**
+	 * Disable the control (e.g. while a parse is running).
+	 */
 	disabled?: boolean
-	/** Field label. @default "Model version" */
+	/**
+	 * Field label. @default "Model version"
+	 */
 	label?: string
 }
 
-/** The model-version selector. Renders `null` when there is nothing meaningful to pick. */
+/**
+ * The model-version selector. Renders `null` when there is nothing meaningful to pick.
+ */
 export function VersionPicker({
 	versions,
 	selected,

package/map/geometry.ts

@@ -16,15 +16,26 @@
  *   preserve it so the ported behavior is byte-identical and the browser graph stays clean.
  */
 
-/** Mean km per degree of latitude (WGS84 average). */
+/**
+ * Segments used to approximate a circle as a polygon ring.
+ */
+const CIRCLE_SEGMENTS = 64
+
+/**
+ * Mean km per degree of latitude (WGS84 average).
+ */
 const KM_PER_DEG_LAT = 111.32
 
-/** A GeoJSON Polygon / MultiPolygon — what the polygon DB stores and the map draws as the place outline. */
+/**
+ * A GeoJSON Polygon / MultiPolygon — what the polygon DB stores and the map draws as the place outline.
+ */
 export type PlaceGeometry =
 	| { type: "Polygon"; coordinates: number[][][] }
 	| { type: "MultiPolygon"; coordinates: number[][][][] }
 
-/** A place bounding box in the demo's object form (the WOF points DB carries only these four numbers). */
+/**
+ * A place bounding box in the demo's object form (the WOF points DB carries only these four numbers).
+ */
 export interface PlaceBBox {
 	minLat: number
 	maxLat: number
@@ -32,20 +43,26 @@ export interface PlaceBBox {
 	maxLon: number
 }
 
-/** A `[west, south, east, north]` → `[[minLon, minLat], [maxLon, maxLat]]` pair, the shape `fitBounds` wants. */
+/**
+ * A `[west, south, east, north]` → `[[minLon, minLat], [maxLon, maxLat]]` pair, the shape `fitBounds` wants.
+ */
 export type BoundsTuple = [[number, number], [number, number]]
 
-/** Km per degree of longitude at a given latitude — the meridians converge toward the poles. */
+/**
+ * Km per degree of longitude at a given latitude — the meridians converge toward the poles.
+ */
 function kmPerDegLon(lat: number): number {
 	return KM_PER_DEG_LAT * Math.cos((lat * Math.PI) / 180)
 }
 
-/** A closed 64-segment (65-point) GeoJSON ring of `radiusKm` around `[lon, lat]`, with latitude correction. */
+/**
+ * A closed 64-segment (65-point) GeoJSON ring of `radiusKm` around `[lon, lat]`, with latitude correction.
+ */
 function circleRing(lat: number, lon: number, radiusKm: number): number[][] {
 	const perLon = kmPerDegLon(lat)
 	const ring: number[][] = []
 
-	for (let i = 0; i <= 64; i++) {
+	for (let i = 0; i <= CIRCLE_SEGMENTS; i++) {
 		const theta = (2 * Math.PI * i) / 64
 
 		ring.push([lon + (radiusKm * Math.cos(theta)) / perLon, lat + (radiusKm * Math.sin(theta)) / KM_PER_DEG_LAT])
@@ -63,6 +80,7 @@ export function approxCircleGeometry(lat: number, lon: number, bbox?: PlaceBBox)
 	const halfDiagKm = bbox
 		? Math.hypot((bbox.maxLat - bbox.minLat) * KM_PER_DEG_LAT, (bbox.maxLon - bbox.minLon) * kmPerDegLon(lat)) / 2
 		: 3
+
 	const radiusKm = Math.min(50, Math.max(0.5, halfDiagKm))
 
 	return { type: "Polygon", coordinates: [circleRing(lat, lon, radiusKm)] }
@@ -126,7 +144,9 @@ export function geomBounds(geometry: PlaceGeometry): PlaceBBox {
 	return { minLon, minLat, maxLon, maxLat }
 }
 
-/** Reshape a {@link PlaceBBox} into the `[[minLon, minLat], [maxLon, maxLat]]` pair `fitBounds` expects. */
+/**
+ * Reshape a {@link PlaceBBox} into the `[[minLon, minLat], [maxLon, maxLat]]` pair `fitBounds` expects.
+ */
 export function bboxToBounds(bbox: PlaceBBox): BoundsTuple {
 	return [
 		[bbox.minLon, bbox.minLat],

package/map/index.ts

@@ -14,6 +14,7 @@
 
 export { DemoMap } from "./DemoMap.tsx"
 export type { DemoMapExtraProps, DemoMapProps, DemoMapStyle } from "./DemoMap.tsx"
+
 export type {
 	DemoBackend,
 	DemoCompareContext,
@@ -64,10 +65,12 @@ export type { UseCompareState } from "./useCompareState.ts"
 export { useDemoGeocode } from "./useDemoGeocode.ts"
 export type { UseDemoGeocode, UseDemoGeocodeOptions } from "./useDemoGeocode.ts"
 export { usePlaceAutocomplete } from "./usePlaceAutocomplete.ts"
+
 export type {
 	AutocompleteInputProps,
 	UsePlaceAutocomplete,
 	UsePlaceAutocompleteOptions,
 } from "./usePlaceAutocomplete.ts"
+
 export { VersionPicker } from "./VersionPicker.tsx"
 export type { VersionPickerProps } from "./VersionPicker.tsx"

package/map/place-render.ts

@@ -23,10 +23,14 @@ import type { ResolvedPlaceView } from "../pipeline/types.ts"
 import { approxCircleGeometry, bboxToBounds, geomBounds, radiusCircleGeometry } from "./geometry.ts"
 import type { BoundsTuple, PlaceBBox, PlaceGeometry } from "./geometry.ts"
 
-/** `[longitude, latitude]`. */
+/**
+ * `[longitude, latitude]`.
+ */
 export type LngLat = [number, number]
 
-/** The street-level resolution tier (#377): `address_point` = exact building; `interpolated` = TIGER estimate. */
+/**
+ * The street-level resolution tier (#377): `address_point` = exact building; `interpolated` = TIGER estimate.
+ */
 export type PlaceTier = "address_point" | "interpolated"
 
 /**
@@ -35,11 +39,17 @@ export type PlaceTier = "address_point" | "interpolated"
  * `ResolvedPlaceView` keeps the map render aligned with the shared parse result; the extras are additive.
  */
 export interface ResolvedMapPlace extends ResolvedPlaceView {
-	/** The place's bounding box, when the gazetteer carries one (admin places). Absent for anchor-centroid postcodes. */
+	/**
+	 * The place's bounding box, when the gazetteer carries one (admin places). Absent for anchor-centroid postcodes.
+	 */
 	bbox?: PlaceBBox
-	/** Street-level tier, when this hit came from the situs/interp tier rather than the WOF admin cascade. */
+	/**
+	 * Street-level tier, when this hit came from the situs/interp tier rather than the WOF admin cascade.
+	 */
 	tier?: PlaceTier
-	/** Honest uncertainty radius in meters for a street-level tier (10 m situs floor; calibrated interp). */
+	/**
+	 * Honest uncertainty radius in meters for a street-level tier (10 m situs floor; calibrated interp).
+	 */
 	uncertaintyM?: number
 	/**
 	 * The crisp admin polygon, when the host has ALREADY fetched it from the sibling polygon DB. Its presence drives the
@@ -57,17 +67,27 @@ export type MapCameraTarget =
 	| { kind: "center"; center: LngLat; zoom: number }
 	| { kind: "bounds"; bounds: BoundsTuple; padding: number }
 
-/** The declarative render spec for one resolved place — the pure output of {@link computeMapPlaceRenderSpec}. */
+/**
+ * The declarative render spec for one resolved place — the pure output of {@link computeMapPlaceRenderSpec}.
+ */
 export interface MapPlaceRenderSpec {
-	/** Marker position(s) as `[lon, lat]`. Single-element today; an array leaves room for multi-marker later. */
+	/**
+	 * Marker position(s) as `[lon, lat]`. Single-element today; an array leaves room for multi-marker later.
+	 */
 	markers: LngLat[]
-	/** The outline geometry (polygon / circle) to draw, or `null` when the place renders as a bare point. */
+	/**
+	 * The outline geometry (polygon / circle) to draw, or `null` when the place renders as a bare point.
+	 */
 	outline: PlaceGeometry | null
-	/** The camera target — animate or fit to this. */
+	/**
+	 * The camera target — animate or fit to this.
+	 */
 	camera: MapCameraTarget
 }
 
-/** Zoom levels the imperative effect flew to, kept named so the cascade reads as intent, not magic numbers. */
+/**
+ * Zoom levels the imperative effect flew to, kept named so the cascade reads as intent, not magic numbers.
+ */
 const ZOOM = {
 	addressPoint: 17,
 	interpolated: 15,
@@ -75,10 +95,14 @@ const ZOOM = {
 	point: 12,
 } as const
 
-/** Padding (px) `fitBounds` insets a fitted box by, matching the ported effect. */
+/**
+ * Padding (px) `fitBounds` insets a fitted box by, matching the ported effect.
+ */
 const FIT_PADDING = 40
 
-/** The minimum lat/lon span (degrees) a bbox must exceed to be treated as a real extent rather than a point. */
+/**
+ * The minimum lat/lon span (degrees) a bbox must exceed to be treated as a real extent rather than a point.
+ */
 const MIN_EXTENT_DEG = 0.001
 
 /**

package/map/types.ts

@@ -22,14 +22,22 @@ import type { ParseResult, PipelineRuntime, ResolvedPlaceView } from "../pipelin
 import type { DemoMapStyle } from "./DemoMap.tsx"
 import type { ResolvedMapPlace } from "./place-render.ts"
 
-/** `[longitude, latitude]`. */
+/**
+ * `[longitude, latitude]`.
+ */
 export type LngLatTuple = [number, number]
 
-/** A viewport bias handed to `runParse` — the map's current center (and optionally zoom) as a soft prior. */
+/**
+ * A viewport bias handed to `runParse` — the map's current center (and optionally zoom) as a soft prior.
+ */
 export interface MapBias {
-	/** Map center as `[lon, lat]`, typically read from `map.getCenter()`. */
+	/**
+	 * Map center as `[lon, lat]`, typically read from `map.getCenter()`.
+	 */
 	center: LngLatTuple
-	/** Current zoom, if the host wants distance-aware biasing. */
+	/**
+	 * Current zoom, if the host wants distance-aware biasing.
+	 */
 	zoom?: number
 }
 
@@ -38,37 +46,63 @@ export interface MapBias {
  * race-dots, …). The host composes the specs; the package renders them declaratively in a later phase.
  */
 export interface OverlaySpec {
-	/** Stable id — used as the `<Source>` id and the layer-id prefix. */
+	/**
+	 * Stable id — used as the `<Source>` id and the layer-id prefix.
+	 */
 	id: string
-	/** The map source spec (vector/geojson/raster). */
+	/**
+	 * The map source spec (vector/geojson/raster).
+	 */
 	source: SourceSpecification
-	/** The layers drawn from that source. */
+	/**
+	 * The layers drawn from that source.
+	 */
 	layers: LayerSpecification[]
-	/** Whether the overlay is visible initially. @default true */
+	/**
+	 * Whether the overlay is visible initially. @default true
+	 */
 	visible?: boolean
-	/** Human label for a layer-toggle control. */
+	/**
+	 * Human label for a layer-toggle control.
+	 */
 	label?: string
 }
 
-/** One autocomplete suggestion produced by the host's FST prefix-walk. */
+/**
+ * One autocomplete suggestion produced by the host's FST prefix-walk.
+ */
 export interface Suggestion {
-	/** The text inserted when the suggestion is picked. */
+	/**
+	 * The text inserted when the suggestion is picked.
+	 */
 	value: string
-	/** Optional display label if it differs from `value`. */
+	/**
+	 * Optional display label if it differs from `value`.
+	 */
 	label?: string
-	/** Optional place kind for badge/icon rendering. */
+	/**
+	 * Optional place kind for badge/icon rendering.
+	 */
 	placetype?: string
 }
 
-/** A selectable model bundle (version tag + a display label the picker shows). */
+/**
+ * A selectable model bundle (version tag + a display label the picker shows).
+ */
 export interface DemoVersionOption {
-	/** The version tag (e.g. a git tag or model-card version). */
+	/**
+	 * The version tag (e.g. a git tag or model-card version).
+	 */
 	version: string
-	/** Display label; falls back to `version`. */
+	/**
+	 * Display label; falls back to `version`.
+	 */
 	label?: string
 }
 
-/** Which neural backend the demo is currently running on. */
+/**
+ * Which neural backend the demo is currently running on.
+ */
 export type DemoBackend = "webgpu" | "wasm"
 
 /**
@@ -80,13 +114,21 @@ export type DemoBackend = "webgpu" | "wasm"
  */
 export interface DemoRuntime extends PipelineRuntime {
 	// ── Map ────────────────────────────────────────────────────────────────
-	/** The composed basemap style (URL or `StyleSpecification`). */
+	/**
+	 * The composed basemap style (URL or `StyleSpecification`).
+	 */
 	mapStyle: DemoMapStyle
-	/** Host-supplied overlays (coverage, race-dots, …). */
+	/**
+	 * Host-supplied overlays (coverage, race-dots, …).
+	 */
 	overlays?: OverlaySpec[]
-	/** Initial map center as `[lon, lat]` (the host's browser-geolocation result). */
+	/**
+	 * Initial map center as `[lon, lat]` (the host's browser-geolocation result).
+	 */
 	initialCenter: LngLatTuple
-	/** Initial zoom for the first camera. */
+	/**
+	 * Initial zoom for the first camera.
+	 */
 	initialZoom?: number
 
 	// ── Parse extras layered over PipelineRuntime.runParse ──────────────────
@@ -99,9 +141,13 @@ export interface DemoRuntime extends PipelineRuntime {
 		bias: MapBias | null,
 		hooks: { onStage: (stage: number) => void }
 	) => ReturnType<PipelineRuntime["runParse"]>
-	/** FST prefix-walk autocomplete, wrapped by the host. */
+	/**
+	 * FST prefix-walk autocomplete, wrapped by the host.
+	 */
 	autocomplete?: (query: string) => Promise<Suggestion[]>
-	/** Maps a raw model score to a calibrated one; `null` when no calibration table is loaded. */
+	/**
+	 * Maps a raw model score to a calibrated one; `null` when no calibration table is loaded.
+	 */
 	calibrator?: (raw: number) => number | null
 	/**
 	 * Enrich the selected candidate into the richer {@link ResolvedMapPlace} the declarative map render consumes (bbox,
@@ -113,27 +159,47 @@ export interface DemoRuntime extends PipelineRuntime {
 	resolveMapPlace?: (candidate: ResolvedPlaceView, result: ParseResult) => ResolvedMapPlace | null
 
 	// ── Version + backend selection ─────────────────────────────────────────
-	/** The selectable model bundles the version picker offers. */
+	/**
+	 * The selectable model bundles the version picker offers.
+	 */
 	availableVersions?: DemoVersionOption[]
-	/** The currently-selected model version. */
+	/**
+	 * The currently-selected model version.
+	 */
 	selectedVersion?: string
-	/** Switch the active model bundle (re-loads weights/tokenizer/gazetteer). */
+	/**
+	 * Switch the active model bundle (re-loads weights/tokenizer/gazetteer).
+	 */
 	selectVersion?: (version: string) => void
-	/** The backend the neural runtime resolved to (e.g. `webgpu (28 MB int8)`); free-form for the label. */
+	/**
+	 * The backend the neural runtime resolved to (e.g. `webgpu (28 MB int8)`); free-form for the label.
+	 */
 	activeBackend?: string
-	/** Whether the CPU/WASM backend is currently forced (the controlled value for the backend toggle). */
+	/**
+	 * Whether the CPU/WASM backend is currently forced (the controlled value for the backend toggle).
+	 */
 	forceWASM?: boolean
-	/** Force the WASM backend (opt out of WebGPU), for the backend toggle. */
+	/**
+	 * Force the WASM backend (opt out of WebGPU), for the backend toggle.
+	 */
 	setForceWASM?: (forceWASM: boolean) => void
 }
 
-/** The compare-mode state a {@link DemoPanels.compare} render-prop receives (the second parse itself stays host-side). */
+/**
+ * The compare-mode state a {@link DemoPanels.compare} render-prop receives (the second parse itself stays host-side).
+ */
 export interface DemoCompareContext {
-	/** The current primary parse result, or `null` before the first submit. */
+	/**
+	 * The current primary parse result, or `null` before the first submit.
+	 */
 	result: ParseResult | null
-	/** Whether the compare toggle is on. */
+	/**
+	 * Whether the compare toggle is on.
+	 */
 	compareMode: boolean
-	/** The version selected to compare against, or `null` when none is chosen. */
+	/**
+	 * The version selected to compare against, or `null` when none is chosen.
+	 */
 	compareVersion: string | null
 }
 
@@ -144,13 +210,21 @@ export interface DemoCompareContext {
  * by the package (`useDemoGeocode`).
  */
 export interface DemoResultContext {
-	/** The current parse+resolve result. */
+	/**
+	 * The current parse+resolve result.
+	 */
 	result: ParseResult
-	/** The selected candidate (falls back to the first), enriched for the resolved-place detail. */
+	/**
+	 * The selected candidate (falls back to the first), enriched for the resolved-place detail.
+	 */
 	selectedCandidate: ResolvedPlaceView | null
-	/** The selected candidate index, for the picker's active state. */
+	/**
+	 * The selected candidate index, for the picker's active state.
+	 */
 	selectedCandidateIndex: number
-	/** Fired when a candidate in the picker is chosen. */
+	/**
+	 * Fired when a candidate in the picker is chosen.
+	 */
 	onSelectCandidate: (index: number) => void
 }
 
@@ -161,11 +235,17 @@ export interface DemoResultContext {
  * fake-runtime Storybook stories pass none and still render the whole demo.
  */
 export interface DemoPanels {
-	/** Rendered at the top of the control panel (e.g. the docs "About this demo"). */
+	/**
+	 * Rendered at the top of the control panel (e.g. the docs "About this demo").
+	 */
 	header?: ReactNode
-	/** One-line release blurb for the selected version. */
+	/**
+	 * One-line release blurb for the selected version.
+	 */
 	releaseInfo?: ReactNode
-	/** Rendered at the bottom of the control panel (e.g. a guided tour). */
+	/**
+	 * Rendered at the bottom of the control panel (e.g. a guided tour).
+	 */
 	footer?: ReactNode
 	/**
 	 * A device-location / proximity-bias control, rendered between the query form and the autocomplete list (the demo's
@@ -173,7 +253,9 @@ export interface DemoPanels {
 	 * {@link DemoRuntime.runParseWithBias} stay a host concern.
 	 */
 	bias?: ReactNode
-	/** Heavy visualizers (span highlight, tree, timing, BIO, …), rendered from the result. */
+	/**
+	 * Heavy visualizers (span highlight, tree, timing, BIO, …), rendered from the result.
+	 */
 	extras?: (result: ParseResult) => ReactNode
 	/**
 	 * Rendered just above the result block (present or empty). The demo's opt-in display toggles live here — calibrated
@@ -192,7 +274,9 @@ export interface DemoPanels {
 	 * {@link result} is set.
 	 */
 	failure?: (result: ParseResult) => ReactNode
-	/** The version-compare view — the host renders its own diff from the compare state it owns. */
+	/**
+	 * The version-compare view — the host renders its own diff from the compare state it owns.
+	 */
 	compare?: (context: DemoCompareContext) => ReactNode
 	/**
 	 * The model-visualizer / debug drawer, mounted beside the map (host's ModelVisualizer). A render-prop so the host can
@@ -200,8 +284,12 @@ export interface DemoPanels {
 	 * state and returns `null` when the drawer is closed.
 	 */
 	debugDrawer?: (context: { result: ParseResult | null }) => ReactNode
-	/** Extra map controls mounted as `<DemoMap>` children (host's DebugControl / LayerToggle via `useControl`). */
+	/**
+	 * Extra map controls mounted as `<DemoMap>` children (host's DebugControl / LayerToggle via `useControl`).
+	 */
 	mapControls?: ReactNode
-	/** A permalink control for the current address (host's PermalinkButton). */
+	/**
+	 * A permalink control for the current address (host's PermalinkButton).
+	 */
 	permalink?: (text: string) => ReactNode
 }

package/map/useCompareState.ts

@@ -13,15 +13,25 @@
 import { useCallback, useState } from "react"
 
 export interface UseCompareState {
-	/** Whether compare mode is on. */
+	/**
+	 * Whether compare mode is on.
+	 */
 	compareMode: boolean
-	/** The version chosen to compare against, or `null`. */
+	/**
+	 * The version chosen to compare against, or `null`.
+	 */
 	compareVersion: string | null
-	/** Flip compare mode; turning it off clears the chosen version. */
+	/**
+	 * Flip compare mode; turning it off clears the chosen version.
+	 */
 	setCompareMode: (compareMode: boolean) => void
-	/** Choose a compare version (`null` clears it). */
+	/**
+	 * Choose a compare version (`null` clears it).
+	 */
 	setCompareVersion: (version: string | null) => void
-	/** Keep the compare selection distinct from the primary — call when the primary version changes. */
+	/**
+	 * Keep the compare selection distinct from the primary — call when the primary version changes.
+	 */
 	clearIfPrimary: (primaryVersion: string) => void
 }
 

package/map/useDemoGeocode.ts

@@ -26,16 +26,24 @@ import type { ResolvedMapPlace } from "./place-render.ts"
 import type { DemoRuntime, MapBias } from "./types.ts"
 
 export interface UseDemoGeocodeOptions {
-	/** The injected demo runtime (extends `PipelineRuntime` with the map + bias surface). */
+	/**
+	 * The injected demo runtime (extends `PipelineRuntime` with the map + bias surface).
+	 */
 	runtime: DemoRuntime
-	/** Address to pre-fill. */
+	/**
+	 * Address to pre-fill.
+	 */
 	defaultText: string
-	/** Read the current viewport bias (the map center) at submit time. Absent → no bias. */
+	/**
+	 * Read the current viewport bias (the map center) at submit time. Absent → no bias.
+	 */
 	getBias?: () => MapBias | null
 }
 
 export interface UseDemoGeocode extends UseParsePipeline {
-	/** The selected candidate enriched into the map-render shape (bbox / tier / polygon), or `null`. */
+	/**
+	 * The selected candidate enriched into the map-render shape (bbox / tier / polygon), or `null`.
+	 */
 	mapPlace: ResolvedMapPlace | null
 }
 

package/map/useMapPlaceRender.ts

@@ -15,7 +15,9 @@ import { useMemo } from "react"
 import { computeMapPlaceRenderSpec } from "./place-render.ts"
 import type { MapPlaceRenderSpec, ResolvedMapPlace } from "./place-render.ts"
 
-/** Memoize the render spec for a resolved place; `null` in → `null` out (nothing to draw). */
+/**
+ * Memoize the render spec for a resolved place; `null` in → `null` out (nothing to draw).
+ */
 export function useMapPlaceRender(place: ResolvedMapPlace | null | undefined): MapPlaceRenderSpec | null {
 	return useMemo(() => (place ? computeMapPlaceRenderSpec(place) : null), [place])
 }