@loadbare/app 0.9.0 → 0.10.0

package/dist/build/locations.js.map

@@ -1 +1 @@
-{"version":3,"file":"locations.js","sourceRoot":"","sources":["../../build/locations.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Finding the application's own files by what they're named, not by which\n * directory they happen to sit in.\n *\n * A page and a widget definition can be byte-for-byte identical markup —\n * the only thing that says which one a file is, is extrinsic to its\n * content. `pages/` vs. `widgets/` used to carry that meaning; here a\n * filename suffix does instead: `chrome.html` is the one chrome file, and\n * `*.page.html` is a page.\n *\n * A page's server half is named the same way: `*.requests.ts` and\n * `*.queries.ts` pair with a `*.page.html` by sharing its basename, and are\n * free to sit anywhere too. Either may be absent — a page with no data needs\n * neither — but one with no matching `*.page.html` is a naming mistake and\n * is rejected below.\n *\n * Widget definitions, widget scripts and stylesheets are not found here.\n * They arrive from more than one origin — this package's own widgets, an\n * imported package, or `src` — and all three are scanned the same way by\n * build/origins.ts. `src` is simply the last origin in that cascade.\n *\n * `--src` names the one tree scanned this way; `--out` names where the\n * build lands. Those, plus this package's own root (for its built-in\n * widgets and hub/), are the only locations this module resolves — every\n * other module takes the result as a plain parameter and never\n * reconstructs one of its own.\n */\n\nimport { readdir, readFile } from \"node:fs/promises\";\nimport type { Dirent } from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { findPackageRoot } from \"./package-root.js\";\nimport type { BuiltinDirs } from \"./origins.js\";\n\nexport { CUSTOM_ELEMENT_TAG } from \"./origins.js\";\n\nconst CHROME_FILENAME = \"chrome.html\";\nconst PAGE_SUFFIX = \".page.html\";\nconst HOOKS_SUFFIX = \".requests.ts\";\nconst QUERIES_SUFFIX = \".queries.ts\";\nconst IMPORTS_FILENAME = \"imports.ts\";\n\nexport interface PageFile {\n  name: string;\n  file: string;\n}\n\nexport interface PageSource {\n  /** Absolute path to the `.requests.ts` module, if this page has one. */\n  requests?: string;\n  /** Absolute path to the `.queries.ts` module, if this page has one. */\n  queries?: string;\n}\n\ninterface Discovered {\n  chromeCandidates: string[];\n  pages: PageFile[];\n  pageSources: Map<string, PageSource>;\n  importsCandidates: string[];\n}\n\n/** The raw walk, with no uniqueness checks — usable on its own by anything that does not need a chrome file. */\nexport async function discoverSrc(src: string): Promise<Discovered> {\n  const chromeCandidates: string[] = [];\n  const pages: PageFile[] = [];\n  const pageSources = new Map<string, PageSource>();\n  const importsCandidates: string[] = [];\n\n  let entries: Dirent[];\n  try {\n    entries = await readdir(src, { withFileTypes: true, recursive: true });\n  } catch {\n    entries = [];\n  }\n\n  const pageSource = (name: string): PageSource => {\n    let p = pageSources.get(name);\n    if (!p) {\n      p = {};\n      pageSources.set(name, p);\n    }\n    return p;\n  };\n\n  for (const entry of entries) {\n    if (!entry.isFile()) continue;\n    const file = path.join(entry.parentPath, entry.name);\n\n    if (entry.name === IMPORTS_FILENAME) {\n      importsCandidates.push(file);\n    } else if (entry.name === CHROME_FILENAME) {\n      chromeCandidates.push(file);\n    } else if (entry.name.endsWith(PAGE_SUFFIX)) {\n      pages.push({ name: entry.name.slice(0, -PAGE_SUFFIX.length), file });\n    } else if (entry.name.endsWith(HOOKS_SUFFIX)) {\n      pageSource(entry.name.slice(0, -HOOKS_SUFFIX.length)).requests = file;\n    } else if (entry.name.endsWith(QUERIES_SUFFIX)) {\n      pageSource(entry.name.slice(0, -QUERIES_SUFFIX.length)).queries = file;\n    }\n  }\n\n  pages.sort((a, b) => a.name.localeCompare(b.name));\n  return { chromeCandidates, pages, pageSources, importsCandidates };\n}\n\nexport type PackageInfo = BuiltinDirs;\n\nexport async function packageInfo(): Promise<PackageInfo> {\n  const here = path.dirname(fileURLToPath(import.meta.url));\n  const root = await findPackageRoot(here);\n  let pkg: { name: string };\n  try {\n    pkg = JSON.parse(await readFile(path.join(root, \"package.json\"), \"utf-8\"));\n  } catch (err) {\n    throw new Error(\n      `locations: could not read '${root}/package.json': ${(err as Error).message}`,\n    );\n  }\n  return {\n    // `hub/` beside this module, not beside package.json: running from source\n    // that is the package's own hub/, and running compiled it is dist/hub —\n    // the one an installed package ships, since `files` carries dist and not\n    // the source tree.\n    builtinHubDir: path.join(path.dirname(here), \"hub\"),\n    packageName: pkg.name,\n  };\n}\n\nexport interface LocationArgs {\n  /** The application's source tree, e.g. \"src\". Scanned as a whole — see this file's header. */\n  src: string;\n  out: string;\n}\n\nexport interface Locations extends PackageInfo {\n  srcDir: string;\n  chromeFile: string;\n  pages: PageFile[];\n  pageSources: Map<string, PageSource>;\n  importsFile?: string;\n  outDir: string;\n}\n\nexport async function resolveLocations(args: LocationArgs): Promise<Locations> {\n  const [info, discovered] = await Promise.all([\n    packageInfo(),\n    discoverSrc(args.src),\n  ]);\n  const { chromeCandidates, importsCandidates, pages, pageSources } =\n    discovered;\n\n  if (chromeCandidates.length === 0) {\n    throw new Error(\n      `locations: no ${CHROME_FILENAME} file found under '${args.src}'`,\n    );\n  }\n  if (chromeCandidates.length > 1) {\n    throw new Error(\n      `locations: more than one ${CHROME_FILENAME} file found under '${args.src}': ` +\n        chromeCandidates.join(\", \"),\n    );\n  }\n  if (importsCandidates.length > 1) {\n    throw new Error(\n      `locations: more than one ${IMPORTS_FILENAME} found under '${args.src}': ` +\n        importsCandidates.join(\", \"),\n    );\n  }\n\n  // Sorted by name above, so duplicates are adjacent. A stub is the page's\n  // whole identity — its route, its template and its server half all key on\n  // it — so two files claiming one stub is a naming mistake, not a merge.\n  for (let i = 1; i < pages.length; i++) {\n    const [prev, here] = [pages[i - 1]!, pages[i]!];\n    if (prev.name === here.name) {\n      throw new Error(\n        `locations: more than one '${here.name}${PAGE_SUFFIX}' found under ` +\n          `'${args.src}': ${prev.file}, ${here.file}; the page namespace is ` +\n          `flat, so a stub names one page`,\n      );\n    }\n  }\n\n  const pageNames = new Set(pages.map((p) => p.name));\n  for (const name of pageSources.keys()) {\n    if (!pageNames.has(name)) {\n      throw new Error(\n        `locations: '${name}${HOOKS_SUFFIX}' or '${name}${QUERIES_SUFFIX}' found under ` +\n          `'${args.src}' but there is no '${name}${PAGE_SUFFIX}'`,\n      );\n    }\n  }\n\n  return {\n    ...info,\n    srcDir: args.src,\n    chromeFile: chromeCandidates[0]!,\n    pages,\n    pageSources,\n    ...(importsCandidates[0] ? { importsFile: importsCandidates[0] } : {}),\n    outDir: args.out,\n  };\n}\n"]}
+{"version":3,"file":"locations.js","sourceRoot":"","sources":["../../build/locations.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Finding the application's own files by what they're named, not by which\n * directory they happen to sit in.\n *\n * A page and a widget definition can be byte-for-byte identical markup —\n * the only thing that says which one a file is, is extrinsic to its\n * content. A filename suffix carries that meaning: `chrome.html` is the one\n * chrome file, and `*.page.html` is a page.\n *\n * A page's server half is named the same way: `*.requests.ts` and\n * `*.queries.ts` pair with a `*.page.html` by sharing its basename, and are\n * free to sit anywhere too. Either may be absent — a page with no data needs\n * neither — but one with no matching `*.page.html` is a naming mistake and\n * is rejected below.\n *\n * Widget definitions, widget scripts and stylesheets are not found here.\n * They arrive from more than one origin — this package's own widgets, an\n * imported package, or `src` — and all three are scanned the same way by\n * build/origins.ts. `src` is simply the last origin in that cascade.\n *\n * `--src` names the one tree scanned this way; `--out` names where the\n * build lands. Those, plus this package's own root (for its built-in\n * widgets and hub/), are the only locations this module resolves — every\n * other module takes the result as a plain parameter and never\n * reconstructs one of its own.\n */\n\nimport { readdir, readFile } from \"node:fs/promises\";\nimport type { Dirent } from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { findPackageRoot } from \"./package-root.js\";\nimport type { BuiltinDirs } from \"./origins.js\";\n\nexport { CUSTOM_ELEMENT_TAG } from \"./origins.js\";\n\nconst CHROME_FILENAME = \"chrome.html\";\nconst PAGE_SUFFIX = \".page.html\";\nconst HOOKS_SUFFIX = \".requests.ts\";\nconst QUERIES_SUFFIX = \".queries.ts\";\nconst IMPORTS_FILENAME = \"imports.ts\";\n\nexport interface PageFile {\n  name: string;\n  file: string;\n}\n\nexport interface PageSource {\n  /** Absolute path to the `.requests.ts` module, if this page has one. */\n  requests?: string;\n  /** Absolute path to the `.queries.ts` module, if this page has one. */\n  queries?: string;\n}\n\ninterface Discovered {\n  chromeCandidates: string[];\n  pages: PageFile[];\n  pageSources: Map<string, PageSource>;\n  importsCandidates: string[];\n}\n\n/** The raw walk, with no uniqueness checks — usable on its own by anything that does not need a chrome file. */\nexport async function discoverSrc(src: string): Promise<Discovered> {\n  const chromeCandidates: string[] = [];\n  const pages: PageFile[] = [];\n  const pageSources = new Map<string, PageSource>();\n  const importsCandidates: string[] = [];\n\n  let entries: Dirent[];\n  try {\n    entries = await readdir(src, { withFileTypes: true, recursive: true });\n  } catch {\n    entries = [];\n  }\n\n  const pageSource = (name: string): PageSource => {\n    let p = pageSources.get(name);\n    if (!p) {\n      p = {};\n      pageSources.set(name, p);\n    }\n    return p;\n  };\n\n  for (const entry of entries) {\n    if (!entry.isFile()) continue;\n    const file = path.join(entry.parentPath, entry.name);\n\n    if (entry.name === IMPORTS_FILENAME) {\n      importsCandidates.push(file);\n    } else if (entry.name === CHROME_FILENAME) {\n      chromeCandidates.push(file);\n    } else if (entry.name.endsWith(PAGE_SUFFIX)) {\n      pages.push({ name: entry.name.slice(0, -PAGE_SUFFIX.length), file });\n    } else if (entry.name.endsWith(HOOKS_SUFFIX)) {\n      pageSource(entry.name.slice(0, -HOOKS_SUFFIX.length)).requests = file;\n    } else if (entry.name.endsWith(QUERIES_SUFFIX)) {\n      pageSource(entry.name.slice(0, -QUERIES_SUFFIX.length)).queries = file;\n    }\n  }\n\n  pages.sort((a, b) => a.name.localeCompare(b.name));\n  return { chromeCandidates, pages, pageSources, importsCandidates };\n}\n\nexport type PackageInfo = BuiltinDirs;\n\nexport async function packageInfo(): Promise<PackageInfo> {\n  const here = path.dirname(fileURLToPath(import.meta.url));\n  const root = await findPackageRoot(here);\n  let pkg: { name: string };\n  try {\n    pkg = JSON.parse(await readFile(path.join(root, \"package.json\"), \"utf-8\"));\n  } catch (err) {\n    throw new Error(\n      `locations: could not read '${root}/package.json': ${(err as Error).message}`,\n    );\n  }\n  return {\n    // `hub/` beside this module, not beside package.json: running from source\n    // that is the package's own hub/, and running compiled it is dist/hub —\n    // the one an installed package ships, since `files` carries dist and not\n    // the source tree.\n    builtinHubDir: path.join(path.dirname(here), \"hub\"),\n    packageName: pkg.name,\n  };\n}\n\nexport interface LocationArgs {\n  /** The application's source tree, e.g. \"src\". Scanned as a whole — see this file's header. */\n  src: string;\n  out: string;\n}\n\nexport interface Locations extends PackageInfo {\n  srcDir: string;\n  chromeFile: string;\n  pages: PageFile[];\n  pageSources: Map<string, PageSource>;\n  importsFile?: string;\n  outDir: string;\n}\n\nexport async function resolveLocations(args: LocationArgs): Promise<Locations> {\n  const [info, discovered] = await Promise.all([\n    packageInfo(),\n    discoverSrc(args.src),\n  ]);\n  const { chromeCandidates, importsCandidates, pages, pageSources } =\n    discovered;\n\n  if (chromeCandidates.length === 0) {\n    throw new Error(\n      `locations: no ${CHROME_FILENAME} file found under '${args.src}'`,\n    );\n  }\n  if (chromeCandidates.length > 1) {\n    throw new Error(\n      `locations: more than one ${CHROME_FILENAME} file found under '${args.src}': ` +\n        chromeCandidates.join(\", \"),\n    );\n  }\n  if (importsCandidates.length > 1) {\n    throw new Error(\n      `locations: more than one ${IMPORTS_FILENAME} found under '${args.src}': ` +\n        importsCandidates.join(\", \"),\n    );\n  }\n\n  // Sorted by name above, so duplicates are adjacent. A stub is the page's\n  // whole identity — its route, its template and its server half all key on\n  // it — so two files claiming one stub is a naming mistake, not a merge.\n  for (let i = 1; i < pages.length; i++) {\n    const [prev, here] = [pages[i - 1]!, pages[i]!];\n    if (prev.name === here.name) {\n      throw new Error(\n        `locations: more than one '${here.name}${PAGE_SUFFIX}' found under ` +\n          `'${args.src}': ${prev.file}, ${here.file}; the page namespace is ` +\n          `flat, so a stub names one page`,\n      );\n    }\n  }\n\n  const pageNames = new Set(pages.map((p) => p.name));\n  for (const name of pageSources.keys()) {\n    if (!pageNames.has(name)) {\n      throw new Error(\n        `locations: '${name}${HOOKS_SUFFIX}' or '${name}${QUERIES_SUFFIX}' found under ` +\n          `'${args.src}' but there is no '${name}${PAGE_SUFFIX}'`,\n      );\n    }\n  }\n\n  return {\n    ...info,\n    srcDir: args.src,\n    chromeFile: chromeCandidates[0]!,\n    pages,\n    pageSources,\n    ...(importsCandidates[0] ? { importsFile: importsCandidates[0] } : {}),\n    outDir: args.out,\n  };\n}\n"]}

package/dist/build/pages.d.ts

@@ -3,10 +3,9 @@
  * build/elements.ts's client entry point.
  *
  * `*.requests.ts` and `*.queries.ts` are ordinary TypeScript, found by
- * build/locations.ts and handed here already paired by page name. What this
- * module writes is the file an application used to hand-maintain: an import
- * of each pair, a `Pages` object naming them by page, and the one
- * `createHub()` call. It is written to `<out>/pages.ts` rather than compiled
+ * build/locations.ts and handed here already paired by page name. This
+ * module writes an import of each pair, a `Pages` object naming them by
+ * page, and the one `createHub()` call. It is written to `<out>/pages.ts` rather than compiled
  * — the application runs it directly, exactly as it does its own server
  * code, so it never needs a bundler step the way the browser-bound client
  * entry does.

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

@@ -1 +1 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../build/pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;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;AAY3D;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,QAAQ,EAAE,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAsCpB"}

package/dist/build/pages.js

@@ -3,10 +3,9 @@
  * build/elements.ts's client entry point.
  *
  * `*.requests.ts` and `*.queries.ts` are ordinary TypeScript, found by
- * build/locations.ts and handed here already paired by page name. What this
- * module writes is the file an application used to hand-maintain: an import
- * of each pair, a `Pages` object naming them by page, and the one
- * `createHub()` call. It is written to `<out>/pages.ts` rather than compiled
+ * build/locations.ts and handed here already paired by page name. This
+ * module writes an import of each pair, a `Pages` object naming them by
+ * page, and the one `createHub()` call. It is written to `<out>/pages.ts` rather than compiled
  * — the application runs it directly, exactly as it does its own server
  * code, so it never needs a bundler step the way the browser-bound client
  * entry does.

package/dist/build/pages.js.map

@@ -1 +1 @@
-{"version":3,"file":"pages.js","sourceRoot":"","sources":["../../build/pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;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. What this\n * module writes is the file an application used to hand-maintain: an import\n * of each pair, a `Pages` object naming them by page, and the one\n * `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":"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"]}

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

@@ -1,32 +1,33 @@
-export declare const ATTR_LIST = "lb-list";
-export declare const ATTR_ROW = "lb-row";
-export declare const ATTR_KEY = "lb-key";
-export declare const ATTR_KEY_VALUE = "lb-key-value";
-export declare const ATTR_CELL = "lb-cell";
+export declare const ATTR_QUERY = "lb-query";
+export declare const ATTR_COLUMN = "lb-column";
 export declare const ATTR_SHOW = "lb-show";
-export declare const ATTR_VALUE = "lb-value";
-export declare const ATTR_ROW_COUNT = "lb-row-count";
+export declare const ATTR_COLUMN_VALUE = "lb-column-value";
+export declare const ATTR_KEY_VALUE = "lb-key-value";
+export declare const ATTR_QUERY_ROW_COUNT = "lb-query-row-count";
+export declare const ATTR_REQUEST = "lb-request";
 export declare const LB_EVENT_NAME = "lb-request";
-export declare const ATTR_ACTION = "lb-action";
+export declare const ATTR_REQUEST_PENDING = "lb-request-pending";
+export declare const ATTR_REQUEST_ERROR = "lb-request-error";
 export declare const LB_RESERVED_PREFIX = "lb-";
-export declare const ACTION_ROW_INSERT = "lb-row-insert";
-export declare const ACTION_ROW_DELETE = "lb-row-delete";
-export declare const ACTION_ROW_UPDATE = "lb-row-update";
-export declare const LB_ACTIONS: readonly ["lb-row-insert", "lb-row-delete", "lb-row-update"];
-export declare const ATTR_SLOT = "lb-slot";
-export declare const ATTR_TEMPLATE = "lb-template";
-export declare const ATTR_NAV_LINK = "lb-nav-link";
-export declare const ATTR_QUERY_PARM = "lb-query-parm";
-export declare const ATTR_QUERY_PARM_PUSH = "lb-query-parm-push";
+export declare const REQUEST_ROW_INSERT = "lb-row-insert";
+export declare const REQUEST_ROW_UPDATE = "lb-row-update";
+export declare const REQUEST_ROW_DELETE = "lb-row-delete";
+export declare const LB_ROW_REQUESTS: readonly ["lb-row-insert", "lb-row-update", "lb-row-delete"];
+export declare const KIND_ROW = "row";
+export declare const KIND_ROWS = "rows";
+export declare const URL_QUERY = "lb-url";
+export declare const URL_COLUMN_PATH = "lb-path";
+export declare const URL_COLUMN_PAGE_LABEL = "lb-page-label";
+export declare const URL_COLUMN_PAGE_UNKNOWN = "lb-page-unknown";
+export declare const ATTR_URL_LINK = "lb-url-link";
+export declare const ATTR_URL_PUSH = "lb-url-push";
+export declare const ATTR_URL_UNKNOWN = "lb-url-unknown";
+export declare const ATTR_EXP_SLOT = "lb-exp-slot";
+export declare const ATTR_EXP_TEMPLATE = "lb-exp-template";
 export declare const ATTR_PAGE = "lb-page";
-export declare const NAV_ROW = "lb-navigation";
-export declare const NAV_CELL_LABEL = "page-label";
-export declare const NAV_CELL_URI = "page-uri";
-export declare const QUERY_PARMS_ROW = "lb-query-parms";
-export declare const ATTR_UNKNOWN_PAGE = "lb-unknown-page";
+export declare const ATTR_PAGE_TITLE = "lb-page-title";
+export declare const DEVELOPER_ATTRIBUTES: readonly ["lb-query", "lb-column", "lb-show", "lb-request", "lb-url-link", "lb-url-push", "lb-url-unknown"];
 export declare const HUB_TAG_NAME = "lb-hub";
-export declare const ATTR_PENDING = "lb-pending";
-export declare const ATTR_ERROR = "lb-error";
 export declare const LB_ENDPOINT = "/lb";
 export declare const LB_REQUEST_TIMEOUT_MS = 10000;
 //# sourceMappingURL=lb-constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"lb-constants.d.ts","sourceRoot":"","sources":["../../core/lb-constants.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,SAAS,YAAY,CAAC;AAQnC,eAAO,MAAM,QAAQ,WAAW,CAAC;AAMjC,eAAO,MAAM,QAAQ,WAAW,CAAC;AAMjC,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAQ7C,eAAO,MAAM,SAAS,YAAY,CAAC;AAanC,eAAO,MAAM,SAAS,YAAY,CAAC;AAEnC,eAAO,MAAM,UAAU,aAAa,CAAC;AAOrC,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAK7C,eAAO,MAAM,aAAa,eAAe,CAAC;AAS1C,eAAO,MAAM,WAAW,cAAc,CAAC;AAYvC,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAMxC,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAKjD,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAcjD,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAIjD,eAAO,MAAM,UAAU,8DAIb,CAAC;AAMX,eAAO,MAAM,SAAS,YAAY,CAAC;AAYnC,eAAO,MAAM,aAAa,gBAAgB,CAAC;AAK3C,eAAO,MAAM,aAAa,gBAAgB,CAAC;AAQ3C,eAAO,MAAM,eAAe,kBAAkB,CAAC;AAK/C,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AAMzD,eAAO,MAAM,SAAS,YAAY,CAAC;AAQnC,eAAO,MAAM,OAAO,kBAAkB,CAAC;AAKvC,eAAO,MAAM,cAAc,eAAe,CAAC;AAC3C,eAAO,MAAM,YAAY,aAAa,CAAC;AAWvC,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAUhD,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AAQnD,eAAO,MAAM,YAAY,WAAW,CAAC;AASrC,eAAO,MAAM,YAAY,eAAe,CAAC;AAOzC,eAAO,MAAM,UAAU,aAAa,CAAC;AASrC,eAAO,MAAM,WAAW,QAAQ,CAAC;AAIjC,eAAO,MAAM,qBAAqB,QAAS,CAAC"}
+{"version":3,"file":"lb-constants.d.ts","sourceRoot":"","sources":["../../core/lb-constants.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,UAAU,aAAa,CAAC;AAKrC,eAAO,MAAM,WAAW,cAAc,CAAC;AAavC,eAAO,MAAM,SAAS,YAAY,CAAC;AAKnC,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AAKnD,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAK7C,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AAKzD,eAAO,MAAM,YAAY,eAAe,CAAC;AAIzC,eAAO,MAAM,aAAa,eAAe,CAAC;AAI1C,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AAKzD,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AAOrD,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAIxC,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAClD,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAClD,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD,eAAO,MAAM,eAAe,8DAIlB,CAAC;AAGX,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,SAAS,SAAS,CAAC;AAKhC,eAAO,MAAM,SAAS,WAAW,CAAC;AAClC,eAAO,MAAM,eAAe,YAAY,CAAC;AACzC,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AACrD,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AAGzD,eAAO,MAAM,aAAa,gBAAgB,CAAC;AAI3C,eAAO,MAAM,aAAa,gBAAgB,CAAC;AAG3C,eAAO,MAAM,gBAAgB,mBAAmB,CAAC;AAMjD,eAAO,MAAM,aAAa,gBAAgB,CAAC;AAK3C,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AAGnD,eAAO,MAAM,SAAS,YAAY,CAAC;AAInC,eAAO,MAAM,eAAe,kBAAkB,CAAC;AAK/C,eAAO,MAAM,oBAAoB,6GAQvB,CAAC;AAQX,eAAO,MAAM,YAAY,WAAW,CAAC;AASrC,eAAO,MAAM,WAAW,QAAQ,CAAC;AAIjC,eAAO,MAAM,qBAAqB,QAAS,CAAC"}

package/dist/core/lb-constants.js

@@ -1,39 +1,21 @@
-// Every hub attribute name lives here. Nothing writes one as a string
+// Every Loadbare attribute name lives here. Nothing writes one as a string
 // literal — not a widget, not a page host, not a test. See
 // docs/reference/data-binding.md.
-// --- Binding (docs/reference/data-binding.md) ---------------------------
-// One containment ladder: a list holds rows, a row holds cells. Both scope
-// attributes take a name the server declares, and a nested one of either
-// kind begins a new scope.
-// Scopes DOM children to a named set of rows.
-export const ATTR_LIST = "lb-list";
-// Scopes DOM children to one named row.
-//
-// A single-row scope is read-only. Every write operation needs a key, and a
-// key exists only on a live row the hub stamped inside a list, so a declared
-// action is the only thing such a scope can send. An application that wants
-// a writable single row declares a list that answers with one row.
-export const ATTR_ROW = "lb-row";
-// Named on a row template by the developer: the column that identifies a row
-// of the list. A property of the list rather than of the template — a list
-// without a fixed key column is meaningless — but written where the rows
-// land, because that is the only place the page says anything about them.
-export const ATTR_KEY = "lb-key";
-// Stamped on a live row by the row machinery: that row's value of the column
-// ATTR_KEY names. Written by the hub, never by a developer, and read back by
-// whatever needs to know which row it is inside — a delete button, an update
-// form, a widget building its own request, or a stylesheet.
-export const ATTR_KEY_VALUE = "lb-key-value";
-// The column an element displays.
-//
-// Its value is a column name and never a cell name. A cell has no name of
-// its own: it is identified by its row and its column, and the row arrives
-// from scope, so the column is all that is left to say. ATTR_KEY holds a
-// column name for the same reason.
-export const ATTR_CELL = "lb-cell";
+// --- Landing (docs/reference/data-binding.md) ----------------------------
+// Everything is a query. The server answers every request with response
+// items, one per query, and each carries the query's kind and key. The
+// markup names a query and the columns it shows; it never repeats what the
+// server already declared.
+// Names the query whose rows land in an element's content. A nested one
+// begins a new query: what is inside it is that query's.
+export const ATTR_QUERY = "lb-query";
+// The column an element shows, read from the nearest ancestor row. On a
+// control the hub sets its value, and gathers it back under this name when
+// the control's request is issued.
+export const ATTR_COLUMN = "lb-column";
 // The column that decides whether an element is present: `null` and `false`
-// are off, and every other value is on. It binds by the same ancestor rule as
-// ATTR_CELL, and names a column for the same reason.
+// are off, and every other value is on. It reads from the nearest ancestor
+// row, as ATTR_COLUMN does.
 //
 // An element that is off is moved into a `<template>` carrying this attribute
 // and the same column, standing where the element stood, and moved back out
@@ -43,132 +25,91 @@ export const ATTR_CELL = "lb-cell";
 // branch in the document so the hub holds nothing. Landing reaches inside it,
 // so a branch that returns is already current; nothing else does.
 export const ATTR_SHOW = "lb-show";
-export const ATTR_VALUE = "lb-value";
-// Stamped on a list scope by the shared row machinery: how many rows it is
-// showing. Written by the hub and never bound to — it is derived from rows
-// the hub already knows, exactly as the section heading in lb-table is. A
-// list widget watches it, and it exists so that "no members yet" is a
-// stylesheet rule rather than a conditional in every list widget.
-export const ATTR_ROW_COUNT = "lb-row-count";
+// Stamped by the hub on every element it sets from a column: the value it
+// set, so a stylesheet can select on it and a custom element that is not a
+// control can render it.
+export const ATTR_COLUMN_VALUE = "lb-column-value";
+// Stamped by the hub on each live row, and on an element a `row` lands on
+// itself: the row's key. The key column is the query's, declared by the
+// server and carried by every response item.
+export const ATTR_KEY_VALUE = "lb-key-value";
+// Stamped by the hub on an element with a row template: how many live rows
+// it holds, so "no members yet" is a stylesheet rule rather than a
+// conditional in every widget.
+export const ATTR_QUERY_ROW_COUNT = "lb-query-row-count";
 // --- Requests (docs/reference/data-binding.md) --------------------------
-// One event name, used by a widget reaching the server and by a widget
-// reaching an ancestor widget.
+// Names the request an element issues when it commits: a form on submit, a
+// control on change, anything else on click.
+export const ATTR_REQUEST = "lb-request";
+// Every request travels as one bubbling event of this name, whoever issued
+// it, so an ancestor may stop it.
 export const LB_EVENT_NAME = "lb-request";
-// Names what an interaction asks for.
-//
-// One attribute name, one wire field, one set of values: the request field
-// `action` carries this attribute's value verbatim, and nothing is
-// translated in between. On a native element the hub turns the element's own
-// event into the request — a form submits, anything else clicks; on a
-// widget, the widget builds it from whatever interaction it owns.
-export const ATTR_ACTION = "lb-action";
+// Stamped on the element that issued a request while its round trip is in
+// flight, alongside aria-busy. A commit on an element carrying it is ignored.
+export const ATTR_REQUEST_PENDING = "lb-request-pending";
+// Stamped on the element that issued a request when its round trip failed —
+// a non-2xx response, a thrown application error, or a timeout, all alike.
+// Cleared at the start of that element's next request.
+export const ATTR_REQUEST_ERROR = "lb-request-error";
 // --- Reserved names ----------------------------------------------------
-// Loadbare owns every value beginning with this prefix, in every lb-*
-// attribute: a name so prefixed is the hub's own (NAV_ROW), and an
-// lb-action so prefixed is an operation (below). The server refuses a page
-// that declares a query or an action beginning with it, so a new reserved
-// name can never collide with one an application already uses.
-//
-// It is also the whole of the wire discriminant. A request whose `action`
-// begins with it is one of the three operations; anything else is a name the
-// page declared under its requests. Nothing else tells them apart.
+// Loadbare owns every name beginning with this prefix: attribute names, the
+// values of its attributes, query names, request names, the column names of
+// its own queries, custom element names and event names. The server refuses
+// a page that declares a query or a request so named.
 export const LB_RESERVED_PREFIX = "lb-";
-// On a <form> in a list scope: builds a new row on submit. The hub gathers
-// every lb-cell inside the form into a values map — no key, because there is
-// no row yet — and the form's own lb-list says which list it is inserting
-// into.
-export const ACTION_ROW_INSERT = "lb-row-insert";
-// Deletes the row the element is inside. Needs no declared name: it takes
-// only the row's own lb-list/lb-key-value binding, which is all the server
-// needs to know which row and whether the operation is permitted on it.
-export const ACTION_ROW_DELETE = "lb-row-delete";
-// Commits cells of the row the element is inside. From a <form> or a button,
-// on submit or click, the hub gathers the same values map as an insert, plus
-// the row's own lb-key-value: a form that is a list's row template root, or
-// sits inside one, has both from its ancestors exactly as a delete button
-// does.
-//
-// From an element carrying lb-cell — a widget wrapping one control — the
-// values map holds that one cell and nothing else, the way a control has a
-// value and a form has values. The widget decides when a change is made and
-// sends the action with its value; without one, the hub reads the control
-// the widget wraps. SQL has one UPDATE whether it sets one column or many,
-// and so there is one operation here.
-export const ACTION_ROW_UPDATE = "lb-row-update";
-// Every reserved lb-action, in one place, so the builder can refuse an
-// unknown one and the hub can refuse to send one it does not implement.
-export const LB_ACTIONS = [
-    ACTION_ROW_INSERT,
-    ACTION_ROW_DELETE,
-    ACTION_ROW_UPDATE,
+// The requests Loadbare provides. Each runs the page's crud declaration for
+// the request's query.
+export const REQUEST_ROW_INSERT = "lb-row-insert";
+export const REQUEST_ROW_UPDATE = "lb-row-update";
+export const REQUEST_ROW_DELETE = "lb-row-delete";
+export const LB_ROW_REQUESTS = [
+    REQUEST_ROW_INSERT,
+    REQUEST_ROW_UPDATE,
+    REQUEST_ROW_DELETE,
 ];
-// --- Expansion (docs/reference/custom-elements.md) ---------------------
-// Marks the element in a definition whose children receive the authored
-// inner content. An attribute rather than an element because HTML content
-// models discard foreign elements inside <select> and <table>.
-export const ATTR_SLOT = "lb-slot";
-// One name in two positions. In a definition it marks a destination; on an
-// authored <template> it names the destination that template is for, and the
-// template is unwrapped into it.
-//
-// It exists because the parser, not the content model, is the obstacle. A
-// <thead> written inside <lb-table> on a page is not in a table, so the
-// tokenizer drops the tag and keeps the text. A <template> survives anywhere
-// and its contents parse as if they were in a table, so wrapping the markup
-// is what gets it to expansion intact — and unwrapping it is what puts real
-// elements in the shipped document.
-export const ATTR_TEMPLATE = "lb-template";
-// --- Host channel (docs/reference/chrome.md) ---------------------------
-// Only anchors carrying this are intercepted, so external links are never
-// hijacked.
-export const ATTR_NAV_LINK = "lb-nav-link";
-// Names the query parm a control writes. The query string describes what is
-// on screen and never commands, so a control that narrows the page writes its
-// value into the address bar rather than sending it: the hub sets the one
-// parm, or deletes it when the value is empty, and loads the page at the new
-// URL. Every other parm is left as it is. Landed back onto the control from
-// the URL on every load, so a reload, a mailed link and Back all show it.
-export const ATTR_QUERY_PARM = "lb-query-parm";
-// Changing what the current page shows is not going anywhere, so a query parm
-// write replaces the history entry. A control carrying this pushes one
-// instead, for the rare parm a user would expect Back to undo.
-export const ATTR_QUERY_PARM_PUSH = "lb-query-parm-push";
-// A page host ships as <template lb-page="<name>">. An attribute rather than
-// an id: an id lives in the application's own namespace, where a page named
-// for something the chrome also ids would collide, and getElementById()
-// answers a collision by silently picking one.
+// --- Kinds --------------------------------------------------------------
+export const KIND_ROW = "row";
+export const KIND_ROWS = "rows";
+// --- The URL (docs/reference/chrome.md) ---------------------------------
+// The query the hub serves: one row, keyed by the path, whose other columns
+// are the query parms.
+export const URL_QUERY = "lb-url";
+export const URL_COLUMN_PATH = "lb-path";
+export const URL_COLUMN_PAGE_LABEL = "lb-page-label";
+export const URL_COLUMN_PAGE_UNKNOWN = "lb-page-unknown";
+// On an `<a>`: a plain primary click sets `lb-path` from the `href`.
+export const ATTR_URL_LINK = "lb-url-link";
+// On an element with `lb-request`: its update of `lb-url` pushes a history
+// entry instead of replacing one.
+export const ATTR_URL_PUSH = "lb-url-push";
+// On a `<dialog>`: the hub calls showModal() when `lb-page-unknown` is true.
+export const ATTR_URL_UNKNOWN = "lb-url-unknown";
+// --- Build time (docs/reference/custom-elements.md) ---------------------
+// Marks the element in an element file whose children receive the rest of
+// the custom element's content. An attribute rather than an element because
+// HTML content models discard foreign elements inside <select> and <table>.
+export const ATTR_EXP_SLOT = "lb-exp-slot";
+// One name in two positions. In an element file it marks a destination; on a
+// `<template>` in the custom element's content it names the destination
+// that template is for, and the template's content moves into it.
+export const ATTR_EXP_TEMPLATE = "lb-exp-template";
+// A page ships as <template lb-page="<stub>">.
 export const ATTR_PAGE = "lb-page";
-// The hub's own row. Landed on every navigation, on any subtree inside the
-// hub that names it, through the same applyData() a server answer goes
-// through — so a chrome displays where the page is the way it displays
-// anything else. One row rather than a list, so a subtree binds it with
-// lb-row. A reserved name (LB_RESERVED_PREFIX): the server refuses to
-// declare a query so named.
-export const NAV_ROW = "lb-navigation";
-// Its two columns. The label is the nav's: the text of the lb-nav-link
-// anchor whose href names the current page, and empty when no anchor does.
-// The URI is the path and query string as the browser has them.
-export const NAV_CELL_LABEL = "page-label";
-export const NAV_CELL_URI = "page-uri";
-// A server response that changes the query parms, in one row whose columns
-// are the parms. Returned from a request's run (write it with queryParms() in
-// server/lb-server.ts), because some values exist only once the write has
-// run: the key of a row just inserted, or the absence of one just deleted.
-// The server then loads the page at the query string with these parms set,
-// in the same round trip, and the hub writes them into the URL before
-// landing that load. An empty value takes the parm out. Only parms: the
-// path is never the server's to change, so this cannot redirect. A reserved
-// name (LB_RESERVED_PREFIX), so it never collides with a declared query.
-export const QUERY_PARMS_ROW = "lb-query-parms";
-// Marks the chrome's own <dialog> for a page name that resolves to no
-// template — a routing miss discovered client-side, not an HTTP 404 (every
-// route gets the same 200 response; see docs/tutorials/010-pages-and-navigation.md).
-// The hub only opens it; what it says comes from NAV_ROW, which the dialog
-// consumes like any other subtree, by naming it in lb-row. Optional: an
-// application that declares none gets today's console.error and nothing
-// more. The builder requires the element it's on to be a <dialog>
-// (build/assemble.ts), since the hub calls showModal() on it.
-export const ATTR_UNKNOWN_PAGE = "lb-unknown-page";
+// Stamped by the builder beside ATTR_PAGE: the text content of the page
+// file's `<title>`, which the builder removes.
+export const ATTR_PAGE_TITLE = "lb-page-title";
+// The attributes a developer writes. The builder refuses any other `lb-`
+// attribute in markup: the rest are stamps, written by the hub or the
+// builder and never by hand or by script.
+export const DEVELOPER_ATTRIBUTES = [
+    ATTR_QUERY,
+    ATTR_COLUMN,
+    ATTR_SHOW,
+    ATTR_REQUEST,
+    ATTR_URL_LINK,
+    ATTR_URL_PUSH,
+    ATTR_URL_UNKNOWN,
+];
 // The hub's own tag. It is exempt from the rule every other LB-* tag
 // follows: expansion does not require it to have a definition (build/expand.ts),
 // and the client build does not require it to have a script of its own
@@ -176,23 +117,9 @@ export const ATTR_UNKNOWN_PAGE = "lb-unknown-page";
 // registered once by the package's main entry point, not a widget an
 // application discovers or declares.
 export const HUB_TAG_NAME = "lb-hub";
-// --- Request lifecycle --------------------------------------------------
-// Stamped on the element that dispatched a request — the button, form, or
-// widget itself — for the duration of its round trip. It carries no
-// meaning beyond "in flight": a stylesheet dims the element, or a custom
-// button widget watches it to disable itself. The hub sets and clears it,
-// alongside aria-busy, and reads it in one place: a native action (a button
-// or form, not a widget) still pending ignores being performed again.
-export const ATTR_PENDING = "lb-pending";
-// Stamped on the same element if that round trip failed — a non-2xx
-// response, a thrown application error, or a timeout, all alike. Cleared at
-// the start of that element's next request. What (if anything) an
-// application shows for it is undecided; this is only the fact that it
-// happened.
-export const ATTR_ERROR = "lb-error";
 // --- Wire --------------------------------------------------------------
 // One path, one method: everything the hub asks of the server is a POST
-// below this path. The page name follows it, and the query string the
+// below this path. The page's stub follows it, and the query string the
 // browser is showing rides after that verbatim, so `/accounts?acct=23` asks
 // as `POST /lb/accounts?acct=23` and the server always knows what URL the
 // browser is showing. Navigation is therefore the only GET an application

package/dist/core/lb-constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"lb-constants.js","sourceRoot":"","sources":["../../core/lb-constants.ts"],"names":[],"mappings":"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","sourcesContent":["// Every hub attribute name lives here. Nothing writes one as a string\n// literal — not a widget, not a page host, not a test. See\n// docs/reference/data-binding.md.\n\n// --- Binding (docs/reference/data-binding.md) ---------------------------\n// One containment ladder: a list holds rows, a row holds cells. Both scope\n// attributes take a name the server declares, and a nested one of either\n// kind begins a new scope.\n\n// Scopes DOM children to a named set of rows.\nexport const ATTR_LIST = \"lb-list\";\n\n// Scopes DOM children to one named row.\n//\n// A single-row scope is read-only. Every write operation needs a key, and a\n// key exists only on a live row the hub stamped inside a list, so a declared\n// action is the only thing such a scope can send. An application that wants\n// a writable single row declares a list that answers with one row.\nexport const ATTR_ROW = \"lb-row\";\n\n// Named on a row template by the developer: the column that identifies a row\n// of the list. A property of the list rather than of the template — a list\n// without a fixed key column is meaningless — but written where the rows\n// land, because that is the only place the page says anything about them.\nexport const ATTR_KEY = \"lb-key\";\n\n// Stamped on a live row by the row machinery: that row's value of the column\n// ATTR_KEY names. Written by the hub, never by a developer, and read back by\n// whatever needs to know which row it is inside — a delete button, an update\n// form, a widget building its own request, or a stylesheet.\nexport const ATTR_KEY_VALUE = \"lb-key-value\";\n\n// The column an element displays.\n//\n// Its value is a column name and never a cell name. A cell has no name of\n// its own: it is identified by its row and its column, and the row arrives\n// from scope, so the column is all that is left to say. ATTR_KEY holds a\n// column name for the same reason.\nexport const ATTR_CELL = \"lb-cell\";\n\n// The column that decides whether an element is present: `null` and `false`\n// are off, and every other value is on. It binds by the same ancestor rule as\n// ATTR_CELL, and names a column for the same reason.\n//\n// An element that is off is moved into a `<template>` carrying this attribute\n// and the same column, standing where the element stood, and moved back out\n// when the column turns on. The builder ships every such element already\n// inside its template. A developer writes this attribute on an element and\n// never on a template: the template form is Loadbare's, and holds the absent\n// branch in the document so the hub holds nothing. Landing reaches inside it,\n// so a branch that returns is already current; nothing else does.\nexport const ATTR_SHOW = \"lb-show\";\n\nexport const ATTR_VALUE = \"lb-value\";\n\n// Stamped on a list scope by the shared row machinery: how many rows it is\n// showing. Written by the hub and never bound to — it is derived from rows\n// the hub already knows, exactly as the section heading in lb-table is. A\n// list widget watches it, and it exists so that \"no members yet\" is a\n// stylesheet rule rather than a conditional in every list widget.\nexport const ATTR_ROW_COUNT = \"lb-row-count\";\n\n// --- Requests (docs/reference/data-binding.md) --------------------------\n// One event name, used by a widget reaching the server and by a widget\n// reaching an ancestor widget.\nexport const LB_EVENT_NAME = \"lb-request\";\n\n// Names what an interaction asks for.\n//\n// One attribute name, one wire field, one set of values: the request field\n// `action` carries this attribute's value verbatim, and nothing is\n// translated in between. On a native element the hub turns the element's own\n// event into the request — a form submits, anything else clicks; on a\n// widget, the widget builds it from whatever interaction it owns.\nexport const ATTR_ACTION = \"lb-action\";\n\n// --- Reserved names ----------------------------------------------------\n// Loadbare owns every value beginning with this prefix, in every lb-*\n// attribute: a name so prefixed is the hub's own (NAV_ROW), and an\n// lb-action so prefixed is an operation (below). The server refuses a page\n// that declares a query or an action beginning with it, so a new reserved\n// name can never collide with one an application already uses.\n//\n// It is also the whole of the wire discriminant. A request whose `action`\n// begins with it is one of the three operations; anything else is a name the\n// page declared under its requests. Nothing else tells them apart.\nexport const LB_RESERVED_PREFIX = \"lb-\";\n\n// On a <form> in a list scope: builds a new row on submit. The hub gathers\n// every lb-cell inside the form into a values map — no key, because there is\n// no row yet — and the form's own lb-list says which list it is inserting\n// into.\nexport const ACTION_ROW_INSERT = \"lb-row-insert\";\n\n// Deletes the row the element is inside. Needs no declared name: it takes\n// only the row's own lb-list/lb-key-value binding, which is all the server\n// needs to know which row and whether the operation is permitted on it.\nexport const ACTION_ROW_DELETE = \"lb-row-delete\";\n\n// Commits cells of the row the element is inside. From a <form> or a button,\n// on submit or click, the hub gathers the same values map as an insert, plus\n// the row's own lb-key-value: a form that is a list's row template root, or\n// sits inside one, has both from its ancestors exactly as a delete button\n// does.\n//\n// From an element carrying lb-cell — a widget wrapping one control — the\n// values map holds that one cell and nothing else, the way a control has a\n// value and a form has values. The widget decides when a change is made and\n// sends the action with its value; without one, the hub reads the control\n// the widget wraps. SQL has one UPDATE whether it sets one column or many,\n// and so there is one operation here.\nexport const ACTION_ROW_UPDATE = \"lb-row-update\";\n\n// Every reserved lb-action, in one place, so the builder can refuse an\n// unknown one and the hub can refuse to send one it does not implement.\nexport const LB_ACTIONS = [\n  ACTION_ROW_INSERT,\n  ACTION_ROW_DELETE,\n  ACTION_ROW_UPDATE,\n] as const;\n\n// --- Expansion (docs/reference/custom-elements.md) ---------------------\n// Marks the element in a definition whose children receive the authored\n// inner content. An attribute rather than an element because HTML content\n// models discard foreign elements inside <select> and <table>.\nexport const ATTR_SLOT = \"lb-slot\";\n\n// One name in two positions. In a definition it marks a destination; on an\n// authored <template> it names the destination that template is for, and the\n// template is unwrapped into it.\n//\n// It exists because the parser, not the content model, is the obstacle. A\n// <thead> written inside <lb-table> on a page is not in a table, so the\n// tokenizer drops the tag and keeps the text. A <template> survives anywhere\n// and its contents parse as if they were in a table, so wrapping the markup\n// is what gets it to expansion intact — and unwrapping it is what puts real\n// elements in the shipped document.\nexport const ATTR_TEMPLATE = \"lb-template\";\n\n// --- Host channel (docs/reference/chrome.md) ---------------------------\n// Only anchors carrying this are intercepted, so external links are never\n// hijacked.\nexport const ATTR_NAV_LINK = \"lb-nav-link\";\n\n// Names the query parm a control writes. The query string describes what is\n// on screen and never commands, so a control that narrows the page writes its\n// value into the address bar rather than sending it: the hub sets the one\n// parm, or deletes it when the value is empty, and loads the page at the new\n// URL. Every other parm is left as it is. Landed back onto the control from\n// the URL on every load, so a reload, a mailed link and Back all show it.\nexport const ATTR_QUERY_PARM = \"lb-query-parm\";\n\n// Changing what the current page shows is not going anywhere, so a query parm\n// write replaces the history entry. A control carrying this pushes one\n// instead, for the rare parm a user would expect Back to undo.\nexport const ATTR_QUERY_PARM_PUSH = \"lb-query-parm-push\";\n\n// A page host ships as <template lb-page=\"<name>\">. An attribute rather than\n// an id: an id lives in the application's own namespace, where a page named\n// for something the chrome also ids would collide, and getElementById()\n// answers a collision by silently picking one.\nexport const ATTR_PAGE = \"lb-page\";\n\n// The hub's own row. Landed on every navigation, on any subtree inside the\n// hub that names it, through the same applyData() a server answer goes\n// through — so a chrome displays where the page is the way it displays\n// anything else. One row rather than a list, so a subtree binds it with\n// lb-row. A reserved name (LB_RESERVED_PREFIX): the server refuses to\n// declare a query so named.\nexport const NAV_ROW = \"lb-navigation\";\n\n// Its two columns. The label is the nav's: the text of the lb-nav-link\n// anchor whose href names the current page, and empty when no anchor does.\n// The URI is the path and query string as the browser has them.\nexport const NAV_CELL_LABEL = \"page-label\";\nexport const NAV_CELL_URI = \"page-uri\";\n\n// A server response that changes the query parms, in one row whose columns\n// are the parms. Returned from a request's run (write it with queryParms() in\n// server/lb-server.ts), because some values exist only once the write has\n// run: the key of a row just inserted, or the absence of one just deleted.\n// The server then loads the page at the query string with these parms set,\n// in the same round trip, and the hub writes them into the URL before\n// landing that load. An empty value takes the parm out. Only parms: the\n// path is never the server's to change, so this cannot redirect. A reserved\n// name (LB_RESERVED_PREFIX), so it never collides with a declared query.\nexport const QUERY_PARMS_ROW = \"lb-query-parms\";\n\n// Marks the chrome's own <dialog> for a page name that resolves to no\n// template — a routing miss discovered client-side, not an HTTP 404 (every\n// route gets the same 200 response; see docs/tutorials/010-pages-and-navigation.md).\n// The hub only opens it; what it says comes from NAV_ROW, which the dialog\n// consumes like any other subtree, by naming it in lb-row. Optional: an\n// application that declares none gets today's console.error and nothing\n// more. The builder requires the element it's on to be a <dialog>\n// (build/assemble.ts), since the hub calls showModal() on it.\nexport const ATTR_UNKNOWN_PAGE = \"lb-unknown-page\";\n\n// The hub's own tag. It is exempt from the rule every other LB-* tag\n// follows: expansion does not require it to have a definition (build/expand.ts),\n// and the client build does not require it to have a script of its own\n// (build/elements.ts) — it is the framework's live element, always present,\n// registered once by the package's main entry point, not a widget an\n// application discovers or declares.\nexport const HUB_TAG_NAME = \"lb-hub\";\n\n// --- Request lifecycle --------------------------------------------------\n// Stamped on the element that dispatched a request — the button, form, or\n// widget itself — for the duration of its round trip. It carries no\n// meaning beyond \"in flight\": a stylesheet dims the element, or a custom\n// button widget watches it to disable itself. The hub sets and clears it,\n// alongside aria-busy, and reads it in one place: a native action (a button\n// or form, not a widget) still pending ignores being performed again.\nexport const ATTR_PENDING = \"lb-pending\";\n\n// Stamped on the same element if that round trip failed — a non-2xx\n// response, a thrown application error, or a timeout, all alike. Cleared at\n// the start of that element's next request. What (if anything) an\n// application shows for it is undecided; this is only the fact that it\n// happened.\nexport const ATTR_ERROR = \"lb-error\";\n\n// --- Wire --------------------------------------------------------------\n// One path, one method: everything the hub asks of the server is a POST\n// below this path. The page name follows it, and the query string the\n// browser is showing rides after that verbatim, so `/accounts?acct=23` asks\n// as `POST /lb/accounts?acct=23` and the server always knows what URL the\n// browser is showing. Navigation is therefore the only GET an application\n// serves, which is what leaves the page name space unrestricted.\nexport const LB_ENDPOINT = \"/lb\";\n\n// A client-side deadline for one round trip. fetch() has no deadline of its\n// own; past this the request is aborted and treated as a failure.\nexport const LB_REQUEST_TIMEOUT_MS = 10_000;\n"]}
+{"version":3,"file":"lb-constants.js","sourceRoot":"","sources":["../../core/lb-constants.ts"],"names":[],"mappings":"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","sourcesContent":["// Every Loadbare attribute name lives here. Nothing writes one as a string\n// literal — not a widget, not a page host, not a test. See\n// docs/reference/data-binding.md.\n\n// --- Landing (docs/reference/data-binding.md) ----------------------------\n// Everything is a query. The server answers every request with response\n// items, one per query, and each carries the query's kind and key. The\n// markup names a query and the columns it shows; it never repeats what the\n// server already declared.\n\n// Names the query whose rows land in an element's content. A nested one\n// begins a new query: what is inside it is that query's.\nexport const ATTR_QUERY = \"lb-query\";\n\n// The column an element shows, read from the nearest ancestor row. On a\n// control the hub sets its value, and gathers it back under this name when\n// the control's request is issued.\nexport const ATTR_COLUMN = \"lb-column\";\n\n// The column that decides whether an element is present: `null` and `false`\n// are off, and every other value is on. It reads from the nearest ancestor\n// row, as ATTR_COLUMN does.\n//\n// An element that is off is moved into a `<template>` carrying this attribute\n// and the same column, standing where the element stood, and moved back out\n// when the column turns on. The builder ships every such element already\n// inside its template. A developer writes this attribute on an element and\n// never on a template: the template form is Loadbare's, and holds the absent\n// branch in the document so the hub holds nothing. Landing reaches inside it,\n// so a branch that returns is already current; nothing else does.\nexport const ATTR_SHOW = \"lb-show\";\n\n// Stamped by the hub on every element it sets from a column: the value it\n// set, so a stylesheet can select on it and a custom element that is not a\n// control can render it.\nexport const ATTR_COLUMN_VALUE = \"lb-column-value\";\n\n// Stamped by the hub on each live row, and on an element a `row` lands on\n// itself: the row's key. The key column is the query's, declared by the\n// server and carried by every response item.\nexport const ATTR_KEY_VALUE = \"lb-key-value\";\n\n// Stamped by the hub on an element with a row template: how many live rows\n// it holds, so \"no members yet\" is a stylesheet rule rather than a\n// conditional in every widget.\nexport const ATTR_QUERY_ROW_COUNT = \"lb-query-row-count\";\n\n// --- Requests (docs/reference/data-binding.md) --------------------------\n// Names the request an element issues when it commits: a form on submit, a\n// control on change, anything else on click.\nexport const ATTR_REQUEST = \"lb-request\";\n\n// Every request travels as one bubbling event of this name, whoever issued\n// it, so an ancestor may stop it.\nexport const LB_EVENT_NAME = \"lb-request\";\n\n// Stamped on the element that issued a request while its round trip is in\n// flight, alongside aria-busy. A commit on an element carrying it is ignored.\nexport const ATTR_REQUEST_PENDING = \"lb-request-pending\";\n\n// Stamped on the element that issued a request when its round trip failed —\n// a non-2xx response, a thrown application error, or a timeout, all alike.\n// Cleared at the start of that element's next request.\nexport const ATTR_REQUEST_ERROR = \"lb-request-error\";\n\n// --- Reserved names ----------------------------------------------------\n// Loadbare owns every name beginning with this prefix: attribute names, the\n// values of its attributes, query names, request names, the column names of\n// its own queries, custom element names and event names. The server refuses\n// a page that declares a query or a request so named.\nexport const LB_RESERVED_PREFIX = \"lb-\";\n\n// The requests Loadbare provides. Each runs the page's crud declaration for\n// the request's query.\nexport const REQUEST_ROW_INSERT = \"lb-row-insert\";\nexport const REQUEST_ROW_UPDATE = \"lb-row-update\";\nexport const REQUEST_ROW_DELETE = \"lb-row-delete\";\n\nexport const LB_ROW_REQUESTS = [\n  REQUEST_ROW_INSERT,\n  REQUEST_ROW_UPDATE,\n  REQUEST_ROW_DELETE,\n] as const;\n\n// --- Kinds --------------------------------------------------------------\nexport const KIND_ROW = \"row\";\nexport const KIND_ROWS = \"rows\";\n\n// --- The URL (docs/reference/chrome.md) ---------------------------------\n// The query the hub serves: one row, keyed by the path, whose other columns\n// are the query parms.\nexport const URL_QUERY = \"lb-url\";\nexport const URL_COLUMN_PATH = \"lb-path\";\nexport const URL_COLUMN_PAGE_LABEL = \"lb-page-label\";\nexport const URL_COLUMN_PAGE_UNKNOWN = \"lb-page-unknown\";\n\n// On an `<a>`: a plain primary click sets `lb-path` from the `href`.\nexport const ATTR_URL_LINK = \"lb-url-link\";\n\n// On an element with `lb-request`: its update of `lb-url` pushes a history\n// entry instead of replacing one.\nexport const ATTR_URL_PUSH = \"lb-url-push\";\n\n// On a `<dialog>`: the hub calls showModal() when `lb-page-unknown` is true.\nexport const ATTR_URL_UNKNOWN = \"lb-url-unknown\";\n\n// --- Build time (docs/reference/custom-elements.md) ---------------------\n// Marks the element in an element file whose children receive the rest of\n// the custom element's content. An attribute rather than an element because\n// HTML content models discard foreign elements inside <select> and <table>.\nexport const ATTR_EXP_SLOT = \"lb-exp-slot\";\n\n// One name in two positions. In an element file it marks a destination; on a\n// `<template>` in the custom element's content it names the destination\n// that template is for, and the template's content moves into it.\nexport const ATTR_EXP_TEMPLATE = \"lb-exp-template\";\n\n// A page ships as <template lb-page=\"<stub>\">.\nexport const ATTR_PAGE = \"lb-page\";\n\n// Stamped by the builder beside ATTR_PAGE: the text content of the page\n// file's `<title>`, which the builder removes.\nexport const ATTR_PAGE_TITLE = \"lb-page-title\";\n\n// The attributes a developer writes. The builder refuses any other `lb-`\n// attribute in markup: the rest are stamps, written by the hub or the\n// builder and never by hand or by script.\nexport const DEVELOPER_ATTRIBUTES = [\n  ATTR_QUERY,\n  ATTR_COLUMN,\n  ATTR_SHOW,\n  ATTR_REQUEST,\n  ATTR_URL_LINK,\n  ATTR_URL_PUSH,\n  ATTR_URL_UNKNOWN,\n] as const;\n\n// The hub's own tag. It is exempt from the rule every other LB-* tag\n// follows: expansion does not require it to have a definition (build/expand.ts),\n// and the client build does not require it to have a script of its own\n// (build/elements.ts) — it is the framework's live element, always present,\n// registered once by the package's main entry point, not a widget an\n// application discovers or declares.\nexport const HUB_TAG_NAME = \"lb-hub\";\n\n// --- Wire --------------------------------------------------------------\n// One path, one method: everything the hub asks of the server is a POST\n// below this path. The page's stub follows it, and the query string the\n// browser is showing rides after that verbatim, so `/accounts?acct=23` asks\n// as `POST /lb/accounts?acct=23` and the server always knows what URL the\n// browser is showing. Navigation is therefore the only GET an application\n// serves, which is what leaves the page name space unrestricted.\nexport const LB_ENDPOINT = \"/lb\";\n\n// A client-side deadline for one round trip. fetch() has no deadline of its\n// own; past this the request is aborted and treated as a failure.\nexport const LB_REQUEST_TIMEOUT_MS = 10_000;\n"]}