@c9up/ream 0.2.26 → 0.2.28

package/dist/dev/fullReload.js.map

@@ -1 +1 @@
-{"version":3,"file":"fullReload.js","sourceRoot":"","sources":["../../src/dev/fullReload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,MAAoB,EACpB,UAAoC;IAEpC,MAAM,GAAG,GACP,MAAM,KAAK,cAAc;QACvB,CAAC,CAAC,sDAAsD;QACxD,CAAC,CAAC,4FAA4F,CAAA;IAClG,OAAO,wBAAwB,UAAU,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAA;AACzD,CAAC"}
+{"version":3,"file":"fullReload.js","sourceRoot":"","sources":["../../src/dev/fullReload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAKrE;;;;;;GAMG;AACH,SAAS,MAAM;IACb,OAAO,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,CAAA;AACtE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,OAAO;QAAE,OAAM;IACzD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK;QAAE,OAAM;IACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;AACjC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,UAAoC;IAClF,OAAO,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAA;AAC/D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,OAAqB,EACrB,UAAoC;IAEpC,OAAO,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAA;AAC1D,CAAC"}

package/dist/dev/hotWatcher.d.ts

@@ -1,9 +1,23 @@
 /**
  * Watching the project for the changes a hot reload reacts to.
  *
- * `fs.watch` with `recursive: true`, which Node implements on Linux, macOS and
- * Windows alike — the reason a watcher used to be a dependency here, and is not
- * any more.
+ * ONE `fs.watch` PER DIRECTORY, walked ourselves — not `recursive: true`, and
+ * never a watch on a file. That is not a preference, it is the bug this module
+ * was reported for: most editors save by writing a temporary file and renaming
+ * it over the original (JetBrains IDEs, several formatters, anything using
+ * write-and-replace for crash safety). The rename gives the path a NEW inode,
+ * and a watcher holding the old one is watching something that no longer has a
+ * name. Measured on Node 25, Linux:
+ *
+ *     fs.watch(dir, { recursive: true })   first rename fires, then silence
+ *     fs.watch(file)                       first rename fires, then silence
+ *     fs.watch(dir)                        every rename fires
+ *
+ * So the first save hot-swapped and every one after it was ignored without a
+ * word — no reload, no restart, nothing in the log. A directory keeps its inode
+ * when a file inside it is replaced, which is why watching directories is the
+ * form that survives. A file to watch is watched through its parent instead,
+ * filtered by name.
  *
  * Two behaviours are worth stating because they are not obvious from the API:
  *
@@ -26,6 +40,8 @@ export interface WatcherOptions {
     files: readonly string[];
     /** Called once per settled change, with an absolute path. */
     onChange: (file: string) => void;
+    /** Told when a directory could not be watched for a reason worth knowing. */
+    onWarning?: (message: string) => void;
 }
 export interface Watcher {
     close: () => void;

package/dist/dev/hotWatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hotWatcher.d.ts","sourceRoot":"","sources":["../../src/dev/hotWatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B,0FAA0F;IAC1F,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,6DAA6D;IAC7D,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CA+C7D"}
+{"version":3,"file":"hotWatcher.d.ts","sourceRoot":"","sources":["../../src/dev/hotWatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AA6BH,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B,0FAA0F;IAC1F,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,6DAA6D;IAC7D,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACtC;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAuI7D"}

package/dist/dev/hotWatcher.js

@@ -1,9 +1,23 @@
 /**
  * Watching the project for the changes a hot reload reacts to.
  *
- * `fs.watch` with `recursive: true`, which Node implements on Linux, macOS and
- * Windows alike — the reason a watcher used to be a dependency here, and is not
- * any more.
+ * ONE `fs.watch` PER DIRECTORY, walked ourselves — not `recursive: true`, and
+ * never a watch on a file. That is not a preference, it is the bug this module
+ * was reported for: most editors save by writing a temporary file and renaming
+ * it over the original (JetBrains IDEs, several formatters, anything using
+ * write-and-replace for crash safety). The rename gives the path a NEW inode,
+ * and a watcher holding the old one is watching something that no longer has a
+ * name. Measured on Node 25, Linux:
+ *
+ *     fs.watch(dir, { recursive: true })   first rename fires, then silence
+ *     fs.watch(file)                       first rename fires, then silence
+ *     fs.watch(dir)                        every rename fires
+ *
+ * So the first save hot-swapped and every one after it was ignored without a
+ * word — no reload, no restart, nothing in the log. A directory keeps its inode
+ * when a file inside it is replaced, which is why watching directories is the
+ * form that survives. A file to watch is watched through its parent instead,
+ * filtered by name.
  *
  * Two behaviours are worth stating because they are not obvious from the API:
  *
@@ -17,13 +31,33 @@
  * syntax error has nothing left to notice the fix. The outer one covers exactly
  * that window, and hands back over by restarting the process.
  */
-import { watch } from 'node:fs';
-import { join, resolve } from 'node:path';
+import { readdirSync, realpathSync, statSync, watch } from 'node:fs';
+import { basename, dirname, join, resolve } from 'node:path';
 /** How long to wait for a save to finish arriving before acting on it. */
 const SETTLE_MS = 40;
+/** Never walked: none of it is application source, and some of it is enormous. */
+const SKIP_DIRECTORIES = new Set(['node_modules', '.git', 'dist', 'build', 'coverage', '.wolf']);
+/**
+ * The half-written files an atomic save leaves behind for a few milliseconds.
+ *
+ * Reported, they would be a change to `Controller.ts.tmp8f3` — a file the graph
+ * has never heard of, on its way to being renamed into the one that matters.
+ */
+function isEditorArtefact(name) {
+    return (name.endsWith('~') ||
+        name.endsWith('.swp') ||
+        name.endsWith('.swx') ||
+        name.startsWith('.#') ||
+        name.startsWith('.goutputstream') ||
+        /\.tmp[\w-]*$/.test(name) ||
+        /^\.?[\w.-]+\.(?:tmp|temp|crswap|part|partial)$/i.test(name));
+}
 export function watchProject(options) {
-    const watchers = [];
+    const watchers = new Map();
     const pending = new Map();
+    /** Real paths already walked, so a symlink loop cannot spin forever. */
+    const visited = new Set();
+    let closed = false;
     const report = (file) => {
         const existing = pending.get(file);
         if (existing !== undefined)
@@ -36,37 +70,153 @@ export function watchProject(options) {
         timer.unref?.();
         pending.set(file, timer);
     };
-    for (const directory of options.directories) {
-        const absolute = resolve(options.root, directory);
+    const warn = (message) => options.onWarning?.(message);
+    /**
+     * Watch one directory, then everything under it.
+     *
+     * Called again for a directory that appears later: a `mkdir app/billing`
+     * during a session must be watched, and the parent's event is what says so.
+     *
+     * `announce` closes the gap between that mkdir and the watch being in place.
+     * `mkdir -p app/billing && cp Controller.ts app/billing/` writes the file
+     * before the watcher on the new directory exists, so what is already inside a
+     * directory discovered mid-session is reported as a change. At startup it is
+     * false, or booting would report every file in the project.
+     */
+    const watchDirectory = (absolute, announce = false) => {
+        if (closed || watchers.has(absolute))
+            return;
+        let real;
+        try {
+            real = realpathSync(absolute);
+            if (!statSync(real).isDirectory())
+                return;
+        }
+        catch (error) {
+            // Absent is ordinary — the list is the framework's conventional layout,
+            // not a requirement, and a directory can be removed mid-session. Any
+            // other reason (no permission, too many open files) is worth saying, or
+            // the project silently stops hot-reloading.
+            if (!isMissing(error))
+                warn(`cannot watch ${absolute}: ${describe(error)}`);
+            return;
+        }
+        if (visited.has(real))
+            return;
+        visited.add(real);
         try {
-            watchers.push(watch(absolute, { recursive: true }, (_event, name) => {
+            const watcher = watch(absolute, (_event, name) => {
                 if (typeof name !== 'string' || name === '')
                     return;
-                report(join(absolute, name));
-            }));
+                const child = join(absolute, name);
+                // A new directory has to be picked up, or nothing in it is ever seen.
+                // Cheap: only for names that are directories right now.
+                if (!SKIP_DIRECTORIES.has(name) && isDirectory(child))
+                    watchDirectory(child, true);
+                if (isEditorArtefact(name))
+                    return;
+                report(child);
+            });
+            watcher.on('error', (error) => {
+                // A watcher whose directory was removed is done; anything else is a
+                // surprise the developer should hear about rather than lose.
+                watchers.delete(absolute);
+                if (!isMissing(error))
+                    warn(`watch on ${absolute} failed: ${describe(error)}`);
+            });
+            watchers.set(absolute, watcher);
+        }
+        catch (error) {
+            if (!isMissing(error))
+                warn(`cannot watch ${absolute}: ${describe(error)}`);
+            return;
         }
-        catch {
-            // A directory this project does not have is not an error: the list is
-            // the framework's conventional layout, not a requirement.
+        let entries = [];
+        try {
+            entries = readdirSync(absolute);
+        }
+        catch (error) {
+            if (!isMissing(error))
+                warn(`cannot read ${absolute}: ${describe(error)}`);
+            return;
+        }
+        for (const entry of entries) {
+            if (SKIP_DIRECTORIES.has(entry))
+                continue;
+            const child = join(absolute, entry);
+            if (isDirectory(child)) {
+                watchDirectory(child, announce);
+                continue;
+            }
+            if (announce && !isEditorArtefact(entry))
+                report(child);
         }
+    };
+    for (const directory of options.directories) {
+        watchDirectory(resolve(options.root, directory));
     }
+    // A file is watched through its parent directory, for the reason at the top
+    // of this module: `fs.watch` on the file itself holds an inode, and an atomic
+    // save replaces it. `.env` is saved by the same editors as everything else.
+    const watchedFiles = new Map();
     for (const file of options.files) {
         const absolute = resolve(options.root, file);
+        const parent = dirname(absolute);
+        const names = watchedFiles.get(parent) ?? new Set();
+        names.add(basename(absolute));
+        watchedFiles.set(parent, names);
+    }
+    for (const [parent, names] of watchedFiles) {
+        // The parent may already be covered as a watched directory — `.env` sits at
+        // the root, which is not in the list, but a caller is free to pass both.
+        if (watchers.has(parent))
+            continue;
         try {
-            watchers.push(watch(absolute, () => report(absolute)));
+            const watcher = watch(parent, (_event, name) => {
+                if (typeof name !== 'string' || !names.has(name))
+                    return;
+                report(join(parent, name));
+            });
+            watcher.on('error', (error) => {
+                watchers.delete(parent);
+                if (!isMissing(error))
+                    warn(`watch on ${parent} failed: ${describe(error)}`);
+            });
+            watchers.set(parent, watcher);
         }
-        catch {
-            // Same: a `.env` that does not exist is simply not watched.
+        catch (error) {
+            if (!isMissing(error))
+                warn(`cannot watch ${parent}: ${describe(error)}`);
         }
     }
     return {
         close: () => {
+            closed = true;
             for (const timer of pending.values())
                 clearTimeout(timer);
             pending.clear();
-            for (const watcher of watchers)
+            for (const watcher of watchers.values())
                 watcher.close();
+            watchers.clear();
         },
     };
 }
+function isDirectory(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/** ENOENT and friends: the path is simply not there, which is not a failure. */
+function isMissing(error) {
+    const code = error.code;
+    return code === 'ENOENT' || code === 'ENOTDIR';
+}
+function describe(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
 //# sourceMappingURL=hotWatcher.js.map

package/dist/dev/hotWatcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"hotWatcher.js","sourceRoot":"","sources":["../../src/dev/hotWatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAkB,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEzC,0EAA0E;AAC1E,MAAM,SAAS,GAAG,EAAE,CAAA;AAiBpB,MAAM,UAAU,YAAY,CAAC,OAAuB;IAClD,MAAM,QAAQ,GAAgB,EAAE,CAAA;IAChC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAA;IAEjD,MAAM,MAAM,GAAG,CAAC,IAAY,EAAQ,EAAE;QACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAClC,IAAI,QAAQ,KAAK,SAAS;YAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;QAClD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACxB,CAAC,EAAE,SAAS,CAAC,CAAA;QACb,sEAAsE;QACtE,KAAK,CAAC,KAAK,EAAE,EAAE,CAAA;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAC1B,CAAC,CAAA;IAED,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QACjD,IAAI,CAAC;YACH,QAAQ,CAAC,IAAI,CACX,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;gBACpD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE;oBAAE,OAAM;gBACnD,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAA;YAC9B,CAAC,CAAC,CACH,CAAA;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sEAAsE;YACtE,0DAA0D;QAC5D,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAC5C,IAAI,CAAC;YACH,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,4DAA4D;QAC9D,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,GAAG,EAAE;YACV,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAA;YACzD,OAAO,CAAC,KAAK,EAAE,CAAA;YACf,KAAK,MAAM,OAAO,IAAI,QAAQ;gBAAE,OAAO,CAAC,KAAK,EAAE,CAAA;QACjD,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"hotWatcher.js","sourceRoot":"","sources":["../../src/dev/hotWatcher.ts"],"names":[],"mappings":"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"}

package/dist/dev/readyBanner.d.ts

@@ -0,0 +1,45 @@
+/**
+ * What the dev server says once it is listening.
+ *
+ * Upstream prints a sticker the moment the child reports ready: the address,
+ * the mode, how long the boot took. Read off `@adonisjs/assembler`'s build:
+ *
+ *     this.ui.sticker()
+ *       .add(`Server address: ${colors.cyan(serverUrl)}`)
+ *       .add(`Mode: ${colors.cyan(this.mode)}`)
+ *       .add(`Ready in: ${colors.cyan(prettyHrtime(message.duration))}`)
+ *
+ * Ours says the same, `Press h to show help` included — the shortcuts are in
+ * `./shortcuts.ts`, so the line is an offer this process keeps.
+ *
+ * Printed from the application rather than from the `ream dev` parent, which
+ * is where upstream prints it. The parent is a Rust process here and the port
+ * is not its to know: a dev server that found 3000 taken binds 3001, and only
+ * the process that bound it can say so. Upstream solves the same problem by
+ * having the child send the port over IPC — the address it prints is the
+ * child's either way.
+ */
+/** Whether `ream dev` is what started this process. */
+export declare function inDevServer(): boolean;
+export interface ReadyBanner {
+    /** The host the server bound, as the Ignitor resolved it. */
+    host: string;
+    port: number;
+    /** `HMR` when the loader is swapping modules, `watch` when it only restarts. */
+    mode: string;
+    /** Milliseconds from process start to listening. */
+    bootMs?: number;
+}
+/**
+ * The address to show for a bound host and port.
+ *
+ * `localhost` rather than `0.0.0.0`: bound to every interface is not a link
+ * that opens, and printing it sends you looking in the wrong place. Shared
+ * with the `o` shortcut so the browser goes where the sticker said.
+ */
+export declare function devServerUrl(host: string, port: number): string;
+/** The lines of the sticker, so a test can read them without a terminal. */
+export declare function readyBannerLines(banner: ReadyBanner): string[];
+/** Print it, the way upstream prints its sticker. */
+export declare function printReadyBanner(banner: ReadyBanner): void;
+//# sourceMappingURL=readyBanner.d.ts.map

package/dist/dev/readyBanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readyBanner.d.ts","sourceRoot":"","sources":["../../src/dev/readyBanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,uDAAuD;AACvD,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAA;IACZ,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAY9D;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAK1D"}

package/dist/dev/readyBanner.js

@@ -0,0 +1,72 @@
+/**
+ * What the dev server says once it is listening.
+ *
+ * Upstream prints a sticker the moment the child reports ready: the address,
+ * the mode, how long the boot took. Read off `@adonisjs/assembler`'s build:
+ *
+ *     this.ui.sticker()
+ *       .add(`Server address: ${colors.cyan(serverUrl)}`)
+ *       .add(`Mode: ${colors.cyan(this.mode)}`)
+ *       .add(`Ready in: ${colors.cyan(prettyHrtime(message.duration))}`)
+ *
+ * Ours says the same, `Press h to show help` included — the shortcuts are in
+ * `./shortcuts.ts`, so the line is an offer this process keeps.
+ *
+ * Printed from the application rather than from the `ream dev` parent, which
+ * is where upstream prints it. The parent is a Rust process here and the port
+ * is not its to know: a dev server that found 3000 taken binds 3001, and only
+ * the process that bound it can say so. Upstream solves the same problem by
+ * having the child send the port over IPC — the address it prints is the
+ * child's either way.
+ */
+import { lumen } from '@c9up/lumen';
+/** Whether `ream dev` is what started this process. */
+export function inDevServer() {
+    return process.env.REAM_DEV === 'true';
+}
+/**
+ * The address to show for a bound host and port.
+ *
+ * `localhost` rather than `0.0.0.0`: bound to every interface is not a link
+ * that opens, and printing it sends you looking in the wrong place. Shared
+ * with the `o` shortcut so the browser goes where the sticker said.
+ */
+export function devServerUrl(host, port) {
+    const shown = host === '0.0.0.0' || host === '::' ? 'localhost' : host;
+    return `http://${shown}:${port}`;
+}
+/** The lines of the sticker, so a test can read them without a terminal. */
+export function readyBannerLines(banner) {
+    const ui = lumen();
+    const lines = [
+        `Server address: ${ui.colors.cyan(devServerUrl(banner.host, banner.port))}`,
+        `Mode: ${ui.colors.cyan(banner.mode)}`,
+    ];
+    if (banner.bootMs !== undefined) {
+        lines.push(`Ready in: ${ui.colors.cyan(formatBootTime(banner.bootMs))}`);
+    }
+    // Only where there is a keyboard: piped into a file, the offer is a lie.
+    if (process.stdin.isTTY)
+        lines.push(`Press ${ui.colors.dim('h')} to show help`);
+    return lines;
+}
+/** Print it, the way upstream prints its sticker. */
+export function printReadyBanner(banner) {
+    const ui = lumen();
+    const sticker = ui.sticker();
+    for (const line of readyBannerLines(banner))
+        sticker.add(line);
+    sticker.render();
+}
+/**
+ * `412 ms`, `1.2 s` — upstream runs the duration through `pretty-hrtime`.
+ *
+ * Not that dependency: this prints one number once per boot, and the package
+ * is 60 lines of unit selection for a case we have exactly one of.
+ */
+function formatBootTime(ms) {
+    if (ms < 1000)
+        return `${Math.round(ms)} ms`;
+    return `${(ms / 1000).toFixed(1)} s`;
+}
+//# sourceMappingURL=readyBanner.js.map

package/dist/dev/readyBanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readyBanner.js","sourceRoot":"","sources":["../../src/dev/readyBanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEnC,uDAAuD;AACvD,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAA;AACxC,CAAC;AAYD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAAY;IACrD,MAAM,KAAK,GAAG,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAA;IACtE,OAAO,UAAU,KAAK,IAAI,IAAI,EAAE,CAAA;AAClC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAAC,MAAmB;IAClD,MAAM,EAAE,GAAG,KAAK,EAAE,CAAA;IAClB,MAAM,KAAK,GAAG;QACZ,mBAAmB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE;QAC3E,SAAS,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;KACvC,CAAA;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAA;IAC1E,CAAC;IACD,yEAAyE;IACzE,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;IAC/E,OAAO,KAAK,CAAA;AACd,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,gBAAgB,CAAC,MAAmB;IAClD,MAAM,EAAE,GAAG,KAAK,EAAE,CAAA;IAClB,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAA;IAC5B,KAAK,MAAM,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC9D,OAAO,CAAC,MAAM,EAAE,CAAA;AAClB,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,EAAU;IAChC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAA;IAC5C,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;AACtC,CAAC"}

package/dist/dev/shortcuts.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The keys the dev server answers to.
+ *
+ * Upstream's set, read off `@adonisjs/assembler`'s build: `r` restarts, `c`
+ * clears, `o` opens the browser, `h` shows the list, and Ctrl-C or Ctrl-D
+ * quits. Same keys, same order, same words.
+ *
+ * Owned by the application rather than by the `ream dev` parent, which is
+ * where upstream owns it — the same split as the ready sticker, and for the
+ * same reason: `o` needs the address, and a port found by scanning past a
+ * taken 3000 is known only to the process that bound it. Everything else
+ * follows from there, because this process already has what each key needs:
+ * exiting on the restart code is what makes the parent start it again, and
+ * the graceful shutdown is already wired to a signal.
+ *
+ * NO dependency for opening a browser. Upstream imports `open`; this spawns
+ * the platform's opener, which is the one thing that package does on the three
+ * platforms a dev server runs on.
+ */
+/** The exit code the `ream dev` parent restarts on. */
+export declare const RESTART_EXIT_CODE = 75;
+export interface ShortcutsOptions {
+    /** Where the server is listening, for `o`. */
+    url?: string;
+    /** Leave the process the way a restart leaves it. Defaults to exiting. */
+    onRestart?: () => void;
+    /** End the session. Defaults to exiting through the normal shutdown. */
+    onQuit?: () => void;
+}
+/** The lines `h` prints, so a test can read them without a terminal. */
+export declare function helpLines(): string[];
+/** What to do with one keypress. Exported so the mapping is testable. */
+export declare function handleKey(key: string, options?: ShortcutsOptions): boolean;
+/**
+ * Listen for keys. Answers a function that stops listening.
+ *
+ * A no-op when stdin is not a terminal — `ream dev` piped into a file has no
+ * keyboard, and raw mode on a pipe throws.
+ */
+export declare function installShortcuts(options?: ShortcutsOptions): () => void;
+//# sourceMappingURL=shortcuts.d.ts.map

package/dist/dev/shortcuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcuts.d.ts","sourceRoot":"","sources":["../../src/dev/shortcuts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAQnC,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,wEAAwE;AACxE,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAEpC;AAiDD,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAY9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,gBAAqB,GAAG,MAAM,IAAI,CAiB3E"}

package/dist/dev/shortcuts.js

@@ -0,0 +1,142 @@
+/**
+ * The keys the dev server answers to.
+ *
+ * Upstream's set, read off `@adonisjs/assembler`'s build: `r` restarts, `c`
+ * clears, `o` opens the browser, `h` shows the list, and Ctrl-C or Ctrl-D
+ * quits. Same keys, same order, same words.
+ *
+ * Owned by the application rather than by the `ream dev` parent, which is
+ * where upstream owns it — the same split as the ready sticker, and for the
+ * same reason: `o` needs the address, and a port found by scanning past a
+ * taken 3000 is known only to the process that bound it. Everything else
+ * follows from there, because this process already has what each key needs:
+ * exiting on the restart code is what makes the parent start it again, and
+ * the graceful shutdown is already wired to a signal.
+ *
+ * NO dependency for opening a browser. Upstream imports `open`; this spawns
+ * the platform's opener, which is the one thing that package does on the three
+ * platforms a dev server runs on.
+ */
+import { spawn } from 'node:child_process';
+import { lumen } from '@c9up/lumen';
+import { clearScreen } from './fullReload.js';
+/** The exit code the `ream dev` parent restarts on. */
+export const RESTART_EXIT_CODE = 75;
+/** The lines `h` prints, so a test can read them without a terminal. */
+export function helpLines() {
+    return ['Available shortcuts:', ...shortcutsFor({}).map((s) => `· ${s.key}: ${s.description}`)];
+}
+function shortcutsFor(options) {
+    const ui = lumen();
+    return [
+        {
+            key: 'r',
+            description: 'restart server',
+            handler: () => {
+                ui.logger.log('');
+                ui.logger.info('Manual restart triggered...');
+                // Exiting on the restart code IS the restart: the parent loops on it,
+                // which is the same path a change outside the boundaries takes.
+                if (options.onRestart)
+                    options.onRestart();
+                else
+                    process.exit(RESTART_EXIT_CODE);
+            },
+        },
+        {
+            key: 'c',
+            description: 'clear console',
+            handler: () => {
+                clearScreen();
+                ui.logger.info('Console cleared');
+            },
+        },
+        {
+            key: 'o',
+            description: 'open in browser',
+            handler: () => {
+                if (options.url === undefined) {
+                    ui.logger.warning('No server address to open');
+                    return;
+                }
+                ui.logger.log('');
+                ui.logger.info(`Opening ${options.url}...`);
+                openBrowser(options.url);
+            },
+        },
+        {
+            key: 'h',
+            description: 'show this help',
+            handler: () => {
+                ui.logger.log('');
+                for (const line of helpLines())
+                    ui.logger.log(line);
+            },
+        },
+    ];
+}
+/** What to do with one keypress. Exported so the mapping is testable. */
+export function handleKey(key, options = {}) {
+    // \u0003 is Ctrl-C and \u0004 is Ctrl-D. Raw mode means no signal is raised
+    // for either, so the process would sit there unkillable without this.
+    if (key === '\u0003' || key === '\u0004') {
+        if (options.onQuit)
+            options.onQuit();
+        else
+            process.kill(process.pid, 'SIGINT');
+        return true;
+    }
+    const shortcut = shortcutsFor(options).find((entry) => entry.key === key);
+    if (shortcut === undefined)
+        return false;
+    shortcut.handler();
+    return true;
+}
+/**
+ * Listen for keys. Answers a function that stops listening.
+ *
+ * A no-op when stdin is not a terminal — `ream dev` piped into a file has no
+ * keyboard, and raw mode on a pipe throws.
+ */
+export function installShortcuts(options = {}) {
+    if (!process.stdin.isTTY)
+        return () => { };
+    const onData = (data) => {
+        handleKey(data.toString(), options);
+    };
+    process.stdin.setRawMode(true);
+    process.stdin.on('data', onData);
+    // Nothing should stay alive for a keyboard: a server that finished its work
+    // must be able to exit with a listener still attached.
+    process.stdin.unref();
+    return () => {
+        process.stdin.setRawMode(false);
+        process.stdin.removeListener('data', onData);
+        process.stdin.pause();
+    };
+}
+/**
+ * Hand the URL to whatever opens links here.
+ *
+ * Detached and ignored: an opener that writes to stderr, or outlives the dev
+ * server, must not take the terminal or the exit with it.
+ */
+function openBrowser(url) {
+    const command = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+    try {
+        const child = spawn(command, [url], {
+            detached: true,
+            stdio: 'ignore',
+            shell: process.platform === 'win32',
+        });
+        child.unref();
+        child.on('error', () => {
+            // No opener on this machine — a headless container, say. The address was
+            // printed a moment ago; losing the click is not worth a crash.
+        });
+    }
+    catch {
+        // Same.
+    }
+}
+//# sourceMappingURL=shortcuts.js.map

package/dist/dev/shortcuts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcuts.js","sourceRoot":"","sources":["../../src/dev/shortcuts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAE7C,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAA;AAiBnC,wEAAwE;AACxE,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,sBAAsB,EAAE,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;AACjG,CAAC;AAED,SAAS,YAAY,CAAC,OAAyB;IAC7C,MAAM,EAAE,GAAG,KAAK,EAAE,CAAA;IAClB,OAAO;QACL;YACE,GAAG,EAAE,GAAG;YACR,WAAW,EAAE,gBAAgB;YAC7B,OAAO,EAAE,GAAG,EAAE;gBACZ,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;gBACjB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;gBAC7C,sEAAsE;gBACtE,gEAAgE;gBAChE,IAAI,OAAO,CAAC,SAAS;oBAAE,OAAO,CAAC,SAAS,EAAE,CAAA;;oBACrC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;YACtC,CAAC;SACF;QACD;YACE,GAAG,EAAE,GAAG;YACR,WAAW,EAAE,eAAe;YAC5B,OAAO,EAAE,GAAG,EAAE;gBACZ,WAAW,EAAE,CAAA;gBACb,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;YACnC,CAAC;SACF;QACD;YACE,GAAG,EAAE,GAAG;YACR,WAAW,EAAE,iBAAiB;YAC9B,OAAO,EAAE,GAAG,EAAE;gBACZ,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;oBAC9B,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAA;oBAC9C,OAAM;gBACR,CAAC;gBACD,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;gBACjB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,GAAG,KAAK,CAAC,CAAA;gBAC3C,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;YAC1B,CAAC;SACF;QACD;YACE,GAAG,EAAE,GAAG;YACR,WAAW,EAAE,gBAAgB;YAC7B,OAAO,EAAE,GAAG,EAAE;gBACZ,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;gBACjB,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE;oBAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACrD,CAAC;SACF;KACF,CAAA;AACH,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,UAA4B,EAAE;IACnE,4EAA4E;IAC5E,sEAAsE;IACtE,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,MAAM;YAAE,OAAO,CAAC,MAAM,EAAE,CAAA;;YAC/B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;QACxC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,CAAA;IACzE,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE,CAAA;IAClB,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA4B,EAAE;IAC7D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IAEzC,MAAM,MAAM,GAAG,CAAC,IAAqB,EAAQ,EAAE;QAC7C,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAA;IACrC,CAAC,CAAA;IACD,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IAC9B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,4EAA4E;IAC5E,uDAAuD;IACvD,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IAErB,OAAO,GAAG,EAAE;QACV,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;QAC/B,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC5C,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACvB,CAAC,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,OAAO,GACX,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAA;IAC9F,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE;YAClC,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;SACpC,CAAC,CAAA;QACF,KAAK,CAAC,KAAK,EAAE,CAAA;QACb,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACrB,yEAAyE;YACzE,+DAA+D;QACjE,CAAC,CAAC,CAAA;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ;IACV,CAAC;AACH,CAAC"}

package/dist/errors/prettyPrintError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prettyPrintError.d.ts","sourceRoot":"","sources":["../../src/errors/prettyPrintError.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CASrD"}
+{"version":3,"file":"prettyPrintError.d.ts","sourceRoot":"","sources":["../../src/errors/prettyPrintError.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAQrD"}

package/dist/errors/prettyPrintError.js

@@ -6,17 +6,14 @@
  * that would make the two import each other.
  */
 import { ReamError } from './ReamError.js';
+import { renderError } from './renderError.js';
 export function prettyPrintError(error) {
+    // A framework error already says what it is, what it was doing and what to
+    // try — printing a source excerpt under it would bury that.
     if (error instanceof ReamError) {
         console.error(error.toDevString());
+        return;
     }
-    else if (error instanceof Error) {
-        console.error(`\n  ${error.message}\n`);
-        if (error.stack)
-            console.error(error.stack);
-    }
-    else {
-        console.error(error);
-    }
+    console.error(renderError(error));
 }
 //# sourceMappingURL=prettyPrintError.js.map