@mailwoman/react 0.0.1 → 7.5.0

package/out/poi/POIExplorer.js

@@ -0,0 +1,43 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @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 { ClientOnly } from "../common/ClientOnly.js";
+import { KindBadge } from "../common/KindBadge.js";
+import { PresetChips } from "../common/PresetChips.js";
+import { AbstainPanel } from "./AbstainPanel.js";
+import { LiveResultsBlock } from "./LiveResultsBlock.js";
+import { OverpassBlock } from "./OverpassBlock.js";
+import { QueryInput } from "./QueryInput.js";
+import { POI_DEFAULT_TEXT, POI_PRESETS } from "./runtime.js";
+import { SubjectPanel } from "./SubjectPanel.js";
+import { usePOISearch } from "./usePOISearch.js";
+function POIExplorerInner({ defaultText, presets, loadRuntime, runLiveSearch, brandLiveSearch, }) {
+    const [text, setText] = useState(defaultText);
+    const { result, liveSearch, searchLive } = usePOISearch({
+        text,
+        loadRuntime,
+        runLiveSearch,
+        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.
+    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] }));
+}
+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 })) }));
+}
+//# sourceMappingURL=POIExplorer.js.map

package/out/poi/POIExplorer.js.map

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

package/out/poi/QueryInput.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `QueryInput` — the labelled text field for the POI explorer. Controlled; presentational only.
+ */
+import type { ReactNode } from "react";
+export interface QueryInputProps {
+    id: string;
+    label: string;
+    value: string;
+    onChange: (value: string) => void;
+    placeholder?: string;
+}
+export declare function QueryInput({ id, label, value, onChange, placeholder }: QueryInputProps): ReactNode;
+//# sourceMappingURL=QueryInput.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QueryInput.d.ts","sourceRoot":"","sources":["../../poi/QueryInput.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,eAAe,GAAG,SAAS,CAOlG"}

package/out/poi/QueryInput.js

@@ -0,0 +1,5 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function QueryInput({ id, label, value, onChange, placeholder }) {
+    return (_jsxs("div", { className: "mw-field", children: [_jsx("label", { htmlFor: id, children: label }), _jsx("input", { id: id, type: "text", value: value, onChange: (e) => onChange(e.target.value), placeholder: placeholder })] }));
+}
+//# sourceMappingURL=QueryInput.js.map

package/out/poi/QueryInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryInput.js","sourceRoot":"","sources":["../../poi/QueryInput.tsx"],"names":[],"mappings":";AAkBA,MAAM,UAAU,UAAU,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAmB;IACtF,OAAO,CACN,eAAK,SAAS,EAAC,UAAU,aACxB,gBAAO,OAAO,EAAE,EAAE,YAAG,KAAK,GAAS,EACnC,gBAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAC,MAAM,EAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,WAAW,GAAI,IAC3G,CACN,CAAA;AACF,CAAC"}

package/out/poi/SubjectPanel.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @copyright Sister Software
+ * @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
+ *   share the match-detail list (matched phrase, confidence, anchor). Presentational.
+ */
+import type { ReactNode } from "react";
+import type { POISubject } from "./types.ts";
+export interface SubjectPanelProps {
+    subject: POISubject;
+}
+export declare function SubjectPanel({ subject }: SubjectPanelProps): ReactNode;
+//# sourceMappingURL=SubjectPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SubjectPanel.d.ts","sourceRoot":"","sources":["../../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;AAkBD,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,iBAAiB,GAAG,SAAS,CA4CtE"}

package/out/poi/SubjectPanel.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/** 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 ? subject.remainder : _jsx("em", { children: "none \u2014 global query" }) })] }));
+}
+export function SubjectPanel({ subject }) {
+    if (subject.kind === "brand") {
+        return (_jsxs(_Fragment, { children: [_jsxs("div", { className: "mw-subject__row", children: [_jsx("span", { className: "mw-subject__chip", children: subject.name }), _jsx("span", { className: "mw-subject__badge mw-subject__badge--brand", children: "brand" }), subject.wikidata ? (_jsx("a", { className: "mw-subject__qid", href: `https://www.wikidata.org/wiki/${subject.wikidata}`, target: "_blank", rel: "noreferrer", children: subject.wikidata })) : null] }), _jsx(MatchDetail, { subject: subject }), _jsx("p", { className: "mw-subject__note", children: "Matched as a chain brand \u2014 resolved by Wikidata QID against the layer's brand index." })] }));
+    }
+    return (_jsxs(_Fragment, { children: [_jsxs("div", { className: "mw-subject__row", children: [_jsx("span", { className: "mw-subject__chip", children: subject.category.label }), subject.buildLocal ? _jsx("span", { className: "mw-subject__badge", children: "build-local" }) : null] }), _jsx(MatchDetail, { subject: subject }), subject.buildLocal ? (_jsx("p", { className: "mw-subject__note", children: "Requires the locally-built OSM layer (ODbL) \u2014 mailwoman ships the builder, not the data." })) : null] }));
+}
+//# sourceMappingURL=SubjectPanel.js.map

package/out/poi/SubjectPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubjectPanel.js","sourceRoot":"","sources":["../../poi/SubjectPanel.tsx"],"names":[],"mappings":";AAkBA,mHAAmH;AACnH,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,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,oDAA4B,GAAM,IAC3E,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

@@ -0,0 +1,43 @@
+/**
+ * @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 "./types.ts";
+/**
+ * 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.
+ *
+ * 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.)
+ */
+export declare function loadPOIRuntime(): Promise<POIRuntime>;
+/** 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";
+    readonly value: "drinking fountain near Springfield";
+}, {
+    readonly label: "Fire hydrant";
+    readonly value: "fire hydrant";
+}, {
+    readonly label: "Hospital + address";
+    readonly value: "hospital, 350 5th Ave, New York";
+}, {
+    readonly label: "Chevron (brand)";
+    readonly value: "chevron near Houston";
+}, {
+    readonly label: "Applebee's (brand)";
+    readonly value: "applebee's near Chicago";
+}];
+export declare const POI_DEFAULT_TEXT: "drinking fountain near Springfield";
+/** `742 m` under 1 km, `1.9 km` past it — matches the demo's distance captions. */
+export declare function formatDistance(distanceM: number): string;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../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,CAgC1D;AAED,+GAA+G;AAC/G,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;EAMd,CAAA;AAEV,eAAO,MAAM,gBAAgB,sCAAuB,CAAA;AAEpD,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIxD"}

package/out/poi/runtime.js

@@ -0,0 +1,67 @@
+/**
+ * @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.
+ *
+ * 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.)
+ */
+export async function loadPOIRuntime() {
+    const [table, brandTable] = await Promise.all([
+        import("@mailwoman/poi-taxonomy/data/taxonomy.json").then((m) => m.default),
+        import("@mailwoman/poi-taxonomy/data/brands.json").then((m) => m.default),
+    ]);
+    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 > 0) {
+            return categoryHits.map((match) => ({
+                kind: "category",
+                categoryID: match.category.id,
+                matchedPhrase: match.matchedPhrase,
+                confidence: match.confidence,
+            }));
+        }
+        return brands.lookupPOIBrand(phrase).map((match) => ({
+            kind: "brand",
+            categoryID: match.brand.name,
+            wikidata: match.brand.wikidata,
+            matchedPhrase: match.matchedPhrase,
+            confidence: match.confidence,
+        }));
+    };
+    return { lookup, lexicon, classify: createKindClassifier({ poiLexicon: lexicon }) };
+}
+/** 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" },
+    { label: "Fire hydrant", value: "fire hydrant" },
+    { label: "Hospital + address", value: "hospital, 350 5th Ave, New York" },
+    { label: "Chevron (brand)", value: "chevron near Houston" },
+    { label: "Applebee's (brand)", value: "applebee's near Chicago" },
+];
+export const POI_DEFAULT_TEXT = POI_PRESETS[0].value;
+/** `742 m` under 1 km, `1.9 km` past it — matches the demo's distance captions. */
+export function formatDistance(distanceM) {
+    if (distanceM < 1000)
+        return `${Math.round(distanceM)} m`;
+    return `${(distanceM / 1000).toFixed(1)} km`;
+}
+//# sourceMappingURL=runtime.js.map

package/out/poi/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../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;IACF,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAiE,CAAC,CAAA;IACzG,MAAM,MAAM,GAAG,oBAAoB,CAAC,UAAmE,CAAC,CAAA;IAExG,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,GAAG,CAAC,EAAE,CAAC;YAC7B,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,+GAA+G;AAC/G,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,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;AAEpD,mFAAmF;AACnF,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

@@ -0,0 +1,113 @@
+/**
+ * @copyright Sister Software
+ * @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 machinery stays out of this
+ *   package's browser graph (it lives in the docs site, which knows where the layer is served).
+ */
+import type { POIPhraseLookup, QueryKindResult } from "@mailwoman/kind-classifier";
+import type { createKindClassifier } from "@mailwoman/kind-classifier";
+import type { createPOITaxonomyLookup } from "@mailwoman/poi-taxonomy/table";
+export type TaxonomyLookup = ReturnType<typeof createPOITaxonomyLookup>;
+export type CategoryRecord = NonNullable<ReturnType<TaxonomyLookup["getPOICategory"]>>;
+/** The lazily-loaded POI runtime: the taxonomy lookup, the adapted lexicon, and the kind classifier over it. */
+export interface POIRuntime {
+    lookup: TaxonomyLookup;
+    lexicon: POIPhraseLookup;
+    classify: ReturnType<typeof createKindClassifier>;
+}
+/** Fields shared by every resolved POI subject, category or brand. */
+export interface POISubjectBase {
+    matchedPhrase: string;
+    confidence: number;
+    /** The non-subject remainder of the query (the location anchor, e.g. "near Springfield"). */
+    remainder: string;
+}
+/** A resolved POI subject that names a taxonomy CATEGORY (`cafe`, `hospital`, `drinking fountain`). */
+export interface POICategorySubject extends POISubjectBase {
+    kind: "category";
+    category: CategoryRecord;
+    /** Whether this category needs the locally-built OSM (ODbL) layer — precomputed off the runtime. */
+    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.
+ */
+export interface POIBrandSubject extends POISubjectBase {
+    kind: "brand";
+    /** The brand's canonical display name. */
+    name: string;
+    /** Wikidata QID, when the lexicon carried one (`Q319642` = Chevron). Absent ⇒ matched by name alone. */
+    wikidata?: string;
+}
+/** A resolved POI subject — a taxonomy category or a chain brand — plus its match metadata. */
+export type POISubject = POICategorySubject | POIBrandSubject;
+/** The intent-only result: the kind verdict plus (when a subject was detected) its OverpassQL export (category only). */
+export interface POIExplorerResult {
+    kindResult: QueryKindResult;
+    subject?: POISubject;
+    overpassQL?: string;
+    overpassError?: string;
+}
+/** One live poi.db hit, as the results list renders it. */
+export interface POISearchHit {
+    name: string;
+    lat: number;
+    lon: number;
+    distanceM: number;
+    country: string;
+    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.
+ */
+export type POILiveSearchResult = {
+    status: "success";
+    hits: POISearchHit[];
+    centerName: string;
+} | {
+    status: "unplaced";
+    anchor: string;
+} | {
+    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).
+ *
+ * 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).
+ */
+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. */
+    brandWikidata?: string;
+}) => Promise<POILiveSearchResult>;
+/** "Search live" state machine. */
+export type LiveSearchState = {
+    status: "idle";
+} | {
+    status: "loading";
+} | {
+    status: "error";
+    message: string;
+} | {
+    status: "success";
+    hits: POISearchHit[];
+    centerName: string;
+};
+/** A single-argument runtime loader — injectable so stories/tests can substitute a mock taxonomy. */
+export type LoadPOIRuntime = () => Promise<POIRuntime>;
+//# sourceMappingURL=types.d.ts.map

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

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

package/out/poi/types.js

@@ -0,0 +1,12 @@
+/**
+ * @copyright Sister Software
+ * @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 machinery stays out of this
+ *   package's browser graph (it lives in the docs site, which knows where the layer is served).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/out/poi/types.js.map

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

package/out/poi/usePOISearch.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @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 "./types.ts";
+export interface UsePOISearchOptions {
+    /** The current query text (controlled by the caller). */
+    text: string;
+    /** Runtime loader. @default loadPOIRuntime */
+    loadRuntime?: LoadPOIRuntime;
+    /** Injected live-search probe. Absent ⇒ the live-results affordance is disabled. */
+    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.
+     */
+    brandLiveSearch?: boolean;
+    /** Debounce before (re)classifying. @default 250 */
+    debounceMs?: number;
+}
+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. */
+    result: POIExplorerResult | null;
+    /** State of the on-demand live poi.db search. */
+    liveSearch: LiveSearchState;
+    /** Whether a live search can run right now (a probe is wired + there's a resolved subject with an anchor). */
+    canSearchLive: boolean;
+    /** Kick off a live search for the current subject. No-op when {@link canSearchLive} is false. */
+    searchLive: () => Promise<void>;
+}
+export declare function usePOISearch({ text, loadRuntime, runLiveSearch, brandLiveSearch, debounceMs, }: UsePOISearchOptions): UsePOISearch;
+//# sourceMappingURL=usePOISearch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePOISearch.d.ts","sourceRoot":"","sources":["../../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,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,WAAW,CAAC,EAAE,cAAc,CAAA;IAC5B,oFAAoF;IACpF,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,YAAY;IAC5B,iDAAiD;IACjD,YAAY,EAAE,OAAO,CAAA;IACrB,oFAAoF;IACpF,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAChC,iDAAiD;IACjD,UAAU,EAAE,eAAe,CAAA;IAC3B,8GAA8G;IAC9G,aAAa,EAAE,OAAO,CAAA;IACtB,iGAAiG;IACjG,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/B;AA2BD,wBAAgB,YAAY,CAAC,EAC5B,IAAI,EACJ,WAA4B,EAC5B,aAAa,EACb,eAAuB,EACvB,UAAgB,GAChB,EAAE,mBAAmB,GAAG,YAAY,CAsJpC"}

package/out/poi/usePOISearch.js

@@ -0,0 +1,158 @@
+/**
+ * @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 { matchPOISubject } from "@mailwoman/kind-classifier";
+import { emitOverpassQL } from "@mailwoman/poi-taxonomy/overpass";
+import { computeQueryShape } from "@mailwoman/query-shape";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { useDebouncedValue } from "../common/useDebouncedValue.js";
+import { loadPOIRuntime } from "./runtime.js";
+/** Compute the OverpassQL export for a matched subject, capturing any emitter error rather than throwing. */
+function buildOverpass(runtime, categoryID, matchedPhrase, remainder) {
+    const category = runtime.lookup.getPOICategory(categoryID);
+    if (!category) {
+        return {};
+    }
+    const intent = {
+        subject: { kind: "category", categoryID, matched: matchedPhrase },
+        ...(remainder ? { anchor: { text: remainder } } : {}),
+    };
+    try {
+        return { overpassQL: emitOverpassQL(intent, category.osmTag ? { osmTag: category.osmTag } : {}) };
+    }
+    catch (err) {
+        return { overpassError: err instanceof Error ? err.message : String(err) };
+    }
+}
+export function usePOISearch({ text, loadRuntime = loadPOIRuntime, runLiveSearch, brandLiveSearch = false, debounceMs = 250, }) {
+    const [runtime, setRuntime] = useState(null);
+    const [result, setResult] = useState(null);
+    const [liveSearch, setLiveSearch] = useState({ status: "idle" });
+    const debouncedText = useDebouncedValue(text, debounceMs);
+    // Capture the loader in a ref so the load fires exactly ONCE on mount, regardless of whether the
+    // caller passes a fresh `loadRuntime` closure each render (an inline `async () => …` would otherwise
+    // retrigger the effect → reload → re-render loop). The runtime is a load-once resource.
+    const loadRuntimeRef = useRef(loadRuntime);
+    loadRuntimeRef.current = loadRuntime;
+    useEffect(() => {
+        let cancelled = false;
+        loadRuntimeRef.current().then((loaded) => {
+            if (!cancelled) {
+                setRuntime(loaded);
+            }
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, []);
+    // Classify the debounced query and derive the subject + OverpassQL (async, so it lives in an effect).
+    useEffect(() => {
+        if (!runtime)
+            return;
+        let cancelled = false;
+        const trimmed = debouncedText.trim();
+        // A new query invalidates live results from the previous one.
+        setLiveSearch({ status: "idle" });
+        if (!trimmed) {
+            setResult(null);
+            return;
+        }
+        const input = { raw: trimmed, normalized: trimmed };
+        const shape = computeQueryShape(trimmed);
+        runtime.classify(input, shape).then((kindResult) => {
+            if (cancelled)
+                return;
+            const matched = kindResult.kind === "poi_query" ? matchPOISubject(trimmed, undefined, runtime.lexicon) : null;
+            if (!matched) {
+                setResult({ kindResult });
+                return;
+            }
+            // Brand subject: the lexicon carries the brand's canonical name as `categoryID` + its Wikidata QID. No category
+            // record, no OverpassQL (brands are searched by QID against the layer's `brand_wikidata` index, not OSM tags).
+            if ((matched.match.kind ?? "category") === "brand") {
+                setResult({
+                    kindResult,
+                    subject: {
+                        kind: "brand",
+                        name: matched.match.categoryID,
+                        ...(matched.match.wikidata ? { wikidata: matched.match.wikidata } : {}),
+                        matchedPhrase: matched.match.matchedPhrase,
+                        confidence: matched.match.confidence,
+                        remainder: matched.remainder,
+                    },
+                });
+                return;
+            }
+            const category = runtime.lookup.getPOICategory(matched.match.categoryID);
+            if (!category) {
+                setResult({ kindResult });
+                return;
+            }
+            setResult({
+                kindResult,
+                subject: {
+                    kind: "category",
+                    category,
+                    matchedPhrase: matched.match.matchedPhrase,
+                    confidence: matched.match.confidence,
+                    remainder: matched.remainder,
+                    buildLocal: runtime.lookup.requiresBuildLocalLayer(category),
+                },
+                ...buildOverpass(runtime, matched.match.categoryID, matched.match.matchedPhrase, matched.remainder),
+            });
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [debouncedText, runtime]);
+    const subject = result?.subject;
+    // A subject is live-searchable when a probe is wired, it has an anchor, and: a CATEGORY that isn't build-local, or a
+    // BRAND with a QID AND a brand-capable probe (`brandLiveSearch`). Brands without a QID / without a brand probe show
+    // the intent + QID chip but no live affordance.
+    const subjectLiveCapable = subject !== undefined &&
+        (subject.kind === "brand" ? brandLiveSearch && subject.wikidata !== undefined : !subject.buildLocal);
+    const canSearchLive = Boolean(runLiveSearch && runtime && subject && subjectLiveCapable && subject.remainder.trim().length > 0);
+    const searchLive = useCallback(async () => {
+        if (!runLiveSearch || !runtime || !subject || !subject.remainder.trim())
+            return;
+        if (subject.kind === "category" ? subject.buildLocal : !(brandLiveSearch && subject.wikidata))
+            return;
+        setLiveSearch({ status: "loading" });
+        try {
+            const outcome = await runLiveSearch(subject.kind === "brand"
+                ? {
+                    categoryID: subject.name,
+                    overtureCategoryIDs: [],
+                    anchor: subject.remainder,
+                    brandWikidata: subject.wikidata,
+                }
+                : {
+                    categoryID: subject.category.id,
+                    // Fan the canonical seed id out over its Overture leaves — the same translation the Node reader uses.
+                    overtureCategoryIDs: runtime.lookup.resolveOvertureCategories(subject.category.id),
+                    anchor: subject.remainder,
+                });
+            if (outcome.status === "success") {
+                setLiveSearch({ status: "success", hits: outcome.hits, centerName: outcome.centerName });
+            }
+            else if (outcome.status === "unplaced") {
+                setLiveSearch({ status: "error", message: `couldn't place "${outcome.anchor}"` });
+            }
+            else {
+                setLiveSearch({ status: "error", message: "the published POI layer isn't reachable" });
+            }
+        }
+        catch {
+            setLiveSearch({ status: "error", message: "the published POI layer isn't reachable" });
+        }
+    }, [runLiveSearch, runtime, subject, brandLiveSearch]);
+    return { runtimeReady: runtime !== null, result, liveSearch, canSearchLive, searchLive };
+}
+//# sourceMappingURL=usePOISearch.js.map

package/out/poi/usePOISearch.js.map

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