create-weapp-vite 2.3.4 → 2.3.5

package/README.md

@@ -7,7 +7,7 @@
 ## 特性
 
 - 交互式创建或非交互式参数创建
-- 内置多种模板（默认、Wevu、Tailwindcss、TDesign、Vant 等）
+- 内置多种模板（默认、Wevu、Wevu + TDesign、Tailwindcss、TDesign、Vant、插件、组件库）
 - 自动对齐 `weapp-vite` 与 `wevu` 版本
 - 自动处理 `.gitignore` 写入
 - 可选安装推荐的 AI skills（`sonofmagic/skills`）
@@ -67,10 +67,12 @@ await createProject('my-app', TemplateName.wevu, { installSkills: true })
 
 - `default`
 - `wevu`
+- `wevu-tdesign`
 - `tailwindcss`
-- `vant`
 - `tdesign`
-- `wevu-tdesign`
+- `vant`
+- `plugin`
+- `lib`
 
 ## 相关链接
 

package/dist/cli.js

@@ -1,4 +1,4 @@
-import { n as RECOMMENDED_SKILLS_INSTALL_COMMAND, t as createProject } from "./src-2teZ_6MA.js";
+import { n as RECOMMENDED_SKILLS_INSTALL_COMMAND, t as createProject } from "./src-Tx4viskG.js";
 import logger from "@weapp-core/logger";
 import { fs } from "@weapp-core/shared/fs";
 import process from "node:process";
@@ -6,6 +6,40 @@ import path from "node:path";
 import { confirm, input, select } from "@inquirer/prompts";
 //#region src/cli.ts
 const cwd = process.cwd();
+const TEMPLATE_CHOICES = [
+	{
+		name: "默认模板",
+		value: "default"
+	},
+	{
+		name: "Wevu 模板 (Vue SFC)",
+		value: "wevu"
+	},
+	{
+		name: "Wevu + TDesign 模板 (wevu + tdesign + tailwindcss)",
+		value: "wevu-tdesign"
+	},
+	{
+		name: "集成 Tailwindcss",
+		value: "tailwindcss"
+	},
+	{
+		name: "TDesign 模板 (tdesign + tailwindcss)",
+		value: "tdesign"
+	},
+	{
+		name: "Vant 模板 (vant + tailwindcss)",
+		value: "vant"
+	},
+	{
+		name: "插件模板 (src + pluginRoot)",
+		value: "plugin"
+	},
+	{
+		name: "组件库模板 (lib 模式)",
+		value: "lib"
+	}
+];
 function parseCliArgs(argv) {
 	const positionals = [];
 	let installSkills;
@@ -42,36 +76,7 @@ async function run() {
 	}
 	await createProject(targetDir, isArgMode ? argTemplate ?? "default" : await select({
 		message: "选择模板",
-		choices: [
-			{
-				name: "默认模板",
-				value: "default"
-			},
-			{
-				name: "组件库模板 (lib 模式)",
-				value: "lib"
-			},
-			{
-				name: "Wevu 模板 (Vue SFC)",
-				value: "wevu"
-			},
-			{
-				name: "Wevu + TDesign 模板 (wevu + tdesign + tailwindcss)",
-				value: "wevu-tdesign"
-			},
-			{
-				name: "集成 Tailwindcss",
-				value: "tailwindcss"
-			},
-			{
-				name: "Vant 模板 (vant + tailwindcss)",
-				value: "vant"
-			},
-			{
-				name: "TDesign 模板 (tdesign + tailwindcss)",
-				value: "tdesign"
-			}
-		],
+		choices: TEMPLATE_CHOICES,
 		default: "default"
 	}), { installSkills: isArgMode ? argInstallSkills ?? false : await confirm({
 		message: `是否安装推荐的 AI skills？将执行 \`${RECOMMENDED_SKILLS_INSTALL_COMMAND}\`，也可稍后手动执行`,

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 //#region src/enums.d.ts
 declare enum TemplateName {
   default = "default",
+  plugin = "plugin",
   wevu = "wevu",
   tailwindcss = "tailwindcss",
   vant = "vant",

package/dist/index.js

@@ -1,2 +1,2 @@
-import { r as TemplateName, t as createProject } from "./src-2teZ_6MA.js";
+import { r as TemplateName, t as createProject } from "./src-Tx4viskG.js";
 export { TemplateName, createProject };

package/dist/{src-2teZ_6MA.js → src-Tx4viskG.js}

@@ -6,14 +6,15 @@ import https from "node:https";
 import { spawn } from "node:child_process";
 import process from "node:process";
 //#region ../../packages-runtime/wevu/package.json
-var version$1 = "6.15.11";
+var version$1 = "6.15.12";
 //#endregion
 //#region ../weapp-vite/package.json
-var version = "6.15.11";
+var version = "6.15.12";
 //#endregion
 //#region src/enums.ts
 let TemplateName = /* @__PURE__ */ function(TemplateName) {
 	TemplateName["default"] = "default";
+	TemplateName["plugin"] = "plugin";
 	TemplateName["wevu"] = "wevu";
 	TemplateName["tailwindcss"] = "tailwindcss";
 	TemplateName["vant"] = "vant";
@@ -30,6 +31,9 @@ function supportsWevu(templateName) {
 function supportsNativePages(templateName) {
 	return !supportsWevu(templateName);
 }
+function supportsPlugin(templateName) {
+	return templateName === "plugin";
+}
 /**
 * @description 生成新项目的 AGENTS 指引
 */
@@ -85,6 +89,7 @@ function createAgentsGuidelines(templateName) {
 	];
 	if (supportsWevu(templateName)) lines.push("  - `$wevu-best-practices` for `wevu` runtime lifecycle, state, store, and event contracts.", "", "## Wevu Authoring", "", "- Import runtime APIs from `wevu` in business code.", "- Register lifecycle hooks synchronously in `setup()` and avoid hook registration after `await`.", "- Prefer `ref`, `reactive`, `computed`, and explicit event contracts over large opaque state writes.", "- Use `storeToRefs` when destructuring store state/getters.", "- Treat mini-program runtime constraints as primary; do not assume Vue web-only behavior.");
 	if (supportsNativePages(templateName)) lines.push("  - `$native-to-weapp-vite-wevu-migration` when migrating native mini-program pages/components toward Vue SFC or wevu.", "", "## Native Mini-program Authoring", "", "- Keep native page/component structure consistent with the template unless there is a clear migration goal.", "- Prefer `weapp-vite generate` or `wv generate` for new app/page/component scaffolds.", "- If migrating this project toward Vue SFC or `wevu`, keep the migration explicit and prefer the official weapp-vite / wevu guidance first.");
+	if (supportsPlugin(templateName)) lines.push("", "## Plugin Authoring", "", "- Keep `src/` as the host app source and `plugin/` as the plugin source root declared by `weapp.pluginRoot`.", "- Validate both `dist/` and `dist-plugin/` outputs after structural changes to host pages, plugin pages, or plugin public components.", "- If you change plugin AppID or switch away from local `dev` linkage, update both `project.config.json.appid` and `src/app.json` -> `plugins.*.provider` together.", "- Treat shared modules under `shared/` as regular source code that can be imported by both host and plugin entries.");
 	return `${lines.join("\n")}\n`;
 }
 //#endregion
@@ -101,8 +106,8 @@ const TEMPLATE_CATALOG = {
 	"@icebreakers/stylelint-config": "^3.0.5",
 	"@iconify-json/mdi": "^1.2.3",
 	"@mini-types/alipay": "^3.0.14",
-	"@tailwindcss/postcss": "^4.2.2",
-	"@tailwindcss/vite": "^4.2.2",
+	"@tailwindcss/postcss": "^4.2.4",
+	"@tailwindcss/vite": "^4.2.4",
 	"@types/node": "^25.6.0",
 	"@types/semver": "^7.7.1",
 	"@vant/weapp": "^1.11.7",
@@ -119,7 +124,7 @@ const TEMPLATE_CATALOG = {
 	"lru-cache": "^11.3.5",
 	"magic-string": "^0.30.21",
 	"miniprogram-api-typings": "^5.1.2",
-	"oxc-parser": "^0.126.0",
+	"oxc-parser": "^0.127.0",
 	"oxc-walker": "^0.7.0",
 	"pkg-types": "^2.3.0",
 	"sass-embedded": "^1.99.0",
@@ -146,7 +151,7 @@ const TEMPLATE_CATALOG = {
 	rolldown: "1.0.0-rc.16",
 	sass: "^1.99.0",
 	stylelint: "^17.8.0",
-	tailwindcss: "^4.2.2",
+	tailwindcss: "^4.2.4",
 	tslib: "^2.8.1",
 	typescript: "^6.0.3",
 	vite: "8.0.9",
@@ -160,8 +165,8 @@ const TEMPLATE_NAMED_CATALOG = {
 		"miniprogram-api-typings": "^5.1.2",
 		typescript: "^6.0.3"
 	},
-	tailwind3: { tailwindcss: "3.4.19" },
-	tailwind4: { tailwindcss: "^4.2.2" }
+	tailwind3: { tailwindcss: "^4.2.4" },
+	tailwind4: { tailwindcss: "^4.2.4" }
 };
 //#endregion
 //#region src/npm.ts
@@ -379,6 +384,7 @@ const TOURIST_APP_ID = "touristappid";
 const moduleDir = path.dirname(fileURLToPath(import.meta.url));
 const TEMPLATE_DIR_MAP = {
 	["default"]: "weapp-vite-template",
+	["plugin"]: "weapp-vite-plugin-template",
 	["lib"]: "weapp-vite-lib-template",
 	["wevu"]: "weapp-vite-wevu-template",
 	["wevu-tdesign"]: "weapp-vite-wevu-tailwindcss-tdesign-template",
@@ -516,6 +522,11 @@ function normalizeTemplateDependencySpecs(pkgJson) {
 		}
 	}
 }
+function ensureManagedTypeScriptDevDependencies(pkgJson) {
+	pkgJson.devDependencies ??= {};
+	if (pkgJson.dependencies?.["@types/node"] || pkgJson.devDependencies["@types/node"] || pkgJson.peerDependencies?.["@types/node"] || pkgJson.optionalDependencies?.["@types/node"]) return;
+	pkgJson.devDependencies["@types/node"] = templateCatalogMap["@types/node"];
+}
 /**
 * @description 根据模板创建项目
 */
@@ -538,6 +549,7 @@ async function createProject(targetDir = "", templateName = "default", options =
 	}
 	const pkgJson = await fs.pathExists(templatePackagePath) ? await fs.readJSON(templatePackagePath) : createEmptyPackageJson();
 	normalizeTemplateDependencySpecs(pkgJson);
+	ensureManagedTypeScriptDevDependencies(pkgJson);
 	if (!pkgJson.devDependencies) pkgJson.devDependencies = {};
 	upsertExistingDependencyVersion(pkgJson, "weapp-vite", toCaretVersion(version));
 	upsertExistingDependencyVersion(pkgJson, "wevu", toCaretVersion(version$1));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-weapp-vite",
   "type": "module",
-  "version": "2.3.4",
+  "version": "2.3.5",
   "description": "create-weapp-vite",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",

package/templates/default/eslint.config.js

@@ -2,5 +2,5 @@ import { icebreaker } from '@icebreakers/eslint-config'
 
 export default icebreaker({
   miniProgram: true,
-  ignores: ['CHANGELOG.md', 'README.md', '.turbo/**'],
+  ignores: ['CHANGELOG.md', 'README.md', '.turbo/**', 'dist/**', '.weapp-vite/**'],
 })

package/templates/default/package.json

@@ -30,6 +30,7 @@
   "devDependencies": {
     "@icebreakers/eslint-config": "catalog:",
     "@icebreakers/stylelint-config": "catalog:",
+    "@types/node": "catalog:",
     "eslint": "catalog:",
     "miniprogram-api-typings": "catalog:",
     "sass": "catalog:",

package/templates/default/src/app.scss

@@ -0,0 +1 @@
+/* empty */

package/templates/default/src/components/HelloWorld/HelloWorld.scss

@@ -1,13 +1,13 @@
 .hello-card {
-  width: 640rpx;
-  margin: 48rpx auto;
-  padding: 32rpx;
-  border-radius: 32rpx;
-  background: #ffffff;
-  box-shadow: 0 20rpx 60rpx rgba(15, 23, 42, 0.08);
   display: flex;
   flex-direction: column;
   gap: 24rpx;
+  width: 640rpx;
+  padding: 32rpx;
+  margin: 48rpx auto;
+  background: #fff;
+  border-radius: 32rpx;
+  box-shadow: 0 20rpx 60rpx rgb(15 23 42 / 8%);
 }
 
 .hello-title {
@@ -30,15 +30,15 @@
 
 .hello-button {
   padding: 16rpx 32rpx;
-  border-radius: 999rpx;
-  background: #2563eb;
-  color: #ffffff;
   font-size: 26rpx;
+  color: #fff;
+  background: #2563eb;
+  border-radius: 999rpx;
 }
 
 .hello-button--ghost {
-  background: #e2e8f0;
   color: #1e293b;
+  background: #e2e8f0;
 }
 
 .hello-tip {

package/templates/default/src/pages/index/index.scss

@@ -0,0 +1 @@
+/* empty */

package/templates/lib/eslint.config.js

@@ -3,5 +3,5 @@ import { icebreaker } from '@icebreakers/eslint-config'
 export default icebreaker({
   miniProgram: true,
   vue: true,
-  ignores: ['CHANGELOG.md', 'README.md', 'dist-lib/**', '.turbo/**'],
+  ignores: ['CHANGELOG.md', 'README.md', '.turbo/**', 'dist/**', 'dist-lib/**', '.weapp-vite/**'],
 })

package/templates/lib/package.json

@@ -1,7 +1,7 @@
 {
   "name": "weapp-vite-lib-template",
   "type": "module",
-  "version": "6.0.11",
+  "version": "6.0.12",
   "private": true,
   "description": "weapp-vite 组件库（lib 模式）模板",
   "author": "ice breaker <1324318532@qq.com>",
@@ -34,6 +34,7 @@
   "devDependencies": {
     "@icebreakers/eslint-config": "catalog:",
     "@icebreakers/stylelint-config": "catalog:",
+    "@types/node": "catalog:",
     "eslint": "catalog:",
     "miniprogram-api-typings": "catalog:",
     "sass": "catalog:",

package/templates/lib/src/app.scss

@@ -0,0 +1 @@
+/* empty */

package/templates/lib/src/components/HelloWorld/HelloWorld.scss

@@ -1,13 +1,13 @@
 .hello-card {
-  width: 640rpx;
-  margin: 48rpx auto;
-  padding: 32rpx;
-  border-radius: 32rpx;
-  background: #ffffff;
-  box-shadow: 0 20rpx 60rpx rgba(15, 23, 42, 0.08);
   display: flex;
   flex-direction: column;
   gap: 24rpx;
+  width: 640rpx;
+  padding: 32rpx;
+  margin: 48rpx auto;
+  background: #fff;
+  border-radius: 32rpx;
+  box-shadow: 0 20rpx 60rpx rgb(15 23 42 / 8%);
 }
 
 .hello-title {
@@ -30,15 +30,15 @@
 
 .hello-button {
   padding: 16rpx 32rpx;
-  border-radius: 999rpx;
-  background: #2563eb;
-  color: #ffffff;
   font-size: 26rpx;
+  color: #fff;
+  background: #2563eb;
+  border-radius: 999rpx;
 }
 
 .hello-button--ghost {
-  background: #e2e8f0;
   color: #1e293b;
+  background: #e2e8f0;
 }
 
 .hello-tip {

package/templates/lib/src/components/sfc-setup/index.vue

@@ -77,9 +77,9 @@ defineExpose({
 <style>
 .card {
   padding: 20rpx;
-  border-radius: 16rpx;
-  border: 2rpx solid transparent;
   background: #eff6ff;
+  border: 2rpx solid transparent;
+  border-radius: 16rpx;
 }
 
 .title {
@@ -102,16 +102,16 @@ defineExpose({
 
 .btn {
   padding: 8rpx 16rpx;
-  border-radius: 999rpx;
-  border: 2rpx solid #1d4ed8;
-  background: #1d4ed8;
-  color: #eff6ff;
   font-size: 22rpx;
+  color: #eff6ff;
+  background: #1d4ed8;
+  border: 2rpx solid #1d4ed8;
+  border-radius: 999rpx;
 }
 
 .btn.ghost {
-  background: transparent;
   color: #1d4ed8;
+  background: transparent;
 }
 
 .tone-info {
@@ -142,7 +142,7 @@ defineExpose({
 }
 
 .is-active {
-  box-shadow: 0 0 0 4rpx rgba(29, 78, 216, 0.2);
+  box-shadow: 0 0 0 4rpx rgb(29 78 216 / 20%);
 }
 
 .has-count .title {

package/templates/plugin/.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true

package/templates/plugin/README.md

@@ -0,0 +1,35 @@
+# weapp-vite-plugin-template
+
+`weapp-vite` 小程序插件模板，内置宿主小程序、`pluginRoot` 和共享 TS 模块示例。
+
+## 使用方式
+
+### 开发
+
+- `pnpm dev`
+- `pnpm dev:open` 可以打包并直接启动微信开发者工具
+
+### 构建
+
+`pnpm build`
+
+### 打开微信开发者工具
+
+`pnpm open`
+
+## 目录说明
+
+- `src/`: 宿主小程序源码
+- `plugin/`: 插件源码，包含 `plugin.json`、公开组件与页面
+- `shared/`: 主包与插件共享的 TypeScript 模块
+
+## 使用提示
+
+- 模板默认通过 `weapp.pluginRoot` 输出 `dist-plugin/**`
+- `src/app.json` 里预置了 `hello-plugin` 的 `provider`
+- 如果你要在自己的插件 AppID 下调试或上传，请先替换 `project.config.json` 的 `appid`，并同步修改 `src/app.json` 里的 `plugins.hello-plugin.provider`
+
+## 文档地址
+
+0. `weapp-vite`: https://vite.icebreaker.top/
+1. 插件开发说明: https://vite.icebreaker.top/guide/plugin

package/templates/plugin/eslint.config.js

@@ -0,0 +1,6 @@
+import { icebreaker } from '@icebreakers/eslint-config'
+
+export default icebreaker({
+  miniProgram: true,
+  ignores: ['CHANGELOG.md', 'README.md', '.turbo/**', 'dist/**', 'dist-plugin/**', '.weapp-vite/**'],
+})

package/templates/plugin/gitignore

@@ -0,0 +1,36 @@
+# dependencies
+node_modules
+.pnp
+.pnp.js
+
+# testing
+coverage
+
+# next.js
+.next/
+out/
+build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# local env files
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# turbo
+.turbo
+
+dist
+vite.config.ts.timestamp-*.mjs
+dist-web
+.weapp-vite/

package/templates/plugin/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "weapp-vite-plugin-template",
+  "type": "module",
+  "version": "1.0.0",
+  "private": true,
+  "description": "微信小程序插件模板",
+  "author": "ice breaker <1324318532@qq.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/weapp-vite/weapp-vite.git",
+    "directory": "templates/weapp-vite-plugin-template"
+  },
+  "bugs": {
+    "url": "https://github.com/weapp-vite/weapp-vite/issues"
+  },
+  "keywords": [],
+  "scripts": {
+    "dev": "wv dev",
+    "dev:open": "wv dev -o",
+    "build": "wv build",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "open": "wv open",
+    "stylelint": "stylelint \"{src,plugin,shared}/**/*.{css,scss,vue,wxss}\" --allow-empty-input",
+    "stylelint:fix": "stylelint \"{src,plugin,shared}/**/*.{css,scss,vue,wxss}\" --fix --allow-empty-input",
+    "g": "wv generate",
+    "postinstall": "wv prepare"
+  },
+  "dependencies": {
+    "dayjs": "catalog:"
+  },
+  "devDependencies": {
+    "@icebreakers/eslint-config": "catalog:",
+    "@icebreakers/stylelint-config": "catalog:",
+    "@types/node": "catalog:",
+    "eslint": "catalog:",
+    "miniprogram-api-typings": "catalog:",
+    "sass": "catalog:",
+    "stylelint": "catalog:",
+    "typescript": "catalog:",
+    "weapp-vite": "workspace:*",
+    "wevu": "workspace:*"
+  }
+}