@livenetworks/ashlar 1.6.1 → 2.0.1

package/js/ln-core/helpers.js

@@ -1,788 +0,0 @@
-// ─── Global Console Warning Interceptor (Production Mode) ──
-if (typeof window !== 'undefined') {
-	const originalWarn = console.warn;
-	console.warn = function (...args) {
-		const isLibraryWarning = typeof args[0] === 'string' &&
-			(args[0].startsWith('[ln-') || args[0].startsWith('[lnCore'));
-
-		if (isLibraryWarning) {
-			const isDebug =
-				document.documentElement.hasAttribute('data-ln-debug') ||
-				(document.body && document.body.hasAttribute('data-ln-debug'));
-
-			if (!isDebug) {
-				return;
-			}
-		}
-		originalWarn.apply(console, args);
-	};
-}
-
-// ─── 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);
-}
-
-// ─── Event Dispatch ────────────────────────────────────────
-
-export function dispatch(element, eventName, detail) {
-	element.dispatchEvent(new CustomEvent(eventName, {
-		bubbles: true,
-		detail: detail || {}
-	}));
-}
-
-export function dispatchCancelable(element, eventName, detail) {
-	const event = new CustomEvent(eventName, {
-		bubbles: true,
-		cancelable: true,
-		detail: detail || {}
-	});
-	element.dispatchEvent(event);
-	return event;
-}
-
-/**
- * Re-filter / re-sort / re-render a data-driven list-like component, then
- * notify the coordinator that fresh data is requested.
- *
- * Shared by ln-list and ln-table. The passed `component` MUST expose this
- * instance contract:
- *   - _applyFilterAndSort()  method
- *   - _render()              method
- *   - _updateFooter()        method
- *   - _vStart, _vEnd         number (reset to -1 to force a full re-render)
- *   - dom                    the component root element (dispatch target)
- *   - name                   the component's name (becomes detail[keyName])
- *   - currentSort, currentFilters, currentSearch
- *
- * @param {Object} component  component instance satisfying the contract above
- * @param {string} eventName  e.g. 'ln-table:request-data' / 'ln-list:request-data'
- * @param {string} keyName    payload key for the name, e.g. 'table' / 'list'
- */
-export function requestData(component, eventName, keyName) {
-	component._applyFilterAndSort();
-	component._vStart = -1;
-	component._vEnd = -1;
-	component._render();
-	component._updateFooter();
-
-	const detail = {
-		sort: component.currentSort,
-		filters: component.currentFilters,
-		search: component.currentSearch
-	};
-	detail[keyName] = component.name;
-	dispatch(component.dom, eventName, detail);
-}
-
-// ─── Declarative DOM Binding ───────────────────────────────
-
-export function fill(root, data) {
-	if (!root || !data) return root;
-
-	// data-ln-field="prop" → textContent
-	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];
-		}
-	}
-
-	// data-ln-attr="attr:prop, attr:prop" → setAttribute
-	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]);
-			}
-		}
-	}
-
-	// data-ln-show="prop" → classList.toggle('hidden', !value)
-	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]);
-		}
-	}
-
-	// data-ln-class="cls:prop, cls:prop" → classList.toggle(cls, !!value)
-	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 ─────────────────────────────
-
-/**
- * Dispatch `ln-fill` at every [data-ln-form] and [data-ln-fillable]
- * descendant of `container`. Fillables self-handle; null → clear/reset.
- */
-export function lnFill(container, record) {
-	// Dispatch at container itself when it is a form or fillable.
-	// Enables lnFill(formEl, record) to reach ln-form's listener, which
-	// guards e.target === self.dom. Modal callers (lnFill(modalEl, …)
-	// where modalEl is [data-ln-modal]) do not match, so they are unaffected.
-	if (container.matches && container.matches('[data-ln-form], [data-ln-fillable]')) {
-		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++) {
-		targets[i].dispatchEvent(new CustomEvent('ln-fill', { detail: record ?? null, bubbles: true }));
-	}
-	return container;
-}
-
-// Delegated display-fillable handler — installed once per page (idempotent
-// across standalone component bundles that each inline ln-core helpers).
-// Forms are NOT [data-ln-fillable]; ln-form's own listener handles them.
-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;
-
-	// ── Pass 1: text nodes ──────────────────────────────────
-	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] : ''; }
-			);
-		}
-	}
-
-	// ── Pass 2: element attributes ──────────────────────────
-	// Uses setAttribute — never innerHTML — so injection risk is the same
-	// as data-ln-attr (the existing declarative attribute-fill mechanism).
-	// Complements data-ln-table-cell-attr (field→attr stamping); both coexist.
-	const _replaceTokens = function (_, key) { return data[key] !== undefined ? data[key] : ''; };
-	const elements = Array.from(clone.querySelectorAll('*'));
-	// Include the root itself when clone is an Element (e.g. a <tr> passed
-	// directly by ln-table._fillRow) — querySelectorAll does not include root.
-	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) {
-	// Index existing children by data-ln-key
-	const existingByKey = {};
-	for (let i = 0; i < container.children.length; i++) {
-		const child = container.children[i];
-		const key = child.getAttribute('data-ln-key');
-		if (key) existingByKey[key] = child;
-	}
-
-	// Build ordered fragment — reuse or clone
-	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-key', key);
-			fillFn(el, item, i);
-		}
-		frag.appendChild(el);
-	}
-
-	// Atomic update: orphans still in container, reused nodes already moved to frag
-	container.textContent = '';
-	container.appendChild(frag);
-}
-
-// ─── 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();
-}
-
-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);
-}
-
-// ─── Dictionary (i18n) ────────────────────────────────────
-
-/**
- * Build a plain object from hidden dictionary elements.
- * Reads all [selector] elements once, extracts key→textContent,
- * removes them from DOM. Returns dictionary object.
- *
- * HTML: <ul hidden>
- *         <li data-ln-upload-dict="remove">Remove</li>
- *       </ul>
- * JS:   const dict = buildDict(container, 'data-ln-upload-dict');
- *        dict.remove → 'Remove'
- */
-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;
-}
-
-// ─── Find Elements ─────────────────────────────────────────
-
-export function findElements(root, selector, attribute, ComponentClass) {
-	if (root.nodeType !== 1) return;
-
-	// Support both simple attribute names and full CSS selectors
-	const isComplex = selector.indexOf('[') !== -1 || selector.indexOf('.') !== -1 || selector.indexOf('#') !== -1;
-	const query = isComplex ? selector : '[' + selector + ']';
-
-	const items = Array.from(root.querySelectorAll(query));
-	if (root.matches && root.matches(query)) {
-		items.push(root);
-	}
-	for (const el of items) {
-		if (!el[attribute]) {
-			el[attribute] = new ComponentClass(el);
-		}
-	}
-}
-
-// ─── Visibility Check ─────────────────────────────────────
-
-export function isVisible(el) {
-	return !!(el.offsetWidth || el.offsetHeight || el.getClientRects().length);
-}
-
-// ─── Form Serialization ───────────────────────────────────
-
-// Effective HTTP method for a form: hidden _method input (non-empty) wins,
-// else the form's own `method` attribute. Shared by ln-form's submit gate
-// and ln-data-coordinator's native-submit claim so both read the identical
-// literal DOM state — no drift between the two independent checks.
-export function resolveFormMethod(form) {
-	const methodInput = form.querySelector('input[name="_method"]');
-	const raw = (methodInput && methodInput.value !== '') ? methodInput.value : form.method;
-	return (raw || '').toUpperCase();
-}
-
-export function serializeForm(form, opts) {
-	const typed = !!(opts && opts.typed);
-	const exclude = opts && opts.exclude;
-	const data = {};
-	const elements = form.elements;
-
-	// Pre-count checkbox names in typed mode to distinguish single-checkbox
-	// (→ boolean) from same-name checkbox groups (→ array of checked values).
-	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;                          // single checkbox → boolean
-			} else {
-				if (!data[el.name]) data[el.name] = [];
-				if (el.checked) data[el.name].push(el.value);        // group → array (unchanged)
-			}
-		} 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;                               // hidden → always string (never coerce)
-		} else if (typed && (el.type === 'number' || el.type === 'range')) {
-			const n = Number(el.value);
-			data[el.name] = (el.value === '' || isNaN(n)) ? null : n; // number/range → Number | null
-		} else {
-			data[el.name] = el.value;
-		}
-	}
-
-	return data;
-}
-
-// Coerce a value to boolean for single-checkbox fill.
-// Flat data-* values arrive as strings; "false", "0", "", "off", "no"
-// (case-insensitive, trimmed) are treated as unchecked.
-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 = [];
-
-	// Pre-count checkbox names to distinguish single-checkbox (→ bool)
-	// from same-name checkbox groups (→ comma-separated list membership).
-	// NOTE: unlike serializeForm, populateForm fills disabled elements too,
-	// so the count must include disabled members (no !el.disabled guard) —
-	// otherwise a group with a disabled box reverts to single-checkbox coercion.
-	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;
-
-		// Decoupled-key fill: data-ln-fill-as wins over name for record matching.
-		// Write (fill) path only — serializeForm stays name-based.
-		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)) {
-				// Programmatic array path — membership check.
-				el.checked = value.indexOf(el.value) !== -1;
-			} else if (checkboxCounts[el.name] > 1) {
-				// Same-name checkbox group + scalar: treat as comma-separated list.
-				// "admin,editor" → ['admin','editor'] → membership check.
-				const list = String(value).split(',').map(function (s) { return s.trim(); });
-				el.checked = list.indexOf(el.value) !== -1;
-			} else {
-				// Single checkbox — boolean coercion.
-				// "false"/"0"/"off"/"no"/"" → unchecked; anything else → checked.
-				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;
-}
-
-// ─── Locale Detection ─────────────────────────────────────
-
-const _standardTerritories = {
-	mk: 'mk-MK',
-	de: 'de-DE',
-	fr: 'fr-FR',
-	es: 'es-ES',
-	it: 'it-IT',
-	nl: 'nl-NL',
-	pt: 'pt-PT',
-	ru: 'ru-RU',
-	bg: 'bg-BG',
-	hr: 'hr-HR',
-	sr: 'sr-RS',
-	sq: 'sq-AL',
-	el: 'el-GR',
-	en: 'en-US'
-};
-
-export function getLocale(el) {
-	const langEl = el ? el.closest('[lang]') : null;
-	const raw = (langEl ? (langEl.getAttribute('lang') || langEl.lang) : null)
-		|| (document.documentElement ? (document.documentElement.getAttribute('lang') || document.documentElement.lang) : null)
-		|| navigator.language;
-	if (!raw) return 'en-US';
-	const lower = raw.trim().toLowerCase();
-	if (lower.indexOf('-') === -1 && _standardTerritories[lower]) {
-		return _standardTerritories[lower];
-	}
-	return raw;
-}
-
-// ─── Raw Value Read ───────────────────────────────────────
-
-/**
- * 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) {
-	return el.hasAttribute('data-ln-value')
-		? el.getAttribute('data-ln-value')
-		: el.textContent.trim();
-}
-
-// ─── Value Comparison Primitives ───────────────────────────
-
-/**
- * Detect the comparison type for a column/field from its current value set.
- * Type is locked ONCE per sort operation (not per pair) — comparing types
- * per-pair breaks comparator transitivity and produces wrong ordering.
- * All non-empty values must be finite numbers for 'number'; otherwise 'string'.
- */
-export function detectValueType(values) {
-	let hasValue = false;
-	for (let i = 0; i < values.length; i++) {
-		const v = values[i];
-		if (v === '' || v == null) continue;
-		hasValue = true;
-		if (!Number.isFinite(Number(v))) return 'string';
-	}
-	return hasValue ? 'number' : 'string';
-}
-
-/**
- * Compare two raw values given a pre-locked type (see detectValueType).
- * Pass an Intl.Collator instance for locale-aware string comparison —
- * built once by the caller outside the sort loop, never per pair.
- */
-export function compareValues(a, b, type, collator) {
-	if (type === 'number') {
-		const na = parseFloat(a);
-		const nb = parseFloat(b);
-		return (isNaN(na) ? 0 : na) - (isNaN(nb) ? 0 : nb);
-	}
-	const strA = a != null ? String(a) : '';
-	const strB = b != null ? String(b) : '';
-	if (collator) return collator.compare(strA, strB);
-	return strA < strB ? -1 : strA > strB ? 1 : 0;
-}
-
-// ─── Value Property Interception ───────────────────────────
-
-/**
- * Intercept the programmatic `value` getter/setter on an input element.
- * Useful for custom components that need to sync/format programmatic changes.
- * @param {HTMLInputElement} dom - The visible input element.
- * @param {Object} descriptor - The original property descriptor of HTMLInputElement.prototype.value.
- * @param {Object} callbacks - Getter and setter callbacks.
- */
-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
-	});
-}
-
-// ─── Component Registration ───────────────────────────────
-
-export function registerComponent(selector, attribute, ComponentFn, componentTag, options = {}) {
-	const extraAttributes = options.extraAttributes || [];
-	const onAttributeChange = options.onAttributeChange || null;
-	const onInit = options.onInit || null;
-
-	function constructor(domRoot) {
-		const root = domRoot || document.body;
-		findElements(root, selector, attribute, ComponentFn);
-		if (onInit) onInit(root);
-	}
-
-	guardBody(function () {
-		const observer = new MutationObserver(function (mutations) {
-			for (let i = 0; i < mutations.length; i++) {
-				const mutation = mutations[i];
-				if (mutation.type === 'childList') {
-					for (let j = 0; j < mutation.addedNodes.length; j++) {
-						const node = mutation.addedNodes[j];
-						if (node.nodeType === 1) {
-							findElements(node, selector, attribute, ComponentFn);
-							if (onInit) onInit(node);
-						}
-					}
-					for (let j = 0; j < mutation.removedNodes.length; j++) {
-						const node = mutation.removedNodes[j];
-						if (node.nodeType === 1) {
-							const isComplex = selector.indexOf('[') !== -1 || selector.indexOf('.') !== -1 || selector.indexOf('#') !== -1;
-							const query = isComplex ? selector : '[' + selector + ']';
-							const items = Array.from(node.querySelectorAll(query));
-							if (node.matches && node.matches(query)) {
-								items.push(node);
-							}
-							for (let k = 0; k < items.length; k++) {
-								const item = items[k];
-								if (!document.contains(item)) {
-									const inst = item[attribute];
-									if (inst && typeof inst.destroy === 'function') {
-										inst.destroy();
-									}
-								}
-							}
-						}
-					}
-				} else if (mutation.type === 'attributes') {
-					if (onAttributeChange && mutation.target[attribute]) {
-						onAttributeChange(mutation.target, mutation.attributeName);
-					} else {
-						findElements(mutation.target, selector, attribute, ComponentFn);
-						if (onInit) onInit(mutation.target);
-					}
-				}
-			}
-		});
-
-		// Extract attribute names from selector for attributeFilter
-		let observedAttributes = [];
-		if (selector.indexOf('[') !== -1) {
-			const re = /\[([\w-]+)/g;
-			let match;
-			while ((match = re.exec(selector)) !== null) {
-				observedAttributes.push(match[1]);
-			}
-		} else {
-			observedAttributes.push(selector);
-		}
-
-		observer.observe(document.body, {
-			childList: true,
-			subtree: true,
-			attributes: true,
-			attributeFilter: observedAttributes.concat(extraAttributes)
-		});
-	}, componentTag || (selector.indexOf('[') === -1 ? selector.replace('data-', '') : 'component'));
-
-	window[attribute] = constructor;
-
-	if (document.readyState === 'loading') {
-		document.addEventListener('DOMContentLoaded', function () {
-			constructor(document.body);
-		});
-	} else {
-		constructor(document.body);
-	}
-
-	return constructor;
-}
-
-// ─── HTTP / URL Helpers ────────────────────────────────────
-
-/**
- * Check if a click event on a link should be intercepted by an in-app navigator.
- * Intercept only left clicks, same-origin, not target="_blank", no download,
- * 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;
-}
-
-/**
- * Build a URL from segments, stripping duplicate slashes.
- */
-export function buildUrl(...segments) {
-	return segments
-		.filter(x => x !== undefined && x !== null && x !== '')
-		.map((part, index) => {
-			if (index === 0) return part.replace(/\/+$/, '');
-			return part.replace(/^\/+/, '').replace(/\/+$/, '');
-		})
-		.filter(Boolean)
-		.join('/');
-}
-
-/**
- * Compile standard JSON request headers.
- */
-export function getHeaders(customHeaders, auth) {
-	return Object.assign({
-		'Content-Type': 'application/json',
-		'Accept': 'application/json'
-	}, customHeaders, auth ? { 'Authorization': auth } : null);
-}
-
-/**
- * Safely parse headers from JSON string.
- */
-export function parseHeaders(str, componentName = 'ln-core') {
-	try { return str ? JSON.parse(str) : {}; }
-	catch (e) { return console.error(`[${componentName}] Invalid headers JSON:`, e), {}; }
-}
-
-// ─── Domain Data Mapper Registry ───────────────────────────
-const _dataMappers = {};
-
-export function registerDataMapper(name, mapper) {
-	_dataMappers[name] = mapper;
-}
-
-export function getDataMapper(name) {
-	return _dataMappers[name] || { ingress: r => r, egress: r => r };
-}
-
-// ─── Locale Fallback Registry ───────────────────────────────
-const _localeFallbacks = {};
-
-export function registerLocaleFallback(langPrefix, dictionary) {
-	if (!langPrefix || typeof dictionary !== 'object') return;
-	const prefix = langPrefix.toLowerCase().split('-')[0];
-	_localeFallbacks[prefix] = dictionary;
-}
-
-export function getLocaleFallback(lang) {
-	if (!lang) return null;
-	const prefix = lang.toLowerCase().split('-')[0];
-	return _localeFallbacks[prefix] || null;
-}
-
-// Default Macedonian locale fallback registration
-registerLocaleFallback('mk', {
-	monthsLong: [
-		'јануари', 'февруари', 'март', 'април', 'мај', 'јуни',
-		'јули', 'август', 'септември', 'октомври', 'ноември', 'декември'
-	],
-	monthsShort: [
-		'јан', 'фев', 'мар', 'апр', 'мај', 'јун',
-		'јул', 'авг', 'септ', 'окт', 'ноем', 'дек'
-	],
-	daysLong: [
-		'недела', 'понеделник', 'вторник', 'среда', 'четврток', 'петок', 'сабота'
-	],
-	daysShort: [
-		'нед', 'пон', 'вт', 'ср', 'чет', 'пет', 'саб'
-	]
-});
-
-if (typeof window !== 'undefined') {
-	window.lnCore = window.lnCore || {};
-	window.lnCore.registerDataMapper = registerDataMapper;
-	window.lnCore.getDataMapper = getDataMapper;
-	window.lnCore.registerLocaleFallback = registerLocaleFallback;
-	window.lnCore.getLocaleFallback = getLocaleFallback;
-	window.lnCore.fillTemplate = fillTemplate;
-	window.lnCore.fill = fill;
-	window.lnCore.lnFill = lnFill;
-	window.lnCore.renderList = renderList;
-}
-
-