@mono-lit/helper 0.0.1 → 0.0.2

package/LICENSE.md

@@ -1,55 +1,55 @@
-# MIT License
-
-Copyright (c) 2026 YCEJ9999
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
----
-
-## Third-party software
-
-The MIT License above covers only the code written for this package. It does
-**not** cover third-party packages these libraries depend on or work with. Each of
-those keeps its own license.
-
-### DevExtreme
-
-**DevExtreme** is a product of **Developer Express Inc. ("DevExpress")** and is
-licensed by DevExpress under its own terms, not by the copyright holder of this
-package. `@mono-lit/helper` does not include or depend on DevExtreme. It can work with
-DevExtreme data sources that your application supplies (for example from
-`@mono-lit/devextreme`). If you use DevExtreme with it:
-
-- this package does **not** provide, sublicense, transfer or grant any DevExtreme
-  license;
-- you are responsible for obtaining a valid DevExtreme license from DevExpress and
-  for complying with its End User License Agreement;
-- DevExpress's license terms, not this file, govern your use of DevExtreme.
-
-Official DevExpress licensing information:
-
-- DevExtreme licensing: https://js.devexpress.com/Licensing/
-- DevExtreme EULA: https://js.devexpress.com/EULAs/DevExtremeComplete/
-
-For setting up your license key, see
-[../devextreme/README.md](../devextreme/README.md).
-
-"DevExpress" and "DevExtreme" are trademarks or registered trademarks of
-Developer Express Inc. This project is not affiliated with or endorsed by
-DevExpress.
+# MIT License
+
+Copyright (c) 2026 YCEJ9999
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+## Third-party software
+
+The MIT License above covers only the code written for this package. It does
+**not** cover third-party packages these libraries depend on or work with. Each of
+those keeps its own license.
+
+### DevExtreme
+
+**DevExtreme** is a product of **Developer Express Inc. ("DevExpress")** and is
+licensed by DevExpress under its own terms, not by the copyright holder of this
+package. `@mono-lit/helper` does not include or depend on DevExtreme. It can work with
+DevExtreme data sources that your application supplies (for example from
+`@mono-lit/devextreme`). If you use DevExtreme with it:
+
+- this package does **not** provide, sublicense, transfer or grant any DevExtreme
+  license;
+- you are responsible for obtaining a valid DevExtreme license from DevExpress and
+  for complying with its End User License Agreement;
+- DevExpress's license terms, not this file, govern your use of DevExtreme.
+
+Official DevExpress licensing information:
+
+- DevExtreme licensing: https://js.devexpress.com/Licensing/
+- DevExtreme EULA: https://js.devexpress.com/EULAs/DevExtremeComplete/
+
+For setting up your license key, see
+[../devextreme/README.md](../devextreme/README.md).
+
+"DevExpress" and "DevExtreme" are trademarks or registered trademarks of
+Developer Express Inc. This project is not affiliated with or endorsed by
+DevExpress.

package/README.md

@@ -1,35 +1,35 @@
-# @mono-lit/helper
-
-Lit web components (tables, forms, inputs, dialogs, charts, …) for Vue and Nuxt. Every component ships a light-DOM build (`@mono-lit/helper/ui/<name>`) and a shadow-DOM build (`@mono-lit/helper/ui/shadow/<name>`).
-
-## Installation
-
-**From npmjs (public):**
-
-```bash
-pnpm add @mono-lit/helper
-```
-
-**From the Netlify registry:** add this to your project's `.npmrc`, then run the same `pnpm add`:
-
-```ini
-@mono-lit:registry=https://mono-libs.netlify.app/npm/
-//mono-libs.netlify.app/npm/:_authToken=<REGISTRY_DOWNLOAD_TOKEN>
-```
-
-Optional peers are only needed for the features that use them: `chart.js` (chart), `suneditor` (rich-text editor), `exceljs` / `handlebars` (table export), plus `@floating-ui/dom`, `vue`, `vite` and `@nuxt/kit` for their integrations.
-
-## Usage
-
-```ts
-import '@mono-lit/helper/index.css'
-import '@mono-lit/helper/ui/button'
-```
-
-```html
-<mono-button>Save</mono-button>
-```
-
-## License
-
-MIT. See the [repository](https://github.com/mono-lit/core) for full documentation.
+# @mono-lit/helper
+
+Lit web components (tables, forms, inputs, dialogs, charts, …) for Vue and Nuxt. Every component ships a light-DOM build (`@mono-lit/helper/ui/<name>`) and a shadow-DOM build (`@mono-lit/helper/ui/shadow/<name>`).
+
+## Installation
+
+**From npmjs (public):**
+
+```bash
+pnpm add @mono-lit/helper
+```
+
+**From the Netlify registry:** add this to your project's `.npmrc`, then run the same `pnpm add`:
+
+```ini
+@mono-lit:registry=https://mono-libs.netlify.app/npm/
+//mono-libs.netlify.app/npm/:_authToken=<REGISTRY_DOWNLOAD_TOKEN>
+```
+
+Optional peers are only needed for the features that use them: `chart.js` (chart), `suneditor` (rich-text editor), `exceljs` / `handlebars` (table export), plus `@floating-ui/dom`, `vue`, `vite` and `@nuxt/kit` for their integrations.
+
+## Usage
+
+```ts
+import '@mono-lit/helper/index.css'
+import '@mono-lit/helper/ui/button'
+```
+
+```html
+<mono-button>Save</mono-button>
+```
+
+## License
+
+MIT. See the [repository](https://github.com/mono-lit/core) for full documentation.

package/dist/data-source-controller-B_rgHCjw.js

@@ -0,0 +1,241 @@
+import { n as describeError, o as isCanceled } from "./normalize-error-Gcgmgh5i.js";
+//#region src/composables/data-source-controller.ts
+/**
+* Encapsulates the generic DataSource + incremental-loading logic shared by
+* `mono-select`, `mono-tag-input`, etc. The host owns the rendering and any
+* scroll/height ergonomics; this controller owns binding, event wiring, page
+* accumulation, and array-mode chunking.
+*
+* Every state mutation calls `host.requestUpdate()` so the host re-renders.
+*/
+var DataSourceController = class {
+	constructor(host, opts) {
+		this._dsItems = [];
+		this._dsLoading = false;
+		this._loadingMore = false;
+		this._isLastPage = false;
+		this._error = null;
+		this._hasLoaded = false;
+		this._retrying = false;
+		this._internalLoad = false;
+		this._bound = null;
+		this._onChanged = () => {
+			if (this._internalLoad) return;
+			this._markLoaded();
+			if (this.opts.getLoadMoreMode()) {
+				const ds = this._bound;
+				this._dsItems = ds ? [...ds.items?.() ?? []] : [];
+				this._isLastPage = ds?.isLastPage?.() ?? false;
+				this._dsLoading = ds?.isLoading?.() ?? false;
+				this._changed();
+				return;
+			}
+			this._sync();
+		};
+		this._onLoadingChanged = () => {
+			this._dsLoading = this._bound?.isLoading?.() ?? false;
+			this._changed();
+		};
+		this._onLoadError = (err) => {
+			this._dsLoading = this._bound?.isLoading?.() ?? false;
+			this.setError(err ?? /* @__PURE__ */ new Error("Request failed"));
+		};
+		this.host = host;
+		this.opts = opts;
+		this._visibleCount = opts.getPageSize();
+		host.addController(this);
+	}
+	hostConnected() {
+		const ds = this.opts.getDataSource();
+		if (ds && this._bound !== ds) this.bind(ds);
+	}
+	hostDisconnected() {
+		this._detach();
+	}
+	/** Attach/detach listeners for a (possibly new) DataSource and seed state. */
+	bind(ds) {
+		if (this._bound === ds) return;
+		this._detach();
+		this._bound = ds;
+		this._error = null;
+		this._retrying = false;
+		this._hasLoaded = !!ds && (ds.items?.() ?? []).length > 0;
+		if (!ds) {
+			this._dsItems = [];
+			this._dsLoading = false;
+			this._isLastPage = false;
+			this._changed();
+			return;
+		}
+		ds.on("changed", this._onChanged);
+		ds.on("loadingChanged", this._onLoadingChanged);
+		ds.on("loadError", this._onLoadError);
+		this._sync();
+		this.maybeImmediateLoad();
+	}
+	maybeImmediateLoad() {
+		const ds = this._bound;
+		if (!ds || !this.opts.getImmediate()) return;
+		const hasItems = (ds.items?.() ?? []).length > 0;
+		const loading = ds.isLoading?.() ?? false;
+		if (hasItems || loading) return;
+		this._loadFirstPage();
+	}
+	/** Call when the load-more mode changes; refreshes paging assumptions. */
+	onLoadMoreModeChange() {
+		if (!this.opts.getLoadMoreMode()) return;
+		this._bound?.paginate?.(true);
+		this._isLastPage = this._bound?.isLastPage?.() ?? false;
+		this._changed();
+	}
+	/** Reset array-mode paging to the first chunk. */
+	resetVisible() {
+		this._visibleCount = this.opts.getPageSize();
+		this._changed();
+	}
+	/** Load/reveal the next page and append it to the accumulated list. */
+	async loadMore() {
+		if (!this.opts.getLoadMoreMode() || this.atLastPage) return;
+		if (this.isArrayLoadMore) {
+			this._visibleCount = Math.min(this.opts.getItems().length, this._visibleCount + this.opts.getPageSize());
+			this._changed();
+			return;
+		}
+		const ds = this._bound;
+		if (!ds || this._loadingMore || this._dsLoading) return;
+		if (typeof ds.pageIndex !== "function") return;
+		const current = ds.pageIndex() ?? 0;
+		this._internalLoad = true;
+		this._loadingMore = true;
+		this._changed();
+		try {
+			ds.paginate?.(true);
+			ds.pageIndex(current + 1);
+			await Promise.resolve(ds.load());
+			this._dsItems = [...this._dsItems, ...ds.items?.() ?? []];
+			this._isLastPage = ds.isLastPage?.() ?? false;
+			this._error = null;
+		} catch (err) {
+			ds.pageIndex(current);
+			this.setError(err);
+		} finally {
+			this._loadingMore = false;
+			this._internalLoad = false;
+			this._changed();
+		}
+	}
+	/**
+	* Re-run the request after a failure. Reloads the source as it stands, so a
+	* failed search is retried with the same query. While it runs the field is
+	* {@link busy} again.
+	*
+	* `load` replaces the plain `ds.load()` — a host whose failed request was a
+	* search passes one that clears the query on the source and reloads.
+	*/
+	async retry(load) {
+		if (!this._bound) return;
+		this._error = null;
+		this._retrying = true;
+		this._changed();
+		try {
+			await this._loadFirstPage(load);
+		} finally {
+			this._retrying = false;
+			this._changed();
+		}
+	}
+	/**
+	* Record a failure from a request the host drove itself (e.g. a server
+	* select-all drain). Cancelled loads are ignored.
+	*/
+	setError(raw) {
+		if (isCanceled(raw)) return;
+		this._error = describeError(raw);
+		this._changed();
+	}
+	/** Raw source array: accumulated DataSource items, or the plain `items`. */
+	get sourceItems() {
+		return this._bound ? this._dsItems : this.opts.getItems();
+	}
+	/** Rows to actually render (array-mode reveals a slice; else everything). */
+	get visibleItems() {
+		if (this.isArrayLoadMore) return this.opts.getItems().slice(0, this._visibleCount);
+		return this.sourceItems;
+	}
+	get loading() {
+		return this._dsLoading;
+	}
+	get loadingMore() {
+		return this._loadingMore;
+	}
+	/**
+	* The field must be locked: the FIRST load (or a retry) is in flight. A
+	* search / filter reload after the source has answered once does not count —
+	* the person is typing into the field and it must stay usable.
+	*/
+	get busy() {
+		return !!this._bound && (this._dsLoading && !this._hasLoaded || this._retrying);
+	}
+	/** The last load failure, described for a person; null once a load succeeds. */
+	get error() {
+		return this._error;
+	}
+	/** load-more is driving a plain `items` array (no DataSource bound). */
+	get isArrayLoadMore() {
+		return !this.opts.getDataSource() && !!this.opts.getLoadMoreMode();
+	}
+	/** Whether there's nothing left to load/reveal. */
+	get atLastPage() {
+		if (this.isArrayLoadMore) return this._visibleCount >= this.opts.getItems().length;
+		return this._isLastPage;
+	}
+	/** A load answered: the source is usable and any earlier failure is over. */
+	_markLoaded() {
+		this._hasLoaded = true;
+		this._error = null;
+	}
+	_sync() {
+		const ds = this._bound;
+		this._dsItems = ds ? [...ds.items?.() ?? []] : [];
+		this._dsLoading = ds?.isLoading?.() ?? false;
+		this._isLastPage = ds?.isLastPage?.() ?? false;
+		this._changed();
+	}
+	/** Load the first page, replacing the accumulated list. */
+	async _loadFirstPage(load) {
+		const ds = this._bound;
+		if (!ds) return;
+		this._internalLoad = true;
+		this._dsLoading = true;
+		this._changed();
+		try {
+			if (this.opts.getLoadMoreMode()) {
+				ds.paginate?.(true);
+				ds.pageIndex?.(0);
+			}
+			await Promise.resolve(load ? load() : ds.load());
+			this._dsItems = [...ds.items?.() ?? []];
+			this._isLastPage = ds.isLastPage?.() ?? false;
+			this._markLoaded();
+		} catch (err) {
+			this.setError(err);
+		} finally {
+			this._dsLoading = ds.isLoading?.() ?? false;
+			this._internalLoad = false;
+			this._changed();
+		}
+	}
+	_detach() {
+		const ds = this._bound;
+		if (!ds) return;
+		ds.off("changed", this._onChanged);
+		ds.off("loadingChanged", this._onLoadingChanged);
+		ds.off("loadError", this._onLoadError);
+		this._bound = null;
+	}
+	_changed() {
+		this.host.requestUpdate();
+	}
+};
+//#endregion
+export { DataSourceController as t };

package/dist/{data-source-controller-C50Qyfzh.js → data-source-controller-Dbb4fd8I.js}

@@ -1,3 +1,4 @@
+import { a as describeError, l as isCanceled } from "./reactive-Di3mTMnV.js";
 //#region src/composables/data-source-controller.ts
 /**
 * Encapsulates the generic DataSource + incremental-loading logic shared by
@@ -13,10 +14,14 @@ var DataSourceController = class {
 		this._dsLoading = false;
 		this._loadingMore = false;
 		this._isLastPage = false;
+		this._error = null;
+		this._hasLoaded = false;
+		this._retrying = false;
 		this._internalLoad = false;
 		this._bound = null;
 		this._onChanged = () => {
 			if (this._internalLoad) return;
+			this._markLoaded();
 			if (this.opts.getLoadMoreMode()) {
 				const ds = this._bound;
 				this._dsItems = ds ? [...ds.items?.() ?? []] : [];
@@ -31,6 +36,10 @@ var DataSourceController = class {
 			this._dsLoading = this._bound?.isLoading?.() ?? false;
 			this._changed();
 		};
+		this._onLoadError = (err) => {
+			this._dsLoading = this._bound?.isLoading?.() ?? false;
+			this.setError(err ?? /* @__PURE__ */ new Error("Request failed"));
+		};
 		this.host = host;
 		this.opts = opts;
 		this._visibleCount = opts.getPageSize();
@@ -48,6 +57,9 @@ var DataSourceController = class {
 		if (this._bound === ds) return;
 		this._detach();
 		this._bound = ds;
+		this._error = null;
+		this._retrying = false;
+		this._hasLoaded = !!ds && (ds.items?.() ?? []).length > 0;
 		if (!ds) {
 			this._dsItems = [];
 			this._dsLoading = false;
@@ -57,7 +69,7 @@ var DataSourceController = class {
 		}
 		ds.on("changed", this._onChanged);
 		ds.on("loadingChanged", this._onLoadingChanged);
-		ds.on("loadError", this._onLoadingChanged);
+		ds.on("loadError", this._onLoadError);
 		this._sync();
 		this.maybeImmediateLoad();
 	}
@@ -102,14 +114,45 @@ var DataSourceController = class {
 			await Promise.resolve(ds.load());
 			this._dsItems = [...this._dsItems, ...ds.items?.() ?? []];
 			this._isLastPage = ds.isLastPage?.() ?? false;
-		} catch {
+			this._error = null;
+		} catch (err) {
 			ds.pageIndex(current);
+			this.setError(err);
 		} finally {
 			this._loadingMore = false;
 			this._internalLoad = false;
 			this._changed();
 		}
 	}
+	/**
+	* Re-run the request after a failure. Reloads the source as it stands, so a
+	* failed search is retried with the same query. While it runs the field is
+	* {@link busy} again.
+	*
+	* `load` replaces the plain `ds.load()` — a host whose failed request was a
+	* search passes one that clears the query on the source and reloads.
+	*/
+	async retry(load) {
+		if (!this._bound) return;
+		this._error = null;
+		this._retrying = true;
+		this._changed();
+		try {
+			await this._loadFirstPage(load);
+		} finally {
+			this._retrying = false;
+			this._changed();
+		}
+	}
+	/**
+	* Record a failure from a request the host drove itself (e.g. a server
+	* select-all drain). Cancelled loads are ignored.
+	*/
+	setError(raw) {
+		if (isCanceled(raw)) return;
+		this._error = describeError(raw);
+		this._changed();
+	}
 	/** Raw source array: accumulated DataSource items, or the plain `items`. */
 	get sourceItems() {
 		return this._bound ? this._dsItems : this.opts.getItems();
@@ -125,6 +168,18 @@ var DataSourceController = class {
 	get loadingMore() {
 		return this._loadingMore;
 	}
+	/**
+	* The field must be locked: the FIRST load (or a retry) is in flight. A
+	* search / filter reload after the source has answered once does not count —
+	* the person is typing into the field and it must stay usable.
+	*/
+	get busy() {
+		return !!this._bound && (this._dsLoading && !this._hasLoaded || this._retrying);
+	}
+	/** The last load failure, described for a person; null once a load succeeds. */
+	get error() {
+		return this._error;
+	}
 	/** load-more is driving a plain `items` array (no DataSource bound). */
 	get isArrayLoadMore() {
 		return !this.opts.getDataSource() && !!this.opts.getLoadMoreMode();
@@ -134,6 +189,11 @@ var DataSourceController = class {
 		if (this.isArrayLoadMore) return this._visibleCount >= this.opts.getItems().length;
 		return this._isLastPage;
 	}
+	/** A load answered: the source is usable and any earlier failure is over. */
+	_markLoaded() {
+		this._hasLoaded = true;
+		this._error = null;
+	}
 	_sync() {
 		const ds = this._bound;
 		this._dsItems = ds ? [...ds.items?.() ?? []] : [];
@@ -142,7 +202,7 @@ var DataSourceController = class {
 		this._changed();
 	}
 	/** Load the first page, replacing the accumulated list. */
-	async _loadFirstPage() {
+	async _loadFirstPage(load) {
 		const ds = this._bound;
 		if (!ds) return;
 		this._internalLoad = true;
@@ -153,10 +213,13 @@ var DataSourceController = class {
 				ds.paginate?.(true);
 				ds.pageIndex?.(0);
 			}
-			await Promise.resolve(ds.load());
+			await Promise.resolve(load ? load() : ds.load());
 			this._dsItems = [...ds.items?.() ?? []];
 			this._isLastPage = ds.isLastPage?.() ?? false;
-		} catch {} finally {
+			this._markLoaded();
+		} catch (err) {
+			this.setError(err);
+		} finally {
 			this._dsLoading = ds.isLoading?.() ?? false;
 			this._internalLoad = false;
 			this._changed();
@@ -167,7 +230,7 @@ var DataSourceController = class {
 		if (!ds) return;
 		ds.off("changed", this._onChanged);
 		ds.off("loadingChanged", this._onLoadingChanged);
-		ds.off("loadError", this._onLoadingChanged);
+		ds.off("loadError", this._onLoadError);
 		this._bound = null;
 	}
 	_changed() {

package/dist/{data-source-options-BTpfrOZ_.js → data-source-options-CP-X62Pa.js}

@@ -1,6 +1,6 @@
 import { n as isPath, r as mergePatch, t as getFieldValue } from "./field-path-C92eGLg3.js";
-import { b as andPredicates, o as mergeSearchFields, t as resolveMaybeReactive, x as compileFilterPredicate, y as andFilters } from "./reactive-BHsqVjRh.js";
-import { i as searchFilterOf, s as flattenLeaves, t as isDataSourceLike } from "./data-source-read-CUX-lgrQ.js";
+import { A as compileFilterPredicate, O as andFilters, h as mergeSearchFields, k as andPredicates, t as resolveMaybeReactive } from "./reactive-Di3mTMnV.js";
+import { i as searchFilterOf, s as flattenLeaves, t as isDataSourceLike } from "./data-source-read-B4DGp6UQ.js";
 import { s as odataStringToArray, t as arrayToODataString } from "./filter-odata-C1vSGZaY.js";
 //#region src/components/table/array-source.ts
 /** Normalise a possibly-grouped input array to flat leaf rows when grouping. */

package/dist/{data-source-options-CQSTZHPE.js → data-source-options-Jqj7LU3Z.js}

@@ -1,7 +1,7 @@
 import { n as isPath, r as mergePatch, t as getFieldValue } from "./field-path-C92eGLg3.js";
 import { i as searchFilterOf, s as flattenLeaves, t as isDataSourceLike } from "./data-source-read-DL88aH8t.js";
 import { n as andPredicates, r as compileFilterPredicate, t as andFilters } from "./filter-eval-DIfU2EAn.js";
-import { o as mergeSearchFields } from "./data-search-Bwo5bg8K.js";
+import { h as mergeSearchFields } from "./normalize-error-Gcgmgh5i.js";
 import { t as resolveMaybeReactive } from "./reactive-D3EERqgO.js";
 import { s as odataStringToArray, t as arrayToODataString } from "./filter-odata-C1vSGZaY.js";
 //#region src/components/table/array-source.ts

package/dist/{data-source-read-CUX-lgrQ.js → data-source-read-B4DGp6UQ.js}

@@ -1,5 +1,5 @@
 import { c as toODataClause, n as isPath, t as getFieldValue } from "./field-path-C92eGLg3.js";
-import { n as unwrapReactive, y as andFilters } from "./reactive-BHsqVjRh.js";
+import { O as andFilters, n as unwrapReactive } from "./reactive-Di3mTMnV.js";
 //#region src/components/table/grouping.ts
 /**
 * Client-side grouping helpers shared by {@link monoArraySource} and

package/dist/{export-BvlBx_GZ.js → export-BiGVyxt6.js}

@@ -1,6 +1,6 @@
 import { a as stripDirectives, d as __toESM, i as escapeCellText, n as parseMarkdown, r as encodeDirective, u as __commonJSMin } from "./markdown-DfqrfOJN.js";
-import { n as unwrapReactive } from "./reactive-BHsqVjRh.js";
-import { n as isReadableSource, r as readAllRows } from "./data-source-read-CUX-lgrQ.js";
+import { n as unwrapReactive } from "./reactive-Di3mTMnV.js";
+import { n as isReadableSource, r as readAllRows } from "./data-source-read-B4DGp6UQ.js";
 //#region src/export/download.ts
 /**
 * Browser download helper. Kept separate (and DOM-guarded) so the report engine

package/dist/{field-icons-BoOG6KrL.js → field-icons-DELrSdqJ.js}

@@ -47,5 +47,40 @@ function chevronIcon(dir) {
     <path fill-rule="evenodd" d=${dir === -1 ? "M12.79 5.23a.75.75 0 0 1-.02 1.06L9.06 10l3.71 3.71a.75.75 0 1 1-1.06 1.06l-4.24-4.24a.75.75 0 0 1 0-1.06l4.24-4.24a.75.75 0 0 1 1.08 0z" : "M7.21 14.77a.75.75 0 0 1 .02-1.06L10.94 10 7.23 6.29a.75.75 0 1 1 1.06-1.06l4.24 4.24a.75.75 0 0 1 0 1.06l-4.24 4.24a.75.75 0 0 1-1.08 0z"} clip-rule="evenodd" />
   </svg>`;
 }
+/**
+* Busy arc for a field whose data source is still answering. Spun by the
+* component's own CSS (`[mono-ds-spinner] > svg`) so a reduced-motion rule can
+* stop it.
+*/
+function spinnerIcon() {
+	return html`<svg
+    mono-icon
+    viewBox="0 0 24 24"
+    width="16"
+    height="16"
+    fill="none"
+    stroke="currentColor"
+    stroke-width="2.5"
+    stroke-linecap="round"
+    aria-hidden="true"
+  >
+    <path d="M12 3a9 9 0 1 0 9 9" />
+  </svg>`;
+}
+/** ↻ — the retry affordance a field shows after its data source failed. */
+function refreshIcon() {
+	return html`<svg
+    mono-icon
+    viewBox="0 0 24 24"
+    width="16"
+    height="16"
+    fill="currentColor"
+    aria-hidden="true"
+  >
+    <path
+      d="M17.65 6.35A8 8 0 1 0 19.73 14h-2.08A6 6 0 1 1 12 6c1.66 0 3.14.69 4.22 1.78L13 11h7V4l-2.35 2.35z"
+    />
+  </svg>`;
+}
 //#endregion
-export { chevronIcon as n, closeIcon as r, caretIcon as t };
+export { spinnerIcon as a, refreshIcon as i, chevronIcon as n, closeIcon as r, caretIcon as t };