UnJS
Logo of unbuild

unbuild

一个统一的 JavaScript 构建系统。

统一的 JavaScript 构建系统

📦 优化的打包工具

基于rollup的健壮打包工具，支持TypeScript，并生成CommonJS和模块格式以及类型声明。

🪄 自动化配置

自动从package.json中推断构建配置和入口。

📁 无捆绑构建

与mkdist集成，通过文件到文件转译生成无捆绑的dist文件。

✨ 被动监听器

使用jiti一次性生成dist，然后你就可以尝试链接你的项目，而无需在开发过程中持续监听和重建。

✍️ Untype 生成器

与untyped集成。

✔️ 安全构建

自动检查各种构建问题，例如潜在的缺失和未使用的依赖项，并使CI失败。

CLI输出还包括输出大小和导出，以便快速检查。

用法

创建src/index.ts

export const log = (...args) => {
  console.log(...args);
};

更新package.json

{
  "type": "module",
  "exports": {
    ".": {
      "import": "./dist/index.mjs",
      "require": "./dist/index.cjs"
    }
  },
  "main": "./dist/index.cjs",
  "types": "./dist/index.d.ts",
  "files": ["dist"]
}

注意 你可以在unjs/template中找到更完整的项目设置示例。

使用unbuild进行构建

npx unbuild

配置会自动从package.json中映射到src/目录的字段中推断。如需更多控制，请继续阅读下一节。

配置

创建build.config.ts

export default {
  entries: ["./src/index"],
};

你可以使用package.json中的unbuild键，或使用build.config.{js,cjs,mjs,ts,mts,cts,json}文件来指定配置。

查看选项此处。

示例

import { defineBuildConfig } from "unbuild";

export default defineBuildConfig({
  // If entries is not provided, will be automatically inferred from package.json
  entries: [
    // default
    "./src/index",
    // mkdist builder transpiles file-to-file keeping original sources structure
    {
      builder: "mkdist",
      input: "./src/package/components/",
      outDir: "./build/components",
    },
  ],

  // Change outDir, default is 'dist'
  outDir: "build",

  // Generates .d.ts declaration file
  declaration: true,
});

或者对于多个构建，你可以声明一个配置数组

import { defineBuildConfig } from "unbuild";

export default defineBuildConfig([
  {
    // If entries is not provided, will be automatically inferred from package.json
    entries: [
      // default
      "./src/index",
      // mkdist builder transpiles file-to-file keeping original sources structure
      {
        builder: "mkdist",
        input: "./src/package/components/",
        outDir: "./build/components",
      },
    ],

    // Change outDir, default is 'dist'
    outDir: "build",

    /**
     * * `compatible` means "src/index.ts" will generate "dist/index.d.mts", "dist/index.d.cts" and "dist/index.d.ts".
     * * `node16` means "src/index.ts" will generate "dist/index.d.mts" and "dist/index.d.cts".
     * * `true` is equivalent to `compatible`.
     * * `false` will disable declaration generation.
     * * `undefined` will auto detect based on "package.json". If "package.json" has "types" field, it will be `"compatible"`, otherwise `false`.
     */
    declaration: "compatible",
  },
  {
    name: "minified",
    entries: ["./src/index"],
    outDir: "build/min",
    rollup: {
      esbuild: {
        minify: true,
      },
    },
  },
]);

💻 开发

  • 克隆此仓库
  • 使用corepack enable启用Corepack（Node.js < 16.10 请使用npm i -g corepack）
  • 使用 pnpm install 安装依赖项
  • 使用 pnpm dev 运行交互式测试

许可

MIT