Skip to content

Commit 847f786

Browse files
fengmk2fengmk2
committed
docs(core): sync BUNDLING.md with relocated @rolldown/pluginutils
Rolldown 1.0.1 moved @rolldown/pluginutils out of its monorepo into a standalone npm package (rolldown/plugins). In our checkout it shows up hoisted under `rolldown/packages/rolldown/node_modules/@rolldown/ pluginutils`, with `.mjs` / `.d.mts` outputs. Update BUNDLING.md to match what the build actually does now: - source location (top-of-doc table + "Source Directories" table + rolldownPluginUtilsDir code constant) - bundleRolldownPluginutils input path - emitted output structure (.js/.d.ts -> .mjs/.d.mts) - exports table extensions No code change — same content as packages/core/build.ts and packages/core/package.json already reference.
1 parent d3d180e commit 847f786

1 file changed

Lines changed: 22 additions & 19 deletions

File tree

‎packages/core/BUNDLING.md‎

Lines changed: 22 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,13 @@ This document explains how `@voidzero-dev/vite-plus-core` bundles multiple upstr
66

77
The core package uses a **multi-project bundling strategy** that combines 5 upstream projects:
88

9-
| Project | Source Location | Purpose |
10-
| ----------------------- | ------------------------------- | ------------------------- |
11-
| `@rolldown/pluginutils` | `rolldown/packages/pluginutils` | Rolldown plugin utilities |
12-
| `rolldown` | `rolldown/packages/rolldown` | Rolldown bundler |
13-
| `vite` | `vite/packages/vite` | Vite v8 beta |
14-
| `tsdown` | `node_modules/tsdown` | TypeScript build tool |
15-
| `vitepress` | `node_modules/vitepress` | Documentation tool |
9+
| Project | Source Location | Purpose |
10+
| ----------------------- | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
11+
| `@rolldown/pluginutils` | `rolldown/packages/rolldown/node_modules/@rolldown/pluginutils` | Rolldown plugin utilities (standalone npm package, hoisted under the rolldown workspace) |
12+
| `rolldown` | `rolldown/packages/rolldown` | Rolldown bundler |
13+
| `vite` | `vite/packages/vite` | Vite v8 beta |
14+
| `tsdown` | `node_modules/tsdown` | TypeScript build tool |
15+
| `vitepress` | `node_modules/vitepress` | Documentation tool |
1616

1717
This approach enables users to access Vite, Rolldown, and related tools through a single package with consistent module specifier rewrites.
1818

@@ -32,7 +32,7 @@ await cp(join(rolldownPluginUtilsDir, 'dist'), join(projectDir, 'dist', 'pluginu
3232
});
3333
```
3434

35-
**Input**: `rolldown/packages/pluginutils/dist/`
35+
**Input**: `rolldown/packages/rolldown/node_modules/@rolldown/pluginutils/dist/`
3636
**Output**: `dist/pluginutils/`
3737

3838
### Step 2: Bundle Rolldown (`bundleRolldown`)
@@ -221,8 +221,8 @@ The original `require("some-cjs-package")` calls are rewritten to `require("./np
221221
```
222222
dist/
223223
├── pluginutils/ # @rolldown/pluginutils
224-
│ ├── index.js
225-
│ ├── index.d.ts
224+
│ ├── index.mjs
225+
│ ├── index.d.mts
226226
│ └── filter/
227227
├── rolldown/ # Rolldown bundler
228228
│ ├── index.mjs
@@ -279,21 +279,21 @@ dist/
279279
| `./rolldown/parallelPlugin` | `./dist/rolldown/parallel-plugin.mjs` | Parallel plugin support |
280280
| `./rolldown/parseAst` | `./dist/rolldown/parse-ast-index.mjs` | AST parsing |
281281
| `./rolldown/plugins` | `./dist/rolldown/plugins-index.mjs` | Built-in plugins |
282-
| `./rolldown/pluginutils` | `./dist/pluginutils/index.js` | Plugin utilities |
283-
| `./rolldown/pluginutils/filter` | `./dist/pluginutils/filter/index.js` | Filter utilities |
282+
| `./rolldown/pluginutils` | `./dist/pluginutils/index.mjs` | Plugin utilities |
283+
| `./rolldown/pluginutils/filter` | `./dist/pluginutils/filter/index.mjs` | Filter utilities |
284284
| `./types/*` | `./dist/vite/types/*` | Type definitions |
285285
286286
---
287287
288288
## Source Directories
289289
290-
| Upstream Project | Source Location | Relation |
291-
| ----------------------- | ------------------------------------- | -------------- |
292-
| `@rolldown/pluginutils` | `../../rolldown/packages/pluginutils` | Git submodule |
293-
| `rolldown` | `../../rolldown/packages/rolldown` | Git submodule |
294-
| `vite` | `../../vite/packages/vite` | Git submodule |
295-
| `tsdown` | `node_modules/tsdown` | npm dependency |
296-
| `vitepress` | `node_modules/vitepress` | npm dependency |
290+
| Upstream Project | Source Location | Relation |
291+
| ----------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
292+
| `@rolldown/pluginutils` | `../../rolldown/packages/rolldown/node_modules/@rolldown/pluginutils` | Hoisted under the rolldown workspace's `node_modules` (standalone npm package since rolldown 1.0.1) |
293+
| `rolldown` | `../../rolldown/packages/rolldown` | Git submodule |
294+
| `vite` | `../../vite/packages/vite` | Git submodule |
295+
| `tsdown` | `node_modules/tsdown` | npm dependency |
296+
| `vitepress` | `node_modules/vitepress` | npm dependency |
297297
298298
---
299299
@@ -386,6 +386,9 @@ const rolldownPluginUtilsDir = resolve(
386386
'..',
387387
'rolldown',
388388
'packages',
389+
'rolldown',
390+
'node_modules',
391+
'@rolldown',
389392
'pluginutils',
390393
);
391394
const rolldownSourceDir = resolve(projectDir, '..', '..', 'rolldown', 'packages', 'rolldown');

0 commit comments

Comments
 (0)