@icebreakers/monorepo-templates 0.1.16 → 1.0.1

package/dist/index.d.mts

@@ -4,16 +4,25 @@ import select from "@inquirer/select";
 import { Command, program } from "commander";
 
 //#region src/types.d.ts
+type TemplateCategory = 'app' | 'docs' | 'library' | 'service' | 'tool';
 interface TemplateChoice {
   key: string;
   label: string;
   source: string;
   target: string;
+  description?: string;
+  category?: TemplateCategory;
 }
 interface TemplateDefinition {
   source: string;
   target: string;
 }
+interface GetTemplateChoicesOptions {
+  category?: TemplateCategory;
+}
+interface SuggestTemplateKeyOptions extends GetTemplateChoicesOptions {
+  keys?: readonly string[];
+}
 //#endregion
 //#region src/paths.d.ts
 declare const packageDir: string;
@@ -74,6 +83,18 @@ declare function isGitignoreFile(name: string): boolean;
 declare function shouldSkipTemplatePath(rootDir: string, targetPath: string): boolean;
 declare function createTemplateCopyFilter(rootDir: string): (src: string) => boolean;
 //#endregion
+//#region src/templates.d.ts
+declare const templateCategories: readonly ["app", "docs", "library", "service", "tool"];
+declare function isTemplateCategory(value: string): value is TemplateCategory;
+declare function getTemplateChoices(options?: GetTemplateChoicesOptions): TemplateChoice[];
+declare function getTemplateKeys(options?: GetTemplateChoicesOptions): string[];
+declare function getTemplateChoice(key: string): TemplateChoice | undefined;
+declare function isTemplateKey(key: string): boolean;
+declare function getTemplateDefinition(key: string): TemplateDefinition | undefined;
+declare function getTemplateSource(key: string): string | undefined;
+declare function getTemplateTarget(key: string): string | undefined;
+declare function suggestTemplateKey(key: string, options?: SuggestTemplateKeyOptions): string | undefined;
+//#endregion
 //#region src/index.d.ts
 declare const templateChoices: TemplateChoice[];
 declare const assetTargets: string[];
@@ -82,4 +103,4 @@ declare const templateSourceMap: Record<string, string>;
 declare const templateTargetMap: Record<string, string>;
 declare const templateMap: Record<string, string>;
 //#endregion
-export { Command, type TemplateChoice, type TemplateDefinition, assetTargets, assetsDir, checkbox, createTemplateCopyFilter, ensureTemplateAssetsPrepared, execaCommand, getAssetTargets, input, isGitignoreFile, packageDir, prepareAssets, program, runCommand, scaffoldTemplate, scaffoldWorkspace, select, shouldSkipTemplatePath, skeletonDir, templateChoices, templateMap, templateSourceMap, templateTargetMap, templatesDir, toPublishGitignorePath, toWorkspaceGitignorePath };
+export { Command, type GetTemplateChoicesOptions, type SuggestTemplateKeyOptions, type TemplateCategory, type TemplateChoice, type TemplateDefinition, assetTargets, assetsDir, checkbox, createTemplateCopyFilter, ensureTemplateAssetsPrepared, execaCommand, getAssetTargets, getTemplateChoice, getTemplateChoices, getTemplateDefinition, getTemplateKeys, getTemplateSource, getTemplateTarget, input, isGitignoreFile, isTemplateCategory, isTemplateKey, packageDir, prepareAssets, program, runCommand, scaffoldTemplate, scaffoldWorkspace, select, shouldSkipTemplatePath, skeletonDir, suggestTemplateKey, templateCategories, templateChoices, templateMap, templateSourceMap, templateTargetMap, templatesDir, toPublishGitignorePath, toWorkspaceGitignorePath };

package/dist/index.mjs

@@ -18,12 +18,13 @@ const coreAssetTargets = [
 	".npmrc",
 	"commitlint.config.ts",
 	"eslint.config.js",
-	"nano-staged.js",
+	"lint-staged.config.js",
 	"stylelint.config.js",
-	"monorepo.config.ts",
+	"repoctl.config.ts",
 	"package.json",
 	"AGENTS.md",
 	"pnpm-workspace.yaml",
+	"scripts",
 	"tsconfig.json",
 	"turbo.json",
 	"vitest.config.ts",
@@ -44,64 +45,64 @@ function getAssetTargets$1(core = false) {
 	return core ? [...coreAssetTargets] : [...assetTargets$1];
 }
 //#endregion
+//#region src/paths.ts
+const packageDir = path$1.resolve(fileURLToPath(new URL("../", import.meta.url)));
+const templatesDir = path$1.join(packageDir, "templates");
+const assetsDir = path$1.join(packageDir, "assets");
+const skeletonDir = assetsDir;
+//#endregion
 //#region template-data.mjs
 const templateChoices$1 = [
-	{
-		key: "unbuild",
-		label: "unbuild 打包",
-		source: "unbuild",
-		target: "packages/unbuild"
-	},
-	{
-		key: "tsup",
-		label: "tsup 打包",
-		source: "tsup",
-		target: "packages/tsup"
-	},
 	{
 		key: "tsdown",
 		label: "tsdown 打包",
 		source: "tsdown",
-		target: "packages/tsdown"
+		target: "packages/tsdown",
+		category: "library",
+		description: "使用 tsdown 构建的 TypeScript 库包"
 	},
 	{
 		key: "vue-lib",
 		label: "vue 组件",
 		source: "vue-lib",
-		target: "packages/vue-lib"
+		target: "packages/vue-lib",
+		category: "library",
+		description: "Vue 3 组件库模板，适合沉淀可复用 UI"
 	},
 	{
 		key: "vue-hono",
 		label: "vue hono 全栈",
 		source: "client",
-		target: "apps/client"
+		target: "apps/client",
+		category: "app",
+		description: "Vue 3 + Hono 的前后端一体应用模板"
 	},
 	{
 		key: "hono-server",
 		label: "hono 模板",
 		source: "server",
-		target: "apps/server"
+		target: "apps/server",
+		category: "service",
+		description: "Hono API 服务模板"
 	},
 	{
 		key: "vitepress",
 		label: "vitepress 文档",
 		source: "vitepress",
-		target: "apps/website"
+		target: "apps/website",
+		category: "docs",
+		description: "VitePress 文档站模板"
 	},
 	{
 		key: "cli",
 		label: "cli 模板",
 		source: "cli",
-		target: "apps/cli"
+		target: "apps/cli",
+		category: "tool",
+		description: "TypeScript 命令行工具模板"
 	}
 ];
 //#endregion
-//#region src/paths.ts
-const packageDir = path$1.resolve(fileURLToPath(new URL("../", import.meta.url)));
-const templatesDir = path$1.join(packageDir, "templates");
-const assetsDir = path$1.join(packageDir, "assets");
-const skeletonDir = assetsDir;
-//#endregion
 //#region src/utils/gitignore.ts
 const publishBasename = "gitignore";
 const workspaceBasename = ".gitignore";
@@ -149,13 +150,13 @@ const skipDirs = new Set([
 const skipFiles = new Set([
 	".DS_Store",
 	"CHANGELOG.md",
-	"route-map.d.ts",
-	"worker-configuration.d.ts"
+	"route-map.d.ts"
 ]);
 function shouldSkipTemplatePath(rootDir, targetPath) {
 	const basename = path.basename(targetPath);
 	if (skipFiles.has(basename)) return true;
 	if (basename.endsWith(".tsbuildinfo")) return true;
+	if (/\.timestamp-\d+-[a-z0-9]+\.mjs$/i.test(basename)) return true;
 	const relative = path.relative(rootDir, targetPath);
 	if (!relative || relative.startsWith("..")) return false;
 	const segments = relative.split(path.sep);
@@ -223,8 +224,11 @@ async function copyEntry(from, to, overwriteExisting, filter) {
 	}
 }
 async function copyAssets(repoRoot, overwriteExisting) {
+	const monorepoAssetRoot = path$1.resolve(repoRoot, "packages/monorepo/assets");
 	for (const target of assetTargets$1) {
-		const from = path$1.join(repoRoot, target);
+		const packageAsset = path$1.join(monorepoAssetRoot, toPublishGitignorePath(target));
+		const repoAsset = path$1.join(repoRoot, target);
+		const from = await pathExists$1(packageAsset) ? packageAsset : repoAsset;
 		if (!await pathExists$1(from)) continue;
 		const to = path$1.join(assetsDir, toPublishGitignorePath(target));
 		const stats = await fs.stat(from);
@@ -277,7 +281,7 @@ async function isPrepared() {
 	const checks = [
 		path.join(assetsDir, "AGENTS.md"),
 		path.join(assetsDir, "LICENSE"),
-		path.join(templatesDir, "unbuild")
+		path.join(templatesDir, "tsdown")
 	];
 	return (await Promise.all(checks.map(pathExists))).every(Boolean);
 }
@@ -399,6 +403,84 @@ async function scaffoldWorkspace(options) {
 	}
 }
 //#endregion
+//#region src/templates.ts
+const templateCategories = [
+	"app",
+	"docs",
+	"library",
+	"service",
+	"tool"
+];
+const choices = templateChoices$1;
+const categorySet = new Set(templateCategories);
+function cloneTemplateChoice(choice) {
+	return { ...choice };
+}
+function isTemplateCategory(value) {
+	return categorySet.has(value);
+}
+function getTemplateChoices(options = {}) {
+	const { category } = options;
+	return (category ? choices.filter((choice) => choice.category === category) : choices).map(cloneTemplateChoice);
+}
+function getTemplateKeys(options = {}) {
+	return getTemplateChoices(options).map((choice) => choice.key);
+}
+function getTemplateChoice(key) {
+	const choice = choices.find((item) => item.key === key);
+	return choice ? cloneTemplateChoice(choice) : void 0;
+}
+function isTemplateKey(key) {
+	return choices.some((choice) => choice.key === key);
+}
+function getTemplateDefinition(key) {
+	const choice = getTemplateChoice(key);
+	if (!choice) return;
+	return {
+		source: choice.source,
+		target: choice.target
+	};
+}
+function getTemplateSource(key) {
+	return getTemplateChoice(key)?.source;
+}
+function getTemplateTarget(key) {
+	return getTemplateChoice(key)?.target;
+}
+function getEditDistance(left, right) {
+	const previous = Array.from({ length: right.length + 1 }, (_, index) => index);
+	for (let leftIndex = 1; leftIndex <= left.length; leftIndex += 1) {
+		const current = [leftIndex];
+		for (let rightIndex = 1; rightIndex <= right.length; rightIndex += 1) {
+			const substitutionCost = left[leftIndex - 1] === right[rightIndex - 1] ? 0 : 1;
+			current[rightIndex] = Math.min((current[rightIndex - 1] ?? 0) + 1, (previous[rightIndex] ?? 0) + 1, (previous[rightIndex - 1] ?? 0) + substitutionCost);
+		}
+		previous.splice(0, previous.length, ...current);
+	}
+	return previous[right.length] ?? 0;
+}
+function getTemplateSuggestionThreshold(value) {
+	if (value.length <= 4) return 1;
+	if (value.length <= 8) return 2;
+	return 3;
+}
+function suggestTemplateKey(key, options = {}) {
+	const normalizedKey = key.trim().toLowerCase();
+	if (!normalizedKey) return;
+	const keys = options.keys ? [...options.keys] : getTemplateKeys(options);
+	const prefixMatch = keys.find((candidate) => {
+		const normalizedCandidate = candidate.toLowerCase();
+		return normalizedCandidate.startsWith(normalizedKey) || normalizedKey.startsWith(normalizedCandidate);
+	});
+	if (prefixMatch) return prefixMatch;
+	const [best] = keys.map((candidate) => ({
+		key: candidate,
+		distance: getEditDistance(normalizedKey, candidate.toLowerCase())
+	})).sort((left, right) => left.distance - right.distance || left.key.localeCompare(right.key));
+	if (!best || best.distance > getTemplateSuggestionThreshold(normalizedKey)) return;
+	return best.key;
+}
+//#endregion
 //#region src/utils/command.ts
 async function runCommand(command, args, options = {}) {
 	const result = await exec(command, args, {
@@ -419,11 +501,11 @@ async function execaCommand(command, options = {}) {
 }
 //#endregion
 //#region src/index.ts
-const templateChoices = templateChoices$1;
+const templateChoices = getTemplateChoices();
 const assetTargets = assetTargets$1;
 const getAssetTargets = getAssetTargets$1;
 const templateSourceMap = Object.fromEntries(templateChoices.map((item) => [item.key, item.source]));
 const templateTargetMap = Object.fromEntries(templateChoices.map((item) => [item.key, item.target]));
 const templateMap = templateSourceMap;
 //#endregion
-export { Command, assetTargets, assetsDir, checkbox, createTemplateCopyFilter, ensureTemplateAssetsPrepared, execaCommand, getAssetTargets, input, isGitignoreFile, packageDir, prepareAssets, program, runCommand, scaffoldTemplate, scaffoldWorkspace, select, shouldSkipTemplatePath, skeletonDir, templateChoices, templateMap, templateSourceMap, templateTargetMap, templatesDir, toPublishGitignorePath, toWorkspaceGitignorePath };
+export { Command, assetTargets, assetsDir, checkbox, createTemplateCopyFilter, ensureTemplateAssetsPrepared, execaCommand, getAssetTargets, getTemplateChoice, getTemplateChoices, getTemplateDefinition, getTemplateKeys, getTemplateSource, getTemplateTarget, input, isGitignoreFile, isTemplateCategory, isTemplateKey, packageDir, prepareAssets, program, runCommand, scaffoldTemplate, scaffoldWorkspace, select, shouldSkipTemplatePath, skeletonDir, suggestTemplateKey, templateCategories, templateChoices, templateMap, templateSourceMap, templateTargetMap, templatesDir, toPublishGitignorePath, toWorkspaceGitignorePath };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@icebreakers/monorepo-templates",
   "type": "module",
-  "version": "0.1.16",
+  "version": "1.0.1",
   "description": "Template assets for icebreaker monorepo scaffolding",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",
@@ -21,14 +21,17 @@
   "sideEffects": false,
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts",
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
       "default": "./dist/index.mjs"
     },
     "./package.json": "./package.json"
   },
   "main": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/index.d.mts",
   "files": [
     "assets",
     "assets-data.mjs",
@@ -40,9 +43,9 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@inquirer/checkbox": "^5.1.2",
-    "@inquirer/input": "^5.0.10",
-    "@inquirer/select": "^5.1.2",
+    "@inquirer/checkbox": "^5.1.4",
+    "@inquirer/input": "^5.0.12",
+    "@inquirer/select": "^5.1.4",
     "commander": "^14.0.3",
     "nanoexec": "^1.1.0"
   },
@@ -52,7 +55,8 @@
   "scripts": {
     "dev": "tsdown --watch --sourcemap",
     "build": "tsdown",
-    "typecheck": "tsc -p tsconfig.json",
+    "typecheck": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json",
+    "tsd": "pnpm build && tsd --files test-d/**/*.test-d.ts",
     "sync:assets": "pnpm run build && node scripts/sync-assets.mjs",
     "lint": "eslint ."
   }

package/template-data.mjs

@@ -1,10 +1,50 @@
 export const templateChoices = [
-  { key: 'unbuild', label: 'unbuild 打包', source: 'unbuild', target: 'packages/unbuild' },
-  { key: 'tsup', label: 'tsup 打包', source: 'tsup', target: 'packages/tsup' },
-  { key: 'tsdown', label: 'tsdown 打包', source: 'tsdown', target: 'packages/tsdown' },
-  { key: 'vue-lib', label: 'vue 组件', source: 'vue-lib', target: 'packages/vue-lib' },
-  { key: 'vue-hono', label: 'vue hono 全栈', source: 'client', target: 'apps/client' },
-  { key: 'hono-server', label: 'hono 模板', source: 'server', target: 'apps/server' },
-  { key: 'vitepress', label: 'vitepress 文档', source: 'vitepress', target: 'apps/website' },
-  { key: 'cli', label: 'cli 模板', source: 'cli', target: 'apps/cli' },
+  {
+    key: 'tsdown',
+    label: 'tsdown 打包',
+    source: 'tsdown',
+    target: 'packages/tsdown',
+    category: 'library',
+    description: '使用 tsdown 构建的 TypeScript 库包',
+  },
+  {
+    key: 'vue-lib',
+    label: 'vue 组件',
+    source: 'vue-lib',
+    target: 'packages/vue-lib',
+    category: 'library',
+    description: 'Vue 3 组件库模板，适合沉淀可复用 UI',
+  },
+  {
+    key: 'vue-hono',
+    label: 'vue hono 全栈',
+    source: 'client',
+    target: 'apps/client',
+    category: 'app',
+    description: 'Vue 3 + Hono 的前后端一体应用模板',
+  },
+  {
+    key: 'hono-server',
+    label: 'hono 模板',
+    source: 'server',
+    target: 'apps/server',
+    category: 'service',
+    description: 'Hono API 服务模板',
+  },
+  {
+    key: 'vitepress',
+    label: 'vitepress 文档',
+    source: 'vitepress',
+    target: 'apps/website',
+    category: 'docs',
+    description: 'VitePress 文档站模板',
+  },
+  {
+    key: 'cli',
+    label: 'cli 模板',
+    source: 'cli',
+    target: 'apps/cli',
+    category: 'tool',
+    description: 'TypeScript 命令行工具模板',
+  },
 ]

package/templates/cli/bin/index.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import '../dist/cli.js'
+import '../dist/cli.mjs'

package/templates/cli/package.json

@@ -19,8 +19,8 @@
   },
   "scripts": {
     "start": "tsx src/index.ts",
-    "dev": "tsup --watch --sourcemap",
-    "build": "tsup",
+    "dev": "tsdown --watch --sourcemap",
+    "build": "tsdown",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "typecheck": "tsc -p tsconfig.json"
@@ -28,6 +28,9 @@
   "dependencies": {
     "consola": "^3.4.2"
   },
+  "devDependencies": {
+    "tsdown": "0.21.10"
+  },
   "publishConfig": {
     "bin": {
       "ice": "./bin/index.js"

package/templates/cli/{tsup.config.ts → tsdown.config.ts}

@@ -1,9 +1,10 @@
-import { defineConfig } from 'tsup'
+import { defineConfig } from 'tsdown'
 
 export default defineConfig({
   entry: ['src/index.ts', 'src/cli.ts'],
   shims: true,
-  format: ['cjs', 'esm'],
+  format: ['esm', 'cjs'],
   clean: true,
   dts: true,
+  target: 'node18',
 })

package/templates/client/eslint.config.js

@@ -1,15 +1,15 @@
 import { fileURLToPath } from 'node:url'
-import { icebreaker } from '@icebreakers/eslint-config'
+import { defineEslintConfig } from 'repoctl/tooling'
 
 const tailwindEntryPoint = fileURLToPath(new URL('./src/style.css', import.meta.url))
 
-export default icebreaker(
-  {
+export default await defineEslintConfig({
+  options: {
     vue: true,
     typescript: true,
     tailwindcss: {
       entryPoint: tailwindEntryPoint,
     },
-    ignores: ['**/fixtures/**'],
+    ignores: ['**/fixtures/**', 'worker-configuration.d.ts'],
   },
-)
+})

package/templates/client/gitignore

@@ -25,4 +25,3 @@ dist-ssr
 src/route-map.d.ts
 .wrangler
 .dev.vars*
-worker-configuration.d.ts

package/templates/client/package.json

@@ -15,38 +15,38 @@
     "typecheck": "vue-tsc -b"
   },
   "dependencies": {
-    "@faker-js/faker": "^10.3.0",
-    "@tanstack/vue-query": "^5.92.9",
-    "@tanstack/vue-query-devtools": "^6.1.5",
+    "@faker-js/faker": "^10.4.0",
+    "@tanstack/vue-query": "^5.100.9",
+    "@tanstack/vue-query-devtools": "^6.1.28",
     "@tanstack/vue-table": "^8.21.3",
-    "@tanstack/vue-virtual": "^3.13.23",
-    "@trpc/client": "^11.13.4",
+    "@tanstack/vue-virtual": "^3.13.24",
+    "@trpc/client": "^11.17.0",
     "clsx": "^2.1.1",
     "pinia": "^3.0.4",
     "tailwind-merge": "^3.5.0",
     "tailwind-variants": "^3.2.2",
-    "vue": "^3.5.30",
-    "vue-i18n": "^11.3.0",
-    "vue-router": "^5.0.3"
+    "vue": "^3.5.33",
+    "vue-i18n": "^11.4.0",
+    "vue-router": "^5.0.6"
   },
   "devDependencies": {
-    "@cloudflare/vite-plugin": "^1.29.0",
-    "@hono/node-server": "^1.19.11",
+    "@cloudflare/vite-plugin": "^1.36.0",
+    "@hono/node-server": "^2.0.1",
     "@hono/trpc-server": "^0.4.2",
-    "@tailwindcss/vite": "^4.2.1",
-    "@trpc/server": "^11.13.4",
-    "@vitejs/plugin-vue": "^6.0.5",
+    "@tailwindcss/vite": "^4.2.4",
+    "@trpc/server": "^11.17.0",
+    "@vitejs/plugin-vue": "^6.0.6",
     "@vitejs/plugin-vue-jsx": "^5.1.5",
-    "@vue/tsconfig": "^0.9.0",
+    "@vue/tsconfig": "^0.9.1",
     "consola": "^3.4.2",
-    "hono": "^4.12.8",
-    "tailwindcss": "^4.2.1",
-    "typescript": "~5.9.3",
-    "vite": "^8.0.0",
-    "vite-plugin-vue-devtools": "^8.1.0",
+    "hono": "^4.12.17",
+    "tailwindcss": "^4.2.4",
+    "typescript": "~6.0.3",
+    "vite": "^8.0.10",
+    "vite-plugin-vue-devtools": "^8.1.1",
     "vite-tsconfig-paths": "^6.1.1",
-    "vue-tsc": "3.2.6",
-    "wrangler": "^4.74.0",
-    "zod": "^4.3.6"
+    "vue-tsc": "3.2.8",
+    "wrangler": "^4.88.0",
+    "zod": "^4.4.3"
   }
 }

package/templates/client/vite.config.ts

@@ -8,7 +8,7 @@ import VueDevTools from 'vite-plugin-vue-devtools'
 import VueRouter from 'vue-router/vite'
 
 // https://vite.dev/config/
-export default defineConfig({
+export default defineConfig(({ command }) => ({
   build: {
     target: 'baseline-widely-available',
   },
@@ -22,12 +22,13 @@ export default defineConfig({
     VueRouter(
       {
         dts: path.resolve(import.meta.dirname, 'src/route-map.d.ts'),
+        watch: command === 'serve',
       },
     ),
     Vue(),
     VueJsx(),
     Tailwindcss(),
     cloudflare(),
-    VueDevTools(),
+    command === 'serve' ? VueDevTools() : null,
   ],
-})
+}))