@mailwoman/react 0.0.1 → 7.5.0

package/README.md

@@ -1,11 +1,41 @@
 # @mailwoman/react
 
 React components + headless hooks for [mailwoman](https://mailwoman.sister.software) — the
-parse/geocode/POI explorers from the docs site, packaged for use in any React app.
+parse/geocode/POI explorers from the docs site, decomposed and packaged for use in any React app.
 
-> **v0.0.1 is a name-reservation placeholder** published to configure npm Trusted
-> Publishing. The first functional release ships with the next mailwoman minor and will
-> include Storybook + browser-mode component tests.
+## What's in the box
+
+Two composed explorers, plus the small presentational units and headless hooks they decompose into:
+
+- **`POIExplorer`** — a self-contained POI-intent tester (classify → subject → OverpassQL). The intent
+  path runs entirely offline over `@mailwoman/kind-classifier`, `@mailwoman/poi-taxonomy`, and
+  `@mailwoman/query-shape` — no weights, no network. A live poi.db search is opt-in via an injected
+  `runLiveSearch` probe, so the httpvfs/worker machinery never enters this package's graph.
+- **`PipelineExplorer`** — a parse + resolve tester driven by an **injected `PipelineRuntime`**. The
+  host supplies `runParse` (compute shape → classify → resolve) and the heavy visualizers as `panels`,
+  keeping onnxruntime-web, sql.js-httpvfs, and node builtins out of this package entirely.
+
+The headless hooks — `usePOISearch`, `useParsePipeline` — own the state machines; the presentational
+units (`QueryInput`, `SubjectPanel`, `OverpassBlock`, `LiveResultsBlock`, `ComponentTable`,
+`ResolvedPlace`, `CandidatePicker`, `KindBadge`, `LoadingIndicator`, …) are pure and prop-driven.
+
+## Usage
+
+```tsx
+import { POIExplorer, PipelineExplorer } from "@mailwoman/react"
+import "@mailwoman/react/styles.css"
+```
+
+Styling ships as a standalone stylesheet (`@mailwoman/react/styles.css`) — plain, `mw-`-prefixed, and
+Infima-token-aware, so it looks right both inside Docusaurus and standalone. No component imports CSS,
+so the bare package import stays node-safe.
+
+## Development
+
+- `yarn workspace @mailwoman/react storybook` — Storybook (Vite) for every unit + the composed
+  explorers, with mocked runtimes (no network/db).
+- `yarn workspace @mailwoman/react test:browser` — Vitest browser-mode component + hook tests
+  (Playwright / headless Chromium).
 
 ## License
 

package/common/ClientOnly.tsx

@@ -0,0 +1,30 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `ClientOnly` — a portable SSR boundary. The docs explorers wrapped Docusaurus's `<BrowserOnly>`;
+ *   this is the framework-agnostic equivalent so the components stay usable in any React app (Next,
+ *   Remix, Docusaurus). It renders `fallback` on the server and the first client paint, then swaps to
+ *   `children()` once mounted — keeping timers, clipboard, and dynamic imports off the server render.
+ *
+ *   The mount flag is derived from a `useEffect` that fires only in the browser; this is a legitimate
+ *   external-sync effect (bridging the server/client rendering boundary), not derived state.
+ */
+
+import { type ReactNode, useEffect, useState } from "react"
+
+export interface ClientOnlyProps {
+	/** Rendered once mounted in the browser. A thunk so its (browser-only) imports never run on the server. */
+	children: () => ReactNode
+	/** Rendered on the server and until the first client mount. */
+	fallback?: ReactNode
+}
+
+export function ClientOnly({ children, fallback = null }: ClientOnlyProps): ReactNode {
+	const [mounted, setMounted] = useState(false)
+
+	useEffect(() => setMounted(true), [])
+
+	return mounted ? children() : fallback
+}

package/common/CopyButton.tsx

@@ -0,0 +1,44 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `CopyButton` — a small presentational button that copies a string and shows a transient checkmark.
+ *   Wraps {@link useClipboard}. Used by both explorers (OverpassQL copy, parse-JSON copy).
+ */
+
+import type { ReactNode } from "react"
+
+import { useClipboard } from "./useClipboard.ts"
+
+export interface CopyButtonProps {
+	/** The text to copy. If a thunk, it's evaluated at click time (so callers can copy the latest value). */
+	value: string | (() => string)
+	/** Label in the idle state. @default "Copy" */
+	label?: ReactNode
+	/** Label shown briefly after a successful copy. @default "✓ Copied" */
+	copiedLabel?: ReactNode
+	className?: string
+	disabled?: boolean
+}
+
+export function CopyButton({
+	value,
+	label = "Copy",
+	copiedLabel = "✓ Copied",
+	className = "mw-btn",
+	disabled,
+}: CopyButtonProps): ReactNode {
+	const { copied, copy } = useClipboard()
+
+	return (
+		<button
+			type="button"
+			className={className}
+			disabled={disabled}
+			onClick={() => copy(typeof value === "function" ? value() : value)}
+		>
+			{copied ? copiedLabel : label}
+		</button>
+	)
+}

package/common/KindBadge.tsx

@@ -0,0 +1,44 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `KindBadge` — compact display of the Stage 2.5 kind-classifier verdict: the top kind + confidence
+ *   as a pill, expanding to the alternatives on click. Shared by both explorers. The result type is
+ *   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 { ReactNode } from "react"
+
+export interface KindBadgeResult {
+	kind: string
+	confidence: number
+	alternatives: ReadonlyArray<{ kind: string; confidence: number }>
+}
+
+export interface KindBadgeProps {
+	kindResult: KindBadgeResult
+}
+
+const formatPct = (n: number): string => `${Math.round(n * 100)}%`
+
+export function KindBadge({ kindResult }: KindBadgeProps): ReactNode {
+	return (
+		<details className="mw-kind">
+			<summary className="mw-kind__summary">
+				<strong>Kind:</strong> <code>{kindResult.kind}</code>{" "}
+				<span className="mw-kind__confidence">({formatPct(kindResult.confidence)})</span>
+			</summary>
+			{kindResult.alternatives.length > 0 ? (
+				<ul className="mw-kind__alternatives">
+					{kindResult.alternatives.map((alt) => (
+						<li key={alt.kind}>
+							<code>{alt.kind}</code> <span className="mw-kind__confidence">({formatPct(alt.confidence)})</span>
+						</li>
+					))}
+				</ul>
+			) : null}
+		</details>
+	)
+}

package/common/LoadingIndicator.tsx

@@ -0,0 +1,104 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   LoadingIndicator — pure-CSS loading states for three UX patterns: `pulse` (skeleton bars),
+ *   `spinner` (rotation ring), and `staged` (a step list with checkmarks). SSR-safe: every animation
+ *   is CSS-driven, so the component renders identically on server and client. Ported from the docs
+ *   component onto plain (`mw-`-prefixed) class names.
+ */
+
+import { memo, type ReactNode } from "react"
+
+import { cx } from "./cx.ts"
+
+export type LoadingMode = "pulse" | "spinner" | "staged"
+
+export interface LoadingIndicatorProps extends React.HTMLAttributes<HTMLDivElement> {
+	/** @default "spinner" */
+	mode?: LoadingMode
+	/** Optional label; in staged mode it renders above the step list. */
+	label?: string
+	/** Number of skeleton bars (pulse mode). @default 3 */
+	barCount?: number
+	/** Spinner ring size. @default "medium" */
+	size?: "small" | "medium" | "large"
+	/** Step labels (staged mode) — one row each. */
+	steps?: string[]
+	/** 0-based index of the active step; earlier steps are complete, later ones pending. @default -1 */
+	activeStep?: number
+}
+
+const SIZE_CLASS: Record<NonNullable<LoadingIndicatorProps["size"]>, string> = {
+	small: "mw-spinner--small",
+	medium: "",
+	large: "mw-spinner--large",
+}
+
+export const LoadingIndicator = memo<LoadingIndicatorProps>(function LoadingIndicator({
+	mode = "spinner",
+	label,
+	barCount = 3,
+	size = "medium",
+	steps,
+	activeStep = -1,
+	className,
+	...rest
+}) {
+	return (
+		<div className={cx("mw-loading", className)} role="status" aria-label={label ?? "Loading"} {...rest}>
+			{mode === "pulse" ? <PulseBars count={barCount} /> : null}
+			{mode === "spinner" ? <SpinnerRing size={size} /> : null}
+			{mode === "staged" ? <StagedProgress steps={steps} activeStep={activeStep} /> : null}
+			{label ? <span className="mw-loading__label">{label}</span> : null}
+		</div>
+	)
+})
+
+const PulseBars = memo<{ count: number }>(function PulseBars({ count }) {
+	return (
+		<div className="mw-pulse">
+			{Array.from({ length: count }, (_, i) => (
+				<div key={i} className="mw-pulse__bar" />
+			))}
+		</div>
+	)
+})
+
+const SpinnerRing = memo<{ size: NonNullable<LoadingIndicatorProps["size"]> }>(function SpinnerRing({ size }) {
+	return <div className={cx("mw-spinner", SIZE_CLASS[size])} />
+})
+
+const StagedProgress = memo<{ steps?: string[]; activeStep: number }>(function StagedProgress({ steps, activeStep }) {
+	if (!steps || steps.length === 0) return null
+
+	return (
+		<ul className="mw-staged">
+			{steps.map((step, i): ReactNode => {
+				const isComplete = i < activeStep
+				const isActive = i === activeStep
+
+				return (
+					<li
+						key={i}
+						className={cx("mw-staged__step", {
+							"mw-staged__step--complete": isComplete,
+							"mw-staged__step--active": isActive,
+							"mw-staged__step--pending": !isComplete && !isActive,
+						})}
+					>
+						<span className="mw-staged__icon">
+							{isComplete ? (
+								<span className="mw-staged__check" />
+							) : isActive ? (
+								<span className="mw-staged__dot" />
+							) : null}
+						</span>
+						<span>{step}</span>
+					</li>
+				)
+			})}
+		</ul>
+	)
+})

package/common/PresetChips.tsx

@@ -0,0 +1,43 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `PresetChips` — the "Try:" row of example buttons shared by both explorers. Presentational: it
+ *   renders a labelled list and calls `onPick` with the chosen preset's value.
+ */
+
+import type { ReactNode } from "react"
+
+export interface Preset {
+	label: string
+	value: string
+}
+
+export interface PresetChipsProps {
+	presets: ReadonlyArray<Preset>
+	onPick: (value: string) => void
+	disabled?: boolean
+	/** Leading label. @default "Try:" */
+	caption?: string
+}
+
+export function PresetChips({ presets, onPick, disabled, caption = "Try:" }: PresetChipsProps): ReactNode {
+	return (
+		<div className="mw-presets">
+			<span className="mw-presets__label">{caption}</span>
+			{presets.map((preset) => (
+				<button
+					key={preset.label}
+					type="button"
+					className="mw-chip"
+					disabled={disabled}
+					onClick={() => onPick(preset.value)}
+					title={preset.value}
+				>
+					{preset.label}
+				</button>
+			))}
+		</div>
+	)
+}

package/common/cx.ts

@@ -0,0 +1,34 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Tiny classname joiner — the only utility the presentational units need. Kept in-package (rather
+ *   than pulling `classnames`) so `@mailwoman/react` ships zero runtime deps beyond its `@mailwoman/*`
+ *   siblings and the React peer.
+ */
+
+export type ClassValue = string | number | false | null | undefined | Record<string, boolean>
+
+/** Join truthy class tokens; object entries contribute their key when the value is truthy. */
+export function cx(...values: ClassValue[]): string {
+	const out: string[] = []
+
+	for (const value of values) {
+		if (!value) continue
+
+		if (typeof value === "string" || typeof value === "number") {
+			out.push(String(value))
+
+			continue
+		}
+
+		for (const [key, on] of Object.entries(value)) {
+			if (on) {
+				out.push(key)
+			}
+		}
+	}
+
+	return out.join(" ")
+}

package/common/useClipboard.ts

@@ -0,0 +1,73 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `useClipboard` — headless copy-to-clipboard with the async Clipboard API and a legacy
+ *   `execCommand` fallback (for insecure contexts / older browsers), plus a transient "copied" flag
+ *   that auto-resets. Extracted from the two explorers' duplicated `onCopy` handlers.
+ */
+
+import { useCallback, useEffect, useRef, useState } from "react"
+
+/** Best-effort clipboard write: async Clipboard API first, hidden-textarea `execCommand` fallback. */
+async function writeToClipboard(value: string): Promise<void> {
+	try {
+		await navigator.clipboard.writeText(value)
+
+		return
+	} catch {
+		// Fall through to the legacy path below.
+	}
+
+	const textarea = document.createElement("textarea")
+	textarea.value = value
+	textarea.style.position = "fixed"
+	textarea.style.opacity = "0"
+	document.body.appendChild(textarea)
+	textarea.select()
+
+	try {
+		document.execCommand("copy")
+	} catch {
+		// Nothing else to try — leave `copied` false via the caller's error path.
+	} finally {
+		document.body.removeChild(textarea)
+	}
+}
+
+export interface UseClipboard {
+	copied: boolean
+	copy: (value: string) => Promise<void>
+}
+
+/** @param resetMs - How long the `copied` flag stays true after a successful copy. */
+export function useClipboard(resetMs = 1500): UseClipboard {
+	const [copied, setCopied] = useState(false)
+	const timer = useRef<ReturnType<typeof setTimeout> | null>(null)
+
+	// Clear a pending reset timer on unmount so it never fires against a torn-down component.
+	useEffect(
+		() => () => {
+			if (timer.current) {
+				clearTimeout(timer.current)
+			}
+		},
+		[]
+	)
+
+	const copy = useCallback(
+		async (value: string) => {
+			await writeToClipboard(value)
+			setCopied(true)
+
+			if (timer.current) {
+				clearTimeout(timer.current)
+			}
+			timer.current = setTimeout(() => setCopied(false), resetMs)
+		},
+		[resetMs]
+	)
+
+	return { copied, copy }
+}

package/common/useDebouncedValue.ts

@@ -0,0 +1,23 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `useDebouncedValue` — returns a copy of `value` that only updates after `delayMs` of quiet. Used by
+ *   the POI explorer to avoid re-classifying on every keystroke. The timer is a genuine external-sync
+ *   effect (a scheduled clock), so it belongs in an effect.
+ */
+
+import { useEffect, useState } from "react"
+
+export function useDebouncedValue<T>(value: T, delayMs: number): T {
+	const [debounced, setDebounced] = useState(value)
+
+	useEffect(() => {
+		const id = setTimeout(() => setDebounced(value), delayMs)
+
+		return () => clearTimeout(id)
+	}, [value, delayMs])
+
+	return debounced
+}

package/index.ts

@@ -5,9 +5,91 @@
  *
  *   `@mailwoman/react` — React components + headless hooks for mailwoman.
  *
- *   v0.0.1 is a name-reservation placeholder published to configure npm Trusted Publishing.
- *   The first functional release extracts the docs-site explorers (parse, geocode, POI) into
- *   decomposed, Storybook-tested components with headless hooks.
+ *   Two composed explorers plus the small presentational units and headless hooks they decompose into:
+ *
+ *   - `POIExplorer` — a self-contained POI-intent tester (classify → subject → OverpassQL), with an
+ *     optional injected live poi.db search. No weights, no network on the intent path.
+ *   - `PipelineExplorer` — a parse+resolve tester driven by an INJECTED `PipelineRuntime`, so the
+ *     model/gazetteer plumbing (ONNX, httpvfs, node builtins) stays in the host, never in this graph.
+ *
+ *   Styling ships separately as `@mailwoman/react/styles.css` (plain, `mw-`-prefixed, Infima-token
+ *   aware) — no CSS is imported by the component modules, so the bare package import is node-safe.
  */
 
-export const MAILWOMAN_REACT_STATUS = "placeholder" as const
+// ── Common primitives ──────────────────────────────────────────────────────
+export { ClientOnly } from "./common/ClientOnly.tsx"
+export type { ClientOnlyProps } from "./common/ClientOnly.tsx"
+export { CopyButton } from "./common/CopyButton.tsx"
+export type { CopyButtonProps } from "./common/CopyButton.tsx"
+export { cx } from "./common/cx.ts"
+export type { ClassValue } from "./common/cx.ts"
+export { KindBadge } from "./common/KindBadge.tsx"
+export type { KindBadgeProps, KindBadgeResult } from "./common/KindBadge.tsx"
+export { LoadingIndicator } from "./common/LoadingIndicator.tsx"
+export type { LoadingIndicatorProps, LoadingMode } from "./common/LoadingIndicator.tsx"
+export { PresetChips } from "./common/PresetChips.tsx"
+export type { Preset, PresetChipsProps } from "./common/PresetChips.tsx"
+export { useClipboard } from "./common/useClipboard.ts"
+export type { UseClipboard } from "./common/useClipboard.ts"
+export { useDebouncedValue } from "./common/useDebouncedValue.ts"
+
+// ── POI explorer ───────────────────────────────────────────────────────────
+export { AbstainPanel } from "./poi/AbstainPanel.tsx"
+export type { AbstainPanelProps } from "./poi/AbstainPanel.tsx"
+export { LiveResultsBlock } from "./poi/LiveResultsBlock.tsx"
+export type { LiveResultsBlockProps } from "./poi/LiveResultsBlock.tsx"
+export { OverpassBlock } from "./poi/OverpassBlock.tsx"
+export type { OverpassBlockProps } from "./poi/OverpassBlock.tsx"
+export { POIExplorer } from "./poi/POIExplorer.tsx"
+export type { POIExplorerProps } from "./poi/POIExplorer.tsx"
+export { QueryInput } from "./poi/QueryInput.tsx"
+export type { QueryInputProps } from "./poi/QueryInput.tsx"
+export { formatDistance, loadPOIRuntime, POI_DEFAULT_TEXT, POI_PRESETS } from "./poi/runtime.ts"
+export { SubjectPanel } from "./poi/SubjectPanel.tsx"
+export type { SubjectPanelProps } from "./poi/SubjectPanel.tsx"
+export type {
+	CategoryRecord,
+	LiveSearchState,
+	LoadPOIRuntime,
+	POIBrandSubject,
+	POICategorySubject,
+	POIExplorerResult,
+	POILiveSearch,
+	POILiveSearchResult,
+	POIRuntime,
+	POISearchHit,
+	POISubject,
+	POISubjectBase,
+	TaxonomyLookup,
+} from "./poi/types.ts"
+export { usePOISearch } from "./poi/usePOISearch.ts"
+export type { UsePOISearch, UsePOISearchOptions } from "./poi/usePOISearch.ts"
+
+// ── Pipeline explorer ──────────────────────────────────────────────────────
+export { CandidatePicker } from "./pipeline/CandidatePicker.tsx"
+export type { CandidatePickerProps } from "./pipeline/CandidatePicker.tsx"
+export { ComponentTable } from "./pipeline/ComponentTable.tsx"
+export type { ComponentTableProps } from "./pipeline/ComponentTable.tsx"
+export { ConfidenceCell } from "./pipeline/ConfidenceCell.tsx"
+export type { ConfidenceCellProps } from "./pipeline/ConfidenceCell.tsx"
+export { buildParsePayload } from "./pipeline/copy.ts"
+export { PIPELINE_DEFAULT_ADDRESS, PIPELINE_PRESETS } from "./pipeline/presets.ts"
+export { PipelineExplorer } from "./pipeline/PipelineExplorer.tsx"
+export type { PipelineExplorerProps } from "./pipeline/PipelineExplorer.tsx"
+export { QueryForm } from "./pipeline/QueryForm.tsx"
+export type { QueryFormProps } from "./pipeline/QueryForm.tsx"
+export { ResolvedPlace } from "./pipeline/ResolvedPlace.tsx"
+export type { ResolvedPlaceProps } from "./pipeline/ResolvedPlace.tsx"
+export type {
+	DualRoleView,
+	FSTProvenance,
+	ParsedComponent,
+	ParseResult,
+	PipelineLoadingState,
+	PipelinePanels,
+	PipelineRuntime,
+	ResolvedPlaceView,
+	StageTiming,
+} from "./pipeline/types.ts"
+export { useParsePipeline } from "./pipeline/useParsePipeline.ts"
+export type { UseParsePipeline, UseParsePipelineOptions } from "./pipeline/useParsePipeline.ts"

package/out/common/ClientOnly.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `ClientOnly` — a portable SSR boundary. The docs explorers wrapped Docusaurus's `<BrowserOnly>`;
+ *   this is the framework-agnostic equivalent so the components stay usable in any React app (Next,
+ *   Remix, Docusaurus). It renders `fallback` on the server and the first client paint, then swaps to
+ *   `children()` once mounted — keeping timers, clipboard, and dynamic imports off the server render.
+ *
+ *   The mount flag is derived from a `useEffect` that fires only in the browser; this is a legitimate
+ *   external-sync effect (bridging the server/client rendering boundary), not derived state.
+ */
+import { type ReactNode } from "react";
+export interface ClientOnlyProps {
+    /** Rendered once mounted in the browser. A thunk so its (browser-only) imports never run on the server. */
+    children: () => ReactNode;
+    /** Rendered on the server and until the first client mount. */
+    fallback?: ReactNode;
+}
+export declare function ClientOnly({ children, fallback }: ClientOnlyProps): ReactNode;
+//# sourceMappingURL=ClientOnly.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ClientOnly.d.ts","sourceRoot":"","sources":["../../common/ClientOnly.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAA;AAE3D,MAAM,WAAW,eAAe;IAC/B,2GAA2G;IAC3G,QAAQ,EAAE,MAAM,SAAS,CAAA;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,QAAe,EAAE,EAAE,eAAe,GAAG,SAAS,CAMpF"}

package/out/common/ClientOnly.js

@@ -0,0 +1,20 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `ClientOnly` — a portable SSR boundary. The docs explorers wrapped Docusaurus's `<BrowserOnly>`;
+ *   this is the framework-agnostic equivalent so the components stay usable in any React app (Next,
+ *   Remix, Docusaurus). It renders `fallback` on the server and the first client paint, then swaps to
+ *   `children()` once mounted — keeping timers, clipboard, and dynamic imports off the server render.
+ *
+ *   The mount flag is derived from a `useEffect` that fires only in the browser; this is a legitimate
+ *   external-sync effect (bridging the server/client rendering boundary), not derived state.
+ */
+import { useEffect, useState } from "react";
+export function ClientOnly({ children, fallback = null }) {
+    const [mounted, setMounted] = useState(false);
+    useEffect(() => setMounted(true), []);
+    return mounted ? children() : fallback;
+}
+//# sourceMappingURL=ClientOnly.js.map

package/out/common/ClientOnly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientOnly.js","sourceRoot":"","sources":["../../common/ClientOnly.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAkB,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAS3D,MAAM,UAAU,UAAU,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,EAAmB;IACxE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAE7C,SAAS,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;IAErC,OAAO,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAA;AACvC,CAAC"}

package/out/common/CopyButton.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `CopyButton` — a small presentational button that copies a string and shows a transient checkmark.
+ *   Wraps {@link useClipboard}. Used by both explorers (OverpassQL copy, parse-JSON copy).
+ */
+import type { ReactNode } from "react";
+export interface CopyButtonProps {
+    /** The text to copy. If a thunk, it's evaluated at click time (so callers can copy the latest value). */
+    value: string | (() => string);
+    /** Label in the idle state. @default "Copy" */
+    label?: ReactNode;
+    /** Label shown briefly after a successful copy. @default "✓ Copied" */
+    copiedLabel?: ReactNode;
+    className?: string;
+    disabled?: boolean;
+}
+export declare function CopyButton({ value, label, copiedLabel, className, disabled, }: CopyButtonProps): ReactNode;
+//# sourceMappingURL=CopyButton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CopyButton.d.ts","sourceRoot":"","sources":["../../common/CopyButton.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,MAAM,WAAW,eAAe;IAC/B,yGAAyG;IACzG,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAA;IAC9B,+CAA+C;IAC/C,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,uEAAuE;IACvE,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,UAAU,CAAC,EAC1B,KAAK,EACL,KAAc,EACd,WAAwB,EACxB,SAAoB,EACpB,QAAQ,GACR,EAAE,eAAe,GAAG,SAAS,CAa7B"}

package/out/common/CopyButton.js

@@ -0,0 +1,7 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useClipboard } from "./useClipboard.js";
+export function CopyButton({ value, label = "Copy", copiedLabel = "✓ Copied", className = "mw-btn", disabled, }) {
+    const { copied, copy } = useClipboard();
+    return (_jsx("button", { type: "button", className: className, disabled: disabled, onClick: () => copy(typeof value === "function" ? value() : value), children: copied ? copiedLabel : label }));
+}
+//# sourceMappingURL=CopyButton.js.map

package/out/common/CopyButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopyButton.js","sourceRoot":"","sources":["../../common/CopyButton.tsx"],"names":[],"mappings":";AAWA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAahD,MAAM,UAAU,UAAU,CAAC,EAC1B,KAAK,EACL,KAAK,GAAG,MAAM,EACd,WAAW,GAAG,UAAU,EACxB,SAAS,GAAG,QAAQ,EACpB,QAAQ,GACS;IACjB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAAA;IAEvC,OAAO,CACN,iBACC,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,YAEjE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,GACrB,CACT,CAAA;AACF,CAAC"}

package/out/common/KindBadge.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `KindBadge` — compact display of the Stage 2.5 kind-classifier verdict: the top kind + confidence
+ *   as a pill, expanding to the alternatives on click. Shared by both explorers. The result type is
+ *   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 { ReactNode } from "react";
+export interface KindBadgeResult {
+    kind: string;
+    confidence: number;
+    alternatives: ReadonlyArray<{
+        kind: string;
+        confidence: number;
+    }>;
+}
+export interface KindBadgeProps {
+    kindResult: KindBadgeResult;
+}
+export declare function KindBadge({ kindResult }: KindBadgeProps): ReactNode;
+//# sourceMappingURL=KindBadge.d.ts.map

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

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