@mailwoman/react 10.0.0 → 10.2.0

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

@@ -1 +1 @@
-{"version":3,"file":"CompareToggle.d.ts","sourceRoot":"","sources":["../../lib/map/CompareToggle.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IACtC;;OAEG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B;;OAEG;IACH,WAAW,EAAE,OAAO,CAAA;IACpB;;OAEG;IACH,mBAAmB,EAAE,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,CAAA;IACnD;;OAEG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B;;OAEG;IACH,sBAAsB,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACxD;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,CAAA;CAClB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAC7B,QAAQ,EACR,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,QAAQ,EACR,MAAM,GACN,EAAE,kBAAkB,GAAG,SAAS,CAmChC"}
+{"version":3,"file":"CompareToggle.d.ts","sourceRoot":"","sources":["../../lib/map/CompareToggle.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IACtC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,WAAW,EAAE,OAAO,CAAA;IACpB,mBAAmB,EAAE,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,CAAA;IACnD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,sBAAsB,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,SAAS,CAAA;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAC7B,QAAQ,EACR,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,QAAQ,EACR,MAAM,GACN,EAAE,kBAAkB,GAAG,SAAS,CAmChC"}

package/out/map/CompareToggle.js

@@ -1,6 +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.
+ * Renders the compare checkbox.
+ *
+ * In compare mode, it also renders the version selector. and no control at all
+ * when fewer than two versions exist.
  */
 export function CompareToggle({ versions, primaryVersion, compareMode, onCompareModeChange, compareVersion, onCompareVersionChange, disabled, status, }) {
     if (versions.length < 2)

package/out/map/CompareToggle.js.map

@@ -1 +1 @@
-{"version":3,"file":"CompareToggle.js","sourceRoot":"","sources":["../../lib/map/CompareToggle.tsx"],"names":[],"mappings":";AAoDA;;GAEG;AACH,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,6CAA6C,aAC7D,gBAAO,IAAI,EAAC,UAAU,EAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAI,kCAExG,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"}
+{"version":3,"file":"CompareToggle.js","sourceRoot":"","sources":["../../lib/map/CompareToggle.tsx"],"names":[],"mappings":";AA0BA;;;;;GAKG;AACH,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,6CAA6C,aAC7D,gBAAO,IAAI,EAAC,UAAU,EAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAI,kCAExG,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/DebugInfo.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Display and log build, model and runtime details for bug reports.
+ */
+import { type ReactNode } from "react";
+export interface DebugInfoProps {
+    /**
+     * The runtime's backend and model size (e.g. `wasm (28 MB int8)`); empty before the model loads.
+     */
+    activeBackend?: string;
+    /**
+     * The model version the runtime loaded.
+     *
+     * The training series.
+     * It differs from the npm version.
+     */
+    selectedVersion?: string | null;
+    /**
+     * Whether the asset bundle finished loading.
+     */
+    ready?: boolean;
+}
+export declare function DebugInfo({ activeBackend, selectedVersion, ready }: DebugInfoProps): ReactNode;
+//# sourceMappingURL=DebugInfo.d.ts.map

package/out/map/DebugInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugInfo.d.ts","sourceRoot":"","sources":["../../lib/map/DebugInfo.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAsB,MAAM,OAAO,CAAA;AAI1D,MAAM,WAAW,cAAc;IAC9B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CACf;AAcD,wBAAgB,SAAS,CAAC,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,cAAc,GAAG,SAAS,CAgC9F"}

package/out/map/DebugInfo.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Display and log build, model and runtime details for bug reports.
+ */
+import { useEffect, useMemo } from "react";
+import { useBuildInfo } from "#common/useBuildInfo";
+/**
+ * One row of the record, as a label and a value.
+ */
+function Row({ label, value }) {
+    return (_jsxs("div", { className: "mw-debug-info__row", children: [_jsx("span", { className: "mw-debug-info__label", children: label }), _jsx("code", { className: "mw-debug-info__value", children: value })] }));
+}
+export function DebugInfo({ activeBackend, selectedVersion, ready }) {
+    const build = useBuildInfo();
+    // Memoized on the primitives it reads, so the log below fires when a value changes
+    // rather than on every render.
+    // A record rebuilt each render would be a new object each time and log continuously.
+    const record = useMemo(() => ({
+        app: build?.app ?? "—",
+        commit: build?.commit ?? build?.revision ?? "—",
+        buildTime: build?.buildTime ?? "—",
+        model: selectedVersion ?? "—",
+        backend: activeBackend || (ready ? "unknown" : "loading…"),
+        userAgent: typeof navigator !== "undefined" ? navigator.userAgent : "—",
+    }), [build?.app, build?.commit, build?.revision, build?.buildTime, selectedVersion, activeBackend, ready]);
+    useEffect(() => {
+        // eslint-disable-next-line no-console -- this is the feature: the record has to reach the console a reporter copies.
+        console.info("[mailwoman] debug info", record);
+    }, [record]);
+    return (_jsxs("div", { className: "mw-debug-info", children: [_jsx(Row, { label: "Build", value: record.app }), _jsx(Row, { label: "Commit", value: record.commit.slice(0, 12) }), _jsx(Row, { label: "Built", value: record.buildTime }), _jsx(Row, { label: "Model", value: record.model }), _jsx(Row, { label: "Backend", value: record.backend })] }));
+}
+//# sourceMappingURL=DebugInfo.js.map

package/out/map/DebugInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugInfo.js","sourceRoot":"","sources":["../../lib/map/DebugInfo.tsx"],"names":[],"mappings":";AAAA;;;;;;GAMG;AAEH,OAAO,EAAkB,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAoBnD;;GAEG;AACH,SAAS,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAoC;IAC9D,OAAO,CACN,eAAK,SAAS,EAAC,oBAAoB,aAClC,eAAM,SAAS,EAAC,sBAAsB,YAAE,KAAK,GAAQ,EACrD,eAAM,SAAS,EAAC,sBAAsB,YAAE,KAAK,GAAQ,IAChD,CACN,CAAA;AACF,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,EAAkB;IAClF,MAAM,KAAK,GAAG,YAAY,EAAE,CAAA;IAE5B,mFAAmF;IACnF,+BAA+B;IAC/B,qFAAqF;IACrF,MAAM,MAAM,GAAG,OAAO,CACrB,GAAG,EAAE,CAAC,CAAC;QACN,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,GAAG;QACtB,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,EAAE,QAAQ,IAAI,GAAG;QAC/C,SAAS,EAAE,KAAK,EAAE,SAAS,IAAI,GAAG;QAClC,KAAK,EAAE,eAAe,IAAI,GAAG;QAC7B,OAAO,EAAE,aAAa,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;QAC1D,SAAS,EAAE,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG;KACvE,CAAC,EACF,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,CAAC,CACrG,CAAA;IAED,SAAS,CAAC,GAAG,EAAE;QACd,qHAAqH;QACrH,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAA;IAC/C,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEZ,OAAO,CACN,eAAK,SAAS,EAAC,eAAe,aAC7B,KAAC,GAAG,IAAC,KAAK,EAAC,OAAO,EAAC,KAAK,EAAE,MAAM,CAAC,GAAG,GAAI,EACxC,KAAC,GAAG,IAAC,KAAK,EAAC,QAAQ,EAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAI,EACzD,KAAC,GAAG,IAAC,KAAK,EAAC,OAAO,EAAC,KAAK,EAAE,MAAM,CAAC,SAAS,GAAI,EAC9C,KAAC,GAAG,IAAC,KAAK,EAAC,OAAO,EAAC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAI,EAC1C,KAAC,GAAG,IAAC,KAAK,EAAC,SAAS,EAAC,KAAK,EAAE,MAAM,CAAC,OAAO,GAAI,IACzC,CACN,CAAA;AACF,CAAC"}

package/out/map/Geocoder.d.ts

@@ -2,66 +2,77 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   `<Geocoder>` — the WHOLE geocoder, composed. It is the map analogue of `PipelineExplorer`
- *   and takes the SAME DI shape: an injected {@link GeocoderRuntime} (the host owns ONNX / httpvfs / R2 /
- *   the composed map style) plus a {@link GeocoderPanels} bag (the host's ModelVisualizer / VersionCompare /
- *   About / Permalink). Everything here is composition + a `ClientOnly` boundary:
- *
- *     - the floating {@link GeocoderControls} panel (version / compare / backend / query+autocomplete / result),
- *     - the declarative {@link MapCanvas} 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 useGeocode} (parse + viewport bias + map place),
- *       {@link usePlaceAutocomplete}, {@link useCompareState}.
- *
- *   Because it pulls {@link MapCanvas} (→ `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 { GeocoderPanels, GeocoderRuntime } from "#map/types";
 import type { Preset } from "../common/PresetChips.tsx";
+/**
+ * Props for {@linkcode Geocoder}.
+ */
 export interface GeocoderProps {
     /**
-     * The injected geocoder runtime (map style + overlays + parse + version/backend).
+     * The geocoder runtime supplies the map style and overlays.
+     *
+     * It also supplies the parser and version and backend controls.
      */
     runtime: GeocoderRuntime;
     /**
-     * Host-injected panels (about, release blurb, compare, permalink, debug drawer, map controls, …).
+     * Panels supplied by the host.
      */
     panels?: GeocoderPanels;
     /**
-     * Address to pre-fill.
+     * The address that pre-fills the search field.
+     * It is not run automatically.
      */
     defaultAddress?: string;
     /**
-     * Example chips. @default the empty set (host supplies its own).
+     * A query to run once when the runtime is ready, such as a permalink's `?q=` value.
+     *
+     * Unlike {@link GeocoderProps.defaultAddress}, this query is submitted,
+     * so a shared link reproduces its result.
+     */
+    initialQuery?: string | null;
+    /**
+     * The example chips.
+     *
+     * @defaultValue []
      */
     presets?: ReadonlyArray<Preset>;
     /**
-     * Open the developer disclosure on mount — the model version, the backend readout and compare. Collapsed by default
-     * so the address field is the first thing a visitor meets. @default false
+     * Whether the developer panel starts open.
+     *
+     * @defaultValue `false`
      */
     developer?: boolean;
     /**
-     * Fired with the query each time one is submitted. The host writes it into its own URL — this package never touches
-     * `location`, because which parameter carries a query is the app's decision.
+     * Called with each user-submitted query.
+     *
+     * The host decides how to write the query to its URL.
+     * This package never touches `location`.
      */
     onSubmitQuery?: (query: string) => void;
     /**
-     * Only hint the viewport bias once the visitor has zoomed past the global view — a whole-globe center is noise.
-     * Matches the `map.getZoom() >= 4` threshold. @default 4
+     * The minimum map zoom at which the viewport is sent as a location bias.
+     *
+     * @defaultValue `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 `<MapCanvas viewState>`), or to keep a headless test
-     * deterministic — the marker + outline still render, only the animated camera move is skipped.
+     * Whether the map moves to each resolved place.
+     *
+     * Set it to false when the host controls the camera or a test needs a fixed view.
+     * The marker and outline render either way.
+     *
+     * @defaultValue `true`
      */
     applyResultCamera?: boolean;
 }
 /**
- * The composed geocoder, behind a `ClientOnly` SSR boundary (the map is intrinsically a client component).
+ * Renders the map and search controls as one geocoder.
+ * It also renders host panels.
+ *
+ * It renders only on the client because MapLibre needs browser APIs.
+ * Import it from `@mailwoman/react/map`.
  */
-export declare function Geocoder({ runtime, panels, defaultAddress, presets, minBiasZoom, applyResultCamera, developer, onSubmitQuery, }: GeocoderProps): ReactNode;
+export declare function Geocoder({ runtime, panels, defaultAddress, presets, minBiasZoom, applyResultCamera, developer, initialQuery, onSubmitQuery, }: GeocoderProps): ReactNode;
 //# sourceMappingURL=Geocoder.d.ts.map

package/out/map/Geocoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Geocoder.d.ts","sourceRoot":"","sources":["../../lib/map/Geocoder.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,KAAK,SAAS,EAA4C,MAAM,OAAO,CAAA;AAGhF,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAW,MAAM,YAAY,CAAA;AAO1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAMvD,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,OAAO,EAAE,eAAe,CAAA;IACxB;;OAEG;IACH,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAgID;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EACxB,OAAO,EACP,MAAkB,EAClB,cAAmB,EACnB,OAAoB,EACpB,WAAe,EACf,iBAAwB,EACxB,SAAiB,EACjB,aAAa,GACb,EAAE,aAAa,GAAG,SAAS,CAuB3B"}
+{"version":3,"file":"Geocoder.d.ts","sourceRoot":"","sources":["../../lib/map/Geocoder.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,SAAS,EAA4C,MAAM,OAAO,CAAA;AAGhF,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAW,MAAM,YAAY,CAAA;AAO1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAOvD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B;;;;OAIG;IACH,OAAO,EAAE,eAAe,CAAA;IACxB;;OAEG;IACH,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC/B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAiID;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,EACxB,OAAO,EACP,MAAkB,EAClB,cAAmB,EACnB,OAAoB,EACpB,WAAe,EACf,iBAAwB,EACxB,SAAiB,EACjB,YAAmB,EACnB,aAAa,GACb,EAAE,aAAa,GAAG,SAAS,CAwB3B"}

package/out/map/Geocoder.js

@@ -3,21 +3,6 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   `<Geocoder>` — the WHOLE geocoder, composed. It is the map analogue of `PipelineExplorer`
- *   and takes the SAME DI shape: an injected {@link GeocoderRuntime} (the host owns ONNX / httpvfs / R2 /
- *   the composed map style) plus a {@link GeocoderPanels} bag (the host's ModelVisualizer / VersionCompare /
- *   About / Permalink). Everything here is composition + a `ClientOnly` boundary:
- *
- *     - the floating {@link GeocoderControls} panel (version / compare / backend / query+autocomplete / result),
- *     - the declarative {@link MapCanvas} 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 useGeocode} (parse + viewport bias + map place),
- *       {@link usePlaceAutocomplete}, {@link useCompareState}.
- *
- *   Because it pulls {@link MapCanvas} (→ `react-map-gl` → `maplibre-gl`, WebGL + DOM at import), it lives on
- *   the `@mailwoman/react/map` subpath ONLY — never the package root. The whole thing renders in Storybook
- *   over a fake runtime (offline stub style + canned geocode) with no network, no ONNX, no gazetteer.
  */
 import { useCallback, useEffect, useRef, useState } from "react";
 import { useCompareState } from "#map/useCompareState";
@@ -26,32 +11,32 @@ import { useMapPlaceRender } from "#map/useMapPlaceRender";
 import { usePlaceAutocomplete } from "#map/usePlaceAutocomplete";
 import { ClientOnly } from "../common/ClientOnly.js";
 import { GeocoderControls } from "./GeocoderControls.js";
+import { GraticuleLayer } from "./GraticuleLayer.js";
 import { MapCanvas } from "./MapCanvas.js";
 import { OverlayLayers } from "./OverlayLayers.js";
 import { ResolvedPlaceLayers } from "./ResolvedPlaceLayers.js";
-function GeocoderInner({ runtime, panels, defaultAddress, presets, minBiasZoom, applyResultCamera, developer, onSubmitQuery, }) {
+function GeocoderInner({ runtime, panels, defaultAddress, presets, minBiasZoom, applyResultCamera, developer, initialQuery, onSubmitQuery, }) {
     const mapRef = useRef(null);
-    // The chrome sits OUTSIDE `<MapCanvas>`, so it cannot take the handle from `useMap()`. A ref alone does not
-    // re-render the compass or the layer control when the map arrives, so the same poll that publishes the test
-    // handle also puts it in state — one poll, two consumers.
+    // The controls render outside `<MapCanvas>` and cannot call `useMap()`.
+    // The map is kept in state so they re-render when it loads.
     const [map, setMap] = useState(null);
-    // The map announces itself; nothing polls for it. `onLoad` carries the instance, so the compass and the layer
-    // control render on the frame the map is ready rather than up to an interval later.
-    //
-    // TEST INJECTION POINT: the e2e viewport-bias suite drives the REAL map (pan + zoom past the bias threshold)
-    // before submitting, and a browser test cannot reach a React ref — so the same handle is republished on
-    // `globalThis.__mailwomanMapCanvas`, and cleared on unmount so a torn-down geocoder leaves no stale handle.
+    // The graticule is inserted before the first non-background layer, so it draws under the data layers.
+    const [baseLayerID, setBaseLayerID] = useState(undefined);
+    // Overlays are inserted before the first label layer, so place names stay readable over a fill.
+    const [labelLayerID, setLabelLayerID] = useState(undefined);
     const onMapLoad = useCallback((event) => {
+        // Browser tests read the map from this global.
         ;
         globalThis.__mailwomanMapCanvas = event.target;
         setMap(event.target);
+        const layers = event.target.getStyle()?.layers ?? [];
+        setBaseLayerID(layers.find((layer) => layer.type !== "background")?.id);
+        setLabelLayerID(layers.find((layer) => layer.type === "symbol")?.id);
     }, []);
     useEffect(() => () => {
         setMap(null);
         delete globalThis.__mailwomanMapCanvas;
     }, []);
-    // Read the viewport bias at submit time — through the map handle, never a threaded state value, so granting/zooming
-    // mid-session doesn't re-create the parse callback. Below the min-bias zoom, a whole-globe center is noise → null.
     const getBias = useCallback(() => {
         const live = mapRef.current?.getMap();
         if (!live)
@@ -74,25 +59,26 @@ function GeocoderInner({ runtime, panels, defaultAddress, presets, minBiasZoom,
         runtime.selectVersion?.(version);
         compare.clearIfPrimary(version);
     }, [runtime, compare]);
-    const onForceWASMChange = useCallback((forceWASM) => runtime.setForceWASM?.(forceWASM), [runtime]);
     return (_jsxs("div", { className: "mw-geocoder-demo", children: [_jsx("div", { className: "mw-geocoder-demo__map", children: _jsxs(MapCanvas, { mapStyle: runtime.mapStyle, mapRef: mapRef, initialViewState: {
                         longitude: runtime.initialCenter[0],
                         latitude: runtime.initialCenter[1],
                         zoom: runtime.initialZoom ?? 3,
                     }, style: { width: "100%", height: "100%" }, 
-                    // One compact attribution pill (the map's own default is a wide, always-open "MapLibre | © …" bar), no
-                    // maplibre wordmark logo.
-                    mapProps: { attributionControl: { compact: true }, maplibreLogo: false, onLoad: onMapLoad }, children: [_jsx(OverlayLayers, { overlays: runtime.overlays }), _jsx(ResolvedPlaceLayers, { spec: spec, applyCamera: applyResultCamera }), panels.mapControls] }) }), _jsx(GeocoderControls, { runtime: runtime, geocode: geocode, autocomplete: autocomplete, compare: compare, panels: panels, presets: presets, placeholder: defaultAddress, map: map, onSubmitQuery: onSubmitQuery, onSelectVersion: onSelectVersion, onForceWASMChange: onForceWASMChange, developer: developer }), panels.debugDrawer ? panels.debugDrawer({ result: geocode.result }) : null] }));
+                    // The attribution is compact.
+                    // The MapLibre logo is hidden.
+                    mapProps: { attributionControl: { compact: true }, maplibreLogo: false, onLoad: onMapLoad }, children: [_jsx(GraticuleLayer, { beforeID: baseLayerID }), _jsx(OverlayLayers, { overlays: runtime.overlays, beforeID: labelLayerID }), _jsx(ResolvedPlaceLayers, { spec: spec, applyCamera: applyResultCamera }), panels.mapControls] }) }), _jsx(GeocoderControls, { runtime: runtime, geocode: geocode, autocomplete: autocomplete, compare: compare, panels: panels, presets: presets, placeholder: defaultAddress, initialQuery: initialQuery, map: map, onSubmitQuery: onSubmitQuery, onSelectVersion: onSelectVersion, developer: developer }), panels.debugDrawer ? panels.debugDrawer({ result: geocode.result }) : null] }));
 }
-/**
- * Stable empty defaults — a fresh `{}`/`[]` per render would churn every downstream memo dep.
- */
+// These defaults are module constants so each render sees the same reference and memo dependencies stay stable.
 const NO_PANELS = {};
 const NO_PRESETS = [];
 /**
- * The composed geocoder, behind a `ClientOnly` SSR boundary (the map is intrinsically a client component).
+ * Renders the map and search controls as one geocoder.
+ * It also renders host panels.
+ *
+ * It renders only on the client because MapLibre needs browser APIs.
+ * Import it from `@mailwoman/react/map`.
  */
-export function Geocoder({ runtime, panels = NO_PANELS, defaultAddress = "", presets = NO_PRESETS, minBiasZoom = 4, applyResultCamera = true, developer = false, onSubmitQuery, }) {
-    return (_jsx(ClientOnly, { fallback: _jsx("div", { className: "mw-geocoder-demo", children: _jsx("p", { children: "Loading the geocoder\u2026" }) }), children: () => (_jsx(GeocoderInner, { runtime: runtime, panels: panels, defaultAddress: defaultAddress, presets: presets, minBiasZoom: minBiasZoom, applyResultCamera: applyResultCamera, developer: developer, onSubmitQuery: onSubmitQuery })) }));
+export function Geocoder({ runtime, panels = NO_PANELS, defaultAddress = "", presets = NO_PRESETS, minBiasZoom = 4, applyResultCamera = true, developer = false, initialQuery = null, onSubmitQuery, }) {
+    return (_jsx(ClientOnly, { fallback: _jsx("div", { className: "mw-geocoder-demo", children: _jsx("p", { children: "Loading the geocoder\u2026" }) }), children: () => (_jsx(GeocoderInner, { runtime: runtime, panels: panels, defaultAddress: defaultAddress, presets: presets, minBiasZoom: minBiasZoom, applyResultCamera: applyResultCamera, developer: developer, initialQuery: initialQuery, onSubmitQuery: onSubmitQuery })) }));
 }
 //# sourceMappingURL=Geocoder.js.map

package/out/map/Geocoder.js.map

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

package/out/map/GeocoderControls.d.ts

@@ -2,15 +2,6 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   The geocoder's chrome over the map: a search pill on top, example chips on one line beneath it, a control column
- *   down the right edge, and a result sheet that rises from the bottom when there is something to show.
- *
- *   It replaces a 400px full-height panel that carried every control at once. The layout is the one the reference
- *   map apps use, and the reason is the map: chrome that floats over it leaves the map the page, where a slab makes
- *   the map the leftover third.
- *
- *   NODE-SAFE: pure React + the shared units, no maplibre.
  */
 import { type ReactNode } from "react";
 import type { MapInstance } from "react-map-gl/maplibre";
@@ -19,63 +10,43 @@ import type { UseCompareState } from "#map/useCompareState";
 import type { UseGeocode } from "#map/useGeocode";
 import type { UsePlaceAutocomplete } from "#map/usePlaceAutocomplete";
 import type { Preset } from "../common/PresetChips.tsx";
+/**
+ * Props for {@linkcode GeocoderControls}.
+ */
 export interface GeocoderControlsProps {
-    /**
-     * The injected geocoder runtime.
-     */
     runtime: GeocoderRuntime;
-    /**
-     * The parse+resolve state machine.
-     */
     geocode: UseGeocode;
-    /**
-     * The place-autocomplete combobox state.
-     */
     autocomplete: UsePlaceAutocomplete;
-    /**
-     * The compare-mode state.
-     */
     compare: UseCompareState;
     /**
-     * Host-injected panels (about, release blurb, compare, permalink, extras, failure).
+     * A query from the URL to run once the runtime is ready.
      */
+    initialQuery?: string | null;
     panels: GeocoderPanels;
-    /**
-     * Example chips.
-     */
     presets: ReadonlyArray<Preset>;
     /**
-     * Input placeholder.
+     * The input placeholder.
+     *
+     * The field also selects its value on focus while it still equals this text.
      */
     placeholder: string;
-    /**
-     * The live map, for the controls that read it: the compass takes its bearing, the host's layer control reads its
-     * style. `null` until react-map-gl instantiates the map.
-     */
     map?: MapInstance | null;
     /**
-     * Fired with the query whenever one is submitted, before the parse starts. The host writes it into the URL; this
-     * package never touches `location`, because the address bar is the app's state, not a control's.
+     * Called before each user-initiated query, so the host can write the query to its URL.
      */
     onSubmitQuery?: (query: string) => void;
-    /**
-     * Select a model version (the composed geocoder also clears a now-colliding compare selection).
-     */
     onSelectVersion: (version: string) => void;
     /**
-     * Toggle the forced WASM backend.
-     */
-    onForceWASMChange: (forceWASM: boolean) => void;
-    /**
-     * Open the developer panel on mount. The model version, the backend readout and compare live inside it: they read on
-     * the model rather than on an address, and above the query field they were the first thing every visitor met.
+     * Whether the developer panel starts open.
      *
-     * @default false
+     * @defaultValue `false`
      */
     developer?: boolean;
 }
 /**
- * The chrome. Everything positioned here floats over the map; nothing occupies a column of the page.
+ * Renders the search and result panels, map control rail and side sheets over the map.
+ *
+ * On narrow screens, users can drag the search panel between bottom-drawer detents.
  */
-export declare function GeocoderControls({ runtime, geocode, autocomplete, compare, panels, presets, placeholder, map, onSubmitQuery, onSelectVersion, onForceWASMChange, developer, }: GeocoderControlsProps): ReactNode;
+export declare function GeocoderControls({ runtime, geocode, autocomplete, compare, panels, presets, placeholder, map, initialQuery, onSubmitQuery, onSelectVersion, developer, }: GeocoderControlsProps): ReactNode;
 //# sourceMappingURL=GeocoderControls.d.ts.map

package/out/map/GeocoderControls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeocoderControls.d.ts","sourceRoot":"","sources":["../../lib/map/GeocoderControls.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAyB,MAAM,OAAO,CAAA;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAGjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAGrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAavD,MAAM,WAAW,qBAAqB;IACrC;;OAEG;IACH,OAAO,EAAE,eAAe,CAAA;IACxB;;OAEG;IACH,OAAO,EAAE,UAAU,CAAA;IACnB;;OAEG;IACH,YAAY,EAAE,oBAAoB,CAAA;IAClC;;OAEG;IACH,OAAO,EAAE,eAAe,CAAA;IACxB;;OAEG;IACH,MAAM,EAAE,cAAc,CAAA;IACtB;;OAEG;IACH,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC9B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IACxB;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC;;OAEG;IACH,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C;;OAEG;IACH,iBAAiB,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAA;IAC/C;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACnB;AAOD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAChC,OAAO,EACP,OAAO,EACP,YAAY,EACZ,OAAO,EACP,MAAM,EACN,OAAO,EACP,WAAW,EACX,GAAU,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,SAAiB,GACjB,EAAE,qBAAqB,GAAG,SAAS,CA2OnC"}
+{"version":3,"file":"GeocoderControls.d.ts","sourceRoot":"","sources":["../../lib/map/GeocoderControls.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,SAAS,EAA4C,MAAM,OAAO,CAAA;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAGjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAGrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAavD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,OAAO,EAAE,eAAe,CAAA;IACxB,OAAO,EAAE,UAAU,CAAA;IACnB,YAAY,EAAE,oBAAoB,CAAA;IAClC,OAAO,EAAE,eAAe,CAAA;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,MAAM,EAAE,cAAc,CAAA;IACtB,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC9B;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IACxB;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACnB;AAoBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAChC,OAAO,EACP,OAAO,EACP,YAAY,EACZ,OAAO,EACP,MAAM,EACN,OAAO,EACP,WAAW,EACX,GAAU,EACV,YAAmB,EACnB,aAAa,EACb,eAAe,EACf,SAAiB,GACjB,EAAE,qBAAqB,GAAG,SAAS,CAshBnC"}