@loadbare/app 0.22.0 → 0.23.0

package/dist/build/build.d.ts

@@ -59,4 +59,20 @@ export interface AppWatcher {
  * never overlap and never fall behind.
  */
 export declare function watchApp(options?: WatchOptions): AppWatcher;
+/**
+ * Watch every directory under `root`, and each one made later, and report
+ * each file an event names, relative to `root`. A directory `skip` answers
+ * true for, relative to `root`, is not watched, nor is anything under it.
+ *
+ * Directories rather than `recursive: true`: on Linux, Node's recursive
+ * watch follows each file, so a file saved by replacing it, as `sed -i` and
+ * many editors save, is never heard from again. A directory's watch outlives
+ * every file in it.
+ *
+ * A directory made after the watch began may hold files before its own
+ * watch starts, so each file found in it is reported.
+ */
+export declare function watchTree(root: string, onFile: (file: string) => void, skip?: (dir: string) => boolean): {
+    close(): void;
+};
 //# sourceMappingURL=build.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../build/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkBH,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,KAAK;IACpB,kCAAkC;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wEAAwE;AACxE,wBAAsB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,KAAK,CAAC,CAgEzE;AAED,sCAAsC;AACtC,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEnD,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACtC,gFAAgF;IAChF,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7B,uDAAuD;IACvD,KAAK,IAAI,IAAI,CAAC;CACf;AAYD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,UAAU,CA6D/D"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../build/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkBH,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,KAAK;IACpB,kCAAkC;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wEAAwE;AACxE,wBAAsB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,KAAK,CAAC,CAgEzE;AAED,sCAAsC;AACtC,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEnD,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACtC,gFAAgF;IAChF,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7B,uDAAuD;IACvD,KAAK,IAAI,IAAI,CAAC;CACf;AAYD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,UAAU,CA6D/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC9B,IAAI,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAqB,GAC3C;IAAE,KAAK,IAAI,IAAI,CAAA;CAAE,CAqDnB"}

package/dist/build/build.js

@@ -10,7 +10,7 @@
  * leaves the last good build in place, so a server reading `dist/` keeps
  * serving something coherent while the developer fixes the mistake.
  */
-import { watch as watchFiles } from "node:fs";
+import { readdirSync, statSync, watch as watchDir } from "node:fs";
 import { mkdir, writeFile } from "node:fs/promises";
 import path from "node:path";
 import * as esbuild from "esbuild";
@@ -121,8 +121,8 @@ export function watchApp(options = {}) {
             void drain();
         return outcome;
     });
-    const watcher = watchFiles(src, { recursive: true }, (_event, file) => {
-        if (closed || !file || !BUILT_FROM.test(file) || inOut(file))
+    const tree = watchTree(src, (file) => {
+        if (closed || !BUILT_FROM.test(file) || inOut(file))
             return;
         pending.add(file.split(path.sep).join("/"));
         if (running || timer)
@@ -135,14 +135,86 @@ export function watchApp(options = {}) {
                     void drain();
             });
         }, SETTLE_MS);
-    });
+    }, inOut);
     return {
         ready,
         close() {
             closed = true;
             clearTimeout(timer);
-            watcher.close();
+            tree.close();
         },
     };
 }
+/**
+ * Watch every directory under `root`, and each one made later, and report
+ * each file an event names, relative to `root`. A directory `skip` answers
+ * true for, relative to `root`, is not watched, nor is anything under it.
+ *
+ * Directories rather than `recursive: true`: on Linux, Node's recursive
+ * watch follows each file, so a file saved by replacing it, as `sed -i` and
+ * many editors save, is never heard from again. A directory's watch outlives
+ * every file in it.
+ *
+ * A directory made after the watch began may hold files before its own
+ * watch starts, so each file found in it is reported.
+ */
+export function watchTree(root, onFile, skip = () => false) {
+    const watchers = new Map();
+    const drop = (dir) => {
+        for (const [watched, watcher] of watchers) {
+            if (dir === "" || watched === dir || watched.startsWith(dir + path.sep)) {
+                watcher.close();
+                watchers.delete(watched);
+            }
+        }
+    };
+    const changed = (file) => {
+        let isDir = false;
+        try {
+            isDir = statSync(path.join(root, file)).isDirectory();
+        }
+        catch {
+            // Gone: a deleted file is a change, and a deleted directory's watch ends.
+        }
+        if (isDir) {
+            if (!watchers.has(file))
+                add(file, true);
+        }
+        else {
+            drop(file);
+            onFile(file);
+        }
+    };
+    const add = (dir, report) => {
+        if (skip(dir))
+            return;
+        const full = path.join(root, dir);
+        let watcher;
+        let entries;
+        try {
+            watcher = watchDir(full, (_event, name) => {
+                if (name)
+                    changed(path.join(dir, name.toString()));
+            });
+            entries = readdirSync(full, { withFileTypes: true });
+        }
+        catch (err) {
+            // The root must exist; a directory below it may be gone already.
+            if (dir === "")
+                throw err;
+            return;
+        }
+        watcher.on("error", () => drop(dir));
+        watchers.set(dir, watcher);
+        for (const entry of entries) {
+            const child = path.join(dir, entry.name);
+            if (entry.isDirectory())
+                add(child, report);
+            else if (report)
+                onFile(child);
+        }
+    };
+    add("", false);
+    return { close: () => drop("") };
+}
 //# sourceMappingURL=build.js.map

package/dist/build/build.js.map

@@ -1 +1 @@
-{"version":3,"file":"build.js","sourceRoot":"","sources":["../../build/build.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The build, as a library: one build, or a watch that rebuilds and says when\n * each build has ended. `loadbare-app-build` (build/cli.ts) is a thin\n * command over these, and `@loadbare/app/dev` runs the watch in process.\n *\n * Paths resolve against the working directory, as the command's do, so a\n * caller runs from the application's root.\n *\n * A build writes nothing until every output is in hand. One that fails\n * leaves the last good build in place, so a server reading `dist/` keeps\n * serving something coherent while the developer fixes the mistake.\n */\n\nimport { watch as watchFiles } from \"node:fs\";\nimport { mkdir, 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\nexport interface BuildOptions {\n  /** The application's source tree, `src` when absent. */\n  src?: string;\n  /** Where the output lands, `dist` when absent. */\n  out?: string;\n  /** Minify `client.js` and `app.css`. */\n  minify?: boolean;\n}\n\nexport interface Built {\n  /** Every file the build wrote. */\n  files: string[];\n  /** How many custom elements `client.js` registers. */\n  elements: number;\n  /** One line saying what was written, as the command prints it. */\n  summary: string;\n}\n\n/** Build once. Throws, having written nothing, when the build fails. */\nexport async function buildApp(options: BuildOptions = {}): Promise<Built> {\n  const src = options.src ?? \"src\";\n  const minify = options.minify ?? false;\n  const locations = await resolveLocations({ src, out: options.out ?? \"dist\" });\n  const { outDir } = locations;\n  const entryFile = path.join(outDir, \"client-entry.ts\");\n\n  const scans = await scanAll(locations, src, locations.importsFile);\n  await mkdir(outDir, { recursive: true });\n  const declared = await loadDeclared(\n    locations.pages,\n    locations.pageSources,\n    outDir,\n  );\n  const { html, usedTags } = await assemble({ ...locations, scans, declared });\n\n  const { resolved } = resolveElements({ used: usedTags, scans });\n  await checkReservedMethods(resolved);\n  // The entry is read by the bundler and never served, so it is written now.\n  await writeFile(entryFile, clientEntrySource(resolved, outDir), \"utf-8\");\n  const bundle = await esbuild.build({\n    entryPoints: [entryFile],\n    bundle: true,\n    format: \"iife\",\n    outfile: path.join(outDir, \"client.js\"),\n    minify,\n    write: false,\n    // esbuild keeps the directory it started in; the paths are the caller's.\n    absWorkingDir: process.cwd(),\n  });\n\n  const outputs = new Map<string, string | Uint8Array>();\n  outputs.set(path.join(outDir, \"app.html\"), html);\n  for (const file of bundle.outputFiles) outputs.set(file.path, file.contents);\n\n  const pages = pagesSource(\n    locations.pages,\n    locations.pageSources,\n    outDir,\n    locations.packageName,\n  );\n  if (pages) outputs.set(path.join(outDir, \"pages.ts\"), pages);\n\n  const css = await stylesSource(cssFrom(scans));\n  if (css) {\n    const code = minify\n      ? (await esbuild.transform(css, { loader: \"css\", minify: true })).code\n      : css;\n    outputs.set(path.join(outDir, \"app.css\"), code);\n  }\n\n  for (const [file, content] of outputs) await writeFile(file, content);\n\n  const files = [...outputs.keys()].map((file) =>\n    path.relative(process.cwd(), file),\n  );\n  const elements = resolved.size;\n  return {\n    files,\n    elements,\n    summary:\n      `wrote ${files.join(\" and \")} ` +\n      `(${elements} custom element${elements === 1 ? \"\" : \"s\"})`,\n  };\n}\n\n/** How one build of a watch ended. */\nexport type BuildOutcome =\n  | { ok: true; changed: string[]; built: Built }\n  | { ok: false; changed: string[]; error: Error };\n\nexport interface WatchOptions extends BuildOptions {\n  /**\n   * A build is starting, for these changed files under `src`, relative to\n   * it. Empty for the first build.\n   */\n  onStart?: (changed: string[]) => void;\n  /** A build has ended, well or badly. A failed build does not stop the watch. */\n  onBuilt?: (outcome: BuildOutcome) => void;\n}\n\nexport interface AppWatcher {\n  /** How the first build ended. */\n  ready: Promise<BuildOutcome>;\n  /** Stop watching. A build already running finishes. */\n  close(): void;\n}\n\n/** The files a build reads. A change to any other file starts no build. */\nconst BUILT_FROM = /\\.(html|ts|css)$/;\n\n/**\n * Edits arrive in bursts: an editor's save is often several events, and a\n * branch switch is hundreds. Waiting this long after the first lets the\n * burst finish, so it starts one build.\n */\nconst SETTLE_MS = 20;\n\n/**\n * Build, then build again whenever a file under `src` changes. Changes that\n * arrive while a build runs are gathered into one build after it, so builds\n * never overlap and never fall behind.\n */\nexport function watchApp(options: WatchOptions = {}): AppWatcher {\n  const src = options.src ?? \"src\";\n  // An output directory inside the source tree is written by every build,\n  // and a change there must not start the next one.\n  const out = path.relative(path.resolve(src), path.resolve(options.out ?? \"dist\"));\n  const inOut = (file: string) =>\n    out !== \"\" && !out.startsWith(\"..\") && (file === out || file.startsWith(out + path.sep));\n  let pending = new Set<string>();\n  let running = false;\n  let timer: NodeJS.Timeout | undefined;\n  let closed = false;\n\n  const once = async (changed: string[]): Promise<BuildOutcome> => {\n    options.onStart?.(changed);\n    let outcome: BuildOutcome;\n    try {\n      outcome = { ok: true, changed, built: await buildApp(options) };\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      outcome = { ok: false, changed, error };\n    }\n    options.onBuilt?.(outcome);\n    return outcome;\n  };\n\n  const drain = async (): Promise<void> => {\n    running = true;\n    while (pending.size > 0 && !closed) {\n      const changed = [...pending].sort();\n      pending = new Set();\n      await once(changed);\n    }\n    running = false;\n  };\n\n  const ready = once([]).then((outcome) => {\n    if (pending.size > 0) void drain();\n    return outcome;\n  });\n\n  const watcher = watchFiles(src, { recursive: true }, (_event, file) => {\n    if (closed || !file || !BUILT_FROM.test(file) || inOut(file)) return;\n    pending.add(file.split(path.sep).join(\"/\"));\n    if (running || timer) return;\n    timer = setTimeout(() => {\n      timer = undefined;\n      // The first build is still running: it starts the next when it ends.\n      void ready.then(() => {\n        if (!running) void drain();\n      });\n    }, SETTLE_MS);\n  });\n\n  return {\n    ready,\n    close() {\n      closed = true;\n      clearTimeout(timer);\n      watcher.close();\n    },\n  };\n}\n"]}
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../build/build.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The build, as a library: one build, or a watch that rebuilds and says when\n * each build has ended. `loadbare-app-build` (build/cli.ts) is a thin\n * command over these, and `@loadbare/app/dev` runs the watch in process.\n *\n * Paths resolve against the working directory, as the command's do, so a\n * caller runs from the application's root.\n *\n * A build writes nothing until every output is in hand. One that fails\n * leaves the last good build in place, so a server reading `dist/` keeps\n * serving something coherent while the developer fixes the mistake.\n */\n\nimport { readdirSync, statSync, watch as watchDir, type FSWatcher } from \"node:fs\";\nimport { mkdir, 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\nexport interface BuildOptions {\n  /** The application's source tree, `src` when absent. */\n  src?: string;\n  /** Where the output lands, `dist` when absent. */\n  out?: string;\n  /** Minify `client.js` and `app.css`. */\n  minify?: boolean;\n}\n\nexport interface Built {\n  /** Every file the build wrote. */\n  files: string[];\n  /** How many custom elements `client.js` registers. */\n  elements: number;\n  /** One line saying what was written, as the command prints it. */\n  summary: string;\n}\n\n/** Build once. Throws, having written nothing, when the build fails. */\nexport async function buildApp(options: BuildOptions = {}): Promise<Built> {\n  const src = options.src ?? \"src\";\n  const minify = options.minify ?? false;\n  const locations = await resolveLocations({ src, out: options.out ?? \"dist\" });\n  const { outDir } = locations;\n  const entryFile = path.join(outDir, \"client-entry.ts\");\n\n  const scans = await scanAll(locations, src, locations.importsFile);\n  await mkdir(outDir, { recursive: true });\n  const declared = await loadDeclared(\n    locations.pages,\n    locations.pageSources,\n    outDir,\n  );\n  const { html, usedTags } = await assemble({ ...locations, scans, declared });\n\n  const { resolved } = resolveElements({ used: usedTags, scans });\n  await checkReservedMethods(resolved);\n  // The entry is read by the bundler and never served, so it is written now.\n  await writeFile(entryFile, clientEntrySource(resolved, outDir), \"utf-8\");\n  const bundle = await esbuild.build({\n    entryPoints: [entryFile],\n    bundle: true,\n    format: \"iife\",\n    outfile: path.join(outDir, \"client.js\"),\n    minify,\n    write: false,\n    // esbuild keeps the directory it started in; the paths are the caller's.\n    absWorkingDir: process.cwd(),\n  });\n\n  const outputs = new Map<string, string | Uint8Array>();\n  outputs.set(path.join(outDir, \"app.html\"), html);\n  for (const file of bundle.outputFiles) outputs.set(file.path, file.contents);\n\n  const pages = pagesSource(\n    locations.pages,\n    locations.pageSources,\n    outDir,\n    locations.packageName,\n  );\n  if (pages) outputs.set(path.join(outDir, \"pages.ts\"), pages);\n\n  const css = await stylesSource(cssFrom(scans));\n  if (css) {\n    const code = minify\n      ? (await esbuild.transform(css, { loader: \"css\", minify: true })).code\n      : css;\n    outputs.set(path.join(outDir, \"app.css\"), code);\n  }\n\n  for (const [file, content] of outputs) await writeFile(file, content);\n\n  const files = [...outputs.keys()].map((file) =>\n    path.relative(process.cwd(), file),\n  );\n  const elements = resolved.size;\n  return {\n    files,\n    elements,\n    summary:\n      `wrote ${files.join(\" and \")} ` +\n      `(${elements} custom element${elements === 1 ? \"\" : \"s\"})`,\n  };\n}\n\n/** How one build of a watch ended. */\nexport type BuildOutcome =\n  | { ok: true; changed: string[]; built: Built }\n  | { ok: false; changed: string[]; error: Error };\n\nexport interface WatchOptions extends BuildOptions {\n  /**\n   * A build is starting, for these changed files under `src`, relative to\n   * it. Empty for the first build.\n   */\n  onStart?: (changed: string[]) => void;\n  /** A build has ended, well or badly. A failed build does not stop the watch. */\n  onBuilt?: (outcome: BuildOutcome) => void;\n}\n\nexport interface AppWatcher {\n  /** How the first build ended. */\n  ready: Promise<BuildOutcome>;\n  /** Stop watching. A build already running finishes. */\n  close(): void;\n}\n\n/** The files a build reads. A change to any other file starts no build. */\nconst BUILT_FROM = /\\.(html|ts|css)$/;\n\n/**\n * Edits arrive in bursts: an editor's save is often several events, and a\n * branch switch is hundreds. Waiting this long after the first lets the\n * burst finish, so it starts one build.\n */\nconst SETTLE_MS = 20;\n\n/**\n * Build, then build again whenever a file under `src` changes. Changes that\n * arrive while a build runs are gathered into one build after it, so builds\n * never overlap and never fall behind.\n */\nexport function watchApp(options: WatchOptions = {}): AppWatcher {\n  const src = options.src ?? \"src\";\n  // An output directory inside the source tree is written by every build,\n  // and a change there must not start the next one.\n  const out = path.relative(path.resolve(src), path.resolve(options.out ?? \"dist\"));\n  const inOut = (file: string) =>\n    out !== \"\" && !out.startsWith(\"..\") && (file === out || file.startsWith(out + path.sep));\n  let pending = new Set<string>();\n  let running = false;\n  let timer: NodeJS.Timeout | undefined;\n  let closed = false;\n\n  const once = async (changed: string[]): Promise<BuildOutcome> => {\n    options.onStart?.(changed);\n    let outcome: BuildOutcome;\n    try {\n      outcome = { ok: true, changed, built: await buildApp(options) };\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      outcome = { ok: false, changed, error };\n    }\n    options.onBuilt?.(outcome);\n    return outcome;\n  };\n\n  const drain = async (): Promise<void> => {\n    running = true;\n    while (pending.size > 0 && !closed) {\n      const changed = [...pending].sort();\n      pending = new Set();\n      await once(changed);\n    }\n    running = false;\n  };\n\n  const ready = once([]).then((outcome) => {\n    if (pending.size > 0) void drain();\n    return outcome;\n  });\n\n  const tree = watchTree(src, (file) => {\n    if (closed || !BUILT_FROM.test(file) || inOut(file)) return;\n    pending.add(file.split(path.sep).join(\"/\"));\n    if (running || timer) return;\n    timer = setTimeout(() => {\n      timer = undefined;\n      // The first build is still running: it starts the next when it ends.\n      void ready.then(() => {\n        if (!running) void drain();\n      });\n    }, SETTLE_MS);\n  }, inOut);\n\n  return {\n    ready,\n    close() {\n      closed = true;\n      clearTimeout(timer);\n      tree.close();\n    },\n  };\n}\n\n/**\n * Watch every directory under `root`, and each one made later, and report\n * each file an event names, relative to `root`. A directory `skip` answers\n * true for, relative to `root`, is not watched, nor is anything under it.\n *\n * Directories rather than `recursive: true`: on Linux, Node's recursive\n * watch follows each file, so a file saved by replacing it, as `sed -i` and\n * many editors save, is never heard from again. A directory's watch outlives\n * every file in it.\n *\n * A directory made after the watch began may hold files before its own\n * watch starts, so each file found in it is reported.\n */\nexport function watchTree(\n  root: string,\n  onFile: (file: string) => void,\n  skip: (dir: string) => boolean = () => false,\n): { close(): void } {\n  const watchers = new Map<string, FSWatcher>();\n\n  const drop = (dir: string) => {\n    for (const [watched, watcher] of watchers) {\n      if (dir === \"\" || watched === dir || watched.startsWith(dir + path.sep)) {\n        watcher.close();\n        watchers.delete(watched);\n      }\n    }\n  };\n\n  const changed = (file: string) => {\n    let isDir = false;\n    try {\n      isDir = statSync(path.join(root, file)).isDirectory();\n    } catch {\n      // Gone: a deleted file is a change, and a deleted directory's watch ends.\n    }\n    if (isDir) {\n      if (!watchers.has(file)) add(file, true);\n    } else {\n      drop(file);\n      onFile(file);\n    }\n  };\n\n  const add = (dir: string, report: boolean) => {\n    if (skip(dir)) return;\n    const full = path.join(root, dir);\n    let watcher: FSWatcher;\n    let entries;\n    try {\n      watcher = watchDir(full, (_event, name) => {\n        if (name) changed(path.join(dir, name.toString()));\n      });\n      entries = readdirSync(full, { withFileTypes: true });\n    } catch (err) {\n      // The root must exist; a directory below it may be gone already.\n      if (dir === \"\") throw err;\n      return;\n    }\n    watcher.on(\"error\", () => drop(dir));\n    watchers.set(dir, watcher);\n    for (const entry of entries) {\n      const child = path.join(dir, entry.name);\n      if (entry.isDirectory()) add(child, report);\n      else if (report) onFile(child);\n    }\n  };\n\n  add(\"\", false);\n  return { close: () => drop(\"\") };\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"lb-apply.d.ts","sourceRoot":"","sources":["../../hub/lb-apply.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lb-apply.d.ts","sourceRoot":"","sources":["../../hub/lb-apply.ts"],"names":[],"mappings":"AAoFA,OAAO,EASL,KAAK,WAAW,EAKhB,KAAK,YAAY,EACjB,KAAK,GAAG,EACR,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AA0B7B,mEAAmE;AACnE,MAAM,WAAW,OAAQ,SAAQ,OAAO;IACtC,KAAK,EAAE,MAAM,CAAC;CACf;AA4BD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAE5C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAGrD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,OAAO,CAIpD;AAUD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,OAAO,GACV,IAAI,CAMN;AA4FD;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAMjE;AA0CD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAGtD;AAsMD;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,GAAG,EACR,IAAI,UAAQ,EACZ,IAAI,CAAC,EAAE,MAAM,GACZ,IAAI,CAIN;AAqED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,GAAG,CAU3C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAKlE;AAQD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAS3C;AA+oBD,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,mDAAmD;IACnD,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CACvB,EAAE,EAAE,OAAO,EACX,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,WAAgB,GACxB,IAAI,CA0KN;AAwID,uDAAuD;AACvD,wBAAgB,UAAU,CACxB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,GACZ,YAAY,GAAG,SAAS,CAE1B;AAiBD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAE7C;AAoGD,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAUD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,GAAE,WAAgB,GACxB,IAAI,CA4BN;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,GAAG,OAAO,CAQ7D"}

package/dist/hub/lb-apply.js

@@ -141,9 +141,11 @@ function land(el, value) {
         return;
     }
     if (isCheckbox(el)) {
-        // Checked by the rule `lb-show` is on by: only null and false are off,
-        // and no string is read.
-        el.checked = value !== false;
+        // Off for false, and for what an unchecked checkbox gathers or an absent
+        // query parm lands as, so a checkbox lands what it gathered even from a
+        // query whose values are strings, such as lb-url.
+        el.checked =
+            value !== false && value !== "false" && value !== "";
     }
     else if (isRadio(el)) {
         el.checked =
@@ -1014,7 +1016,8 @@ function hide(el, hidden) {
 }
 /**
  * Finish a group and everything under it, from the rows it shows: each
- * heading filled from the first, as it was when last placed by the order,
+ * heading filled and linked from the first, as it was when last placed by
+ * the order,
  * each aggregate set from all of them, and a group hidden when a filter hides
  * every row in it. The rows it shows are returned.
  */
@@ -1032,9 +1035,12 @@ function finish(group, types) {
             }
         }
     }
-    if (shown[0])
-        for (const head of group.heads)
+    if (shown[0]) {
+        for (const head of group.heads) {
             fill(head, shown[0].placed);
+            link(head, shown[0].placed);
+        }
+    }
     aggregate(group.aggregates, rows, types);
     return shown;
 }