@icebreakers/monorepo 3.1.17 → 3.2.0

package/templates/apps/website/why/examples/3.npm-basic-package/package.json

@@ -1,32 +0,0 @@
-{
-  "name": "icebreaker-npm-basic-package",
-  "type": "module",
-  "version": "1.0.5",
-  "description": "",
-  "author": "",
-  "license": "ISC",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs"
-    }
-  },
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "dev": "unbuild --stub",
-    "build:watch": "tsup --watch --sourcemap",
-    "build": "tsup"
-  },
-  "devDependencies": {
-    "tsup": "^8.5.0",
-    "tsx": "^4.19.4",
-    "typescript": "^5.8.3",
-    "unbuild": "^3.5.0"
-  }
-}

package/templates/apps/website/why/examples/3.npm-basic-package/src/index.ts

@@ -1,8 +0,0 @@
-/* eslint-disable no-console */
-export function sayHello() {
-  const message = 'hello world typescript'
-  console.log(message)
-  return message
-}
-
-console.log(`load package icebreaker-npm-basic-package`)

package/templates/apps/website/why/examples/3.npm-basic-package/tsconfig.json

@@ -1,16 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ESNext",
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "resolveJsonModule": true,
-    "allowJs": true,
-    "strict": true,
-    "allowSyntheticDefaultImports": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true
-  },
-  "include": [
-    "src"
-  ]
-}

package/templates/apps/website/why/examples/3.npm-basic-package/tsup.config.ts

@@ -1,16 +0,0 @@
-import { defineConfig } from 'tsup'
-
-export default defineConfig({
-  entry: ['src/index.ts'],
-  shims: true,
-  format: ['cjs', 'esm'],
-  clean: true,
-  dts: true,
-  cjsInterop: true,
-  splitting: true,
-  outExtension({ format }) {
-    return {
-      js: `.${format === 'esm' ? 'mjs' : 'cjs'}`,
-    }
-  },
-})

package/templates/apps/website/why/examples/usage-cjs/cjs.cjs

@@ -1,4 +0,0 @@
-/* eslint-disable no-console */
-console.log(__dirname)
-console.log(import.meta.dirname)
-console.log(require)

package/templates/apps/website/why/examples/usage-cjs/esm.mjs

@@ -1,4 +0,0 @@
-/* eslint-disable no-console */
-console.log(__dirname)
-console.log(import.meta.dirname)
-console.log(require)

package/templates/apps/website/why/examples/usage-cjs/index.js

@@ -1,12 +0,0 @@
-/* eslint-disable no-console */
-// import c from 'chalk'
-// const c = require('chalk')
-const { sayHello } = require('icebreaker-npm-basic-package')
-const { sayHello: sayHelloCjs } = require('icebreaker-npm-basic-package-multiple-exports')
-
-sayHello()
-sayHelloCjs()
-
-import('chalk').then(({ default: c }) => {
-  console.log(c.green('Hello World!'))
-})

package/templates/apps/website/why/examples/usage-cjs/package-lock.json

@@ -1,42 +0,0 @@
-{
-  "name": "usage-cjs",
-  "version": "1.0.0",
-  "lockfileVersion": 3,
-  "requires": true,
-  "packages": {
-    "": {
-      "name": "usage-cjs",
-      "version": "1.0.0",
-      "license": "ISC",
-      "dependencies": {
-        "chalk": "^5.6.2",
-        "icebreaker-npm-basic-package": "^1.0.5",
-        "icebreaker-npm-basic-package-multiple-exports": "^0.0.0"
-      }
-    },
-    "node_modules/chalk": {
-      "version": "5.6.2",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz",
-      "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==",
-      "license": "MIT",
-      "engines": {
-        "node": "^12.17.0 || ^14.13 || >=16.0.0"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/chalk?sponsor=1"
-      }
-    },
-    "node_modules/icebreaker-npm-basic-package": {
-      "version": "1.0.5",
-      "resolved": "https://registry.npmjs.org/icebreaker-npm-basic-package/-/icebreaker-npm-basic-package-1.0.5.tgz",
-      "integrity": "sha512-tWDfJzIKb61L1hTM25dtjgBi1vljZZc16ummy5MqGEpCxf8eQAVLq3ZPq9TbHn0+pAXN2+OlFBBpPTvZuP/wUg==",
-      "license": "ISC"
-    },
-    "node_modules/icebreaker-npm-basic-package-multiple-exports": {
-      "version": "0.0.0",
-      "resolved": "https://registry.npmjs.org/icebreaker-npm-basic-package-multiple-exports/-/icebreaker-npm-basic-package-multiple-exports-0.0.0.tgz",
-      "integrity": "sha512-JZh7KXHzUsS9JlqOa0bjTM1i3xwAGHp3JBmK/kApZmZx7It8HfpE5vY98EAdjOHfVcCHKzJc24tkR1t2dv2dvA==",
-      "license": "ISC"
-    }
-  }
-}

package/templates/apps/website/why/examples/usage-cjs/package.json

@@ -1,20 +0,0 @@
-{
-  "name": "usage-cjs",
-  "version": "1.0.0",
-  "private": true,
-  "description": "",
-  "author": "",
-  "license": "ISC",
-  "keywords": [],
-  "main": "index.js",
-  "scripts": {
-    "start": "node .",
-    "esm": "node esm.mjs",
-    "cjs": "node cjs.cjs"
-  },
-  "dependencies": {
-    "chalk": "^5.6.2",
-    "icebreaker-npm-basic-package": "^1.0.5",
-    "icebreaker-npm-basic-package-multiple-exports": "^0.0.0"
-  }
-}

package/templates/apps/website/why/examples/usage-esm/cjs.cjs

@@ -1,4 +0,0 @@
-/* eslint-disable no-console */
-console.log(__dirname)
-console.log(import.meta.dirname)
-console.log(require)

package/templates/apps/website/why/examples/usage-esm/createRequire.js

@@ -1,7 +0,0 @@
-import { createRequire } from 'node:module'
-
-const require = createRequire(import.meta.filename)
-
-const { sayHello } = require('icebreaker-npm-basic-package')
-
-sayHello()

package/templates/apps/website/why/examples/usage-esm/esm.mjs

@@ -1,4 +0,0 @@
-/* eslint-disable no-console */
-console.log(__dirname)
-console.log(import.meta.dirname)
-console.log(require)

package/templates/apps/website/why/examples/usage-esm/index.js

@@ -1,8 +0,0 @@
-/* eslint-disable no-console */
-import c from 'chalk'
-import { sayHello } from 'icebreaker-npm-basic-package'
-import { sayHello as sayHello2 } from 'icebreaker-npm-basic-package-multiple-exports'
-
-sayHello()
-sayHello2()
-console.log(c.green('Hello World!'))

package/templates/apps/website/why/examples/usage-esm/package-lock.json

@@ -1,42 +0,0 @@
-{
-  "name": "usage-esm",
-  "version": "1.0.0",
-  "lockfileVersion": 3,
-  "requires": true,
-  "packages": {
-    "": {
-      "name": "usage-esm",
-      "version": "1.0.0",
-      "license": "ISC",
-      "dependencies": {
-        "chalk": "^5.6.2",
-        "icebreaker-npm-basic-package": "1.0.5",
-        "icebreaker-npm-basic-package-multiple-exports": "^0.0.0"
-      }
-    },
-    "node_modules/chalk": {
-      "version": "5.6.2",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz",
-      "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==",
-      "license": "MIT",
-      "engines": {
-        "node": "^12.17.0 || ^14.13 || >=16.0.0"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/chalk?sponsor=1"
-      }
-    },
-    "node_modules/icebreaker-npm-basic-package": {
-      "version": "1.0.5",
-      "resolved": "https://registry.npmjs.org/icebreaker-npm-basic-package/-/icebreaker-npm-basic-package-1.0.5.tgz",
-      "integrity": "sha512-tWDfJzIKb61L1hTM25dtjgBi1vljZZc16ummy5MqGEpCxf8eQAVLq3ZPq9TbHn0+pAXN2+OlFBBpPTvZuP/wUg==",
-      "license": "ISC"
-    },
-    "node_modules/icebreaker-npm-basic-package-multiple-exports": {
-      "version": "0.0.0",
-      "resolved": "https://registry.npmjs.org/icebreaker-npm-basic-package-multiple-exports/-/icebreaker-npm-basic-package-multiple-exports-0.0.0.tgz",
-      "integrity": "sha512-JZh7KXHzUsS9JlqOa0bjTM1i3xwAGHp3JBmK/kApZmZx7It8HfpE5vY98EAdjOHfVcCHKzJc24tkR1t2dv2dvA==",
-      "license": "ISC"
-    }
-  }
-}

package/templates/apps/website/why/examples/usage-esm/package.json

@@ -1,21 +0,0 @@
-{
-  "name": "usage-esm",
-  "type": "module",
-  "version": "1.0.0",
-  "private": true,
-  "description": "",
-  "author": "",
-  "license": "ISC",
-  "keywords": [],
-  "main": "index.js",
-  "scripts": {
-    "start": "node .",
-    "esm": "node esm.mjs",
-    "cjs": "node cjs.cjs"
-  },
-  "dependencies": {
-    "chalk": "^5.6.2",
-    "icebreaker-npm-basic-package": "1.0.5",
-    "icebreaker-npm-basic-package-multiple-exports": "^0.0.0"
-  }
-}

package/templates/apps/website/why/how-to-reuse-js-code.md

@@ -1,250 +0,0 @@
----
-outline: [2, 4]
----
-
-# 如何复用 js 代码
-
-我们知道，不论在什么编程语言里，复用代码最简单的方案就是 `复制粘贴`
-
-然而，复制粘贴会导致代码冗余、难以维护，修改一处逻辑时易漏改其它处，增加出错概率，违背“不要重复自己”（DRY）原则。
-
-假如人人写代码都复制粘贴，这会造成一个工程化的地狱，后期维护成本急剧升高。
-
-为此我们需要有效利用 `模块化` 的思路，去提炼，拆分，复用我们写的代码。
-
-## **代码的模块化**
-
-在现代 `JavaScript` 开发中，**模块化**不仅是一种组织代码的结构化方式，更是实现高效代码复用的核心前提。
-
-### 模块化是复用的基础
-
-1. **明确边界，职责单一**
-   模块化将一个大程序拆分为职责清晰、相互独立的功能块（模块）。每个模块完成一个单一任务，这种**高内聚、低耦合**的结构，为复用提供了天然的土壤。
-
-2. **清晰的导入导出机制**
-   通过标准的 `export` 和 `import`（或 `CommonJS` 的 `module.exports` / `require`），开发者可以在不同文件、不同项目中复用相同模块，而无需复制粘贴代码。
-
-3. **便于维护与测试**
-   模块是可单独测试、维护的最小单元。模块化设计使得一个功能变化不会影响其他模块，增强了系统的稳定性和可扩展性。
-
-4. **为构建通用库打下基础**
-   工具函数库（如 `lodash/es-toolkit`）、业务中间件、配置模块、数据处理逻辑等，都是基于模块化原则设计的。只有当代码被封装为模块，它才可能被提取、封装、共享、发布。
-
-### 模块化让复用从被动到主动
-
-非模块化时代的“复用”往往是：
-
-- 复制粘贴代码
-- 修改适配不同上下文
-
-而模块化之后，“复用”变成了：
-
-- 明确接口，按需引入
-- 参数化、配置化、可扩展
-
-这不仅是形式上的进步，更是软件工程层面的范式跃迁。
-
-### js 模块的典型格式
-
-- **ES Modules（现代浏览器/现代 Node.js）**：标准、推荐，使用 `import` / `export`
-- **CommonJS（传统 Node.js）**：使用 `require` / `module.exports`
-- **UMD / IIFE / SystemJS / AMD**：一些老式模块化兼容方案，仍用于一些库的打包格式
-
-#### ES Modules (ESM)
-
-目前大部分新的 `npm` 包都使用这个格式发包，
-
-它最大的特点是，使用 `export` / `import` 将功能函数、类、常量等分别放入独立 `.js` 文件中，动态引入的使用 `import()` 进行引入
-
-```js
-// utils/math.js
-export function add(a, b) {
-  return a + b
-}
-
-export function multiply(a, b) {
-  return a * b
-}
-```
-
-```js
-// main.js
-import { add, multiply } from './utils/math'
-
-console.log(add(2, 3)) // 5
-console.log(multiply(2, 3)) // 6
-```
-
-**这是目前的主流，也是未来的方向**
-
-注意事项：
-
-- 在浏览器中引入，需要使用 `<script type="module">`
-- 在 `Node.js` 中需要 `package.json` 设置 `"type": "module"`
-
----
-
-#### CommonJS (CJS)
-
-在 `ESM` 规范没有被确立之前的社区模块化方案，低版本 `Node.js` 环境使用，高版本 `Node.js` 同时兼容 `CJS` 和 `ESM` 2 种模块化方案和加载策略
-
-最大的特点为，使用 `require` / `module.exports`(`commonjs2`) / `exports`(`commonjs`) 进行模块化
-
-```js
-// utils/math.js
-function add(a, b) {
-  return a + b
-}
-module.exports = { add }
-```
-
-```js
-// app.js
-const { add } = require('./utils/math.js')
-
-console.log(add(5, 10))
-```
-
-新的包不会使用这个格式，目前这个格式的 `npm` 包，也正在逐步向 `ESM` 格式进行迁移
-
-#### AMD (Asynchronous Module Definition)
-
-AMD 是 RequireJS 推广的模块格式，支持异步加载模块，适用于浏览器。
-
-```js
-define('myLib', [], () => {
-  function hello() {
-    return 'Hello from AMD'
-  }
-
-  return {
-    hello
-  }
-})
-```
-
-**已经过时，不要使用!**
-
-#### UMD （Universal Module Definition）
-
-UMD 是为了同时兼容 CommonJS、AMD 和浏览器环境而设计的模块格式。
-
-```js
-(function (root, factory) {
-  if (typeof define === 'function' && define.amd) {
-    // AMD
-    define([], factory)
-  }
-  else if (typeof module === 'object' && module.exports) {
-    // CommonJS
-    module.exports = factory()
-  }
-  else {
-    // Browser global
-    root.myLib = factory()
-  }
-}(this, () => {
-  // 模块内容
-  function hello() {
-    return 'Hello from UMD'
-  }
-
-  return {
-    hello
-  }
-}))
-```
-
-通常在你使用 `vite` 的 `lib` 模式的时候，除了会打一个 `ESM` 包之外，也会打一个 `UMD` 的包，用于 `CDN` + `SSR` 场景下使用。
-
-#### IIFE （Immediately Invoked Function Expression）
-
-IIFE 是立即执行函数表达式，常用于浏览器中，通常暴露到 `window` 上（无模块系统时的“模拟模块”方式）。
-
-https://developer.mozilla.org/en-US/docs/Glossary/IIFE
-
-```js
-(function () {
-  function hello() {
-    console.log('Hello from IIFE')
-  }
-
-  // 暴露到全局
-  window.myLib = {
-    hello
-  }
-})()
-```
-
-#### SystemJS / System.register
-
-`System` 是由 `ES6 Module Loader` 提出的一种格式，现代打包工具（如 `Rollup`）可以输出此格式，用于运行时动态加载 `ES Modules`。
-
-`SystemJS` 就是帮助你在不支持原生 `ESM` 格式的浏览器上(比如IE11)，使用 `ESM` 格式
-
-```js
-System.register(['./constants'], (exports) => {
-  return {
-    execute() {
-      function hello() {
-        console.log('Hello from System')
-      }
-
-      exports('hello', hello)
-    }
-  }
-})
-```
-
-加载方式（需要 `SystemJS` 库）：
-
-```html
-<script src="https://cdn.jsdelivr.net/npm/systemjs/dist/system.js"></script>
-<script>
-  System.import('/path/to/your-module.js').then(({ hello }) => hello())
-</script>
-```
-
-比如 `@vitejs/plugin-legacy` 这个浏览器降级兼容方案，就是使用 `SystemJS` 在老旧的浏览器里面，加载 `ESM` 格式，从而进行兼容的。
-
-#### 参考链接
-
-- [rollupjs](https://rollupjs.org/configuration-options/#output-format)
-- [webpackjs](https://webpack.js.org/configuration/output/#module-definition-systems-1)
-- [esbuild](https://esbuild.github.io/api/#format)
-- [swc](https://swc.rs/docs/configuration/modules)
-- [babel](https://babeljs.io/docs/babel-preset-env#modules)
-- [typescript](https://www.typescriptlang.org/tsconfig/#module)
-
-## 一些复用方式
-
-### **利用路径 alias 复用代码**
-
-在纯 JS 工程中，如果使用构建工具如 Vite / Webpack，可以配置别名路径：
-
-```js
-// vite.config.js
-export default {
-  resolve: {
-    alias: {
-      '@utils': path.resolve(__dirname, 'src/utils')
-    }
-  }
-}
-```
-
-然后在代码中：
-
-```js
-import { add } from '@utils/math.js'
-```
-
-但是这种方式，仅在构建工具中生效，假如一个项目不用任何的构建工具，这个方案就不行了。
-
-### **发布为 npm 本地包 / 私有包 / 公共包**
-
-绝大部的场景都应该使用这个方案，来达到跨项目复用代码的目的。
-
-这也是官方和社区推荐的方案。
-
-接下来让我们开始 `npm` 包发布的旅程吧！

package/templates/apps/website/why/index.md

@@ -1 +0,0 @@
-# 从 0 到 1 构建 monorepo

package/templates/apps/website/why/js-cjs-mjs.md

@@ -1,99 +0,0 @@
-# js 文件的各种后缀
-
-下面用一张“速查表”+要点说明，把这些扩展名分别讲清楚，并说明各自**在什么情况下会被当作可执行模块加载**，以及**谁来消费它**。
-
-## 速查表
-
-| 扩展名  | 语义                                               | 由谁执行/消费                                        | 何时被当作“可运行的模块”加载                                                                                                                                                                                                      |
-| ------- | -------------------------------------------------- | ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `.js`   | JavaScript 源码（CJS 或 ESM，取决于上下文）        | Node、浏览器、打包器                                 | **Node**：受 `package.json` 的 `"type"` 影响——`"type":"module"` 时按 **ESM** 解析，否则按 **CommonJS**。**浏览器**：始终当作 JS，是否是模块取决于 `<script type="module">`（ESM）还是普通 `<script>`（经典脚本）。                |
-| `.cjs`  | JavaScript（**强制 CommonJS**）                    | Node、打包器                                         | **Node**：始终按 **CommonJS** 加载，与 `package.json` 的 `"type"` 无关。                                                                                                                                                          |
-| `.mjs`  | JavaScript（**强制 ESM**）                         | Node、浏览器、打包器                                 | **Node**：始终按 **ESM** 加载。**浏览器**：当作普通 JS 文件；是否作为模块取决于 `<script type="module">`。                                                                                                                        |
-| `.ts`   | TypeScript 源码（模块语义由编译目标/解析策略决定） | **TS 编译器/工具链**（tsc、ts-node、tsx、Vite 等）   | 不是原生可执行；需经编译或运行时加载器将其转成 `.js`。在 TS 的 `moduleResolution`=NodeNext/Node16 下，`.ts` 的产物会遵循对应的 CJS/ESM 规则。                                                                                     |
-| `.cts`  | TypeScript，**指定生成 CommonJS**                  | TS 编译器/工具链                                     | 同上；不由 Node 直接执行。编译后产出 `.cjs/.js`（CJS 语义），并可生成 `.d.cts`。                                                                                                                                                  |
-| `.mts`  | TypeScript，**指定生成 ESM**                       | TS 编译器/工具链                                     | 同上；不由 Node 直接执行。编译后产出 `.mjs/.js`（ESM 语义），并可生成 `.d.mts`。                                                                                                                                                  |
-| `.d.ts` | **类型声明文件**（仅类型，无运行时）               | TypeScript 编译器、编辑器/语言服务、打包器的类型阶段 | **永不执行**。仅在类型检查/智能提示/发布类型时被“读取”。若包的 `package.json` 有 `"types": "index.d.ts"`（或在 `exports` 的 `types`/ `typesVersions` 配置），TS 会用它做类型来源。也存在 `.d.mts` / `.d.cts` 变体以对应 ESM/CJS。 |
-
-# 关键规则与细节
-
-1. **Node.js 如何决定 CJS vs ESM（针对 `.js`）**
-   - 在某个包目录（有 `package.json`）下：
-     - `package.json` 有 `"type": "module"` → 该目录内的 **`.js`** 默认视作 **ESM**。
-     - 否则（默认 `"type":"commonjs"`）→ **`.js`** 默认视作 **CommonJS**。
-
-   - **`.mjs` 一律 ESM，`.cjs` 一律 CJS**，不受 `"type"` 影响。
-   - 混合项目的常见做法：`"type":"module"` + 把需要 CJS 的文件命名为 `.cjs`；或反之。
-
-2. **浏览器如何加载**
-   - 浏览器不关心 `.mjs/.cjs` 这些“Node 语义”扩展名本身；它看的是 `<script>` 标签：
-     - `<script type="module" src="...">` → ESM 模式（支持 `import`）。
-     - `<script src="...">` → 经典脚本（全局作用域，无模块语义）。
-
-   - 资源的 **MIME 类型** 需正确（如 `text/javascript`）；文件扩展名不是决定性因素。
-
-3. **TypeScript 文件（`.ts/.mts/.cts`）何时“会被加载”？**
-   - **Node 原生不会执行 TS**。你需要：
-     - 先用 **`tsc`** 编译为 `.js/.mjs/.cjs` 再由 Node 加载；或
-     - 使用运行时加载器/执行器（如 **ts-node、tsx、Bun** 或打包器 dev server）在内存里**即时转译**后再交给 JS 运行时执行。
-
-   - **`.mts` / `.cts` 的意义**：在 TS 4.7+ 的 `moduleResolution: "NodeNext"/"Node16"` 下，明确告知“这是要编译成 ESM/CJS 的 TS 文件”。这能避免仅用 `.ts` 时的二义性。
-   - 生成声明文件时会对应地产生 `.d.mts` / `.d.cts`。
-
-4. **`.d.ts`（与 `.d.mts/.d.cts`）何时被“读取”**
-   - **只在类型系统中使用**：编译（`tsc`）、编辑器智能提示、类型检查、`npm publish` 时作为类型入口。
-   - 定位方式：
-     - 包内 `package.json` 的 `"types"` / `"typings"` 字段；
-     - `exports` 的 `types`（或 `typesVersions`）；
-     - `typeRoots`、`types`、三斜线指令 `/// <reference types="...">`；
-     - `@types/*` 包（DefinitelyTyped）。
-
-   - **运行时绝不加载/执行**。
-
-5. **打包器（Vite、Webpack、Rollup、esbuild）**
-   - 都把 **`.mjs` 当 ESM**、**`.cjs` 当 CJS**。
-   - 会通过插件/内置加载 TS（把 `.ts/.mts/.cts` 转成 JS）。
-   - 会遵守 `exports`/`module`/`main`/`type` 等字段来选择入口与格式。
-   - 对于 Node 产物，常见是同时发布 ESM 与 CJS 两套构建（双包架构），并提供相应的 `.d.ts`。
-
-## 示例
-
-**Node + `"type":"module"` 情况：**
-
-```txt
-pkg/
-  package.json  // { "type": "module" }
-  index.js      // 按 ESM 解析
-  legacy.cjs    // 按 CJS 解析
-  util.mjs      // 按 ESM 解析
-```
-
-**TypeScript 在 NodeNext 下的布局：**
-
-```txt
-src/
-  index.mts     // 编译为 ESM（.mjs）；会配套生成 index.d.mts（若开启声明）
-  loader.cts    // 编译为 CJS（.cjs）；会配套生成 loader.d.cts
-  types.d.ts    // 仅类型，运行时不参与
-```
-
-**浏览器：**
-
-```html
-<!-- 经典脚本（非模块） -->
-<script src="/app.js"></script>
-
-<!-- ESM 模块 -->
-<script type="module" src="/main.js"></script>
-```
-
-## 实战建议
-
-- **库作者**：建议产出 **双格式**（CJS+ESM）与**类型声明**，并在 `package.json` 设置：
-  - `"type": "module"`（若以 ESM 为主），再提供 CJS 入口（`.cjs`）；
-  - 使用 `exports` 指定 `import`/`require` 条目与 `types`。
-
-- **应用作者**：统一风格更省心。若全量 ESM，就：
-  - `"type":"module"` + 统一 `.js/.mjs`（或 TS 中用 `.mts`）；
-  - 依赖里若有 CJS 包，让打包器或 Node 的兼容层处理。
-
-- **TS 工程**：用 **`moduleResolution: "NodeNext"`**，并用 `.mts/.cts` 明确产物语义；发布时别忘了 `.d.ts`/`.d.mts/.d.cts`。