@icebreakers/monorepo-templates 1.0.0 → 1.0.2

package/templates/vitepress/why/examples/3.npm-basic-package/package.json

@@ -19,14 +19,13 @@
     "dist"
   ],
   "scripts": {
-    "dev": "unbuild --stub",
-    "build:watch": "tsup --watch --sourcemap",
-    "build": "tsup"
+    "dev": "tsdown --watch --sourcemap",
+    "build:watch": "tsdown --watch --sourcemap",
+    "build": "tsdown"
   },
   "devDependencies": {
-    "tsup": "^8.5.0",
+    "tsdown": "0.21.10",
     "tsx": "^4.19.4",
-    "typescript": "^5.8.3",
-    "unbuild": "^3.5.0"
+    "typescript": "^5.8.3"
   }
 }

package/templates/vitepress/why/examples/3.npm-basic-package/tsdown.config.ts

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

package/templates/vitepress/why/modern/bundlers.md

@@ -12,6 +12,17 @@
 
 当前这个仓库已经把通用类库模板收敛到 `tsdown`，组件库则继续使用 `vite` 库模式。
 
+## 过时的方案
+
+:::warning 不推荐继续使用
+`tsup` 和 `unbuild` 在这个模板仓库里已经被标记为过时方案，不再作为新项目的推荐构建工具。
+:::
+
+- `tsup` 曾经用于部分 TypeScript 包和服务模板，但现在这些模板已经迁移到 `tsdown`。如果旧项目里还有 `tsup.config.ts`，建议改成 `tsdown.config.ts`，并把 `build` / `dev` 脚本切到 `tsdown`。
+- `unbuild` 曾经用于库包开发时的 stub 流程，但这里的新模板已经统一使用 `tsdown --watch` 处理开发构建。新项目不要继续引入 `unbuild`。
+
+新建 TypeScript 类库优先使用 `tsdown` 模板；Vue 组件库继续使用 `vite` 库模式。
+
 ## tsdown
 
 本项目当前的通用类库模板是 [tsdown](https://github.com/sonofmagic/monorepo-template/tree/main/templates/tsdown)

package/templates/vue-lib/eslint.config.js

@@ -1,6 +1,4 @@
-import { loadRepoctlToolingModule } from '../../tooling/load-tooling-module.mjs'
-
-const { defineEslintConfig } = await loadRepoctlToolingModule()
+import { defineEslintConfig } from 'repoctl/tooling'
 
 export default await defineEslintConfig({
   options: {

package/templates/vue-lib/package.json

@@ -17,11 +17,11 @@
   "sideEffects": false,
   "exports": {
     ".": {
-      "types": "./dist/src/index.d.ts",
+      "types": "./dist/index.d.ts",
       "default": "./src/index.ts"
     }
   },
-  "types": "./dist/src/index.d.ts",
+  "types": "./dist/index.d.ts",
   "files": [
     "dist"
   ],
@@ -33,12 +33,12 @@
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "typecheck": "vue-tsc -b",
-    "tsd": "pnpm build && tsd --typings dist/src/index.d.ts --files test-d/**/*.test-d.ts"
+    "tsd": "pnpm build && tsd --typings dist/index.d.ts --files test-d/**/*.test-d.ts"
   },
   "publishConfig": {
     "exports": {
       ".": {
-        "types": "./dist/src/index.d.ts",
+        "types": "./dist/index.d.ts",
         "import": "./dist/index.js",
         "require": "./dist/index.umd.cjs"
       },
@@ -46,7 +46,7 @@
     },
     "main": "./dist/index.umd.cjs",
     "module": "./dist/index.js",
-    "types": "./dist/src/index.d.ts"
+    "types": "./dist/index.d.ts"
   },
   "devDependencies": {
     "@vitejs/plugin-vue": "^6.0.6",
@@ -55,7 +55,7 @@
     "jsdom": "^29.1.1",
     "vite": "^8.0.10",
     "vite-plugin-dts": "^5.0.0",
-    "vue": "^3.5.33",
-    "vue-tsc": "^3.2.7"
+    "vue": "^3.5.34",
+    "vue-tsc": "^3.2.8"
   }
 }

package/templates/vue-lib/test-d/index.test-d.ts

@@ -1,6 +1,6 @@
 import type { Component } from 'vue'
 import { expectAssignable } from 'tsd'
 // eslint-disable-next-line antfu/no-import-dist
-import { HelloWorld } from '../dist/src/index'
+import { HelloWorld } from '../dist/index'
 
 expectAssignable<Component>(HelloWorld)

package/templates/vue-lib/vitest.config.ts

@@ -1,10 +1,8 @@
 import Vue from '@vitejs/plugin-vue'
+import { defineVitestProjectConfig } from 'repoctl/tooling'
 import { mergeConfig } from 'vitest/config'
-import { loadRepoctlToolingModule } from '../../tooling/load-tooling-module.mjs'
 import { sharedConfig } from './vite.shared.config'
 
-const { defineVitestProjectConfig } = await loadRepoctlToolingModule()
-
 export default mergeConfig(sharedConfig, {
   ...await defineVitestProjectConfig({
     options: {

package/assets/tooling/ensure-tooling-built.mjs

@@ -1,24 +0,0 @@
-import { execSync } from 'node:child_process'
-import { existsSync } from 'node:fs'
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-const toolingMarkerPaths = [
-  ['packages', 'monorepo', 'dist', 'tooling-entry.mjs'],
-  ['packages', 'repoctl', 'dist', 'tooling-entry.mjs'],
-]
-
-const rootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
-
-export async function ensureToolingBuilt() {
-  const missingBuildOutput = toolingMarkerPaths.some(segments => !existsSync(path.join(rootDir, ...segments)))
-
-  if (!missingBuildOutput) {
-    return
-  }
-
-  execSync('pnpm tooling:build', {
-    cwd: rootDir,
-    stdio: 'inherit',
-  })
-}

package/assets/tooling/load-tooling-module.mjs

@@ -1,71 +0,0 @@
-import path from 'node:path'
-import { fileURLToPath, pathToFileURL } from 'node:url'
-import { ensureToolingBuilt } from './ensure-tooling-built.mjs'
-
-const rootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
-
-const toolingEntryPaths = {
-  monorepo: path.join(rootDir, 'packages', 'monorepo', 'dist', 'tooling-entry.mjs'),
-  repoctl: path.join(rootDir, 'packages', 'repoctl', 'dist', 'tooling-entry.mjs'),
-}
-
-function getToolingImportSpecifier(entryPath, cacheBust = false) {
-  const fileUrl = pathToFileURL(entryPath)
-  return cacheBust ? `${fileUrl.href}?t=${Date.now()}` : fileUrl.href
-}
-
-export function isRecoverableToolingLoadError(error) {
-  if (!(error instanceof Error)) {
-    return false
-  }
-
-  const nodeError = /** @type {NodeJS.ErrnoException} */ (error)
-  return nodeError.code === 'ERR_MODULE_NOT_FOUND'
-    || nodeError.code === 'ENOENT'
-    || error.message.includes('Cannot find module')
-    || error.message.includes('No such file or directory')
-}
-
-async function importToolingEntry(entryPath, cacheBust = false) {
-  const specifier = getToolingImportSpecifier(entryPath, cacheBust)
-  return import(specifier)
-}
-
-export function createToolingModuleLoader({
-  ensureBuilt = ensureToolingBuilt,
-  importModule = importToolingEntry,
-} = {}) {
-  return async function loadToolingModule(entryPath) {
-    await ensureBuilt()
-
-    try {
-      return await importModule(entryPath)
-    }
-    catch (error) {
-      if (!isRecoverableToolingLoadError(error)) {
-        throw error
-      }
-
-      await ensureBuilt()
-      return importModule(entryPath, true)
-    }
-  }
-}
-
-const loadToolingModule = createToolingModuleLoader()
-
-export function loadMonorepoToolingModule() {
-  return loadToolingModule(toolingEntryPaths.monorepo)
-}
-
-export async function loadRepoctlToolingModule() {
-  try {
-    return await loadToolingModule(toolingEntryPaths.repoctl)
-  }
-  catch (error) {
-    if (!isRecoverableToolingLoadError(error)) {
-      throw error
-    }
-    return loadToolingModule(toolingEntryPaths.monorepo)
-  }
-}

package/templates/vitepress/why/examples/3.npm-basic-package/build.config.ts

@@ -1,24 +0,0 @@
-import path from 'node:path'
-import { defineBuildConfig } from 'unbuild'
-
-export default defineBuildConfig({
-  // entries: ['./src/index', './src/cli'],
-  rollup: {
-    // 内联，相当于 nodeResolve
-    inlineDependencies: true,
-    // cjs
-    emitCJS: true,
-    // 添加 cjs 注入
-    cjsBridge: true,
-    dts: {
-      // https://github.com/unjs/unbuild/issues/135
-      respectExternal: false,
-    },
-  },
-  alias: {
-    // 别名
-    '@': path.resolve(__dirname, './src'),
-  },
-  // dts
-  declaration: true,
-})

package/templates/vitepress/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'}`,
-    }
-  },
-})