@mailwoman/react 7.4.0 → 7.6.0

package/map/usePlaceAutocomplete.ts

@@ -0,0 +1,195 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `usePlaceAutocomplete` — the headless "Did you mean" combobox lifted from the demo god component
+ *   (`_app.tsx:820-900`). It walks the host-supplied `autocomplete` over the locality segment the visitor
+ *   is typing (the text after the last comma), owns the suggestion list + keyboard-highlighted active
+ *   descendant, and rewrites the input on pick (replacing just that segment). No FST, no fetch of its own
+ *   — the `autocomplete` fetcher is INJECTED (the package never imports `@mailwoman/resolver-wof-sqlite`),
+ *   so this stays node-safe and testable with a synchronous fake.
+ *
+ *   Returns the `<input>` aria/combobox props to spread onto the reused {@link QueryForm} input plus an
+ *   `onInputKeyDown` (↑/↓ move the highlight, Enter accepts it AND suppresses submit, Esc dismisses), and
+ *   the presentational {@link PlaceAutocomplete} listbox renders `suggestions` / `activeIndex`.
+ */
+
+import { type KeyboardEvent, useCallback, useEffect, useRef, useState } from "react"
+
+import { useDebouncedValue } from "../common/useDebouncedValue.ts"
+import type { Suggestion } from "./types.ts"
+
+export interface UsePlaceAutocompleteOptions {
+	/** The current input text. */
+	text: string
+	/** Setter for the input text (a pick rewrites the last-comma segment). */
+	setText: (text: string) => void
+	/** The host's autocomplete fetcher (FST prefix-walk). Absent → the combobox is inert. */
+	autocomplete?: (query: string) => Promise<Suggestion[]>
+	/** Minimum query length before suggesting. @default 2 */
+	minChars?: number
+	/** Debounce before firing the fetcher. @default 150 */
+	debounceMs?: number
+}
+
+/** The combobox aria props to spread onto the input the suggestions describe. */
+export interface AutocompleteInputProps {
+	role: "combobox"
+	"aria-expanded": boolean
+	"aria-controls": string
+	"aria-autocomplete": "list"
+	"aria-activedescendant": string | undefined
+	autoComplete: "off"
+}
+
+export interface UsePlaceAutocomplete {
+	/** The current suggestions (empty when nothing matches — the listbox then hides). */
+	suggestions: Suggestion[]
+	/** The keyboard-highlighted suggestion index; `-1` when none is highlighted. */
+	activeIndex: number
+	/** Set the highlighted index (the listbox calls this on mouse-enter). */
+	setActiveIndex: (index: number) => void
+	/** Keydown handler for the input: ↑/↓ highlight, Enter accepts (+ suppresses submit), Esc dismisses. */
+	onInputKeyDown: (event: KeyboardEvent<HTMLInputElement>) => void
+	/** Accept a suggestion by value (rewrites the last-comma segment, closes the list). */
+	pick: (value: string) => void
+	/** Close the list without picking. */
+	dismiss: () => void
+	/** Aria/combobox props for the input the suggestions describe. */
+	inputProps: AutocompleteInputProps
+	/** The listbox element id (matches `inputProps["aria-controls"]`). */
+	listboxId: string
+	/** Build the option element id for suggestion `index`. */
+	optionId: (index: number) => string
+}
+
+const LISTBOX_ID = "mw-demo-suggest-list"
+const optionId = (index: number) => `mw-demo-suggest-${index}`
+
+/** Extract the locality segment being typed — the text after the last comma, trimmed. */
+function localitySegment(text: string): string {
+	return (text.includes(",") ? text.slice(text.lastIndexOf(",") + 1) : text).trim()
+}
+
+/** Replace the locality segment (after the last comma) with `name`, preserving the address prefix. */
+function replaceSegment(current: string, name: string): string {
+	return current.includes(",") ? `${current.slice(0, current.lastIndexOf(",") + 1)} ${name}` : name
+}
+
+export function usePlaceAutocomplete({
+	text,
+	setText,
+	autocomplete,
+	minChars = 2,
+	debounceMs = 150,
+}: UsePlaceAutocompleteOptions): UsePlaceAutocomplete {
+	const [suggestions, setSuggestions] = useState<Suggestion[]>([])
+	const [activeIndex, setActiveIndex] = useState(-1)
+	// One-shot guard: a pick rewrites `text` to the chosen name, which would otherwise re-trigger the fetch and
+	// immediately re-suggest the place just chosen. Set on pick, consumed by the next effect run.
+	const suppressRef = useRef(false)
+
+	const query = localitySegment(text)
+	const debouncedQuery = useDebouncedValue(query, debounceMs)
+
+	useEffect(() => {
+		if (suppressRef.current) {
+			suppressRef.current = false
+			setSuggestions([])
+			setActiveIndex(-1)
+
+			return
+		}
+
+		if (!autocomplete || debouncedQuery.length < minChars || /^\d/.test(debouncedQuery)) {
+			setSuggestions([])
+			setActiveIndex(-1)
+
+			return
+		}
+
+		let cancelled = false
+
+		void (async () => {
+			try {
+				const next = await autocomplete(debouncedQuery)
+
+				if (cancelled) return
+				setSuggestions(next)
+				setActiveIndex(-1)
+			} catch {
+				if (cancelled) return
+				setSuggestions([])
+				setActiveIndex(-1)
+			}
+		})()
+
+		return () => {
+			cancelled = true
+		}
+	}, [debouncedQuery, autocomplete, minChars])
+
+	const pick = useCallback(
+		(value: string) => {
+			suppressRef.current = true
+			setText(replaceSegment(text, value))
+			setSuggestions([])
+			setActiveIndex(-1)
+		},
+		[text, setText]
+	)
+
+	const dismiss = useCallback(() => {
+		setSuggestions([])
+		setActiveIndex(-1)
+	}, [])
+
+	const onInputKeyDown = useCallback(
+		(event: KeyboardEvent<HTMLInputElement>) => {
+			if (suggestions.length === 0) return
+
+			switch (event.key) {
+				case "ArrowDown":
+					event.preventDefault()
+					setActiveIndex((i) => Math.min(i + 1, suggestions.length - 1))
+					break
+				case "ArrowUp":
+					event.preventDefault()
+					setActiveIndex((i) => Math.max(i - 1, 0))
+					break
+				case "Enter":
+					if (activeIndex >= 0 && activeIndex < suggestions.length) {
+						event.preventDefault()
+						pick(suggestions[activeIndex]!.value)
+					}
+
+					break
+				case "Escape":
+					event.preventDefault()
+					dismiss()
+					break
+			}
+		},
+		[suggestions, activeIndex, pick, dismiss]
+	)
+
+	return {
+		suggestions,
+		activeIndex,
+		setActiveIndex,
+		onInputKeyDown,
+		pick,
+		dismiss,
+		inputProps: {
+			role: "combobox",
+			"aria-expanded": suggestions.length > 0,
+			"aria-controls": LISTBOX_ID,
+			"aria-autocomplete": "list",
+			"aria-activedescendant": activeIndex >= 0 ? optionId(activeIndex) : undefined,
+			autoComplete: "off",
+		},
+		listboxId: LISTBOX_ID,
+		optionId,
+	}
+}

package/out/common/PresetChips.d.ts

@@ -17,6 +17,8 @@ export interface PresetChipsProps {
     disabled?: boolean;
     /** Leading label. @default "Try:" */
     caption?: string;
+    /** Optional trailing content rendered inside the chip row after the presets (e.g. an inline permalink button). */
+    trailing?: ReactNode;
 }
-export declare function PresetChips({ presets, onPick, disabled, caption }: PresetChipsProps): ReactNode;
+export declare function PresetChips({ presets, onPick, disabled, caption, trailing }: PresetChipsProps): ReactNode;
 //# sourceMappingURL=PresetChips.d.ts.map

package/out/common/PresetChips.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PresetChips.d.ts","sourceRoot":"","sources":["../../common/PresetChips.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,WAAW,MAAM;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC9B,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAgB,EAAE,EAAE,gBAAgB,GAAG,SAAS,CAkBxG"}
+{"version":3,"file":"PresetChips.d.ts","sourceRoot":"","sources":["../../common/PresetChips.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,WAAW,MAAM;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC9B,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kHAAkH;IAClH,QAAQ,CAAC,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAgB,EAAE,QAAQ,EAAE,EAAE,gBAAgB,GAAG,SAAS,CAmBlH"}

package/out/common/PresetChips.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-export function PresetChips({ presets, onPick, disabled, caption = "Try:" }) {
-    return (_jsxs("div", { className: "mw-presets", children: [_jsx("span", { className: "mw-presets__label", children: caption }), presets.map((preset) => (_jsx("button", { type: "button", className: "mw-chip", disabled: disabled, onClick: () => onPick(preset.value), title: preset.value, children: preset.label }, preset.label)))] }));
+export function PresetChips({ presets, onPick, disabled, caption = "Try:", trailing }) {
+    return (_jsxs("div", { className: "mw-presets", children: [_jsx("span", { className: "mw-presets__label", children: caption }), presets.map((preset) => (_jsx("button", { type: "button", className: "mw-chip", disabled: disabled, onClick: () => onPick(preset.value), title: preset.value, children: preset.label }, preset.label))), trailing] }));
 }
 //# sourceMappingURL=PresetChips.js.map

package/out/common/PresetChips.js.map

@@ -1 +1 @@
-{"version":3,"file":"PresetChips.js","sourceRoot":"","sources":["../../common/PresetChips.tsx"],"names":[],"mappings":";AAwBA,MAAM,UAAU,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAoB;IAC5F,OAAO,CACN,eAAK,SAAS,EAAC,YAAY,aAC1B,eAAM,SAAS,EAAC,mBAAmB,YAAE,OAAO,GAAQ,EACnD,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACxB,iBAEC,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,SAAS,EACnB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EACnC,KAAK,EAAE,MAAM,CAAC,KAAK,YAElB,MAAM,CAAC,KAAK,IAPR,MAAM,CAAC,KAAK,CAQT,CACT,CAAC,IACG,CACN,CAAA;AACF,CAAC"}
+{"version":3,"file":"PresetChips.js","sourceRoot":"","sources":["../../common/PresetChips.tsx"],"names":[],"mappings":";AA0BA,MAAM,UAAU,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAE,QAAQ,EAAoB;IACtG,OAAO,CACN,eAAK,SAAS,EAAC,YAAY,aAC1B,eAAM,SAAS,EAAC,mBAAmB,YAAE,OAAO,GAAQ,EACnD,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACxB,iBAEC,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,SAAS,EACnB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EACnC,KAAK,EAAE,MAAM,CAAC,KAAK,YAElB,MAAM,CAAC,KAAK,IAPR,MAAM,CAAC,KAAK,CAQT,CACT,CAAC,EACD,QAAQ,IACJ,CACN,CAAA;AACF,CAAC"}

package/out/index.d.ts

@@ -43,7 +43,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, LoadPOIRuntime, POIExplorerResult, POILiveSearch, POILiveSearchResult, POIRuntime, POISearchHit, POISubject, TaxonomyLookup, } from "./poi/types.ts";
+export type { CategoryRecord, LiveSearchState, LoadPOIRuntime, POIBrandSubject, POICategorySubject, POIExplorerResult, POILiveSearch, POILiveSearchResult, POIRuntime, POISearchHit, POISubject, POISubjectBase, TaxonomyLookup, } from "./poi/types.ts";
 export { usePOISearch } from "./poi/usePOISearch.ts";
 export type { UsePOISearch, UsePOISearchOptions } from "./poi/usePOISearch.ts";
 export { CandidatePicker } from "./pipeline/CandidatePicker.tsx";
@@ -63,4 +63,7 @@ export type { ResolvedPlaceProps } from "./pipeline/ResolvedPlace.tsx";
 export type { DualRoleView, FSTProvenance, ParsedComponent, ParseResult, PipelineLoadingState, PipelinePanels, PipelineRuntime, ResolvedPlaceView, StageTiming, } from "./pipeline/types.ts";
 export { useParsePipeline } from "./pipeline/useParsePipeline.ts";
 export type { UseParsePipeline, UseParsePipelineOptions } from "./pipeline/useParsePipeline.ts";
+export { useDemoRuntime } from "./runtime/useDemoRuntime.ts";
+export type { DemoAssetsLoadContext, DemoLoaderState, DemoManifest, DemoReleaseBase, DemoRuntimeConfig, } from "./runtime/useDemoRuntime.ts";
+export type { DemoBackend, DemoMapExtraProps, DemoMapProps, DemoMapStyle, DemoRuntime, DemoVersionOption, LngLatTuple, MapBias, OverlaySpec, Suggestion, } from "./map/index.ts";
 //# sourceMappingURL=index.d.ts.map

package/out/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/out/index.js

@@ -43,4 +43,6 @@ export { PipelineExplorer } from "./pipeline/PipelineExplorer.js";
 export { QueryForm } from "./pipeline/QueryForm.js";
 export { ResolvedPlace } from "./pipeline/ResolvedPlace.js";
 export { useParsePipeline } from "./pipeline/useParsePipeline.js";
+// ── Demo runtime (shared load orchestration; node-safe — no onnx/httpvfs/maplibre) ──
+export { useDemoRuntime } from "./runtime/useDemoRuntime.js";
 //# sourceMappingURL=index.js.map

package/out/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,8EAA8E;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAyB,CAAA;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAyB,CAAA;AAEpD,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAA;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAwB,CAAA;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA+B,CAAA;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAA0B,CAAA;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAEjE,8EAA8E;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAwB,CAAA;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA4B,CAAA;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAyB,CAAA;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAuB,CAAA;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAsB,CAAA;AAEjD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAwB,CAAA;AAcrD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAGpD,8EAA8E;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,+BAAgC,CAAA;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA+B,CAAA;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA+B,CAAA;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAiC,CAAA;AAElE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAA0B,CAAA;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA8B,CAAA;AAa5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,8EAA8E;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAyB,CAAA;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAyB,CAAA;AAEpD,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAA;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAwB,CAAA;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA+B,CAAA;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAA0B,CAAA;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAEjE,8EAA8E;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAwB,CAAA;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA4B,CAAA;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAyB,CAAA;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAuB,CAAA;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAsB,CAAA;AAEjD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAwB,CAAA;AAiBrD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAGpD,8EAA8E;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,+BAAgC,CAAA;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA+B,CAAA;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA+B,CAAA;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAiC,CAAA;AAElE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAA0B,CAAA;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA8B,CAAA;AAa5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAGjE,uFAAuF;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA"}

package/out/map/BackendControl.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `<BackendControl>` — the neural-backend indicator + "Force WASM" checkbox from the demo's control
+ *   panel (`_app.tsx:1255-1280`), as a dumb presentational unit. It shows which backend the runtime
+ *   resolved to (WebGPU / WASM, with the int8 size the host formats into the label) and lets the visitor
+ *   opt out of WebGPU. Props in, one boolean event out — the host re-loads the bundle on the toggle.
+ *
+ *   NODE-SAFE: pure React, no maplibre.
+ */
+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. */
+    activeBackend?: string;
+    /** Whether the CPU/WASM backend is currently forced. */
+    forceWASM: boolean;
+    /** Fired when the visitor toggles the "Force WASM" checkbox. */
+    onForceWASMChange: (forceWASM: boolean) => void;
+}
+/** The backend indicator + WASM opt-out. */
+export declare function BackendControl({ activeBackend, forceWASM, onForceWASMChange }: BackendControlProps): ReactNode;
+//# sourceMappingURL=BackendControl.d.ts.map

package/out/map/BackendControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackendControl.d.ts","sourceRoot":"","sources":["../../map/BackendControl.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,WAAW,mBAAmB;IACnC,kGAAkG;IAClG,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,wDAAwD;IACxD,SAAS,EAAE,OAAO,CAAA;IAClB,gEAAgE;IAChE,iBAAiB,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAA;CAC/C;AAED,4CAA4C;AAC5C,wBAAgB,cAAc,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAE,EAAE,mBAAmB,GAAG,SAAS,CAa9G"}

package/out/map/BackendControl.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** The backend indicator + WASM opt-out. */
+export function BackendControl({ activeBackend, forceWASM, onForceWASMChange }) {
+    return (_jsxs("div", { className: "mw-demo-backend", children: [activeBackend ? (_jsxs("span", { className: "mw-demo-backend__active", children: ["Backend: ", _jsx("code", { children: activeBackend })] })) : null, _jsxs("label", { className: "mw-demo-backend__toggle", children: [_jsx("input", { type: "checkbox", checked: forceWASM, onChange: (e) => onForceWASMChange(e.target.checked) }), " Force WASM"] })] }));
+}
+//# sourceMappingURL=BackendControl.js.map

package/out/map/BackendControl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackendControl.js","sourceRoot":"","sources":["../../map/BackendControl.tsx"],"names":[],"mappings":";AAwBA,4CAA4C;AAC5C,MAAM,UAAU,cAAc,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAuB;IAClG,OAAO,CACN,eAAK,SAAS,EAAC,iBAAiB,aAC9B,aAAa,CAAC,CAAC,CAAC,CAChB,gBAAM,SAAS,EAAC,yBAAyB,0BAC/B,yBAAO,aAAa,GAAQ,IAC/B,CACP,CAAC,CAAC,CAAC,IAAI,EACR,iBAAO,SAAS,EAAC,yBAAyB,aACzC,gBAAO,IAAI,EAAC,UAAU,EAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAI,mBAC5F,IACH,CACN,CAAA;AACF,CAAC"}

package/out/map/CompareToggle.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `<CompareToggle>` — the "Compare" checkbox plus the compare-version `<select>` from the demo's
+ *   control panel (`_app.tsx:1281-1339`), as a dumb presentational unit. Turning it on reveals a second
+ *   version picker (the primary version filtered out); the actual second parse is a host concern the
+ *   composed demo surfaces through `panels.compare`. Props in, two events out.
+ *
+ *   NODE-SAFE: pure React, no maplibre.
+ */
+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). */
+    versions: ReadonlyArray<DemoVersionOption>;
+    /** The primary version, excluded from the compare options. */
+    primaryVersion: string | null;
+    /** Whether compare mode is on. */
+    compareMode: boolean;
+    /** Fired when the visitor flips compare mode. */
+    onCompareModeChange: (compareMode: boolean) => void;
+    /** 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). */
+    onCompareVersionChange: (version: string | null) => void;
+    /** 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). */
+    status?: ReactNode;
+}
+/** The compare toggle + (when on) the compare-version selector. Renders `null` with fewer than two versions. */
+export declare function CompareToggle({ versions, primaryVersion, compareMode, onCompareModeChange, compareVersion, onCompareVersionChange, disabled, status, }: CompareToggleProps): ReactNode;
+//# sourceMappingURL=CompareToggle.d.ts.map

package/out/map/CompareToggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompareToggle.d.ts","sourceRoot":"","sources":["../../map/CompareToggle.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnD,MAAM,WAAW,kBAAkB;IAClC,8FAA8F;IAC9F,QAAQ,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAA;IAC1C,8DAA8D;IAC9D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,kCAAkC;IAClC,WAAW,EAAE,OAAO,CAAA;IACpB,iDAAiD;IACjD,mBAAmB,EAAE,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,CAAA;IACnD,4EAA4E;IAC5E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,yFAAyF;IACzF,sBAAsB,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACxD,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gGAAgG;IAChG,MAAM,CAAC,EAAE,SAAS,CAAA;CAClB;AAED,gHAAgH;AAChH,wBAAgB,aAAa,CAAC,EAC7B,QAAQ,EACR,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,QAAQ,EACR,MAAM,GACN,EAAE,kBAAkB,GAAG,SAAS,CAkChC"}

package/out/map/CompareToggle.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** The compare toggle + (when on) the compare-version selector. Renders `null` with fewer than two versions. */
+export function CompareToggle({ versions, primaryVersion, compareMode, onCompareModeChange, compareVersion, onCompareVersionChange, disabled, status, }) {
+    if (versions.length < 2)
+        return null;
+    const options = versions.filter((v) => v.version !== primaryVersion);
+    return (_jsxs("div", { className: "mw-demo-compare", children: [_jsxs("label", { className: "mw-demo-compare__toggle", children: [_jsx("input", { type: "checkbox", checked: compareMode, onChange: (e) => onCompareModeChange(e.target.checked) }), " Compare"] }), compareMode ? (_jsxs("div", { className: "mw-demo-control", children: [_jsx("label", { className: "mw-demo-control__label", htmlFor: "mw-demo-compare-version", children: "Compare with" }), _jsxs("select", { id: "mw-demo-compare-version", className: "mw-demo-control__select", value: compareVersion ?? "", onChange: (e) => onCompareVersionChange(e.target.value || null), disabled: disabled, children: [_jsx("option", { value: "", children: "Select version\u2026" }), options.map((v) => (_jsx("option", { value: v.version, children: v.label ?? v.version }, v.version)))] }), status ? _jsx("p", { className: "mw-demo-compare__status", children: status }) : null] })) : null] }));
+}
+//# sourceMappingURL=CompareToggle.js.map

package/out/map/CompareToggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompareToggle.js","sourceRoot":"","sources":["../../map/CompareToggle.tsx"],"names":[],"mappings":";AAoCA,gHAAgH;AAChH,MAAM,UAAU,aAAa,CAAC,EAC7B,QAAQ,EACR,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,QAAQ,EACR,MAAM,GACc;IACpB,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IAEpC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,cAAc,CAAC,CAAA;IAEpE,OAAO,CACN,eAAK,SAAS,EAAC,iBAAiB,aAC/B,iBAAO,SAAS,EAAC,yBAAyB,aACzC,gBAAO,IAAI,EAAC,UAAU,EAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAI,gBAChG,EACP,WAAW,CAAC,CAAC,CAAC,CACd,eAAK,SAAS,EAAC,iBAAiB,aAC/B,gBAAO,SAAS,EAAC,wBAAwB,EAAC,OAAO,EAAC,yBAAyB,6BAEnE,EACR,kBACC,EAAE,EAAC,yBAAyB,EAC5B,SAAS,EAAC,yBAAyB,EACnC,KAAK,EAAE,cAAc,IAAI,EAAE,EAC3B,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,EAC/D,QAAQ,EAAE,QAAQ,aAElB,iBAAQ,KAAK,EAAC,EAAE,qCAAyB,EACxC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CACnB,iBAAwB,KAAK,EAAE,CAAC,CAAC,OAAO,YACtC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,IADT,CAAC,CAAC,OAAO,CAEb,CACT,CAAC,IACM,EACR,MAAM,CAAC,CAAC,CAAC,YAAG,SAAS,EAAC,yBAAyB,YAAE,MAAM,GAAK,CAAC,CAAC,CAAC,IAAI,IAC/D,CACN,CAAC,CAAC,CAAC,IAAI,IACH,CACN,CAAA;AACF,CAAC"}

package/out/map/DemoControls.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `<DemoControls>` — the geocoder demo's floating control panel, assembled from the demo-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}.
+ *
+ *   NODE-SAFE: pure React + the shared/demo units, no maplibre. It rides `@mailwoman/react/map` as a
+ *   demo-specific control, not for WebGL.
+ */
+import type { ReactNode } from "react";
+import { type Preset } from "../common/PresetChips.tsx";
+import type { DemoPanels, DemoRuntime } from "./types.ts";
+import type { UseCompareState } from "./useCompareState.ts";
+import type { UseDemoGeocode } from "./useDemoGeocode.ts";
+import type { UsePlaceAutocomplete } from "./usePlaceAutocomplete.ts";
+export interface DemoControlsProps {
+    /** The injected demo runtime. */
+    runtime: DemoRuntime;
+    /** The parse+resolve state machine. */
+    geocode: UseDemoGeocode;
+    /** The place-autocomplete combobox state. */
+    autocomplete: UsePlaceAutocomplete;
+    /** The compare-mode state. */
+    compare: UseCompareState;
+    /** Host-injected panels (about, release blurb, compare, permalink, extras, failure). */
+    panels: DemoPanels;
+    /** Example chips. */
+    presets: ReadonlyArray<Preset>;
+    /** Input placeholder. */
+    placeholder: string;
+    /** Select a model version (the composed demo also clears a now-colliding compare selection). */
+    onSelectVersion: (version: string) => void;
+    /** Toggle the forced WASM backend. */
+    onForceWASMChange: (forceWASM: boolean) => void;
+}
+/** The floating control panel. */
+export declare function DemoControls({ runtime, geocode, autocomplete, compare, panels, presets, placeholder, onSelectVersion, onForceWASMChange, }: DemoControlsProps): ReactNode;
+//# sourceMappingURL=DemoControls.d.ts.map

package/out/map/DemoControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DemoControls.d.ts","sourceRoot":"","sources":["../../map/DemoControls.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAMpE,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAGrE,MAAM,WAAW,iBAAiB;IACjC,iCAAiC;IACjC,OAAO,EAAE,WAAW,CAAA;IACpB,uCAAuC;IACvC,OAAO,EAAE,cAAc,CAAA;IACvB,6CAA6C;IAC7C,YAAY,EAAE,oBAAoB,CAAA;IAClC,8BAA8B;IAC9B,OAAO,EAAE,eAAe,CAAA;IACxB,wFAAwF;IACxF,MAAM,EAAE,UAAU,CAAA;IAClB,qBAAqB;IACrB,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC9B,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,gGAAgG;IAChG,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,sCAAsC;IACtC,iBAAiB,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAA;CAC/C;AAED,kCAAkC;AAClC,wBAAgB,YAAY,CAAC,EAC5B,OAAO,EACP,OAAO,EACP,YAAY,EACZ,OAAO,EACP,MAAM,EACN,OAAO,EACP,WAAW,EACX,eAAe,EACf,iBAAiB,GACjB,EAAE,iBAAiB,GAAG,SAAS,CA6G/B"}

package/out/map/DemoControls.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { LoadingIndicator } from "../common/LoadingIndicator.js";
+import { PresetChips } from "../common/PresetChips.js";
+import { QueryForm } from "../pipeline/QueryForm.js";
+import { BackendControl } from "./BackendControl.js";
+import { CompareToggle } from "./CompareToggle.js";
+import { PlaceAutocomplete } from "./PlaceAutocomplete.js";
+import { ResultPanel } from "./ResultPanel.js";
+import { VersionPicker } from "./VersionPicker.js";
+/** The floating control panel. */
+export function DemoControls({ runtime, geocode, autocomplete, compare, panels, presets, placeholder, onSelectVersion, onForceWASMChange, }) {
+    const versions = runtime.availableVersions ?? [];
+    const { busy, result, selectedCandidate } = geocode;
+    const loading = runtime.loading;
+    const errorMessage = geocode.parseError ?? runtime.errorMessage ?? null;
+    return (_jsxs("section", { className: "mw-demo-controls", children: [panels.header, panels.releaseInfo, _jsx(VersionPicker, { versions: versions, selected: runtime.selectedVersion ?? null, onSelect: onSelectVersion, disabled: busy }), _jsx(BackendControl, { activeBackend: runtime.activeBackend, forceWASM: runtime.forceWASM ?? false, onForceWASMChange: onForceWASMChange }), _jsx(CompareToggle, { versions: versions, primaryVersion: runtime.selectedVersion ?? null, compareMode: compare.compareMode, onCompareModeChange: compare.setCompareMode, compareVersion: compare.compareVersion, onCompareVersionChange: compare.setCompareVersion, disabled: busy }), _jsx(QueryForm, { value: geocode.text, onChange: geocode.setText, onSubmit: geocode.submit, disabled: !runtime.ready, busy: busy, placeholder: placeholder, onKeyDown: autocomplete.onInputKeyDown, inputProps: autocomplete.inputProps }), panels.bias, _jsx(PlaceAutocomplete, { suggestions: autocomplete.suggestions, activeIndex: autocomplete.activeIndex, onPick: autocomplete.pick, onHover: autocomplete.setActiveIndex, listboxId: autocomplete.listboxId, optionId: autocomplete.optionId }), _jsx(PresetChips, { presets: presets, disabled: !runtime.ready || busy, onPick: (value) => {
+                    geocode.setText(value);
+                    geocode.reset();
+                }, trailing: panels.permalink ? panels.permalink(geocode.text) : null }), loading && !runtime.ready ? (_jsx(LoadingIndicator, { mode: "staged", steps: loading.stepLabels.length > 0 ? loading.stepLabels : undefined, activeStep: loading.stepIndex, label: loading.progress })) : null, errorMessage ? _jsx("p", { className: "mw-error", children: errorMessage }) : null, panels.aboveResult ? panels.aboveResult({ result }) : null, busy ? (_jsx("div", { className: "mw-result", children: _jsx(LoadingIndicator, { mode: "staged", steps: runtime.parseStageLabels, activeStep: geocode.parseStage }) })) : result ? (panels.result ? (panels.result({
+                result,
+                selectedCandidate,
+                selectedCandidateIndex: geocode.selectedCandidateIndex,
+                onSelectCandidate: geocode.selectCandidate,
+            })) : (_jsx(ResultPanel, { result: result, selectedCandidate: selectedCandidate, selectedCandidateIndex: geocode.selectedCandidateIndex, onSelectCandidate: geocode.selectCandidate, extras: panels.extras, failure: panels.failure }))) : null, panels.compare
+                ? panels.compare({ result, compareMode: compare.compareMode, compareVersion: compare.compareVersion })
+                : null, panels.footer] }));
+}
+//# sourceMappingURL=DemoControls.js.map

package/out/map/DemoControls.js.map

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

package/out/map/DemoMap.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `<DemoMap>` — 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.
+ *
+ *   NODE-IMPORT SAFETY: this module imports `react-map-gl/maplibre` (which pulls `maplibre-gl` — WebGL
+ *   + DOM at import) at module scope, so it is reachable ONLY through the `@mailwoman/react/map`
+ *   subpath, never from the package root (`index.ts`). The bare `import("@mailwoman/react")` a node
+ *   consumer (or the CI smoke IMPORT_CHECK) runs must never transitively load this file. Keep it out of
+ *   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
+ *   server-renders should wrap it in a client boundary (the package's `ClientOnly`), exactly as the
+ *   composed `GeocoderDemo` will in a later phase.
+ */
+import type { CSSProperties, ReactNode, Ref } from "react";
+import type { MapProps, MapRef, ViewStateChangeEvent } from "react-map-gl/maplibre";
+/** The style a `<DemoMap>` renders — a style URL or an inline/composed `StyleSpecification`. */
+export type DemoMapStyle = NonNullable<MapProps["mapStyle"]>;
+/**
+ * Escape hatch 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.
+ */
+export type DemoMapExtraProps = Partial<Omit<MapProps, "mapStyle" | "initialViewState" | "viewState" | "onMove" | "children" | "style" | "ref">>;
+export interface DemoMapProps {
+    /** The map style — host-composed `StyleSpecification` or a style URL. */
+    mapStyle: DemoMapStyle;
+    /** Uncontrolled initial camera. Use this OR `viewState`, not both. */
+    initialViewState?: MapProps["initialViewState"];
+    /** 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. */
+    onMove?: (event: ViewStateChangeEvent) => void;
+    /** Map projection. @default "globe" (matches the docs `DashboardMap`). */
+    projection?: MapProps["projection"];
+    /** 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. */
+    children?: ReactNode;
+    /** Class on the wrapper element. */
+    className?: string;
+    /** Inline style on the wrapper element (sizing lives here or on `.mw-demo-map`). */
+    style?: CSSProperties;
+    /** Remaining `<Map>` props DemoMap does not surface explicitly. */
+    mapProps?: DemoMapExtraProps;
+}
+/**
+ * The controlled-viewport map shell. Renders a sized wrapper around a `react-map-gl/maplibre` `<Map>`; everything
+ * host-specific (the composed `mapStyle`, the initial center) is injected, and overlays ride in as `children`.
+ */
+export declare function DemoMap({ mapStyle, initialViewState, viewState, onMove, projection, mapRef, children, className, style, mapProps, }: DemoMapProps): ReactNode;
+//# sourceMappingURL=DemoMap.d.ts.map

package/out/map/DemoMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DemoMap.d.ts","sourceRoot":"","sources":["../../map/DemoMap.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAE1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAEnF,gGAAgG;AAChG,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAA;AAE5D;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACtC,IAAI,CAAC,QAAQ,EAAE,UAAU,GAAG,kBAAkB,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,KAAK,CAAC,CACvG,CAAA;AAED,MAAM,WAAW,YAAY;IAC5B,yEAAyE;IACzE,QAAQ,EAAE,YAAY,CAAA;IACtB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAA;IAC/C,2DAA2D;IAC3D,SAAS,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAA;IACjC,gGAAgG;IAChG,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAA;IAC9C,0EAA0E;IAC1E,UAAU,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAA;IACnC,oGAAoG;IACpG,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACpB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oFAAoF;IACpF,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAC5B;AAID;;;GAGG;AACH,wBAAgB,OAAO,CAAC,EACvB,QAAQ,EACR,gBAAgB,EAChB,SAAS,EACT,MAAM,EACN,UAAoB,EACpB,MAAM,EACN,QAAQ,EACR,SAAS,EACT,KAAK,EACL,QAAQ,GACR,EAAE,YAAY,GAAG,SAAS,CAmB1B"}

package/out/map/DemoMap.js

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

package/out/map/DemoMap.js.map

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

package/out/map/GeocoderDemo.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @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 { type ReactNode } from "react";
+import { type Preset } from "../common/PresetChips.tsx";
+import type { DemoPanels, DemoRuntime } from "./types.ts";
+export interface GeocoderDemoProps {
+    /** The injected demo runtime (map style + overlays + parse + version/backend). */
+    runtime: DemoRuntime;
+    /** Host-injected panels (about, release blurb, compare, permalink, debug drawer, map controls, …). */
+    panels?: DemoPanels;
+    /** Address to pre-fill. */
+    defaultAddress?: string;
+    /** 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.
+     * Matches the demo's `map.getZoom() >= 4` gate. @default 4
+     */
+    minBiasZoom?: number;
+    /**
+     * Fly/fit the map to the resolved place on each result (via {@link ResolvedPlaceLayers}). @default true. Set false
+     * for a host that drives the camera itself (a controlled `<DemoMap viewState>`), or to keep a headless test
+     * deterministic — the marker + outline still render, only the animated camera move is skipped.
+     */
+    applyResultCamera?: boolean;
+}
+/** The composed geocoder demo, behind a `ClientOnly` SSR boundary (the map is intrinsically a client component). */
+export declare function GeocoderDemo({ runtime, panels, defaultAddress, presets, minBiasZoom, applyResultCamera, }: GeocoderDemoProps): ReactNode;
+//# sourceMappingURL=GeocoderDemo.d.ts.map

package/out/map/GeocoderDemo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeocoderDemo.d.ts","sourceRoot":"","sources":["../../map/GeocoderDemo.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAA;AAI3D,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAKvD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAW,MAAM,YAAY,CAAA;AAMlE,MAAM,WAAW,iBAAiB;IACjC,kFAAkF;IAClF,OAAO,EAAE,WAAW,CAAA;IACpB,sGAAsG;IACtG,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,2BAA2B;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qEAAqE;IACrE,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC/B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC3B;AA4FD,oHAAoH;AACpH,wBAAgB,YAAY,CAAC,EAC5B,OAAO,EACP,MAAW,EACX,cAAmB,EACnB,OAAY,EACZ,WAAe,EACf,iBAAwB,GACxB,EAAE,iBAAiB,GAAG,SAAS,CAqB/B"}