@mlightcad/data-model 1.9.9 → 1.9.11

package/lib/database/transaction/AcDbChangeRecorder.js

@@ -0,0 +1,235 @@
+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 { AcDbSysVarManager } from '../AcDbSysVarManager';
+import { areChangeContainersEqual } 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.
+ */
+var AcDbChangeRecorder = /** @class */ (function () {
+    function AcDbChangeRecorder() {
+        this.changes = [];
+    }
+    /**
+     * Returns the changes recorded so far in this transaction.
+     *
+     * The returned array is the internal store; callers should treat it as read-only.
+     */
+    AcDbChangeRecorder.prototype.getChanges = function () {
+        return this.changes;
+    };
+    /**
+     * Discards all recorded changes without applying them.
+     */
+    AcDbChangeRecorder.prototype.clear = function () {
+        this.changes.length = 0;
+    };
+    /**
+     * 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
+     */
+    AcDbChangeRecorder.prototype.mergeFrom = function (other) {
+        var e_1, _a;
+        try {
+            for (var _b = __values(other.getChanges()), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var change = _c.value;
+                this.mergeChange(change);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+    };
+    /**
+     * 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
+     */
+    AcDbChangeRecorder.prototype.recordModify = function (object) {
+        var objectId = object.objectId;
+        var existing = this.changes.find(function (c) { return c.kind === 'modify' && c.objectId === objectId; });
+        if (existing) {
+            return;
+        }
+        this.changes.push({
+            kind: 'modify',
+            objectId: objectId,
+            before: object.clonePreservingIdentity()
+        });
+    };
+    /**
+     * 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
+     */
+    AcDbChangeRecorder.prototype.recordAppend = function (container, object) {
+        this.recordStructuralChange({
+            kind: 'append',
+            container: container,
+            object: object.clonePreservingIdentity()
+        });
+    };
+    /**
+     * 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
+     */
+    AcDbChangeRecorder.prototype.recordRemove = function (container, object) {
+        this.recordStructuralChange({
+            kind: 'remove',
+            container: container,
+            object: object.clonePreservingIdentity()
+        });
+    };
+    /**
+     * 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
+     */
+    AcDbChangeRecorder.prototype.recordSysvar = function (name, before) {
+        var normalizedName = name.toLowerCase();
+        var existing = this.changes.find(function (c) { return c.kind === 'sysvar' && c.name === normalizedName; });
+        if (existing) {
+            return;
+        }
+        this.changes.push({
+            kind: 'sysvar',
+            name: normalizedName,
+            before: before
+        });
+    };
+    /**
+     * 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
+     */
+    AcDbChangeRecorder.prototype.finalize = function (database) {
+        var e_2, _a;
+        try {
+            for (var _b = __values(this.changes), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var change = _c.value;
+                if (change.kind === 'modify') {
+                    var object = database.getObjectById(change.objectId);
+                    if (object) {
+                        change.after = object.clonePreservingIdentity();
+                    }
+                }
+                else if (change.kind === 'sysvar') {
+                    change.after = this.getSysvarValue(database, change.name);
+                }
+            }
+        }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+        finally {
+            try {
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            }
+            finally { if (e_2) throw e_2.error; }
+        }
+    };
+    /**
+     * 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
+     */
+    AcDbChangeRecorder.prototype.recordStructuralChange = function (change) {
+        var oppositeKind = change.kind === 'append' ? 'remove' : 'append';
+        var cancelIndex = this.findStructuralChangeIndex(oppositeKind, change.container, change.object.objectId);
+        if (cancelIndex >= 0) {
+            this.changes.splice(cancelIndex, 1);
+            return;
+        }
+        this.changes.push(change);
+    };
+    /**
+     * 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
+     */
+    AcDbChangeRecorder.prototype.mergeChange = function (change) {
+        if (change.kind === 'modify') {
+            var existing = this.changes.find(function (c) { return c.kind === 'modify' && c.objectId === change.objectId; });
+            if (!existing) {
+                this.changes.push(change);
+            }
+            return;
+        }
+        if (change.kind === 'sysvar') {
+            var existing = this.changes.find(function (c) { return c.kind === 'sysvar' && c.name === change.name; });
+            if (!existing) {
+                this.changes.push(change);
+            }
+            return;
+        }
+        this.recordStructuralChange(change);
+    };
+    /**
+     * 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
+     */
+    AcDbChangeRecorder.prototype.findStructuralChangeIndex = function (kind, container, objectId) {
+        return this.changes.findIndex(function (change) {
+            return change.kind === kind &&
+                change.object.objectId === objectId &&
+                areChangeContainersEqual(change.container, container);
+        });
+    };
+    /**
+     * 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}
+     */
+    AcDbChangeRecorder.prototype.getSysvarValue = function (database, name) {
+        return AcDbSysVarManager.instance().getVar(name, database);
+    };
+    return AcDbChangeRecorder;
+}());
+export { AcDbChangeRecorder };
+//# sourceMappingURL=AcDbChangeRecorder.js.map

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

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

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

@@ -0,0 +1,67 @@
+import { AcDbObject } from '../../base';
+/**
+ * Identifies the container that holds a database object for undo/redo recording.
+ *
+ * - `blockTableRecord` — entity membership in a block table record
+ * - `symbolTable` — symbol table record membership
+ * - `dictionary` — named entry in an {@link AcDbDictionary}
+ */
+export type AcDbChangeContainer = {
+    type: 'blockTableRecord';
+    ownerId: string;
+} | {
+    type: 'symbolTable';
+    tableName: string;
+} | {
+    type: 'dictionary';
+    dictionaryId: string;
+    key: string;
+};
+/**
+ * A single recorded change within a transaction or undo record.
+ *
+ * Each variant stores enough information for {@link AcDbChangeApplier} to
+ * replay the change forward or in reverse.
+ */
+export type AcDbDatabaseChange = {
+    /** Property snapshot change for one database-resident object */
+    kind: 'modify';
+    /** Object whose properties changed */
+    objectId: string;
+    /** State before the transaction or undoable operation */
+    before: AcDbObject;
+    /** State after commit; populated by {@link AcDbChangeRecorder.finalize} */
+    after?: AcDbObject;
+} | {
+    /** Object inserted into a container */
+    kind: 'append';
+    /** Container that received the object */
+    container: AcDbChangeContainer;
+    /** Appended object snapshot */
+    object: AcDbObject;
+} | {
+    /** Object removed from a container */
+    kind: 'remove';
+    /** Container that owned the object */
+    container: AcDbChangeContainer;
+    /** Removed object snapshot */
+    object: AcDbObject;
+} | {
+    /** System variable value change */
+    kind: 'sysvar';
+    /** Normalized system variable name */
+    name: string;
+    /** Value before the mutation */
+    before: unknown;
+    /** Value after commit; populated by {@link AcDbChangeRecorder.finalize} */
+    after?: unknown;
+};
+/**
+ * Returns true when two change containers refer to the same storage location.
+ *
+ * @param a - First container descriptor
+ * @param b - Second container descriptor
+ * @returns True when both descriptors identify the same append/remove target
+ */
+export declare function areChangeContainersEqual(a: AcDbChangeContainer, b: AcDbChangeContainer): boolean;
+//# sourceMappingURL=AcDbDatabaseChange.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcDbDatabaseChange.d.ts","sourceRoot":"","sources":["../../../src/database/transaction/AcDbDatabaseChange.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IACE,gEAAgE;IAChE,IAAI,EAAE,QAAQ,CAAA;IACd,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,yDAAyD;IACzD,MAAM,EAAE,UAAU,CAAA;IAClB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB,GACD;IACE,uCAAuC;IACvC,IAAI,EAAE,QAAQ,CAAA;IACd,yCAAyC;IACzC,SAAS,EAAE,mBAAmB,CAAA;IAC9B,+BAA+B;IAC/B,MAAM,EAAE,UAAU,CAAA;CACnB,GACD;IACE,sCAAsC;IACtC,IAAI,EAAE,QAAQ,CAAA;IACd,sCAAsC;IACtC,SAAS,EAAE,mBAAmB,CAAA;IAC9B,8BAA8B;IAC9B,MAAM,EAAE,UAAU,CAAA;CACnB,GACD;IACE,mCAAmC;IACnC,IAAI,EAAE,QAAQ,CAAA;IACd,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,gCAAgC;IAChC,MAAM,EAAE,OAAO,CAAA;IACf,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAEL;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,CAAC,EAAE,mBAAmB,EACtB,CAAC,EAAE,mBAAmB,GACrB,OAAO,CAiBT"}

package/lib/database/transaction/AcDbDatabaseChange.js

@@ -0,0 +1,23 @@
+/**
+ * Returns true when two change containers refer to the same storage location.
+ *
+ * @param a - First container descriptor
+ * @param b - Second container descriptor
+ * @returns True when both descriptors identify the same append/remove target
+ */
+export function areChangeContainersEqual(a, b) {
+    if (a.type !== b.type) {
+        return false;
+    }
+    switch (a.type) {
+        case 'blockTableRecord':
+            return b.type === 'blockTableRecord' && a.ownerId === b.ownerId;
+        case 'symbolTable':
+            return b.type === 'symbolTable' && a.tableName === b.tableName;
+        case 'dictionary':
+            return (b.type === 'dictionary' &&
+                a.dictionaryId === b.dictionaryId &&
+                a.key === b.key);
+    }
+}
+//# sourceMappingURL=AcDbDatabaseChange.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcDbDatabaseChange.js","sourceRoot":"","sources":["../../../src/database/transaction/AcDbDatabaseChange.ts"],"names":[],"mappings":"AA0DA;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,CAAsB,EACtB,CAAsB;IAEtB,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QACtB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,kBAAkB;YACrB,OAAO,CAAC,CAAC,IAAI,KAAK,kBAAkB,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAA;QACjE,KAAK,aAAa;YAChB,OAAO,CAAC,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,CAAA;QAChE,KAAK,YAAY;YACf,OAAO,CACL,CAAC,CAAC,IAAI,KAAK,YAAY;gBACvB,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,YAAY;gBACjC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAChB,CAAA;IACL,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,26 @@
+import { AcDbObject, AcDbObjectId } from '../../base';
+import { AcDbDatabase } from '../AcDbDatabase';
+import { AcDbTransaction } from './AcDbTransaction';
+/**
+ * Database-bound transaction with object lookup through {@link AcDbDatabase}.
+ *
+ * Created by {@link AcDbDatabaseTransactionManager.startTransaction} and
+ * returned from {@link AcDbDatabaseTransactionManager.runUndoable}.
+ */
+export declare class AcDbDatabaseTransaction extends AcDbTransaction {
+    private readonly database;
+    /**
+     * @param database - Database whose objects are opened and recorded
+     */
+    constructor(database: AcDbDatabase);
+    /**
+     * Resolves an object ID through the owning database.
+     *
+     * @param objectId - Identifier of the object to open
+     * @param openErased - Reserved for erased-object support
+     * @returns The matching live object
+     * @throws Error when the object cannot be found
+     */
+    protected lookupObject<T extends AcDbObject>(objectId: AcDbObjectId, openErased: boolean): T;
+}
+//# sourceMappingURL=AcDbDatabaseTransaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcDbDatabaseTransaction.d.ts","sourceRoot":"","sources":["../../../src/database/transaction/AcDbDatabaseTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEnD;;;;;GAKG;AACH,qBAAa,uBAAwB,SAAQ,eAAe;IAI9C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAHrC;;OAEG;gBAC0B,QAAQ,EAAE,YAAY;IAInD;;;;;;;OAOG;cACgB,YAAY,CAAC,CAAC,SAAS,UAAU,EAClD,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,OAAO,GAClB,CAAC;CAOL"}

package/lib/database/transaction/AcDbDatabaseTransaction.js

@@ -0,0 +1,51 @@
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+import { AcDbTransaction } from './AcDbTransaction';
+/**
+ * Database-bound transaction with object lookup through {@link AcDbDatabase}.
+ *
+ * Created by {@link AcDbDatabaseTransactionManager.startTransaction} and
+ * returned from {@link AcDbDatabaseTransactionManager.runUndoable}.
+ */
+var AcDbDatabaseTransaction = /** @class */ (function (_super) {
+    __extends(AcDbDatabaseTransaction, _super);
+    /**
+     * @param database - Database whose objects are opened and recorded
+     */
+    function AcDbDatabaseTransaction(database) {
+        var _this = _super.call(this) || this;
+        _this.database = database;
+        return _this;
+    }
+    /**
+     * Resolves an object ID through the owning database.
+     *
+     * @param objectId - Identifier of the object to open
+     * @param openErased - Reserved for erased-object support
+     * @returns The matching live object
+     * @throws Error when the object cannot be found
+     */
+    AcDbDatabaseTransaction.prototype.lookupObject = function (objectId, openErased) {
+        var obj = this.database.getObjectById(objectId, openErased);
+        if (!obj) {
+            throw new Error("lookupObject(".concat(objectId, ") not found"));
+        }
+        return obj;
+    };
+    return AcDbDatabaseTransaction;
+}(AcDbTransaction));
+export { AcDbDatabaseTransaction };
+//# sourceMappingURL=AcDbDatabaseTransaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcDbDatabaseTransaction.js","sourceRoot":"","sources":["../../../src/database/transaction/AcDbDatabaseTransaction.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEnD;;;;;GAKG;AACH;IAA6C,2CAAe;IAC1D;;OAEG;IACH,iCAA6B,QAAsB;QACjD,YAAA,MAAK,WAAE,SAAA;QADoB,cAAQ,GAAR,QAAQ,CAAc;;IAEnD,CAAC;IAED;;;;;;;OAOG;IACgB,8CAAY,GAA/B,UACE,QAAsB,EACtB,UAAmB;QAEnB,IAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;QAC7D,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,uBAAgB,QAAQ,gBAAa,CAAC,CAAA;QACxD,CAAC;QACD,OAAO,GAAQ,CAAA;IACjB,CAAC;IACH,8BAAC;AAAD,CAAC,AA1BD,CAA6C,eAAe,GA0B3D"}

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

@@ -0,0 +1,188 @@
+import { AcDbObject } from '../../base';
+import { AcDbDatabase } from '../AcDbDatabase';
+import { AcDbChangeContainer } from './AcDbDatabaseChange';
+import { AcDbDatabaseTransaction } from './AcDbDatabaseTransaction';
+/**
+ * Manages database transactions and undo/redo history for one {@link AcDbDatabase}.
+ *
+ * Aligns with ObjectARX {@code AcDbTransactionManager} semantics and provides
+ * undo mark grouping for editor commands.
+ */
+export declare class AcDbDatabaseTransactionManager {
+    private readonly database;
+    private readonly transactionStack;
+    private readonly undoStack;
+    private readonly changeApplier;
+    private readonly undoMarkStack;
+    private _applyingUndoRedo;
+    /**
+     * When true, mutations outside an active transaction throw an error.
+     *
+     * Undo/redo replay is exempt so {@link AcDbChangeApplier} can restore state.
+     */
+    strictMode: boolean;
+    /**
+     * Creates a transaction manager for one database.
+     *
+     * @param database - Database whose mutations and undo history are managed
+     */
+    constructor(database: AcDbDatabase);
+    /**
+     * Starts a new database transaction and pushes it onto the stack.
+     *
+     * Equivalent to ObjectARX `AcDbTransactionManager::startTransaction()`.
+     *
+     * @returns The newly created transaction
+     */
+    startTransaction(): AcDbDatabaseTransaction;
+    /**
+     * Returns the top-most active transaction, if any.
+     */
+    currentTransaction(): AcDbDatabaseTransaction | undefined;
+    /**
+     * Returns true when at least one transaction is active.
+     */
+    hasTransaction(): boolean;
+    /**
+     * Returns true when mutations should be recorded into the current transaction.
+     *
+     * Recording is disabled while undo/redo is being applied.
+     */
+    isRecording(): boolean;
+    /**
+     * Returns true while {@link AcDbChangeApplier} is replaying undo or redo changes.
+     */
+    isApplyingUndoRedo(): boolean;
+    /**
+     * Commits the current transaction.
+     *
+     * Nested transactions merge their recorder into the parent. The outermost
+     * commit finalizes changes, dispatches events, and enqueues undo history
+     * when an undo mark is active.
+     *
+     * @throws Error if no transaction is active
+     */
+    commitTransaction(): void;
+    /**
+     * Aborts the current transaction and rolls back all recorded changes.
+     *
+     * @throws Error if no transaction is active
+     */
+    abortTransaction(): void;
+    /**
+     * Opens an undo-mark group.
+     *
+     * Commits performed before {@link endUndoMark} are merged into one
+     * {@link AcDbUndoRecord}.
+     *
+     * @param label - Optional label for undo UI (for example, `"Move"`)
+     */
+    startUndoMark(label?: string): void;
+    /**
+     * Closes the current undo mark and pushes a record when changes were committed.
+     *
+     * @throws Error if no undo mark is active
+     */
+    endUndoMark(): void;
+    /**
+     * Discards the current undo mark without creating an undo record.
+     */
+    cancelUndoMark(): void;
+    /**
+     * Undoes the most recent undo record.
+     *
+     * @returns True when an undo record was applied; false when the stack is empty
+     */
+    undo(): boolean;
+    /**
+     * Redoes the most recently undone record.
+     *
+     * @returns True when a redo record was applied; false when the redo stack is empty
+     */
+    redo(): boolean;
+    /**
+     * Returns true when at least one undo record is available.
+     */
+    canUndo(): boolean;
+    /**
+     * Returns true when at least one redo record is available.
+     */
+    canRedo(): boolean;
+    /**
+     * Clears both undo and redo history for this database.
+     */
+    clearUndoStack(): void;
+    /**
+     * Records append of an object into a container during the active transaction.
+     *
+     * No-op when {@link isRecording} is false.
+     *
+     * @param container - Container that received the object
+     * @param object - Object that was appended
+     */
+    recordAppend(container: AcDbChangeContainer, object: AcDbObject): void;
+    /**
+     * Records removal of an object from a container during the active transaction.
+     *
+     * No-op when {@link isRecording} is false.
+     *
+     * @param container - Container that owned the removed object
+     * @param object - Object that was removed
+     */
+    recordRemove(container: AcDbChangeContainer, object: AcDbObject): void;
+    /**
+     * Records the pre-change value of a system variable.
+     *
+     * No-op when {@link isRecording} is false.
+     *
+     * @param name - System variable name
+     * @param before - Value observed before mutation
+     */
+    recordSysvar(name: string, before: unknown): void;
+    /**
+     * Maps a symbol table instance to the stable name stored in undo records.
+     *
+     * @param table - Symbol table whose logical name is needed
+     * @returns Known table name, or the table's object ID as a fallback
+     */
+    resolveSymbolTableName(table: {
+        objectId: string;
+    }): string;
+    /**
+     * Runs one undoable editor command inside a transaction and undo mark.
+     *
+     * On success the transaction is committed and the undo mark is closed.
+     * On failure the transaction is aborted and the undo mark is cancelled.
+     *
+     * @param label - Label stored on the resulting undo record
+     * @param fn - Callback that performs the command using the active transaction
+     * @returns The value returned by `fn`
+     */
+    runUndoable<T>(label: string, fn: (tr: AcDbDatabaseTransaction) => T): T;
+    /**
+     * Appends committed changes to the active undo mark, if any.
+     *
+     * Called after the outermost transaction commit so multiple commits within
+     * one {@link startUndoMark} group merge into a single {@link AcDbUndoRecord}.
+     *
+     * @param changes - Finalized changes from the committed transaction
+     */
+    private enqueueUndoChanges;
+    /**
+     * Dispatches entity, dictionary, and sysvar events after a successful commit.
+     *
+     * @param changes - Finalized changes from the committed outermost transaction
+     */
+    private dispatchCommitEvents;
+    /**
+     * Dispatches entity, dictionary, and sysvar events after undo or redo replay.
+     *
+     * Append/remove and dictionary notifications are swapped when `inverse` is
+     * true so listeners observe the same semantics as the user-facing operation.
+     *
+     * @param changes - Changes from the undo record being applied
+     * @param inverse - True when undoing (inverse replay); false when redoing
+     */
+    private dispatchUndoRedoEvents;
+}
+//# sourceMappingURL=AcDbDatabaseTransactionManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcDbDatabaseTransactionManager.d.ts","sourceRoot":"","sources":["../../../src/database/transaction/AcDbDatabaseTransactionManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAO9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAanE;;;;;GAKG;AACH,qBAAa,8BAA8B;IAmB7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAlBrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgC;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmB;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;IACxD,OAAO,CAAC,iBAAiB,CAAQ;IAEjC;;;;OAIG;IACH,UAAU,UAAQ;IAElB;;;;OAIG;gBAC0B,QAAQ,EAAE,YAAY;IAInD;;;;;;OAMG;IACH,gBAAgB,IAAI,uBAAuB;IAM3C;;OAEG;IACH,kBAAkB,IAAI,uBAAuB,GAAG,SAAS;IAIzD;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;;;;;;;OAQG;IACH,iBAAiB,IAAI,IAAI;IAuBzB;;;;OAIG;IACH,gBAAgB,IAAI,IAAI;IAqBxB;;;;;;;OAOG;IACH,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAInC;;;;OAIG;IACH,WAAW,IAAI,IAAI;IAgBnB;;OAEG;IACH,cAAc,IAAI,IAAI;IAMtB;;;;OAIG;IACH,IAAI,IAAI,OAAO;IAoBf;;;;OAIG;IACH,IAAI,IAAI,OAAO;IAoBf;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,cAAc,IAAI,IAAI;IAItB;;;;;;;OAOG;IACH,YAAY,CAAC,SAAS,EAAE,mBAAmB,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAOtE;;;;;;;OAOG;IACH,YAAY,CAAC,SAAS,EAAE,mBAAmB,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAOtE;;;;;;;OAOG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAOjD;;;;;OAKG;IACH,sBAAsB,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAa3D;;;;;;;;;OASG;IACH,WAAW,CAAC,CAAC,EACX,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,EAAE,EAAE,uBAAuB,KAAK,CAAC,GACrC,CAAC;IAiBJ;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAyC5B;;;;;;;;OAQG;IACH,OAAO,CAAC,sBAAsB;CA+D/B"}