@mailwoman/react 9.3.0 → 10.0.0

package/lib/pipeline/useParsePipeline.ts

@@ -9,9 +9,10 @@
  *   contract and shapes the UI state.
  */
 
+import type { ParseResult, ResolvedPlaceView } from "@mailwoman/core/pipeline/client-result"
 import { useCallback, useState } from "react"
 
-import type { ParseResult, PipelineRuntime, ResolvedPlaceView } from "#pipeline/types"
+import type { PipelineRuntime } from "#pipeline/types"
 
 export interface UseParsePipelineOptions {
 	runtime: PipelineRuntime
@@ -35,9 +36,12 @@ export interface UseParsePipeline {
 	 */
 	selectedCandidate: ResolvedPlaceView | null
 	/**
-	 * Run a parse for the current text. Safe to bind to a form's `onSubmit`.
+	 * Parse and resolve the current text. Safe to bind to a form's `onSubmit`.
+	 *
+	 * Pass `query` to submit a value the field has not re-rendered with yet — a preset press sets the text and submits in
+	 * one handler, and that state update is not visible to this call.
 	 */
-	submit: () => Promise<void>
+	submit: (query?: string) => Promise<void>
 	/**
 	 * Clear the result (used when a preset replaces the input).
 	 */
@@ -52,24 +56,32 @@ export function useParsePipeline({ runtime, defaultText }: UseParsePipelineOptio
 	const [selectedCandidateIndex, setSelectedCandidateIndex] = useState(0)
 	const [parseError, setParseError] = useState<string | null>(null)
 
-	const submit = useCallback(async () => {
-		if (!runtime.ready || busy) return
+	// `query` exists because `setText` does not reach this closure before the call after it runs. A preset that called
+	// `setText(value)` then `submit()` parsed the PREVIOUS text — the field showed the preset and the map answered the
+	// address before it. A caller that already knows the query passes it; the field's own submit passes nothing.
+	const submit = useCallback(
+		async (query?: string) => {
+			if (!runtime.ready || busy) return
 
-		setBusy(true)
-		setParseStage(0)
-		setParseError(null)
+			const input = query ?? text
 
-		try {
-			const parsed = await runtime.runParse(text, { onStage: setParseStage })
-			setSelectedCandidateIndex(0)
-			setResult(parsed)
-		} catch (error) {
-			setParseError(error instanceof Error ? error.message : String(error))
-		} finally {
-			setBusy(false)
-			setParseStage(-1)
-		}
-	}, [runtime, text, busy])
+			setBusy(true)
+			setParseStage(0)
+			setParseError(null)
+
+			try {
+				const parsed = await runtime.runParse(input, { onStage: setParseStage })
+				setSelectedCandidateIndex(0)
+				setResult(parsed)
+			} catch (error) {
+				setParseError(error instanceof Error ? error.message : String(error))
+			} finally {
+				setBusy(false)
+				setParseStage(-1)
+			}
+		},
+		[runtime, text, busy]
+	)
 
 	const reset = useCallback(() => setResult(null), [])
 

package/lib/poi/index.ts

@@ -0,0 +1,39 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file POI explorer components, hooks, runtime, and contracts.
+ */
+
+export { AbstainPanel } from "./AbstainPanel.tsx"
+export type { AbstainPanelProps } from "./AbstainPanel.tsx"
+export { LiveResultsBlock } from "./LiveResultsBlock.tsx"
+export type { LiveResultsBlockProps } from "./LiveResultsBlock.tsx"
+export { OverpassBlock } from "./OverpassBlock.tsx"
+export type { OverpassBlockProps } from "./OverpassBlock.tsx"
+export { POIExplorer } from "./POIExplorer.tsx"
+export type { POIExplorerProps } from "./POIExplorer.tsx"
+export { QueryInput } from "./QueryInput.tsx"
+export type { QueryInputProps } from "./QueryInput.tsx"
+export { formatDistance, loadPOIRuntime, POI_DEFAULT_TEXT, POI_PRESETS } from "#poi/runtime"
+export { SubjectPanel } from "./SubjectPanel.tsx"
+export type { SubjectPanelProps } from "./SubjectPanel.tsx"
+
+export type {
+	CategoryRecord,
+	LiveSearchState,
+	LoadPOIRuntime,
+	POIBrandSubject,
+	POICategorySubject,
+	POIExplorerResult,
+	POILiveSearch,
+	POILiveSearchResult,
+	POIRuntime,
+	POISearchHit,
+	POISubject,
+	POISubjectBase,
+	TaxonomyLookup,
+} from "#poi/types"
+
+export { usePOISearch } from "#poi/usePOISearch"
+export type { UsePOISearch, UsePOISearchOptions } from "#poi/usePOISearch"

package/lib/poi/types.ts

@@ -9,7 +9,8 @@
  *   package's browser graph (it lives in the docs site, which knows where the layer is served).
  */
 
-import type { POIPhraseLookup, QueryKindResult, createKindClassifier } from "@mailwoman/kind-classifier"
+import type { QueryKindResult } from "@mailwoman/core/pipeline"
+import type { POIPhraseLookup, createKindClassifier } from "@mailwoman/kind-classifier"
 import type { createPOITaxonomyLookup } from "@mailwoman/poi-taxonomy/table"
 
 export type TaxonomyLookup = ReturnType<typeof createPOITaxonomyLookup>

package/lib/runtime/index.ts

@@ -0,0 +1,16 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file Node-safe release-runtime exports.
+ */
+
+export { useReleaseRuntime } from "#runtime/useReleaseRuntime"
+
+export type {
+	AssetsLoadContext,
+	ReleaseBase,
+	ReleaseLoaderState,
+	ReleaseManifest,
+	ReleaseRuntimeConfig,
+} from "#runtime/useReleaseRuntime"

package/lib/runtime/{useDemoRuntime.ts → useReleaseRuntime.ts}

@@ -3,8 +3,8 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `useDemoRuntime` — the headless load-orchestration hook shared by every mailwoman demo surface (the
- *   inline doc-embeds via `DemoEmbed`, and the geocoder map page). It owns the version-selection state
+ *   `useReleaseRuntime` — the headless load-orchestration hook shared by every mailwoman browser surface (the
+ *   inline doc-embeds via `RuntimeEmbed`, and the geocoder). It owns the version-selection state
  *   machine, the per-version load SEQUENCING, cancellation, and the ready / loading / error state — but
  *   NOTHING model- or map-specific. The actual asset fetchers (the ONNX classifier factory, the httpvfs
  *   WOF opener, the FST fetch, the releases.json fetch) are INJECTED by the host as async functions, so
@@ -22,7 +22,7 @@ import { useCallback, useEffect, useMemo, useRef, useState } from "react"
 /**
  * The minimal contract a release-manifest entry must satisfy. Hosts extend this with their own fields.
  */
-export interface DemoReleaseBase {
+export interface ReleaseBase {
 	/**
 	 * The version tag this entry describes (matched against `selectedVersion`).
 	 */
@@ -36,7 +36,7 @@ export interface DemoReleaseBase {
 /**
  * The releases manifest the host fetches — the default version plus the selectable release entries.
  */
-export interface DemoManifest<TRelease extends DemoReleaseBase = DemoReleaseBase> {
+export interface ReleaseManifest<TRelease extends ReleaseBase = ReleaseBase> {
 	/**
 	 * The version selected on first load (before the user picks another).
 	 */
@@ -52,7 +52,7 @@ export interface DemoManifest<TRelease extends DemoReleaseBase = DemoReleaseBase
  * staged step labels/index THROUGH these setters (all no-op once the load is superseded/aborted), while the hook owns
  * the terminal state (revealing the assets + clearing progress on success, surfacing the error on failure).
  */
-export interface DemoAssetsLoadContext {
+export interface AssetsLoadContext {
 	/**
 	 * Aborts when this load is superseded (version/backend switch) or the provider unmounts.
 	 */
@@ -82,18 +82,18 @@ export interface DemoAssetsLoadContext {
 /**
  * The injected loaders the hook orchestrates. Nothing here is model- or map-aware — the host owns all that.
  */
-export interface DemoRuntimeConfig<TAssets, TRelease extends DemoReleaseBase = DemoReleaseBase> {
+export interface ReleaseRuntimeConfig<TAssets, TRelease extends ReleaseBase = ReleaseBase> {
 	/**
-	 * Fetch + normalize the releases manifest. Returns `null` when no manifest is available (the demo then shows nothing
-	 * selectable). Rejecting surfaces `errorMessage`. Runs once on mount.
+	 * Fetch + normalize the releases manifest. Returns `null` when no manifest is available (the surface then shows
+	 * nothing selectable). Rejecting surfaces `errorMessage`. Runs once on mount.
 	 */
-	loadManifest: (signal: AbortSignal) => Promise<DemoManifest<TRelease> | null>
+	loadManifest: (signal: AbortSignal) => Promise<ReleaseManifest<TRelease> | null>
 	/**
 	 * Load the full asset bundle for one release — the classifier, FST, WOF lookup, calibrator, whatever the host needs.
 	 * Runs on every version or `forceWASM` change. Report progress via `ctx`; return the bundle. Rejecting surfaces
 	 * `errorMessage`. Bail early when `ctx.signal.aborted` — the hook discards a superseded result regardless.
 	 */
-	loadAssets: (release: TRelease, ctx: DemoAssetsLoadContext) => Promise<TAssets>
+	loadAssets: (release: TRelease, ctx: AssetsLoadContext) => Promise<TAssets>
 	/**
 	 * The progress line shown before the manifest arrives. @default "Loading releases…"
 	 */
@@ -101,19 +101,17 @@ export interface DemoRuntimeConfig<TAssets, TRelease extends DemoReleaseBase = D
 }
 
 /**
- * The state `useDemoRuntime` produces — the load-orchestration state a demo surface renders + re-projects.
+ * The state `useReleaseRuntime` produces — the load-orchestration state a surface renders + re-projects.
  *
- * NAMING (phase 4): this is the LOADER STATE, deliberately distinct from {@link DemoRuntime} (the injected runtime
- * contract `<GeocoderDemo>` consumes). The two were same-stem before (`UseDemoRuntime` vs `DemoRuntime`); phase 4
- * disambiguates by renaming the loader-state type to `DemoLoaderState`. A host builds a {@link DemoRuntime} by pairing
- * this loader state (assets + backend + version) with the map surface (style, overlays, bias, parse) — see the map
- * subpath's `DemoRuntime`.
+ * This is the LOADER STATE, deliberately distinct from {@link GeocoderRuntime} (the injected runtime contract
+ * `<Geocoder>` consumes). A host builds a {@link GeocoderRuntime} by pairing this loader state (assets + backend +
+ * version) with the map surface (style, overlays, bias, parse) — see the map subpath's `GeocoderRuntime`.
  */
-export interface DemoLoaderState<TAssets, TRelease extends DemoReleaseBase = DemoReleaseBase> {
+export interface ReleaseLoaderState<TAssets, TRelease extends ReleaseBase = ReleaseBase> {
 	/**
 	 * The releases manifest, once fetched.
 	 */
-	manifest: DemoManifest<TRelease> | null
+	manifest: ReleaseManifest<TRelease> | null
 	/**
 	 * The currently-selected version, or `null` before the manifest resolves.
 	 */
@@ -171,12 +169,12 @@ export interface DemoLoaderState<TAssets, TRelease extends DemoReleaseBase = Dem
  * change reloads the bundle via `loadAssets`, the previous load aborted first. The assets are revealed ATOMICALLY when
  * `loadAssets` resolves (so `ready` flips exactly once per load), and consumers wait on `ready`.
  */
-export function useDemoRuntime<TAssets, TRelease extends DemoReleaseBase = DemoReleaseBase>(
-	config: DemoRuntimeConfig<TAssets, TRelease>
-): DemoLoaderState<TAssets, TRelease> {
+export function useReleaseRuntime<TAssets, TRelease extends ReleaseBase = ReleaseBase>(
+	config: ReleaseRuntimeConfig<TAssets, TRelease>
+): ReleaseLoaderState<TAssets, TRelease> {
 	const { initialProgress = "Loading releases…" } = config
 
-	const [manifest, setManifest] = useState<DemoManifest<TRelease> | null>(null)
+	const [manifest, setManifest] = useState<ReleaseManifest<TRelease> | null>(null)
 	const [selectedVersion, setSelectedVersion] = useState<string | null>(null)
 	const [assets, setAssets] = useState<TAssets | null>(null)
 	const [loadingProgress, setLoadingProgress] = useState<string>(initialProgress)
@@ -194,7 +192,7 @@ export function useDemoRuntime<TAssets, TRelease extends DemoReleaseBase = DemoR
 	// Latest manifest for the version-load effect, so it can resolve the release WITHOUT depending on `manifest`
 	// identity — which would double-fire the load the instant the manifest first arrives (the selection transition
 	// null → defaultVersion already fires it once).
-	const manifestRef = useRef<DemoManifest<TRelease> | null>(null)
+	const manifestRef = useRef<ReleaseManifest<TRelease> | null>(null)
 
 	useEffect(() => {
 		loadManifestRef.current = config.loadManifest
@@ -249,7 +247,7 @@ export function useDemoRuntime<TAssets, TRelease extends DemoReleaseBase = DemoR
 				setLoadingStepLabels([])
 				setActiveBackend("")
 
-				const ctx: DemoAssetsLoadContext = {
+				const ctx: AssetsLoadContext = {
 					signal,
 					forceWASM,
 					setProgress: (progress) => guard(() => setLoadingProgress(progress)),

package/out/common/About.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `About` — the explainer for the browser geocoder: the neural model, the confidence colours, the gazetteer
+ *   resolver, the byte-range database and the FST prior. Prose about the product a host places above or beside the
+ *   geocoder; it renders nothing live.
+ */
+import type { ReactNode } from "react";
+export interface AboutProps {
+    /**
+     * Wrap the prose in its own `<details>` disclosure. Set false where the host is already the disclosure — inside a
+     * sheet opened by an About button, a summary repeating that button's words is one control too many.
+     *
+     * @default true
+     */
+    collapsible?: boolean;
+}
+export declare function About({ collapsible }?: AboutProps): ReactNode;
+//# sourceMappingURL=About.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"About.d.ts","sourceRoot":"","sources":["../../lib/common/About.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,WAAW,UAAU;IAC1B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,wBAAgB,KAAK,CAAC,EAAE,WAAkB,EAAE,GAAE,UAAe,GAAG,SAAS,CAkFxE"}

package/out/common/About.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function About({ collapsible = true } = {}) {
+    const body = (_jsxs("div", { className: "mw-about__body", children: [_jsxs("section", { className: "mw-about__section", children: [_jsx("h3", { className: "mw-about__heading", children: "Neural model" }), _jsxs("p", { children: ["A ~29M-parameter BERT-style encoder classifies each token into one of 33 BIO labels covering 16 address components (street, house number, unit, locality, region, postcode, venue, country, intersection, etc.). It runs entirely in your browser via ", _jsx("strong", { children: "onnxruntime-web" }), " (WebGPU with WASM SIMD fallback). The model ships as a 37.6 MB int8-quantized ONNX bundle; fp32 weights are also available for higher accuracy."] })] }), _jsxs("section", { className: "mw-about__section", children: [_jsx("h3", { className: "mw-about__heading", children: "Confidence colors" }), _jsx("p", { children: "Every classified span carries a confidence score between 0 and 1. The colors in the results table give you a quick visual read:" }), _jsxs("ul", { className: "mw-about__legend", children: [_jsxs("li", { className: "mw-about__item", children: [_jsx("span", { className: "mw-about__swatch mw-about__swatch--high" }), _jsx("strong", { children: "Green" }), " (\u2265 0.8) \u2014 high confidence. The model is nearly certain."] }), _jsxs("li", { className: "mw-about__item", children: [_jsx("span", { className: "mw-about__swatch mw-about__swatch--mid" }), _jsx("strong", { children: "Amber" }), " (0.5\u20130.8) \u2014 moderate confidence. Worth verifying."] }), _jsxs("li", { className: "mw-about__item", children: [_jsx("span", { className: "mw-about__swatch mw-about__swatch--low" }), _jsx("strong", { children: "Red" }), " (< 0.5) \u2014 low confidence. The model is unsure \u2014 likely wrong."] })] }), _jsxs("p", { children: ["These are raw model scores. For calibrated probabilities, the library ships a per-locale isotonic calibrator (", _jsx("code", { children: "calibration.json" }), ") that maps the raw scores to well-calibrated probability estimates."] })] }), _jsxs("section", { className: "mw-about__section", children: [_jsx("h3", { className: "mw-about__heading", children: "WOF resolver" }), _jsxs("p", { children: ["After classification, the resolver queries a ", _jsx("strong", { children: "Who's On First" }), " (WOF) SQLite gazetteer to match the parsed components \u2014 locality, region, and postcode \u2014 against real-world places with coordinates. The cascade tries postcode first (most precise), then locality, then the raw input text. The result is a sorted list of candidate places with WOF IDs, placetypes, lat/lon, and bounding boxes."] })] }), _jsxs("section", { className: "mw-about__section", children: [_jsx("h3", { className: "mw-about__heading", children: "Byte-range gazetteer" }), _jsxs("p", { children: ["The gazetteer is a multi-gigabyte SQLite file served from a public bucket. It loads via", " ", _jsx("strong", { children: "sql.js-httpvfs" }), ", which range-requests only the pages a lookup touches, so your browser fetches a few hundred kilobytes per session instead of the whole file."] })] }), _jsxs("section", { className: "mw-about__section", children: [_jsx("h3", { className: "mw-about__heading", children: "FST prior" }), _jsxs("p", { children: ["A ", _jsx("strong", { children: "finite-state transducer" }), " (FST) built from ~94K US place names runs before the neural classifier. It pre-annotates known locality, region, and postcode spans in the input \u2014 places like \"Springfield\" or \"Cook County\" that the FST can match exactly. These \"FST prior\" hits feed the classifier as strong hints, improving locality and region recall on addresses where the neural model alone might miss them. The FST is active whenever the selected release includes it."] })] })] }));
+    if (!collapsible)
+        return body;
+    return (_jsxs("details", { className: "mw-about", children: [_jsxs("summary", { className: "mw-about__summary", children: [_jsx("span", { className: "mw-about__icon", children: "\u2139\uFE0F" }), "About this geocoder"] }), body] }));
+}
+//# sourceMappingURL=About.js.map

package/out/common/About.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"About.js","sourceRoot":"","sources":["../../lib/common/About.tsx"],"names":[],"mappings":";AAsBA,MAAM,UAAU,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,EAAE,GAAe,EAAE;IAC5D,MAAM,IAAI,GAAG,CACZ,eAAK,SAAS,EAAC,gBAAgB,aAC9B,mBAAS,SAAS,EAAC,mBAAmB,aACrC,aAAI,SAAS,EAAC,mBAAmB,6BAAkB,EACnD,kRAGmC,+CAAgC,wJAE/D,IACK,EAEV,mBAAS,SAAS,EAAC,mBAAmB,aACrC,aAAI,SAAS,EAAC,mBAAmB,kCAAuB,EACxD,0JAGI,EACJ,cAAI,SAAS,EAAC,kBAAkB,aAC/B,cAAI,SAAS,EAAC,gBAAgB,aAC7B,eAAM,SAAS,EAAC,yCAAyC,GAAG,EAC5D,qCAAsB,0EAClB,EACL,cAAI,SAAS,EAAC,gBAAgB,aAC7B,eAAM,SAAS,EAAC,wCAAwC,GAAG,EAC3D,qCAAsB,oEAClB,EACL,cAAI,SAAS,EAAC,gBAAgB,aAC7B,eAAM,SAAS,EAAC,wCAAwC,GAAG,EAC3D,mCAAoB,gFAChB,IACD,EACL,0IAEC,8CAA6B,4EAC1B,IACK,EAEV,mBAAS,SAAS,EAAC,mBAAmB,aACrC,aAAI,SAAS,EAAC,mBAAmB,6BAAkB,EACnD,yEAC8C,8CAAoC,uVAI9E,IACK,EAEV,mBAAS,SAAS,EAAC,mBAAmB,aACrC,aAAI,SAAS,EAAC,mBAAmB,qCAA0B,EAC3D,mHACyF,GAAG,EAC3F,8CAA+B,sJAE5B,IACK,EAEV,mBAAS,SAAS,EAAC,mBAAmB,aACrC,aAAI,SAAS,EAAC,mBAAmB,0BAAe,EAChD,8BACG,uDAAwC,0cAKvC,IACK,IACL,CACN,CAAA;IAED,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAA;IAE7B,OAAO,CACN,mBAAS,SAAS,EAAC,UAAU,aAC5B,mBAAS,SAAS,EAAC,mBAAmB,aACrC,eAAM,SAAS,EAAC,gBAAgB,6BAAU,2BAEjC,EACT,IAAI,IACI,CACV,CAAA;AACF,CAAC"}

package/out/common/KindBadge.d.ts

@@ -8,17 +8,10 @@
  *   kept structural (`kind: string`) so both the POI query classifier's `QueryKindResult` and the
  *   pipeline's projection satisfy it without a hard type dependency.
  */
+import type { KindView } from "@mailwoman/core/pipeline/client-result";
 import type { ReactNode } from "react";
-export interface KindBadgeResult {
-    kind: string;
-    confidence: number;
-    alternatives: ReadonlyArray<{
-        kind: string;
-        confidence: number;
-    }>;
-}
 export interface KindBadgeProps {
-    kindResult: KindBadgeResult;
+    kindResult: KindView;
 }
 export declare function KindBadge({ kindResult }: KindBadgeProps): ReactNode;
 //# sourceMappingURL=KindBadge.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"KindBadge.d.ts","sourceRoot":"","sources":["../../lib/common/KindBadge.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACjE;AAED,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,eAAe,CAAA;CAC3B;AAID,wBAAgB,SAAS,CAAC,EAAE,UAAU,EAAE,EAAE,cAAc,GAAG,SAAS,CAkBnE"}
+{"version":3,"file":"KindBadge.d.ts","sourceRoot":"","sources":["../../lib/common/KindBadge.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAA;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,QAAQ,CAAA;CACpB;AAID,wBAAgB,SAAS,CAAC,EAAE,UAAU,EAAE,EAAE,cAAc,GAAG,SAAS,CAkBnE"}

package/out/common/KindBadge.js.map

@@ -1 +1 @@
-{"version":3,"file":"KindBadge.js","sourceRoot":"","sources":["../../lib/common/KindBadge.tsx"],"names":[],"mappings":";AAuBA,MAAM,SAAS,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAA;AAElE,MAAM,UAAU,SAAS,CAAC,EAAE,UAAU,EAAkB;IACvD,OAAO,CACN,mBAAS,SAAS,EAAC,SAAS,aAC3B,mBAAS,SAAS,EAAC,kBAAkB,aACpC,qCAAsB,OAAC,yBAAO,UAAU,CAAC,IAAI,GAAQ,EAAC,GAAG,EACzD,gBAAM,SAAS,EAAC,qBAAqB,kBAAG,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,IACxE,EACT,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CACjC,aAAI,SAAS,EAAC,uBAAuB,YACnC,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CACrC,yBACC,yBAAO,GAAG,CAAC,IAAI,GAAQ,OAAC,gBAAM,SAAS,EAAC,qBAAqB,kBAAG,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,KAD1F,GAAG,CAAC,IAAI,CAEZ,CACL,CAAC,GACE,CACL,CAAC,CAAC,CAAC,IAAI,IACC,CACV,CAAA;AACF,CAAC"}
+{"version":3,"file":"KindBadge.js","sourceRoot":"","sources":["../../lib/common/KindBadge.tsx"],"names":[],"mappings":";AAkBA,MAAM,SAAS,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAA;AAElE,MAAM,UAAU,SAAS,CAAC,EAAE,UAAU,EAAkB;IACvD,OAAO,CACN,mBAAS,SAAS,EAAC,SAAS,aAC3B,mBAAS,SAAS,EAAC,kBAAkB,aACpC,qCAAsB,OAAC,yBAAO,UAAU,CAAC,IAAI,GAAQ,EAAC,GAAG,EACzD,gBAAM,SAAS,EAAC,qBAAqB,kBAAG,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,IACxE,EACT,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CACjC,aAAI,SAAS,EAAC,uBAAuB,YACnC,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CACrC,yBACC,yBAAO,GAAG,CAAC,IAAI,GAAQ,OAAC,gBAAM,SAAS,EAAC,qBAAqB,kBAAG,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,KAD1F,GAAG,CAAC,IAAI,CAEZ,CACL,CAAC,GACE,CACL,CAAC,CAAC,CAAC,IAAI,IACC,CACV,CAAA;AACF,CAAC"}

package/out/common/confidence-tiers.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file Confidence banding shared by every component that colours a span by confidence.
+ *
+ *   It is a presentation choice, not a model one: the parser emits a continuous confidence and these
+ *   bounds only decide which colour a span is drawn in, so they live here rather than anywhere the
+ *   pipeline can see them.
+ */
+/**
+ * At or above this the span is drawn as high-confidence.
+ */
+export declare const HIGH_CONFIDENCE_MIN = 0.8;
+/**
+ * At or above this the span is drawn as medium-confidence; below it, low.
+ */
+export declare const MID_CONFIDENCE_MIN = 0.5;
+/**
+ * The banding a component applies to a span's confidence.
+ */
+export type ConfidenceTier = "high" | "mid" | "low";
+/**
+ * Bands a continuous confidence into the three tiers the demo styles against.
+ *
+ * @param confidence A parser confidence in `[0, 1]`.
+ *
+ * @returns The tier to style with.
+ */
+export declare function confidenceTier(confidence: number): ConfidenceTier;
+/**
+ * {@link confidenceTier} for a possibly-absent confidence: an unmeasured span is drawn as `mid` rather than `low`, so an
+ * older model that emits no confidence never reads as uniformly wrong.
+ */
+export declare function confidenceTierOrMid(confidence?: number): ConfidenceTier;
+//# sourceMappingURL=confidence-tiers.d.ts.map

package/out/common/confidence-tiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence-tiers.d.ts","sourceRoot":"","sources":["../../lib/common/confidence-tiers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB,MAAM,CAAA;AAEtC;;GAEG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAA;AAErC;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAA;AAEnD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAMjE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CAIvE"}

package/out/common/confidence-tiers.js

@@ -0,0 +1,42 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file Confidence banding shared by every component that colours a span by confidence.
+ *
+ *   It is a presentation choice, not a model one: the parser emits a continuous confidence and these
+ *   bounds only decide which colour a span is drawn in, so they live here rather than anywhere the
+ *   pipeline can see them.
+ */
+/**
+ * At or above this the span is drawn as high-confidence.
+ */
+export const HIGH_CONFIDENCE_MIN = 0.8;
+/**
+ * At or above this the span is drawn as medium-confidence; below it, low.
+ */
+export const MID_CONFIDENCE_MIN = 0.5;
+/**
+ * Bands a continuous confidence into the three tiers the demo styles against.
+ *
+ * @param confidence A parser confidence in `[0, 1]`.
+ *
+ * @returns The tier to style with.
+ */
+export function confidenceTier(confidence) {
+    if (confidence >= HIGH_CONFIDENCE_MIN)
+        return "high";
+    if (confidence >= MID_CONFIDENCE_MIN)
+        return "mid";
+    return "low";
+}
+/**
+ * {@link confidenceTier} for a possibly-absent confidence: an unmeasured span is drawn as `mid` rather than `low`, so an
+ * older model that emits no confidence never reads as uniformly wrong.
+ */
+export function confidenceTierOrMid(confidence) {
+    if (confidence == null)
+        return "mid";
+    return confidenceTier(confidence);
+}
+//# sourceMappingURL=confidence-tiers.js.map

package/out/common/confidence-tiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence-tiers.js","sourceRoot":"","sources":["../../lib/common/confidence-tiers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAA;AAEtC;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAA;AAOrC;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB;IAChD,IAAI,UAAU,IAAI,mBAAmB;QAAE,OAAO,MAAM,CAAA;IAEpD,IAAI,UAAU,IAAI,kBAAkB;QAAE,OAAO,KAAK,CAAA;IAElD,OAAO,KAAK,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAmB;IACtD,IAAI,UAAU,IAAI,IAAI;QAAE,OAAO,KAAK,CAAA;IAEpC,OAAO,cAAc,CAAC,UAAU,CAAC,CAAA;AAClC,CAAC"}

package/out/common/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file Common React primitives.
+ */
+export { ClientOnly } from "./ClientOnly.tsx";
+export type { ClientOnlyProps } from "./ClientOnly.tsx";
+export { CopyButton } from "./CopyButton.tsx";
+export type { CopyButtonProps } from "./CopyButton.tsx";
+export { cx } from "#common/cx";
+export type { ClassValue } from "#common/cx";
+export { KindBadge } from "./KindBadge.tsx";
+export type { KindBadgeProps } from "./KindBadge.tsx";
+export { LoadingIndicator } from "./LoadingIndicator.tsx";
+export type { LoadingIndicatorProps, LoadingMode } from "./LoadingIndicator.tsx";
+export { PresetChips } from "./PresetChips.tsx";
+export type { Preset, PresetChipsProps } from "./PresetChips.tsx";
+export { useClipboard } from "#common/useClipboard";
+export type { UseClipboard } from "#common/useClipboard";
+export { useDebouncedValue } from "#common/useDebouncedValue";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/common/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAC/B,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,YAAY,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA"}

package/out/common/index.js

@@ -0,0 +1,15 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file Common React primitives.
+ */
+export { ClientOnly } from "./ClientOnly.js";
+export { CopyButton } from "./CopyButton.js";
+export { cx } from "#common/cx";
+export { KindBadge } from "./KindBadge.js";
+export { LoadingIndicator } from "./LoadingIndicator.js";
+export { PresetChips } from "./PresetChips.js";
+export { useClipboard } from "#common/useClipboard";
+export { useDebouncedValue } from "#common/useDebouncedValue";
+//# sourceMappingURL=index.js.map

package/out/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/common/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAkB,CAAA;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAkB,CAAA;AAE7C,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAE/B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAiB,CAAA;AAE3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAwB,CAAA;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAmB,CAAA;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA"}

package/out/common/text-tokens.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file Word tokenization + span ownership shared by the word-level visualizers.
+ *
+ *   A word-level panel splits the raw input on whitespace and assigns each word to its most specific
+ *   covering span (the shortest-span owner, the same rule a character-level highlight applies per
+ *   character). Two panels must agree for the BIO labels to line up between them, so the split and
+ *   the owner walk live here.
+ */
+export interface WordToken {
+    /**
+     * The word text as it appears in the input.
+     */
+    text: string;
+    /**
+     * Leading whitespace before this word.
+     */
+    whitespace: string;
+    /**
+     * Start offset in the input string.
+     */
+    start: number;
+    /**
+     * End offset in the input string (exclusive).
+     */
+    end: number;
+}
+/**
+ * Tokenize the raw input into words, preserving leading whitespace for each token.
+ */
+export declare function tokenizeWords(input: string): WordToken[];
+/**
+ * A half-open `[start, end)` character range into the input.
+ */
+export interface CharSpan {
+    start: number;
+    end: number;
+}
+/**
+ * Per-word index of the most specific (shortest) span covering it, or `-1` when no span overlaps the word. A word is
+ * covered when any part of it falls within the span.
+ */
+export declare function shortestSpanOwners(words: readonly CharSpan[], spans: readonly CharSpan[]): number[];
+//# sourceMappingURL=text-tokens.d.ts.map

package/out/common/text-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-tokens.d.ts","sourceRoot":"","sources":["../../lib/common/text-tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,SAAS;IACzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;CACX;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,CAyBxD;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACX;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,EAAE,CAcnG"}

package/out/common/text-tokens.js

@@ -0,0 +1,52 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file Word tokenization + span ownership shared by the word-level visualizers.
+ *
+ *   A word-level panel splits the raw input on whitespace and assigns each word to its most specific
+ *   covering span (the shortest-span owner, the same rule a character-level highlight applies per
+ *   character). Two panels must agree for the BIO labels to line up between them, so the split and
+ *   the owner walk live here.
+ */
+/**
+ * Tokenize the raw input into words, preserving leading whitespace for each token.
+ */
+export function tokenizeWords(input) {
+    const words = [];
+    let i = 0;
+    // `charAt` answers "" past the end, which no whitespace test matches, so both walks stop at the input's length.
+    while (i < input.length) {
+        let ws = "";
+        while (/\s/.test(input.charAt(i))) {
+            ws += input.charAt(i);
+            i++;
+        }
+        if (i >= input.length)
+            break;
+        const start = i;
+        while (i < input.length && !/\s/.test(input.charAt(i))) {
+            i++;
+        }
+        words.push({ text: input.slice(start, i), start, end: i, whitespace: ws });
+    }
+    return words;
+}
+/**
+ * Per-word index of the most specific (shortest) span covering it, or `-1` when no span overlaps the word. A word is
+ * covered when any part of it falls within the span.
+ */
+export function shortestSpanOwners(words, spans) {
+    return words.map((word) => {
+        let best = -1;
+        let bestLen = Infinity;
+        for (const [s, sp] of spans.entries()) {
+            if (word.start < sp.end && word.end > sp.start && sp.end - sp.start < bestLen) {
+                bestLen = sp.end - sp.start;
+                best = s;
+            }
+        }
+        return best;
+    });
+}
+//# sourceMappingURL=text-tokens.js.map

package/out/common/text-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-tokens.js","sourceRoot":"","sources":["../../lib/common/text-tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IAC1C,MAAM,KAAK,GAAgB,EAAE,CAAA;IAC7B,IAAI,CAAC,GAAG,CAAC,CAAA;IAET,gHAAgH;IAChH,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACzB,IAAI,EAAE,GAAG,EAAE,CAAA;QAEX,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;YAErB,CAAC,EAAE,CAAA;QACJ,CAAC;QAED,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM;YAAE,MAAK;QAC5B,MAAM,KAAK,GAAG,CAAC,CAAA;QAEf,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,CAAC,EAAE,CAAA;QACJ,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAA;IAC3E,CAAC;IAED,OAAO,KAAK,CAAA;AACb,CAAC;AAUD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAA0B,EAAE,KAA0B;IACxF,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACzB,IAAI,IAAI,GAAG,CAAC,CAAC,CAAA;QACb,IAAI,OAAO,GAAG,QAAQ,CAAA;QAEtB,KAAK,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,KAAK,GAAG,OAAO,EAAE,CAAC;gBAC/E,OAAO,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,KAAK,CAAA;gBAC3B,IAAI,GAAG,CAAC,CAAA;YACT,CAAC;QACF,CAAC;QAED,OAAO,IAAI,CAAA;IACZ,CAAC,CAAC,CAAA;AACH,CAAC"}