@icebreakers/monorepo-templates 1.3.3 → 1.3.5

package/assets/.github/workflows/ci.yml

@@ -36,7 +36,7 @@ jobs:
         with:
           fetch-depth: 2
 
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
+      - uses: pnpm/action-setup@ea17c68df8912ef543352723c149a84f56e3d413 # v6.1.0
 
       - name: Setup Node.js environment
         uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0

package/assets/.github/workflows/release.yml

@@ -54,7 +54,7 @@ jobs:
         with:
           fetch-depth: 0
 
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
+      - uses: pnpm/action-setup@ea17c68df8912ef543352723c149a84f56e3d413 # v6.1.0
 
       - name: Setup Node.js environment
         uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0

package/assets/gitignore

@@ -37,3 +37,6 @@ vite.config.ts.timestamp-*.mjs
 config.ts.timestamp-*.mjs
 .vite-inspect
 .playwright-cli
+
+# local AI task artifacts
+/.qoder/

package/assets/package.json

@@ -3,7 +3,7 @@
   "type": "module",
   "version": "0.0.0",
   "private": true,
-  "packageManager": "pnpm@11.25.0",
+  "packageManager": "pnpm@12.3.4",
   "description": "Source workspace for repoctl and Icebreaker's shared development packages",
   "author": "ice breaker <hi@sonofmagic.top>",
   "homepage": "https://repoctl.icebreaker.top",
@@ -75,6 +75,7 @@
     "@eslint/eslintrc": "^3.3.7",
     "@icebreakers/commitlint-config": "workspace:*",
     "@icebreakers/eslint-config": "workspace:*",
+    "@icebreakers/monorepo": "workspace:*",
     "@icebreakers/stylelint-config": "workspace:*",
     "@next/eslint-plugin-next": "^16.3.4",
     "@prettier/plugin-xml": "^3.4.2",
@@ -84,19 +85,18 @@
     "@types/lodash": "^4.17.25",
     "@types/lodash-es": "^4.17.12",
     "@types/micromatch": "^4.0.10",
-    "@icebreakers/monorepo": "workspace:*",
-    "@types/node": "^26.4.1",
+    "@types/node": "^26.5.0",
     "@types/semver": "^7.8.0",
     "@types/set-value": "^4.0.3",
-    "@typescript-eslint/types": "^8.69.0",
-    "@unocss/eslint-plugin": "66.9.2",
+    "@typescript-eslint/types": "^8.70.0",
+    "@unocss/eslint-plugin": "66.10.0",
     "@vitest/coverage-v8": "~5.0.0",
     "astro-eslint-parser": "^3.1.0",
     "ci-info": "^4.4.0",
     "cross-env": "^10.1.0",
     "defu": "^6.1.7",
     "es-toolkit": "^1.52.0",
-    "eslint": "^10.9.1",
+    "eslint": "^10.10.0",
     "eslint-plugin-astro": "^3.1.0",
     "eslint-plugin-mdx": "3.8.1",
     "eslint-plugin-svelte": "^3.23.0",
@@ -106,29 +106,29 @@
     "get-value": "^4.1.0",
     "husky": "^9.1.7",
     "jiti": "^2.7.0",
-    "lint-staged": "^17.4.1",
+    "lint-staged": "^17.5.0",
     "lodash": "^4.18.1",
     "lodash-es": "^4.18.1",
     "micromatch": "^4.0.8",
     "only-allow": "^1.2.2",
     "pathe": "^2.0.3",
-    "pkg-types": "^2.3.2",
+    "pkg-types": "^2.3.3",
     "prettier": "^3.9.6",
     "prettier-plugin-astro": "^0.14.1",
     "repoctl": "workspace:*",
     "rimraf": "^6.1.3",
     "set-value": "^4.1.0",
-    "stylelint": "^17.14.1",
+    "stylelint": "^17.15.0",
     "svelte": "^5.57.0",
     "svelte-eslint-parser": "^1.8.1",
     "tailwindcss": "^4.3.3",
     "tsd": "^0.33.0",
-    "tsdown": "0.22.14",
+    "tsdown": "0.23.0",
     "tslib": "^2.8.1",
+    "tsup": "^8.5.1",
     "tsx": "^4.23.13",
     "turbo": "^2.10.12",
     "type-fest": "^5.9.0",
-    "tsup": "^8.5.1",
     "typescript": "^6.0.3",
     "unbuild": "^3.6.1",
     "vitest": "~5.0.0",

package/assets/turbo.json

@@ -1,5 +1,8 @@
 {
   "$schema": "https://turborepo.com/schema.json",
+  "globalDependencies": [
+    "pnpm-lock.yaml"
+  ],
   "tasks": {
     "build": {
       "dependsOn": [
@@ -8,6 +11,10 @@
       "inputs": [
         "src/**",
         "lib/**",
+        "worker/**",
+        "wrangler.{json,jsonc,toml}",
+        ".dev.vars*",
+        ".env*",
         "package.json",
         "tsconfig*.json",
         "*.config.{js,ts,mjs,mts}"
@@ -72,6 +79,10 @@
       "inputs": [
         "src/**",
         "lib/**",
+        "worker/**",
+        "wrangler.{json,jsonc,toml}",
+        ".dev.vars*",
+        ".env*",
         "test/**",
         "package.json",
         "tsconfig*.json"

package/dist/cli.mjs

@@ -1,4 +1,4 @@
-import { t as prepareAssets } from "./prepare-D7eJqEqy.mjs";
+import { t as prepareAssets } from "./prepare-DlR-vvls.mjs";
 import process from "node:process";
 //#region src/cli.ts
 async function main() {

package/dist/index.d.mts

@@ -24,20 +24,20 @@ interface SuggestTemplateKeyOptions extends GetTemplateChoicesOptions {
 }
 //#endregion
 //#region src/paths.d.ts
-declare const packageDir: string;
-declare const templatesDir: string;
-declare const assetsDir: string;
-declare const skeletonDir: string;
+export declare const packageDir: string;
+export declare const templatesDir: string;
+export declare const assetsDir: string;
+export declare const skeletonDir: string;
 //#endregion
 //#region src/prepare.d.ts
 interface PrepareAssetsOptions {
   overwriteExisting?: boolean;
   silent?: boolean;
 }
-declare function prepareAssets(options?: PrepareAssetsOptions): Promise<void>;
+export declare function prepareAssets(options?: PrepareAssetsOptions): Promise<void>;
 //#endregion
 //#region src/runtime-assets.d.ts
-declare function ensureTemplateAssetsPrepared(): Promise<void>;
+export declare function ensureTemplateAssetsPrepared(): Promise<void>;
 //#endregion
 //#region src/scaffold.d.ts
 type TargetMode = 'prepare' | 'ensure' | 'skip';
@@ -58,48 +58,48 @@ interface ScaffoldWorkspaceOptions {
   targetMode?: TargetMode;
   force?: boolean;
 }
-declare function scaffoldTemplate(options: ScaffoldTemplateOptions): Promise<void>;
-declare function scaffoldWorkspace(options: ScaffoldWorkspaceOptions): Promise<void>;
+export declare function scaffoldTemplate(options: ScaffoldTemplateOptions): Promise<void>;
+export declare function scaffoldWorkspace(options: ScaffoldWorkspaceOptions): Promise<void>;
 //#endregion
 //#region src/utils/command.d.ts
 interface RunCommandOptions {
   cwd?: string;
   stdio?: 'inherit' | 'pipe';
 }
-declare function runCommand(command: string, args: string[], options?: RunCommandOptions): Promise<{
+export declare function runCommand(command: string, args: string[], options?: RunCommandOptions): Promise<{
   exitCode: number | null;
 }>;
-declare function execaCommand(command: string, options?: RunCommandOptions): Promise<{
+export declare function execaCommand(command: string, options?: RunCommandOptions): Promise<{
   exitCode: number | null;
 }>;
 //#endregion
 //#region src/utils/gitignore.d.ts
-declare function toPublishGitignorePath(input: string): string;
-declare function toWorkspaceGitignorePath(input: string): string;
-declare function isGitignoreFile(name: string): boolean;
+export declare function toPublishGitignorePath(input: string): string;
+export declare function toWorkspaceGitignorePath(input: string): string;
+export declare function isGitignoreFile(name: string): boolean;
 //#endregion
 //#region src/utils/template-filter.d.ts
-declare function shouldSkipTemplatePath(rootDir: string, targetPath: string): boolean;
-declare function createTemplateCopyFilter(rootDir: string): (src: string) => boolean;
+export declare function shouldSkipTemplatePath(rootDir: string, targetPath: string): boolean;
+export 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;
+export declare const templateCategories: readonly ["app", "docs", "library", "service", "tool"];
+export declare function isTemplateCategory(value: string): value is TemplateCategory;
+export declare function getTemplateChoices(options?: GetTemplateChoicesOptions): TemplateChoice[];
+export declare function getTemplateKeys(options?: GetTemplateChoicesOptions): string[];
+export declare function getTemplateChoice(key: string): TemplateChoice | undefined;
+export declare function isTemplateKey(key: string): boolean;
+export declare function getTemplateDefinition(key: string): TemplateDefinition | undefined;
+export declare function getTemplateSource(key: string): string | undefined;
+export declare function getTemplateTarget(key: string): string | undefined;
+export declare function suggestTemplateKey(key: string, options?: SuggestTemplateKeyOptions): string | undefined;
 //#endregion
 //#region src/index.d.ts
-declare const templateChoices: TemplateChoice[];
-declare const assetTargets: string[];
-declare const getAssetTargets: (core?: boolean) => string[];
-declare const templateSourceMap: Record<string, string>;
-declare const templateTargetMap: Record<string, string>;
-declare const templateMap: Record<string, string>;
+export declare const templateChoices: TemplateChoice[];
+export declare const assetTargets: string[];
+export declare const getAssetTargets: (core?: boolean) => string[];
+export declare const templateSourceMap: Record<string, string>;
+export declare const templateTargetMap: Record<string, string>;
+export declare const templateMap: Record<string, string>;
 //#endregion
-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 };
+export { Command, type GetTemplateChoicesOptions, type SuggestTemplateKeyOptions, type TemplateCategory, type TemplateChoice, type TemplateDefinition, checkbox, input, program, select };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as toPublishGitignorePath, c as assetsDir, d as templatesDir, f as assetTargets$1, i as isGitignoreFile, l as packageDir, n as createTemplateCopyFilter, o as toWorkspaceGitignorePath, p as getAssetTargets$1, r as shouldSkipTemplatePath, s as templateChoices$1, t as prepareAssets, u as skeletonDir } from "./prepare-D7eJqEqy.mjs";
+import { a as toPublishGitignorePath, c as assetsDir, d as templatesDir, f as assetTargets$1, i as isGitignoreFile, l as packageDir, n as createTemplateCopyFilter, o as toWorkspaceGitignorePath, p as getAssetTargets$1, r as shouldSkipTemplatePath, s as templateChoices$1, t as prepareAssets, u as skeletonDir } from "./prepare-DlR-vvls.mjs";
 import path from "node:path";
 import fs, { access, open, rm } from "node:fs/promises";
 import exec from "nanoexec";

package/dist/{prepare-D7eJqEqy.mjs → prepare-DlR-vvls.mjs}

@@ -144,7 +144,8 @@ const skipDirs = /* @__PURE__ */ new Set([
 const skipFiles = /* @__PURE__ */ new Set([
 	".DS_Store",
 	"CHANGELOG.md",
-	"route-map.d.ts"
+	"route-map.d.ts",
+	"worker-configuration.d.ts"
 ]);
 function shouldSkipTemplatePath(rootDir, targetPath) {
 	const basename = path.basename(targetPath);
@@ -310,6 +311,19 @@ async function removeSourceRepoReleaseToolingBuildStep() {
 	const nextContent = removeSourceRepoReleaseToolingBuildStepContent(content);
 	if (nextContent !== content) await fs.writeFile(releaseWorkflowPath, nextContent, "utf8");
 }
+async function removeSourceRepoWorkerTypeChecks() {
+	const workflowPath = path$1.join(assetsDir, ".github/workflows/ci.yml");
+	if (await pathExists(workflowPath)) {
+		const workflow = await fs.readFile(workflowPath, "utf8");
+		await fs.writeFile(workflowPath, workflow.replace(/\r?\n\s+- name: Check Worker type generation from packaged templates\r?\n\s+run: pnpm test:worker-types\r?\n/g, "\n"));
+	}
+	const manifestPath = path$1.join(assetsDir, "package.json");
+	if (await pathExists(manifestPath)) {
+		const manifest = JSON.parse(await fs.readFile(manifestPath, "utf8"));
+		delete manifest.scripts?.["test:worker-types"];
+		await fs.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
+	}
+}
 async function copyTemplates(repoRoot, overwriteExisting) {
 	for (const template of templateChoices) {
 		const from = path$1.join(repoRoot, "templates", template.source);
@@ -331,6 +345,7 @@ async function prepareAssets(options = {}) {
 	await removePublishedReleaseState();
 	await writePublishedToolingConfigs();
 	await removeSourceRepoReleaseToolingBuildStep();
+	await removeSourceRepoWorkerTypeChecks();
 	await copyTemplates(repoRoot, overwriteExisting);
 }
 //#endregion

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@icebreakers/monorepo-templates",
   "type": "module",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "description": "Built-in project templates and managed workspace assets for repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",
@@ -45,9 +45,9 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@inquirer/checkbox": "^5.2.4",
-    "@inquirer/input": "^5.1.5",
-    "@inquirer/select": "^5.2.4",
+    "@inquirer/checkbox": "^5.2.5",
+    "@inquirer/input": "^5.1.6",
+    "@inquirer/select": "^5.2.5",
     "commander": "^15.0.0",
     "nanoexec": "^1.1.0",
     "yaml": "^2.9.0"

package/templates/cli/package.json

@@ -36,7 +36,7 @@
     "consola": "^3.4.2"
   },
   "devDependencies": {
-    "tsdown": "0.22.14"
+    "tsdown": "0.23.0"
   },
   "publishConfig": {
     "bin": {

package/templates/client/gitignore

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

package/templates/client/package.json

@@ -20,22 +20,22 @@
     "template"
   ],
   "scripts": {
-    "dev": "vite --host",
-    "build": "vue-tsc -b && vite build",
+    "dev": "pnpm cf-typegen && vite --host",
+    "build": "pnpm cf-typegen && vue-tsc -b && vite build",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "preview": "vite preview",
     "deploy": "wrangler deploy",
     "cf-typegen": "wrangler types",
     "cf-typegen:check": "wrangler types --check",
-    "typecheck": "pnpm cf-typegen:check && vue-tsc -b"
+    "typecheck": "pnpm cf-typegen && vue-tsc -b"
   },
   "dependencies": {
     "@faker-js/faker": "^10.6.0",
     "@tanstack/vue-query": "^5.102.8",
     "@tanstack/vue-query-devtools": "^6.1.48",
     "@tanstack/vue-table": "^9.2.4",
-    "@tanstack/vue-virtual": "^3.13.36",
+    "@tanstack/vue-virtual": "^3.13.37",
     "@trpc/client": "^11.18.0",
     "clsx": "^2.1.1",
     "pinia": "^4.0.3",
@@ -46,7 +46,7 @@
     "vue-router": "^5.3.1"
   },
   "devDependencies": {
-    "@cloudflare/vite-plugin": "^1.54.3",
+    "@cloudflare/vite-plugin": "^1.54.5",
     "@hono/node-server": "^2.1.1",
     "@hono/trpc-server": "^0.4.2",
     "@tailwindcss/vite": "^4.3.3",
@@ -55,14 +55,14 @@
     "@vitejs/plugin-vue-jsx": "^5.1.6",
     "@vue/tsconfig": "^0.9.1",
     "consola": "^3.4.2",
-    "hono": "^4.13.5",
+    "hono": "^4.13.7",
     "tailwindcss": "^4.3.3",
     "typescript": "~6.0.3",
     "vite": "^8.2.2",
     "vite-plugin-vue-devtools": "^8.2.1",
     "vite-tsconfig-paths": "^6.1.1",
     "vue-tsc": "3.3.11",
-    "wrangler": "^4.128.0",
+    "wrangler": "^4.129.1",
     "zod": "^4.5.4"
   }
 }

package/templates/client/turbo.json

@@ -0,0 +1,11 @@
+{
+  "extends": ["//"],
+  "tasks": {
+    "build": {
+      "outputs": ["dist/**", "worker-configuration.d.ts"]
+    },
+    "typecheck": {
+      "outputs": ["worker-configuration.d.ts"]
+    }
+  }
+}

package/templates/server/gitignore

@@ -1 +1,2 @@
 .wrangler
+worker-configuration.d.ts

package/templates/server/package.json

@@ -31,8 +31,8 @@
     "dist"
   ],
   "scripts": {
-    "dev": "wrangler dev",
-    "build": "tsdown",
+    "dev": "pnpm cf-typegen && wrangler dev",
+    "build": "pnpm cf-typegen && tsdown",
     "build:watch": "tsdown --watch --sourcemap",
     "node:build:watch": "pnpm build:watch",
     "node:build": "pnpm build",
@@ -46,7 +46,7 @@
     "deploy": "wrangler deploy",
     "cf-typegen": "wrangler types",
     "cf-typegen:check": "wrangler types --check",
-    "typecheck": "pnpm cf-typegen:check && tsc -p tsconfig.json && tsc -p tsconfig.worker.json"
+    "typecheck": "pnpm cf-typegen && tsc -p tsconfig.json && tsc -p tsconfig.worker.json"
   },
   "publishConfig": {
     "exports": {
@@ -63,9 +63,9 @@
   "devDependencies": {
     "@hono/node-server": "^2.1.1",
     "consola": "^3.4.2",
-    "hono": "^4.13.5",
-    "tsdown": "0.22.14",
-    "wrangler": "^4.128.0",
+    "hono": "^4.13.7",
+    "tsdown": "0.23.0",
+    "wrangler": "^4.129.1",
     "zod": "^4.5.4"
   }
 }

package/templates/server/turbo.json

@@ -0,0 +1,11 @@
+{
+  "extends": ["//"],
+  "tasks": {
+    "build": {
+      "outputs": ["dist/**", "worker-configuration.d.ts"]
+    },
+    "typecheck": {
+      "outputs": ["worker-configuration.d.ts"]
+    }
+  }
+}

package/templates/vitepress/package.json

@@ -38,7 +38,7 @@
   "devDependencies": {
     "@braintree/sanitize-url": "^7.1.2",
     "@tailwindcss/vite": "^4.3.3",
-    "cytoscape": "^3.34.2",
+    "cytoscape": "^3.34.3",
     "cytoscape-cose-bilkent": "^4.1.0",
     "dayjs": "^1.11.23",
     "debug": "^4.4.3",
@@ -49,6 +49,6 @@
     "vitepress-plugin-llms": "^1.13.5",
     "vitepress-plugin-mermaid": "^2.0.17",
     "vue-tsc": "^3.3.11",
-    "wrangler": "^4.128.0"
+    "wrangler": "^4.129.1"
   }
 }

package/templates/vitepress/reference/templates.md

@@ -74,6 +74,14 @@ Check first:
 - `dev`, `build`, and `typecheck` scripts are part of root tasks.
 - CI needs integration or E2E tests.
 
+### Cloudflare Worker types
+
+The `vue-hono` and `hono-server` templates generate `worker-configuration.d.ts` from the installed Wrangler version and `wrangler.jsonc` before `dev`, `build`, and `typecheck`. This generated file is ignored by Git and excluded from published templates. Dependency updates do not require committing regenerated declarations.
+
+Run `pnpm cf-typegen` in the app workspace to refresh editor types after changing bindings or compatibility settings. `pnpm cf-typegen:check` is a read-only diagnostic: it reports missing or outdated declarations. Build and typecheck regenerate them automatically and still fail on invalid configuration or TypeScript errors.
+
+For existing projects, update these scripts and the Turbo inputs/outputs, then remove `worker-configuration.d.ts` from the Git index with `git rm --cached worker-configuration.d.ts` and add it to `.gitignore`.
+
 ### Create a docs site
 
 ```bash

package/templates/vitepress/zh/reference/templates.md

@@ -76,6 +76,14 @@ repo new api --template hono-server
 - `dev`、`build`、`typecheck` 脚本是否接入根任务。
 - 是否需要在 CI 里加入 E2E 或集成测试。
 
+### Cloudflare Worker 类型
+
+`vue-hono` 和 `hono-server` 模板会在 `dev`、`build`、`typecheck` 前，根据已安装的 Wrangler 版本和 `wrangler.jsonc` 自动生成 `worker-configuration.d.ts`。该文件由 Git 忽略，也不会打入发布的模板包；依赖升级无需再提交重新生成的声明。
+
+修改 binding 或兼容性配置后，可在应用工作区运行 `pnpm cf-typegen` 刷新编辑器类型。`pnpm cf-typegen:check` 保留为只读诊断命令，文件缺失或过期时会报错。构建和类型检查会自动重新生成，配置错误和真实 TypeScript 错误仍会阻止通过。
+
+已有项目需同步这些脚本和 Turbo 的输入、输出配置，再执行 `git rm --cached worker-configuration.d.ts` 移除 Git 跟踪，并将文件加入 `.gitignore`。
+
 ### 要创建文档站
 
 ```bash