create-koishi-ce 1.6.4 → 1.7.0

package/README.md

@@ -27,7 +27,7 @@ npm create koishi-ce my-app
 
 ## 生成的项目
 
-- **package.json**：`type: module`、`packageManager` 钉 Bun、workspaces 含 `plugins/*` 与 `external/*`；dependencies 预装全套 `@koishi-ce` 常用插件（console、config、market、auth、admin、help、sandbox、database-sqlite 等），并预置四行 npm alias 钉住上游名——`koishi` / `@koishijs/core` / `@koishijs/loader` 指向 `@koishi-ce/koishi-shim`、`@koishijs/plugin-console` 指向 `@koishi-ce/console-shim`，社区插件由此全部解析到 CE 框架；
+- **package.json**：`type: module`、`packageManager` 钉 Bun、workspaces 含 `plugins/*` 与 `external/*`；dependencies 预装全套 `@koishi-ce` 常用插件（console、config、market、auth、admin、help、sandbox、database-sqlite 等），并预置六行 npm alias 钉住上游名——`koishi` / `@koishijs/core` / `@koishijs/loader` 指向 `@koishi-ce/koishi-shim`、`@koishijs/plugin-console` 指向 `@koishi-ce/console-shim`、`@koishijs/client` / `@koishijs/components` 分别指向 `@koishi-ce/client-shim` / `@koishi-ce/components-shim`，社区插件（含把上游前端库写进 dependencies 的 webui 插件）由此全部解析到 CE 对应包；
 - **koishi.yml**：按 server（端口 5140-5149）/ basic / console（自动打开、市场指向 registry.koishi.chat 镜像）/ storage / adapter / develop（开发模式启用热重载）分组预写；官方 adapter 插件以 `~` 停用条目预写、不预装，装好后在控制台按需启用；数据库开箱即用——`database-sqlite` 默认启用，mongo / mysql / postgres 等其余 database 不预写占位条目，市场安装后自动出现；
 - **开发工具链**：devDependencies 预置 `@koishi-ce/client`、`@koishi-ce/plugin-hmr` 与 `@koishi-ce/scripts`（`koishi-scripts setup` 可在 external/ 下继续创建插件项目）。
 

package/lib/bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env bun
-import { t as start } from "./src-D2Fw0uXq.mjs";
+import { t as start } from "./src-Cj4uFpkr.mjs";
 //#region src/bin.ts
 /**
 * create-koishi-ce 的 CLI 可执行入口：shebang 由 rolldown 原样保留到

package/lib/index.mjs

@@ -1,2 +1,2 @@
-import { a as renderManifest, i as readNpmrcRegistry, n as detectAgent, r as getLocalRegistry, t as start } from "./src-D2Fw0uXq.mjs";
+import { a as renderManifest, i as readNpmrcRegistry, n as detectAgent, r as getLocalRegistry, t as start } from "./src-Cj4uFpkr.mjs";
 export { detectAgent, getLocalRegistry, readNpmrcRegistry, renderManifest, start };

package/lib/{src-D2Fw0uXq.mjs → src-Cj4uFpkr.mjs}

@@ -9,7 +9,7 @@ import { downloadTemplate } from "giget";
 var package_default = {
 	name: "create-koishi-ce",
 	description: "Setup a Koishi application",
-	version: "1.6.4",
+	version: "1.7.0",
 	type: "module",
 	main: "./lib/index.mjs",
 	module: "./lib/index.mjs",
@@ -157,10 +157,12 @@ function writePackageJson(rootDir, project, prod) {
 *   均以 Bun 为准（ESM-only 产物，Bun 原生加载 TS / yml）；脚本里的环境
 *   变量注入直接写 `NODE_ENV=... ` 前缀——bun run 走 Bun Shell，跨平台
 *   原生支持，无需 cross-env 一类的依赖；
-* - "koishi" 裸名与 @koishijs/core / @koishijs/loader / @koishijs/plugin-console
-*   上游名用 npm alias 钉到 @koishi-ce shim（版本冻结线，见 packages/shim）：
-*   上游官方 adapter / database 插件与社区 koishi-plugin-* 的 peer 由此满足，
-*   不会拉入 npm 官方全家桶形成第二份框架副本；市场安装亦不改写该声明
+* - "koishi" 裸名与 @koishijs/core / @koishijs/loader / @koishijs/plugin-console /
+*   @koishijs/client / @koishijs/components 上游名用 npm alias 钉到 @koishi-ce
+*   shim（版本冻结线，见 packages/shim）：上游官方 adapter / database 插件与
+*   社区 koishi-plugin-* 的 peer 由此满足，webui 插件写进 dependencies 的
+*   client / components 亦被钉住（满足性判定看落盘版本），不会拉入 npm
+*   官方全家桶形成第二份框架副本；市场安装亦不改写该声明
 *   （installer 的 isGuardedRequest 护栏将 npm:@koishi-ce alias 与
 *   workspace: 同等保护）；
 * - koishi.yml 采用配置页导出形态：插件键带 uid 实例后缀，分组带中文
@@ -255,7 +257,9 @@ function baseManifest() {
 			koishi: "npm:@koishi-ce/koishi-shim@^4.18.11",
 			"@koishijs/plugin-console": "npm:@koishi-ce/console-shim@^5.30.11",
 			"@koishijs/core": "npm:@koishi-ce/koishi-shim@4.18.11",
-			"@koishijs/loader": "npm:@koishi-ce/koishi-shim@^4.18.11"
+			"@koishijs/loader": "npm:@koishi-ce/koishi-shim@^4.18.11",
+			"@koishijs/client": "npm:@koishi-ce/client-shim@^5.30.11",
+			"@koishijs/components": "npm:@koishi-ce/components-shim@^1.5.22"
 		},
 		devDependencies: {
 			"@koishi-ce/client": "^1.0.0",
@@ -390,7 +394,7 @@ async function getName() {
 		initialValue: "koishi-app",
 		validate: (value) => value?.trim() ? void 0 : "项目名不能为空"
 	});
-	if (p.isCancel(answer)) process.exit(0);
+	if (p.isCancel(answer) || typeof answer !== "string") process.exit(0);
 	const trimmed = answer.trim();
 	if (!trimmed) process.exit(0);
 	return trimmed;

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "create-koishi-ce",
     "description": "Setup a Koishi application",
-    "version": "1.6.4",
+    "version": "1.7.0",
     "type": "module",
     "main": "./lib/index.mjs",
     "module": "./lib/index.mjs",

package/src/__tests__/template.test.ts

@@ -10,13 +10,16 @@ import {
 
 test("内置模板依赖纯度：不含任何 @koishijs / koishi-plugin 官方生态包", () => {
 	const { dependencies, devDependencies } = baseManifest();
-	// 四个上游名是刻意的 npm alias 占位（koishi 裸名 / @koishijs/plugin-console /
-	// @koishijs/core / @koishijs/loader），其余必须是 @koishi-ce 作用域
+	// 六个上游名是刻意的 npm alias 占位（koishi 裸名 / @koishijs/plugin-console /
+	// @koishijs/core / @koishijs/loader / @koishijs/client / @koishijs/components），
+	// 其余必须是 @koishi-ce 作用域
 	const guarded = new Set([
 		"koishi",
 		"@koishijs/plugin-console",
 		"@koishijs/core",
 		"@koishijs/loader",
+		"@koishijs/client",
+		"@koishijs/components",
 	]);
 	for (const key of Object.keys(dependencies ?? {})) {
 		expect(
@@ -96,6 +99,15 @@ test("内置模板钉住 console / core / loader 上游 peer 名，防 Bun 自
 	expect(dependencies?.["@koishijs/loader"]).toBe(
 		"npm:@koishi-ce/koishi-shim@^4.18.11",
 	);
+	// webui 插件把 client 写进 dependencies 的形态（napuketto 实证）：
+	// 版本冻结 5.30.x 线满足 ^5.x，官方 client（连带 components）不再落盘
+	expect(dependencies?.["@koishijs/client"]).toBe(
+		"npm:@koishi-ce/client-shim@^5.30.11",
+	);
+	// 官方 client 的硬依赖、插件生态常直接依赖；冻结 1.5.x 线满足 ^1.5
+	expect(dependencies?.["@koishijs/components"]).toBe(
+		"npm:@koishi-ce/components-shim@^1.5.22",
+	);
 });
 
 test("内置模板静态文件齐备，koishi.yml 预配 market 镜像源", () => {

package/src/index.ts

@@ -115,7 +115,10 @@ async function getName(): Promise<string> {
 		validate: (value) =>
 			value?.trim() ? undefined : "项目名不能为空",
 	});
-	if (p.isCancel(answer)) process.exit(0);
+	// @clack/core 1.5 的 isCancel 只收窄 unique symbol，而 text() 返回泛型
+	// symbol，需叠加 typeof 才能把类型收窄到 string
+	if (p.isCancel(answer) || typeof answer !== "string")
+		process.exit(0);
 	const trimmed = answer.trim();
 	if (!trimmed) process.exit(0);
 	return trimmed;

package/src/template/README.md

@@ -26,7 +26,7 @@ bun run dev          # 启动（开发模式，启用 HMR 热更新）
 
 推荐在控制台「插件市场」页安装（已预配 registry.koishi.chat 镜像源）；也可以手动 `bun add <包名>` 后在 `koishi.yml` 中启用。
 
-根依赖中的四行 npm alias——`"koishi": "npm:@koishi-ce/koishi-shim@^4.18.11"`、`"@koishijs/plugin-console": "npm:@koishi-ce/console-shim@^5.30.11"`、`"@koishijs/core": "npm:@koishi-ce/koishi-shim@4.18.11"`、`"@koishijs/loader": "npm:@koishi-ce/koishi-shim@^4.18.11"`——已把上游生态的 peer 依赖全部钉回 @koishi-ce 框架（前两行与后两行分别只涉及 koishi-shim / console-shim 两个包；**请勿删除或改写这四行**），不会形成第二份框架 / console / loader 副本。
+根依赖中的六行 npm alias——`"koishi": "npm:@koishi-ce/koishi-shim@^4.18.11"`、`"@koishijs/plugin-console": "npm:@koishi-ce/console-shim@^5.30.11"`、`"@koishijs/core": "npm:@koishi-ce/koishi-shim@4.18.11"`、`"@koishijs/loader": "npm:@koishi-ce/koishi-shim@^4.18.11"`、`"@koishijs/client": "npm:@koishi-ce/client-shim@^5.30.11"`、`"@koishijs/components": "npm:@koishi-ce/components-shim@^1.5.22"`——已把上游生态的 peer 与 dependencies 声明全部钉回 @koishi-ce 对应包（涉及 koishi-shim / console-shim / client-shim / components-shim 四个包；**请勿删除或改写这六行**），不会形成第二份框架 / console / 前端库副本。
 
 ## 更新依赖
 

package/src/template.ts

@@ -19,10 +19,12 @@
  *   均以 Bun 为准（ESM-only 产物，Bun 原生加载 TS / yml）；脚本里的环境
  *   变量注入直接写 `NODE_ENV=... ` 前缀——bun run 走 Bun Shell，跨平台
  *   原生支持，无需 cross-env 一类的依赖；
- * - "koishi" 裸名与 @koishijs/core / @koishijs/loader / @koishijs/plugin-console
- *   上游名用 npm alias 钉到 @koishi-ce shim（版本冻结线，见 packages/shim）：
- *   上游官方 adapter / database 插件与社区 koishi-plugin-* 的 peer 由此满足，
- *   不会拉入 npm 官方全家桶形成第二份框架副本；市场安装亦不改写该声明
+ * - "koishi" 裸名与 @koishijs/core / @koishijs/loader / @koishijs/plugin-console /
+ *   @koishijs/client / @koishijs/components 上游名用 npm alias 钉到 @koishi-ce
+ *   shim（版本冻结线，见 packages/shim）：上游官方 adapter / database 插件与
+ *   社区 koishi-plugin-* 的 peer 由此满足，webui 插件写进 dependencies 的
+ *   client / components 亦被钉住（满足性判定看落盘版本），不会拉入 npm
+ *   官方全家桶形成第二份框架副本；市场安装亦不改写该声明
  *   （installer 的 isGuardedRequest 护栏将 npm:@koishi-ce alias 与
  *   workspace: 同等保护）；
  * - koishi.yml 采用配置页导出形态：插件键带 uid 实例后缀，分组带中文
@@ -175,6 +177,15 @@ export function baseManifest(): Manifest {
 			// koishi-shim（4.18.11 满足 ^4.6.11），勿指回已废弃的 loader-shim
 			"@koishijs/loader":
 				"npm:@koishi-ce/koishi-shim@^4.18.11",
+			// 上游 client 名占位：第三方 webui 插件常把 @koishijs/client 写进
+			// dependencies（非 peer，napuketto 实证），无归属时 Bun 装下官方
+			// client 并连带官方 components 全家桶；版本冻结 5.30.x 线满足 ^5.x
+			"@koishijs/client":
+				"npm:@koishi-ce/client-shim@^5.30.11",
+			// 上游 components 名占位：官方 client 的硬依赖，插件生态亦常直接
+			// 依赖（element-plus 系共享组件库）；版本冻结 1.5.x 线满足 ^1.5
+			"@koishijs/components":
+				"npm:@koishi-ce/components-shim@^1.5.22",
 		},
 		devDependencies: {
 			"@koishi-ce/client": "^1.0.0",