@koishi-ce/client 1.0.0

package/client/utils.ts

@@ -0,0 +1,36 @@
+import * as cordis from "cordis";
+import { markRaw } from "vue";
+import type { Context } from "./context";
+
+/**
+ * 前端服务基类：继承 cordis.Service 并固定为本库的 Context 类型。
+ * 各核心服务（action / i18n / loader / router / setting / theme）均由此派生。
+ */
+export abstract class Service<
+	T = unknown,
+	C extends Context = Context,
+> extends cordis.Service<T, C> {}
+
+/** 可排序项：实现本接口的条目可被 insert() 按 order 插入有序列表 */
+export interface Ordered {
+	order?: number;
+}
+
+/**
+ * 按 order 升序将条目插入有序列表（相同 order 的后者排在后面）。
+ * 同时 markRaw 标记条目，避免其被 Vue 深度代理。
+ */
+export function insert<T extends Ordered>(list: T[], item: T) {
+	markRaw(item);
+	// order 为可选属性：任一侧缺失（undefined）时数值比较结果恒为 false，
+	// 与原实现（直接比较）在所有输入下的求值结果一致，这里显式判空以通过严格空检查
+	const index = list.findIndex(
+		(a) =>
+			a.order !== undefined && item.order !== undefined && a.order < item.order,
+	);
+	if (index >= 0) {
+		list.splice(index, 0, item);
+	} else {
+		list.push(item);
+	}
+}

package/global.d.ts

@@ -0,0 +1,24 @@
+/// <reference types="vue-i18n" />
+/// <reference types="vite/client" />
+/// <reference types="element-plus/global" />
+
+// 以下为消费本包（@koishi-ce/client/global）的插件工程提供的环境类型垫片：
+// .vue 单文件组件与 yaml / yml 文案文件在此仅声明为无结构导出，
+// 具体类型由各工程的构建工具链（vite 插件）在编译期处理
+
+declare module "*.vue" {
+	import { Component } from "vue";
+
+	const component: Component;
+	export default component;
+}
+
+declare module "*.yaml" {
+	const content: Record<never, never>;
+	export default content;
+}
+
+declare module "*.yml" {
+	const content: Record<never, never>;
+	export default content;
+}

package/lib/bin.d.ts

@@ -0,0 +1 @@
+export {}

package/lib/bin.mjs

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+import { t as build } from "./src-Bxzzi1Rx.mjs";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+//#endregion
+//#region src/bin.ts
+/**
+* `koishi-console` CLI 入口（构建产物 lib/bin.mjs 由 package.json 的
+* bin 字段指向，仓库内亦可用 Bun 直接运行本源文件）。
+*
+* 极简手写 CLI（不引 CLI 框架）：仅 `build [root]` 一个子命令 +
+* help/version。带 root（或 cwd 本身是含 client/ 的插件目录）时构建
+* 该 webui 插件的前端；否则执行宿主控制台前端总装（scripts/client.ts，
+* 产物写入 plugins/webui/console/dist）。
+*/
+const { version } = {
+	name: "@koishi-ce/client",
+	description: "Koishi Console Client",
+	version: "1.0.0",
+	type: "module",
+	main: "client/index.ts",
+	exports: {
+		".": {
+			"source": "./src/index.ts",
+			"default": "./client/index.ts"
+		},
+		"./global": "./global.d.ts",
+		"./bin": "./lib/bin.mjs",
+		"./lib": "./lib/index.mjs",
+		"./package.json": "./package.json"
+	},
+	files: [
+		"app",
+		"client",
+		"lib",
+		"src",
+		"global.d.ts"
+	],
+	bin: { "koishi-console": "./lib/bin.mjs" },
+	contributors: ["Shigma <shigma10826@gmail.com>", "Oppenheymu <oppenheymu@gmail.com>"],
+	license: "AGPL-3.0",
+	repository: {
+		"type": "git",
+		"url": "git+https://github.com/Koishi-CE/koishi.git",
+		"directory": "packages/web/client"
+	},
+	bugs: { "url": "https://github.com/Koishi-CE/koishi/issues" },
+	homepage: "https://koishi.chat",
+	keywords: [
+		"bot",
+		"chatbot",
+		"koishi",
+		"plugin",
+		"webui",
+		"console",
+		"build"
+	],
+	dependencies: {
+		"@koishi-ce/components": "workspace:*",
+		"@satorijs/protocol": "^1.7.0",
+		"@vitejs/plugin-vue": "^6.0.8",
+		"@vueuse/core": "^14.4.0",
+		"cordis": "^3.18.1",
+		"cosmokit": "^1.8.1",
+		"element-plus": "^2.14.5",
+		"marked-vue": "^1.3.0",
+		"sass-embedded": "^1.102.0",
+		"unocss": "^66.8.1",
+		"vite": "^8.2.2",
+		"vue": "^3.5.42",
+		"vue-i18n": "^11.4.10",
+		"vue-router": "^5.2.0"
+	}
+};
+const help = `koishi-console/${version}
+
+Usage:
+  $ koishi-console <command> [options]
+
+Commands:
+  build [root]  build the frontend of given webui plugin, or the host
+                console when omitted (or when cwd has no client/ dir)
+
+Options:
+  -h, --help     Display this message
+  -v, --version  Display version number`;
+async function main() {
+	const [command, ...args] = process.argv.slice(2);
+	if (command === void 0 || command === "-h" || command === "--help") {
+		console.log(help);
+		return;
+	}
+	if (command === "-v" || command === "--version") {
+		console.log(`koishi-console/${version}`);
+		return;
+	}
+	if (command === "build") {
+		const target = args.find((arg) => !arg.startsWith("-")) ?? (existsSync("client") ? "." : void 0);
+		if (target !== void 0) {
+			await build(resolve(process.cwd(), target));
+			return;
+		}
+		await (await import("./client-CaTn_gVG.mjs")).default();
+		return;
+	}
+	console.error(`Unknown command ${JSON.stringify(command)}.`);
+	console.log(help);
+	process.exitCode = 1;
+}
+await main();
+//#endregion
+export {};

package/lib/client-CaTn_gVG.mjs

@@ -0,0 +1,125 @@
+import { t as yaml } from "./yaml-UzQbvquH.mjs";
+import { createRequire } from "node:module";
+import { appendFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import vue from "@vitejs/plugin-vue";
+import * as vite from "vite";
+import mini from "unocss/preset-mini";
+import unocss from "unocss/vite";
+//#region \0rolldown/runtime.js
+var __require = /* #__PURE__ */ (() => createRequire(import.meta.url))();
+//#endregion
+//#region scripts/client.ts
+/**
+* 宿主控制台前端的总装构建脚本（编程式 vite.build，本仓库没有 vite 配置文件）。
+*
+* 产物目录硬编码为 `plugins/webui/console/dist/`，内容分四部分：
+* - 主应用（本包 `app/` 目录）→ `index.js`
+* - client 组件库（本包 `client/` 目录）→ `client.js`（element-plus 单独成 chunk）
+* - vue / vue-router / @vueuse/core 三个运行时共享包 → `vue.js` 等，
+*   供主应用、client 与所有 webui 插件以 external 依赖的方式共享
+*/
+/**
+* 定位某个依赖包在 node_modules 中的安装目录。
+*
+* @param id 依赖包名（须能被 require.resolve 解析到）
+* @returns 形如 `<前缀>/node_modules/<id>` 的目录路径（统一为正斜杠）
+*/
+function findModulePath(id) {
+	const path = __require.resolve(id).replace(/\\/g, "/");
+	const keyword = `/node_modules/${id}/`;
+	return path.slice(0, path.indexOf(keyword)) + keyword.slice(0, -1);
+}
+const cwd = resolve(import.meta.dir, "../../../..");
+const dist = `${cwd}/plugins/webui/console/dist`;
+/**
+* 通用构建函数：以 `root` 为构建根目录打一个 ES 模块包到 console dist。
+*
+* @param root 构建根目录（决定默认入口与 html 所在位置）
+* @param config 额外的 vite 配置，逐层合并覆盖下方默认值
+* @param isClient 标记本次构建的是否为 client 组件库本体。仅该构建需要
+*   真实打包 vue-i18n（见下方别名说明），其余构建一律复用宿主的 client.js
+* @returns rollup 构建结果（供调用方进一步处理产物）
+*/
+async function build(root, config = {}, isClient = false) {
+	const { rollupOptions = {} } = config.build || {};
+	return await vite.build({
+		root,
+		build: {
+			outDir: `${cwd}/plugins/webui/console/dist`,
+			emptyOutDir: true,
+			cssCodeSplit: false,
+			chunkSizeWarningLimit: 1024,
+			...config.build,
+			rollupOptions: {
+				...rollupOptions,
+				makeAbsoluteExternalsRelative: true,
+				external: [
+					`${root}/vue.js`,
+					`${root}/vue-router.js`,
+					`${root}/client.js`,
+					`${root}/vueuse.js`
+				],
+				output: {
+					format: "module",
+					entryFileNames: "[name].js",
+					chunkFileNames: "[name].js",
+					assetFileNames: "[name].[ext]",
+					...rollupOptions.output
+				}
+			}
+		},
+		plugins: [
+			vue(),
+			yaml(),
+			...config.plugins || []
+		],
+		resolve: { alias: {
+			vue: `${root}/vue.js`,
+			"vue-router": `${root}/vue-router.js`,
+			"@vueuse/core": `${root}/vueuse.js`,
+			"@koishi-ce/client": `${root}/client.js`,
+			"schemastery-vue/client": `${cwd}/packages/web/components/client/schemastery-vue-runtime.ts`,
+			...isClient ? { "vue-i18n": findModulePath("vue-i18n") + "/dist/vue-i18n.esm-browser.prod.js" } : { "vue-i18n": `${root}/client.js` }
+		} }
+	});
+}
+async function client_default() {
+	const { output } = await build(`${cwd}/packages/web/client/app`, { plugins: [unocss({ presets: [mini({ preflight: false })] })] });
+	await Promise.all([
+		Bun.write(`${dist}/vue.js`, Bun.file(`${findModulePath("vue")}/dist/vue.runtime.esm-browser.prod.js`)),
+		build(`${findModulePath("vue-router")}/dist`, { build: {
+			outDir: dist,
+			emptyOutDir: false,
+			rollupOptions: {
+				input: { "vue-router": `${findModulePath("vue-router")}/dist/vue-router.esm-browser.js` },
+				preserveEntrySignatures: "strict"
+			}
+		} }),
+		build(findModulePath("@vueuse/core"), { build: {
+			outDir: dist,
+			emptyOutDir: false,
+			rollupOptions: {
+				input: { vueuse: `${findModulePath("@vueuse/core")}/dist/index.js` },
+				preserveEntrySignatures: "strict"
+			}
+		} })
+	]);
+	await build(`${cwd}/packages/web/client/client`, { build: {
+		outDir: dist,
+		emptyOutDir: false,
+		rollupOptions: {
+			input: { client: `${cwd}/packages/web/client/client/index.ts` },
+			output: { manualChunks(id) {
+				return id.includes("element-plus") ? "element" : void 0;
+			} },
+			preserveEntrySignatures: "strict"
+		}
+	} }, true);
+	for (const file of output) if (file.type === "asset" && file.name === "style.css") {
+		if (file.source === void 0) continue;
+		await appendFile(`${dist}/style.css`, file.source);
+	}
+}
+//#endregion
+export { client_default as default };

package/lib/index.d.ts

@@ -0,0 +1,20 @@
+import * as vite from "vite";
+//#region src/index.d.ts
+/**
+ * 构建单个 webui 插件的前端产物。
+ *
+ * @param root 插件目录（无 `client/` 子目录时视为该插件没有前端，直接跳过）
+ * @param config 额外的 vite 配置，逐层合并覆盖下方默认值
+ */
+declare function build(root: string, config?: vite.UserConfig): Promise<void>;
+/**
+ * 创建开发模式下的 vite dev server（middlewareMode，不监听独立端口，
+ * 由宿主 HTTP 服务挂载到 `/vite/` 前缀下）。
+ *
+ * @param baseDir 用于圈定文件访问范围的工作区根目录
+ * @param config 额外的 vite 配置
+ * @returns vite 的 ViteDevServer 实例
+ */
+declare function createServer(baseDir: string, config?: vite.InlineConfig): Promise<vite.ViteDevServer>;
+//#endregion
+export { build, createServer };

package/lib/index.mjs

@@ -0,0 +1,2 @@
+import { n as createServer, t as build } from "./src-Bxzzi1Rx.mjs";
+export { build, createServer };

package/lib/src-Bxzzi1Rx.mjs

@@ -0,0 +1,160 @@
+import { t as yaml } from "./yaml-UzQbvquH.mjs";
+import { existsSync } from "node:fs";
+import { mkdir, rm } from "node:fs/promises";
+import { resolve } from "node:path";
+import vue from "@vitejs/plugin-vue";
+import * as vite from "vite";
+//#region src/index.ts
+/**
+* @koishi-ce/client 构建入口。
+*
+* 提供两个编程式 API（本仓库的前端构建没有 vite 配置文件，全部在此完成）：
+* - `build(root)`：构建单个 webui 插件的前端（`<插件目录>/client/` → `dist/`），
+*   由 `koishi-console` CLI（src/bin.ts）暴露给各插件使用；
+* - `createServer(baseDir)`：创建开发模式的 vite 中间件服务器。
+*/
+async function collectWorkspaceAliases() {
+	const repoRoot = resolve(import.meta.dir, "../../../..").replace(/\\/g, "/");
+	const manifest = await Bun.file(`${repoRoot}/package.json`).json();
+	const aliases = {};
+	for (const pattern of manifest.workspaces ?? []) {
+		const files = new Bun.Glob(`${pattern}/package.json`).scanSync({ cwd: repoRoot });
+		for (const file of files) {
+			const dir = `${repoRoot}/${file.replaceAll("\\", "/").slice(0, -13)}`;
+			try {
+				const { name } = await Bun.file(`${dir}/package.json`).json();
+				if (!name) continue;
+				const clientEntry = `${dir}/client/index.ts`;
+				if (existsSync(`${dir}/src`)) aliases[`${name}/src`] = `${dir}/src`;
+				if (existsSync(clientEntry)) aliases[`${name}/client`] = clientEntry;
+				aliases[name] = existsSync(clientEntry) ? clientEntry : `${dir}/src`;
+			} catch {}
+		}
+	}
+	return aliases;
+}
+const workspaceAliases = await collectWorkspaceAliases();
+const runtimeShimPath = (workspaceAliases["@koishi-ce/components"] ?? "").replace(/client\/index\.ts$/, "client/schemastery-vue-runtime.ts");
+/**
+* 构建单个 webui 插件的前端产物。
+*
+* @param root 插件目录（无 `client/` 子目录时视为该插件没有前端，直接跳过）
+* @param config 额外的 vite 配置，逐层合并覆盖下方默认值
+*/
+async function build(root, config = {}) {
+	if (!existsSync(`${root}/client`)) return;
+	const outDir = `${root}/dist`;
+	if (existsSync(outDir)) await rm(outDir, { recursive: true });
+	await mkdir(outDir, { recursive: true });
+	const results = await vite.build(vite.mergeConfig({
+		root,
+		build: {
+			write: false,
+			outDir: "dist",
+			assetsDir: "",
+			minify: true,
+			emptyOutDir: true,
+			commonjsOptions: { strictRequires: true },
+			lib: {
+				entry: `${root}/client/index.ts`,
+				fileName: "index",
+				formats: ["es"]
+			},
+			rollupOptions: {
+				makeAbsoluteExternalsRelative: true,
+				onwarn(warning, warn) {
+					if (warning.message.includes("is being imported multiple times")) return;
+					warn(warning);
+				},
+				external: [
+					"vue",
+					"vue-router",
+					"@vueuse/core",
+					"@koishi-ce/client"
+				],
+				output: { format: "iife" }
+			}
+		},
+		plugins: [
+			vue(),
+			yaml(),
+			(await import("unocss/vite")).default({ presets: [(await import("unocss/preset-mini")).default({ preflight: false })] })
+		],
+		resolve: { alias: {
+			...workspaceAliases,
+			"vue-i18n": "@koishi-ce/client",
+			"@koishi-ce/components": "@koishi-ce/client",
+			"@koishijs/components": workspaceAliases["@koishi-ce/components"],
+			"schemastery-vue/client": runtimeShimPath
+		} },
+		define: { "process.env.NODE_ENV": "\"production\"" }
+	}, config));
+	for (const item of results[0]?.output ?? []) {
+		const dest = `${root}/dist/${item.fileName === "index.mjs" ? "index.js" : item.fileName}`;
+		if (item.type === "asset") {
+			if (item.source === void 0) continue;
+			await Bun.write(dest, item.source);
+		} else if (item.code !== void 0) {
+			const { code } = await vite.minify(dest, item.code, {
+				compress: false,
+				mangle: false
+			});
+			await Bun.write(dest, code);
+		}
+	}
+}
+/**
+* 创建开发模式下的 vite dev server（middlewareMode，不监听独立端口，
+* 由宿主 HTTP 服务挂载到 `/vite/` 前缀下）。
+*
+* @param baseDir 用于圈定文件访问范围的工作区根目录
+* @param config 额外的 vite 配置
+* @returns vite 的 ViteDevServer 实例
+*/
+async function createServer(baseDir, config = {}) {
+	const root = resolve(import.meta.dir, "../app");
+	return vite.createServer(vite.mergeConfig({
+		root,
+		base: "/vite/",
+		server: {
+			middlewareMode: true,
+			fs: { allow: [vite.searchForWorkspaceRoot(baseDir)] }
+		},
+		plugins: [
+			vue(),
+			yaml(),
+			(await import("unocss/vite")).default({ presets: [(await import("unocss/preset-mini")).default({ preflight: false })] })
+		],
+		resolve: {
+			dedupe: [
+				"vue",
+				"vue-demi",
+				"vue-router",
+				"element-plus",
+				"@vueuse/core",
+				"@popperjs/core",
+				"marked",
+				"xss"
+			],
+			alias: {
+				"../client.js": "@koishi-ce/client",
+				"../vue.js": "vue",
+				"../vue-router.js": "vue-router",
+				"../vueuse.js": "@vueuse/core",
+				"schemastery-vue/client": runtimeShimPath
+			}
+		},
+		optimizeDeps: { include: [
+			"vue",
+			"vue-router",
+			"element-plus",
+			"@vueuse/core",
+			"@popperjs/core",
+			"marked",
+			"xss"
+		] },
+		build: { rollupOptions: { input: `${root}/index.html` } }
+	}, config));
+}
+//#endregion
+export { createServer as n, build as t };

package/lib/yaml-UzQbvquH.mjs

@@ -0,0 +1,23 @@
+//#region src/yaml.ts
+/**
+* .yml/.yaml → JS 模块的 vite 转换插件（替代 @maikolib/vite-plugin-yaml）。
+*
+* 构建脚本统一以 Bun 执行，YAML 解析走 Bun 内置的 Bun.YAML，不再引入 js-yaml
+* （其 4.1.0 版本存在 GHSA-52cp-r559-cp3m / GHSA-5p4m-2wfm-xmqj 高危通告）。
+* 行为对齐原插件：默认导出解析结果，不产出 sourcemap 映射。
+*/
+function yaml() {
+	return {
+		name: "vite:transform-yaml",
+		transform(code, id) {
+			if (!/\.ya?ml$/.test(id)) return null;
+			const data = Bun.YAML.parse(code);
+			return {
+				code: `const data = ${JSON.stringify(data)};\nexport default data;`,
+				map: { mappings: "" }
+			};
+		}
+	};
+}
+//#endregion
+export { yaml as t };

package/package.json

@@ -0,0 +1,66 @@
+{
+    "name": "@koishi-ce/client",
+    "description": "Koishi Console Client",
+    "version": "1.0.0",
+    "type": "module",
+    "main": "client/index.ts",
+    "exports": {
+        ".": {
+            "source": "./src/index.ts",
+            "default": "./client/index.ts"
+        },
+        "./global": "./global.d.ts",
+        "./bin": "./lib/bin.mjs",
+        "./lib": "./lib/index.mjs",
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "app",
+        "client",
+        "lib",
+        "src",
+        "global.d.ts"
+    ],
+    "bin": {
+        "koishi-console": "./lib/bin.mjs"
+    },
+    "contributors": [
+        "Shigma <shigma10826@gmail.com>",
+        "Oppenheymu <oppenheymu@gmail.com>"
+    ],
+    "license": "AGPL-3.0",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/Koishi-CE/koishi.git",
+        "directory": "packages/web/client"
+    },
+    "bugs": {
+        "url": "https://github.com/Koishi-CE/koishi/issues"
+    },
+    "homepage": "https://koishi.chat",
+    "keywords": [
+        "bot",
+        "chatbot",
+        "koishi",
+        "plugin",
+        "webui",
+        "console",
+        "build"
+    ],
+    "dependencies": {
+        "@koishi-ce/components": "^1.0.0",
+        "@satorijs/protocol": "^1.7.0",
+        "@vitejs/plugin-vue": "^6.0.8",
+        "@vueuse/core": "^14.4.0",
+        "cordis": "^3.18.1",
+        "cosmokit": "^1.8.1",
+        "element-plus": "^2.14.5",
+        "marked-vue": "^1.3.0",
+        "sass-embedded": "^1.102.0",
+        "unocss": "^66.8.1",
+        "vite": "^8.2.2",
+        "vue": "^3.5.42",
+        "vue-i18n": "^11.4.10",
+        "vue-router": "^5.2.0"
+    }
+}

package/src/bin.ts

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+/**
+ * `koishi-console` CLI 入口（构建产物 lib/bin.mjs 由 package.json 的
+ * bin 字段指向，仓库内亦可用 Bun 直接运行本源文件）。
+ *
+ * 极简手写 CLI（不引 CLI 框架）：仅 `build [root]` 一个子命令 +
+ * help/version。带 root（或 cwd 本身是含 client/ 的插件目录）时构建
+ * 该 webui 插件的前端；否则执行宿主控制台前端总装（scripts/client.ts，
+ * 产物写入 plugins/webui/console/dist）。
+ */
+
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import pkg from "../package.json" with { type: "json" };
+
+const { version } = pkg;
+
+import { build } from "./index.ts";
+
+const help = `koishi-console/${version}
+
+Usage:
+  $ koishi-console <command> [options]
+
+Commands:
+  build [root]  build the frontend of given webui plugin, or the host
+                console when omitted (or when cwd has no client/ dir)
+
+Options:
+  -h, --help     Display this message
+  -v, --version  Display version number`;
+
+async function main() {
+	const [command, ...args] = process.argv.slice(2);
+	if (command === undefined || command === "-h" || command === "--help") {
+		console.log(help);
+		return;
+	}
+	if (command === "-v" || command === "--version") {
+		console.log(`koishi-console/${version}`);
+		return;
+	}
+	if (command === "build") {
+		// root 缺省时：cwd 是插件目录则构建它，否则视为宿主总装
+		const root = args.find((arg) => !arg.startsWith("-"));
+		const target = root ?? (existsSync("client") ? "." : undefined);
+		if (target !== undefined) {
+			await build(resolve(process.cwd(), target));
+			return;
+		}
+		const host = await import("../scripts/client.ts");
+		await host.default();
+		return;
+	}
+	console.error(`Unknown command ${JSON.stringify(command)}.`);
+	console.log(help);
+	process.exitCode = 1;
+}
+
+await main();