@livenetworks/ashlar 1.6.1 → 2.0.1

package/components/ln-key/src/key-model.js

@@ -0,0 +1,146 @@
+const MODIFIER_ORDER = ['Ctrl', 'Alt', 'Shift', 'Meta'];
+
+const KEY_ALIASES = {
+	alt: 'Alt',
+	control: 'Ctrl',
+	ctrl: 'Ctrl',
+	meta: 'Meta',
+	command: 'Meta',
+	cmd: 'Meta',
+	option: 'Alt',
+	shift: 'Shift',
+	esc: 'Escape',
+	escape: 'Escape',
+	space: 'Space',
+	spacebar: 'Space',
+	enter: 'Enter',
+	return: 'Enter',
+	tab: 'Tab',
+	backspace: 'Backspace',
+	delete: 'Delete',
+	del: 'Delete',
+	insert: 'Insert',
+	home: 'Home',
+	end: 'End',
+	pageup: 'PageUp',
+	pagedown: 'PageDown',
+	arrowup: 'ArrowUp',
+	up: 'ArrowUp',
+	arrowdown: 'ArrowDown',
+	down: 'ArrowDown',
+	arrowleft: 'ArrowLeft',
+	left: 'ArrowLeft',
+	arrowright: 'ArrowRight',
+	right: 'ArrowRight'
+};
+
+function canonicalKey(value) {
+	if (value === ' ') return 'Space';
+
+	const raw = String(value || '').trim();
+	if (!raw) return '';
+
+	const alias = KEY_ALIASES[raw.toLowerCase()];
+	if (alias) return alias;
+	if (raw.length === 1) return raw.toUpperCase();
+	if (/^f\d{1,2}$/i.test(raw)) return raw.toUpperCase();
+
+	return raw.charAt(0).toUpperCase() + raw.slice(1);
+}
+
+export function normalizeShortcut(value) {
+	const raw = String(value || '').replace(/\s*\+\s*/g, '+').trim();
+	if (!raw) return '';
+
+	const parts = raw.split('+');
+	const modifiers = new Set();
+	let key = '';
+
+	for (let i = 0; i < parts.length; i++) {
+		const part = canonicalKey(parts[i]);
+		if (!part) return '';
+
+		if (MODIFIER_ORDER.indexOf(part) !== -1) {
+			modifiers.add(part);
+			continue;
+		}
+
+		if (key) return '';
+		key = part;
+	}
+
+	if (!key) return '';
+
+	const normalized = [];
+	for (let i = 0; i < MODIFIER_ORDER.length; i++) {
+		if (modifiers.has(MODIFIER_ORDER[i])) normalized.push(MODIFIER_ORDER[i]);
+	}
+	normalized.push(key);
+	return normalized.join('+');
+}
+
+export function parseShortcutList(value) {
+	const compact = String(value || '').replace(/\s*\+\s*/g, '+').trim();
+	if (!compact) return [];
+
+	const tokens = compact.split(/[\s,]+/);
+	const shortcuts = [];
+	for (let i = 0; i < tokens.length; i++) {
+		const normalized = normalizeShortcut(tokens[i]);
+		if (normalized && shortcuts.indexOf(normalized) === -1) {
+			shortcuts.push(normalized);
+		}
+	}
+	return shortcuts;
+}
+
+export function composeExternalShortcut(modifier, keyValue) {
+	const key = String(keyValue || '').trim();
+	if (!key || /[\s,]/.test(key)) return '';
+
+	const modifierValue = String(modifier || '').replace(/\s*\+\s*/g, '+').trim();
+	if (/[\s,]/.test(modifierValue)) return '';
+
+	return normalizeShortcut(modifierValue ? modifierValue + '+' + key : key);
+}
+
+export function eventToShortcut(event) {
+	if (!event) return '';
+
+	const key = canonicalKey(event.key);
+	if (!key || MODIFIER_ORDER.indexOf(key) !== -1) return '';
+
+	const parts = [];
+	if (event.ctrlKey) parts.push('Ctrl');
+	if (event.altKey) parts.push('Alt');
+	if (event.shiftKey) parts.push('Shift');
+	if (event.metaKey) parts.push('Meta');
+	parts.push(key);
+	return parts.join('+');
+}
+
+export function inferKeyAction(target) {
+	if (!target || !target.tagName) return null;
+
+	const tag = String(target.tagName).toLowerCase();
+	if (tag === 'button') return 'click';
+	if (tag === 'a' && target.hasAttribute && target.hasAttribute('href')) return 'click';
+	if (tag === 'input' || tag === 'textarea' || tag === 'select') return 'focus';
+
+	if (target.isContentEditable) return 'focus';
+	if (target.hasAttribute && target.hasAttribute('contenteditable')) {
+		const value = target.getAttribute('contenteditable');
+		if (value === '' || String(value).toLowerCase() !== 'false') return 'focus';
+	}
+
+	return null;
+}
+
+export function browserAlreadyHandles(event, target, action, key) {
+	if (!event || !target || action !== 'click' || event.target !== target) return false;
+	if (event.ctrlKey || event.altKey || event.shiftKey || event.metaKey) return false;
+
+	const tag = String(target.tagName || '').toLowerCase();
+	if (tag === 'button') return key === 'Enter' || key === 'Space';
+	return tag === 'a' && target.hasAttribute && target.hasAttribute('href') && key === 'Enter';
+}

package/components/ln-key/src/ln-key.js

@@ -0,0 +1,201 @@
+import { dispatch, dispatchCancelable, isEditableTarget, isUsableTarget, registerComponent } from '../../ln-core';
+import { browserAlreadyHandles, composeExternalShortcut, eventToShortcut, inferKeyAction, parseShortcutList } from './key-model.js';
+
+(function () {
+	const DOM_SELECTOR = 'data-ln-key';
+	const DOM_ATTRIBUTE = 'lnKey';
+	const TARGET_ATTRIBUTE = 'data-ln-key-target';
+	const ALLOW_INPUT_ATTRIBUTE = 'data-ln-key-allow-input';
+	const MODIFIER_ATTRIBUTE = 'data-ln-key-modifier';
+	const FOR_ATTRIBUTE = 'data-ln-key-for';
+	const FOR_DOM_ATTRIBUTE = 'lnKeyFor';
+	if (window[DOM_ATTRIBUTE] !== undefined) return;
+
+	// ─── Attribute Contract (SSOT) ──────────────────────────
+	function _syncKey(el) {
+		const instance = el[DOM_ATTRIBUTE];
+		if (!instance) return;
+		if (!el.hasAttribute(DOM_SELECTOR)) {
+			instance.destroy();
+			return;
+		}
+		instance.sync();
+	}
+
+	function _syncKeyFor(el) {
+		const instance = el[FOR_DOM_ATTRIBUTE];
+		if (instance && !el.hasAttribute(FOR_ATTRIBUTE)) instance.destroy();
+	}
+
+	const ATTRIBUTES = {
+		'data-ln-key':             { type: 'string', effect: _syncKey, description: 'Keyboard shortcut combination (e.g. meta+k, ctrl+s)' },
+		'data-ln-key-target':      { type: 'string', effect: _syncKey, description: 'Target element selector or ID to receive synthetic click or focus' },
+		'data-ln-key-allow-input': { type: 'boolean', effect: _syncKey, description: 'Permits shortcut execution even when focused inside an editable input' }
+	};
+
+	const FOR_ATTRIBUTES = {
+		'data-ln-key-for':      { type: 'string', effect: _syncKeyFor, description: 'Target element ID that this shortcut badge is displayed for' },
+		'data-ln-key-modifier': { type: 'string', description: 'Platform modifier text representation override' }
+	};
+
+	const instances = new Set();
+	let keydownListener = null;
+
+	function _ensureKeydownListener() {
+		if (keydownListener) return;
+		keydownListener = function (event) {
+			if (event.defaultPrevented || event.isComposing || event.repeat) return;
+
+			const key = eventToShortcut(event);
+			if (!key) return;
+
+			const editing = isEditableTarget(event.target);
+			const hosts = document.querySelectorAll('[' + DOM_SELECTOR + '], [' + FOR_ATTRIBUTE + ']');
+			let winner = null;
+			let hasDuplicate = false;
+			let nativeActivation = false;
+
+			for (let i = 0; i < hosts.length; i++) {
+				const host = hosts[i];
+				const instance = host[DOM_ATTRIBUTE] || host[FOR_DOM_ATTRIBUTE];
+				if (!instance || !instance.matches(key)) continue;
+				if (editing && !instance.allowsInput()) continue;
+
+				const target = instance.resolveTarget();
+				const action = inferKeyAction(target);
+				if (!action || !isUsableTarget(target, action)) continue;
+				if (browserAlreadyHandles(event, target, action, key)) {
+					nativeActivation = true;
+					continue;
+				}
+
+				if (!winner) {
+					winner = { host: host, target: target, action: action };
+				} else {
+					hasDuplicate = true;
+				}
+			}
+
+			if (nativeActivation || !winner) return;
+
+			if (hasDuplicate) {
+				console.warn('[ln-key] Duplicate active shortcut "' + key + '"; first DOM match wins.');
+			}
+
+			const detail = {
+				source: winner.host,
+				target: winner.target,
+				action: winner.action,
+				key: key,
+				event: event
+			};
+			const before = dispatchCancelable(winner.host, 'ln-key:before-trigger', detail);
+			if (before.defaultPrevented) return;
+
+			event.preventDefault();
+			winner.target[winner.action]();
+			dispatch(winner.host, 'ln-key:trigger', detail);
+		};
+		document.addEventListener('keydown', keydownListener);
+	}
+
+	function _maybeRemoveKeydownListener() {
+		if (instances.size > 0 || !keydownListener) return;
+		document.removeEventListener('keydown', keydownListener);
+		keydownListener = null;
+	}
+
+	function _component(dom) {
+		this.dom = dom;
+		this.shortcuts = [];
+		instances.add(this);
+		this.sync();
+		_ensureKeydownListener();
+		return this;
+	}
+
+	_component.prototype.sync = function () {
+		this.shortcuts = parseShortcutList(this.dom.getAttribute(DOM_SELECTOR));
+	};
+
+	_component.prototype.matches = function (key) {
+		return this.shortcuts.indexOf(key) !== -1;
+	};
+
+	_component.prototype.allowsInput = function () {
+		return this.dom.hasAttribute(ALLOW_INPUT_ATTRIBUTE);
+	};
+
+	_component.prototype.resolveTarget = function () {
+		const selector = this.dom.getAttribute(TARGET_ATTRIBUTE);
+		if (!selector) return this.dom;
+		return _resolveTarget(selector, TARGET_ATTRIBUTE);
+	};
+
+	_component.prototype.destroy = function () {
+		if (!this.dom[DOM_ATTRIBUTE]) return;
+		instances.delete(this);
+		delete this.dom[DOM_ATTRIBUTE];
+		_maybeRemoveKeydownListener();
+	};
+
+	function _externalComponent(dom) {
+		this.dom = dom;
+		instances.add(this);
+		_ensureKeydownListener();
+		return this;
+	}
+
+	_externalComponent.prototype._modifierContext = function () {
+		return this.dom.closest('[' + MODIFIER_ATTRIBUTE + ']');
+	};
+
+	_externalComponent.prototype.shortcut = function () {
+		const context = this._modifierContext();
+		const modifier = context ? context.getAttribute(MODIFIER_ATTRIBUTE) : '';
+		return composeExternalShortcut(modifier, this.dom.textContent);
+	};
+
+	_externalComponent.prototype.matches = function (key) {
+		return this.shortcut() === key;
+	};
+
+	_externalComponent.prototype.allowsInput = function () {
+		if (this.dom.hasAttribute(ALLOW_INPUT_ATTRIBUTE)) return true;
+		const context = this._modifierContext();
+		return !!(context && context.hasAttribute(ALLOW_INPUT_ATTRIBUTE));
+	};
+
+	_externalComponent.prototype.resolveTarget = function () {
+		return _resolveTarget(this.dom.getAttribute(FOR_ATTRIBUTE), FOR_ATTRIBUTE);
+	};
+
+	_externalComponent.prototype.destroy = function () {
+		if (!this.dom[FOR_DOM_ATTRIBUTE]) return;
+		instances.delete(this);
+		delete this.dom[FOR_DOM_ATTRIBUTE];
+		_maybeRemoveKeydownListener();
+	};
+
+	function _resolveTarget(selector, attribute) {
+		if (!selector) return null;
+		try {
+			const target = document.querySelector(selector);
+			if (!target) {
+				console.warn('[ln-key] Target not found for ' + attribute + ' selector "' + selector + '".');
+			}
+			return target;
+		} catch (error) {
+			console.warn('[ln-key] Invalid ' + attribute + ' selector "' + selector + '".');
+			return null;
+		}
+	}
+
+	registerComponent(DOM_SELECTOR, DOM_ATTRIBUTE, _component, 'ln-key', {
+		attributes: ATTRIBUTES
+	});
+
+	registerComponent(FOR_ATTRIBUTE, FOR_DOM_ATTRIBUTE, _externalComponent, 'ln-key-for', {
+		attributes: FOR_ATTRIBUTES
+	});
+})();

package/{js → components}/ln-link/README.md

@@ -1,8 +1,6 @@
 # ln-link
 
-> Turns a container into a click-navigable surface by triggering
-> `.click()` on the first inner `<a>`. Hover surfaces the URL in a
-> bottom-left status bar that mirrors the browser's native preview.
+> Applied to a table, tbody, or container element (`<table data-ln-link>`, `<div data-ln-link>`). It listens for container `click` events, resolves the first anchor tag (`row.querySelector('a')`) in document order, and calls `.click()` on that anchor while bypassing clicks on nested interactive elements (`<button>`, `<input>`, `<select>`, `<textarea>`). It dynamically appends a viewport status bar (`.ln-link-status`) mirroring the native URL preview on hover, leaving navigation entirely to the platform or SPA router.
 
 ## Philosophy
 
@@ -209,7 +207,7 @@ window.lnLink.destroy(container);
   activate it normally.
 - **Does not own appearance.** `cursor: pointer` and
   `user-select: none` come from `@mixin link-row`
-  (`scss/config/mixins/_link.scss`); the status bar styling comes
+  (`theme/config/mixins/_link.scss`); the status bar styling comes
   from `@mixin link-status`. JS owns behavior; SCSS owns
   appearance.
 
@@ -286,25 +284,25 @@ This is the recommended approach for standard integration, loading the component
 #### Standalone (Zero-Dependency IIFE)
 If you only need this component and want to avoid loading the full bundle, you can load it standalone using its zero-dependency compiled IIFE:
 ```html
-<script src="js/ln-link/ln-link.js" defer></script>
+<script src="components/ln-link/ln-link.js" defer></script>
 ```
 
 ### Source Files
 
-- **Active Development (Source of Truth)**: [js/ln-link/src/ln-link.js](file:///c:/laragon/www/ln-ashlar/js/ln-link/src/ln-link.js)
-- **Compiled Standalone Distribution**: [js/ln-link/ln-link.js](file:///c:/laragon/www/ln-ashlar/js/ln-link/ln-link.js)
+- **Active Development (Source of Truth)**: [components/ln-link/src/ln-link.js](file:///c:/laragon/www/ln-ashlar/components/ln-link/src/ln-link.js)
+- **Compiled Standalone Distribution**: [components/ln-link/ln-link.js](file:///c:/laragon/www/ln-ashlar/components/ln-link/ln-link.js)
 
 ## See also
 
 - [`../ln-ajax/README.md`](../ln-ajax/README.md) — ln-ajax interop details
-- [`../../scss/config/mixins/_link.scss`](../../scss/config/mixins/_link.scss) — `link-row` and `link-status` mixins
+- [`../../theme/config/mixins/_link.scss`](../../theme/config/mixins/_link.scss) — `link-row` and `link-status` mixins
 - [`../../demo/admin/src/pages/link.html`](../../demo/admin/src/pages/link.html) — interactive demo
 
 ---
 
 ## 🔧 Internals
 
-Source: `js/ln-link/ln-link.js`. Imports `dispatchCancelable` and `guardBody` from `../ln-core`.
+Source: `components/ln-link/ln-link.js`. Imports `dispatchCancelable` and `guardBody` from `../ln-core`.
 
 ### State surface
 

package/components/ln-link/ln-link-dev.scss

@@ -0,0 +1,8 @@
+@use '../../theme/config/mixins' as *;
+
+[data-ln-debug] {
+	// 1. Link Anchor Check: data-ln-link container must contain at least one <a href="...">
+	[data-ln-link]:not(:has(a[href])) {
+		@include dev-dom-error("[data-ln-link] container is missing a required child <a href=\"...\"> link.");
+	}
+}

package/components/ln-link/ln-link.js

@@ -0,0 +1 @@
+(function(){"use strict";function R(){return typeof window>"u"?!1:window.lnDebug===!0||window.lnCore&&window.lnCore._debugSink?!0:typeof document<"u"&&document.body?document.body.hasAttribute("data-ln-debug")||document.body.querySelector("[data-ln-debug]")!==null:!1}function k(e){if(typeof window>"u")return!1;if(window.lnDebug===!0)return!0;if(window.lnCore&&window.lnCore._debugIsContained)return e?window.lnCore._debugIsContained(e):window.lnCore._debugSink!==null;if(e&&e.closest){const t=e.closest("[data-ln-debug]");return!(!t||typeof document<"u"&&t===document.documentElement)}return typeof document<"u"&&document.body?document.body.hasAttribute("data-ln-debug"):!1}if(typeof window<"u"&&(window.lnCore=window.lnCore||{},!window.lnCore._warnBound)){window.lnCore._warnBound=!0;const e=console.warn;console.warn=function(...t){if(typeof t[0]=="string"&&(t[0].startsWith("[ln-")||t[0].startsWith("[lnCore"))){let i=null;for(let u=1;u<t.length;u++)if(t[u]&&t[u].nodeType===1){i=t[u];break}if(!k(i))return}e.apply(console,t)}}function q(e,t,n){const i=n||{};window.lnCore._debugSink&&window.lnCore._debugSink("event",t,e,i),e.dispatchEvent(new CustomEvent(t,{bubbles:!0,detail:i}))}function B(e,t,n){const i=n||{};window.lnCore._debugSink&&window.lnCore._debugSink("event",t,e,i);const u=new CustomEvent(t,{bubbles:!0,cancelable:!0,detail:i});return e.dispatchEvent(u),u}function g(e,t){if(!document.body){document.addEventListener("DOMContentLoaded",function(){g(e,t)}),console.warn("["+t+'] Script loaded before <body> — add "defer" to your <script> tag');return}e()}const _={};function I(e,t){_[e]=t}function M(e){return _[e]||{ingress:t=>t,egress:t=>t}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerDataMapper=I,window.lnCore.getDataMapper=M);function F(){typeof window>"u"||(window.lnCore=window.lnCore||{},!window.lnCore._localeObserverBound&&(window.lnCore._localeObserverBound=!0,g(function(){new MutationObserver(function(){q(document,"ln-core:locale-change",{})}).observe(document.documentElement,{attributes:!0,attributeFilter:["lang"],subtree:!0})},"ln-core")))}const v={};function W(e,t){if(!e||typeof t!="object")return;const n=e.toLowerCase().split("-")[0];v[n]=t}function N(e){if(!e)return null;const t=e.toLowerCase().split("-")[0];return v[t]||null}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerLocaleFallback=W,window.lnCore.getLocaleFallback=N,window.lnCore.ensureLocaleObserver=F);const C={};function V(e,t){C[e]||(C[e]=document.querySelector('[data-ln-template="'+e+'"]'));const n=C[e];return n?n.content.cloneNode(!0):(console.warn("["+(t||"ln-core")+'] Template "'+e+'" not found'),null)}function S(e,t){if(!e||!t)return e;const n=e.querySelectorAll("[data-ln-field]");for(let r=0;r<n.length;r++){const c=n[r],s=c.getAttribute("data-ln-field");t[s]!=null&&(c.textContent=t[s])}const i=e.querySelectorAll("[data-ln-attr]");for(let r=0;r<i.length;r++){const c=i[r],s=c.getAttribute("data-ln-attr").split(",");for(let a=0;a<s.length;a++){const w=s[a].trim().split(":");if(w.length!==2)continue;const h=w[0].trim(),p=w[1].trim();t[p]!=null&&c.setAttribute(h,t[p])}}const u=e.querySelectorAll("[data-ln-show]");for(let r=0;r<u.length;r++){const c=u[r],s=c.getAttribute("data-ln-show");s in t&&c.classList.toggle("hidden",!t[s])}const o=e.querySelectorAll("[data-ln-class]");for(let r=0;r<o.length;r++){const c=o[r],s=c.getAttribute("data-ln-class").split(",");for(let a=0;a<s.length;a++){const w=s[a].trim().split(":");if(w.length!==2)continue;const h=w[0].trim(),p=w[1].trim();p in t&&c.classList.toggle(h,!!t[p])}}return e}function j(e,t){e.matches&&e.matches("[data-ln-form], [data-ln-fillable]")&&(window.lnCore._debugSink&&window.lnCore._debugSink("event","ln-fill",e,t??null),e.dispatchEvent(new CustomEvent("ln-fill",{detail:t??null,bubbles:!0})));const n=e.querySelectorAll("[data-ln-form], [data-ln-fillable]");for(let i=0;i<n.length;i++)window.lnCore._debugSink&&window.lnCore._debugSink("event","ln-fill",n[i],t??null),n[i].dispatchEvent(new CustomEvent("ln-fill",{detail:t??null,bubbles:!0}));return e}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore._fillBound||(window.lnCore._fillBound=!0,document.addEventListener("ln-fill",function(e){if(!(!e.target.matches||!e.target.matches("[data-ln-fillable]")))if(e.detail)S(e.target,e.detail);else{const t=e.target.querySelectorAll("[data-ln-field]");for(let n=0;n<t.length;n++)t[n].textContent=""}})));function L(e,t){if(!e||!t)return e;const n=document.createTreeWalker(e,NodeFilter.SHOW_TEXT);for(;n.nextNode();){const o=n.currentNode;o.textContent.indexOf("{{")!==-1&&(o.textContent=o.textContent.replace(/\{\{\s*(\w+)\s*\}\}/g,function(r,c){return t[c]!==void 0?t[c]:""}))}const i=function(o,r){return t[r]!==void 0?t[r]:""},u=Array.from(e.querySelectorAll("*"));e.nodeType===1&&u.push(e);for(let o=0;o<u.length;o++){const r=u[o],c=r.attributes;for(let s=0;s<c.length;s++){const a=c[s];a.value.indexOf("{{")!==-1&&r.setAttribute(a.name,a.value.replace(/\{\{\s*(\w+)\s*\}\}/g,i))}}return e}function K(e,t,n,i,u,o){const r={};for(let s=0;s<e.children.length;s++){const a=e.children[s],w=a.getAttribute("data-ln-render-key");w&&(r[w]=a)}const c=document.createDocumentFragment();for(let s=0;s<t.length;s++){const a=t[s],w=String(i(a));let h=r[w];if(h)u(h,a,s);else{const p=V(n,o);if(!p||(L(p,a),h=p.firstElementChild,!h))continue;h.setAttribute("data-ln-render-key",w),u(h,a,s)}c.appendChild(h)}e.textContent="",e.appendChild(c)}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.fillTemplate=L,window.lnCore.fill=S,window.lnCore.lnFill=j,window.lnCore.renderList=K);function H(e,t,n,i,u){if(!e||t===null)return!0;const o=i||"ln-component",r=e.type;if(r==="trigger"||r==="marker"||r==="string"||r==="list"||!r||t===""&&e.fallback!==void 0)return!0;const c=s=>{u?console.warn(s,u):console.warn(s)};if(r==="boolean"){const s=t.trim().toLowerCase();return s!==""&&s!=="true"&&s!=="false"&&s!=="1"&&s!=="0"?(c(`[${o}] Invalid value "${t}" for boolean attribute "${n}". Allowed: "true", "false", or presence-only.`),!1):!0}if(r==="enum"){const s=e.values||[];return s.includes(t)?!0:(c(`[${o}] Invalid value "${t}" for attribute "${n}". Allowed: ${s.join(", ")}. Fallback: "${e.fallback}".`),!1)}if(r==="integer"){if(!/^-?\d+$/.test(t))return c(`[${o}] Invalid integer "${t}" for attribute "${n}". Fallback: ${e.fallback}.`),!1;const s=parseInt(t,10);return e.min!==void 0&&s<e.min?(c(`[${o}] Value ${s} for attribute "${n}" is less than min (${e.min}).`),!1):e.max!==void 0&&s>e.max?(c(`[${o}] Value ${s} for attribute "${n}" is greater than max (${e.max}).`),!1):!0}if(r==="float")return isNaN(Number(t))?(c(`[${o}] Invalid float "${t}" for attribute "${n}". Fallback: ${e.fallback}.`),!1):!0;if(r==="json")try{return JSON.parse(t),!0}catch(s){return c(`[${o}] Invalid JSON for attribute "${n}": ${s.message}. Fallback: ${e.fallback}.`),!1}return!0}function U(e){if(e.onAttrChange&&!e.declared)return null;const t=new Set;if(e.effects)for(const n in e.effects)t.add(n);if(e.onAttrChange&&e.declared)for(const n of e.declared)t.add(n);return t}function Y(e,t,n,i){if(e.nodeType!==1)return;const o=t.indexOf("[")!==-1||t.indexOf(".")!==-1||t.indexOf("#")!==-1?t:"["+t+"]",r=Array.from(e.querySelectorAll(o));e.matches&&e.matches(o)&&r.push(e);for(const c of r)if(!c[n]){window.lnCore._persistSink&&c.hasAttribute("data-ln-persist")&&window.lnCore._persistSink(c,t);try{c[n]=new i(c)}catch(s){console.error("["+n+"] init failed",c,s)}}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore._bootHolds=window.lnCore._bootHolds||0,window.lnCore._bootQueue=window.lnCore._bootQueue||[]);function E(){window.lnCore=window.lnCore||{};const e=window.lnCore._attrRegistry=window.lnCore._attrRegistry||{byAttr:new Map,reactive:[],persist:[]};return e.byReactive=e.byReactive||new Map,e.reactiveWildcard=e.reactiveWildcard||[],e}function G(e){const t=E(),n=e.observed||[];for(let i=0;i<n.length;i++){const u=n[i];t.byAttr.has(u)||t.byAttr.set(u,[]),t.byAttr.get(u).push(e)}if(t.byDeclaredAttr=t.byDeclaredAttr||new Map,e.attributes)for(const i in e.attributes){t.byDeclaredAttr.has(i)||t.byDeclaredAttr.set(i,[]);const u=t.byDeclaredAttr.get(i);u.some(o=>o.componentTag===e.componentTag)||u.push({spec:e.attributes[i],componentTag:e.componentTag})}if(e.onAttrChange||e.effects){t.reactive.push(e);const i=U(e);if(i===null)t.reactiveWildcard.push(e);else for(const u of i)t.byReactive.has(u)||t.byReactive.set(u,[]),t.byReactive.get(u).push(e)}e.persist&&t.persist.push(e)}function O(e,t,n,i){for(let u=0;u<e.length;u++){const o=e[u];if(!t[o.attribute])continue;const r=o.effects&&o.effects[n];r?r(t,n,i):o.onAttrChange&&(!o.declared||o.declared.has(n))&&o.onAttrChange(t,n,i)}}function J(e){const t=e.target,n=e.attributeName;if(e.oldValue===t.getAttribute(n))return;const i=E(),u=i.byAttr.get(n);if(R()&&i.byDeclaredAttr&&i.byDeclaredAttr.has(n)&&k(t)){const o=i.byDeclaredAttr.get(n),r=t.getAttribute(n);for(let c=0;c<o.length;c++)H(o[c].spec,r,n,o[c].componentTag,t)}if(window.lnCore._debugSink&&(n.indexOf("data-ln-")===0||u)&&window.lnCore._debugSink("attr",n,t,{oldValue:e.oldValue,newValue:t.getAttribute(n)}),n.indexOf("data-ln-")===0){const o=i.byReactive.get(n);o&&O(o,t,n,e.oldValue),i.reactiveWildcard.length&&O(i.reactiveWildcard,t,n,e.oldValue)}if(u)for(let o=0;o<u.length;o++){const r=u[o];if(r.handler){r.handler(t,n,e.oldValue);continue}r.onAttributeChange&&t[r.attribute]?r.onAttributeChange(t,n):(Y(t,r.selector,r.attribute,r.ComponentFn),r.onInit&&r.onInit(t))}}function P(){window.lnCore=window.lnCore||{},!window.lnCore._attrObserverBound&&(window.lnCore._attrObserverBound=!0,g(function(){new MutationObserver(function(t){for(let n=0;n<t.length;n++)try{J(t[n])}catch(i){console.error("[ln-core] mutation handler failed",t[n].target,i)}}).observe(document.body,{attributes:!0,subtree:!0,attributeOldValue:!0})},"ln-core"))}function Q(e,t){G({observed:e,handler:t}),P()}function D(e){return(e||"").replace(/^#/,"")}function m(e){const t=e===void 0?location.hash:e,n={},i=D(t);if(!i)return n;const u=i.split("&");for(let o=0;o<u.length;o++){const r=u[o];if(!r)continue;const c=r.indexOf(":"),s=c>-1?r.slice(0,c):r,a=c>-1?r.slice(c+1):"";if(s)try{n[s]=decodeURIComponent(a)}catch{n[s]=a}}return n}function z(e){if(!e)return null;const t=m();return e in t?t[e]:null}function X(e,t){if(!e)return;const n=m();t==null?delete n[e]:n[e]=String(t);const u=Object.keys(n).map(function(o){const r=n[o];return r===""?o:o+":"+encodeURIComponent(r)}).join("&");D(location.hash)!==u&&(location.hash=u)}function Z(e){return e.button===1||e.ctrlKey||e.metaKey||e.shiftKey?!1:(e.preventDefault(),!0)}function ee(e,t){if(!e||!e.hasAttribute("data-ln-hash"))return null;const n=e.getAttribute("data-ln-hash");if(n&&n.trim()!=="")return n.trim();const i=e.getAttribute("data-ln-sort")||e.getAttribute("data-ln-search-for")||e.getAttribute("data-ln-search")||e.getAttribute("data-ln-filter")||e.id;return i?t?i+"-"+t:i:t||null}function te(e,t){return!t||t==="none"||e===null||e===void 0?null:String(e)+"."+t}function ne(e){return!e||typeof e!="string"?null:e.endsWith(".asc")?{fieldOrColumn:e.slice(0,-4),direction:"asc"}:e.endsWith(".desc")?{fieldOrColumn:e.slice(0,-5),direction:"desc"}:null}function re(e,t){return!e||!Array.isArray(t)||t.length===0?null:e+":"+t.map(encodeURIComponent).join(",")}function ie(e){if(!e||typeof e!="string")return null;const t=e.indexOf(":");if(t===-1)return null;const n=e.slice(0,t),i=e.slice(t+1),u=i?i.split(",").map(function(o){try{return decodeURIComponent(o)}catch{return o}}).filter(Boolean):[];return{key:n,values:u}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.hashParse=m,window.lnCore.hashGet=z,window.lnCore.hashSet=X,window.lnCore.hashLinkClick=Z,window.lnCore.resolveHashNamespace=ee,window.lnCore.hashSortEncode=te,window.lnCore.hashSortDecode=ne,window.lnCore.hashFilterEncode=re,window.lnCore.hashFilterDecode=ie),(function(){const e="data-ln-link",t="lnLink";if(window[t]!==void 0)return;let n=null;function i(){n=document.createElement("div"),n.className="ln-link-status",document.body.appendChild(n)}function u(l){n&&(n.textContent=l,n.classList.add("ln-link-status--visible"))}function o(){n&&n.classList.remove("ln-link-status--visible")}function r(l,d){if(d.target.closest("a, button, input, select, textarea"))return;const f=l.querySelector("a");if(!f)return;const b=f.getAttribute("href");if(!b)return;if(d.ctrlKey||d.metaKey||d.button===1){window.open(b,"_blank","noopener,noreferrer");return}B(l,"ln-link:navigate",{target:l,href:b,link:f}).defaultPrevented||f.click()}function c(l){const d=l.querySelector("a");if(!d)return;const f=d.getAttribute("href");f&&u(f)}function s(){o()}function a(l){l[t+"Row"]||!l.querySelector("a")||(l[t+"Row"]=!0,l._lnLinkClick=function(f){r(l,f)},l._lnLinkEnter=function(){c(l)},l.addEventListener("click",l._lnLinkClick),l.addEventListener("mouseenter",l._lnLinkEnter),l.addEventListener("mouseleave",s))}function w(l){l[t+"Row"]&&(l._lnLinkClick&&l.removeEventListener("click",l._lnLinkClick),l._lnLinkEnter&&l.removeEventListener("mouseenter",l._lnLinkEnter),l.removeEventListener("mouseleave",s),delete l._lnLinkClick,delete l._lnLinkEnter,delete l[t+"Row"])}function h(l){if(!l[t+"Init"])return;const d=l.tagName;if(d==="TABLE"||d==="TBODY"){const f=d==="TABLE"&&l.querySelector("tbody")||l;for(const b of f.querySelectorAll("tr"))w(b)}else w(l);delete l[t+"Init"]}function p(l){if(l[t+"Init"])return;l[t+"Init"]=!0;const d=l.tagName;if(d==="TABLE"||d==="TBODY"){const f=d==="TABLE"&&l.querySelector("tbody")||l;for(const b of f.querySelectorAll("tr"))a(b)}else a(l)}function y(l){l.hasAttribute&&l.hasAttribute(e)&&p(l);const d=l.querySelectorAll?l.querySelectorAll("["+e+"]"):[];for(const f of d)p(f)}function oe(){g(function(){new MutationObserver(function(d){for(const f of d)if(f.type==="childList"){for(const b of f.addedNodes)if(b.nodeType===1){y(b);const A=b.closest("["+e+"]");if(A)if(b.tagName==="TR")a(b);else{const x=A.tagName;if(x==="TABLE"||x==="TBODY"){const le=b.querySelectorAll?b.querySelectorAll("tr"):[];for(const se of le)a(se)}}}}}).observe(document.body,{childList:!0,subtree:!0}),Q([e],function(d){d.hasAttribute&&d.hasAttribute(e)?y(d):h(d)})},"ln-link")}function T(l){y(l)}window[t]={init:T,destroy:h};function $(){i(),oe(),T(document.body)}document.readyState==="loading"?document.addEventListener("DOMContentLoaded",$):$()})()})();

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

@@ -0,0 +1,22 @@
+{
+	"$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-link",
+	"generator": "scripts/sync-ln-schemas.mjs",
+	"attributes": {
+		"data-ln-debug": {
+			"direction": null,
+			"sources": [
+				"ln-link-dev.scss"
+			]
+		},
+		"data-ln-link": {
+			"direction": "author",
+			"sources": [
+				"ln-link-dev.scss",
+				"src/ln-link.js"
+			],
+			"type": "marker",
+			"description": "Makes entire table row or container clickable based on child anchor link"
+		}
+	}
+}

package/{js → components}/ln-link/src/ln-link.js

@@ -1,4 +1,4 @@
-import { dispatchCancelable, guardBody } from '../../ln-core';
+import { dispatchCancelable, guardBody, observeAttributes } from '../../ln-core';
 
 (function () {
 	const DOM_SELECTOR = 'data-ln-link';
@@ -6,6 +6,11 @@ import { dispatchCancelable, guardBody } from '../../ln-core';
 
 	if (window[DOM_ATTRIBUTE] !== undefined) return;
 
+	// ─── Attribute Contract (SSOT) ──────────────────────────
+	const ATTRIBUTES = {
+		'data-ln-link': { type: 'marker', description: 'Makes entire table row or container clickable based on child anchor link' }
+	};
+
 	// ─── Status Bar ────────────────────────────────────────────
 
 	let _statusEl = null;
@@ -39,7 +44,7 @@ import { dispatchCancelable, guardBody } from '../../ln-core';
 		if (!href) return;
 
 		if (e.ctrlKey || e.metaKey || e.button === 1) {
-			window.open(href, '_blank');
+			window.open(href, '_blank', 'noopener,noreferrer');
 			return;
 		}
 
@@ -169,21 +174,21 @@ import { dispatchCancelable, guardBody } from '../../ln-core';
 								}
 							}
 						}
-					} else if (mutation.type === 'attributes') {
-						if (mutation.target.hasAttribute && mutation.target.hasAttribute(DOM_SELECTOR)) {
-							findElements(mutation.target);
-						} else {
-							_destroyContainer(mutation.target);
-						}
 					}
 				}
 			});
 
 			observer.observe(document.body, {
 				childList: true,
-				subtree: true,
-				attributes: true,
-				attributeFilter: [DOM_SELECTOR]
+				subtree: true
+			});
+
+			observeAttributes([DOM_SELECTOR], function (el) {
+				if (el.hasAttribute && el.hasAttribute(DOM_SELECTOR)) {
+					findElements(el);
+				} else {
+					_destroyContainer(el);
+				}
 			});
 		}, 'ln-link');
 	}