@livenetworks/ashlar 1.6.0 → 2.0.0

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

@@ -1,4 +1,4 @@
-import { cloneTemplate, dispatch, dispatchCancelable, registerComponent } from '../../ln-core';
+import { cloneTemplate, dispatch, dispatchCancelable, registerComponent, defineAttrs, attrSpec, attrStr } from '../../ln-core';
 
 (function () {
 	const DOM_SELECTOR = 'data-ln-translations';
@@ -6,6 +6,22 @@ import { cloneTemplate, dispatch, dispatchCancelable, registerComponent } from '
 
 	if (window[DOM_ATTRIBUTE] !== undefined) return;
 
+	// ─── Attribute Contract (SSOT) ──────────────────────────
+	const ATTRIBUTES = {
+		'data-ln-translations':              { type: 'marker', description: 'Mounts multi-language translation manager on form container' },
+		'data-ln-translations-default':      { prop: 'defaultLang', read: attrStr, type: 'string', fallback: '', description: 'Default primary language code (e.g. en)' },
+		'data-ln-translations-placeholder':  { prop: 'placeholderLabel', read: attrStr, type: 'string', fallback: '{lang} translation', description: 'Placeholder label pattern for cloned translation inputs' },
+		'data-ln-translations-remove-label': { prop: 'removeLabel', read: attrStr, type: 'string', fallback: 'Remove {lang}', description: 'Accessible label template for translation removal buttons' },
+		'data-ln-translations-locales':      { prop: '_localesRaw', read: attrStr, type: 'json', fallback: '', description: 'JSON dictionary of supported locale codes and display labels' },
+		'data-ln-translations-active':        { type: 'marker', description: 'Container holding active language badge tags' },
+		'data-ln-translations-add':           { type: 'string', description: 'Trigger button action to add specified language translation fields' },
+		'data-ln-translations-lang':          { type: 'string', description: 'Language code associated with active language badge' },
+		'data-ln-translations-prefix':        { type: 'string', description: 'Prefix format pattern for cloned translated field names' },
+		'data-ln-translatable':              { type: 'marker', description: 'Marks form control as translatable into multiple languages' },
+		'data-ln-translatable-lang':         { type: 'string', description: 'Language code assigned to specific translatable input instance' }
+	};
+	const ATTR_SPEC = attrSpec(ATTRIBUTES);
+
 	// ─── Default locales (override via data-ln-translations-locales JSON) ──
 
 	const DEFAULT_LOCALES = {
@@ -18,18 +34,15 @@ import { cloneTemplate, dispatch, dispatchCancelable, registerComponent } from '
 
 	function _component(dom) {
 		this.dom = dom;
+		defineAttrs(this, dom, ATTR_SPEC);
 		this.activeLanguages = new Set();
-		this.defaultLang = dom.getAttribute(DOM_SELECTOR + '-default') || '';
-		this.placeholderLabel = dom.getAttribute(DOM_SELECTOR + '-placeholder') || '{lang} translation';
-		this.removeLabel = dom.getAttribute(DOM_SELECTOR + '-remove-label') || 'Remove {lang}';
-		this.badgesEl = dom.querySelector('[' + DOM_SELECTOR + '-active]');
+		this.badgesEl = dom.querySelector('[data-ln-translations-active]');
 		this.menuEl = dom.querySelector('[data-ln-dropdown] > [data-ln-toggle]');
 
 		// Parse locales from attribute or use defaults
-		const localesAttr = dom.getAttribute(DOM_SELECTOR + '-locales');
 		this.locales = DEFAULT_LOCALES;
-		if (localesAttr) {
-			try { this.locales = JSON.parse(localesAttr); }
+		if (this._localesRaw) {
+			try { this.locales = JSON.parse(this._localesRaw); }
 			catch (e) { console.warn('[ln-translations] Invalid JSON in data-ln-translations-locales'); }
 		}
 
@@ -121,7 +134,7 @@ import { cloneTemplate, dispatch, dispatchCancelable, registerComponent } from '
 		}
 
 		// Hide trigger if no languages available
-		const triggerBtn = this.dom.querySelector('[' + DOM_SELECTOR + '-add]');
+		const triggerBtn = this.dom.querySelector('[data-ln-translations-add]');
 		if (triggerBtn) {
 			triggerBtn.hidden = availableCount === 0;
 		}
@@ -276,5 +289,7 @@ import { cloneTemplate, dispatch, dispatchCancelable, registerComponent } from '
 
 	// ─── Init ──────────────────────────────────────────────────
 
-	registerComponent(DOM_SELECTOR, DOM_ATTRIBUTE, _component, 'ln-translations');
+	registerComponent(DOM_SELECTOR, DOM_ATTRIBUTE, _component, 'ln-translations', {
+		attributes: ATTRIBUTES
+	});
 })();

package/components/ln-ui-coordinator/README.md

@@ -0,0 +1,101 @@
+# ln-ui-coordinator
+
+> Applied to a container element (`<main data-ln-ui-coordinator>`). It listens for clicks on `[data-ln-modal-for]` triggers and `a[href^="#"]` anchors to open `[data-ln-modal]` dialogs and synchronize the URL hash, intercepts bubbling `ln-ajax:success`/`ln-ajax:error` and `ln-upload:error` events to dispatch `ln-toast:enqueue` notifications, and extracts `data-ln-fill-*` attributes to dispatch `ln-fill:request`. It never inspects internal form validation states, keeping forms and dialogs strictly encapsulated.
+
+A general-purpose **Layer 2 Coordinator** that mediates UI triggers, modals (`ln-modal`), AJAX (`ln-ajax`), uploads (`ln-upload`), record filling (`ln-fill`), and toast notifications (`ln-toast`).
+
+---
+
+## 1. Responsibilities
+
+1. **Modal Triggers & Hash Navigation:** Listens for clicks on `[data-ln-modal-for]` triggers and `a[href^="#"]` hash anchors, synchronizing the active modal state with the URL hash and handling `new` / `edit` modes.
+2. **Dynamic Form & Record Population:** Bridges trigger payloads (`data-ln-fill-*`) and emits `ln-fill:request` on modal open.
+3. **AJAX Submit Mediation:** Catches `ln-ajax:success` events:
+   - Dispatches `ln-toast:enqueue` notifications when the server returns `{ message: { body, title?, type? } }` (where `body` is required).
+   - Closes the active modal (if submit originated inside a modal), cleans URL hash, and resets the form.
+4. **Error Feedback & Resilience:** Catches `ln-ajax:error`:
+   - Dispatches error toasts on server error envelopes or network failures (with fallback support via `data-ln-ui-coordinator-dict`).
+   - Climbs parent coordinator containers to inherit and merge dictionary translations hierarchically.
+   - Keeps modals open on error so form validation messages remain visible.
+5. **Upload Feedback Mediation:** Catches `ln-upload:invalid` and `ln-upload:error`:
+   - Dispatches error toasts with translated messages (`upload-invalid-title`, `upload-invalid-type`, `upload-max-size`, `upload-max-files`, `upload-error-title`, `upload-failed`).
+
+---
+
+## 2. HTML Markup
+
+```html
+<!-- Wrapper container or dialog with localized fallback messages -->
+<main data-ln-ui-coordinator>
+    <ul hidden>
+        <li data-ln-ui-coordinator-dict="network-error">Network connection failed.</li>
+        <li data-ln-ui-coordinator-dict="network-error-title">Connection Error</li>
+        <li data-ln-ui-coordinator-dict="server-error">The server encountered an error.</li>
+        <li data-ln-ui-coordinator-dict="server-error-title">Server Error</li>
+        <li data-ln-ui-coordinator-dict="upload-invalid-title">Invalid File</li>
+        <li data-ln-ui-coordinator-dict="upload-invalid-type">This file type is not allowed.</li>
+        <li data-ln-ui-coordinator-dict="upload-max-size">File size exceeds maximum allowed limit.</li>
+        <li data-ln-ui-coordinator-dict="upload-max-files">Maximum number of uploaded files exceeded.</li>
+        <li data-ln-ui-coordinator-dict="upload-error-title">Upload Error</li>
+        <li data-ln-ui-coordinator-dict="upload-failed">Failed to upload file.</li>
+    </ul>
+
+    <!-- Triggers -->
+    <button type="button" data-ln-modal-for="user-modal">New User</button>
+    <a href="#user-modal:42" data-ln-fill-id="42" data-ln-fill-name="Ada Lovelace">Edit #42</a>
+
+    <!-- Modal Dialog -->
+    <dialog class="ln-modal" data-ln-modal id="user-modal">
+        <form action="/api/users" method="POST" data-ln-ajax id="user-form">
+            <input type="text" name="name" required />
+            <button type="submit">Save</button>
+            <button type="button" data-ln-modal-close>Cancel</button>
+        </form>
+    </dialog>
+</main>
+```
+
+---
+
+## 3. Declarative Attributes
+
+| Attribute | Element | Description |
+|:---|:---|:---|
+| `data-ln-ui-coordinator` | Container / Dialog | Activates UI orchestration on the element and its subtree, acting as dictionary host. |
+| `data-ln-ui-coordinator-dict` | `<li>` element | Translatable fallback toast messages (see Dictionary Keys below). |
+| `data-ln-modal-for="id"` | Trigger `<button>` | Opens the target `ln-modal` by id. |
+| `data-ln-modal-mode="new\|edit"` | Trigger / `<dialog>` | Forces explicit modal creation or edit mode. |
+| `data-ln-fill-*` | Trigger `<a>` | Passes record values to form controls inside the opened modal. |
+
+### Dictionary Keys
+
+| Key | Used For | Fallback |
+|:---|:---|:---|
+| `network-error` | Network disconnection error message | `Network error` |
+| `network-error-title` | Network error toast title | `""` |
+| `server-error` | HTTP server error message | `Server error` |
+| `server-error-title` | HTTP server error toast title | `""` |
+| `upload-invalid-title` | Invalid file toast title | `Invalid File` |
+| `upload-invalid-type` | Invalid file extension / MIME message | `This file type is not allowed` |
+| `upload-max-size` | Exceeded max size message | `File is too large` |
+| `upload-max-files` | Exceeded max file count message | `Maximum file count exceeded` |
+| `upload-error-title` | Upload failure toast title | `Upload Error` |
+| `upload-failed` | Upload failure message | `Failed to upload file` |
+
+---
+
+## 4. DOM Events
+
+| Event | Direction | Target | Description |
+|:---|:---|:---|:---|
+| `ln-modal:request-open` | Emits | `<dialog>` | Requests panel opening on target `ln-modal`. |
+| `ln-modal:request-close` | Emits | `<dialog>` | Requests panel closing on target `ln-modal`. |
+| `ln-fill:request` | Emits | `<dialog>` | Requests form data population for the opened modal. |
+| `ln-toast:enqueue` | Emits | `window` | Dispatched with `{ type, title, message }` on AJAX responses or error fallbacks. |
+| `click` | Listens | `document` | Intercepts modal triggers and hash links. |
+| `submit` | Listens | `document` | Tracks native submissions in modals for clean hash/reload lifecycle. |
+| `hashchange` | Listens | `window` | Synchronizes URL hash and active modals. |
+| `ln-ajax:success` | Listens | `document` | Enqueues success toast, closes modal, and resets forms. |
+| `ln-ajax:error` | Listens | `document` | Enqueues error toast while keeping modals open. |
+| `ln-upload:invalid` | Listens | `document` | Enqueues error toast on file validation failure. |
+| `ln-upload:error` | Listens | `document` | Enqueues error toast on upload failure. |

package/components/ln-ui-coordinator/ln-ui-coordinator-dev.scss

@@ -0,0 +1,8 @@
+@use '../../theme/config/mixins' as *;
+
+[data-ln-debug] {
+	// Dev diagnostics for ln-ui-coordinator
+	[data-ln-ui-coordinator] {
+		// Valid anywhere (dialog, section, main, body, container)
+	}
+}

package/components/ln-ui-coordinator/ln-ui-coordinator.js

@@ -0,0 +1 @@
+(function(){"use strict";function j(){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 L(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 o=null;for(let r=1;r<t.length;r++)if(t[r]&&t[r].nodeType===1){o=t[r];break}if(!L(o))return}e.apply(console,t)}}function m(e,t,n){const o=n||{};window.lnCore._debugSink&&window.lnCore._debugSink("event",t,e,o),e.dispatchEvent(new CustomEvent(t,{bubbles:!0,detail:o}))}function x(e,t){if(!document.body){document.addEventListener("DOMContentLoaded",function(){x(e,t)}),console.warn("["+t+'] Script loaded before <body> — add "defer" to your <script> tag');return}e()}const B={};function J(e,t){B[e]=t}function P(e){return B[e]||{ingress:t=>t,egress:t=>t}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerDataMapper=J,window.lnCore.getDataMapper=P);function X(){typeof window>"u"||(window.lnCore=window.lnCore||{},!window.lnCore._localeObserverBound&&(window.lnCore._localeObserverBound=!0,x(function(){new MutationObserver(function(){m(document,"ln-core:locale-change",{})}).observe(document.documentElement,{attributes:!0,attributeFilter:["lang"],subtree:!0})},"ln-core")))}const W={};function Y(e,t){if(!e||typeof t!="object")return;const n=e.toLowerCase().split("-")[0];W[n]=t}function Z(e){if(!e)return null;const t=e.toLowerCase().split("-")[0];return W[t]||null}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerLocaleFallback=Y,window.lnCore.getLocaleFallback=Z,window.lnCore.ensureLocaleObserver=X);const D={};function ee(e,t){D[e]||(D[e]=document.querySelector('[data-ln-template="'+e+'"]'));const n=D[e];return n?n.content.cloneNode(!0):(console.warn("["+(t||"ln-core")+'] Template "'+e+'" not found'),null)}function N(e,t){if(!e||!t)return e;const n=e.querySelectorAll("[data-ln-field]");for(let l=0;l<n.length;l++){const u=n[l],d=u.getAttribute("data-ln-field");t[d]!=null&&(u.textContent=t[d])}const o=e.querySelectorAll("[data-ln-attr]");for(let l=0;l<o.length;l++){const u=o[l],d=u.getAttribute("data-ln-attr").split(",");for(let h=0;h<d.length;h++){const g=d[h].trim().split(":");if(g.length!==2)continue;const b=g[0].trim(),C=g[1].trim();t[C]!=null&&u.setAttribute(b,t[C])}}const r=e.querySelectorAll("[data-ln-show]");for(let l=0;l<r.length;l++){const u=r[l],d=u.getAttribute("data-ln-show");d in t&&u.classList.toggle("hidden",!t[d])}const i=e.querySelectorAll("[data-ln-class]");for(let l=0;l<i.length;l++){const u=i[l],d=u.getAttribute("data-ln-class").split(",");for(let h=0;h<d.length;h++){const g=d[h].trim().split(":");if(g.length!==2)continue;const b=g[0].trim(),C=g[1].trim();C in t&&u.classList.toggle(b,!!t[C])}}return e}function te(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 o=0;o<n.length;o++)window.lnCore._debugSink&&window.lnCore._debugSink("event","ln-fill",n[o],t??null),n[o].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)N(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 U(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,u){return t[u]!==void 0?t[u]:""}))}const o=function(i,l){return t[l]!==void 0?t[l]:""},r=Array.from(e.querySelectorAll("*"));e.nodeType===1&&r.push(e);for(let i=0;i<r.length;i++){const l=r[i],u=l.attributes;for(let d=0;d<u.length;d++){const h=u[d];h.value.indexOf("{{")!==-1&&l.setAttribute(h.name,h.value.replace(/\{\{\s*(\w+)\s*\}\}/g,o))}}return e}function ne(e,t,n,o,r,i){const l={};for(let d=0;d<e.children.length;d++){const h=e.children[d],g=h.getAttribute("data-ln-render-key");g&&(l[g]=h)}const u=document.createDocumentFragment();for(let d=0;d<t.length;d++){const h=t[d],g=String(o(h));let b=l[g];if(b)r(b,h,d);else{const C=ee(n,i);if(!C||(U(C,h),b=C.firstElementChild,!b))continue;b.setAttribute("data-ln-render-key",g),r(b,h,d)}u.appendChild(b)}e.textContent="",e.appendChild(u)}function oe(e,t){const n={},o=e.querySelectorAll("["+t+"]");for(let r=0;r<o.length;r++)n[o[r].getAttribute(t)]=o[r].textContent,o[r].remove();return n}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.fillTemplate=U,window.lnCore.fill=N,window.lnCore.lnFill=te,window.lnCore.renderList=ne);function V(e,t,n,o,r){if(!e||t===null)return!0;const i=o||"ln-component",l=e.type;if(l==="trigger"||l==="marker"||l==="string"||l==="list"||!l||t===""&&e.fallback!==void 0)return!0;const u=d=>{r?console.warn(d,r):console.warn(d)};if(l==="boolean"){const d=t.trim().toLowerCase();return d!==""&&d!=="true"&&d!=="false"&&d!=="1"&&d!=="0"?(u(`[${i}] Invalid value "${t}" for boolean attribute "${n}". Allowed: "true", "false", or presence-only.`),!1):!0}if(l==="enum"){const d=e.values||[];return d.includes(t)?!0:(u(`[${i}] Invalid value "${t}" for attribute "${n}". Allowed: ${d.join(", ")}. Fallback: "${e.fallback}".`),!1)}if(l==="integer"){if(!/^-?\d+$/.test(t))return u(`[${i}] Invalid integer "${t}" for attribute "${n}". Fallback: ${e.fallback}.`),!1;const d=parseInt(t,10);return e.min!==void 0&&d<e.min?(u(`[${i}] Value ${d} for attribute "${n}" is less than min (${e.min}).`),!1):e.max!==void 0&&d>e.max?(u(`[${i}] Value ${d} for attribute "${n}" is greater than max (${e.max}).`),!1):!0}if(l==="float")return isNaN(Number(t))?(u(`[${i}] Invalid float "${t}" for attribute "${n}". Fallback: ${e.fallback}.`),!1):!0;if(l==="json")try{return JSON.parse(t),!0}catch(d){return u(`[${i}] Invalid JSON for attribute "${n}": ${d.message}. Fallback: ${e.fallback}.`),!1}return!0}function re(e){const t={};for(const n in e){const o=e[n];o&&o.effect&&(t[n]=o.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 T(e,t,n,o){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 u of l)if(!u[n]){window.lnCore._persistSink&&u.hasAttribute("data-ln-persist")&&window.lnCore._persistSink(u,t);try{u[n]=new o(u)}catch(d){console.error("["+n+"] init failed",u,d)}}}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 $(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 H(){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 se(e){const t=H(),n=e.observed||[];for(let o=0;o<n.length;o++){const r=n[o];t.byAttr.has(r)||t.byAttr.set(r,[]),t.byAttr.get(r).push(e)}if(t.byDeclaredAttr=t.byDeclaredAttr||new Map,e.attributes)for(const o in e.attributes){t.byDeclaredAttr.has(o)||t.byDeclaredAttr.set(o,[]);const r=t.byDeclaredAttr.get(o);r.some(i=>i.componentTag===e.componentTag)||r.push({spec:e.attributes[o],componentTag:e.componentTag})}if(e.onAttrChange||e.effects){t.reactive.push(e);const o=ie(e);if(o===null)t.reactiveWildcard.push(e);else for(const r of o)t.byReactive.has(r)||t.byReactive.set(r,[]),t.byReactive.get(r).push(e)}e.persist&&t.persist.push(e)}function K(e,t,n,o){for(let r=0;r<e.length;r++){const i=e[r];if(!t[i.attribute])continue;const l=i.effects&&i.effects[n];l?l(t,n,o):i.onAttrChange&&(!i.declared||i.declared.has(n))&&i.onAttrChange(t,n,o)}}function de(e){const t=e.target,n=e.attributeName;if(e.oldValue===t.getAttribute(n))return;const o=H(),r=o.byAttr.get(n);if(j()&&o.byDeclaredAttr&&o.byDeclaredAttr.has(n)&&L(t)){const i=o.byDeclaredAttr.get(n),l=t.getAttribute(n);for(let u=0;u<i.length;u++)V(i[u].spec,l,n,i[u].componentTag,t)}if(window.lnCore._debugSink&&(n.indexOf("data-ln-")===0||r)&&window.lnCore._debugSink("attr",n,t,{oldValue:e.oldValue,newValue:t.getAttribute(n)}),n.indexOf("data-ln-")===0){const i=o.byReactive.get(n);i&&K(i,t,n,e.oldValue),o.reactiveWildcard.length&&K(o.reactiveWildcard,t,n,e.oldValue)}if(r)for(let i=0;i<r.length;i++){const l=r[i];if(l.handler){l.handler(t,n,e.oldValue);continue}l.onAttributeChange&&t[l.attribute]?l.onAttributeChange(t,n):(T(t,l.selector,l.attribute,l.ComponentFn),l.onInit&&l.onInit(t))}}function ae(){window.lnCore=window.lnCore||{},!window.lnCore._attrObserverBound&&(window.lnCore._attrObserverBound=!0,x(function(){new MutationObserver(function(t){for(let n=0;n<t.length;n++)try{de(t[n])}catch(o){console.error("[ln-core] mutation handler failed",t[n].target,o)}}).observe(document.body,{attributes:!0,subtree:!0,attributeOldValue:!0})},"ln-core"))}function Q(){return window.lnCore=window.lnCore||{},window.lnCore._lifecycleRegistry=window.lnCore._lifecycleRegistry||[]}function ce(e){const t=Q();if(t.length){if(e.target)for(let n=0;n<t.length;n++){const o=t[n];if(o.onSubtreeChange){const r=o.query,i=e.target.nodeType===1?e.target.matches(r)?e.target:e.target.closest(r):e.target.parentElement?e.target.parentElement.closest(r):null;i&&o.onSubtreeChange(i,e)}}for(let n=0;n<e.addedNodes.length;n++){const o=e.addedNodes[n];if(o.nodeType===1)for(let r=0;r<t.length;r++){const i=t[r];T(o,i.selector,i.attribute,i.ComponentFn),i.onInit&&i.onInit(o)}}for(let n=0;n<e.removedNodes.length;n++){const o=e.removedNodes[n];if(o.nodeType===1)for(let r=0;r<t.length;r++){const i=t[r],l=i.query,u=Array.from(o.querySelectorAll(l));o.matches&&o.matches(l)&&u.push(o);for(let d=0;d<u.length;d++){const h=u[d];if(!document.contains(h)){const g=h[i.attribute];if(g&&typeof g.destroy=="function")try{g.destroy()}catch(b){console.error("["+i.attribute+"] destroy failed",h,b)}delete h[i.attribute]}}}}}}function ue(){window.lnCore=window.lnCore||{},!window.lnCore._lifecycleObserverBound&&(window.lnCore._lifecycleObserverBound=!0,x(function(){new MutationObserver(function(t){for(let n=0;n<t.length;n++){const o=t[n];if(o.type==="childList")try{ce(o)}catch(r){console.error("[ln-core] lifecycle handler failed",o.target,r)}}}).observe(document.body,{childList:!0,subtree:!0})},"ln-core"))}function fe(e,t,n,o,r={}){const i=r.extraAttributes||[],l=r.onAttributeChange||null,u=r.onSubtreeChange||null,d=r.onInit||null,h=r.onAttrChange||null,g=r.effects||null,b=r.attributes||null,C=b?re(b):g,F=b?new Set(Object.keys(b)):null,I=r.persist||null;function v(w){const c=w||document.body;if(T(c,e,t,n),b&&j())for(const p in b){const y=b[p],A=Array.from(c.querySelectorAll("["+p+"]"));c.matches&&c.matches("["+p+"]")&&A.push(c);for(let S=0;S<A.length;S++){const E=A[S];L(E)&&V(y,E.getAttribute(p),p,o,E)}}d&&d(c)}const M=[];if(e.indexOf("[")!==-1){const w=/\[([\w-]+)/g;let c;for(;(c=w.exec(e))!==null;)M.push(c[1])}else M.push(e);se({selector:e,attribute:t,componentTag:o,attributes:b,ComponentFn:n,onInit:d,observed:M.concat(i),onAttributeChange:l,onAttrChange:h,effects:C,declared:F,persist:I}),ae();const s=e.indexOf("[")!==-1||e.indexOf(".")!==-1||e.indexOf("#")!==-1?e:"["+e+"]";Q().push({selector:e,attribute:t,ComponentFn:n,onInit:d,onSubtreeChange:u,query:s}),ue(),window[t]=v;function a(){le()>0?$(function(){v(document.body)}):v(document.body)}return document.readyState==="loading"?document.addEventListener("DOMContentLoaded",a):a(),v}function z(e){return(e||"").replace(/^#/,"")}function O(e){const t=e===void 0?location.hash:e,n={},o=z(t);if(!o)return n;const r=o.split("&");for(let i=0;i<r.length;i++){const l=r[i];if(!l)continue;const u=l.indexOf(":"),d=u>-1?l.slice(0,u):l,h=u>-1?l.slice(u+1):"";if(d)try{n[d]=decodeURIComponent(h)}catch{n[d]=h}}return n}function k(e){if(!e)return null;const t=O();return e in t?t[e]:null}function _(e,t){if(!e)return;const n=O();t==null?delete n[e]:n[e]=String(t);const r=Object.keys(n).map(function(i){const l=n[i];return l===""?i:i+":"+encodeURIComponent(l)}).join("&");z(location.hash)!==r&&(location.hash=r)}function G(e){return e.button===1||e.ctrlKey||e.metaKey||e.shiftKey?!1:(e.preventDefault(),!0)}function we(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 o=e.getAttribute("data-ln-sort")||e.getAttribute("data-ln-search-for")||e.getAttribute("data-ln-search")||e.getAttribute("data-ln-filter")||e.id;return o?t?o+"-"+t:o:t||null}function he(e,t){return!t||t==="none"||e===null||e===void 0?null:String(e)+"."+t}function be(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 ge(e,t){return!e||!Array.isArray(t)||t.length===0?null:e+":"+t.map(encodeURIComponent).join(",")}function pe(e){if(!e||typeof e!="string")return null;const t=e.indexOf(":");if(t===-1)return null;const n=e.slice(0,t),o=e.slice(t+1),r=o?o.split(",").map(function(i){try{return decodeURIComponent(i)}catch{return i}}).filter(Boolean):[];return{key:n,values:r}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.hashParse=O,window.lnCore.hashGet=k,window.lnCore.hashSet=_,window.lnCore.hashLinkClick=G,window.lnCore.resolveHashNamespace=we,window.lnCore.hashSortEncode=he,window.lnCore.hashSortDecode=be,window.lnCore.hashFilterEncode=ge,window.lnCore.hashFilterDecode=pe),(function(){const e="data-ln-ui-coordinator",t="lnUiCoordinator",n="data-ln-ui-coordinator-dict";if(window[t]!==void 0)return;const o={"data-ln-ui-coordinator":{type:"marker",description:"Mounts UI coordinator mediating global hash-routing, modals, and toasts"},"data-ln-ui-coordinator-dict":{type:"string",description:"Dictionary key prefix mapping for translatable UI coordinator messages"}};function r(f){const s={};let a=f;const w=[];for(;a;){const c=a.closest("["+e+"]");if(!c)break;c[t]&&c[t].dict&&w.unshift(c[t].dict),a=c.parentElement}for(const c of w)Object.assign(s,c);return s}function i(f,s){if(s){if(f){const w=f.closest("["+e+"]");if(w){if(w.id===s&&w.hasAttribute("data-ln-modal"))return w;const c=w.querySelector("#"+CSS.escape(s)+'[data-ln-modal], [data-ln-modal="'+s+'"]');if(c)return c}}const a=document.getElementById(s)||document.querySelector('[data-ln-modal="'+s+'"]');if(a)return a}if(f){const a=f.closest("["+e+"]");if(a){if(a.hasAttribute("data-ln-modal"))return a;const c=a.querySelector("[data-ln-modal]");if(c)return c}const w=f.closest("[data-ln-modal]");if(w)return w}return document.querySelector("[data-ln-modal]")}function l(f,s){if(f!=="edit")return"";if(s){const a=s.getAttribute("data-ln-fill-id");if(a)return a}return"edit"}function u(f){if(!f)return;const s=f.querySelectorAll("[data-ln-field]");for(let w=0;w<s.length;w++)s[w].textContent="";const a=f.querySelectorAll("form");for(let w=0;w<a.length;w++)window.lnCore&&typeof window.lnCore.lnFill=="function"?window.lnCore.lnFill(a[w],null):a[w].reset()}document.addEventListener("click",function(f){if(f.ctrlKey||f.metaKey||f.button===1)return;const s=f.target.closest("[data-ln-modal-for]");if(s){const w=s.getAttribute("data-ln-modal-for"),c=i(s,w);if(c&&c.lnModal){f.preventDefault();const p={lnModalFor:!0,lnModalClose:!0,lnModalMode:!0},y={},A=s.dataset;for(const q in A){if(!q.startsWith("lnModal")||p[q])continue;const R=q.slice(7);R&&(y[R.charAt(0).toLowerCase()+R.slice(1)]=A[q])}const S=Object.keys(y).length>0;s.hasAttribute("data-ln-modal-mode")?c.dataset.lnModalMode=s.getAttribute("data-ln-modal-mode"):c.dataset.lnModalMode=S?"edit":"new",S&&window.lnCore&&typeof window.lnCore.lnFill=="function"?window.lnCore.lnFill(c,y):c.dataset.lnModalMode==="new"&&u(c),c.getAttribute("data-ln-modal")==="open"?m(c,"ln-modal:request-close",{}):(c.id&&_(c.id,l(c.dataset.lnModalMode,s)),m(c,"ln-modal:request-open",{}))}return}const a=f.target.closest('a[href^="#"]');if(a){const w=O(a.getAttribute("href"));for(const c in w){const p=document.getElementById(c);if(p&&p.lnModal){if(!G(f))return;_(c,w[c]);return}}}}),document.addEventListener("ln-modal:before-open",function(f){const s=f.target;if(!s||!s.lnModal)return;(s.dataset.lnModalMode||"new")==="new"&&u(s)}),document.addEventListener("ln-modal:open",function(f){const s=f.target;if(!s||!s.lnModal||!s.id)return;let a=k(s.id);a===null&&(a=l(s.dataset.lnModalMode,null),_(s.id,a)),a?(s.dataset.lnModalMode="edit",m(s,"ln-fill:request",{id:a})):(s.dataset.lnModalMode="new",u(s))});let d=!1;function h(){if(!d){d=!0;try{const f=document.querySelectorAll("[data-ln-modal][id]");for(let s=0;s<f.length;s++){const a=f[s];if(!a.lnModal)continue;const w=a.id,c=k(w),p=c!==null,y=a.lnModal.isOpen;if(p){const A=c?"edit":"new";a.dataset.lnModalMode=A,y?c?m(a,"ln-fill:request",{id:c}):u(a):m(a,"ln-modal:request-open",{})}else y&&m(a,"ln-modal:request-close",{})}}finally{d=!1}}}function g(){const f=document.querySelectorAll('[data-ln-modal="open"][id]');for(let s=0;s<f.length;s++){const a=f[s];a.lnModal&&k(a.id)===null&&_(a.id,l(a.dataset.lnModalMode,null))}}window.addEventListener("hashchange",h);function b(){g(),h()}document.readyState==="loading"?document.addEventListener("DOMContentLoaded",function(){$(b)}):$(b);function C(f){const a=(f.detail||{}).data;if(a&&a.message){const c=a.message;m(window,"ln-toast:enqueue",{type:c.type||"success",title:c.title||"",message:c.body||""})}const w=f.target.closest("[data-ln-modal]");w&&w.lnModal&&(w.id&&_(w.id,null),m(w,"ln-modal:request-close",{}),u(w))}function F(f){const s=f.detail||{},a=s.data,w=s.status||0,c=r(f.target);if(a&&a.message){const p=a.message;m(window,"ln-toast:enqueue",{type:p.type||"error",title:p.title||"",message:p.body||""})}else w===0?m(window,"ln-toast:enqueue",{type:"error",title:c["network-error-title"]||"",message:c["network-error"]||"Network error"}):m(window,"ln-toast:enqueue",{type:"error",title:c["server-error-title"]||"",message:c["server-error"]||"Server error"})}document.addEventListener("ln-ajax:success",C),document.addEventListener("ln-ajax:error",F);function I(f){const s=f.detail||{},a=r(f.target),w=s.message||(s.reason==="max-size"?a["upload-max-size"]||"File is too large":s.reason==="max-files"?a["upload-max-files"]||"Maximum file count exceeded":a["upload-invalid-type"]||"This file type is not allowed"),c=a["upload-invalid-title"]||"Invalid File";m(window,"ln-toast:enqueue",{type:"error",title:c,message:w})}function v(f){const s=f.detail||{},a=r(f.target),w=s.message||a["upload-failed"]||"Failed to upload file",c=a["upload-error-title"]||"Upload Error";m(window,"ln-toast:enqueue",{type:"error",title:c,message:w})}document.addEventListener("ln-upload:invalid",I),document.addEventListener("ln-upload:error",v),document.addEventListener("ln-modal:close",function(f){const s=f.target;!s||!s.lnModal||(s.id&&k(s.id)!==null&&_(s.id,null),s.dataset.lnModalMode==="new"&&u(s))});function M(f){return this.dom=f,this.dict=oe(f,n),this}M.prototype.destroy=function(){this.dom[t]&&(this.dict={},delete this.dom[t])},fe(e,t,M,"ln-ui-coordinator",{attributes:o})})()})();

package/components/ln-ui-coordinator/ln-ui-coordinator.schema.json

@@ -0,0 +1,60 @@
+{
+	"$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-ui-coordinator",
+	"generator": "scripts/sync-ln-schemas.mjs",
+	"attributes": {
+		"data-ln-debug": {
+			"direction": null,
+			"sources": [
+				"ln-ui-coordinator-dev.scss"
+			]
+		},
+		"data-ln-field": {
+			"direction": "author",
+			"sources": [
+				"src/ln-ui-coordinator.js"
+			]
+		},
+		"data-ln-fill-id": {
+			"direction": "author",
+			"sources": [
+				"src/ln-ui-coordinator.js"
+			]
+		},
+		"data-ln-modal": {
+			"direction": "author",
+			"sources": [
+				"src/ln-ui-coordinator.js"
+			]
+		},
+		"data-ln-modal-for": {
+			"direction": "author",
+			"sources": [
+				"src/ln-ui-coordinator.js"
+			]
+		},
+		"data-ln-modal-mode": {
+			"direction": "both",
+			"sources": [
+				"src/ln-ui-coordinator.js"
+			]
+		},
+		"data-ln-ui-coordinator": {
+			"direction": "author",
+			"sources": [
+				"ln-ui-coordinator-dev.scss",
+				"src/ln-ui-coordinator.js"
+			],
+			"type": "marker",
+			"description": "Mounts UI coordinator mediating global hash-routing, modals, and toasts"
+		},
+		"data-ln-ui-coordinator-dict": {
+			"direction": null,
+			"sources": [
+				"src/ln-ui-coordinator.js"
+			],
+			"type": "string",
+			"description": "Dictionary key prefix mapping for translatable UI coordinator messages"
+		}
+	}
+}