plgg-bundle 0.0.1

package/dist/Dev/node/devServer.js

@@ -0,0 +1,298 @@
+import { resolve, isAbsolute, join, } from "node:path";
+import { existsSync } from "node:fs";
+import { pathToFileURL } from "node:url";
+import { register } from "node:module";
+import {} from "node:http";
+import {} from "plgg-bundle/Dev/model/Fetch";
+import {} from "plgg-bundle/Dev/model/ModuleGraph";
+import { RELOAD_PATH, SSE_PRELUDE, RELOAD_FRAME, } from "plgg-bundle/Dev/model/Protocol";
+import { isAllowedHost } from "plgg-bundle/Dev/usecase/allowedHost";
+import { shouldReload } from "plgg-bundle/Dev/usecase/reloadDecision";
+import { decorateDevHtml } from "plgg-bundle/Dev/usecase/decorateDevHtml";
+import {} from "plgg-bundle/domain/model/BundleConfig";
+import { serveFetch, } from "plgg-bundle/Dev/node/httpAdapter";
+import { watchRoots } from "plgg-bundle/Dev/node/watch";
+import { scanGraph, } from "plgg-bundle/Dev/node/scanGraph";
+/** UTF-8 encode at call time (never at module top level). */
+const encodeUtf8 = (text) => new TextEncoder().encode(text);
+/** Whether a value is a non-null object. */
+const isRecord = (v) => typeof v === "object" && v !== null;
+/**
+ * The dev-entry factory to invoke: the module's `default`
+ * export, or the module itself when it has none. Stays
+ * `unknown` — {@link callFactory} does the callable check.
+ */
+const defaultExport = (mod) => isRecord(mod) && "default" in mod
+    ? mod["default"]
+    : mod;
+/**
+ * Invoke a dev-entry factory and normalise its result to a
+ * {@link Fetch}. The imported value is `unknown`, so the
+ * boundary is validated at runtime (`typeof`/`instanceof`)
+ * and wrapped into a correctly-typed `Fetch` — no `as`, no
+ * `any` annotation. Calling a value narrowed only to
+ * `Function` yields `any`; feeding it through the
+ * `unknown`-typed {@link normalizeFetch} re-establishes
+ * the type at the seam.
+ */
+const callFactory = (factory) => {
+    if (typeof factory !== "function") {
+        throw new Error("dev entry must default-export a () => Fetch factory");
+    }
+    return Promise.resolve(factory()).then(normalizeFetch);
+};
+/**
+ * Validate that a factory's result is a callable and wrap
+ * it as a {@link Fetch} that checks each answer is a
+ * `Response`.
+ */
+const normalizeFetch = (value) => {
+    if (typeof value !== "function") {
+        throw new Error("dev entry factory must return a Fetch (a function)");
+    }
+    return (request) => Promise.resolve(value(request)).then(asResponse);
+};
+/** Assert a Fetch answer is a Web `Response`. */
+const asResponse = (value) => {
+    if (value instanceof Response) {
+        return value;
+    }
+    throw new Error("dev entry Fetch must resolve to a Response");
+};
+/** An Error's message, or a stringified non-Error. */
+const msg = (e) => e instanceof Error ? e.message : String(e);
+/** dev-server console output — a deliberate side effect. */
+const log = (message) => {
+    process.stdout.write(`${message}\n`);
+};
+/**
+ * Cache-busting re-import of the dev entry at `version`,
+ * then run its factory to get a fresh {@link Fetch}. The
+ * loader hook propagates `?v=<version>` down the local
+ * import graph, so the whole affected subgraph
+ * re-evaluates — real code hot-reload.
+ */
+const load = async (entryUrl, version) => {
+    const mod = await import(`${entryUrl}?v=${version}`);
+    return callFactory(defaultExport(mod));
+};
+/** The 403 a disallowed Host gets. */
+const forbidden = () => new Response("Forbidden", {
+    status: 403,
+    headers: {
+        "content-type": "text/plain; charset=utf-8",
+    },
+});
+/**
+ * The DEV-ONLY SSE endpoint: an open `text/event-stream`
+ * whose controller joins the client registry and is
+ * removed on disconnect; a reload enqueues a frame onto it.
+ */
+const sseResponse = (clients) => {
+    // Bridge seam: capture the controller so `start` can
+    // register it and `cancel` can remove the same one.
+    let registered;
+    return new Response(new ReadableStream({
+        start: (controller) => {
+            registered = controller;
+            clients.add(controller);
+            controller.enqueue(encodeUtf8(SSE_PRELUDE));
+        },
+        cancel: () => {
+            if (registered !== undefined) {
+                clients.delete(registered);
+            }
+        },
+    }), {
+        status: 200,
+        headers: {
+            "content-type": "text/event-stream",
+            "cache-control": "no-cache",
+            connection: "keep-alive",
+        },
+    });
+};
+/** Push a reload frame to every open live-reload stream. */
+const notifyReload = (clients) => clients.forEach((controller) => controller.enqueue(encodeUtf8(RELOAD_FRAME)));
+/** Whether a response carries an HTML body. */
+const isHtml = (response) => {
+    const ct = response.headers.get("content-type");
+    return ct !== null && ct.includes("text/html");
+};
+/**
+ * Dev HTML headers: drop `content-length` (the appended
+ * script grew the body) and force `no-store` so a tunnel/
+ * CDN never serves stale inlined styles after an edit.
+ */
+const devHtmlHeaders = (headers) => {
+    const next = new Headers([...headers].filter(([key]) => {
+        const lower = key.toLowerCase();
+        return (lower !== "content-length" &&
+            lower !== "cache-control");
+    }));
+    next.set("cache-control", "no-store");
+    return next;
+};
+/** Append the live-reload script to an HTML response. */
+const decorateHtmlResponse = (response) => isHtml(response)
+    ? response
+        .text()
+        .then((html) => new Response(decorateDevHtml(html), {
+        status: response.status,
+        headers: devHtmlHeaders(response.headers),
+    }))
+    : Promise.resolve(response);
+/**
+ * The wrapping dev handler: 403 a disallowed Host, answer
+ * the SSE route, otherwise run the live app Fetch and
+ * append the live-reload script to its HTML.
+ */
+const devHandler = (state, allowedHosts) => (request) => {
+    const url = new URL(request.url);
+    if (!isAllowedHost(allowedHosts)(url.host)) {
+        return Promise.resolve(forbidden());
+    }
+    if (url.pathname === RELOAD_PATH) {
+        return Promise.resolve(sseResponse(state.clients));
+    }
+    return state
+        .appFetch(request)
+        .then(decorateHtmlResponse);
+};
+/** Resolve a config value that may be absolute or root-relative. */
+const under = (root, path) => isAbsolute(path)
+    ? path
+    : resolve(root, path);
+/**
+ * Register the dev-only cross-package source resolver
+ * (`bin/appAliasHook.mjs`) with the alias rules, so a
+ * dependency's `<prefix>/*` imports load from source and
+ * hot-reload. Registered later than the package's own hook
+ * so it runs first and short-circuits on an alias hit.
+ */
+const registerSourceAliases = (aliases) => {
+    const hookUrl = new URL("../../../bin/appAliasHook.mjs", import.meta.url).href;
+    register(hookUrl, import.meta.url, {
+        data: {
+            aliases: aliases.map((a) => ({
+                prefix: a.prefix,
+                srcDir: a.srcDir,
+            })),
+        },
+    });
+};
+/**
+ * Map an fs.watch filename (relative to some watched root)
+ * to an absolute path by probing each root, or null when
+ * it matches none (a deletion) — the reload decision then
+ * reloads conservatively.
+ */
+const toChanged = (roots, filename) => {
+    for (const root of roots) {
+        const abs = resolve(root, filename);
+        if (existsSync(abs)) {
+            return abs;
+        }
+    }
+    return null;
+};
+/**
+ * A single hot-reload cycle: refresh the graph, decide
+ * whether the change is relevant, then bump the version,
+ * re-import the entry (re-evaluating the changed
+ * subgraph), swap the live Fetch, and notify browsers. A
+ * failed re-import keeps the last good Fetch so a
+ * mid-edit save never crashes the loop.
+ */
+const reload = async (state, entryUrl, watchAbs, aliases, filename) => {
+    state.graph = scanGraph(watchAbs, aliases);
+    const changed = toChanged(watchAbs, filename);
+    if (changed !== null &&
+        !shouldReload(state.graph, changed)) {
+        return;
+    }
+    state.version += 1;
+    try {
+        state.appFetch = await load(entryUrl, state.version);
+    }
+    catch (e) {
+        log(`plgg-bundle dev: reload failed (${msg(e)}) — keeping last good build`);
+        return;
+    }
+    notifyReload(state.clients);
+    log(`plgg-bundle dev: hot-reloaded (${filename})`);
+};
+/** The URL the dev server is reachable at. */
+const devUrl = (port) => `http://localhost:${port}/`;
+/** The port a listening server actually bound (honours port 0). */
+const boundPort = (server, fallback) => {
+    const addr = server.address();
+    return typeof addr === "object" &&
+        addr !== null &&
+        typeof addr.port === "number"
+        ? addr.port
+        : fallback;
+};
+/**
+ * Start the dev server for a config's `dev` section: load
+ * the app Fetch, serve it over node:http, watch the source
+ * roots, and hot-reload on every relevant code/content
+ * edit. Resolves once the listener is up, with the
+ * reachable URL and a `close` handle.
+ */
+export const runDevServer = async (config) => {
+    const dev = config.dev;
+    if (dev === undefined) {
+        throw new Error("plgg-bundle dev: config has no `dev` section");
+    }
+    const entryUrl = pathToFileURL(under(config.root, dev.entry)).href;
+    const watchAbs = dev.watch.map((w) => under(config.root, w));
+    // The app's own self-alias (source), plus any
+    // cross-package `sourceAliases` — the resolution rules for
+    // both the module graph AND the loader hook.
+    const aliases = [
+        {
+            prefix: config.alias.prefix,
+            srcDir: join(config.root, config.alias.srcRoot),
+        },
+        ...dev.sourceAliases.map((a) => ({
+            prefix: a.prefix,
+            srcDir: under(config.root, a.srcDir),
+        })),
+    ];
+    // Register the cross-package source resolver BEFORE the
+    // first entry import, so a dependency's `<prefix>/*`
+    // loads from source and hot-reloads. Only needed when the
+    // app pulls another package's source (a self-contained
+    // app resolves everything relatively / via its own hook).
+    if (dev.sourceAliases.length > 0) {
+        registerSourceAliases(aliases);
+    }
+    const state = {
+        version: 1,
+        appFetch: await load(entryUrl, 1),
+        graph: scanGraph(watchAbs, aliases),
+        clients: new Set(),
+    };
+    const handler = devHandler(state, dev.allowedHosts);
+    const options = {
+        port: dev.port,
+    };
+    const server = await new Promise((ready) => {
+        const s = serveFetch(options, () => handler, () => ready(s))();
+    });
+    const url = devUrl(boundPort(server, dev.port));
+    log(`plgg-bundle dev on ${url}`);
+    const watchers = watchRoots(watchAbs, (filename) => {
+        void reload(state, entryUrl, watchAbs, aliases, filename);
+    });
+    return {
+        url,
+        close: () => {
+            server.closeAllConnections();
+            server.close();
+            watchers.forEach((w) => w.close());
+        },
+    };
+};
+//# sourceMappingURL=devServer.js.map

package/dist/Dev/node/devServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devServer.js","sourceRoot":"","sources":["../../../src/Dev/node/devServer.ts"],"names":[],"mappings":"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"}

package/dist/Dev/node/httpAdapter.d.ts

@@ -0,0 +1,19 @@
+import { type IncomingMessage, type ServerResponse, type Server } from "node:http";
+import { type Fetch } from "plgg-bundle/Dev/model/Fetch";
+/** How the dev server binds its node:http listener. */
+export type ServeOptions = Readonly<{
+    port: number;
+    hostname?: string;
+}>;
+/** Convert a Node request (+ buffered body) into a Request. */
+export declare const toRequest: (req: IncomingMessage, body: ArrayBuffer) => Request;
+/** Write a Web Response back onto a Node ServerResponse. */
+export declare const writeResponse: (res: ServerResponse, response: Response) => Promise<void>;
+/**
+ * Serve a {@link Fetch} over a node:http server
+ * (data-last). The handler is read fresh from `current()`
+ * per request, so the dev loop can hot-swap the live
+ * `Fetch` without rebinding the listener.
+ */
+export declare const serveFetch: (options: ServeOptions, current: () => Fetch, onListen?: () => void) => () => Server;
+//# sourceMappingURL=httpAdapter.d.ts.map

package/dist/Dev/node/httpAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpAdapter.d.ts","sourceRoot":"","sources":["../../../src/Dev/node/httpAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,MAAM,EACZ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAUzD,uDAAuD;AACvD,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AA4CH,+DAA+D;AAC/D,eAAO,MAAM,SAAS,GACpB,KAAK,eAAe,EACpB,MAAM,WAAW,KAChB,OAgBF,CAAC;AAqBF,4DAA4D;AAC5D,eAAO,MAAM,aAAa,GACxB,KAAK,cAAc,EACnB,UAAU,QAAQ,KACjB,OAAO,CAAC,IAAI,CAUd,CAAC;AAUF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAEnB,SAAS,YAAY,EACrB,SAAS,MAAM,KAAK,EACpB,WAAW,MAAM,IAAI,WAEnB,MAoBH,CAAC"}

package/dist/Dev/node/httpAdapter.js

@@ -0,0 +1,76 @@
+import { createServer, } from "node:http";
+import {} from "plgg-bundle/Dev/model/Fetch";
+/** Buffer a request body into an ArrayBuffer. */
+const collectBody = (req) => new Promise((resolve, reject) => {
+    const chunks = [];
+    req.on("data", (chunk) => {
+        chunks.push(chunk);
+    });
+    req.on("end", () => {
+        const merged = Buffer.concat(chunks);
+        const copy = new ArrayBuffer(merged.byteLength);
+        new Uint8Array(copy).set(merged);
+        resolve(copy);
+    });
+    req.on("error", reject);
+});
+/** Copy Node's incoming headers into Web Headers. */
+const buildHeaders = (raw) => new Headers(Object.entries(raw).flatMap(([key, value]) => value === undefined
+    ? []
+    : typeof value === "string"
+        ? [[key, value]]
+        : value.map((v) => [
+            key,
+            v,
+        ])));
+/** Convert a Node request (+ buffered body) into a Request. */
+export const toRequest = (req, body) => {
+    const method = req.method ?? "GET";
+    const host = req.headers.host ?? "localhost";
+    const url = `http://${host}${req.url ?? "/"}`;
+    return method !== "GET" &&
+        method !== "HEAD" &&
+        body.byteLength > 0
+        ? new Request(url, {
+            method,
+            headers: buildHeaders(req.headers),
+            body,
+        })
+        : new Request(url, {
+            method,
+            headers: buildHeaders(req.headers),
+        });
+};
+/** Stream a Web ReadableStream of bytes onto the Node response. */
+const pump = (reader, res) => reader.read().then((chunk) => chunk.done
+    ? new Promise((resolve) => res.end(() => resolve()))
+    : new Promise((resolve, reject) => res.write(Buffer.from(chunk.value), (e) => e ? reject(e) : resolve())).then(() => pump(reader, res)));
+/** Write a Web Response back onto a Node ServerResponse. */
+export const writeResponse = (res, response) => {
+    res.statusCode = response.status;
+    response.headers.forEach((value, key) => res.setHeader(key, value));
+    return response.body === null
+        ? new Promise((resolve) => res.end(() => resolve()))
+        : pump(response.body.getReader(), res);
+};
+/** Last-resort 500 when the adapter itself throws. */
+const writeError = (res) => {
+    res.statusCode = 500;
+    res.end("Internal Server Error");
+};
+/**
+ * Serve a {@link Fetch} over a node:http server
+ * (data-last). The handler is read fresh from `current()`
+ * per request, so the dev loop can hot-swap the live
+ * `Fetch` without rebinding the listener.
+ */
+export const serveFetch = (options, current, onListen) => () => {
+    const server = createServer((req, res) => collectBody(req)
+        .then((body) => current()(toRequest(req, body)))
+        .then((response) => writeResponse(res, response))
+        .catch(() => writeError(res)));
+    return options.hostname === undefined
+        ? server.listen(options.port, () => onListen?.())
+        : server.listen(options.port, options.hostname, () => onListen?.());
+};
+//# sourceMappingURL=httpAdapter.js.map

package/dist/Dev/node/httpAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpAdapter.js","sourceRoot":"","sources":["../../../src/Dev/node/httpAdapter.ts"],"names":[],"mappings":"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"}

package/dist/Dev/node/scanGraph.d.ts

@@ -0,0 +1,21 @@
+import { type ModuleGraph } from "plgg-bundle/Dev/model/ModuleGraph";
+/**
+ * A self-alias resolution rule: `<prefix>`/`<prefix>/<sub>`
+ * → `<srcDir>`/`<srcDir>/<sub>`. One per package whose
+ * source participates in dev (the app's own, plus any
+ * cross-package `sourceAliases`).
+ */
+export type Alias = Readonly<{
+    prefix: string;
+    srcDir: string;
+}>;
+/**
+ * Scan the watch roots and build the local
+ * {@link ModuleGraph}, resolving relative AND aliased
+ * imports (every rule in `aliases`) so cross-package source
+ * edges are captured. Unreadable roots/files are skipped (a
+ * scan is best-effort — the reload decision falls back to
+ * reloading when the graph is empty).
+ */
+export declare const scanGraph: (roots: ReadonlyArray<string>, aliases: ReadonlyArray<Alias>) => ModuleGraph;
+//# sourceMappingURL=scanGraph.d.ts.map

package/dist/Dev/node/scanGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanGraph.d.ts","sourceRoot":"","sources":["../../../src/Dev/node/scanGraph.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAkBrE;;;;;GAKG;AACH,MAAM,MAAM,KAAK,GAAG,QAAQ,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GACpB,OAAO,aAAa,CAAC,MAAM,CAAC,EAC5B,SAAS,aAAa,CAAC,KAAK,CAAC,KAC5B,WAKA,CAAC"}

package/dist/Dev/node/scanGraph.js

@@ -0,0 +1,145 @@
+import { readdirSync, readFileSync, statSync, } from "node:fs";
+import { resolve, dirname, join, } from "node:path";
+import { parseImports } from "plgg-bundle/Dev/usecase/parseImports";
+import { buildGraph } from "plgg-bundle/Dev/usecase/buildGraph";
+import {} from "plgg-bundle/Dev/model/ModuleGraph";
+// The effectful graph scan: walk the watch roots, read
+// each source file, and resolve its LOCAL import edges
+// (relative specifiers + the app's own self-alias) to
+// absolute paths. Feeds the pure `buildGraph` /
+// reload-decision. In `Dev/node/` (fs seam), excluded from
+// the coverage threshold and exercised by the fixture PoC.
+/** Source extensions whose imports are scanned. */
+const SOURCE_EXT = [
+    ".ts",
+    ".tsx",
+    ".mts",
+    ".js",
+    ".mjs",
+];
+/**
+ * Scan the watch roots and build the local
+ * {@link ModuleGraph}, resolving relative AND aliased
+ * imports (every rule in `aliases`) so cross-package source
+ * edges are captured. Unreadable roots/files are skipped (a
+ * scan is best-effort — the reload decision falls back to
+ * reloading when the graph is empty).
+ */
+export const scanGraph = (roots, aliases) => buildGraph(sourceFiles(roots).flatMap((file) => edgesOf(file, aliases)));
+/** Every source file under the roots (recursive, de-duped). */
+const sourceFiles = (roots) => {
+    const seen = new Set();
+    for (const root of roots) {
+        for (const abs of walk(root)) {
+            seen.add(abs);
+        }
+    }
+    return [...seen];
+};
+/**
+ * Directories never descended into during the graph scan —
+ * dependency trees, build output, VCS. A watch root of `.`
+ * (a package dir) would otherwise pull thousands of
+ * `node_modules` files into the graph.
+ */
+const SKIP_DIRS = [
+    "node_modules",
+    "dist",
+    ".git",
+];
+/**
+ * Recursively list source files under a directory, pruning
+ * {@link SKIP_DIRS}. A manual walk (not `readdirSync`'s
+ * `recursive`) so a huge `node_modules` is never read.
+ */
+const walk = (root) => {
+    let entries;
+    try {
+        entries = readdirSync(root, {
+            withFileTypes: true,
+        });
+    }
+    catch {
+        return [];
+    }
+    return entries.flatMap((entry) => {
+        const abs = join(root, entry.name);
+        if (entry.isDirectory()) {
+            return SKIP_DIRS.includes(entry.name)
+                ? []
+                : walk(abs);
+        }
+        return entry.isFile() &&
+            SOURCE_EXT.some((e) => entry.name.endsWith(e))
+            ? [abs]
+            : [];
+    });
+};
+/** The resolved local edges a single file imports. */
+const edgesOf = (file, aliases) => {
+    const source = read(file);
+    if (source === null) {
+        return [];
+    }
+    return parseImports(source).flatMap((spec) => {
+        const to = resolveLocal(file, spec, aliases);
+        return to === null
+            ? []
+            : [{ from: file, to }];
+    });
+};
+/** Read a file, or null when it cannot be read. */
+const read = (file) => {
+    try {
+        return readFileSync(file, "utf8");
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * Resolve a specifier to an absolute local file, or null
+ * for a package / `node:` specifier. Handles relative
+ * paths and every alias rule (`prefix` / `prefix/…`); tries
+ * the path itself, `.ts`, and `/index.ts`.
+ */
+const resolveLocal = (from, spec, aliases) => {
+    const base = baseOf(from, spec, aliases);
+    if (base === null) {
+        return null;
+    }
+    const candidates = [
+        base,
+        `${base}.ts`,
+        join(base, "index.ts"),
+    ];
+    // A FILE, never a directory: a bare `<prefix>` base is
+    // the src dir (which exists) — prefer its `index.ts`.
+    return (candidates.find(isFile) ?? null);
+};
+/** Whether a path exists and is a regular file. */
+const isFile = (path) => {
+    try {
+        return statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+};
+/** The pre-extension base path a specifier points at. */
+const baseOf = (from, spec, aliases) => {
+    if (spec.startsWith("./") ||
+        spec.startsWith("../")) {
+        return resolve(dirname(from), spec);
+    }
+    for (const alias of aliases) {
+        if (spec === alias.prefix) {
+            return alias.srcDir;
+        }
+        if (spec.startsWith(`${alias.prefix}/`)) {
+            return join(alias.srcDir, spec.slice(alias.prefix.length + 1));
+        }
+    }
+    return null;
+};
+//# sourceMappingURL=scanGraph.js.map

package/dist/Dev/node/scanGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanGraph.js","sourceRoot":"","sources":["../../../src/Dev/node/scanGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,QAAQ,GACT,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,OAAO,EACP,OAAO,EACP,IAAI,GACL,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAoB,MAAM,mCAAmC,CAAC;AAErE,uDAAuD;AACvD,uDAAuD;AACvD,sDAAsD;AACtD,gDAAgD;AAChD,2DAA2D;AAC3D,2DAA2D;AAE3D,mDAAmD;AACnD,MAAM,UAAU,GAA0B;IACxC,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;CACP,CAAC;AAaF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,KAA4B,EAC5B,OAA6B,EAChB,EAAE,CACf,UAAU,CACR,WAAW,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAClC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CACvB,CACF,CAAC;AAEJ,+DAA+D;AAC/D,MAAM,WAAW,GAAG,CAClB,KAA4B,EACL,EAAE;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,SAAS,GAA0B;IACvC,cAAc;IACd,MAAM;IACN,MAAM;CACP,CAAC;AAEF;;;;GAIG;AACH,MAAM,IAAI,GAAG,CACX,IAAY,EACW,EAAE;IACzB,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE;YAC1B,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;gBACnC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,EAAE;YACnB,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CACvB;YACD,CAAC,CAAC,CAAC,GAAG,CAAC;YACP,CAAC,CAAC,EAAE,CAAC;IACT,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,sDAAsD;AACtD,MAAM,OAAO,GAAG,CACd,IAAY,EACZ,OAA6B,EACgB,EAAE;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3C,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7C,OAAO,EAAE,KAAK,IAAI;YAChB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,mDAAmD;AACnD,MAAM,IAAI,GAAG,CAAC,IAAY,EAAiB,EAAE;IAC3C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,YAAY,GAAG,CACnB,IAAY,EACZ,IAAY,EACZ,OAA6B,EACd,EAAE;IACjB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,UAAU,GAAG;QACjB,IAAI;QACJ,GAAG,IAAI,KAAK;QACZ,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;KACvB,CAAC;IACF,uDAAuD;IACvD,sDAAsD;IACtD,OAAO,CACL,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAChC,CAAC;AACJ,CAAC,CAAC;AAEF,mDAAmD;AACnD,MAAM,MAAM,GAAG,CAAC,IAAY,EAAW,EAAE;IACvC,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,GAAG,CACb,IAAY,EACZ,IAAY,EACZ,OAA6B,EACd,EAAE;IACjB,IACE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QACrB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EACtB,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,IAAI,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC,MAAM,CAAC;QACtB,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,OAAO,IAAI,CACT,KAAK,CAAC,MAAM,EACZ,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CACpC,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/dist/Dev/node/watch.d.ts

@@ -0,0 +1,10 @@
+import { type FSWatcher } from "node:fs";
+/**
+ * Watch each root recursively; coalesce bursts onto a
+ * single `onChange` carrying the last changed filename.
+ * Returns the watchers so the caller owns their lifecycle.
+ * A root that cannot be watched is skipped rather than
+ * crashing the dev loop.
+ */
+export declare const watchRoots: (roots: ReadonlyArray<string>, onChange: (filename: string) => void) => ReadonlyArray<FSWatcher>;
+//# sourceMappingURL=watch.d.ts.map

package/dist/Dev/node/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/Dev/node/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAYhD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GACrB,OAAO,aAAa,CAAC,MAAM,CAAC,EAC5B,UAAU,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,KACnC,aAAa,CAAC,SAAS,CA+BzB,CAAC"}

package/dist/Dev/node/watch.js

@@ -0,0 +1,44 @@
+import { watch } from "node:fs";
+// The fs.watch seam: a debounced, recursive watcher over
+// several source roots. One save can emit multiple events,
+// so an imperative timer coalesces them onto a single
+// `onChange(path)`. Kept in `Dev/node/` (effectful,
+// excluded from the coverage threshold) — the pure reload
+// decision it feeds is unit-tested separately.
+/** fs.watch debounce window in ms. */
+const DEBOUNCE_MS = 80;
+/**
+ * Watch each root recursively; coalesce bursts onto a
+ * single `onChange` carrying the last changed filename.
+ * Returns the watchers so the caller owns their lifecycle.
+ * A root that cannot be watched is skipped rather than
+ * crashing the dev loop.
+ */
+export const watchRoots = (roots, onChange) => {
+    // Debounce seam: one shared timer + the latest filename
+    // across all roots.
+    let pending;
+    let latest = "";
+    const fire = (filename) => {
+        latest = filename;
+        clearTimeout(pending);
+        pending = setTimeout(() => {
+            onChange(latest);
+        }, DEBOUNCE_MS);
+    };
+    return roots.flatMap((root) => {
+        try {
+            return [
+                watch(root, { recursive: true }, (_event, filename) => {
+                    if (filename !== null) {
+                        fire(filename);
+                    }
+                }),
+            ];
+        }
+        catch {
+            return [];
+        }
+    });
+};
+//# sourceMappingURL=watch.js.map