fix(unplugin-typegpu): expose built artifacts via $built$ exports

[mvanhorn]

Summary

Adds $built$ sibling entries to the dev exports map in packages/unplugin-typegpu/package.json so consumers can opt into the compiled dist/*.js artifacts instead of the raw TypeScript source. Every existing subpath (., rollup, babel, bun, esbuild, farm, rolldown, rolldown-browser, rspack, vite, webpack) gains a matching <subpath>/$built$ entry resolving to ./dist/<name>.js (and ./dist/<name>.d.ts for types). The original ./src/*.ts entries are left untouched, and publishConfig.exports is unchanged.

This mirrors the exact mechanism already used by the sibling typegpu package, which exposes $built$ variants of each export pointing at its compiled dist output.

Why this matters

Today the dev exports map points every subpath directly at ./src/*.ts. When the package is consumed outside the dev/monorepo resolution (or when a consumer simply wants the compiled output), there is no way to opt into the built artifacts, so the raw .ts source is imported. Issue #2605 requests exactly this, and the maintainer confirmed the direction:

"We could use the same mechanism we use for the typegpu package, and expose the built package artifacts under unplugin-typegpu/babel/$built$."

Testing

• package.json remains valid JSON.
• pnpm --filter unplugin-typegpu build (tsdown) produces every referenced dist file; no $built$ entry points at a non-existent artifact (all 11 subpaths cross-checked against the tsdown entry list).
• Runtime resolution verified: require('unplugin-typegpu/babel/$built$') resolves to the compiled ./dist/babel.js.
• pnpm --filter unplugin-typegpu test:types passes; oxlint and oxfmt --check report no issues on the changed file.

Fixes #2605

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds explicit “built” export subpaths for unplugin-typegpu so consumers can import precompiled JS + .d.ts from dist/ alongside the existing TS source exports.

Changes:

• Added ./$built$ export entries for the main entry and each bundler integration (rollup, vite, webpack, etc.)
• Each new built export maps types to dist/*.d.ts and runtime to dist/*.js

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[pullfrog]

✅ No new issues found.

Reviewed changes — adds $built$ sibling entries to the dev exports map so consumers can opt into compiled artifacts, matching the mechanism already used by the typegpu package.

• Add $built$ export subpaths for all 11 entry points — each existing subpath (., rollup, babel, bun, esbuild, farm, rolldown, rolldown-browser, rspack, vite, webpack) gains a matching <subpath>/$built$ entry pointing at ./dist/<name>.js and ./dist/<name>.d.ts.
• Original source exports and publishConfig.exports untouched — only the dev exports map is extended.

  ^{｜ View workflow run ｜ Using DeepSeek Pro (free via Pullfrog for OSS) ｜ 𝕏}

[iwoplaza]

The exports only include the ESM export, I'd like them to export both the ESM and CJS exports, just like the published package

[mvanhorn]

Done in f201454 - each $built$ export now provides explicit import (ESM) and require (CJS) conditions, matching the published package layout. Verified with a local tsdown build that dist emits .cjs/.d.cts alongside .js/.d.ts for every subpath.

[pullfrog]

✅ No new issues found.

Reviewed changes — the new commit revises the dev $built$ exports to use nested import/require conditions, addressing the prior reviewer feedback that only ESM was exposed.

• Update $built$ exports to support both ESM and CJS — every $built$ subpath now resolves ESM to ./dist/<name>.js + ./dist/<name>.d.ts and CJS to ./dist/<name>.cjs + ./dist/<name>.d.cts, matching the published publishConfig.exports layout.
• Preserve source exports and publish config — the existing ./src/*.ts dev entries and the published publishConfig.exports map remain unchanged.

  ^{｜ View workflow run ｜ Using Kimi K2 (free via Pullfrog for OSS) ｜ 𝕏}

[pullfrog]

✅ No new issues found.

Reviewed changes — the latest commit adds a catch-all default condition to every $built$ dev export and a clarifying comment in the bundler config.

• Added default fallback to each $built$ entry — after the ESM and CJS conditions, every subpath now maps default to ./dist/<name>.js.
• Added a workspace-only marker comment in tsdown.config.ts — explains that $built$ is replaced before publish.

  ^{｜ Fix it ➔ ｜ View workflow run ｜ Using Kimi K2 (free via Pullfrog for OSS) ｜ 𝕏}