@livenetworks/ashlar 1.6.1 → 2.0.0

package/{js → components}/ln-api-queue/src/ln-api-queue.js

@@ -7,9 +7,20 @@ import { QueueStorage } from './queue-storage';
 	const BACKOFF_LADDER = [2000, 5000, 15000, 60000, 300000];
 	const MAX_ATTEMPTS = 8;
 	const LEASE_MS = 60000;
-
 	if (window[DOM_ATTRIBUTE] !== undefined) return;
 
+	// ─── Attribute Contract (SSOT) ──────────────────────────
+	function _syncOnline(el) {
+		const instance = el[DOM_ATTRIBUTE];
+		if (!instance) return;
+		instance._drain();
+	}
+
+	const ATTRIBUTES = {
+		'data-ln-api-queue':        { type: 'marker', description: 'Mounts offline API synchronization queue backed by IndexedDB' },
+		'data-ln-api-queue-online': { effect: _syncOnline, type: 'enum', values: ['true', 'false'], fallback: 'auto', description: 'Network connectivity override (true/false, or auto-detect from navigator.onLine)' }
+	};
+
 	function _uuid() {
 		try { return crypto.randomUUID(); }
 		catch (_) {
@@ -31,7 +42,7 @@ import { QueueStorage } from './queue-storage';
 		dom[DOM_ATTRIBUTE] = this;
 
 		const coordinatorEl = dom.closest('[data-ln-data-coordinator]');
-		this.scope = dom.getAttribute(DOM_SELECTOR) || (coordinatorEl ? coordinatorEl.getAttribute('data-ln-data-coordinator') : null) || 'default';
+		this.scope = dom.id || (coordinatorEl ? coordinatorEl.id : null) || 'default';
 
 		this._paused = false;
 		this._timers = new Map();
@@ -51,9 +62,12 @@ import { QueueStorage } from './queue-storage';
 				}
 				return _storage.getPaused(self.scope);
 			})
-			.then(paused => {
-				self._paused = !!paused;
-				if (self._paused) dispatch(self.dom, 'ln-api-queue:paused', { reason: 'auth', restored: true });
+			.then(pausedReason => {
+				self._paused = !!pausedReason;
+				if (self._paused) {
+					const reason = typeof pausedReason === 'string' ? pausedReason : 'auth';
+					dispatch(self.dom, 'ln-api-queue:paused', { reason: reason, restored: true });
+				}
 				return self._emitPendingCount();
 			})
 			.then(() => self._drain())
@@ -240,6 +254,16 @@ import { QueueStorage } from './queue-storage';
 		});
 	};
 
+	_component.prototype._onPause = function () {
+		const self = this;
+		return _storage.setPaused(self.scope, 'manual').then(() => {
+			self._paused = true;
+			dispatch(self.dom, 'ln-api-queue:paused', { reason: 'manual' });
+		}).catch(error => {
+			dispatch(self.dom, 'ln-api-queue:error', { operation: 'pause', error });
+		});
+	};
+
 	_component.prototype._onDrain = function () {
 		const self = this;
 		return _storage.resetFailed(self.scope).then(() => {
@@ -272,6 +296,7 @@ import { QueueStorage } from './queue-storage';
 			remap: e => self._onRemap(e),
 			resolveCreate: e => self._onResolveCreate(e),
 			resume: () => self._onResume(),
+			pause: () => self._onPause(),
 			drain: () => self._onDrain(),
 			clear: () => self._onClear()
 		};
@@ -282,6 +307,7 @@ import { QueueStorage } from './queue-storage';
 		self.dom.addEventListener('ln-api-queue:request-remap', self._handlers.remap);
 		self.dom.addEventListener('ln-api-queue:resolve-create', self._handlers.resolveCreate);
 		self.dom.addEventListener('ln-api-queue:request-resume', self._handlers.resume);
+		self.dom.addEventListener('ln-api-queue:request-pause', self._handlers.pause);
 		self.dom.addEventListener('ln-api-queue:request-drain', self._handlers.drain);
 		self.dom.addEventListener('ln-api-queue:request-clear', self._handlers.clear);
 	};
@@ -296,6 +322,7 @@ import { QueueStorage } from './queue-storage';
 		self.dom.removeEventListener('ln-api-queue:request-remap', self._handlers.remap);
 		self.dom.removeEventListener('ln-api-queue:resolve-create', self._handlers.resolveCreate);
 		self.dom.removeEventListener('ln-api-queue:request-resume', self._handlers.resume);
+		self.dom.removeEventListener('ln-api-queue:request-pause', self._handlers.pause);
 		self.dom.removeEventListener('ln-api-queue:request-drain', self._handlers.drain);
 		self.dom.removeEventListener('ln-api-queue:request-clear', self._handlers.clear);
 		window.removeEventListener('online', self._onlineHandler);
@@ -303,18 +330,10 @@ import { QueueStorage } from './queue-storage';
 		self._timers.forEach(timer => clearTimeout(timer));
 		self._timers.clear();
 
-		dispatch(self.dom, 'ln-api-queue:destroyed', { scope: self.scope });
 		delete self.dom[DOM_ATTRIBUTE];
 	};
 
-	function _syncAttr(el) {
-		const instance = el[DOM_ATTRIBUTE];
-		if (!instance) return;
-		instance._drain();
-	}
-
 	registerComponent(DOM_SELECTOR, DOM_ATTRIBUTE, _component, 'ln-api-queue', {
-		extraAttributes: ['data-ln-api-queue-online'],
-		onAttributeChange: _syncAttr
+		attributes: ATTRIBUTES
 	});
 })();

package/{js → components}/ln-api-queue/src/queue-storage.js

@@ -289,7 +289,7 @@ export class QueueStorage {
 					if (reason === 'auth') {
 						entry.status = 'pending';
 						outbox.put(entry);
-						meta.put({ key: pauseKey(scope), value: true });
+						meta.put({ key: pauseKey(scope), value: 'auth' });
 						result = { status: 'auth', entry };
 						return;
 					}
@@ -386,7 +386,10 @@ export class QueueStorage {
 			return new Promise((resolve, reject) => {
 				const tx = db.transaction(META, 'readonly');
 				const request = tx.objectStore(META).get(pauseKey(scope));
-				request.onsuccess = () => resolve(!!(request.result && request.result.value));
+				request.onsuccess = () => {
+					const val = request.result ? request.result.value : false;
+					resolve(val || false);
+				};
 				request.onerror = () => reject(requestError(request, 'Queue pause-state read failed'));
 			});
 		});
@@ -397,7 +400,8 @@ export class QueueStorage {
 			if (!db) return;
 			return new Promise((resolve, reject) => {
 				const tx = db.transaction(META, 'readwrite');
-				tx.objectStore(META).put({ key: pauseKey(scope), value: !!paused });
+				const value = typeof paused === 'string' ? paused : (paused ? 'manual' : false);
+				tx.objectStore(META).put({ key: pauseKey(scope), value: value });
 				tx.oncomplete = () => resolve();
 				tx.onerror = () => reject(tx.error || new Error('Queue pause-state write failed'));
 				tx.onabort = () => reject(tx.error || new Error('Queue pause-state write aborted'));

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

@@ -1,127 +1,129 @@
-# ln-autoresize
-
-A zero-dependency, high-performance **UX Helper Primitive** (~47 lines of JavaScript) that dynamically resizes a `<textarea>` to track its content. It grows as the user types and collapses instantly as text is deleted.
-
----
-
-## 🧭 Philosophy & Architecture
-
-1. **Platform-First Execution:** Instead of introducing heavy observers or layouts, `ln-autoresize` hooks directly into the browser's native layout engine. By resetting height to `auto` before reading `scrollHeight` inside the event loop, it forces a synchronous, flicker-free layout calculation.
-2. **Strict Concern Scope:** The primitive is stateless. Ceiling limits, minimum bounds, and manual resize handles are defined exclusively via standard CSS classes. The script only handles active observation.
-3. **Reactive Synchronization:** Data flows strictly through DOM events. Programmatic changes must trigger standard events (`input` / `change`) so that dependent primitives can adapt in synchrony.
-
----
-
-## 📦 Minimal Blueprint
-
-```html
-<textarea data-ln-autoresize rows="1" placeholder="Type here..."></textarea>
-```
-
-To cap growth at a maximum height and enable scroll past it, pair the attribute with pure CSS:
-
-```scss
-textarea[data-ln-autoresize] {
-    resize: none;         // Removes conflicting manual drag handle
-    max-height: 6rem;     // Defines height ceiling
-    overflow-y: auto;     // Reveals scrollbar at ceiling
-}
-```
-
-> [!TIP]
-> Always set `rows="1"` on the HTML element. This ensures the initial empty height matches the post-initialization state and prevents visual snap-shut on first paint.
-
----
-
-## 🛠️ Declarative API Contract
-
-### HTML Attributes
-
-| Attribute | Elements | Description |
-| :--- | :--- | :--- |
-| `data-ln-autoresize` | `<textarea>` | Observation marker. Presence creates the instance and runs initial measurement. |
-
-### JS API
-
-Access the utility instance directly via the `lnAutoresize` property on the textarea element:
-
-```javascript
-const textarea = document.getElementById('my-textarea');
-
-// 1. Force a manual re-measure (essential after parent reveals, font loads, etc.)
-textarea.lnAutoresize._resize();
-
-// 2. Tear down event listeners and clear inline styles
-textarea.lnAutoresize.destroy();
-```
-
----
-
-## ⚡ DOM Events
-
-`ln-autoresize` does not emit custom events. It relies entirely on standard browser interactions:
-
-- **Listens to `input`:** Triggers `_resize()` on keystrokes, pastes, and deletes.
-- **Listens to `change`:** Triggers `_resize()` on value commits.
-
----
-
-## ⚠️ Common Pitfalls
-
-- **Setting `textarea.value` directly:** Programmatic writes are silent in the DOM. The component will not detect value updates unless you dispatch a synthetic event:
-  ```javascript
-  textarea.value = 'New text content';
-  textarea.dispatchEvent(new Event('input', { bubbles: true }));
-  ```
-- **Mounting in hidden parents:** A textarea inside a `display: none` container measures `scrollHeight` as `0`. When revealed later, it will appear collapsed. Force a re-measure manually after reveal:
-  ```javascript
-  textarea.lnAutoresize._resize();
-  ```
-- **Conflicting manual drag handles:** By default, textareas may have `resize: vertical` applied. This lets users manual resize the input, which is instantly overridden by the script on the next keystroke. Set `resize: none` to clean up the interface.
-
----
-
-## 🔧 Internals
-
-Source: `js/ln-autoresize/ln-autoresize.js`. A pure presentation utility — owns no data, emits no custom events, cooperates with no other component outside the `input` platform event.
-
-### Instance state
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `dom` | `HTMLTextAreaElement` | The textarea, constructor argument |
-| `_onInput` | `Function` | Bound `input` handler, kept for `destroy()` unbind |
-
-No cached "current height" — `_resize` always reads `scrollHeight` fresh, so external CSS changes (`max-height`, font-size, padding) are picked up on the next keystroke.
-
-### Resize mechanism
-
-```
-_resize():
-  1. style.height = 'auto'
-  2. read scrollHeight
-  3. style.height = scrollHeight + 'px'
-```
-
-Step 1 is what makes it shrink, not just grow: `scrollHeight` reports the explicit `height` when content fits inside it, so without the reset every measurement would ratchet upward only. The reset + re-read happen synchronously in one tick, so the browser never paints the intermediate `auto` state — no flicker.
-
-The constructor also calls `_resize()` once before returning, to size server-rendered pre-filled values and late-attached fields (`setAttribute` after the fact) on first paint rather than first keystroke. If the textarea is hidden at construction (`display: none` ancestor), `scrollHeight` reads `0` and there's no `ResizeObserver`/`IntersectionObserver` to catch a later reveal — call `_resize()` manually after showing it.
-
-### Tag validation
-
-The constructor checks `dom.tagName !== 'TEXTAREA'` and, if true, warns and returns `this` early with no `dom`/listener. The element is still marked initialized, so re-attaching the attribute after swapping in a real `<textarea>` needs `destroy()` first.
-
-### MutationObserver via `registerComponent`
-
-Standard shared observer on `document.body`: `childList/subtree` catches new `[data-ln-autoresize]` textareas anywhere; `attributes` (filtered to the one attribute) catches late `setAttribute` addition. Only attribute *presence* matters — no `onAttributeChange` callback, so value changes and attribute removal are no-ops.
-
-### Destroy
-
-Idempotent (bails if already torn down). Unbinds `_onInput`, clears `style.height` (reverting to the CSS-driven `rows`-based height), deletes the instance property. Does not remove the `data-ln-autoresize` attribute — the caller owns it, so a later rescan can re-create the instance.
-
-### Cross-component coordination
-
-No ln-prefixed import/listen/dispatch — only the platform `input` event. Two paths feed it synthetic `input` events:
-
-- **`ln-form:fill`** — `ln-form`'s `fill()` writes `.value` then dispatches `input` on each populated field; autoresize catches it and re-measures. Direct `.value =` writes from project code skip this and will not resize.
-- **`lnForm.reset()`** — walks fields dispatching synthetic `input`/`change` after `dom.reset()`, so cleared textareas shrink back. The bare native `<button type="reset">` path does NOT dispatch synthetic `input` (intentionally minimal); wire it manually or use the `lnForm.reset()` API if auto-shrink is needed there.
+# ln-autoresize
+
+> Applied directly to a `<textarea data-ln-autoresize rows="1">`. It listens for native `input` events:
+> in the handler, it resets `textarea.style.height = 'auto'`, reads `textarea.scrollHeight`, and sets
+> `textarea.style.height = textarea.scrollHeight + 'px'`. It carries zero state, executing a synchronous layout calculation to expand and collapse the box dynamically.
+
+---
+
+## 🧭 Philosophy & Architecture
+
+1. **Platform-First Execution:** Instead of introducing heavy observers or layouts, `ln-autoresize` hooks directly into the browser's native layout engine. By resetting height to `auto` before reading `scrollHeight` inside the event loop, it forces a synchronous, flicker-free layout calculation.
+2. **Strict Concern Scope:** The primitive is stateless. Ceiling limits, minimum bounds, and manual resize handles are defined exclusively via standard CSS classes. The script only handles active observation.
+3. **Reactive Synchronization:** Data flows strictly through DOM events. Programmatic changes must trigger standard events (`input` / `change`) so that dependent primitives can adapt in synchrony.
+
+---
+
+## 📦 Minimal Blueprint
+
+```html
+<textarea data-ln-autoresize rows="1" placeholder="Type here..."></textarea>
+```
+
+To cap growth at a maximum height and enable scroll past it, pair the attribute with pure CSS:
+
+```scss
+textarea[data-ln-autoresize] {
+    resize: none;         // Removes conflicting manual drag handle
+    max-height: 6rem;     // Defines height ceiling
+    overflow-y: auto;     // Reveals scrollbar at ceiling
+}
+```
+
+> [!TIP]
+> Always set `rows="1"` on the HTML element. This ensures the initial empty height matches the post-initialization state and prevents visual snap-shut on first paint.
+
+---
+
+## 🛠️ Declarative API Contract
+
+### HTML Attributes
+
+| Attribute | Elements | Description |
+| :--- | :--- | :--- |
+| `data-ln-autoresize` | `<textarea>` | Observation marker. Presence creates the instance and runs initial measurement. |
+
+### JS API
+
+Access the utility instance directly via the `lnAutoresize` property on the textarea element:
+
+```javascript
+const textarea = document.getElementById('my-textarea');
+
+// 1. Force a manual re-measure (essential after parent reveals, font loads, etc.)
+textarea.lnAutoresize._resize();
+
+// 2. Tear down event listeners and clear inline styles
+textarea.lnAutoresize.destroy();
+```
+
+---
+
+## ⚡ DOM Events
+
+`ln-autoresize` does not emit custom events. It relies entirely on standard browser interactions:
+
+- **Listens to `input`:** Triggers `_resize()` on keystrokes, pastes, and deletes.
+- **Listens to `change`:** Triggers `_resize()` on value commits.
+
+---
+
+## ⚠️ Common Pitfalls
+
+- **Setting `textarea.value` directly:** Programmatic writes are silent in the DOM. The component will not detect value updates unless you dispatch a synthetic event:
+  ```javascript
+  textarea.value = 'New text content';
+  textarea.dispatchEvent(new Event('input', { bubbles: true }));
+  ```
+- **Mounting in hidden parents:** A textarea inside a `display: none` container measures `scrollHeight` as `0`. When revealed later, it will appear collapsed. Force a re-measure manually after reveal:
+  ```javascript
+  textarea.lnAutoresize._resize();
+  ```
+- **Conflicting manual drag handles:** By default, textareas may have `resize: vertical` applied. This lets users manual resize the input, which is instantly overridden by the script on the next keystroke. Set `resize: none` to clean up the interface.
+
+---
+
+## 🔧 Internals
+
+Source: `components/ln-autoresize/ln-autoresize.js`. A pure presentation utility — owns no data, emits no custom events, cooperates with no other component outside the `input` platform event.
+
+### Instance state
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `dom` | `HTMLTextAreaElement` | The textarea, constructor argument |
+| `_onInput` | `Function` | Bound `input` handler, kept for `destroy()` unbind |
+
+No cached "current height" — `_resize` always reads `scrollHeight` fresh, so external CSS changes (`max-height`, font-size, padding) are picked up on the next keystroke.
+
+### Resize mechanism
+
+```
+_resize():
+  1. style.height = 'auto'
+  2. read scrollHeight
+  3. style.height = scrollHeight + 'px'
+```
+
+Step 1 is what makes it shrink, not just grow: `scrollHeight` reports the explicit `height` when content fits inside it, so without the reset every measurement would ratchet upward only. The reset + re-read happen synchronously in one tick, so the browser never paints the intermediate `auto` state — no flicker.
+
+The constructor also calls `_resize()` once before returning, to size server-rendered pre-filled values and late-attached fields (`setAttribute` after the fact) on first paint rather than first keystroke. If the textarea is hidden at construction (`display: none` ancestor), `scrollHeight` reads `0` and there's no `ResizeObserver`/`IntersectionObserver` to catch a later reveal — call `_resize()` manually after showing it.
+
+### Tag validation
+
+The constructor checks `dom.tagName !== 'TEXTAREA'` and, if true, warns and returns `this` early with no `dom`/listener. The element is still marked initialized, so re-attaching the attribute after swapping in a real `<textarea>` needs `destroy()` first.
+
+### MutationObserver via `registerComponent`
+
+Standard shared observer on `document.body`: `childList/subtree` catches new `[data-ln-autoresize]` textareas anywhere; `attributes` (filtered to the one attribute) catches late `setAttribute` addition. Only attribute *presence* matters — no `onAttributeChange` callback, so value changes and attribute removal are no-ops.
+
+### Destroy
+
+Idempotent (bails if already torn down). Unbinds `_onInput`, clears `style.height` (reverting to the CSS-driven `rows`-based height), deletes the instance property. Does not remove the `data-ln-autoresize` attribute — the caller owns it, so a later rescan can re-create the instance.
+
+### Cross-component coordination
+
+No ln-prefixed import/listen/dispatch — only the platform `input` event. Two paths feed it synthetic `input` events:
+
+- **`ln-form:fill`** — `ln-form`'s `fill()` writes `.value` then dispatches `input` on each populated field; autoresize catches it and re-measures. Direct `.value =` writes from project code skip this and will not resize.
+- **`lnForm.reset()`** — walks fields dispatching synthetic `input`/`change` after `dom.reset()`, so cleared textareas shrink back. The bare native `<button type="reset">` path does NOT dispatch synthetic `input` (intentionally minimal); wire it manually or use the `lnForm.reset()` API if auto-shrink is needed there.

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

@@ -0,0 +1,8 @@
+@use '../../theme/config/mixins' as *;
+
+[data-ln-debug] {
+	// 1. Host Element Check: data-ln-autoresize belongs only on <textarea>
+	[data-ln-autoresize]:not(textarea) {
+		@include dev-inline-error("data-ln-autoresize belongs only on <textarea> elements");
+	}
+}

package/components/ln-autoresize/ln-autoresize.js

@@ -0,0 +1 @@
+(function(){"use strict";function O(){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 p(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(!p(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 b(e,t){if(!document.body){document.addEventListener("DOMContentLoaded",function(){b(e,t)}),console.warn("["+t+'] Script loaded before <body> — add "defer" to your <script> tag');return}e()}const x={};function B(e,t){x[e]=t}function N(e){return x[e]||{ingress:t=>t,egress:t=>t}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerDataMapper=B,window.lnCore.getDataMapper=N);function W(){typeof window>"u"||(window.lnCore=window.lnCore||{},!window.lnCore._localeObserverBound&&(window.lnCore._localeObserverBound=!0,b(function(){new MutationObserver(function(){M(document,"ln-core:locale-change",{})}).observe(document.documentElement,{attributes:!0,attributeFilter:["lang"],subtree:!0})},"ln-core")))}const E={};function j(e,t){if(!e||typeof t!="object")return;const n=e.toLowerCase().split("-")[0];E[n]=t}function V(e){if(!e)return null;const t=e.toLowerCase().split("-")[0];return E[t]||null}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerLocaleFallback=j,window.lnCore.getLocaleFallback=V,window.lnCore.ensureLocaleObserver=W);const C={};function H(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 L(e,t){if(!e||!t)return e;const n=e.querySelectorAll("[data-ln-field]");for(let l=0;l<n.length;l++){const c=n[l],s=c.getAttribute("data-ln-field");t[s]!=null&&(c.textContent=t[s])}const o=e.querySelectorAll("[data-ln-attr]");for(let l=0;l<o.length;l++){const c=o[l],s=c.getAttribute("data-ln-attr").split(",");for(let u=0;u<s.length;u++){const a=s[u].trim().split(":");if(a.length!==2)continue;const d=a[0].trim(),f=a[1].trim();t[f]!=null&&c.setAttribute(d,t[f])}}const r=e.querySelectorAll("[data-ln-show]");for(let l=0;l<r.length;l++){const c=r[l],s=c.getAttribute("data-ln-show");s in t&&c.classList.toggle("hidden",!t[s])}const i=e.querySelectorAll("[data-ln-class]");for(let l=0;l<i.length;l++){const c=i[l],s=c.getAttribute("data-ln-class").split(",");for(let u=0;u<s.length;u++){const a=s[u].trim().split(":");if(a.length!==2)continue;const d=a[0].trim(),f=a[1].trim();f in t&&c.classList.toggle(d,!!t[f])}}return e}function z(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)L(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 $(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,c){return t[c]!==void 0?t[c]:""}))}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],c=l.attributes;for(let s=0;s<c.length;s++){const u=c[s];u.value.indexOf("{{")!==-1&&l.setAttribute(u.name,u.value.replace(/\{\{\s*(\w+)\s*\}\}/g,o))}}return e}function U(e,t,n,o,r,i){const l={};for(let s=0;s<e.children.length;s++){const u=e.children[s],a=u.getAttribute("data-ln-render-key");a&&(l[a]=u)}const c=document.createDocumentFragment();for(let s=0;s<t.length;s++){const u=t[s],a=String(o(u));let d=l[a];if(d)r(d,u,s);else{const f=H(n,i);if(!f||($(f,u),d=f.firstElementChild,!d))continue;d.setAttribute("data-ln-render-key",a),r(d,u,s)}c.appendChild(d)}e.textContent="",e.appendChild(c)}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.fillTemplate=$,window.lnCore.fill=L,window.lnCore.lnFill=z,window.lnCore.renderList=U);function T(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 c=s=>{r?console.warn(s,r):console.warn(s)};if(l==="boolean"){const s=t.trim().toLowerCase();return s!==""&&s!=="true"&&s!=="false"&&s!=="1"&&s!=="0"?(c(`[${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:(c(`[${i}] Invalid value "${t}" for attribute "${n}". Allowed: ${s.join(", ")}. Fallback: "${e.fallback}".`),!1)}if(l==="integer"){if(!/^-?\d+$/.test(t))return c(`[${i}] Invalid integer "${t}" for attribute "${n}". Fallback: ${e.fallback}.`),!1;const s=parseInt(t,10);return e.min!==void 0&&s<e.min?(c(`[${i}] Value ${s} for attribute "${n}" is less than min (${e.min}).`),!1):e.max!==void 0&&s>e.max?(c(`[${i}] Value ${s} for attribute "${n}" is greater than max (${e.max}).`),!1):!0}if(l==="float")return isNaN(Number(t))?(c(`[${i}] Invalid float "${t}" for attribute "${n}". Fallback: ${e.fallback}.`),!1):!0;if(l==="json")try{return JSON.parse(t),!0}catch(s){return c(`[${i}] Invalid JSON for attribute "${n}": ${s.message}. Fallback: ${e.fallback}.`),!1}return!0}function Q(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 K(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,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 c of l)if(!c[n]){window.lnCore._persistSink&&c.hasAttribute("data-ln-persist")&&window.lnCore._persistSink(c,t);try{c[n]=new o(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 G(){return typeof window<"u"&&window.lnCore&&window.lnCore._bootHolds||0}function J(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 D(){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 X(e){const t=D(),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=K(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 I(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 P(e){const t=e.target,n=e.attributeName;if(e.oldValue===t.getAttribute(n))return;const o=D(),r=o.byAttr.get(n);if(O()&&o.byDeclaredAttr&&o.byDeclaredAttr.has(n)&&p(t)){const i=o.byDeclaredAttr.get(n),l=t.getAttribute(n);for(let c=0;c<i.length;c++)T(i[c].spec,l,n,i[c].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&&I(i,t,n,e.oldValue),o.reactiveWildcard.length&&I(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):(y(t,l.selector,l.attribute,l.ComponentFn),l.onInit&&l.onInit(t))}}function Y(){window.lnCore=window.lnCore||{},!window.lnCore._attrObserverBound&&(window.lnCore._attrObserverBound=!0,b(function(){new MutationObserver(function(t){for(let n=0;n<t.length;n++)try{P(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 R(){return window.lnCore=window.lnCore||{},window.lnCore._lifecycleRegistry=window.lnCore._lifecycleRegistry||[]}function Z(e){const t=R();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];y(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,c=Array.from(o.querySelectorAll(l));o.matches&&o.matches(l)&&c.push(o);for(let s=0;s<c.length;s++){const u=c[s];if(!document.contains(u)){const a=u[i.attribute];if(a&&typeof a.destroy=="function")try{a.destroy()}catch(d){console.error("["+i.attribute+"] destroy failed",u,d)}delete u[i.attribute]}}}}}}function ee(){window.lnCore=window.lnCore||{},!window.lnCore._lifecycleObserverBound&&(window.lnCore._lifecycleObserverBound=!0,b(function(){new MutationObserver(function(t){for(let n=0;n<t.length;n++){const o=t[n];if(o.type==="childList")try{Z(o)}catch(r){console.error("[ln-core] lifecycle handler failed",o.target,r)}}}).observe(document.body,{childList:!0,subtree:!0})},"ln-core"))}function te(e,t,n,o,r={}){const i=r.extraAttributes||[],l=r.onAttributeChange||null,c=r.onSubtreeChange||null,s=r.onInit||null,u=r.onAttrChange||null,a=r.effects||null,d=r.attributes||null,f=d?Q(d):a,de=d?new Set(Object.keys(d)):null,ae=r.persist||null;function g(_){const w=_||document.body;if(y(w,e,t,n),d&&O())for(const h in d){const we=d[h],v=Array.from(w.querySelectorAll("["+h+"]"));w.matches&&w.matches("["+h+"]")&&v.push(w);for(let S=0;S<v.length;S++){const k=v[S];p(k)&&T(we,k.getAttribute(h),h,o,k)}}s&&s(w)}const A=[];if(e.indexOf("[")!==-1){const _=/\[([\w-]+)/g;let w;for(;(w=_.exec(e))!==null;)A.push(w[1])}else A.push(e);X({selector:e,attribute:t,componentTag:o,attributes:d,ComponentFn:n,onInit:s,observed:A.concat(i),onAttributeChange:l,onAttrChange:u,effects:f,declared:de,persist:ae}),Y();const fe=e.indexOf("[")!==-1||e.indexOf(".")!==-1||e.indexOf("#")!==-1?e:"["+e+"]";R().push({selector:e,attribute:t,ComponentFn:n,onInit:s,onSubtreeChange:c,query:fe}),ee(),window[t]=g;function F(){G()>0?J(function(){g(document.body)}):g(document.body)}return document.readyState==="loading"?document.addEventListener("DOMContentLoaded",F):F(),g}function q(e){return(e||"").replace(/^#/,"")}function m(e){const t=e===void 0?location.hash:e,n={},o=q(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 c=l.indexOf(":"),s=c>-1?l.slice(0,c):l,u=c>-1?l.slice(c+1):"";if(s)try{n[s]=decodeURIComponent(u)}catch{n[s]=u}}return n}function ne(e){if(!e)return null;const t=m();return e in t?t[e]:null}function oe(e,t){if(!e)return;const n=m();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("&");q(location.hash)!==r&&(location.hash=r)}function re(e){return e.button===1||e.ctrlKey||e.metaKey||e.shiftKey?!1:(e.preventDefault(),!0)}function ie(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 le(e,t){return!t||t==="none"||e===null||e===void 0?null:String(e)+"."+t}function se(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 ce(e,t){return!e||!Array.isArray(t)||t.length===0?null:e+":"+t.map(encodeURIComponent).join(",")}function ue(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=m,window.lnCore.hashGet=ne,window.lnCore.hashSet=oe,window.lnCore.hashLinkClick=re,window.lnCore.resolveHashNamespace=ie,window.lnCore.hashSortEncode=le,window.lnCore.hashSortDecode=se,window.lnCore.hashFilterEncode=ce,window.lnCore.hashFilterDecode=ue),(function(){const e="data-ln-autoresize",t="lnAutoresize";if(window[t]!==void 0)return;const n={"data-ln-autoresize":{type:"marker",description:"Automatically adjusts textarea height to match its scrollable content"}};function o(r){if(r.tagName!=="TEXTAREA")return console.warn("[ln-autoresize] Can only be applied to <textarea>, got:",r.tagName),this;this.dom=r;const i=this;return this._onInput=function(){i._resize()},r.addEventListener("input",this._onInput),this._resize(),this}o.prototype._resize=function(){this.dom.style.height="auto",this.dom.style.height=this.dom.scrollHeight+"px"},o.prototype.destroy=function(){this.dom[t]&&(this.dom.removeEventListener("input",this._onInput),this.dom.style.height="",delete this.dom[t])},te(e,t,o,"ln-autoresize",{attributes:n})})()})();

package/components/ln-autoresize/ln-autoresize.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-autoresize",
+	"generator": "scripts/sync-ln-schemas.mjs",
+	"attributes": {
+		"data-ln-autoresize": {
+			"direction": null,
+			"sources": [
+				"ln-autoresize-dev.scss",
+				"src/ln-autoresize.js"
+			],
+			"type": "marker",
+			"description": "Automatically adjusts textarea height to match its scrollable content"
+		},
+		"data-ln-debug": {
+			"direction": null,
+			"sources": [
+				"ln-autoresize-dev.scss"
+			]
+		}
+	}
+}

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

@@ -6,6 +6,11 @@ import { registerComponent } from '../../ln-core';
 
 	if (window[DOM_ATTRIBUTE] !== undefined) return;
 
+	// ─── Attribute Contract (SSOT) ──────────────────────────
+	const ATTRIBUTES = {
+		'data-ln-autoresize': { type: 'marker', description: 'Automatically adjusts textarea height to match its scrollable content' }
+	};
+
 	// ─── Component ─────────────────────────────────────────────
 
 	function _component(dom) {
@@ -43,5 +48,7 @@ import { registerComponent } from '../../ln-core';
 
 	// ─── Init ──────────────────────────────────────────────────
 
-	registerComponent(DOM_SELECTOR, DOM_ATTRIBUTE, _component, 'ln-autoresize');
+	registerComponent(DOM_SELECTOR, DOM_ATTRIBUTE, _component, 'ln-autoresize', {
+		attributes: ATTRIBUTES
+	});
 })();