@huanban/rulego-editor-core 1.0.0

package/dist/core/HistoryManager.d.ts

@@ -0,0 +1,166 @@
+/**
+ * @file HistoryManager.ts
+ * @description 基于 Command 模式的撤销/重做系统
+ *
+ * 实现完整的 Undo/Redo 功能，核心概念:
+ * - Command: 封装一个可执行和可撤销的操作
+ * - UndoStack: 记录已执行的命令
+ * - RedoStack: 记录已撤销的命令
+ * - BatchCommand: 将多个命令组合为一个原子操作
+ *
+ * 原版编辑器通过 LogicFlow 的 history:change 事件维护 undos/redos 数组,
+ * 这里改为独立的 HistoryManager 以支持更细粒度的操作控制。
+ */
+/**
+ * 命令接口
+ * 每个可撤销的操作都实现此接口
+ */
+export interface Command {
+    /** 执行操作 */
+    execute(): void;
+    /** 撤销操作 */
+    undo(): void;
+    /** 操作描述 (用于调试和 UI 提示) */
+    description: string;
+}
+/**
+ * 历史记录变更回调
+ */
+type HistoryChangeCallback = (state: {
+    canUndo: boolean;
+    canRedo: boolean;
+    undoCount: number;
+    redoCount: number;
+}) => void;
+/**
+ * 撤销/重做管理器
+ *
+ * @example
+ * ```typescript
+ * const history = new HistoryManager({ maxHistory: 50 })
+ *
+ * // 监听变更
+ * history.onChange((state) => {
+ *   updateUndoButton(state.canUndo)
+ *   updateRedoButton(state.canRedo)
+ * })
+ *
+ * // 执行命令
+ * history.execute(new AddNodeCommand(editor, nodeData))
+ *
+ * // 撤销
+ * history.undo()
+ *
+ * // 重做
+ * history.redo()
+ * ```
+ */
+export declare class HistoryManager {
+    /** 撤销栈 (最近执行的命令在顶部) */
+    private undoStack;
+    /** 重做栈 (最近撤销的命令在顶部) */
+    private redoStack;
+    /** 最大历史记录数 */
+    private maxHistory;
+    /** 变更回调列表 */
+    private changeCallbacks;
+    /** 是否暂停记录 (批量操作时使用) */
+    private paused;
+    /**
+     * 创建历史管理器
+     *
+     * @param options - 配置选项
+     * @param options.maxHistory - 最大历史记录数 (默认: 50)
+     */
+    constructor(options?: {
+        maxHistory?: number;
+    });
+    /**
+     * 执行一个命令并记录到撤销栈
+     *
+     * 执行新命令后会清空重做栈 (与所有编辑器的标准行为一致)
+     *
+     * @param command - 要执行的命令
+     */
+    execute(command: Command): void;
+    /**
+     * 撤销最近的命令
+     *
+     * @returns 是否成功撤销
+     */
+    undo(): boolean;
+    /**
+     * 重做最近撤销的命令
+     *
+     * @returns 是否成功重做
+     */
+    redo(): boolean;
+    /**
+     * 是否可以撤销
+     */
+    canUndo(): boolean;
+    /**
+     * 是否可以重做
+     */
+    canRedo(): boolean;
+    /**
+     * 获取撤销栈中的命令描述列表 (用于调试/UI显示)
+     */
+    getUndoDescriptions(): string[];
+    /**
+     * 获取重做栈中的命令描述列表
+     */
+    getRedoDescriptions(): string[];
+    /**
+     * 批量执行多个命令 (作为一个原子操作记录)
+     *
+     * 在批量执行期间暂停单独记录, 执行完成后创建 BatchCommand 统一记录
+     *
+     * @param commands - 要执行的命令列表
+     * @param description - 批量操作描述
+     */
+    executeBatch(commands: Command[], description: string): void;
+    /**
+     * 监听历史记录变更
+     *
+     * @param callback - 变更回调
+     * @returns 取消监听的函数
+     */
+    onChange(callback: HistoryChangeCallback): () => void;
+    /**
+     * 清空所有历史记录
+     */
+    clear(): void;
+    /**
+     * 暂停历史记录 (执行一些不需要撤销的操作时)
+     */
+    pause(): void;
+    /**
+     * 恢复历史记录
+     */
+    resume(): void;
+    /**
+     * 销毁管理器
+     */
+    destroy(): void;
+    /**
+     * 通知所有监听器状态变更
+     */
+    private notifyChange;
+}
+/**
+ * 批量命令 - 将多个命令组合为一个原子操作
+ */
+export declare class BatchCommand implements Command {
+    /** 子命令列表 */
+    private commands;
+    /** 批量操作描述 */
+    description: string;
+    constructor(commands: Command[], description: string);
+    /** 按顺序执行所有子命令 */
+    execute(): void;
+    /** 按逆序撤销所有子命令 */
+    undo(): void;
+}
+export {};
+//# sourceMappingURL=HistoryManager.d.ts.map

package/dist/core/HistoryManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HistoryManager.d.ts","sourceRoot":"","sources":["../../src/core/HistoryManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,WAAW;IACX,OAAO,IAAI,IAAI,CAAA;IACf,WAAW;IACX,IAAI,IAAI,IAAI,CAAA;IACZ,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAA;CACpB;AAMD;;GAEG;AACH,KAAK,qBAAqB,GAAG,CAAC,KAAK,EAAE;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB,KAAK,IAAI,CAAA;AAEV;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,cAAc;IACzB,uBAAuB;IACvB,OAAO,CAAC,SAAS,CAAgB;IACjC,uBAAuB;IACvB,OAAO,CAAC,SAAS,CAAgB;IACjC,cAAc;IACd,OAAO,CAAC,UAAU,CAAQ;IAC1B,aAAa;IACb,OAAO,CAAC,eAAe,CAAwC;IAC/D,uBAAuB;IACvB,OAAO,CAAC,MAAM,CAAQ;IAEtB;;;;;OAKG;gBACS,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAI7C;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAsB/B;;;;OAIG;IACH,IAAI,IAAI,OAAO;IAiBf;;;;OAIG;IACH,IAAI,IAAI,OAAO;IAiBf;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;;;;;;OAOG;IACH,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAK5D;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAOrD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf;;OAEG;IACH,OAAO,CAAC,YAAY;CAerB;AAMD;;GAEG;AACH,qBAAa,YAAa,YAAW,OAAO;IAC1C,YAAY;IACZ,OAAO,CAAC,QAAQ,CAAW;IAC3B,aAAa;IACb,WAAW,EAAE,MAAM,CAAA;gBAEP,QAAQ,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM;IAKpD,iBAAiB;IACjB,OAAO,IAAI,IAAI;IAIf,iBAAiB;IACjB,IAAI,IAAI,IAAI;CAGb"}

package/dist/core/I18nManager.d.ts

@@ -0,0 +1,130 @@
+/**
+ * @file I18nManager.ts
+ * @description 国际化管理器 — 多语言支持
+ *
+ * 轻量级的 i18n 实现, 基于嵌套对象路径查找。
+ * 支持:
+ * - 多语言包注册
+ * - 动态切换语言
+ * - 路径式 key 查找 (如 'sidebar.search', 'category.filter')
+ * - 变量插值 (如 'hello {{name}}')
+ * - 回退语言 (找不到翻译时用回退语言)
+ *
+ * 框架适配层可以将其桥接到 vue-i18n 或 react-intl 等框架级方案。
+ */
+/**
+ * 语言包类型 (支持嵌套)
+ */
+export type LocaleMessages = Record<string, string | Record<string, unknown>>;
+/**
+ * 语言变更回调
+ */
+type LocaleChangeCallback = (locale: string) => void;
+/**
+ * 国际化管理器
+ *
+ * @example
+ * ```typescript
+ * const i18n = new I18nManager({ locale: 'zh-CN', fallback: 'en-US' })
+ *
+ * // 注册语言包
+ * i18n.register('zh-CN', {
+ *   sidebar: {
+ *     search: '搜索组件...',
+ *     title: '组件列表',
+ *   },
+ *   category: {
+ *     filter: '过滤器',
+ *     transform: '转换器',
+ *   }
+ * })
+ *
+ * // 翻译
+ * i18n.t('sidebar.search')  // => '搜索组件...'
+ * i18n.t('category.filter') // => '过滤器'
+ *
+ * // 变量插值
+ * i18n.t('hello', { name: 'World' }) // => 'Hello World'
+ * ```
+ */
+export declare class I18nManager {
+    /** 当前语言 */
+    private locale;
+    /** 回退语言 */
+    private fallback;
+    /** 已注册的语言包: locale => messages */
+    private messages;
+    /** 语言变更回调 */
+    private changeCallbacks;
+    /**
+     * 创建国际化管理器
+     *
+     * @param options - 配置选项
+     */
+    constructor(options?: {
+        locale?: string;
+        fallback?: string;
+    });
+    /**
+     * 注册语言包
+     *
+     * @param locale - 语言标识 (如 zh-CN, en-US)
+     * @param messages - 语言包内容 (支持嵌套对象)
+     * @param merge - 是否与已有语言包合并 (默认: true)
+     */
+    register(locale: string, messages: LocaleMessages, merge?: boolean): void;
+    /**
+     * 获取翻译文本
+     *
+     * @param key - 翻译 key (支持点分路径, 如 'sidebar.search')
+     * @param params - 插值变量
+     * @returns 翻译后的文本, 找不到返回 key 本身
+     */
+    t(key: string, params?: Record<string, string | number>): string;
+    /**
+     * 切换语言
+     *
+     * @param locale - 目标语言
+     */
+    setLocale(locale: string): void;
+    /**
+     * 获取当前语言
+     */
+    getLocale(): string;
+    /**
+     * 获取所有已注册的语言列表
+     */
+    getAvailableLocales(): string[];
+    /**
+     * 监听语言变更
+     *
+     * @param callback - 变更回调
+     * @returns 取消监听函数
+     */
+    onLocaleChange(callback: LocaleChangeCallback): () => void;
+    /**
+     * 检查是否存在某个 key 的翻译
+     *
+     * @param key - 翻译 key
+     * @param locale - 指定语言 (默认: 当前语言)
+     */
+    has(key: string, locale?: string): boolean;
+    /**
+     * 销毁
+     */
+    destroy(): void;
+    /**
+     * 从语言包中按路径查找翻译
+     */
+    private lookup;
+    /**
+     * 变量插值: 将 {{key}} 替换为对应值
+     */
+    private interpolate;
+    /**
+     * 深合并两个对象
+     */
+    private deepMerge;
+}
+export {};
+//# sourceMappingURL=I18nManager.d.ts.map

package/dist/core/I18nManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"I18nManager.d.ts","sourceRoot":"","sources":["../../src/core/I18nManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAE7E;;GAEG;AACH,KAAK,oBAAoB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,WAAW;IACtB,WAAW;IACX,OAAO,CAAC,MAAM,CAAQ;IACtB,WAAW;IACX,OAAO,CAAC,QAAQ,CAAQ;IACxB,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAyC;IACzD,aAAa;IACb,OAAO,CAAC,eAAe,CAAuC;IAE9D;;;;OAIG;gBACS,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAK5D;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,UAAO,GAAG,IAAI;IAStE;;;;;;OAMG;IACH,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM;IAsBhE;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAa/B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAO1D;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IAI1C;;OAEG;IACH,OAAO,IAAI,IAAI;IASf;;OAEG;IACH,OAAO,CAAC,MAAM;IAiBd;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,OAAO,CAAC,SAAS;CA4BlB"}

package/dist/core/StateStore.d.ts

@@ -0,0 +1,160 @@
+/**
+ * @file StateStore.ts
+ * @description 框架无关的响应式状态容器
+ *
+ * 设计灵感来自 zustand/vanilla 和 nanostores。
+ * 提供发布-订阅模式的状态管理，支持:
+ * - 部分状态更新 (partial update)
+ * - 选择性订阅 (selector subscription, 只在特定字段变化时通知)
+ * - 快照获取 (get snapshot)
+ * - 自动清理 (unsubscribe 返回值模式)
+ *
+ * 各框架适配器可以包装为:
+ * - Vue: ref()/watch() 响应式
+ * - React: useSyncExternalStore() hook
+ * - 原生 JS: 直接 subscribe 回调
+ *
+ * @example
+ * ```typescript
+ * const store = new StateStore<EditorState>(initialState)
+ *
+ * // 订阅全部状态变化
+ * const unsubscribe = store.subscribe((state, prevState) => {
+ *   console.log('状态变更:', state)
+ * })
+ *
+ * // 选择性订阅
+ * const nodeSelector = store.select(s => s.selectedNode)
+ * nodeSelector.subscribe((node) => {
+ *   console.log('选中节点变化:', node)
+ * })
+ *
+ * // 更新状态
+ * store.setState({ selectedNode: someNode })
+ *
+ * // 函数式更新
+ * store.setState(prev => ({ isDirty: !prev.isDirty }))
+ * ```
+ */
+/**
+ * 状态变更监听器类型
+ * @param state - 新状态
+ * @param prevState - 旧状态
+ */
+type StateListener<T> = (state: T, prevState: T) => void;
+/**
+ * 选择器返回的订阅句柄
+ */
+interface SelectorHandle<S> {
+    /** 获取当前选中值 */
+    get: () => S;
+    /** 订阅选中值的变化 */
+    subscribe: (listener: (value: S, prevValue: S) => void) => () => void;
+}
+/**
+ * 框架无关的响应式状态容器
+ *
+ * @typeParam T - 状态对象的类型
+ */
+export declare class StateStore<T extends Record<string, unknown>> {
+    /** 当前状态 (内部可变) */
+    private state;
+    /** 全量订阅的监听器集合 */
+    private listeners;
+    /** 状态变更版本号 (用于 React useSyncExternalStore 等对比场景) */
+    private version;
+    /**
+     * 创建状态容器
+     * @param initialState - 初始状态对象
+     */
+    constructor(initialState: T);
+    /**
+     * 获取当前状态的只读快照
+     *
+     * 注意: 返回的是浅冻结对象，不应直接修改属性。
+     * 修改状态只能通过 setState 方法。
+     *
+     * @returns 当前状态的只读引用
+     */
+    getState(): Readonly<T>;
+    /**
+     * 获取当前版本号
+     * 每次 setState 调用版本号 +1，用于变更检测
+     *
+     * @returns 版本号
+     */
+    getVersion(): number;
+    /**
+     * 更新状态 (支持部分更新和函数式更新)
+     *
+     * 部分更新: 传入一个 Partial<T> 对象，自动与现有状态合并
+     * 函数式更新: 传入一个函数，接收当前状态，返回需要更新的部分
+     *
+     * @param partial - 部分状态对象或更新函数
+     *
+     * @example
+     * ```typescript
+     * // 对象方式
+     * store.setState({ selectedNode: node, isDirty: true })
+     *
+     * // 函数方式 (适合依赖当前状态的更新)
+     * store.setState(prev => ({
+     *   nodeCount: prev.nodeCount + 1
+     * }))
+     * ```
+     */
+    setState(partial: Partial<T> | ((prev: T) => Partial<T>)): void;
+    /**
+     * 批量更新状态 (只触发一次通知)
+     *
+     * 适用于需要同时修改多个状态但只想触发一次更新的场景
+     *
+     * @param updater - 更新函数，可多次调用 setState
+     */
+    batch(updater: () => void): void;
+    /**
+     * 订阅状态变化
+     *
+     * @param listener - 状态变更回调函数
+     * @returns 取消订阅函数 (调用后停止接收通知)
+     */
+    subscribe(listener: StateListener<T>): () => void;
+    /**
+     * 选择性订阅 (只关注特定字段的变化)
+     *
+     * 通过 selector 函数提取状态的一个切片。
+     * 只有当该切片发生变化时才触发通知，减少不必要的 UI 更新。
+     *
+     * 使用浅比较 (===) 进行变更检测，
+     * 如果 selector 返回引用类型，需注意引用是否真正发生了变化。
+     *
+     * @param selector - 状态选择器函数
+     * @returns 包含 get 和 subscribe 的句柄
+     *
+     * @example
+     * ```typescript
+     * const nodeHandle = store.select(s => s.selectedNode)
+     *
+     * // 获取当前值
+     * console.log(nodeHandle.get())
+     *
+     * // 只在 selectedNode 变化时收到通知
+     * nodeHandle.subscribe((node, prevNode) => {
+     *   console.log('节点变化:', prevNode, '->', node)
+     * })
+     * ```
+     */
+    select<S>(selector: (state: T) => S): SelectorHandle<S>;
+    /**
+     * 重置状态为指定值 (全量替换)
+     *
+     * @param newState - 新的完整状态
+     */
+    reset(newState: T): void;
+    /**
+     * 销毁状态容器，清除所有监听器
+     */
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=StateStore.d.ts.map

package/dist/core/StateStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateStore.d.ts","sourceRoot":"","sources":["../../src/core/StateStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH;;;;GAIG;AACH,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,KAAK,IAAI,CAAA;AAExD;;GAEG;AACH,UAAU,cAAc,CAAC,CAAC;IACxB,cAAc;IACd,GAAG,EAAE,MAAM,CAAC,CAAA;IACZ,eAAe;IACf,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;CACtE;AAED;;;;GAIG;AACH,qBAAa,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvD,kBAAkB;IAClB,OAAO,CAAC,KAAK,CAAG;IAChB,iBAAiB;IACjB,OAAO,CAAC,SAAS,CAAmC;IACpD,oDAAoD;IACpD,OAAO,CAAC,OAAO,CAAI;IAEnB;;;OAGG;gBACS,YAAY,EAAE,CAAC;IAK3B;;;;;;;OAOG;IACH,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC;IAIvB;;;;;OAKG;IACH,UAAU,IAAI,MAAM;IAIpB;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAkB/D;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAuBhC;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAOjD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC;IAmBvD;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI;IAaxB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/core/ThemeManager.d.ts

@@ -0,0 +1,175 @@
+/**
+ * @file core/ThemeManager.ts
+ * @description 主题管理器 — 支持多主题动态切换
+ *
+ * 基于 CSS 自定义属性 (CSS Variables) 实现运行时主题切换,
+ * 无需重新加载页面或重新编译样式。
+ *
+ * 核心设计:
+ * - 所有样式值都通过 CSS 变量定义 (如 --rg-bg-primary)
+ * - 切换主题 = 批量更新 CSS 变量值
+ * - 支持自定义主题注册 (只需提供变量映射)
+ * - 自动检测系统深色模式偏好
+ *
+ * 内置主题:
+ * - light: 明亮主题 (默认) — 清爽专业
+ * - dark: 暗色主题 — 护眼模式
+ * - blue: 蓝色主题 — 科技感
+ *
+ * 使用方式:
+ * ```typescript
+ * import { ThemeManager } from '@huanban/rulego-editor-core'
+ *
+ * const theme = new ThemeManager()
+ *
+ * // 切换到暗色主题
+ * theme.setTheme('dark')
+ *
+ * // 注册自定义主题
+ * theme.register('ocean', {
+ *   '--rg-bg-primary': '#0a192f',
+ *   '--rg-text-primary': '#ccd6f6',
+ *   // ...更多变量
+ * })
+ *
+ * // 跟随系统主题
+ * theme.followSystem()
+ *
+ * // 监听主题变更
+ * theme.onChange((themeName) => {
+ *   console.log('主题切换为:', themeName)
+ * })
+ * ```
+ *
+ * CSS 变量命名规范:
+ * - --rg-bg-*    : 背景色
+ * - --rg-text-*  : 文字色
+ * - --rg-border-*: 边框色
+ * - --rg-shadow-*: 阴影
+ * - --rg-node-*  : 节点专用 (按分类)
+ * - --rg-edge-*  : 连接线专用
+ * - --rg-ui-*    : UI 组件 (按钮、面板等)
+ *
+ * @see styles/variables.css 完整的 CSS 变量列表
+ */
+/**
+ * 主题变量映射
+ * key: CSS 变量名 (如 '--rg-bg-primary')
+ * value: 对应的值 (如 '#ffffff')
+ */
+export type ThemeVariables = Record<string, string>;
+/**
+ * 主题定义
+ */
+export interface ThemeDefinition {
+    /** 主题名称 */
+    name: string;
+    /** 显示标签 */
+    label: string;
+    /** 是否为暗色主题 (影响 data-theme 属性) */
+    isDark: boolean;
+    /** CSS 变量映射 */
+    variables: ThemeVariables;
+}
+/** 主题变更回调 */
+type ThemeChangeCallback = (themeName: string, isDark: boolean) => void;
+/**
+ * 主题管理器
+ *
+ * 通过修改容器元素的 CSS 自定义属性实现主题切换。
+ * 每套主题定义一组 CSS 变量值, 切换时批量更新。
+ */
+export declare class ThemeManager {
+    /** 已注册的主题 */
+    private themes;
+    /** 当前主题名 */
+    private currentTheme;
+    /** CSS 变量挂载的目标元素 (默认: document.documentElement) */
+    private targetElement;
+    /** 变更回调 */
+    private changeCallbacks;
+    /** 系统主题监听器 */
+    private systemThemeQuery;
+    /** 系统主题监听处理函数 */
+    private systemThemeHandler;
+    constructor();
+    /**
+     * 注册主题
+     *
+     * @param theme - 主题定义
+     * @param overwrite - 是否覆盖已有同名主题 (默认: true)
+     */
+    register(theme: ThemeDefinition, overwrite?: boolean): void;
+    /**
+     * 切换主题
+     *
+     * @param name - 主题名称
+     * @param container - CSS 变量挂载的容器元素 (可选, 默认 document.documentElement)
+     */
+    setTheme(name: string, container?: HTMLElement): void;
+    /**
+     * 获取当前主题名称
+     */
+    getTheme(): string;
+    /**
+     * 获取当前主题定义
+     */
+    getThemeDefinition(): ThemeDefinition | undefined;
+    /**
+     * 获取所有可用主题
+     */
+    getAvailableThemes(): Array<{
+        name: string;
+        label: string;
+        isDark: boolean;
+    }>;
+    /**
+     * 跟随系统主题 (自动检测深色/浅色模式)
+     *
+     * - 系统为深色模式 → 使用 'dark' 主题
+     * - 系统为浅色模式 → 使用 'light' 主题
+     *
+     * @param darkTheme - 深色模式使用的主题名 (默认: 'dark')
+     * @param lightTheme - 浅色模式使用的主题名 (默认: 'light')
+     */
+    followSystem(darkTheme?: string, lightTheme?: string): void;
+    /**
+     * 停止跟随系统主题
+     */
+    unfollowSystem(): void;
+    /**
+     * 监听主题变更
+     *
+     * @param callback - 变更回调 (themeName, isDark)
+     * @returns 取消监听函数
+     */
+    onChange(callback: ThemeChangeCallback): () => void;
+    /**
+     * 销毁主题管理器
+     */
+    destroy(): void;
+}
+/**
+ * 基础 CSS 变量列表 (所有主题共用的变量名)
+ * 每套主题只需要覆盖这些变量的值
+ */
+/**
+ * 🌤 明亮主题 (默认)
+ * 设计风格: 清爽、专业、高对比度
+ * 适合: 日间使用、正式场合、打印
+ */
+export declare const THEME_LIGHT: ThemeDefinition;
+/**
+ * 🌙 暗色主题
+ * 设计风格: 深邃、护眼、高级感
+ * 适合: 夜间使用、长时间工作
+ */
+export declare const THEME_DARK: ThemeDefinition;
+/**
+ * 🔵 蓝色科技主题
+ * 设计风格: 科技感、IoT 风格、专业
+ * 适合: 物联网控制台、监控场景、技术演示
+ */
+export declare const THEME_BLUE: ThemeDefinition;
+export {};
+//# sourceMappingURL=ThemeManager.d.ts.map

package/dist/core/ThemeManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeManager.d.ts","sourceRoot":"","sources":["../../src/core/ThemeManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAMH;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEnD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;IACb,iCAAiC;IACjC,MAAM,EAAE,OAAO,CAAA;IACf,eAAe;IACf,SAAS,EAAE,cAAc,CAAA;CAC1B;AAED,aAAa;AACb,KAAK,mBAAmB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;AAMvE;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,aAAa;IACb,OAAO,CAAC,MAAM,CAA0C;IACxD,YAAY;IACZ,OAAO,CAAC,YAAY,CAAU;IAC9B,mDAAmD;IACnD,OAAO,CAAC,aAAa,CAA2B;IAChD,WAAW;IACX,OAAO,CAAC,eAAe,CAAsC;IAC7D,cAAc;IACd,OAAO,CAAC,gBAAgB,CAA8B;IACtD,iBAAiB;IACjB,OAAO,CAAC,kBAAkB,CAAkD;;IAS5E;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,SAAS,UAAO,GAAG,IAAI;IAQxD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,WAAW,GAAG,IAAI;IAoCrD;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,kBAAkB,IAAI,eAAe,GAAG,SAAS;IAIjD;;OAEG;IACH,kBAAkB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAQ7E;;;;;;;;OAQG;IACH,YAAY,CAAC,SAAS,SAAS,EAAE,UAAU,SAAU,GAAG,IAAI;IAqB5D;;OAEG;IACH,cAAc,IAAI,IAAI;IAQtB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAOnD;;OAEG;IACH,OAAO,IAAI,IAAI;CAKhB;AAMD;;;GAGG;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,eA0IzB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,eA0IxB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,eA0IxB,CAAA"}