@mailwoman/react 9.3.0 → 10.0.0

package/out/map/types.d.ts

@@ -3,22 +3,23 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   Types for the geocoder-demo map surface. Mirrors the pipeline boundary: the package owns the UI state
- *   machine + the declarative map, while the host injects a {@link DemoRuntime} that owns ONNX / httpvfs
- *   / R2 and the composed map style. {@link DemoRuntime} EXTENDS {@link PipelineRuntime} so the shared
+ *   Types for the geocoder map surface. Mirrors the pipeline boundary: the package owns the UI state
+ *   machine + the declarative map, while the host injects a {@link GeocoderRuntime} that owns ONNX / httpvfs
+ *   / R2 and the composed map style. {@link GeocoderRuntime} EXTENDS {@link PipelineRuntime} so the shared
  *   `runParse` / `parseStageLabels` / `loading` contract is reused, and adds the map-specific surface
  *   (style, overlays, initial center, viewport bias, backend/version selection). Phase 4 adds the
- *   `resolveMapPlace` enricher, the {@link DemoPanels} injection bag, and the {@link DemoCompareContext}.
+ *   `resolveMapPlace` enricher, the {@link GeocoderPanels} injection bag, and the {@link CompareContext}.
  *
  *   The map-spec types are imported type-only from `react-map-gl/maplibre`; nothing here loads maplibre at
- *   runtime, so this module stays node-safe (its concrete-value CONSUMERS — `DemoMap`, `GeocoderDemo` —
+ *   runtime, so this module stays node-safe (its concrete-value CONSUMERS — `MapCanvas`, `Geocoder` —
  *   are the ones behind the `@mailwoman/react/map` subpath).
  */
+import type { ParseResult, ResolvedPlaceView } from "@mailwoman/core/pipeline/client-result";
 import type { ReactNode } from "react";
-import type { LayerSpecification, SourceSpecification } from "react-map-gl/maplibre";
+import type { LayerSpecification, MapInstance, SourceSpecification } from "react-map-gl/maplibre";
 import type { LngLat, ResolvedMapPlace } from "#map/place-render";
-import type { ParseResult, PipelineRuntime, ResolvedPlaceView } from "#pipeline/types";
-import type { DemoMapStyle } from "./DemoMap.tsx";
+import type { PipelineRuntime } from "#pipeline/types";
+import type { MapCanvasStyle } from "./MapCanvas.tsx";
 /**
  * `[longitude, latitude]`.
  *
@@ -84,7 +85,7 @@ export interface Suggestion {
 /**
  * A selectable model bundle (version tag + a display label the picker shows).
  */
-export interface DemoVersionOption {
+export interface VersionOption {
     /**
      * The version tag (e.g. a git tag or model-card version).
      */
@@ -95,21 +96,21 @@ export interface DemoVersionOption {
     label?: string;
 }
 /**
- * Which neural backend the demo is currently running on.
+ * Which neural backend the geocoder is currently running on.
  */
-export type DemoBackend = "webgpu" | "wasm";
+export type InferenceBackend = "webgpu" | "wasm";
 /**
- * The injected demo runtime. Extends {@link PipelineRuntime} (shared `runParse` / `parseStageLabels` / `loading` /
- * `ready`) with the map + version/backend surface the demo needs. The host composes `mapStyle` (via cartographer's
+ * The injected geocoder runtime. Extends {@link PipelineRuntime} (shared `runParse` / `parseStageLabels` / `loading` /
+ * `ready`) with the map + version/backend surface the geocoder needs. The host composes `mapStyle` (via cartographer's
  * `StyleSpecificationComposer` + the tile-worker TileJSON), supplies the overlay specs, the initial center (from
  * geolocation), the FST autocomplete, and the calibrator — nothing in the package imports `@mailwoman/cartographer`,
- * `@mailwoman/neural-web`, httpvfs, or Docusaurus.
+ * `@mailwoman/neural`'s web loader, httpvfs, or Docusaurus.
  */
-export interface DemoRuntime extends PipelineRuntime {
+export interface GeocoderRuntime extends PipelineRuntime {
     /**
      * The composed basemap style (URL or `StyleSpecification`).
      */
-    mapStyle: DemoMapStyle;
+    mapStyle: MapCanvasStyle;
     /**
      * Host-supplied overlays (coverage, race-dots, …).
      */
@@ -123,7 +124,7 @@ export interface DemoRuntime extends PipelineRuntime {
      */
     initialZoom?: number;
     /**
-     * A bias-aware parse. The map demo feeds the current viewport center as a soft prior; when absent the host falls back
+     * A bias-aware parse. The geocoder feeds the current viewport center as a soft prior; when absent the host falls back
      * to the base {@link PipelineRuntime.runParse}. Kept separate so the shared `runParse` contract is unchanged.
      */
     runParseWithBias?: (input: string, bias: MapBias | null, hooks: {
@@ -139,16 +140,16 @@ export interface DemoRuntime extends PipelineRuntime {
     calibrator?: (raw: number) => number | null;
     /**
      * Enrich the selected candidate into the richer {@link ResolvedMapPlace} the declarative map render consumes (bbox,
-     * street tier + uncertainty, a pre-fetched crisp polygon) — the fields that live on the demo's `ResolvedHit` but not
+     * street tier + uncertainty, a pre-fetched crisp polygon) — the fields that live on the host's `ResolvedHit` but not
      * on the shared {@link ResolvedPlaceView}. The host owns this because those extras (and the async polygon fetch in the
-     * real demo) are host/gazetteer concerns; the package keeps {@link ParseResult} unpolluted. Absent → the candidate
+     * real runtime) are host/gazetteer concerns; the package keeps {@link ParseResult} unpolluted. Absent → the candidate
      * renders as a bare point (marker + a mid-zoom fly-to). Returning `null` also renders nothing.
      */
     resolveMapPlace?: (candidate: ResolvedPlaceView, result: ParseResult) => ResolvedMapPlace | null;
     /**
      * The selectable model bundles the version picker offers.
      */
-    availableVersions?: DemoVersionOption[];
+    availableVersions?: VersionOption[];
     /**
      * The currently-selected model version.
      */
@@ -171,9 +172,10 @@ export interface DemoRuntime extends PipelineRuntime {
     setForceWASM?: (forceWASM: boolean) => void;
 }
 /**
- * The compare-mode state a {@link DemoPanels.compare} render-prop receives (the second parse itself stays host-side).
+ * The compare-mode state a {@link GeocoderPanels.compare} render-prop receives (the second parse itself stays
+ * host-side).
  */
-export interface DemoCompareContext {
+export interface CompareContext {
     /**
      * The current primary parse result, or `null` before the first submit.
      */
@@ -188,12 +190,12 @@ export interface DemoCompareContext {
     compareVersion: string | null;
 }
 /**
- * The state a {@link DemoPanels.result} render-prop receives, so a host can render its OWN result block (the docs
+ * The state a {@link GeocoderPanels.result} render-prop receives, so a host can render its OWN result block (a
  * `<ResultPanel>` with its span-highlight / timing / hierarchy / precision detail) in place of the package's default
  * {@link ResultPanel}. Everything the default panel needs is passed through; the candidate-selection state stays owned
- * by the package (`useDemoGeocode`).
+ * by the package (`useGeocode`).
  */
-export interface DemoResultContext {
+export interface ResultContext {
     /**
      * The current parse+resolve result.
      */
@@ -212,14 +214,14 @@ export interface DemoResultContext {
     onSelectCandidate: (index: number) => void;
 }
 /**
- * Host-injected panels for {@link GeocoderDemo}, the map analogue of `PipelinePanels`. Each is an already-rendered
- * `ReactNode` (or a thunk of the parse result / compare state) so the package needs neither the heavy docs visualizers
- * (ModelVisualizer, VersionCompare, AboutDemo, PermalinkButton) nor their data types. Every field is optional — the
- * fake-runtime Storybook stories pass none and still render the whole demo.
+ * Host-injected panels for {@link Geocoder}, the map analogue of `PipelinePanels`. Each is an already-rendered
+ * `ReactNode` (or a thunk of the parse result / compare state) so the package needs neither the heavy host visualizers
+ * (ModelVisualizer, VersionCompare, About, PermalinkButton) nor their data types. Every field is optional — the
+ * fake-runtime Storybook stories pass none and still render the whole geocoder.
  */
-export interface DemoPanels {
+export interface GeocoderPanels {
     /**
-     * Rendered at the top of the control panel (e.g. the docs "About this demo").
+     * Rendered at the top of the control panel (e.g. the host's "About this geocoder").
      */
     header?: ReactNode;
     /**
@@ -231,9 +233,9 @@ export interface DemoPanels {
      */
     footer?: ReactNode;
     /**
-     * A device-location / proximity-bias control, rendered between the query form and the autocomplete list (the demo's
-     * "📍 Use my location" row). Host-owned so the geolocation permission + the bias it feeds into the host's
-     * {@link DemoRuntime.runParseWithBias} stay a host concern.
+     * A device-location / proximity-bias control, rendered between the query form and the autocomplete list (the "📍 Use
+     * my location" row). Host-owned so the geolocation permission + the bias it feeds into the host's
+     * {@link GeocoderRuntime.runParseWithBias} stay a host concern.
      */
     bias?: ReactNode;
     /**
@@ -241,19 +243,25 @@ export interface DemoPanels {
      */
     extras?: (result: ParseResult) => ReactNode;
     /**
-     * Rendered just above the result block (present or empty). The demo's opt-in display toggles live here — calibrated
-     * confidence + dev-mode — because the host owns both the toggle state AND the {@link result} / {@link debugDrawer}
-     * renderers those toggles drive.
+     * Rendered just above the result block (present or empty), for content that reads on THIS answer.
+     *
+     * A control that reads on the model rather than on an address belongs in {@link developerExtras}: above the result it
+     * is the first thing a visitor meets, and on a phone it pushes the answer below the fold.
      */
     aboveResult?: (context: {
         result: ParseResult | null;
     }) => ReactNode;
+    /**
+     * Host controls appended to the Developer sheet — the opt-in display toggles, whose state and the renderers they
+     * drive both belong to the host.
+     */
+    developerExtras?: ReactNode;
     /**
      * Replace the package's default {@link ResultPanel} entirely. When provided, the host renders its own result block
-     * (the docs `<ResultPanel>` — span highlight, timing, hierarchy, precision detail, calibrated confidences) from the
-     * {@link DemoResultContext}. Absent → the built-in panel renders.
+     * (span highlight, timing, hierarchy, precision detail, calibrated confidences) from the {@link ResultContext}. Absent
+     * → the built-in panel renders.
      */
-    result?: (context: DemoResultContext) => ReactNode;
+    result?: (context: ResultContext) => ReactNode;
     /**
      * Rendered in place of the resolved-place panel when nothing resolved (host's FailureDiagnostic). Ignored when
      * {@link result} is set.
@@ -262,7 +270,7 @@ export interface DemoPanels {
     /**
      * The version-compare view — the host renders its own diff from the compare state it owns.
      */
-    compare?: (context: DemoCompareContext) => ReactNode;
+    compare?: (context: CompareContext) => ReactNode;
     /**
      * The model-visualizer / debug drawer, mounted beside the map (host's ModelVisualizer). A render-prop so the host can
      * trace the CURRENT result (its input) — the package passes the live parse result; the host decides on its own
@@ -272,9 +280,19 @@ export interface DemoPanels {
         result: ParseResult | null;
     }) => ReactNode;
     /**
-     * Extra map controls mounted as `<DemoMap>` children (host's DebugControl / LayerToggle via `useControl`).
+     * Extra map controls mounted as `<MapCanvas>` children (host's DebugControl / LayerToggle via `useControl`).
      */
     mapControls?: ReactNode;
+    /**
+     * A layer control, rendered in the chrome's top column under the example chips rather than in a MapLibre corner.
+     *
+     * A render-prop taking the live map handle, because a layer control reads `getStyle().layers` and writes
+     * `setLayoutProperty` — it cannot be a static node. The handle is `null` until the map instantiates, so the host
+     * returns `null` for that first frame rather than rendering an empty control.
+     */
+    layers?: (context: {
+        map: MapInstance | null;
+    }) => ReactNode;
     /**
      * A permalink control for the current address (host's PermalinkButton).
      */

package/out/map/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../lib/map/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../lib/map/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC5F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAEjG,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAA;AAEhC;;GAEG;AACH,MAAM,WAAW,OAAO;IACvB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC3B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IACV;;OAEG;IACH,MAAM,EAAE,mBAAmB,CAAA;IAC3B;;OAEG;IACH,MAAM,EAAE,kBAAkB,EAAE,CAAA;IAC5B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEhD;;;;;;GAMG;AACH,MAAM,WAAW,eAAgB,SAAQ,eAAe;IAEvD;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAA;IACxB;;OAEG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAGpB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,GAAG,IAAI,EACpB,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,KACvC,UAAU,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAA;IAC5C;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IACvD;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;IAC3C;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,KAAK,gBAAgB,GAAG,IAAI,CAAA;IAGhG;;OAEG;IACH,iBAAiB,CAAC,EAAE,aAAa,EAAE,CAAA;IACnC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAA;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B;;OAEG;IACH,MAAM,EAAE,WAAW,GAAG,IAAI,CAAA;IAC1B;;OAEG;IACH,WAAW,EAAE,OAAO,CAAA;IACpB;;OAEG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,MAAM,EAAE,WAAW,CAAA;IACnB;;OAEG;IACH,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC3C;;OAEG;IACH,sBAAsB,EAAE,MAAM,CAAA;IAC9B;;OAEG;IACH,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC9B;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB;;OAEG;IACH,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,CAAA;IAC3C;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAAA;KAAE,KAAK,SAAS,CAAA;IACpE;;;OAGG;IACH,eAAe,CAAC,EAAE,SAAS,CAAA;IAC3B;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,SAAS,CAAA;IAC9C;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,CAAA;IAC5C;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,SAAS,CAAA;IAChD;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAAA;KAAE,KAAK,SAAS,CAAA;IACpE;;OAEG;IACH,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAAA;KAAE,KAAK,SAAS,CAAA;IAC5D;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAA;CACvC"}

package/out/map/types.js

@@ -3,15 +3,15 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   Types for the geocoder-demo map surface. Mirrors the pipeline boundary: the package owns the UI state
- *   machine + the declarative map, while the host injects a {@link DemoRuntime} that owns ONNX / httpvfs
- *   / R2 and the composed map style. {@link DemoRuntime} EXTENDS {@link PipelineRuntime} so the shared
+ *   Types for the geocoder map surface. Mirrors the pipeline boundary: the package owns the UI state
+ *   machine + the declarative map, while the host injects a {@link GeocoderRuntime} that owns ONNX / httpvfs
+ *   / R2 and the composed map style. {@link GeocoderRuntime} EXTENDS {@link PipelineRuntime} so the shared
  *   `runParse` / `parseStageLabels` / `loading` contract is reused, and adds the map-specific surface
  *   (style, overlays, initial center, viewport bias, backend/version selection). Phase 4 adds the
- *   `resolveMapPlace` enricher, the {@link DemoPanels} injection bag, and the {@link DemoCompareContext}.
+ *   `resolveMapPlace` enricher, the {@link GeocoderPanels} injection bag, and the {@link CompareContext}.
  *
  *   The map-spec types are imported type-only from `react-map-gl/maplibre`; nothing here loads maplibre at
- *   runtime, so this module stays node-safe (its concrete-value CONSUMERS — `DemoMap`, `GeocoderDemo` —
+ *   runtime, so this module stays node-safe (its concrete-value CONSUMERS — `MapCanvas`, `Geocoder` —
  *   are the ones behind the `@mailwoman/react/map` subpath).
  */
 export {};

package/out/map/{useDemoGeocode.d.ts → useGeocode.d.ts}

@@ -3,9 +3,9 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `useDemoGeocode` — the parse+resolve state machine for the geocoder map demo. It REUSES the pipeline's
+ *   `useGeocode` — the parse+resolve state machine for the geocoder map. It REUSES the pipeline's
  *   `useParsePipeline` (text / busy / stage / result / candidate selection) and layers on the two map-only
- *   concerns the demo adds over the base explorer:
+ *   concerns the geocoder adds over the base explorer:
  *
  *     1. Viewport bias — when the runtime exposes `runParseWithBias`, the current map center (read through
  *        an injected `getBias`, itself reading the `MapRef`) rides along as a soft proximity prior. The
@@ -18,13 +18,13 @@
  *   callback, so this hook stays independent of the map binding.
  */
 import type { ResolvedMapPlace } from "#map/place-render";
-import type { DemoRuntime, MapBias } from "#map/types";
+import type { GeocoderRuntime, MapBias } from "#map/types";
 import { type UseParsePipeline } from "#pipeline/useParsePipeline";
-export interface UseDemoGeocodeOptions {
+export interface UseGeocodeOptions {
     /**
-     * The injected demo runtime (extends `PipelineRuntime` with the map + bias surface).
+     * The injected geocoder runtime (extends `PipelineRuntime` with the map + bias surface).
      */
-    runtime: DemoRuntime;
+    runtime: GeocoderRuntime;
     /**
      * Address to pre-fill.
      */
@@ -34,11 +34,11 @@ export interface UseDemoGeocodeOptions {
      */
     getBias?: () => MapBias | null;
 }
-export interface UseDemoGeocode extends UseParsePipeline {
+export interface UseGeocode extends UseParsePipeline {
     /**
      * The selected candidate enriched into the map-render shape (bbox / tier / polygon), or `null`.
      */
     mapPlace: ResolvedMapPlace | null;
 }
-export declare function useDemoGeocode({ runtime, defaultText, getBias }: UseDemoGeocodeOptions): UseDemoGeocode;
-//# sourceMappingURL=useDemoGeocode.d.ts.map
+export declare function useGeocode({ runtime, defaultText, getBias }: UseGeocodeOptions): UseGeocode;
+//# sourceMappingURL=useGeocode.d.ts.map

package/out/map/useGeocode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGeocode.d.ts","sourceRoot":"","sources":["../../lib/map/useGeocode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAE1D,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAEpF,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,OAAO,EAAE,eAAe,CAAA;IACxB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI,CAAA;CAC9B;AAED,MAAM,WAAW,UAAW,SAAQ,gBAAgB;IACnD;;OAEG;IACH,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAA;CACjC;AAED,wBAAgB,UAAU,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,iBAAiB,GAAG,UAAU,CAyB3F"}

package/out/map/{useDemoGeocode.js → useGeocode.js}

@@ -3,9 +3,9 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `useDemoGeocode` — the parse+resolve state machine for the geocoder map demo. It REUSES the pipeline's
+ *   `useGeocode` — the parse+resolve state machine for the geocoder map. It REUSES the pipeline's
  *   `useParsePipeline` (text / busy / stage / result / candidate selection) and layers on the two map-only
- *   concerns the demo adds over the base explorer:
+ *   concerns the geocoder adds over the base explorer:
  *
  *     1. Viewport bias — when the runtime exposes `runParseWithBias`, the current map center (read through
  *        an injected `getBias`, itself reading the `MapRef`) rides along as a soft proximity prior. The
@@ -19,7 +19,7 @@
  */
 import { useMemo } from "react";
 import { useParsePipeline } from "#pipeline/useParsePipeline";
-export function useDemoGeocode({ runtime, defaultText, getBias }) {
+export function useGeocode({ runtime, defaultText, getBias }) {
     // Bind the viewport bias into a derived `runParse` so `useParsePipeline` is reused unchanged. When the runtime has no
     // bias-aware parse, pass it straight through.
     const geoRuntime = useMemo(() => {
@@ -41,4 +41,4 @@ export function useDemoGeocode({ runtime, defaultText, getBias }) {
     }, [pipeline.selectedCandidate, pipeline.result, runtime]);
     return { ...pipeline, mapPlace };
 }
-//# sourceMappingURL=useDemoGeocode.js.map
+//# sourceMappingURL=useGeocode.js.map

package/out/map/useGeocode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGeocode.js","sourceRoot":"","sources":["../../lib/map/useGeocode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAK/B,OAAO,EAAE,gBAAgB,EAAyB,MAAM,4BAA4B,CAAA;AAwBpF,MAAM,UAAU,UAAU,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAqB;IAC9E,sHAAsH;IACtH,8CAA8C;IAC9C,MAAM,UAAU,GAAG,OAAO,CAAkB,GAAG,EAAE;QAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAA;QAEzC,IAAI,CAAC,QAAQ;YAAE,OAAO,OAAO,CAAA;QAE7B,OAAO;YACN,GAAG,OAAO;YACV,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,KAAK,CAAC;SACvE,CAAA;IACF,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;IAEtB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAA;IAEvE,MAAM,QAAQ,GAAG,OAAO,CAA0B,GAAG,EAAE;QACtD,IAAI,CAAC,QAAQ,CAAC,iBAAiB,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAO,IAAI,CAAA;QAEhE,OAAO,OAAO,CAAC,eAAe;YAC7B,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC;YACtE,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAA;IAC9B,CAAC,EAAE,CAAC,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAE1D,OAAO,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,CAAA;AACjC,CAAC"}

package/out/map/useMapBearing.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `useMapBearing` — the map's rotation as React state, for a compass that appears off north and fades back.
+ *
+ *   The map is an external store, so it is read through `useSyncExternalStore` rather than mirrored into state by an
+ *   effect: the bearing is a number, which makes a stable snapshot, and React tears nothing during a concurrent
+ *   render.
+ *
+ *   It listens on `rotate` rather than `rotateend`, because the needle has to track the gesture rather than snap once
+ *   the gesture is over. `move` is subscribed too: a `flyTo` or an `easeTo` carrying a bearing rotates the map without
+ *   firing a rotate event, and a compass that misses those stays pointing north over a turned map.
+ */
+import type { MapInstance } from "react-map-gl/maplibre";
+export interface UseMapBearing {
+    /**
+     * Degrees off north, as MapLibre reports it. Zero while there is no map.
+     */
+    bearing: number;
+    /**
+     * Rotate the map back to north. A no-op while there is no map.
+     */
+    resetNorth: () => void;
+}
+export declare function useMapBearing(map: MapInstance | null): UseMapBearing;
+//# sourceMappingURL=useMapBearing.d.ts.map

package/out/map/useMapBearing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMapBearing.d.ts","sourceRoot":"","sources":["../../lib/map/useMapBearing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,UAAU,EAAE,MAAM,IAAI,CAAA;CACtB;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,GAAG,aAAa,CAyBpE"}

package/out/map/useMapBearing.js

@@ -0,0 +1,35 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `useMapBearing` — the map's rotation as React state, for a compass that appears off north and fades back.
+ *
+ *   The map is an external store, so it is read through `useSyncExternalStore` rather than mirrored into state by an
+ *   effect: the bearing is a number, which makes a stable snapshot, and React tears nothing during a concurrent
+ *   render.
+ *
+ *   It listens on `rotate` rather than `rotateend`, because the needle has to track the gesture rather than snap once
+ *   the gesture is over. `move` is subscribed too: a `flyTo` or an `easeTo` carrying a bearing rotates the map without
+ *   firing a rotate event, and a compass that misses those stays pointing north over a turned map.
+ */
+import { useCallback, useSyncExternalStore } from "react";
+export function useMapBearing(map) {
+    const subscribe = useCallback((onChange) => {
+        if (!map)
+            return () => undefined;
+        map.on("rotate", onChange);
+        map.on("move", onChange);
+        return () => {
+            map.off("rotate", onChange);
+            map.off("move", onChange);
+        };
+    }, [map]);
+    // The server snapshot is the same reading: there is no map during a server render, and north is what a compass
+    // shows when it has nothing to report.
+    const readBearing = useCallback(() => map?.getBearing() ?? 0, [map]);
+    const bearing = useSyncExternalStore(subscribe, readBearing, () => 0);
+    const resetNorth = useCallback(() => map?.easeTo({ bearing: 0, pitch: 0 }), [map]);
+    return { bearing, resetNorth };
+}
+//# sourceMappingURL=useMapBearing.js.map

package/out/map/useMapBearing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMapBearing.js","sourceRoot":"","sources":["../../lib/map/useMapBearing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAA;AAczD,MAAM,UAAU,aAAa,CAAC,GAAuB;IACpD,MAAM,SAAS,GAAG,WAAW,CAC5B,CAAC,QAAoB,EAAE,EAAE;QACxB,IAAI,CAAC,GAAG;YAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAA;QAEhC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;QAC1B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAExB,OAAO,GAAG,EAAE;YACX,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;YAC3B,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC1B,CAAC,CAAA;IACF,CAAC,EACD,CAAC,GAAG,CAAC,CACL,CAAA;IAED,+GAA+G;IAC/G,uCAAuC;IACvC,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;IAEpE,MAAM,OAAO,GAAG,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;IAErE,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;IAElF,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAA;AAC/B,CAAC"}

package/out/map/useMapLabelPick.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `useMapLabelPick` — clicking a place label on the map searches for it, the way the reference map apps behave.
+ *
+ *   A label on a map looks like a link, so a visitor clicks it. Without this the click reaches the map's pan handler
+ *   and nothing happens, which reads as the label being decoration.
+ *
+ *   It reads the label's OWN name from the rendered feature rather than reverse-geocoding the click point: the name
+ *   is what the visitor pointed at, and a lookup by coordinate answers whatever is nearest instead, which on a dense
+ *   basemap is regularly not the thing under the cursor.
+ *
+ *   THE QUERY IS SCOPED, AND THE HOVER QUERY IS THROTTLED. `queryRenderedFeatures` with no `layers` walks the whole
+ *   style: measured at 64.3 ms per call returning 4,819 features over the 79-layer basemap at zoom 14 in Manhattan,
+ *   against 4.9 ms and 44 features scoped to that style's 11 label layers. At one call per pointer move the unscoped
+ *   form is the map's whole frame budget, so the layer list is resolved once per style and the hover query runs at
+ *   most once per animation frame. The click query is not throttled — there is one of those per click.
+ */
+import type { MapInstance } from "react-map-gl/maplibre";
+export declare function useMapLabelPick(map: MapInstance | null, onPick: (name: string) => void): void;
+//# sourceMappingURL=useMapLabelPick.d.ts.map

package/out/map/useMapLabelPick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMapLabelPick.d.ts","sourceRoot":"","sources":["../../lib/map/useMapLabelPick.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,uBAAuB,CAAA;AA2C5E,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAyD7F"}

package/out/map/useMapLabelPick.js

@@ -0,0 +1,104 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `useMapLabelPick` — clicking a place label on the map searches for it, the way the reference map apps behave.
+ *
+ *   A label on a map looks like a link, so a visitor clicks it. Without this the click reaches the map's pan handler
+ *   and nothing happens, which reads as the label being decoration.
+ *
+ *   It reads the label's OWN name from the rendered feature rather than reverse-geocoding the click point: the name
+ *   is what the visitor pointed at, and a lookup by coordinate answers whatever is nearest instead, which on a dense
+ *   basemap is regularly not the thing under the cursor.
+ *
+ *   THE QUERY IS SCOPED, AND THE HOVER QUERY IS THROTTLED. `queryRenderedFeatures` with no `layers` walks the whole
+ *   style: measured at 64.3 ms per call returning 4,819 features over the 79-layer basemap at zoom 14 in Manhattan,
+ *   against 4.9 ms and 44 features scoped to that style's 11 label layers. At one call per pointer move the unscoped
+ *   form is the map's whole frame budget, so the layer list is resolved once per style and the hover query runs at
+ *   most once per animation frame. The click query is not throttled — there is one of those per click.
+ */
+import { useEffect, useEffectEvent } from "react";
+/**
+ * The layers whose features carry a place name. Protomaps names its label layers `<theme>_label` and its settlement
+ * layers `places_*`; anything else in the style is geometry, not a label a visitor can read and point at.
+ */
+const LABEL_LAYER = /_label|^places_/;
+/**
+ * Properties a label carries its text under, in the order they are trusted. `name` is protomaps' own; the localized
+ * variants appear on styles built for a specific script.
+ */
+const NAME_KEYS = ["name", "name:en", "name_en"];
+/**
+ * The style's label layers, by id.
+ *
+ * A style with none answers an EMPTY ARRAY, and the caller must treat that as "no labels to pick" rather than passing
+ * it to `queryRenderedFeatures` — an empty `layers` option is not the same as an absent one there, and the difference
+ * between "this style has no labels" and "query everything" is the 64 ms this hook exists to avoid.
+ */
+function labelLayerIDs(map) {
+    const layers = map.getStyle()?.layers ?? [];
+    return layers.map((layer) => layer.id).filter((id) => LABEL_LAYER.test(id));
+}
+function labelNameAt(map, point, layers) {
+    if (!layers.length)
+        return null;
+    // `queryRenderedFeatures` answers in paint order with the topmost first, which is the label drawn over the others
+    // and therefore the one a click landed on.
+    for (const feature of map.queryRenderedFeatures(point, { layers })) {
+        for (const key of NAME_KEYS) {
+            const value = feature.properties?.[key];
+            if (typeof value === "string" && value.trim())
+                return value;
+        }
+    }
+    return null;
+}
+export function useMapLabelPick(map, onPick) {
+    // The subscription depends on the MAP alone. `useGeocode` returns a fresh object every render, so a callback built
+    // from it is new every render too — with `onPick` in the dependency list these map listeners were torn down and
+    // re-added on every keystroke in the search field. `useEffectEvent` is the shape for exactly this: an event
+    // handler that always sees the latest props without being a reactive dependency.
+    const pick = useEffectEvent((name) => onPick(name));
+    useEffect(() => {
+        if (!map)
+            return;
+        // Recomputed when the style swaps (a theme change, a version switch) and not once per pointer move.
+        let layers = labelLayerIDs(map);
+        const readLayers = () => {
+            layers = labelLayerIDs(map);
+        };
+        const onClick = (event) => {
+            const name = labelNameAt(map, event.point, layers);
+            if (name) {
+                pick(name);
+            }
+        };
+        let frame = 0;
+        const onMove = (event) => {
+            if (frame)
+                return;
+            frame = requestAnimationFrame(() => {
+                frame = 0;
+                const canvas = map.getCanvas();
+                // The drag cursor belongs to the pan gesture; overriding it mid-drag would fight the map for the pointer.
+                if (canvas.style.cursor === "grabbing")
+                    return;
+                canvas.style.cursor = labelNameAt(map, event.point, layers) ? "pointer" : "";
+            });
+        };
+        map.on("styledata", readLayers);
+        map.on("click", onClick);
+        map.on("mousemove", onMove);
+        return () => {
+            if (frame) {
+                cancelAnimationFrame(frame);
+            }
+            map.off("styledata", readLayers);
+            map.off("click", onClick);
+            map.off("mousemove", onMove);
+            map.getCanvas().style.cursor = "";
+        };
+    }, [map]);
+}
+//# sourceMappingURL=useMapLabelPick.js.map

package/out/map/useMapLabelPick.js.map

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

package/out/pipeline/CandidatePicker.d.ts

@@ -6,8 +6,8 @@
  *   `CandidatePicker` — the ranked list of alternate gazetteer candidates; clicking one selects it.
  *   Presentational; the selected index is owned by the caller (the pipeline hook).
  */
+import type { ResolvedPlaceView } from "@mailwoman/core/pipeline/client-result";
 import type { ReactNode } from "react";
-import type { ResolvedPlaceView } from "#pipeline/types";
 export interface CandidatePickerProps {
     candidates: ResolvedPlaceView[];
     selectedIndex: number;

package/out/pipeline/CandidatePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CandidatePicker.d.ts","sourceRoot":"","sources":["../../lib/pipeline/CandidatePicker.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAExD,MAAM,WAAW,oBAAoB;IACpC,UAAU,EAAE,iBAAiB,EAAE,CAAA;IAC/B,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC;AAED,wBAAgB,eAAe,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,oBAAoB,GAAG,SAAS,CAwBxG"}
+{"version":3,"file":"CandidatePicker.d.ts","sourceRoot":"","sources":["../../lib/pipeline/CandidatePicker.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,MAAM,WAAW,oBAAoB;IACpC,UAAU,EAAE,iBAAiB,EAAE,CAAA;IAC/B,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC;AAED,wBAAgB,eAAe,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,oBAAoB,GAAG,SAAS,CAwBxG"}

package/out/pipeline/CandidatePicker.js

@@ -1,4 +1,4 @@
-import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { cx } from "#common/cx";
 export function CandidatePicker({ candidates, selectedIndex, onSelect }) {
     return (_jsxs("div", { className: "mw-candidates", children: [_jsxs("h2", { children: ["Other candidates (", candidates.length - 1, ")"] }), _jsx("ol", { className: "mw-candidates__list", children: candidates.map((candidate, i) => (_jsx("li", { children: _jsxs("button", { type: "button", className: cx("mw-candidates__btn", { "mw-candidates__btn--active": i === selectedIndex }), onClick: () => onSelect(i), title: `${candidate.placetype} • WOF ${candidate.id} • score ${candidate.score.toFixed(3)}`, children: [_jsxs("span", { className: "mw-candidates__rank", children: ["#", i + 1] }), _jsx("span", { className: "mw-candidates__name", children: candidate.name }), _jsxs("span", { className: "mw-candidates__meta", children: [candidate.placetype, " \u00B7 ", candidate.score.toFixed(2)] })] }) }, `${candidate.id}-${i}`))) })] }));

package/out/pipeline/CandidatePicker.js.map

@@ -1 +1 @@
-{"version":3,"file":"CandidatePicker.js","sourceRoot":"","sources":["../../lib/pipeline/CandidatePicker.tsx"],"names":[],"mappings":";AAWA,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAS/B,MAAM,UAAU,eAAe,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAwB;IAC5F,OAAO,CACN,eAAK,SAAS,EAAC,eAAe,aAC7B,+CAAuB,UAAU,CAAC,MAAM,GAAG,CAAC,SAAO,EACnD,aAAI,SAAS,EAAC,qBAAqB,YACjC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,CACjC,uBACC,kBACC,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,EAAE,CAAC,oBAAoB,EAAE,EAAE,4BAA4B,EAAE,CAAC,KAAK,aAAa,EAAE,CAAC,EAC1F,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAC1B,KAAK,EAAE,GAAG,SAAS,CAAC,SAAS,UAAU,SAAS,CAAC,EAAE,YAAY,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,aAE3F,gBAAM,SAAS,EAAC,qBAAqB,kBAAG,CAAC,GAAG,CAAC,IAAQ,EACrD,eAAM,SAAS,EAAC,qBAAqB,YAAE,SAAS,CAAC,IAAI,GAAQ,EAC7D,gBAAM,SAAS,EAAC,qBAAqB,aACnC,SAAS,CAAC,SAAS,cAAK,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAC7C,IACC,IAZD,GAAG,SAAS,CAAC,EAAE,IAAI,CAAC,EAAE,CAa1B,CACL,CAAC,GACE,IACA,CACN,CAAA;AACF,CAAC"}
+{"version":3,"file":"CandidatePicker.js","sourceRoot":"","sources":["../../lib/pipeline/CandidatePicker.tsx"],"names":[],"mappings":";AAYA,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAQ/B,MAAM,UAAU,eAAe,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAwB;IAC5F,OAAO,CACN,eAAK,SAAS,EAAC,eAAe,aAC7B,+CAAuB,UAAU,CAAC,MAAM,GAAG,CAAC,SAAO,EACnD,aAAI,SAAS,EAAC,qBAAqB,YACjC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,CACjC,uBACC,kBACC,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,EAAE,CAAC,oBAAoB,EAAE,EAAE,4BAA4B,EAAE,CAAC,KAAK,aAAa,EAAE,CAAC,EAC1F,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAC1B,KAAK,EAAE,GAAG,SAAS,CAAC,SAAS,UAAU,SAAS,CAAC,EAAE,YAAY,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,aAE3F,gBAAM,SAAS,EAAC,qBAAqB,kBAAG,CAAC,GAAG,CAAC,IAAQ,EACrD,eAAM,SAAS,EAAC,qBAAqB,YAAE,SAAS,CAAC,IAAI,GAAQ,EAC7D,gBAAM,SAAS,EAAC,qBAAqB,aACnC,SAAS,CAAC,SAAS,cAAK,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAC7C,IACC,IAZD,GAAG,SAAS,CAAC,EAAE,IAAI,CAAC,EAAE,CAa1B,CACL,CAAC,GACE,IACA,CACN,CAAA;AACF,CAAC"}

package/out/pipeline/ComponentTable.d.ts

@@ -5,8 +5,8 @@
  *
  *   `ComponentTable` — the tag / value / confidence table of decoded components. Presentational.
  */
+import type { ParsedComponent } from "@mailwoman/core/pipeline/client-result";
 import type { ReactNode } from "react";
-import type { ParsedComponent } from "#pipeline/types";
 export interface ComponentTableProps {
     nodes: ParsedComponent[];
 }

package/out/pipeline/ComponentTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentTable.d.ts","sourceRoot":"","sources":["../../lib/pipeline/ComponentTable.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAItD,MAAM,WAAW,mBAAmB;IACnC,KAAK,EAAE,eAAe,EAAE,CAAA;CACxB;AAED,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,EAAE,mBAAmB,GAAG,SAAS,CAuBxE"}
+{"version":3,"file":"ComponentTable.d.ts","sourceRoot":"","sources":["../../lib/pipeline/ComponentTable.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,MAAM,WAAW,mBAAmB;IACnC,KAAK,EAAE,eAAe,EAAE,CAAA;CACxB;AAED,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,EAAE,mBAAmB,GAAG,SAAS,CAuBxE"}

package/out/pipeline/ComponentTable.js.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentTable.js","sourceRoot":"","sources":["../../lib/pipeline/ComponentTable.tsx"],"names":[],"mappings":";AAYA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAsB,CAAA;AAMrD,MAAM,UAAU,cAAc,CAAC,EAAE,KAAK,EAAuB;IAC5D,OAAO,CACN,iBAAO,SAAS,EAAC,eAAe,aAC/B,0BACC,yBACC,+BAAY,EACZ,iCAAc,EACd,sCAAmB,IACf,GACE,EACR,0BACE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CACvB,yBACC,uBAAK,IAAI,CAAC,GAAG,GAAM,EACnB,uBAAK,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,GAAM,EACnC,uBACC,KAAC,cAAc,IAAC,UAAU,EAAE,IAAI,CAAC,UAAU,GAAI,GAC3C,KALG,CAAC,CAML,CACL,CAAC,GACK,IACD,CACR,CAAA;AACF,CAAC"}
+{"version":3,"file":"ComponentTable.js","sourceRoot":"","sources":["../../lib/pipeline/ComponentTable.tsx"],"names":[],"mappings":";AAWA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAsB,CAAA;AAMrD,MAAM,UAAU,cAAc,CAAC,EAAE,KAAK,EAAuB;IAC5D,OAAO,CACN,iBAAO,SAAS,EAAC,eAAe,aAC/B,0BACC,yBACC,+BAAY,EACZ,iCAAc,EACd,sCAAmB,IACf,GACE,EACR,0BACE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CACvB,yBACC,uBAAK,IAAI,CAAC,GAAG,GAAM,EACnB,uBAAK,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,GAAM,EACnC,uBACC,KAAC,cAAc,IAAC,UAAU,EAAE,IAAI,CAAC,UAAU,GAAI,GAC3C,KALG,CAAC,CAML,CACL,CAAC,GACK,IACD,CACR,CAAA;AACF,CAAC"}