@livenetworks/ashlar 2.1.13 → 2.2.1

package/components/ln-core/README.md

@@ -559,24 +559,24 @@ const batchRender = createBatcher(
 
 ---
 
-## Reactive Rendering Pattern
-
-The `createBatcher` primitive and DOM rendering helpers (`fill`, `renderList`) are designed to be used together as the canonical ln-ashlar microtask render loop:
-
-1. **State mutation.** Component updates internal data properties (e.g. `this.state.key = 'val'`).
-2. **Microtask queue.** The component triggers the `schedule()` function returned by `createBatcher`. Any number of synchronous assignments in the same sync block schedule a single microtask.
-3. **One render.** When the microtask fires, the batcher calls `renderFn` exactly once. `renderFn` typically calls `fill(this.dom, this.state)` (or `renderList` for keyed collections) to project state into the DOM, then the optional `afterRender` callback fires (commonly used to dispatch a `ln-{component}:rendered` or changed event).
-
-Two state assignments on the same tick produce one DOM update:
-
-The pattern is: **state mutation → microtask queue → one render**.
-Never wire sync state updates directly to immediate DOM writes when multiple attributes or filter parameters can change simultaneously — batching prevents layout thrashing.
-
-For further details, see
-[Reactive Rendering Pattern in components/COMPONENTS.md](../../components/COMPONENTS.md#reactive-rendering-pattern).
-
----
-
+## Reactive Rendering Pattern
+
+The `createBatcher` primitive and DOM rendering helpers (`fill`, `renderList`) are designed to be used together as the canonical ln-ashlar microtask render loop:
+
+1. **State mutation.** Component updates internal data properties (e.g. `this.state.key = 'val'`).
+2. **Microtask queue.** The component triggers the `schedule()` function returned by `createBatcher`. Any number of synchronous assignments in the same sync block schedule a single microtask.
+3. **One render.** When the microtask fires, the batcher calls `renderFn` exactly once. `renderFn` typically calls `fill(this.dom, this.state)` (or `renderList` for keyed collections) to project state into the DOM, then the optional `afterRender` callback fires (commonly used to dispatch a `ln-{component}:rendered` or changed event).
+
+Two state assignments on the same tick produce one DOM update:
+
+The pattern is: **state mutation → microtask queue → one render**.
+Never wire sync state updates directly to immediate DOM writes when multiple attributes or filter parameters can change simultaneously — batching prevents layout thrashing.
+
+For further details, see
+[Reactive Rendering Pattern in components/COMPONENTS.md](../../components/COMPONENTS.md#reactive-rendering-pattern).
+
+---
+
 ## window-cache.js
 
 ### createWindowCache(config)
@@ -951,9 +951,9 @@ import { dispatch, dispatchCancelable, guardBody, findElements, createBatcher, f
         const self = this;
 
         // Reactive state + batched rendering
-                this.state = { items: [] };
-        this.batchRender = createBatcher(function () {
-            if (!self._destroyed) self._render();
+                this.state = { items: [] };
+        this.batchRender = createBatcher(function () {
+            if (!self._destroyed) self._render();
         });
 
         return this;

package/components/ln-core/ln-core.schema.json

@@ -1,120 +1,120 @@
-{
-	"$comment": "This file is partly generated. The $comment, component, generator, and each attribute's direction, sources, type, values, fallback, and description keys are owned by the generator and synchronized from JS source code. All other keys are preserved and safe to hand-author. Regenerate with `npm run sync:ln-schemas`.",
-	"component": "ln-core",
-	"generator": "scripts/sync-ln-schemas.mjs",
-	"attributes": {
-		"data-ln-attr": {
-			"direction": "author",
-			"sources": [
-				"template.js"
-			]
-		},
-		"data-ln-class": {
-			"direction": "author",
-			"sources": [
-				"template.js"
-			]
-		},
-		"data-ln-debug": {
-			"direction": "author",
-			"sources": [
-				"events.js"
-			]
-		},
-		"data-ln-field": {
-			"direction": "author",
-			"sources": [
-				"template.js"
-			]
-		},
-		"data-ln-fill-as": {
-			"direction": "author",
-			"sources": [
-				"form.js"
-			]
-		},
-		"data-ln-fillable": {
-			"direction": "author",
-			"sources": [
-				"template.js"
-			]
-		},
-		"data-ln-filter": {
-			"direction": "author",
-			"sources": [
-				"hash.js",
-				"query.js"
-			]
-		},
-		"data-ln-form": {
-			"direction": "author",
-			"sources": [
-				"template.js"
-			]
-		},
-		"data-ln-hash": {
-			"direction": "author",
-			"sources": [
-				"hash.js"
-			]
-		},
-		"data-ln-persist": {
-			"direction": "author",
-			"sources": [
-				"lifecycle.js"
-			]
-		},
-		"data-ln-query": {
-			"direction": "author",
-			"sources": [
-				"query.js"
-			]
-		},
-		"data-ln-render-key": {
-			"direction": "both",
-			"sources": [
-				"template.js"
-			]
-		},
-		"data-ln-search": {
-			"direction": "author",
-			"sources": [
-				"hash.js",
-				"query.js"
-			]
-		},
-		"data-ln-search-for": {
-			"direction": "author",
-			"sources": [
-				"hash.js",
-				"query.js"
-			]
-		},
-		"data-ln-show": {
-			"direction": "author",
-			"sources": [
-				"template.js"
-			]
-		},
-		"data-ln-sort": {
-			"direction": "author",
-			"sources": [
-				"hash.js",
-				"query.js"
-			]
-		},
-		"data-ln-template": {
-			"direction": "author",
-			"sources": [
-				"template.js"
-			]
-		},
-		"data-ln-value": {
-			"direction": "both",
-			"sources": [
-				"dom.js",
-				"form.js"
-			]
-		}
-	}
-}
+{
+	"$comment": "This file is partly generated. The $comment, component, generator, and each attribute's direction, sources, type, values, fallback, and description keys are owned by the generator and synchronized from JS source code. All other keys are preserved and safe to hand-author. Regenerate with `npm run sync:ln-schemas`.",
+	"component": "ln-core",
+	"generator": "scripts/sync-ln-schemas.mjs",
+	"attributes": {
+		"data-ln-attr": {
+			"direction": "author",
+			"sources": [
+				"template.js"
+			]
+		},
+		"data-ln-class": {
+			"direction": "author",
+			"sources": [
+				"template.js"
+			]
+		},
+		"data-ln-debug": {
+			"direction": "author",
+			"sources": [
+				"events.js"
+			]
+		},
+		"data-ln-field": {
+			"direction": "author",
+			"sources": [
+				"template.js"
+			]
+		},
+		"data-ln-fill-as": {
+			"direction": "author",
+			"sources": [
+				"form.js"
+			]
+		},
+		"data-ln-fillable": {
+			"direction": "author",
+			"sources": [
+				"template.js"
+			]
+		},
+		"data-ln-filter": {
+			"direction": "author",
+			"sources": [
+				"hash.js",
+				"query.js"
+			]
+		},
+		"data-ln-form": {
+			"direction": "author",
+			"sources": [
+				"template.js"
+			]
+		},
+		"data-ln-hash": {
+			"direction": "author",
+			"sources": [
+				"hash.js"
+			]
+		},
+		"data-ln-persist": {
+			"direction": "author",
+			"sources": [
+				"lifecycle.js"
+			]
+		},
+		"data-ln-query": {
+			"direction": "author",
+			"sources": [
+				"query.js"
+			]
+		},
+		"data-ln-render-key": {
+			"direction": "both",
+			"sources": [
+				"template.js"
+			]
+		},
+		"data-ln-search": {
+			"direction": "author",
+			"sources": [
+				"hash.js",
+				"query.js"
+			]
+		},
+		"data-ln-search-for": {
+			"direction": "author",
+			"sources": [
+				"hash.js",
+				"query.js"
+			]
+		},
+		"data-ln-show": {
+			"direction": "author",
+			"sources": [
+				"template.js"
+			]
+		},
+		"data-ln-sort": {
+			"direction": "author",
+			"sources": [
+				"hash.js",
+				"query.js"
+			]
+		},
+		"data-ln-template": {
+			"direction": "author",
+			"sources": [
+				"template.js"
+			]
+		},
+		"data-ln-value": {
+			"direction": "both",
+			"sources": [
+				"dom.js",
+				"form.js"
+			]
+		}
+	}
+}

package/components/ln-core/query.js

@@ -1,113 +1,113 @@
-// ─── Query String codec (URL search params as reactive state) ──
-//
-// Allows components (ln-search, ln-filter, ln-sort) to bind to URL search
-// parameters (?search=foo&status=active&sort=amount.desc) in SPAs without
-// polluting or colliding with the URL hash fragment (#modal, #tab).
-//
-// Write mechanism: `history.replaceState` (does not reload the page or pollute history).
-// Read mechanism: `URLSearchParams` on window.location.search.
-// Navigation: Reacts to `popstate` events on browser Back/Forward navigation.
-
-function _stripSearch(str) {
-	return (str || '').replace(/^\?/, '');
-}
-
-export function queryParse(searchStr) {
-	const raw = (searchStr === undefined)
-		? (typeof window !== 'undefined' ? window.location.search : '')
-		: searchStr;
-	const map = {};
-	const s = _stripSearch(raw);
-	if (!s) return map;
-	const params = new URLSearchParams(s);
-	for (const [key, val] of params.entries()) {
-		map[key] = val;
-	}
-	return map;
-}
-
-export function queryGet(key) {
-	if (!key || typeof window === 'undefined') return null;
-	const params = new URLSearchParams(window.location.search);
-	return params.has(key) ? params.get(key) : null;
-}
-
-export function querySet(key, value) {
-	if (!key || typeof window === 'undefined') return;
-	const url = new URL(window.location.href);
-
-	if (value === null || value === undefined || value === '') {
-		url.searchParams.delete(key);
-	} else {
-		url.searchParams.set(key, String(value));
-	}
-
-	if (url.search === window.location.search) return;
-
-	const nextUrl = url.pathname + url.search + url.hash;
-	window.history.replaceState(window.history.state, '', nextUrl);
-}
-
-export function resolveQueryParam(el, defaultSuffix) {
-	if (!el || !el.hasAttribute('data-ln-query')) return null;
-	const explicit = el.getAttribute('data-ln-query');
-	if (explicit && explicit.trim() !== '') return explicit.trim();
-	const targetId = el.getAttribute('data-ln-sort')
-		|| el.getAttribute('data-ln-search-for')
-		|| el.getAttribute('data-ln-search')
-		|| el.getAttribute('data-ln-filter')
-		|| el.id;
-	if (targetId) {
-		return defaultSuffix ? (targetId + '_' + defaultSuffix) : targetId;
-	}
-	return defaultSuffix || null;
-}
-
-export function querySortEncode(fieldOrColumn, direction) {
-	if (!direction || direction === 'none' || fieldOrColumn === null || fieldOrColumn === undefined) return null;
-	return String(fieldOrColumn) + '.' + direction;
-}
-
-export function querySortDecode(val, queryParams) {
-	if (val && typeof val === 'string') {
-		if (val.endsWith('.asc')) {
-			return { fieldOrColumn: val.slice(0, -4), direction: 'asc' };
-		}
-		if (val.endsWith('.desc')) {
-			return { fieldOrColumn: val.slice(0, -5), direction: 'desc' };
-		}
-	}
-	if (queryParams && typeof queryParams === 'object') {
-		const field = queryParams.sort_field || queryParams.sort_by;
-		if (field) {
-			const dir = (queryParams.sort_dir && String(queryParams.sort_dir).toLowerCase() === 'desc') ? 'desc' : 'asc';
-			return { fieldOrColumn: field, direction: dir };
-		}
-	}
-	return null;
-}
-
-export function queryFilterEncode(values) {
-	if (!Array.isArray(values) || values.length === 0) return null;
-	return values.map(encodeURIComponent).join(',');
-}
-
-export function queryFilterDecode(val) {
-	if (!val || typeof val !== 'string') return [];
-	return val.split(',').map(function (v) {
-		try { return decodeURIComponent(v.trim()); }
-		catch (e) { return v.trim(); }
-	}).filter(Boolean);
-}
-
-if (typeof window !== 'undefined') {
-	window.lnCore = window.lnCore || {};
-	window.lnCore.queryParse = queryParse;
-	window.lnCore.queryGet = queryGet;
-	window.lnCore.querySet = querySet;
-	window.lnCore.resolveQueryParam = resolveQueryParam;
-	window.lnCore.querySortEncode = querySortEncode;
-	window.lnCore.querySortDecode = querySortDecode;
-	window.lnCore.queryFilterEncode = queryFilterEncode;
-	window.lnCore.queryFilterDecode = queryFilterDecode;
-}
+// ─── Query String codec (URL search params as reactive state) ──
+//
+// Allows components (ln-search, ln-filter, ln-sort) to bind to URL search
+// parameters (?search=foo&status=active&sort=amount.desc) in SPAs without
+// polluting or colliding with the URL hash fragment (#modal, #tab).
+//
+// Write mechanism: `history.replaceState` (does not reload the page or pollute history).
+// Read mechanism: `URLSearchParams` on window.location.search.
+// Navigation: Reacts to `popstate` events on browser Back/Forward navigation.
+
+function _stripSearch(str) {
+	return (str || '').replace(/^\?/, '');
+}
+
+export function queryParse(searchStr) {
+	const raw = (searchStr === undefined)
+		? (typeof window !== 'undefined' ? window.location.search : '')
+		: searchStr;
+	const map = {};
+	const s = _stripSearch(raw);
+	if (!s) return map;
+	const params = new URLSearchParams(s);
+	for (const [key, val] of params.entries()) {
+		map[key] = val;
+	}
+	return map;
+}
+
+export function queryGet(key) {
+	if (!key || typeof window === 'undefined') return null;
+	const params = new URLSearchParams(window.location.search);
+	return params.has(key) ? params.get(key) : null;
+}
+
+export function querySet(key, value) {
+	if (!key || typeof window === 'undefined') return;
+	const url = new URL(window.location.href);
+
+	if (value === null || value === undefined || value === '') {
+		url.searchParams.delete(key);
+	} else {
+		url.searchParams.set(key, String(value));
+	}
+
+	if (url.search === window.location.search) return;
+
+	const nextUrl = url.pathname + url.search + url.hash;
+	window.history.replaceState(window.history.state, '', nextUrl);
+}
+
+export function resolveQueryParam(el, defaultSuffix) {
+	if (!el || !el.hasAttribute('data-ln-query')) return null;
+	const explicit = el.getAttribute('data-ln-query');
+	if (explicit && explicit.trim() !== '') return explicit.trim();
+	const targetId = el.getAttribute('data-ln-sort')
+		|| el.getAttribute('data-ln-search-for')
+		|| el.getAttribute('data-ln-search')
+		|| el.getAttribute('data-ln-filter')
+		|| el.id;
+	if (targetId) {
+		return defaultSuffix ? (targetId + '_' + defaultSuffix) : targetId;
+	}
+	return defaultSuffix || null;
+}
+
+export function querySortEncode(fieldOrColumn, direction) {
+	if (!direction || direction === 'none' || fieldOrColumn === null || fieldOrColumn === undefined) return null;
+	return String(fieldOrColumn) + '.' + direction;
+}
+
+export function querySortDecode(val, queryParams) {
+	if (val && typeof val === 'string') {
+		if (val.endsWith('.asc')) {
+			return { fieldOrColumn: val.slice(0, -4), direction: 'asc' };
+		}
+		if (val.endsWith('.desc')) {
+			return { fieldOrColumn: val.slice(0, -5), direction: 'desc' };
+		}
+	}
+	if (queryParams && typeof queryParams === 'object') {
+		const field = queryParams.sort_field || queryParams.sort_by;
+		if (field) {
+			const dir = (queryParams.sort_dir && String(queryParams.sort_dir).toLowerCase() === 'desc') ? 'desc' : 'asc';
+			return { fieldOrColumn: field, direction: dir };
+		}
+	}
+	return null;
+}
+
+export function queryFilterEncode(values) {
+	if (!Array.isArray(values) || values.length === 0) return null;
+	return values.map(encodeURIComponent).join(',');
+}
+
+export function queryFilterDecode(val) {
+	if (!val || typeof val !== 'string') return [];
+	return val.split(',').map(function (v) {
+		try { return decodeURIComponent(v.trim()); }
+		catch (e) { return v.trim(); }
+	}).filter(Boolean);
+}
+
+if (typeof window !== 'undefined') {
+	window.lnCore = window.lnCore || {};
+	window.lnCore.queryParse = queryParse;
+	window.lnCore.queryGet = queryGet;
+	window.lnCore.querySet = querySet;
+	window.lnCore.resolveQueryParam = resolveQueryParam;
+	window.lnCore.querySortEncode = querySortEncode;
+	window.lnCore.querySortDecode = querySortDecode;
+	window.lnCore.queryFilterEncode = queryFilterEncode;
+	window.lnCore.queryFilterDecode = queryFilterDecode;
+}

package/components/ln-data-coordinator/README.md

@@ -446,6 +446,8 @@ There is no `ln-data-store:sync-conflict` event and no `forceSync()` error
 backstop — both were removed as part of this refactor (no grep-verified
 consumer existed for either).
 
+**Non-queued direct connector rollback (`!meta.queued`)** — When an offline queue is not present and a direct connector request fails, `ln-data-coordinator` automatically rolls back the optimistic local store mutation to keep the client cache consistent: an `update` failure restores the pre-mutation `meta.snapshot` (`ln-data-store:request-update`), a `create` failure deletes the optimistic record via `meta.tempId` (`ln-data-store:request-delete`), and a `delete` failure re-creates the deleted record from `meta.snapshot` (`ln-data-store:request-create`).
+
 ---
 
 ---