@mailwoman/react 10.0.0 → 10.2.0

package/lib/search/search.css

@@ -0,0 +1,282 @@
+/* ---------------------------------------------------------------------------
+ * The docs search modal.
+ *
+ * The native <dialog> has zero padding, so the only click whose target is the dialog element itself is a click on
+ * the backdrop. The padding sits on the form, the body and the footer instead.
+ *
+ * The selected option is marked by an inset accent bar as well as a fill, so the selection holds 3:1 against the
+ * panel without depending on the fill alone. Colors, radii, spacing, type and motion read semantic tokens from
+ * tokens.css. The layout literals are the panel width and height caps, the 44px input height, the 3px selection
+ * bar, the 640px phone breakpoint, the icon size and the backdrop scrim, for which no token exists.
+ * --------------------------------------------------------------------------- */
+
+.mw-search {
+	width: min(40rem, 92vw);
+	max-height: 70vh;
+	margin: 12vh auto 0;
+	padding: 0;
+	overflow: hidden;
+	color: var(--color-text-primary);
+	font-family: var(--font-family-text);
+	font-size: var(--font-size-callout);
+	line-height: var(--line-height-body);
+	background: var(--color-background-raised);
+	border: 1px solid var(--control-border);
+	border-radius: var(--radius-panel);
+	box-shadow: var(--material-glass-shadow);
+}
+
+.mw-search[open] {
+	display: flex;
+	flex-direction: column;
+}
+
+.mw-search::backdrop {
+	background: oklch(0% 0 264 / 0.5);
+}
+
+.mw-search__form {
+	display: flex;
+	gap: var(--space-3);
+	align-items: center;
+	padding: var(--space-4) var(--space-5);
+	border-bottom: 1px solid var(--color-separator);
+}
+
+.mw-search__field {
+	display: flex;
+	flex: 1 1 auto;
+	gap: var(--space-3);
+	align-items: center;
+	min-height: 44px;
+	padding: 0 var(--space-4);
+	color: var(--control-foreground);
+	background: var(--control-background);
+	border: 1px solid var(--control-border);
+	border-radius: var(--radius-control);
+}
+
+.mw-search__field:focus-within {
+	outline: 2px solid var(--color-accent);
+	outline-offset: 1px;
+}
+
+.mw-search__icon {
+	flex: 0 0 auto;
+	width: 20px;
+	height: 20px;
+	color: var(--color-accent);
+}
+
+.mw-search__icon--spinning {
+	animation: mw-search-spin 0.8s linear infinite;
+}
+
+.mw-search__input {
+	flex: 1 1 auto;
+	min-width: 0;
+	padding: var(--space-3) 0;
+	color: inherit;
+	font: inherit;
+	font-size: var(--font-size-body);
+	background: transparent;
+	border: 0;
+	outline: 0;
+}
+
+.mw-search__cancel {
+	display: none;
+	padding: var(--space-2) var(--space-3);
+	color: var(--color-accent);
+	font: inherit;
+	background: transparent;
+	border: 0;
+	cursor: pointer;
+}
+
+.mw-search__corrected {
+	margin: 0;
+	padding: var(--space-3) var(--space-5) 0;
+	color: var(--color-text-secondary);
+	font-size: var(--font-size-footnote);
+}
+
+.mw-search__body {
+	flex: 1 1 auto;
+	min-height: 0;
+	padding: var(--space-3) var(--space-4);
+	overflow-y: auto;
+}
+
+.mw-search__category {
+	padding: var(--space-4) var(--space-4) var(--space-2);
+	color: var(--color-text-secondary);
+	font-size: var(--font-size-footnote);
+	font-weight: var(--font-weight-semibold);
+}
+
+.mw-search__recent-list {
+	margin: 0;
+	padding: 0;
+	list-style: none;
+}
+
+.mw-search__recent-item {
+	display: flex;
+	align-items: center;
+	border-radius: var(--radius-control);
+}
+
+.mw-search__recent-item:hover {
+	background: var(--color-background-sunken);
+}
+
+.mw-search__recent-query {
+	flex: 1 1 auto;
+	padding: var(--space-3) var(--space-4);
+	color: inherit;
+	font: inherit;
+	text-align: left;
+	background: transparent;
+	border: 0;
+	cursor: pointer;
+}
+
+.mw-search__recent-remove {
+	flex: 0 0 auto;
+	width: 44px;
+	height: 44px;
+	color: var(--color-text-secondary);
+	font: inherit;
+	font-size: var(--font-size-body);
+	background: transparent;
+	border: 0;
+	cursor: pointer;
+}
+
+.mw-search__recent-remove:hover,
+.mw-search__recent-remove:focus-visible {
+	color: var(--color-text-primary);
+}
+
+.mw-search__empty {
+	margin: 0;
+	padding: var(--space-5) var(--space-4);
+	color: var(--color-text-secondary);
+	text-align: center;
+}
+
+.mw-search__option {
+	border-radius: var(--radius-control);
+	display: flex;
+	flex-direction: column;
+	gap: var(--space-1);
+	padding: var(--space-3) var(--space-4);
+	color: inherit;
+	text-decoration: none;
+}
+
+.mw-search__option--section {
+	padding-left: calc(var(--space-4) + var(--space-5));
+}
+
+.mw-search__option[aria-selected="true"] {
+	background: var(--color-background-sunken);
+	box-shadow: inset 3px 0 0 var(--color-accent);
+}
+
+.mw-search__path {
+	color: var(--color-text-secondary);
+	font-size: var(--font-size-footnote);
+}
+
+.mw-search__title {
+	font-size: var(--font-size-subheadline);
+	font-weight: var(--font-weight-semibold);
+}
+
+.mw-search__snippet {
+	color: var(--color-text-secondary);
+	font-size: var(--font-size-footnote);
+}
+
+.mw-search mark {
+	color: var(--color-text-primary);
+	font-weight: var(--font-weight-semibold);
+	background: var(--color-accent-background);
+	border-radius: var(--radius-tick);
+}
+
+.mw-search__footer {
+	display: flex;
+	gap: var(--space-4);
+	align-items: center;
+	justify-content: space-between;
+	padding: var(--space-3) var(--space-5);
+	color: var(--color-text-secondary);
+	font-size: var(--font-size-footnote);
+	border-top: 1px solid var(--color-separator);
+}
+
+.mw-search__status {
+	margin: 0;
+}
+
+.mw-search__hints {
+	display: flex;
+	gap: var(--space-4);
+	margin: 0;
+	padding: 0;
+	list-style: none;
+}
+
+.mw-search__hints kbd {
+	display: inline-block;
+	min-width: 1.5em;
+	margin-right: var(--space-1);
+	padding: 0 var(--space-1);
+	font: inherit;
+	text-align: center;
+	background: var(--color-background-sunken);
+	border: 1px solid var(--control-border);
+	border-radius: var(--radius-tick);
+}
+
+@media (width <= 640px) {
+	.mw-search {
+		width: 100vw;
+		max-width: none;
+		height: 100dvh;
+		max-height: none;
+		margin: 0;
+		border: 0;
+		border-radius: 0;
+	}
+
+	.mw-search__cancel {
+		display: inline-block;
+	}
+
+	.mw-search__hints {
+		display: none;
+	}
+}
+
+@media (prefers-reduced-motion: no-preference) {
+	.mw-search[open] {
+		animation: mw-search-open var(--duration-standard) var(--easing-decelerate);
+	}
+}
+
+@keyframes mw-search-open {
+	from {
+		opacity: 0;
+		transform: translateY(calc(var(--space-4) * -1));
+	}
+}
+
+@keyframes mw-search-spin {
+	to {
+		transform: rotate(360deg);
+	}
+}

package/lib/search/types.ts

@@ -0,0 +1,68 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The record the docs build indexes and the response the search modal renders. The modal and the
+ *   query code share these through `import type`.
+ */
+
+/**
+ * The number of hierarchy entries: the sidebar category, then `h1` through `h6`.
+ */
+export const HIERARCHY_DEPTH = 7
+
+export interface SearchRecord {
+	/**
+	 * The first 32 hex characters of `sha256(url + "#" + anchor + "\n" + position)`.
+	 */
+	id: string
+	/**
+	 * Site-relative path without the anchor, such as `/docs/developers/reference/cli`.
+	 */
+	url: string
+	/**
+	 * The heading id the record links to, or the empty string for the top of the page.
+	 */
+	anchor: string
+	/**
+	 * Seven entries, `lvl0` through `lvl6`, with `null` below the record's own level.
+	 */
+	hierarchy: (string | null)[]
+	/**
+	 * Aggregated text under the heading, or the empty string for a heading without body text.
+	 */
+	content: string
+	/**
+	 * Depth of the deepest non-null hierarchy entry, 0 through 6.
+	 */
+	level: number
+	/**
+	 * Zero-based order of the record on its page.
+	 */
+	position: number
+}
+
+export interface SearchHit {
+	url: string
+	anchor: string
+	hierarchy: (string | null)[]
+	/**
+	 * At most 160 characters of content around the first match.
+	 */
+	snippet: string
+	/**
+	 * Character ranges within `snippet` that matched a query token.
+	 */
+	highlights: [start: number, end: number][]
+}
+
+export interface SearchResponse {
+	query: string
+	/**
+	 * The text actually searched when a token was corrected against the vocabulary.
+	 * It is `null` when no token was.
+	 */
+	corrected: string | null
+	hits: SearchHit[]
+}

package/lib/search.ts

@@ -0,0 +1,11 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file The docs search modal and its wire types.
+ */
+
+export { hitHref, SearchModal } from "./search/SearchModal.tsx"
+export type { SearchModalProps } from "./search/SearchModal.tsx"
+export { HIERARCHY_DEPTH } from "./search/types.ts"
+export type { SearchHit, SearchRecord, SearchResponse } from "./search/types.ts"

package/out/common/About.d.ts

@@ -3,17 +3,17 @@
  * @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.
+ * `About` — the explainer for the browser geocoder: the neural model, the confidence colors, the gazetteer resolver, the byte-range database and the FST prior. It renders no live content.
  */
 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.
+     * Wraps the prose in its own `<details>` disclosure.
      *
-     * @default true
+     * Set false where the host is already the disclosure, because a summary repeating
+     * an About button's words is one control too many.
+     *
+     * @defaultValue `true`
      */
     collapsible?: boolean;
 }

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

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

package/out/common/About.js

@@ -1,6 +1,6 @@
 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."] })] })] }));
+    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" }), " on its WASM SIMD backend. 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: "sqlite-wasm" }), " over a read-only HTTP file system. It range-requests only the pages a lookup touches. Therefore, 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] }));

package/out/common/About.js.map

@@ -1 +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"}
+{"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,gJAE/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,2CAA4B,6LAEzB,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/ClientOnly.d.ts

@@ -3,21 +3,12 @@
  * @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 comes from `useSyncExternalStore` with a constant snapshot pair — `false` on the
- *   server, `true` in the browser — which is the store-shaped statement of exactly this boundary. The
- *   earlier `useState(false)` + `useEffect(() => setMounted(true))` said the same thing with a
- *   render-cascade the react(set-state-in-effect) rule rightly flags: the second render was the
- *   mechanism, not an accident, and the store form gets the same second paint without a set-state.
+ * `ClientOnly` — a portable SSR boundary that renders `fallback` on the server and first client paint. It swaps to `children()` after mounting, keeping timers, clipboard and dynamic imports off the server render.
  */
 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.
+     * Rendered once mounted in the browser, as a thunk so its browser-only imports never run on the server.
      */
     children: () => ReactNode;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"ClientOnly.d.ts","sourceRoot":"","sources":["../../lib/common/ClientOnly.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAwB,MAAM,OAAO,CAAA;AAS5D,MAAM,WAAW,eAAe;IAC/B;;OAEG;IACH,QAAQ,EAAE,MAAM,SAAS,CAAA;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,QAAe,EAAE,EAAE,eAAe,GAAG,SAAS,CAQpF"}
+{"version":3,"file":"ClientOnly.d.ts","sourceRoot":"","sources":["../../lib/common/ClientOnly.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAwB,MAAM,OAAO,CAAA;AAM5D,MAAM,WAAW,eAAe;IAC/B;;OAEG;IACH,QAAQ,EAAE,MAAM,SAAS,CAAA;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,QAAe,EAAE,EAAE,eAAe,GAAG,SAAS,CAQpF"}

package/out/common/ClientOnly.js

@@ -3,21 +3,9 @@
  * @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 comes from `useSyncExternalStore` with a constant snapshot pair — `false` on the
- *   server, `true` in the browser — which is the store-shaped statement of exactly this boundary. The
- *   earlier `useState(false)` + `useEffect(() => setMounted(true))` said the same thing with a
- *   render-cascade the react(set-state-in-effect) rule rightly flags: the second render was the
- *   mechanism, not an accident, and the store form gets the same second paint without a set-state.
+ * `ClientOnly` — a portable SSR boundary that renders `fallback` on the server and first client paint. It swaps to `children()` after mounting, keeping timers, clipboard and dynamic imports off the server render.
  */
 import { useSyncExternalStore } from "react";
-/**
- * The boundary never changes after mount, so nothing ever notifies.
- */
 function subscribeNever() {
     return () => { };
 }

package/out/common/ClientOnly.js.map

@@ -1 +1 @@
-{"version":3,"file":"ClientOnly.js","sourceRoot":"","sources":["../../lib/common/ClientOnly.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAkB,oBAAoB,EAAE,MAAM,OAAO,CAAA;AAE5D;;GAEG;AACH,SAAS,cAAc;IACtB,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;AAChB,CAAC;AAaD,MAAM,UAAU,UAAU,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,EAAmB;IACxE,MAAM,OAAO,GAAG,oBAAoB,CACnC,cAAc,EACd,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,KAAK,CACX,CAAA;IAED,OAAO,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAA;AACvC,CAAC"}
+{"version":3,"file":"ClientOnly.js","sourceRoot":"","sources":["../../lib/common/ClientOnly.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAkB,oBAAoB,EAAE,MAAM,OAAO,CAAA;AAE5D,SAAS,cAAc;IACtB,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;AAChB,CAAC;AAaD,MAAM,UAAU,UAAU,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,EAAmB;IACxE,MAAM,OAAO,GAAG,oBAAoB,CACnC,cAAc,EACd,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,KAAK,CACX,CAAA;IAED,OAAO,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAA;AACvC,CAAC"}

package/out/common/CopyButton.d.ts

@@ -9,15 +9,21 @@
 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).
+     * 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 in the idle state.
+     *
+     * @defaultValue `"Copy"`
      */
     label?: ReactNode;
     /**
-     * Label shown briefly after a successful copy. @default "✓ Copied"
+     * Label shown briefly after a successful copy.
+     *
+     * @defaultValue `"✓ Copied"`
      */
     copiedLabel?: ReactNode;
     className?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"CopyButton.d.ts","sourceRoot":"","sources":["../../lib/common/CopyButton.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,MAAM,WAAW,eAAe;IAC/B;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAA;IAC9B;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB;;OAEG;IACH,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"}
+{"version":3,"file":"CopyButton.d.ts","sourceRoot":"","sources":["../../lib/common/CopyButton.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,MAAM,WAAW,eAAe;IAC/B;;;;OAIG;IACH,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAA;IAC9B;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB;;;;OAIG;IACH,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.map

@@ -1 +1 @@
-{"version":3,"file":"CopyButton.js","sourceRoot":"","sources":["../../lib/common/CopyButton.tsx"],"names":[],"mappings":";AAWA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAmBnD,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"}
+{"version":3,"file":"CopyButton.js","sourceRoot":"","sources":["../../lib/common/CopyButton.tsx"],"names":[],"mappings":";AAWA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAyBnD,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/LoadingIndicator.d.ts

@@ -11,19 +11,24 @@
 export type LoadingMode = "pulse" | "spinner" | "staged";
 export interface LoadingIndicatorProps extends React.HTMLAttributes<HTMLDivElement> {
     /**
-     * @default "spinner"
+     * @defaultValue `"spinner"`
      */
     mode?: LoadingMode;
     /**
-     * Optional label; in staged mode it renders above the step list.
+     * Optional label.
+     * In staged mode it renders above the step list.
      */
     label?: string;
     /**
-     * Number of skeleton bars (pulse mode). @default 3
+     * Number of skeleton bars (pulse mode).
+     *
+     * @defaultValue `3`
      */
     barCount?: number;
     /**
-     * Spinner ring size. @default "medium"
+     * Spinner ring size.
+     *
+     * @defaultValue `"medium"`
      */
     size?: "small" | "medium" | "large";
     /**
@@ -31,7 +36,10 @@ export interface LoadingIndicatorProps extends React.HTMLAttributes<HTMLDivEleme
      */
     steps?: string[];
     /**
-     * 0-based index of the active step; earlier steps are complete, later ones pending. @default -1
+     * 0-based index of the active step.
+     * Earlier steps are complete, later ones pending.
+     *
+     * @defaultValue `-1`
      */
     activeStep?: number;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"LoadingIndicator.d.ts","sourceRoot":"","sources":["../../lib/common/LoadingIndicator.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAA;AAExD,MAAM,WAAW,qBAAsB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAClF;;OAEG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;IACnC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAQD;;GAEG;AACH,eAAO,MAAM,gBAAgB,6DAkB3B,CAAA"}
+{"version":3,"file":"LoadingIndicator.d.ts","sourceRoot":"","sources":["../../lib/common/LoadingIndicator.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAA;AAExD,MAAM,WAAW,qBAAsB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAClF;;OAEG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;IACnC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAQD;;GAEG;AACH,eAAO,MAAM,gBAAgB,6DAkB3B,CAAA"}

package/out/common/LoadingIndicator.js.map

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

package/out/common/PresetChips.d.ts

@@ -3,18 +3,18 @@
  * @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.
+ *   `PresetChips` is the "Try:" row of example buttons shared by both explorers. Presentational: it
+ *   renders a labeled list and calls `onPick` with the chosen preset's value.
  */
 import type { ReactNode } from "react";
 export interface Preset {
     label: string;
     value: string;
     /**
-     * ISO country code for the placetype-pair country pin (#1278 phase 2's `{country}` override). Optional: a host that
-     * wires the pair prior hands this to `selectPairIndexForText` when the input still equals this preset's text, so a
-     * locale structural routing can't detect (NZ's 4-digit postcode isn't distinctive) still fires the dependent_locality
-     * prior. Purely descriptive to `PresetChips` itself (which only emits `value`).
+     * ISO country code for the placetype-pair country pin.
+     *
+     * A host that wires the pair prior hands this to `selectPairIndexForText`
+     * when the input still equals this preset's text.
      */
     country?: string;
 }
@@ -23,11 +23,14 @@ export interface PresetChipsProps {
     onPick: (value: string) => void;
     disabled?: boolean;
     /**
-     * Leading label. @default "Try:"
+     * The label shown before the choices.
+     *
+     * @defaultValue `"Try:"`
      */
     caption?: string;
     /**
-     * Optional trailing content rendered inside the chip row after the presets (e.g. an inline permalink button).
+     * Optional trailing content rendered inside the chip row after the presets
+     * (e.g. an inline permalink button).
      */
     trailing?: ReactNode;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"PresetChips.d.ts","sourceRoot":"","sources":["../../lib/common/PresetChips.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,WAAW,MAAM;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC9B,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAgB,EAAE,QAAQ,EAAE,EAAE,gBAAgB,GAAG,SAAS,CAmBlH"}
+{"version":3,"file":"PresetChips.d.ts","sourceRoot":"","sources":["../../lib/common/PresetChips.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,WAAW,MAAM;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC9B,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAgB,EAAE,QAAQ,EAAE,EAAE,gBAAgB,GAAG,SAAS,CAmBlH"}

package/out/common/PresetChips.js.map

@@ -1 +1 @@
-{"version":3,"file":"PresetChips.js","sourceRoot":"","sources":["../../lib/common/PresetChips.tsx"],"names":[],"mappings":";AAqCA,MAAM,UAAU,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAE,QAAQ,EAAoB;IACtG,OAAO,CACN,eAAK,SAAS,EAAC,YAAY,aAC1B,eAAM,SAAS,EAAC,mBAAmB,YAAE,OAAO,GAAQ,EACnD,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACxB,iBAEC,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,SAAS,EACnB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EACnC,KAAK,EAAE,MAAM,CAAC,KAAK,YAElB,MAAM,CAAC,KAAK,IAPR,MAAM,CAAC,KAAK,CAQT,CACT,CAAC,EACD,QAAQ,IACJ,CACN,CAAA;AACF,CAAC"}
+{"version":3,"file":"PresetChips.js","sourceRoot":"","sources":["../../lib/common/PresetChips.tsx"],"names":[],"mappings":";AAwCA,MAAM,UAAU,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAE,QAAQ,EAAoB;IACtG,OAAO,CACN,eAAK,SAAS,EAAC,YAAY,aAC1B,eAAM,SAAS,EAAC,mBAAmB,YAAE,OAAO,GAAQ,EACnD,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACxB,iBAEC,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,SAAS,EACnB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EACnC,KAAK,EAAE,MAAM,CAAC,KAAK,YAElB,MAAM,CAAC,KAAK,IAPR,MAAM,CAAC,KAAK,CAQT,CACT,CAAC,EACD,QAAQ,IACJ,CACN,CAAA;AACF,CAAC"}