@zhin.js/core 1.0.24 → 1.0.26

package/lib/built/command.js

@@ -1,54 +1,81 @@
+/**
+ * CommandFeature
+ * 管理所有插件注册的命令，继承自 Feature 抽象类
+ */
+import { Feature } from "../feature.js";
 import { getPlugin } from "../plugin.js";
 /**
- * 创建命令 Context
+ * 命令服务 Feature
  */
-export function createCommandService() {
-    const items = [];
-    const byName = new Map();
-    const pluginMap = new Map();
-    const value = {
-        items,
-        byName,
-        add(command, pluginName) {
-            items.push(command);
-            byName.set(command.pattern, command);
-            pluginMap.set(command, pluginName);
-            return () => value.remove(command);
-        },
-        remove(command) {
-            const index = items.indexOf(command);
-            if (index !== -1) {
-                items.splice(index, 1);
-                byName.delete(command.pattern);
-                pluginMap.delete(command);
-                return true;
-            }
-            return false;
-        },
-        get(pattern) {
-            return byName.get(pattern);
-        },
-        async handle(message, plugin) {
-            for (const command of items) {
-                const result = await command.handle(message, plugin);
-                if (result)
-                    return result;
-            }
-            return null;
+export class CommandFeature extends Feature {
+    name = 'command';
+    icon = 'Terminal';
+    desc = '命令';
+    /** 按 pattern 索引 */
+    byName = new Map();
+    /**
+     * 添加命令
+     */
+    add(command, pluginName) {
+        this.byName.set(command.pattern, command);
+        return super.add(command, pluginName);
+    }
+    /**
+     * 移除命令
+     */
+    remove(command) {
+        this.byName.delete(command.pattern);
+        return super.remove(command);
+    }
+    /**
+     * 按 pattern 获取命令
+     */
+    get(pattern) {
+        return this.byName.get(pattern);
+    }
+    /**
+     * 处理消息，依次尝试匹配命令
+     */
+    async handle(message, plugin) {
+        for (const command of this.items) {
+            const result = await command.handle(message, plugin);
+            if (result)
+                return result;
         }
-    };
-    return {
-        name: 'command',
-        description: '命令服务',
-        value,
-        extensions: {
+        return null;
+    }
+    /**
+     * 序列化为 JSON
+     */
+    toJSON(pluginName) {
+        const list = pluginName ? this.getByPlugin(pluginName) : this.items;
+        return {
+            name: this.name,
+            icon: this.icon,
+            desc: this.desc,
+            count: list.length,
+            items: list.map(c => ({
+                name: c.pattern,
+                desc: c.helpInfo?.desc,
+                usage: c.helpInfo?.usage,
+                examples: c.helpInfo?.examples,
+            })),
+        };
+    }
+    /**
+     * 提供给 Plugin.prototype 的扩展方法
+     */
+    get extensions() {
+        const feature = this;
+        return {
             addCommand(command) {
                 const plugin = getPlugin();
-                const dispose = value.add(command, plugin.name);
+                const dispose = feature.add(command, plugin.name);
+                plugin.recordFeatureContribution(feature.name, command.pattern);
                 plugin.onDispose(dispose);
                 return dispose;
-            }
-        }
-    };
+            },
+        };
+    }
 }
 //# sourceMappingURL=command.js.map

package/lib/built/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/built/command.ts"],"names":[],"mappings":"AAMA,OAAO,EAAmB,SAAS,EAAE,MAAM,cAAc,CAAC;AAuC1D;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,KAAK,GAAwC,EAAE,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,GAAG,EAA6C,CAAC;IACpE,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6C,CAAC;IAEvE,MAAM,KAAK,GAAmB;QAC5B,KAAK;QACL,MAAM;QAEN,GAAG,CAAC,OAAO,EAAE,UAAU;YACrB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACrC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YACnC,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,CAAC,OAAO;YACZ,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACrC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBACvB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBAC/B,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC1B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,GAAG,CAAC,OAAO;YACT,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM;YAC1B,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBACrD,IAAI,MAAM;oBAAE,OAAO,MAAM,CAAC;YAC5B,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,MAAM;QACnB,KAAK;QACL,UAAU,EAAE;YACV,UAAU,CAA8B,OAA0B;gBAChE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;gBAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,OAA4C,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBACrF,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBAC1B,OAAO,OAAO,CAAC;YACjB,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/built/command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAe,MAAM,eAAe,CAAC;AAGrD,OAAO,EAAU,SAAS,EAAE,MAAM,cAAc,CAAC;AAqBjD;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,OAA0C;IACnE,IAAI,GAAG,SAAkB,CAAC;IAC1B,IAAI,GAAG,UAAU,CAAC;IAClB,IAAI,GAAG,IAAI,CAAC;IAErB,mBAAmB;IACV,MAAM,GAAG,IAAI,GAAG,EAA6C,CAAC;IAEvE;;OAEG;IACH,GAAG,CAAC,OAA0C,EAAE,UAAkB;QAChE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1C,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAA0C;QAC/C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,OAAe;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAAmD,EAAE,MAAc;QAC9E,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACrD,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAmB;QACxB,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QACpE,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACpB,IAAI,EAAE,CAAC,CAAC,OAAO;gBACf,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI;gBACtB,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK;gBACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ;aAC/B,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC;QACrB,OAAO;YACL,UAAU,CAA8B,OAA0B;gBAChE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;gBAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAA4C,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBACvF,MAAM,CAAC,yBAAyB,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;gBAChE,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBAC1B,OAAO,OAAO,CAAC;YACjB,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/lib/built/component.d.ts

@@ -1,9 +1,10 @@
 /**
- * Component Context
- * 管理所有插件注册的组件
+ * ComponentFeature
+ * 管理所有插件注册的组件，继承自 Feature 抽象类
  */
+import { Feature, FeatureJSON } from "../feature.js";
 import { Component } from "../component.js";
-import { Context } from "../plugin.js";
+import { Plugin } from "../plugin.js";
 /**
  * ComponentContext 扩展方法类型
  */
@@ -16,27 +17,53 @@ declare module "../plugin.js" {
         interface Extensions extends ComponentContextExtensions {
         }
         interface Contexts {
-            component: ComponentService;
+            component: ComponentFeature;
         }
     }
 }
 /**
- * 组件服务数据
+ * 组件服务 Feature
  */
-export interface ComponentService {
+export declare class ComponentFeature extends Feature<Component<any>> {
+    #private;
+    readonly name: "component";
+    readonly icon = "Box";
+    readonly desc = "\u7EC4\u4EF6";
     /** 按名称索引 */
     readonly byName: Map<string, Component<any>>;
-    /** 添加组件 */
+    /**
+     * 添加组件
+     */
     add(component: Component<any>, pluginName: string): () => void;
-    /** 获取所有组件名称 */
-    getAllNames(): string[];
-    /** 移除组件 */
+    /**
+     * 移除组件
+     */
     remove(component: Component<any>): boolean;
-    /** 按名称获取 */
+    /**
+     * 获取所有组件名称
+     */
+    getAllNames(): string[];
+    /**
+     * 按名称获取组件
+     */
     get(name: string): Component<any> | undefined;
+    /**
+     * 生命周期: 挂载时注册消息渲染监听器
+     */
+    mounted(plugin: Plugin): void;
+    /**
+     * 生命周期: 销毁时移除监听器
+     */
+    dispose(): void;
+    /**
+     * 序列化为 JSON
+     */
+    toJSON(pluginName?: string): FeatureJSON;
+    /**
+     * 提供给 Plugin.prototype 的扩展方法
+     */
+    get extensions(): {
+        addComponent<T extends Component<any>>(component: T): () => void;
+    };
 }
-/**
- * 创建组件 Context
- */
-export declare function createComponentService(): Context<'component', ComponentContextExtensions>;
 //# sourceMappingURL=component.d.ts.map

package/lib/built/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/built/component.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAoB,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EAAE,OAAO,EAAqB,MAAM,cAAc,CAAC;AAI1D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,WAAW;IACX,YAAY,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,MAAM,IAAI,CAAC;CAClE;AAGD,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,MAAM,CAAC;QACf,UAAU,UAAW,SAAQ,0BAA0B;SAAG;QAC1D,UAAU,QAAQ;YAChB,SAAS,EAAE,gBAAgB,CAAC;SAC7B;KACF;CACF;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY;IACZ,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,WAAW;IACX,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC/D,eAAe;IACf,WAAW,IAAI,MAAM,EAAE,CAAC;IACxB,WAAW;IACX,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;IAC3C,YAAY;IACZ,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;CAC/C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAAC,WAAW,EAAE,0BAA0B,CAAC,CA6DzF"}
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/built/component.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,SAAS,EAAoB,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EAAE,MAAM,EAAa,MAAM,cAAc,CAAC;AAIjD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,WAAW;IACX,YAAY,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,MAAM,IAAI,CAAC;CAClE;AAGD,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,MAAM,CAAC;QACf,UAAU,UAAW,SAAQ,0BAA0B;SAAG;QAC1D,UAAU,QAAQ;YAChB,SAAS,EAAE,gBAAgB,CAAC;SAC7B;KACF;CACF;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;;IAC3D,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IACrC,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,IAAI,kBAAQ;IAErB,YAAY;IACZ,QAAQ,CAAC,MAAM,8BAAqC;IAMpD;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,IAAI;IAK9D;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,OAAO;IAK1C;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS;IAI7C;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ7B;;OAEG;IACH,OAAO,IAAI,IAAI;IAOf;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW;IAcxC;;OAEG;IACH,IAAI,UAAU;qBAGG,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,SAvEG,IAAI;MA+E7D;CACF"}

package/lib/built/component.js

@@ -1,65 +1,97 @@
 /**
- * Component Context
- * 管理所有插件注册的组件
+ * ComponentFeature
+ * 管理所有插件注册的组件，继承自 Feature 抽象类
  */
+import { Feature } from "../feature.js";
 import { renderComponents } from "../component.js";
 import { getPlugin } from "../plugin.js";
 /**
- * 创建组件 Context
+ * 组件服务 Feature
  */
-export function createComponentService() {
-    const byName = new Map();
-    const pluginMap = new Map();
-    let listener;
-    let rootPlugin;
-    const value = {
-        byName,
-        add(component, pluginName) {
-            byName.set(component.name, component);
-            pluginMap.set(component, pluginName);
-            return () => value.remove(component);
-        },
-        getAllNames() {
-            return Array.from(byName.keys());
-        },
-        remove(component) {
-            if (byName.has(component.name)) {
-                byName.delete(component.name);
-                pluginMap.delete(component);
-                return true;
-            }
-            return false;
-        },
-        get(name) {
-            return byName.get(name);
+export class ComponentFeature extends Feature {
+    name = 'component';
+    icon = 'Box';
+    desc = '组件';
+    /** 按名称索引 */
+    byName = new Map();
+    /** 内部状态：消息渲染监听器 & 宿主插件 */
+    #listener;
+    #rootPlugin;
+    /**
+     * 添加组件
+     */
+    add(component, pluginName) {
+        this.byName.set(component.name, component);
+        return super.add(component, pluginName);
+    }
+    /**
+     * 移除组件
+     */
+    remove(component) {
+        this.byName.delete(component.name);
+        return super.remove(component);
+    }
+    /**
+     * 获取所有组件名称
+     */
+    getAllNames() {
+        return Array.from(this.byName.keys());
+    }
+    /**
+     * 按名称获取组件
+     */
+    get(name) {
+        return this.byName.get(name);
+    }
+    /**
+     * 生命周期: 挂载时注册消息渲染监听器
+     */
+    mounted(plugin) {
+        this.#rootPlugin = plugin;
+        this.#listener = (options) => {
+            return renderComponents(this.byName, options);
+        };
+        plugin.root.on('before.sendMessage', this.#listener);
+    }
+    /**
+     * 生命周期: 销毁时移除监听器
+     */
+    dispose() {
+        if (this.#listener && this.#rootPlugin) {
+            this.#rootPlugin.root.off('before.sendMessage', this.#listener);
+            this.#listener = undefined;
         }
-    };
-    return {
-        name: 'component',
-        description: '组件服务',
-        mounted(plugin) {
-            rootPlugin = plugin;
-            // 创建消息渲染监听器
-            listener = (options) => {
-                return renderComponents(byName, options);
-            };
-            plugin.root.on('before.sendMessage', listener);
-            return value;
-        },
-        dispose() {
-            if (listener && rootPlugin) {
-                rootPlugin.root.off('before.sendMessage', listener);
-                listener = undefined;
-            }
-        },
-        extensions: {
+    }
+    /**
+     * 序列化为 JSON
+     */
+    toJSON(pluginName) {
+        const list = pluginName ? this.getByPlugin(pluginName) : this.items;
+        return {
+            name: this.name,
+            icon: this.icon,
+            desc: this.desc,
+            count: list.length,
+            items: list.map(c => ({
+                name: c.name,
+                type: 'component',
+            })),
+        };
+    }
+    /**
+     * 提供给 Plugin.prototype 的扩展方法
+     */
+    get extensions() {
+        const feature = this;
+        return {
             addComponent(component) {
                 const plugin = getPlugin();
-                const dispose = value.add(component, plugin.name);
+                const dispose = feature.add(component, plugin.name);
+                plugin.recordFeatureContribution(feature.name, component.name);
                 plugin.onDispose(dispose);
                 return dispose;
-            }
-        }
-    };
+            },
+        };
+    }
 }
 //# sourceMappingURL=component.js.map

package/lib/built/component.js.map

@@ -1 +1 @@
-{"version":3,"file":"component.js","sourceRoot":"","sources":["../../src/built/component.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAa,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EAAmB,SAAS,EAAE,MAAM,cAAc,CAAC;AAsC1D;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IACpD,IAAI,QAA8B,CAAC;IACnC,IAAI,UAA8B,CAAC;IAEnC,MAAM,KAAK,GAAqB;QAC9B,MAAM;QAEN,GAAG,CAAC,SAAS,EAAE,UAAU;YACvB,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YACtC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YACrC,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;QACD,WAAW;YACT,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,CAAC,SAAS;YACd,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC9B,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC5B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,GAAG,CAAC,IAAI;YACN,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,MAAM;QAEnB,OAAO,CAAC,MAAc;YACpB,UAAU,GAAG,MAAM,CAAC;YACpB,YAAY;YACZ,QAAQ,GAAG,CAAC,OAAoB,EAAE,EAAE;gBAClC,OAAO,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC3C,CAAC,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;YAC/C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO;YACL,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;gBAC3B,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;gBACpD,QAAQ,GAAG,SAAS,CAAC;YACvB,CAAC;QACH,CAAC;QAED,UAAU,EAAE;YACV,YAAY,CAA2B,SAAY;gBACjD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;gBAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBAClD,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBAC1B,OAAO,OAAO,CAAC;YACjB,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../../src/built/component.ts"],"names":[],"mappings":"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"}

package/lib/built/config.d.ts

@@ -1,4 +1,5 @@
 import { Schema } from "@zhin.js/schema";
+import { Feature, FeatureJSON } from "../feature.js";
 export declare class ConfigLoader<T extends object> {
     #private;
     filename: string;
@@ -15,17 +16,65 @@ export declare namespace ConfigLoader {
     const supportedExtensions: string[];
     function load<T extends object>(filename: string, initial?: T, schema?: Schema<T>): ConfigLoader<T>;
 }
-export declare class ConfigService {
-    configs: Map<string, ConfigLoader<any>>;
-    constructor();
+/**
+ * 配置项声明记录
+ */
+export interface ConfigRecord {
+    key: string;
+    defaultValue: any;
+}
+/**
+ * ConfigFeature 扩展方法类型
+ */
+export interface ConfigContextExtensions {
+    /** 声明插件配置项（key + 默认值），如果配置文件中不存在则写入默认值 */
+    addConfig(key: string, defaultValue: any): () => void;
+}
+declare module "../plugin.js" {
+    namespace Plugin {
+        interface Extensions extends ConfigContextExtensions {
+        }
+        interface Contexts {
+            config: ConfigFeature;
+        }
+    }
+}
+export declare class ConfigFeature extends Feature<ConfigRecord> {
+    #private;
+    readonly name: "config";
+    readonly icon = "Settings";
+    readonly desc = "\u914D\u7F6E";
+    /** 内部配置文件管理 */
+    readonly configs: Map<string, ConfigLoader<any>>;
+    /**
+     * 加载配置文件
+     */
     load<T extends object>(filename: string, initial?: Partial<T>, schema?: Schema<T>): ConfigLoader<T>;
+    /**
+     * 获取配置数据（代理模式，自动保存）
+     */
     get<T extends object>(filename: string, initial?: Partial<T>, schema?: Schema<T>): T;
+    /**
+     * 获取原始配置数据
+     */
     getRaw<T extends object>(filename: string, initial?: Partial<T>, schema?: Schema<T>): T;
     /**
      * 更新配置文件内容
-     * @param filename 配置文件名
-     * @param data 新的配置数据
      */
     set<T extends object>(filename: string, data: T): void;
+    /**
+     * 序列化为 JSON
+     */
+    toJSON(pluginName?: string): FeatureJSON;
+    /**
+     * 提供给 Plugin.prototype 的扩展方法
+     */
+    get extensions(): {
+        addConfig(key: string, defaultValue: any): () => void;
+    };
 }
+/**
+ * @deprecated Use ConfigFeature instead
+ */
+export declare const ConfigService: typeof ConfigFeature;
 //# sourceMappingURL=config.d.ts.map

package/lib/built/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/built/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,qBAAa,YAAY,CAAC,CAAC,SAAS,MAAM;;IAWnB,QAAQ,EAAE,MAAM;IAAS,OAAO,EAAC,CAAC;IAAS,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAThF,IAAI,IAAI,IAAI,CAAC,CAEZ;IACD,IAAI,GAAG,IAAI,CAAC,CAEX;IACD,IAAI,SAAS,WAEZ;gBACkB,QAAQ,EAAE,MAAM,EAAS,OAAO,EAAC,CAAC,EAAS,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,YAAA;IA+ChF,IAAI;IAsBJ,IAAI,CAAC,QAAQ,EAAE,MAAM;CAWxB;AACD,yBAAiB,YAAY,CAAA;IAClB,MAAM,mBAAmB,UAA6B,CAAC;IAC9D,SAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,mBAItF;CACJ;AACD,qBAAa,aAAa;IACtB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAa;;IAGpD,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAShF,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IAMnF,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IAMtF;;;;OAIG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;CAOzD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/built/config.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAOrD,qBAAa,YAAY,CAAC,CAAC,SAAS,MAAM;;IAWrB,QAAQ,EAAE,MAAM;IAAS,OAAO,EAAE,CAAC;IAAS,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IATjF,IAAI,IAAI,IAAI,CAAC,CAEZ;IACD,IAAI,GAAG,IAAI,CAAC,CAEX;IACD,IAAI,SAAS,WAEZ;gBACkB,QAAQ,EAAE,MAAM,EAAS,OAAO,EAAE,CAAC,EAAS,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,YAAA;IA2CjF,IAAI;IAsBJ,IAAI,CAAC,QAAQ,EAAE,MAAM;CAWtB;AAED,yBAAiB,YAAY,CAAC;IACrB,MAAM,mBAAmB,UAA6B,CAAC;IAC9D,SAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,mBAIvF;CACF;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,GAAG,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,GAAG,MAAM,IAAI,CAAC;CACvD;AAED,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,MAAM,CAAC;QACf,UAAU,UAAW,SAAQ,uBAAuB;SAAG;QACvD,UAAU,QAAQ;YAChB,MAAM,EAAE,aAAa,CAAC;SACvB;KACF;CACF;AAED,qBAAa,aAAc,SAAQ,OAAO,CAAC,YAAY,CAAC;;IACtD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,IAAI,kBAAQ;IAErB,eAAe;IACf,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAa;IAK7D;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IAanG;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IAOpF;;OAEG;IACH,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IAOvF;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAOtD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW;IAcxC;;OAEG;IACH,IAAI,UAAU;uBAGK,MAAM,gBAAgB,GAAG;MAsB3C;CACF;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,sBAAgB,CAAC"}

package/lib/built/config.js

@@ -1,6 +1,16 @@
+/**
+ * ConfigFeature
+ * 配置管理服务，继承自 Feature 抽象类
+ * 保留原有 ConfigLoader / ConfigService 逻辑，增加 addConfig 扩展
+ */
 import path from "node:path";
 import fs from "node:fs";
 import { stringify as stringifyYaml, parse as parseYaml } from "yaml";
+import { Feature } from "../feature.js";
+import { getPlugin } from "../plugin.js";
+// ============================================================================
+// ConfigLoader（保持不变）
+// ============================================================================
 export class ConfigLoader {
     filename;
     initial;
@@ -24,20 +34,16 @@ export class ConfigLoader {
     #proxy(data, loader) {
         return new Proxy(data, {
             get(target, prop, receiver) {
-                // 对于特殊属性（如 Symbol、prototype 等），直接返回原始值
                 if (typeof prop === 'symbol' || prop === 'constructor' || prop === 'prototype') {
                     return Reflect.get(target, prop, receiver);
                 }
                 const result = Reflect.get(target, prop, receiver);
-                // 对于函数属性（如数组的 map、filter 等），直接返回，不进行代理
                 if (typeof result === 'function') {
                     return result;
                 }
-                // 对于对象和数组，递归代理（但排除函数）
                 if (result instanceof Object && result !== null && typeof result !== 'function') {
                     return loader.#proxy(result, loader);
                 }
-                // 处理环境变量占位符
                 if (typeof result === 'string') {
                     if (result.startsWith('\\${') && result.endsWith('}'))
                         return result.slice(1);
@@ -106,10 +112,17 @@ export class ConfigLoader {
     }
     ConfigLoader.load = load;
 })(ConfigLoader || (ConfigLoader = {}));
-export class ConfigService {
+export class ConfigFeature extends Feature {
+    name = 'config';
+    icon = 'Settings';
+    desc = '配置';
+    /** 内部配置文件管理 */
     configs = new Map();
-    constructor() {
-    }
+    /** 主配置文件名（第一个加载的配置文件） */
+    #primaryConfigFile = '';
+    /**
+     * 加载配置文件
+     */
     load(filename, initial, schema) {
         const ext = path.extname(filename).toLowerCase();
         if (!ConfigLoader.supportedExtensions.includes(ext)) {
@@ -117,8 +130,14 @@ export class ConfigService {
         }
         const config = ConfigLoader.load(filename, initial, schema);
         this.configs.set(filename, config);
+        if (!this.#primaryConfigFile) {
+            this.#primaryConfigFile = filename;
+        }
         return config;
     }
+    /**
+     * 获取配置数据（代理模式，自动保存）
+     */
     get(filename, initial, schema) {
         if (!this.configs.has(filename))
             this.load(filename, initial, schema);
@@ -127,6 +146,9 @@ export class ConfigService {
             throw new Error(`配置文件 ${filename} 未加载`);
         return config.data;
     }
+    /**
+     * 获取原始配置数据
+     */
     getRaw(filename, initial, schema) {
         if (!this.configs.has(filename))
             this.load(filename, initial, schema);
@@ -137,16 +159,60 @@ export class ConfigService {
     }
     /**
      * 更新配置文件内容
-     * @param filename 配置文件名
-     * @param data 新的配置数据
      */
     set(filename, data) {
         const config = this.configs.get(filename);
         if (!config)
             throw new Error(`配置文件 ${filename} 未加载`);
-        // 直接更新内部数据（会触发 Proxy 的 set 拦截器并自动保存）
         Object.assign(config.raw, data);
         config.save(path.resolve(process.cwd(), filename));
     }
+    /**
+     * 序列化为 JSON
+     */
+    toJSON(pluginName) {
+        const list = pluginName ? this.getByPlugin(pluginName) : this.items;
+        return {
+            name: this.name,
+            icon: this.icon,
+            desc: this.desc,
+            count: list.length,
+            items: list.map(r => ({
+                name: r.key,
+                // 不暴露 defaultValue 以防止泄露密钥/令牌
+            })),
+        };
+    }
+    /**
+     * 提供给 Plugin.prototype 的扩展方法
+     */
+    get extensions() {
+        const feature = this;
+        return {
+            addConfig(key, defaultValue) {
+                const plugin = getPlugin();
+                // 尝试写入主配置文件（如果 key 不存在）
+                if (feature.#primaryConfigFile) {
+                    const config = feature.configs.get(feature.#primaryConfigFile);
+                    if (config) {
+                        const raw = config.raw;
+                        if (!(key in raw)) {
+                            raw[key] = defaultValue;
+                            config.save(path.resolve(process.cwd(), feature.#primaryConfigFile));
+                        }
+                    }
+                }
+                const record = { key, defaultValue };
+                const dispose = feature.add(record, plugin.name);
+                plugin.recordFeatureContribution(feature.name, key);
+                plugin.onDispose(dispose);
+                return dispose;
+            },
+        };
+    }
 }
+/**
+ * @deprecated Use ConfigFeature instead
+ */
+export const ConfigService = ConfigFeature;
 //# sourceMappingURL=config.js.map