@loadbare/app 0.21.0 → 0.23.0

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

@@ -0,0 +1,128 @@
+/**
+ * A development server for a Loadbare application: after any change, the
+ * developer refreshes the browser, and never restarts anything.
+ *
+ *   browser --> devProxy :port --> appServer :appPort (a child process)
+ *                  |
+ *                  +-- watchApp (in this process)
+ *
+ * `devServer` is the whole recipe. It is built from four parts, each
+ * exported, so an application that wants something else assembles its own:
+ *
+ *   watchApp   @loadbare/app/build: rebuilds `dist/`, and says when each
+ *              build starts and ends
+ *   appServer  the application's own server as a child process, restarted
+ *              on demand
+ *   gate       holds requests while a build runs or the server restarts
+ *   devProxy   the port the browser uses, passing requests through the gate
+ *
+ * Why only the server restarts: `app.html`, `client.js` and `app.css` are
+ * read from disk on each request, so a rebuild is all they need. The
+ * server's own modules are loaded once, and Node cannot unload a module, so
+ * a server-side change needs a new process. The URL holds the page's state,
+ * so a refresh puts the user back where they were.
+ *
+ * The application's server runs as it does in production, unchanged, apart
+ * from reading its port from the environment.
+ */
+import http from "node:http";
+export interface Gate {
+    /** Hold requests from now until this close is matched by an open. */
+    close(reason: string): void;
+    /** Match one close of this reason. Requests go on once none is left. */
+    open(reason: string): void;
+    /** Resolves once the gate is open. */
+    wait(): Promise<void>;
+    readonly isOpen: boolean;
+}
+/**
+ * Requests wait while any reason to hold them stands: a build running, the
+ * server starting. Each close is matched by its own open, so one ending
+ * does not open the gate on another still in progress, of the same reason
+ * or another.
+ */
+export declare function gate(): Gate;
+export interface AppServerOptions {
+    /** The server's entry file, such as `server.ts`. */
+    entry: string;
+    /** The port it listens on. */
+    port: number;
+    /** The environment variable it reads its port from, `PORT` when absent. */
+    portEnv?: string;
+    /** Node's arguments before the entry, `--env-file-if-exists=.env` when absent. */
+    node?: string[];
+    /** Where its progress goes. */
+    log?: (line: string) => void;
+}
+export type AppServerState = "starting" | "running" | "down" | "stopped";
+export interface AppServer {
+    /**
+     * Stop the server if it runs, and start it again. Resolves once it
+     * accepts connections, or once it has exited instead.
+     */
+    restart(): Promise<void>;
+    /** Stop it, for good: a restart asked for after this does nothing. */
+    stop(): Promise<void>;
+    /** `down` is a server that exited on its own, as on a throw at import. */
+    readonly state: AppServerState;
+}
+/**
+ * The application's server as a child process. The child never outlives
+ * this process, however this process ends: it is killed on exit as well as
+ * on stop.
+ */
+export declare function appServer(options: AppServerOptions): AppServer;
+export interface DevProxyOptions {
+    /** The port the browser uses. */
+    port: number;
+    /** The host to listen on, `127.0.0.1` when absent. */
+    host?: string;
+    /** Where requests go on to: the application's server. */
+    target: number;
+    /** Requests wait at it while it is closed. */
+    gate: Gate;
+    /** True while the application's server is down, which answers 502. */
+    isDown: () => boolean;
+}
+/** Said to the browser while the application's server is down. */
+export declare const DOWN_MESSAGE = "The app server is down; see the dev console.";
+/**
+ * Listen on the browser's port, and pass every request through the gate to
+ * the application's server, method, path, headers and body as they came.
+ * Resolves once listening; rejects with a plain message when the port is in
+ * use.
+ */
+export declare function devProxy(options: DevProxyOptions): Promise<http.Server>;
+export interface DevServerOptions {
+    /** The application's server entry file, such as `server.ts`. */
+    server: string;
+    /** The port the browser uses: `PORT` from the environment, or 8787. */
+    port?: number;
+    /** The host the browser's port listens on, `127.0.0.1` when absent. */
+    host?: string;
+    /** The port the application's server gets, `port + 10000` when absent. */
+    appPort?: number;
+    /** The environment variable the application's server reads its port from, `PORT` when absent. */
+    portEnv?: string;
+    /** Node's arguments before the entry, `--env-file-if-exists=.env` when absent. */
+    node?: string[];
+    /** The builder's source tree, `src` when absent. */
+    src?: string;
+    /** The builder's output, `dist` when absent. */
+    out?: string;
+    /** Where progress goes, the console when absent. */
+    log?: (line: string) => void;
+}
+export interface DevServer {
+    /** The port the browser uses. */
+    port: number;
+    /** Stop everything: the watch, the application's server and the port. */
+    close(): Promise<void>;
+}
+/**
+ * The whole dev server: watch and rebuild, restart the application's
+ * server when a server-side file changed, and hold every request while
+ * either is under way. Stops everything on Ctrl-C or a kill.
+ */
+export declare function devServer(options: DevServerOptions): Promise<DevServer>;
+//# sourceMappingURL=lb-dev.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lb-dev.d.ts","sourceRoot":"","sources":["../../dev/lb-dev.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B,MAAM,WAAW,IAAI;IACnB,qEAAqE;IACrE,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,wEAAwE;IACxE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sCAAsC;IACtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAwB3B;AAID,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,+BAA+B;IAC/B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,sEAAsE;IACtE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA0D9D;AAoBD,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,IAAI,EAAE,IAAI,CAAC;IACX,sEAAsE;IACtE,MAAM,EAAE,MAAM,OAAO,CAAC;CACvB;AAED,kEAAkE;AAClE,eAAO,MAAM,YAAY,iDAAiD,CAAC;AAE3E;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAqCvE;AAID,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iGAAiG;IACjG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAWD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CA4F7E"}

package/dist/dev/lb-dev.js

@@ -0,0 +1,289 @@
+/**
+ * A development server for a Loadbare application: after any change, the
+ * developer refreshes the browser, and never restarts anything.
+ *
+ *   browser --> devProxy :port --> appServer :appPort (a child process)
+ *                  |
+ *                  +-- watchApp (in this process)
+ *
+ * `devServer` is the whole recipe. It is built from four parts, each
+ * exported, so an application that wants something else assembles its own:
+ *
+ *   watchApp   @loadbare/app/build: rebuilds `dist/`, and says when each
+ *              build starts and ends
+ *   appServer  the application's own server as a child process, restarted
+ *              on demand
+ *   gate       holds requests while a build runs or the server restarts
+ *   devProxy   the port the browser uses, passing requests through the gate
+ *
+ * Why only the server restarts: `app.html`, `client.js` and `app.css` are
+ * read from disk on each request, so a rebuild is all they need. The
+ * server's own modules are loaded once, and Node cannot unload a module, so
+ * a server-side change needs a new process. The URL holds the page's state,
+ * so a refresh puts the user back where they were.
+ *
+ * The application's server runs as it does in production, unchanged, apart
+ * from reading its port from the environment.
+ */
+import { spawn } from "node:child_process";
+import { watch } from "node:fs";
+import { readFile } from "node:fs/promises";
+import http from "node:http";
+import net from "node:net";
+import path from "node:path";
+import { watchApp } from "../build/build.js";
+/**
+ * Requests wait while any reason to hold them stands: a build running, the
+ * server starting. Each close is matched by its own open, so one ending
+ * does not open the gate on another still in progress, of the same reason
+ * or another.
+ */
+export function gate() {
+    const reasons = new Map();
+    let waiting = [];
+    return {
+        close(reason) {
+            reasons.set(reason, (reasons.get(reason) ?? 0) + 1);
+        },
+        open(reason) {
+            const left = (reasons.get(reason) ?? 0) - 1;
+            if (left > 0)
+                reasons.set(reason, left);
+            else
+                reasons.delete(reason);
+            if (reasons.size > 0)
+                return;
+            for (const go of waiting)
+                go();
+            waiting = [];
+        },
+        wait() {
+            return reasons.size === 0
+                ? Promise.resolve()
+                : new Promise((go) => waiting.push(go));
+        },
+        get isOpen() {
+            return reasons.size === 0;
+        },
+    };
+}
+/**
+ * The application's server as a child process. The child never outlives
+ * this process, however this process ends: it is killed on exit as well as
+ * on stop.
+ */
+export function appServer(options) {
+    const { entry, port, portEnv = "PORT", node = ["--env-file-if-exists=.env"], log = () => { }, } = options;
+    let child = null;
+    let state = "stopped";
+    let stopped = false;
+    const kill = () => child?.kill();
+    process.on("exit", kill);
+    /** Stop the child that runs now, and wait for it to go. */
+    const end = async () => {
+        const old = child;
+        // Forgotten first, so its exit is not taken for a crash.
+        child = null;
+        if (!old || old.exitCode !== null || old.signalCode !== null)
+            return;
+        await new Promise((done) => {
+            old.once("exit", done);
+            old.kill();
+        });
+    };
+    return {
+        async restart() {
+            if (stopped)
+                return;
+            const again = child !== null;
+            await end();
+            if (again)
+                log("restarting the app server");
+            state = "starting";
+            const started = spawn(process.execPath, [...node, entry], {
+                stdio: "inherit",
+                env: { ...process.env, [portEnv]: String(port) },
+            });
+            child = started;
+            started.once("exit", (code) => {
+                // An exit asked for is the restart's or the stop's business.
+                if (child !== started)
+                    return;
+                child = null;
+                state = "down";
+                log(`the app server stopped (exit ${code}); save a fix to restart it`);
+            });
+            await listening(port, () => child !== started);
+            if (child === started && !stopped)
+                state = "running";
+        },
+        async stop() {
+            stopped = true;
+            state = "stopped";
+            await end();
+            process.off("exit", kill);
+        },
+        get state() {
+            return state;
+        },
+    };
+}
+/** Resolves once something accepts connections on the port, or `abandon` says to give up. */
+async function listening(port, abandon) {
+    while (!abandon()) {
+        const up = await new Promise((done) => {
+            const socket = net.connect(port, "127.0.0.1");
+            socket.once("connect", () => {
+                socket.end();
+                done(true);
+            });
+            socket.once("error", () => done(false));
+        });
+        if (up)
+            return;
+        await new Promise((wait) => setTimeout(wait, 50));
+    }
+}
+/** Said to the browser while the application's server is down. */
+export const DOWN_MESSAGE = "The app server is down; see the dev console.";
+/**
+ * Listen on the browser's port, and pass every request through the gate to
+ * the application's server, method, path, headers and body as they came.
+ * Resolves once listening; rejects with a plain message when the port is in
+ * use.
+ */
+export function devProxy(options) {
+    const { port, host = "127.0.0.1", target, gate, isDown } = options;
+    const server = http.createServer(async (req, res) => {
+        await gate.wait();
+        if (isDown()) {
+            res.writeHead(502, { "content-type": "text/plain" }).end(DOWN_MESSAGE);
+            return;
+        }
+        const ahead = http.request({
+            host: "127.0.0.1",
+            port: target,
+            method: req.method,
+            path: req.url,
+            headers: req.headers,
+        }, (answer) => {
+            res.writeHead(answer.statusCode ?? 502, answer.headers);
+            answer.pipe(res);
+        });
+        ahead.on("error", () => {
+            if (!res.headersSent)
+                res.writeHead(502, { "content-type": "text/plain" });
+            res.end(DOWN_MESSAGE);
+        });
+        req.pipe(ahead);
+    });
+    return new Promise((resolve, reject) => {
+        server.once("error", (error) => {
+            reject(error.code === "EADDRINUSE"
+                ? new Error(`port ${port} is in use; is another dev server running?`)
+                : error);
+        });
+        server.listen(port, host, () => resolve(server));
+    });
+}
+/**
+ * Whether a build's changes need the server restarted: a module the server
+ * loads. Markup, stylesheets and browser code are read from disk per
+ * request, or bundled into a file that is.
+ */
+function serverSide(file) {
+    return file.endsWith(".ts") && !file.endsWith(".browser.ts");
+}
+/**
+ * The whole dev server: watch and rebuild, restart the application's
+ * server when a server-side file changed, and hold every request while
+ * either is under way. Stops everything on Ctrl-C or a kill.
+ */
+export async function devServer(options) {
+    const port = options.port ?? Number(process.env.PORT || 8787);
+    const appPort = options.appPort ?? port + 10000;
+    const out = options.out ?? "dist";
+    const log = options.log ?? ((line) => console.log(`loadbare-dev: ${line}`));
+    const entry = path.resolve(options.server);
+    const pagesFile = path.resolve(out, "pages.ts");
+    const readPages = () => readFile(pagesFile, "utf-8").catch(() => null);
+    const held = gate();
+    held.close("build");
+    const app = appServer({
+        entry,
+        port: appPort,
+        portEnv: options.portEnv,
+        node: options.node,
+        log,
+    });
+    // One restart at a time, in the order asked for: a second asked for while
+    // one runs follows it, rather than killing the server it is starting.
+    let restarts = Promise.resolve();
+    const restart = () => {
+        held.close("server");
+        restarts = restarts
+            .then(() => app.restart())
+            .finally(() => held.open("server"));
+        return restarts;
+    };
+    // Started first, so a busy port is reported before anything else runs.
+    const proxy = await devProxy({
+        port,
+        host: options.host,
+        target: appPort,
+        gate: held,
+        isDown: () => app.state === "down",
+    });
+    let pages = null;
+    const watcher = watchApp({
+        src: options.src,
+        out,
+        onStart: () => held.close("build"),
+        onBuilt: (outcome) => {
+            if (outcome.ok)
+                log(outcome.built.summary);
+            else
+                log(`build failed, serving the last good build: ${outcome.error.message}`);
+            void (async () => {
+                // The registry the server imports names the page modules, so a page
+                // gained or lost changes it without any server-side file changing.
+                const now = await readPages();
+                const restartNeeded = app.state !== "running" ||
+                    now !== pages ||
+                    outcome.changed.some(serverSide);
+                pages = now;
+                // The first build's server is started once the watch is ready.
+                if (restartNeeded && outcome.changed.length > 0)
+                    await restart();
+                held.open("build");
+            })();
+        },
+    });
+    // The entry's directory, not the file: an editor that saves by replacing
+    // the file would leave a watcher on the one it replaced.
+    const entryWatcher = watch(path.dirname(entry), (_event, file) => {
+        if (file === path.basename(entry))
+            void restart();
+    });
+    await watcher.ready;
+    pages = await readPages();
+    await restart();
+    held.open("build");
+    log(`http://${options.host ?? "127.0.0.1"}:${port}, app server on ${appPort}`);
+    const close = async () => {
+        watcher.close();
+        entryWatcher.close();
+        await app.stop();
+        // A browser holds its connection open between requests, and close()
+        // waits for every open connection to end.
+        proxy.closeAllConnections();
+        await new Promise((done) => proxy.close(done));
+        process.off("SIGINT", onSignal);
+        process.off("SIGTERM", onSignal);
+    };
+    const onSignal = () => void close().then(() => process.exit(0));
+    process.on("SIGINT", onSignal);
+    process.on("SIGTERM", onSignal);
+    return { port, close };
+}
+//# sourceMappingURL=lb-dev.js.map

package/dist/dev/lb-dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lb-dev.js","sourceRoot":"","sources":["../../dev/lb-dev.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A development server for a Loadbare application: after any change, the\n * developer refreshes the browser, and never restarts anything.\n *\n *   browser --> devProxy :port --> appServer :appPort (a child process)\n *                  |\n *                  +-- watchApp (in this process)\n *\n * `devServer` is the whole recipe. It is built from four parts, each\n * exported, so an application that wants something else assembles its own:\n *\n *   watchApp   @loadbare/app/build: rebuilds `dist/`, and says when each\n *              build starts and ends\n *   appServer  the application's own server as a child process, restarted\n *              on demand\n *   gate       holds requests while a build runs or the server restarts\n *   devProxy   the port the browser uses, passing requests through the gate\n *\n * Why only the server restarts: `app.html`, `client.js` and `app.css` are\n * read from disk on each request, so a rebuild is all they need. The\n * server's own modules are loaded once, and Node cannot unload a module, so\n * a server-side change needs a new process. The URL holds the page's state,\n * so a refresh puts the user back where they were.\n *\n * The application's server runs as it does in production, unchanged, apart\n * from reading its port from the environment.\n */\n\nimport { spawn, type ChildProcess } from \"node:child_process\";\nimport { watch } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport http from \"node:http\";\nimport net from \"node:net\";\nimport path from \"node:path\";\nimport { watchApp, type BuildOutcome } from \"../build/build.js\";\n\n// --- the gate ---------------------------------------------------------------\n\nexport interface Gate {\n  /** Hold requests from now until this close is matched by an open. */\n  close(reason: string): void;\n  /** Match one close of this reason. Requests go on once none is left. */\n  open(reason: string): void;\n  /** Resolves once the gate is open. */\n  wait(): Promise<void>;\n  readonly isOpen: boolean;\n}\n\n/**\n * Requests wait while any reason to hold them stands: a build running, the\n * server starting. Each close is matched by its own open, so one ending\n * does not open the gate on another still in progress, of the same reason\n * or another.\n */\nexport function gate(): Gate {\n  const reasons = new Map<string, number>();\n  let waiting: (() => void)[] = [];\n  return {\n    close(reason) {\n      reasons.set(reason, (reasons.get(reason) ?? 0) + 1);\n    },\n    open(reason) {\n      const left = (reasons.get(reason) ?? 0) - 1;\n      if (left > 0) reasons.set(reason, left);\n      else reasons.delete(reason);\n      if (reasons.size > 0) return;\n      for (const go of waiting) go();\n      waiting = [];\n    },\n    wait() {\n      return reasons.size === 0\n        ? Promise.resolve()\n        : new Promise((go) => waiting.push(go));\n    },\n    get isOpen() {\n      return reasons.size === 0;\n    },\n  };\n}\n\n// --- the application's server ----------------------------------------------\n\nexport interface AppServerOptions {\n  /** The server's entry file, such as `server.ts`. */\n  entry: string;\n  /** The port it listens on. */\n  port: number;\n  /** The environment variable it reads its port from, `PORT` when absent. */\n  portEnv?: string;\n  /** Node's arguments before the entry, `--env-file-if-exists=.env` when absent. */\n  node?: string[];\n  /** Where its progress goes. */\n  log?: (line: string) => void;\n}\n\nexport type AppServerState = \"starting\" | \"running\" | \"down\" | \"stopped\";\n\nexport interface AppServer {\n  /**\n   * Stop the server if it runs, and start it again. Resolves once it\n   * accepts connections, or once it has exited instead.\n   */\n  restart(): Promise<void>;\n  /** Stop it, for good: a restart asked for after this does nothing. */\n  stop(): Promise<void>;\n  /** `down` is a server that exited on its own, as on a throw at import. */\n  readonly state: AppServerState;\n}\n\n/**\n * The application's server as a child process. The child never outlives\n * this process, however this process ends: it is killed on exit as well as\n * on stop.\n */\nexport function appServer(options: AppServerOptions): AppServer {\n  const {\n    entry,\n    port,\n    portEnv = \"PORT\",\n    node = [\"--env-file-if-exists=.env\"],\n    log = () => {},\n  } = options;\n  let child: ChildProcess | null = null;\n  let state: AppServerState = \"stopped\";\n  let stopped = false;\n  const kill = () => child?.kill();\n  process.on(\"exit\", kill);\n\n  /** Stop the child that runs now, and wait for it to go. */\n  const end = async () => {\n    const old = child;\n    // Forgotten first, so its exit is not taken for a crash.\n    child = null;\n    if (!old || old.exitCode !== null || old.signalCode !== null) return;\n    await new Promise((done) => {\n      old.once(\"exit\", done);\n      old.kill();\n    });\n  };\n\n  return {\n    async restart() {\n      if (stopped) return;\n      const again = child !== null;\n      await end();\n      if (again) log(\"restarting the app server\");\n      state = \"starting\";\n      const started = spawn(process.execPath, [...node, entry], {\n        stdio: \"inherit\",\n        env: { ...process.env, [portEnv]: String(port) },\n      });\n      child = started;\n      started.once(\"exit\", (code) => {\n        // An exit asked for is the restart's or the stop's business.\n        if (child !== started) return;\n        child = null;\n        state = \"down\";\n        log(`the app server stopped (exit ${code}); save a fix to restart it`);\n      });\n      await listening(port, () => child !== started);\n      if (child === started && !stopped) state = \"running\";\n    },\n    async stop() {\n      stopped = true;\n      state = \"stopped\";\n      await end();\n      process.off(\"exit\", kill);\n    },\n    get state() {\n      return state;\n    },\n  };\n}\n\n/** Resolves once something accepts connections on the port, or `abandon` says to give up. */\nasync function listening(port: number, abandon: () => boolean): Promise<void> {\n  while (!abandon()) {\n    const up = await new Promise<boolean>((done) => {\n      const socket = net.connect(port, \"127.0.0.1\");\n      socket.once(\"connect\", () => {\n        socket.end();\n        done(true);\n      });\n      socket.once(\"error\", () => done(false));\n    });\n    if (up) return;\n    await new Promise((wait) => setTimeout(wait, 50));\n  }\n}\n\n// --- the port the browser uses ---------------------------------------------\n\nexport interface DevProxyOptions {\n  /** The port the browser uses. */\n  port: number;\n  /** The host to listen on, `127.0.0.1` when absent. */\n  host?: string;\n  /** Where requests go on to: the application's server. */\n  target: number;\n  /** Requests wait at it while it is closed. */\n  gate: Gate;\n  /** True while the application's server is down, which answers 502. */\n  isDown: () => boolean;\n}\n\n/** Said to the browser while the application's server is down. */\nexport const DOWN_MESSAGE = \"The app server is down; see the dev console.\";\n\n/**\n * Listen on the browser's port, and pass every request through the gate to\n * the application's server, method, path, headers and body as they came.\n * Resolves once listening; rejects with a plain message when the port is in\n * use.\n */\nexport function devProxy(options: DevProxyOptions): Promise<http.Server> {\n  const { port, host = \"127.0.0.1\", target, gate, isDown } = options;\n  const server = http.createServer(async (req, res) => {\n    await gate.wait();\n    if (isDown()) {\n      res.writeHead(502, { \"content-type\": \"text/plain\" }).end(DOWN_MESSAGE);\n      return;\n    }\n    const ahead = http.request(\n      {\n        host: \"127.0.0.1\",\n        port: target,\n        method: req.method,\n        path: req.url,\n        headers: req.headers,\n      },\n      (answer) => {\n        res.writeHead(answer.statusCode ?? 502, answer.headers);\n        answer.pipe(res);\n      },\n    );\n    ahead.on(\"error\", () => {\n      if (!res.headersSent) res.writeHead(502, { \"content-type\": \"text/plain\" });\n      res.end(DOWN_MESSAGE);\n    });\n    req.pipe(ahead);\n  });\n  return new Promise((resolve, reject) => {\n    server.once(\"error\", (error: NodeJS.ErrnoException) => {\n      reject(\n        error.code === \"EADDRINUSE\"\n          ? new Error(`port ${port} is in use; is another dev server running?`)\n          : error,\n      );\n    });\n    server.listen(port, host, () => resolve(server));\n  });\n}\n\n// --- the recipe ---------------------------------------------------------------\n\nexport interface DevServerOptions {\n  /** The application's server entry file, such as `server.ts`. */\n  server: string;\n  /** The port the browser uses: `PORT` from the environment, or 8787. */\n  port?: number;\n  /** The host the browser's port listens on, `127.0.0.1` when absent. */\n  host?: string;\n  /** The port the application's server gets, `port + 10000` when absent. */\n  appPort?: number;\n  /** The environment variable the application's server reads its port from, `PORT` when absent. */\n  portEnv?: string;\n  /** Node's arguments before the entry, `--env-file-if-exists=.env` when absent. */\n  node?: string[];\n  /** The builder's source tree, `src` when absent. */\n  src?: string;\n  /** The builder's output, `dist` when absent. */\n  out?: string;\n  /** Where progress goes, the console when absent. */\n  log?: (line: string) => void;\n}\n\nexport interface DevServer {\n  /** The port the browser uses. */\n  port: number;\n  /** Stop everything: the watch, the application's server and the port. */\n  close(): Promise<void>;\n}\n\n/**\n * Whether a build's changes need the server restarted: a module the server\n * loads. Markup, stylesheets and browser code are read from disk per\n * request, or bundled into a file that is.\n */\nfunction serverSide(file: string): boolean {\n  return file.endsWith(\".ts\") && !file.endsWith(\".browser.ts\");\n}\n\n/**\n * The whole dev server: watch and rebuild, restart the application's\n * server when a server-side file changed, and hold every request while\n * either is under way. Stops everything on Ctrl-C or a kill.\n */\nexport async function devServer(options: DevServerOptions): Promise<DevServer> {\n  const port = options.port ?? Number(process.env.PORT || 8787);\n  const appPort = options.appPort ?? port + 10000;\n  const out = options.out ?? \"dist\";\n  const log =\n    options.log ?? ((line: string) => console.log(`loadbare-dev: ${line}`));\n  const entry = path.resolve(options.server);\n  const pagesFile = path.resolve(out, \"pages.ts\");\n  const readPages = () => readFile(pagesFile, \"utf-8\").catch(() => null);\n\n  const held = gate();\n  held.close(\"build\");\n\n  const app = appServer({\n    entry,\n    port: appPort,\n    portEnv: options.portEnv,\n    node: options.node,\n    log,\n  });\n  // One restart at a time, in the order asked for: a second asked for while\n  // one runs follows it, rather than killing the server it is starting.\n  let restarts = Promise.resolve();\n  const restart = (): Promise<void> => {\n    held.close(\"server\");\n    restarts = restarts\n      .then(() => app.restart())\n      .finally(() => held.open(\"server\"));\n    return restarts;\n  };\n\n  // Started first, so a busy port is reported before anything else runs.\n  const proxy = await devProxy({\n    port,\n    host: options.host,\n    target: appPort,\n    gate: held,\n    isDown: () => app.state === \"down\",\n  });\n\n  let pages: string | null = null;\n  const watcher = watchApp({\n    src: options.src,\n    out,\n    onStart: () => held.close(\"build\"),\n    onBuilt: (outcome: BuildOutcome) => {\n      if (outcome.ok) log(outcome.built.summary);\n      else log(`build failed, serving the last good build: ${outcome.error.message}`);\n      void (async () => {\n        // The registry the server imports names the page modules, so a page\n        // gained or lost changes it without any server-side file changing.\n        const now = await readPages();\n        const restartNeeded =\n          app.state !== \"running\" ||\n          now !== pages ||\n          outcome.changed.some(serverSide);\n        pages = now;\n        // The first build's server is started once the watch is ready.\n        if (restartNeeded && outcome.changed.length > 0) await restart();\n        held.open(\"build\");\n      })();\n    },\n  });\n\n  // The entry's directory, not the file: an editor that saves by replacing\n  // the file would leave a watcher on the one it replaced.\n  const entryWatcher = watch(path.dirname(entry), (_event, file) => {\n    if (file === path.basename(entry)) void restart();\n  });\n\n  await watcher.ready;\n  pages = await readPages();\n  await restart();\n  held.open(\"build\");\n  log(`http://${options.host ?? \"127.0.0.1\"}:${port}, app server on ${appPort}`);\n\n  const close = async () => {\n    watcher.close();\n    entryWatcher.close();\n    await app.stop();\n    // A browser holds its connection open between requests, and close()\n    // waits for every open connection to end.\n    proxy.closeAllConnections();\n    await new Promise((done) => proxy.close(done));\n    process.off(\"SIGINT\", onSignal);\n    process.off(\"SIGTERM\", onSignal);\n  };\n  const onSignal = () => void close().then(() => process.exit(0));\n  process.on(\"SIGINT\", onSignal);\n  process.on(\"SIGTERM\", onSignal);\n\n  return { port, close };\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":"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"}

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;
 }