@ccpc/core 0.1.0

package/dist/transaction/transaction_group.js

@@ -0,0 +1,242 @@
+import { DebugUtil } from '../toolkit/debug_util';
+import { EN_TransactionStatus } from './i_transaction_base';
+import { Transaction } from './transaction';
+import { TransactionBase } from './transaction_base';
+export class TransactionGroup extends TransactionBase {
+    constructor(doc, name, isRoot = false) {
+        super(doc, name);
+        this.isRoot = isRoot;
+        this.undoList = [];
+        this.redoList = [];
+        this._maxUndoStackSize = 30;
+        this.isRoot = isRoot;
+        this.start();
+    }
+    start() {
+        // TODO 发送事件
+        super.start();
+        if (this.isRoot)
+            return true;
+        this.doc.transactionMgr.getLastLeafTranGroup(true)?.clearRedoList();
+        this.parent = this.getStartParent();
+        return true;
+    }
+    startTransaction(t) {
+        DebugUtil.assert(this.getStatus() === EN_TransactionStatus.STARTED, '事务组已完成,不能再启动事务', 'wg', '2026-03-05');
+        const oldName = this.getCurrentTransaction()?.name;
+        const newName = t.name;
+        DebugUtil.assert(this.getStatus() === EN_TransactionStatus.STARTED && !this.getCurrentTransaction(), `事务不能嵌套, 新事务${newName}, 未完成的事务${oldName}`, 'wg', '2025-03-05');
+        this.undoList.push(t);
+        this.redoList.splice(0);
+        const max = Math.max(this.getMaxUndoStackSize(), 4);
+        if (this.undoList.length <= max) {
+            return;
+        }
+        const head = this.undoList.shift();
+        // edit mode will compress all transactions to one single node,so we should merge first node to second
+        if (head && this.parent) {
+            const first = this._toTransaction(head);
+            const second = this._toTransaction(this.undoList[0]);
+            this.undoList[0] = first.merge(second);
+        }
+    }
+    /**
+     * 事务或事务组转成事务
+     */
+    _toTransaction(t) {
+        if (t.isTransactionLike(TransactionGroup))
+            return t._compressToTransaction();
+        else
+            return t;
+    }
+    /**
+     * 事务组压缩成事务
+     */
+    _compressToTransaction() {
+        //空的事务组 压缩成一个空事务
+        if (!this.undoList.length) {
+            const empty = new Transaction(this.doc, 'empty');
+            empty.setStatus(EN_TransactionStatus.COMMITTED);
+            return empty;
+        }
+        const newName = this.undoList[0].name + '->' + this.undoList[this.undoList.length - 1].name;
+        while (this.undoList.length > 1) {
+            const popped = this.undoList.pop();
+            DebugUtil.assert(popped, 'undoList不应该为空', 'wg', '2026-03-05');
+            const next = this._toTransaction(popped);
+            const pre = this._toTransaction(this.undoList[this.undoList.length - 1]);
+            this.undoList[this.undoList.length - 1] = pre;
+            pre.merge(next);
+        }
+        const result = this.undoList[0];
+        result.name = newName;
+        result.canUndo = true;
+        return result;
+    }
+    assimilate() {
+        this._status = EN_TransactionStatus.COMMITTED;
+        if (!this.undoList.length) {
+            this.parent?.undoList.pop();
+            return undefined;
+        }
+        const transaction = this._compressToTransaction();
+        this.parent?.replaceTailTransaction(this, transaction);
+        // TODO 刷新视图, 发送事件
+        // this.doc.updateView();
+        return transaction;
+    }
+    /**
+     * 压缩成一个事务,然后undo
+     */
+    rollBack() {
+        super.rollBack();
+        if (!this.undoList.length) {
+            this.parent?.undoList.pop();
+            return true;
+        }
+        const transaction = this._compressToTransaction();
+        this.parent?.replaceTailTransaction(this, transaction);
+        this.parent?.undoWithoutRedo(transaction);
+        return true;
+    }
+    undoWithoutRedo(ut) {
+        ut.reverseAndExecute();
+        this.undoList.pop();
+        return true;
+    }
+    replaceTailTransaction(tail, t) {
+        DebugUtil.assert(this.undoList[this.undoList.length - 1] === tail, '只能替换栈顶事务', 'wg', '2026-03-05');
+        this.undoList[this.undoList.length - 1] = t;
+        t.parent = this;
+        return true;
+    }
+    canUndo() {
+        const ut = this.undoList[this.undoList.length - 1];
+        if (!ut)
+            return false;
+        if (ut.isTransactionLike(TransactionGroup)) {
+            if (ut._undoListNotEmpty()) {
+                return ut.canUndo();
+            }
+            return false;
+        }
+        else if (ut.isTransactionLike(Transaction)) {
+            return !!ut.canUndo;
+        }
+        return false;
+    }
+    canRedo() {
+        const ut = this.redoList[this.redoList.length - 1];
+        if (!ut)
+            return false;
+        if (ut.isTransactionLike(TransactionGroup)) {
+            if (ut._redoListNotEmpty()) {
+                return ut.canRedo();
+            }
+            return false;
+        }
+        return true;
+    }
+    /**
+     * undo数组是否为空
+     */
+    _undoListNotEmpty() {
+        return !!this.undoList.length;
+    }
+    /**
+     * redo是否为空
+     */
+    _redoListNotEmpty() {
+        return !!this.redoList.length;
+    }
+    undo() {
+        const ut = this.undoList[this.undoList.length - 1];
+        if (!ut)
+            return false;
+        if (ut.isTransactionLike(TransactionGroup)) {
+            if (ut._undoListNotEmpty()) {
+                return ut.undo();
+            }
+            return false;
+        }
+        else if (ut.isTransactionLike(Transaction)) {
+            if (!ut.canUndo)
+                return false;
+            ut.reverseAndExecute();
+            this.undoList.pop();
+            this.redoList.push(ut);
+            return true;
+        }
+        return false;
+    }
+    redo() {
+        const ut = this.redoList[this.redoList.length - 1];
+        if (!ut)
+            return false;
+        if (ut.isTransactionLike(TransactionGroup)) {
+            if (ut._redoListNotEmpty()) {
+                return ut.redo();
+            }
+            return false;
+        }
+        else if (ut.isTransactionLike(Transaction)) {
+            ut.reverseAndExecute();
+            this.redoList.pop();
+            this.undoList.push(ut);
+            return true;
+        }
+        return false;
+    }
+    clearRedoList() {
+        this.redoList.splice(0);
+    }
+    popTransaction(t) {
+        DebugUtil.assert(this.undoList.pop() === t, '只能pop栈顶事务', 'wg', '2026-03-05');
+        return true;
+    }
+    getCurrentTransaction() {
+        const t = this.undoList[this.undoList.length - 1];
+        if (t && t.isTransactionLike(Transaction) && t.getStatus() === EN_TransactionStatus.STARTED)
+            return t;
+        return undefined;
+    }
+    getCurrentTransactionGroup() {
+        const t = this.undoList.slice(0)
+            .reverse()
+            .find((i) => i.isTransactionLike(TransactionGroup) && i.getStatus() === EN_TransactionStatus.STARTED);
+        if (t && t.isTransactionLike(TransactionGroup)) {
+            return t.getCurrentTransactionGroup();
+        }
+        if (this.getStatus() === EN_TransactionStatus.STARTED) {
+            return this;
+        }
+        return undefined;
+    }
+    getLastLeafTransGroup(undoList) {
+        let t;
+        if (this.undoList[this.undoList.length - 1]) {
+            t = this.undoList[this.undoList.length - 1];
+        }
+        else {
+            const list = undoList ? this.undoList : this.redoList;
+            t = list[list.length - 1];
+        }
+        if (!t)
+            return this;
+        if (t.isTransactionLike(Transaction)) {
+            return t.parent;
+        }
+        if (t.isTransactionLike(TransactionGroup)) {
+            return t.getLastLeafTransGroup(undoList);
+        }
+    }
+    setMaxUndoStackSize(size) {
+        this._maxUndoStackSize = size;
+    }
+    getMaxUndoStackSize() {
+        return this._maxUndoStackSize || this.parent?.getMaxUndoStackSize() || 30;
+    }
+    collectUsedIds(set) {
+        this.undoList.concat(this.redoList).forEach(t => t.collectUsedIds(set));
+    }
+}

package/dist/transaction/transaction_mgr.d.ts

@@ -0,0 +1,54 @@
+import { IDocument } from '../document/i_document';
+import { ITransaction } from './i_transaction';
+import { ITransactionGroup } from './i_transaction_group';
+import { UndoRedoEntity } from './undo_redo_entity';
+/**
+ * 事务管理器
+ */
+export declare class TransactionMgr {
+    /**事务树的根节点*/
+    private _rootNode;
+    init(doc: IDocument): void;
+    /**
+     * 清空事务树
+     */
+    clear(): void;
+    /**
+     * 设置最大回撤步数
+     */
+    setMaxUndoStackSize(size: number): void;
+    /**
+     * 获取当前正在进行的事务
+     */
+    getCurrentTransaction(): ITransaction | undefined;
+    /**
+     * 获取当前事务组
+     */
+    getCurrentTransactionGroup(): ITransactionGroup | undefined;
+    /**
+     * 获取最后的叶子节点事务组
+     */
+    getLastLeafTranGroup(undoList: boolean): ITransactionGroup | undefined;
+    /**
+     * 获取当前正在进行的事务的undoRedoEntity
+     */
+    getCurrentUndoRedoEntity(): UndoRedoEntity;
+    /**
+     * 撤销
+     */
+    undo(): boolean;
+    /**
+     * 回退
+     */
+    redo(): boolean;
+    /**
+     * 是否可撤销
+     */
+    canUndo(): boolean;
+    /**
+     * 是否可回退
+     */
+    canRedo(): boolean;
+    idPoolGC(): Set<number>;
+}
+//# sourceMappingURL=transaction_mgr.d.ts.map

package/dist/transaction/transaction_mgr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction_mgr.d.ts","sourceRoot":"","sources":["../../src/transaction/transaction_mgr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;GAEG;AACH,qBAAa,cAAc;IACvB,YAAY;IACZ,OAAO,CAAC,SAAS,CAAqB;IAE/B,IAAI,CAAC,GAAG,EAAE,SAAS;IAK1B;;OAEG;IACI,KAAK;IAKZ;;OAEG;IACI,mBAAmB,CAAC,IAAI,EAAE,MAAM;IAIvC;;OAEG;IACI,qBAAqB,IAAI,YAAY,GAAG,SAAS;IAMxD;;OAEG;IACI,0BAA0B,IAAI,iBAAiB,GAAG,SAAS;IAIlE;;OAEG;IACI,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS;IAI7E;;OAEG;IACI,wBAAwB,IAAI,cAAc;IAMjD;;OAEG;IACI,IAAI;IAKX;;OAEG;IACI,IAAI;IAKX;;OAEG;IACI,OAAO;IAId;;OAEG;IACI,OAAO;IAIP,QAAQ,IAAI,GAAG,CAAC,MAAM,CAAC;CAKjC"}

package/dist/transaction/transaction_mgr.js

@@ -0,0 +1,84 @@
+import { DebugUtil } from '../toolkit/debug_util';
+import { TransactionGroup } from './transaction_group';
+/**
+ * 事务管理器
+ */
+export class TransactionMgr {
+    init(doc) {
+        this._rootNode = new TransactionGroup(doc, 'root', true);
+        this.setMaxUndoStackSize(50);
+    }
+    /**
+     * 清空事务树
+     */
+    clear() {
+        this._rootNode.undoList.splice(0);
+        this._rootNode.clearRedoList();
+    }
+    /**
+     * 设置最大回撤步数
+     */
+    setMaxUndoStackSize(size) {
+        this._rootNode.setMaxUndoStackSize(size);
+    }
+    /**
+     * 获取当前正在进行的事务
+     */
+    getCurrentTransaction() {
+        const group = this._rootNode.getCurrentTransactionGroup();
+        if (!group)
+            return undefined;
+        return group.getCurrentTransaction();
+    }
+    /**
+     * 获取当前事务组
+     */
+    getCurrentTransactionGroup() {
+        return this._rootNode.getCurrentTransactionGroup();
+    }
+    /**
+     * 获取最后的叶子节点事务组
+     */
+    getLastLeafTranGroup(undoList) {
+        return this._rootNode.getLastLeafTransGroup(undoList);
+    }
+    /**
+     * 获取当前正在进行的事务的undoRedoEntity
+     */
+    getCurrentUndoRedoEntity() {
+        const transaction = this.getCurrentTransaction();
+        DebugUtil.assert(transaction, '没有事务', 'wg', '2025-11-18');
+        return transaction.undoRedoEntity;
+    }
+    /**
+     * 撤销
+     */
+    undo() {
+        const result = !!this.getLastLeafTranGroup(true)?.undo();
+        return result;
+    }
+    /**
+     * 回退
+     */
+    redo() {
+        const result = !!this.getLastLeafTranGroup(false)?.redo();
+        return result;
+    }
+    /**
+     * 是否可撤销
+     */
+    canUndo() {
+        return !!this.getLastLeafTranGroup(true)?.canUndo();
+    }
+    /**
+     * 是否可回退
+     */
+    canRedo() {
+        return !!this.getLastLeafTranGroup(false)?.canRedo();
+    }
+    idPoolGC() {
+        const set = new Set();
+        this._rootNode.collectUsedIds(set);
+        return set;
+    }
+}

package/dist/transaction/undo_redo_entity.d.ts

@@ -0,0 +1,71 @@
+import { IDocument } from '../document/i_document';
+import { IElement } from '../element/i_element';
+/**
+ * 记录一次undo/redo的Element变化
+ */
+export declare class UndoRedoEntity {
+    private _doc;
+    /**增加的元素*/
+    private readonly _added;
+    /**删除的元素*/
+    private readonly _deleted;
+    /**修改的元素*/
+    private readonly _modified;
+    /**修改的元素-属性集合映射*/
+    private readonly _modifiedProperties;
+    constructor(doc: IDocument);
+    /**监听元素增加*/
+    onElementsAdded(eles: IElement[]): void;
+    /**监听元素更新*/
+    onElementsUpdated(eles: IElement[]): void;
+    /**监听元素删除*/
+    onElementsDeleted(eles: IElement[]): void;
+    clear(): void;
+    /**
+     * 真正去改变db
+     */
+    commit(): boolean;
+    /**
+     * 数据回滚
+     */
+    rollBack(): boolean;
+    /**
+     * undo变redo,redo变undo
+     */
+    reverseAndExecute(): void;
+    /**
+     * 合并其它提交
+     */
+    merge(other: UndoRedoEntity): void;
+    /**
+     * 将操作reverse
+     */
+    private _reverse;
+    /**
+     * 正向执行
+     */
+    _execute(): void;
+    /**
+     * 压缩事务
+     * 主要处理例如，新增一个Element,然后更改这个Element的属性,事务管理器会记录每一个操作，这时只需要记录增加的操作即可
+     */
+    private _compress;
+    /**是否为空*/
+    _isEmpty(): boolean;
+    /**
+     * 从容器中增删对象
+     * @param del 是否删除
+     * @param eles 对象数组
+     */
+    private _handleElementsFromDB;
+    /**
+     * 收集使用过的id
+     */
+    collectUsedIds(set: Set<number>): void;
+    /**
+     * 获取所有修改的ElementId集合
+     */
+    getModifiedElementIds(): Set<number>;
+    private _updateViewCache;
+}
+//# sourceMappingURL=undo_redo_entity.d.ts.map

package/dist/transaction/undo_redo_entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo_redo_entity.d.ts","sourceRoot":"","sources":["../../src/transaction/undo_redo_entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAkB,MAAM,sBAAsB,CAAC;AAGhE;;GAEG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,IAAI,CAAY;IAExB,UAAU;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAE9C,UAAU;IACV,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAEhD,UAAU;IACV,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IAEjD,iBAAiB;IACjB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA4C;gBAEpE,GAAG,EAAE,SAAS;IAI1B,WAAW;IACJ,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE;IAIvC,WAAW;IACJ,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE;IAIzC,WAAW;IACJ,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE;IAIlC,KAAK;IAOZ;;OAEG;IACI,MAAM;IAsBb;;OAEG;IACI,QAAQ;IAaf;;OAEG;IACI,iBAAiB;IAKxB;;OAEG;IACI,KAAK,CAAC,KAAK,EAAE,cAAc;IAsElC;;OAEG;IACH,OAAO,CAAC,QAAQ;IAmBhB;;OAEG;IACI,QAAQ;IAiBf;;;OAGG;IACH,OAAO,CAAC,SAAS;IA0BjB,SAAS;IACF,QAAQ;IAIf;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;OAEG;IACI,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC;IAKtC;;OAEG;IACI,qBAAqB;IAQ5B,OAAO,CAAC,gBAAgB;CAiB3B"}