@livenetworks/ashlar 2.1.12 → 2.2.0

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

@@ -1,112 +1,100 @@
-{
-	"$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-sort",
-	"generator": "scripts/sync-ln-schemas.mjs",
-	"attributes": {
-		"data-ln-debug": {
-			"direction": null,
-			"sources": [
-				"ln-sort-dev.scss"
-			]
-		},
-		"data-ln-empty": {
-			"direction": "author",
-			"sources": [
-				"src/sort-model.js"
-			]
-		},
-		"data-ln-empty-state": {
-			"direction": "author",
-			"sources": [
-				"src/sort-model.js"
-			]
-		},
-		"data-ln-field": {
-			"direction": "author",
-			"sources": [
-				"src/ln-sort.js"
-			]
-		},
-		"data-ln-hash": {
-			"direction": null,
-			"sources": [
-				"src/ln-sort.js"
-			],
-			"type": "string",
-			"description": "URL hash routing key for sort state persistence"
-		},
-		"data-ln-query": {
-			"direction": null,
-			"sources": [
-				"src/ln-sort.js"
-			],
-			"type": "string",
-			"description": "URL query parameter name for sort state persistence"
-		},
-		"data-ln-sort": {
-			"direction": null,
-			"sources": [
-				"ln-sort-dev.scss",
-				"src/ln-sort.js"
-			],
-			"type": "string",
-			"description": "Target table or list element ID to sort"
-		},
-		"data-ln-sort-dir": {
-			"direction": "author",
-			"sources": [
-				"src/ln-sort.js"
-			],
-			"type": "enum",
-			"values": [
-				"asc",
-				"desc"
-			],
-			"fallback": "asc",
-			"description": "Default or requested sort direction"
-		},
-		"data-ln-sort-exclude": {
-			"direction": "author",
-			"sources": [
-				"src/sort-model.js"
-			]
-		},
-		"data-ln-sort-field": {
-			"direction": null,
-			"sources": [
-				"src/ln-sort.js"
-			],
-			"type": "string",
-			"description": "Field name or column key to sort by"
-		},
-		"data-ln-sort-items": {
-			"direction": "author",
-			"sources": [
-				"src/ln-sort.js",
-				"src/sort-model.js"
-			],
-			"type": "string",
-			"description": "CSS selector matching sortable child items"
-		},
-		"data-ln-sort-state": {
-			"direction": "both",
-			"sources": [
-				"src/ln-sort.js"
-			],
-			"type": "enum",
-			"values": [
-				"asc",
-				"desc",
-				"none"
-			],
-			"fallback": "none",
-			"description": "Active sort state applied to column or control"
-		},
-		"data-ln-table-empty": {
-			"direction": "author",
-			"sources": [
-				"src/sort-model.js"
-			]
-		}
-	}
-}
+{
+	"$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-sort",
+	"generator": "scripts/sync-ln-schemas.mjs",
+	"attributes": {
+		"data-ln-debug": {
+			"direction": null,
+			"sources": [
+				"ln-sort-dev.scss"
+			]
+		},
+		"data-ln-field": {
+			"direction": "author",
+			"sources": [
+				"src/ln-sort.js"
+			]
+		},
+		"data-ln-hash": {
+			"direction": null,
+			"sources": [
+				"src/ln-sort.js"
+			],
+			"type": "string",
+			"description": "URL hash routing key for sort state persistence"
+		},
+		"data-ln-query": {
+			"direction": null,
+			"sources": [
+				"src/ln-sort.js"
+			],
+			"type": "string",
+			"description": "URL query parameter name for sort state persistence"
+		},
+		"data-ln-sort": {
+			"direction": null,
+			"sources": [
+				"ln-sort-dev.scss",
+				"src/ln-sort.js"
+			],
+			"type": "string",
+			"description": "Target table or list element ID to sort"
+		},
+		"data-ln-sort-dir": {
+			"direction": "author",
+			"sources": [
+				"src/ln-sort.js"
+			],
+			"type": "enum",
+			"values": [
+				"asc",
+				"desc"
+			],
+			"fallback": "asc",
+			"description": "Default or requested sort direction"
+		},
+		"data-ln-sort-exclude": {
+			"direction": "author",
+			"sources": [
+				"src/sort-model.js"
+			]
+		},
+		"data-ln-sort-field": {
+			"direction": null,
+			"sources": [
+				"src/ln-sort.js"
+			],
+			"type": "string",
+			"description": "Field name or column key to sort by"
+		},
+		"data-ln-sort-items": {
+			"direction": "author",
+			"sources": [
+				"src/ln-sort.js",
+				"src/sort-model.js"
+			],
+			"type": "string",
+			"description": "CSS selector matching sortable child items"
+		},
+		"data-ln-sort-state": {
+			"direction": "both",
+			"sources": [
+				"src/ln-sort.js"
+			],
+			"type": "enum",
+			"values": [
+				"asc",
+				"desc",
+				"none"
+			],
+			"fallback": "none",
+			"description": "Active sort state applied to column or control"
+		},
+		"data-ln-table-empty": {
+			"direction": "author",
+			"sources": [
+				"src/sort-model.js"
+			]
+		}
+	}
+}

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

@@ -74,15 +74,10 @@ export function isExcludedSortItem(el) {
 	if (!el || typeof el !== 'object' || el.nodeType !== 1) return true;
 	if (el.tagName === 'TEMPLATE') return true;
 	if (typeof el.hasAttribute === 'function') {
-		if (el.hasAttribute('data-ln-sort-exclude') || el.hasAttribute('hidden')) return true;
+		if (el.hasAttribute('data-ln-sort-exclude') || el.hasAttribute('data-ln-table-empty') || el.hasAttribute('hidden')) return true;
 	}
 	if (el.classList && el.classList.contains('hidden')) return true;
 	if (el.style && el.style.display === 'none') return true;
-	if (typeof el.matches === 'function') {
-		if (el.matches('.empty-state, .ln-table__empty, .ln-table__empty-state, [data-ln-empty], [data-ln-empty-state], [data-ln-table-empty]')) {
-			return true;
-		}
-	}
 	return false;
 }
 

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

@@ -1,38 +1,38 @@
-{
-	"$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-sortable",
-	"generator": "scripts/sync-ln-schemas.mjs",
-	"attributes": {
-		"data-ln-debug": {
-			"direction": null,
-			"sources": [
-				"ln-sortable-dev.scss"
-			]
-		},
-		"data-ln-sortable": {
-			"direction": "author",
-			"sources": [
-				"ln-sortable-dev.scss",
-				"ln-sortable.scss",
-				"src/ln-sortable.js"
-			],
-			"type": "enum",
-			"values": [
-				"enabled",
-				"disabled"
-			],
-			"fallback": "enabled",
-			"description": "Enables drag-and-drop item reordering or disables when set to disabled"
-		},
-		"data-ln-sortable-handle": {
-			"direction": "author",
-			"sources": [
-				"ln-sortable-dev.scss",
-				"ln-sortable.scss",
-				"src/ln-sortable.js"
-			],
-			"type": "marker",
-			"description": "Designates an element as the drag handle for its parent sortable item"
-		}
-	}
-}
+{
+	"$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-sortable",
+	"generator": "scripts/sync-ln-schemas.mjs",
+	"attributes": {
+		"data-ln-debug": {
+			"direction": null,
+			"sources": [
+				"ln-sortable-dev.scss"
+			]
+		},
+		"data-ln-sortable": {
+			"direction": "author",
+			"sources": [
+				"ln-sortable-dev.scss",
+				"ln-sortable.scss",
+				"src/ln-sortable.js"
+			],
+			"type": "enum",
+			"values": [
+				"enabled",
+				"disabled"
+			],
+			"fallback": "enabled",
+			"description": "Enables drag-and-drop item reordering or disables when set to disabled"
+		},
+		"data-ln-sortable-handle": {
+			"direction": "author",
+			"sources": [
+				"ln-sortable-dev.scss",
+				"ln-sortable.scss",
+				"src/ln-sortable.js"
+			],
+			"type": "marker",
+			"description": "Designates an element as the drag handle for its parent sortable item"
+		}
+	}
+}

package/components/ln-sortable/ln-sortable.scss

@@ -1,25 +1,25 @@
-// ==========================================================================
-// ln-sortable — Functional State & Drag Rules
-// ==========================================================================
-
-[data-ln-sortable] {
-	&.ln-sortable--active {
-		user-select: none;
-	}
-
-	> * {
-		&.ln-sortable--dragging {
-			will-change: transform, opacity;
-			opacity: 0.4;
-		}
-	}
-}
-
-[data-ln-sortable-handle] {
-	touch-action: none;
-	cursor: grab;
-
-	&:active {
-		cursor: grabbing;
-	}
-}
+// ==========================================================================
+// ln-sortable — Functional State & Drag Rules
+// ==========================================================================
+
+[data-ln-sortable] {
+	&.ln-sortable--active {
+		user-select: none;
+	}
+
+	> * {
+		&.ln-sortable--dragging {
+			will-change: transform, opacity;
+			opacity: 0.4;
+		}
+	}
+}
+
+[data-ln-sortable-handle] {
+	touch-action: none;
+	cursor: grab;
+
+	&:active {
+		cursor: grabbing;
+	}
+}

package/components/ln-table/README.md

@@ -181,6 +181,7 @@ External UI controls (`ln-search`, `ln-filter`, filter header buttons, clear but
 | `data-ln-table-row-select` | `<input>` | Selection checkbox in row templates. |
 | `data-ln-table-row-action="name"`| `<button>` | Action button trigger in row templates. |
 | `data-ln-table-loading` | Indicator / Template | Loading indicator element in footer (revealed during background re-fetch) or loading state template. |
+| `data-ln-table-empty` | `<tr>` / Template | Written by ln-table on the rendered empty and loading placeholder row. ln-sort and ln-filter skip rows that carry it. Author it on a hand-written placeholder row in a plain table. On a `<template>` it holds the empty-state content. |
 
 ---
 
@@ -234,7 +235,7 @@ Column filters use static authored markup — a `[data-ln-popover]` block contai
 <!-- th attribute maps filter key → column -->
 <th data-ln-table-filter-col="department">
 	Department
-	<button class="table-filter" type="button"
+	<button type="button"
 	        data-ln-table-col-filter
 	        data-ln-popover-for="filter-dept"
 	        aria-label="Filter department">
@@ -330,6 +331,12 @@ the same target: `ln-table` calls `preventDefault()` unconditionally on
 
 A single observer on `document.body`: new `data-ln-table` root injected → `new lnTable(node)`; elements injected inside a live root → local rescan (no full re-init); `data-ln-table-source`/`-window` attribute set on an existing element → re-evaluated live (see Windowed Mode below).
 
+### Virtual scroll row height
+
+`_rowHeight` is measured once, from the first rows that exist (`_parseRows`, else `_enableVirtualScroll`). While virtual scrolling is active, a window `resize` sets a flag and goes through the same rAF as scroll. The next `_renderVirtual` re-measures the pitch of the rendered block (first to last pool row) before it writes anything. If the pitch changed, for example because a media query turned rows into stacked cards, the window is recomputed and the scroll position moves so the record at the top of the viewport stays there. `calculateVirtualWindow` still assumes uniform rows, so the pitch is an average. Changes in container width that do not resize the window are not observed.
+
+Column widths are locked once (`<colgroup>` + inline `table-layout: fixed`), from the column-header row, and only while that row has a box. A header that is hidden at bootstrap (stacked-card mode, or a hidden ancestor) defers the lock. A virtual table retries it on each window `resize` until it succeeds. A non-virtual table stays on automatic layout.
+
 ### Windowed cache mechanics
 
 Backed by `ln-core.createWindowCache` — the table owns the cache instance, not the full dataset: