@nifrajs/web 3.5.0 → 4.0.2

package/dist/internal/html-spans.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `source` without its HTML comments. A browser ends one at `-->`, and also at `--!>`; an opener
+ * with no end after it is kept as text.
+ */
+export declare function withoutComments(source: string): string;
+/** The text between each `open` and the first `close` after it, read on from that `close`. */
+export declare function delimitedSpans(source: string, open: string, close: string): string[];
+/** `source` without the spans the global `pattern` matches, each handed to `onMatch` first. */
+export declare function withoutMatches(source: string, pattern: RegExp, onMatch?: (match: RegExpMatchArray) => void): string;
+//# sourceMappingURL=html-spans.d.ts.map

package/dist/internal/html-spans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-spans.d.ts","sourceRoot":"","sources":["../../src/internal/html-spans.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAatD;AAED,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CASpF;AAED,+FAA+F;AAC/F,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAC1C,MAAM,CAUR"}

package/dist/internal/html-spans.js

@@ -0,0 +1,46 @@
+// The comment and delimiter readers scan instead of matching one lazy RegExp: a pattern like
+// `<!--[\s\S]*?-->` reads to the end of the source again from every opener that never closes.
+/**
+ * `source` without its HTML comments. A browser ends one at `-->`, and also at `--!>`; an opener
+ * with no end after it is kept as text.
+ */
+export function withoutComments(source) {
+    const end = /--!?>/g;
+    let kept = "";
+    let from = 0;
+    for (let start = source.indexOf("<!--"); start !== -1; start = source.indexOf("<!--", from)) {
+        end.lastIndex = start + 4;
+        const close = end.exec(source);
+        // No later opener has an end after it either.
+        if (close === null)
+            break;
+        kept += source.slice(from, start);
+        from = close.index + close[0].length;
+    }
+    return kept + source.slice(from);
+}
+/** The text between each `open` and the first `close` after it, read on from that `close`. */
+export function delimitedSpans(source, open, close) {
+    const spans = [];
+    for (let start = source.indexOf(open); start !== -1;) {
+        const end = source.indexOf(close, start + open.length);
+        if (end === -1)
+            break;
+        spans.push(source.slice(start + open.length, end));
+        start = source.indexOf(open, end + close.length);
+    }
+    return spans;
+}
+/** `source` without the spans the global `pattern` matches, each handed to `onMatch` first. */
+export function withoutMatches(source, pattern, onMatch) {
+    let kept = "";
+    let from = 0;
+    for (const match of source.matchAll(pattern)) {
+        onMatch?.(match);
+        const start = match.index ?? 0;
+        kept += source.slice(from, start);
+        from = start + match[0].length;
+    }
+    return kept + source.slice(from);
+}
+//# sourceMappingURL=html-spans.js.map

package/dist/internal/html-spans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-spans.js","sourceRoot":"","sources":["../../src/internal/html-spans.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,8FAA8F;AAE9F;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,GAAG,GAAG,QAAQ,CAAA;IACpB,IAAI,IAAI,GAAG,EAAE,CAAA;IACb,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,KAAK,IAAI,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;QAC5F,GAAG,CAAC,SAAS,GAAG,KAAK,GAAG,CAAC,CAAA;QACzB,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC9B,8CAA8C;QAC9C,IAAI,KAAK,KAAK,IAAI;YAAE,MAAK;QACzB,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACjC,IAAI,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;IACtC,CAAC;IACD,OAAO,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AAClC,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,IAAY,EAAE,KAAa;IACxE,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,IAAI,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,GAAI,CAAC;QACtD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;QACtD,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,MAAK;QACrB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;QAClD,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;IAClD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,OAAe,EACf,OAA2C;IAE3C,IAAI,IAAI,GAAG,EAAE,CAAA;IACb,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;QAChB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,CAAA;QAC9B,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACjC,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;IAChC,CAAC;IACD,OAAO,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AAClC,CAAC"}

package/dist/internal/loading-runtime.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `_loading` pages. The router is untouched: {@link withLoading} only swaps the leaf of the state the
+ * view is told while a navigation is pending, so no adapter knows a loading page exists.
+ */
+import type { MatchChain } from "../render-seam.js";
+import { type ClientRouter } from "../router.js";
+/** How long a navigation may run before its `_loading` page shows. Shorter loads swap straight to the
+ * new page: a skeleton that flashes for a few frames reads as a glitch, not as feedback. */
+export declare const LOADING_DELAY_MS = 120;
+/**
+ * One route's row: its layout ids (outermost → innermost), and the `_loading` pages above it
+ * (outermost → innermost), each paired with how many of those layouts sit at or above it.
+ */
+export type LoadingRoute = readonly [
+    layoutIds: readonly string[],
+    loadings: ReadonlyArray<readonly [id: string, layouts: number]>
+];
+export interface LoadingOptions {
+    /** Every route id → its {@link LoadingRoute} row. A route id absent here has no layouts. */
+    readonly routes: Readonly<Record<string, LoadingRoute>>;
+    /** `_loading` id → a lazy import of its module. */
+    readonly modules: Readonly<Record<string, () => Promise<{
+        readonly default?: unknown;
+        readonly handle?: unknown;
+    }>>>;
+    /** The mounted view's route id → component chain table. The wrapper adds a chain per loading view. */
+    readonly chains: Record<string, readonly unknown[]>;
+    /** Route id → search-schema chain, kept in step with {@link chains}. */
+    readonly searchSchemas: Record<string, readonly unknown[]>;
+    /** Route id → what `useMatches` reports, kept in step with {@link chains}. */
+    readonly matchChains?: Record<string, MatchChain>;
+    /** Override {@link LOADING_DELAY_MS}. */
+    readonly delayMs?: number;
+    /** Where a navigation goes when it fails after its loading page was shown. Defaults to a document
+     * load of the path. */
+    readonly fallback?: (path: string) => void;
+}
+/**
+ * Shows the innermost `_loading` within the layouts both pages share once a navigation outlasts
+ * `delayMs`. `navigate` settles when it shows, so a view transition does not hold across the wait; a
+ * later failure goes to `fallback`, or replaces the entry for a redirect out of the app.
+ */
+export declare function withLoading(router: ClientRouter, options: LoadingOptions): ClientRouter;
+//# sourceMappingURL=loading-runtime.d.ts.map

package/dist/internal/loading-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading-runtime.d.ts","sourceRoot":"","sources":["../../src/internal/loading-runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,KAAK,YAAY,EAAgC,MAAM,cAAc,CAAA;AAE9E;4FAC4F;AAC5F,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAEnC;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS;IAClC,SAAS,EAAE,SAAS,MAAM,EAAE;IAC5B,QAAQ,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;CAChE,CAAA;AAED,MAAM,WAAW,cAAc;IAC7B,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;IACvD,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CACxB,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CACzF,CAAA;IACD,sGAAsG;IACtG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC,CAAA;IACnD,wEAAwE;IACxE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC,CAAA;IAC1D,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACjD,yCAAyC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB;2BACuB;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC3C;AAOD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,GAAG,YAAY,CAiMvF"}

package/dist/internal/loading-runtime.js

@@ -0,0 +1,206 @@
+import { redirectOf } from "../router.js";
+/** How long a navigation may run before its `_loading` page shows. Shorter loads swap straight to the
+ * new page: a skeleton that flashes for a few frames reads as a glitch, not as feedback. */
+export const LOADING_DELAY_MS = 120;
+const pathnameOf = (path) => {
+    const q = path.indexOf("?");
+    return q === -1 ? path : path.slice(0, q);
+};
+/**
+ * Shows the innermost `_loading` within the layouts both pages share once a navigation outlasts
+ * `delayMs`. `navigate` settles when it shows, so a view transition does not hold across the wait; a
+ * later failure goes to `fallback`, or replaces the entry for a redirect out of the app.
+ */
+export function withLoading(router, options) {
+    const { routes, modules, chains, searchSchemas, matchChains } = options;
+    const delayMs = options.delayMs ?? LOADING_DELAY_MS;
+    const fallback = options.fallback ?? ((path) => location.assign(path));
+    const listeners = new Set();
+    const components = new Map();
+    const handles = new Map();
+    const inflight = new Map();
+    /** Bumped per navigation through this wrapper - the latest one owns the page slot. */
+    let seq = 0;
+    /** The loading view on screen (its chain id), and the navigation it belongs to. */
+    let shown;
+    let owner = 0;
+    // One derived state per (router state, loading view) so `snapshot` is referentially stable.
+    let base;
+    let derived;
+    const emit = () => {
+        for (const listener of [...listeners])
+            listener();
+    };
+    const load = (id) => {
+        if (components.has(id))
+            return Promise.resolve();
+        const running = inflight.get(id);
+        if (running !== undefined)
+            return running;
+        const importer = modules[id];
+        const job = (importer === undefined ? Promise.reject(new Error(`no _loading module "${id}"`)) : importer())
+            .then((mod) => {
+            if (mod.default !== undefined)
+                components.set(id, mod.default);
+            handles.set(id, mod.handle);
+        })
+            .finally(() => {
+            inflight.delete(id);
+        });
+        inflight.set(id, job);
+        return job;
+    };
+    const pick = (fromId, toId) => {
+        const target = routes[toId];
+        if (target === undefined)
+            return undefined;
+        const current = routes[fromId]?.[0] ?? [];
+        const [layouts, candidates] = target;
+        let shared = 0;
+        while (shared < current.length &&
+            shared < layouts.length &&
+            current[shared] === layouts[shared]) {
+            shared++;
+        }
+        for (let i = candidates.length - 1; i >= 0; i--) {
+            const candidate = candidates[i];
+            if (candidate !== undefined && candidate[1] <= shared)
+                return { id: candidate[0], shared };
+        }
+        return undefined;
+    };
+    const snapshot = () => {
+        const state = router.snapshot();
+        if (shown === undefined || !state.pending)
+            return state;
+        if (base !== state || derived === undefined || derived.routeId !== shown) {
+            base = state;
+            // The layouts keep their data and the URL-derived fields stay the current page's; only the leaf
+            // changes, and it has no loader data of its own.
+            derived = { ...state, routeId: shown, data: null };
+        }
+        return derived;
+    };
+    const navigate = (path) => {
+        const match = router.match(path);
+        // Unmatched: the router ignores it, so whatever is on screen stays as it is.
+        if (match === null)
+            return router.navigate(path);
+        const mine = ++seq;
+        const from = router.snapshot();
+        const choice = pathnameOf(from.path) === pathnameOf(path) ? undefined : pick(from.routeId, match.routeId);
+        // NUL-prefixed: a chain id no route file can produce.
+        const view = choice === undefined ? undefined : `\0${choice.id}\0${from.routeId}\0${choice.shared}`;
+        const wasShown = shown !== undefined;
+        // A newer navigation that would show the same view keeps it, rather than flashing the old page.
+        const carried = wasShown && shown === view;
+        if (carried)
+            owner = mine;
+        else
+            shown = undefined;
+        const done = router.navigate(path);
+        if (choice === undefined || view === undefined) {
+            if (wasShown)
+                emit();
+            return done;
+        }
+        let finished = false;
+        let revealed = carried;
+        let timer;
+        const reveal = new Promise((resolve) => {
+            if (carried) {
+                setTimeout(resolve, 0);
+                return;
+            }
+            const show = () => {
+                if (finished || mine !== seq || !router.snapshot().pending)
+                    return;
+                const component = components.get(choice.id);
+                if (component === undefined)
+                    return;
+                chains[view] ??= [...(chains[from.routeId] ?? []).slice(0, choice.shared), component];
+                // The current route's schemas: the URL is still its URL, so its layouts read the same search.
+                searchSchemas[view] ??= searchSchemas[from.routeId] ?? [];
+                if (matchChains !== undefined) {
+                    const current = matchChains[from.routeId];
+                    matchChains[view] ??= {
+                        ids: [...(current?.ids ?? []).slice(0, choice.shared), choice.id],
+                        handles: [...(current?.handles ?? []).slice(0, choice.shared), handles.get(choice.id)],
+                    };
+                }
+                shown = view;
+                owner = mine;
+                revealed = true;
+                emit();
+                // A macrotask later, so the view has committed the loading page before the caller resumes.
+                setTimeout(resolve, 0);
+            };
+            const ready = load(choice.id);
+            // A `_loading` module that fails to load costs only the loading page, never the navigation.
+            ready.catch(() => { });
+            timer = setTimeout(() => {
+                ready.then(show, () => { });
+            }, wasShown ? 0 : delayMs);
+        });
+        const finish = () => {
+            finished = true;
+            clearTimeout(timer);
+            if (owner !== mine || shown === undefined)
+                return;
+            shown = undefined;
+            // A navigation that ended without publishing (superseded inside the router) leaves the store
+            // pending: tell the view the page slot is the current page's again.
+            if (router.snapshot().pending)
+                emit();
+        };
+        const settled = done.then(finish, (error) => {
+            finish();
+            // A newer navigation owns the document now; even an aborted older fetch can reject late.
+            if (mine !== seq)
+                return;
+            if (!revealed)
+                throw error;
+            const to = redirectOf(error);
+            if (to === undefined)
+                fallback(path);
+            else
+                location.replace(to);
+        });
+        return Promise.race([settled, reveal]);
+    };
+    return {
+        ...router,
+        snapshot,
+        subscribe(listener) {
+            listeners.add(listener);
+            const unsubscribe = router.subscribe(listener);
+            return () => {
+                listeners.delete(listener);
+                unsubscribe();
+            };
+        },
+        navigate,
+        submit(action, body, opts) {
+            ++seq;
+            shown = undefined;
+            return router.submit(action, body, opts);
+        },
+        invalidate(paths) {
+            if (paths === undefined || paths.includes(router.snapshot().path)) {
+                ++seq;
+                shown = undefined;
+            }
+            return router.invalidate(paths);
+        },
+        prefetch(path) {
+            // Warm the loading pages a navigation there could show, alongside the route itself.
+            const match = router.match(path);
+            if (match !== null) {
+                for (const [id] of routes[match.routeId]?.[1] ?? [])
+                    load(id).catch(() => { });
+            }
+            return router.prefetch(path);
+        },
+    };
+}
+//# sourceMappingURL=loading-runtime.js.map

package/dist/internal/loading-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading-runtime.js","sourceRoot":"","sources":["../../src/internal/loading-runtime.ts"],"names":[],"mappings":"AAKA,OAAO,EAAuC,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9E;4FAC4F;AAC5F,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAA;AA+BnC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE;IAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC3B,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAC3C,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAoB,EAAE,OAAuB;IACvE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,OAAO,CAAA;IACvE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAA;IACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IAE9E,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAA;IACvC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAmB,CAAA;IAC7C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAA;IAC1C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAA;IACjD,sFAAsF;IACtF,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,mFAAmF;IACnF,IAAI,KAAyB,CAAA;IAC7B,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,4FAA4F;IAC5F,IAAI,IAA6B,CAAA;IACjC,IAAI,OAAgC,CAAA;IAEpC,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,SAAS,CAAC;YAAE,QAAQ,EAAE,CAAA;IACnD,CAAC,CAAA;IAED,MAAM,IAAI,GAAG,CAAC,EAAU,EAAiB,EAAE;QACzC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;QAChD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAChC,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,OAAO,CAAA;QACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,EAAE,CAAC,CAAA;QAC5B,MAAM,GAAG,GAAG,CACV,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAC9F;aACE,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;YACZ,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;gBAAE,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;YAC9D,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;QAC7B,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACrB,CAAC,CAAC,CAAA;QACJ,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;QACrB,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;IAED,MAAM,IAAI,GAAG,CACX,MAAc,EACd,IAAY,EACkD,EAAE;QAChE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QAC3B,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACzC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,MAAM,CAAA;QACpC,IAAI,MAAM,GAAG,CAAC,CAAA;QACd,OACE,MAAM,GAAG,OAAO,CAAC,MAAM;YACvB,MAAM,GAAG,OAAO,CAAC,MAAM;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,EACnC,CAAC;YACD,MAAM,EAAE,CAAA;QACV,CAAC;QACD,KAAK,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAChD,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;YAC/B,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,MAAM;gBAAE,OAAO,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAA;QAC5F,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,GAAgB,EAAE;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;QAC/B,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO;YAAE,OAAO,KAAK,CAAA;QACvD,IAAI,IAAI,KAAK,KAAK,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YACzE,IAAI,GAAG,KAAK,CAAA;YACZ,gGAAgG;YAChG,iDAAiD;YACjD,OAAO,GAAG,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;QACpD,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAiB,EAAE;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAChC,6EAA6E;QAC7E,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAChD,MAAM,IAAI,GAAG,EAAE,GAAG,CAAA;QAClB,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;QAC9B,MAAM,MAAM,GACV,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QAC5F,sDAAsD;QACtD,MAAM,IAAI,GACR,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,CAAA;QACxF,MAAM,QAAQ,GAAG,KAAK,KAAK,SAAS,CAAA;QACpC,gGAAgG;QAChG,MAAM,OAAO,GAAG,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAA;QAC1C,IAAI,OAAO;YAAE,KAAK,GAAG,IAAI,CAAA;;YACpB,KAAK,GAAG,SAAS,CAAA;QAEtB,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAClC,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/C,IAAI,QAAQ;gBAAE,IAAI,EAAE,CAAA;YACpB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,QAAQ,GAAG,KAAK,CAAA;QACpB,IAAI,QAAQ,GAAG,OAAO,CAAA;QACtB,IAAI,KAAgD,CAAA;QACpD,MAAM,MAAM,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC3C,IAAI,OAAO,EAAE,CAAC;gBACZ,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;gBACtB,OAAM;YACR,CAAC;YACD,MAAM,IAAI,GAAG,GAAS,EAAE;gBACtB,IAAI,QAAQ,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO;oBAAE,OAAM;gBAClE,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;gBAC3C,IAAI,SAAS,KAAK,SAAS;oBAAE,OAAM;gBACnC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAA;gBACrF,8FAA8F;gBAC9F,aAAa,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;gBACzD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;oBAC9B,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;oBACzC,WAAW,CAAC,IAAI,CAAC,KAAK;wBACpB,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC;wBACjE,OAAO,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;qBACvF,CAAA;gBACH,CAAC;gBACD,KAAK,GAAG,IAAI,CAAA;gBACZ,KAAK,GAAG,IAAI,CAAA;gBACZ,QAAQ,GAAG,IAAI,CAAA;gBACf,IAAI,EAAE,CAAA;gBACN,2FAA2F;gBAC3F,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;YACxB,CAAC,CAAA;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YAC7B,4FAA4F;YAC5F,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YACrB,KAAK,GAAG,UAAU,CAChB,GAAG,EAAE;gBACH,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YAC5B,CAAC,EACD,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CACvB,CAAA;QACH,CAAC,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,QAAQ,GAAG,IAAI,CAAA;YACf,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAM;YACjD,KAAK,GAAG,SAAS,CAAA;YACjB,6FAA6F;YAC7F,oEAAoE;YACpE,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO;gBAAE,IAAI,EAAE,CAAA;QACvC,CAAC,CAAA;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAc,EAAE,EAAE;YACnD,MAAM,EAAE,CAAA;YACR,yFAAyF;YACzF,IAAI,IAAI,KAAK,GAAG;gBAAE,OAAM;YACxB,IAAI,CAAC,QAAQ;gBAAE,MAAM,KAAK,CAAA;YAC1B,MAAM,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;YAC5B,IAAI,EAAE,KAAK,SAAS;gBAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;;gBAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAC3B,CAAC,CAAC,CAAA;QACF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;IACxC,CAAC,CAAA;IAED,OAAO;QACL,GAAG,MAAM;QACT,QAAQ;QACR,SAAS,CAAC,QAAQ;YAChB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACvB,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;YAC9C,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;gBAC1B,WAAW,EAAE,CAAA;YACf,CAAC,CAAA;QACH,CAAC;QACD,QAAQ;QACR,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI;YACvB,EAAE,GAAG,CAAA;YACL,KAAK,GAAG,SAAS,CAAA;YACjB,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;QAC1C,CAAC;QACD,UAAU,CAAC,KAAK;YACd,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClE,EAAE,GAAG,CAAA;gBACL,KAAK,GAAG,SAAS,CAAA;YACnB,CAAC;YACD,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;QACjC,CAAC;QACD,QAAQ,CAAC,IAAI;YACX,oFAAoF;YACpF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAChC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,KAAK,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;oBAAE,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YAC/E,CAAC;YACD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC9B,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/internal/matches-runtime.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `useMatches` for every adapter. It reads only {@link RenderProps}, which SSR and the mounted router
+ * both build, so server and browser agree. Layout prefixes follow the `filePathToRoutes` grammar.
+ */
+import type { RenderProps, UIMatch } from "../render-seam.js";
+/** The matches of one render, outermost layout first. Empty when the render carries no chain. */
+export declare function chainMatches(props: RenderProps): readonly UIMatch[];
+//# sourceMappingURL=matches-runtime.d.ts.map

package/dist/internal/matches-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matches-runtime.d.ts","sourceRoot":"","sources":["../../src/internal/matches-runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAO7D,iGAAiG;AACjG,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,OAAO,EAAE,CAiDnE"}

package/dist/internal/matches-runtime.js

@@ -0,0 +1,61 @@
+const GROUP = /^\(.+\)$/;
+const OPTIONAL = /^\[\[([A-Za-z_][A-Za-z0-9_]*)\]\]$/;
+const CATCH_ALL = /^\[\.\.\.([A-Za-z_][A-Za-z0-9_]*)\]$/;
+const MARKER = /\[([A-Za-z_][A-Za-z0-9_]*)\]/g;
+/** The matches of one render, outermost layout first. Empty when the render carries no chain. */
+export function chainMatches(props) {
+    const chain = props.matchChain;
+    if (chain === undefined)
+        return [];
+    const path = props.path ?? "";
+    const query = path.indexOf("?");
+    const pathname = query === -1 ? path : path.slice(0, query);
+    const segments = pathname.split("/").filter((segment) => segment !== "");
+    const params = props.params ?? {};
+    const last = chain.ids.length - 1;
+    return chain.ids.map((id, index) => {
+        const handle = chain.handles[index];
+        if (index === last)
+            return { id, pathname, params, data: props.data, handle };
+        const owned = {};
+        let depth = 0;
+        let rest = false;
+        const slash = id.lastIndexOf("/");
+        for (const part of slash === -1 ? [] : id.slice(0, slash).split("/")) {
+            if (part === "index" || GROUP.test(part))
+                continue;
+            const optional = OPTIONAL.exec(part)?.[1];
+            if (optional !== undefined) {
+                const value = params[optional];
+                if (value !== undefined) {
+                    owned[optional] = value;
+                    depth += 1;
+                }
+                continue;
+            }
+            const catchAll = CATCH_ALL.exec(part)?.[1];
+            if (catchAll !== undefined) {
+                const value = params[catchAll];
+                if (value !== undefined)
+                    owned[catchAll] = value;
+                rest = true;
+                break;
+            }
+            for (const marker of part.matchAll(MARKER)) {
+                const name = marker[1];
+                const value = params[name];
+                if (value !== undefined)
+                    owned[name] = value;
+            }
+            depth += 1;
+        }
+        return {
+            id,
+            pathname: rest ? pathname : `/${segments.slice(0, depth).join("/")}`,
+            params: owned,
+            data: props.layoutData?.[index] ?? null,
+            handle,
+        };
+    });
+}
+//# sourceMappingURL=matches-runtime.js.map

package/dist/internal/matches-runtime.js.map

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

package/dist/internal/mount-shadow.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Page routes a mount makes unreachable.
+ *
+ * A pre-route mount (the auto-mounted backend at `apiPrefix`, a `mounts` entry, an `app.mount()` in
+ * `use`) answers every request under its path before page routing, and its 404 is final -
+ * `fallbackOn: 404` only tries the next mount. A page file whose URL sits under one therefore never
+ * renders, and nothing says so: the request gets the mount's 404. This finds those pages so the app
+ * fails at startup, at build, and in `nifra check` instead.
+ *
+ * Pure and fs-free: it takes the manifest and the mount paths, so the runtime, the build and the static
+ * check all run the same comparison.
+ */
+import type { Manifest } from "../manifest.js";
+/** A page file whose URL pattern sits under a mount. */
+export interface ShadowedPage {
+    /** The route file, as the manifest names it (relative to `routes/`). */
+    readonly file: string;
+    /** The URL pattern the file serves. */
+    readonly pattern: string;
+    /** The mount path, normalized as the server matches it. */
+    readonly mount: string;
+}
+/**
+ * Normalize a mount path the way the server's mount table does: drop a trailing `/*` and a trailing
+ * `/`, keep `/` for a root mount. `undefined` for a path the server would refuse (not absolute, a
+ * query or hash, a param or an inner wildcard) - the mount itself reports that.
+ */
+export declare function normalizeMountPath(path: string): string | undefined;
+/**
+ * The page routes and nested `_404` scopes that sit under one of `mountPaths`, in manifest order. Paths
+ * are normalized here; one the server would refuse is skipped.
+ */
+export declare function shadowedPages(manifest: Pick<Manifest, "routes" | "notFounds">, mountPaths: readonly string[]): readonly ShadowedPage[];
+/** The message every surface reports shadowed pages with. */
+export declare function formatShadowedPages(pages: readonly ShadowedPage[]): string;
+//# sourceMappingURL=mount-shadow.d.ts.map

package/dist/internal/mount-shadow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-shadow.d.ts","sourceRoot":"","sources":["../../src/internal/mount-shadow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMnE;AAUD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC,EAChD,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,SAAS,YAAY,EAAE,CAuBzB;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAS1E"}

package/dist/internal/mount-shadow.js

@@ -0,0 +1,65 @@
+/**
+ * Normalize a mount path the way the server's mount table does: drop a trailing `/*` and a trailing
+ * `/`, keep `/` for a root mount. `undefined` for a path the server would refuse (not absolute, a
+ * query or hash, a param or an inner wildcard) - the mount itself reports that.
+ */
+export function normalizeMountPath(path) {
+    if (!path.startsWith("/") || path.includes("?") || path.includes("#"))
+        return undefined;
+    const bare = path.endsWith("/*") ? path.slice(0, -2) : path;
+    if (bare.includes("*") || bare.includes(":"))
+        return undefined;
+    if (bare.length === 0)
+        return "/";
+    return bare.length > 1 && bare.endsWith("/") ? bare.slice(0, -1) : bare;
+}
+/** Whether every request a pattern serves lands under `mount`: its leading segments equal the mount's
+ * segments literally. A param or wildcard segment is not the mount's literal text, so `/:lang/x` is
+ * reachable for every other value and is not reported. */
+function patternUnderMount(pattern, mount) {
+    if (mount === "/")
+        return true;
+    return pattern === mount || pattern.startsWith(`${mount}/`);
+}
+/**
+ * The page routes and nested `_404` scopes that sit under one of `mountPaths`, in manifest order. Paths
+ * are normalized here; one the server would refuse is skipped.
+ */
+export function shadowedPages(manifest, mountPaths) {
+    const mounts = [];
+    for (const path of mountPaths) {
+        const normalized = normalizeMountPath(path);
+        if (normalized !== undefined && !mounts.includes(normalized))
+            mounts.push(normalized);
+    }
+    if (mounts.length === 0)
+        return [];
+    const found = [];
+    const under = (pattern) => {
+        for (const mount of mounts)
+            if (patternUnderMount(pattern, mount))
+                return mount;
+        return undefined;
+    };
+    for (const route of manifest.routes) {
+        const mount = under(route.pattern);
+        if (mount !== undefined)
+            found.push({ file: route.file, pattern: route.pattern, mount });
+    }
+    for (const entry of Object.values(manifest.notFounds ?? {})) {
+        for (const scope of entry.scopes) {
+            const mount = under(scope.pattern);
+            if (mount !== undefined)
+                found.push({ file: entry.file, pattern: scope.pattern, mount });
+        }
+    }
+    return found;
+}
+/** The message every surface reports shadowed pages with. */
+export function formatShadowedPages(pages) {
+    const lines = pages.map((page) => `  ${page.file} serves ${page.pattern}, under the mount at ${page.mount}`);
+    return (`${pages.length === 1 ? "1 page route" : `${pages.length} page routes`} can never render: a mount answers every request under its path before page routing, and its 404 is final.\n` +
+        `${lines.join("\n")}\n` +
+        'Move each file out of the mounted path, or serve that URL from the mounted app. The backend\'s mount path is `apiPrefix` (default "/api"; export it from framework.ts, or set it to "" to turn the mount off).');
+}
+//# sourceMappingURL=mount-shadow.js.map

package/dist/internal/mount-shadow.js.map

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

package/dist/internal/node-builtins.d.ts

@@ -0,0 +1,3 @@
+/** Whether `specifier` names a Node built-in without the `node:` prefix (`fs/promises`). */
+export declare const isBareNodeBuiltin: (specifier: string) => boolean;
+//# sourceMappingURL=node-builtins.d.ts.map

package/dist/internal/node-builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-builtins.d.ts","sourceRoot":"","sources":["../../src/internal/node-builtins.ts"],"names":[],"mappings":"AA6EA,4FAA4F;AAC5F,eAAO,MAAM,iBAAiB,GAAI,WAAW,MAAM,KAAG,OAA8C,CAAA"}

package/dist/internal/node-builtins.js

@@ -0,0 +1,79 @@
+/**
+ * Node's built-in module names without the `node:` prefix (`fs`, `fs/promises`, ...), for the client
+ * build guards. A fixed list rather than `module.builtinModules`, which differs between Node and Bun
+ * (Bun adds `bun:*`), so a leak reads the same whichever runtime runs the build. Names that exist only
+ * with the prefix (`node:test`, `node:sqlite`) are covered by the prefix itself.
+ */
+const NODE_BUILTIN_MODULES = new Set([
+    "_http_agent",
+    "_http_client",
+    "_http_common",
+    "_http_incoming",
+    "_http_outgoing",
+    "_http_server",
+    "_stream_duplex",
+    "_stream_passthrough",
+    "_stream_readable",
+    "_stream_transform",
+    "_stream_wrap",
+    "_stream_writable",
+    "_tls_common",
+    "_tls_wrap",
+    "assert",
+    "assert/strict",
+    "async_hooks",
+    "buffer",
+    "child_process",
+    "cluster",
+    "console",
+    "constants",
+    "crypto",
+    "dgram",
+    "diagnostics_channel",
+    "dns",
+    "dns/promises",
+    "domain",
+    "events",
+    "fs",
+    "fs/promises",
+    "http",
+    "http2",
+    "https",
+    "inspector",
+    "inspector/promises",
+    "module",
+    "net",
+    "os",
+    "path",
+    "path/posix",
+    "path/win32",
+    "perf_hooks",
+    "process",
+    "punycode",
+    "querystring",
+    "readline",
+    "readline/promises",
+    "repl",
+    "stream",
+    "stream/consumers",
+    "stream/promises",
+    "stream/web",
+    "string_decoder",
+    "sys",
+    "timers",
+    "timers/promises",
+    "tls",
+    "trace_events",
+    "tty",
+    "url",
+    "util",
+    "util/types",
+    "v8",
+    "vm",
+    "wasi",
+    "worker_threads",
+    "zlib",
+]);
+/** Whether `specifier` names a Node built-in without the `node:` prefix (`fs/promises`). */
+export const isBareNodeBuiltin = (specifier) => NODE_BUILTIN_MODULES.has(specifier);
+//# sourceMappingURL=node-builtins.js.map

package/dist/internal/node-builtins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-builtins.js","sourceRoot":"","sources":["../../src/internal/node-builtins.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC;IACxD,aAAa;IACb,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,cAAc;IACd,gBAAgB;IAChB,qBAAqB;IACrB,kBAAkB;IAClB,mBAAmB;IACnB,cAAc;IACd,kBAAkB;IAClB,aAAa;IACb,WAAW;IACX,QAAQ;IACR,eAAe;IACf,aAAa;IACb,QAAQ;IACR,eAAe;IACf,SAAS;IACT,SAAS;IACT,WAAW;IACX,QAAQ;IACR,OAAO;IACP,qBAAqB;IACrB,KAAK;IACL,cAAc;IACd,QAAQ;IACR,QAAQ;IACR,IAAI;IACJ,aAAa;IACb,MAAM;IACN,OAAO;IACP,OAAO;IACP,WAAW;IACX,oBAAoB;IACpB,QAAQ;IACR,KAAK;IACL,IAAI;IACJ,MAAM;IACN,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,SAAS;IACT,UAAU;IACV,aAAa;IACb,UAAU;IACV,mBAAmB;IACnB,MAAM;IACN,QAAQ;IACR,kBAAkB;IAClB,iBAAiB;IACjB,YAAY;IACZ,gBAAgB;IAChB,KAAK;IACL,QAAQ;IACR,iBAAiB;IACjB,KAAK;IACL,cAAc;IACd,KAAK;IACL,KAAK;IACL,MAAM;IACN,YAAY;IACZ,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,gBAAgB;IAChB,MAAM;CACP,CAAC,CAAA;AAEF,4FAA4F;AAC5F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAiB,EAAW,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA"}