hortimagic 1.0.3 → 1.0.5

package/dist/index.d.ts

@@ -4,12 +4,13 @@
 /// <reference path="../src/components/type.d.ts"/>
 import { CSSResult } from 'lit';
 import { LitElement } from 'lit';
+import { proxy } from 'valtio/vanilla';
+import { snapshot } from 'valtio/vanilla';
+import { subscribe } from 'valtio/vanilla';
 import { TemplateResult } from 'lit-html';
-import { TinyEmitter } from 'tiny-emitter';
 
-/**
- * 向列表加入一个脚本，具有唯一性,名字或链接一样的话就覆盖
- * @param script 要添加的脚本对象
+/** 添加脚本到列表
+ * @param script 脚本对象
  * @returns 是否添加成功
  */
 declare function addScriptToList(script: Script): boolean;
@@ -24,20 +25,10 @@ declare function afterOnmessage(message: string): Promise<string>;
 
 declare function afterSend(message: string): string;
 
-export declare namespace app_tools {
-    export {
-        notice,
-        confirm_2 as confirm
-    }
-}
-
 declare namespace apps {
     export {
         main_app,
-        example_app,
-        dialog_app,
-        script_app,
-        app_tools
+        dialog_app
     }
 }
 export { apps }
@@ -52,6 +43,8 @@ declare function beforeSend(message: string): Promise<string | null>;
  */
 declare function changeRoom(roomId: string): void;
 
+declare function clearScriptList(): void;
+
 declare namespace components {
     export {
         hm_move_panel,
@@ -60,6 +53,7 @@ declare namespace components {
         hm_notification,
         hm_button,
         hm_cell,
+        hm_select,
         hm_swipe_cell,
         hm_switch,
         hm_accordion,
@@ -90,42 +84,47 @@ declare function compressHTML(html: string): string;
  * @param cancelCallback 选择取消时的回调函数
  * @param closeCallback 关闭弹窗时的回调函数
  * @example ```javascript
- * hortimagic.apps.app_tools.confirm('hhhhhhhhhhhhhh',()=>{console.log('qqqqqqqqqqq')},()=>{console.log('cccccccccccc')})
+ * hortimagic.easy_tools.confirm('hhhhhhhhhhhhhh',()=>{console.log('qqqqqqqqqqq')},()=>{console.log('cccccccccccc')})
  * ```
  */
 declare function confirm_2(message: string, confirmCallback?: Function, cancelCallback?: Function, closeCallback?: Function): void;
+export { confirm_2 as confirm }
 
 declare namespace core {
     export {
         tools,
-        iirose_socket,
-        event_emitter,
         Message,
+        socket_tools,
         encoder,
         decoder,
         elements_hooks,
+        Emitter,
+        log_tools,
+        store,
         script_tools
     }
 }
 export { core }
 
+/**
+ * 弹幕消息类
+ * 用于表示弹幕类型的消息
+ */
 declare class Danmu {
-    /**  */
+    /** 用户名 */
     username: string;
-    /**  */
+    /** 头像链接 */
     avatar: string;
-    /**  */
+    /** 消息 */
     message: string;
-    /**  */
+    /** 消息颜色 */
     color: string;
-    /**  */
+    /** 性别 */
     gender: string;
-    /**  */
+    /** 时间戳 */
     timeStamp: string;
-    /**  */
+    /** 唯一id */
     uid: string;
-    /** 消息类型 */
-    readonly messageClass = "danmu";
 }
 
 /**
@@ -137,12 +136,17 @@ declare class Danmu {
  */
 declare function danmu(message: string, color: string, v?: string): string;
 
+/**
+ * 解析消息字符串并将对应的消息对象添加到消息列表中
+ * @param message 原消息字符串
+ */
 declare function decodeMessage(message: string): void;
 
-declare namespace decoder {
+export declare namespace decoder {
     export {
-        messageObjList,
-        decodeMessage
+        judegMessageClass,
+        decodeMessage,
+        messageObjList
     }
 }
 
@@ -155,16 +159,28 @@ export declare namespace dialog {
 
 export declare namespace dialog_app {
     export {
-        dialogApp,
-        initDialogApp
+        initDialogApp,
+        HmDialogApp,
+        dialogApp
     }
 }
 
-declare let dialogApp: HmDialogApp;
+/**
+ * 默认的对话框模块
+ */
+declare const dialogApp: HmDialogApp;
 
-/** 移动面板容器 */
+/** 弹窗容器 */
 declare let dialogHolder: HTMLDivElement;
 
+declare namespace easy_tools {
+    export {
+        confirm_2 as confirm,
+        notice
+    }
+}
+export { easy_tools }
+
 /** 原来界面的元素 */
 declare let elements: {
     /** 移动窗口父元素,移动窗口容器 */
@@ -189,21 +205,80 @@ declare let elements: {
     moveinputSendBtnSend: Element | null;
 };
 
-declare namespace elements_hooks {
+export declare namespace elements_hooks {
     export {
-        elements,
         refreshAll,
-        Hooks,
-        initHooks
+        initHooks,
+        elements,
+        Hooks
     }
 }
 
 /**
- * 事件触发器
+ * Emitter 类提供事件驱动的编程模式，允许对象间通过事件进行通信
+ * 支持事件监听、取消监听、一次性监听和事件触发功能
  */
-declare let emitter: TinyEmitter;
+declare class Emitter {
+    /**
+     * 存储事件名称和对应监听器数组的映射
+     * @private
+     */
+    private events;
+    /**
+     * 为指定事件添加监听器
+     * @param eventName 事件名称
+     * @param listener 事件触发时要调用的回调函数
+     * @example
+     * ```ts
+     * const emitter = new Emitter();
+     * emitter.on('test', (data) => console.log('接收到数据:', data));
+     * emitter.emit('test', { message: 'Hello' }); // 输出: 接收到数据: { message: 'Hello' }
+     * ```
+     */
+    on(eventName: string, listener: Listener): void;
+    /**
+     * 移除指定事件的监听器
+     * @param eventName 事件名称
+     * @param listener 要移除的监听器函数，如果未提供则移除该事件的所有监听器
+     * @example
+     * ```ts
+     * const emitter = new Emitter();
+     * const listener = (data) => console.log(data);
+     * emitter.on('test', listener);
+     * emitter.off('test', listener); // 移除特定监听器
+     * emitter.off('test'); // 移除所有 'test' 事件的监听器
+     * ```
+     */
+    off(eventName: string, listener?: Listener): void;
+    /**
+     * 为指定事件添加一次性监听器，监听器在第一次触发后将被移除
+     * @param eventName 事件名称
+     * @param listener 事件触发时要调用的回调函数，只执行一次
+     * @example
+     * ```ts
+     * const emitter = new Emitter();
+     * emitter.once('start', () => console.log('仅执行一次'));
+     * emitter.emit('start'); // 输出: 仅执行一次
+     * emitter.emit('start'); // 没有输出，因为监听器已被移除
+     * ```
+     */
+    once(eventName: string, listener: Listener): void;
+    /**
+     * 触发指定事件，并传递参数给监听器
+     * @param eventName 事件名称
+     * @param args 传递给监听器的参数
+     * @returns 如果至少有一个监听器被调用则返回 true，否则返回 false
+     * @example
+     * ```ts
+     * const emitter = new Emitter();
+     * emitter.on('greet', (name, age) => console.log(`你好 ${name}, 你 ${age} 岁了`));
+     * emitter.emit('greet', '小明', 25); // 输出: 你好 小明, 你 25 岁了
+     * ```
+     */
+    emit(eventName: string, ...args: any[]): boolean;
+}
 
-declare namespace encoder {
+export declare namespace encoder {
     export {
         publicChat,
         privateChat,
@@ -217,18 +292,9 @@ declare namespace encoder {
     }
 }
 
-declare namespace event_emitter {
-    export {
-        TinyEmitter,
-        emitter
-    }
-}
+declare function findScriptByName(name: string): number;
 
-export declare namespace example_app {
-    export {
-        initExampleApp
-    }
-}
+declare function findScriptByUrl(url: string): number;
 
 /**
  * 创造一个新的私聊气泡，搭配静默发送私聊消息才能和“正常一样使用。
@@ -251,6 +317,7 @@ declare function getAllOnlineUserInfo(): {
     personalizedSignature: any;
 }[] | null;
 
+/** 获取svg代码 */
 declare function getIcon(name: string): string;
 
 /**
@@ -304,18 +371,16 @@ declare function getUserInputColor(): string | null;
  */
 declare function getUserName(): string | null;
 
-/**
- * 获取用户蔷薇头像url
- * @returns {string}
- */
-declare function getUserProfilePictureUrl(): string | null;
-
 /**
  * 获取当前用户的UID
  * @returns 返回当前用户的UID，没找到返回null
  */
 declare function getUserUid(): string | null;
 
+/**
+ * 隐藏消息类
+ * 用于表示隐藏类型的消息
+ */
 declare class Hidden {
     /** 消息的标题，名字？主题 */
     messageName: string;
@@ -323,8 +388,6 @@ declare class Hidden {
     uid: string;
     /** 数据 */
     data: string;
-    /** 消息类型 */
-    readonly messageClass = "hidden";
 }
 
 /**
@@ -364,6 +427,7 @@ export declare namespace hm_icon {
     export {
         registerIcon,
         getIcon,
+        iconMap,
         HmIcon
     }
 }
@@ -394,6 +458,12 @@ export declare namespace hm_notification {
     }
 }
 
+export declare namespace hm_select {
+    export {
+        HmSelect
+    }
+}
+
 export declare namespace hm_swipe_cell {
     export {
         HmSwipeCell
@@ -407,8 +477,10 @@ export declare namespace hm_switch {
 }
 
 /**
+ * 折叠面板
  * @example
- *   <hm-accordion>
+ * <hm-accordion title-content="标题内容"></hm-accordion>
+ * <hm-accordion>
  <span slot="header">我的折叠面板</span>
  <div>内容项 1</div>
  <div>内容项 2</div>
@@ -416,7 +488,10 @@ export declare namespace hm_switch {
  */
 declare class HmAccordion extends LitElement {
     maxHeight: string;
+    /** 折叠项 */
     items: any[];
+    /** 标题内容 */
+    titleContent: string;
     /** 是否展开 */
     expanded: boolean;
     static styles: CSSResult;
@@ -489,36 +564,7 @@ declare class HmButton extends LitElement {
  * @cssprop --hm-cell-background - 背景颜色
  *
  * @example
- * ```html
- * <!-- 基础用法 -->
- * <hm-cell
- *   titleName="单元格标题"
- *   descripthion="这是描述信息"
- *   content="内容区域">
- * </hm-cell>
- *
- * <!-- 使用插槽自定义内容 -->
- * <hm-cell>
- *   <div slot="title">自定义标题</div>
- *   <div slot="description">自定义描述</div>
- *   <div slot="content">自定义内容</div>
- * </hm-cell>
- *
- * <!-- 带点击事件 -->
- * <hm-cell
- *   titleName="可点击标题"
- *   content="点击查看详情"
- *   .titleClickCallback="${() => console.log('标题被点击')}"
- *   .contentClickCallback="${() => console.log('内容被点击')}">
- * </hm-cell>
- *
- * <!-- 自定义样式 -->
- * <hm-cell
- *   titleName="自定义样式"
- *   content="特殊样式"
- *   style="--hm-cell-background: #f0f8ff; --hm-cell-title-color: #1890ff;">
- * </hm-cell>
- * ```
+ * <hm-cell title-name="标题" descripthion="描述信息" content="内容"></hm-cell>
  */
 declare class HmCell extends LitElement {
     /** 标题，使用slot后失效 */
@@ -566,6 +612,10 @@ declare class HmDialog extends LitElement {
     render(): TemplateResult<1>;
 }
 
+/**
+ * 对话框模块
+ * @slot - 默认slot
+ */
 declare class HmDialogApp extends LitElement {
     dialogOpen: boolean;
     message: string;
@@ -578,7 +628,15 @@ declare class HmDialogApp extends LitElement {
     render(): TemplateResult<1>;
 }
 
+/** 图标组件
+ * @example
+ * <hm-icon icon="magic-wand"></hm-icon>
+ * <hm-icon icon="close"></hm-icon>
+ * <hm-icon icon="open"></hm-icon>
+ * <hm-icon icon="arrow-up"></hm-icon>
+ */
 declare class HmIcon extends LitElement {
+    /** 图标名称 */
     icon: string;
     size: string;
     /** 触发点击事件 */
@@ -619,9 +677,13 @@ declare class HmInput extends LitElement {
 }
 
 declare class HmMenu extends LitElement {
+    /** 图标 */
     icon: string;
+    /** 内容 */
     content: string;
+    /** 标记 */
     flag: boolean;
+    /** 是否是菜单项（二级菜单） */
     isMenuItem: boolean;
     static styles: CSSResult;
     /** 触发点击事件 */
@@ -640,25 +702,25 @@ declare class HmMovePanel extends LitElement {
     bodyBackgroundColor: string;
     bodyColor: string;
     footerBackgroundColor: string;
-    buttonBackgroundColor: string;
+    /** 按钮背景 */
+    buttonBackground: string;
+    /** 按钮文字色 */
     buttonColor: string;
     /** 标题 */
     titleContent: string;
     leftButtonText: string;
     rightButtonText: string;
-    /** 显示状态,不建议直接修改，请使用show()和hide()方法，否则无法触发对应事件 */
+    /** 显示状态,不建议直接修改，请使用showMovePanel()和hideMovePanel()方法，否则无法触发对应事件 */
     isDisplay: boolean;
     zIndex: number;
     /** 左上角图标 */
     icon: string;
+    /** 左下角图标 */
+    leftIcon: string;
+    /** 右下角图标 */
+    rightIcon: string;
     left: number;
     top: number;
-    handleLeftClick(): void;
-    handleRightClick(): void;
-    /**
-     * 组件内部的body元素
-     */
-    body: Promise<HTMLDivElement>;
     static styles: CSSResult;
     constructor();
     /** 关闭移动窗口 */
@@ -680,8 +742,8 @@ declare class HmMovePanel extends LitElement {
     putTopToggel(): void;
     render(): TemplateResult<1>;
     _handleClose(): void;
-    _handleLeftButtonClick(): void;
-    _handleRightButtonClick(): void;
+    handleLeftButtonClick(): void;
+    handleRightButtonClick(): void;
 }
 
 /** 通知消息组件
@@ -728,6 +790,80 @@ declare class HmNotification extends LitElement {
     render(): TemplateResult<1>;
 }
 
+/**
+ * HmSelect 是一个可自定义的下拉选择组件，基于 LitElement 构建
+ *
+ * @example
+ * 基本用法:
+ * ```html
+ * <hm-select .labelList="${[['选项1', 'value1'], ['选项2', 'value2']]}" @change="${(e) => logger.log('hm-select',e.detail)}"></hm-select>
+ * ```
+ *
+ * @example
+ * 禁用状态:
+ * ```html
+ * <hm-select .labelList="${[['选项1', 'value1'], ['选项2', 'value2']]}" disabled></hm-select>
+ * ```
+ *
+ * @example
+ * 带默认选中项:
+ * ```html
+ * <hm-select .labelList="${[['选项1', 'value1'], ['选项2', 'value2']]}" .index="${1}"></hm-select>
+ * ```
+ *
+ * @example
+ * 使用数字值:
+ * ```html
+ * <hm-select .labelList="${[['一', 1], ['二', 2], ['三', 3]]}" .index="${0}"></hm-select>
+ * ```
+ *
+ * @slot - 默认插槽，用于放置额外内容
+ * @fires change - 当选择项改变时触发，携带 { value, label, index } 信息
+ */
+declare class HmSelect extends LitElement {
+    /**
+     * 当前选中项的索引，默认为 0
+     * @type {number}
+     */
+    index: number;
+    /**
+     * 当前选中项的值
+     * @type {any}
+     */
+    value: any;
+    /**
+     * 选择项列表，每个项为 [label, value] 的数组格式
+     * @type {Array<Array<string | any>>}
+     */
+    labelList: (string | any)[][];
+    /**
+     * 是否禁用选择器
+     * @type {boolean}
+     */
+    disabled: boolean;
+    private selectRef;
+    static styles: CSSResult;
+    constructor();
+    connectedCallback(): void;
+    render(): TemplateResult<1>;
+    /**
+     * 处理选择项改变事件
+     * @param {Event} e - change 事件
+     * @private
+     */
+    private _handleChange;
+    /**
+     * 获取当前选中的值
+     * @returns {any} 当前选中的值，返回labelList中对应项的实际值类型
+     */
+    getValue(): any;
+    /**
+     * 设置选中值
+     * @param {any} value - 要设置的值，可以是字符串或数字等类型
+     */
+    setValue(value: any): void;
+}
+
 /**
  * 滑动单元格组件
  * 实现左右滑动显示操作按钮的交互效果
@@ -811,7 +947,7 @@ declare class HmSwipeCell extends LitElement {
  * <hm-switch openIcon="check" closeIcon="close"></hm-switch>
  *
  * <!-- 监听状态变化 -->
- * <hm-switch @hm-switch-change="${(e) => console.log('开关状态:', e.detail.checked)}"></hm-switch>
+ * <hm-switch @hm-switch-change="${(e) => logger.log('hm-switch','开关状态:', e.detail.checked)}"></hm-switch>
  * ```
  */
 declare class HmSwitch extends LitElement {
@@ -868,6 +1004,33 @@ declare let Hooks: {
     replaceButtonProcesser: () => void;
 };
 
+/**
+ * hortiMagicStore存储库
+ */
+declare const HortimagicStore: {
+    /** 是否自动保存 */
+    autoSave: boolean;
+    /** 日志是否开启 */
+    logFlag: {
+        log: boolean;
+        info: boolean;
+        debug: boolean;
+        warn: boolean;
+        error: boolean;
+    };
+    /** 消息日志是否开启 */
+    messageLogFlag: {
+        send: boolean;
+        decode: boolean;
+        emit: boolean;
+        receive: boolean;
+    };
+    /** 日志列表最大长度 */
+    logListLength: number;
+    /** 脚本列表 */
+    scriptList: Script[];
+};
+
 /**
  * html特殊符号反转义
  * @param {string} e
@@ -882,12 +1045,14 @@ declare function htmlSpecialCharsDecode(e: string): string;
  */
 declare function htmlSpecialCharsEscape(e: string): string;
 
-declare namespace iirose_socket {
-    export {
-        sockets,
-        initSocket
-    }
-}
+/** 存储图标的map类型数据
+ * key: 图标名称
+ * value: 图标svg代码
+ * 遍历图标名称的方式如下：
+ * @example
+ * for (const [iconName, iconSvg] of iconMap) {}
+ */
+declare const iconMap: Map<string, string>;
 
 /** package配置信息 */
 export declare const information: {
@@ -914,26 +1079,29 @@ export declare const information: {
     ingected: boolean;
 };
 
-/**
- * 读取本地脚本列表并注入
+declare const ingectedUrlList: string[];
+
+/** 注入脚本,不论它是否使能
+ * @param script 脚本对象
  */
-declare function ingectlocalScript(): void;
+declare function ingecteScript(script: Script): boolean;
+
+declare function ingecteScriptList(): void;
 
 declare function init(): Promise<void>;
 
 /** 初始化对话框模块 */
 declare function initDialogApp(): Promise<void>;
 
-/** 初始化移动面板容器 */
+/** 初始化弹窗容器 */
 declare function initDialogHolder(): void;
 
-declare function initExampleApp(): Promise<HmMenu>;
-
 /**
  * 注入钩子函数
  */
 declare function initHooks(): void;
 
+/** 初始化菜单容器 */
 declare function initMenuHolder(): void;
 
 /** 初始化移动面板容器 */
@@ -942,21 +1110,15 @@ declare function initMovePanelHolder(): void;
 /** 初始化通知容器 */
 declare function initNotificationHolder(): void;
 
-declare function initScriptApp(): Promise<HmMenu>;
-
 declare function initSocket(): Promise<void>;
 
-/**
- * 注入一个JS脚本
- * @param script 要注入的脚本对象
- */
-declare function injectScript(script: Script): boolean;
+declare function initStore(): void;
 
 /**
- * 注入一组JS脚本
- * @param list 脚本列表
+ * 判断消息类型并返回对应的类型字符串
+ * @param message
  */
-declare function injectScriptList(list: Script[]): void;
+declare function judegMessageClass(messageObj: MessageClass): "hidden" | "public" | "private" | "danmu" | "withdrawn" | "system" | "stock" | "unknown";
 
 /**
  * 编码点赞消息
@@ -966,6 +1128,67 @@ declare function injectScriptList(list: Script[]): void;
  */
 declare function like(targetUid: string, content?: string): string;
 
+/**
+ * 事件监听器类型定义，表示一个可以接收任意参数的函数
+ */
+declare type Listener = (...args: any[]) => void;
+
+/**
+ * 加载store
+ */
+declare function loadStore(): void;
+
+export declare namespace log_tools {
+    export {
+        logEmitter,
+        logger
+    }
+}
+
+/**
+ * 日志事件发射器
+ * 每次日志输出时都会触发'log'事件
+ */
+declare const logEmitter: Emitter;
+
+/**
+ * 日志记录器
+ * 根据配置中的日志级别来决定是否输出日志
+ * 只有当配置的日志级别与当前输出的日志级别匹配时才会输出日志
+ */
+export declare const logger: {
+    /**
+     * 记录普通日志
+     * 只有在配置的日志级小于等于DEBUG时才会输出
+     * @param args 要输出的参数
+     */
+    log(tag: string, ...args: any[]): void;
+    /**
+     * 输出调试日志
+     * 仅在配置的日志级别小于等于DEBUG时才会输出
+     * @param args 要输出的参数
+     */
+    debug(tag: string, ...args: any[]): void;
+    /**
+     * 输出信息日志
+     * 仅在配置的日志级别小于等于INFO时才会输出
+     * @param args 要输出的参数
+     */
+    info(tag: string, ...args: any[]): void;
+    /**
+     * 输出警告日志
+     * 仅在配置的日志级别小于等于WARN时才会输出
+     * @param args 要输出的参数
+     */
+    warn(tag: string, ...args: any[]): void;
+    /**
+     * 输出错误日志
+     * 仅在配置的日志级别小于等于ERROR时才会输出
+     * @param args 要输出的参数
+     */
+    error(tag: string, ...args: any[]): void;
+};
+
 export declare namespace main_app {
     export {
         init
@@ -979,10 +1202,12 @@ export declare namespace menu {
     }
 }
 
+/** 菜单容器 */
 declare let menuHolder: HTMLDivElement;
 
-declare namespace Message {
+export declare namespace Message {
     export {
+        MessageClass,
         Public,
         Private,
         Hidden,
@@ -994,8 +1219,16 @@ declare namespace Message {
     }
 }
 
+/**
+ * 所有消息类型的联合类型
+ * 用于类型检查和类型安全
+ */
+declare type MessageClass = Public | Private | Hidden | Danmu | Withdrawn | System | Stock | Unkonw;
+
+declare const messageEmitter: Emitter;
+
 /** 解析好后的消息列表 */
-declare let messageObjList: (Public | Private | Hidden | Danmu | Withdrawn | System | Stock | Unkonw)[];
+declare let messageObjList: MessageClass[];
 
 export declare namespace move_panel {
     export {
@@ -1026,11 +1259,57 @@ declare function musicCard(typeId: string, title: string, singerName: string, co
 
 /**
  * 消失通知函数
+ * @example
+ * ```javascript
+ * // 显示成功通知
+ * hortimagic.easy_tools.notice.success('操作成功', '您的操作已成功完成');
+ *
+ * // 显示警告通知
+ * hortimagic.easy_tools.notice.warning('警告', '请注意检查输入信息', 5000);
+ *
+ * // 显示错误通知
+ * hortimagic.easy_tools.notice.error('错误', '操作失败，请重试');
+ *
+ * // 显示普通通知
+ * hortimagic.easy_tools.notice.normal('提示', '这是一条普通提示信息');
+ * ```
  */
-declare let notice: {
+export declare const notice: {
+    /**
+     * 显示成功通知
+     * 创建并显示一个成功状态的通知组件
+     * @param title - 通知的标题文本
+     * @param content - 通知的内容文本
+     * @param displayTime - 通知显示的时间（毫秒），默认为3000毫秒
+     * @returns 无返回值
+     */
     success(title: string, content: string, displayTime?: number): void;
+    /**
+     * 显示警告通知
+     * 创建并显示一个警告状态的通知组件
+     * @param title - 通知的标题文本
+     * @param content - 通知的内容文本
+     * @param displayTime - 通知显示的时间（毫秒），默认为3000毫秒
+     * @returns 无返回值
+     */
     warning(title: string, content: string, displayTime?: number): void;
+    /**
+     * 显示错误通知
+     * 创建并显示一个错误状态的通知组件
+     * @param title - 通知的标题文本
+     * @param content - 通知的内容文本
+     * @param displayTime - 通知显示的时间（毫秒），默认为3000毫秒
+     * @returns 无返回值
+     */
     error(title: string, content: string, displayTime?: number): void;
+    /**
+     * 显示普通通知
+     * 创建并显示一个普通状态的通知组件
+     * @param title - 通知的标题文本
+     * @param content - 通知的内容文本
+     * @param displayTime - 通知显示的时间（毫秒），默认为3000毫秒
+     * @returns 无返回值
+     */
     normal(title: string, content: string, displayTime?: number): void;
 };
 
@@ -1050,6 +1329,10 @@ declare function originalOnmessage(message: string): string;
 
 declare function originalSend(message: string): string;
 
+/**
+ * 私聊消息类
+ * 用于表示私聊消息
+ */
 declare class Private {
     /** 时间戳 */
     timeStamp: string;
@@ -1067,8 +1350,6 @@ declare class Private {
     uid: string;
     /** 消息唯一标识 */
     messageUid: string;
-    /** 消息类型 */
-    readonly messageClass = "private";
 }
 
 /**
@@ -1080,6 +1361,10 @@ declare class Private {
  */
 declare function privateChat(uid: string, message: string, color: string): string;
 
+/**
+ * 公共消息类
+ * 用于表示公共频道中的消息
+ */
 declare class Public {
     /** 时间戳 */
     timeStamp: string;
@@ -1099,8 +1384,6 @@ declare class Public {
     designation: string;
     /** 消息UID */
     messageUid: string;
-    /** 消息类别 */
-    readonly messageClass = "public";
 }
 
 /**
@@ -1112,30 +1395,68 @@ declare class Public {
 declare function publicChat(message: string, color: string): string;
 
 /**
- * 读取本地存储的脚本列表
+ * 导出valtio响应式状态管理库常用方法
+ * @example
+ * // 创建响应式状态
+ * const state = reactive.proxy({ count: 0 })
+ *
+ * // 订阅状态变化
+ * reactive.subscribe(state, () => {
+ *   console.log('state has changed to', state)
+ * })
+ *
+ * // 获取状态快照
+ * const snap = reactive.snapshot(state)
+ *
+ * // 在组件中使用（注意：snapshot返回的是只读快照，不能直接修改）
+ * // 需要通过原始proxy对象进行修改
+ * const updateState = () => {
+ *   state.count++ // 直接修改原始proxy对象
+ * }
+ *
+ * // 无React环境使用示例：
+ * // 1. 创建状态
+ * const counterStore = proxy({ count: 0 });
+ *
+ * // 2. 修改状态
+ * counterStore.count++;
+ *
+ * // 3. 获取快照（用于显示）
+ * const snap = snapshot(counterStore);
+ * console.log(snap.count); // 输出当前值
+ *
+ * // 4. 订阅变化
+ * subscribe(counterStore, () => {
+ *   console.log('counter changed');
+ * });
  */
-declare function readScriptList(): void;
+declare const reactive: {
+    proxy: typeof proxy;
+    subscribe: typeof subscribe;
+    /**
+     * 获取快照
+     * @param {object} store
+     * @returns {object} 一个静态的快照
+     */
+    snapshot: typeof snapshot;
+};
 
 /**
  * 更新一些element
  */
 declare function refreshAll(): void;
 
+/** 提供静态方法用于外部注册图标 */
 declare function registerIcon(name: string, svgContent: string): void;
 
-/** 从列表中移除一个脚本
- * @param script 要移除的脚本对象
- */
-declare function removeScriptFromList(script: Script): void;
+declare function removeScriptFromList(script: Script): boolean;
 
 /**
- * 保存脚本列表到本地存储
+ * 保存store
  */
-declare function saveScriptList(): void;
+declare function saveStore(): void;
 
-/**
- * 脚本类
- */
+/** 脚本类 */
 declare class Script {
     /** 名字 */
     name: string;
@@ -1143,34 +1464,24 @@ declare class Script {
     url: string;
     /** 是否启用,默认启用 */
     enable: boolean;
-    /** 是否已经注入,手动修改 */
-    ingected: boolean;
-    constructor(name: string, url: string, enable?: boolean, ingected?: boolean);
+    constructor(name: string, url: string, enable?: boolean);
 }
 
-export declare namespace script_app {
+export declare namespace script_tools {
     export {
-        initScriptApp
-    }
-}
-
-declare namespace script_tools {
-    export {
-        Script,
-        scriptList,
         addScriptToList,
+        updateScriptInList,
         removeScriptFromList,
-        injectScript,
-        injectScriptList,
-        readScriptList,
-        saveScriptList,
-        ingectlocalScript
+        findScriptByUrl,
+        findScriptByName,
+        clearScriptList,
+        ingecteScript,
+        ingecteScriptList,
+        ingectedUrlList,
+        Script
     }
 }
 
-/** 脚本列表 */
-declare let scriptList: Script[];
-
 declare function send(message: string): Promise<void>;
 
 /**
@@ -1179,7 +1490,15 @@ declare function send(message: string): Promise<void>;
  */
 declare function sleep(ms: number): Promise<unknown>;
 
-declare const sockets: {
+export declare namespace socket_tools {
+    export {
+        initSocket,
+        messageEmitter,
+        socketTools
+    }
+}
+
+declare const socketTools: {
     beforeSend: typeof beforeSend;
     originalSend: typeof originalSend;
     afterSend: typeof afterSend;
@@ -1191,6 +1510,10 @@ declare const sockets: {
     initSocket: typeof initSocket;
 };
 
+/**
+ * 股票消息类
+ * 用于表示股票相关数据消息
+ */
 declare class Stock {
     /**
      * '*' 表示股价过低无法买股票
@@ -1209,8 +1532,6 @@ declare class Stock {
     totalEquity: number;
     /** 账户余额 */
     balance: number;
-    /** 消息类型 */
-    readonly messageClass = "stock";
 }
 
 /**
@@ -1220,20 +1541,32 @@ declare class Stock {
  */
 declare function stockRequest(count: number | undefined): string;
 
+export declare namespace store {
+    export {
+        saveStore,
+        loadStore,
+        initStore,
+        reactive,
+        HortimagicStore
+    }
+}
+
 /**
  * 切换房间
  * @param {string} roomId
  */
 declare function switchRoom(roomId: string): void;
 
+/**
+ * 系统消息类
+ * 用于表示系统通知类消息
+ */
 declare class System {
     /** 消息列表 */
     userMessageList: string[];
-    /** 消息类型 */
-    readonly messageClass = "system";
 }
 
-declare namespace tools {
+export declare namespace tools {
     export {
         sleep,
         compressHTML,
@@ -1248,20 +1581,23 @@ declare namespace tools {
         getOnlineUserInfoById,
         getAllOnlineUserInfo,
         changeRoom,
-        getUserProfilePictureUrl,
         getUserInputColor,
         generatePrivateMessageBubble,
         switchRoom
     }
 }
 
+/**
+ * 未知消息类
+ * 用于表示无法识别的消息类型
+ */
 declare class Unkonw {
     /** 未知消息的原型 */
     message: string;
-    /** 消息类型 */
-    readonly messageClass = "unkonw";
 }
 
+declare function updateScriptInList(script: Script): boolean;
+
 /**
  * 生成一个视频卡片消息
  * @param typeId 视频平台从0开始
@@ -1273,6 +1609,10 @@ declare class Unkonw {
  */
 declare function videoCard(typeId: string, title: string, singerName: string, coverUrl: string, color: string, resolutionRatio: string, time: string): string;
 
+/**
+ * 撤回消息类
+ * 用于表示撤回操作的消息
+ */
 declare class Withdrawn {
     /** 可选的，撤回私聊对象窗口的UID */
     privateUID: string;
@@ -1282,8 +1622,6 @@ declare class Withdrawn {
     messageUid: string;
     /** 数据唯一标识，上面两个组合在一起 */
     dataUid: string;
-    /** 消息类型 */
-    readonly messageClass = "withdrawn";
 }
 
 /**