@statewalker/webrun-bundler 0.0.0-stage → 0.1.1

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["toBase64","resolvePackageExports","resolveImports"],"sources":["../src/paths.ts","../src/input-maps.ts","../src/packages.ts","../src/resolve.ts","../src/bundle.ts"],"sourcesContent":["import { normalizePath, tryReadText } from \"@statewalker/webrun-files\";\nimport type { Mount, PackageManifest } from \"./types.js\";\n\n/** `path` joined to `dir`, with `.` and `..` resolved; `undefined` when it leaves `root`. */\nexport function joinWithin(root: string, dir: string, path: string): string | undefined {\n  const parts = (path.startsWith(\"/\") ? path : `${dir}/${path}`).split(\"/\");\n  const out: string[] = [];\n  for (const p of parts) {\n    if (!p || p === \".\") continue;\n    if (p === \"..\") {\n      if (!out.length) return undefined;\n      out.pop();\n    } else out.push(p);\n  }\n  const joined = `/${out.join(\"/\")}`;\n  const r = normalizePath(root);\n  return r === \"/\" || joined === r || joined.startsWith(`${r}/`) ? joined : undefined;\n}\n\nexport const dirOf = (path: string) => path.slice(0, path.lastIndexOf(\"/\")) || \"/\";\n\n/** The id of a mount's file: `<prefix>/<path below root>`. */\nexport function idOf(mount: Mount, path: string): string {\n  const r = normalizePath(mount.root);\n  const rel = r === \"/\" ? path : path.slice(r.length);\n  return `${mount.prefix}${rel || \"/\"}`;\n}\n\n/** A mount's file from its id; `undefined` when the id is not the mount's. */\nexport function pathOf(mount: Mount, id: string): string | undefined {\n  if (!id.startsWith(`${mount.prefix}/`)) return undefined;\n  const r = normalizePath(mount.root);\n  const rel = id.slice(mount.prefix.length);\n  return r === \"/\" ? rel : `${r}${rel}`;\n}\n\nexport async function isFile(mount: Mount, path: string): Promise<boolean> {\n  const s = await mount.files.stats(path);\n  return s?.kind === \"file\";\n}\n\nexport async function readManifest(\n  files: Mount[\"files\"],\n  dir: string,\n): Promise<PackageManifest | undefined> {\n  const text = await tryReadText(files, `${dir === \"/\" ? \"\" : dir}/package.json`);\n  if (text === undefined) return undefined;\n  try {\n    return JSON.parse(text) as PackageManifest;\n  } catch {\n    return undefined;\n  }\n}\n\n/** `react` → `{ name: \"react\" }`; `@a/b/c.js` → `{ name: \"@a/b\", subpath: \"c.js\" }`. */\nexport function parsePackageSpecifier(spec: string): { name: string; subpath?: string } {\n  const parts = spec.split(\"/\");\n  const n = spec.startsWith(\"@\") ? 2 : 1;\n  const name = parts.slice(0, n).join(\"/\");\n  const subpath = parts.slice(n).join(\"/\");\n  return subpath ? { name, subpath } : { name };\n}\n","import { tryReadText } from \"@statewalker/webrun-files\";\nimport { dirOf, idOf, joinWithin } from \"./paths.js\";\nimport type { Mount, SourceMap } from \"./types.js\";\n\n// The last `//# sourceMappingURL=…` (or `//@`) comment of a JS file.\nconst MAP_COMMENT = /\\/\\/[#@]\\s*sourceMappingURL=(\\S+)\\s*$/;\n\nconst toBase64 = (text: string) => {\n  const bytes = new TextEncoder().encode(text);\n  let bin = \"\";\n  for (let i = 0; i < bytes.length; i += 0x8000)\n    bin += String.fromCharCode(...bytes.subarray(i, i + 0x8000));\n  return btoa(bin);\n};\nconst fromBase64 = (b64: string) =>\n  new TextDecoder().decode(Uint8Array.from(atob(b64), (c) => c.charCodeAt(0)));\n\n/**\n * A file's own source map, made usable by esbuild, which reads only maps inlined in\n * the file it loads (it cannot follow a linked `.map` through a FilesApi):\n *\n * - a linked map (`//# sourceMappingURL=index.js.map`) is read from the same tree and\n *   inlined; an inline `data:` map is kept;\n * - its sources become ids of the same tree (`npm:pkg@1.0.0/src/index.ts`), so the\n *   bundle's map names the package's original files, not the published JavaScript;\n * - missing `sourcesContent` is filled from the tree when the original file ships\n *   with the package.\n *\n * esbuild then composes it with its own: a bundled line traces to the original source.\n * A map that is missing or unreadable is dropped (the file maps to itself).\n */\n/**\n * `code` without its trailing `sourceMappingURL` comment (and without reading the map): for\n * bundles built with no source map, where an inlined input map would only add to what esbuild\n * parses and holds (a package's maps, with their sources' text, can outweigh its code).\n */\nexport function withoutInputMap(code: string): string {\n  const end = code.trimEnd();\n  const nl = end.lastIndexOf(\"\\n\");\n  return MAP_COMMENT.test(end.slice(nl + 1)) ? end.slice(0, Math.max(0, nl)) : code;\n}\n\nexport async function inlineInputMap(mount: Mount, path: string, code: string): Promise<string> {\n  const lines = code.trimEnd().split(\"\\n\");\n  const last = lines[lines.length - 1] ?? \"\";\n  const match = MAP_COMMENT.exec(last);\n  if (!match) return code;\n  const url = match[1] as string;\n  const body = lines.slice(0, -1).join(\"\\n\");\n  let text: string | undefined;\n  let mapDir = dirOf(path);\n  if (url.startsWith(\"data:\")) {\n    const comma = url.indexOf(\",\");\n    const meta = url.slice(5, comma);\n    const payload = url.slice(comma + 1);\n    try {\n      text = meta.endsWith(\";base64\") ? fromBase64(payload) : decodeURIComponent(payload);\n    } catch {\n      text = undefined;\n    }\n  } else if (!/^[a-z][a-z0-9+.-]*:/i.test(url)) {\n    const mapPath = joinWithin(mount.root, dirOf(path), decodeURIComponent(url));\n    if (mapPath) {\n      text = await tryReadText(mount.files, mapPath);\n      mapDir = dirOf(mapPath);\n    }\n  }\n  let map: SourceMap;\n  try {\n    map = JSON.parse(text ?? \"\") as SourceMap;\n  } catch {\n    return body; // no usable map: the file is its own source\n  }\n  const sourceDir = map.sourceRoot\n    ? (joinWithin(\"/\", mapDir, map.sourceRoot.replace(/\\/$/, \"\")) ?? mapDir)\n    : mapDir;\n  const contents: (string | null)[] = map.sourcesContent ? [...map.sourcesContent] : [];\n  const sources: string[] = [];\n  for (let i = 0; i < map.sources.length; i++) {\n    const src = map.sources[i] as string;\n    const local = /^[a-z][a-z0-9+.-]*:/i.test(src)\n      ? undefined\n      : joinWithin(mount.root, sourceDir, src);\n    sources.push(local ? idOf(mount, local) : src);\n    if (contents[i] == null && local) contents[i] = (await tryReadText(mount.files, local)) ?? null;\n  }\n  const fixed: SourceMap = { ...map, sources, sourcesContent: contents };\n  delete fixed.sourceRoot;\n  return `${body}\\n//# sourceMappingURL=data:application/json;base64,${toBase64(JSON.stringify(fixed))}\\n`;\n}\n","import type { Source } from \"@statewalker/webrun-modules\";\nimport { dirOf, readManifest } from \"./paths.js\";\nimport type { Importer, Mount, PackageStore } from \"./types.js\";\n\nconst mountPrefix = (name: string, version: string | undefined) =>\n  `npm:${name}@${version ?? \"0.0.0\"}`;\n\n/**\n * Packages from `node_modules` folders, found as Node finds them: in the importing\n * file's directory and each parent, inside the importer's own FilesApi. A package\n * installed in the project (or in another package's `node_modules`) is read where it is.\n *\n * pnpm layouts: a package's own dependencies sit next to its real directory in\n * `node_modules/.pnpm`, which Node reaches through the symlink's real path and a FilesApi\n * cannot see. When the walk finds nothing, each ancestor's `node_modules/.pnpm/node_modules`\n * (pnpm's hoisted links to every installed package) is tried too.\n */\nexport function nodeModulesPackages(): PackageStore {\n  const mounts = new Map<string, Mount>();\n  const at = async (files: Mount[\"files\"], root: string, name: string) => {\n    const known = mounts.get(root);\n    if (known && known.files === files) return known;\n    const manifest = await readManifest(files, root);\n    if (!manifest) return undefined;\n    const mount: Mount = { prefix: mountPrefix(name, manifest.version), files, root, manifest };\n    mounts.set(root, mount);\n    return mount;\n  };\n  const ancestors = (path: string) => {\n    const dirs: string[] = [];\n    for (let dir = dirOf(path); ; dir = dirOf(dir)) {\n      dirs.push(dir === \"/\" ? \"\" : dir);\n      if (dir === \"/\") return dirs;\n    }\n  };\n  return {\n    async get(name, importer) {\n      const files = importer.mount.files;\n      const dirs = ancestors(importer.path);\n      for (const dir of dirs) {\n        const m = await at(files, `${dir}/node_modules/${name}`, name);\n        if (m) return m;\n      }\n      for (const dir of dirs) {\n        const m = await at(files, `${dir}/node_modules/.pnpm/node_modules/${name}`, name);\n        if (m) return m;\n      }\n      return undefined;\n    },\n  };\n}\n\nconst DEPENDENCY_FIELDS = [\n  \"dependencies\",\n  \"peerDependencies\",\n  \"optionalDependencies\",\n  \"devDependencies\",\n] as const;\n\n/** The version range `importer`'s `package.json` gives `name`, if any. */\nfunction rangeFor(name: string, importer: Importer): string | undefined {\n  const m = importer.mount.manifest;\n  for (const field of DEPENDENCY_FIELDS) {\n    const range = m?.[field]?.[name];\n    if (range) return range;\n  }\n  return undefined;\n}\n\n/**\n * Packages fetched on demand (default: the npm registry, through webrun-modules'\n * `npmRegistrySource`) and kept in memory: each one is its own FilesApi tree. The\n * version is the range the importer's `package.json` declares (the project's for the\n * project's files), else the latest; one range loads once.\n */\nexport function npmPackages(opts: { source?: Source } = {}): PackageStore {\n  // Loaded only when used: a bundle of the bundler that brings its own source stays small.\n  let registry: Promise<Source> | undefined;\n  const source: Source = opts.source ?? {\n    matches: (ref) => \"pkg\" in ref,\n    load: async (ref) => {\n      registry ??= import(\"@statewalker/webrun-modules\").then((m) => m.npmRegistrySource());\n      return (await registry).load(ref);\n    },\n  };\n  const byRange = new Map<string, Promise<Mount>>();\n  const byVersion = new Map<string, Mount>();\n  return {\n    get(name, importer) {\n      const range = rangeFor(name, importer);\n      const key = `${name}@${range ?? \"latest\"}`;\n      let mount = byRange.get(key);\n      if (!mount) {\n        mount = source.load({ pkg: name, version: range }).then((p) => {\n          const prefix = mountPrefix(p.name, p.version);\n          const seen = byVersion.get(prefix);\n          if (seen) return seen; // two ranges, one version: one copy of the package\n          const m: Mount = { prefix, files: p.files, root: \"/\", manifest: p.manifest };\n          byVersion.set(prefix, m);\n          return m;\n        });\n        byRange.set(key, mount);\n      }\n      return mount;\n    },\n  };\n}\n\n/** The first store that has the package wins (`node_modules` first, then the registry). */\nexport function chainPackages(...stores: PackageStore[]): PackageStore {\n  return {\n    async get(name, importer) {\n      let failure: unknown;\n      for (const s of stores) {\n        try {\n          const m = await s.get(name, importer);\n          if (m) return m;\n        } catch (e) {\n          failure ??= e; // the next store may still have it\n        }\n      }\n      if (failure) throw failure;\n      return undefined;\n    },\n  };\n}\n","import { imports as resolveImports, exports as resolvePackageExports } from \"resolve.exports\";\nimport { dirOf, isFile, joinWithin, parsePackageSpecifier } from \"./paths.js\";\nimport type { Importer, Mount, PackageManifest, PackageStore } from \"./types.js\";\n\n/** Extensions tried, in order, for a path written without one (or with `.js` for a `.ts` file). */\nconst EXTENSIONS = [\".ts\", \".tsx\", \".mts\", \".cts\", \".js\", \".jsx\", \".mjs\", \".cjs\", \".json\"];\n\nexport interface Resolved {\n  mount: Mount;\n  path: string;\n}\n\n/** `path` as written, else with an extension, else its `index` file. */\nasync function resolveFile(mount: Mount, path: string): Promise<string | undefined> {\n  if (await isFile(mount, path)) return path;\n  // TypeScript sources import `./x.js` for `./x.ts`.\n  const js = /\\.(m|c)?jsx?$/.exec(path);\n  if (js) {\n    const base = path.slice(0, -js[0].length);\n    for (const ext of [`.${js[1] ?? \"\"}ts`, \".tsx\"])\n      if (await isFile(mount, base + ext)) return base + ext;\n  }\n  for (const ext of EXTENSIONS) if (await isFile(mount, path + ext)) return path + ext;\n  const dir = path.endsWith(\"/\") ? path.slice(0, -1) : path;\n  for (const ext of EXTENSIONS)\n    if (await isFile(mount, `${dir}/index${ext}`)) return `${dir}/index${ext}`;\n  return undefined;\n}\n\ntype Conditions = { conditions: string[]; require: boolean; browser: boolean };\n\nfunction exportsTarget(\n  manifest: PackageManifest,\n  entry: string,\n  c: Conditions,\n): string | undefined {\n  try {\n    const out = resolvePackageExports(manifest, entry, {\n      conditions: c.conditions,\n      require: c.require,\n      browser: c.browser,\n    }) as string[] | undefined;\n    return out?.[0];\n  } catch {\n    return undefined;\n  }\n}\n\n/** A package's file for `subpath`: `exports` first, then `module`/`main` (and `browser` when it is a string). */\nasync function resolvePackageEntry(\n  mount: Mount,\n  subpath: string | undefined,\n  c: Conditions,\n): Promise<string | undefined> {\n  const manifest = mount.manifest ?? {};\n  const entry = subpath ? `./${subpath}` : \".\";\n  if (manifest.exports !== undefined) {\n    const target = exportsTarget(manifest, entry, c);\n    if (!target) return undefined; // not exported: Node refuses it as well\n    return joinWithin(mount.root, mount.root, target);\n  }\n  if (subpath) return resolveFile(mount, joinWithin(mount.root, mount.root, subpath) ?? \"\");\n  const fields = [\n    ...(c.browser && typeof manifest.browser === \"string\" ? [manifest.browser] : []),\n    ...(c.require ? [] : [manifest.module]),\n    manifest.main,\n    \"index.js\",\n  ].filter((f): f is string => typeof f === \"string\");\n  for (const f of fields) {\n    const p = joinWithin(mount.root, mount.root, f);\n    const file = p && (await resolveFile(mount, p));\n    if (file) return file;\n  }\n  return undefined;\n}\n\n/**\n * Resolves `spec` as written in `importer`: a path of the same tree (`./x`, `../y.js`,\n * `/z`), a `#imports` alias of the importer's package, or a package found by `packages`\n * (with its `exports`, `module` and `main`).\n */\nexport async function resolveSpecifier(\n  spec: string,\n  importer: Importer,\n  packages: PackageStore,\n  c: Conditions,\n): Promise<Resolved | undefined> {\n  const { mount } = importer;\n  if (spec.startsWith(\"./\") || spec.startsWith(\"../\") || spec.startsWith(\"/\") || spec === \".\") {\n    const base = spec.startsWith(\"/\") ? mount.root : dirOf(importer.path);\n    const target = joinWithin(mount.root, base, spec.startsWith(\"/\") ? spec.slice(1) : spec);\n    const path = target && (await resolveFile(mount, target));\n    return path ? { mount, path } : undefined;\n  }\n  if (spec.startsWith(\"#\")) {\n    try {\n      const out = resolveImports(mount.manifest ?? {}, spec, {\n        conditions: c.conditions,\n        require: c.require,\n        browser: c.browser,\n      }) as string[] | undefined;\n      const target = out?.[0];\n      if (!target) return undefined;\n      if (!target.startsWith(\".\")) return resolveSpecifier(target, importer, packages, c);\n      const path = joinWithin(mount.root, mount.root, target);\n      return path && (await isFile(mount, path)) ? { mount, path } : undefined;\n    } catch {\n      return undefined;\n    }\n  }\n  const { name, subpath } = parsePackageSpecifier(spec);\n  const pkg = await packages.get(name, importer);\n  if (!pkg) return undefined;\n  const path = await resolvePackageEntry(pkg, subpath, c);\n  return path && (await isFile(pkg, path)) ? { mount: pkg, path } : undefined;\n}\n","import { readText } from \"@statewalker/webrun-files\";\nimport type { Loader, Plugin } from \"esbuild-wasm\";\nimport { inlineInputMap, withoutInputMap } from \"./input-maps.js\";\nimport { nodeModulesPackages } from \"./packages.js\";\nimport { dirOf, idOf, isFile, joinWithin, pathOf, readManifest } from \"./paths.js\";\nimport { resolveSpecifier } from \"./resolve.js\";\nimport type {\n  BundleOptions,\n  BundleResult,\n  ExternalPattern,\n  Mount,\n  SourceMap,\n  TranspileOptions,\n  TranspileResult,\n} from \"./types.js\";\n\n/** esbuild's namespace for the files the bundler serves; its source-map names drop it. */\nconst NS = \"webrun\";\n/** esbuild's namespace for the host's modules (`modules`): `virtual:<specifier>` in maps. */\nconst VNS = \"webrun-virtual\";\n/** Marks an `inject` entry, so that it resolves like an import, not like the entry point. */\nconst INJECT = \"webrun-inject:\";\n\n/** esbuild `supported` flags that lower `await` to generators. */\nconst LOWER_AWAIT = { \"async-await\": false, \"async-generator\": false, \"for-await\": false };\n\nconst LOADERS: Record<string, Loader> = {\n  ts: \"ts\",\n  mts: \"ts\",\n  cts: \"ts\",\n  tsx: \"tsx\",\n  jsx: \"jsx\",\n  js: \"js\",\n  mjs: \"js\",\n  cjs: \"js\",\n  json: \"json\",\n  css: \"css\",\n  txt: \"text\",\n  wasm: \"binary\",\n};\nexport const loaderFor = (path: string): Loader =>\n  LOADERS[/\\.([a-z0-9]+)$/i.exec(path)?.[1]?.toLowerCase() ?? \"\"] ?? \"js\";\n\nconst isExternal = (spec: string, patterns: ExternalPattern[]) =>\n  /^(https?:|data:)/.test(spec) ||\n  patterns.some((p) =>\n    typeof p === \"string\"\n      ? p.endsWith(\"*\")\n        ? spec.startsWith(p.slice(0, -1))\n        : spec === p\n      : p.test(spec),\n  );\n\n/** A source name of esbuild's map → the file id it stands for. */\nconst sourceId = (s: string) =>\n  s\n    .replace(/^(\\.\\.\\/)*/, \"\")\n    .replace(new RegExp(`^${VNS}:`), \"virtual:\")\n    .replace(new RegExp(`^${NS}:`), \"\")\n    .replace(\"?type=module.mjs\", \"\"); // ESM_SUFFIX: the file's id, as in the map's other sources\n\nconst toBase64 = (text: string) => {\n  const bytes = new TextEncoder().encode(text);\n  let bin = \"\";\n  for (let i = 0; i < bytes.length; i += 0x8000)\n    bin += String.fromCharCode(...bytes.subarray(i, i + 0x8000));\n  return btoa(bin);\n};\n\n/** `code` with its trailing map link replaced: by `map` inlined, or by a link to `name`. */\nfunction linkMap(code: string, map: SourceMap, how: \"external\" | \"inline\", name: string) {\n  const body = code.replace(/\\n?\\/\\/# sourceMappingURL=\\S+\\s*$/, \"\");\n  const url =\n    how === \"inline\"\n      ? `data:application/json;base64,${toBase64(JSON.stringify(map))}`\n      : `${name.split(\"/\").pop()}.map`;\n  return `${body}\\n//# sourceMappingURL=${url}\\n`;\n}\n\n/**\n * Bundles `entry` of a project into one module with esbuild (esbuild-wasm in browsers).\n * Every file is read through FilesApi (the project's, or a package's from `packages`):\n * esbuild resolves and loads nothing itself. esbuild transpiles TypeScript and JSX,\n * converts CommonJS, lowers `await` when asked, and bundles, all in one pass, and its\n * source map goes back through each step to the files it read; where a package ships\n * its own map (TypeScript compiled to `.js`), to the package's original source. The\n * map's sources are file ids: `~/src/app.ts`, `npm:pkg@1.2.3/src/index.ts`.\n */\n/** Marks the id of a `.js` file in a `\"type\": \"module\"` package scope (see `moduleTypeOf`). */\nconst ESM_SUFFIX = \"?type=module.mjs\";\n\nexport async function bundle(opts: BundleOptions): Promise<BundleResult> {\n  const root = opts.root ?? \"/\";\n  const project: Mount = {\n    prefix: \"~\",\n    files: opts.files,\n    root,\n    manifest: await readManifest(opts.files, root),\n  };\n  const packages = opts.packages ?? nodeModulesPackages();\n  const external = opts.external ?? [];\n  const browser = (opts.platform ?? \"browser\") === \"browser\";\n  const conditions = opts.conditions ?? [\"browser\"];\n  const outfile = opts.outfile ?? \"bundle.js\";\n  const mounts = new Map<string, Mount>([[project.prefix, project]]);\n  const supplied = opts.modules;\n  const virtualSource = (spec: string) =>\n    typeof supplied === \"function\" ? supplied(spec) : supplied?.[spec];\n\n  /** The mount and path of a file id; the longest prefix wins (`npm:@a/b@1.0.0/…`). */\n  /**\n   * The module type of a `.js` file, as Node.js decides it: the `type` of the nearest\n   * `package.json` (tslib ships `modules/package.json` with `\"type\": \"module\"`). esbuild reads\n   * that only for files on its own file system; for ours, a file in a `\"type\": \"module\"` scope\n   * gets an id ending in ESM_SUFFIX (`.mjs`), so that esbuild gives its imports of CommonJS\n   * modules Node's interop: the default import is `module.exports`, even with `__esModule`.\n   * Vite gets the same from esbuild by pre-bundling dependencies from disk.\n   */\n  const scopeTypes = new Map<string, string | undefined>();\n  const moduleTypeOf = async (mount: Mount, path: string): Promise<string | undefined> => {\n    const root = mount.root.replace(/\\/$/, \"\");\n    for (let dir = dirOf(path); dir.length >= root.length; dir = dirOf(dir)) {\n      const key = `${mount.prefix}:${dir}`;\n      if (scopeTypes.has(key)) return scopeTypes.get(key);\n      const pj = `${dir === \"/\" ? \"\" : dir}/package.json`;\n      if (await isFile(mount, pj)) {\n        let type: string | undefined;\n        try {\n          type = JSON.parse(await readText(mount.files, pj)).type;\n        } catch {}\n        scopeTypes.set(key, type);\n        return type;\n      }\n      if (dir === root || dir === \"/\" || !dir) break;\n    }\n    return undefined;\n  };\n\n  const locate = (id: string) => {\n    if (id.endsWith(ESM_SUFFIX)) id = id.slice(0, -ESM_SUFFIX.length);\n    let best: Mount | undefined;\n    for (const m of mounts.values())\n      if (id.startsWith(`${m.prefix}/`) && (!best || m.prefix.length > best.prefix.length))\n        best = m;\n    const path = best && pathOf(best, id);\n    if (!best || !path) throw new Error(`webrun-bundler: no file ${id}`);\n    return { mount: best, path };\n  };\n\n  const plugin: Plugin = {\n    name: \"webrun-files\",\n    setup(b) {\n      b.onResolve({ filter: /.*/ }, async (args) => {\n        const injected = args.path.startsWith(INJECT);\n        const spec = injected ? args.path.slice(INJECT.length) : args.path;\n        if (args.kind === \"entry-point\" && !injected) {\n          const path = joinWithin(root, root, args.path.replace(/^\\/+/, \"\"));\n          if (!path) return { errors: [{ text: `entry ${args.path} is outside the project` }] };\n          return { path: idOf(project, path), namespace: NS };\n        }\n        if (virtualSource(spec) !== undefined) return { path: spec, namespace: VNS };\n        if (isExternal(spec, external)) return { path: spec, external: true };\n        // The host's modules and `inject` entries import from the project's root.\n        const importer =\n          injected || args.namespace === VNS\n            ? { mount: project, path: `${root === \"/\" ? \"\" : root}/` }\n            : locate(args.importer);\n        const require = args.kind === \"require-call\" || args.kind === \"require-resolve\";\n        const failed = (why?: string) => ({\n          errors: [\n            {\n              text: `Could not resolve \"${spec}\" (imported by ${args.importer || \"inject\"})${why ? `: ${why}` : \"\"}`,\n            },\n          ],\n        });\n        let r: Awaited<ReturnType<typeof resolveSpecifier>>;\n        try {\n          r = await resolveSpecifier(spec, importer, packages, {\n            conditions,\n            require,\n            browser,\n          });\n        } catch (e) {\n          return failed((e as Error)?.message ?? String(e));\n        }\n        if (!r) return failed();\n        mounts.set(r.mount.prefix, r.mount);\n        const esm = /\\.js$/.test(r.path) && (await moduleTypeOf(r.mount, r.path)) === \"module\";\n        return { path: idOf(r.mount, r.path) + (esm ? ESM_SUFFIX : \"\"), namespace: NS };\n      });\n      b.onLoad({ filter: /.*/, namespace: VNS }, (args) => ({\n        contents: virtualSource(args.path) ?? \"\",\n        loader: \"js\",\n      }));\n      b.onLoad({ filter: /.*/, namespace: NS }, async (args) => {\n        const { mount, path } = locate(args.path);\n        const loader = loaderFor(path);\n        if (loader === \"binary\") {\n          const chunks: Uint8Array[] = [];\n          for await (const c of mount.files.read(path)) chunks.push(c);\n          const bytes = new Uint8Array(chunks.reduce((n, c) => n + c.length, 0));\n          let at = 0;\n          for (const c of chunks) {\n            bytes.set(c, at);\n            at += c.length;\n          }\n          return { contents: bytes, loader };\n        }\n        const text = await readText(mount.files, path);\n        const js = loader === \"js\" || loader === \"ts\" || loader === \"jsx\" || loader === \"tsx\";\n        // Without an output map, the inputs' own maps are not read: esbuild would only parse them.\n        if (!js) return { contents: text, loader };\n        if (opts.sourcemap === false) return { contents: withoutInputMap(text), loader };\n        return { contents: await inlineInputMap(mount, path, text), loader };\n      });\n    },\n  };\n\n  const { plugins: extraPlugins = [], ...rest } = opts.esbuildOptions ?? {};\n  const result = await opts.esbuild.build({\n    entryPoints: [opts.entry],\n    bundle: true,\n    write: false,\n    format: opts.format ?? \"esm\",\n    platform: opts.platform ?? \"browser\",\n    target: opts.target ?? \"es2022\",\n    outfile,\n    absWorkingDir: \"/\",\n    metafile: true,\n    logLevel: \"silent\",\n    minify: opts.minify,\n    define: opts.define,\n    ...(opts.lowerAwait ? { supported: LOWER_AWAIT } : {}),\n    ...rest,\n    ...(opts.inject?.length ? { inject: opts.inject.map((s) => INJECT + s) } : {}),\n    // `sourcemap: false`: no map at all (a large bundle's map, with every source's content,\n    // can take more memory than the bundle).\n    sourcemap: opts.sourcemap === false ? false : \"external\",\n    sourcesContent: opts.sourcemap !== false,\n    plugins: [...extraPlugins, plugin],\n  });\n  const out = result.outputFiles ?? [];\n  const jsFile = out.find((f) => !f.path.endsWith(\".map\"));\n  const mapFile = out.find((f) => f.path.endsWith(\".map\"));\n  if (!jsFile) throw new Error(\"webrun-bundler: esbuild produced no output\");\n  if (!mapFile)\n    return {\n      code: jsFile.text,\n      map: { version: 3, sources: [], names: [], mappings: \"\" } as unknown as SourceMap,\n      metafile: result.metafile as BundleResult[\"metafile\"],\n      warnings: result.warnings,\n    } as BundleResult;\n  const raw = JSON.parse(mapFile.text) as SourceMap;\n  const map: SourceMap = {\n    ...raw,\n    file: outfile.split(\"/\").pop(),\n    sources: raw.sources.map(sourceId),\n  };\n  delete map.sourceRoot;\n  return {\n    code: linkMap(jsFile.text, map, opts.sourcemap || \"external\", outfile),\n    map,\n    metafile: result.metafile as BundleResult[\"metafile\"],\n    warnings: result.warnings,\n  };\n}\n\n/**\n * Transpiles one file (TypeScript, JSX, modern syntax down to `target`; `await` lowered\n * when asked) with a source map back to it. A map the code carries (`sourceMappingURL`,\n * inline) is composed in, so the result still traces to the original.\n */\nexport async function transpile(code: string, opts: TranspileOptions): Promise<TranspileResult> {\n  const r = await opts.esbuild.transform(code, {\n    loader: loaderFor(opts.path),\n    sourcefile: opts.path,\n    sourcemap: \"external\",\n    sourcesContent: true,\n    format: opts.format,\n    target: opts.target ?? \"es2022\",\n    minify: opts.minify,\n    define: opts.define,\n    ...(opts.lowerAwait ? { supported: LOWER_AWAIT } : {}),\n  });\n  const map = JSON.parse(r.map) as SourceMap;\n  return {\n    code: linkMap(r.code, map, opts.sourcemap ?? \"external\", opts.path.replace(/\\.[^./]+$/, \".js\")),\n    map,\n    warnings: r.warnings,\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "@statewalker/webrun-bundler",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "private": false,
+  "type": "module",
+  "description": "Transpiler, resolver and bundler on esbuild-wasm that reads everything through a FilesApi (MemFilesApi, OPFS, a FilesApi over a port; never node:fs) and fetches npm packages on demand. Every transformation keeps a source map: each line of a bundle traces back to the user's file or to the npm package's own source.",
+  "bugs": {
+    "url": "https://github.com/statewalker/webrun-sites/issues"
+  },
+  "homepage": "https://github.com/statewalker/webrun-sites/tree/main/packages/webrun-bundler#readme",
+  "author": {
+    "name": "Mikhail Kotelnikov",
+    "email": "mikhail.kotelnikov@gmail.com"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/statewalker/webrun-sites.git",
+    "directory": "packages/webrun-bundler"
+  },
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@statewalker/webrun-files": "^0.10.0",
+    "resolve.exports": "^2.0.3",
+    "@statewalker/webrun-modules": "^0.3.6"
+  },
+  "peerDependencies": {
+    "esbuild-wasm": "^0.28.0"
+  },
+  "devDependencies": {
+    "@jridgewell/trace-mapping": "^0.3.31",
+    "@statewalker/webrun-files-browser": "^0.10.2",
+    "@statewalker/webrun-files-mem": "^0.10.0",
+    "esbuild-wasm": "^0.28.2",
+    "playwright": "^1.63.0",
+    "rimraf": "^6.1.3",
+    "tsdown": "^0.23.0",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.3"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist",
+    "lint": "biome check --write .",
+    "format": "biome format --write .",
+    "test:browser": "node e2e/browser.mjs"
+  }
 }

package/src/bundle.test.ts

@@ -0,0 +1,459 @@
+import { originalPositionFor, TraceMap } from "@jridgewell/trace-mapping";
+import type { FilesApi } from "@statewalker/webrun-files";
+import { MemFilesApi } from "@statewalker/webrun-files-mem";
+import type { Source } from "@statewalker/webrun-modules";
+import * as esbuild from "esbuild-wasm";
+import { describe, expect, it } from "vitest";
+import { bundle, chainPackages, nodeModulesPackages, npmPackages, transpile } from "./index.js";
+import type { SourceMap } from "./types.js";
+
+// esbuild-wasm itself (its Node build runs the same WebAssembly as in browsers); every
+// file comes from a MemFilesApi, nothing from a disk.
+
+const enc = new TextEncoder();
+async function filesOf(tree: Record<string, string>): Promise<FilesApi> {
+  const files = new MemFilesApi();
+  for (const [path, text] of Object.entries(tree)) await files.write(path, [enc.encode(text)]);
+  return files;
+}
+
+/** 1-based line of the first line of `text` containing `marker`. */
+const lineOf = (text: string, marker: string) =>
+  text.split("\n").findIndex((l) => l.includes(marker)) + 1;
+
+/** Where the bundled line holding `marker` comes from. */
+function trace(code: string, map: SourceMap, marker: string) {
+  const lines = code.split("\n");
+  const line = lines.findIndex((l) => l.includes(marker));
+  expect(line, `${marker} in the bundle`).toBeGreaterThanOrEqual(0);
+  const tm = new TraceMap(map as never);
+  const text = lines[line] as string;
+  // the first mapped column of the line
+  for (let column = 0; column < text.length; column++) {
+    const pos = originalPositionFor(tm, { line: line + 1, column });
+    if (pos.source) return { source: pos.source, line: pos.line };
+  }
+  return { source: null, line: null };
+}
+
+// The original TypeScript of a published package: types and comments make its lines differ
+// from the compiled JavaScript's, so a trace that ends at the .js would be off.
+const ESM_PKG_SRC = `/** Greeting helpers. */
+export interface Options {
+  punctuation?: string;
+}
+
+export type Name = string;
+
+export async function greet(name: Name, opts: Options = {}): Promise<string> {
+  await Promise.resolve();
+  return "hello " + name + (opts.punctuation ?? "!") + "MARK_ESM_PKG".slice(99);
+}
+`;
+
+/** `esm-pkg` as npm ships it: compiled dist/, a linked map without sourcesContent, src/. */
+async function esmPackage(): Promise<Record<string, string>> {
+  const out = await esbuild.transform(ESM_PKG_SRC, {
+    loader: "ts",
+    sourcefile: "../src/index.ts",
+    sourcemap: "external",
+    format: "esm",
+    target: "es2022",
+  });
+  const map = JSON.parse(out.map);
+  delete map.sourcesContent; // many packages ship maps without it: the bundler reads src/
+  return {
+    "/package.json": JSON.stringify({
+      name: "esm-pkg",
+      version: "1.2.3",
+      type: "module",
+      exports: { ".": { browser: "./dist/browser.js", default: "./dist/index.js" } },
+    }),
+    "/dist/browser.js": `${out.code}//# sourceMappingURL=browser.js.map\n`,
+    "/dist/browser.js.map": JSON.stringify(map),
+    "/dist/index.js": 'export const greet = () => "not the browser build";\n',
+    "/src/index.ts": ESM_PKG_SRC,
+  };
+}
+
+const CJS_PKG = {
+  "/package.json": JSON.stringify({ name: "cjs-pkg", version: "2.0.0", main: "lib/index.js" }),
+  "/lib/index.js": `"use strict";
+exports.shout = function (s) {
+  return s.toUpperCase() + "!" + "MARK_CJS".slice(99);
+};
+`,
+};
+
+const APP = `import cjs from "cjs-pkg";
+import { greet } from "esm-pkg";
+import data from "./data.json";
+
+export async function main(name: string): Promise<string> {
+  const g = (await greet(name)) + "MARK_APP_AWAIT".slice(99);
+  return \`\${g} \${cjs.shout(name)} \${data.v}\${"MARK_APP_RETURN".slice(99)}\`;
+}
+`;
+
+/** A registry `Source` over in-memory packages; counts loads. */
+function fakeRegistry(packages: Record<string, Record<string, string>>) {
+  const loads: string[] = [];
+  const source: Source = {
+    matches: (ref) => "pkg" in ref,
+    async load(ref) {
+      if (!("pkg" in ref)) throw new Error("not a package");
+      loads.push(`${ref.pkg}@${ref.version ?? "latest"}`);
+      const tree = packages[ref.pkg];
+      if (!tree) throw new Error(`no package ${ref.pkg}`);
+      const files = await filesOf(tree);
+      const manifest = JSON.parse(tree["/package.json"] as string);
+      return { name: ref.pkg, version: manifest.version, files, manifest };
+    },
+  };
+  return { source, loads };
+}
+
+async function run(code: string) {
+  const bytes = enc.encode(code);
+  let bin = "";
+  for (const b of bytes) bin += String.fromCharCode(b);
+  const url = `data:text/javascript;base64,${btoa(bin)}`;
+  return import(/* @vite-ignore */ url);
+}
+
+describe("bundle", () => {
+  it("bundles from a FilesApi with packages fetched on demand; every line traces to its source", async () => {
+    const files = await filesOf({
+      "/package.json": JSON.stringify({
+        dependencies: { "esm-pkg": "^1.0.0", "cjs-pkg": "^2.0.0" },
+      }),
+      "/src/app.ts": APP,
+      "/src/data.json": '{ "v": 42 }',
+    });
+    const { source, loads } = fakeRegistry({ "esm-pkg": await esmPackage(), "cjs-pkg": CJS_PKG });
+    const r = await bundle({
+      esbuild,
+      files,
+      entry: "/src/app.ts",
+      packages: npmPackages({ source }),
+    });
+
+    expect(loads.sort()).toEqual(["cjs-pkg@^2.0.0", "esm-pkg@^1.0.0"]);
+    expect((await run(r.code)).main).toBeTypeOf("function");
+    expect(await (await run(r.code)).main("bob")).toBe("hello bob! BOB! 42");
+    expect(r.code).toMatch(/\/\/# sourceMappingURL=bundle\.js\.map\n$/);
+
+    // The user's TypeScript, line for line.
+    expect(trace(r.code, r.map, "MARK_APP_AWAIT")).toEqual({
+      source: "~/src/app.ts",
+      line: lineOf(APP, "MARK_APP_AWAIT"),
+    });
+    expect(trace(r.code, r.map, "MARK_APP_RETURN")).toEqual({
+      source: "~/src/app.ts",
+      line: lineOf(APP, "MARK_APP_RETURN"),
+    });
+    // Through the package's own map, to its original TypeScript (not dist/browser.js).
+    expect(trace(r.code, r.map, "MARK_ESM_PKG")).toEqual({
+      source: "npm:esm-pkg@1.2.3/src/index.ts",
+      line: lineOf(ESM_PKG_SRC, "MARK_ESM_PKG"),
+    });
+    // CommonJS, converted by esbuild, still maps to the package's file.
+    expect(trace(r.code, r.map, "MARK_CJS")).toEqual({
+      source: "npm:cjs-pkg@2.0.0/lib/index.js",
+      line: 3,
+    });
+    // The map carries every source's text, the package's TypeScript included.
+    const i = r.map.sources.indexOf("npm:esm-pkg@1.2.3/src/index.ts");
+    expect(r.map.sourcesContent?.[i]).toBe(ESM_PKG_SRC);
+    expect(r.map.sources).not.toContain("npm:esm-pkg@1.2.3/dist/browser.js");
+  });
+
+  it("sourcemap: false builds no map (the same code, no sourceMappingURL), warnings kept", async () => {
+    const files = await filesOf({
+      "/package.json": JSON.stringify({
+        dependencies: { "esm-pkg": "^1.0.0", "cjs-pkg": "^2.0.0" },
+      }),
+      "/src/app.ts": APP,
+      "/src/data.json": '{ "v": 42 }',
+      // esbuild warns about a comparison with -0.
+      "/src/warn.ts": "export const odd = (x: number) => x === -0;\n",
+    });
+    const { source } = fakeRegistry({ "esm-pkg": await esmPackage(), "cjs-pkg": CJS_PKG });
+    await files.write("/src/entry.ts", [
+      new TextEncoder().encode('export * from "./app.ts";\nexport * from "./warn.ts";\n'),
+    ]);
+    const r = await bundle({
+      esbuild,
+      files,
+      entry: "/src/entry.ts",
+      packages: npmPackages({ source }),
+      sourcemap: false,
+    });
+    expect(await (await run(r.code)).main("bob")).toBe("hello bob! BOB! 42");
+    expect(r.code).not.toMatch(/sourceMappingURL/);
+    expect(r.map.mappings).toBe("");
+    expect(r.map.sources).toEqual([]);
+    expect(r.warnings?.map((w) => w.text).join(" ")).toMatch(/-0/);
+    // The package's own map is neither read nor inlined: esbuild gets its code alone.
+    const inputs = r.metafile?.inputs ?? {};
+    const pkgInput = Object.keys(inputs).find((k) => k.includes("esm-pkg@1.2.3/dist/browser.js"));
+    expect(pkgInput).toBeDefined();
+    const withMaps = await bundle({
+      esbuild,
+      files,
+      entry: "/src/entry.ts",
+      packages: npmPackages({ source }),
+    });
+    const mapped = withMaps.metafile?.inputs[pkgInput as string]?.bytes ?? 0;
+    expect(inputs[pkgInput as string]?.bytes ?? Infinity).toBeLessThan(mapped);
+  });
+
+  it("maps every line that comes from an input; only esbuild's own helpers have no source", async () => {
+    const files = await filesOf({
+      "/package.json": JSON.stringify({
+        dependencies: { "esm-pkg": "^1.0.0", "cjs-pkg": "^2.0.0" },
+      }),
+      "/src/app.ts": APP,
+      "/src/data.json": '{ "v": 42 }',
+    });
+    const { source } = fakeRegistry({ "esm-pkg": await esmPackage(), "cjs-pkg": CJS_PKG });
+    for (const lowerAwait of [false, true]) {
+      const r = await bundle({
+        esbuild,
+        files,
+        entry: "/src/app.ts",
+        packages: npmPackages({ source }),
+        lowerAwait,
+      });
+      const tm = new TraceMap(r.map as never);
+      const lines = r.code.split("\n");
+      // esbuild's runtime (`__commonJS`, `__toESM`, with lowering `__async`) comes first, up
+      // to the first module's comment; it is the only code no input wrote.
+      const firstModule = lines.findIndex((l) => l.startsWith("// webrun:"));
+      expect(firstModule).toBeGreaterThan(0);
+      // …and its closing `export { … };` clause, which lists the entry's exports.
+      const exportClause = lines.lastIndexOf("export {");
+      const unmapped: string[] = [];
+      lines.slice(firstModule, exportClause < 0 ? undefined : exportClause).forEach((text, i) => {
+        const code = text.trim();
+        if (!code || code.startsWith("//") || /^[\]{}()[;,]+$/.test(code)) return;
+        let mapped = false;
+        for (let column = 0; column < text.length && !mapped; column++)
+          mapped = !!originalPositionFor(tm, { line: firstModule + i + 1, column }).source;
+        if (!mapped) unmapped.push(code);
+      });
+      // Besides them, only esbuild's CommonJS wrapper lines: `var require_x = __commonJS({`
+      // and the module's function head.
+      expect(
+        unmapped.filter(
+          (l) => !/^var require_\w+ = __commonJS\(\{$|^"webrun:[^"]+"\(.*\) \{$/.test(l),
+        ),
+      ).toEqual([]);
+      if (lowerAwait) {
+        expect(r.code).not.toMatch(/\bawait\b/);
+        expect(trace(r.code, r.map, "MARK_APP_AWAIT").source).toBe("~/src/app.ts");
+        expect(trace(r.code, r.map, "MARK_ESM_PKG").source).toBe("npm:esm-pkg@1.2.3/src/index.ts");
+        expect(await (await run(r.code)).main("amy")).toBe("hello amy! AMY! 42");
+      }
+    }
+  });
+
+  it("reads packages from node_modules folders of the FilesApi, nested ones first", async () => {
+    const files = await filesOf({
+      "/src/main.js":
+        'import { a } from "a";\nimport { v } from "b";\nexport const out = a + "/" + v;\n',
+      "/node_modules/a/package.json": JSON.stringify({
+        name: "a",
+        version: "1.0.0",
+        main: "index.js",
+      }),
+      "/node_modules/a/index.js": 'export { v as a } from "b";\n',
+      "/node_modules/a/node_modules/b/package.json": JSON.stringify({
+        name: "b",
+        version: "2.0.0",
+        module: "m.js",
+      }),
+      "/node_modules/a/node_modules/b/m.js": 'export const v = "b2" + "MARK_B2".slice(99);\n',
+      "/node_modules/b/package.json": JSON.stringify({ name: "b", version: "1.0.0" }),
+      "/node_modules/b/index.js": 'export const v = "b1";\n',
+    });
+    const r = await bundle({ esbuild, files, entry: "/src/main.js" });
+    expect((await run(r.code)).out).toBe("b2/b1");
+    expect(trace(r.code, r.map, "MARK_B2").source).toBe("npm:b@2.0.0/m.js");
+    // a/index.js only re-exports: no code of its own, so esbuild maps nothing to it.
+    expect(r.map.sources).toEqual(
+      expect.arrayContaining(["~/src/main.js", "npm:b@2.0.0/m.js", "npm:b@1.0.0/index.js"]),
+    );
+  });
+
+  it('gives files in a "type": "module" scope Node\'s CommonJS interop (tslib\'s modules/)', async () => {
+    // tslib 2.3: exports "import" -> modules/index.js (modules/package.json: type module), which
+    // does `import tslib from "../tslib.js"` of a CommonJS file that sets __esModule. In Node
+    // (and Vite, which pre-bundles from disk) the default import is module.exports.
+    const files = await filesOf({
+      "/src/main.js": 'import { __extends } from "tslib";\nexport const out = typeof __extends;\n',
+      "/node_modules/tslib/package.json": JSON.stringify({
+        name: "tslib",
+        version: "2.3.0",
+        main: "tslib.js",
+        exports: {
+          ".": { import: "./modules/index.js", module: "./tslib.es6.js", default: "./tslib.js" },
+        },
+      }),
+      "/node_modules/tslib/modules/package.json": JSON.stringify({ type: "module" }),
+      "/node_modules/tslib/modules/index.js":
+        'import tslib from "../tslib.js";\nconst { __extends } = tslib;\nexport { __extends };\n',
+      "/node_modules/tslib/tslib.js":
+        'Object.defineProperty(exports, "__esModule", { value: true });\nexports.__extends = function () {};\n',
+      "/node_modules/tslib/tslib.es6.js": "export function __extends() {}\n",
+    });
+    const r = await bundle({
+      esbuild,
+      files,
+      entry: "/src/main.js",
+      conditions: ["browser", "import"],
+    });
+    expect((await run(r.code)).out).toBe("function");
+    expect(r.map.sources).toContain("npm:tslib@2.3.0/modules/index.js");
+  });
+
+  it("keeps externals as imports, picks exports conditions, resolves .js to .ts and #imports", async () => {
+    const files = await filesOf({
+      "/package.json": JSON.stringify({ imports: { "#util": "./src/util.ts" } }),
+      "/src/worker.ts":
+        'import { DurableObject } from "cloudflare:workers";\nimport { readFileSync } from "node:fs";\nimport { which } from "dual";\nimport { util } from "#util";\nimport { helper } from "./helper.js";\nexport const all = [DurableObject, readFileSync, which, util, helper];\n',
+      "/src/util.ts": 'export const util: string = "util";\n',
+      "/src/helper.ts": 'export const helper: string = "helper";\n',
+      "/node_modules/dual/package.json": JSON.stringify({
+        name: "dual",
+        version: "1.0.0",
+        exports: { workerd: "./w.js", browser: "./b.js", default: "./d.js" },
+      }),
+      "/node_modules/dual/w.js": 'export const which = "workerd";\n',
+      "/node_modules/dual/b.js": 'export const which = "browser";\n',
+      "/node_modules/dual/d.js": 'export const which = "default";\n',
+    });
+    const r = await bundle({
+      esbuild,
+      files,
+      entry: "/src/worker.ts",
+      external: ["cloudflare:*", "node:*"],
+      conditions: ["workerd", "worker", "browser"],
+      platform: "neutral",
+    });
+    expect(r.code).toMatch(/from "cloudflare:workers"/);
+    expect(r.code).toMatch(/from "node:fs"/);
+    expect(r.code).toContain('"workerd"');
+    expect(r.code).not.toContain('"browser"');
+    expect(r.map.sources).toEqual(
+      expect.arrayContaining([
+        "~/src/worker.ts",
+        "~/src/util.ts",
+        "~/src/helper.ts",
+        "npm:dual@1.0.0/w.js",
+      ]),
+    );
+  });
+
+  it("node_modules first, then the registry; unresolvable imports are esbuild errors", async () => {
+    const files = await filesOf({
+      "/package.json": JSON.stringify({ dependencies: { "cjs-pkg": "2" } }),
+      "/src/main.js":
+        'import local from "local";\nimport cjs from "cjs-pkg";\nexport const out = local + cjs.shout("a");\n',
+      "/node_modules/local/package.json": JSON.stringify({ name: "local", version: "0.1.0" }),
+      "/node_modules/local/index.js": 'export default "local:";\n',
+    });
+    const { source, loads } = fakeRegistry({ "cjs-pkg": CJS_PKG });
+    const packages = chainPackages(nodeModulesPackages(), npmPackages({ source }));
+    const r = await bundle({ esbuild, files, entry: "/src/main.js", packages });
+    expect((await run(r.code)).out).toBe("local:A!");
+    expect(loads).toEqual(["cjs-pkg@2"]);
+
+    await files.write("/src/bad.js", [enc.encode('import "nowhere";\n')]);
+    await expect(bundle({ esbuild, files, entry: "/src/bad.js", packages })).rejects.toThrow(
+      /Could not resolve "nowhere"/,
+    );
+  });
+
+  it("host modules (by name or function) and inject; their lines map to virtual:<specifier>", async () => {
+    const files = await filesOf({
+      "/src/main.ts":
+        'import { env } from "cloudflare:workers";\nimport { join } from "node:path";\nimport { tag } from "./tag.ts";\nexport const out = [env.NAME, join("a", "b"), tag, new Response("r").kind];\n',
+      "/src/tag.ts": 'export const tag: string = "tag";\n',
+      "/src/shim.ts":
+        'export class Response { kind = "shimmed"; constructor(public body: string) {} }\n',
+    });
+    const r = await bundle({
+      esbuild,
+      files,
+      entry: "/src/main.ts",
+      modules: (spec) =>
+        spec === "cloudflare:workers"
+          ? 'export const env = { NAME: "host-env" };\n'
+          : spec.startsWith("node:")
+            ? `export const join = (...p) => p.join("/") + ${JSON.stringify(`<${spec}>`)};\n`
+            : undefined,
+      inject: ["/src/shim.ts"],
+    });
+    expect((await run(r.code)).out).toEqual(["host-env", "a/b<node:path>", "tag", "shimmed"]);
+    expect(r.map.sources).toEqual(
+      expect.arrayContaining([
+        "virtual:cloudflare:workers",
+        "virtual:node:path",
+        "~/src/main.ts",
+        "~/src/shim.ts",
+      ]),
+    );
+    // a record works too, and an unknown specifier still resolves as usual
+    const r2 = await bundle({
+      esbuild,
+      files,
+      entry: "/src/main.ts",
+      modules: {
+        "cloudflare:workers": "export const env = { NAME: 1 };\n",
+        "node:path": "export const join = () => 2;\n",
+      },
+    });
+    expect((await run(r2.code)).out.slice(0, 3)).toEqual([1, 2, "tag"]);
+  });
+
+  it("pnpm layouts: a package's own dependencies come from node_modules/.pnpm/node_modules", async () => {
+    const files = await filesOf({
+      "/app/main.js": 'import { a } from "a";\nexport const out = a;\n',
+      // node_modules/a is a symlink into .pnpm in a real install; its dependency b is only
+      // next to a's real directory, reachable through pnpm's hoisted links.
+      "/app/node_modules/a/package.json": JSON.stringify({ name: "a", version: "1.0.0" }),
+      "/app/node_modules/a/index.js": 'import { b } from "b";\nexport const a = "a+" + b;\n',
+      "/app/node_modules/.pnpm/node_modules/b/package.json": JSON.stringify({
+        name: "b",
+        version: "4.0.0",
+      }),
+      "/app/node_modules/.pnpm/node_modules/b/index.js": 'export const b = "b";\n',
+    });
+    const r = await bundle({ esbuild, files, root: "/app", entry: "/main.js" });
+    expect((await run(r.code)).out).toBe("a+b");
+    expect(r.map.sources).toContain("npm:b@4.0.0/index.js");
+  });
+
+  it("inline maps: the bundle carries its own map", async () => {
+    const files = await filesOf({ "/a.ts": "export const a: number = 1; // MARK_A\n" });
+    const r = await bundle({ esbuild, files, entry: "/a.ts", sourcemap: "inline" });
+    const b64 = /sourceMappingURL=data:application\/json;base64,(\S+)/.exec(r.code)?.[1];
+    expect(
+      JSON.parse(
+        new TextDecoder().decode(Uint8Array.from(atob(b64 as string), (c) => c.charCodeAt(0))),
+      ),
+    ).toEqual(r.map);
+  });
+});
+
+describe("transpile", () => {
+  it("one file, its map back to it; await lowered when asked", async () => {
+    const src =
+      "type T = number;\n\nexport async function f(x: T) {\n  return (await x) + 1 + 'MARK_F'.length * 0;\n}\n";
+    const r = await transpile(src, { esbuild, path: "~/src/f.ts", lowerAwait: true });
+    expect(r.code).not.toMatch(/\bawait\b/);
+    expect(trace(r.code, r.map, "MARK_F")).toEqual({ source: "~/src/f.ts", line: 4 });
+    expect(r.code).toMatch(/\/\/# sourceMappingURL=f\.js\.map\n$/);
+  });
+});