@icebreakers/monorepo-templates 1.3.4 → 1.3.5

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

@@ -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,7 +85,6 @@
     "@types/lodash": "^4.17.25",
     "@types/lodash-es": "^4.17.12",
     "@types/micromatch": "^4.0.10",
-    "@icebreakers/monorepo": "workspace:*",
     "@types/node": "^26.5.0",
     "@types/semver": "^7.8.0",
     "@types/set-value": "^4.0.3",
@@ -125,10 +125,10 @@
     "tsd": "^0.33.0",
     "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.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.4",
+  "version": "1.3.5",
   "description": "Built-in project templates and managed workspace assets for repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",

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,15 +20,15 @@
     "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",
@@ -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",
@@ -62,7 +62,7 @@
     "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": {
@@ -65,7 +65,7 @@
     "consola": "^3.4.2",
     "hono": "^4.13.7",
     "tsdown": "0.23.0",
-    "wrangler": "^4.128.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

@@ -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