@livenetworks/ashlar 1.6.1 → 2.0.1

package/{js → components}/ln-data-coordinator/src/mutation-receipts.js

@@ -4,11 +4,6 @@ export class MutationReceipts {
 	}
 
 	wait(requestId) {
-		if (!requestId) return Promise.reject(new Error('Mutation requestId is required'));
-		if (this._pending.has(requestId)) {
-			return Promise.reject(new Error(`Duplicate mutation requestId: ${requestId}`));
-		}
-
 		return new Promise((resolve, reject) => {
 			this._pending.set(requestId, { resolve, reject });
 		});

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

@@ -1,19 +1,22 @@
 # ln-data-store
 
-A zero-dependency, local-first **Database Cache Store** backed by standard browser `IndexedDB`. It acts as a pure client-side database cache, maintaining records locally, executing high-performance querying in-memory, and applying optimistic mutations directly — a record is a record, with no pending state, snapshots, or rollback machinery.
-
-It possesses no visual interface and is **completely blind to the network** (no fetch, status codes, paths, or URLs). Instead, it communicates strictly via custom DOM events, allowing the parent **Data Coordinator** to orchestrate syncs and mutations.
+> Applied to a hidden element via `data-ln-data-store id="name"`. It initializes and queries an IndexedDB database
+> (`ln_app_cache`) with automatic schema upgrades and optional AES-GCM encryption. It is completely blind to the network:
+> listening for request CustomEvents (`ln-data-store:request-query`, `request-save`, `request-delete`), resolving results
+> against local records, and emitting `ln-data-store:stale` when cached data exceeds its configured timeout.
 
 ---
 
 ## 📦 Declarative Setup in HTML
 
 ```html
-<div data-ln-data-store="documents"
-     data-ln-data-store-stale="300"
-     data-ln-data-store-indexes="status,department,updated_at"
-     data-ln-data-store-search-fields="title,owner">
-</div>
+<ul id="documents"
+    data-ln-data-store
+    data-ln-data-store-stale="300"
+    data-ln-data-store-indexes="status,department,updated_at"
+    data-ln-data-store-search-fields="title,owner"
+    hidden>
+</ul>
 ```
 
 ---
@@ -22,10 +25,15 @@ It possesses no visual interface and is **completely blind to the network** (no
 
 | Attribute | Description | Default |
 |---|---|---|
-| `data-ln-data-store="name"` | Declares the store name. | *Required* |
+| `id="name"` | Unique identifier of the store (the store name). | *Required* |
+| `data-ln-data-store` | Marker attribute to declare the component. | *Required* |
 | `data-ln-data-store-stale="N"` | Seconds before cache is considered stale. Set to `never` or `-1` to disable staleness. | `300` |
 | `data-ln-data-store-indexes="…"` | Comma-separated list of IndexedDB index fields. | `""` |
 | `data-ln-data-store-search-fields="…"` | Comma-separated list of text-search fields for local query search matching. | `""` |
+| `data-ln-data-store-window="N"` | Enables windowed residency mode. Caps how many records stay resident — both the LRU position index and the records held in IndexedDB. | *Disabled* |
+| `data-ln-data-store-window-page="N"` | Page size of slices requested from the server. | `200` |
+| `data-ln-data-store-no-local-query` | Leave queries to the server: the store stops answering reads from its own records. Read live, so it can be flipped per situation. | *Absent* |
+| `data-ln-data-store-frozen` | **Runtime-written, dev-only.** Set by the component itself when `data-ln-data-store` or `-indexes` is edited after init; surfaced as a dev-only diagnostic banner (`[data-ln-debug]`). Not authored. | *Absent* |
 
 ---
 
@@ -35,7 +43,7 @@ It possesses no visual interface and is **completely blind to the network** (no
 
 - **Dynamic Schema Discovery:** Upon initialization, the component scans the document for all `[data-ln-data-store]` elements. It collects their store names and index definitions.
 - **Auto Upgrade:** If new stores or indexes are declared in the HTML markup, the component closes the active connection, increments the database version, and dynamically creates the missing stores and indexes in `onupgradeneeded`.
-- **Memory Fallback:** If the browser does not support IndexedDB, or if database open/upgrade operations fail/are blocked, the component transparently falls back to an in-memory data store.
+- **Initialization Failure:** If the browser does not support IndexedDB, or if database open/upgrade operations fail/are blocked, the component fails initialization, sets `initializationError`, and dispatches `ln-data-store:initialization-error`. There is no in-memory fallback; consumers are responsible for handling storage unavailability.
 
 ---
 
@@ -54,7 +62,7 @@ The store supports local record encryption to secure cached data in IndexedDB:
 Access the database layer directly via the `lnDataStore` property on the store container element:
 
 ```javascript
-const storeEl = document.querySelector('[data-ln-data-store="documents"]');
+const storeEl = document.getElementById('documents');
 const store = storeEl.lnDataStore;
 ```
 
@@ -89,10 +97,11 @@ store.setPresenters({
 });
 ```
 
-### 3. Public Methods
+### 3. Public Properties & Methods
 
-| Method | Return Type | Description |
+| Property/Method | Type / Return Type | Description |
 |---|---|---|
+| `query` | `Object` | Active query filters and search terms: `{ filters: {}, search: '' }`. |
 | `getAll(options)` | `Promise<Object>` | Retrieves records. Options support `sort` (`{ field, direction }`), `filters` (`{ field: Array }`), `search` (`String`), `offset`, `limit`. Returns `{ data, total, filtered }`. |
 | `getById(id)` | `Promise<Object\|null>` | Returns a single record (decorated with presenters) or `null`. |
 | `count(filters)` | `Promise<Number>` | Returns the total count of records. If filters are provided, returns the filtered count. |
@@ -103,11 +112,26 @@ store.setPresenters({
 | `fullReload()` | `Promise<void>` | Clears the IndexedDB store, resets sync metadata, and triggers a sync. |
 | `destroy()` | `void` | Cleans up the instance, removes event listeners, and deletes the DOM reference. |
 
+### 4. Windowed Residency (Virtualization)
+
+When `data-ln-data-store-window` is present, the store operates in windowed residency mode. The server is the authority on record order: the store keeps a memory index of logical positions to record IDs (`Map<position, id>`) capped at the window size. A view's range request is resolved through that index and materialised from IndexedDB; a missing page dispatches `ln-data-store:request-page`. Records the index evicts are deleted from IndexedDB too, so the window bounds what is stored, not only what is positioned. Only IDs the index itself placed can be evicted, so a locally created record the server has not positioned is never dropped.
+
+A query change resets the index — positions are query-relative and become meaningless. Until the server's first page for the new query lands, the store answers from the records it already holds and marks the answer **provisional**: rows only, no totals. Counts and scroll geometry hold at whatever the last authoritative answer established, and the server's answer supersedes the provisional one at the next generation. The local pass stops as soon as the requested slice is full, so its cost tracks the viewport rather than the store.
+
+`data-ln-data-store-no-local-query` turns that off: the store reports the window as unresolved and the view waits for the server. Already-positioned rows are still served from cache — those are the server's own answer, only materialised locally.
+
+Windowed residency and coordinator autosync are mutually exclusive in practice: a full sync inserts records the index never positioned, which the window cannot bound.
+
 ---
 
 ## ⚡ DOM Events
 
-### Commands (Listened to by the Store)
+### Commands & Query Events (Listened to by the Store)
+
+| Event | `e.detail` payload | Description |
+|---|---|---|
+| `ln-search:change` | `{ term }` | Updates the active `query.search` term and dispatches `ln-data-store:query-changed`. |
+| `ln-filter:change` | `{ key, values, targetId }` | Updates the active `query.filters[key]` and dispatches `ln-data-store:query-changed`. |
 
 All mutations must be routed via DOM events. **Never invoke write methods directly.** The caller is responsible for supplying a `tempId` (e.g. `'_temp_' + crypto.randomUUID()`) when creating records:
 
@@ -158,6 +182,8 @@ These events bubble up and can be listened to by coordinators or rendering views
 
 | Event | `e.detail` payload | Description |
 |---|---|---|
+| `ln-data-store:request-page` | `{ store, offset, limit, query, queryGen }` | Dispatched in windowed residency when pages within the sliding window are missing and must be fetched from the server. |
+| `ln-data-store:query-changed` | `{ store, query }` | Emitted when store search query or column filters change. |
 | `ln-data-store:initialized` | `{ store, hasCache, lastSyncedAt, count }` | Emitted once after IndexedDB connection opens. The instance's `ready` promise resolves after this state is committed. |
 | `ln-data-store:initialization-error` | `{ store, error }` | IndexedDB could not be initialized. `ready` still resolves after `initializationError` is set, allowing a coordinator to route reads to its connector. |
 | `ln-data-store:ready` | `{ store, count, source }` | Emitted when data is ready. `source` is `'cache'` (init) or `'server'` (first sync). |
@@ -167,7 +193,6 @@ These events bubble up and can be listened to by coordinators or rendering views
 | `ln-data-store:deleted` | `{ store, id \| ids, requestId? }` | Emitted after optimistic delete or bulk delete. |
 | `ln-data-store:synced` | `{ store, added, deleted, changed }` | Emitted after subsequent delta sync merges. |
 | `ln-data-store:sync-error` | `{ store, error, status }` | A connector sync failed; `isSyncing` has been cleared so online/visibility retry can proceed. |
-| `ln-data-store:destroyed` | `{ store }` | Emitted when the store instance is destroyed. |
 | `ln-data-store:mutation-error` | `{ store, action, requestId, error }` | A serialized local mutation failed. `requestId` lets a coordinator correlate reconciliation failures. |
 
 ### Global System Events
@@ -189,7 +214,7 @@ These events bubble up and can be listened to by coordinators or rendering views
 
 ## 🔧 Internals
 
-Source: `js/ln-data-store/ln-data-store.js`.
+Source: `components/ln-data-store/ln-data-store.js`.
 
 ### Shared IndexedDB connection
 
@@ -234,7 +259,7 @@ The store renders nothing. Its only DOM-side effects: attaches `request-*` liste
 
 ### Mutation error reconciliation
 
-`ln-data-store` has no concept of "confirm" or "revert" — a `request-update`/`request-delete` is applied unconditionally to the local cache. Reconciling server-side mutation errors (retry, drop, conflict-server-wins, auth-pause) is `ln-data-coordinator`'s job — see [`js/ln-data-coordinator/README.md`](../ln-data-coordinator/README.md) §Error reconciliation policy.
+`ln-data-store` has no concept of "confirm" or "revert" — a `request-update`/`request-delete` is applied unconditionally to the local cache. Reconciling server-side mutation errors (retry, drop, conflict-server-wins, auth-pause) is `ln-data-coordinator`'s job — see [`components/ln-data-coordinator/README.md`](../ln-data-coordinator/README.md) §Error reconciliation policy.
 
 ### At-rest encryption reference
 

package/components/ln-data-store/ln-data-store-dev.scss

@@ -0,0 +1,13 @@
+@use '../../theme/config/mixins' as *;
+
+[data-ln-debug] {
+	// 1. Store Table Name Check: data-ln-data-store requires an ID to serve as the store table name
+	[data-ln-data-store]:not([id]) {
+		@include dev-dom-error("[data-ln-data-store] requires a unique 'id' attribute as store table name.");
+	}
+
+	// 2. Frozen Attribute Edit: the IndexedDB schema and store name are fixed at init time
+	[data-ln-data-store][data-ln-data-store-frozen] {
+		@include dev-dom-error("data-ln-data-store / -indexes are read once at init — the IndexedDB schema can only change in a versionchange transaction. Reload to apply.");
+	}
+}

package/components/ln-data-store/ln-data-store.js

@@ -0,0 +1 @@
+(function(){"use strict";function ie(){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 Z(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 n=e.closest("[data-ln-debug]");return!(!n||typeof document<"u"&&n===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(...n){if(typeof n[0]=="string"&&(n[0].startsWith("[ln-")||n[0].startsWith("[lnCore"))){let i=null;for(let a=1;a<n.length;a++)if(n[a]&&n[a].nodeType===1){i=n[a];break}if(!Z(i))return}e.apply(console,n)}}function v(e,n,o){const i=o||{};window.lnCore._debugSink&&window.lnCore._debugSink("event",n,e,i),e.dispatchEvent(new CustomEvent(n,{bubbles:!0,detail:i}))}function G(e,n){if(!document.body){document.addEventListener("DOMContentLoaded",function(){G(e,n)}),console.warn("["+n+'] Script loaded before <body> — add "defer" to your <script> tag');return}e()}const ae={};function qe(e,n){ae[e]=n}function Le(e){return ae[e]||{ingress:n=>n,egress:n=>n}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerDataMapper=qe,window.lnCore.getDataMapper=Le);function Ne(){typeof window>"u"||(window.lnCore=window.lnCore||{},!window.lnCore._localeObserverBound&&(window.lnCore._localeObserverBound=!0,G(function(){new MutationObserver(function(){v(document,"ln-core:locale-change",{})}).observe(document.documentElement,{attributes:!0,attributeFilter:["lang"],subtree:!0})},"ln-core")))}const se={};function De(e,n){if(!e||typeof n!="object")return;const o=e.toLowerCase().split("-")[0];se[o]=n}function Te(e){if(!e)return null;const n=e.toLowerCase().split("-")[0];return se[n]||null}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerLocaleFallback=De,window.lnCore.getLocaleFallback=Te,window.lnCore.ensureLocaleObserver=Ne);const X={};function ze(e,n){X[e]||(X[e]=document.querySelector('[data-ln-template="'+e+'"]'));const o=X[e];return o?o.content.cloneNode(!0):(console.warn("["+(n||"ln-core")+'] Template "'+e+'" not found'),null)}function le(e,n){if(!e||!n)return e;const o=e.querySelectorAll("[data-ln-field]");for(let c=0;c<o.length;c++){const f=o[c],h=f.getAttribute("data-ln-field");n[h]!=null&&(f.textContent=n[h])}const i=e.querySelectorAll("[data-ln-attr]");for(let c=0;c<i.length;c++){const f=i[c],h=f.getAttribute("data-ln-attr").split(",");for(let p=0;p<h.length;p++){const b=h[p].trim().split(":");if(b.length!==2)continue;const _=b[0].trim(),k=b[1].trim();n[k]!=null&&f.setAttribute(_,n[k])}}const a=e.querySelectorAll("[data-ln-show]");for(let c=0;c<a.length;c++){const f=a[c],h=f.getAttribute("data-ln-show");h in n&&f.classList.toggle("hidden",!n[h])}const s=e.querySelectorAll("[data-ln-class]");for(let c=0;c<s.length;c++){const f=s[c],h=f.getAttribute("data-ln-class").split(",");for(let p=0;p<h.length;p++){const b=h[p].trim().split(":");if(b.length!==2)continue;const _=b[0].trim(),k=b[1].trim();k in n&&f.classList.toggle(_,!!n[k])}}return e}function Oe(e,n){e.matches&&e.matches("[data-ln-form], [data-ln-fillable]")&&(window.lnCore._debugSink&&window.lnCore._debugSink("event","ln-fill",e,n??null),e.dispatchEvent(new CustomEvent("ln-fill",{detail:n??null,bubbles:!0})));const o=e.querySelectorAll("[data-ln-form], [data-ln-fillable]");for(let i=0;i<o.length;i++)window.lnCore._debugSink&&window.lnCore._debugSink("event","ln-fill",o[i],n??null),o[i].dispatchEvent(new CustomEvent("ln-fill",{detail:n??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)le(e.target,e.detail);else{const n=e.target.querySelectorAll("[data-ln-field]");for(let o=0;o<n.length;o++)n[o].textContent=""}})));function ce(e,n){if(!e||!n)return e;const o=document.createTreeWalker(e,NodeFilter.SHOW_TEXT);for(;o.nextNode();){const s=o.currentNode;s.textContent.indexOf("{{")!==-1&&(s.textContent=s.textContent.replace(/\{\{\s*(\w+)\s*\}\}/g,function(c,f){return n[f]!==void 0?n[f]:""}))}const i=function(s,c){return n[c]!==void 0?n[c]:""},a=Array.from(e.querySelectorAll("*"));e.nodeType===1&&a.push(e);for(let s=0;s<a.length;s++){const c=a[s],f=c.attributes;for(let h=0;h<f.length;h++){const p=f[h];p.value.indexOf("{{")!==-1&&c.setAttribute(p.name,p.value.replace(/\{\{\s*(\w+)\s*\}\}/g,i))}}return e}function Re(e,n,o,i,a,s){const c={};for(let h=0;h<e.children.length;h++){const p=e.children[h],b=p.getAttribute("data-ln-render-key");b&&(c[b]=p)}const f=document.createDocumentFragment();for(let h=0;h<n.length;h++){const p=n[h],b=String(i(p));let _=c[b];if(_)a(_,p,h);else{const k=ze(o,s);if(!k||(ce(k,p),_=k.firstElementChild,!_))continue;_.setAttribute("data-ln-render-key",b),a(_,p,h)}f.appendChild(_)}e.textContent="",e.appendChild(f)}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.fillTemplate=ce,window.lnCore.fill=le,window.lnCore.lnFill=Oe,window.lnCore.renderList=Re);function ue(e,n,o){const i=e.getAttribute(n);return i===null?o:i}function Y(e,n,o){const i=parseInt(e.getAttribute(n),10);return isNaN(i)?o:i}function de(e,n,o=!1){const i=e.getAttribute(n);if(i===null)return!!o;const a=i.trim().toLowerCase();return!(a==="false"||a==="0")}function fe(e,n){return(e.getAttribute(n)||"").split(",").map(o=>o.trim()).filter(Boolean)}const ee=new Map;function Pe(e,n){const o=(e?e.join("|"):"")+"::"+n;if(ee.has(o))return ee.get(o);const i=new Set(e||[]),a=function(s,c){const f=s.getAttribute(c);return f!==null&&i.has(f)?f:n};return ee.set(o,a),a}function Be(e,n,o){const i=parseFloat(e.getAttribute(n));return isNaN(i)?o:i}function Me(e,n,o){const i=e.getAttribute(n);if(!i)return o;try{return JSON.parse(i)}catch{return o}}function he(e,n,o,i,a){if(!e||n===null)return!0;const s=i||"ln-component",c=e.type;if(c==="trigger"||c==="marker"||c==="string"||c==="list"||!c||n===""&&e.fallback!==void 0)return!0;const f=h=>{a?console.warn(h,a):console.warn(h)};if(c==="boolean"){const h=n.trim().toLowerCase();return h!==""&&h!=="true"&&h!=="false"&&h!=="1"&&h!=="0"?(f(`[${s}] Invalid value "${n}" for boolean attribute "${o}". Allowed: "true", "false", or presence-only.`),!1):!0}if(c==="enum"){const h=e.values||[];return h.includes(n)?!0:(f(`[${s}] Invalid value "${n}" for attribute "${o}". Allowed: ${h.join(", ")}. Fallback: "${e.fallback}".`),!1)}if(c==="integer"){if(!/^-?\d+$/.test(n))return f(`[${s}] Invalid integer "${n}" for attribute "${o}". Fallback: ${e.fallback}.`),!1;const h=parseInt(n,10);return e.min!==void 0&&h<e.min?(f(`[${s}] Value ${h} for attribute "${o}" is less than min (${e.min}).`),!1):e.max!==void 0&&h>e.max?(f(`[${s}] Value ${h} for attribute "${o}" is greater than max (${e.max}).`),!1):!0}if(c==="float")return isNaN(Number(n))?(f(`[${s}] Invalid float "${n}" for attribute "${o}". Fallback: ${e.fallback}.`),!1):!0;if(c==="json")try{return JSON.parse(n),!0}catch(h){return f(`[${s}] Invalid JSON for attribute "${o}": ${h.message}. Fallback: ${e.fallback}.`),!1}return!0}function Fe(e,n,o){for(const i in o){const[a,s,c]=o[i];Object.defineProperty(e,i,{get:function(){return a(n,s,c)},enumerable:!0,configurable:!0})}return e}function je(e){const n={};for(const o in e){const i=e[o];if(!i||!i.prop)continue;let a=i.read;if(!a&&i.type)switch(i.type){case"enum":a=Pe(i.values,i.fallback);break;case"integer":a=Y;break;case"float":a=Be;break;case"boolean":a=de;break;case"list":a=fe;break;case"json":a=Me;break;case"string":default:a=ue;break}a||(a=ue),n[i.prop]=[a,o,i.fallback]}return n}function $e(e){const n={};for(const o in e){const i=e[o];i&&i.effect&&(n[o]=i.effect)}return Object.keys(n).length?n:null}function Ke(e){if(e.onAttrChange&&!e.declared)return null;const n=new Set;if(e.effects)for(const o in e.effects)n.add(o);if(e.onAttrChange&&e.declared)for(const o of e.declared)n.add(o);return n}function te(e,n,o,i){if(e.nodeType!==1)return;const s=n.indexOf("[")!==-1||n.indexOf(".")!==-1||n.indexOf("#")!==-1?n:"["+n+"]",c=Array.from(e.querySelectorAll(s));e.matches&&e.matches(s)&&c.push(e);for(const f of c)if(!f[o]){window.lnCore._persistSink&&f.hasAttribute("data-ln-persist")&&window.lnCore._persistSink(f,n);try{f[o]=new i(f)}catch(h){console.error("["+o+"] init failed",f,h)}}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore._bootHolds=window.lnCore._bootHolds||0,window.lnCore._bootQueue=window.lnCore._bootQueue||[]);function Ve(){return typeof window<"u"&&window.lnCore&&window.lnCore._bootHolds||0}function Ge(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 we(){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 He(e){const n=we(),o=e.observed||[];for(let i=0;i<o.length;i++){const a=o[i];n.byAttr.has(a)||n.byAttr.set(a,[]),n.byAttr.get(a).push(e)}if(n.byDeclaredAttr=n.byDeclaredAttr||new Map,e.attributes)for(const i in e.attributes){n.byDeclaredAttr.has(i)||n.byDeclaredAttr.set(i,[]);const a=n.byDeclaredAttr.get(i);a.some(s=>s.componentTag===e.componentTag)||a.push({spec:e.attributes[i],componentTag:e.componentTag})}if(e.onAttrChange||e.effects){n.reactive.push(e);const i=Ke(e);if(i===null)n.reactiveWildcard.push(e);else for(const a of i)n.byReactive.has(a)||n.byReactive.set(a,[]),n.byReactive.get(a).push(e)}e.persist&&n.persist.push(e)}function ye(e,n,o,i){for(let a=0;a<e.length;a++){const s=e[a];if(!n[s.attribute])continue;const c=s.effects&&s.effects[o];c?c(n,o,i):s.onAttrChange&&(!s.declared||s.declared.has(o))&&s.onAttrChange(n,o,i)}}function We(e){const n=e.target,o=e.attributeName;if(e.oldValue===n.getAttribute(o))return;const i=we(),a=i.byAttr.get(o);if(ie()&&i.byDeclaredAttr&&i.byDeclaredAttr.has(o)&&Z(n)){const s=i.byDeclaredAttr.get(o),c=n.getAttribute(o);for(let f=0;f<s.length;f++)he(s[f].spec,c,o,s[f].componentTag,n)}if(window.lnCore._debugSink&&(o.indexOf("data-ln-")===0||a)&&window.lnCore._debugSink("attr",o,n,{oldValue:e.oldValue,newValue:n.getAttribute(o)}),o.indexOf("data-ln-")===0){const s=i.byReactive.get(o);s&&ye(s,n,o,e.oldValue),i.reactiveWildcard.length&&ye(i.reactiveWildcard,n,o,e.oldValue)}if(a)for(let s=0;s<a.length;s++){const c=a[s];if(c.handler){c.handler(n,o,e.oldValue);continue}c.onAttributeChange&&n[c.attribute]?c.onAttributeChange(n,o):(te(n,c.selector,c.attribute,c.ComponentFn),c.onInit&&c.onInit(n))}}function Ue(){window.lnCore=window.lnCore||{},!window.lnCore._attrObserverBound&&(window.lnCore._attrObserverBound=!0,G(function(){new MutationObserver(function(n){for(let o=0;o<n.length;o++)try{We(n[o])}catch(i){console.error("[ln-core] mutation handler failed",n[o].target,i)}}).observe(document.body,{attributes:!0,subtree:!0,attributeOldValue:!0})},"ln-core"))}function pe(){return window.lnCore=window.lnCore||{},window.lnCore._lifecycleRegistry=window.lnCore._lifecycleRegistry||[]}function Qe(e){const n=pe();if(n.length){if(e.target)for(let o=0;o<n.length;o++){const i=n[o];if(i.onSubtreeChange){const a=i.query,s=e.target.nodeType===1?e.target.matches(a)?e.target:e.target.closest(a):e.target.parentElement?e.target.parentElement.closest(a):null;s&&i.onSubtreeChange(s,e)}}for(let o=0;o<e.addedNodes.length;o++){const i=e.addedNodes[o];if(i.nodeType===1)for(let a=0;a<n.length;a++){const s=n[a];te(i,s.selector,s.attribute,s.ComponentFn),s.onInit&&s.onInit(i)}}for(let o=0;o<e.removedNodes.length;o++){const i=e.removedNodes[o];if(i.nodeType===1)for(let a=0;a<n.length;a++){const s=n[a],c=s.query,f=Array.from(i.querySelectorAll(c));i.matches&&i.matches(c)&&f.push(i);for(let h=0;h<f.length;h++){const p=f[h];if(!document.contains(p)){const b=p[s.attribute];if(b&&typeof b.destroy=="function")try{b.destroy()}catch(_){console.error("["+s.attribute+"] destroy failed",p,_)}delete p[s.attribute]}}}}}}function Je(){window.lnCore=window.lnCore||{},!window.lnCore._lifecycleObserverBound&&(window.lnCore._lifecycleObserverBound=!0,G(function(){new MutationObserver(function(n){for(let o=0;o<n.length;o++){const i=n[o];if(i.type==="childList")try{Qe(i)}catch(a){console.error("[ln-core] lifecycle handler failed",i.target,a)}}}).observe(document.body,{childList:!0,subtree:!0})},"ln-core"))}function Ze(e,n,o,i,a={}){const s=a.extraAttributes||[],c=a.onAttributeChange||null,f=a.onSubtreeChange||null,h=a.onInit||null,p=a.onAttrChange||null,b=a.effects||null,_=a.attributes||null,k=_?$e(_):b,R=_?new Set(Object.keys(_)):null,P=a.persist||null;function g(E){const I=E||document.body;if(te(I,e,n,o),_&&ie())for(const B in _){const H=_[B],$=Array.from(I.querySelectorAll("["+B+"]"));I.matches&&I.matches("["+B+"]")&&$.push(I);for(let F=0;F<$.length;F++){const O=$[F];Z(O)&&he(H,O.getAttribute(B),B,i,O)}}h&&h(I)}const S=[];if(e.indexOf("[")!==-1){const E=/\[([\w-]+)/g;let I;for(;(I=E.exec(e))!==null;)S.push(I[1])}else S.push(e);He({selector:e,attribute:n,componentTag:i,attributes:_,ComponentFn:o,onInit:h,observed:S.concat(s),onAttributeChange:c,onAttrChange:p,effects:k,declared:R,persist:P}),Ue();const q=e.indexOf("[")!==-1||e.indexOf(".")!==-1||e.indexOf("#")!==-1?e:"["+e+"]";pe().push({selector:e,attribute:n,ComponentFn:o,onInit:h,onSubtreeChange:f,query:q}),Je(),window[n]=g;function A(){Ve()>0?Ge(function(){g(document.body)}):g(document.body)}return document.readyState==="loading"?document.addEventListener("DOMContentLoaded",A):A(),g}function Xe(e){let n=!1;for(let o=0;o<e.length;o++){const i=e[o];if(!(i===""||i==null)&&(n=!0,!Number.isFinite(Number(i))))return"string"}return n?"number":"string"}function Ye(e,n,o,i){if(o==="number"){const c=parseFloat(e),f=parseFloat(n);return(isNaN(c)?0:c)-(isNaN(f)?0:f)}const a=e!=null?String(e):"",s=n!=null?String(n):"";return i?i.compare(a,s):a<s?-1:a>s?1:0}function ge(e){return(e||"").replace(/^#/,"")}function ne(e){const n=e===void 0?location.hash:e,o={},i=ge(n);if(!i)return o;const a=i.split("&");for(let s=0;s<a.length;s++){const c=a[s];if(!c)continue;const f=c.indexOf(":"),h=f>-1?c.slice(0,f):c,p=f>-1?c.slice(f+1):"";if(h)try{o[h]=decodeURIComponent(p)}catch{o[h]=p}}return o}function et(e){if(!e)return null;const n=ne();return e in n?n[e]:null}function tt(e,n){if(!e)return;const o=ne();n==null?delete o[e]:o[e]=String(n);const a=Object.keys(o).map(function(s){const c=o[s];return c===""?s:s+":"+encodeURIComponent(c)}).join("&");ge(location.hash)!==a&&(location.hash=a)}function nt(e){return e.button===1||e.ctrlKey||e.metaKey||e.shiftKey?!1:(e.preventDefault(),!0)}function rt(e,n){if(!e||!e.hasAttribute("data-ln-hash"))return null;const o=e.getAttribute("data-ln-hash");if(o&&o.trim()!=="")return o.trim();const i=e.getAttribute("data-ln-sort")||e.getAttribute("data-ln-search-for")||e.getAttribute("data-ln-search")||e.getAttribute("data-ln-filter")||e.id;return i?n?i+"-"+n:i:n||null}function ot(e,n){return!n||n==="none"||e===null||e===void 0?null:String(e)+"."+n}function it(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 at(e,n){return!e||!Array.isArray(n)||n.length===0?null:e+":"+n.map(encodeURIComponent).join(",")}function st(e){if(!e||typeof e!="string")return null;const n=e.indexOf(":");if(n===-1)return null;const o=e.slice(0,n),i=e.slice(n+1),a=i?i.split(",").map(function(s){try{return decodeURIComponent(s)}catch{return s}}).filter(Boolean):[];return{key:o,values:a}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.hashParse=ne,window.lnCore.hashGet=et,window.lnCore.hashSet=tt,window.lnCore.hashLinkClick=nt,window.lnCore.resolveHashNamespace=rt,window.lnCore.hashSortEncode=ot,window.lnCore.hashSortDecode=it,window.lnCore.hashFilterEncode=at,window.lnCore.hashFilterDecode=st);let j=null;const lt="ln-ashlar:storage-salt:v1",me=32768;function be(e){let n="";const o=e.byteLength;for(let i=0;i<o;i+=me)n+=String.fromCharCode.apply(null,e.subarray(i,Math.min(i+me,o)));return btoa(n)}function _e(e){const n=atob(e),o=n.length,i=new Uint8Array(o);for(let a=0;a<o;a++)i[a]=n.charCodeAt(a);return i}function Ce(e,n){let o=j,i={};return typeof CryptoKey<"u"&&e instanceof CryptoKey?o=e:e&&typeof e=="object"&&(i=e,typeof CryptoKey<"u"&&i.key instanceof CryptoKey&&(o=i.key)),{key:o,options:i}}async function ct(e,n={}){if(!e)throw new Error("[ln-crypto] Key derivation failed: Secret string is required");const o=n.method||"pbkdf2",i=new TextEncoder;if(o==="sha256"){const h=await crypto.subtle.digest("SHA-256",i.encode(e));return crypto.subtle.importKey("raw",h,{name:"AES-GCM"},!1,["encrypt","decrypt"])}const a=n.salt||lt,s=typeof a=="string"?i.encode(a):a,c=n.iterations||1e5,f=await crypto.subtle.importKey("raw",i.encode(e),"PBKDF2",!1,["deriveKey"]);return crypto.subtle.deriveKey({name:"PBKDF2",salt:s,iterations:c,hash:"SHA-256"},f,{name:"AES-GCM",length:256},!1,["encrypt","decrypt"])}async function Se(e,n={}){if(!e){j=null;return}try{const o=n.method||"sha256";j=await ct(e,{...n,method:o})}catch(o){throw console.error("[ln-core/crypto] Key derivation failed:",o),j=null,o}}function z(){return j}async function ut(e,n,o){const{key:i}=Ce(n);if(e==null)return e;if(!i)throw new Error("[ln-crypto] Encryption failed: No active cryptographic key provided");try{const a=new TextEncoder,s=crypto.getRandomValues(new Uint8Array(12)),c=typeof e=="string"?e:JSON.stringify(e),f=await crypto.subtle.encrypt({name:"AES-GCM",iv:s},i,a.encode(c));return{v:1,alg:"AES-GCM",encrypted:!0,iv:be(s),data:be(new Uint8Array(f))}}catch(a){throw console.error("[ln-core/crypto] Encryption failed:",a),new Error("[ln-crypto] Encryption failed: "+(a&&a.message?a.message:String(a)))}}async function dt(e,n,o){const{key:i,options:a}=Ce(n),s=a.silent===!0;if(!e||!e.encrypted)return e;if(!i){if(s)return{...e,decryptionError:!0};throw new Error("[ln-crypto] Decryption failed: No active cryptographic key provided")}if(!e.iv||!e.data){if(s)return{...e,decryptionError:!0};throw new Error("[ln-crypto] Decryption failed: Malformed envelope (missing iv or data)")}try{const c=new TextDecoder,f=_e(e.iv),h=_e(e.data),p=await crypto.subtle.decrypt({name:"AES-GCM",iv:f},i,h),b=c.decode(p);try{return JSON.parse(b)}catch{return b}}catch(c){if(s)return{...e,decryptionError:!0};throw console.error("[ln-core/crypto] Decryption failed. Key may be incorrect or payload tampered:",c),new Error("[ln-crypto] Decryption failed. Key may be incorrect or payload tampered: "+(c&&c.message?c.message:String(c)))}}function ft(e){return String(e||"").trim().toLowerCase()}function ht(e){const n=ft(e);return n?n.split(/\s+/).filter(Boolean):[]}function wt(e,n){if(!n||n.length===0)return!0;if(!e)return!1;const o=String(e).toLowerCase();for(let i=0;i<n.length;i++)if(o.indexOf(n[i])===-1)return!1;return!0}function yt(e,n){if(!n||n.length===0)return!0;if(e==null)return!1;const o=String(e).trim().toLowerCase();for(let i=0;i<n.length;i++)if(String(n[i]).trim().toLowerCase()===o)return!0;return!1}function pt(e={}){let n=e.windowSize>0?e.windowSize:1e3,o=e.pageSize>0?e.pageSize:200,i=e.fetchDebounce!=null?e.fetchDebounce:120;const a=typeof e.requestPage=="function"?e.requestPage:()=>{},s=new Map,c=new Set;let f=0,h=0,p=0,b=!1,_=null;function k(g,S){s.delete(g),s.set(g,S)}function R(){if(s.size<=n)return[];const g=[];for(;s.size>n;){const L=s.keys().next().value;g.push(s.get(L)),s.delete(L)}const S=new Set(s.values());return g.filter(L=>!S.has(L))}function P(g,S){c.add(g),clearTimeout(_),_=setTimeout(()=>a(g,o,S),i)}return{get logicalTotal(){return f},set logicalTotal(g){f=g},get grandTotal(){return h},set grandTotal(g){h=g},get queryGen(){return p},set queryGen(g){p=g},get size(){return s.size},get hasLoaded(){return b},getId:g=>{if(!s.has(g))return;const S=s.get(g);return k(g,S),S},ensure:(g,S,L)=>{if(!b&&!c.has(0))return P(0,L);if(f<=0)return;const q=Math.max(0,g),A=Math.min(f,S);for(let E=q;E<A;E++)if(!s.has(E)){const I=Math.floor(E/o)*o;if(!c.has(I))return P(I,L)}},ingest:(g,S,L,q,A)=>{if(A!=null&&A!==p)return[];b=!0,L!=null&&(h=L),q!=null&&(f=q);for(let E=0;E<S.length;E++)k(g+E,S[E]);return c.delete(g),R()},reset:function(){p++,this.clear()},clear:()=>{b=!1,s.clear(),c.clear(),clearTimeout(_)},configure:(g={})=>{let S=[];return g.windowSize>0&&g.windowSize!==n&&(n=g.windowSize,S=R()),g.pageSize>0&&(o=g.pageSize),g.fetchDebounce>=0&&(i=g.fetchDebounce),S}}}function gt(e,n,o){if(!Array.isArray(e)||!n||!n.field)return e;const{field:i,direction:a}=n,s=a==="desc",c=e.map(h=>h?h[i]:void 0),f=Xe(c);return[...e].sort((h,p)=>{const b=h?h[i]:void 0,_=p?p[i]:void 0,k=Ye(b,_,f,o);return s?-k:k})}function Ae(e,n){if(!Array.isArray(e)||!n||typeof n!="object")return e;const o=Object.keys(n).filter(i=>Array.isArray(n[i])&&n[i].length>0);return o.length?e.filter(i=>i?o.every(a=>yt(i[a],n[a])):!1):e}function mt(e,n,o){if(!Array.isArray(e)||!n||!o||!o.length)return e;const i=ht(n);return i.length?e.filter(a=>a?i.every(s=>o.some(c=>{const f=a[c];return f!=null&&wt(String(f),[s])})):!1):e}function bt(e,n,o){if(!Array.isArray(e)||!e.length)return 0;if(o==="count")return e.length;const i=e.map(s=>s&&s[n]!=null?parseFloat(s[n]):NaN).filter(s=>Number.isFinite(s)),a=i.reduce((s,c)=>s+c,0);return o==="sum"?a:o==="avg"&&i.length?a/i.length:0}function _t(e,n={},o=[],i){if(!Array.isArray(e))return{records:[],total:0,filtered:0};const a=e.length;let s=e;n.filters&&(s=Ae(s,n.filters)),n.search&&(s=mt(s,n.search,o));const c=s.length;if(n.sort&&(s=gt(s,n.sort,i)),n.offset||n.limit){const f=n.offset||0,h=n.limit||s.length;s=s.slice(f,f+h)}return{records:s,total:a,filtered:c}}function Ct(e,n){return!Array.isArray(e)||!n||typeof n!="object"?e:e.map(o=>{if(!o)return null;const i={...o};for(const[a,s]of Object.entries(n))if(typeof s=="function")try{i[a]=s(o)}catch{i[a]=void 0}return i})}(function(){const e="data-ln-data-store",n="lnDataStore";if(window[n]!==void 0)return;function o(t,r,l){const u=t.getAttribute(r);if(u==="never"||u==="-1")return-1;const d=parseInt(u,10);return isNaN(d)?l:d}const i={"data-ln-data-store":{type:"marker",effect:Ie,description:"Identifies the element as a data-store definition container"},"data-ln-data-store-indexes":{type:"list",effect:Ie,description:"Comma-separated index field names for the IndexedDB store"},"data-ln-data-store-stale":{prop:"_staleThreshold",type:"integer",read:o,fallback:300,description:"Cache staleness threshold in seconds, or -1/never"},"data-ln-data-store-search-fields":{prop:"_searchFields",type:"list",read:fe,description:"Record fields to index for client-side search"},"data-ln-data-store-no-local-query":{prop:"noLocalQuery",type:"boolean",read:de,description:"Bypasses local IndexedDB query resolution, forcing remote fetching"},"data-ln-data-store-window":{prop:"_windowSize",type:"integer",read:Y,fallback:1e3,min:10,effect:jt,description:"Virtual scrolling cache window size in records"},"data-ln-data-store-window-page":{prop:"_windowPageSize",type:"integer",read:Y,fallback:200,min:5,effect:$t,description:"Virtual scrolling slice page size"},"data-ln-data-store-frozen":{type:"marker",description:"Applied at runtime to indicate store schema is locked in IndexedDB"}},a=je(i),s="ln_app_cache",c="_meta",f="1.0";let h=null,p=null;const b={};function _(t){t&&t.name==="QuotaExceededError"&&v(document,"ln-data-store:quota-exceeded",{error:t})}function k(){const t={};for(const r of document.querySelectorAll(`[${e}]`)){const l=r.id;if(l){const u=r.getAttribute("data-ln-data-store-indexes")||"";t[l]={indexes:u.split(",").map(d=>d.trim()).filter(Boolean)}}}return t}function R(){return p||(p=new Promise(t=>{if(typeof indexedDB>"u")return console.warn("[ln-data-store] IndexedDB not available — falling back to in-memory store"),t(null);const r=k(),l=Object.keys(r),u=indexedDB.open(s);u.onerror=()=>{console.warn("[ln-data-store] IndexedDB open failed — falling back to in-memory store"),t(null)},u.onsuccess=d=>{const w=d.target.result,y=Array.from(w.objectStoreNames);if(!(!y.includes(c)||l.some(T=>!y.includes(T))))return P(w),h=w,t(w);const C=w.version;w.close();const x=indexedDB.open(s,C+1);x.onblocked=()=>{console.warn("[ln-data-store] Database upgrade blocked — waiting for other tabs to close connection")},x.onerror=()=>{console.warn("[ln-data-store] Database upgrade failed"),t(null)},x.onupgradeneeded=T=>{const N=T.target.result;N.objectStoreNames.contains(c)||N.createObjectStore(c,{keyPath:"key"});for(const M of l)if(!N.objectStoreNames.contains(M)){const V=N.createObjectStore(M,{keyPath:"id"});for(const oe of r[M].indexes)V.createIndex(oe,oe,{unique:!1})}},x.onsuccess=T=>{const N=T.target.result;P(N),h=N,t(N)}}}),p)}function P(t){t.onversionchange=()=>{t.close(),h=null,p=null}}function g(){return h?Promise.resolve(h):(p=null,R())}async function S(t){if(!z()||!t)return t;const r={...t},l=r.id,u=await ut(r);return!u||!u.encrypted?t:{...u,id:l}}async function L(t){return!t||!t.encrypted||!z()?t:dt(t,{silent:!0})}const q=(t,r)=>g().then(l=>l?l.transaction(t,r).objectStore(t):null);function A(t){return new Promise((r,l)=>{t.onsuccess=()=>r(t.result),t.onerror=()=>{_(t.error),l(t.error)}})}const E=t=>q(t,"readonly").then(r=>r?A(r.getAll()):[]).then(r=>z()?Promise.all(r.map(l=>L(l))):r),I=(t,r)=>q(t,"readonly").then(l=>l?A(l.get(r)).then(u=>u!==void 0?u:typeof r=="string"&&r.trim()!==""&&!isNaN(Number(r))?A(l.get(Number(r))):typeof r=="number"?A(l.get(String(r))):null):null).then(l=>l?L(l):null),B=(t,r)=>g().then(l=>{if(!l)return[];const d=l.transaction(t,"readonly").objectStore(t),w=r.map(y=>A(d.get(y)).then(m=>m!==void 0?m:typeof y=="string"&&y.trim()!==""&&!isNaN(Number(y))?A(d.get(Number(y))):typeof y=="number"?A(d.get(String(y))):null));return Promise.all(w).then(y=>z()?Promise.all(y.map(m=>m?L(m):null)):y)}),H=(t,r)=>(z()?S(r):Promise.resolve(r)).then(u=>q(t,"readwrite").then(d=>d?A(d.put(u)):null)),$=(t,r)=>q(t,"readwrite").then(l=>l?A(l.delete(r)).then(()=>{if(typeof r=="string"&&r.trim()!==""&&!isNaN(Number(r)))return A(l.delete(Number(r)));if(typeof r=="number")return A(l.delete(String(r)))}):null),F=t=>q(t,"readwrite").then(r=>r?A(r.clear()):null),O=t=>q(t,"readonly").then(r=>r?A(r.count()):0),St=t=>q(c,"readonly").then(r=>r?A(r.get(t)):null),W=(t,r)=>q(c,"readwrite").then(l=>{if(l)return r.key=t,A(l.put(r))});function D(t){return this.dom=t,this._name=t.id,this._name||console.warn("[ln-data-store] missing id — the store cannot be addressed",t),Fe(this,t,a),this._handlers=null,this.isLoaded=!1,this.canServe=!1,this.isInitialized=!1,this.initializationError=null,this.hasCache=!1,this.isSyncing=!1,this.lastSyncedAt=null,this.query={filters:{},search:"",sort:null},t.hasAttribute("data-ln-data-store-window")?this._windowIndex=pt({windowSize:this._windowSize,pageSize:this._windowPageSize,requestPage:(r,l,u)=>{v(this.dom,"ln-data-store:request-page",{store:this._name,offset:r,limit:l,query:u,queryGen:this._windowIndex.queryGen})}}):this._windowIndex=null,this.windowed=this._windowIndex!==null,this.totalCount=0,this.presenters=null,this._mutationChain=Promise.resolve(),b[this._name]=this,At(this),this.ready=qt(this),this}function At(t){t._handlers={create:r=>U(t,"create",r.detail,()=>vt(t,r.detail)),update:r=>U(t,"update",r.detail,()=>xt(t,r.detail)),delete:r=>U(t,"delete",r.detail,()=>kt(t,r.detail)),"bulk-delete":r=>U(t,"bulk-delete",r.detail,()=>Et(t,r.detail)),"sync-failed":r=>{t.isSyncing=!1,v(t.dom,"ln-data-store:sync-error",{store:t._name,error:r.detail&&r.detail.error,status:r.detail&&r.detail.status})}};for(const[r,l]of Object.entries(t._handlers))t.dom.addEventListener(`ln-data-store:request-${r}`,l);t._queryHandlers={"ln-search:change":r=>{r.preventDefault();const l=r.detail&&r.detail.term!=null?r.detail.term:"";l!==t.query.search&&(t.query.search=l,re(t))},"ln-filter:change":r=>{r.preventDefault();const l=r.detail&&r.detail.key;if(!l)return;const u=(r.detail.values||[]).slice(),d=t.query.filters[l];(d?d.length===u.length&&d.every((y,m)=>y===u[m]):!u.length)||(u.length?t.query.filters[l]=u:delete t.query.filters[l],re(t))},"ln-sort:change":r=>{r.preventDefault();const l=r.detail&&r.detail.field,u=r.detail&&r.detail.direction,d=u&&u!=="none"?{field:l,direction:u}:null,w=t.query.sort;!w&&!d||w&&d&&w.field===d.field&&w.direction===d.direction||(t.query.sort=d,re(t))}};for(const[r,l]of Object.entries(t._queryHandlers))t.dom.addEventListener(r,l)}function U(t,r,l,u){const d=l&&l.requestId;return t._mutationChain=t._mutationChain.then(()=>t.ready).then(()=>{if(t.initializationError)throw t.initializationError;return u()}).catch(w=>It(t,r,d,w)),t._mutationChain}function Q(t,r=0){return O(t._name).then(l=>{if(t._windowIndex||t.windowed){const u=t.totalCount!=null?t.totalCount:l;t.totalCount=Math.max(0,u+r)}else t.totalCount=l;return t.hasCache=!0,t.isLoaded=!0,t.canServe=!0,W(t._name,{schema_version:f,last_synced_at:t.lastSyncedAt,has_cache:!0,record_count:t.totalCount})})}function vt(t,{tempId:r,data:l={},requestId:u}={}){const d={...l,id:r};return H(t._name,d).then(()=>Q(t,1)).then(()=>{v(t.dom,"ln-data-store:created",{store:t._name,record:d,tempId:r,requestId:u})})}function xt(t,{id:r,data:l={},requestId:u}={}){return I(t._name,r).then(d=>{if(!d)throw new Error(`Record not found: ${r}`);const w=d.id,y={...d,...l,id:w},m=l.id,C=m!==void 0&&m!==w;return(C?Lt(t._name,w,{...y,id:m}):H(t._name,y)).then(()=>Q(t,0)).then(()=>{v(t.dom,"ln-data-store:updated",{store:t._name,record:C?{...y,id:m}:y,previous:d,requestId:u})})})}function kt(t,{id:r,requestId:l}={}){return I(t._name,r).then(u=>{if(!u){v(t.dom,"ln-data-store:deleted",{store:t._name,id:r,requestId:l,missing:!0});return}const d=u.id;return $(t._name,d).then(()=>Q(t,-1)).then(()=>{v(t.dom,"ln-data-store:deleted",{store:t._name,id:d,requestId:l})})})}function Et(t,{ids:r=[],requestId:l}={}){return r.length?Promise.all(r.map(u=>I(t._name,u))).then(u=>{const d=u.filter(Boolean).map(w=>w.id);return J(t._name,d).then(()=>Q(t,-d.length)).then(()=>{v(t.dom,"ln-data-store:deleted",{store:t._name,ids:d,requestId:l})})}):(v(t.dom,"ln-data-store:deleted",{store:t._name,ids:[],requestId:l}),Promise.resolve())}function It(t,r,l,u){console.error("[ln-data-store] "+r+" failed:",u),v(t.dom,"ln-data-store:mutation-error",{store:t._name,action:r,requestId:l,error:u})}function qt(t){return R().then(r=>{if(!r)throw new Error("IndexedDB is unavailable");return St(t._name)}).then(r=>{if(t.initializationError=null,r&&r.schema_version===f)t.lastSyncedAt=r.last_synced_at||null,t.totalCount=r.record_count||0,t.hasCache=r.has_cache===!0||t.totalCount>0,t.hasCache&&(t.isLoaded=!0,t.canServe=!0,v(t.dom,"ln-data-store:ready",{store:t._name,count:t.totalCount,source:"cache"})),t.isInitialized=!0,v(t.dom,"ln-data-store:initialized",{store:t._name,hasCache:t.hasCache,lastSyncedAt:t.lastSyncedAt,count:t.totalCount});else{if(r&&r.schema_version!==f)return F(t._name).then(()=>W(t._name,{schema_version:f,last_synced_at:null,has_cache:!1,record_count:0})).then(()=>{t.isInitialized=!0,t.hasCache=!1,v(t.dom,"ln-data-store:initialized",{store:t._name,hasCache:!1,lastSyncedAt:null,count:0})});t.isInitialized=!0,t.hasCache=!1,v(t.dom,"ln-data-store:initialized",{store:t._name,hasCache:!1,lastSyncedAt:null,count:0})}}).catch(r=>(t.isInitialized=!0,t.isLoaded=!1,t.canServe=!1,t.hasCache=!1,t.isSyncing=!1,t.initializationError=r,v(t.dom,"ln-data-store:initialization-error",{store:t._name,error:r}),{ok:!1,error:r}))}function ve(t){t.isSyncing=!0,v(t.dom,"ln-data-store:request-remote-sync",{since:t.lastSyncedAt})}function xe(t,r){return g().then(l=>l?(z()?Promise.all(r.map(d=>S(d))):Promise.resolve(r)).then(d=>new Promise((w,y)=>{const m=l.transaction(t,"readwrite"),C=m.objectStore(t);d.forEach(x=>C.put(x)),m.oncomplete=()=>w(),m.onerror=()=>{_(m.error),y(m.error)}})):void 0)}function J(t,r){return g().then(l=>{if(l)return new Promise((u,d)=>{const w=l.transaction(t,"readwrite"),y=w.objectStore(t);r.forEach(m=>{y.delete(m),typeof m=="string"&&m.trim()!==""&&!isNaN(Number(m))?y.delete(Number(m)):typeof m=="number"&&y.delete(String(m))}),w.oncomplete=()=>u(),w.onerror=()=>d(w.error)})})}function Lt(t,r,l){return(z()?S(l):Promise.resolve(l)).then(d=>g().then(w=>{if(w)return new Promise((y,m)=>{const C=w.transaction(t,"readwrite"),x=C.objectStore(t);x.put(d),x.delete(r),C.oncomplete=()=>y(),C.onerror=()=>{_(C.error),m(C.error)}})}))}const Nt=new Intl.Collator(void 0,{numeric:!0,sensitivity:"base"});function Dt(t){return t?Object.keys(t).filter(r=>Array.isArray(t[r])&&t[r].length>0):[]}function Tt(t,r,l){return r.every(u=>l[u].map(String).includes(String(t[u])))}function zt(t){return String(t||"").toLowerCase().split(/\s+/).filter(Boolean)}function Ot(t,r,l){return r.every(u=>l.some(d=>{const w=t[d];return w!=null&&String(w).toLowerCase().includes(u)}))}function Rt(t,r,l){return bt(t,r,l)}function K(t,r){return Ct(r,t.presenters&&t.presenters.computed)}function Pt(t){return!t.sort&&!z()}function Bt(t,r,l){const u=Dt(r.filters),d=r.search?zt(r.search):[],w=t._searchFields,y=d.length>0&&w&&w.length>0;return q(t._name,"readonly").then(m=>m?new Promise((C,x)=>{const T=[],N=m.openCursor();N.onsuccess=()=>{const M=N.result;if(!M||T.length>=l){C(T);return}const V=M.value;(!u.length||Tt(V,u,r.filters))&&(!y||Ot(V,d,w))&&T.push(V),M.continue()},N.onerror=()=>x(N.error)}):[])}function ke(t,r,l){return _t(r,l,t._searchFields,Nt)}function Ee(t,r,l){const u=[];for(let w=r;w<r+l;w++){const y=t._windowIndex.getId(w);u.push(y)}const d=Array.from(new Set(u.filter(w=>w!==void 0)));return B(t._name,d).then(w=>{const y=new Map;for(let C=0;C<w.length;C++){const x=w[C];x&&y.set(String(x.id),x)}const m=[];for(let C=0;C<u.length;C++){const x=u[C];if(x===void 0)m.push(null);else{const T=y.get(String(x));m.push(T||null)}}return{data:K(t,m),total:t._windowIndex.grandTotal,filtered:t._windowIndex.logicalTotal,offset:r,queryGen:t._windowIndex.queryGen}})}D.prototype.getAll=function(t={}){const r=this;if(r._windowIndex){const l=t.offset||0,u=t.limit||200;if(r._windowIndex.ensure(l,l+u,t),!r._windowIndex.hasLoaded&&!r.noLocalQuery){const d=l+u,w=y=>y.length?{data:K(r,y),offset:l,queryGen:r._windowIndex.queryGen,provisional:!0}:Ee(r,l,u);return Pt(t)?Bt(r,t,d).then(y=>w(y.slice(l,d))):E(r._name).then(y=>w(ke(r,y,t).records))}return Ee(r,l,u)}return E(r._name).then(l=>{const u=ke(r,l,t);return{data:K(r,u.records),total:u.total,filtered:u.filtered}})},D.prototype.getById=function(t){return I(this._name,t).then(r=>r?K(this,[r])[0]:null)},D.prototype.count=function(t){return t&&Object.keys(t).length>0?E(this._name).then(l=>Ae(l,t).length):this.totalCount!=null?Promise.resolve(this.totalCount):O(this._name)},D.prototype.aggregate=function(t,r){return E(this._name).then(l=>Rt(l,t,r))},D.prototype.setPresenters=function(t){this.presenters=t},D.prototype.applySync=function(t,r,l,u){u=u||{};const d=this;if(d._windowIndex&&u.queryGen!=null&&u.queryGen!==d._windowIndex.queryGen)return Promise.resolve();t.length>0||r.length>0;let w=Promise.resolve();return t.length>0&&(w=w.then(()=>xe(d._name,t))),r.length>0&&(w=w.then(()=>J(d._name,r))),w.then(()=>{if(d._windowIndex&&(u.offset!=null||u.total!=null)){const y=u.offset!=null?u.offset:0,m=t.map(x=>x.id),C=d._windowIndex.ingest(y,m,u.total,u.filtered,u.queryGen);if(C&&C.length)return J(d._name,C)}}).then(()=>O(d._name)).then(y=>(d.totalCount=u.total!==void 0?u.total:y,d.hasCache=!0,W(d._name,{schema_version:f,last_synced_at:l,has_cache:!0,record_count:d.totalCount}))).then(()=>{const y=!d.isLoaded;d.isLoaded=!0,d.canServe=!0,d.isSyncing=!1,d.lastSyncedAt=l,y?(v(d.dom,"ln-data-store:loaded",{store:d._name,count:d.totalCount,meta:u}),v(d.dom,"ln-data-store:ready",{store:d._name,count:d.totalCount,source:"server",meta:u})):v(d.dom,"ln-data-store:synced",{store:d._name,added:t.length,deleted:r.length,changed:!0,meta:u})}).catch(y=>{d.isSyncing=!1,console.error("[ln-data-store] applySync failed:",y)})},D.prototype.applyQuery=function(t,r){r=r||{};const l=this;let u=Promise.resolve();return t.length>0&&(u=u.then(()=>xe(l._name,t))),u.then(()=>O(l._name)).then(d=>(l.totalCount=r.total!==void 0?r.total:d,t.length>0&&(l.canServe=!0),K(l,t))).catch(d=>(console.error("[ln-data-store] applyQuery failed:",d),[]))},D.prototype.forceSync=function(){this.isSyncing||ve(this)},D.prototype.fullReload=function(){const t=this;return F(t._name).then(()=>W(t._name,{schema_version:f,last_synced_at:null,has_cache:!1,record_count:0})).then(()=>{t.isLoaded=!1,t.hasCache=!1,t.lastSyncedAt=null,t.totalCount=0,ve(t)})},D.prototype.destroy=function(){if(this._windowIndex&&(this._windowIndex.clear(),this._windowIndex=null,this.windowed=!1),this._handlers){for(const[t,r]of Object.entries(this._handlers))this.dom.removeEventListener(`ln-data-store:request-${t}`,r);this._handlers=null}if(this._queryHandlers){for(const[t,r]of Object.entries(this._queryHandlers))this.dom.removeEventListener(t,r);this._queryHandlers=null}delete b[this._name],delete this.dom[n]};function Mt(){return g().then(t=>{if(!t)return;const r=Array.from(t.objectStoreNames);return new Promise((l,u)=>{const d=t.transaction(r,"readwrite");r.forEach(w=>d.objectStore(w).clear()),d.oncomplete=()=>l(),d.onerror=()=>u(d.error)})}).then(()=>{Object.values(b).forEach(t=>{t.isLoaded=!1,t.canServe=!1,t.isInitialized=!1,t.initializationError=null,t.hasCache=!1,t.isSyncing=!1,t.lastSyncedAt=null,t.totalCount=0})})}function re(t){t._windowIndex&&t._windowIndex.reset(),v(t.dom,"ln-data-store:query-changed",{store:t._name,query:{filters:Object.assign({},t.query.filters),search:t.query.search,sort:t.query.sort?Object.assign({},t.query.sort):null}})}const Ft="data-ln-data-store-frozen";function Ie(t,r){t.setAttribute(Ft,r)}function jt(t){const r=t[n];if(!r._windowIndex)return;const l=r._windowIndex.configure({windowSize:r._windowSize});l.length&&J(r._name,l).catch(u=>{console.error("[ln-data-store] window shrink eviction failed:",u)})}function $t(t){const r=t[n];r._windowIndex&&r._windowIndex.configure({pageSize:r._windowPageSize})}Ze(e,n,D,"ln-data-store",{attributes:i}),window[n].clearAll=Mt,window[n].init=window[n],window[n].setStorageKey=Se,typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.setStorageKey=Se)})()})();

package/components/ln-data-store/ln-data-store.schema.json

@@ -0,0 +1,84 @@
+{
+	"$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-data-store",
+	"generator": "scripts/sync-ln-schemas.mjs",
+	"attributes": {
+		"data-ln-data-store": {
+			"direction": "author",
+			"sources": [
+				"ln-data-store-dev.scss",
+				"src/ln-data-store.js"
+			],
+			"type": "marker",
+			"description": "Identifies the element as a data-store definition container"
+		},
+		"data-ln-data-store-frozen": {
+			"direction": "runtime",
+			"sources": [
+				"ln-data-store-dev.scss",
+				"src/ln-data-store.js"
+			],
+			"type": "marker",
+			"description": "Applied at runtime to indicate store schema is locked in IndexedDB"
+		},
+		"data-ln-data-store-indexes": {
+			"direction": "author",
+			"sources": [
+				"src/ln-data-store.js"
+			],
+			"type": "list",
+			"description": "Comma-separated index field names for the IndexedDB store"
+		},
+		"data-ln-data-store-no-local-query": {
+			"direction": null,
+			"sources": [
+				"src/ln-data-store.js"
+			],
+			"type": "boolean",
+			"description": "Bypasses local IndexedDB query resolution, forcing remote fetching"
+		},
+		"data-ln-data-store-search-fields": {
+			"direction": null,
+			"sources": [
+				"src/ln-data-store.js"
+			],
+			"type": "list",
+			"description": "Record fields to index for client-side search"
+		},
+		"data-ln-data-store-stale": {
+			"direction": null,
+			"sources": [
+				"src/ln-data-store.js"
+			],
+			"type": "integer",
+			"fallback": 300,
+			"description": "Cache staleness threshold in seconds, or -1/never"
+		},
+		"data-ln-data-store-window": {
+			"direction": "author",
+			"sources": [
+				"src/ln-data-store.js"
+			],
+			"type": "integer",
+			"fallback": 1000,
+			"min": 10,
+			"description": "Virtual scrolling cache window size in records"
+		},
+		"data-ln-data-store-window-page": {
+			"direction": null,
+			"sources": [
+				"src/ln-data-store.js"
+			],
+			"type": "integer",
+			"fallback": 200,
+			"min": 5,
+			"description": "Virtual scrolling slice page size"
+		},
+		"data-ln-debug": {
+			"direction": null,
+			"sources": [
+				"ln-data-store-dev.scss"
+			]
+		}
+	}
+}

package/components/ln-data-store/src/data-store-model.js

@@ -0,0 +1,155 @@
+import { compareValues, detectValueType } from '../../ln-core/compare.js';
+import { matchesFilterValues, matchesSearchTokens, tokenizeSearchQuery } from '../../ln-core/matching.js';
+
+/**
+ * Sorts an array of record objects by field and direction using pure core comparison.
+ * @param {Array<Record<string, any>>} records
+ * @param {{ field?: string, direction?: string } | null} [sort]
+ * @param {Intl.Collator} [collator]
+ * @returns {Array<Record<string, any>>}
+ */
+export function sortRecords(records, sort, collator) {
+	if (!Array.isArray(records) || !sort || !sort.field) return records;
+	const { field, direction } = sort;
+	const desc = direction === 'desc';
+
+	// Lock the value type once for the entire sort operation (per Doctrinal / compare.js rules)
+	const sampleValues = records.map(r => (r ? r[field] : undefined));
+	const valueType = detectValueType(sampleValues);
+
+	return [...records].sort((a, b) => {
+		const va = a ? a[field] : undefined;
+		const vb = b ? b[field] : undefined;
+
+		const result = compareValues(va, vb, valueType, collator);
+		return desc ? -result : result;
+	});
+}
+
+/**
+ * Filters an array of records against a dictionary of active filter arrays.
+ * Reuses matchesFilterValues from ln-core/matching (AND across fields, OR within field).
+ * @param {Array<Record<string, any>>} records
+ * @param {Record<string, Array<any>>} filters
+ * @returns {Array<Record<string, any>>}
+ */
+export function filterRecords(records, filters) {
+	if (!Array.isArray(records) || !filters || typeof filters !== 'object') return records;
+
+	const keys = Object.keys(filters).filter(k => Array.isArray(filters[k]) && filters[k].length > 0);
+	if (!keys.length) return records;
+
+	return records.filter(record => {
+		if (!record) return false;
+		return keys.every(field => matchesFilterValues(record[field], filters[field]));
+	});
+}
+
+/**
+ * Searches records across specified fields using ln-core/matching tokenization and matching.
+ * @param {Array<Record<string, any>>} records
+ * @param {string} query
+ * @param {string[]} searchFields
+ * @returns {Array<Record<string, any>>}
+ */
+export function searchRecords(records, query, searchFields) {
+	if (!Array.isArray(records) || !query || !searchFields || !searchFields.length) return records;
+
+	const tokens = tokenizeSearchQuery(query);
+	if (!tokens.length) return records;
+
+	return records.filter(record => {
+		if (!record) return false;
+		return tokens.every(token =>
+			searchFields.some(field => {
+				const val = record[field];
+				return val != null && matchesSearchTokens(String(val), [token]);
+			})
+		);
+	});
+}
+
+/**
+ * Computes aggregates (count, sum, avg) on a specific field across records.
+ * @param {Array<Record<string, any>>} records
+ * @param {string} field
+ * @param {'count' | 'sum' | 'avg'} fn
+ * @returns {number}
+ */
+export function aggregateRecords(records, field, fn) {
+	if (!Array.isArray(records) || !records.length) return 0;
+	if (fn === 'count') return records.length;
+
+	const numbers = records
+		.map(r => (r && r[field] != null ? parseFloat(r[field]) : NaN))
+		.filter(v => Number.isFinite(v));
+
+	const sum = numbers.reduce((a, b) => a + b, 0);
+
+	if (fn === 'sum') return sum;
+	if (fn === 'avg') return numbers.length ? sum / numbers.length : 0;
+	return 0;
+}
+
+/**
+ * Executes full in-memory query evaluation: filter -> search -> sort -> slice.
+ * @param {Array<Record<string, any>>} records
+ * @param {{ filters?: Record<string, any[]>, search?: string, sort?: { field?: string, direction?: string }, offset?: number, limit?: number }} [options={}]
+ * @param {string[]} [searchFields=[]]
+ * @param {Intl.Collator} [collator]
+ * @returns {{ records: Array<Record<string, any>>, total: number, filtered: number }}
+ */
+export function queryRecords(records, options = {}, searchFields = [], collator) {
+	if (!Array.isArray(records)) {
+		return { records: [], total: 0, filtered: 0 };
+	}
+
+	const total = records.length;
+	let result = records;
+
+	if (options.filters) {
+		result = filterRecords(result, options.filters);
+	}
+	if (options.search) {
+		result = searchRecords(result, options.search, searchFields);
+	}
+
+	const filtered = result.length;
+
+	if (options.sort) {
+		result = sortRecords(result, options.sort, collator);
+	}
+
+	if (options.offset || options.limit) {
+		const offset = options.offset || 0;
+		const limit = options.limit || result.length;
+		result = result.slice(offset, offset + limit);
+	}
+
+	return { records: result, total, filtered };
+}
+
+/**
+ * Decorates records with computed fields (pure, no console side-effects).
+ * @param {Array<Record<string, any>>} records
+ * @param {Record<string, (record: any) => any>} [computed]
+ * @returns {Array<Record<string, any>>}
+ */
+export function decorateRecords(records, computed) {
+	if (!Array.isArray(records) || !computed || typeof computed !== 'object') return records;
+
+	return records.map(record => {
+		if (!record) return null;
+		const copy = { ...record };
+		for (const [fieldName, fn] of Object.entries(computed)) {
+			if (typeof fn === 'function') {
+				try {
+					copy[fieldName] = fn(record);
+				} catch (_) {
+					copy[fieldName] = undefined;
+				}
+			}
+		}
+		return copy;
+	});
+}