@chatbi-v/core 3.0.0 → 3.1.4

package/dist/manifest/index.cjs

@@ -0,0 +1,253 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/manifest/index.ts
+var manifest_exports = {};
+__export(manifest_exports, {
+  EXTENSION_TYPES: () => EXTENSION_TYPES,
+  PLUGIN_TYPES: () => PLUGIN_TYPES,
+  PluginManifestSchema: () => PluginManifestSchema,
+  RENDER_MODES: () => RENDER_MODES,
+  assertManifest: () => assertManifest,
+  extractManifestFromPlugin: () => extractManifestFromPlugin,
+  normalizePluginManifest: () => normalizePluginManifest,
+  validateManifest: () => validateManifest
+});
+module.exports = __toCommonJS(manifest_exports);
+
+// src/manifest/PluginManifest.ts
+var import_zod = require("zod");
+var EXTENSION_TYPES = ["slot", "hook", "command", "service"];
+var RENDER_MODES = ["replace", "append", "prepend"];
+var ExtensionSchema = import_zod.z.object({
+  /** 扩展点名称/标识符 */
+  name: import_zod.z.string().min(1, "\u6269\u5C55\u70B9\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A"),
+  /** 扩展点类型 */
+  type: import_zod.z.enum(EXTENSION_TYPES),
+  /** 扩展点描述 */
+  description: import_zod.z.string().optional(),
+  /** 对于 slot 类型，指定插槽位置 */
+  slot: import_zod.z.string().optional(),
+  /** 扩展点的配置选项 */
+  config: import_zod.z.record(import_zod.z.any()).optional(),
+  /**
+   * 渲染模式
+   * @description 定义插槽内容的渲染方式：replace(替换)、append(追加)、prepend(前置)
+   */
+  renderMode: import_zod.z.enum(RENDER_MODES).optional(),
+  /**
+   * 条件渲染配置
+   * @description 用于条件渲染，如 requiresAuth: true 表示需要认证
+   */
+  condition: import_zod.z.record(import_zod.z.any()).optional()
+});
+var DependencySchema = import_zod.z.object({
+  /** 依赖插件 ID */
+  id: import_zod.z.string().min(1, "\u4F9D\u8D56\u63D2\u4EF6 ID \u4E0D\u80FD\u4E3A\u7A7A"),
+  /** 依赖版本范围 (SemVer) */
+  version: import_zod.z.string().min(1, "\u4F9D\u8D56\u7248\u672C\u4E0D\u80FD\u4E3A\u7A7A"),
+  /** 是否为可选依赖 */
+  optional: import_zod.z.boolean().optional().default(false)
+});
+var PLUGIN_TYPES = [
+  "business",
+  "functional",
+  "view",
+  "theme",
+  "renderer",
+  "system"
+];
+var EntrySchema = import_zod.z.union([
+  import_zod.z.string().min(1, "\u5165\u53E3\u8DEF\u5F84\u4E0D\u80FD\u4E3A\u7A7A"),
+  import_zod.z.object({
+    /** 入口文件 URL */
+    url: import_zod.z.string().min(1, "\u5165\u53E3 URL \u4E0D\u80FD\u4E3A\u7A7A"),
+    /** 共享作用域 (用于模块联邦) */
+    shareScope: import_zod.z.string().optional()
+  })
+]);
+var CompatibilitySchema = import_zod.z.object({
+  /** 最低宿主版本 */
+  minVersion: import_zod.z.string().optional(),
+  /** 最高宿主版本 */
+  maxVersion: import_zod.z.string().optional(),
+  /** 兼容的宿主版本列表 */
+  supportedVersions: import_zod.z.array(import_zod.z.string()).optional()
+});
+var CapabilitiesSchema = import_zod.z.record(import_zod.z.boolean());
+var ConfigurationSchema = import_zod.z.array(
+  import_zod.z.object({
+    key: import_zod.z.string().min(1),
+    type: import_zod.z.enum(["string", "number", "boolean", "select"]),
+    label: import_zod.z.string().min(1),
+    description: import_zod.z.string().optional(),
+    default: import_zod.z.any().optional(),
+    options: import_zod.z.array(import_zod.z.object({ label: import_zod.z.string(), value: import_zod.z.any() })).optional()
+  })
+);
+var PERMISSION_ACTIONS = [
+  "read",
+  "write",
+  "execute",
+  "admin"
+];
+var PERMISSION_SCOPES = ["plugin", "global", "user"];
+var PluginManifestSchema = import_zod.z.object({
+  /** 插件唯一 ID (推荐反向域名格式) */
+  id: import_zod.z.string().min(1, "\u63D2\u4EF6 ID \u4E0D\u80FD\u4E3A\u7A7A"),
+  /** 插件版本号 (SemVer) */
+  version: import_zod.z.string().min(1, "\u7248\u672C\u53F7\u4E0D\u80FD\u4E3A\u7A7A").refine((v) => /^\d+\.\d+\.\d+(-[a-zA-Z0-9.-]+)?$/.test(v), {
+    message: "\u7248\u672C\u53F7\u5FC5\u987B\u7B26\u5408 SemVer \u683C\u5F0F"
+  }),
+  /** 插件显示名称 */
+  name: import_zod.z.string().min(1, "\u63D2\u4EF6\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A"),
+  /** 插件入口 */
+  entry: EntrySchema,
+  /** 插件类型 */
+  type: import_zod.z.enum(PLUGIN_TYPES).optional().default("business"),
+  /** 插件功能描述 */
+  description: import_zod.z.string().optional(),
+  /** 插件作者 */
+  author: import_zod.z.string().optional(),
+  /** 插件图标 */
+  icon: import_zod.z.string().optional(),
+  /** 兼容性要求 */
+  compatibility: CompatibilitySchema.optional(),
+  /** 插件依赖 */
+  dependencies: import_zod.z.array(DependencySchema).optional().default([]),
+  /** 扩展点声明 */
+  extensions: import_zod.z.array(ExtensionSchema).optional().default([]),
+  /** 能力声明 */
+  capabilities: CapabilitiesSchema.optional(),
+  /** 配置项定义 */
+  configuration: ConfigurationSchema.optional(),
+  /** 存储定义 */
+  storage: import_zod.z.array(import_zod.z.any()).optional(),
+  /** 路由定义 (仅供展示，实际路由在运行时注册) */
+  routes: import_zod.z.array(import_zod.z.object({ path: import_zod.z.string() })).optional(),
+  /** 权限声明 */
+  permissions: import_zod.z.array(
+    import_zod.z.object({
+      action: import_zod.z.enum(PERMISSION_ACTIONS),
+      scope: import_zod.z.enum(PERMISSION_SCOPES),
+      resource: import_zod.z.string()
+    })
+  ).optional(),
+  /** 插件优先级 */
+  priority: import_zod.z.number().optional().default(100)
+});
+
+// src/manifest/ManifestValidator.ts
+function formatZodErrors(error) {
+  return error.errors.map((err) => ({
+    message: err.message,
+    path: err.path.map(String),
+    type: err.code
+  }));
+}
+function validateManifest(raw) {
+  const result = PluginManifestSchema.safeParse(raw);
+  if (result.success) {
+    return {
+      valid: true,
+      data: result.data
+    };
+  }
+  return {
+    valid: false,
+    errors: formatZodErrors(result.error)
+  };
+}
+function assertManifest(raw) {
+  return PluginManifestSchema.parse(raw);
+}
+
+// src/manifest/ManifestWrapper.ts
+function extractManifestFromPlugin(plugin) {
+  const input = plugin;
+  const metadata = input.metadata;
+  const manifest = {
+    id: input.id || metadata?.id,
+    version: metadata?.version || "1.0.0",
+    name: metadata?.name || input.name,
+    type: metadata?.type || input.type,
+    description: metadata?.description || input.description,
+    author: metadata?.author || input.author,
+    icon: metadata?.icon || input.icon,
+    entry: input.entry || "index.js"
+  };
+  const deps = metadata?.dependencies || input.dependencies;
+  if (Array.isArray(deps)) {
+    manifest.dependencies = deps.map((dep) => {
+      if (typeof dep === "string") {
+        return { id: dep, version: "*", optional: false };
+      }
+      return dep;
+    });
+  }
+  const extensions = metadata?.extensions || input.extensions;
+  if (Array.isArray(extensions)) {
+    manifest.extensions = extensions.map(
+      (ext) => ({
+        name: ext.slot || ext.name,
+        type: "slot",
+        description: ext.meta?.description,
+        slot: ext.slot
+      })
+    );
+  }
+  const caps = metadata?.capabilities || input.capabilities;
+  if (caps && typeof caps === "object") {
+    manifest.capabilities = caps;
+  }
+  const config = metadata?.configuration || input.configuration;
+  if (Array.isArray(config)) {
+    manifest.configuration = config;
+  }
+  return manifest;
+}
+function normalizePluginManifest(input) {
+  let manifest;
+  if (!input || typeof input !== "object") {
+    return {
+      valid: false,
+      errors: [{ message: "\u8F93\u5165\u5FC5\u987B\u662F\u5BF9\u8C61", path: [], type: "invalid_type" }]
+    };
+  }
+  const record = input;
+  if (record.id && record.version && record.name && record.entry) {
+    manifest = record;
+  } else if (record.metadata) {
+    manifest = extractManifestFromPlugin(record);
+  } else {
+    manifest = extractManifestFromPlugin(record);
+  }
+  return validateManifest(manifest);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EXTENSION_TYPES,
+  PLUGIN_TYPES,
+  PluginManifestSchema,
+  RENDER_MODES,
+  assertManifest,
+  extractManifestFromPlugin,
+  normalizePluginManifest,
+  validateManifest
+});

package/dist/manifest/index.d.cts

@@ -0,0 +1,56 @@
+import { c as PluginManifest, P as Plugin } from '../plugin-port-CHRPxDOi.cjs';
+export { Q as Command, U as CommandHandler, V as CommandType, W as Compatibility, D as Dependency, a4 as EXTENSION_TYPES, X as Entry, Y as Extension, Z as ExtensionType, _ as HookType, $ as OnActivateHandler, a0 as OnDeactivateHandler, a1 as OnErrorHandler, B as PLUGIN_TYPES, a3 as PluginManifestSchema, C as PluginType, a5 as RENDER_MODES, a2 as RenderMode } from '../plugin-port-CHRPxDOi.cjs';
+import 'zod';
+
+/**
+ * 验证结果类型
+ */
+interface ValidationResult {
+    /** 是否有效 */
+    valid: boolean;
+    /** 验证通过时的数据 */
+    data?: PluginManifest;
+    /** 验证失败时的错误 */
+    errors?: {
+        /** 错误消息 */
+        message: string;
+        /** 错误路径 */
+        path: string[];
+        /** 具体错误类型 */
+        type: string;
+    }[];
+}
+/**
+ * 验证 Manifest
+ * @param raw - 待验证的原始数据
+ * @returns 验证结果
+ */
+declare function validateManifest(raw: unknown): ValidationResult;
+/**
+ * 验证 Manifest 并抛出错误
+ * @param raw - 待验证的原始数据
+ * @returns 验证通过的 Manifest 数据
+ * @throws ZodError 当验证失败时
+ */
+declare function assertManifest(raw: unknown): PluginManifest;
+
+/**
+ * Manifest 向后兼容包装器
+ * @description 支持旧版 definePlugin 格式自动转换为 Manifest 格式
+ */
+
+/**
+ * 从 Plugin 对象提取 Manifest
+ * @param plugin - 插件对象
+ * @returns 提取的 Manifest 对象
+ */
+declare function extractManifestFromPlugin(plugin: Plugin | Record<string, unknown>): Partial<PluginManifest>;
+/**
+ * 规范化插件 Manifest
+ * @param input - Plugin 对象、definePlugin 结果或纯对象
+ * @returns 规范化后的 Manifest
+ * @throws 当输入无效且无法转换时
+ */
+declare function normalizePluginManifest(input: Plugin | Record<string, unknown> | unknown): ValidationResult;
+
+export { PluginManifest, type ValidationResult, assertManifest, extractManifestFromPlugin, normalizePluginManifest, validateManifest };

package/dist/manifest/index.d.ts

@@ -0,0 +1,56 @@
+import { c as PluginManifest, P as Plugin } from '../plugin-port-CHRPxDOi.js';
+export { Q as Command, U as CommandHandler, V as CommandType, W as Compatibility, D as Dependency, a4 as EXTENSION_TYPES, X as Entry, Y as Extension, Z as ExtensionType, _ as HookType, $ as OnActivateHandler, a0 as OnDeactivateHandler, a1 as OnErrorHandler, B as PLUGIN_TYPES, a3 as PluginManifestSchema, C as PluginType, a5 as RENDER_MODES, a2 as RenderMode } from '../plugin-port-CHRPxDOi.js';
+import 'zod';
+
+/**
+ * 验证结果类型
+ */
+interface ValidationResult {
+    /** 是否有效 */
+    valid: boolean;
+    /** 验证通过时的数据 */
+    data?: PluginManifest;
+    /** 验证失败时的错误 */
+    errors?: {
+        /** 错误消息 */
+        message: string;
+        /** 错误路径 */
+        path: string[];
+        /** 具体错误类型 */
+        type: string;
+    }[];
+}
+/**
+ * 验证 Manifest
+ * @param raw - 待验证的原始数据
+ * @returns 验证结果
+ */
+declare function validateManifest(raw: unknown): ValidationResult;
+/**
+ * 验证 Manifest 并抛出错误
+ * @param raw - 待验证的原始数据
+ * @returns 验证通过的 Manifest 数据
+ * @throws ZodError 当验证失败时
+ */
+declare function assertManifest(raw: unknown): PluginManifest;
+
+/**
+ * Manifest 向后兼容包装器
+ * @description 支持旧版 definePlugin 格式自动转换为 Manifest 格式
+ */
+
+/**
+ * 从 Plugin 对象提取 Manifest
+ * @param plugin - 插件对象
+ * @returns 提取的 Manifest 对象
+ */
+declare function extractManifestFromPlugin(plugin: Plugin | Record<string, unknown>): Partial<PluginManifest>;
+/**
+ * 规范化插件 Manifest
+ * @param input - Plugin 对象、definePlugin 结果或纯对象
+ * @returns 规范化后的 Manifest
+ * @throws 当输入无效且无法转换时
+ */
+declare function normalizePluginManifest(input: Plugin | Record<string, unknown> | unknown): ValidationResult;
+
+export { PluginManifest, type ValidationResult, assertManifest, extractManifestFromPlugin, normalizePluginManifest, validateManifest };

package/dist/manifest/index.mjs

@@ -0,0 +1,20 @@
+import {
+  EXTENSION_TYPES,
+  PLUGIN_TYPES,
+  PluginManifestSchema,
+  RENDER_MODES,
+  assertManifest,
+  extractManifestFromPlugin,
+  normalizePluginManifest,
+  validateManifest
+} from "../chunk-AAKBSVX6.mjs";
+export {
+  EXTENSION_TYPES,
+  PLUGIN_TYPES,
+  PluginManifestSchema,
+  RENDER_MODES,
+  assertManifest,
+  extractManifestFromPlugin,
+  normalizePluginManifest,
+  validateManifest
+};