@chee/patchwork-bundles 0.1.0 → 0.2.0

package/dist/esbuild.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (options?: import("./types.js").PatchworkBundleOptions | undefined) => import("esbuild").Plugin;
+export default _default;
+//# sourceMappingURL=esbuild.d.ts.map

package/dist/esbuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.d.ts","sourceRoot":"","sources":["../src/esbuild.ts"],"names":[],"mappings":";AACA,wBAAwC"}

package/{src/esbuild.ts → dist/esbuild.js}

@@ -1,2 +1,3 @@
 import { patchworkBundles } from "./index.js";
 export default patchworkBundles.esbuild;
+//# sourceMappingURL=esbuild.js.map

package/dist/esbuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.js","sourceRoot":"","sources":["../src/esbuild.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,eAAe,gBAAgB,CAAC,OAAO,CAAC"}

package/dist/farm.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (options?: import("./types.js").PatchworkBundleOptions | undefined) => JsPlugin;
+export default _default;
+//# sourceMappingURL=farm.d.ts.map

package/dist/farm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"farm.d.ts","sourceRoot":"","sources":["../src/farm.ts"],"names":[],"mappings":";AACA,wBAAqC"}

package/{src/farm.ts → dist/farm.js}

@@ -1,2 +1,3 @@
 import { patchworkBundles } from "./index.js";
 export default patchworkBundles.farm;
+//# sourceMappingURL=farm.js.map

package/dist/farm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"farm.js","sourceRoot":"","sources":["../src/farm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,eAAe,gBAAgB,CAAC,IAAI,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { type PatchworkBundleOptions } from "./types.js";
+export declare const patchworkBundles: import("unplugin").UnpluginInstance<PatchworkBundleOptions | undefined, boolean>;
+export default patchworkBundles;
+export type { PatchworkBundleOptions } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAkB,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAUzE,eAAO,MAAM,gBAAgB,kFA0G5B,CAAC;AAEF,eAAe,gBAAgB,CAAC;AAChC,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,98 @@
+import { createUnplugin } from "unplugin";
+import { resolve } from "node:path";
+import { readPackageJson, parseBareSpecifier, isBareSpecifier, resolveDepEntryPoint, collectModuleExports, ensureLexer, } from "./utils.js";
+import { getImportableUrlFromAutomergeUrl } from "@inkandswitch/patchwork-filesystem";
+import externals from "@inkandswitch/patchwork-bootloader/externals";
+import { resolveOptions } from "./types.js";
+// Prefix marking a virtual module we generate for
+// `rewrite.automerge: "patchwork:cross-origin"`. The rest of the id is the
+// original bare specifier. The leading NUL keeps other tooling from treating it
+// as a real file path.
+const CROSS_ORIGIN_PREFIX = "\0patchwork-bundle-cross-origin:";
+const VALID_IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+export const patchworkBundles = createUnplugin((rawOptions) => {
+    const options = resolveOptions(rawOptions);
+    let deps;
+    return {
+        name: "patchwork-bundles",
+        enforce: "pre",
+        async buildStart() {
+            const pkgPath = resolve(process.cwd(), options.packageJsonPath);
+            const pkgJson = readPackageJson(pkgPath);
+            deps = pkgJson.dependencies ?? {};
+            if (options.rewrite.automerge === "patchwork:cross-origin") {
+                await ensureLexer();
+            }
+        },
+        resolveId(id) {
+            // Virtual modules we emitted below are handled in load().
+            if (id.startsWith(CROSS_ORIGIN_PREFIX))
+                return id;
+            if (!isBareSpecifier(id))
+                return undefined;
+            // Bootloader externals — always external (served via importmap)
+            if (externals.includes(id)) {
+                return { id, external: true };
+            }
+            const { pkgName, subpath } = parseBareSpecifier(id);
+            if (pkgName !== id && externals.includes(pkgName)) {
+                return { id, external: true };
+            }
+            const version = deps[pkgName];
+            if (!version)
+                return undefined;
+            // Automerge deps — rewrite to service worker URLs
+            if (version.startsWith("automerge:")) {
+                if (options.rewrite.automerge === "patchwork") {
+                    const entryPoint = resolveDepEntryPoint(pkgName, subpath);
+                    const url = getImportableUrlFromAutomergeUrl(version, entryPoint);
+                    return { id: url, external: true };
+                }
+                // Cross-origin mode: defer URL construction to the browser so the
+                // service-worker path resolves against the *running document's*
+                // origin, not the (possibly cross-origin) module's. Emit a virtual
+                // re-export module; the code is generated in load().
+                if (options.rewrite.automerge === "patchwork:cross-origin") {
+                    return CROSS_ORIGIN_PREFIX + id;
+                }
+                return undefined;
+            }
+            // npm fallback — optionally rewrite to esm.sh
+            if (options.rewrite.npm === "esm.sh") {
+                const cleanVersion = version.replace(/^[\^~>=<\s]+/, "");
+                const esmId = subpath === "." ? pkgName : id;
+                return {
+                    id: `https://esm.sh/${esmId}@${cleanVersion}`,
+                    external: true,
+                };
+            }
+            return undefined;
+        },
+        load(id) {
+            if (!id.startsWith(CROSS_ORIGIN_PREFIX))
+                return undefined;
+            const spec = id.slice(CROSS_ORIGIN_PREFIX.length);
+            const { pkgName, subpath } = parseBareSpecifier(spec);
+            const version = deps[pkgName];
+            const entryPoint = resolveDepEntryPoint(pkgName, subpath);
+            // Enumerate the dep's named exports so the virtual module can re-export
+            // the same shape. Read the installed copy in node_modules — assumed to
+            // match the automerge doc the service worker serves.
+            const entryFile = resolve(process.cwd(), "node_modules", pkgName, entryPoint);
+            const exportNames = collectModuleExports(entryFile);
+            const hasDefault = exportNames.delete("default");
+            const named = [...exportNames].filter((n) => VALID_IDENT.test(n));
+            const lines = [
+                `import { getImportableUrlFromAutomergeUrl as __pwResolve } from "@inkandswitch/patchwork-filesystem";`,
+                `const __pwUrl = __pwResolve(${JSON.stringify(version)}, ${JSON.stringify(entryPoint)});`,
+                `const __pwMod = await import(/* @vite-ignore */ __pwUrl);`,
+                ...named.map((n) => `export const ${n} = __pwMod[${JSON.stringify(n)}];`),
+            ];
+            if (hasDefault)
+                lines.push(`export default __pwMod.default;`);
+            return { code: lines.join("\n"), moduleSideEffects: true };
+        },
+    };
+});
+export default patchworkBundles;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/rollup.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (options?: import("./types.js").PatchworkBundleOptions | undefined) => import("rollup").Plugin<any> | import("rollup").Plugin<any>[];
+export default _default;
+//# sourceMappingURL=rollup.d.ts.map

package/dist/rollup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup.d.ts","sourceRoot":"","sources":["../src/rollup.ts"],"names":[],"mappings":";AACA,wBAAuC"}

package/{src/rollup.ts → dist/rollup.js}

@@ -1,2 +1,3 @@
 import { patchworkBundles } from "./index.js";
 export default patchworkBundles.rollup;
+//# sourceMappingURL=rollup.js.map

package/dist/rollup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup.js","sourceRoot":"","sources":["../src/rollup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,eAAe,gBAAgB,CAAC,MAAM,CAAC"}

package/dist/rspack.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (options?: import("./types.js").PatchworkBundleOptions | undefined) => RspackPluginInstance;
+export default _default;
+//# sourceMappingURL=rspack.d.ts.map

package/dist/rspack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rspack.d.ts","sourceRoot":"","sources":["../src/rspack.ts"],"names":[],"mappings":";AACA,wBAAuC"}

package/{src/rspack.ts → dist/rspack.js}

@@ -1,2 +1,3 @@
 import { patchworkBundles } from "./index.js";
 export default patchworkBundles.rspack;
+//# sourceMappingURL=rspack.js.map

package/dist/rspack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rspack.js","sourceRoot":"","sources":["../src/rspack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,eAAe,gBAAgB,CAAC,MAAM,CAAC"}

package/dist/test/integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=integration.test.d.ts.map

package/dist/test/integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.test.d.ts","sourceRoot":"","sources":["../../src/test/integration.test.ts"],"names":[],"mappings":""}

package/dist/test/integration.test.js

@@ -0,0 +1,172 @@
+import { describe, it, expect, beforeAll, afterAll } from "vitest";
+import * as fs from "node:fs/promises";
+import * as os from "node:os";
+import * as path from "node:path";
+import { execSync } from "node:child_process";
+import { build as viteBuild } from "vite";
+import * as esbuild from "esbuild";
+const AUTOMERGE_URL = "automerge:kFcrzeDmr5zXE1jShvxUPsoToAN";
+const ENCODED_URL = encodeURIComponent(AUTOMERGE_URL);
+describe("patchwork-bundles integration", () => {
+    let tmpDir;
+    let originalCwd;
+    beforeAll(async () => {
+        originalCwd = process.cwd();
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "patchwork-bundles-test-"));
+        // Phase 1: set up project with pnpm-plugin-patchwork as a configDependency
+        await fs.writeFile(path.join(tmpDir, "package.json"), JSON.stringify({
+            name: "test-patchwork-bundles",
+            version: "0.0.0",
+            type: "module",
+            dependencies: {
+                "my-sideboard-tool": AUTOMERGE_URL,
+                "solid-js": "^1.9.9",
+            },
+        }, null, 2));
+        // stub workspace packages that the automerge doc depends on via workspace:^
+        const bootloaderDir = path.join(tmpDir, "packages/patchwork-bootloader");
+        await fs.mkdir(bootloaderDir, { recursive: true });
+        await fs.writeFile(path.join(bootloaderDir, "package.json"), JSON.stringify({
+            name: "@inkandswitch/patchwork-bootloader",
+            version: "0.0.1",
+            type: "module",
+            exports: { "./externals": { import: "./externals.js" } },
+        }));
+        await fs.writeFile(path.join(bootloaderDir, "externals.js"), `const externals = [\n  "solid-js",\n  "solid-js/web",\n  "solid-js/html",\n  "solid-js/store",\n  "solid-js/jsx-runtime",\n  "solid-js/h"\n];\nexport default externals;\n`);
+        const elementsDir = path.join(tmpDir, "packages/patchwork-elements");
+        await fs.mkdir(elementsDir, { recursive: true });
+        await fs.writeFile(path.join(elementsDir, "package.json"), JSON.stringify({
+            name: "@inkandswitch/patchwork-elements",
+            version: "0.0.1",
+            type: "module",
+        }));
+        await fs.writeFile(path.join(tmpDir, "pnpm-workspace.yaml"), [
+            "packages:",
+            '  - "packages/*"',
+            "configDependencies:",
+            '  pnpm-plugin-patchwork: "0.1.0"',
+            "",
+        ].join("\n"));
+        // .npmrc — avoid strict peer deps issues
+        await fs.writeFile(path.join(tmpDir, ".npmrc"), "strict-peer-dependencies=false\nauto-install-peers=true\n");
+        // install — plugin resolves automerge: deps automatically
+        // filter out parent pnpm's npm_config_* env vars to avoid contamination
+        const cleanEnv = Object.fromEntries(Object.entries(process.env).filter(([k]) => !k.startsWith("npm_")));
+        execSync("npx pnpm@next-11 install --no-frozen-lockfile", {
+            cwd: tmpDir,
+            stdio: "pipe",
+            timeout: 120_000,
+            env: {
+                ...cleanEnv,
+                PATCHWORK_SYNC_SERVER: "wss://sync3.automerge.org",
+            },
+        });
+        // Phase 2: write source file
+        const srcDir = path.join(tmpDir, "src");
+        await fs.mkdir(srcDir, { recursive: true });
+        await fs.writeFile(path.join(srcDir, "index.ts"), [
+            `import { createSignal } from "solid-js";`,
+            `import * as sideboard from "my-sideboard-tool";`,
+            `console.log(createSignal, sideboard);`,
+            "",
+        ].join("\n"));
+        process.chdir(tmpDir);
+    }, 180_000);
+    afterAll(async () => {
+        process.chdir(originalCwd);
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    describe("pnpm plugin installed my-sideboard-tool from automerge", () => {
+        it("has a package.json with the sideboard package name", async () => {
+            const pkgPath = path.join(tmpDir, "node_modules/my-sideboard-tool/package.json");
+            const pkg = JSON.parse(await fs.readFile(pkgPath, "utf-8"));
+            expect(pkg.name).toBe("@chee/patchwork-sideboard");
+        });
+        it("has an exports field with a patchwork condition", async () => {
+            const pkgPath = path.join(tmpDir, "node_modules/my-sideboard-tool/package.json");
+            const pkg = JSON.parse(await fs.readFile(pkgPath, "utf-8"));
+            expect(pkg.exports).toBeDefined();
+            expect(pkg.exports["."]).toBeDefined();
+            expect(pkg.exports["."].patchwork).toBeDefined();
+        });
+        it("contains actual dist files from the automerge document", async () => {
+            const distDir = path.join(tmpDir, "node_modules/my-sideboard-tool/dist");
+            const files = await fs.readdir(distDir);
+            expect(files.length).toBeGreaterThan(0);
+            // should have js output
+            expect(files.some((f) => f.endsWith(".js"))).toBe(true);
+        });
+    });
+    describe("vite build", () => {
+        let output;
+        beforeAll(async () => {
+            // Determine what entry point the plugin will resolve to
+            const pluginPath = path.resolve(originalCwd, "dist/vite.js");
+            const { default: vitePlugin } = await import(pluginPath);
+            const result = await viteBuild({
+                root: tmpDir,
+                logLevel: "silent",
+                build: {
+                    lib: {
+                        entry: path.join(tmpDir, "src/index.ts"),
+                        formats: ["es"],
+                        fileName: "index",
+                    },
+                    outDir: path.join(tmpDir, "dist-vite"),
+                    write: true,
+                    minify: false,
+                },
+                plugins: [vitePlugin()],
+            });
+            // vite 7 outputs .js, older versions output .mjs
+            const mjs = path.join(tmpDir, "dist-vite/index.mjs");
+            const js = path.join(tmpDir, "dist-vite/index.js");
+            output = await fs.readFile(await fs.access(mjs).then(() => mjs, () => js), "utf-8");
+        }, 60_000);
+        it("rewrites automerge dep to service-worker URL", () => {
+            expect(output).toContain(ENCODED_URL);
+            // Should be an import from /<encoded-url>/...
+            expect(output).toMatch(new RegExp(`from ["']/${ENCODED_URL}/`));
+        });
+        it("externalizes solid-js", () => {
+            expect(output).toMatch(/from ["']solid-js["']/);
+            // if solid-js were inlined, the output would be thousands of lines
+            const lines = output.split("\n").length;
+            expect(lines).toBeLessThan(20);
+        });
+        it("does not contain bundled automerge dep code", () => {
+            // The automerge dep should be external, not inlined
+            expect(output).not.toContain("my-sideboard-tool");
+        });
+    });
+    describe("esbuild build", () => {
+        let output;
+        beforeAll(async () => {
+            const pluginPath = path.resolve(originalCwd, "dist/esbuild.js");
+            const { default: esbuildPlugin } = await import(pluginPath);
+            await esbuild.build({
+                entryPoints: [path.join(tmpDir, "src/index.ts")],
+                bundle: true,
+                format: "esm",
+                outfile: path.join(tmpDir, "dist-esbuild/index.js"),
+                plugins: [esbuildPlugin()],
+                logLevel: "silent",
+            });
+            output = await fs.readFile(path.join(tmpDir, "dist-esbuild/index.js"), "utf-8");
+        }, 60_000);
+        it("rewrites automerge dep to service-worker URL", () => {
+            expect(output).toContain(ENCODED_URL);
+            expect(output).toMatch(new RegExp(`from ["']/${ENCODED_URL}/`));
+        });
+        it("externalizes solid-js", () => {
+            expect(output).toMatch(/from ["']solid-js["']/);
+            // if solid-js were inlined, the output would be thousands of lines
+            const lines = output.split("\n").length;
+            expect(lines).toBeLessThan(20);
+        });
+        it("does not contain bundled automerge dep code", () => {
+            expect(output).not.toContain("my-sideboard-tool");
+        });
+    });
+});
+//# sourceMappingURL=integration.test.js.map

package/dist/test/integration.test.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,41 @@
+export interface PatchworkBundleOptions {
+    /** Path to the project's package.json. Default: "./package.json" relative to cwd */
+    packageJsonPath?: string;
+    rewrite?: {
+        /**
+         * How to handle dependencies with `automerge:` version specifiers.
+         * - `"patchwork"` (default): rewrite bare imports to *root-relative*
+         *   service-worker URLs (`/{encodeURIComponent("automerge:docid")}/resolved/entry.js`),
+         *   resolving through the dep's package.json exports with the `"patchwork"` condition.
+         *   The leading `/` resolves against the *importing module's* origin, so this
+         *   only works when the tool is served same-origin as the patchwork service
+         *   worker. A tool served from a different origin (e.g. a separate static
+         *   host) will 404 on these imports.
+         * - `"patchwork:cross-origin"`: rewrite bare imports to a virtual module
+         *   that resolves the URL *at runtime* via `getImportableUrlFromAutomergeUrl`
+         *   and dynamically imports it, re-exporting the dep's named exports
+         *   (top-level await). This resolves against the running document's origin
+         *   instead of the module's, so it works even when the tool is loaded
+         *   cross-origin from where the service worker lives. Requires a build
+         *   target that supports top-level await (e.g. `es2022`/`esnext`).
+         * - `"bundle"`: include the dependency code in the bundle normally.
+         */
+        automerge?: "patchwork" | "patchwork:cross-origin" | "bundle";
+        /**
+         * How to handle npm dependencies (deps that aren't `automerge:` URLs
+         * and aren't in the bootloader externals list).
+         * - `"bundle"` (default): bundle them normally.
+         * - `"esm.sh"`: rewrite to `https://esm.sh/<pkg>@<version>` external URLs.
+         */
+        npm?: "esm.sh" | "bundle";
+    };
+}
+export interface ResolvedOptions {
+    packageJsonPath: string;
+    rewrite: {
+        automerge: "patchwork" | "patchwork:cross-origin" | "bundle";
+        npm: "esm.sh" | "bundle";
+    };
+}
+export declare function resolveOptions(raw?: PatchworkBundleOptions): ResolvedOptions;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,oFAAoF;IACpF,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,EAAE;QACR;;;;;;;;;;;;;;;;;WAiBG;QACH,SAAS,CAAC,EAAE,WAAW,GAAG,wBAAwB,GAAG,QAAQ,CAAC;QAE9D;;;;;WAKG;QACH,GAAG,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE;QACP,SAAS,EAAE,WAAW,GAAG,wBAAwB,GAAG,QAAQ,CAAC;QAC7D,GAAG,EAAE,QAAQ,GAAG,QAAQ,CAAC;KAC1B,CAAC;CACH;AAED,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,sBAAsB,GAAG,eAAe,CAQ5E"}

package/dist/types.js

@@ -0,0 +1,10 @@
+export function resolveOptions(raw) {
+    return {
+        packageJsonPath: raw?.packageJsonPath ?? "./package.json",
+        rewrite: {
+            automerge: raw?.rewrite?.automerge ?? "patchwork",
+            npm: raw?.rewrite?.npm ?? "bundle",
+        },
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA2CA,MAAM,UAAU,cAAc,CAAC,GAA4B;IACzD,OAAO;QACL,eAAe,EAAE,GAAG,EAAE,eAAe,IAAI,gBAAgB;QACzD,OAAO,EAAE;YACP,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,IAAI,WAAW;YACjD,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,QAAQ;SACnC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Read and parse a package.json file.
+ */
+export declare function readPackageJson(path: string): Record<string, any>;
+/**
+ * Parse a bare import specifier into package name and subpath.
+ *
+ * - `"abc"` → `{ pkgName: "abc", subpath: "." }`
+ * - `"abc/utils"` → `{ pkgName: "abc", subpath: "./utils" }`
+ * - `"@scope/pkg"` → `{ pkgName: "@scope/pkg", subpath: "." }`
+ * - `"@scope/pkg/utils"` → `{ pkgName: "@scope/pkg", subpath: "./utils" }`
+ */
+export declare function parseBareSpecifier(id: string): {
+    pkgName: string;
+    subpath: string;
+};
+/**
+ * Returns true if the specifier is a bare import (not relative, absolute,
+ * or a protocol URL).
+ */
+export declare function isBareSpecifier(id: string): boolean;
+/**
+ * Resolve a dependency's entry point by reading its package.json from
+ * `node_modules/` and resolving through its `exports` field.
+ *
+ * Returns the resolved path relative to the package root (e.g. `"./dist/index.js"`),
+ * or the subpath itself if resolution fails.
+ */
+export declare function resolveDepEntryPoint(pkgName: string, subpath?: string, conditions?: string[]): string;
+/**
+ * Enumerate the *named* exports of an ES module file, following relative
+ * `export * from "./x"` re-exports one dependency at a time. Used to generate a
+ * runtime-resolved virtual module that re-exports the same names as the real
+ * module. `"default"` is included in the returned set if the module has a
+ * default export.
+ *
+ * es-module-lexer must be initialised first (see {@link ensureLexer}).
+ */
+export declare function collectModuleExports(entryPath: string, seen?: Set<string>): Set<string>;
+/** Initialise es-module-lexer's WASM once; safe to await repeatedly. */
+export declare function ensureLexer(): Promise<void>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAEjE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAuBA;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAY,EACrB,UAAU,GAAE,MAAM,EAAuC,GACxD,MAAM,CAwBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAC5B,GAAG,CAAC,MAAM,CAAC,CAiCb;AAmBD,wEAAwE;AACxE,wBAAgB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3C"}

package/dist/utils.js

@@ -0,0 +1,141 @@
+import { readFileSync, existsSync } from "node:fs";
+import { resolve as resolvePath, dirname } from "node:path";
+import { resolve as resolveExports } from "resolve.exports";
+import { init as initLexer, parse as parseModule } from "es-module-lexer";
+/**
+ * Read and parse a package.json file.
+ */
+export function readPackageJson(path) {
+    return JSON.parse(readFileSync(path, "utf-8"));
+}
+/**
+ * Parse a bare import specifier into package name and subpath.
+ *
+ * - `"abc"` → `{ pkgName: "abc", subpath: "." }`
+ * - `"abc/utils"` → `{ pkgName: "abc", subpath: "./utils" }`
+ * - `"@scope/pkg"` → `{ pkgName: "@scope/pkg", subpath: "." }`
+ * - `"@scope/pkg/utils"` → `{ pkgName: "@scope/pkg", subpath: "./utils" }`
+ */
+export function parseBareSpecifier(id) {
+    const firstSlash = id.indexOf("/");
+    const isScoped = id.startsWith("@");
+    if (isScoped) {
+        const secondSlash = id.indexOf("/", firstSlash + 1);
+        if (secondSlash === -1) {
+            return { pkgName: id, subpath: "." };
+        }
+        return {
+            pkgName: id.slice(0, secondSlash),
+            subpath: "./" + id.slice(secondSlash + 1),
+        };
+    }
+    if (firstSlash === -1) {
+        return { pkgName: id, subpath: "." };
+    }
+    return {
+        pkgName: id.slice(0, firstSlash),
+        subpath: "./" + id.slice(firstSlash + 1),
+    };
+}
+/**
+ * Returns true if the specifier is a bare import (not relative, absolute,
+ * or a protocol URL).
+ */
+export function isBareSpecifier(id) {
+    return (id.length > 0 &&
+        !id.startsWith(".") &&
+        !id.startsWith("/") &&
+        !id.includes(":"));
+}
+/**
+ * Resolve a dependency's entry point by reading its package.json from
+ * `node_modules/` and resolving through its `exports` field.
+ *
+ * Returns the resolved path relative to the package root (e.g. `"./dist/index.js"`),
+ * or the subpath itself if resolution fails.
+ */
+export function resolveDepEntryPoint(pkgName, subpath = ".", conditions = ["patchwork", "browser", "import"]) {
+    try {
+        const depPkgJsonPath = resolvePath(process.cwd(), "node_modules", pkgName, "package.json");
+        const depPkgJson = readPackageJson(depPkgJsonPath);
+        const resolved = resolveExports(depPkgJson, subpath, { conditions });
+        if (resolved && resolved[0]) {
+            return resolved[0];
+        }
+        // Fallback to "main" for root export
+        if (subpath === "." && typeof depPkgJson.main === "string") {
+            return depPkgJson.main;
+        }
+    }
+    catch {
+        // If we can't read the dep's package.json, just pass through the subpath
+    }
+    return subpath;
+}
+/**
+ * Enumerate the *named* exports of an ES module file, following relative
+ * `export * from "./x"` re-exports one dependency at a time. Used to generate a
+ * runtime-resolved virtual module that re-exports the same names as the real
+ * module. `"default"` is included in the returned set if the module has a
+ * default export.
+ *
+ * es-module-lexer must be initialised first (see {@link ensureLexer}).
+ */
+export function collectModuleExports(entryPath, seen = new Set()) {
+    const names = new Set();
+    if (seen.has(entryPath) || !existsSync(entryPath))
+        return names;
+    seen.add(entryPath);
+    let source;
+    try {
+        source = readFileSync(entryPath, "utf-8");
+    }
+    catch {
+        return names;
+    }
+    const [imports, exports] = parseModule(source);
+    for (const e of exports) {
+        if (e.n)
+            names.add(e.n);
+    }
+    // `export * from "./rel"` contributes names that aren't listed inline. Those
+    // re-exports show up in `imports`; detect them by the statement text and
+    // recurse into relative targets.
+    for (const imp of imports) {
+        const spec = imp.n;
+        if (!spec || !spec.startsWith("."))
+            continue;
+        const stmt = source.slice(imp.ss, imp.se);
+        if (!/^export\s*\*/.test(stmt))
+            continue;
+        const target = resolveRelativeModule(dirname(entryPath), spec);
+        if (!target)
+            continue;
+        for (const n of collectModuleExports(target, seen)) {
+            if (n !== "default")
+                names.add(n); // `export *` never re-exports default
+        }
+    }
+    return names;
+}
+/**
+ * Resolve a relative module specifier to an existing file, trying the literal
+ * path and common JS extensions / index files.
+ */
+function resolveRelativeModule(fromDir, spec) {
+    const base = resolvePath(fromDir, spec);
+    const candidates = [
+        base,
+        `${base}.js`,
+        `${base}.mjs`,
+        resolvePath(base, "index.js"),
+        resolvePath(base, "index.mjs"),
+    ];
+    return candidates.find((c) => existsSync(c)) ?? null;
+}
+let lexerReady;
+/** Initialise es-module-lexer's WASM once; safe to await repeatedly. */
+export function ensureLexer() {
+    return (lexerReady ??= initLexer);
+}
+//# sourceMappingURL=utils.js.map