Rollup：从静态 ESM 图生成可发布的库产物

export function virtualBuildInfo() {
  const virtualId = 'virtual:build-info';
  const resolvedId = '\0virtual:build-info';

  return {
    name: 'virtual-build-info',
    resolveId(source) {
      if (source === virtualId) return resolvedId;
      return null;
    },
    load(id) {
      if (id === resolvedId) {
        return 'export const builtAt = "2026-07-08";';
      }
      return null;
    },
    transform(code, id) {
      if (!id.endsWith('.ts')) return null;
      return { code, map: null };
    },
    moduleParsed(info) {
      if (info.isEntry) this.warn(`entry: ${info.id}`);
    },
  };
}

function manifest() {
  return {
    name: 'manifest',
    generateBundle(_options, bundle) {
      const entries = {};

      for (const chunk of Object.values(bundle)) {
        if (chunk.type !== 'chunk' || !chunk.facadeModuleId) continue;
        entries[toSourceName(chunk.facadeModuleId)] = {
          file: chunk.fileName,
          src: toSourceName(chunk.facadeModuleId),
          isEntry: chunk.isEntry,
          isDynamicEntry: chunk.isDynamicEntry,
        };
      }

      this.emitFile({
        type: 'asset',
        fileName: 'manifest.json',
        source: `${JSON.stringify(entries, null, 2)}\n`,
      });
    },
  };
}

// catalog.ts
export const removableMarker = 'SHOULD_NOT_REACH_BUNDLE';

// side-effect.ts
globalThis.__BUILD_TOOLS_SIDE_EFFECT__ = 'preserved';

export default {
  treeshake: {
    moduleSideEffects: true,
  },
};

import pkg from './package.json' with { type: 'json' };

const peerNames = new Set(Object.keys(pkg.peerDependencies ?? {}));

export default {
  input: {
    index: 'src/index.ts',
    button: 'src/button.ts',
  },
  external(id) {
    const name = id.startsWith('@')
      ? id.split('/').slice(0, 2).join('/')
      : id.split('/')[0];
    return peerNames.has(name);
  },
  output: [
    { dir: 'dist/es', format: 'es', sourcemap: true },
    { dir: 'dist/cjs', format: 'cjs', sourcemap: true, exports: 'named' },
  ],
};

export default {
  input: {
    index: 'src/index.ts',
    'components/button': 'src/components/button.ts',
  },
  output: [
    {
      dir: 'dist/es',
      format: 'es',
      entryFileNames: '[name].js',
      sourcemap: true,
    },
    {
      dir: 'dist/cjs',
      format: 'cjs',
      entryFileNames: '[name].cjs',
      sourcemap: true,
    },
  ],
};

{
  "type": "module",
  "exports": {
    ".": {
      "import": "./dist/es/index.js",
      "require": "./dist/cjs/index.cjs",
      "types": "./dist/types/index.d.ts"
    },
    "./components/button": {
      "import": "./dist/es/components/button.js",
      "require": "./dist/cjs/components/button.cjs",
      "types": "./dist/types/components/button.d.ts"
    }
  }
}

button.addEventListener('click', async () => {
  const { renderDetail } = await import('./detail.ts');
  renderDetail(detail, tool);
});

export default {
  output: {
    manualChunks(id) {
      if (id.includes('node_modules')) return 'vendor';
      if (id.endsWith('/src/detail.ts')) return 'detail';
      return null;
    },
  },
};

export default {
  plugins: [
    typescript({ compilerOptions: { sourceMap: true, target: 'ES2022' } }),
    postcss({ extract: 'assets/styles.css', minimize: true, sourceMap: true }),
    terser(),
  ],
  output: {
    sourcemap: true,
  },
};

function htmlTemplate(templateFile) {
  return {
    name: 'html-template',
    buildStart() {
      this.addWatchFile(templateFile);
    },
    generateBundle() {
      // 读取 templateFile 并 emit HTML。
    },
  };
}

// a.js
import { b } from './b.js';
export const a = b + 1;

// b.js
import { a } from './a.js';
export const b = a + 1; // 读取尚未初始化的 a，可能触发 TDZ 或 undefined 风险

pnpm --filter @roadmap/build-tools-slice build:rollup

examples/build-tools/src/main.ts
examples/build-tools/src/catalog.ts
examples/build-tools/src/detail.ts
examples/build-tools/src/side-effect.ts
examples/build-tools/src/styles.css

examples/build-tools/dist/rollup/index.html
examples/build-tools/dist/rollup/manifest.json
examples/build-tools/dist/rollup/assets/*.js
examples/build-tools/dist/rollup/assets/*.css
examples/build-tools/dist/rollup/assets/*.js.map
examples/build-tools/dist/rollup/assets/*.css.map

find examples/build-tools/dist/rollup -type f | sort
node --test --test-name-pattern rollup examples/build-tools/test/artifacts.test.mjs