@mailwoman/react 10.0.0 → 10.1.0

package/out/poi/POIExplorer.d.ts

@@ -2,38 +2,48 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   `POIExplorer` — the composed POI-intent tester. Detects a POI subject in free text, shows the
- *   category + OverpassQL export, and (when a live-search probe is injected) searches the published
- *   poi.db layer. The intent path is self-contained — no weights, no network. All runtime concerns are
- *   in {@link usePOISearch}; this file is composition + a `ClientOnly` SSR boundary.
  */
 import { type ReactNode } from "react";
 import type { LoadPOIRuntime, POILiveSearch } from "#poi/types";
 import { type Preset } from "../common/PresetChips.tsx";
+/**
+ * Props for {@linkcode POIExplorer}.
+ */
 export interface POIExplorerProps {
     /**
-     * Query to pre-fill in the input.
+     * The query that pre-fills the input.
      */
     defaultText?: string;
     /**
-     * Example chips. @default the built-in POI presets
+     * The example chips.
+     *
+     * @default POI_PRESETS
      */
     presets?: ReadonlyArray<Preset>;
     /**
-     * Override the taxonomy-runtime loader (stories/tests inject a mock).
+     * A replacement loader for the taxonomy runtime, such as a mock in stories and tests.
      */
     loadRuntime?: LoadPOIRuntime;
     /**
-     * Live poi.db probe. Absent ⇒ intent-only (no live-results affordance).
+     * The live poi.db search.
+     * Without it, the explorer shows only the detected intent.
      */
     runLiveSearch?: POILiveSearch;
     /**
-     * Whether {@link runLiveSearch} can serve BRAND subjects (fetch by QID). Default false: a brand subject shows the
-     * intent + QID chip but no live block. The docs' httpvfs probe leaves this off (brand-wide byte-range hydration is
-     * pathological — measured); a server-side backend can enable it.
+     * Whether {@link runLiveSearch} can search brand subjects by Wikidata QID.
+     *
+     * When it is false, a brand subject shows its intent and QID chip without a live block.
+     * A byte-range probe over httpvfs should leave it off because a brand-wide
+     * lookup reads too much of the database.
      */
     brandLiveSearch?: boolean;
 }
+/**
+ * Renders a POI-intent tester that detects a POI subject in free text.
+ *
+ * It shows the matched category or brand and, for categories, an OverpassQL export.
+ * When `runLiveSearch` is set, it can also search the published poi.db.
+ * It renders only on the client.
+ */
 export declare function POIExplorer({ defaultText, presets, loadRuntime, runLiveSearch, brandLiveSearch, }: POIExplorerProps): ReactNode;
 //# sourceMappingURL=POIExplorer.d.ts.map

package/out/poi/POIExplorer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"POIExplorer.d.ts","sourceRoot":"","sources":["../../lib/poi/POIExplorer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAA;AAGhD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAK/D,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAOpE,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC/B;;OAEG;IACH,WAAW,CAAC,EAAE,cAAc,CAAA;IAC5B;;OAEG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;CACzB;AAoED,wBAAgB,WAAW,CAAC,EAC3B,WAA8B,EAC9B,OAAqB,EACrB,WAAW,EACX,aAAa,EACb,eAAe,GACf,EAAE,gBAAgB,GAAG,SAAS,CAoB9B"}
+{"version":3,"file":"POIExplorer.d.ts","sourceRoot":"","sources":["../../lib/poi/POIExplorer.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAA;AAGhD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAK/D,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAOpE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC/B;;OAEG;IACH,WAAW,CAAC,EAAE,cAAc,CAAA;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;CACzB;AAmED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EAC3B,WAA8B,EAC9B,OAAqB,EACrB,WAAW,EACX,aAAa,EACb,eAAe,GACf,EAAE,gBAAgB,GAAG,SAAS,CAoB9B"}

package/out/poi/POIExplorer.js

@@ -3,11 +3,6 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   `POIExplorer` — the composed POI-intent tester. Detects a POI subject in free text, shows the
- *   category + OverpassQL export, and (when a live-search probe is injected) searches the published
- *   poi.db layer. The intent path is self-contained — no weights, no network. All runtime concerns are
- *   in {@link usePOISearch}; this file is composition + a `ClientOnly` SSR boundary.
  */
 import { useState } from "react";
 import { POI_DEFAULT_TEXT, POI_PRESETS } from "#poi/runtime";
@@ -29,14 +24,20 @@ function POIExplorerInner({ defaultText, presets, loadRuntime, runLiveSearch, br
         brandLiveSearch,
     });
     const subject = result?.subject;
-    // The live block appears whenever the subject COULD be live-searched with an anchor — i.e. capable minus the
-    // anchor-present requirement (`canSearchLive` also requires an anchor; the block itself renders the "add an anchor"
-    // hint, so it must show one step earlier). Category: not build-local. Brand: brand-capable probe + a QID.
+    // A category is searchable unless it is build-local.
+    // A brand needs a QID and a brand-capable probe.
     const showLiveBlock = Boolean(runLiveSearch &&
         subject &&
         (subject.kind === "brand" ? brandLiveSearch && subject.wikidata !== undefined : !subject.buildLocal));
     return (_jsxs("div", { className: "mw-poi-explorer", children: [_jsx(QueryInput, { id: "mw-poi-input", label: "Query", value: text, onChange: setText, placeholder: POI_DEFAULT_TEXT }), _jsx(PresetChips, { presets: presets, onPick: setText }), result ? (_jsxs("div", { className: "mw-result", children: [_jsx(KindBadge, { kindResult: result.kindResult }), subject ? (_jsxs(_Fragment, { children: [_jsx(SubjectPanel, { subject: subject }), subject.kind === "category" ? (_jsx(OverpassBlock, { overpassQL: result.overpassQL, overpassError: result.overpassError })) : null, showLiveBlock ? (_jsx(LiveResultsBlock, { subjectLabel: subject.kind === "brand" ? subject.name : subject.category.label, anchor: subject.remainder, state: liveSearch, onSearch: searchLive })) : null] })) : (_jsx(AbstainPanel, { kind: result.kindResult.kind }))] })) : null] }));
 }
+/**
+ * Renders a POI-intent tester that detects a POI subject in free text.
+ *
+ * It shows the matched category or brand and, for categories, an OverpassQL export.
+ * When `runLiveSearch` is set, it can also search the published poi.db.
+ * It renders only on the client.
+ */
 export function POIExplorer({ defaultText = POI_DEFAULT_TEXT, presets = POI_PRESETS, loadRuntime, runLiveSearch, brandLiveSearch, }) {
     return (_jsx(ClientOnly, { fallback: _jsx("div", { className: "mw-poi-explorer", children: _jsx("p", { children: "Loading POI tester\u2026" }) }), children: () => (_jsx(POIExplorerInner, { defaultText: defaultText, presets: presets, loadRuntime: loadRuntime, runLiveSearch: runLiveSearch, brandLiveSearch: brandLiveSearch })) }));
 }

package/out/poi/POIExplorer.js.map

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

package/out/poi/QueryInput.d.ts

@@ -3,7 +3,7 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `QueryInput` — the labelled text field for the POI explorer. Controlled; presentational only.
+ *   `QueryInput` — the labeled text field for the POI explorer. Controlled. presentational only.
  */
 import type { ReactNode } from "react";
 export interface QueryInputProps {

package/out/poi/SubjectPanel.d.ts

@@ -3,8 +3,8 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `SubjectPanel` — renders the detected POI subject. For a CATEGORY: the category chip, the optional
- *   build-local badge + note. For a BRAND: the brand-name chip + a Wikidata QID chip (linked). Both
+ *   `SubjectPanel` — renders the detected POI subject. For a category: the category chip, the optional
+ *   build-local badge + note. For a brand: the brand-name chip + a Wikidata QID chip (linked). Both
  *   share the match-detail list (matched phrase, confidence, anchor). Presentational.
  */
 import type { ReactNode } from "react";

package/out/poi/SubjectPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SubjectPanel.d.ts","sourceRoot":"","sources":["../../lib/poi/SubjectPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,UAAU,CAAA;CACnB;AAoBD,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,iBAAiB,GAAG,SAAS,CA4CtE"}
+{"version":3,"file":"SubjectPanel.d.ts","sourceRoot":"","sources":["../../lib/poi/SubjectPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,UAAU,CAAA;CACnB;AAqBD,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,iBAAiB,GAAG,SAAS,CA4CtE"}

package/out/poi/SubjectPanel.js

@@ -1,6 +1,7 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
- * The shared match-detail list (matched phrase, confidence, anchor) — identical for category + brand subjects.
+ * The shared match-detail list (matched phrase, confidence, anchor) —
+ * identical for category + brand subjects.
  */
 function MatchDetail({ subject }) {
     return (_jsxs("dl", { className: "mw-subject__detail", children: [_jsx("dt", { children: "matched phrase" }), _jsx("dd", { children: _jsx("code", { children: subject.matchedPhrase }) }), _jsx("dt", { children: "confidence" }), _jsxs("dd", { children: [Math.round(subject.confidence * 100), "%"] }), _jsx("dt", { children: "anchor" }), _jsx("dd", { children: subject.remainder || _jsx("em", { children: "none \u2014 global query" }) })] }));

package/out/poi/SubjectPanel.js.map

@@ -1 +1 @@
-{"version":3,"file":"SubjectPanel.js","sourceRoot":"","sources":["../../lib/poi/SubjectPanel.tsx"],"names":[],"mappings":";AAkBA;;GAEG;AACH,SAAS,WAAW,CAAC,EAAE,OAAO,EAAqB;IAClD,OAAO,CACN,cAAI,SAAS,EAAC,oBAAoB,aACjC,0CAAuB,EACvB,uBACC,yBAAO,OAAO,CAAC,aAAa,GAAQ,GAChC,EACL,sCAAmB,EACnB,yBAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC,SAAO,EAChD,kCAAe,EACf,uBAAK,OAAO,CAAC,SAAS,IAAI,oDAA4B,GAAM,IACxD,CACL,CAAA;AACF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAE,OAAO,EAAqB;IAC1D,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO,CACN,8BACC,eAAK,SAAS,EAAC,iBAAiB,aAC/B,eAAM,SAAS,EAAC,kBAAkB,YAAE,OAAO,CAAC,IAAI,GAAQ,EACxD,eAAM,SAAS,EAAC,4CAA4C,sBAAa,EACxE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CACnB,YACC,SAAS,EAAC,iBAAiB,EAC3B,IAAI,EAAE,iCAAiC,OAAO,CAAC,QAAQ,EAAE,EACzD,MAAM,EAAC,QAAQ,EACf,GAAG,EAAC,YAAY,YAEf,OAAO,CAAC,QAAQ,GACd,CACJ,CAAC,CAAC,CAAC,IAAI,IACH,EAEN,KAAC,WAAW,IAAC,OAAO,EAAE,OAAO,GAAI,EAEjC,YAAG,SAAS,EAAC,kBAAkB,0GAE3B,IACF,CACH,CAAA;IACF,CAAC;IAED,OAAO,CACN,8BACC,eAAK,SAAS,EAAC,iBAAiB,aAC/B,eAAM,SAAS,EAAC,kBAAkB,YAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,GAAQ,EACjE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,eAAM,SAAS,EAAC,mBAAmB,4BAAmB,CAAC,CAAC,CAAC,IAAI,IAC9E,EAEN,KAAC,WAAW,IAAC,OAAO,EAAE,OAAO,GAAI,EAEhC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CACrB,YAAG,SAAS,EAAC,kBAAkB,8GAE3B,CACJ,CAAC,CAAC,CAAC,IAAI,IACN,CACH,CAAA;AACF,CAAC"}
+{"version":3,"file":"SubjectPanel.js","sourceRoot":"","sources":["../../lib/poi/SubjectPanel.tsx"],"names":[],"mappings":";AAkBA;;;GAGG;AACH,SAAS,WAAW,CAAC,EAAE,OAAO,EAAqB;IAClD,OAAO,CACN,cAAI,SAAS,EAAC,oBAAoB,aACjC,0CAAuB,EACvB,uBACC,yBAAO,OAAO,CAAC,aAAa,GAAQ,GAChC,EACL,sCAAmB,EACnB,yBAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC,SAAO,EAChD,kCAAe,EACf,uBAAK,OAAO,CAAC,SAAS,IAAI,oDAA4B,GAAM,IACxD,CACL,CAAA;AACF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAE,OAAO,EAAqB;IAC1D,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO,CACN,8BACC,eAAK,SAAS,EAAC,iBAAiB,aAC/B,eAAM,SAAS,EAAC,kBAAkB,YAAE,OAAO,CAAC,IAAI,GAAQ,EACxD,eAAM,SAAS,EAAC,4CAA4C,sBAAa,EACxE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CACnB,YACC,SAAS,EAAC,iBAAiB,EAC3B,IAAI,EAAE,iCAAiC,OAAO,CAAC,QAAQ,EAAE,EACzD,MAAM,EAAC,QAAQ,EACf,GAAG,EAAC,YAAY,YAEf,OAAO,CAAC,QAAQ,GACd,CACJ,CAAC,CAAC,CAAC,IAAI,IACH,EAEN,KAAC,WAAW,IAAC,OAAO,EAAE,OAAO,GAAI,EAEjC,YAAG,SAAS,EAAC,kBAAkB,0GAE3B,IACF,CACH,CAAA;IACF,CAAC;IAED,OAAO,CACN,8BACC,eAAK,SAAS,EAAC,iBAAiB,aAC/B,eAAM,SAAS,EAAC,kBAAkB,YAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,GAAQ,EACjE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,eAAM,SAAS,EAAC,mBAAmB,4BAAmB,CAAC,CAAC,CAAC,IAAI,IAC9E,EAEN,KAAC,WAAW,IAAC,OAAO,EAAE,OAAO,GAAI,EAEhC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CACrB,YAAG,SAAS,EAAC,kBAAkB,8GAE3B,CACJ,CAAC,CAAC,CAAC,IAAI,IACN,CACH,CAAA;AACF,CAAC"}

package/out/poi/runtime.d.ts

@@ -2,26 +2,17 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   The default POI runtime loader + presentation helpers. `loadPOIRuntime` dynamically imports the
- *   ~2k-record Overture taxonomy snapshot (so bundlers code-split it into its own chunk, fetched only
- *   when the explorer actually mounts) and wires the kind classifier over it. Pure + browser-safe: no
- *   network, no DOM — the whole intent path runs offline.
  */
 import type { POIRuntime } from "#poi/types";
 /**
- * Build the POI runtime, dynamically importing the taxonomy + brand JSON so the tables land in their own chunk. A
- * static import would inline the whole snapshot into every consumer's bundle.
+ * Loads the browser POI runtime, importing the taxonomy and brand tables dynamically
+ * so they land in their own chunk instead of every consumer's bundle.
  *
- * The lexicon unions categories then brands, mirroring the Node runtime's `poiTaxonomyLookup` precedence: a phrase that
- * matches a taxonomy CATEGORY wins (the curated set); only on a category miss does the chain-brand table fire,
- * returning a `kind: "brand"` match carrying the brand's canonical name + Wikidata QID. (The Node path also chains
- * `@mailwoman/variant-aliases` regional slang; the browser tester leaves that out — one fewer package + data table for
- * a demo, and the QID-keyed brand table already covers the headline brands.)
+ * Its lexicon tries exact categories and then brands only, a subset of the Node `poiTaxonomyLookup` chain.
  */
 export declare function loadPOIRuntime(): Promise<POIRuntime>;
 /**
- * Default example queries for the POI explorer — a mix of category, build-local, and chain-brand subjects.
+ * Default example queries for the POI explorer — a mix of category, build-local and chain-brand subjects.
  */
 export declare const POI_PRESETS: readonly [{
     readonly label: "Drinking fountain";
@@ -40,7 +31,7 @@ export declare const POI_PRESETS: readonly [{
     readonly value: "applebee's near Chicago";
 }];
 /**
- * Query the POI explorer opens on — the first preset, so the two stay in step.
+ * Holds the query the POI explorer opens on, taken from the first preset so the two stay in step.
  */
 export declare const POI_DEFAULT_TEXT: "drinking fountain near Springfield";
 /**

package/out/poi/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../lib/poi/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;;;;;GASG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,CAiC1D;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;aACrB,KAAK,EAAE,mBAAmB;aAAE,KAAK,EAAE,oCAAoC;;aACvE,KAAK,EAAE,cAAc;aAAE,KAAK,EAAE,cAAc;;aAC5C,KAAK,EAAE,oBAAoB;aAAE,KAAK,EAAE,iCAAiC;;aACrE,KAAK,EAAE,iBAAiB;aAAE,KAAK,EAAE,sBAAsB;;aACvD,KAAK,EAAE,oBAAoB;aAAE,KAAK,EAAE,yBAAyB;EACtD,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,gBAAgB,sCAAuB,CAAA;AAEpD;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIxD"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../lib/poi/runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;GAKG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,CA+B1D;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;aACrB,KAAK,EAAE,mBAAmB;aAAE,KAAK,EAAE,oCAAoC;;aACvE,KAAK,EAAE,cAAc;aAAE,KAAK,EAAE,cAAc;;aAC5C,KAAK,EAAE,oBAAoB;aAAE,KAAK,EAAE,iCAAiC;;aACrE,KAAK,EAAE,iBAAiB;aAAE,KAAK,EAAE,sBAAsB;;aACvD,KAAK,EAAE,oBAAoB;aAAE,KAAK,EAAE,yBAAyB;EACtD,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,gBAAgB,sCAAuB,CAAA;AAEpD;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIxD"}

package/out/poi/runtime.js

@@ -2,23 +2,14 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   The default POI runtime loader + presentation helpers. `loadPOIRuntime` dynamically imports the
- *   ~2k-record Overture taxonomy snapshot (so bundlers code-split it into its own chunk, fetched only
- *   when the explorer actually mounts) and wires the kind classifier over it. Pure + browser-safe: no
- *   network, no DOM — the whole intent path runs offline.
  */
 import { createKindClassifier } from "@mailwoman/kind-classifier";
 import { createPOIBrandLookup, createPOITaxonomyLookup } from "@mailwoman/poi-taxonomy/table";
 /**
- * Build the POI runtime, dynamically importing the taxonomy + brand JSON so the tables land in their own chunk. A
- * static import would inline the whole snapshot into every consumer's bundle.
+ * Loads the browser POI runtime, importing the taxonomy and brand tables dynamically
+ * so they land in their own chunk instead of every consumer's bundle.
  *
- * The lexicon unions categories then brands, mirroring the Node runtime's `poiTaxonomyLookup` precedence: a phrase that
- * matches a taxonomy CATEGORY wins (the curated set); only on a category miss does the chain-brand table fire,
- * returning a `kind: "brand"` match carrying the brand's canonical name + Wikidata QID. (The Node path also chains
- * `@mailwoman/variant-aliases` regional slang; the browser tester leaves that out — one fewer package + data table for
- * a demo, and the QID-keyed brand table already covers the headline brands.)
+ * Its lexicon tries exact categories and then brands only, a subset of the Node `poiTaxonomyLookup` chain.
  */
 export async function loadPOIRuntime() {
     const [table, brandTable] = await Promise.all([
@@ -27,8 +18,6 @@ export async function loadPOIRuntime() {
     ]);
     const lookup = createPOITaxonomyLookup(table);
     const brands = createPOIBrandLookup(brandTable);
-    // Adapt the taxonomy + brand lookups to the `POIPhraseLookup` shape the classifier expects: categories first, brands
-    // on a category miss.
     const lexicon = (phrase, locale) => {
         const categoryHits = lookup.lookupPOICategory(phrase, locale);
         if (categoryHits.length) {
@@ -50,7 +39,7 @@ export async function loadPOIRuntime() {
     return { lookup, lexicon, classify: createKindClassifier({ poiLexicon: lexicon }) };
 }
 /**
- * Default example queries for the POI explorer — a mix of category, build-local, and chain-brand subjects.
+ * Default example queries for the POI explorer — a mix of category, build-local and chain-brand subjects.
  */
 export const POI_PRESETS = [
     { label: "Drinking fountain", value: "drinking fountain near Springfield" },
@@ -60,7 +49,7 @@ export const POI_PRESETS = [
     { label: "Applebee's (brand)", value: "applebee's near Chicago" },
 ];
 /**
- * Query the POI explorer opens on — the first preset, so the two stay in step.
+ * Holds the query the POI explorer opens on, taken from the first preset so the two stay in step.
  */
 export const POI_DEFAULT_TEXT = POI_PRESETS[0].value;
 /**

package/out/poi/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../lib/poi/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEjE,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AAI7F;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IACnC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7C,MAAM,CAAC,4CAA4C,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC3E,MAAM,CAAC,0CAA0C,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;KACzE,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAsD,CAAC,CAAA;IAC9F,MAAM,MAAM,GAAG,oBAAoB,CAAC,UAAwD,CAAC,CAAA;IAE7F,qHAAqH;IACrH,sBAAsB;IACtB,MAAM,OAAO,GAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;QACnD,MAAM,YAAY,GAAG,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAE7D,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;YACzB,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACnC,IAAI,EAAE,UAAU;gBAChB,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE;gBAC7B,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,UAAU,EAAE,KAAK,CAAC,UAAU;aAC5B,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACpD,IAAI,EAAE,OAAO;YACb,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;YAC5B,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ;YAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,UAAU,EAAE,KAAK,CAAC,UAAU;SAC5B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,oBAAoB,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE,CAAA;AACpF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IAC1B,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,oCAAoC,EAAE;IAC3E,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE;IAChD,EAAE,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,iCAAiC,EAAE;IACzE,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,sBAAsB,EAAE;IAC3D,EAAE,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,yBAAyB,EAAE;CACxD,CAAA;AAEV;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;AAEpD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC/C,IAAI,SAAS,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAA;IAEzD,OAAO,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAA;AAC7C,CAAC"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../lib/poi/runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEjE,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AAI7F;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IACnC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7C,MAAM,CAAC,4CAA4C,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC3E,MAAM,CAAC,0CAA0C,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;KACzE,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAsD,CAAC,CAAA;IAC9F,MAAM,MAAM,GAAG,oBAAoB,CAAC,UAAwD,CAAC,CAAA;IAE7F,MAAM,OAAO,GAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;QACnD,MAAM,YAAY,GAAG,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAE7D,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;YACzB,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACnC,IAAI,EAAE,UAAU;gBAChB,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE;gBAC7B,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,UAAU,EAAE,KAAK,CAAC,UAAU;aAC5B,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACpD,IAAI,EAAE,OAAO;YACb,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;YAC5B,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ;YAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,UAAU,EAAE,KAAK,CAAC,UAAU;SAC5B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,oBAAoB,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE,CAAA;AACpF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IAC1B,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,oCAAoC,EAAE;IAC3E,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE;IAChD,EAAE,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,iCAAiC,EAAE;IACzE,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,sBAAsB,EAAE;IAC3D,EAAE,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,yBAAyB,EAAE;CACxD,CAAA;AAEV;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;AAEpD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC/C,IAAI,SAAS,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAA;IAEzD,OAAO,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAA;AAC7C,CAAC"}

package/out/poi/types.d.ts

@@ -3,18 +3,22 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   Types for the POI explorer. The intent path (classification → subject → OverpassQL) is fully
- *   self-contained over the pure `@mailwoman/*` packages; the live poi.db path is expressed only as an
- *   INJECTED async function ({@link POILiveSearch}) so the httpvfs/worker implementation stays out of this
- *   package's browser graph (it lives in the docs site, which knows where the layer is served).
+ *   Types for the POI explorer. Live poi.db search is injected as {@link POILiveSearch} so the httpvfs
+ *   worker stays out of this package's browser graph.
  */
 import type { QueryKindResult } from "@mailwoman/core/pipeline";
 import type { POIPhraseLookup, createKindClassifier } from "@mailwoman/kind-classifier";
 import type { createPOITaxonomyLookup } from "@mailwoman/poi-taxonomy/table";
+/**
+ * The POI taxonomy lookup that the explorer runtime loads.
+ */
 export type TaxonomyLookup = ReturnType<typeof createPOITaxonomyLookup>;
+/**
+ * One taxonomy category record.
+ */
 export type CategoryRecord = NonNullable<ReturnType<TaxonomyLookup["getPOICategory"]>>;
 /**
- * The lazily-loaded POI runtime: the taxonomy lookup, the adapted lexicon, and the kind classifier over it.
+ * The lazily loaded POI runtime holds the taxonomy lookup, the lexicon and the kind classifier.
  */
 export interface POIRuntime {
     lookup: TaxonomyLookup;
@@ -28,25 +32,25 @@ export interface POISubjectBase {
     matchedPhrase: string;
     confidence: number;
     /**
-     * The non-subject remainder of the query (the location anchor, e.g. "near Springfield").
+     * The rest of the query after the subject, usually the location anchor such as "near Springfield".
      */
     remainder: string;
 }
 /**
- * A resolved POI subject that names a taxonomy CATEGORY (`cafe`, `hospital`, `drinking fountain`).
+ * A resolved POI subject that matched a taxonomy category such as `cafe` or `hospital`.
  */
 export interface POICategorySubject extends POISubjectBase {
     kind: "category";
     category: CategoryRecord;
     /**
-     * Whether this category needs the locally-built OSM (ODbL) layer — precomputed off the runtime.
+     * Whether this category requires the locally built OSM (ODbL) layer.
      */
     buildLocal: boolean;
 }
 /**
- * A resolved POI subject that names a chain BRAND (`chevron`, `applebee's`). Brands carry a Wikidata QID and are
- * searched by that QID, NOT by category k-ring — see `@mailwoman/poi-taxonomy`'s brand table + the layer's
- * `brand_wikidata` index.
+ * A resolved POI subject that matched a chain brand such as `chevron`.
+ *
+ * Live search looks up a brand by its Wikidata QID instead of by category k-ring.
  */
 export interface POIBrandSubject extends POISubjectBase {
     kind: "brand";
@@ -55,16 +59,19 @@ export interface POIBrandSubject extends POISubjectBase {
      */
     name: string;
     /**
-     * Wikidata QID, when the lexicon carried one (`Q319642` = Chevron). Absent ⇒ matched by name alone.
+     * The brand's Wikidata QID.
+     * It is absent when the lexicon had no QID for the brand.
      */
     wikidata?: string;
 }
 /**
- * A resolved POI subject — a taxonomy category or a chain brand — plus its match metadata.
+ * A resolved POI subject, either a taxonomy category or a chain brand.
  */
 export type POISubject = POICategorySubject | POIBrandSubject;
 /**
- * The intent-only result: the kind verdict plus (when a subject was detected) its OverpassQL export (category only).
+ * The intent-only result.
+ *
+ * It holds the kind verdict and, when a category subject was detected, its OverpassQL export.
  */
 export interface POIExplorerResult {
     kindResult: QueryKindResult;
@@ -84,8 +91,10 @@ export interface POISearchHit {
     confidence: number;
 }
 /**
- * Result of an injected live search. Preserves the original tester's two failure modes — the anchor not resolving vs
- * the published layer being unreachable — so the UI can word them differently.
+ * The result of an injected live search.
+ *
+ * The `unplaced` and `unavailable` states stay separate so the UI can tell an
+ * unresolved anchor apart from an unreachable layer.
  */
 export type POILiveSearchResult = {
     status: "success";
@@ -98,27 +107,29 @@ export type POILiveSearchResult = {
     status: "unavailable";
 };
 /**
- * The injected live-search function. Given the resolved category (+ its Overture leaf fan-out) and the anchor text, it
- * probes the published poi.db and returns hits. Absent ⇒ the explorer runs intent-only (no "Search live" button).
+ * The injected live-search function.
+ *
+ * It probes the published poi.db for the resolved category, its Overture leaf
+ * categories and the anchor text.
+ * The explorer runs intent-only when this function is absent.
+ *
+ * For a brand subject, `brandWikidata` contains the QID and the probe fetches by it.
+ * In that case `categoryID` holds the brand name and `overtureCategoryIDs` is empty.
  *
- * Brand support is ADDITIVE: when the resolved subject is a chain brand, `brandWikidata` carries its QID and the probe
- * fetches by that QID instead of a category k-ring (`categoryID`/`overtureCategoryIDs` are then the brand name / empty
- * and unused). The category path is byte-identical to before. A probe that can't serve brands simply leaves brand live
- * search unwired at the call site (see `usePOISearch`'s `brandLiveSearch` option) — the docs' httpvfs probe does
- * exactly that, brand-wide row hydration being pathological over byte-range (measured; the brand path is server-side
- * only).
+ * A probe that cannot serve brands should leave `usePOISearch`'s `brandLiveSearch` option unset.
  */
 export type POILiveSearch = (params: {
     categoryID: string;
     overtureCategoryIDs: string[];
     anchor: string;
     /**
-     * Present when the subject is a chain brand — the probe fetches by this QID, not a category k-ring.
+     * The brand's Wikidata QID.
+     * It is present only when the subject is a chain brand.
      */
     brandWikidata?: string;
 }) => Promise<POILiveSearchResult>;
 /**
- * "Search live" state machine.
+ * The state of a "Search live" request.
  */
 export type LiveSearchState = {
     status: "idle";
@@ -133,7 +144,8 @@ export type LiveSearchState = {
     centerName: string;
 };
 /**
- * A single-argument runtime loader — injectable so stories/tests can substitute a mock taxonomy.
+ * A runtime loader.
+ * Stories and tests inject one to substitute a mock taxonomy.
  */
 export type LoadPOIRuntime = () => Promise<POIRuntime>;
 //# sourceMappingURL=types.d.ts.map

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

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

package/out/poi/types.js

@@ -3,10 +3,8 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   Types for the POI explorer. The intent path (classification → subject → OverpassQL) is fully
- *   self-contained over the pure `@mailwoman/*` packages; the live poi.db path is expressed only as an
- *   INJECTED async function ({@link POILiveSearch}) so the httpvfs/worker implementation stays out of this
- *   package's browser graph (it lives in the docs site, which knows where the layer is served).
+ *   Types for the POI explorer. Live poi.db search is injected as {@link POILiveSearch} so the httpvfs
+ *   worker stays out of this package's browser graph.
  */
 export {};
 //# sourceMappingURL=types.js.map

package/out/poi/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../lib/poi/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../lib/poi/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/out/poi/usePOISearch.d.ts

@@ -2,59 +2,70 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   `usePOISearch` — the headless core of the POI explorer. Owns the taxonomy-runtime load, the
- *   debounced classify → subject → OverpassQL derivation, and the "Search live" state machine. The
- *   runtime loader and the live-search probe are both INJECTABLE, so stories/tests drive it with mocks
- *   and no network or db. Presentation is entirely the caller's concern.
  */
 import type { LiveSearchState, LoadPOIRuntime, POIExplorerResult, POILiveSearch } from "#poi/types";
+/**
+ * Options for {@link usePOISearch}.
+ */
 export interface UsePOISearchOptions {
     /**
-     * The current query text (controlled by the caller).
+     * The current query text, owned and updated by the caller.
      */
     text: string;
     /**
-     * Runtime loader. @default loadPOIRuntime
+     * The loader that the hook calls once on mount.
+     * It defaults to `loadPOIRuntime`.
      */
     loadRuntime?: LoadPOIRuntime;
     /**
-     * Injected live-search probe. Absent ⇒ the live-results affordance is disabled.
+     * The live-search probe.
+     * Live search is unavailable when it is absent.
      */
     runLiveSearch?: POILiveSearch;
     /**
-     * Whether the injected probe can serve BRAND subjects (fetch by Wikidata QID). Default false: brand subjects show the
-     * intent + QID chip but no live-search affordance. The docs' httpvfs probe leaves this off — brand-wide row hydration
-     * is pathological over byte-range (measured) — so brand live search is a server-side-backend capability. Category
-     * live search is unaffected either way.
+     * Whether the probe can search for brand subjects by Wikidata ID, defaulting to
+     * false. enable it only for a server-side backend, since fetching every row for
+     * a brand over an HTTP range-request database is too slow.
      */
     brandLiveSearch?: boolean;
     /**
-     * Debounce before (re)classifying. @default 250
+     * The delay in milliseconds before the text is classified.
+     * Defaults to 250.
      */
     debounceMs?: number;
 }
+/**
+ * The state that {@link usePOISearch} returns.
+ */
 export interface UsePOISearch {
     /**
      * True once the taxonomy runtime has loaded.
      */
     runtimeReady: boolean;
     /**
-     * The intent result for the current (debounced) query, or null for empty input.
+     * The classification for the current debounced text, `null` for empty text
+     * and while classification is pending.
      */
     result: POIExplorerResult | null;
     /**
-     * State of the on-demand live poi.db search.
+     * The live-search state for the current debounced text, `idle` until a search runs.
      */
     liveSearch: LiveSearchState;
     /**
-     * Whether a live search can run right now (a probe is wired + there's a resolved subject with an anchor).
+     * Whether a probe is wired and the subject supports live search with a non-empty place anchor.
      */
     canSearchLive: boolean;
     /**
-     * Kick off a live search for the current subject. No-op when {@link canSearchLive} is false.
+     * Starts a live search for the current subject.
+     * It starts no search when `canSearchLive` is false.
      */
     searchLive: () => Promise<void>;
 }
+/**
+ * Classifies debounced query text as a POI category or brand request and runs live searches on demand.
+ *
+ * Each result is keyed to the query that produced it, live search requires a non-empty anchor.
+ * Brands need `brandLiveSearch` plus a Wikidata ID.
+ */
 export declare function usePOISearch({ text, loadRuntime, runLiveSearch, brandLiveSearch, debounceMs, }: UsePOISearchOptions): UsePOISearch;
 //# sourceMappingURL=usePOISearch.d.ts.map

package/out/poi/usePOISearch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePOISearch.d.ts","sourceRoot":"","sources":["../../lib/poi/usePOISearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAc,MAAM,YAAY,CAAA;AAE/G,MAAM,WAAW,mBAAmB;IACnC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,WAAW,CAAC,EAAE,cAAc,CAAA;IAC5B;;OAEG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,YAAY,EAAE,OAAO,CAAA;IACrB;;OAEG;IACH,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAChC;;OAEG;IACH,UAAU,EAAE,eAAe,CAAA;IAC3B;;OAEG;IACH,aAAa,EAAE,OAAO,CAAA;IACtB;;OAEG;IACH,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/B;AA6BD,wBAAgB,YAAY,CAAC,EAC5B,IAAI,EACJ,WAA4B,EAC5B,aAAa,EACb,eAAuB,EACvB,UAAgB,GAChB,EAAE,mBAAmB,GAAG,YAAY,CAkLpC"}
+{"version":3,"file":"usePOISearch.d.ts","sourceRoot":"","sources":["../../lib/poi/usePOISearch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAc,MAAM,YAAY,CAAA;AAE/G;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;;OAGG;IACH,WAAW,CAAC,EAAE,cAAc,CAAA;IAE5B;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAE7B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IAEzB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,YAAY,EAAE,OAAO,CAAA;IAErB;;;OAGG;IACH,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAEhC;;OAEG;IACH,UAAU,EAAE,eAAe,CAAA;IAE3B;;OAEG;IACH,aAAa,EAAE,OAAO,CAAA;IAEtB;;;OAGG;IACH,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/B;AA0BD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAC5B,IAAI,EACJ,WAA4B,EAC5B,aAAa,EACb,eAAuB,EACvB,UAAgB,GAChB,EAAE,mBAAmB,GAAG,YAAY,CA6JpC"}