@loadbare/app 0.4.0 → 0.5.0

package/dist/build/origins.js

@@ -0,0 +1,270 @@
+/**
+ * Where a build's files come from — see docs/reference/builder.md.
+ *
+ * Three kinds of file reach the assembled application: a `.html` definition
+ * that expands a tag, a `.ts` script that registers its class, and a `.css`
+ * stylesheet. All three arrive from the same places, so all three are found
+ * the same way: one ordered list of origins, scanned once each, read by
+ * whoever needs them.
+ *
+ * The order is the cascade, and it is the same for every file kind:
+ *
+ *   1. this package's own `hub/`
+ *   2. each package declared in `imports.ts`, in first-mention order
+ *   3. the application's own `--src` tree
+ *
+ * A package contributes one directory of its own choosing — `loadbare.widgets`
+ * in its package.json, or the whole package when it says nothing.  See
+ * `widgetDir` below for why a package gets to answer that.
+ *
+ * The one built-in origin holds one tag, `lb-hub`, and it is there because
+ * every application has a hub whether or not it says so. A widget is not in
+ * that position: `@loadbare/widgets` is a declared package like any other,
+ * and the builder cannot tell it from someone else's.
+ *
+ * Two rules fall out of that list, and there is no third:
+ *
+ *   - Within one origin, two files claiming the same tag are an error. That
+ *     is a typo, and the origin's own author is the one who can fix it.
+ *   - Across origins, the later one wins. An application always has the
+ *     final say over a package it imported, and a package over a built-in,
+ *     without anyone having to out-name a dependency they do not control.
+ */
+import { readdir, readFile, stat } from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+/** Lowercase, hyphenated — the one shape every custom element tag has, and the one native elements never do. */
+export const CUSTOM_ELEMENT_TAG = /^[a-z][a-z0-9]*(-[a-z0-9]+)+$/;
+const HTML_SUFFIX = ".html";
+const SCRIPT_SUFFIXES = [".ts", ".js"];
+const CSS_SUFFIX = ".css";
+/**
+ * Every file under `dir`, its own nested `node_modules` excluded — those
+ * belong to the packages that declare them, not to this one.
+ */
+async function filesUnder(dir) {
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true, recursive: true });
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((entry) => {
+        if (!entry.isFile())
+            return false;
+        const relative = path.relative(dir, entry.parentPath);
+        return !relative.split(path.sep).includes("node_modules");
+    })
+        .map((entry) => path.join(entry.parentPath, entry.name));
+}
+/**
+ * One origin's contribution, classified by filename alone.
+ *
+ * A `.html` or `.ts` file is a widget's only when its basename is a tag —
+ * 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.
+ */
+export async function scanOrigin(origin) {
+    const definitions = new Map();
+    const scripts = new Map();
+    const css = [];
+    const claim = (into, what, tag, file) => {
+        const already = into.get(tag);
+        if (already) {
+            throw new Error(`origins: '${origin.name}' has two ${what} files for <${tag}>: ` +
+                `'${already}' and '${file}'`);
+        }
+        into.set(tag, file);
+    };
+    for (const dir of origin.dirs) {
+        for (const file of await filesUnder(dir)) {
+            const name = path.basename(file);
+            if (name.endsWith(CSS_SUFFIX)) {
+                css.push(file);
+            }
+            else if (name.endsWith(HTML_SUFFIX)) {
+                const tag = name.slice(0, -HTML_SUFFIX.length).toLowerCase();
+                if (CUSTOM_ELEMENT_TAG.test(tag)) {
+                    claim(definitions, "definition", tag, file);
+                }
+            }
+            else {
+                const suffix = SCRIPT_SUFFIXES.find((s) => name.endsWith(s));
+                if (!suffix)
+                    continue;
+                const tag = name.slice(0, -suffix.length).toLowerCase();
+                // Without the extension: this becomes an import specifier, and
+                // esbuild resolves ".ts" from the bare path the same way as ".js".
+                // A `.d.ts` never reaches here — stripping ".ts" leaves a dot, which
+                // is not a tag.
+                if (CUSTOM_ELEMENT_TAG.test(tag)) {
+                    claim(scripts, "script", tag, file.slice(0, -suffix.length));
+                }
+            }
+        }
+    }
+    // By filename first, the full path only to break a tie. A directory a file
+    // happens to sit in never affects the order.
+    css.sort((a, b) => path.basename(a).localeCompare(path.basename(b)) || a.localeCompare(b));
+    return {
+        name: origin.name,
+        ...(origin.specifier ? { specifier: origin.specifier } : {}),
+        definitions,
+        scripts,
+        css,
+    };
+}
+/**
+ * `imports.ts`, executed rather than parsed — it runs through the same
+ * loader as the rest of the build, so it is ordinary TypeScript, not a data
+ * format with its own rules. It lists the packages an application pulls
+ * widgets from, and each one becomes an origin, scanned exactly as `src` is.
+ */
+export async function loadElementManifest(file) {
+    let mod;
+    try {
+        // pathToFileURL requires an absolute path; the caller's may not be one.
+        mod = (await import(pathToFileURL(path.resolve(file)).href));
+    }
+    catch (err) {
+        if (err.code === "ERR_MODULE_NOT_FOUND")
+            return [];
+        throw new Error(`elements: '${file}' failed to load: ${err.message}`);
+    }
+    const declared = mod.default ?? [];
+    if (!Array.isArray(declared)) {
+        throw new Error(`imports.ts: must default-export an array of package names, got ${typeof declared}`);
+    }
+    for (const name of declared) {
+        if (typeof name !== "string" || name === "") {
+            throw new Error(`imports.ts: every entry must be a package name, got ${JSON.stringify(name)}`);
+        }
+    }
+    return declared;
+}
+/**
+ * The ordinary node_modules walk, stopping at the first directory that has
+ * the package installed — not a full resolution of an entry file, on
+ * purpose: this only needs the package's root directory, and stopping short
+ * avoids caring whether the package exposes an "exports" map at all.  Which
+ * part of that root holds the widgets is the package's own answer to give —
+ * `widgetDir` asks it.
+ */
+export async function findInstalledPackage(packageName, fromDir) {
+    let dir = path.resolve(fromDir);
+    for (;;) {
+        const candidate = path.join(dir, "node_modules", packageName);
+        try {
+            await stat(path.join(candidate, "package.json"));
+            return candidate;
+        }
+        catch {
+            // not here — keep walking up
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            throw new Error(`origins: could not find installed package '${packageName}' above '${fromDir}'`);
+        }
+        dir = parent;
+    }
+}
+/**
+ * Where in an installed package its widgets are, from the package's own
+ * manifest:
+ *
+ *     "loadbare": { "widgets": "./dist" }
+ *
+ * A package that says nothing has its whole directory scanned, which is what
+ * every package got before this field existed.
+ *
+ * The field is here because a published package is not a source tree. It is a
+ * distribution artifact with a shape npm defines — compiled output in `dist/`,
+ * the source excluded, plus a README, a licence, docs and whatever else its
+ * author ships — and scanning all of it makes every one of those files a
+ * possible widget. A package that compiles then carries the same tag twice,
+ * once as `.ts` and once as `.js`, and the duplicate-tag error fires on a
+ * package the application does not control and cannot fix.
+ *
+ * So the package says where to look, and the rest of it is none of the
+ * builder's business. This costs an application author nothing: they still
+ * list the package in `imports.ts` and write no import statement. It costs the
+ * package author one line, in the file npm already expects to carry exactly
+ * this kind of declaration.
+ */
+async function widgetDir(root, packageName) {
+    let manifest;
+    try {
+        manifest = JSON.parse(await readFile(path.join(root, "package.json"), "utf-8"));
+    }
+    catch (err) {
+        throw new Error(`origins: could not read the package.json of '${packageName}': ${err.message}`);
+    }
+    const declared = manifest.loadbare?.widgets;
+    if (declared === undefined)
+        return root;
+    if (typeof declared !== "string" || declared === "") {
+        throw new Error(`origins: '${packageName}' has a "loadbare.widgets" that is not a path: ` +
+            `${JSON.stringify(declared)}`);
+    }
+    // A path out of the package would put a package's declaration in charge of
+    // directories it does not own — including the application's own.
+    const dir = path.resolve(root, declared);
+    const inside = path.relative(root, dir);
+    if (path.isAbsolute(declared) || inside.startsWith("..")) {
+        throw new Error(`origins: '${packageName}' declares widgets at '${declared}', which is outside the package`);
+    }
+    // A declared directory that is not there means the package shipped without
+    // its widgets — its build did not run, or `files` left the directory out.
+    // Scanning the package root instead would find some of them and look like it
+    // worked, so this stops.
+    try {
+        await stat(dir);
+    }
+    catch {
+        throw new Error(`origins: '${packageName}' declares widgets at '${declared}', which is not in the installed package`);
+    }
+    return dir;
+}
+/**
+ * The cascade, in order. A declared package is an origin like any other: the
+ * directory it points `loadbare.widgets` at is scanned the way `src` is — its
+ * whole installed directory, when it points at nothing — and a widget there is
+ * found by its filename, not by being named in a manifest.
+ *
+ * `hub/` is the only origin naming a specifier, because `lb-hub` is the
+ * package's main entry point rather than a file to reach into.
+ */
+export async function buildOrigins(builtin, declared, src) {
+    const { builtinHubDir, packageName } = builtin;
+    const packages = [];
+    for (const name of declared) {
+        const root = await findInstalledPackage(name, src);
+        packages.push({ name, dirs: [await widgetDir(root, name)] });
+    }
+    return [
+        {
+            name: packageName,
+            dirs: [builtinHubDir],
+            specifier: () => packageName,
+        },
+        ...packages,
+        { name: src, dirs: [src] },
+    ];
+}
+/**
+ * The whole cascade, scanned. Everything a build reads from disk that is not
+ * a page, the chrome, or a page's server half comes back from here.
+ */
+export async function scanAll(builtin, src, importsFile) {
+    const declared = importsFile ? await loadElementManifest(importsFile) : [];
+    const origins = await buildOrigins(builtin, declared, src);
+    return Promise.all(origins.map(scanOrigin));
+}
+/** Every origin's stylesheets, concatenated in cascade order. */
+export function cssFrom(scans) {
+    return scans.flatMap((scan) => scan.css);
+}

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

@@ -14,6 +14,7 @@ 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_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";

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

@@ -1 +1 @@
-{"version":3,"file":"lb-constants.d.ts","sourceRoot":"","sources":["../../core/lb-constants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,UAAU,aAAa,CAAC;AACrC,eAAO,MAAM,QAAQ,WAAW,CAAC;AACjC,eAAO,MAAM,SAAS,YAAY,CAAC;AACnC,eAAO,MAAM,UAAU,aAAa,CAAC;AAMrC,eAAO,MAAM,UAAU,aAAa,CAAC;AAKrC,eAAO,MAAM,SAAS,YAAY,CAAC;AAOnC,eAAO,MAAM,cAAc,cAAc,CAAC;AAK1C,eAAO,MAAM,aAAa,eAAe,CAAC;AAM1C,eAAO,MAAM,WAAW,cAAc,CAAC;AAMvC,eAAO,MAAM,WAAW,cAAc,CAAC;AAKvC,eAAO,MAAM,WAAW,cAAc,CAAC;AAOvC,eAAO,MAAM,WAAW,cAAc,CAAC;AAMvC,eAAO,MAAM,SAAS,YAAY,CAAC;AAYnC,eAAO,MAAM,aAAa,gBAAgB,CAAC;AAK3C,eAAO,MAAM,aAAa,gBAAgB,CAAC;AAG3C,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAQ5C,eAAO,MAAM,YAAY,WAAW,CAAC;AAQrC,eAAO,MAAM,YAAY,oBAAoB,CAAC;AAO9C,eAAO,MAAM,UAAU,kBAAkB,CAAC;AAG1C,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAC3C,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAIzC,eAAO,MAAM,qBAAqB,QAAS,CAAC"}
+{"version":3,"file":"lb-constants.d.ts","sourceRoot":"","sources":["../../core/lb-constants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,UAAU,aAAa,CAAC;AACrC,eAAO,MAAM,QAAQ,WAAW,CAAC;AACjC,eAAO,MAAM,SAAS,YAAY,CAAC;AACnC,eAAO,MAAM,UAAU,aAAa,CAAC;AAMrC,eAAO,MAAM,UAAU,aAAa,CAAC;AAKrC,eAAO,MAAM,SAAS,YAAY,CAAC;AAOnC,eAAO,MAAM,cAAc,cAAc,CAAC;AAK1C,eAAO,MAAM,aAAa,eAAe,CAAC;AAM1C,eAAO,MAAM,WAAW,cAAc,CAAC;AAMvC,eAAO,MAAM,WAAW,cAAc,CAAC;AAKvC,eAAO,MAAM,WAAW,cAAc,CAAC;AAOvC,eAAO,MAAM,WAAW,cAAc,CAAC;AAMvC,eAAO,MAAM,SAAS,YAAY,CAAC;AAYnC,eAAO,MAAM,aAAa,gBAAgB,CAAC;AAK3C,eAAO,MAAM,aAAa,gBAAgB,CAAC;AAG3C,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAQ5C,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AAQnD,eAAO,MAAM,YAAY,WAAW,CAAC;AAQrC,eAAO,MAAM,YAAY,oBAAoB,CAAC;AAO9C,eAAO,MAAM,UAAU,kBAAkB,CAAC;AAG1C,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAC3C,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAIzC,eAAO,MAAM,qBAAqB,QAAS,CAAC"}

package/dist/core/lb-constants.js

@@ -1,7 +1,7 @@
 // Every hub attribute name lives here. Nothing writes one as a string
-// literal — not a widget, not a page host, not a test. See docs/guide.md,
-// "Attribute vocabulary".
-// --- Addressing (docs/data-binding.md) ---------------------------------
+// literal — not a widget, not a page host, not a test. See
+// docs/reference/data-binding.md.
+// --- Binding (docs/reference/data-binding.md) ---------------------------
 export const ATTR_QUERY = "lb-query";
 export const ATTR_KEY = "lb-key";
 export const ATTR_CELL = "lb-cell";
@@ -17,11 +17,11 @@ export const ATTR_GROUP = "lb-group";
 export const ATTR_SORT = "lb-sort";
 // Stamped on a list widget by the shared row machinery: how many rows it is
 // showing. It is HTML's namespace rather than Loadbare App's because nothing
-// addresses it — it is derived from rows the hub already knows, exactly as
+// binds to it — it is derived from rows the hub already knows, exactly as
 // the section heading in lb-table is. It exists so that "no members yet"
 // is a stylesheet rule rather than a conditional in every list widget.
 export const ATTR_ROW_COUNT = "data-rows";
-// --- Requests (docs/requests.md) ---------------------------------------
+// --- Requests (docs/reference/data-binding.md) --------------------------
 // One event name, used by a widget reaching the server and by a widget
 // reaching an ancestor widget.
 export const LB_EVENT_NAME = "lb-request";
@@ -32,7 +32,7 @@ export const LB_EVENT_NAME = "lb-request";
 export const ATTR_ACTION = "lb-action";
 // Marks a native element as deleting the tuple it is inside — the CRUD
 // counterpart to lb-action. It needs no declared name: tuple-delete takes
-// only the row's own lb-query/lb-key coordinates, which is all the server
+// only the row's own lb-query/lb-key binding, which is all the server
 // needs to know which row and whether the operation is permitted on it.
 export const ATTR_DELETE = "lb-delete";
 // Marks a <form> as building a new tuple on submit. The hub gathers every
@@ -45,7 +45,7 @@ export const ATTR_INSERT = "lb-insert";
 // a list's row template root, or sits inside one, has both from its
 // ancestors exactly as a delete button does.
 export const ATTR_UPDATE = "lb-update";
-// --- Expansion (docs/expansion.md) -------------------------------------
+// --- Expansion (docs/reference/custom-elements.md) ---------------------
 // Marks the element in a definition whose children receive the authored
 // inner content. An attribute rather than an element because HTML content
 // models discard foreign elements inside <select> and <table>.
@@ -61,12 +61,19 @@ export const ATTR_SLOT = "lb-slot";
 // is what gets it to expansion intact — and unwrapping it is what puts real
 // elements in the shipped document.
 export const ATTR_TEMPLATE = "lb-template";
-// --- Host channel (docs/bundling.md) -----------------------------------
+// --- Host channel (docs/reference/chrome.md) ---------------------------
 // Only anchors carrying this are intercepted, so external links are never
 // hijacked.
 export const ATTR_NAV_LINK = "lb-nav-link";
 // A page host ships as <template id="page-<name>">.
 export const PAGE_TEMPLATE_PREFIX = "page-";
+// Marks the chrome's own <dialog> for a page name that resolves to no
+// template — a routing miss discovered client-side, not an HTTP 404 (every
+// route gets the same 200 response; see docs/tutorials/010-pages-and-navigation.md).
+// Optional: an application that declares none gets today's console.error
+// and nothing more. The builder requires the element it's on to be a
+// <dialog> (build/assemble.ts), since the hub calls showModal() on it.
+export const ATTR_UNKNOWN_PAGE = "lb-unknown-page";
 // The hub's own tag. It is exempt from the rule every other LB-* tag
 // follows: expansion does not require it to have a definition (build/expand.ts),
 // and the client build does not require it to have a script of its own

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

@@ -1,4 +1,4 @@
-/** docs/requests.md — the operation set is closed. */
+/** docs/reference/data-binding.md — the operation set is closed. */
 export type HubRequest = {
     op: "cell-change";
     query: string;
@@ -43,7 +43,7 @@ export type HubRequest = {
 /** One query's result: the cells of a single tuple. Every value is a string. */
 export type QueryResult = Record<string, string>;
 /**
- * A query that returns many tuples — see docs/guide.md, "List processing".
+ * A query that returns many tuples — see docs/reference/server.md, "Queries".
  *
  * Two results, because a list widget must be told the difference. `rows` is
  * the entire set and therefore also the order; `patch` names only what

package/dist/core/lb-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lb-types.d.ts","sourceRoot":"","sources":["../../core/lb-types.ts"],"names":[],"mappings":"AAEA,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAClB;IACE,EAAE,EAAE,aAAa,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACrE;IACE,EAAE,EAAE,cAAc,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,GACD;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE;AACpD;;;;;;;;;;;;GAYG;GACD;IACE,EAAE,EAAE,QAAQ,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,EAAE,CAAA;CAAE,GACnC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE3D,sEAAsE;AACtE,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAEjD,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,IAAI,UAAU,CAGpE;AAED;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CACtC"}
+{"version":3,"file":"lb-types.d.ts","sourceRoot":"","sources":["../../core/lb-types.ts"],"names":[],"mappings":"AAEA,oEAAoE;AACpE,MAAM,MAAM,UAAU,GAClB;IACE,EAAE,EAAE,aAAa,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACrE;IACE,EAAE,EAAE,cAAc,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,GACD;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE;AACpD;;;;;;;;;;;;GAYG;GACD;IACE,EAAE,EAAE,QAAQ,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,EAAE,CAAA;CAAE,GACnC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE3D,sEAAsE;AACtE,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAEjD,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,IAAI,UAAU,CAGpE;AAED;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CACtC"}

package/dist/hub/lb-apply.js

@@ -1,6 +1,6 @@
 /// <reference lib="dom" />
 /**
- * Landing data on a live host — see docs/guide.md, "Applying a response".
+ * Landing data on a live host — see docs/reference/data-binding.md.
  *
  * This is one file rather than part of the hub because a list widget needs
  * the same operation. It clones a row and fills it with a tuple, and filling

package/dist/hub/lb-hub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lb-hub.d.ts","sourceRoot":"","sources":["../../hub/lb-hub.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"lb-hub.d.ts","sourceRoot":"","sources":["../../hub/lb-hub.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/hub/lb-hub.js

@@ -1,13 +1,13 @@
 /// <reference lib="dom" />
-import { ATTR_ACTION, ATTR_CELL, ATTR_DELETE, ATTR_ERROR, ATTR_INSERT, ATTR_KEY, ATTR_NAV_LINK, ATTR_PENDING, ATTR_QUERY, ATTR_UPDATE, HUB_TAG_NAME, PAGE_TEMPLATE_PREFIX, LB_DATA_ENDPOINT, LB_EVENT_NAME, LB_REQUEST_ENDPOINT, LB_REQUEST_TIMEOUT_MS, } from "../core/lb-constants";
-import { applyData } from "./lb-apply";
+import { ATTR_ACTION, ATTR_CELL, ATTR_DELETE, ATTR_ERROR, ATTR_INSERT, ATTR_KEY, ATTR_NAV_LINK, ATTR_PENDING, ATTR_QUERY, ATTR_UNKNOWN_PAGE, ATTR_UPDATE, HUB_TAG_NAME, PAGE_TEMPLATE_PREFIX, LB_DATA_ENDPOINT, LB_EVENT_NAME, LB_REQUEST_ENDPOINT, LB_REQUEST_TIMEOUT_MS, } from "../core/lb-constants";
+import { applyData, applyTuple } from "./lb-apply";
 export { applyData, applyTuple } from "./lb-apply";
 /**
- * Where a click happened, in the addressing vocabulary. An action carries
+ * Where a click happened, in the binding vocabulary. An action carries
  * these and nothing else, so there is no channel for a browser-supplied
  * argument.
  */
-function coordinates(el) {
+function binding(el) {
     const query = el.closest(`[${ATTR_QUERY}]`)?.getAttribute(ATTR_QUERY);
     const key = el.closest(`[${ATTR_KEY}]`)?.getAttribute(ATTR_KEY);
     const cell = el.getAttribute(ATTR_CELL);
@@ -51,10 +51,15 @@ function gatherValues(form) {
     }
     return values;
 }
-/** A path names a page host, and nothing finer. */
+/**
+ * A path names a page host, and nothing finer. The bare path resolves to
+ * `index`, the same convention a static file server follows — an
+ * application names its landing page that way rather than the hub singling
+ * one out.
+ */
 function pageNameFor(path) {
     const name = path.replace(/^\/+|\/+$/g, "");
-    return name === "" ? "counter" : name;
+    return name === "" ? "index" : name;
 }
 /**
  * Fetch one round trip against the client-side deadline. Throws — rather
@@ -109,7 +114,7 @@ class LbHub extends HTMLElement {
                 headers: { "content-type": "application/json" },
                 body: JSON.stringify(request),
             })
-                .then((data) => applyData(this.main, data))
+                .then((data) => applyData(this, data))
                 .catch((err) => {
                 console.error(`lb-hub: request failed`, err);
                 origin?.setAttribute(ATTR_ERROR, "");
@@ -136,37 +141,37 @@ class LbHub extends HTMLElement {
             const detail = {
                 op: "action",
                 name: el.getAttribute(ATTR_ACTION),
-                ...coordinates(el),
+                ...binding(el),
             };
             el.dispatchEvent(new CustomEvent(LB_EVENT_NAME, { bubbles: true, detail }));
         });
         // The CRUD counterpart to the lb-action delegation above: a native
         // element needs no declared name to delete the row it is in, only its
-        // own query/key coordinates.
+        // own query/key binding.
         this.addEventListener("click", (e) => {
             const el = e.target?.closest(`[${ATTR_DELETE}]`);
             if (!el || el.localName.includes("-"))
                 return;
             e.preventDefault();
-            const { query, key } = coordinates(el);
+            const { query, key } = binding(el);
             if (!query || !key) {
-                console.warn(`lb-hub: lb-delete with no query/key coordinates, ignoring`, el);
+                console.warn(`lb-hub: lb-delete with no query/key binding, ignoring`, el);
                 return;
             }
             const detail = { op: "tuple-delete", query, key };
             el.dispatchEvent(new CustomEvent(LB_EVENT_NAME, { bubbles: true, detail }));
         });
-        // The CRUD op that gathers rather than addresses a single cell: every
+        // The CRUD op that gathers rather than binds a single cell: every
         // lb-cell inside the form becomes one entry of the values map. There is
         // no key, because there is no row yet — only the query, found the same
-        // way coordinates() finds one for a click, says what it is inserting
+        // way binding() finds one for a click, says what it is inserting
         // into.
         this.addEventListener("submit", (e) => {
             const form = e.target?.closest(`[${ATTR_INSERT}]`);
             if (!form)
                 return;
             e.preventDefault();
-            const { query } = coordinates(form);
+            const { query } = binding(form);
             if (!query) {
                 console.warn(`lb-hub: lb-insert with no lb-query, ignoring`, form);
                 return;
@@ -187,9 +192,9 @@ class LbHub extends HTMLElement {
             if (!form)
                 return;
             e.preventDefault();
-            const { query, key } = coordinates(form);
+            const { query, key } = binding(form);
             if (!query || !key) {
-                console.warn(`lb-hub: lb-update with no query/key coordinates, ignoring`, form);
+                console.warn(`lb-hub: lb-update with no query/key binding, ignoring`, form);
                 return;
             }
             const detail = {
@@ -223,6 +228,7 @@ class LbHub extends HTMLElement {
         const template = document.getElementById(PAGE_TEMPLATE_PREFIX + page);
         if (!(template instanceof HTMLTemplateElement)) {
             console.error(`lb-hub: no page host for '${page}'`);
+            this.reportUnknownPage(page);
             return;
         }
         let data = {};
@@ -236,7 +242,28 @@ class LbHub extends HTMLElement {
         // Insert and hydrate in one synchronous block: the browser does not
         // paint mid-task, so there is no empty flash.
         this.main.replaceChildren(template.content.cloneNode(true));
-        applyData(this.main, data);
+        applyData(this, data);
+    }
+    /**
+     * A path that resolves to no page host is discovered client-side, after a
+     * successful 200 — every route gets the same document, so there is no
+     * HTTP 404 to report (see docs/tutorials/010-pages-and-navigation.md).
+     * lb-unknown-page is optional: an application that declares none gets
+     * nothing beyond navigate()'s console.error. The builder guarantees the
+     * element it's on is a <dialog> (build/assemble.ts), so this can call
+     * showModal() without checking the tag here.
+     *
+     * Scoped to the hub, like every other lookup here, so that one rule holds
+     * without exception: what the hub acts on is inside the hub.
+     */
+    reportUnknownPage(page) {
+        const dialog = this.querySelector(`[${ATTR_UNKNOWN_PAGE}]`);
+        if (!dialog)
+            return;
+        applyTuple(dialog, { page });
+        const modal = dialog;
+        if (!modal.open)
+            modal.showModal();
     }
 }
 customElements.define(HUB_TAG_NAME, LbHub);

package/dist/hub/lb-rows.js

@@ -1,7 +1,7 @@
 /// <reference lib="dom" />
 /**
- * The row machinery a list widget shares — see docs/guide.md, "List
- * processing".
+ * The row machinery a list widget shares — see docs/reference/custom-elements.md,
+ * "Accepting rows".
  *
  * A widget owns where a row goes and nothing else. Cloning the template,
  * matching a tuple to the row already showing it, and filling that row are
@@ -101,6 +101,6 @@ export function applyRows(scope, result, place = before) {
     // one conditional a page cannot be sent, since the server answers with rows
     // and says nothing about how many survived reconciliation. A page says what
     // an empty list looks like in a stylesheet, and no list widget carries code
-    // for it. See docs/guide.md, "Conditional rendering".
+    // for it. See docs/reference/data-binding.md.
     scope.setAttribute(ATTR_ROW_COUNT, String(showing(scope, template).size));
 }

package/dist/server/lb-server.d.ts

@@ -41,7 +41,7 @@ export declare function patch(change: {
 /** The shape of a `<name>.queries.ts` module. */
 export type Queries = Record<string, Query>;
 /**
- * Where the interaction happened, in the addressing vocabulary, plus the one
+ * Where the interaction happened, in the binding vocabulary, plus the one
  * value a control may carry.
  *
  * The browser fills these from attributes it already has. It never names a
@@ -117,7 +117,7 @@ export interface Crud {
  *
  * `crud` is the same rule for the typed CRUD operations, keyed by the query
  * they operate on rather than by a declared name — there is nothing to name,
- * since the row's own coordinates say what it is.
+ * since the row's own binding says what it is.
  */
 export interface Hooks {
     beforeGet?: (ctx: HubContext) => void | Promise<void>;
@@ -130,8 +130,9 @@ export interface Page {
     hooks: Hooks;
 }
 /**
- * The page registry. Nothing scans a directory yet, so the application names
- * its pages — see docs/guide.md, "What Hub does not do yet".
+ * The page registry. The builder populates this automatically from every
+ * `.hooks.ts`/`.queries.ts` pair it discovers — see docs/reference/builder.md,
+ * "Generating the server-side page registry".
  */
 export type Pages = Record<string, Page>;
 export interface Hub {

package/dist/server/lb-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lb-server.d.ts","sourceRoot":"","sources":["../../server/lb-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lb-server.d.ts","sourceRoot":"","sources":["../../server/lb-server.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,OAAO,EACP,SAAS,EACV,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,UAAU;CAAG;AAE9B;;;;;GAKG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAExE;;;GAGG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,UAAU,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE;IAC5B,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,GAAG,UAAU,CAEb;AAED,iDAAiD;AACjD,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE5C;;;;;;;;;GASG;AACH,MAAM,WAAW,KAAK;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,CACH,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,KAAK,KACT,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,GAAG,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC;IAC7E,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAChF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AACpD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AACvE,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,WAAW,IAAI;IACnB,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,KAAK;IACpB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CAC7B;AAED,sEAAsE;AACtE,MAAM,WAAW,IAAI;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAEzC,MAAM,WAAW,GAAG;IAClB,0EAA0E;IAC1E,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7D;;;OAGG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,kFAAkF;IAClF,aAAa,CACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAClE,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,oFAAoF;IACpF,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EACrC,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,mFAAmF;IACnF,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,EACxD,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,gGAAgG;IAChG,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,EACrE,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,CAoG3C"}

package/dist/tests/assemble.test.js

@@ -11,6 +11,7 @@ import { tmpdir } from "node:os";
 import path from "node:path";
 import { assemble } from "../build/assemble";
 import { resolveLocations } from "../build/locations";
+import { scanAll } from "../build/origins";
 async function tree(files) {
     const dir = await mkdtemp(path.join(tmpdir(), "loadbare-assemble-"));
     for (const [name, content] of Object.entries(files)) {
@@ -20,15 +21,21 @@ async function tree(files) {
     }
     return dir;
 }
+async function scansFor(locations) {
+    return scanAll(locations, locations.srcDir, locations.importsFile);
+}
 describe("assemble", () => {
     it("expands a widget written in the chrome, not only in pages", async () => {
         const src = await tree({
-            "chrome.chrome.html": `<!doctype html><body><lb-nav exp-label="Site"><a href="/a">A</a></lb-nav><lb-hub><main></main></lb-hub></body>`,
+            "chrome.html": `<!doctype html><body><lb-nav exp-label="Site"><a href="/a">A</a></lb-nav><lb-hub><main></main></lb-hub></body>`,
             "lb-nav.html": `<nav aria-label="{{label}}" lb-slot></nav>`,
         });
         try {
             const locations = await resolveLocations({ src, out: `${src}/dist` });
-            const { html, usedTags } = await assemble(locations);
+            const { html, usedTags } = await assemble({
+                ...locations,
+                scans: await scansFor(locations),
+            });
             assert.match(html, /<nav aria-label="Site"><a href="\/a">A<\/a><\/nav>/);
             assert.ok(usedTags.has("lb-nav"));
         }
@@ -38,11 +45,11 @@ describe("assemble", () => {
     });
     it("still throws when the chrome uses an undefined widget", async () => {
         const src = await tree({
-            "chrome.chrome.html": `<!doctype html><body><lb-nope></lb-nope></body>`,
+            "chrome.html": `<!doctype html><body><lb-nope></lb-nope></body>`,
         });
         try {
             const locations = await resolveLocations({ src, out: `${src}/dist` });
-            await assert.rejects(() => assemble(locations), /<lb-nope> has no definition/);
+            await assert.rejects(async () => assemble({ ...locations, scans: await scansFor(locations) }), /<lb-nope> has no definition/);
         }
         finally {
             await rm(src, { recursive: true, force: true });