@loadbare/app 0.18.1 → 0.19.0

package/README.md

@@ -1,20 +1,26 @@
 # Loadbare App
 
-The fundamentals of @loadbare/app are fixed, we are now working
-on completeness.
+Loadbare App is a web app framework for server-bound applications.  Its
+goals are performance, correctness and developer ergonomics, all true at
+once: what the user sees is what the database held at the last round trip,
+it arrives fast, and the correct, fast application is the easiest one to
+write.
 
-> This package is being prepped for 1.0, current work focuses
-> on building a few side projects to pressure test the
-> model, find performance issues, fill in blanks and anything
-> until the package becomes stable.
+[The Theory of Loadbare App](./docs/theory.md) sets out what each goal
+means, how they relate to each other, and how the implementation is 
+measured against them.
 
-## Purpose
+## Status
 
-Loadbare App is a web app framework built specifically to deliver high performance
-to the user for server-bound applications. 
+This package is being prepped for 1.0, current work focuses
+on building a few side projects to pressure test the
+model, find performance issues, fill in blanks and anything
+else until the package becomes stable.
 
-To the developer Loadbare offers very high code compression with little or
-no boilerplate.
+Update October 9th: Recent commits show the framework is
+settling.  Less vocabulary is being added or refactored, and work
+is transitioning to code hygiene, optimizations, documentation,
+and tying in loose ends.
 
 ## Widgets
 
@@ -50,12 +56,6 @@ each lesson.
 
 [The Elements of a Loadbare Application](./docs/reference/overview.md)
 
-## Theory
-
-[New Theory](./docs/theory.md): The newer theory document.
-
-[Old Theory](./docs/theory-old.md): the design rationale behind Loadbare App.
-
 ## Roadmap Items for 1.0 and 1.1
 
 [Roadmap](./docs/roadmap.md)

package/dist/build/assemble.d.ts

@@ -16,6 +16,7 @@
  * module never reconstructs one of its own, and never reads a directory
  * looking for pages or widgets; it is handed exactly which files those are.
  */
+import type { DeclaredPages } from "./declared.js";
 import type { PageFile } from "./locations.js";
 import type { OriginScan } from "./origins.js";
 export interface AssembleOptions {
@@ -23,11 +24,16 @@ export interface AssembleOptions {
     pages: PageFile[];
     /** Every origin, already scanned, in cascade order — see build/origins.ts. */
     scans: OriginScan[];
+    /**
+     * What each page declares — see build/declared.ts. Without it, the names
+     * `lb-query` and `lb-request` carry are not checked.
+     */
+    declared?: DeclaredPages;
 }
 export interface Assembled {
     html: string;
     /** Every custom element tag left in the document once expansion is done. */
     usedTags: Set<string>;
 }
-export declare function assemble({ chromeFile, pages, scans, }: AssembleOptions): Promise<Assembled>;
+export declare function assemble({ chromeFile, pages, scans, declared, }: AssembleOptions): Promise<Assembled>;
 //# sourceMappingURL=assemble.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../build/assemble.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAkCH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AA+U/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,CAwDtC"}
+{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../build/assemble.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAuCH,OAAO,KAAK,EAAY,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAsb/C,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,8EAA8E;IAC9E,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;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,EACL,QAAQ,GACT,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAgEtC"}

package/dist/build/assemble.js

@@ -19,7 +19,7 @@
 import { readFile } from "node:fs/promises";
 import { addDefinitions, customElementTags, expandTree, } from "./expand.js";
 import { formatHtml } from "./format.js";
-import { AGGREGATES, ATTR_FILTER, ATTR_ORDER, ATTR_COLUMN, ATTR_COUNT, ATTR_GROUP, ATTR_PAGE, ATTR_PAGE_TITLE, ATTR_QUERY, ATTR_REQUEST, ATTR_SELECT, ATTR_SHOW, ATTR_URL_LINK, ATTR_URL_PUSH, ATTR_URL_UNKNOWN, DEVELOPER_ATTRIBUTES, HUB_TAG_NAME, LB_COMMAND_PREFIX, LB_COMMANDS, LB_RESERVED_PREFIX, SHOW_NOT, } from "../core/lb-constants.js";
+import { AGGREGATES, ATTR_FILTER, ATTR_ORDER, ATTR_COLUMN, ATTR_COUNT, ATTR_GROUP, ATTR_PAGE, ATTR_PAGE_TITLE, ATTR_QUERY, ATTR_REQUEST, ATTR_SELECT, ATTR_SHOW, ATTR_URL_LINK, ATTR_URL_PUSH, ATTR_URL_UNKNOWN, CHOICES_QUERY, DEVELOPER_ATTRIBUTES, HUB_TAG_NAME, LB_COMMAND_PREFIX, LB_COMMANDS, LB_RESERVED_PREFIX, REQUEST_ROW_DELETE, REQUEST_ROW_INSERT, REQUEST_ROW_UPDATE, SHOW_NOT, URL_QUERY, } from "../core/lb-constants.js";
 import { isRowRequest } from "../core/lb-types.js";
 /**
  * The hub is one element, and it swaps each page into the one `<main>`
@@ -69,6 +69,73 @@ function checkUnknownPageDialog(chromeFile, body) {
             `<${HUB_TAG_NAME}>, where the hub cannot reach it`);
     }
 }
+/** The queries the hub serves, which every page and the chrome may name. */
+const HUB_QUERIES = [URL_QUERY, CHOICES_QUERY];
+/** The `Crud` key each request Loadbare provides runs. */
+const CRUD_KEYS = {
+    [REQUEST_ROW_INSERT]: "rowInsert",
+    [REQUEST_ROW_UPDATE]: "rowUpdate",
+    [REQUEST_ROW_DELETE]: "rowDelete",
+};
+/**
+ * An `lb-query` or `lb-request` naming nothing the page declares would be
+ * found only on the first round trip, as a server warning and an empty
+ * answer, so a typo would build cleanly.
+ *
+ * A request Loadbare provides is for the query of what it gathers: a form's
+ * own when the form carries `lb-query`, otherwise the nearest around the
+ * element, as the hub decides it (hub/lb-hub.browser.ts). With no query
+ * around it, the hub reports it in the browser.
+ */
+function checkNames(el, scope, names, problems) {
+    const tag = el.localName;
+    const { declared } = names;
+    const query = el.getAttribute(ATTR_QUERY);
+    if (query !== null && !HUB_QUERIES.includes(query)) {
+        if (declared === null) {
+            problems.push(`<${tag}> carries ${ATTR_QUERY}="${query}"; the chrome belongs to ` +
+                `no page, and names only ${HUB_QUERIES.join(" and ")}`);
+        }
+        else if (!declared.queries.has(query)) {
+            problems.push(`<${tag}> carries ${ATTR_QUERY}="${query}", which the page's ` +
+                `queries do not declare`);
+        }
+    }
+    const request = el.getAttribute(ATTR_REQUEST);
+    if (!request)
+        return;
+    if (isRowRequest(request)) {
+        const target = tag === "form" && query !== null ? query : (scope?.query ?? null);
+        if (target === null)
+            return;
+        if (HUB_QUERIES.includes(target)) {
+            if (request !== REQUEST_ROW_UPDATE) {
+                problems.push(`<${tag}> carries ${ATTR_REQUEST}="${request}" for '${target}'; ` +
+                    `the hub answers only ${REQUEST_ROW_UPDATE} for it`);
+            }
+            return;
+        }
+        // A query the page does not declare is reported once, where it is named.
+        if (declared === null || !declared.queries.has(target))
+            return;
+        const key = CRUD_KEYS[request];
+        if (!declared.crud.get(target)?.has(key)) {
+            problems.push(`<${tag}> carries ${ATTR_REQUEST}="${request}" for '${target}', ` +
+                `whose crud entry the page does not declare with ${key}`);
+        }
+    }
+    else if (request.startsWith(LB_RESERVED_PREFIX)) {
+        // Reported by walkMarkup as naming no request Loadbare provides.
+    }
+    else if (declared === null) {
+        problems.push(`<${tag}> carries ${ATTR_REQUEST}="${request}"; the chrome belongs ` +
+            `to no page, and sends no declared request`);
+    }
+    else if (!declared.handlers.has(request)) {
+        problems.push(`<${tag}> carries ${ATTR_REQUEST}="${request}", which the page's ` +
+            `handlers do not declare`);
+    }
+}
 /**
  * The markup, checked once against the finished document rather than
  * discovered one console error at a time in a browser.
@@ -80,12 +147,15 @@ function checkUnknownPageDialog(chromeFile, body) {
  * A `<template>`'s children are walked in the scope that encloses the
  * template, because a row template's clones land in the element around it.
  */
-function walkMarkup(node, scope, problems) {
+function walkMarkup(node, scope, names, problems) {
     for (const el of node.children) {
         const tag = el.localName;
         let here = scope;
-        if (el.hasAttribute(ATTR_QUERY))
-            here = { row: "unknown" };
+        const query = el.getAttribute(ATTR_QUERY);
+        if (query !== null)
+            here = { query, row: "unknown" };
+        if (names)
+            checkNames(el, scope, names, problems);
         for (const { name } of el.attributes) {
             if (name.startsWith(LB_RESERVED_PREFIX) &&
                 !DEVELOPER_ATTRIBUTES.includes(name)) {
@@ -194,7 +264,7 @@ function walkMarkup(node, scope, problems) {
                     `${SHOW_NOT} and then the column it reverses`);
             }
         }
-        walkMarkup(el, here, problems);
+        walkMarkup(el, here, names, problems);
         // By tag name rather than by instanceof: template content belongs to a
         // document with no window, so the constructor is not reachable from the
         // node.
@@ -210,7 +280,7 @@ function walkMarkup(node, scope, problems) {
                     }
                 }
             }
-            walkMarkup(content, isRowTemplate ? { row: true } : here, problems);
+            walkMarkup(content, isRowTemplate ? { query: scope.query, row: true } : here, names, problems);
         }
     }
 }
@@ -257,9 +327,9 @@ function expandFile(file, source, defs) {
     }
 }
 /** Check one expanded fragment, and name the file if anything is wrong. */
-function checkMarkup(file, root) {
+function checkMarkup(file, root, names) {
     const problems = [];
-    walkMarkup(root, null, problems);
+    walkMarkup(root, null, names, problems);
     if (problems.length > 0) {
         throw new Error(`assemble: '${file}' markup:\n  ` + problems.join(`\n  `));
     }
@@ -281,7 +351,7 @@ function liftTitle(holder) {
 function attributeValue(text) {
     return text.replace(/&/g, "&amp;").replace(/"/g, "&quot;");
 }
-export async function assemble({ chromeFile, pages, scans, }) {
+export async function assemble({ chromeFile, pages, scans, declared, }) {
     // One layer per origin, in order, so a later origin's definition overrides
     // an earlier one's for the same tag. Each layer is checked for cycles as it
     // lands, against everything merged so far.
@@ -298,7 +368,7 @@ export async function assemble({ chromeFile, pages, scans, }) {
         const host = expandFile(file, authored, defs);
         const title = liftTitle(host);
         checkPage(file, host.content);
-        checkMarkup(file, host.content);
+        checkMarkup(file, host.content, declared ? { declared: declared.get(name) } : null);
         wrapShown(host);
         customElementTags(host.content, usedTags);
         const titled = title === null ? "" : ` ${ATTR_PAGE_TITLE}="${attributeValue(title)}"`;
@@ -319,7 +389,7 @@ export async function assemble({ chromeFile, pages, scans, }) {
     const chromeBody = expandFile(chromeFile, bodyContent, defs);
     checkChrome(chromeFile, chromeBody.content);
     checkUnknownPageDialog(chromeFile, chromeBody.content);
-    checkMarkup(chromeFile, chromeBody.content);
+    checkMarkup(chromeFile, chromeBody.content, declared ? { declared: null } : null);
     wrapShown(chromeBody);
     customElementTags(chromeBody.content, usedTags);
     customElementTags(chromeSource.replace(whole, ""), usedTags);

package/dist/build/assemble.js.map

@@ -1 +1 @@
-{"version":3,"file":"assemble.js","sourceRoot":"","sources":["../../build/assemble.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Assembling one document out of a chrome file and a set of pages.\n *\n * Every `.html` file in play — the chrome and each page — goes through the\n * same `expand()` (see build/expand.ts) against the same definitions: the\n * built-in widgets and whatever definitions were found in the caller's own\n * source tree. `expand()` only ever sees a fragment, so the chrome's own is\n * the text between its `<body>` tags; a page's is the whole file. A page's\n * expanded host is wrapped in `<template lb-page=\"<name>\">` and, together\n * with the chrome's own expanded body content, spliced back into the\n * chrome's `<body>`. The result is the one document a server has to serve\n * for every route — see docs/tutorials/000-getting-started.md and\n * docs/reference/builder.md.\n *\n * Every path here is a parameter, resolved once by build/locations.ts — this\n * module never reconstructs one of its own, and never reads a directory\n * looking for pages or widgets; it is handed exactly which files those are.\n */\n\nimport { readFile } from \"node:fs/promises\";\nimport {\n  addDefinitions,\n  customElementTags,\n  expandTree,\n  type Definitions,\n} from \"./expand.js\";\nimport { formatHtml } from \"./format.js\";\nimport {\n  AGGREGATES,\n  ATTR_FILTER,\n  ATTR_ORDER,\n  ATTR_COLUMN,\n  ATTR_COUNT,\n  ATTR_GROUP,\n  ATTR_PAGE,\n  ATTR_PAGE_TITLE,\n  ATTR_QUERY,\n  ATTR_REQUEST,\n  ATTR_SELECT,\n  ATTR_SHOW,\n  ATTR_URL_LINK,\n  ATTR_URL_PUSH,\n  ATTR_URL_UNKNOWN,\n  DEVELOPER_ATTRIBUTES,\n  HUB_TAG_NAME,\n  LB_COMMAND_PREFIX,\n  LB_COMMANDS,\n  LB_RESERVED_PREFIX,\n  SHOW_NOT,\n} from \"../core/lb-constants.js\";\nimport { isRowRequest } from \"../core/lb-types.js\";\nimport type { PageFile } from \"./locations.js\";\nimport type { OriginScan } from \"./origins.js\";\n\n/**\n * The hub is one element, and it swaps each page into the one `<main>`\n * inside it (hub/lb-hub.browser.ts), so the chrome holds exactly one of each,\n * the `<main>` inside the hub and empty, since whatever it held would be\n * replaced by the first page. A page is swapped into that `<main>`, so it\n * carries neither.\n */\nfunction checkChrome(chromeFile: string, body: ParentNode): void {\n  const where = `assemble: '${chromeFile}'`;\n  const hubs = body.querySelectorAll(HUB_TAG_NAME).length;\n  if (hubs !== 1) {\n    throw new Error(\n      `${where} has ${hubs} <${HUB_TAG_NAME}>; it needs exactly one`,\n    );\n  }\n  const mains = body.querySelectorAll(\"main\");\n  if (mains.length !== 1) {\n    throw new Error(\n      `${where} has ${mains.length} <main>; it needs exactly one`,\n    );\n  }\n  const main = mains[0]!;\n  if (!main.closest(HUB_TAG_NAME)) {\n    throw new Error(\n      `${where} has its <main> outside <${HUB_TAG_NAME}>, where the hub cannot reach it`,\n    );\n  }\n  if (main.children.length > 0 || main.textContent!.trim() !== \"\") {\n    throw new Error(\n      `${where} has content in its <main>, which the first page replaces; it goes empty`,\n    );\n  }\n}\n\n/** A page lands inside the chrome's `<main>`, so it brings no second one and no hub. */\nfunction checkPage(file: string, root: ParentNode): void {\n  for (const tag of [HUB_TAG_NAME, \"main\"]) {\n    if (root.querySelector(tag)) {\n      throw new Error(\n        `assemble: '${file}' carries a <${tag}>, which belongs to the chrome alone`,\n      );\n    }\n  }\n}\n\n/**\n * The hub calls showModal() on the `<dialog>` carrying lb-url-unknown\n * (hub/lb-hub.browser.ts), and looks for it inside itself, as it does for\n * everything else it acts on. A dialog elsewhere in the body would never open\n * and would say nothing about why.\n */\nfunction checkUnknownPageDialog(chromeFile: string, body: ParentNode): void {\n  const el = body.querySelector(`[${ATTR_URL_UNKNOWN}]`);\n  if (!el) return;\n  if (!el.closest(HUB_TAG_NAME)) {\n    throw new Error(\n      `assemble: '${chromeFile}' declares ${ATTR_URL_UNKNOWN} outside ` +\n        `<${HUB_TAG_NAME}>, where the hub cannot reach it`,\n    );\n  }\n}\n\n/**\n * Where the markup stands while the check walks it: inside some `lb-query`,\n * and whether there is a row there to take a value from. Inside a row\n * template there always is. Inside an `lb-query` outside one, there is when\n * the query is of kind `row`, which only the server knows.\n */\ninterface Scope {\n  row: boolean | \"unknown\";\n}\n\n/**\n * The markup, checked once against the finished document rather than\n * discovered one console error at a time in a browser.\n *\n * Every rule here is a fact the markup states about itself. The developer\n * writes `lb-*` attributes in markup, and script never assigns them, which is\n * what makes checking the markup sound. See docs/reference/data-binding.md.\n *\n * A `<template>`'s children are walked in the scope that encloses the\n * template, because a row template's clones land in the element around it.\n */\nfunction walkMarkup(\n  node: ParentNode,\n  scope: Scope | null,\n  problems: string[],\n): void {\n  for (const el of node.children) {\n    const tag = el.localName;\n    let here = scope;\n    if (el.hasAttribute(ATTR_QUERY)) here = { row: \"unknown\" };\n\n    for (const { name } of el.attributes) {\n      if (\n        name.startsWith(LB_RESERVED_PREFIX) &&\n        !(DEVELOPER_ATTRIBUTES as readonly string[]).includes(name)\n      ) {\n        problems.push(\n          `<${tag}> carries ${name}, which is not an attribute a developer ` +\n            `writes`,\n        );\n      }\n    }\n\n    const request = el.getAttribute(ATTR_REQUEST);\n    if (\n      request !== null &&\n      request.startsWith(LB_RESERVED_PREFIX) &&\n      !isRowRequest(request)\n    ) {\n      problems.push(\n        `<${tag}> carries ${ATTR_REQUEST}=\"${request}\", which begins with ` +\n          `'${LB_RESERVED_PREFIX}' but names no request Loadbare provides`,\n      );\n    }\n    if (el.hasAttribute(ATTR_URL_LINK) && tag !== \"a\") {\n      problems.push(`<${tag}> carries ${ATTR_URL_LINK}; it goes on an <a>`);\n    }\n    if (el.hasAttribute(ATTR_URL_PUSH) && request === null) {\n      problems.push(\n        `<${tag}> carries ${ATTR_URL_PUSH} and no ${ATTR_REQUEST}; it goes ` +\n          `on an element with ${ATTR_REQUEST}`,\n      );\n    }\n    // A selector is a checkbox in a live row, and selects that row. It is no\n    // column, and commits nothing of its own.\n    if (el.hasAttribute(ATTR_SELECT)) {\n      if (tag !== \"input\" || el.getAttribute(\"type\") !== \"checkbox\") {\n        problems.push(\n          `<${tag}> carries ${ATTR_SELECT}; it goes on an ` +\n            `<input type=\"checkbox\">`,\n        );\n      } else if (scope?.row !== true) {\n        problems.push(\n          `<input> carries ${ATTR_SELECT} outside a row template; it ` +\n            `selects the row it sits in`,\n        );\n      }\n      for (const name of [ATTR_COLUMN, ATTR_REQUEST]) {\n        if (el.hasAttribute(name)) {\n          problems.push(\n            `<${tag}> carries ${ATTR_SELECT} and ${name}; a selector is no ` +\n              `column and sends nothing`,\n          );\n        }\n      }\n    }\n    // HTML's own command attribute, whose `--lb-` values are Loadbare's.\n    const command = el.getAttribute(\"command\");\n    if (command !== null && command.startsWith(LB_COMMAND_PREFIX)) {\n      if (!(LB_COMMANDS as readonly string[]).includes(command)) {\n        problems.push(\n          `<${tag}> carries command=\"${command}\", which begins with ` +\n            `'${LB_COMMAND_PREFIX}' but names no command Loadbare provides`,\n        );\n      } else if (!el.hasAttribute(\"commandfor\")) {\n        problems.push(\n          `<${tag}> carries command=\"${command}\" and no commandfor; it ` +\n            `names the form the command is for`,\n        );\n      }\n    }\n    if (el.hasAttribute(ATTR_URL_UNKNOWN) && tag !== \"dialog\") {\n      problems.push(\n        `<${tag}> carries ${ATTR_URL_UNKNOWN}; it goes on a <dialog>`,\n      );\n    }\n\n    // A group is a template holding a heading and the template its\n    // contents go in; an aggregate is set on an element, from the column it\n    // names.\n    if (el.hasAttribute(ATTR_GROUP)) {\n      if (tag !== \"template\") {\n        problems.push(\n          `<${tag}> carries ${ATTR_GROUP}; it goes on a <template>`,\n        );\n      } else if (\n        !(el as HTMLTemplateElement).content.querySelector(\n          `template:not([${ATTR_SHOW}])`,\n        )\n      ) {\n        problems.push(\n          `a <template ${ATTR_GROUP}> holds no <template> for its contents`,\n        );\n      }\n    }\n    for (const name of AGGREGATES) {\n      if (!el.hasAttribute(name)) continue;\n      if (tag === \"template\") {\n        problems.push(`a <template> carries ${name}; it goes on an element`);\n      } else if (name !== ATTR_COUNT && !el.getAttribute(name)) {\n        problems.push(`<${tag}> carries ${name} naming no column`);\n      }\n    }\n\n    // The user's order and filter for the rows an element holds, each read\n    // from a column of lb-choices it names.\n    for (const name of [ATTR_ORDER, ATTR_FILTER]) {\n      const value = el.getAttribute(name);\n      if (value === null) continue;\n      if (!el.hasAttribute(ATTR_QUERY)) {\n        problems.push(\n          `<${tag}> carries ${name}; it goes on the element carrying ` +\n            `${ATTR_QUERY}`,\n        );\n      } else if (value.trim() === \"\") {\n        problems.push(`<${tag}> carries ${name} naming no column`);\n      }\n    }\n\n    // Judged by the scope around the element, not one the element carries:\n    // its condition is a column of the row around it. With no lb-query\n    // around it at all, nothing ever lands on it, and the element never\n    // shows.\n    const show = el.getAttribute(ATTR_SHOW);\n    if (show !== null) {\n      if (tag === \"template\") {\n        problems.push(\n          `a <template> carries ${ATTR_SHOW}=\"${show}\"; write it on the ` +\n            `element it shows, and Loadbare supplies the template`,\n        );\n      } else if (scope === null || scope.row === false) {\n        problems.push(\n          `<${tag}> carries ${ATTR_SHOW}=\"${show}\" with no row around it ` +\n            `to take the value from`,\n        );\n      } else if (show === SHOW_NOT || show.startsWith(SHOW_NOT + SHOW_NOT)) {\n        problems.push(\n          `<${tag}> carries ${ATTR_SHOW}=\"${show}\"; write one ` +\n            `${SHOW_NOT} and then the column it reverses`,\n        );\n      }\n    }\n\n    walkMarkup(el, here, problems);\n    // By tag name rather than by instanceof: template content belongs to a\n    // document with no window, so the constructor is not reachable from the\n    // node.\n    if (tag === \"template\") {\n      const content = (el as HTMLTemplateElement).content;\n      const isRowTemplate =\n        scope !== null && !!el.parentElement?.closest(`[${ATTR_QUERY}]`);\n      if (isRowTemplate) {\n        for (const root of content.children) {\n          if (root.hasAttribute(ATTR_SHOW)) {\n            problems.push(\n              `<${root.localName}> is a row template's root and carries ` +\n                `${ATTR_SHOW}; a row that should not show is left out by ` +\n                `the query`,\n            );\n          }\n        }\n      }\n      walkMarkup(content, isRowTemplate ? { row: true } : here, problems);\n    }\n  }\n}\n\n/**\n * Ship every `lb-show` element already inside the template the hub keeps an\n * absent branch in, so nothing conditional shows until its value says so.\n * A page is in the document before its data arrives, and a value that has not\n * arrived is no value.\n *\n * Elements are collected before any is moved, and a wrapped element is still\n * reached once its outer one has gone into a template, because the references\n * are held.\n */\nfunction wrapShown(holder: HTMLTemplateElement): void {\n  const doc = holder.ownerDocument;\n  const shown: Element[] = [];\n  const collect = (root: ParentNode): void => {\n    shown.push(...root.querySelectorAll(`[${ATTR_SHOW}]`));\n    for (const t of root.querySelectorAll(\"template\")) {\n      collect((t as HTMLTemplateElement).content);\n    }\n  };\n  collect(holder.content);\n  for (const el of shown) {\n    const parked = doc.createElement(\"template\");\n    parked.setAttribute(ATTR_SHOW, el.getAttribute(ATTR_SHOW)!);\n    el.replaceWith(parked);\n    parked.content.append(el);\n  }\n}\n\n/**\n * Expand one file's markup, naming the file if expansion refuses it.\n *\n * What comes back is the tree the browser will build, so every pass after\n * this reads and changes it in place, and it is serialized once, when it\n * ships.\n */\nfunction expandFile(\n  file: string,\n  source: string,\n  defs: Definitions,\n): HTMLTemplateElement {\n  try {\n    return expandTree(source, defs);\n  } catch (e) {\n    throw new Error(`assemble: '${file}': ${(e as Error).message}`);\n  }\n}\n\n/** Check one expanded fragment, and name the file if anything is wrong. */\nfunction checkMarkup(file: string, root: ParentNode): void {\n  const problems: string[] = [];\n  walkMarkup(root, null, problems);\n  if (problems.length > 0) {\n    throw new Error(`assemble: '${file}' markup:\\n  ` + problems.join(`\\n  `));\n  }\n}\n\n/**\n * A page file's `<title>` names the page. It is lifted out, since a page is\n * a fragment inside `<main>` and a `<title>` belongs in a document's head,\n * and its text content is stamped on the page as ATTR_PAGE_TITLE.\n */\nfunction liftTitle(holder: HTMLTemplateElement): string | null {\n  const title = holder.content.querySelector(\"title\");\n  if (!title) return null;\n  const text = title.textContent?.trim() ?? \"\";\n  title.remove();\n  return text;\n}\n\n/** An attribute value, escaped for a double-quoted attribute. */\nfunction attributeValue(text: string): string {\n  return text.replace(/&/g, \"&amp;\").replace(/\"/g, \"&quot;\");\n}\n\nexport interface AssembleOptions {\n  chromeFile: string;\n  pages: PageFile[];\n  /** Every origin, already scanned, in cascade order — see build/origins.ts. */\n  scans: OriginScan[];\n}\n\nexport interface Assembled {\n  html: string;\n  /** Every custom element tag left in the document once expansion is done. */\n  usedTags: Set<string>;\n}\n\nexport async function assemble({\n  chromeFile,\n  pages,\n  scans,\n}: AssembleOptions): Promise<Assembled> {\n  // One layer per origin, in order, so a later origin's definition overrides\n  // an earlier one's for the same tag. Each layer is checked for cycles as it\n  // lands, against everything merged so far.\n  let defs: Definitions = {};\n  for (const scan of scans) {\n    defs = await addDefinitions(defs, scan.definitions);\n  }\n\n  // Tags are collected from each tree as it goes by. What ships is these\n  // trees and the chrome around its body, which is collected on its own.\n  const usedTags = new Set<string>();\n  const templates: string[] = [];\n  for (const { name, file } of pages) {\n    const authored = await readFile(file, \"utf-8\");\n    const host = expandFile(file, authored, defs);\n    const title = liftTitle(host);\n    checkPage(file, host.content);\n    checkMarkup(file, host.content);\n    wrapShown(host);\n    customElementTags(host.content, usedTags);\n    const titled =\n      title === null ? \"\" : ` ${ATTR_PAGE_TITLE}=\"${attributeValue(title)}\"`;\n    templates.push(\n      `<template ${ATTR_PAGE}=\"${name}\"${titled}>${host.innerHTML}</template>`,\n    );\n  }\n\n  let chromeSource: string;\n  try {\n    chromeSource = await readFile(chromeFile, \"utf-8\");\n  } catch {\n    throw new Error(`assemble: no chrome file at '${chromeFile}'`);\n  }\n\n  const body = /<body([^>]*)>([\\s\\S]*)<\\/body>/i.exec(chromeSource);\n  if (!body) {\n    throw new Error(\n      `assemble: '${chromeFile}' has no <body>...</body> to expand`,\n    );\n  }\n  const [whole, bodyAttrs, bodyContent] = body;\n  const chromeBody = expandFile(chromeFile, bodyContent!, defs);\n  checkChrome(chromeFile, chromeBody.content);\n  checkUnknownPageDialog(chromeFile, chromeBody.content);\n  checkMarkup(chromeFile, chromeBody.content);\n  wrapShown(chromeBody);\n  customElementTags(chromeBody.content, usedTags);\n  customElementTags(chromeSource.replace(whole!, \"\"), usedTags);\n  const withPages = chromeSource.replace(\n    whole!,\n    () =>\n      `<body${bodyAttrs}>${chromeBody.innerHTML}\\n${templates.join(\"\\n\")}\\n</body>`,\n  );\n\n  return { html: await formatHtml(withPages), usedTags };\n}\n"]}
+{"version":3,"file":"assemble.js","sourceRoot":"","sources":["../../build/assemble.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Assembling one document out of a chrome file and a set of pages.\n *\n * Every `.html` file in play — the chrome and each page — goes through the\n * same `expand()` (see build/expand.ts) against the same definitions: the\n * built-in widgets and whatever definitions were found in the caller's own\n * source tree. `expand()` only ever sees a fragment, so the chrome's own is\n * the text between its `<body>` tags; a page's is the whole file. A page's\n * expanded host is wrapped in `<template lb-page=\"<name>\">` and, together\n * with the chrome's own expanded body content, spliced back into the\n * chrome's `<body>`. The result is the one document a server has to serve\n * for every route — see docs/tutorials/000-getting-started.md and\n * docs/reference/builder.md.\n *\n * Every path here is a parameter, resolved once by build/locations.ts — this\n * module never reconstructs one of its own, and never reads a directory\n * looking for pages or widgets; it is handed exactly which files those are.\n */\n\nimport { readFile } from \"node:fs/promises\";\nimport {\n  addDefinitions,\n  customElementTags,\n  expandTree,\n  type Definitions,\n} from \"./expand.js\";\nimport { formatHtml } from \"./format.js\";\nimport {\n  AGGREGATES,\n  ATTR_FILTER,\n  ATTR_ORDER,\n  ATTR_COLUMN,\n  ATTR_COUNT,\n  ATTR_GROUP,\n  ATTR_PAGE,\n  ATTR_PAGE_TITLE,\n  ATTR_QUERY,\n  ATTR_REQUEST,\n  ATTR_SELECT,\n  ATTR_SHOW,\n  ATTR_URL_LINK,\n  ATTR_URL_PUSH,\n  ATTR_URL_UNKNOWN,\n  CHOICES_QUERY,\n  DEVELOPER_ATTRIBUTES,\n  HUB_TAG_NAME,\n  LB_COMMAND_PREFIX,\n  LB_COMMANDS,\n  LB_RESERVED_PREFIX,\n  REQUEST_ROW_DELETE,\n  REQUEST_ROW_INSERT,\n  REQUEST_ROW_UPDATE,\n  SHOW_NOT,\n  URL_QUERY,\n} from \"../core/lb-constants.js\";\nimport { isRowRequest } from \"../core/lb-types.js\";\nimport type { Declared, DeclaredPages } from \"./declared.js\";\nimport type { PageFile } from \"./locations.js\";\nimport type { OriginScan } from \"./origins.js\";\n\n/**\n * The hub is one element, and it swaps each page into the one `<main>`\n * inside it (hub/lb-hub.browser.ts), so the chrome holds exactly one of each,\n * the `<main>` inside the hub and empty, since whatever it held would be\n * replaced by the first page. A page is swapped into that `<main>`, so it\n * carries neither.\n */\nfunction checkChrome(chromeFile: string, body: ParentNode): void {\n  const where = `assemble: '${chromeFile}'`;\n  const hubs = body.querySelectorAll(HUB_TAG_NAME).length;\n  if (hubs !== 1) {\n    throw new Error(\n      `${where} has ${hubs} <${HUB_TAG_NAME}>; it needs exactly one`,\n    );\n  }\n  const mains = body.querySelectorAll(\"main\");\n  if (mains.length !== 1) {\n    throw new Error(\n      `${where} has ${mains.length} <main>; it needs exactly one`,\n    );\n  }\n  const main = mains[0]!;\n  if (!main.closest(HUB_TAG_NAME)) {\n    throw new Error(\n      `${where} has its <main> outside <${HUB_TAG_NAME}>, where the hub cannot reach it`,\n    );\n  }\n  if (main.children.length > 0 || main.textContent!.trim() !== \"\") {\n    throw new Error(\n      `${where} has content in its <main>, which the first page replaces; it goes empty`,\n    );\n  }\n}\n\n/** A page lands inside the chrome's `<main>`, so it brings no second one and no hub. */\nfunction checkPage(file: string, root: ParentNode): void {\n  for (const tag of [HUB_TAG_NAME, \"main\"]) {\n    if (root.querySelector(tag)) {\n      throw new Error(\n        `assemble: '${file}' carries a <${tag}>, which belongs to the chrome alone`,\n      );\n    }\n  }\n}\n\n/**\n * The hub calls showModal() on the `<dialog>` carrying lb-url-unknown\n * (hub/lb-hub.browser.ts), and looks for it inside itself, as it does for\n * everything else it acts on. A dialog elsewhere in the body would never open\n * and would say nothing about why.\n */\nfunction checkUnknownPageDialog(chromeFile: string, body: ParentNode): void {\n  const el = body.querySelector(`[${ATTR_URL_UNKNOWN}]`);\n  if (!el) return;\n  if (!el.closest(HUB_TAG_NAME)) {\n    throw new Error(\n      `assemble: '${chromeFile}' declares ${ATTR_URL_UNKNOWN} outside ` +\n        `<${HUB_TAG_NAME}>, where the hub cannot reach it`,\n    );\n  }\n}\n\n/**\n * Where the markup stands while the check walks it: inside which `lb-query`,\n * and whether there is a row there to take a value from. Inside a row\n * template there always is. Inside an `lb-query` outside one, there is when\n * the query is of kind `row`, which only the server knows.\n */\ninterface Scope {\n  query: string;\n  row: boolean | \"unknown\";\n}\n\n/** The queries the hub serves, which every page and the chrome may name. */\nconst HUB_QUERIES: readonly string[] = [URL_QUERY, CHOICES_QUERY];\n\n/** The `Crud` key each request Loadbare provides runs. */\nconst CRUD_KEYS: Record<string, string> = {\n  [REQUEST_ROW_INSERT]: \"rowInsert\",\n  [REQUEST_ROW_UPDATE]: \"rowUpdate\",\n  [REQUEST_ROW_DELETE]: \"rowDelete\",\n};\n\n/**\n * What a file's names are checked against: a page's declarations, or `null`\n * for the chrome, which belongs to no page and so names only what the hub\n * serves.\n */\ntype Names = { declared: Declared | null };\n\n/**\n * An `lb-query` or `lb-request` naming nothing the page declares would be\n * found only on the first round trip, as a server warning and an empty\n * answer, so a typo would build cleanly.\n *\n * A request Loadbare provides is for the query of what it gathers: a form's\n * own when the form carries `lb-query`, otherwise the nearest around the\n * element, as the hub decides it (hub/lb-hub.browser.ts). With no query\n * around it, the hub reports it in the browser.\n */\nfunction checkNames(\n  el: Element,\n  scope: Scope | null,\n  names: Names,\n  problems: string[],\n): void {\n  const tag = el.localName;\n  const { declared } = names;\n\n  const query = el.getAttribute(ATTR_QUERY);\n  if (query !== null && !HUB_QUERIES.includes(query)) {\n    if (declared === null) {\n      problems.push(\n        `<${tag}> carries ${ATTR_QUERY}=\"${query}\"; the chrome belongs to ` +\n          `no page, and names only ${HUB_QUERIES.join(\" and \")}`,\n      );\n    } else if (!declared.queries.has(query)) {\n      problems.push(\n        `<${tag}> carries ${ATTR_QUERY}=\"${query}\", which the page's ` +\n          `queries do not declare`,\n      );\n    }\n  }\n\n  const request = el.getAttribute(ATTR_REQUEST);\n  if (!request) return;\n  if (isRowRequest(request)) {\n    const target =\n      tag === \"form\" && query !== null ? query : (scope?.query ?? null);\n    if (target === null) return;\n    if (HUB_QUERIES.includes(target)) {\n      if (request !== REQUEST_ROW_UPDATE) {\n        problems.push(\n          `<${tag}> carries ${ATTR_REQUEST}=\"${request}\" for '${target}'; ` +\n            `the hub answers only ${REQUEST_ROW_UPDATE} for it`,\n        );\n      }\n      return;\n    }\n    // A query the page does not declare is reported once, where it is named.\n    if (declared === null || !declared.queries.has(target)) return;\n    const key = CRUD_KEYS[request]!;\n    if (!declared.crud.get(target)?.has(key)) {\n      problems.push(\n        `<${tag}> carries ${ATTR_REQUEST}=\"${request}\" for '${target}', ` +\n          `whose crud entry the page does not declare with ${key}`,\n      );\n    }\n  } else if (request.startsWith(LB_RESERVED_PREFIX)) {\n    // Reported by walkMarkup as naming no request Loadbare provides.\n  } else if (declared === null) {\n    problems.push(\n      `<${tag}> carries ${ATTR_REQUEST}=\"${request}\"; the chrome belongs ` +\n        `to no page, and sends no declared request`,\n    );\n  } else if (!declared.handlers.has(request)) {\n    problems.push(\n      `<${tag}> carries ${ATTR_REQUEST}=\"${request}\", which the page's ` +\n        `handlers do not declare`,\n    );\n  }\n}\n\n/**\n * The markup, checked once against the finished document rather than\n * discovered one console error at a time in a browser.\n *\n * Every rule here is a fact the markup states about itself. The developer\n * writes `lb-*` attributes in markup, and script never assigns them, which is\n * what makes checking the markup sound. See docs/reference/data-binding.md.\n *\n * A `<template>`'s children are walked in the scope that encloses the\n * template, because a row template's clones land in the element around it.\n */\nfunction walkMarkup(\n  node: ParentNode,\n  scope: Scope | null,\n  names: Names | null,\n  problems: string[],\n): void {\n  for (const el of node.children) {\n    const tag = el.localName;\n    let here = scope;\n    const query = el.getAttribute(ATTR_QUERY);\n    if (query !== null) here = { query, row: \"unknown\" };\n    if (names) checkNames(el, scope, names, problems);\n\n    for (const { name } of el.attributes) {\n      if (\n        name.startsWith(LB_RESERVED_PREFIX) &&\n        !(DEVELOPER_ATTRIBUTES as readonly string[]).includes(name)\n      ) {\n        problems.push(\n          `<${tag}> carries ${name}, which is not an attribute a developer ` +\n            `writes`,\n        );\n      }\n    }\n\n    const request = el.getAttribute(ATTR_REQUEST);\n    if (\n      request !== null &&\n      request.startsWith(LB_RESERVED_PREFIX) &&\n      !isRowRequest(request)\n    ) {\n      problems.push(\n        `<${tag}> carries ${ATTR_REQUEST}=\"${request}\", which begins with ` +\n          `'${LB_RESERVED_PREFIX}' but names no request Loadbare provides`,\n      );\n    }\n    if (el.hasAttribute(ATTR_URL_LINK) && tag !== \"a\") {\n      problems.push(`<${tag}> carries ${ATTR_URL_LINK}; it goes on an <a>`);\n    }\n    if (el.hasAttribute(ATTR_URL_PUSH) && request === null) {\n      problems.push(\n        `<${tag}> carries ${ATTR_URL_PUSH} and no ${ATTR_REQUEST}; it goes ` +\n          `on an element with ${ATTR_REQUEST}`,\n      );\n    }\n    // A selector is a checkbox in a live row, and selects that row. It is no\n    // column, and commits nothing of its own.\n    if (el.hasAttribute(ATTR_SELECT)) {\n      if (tag !== \"input\" || el.getAttribute(\"type\") !== \"checkbox\") {\n        problems.push(\n          `<${tag}> carries ${ATTR_SELECT}; it goes on an ` +\n            `<input type=\"checkbox\">`,\n        );\n      } else if (scope?.row !== true) {\n        problems.push(\n          `<input> carries ${ATTR_SELECT} outside a row template; it ` +\n            `selects the row it sits in`,\n        );\n      }\n      for (const name of [ATTR_COLUMN, ATTR_REQUEST]) {\n        if (el.hasAttribute(name)) {\n          problems.push(\n            `<${tag}> carries ${ATTR_SELECT} and ${name}; a selector is no ` +\n              `column and sends nothing`,\n          );\n        }\n      }\n    }\n    // HTML's own command attribute, whose `--lb-` values are Loadbare's.\n    const command = el.getAttribute(\"command\");\n    if (command !== null && command.startsWith(LB_COMMAND_PREFIX)) {\n      if (!(LB_COMMANDS as readonly string[]).includes(command)) {\n        problems.push(\n          `<${tag}> carries command=\"${command}\", which begins with ` +\n            `'${LB_COMMAND_PREFIX}' but names no command Loadbare provides`,\n        );\n      } else if (!el.hasAttribute(\"commandfor\")) {\n        problems.push(\n          `<${tag}> carries command=\"${command}\" and no commandfor; it ` +\n            `names the form the command is for`,\n        );\n      }\n    }\n    if (el.hasAttribute(ATTR_URL_UNKNOWN) && tag !== \"dialog\") {\n      problems.push(\n        `<${tag}> carries ${ATTR_URL_UNKNOWN}; it goes on a <dialog>`,\n      );\n    }\n\n    // A group is a template holding a heading and the template its\n    // contents go in; an aggregate is set on an element, from the column it\n    // names.\n    if (el.hasAttribute(ATTR_GROUP)) {\n      if (tag !== \"template\") {\n        problems.push(\n          `<${tag}> carries ${ATTR_GROUP}; it goes on a <template>`,\n        );\n      } else if (\n        !(el as HTMLTemplateElement).content.querySelector(\n          `template:not([${ATTR_SHOW}])`,\n        )\n      ) {\n        problems.push(\n          `a <template ${ATTR_GROUP}> holds no <template> for its contents`,\n        );\n      }\n    }\n    for (const name of AGGREGATES) {\n      if (!el.hasAttribute(name)) continue;\n      if (tag === \"template\") {\n        problems.push(`a <template> carries ${name}; it goes on an element`);\n      } else if (name !== ATTR_COUNT && !el.getAttribute(name)) {\n        problems.push(`<${tag}> carries ${name} naming no column`);\n      }\n    }\n\n    // The user's order and filter for the rows an element holds, each read\n    // from a column of lb-choices it names.\n    for (const name of [ATTR_ORDER, ATTR_FILTER]) {\n      const value = el.getAttribute(name);\n      if (value === null) continue;\n      if (!el.hasAttribute(ATTR_QUERY)) {\n        problems.push(\n          `<${tag}> carries ${name}; it goes on the element carrying ` +\n            `${ATTR_QUERY}`,\n        );\n      } else if (value.trim() === \"\") {\n        problems.push(`<${tag}> carries ${name} naming no column`);\n      }\n    }\n\n    // Judged by the scope around the element, not one the element carries:\n    // its condition is a column of the row around it. With no lb-query\n    // around it at all, nothing ever lands on it, and the element never\n    // shows.\n    const show = el.getAttribute(ATTR_SHOW);\n    if (show !== null) {\n      if (tag === \"template\") {\n        problems.push(\n          `a <template> carries ${ATTR_SHOW}=\"${show}\"; write it on the ` +\n            `element it shows, and Loadbare supplies the template`,\n        );\n      } else if (scope === null || scope.row === false) {\n        problems.push(\n          `<${tag}> carries ${ATTR_SHOW}=\"${show}\" with no row around it ` +\n            `to take the value from`,\n        );\n      } else if (show === SHOW_NOT || show.startsWith(SHOW_NOT + SHOW_NOT)) {\n        problems.push(\n          `<${tag}> carries ${ATTR_SHOW}=\"${show}\"; write one ` +\n            `${SHOW_NOT} and then the column it reverses`,\n        );\n      }\n    }\n\n    walkMarkup(el, here, names, problems);\n    // By tag name rather than by instanceof: template content belongs to a\n    // document with no window, so the constructor is not reachable from the\n    // node.\n    if (tag === \"template\") {\n      const content = (el as HTMLTemplateElement).content;\n      const isRowTemplate =\n        scope !== null && !!el.parentElement?.closest(`[${ATTR_QUERY}]`);\n      if (isRowTemplate) {\n        for (const root of content.children) {\n          if (root.hasAttribute(ATTR_SHOW)) {\n            problems.push(\n              `<${root.localName}> is a row template's root and carries ` +\n                `${ATTR_SHOW}; a row that should not show is left out by ` +\n                `the query`,\n            );\n          }\n        }\n      }\n      walkMarkup(\n        content,\n        isRowTemplate ? { query: scope!.query, row: true } : here,\n        names,\n        problems,\n      );\n    }\n  }\n}\n\n/**\n * Ship every `lb-show` element already inside the template the hub keeps an\n * absent branch in, so nothing conditional shows until its value says so.\n * A page is in the document before its data arrives, and a value that has not\n * arrived is no value.\n *\n * Elements are collected before any is moved, and a wrapped element is still\n * reached once its outer one has gone into a template, because the references\n * are held.\n */\nfunction wrapShown(holder: HTMLTemplateElement): void {\n  const doc = holder.ownerDocument;\n  const shown: Element[] = [];\n  const collect = (root: ParentNode): void => {\n    shown.push(...root.querySelectorAll(`[${ATTR_SHOW}]`));\n    for (const t of root.querySelectorAll(\"template\")) {\n      collect((t as HTMLTemplateElement).content);\n    }\n  };\n  collect(holder.content);\n  for (const el of shown) {\n    const parked = doc.createElement(\"template\");\n    parked.setAttribute(ATTR_SHOW, el.getAttribute(ATTR_SHOW)!);\n    el.replaceWith(parked);\n    parked.content.append(el);\n  }\n}\n\n/**\n * Expand one file's markup, naming the file if expansion refuses it.\n *\n * What comes back is the tree the browser will build, so every pass after\n * this reads and changes it in place, and it is serialized once, when it\n * ships.\n */\nfunction expandFile(\n  file: string,\n  source: string,\n  defs: Definitions,\n): HTMLTemplateElement {\n  try {\n    return expandTree(source, defs);\n  } catch (e) {\n    throw new Error(`assemble: '${file}': ${(e as Error).message}`);\n  }\n}\n\n/** Check one expanded fragment, and name the file if anything is wrong. */\nfunction checkMarkup(\n  file: string,\n  root: ParentNode,\n  names: Names | null,\n): void {\n  const problems: string[] = [];\n  walkMarkup(root, null, names, problems);\n  if (problems.length > 0) {\n    throw new Error(`assemble: '${file}' markup:\\n  ` + problems.join(`\\n  `));\n  }\n}\n\n/**\n * A page file's `<title>` names the page. It is lifted out, since a page is\n * a fragment inside `<main>` and a `<title>` belongs in a document's head,\n * and its text content is stamped on the page as ATTR_PAGE_TITLE.\n */\nfunction liftTitle(holder: HTMLTemplateElement): string | null {\n  const title = holder.content.querySelector(\"title\");\n  if (!title) return null;\n  const text = title.textContent?.trim() ?? \"\";\n  title.remove();\n  return text;\n}\n\n/** An attribute value, escaped for a double-quoted attribute. */\nfunction attributeValue(text: string): string {\n  return text.replace(/&/g, \"&amp;\").replace(/\"/g, \"&quot;\");\n}\n\nexport interface AssembleOptions {\n  chromeFile: string;\n  pages: PageFile[];\n  /** Every origin, already scanned, in cascade order — see build/origins.ts. */\n  scans: OriginScan[];\n  /**\n   * What each page declares — see build/declared.ts. Without it, the names\n   * `lb-query` and `lb-request` carry are not checked.\n   */\n  declared?: DeclaredPages;\n}\n\nexport interface Assembled {\n  html: string;\n  /** Every custom element tag left in the document once expansion is done. */\n  usedTags: Set<string>;\n}\n\nexport async function assemble({\n  chromeFile,\n  pages,\n  scans,\n  declared,\n}: AssembleOptions): Promise<Assembled> {\n  // One layer per origin, in order, so a later origin's definition overrides\n  // an earlier one's for the same tag. Each layer is checked for cycles as it\n  // lands, against everything merged so far.\n  let defs: Definitions = {};\n  for (const scan of scans) {\n    defs = await addDefinitions(defs, scan.definitions);\n  }\n\n  // Tags are collected from each tree as it goes by. What ships is these\n  // trees and the chrome around its body, which is collected on its own.\n  const usedTags = new Set<string>();\n  const templates: string[] = [];\n  for (const { name, file } of pages) {\n    const authored = await readFile(file, \"utf-8\");\n    const host = expandFile(file, authored, defs);\n    const title = liftTitle(host);\n    checkPage(file, host.content);\n    checkMarkup(\n      file,\n      host.content,\n      declared ? { declared: declared.get(name)! } : null,\n    );\n    wrapShown(host);\n    customElementTags(host.content, usedTags);\n    const titled =\n      title === null ? \"\" : ` ${ATTR_PAGE_TITLE}=\"${attributeValue(title)}\"`;\n    templates.push(\n      `<template ${ATTR_PAGE}=\"${name}\"${titled}>${host.innerHTML}</template>`,\n    );\n  }\n\n  let chromeSource: string;\n  try {\n    chromeSource = await readFile(chromeFile, \"utf-8\");\n  } catch {\n    throw new Error(`assemble: no chrome file at '${chromeFile}'`);\n  }\n\n  const body = /<body([^>]*)>([\\s\\S]*)<\\/body>/i.exec(chromeSource);\n  if (!body) {\n    throw new Error(\n      `assemble: '${chromeFile}' has no <body>...</body> to expand`,\n    );\n  }\n  const [whole, bodyAttrs, bodyContent] = body;\n  const chromeBody = expandFile(chromeFile, bodyContent!, defs);\n  checkChrome(chromeFile, chromeBody.content);\n  checkUnknownPageDialog(chromeFile, chromeBody.content);\n  checkMarkup(\n    chromeFile,\n    chromeBody.content,\n    declared ? { declared: null } : null,\n  );\n  wrapShown(chromeBody);\n  customElementTags(chromeBody.content, usedTags);\n  customElementTags(chromeSource.replace(whole!, \"\"), usedTags);\n  const withPages = chromeSource.replace(\n    whole!,\n    () =>\n      `<body${bodyAttrs}>${chromeBody.innerHTML}\\n${templates.join(\"\\n\")}\\n</body>`,\n  );\n\n  return { html: await formatHtml(withPages), usedTags };\n}\n"]}

package/dist/build/cli.d.ts

@@ -19,6 +19,9 @@
  * build/elements.ts for how a tag is resolved to the script that registers
  * 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 `lb-query` and `lb-request` in the chrome and the pages is checked
+ * against what the page declares, which is read by loading the page modules
+ * — see build/declared.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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../build/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../build/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG"}

package/dist/build/cli.js

@@ -19,6 +19,9 @@
  * build/elements.ts for how a tag is resolved to the script that registers
  * 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 `lb-query` and `lb-request` in the chrome and the pages is checked
+ * against what the page declares, which is read by loading the page modules
+ * — see build/declared.ts.
  * Every origin's stylesheets are concatenated in that same cascade order and
  * written to `<out>/app.css` — see build/styles.ts.
  *
@@ -39,6 +42,7 @@ import { mkdir, watch, writeFile } from "node:fs/promises";
 import path from "node:path";
 import * as esbuild from "esbuild";
 import { assemble } from "./assemble.js";
+import { loadDeclared } from "./declared.js";
 import { checkReservedMethods, clientEntrySource, resolveElements, } from "./elements.js";
 import { resolveLocations } from "./locations.js";
 import { cssFrom, scanAll } from "./origins.js";
@@ -59,8 +63,9 @@ async function build() {
     const entryFile = path.join(locations.outDir, "client-entry.ts");
     const clientFile = path.join(locations.outDir, "client.js");
     const scans = await scanAll(locations, srcDir, locations.importsFile);
-    const { html, usedTags } = await assemble({ ...locations, scans });
     await mkdir(locations.outDir, { recursive: true });
+    const declared = await loadDeclared(locations.pages, locations.pageSources, locations.outDir);
+    const { html, usedTags } = await assemble({ ...locations, scans, declared });
     await writeFile(outFile, html, "utf-8");
     const { resolved } = resolveElements({ used: usedTags, scans });
     await checkReservedMethods(resolved);

package/dist/build/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../build/cli.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n/**\n * loadbare-app-build — assemble a chrome file and its pages into one HTML\n * document, and bundle the client script for exactly the custom elements\n * that document uses. See docs/tutorials/000-getting-started.md.\n *\n *   loadbare-app-build [--src src] [--out dist] [--watch] [--minify]\n *\n * `--src` names the application's own tree: the one `chrome.html` file,\n * every `*.page.html` page, its `*.requests.ts`/`*.queries.ts` pairs, and\n * `imports.ts` if there is one — see build/locations.ts. It is also the last\n * origin in the cascade that supplies widget definitions, widget scripts and\n * stylesheets; this package's own widgets come first and each package named\n * in `imports.ts` in between, all scanned the same way — see\n * build/origins.ts.\n *\n * The assembled document is written to `<out>/app.html`; the client bundle\n * to `<out>/client.js`, by way of a generated `<out>/client-entry.ts` — see\n * build/elements.ts for how a tag is resolved to the script that registers\n * it. When any page has a requests or queries file, the hub registry that used\n * to be hand-maintained is written to `<out>/pages.ts` — see build/pages.ts.\n * Every origin's stylesheets are concatenated in that same cascade order and\n * written to `<out>/app.css` — see build/styles.ts.\n *\n * `--minify` minifies both output files: esbuild's own minifier for\n * `client.js`, as part of the same bundling pass, and esbuild's CSS\n * transform for `app.css`, as a pass over the concatenation above. `app.html`\n * is never minified — it is markup an application may still want to read.\n *\n * Without `--watch`, this runs once and exits. With it, every `.html`,\n * `.ts` and `.css` file under `<src>` is watched — a page, a widget's\n * markup, a widget's class, a stylesheet, and `imports.ts` all feed the\n * same build — and a rebuild that throws is reported without stopping the\n * watch. There is no dev server and no browser reload here, only the files\n * on disk staying current for the next manual refresh.\n */\n\nimport { parseArgs } from \"node:util\";\nimport { mkdir, watch, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport * as esbuild from \"esbuild\";\nimport { assemble } from \"./assemble.js\";\nimport {\n  checkReservedMethods,\n  clientEntrySource,\n  resolveElements,\n} from \"./elements.js\";\nimport { resolveLocations } from \"./locations.js\";\nimport { cssFrom, scanAll } from \"./origins.js\";\nimport { pagesSource } from \"./pages.js\";\nimport { stylesSource } from \"./styles.js\";\n\nconst { values } = parseArgs({\n  options: {\n    src: { type: \"string\", default: \"src\" },\n    out: { type: \"string\", default: \"dist\" },\n    watch: { type: \"boolean\", default: false },\n    minify: { type: \"boolean\", default: false },\n  },\n});\n\nconst srcDir = values.src!;\n\nasync function build(): Promise<void> {\n  const locations = await resolveLocations({ src: srcDir, out: values.out! });\n  const outFile = path.join(locations.outDir, \"app.html\");\n  const entryFile = path.join(locations.outDir, \"client-entry.ts\");\n  const clientFile = path.join(locations.outDir, \"client.js\");\n\n  const scans = await scanAll(locations, srcDir, locations.importsFile);\n\n  const { html, usedTags } = await assemble({ ...locations, scans });\n  await mkdir(locations.outDir, { recursive: true });\n  await writeFile(outFile, html, \"utf-8\");\n\n  const { resolved } = resolveElements({ used: usedTags, scans });\n  await checkReservedMethods(resolved);\n  await writeFile(\n    entryFile,\n    clientEntrySource(resolved, locations.outDir),\n    \"utf-8\",\n  );\n  await esbuild.build({\n    entryPoints: [entryFile],\n    bundle: true,\n    format: \"iife\",\n    outfile: clientFile,\n    minify: values.minify,\n  });\n\n  const generatedPages = pagesSource(\n    locations.pages,\n    locations.pageSources,\n    locations.outDir,\n    locations.packageName,\n  );\n  let pagesMessage = \"\";\n  if (generatedPages) {\n    const pagesFile = path.join(locations.outDir, \"pages.ts\");\n    await writeFile(pagesFile, generatedPages, \"utf-8\");\n    pagesMessage = ` and ${pagesFile}`;\n  }\n\n  const concatenatedCss = await stylesSource(cssFrom(scans));\n  let cssMessage = \"\";\n  if (concatenatedCss) {\n    const cssFile = path.join(locations.outDir, \"app.css\");\n    const generatedCss = values.minify\n      ? (\n          await esbuild.transform(concatenatedCss, {\n            loader: \"css\",\n            minify: true,\n          })\n        ).code\n      : concatenatedCss;\n    await writeFile(cssFile, generatedCss, \"utf-8\");\n    cssMessage = ` and ${cssFile}`;\n  }\n\n  console.log(\n    `loadbare-app-build: wrote ${outFile} and ${clientFile}${pagesMessage}${cssMessage} ` +\n      `(${resolved.size} custom element${resolved.size === 1 ? \"\" : \"s\"})`,\n  );\n}\n\nasync function main(): Promise<void> {\n  try {\n    await build();\n  } catch (err) {\n    console.error(`loadbare-app-build: ${(err as Error).message}`);\n    if (!values.watch) {\n      process.exitCode = 1;\n      return;\n    }\n  }\n\n  if (!values.watch) return;\n\n  console.log(`loadbare-app-build: watching ${srcDir}`);\n  const watcher = watch(srcDir, { recursive: true });\n  for await (const event of watcher) {\n    if (\n      !event.filename?.endsWith(\".html\") &&\n      !event.filename?.endsWith(\".ts\") &&\n      !event.filename?.endsWith(\".css\")\n    )\n      continue;\n    try {\n      await build();\n    } catch (err) {\n      console.error(`loadbare-app-build: ${(err as Error).message}`);\n    }\n  }\n}\n\nvoid main();\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../build/cli.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n/**\n * loadbare-app-build — assemble a chrome file and its pages into one HTML\n * document, and bundle the client script for exactly the custom elements\n * that document uses. See docs/tutorials/000-getting-started.md.\n *\n *   loadbare-app-build [--src src] [--out dist] [--watch] [--minify]\n *\n * `--src` names the application's own tree: the one `chrome.html` file,\n * every `*.page.html` page, its `*.requests.ts`/`*.queries.ts` pairs, and\n * `imports.ts` if there is one — see build/locations.ts. It is also the last\n * origin in the cascade that supplies widget definitions, widget scripts and\n * stylesheets; this package's own widgets come first and each package named\n * in `imports.ts` in between, all scanned the same way — see\n * build/origins.ts.\n *\n * The assembled document is written to `<out>/app.html`; the client bundle\n * to `<out>/client.js`, by way of a generated `<out>/client-entry.ts` — see\n * build/elements.ts for how a tag is resolved to the script that registers\n * it. When any page has a requests or queries file, the hub registry that used\n * to be hand-maintained is written to `<out>/pages.ts` — see build/pages.ts.\n * Every `lb-query` and `lb-request` in the chrome and the pages is checked\n * against what the page declares, which is read by loading the page modules\n * — see build/declared.ts.\n * Every origin's stylesheets are concatenated in that same cascade order and\n * written to `<out>/app.css` — see build/styles.ts.\n *\n * `--minify` minifies both output files: esbuild's own minifier for\n * `client.js`, as part of the same bundling pass, and esbuild's CSS\n * transform for `app.css`, as a pass over the concatenation above. `app.html`\n * is never minified — it is markup an application may still want to read.\n *\n * Without `--watch`, this runs once and exits. With it, every `.html`,\n * `.ts` and `.css` file under `<src>` is watched — a page, a widget's\n * markup, a widget's class, a stylesheet, and `imports.ts` all feed the\n * same build — and a rebuild that throws is reported without stopping the\n * watch. There is no dev server and no browser reload here, only the files\n * on disk staying current for the next manual refresh.\n */\n\nimport { parseArgs } from \"node:util\";\nimport { mkdir, watch, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport * as esbuild from \"esbuild\";\nimport { assemble } from \"./assemble.js\";\nimport { loadDeclared } from \"./declared.js\";\nimport {\n  checkReservedMethods,\n  clientEntrySource,\n  resolveElements,\n} from \"./elements.js\";\nimport { resolveLocations } from \"./locations.js\";\nimport { cssFrom, scanAll } from \"./origins.js\";\nimport { pagesSource } from \"./pages.js\";\nimport { stylesSource } from \"./styles.js\";\n\nconst { values } = parseArgs({\n  options: {\n    src: { type: \"string\", default: \"src\" },\n    out: { type: \"string\", default: \"dist\" },\n    watch: { type: \"boolean\", default: false },\n    minify: { type: \"boolean\", default: false },\n  },\n});\n\nconst srcDir = values.src!;\n\nasync function build(): Promise<void> {\n  const locations = await resolveLocations({ src: srcDir, out: values.out! });\n  const outFile = path.join(locations.outDir, \"app.html\");\n  const entryFile = path.join(locations.outDir, \"client-entry.ts\");\n  const clientFile = path.join(locations.outDir, \"client.js\");\n\n  const scans = await scanAll(locations, srcDir, locations.importsFile);\n\n  await mkdir(locations.outDir, { recursive: true });\n  const declared = await loadDeclared(\n    locations.pages,\n    locations.pageSources,\n    locations.outDir,\n  );\n  const { html, usedTags } = await assemble({ ...locations, scans, declared });\n  await writeFile(outFile, html, \"utf-8\");\n\n  const { resolved } = resolveElements({ used: usedTags, scans });\n  await checkReservedMethods(resolved);\n  await writeFile(\n    entryFile,\n    clientEntrySource(resolved, locations.outDir),\n    \"utf-8\",\n  );\n  await esbuild.build({\n    entryPoints: [entryFile],\n    bundle: true,\n    format: \"iife\",\n    outfile: clientFile,\n    minify: values.minify,\n  });\n\n  const generatedPages = pagesSource(\n    locations.pages,\n    locations.pageSources,\n    locations.outDir,\n    locations.packageName,\n  );\n  let pagesMessage = \"\";\n  if (generatedPages) {\n    const pagesFile = path.join(locations.outDir, \"pages.ts\");\n    await writeFile(pagesFile, generatedPages, \"utf-8\");\n    pagesMessage = ` and ${pagesFile}`;\n  }\n\n  const concatenatedCss = await stylesSource(cssFrom(scans));\n  let cssMessage = \"\";\n  if (concatenatedCss) {\n    const cssFile = path.join(locations.outDir, \"app.css\");\n    const generatedCss = values.minify\n      ? (\n          await esbuild.transform(concatenatedCss, {\n            loader: \"css\",\n            minify: true,\n          })\n        ).code\n      : concatenatedCss;\n    await writeFile(cssFile, generatedCss, \"utf-8\");\n    cssMessage = ` and ${cssFile}`;\n  }\n\n  console.log(\n    `loadbare-app-build: wrote ${outFile} and ${clientFile}${pagesMessage}${cssMessage} ` +\n      `(${resolved.size} custom element${resolved.size === 1 ? \"\" : \"s\"})`,\n  );\n}\n\nasync function main(): Promise<void> {\n  try {\n    await build();\n  } catch (err) {\n    console.error(`loadbare-app-build: ${(err as Error).message}`);\n    if (!values.watch) {\n      process.exitCode = 1;\n      return;\n    }\n  }\n\n  if (!values.watch) return;\n\n  console.log(`loadbare-app-build: watching ${srcDir}`);\n  const watcher = watch(srcDir, { recursive: true });\n  for await (const event of watcher) {\n    if (\n      !event.filename?.endsWith(\".html\") &&\n      !event.filename?.endsWith(\".ts\") &&\n      !event.filename?.endsWith(\".css\")\n    )\n      continue;\n    try {\n      await build();\n    } catch (err) {\n      console.error(`loadbare-app-build: ${(err as Error).message}`);\n    }\n  }\n}\n\nvoid main();\n"]}

package/dist/build/declared.d.ts

@@ -0,0 +1,25 @@
+/**
+ * What each page declares: the names its queries, its declared requests and
+ * its `crud` entries answer to, read so the markup can be checked against
+ * them before anything ships — see build/assemble.ts.
+ *
+ * The names are read off the finished objects rather than out of the
+ * source, so they are exact however a module builds them. The page modules
+ * are bundled from build/pages.ts's `declaredSource`, with every package
+ * left external, into a module beside `pages.ts` in `outDir`, so it resolves
+ * packages as `pages.ts` does. That module is imported and removed. The
+ * build therefore runs each page module's import-time code, as the server
+ * does when it starts.
+ */
+import type { PageFile, PageSource } from "./locations.js";
+/** One page's names. */
+export interface Declared {
+    queries: Set<string>;
+    handlers: Set<string>;
+    /** By query name, the `Crud` keys declared for it: `rowInsert` and the rest. */
+    crud: Map<string, Set<string>>;
+}
+/** By page name, every page, including one with no page modules. */
+export type DeclaredPages = Map<string, Declared>;
+export declare function loadDeclared(pages: PageFile[], pageSources: Map<string, PageSource>, outDir: string): Promise<DeclaredPages>;
+//# sourceMappingURL=declared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"declared.d.ts","sourceRoot":"","sources":["../../build/declared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG3D,wBAAwB;AACxB,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,gFAAgF;IAChF,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CAChC;AAED,oEAAoE;AACpE,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAkBlD,wBAAsB,YAAY,CAChC,KAAK,EAAE,QAAQ,EAAE,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC,CAiCxB"}

package/dist/build/declared.js

@@ -0,0 +1,62 @@
+/**
+ * What each page declares: the names its queries, its declared requests and
+ * its `crud` entries answer to, read so the markup can be checked against
+ * them before anything ships — see build/assemble.ts.
+ *
+ * The names are read off the finished objects rather than out of the
+ * source, so they are exact however a module builds them. The page modules
+ * are bundled from build/pages.ts's `declaredSource`, with every package
+ * left external, into a module beside `pages.ts` in `outDir`, so it resolves
+ * packages as `pages.ts` does. That module is imported and removed. The
+ * build therefore runs each page module's import-time code, as the server
+ * does when it starts.
+ */
+import { mkdir, rm } from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import * as esbuild from "esbuild";
+import { declaredSource } from "./pages.js";
+function namesOf(page) {
+    return {
+        queries: new Set(Object.keys(page?.queries ?? {})),
+        handlers: new Set(Object.keys(page?.requests.handlers ?? {})),
+        crud: new Map(Object.entries(page?.requests.crud ?? {}).map(([query, crud]) => [
+            query,
+            new Set(Object.keys(crud)),
+        ])),
+    };
+}
+/** Each import gets a module of its own, so a rebuild under --watch reads the files as they now are. */
+let generation = 0;
+export async function loadDeclared(pages, pageSources, outDir) {
+    let loaded = {};
+    if (pageSources.size > 0) {
+        const file = path.join(outDir, `.lb-declared-${process.pid}-${++generation}.mjs`);
+        try {
+            await mkdir(outDir, { recursive: true });
+            await esbuild.build({
+                stdin: {
+                    contents: declaredSource(pages, pageSources, outDir),
+                    resolveDir: outDir,
+                    sourcefile: "pages.ts",
+                    loader: "ts",
+                },
+                bundle: true,
+                platform: "node",
+                format: "esm",
+                packages: "external",
+                outfile: file,
+                logLevel: "silent",
+            });
+            ({ pages: loaded } = await import(pathToFileURL(file).href));
+        }
+        catch (err) {
+            throw new Error(`declared: could not load the page modules: ${err.message}`);
+        }
+        finally {
+            await rm(file, { force: true });
+        }
+    }
+    return new Map(pages.map(({ name }) => [name, namesOf(loaded[name])]));
+}
+//# sourceMappingURL=declared.js.map

package/dist/build/declared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declared.js","sourceRoot":"","sources":["../../build/declared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAGnC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAa5C,SAAS,OAAO,CAAC,IAAsB;IACrC,OAAO;QACL,OAAO,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;QAClD,QAAQ,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAC7D,IAAI,EAAE,IAAI,GAAG,CACX,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;YAC/D,KAAK;YACL,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC3B,CAAC,CACH;KACF,CAAC;AACJ,CAAC;AAED,wGAAwG;AACxG,IAAI,UAAU,GAAG,CAAC,CAAC;AAEnB,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAiB,EACjB,WAAoC,EACpC,MAAc;IAEd,IAAI,MAAM,GAAyB,EAAE,CAAC;IACtC,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CACpB,MAAM,EACN,gBAAgB,OAAO,CAAC,GAAG,IAAI,EAAE,UAAU,MAAM,CAClD,CAAC;QACF,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,MAAM,OAAO,CAAC,KAAK,CAAC;gBAClB,KAAK,EAAE;oBACL,QAAQ,EAAE,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC;oBACpD,UAAU,EAAE,MAAM;oBAClB,UAAU,EAAE,UAAU;oBACtB,MAAM,EAAE,IAAI;iBACb;gBACD,MAAM,EAAE,IAAI;gBACZ,QAAQ,EAAE,MAAM;gBAChB,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,UAAU;gBACpB,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,QAAQ;aACnB,CAAC,CAAC;YACH,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,8CAA+C,GAAa,CAAC,OAAO,EAAE,CACvE,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC","sourcesContent":["/**\n * What each page declares: the names its queries, its declared requests and\n * its `crud` entries answer to, read so the markup can be checked against\n * them before anything ships — see build/assemble.ts.\n *\n * The names are read off the finished objects rather than out of the\n * source, so they are exact however a module builds them. The page modules\n * are bundled from build/pages.ts's `declaredSource`, with every package\n * left external, into a module beside `pages.ts` in `outDir`, so it resolves\n * packages as `pages.ts` does. That module is imported and removed. The\n * build therefore runs each page module's import-time code, as the server\n * does when it starts.\n */\n\nimport { mkdir, rm } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport * as esbuild from \"esbuild\";\nimport type { Page } from \"../server/lb-server.js\";\nimport type { PageFile, PageSource } from \"./locations.js\";\nimport { declaredSource } from \"./pages.js\";\n\n/** One page's names. */\nexport interface Declared {\n  queries: Set<string>;\n  handlers: Set<string>;\n  /** By query name, the `Crud` keys declared for it: `rowInsert` and the rest. */\n  crud: Map<string, Set<string>>;\n}\n\n/** By page name, every page, including one with no page modules. */\nexport type DeclaredPages = Map<string, Declared>;\n\nfunction namesOf(page: Page | undefined): Declared {\n  return {\n    queries: new Set(Object.keys(page?.queries ?? {})),\n    handlers: new Set(Object.keys(page?.requests.handlers ?? {})),\n    crud: new Map(\n      Object.entries(page?.requests.crud ?? {}).map(([query, crud]) => [\n        query,\n        new Set(Object.keys(crud)),\n      ]),\n    ),\n  };\n}\n\n/** Each import gets a module of its own, so a rebuild under --watch reads the files as they now are. */\nlet generation = 0;\n\nexport async function loadDeclared(\n  pages: PageFile[],\n  pageSources: Map<string, PageSource>,\n  outDir: string,\n): Promise<DeclaredPages> {\n  let loaded: Record<string, Page> = {};\n  if (pageSources.size > 0) {\n    const file = path.join(\n      outDir,\n      `.lb-declared-${process.pid}-${++generation}.mjs`,\n    );\n    try {\n      await mkdir(outDir, { recursive: true });\n      await esbuild.build({\n        stdin: {\n          contents: declaredSource(pages, pageSources, outDir),\n          resolveDir: outDir,\n          sourcefile: \"pages.ts\",\n          loader: \"ts\",\n        },\n        bundle: true,\n        platform: \"node\",\n        format: \"esm\",\n        packages: \"external\",\n        outfile: file,\n        logLevel: \"silent\",\n      });\n      ({ pages: loaded } = await import(pathToFileURL(file).href));\n    } catch (err) {\n      throw new Error(\n        `declared: could not load the page modules: ${(err as Error).message}`,\n      );\n    } finally {\n      await rm(file, { force: true });\n    }\n  }\n  return new Map(pages.map(({ name }) => [name, namesOf(loaded[name])]));\n}\n"]}

package/dist/build/pages.d.ts

@@ -25,4 +25,10 @@ import type { PageFile, PageSource } from "./locations.js";
  * client entry beyond the built-ins.
  */
 export declare function pagesSource(pages: PageFile[], pageSources: Map<string, PageSource>, outDir: string, packageName: string): string | undefined;
+/**
+ * The same registry with no `createHub()`, exporting the `Pages` object
+ * itself, so the builder can read what each page declares — see
+ * build/declared.ts. Resolved from `outDir`, as `pages.ts` is.
+ */
+export declare function declaredSource(pages: PageFile[], pageSources: Map<string, PageSource>, outDir: string): string;
 //# sourceMappingURL=pages.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../build/pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;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"}
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../build/pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAgD3D;;;;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,CAcpB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,EAAE,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,MAAM,EAAE,MAAM,GACb,MAAM,CAMR"}