@mailwoman/react 8.0.0 → 8.2.0

package/common/ClientOnly.tsx

@@ -15,9 +15,13 @@
 import { type ReactNode, useEffect, useState } from "react"
 
 export interface ClientOnlyProps {
-	/** Rendered once mounted in the browser. A thunk so its (browser-only) imports never run on the server. */
+	/**
+	 * Rendered once mounted in the browser. A thunk so its (browser-only) imports never run on the server.
+	 */
 	children: () => ReactNode
-	/** Rendered on the server and until the first client mount. */
+	/**
+	 * Rendered on the server and until the first client mount.
+	 */
 	fallback?: ReactNode
 }
 

package/common/CopyButton.tsx

@@ -12,11 +12,17 @@ import type { ReactNode } from "react"
 import { useClipboard } from "./useClipboard.ts"
 
 export interface CopyButtonProps {
-	/** The text to copy. If a thunk, it's evaluated at click time (so callers can copy the latest value). */
+	/**
+	 * The text to copy. If a thunk, it's evaluated at click time (so callers can copy the latest value).
+	 */
 	value: string | (() => string)
-	/** Label in the idle state. @default "Copy" */
+	/**
+	 * Label in the idle state. @default "Copy"
+	 */
 	label?: ReactNode
-	/** Label shown briefly after a successful copy. @default "✓ Copied" */
+	/**
+	 * Label shown briefly after a successful copy. @default "✓ Copied"
+	 */
 	copiedLabel?: ReactNode
 	className?: string
 	disabled?: boolean

package/common/KindBadge.tsx

@@ -30,7 +30,7 @@ export function KindBadge({ kindResult }: KindBadgeProps): ReactNode {
 				<strong>Kind:</strong> <code>{kindResult.kind}</code>{" "}
 				<span className="mw-kind__confidence">({formatPct(kindResult.confidence)})</span>
 			</summary>
-			{kindResult.alternatives.length > 0 ? (
+			{kindResult.alternatives.length ? (
 				<ul className="mw-kind__alternatives">
 					{kindResult.alternatives.map((alt) => (
 						<li key={alt.kind}>

package/common/LoadingIndicator.tsx

@@ -16,17 +16,29 @@ import { cx } from "./cx.ts"
 export type LoadingMode = "pulse" | "spinner" | "staged"
 
 export interface LoadingIndicatorProps extends React.HTMLAttributes<HTMLDivElement> {
-	/** @default "spinner" */
+	/**
+	 * @default "spinner"
+	 */
 	mode?: LoadingMode
-	/** Optional label; in staged mode it renders above the step list. */
+	/**
+	 * Optional label; in staged mode it renders above the step list.
+	 */
 	label?: string
-	/** Number of skeleton bars (pulse mode). @default 3 */
+	/**
+	 * Number of skeleton bars (pulse mode). @default 3
+	 */
 	barCount?: number
-	/** Spinner ring size. @default "medium" */
+	/**
+	 * Spinner ring size. @default "medium"
+	 */
 	size?: "small" | "medium" | "large"
-	/** Step labels (staged mode) — one row each. */
+	/**
+	 * Step labels (staged mode) — one row each.
+	 */
 	steps?: string[]
-	/** 0-based index of the active step; earlier steps are complete, later ones pending. @default -1 */
+	/**
+	 * 0-based index of the active step; earlier steps are complete, later ones pending. @default -1
+	 */
 	activeStep?: number
 }
 
@@ -36,6 +48,9 @@ const SIZE_CLASS: Record<NonNullable<LoadingIndicatorProps["size"]>, string> = {
 	large: "mw-spinner--large",
 }
 
+/**
+ * Spinner, pulse or staged progress, depending on how long the caller expects to wait.
+ */
 export const LoadingIndicator = memo<LoadingIndicatorProps>(function LoadingIndicator({
 	mode = "spinner",
 	label,
@@ -71,7 +86,7 @@ const SpinnerRing = memo<{ size: NonNullable<LoadingIndicatorProps["size"]> }>(f
 })
 
 const StagedProgress = memo<{ steps?: string[]; activeStep: number }>(function StagedProgress({ steps, activeStep }) {
-	if (!steps || steps.length === 0) return null
+	if (!steps || !steps.length) return null
 
 	return (
 		<ul className="mw-staged">

package/common/PresetChips.tsx

@@ -25,9 +25,13 @@ export interface PresetChipsProps {
 	presets: ReadonlyArray<Preset>
 	onPick: (value: string) => void
 	disabled?: boolean
-	/** Leading label. @default "Try:" */
+	/**
+	 * Leading label. @default "Try:"
+	 */
 	caption?: string
-	/** Optional trailing content rendered inside the chip row after the presets (e.g. an inline permalink button). */
+	/**
+	 * Optional trailing content rendered inside the chip row after the presets (e.g. an inline permalink button).
+	 */
 	trailing?: ReactNode
 }
 

package/common/cx.ts

@@ -10,7 +10,9 @@
 
 export type ClassValue = string | number | false | null | undefined | Record<string, boolean>
 
-/** Join truthy class tokens; object entries contribute their key when the value is truthy. */
+/**
+ * Join truthy class tokens; object entries contribute their key when the value is truthy.
+ */
 export function cx(...values: ClassValue[]): string {
 	const out: string[] = []
 

package/common/useClipboard.ts

@@ -10,7 +10,9 @@
 
 import { useCallback, useEffect, useRef, useState } from "react"
 
-/** Best-effort clipboard write: async Clipboard API first, hidden-textarea `execCommand` fallback. */
+/**
+ * Best-effort clipboard write: async Clipboard API first, hidden-textarea `execCommand` fallback.
+ */
 async function writeToClipboard(value: string): Promise<void> {
 	try {
 		await navigator.clipboard.writeText(value)
@@ -41,7 +43,9 @@ export interface UseClipboard {
 	copy: (value: string) => Promise<void>
 }
 
-/** @param resetMs - How long the `copied` flag stays true after a successful copy. */
+/**
+ * @param resetMs - How long the `copied` flag stays true after a successful copy.
+ */
 export function useClipboard(resetMs = 1500): UseClipboard {
 	const [copied, setCopied] = useState(false)
 	const timer = useRef<ReturnType<typeof setTimeout> | null>(null)
@@ -64,6 +68,7 @@ export function useClipboard(resetMs = 1500): UseClipboard {
 			if (timer.current) {
 				clearTimeout(timer.current)
 			}
+
 			timer.current = setTimeout(() => setCopied(false), resetMs)
 		},
 		[resetMs]

package/index.ts

@@ -47,6 +47,7 @@ export type { QueryInputProps } from "./poi/QueryInput.tsx"
 export { formatDistance, loadPOIRuntime, POI_DEFAULT_TEXT, POI_PRESETS } from "./poi/runtime.ts"
 export { SubjectPanel } from "./poi/SubjectPanel.tsx"
 export type { SubjectPanelProps } from "./poi/SubjectPanel.tsx"
+
 export type {
 	CategoryRecord,
 	LiveSearchState,
@@ -62,6 +63,7 @@ export type {
 	POISubjectBase,
 	TaxonomyLookup,
 } from "./poi/types.ts"
+
 export { usePOISearch } from "./poi/usePOISearch.ts"
 export type { UsePOISearch, UsePOISearchOptions } from "./poi/usePOISearch.ts"
 
@@ -80,6 +82,7 @@ export { QueryForm } from "./pipeline/QueryForm.tsx"
 export type { QueryFormProps } from "./pipeline/QueryForm.tsx"
 export { ResolvedPlace } from "./pipeline/ResolvedPlace.tsx"
 export type { ResolvedPlaceProps } from "./pipeline/ResolvedPlace.tsx"
+
 export type {
 	DualRoleView,
 	FSTProvenance,
@@ -91,11 +94,13 @@ export type {
 	ResolvedPlaceView,
 	StageTiming,
 } from "./pipeline/types.ts"
+
 export { useParsePipeline } from "./pipeline/useParsePipeline.ts"
 export type { UseParsePipeline, UseParsePipelineOptions } from "./pipeline/useParsePipeline.ts"
 
 // ── Demo runtime (shared load orchestration; node-safe — no onnx/httpvfs/maplibre) ──
 export { useDemoRuntime } from "./runtime/useDemoRuntime.ts"
+
 export type {
 	DemoAssetsLoadContext,
 	DemoLoaderState,

package/map/BackendControl.tsx

@@ -14,15 +14,23 @@
 import type { ReactNode } from "react"
 
 export interface BackendControlProps {
-	/** The backend the runtime resolved to (e.g. `webgpu (28 MB int8)`); empty before it is known. */
+	/**
+	 * The backend the runtime resolved to (e.g. `webgpu (28 MB int8)`); empty before it is known.
+	 */
 	activeBackend?: string
-	/** Whether the CPU/WASM backend is currently forced. */
+	/**
+	 * Whether the CPU/WASM backend is currently forced.
+	 */
 	forceWASM: boolean
-	/** Fired when the visitor toggles the "Force WASM" checkbox. */
+	/**
+	 * Fired when the visitor toggles the "Force WASM" checkbox.
+	 */
 	onForceWASMChange: (forceWASM: boolean) => void
 }
 
-/** The backend indicator + WASM opt-out. */
+/**
+ * The backend indicator + WASM opt-out.
+ */
 export function BackendControl({ activeBackend, forceWASM, onForceWASMChange }: BackendControlProps): ReactNode {
 	return (
 		<div className="mw-demo-backend">

package/map/CompareToggle.tsx

@@ -16,25 +16,43 @@ import type { ReactNode } from "react"
 import type { DemoVersionOption } from "./types.ts"
 
 export interface CompareToggleProps {
-	/** The selectable model bundles (the primary version is filtered out of the compare list). */
+	/**
+	 * The selectable model bundles (the primary version is filtered out of the compare list).
+	 */
 	versions: ReadonlyArray<DemoVersionOption>
-	/** The primary version, excluded from the compare options. */
+	/**
+	 * The primary version, excluded from the compare options.
+	 */
 	primaryVersion: string | null
-	/** Whether compare mode is on. */
+	/**
+	 * Whether compare mode is on.
+	 */
 	compareMode: boolean
-	/** Fired when the visitor flips compare mode. */
+	/**
+	 * Fired when the visitor flips compare mode.
+	 */
 	onCompareModeChange: (compareMode: boolean) => void
-	/** The version chosen to compare against, or `null` when none is chosen. */
+	/**
+	 * The version chosen to compare against, or `null` when none is chosen.
+	 */
 	compareVersion: string | null
-	/** Fired with the chosen compare version (or `null` when the empty option is picked). */
+	/**
+	 * Fired with the chosen compare version (or `null` when the empty option is picked).
+	 */
 	onCompareVersionChange: (version: string | null) => void
-	/** Disable the compare-version select (e.g. while a parse or compare load runs). */
+	/**
+	 * Disable the compare-version select (e.g. while a parse or compare load runs).
+	 */
 	disabled?: boolean
-	/** A status line rendered under the select (e.g. the compare backend, or a "Loading…" line). */
+	/**
+	 * A status line rendered under the select (e.g. the compare backend, or a "Loading…" line).
+	 */
 	status?: ReactNode
 }
 
-/** The compare toggle + (when on) the compare-version selector. Renders `null` with fewer than two versions. */
+/**
+ * The compare toggle + (when on) the compare-version selector. Renders `null` with fewer than two versions.
+ */
 export function CompareToggle({
 	versions,
 	primaryVersion,

package/map/DemoControls.tsx

@@ -30,27 +30,47 @@ import type { UsePlaceAutocomplete } from "./usePlaceAutocomplete.ts"
 import { VersionPicker } from "./VersionPicker.tsx"
 
 export interface DemoControlsProps {
-	/** The injected demo runtime. */
+	/**
+	 * The injected demo runtime.
+	 */
 	runtime: DemoRuntime
-	/** The parse+resolve state machine. */
+	/**
+	 * The parse+resolve state machine.
+	 */
 	geocode: UseDemoGeocode
-	/** The place-autocomplete combobox state. */
+	/**
+	 * The place-autocomplete combobox state.
+	 */
 	autocomplete: UsePlaceAutocomplete
-	/** The compare-mode state. */
+	/**
+	 * The compare-mode state.
+	 */
 	compare: UseCompareState
-	/** Host-injected panels (about, release blurb, compare, permalink, extras, failure). */
+	/**
+	 * Host-injected panels (about, release blurb, compare, permalink, extras, failure).
+	 */
 	panels: DemoPanels
-	/** Example chips. */
+	/**
+	 * Example chips.
+	 */
 	presets: ReadonlyArray<Preset>
-	/** Input placeholder. */
+	/**
+	 * Input placeholder.
+	 */
 	placeholder: string
-	/** Select a model version (the composed demo also clears a now-colliding compare selection). */
+	/**
+	 * Select a model version (the composed demo also clears a now-colliding compare selection).
+	 */
 	onSelectVersion: (version: string) => void
-	/** Toggle the forced WASM backend. */
+	/**
+	 * Toggle the forced WASM backend.
+	 */
 	onForceWASMChange: (forceWASM: boolean) => void
 }
 
-/** The floating control panel. */
+/**
+ * The floating control panel.
+ */
 export function DemoControls({
 	runtime,
 	geocode,
@@ -130,7 +150,7 @@ export function DemoControls({
 			{loading && !runtime.ready ? (
 				<LoadingIndicator
 					mode="staged"
-					steps={loading.stepLabels.length > 0 ? loading.stepLabels : undefined}
+					steps={loading.stepLabels.length ? loading.stepLabels : undefined}
 					activeStep={loading.stepIndex}
 					label={loading.progress}
 				/>

package/map/DemoMap.tsx

@@ -25,7 +25,9 @@ import type { CSSProperties, ReactNode, Ref } from "react"
 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 `<DemoMap>` renders — a style URL or an inline/composed `StyleSpecification`.
+ */
 export type DemoMapStyle = NonNullable<MapProps["mapStyle"]>
 
 /**
@@ -37,25 +39,45 @@ export type DemoMapExtraProps = Partial<
 >
 
 export interface DemoMapProps {
-	/** The map style — host-composed `StyleSpecification` or a style URL. */
+	/**
+	 * The map style — host-composed `StyleSpecification` or a style URL.
+	 */
 	mapStyle: DemoMapStyle
-	/** Uncontrolled initial camera. Use this OR `viewState`, not both. */
+	/**
+	 * Uncontrolled initial camera. Use this OR `viewState`, not both.
+	 */
 	initialViewState?: MapProps["initialViewState"]
-	/** Controlled camera. Pair with `onMove` to persist it. */
+	/**
+	 * Controlled camera. Pair with `onMove` to persist it.
+	 */
 	viewState?: MapProps["viewState"]
-	/** Fired on every camera change (drag/zoom/rotate) — the seam for viewport-bias persistence. */
+	/**
+	 * Fired on every camera change (drag/zoom/rotate) — the seam for viewport-bias persistence.
+	 */
 	onMove?: (event: ViewStateChangeEvent) => void
-	/** Map projection. @default "globe" (matches the docs `DashboardMap`). */
+	/**
+	 * Map projection. @default "globe" (matches the docs `DashboardMap`).
+	 */
 	projection?: MapProps["projection"]
-	/** Forwarded to the underlying `<Map>` for imperative access (`useMap`/`flyTo` in later phases). */
+	/**
+	 * Forwarded to the underlying `<Map>` for imperative access (`useMap`/`flyTo` in later phases).
+	 */
 	mapRef?: Ref<MapRef>
-	/** Overlays, markers, and controls — rendered as `<Map>` children. Empty in phase 1. */
+	/**
+	 * Overlays, markers, and controls — rendered as `<Map>` children. Empty in phase 1.
+	 */
 	children?: ReactNode
-	/** Class on the wrapper element. */
+	/**
+	 * Class on the wrapper element.
+	 */
 	className?: string
-	/** Inline style on the wrapper element (sizing lives here or on `.mw-demo-map`). */
+	/**
+	 * Inline style on the wrapper element (sizing lives here or on `.mw-demo-map`).
+	 */
 	style?: CSSProperties
-	/** Remaining `<Map>` props DemoMap does not surface explicitly. */
+	/**
+	 * Remaining `<Map>` props DemoMap does not surface explicitly.
+	 */
 	mapProps?: DemoMapExtraProps
 }
 

package/map/GeocoderDemo.tsx

@@ -23,7 +23,7 @@ import { type ReactNode, useCallback, useRef } from "react"
 import type { MapRef } from "react-map-gl/maplibre"
 
 import { ClientOnly } from "../common/ClientOnly.tsx"
-import { type Preset } from "../common/PresetChips.tsx"
+import type { Preset } from "../common/PresetChips.tsx"
 import { DemoControls } from "./DemoControls.tsx"
 import { DemoMap } from "./DemoMap.tsx"
 import { OverlayLayers } from "./OverlayLayers.tsx"
@@ -35,13 +35,21 @@ import { useMapPlaceRender } from "./useMapPlaceRender.ts"
 import { usePlaceAutocomplete } from "./usePlaceAutocomplete.ts"
 
 export interface GeocoderDemoProps {
-	/** The injected demo runtime (map style + overlays + parse + version/backend). */
+	/**
+	 * The injected demo runtime (map style + overlays + parse + version/backend).
+	 */
 	runtime: DemoRuntime
-	/** Host-injected panels (about, release blurb, compare, permalink, debug drawer, map controls, …). */
+	/**
+	 * Host-injected panels (about, release blurb, compare, permalink, debug drawer, map controls, …).
+	 */
 	panels?: DemoPanels
-	/** Address to pre-fill. */
+	/**
+	 * Address to pre-fill.
+	 */
 	defaultAddress?: string
-	/** Example chips. @default the empty set (host supplies its own). */
+	/**
+	 * Example chips. @default the empty set (host supplies its own).
+	 */
 	presets?: ReadonlyArray<Preset>
 	/**
 	 * Only hint the viewport bias once the visitor has zoomed past the global view — a whole-globe center is noise.
@@ -89,6 +97,7 @@ function GeocoderDemoInner({
 
 	const geocode = useDemoGeocode({ runtime, defaultText: defaultAddress, getBias })
 	const compare = useCompareState()
+
 	const autocomplete = usePlaceAutocomplete({
 		text: geocode.text,
 		setText: geocode.setText,
@@ -146,12 +155,20 @@ function GeocoderDemoInner({
 	)
 }
 
-/** The composed geocoder demo, behind a `ClientOnly` SSR boundary (the map is intrinsically a client component). */
+/**
+ * Stable empty defaults — a fresh `{}`/`[]` per render would churn every downstream memo dep.
+ */
+const NO_PANELS: DemoPanels = {}
+const NO_PRESETS: ReadonlyArray<Preset> = []
+
+/**
+ * The composed geocoder demo, behind a `ClientOnly` SSR boundary (the map is intrinsically a client component).
+ */
 export function GeocoderDemo({
 	runtime,
-	panels = {},
+	panels = NO_PANELS,
 	defaultAddress = "",
-	presets = [],
+	presets = NO_PRESETS,
 	minBiasZoom = 4,
 	applyResultCamera = true,
 }: GeocoderDemoProps): ReactNode {

package/map/OverlayLayers.tsx

@@ -19,13 +19,17 @@ import { Layer, Source } from "react-map-gl/maplibre"
 import type { OverlaySpec } from "./types.ts"
 
 export interface OverlayLayersProps {
-	/** The overlays to render, in draw order (first is drawn first / lowest). */
+	/**
+	 * 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`. */
+/**
+ * Render each overlay as one `<Source>` and its `<Layer>`s, honoring the `visible` flag via `visibility`.
+ */
 export function OverlayLayers({ overlays }: OverlayLayersProps): ReactNode {
-	if (!overlays || overlays.length === 0) return null
+	if (!overlays || !overlays.length) return null
 
 	return (
 		<>

package/map/PlaceAutocomplete.tsx

@@ -18,23 +18,39 @@ import { cx } from "../common/cx.ts"
 import type { Suggestion } from "./types.ts"
 
 export interface PlaceAutocompleteProps {
-	/** The suggestions to render (from {@link usePlaceAutocomplete}). */
+	/**
+	 * The suggestions to render (from {@link usePlaceAutocomplete}).
+	 */
 	suggestions: Suggestion[]
-	/** The keyboard-highlighted index; `-1` for none. */
+	/**
+	 * The keyboard-highlighted index; `-1` for none.
+	 */
 	activeIndex: number
-	/** Fired (with the suggestion `value`) when one is clicked. */
+	/**
+	 * 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. */
+	/**
+	 * 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`). */
+	/**
+	 * 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. */
+	/**
+	 * Build the option element id — pass `optionId` from the hook.
+	 */
 	optionId: (index: number) => string
-	/** Leading label. @default "Did you mean:" */
+	/**
+	 * Leading label. @default "Did you mean:"
+	 */
 	caption?: string
 }
 
-/** The suggestion listbox. */
+/**
+ * The suggestion listbox.
+ */
 export function PlaceAutocomplete({
 	suggestions,
 	activeIndex,
@@ -44,7 +60,7 @@ export function PlaceAutocomplete({
 	optionId,
 	caption = "Did you mean:",
 }: PlaceAutocompleteProps): ReactNode {
-	if (suggestions.length === 0) return null
+	if (!suggestions.length) return null
 
 	return (
 		<div className="mw-demo-suggest" id={listboxId} role="listbox" aria-label="Place suggestions">

package/map/PlaceMarker.tsx

@@ -15,21 +15,33 @@
 import type { ReactNode } from "react"
 import { Marker } from "react-map-gl/maplibre"
 
-/** The house pink the demo has always drawn the resolved-place marker in. */
+/**
+ * The house pink the demo has always drawn the resolved-place marker in.
+ */
 const MARKER_COLOR = "#e0367c"
 
 export interface PlaceMarkerProps {
-	/** Marker longitude. */
+	/**
+	 * Marker longitude.
+	 */
 	longitude: number
-	/** Marker latitude. */
+	/**
+	 * Marker latitude.
+	 */
 	latitude: number
-	/** Pin color. @default the house pink. */
+	/**
+	 * Pin color. @default the house pink.
+	 */
 	color?: string
-	/** Which part of the marker sits on the coordinate. @default "center" (a symmetric dot). */
+	/**
+	 * 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. */
+/**
+ * A single resolved-place marker. Wraps `react-map-gl`'s `<Marker>` with the demo's default color.
+ */
 export function PlaceMarker({
 	longitude,
 	latitude,

package/map/ResolvedPlaceLayers.tsx

@@ -21,22 +21,32 @@ import { ResultCamera } from "./ResultCamera.tsx"
 import { ResultOverlay } from "./ResultOverlay.tsx"
 
 export interface ResolvedPlaceLayersProps {
-	/** The render spec (from {@link useMapPlaceRender}); `null` renders nothing. */
+	/**
+	 * 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 */
+	/**
+	 * Animate the camera move. Forwarded to {@link ResultCamera}. @default true
+	 */
 	animateCamera?: boolean
-	/** Source/layer id prefix for the outline. @default "mw-result" */
+	/**
+	 * Source/layer id prefix for the outline. @default "mw-result"
+	 */
 	outlineId?: string
-	/** Marker color. @default the house pink. */
+	/**
+	 * Marker color. @default the house pink.
+	 */
 	markerColor?: string
 }
 
-/** Render the marker(s), outline, and (optional) camera move for one resolved place. */
+/**
+ * Render the marker(s), outline, and (optional) camera move for one resolved place.
+ */
 export function ResolvedPlaceLayers({
 	spec,
 	applyCamera = true,

package/map/ResultCamera.tsx

@@ -25,7 +25,9 @@ import { useMap } from "react-map-gl/maplibre"
 import type { MapCameraTarget } from "./place-render.ts"
 
 export interface ResultCameraProps {
-	/** The camera target to animate to. `null` leaves the camera untouched (no result yet). */
+	/**
+	 * 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`
@@ -34,7 +36,9 @@ export interface ResultCameraProps {
 	animate?: boolean
 }
 
-/** Drive the live map to `target`. No DOM of its own — it is a behavior mounted as a `<Map>` child. */
+/**
+ * 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 }: ResultCameraProps): ReactNode {
 	const map = useMap()