chore: init wetw project

Author: sonofmagic

.changeset/zengjia-wetw-cli.md

@@ -0,0 +1,5 @@
+---
+"wetw": minor
+---
+
+为 wetw 增加基于 cac 的 CLI（init/list/add），支持自定义配置路径、工作目录以及强制覆盖，默认写出 wetw.config.ts 并内置 counter 示例。

benchmark/data/2025-11-26.json

@@ -0,0 +1,52 @@
+{
+  "uni-app-webpack-vue2": {
+    "babel": [
+      279.05220800000006,
+      1204.3177080000023
+    ]
+  },
+  "rax": {
+    "babel": [
+      43.26670800000102,
+      56.27020799999991,
+      50.776583000000755,
+      20.865374999999403,
+      11.805124999998952,
+      89.58862500000032,
+      297.7642080000005
+    ]
+  },
+  "uni-app-webpack5-vue2": {
+    "babel": [
+      471.1814169999998
+    ]
+  },
+  "mpx": {
+    "babel": [
+      478.64458399999967,
+      23.821249999997235,
+      193.04095800000505,
+      325.3952500000014,
+      148.299291000003,
+      26.64470799999981,
+      552.6072500000009
+    ]
+  },
+  "native-webpack": {
+    "babel": [
+      297.7599170000003
+    ]
+  },
+  "taro-vue3": {
+    "babel": [
+      372.9925839999996
+    ]
+  },
+  "taro-react": {
+    "babel": [
+      238.2564999999995,
+      219.2747079999972,
+      273.29708299999766
+    ]
+  }
+}

packages/wetw/README.md

@@ -0,0 +1,87 @@
+# wetw CLI 使用说明
+
+一个借鉴 shadcn-ui 思路的生成器：通过配置文件 + 组件注册表，把模板文件直接拷贝到你的项目中，方便二次定制。配置文件默认使用 `wetw.config.ts`（c12 原生支持）。
+
+## 安装
+
+```bash
+pnpm add -D wetw
+```
+
+或在未安装的情况下临时调用：
+
+```bash
+npx wetw --help
+```
+
+## 快速开始
+
+1. 生成配置文件：
+
+```bash
+wetw init
+```
+
+会在当前目录写出 `wetw.config.ts`，默认输出目录是 `wetw/`。
+
+2. 查看可用组件：
+
+```bash
+wetw list
+```
+
+3. 添加组件（示例内置了一个 `counter`）：
+
+```bash
+wetw add counter
+```
+
+生成的文件将落在配置的 `outDir` 下，例如 `wetw/counter/*`。如需覆盖已有文件，加上 `--force`。
+
+## 配置示例
+
+`wetw.config.ts`：
+
+```ts
+import { defineConfig } from 'wetw'
+
+export default defineConfig({
+  outDir: 'wetw', // 生成目录，默认为 wetw
+  // registry 可以是本地/远程 JSON，或直接写数组
+  // registry: 'https://example.com/wetw/registry.json',
+  // templatesRoot: './templates', // 用于解析 registry 文件中的相对 src
+})
+```
+
+## 命令速查
+
+- `wetw init [--config wetw.config.ts]`：写入默认配置文件。
+- `wetw list [--json]`：输出当前 registry 中的组件清单。
+- `wetw add <name...> [--force]`：按名称生成组件文件。
+- 通用参数：`--config` 指定配置文件，`--cwd` 指定工作目录。
+
+## 自定义 registry
+
+一个最小的注册表示例（保存为 `registry.json`）：
+
+```json
+[
+  {
+    "name": "button",
+    "description": "自定义按钮",
+    "files": [
+      { "path": "button/index.ts", "content": "export const btn = true" }
+    ]
+  }
+]
+```
+
+在 `wetw.config.ts` 中指定：
+
+```ts
+export default defineConfig({
+  registry: './registry.json',
+})
+```
+
+随后执行 `wetw add button` 即可写入对应文件。\*\*\*

packages/wetw/package.json

@@ -31,6 +31,9 @@
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
+  "bin": {
+    "wetw": "./dist/cli.mjs"
+  },
   "files": [
     "dist"
   ],
@@ -43,5 +46,9 @@
     "lint": "eslint .",
     "lint:fix": "eslint . --fix"
   },
-  "publishConfig": {}
+  "publishConfig": {},
+  "dependencies": {
+    "c12": "^3.3.2",
+    "cac": "^6.7.14"
+  }
 }

packages/wetw/src/add.ts

@@ -0,0 +1,90 @@
+import type { LoadWetwConfigOptions } from './config'
+import type { ResolvedWetwConfig, WetwRegistryFile, WetwRegistryItem } from './types'
+import { constants } from 'node:fs'
+import { access, mkdir, readFile, writeFile } from 'node:fs/promises'
+import { dirname, isAbsolute, resolve } from 'node:path'
+import { loadWetwConfig } from './config'
+import { resolveRegistry } from './registry'
+import { isHttp } from './utils'
+
+export interface AddComponentsOptions extends LoadWetwConfigOptions {
+  force?: boolean
+  registry?: WetwRegistryItem[]
+}
+
+async function pathExists(target: string) {
+  try {
+    await access(target, constants.F_OK)
+    return true
+  }
+  catch (error) {
+    if ((error as NodeJS.ErrnoException).code === 'ENOENT') {
+      return false
+    }
+    throw error
+  }
+}
+
+async function getFileContent(file: WetwRegistryFile, config: ResolvedWetwConfig) {
+  if ('content' in file && file.content !== undefined) {
+    return file.content
+  }
+
+  if ('src' in file) {
+    if (isHttp(file.src)) {
+      const response = await fetch(file.src)
+      if (!response.ok) {
+        throw new Error(`Failed to download ${file.src}: ${response.statusText}`)
+      }
+      return response.text()
+    }
+
+    const from = isAbsolute(file.src) ? file.src : resolve(config.templatesRoot, file.src)
+    return readFile(from, 'utf8')
+  }
+
+  throw new Error(`Invalid registry file entry for ${file.path}`)
+}
+
+async function writeFileSafely(target: string, content: string, force: boolean) {
+  const exists = await pathExists(target)
+  if (exists && !force) {
+    throw new Error(`File already exists: ${target}`)
+  }
+
+  await mkdir(dirname(target), { recursive: true })
+  await writeFile(target, content, 'utf8')
+}
+
+export async function addComponents(names: string[], options: AddComponentsOptions = {}) {
+  if (!names.length) {
+    throw new Error('Please provide at least one component name')
+  }
+
+  const config = await loadWetwConfig({
+    cwd: options.cwd,
+    configFile: options.configFile,
+    overrides: options.overrides,
+  })
+
+  const registry = options.registry ?? (await resolveRegistry(config))
+  const registryMap = new Map(registry.map(item => [item.name, item]))
+
+  for (const name of names) {
+    const item = registryMap.get(name)
+    if (!item) {
+      throw new Error(`Component "${name}" not found in registry`)
+    }
+
+    for (const file of item.files) {
+      const content = await getFileContent(file, config)
+      const target = resolve(config.outDir, file.path)
+      await writeFileSafely(target, content, options.force ?? false)
+    }
+  }
+
+  return {
+    added: names,
+    outDir: config.outDir,
+  }
+}

packages/wetw/src/cli.ts

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+import process from 'node:process'
+import { cac } from 'cac'
+import pkg from '../package.json' assert { type: 'json' }
+import { addComponents } from './add'
+import { loadWetwConfig } from './config'
+import { writeDefaultConfig } from './init'
+import { resolveRegistry } from './registry'
+
+const cli = cac('wetw')
+
+cli
+  .option('--config <path>', 'Path to wetw.config.(ts|js|json)')
+  .option('--cwd <path>', 'Working directory (defaults to process.cwd())')
+
+function handleError(error: unknown) {
+  console.error((error as Error).message)
+  process.exitCode = 1
+}
+
+cli
+  .command('init', 'Create a config file')
+  .option('--force', 'Overwrite existing config file')
+  .action(async (options) => {
+    try {
+      const file = await writeDefaultConfig({
+        cwd: options.cwd,
+        configFile: options.config,
+        force: options.force,
+      })
+      console.log(`Generated config at ${file}`)
+    }
+    catch (error) {
+      handleError(error)
+    }
+  })
+
+cli
+  .command('list', 'List registry components')
+  .option('--json', 'Emit list as JSON')
+  .action(async (options) => {
+    try {
+      const config = await loadWetwConfig({
+        cwd: options.cwd,
+        configFile: options.config,
+      })
+
+      const registry = await resolveRegistry(config)
+      if (options.json) {
+        console.log(JSON.stringify(registry, null, 2))
+        return
+      }
+
+      if (!registry.length) {
+        console.log('Registry is empty')
+        return
+      }
+
+      console.log('Available components:')
+      for (const item of registry) {
+        const description = item.description ? ` - ${item.description}` : ''
+        console.log(`- ${item.name}${description}`)
+      }
+    }
+    catch (error) {
+      handleError(error)
+    }
+  })
+
+cli
+  .command('add <names...>', 'Add components to the project')
+  .option('--force', 'Overwrite existing files')
+  .action(async (names: string[], options) => {
+    try {
+      if (!names?.length) {
+        throw new Error('wetw add <name...> expects at least one component')
+      }
+
+      await addComponents(names, {
+        cwd: options.cwd,
+        configFile: options.config,
+        force: options.force,
+      })
+      console.log(`Added: ${names.join(', ')}`)
+    }
+    catch (error) {
+      handleError(error)
+    }
+  })
+
+cli.help()
+cli.version(pkg.version ?? '0.0.0')
+
+if (process.argv.length <= 2) {
+  cli.outputHelp()
+}
+
+cli.parse()