@livenetworks/ashlar 2.0.6 → 2.0.8

package/components/ln-core/number.js

@@ -1,125 +1,125 @@
-const _formatterCache = {};
-
-/**
- * Extract group and decimal separators dynamically from Intl.NumberFormat.
- * Supports standard commas, dots, and unicode narrow no-break space (U+202F) for fr-FR.
- *
- * @param {string} locale BCP 47 locale tag (e.g. 'en-US', 'mk-MK', 'fr-FR')
- * @returns {{ groupSep: string, decimalSep: string, fmt: Intl.NumberFormat }}
- */
-export function getSeparators(locale) {
-	const key = locale || 'default';
-	if (!_formatterCache[key]) {
-		const fmt = new Intl.NumberFormat(locale, { useGrouping: true });
-		const parts = fmt.formatToParts(1234.5);
-		let groupSep = '';
-		let decimalSep = '.';
-		for (let i = 0; i < parts.length; i++) {
-			if (parts[i].type === 'group') groupSep = parts[i].value;
-			if (parts[i].type === 'decimal') decimalSep = parts[i].value;
-		}
-		_formatterCache[key] = { groupSep, decimalSep, fmt };
-	}
-	return _formatterCache[key];
-}
-
-/**
- * Clean a numeric string by removing group separators, unicode spaces,
- * and normalizing the decimal separator to a period ('.').
- *
- * @param {string} raw Raw user input or string representation
- * @param {string} groupSep Group (thousands) separator
- * @param {string} decimalSep Decimal separator
- * @returns {string} Standardized numeric string (e.g. "1234.56" or "-10")
- */
-export function cleanNumericString(raw, groupSep, decimalSep) {
-	if (raw == null || typeof raw !== 'string') return '';
-	let str = raw.trim();
-	if (str === '') return '';
-
-	// Remove common currency symbols
-	str = str.replace(/[$€£¥]/g, '');
-
-	// Remove group separators if present
-	if (groupSep) {
-		str = str.split(groupSep).join('');
-	}
-
-	// Remove all Unicode whitespace characters (covers space, U+00A0, U+202F, etc.)
-	str = str.replace(/\s/g, '');
-
-	// Normalize decimal separator to '.'
-	if (decimalSep && decimalSep !== '.') {
-		str = str.replace(decimalSep, '.');
-	}
-
-	// Strip any remaining characters except digits, minus, and dot
-	str = str.replace(/[^\d.-]/g, '');
-
-	return str;
-}
-
-/**
- * Parse a localized numeric string or raw value into a valid floating-point number.
- *
- * @param {unknown} raw Raw string or number
- * @param {string} locale BCP 47 locale tag
- * @returns {number} Parsed float or NaN if invalid
- */
-export function parseNumber(raw, locale) {
-	if (typeof raw === 'number') return isNaN(raw) ? NaN : raw;
-	if (raw == null || typeof raw !== 'string') return NaN;
-	const trimmed = raw.trim();
-	if (trimmed === '' || trimmed === '-') return NaN;
-
-	const info = getSeparators(locale);
-	const cleaned = cleanNumericString(trimmed, info.groupSep, info.decimalSep);
-	if (cleaned === '' || cleaned === '-') return NaN;
-
-	const num = parseFloat(cleaned);
-	return isNaN(num) ? NaN : num;
-}
-
-/**
- * Format a number using Intl.NumberFormat according to specified locale and options.
- *
- * @param {number} num Number to format
- * @param {string} [locale='default'] BCP 47 locale tag
- * @param {Object} [options] Formatting options
- * @param {number|null} [options.maxDecimals] Maximum fraction digits limit
- * @param {number} [options.userDecimals] Exact fraction digits to preserve during typing
- * @returns {string} Formatted number string
- */
-export function formatNumber(num, locale, options = {}) {
-	if (typeof num !== 'number' || isNaN(num) || !Number.isFinite(num)) return '';
-
-	const loc = locale || 'default';
-	const maxDecimals = options.maxDecimals != null ? parseInt(options.maxDecimals, 10) : null;
-	const userDecimals = options.userDecimals != null ? options.userDecimals : null;
-
-	if (maxDecimals !== null) {
-		const cacheKey = loc + '|max:' + maxDecimals;
-		if (!_formatterCache[cacheKey]) {
-			_formatterCache[cacheKey] = new Intl.NumberFormat(locale, {
-				useGrouping: true,
-				minimumFractionDigits: 0,
-				maximumFractionDigits: maxDecimals
-			});
-		}
-		return _formatterCache[cacheKey].format(num);
-	}
-
-	if (userDecimals !== null && userDecimals > 0) {
-		const cacheKey = loc + '|exact:' + userDecimals;
-		if (!_formatterCache[cacheKey]) {
-			_formatterCache[cacheKey] = new Intl.NumberFormat(locale, {
-				useGrouping: true,
-				minimumFractionDigits: userDecimals,
-				maximumFractionDigits: userDecimals
-			});
-		}
-		return _formatterCache[cacheKey].format(num);
-	}
-
-	return getSeparators(locale).fmt.format(num);
-}
+const _formatterCache = {};
+
+/**
+ * Extract group and decimal separators dynamically from Intl.NumberFormat.
+ * Supports standard commas, dots, and unicode narrow no-break space (U+202F) for fr-FR.
+ *
+ * @param {string} locale BCP 47 locale tag (e.g. 'en-US', 'mk-MK', 'fr-FR')
+ * @returns {{ groupSep: string, decimalSep: string, fmt: Intl.NumberFormat }}
+ */
+export function getSeparators(locale) {
+	const key = locale || 'default';
+	if (!_formatterCache[key]) {
+		const fmt = new Intl.NumberFormat(locale, { useGrouping: true });
+		const parts = fmt.formatToParts(1234.5);
+		let groupSep = '';
+		let decimalSep = '.';
+		for (let i = 0; i < parts.length; i++) {
+			if (parts[i].type === 'group') groupSep = parts[i].value;
+			if (parts[i].type === 'decimal') decimalSep = parts[i].value;
+		}
+		_formatterCache[key] = { groupSep, decimalSep, fmt };
+	}
+	return _formatterCache[key];
+}
+
+/**
+ * Clean a numeric string by removing group separators, unicode spaces,
+ * and normalizing the decimal separator to a period ('.').
+ *
+ * @param {string} raw Raw user input or string representation
+ * @param {string} groupSep Group (thousands) separator
+ * @param {string} decimalSep Decimal separator
+ * @returns {string} Standardized numeric string (e.g. "1234.56" or "-10")
+ */
+export function cleanNumericString(raw, groupSep, decimalSep) {
+	if (raw == null || typeof raw !== 'string') return '';
+	let str = raw.trim();
+	if (str === '') return '';
+
+	// Remove common currency symbols
+	str = str.replace(/[$€£¥]/g, '');
+
+	// Remove group separators if present
+	if (groupSep) {
+		str = str.split(groupSep).join('');
+	}
+
+	// Remove all Unicode whitespace characters (covers space, U+00A0, U+202F, etc.)
+	str = str.replace(/\s/g, '');
+
+	// Normalize decimal separator to '.'
+	if (decimalSep && decimalSep !== '.') {
+		str = str.replace(decimalSep, '.');
+	}
+
+	// Strip any remaining characters except digits, minus, and dot
+	str = str.replace(/[^\d.-]/g, '');
+
+	return str;
+}
+
+/**
+ * Parse a localized numeric string or raw value into a valid floating-point number.
+ *
+ * @param {unknown} raw Raw string or number
+ * @param {string} locale BCP 47 locale tag
+ * @returns {number} Parsed float or NaN if invalid
+ */
+export function parseNumber(raw, locale) {
+	if (typeof raw === 'number') return isNaN(raw) ? NaN : raw;
+	if (raw == null || typeof raw !== 'string') return NaN;
+	const trimmed = raw.trim();
+	if (trimmed === '' || trimmed === '-') return NaN;
+
+	const info = getSeparators(locale);
+	const cleaned = cleanNumericString(trimmed, info.groupSep, info.decimalSep);
+	if (cleaned === '' || cleaned === '-') return NaN;
+
+	const num = parseFloat(cleaned);
+	return isNaN(num) ? NaN : num;
+}
+
+/**
+ * Format a number using Intl.NumberFormat according to specified locale and options.
+ *
+ * @param {number} num Number to format
+ * @param {string} [locale='default'] BCP 47 locale tag
+ * @param {Object} [options] Formatting options
+ * @param {number|null} [options.maxDecimals] Maximum fraction digits limit
+ * @param {number} [options.userDecimals] Exact fraction digits to preserve during typing
+ * @returns {string} Formatted number string
+ */
+export function formatNumber(num, locale, options = {}) {
+	if (typeof num !== 'number' || isNaN(num) || !Number.isFinite(num)) return '';
+
+	const loc = locale || 'default';
+	const maxDecimals = options.maxDecimals != null ? parseInt(options.maxDecimals, 10) : null;
+	const userDecimals = options.userDecimals != null ? options.userDecimals : null;
+
+	if (maxDecimals !== null) {
+		const cacheKey = loc + '|max:' + maxDecimals;
+		if (!_formatterCache[cacheKey]) {
+			_formatterCache[cacheKey] = new Intl.NumberFormat(locale, {
+				useGrouping: true,
+				minimumFractionDigits: 0,
+				maximumFractionDigits: maxDecimals
+			});
+		}
+		return _formatterCache[cacheKey].format(num);
+	}
+
+	if (userDecimals !== null && userDecimals > 0) {
+		const cacheKey = loc + '|exact:' + userDecimals;
+		if (!_formatterCache[cacheKey]) {
+			_formatterCache[cacheKey] = new Intl.NumberFormat(locale, {
+				useGrouping: true,
+				minimumFractionDigits: userDecimals,
+				maximumFractionDigits: userDecimals
+			});
+		}
+		return _formatterCache[cacheKey].format(num);
+	}
+
+	return getSeparators(locale).fmt.format(num);
+}

package/components/ln-core/template.js

@@ -1,206 +1,206 @@
-// ─── Template Cache ────────────────────────────────────────
-const _tmplCache = {};
-
-/**
- * Clone a <template data-ln-template="name"> element.
- * Cached after first lookup.
- */
-export function cloneTemplate(name, componentTag) {
-	if (!_tmplCache[name]) {
-		_tmplCache[name] = document.querySelector('[data-ln-template="' + name + '"]');
-	}
-	const tmpl = _tmplCache[name];
-	if (!tmpl) {
-		console.warn('[' + (componentTag || 'ln-core') + '] Template "' + name + '" not found');
-		return null;
-	}
-	return tmpl.content.cloneNode(true);
-}
-
-export function cloneTemplateScoped(root, name, componentTag) {
-	if (root) {
-		const local = root.querySelector('[data-ln-template="' + name + '"]');
-		if (local) return local.content.cloneNode(true);
-	}
-	return cloneTemplate(name, componentTag);
-}
-
-// ─── Declarative DOM Binding ───────────────────────────────
-
-export function fill(root, data) {
-	if (!root || !data) return root;
-
-	const fields = root.querySelectorAll('[data-ln-field]');
-	for (let i = 0; i < fields.length; i++) {
-		const el = fields[i];
-		const prop = el.getAttribute('data-ln-field');
-		if (data[prop] != null) {
-			el.textContent = data[prop];
-		}
-	}
-
-	const attrs = root.querySelectorAll('[data-ln-attr]');
-	for (let i = 0; i < attrs.length; i++) {
-		const el = attrs[i];
-		const pairs = el.getAttribute('data-ln-attr').split(',');
-		for (let j = 0; j < pairs.length; j++) {
-			const parts = pairs[j].trim().split(':');
-			if (parts.length !== 2) continue;
-			const attr = parts[0].trim();
-			const prop = parts[1].trim();
-			if (data[prop] != null) {
-				el.setAttribute(attr, data[prop]);
-			}
-		}
-	}
-
-	const shows = root.querySelectorAll('[data-ln-show]');
-	for (let i = 0; i < shows.length; i++) {
-		const el = shows[i];
-		const prop = el.getAttribute('data-ln-show');
-		if (prop in data) {
-			el.classList.toggle('hidden', !data[prop]);
-		}
-	}
-
-	const classes = root.querySelectorAll('[data-ln-class]');
-	for (let i = 0; i < classes.length; i++) {
-		const el = classes[i];
-		const pairs = el.getAttribute('data-ln-class').split(',');
-		for (let j = 0; j < pairs.length; j++) {
-			const parts = pairs[j].trim().split(':');
-			if (parts.length !== 2) continue;
-			const cls = parts[0].trim();
-			const prop = parts[1].trim();
-			if (prop in data) {
-				el.classList.toggle(cls, !!data[prop]);
-			}
-		}
-	}
-
-	return root;
-}
-
-// ─── Event-driven fill fan-out ─────────────────────────────
-
-export function lnFill(container, record) {
-	if (container.matches && container.matches('[data-ln-form], [data-ln-fillable]')) {
-		if (window.lnCore._debugSink) window.lnCore._debugSink('event', 'ln-fill', container, record ?? null);
-		container.dispatchEvent(new CustomEvent('ln-fill', { detail: record ?? null, bubbles: true }));
-	}
-	const targets = container.querySelectorAll('[data-ln-form], [data-ln-fillable]');
-	for (let i = 0; i < targets.length; i++) {
-		if (window.lnCore._debugSink) window.lnCore._debugSink('event', 'ln-fill', targets[i], record ?? null);
-		targets[i].dispatchEvent(new CustomEvent('ln-fill', { detail: record ?? null, bubbles: true }));
-	}
-	return container;
-}
-
-if (typeof window !== 'undefined') {
-	window.lnCore = window.lnCore || {};
-	if (!window.lnCore._fillBound) {
-		window.lnCore._fillBound = true;
-		document.addEventListener('ln-fill', function (e) {
-			if (!e.target.matches || !e.target.matches('[data-ln-fillable]')) return;
-			if (e.detail) {
-				fill(e.target, e.detail);
-			} else {
-				const fields = e.target.querySelectorAll('[data-ln-field]');
-				for (let i = 0; i < fields.length; i++) {
-					fields[i].textContent = '';
-				}
-			}
-		});
-	}
-}
-
-// ─── Template Text-Node Placeholders ──────────────────────
-
-export function fillTemplate(clone, data) {
-	if (!clone || !data) return clone;
-
-	const walker = document.createTreeWalker(clone, NodeFilter.SHOW_TEXT);
-	while (walker.nextNode()) {
-		const node = walker.currentNode;
-		if (node.textContent.indexOf('{{') !== -1) {
-			node.textContent = node.textContent.replace(
-				/\{\{\s*(\w+)\s*\}\}/g,
-				function (_, key) { return data[key] !== undefined ? data[key] : ''; }
-			);
-		}
-	}
-
-	const _replaceTokens = function (_, key) { return data[key] !== undefined ? data[key] : ''; };
-	const elements = Array.from(clone.querySelectorAll('*'));
-	if (clone.nodeType === 1) elements.push(clone);
-	for (let i = 0; i < elements.length; i++) {
-		const el = elements[i];
-		const attrs = el.attributes;
-		for (let j = 0; j < attrs.length; j++) {
-			const attr = attrs[j];
-			if (attr.value.indexOf('{{') !== -1) {
-				el.setAttribute(attr.name, attr.value.replace(/\{\{\s*(\w+)\s*\}\}/g, _replaceTokens));
-			}
-		}
-	}
-
-	return clone;
-}
-
-// ─── Keyed List Rendering ──────────────────────────────────
-
-export function renderList(container, items, templateName, keyFn, fillFn, componentTag) {
-	const existingByKey = {};
-	for (let i = 0; i < container.children.length; i++) {
-		const child = container.children[i];
-		const key = child.getAttribute('data-ln-render-key');
-		if (key) existingByKey[key] = child;
-	}
-
-	const frag = document.createDocumentFragment();
-
-	for (let i = 0; i < items.length; i++) {
-		const item = items[i];
-		const key = String(keyFn(item));
-		let el = existingByKey[key];
-
-		if (el) {
-			fillFn(el, item, i);
-		} else {
-			const clone = cloneTemplate(templateName, componentTag);
-			if (!clone) continue;
-			fillTemplate(clone, item);
-			el = clone.firstElementChild;
-			if (!el) continue;
-			el.setAttribute('data-ln-render-key', key);
-			fillFn(el, item, i);
-		}
-		frag.appendChild(el);
-	}
-
-	container.textContent = '';
-	container.appendChild(frag);
-}
-
-// ─── Dictionary (i18n) ────────────────────────────────────
-
-/**
- * Build a plain object from hidden dictionary elements.
- */
-export function buildDict(root, selector) {
-	const dict = {};
-	const els = root.querySelectorAll('[' + selector + ']');
-	for (let i = 0; i < els.length; i++) {
-		dict[els[i].getAttribute(selector)] = els[i].textContent;
-		els[i].remove();
-	}
-	return dict;
-}
-
-if (typeof window !== 'undefined') {
-	window.lnCore = window.lnCore || {};
-	window.lnCore.fillTemplate = fillTemplate;
-	window.lnCore.fill = fill;
-	window.lnCore.lnFill = lnFill;
-	window.lnCore.renderList = renderList;
-}
+// ─── Template Cache ────────────────────────────────────────
+const _tmplCache = {};
+
+/**
+ * Clone a <template data-ln-template="name"> element.
+ * Cached after first lookup.
+ */
+export function cloneTemplate(name, componentTag) {
+	if (!_tmplCache[name]) {
+		_tmplCache[name] = document.querySelector('[data-ln-template="' + name + '"]');
+	}
+	const tmpl = _tmplCache[name];
+	if (!tmpl) {
+		console.warn('[' + (componentTag || 'ln-core') + '] Template "' + name + '" not found');
+		return null;
+	}
+	return tmpl.content.cloneNode(true);
+}
+
+export function cloneTemplateScoped(root, name, componentTag) {
+	if (root) {
+		const local = root.querySelector('[data-ln-template="' + name + '"]');
+		if (local) return local.content.cloneNode(true);
+	}
+	return cloneTemplate(name, componentTag);
+}
+
+// ─── Declarative DOM Binding ───────────────────────────────
+
+export function fill(root, data) {
+	if (!root || !data) return root;
+
+	const fields = root.querySelectorAll('[data-ln-field]');
+	for (let i = 0; i < fields.length; i++) {
+		const el = fields[i];
+		const prop = el.getAttribute('data-ln-field');
+		if (data[prop] != null) {
+			el.textContent = data[prop];
+		}
+	}
+
+	const attrs = root.querySelectorAll('[data-ln-attr]');
+	for (let i = 0; i < attrs.length; i++) {
+		const el = attrs[i];
+		const pairs = el.getAttribute('data-ln-attr').split(',');
+		for (let j = 0; j < pairs.length; j++) {
+			const parts = pairs[j].trim().split(':');
+			if (parts.length !== 2) continue;
+			const attr = parts[0].trim();
+			const prop = parts[1].trim();
+			if (data[prop] != null) {
+				el.setAttribute(attr, data[prop]);
+			}
+		}
+	}
+
+	const shows = root.querySelectorAll('[data-ln-show]');
+	for (let i = 0; i < shows.length; i++) {
+		const el = shows[i];
+		const prop = el.getAttribute('data-ln-show');
+		if (prop in data) {
+			el.classList.toggle('hidden', !data[prop]);
+		}
+	}
+
+	const classes = root.querySelectorAll('[data-ln-class]');
+	for (let i = 0; i < classes.length; i++) {
+		const el = classes[i];
+		const pairs = el.getAttribute('data-ln-class').split(',');
+		for (let j = 0; j < pairs.length; j++) {
+			const parts = pairs[j].trim().split(':');
+			if (parts.length !== 2) continue;
+			const cls = parts[0].trim();
+			const prop = parts[1].trim();
+			if (prop in data) {
+				el.classList.toggle(cls, !!data[prop]);
+			}
+		}
+	}
+
+	return root;
+}
+
+// ─── Event-driven fill fan-out ─────────────────────────────
+
+export function lnFill(container, record) {
+	if (container.matches && container.matches('[data-ln-form], [data-ln-fillable]')) {
+		if (window.lnCore._debugSink) window.lnCore._debugSink('event', 'ln-fill', container, record ?? null);
+		container.dispatchEvent(new CustomEvent('ln-fill', { detail: record ?? null, bubbles: true }));
+	}
+	const targets = container.querySelectorAll('[data-ln-form], [data-ln-fillable]');
+	for (let i = 0; i < targets.length; i++) {
+		if (window.lnCore._debugSink) window.lnCore._debugSink('event', 'ln-fill', targets[i], record ?? null);
+		targets[i].dispatchEvent(new CustomEvent('ln-fill', { detail: record ?? null, bubbles: true }));
+	}
+	return container;
+}
+
+if (typeof window !== 'undefined') {
+	window.lnCore = window.lnCore || {};
+	if (!window.lnCore._fillBound) {
+		window.lnCore._fillBound = true;
+		document.addEventListener('ln-fill', function (e) {
+			if (!e.target.matches || !e.target.matches('[data-ln-fillable]')) return;
+			if (e.detail) {
+				fill(e.target, e.detail);
+			} else {
+				const fields = e.target.querySelectorAll('[data-ln-field]');
+				for (let i = 0; i < fields.length; i++) {
+					fields[i].textContent = '';
+				}
+			}
+		});
+	}
+}
+
+// ─── Template Text-Node Placeholders ──────────────────────
+
+export function fillTemplate(clone, data) {
+	if (!clone || !data) return clone;
+
+	const walker = document.createTreeWalker(clone, NodeFilter.SHOW_TEXT);
+	while (walker.nextNode()) {
+		const node = walker.currentNode;
+		if (node.textContent.indexOf('{{') !== -1) {
+			node.textContent = node.textContent.replace(
+				/\{\{\s*(\w+)\s*\}\}/g,
+				function (_, key) { return data[key] !== undefined ? data[key] : ''; }
+			);
+		}
+	}
+
+	const _replaceTokens = function (_, key) { return data[key] !== undefined ? data[key] : ''; };
+	const elements = Array.from(clone.querySelectorAll('*'));
+	if (clone.nodeType === 1) elements.push(clone);
+	for (let i = 0; i < elements.length; i++) {
+		const el = elements[i];
+		const attrs = el.attributes;
+		for (let j = 0; j < attrs.length; j++) {
+			const attr = attrs[j];
+			if (attr.value.indexOf('{{') !== -1) {
+				el.setAttribute(attr.name, attr.value.replace(/\{\{\s*(\w+)\s*\}\}/g, _replaceTokens));
+			}
+		}
+	}
+
+	return clone;
+}
+
+// ─── Keyed List Rendering ──────────────────────────────────
+
+export function renderList(container, items, templateName, keyFn, fillFn, componentTag) {
+	const existingByKey = {};
+	for (let i = 0; i < container.children.length; i++) {
+		const child = container.children[i];
+		const key = child.getAttribute('data-ln-render-key');
+		if (key) existingByKey[key] = child;
+	}
+
+	const frag = document.createDocumentFragment();
+
+	for (let i = 0; i < items.length; i++) {
+		const item = items[i];
+		const key = String(keyFn(item));
+		let el = existingByKey[key];
+
+		if (el) {
+			fillFn(el, item, i);
+		} else {
+			const clone = cloneTemplate(templateName, componentTag);
+			if (!clone) continue;
+			fillTemplate(clone, item);
+			el = clone.firstElementChild;
+			if (!el) continue;
+			el.setAttribute('data-ln-render-key', key);
+			fillFn(el, item, i);
+		}
+		frag.appendChild(el);
+	}
+
+	container.textContent = '';
+	container.appendChild(frag);
+}
+
+// ─── Dictionary (i18n) ────────────────────────────────────
+
+/**
+ * Build a plain object from hidden dictionary elements.
+ */
+export function buildDict(root, selector) {
+	const dict = {};
+	const els = root.querySelectorAll('[' + selector + ']');
+	for (let i = 0; i < els.length; i++) {
+		dict[els[i].getAttribute(selector)] = els[i].textContent;
+		els[i].remove();
+	}
+	return dict;
+}
+
+if (typeof window !== 'undefined') {
+	window.lnCore = window.lnCore || {};
+	window.lnCore.fillTemplate = fillTemplate;
+	window.lnCore.fill = fill;
+	window.lnCore.lnFill = lnFill;
+	window.lnCore.renderList = renderList;
+}

package/components/ln-couchdb-connector/README.md

@@ -177,3 +177,7 @@ Ingress: every fetched/created/updated document gets `id = _id` before reaching
 ### Envelope unwrap
 
 Same `{message, content}` presence-check as `ln-api-connector` (see its README) — `content` replaces the bare CouchDB body when present, `message` rides opaquely on the `:created`/`:updated`/`:deleted`/`:bulk-deleted` event detail. Raw CouchDB never sends this envelope, so a direct CouchDB backend never toasts; only a proxy/gateway that wraps responses can opt in.
+
+### Async Cancellation & Lifecycle (`destroy()`)
+
+In `destroy()`, any in-flight delta changes feed fetch (`fetchDelta`) is aborted via an internal `AbortController` (`_deltaController`), and its aborted promise rejection is safely ignored to prevent uncaught errors or stale event dispatches after element teardown. In accordance with offline sync data integrity rules, mutation requests (POST/PUT/DELETE) are not aborted mid-flight to avoid ambiguous states where the remote database commits a write while the client treats it as aborted.