@loadbare/app 0.5.5 → 0.6.0

package/README.md

@@ -4,17 +4,18 @@ The fundamentals of @loadbare/app are fixed, we are now working
 on completeness.
 
 > This package is being prepped for 1.0, current work is:
+>
 > 1. docs (nearly done)
 > 2. demos (must be normalized and checked against docs)
 > 3. test a release/use cycle, make sure all instructions work
 
-
 ## Purpose
 
 Loadbare App is a web app framework built specifically to deliver high performance
-to the user for server-bound applications. 
+to the user for server-bound applications.
 
 Loadbare App has two twin primary goals
+
 - To follow the loadbare philosophy of reducing accidental complexity
   to near zero, so the app developer is spending maximum time on the app
   instead of the tooling.
@@ -62,5 +63,3 @@ each lesson.
 ## Roadmap Items for 1.0 and 1.1
 
 [Roadmap](./docs/roadmap.md)
-
-

package/dist/build/assemble.d.ts

@@ -6,7 +6,7 @@
  * built-in widgets and whatever definitions were found in the caller's own
  * source tree. `expand()` only ever sees a fragment, so the chrome's own is
  * the text between its `<body>` tags; a page's is the whole file. A page's
- * expanded host is wrapped in `<template id="page-<name>">` and, together
+ * expanded host is wrapped in `<template lb-page="<name>">` and, together
  * with the chrome's own expanded body content, spliced back into the
  * chrome's `<body>`. The result is the one document a server has to serve
  * for every route — see docs/tutorials/000-getting-started.md and

package/dist/build/assemble.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../build/assemble.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAeH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAuB/C,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,8EAA8E;IAC9E,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB;AAED,wBAAsB,QAAQ,CAAC,EAC7B,UAAU,EACV,KAAK,EACL,KAAK,GACN,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CA2CtC"}
+{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../build/assemble.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAoBH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAwH/C,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,8EAA8E;IAC9E,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB;AAED,wBAAsB,QAAQ,CAAC,EAC7B,UAAU,EACV,KAAK,EACL,KAAK,GACN,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CA2CtC"}

package/dist/build/assemble.js

@@ -6,7 +6,7 @@
  * built-in widgets and whatever definitions were found in the caller's own
  * source tree. `expand()` only ever sees a fragment, so the chrome's own is
  * the text between its `<body>` tags; a page's is the whole file. A page's
- * expanded host is wrapped in `<template id="page-<name>">` and, together
+ * expanded host is wrapped in `<template lb-page="<name>">` and, together
  * with the chrome's own expanded body content, spliced back into the
  * chrome's `<body>`. The result is the one document a server has to serve
  * for every route — see docs/tutorials/000-getting-started.md and
@@ -20,12 +20,17 @@ import { readFile } from "node:fs/promises";
 import { JSDOM } from "jsdom";
 import { addDefinitions, customElementTags, expand, } from "./expand.js";
 import { formatHtml } from "./format.js";
-import { ATTR_UNKNOWN_PAGE, PAGE_TEMPLATE_PREFIX, } from "../core/lb-constants.js";
+import { ATTR_CELL, ATTR_KEY, ATTR_LIST, ATTR_PAGE, ATTR_ROW, ATTR_UNKNOWN_PAGE, HUB_TAG_NAME, } from "../core/lb-constants.js";
 /**
- * The hub calls showModal() on whatever carries lb-unknown-page (hub/lb-hub.browser.ts),
- * so a chrome that puts the attribute on anything else would fail at
- * runtime, on whichever page happens to 404 first, rather than at build
- * time. The attribute is optional; only a wrong element on it is an error.
+ * The hub calls showModal() on whatever carries lb-unknown-page
+ * (hub/lb-hub.browser.ts), so a chrome that puts the attribute on anything
+ * else would fail at runtime, on whichever page happens to 404 first, rather
+ * than at build time. The attribute is optional; a wrong element on it, or a
+ * right one out of the hub's reach, is an error.
+ *
+ * Out of reach because the hub looks for the dialog inside itself, as it
+ * does for everything else it acts on. A dialog elsewhere in the body would
+ * never open and would say nothing about why.
  */
 function checkUnknownPageDialog(chromeFile, expandedBody) {
     const fragment = JSDOM.fragment(expandedBody);
@@ -36,6 +41,72 @@ function checkUnknownPageDialog(chromeFile, expandedBody) {
         throw new Error(`assemble: '${chromeFile}' declares ${ATTR_UNKNOWN_PAGE} on ` +
             `<${el.tagName.toLowerCase()}>, must be a <dialog>`);
     }
+    if (!el.closest(HUB_TAG_NAME)) {
+        throw new Error(`assemble: '${chromeFile}' declares ${ATTR_UNKNOWN_PAGE} outside ` +
+            `<${HUB_TAG_NAME}>, where the hub cannot reach it`);
+    }
+}
+/**
+ * The binding vocabulary, checked once against the finished document rather
+ * than discovered one console error at a time in a browser.
+ *
+ * Everything here is a fact the markup states about itself, so none of it
+ * needs the server: a key is named on a row template, a row template belongs
+ * to a list, and a cell belongs to a scope. What the markup and the server
+ * say about cardinality cannot be compared here, because they are separate
+ * artifacts — createHub holds that check. See docs/reference/data-binding.md.
+ *
+ * A list scope with no row template is not an error. It is bound to the list
+ * without displaying it, which is what an insert form naming the list it adds
+ * to already is.
+ *
+ * A `<template>`'s children are walked in the scope that encloses the
+ * template, because a row template's clones land in the list around it.
+ */
+function walkBinding(node, scope, problems) {
+    for (const el of node.children) {
+        const listName = el.getAttribute(ATTR_LIST);
+        const rowName = el.getAttribute(ATTR_ROW);
+        const tag = el.localName;
+        let here = scope;
+        if (listName !== null && rowName !== null) {
+            problems.push(`<${tag}> carries both ${ATTR_LIST} and ${ATTR_ROW}; a scope is ` +
+                `one or the other, and a name answers with one shape`);
+        }
+        if (listName !== null)
+            here = { kind: "list", name: listName };
+        else if (rowName !== null)
+            here = { kind: "row", name: rowName };
+        if (el.hasAttribute(ATTR_CELL) && here === null) {
+            problems.push(`<${tag}> carries ${ATTR_CELL}="${el.getAttribute(ATTR_CELL)}" with ` +
+                `no ${ATTR_LIST} or ${ATTR_ROW} scope around it`);
+        }
+        if (el.hasAttribute(ATTR_KEY)) {
+            if (tag !== "template") {
+                problems.push(`<${tag}> carries ${ATTR_KEY}; it names the column that identifies ` +
+                    `a row and belongs on the row <template>`);
+            }
+            else if (here === null || here.kind !== "list") {
+                problems.push(`a <template> carries ${ATTR_KEY} outside any ${ATTR_LIST} scope; ` +
+                    `only a list has rows to identify`);
+            }
+        }
+        walkBinding(el, here, problems);
+        // By tag name rather than by instanceof: JSDOM.fragment() parses into a
+        // document with no window, so the constructor is not reachable from the
+        // node.
+        if (tag === "template") {
+            walkBinding(el.content, here, problems);
+        }
+    }
+}
+/** Check one expanded fragment, and name the file if anything is wrong. */
+function checkBinding(file, html) {
+    const problems = [];
+    walkBinding(JSDOM.fragment(html), null, problems);
+    if (problems.length > 0) {
+        throw new Error(`assemble: '${file}' binding:\n  ` + problems.join(`\n  `));
+    }
 }
 export async function assemble({ chromeFile, pages, scans, }) {
     // One layer per origin, in order, so a later origin's definition overrides
@@ -49,7 +120,8 @@ export async function assemble({ chromeFile, pages, scans, }) {
     for (const { name, file } of pages) {
         const authored = await readFile(file, "utf-8");
         const host = expand(authored, defs);
-        templates.push(`<template id="${PAGE_TEMPLATE_PREFIX}${name}">${host}</template>`);
+        checkBinding(file, host);
+        templates.push(`<template ${ATTR_PAGE}="${name}">${host}</template>`);
     }
     let chromeSource;
     try {
@@ -65,6 +137,7 @@ export async function assemble({ chromeFile, pages, scans, }) {
     const [whole, bodyAttrs, bodyContent] = body;
     const expandedBody = expand(bodyContent, defs);
     checkUnknownPageDialog(chromeFile, expandedBody);
+    checkBinding(chromeFile, expandedBody);
     const withPages = chromeSource.replace(whole, () => `<body${bodyAttrs}>${expandedBody}\n${templates.join("\n")}\n</body>`);
     return {
         html: await formatHtml(withPages),

package/dist/build/cli.d.ts

@@ -7,7 +7,7 @@
  *   loadbare-app-build [--src src] [--out dist] [--watch] [--minify]
  *
  * `--src` names the application's own tree: the one `chrome.html` file,
- * every `*.page.html` page, its `*.hooks.ts`/`*.queries.ts` pairs, and
+ * every `*.page.html` page, its `*.requests.ts`/`*.queries.ts` pairs, and
  * `imports.ts` if there is one — see build/locations.ts. It is also the last
  * origin in the cascade that supplies widget definitions, widget scripts and
  * stylesheets; this package's own widgets come first and each package named
@@ -17,7 +17,7 @@
  * The assembled document is written to `<out>/app.html`; the client bundle
  * to `<out>/client.js`, by way of a generated `<out>/client-entry.ts` — see
  * build/elements.ts for how a tag is resolved to the script that registers
- * it. When any page has a hooks or queries file, the hub registry that used
+ * it. When any page has a requests or queries file, the hub registry that used
  * to be hand-maintained is written to `<out>/pages.ts` — see build/pages.ts.
  * Every origin's stylesheets are concatenated in that same cascade order and
  * written to `<out>/app.css` — see build/styles.ts.

package/dist/build/cli.js

@@ -7,7 +7,7 @@
  *   loadbare-app-build [--src src] [--out dist] [--watch] [--minify]
  *
  * `--src` names the application's own tree: the one `chrome.html` file,
- * every `*.page.html` page, its `*.hooks.ts`/`*.queries.ts` pairs, and
+ * every `*.page.html` page, its `*.requests.ts`/`*.queries.ts` pairs, and
  * `imports.ts` if there is one — see build/locations.ts. It is also the last
  * origin in the cascade that supplies widget definitions, widget scripts and
  * stylesheets; this package's own widgets come first and each package named
@@ -17,7 +17,7 @@
  * The assembled document is written to `<out>/app.html`; the client bundle
  * to `<out>/client.js`, by way of a generated `<out>/client-entry.ts` — see
  * build/elements.ts for how a tag is resolved to the script that registers
- * it. When any page has a hooks or queries file, the hub registry that used
+ * it. When any page has a requests or queries file, the hub registry that used
  * to be hand-maintained is written to `<out>/pages.ts` — see build/pages.ts.
  * Every origin's stylesheets are concatenated in that same cascade order and
  * written to `<out>/app.css` — see build/styles.ts.

package/dist/build/expand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expand.d.ts","sourceRoot":"","sources":["../../build/expand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA0CH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AA8BjD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAmB1E;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACzB,OAAO,CAAC,WAAW,CAAC,CAStB;AA4CD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAS3D;AAkPD;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAIhE"}
+{"version":3,"file":"expand.d.ts","sourceRoot":"","sources":["../../build/expand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAkCH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AA8BjD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAmB1E;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACzB,OAAO,CAAC,WAAW,CAAC,CAStB;AA4CD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAS3D;AA8OD;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAIhE"}

package/dist/build/expand.js

@@ -11,29 +11,26 @@
  */
 import { readdir, readFile } from "node:fs/promises";
 import { JSDOM } from "jsdom";
-import { ATTR_SLOT, ATTR_TEMPLATE, HUB_TAG_NAME, } from "../core/lb-constants.js";
-/**
- * The framework's reserved namespace. Every one of these must resolve to a
- * definition — a typo here is caught immediately rather than shipped as an
- * inert tag. A tag outside this namespace still expands when a definition
- * exists for it (an application is free to name its own widgets anything),
- * but is not required to have one: with no definition, it is assumed to be
- * a plain custom element, registered by script alone.
- */
-const WIDGET_TAG = /^LB-/;
+import { ATTR_SLOT, ATTR_TEMPLATE } from "../core/lb-constants.js";
+/** Lowercase, hyphenated — the one shape a custom element tag has. */
+const CUSTOM_ELEMENT = /-/;
+/** A placeholder is an entire attribute value or an entire text node. */
 /**
- * The one LB-* tag that is not a widget: the hub itself, always present in
- * the chrome, registered by script rather than by definition. Expanding the
- * chrome (see build/assemble.ts) would otherwise demand a definition for it
- * that could never exist.
+ * `{{name}}` or `{{name|default}}`. The default is a literal that stands in
+ * when the tag supplies nothing; it is not evaluated and nothing branches on
+ * it. Whitespace around the name and the default is not part of either, so
+ * `{{button-text | OK}}` is the same placeholder as `{{button-text|OK}}` —
+ * a spaced form that shipped as literal braces would be a silent failure
+ * an author would find in the browser.
  */
-const HUB_TAG = HUB_TAG_NAME.toUpperCase();
-/** A placeholder is an entire attribute value or an entire text node. */
-const PLACEHOLDER = /^\{\{([A-Za-z][\w-]*)\}\}$/;
+const PLACEHOLDER = /^\{\{\s*([A-Za-z][\w-]*)\s*(?:\|\s*([^}]*?)\s*)?\}\}$/;
 /**
  * Marks an attribute as input to expansion. Three namespaces share the tag:
- * `lb-` is the hub's, `exp-` is expansion's, and everything unprefixed is
- * HTML's and means what HTML says it means. So an author is free to write
+ * `lb-` holds the names Loadbare defines, `exp-` the names a widget author
+ * defines, and everything unprefixed is HTML's and means what HTML says it
+ * means. The split is by owner rather than by phase — `lb-slot` and
+ * `lb-template` are expansion's own and never reach the browser, while
+ * `lb-list` and `lb-cell` are read at both times. So an author is free to write
  * `class`, `title` or `hidden` on any widget, whatever its parameters happen
  * to be named. The prefix marks the slot on the tag, where the ambiguity was;
  * inside a definition `{{ }}` already says the same thing, so `exp-label`
@@ -171,13 +168,13 @@ export function customElementTags(html) {
     }
     return tags;
 }
-/** Which widgets a definition uses. Undefined tags are caught during expansion. */
-function referencesOf(source) {
+/** Which definitions a definition uses. A tag with no definition expands to nothing and cannot cycle. */
+function referencesOf(source, defs) {
     const refs = new Set();
     for (const scope of scopes(parse(source))) {
         for (const el of scope.querySelectorAll("*")) {
             const tag = el.tagName.toUpperCase();
-            if (WIDGET_TAG.test(tag))
+            if (CUSTOM_ELEMENT.test(tag) && tag in defs)
                 refs.add(tag);
         }
     }
@@ -190,7 +187,7 @@ function referencesOf(source) {
 function checkAcyclic(defs) {
     const refs = new Map();
     for (const [tag, source] of Object.entries(defs)) {
-        refs.set(tag, referencesOf(source));
+        refs.set(tag, referencesOf(source, defs));
     }
     const done = new Set();
     const path = [];
@@ -212,7 +209,8 @@ function checkAcyclic(defs) {
         visit(tag);
 }
 /**
- * Resolve a placeholder against what the author wrote. Unset means absent.
+ * Resolve a placeholder against what the author wrote: the supplied value,
+ * else the definition's default, else absent.
  *
  * Every name the definition asks for is recorded, whether or not it was
  * supplied, so expansion can report a parameter the definition never declared.
@@ -223,7 +221,7 @@ function resolve(text, attrs, asked) {
         return text;
     const name = match[1];
     asked.add(name);
-    return attrs.get(name) ?? null;
+    return attrs.get(name) ?? match[2] ?? null;
 }
 function substitute(root, attrs, asked) {
     for (const scope of scopes(root)) {
@@ -326,12 +324,8 @@ function fillSlot(tag, root, content) {
     slot.append(...content);
     slot.removeAttribute(ATTR_SLOT);
 }
-function expandElement(el, defs) {
+function expandElement(el, defs, source) {
     const tag = el.tagName.toUpperCase();
-    const source = defs[tag];
-    if (source === undefined) {
-        throw new Error(`expand: <${tag.toLowerCase()}> has no definition. Every hub tag must resolve.`);
-    }
     // The tag survives expansion carrying every attribute the author wrote,
     // `exp-` ones included. They cost nothing where they are, and what ships
     // shows what was asked for beside what it produced.
@@ -360,10 +354,12 @@ function expandElement(el, defs) {
 }
 function walk(root, defs) {
     for (const child of [...root.children]) {
-        const tag = child.tagName.toUpperCase();
-        if (tag in defs || (WIDGET_TAG.test(tag) && tag !== HUB_TAG)) {
-            expandElement(child, defs);
-        }
+        const source = defs[child.tagName.toUpperCase()];
+        // A tag with no definition is left alone. It is a custom element a
+        // script registers, and build/elements.ts is where a tag that has
+        // neither a definition nor a script is refused — one rule, one place.
+        if (source !== undefined)
+            expandElement(child, defs, source);
         // Definitions may use other widgets, so descend after expanding. The
         // acyclicity check is what makes this terminate.
         walk(child, defs);

package/dist/build/locations.d.ts

@@ -8,7 +8,7 @@
  * filename suffix does instead: `chrome.html` is the one chrome file, and
  * `*.page.html` is a page.
  *
- * A page's server half is named the same way: `*.hooks.ts` and
+ * A page's server half is named the same way: `*.requests.ts` and
  * `*.queries.ts` pair with a `*.page.html` by sharing its basename, and are
  * free to sit anywhere too. Either may be absent — a page with no data needs
  * neither — but one with no matching `*.page.html` is a naming mistake and
@@ -32,8 +32,8 @@ export interface PageFile {
     file: string;
 }
 export interface PageSource {
-    /** Absolute path, without extension, to the `.hooks.ts` module, if this page has one. */
-    hooks?: string;
+    /** Absolute path, without extension, to the `.requests.ts` module, if this page has one. */
+    requests?: string;
     /** Absolute path, without extension, to the `.queries.ts` module, if this page has one. */
     queries?: string;
 }

package/dist/build/locations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locations.d.ts","sourceRoot":"","sources":["../../build/locations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAQlD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,UAAU;IAClB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,gHAAgH;AAChH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA6ClE;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC;AAEtC,wBAAsB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAmBxD;AAED,MAAM,WAAW,YAAY;IAC3B,8FAA8F;IAC9F,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,SAAU,SAAQ,WAAW;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CA6C7E"}
+{"version":3,"file":"locations.d.ts","sourceRoot":"","sources":["../../build/locations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAQlD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,UAAU;IAClB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,gHAAgH;AAChH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA2ClE;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC;AAEtC,wBAAsB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAmBxD;AAED,MAAM,WAAW,YAAY;IAC3B,8FAA8F;IAC9F,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,SAAU,SAAQ,WAAW;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CA2D7E"}

package/dist/build/locations.js

@@ -8,7 +8,7 @@
  * filename suffix does instead: `chrome.html` is the one chrome file, and
  * `*.page.html` is a page.
  *
- * A page's server half is named the same way: `*.hooks.ts` and
+ * A page's server half is named the same way: `*.requests.ts` and
  * `*.queries.ts` pair with a `*.page.html` by sharing its basename, and are
  * free to sit anywhere too. Either may be absent — a page with no data needs
  * neither — but one with no matching `*.page.html` is a naming mistake and
@@ -32,7 +32,7 @@ import { findPackageRoot } from "./package-root.js";
 export { CUSTOM_ELEMENT_TAG } from "./origins.js";
 const CHROME_FILENAME = "chrome.html";
 const PAGE_SUFFIX = ".page.html";
-const HOOKS_SUFFIX = ".hooks.ts";
+const HOOKS_SUFFIX = ".requests.ts";
 const QUERIES_SUFFIX = ".queries.ts";
 const IMPORTS_FILENAME = "imports.ts";
 /** The raw walk, with no uniqueness checks — usable on its own by anything that does not need a chrome file. */
@@ -70,7 +70,8 @@ export async function discoverSrc(src) {
             pages.push({ name: entry.name.slice(0, -PAGE_SUFFIX.length), file });
         }
         else if (entry.name.endsWith(HOOKS_SUFFIX)) {
-            pageSource(entry.name.slice(0, -HOOKS_SUFFIX.length)).hooks = file.slice(0, -".ts".length);
+            pageSource(entry.name.slice(0, -HOOKS_SUFFIX.length)).requests =
+                file.slice(0, -".ts".length);
         }
         else if (entry.name.endsWith(QUERIES_SUFFIX)) {
             pageSource(entry.name.slice(0, -QUERIES_SUFFIX.length)).queries =
@@ -116,6 +117,17 @@ export async function resolveLocations(args) {
         throw new Error(`locations: more than one ${IMPORTS_FILENAME} found under '${args.src}': ` +
             importsCandidates.join(", "));
     }
+    // Sorted by name above, so duplicates are adjacent. A stub is the page's
+    // whole identity — its route, its template and its server half all key on
+    // it — so two files claiming one stub is a naming mistake, not a merge.
+    for (let i = 1; i < pages.length; i++) {
+        const [prev, here] = [pages[i - 1], pages[i]];
+        if (prev.name === here.name) {
+            throw new Error(`locations: more than one '${here.name}${PAGE_SUFFIX}' found under ` +
+                `'${args.src}': ${prev.file}, ${here.file}; the page namespace is ` +
+                `flat, so a stub names one page`);
+        }
+    }
     const pageNames = new Set(pages.map((p) => p.name));
     for (const name of pageSources.keys()) {
         if (!pageNames.has(name)) {

package/dist/build/origins.d.ts

@@ -71,19 +71,6 @@ export interface OriginScan {
     /** Every `.css` file here, sorted by filename with the full path breaking a tie. */
     css: string[];
 }
-/**
- * One origin's contribution, classified by filename alone.
- *
- * A `.html` file is a widget's only when its basename is a tag, and a module
- * only when it is `<tag>.browser.ts` — which is what excludes `chrome.html`,
- * `about.page.html`, `about.hooks.ts` and `imports.ts` here without naming
- * any of them. Those are the application's own files, and
- * build/locations.ts picks them out of `src` separately.
- *
- * A module named after a tag without the `.browser` goes in `unmarked`, so
- * an author who forgot the word gets told which file to rename rather than
- * being told their tag does not exist.
- */
 export declare function scanOrigin(origin: Origin): Promise<OriginScan>;
 /** The shape of an `imports.ts` module's default export: the packages an application pulls widgets from. */
 export type ElementManifest = string[];

package/dist/build/origins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"origins.d.ts","sourceRoot":"","sources":["../../build/origins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAOH,gHAAgH;AAChH,eAAO,MAAM,kBAAkB,QAAkC,CAAC;AASlE,MAAM,WAAW,MAAM;IACrB,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;;;;OAKG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,qCAAqC;IACrC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,oEAAoE;IACpE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;;OAKG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,oFAAoF;IACpF,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAsBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA4EpE;AAED,4GAA4G;AAC5G,MAAM,MAAM,eAAe,GAAG,MAAM,EAAE,CAAC;AAEvC;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,CAAC,CA4B1B;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAwED,MAAM,WAAW,WAAW;IAC1B,+FAA+F;IAC/F,aAAa,EAAE,MAAM,CAAC;IACtB,kGAAkG;IAClG,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,eAAe,EACzB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,EAAE,CAAC,CAkBnB;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,UAAU,EAAE,CAAC,CAIvB;AAED,iEAAiE;AACjE,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAErD"}
+{"version":3,"file":"origins.d.ts","sourceRoot":"","sources":["../../build/origins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAOH,gHAAgH;AAChH,eAAO,MAAM,kBAAkB,QAAkC,CAAC;AASlE,MAAM,WAAW,MAAM;IACrB,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;;;;OAKG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,qCAAqC;IACrC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,oEAAoE;IACpE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;;OAKG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,oFAAoF;IACpF,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AA2DD,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA4EpE;AAED,4GAA4G;AAC5G,MAAM,MAAM,eAAe,GAAG,MAAM,EAAE,CAAC;AAEvC;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,CAAC,CA4B1B;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAwED,MAAM,WAAW,WAAW;IAC1B,+FAA+F;IAC/F,aAAa,EAAE,MAAM,CAAC;IACtB,kGAAkG;IAClG,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,eAAe,EACzB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,EAAE,CAAC,CAkBnB;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,UAAU,EAAE,CAAC,CAIvB;AAED,iEAAiE;AACjE,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAErD"}

package/dist/build/origins.js

@@ -76,7 +76,7 @@ async function filesUnder(dir) {
  *
  * A `.html` file is a widget's only when its basename is a tag, and a module
  * only when it is `<tag>.browser.ts` — which is what excludes `chrome.html`,
- * `about.page.html`, `about.hooks.ts` and `imports.ts` here without naming
+ * `about.page.html`, `about.requests.ts` and `imports.ts` here without naming
  * any of them. Those are the application's own files, and
  * build/locations.ts picks them out of `src` separately.
  *
@@ -84,6 +84,29 @@ async function filesUnder(dir) {
  * an author who forgot the word gets told which file to rename rather than
  * being told their tag does not exist.
  */
+/**
+ * The tag a filename claims, or null when it claims none.
+ *
+ * A filename is the tag verbatim, never folded. HTML matches an element name
+ * case-insensitively, so folding would let `My-Widget.html` and
+ * `my-widget.html` be two files for one tag — a collision on a
+ * case-sensitive filesystem and one file on a case-insensitive one, which is
+ * a difference between machines rather than a rule anyone can read.
+ *
+ * A name that is a tag only once folded is refused rather than ignored: the
+ * author meant a widget, and silence would leave them with a tag that never
+ * expands.
+ */
+function tagIn(stem, file) {
+    if (CUSTOM_ELEMENT_TAG.test(stem))
+        return stem;
+    const folded = stem.toLowerCase();
+    if (!CUSTOM_ELEMENT_TAG.test(folded))
+        return null;
+    const suffix = path.basename(file).slice(stem.length);
+    throw new Error(`origins: '${file}' carries capitals; a tag is lowercase, so this ` +
+        `file must be named '${folded}${suffix}'`);
+}
 export async function scanOrigin(origin) {
     const definitions = new Map();
     const scripts = new Map();
@@ -104,20 +127,19 @@ export async function scanOrigin(origin) {
                 css.push(file);
             }
             else if (name.endsWith(HTML_SUFFIX)) {
-                const tag = name.slice(0, -HTML_SUFFIX.length).toLowerCase();
-                if (CUSTOM_ELEMENT_TAG.test(tag)) {
+                const tag = tagIn(name.slice(0, -HTML_SUFFIX.length), file);
+                if (tag)
                     claim(definitions, "definition", tag, file);
-                }
             }
             else {
                 const browser = BROWSER_SUFFIXES.find((s) => name.endsWith(s));
                 if (browser) {
-                    const tag = name.slice(0, -browser.length).toLowerCase();
+                    const tag = tagIn(name.slice(0, -browser.length), file);
                     // Only the trailing ".ts" comes off, never the ".browser": what is
                     // left becomes an import specifier, and esbuild resolves
                     // "lb-thing.browser" to "lb-thing.browser.ts" the same way as to
                     // ".js".
-                    if (CUSTOM_ELEMENT_TAG.test(tag)) {
+                    if (tag) {
                         const ext = MODULE_SUFFIXES.find((e) => name.endsWith(e));
                         claim(scripts, "script", tag, file.slice(0, -ext.length));
                     }
@@ -130,8 +152,10 @@ export async function scanOrigin(origin) {
                 // code. It contributes nothing. Remembering it costs a map entry and
                 // buys an error message that names the file instead of describing an
                 // absence. A `.d.ts` never reaches here — stripping ".ts" leaves a
-                // dot, which is not a tag.
-                const tag = name.slice(0, -ext.length).toLowerCase();
+                // dot, which is not a tag. Tested rather than tagIn()'d: an unmarked
+                // module was never claimed to be a widget, so a capital in its name
+                // is not a mistake anyone here can see.
+                const tag = name.slice(0, -ext.length);
                 if (CUSTOM_ELEMENT_TAG.test(tag) && !unmarked.has(tag)) {
                     unmarked.set(tag, file);
                 }

package/dist/build/pages.d.ts

@@ -2,7 +2,7 @@
  * Generating the hub's page registry — the server-side counterpart to
  * build/elements.ts's client entry point.
  *
- * `*.hooks.ts` and `*.queries.ts` are ordinary TypeScript, found by
+ * `*.requests.ts` and `*.queries.ts` are ordinary TypeScript, found by
  * build/locations.ts and handed here already paired by page name. What this
  * module writes is the file an application used to hand-maintain: an import
  * of each pair, a `Pages` object naming them by page, and the one
@@ -11,13 +11,13 @@
  * code, so it never needs a bundler step the way the browser-bound client
  * entry does.
  *
- * Nothing here is emitted for a page with neither a hooks nor a queries
+ * Nothing here is emitted for a page with neither a requests nor a queries
  * file — a purely static page needs no hub entry, and createHub is only
  * called at all when there is at least one.
  */
 import type { PageFile, PageSource } from "./locations.js";
 /**
- * `undefined` when no page has a hooks or queries file — the caller writes
+ * `undefined` when no page has a requests or queries file — the caller writes
  * nothing in that case, the same way an app with no custom elements gets no
  * client entry beyond the built-ins.
  */

package/dist/build/pages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../build/pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAY3D;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,QAAQ,EAAE,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAoCpB"}
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../build/pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAY3D;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,QAAQ,EAAE,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAsCpB"}

package/dist/build/pages.js

@@ -2,7 +2,7 @@
  * Generating the hub's page registry — the server-side counterpart to
  * build/elements.ts's client entry point.
  *
- * `*.hooks.ts` and `*.queries.ts` are ordinary TypeScript, found by
+ * `*.requests.ts` and `*.queries.ts` are ordinary TypeScript, found by
  * build/locations.ts and handed here already paired by page name. What this
  * module writes is the file an application used to hand-maintain: an import
  * of each pair, a `Pages` object naming them by page, and the one
@@ -11,7 +11,7 @@
  * code, so it never needs a bundler step the way the browser-bound client
  * entry does.
  *
- * Nothing here is emitted for a page with neither a hooks nor a queries
+ * Nothing here is emitted for a page with neither a requests nor a queries
  * file — a purely static page needs no hub entry, and createHub is only
  * called at all when there is at least one.
  */
@@ -25,7 +25,7 @@ function relativeImport(outDir, file) {
     return rel.startsWith(".") ? rel : `./${rel}`;
 }
 /**
- * `undefined` when no page has a hooks or queries file — the caller writes
+ * `undefined` when no page has a requests or queries file — the caller writes
  * nothing in that case, the same way an app with no custom elements gets no
  * client entry beyond the built-ins.
  */
@@ -40,15 +40,17 @@ export function pagesSource(pages, pageSources, outDir, packageName) {
         const source = pageSources.get(name);
         if (!source)
             continue;
-        const hooksId = source.hooks ? identifier(name, "Hooks") : undefined;
+        const requestsId = source.requests
+            ? identifier(name, "Requests")
+            : undefined;
         const queriesId = source.queries ? identifier(name, "Queries") : undefined;
-        if (source.hooks) {
-            imports.push(`import { hooks as ${hooksId} } from ${JSON.stringify(relativeImport(outDir, source.hooks))};`);
+        if (source.requests) {
+            imports.push(`import { requests as ${requestsId} } from ${JSON.stringify(relativeImport(outDir, source.requests))};`);
         }
         if (source.queries) {
             imports.push(`import { queries as ${queriesId} } from ${JSON.stringify(relativeImport(outDir, source.queries))};`);
         }
-        entries.push(`  ${JSON.stringify(name)}: { hooks: ${hooksId ?? "{}"}, queries: ${queriesId ?? "{}"} },`);
+        entries.push(`  ${JSON.stringify(name)}: { requests: ${requestsId ?? "{}"}, queries: ${queriesId ?? "{}"} },`);
     }
     return ([...imports, "", "export const hub = createHub({", ...entries, "});"].join("\n") + "\n");
 }

package/dist/core/lb-constants.d.ts

@@ -1,24 +1,29 @@
-export declare const ATTR_QUERY = "lb-query";
+export declare const ATTR_LIST = "lb-list";
+export declare const ATTR_ROW = "lb-row";
 export declare const ATTR_KEY = "lb-key";
+export declare const ATTR_KEY_VALUE = "lb-key-value";
 export declare const ATTR_CELL = "lb-cell";
 export declare const ATTR_VALUE = "lb-value";
-export declare const ATTR_GROUP = "lb-group";
-export declare const ATTR_SORT = "lb-sort";
-export declare const ATTR_ROW_COUNT = "data-rows";
+export declare const ATTR_ROW_COUNT = "lb-row-count";
 export declare const LB_EVENT_NAME = "lb-request";
 export declare const ATTR_ACTION = "lb-action";
-export declare const ATTR_DELETE = "lb-delete";
-export declare const ATTR_INSERT = "lb-insert";
-export declare const ATTR_UPDATE = "lb-update";
+export declare const LB_RESERVED_PREFIX = "lb-";
+export declare const ACTION_ROW_INSERT = "lb-row-insert";
+export declare const ACTION_ROW_DELETE = "lb-row-delete";
+export declare const ACTION_ROW_UPDATE = "lb-row-update";
+export declare const ACTION_CELL_CHANGE = "lb-cell-change";
+export declare const LB_ACTIONS: readonly ["lb-row-insert", "lb-row-delete", "lb-row-update", "lb-cell-change"];
 export declare const ATTR_SLOT = "lb-slot";
 export declare const ATTR_TEMPLATE = "lb-template";
 export declare const ATTR_NAV_LINK = "lb-nav-link";
-export declare const PAGE_TEMPLATE_PREFIX = "page-";
+export declare const ATTR_PAGE = "lb-page";
+export declare const NAV_ROW = "lb-navigation";
+export declare const NAV_CELL_LABEL = "page-label";
+export declare const NAV_CELL_URI = "page-uri";
 export declare const ATTR_UNKNOWN_PAGE = "lb-unknown-page";
 export declare const HUB_TAG_NAME = "lb-hub";
-export declare const ATTR_PENDING = "data-lb-pending";
-export declare const ATTR_ERROR = "data-lb-error";
-export declare const LB_DATA_ENDPOINT = "/lb/data";
-export declare const LB_REQUEST_ENDPOINT = "/lb";
+export declare const ATTR_PENDING = "lb-pending";
+export declare const ATTR_ERROR = "lb-error";
+export declare const LB_ENDPOINT = "/lb";
 export declare const LB_REQUEST_TIMEOUT_MS = 10000;
 //# sourceMappingURL=lb-constants.d.ts.map