Mokup v1 迁移指南

本文档汇总了本次 breaking change 升级需要关注的点。

1. Node.js 版本要求

所有公开包现在都要求：

^20.19.0 || >=22.12.0

低于这个范围的 Node.js 版本不再支持。

所有已发布包现在只提供 ESM 输出。

受影响示例：

const mokup = require('mokup')

这类 CommonJS require() 用法不再受支持，需要改为 ESM：

import mokup from 'mokup'

旧入口：

import { build } from '@mokup/shared/esbuild'

现在应直接改为：

import { build } from '@mokup/shared/rolldown'

当前仓库内部统一使用 @mokup/shared/rolldown 的 build() 能力，底层实现已经切到 Rolldown。

已发布包的构建链已经从 unbuild / tsup 切换为 tsdown。

如果你在仓库内扩展包配置，应该优先使用：

而不是旧的 build.config.ts、tsup 或 unbuild 配置。

当前仓库已经完成以下迁移：