@yumerijs/core 1.1.0-alpha.1 → 1.1.0-alpha.2

package/dist/src/config.d.ts

@@ -0,0 +1,133 @@
+/**
+ * @time: 2025/03/24 12:26
+ * @author: FireGuo
+ * WindyPear-Team All right reserved
+ **/
+/**
+ * 插件配置模式定义类
+ * 用于描述插件配置项的类型、默认值、描述等信息
+ */
+export declare class ConfigSchema {
+    /**
+     * 配置项类型
+     */
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    /**
+     * 默认值
+     */
+    default?: any;
+    /**
+     * 配置项描述
+     */
+    description?: string;
+    /**
+     * 是否必需
+     */
+    required?: boolean;
+    /**
+     * 枚举值列表（可选项）
+     */
+    enum?: any[];
+    /**
+     * 数组项类型定义（当type为array时使用）
+     */
+    items?: ConfigSchema;
+    /**
+     * 对象属性定义（当type为object时使用）
+     */
+    properties?: Record<string, ConfigSchema>;
+    /**
+     * 创建配置模式对象
+     * @param type 配置项类型
+     * @param options 配置项选项
+     */
+    constructor(type: 'string' | 'number' | 'boolean' | 'object' | 'array', options?: {
+        default?: any;
+        description?: string;
+        required?: boolean;
+        enum?: any[];
+        items?: ConfigSchema;
+        properties?: Record<string, ConfigSchema>;
+    });
+    /**
+     * 创建字符串类型配置模式
+     * @param options 配置项选项
+     * @returns 配置模式对象
+     */
+    static string(options?: Omit<ConfigSchema, 'type' | 'items' | 'properties'>): ConfigSchema;
+    /**
+     * 创建数字类型配置模式
+     * @param options 配置项选项
+     * @returns 配置模式对象
+     */
+    static number(options?: Omit<ConfigSchema, 'type' | 'items' | 'properties'>): ConfigSchema;
+    /**
+     * 创建布尔类型配置模式
+     * @param options 配置项选项
+     * @returns 配置模式对象
+     */
+    static boolean(options?: Omit<ConfigSchema, 'type' | 'items' | 'properties'>): ConfigSchema;
+    /**
+     * 创建对象类型配置模式
+     * @param properties 对象属性定义
+     * @param options 配置项选项
+     * @returns 配置模式对象
+     */
+    static object(properties: Record<string, ConfigSchema>, options?: Omit<ConfigSchema, 'type' | 'items' | 'properties'>): ConfigSchema;
+    /**
+     * 创建数组类型配置模式
+     * @param items 数组项类型定义
+     * @param options 配置项选项
+     * @returns 配置模式对象
+     */
+    static array(items: ConfigSchema, options?: Omit<ConfigSchema, 'type' | 'items' | 'properties'>): ConfigSchema;
+    /**
+     * 验证值是否符合配置模式
+     * @param value 要验证的值
+     * @returns 验证结果，如果通过返回true，否则返回错误信息
+     */
+    validate(value: any): true | string;
+}
+export declare class Config {
+    /**
+     * 配置名称
+     */
+    name: string;
+    /**
+     * 配置内容
+     */
+    content: {
+        [name: string]: any;
+    };
+    /**
+     * 配置模式
+     */
+    schema?: Record<string, ConfigSchema>;
+    /**
+     * 创建配置对象
+     * @param name 配置名称
+     * @param content 配置内容
+     * @param schema 配置模式
+     */
+    constructor(name: string, content?: {
+        [name: string]: any;
+    }, schema?: Record<string, ConfigSchema>);
+    /**
+     * 获取配置项值
+     * @param key 配置项键名
+     * @param defaultValue 默认值
+     * @returns 配置项值
+     */
+    get<T>(key: string, defaultValue?: T): T;
+    /**
+     * 设置配置项值
+     * @param key 配置项键名
+     * @param value 配置项值
+     */
+    set(key: string, value: any): void;
+    /**
+     * 验证配置是否符合schema
+     * @returns 验证结果，如果通过返回true，否则返回错误信息
+     */
+    validate(): true | string;
+}

package/dist/src/config.js

@@ -0,0 +1,205 @@
+"use strict";
+/**
+ * @time: 2025/03/24 12:26
+ * @author: FireGuo
+ * WindyPear-Team All right reserved
+ **/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Config = exports.ConfigSchema = void 0;
+/**
+ * 插件配置模式定义类
+ * 用于描述插件配置项的类型、默认值、描述等信息
+ */
+class ConfigSchema {
+    /**
+     * 创建配置模式对象
+     * @param type 配置项类型
+     * @param options 配置项选项
+     */
+    constructor(type, options) {
+        this.type = type;
+        if (options) {
+            this.default = options.default;
+            this.description = options.description;
+            this.required = options.required;
+            this.enum = options.enum;
+            this.items = options.items;
+            this.properties = options.properties;
+        }
+    }
+    /**
+     * 创建字符串类型配置模式
+     * @param options 配置项选项
+     * @returns 配置模式对象
+     */
+    static string(options) {
+        return new ConfigSchema('string', options);
+    }
+    /**
+     * 创建数字类型配置模式
+     * @param options 配置项选项
+     * @returns 配置模式对象
+     */
+    static number(options) {
+        return new ConfigSchema('number', options);
+    }
+    /**
+     * 创建布尔类型配置模式
+     * @param options 配置项选项
+     * @returns 配置模式对象
+     */
+    static boolean(options) {
+        return new ConfigSchema('boolean', options);
+    }
+    /**
+     * 创建对象类型配置模式
+     * @param properties 对象属性定义
+     * @param options 配置项选项
+     * @returns 配置模式对象
+     */
+    static object(properties, options) {
+        return new ConfigSchema('object', { ...options, properties });
+    }
+    /**
+     * 创建数组类型配置模式
+     * @param items 数组项类型定义
+     * @param options 配置项选项
+     * @returns 配置模式对象
+     */
+    static array(items, options) {
+        return new ConfigSchema('array', { ...options, items });
+    }
+    /**
+     * 验证值是否符合配置模式
+     * @param value 要验证的值
+     * @returns 验证结果，如果通过返回true，否则返回错误信息
+     */
+    validate(value) {
+        // 检查必需项
+        if (this.required && value === undefined) {
+            return `Missing required value`;
+        }
+        // 如果值存在，检查类型
+        if (value !== undefined) {
+            // 类型检查
+            switch (this.type) {
+                case 'string':
+                    if (typeof value !== 'string') {
+                        return `Value should be string`;
+                    }
+                    break;
+                case 'number':
+                    if (typeof value !== 'number') {
+                        return `Value should be number`;
+                    }
+                    break;
+                case 'boolean':
+                    if (typeof value !== 'boolean') {
+                        return `Value should be boolean`;
+                    }
+                    break;
+                case 'object':
+                    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+                        return `Value should be object`;
+                    }
+                    // 如果有属性定义，检查每个属性
+                    if (this.properties) {
+                        for (const key in this.properties) {
+                            const propSchema = this.properties[key];
+                            const propValue = value[key];
+                            const propResult = propSchema.validate(propValue);
+                            if (propResult !== true) {
+                                return `Property ${key}: ${propResult}`;
+                            }
+                        }
+                    }
+                    break;
+                case 'array':
+                    if (!Array.isArray(value)) {
+                        return `Value should be array`;
+                    }
+                    // 如果有数组项定义，检查每个项
+                    if (this.items) {
+                        for (let i = 0; i < value.length; i++) {
+                            const itemResult = this.items.validate(value[i]);
+                            if (itemResult !== true) {
+                                return `Item at index ${i}: ${itemResult}`;
+                            }
+                        }
+                    }
+                    break;
+            }
+            // 枚举值检查
+            if (this.enum && !this.enum.includes(value)) {
+                return `Value should be one of: ${this.enum.join(', ')}`;
+            }
+        }
+        return true;
+    }
+}
+exports.ConfigSchema = ConfigSchema;
+class Config {
+    /**
+     * 创建配置对象
+     * @param name 配置名称
+     * @param content 配置内容
+     * @param schema 配置模式
+     */
+    constructor(name, content, schema) {
+        /**
+         * 配置名称
+         */
+        this.name = '';
+        /**
+         * 配置内容
+         */
+        this.content = {};
+        this.name = name;
+        this.content = content || {}; // 如果 content 是 undefined，则赋值为空对象
+        this.schema = schema;
+    }
+    /**
+     * 获取配置项值
+     * @param key 配置项键名
+     * @param defaultValue 默认值
+     * @returns 配置项值
+     */
+    get(key, defaultValue) {
+        if (this.content[key] !== undefined) {
+            return this.content[key];
+        }
+        // 如果有schema，尝试从schema中获取默认值
+        if (this.schema && this.schema[key] && this.schema[key].default !== undefined) {
+            return this.schema[key].default;
+        }
+        return defaultValue;
+    }
+    /**
+     * 设置配置项值
+     * @param key 配置项键名
+     * @param value 配置项值
+     */
+    set(key, value) {
+        this.content[key] = value;
+    }
+    /**
+     * 验证配置是否符合schema
+     * @returns 验证结果，如果通过返回true，否则返回错误信息
+     */
+    validate() {
+        if (!this.schema) {
+            return true; // 没有schema，视为验证通过
+        }
+        for (const key in this.schema) {
+            const schemaItem = this.schema[key];
+            const value = this.content[key];
+            const result = schemaItem.validate(value);
+            if (result !== true) {
+                return `Config ${key}: ${result}`;
+            }
+        }
+        return true;
+    }
+}
+exports.Config = Config;
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"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"}

package/dist/src/core.d.ts

@@ -0,0 +1,66 @@
+import { Config } from './config';
+import { Logger } from './logger';
+import { Command } from './command';
+import { Session } from './session';
+import { Platform } from './platform';
+interface Plugin {
+    apply: (core: Core, config: Config) => Promise<void>;
+    disable: (core: Core) => Promise<void>;
+    depend: Array<string>;
+    provide: Array<string>;
+}
+interface PluginLoader {
+    load(pluginName: string): Promise<Plugin>;
+    unloadPlugin(pluginName: string): Promise<void>;
+    checkPluginDependencies(pluginPath: string): Promise<boolean>;
+    installPluginDependencies(pluginName: string): Promise<void>;
+    logger: Logger;
+}
+export declare class Core {
+    plugins: {
+        [name: string]: Plugin & {
+            depend?: string[];
+            provide?: string[];
+        };
+    };
+    config: any;
+    platforms: Platform[];
+    private eventListeners;
+    private components;
+    commands: Record<string, Command>;
+    private pluginLoader;
+    private logger;
+    private providedComponents;
+    private pluginModules;
+    constructor(pluginLoader: PluginLoader);
+    loadConfig(configPath: string): Promise<void>;
+    getPluginConfig(pluginName: string): Promise<Config>;
+    loadPlugins(): Promise<void>;
+    /**
+     * 监听插件目录，实现热重载
+     * @param core Core实例
+     * @param pluginsDir 插件目录
+     */
+    watchPlugins(core: Core, pluginsDir?: string): void;
+    /**
+     * 重新加载插件
+     * @param pluginName 插件名称
+     * @param core Core实例
+     */
+    reloadPlugin(pluginName: string, core: Core): Promise<void>;
+    /**
+     * 卸载插件并触发事件
+     * @param pluginName 插件名称
+     * @param core Core实例
+     */
+    unloadPluginAndEmit(pluginName: string, core: Core): Promise<void>;
+    registerComponent(name: string, component: any): void;
+    getComponent(name: string): any;
+    unregisterComponent(name: string): void;
+    on(event: string, listener: (...args: any[]) => Promise<void>): void;
+    emit(event: string, ...args: any[]): Promise<void>;
+    command(name: string): Command;
+    executeCommand(name: string, session: any, ...args: any[]): Promise<Session | null>;
+    registerPlatform(platform: Platform): any;
+}
+export {};