@livenetworks/ashlar 2.1.12 → 2.2.0

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-core/reactive.js

@@ -1,62 +1,3 @@
-// ─── Shallow Reactive ──────────────────────────────────────
-
-export function reactiveState(initial, onChange) {
-	return new Proxy(Object.assign({}, initial), {
-		set(target, prop, value) {
-			const old = target[prop];
-			if (old === value) return true;
-			target[prop] = value;
-			onChange(prop, value, old);
-			return true;
-		}
-	});
-}
-
-// ─── Deep Reactive ─────────────────────────────────────────
-
-const PROXY_FLAG = Symbol('deepReactive');
-
-export function deepReactive(obj, onChange) {
-	function wrap(target) {
-		if (target === null || typeof target !== 'object') return target;
-		if (target[PROXY_FLAG]) return target;
-
-		// Recursively wrap existing nested objects/arrays
-		const keys = Object.keys(target);
-		for (let i = 0; i < keys.length; i++) {
-			const val = target[keys[i]];
-			if (val !== null && typeof val === 'object') {
-				target[keys[i]] = wrap(val);
-			}
-		}
-
-		return new Proxy(target, {
-			get(t, prop) {
-				if (prop === PROXY_FLAG) return true;
-				return t[prop];
-			},
-			set(t, prop, value) {
-				const old = t[prop];
-				if (value !== null && typeof value === 'object') {
-					value = wrap(value);
-				}
-				t[prop] = value;
-				if (old !== value) onChange();
-				return true;
-			},
-			deleteProperty(t, prop) {
-				if (prop in t) {
-					delete t[prop];
-					onChange();
-				}
-				return true;
-			}
-		});
-	}
-
-	return wrap(obj);
-}
-
 // ─── Render Batcher ────────────────────────────────────────
 
 export function createBatcher(renderFn, afterRender) {

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`).
+
 ---
 
 ---