@alchemy.run/node-utils 2.0.0-beta.76 → 2.0.0-beta.78

package/THIRD_PARTY_LICENSES.md

@@ -6,7 +6,7 @@ respective license notices.
 
 ## Astro
 
-Portions of `packages/cloudflare-frameworks/src/astro` are derived from
+Portions of `packages/frontend-frameworks/src/astro` are derived from
 `@astrojs/cloudflare`.
 
 Copyright (c) 2021 Fred K. Schott
@@ -33,7 +33,7 @@ SOFTWARE.
 
 ## SvelteKit
 
-Portions of `packages/cloudflare-frameworks/src/sveltekit` are derived from
+Portions of `packages/frontend-frameworks/src/sveltekit` are derived from
 `@sveltejs/adapter-cloudflare`.
 
 Copyright (c) 2020 SvelteKit contributors
@@ -43,7 +43,7 @@ Astro section above.
 
 ## Waku
 
-Portions of `packages/cloudflare-frameworks/src/waku` are derived from Waku.
+Portions of `packages/frontend-frameworks/src/waku` are derived from Waku.
 
 Copyright (c) 2023 Daishi Kato
 
@@ -65,7 +65,7 @@ License reproduced in the Astro section above.
 
 ## OpenNext for Cloudflare
 
-Portions of `packages/cloudflare-frameworks/src/nextjs`, including the build
+Portions of `packages/frontend-frameworks/src/nextjs`, including the build
 runner and development-context integration, are derived from OpenNext for
 Cloudflare.
 
@@ -122,17 +122,17 @@ been dedicated to the public domain. See <https://www.sqlite.org/copyright.html>
 
 ## Upstream source references
 
-- Astro: <https://github.com/withastro/astro>
-- SvelteKit: <https://github.com/sveltejs/kit>
-- Waku: <https://github.com/wakujs/waku>
-- Cloudflare Workers SDK: <https://github.com/cloudflare/workers-sdk>
-- OpenNext for Cloudflare: <https://github.com/opennextjs/opennextjs-cloudflare>
+- Astro: [`a2240c43830e29c1d85667f4c610655d6b10253f`](https://github.com/withastro/astro/tree/a2240c43830e29c1d85667f4c610655d6b10253f)
+- SvelteKit: [`f36b3a4cd307bd8c89e03fa191becc175e7b3077`](https://github.com/sveltejs/kit/tree/f36b3a4cd307bd8c89e03fa191becc175e7b3077)
+- Waku: [`39e868f2638c27de9635c68ebf965e14a4112e9b`](https://github.com/wakujs/waku/tree/39e868f2638c27de9635c68ebf965e14a4112e9b)
+- Cloudflare Workers SDK: [`b7b4ff84477982e7c770bb93928287893fcf2e03`](https://github.com/cloudflare/workers-sdk/tree/b7b4ff84477982e7c770bb93928287893fcf2e03)
+- OpenNext for Cloudflare: [`da4b7fc8c89441a6f96205635fa70e329d1f0df7`](https://github.com/opennextjs/opennextjs-cloudflare/tree/da4b7fc8c89441a6f96205635fa70e329d1f0df7)
 - SST: <https://github.com/sst/sst>
 - node-sanitize-filename: <https://github.com/parshap/node-sanitize-filename>
 - node-ignore: <https://github.com/kaelzhang/node-ignore>
 - SQLite: <https://github.com/sqlite/sqlite>
 
-The external `.vendor` Git submodules are separate works governed by the
-license files in their respective repositories. This notice covers code copied
+The first-class `submodules/` checkouts (distilled, floci) are separate works
+governed by the license files in their respective repositories. This notice covers code copied
 or adapted into the Alchemy repository; it does not replace the license
 documentation within those submodules.

package/lib/dependency-watcher.d.ts

@@ -0,0 +1,28 @@
+import { type ChokidarOptions } from "chokidar";
+export interface DependencyChange {
+    readonly paths: ReadonlySet<string>;
+}
+export type DependencyChangeListener = (change: DependencyChange) => void;
+export interface DependencyWatcherOptions {
+    /** Chokidar options passed to the file watcher. */
+    readonly watch?: ChokidarOptions | undefined;
+    readonly debounceMs?: number | undefined;
+}
+/**
+ * Watches an explicit set of absolute file paths and delivers debounced
+ * batches only when their contents change. Chokidar follows editor atomic-save
+ * replacements without polling by default. The set is replaced wholesale
+ * with {@link set}, so the watcher always mirrors exactly the files the caller
+ * currently depends on.
+ */
+export declare class DependencyWatcher {
+    #private;
+    constructor(options?: DependencyWatcherOptions);
+    get dependencies(): ReadonlySet<string>;
+    subscribe(listener: DependencyChangeListener): () => void;
+    /** Replace the watched set with `dependencies` (absolute paths). */
+    set(dependencies: ReadonlySet<string>): void;
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=dependency-watcher.d.ts.map

package/lib/dependency-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-watcher.d.ts","sourceRoot":"","sources":["../src/dependency-watcher.ts"],"names":[],"mappings":"AAGA,OAAO,EAAS,KAAK,eAAe,EAAkB,MAAM,UAAU,CAAC;AAEvE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,MAAM,wBAAwB,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAE1E,MAAM,WAAW,wBAAwB;IACvC,mDAAmD;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,qBAAa,iBAAiB;;IAU5B,YAAY,OAAO,GAAE,wBAA6B,EAUjD;IAED,IAAI,YAAY,IAAI,WAAW,CAAC,MAAM,CAAC,CAEtC;IAED,SAAS,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,IAAI,CAGxD;IAED,oEAAoE;IACpE,GAAG,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAuB3C;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAM3B;IAEK,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3C;CAsCF"}

package/lib/dependency-watcher.js

@@ -0,0 +1,114 @@
+import { createHash } from "node:crypto";
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { watch } from "chokidar";
+/**
+ * Watches an explicit set of absolute file paths and delivers debounced
+ * batches only when their contents change. Chokidar follows editor atomic-save
+ * replacements without polling by default. The set is replaced wholesale
+ * with {@link set}, so the watcher always mirrors exactly the files the caller
+ * currently depends on.
+ */
+export class DependencyWatcher {
+    #options;
+    #listeners = new Set();
+    #watcher;
+    #dependencies = new Set();
+    #fingerprints = new Map();
+    #pending = new Set();
+    #timer;
+    #closed = false;
+    constructor(options = {}) {
+        this.#options = options;
+        this.#watcher = watch([], {
+            ...options.watch,
+            ignoreInitial: true,
+        });
+        this.#watcher.on("all", (_event, changed) => {
+            const absolute = path.resolve(this.#cwd(), changed);
+            if (this.#dependencies.has(absolute))
+                this.#queue(absolute);
+        });
+    }
+    get dependencies() {
+        return this.#dependencies;
+    }
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    }
+    /** Replace the watched set with `dependencies` (absolute paths). */
+    set(dependencies) {
+        if (this.#closed)
+            return;
+        const previous = this.#dependencies;
+        this.#dependencies = dependencies;
+        const removed = [...previous].filter((dependency) => !dependencies.has(dependency));
+        const added = [...dependencies].filter((dependency) => !previous.has(dependency));
+        if (removed.length > 0) {
+            for (const dependency of removed) {
+                this.#fingerprints.delete(dependency);
+                this.#pending.delete(dependency);
+            }
+            void this.#watcher.unwatch(removed);
+        }
+        if (added.length > 0) {
+            for (const dependency of added) {
+                this.#fingerprints.set(dependency, this.#fingerprint(dependency));
+            }
+            this.#watcher.add(added);
+        }
+    }
+    async close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        if (this.#timer !== undefined)
+            clearTimeout(this.#timer);
+        await this.#watcher.close();
+        this.#listeners.clear();
+    }
+    async [Symbol.asyncDispose]() {
+        await this.close();
+    }
+    #cwd() {
+        return this.#options.watch?.cwd ?? process.cwd();
+    }
+    #queue(changed) {
+        this.#pending.add(changed);
+        if (this.#timer !== undefined)
+            clearTimeout(this.#timer);
+        this.#timer = setTimeout(() => {
+            this.#timer = undefined;
+            const pending = this.#pending;
+            this.#pending = new Set();
+            const paths = new Set();
+            for (const dependency of pending) {
+                const previous = this.#fingerprints.get(dependency);
+                const current = this.#fingerprint(dependency);
+                if (current === previous)
+                    continue;
+                this.#fingerprints.set(dependency, current);
+                paths.add(dependency);
+            }
+            if (paths.size === 0)
+                return;
+            for (const listener of this.#listeners)
+                listener({ paths });
+        }, this.#options.debounceMs ?? 50);
+    }
+    #fingerprint(file) {
+        try {
+            return createHash("sha256")
+                .update(readFileSync(file))
+                .digest("base64url");
+        }
+        catch {
+            // Missing and unreadable are both materially different from the last
+            // successfully read contents, while repeated missing-file events fold
+            // onto the same value.
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=dependency-watcher.js.map

package/lib/dependency-watcher.js.map

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

package/lib/register-oxc.d.ts

@@ -0,0 +1,61 @@
+export interface OxcLoaderOptions {
+    /**
+     * Additional package export conditions used during module resolution.
+     * They are made available alongside Node's ambient conditions to both the
+     * TypeScript-aware resolver and Node's package exports resolver.
+     */
+    readonly conditions?: ReadonlyArray<string> | undefined;
+    /**
+     * Honour `tsconfig.json` discovered upward from each file: compiler
+     * options for the transform, `paths`/`baseUrl` aliases for resolution.
+     * @default true
+     */
+    readonly tsconfig?: boolean | undefined;
+    /** Controls which file URLs belong to the fresh import graph. */
+    readonly shouldInvalidate?: ((url: string, parentURL: string | undefined) => boolean) | undefined;
+    /**
+     * Limits transformation to matching absolute file paths; everything else
+     * loads through Node untouched. Lets a published install transpile only
+     * the user's own TypeScript while alchemy and its dependencies run their
+     * built JavaScript.
+     */
+    readonly filter?: ((path: string) => boolean) | undefined;
+    /**
+     * On-disk cache of Oxc output shared by every process on the machine, so
+     * the CLI, its dev exec child and the local-provider sidecars transpile
+     * each source file once between them rather than once each. `false`
+     * disables it, a string names the directory.
+     * @default `$ALCHEMY_TRANSFORM_CACHE` (`0` disables), else a per-user
+     * directory under the OS temp directory
+     */
+    readonly cache?: boolean | string | undefined;
+}
+export interface RegisterOxcOptions extends OxcLoaderOptions {
+    /**
+     * Isolates one import graph in the runtime's module cache: every file
+     * URL the graph resolves carries this namespace as a query parameter, so
+     * the same files import again as fresh modules under a new namespace.
+     * This is how `alchemy dev` reloads the user's stack (see
+     * `watch-import.ts`); an un-namespaced registration is the process-wide
+     * TypeScript loader.
+     */
+    readonly namespace?: string | undefined;
+    /** Called once the runtime loads a file in this registration's graph. */
+    readonly onImport?: ((url: string) => void) | undefined;
+}
+export interface OxcLoader {
+    /**
+     * Imports a file under this registration's namespace. `specifier` is a
+     * file URL, an absolute path, or a path relative to `parentURL`.
+     */
+    import<T = unknown>(specifier: string, parentURL: string): Promise<T>;
+    unregister(): void;
+}
+/**
+ * Registers synchronous Node module hooks that transpile TypeScript with
+ * Rolldown's Oxc transformer and resolve it the way TypeScript (and tsx)
+ * does. A namespaced registration also provides a scoped import whose
+ * namespace propagates through the complete ESM graph.
+ */
+export declare const registerOxc: (options?: RegisterOxcOptions) => OxcLoader;
+//# sourceMappingURL=register-oxc.d.ts.map

package/lib/register-oxc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-oxc.d.ts","sourceRoot":"","sources":["../src/register-oxc.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACxD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,iEAAiE;IACjE,QAAQ,CAAC,gBAAgB,CAAC,EACtB,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,GACzD,SAAS,CAAC;IACd;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IAC1D;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACzD;AAED,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtE,UAAU,IAAI,IAAI,CAAC;CACpB;AAkID;;;;;GAKG;AACH,eAAO,MAAM,WAAW,aAAa,kBAAkB,KAAQ,SA8H9D,CAAC"}

package/lib/register-oxc.js

@@ -0,0 +1,220 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import * as NodeModule from "node:module";
+import { registerHooks, } from "node:module";
+import { pathToFileURL } from "node:url";
+import { filePathOfUrl, isFileLikeSpecifier, isProjectPath, SpecifierResolver, splitSpecifierMetadata, } from "./resolve-specifier.js";
+import { SourceTransformer } from "./transform-source.js";
+const namespaceParameter = "alchemy-import-namespace";
+const globalRegistrationKey = Symbol.for("@alchemy.run/node-utils/register-oxc");
+const namespaceOf = (url) => {
+    if (url === undefined || !url.startsWith("file:"))
+        return undefined;
+    return new URL(url).searchParams.get(namespaceParameter) ?? undefined;
+};
+const withoutNamespace = (url) => {
+    if (!url.startsWith("file:"))
+        return url;
+    const parsed = new URL(url);
+    parsed.searchParams.delete(namespaceParameter);
+    return parsed.href;
+};
+const withNamespace = (url, namespace) => {
+    const parsed = new URL(url);
+    parsed.searchParams.set(namespaceParameter, namespace);
+    return parsed.href;
+};
+/**
+ * Node's module compile cache (`module.enableCompileCache`) keeps V8 code
+ * cache for compiled modules — transformed TypeScript included, since it is
+ * keyed by the compiled source — but Node only persists it once after the
+ * entry module evaluated and again on a clean exit. Alchemy processes load
+ * most of their graph lazily after that point (commands, the user's stack,
+ * provider layers) and usually stop on a signal, so without an explicit
+ * flush that code never reaches the cache. Flush once module loading has
+ * gone quiet; a no-op when the cache is off or this Node predates it.
+ */
+const scheduleCompileCacheFlush = (() => {
+    let timer;
+    return () => {
+        if (NodeModule.getCompileCacheDir?.() === undefined)
+            return;
+        if (timer !== undefined)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            timer = undefined;
+            NodeModule.flushCompileCache?.();
+        }, 1000);
+        timer.unref();
+    };
+})();
+/** Specifiers Node owns outright: builtins, data URLs, remote schemes. */
+const isForeignSpecifier = (specifier) => /^(?:node:|data:|[a-z][a-z\d+.-]*:\/\/)/i.test(specifier) &&
+    !specifier.startsWith("file:");
+/** A `require()` reaching the hooks: Node's CommonJS resolver wants paths, not URLs. */
+const isRequireContext = (context) => context.conditions?.includes("require") === true &&
+    !context.conditions.includes("import");
+const resolveWithCandidate = (candidate, metadata, context, nextResolve) => {
+    const specifier = isRequireContext(context)
+        ? candidate + metadata
+        : pathToFileURL(candidate).href + metadata;
+    try {
+        return nextResolve(specifier, context);
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * tsx-compatible resolution. Node's resolver decides in the end; Oxc's
+ * resolver supplies the TypeScript-aware candidate (tsconfig `paths`,
+ * `.js` → `.ts` substitution, extensionless and directory imports) that
+ * Node would not find on its own.
+ */
+const resolveSpecifier = (resolver, specifier, context, nextResolve) => {
+    if (isForeignSpecifier(specifier))
+        return nextResolve(specifier, context);
+    const parentPath = filePathOfUrl(context.parentURL);
+    const { specifier: clean, metadata } = splitSpecifierMetadata(specifier);
+    const conditions = context.conditions ?? [];
+    // TypeScript's rules apply to project code. Dependencies keep Node's plain
+    // resolution so published packages behave exactly as they would without us.
+    if (parentPath !== undefined && isProjectPath(parentPath)) {
+        const candidate = resolver.resolve(parentPath, clean, conditions);
+        if (candidate !== undefined) {
+            const resolved = resolveWithCandidate(candidate, metadata, context, nextResolve);
+            if (resolved !== undefined)
+                return resolved;
+        }
+    }
+    return nextResolve(specifier, context);
+};
+/**
+ * `import data from "./x.json"` without an import attribute is how
+ * TypeScript projects import JSON (`resolveJsonModule`); Node insists on
+ * `with { type: "json" }` for ESM. Supply it, as tsx does.
+ */
+const withJsonAttribute = (url, context) => {
+    if (!/\.json(?:[?#]|$)/.test(url) || context.importAttributes?.type) {
+        return context;
+    }
+    return {
+        ...context,
+        importAttributes: { ...context.importAttributes, type: "json" },
+    };
+};
+/**
+ * Registers synchronous Node module hooks that transpile TypeScript with
+ * Rolldown's Oxc transformer and resolve it the way TypeScript (and tsx)
+ * does. A namespaced registration also provides a scoped import whose
+ * namespace propagates through the complete ESM graph.
+ */
+export const registerOxc = (options = {}) => {
+    // One global (un-namespaced) registration per process. Alchemy starts every
+    // Node process with `--import` of a file that calls this, and in-process
+    // callers (the dev exec child, tests) may call it again; a second copy of
+    // the hooks would only re-run the resolve chain. The marker lives on
+    // globalThis because a checkout can load this module twice (src/ and lib/).
+    const globalRegistration = globalThis;
+    if (options.namespace === undefined) {
+        const existing = globalRegistration[globalRegistrationKey];
+        if (existing !== undefined)
+            return existing;
+    }
+    const transformer = new SourceTransformer(options);
+    const resolver = new SpecifierResolver({
+        tsconfig: options.tsconfig ?? true,
+    });
+    const shouldInvalidate = options.shouldInvalidate ?? (() => true);
+    // Transformed sources reference their source maps (see transform-source);
+    // Node only reads and applies them to stack traces once source-map support
+    // is on.
+    const sourceMapsWereEnabled = process.sourceMapsEnabled;
+    process.setSourceMapsEnabled(true);
+    const hooks = registerHooks({
+        resolve(specifier, context, nextResolve) {
+            // A graph's entry carries the namespace itself (see `import` below);
+            // everything it imports inherits it from the importing module's URL.
+            const namespace = options.namespace === undefined
+                ? undefined
+                : (namespaceOf(specifier) ?? namespaceOf(context.parentURL));
+            if (options.namespace !== undefined && namespace !== options.namespace) {
+                return nextResolve(specifier, context);
+            }
+            const resolutionContext = options.conditions === undefined || options.conditions.length === 0
+                ? context
+                : {
+                    ...context,
+                    conditions: [
+                        ...new Set([...options.conditions, ...context.conditions]),
+                    ],
+                };
+            const resolved = resolveSpecifier(resolver, specifier, resolutionContext, nextResolve);
+            if (namespace !== undefined &&
+                resolved.url.startsWith("file:") &&
+                shouldInvalidate(withoutNamespace(resolved.url), context.parentURL === undefined
+                    ? undefined
+                    : withoutNamespace(context.parentURL))) {
+                return { ...resolved, url: withNamespace(resolved.url, namespace) };
+            }
+            return resolved;
+        },
+        load(url, context, nextLoad) {
+            scheduleCompileCacheFlush();
+            const namespace = namespaceOf(url);
+            if (options.namespace !== undefined && namespace !== options.namespace) {
+                return nextLoad(url, context);
+            }
+            const cleanUrl = withoutNamespace(url);
+            const filePath = filePathOfUrl(cleanUrl);
+            if (filePath === undefined)
+                return nextLoad(cleanUrl, context);
+            options.onImport?.(cleanUrl);
+            if (options.filter !== undefined && !options.filter(filePath)) {
+                return nextLoad(cleanUrl, withJsonAttribute(cleanUrl, context));
+            }
+            const transformed = transformer.transform(filePath, context.format);
+            if (transformed === undefined) {
+                return nextLoad(cleanUrl, withJsonAttribute(cleanUrl, context));
+            }
+            return { ...transformed, shortCircuit: true };
+        },
+    });
+    const loader = {
+        import(specifier, parentURL) {
+            if (!isFileLikeSpecifier(specifier)) {
+                throw new Error(`Cannot import '${specifier}': expected a file URL or path.`);
+            }
+            const base = parentURL.startsWith("file:")
+                ? parentURL
+                : pathToFileURL(parentURL).href;
+            const url = specifier.startsWith("file:")
+                ? specifier
+                : new URL(specifier.startsWith(".")
+                    ? specifier
+                    : pathToFileURL(specifier).href, base).href;
+            return import(__rewriteRelativeImportExtension(options.namespace === undefined
+                ? url
+                : withNamespace(url, options.namespace)));
+        },
+        unregister() {
+            hooks.deregister();
+            if (globalRegistration[globalRegistrationKey] === loader) {
+                delete globalRegistration[globalRegistrationKey];
+            }
+            if (sourceMapsWereEnabled === false)
+                process.setSourceMapsEnabled(false);
+        },
+    };
+    if (options.namespace === undefined) {
+        globalRegistration[globalRegistrationKey] = loader;
+    }
+    return loader;
+};
+//# sourceMappingURL=register-oxc.js.map

package/lib/register-oxc.js.map

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

package/lib/resolve-specifier.d.ts

@@ -0,0 +1,46 @@
+/**
+ * TypeScript-aware specifier resolution on top of Oxc's resolver, mirroring
+ * what tsx layers over Node's resolver:
+ *
+ * - `tsconfig.json` `paths` / `baseUrl` aliases, discovered per importing file
+ * - emitted-extension substitution (`./x.js` → `x.ts`/`x.tsx`, `.mjs` → `.mts`,
+ *   `.cjs` → `.cts`, `.jsx` → `.tsx`), TypeScript source winning over an
+ *   emitted sibling
+ * - extensionless specifiers and directory indexes, TypeScript first
+ *
+ * Node's own resolver stays the authority: every candidate this class
+ * produces is handed back to Node (`nextResolve`) so it decides the format,
+ * validates package exports, and reports the canonical error.
+ */
+export interface SpecifierResolverOptions {
+    /** Discover `tsconfig.json` upward from each importing file. */
+    readonly tsconfig: boolean;
+}
+export declare const nodeModulesSegment: string;
+/** Local project code: a file path outside every `node_modules` directory. */
+export declare const isProjectPath: (filePath: string) => boolean;
+/** Whether TypeScript's extension substitution applies to this importer. */
+export declare const isTypeScriptPath: (filePath: string) => boolean;
+export declare const isFileLikeSpecifier: (specifier: string) => boolean;
+/**
+ * Splits `?query#fragment` metadata off a specifier. Bare specifiers never
+ * carry fragments in Node, so only `?` is honoured there.
+ */
+export declare const splitSpecifierMetadata: (specifier: string) => {
+    specifier: string;
+    metadata: string;
+};
+export declare const filePathOfUrl: (url: string | undefined) => string | undefined;
+export declare class SpecifierResolver {
+    #private;
+    constructor(options: SpecifierResolverOptions);
+    /**
+     * Resolves `specifier` as imported from `parentPath` to an absolute file
+     * path, or `undefined` when Oxc cannot resolve it (Node then reports the
+     * error), when it is a builtin, or when a bare specifier lands inside
+     * `node_modules` — packages are Node's business, only `paths` aliases
+     * that map onto project files are ours.
+     */
+    resolve(parentPath: string, specifier: string, conditions: ReadonlyArray<string>): string | undefined;
+}
+//# sourceMappingURL=resolve-specifier.d.ts.map

package/lib/resolve-specifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-specifier.d.ts","sourceRoot":"","sources":["../src/resolve-specifier.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,kBAAkB,QAAuC,CAAC;AAEvE,8EAA8E;AAC9E,eAAO,MAAM,aAAa,aAAc,MAAM,YACN,CAAC;AAIzC,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,aAAc,MAAM,YACZ,CAAC;AAEtC,eAAO,MAAM,mBAAmB,cAAe,MAAM,YAMzB,CAAC;AAE7B;;;GAGG;AACH,eAAO,MAAM,sBAAsB,cAAe,MAAM;;;CAUvD,CAAC;AAEF,eAAO,MAAM,aAAa,QAAS,MAAM,GAAG,SAAS,uBAOpD,CAAC;AAEF,qBAAa,iBAAiB;;IAK5B,YAAY,OAAO,EAAE,wBAAwB,EA6B5C;IAuBD;;;;;;OAMG;IACH,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,GAChC,MAAM,GAAG,SAAS,CAmBpB;CACF"}