@livenetworks/ashlar 2.0.7 → 2.0.9

package/components/ln-core/dom.js

@@ -1,115 +1,115 @@
-// ─── Guard Body ────────────────────────────────────────
-
-export function guardBody(setupFn, componentTag) {
-	if (!document.body) {
-		document.addEventListener('DOMContentLoaded', function () {
-			guardBody(setupFn, componentTag);
-		});
-		console.warn('[' + componentTag + '] Script loaded before <body> — add "defer" to your <script> tag');
-		return;
-	}
-	setupFn();
-}
-
-// ─── Visibility Check ─────────────────────────────────────
-
-export function isVisible(el) {
-	return !!(el.offsetWidth || el.offsetHeight || el.getClientRects().length);
-}
-
-/**
- * Determines whether a mouse click event should be ignored (modified click or non-primary button).
- * @param {MouseEvent|Object} [event]
- * @returns {boolean}
- */
-export function shouldIgnoreClick(event) {
-	if (!event) return true;
-	if (event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return true;
-	if (typeof event.button === 'number' && event.button !== 0) return true;
-	return false;
-}
-
-/**
- * Checks if a target element is an active editable field or contenteditable element.
- * @param {Element|Object} [target]
- * @returns {boolean}
- */
-export function isEditableTarget(target) {
-	if (!target) return false;
-	if (typeof target.closest === 'function') {
-		return Boolean(target.closest('input, textarea, select, [contenteditable]:not([contenteditable="false"])'));
-	}
-	const tag = String(target.tagName || '').toLowerCase();
-	return tag === 'input' || tag === 'textarea' || tag === 'select' || Boolean(target.isContentEditable);
-}
-
-/**
- * Checks if a target element is disabled, aria-disabled, or inside an inert container.
- * @param {Element|Object} [target]
- * @returns {boolean}
- */
-export function isTargetDisabled(target) {
-	if (!target) return true;
-	if (target.disabled || (typeof target.getAttribute === 'function' && target.getAttribute('aria-disabled') === 'true')) {
-		return true;
-	}
-	if (typeof target.closest === 'function' && target.closest('[inert]')) {
-		return true;
-	}
-	return false;
-}
-
-/**
- * Checks if a target element is connected, enabled, not inert, visible, and optionally supports an action method.
- * @param {Element} target
- * @param {string} [action]
- * @returns {boolean}
- */
-export function isUsableTarget(target, action) {
-	if (!target || !document.contains(target)) return false;
-	if (isTargetDisabled(target)) return false;
-	if (action && typeof target[action] !== 'function') return false;
-	return isVisible(target);
-}
-
-/**
- * Checks if a link click should be intercepted by client-side routing.
- * Must be standard navigation click (left button, no modifiers), same origin,
- * not mailto/tel, and not pure hash/empty.
- *
- * @param {MouseEvent} event
- * @param {HTMLAnchorElement} anchor
- * @returns {boolean}
- */
-export function shouldInterceptLink(event, anchor) {
-	if (event.ctrlKey || event.metaKey || event.shiftKey || event.altKey || event.button !== 0) {
-		return false;
-	}
-	if (!anchor) return false;
-	const href = anchor.getAttribute('href');
-	if (!href) return false;
-	if (anchor.getAttribute('target') === '_blank') return false;
-	if (anchor.hasAttribute('download')) return false;
-	if (href.startsWith('mailto:') || href.startsWith('tel:')) return false;
-	if (href === '#' || href.startsWith('#')) return false;
-	if (anchor.hostname && anchor.hostname !== window.location.hostname) return false;
-	return true;
-}
-
-/**
- * Read the raw machine value behind a formatted cell/item display.
- * Returns the `data-ln-value` attribute if present, else trimmed textContent.
- * Single read path for value-based sort/filter across components.
- */
-export function readValue(el) {
-	if (el.hasAttribute('data-ln-value')) {
-		return el.getAttribute('data-ln-value');
-	}
-	if (el.tagName === 'TIME' && el.hasAttribute('datetime')) {
-		return el.getAttribute('datetime');
-	}
-	if (el.tagName === 'DATA' && el.hasAttribute('value')) {
-		return el.getAttribute('value');
-	}
-	return el.textContent.trim();
-}
+// ─── Guard Body ────────────────────────────────────────
+
+export function guardBody(setupFn, componentTag) {
+	if (!document.body) {
+		document.addEventListener('DOMContentLoaded', function () {
+			guardBody(setupFn, componentTag);
+		});
+		console.warn('[' + componentTag + '] Script loaded before <body> — add "defer" to your <script> tag');
+		return;
+	}
+	setupFn();
+}
+
+// ─── Visibility Check ─────────────────────────────────────
+
+export function isVisible(el) {
+	return !!(el.offsetWidth || el.offsetHeight || el.getClientRects().length);
+}
+
+/**
+ * Determines whether a mouse click event should be ignored (modified click or non-primary button).
+ * @param {MouseEvent|Object} [event]
+ * @returns {boolean}
+ */
+export function shouldIgnoreClick(event) {
+	if (!event) return true;
+	if (event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return true;
+	if (typeof event.button === 'number' && event.button !== 0) return true;
+	return false;
+}
+
+/**
+ * Checks if a target element is an active editable field or contenteditable element.
+ * @param {Element|Object} [target]
+ * @returns {boolean}
+ */
+export function isEditableTarget(target) {
+	if (!target) return false;
+	if (typeof target.closest === 'function') {
+		return Boolean(target.closest('input, textarea, select, [contenteditable]:not([contenteditable="false"])'));
+	}
+	const tag = String(target.tagName || '').toLowerCase();
+	return tag === 'input' || tag === 'textarea' || tag === 'select' || Boolean(target.isContentEditable);
+}
+
+/**
+ * Checks if a target element is disabled, aria-disabled, or inside an inert container.
+ * @param {Element|Object} [target]
+ * @returns {boolean}
+ */
+export function isTargetDisabled(target) {
+	if (!target) return true;
+	if (target.disabled || (typeof target.getAttribute === 'function' && target.getAttribute('aria-disabled') === 'true')) {
+		return true;
+	}
+	if (typeof target.closest === 'function' && target.closest('[inert]')) {
+		return true;
+	}
+	return false;
+}
+
+/**
+ * Checks if a target element is connected, enabled, not inert, visible, and optionally supports an action method.
+ * @param {Element} target
+ * @param {string} [action]
+ * @returns {boolean}
+ */
+export function isUsableTarget(target, action) {
+	if (!target || !document.contains(target)) return false;
+	if (isTargetDisabled(target)) return false;
+	if (action && typeof target[action] !== 'function') return false;
+	return isVisible(target);
+}
+
+/**
+ * Checks if a link click should be intercepted by client-side routing.
+ * Must be standard navigation click (left button, no modifiers), same origin,
+ * not mailto/tel, and not pure hash/empty.
+ *
+ * @param {MouseEvent} event
+ * @param {HTMLAnchorElement} anchor
+ * @returns {boolean}
+ */
+export function shouldInterceptLink(event, anchor) {
+	if (event.ctrlKey || event.metaKey || event.shiftKey || event.altKey || event.button !== 0) {
+		return false;
+	}
+	if (!anchor) return false;
+	const href = anchor.getAttribute('href');
+	if (!href) return false;
+	if (anchor.getAttribute('target') === '_blank') return false;
+	if (anchor.hasAttribute('download')) return false;
+	if (href.startsWith('mailto:') || href.startsWith('tel:')) return false;
+	if (href === '#' || href.startsWith('#')) return false;
+	if (anchor.hostname && anchor.hostname !== window.location.hostname) return false;
+	return true;
+}
+
+/**
+ * Read the raw machine value behind a formatted cell/item display.
+ * Returns the `data-ln-value` attribute if present, else trimmed textContent.
+ * Single read path for value-based sort/filter across components.
+ */
+export function readValue(el) {
+	if (el.hasAttribute('data-ln-value')) {
+		return el.getAttribute('data-ln-value');
+	}
+	if (el.tagName === 'TIME' && el.hasAttribute('datetime')) {
+		return el.getAttribute('datetime');
+	}
+	if (el.tagName === 'DATA' && el.hasAttribute('value')) {
+		return el.getAttribute('value');
+	}
+	return el.textContent.trim();
+}

package/components/ln-core/form.js

@@ -1,136 +1,146 @@
-// ─── Form Method Resolution ────────────────────────────────
-
-export function resolveFormMethod(form) {
-	const methodInput = form.querySelector('input[name="_method"]');
-	const raw = (methodInput && methodInput.value !== '') ? methodInput.value : form.method;
-	return (raw || '').toUpperCase();
-}
-
-// ─── Form Serialization ───────────────────────────────────
-
-export function serializeForm(form, opts) {
-	const typed = !!(opts && opts.typed);
-	const exclude = opts && opts.exclude;
-	const data = {};
-	const elements = form.elements;
-
-	const checkboxCounts = {};
-	if (typed) {
-		for (let i = 0; i < elements.length; i++) {
-			const el = elements[i];
-			if (el.name && el.type === 'checkbox' && !el.disabled) {
-				checkboxCounts[el.name] = (checkboxCounts[el.name] || 0) + 1;
-			}
-		}
-	}
-
-	for (let i = 0; i < elements.length; i++) {
-		const el = elements[i];
-		if (!el.name || el.disabled || el.type === 'file' || el.type === 'submit' || el.type === 'button') continue;
-		if (exclude && el.matches && el.matches(exclude)) continue;
-
-		if (el.type === 'checkbox') {
-			if (typed && checkboxCounts[el.name] === 1) {
-				data[el.name] = el.checked;
-			} else {
-				if (!data[el.name]) data[el.name] = [];
-				if (el.checked) data[el.name].push(el.value);
-			}
-		} else if (el.type === 'radio') {
-			if (el.checked) data[el.name] = el.value;
-		} else if (el.type === 'select-multiple') {
-			data[el.name] = [];
-			for (let j = 0; j < el.options.length; j++) {
-				if (el.options[j].selected) data[el.name].push(el.options[j].value);
-			}
-		} else if (typed && el.type === 'hidden') {
-			data[el.name] = el.value;
-		} else if (typed && (el.type === 'number' || el.type === 'range')) {
-			const n = Number(el.value);
-			data[el.name] = (el.value === '' || isNaN(n)) ? null : n;
-		} else {
-			data[el.name] = el.value;
-		}
-	}
-
-	return data;
-}
-
-// ─── Form Population ──────────────────────────────────────
-
-function _coerceBool(value) {
-	if (typeof value !== 'string') return !!value;
-	const v = value.trim().toLowerCase();
-	return v !== 'false' && v !== '0' && v !== '' && v !== 'off' && v !== 'no';
-}
-
-export function populateForm(form, data) {
-	const elements = form.elements;
-	const filled = [];
-
-	const checkboxCounts = {};
-	for (let i = 0; i < elements.length; i++) {
-		const el = elements[i];
-		if (el.name && el.type === 'checkbox') {
-			checkboxCounts[el.name] = (checkboxCounts[el.name] || 0) + 1;
-		}
-	}
-
-	for (let i = 0; i < elements.length; i++) {
-		const el = elements[i];
-		if (el.type === 'file' || el.type === 'submit' || el.type === 'button') continue;
-
-		const matchKey = el.getAttribute('data-ln-fill-as') || el.name;
-		if (!matchKey || !(matchKey in data)) continue;
-
-		const value = data[matchKey];
-
-		if (el.type === 'checkbox') {
-			if (Array.isArray(value)) {
-				el.checked = value.indexOf(el.value) !== -1;
-			} else if (checkboxCounts[el.name] > 1) {
-				const list = String(value).split(',').map(function (s) { return s.trim(); });
-				el.checked = list.indexOf(el.value) !== -1;
-			} else {
-				el.checked = _coerceBool(value);
-			}
-			filled.push(el);
-		} else if (el.type === 'radio') {
-			el.checked = el.value === String(value);
-			filled.push(el);
-		} else if (el.type === 'select-multiple') {
-			if (Array.isArray(value)) {
-				for (let j = 0; j < el.options.length; j++) {
-					el.options[j].selected = value.indexOf(el.options[j].value) !== -1;
-				}
-			}
-			filled.push(el);
-		} else {
-			el.value = value;
-			filled.push(el);
-		}
-	}
-
-	return filled;
-}
-
-// ─── Value Property Interception ───────────────────────────
-
-export function interceptValueProperty(dom, descriptor, { get, set }) {
-	Object.defineProperty(dom, 'value', {
-		get: function () {
-			if (get) {
-				return get.call(this);
-			}
-			return descriptor.get.call(this);
-		},
-		set: function (val) {
-			if (set) {
-				set.call(this, val, (originalVal) => descriptor.set.call(this, originalVal));
-			} else {
-				descriptor.set.call(this, val);
-			}
-		},
-		configurable: true
-	});
-}
+// ─── Form Method Resolution ────────────────────────────────
+
+export function resolveFormMethod(form) {
+	const methodInput = form.querySelector('input[name="_method"]');
+	const raw = (methodInput && methodInput.value !== '') ? methodInput.value : form.method;
+	return (raw || '').toUpperCase();
+}
+
+// ─── Form Serialization ───────────────────────────────────
+
+export function serializeForm(form, opts) {
+	const typed = !!(opts && opts.typed);
+	const exclude = opts && opts.exclude;
+	const data = {};
+	const elements = form.elements;
+
+	const checkboxCounts = {};
+	if (typed) {
+		for (let i = 0; i < elements.length; i++) {
+			const el = elements[i];
+			if (el.name && el.type === 'checkbox' && !el.disabled) {
+				checkboxCounts[el.name] = (checkboxCounts[el.name] || 0) + 1;
+			}
+		}
+	}
+
+	for (let i = 0; i < elements.length; i++) {
+		const el = elements[i];
+		if (!el.name || el.disabled || el.type === 'file' || el.type === 'submit' || el.type === 'button') continue;
+		if (exclude && el.matches && el.matches(exclude)) continue;
+
+		if (el.type === 'checkbox') {
+			if (typed && checkboxCounts[el.name] === 1) {
+				data[el.name] = el.checked;
+			} else {
+				if (!data[el.name]) data[el.name] = [];
+				if (el.checked) data[el.name].push(el.value);
+			}
+		} else if (el.type === 'radio') {
+			if (el.checked) data[el.name] = el.value;
+		} else if (el.type === 'select-multiple') {
+			data[el.name] = [];
+			for (let j = 0; j < el.options.length; j++) {
+				if (el.options[j].selected) data[el.name].push(el.options[j].value);
+			}
+		} else if (typed && el.type === 'hidden') {
+			data[el.name] = el.value;
+		} else if (typed && (el.type === 'number' || el.type === 'range')) {
+			const n = Number(el.value);
+			data[el.name] = (el.value === '' || isNaN(n)) ? null : n;
+		} else {
+			data[el.name] = el.value;
+		}
+	}
+
+	return data;
+}
+
+// ─── Form Population ──────────────────────────────────────
+
+function _coerceBool(value) {
+	if (typeof value !== 'string') return !!value;
+	const v = value.trim().toLowerCase();
+	return v !== 'false' && v !== '0' && v !== '' && v !== 'off' && v !== 'no';
+}
+
+export function populateForm(form, data) {
+	const elements = form.elements;
+	const filled = [];
+
+	const checkboxCounts = {};
+	for (let i = 0; i < elements.length; i++) {
+		const el = elements[i];
+		if (el.name && el.type === 'checkbox') {
+			checkboxCounts[el.name] = (checkboxCounts[el.name] || 0) + 1;
+		}
+	}
+
+	for (let i = 0; i < elements.length; i++) {
+		const el = elements[i];
+		if (el.type === 'file' || el.type === 'submit' || el.type === 'button') continue;
+
+		const matchKey = el.getAttribute('data-ln-fill-as') || el.name;
+		if (!matchKey || !(matchKey in data)) continue;
+
+		const value = data[matchKey];
+
+		if (el.type === 'checkbox') {
+			if (Array.isArray(value)) {
+				el.checked = value.indexOf(el.value) !== -1;
+			} else if (checkboxCounts[el.name] > 1) {
+				const list = String(value).split(',').map(function (s) { return s.trim(); });
+				el.checked = list.indexOf(el.value) !== -1;
+			} else {
+				el.checked = _coerceBool(value);
+			}
+			filled.push(el);
+		} else if (el.type === 'radio') {
+			el.checked = el.value === String(value);
+			filled.push(el);
+		} else if (el.type === 'select-multiple') {
+			if (Array.isArray(value)) {
+				for (let j = 0; j < el.options.length; j++) {
+					el.options[j].selected = value.indexOf(el.options[j].value) !== -1;
+				}
+			}
+			filled.push(el);
+		} else {
+			el.value = value;
+			if (el.tagName === 'SELECT' && value != null) {
+				el.setAttribute('data-ln-value', value);
+			}
+			filled.push(el);
+		}
+	}
+
+	return filled;
+}
+
+// ─── Value Property Interception ───────────────────────────
+
+export function interceptValueProperty(dom, descriptor, { get, set }) {
+	Object.defineProperty(dom, 'value', {
+		get: function () {
+			if (get) {
+				return get.call(this);
+			}
+			return descriptor.get.call(this);
+		},
+		set: function (val) {
+			if (set) {
+				set.call(this, val, (originalVal) => descriptor.set.call(this, originalVal));
+			} else {
+				descriptor.set.call(this, val);
+			}
+		},
+		configurable: true
+	});
+}
+
+if (typeof window !== 'undefined') {
+	window.lnCore = window.lnCore || {};
+	window.lnCore.populateForm = populateForm;
+	window.lnCore.serializeForm = serializeForm;
+	window.lnCore.resolveFormMethod = resolveFormMethod;
+}

package/components/ln-core/helpers.js

@@ -1,33 +1,33 @@
-// ==========================================================================
-// ln-core — Shared Helpers & Runtime Kernel Facade (Barrel File)
-// ==========================================================================
-// All primitives are modularized into cohesive single-responsibility modules.
-// This barrel re-exports the entire public surface with 100% backward
-// compatibility. Evaluation order preserves module initialization invariants:
-// events.js evaluates first to ensure window.lnCore and console warning
-// interception are established before subsequent modules load.
-// ==========================================================================
-
-// Events & Debug
-export { dispatch, dispatchCancelable, requestData, setDebugSink, setPersistSink, hasActiveDebug, isDevMode } from './events.js';
-
-// DOM & Target Predicates
-export { guardBody, isVisible, shouldIgnoreClick, isEditableTarget, isTargetDisabled, isUsableTarget, shouldInterceptLink, readValue } from './dom.js';
-
-// Form Utilities
-export { resolveFormMethod, serializeForm, populateForm, interceptValueProperty } from './form.js';
-
-// HTTP & Data Mappers
-export { buildUrl, getHeaders, parseHeaders, registerDataMapper, getDataMapper } from './http.js';
-
-// Locale & i18n
-export { getLocale, ensureLocaleObserver, registerLocaleFallback, getLocaleFallback } from './locale.js';
-
-// Templates & DOM Fill
-export { cloneTemplate, cloneTemplateScoped, fill, lnFill, fillTemplate, renderList, buildDict } from './template.js';
-
-// Lifecycle & Kernel Registration
-export { findElements, holdInit, releaseInit, pendingCount, queueBoot, observeAttributes, registerComponent } from './lifecycle.js';
-
-// Value Comparison Primitives (re-exported from compare.js for backward compatibility)
-export { compareValues, detectValueType } from './compare.js';
+// ==========================================================================
+// ln-core — Shared Helpers & Runtime Kernel Facade (Barrel File)
+// ==========================================================================
+// All primitives are modularized into cohesive single-responsibility modules.
+// This barrel re-exports the entire public surface with 100% backward
+// compatibility. Evaluation order preserves module initialization invariants:
+// events.js evaluates first to ensure window.lnCore and console warning
+// interception are established before subsequent modules load.
+// ==========================================================================
+
+// Events & Debug
+export { dispatch, dispatchCancelable, requestData, setDebugSink, setPersistSink, hasActiveDebug, isDevMode } from './events.js';
+
+// DOM & Target Predicates
+export { guardBody, isVisible, shouldIgnoreClick, isEditableTarget, isTargetDisabled, isUsableTarget, shouldInterceptLink, readValue } from './dom.js';
+
+// Form Utilities
+export { resolveFormMethod, serializeForm, populateForm, interceptValueProperty } from './form.js';
+
+// HTTP & Data Mappers
+export { buildUrl, getHeaders, parseHeaders, registerDataMapper, getDataMapper } from './http.js';
+
+// Locale & i18n
+export { getLocale, ensureLocaleObserver, registerLocaleFallback, getLocaleFallback } from './locale.js';
+
+// Templates & DOM Fill
+export { cloneTemplate, cloneTemplateScoped, fill, lnFill, fillTemplate, renderList, buildDict } from './template.js';
+
+// Lifecycle & Kernel Registration
+export { findElements, holdInit, releaseInit, pendingCount, queueBoot, observeAttributes, registerComponent } from './lifecycle.js';
+
+// Value Comparison Primitives (re-exported from compare.js for backward compatibility)
+export { compareValues, detectValueType } from './compare.js';