@livenetworks/ashlar 1.6.0 → 2.0.0

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

@@ -1,4 +1,5 @@
 import { dispatch, registerComponent } from '../../ln-core';
+import { hasInitialValue, isFieldValid, resolveActiveErrorKeys } from './validate-model.js';
 
 (function () {
 	const DOM_SELECTOR = 'data-ln-validate';
@@ -8,18 +9,15 @@ import { dispatch, registerComponent } from '../../ln-core';
 	const CSS_VALID = 'ln-validate-valid';
 	const CSS_INVALID = 'ln-validate-invalid';
 
-	const ERROR_MAP = {
-		required: 'valueMissing',
-		typeMismatch: 'typeMismatch',
-		tooShort: 'tooShort',
-		tooLong: 'tooLong',
-		patternMismatch: 'patternMismatch',
-		rangeUnderflow: 'rangeUnderflow',
-		rangeOverflow: 'rangeOverflow'
-	};
-
 	if (window[DOM_ATTRIBUTE] !== undefined) return;
 
+	// ─── Attribute Contract (SSOT) ──────────────────────────
+	const ATTRIBUTES = {
+		'data-ln-validate':        { type: 'marker', description: 'Activates validation on form input or field' },
+		'data-ln-validate-errors': { type: 'marker', description: 'Container element holding validation error message elements' },
+		'data-ln-validate-error':  { type: 'string', description: 'Identifies error message template for a specific validation rule' }
+	};
+
 	// ─── Component ─────────────────────────────────────────────
 
 	function _component(dom) {
@@ -67,7 +65,6 @@ import { dispatch, registerComponent } from '../../ln-core';
 					if (el) el.classList.add('hidden');
 				}
 			} else {
-				// clear all custom errors
 				self._customErrors.forEach(function (err) {
 					if (parent) {
 						const el = parent.querySelector('[' + ERROR_SELECTOR + '="' + err + '"]');
@@ -76,7 +73,6 @@ import { dispatch, registerComponent } from '../../ln-core';
 				});
 				self._customErrors.clear();
 			}
-			// Re-run native validation to update visual state
 			if (self._touched) self.validate();
 		};
 
@@ -89,8 +85,6 @@ import { dispatch, registerComponent } from '../../ln-core';
 
 		const form = dom.form;
 		if (form) {
-			// One validated field is enough to own the form's gate —
-			// browser bubbles must yield to ln-validate's own error display.
 			if (!form.hasAttribute('novalidate')) {
 				form.setAttribute('novalidate', '');
 			}
@@ -108,16 +102,6 @@ import { dispatch, registerComponent } from '../../ln-core';
 			form.addEventListener('reset', this._onFormReset);
 			form.addEventListener('ln-validate:request-validate', this._onValidateRequest);
 
-			// Submit gate — attached once per form, by whichever validated
-			// field initializes first (marker lives on the form itself,
-			// same one-shot-guard shape as ln-fill's _fillBound). Runs on
-			// every method, GET included — this is a straight replacement
-			// for the native browser validation `novalidate` just silenced
-			// above, and native validation never had a method condition
-			// either. ln-data-coordinator's own POST/PUT/PATCH method gate
-			// for the write pipeline is a separate, later decision — it
-			// reads e.defaultPrevented first, so it never claims a submit
-			// this gate already blocked.
 			if (!form._lnValidateGateBound) {
 				form._lnValidateGateBound = true;
 				form.addEventListener('submit', function (e) {
@@ -131,23 +115,24 @@ import { dispatch, registerComponent } from '../../ln-core';
 						});
 						validationDetail.invalidFields[0].focus();
 					}
-					// Valid — nothing left to do. Native submit continues;
-					// ln-data-coordinator (document, bubble phase) or plain
-					// HTML/ln-ajax decides what happens to it next.
 				});
 			}
 		}
 
+		if (hasInitialValue(dom)) {
+			this._touched = true;
+			this.validate();
+		}
+
 		return this;
 	}
 
 	_component.prototype.validate = function () {
 		const dom = this.dom;
 		const validity = dom.validity;
-		const nativeValid = dom.checkValidity();
-		const isValid = nativeValid && this._customErrors.size === 0;
+		const isValid = isFieldValid(validity, this._customErrors.size);
+		const activeErrors = resolveActiveErrorKeys(validity, this._customErrors);
 
-		// Show/hide error messages
 		const parent = dom.closest('.form-element');
 		if (parent) {
 			const errorList = parent.querySelector('[' + ERRORS_SELECTOR + ']');
@@ -155,27 +140,17 @@ import { dispatch, registerComponent } from '../../ln-core';
 				const items = errorList.querySelectorAll('[' + ERROR_SELECTOR + ']');
 				for (let i = 0; i < items.length; i++) {
 					const errorKey = items[i].getAttribute(ERROR_SELECTOR);
-					const validityProp = ERROR_MAP[errorKey];
-					if (!validityProp) continue; // custom error — managed by set-custom/clear-custom
-					if (validity[validityProp]) {
-						items[i].classList.remove('hidden');
-					} else {
-						items[i].classList.add('hidden');
-					}
+					items[i].classList.toggle('hidden', !activeErrors.includes(errorKey));
 				}
 			}
 		}
 
-		// Toggle CSS classes on input
 		dom.classList.toggle(CSS_VALID, isValid);
 		dom.classList.toggle(CSS_INVALID, !isValid);
-
-		// Manage ARIA invalid attribute
 		dom.setAttribute('aria-invalid', isValid ? 'false' : 'true');
 
-		// Emit event
 		const eventName = isValid ? 'ln-validate:valid' : 'ln-validate:invalid';
-		dispatch(dom, eventName, { target: dom, field: dom.name });
+		dispatch(dom, eventName, { target: dom, field: dom.name, errors: activeErrors });
 
 		return isValid;
 	};
@@ -196,7 +171,9 @@ import { dispatch, registerComponent } from '../../ln-core';
 	};
 
 	Object.defineProperty(_component.prototype, 'isValid', {
-		get: function () { return this.dom.checkValidity() && this._customErrors.size === 0; }
+		get: function () {
+			return isFieldValid(this.dom.validity, this._customErrors.size);
+		}
 	});
 
 	_component.prototype.destroy = function () {
@@ -214,11 +191,12 @@ import { dispatch, registerComponent } from '../../ln-core';
 
 		this.dom.classList.remove(CSS_VALID, CSS_INVALID);
 		this.dom.removeAttribute('aria-invalid');
-		dispatch(this.dom, 'ln-validate:destroyed', { target: this.dom });
 		delete this.dom[DOM_ATTRIBUTE];
 	};
 
 	// ─── Init ──────────────────────────────────────────────────
 
-	registerComponent(DOM_SELECTOR, DOM_ATTRIBUTE, _component, 'ln-validate');
+	registerComponent(DOM_SELECTOR, DOM_ATTRIBUTE, _component, 'ln-validate', {
+		attributes: ATTRIBUTES
+	});
 })();

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

@@ -0,0 +1,64 @@
+export const ERROR_MAP = {
+	required: 'valueMissing',
+	typeMismatch: 'typeMismatch',
+	tooShort: 'tooShort',
+	tooLong: 'tooLong',
+	patternMismatch: 'patternMismatch',
+	rangeUnderflow: 'rangeUnderflow',
+	rangeOverflow: 'rangeOverflow'
+};
+
+/**
+ * Checks if a field is valid given its native validity state and custom errors count.
+ * @param {{ valid?: boolean } | null | undefined} validityState
+ * @param {number} [customErrorsCount=0]
+ * @returns {boolean}
+ */
+export function isFieldValid(validityState, customErrorsCount = 0) {
+	if (!validityState) return customErrorsCount === 0;
+	return Boolean(validityState.valid && customErrorsCount === 0);
+}
+
+/**
+ * Whether a field already holds a value at init, so it is validated up front.
+ * A checkbox or radio always carries a `value` ("on" by default) — only its
+ * `checked` state says whether anything was chosen.
+ * @param {{ type?: string, value?: string, checked?: boolean }} field
+ * @returns {boolean}
+ */
+export function hasInitialValue(field) {
+	if (field.type === 'checkbox' || field.type === 'radio') return Boolean(field.checked);
+	return Boolean(field.value && field.value.trim() !== '');
+}
+
+/**
+ * Resolves all active error keys for a given validity state and custom errors set.
+ * @param {Record<string, boolean>} validityState
+ * @param {Set<string>|Array<string>} [customErrors]
+ * @returns {string[]}
+ */
+export function resolveActiveErrorKeys(validityState, customErrors) {
+	const active = [];
+
+	if (validityState) {
+		const keys = Object.keys(ERROR_MAP);
+		for (let i = 0; i < keys.length; i++) {
+			const errorKey = keys[i];
+			const prop = ERROR_MAP[errorKey];
+			if (validityState[prop]) {
+				active.push(errorKey);
+			}
+		}
+	}
+
+	if (customErrors) {
+		const customList = Array.from(customErrors);
+		for (let i = 0; i < customList.length; i++) {
+			if (customList[i] && active.indexOf(customList[i]) === -1) {
+				active.push(customList[i]);
+			}
+		}
+	}
+
+	return active;
+}

package/components/ln-websocket-connector/README.md

@@ -0,0 +1,166 @@
+# `data-ln-websocket-connector`
+
+> Applied to an element inside a `ln-data-coordinator`. Opens a WebSocket, turns server pushes into
+> `ln-websocket-connector:fetched`, and answers the same request events as `ln-api-connector` and
+> `ln-couchdb-connector`. Connection status is private state announced by events — never an attribute.
+
+A zero-dependency push transport. Beside a REST connector it only delivers live changes; on its own
+it carries reads, writes and pushes over one socket.
+
+---
+
+## Declarative DOM Setup
+
+### Live changes beside REST
+
+The REST connector takes every request; the socket only pushes changes into the store.
+
+```html
+<ul data-ln-data-coordinator="tasks" hidden>
+	<li data-ln-data-store="tasks" id="tasks"></li>
+	<li data-ln-api-connector data-ln-api-base-url="https://api.example.com" data-ln-api-path="tasks"></li>
+	<li data-ln-websocket-connector data-ln-websocket-connector-url="wss://api.example.com/live"></li>
+</ul>
+```
+
+### Socket alone
+
+With no REST or CouchDB connector in the coordinator, the socket takes every request too.
+
+```html
+<ul data-ln-data-coordinator="tasks" hidden>
+	<li data-ln-data-store="tasks" id="tasks"></li>
+	<li data-ln-websocket-connector data-ln-websocket-connector-url="wss://api.example.com/live"></li>
+</ul>
+```
+
+---
+
+## Attributes
+
+Both attributes are commands set from outside; the component obeys them.
+
+| Attribute | Values | Default | Description |
+|-----------|--------|---------|-------------|
+| `data-ln-websocket-connector` | `connect` \| `disconnect` | `connect` | Opens or closes the socket. A bare attribute connects. |
+| `data-ln-websocket-connector-url` | `ws://…` \| `wss://…` | — | Endpoint. Changing it while connected closes and reopens on the new URL. |
+
+There is no attribute for the connection status. `connecting`, `connected` and `disconnected` are
+what the component observes, not something anyone can set — writing `connected` into an attribute
+would not connect anything. The status is announced by events; whoever listens decides how to show it.
+
+---
+
+## DOM Events
+
+### Commands (dispatched TO the connector)
+
+Only the `ln-websocket-connector:*` namespace is handled.
+
+| Event | `detail` | Description |
+|-------|----------|-------------|
+| `ln-websocket-connector:request-sync` | `{ since, meta? }` | Delta sync since a token. |
+| `ln-websocket-connector:request-query` | `{ query, meta? }` | One page of a query (`search`, `filters`, `sort`, `offset`, `limit`). |
+| `ln-websocket-connector:request-create` | `{ data, tempId?, idempotencyKey?, meta? }` | Create a record. |
+| `ln-websocket-connector:request-update` | `{ id, data, expected_version?, idempotencyKey?, meta? }` | Update a record. |
+| `ln-websocket-connector:request-delete` | `{ id, idempotencyKey?, meta? }` | Delete a record. |
+| `ln-websocket-connector:request-bulk-delete` | `{ ids, idempotencyKey?, meta? }` | Delete several records. |
+
+### Notifications (emitted BY the connector)
+
+| Event | `detail` | Description |
+|-------|----------|-------------|
+| `ln-websocket-connector:connecting` | `{ url, attempt }` | A connection attempt starts. `attempt` counts from 1 and resets on open. |
+| `ln-websocket-connector:connected` | `{ url }` | The socket is open. |
+| `ln-websocket-connector:disconnected` | `{ url, code, reason, willReconnect }` | The socket closed, or a pending reconnect was cancelled. |
+| `ln-websocket-connector:fetched` | `{ data, since, meta }` / `{ data, total, filtered, offset, queryGen, meta }` | A sync reply, a query page, or a server push (`meta: null`). |
+| `ln-websocket-connector:created` | `{ record, tempId, message, meta }` | Create confirmed. |
+| `ln-websocket-connector:updated` | `{ record, id, message, meta }` | Update confirmed. |
+| `ln-websocket-connector:deleted` | `{ response, id, message, meta }` | Delete confirmed. |
+| `ln-websocket-connector:bulk-deleted` | `{ response, ids, message, meta }` | Bulk delete confirmed. |
+| `ln-websocket-connector:error` | `{ action, error, status, data, conflictData, meta, … }` | A rejected request, or one that could not be delivered (`status: 0`). |
+
+`meta` is echoed unchanged and never leaves the page.
+
+---
+
+## Wire Protocol
+
+JSON text frames.
+
+**Request** — `{ "ref": "<string>", "type": "<type>", ...payload }`
+
+| `type` | payload |
+|--------|---------|
+| `sync` | `since` |
+| `query` | `query` |
+| `create` | `data`, `idempotencyKey` |
+| `update` | `id`, `data`, `expected_version`, `idempotencyKey` |
+| `delete` | `id`, `idempotencyKey` |
+| `bulk-delete` | `ids`, `idempotencyKey` |
+
+**Reply** — the same `ref`, then either `{ "ok": true, "content": …, "message": … }` or
+`{ "ok": false, "status": 409, "error": "…", "data": … }`. `content` is `{ data, deleted, synced_at }`
+for `sync`, `{ data, total, filtered }` for `query`, the record for `create` / `update`, and the
+server response for `delete` / `bulk-delete`. `message` is the same opaque toast payload as the REST
+`{ message, content }` envelope.
+
+**Push** — no `ref`: `{ "type": "changes", "data": [...], "deleted": [...], "synced_at": … }`.
+
+`synced_at` is the same token the REST delta takes as `since`. Beside REST, a push advances the
+store's `lastSyncedAt`, and the next REST sync sends it — the server must keep both in one currency.
+
+---
+
+## Coordinator Integration
+
+`ln-data-coordinator` needs no wiring:
+
+- **Request connector:** `[data-ln-api-connector]` or `[data-ln-couchdb-connector]` when present,
+  otherwise `[data-ln-websocket-connector]`.
+- **Pushes:** `:fetched` without `meta.kind` goes to `store.applySync` — upsert plus delete, the path
+  CouchDB sync already uses. Bound tables and lists refresh on `ln-data-store:synced`.
+- **Catch-up:** on every `:connected` the coordinator runs `store.forceSync()`, a delta since
+  `lastSyncedAt`, over whichever connector takes requests.
+
+### Showing the status
+
+The coordinator does not render connection status. Page wiring listens and draws it — here with
+an app-owned `data-status`, since app state stays out of `data-ln-*`:
+
+```js
+const chip = document.getElementById('tasks-status');
+['connecting', 'connected', 'disconnected'].forEach(function (status) {
+	coordinatorEl.addEventListener('ln-websocket-connector:' + status, function () {
+		chip.setAttribute('data-status', status);
+	});
+});
+```
+
+---
+
+## 🔧 Internals
+
+Source: `components/ln-websocket-connector/src/ln-websocket-connector.js`.
+
+### Requests while not connected
+
+- **Command `connect`, socket not open** (first connect, or between reconnect attempts): the request
+  is held and sent in order on open. `:connected` is dispatched before the flush, so the coordinator's
+  catch-up sync sees the store already syncing and does not send a second one.
+- **Command `disconnect`:** the request fails at once with `:error { status: 0 }`.
+- **Socket closes with replies outstanding:** each one fails with `:error { status: 0 }`. The
+  coordinator treats status 0 as transient and never deletes local data on it.
+
+### Reconnect
+
+An unexpected close while the command is `connect` retries after 1 s, doubling up to 30 s, and the
+counter resets on a successful open. `new WebSocket()` throwing synchronously (an invalid URL, or
+`ws://` blocked on an `https://` page) is not retried: retrying cannot fix it. The component reports
+`:disconnected { willReconnect: false }`; a new URL or a new `connect` command opens again.
+
+### Teardown
+
+`destroy()` closes the socket, clears the reconnect timer, removes the request listeners and
+deletes the instance. It dispatches nothing, so held and outstanding requests are discarded, not
+failed.

package/components/ln-websocket-connector/ln-websocket-connector.js

@@ -0,0 +1 @@
+(function(){"use strict";function I(){return typeof window>"u"?!1:window.lnDebug===!0||window.lnCore&&window.lnCore._debugSink?!0:typeof document<"u"&&document.body?document.body.hasAttribute("data-ln-debug")||document.body.querySelector("[data-ln-debug]")!==null:!1}function k(e){if(typeof window>"u")return!1;if(window.lnDebug===!0)return!0;if(window.lnCore&&window.lnCore._debugIsContained)return e?window.lnCore._debugIsContained(e):window.lnCore._debugSink!==null;if(e&&e.closest){const t=e.closest("[data-ln-debug]");return!(!t||typeof document<"u"&&t===document.documentElement)}return typeof document<"u"&&document.body?document.body.hasAttribute("data-ln-debug"):!1}if(typeof window<"u"&&(window.lnCore=window.lnCore||{},!window.lnCore._warnBound)){window.lnCore._warnBound=!0;const e=console.warn;console.warn=function(...t){if(typeof t[0]=="string"&&(t[0].startsWith("[ln-")||t[0].startsWith("[lnCore"))){let o=null;for(let r=1;r<t.length;r++)if(t[r]&&t[r].nodeType===1){o=t[r];break}if(!k(o))return}e.apply(console,t)}}function b(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 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 $={};function H(e,t){$[e]=t}function U(e){return $[e]||{ingress:t=>t,egress:t=>t}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerDataMapper=H,window.lnCore.getDataMapper=U);function J(){typeof window>"u"||(window.lnCore=window.lnCore||{},!window.lnCore._localeObserverBound&&(window.lnCore._localeObserverBound=!0,C(function(){new MutationObserver(function(){b(document,"ln-core:locale-change",{})}).observe(document.documentElement,{attributes:!0,attributeFilter:["lang"],subtree:!0})},"ln-core")))}const N={};function P(e,t){if(!e||typeof t!="object")return;const n=e.toLowerCase().split("-")[0];N[n]=t}function Q(e){if(!e)return null;const t=e.toLowerCase().split("-")[0];return N[t]||null}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerLocaleFallback=P,window.lnCore.getLocaleFallback=Q,window.lnCore.ensureLocaleObserver=J);const A={};function G(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 D(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],d=a.getAttribute("data-ln-field");t[d]!=null&&(a.textContent=t[d])}const o=e.querySelectorAll("[data-ln-attr]");for(let l=0;l<o.length;l++){const a=o[l],d=a.getAttribute("data-ln-attr").split(",");for(let h=0;h<d.length;h++){const u=d[h].trim().split(":");if(u.length!==2)continue;const i=u[0].trim(),c=u[1].trim();t[c]!=null&&a.setAttribute(i,t[c])}}const r=e.querySelectorAll("[data-ln-show]");for(let l=0;l<r.length;l++){const a=r[l],d=a.getAttribute("data-ln-show");d in t&&a.classList.toggle("hidden",!t[d])}const s=e.querySelectorAll("[data-ln-class]");for(let l=0;l<s.length;l++){const a=s[l],d=a.getAttribute("data-ln-class").split(",");for(let h=0;h<d.length;h++){const u=d[h].trim().split(":");if(u.length!==2)continue;const i=u[0].trim(),c=u[1].trim();c in t&&a.classList.toggle(i,!!t[c])}}return e}function X(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)D(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 M(e,t){if(!e||!t)return e;const n=document.createTreeWalker(e,NodeFilter.SHOW_TEXT);for(;n.nextNode();){const s=n.currentNode;s.textContent.indexOf("{{")!==-1&&(s.textContent=s.textContent.replace(/\{\{\s*(\w+)\s*\}\}/g,function(l,a){return t[a]!==void 0?t[a]:""}))}const o=function(s,l){return t[l]!==void 0?t[l]:""},r=Array.from(e.querySelectorAll("*"));e.nodeType===1&&r.push(e);for(let s=0;s<r.length;s++){const l=r[s],a=l.attributes;for(let d=0;d<a.length;d++){const h=a[d];h.value.indexOf("{{")!==-1&&l.setAttribute(h.name,h.value.replace(/\{\{\s*(\w+)\s*\}\}/g,o))}}return e}function z(e,t,n,o,r,s){const l={};for(let d=0;d<e.children.length;d++){const h=e.children[d],u=h.getAttribute("data-ln-render-key");u&&(l[u]=h)}const a=document.createDocumentFragment();for(let d=0;d<t.length;d++){const h=t[d],u=String(o(h));let i=l[u];if(i)r(i,h,d);else{const c=G(n,s);if(!c||(M(c,h),i=c.firstElementChild,!i))continue;i.setAttribute("data-ln-render-key",u),r(i,h,d)}a.appendChild(i)}e.textContent="",e.appendChild(a)}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.fillTemplate=M,window.lnCore.fill=D,window.lnCore.lnFill=X,window.lnCore.renderList=z);function v(e,t,n){const o=e.getAttribute(t);return o===null?n:o}function Y(e,t,n){const o=parseInt(e.getAttribute(t),10);return isNaN(o)?n:o}function Z(e,t,n=!1){const o=e.getAttribute(t);if(o===null)return!!n;const r=o.trim().toLowerCase();return!(r==="false"||r==="0")}function ee(e,t){return(e.getAttribute(t)||"").split(",").map(n=>n.trim()).filter(Boolean)}const S=new Map;function te(e,t){const n=(e?e.join("|"):"")+"::"+t;if(S.has(n))return S.get(n);const o=new Set(e||[]),r=function(s,l){const a=s.getAttribute(l);return a!==null&&o.has(a)?a:t};return S.set(n,r),r}function ne(e,t,n){const o=parseFloat(e.getAttribute(t));return isNaN(o)?n:o}function oe(e,t,n){const o=e.getAttribute(t);if(!o)return n;try{return JSON.parse(o)}catch{return n}}function F(e,t,n,o,r){if(!e||t===null)return!0;const s=o||"ln-component",l=e.type;if(l==="trigger"||l==="marker"||l==="string"||l==="list"||!l||t===""&&e.fallback!==void 0)return!0;const a=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"?(a(`[${s}] 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:(a(`[${s}] Invalid value "${t}" for attribute "${n}". Allowed: ${d.join(", ")}. Fallback: "${e.fallback}".`),!1)}if(l==="integer"){if(!/^-?\d+$/.test(t))return a(`[${s}] Invalid integer "${t}" for attribute "${n}". Fallback: ${e.fallback}.`),!1;const d=parseInt(t,10);return e.min!==void 0&&d<e.min?(a(`[${s}] Value ${d} for attribute "${n}" is less than min (${e.min}).`),!1):e.max!==void 0&&d>e.max?(a(`[${s}] Value ${d} for attribute "${n}" is greater than max (${e.max}).`),!1):!0}if(l==="float")return isNaN(Number(t))?(a(`[${s}] Invalid float "${t}" for attribute "${n}". Fallback: ${e.fallback}.`),!1):!0;if(l==="json")try{return JSON.parse(t),!0}catch(d){return a(`[${s}] Invalid JSON for attribute "${n}": ${d.message}. Fallback: ${e.fallback}.`),!1}return!0}function re(e,t,n){for(const o in n){const[r,s,l]=n[o];Object.defineProperty(e,o,{get:function(){return r(t,s,l)},enumerable:!0,configurable:!0})}return e}function ie(e){const t={};for(const n in e){const o=e[n];if(!o||!o.prop)continue;let r=o.read;if(!r&&o.type)switch(o.type){case"enum":r=te(o.values,o.fallback);break;case"integer":r=Y;break;case"float":r=ne;break;case"boolean":r=Z;break;case"list":r=ee;break;case"json":r=oe;break;case"string":default:r=v;break}r||(r=v),t[o.prop]=[r,n,o.fallback]}return t}function se(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 le(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 O(e,t,n,o){if(e.nodeType!==1)return;const s=t.indexOf("[")!==-1||t.indexOf(".")!==-1||t.indexOf("#")!==-1?t:"["+t+"]",l=Array.from(e.querySelectorAll(s));e.matches&&e.matches(s)&&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 o(a)}catch(d){console.error("["+n+"] init failed",a,d)}}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore._bootHolds=window.lnCore._bootHolds||0,window.lnCore._bootQueue=window.lnCore._bootQueue||[]);function ce(){return typeof window<"u"&&window.lnCore&&window.lnCore._bootHolds||0}function de(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 B(){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=B(),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(s=>s.componentTag===e.componentTag)||r.push({spec:e.attributes[o],componentTag:e.componentTag})}if(e.onAttrChange||e.effects){t.reactive.push(e);const o=le(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 W(e,t,n,o){for(let r=0;r<e.length;r++){const s=e[r];if(!t[s.attribute])continue;const l=s.effects&&s.effects[n];l?l(t,n,o):s.onAttrChange&&(!s.declared||s.declared.has(n))&&s.onAttrChange(t,n,o)}}function ue(e){const t=e.target,n=e.attributeName;if(e.oldValue===t.getAttribute(n))return;const o=B(),r=o.byAttr.get(n);if(I()&&o.byDeclaredAttr&&o.byDeclaredAttr.has(n)&&k(t)){const s=o.byDeclaredAttr.get(n),l=t.getAttribute(n);for(let a=0;a<s.length;a++)F(s[a].spec,l,n,s[a].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 s=o.byReactive.get(n);s&&W(s,t,n,e.oldValue),o.reactiveWildcard.length&&W(o.reactiveWildcard,t,n,e.oldValue)}if(r)for(let s=0;s<r.length;s++){const l=r[s];if(l.handler){l.handler(t,n,e.oldValue);continue}l.onAttributeChange&&t[l.attribute]?l.onAttributeChange(t,n):(O(t,l.selector,l.attribute,l.ComponentFn),l.onInit&&l.onInit(t))}}function fe(){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{ue(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 j(){return window.lnCore=window.lnCore||{},window.lnCore._lifecycleRegistry=window.lnCore._lifecycleRegistry||[]}function he(e){const t=j();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,s=e.target.nodeType===1?e.target.matches(r)?e.target:e.target.closest(r):e.target.parentElement?e.target.parentElement.closest(r):null;s&&o.onSubtreeChange(s,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 s=t[r];O(o,s.selector,s.attribute,s.ComponentFn),s.onInit&&s.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 s=t[r],l=s.query,a=Array.from(o.querySelectorAll(l));o.matches&&o.matches(l)&&a.push(o);for(let d=0;d<a.length;d++){const h=a[d];if(!document.contains(h)){const u=h[s.attribute];if(u&&typeof u.destroy=="function")try{u.destroy()}catch(i){console.error("["+s.attribute+"] destroy failed",h,i)}delete h[s.attribute]}}}}}}function we(){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 o=t[n];if(o.type==="childList")try{he(o)}catch(r){console.error("[ln-core] lifecycle handler failed",o.target,r)}}}).observe(document.body,{childList:!0,subtree:!0})},"ln-core"))}function pe(e,t,n,o,r={}){const s=r.extraAttributes||[],l=r.onAttributeChange||null,a=r.onSubtreeChange||null,d=r.onInit||null,h=r.onAttrChange||null,u=r.effects||null,i=r.attributes||null,c=i?se(i):u,f=i?new Set(Object.keys(i)):null,p=r.persist||null;function w(x){const m=x||document.body;if(O(m,e,t,n),i&&I())for(const _ in i){const ve=i[_],R=Array.from(m.querySelectorAll("["+_+"]"));m.matches&&m.matches("["+_+"]")&&R.push(m);for(let T=0;T<R.length;T++){const L=R[T];k(L)&&F(ve,L.getAttribute(_),_,o,L)}}d&&d(m)}const g=[];if(e.indexOf("[")!==-1){const x=/\[([\w-]+)/g;let m;for(;(m=x.exec(e))!==null;)g.push(m[1])}else g.push(e);ae({selector:e,attribute:t,componentTag:o,attributes:i,ComponentFn:n,onInit:d,observed:g.concat(s),onAttributeChange:l,onAttrChange:h,effects:c,declared:f,persist:p}),fe();const y=e.indexOf("[")!==-1||e.indexOf(".")!==-1||e.indexOf("#")!==-1?e:"["+e+"]";j().push({selector:e,attribute:t,ComponentFn:n,onInit:d,onSubtreeChange:a,query:y}),we(),window[t]=w;function V(){ce()>0?de(function(){w(document.body)}):w(document.body)}return document.readyState==="loading"?document.addEventListener("DOMContentLoaded",V):V(),w}function K(e){return(e||"").replace(/^#/,"")}function q(e){const t=e===void 0?location.hash:e,n={},o=K(t);if(!o)return n;const r=o.split("&");for(let s=0;s<r.length;s++){const l=r[s];if(!l)continue;const a=l.indexOf(":"),d=a>-1?l.slice(0,a):l,h=a>-1?l.slice(a+1):"";if(d)try{n[d]=decodeURIComponent(h)}catch{n[d]=h}}return n}function be(e){if(!e)return null;const t=q();return e in t?t[e]:null}function ge(e,t){if(!e)return;const n=q();t==null?delete n[e]:n[e]=String(t);const r=Object.keys(n).map(function(s){const l=n[s];return l===""?s:s+":"+encodeURIComponent(l)}).join("&");K(location.hash)!==r&&(location.hash=r)}function me(e){return e.button===1||e.ctrlKey||e.metaKey||e.shiftKey?!1:(e.preventDefault(),!0)}function ye(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 _e(e,t){return!t||t==="none"||e===null||e===void 0?null:String(e)+"."+t}function Ce(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 ke(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),o=e.slice(t+1),r=o?o.split(",").map(function(s){try{return decodeURIComponent(s)}catch{return s}}).filter(Boolean):[];return{key:n,values:r}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.hashParse=q,window.lnCore.hashGet=be,window.lnCore.hashSet=ge,window.lnCore.hashLinkClick=me,window.lnCore.resolveHashNamespace=ye,window.lnCore.hashSortEncode=_e,window.lnCore.hashSortDecode=Ce,window.lnCore.hashFilterEncode=ke,window.lnCore.hashFilterDecode=Ae),(function(){const e="data-ln-websocket-connector",t="lnWebsocketConnector";if(window[t]!==void 0)return;const n=1e3,o=3e4;function r(i){const c=i[t];c&&(c.command==="connect"?c._open():c._disconnect())}function s(i){const c=i[t];!c||c.command!=="connect"||(c._drop("url-changed"),c._open())}const l={"data-ln-websocket-connector":{prop:"command",type:"enum",values:["connect","disconnect"],fallback:"connect",effect:r,description:"Connection command set from outside: connect or disconnect"},"data-ln-websocket-connector-url":{prop:"url",read:v,type:"string",fallback:"",effect:s,description:"WebSocket endpoint URL (ws:// or wss://)"}},a=ie(l),d={"ln-websocket-connector:request-sync":"sync","ln-websocket-connector:request-query":"query","ln-websocket-connector:request-create":"create","ln-websocket-connector:request-update":"update","ln-websocket-connector:request-delete":"delete","ln-websocket-connector:request-bulk-delete":"bulk-delete"};function h(i,c){return i==="sync"?{since:c.since}:i==="query"?{query:c.query||{}}:i==="create"?{data:c.data,idempotencyKey:c.idempotencyKey}:i==="update"?{id:c.id,data:c.data,expected_version:c.expected_version,idempotencyKey:c.idempotencyKey}:i==="delete"?{id:c.id,idempotencyKey:c.idempotencyKey}:{ids:c.ids,idempotencyKey:c.idempotencyKey}}function u(i){this.dom=i,re(this,i,a),i[t]=this,this._socket=null,this._status="disconnected",this._attempt=0,this._timer=null,this._seq=0,this._pending=new Map,this._held=[];const c=this;this._onRequest=function(f){c._request(d[f.type],f.detail||{})};for(const f in d)i.addEventListener(f,this._onRequest);return this.command==="connect"&&this._open(),this}u.prototype._open=function(){if(this._socket||this._timer)return;const i=this,c=this.url;this._attempt++,this._status="connecting",b(this.dom,"ln-websocket-connector:connecting",{url:c,attempt:this._attempt});let f;try{f=new WebSocket(c)}catch(p){this._status="disconnected",this._attempt=0,this._failAll(this._held,p.message),this._held=[],b(this.dom,"ln-websocket-connector:disconnected",{url:c,code:0,reason:p.message,willReconnect:!1});return}this._socket=f,f.onopen=function(){i._status="connected",i._attempt=0,b(i.dom,"ln-websocket-connector:connected",{url:c});const p=i._held;i._held=[];for(let w=0;w<p.length;w++)i._send(p[w])},f.onmessage=function(p){i._receive(p.data)},f.onclose=function(p){i._socket=null,i._status="disconnected",i._failPending("connection closed");const w=i.command==="connect";b(i.dom,"ln-websocket-connector:disconnected",{url:c,code:p.code,reason:p.reason,willReconnect:w}),w&&i._scheduleReconnect()}},u.prototype._scheduleReconnect=function(){const i=this,c=Math.min(n*Math.pow(2,Math.max(0,this._attempt-1)),o);this._timer=setTimeout(function(){i._timer=null,i._open()},c)},u.prototype._drop=function(i){const c=!!(this._socket||this._timer);clearTimeout(this._timer),this._timer=null,this._attempt=0,this._socket&&(this._socket.onopen=this._socket.onmessage=this._socket.onclose=null,this._socket.close(1e3,i),this._socket=null),c&&(this._status="disconnected",this._failPending("connection closed"),b(this.dom,"ln-websocket-connector:disconnected",{url:this.url,code:1e3,reason:i,willReconnect:!1}))},u.prototype._disconnect=function(){this._drop("disconnect"),this._failAll(this._held,"disconnected"),this._held=[]},u.prototype._request=function(i,c){const f={ref:String(++this._seq),type:i,detail:c};this._status==="connected"?this._send(f):this.command==="connect"?this._held.push(f):this._fail(f,0,"disconnected",null)},u.prototype._send=function(i){this._pending.set(i.ref,i),this._socket.send(JSON.stringify(Object.assign({ref:i.ref,type:i.type},h(i.type,i.detail))))},u.prototype._receive=function(i){let c;try{c=JSON.parse(i)}catch{console.warn("[ln-websocket-connector] Ignored a frame that is not JSON:",i);return}if(c.ref!==void 0){const f=this._pending.get(String(c.ref));if(!f)return;this._pending.delete(f.ref),c.ok?this._resolve(f,c.content,c.message||null):this._fail(f,c.status||0,c.error,c.data);return}c.type==="changes"&&b(this.dom,"ln-websocket-connector:fetched",{data:{data:c.data||[],deleted:c.deleted||[],synced_at:c.synced_at},since:null,meta:null})},u.prototype._resolve=function(i,c,f){const p=i.detail,w=p.meta||null,g=this.dom;if(i.type==="sync")b(g,"ln-websocket-connector:fetched",{data:c,since:p.since,meta:w});else if(i.type==="query"){const E=p.query||{},y=c||{};b(g,"ln-websocket-connector:fetched",{data:y.data||[],total:y.total,filtered:y.filtered,offset:E.offset,queryGen:E.queryGen,meta:w})}else i.type==="create"?b(g,"ln-websocket-connector:created",{record:c,tempId:p.tempId,message:f,meta:w}):i.type==="update"?b(g,"ln-websocket-connector:updated",{record:c,id:p.id,message:f,meta:w}):i.type==="delete"?b(g,"ln-websocket-connector:deleted",{response:c,id:p.id,message:f,meta:w}):b(g,"ln-websocket-connector:bulk-deleted",{response:c,ids:p.ids,message:f,meta:w})},u.prototype._fail=function(i,c,f,p){const w=i.detail;b(this.dom,"ln-websocket-connector:error",{action:i.type,error:f,status:c,data:p||null,conflictData:c===409&&p||null,since:w.since,id:w.id,ids:w.ids,tempId:w.tempId,meta:w.meta||null})},u.prototype._failAll=function(i,c){for(let f=0;f<i.length;f++)this._fail(i[f],0,c,null)},u.prototype._failPending=function(i){const c=Array.from(this._pending.values());this._pending.clear(),this._failAll(c,i)},u.prototype.destroy=function(){if(this.dom[t]){for(const i in d)this.dom.removeEventListener(i,this._onRequest);clearTimeout(this._timer),this._timer=null,this._socket&&(this._socket.onopen=this._socket.onmessage=this._socket.onclose=null,this._socket.close(1e3,"destroy"),this._socket=null),this._pending.clear(),this._held=[],delete this.dom[t]}},pe(e,t,u,"ln-websocket-connector",{attributes:l})})()})();

package/components/ln-websocket-connector/ln-websocket-connector.schema.json

@@ -0,0 +1,29 @@
+{
+	"$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-websocket-connector",
+	"generator": "scripts/sync-ln-schemas.mjs",
+	"attributes": {
+		"data-ln-websocket-connector": {
+			"direction": null,
+			"sources": [
+				"src/ln-websocket-connector.js"
+			],
+			"type": "enum",
+			"values": [
+				"connect",
+				"disconnect"
+			],
+			"fallback": "connect",
+			"description": "Connection command set from outside: connect or disconnect"
+		},
+		"data-ln-websocket-connector-url": {
+			"direction": null,
+			"sources": [
+				"src/ln-websocket-connector.js"
+			],
+			"type": "string",
+			"fallback": "",
+			"description": "WebSocket endpoint URL (ws:// or wss://)"
+		}
+	}
+}