@livenetworks/ashlar 1.6.1 → 2.0.1

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

@@ -0,0 +1,159 @@
+import { dispatch, registerComponent } from '../../ln-core';
+import {
+	obfuscate,
+	deobfuscate,
+	utf8ToBase64,
+	base64ToUtf8,
+	xorObfuscate,
+	xorDeobfuscate
+} from './obfuscator-model.js';
+
+(function () {
+	const DOM_SELECTOR = 'data-ln-obfuscator';
+	const DOM_ATTRIBUTE = 'lnObfuscator';
+
+	if (window[DOM_ATTRIBUTE] !== undefined) return;
+
+	function _syncAttribute(el) {
+		const inst = el[DOM_ATTRIBUTE];
+		if (!inst) return;
+		inst.deobfuscate();
+	}
+
+	// ─── Attribute Contract (SSOT) ──────────────────────────
+	const ATTRIBUTES = {
+		'data-ln-obfuscator':       { type: 'enum', values: ['rot13', 'base64', 'xor'], fallback: 'rot13', effect: _syncAttribute, description: 'Codec used to deobfuscate text or links' },
+		'data-ln-obfuscator-codec': { type: 'enum', values: ['rot13', 'base64', 'xor'], fallback: 'rot13', effect: _syncAttribute, description: 'Explicit codec override attribute' },
+		'data-ln-obfuscator-key':   { type: 'string', effect: _syncAttribute, description: 'Encryption or masking key for XOR codec' }
+	};
+
+	// ─── Component Constructor ───────────────────────────────
+	function _component(dom) {
+		if (dom[DOM_ATTRIBUTE]) return dom[DOM_ATTRIBUTE];
+		dom[DOM_ATTRIBUTE] = this;
+		this.dom = dom;
+		this._originalTextNodes = null;
+		this._originalHref = null;
+
+		this.deobfuscate();
+		return this;
+	}
+
+	// ─── Core Deobfuscation Logic ────────────────────────────
+	_component.prototype.deobfuscate = function () {
+		const isLink = Boolean(this.dom.matches && (this.dom.matches('a') || this.dom.matches('area')));
+
+		// Capture initial raw href before first mutation
+		if (this._originalHref === null && isLink && this.dom.hasAttribute('href')) {
+			this._originalHref = this.dom.getAttribute('href');
+		}
+
+		// Capture initial raw text nodes (or re-capture if child nodes were replaced)
+		const needsRescan = !this._originalTextNodes || this._originalTextNodes.length === 0 || this._originalTextNodes.some(item => !this.dom.contains(item.node));
+		if (needsRescan) {
+			this._originalTextNodes = [];
+			if (typeof document !== 'undefined' && document.createTreeWalker) {
+				const walker = document.createTreeWalker(this.dom, NodeFilter.SHOW_TEXT, {
+					acceptNode: function (node) {
+						if (node.parentElement && node.parentElement.classList && node.parentElement.classList.contains('sr-only')) {
+							return NodeFilter.FILTER_REJECT;
+						}
+						return NodeFilter.FILTER_ACCEPT;
+					}
+				});
+				while (walker.nextNode()) {
+					this._originalTextNodes.push({
+						node: walker.currentNode,
+						raw: walker.currentNode.nodeValue
+					});
+				}
+			}
+		}
+
+		const rawShift = this.dom.getAttribute(DOM_SELECTOR);
+		const parsed = parseInt(rawShift, 10);
+		const shift = isNaN(parsed) ? 13 : parsed;
+
+		const rawCodec = (this.dom.getAttribute('data-ln-obfuscator-codec') || '').toLowerCase().trim();
+		const rawKey = this.dom.getAttribute('data-ln-obfuscator-key');
+
+		let codec = 'rot';
+		if (rawCodec === 'xor' || rawCodec === 'base64') {
+			codec = rawCodec;
+		} else if (rawKey) {
+			codec = 'xor';
+		}
+
+		const key = rawKey || 'ln-ashlar';
+		const options = { codec, shift, key };
+
+		// Reset premature ln-external-links decoration if present
+		if (isLink && this.dom.getAttribute('data-ln-external-link') === 'processed') {
+			const hints = this.dom.querySelectorAll('.sr-only');
+			for (let i = 0; i < hints.length; i++) {
+				hints[i].remove();
+			}
+			this.dom.removeAttribute('data-ln-external-link');
+			this.dom.removeAttribute('target');
+			const relParts = (this.dom.rel || '').split(/\s+/).filter(function (r) {
+				return r && r !== 'noopener' && r !== 'noreferrer';
+			});
+			if (relParts.length > 0) {
+				this.dom.rel = relParts.join(' ');
+			} else {
+				this.dom.removeAttribute('rel');
+			}
+		}
+
+		// Apply deobfuscation to text nodes using the stored original raw text
+		if (this._originalTextNodes) {
+			for (let i = 0; i < this._originalTextNodes.length; i++) {
+				const item = this._originalTextNodes[i];
+				if (item.node && item.raw && item.raw.length > 0) {
+					item.node.nodeValue = deobfuscate(item.raw, options);
+				}
+			}
+		}
+
+		// Apply deobfuscation to href attribute using stored original raw href
+		if (isLink && this._originalHref) {
+			const deobfuscatedHref = deobfuscate(this._originalHref, options);
+			this.dom.setAttribute('href', deobfuscatedHref);
+		}
+
+		dispatch(this.dom, 'ln-obfuscator:deobfuscated', {
+			target: this.dom,
+			codec: codec,
+			shift: shift,
+			key: codec === 'xor' ? key : null
+		});
+	};
+
+	_component.prototype.destroy = function () {
+		if (!this.dom[DOM_ATTRIBUTE]) return;
+		if (this._originalTextNodes) {
+			for (let i = 0; i < this._originalTextNodes.length; i++) {
+				const item = this._originalTextNodes[i];
+				if (item.node && item.raw) {
+					item.node.nodeValue = item.raw;
+				}
+			}
+		}
+		if (this._originalHref !== null) {
+			this.dom.setAttribute('href', this._originalHref);
+		}
+		delete this.dom[DOM_ATTRIBUTE];
+	};
+
+	// ─── Registration & Global Helpers ──────────────────────
+	const constructor = registerComponent(DOM_SELECTOR, DOM_ATTRIBUTE, _component, 'ln-obfuscator', {
+		attributes: ATTRIBUTES
+	});
+
+	constructor.obfuscate = obfuscate;
+	constructor.deobfuscate = deobfuscate;
+	constructor.utf8ToBase64 = utf8ToBase64;
+	constructor.base64ToUtf8 = base64ToUtf8;
+	constructor.xorObfuscate = xorObfuscate;
+	constructor.xorDeobfuscate = xorDeobfuscate;
+})();

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

@@ -0,0 +1,250 @@
+/**
+ * components/ln-obfuscator/src/obfuscator-model.js
+ *
+ * Pure cipher and encoding algorithms for ln-obfuscator.
+ * Supports:
+ *  - 'rot' (default): Caesar / ROT-N on [a-zA-Z] (mod 26) and [0-9] (mod 10).
+ *  - 'base64': UTF-8 safe Base64 encoding for arbitrary unicode / scripts (Cyrillic, CJK, etc.).
+ *  - 'xor': Symmetric multi-byte XOR cipher with Base64 ASCII transport for arbitrary unicode.
+ *
+ * Zero DOM dependencies.
+ */
+
+/**
+ * Shifts an ASCII alphabetic character (mod 26) or digit (mod 10) by the given offset (preserving case).
+ * Non-alphanumeric characters (symbols, spaces, unicode) are returned untouched.
+ *
+ * @param {string} char - Single character
+ * @param {number} shift - Integer shift offset
+ * @returns {string} Shifted character
+ */
+export function rotChar(char, shift) {
+	if (char.length !== 1) return char;
+	const code = char.charCodeAt(0);
+
+	// Uppercase A-Z (65-90)
+	if (code >= 65 && code <= 90) {
+		const offset = ((code - 65 + shift) % 26 + 26) % 26;
+		return String.fromCharCode(65 + offset);
+	}
+
+	// Lowercase a-z (97-122)
+	if (code >= 97 && code <= 122) {
+		const offset = ((code - 97 + shift) % 26 + 26) % 26;
+		return String.fromCharCode(97 + offset);
+	}
+
+	// Digits 0-9 (48-57)
+	if (code >= 48 && code <= 57) {
+		const offset = ((code - 48 + shift) % 10 + 10) % 10;
+		return String.fromCharCode(48 + offset);
+	}
+
+	return char;
+}
+
+/**
+ * Encodes any UTF-8 string into Base64 (browser & Node compatible, Unicode-safe).
+ *
+ * @param {string} str - Input text
+ * @returns {string} Base64 encoded string
+ */
+export function utf8ToBase64(str) {
+	if (str == null || str === '') return '';
+	const input = String(str);
+	if (typeof TextEncoder !== 'undefined' && typeof btoa !== 'undefined') {
+		const bytes = new TextEncoder().encode(input);
+		let binary = '';
+		const len = bytes.length;
+		for (let i = 0; i < len; i++) {
+			binary += String.fromCharCode(bytes[i]);
+		}
+		return btoa(binary);
+	}
+	if (typeof Buffer !== 'undefined') {
+		return Buffer.from(input, 'utf-8').toString('base64');
+	}
+	return '';
+}
+
+/**
+ * Decodes a Base64 string back into a UTF-8 string (browser & Node compatible, Unicode-safe).
+ *
+ * @param {string} b64 - Base64 string
+ * @returns {string} Decoded UTF-8 string
+ */
+export function base64ToUtf8(b64) {
+	if (b64 == null || b64 === '') return '';
+	try {
+		const trimmed = String(b64).trim();
+		if (typeof atob !== 'undefined' && typeof TextDecoder !== 'undefined') {
+			const binary = atob(trimmed);
+			const bytes = new Uint8Array(binary.length);
+			for (let i = 0; i < binary.length; i++) {
+				bytes[i] = binary.charCodeAt(i);
+			}
+			return new TextDecoder().decode(bytes);
+		}
+		if (typeof Buffer !== 'undefined') {
+			return Buffer.from(trimmed, 'base64').toString('utf-8');
+		}
+	} catch {
+		return b64;
+	}
+	return b64;
+}
+
+/**
+ * Performs byte-level XOR with a repeating key.
+ *
+ * @param {Uint8Array} bytes - Input bytes
+ * @param {string} keyStr - Key string
+ * @returns {Uint8Array} XOR transformed bytes
+ */
+export function xorBytes(bytes, keyStr) {
+	const key = String(keyStr || 'ln-ashlar');
+	let keyBytes;
+	if (typeof TextEncoder !== 'undefined') {
+		keyBytes = new TextEncoder().encode(key);
+	} else if (typeof Buffer !== 'undefined') {
+		keyBytes = Buffer.from(key, 'utf-8');
+	} else {
+		keyBytes = [108, 110];
+	}
+	const keyLen = keyBytes.length || 1;
+	const out = new Uint8Array(bytes.length);
+	for (let i = 0; i < bytes.length; i++) {
+		out[i] = bytes[i] ^ keyBytes[i % keyLen];
+	}
+	return out;
+}
+
+/**
+ * Obfuscates UTF-8 text with an XOR cipher and returns Base64 ASCII text.
+ *
+ * @param {string} text - Input text (any script / unicode)
+ * @param {string} [key='ln-ashlar'] - Secret key
+ * @returns {string} Base64 encoded XOR payload
+ */
+export function xorObfuscate(text, key = 'ln-ashlar') {
+	if (text == null || text === '') return '';
+	const input = String(text);
+	let bytes;
+	if (typeof TextEncoder !== 'undefined') {
+		bytes = new TextEncoder().encode(input);
+	} else if (typeof Buffer !== 'undefined') {
+		bytes = Buffer.from(input, 'utf-8');
+	} else {
+		return '';
+	}
+	const xored = xorBytes(bytes, key);
+	let binary = '';
+	for (let i = 0; i < xored.length; i++) {
+		binary += String.fromCharCode(xored[i]);
+	}
+	if (typeof btoa !== 'undefined') {
+		return btoa(binary);
+	}
+	if (typeof Buffer !== 'undefined') {
+		return Buffer.from(xored).toString('base64');
+	}
+	return '';
+}
+
+/**
+ * Deobfuscates Base64 ASCII XOR payload back into UTF-8 text.
+ *
+ * @param {string} b64 - Base64 encoded XOR payload
+ * @param {string} [key='ln-ashlar'] - Secret key used during obfuscation
+ * @returns {string} Plain UTF-8 text
+ */
+export function xorDeobfuscate(b64, key = 'ln-ashlar') {
+	if (b64 == null || b64 === '') return '';
+	try {
+		const trimmed = String(b64).trim();
+		let binary = '';
+		if (typeof atob !== 'undefined') {
+			binary = atob(trimmed);
+		} else if (typeof Buffer !== 'undefined') {
+			binary = Buffer.from(trimmed, 'base64').toString('binary');
+		} else {
+			return b64;
+		}
+		const bytes = new Uint8Array(binary.length);
+		for (let i = 0; i < binary.length; i++) {
+			bytes[i] = binary.charCodeAt(i);
+		}
+		const xored = xorBytes(bytes, key);
+		if (typeof TextDecoder !== 'undefined') {
+			return new TextDecoder().decode(xored);
+		}
+		if (typeof Buffer !== 'undefined') {
+			return Buffer.from(xored).toString('utf-8');
+		}
+	} catch {
+		return b64;
+	}
+	return b64;
+}
+
+/**
+ * Parses options argument for obfuscate / deobfuscate.
+ * @private
+ */
+function _parseOptions(options) {
+	if (typeof options === 'number' || (typeof options === 'string' && /^-?\d+$/.test(String(options).trim()))) {
+		return { codec: 'rot', shift: Number(options) || 13, key: 'ln-ashlar' };
+	}
+	if (options && typeof options === 'object') {
+		const rawCodec = (options.codec || (options.key ? 'xor' : 'rot')).toLowerCase().trim();
+		const codec = (rawCodec === 'xor' || rawCodec === 'base64') ? rawCodec : 'rot';
+		const shift = Number(options.shift) || 13;
+		const key = options.key || 'ln-ashlar';
+		return { codec, shift, key };
+	}
+	return { codec: 'rot', shift: 13, key: 'ln-ashlar' };
+}
+
+/**
+ * Obfuscates a string with the configured codec ('rot', 'base64', or 'xor').
+ *
+ * @param {string} text - Input text
+ * @param {number|object} [options=13] - Shift offset (number) or options object `{ codec, shift, key }`
+ * @returns {string} Obfuscated string
+ */
+export function obfuscate(text, options = 13) {
+	if (text == null) return '';
+	if (typeof text !== 'string') text = String(text);
+	if (text.length === 0) return '';
+
+	const opts = _parseOptions(options);
+	if (opts.codec === 'base64') {
+		return utf8ToBase64(text);
+	}
+	if (opts.codec === 'xor') {
+		return xorObfuscate(text, opts.key);
+	}
+	return text.replace(/[a-zA-Z0-9]/g, (c) => rotChar(c, opts.shift));
+}
+
+/**
+ * Deobfuscates a string by reversing the configured codec ('rot', 'base64', or 'xor').
+ *
+ * @param {string} text - Obfuscated text
+ * @param {number|object} [options=13] - Original shift offset (number) or options object `{ codec, shift, key }`
+ * @returns {string} Plain text
+ */
+export function deobfuscate(text, options = 13) {
+	if (text == null) return '';
+	if (typeof text !== 'string') text = String(text);
+	if (text.length === 0) return '';
+
+	const opts = _parseOptions(options);
+	if (opts.codec === 'base64') {
+		return base64ToUtf8(text);
+	}
+	if (opts.codec === 'xor') {
+		return xorDeobfuscate(text, opts.key);
+	}
+	return text.replace(/[a-zA-Z0-9]/g, (c) => rotChar(c, -opts.shift));
+}

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

@@ -1,5 +1,7 @@
 # ln-options
 
+> Applied to a `<select data-ln-options="storeName" data-ln-options-value="id" data-ln-options-label="name">` element inside a coordinator subtree. It emits `ln-options:request-data` on initialization and listens for `ln-options:set-data` to populate `<option>` elements while preserving the placeholder and restoring previous selection. It never accesses IndexedDB or network endpoints directly, leaving data resolution entirely to `ln-data-coordinator`.
+
 Populates a `<select>` element with records from an `ln-data-store` via the `ln-data-coordinator` binder. Opt-in: add `data-ln-options="<storeName>"` to any `<select>` inside (or reachable by) a coordinator subtree.
 
 No `<template>` needed — ln-options writes `<option>` elements directly (value + label only).
@@ -55,7 +57,7 @@ The placeholder `<option value="">` is preserved across refreshes. The previous
 
 ## 🔧 Internals
 
-Source: `js/ln-options/src/ln-options.js`. Pure event client — never imports or reads `ln-data-store` directly.
+Source: `components/ln-options/src/ln-options.js`. Pure event client — never imports or reads `ln-data-store` directly.
 
 ### Coordinator wiring
 

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

@@ -0,0 +1,13 @@
+@use '../../theme/config/mixins' as *;
+
+[data-ln-debug] {
+	// 1. Host Element Check: data-ln-options belongs only on <select>
+	[data-ln-options]:not(select) {
+		@include dev-inline-error("data-ln-options belongs only on <select> elements");
+	}
+
+	// 2. Store Name Check: source store name cannot be empty
+	[data-ln-options=""] {
+		@include dev-inline-error("data-ln-options store name cannot be empty");
+	}
+}

package/components/ln-options/ln-options.js

@@ -0,0 +1 @@
+(function(){"use strict";function D(){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 m(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 r=null;for(let o=1;o<t.length;o++)if(t[o]&&t[o].nodeType===1){r=t[o];break}if(!m(r))return}e.apply(console,t)}}function $(e,t,n){const r=n||{};window.lnCore._debugSink&&window.lnCore._debugSink("event",t,e,r),e.dispatchEvent(new CustomEvent(t,{bubbles:!0,detail:r}))}function C(e,t){if(!document.body){document.addEventListener("DOMContentLoaded",function(){C(e,t)}),console.warn("["+t+'] Script loaded before <body> — add "defer" to your <script> tag');return}e()}const F={};function V(e,t){F[e]=t}function H(e){return F[e]||{ingress:t=>t,egress:t=>t}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerDataMapper=V,window.lnCore.getDataMapper=H);function U(){typeof window>"u"||(window.lnCore=window.lnCore||{},!window.lnCore._localeObserverBound&&(window.lnCore._localeObserverBound=!0,C(function(){new MutationObserver(function(){$(document,"ln-core:locale-change",{})}).observe(document.documentElement,{attributes:!0,attributeFilter:["lang"],subtree:!0})},"ln-core")))}const T={};function Q(e,t){if(!e||typeof t!="object")return;const n=e.toLowerCase().split("-")[0];T[n]=t}function J(e){if(!e)return null;const t=e.toLowerCase().split("-")[0];return T[t]||null}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerLocaleFallback=Q,window.lnCore.getLocaleFallback=J,window.lnCore.ensureLocaleObserver=U);const A={};function K(e,t){A[e]||(A[e]=document.querySelector('[data-ln-template="'+e+'"]'));const n=A[e];return n?n.content.cloneNode(!0):(console.warn("["+(t||"ln-core")+'] Template "'+e+'" not found'),null)}function I(e,t){if(!e||!t)return e;const n=e.querySelectorAll("[data-ln-field]");for(let l=0;l<n.length;l++){const a=n[l],s=a.getAttribute("data-ln-field");t[s]!=null&&(a.textContent=t[s])}const r=e.querySelectorAll("[data-ln-attr]");for(let l=0;l<r.length;l++){const a=r[l],s=a.getAttribute("data-ln-attr").split(",");for(let c=0;c<s.length;c++){const d=s[c].trim().split(":");if(d.length!==2)continue;const u=d[0].trim(),f=d[1].trim();t[f]!=null&&a.setAttribute(u,t[f])}}const o=e.querySelectorAll("[data-ln-show]");for(let l=0;l<o.length;l++){const a=o[l],s=a.getAttribute("data-ln-show");s in t&&a.classList.toggle("hidden",!t[s])}const i=e.querySelectorAll("[data-ln-class]");for(let l=0;l<i.length;l++){const a=i[l],s=a.getAttribute("data-ln-class").split(",");for(let c=0;c<s.length;c++){const d=s[c].trim().split(":");if(d.length!==2)continue;const u=d[0].trim(),f=d[1].trim();f in t&&a.classList.toggle(u,!!t[f])}}return e}function P(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 r=0;r<n.length;r++)window.lnCore._debugSink&&window.lnCore._debugSink("event","ln-fill",n[r],t??null),n[r].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)I(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 q(e,t){if(!e||!t)return e;const n=document.createTreeWalker(e,NodeFilter.SHOW_TEXT);for(;n.nextNode();){const i=n.currentNode;i.textContent.indexOf("{{")!==-1&&(i.textContent=i.textContent.replace(/\{\{\s*(\w+)\s*\}\}/g,function(l,a){return t[a]!==void 0?t[a]:""}))}const r=function(i,l){return t[l]!==void 0?t[l]:""},o=Array.from(e.querySelectorAll("*"));e.nodeType===1&&o.push(e);for(let i=0;i<o.length;i++){const l=o[i],a=l.attributes;for(let s=0;s<a.length;s++){const c=a[s];c.value.indexOf("{{")!==-1&&l.setAttribute(c.name,c.value.replace(/\{\{\s*(\w+)\s*\}\}/g,r))}}return e}function G(e,t,n,r,o,i){const l={};for(let s=0;s<e.children.length;s++){const c=e.children[s],d=c.getAttribute("data-ln-render-key");d&&(l[d]=c)}const a=document.createDocumentFragment();for(let s=0;s<t.length;s++){const c=t[s],d=String(r(c));let u=l[d];if(u)o(u,c,s);else{const f=K(n,i);if(!f||(q(f,c),u=f.firstElementChild,!u))continue;u.setAttribute("data-ln-render-key",d),o(u,c,s)}a.appendChild(u)}e.textContent="",e.appendChild(a)}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.fillTemplate=q,window.lnCore.fill=I,window.lnCore.lnFill=P,window.lnCore.renderList=G);function b(e,t,n){const r=e.getAttribute(t);return r===null?n:r}function X(e,t,n){const r=parseInt(e.getAttribute(t),10);return isNaN(r)?n:r}function z(e,t,n=!1){const r=e.getAttribute(t);if(r===null)return!!n;const o=r.trim().toLowerCase();return!(o==="false"||o==="0")}function Y(e,t){return(e.getAttribute(t)||"").split(",").map(n=>n.trim()).filter(Boolean)}const _=new Map;function Z(e,t){const n=(e?e.join("|"):"")+"::"+t;if(_.has(n))return _.get(n);const r=new Set(e||[]),o=function(i,l){const a=i.getAttribute(l);return a!==null&&r.has(a)?a:t};return _.set(n,o),o}function ee(e,t,n){const r=parseFloat(e.getAttribute(t));return isNaN(r)?n:r}function te(e,t,n){const r=e.getAttribute(t);if(!r)return n;try{return JSON.parse(r)}catch{return n}}function N(e,t,n,r,o){if(!e||t===null)return!0;const i=r||"ln-component",l=e.type;if(l==="trigger"||l==="marker"||l==="string"||l==="list"||!l||t===""&&e.fallback!==void 0)return!0;const a=s=>{o?console.warn(s,o):console.warn(s)};if(l==="boolean"){const s=t.trim().toLowerCase();return s!==""&&s!=="true"&&s!=="false"&&s!=="1"&&s!=="0"?(a(`[${i}] Invalid value "${t}" for boolean attribute "${n}". Allowed: "true", "false", or presence-only.`),!1):!0}if(l==="enum"){const s=e.values||[];return s.includes(t)?!0:(a(`[${i}] Invalid value "${t}" for attribute "${n}". Allowed: ${s.join(", ")}. Fallback: "${e.fallback}".`),!1)}if(l==="integer"){if(!/^-?\d+$/.test(t))return a(`[${i}] Invalid integer "${t}" for attribute "${n}". Fallback: ${e.fallback}.`),!1;const s=parseInt(t,10);return e.min!==void 0&&s<e.min?(a(`[${i}] Value ${s} for attribute "${n}" is less than min (${e.min}).`),!1):e.max!==void 0&&s>e.max?(a(`[${i}] Value ${s} for attribute "${n}" is greater than max (${e.max}).`),!1):!0}if(l==="float")return isNaN(Number(t))?(a(`[${i}] Invalid float "${t}" for attribute "${n}". Fallback: ${e.fallback}.`),!1):!0;if(l==="json")try{return JSON.parse(t),!0}catch(s){return a(`[${i}] Invalid JSON for attribute "${n}": ${s.message}. Fallback: ${e.fallback}.`),!1}return!0}function ne(e,t,n){for(const r in n){const[o,i,l]=n[r];Object.defineProperty(e,r,{get:function(){return o(t,i,l)},enumerable:!0,configurable:!0})}return e}function re(e){const t={};for(const n in e){const r=e[n];if(!r||!r.prop)continue;let o=r.read;if(!o&&r.type)switch(r.type){case"enum":o=Z(r.values,r.fallback);break;case"integer":o=X;break;case"float":o=ee;break;case"boolean":o=z;break;case"list":o=Y;break;case"json":o=te;break;case"string":default:o=b;break}o||(o=b),t[r.prop]=[o,n,r.fallback]}return t}function oe(e){const t={};for(const n in e){const r=e[n];r&&r.effect&&(t[n]=r.effect)}return Object.keys(t).length?t:null}function ie(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 v(e,t,n,r){if(e.nodeType!==1)return;const i=t.indexOf("[")!==-1||t.indexOf(".")!==-1||t.indexOf("#")!==-1?t:"["+t+"]",l=Array.from(e.querySelectorAll(i));e.matches&&e.matches(i)&&l.push(e);for(const a of l)if(!a[n]){window.lnCore._persistSink&&a.hasAttribute("data-ln-persist")&&window.lnCore._persistSink(a,t);try{a[n]=new r(a)}catch(s){console.error("["+n+"] init failed",a,s)}}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore._bootHolds=window.lnCore._bootHolds||0,window.lnCore._bootQueue=window.lnCore._bootQueue||[]);function le(){return typeof window<"u"&&window.lnCore&&window.lnCore._bootHolds||0}function se(e){typeof window<"u"?(window.lnCore=window.lnCore||{},window.lnCore._bootHolds=window.lnCore._bootHolds||0,window.lnCore._bootQueue=window.lnCore._bootQueue||[],window.lnCore._bootHolds>0?window.lnCore._bootQueue.push(e):setTimeout(e,0)):e()}function R(){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 ae(e){const t=R(),n=e.observed||[];for(let r=0;r<n.length;r++){const o=n[r];t.byAttr.has(o)||t.byAttr.set(o,[]),t.byAttr.get(o).push(e)}if(t.byDeclaredAttr=t.byDeclaredAttr||new Map,e.attributes)for(const r in e.attributes){t.byDeclaredAttr.has(r)||t.byDeclaredAttr.set(r,[]);const o=t.byDeclaredAttr.get(r);o.some(i=>i.componentTag===e.componentTag)||o.push({spec:e.attributes[r],componentTag:e.componentTag})}if(e.onAttrChange||e.effects){t.reactive.push(e);const r=ie(e);if(r===null)t.reactiveWildcard.push(e);else for(const o of r)t.byReactive.has(o)||t.byReactive.set(o,[]),t.byReactive.get(o).push(e)}e.persist&&t.persist.push(e)}function M(e,t,n,r){for(let o=0;o<e.length;o++){const i=e[o];if(!t[i.attribute])continue;const l=i.effects&&i.effects[n];l?l(t,n,r):i.onAttrChange&&(!i.declared||i.declared.has(n))&&i.onAttrChange(t,n,r)}}function ce(e){const t=e.target,n=e.attributeName;if(e.oldValue===t.getAttribute(n))return;const r=R(),o=r.byAttr.get(n);if(D()&&r.byDeclaredAttr&&r.byDeclaredAttr.has(n)&&m(t)){const i=r.byDeclaredAttr.get(n),l=t.getAttribute(n);for(let a=0;a<i.length;a++)N(i[a].spec,l,n,i[a].componentTag,t)}if(window.lnCore._debugSink&&(n.indexOf("data-ln-")===0||o)&&window.lnCore._debugSink("attr",n,t,{oldValue:e.oldValue,newValue:t.getAttribute(n)}),n.indexOf("data-ln-")===0){const i=r.byReactive.get(n);i&&M(i,t,n,e.oldValue),r.reactiveWildcard.length&&M(r.reactiveWildcard,t,n,e.oldValue)}if(o)for(let i=0;i<o.length;i++){const l=o[i];if(l.handler){l.handler(t,n,e.oldValue);continue}l.onAttributeChange&&t[l.attribute]?l.onAttributeChange(t,n):(v(t,l.selector,l.attribute,l.ComponentFn),l.onInit&&l.onInit(t))}}function ue(){window.lnCore=window.lnCore||{},!window.lnCore._attrObserverBound&&(window.lnCore._attrObserverBound=!0,C(function(){new MutationObserver(function(t){for(let n=0;n<t.length;n++)try{ce(t[n])}catch(r){console.error("[ln-core] mutation handler failed",t[n].target,r)}}).observe(document.body,{attributes:!0,subtree:!0,attributeOldValue:!0})},"ln-core"))}function B(){return window.lnCore=window.lnCore||{},window.lnCore._lifecycleRegistry=window.lnCore._lifecycleRegistry||[]}function de(e){const t=B();if(t.length){if(e.target)for(let n=0;n<t.length;n++){const r=t[n];if(r.onSubtreeChange){const o=r.query,i=e.target.nodeType===1?e.target.matches(o)?e.target:e.target.closest(o):e.target.parentElement?e.target.parentElement.closest(o):null;i&&r.onSubtreeChange(i,e)}}for(let n=0;n<e.addedNodes.length;n++){const r=e.addedNodes[n];if(r.nodeType===1)for(let o=0;o<t.length;o++){const i=t[o];v(r,i.selector,i.attribute,i.ComponentFn),i.onInit&&i.onInit(r)}}for(let n=0;n<e.removedNodes.length;n++){const r=e.removedNodes[n];if(r.nodeType===1)for(let o=0;o<t.length;o++){const i=t[o],l=i.query,a=Array.from(r.querySelectorAll(l));r.matches&&r.matches(l)&&a.push(r);for(let s=0;s<a.length;s++){const c=a[s];if(!document.contains(c)){const d=c[i.attribute];if(d&&typeof d.destroy=="function")try{d.destroy()}catch(u){console.error("["+i.attribute+"] destroy failed",c,u)}delete c[i.attribute]}}}}}}function fe(){window.lnCore=window.lnCore||{},!window.lnCore._lifecycleObserverBound&&(window.lnCore._lifecycleObserverBound=!0,C(function(){new MutationObserver(function(t){for(let n=0;n<t.length;n++){const r=t[n];if(r.type==="childList")try{de(r)}catch(o){console.error("[ln-core] lifecycle handler failed",r.target,o)}}}).observe(document.body,{childList:!0,subtree:!0})},"ln-core"))}function we(e,t,n,r,o={}){const i=o.extraAttributes||[],l=o.onAttributeChange||null,a=o.onSubtreeChange||null,s=o.onInit||null,c=o.onAttrChange||null,d=o.effects||null,u=o.attributes||null,f=u?oe(u):d,h=u?new Set(Object.keys(u)):null,p=o.persist||null;function y(O){const w=O||document.body;if(v(w,e,t,n),u&&D())for(const g in u){const ve=u[g],x=Array.from(w.querySelectorAll("["+g+"]"));w.matches&&w.matches("["+g+"]")&&x.push(w);for(let E=0;E<x.length;E++){const L=x[E];m(L)&&N(ve,L.getAttribute(g),g,r,L)}}s&&s(w)}const k=[];if(e.indexOf("[")!==-1){const O=/\[([\w-]+)/g;let w;for(;(w=O.exec(e))!==null;)k.push(w[1])}else k.push(e);ae({selector:e,attribute:t,componentTag:r,attributes:u,ComponentFn:n,onInit:s,observed:k.concat(i),onAttributeChange:l,onAttrChange:c,effects:f,declared:h,persist:p}),ue();const _e=e.indexOf("[")!==-1||e.indexOf(".")!==-1||e.indexOf("#")!==-1?e:"["+e+"]";B().push({selector:e,attribute:t,ComponentFn:n,onInit:s,onSubtreeChange:a,query:_e}),fe(),window[t]=y;function W(){le()>0?se(function(){y(document.body)}):y(document.body)}return document.readyState==="loading"?document.addEventListener("DOMContentLoaded",W):W(),y}function j(e){return(e||"").replace(/^#/,"")}function S(e){const t=e===void 0?location.hash:e,n={},r=j(t);if(!r)return n;const o=r.split("&");for(let i=0;i<o.length;i++){const l=o[i];if(!l)continue;const a=l.indexOf(":"),s=a>-1?l.slice(0,a):l,c=a>-1?l.slice(a+1):"";if(s)try{n[s]=decodeURIComponent(c)}catch{n[s]=c}}return n}function be(e){if(!e)return null;const t=S();return e in t?t[e]:null}function he(e,t){if(!e)return;const n=S();t==null?delete n[e]:n[e]=String(t);const o=Object.keys(n).map(function(i){const l=n[i];return l===""?i:i+":"+encodeURIComponent(l)}).join("&");j(location.hash)!==o&&(location.hash=o)}function pe(e){return e.button===1||e.ctrlKey||e.metaKey||e.shiftKey?!1:(e.preventDefault(),!0)}function ge(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 r=e.getAttribute("data-ln-sort")||e.getAttribute("data-ln-search-for")||e.getAttribute("data-ln-search")||e.getAttribute("data-ln-filter")||e.id;return r?t?r+"-"+t:r:t||null}function Ce(e,t){return!t||t==="none"||e===null||e===void 0?null:String(e)+"."+t}function ye(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 me(e,t){return!e||!Array.isArray(t)||t.length===0?null:e+":"+t.map(encodeURIComponent).join(",")}function Ae(e){if(!e||typeof e!="string")return null;const t=e.indexOf(":");if(t===-1)return null;const n=e.slice(0,t),r=e.slice(t+1),o=r?r.split(",").map(function(i){try{return decodeURIComponent(i)}catch{return i}}).filter(Boolean):[];return{key:n,values:o}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.hashParse=S,window.lnCore.hashGet=be,window.lnCore.hashSet=he,window.lnCore.hashLinkClick=pe,window.lnCore.resolveHashNamespace=ge,window.lnCore.hashSortEncode=Ce,window.lnCore.hashSortDecode=ye,window.lnCore.hashFilterEncode=me,window.lnCore.hashFilterDecode=Ae),(function(){const e="data-ln-options",t="lnOptions";if(window[t]!==void 0)return;const n={"data-ln-options":{prop:"_storeName",type:"string",read:b,fallback:"",description:"Store or coordinator addressing to populate options from"},"data-ln-options-value":{prop:"_valueField",type:"string",read:b,fallback:"id",description:"Field name used for option value attribute"},"data-ln-options-label":{prop:"_labelField",type:"string",read:b,fallback:"name",description:"Field name used for option visible label text"}},r=re(n);function o(i){this.dom=i,ne(this,i,r);const l=this;return this._onSetData=function(a){l._rebuild(a.detail.data||[])},i.addEventListener("ln-options:set-data",this._onSetData),$(i,"ln-options:request-data",{options:this._storeName}),this}o.prototype._rebuild=function(i){const l=this.dom,a=this._valueField,s=this._labelField,c=l.value,d=l.querySelectorAll("option");for(let f=d.length-1;f>=0;f--)d[f].value!==""&&l.removeChild(d[f]);for(let f=0;f<i.length;f++){const h=i[f],p=document.createElement("option");p.value=String(h[a]),p.textContent=h[s]!=null?h[s]:"",l.appendChild(p)}const u=l.options;for(let f=0;f<u.length;f++)if(u[f].value===c){l.value=c;break}},o.prototype.destroy=function(){this.dom[t]&&(this.dom.removeEventListener("ln-options:set-data",this._onSetData),delete this.dom[t])},we(e,t,o,"ln-options",{attributes:n})})()})();

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

@@ -0,0 +1,41 @@
+{
+	"$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-options",
+	"generator": "scripts/sync-ln-schemas.mjs",
+	"attributes": {
+		"data-ln-debug": {
+			"direction": null,
+			"sources": [
+				"ln-options-dev.scss"
+			]
+		},
+		"data-ln-options": {
+			"direction": null,
+			"sources": [
+				"ln-options-dev.scss",
+				"src/ln-options.js"
+			],
+			"type": "string",
+			"fallback": "",
+			"description": "Store or coordinator addressing to populate options from"
+		},
+		"data-ln-options-label": {
+			"direction": null,
+			"sources": [
+				"src/ln-options.js"
+			],
+			"type": "string",
+			"fallback": "name",
+			"description": "Field name used for option visible label text"
+		},
+		"data-ln-options-value": {
+			"direction": null,
+			"sources": [
+				"src/ln-options.js"
+			],
+			"type": "string",
+			"fallback": "id",
+			"description": "Field name used for option value attribute"
+		}
+	}
+}

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

@@ -1,4 +1,4 @@
-import { registerComponent, dispatch } from '../../ln-core';
+import { registerComponent, dispatch, defineAttrs, attrSpec, attrStr } from '../../ln-core';
 
 (function () {
 	const DOM_SELECTOR = 'data-ln-options';
@@ -6,13 +6,19 @@ import { registerComponent, dispatch } from '../../ln-core';
 
 	if (window[DOM_ATTRIBUTE] !== undefined) return;
 
+	// ─── Attribute Contract (SSOT) ──────────────────────────
+	const ATTRIBUTES = {
+		'data-ln-options':       { prop: '_storeName', type: 'string', read: attrStr, fallback: '', description: 'Store or coordinator addressing to populate options from' },
+		'data-ln-options-value': { prop: '_valueField', type: 'string', read: attrStr, fallback: 'id', description: 'Field name used for option value attribute' },
+		'data-ln-options-label': { prop: '_labelField', type: 'string', read: attrStr, fallback: 'name', description: 'Field name used for option visible label text' }
+	};
+	const ATTR_SPEC = attrSpec(ATTRIBUTES);
+
 	// ─── Component ─────────────────────────────────────────────
 
 	function _component(dom) {
 		this.dom = dom;
-		this._storeName = dom.getAttribute(DOM_SELECTOR);
-		this._valueField = dom.getAttribute('data-ln-options-value') || 'id';
-		this._labelField = dom.getAttribute('data-ln-options-label') || 'name';
+		defineAttrs(this, dom, ATTR_SPEC);
 
 		const self = this;
 
@@ -70,5 +76,7 @@ import { registerComponent, dispatch } from '../../ln-core';
 
 	// ─── Init ──────────────────────────────────────────────────
 
-	registerComponent(DOM_SELECTOR, DOM_ATTRIBUTE, _component, 'ln-options');
+	registerComponent(DOM_SELECTOR, DOM_ATTRIBUTE, _component, 'ln-options', {
+		attributes: ATTRIBUTES
+	});
 })();