@loadbare/app 0.18.2 → 0.19.0

package/dist/build/pages.js

@@ -27,17 +27,9 @@ function relativeImport(outDir, file) {
     const rel = path.relative(outDir, file).split(path.sep).join("/");
     return rel.startsWith(".") ? rel : `./${rel}`;
 }
-/**
- * `undefined` when no page has a requests or queries file — the caller writes
- * nothing in that case, the same way an app with no custom elements gets no
- * client entry beyond the built-ins.
- */
-export function pagesSource(pages, pageSources, outDir, packageName) {
-    if (pageSources.size === 0)
-        return undefined;
-    const imports = [
-        `import { createHub } from ${JSON.stringify(`${packageName}/server`)};`,
-    ];
+/** An import of each page's modules, and its `Pages` entry naming them. */
+function pageEntries(pages, pageSources, outDir) {
+    const imports = [];
     const entries = [];
     for (const { name } of pages) {
         const source = pageSources.get(name);
@@ -55,6 +47,34 @@ export function pagesSource(pages, pageSources, outDir, packageName) {
         }
         entries.push(`  ${JSON.stringify(name)}: { requests: ${requestsId ?? "{}"}, queries: ${queriesId ?? "{}"} },`);
     }
-    return ([...imports, "", "export const hub = createHub({", ...entries, "});"].join("\n") + "\n");
+    return { imports, entries };
+}
+/**
+ * `undefined` when no page has a requests or queries file — the caller writes
+ * nothing in that case, the same way an app with no custom elements gets no
+ * client entry beyond the built-ins.
+ */
+export function pagesSource(pages, pageSources, outDir, packageName) {
+    if (pageSources.size === 0)
+        return undefined;
+    const { imports, entries } = pageEntries(pages, pageSources, outDir);
+    return ([
+        `import { createHub } from ${JSON.stringify(`${packageName}/server`)};`,
+        ...imports,
+        "",
+        "export const hub = createHub({",
+        ...entries,
+        "});",
+    ].join("\n") + "\n");
+}
+/**
+ * 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 function declaredSource(pages, pageSources, outDir) {
+    const { imports, entries } = pageEntries(pages, pageSources, outDir);
+    return ([...imports, "", "export const pages = {", ...entries, "};"].join("\n") +
+        "\n");
 }
 //# sourceMappingURL=pages.js.map

package/dist/build/pages.js.map

@@ -1 +1 @@
-{"version":3,"file":"pages.js","sourceRoot":"","sources":["../../build/pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,qFAAqF;AACrF,SAAS,UAAU,CAAC,IAAY,EAAE,MAA8B;IAC9D,OAAO,QAAQ,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,cAAc,CAAC,MAAc,EAAE,IAAY;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClE,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,KAAiB,EACjB,WAAoC,EACpC,MAAc,EACd,WAAmB;IAEnB,IAAI,WAAW,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE7C,MAAM,OAAO,GAAa;QACxB,6BAA6B,IAAI,CAAC,SAAS,CAAC,GAAG,WAAW,SAAS,CAAC,GAAG;KACxE,CAAC;IACF,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM;YAAE,SAAS;QAEtB,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ;YAChC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC;YAC9B,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE3E,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CACV,wBAAwB,UAAU,WAAW,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CACxG,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CACV,uBAAuB,SAAS,WAAW,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CACrG,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,IAAI,CACV,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,iBAAiB,UAAU,IAAI,IAAI,cAAc,SAAS,IAAI,IAAI,KAAK,CACjG,CAAC;IACJ,CAAC;IAED,OAAO,CACL,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,gCAAgC,EAAE,GAAG,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,CACxE,IAAI,CACL,GAAG,IAAI,CACT,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Generating the hub's page registry — the server-side counterpart to\n * build/elements.ts's client entry point.\n *\n * `*.requests.ts` and `*.queries.ts` are ordinary TypeScript, found by\n * build/locations.ts and handed here already paired by page name. This\n * module writes an import of each pair, a `Pages` object naming them by\n * page, and the one `createHub()` call. It is written to `<out>/pages.ts` rather than compiled\n * — the application runs it directly, exactly as it does its own server\n * code, so it never needs a bundler step the way the browser-bound client\n * entry does.\n *\n * Each import keeps its `.ts` extension. Node's loader, including its own\n * type stripping, looks for exactly the path it is given and never tries an\n * extension, so a path without one runs under tsx and nowhere else.\n *\n * Nothing here is emitted for a page with neither a requests nor a queries\n * file — a purely static page needs no hub entry, and createHub is only\n * called at all when there is at least one.\n */\n\nimport path from \"node:path\";\nimport type { PageFile, PageSource } from \"./locations.js\";\n\n/** A page name may contain anything a filename can; an import identifier may not. */\nfunction identifier(name: string, suffix: \"Requests\" | \"Queries\"): string {\n  return `page_${name.replace(/[^a-zA-Z0-9]/g, \"_\")}_${suffix}`;\n}\n\nfunction relativeImport(outDir: string, file: string): string {\n  const rel = path.relative(outDir, file).split(path.sep).join(\"/\");\n  return rel.startsWith(\".\") ? rel : `./${rel}`;\n}\n\n/**\n * `undefined` when no page has a requests or queries file — the caller writes\n * nothing in that case, the same way an app with no custom elements gets no\n * client entry beyond the built-ins.\n */\nexport function pagesSource(\n  pages: PageFile[],\n  pageSources: Map<string, PageSource>,\n  outDir: string,\n  packageName: string,\n): string | undefined {\n  if (pageSources.size === 0) return undefined;\n\n  const imports: string[] = [\n    `import { createHub } from ${JSON.stringify(`${packageName}/server`)};`,\n  ];\n  const entries: string[] = [];\n\n  for (const { name } of pages) {\n    const source = pageSources.get(name);\n    if (!source) continue;\n\n    const requestsId = source.requests\n      ? identifier(name, \"Requests\")\n      : undefined;\n    const queriesId = source.queries ? identifier(name, \"Queries\") : undefined;\n\n    if (source.requests) {\n      imports.push(\n        `import { requests as ${requestsId} } from ${JSON.stringify(relativeImport(outDir, source.requests))};`,\n      );\n    }\n    if (source.queries) {\n      imports.push(\n        `import { queries as ${queriesId} } from ${JSON.stringify(relativeImport(outDir, source.queries))};`,\n      );\n    }\n\n    entries.push(\n      `  ${JSON.stringify(name)}: { requests: ${requestsId ?? \"{}\"}, queries: ${queriesId ?? \"{}\"} },`,\n    );\n  }\n\n  return (\n    [...imports, \"\", \"export const hub = createHub({\", ...entries, \"});\"].join(\n      \"\\n\",\n    ) + \"\\n\"\n  );\n}\n"]}
+{"version":3,"file":"pages.js","sourceRoot":"","sources":["../../build/pages.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Generating the hub's page registry — the server-side counterpart to\n * build/elements.ts's client entry point.\n *\n * `*.requests.ts` and `*.queries.ts` are ordinary TypeScript, found by\n * build/locations.ts and handed here already paired by page name. This\n * module writes an import of each pair, a `Pages` object naming them by\n * page, and the one `createHub()` call. It is written to `<out>/pages.ts` rather than compiled\n * — the application runs it directly, exactly as it does its own server\n * code, so it never needs a bundler step the way the browser-bound client\n * entry does.\n *\n * Each import keeps its `.ts` extension. Node's loader, including its own\n * type stripping, looks for exactly the path it is given and never tries an\n * extension, so a path without one runs under tsx and nowhere else.\n *\n * Nothing here is emitted for a page with neither a requests nor a queries\n * file — a purely static page needs no hub entry, and createHub is only\n * called at all when there is at least one.\n */\n\nimport path from \"node:path\";\nimport type { PageFile, PageSource } from \"./locations.js\";\n\n/** A page name may contain anything a filename can; an import identifier may not. */\nfunction identifier(name: string, suffix: \"Requests\" | \"Queries\"): string {\n  return `page_${name.replace(/[^a-zA-Z0-9]/g, \"_\")}_${suffix}`;\n}\n\nfunction relativeImport(outDir: string, file: string): string {\n  const rel = path.relative(outDir, file).split(path.sep).join(\"/\");\n  return rel.startsWith(\".\") ? rel : `./${rel}`;\n}\n\n/** An import of each page's modules, and its `Pages` entry naming them. */\nfunction pageEntries(\n  pages: PageFile[],\n  pageSources: Map<string, PageSource>,\n  outDir: string,\n): { imports: string[]; entries: string[] } {\n  const imports: string[] = [];\n  const entries: string[] = [];\n\n  for (const { name } of pages) {\n    const source = pageSources.get(name);\n    if (!source) continue;\n\n    const requestsId = source.requests\n      ? identifier(name, \"Requests\")\n      : undefined;\n    const queriesId = source.queries ? identifier(name, \"Queries\") : undefined;\n\n    if (source.requests) {\n      imports.push(\n        `import { requests as ${requestsId} } from ${JSON.stringify(relativeImport(outDir, source.requests))};`,\n      );\n    }\n    if (source.queries) {\n      imports.push(\n        `import { queries as ${queriesId} } from ${JSON.stringify(relativeImport(outDir, source.queries))};`,\n      );\n    }\n\n    entries.push(\n      `  ${JSON.stringify(name)}: { requests: ${requestsId ?? \"{}\"}, queries: ${queriesId ?? \"{}\"} },`,\n    );\n  }\n  return { imports, entries };\n}\n\n/**\n * `undefined` when no page has a requests or queries file — the caller writes\n * nothing in that case, the same way an app with no custom elements gets no\n * client entry beyond the built-ins.\n */\nexport function pagesSource(\n  pages: PageFile[],\n  pageSources: Map<string, PageSource>,\n  outDir: string,\n  packageName: string,\n): string | undefined {\n  if (pageSources.size === 0) return undefined;\n\n  const { imports, entries } = pageEntries(pages, pageSources, outDir);\n  return (\n    [\n      `import { createHub } from ${JSON.stringify(`${packageName}/server`)};`,\n      ...imports,\n      \"\",\n      \"export const hub = createHub({\",\n      ...entries,\n      \"});\",\n    ].join(\"\\n\") + \"\\n\"\n  );\n}\n\n/**\n * The same registry with no `createHub()`, exporting the `Pages` object\n * itself, so the builder can read what each page declares — see\n * build/declared.ts. Resolved from `outDir`, as `pages.ts` is.\n */\nexport function declaredSource(\n  pages: PageFile[],\n  pageSources: Map<string, PageSource>,\n  outDir: string,\n): string {\n  const { imports, entries } = pageEntries(pages, pageSources, outDir);\n  return (\n    [...imports, \"\", \"export const pages = {\", ...entries, \"};\"].join(\"\\n\") +\n    \"\\n\"\n  );\n}\n"]}

package/docs/TECHREF-1.0.md

@@ -5,68 +5,6 @@ This is the complete technical reference to the upcoming Release 1.0.
 Method-of-work is to continually revise this document to what we want
 to be true, then revise the code, docs, and tests to ensure it is true.
 
-## Blockers
-
-We cannot declare 1.0 until we determine if these blockers can be
-added later w/o breaking changes.  If we are reasonably confident
-that they can be decided later w/o breaking changes, then we rename
-them to "Out of Scope" or move them to the roadmap.  Otherwise, 
-they must be resolved before we declare 1.0.
-
-### Nested queries
-
-Imagine an HTML `<select>` that shows a fixed set of choices on every row of
-a table, such as `customer_type` for a table of customers.  When every
-customer may take every customer type, the system as written today is
-fine, because every `<select>` receives the same rows.
-
-But the allowed values may depend on other values in the row.
-
-- **Decide whether a nested query's rows may depend on its row.** A nested
-  query has one answer, which every live row receives.  See
-  [Master-detail](#master-detail) for what a nested query is for.
-
-```html
-<tbody lb-query="accounts">
-  <template><tr>
-    <td lb-column="name"></td>
-    <td><select lb-query="statuses" lb-column="status"><template><option lb-column="label"></option></template></select></td>
-  </tr></template>
-</tbody>
-```
-
-### The server API
-
-- **Land `staticRoutes`.**  It closes the last place where an
-  application hand-writes facts the builder owns.
-
-### The builder
-
-- **Adopt a configuration file and fold `imports.ts` into it.** It holds
-  `out`, `minify` and `imports`, and lives where `imports.ts` lives now, so a
-  repository with several applications gets one per application.  `--src`
-  stays a flag, since it is what locates the file.  State the precedence
-  between a flag and a key once.  Its key names join the permanent surface,
-  so this lands before 1.0 or not at all.  It reserves a key for the
-  roadmap's tree-shaking CSS by tag name.
-- **Confirm the three output names.** `app.html`, `client.js` and `app.css`
-  are about to be fixed in `staticRoutes` as well as in the builder.
-
-### The internal surface
-
-None of this is surface.  It is listed here because trimming it is free
-today and breaking after 1.0.
-
-- **Audit what the hub does.** Every routine it runs answers to an `lb-*`
-  attribute, a [reserved query](#reserved-queries), or a
-  [reserved event](#reserved-events) or [method](#reserved-methods).  Trim
-  whatever does not, and leave what stays clean: no dead code, no routine
-  written twice, no comment the code contradicts.
-- **Keep the rest as constants.** The endpoint, `index` and the timeout are
-  linkage between the builder and the hub rather than facts an application
-  varies.  Adding a knob for any of them buys a second shape of application
-  to reason about.
-
 ## The build
 
 ### Running the builder
@@ -173,8 +111,8 @@ it is sent to the browser on initial page load, no HTML is ever sent
 again.
 
 The developer writes `lb-*` attributes in markup.  Script never assigns
-them.  The hub and the builder write only their stamps, and the hub writes
-the `name` of a radio button in a row template.  See
+them.  The hub and the builder write only their stamps, apart from the
+few exceptions listed in [Miswarts](./miswarts.md).  See
 [The markup checks](#the-markup-checks).
 
 ### Expansion
@@ -1366,10 +1304,10 @@ new URL carries only the query parms the request names.
 
 Every load lands `lb-url`, and a parm the URL does not carry lands empty on
 every element naming it as a column, so a control shows what the address
-bar says after Back as well as after a reload.  This is the one exception
-to landing, where a row sets the columns it names and leaves the rest as
-they were: the hub reads the column names under `lb-query="lb-url"` and
-names each one in the row it lands.
+bar says after Back as well as after a reload
+([miswart](./miswarts.md#lb-url-lands-every-parm-it-names)): the hub reads the
+column names under `lb-query="lb-url"` and names each one in the row it
+lands.
 
 The hub sends the query parms with every round trip, a page load and a
 request alike.  The server passes them to `contextFor` — see
@@ -1518,6 +1456,15 @@ to build on any of these:
   reach the check.
 - `lb-request` naming a value that begins with `lb-` and is not one of the
   three request names.
+- `lb-query` naming a query the page does not declare.  `lb-url` and
+  `lb-choices` are the hub's, and every page and the chrome may name them.
+  The chrome belongs to no page, and names no other query.
+- `lb-request` naming a request the page does not declare under `handlers`.
+  The chrome sends none of them.
+- One of the three request names for a query whose `crud` entry does not
+  declare it, and any but `lb-row-update` for `lb-url` or `lb-choices`.  The
+  query is a form's own when the form carries `lb-query`, and otherwise the
+  nearest `lb-query` around the element.
 - `lb-url-link` on anything but an `<a>`.
 - `lb-url-push` on an element with no `lb-request`.
 - `lb-url-unknown` on anything but a `<dialog>`, and in the chrome, outside
@@ -1547,6 +1494,10 @@ whose name begins with `lb` and a capital and is not in
 
 `lb-column` with no ancestor row is allowed: the hub gathers from it.
 
+To know what each page declares, the builder loads the page's
+`.queries.ts` and `.requests.ts` modules, so their import-time code runs
+during the build, as it does when the server starts.
+
 Script never assigns an `lb-` attribute, so the markup states every one
 that exists, and checking the markup is sound.
 
@@ -1559,7 +1510,8 @@ uncommon, and Loadbare/app does not shape itself around them.
   by `name`, and a row template repeats one `name` in every live row.  The
   hub stamps each radio button's `name` with the `name` written, or its
   column when none is, followed by `-` and the live row's key, so each live
-  row holds a group of its own.
+  row holds a group of its own
+  ([miswart](./miswarts.md#radio-button-names-in-a-row-template)).
 - **Several rows not yet entered, each holding radio buttons.**  A
   [row not yet entered](#a-row-not-yet-entered) has an empty key, so the
   radio buttons of every such row share one `name` and form one group.
@@ -1821,9 +1773,12 @@ It has four optional keys.
 | `onChoices`   | Nothing               | Runs with every choice made on the page, each time the user makes one |
 
 The server resolves a declared request against `handlers`, and a request
-Loadbare provides against `crud` under the request's query.  A name with no
-entry there logs a server console warning naming the page and the missing
-entry, and answers 200 with no response items, so nothing lands and
+Loadbare provides against `crud` under the request's query.  The builder
+refuses markup naming a request the page does not declare; see
+[The markup checks](#the-markup-checks).  A name with no entry there can
+still arrive, from a widget's script or from outside the page, and it
+logs a server console warning naming the page and the missing entry, and
+answers 200 with no response items, so nothing lands and
 `lb-request-pending` clears from the element that issued the request.  A
 request carrying no name answers 400, and a `run` that throws answers 500.