@zhin.js/core 1.1.0 → 1.1.3

package/src/built/component.ts

@@ -1,130 +0,0 @@
-/**
- * ComponentFeature
- * 管理所有插件注册的组件，继承自 Feature 抽象类
- */
-import { Feature, FeatureJSON } from "../feature.js";
-import { Component, renderComponents } from "../component.js";
-import { SendOptions, MaybePromise } from "../types.js";
-import { Plugin, getPlugin } from "../plugin.js";
-import type { PluginLike } from '@zhin.js/kernel';
-
-type Listener = (options: SendOptions) => MaybePromise<SendOptions>;
-
-/**
- * ComponentContext 扩展方法类型
- */
-export interface ComponentContextExtensions {
-  /** 添加组件 */
-  addComponent<T extends Component<any>>(component: T): () => void;
-}
-
-// 扩展 Plugin 接口
-declare module "../plugin.js" {
-  namespace Plugin {
-    interface Extensions extends ComponentContextExtensions {}
-    interface Contexts {
-      component: ComponentFeature;
-    }
-  }
-}
-
-/**
- * 组件服务 Feature
- */
-export class ComponentFeature extends Feature<Component<any>> {
-  readonly name = 'component' as const;
-  readonly icon = 'Box';
-  readonly desc = '组件';
-
-  /** 按名称索引 */
-  readonly byName = new Map<string, Component<any>>();
-
-  /** 内部状态：消息渲染监听器 & 宿主插件 */
-  #listener?: Listener;
-  #rootPlugin?: Plugin;
-
-  /**
-   * 添加组件
-   */
-  add(component: Component<any>, pluginName: string): () => void {
-    this.byName.set(component.name, component);
-    return super.add(component, pluginName);
-  }
-
-  /**
-   * 移除组件
-   */
-  remove(component: Component<any>): boolean {
-    this.byName.delete(component.name);
-    return super.remove(component);
-  }
-
-  /**
-   * 获取所有组件名称
-   */
-  getAllNames(): string[] {
-    return Array.from(this.byName.keys());
-  }
-
-  /**
-   * 按名称获取组件
-   */
-  get(name: string): Component<any> | undefined {
-    return this.byName.get(name);
-  }
-
-  /**
-   * 生命周期: 挂载时注册消息渲染监听器
-   */
-  mounted(plugin: PluginLike): void {
-    const p = plugin as Plugin;
-    this.#rootPlugin = p;
-    this.#listener = (options: SendOptions) => {
-      return renderComponents(this.byName, options);
-    };
-    p.root.on('before.sendMessage', this.#listener);
-  }
-
-  /**
-   * 生命周期: 销毁时移除监听器
-   */
-  dispose(): void {
-    if (this.#listener && this.#rootPlugin) {
-      this.#rootPlugin.root.off('before.sendMessage', this.#listener);
-      this.#listener = undefined;
-    }
-  }
-
-  /**
-   * 序列化为 JSON
-   */
-  toJSON(pluginName?: string): FeatureJSON {
-    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<T extends Component<any>>(component: T) {
-        const plugin = getPlugin();
-        const dispose = feature.add(component, plugin.name);
-        plugin.recordFeatureContribution(feature.name, component.name);
-        plugin.onDispose(dispose);
-        return dispose;
-      },
-    };
-  }
-}

package/src/built/config.ts

@@ -1,335 +0,0 @@
-/**
- * ConfigFeature
- * 配置管理服务，继承自 Feature 抽象类
- * 保留原有 ConfigLoader / ConfigService 逻辑，增加 addConfig 扩展
- */
-import path from "node:path";
-import fs from "node:fs";
-import { stringify as stringifyYaml, parse as parseYaml, parseDocument } from "yaml";
-import { parse as parseToml, stringify as stringifyToml } from "smol-toml";
-import { Schema } from "@zhin.js/schema";
-import { Feature, FeatureJSON } from "../feature.js";
-import { getPlugin } from "../plugin.js";
-
-// ============================================================================
-// ConfigLoader（保持不变）
-// ============================================================================
-
-export class ConfigLoader<T extends object> {
-  #data: T;
-  get data(): T {
-    return this.#proxy(this.#data, this);
-  }
-  get raw(): T {
-    return this.#data;
-  }
-  get extension() {
-    return path.extname(this.filename).toLowerCase();
-  }
-  constructor(public filename: string, public initial: T, public schema?: Schema<T>) {
-    this.#data = this.initial;
-  }
-  #proxy<R extends object>(data: R, loader: ConfigLoader<T>) {
-    return new Proxy(data, {
-      get(target, prop, receiver) {
-        if (typeof prop === 'symbol' || prop === 'constructor' || prop === 'prototype') {
-          return Reflect.get(target, prop, receiver);
-        }
-
-        const result = Reflect.get(target, prop, receiver);
-
-        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);
-          if (/^\$\{(.*)\}$/.test(result)) {
-            const content = result.slice(2, -1);
-            // 支持 bash 风格的默认值语法：${VAR:-default} 和 ${VAR:=default}
-            // 同时兼容简单语法 ${VAR:default}
-            let key: string;
-            let defaultValue: string | undefined;
-            const bashDefaultMatch = content.match(/^([^:}]+):[-=](.*)$/);
-            if (bashDefaultMatch) {
-              // ${VAR:-default} 或 ${VAR:=default}
-              key = bashDefaultMatch[1];
-              defaultValue = bashDefaultMatch[2];
-            } else if (content.includes(':')) {
-              // ${VAR:default}（旧的简单语法）
-              const [k, ...rest] = content.split(':');
-              key = k;
-              defaultValue = rest.join(':');
-            } else {
-              key = content;
-              defaultValue = undefined;
-            }
-            return process.env[key] ?? defaultValue ?? (loader.initial as any)[key] ?? result;
-          }
-        }
-        return result;
-      },
-      set(target, prop, value, receiver) {
-        const result = Reflect.set(target, prop, value, receiver);
-        loader.save(loader.filename);
-        return result;
-      },
-      deleteProperty(target, prop) {
-        const result = Reflect.deleteProperty(target, prop);
-        loader.save(loader.filename);
-        return result;
-      }
-    });
-  }
-  load() {
-    const fullPath = path.resolve(process.cwd(), this.filename);
-    if (!fs.existsSync(fullPath)) {
-      this.save(fullPath);
-    }
-    const content = fs.readFileSync(fullPath, "utf-8");
-    let rawConfig: any;
-    switch (this.extension) {
-      case ".json":
-        rawConfig = JSON.parse(content);
-        break;
-      case ".yaml":
-      case ".yml":
-        rawConfig = parseYaml(content);
-        break;
-      case ".toml":
-        rawConfig = parseToml(content);
-        break;
-    }
-    if (this.schema) {
-      this.#data = this.schema(rawConfig || this.initial) as T;
-    } else {
-      this.#data = rawConfig as T;
-    }
-  }
-  save(fullPath: string) {
-    switch (this.extension) {
-      case ".json":
-        fs.writeFileSync(fullPath, JSON.stringify(this.#data, null, 2));
-        break;
-      case ".yaml":
-      case ".yml":
-        fs.writeFileSync(fullPath, stringifyYaml(this.#data));
-        break;
-      case ".toml":
-        fs.writeFileSync(fullPath, stringifyToml(this.#data as Record<string, any>));
-        break;
-    }
-  }
-  /**
-   * 精准修改单个顶层 key 并写回文件
-   * 保留注释、格式和未修改字段（如 ${VAR} 环境变量引用）
-   */
-  patchKey(key: string, value: any) {
-    const fullPath = path.resolve(process.cwd(), this.filename);
-    switch (this.extension) {
-      case ".yaml":
-      case ".yml": {
-        const content = fs.readFileSync(fullPath, 'utf-8');
-        const doc = parseDocument(content);
-        doc.set(key, value);
-        fs.writeFileSync(fullPath, doc.toString());
-        break;
-      }
-      case ".json": {
-        const content = fs.readFileSync(fullPath, 'utf-8');
-        const obj = JSON.parse(content);
-        obj[key] = value;
-        fs.writeFileSync(fullPath, JSON.stringify(obj, null, 2));
-        break;
-      }
-      case ".toml": {
-        const content = fs.readFileSync(fullPath, 'utf-8');
-        const obj = parseToml(content);
-        (obj as Record<string, any>)[key] = value;
-        fs.writeFileSync(fullPath, stringifyToml(obj));
-        break;
-      }
-    }
-    // 同步更新内存
-    (this.#data as Record<string, any>)[key] = value;
-  }
-}
-
-export namespace ConfigLoader {
-  export const supportedExtensions = [".json", ".yaml", ".yml", ".toml"];
-
-  /**
-   * 自动发现配置文件（按优先级：yml > yaml > json > toml）
-   */
-  export function discover(basename: string): string | null {
-    const cwd = process.cwd();
-    for (const ext of ['.yml', '.yaml', '.json', '.toml']) {
-      const filename = `${basename}${ext}`;
-      if (fs.existsSync(path.resolve(cwd, filename))) {
-        return filename;
-      }
-    }
-    return null;
-  }
-  export function load<T extends object>(filename: string, initial?: T, schema?: Schema<T>) {
-    const result = new ConfigLoader<T>(filename, initial ?? {} as T, schema);
-    result.load();
-    return result;
-  }
-}
-
-// ============================================================================
-// ConfigFeature
-// ============================================================================
-
-/**
- * 配置项声明记录
- */
-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 class ConfigFeature extends Feature<ConfigRecord> {
-  readonly name = 'config' as const;
-  readonly icon = 'Settings';
-  readonly desc = '配置';
-
-  /** 内部配置文件管理 */
-  readonly configs: Map<string, ConfigLoader<any>> = new Map();
-
-  /** 主配置文件名（第一个加载的配置文件） */
-  #primaryConfigFile: string = '';
-
-  /** 获取主配置文件名 */
-  get primaryFile(): string {
-    return this.#primaryConfigFile;
-  }
-
-  /**
-   * 加载配置文件
-   */
-  load<T extends object>(filename: string, initial?: Partial<T>, schema?: Schema<T>): ConfigLoader<T> {
-    const ext = path.extname(filename).toLowerCase();
-    if (!ConfigLoader.supportedExtensions.includes(ext)) {
-      throw new Error(`不支持的配置文件格式: ${ext}`);
-    }
-    const config = ConfigLoader.load(filename, initial as T, schema);
-    this.configs.set(filename, config);
-    if (!this.#primaryConfigFile) {
-      this.#primaryConfigFile = filename;
-    }
-    return config;
-  }
-
-  /**
-   * 获取配置数据（代理模式，自动保存）
-   */
-  get<T extends object>(filename: string, initial?: Partial<T>, schema?: Schema<T>): T {
-    if (!this.configs.has(filename)) this.load(filename, initial, schema);
-    const config = this.configs.get(filename);
-    if (!config) throw new Error(`配置文件 ${filename} 未加载`);
-    return config.data as T;
-  }
-
-  /**
-   * 获取主配置文件数据（第一个加载的配置文件）
-   */
-  getPrimary<T extends object>(): T {
-    if (!this.#primaryConfigFile) throw new Error('没有加载任何配置文件');
-    return this.get<T>(this.#primaryConfigFile);
-  }
-
-  /**
-   * 获取原始配置数据
-   */
-  getRaw<T extends object>(filename: string, initial?: Partial<T>, schema?: Schema<T>): T {
-    if (!this.configs.has(filename)) this.load(filename, initial, schema);
-    const config = this.configs.get(filename);
-    if (!config) throw new Error(`配置文件 ${filename} 未加载`);
-    return config.raw as T;
-  }
-
-  /**
-   * 更新配置文件内容
-   */
-  set<T extends object>(filename: string, data: T): void {
-    const config = this.configs.get(filename);
-    if (!config) throw new Error(`配置文件 ${filename} 未加载`);
-    Object.assign(config.raw, data);
-    config.save(path.resolve(process.cwd(), filename));
-  }
-
-  /**
-   * 序列化为 JSON
-   */
-  toJSON(pluginName?: string): FeatureJSON {
-    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: string, defaultValue: any) {
-        const plugin = getPlugin();
-
-        // 尝试写入主配置文件（如果 key 不存在）
-        if (feature.#primaryConfigFile) {
-          const config = feature.configs.get(feature.#primaryConfigFile);
-          if (config) {
-            const raw = config.raw as Record<string, any>;
-            if (!(key in raw)) {
-              raw[key] = defaultValue;
-              config.save(path.resolve(process.cwd(), feature.#primaryConfigFile));
-            }
-          }
-        }
-
-        const record: ConfigRecord = { 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;

package/src/built/cron.ts

@@ -1,156 +0,0 @@
-/**
- * CronFeature
- * 管理所有插件注册的定时任务，继承自 Feature 抽象类
- */
-import { Feature, FeatureJSON } from "../feature.js";
-import { Cron } from "../cron.js";
-import { Plugin, getPlugin } from "../plugin.js";
-
-/**
- * CronContext 扩展方法类型
- */
-export interface CronContextExtensions {
-  /** 添加定时任务 */
-  addCron(cron: Cron): () => void;
-}
-
-// 扩展 Plugin 接口
-declare module "../plugin.js" {
-  namespace Plugin {
-    interface Extensions extends CronContextExtensions {}
-    interface Contexts {
-      cron: CronFeature;
-    }
-  }
-}
-
-/**
- * 定时任务服务 Feature
- */
-export class CronFeature extends Feature<Cron> {
-  readonly name = 'cron' as const;
-  readonly icon = 'Clock';
-  readonly desc = '定时任务';
-
-  /** 按 ID/表达式 索引 */
-  readonly byName = new Map<string, Cron>();
-
-  /**
-   * 添加定时任务，自动启动
-   */
-  add(cron: Cron, pluginName: string): () => void {
-    this.byName.set(cron.id || cron.cronExpression, cron);
-    // 自动启动
-    if (!cron.running) {
-      cron.run();
-    }
-    return super.add(cron, pluginName);
-  }
-
-  /**
-   * 移除定时任务，自动停止
-   */
-  remove(cron: Cron): boolean {
-    if (cron.running) {
-      cron.stop();
-    }
-    this.byName.delete(cron.id || cron.cronExpression);
-    return super.remove(cron);
-  }
-
-  /**
-   * 按 ID/表达式 获取
-   */
-  get(id: string): Cron | undefined {
-    return this.byName.get(id);
-  }
-
-  /**
-   * 停止所有任务
-   */
-  stopAll(): void {
-    for (const cron of this.items) {
-      if (cron.running) {
-        cron.stop();
-      }
-    }
-  }
-
-  /**
-   * 启动所有任务
-   */
-  startAll(): void {
-    for (const cron of this.items) {
-      if (!cron.running && !cron.disposed) {
-        cron.run();
-      }
-    }
-  }
-
-  /**
-   * 获取所有任务状态
-   */
-  getStatus(): Array<{
-    expression: string;
-    running: boolean;
-    nextExecution: Date | null;
-    plugin: string;
-  }> {
-    return this.items.map(cron => {
-      // 从 pluginItems 中找到对应的插件名
-      let pluginName = 'unknown';
-      for (const [name, items] of this.pluginItems) {
-        if (items.includes(cron)) {
-          pluginName = name;
-          break;
-        }
-      }
-      return {
-        expression: cron.cronExpression,
-        running: cron.running,
-        nextExecution: cron.running ? cron.getNextExecutionTime() : null,
-        plugin: pluginName,
-      };
-    });
-  }
-
-  /**
-   * 生命周期: 销毁时停止所有任务
-   */
-  dispose(): void {
-    this.stopAll();
-  }
-
-  /**
-   * 序列化为 JSON
-   */
-  toJSON(pluginName?: string): FeatureJSON {
-    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 => ({
-        expression: c.cronExpression,
-        running: c.running,
-      })),
-    };
-  }
-
-  /**
-   * 提供给 Plugin.prototype 的扩展方法
-   */
-  get extensions() {
-    const feature = this;
-    return {
-      addCron(cron: Cron) {
-        const plugin = getPlugin();
-        const dispose = feature.add(cron, plugin.name);
-        plugin.recordFeatureContribution(feature.name, cron.id || cron.cronExpression);
-        plugin.onDispose(dispose);
-        return dispose;
-      },
-    };
-  }
-}