@allbluecn/kernel 0.2.0

package/README.md

@@ -0,0 +1,36 @@
+# @allbluecn/kernel
+
+AllBlue 插件协议：类型定义 + 构建期装配器（零运行时）。
+
+## 安装
+
+```bash
+pnpm add @allbluecn/kernel
+```
+
+## 用法
+
+```ts
+import { definePlugin, defineProfile, resolvePluginOrder } from '@allbluecn/kernel'
+
+const auth = definePlugin({
+  id: '@allblue/auth',
+  version: '0.1.0',
+  contributes: {
+    features: [{ key: 'sso', tier: 'pro', module: 'auth' }],
+  },
+})
+
+const profile = defineProfile({
+  id: 'oss',
+  plugins: [auth],
+})
+
+const resolved = resolvePluginOrder(profile.plugins)
+```
+
+### CLI
+
+```bash
+pnpm allblue modules --profile oss
+```

package/dist/bin.d.ts

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

package/dist/bin.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { n as generateAssemblyCode, r as resolvePluginOrder, t as dumpModules } from "./src-Dvcggyr-.js";
+import { parseArgs } from "node:util";
+import { pathToFileURL } from "node:url";
+import { dirname, relative, resolve } from "node:path";
+//#region src/bin.ts
+const { values } = parseArgs({
+	allowPositionals: true,
+	options: {
+		profile: {
+			type: "string",
+			short: "p"
+		},
+		"gen-out": { type: "string" }
+	}
+});
+async function main() {
+	const profileArg = values.profile;
+	if (!profileArg) {
+		console.error("用法: allblue modules --profile <oss|saas|desktop> [--gen-out <file>]");
+		process.exit(1);
+	}
+	const profilePath = resolve(profileArg.endsWith(".ts") ? profileArg : `profiles/${profileArg}.ts`);
+	const profile = (await import(pathToFileURL(profilePath).href)).default;
+	const resolved = resolvePluginOrder(profile.plugins);
+	if (values["gen-out"]) {
+		const outPath = resolve(values["gen-out"]);
+		const relProfile = relImportPath(outPath, profilePath);
+		const code = generateAssemblyCode({
+			profileId: profile.id,
+			profileModulePath: relProfile,
+			resolved
+		});
+		const { writeFile } = await import("node:fs/promises");
+		await writeFile(outPath, code + "\n", "utf8");
+		console.log(`已生成 ${outPath} (${resolved.order.length} plugins)`);
+	}
+	console.log(dumpModules(profile.id, resolved));
+}
+function relImportPath(fromFile, toFile) {
+	let rel = relative(dirname(fromFile), toFile).replace(/\.ts$/, "");
+	if (!rel.startsWith(".")) rel = `./${rel}`;
+	return rel;
+}
+main().catch((error) => {
+	console.error(error instanceof Error ? error.message : error);
+	process.exit(1);
+});
+//#endregion
+export {};

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+import { ComponentType } from "react";
+//#region src/contributions.d.ts
+type ServerMiddleware = unknown;
+interface RouteContribution {
+  path: string;
+  route: unknown;
+}
+type QueryFactoryMap = Record<string, () => unknown>;
+type SlotComponentMap = Record<string, ComponentType>;
+interface FeatureContribution {
+  key: string;
+  tier: string;
+  module: string;
+}
+interface PrismaContribution {
+  models: string[];
+}
+interface PluginContributions {
+  routes?: RouteContribution[];
+  serverMiddleware?: ServerMiddleware[];
+  queryOptions?: QueryFactoryMap;
+  uiSlots?: SlotComponentMap;
+  features?: FeatureContribution[];
+  aiTools?: unknown[];
+  prisma?: PrismaContribution;
+}
+//#endregion
+//#region src/types.d.ts
+interface PluginDefinition {
+  id: string;
+  version: string;
+  dependencies?: string[];
+  contributes: PluginContributions;
+}
+//#endregion
+//#region src/define-profile.d.ts
+interface ProfileDefinition {
+  id: string;
+  plugins: PluginDefinition[];
+}
+declare function defineProfile(profile: ProfileDefinition): ProfileDefinition;
+//#endregion
+//#region src/define-plugin.d.ts
+declare function definePlugin(def: PluginDefinition): PluginDefinition;
+//#endregion
+//#region src/resolve-order.d.ts
+interface ResolveResult {
+  order: PluginDefinition[];
+  ids: string[];
+}
+declare function resolvePluginOrder(plugins: PluginDefinition[]): ResolveResult;
+//#endregion
+//#region src/generate-assembly.d.ts
+interface GenerateAssemblyInput {
+  profileId: string;
+  profileModulePath: string;
+  resolved: ResolveResult;
+}
+declare function generateAssemblyCode(input: GenerateAssemblyInput): string;
+//#endregion
+//#region src/dump-modules.d.ts
+declare function dumpModules(profileId: string, resolved: ResolveResult): string;
+//#endregion
+export { type FeatureContribution, type PluginContributions, type PluginDefinition, type PrismaContribution, type ProfileDefinition, type QueryFactoryMap, type ResolveResult, type RouteContribution, type SlotComponentMap, definePlugin, defineProfile, dumpModules, generateAssemblyCode, resolvePluginOrder };

package/dist/index.js

@@ -0,0 +1,2 @@
+import { a as definePlugin, i as defineProfile, n as generateAssemblyCode, r as resolvePluginOrder, t as dumpModules } from "./src-Dvcggyr-.js";
+export { definePlugin, defineProfile, dumpModules, generateAssemblyCode, resolvePluginOrder };

package/dist/src-Dvcggyr-.js

@@ -0,0 +1,122 @@
+//#region src/define-plugin.ts
+const PLUGIN_ID_RE = /^@[a-z0-9-]+\/[a-z0-9-]+$/;
+function definePlugin(def) {
+	if (!PLUGIN_ID_RE.test(def.id)) throw new Error(`插件 id 必须形如 '@scope/name'（小写），收到: ${def.id}`);
+	if (!/^\d+\.\d+\.\d+/.test(def.version)) throw new Error(`插件 version 必须是语义化版本，收到: ${def.version}`);
+	return deepFreeze(def);
+}
+function deepFreeze(value) {
+	if (value && typeof value === "object" && !Object.isFrozen(value)) {
+		Object.freeze(value);
+		for (const key of Object.keys(value)) deepFreeze(value[key]);
+	}
+	return value;
+}
+//#endregion
+//#region src/define-profile.ts
+const PROFILE_ID_RE = /^[a-z0-9][a-z0-9-]*$/;
+function defineProfile(profile) {
+	if (!PROFILE_ID_RE.test(profile.id)) throw new Error(`profile id 只允许小写字母/数字/连字符，收到: ${profile.id}`);
+	const seen = /* @__PURE__ */ new Set();
+	for (const plugin of profile.plugins) {
+		if (seen.has(plugin.id)) throw new Error(`profile 中存在重复插件 id: ${plugin.id}`);
+		seen.add(plugin.id);
+	}
+	return Object.freeze({
+		...profile,
+		plugins: Object.freeze([...profile.plugins])
+	});
+}
+//#endregion
+//#region src/resolve-order.ts
+function resolvePluginOrder(plugins) {
+	const byId = /* @__PURE__ */ new Map();
+	for (const plugin of plugins) {
+		if (byId.has(plugin.id)) throw new Error(`重复插件 id: ${plugin.id}`);
+		byId.set(plugin.id, plugin);
+	}
+	for (const plugin of plugins) for (const dep of plugin.dependencies ?? []) if (!byId.has(dep)) throw new Error(`插件 ${plugin.id} 依赖的 ${dep} 未在 profile 中声明`);
+	const declarationIndex = new Map(plugins.map((p, i) => [p.id, i]));
+	const inDegree = /* @__PURE__ */ new Map();
+	const dependents = /* @__PURE__ */ new Map();
+	for (const plugin of plugins) {
+		inDegree.set(plugin.id, plugin.dependencies?.length ?? 0);
+		for (const dep of plugin.dependencies ?? []) dependents.set(dep, [...dependents.get(dep) ?? [], plugin.id]);
+	}
+	const ready = plugins.filter((p) => (inDegree.get(p.id) ?? 0) === 0).sort((a, b) => declarationIndex.get(a.id) - declarationIndex.get(b.id)).map((p) => p.id);
+	const orderIds = [];
+	while (ready.length > 0) {
+		const id = ready.shift();
+		orderIds.push(id);
+		for (const dependent of dependents.get(id) ?? []) {
+			const next = (inDegree.get(dependent) ?? 0) - 1;
+			inDegree.set(dependent, next);
+			if (next === 0) ready.push(dependent);
+		}
+	}
+	if (orderIds.length !== plugins.length) {
+		const cyclePath = findCyclePath(plugins.filter((p) => !orderIds.includes(p.id)).map((p) => p.id), byId);
+		throw new Error(`检测到依赖环: ${cyclePath.join(" -> ")}`);
+	}
+	return {
+		order: orderIds.map((id) => byId.get(id)),
+		ids: orderIds
+	};
+}
+function findCyclePath(cyclicIds, byId) {
+	const start = cyclicIds[0];
+	const path = [start];
+	const visited = /* @__PURE__ */ new Set([start]);
+	let current = start;
+	while (true) {
+		const deps = byId.get(current)?.dependencies ?? [];
+		const next = deps.find((d) => cyclicIds.includes(d)) ?? deps[0];
+		if (!next) break;
+		if (next === start || visited.has(next)) {
+			path.push(next);
+			return path;
+		}
+		visited.add(next);
+		path.push(next);
+		current = next;
+	}
+	return path;
+}
+//#endregion
+//#region src/generate-assembly.ts
+function generateAssemblyCode(input) {
+	const { profileId, profileModulePath, resolved } = input;
+	const ids = resolved.ids.map((id) => `'${id}'`).join(", ");
+	return [
+		`// AUTO-GENERATED by @allbluecn/kernel — DO NOT EDIT`,
+		`// profile: ${profileId} (validated: ${resolved.order.length} plugins)`,
+		`// 拓扑序（被依赖者在前）：${resolved.ids.join(" -> ")}`,
+		`import type { ProfileDefinition } from '@allbluecn/kernel'`,
+		``,
+		`export { default as profile } from '${profileModulePath}'`,
+		``,
+		`export const pluginIds: string[] = [${ids}]`,
+		``,
+		`declare const _profile: ProfileDefinition`
+	].join("\n");
+}
+//#endregion
+//#region src/dump-modules.ts
+function dumpModules(profileId, resolved) {
+	const lines = [`profile: ${profileId} (${resolved.order.length} plugins)`];
+	for (const plugin of resolved.order) {
+		const c = plugin.contributes;
+		const parts = [];
+		if (c.routes?.length) parts.push(`routes:${c.routes.length}`);
+		if (c.serverMiddleware?.length) parts.push(`middleware:${c.serverMiddleware.length}`);
+		if (c.queryOptions && Object.keys(c.queryOptions).length) parts.push(`queries:${Object.keys(c.queryOptions).length}`);
+		if (c.uiSlots && Object.keys(c.uiSlots).length) parts.push(`ui-slots:${Object.keys(c.uiSlots).length}`);
+		if (c.features?.length) parts.push(`features:${c.features.length}`);
+		if (c.aiTools?.length) parts.push(`ai-tools:${c.aiTools.length}`);
+		if (c.prisma?.models.length) parts.push(`prisma-models:${c.prisma.models.length}`);
+		lines.push(`${plugin.id}@${plugin.version} — ${parts.length ? parts.join(" ") : "no contributions"}`);
+	}
+	return lines.join("\n");
+}
+//#endregion
+export { definePlugin as a, defineProfile as i, generateAssemblyCode as n, resolvePluginOrder as r, dumpModules as t };

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@allbluecn/kernel",
+  "version": "0.2.0",
+  "license": "AGPL-3.0-or-later",
+  "type": "module",
+  "description": "AllBlue 插件协议：类型定义 + 构建期装配器（零运行时）",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "allblue": "./dist/bin.js"
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsdown",
+    "lint": "tsc --noEmit",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@tanstack/react-start": "1.168.46",
+    "@tanstack/ai": "0.43.0",
+    "react": "^19"
+  },
+  "devDependencies": {
+    "@tanstack/react-start": "1.168.46",
+    "@tanstack/ai": "0.43.0",
+    "@types/node": "^24.13.3",
+    "@types/react": "^19",
+    "react": "^19",
+    "tsdown": "^0.22.0",
+    "typescript": "^7",
+    "vitest": "4.1.5"
+  }
+}