@mlightcad/data-model 1.9.10 → 1.9.12

package/lib/database/transaction/AcDbChangeApplier.d.ts

@@ -0,0 +1,118 @@
+import { AcDbObject } from '../../base';
+import { AcDbEntity } from '../../entity/AcDbEntity';
+import { AcDbDatabase } from '../AcDbDatabase';
+import { AcDbDatabaseChange } from './AcDbDatabaseChange';
+/**
+ * Applies forward or inverse database changes for undo/redo operations.
+ *
+ * Structural changes (append/remove) and property snapshots (modify/sysvar)
+ * are replayed against a live {@link AcDbDatabase} instance.
+ */
+export declare class AcDbChangeApplier {
+    private readonly database;
+    /**
+     * Creates an applier bound to one database.
+     *
+     * @param database - Database whose containers and objects receive replayed changes
+     */
+    constructor(database: AcDbDatabase);
+    /**
+     * Replays changes in commit order.
+     *
+     * Used by redo and by applying the forward direction of an undo record.
+     *
+     * @param changes - Ordered list of changes recorded by {@link AcDbChangeRecorder}
+     */
+    applyForward(changes: AcDbDatabaseChange[]): void;
+    /**
+     * Replays the inverse of each change in reverse order.
+     *
+     * Used by undo and transaction abort to restore the prior database state.
+     *
+     * @param changes - Ordered list of changes recorded by {@link AcDbChangeRecorder}
+     */
+    applyInverse(changes: AcDbDatabaseChange[]): void;
+    /**
+     * Dispatches one recorded change in the requested direction.
+     *
+     * @param change - Single entry from a transaction or undo record
+     * @param forward - When true, replay the original mutation; when false, apply its inverse
+     */
+    private applyChange;
+    /**
+     * Restores object property state from a modify snapshot.
+     *
+     * @param change - Modify entry with before/after clones
+     * @param forward - When true, apply `after`; when false, apply `before`
+     */
+    private applyModify;
+    /**
+     * Restores a system variable from a sysvar snapshot.
+     *
+     * @param change - Sysvar entry with before/after values
+     * @param forward - When true, apply `after`; when false, apply `before`
+     */
+    private applySysvar;
+    /**
+     * Re-inserts an object into the container described by `container`.
+     *
+     * @param container - Target block table record, symbol table, or dictionary entry
+     * @param object - Object snapshot to append
+     */
+    private applyAppend;
+    /**
+     * Removes an object from the container described by `container`.
+     *
+     * @param container - Source block table record, symbol table, or dictionary entry
+     * @param object - Object whose {@link AcDbObject.objectId} identifies the removal target
+     */
+    private applyRemove;
+    /**
+     * Resolves a symbol table instance from the stable name stored in undo records.
+     *
+     * @param tableName - Logical table name (for example, `"layerTable"`) or unknown fallback ID
+     * @returns Matching table on this applier's database, or undefined when unrecognized
+     */
+    private getSymbolTable;
+}
+/**
+ * Collects entities affected by changes for post-commit/undo/redo event dispatch.
+ *
+ * Only block-table-record append/remove operations contribute to the
+ * appended and erased lists; modify entries always resolve through object IDs.
+ *
+ * @param database - Database used to resolve live entity references
+ * @param changes - Changes produced by a transaction or undo record
+ * @returns Entity buckets keyed by the kind of structural or property change
+ */
+export declare function collectChangeEntities(database: AcDbDatabase, changes: AcDbDatabaseChange[]): {
+    /** Entities whose properties were modified */
+    modified: AcDbEntity[];
+    /** Entities appended to a block table record */
+    appended: AcDbEntity[];
+    /** Entities removed from a block table record */
+    erased: AcDbEntity[];
+};
+/**
+ * One dictionary entry referenced by an append or remove change.
+ */
+export interface AcDbDictionaryChangeEntry {
+    /** Dictionary object that was set or erased */
+    object: AcDbObject;
+    /** Dictionary key associated with the object */
+    key: string;
+}
+/**
+ * Collects dictionary entries affected by changes for post-commit/undo/redo dispatch.
+ *
+ * @param database - Database used to resolve live object references after replay
+ * @param changes - Changes produced by a transaction or undo record
+ * @returns Dictionary entries grouped by set and erase operations
+ */
+export declare function collectDictionaryChanges(database: AcDbDatabase, changes: AcDbDatabaseChange[]): {
+    /** Entries inserted or replaced in a dictionary */
+    set: AcDbDictionaryChangeEntry[];
+    /** Entries removed from a dictionary */
+    erased: AcDbDictionaryChangeEntry[];
+};
+//# sourceMappingURL=AcDbChangeApplier.d.ts.map

package/lib/database/transaction/AcDbChangeApplier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcDbChangeApplier.d.ts","sourceRoot":"","sources":["../../../src/database/transaction/AcDbChangeApplier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAI9C,OAAO,EAAuB,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9E;;;;;GAKG;AACH,qBAAa,iBAAiB;IAMhB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IALrC;;;;OAIG;gBAC0B,QAAQ,EAAE,YAAY;IAEnD;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAMjD;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAMjD;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAyBnB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAenB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAenB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IA4BnB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IA4BnB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;CAuBvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,kBAAkB,EAAE,GAC5B;IACD,8CAA8C;IAC9C,QAAQ,EAAE,UAAU,EAAE,CAAA;IACtB,gDAAgD;IAChD,QAAQ,EAAE,UAAU,EAAE,CAAA;IACtB,iDAAiD;IACjD,MAAM,EAAE,UAAU,EAAE,CAAA;CACrB,CA8BA;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,+CAA+C;IAC/C,MAAM,EAAE,UAAU,CAAA;IAClB,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,kBAAkB,EAAE,GAC5B;IACD,mDAAmD;IACnD,GAAG,EAAE,yBAAyB,EAAE,CAAA;IAChC,wCAAwC;IACxC,MAAM,EAAE,yBAAyB,EAAE,CAAA;CACpC,CAuBA"}

package/lib/database/transaction/AcDbChangeApplier.js

@@ -0,0 +1,310 @@
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+import { AcDbEntity } from '../../entity/AcDbEntity';
+import { AcDbSysVarManager } from '../AcDbSysVarManager';
+/**
+ * Applies forward or inverse database changes for undo/redo operations.
+ *
+ * Structural changes (append/remove) and property snapshots (modify/sysvar)
+ * are replayed against a live {@link AcDbDatabase} instance.
+ */
+var AcDbChangeApplier = /** @class */ (function () {
+    /**
+     * Creates an applier bound to one database.
+     *
+     * @param database - Database whose containers and objects receive replayed changes
+     */
+    function AcDbChangeApplier(database) {
+        this.database = database;
+    }
+    /**
+     * Replays changes in commit order.
+     *
+     * Used by redo and by applying the forward direction of an undo record.
+     *
+     * @param changes - Ordered list of changes recorded by {@link AcDbChangeRecorder}
+     */
+    AcDbChangeApplier.prototype.applyForward = function (changes) {
+        var e_1, _a;
+        try {
+            for (var changes_1 = __values(changes), changes_1_1 = changes_1.next(); !changes_1_1.done; changes_1_1 = changes_1.next()) {
+                var change = changes_1_1.value;
+                this.applyChange(change, true);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (changes_1_1 && !changes_1_1.done && (_a = changes_1.return)) _a.call(changes_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+    };
+    /**
+     * Replays the inverse of each change in reverse order.
+     *
+     * Used by undo and transaction abort to restore the prior database state.
+     *
+     * @param changes - Ordered list of changes recorded by {@link AcDbChangeRecorder}
+     */
+    AcDbChangeApplier.prototype.applyInverse = function (changes) {
+        for (var i = changes.length - 1; i >= 0; i--) {
+            this.applyChange(changes[i], false);
+        }
+    };
+    /**
+     * Dispatches one recorded change in the requested direction.
+     *
+     * @param change - Single entry from a transaction or undo record
+     * @param forward - When true, replay the original mutation; when false, apply its inverse
+     */
+    AcDbChangeApplier.prototype.applyChange = function (change, forward) {
+        switch (change.kind) {
+            case 'modify':
+                this.applyModify(change, forward);
+                break;
+            case 'append':
+                if (forward) {
+                    this.applyAppend(change.container, change.object);
+                }
+                else {
+                    this.applyRemove(change.container, change.object);
+                }
+                break;
+            case 'remove':
+                if (forward) {
+                    this.applyRemove(change.container, change.object);
+                }
+                else {
+                    this.applyAppend(change.container, change.object);
+                }
+                break;
+            case 'sysvar':
+                this.applySysvar(change, forward);
+                break;
+        }
+    };
+    /**
+     * Restores object property state from a modify snapshot.
+     *
+     * @param change - Modify entry with before/after clones
+     * @param forward - When true, apply `after`; when false, apply `before`
+     */
+    AcDbChangeApplier.prototype.applyModify = function (change, forward) {
+        var object = this.database.getObjectById(change.objectId);
+        if (!object) {
+            return;
+        }
+        var snapshot = forward ? change.after : change.before;
+        if (snapshot) {
+            object.restoreFrom(snapshot);
+        }
+    };
+    /**
+     * Restores a system variable from a sysvar snapshot.
+     *
+     * @param change - Sysvar entry with before/after values
+     * @param forward - When true, apply `after`; when false, apply `before`
+     */
+    AcDbChangeApplier.prototype.applySysvar = function (change, forward) {
+        var value = forward ? change.after : change.before;
+        if (value === undefined) {
+            return;
+        }
+        AcDbSysVarManager.instance().setVar(change.name, value, this.database);
+    };
+    /**
+     * Re-inserts an object into the container described by `container`.
+     *
+     * @param container - Target block table record, symbol table, or dictionary entry
+     * @param object - Object snapshot to append
+     */
+    AcDbChangeApplier.prototype.applyAppend = function (container, object) {
+        switch (container.type) {
+            case 'blockTableRecord': {
+                var btr = this.database.tables.blockTable.getIdAt(container.ownerId);
+                if (btr) {
+                    btr.appendEntity(object);
+                }
+                break;
+            }
+            case 'symbolTable': {
+                var table = this.getSymbolTable(container.tableName);
+                if (table) {
+                    table.add(object);
+                }
+                break;
+            }
+            case 'dictionary': {
+                var dictionary = this.database.getObjectById(container.dictionaryId);
+                if (dictionary) {
+                    dictionary.setAt(container.key, object);
+                }
+                break;
+            }
+        }
+    };
+    /**
+     * Removes an object from the container described by `container`.
+     *
+     * @param container - Source block table record, symbol table, or dictionary entry
+     * @param object - Object whose {@link AcDbObject.objectId} identifies the removal target
+     */
+    AcDbChangeApplier.prototype.applyRemove = function (container, object) {
+        switch (container.type) {
+            case 'blockTableRecord': {
+                var btr = this.database.tables.blockTable.getIdAt(container.ownerId);
+                if (btr) {
+                    btr.removeEntity(object.objectId);
+                }
+                break;
+            }
+            case 'symbolTable': {
+                var table = this.getSymbolTable(container.tableName);
+                if (table) {
+                    table.removeId(object.objectId);
+                }
+                break;
+            }
+            case 'dictionary': {
+                var dictionary = this.database.getObjectById(container.dictionaryId);
+                if (dictionary) {
+                    dictionary.removeId(object.objectId);
+                }
+                break;
+            }
+        }
+    };
+    /**
+     * Resolves a symbol table instance from the stable name stored in undo records.
+     *
+     * @param tableName - Logical table name (for example, `"layerTable"`) or unknown fallback ID
+     * @returns Matching table on this applier's database, or undefined when unrecognized
+     */
+    AcDbChangeApplier.prototype.getSymbolTable = function (tableName) {
+        var tables = this.database.tables;
+        switch (tableName) {
+            case 'appIdTable':
+                return tables.appIdTable;
+            case 'blockTable':
+                return tables.blockTable;
+            case 'dimStyleTable':
+                return tables.dimStyleTable;
+            case 'linetypeTable':
+                return tables.linetypeTable;
+            case 'textStyleTable':
+                return tables.textStyleTable;
+            case 'viewTable':
+                return tables.viewTable;
+            case 'layerTable':
+                return tables.layerTable;
+            case 'viewportTable':
+                return tables.viewportTable;
+            default:
+                return undefined;
+        }
+    };
+    return AcDbChangeApplier;
+}());
+export { AcDbChangeApplier };
+/**
+ * Collects entities affected by changes for post-commit/undo/redo event dispatch.
+ *
+ * Only block-table-record append/remove operations contribute to the
+ * appended and erased lists; modify entries always resolve through object IDs.
+ *
+ * @param database - Database used to resolve live entity references
+ * @param changes - Changes produced by a transaction or undo record
+ * @returns Entity buckets keyed by the kind of structural or property change
+ */
+export function collectChangeEntities(database, changes) {
+    var e_2, _a;
+    var _b;
+    var modified = [];
+    var appended = [];
+    var erased = [];
+    try {
+        for (var changes_2 = __values(changes), changes_2_1 = changes_2.next(); !changes_2_1.done; changes_2_1 = changes_2.next()) {
+            var change = changes_2_1.value;
+            if (change.kind === 'modify') {
+                var object = database.getObjectById(change.objectId);
+                if (object instanceof AcDbEntity) {
+                    modified.push(object);
+                }
+            }
+            else if (change.kind === 'append') {
+                if (change.container.type === 'blockTableRecord') {
+                    var entity = (_b = database.tables.blockTable.getEntityById(change.object.objectId)) !== null && _b !== void 0 ? _b : (change.object instanceof AcDbEntity ? change.object : undefined);
+                    if (entity) {
+                        appended.push(entity);
+                    }
+                }
+            }
+            else if (change.kind === 'remove') {
+                if (change.container.type === 'blockTableRecord') {
+                    if (change.object instanceof AcDbEntity) {
+                        erased.push(change.object);
+                    }
+                }
+            }
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (changes_2_1 && !changes_2_1.done && (_a = changes_2.return)) _a.call(changes_2);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    return { modified: modified, appended: appended, erased: erased };
+}
+/**
+ * Collects dictionary entries affected by changes for post-commit/undo/redo dispatch.
+ *
+ * @param database - Database used to resolve live object references after replay
+ * @param changes - Changes produced by a transaction or undo record
+ * @returns Dictionary entries grouped by set and erase operations
+ */
+export function collectDictionaryChanges(database, changes) {
+    var e_3, _a;
+    var _b;
+    var set = [];
+    var erased = [];
+    try {
+        for (var changes_3 = __values(changes), changes_3_1 = changes_3.next(); !changes_3_1.done; changes_3_1 = changes_3.next()) {
+            var change = changes_3_1.value;
+            if (change.kind !== 'append' && change.kind !== 'remove') {
+                continue;
+            }
+            if (change.container.type !== 'dictionary') {
+                continue;
+            }
+            var key = change.container.key;
+            if (change.kind === 'append') {
+                var object = (_b = database.getObjectById(change.object.objectId)) !== null && _b !== void 0 ? _b : change.object;
+                set.push({ object: object, key: key });
+            }
+            else if (change.kind === 'remove') {
+                erased.push({ object: change.object, key: key });
+            }
+        }
+    }
+    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+    finally {
+        try {
+            if (changes_3_1 && !changes_3_1.done && (_a = changes_3.return)) _a.call(changes_3);
+        }
+        finally { if (e_3) throw e_3.error; }
+    }
+    return { set: set, erased: erased };
+}
+//# sourceMappingURL=AcDbChangeApplier.js.map

package/lib/database/transaction/AcDbChangeApplier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcDbChangeApplier.js","sourceRoot":"","sources":["../../../src/database/transaction/AcDbChangeApplier.ts"],"names":[],"mappings":"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"}

package/lib/database/transaction/AcDbChangeRecorder.d.ts

@@ -0,0 +1,113 @@
+import { AcDbObject } from '../../base';
+import { AcDbDatabase } from '../AcDbDatabase';
+import { AcDbChangeContainer, AcDbDatabaseChange } from './AcDbDatabaseChange';
+/**
+ * Accumulates structured database changes during an active transaction.
+ *
+ * Append/remove pairs that cancel within the same transaction are coalesced,
+ * and duplicate modify/sysvar entries for the same target are ignored.
+ */
+export declare class AcDbChangeRecorder {
+    private readonly changes;
+    /**
+     * Returns the changes recorded so far in this transaction.
+     *
+     * The returned array is the internal store; callers should treat it as read-only.
+     */
+    getChanges(): AcDbDatabaseChange[];
+    /**
+     * Discards all recorded changes without applying them.
+     */
+    clear(): void;
+    /**
+     * Merges changes from a nested transaction into this recorder.
+     *
+     * Used when an inner transaction commits into its parent without touching
+     * the undo stack.
+     *
+     * @param other - Recorder from a child transaction being committed
+     */
+    mergeFrom(other: AcDbChangeRecorder): void;
+    /**
+     * Records the pre-modification snapshot of an opened-for-write object.
+     *
+     * Only the first modify entry per {@link AcDbObject.objectId} is kept.
+     *
+     * @param object - Object whose state should be restorable on abort/undo
+     */
+    recordModify(object: AcDbObject): void;
+    /**
+     * Records insertion of an object into a database container.
+     *
+     * If a matching remove was recorded earlier in the same transaction,
+     * the pair cancels and neither change is retained.
+     *
+     * @param container - Container that received the object
+     * @param object - Object that was appended; stored as an identity-preserving clone
+     */
+    recordAppend(container: AcDbChangeContainer, object: AcDbObject): void;
+    /**
+     * Records removal of an object from a database container.
+     *
+     * If a matching append was recorded earlier in the same transaction,
+     * the pair cancels and neither change is retained.
+     *
+     * @param container - Container that owned the removed object
+     * @param object - Object that was removed; stored as an identity-preserving clone
+     */
+    recordRemove(container: AcDbChangeContainer, object: AcDbObject): void;
+    /**
+     * Records the value of a system variable before mutation.
+     *
+     * Only the first sysvar entry per normalized name is kept.
+     *
+     * @param name - System variable name (case-insensitive)
+     * @param before - Value observed before the mutation
+     */
+    recordSysvar(name: string, before: unknown): void;
+    /**
+     * Captures the post-change state for modify and sysvar entries at commit time.
+     *
+     * Append/remove entries are complete when recorded and do not require
+     * finalization.
+     *
+     * @param database - Database used to read live post-commit values
+     */
+    finalize(database: AcDbDatabase): void;
+    /**
+     * Records or coalesces one append/remove change.
+     *
+     * When an opposite structural change for the same container and object ID
+     * already exists in this transaction, both entries cancel and neither is kept.
+     *
+     * @param change - Append or remove entry to merge into the recorder
+     */
+    private recordStructuralChange;
+    /**
+     * Merges one change from a nested transaction into this recorder.
+     *
+     * Modify and sysvar entries deduplicate by object ID or variable name;
+     * structural entries use the same cancel/coalesce rules as {@link recordAppend}.
+     *
+     * @param change - Change copied from a child transaction recorder
+     */
+    private mergeChange;
+    /**
+     * Finds the index of a structural change matching kind, container, and object ID.
+     *
+     * @param kind - Append or remove kind to search for
+     * @param container - Container descriptor that must match exactly
+     * @param objectId - Object identifier of the affected record
+     * @returns Index in {@link changes}, or `-1` when no match exists
+     */
+    private findStructuralChangeIndex;
+    /**
+     * Reads the current value of a system variable from the database.
+     *
+     * @param database - Database passed to {@link AcDbSysVarManager.getVar}
+     * @param name - Normalized system variable name
+     * @returns Live variable value used to populate `after` during {@link finalize}
+     */
+    private getSysvarValue;
+}
+//# sourceMappingURL=AcDbChangeRecorder.d.ts.map

package/lib/database/transaction/AcDbChangeRecorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcDbChangeRecorder.d.ts","sourceRoot":"","sources":["../../../src/database/transaction/AcDbChangeRecorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAEnB,MAAM,sBAAsB,CAAA;AAE7B;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IAEnD;;;;OAIG;IACH,UAAU,IAAI,kBAAkB,EAAE;IAIlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;;OAOG;IACH,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAM1C;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAetC;;;;;;;;OAQG;IACH,YAAY,CAAC,SAAS,EAAE,mBAAmB,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAQtE;;;;;;;;OAQG;IACH,YAAY,CAAC,SAAS,EAAE,mBAAmB,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAQtE;;;;;;;OAOG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAejD;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAatC;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IAiB9B;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;IAwBnB;;;;;;;OAOG;IACH,OAAO,CAAC,yBAAyB;IAajC;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;CAGvB"}