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

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/import-loader.d.ts

@@ -0,0 +1,54 @@
+import type { TransformOptions } from "rolldown/utils";
+export interface TransformContext {
+    readonly url: string;
+    readonly path: string;
+    readonly format: "module" | "commonjs";
+}
+export interface SourceTransformResult {
+    readonly code: string;
+    readonly map?: string | object | undefined;
+}
+export type SourceTransform = (code: string, context: TransformContext) => string | SourceTransformResult | undefined;
+export interface ImportLoaderOptions {
+    /**
+     * 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;
+    /**
+     * Oxc transform configuration, layered over the nearest `tsconfig.json`
+     * of each transformed file (`jsx`, decorators, …).
+     */
+    readonly transform?: TransformOptions | undefined;
+    /** Additional synchronous source transforms, applied after Oxc. */
+    readonly transforms?: ReadonlyArray<SourceTransform> | 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;
+}
+export interface ImportLoaderRegistrationOptions extends ImportLoaderOptions {
+    /** Isolates one import graph in the runtime's module cache. */
+    readonly namespace?: string | undefined;
+    /** Called once the runtime loads a file in this registration's graph. */
+    readonly onImport?: ((url: string) => void) | undefined;
+}
+export interface ImportLoader {
+    import<T = unknown>(specifier: string, parentURL: string): Promise<T>;
+    unregister(): void | Promise<void>;
+}
+/** Creates a Node import loader using synchronous module hooks backed by Oxc. */
+export declare const createImportLoader: (options?: ImportLoaderRegistrationOptions) => Promise<ImportLoader>;
+//# sourceMappingURL=import-loader.d.ts.map

package/lib/import-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-loader.d.ts","sourceRoot":"","sources":["../src/import-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;CACxC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC5C;AAED,MAAM,MAAM,eAAe,GAAG,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,KACtB,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAAC;AAEhD,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACxD;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAClD,mEAAmE;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,GAAG,SAAS,CAAC;IACjE;;;;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;CAC3D;AAED,MAAM,WAAW,+BAAgC,SAAQ,mBAAmB;IAC1E,+DAA+D;IAC/D,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,YAAY;IAC3B,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtE,UAAU,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,aACpB,+BAA+B,KACvC,OAAO,CAAC,YAAY,CAQtB,CAAC"}

package/lib/import-loader.js

@@ -0,0 +1,9 @@
+/** Creates a Node import loader using synchronous module hooks backed by Oxc. */
+export const createImportLoader = async (options = {}) => {
+    if (process.versions.bun !== undefined) {
+        throw new Error("The import-aware loader is only available in Node; use Bun's process-level watcher instead.");
+    }
+    const { registerOxc } = await import("./register-oxc.js");
+    return registerOxc(options);
+};
+//# sourceMappingURL=import-loader.js.map

package/lib/import-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-loader.js","sourceRoot":"","sources":["../src/import-loader.ts"],"names":[],"mappings":"AA+DA,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACrC,OAAO,GAAoC,EAAE,EACtB,EAAE;IACzB,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC1D,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC,CAAC"}

package/lib/register-oxc.d.ts

@@ -0,0 +1,16 @@
+import type { ImportLoader, ImportLoaderRegistrationOptions } from "./import-loader.ts";
+export type { ImportLoader as RegisteredOxcImporter, ImportLoaderRegistrationOptions as RegisterOxcOptions, SourceTransform, SourceTransformResult, TransformContext, } from "./import-loader.ts";
+/**
+ * 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?: ImportLoaderRegistrationOptions) => ImportLoader;
+/**
+ * One-shot TypeScript import that leaves the rest of the runtime untouched:
+ * a private namespace is registered for the call, so nothing is shared with
+ * other imports of the same files. Mirrors tsx's `tsImport`.
+ */
+export declare const tsImport: <T = unknown>(specifier: string, parentURL: string, options?: Omit<ImportLoaderRegistrationOptions, "namespace">) => Promise<T>;
+//# 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":"AASA,OAAO,KAAK,EACV,YAAY,EACZ,+BAA+B,EAChC,MAAM,oBAAoB,CAAC;AAU5B,YAAY,EACV,YAAY,IAAI,qBAAqB,EACrC,+BAA+B,IAAI,kBAAkB,EACrD,eAAe,EACf,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAwK5B;;;;;GAKG;AACH,eAAO,MAAM,WAAW,aACb,+BAA+B,KACvC,YAuHF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAU,CAAC,GAAG,OAAO,aAC7B,MAAM,aACN,MAAM,YACR,IAAI,CAAC,+BAA+B,EAAE,WAAW,CAAC,KAC1D,OAAO,CAAC,CAAC,CAOX,CAAC"}

package/lib/register-oxc.js

@@ -0,0 +1,257 @@
+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 { randomUUID } from "node:crypto";
+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 protocol = "alchemy-import:";
+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;
+};
+const parseRequest = (specifier) => {
+    if (!specifier.startsWith(protocol))
+        return undefined;
+    return JSON.parse(decodeURIComponent(specifier.slice(protocol.length)));
+};
+/** 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:");
+const notFoundCodes = new Set([
+    "ERR_MODULE_NOT_FOUND",
+    "MODULE_NOT_FOUND",
+    "ERR_UNSUPPORTED_DIR_IMPORT",
+    "ERR_PACKAGE_PATH_NOT_EXPORTED",
+]);
+const isNotFound = (error) => error instanceof Error &&
+    notFoundCodes.has(error.code ?? "");
+/**
+ * The file Node could not find, from the error it raised. Node names the
+ * resolved target (`url` on ESM errors, the message on CommonJS ones) —
+ * for a package `exports` entry pointing at emitted JavaScript that was
+ * never built, that is the `.js` path whose `.ts` source we can substitute.
+ */
+const missingPathOf = (error) => {
+    if (error.url !== undefined)
+        return filePathOfUrl(error.url);
+    const match = error.message.match(/^Cannot find module '([^']+)'/);
+    if (match === null)
+        return undefined;
+    const [, target] = match;
+    if (target === undefined)
+        return undefined;
+    if (target.startsWith("file:"))
+        return filePathOfUrl(target);
+    return target.startsWith("/") || /^[a-zA-Z]:[\\/]/.test(target)
+        ? target
+        : undefined;
+};
+/** 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;
+        }
+    }
+    try {
+        return nextResolve(specifier, context);
+    }
+    catch (error) {
+        if (!isNotFound(error))
+            throw error;
+        // A package `exports`/`main` target naming emitted JavaScript that only
+        // exists as TypeScript source (workspace packages in a checkout).
+        const missing = missingPathOf(error);
+        if (missing !== undefined && isFileLikeSpecifier(missing)) {
+            const candidate = resolver.resolveMissing(missing, conditions);
+            if (candidate !== undefined && candidate !== missing) {
+                const resolved = resolveWithCandidate(candidate, metadata, context, nextResolve);
+                if (resolved !== undefined)
+                    return resolved;
+            }
+        }
+        throw error;
+    }
+};
+/**
+ * `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 carry inline source maps; Node only 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) {
+            const request = parseRequest(specifier);
+            const inheritedNamespace = namespaceOf(context.parentURL);
+            const namespace = options.namespace === undefined
+                ? undefined
+                : (request?.namespace ?? inheritedNamespace);
+            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 = request
+                ? resolveSpecifier(resolver, request.specifier, { ...resolutionContext, parentURL: request.parentURL }, nextResolve)
+                : 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) {
+            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, cleanUrl, context.format);
+            if (transformed === undefined) {
+                return nextLoad(cleanUrl, withJsonAttribute(cleanUrl, context));
+            }
+            return { ...transformed, shortCircuit: true };
+        },
+    });
+    const loader = {
+        import(specifier, parentURL) {
+            const request = {
+                namespace: options.namespace,
+                parentURL: parentURL.startsWith("file:")
+                    ? parentURL
+                    : pathToFileURL(parentURL).href,
+                specifier,
+            };
+            return import(__rewriteRelativeImportExtension(`${protocol}${encodeURIComponent(JSON.stringify(request))}`));
+        },
+        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;
+};
+/**
+ * One-shot TypeScript import that leaves the rest of the runtime untouched:
+ * a private namespace is registered for the call, so nothing is shared with
+ * other imports of the same files. Mirrors tsx's `tsImport`.
+ */
+export const tsImport = async (specifier, parentURL, options = {}) => {
+    const loader = registerOxc({ ...options, namespace: randomUUID() });
+    try {
+        return await loader.import(specifier, parentURL);
+    }
+    finally {
+        await loader.unregister();
+    }
+};
+//# 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,52 @@
+/**
+ * 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;
+    /**
+     * Given a file path Node failed to find (typically an `exports`/`main`
+     * target that names emitted JavaScript that was never built), finds the
+     * TypeScript source it was emitted from via extension substitution.
+     */
+    resolveMissing(missingPath: 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;IAED;;;;OAIG;IACH,cAAc,CACZ,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,GAChC,MAAM,GAAG,SAAS,CAYpB;CACF"}