@mono-lit/helper 0.0.1 → 0.0.2

package/dist/{data-search-Bwo5bg8K.js → normalize-error-Gcgmgh5i.js}

@@ -570,4 +570,302 @@ var MonoSourceSearch = class {
 	}
 };
 //#endregion
-export { searchEntryFor as S, hasWildcardSearch as _, isFoldableSearch as a, plainSearchColumns as b, plainSearchFields as c, searchRemoteFilter as d, searchRowPredicate as f, hasCustomSearch as g, expandWildcard as h, SEARCH_FIELDS_KEYS as i, readSearchField as l, customRemoteClause as m, DEFAULT_SEARCH_OPERATION as n, mergeSearchFields as o, customPredicate as p, MonoSourceSearch as r, parseSearchValue as s, DEFAULT_SEARCH_FIELDS as t, resolveSearchFields as u, isWildcardPattern as v, resolveSearchEntries as x, normalizeSearchExpr as y };
+//#region src/utils/normalize-error.ts
+/** Fields worth reading off an object that is not an `Error`. */
+var MESSAGE_KEYS = [
+	"message",
+	"statusText",
+	"errorMessage",
+	"error",
+	"detail"
+];
+var text = (value) => typeof value === "string" && value.trim() ? value.trim() : "";
+var isObject = (value) => value !== null && typeof value === "object";
+/**
+* A readable message for `raw`, or `fallback` when nothing legible can be found.
+*
+* Never throws, and never returns an empty string — a caller rendering this into
+* an error bar has to have something to render, and a blank bar is worse than a
+* generic one.
+*/
+function normalizeError(raw, fallback = "Request failed") {
+	if (raw == null) return fallback;
+	if (raw instanceof Error) {
+		const own = text(raw.message);
+		if (own) return own;
+	} else {
+		if (typeof raw === "string") return text(raw) || fallback;
+		if (typeof raw === "number" || typeof raw === "boolean") return String(raw);
+	}
+	if (isObject(raw)) {
+		const obj = raw;
+		for (const key of MESSAGE_KEYS) {
+			const hit = text(obj[key]);
+			if (hit) return hit;
+		}
+		const response = obj.response;
+		if (isObject(response)) {
+			const nested = text(response.statusText) || text(response.message);
+			if (nested) return nested;
+		}
+		const status = errorStatus(obj);
+		if (status !== void 0 && status > 0) return `HTTP ${status}`;
+		if (raw instanceof Error) return text(raw.name) || fallback;
+		return fallback;
+	}
+	return text(String(raw)) || fallback;
+}
+/**
+* What the bar says for a status. English; an app puts its own language in
+* ONCE with `setErrorMessages()` rather than on every table.
+*/
+var DEFAULT_ERROR_MESSAGES = Object.freeze({
+	network: "Could not reach the server. Check your connection and try again.",
+	400: "The server rejected the request.",
+	401: "Your session has expired. Please sign in again.",
+	403: "You do not have permission to view this data.",
+	404: "The requested data could not be found.",
+	408: "The server took too long to respond. Please try again.",
+	409: "The request conflicts with the current state of the data.",
+	422: "The server could not process the request.",
+	429: "Too many requests. Please wait a moment and try again.",
+	500: "Something went wrong on the server. Please try again later.",
+	502: "The server is temporarily unavailable. Please try again later.",
+	503: "The server is temporarily unavailable. Please try again later.",
+	504: "The server took too long to respond. Please try again later.",
+	default: "Request failed"
+});
+var globalMessages = null;
+/**
+* App-wide wording, merged over the defaults; `null` restores them. A grid's own
+* `errorMessages` merges over this in turn, so a single table can still differ.
+*/
+function setErrorMessages(messages) {
+	globalMessages = messages ? { ...messages } : null;
+}
+/** Defaults ← app-wide ← `local`, same shape as the filter builder's `resolveTexts`. */
+function resolveErrorMessages(local) {
+	const merged = { ...DEFAULT_ERROR_MESSAGES };
+	for (const layer of [globalMessages, local]) {
+		if (!layer) continue;
+		for (const key of Object.keys(layer)) {
+			const value = layer[key];
+			if (typeof value === "string" && value.trim()) merged[key] = value;
+		}
+	}
+	return merged;
+}
+/**
+* The standard reason phrases. Not shown to anyone — they are what `describeError`
+* uses to recognise that an error's text is ONLY the phrase for its status
+* (`Error('Forbidden')` + `httpStatus: 403`), which adds nothing to the preset and
+* so is not a detail worth appending.
+*/
+var REASON_PHRASES = {
+	400: "Bad Request",
+	401: "Unauthorized",
+	402: "Payment Required",
+	403: "Forbidden",
+	404: "Not Found",
+	405: "Method Not Allowed",
+	408: "Request Timeout",
+	409: "Conflict",
+	410: "Gone",
+	412: "Precondition Failed",
+	413: "Payload Too Large",
+	415: "Unsupported Media Type",
+	422: "Unprocessable Entity",
+	429: "Too Many Requests",
+	500: "Internal Server Error",
+	501: "Not Implemented",
+	502: "Bad Gateway",
+	503: "Service Unavailable",
+	504: "Gateway Timeout"
+};
+/** Texts a transport mints for "no answer at all" — a status of 0 in words. */
+var NETWORK_TEXTS = [
+	"failed to fetch",
+	"networkerror when attempting to fetch resource",
+	"load failed",
+	"network error",
+	"unspecified network error",
+	"network connection timeout",
+	"network request failed"
+];
+var toStatus = (value) => {
+	if (value === null || value === void 0 || value === "") return void 0;
+	const n = Number(value);
+	return Number.isInteger(n) && n >= 0 && n < 1e3 ? n : void 0;
+};
+/**
+* The HTTP status an error carries, `0` for a network failure, `undefined` when
+* it has none.
+*
+* Reads the fields the common transports use — devextreme's `httpStatus`, a
+* fetch `Response` / axios error's `status` and `response.status`, ofetch's
+* `statusCode`, an OData error body's numeric `code` — on an `Error` instance as
+* readily as on a plain object, since devextreme `extend()`s them onto an
+* `Error`.
+*/
+function errorStatus(raw) {
+	if (!isObject(raw)) return void 0;
+	const response = isObject(raw.response) ? raw.response : void 0;
+	const direct = toStatus(raw.httpStatus) ?? toStatus(raw.status) ?? toStatus(raw.statusCode) ?? toStatus(response?.status) ?? toStatus(response?.statusCode);
+	if (direct !== void 0) return direct;
+	const code = toStatus((isObject(raw.errorDetails) ? raw.errorDetails : void 0)?.code);
+	if (code !== void 0 && code >= 400) return code;
+	const own = (raw instanceof Error ? text(raw.message) : text(raw.message)).toLowerCase();
+	if (own && NETWORK_TEXTS.some((t) => own.includes(t))) return 0;
+}
+/** A JSON response body handed over as text (an XHR's `responseText`), parsed; else undefined. */
+function parseBody(value) {
+	if (typeof value !== "string") return void 0;
+	const s = value.trim();
+	if (!s.startsWith("{") && !s.startsWith("[")) return void 0;
+	try {
+		return JSON.parse(s);
+	} catch {
+		return;
+	}
+}
+/** The "same message" key: case, spacing and trailing punctuation do not make two texts different. */
+var messageKey = (value) => value.toLowerCase().replace(/\s+/g, " ").replace(/[\s.!:;,]+$/, "").trim();
+/**
+* Keep each message once. Two texts are the same message when they match after
+* {@link messageKey}, and a text another kept one already CONTAINS adds nothing
+* ("Not found" next to "Not found: Order 42") — the longer, more specific one wins
+* and keeps its place in the order the messages were found.
+*/
+function uniqueMessages(found) {
+	const kept = [];
+	for (const t of found) {
+		const key = messageKey(t);
+		if (!key) continue;
+		if (kept.some((k) => k.key.includes(key))) continue;
+		const swallowed = kept.findIndex((k) => key.includes(k.key));
+		if (swallowed >= 0) {
+			kept[swallowed] = {
+				text: t,
+				key
+			};
+			for (let i = kept.length - 1; i > swallowed; i--) if (key.includes(kept[i].key)) kept.splice(i, 1);
+			continue;
+		}
+		kept.push({
+			text: t,
+			key
+		});
+	}
+	return kept.map((k) => k.text);
+}
+/**
+* Every message an error carries, combined the way `monoFetch`'s
+* `extractErrorMessage` does it: each key whose name contains "message"
+* (`message`, `errorMessage`, `Message`, …) holding text — or OData's
+* `{ message: { value } }` — at any depth up to 3, plus a JSON body still in
+* `responseText` / `responseJSON` / `response`, plus an `Error`'s own
+* (non-enumerable) `message`. The usual body fields `detail` / `title` and a
+* plain-text `response.data` count too.
+*
+* Deduplicated by {@link uniqueMessages}, transport boilerplate ("Bad Request",
+* "Failed to fetch") dropped, in the order found.
+*/
+function collectErrorMessages(raw, status = errorStatus(raw)) {
+	const found = [];
+	const add = (value) => {
+		const t = text(value);
+		if (t) found.push(t);
+	};
+	const seen = /* @__PURE__ */ new Set();
+	const visit = (val, depth) => {
+		if (!isObject(val) || depth > 3 || seen.has(val)) return;
+		seen.add(val);
+		if (val instanceof Error) add(val.message);
+		for (const [k, v] of Object.entries(val)) {
+			if (/message/i.test(k)) {
+				if (typeof v === "string") add(v);
+				else if (isObject(v) && typeof v.value === "string") add(v.value);
+			} else if (k === "detail" || k === "title" || k === "errorDetail") add(v);
+			else if (k === "responseText" || k === "response" || k === "data" || k === "_data") {
+				if (typeof v === "string") {
+					const body = parseBody(v);
+					if (body !== void 0) visit(body, depth + 1);
+					else if (k !== "response") add(v);
+				}
+			}
+			if (isObject(v)) visit(v, depth + 1);
+		}
+	};
+	if (typeof raw === "string") add(raw);
+	else visit(raw, 0);
+	return uniqueMessages(found).filter((t) => !isBoilerplate(t, status));
+}
+/** Is `value` nothing more than the reason phrase / a generic label for `status`? */
+function isBoilerplate(value, status) {
+	const v = value.toLowerCase();
+	if (!v || v === "error" || v === "unknown error" || v === "request failed") return true;
+	if (/^http\s*\d{3}$/.test(v)) return true;
+	if (NETWORK_TEXTS.some((t) => v.includes(t))) return true;
+	if (status !== void 0) {
+		const phrase = REASON_PHRASES[status]?.toLowerCase();
+		if (phrase && (v === phrase || v === `${status} ${phrase}` || v === `${status}`)) return true;
+		if (v === String(status)) return true;
+	}
+	return Object.values(REASON_PHRASES).some((p) => p.toLowerCase() === v);
+}
+/**
+* The one line a field shows for `err`: what the server said, every distinct
+* message combined (`monoFetch` style), or the headline when it said nothing.
+*/
+function errorText(err, separator = " · ") {
+	return err.messages.length ? err.messages.join(separator) : err.message;
+}
+/** The hover text: the headline, then everything the server said, each once. */
+function errorTitle(err) {
+	return uniqueMessages([err.message, ...err.messages]).join("\n");
+}
+/**
+* The line a person should read for `raw`.
+*
+* Order: a preset for the status (`'network'` for 0) → the error's own text →
+* `messages.default`. When a preset is the headline, whatever the server said
+* on top of the status becomes `detail`; without a preset, the raw text IS the
+* headline and only a distinct server body is a detail. Never throws, never
+* returns an empty `message`.
+*/
+function describeError(raw, messages) {
+	const texts = resolveErrorMessages(messages);
+	const status = errorStatus(raw);
+	const fallback = texts.default || DEFAULT_ERROR_MESSAGES.default;
+	const rawText = normalizeError(raw, fallback);
+	const preset = status === void 0 ? void 0 : status === 0 ? texts.network : texts[status];
+	const said = collectErrorMessages(raw, status).filter((m) => m !== preset);
+	if (preset) {
+		const out = {
+			message: preset,
+			status,
+			messages: said
+		};
+		if (said.length) out.detail = said.join("\n\n");
+		return out;
+	}
+	const message = rawText || fallback;
+	const rest = said.filter((m) => messageKey(m) !== messageKey(message));
+	const out = {
+		message,
+		messages: said
+	};
+	if (status !== void 0) out.status = status;
+	if (rest.length) out.detail = rest.join("\n\n");
+	return out;
+}
+/**
+* A load a newer load superseded (devextreme rejects it with `'canceled'`).
+* Not a failure — nothing should be shown for it.
+*/
+function isCanceled(err) {
+	if (!err) return false;
+	return err === "canceled" || err.name === "canceled" || err.message === "canceled" || err.__id === "canceled";
+}
+//#endregion
+export { resolveSearchEntries as A, customRemoteClause as C, isWildcardPattern as D, hasWildcardSearch as E, normalizeSearchExpr as O, customPredicate as S, hasCustomSearch as T, plainSearchFields as _, errorTitle as a, searchRemoteFilter as b, resolveErrorMessages as c, DEFAULT_SEARCH_OPERATION as d, MonoSourceSearch as f, parseSearchValue as g, mergeSearchFields as h, errorText as i, searchEntryFor as j, plainSearchColumns as k, setErrorMessages as l, isFoldableSearch as m, describeError as n, isCanceled as o, SEARCH_FIELDS_KEYS as p, errorStatus as r, normalizeError as s, DEFAULT_ERROR_MESSAGES as t, DEFAULT_SEARCH_FIELDS as u, readSearchField as v, expandWildcard as w, searchRowPredicate as x, resolveSearchFields as y };

package/dist/{reactive-BHsqVjRh.js → reactive-Di3mTMnV.js}

@@ -740,6 +740,304 @@ var MonoSourceSearch = class {
 	}
 };
 //#endregion
+//#region src/utils/normalize-error.ts
+/** Fields worth reading off an object that is not an `Error`. */
+var MESSAGE_KEYS = [
+	"message",
+	"statusText",
+	"errorMessage",
+	"error",
+	"detail"
+];
+var text = (value) => typeof value === "string" && value.trim() ? value.trim() : "";
+var isObject = (value) => value !== null && typeof value === "object";
+/**
+* A readable message for `raw`, or `fallback` when nothing legible can be found.
+*
+* Never throws, and never returns an empty string — a caller rendering this into
+* an error bar has to have something to render, and a blank bar is worse than a
+* generic one.
+*/
+function normalizeError(raw, fallback = "Request failed") {
+	if (raw == null) return fallback;
+	if (raw instanceof Error) {
+		const own = text(raw.message);
+		if (own) return own;
+	} else {
+		if (typeof raw === "string") return text(raw) || fallback;
+		if (typeof raw === "number" || typeof raw === "boolean") return String(raw);
+	}
+	if (isObject(raw)) {
+		const obj = raw;
+		for (const key of MESSAGE_KEYS) {
+			const hit = text(obj[key]);
+			if (hit) return hit;
+		}
+		const response = obj.response;
+		if (isObject(response)) {
+			const nested = text(response.statusText) || text(response.message);
+			if (nested) return nested;
+		}
+		const status = errorStatus(obj);
+		if (status !== void 0 && status > 0) return `HTTP ${status}`;
+		if (raw instanceof Error) return text(raw.name) || fallback;
+		return fallback;
+	}
+	return text(String(raw)) || fallback;
+}
+/**
+* What the bar says for a status. English; an app puts its own language in
+* ONCE with `setErrorMessages()` rather than on every table.
+*/
+var DEFAULT_ERROR_MESSAGES = Object.freeze({
+	network: "Could not reach the server. Check your connection and try again.",
+	400: "The server rejected the request.",
+	401: "Your session has expired. Please sign in again.",
+	403: "You do not have permission to view this data.",
+	404: "The requested data could not be found.",
+	408: "The server took too long to respond. Please try again.",
+	409: "The request conflicts with the current state of the data.",
+	422: "The server could not process the request.",
+	429: "Too many requests. Please wait a moment and try again.",
+	500: "Something went wrong on the server. Please try again later.",
+	502: "The server is temporarily unavailable. Please try again later.",
+	503: "The server is temporarily unavailable. Please try again later.",
+	504: "The server took too long to respond. Please try again later.",
+	default: "Request failed"
+});
+var globalMessages = null;
+/**
+* App-wide wording, merged over the defaults; `null` restores them. A grid's own
+* `errorMessages` merges over this in turn, so a single table can still differ.
+*/
+function setErrorMessages(messages) {
+	globalMessages = messages ? { ...messages } : null;
+}
+/** Defaults ← app-wide ← `local`, same shape as the filter builder's `resolveTexts`. */
+function resolveErrorMessages(local) {
+	const merged = { ...DEFAULT_ERROR_MESSAGES };
+	for (const layer of [globalMessages, local]) {
+		if (!layer) continue;
+		for (const key of Object.keys(layer)) {
+			const value = layer[key];
+			if (typeof value === "string" && value.trim()) merged[key] = value;
+		}
+	}
+	return merged;
+}
+/**
+* The standard reason phrases. Not shown to anyone — they are what `describeError`
+* uses to recognise that an error's text is ONLY the phrase for its status
+* (`Error('Forbidden')` + `httpStatus: 403`), which adds nothing to the preset and
+* so is not a detail worth appending.
+*/
+var REASON_PHRASES = {
+	400: "Bad Request",
+	401: "Unauthorized",
+	402: "Payment Required",
+	403: "Forbidden",
+	404: "Not Found",
+	405: "Method Not Allowed",
+	408: "Request Timeout",
+	409: "Conflict",
+	410: "Gone",
+	412: "Precondition Failed",
+	413: "Payload Too Large",
+	415: "Unsupported Media Type",
+	422: "Unprocessable Entity",
+	429: "Too Many Requests",
+	500: "Internal Server Error",
+	501: "Not Implemented",
+	502: "Bad Gateway",
+	503: "Service Unavailable",
+	504: "Gateway Timeout"
+};
+/** Texts a transport mints for "no answer at all" — a status of 0 in words. */
+var NETWORK_TEXTS = [
+	"failed to fetch",
+	"networkerror when attempting to fetch resource",
+	"load failed",
+	"network error",
+	"unspecified network error",
+	"network connection timeout",
+	"network request failed"
+];
+var toStatus = (value) => {
+	if (value === null || value === void 0 || value === "") return void 0;
+	const n = Number(value);
+	return Number.isInteger(n) && n >= 0 && n < 1e3 ? n : void 0;
+};
+/**
+* The HTTP status an error carries, `0` for a network failure, `undefined` when
+* it has none.
+*
+* Reads the fields the common transports use — devextreme's `httpStatus`, a
+* fetch `Response` / axios error's `status` and `response.status`, ofetch's
+* `statusCode`, an OData error body's numeric `code` — on an `Error` instance as
+* readily as on a plain object, since devextreme `extend()`s them onto an
+* `Error`.
+*/
+function errorStatus(raw) {
+	if (!isObject(raw)) return void 0;
+	const response = isObject(raw.response) ? raw.response : void 0;
+	const direct = toStatus(raw.httpStatus) ?? toStatus(raw.status) ?? toStatus(raw.statusCode) ?? toStatus(response?.status) ?? toStatus(response?.statusCode);
+	if (direct !== void 0) return direct;
+	const code = toStatus((isObject(raw.errorDetails) ? raw.errorDetails : void 0)?.code);
+	if (code !== void 0 && code >= 400) return code;
+	const own = (raw instanceof Error ? text(raw.message) : text(raw.message)).toLowerCase();
+	if (own && NETWORK_TEXTS.some((t) => own.includes(t))) return 0;
+}
+/** A JSON response body handed over as text (an XHR's `responseText`), parsed; else undefined. */
+function parseBody(value) {
+	if (typeof value !== "string") return void 0;
+	const s = value.trim();
+	if (!s.startsWith("{") && !s.startsWith("[")) return void 0;
+	try {
+		return JSON.parse(s);
+	} catch {
+		return;
+	}
+}
+/** The "same message" key: case, spacing and trailing punctuation do not make two texts different. */
+var messageKey = (value) => value.toLowerCase().replace(/\s+/g, " ").replace(/[\s.!:;,]+$/, "").trim();
+/**
+* Keep each message once. Two texts are the same message when they match after
+* {@link messageKey}, and a text another kept one already CONTAINS adds nothing
+* ("Not found" next to "Not found: Order 42") — the longer, more specific one wins
+* and keeps its place in the order the messages were found.
+*/
+function uniqueMessages(found) {
+	const kept = [];
+	for (const t of found) {
+		const key = messageKey(t);
+		if (!key) continue;
+		if (kept.some((k) => k.key.includes(key))) continue;
+		const swallowed = kept.findIndex((k) => key.includes(k.key));
+		if (swallowed >= 0) {
+			kept[swallowed] = {
+				text: t,
+				key
+			};
+			for (let i = kept.length - 1; i > swallowed; i--) if (key.includes(kept[i].key)) kept.splice(i, 1);
+			continue;
+		}
+		kept.push({
+			text: t,
+			key
+		});
+	}
+	return kept.map((k) => k.text);
+}
+/**
+* Every message an error carries, combined the way `monoFetch`'s
+* `extractErrorMessage` does it: each key whose name contains "message"
+* (`message`, `errorMessage`, `Message`, …) holding text — or OData's
+* `{ message: { value } }` — at any depth up to 3, plus a JSON body still in
+* `responseText` / `responseJSON` / `response`, plus an `Error`'s own
+* (non-enumerable) `message`. The usual body fields `detail` / `title` and a
+* plain-text `response.data` count too.
+*
+* Deduplicated by {@link uniqueMessages}, transport boilerplate ("Bad Request",
+* "Failed to fetch") dropped, in the order found.
+*/
+function collectErrorMessages(raw, status = errorStatus(raw)) {
+	const found = [];
+	const add = (value) => {
+		const t = text(value);
+		if (t) found.push(t);
+	};
+	const seen = /* @__PURE__ */ new Set();
+	const visit = (val, depth) => {
+		if (!isObject(val) || depth > 3 || seen.has(val)) return;
+		seen.add(val);
+		if (val instanceof Error) add(val.message);
+		for (const [k, v] of Object.entries(val)) {
+			if (/message/i.test(k)) {
+				if (typeof v === "string") add(v);
+				else if (isObject(v) && typeof v.value === "string") add(v.value);
+			} else if (k === "detail" || k === "title" || k === "errorDetail") add(v);
+			else if (k === "responseText" || k === "response" || k === "data" || k === "_data") {
+				if (typeof v === "string") {
+					const body = parseBody(v);
+					if (body !== void 0) visit(body, depth + 1);
+					else if (k !== "response") add(v);
+				}
+			}
+			if (isObject(v)) visit(v, depth + 1);
+		}
+	};
+	if (typeof raw === "string") add(raw);
+	else visit(raw, 0);
+	return uniqueMessages(found).filter((t) => !isBoilerplate(t, status));
+}
+/** Is `value` nothing more than the reason phrase / a generic label for `status`? */
+function isBoilerplate(value, status) {
+	const v = value.toLowerCase();
+	if (!v || v === "error" || v === "unknown error" || v === "request failed") return true;
+	if (/^http\s*\d{3}$/.test(v)) return true;
+	if (NETWORK_TEXTS.some((t) => v.includes(t))) return true;
+	if (status !== void 0) {
+		const phrase = REASON_PHRASES[status]?.toLowerCase();
+		if (phrase && (v === phrase || v === `${status} ${phrase}` || v === `${status}`)) return true;
+		if (v === String(status)) return true;
+	}
+	return Object.values(REASON_PHRASES).some((p) => p.toLowerCase() === v);
+}
+/**
+* The one line a field shows for `err`: what the server said, every distinct
+* message combined (`monoFetch` style), or the headline when it said nothing.
+*/
+function errorText(err, separator = " · ") {
+	return err.messages.length ? err.messages.join(separator) : err.message;
+}
+/** The hover text: the headline, then everything the server said, each once. */
+function errorTitle(err) {
+	return uniqueMessages([err.message, ...err.messages]).join("\n");
+}
+/**
+* The line a person should read for `raw`.
+*
+* Order: a preset for the status (`'network'` for 0) → the error's own text →
+* `messages.default`. When a preset is the headline, whatever the server said
+* on top of the status becomes `detail`; without a preset, the raw text IS the
+* headline and only a distinct server body is a detail. Never throws, never
+* returns an empty `message`.
+*/
+function describeError(raw, messages) {
+	const texts = resolveErrorMessages(messages);
+	const status = errorStatus(raw);
+	const fallback = texts.default || DEFAULT_ERROR_MESSAGES.default;
+	const rawText = normalizeError(raw, fallback);
+	const preset = status === void 0 ? void 0 : status === 0 ? texts.network : texts[status];
+	const said = collectErrorMessages(raw, status).filter((m) => m !== preset);
+	if (preset) {
+		const out = {
+			message: preset,
+			status,
+			messages: said
+		};
+		if (said.length) out.detail = said.join("\n\n");
+		return out;
+	}
+	const message = rawText || fallback;
+	const rest = said.filter((m) => messageKey(m) !== messageKey(message));
+	const out = {
+		message,
+		messages: said
+	};
+	if (status !== void 0) out.status = status;
+	if (rest.length) out.detail = rest.join("\n\n");
+	return out;
+}
+/**
+* A load a newer load superseded (devextreme rejects it with `'canceled'`).
+* Not a failure — nothing should be shown for it.
+*/
+function isCanceled(err) {
+	if (!err) return false;
+	return err === "canceled" || err.name === "canceled" || err.message === "canceled" || err.__id === "canceled";
+}
+//#endregion
 //#region src/composables/reactive.ts
 /**
 * Unwrap a `ref()` / `computed()` wrapper and a `reactive()` proxy to the raw
@@ -786,4 +1084,4 @@ function unwrapReactiveDeep(value) {
 	return changed ? items : out;
 }
 //#endregion
-export { joinFilters as S, resolveSearchEntries as _, MonoSourceSearch as a, andPredicates as b, searchRowPredicate as c, expandWildcard as d, hasCustomSearch as f, plainSearchColumns as g, normalizeSearchExpr as h, DEFAULT_SEARCH_FIELDS as i, customPredicate as l, isWildcardPattern as m, unwrapReactive as n, mergeSearchFields as o, hasWildcardSearch as p, unwrapReactiveDeep as r, resolveSearchFields as s, resolveMaybeReactive as t, customRemoteClause as u, searchEntryFor as v, compileFilterPredicate as x, andFilters as y };
+export { compileFilterPredicate as A, isWildcardPattern as C, searchEntryFor as D, resolveSearchEntries as E, andFilters as O, hasWildcardSearch as S, plainSearchColumns as T, searchRowPredicate as _, describeError as a, expandWildcard as b, errorTitle as c, resolveErrorMessages as d, setErrorMessages as f, resolveSearchFields as g, mergeSearchFields as h, DEFAULT_ERROR_MESSAGES as i, joinFilters as j, andPredicates as k, isCanceled as l, MonoSourceSearch as m, unwrapReactive as n, errorStatus as o, DEFAULT_SEARCH_FIELDS as p, unwrapReactiveDeep as r, errorText as s, resolveMaybeReactive as t, normalizeError as u, customPredicate as v, normalizeSearchExpr as w, hasCustomSearch as x, customRemoteClause as y };

package/dist/src/components/card/card-core.d.ts

@@ -55,6 +55,7 @@ export declare class MonoCardCoreInterface {
     protected get _isInteractive(): boolean;
     protected get _isDisabled(): boolean;
     protected get _hasHeader(): boolean;
+    protected get _noSubtitle(): boolean;
     protected get _cardClasses(): string;
     protected _handleClick(event: MouseEvent): void;
     protected _handleKeyDown(event: KeyboardEvent): void;

package/dist/src/components/chart/chart-types.d.ts

@@ -2,6 +2,7 @@ import { CssSizeValue } from '../../composables/css-size';
 import { MonoGridSource } from '../table/mono-data-grid.js';
 import { MaybeReactive } from '../../composables/reactive.js';
 import { MonoDataSourceOptions, MonoOdataOptions } from '../../utils/data-source-options.js';
+import { DescribedError } from '../../utils/normalize-error.js';
 /** Chart.js chart types the addon exposes. */
 export type MonoChartType = 'bar' | 'line' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'scatter' | 'bubble';
 /** Aggregate applied to a series' values when rows are bucketed by `groupBy`. */
@@ -200,6 +201,13 @@ export interface MonoChartController<T = any> {
     readonly items: T[];
     /** True while the bound source is loading. */
     loading: boolean;
+    /**
+     * The last load failure, described for a person (`describeError`); null once
+     * a load succeeds. The chart element paints it with a ↻ that calls {@link retry}.
+     */
+    readonly error: DescribedError | null;
+    /** True once the source has answered at least once (or raw data was set). */
+    readonly hasLoaded: boolean;
     /** Current chart type. */
     type: MonoChartType;
     /** The bound source, or null. */
@@ -234,6 +242,8 @@ export interface MonoChartController<T = any> {
     reload(): Promise<void>;
     /** Alias of `reload()` — the call to make after the reactive state behind a base getter changed. */
     refresh(): Promise<void>;
+    /** `reload()` after a failure; never rejects (the failure lands on {@link error}). */
+    retry(): Promise<void>;
     /** Replace `dataSourceOptions` and reload. */
     setDataSourceOptions(next: MaybeReactive<MonoDataSourceOptions> | undefined): Promise<void>;
     /** Replace `odataOptions` and reload. */
@@ -277,6 +287,15 @@ export interface ChartCssClass {
  * itself, so setting them *from* the controller would be circular.
  */
 export interface MonoChartProps {
+    /** Spinner + `loadingText` over the plot — the app is still fetching what it shows. */
+    loading?: boolean;
+    loadingText?: string;
+    'loading-text'?: string;
+    /** The app's fetch failed: a string or the error itself. Painted with ↻, which fires `retry`. */
+    loadingError?: unknown;
+    'loading-error'?: unknown;
+    retryLabel?: string;
+    'retry-label'?: string;
     /**
      * Chart type. Ignored by the presets, which fix their own. When a controller
      * is bound this overrides the controller's `type`.