mirror of
https://github.com/Wx-2025/ST-Amily2-Chat-Optimisation.git
synced 2026-06-06 04:35:51 +00:00
118 lines
3.4 KiB
JavaScript
118 lines
3.4 KiB
JavaScript
/**
|
||
* @file ITableStore 实现 —— 表格运行时状态的唯一所有者。
|
||
*
|
||
* 替代 manager.js 中三个 module-level 可变量：
|
||
* currentTablesState → 通过 getState/setState 访问
|
||
* highlightedCells → addHighlight/getHighlights/clearHighlights
|
||
* updatedTables → markTableUpdated/getUpdatedTables/clearUpdatedTables
|
||
*
|
||
* 本模块只承担"存"，不触发任何副作用（不保存、不渲染、不发事件总线消息）。
|
||
* 副作用编排留给 Service 层 / Action 层。
|
||
*
|
||
* setState 会触发 subscribe 注册的回调，给 UI / SuperMemory 一个钩子，
|
||
* 但不直接 import UI（保持 domain 纯度）。
|
||
*
|
||
* @typedef {import('../dto/Table.js').TableState} TableState
|
||
*/
|
||
|
||
import { log } from '../logger.js';
|
||
|
||
/** @type {TableState | null} */
|
||
let _state = null;
|
||
|
||
/** @type {Set<string>} 形如 "tableIndex-rowIndex-colIndex" */
|
||
const _highlights = new Set();
|
||
|
||
/** @type {Set<number>} 标记本周期内被改过的表格索引 */
|
||
const _updatedTables = new Set();
|
||
|
||
/** @type {Set<(state: TableState | null) => void>} */
|
||
const _listeners = new Set();
|
||
|
||
// ── 主状态 ────────────────────────────────────────────────────────────────
|
||
|
||
/**
|
||
* @returns {TableState | null}
|
||
*/
|
||
export function getState() {
|
||
return _state;
|
||
}
|
||
|
||
/**
|
||
* 直接替换全局状态。注意：不做深拷贝，调用方需自己负责传入的 state 不被外部 mutate。
|
||
* @param {TableState | null} newState
|
||
*/
|
||
export function setState(newState) {
|
||
_state = newState;
|
||
_notify();
|
||
}
|
||
|
||
/**
|
||
* 订阅 setState 触发的变更通知。返回取消订阅函数。
|
||
* 仅在 setState 被调用时触发；mutate 同一引用不会触发。
|
||
* @param {(state: TableState | null) => void} listener
|
||
* @returns {() => void}
|
||
*/
|
||
export function subscribe(listener) {
|
||
_listeners.add(listener);
|
||
return () => _listeners.delete(listener);
|
||
}
|
||
|
||
function _notify() {
|
||
for (const l of _listeners) {
|
||
try {
|
||
l(_state);
|
||
} catch (e) {
|
||
console.error('[TableStore] listener error:', e);
|
||
}
|
||
}
|
||
}
|
||
|
||
// ── 单元格高亮 ─────────────────────────────────────────────────────────────
|
||
|
||
/**
|
||
* @param {number} tableIndex
|
||
* @param {number} rowIndex
|
||
* @param {number} colIndex
|
||
*/
|
||
export function addHighlight(tableIndex, rowIndex, colIndex) {
|
||
_highlights.add(`${tableIndex}-${rowIndex}-${colIndex}`);
|
||
}
|
||
|
||
/**
|
||
* @returns {Set<string>}
|
||
*/
|
||
export function getHighlights() {
|
||
return _highlights;
|
||
}
|
||
|
||
export function clearHighlights() {
|
||
if (_highlights.size > 0) {
|
||
_highlights.clear();
|
||
log('已清除所有单元格高亮标记。', 'info');
|
||
}
|
||
}
|
||
|
||
// ── 更新过的表格标记 ───────────────────────────────────────────────────────
|
||
|
||
/**
|
||
* @param {number} tableIndex
|
||
*/
|
||
export function markTableUpdated(tableIndex) {
|
||
_updatedTables.add(tableIndex);
|
||
}
|
||
|
||
/**
|
||
* @returns {Set<number>}
|
||
*/
|
||
export function getUpdatedTables() {
|
||
return _updatedTables;
|
||
}
|
||
|
||
export function clearUpdatedTables() {
|
||
if (_updatedTables.size > 0) {
|
||
_updatedTables.clear();
|
||
log('已清除所有表格的更新标记。', 'info');
|
||
}
|
||
}
|