@mlightcad/cad-simple-viewer 1.5.6 → 1.5.7

package/lib/service/AcApEntityService.js

@@ -0,0 +1,194 @@
+import { AcGeMatrix3d } from '@mlightcad/data-model';
+import { createRotationMatrix } from '../util/AcApGeTransform';
+import { acapRunServiceEdit, ENTITY_EDIT_LABEL } from './AcApServiceEdit';
+/**
+ * Centralizes entity mutations for modify commands and non-command callers.
+ *
+ * Provides geometric transforms, cloning, erasure, layer reassignment,
+ * and undo-wrapped edit helpers against a single {@link AcDbDatabase}.
+ */
+var AcApEntityService = /** @class */ (function () {
+    /**
+     * Creates an entity service bound to a database.
+     *
+     * @param db - Database whose entities will be mutated.
+     */
+    function AcApEntityService(db) {
+        this.db = db;
+    }
+    /**
+     * Returns entity instances for the given object ids.
+     *
+     * @param ids - Entity object ids to look up.
+     * @returns Entities that exist in the block table.
+     */
+    AcApEntityService.prototype.getEntitiesByIds = function (ids) {
+        var _this = this;
+        return ids
+            .map(function (id) { return _this.db.tables.blockTable.getEntityById(id); })
+            .filter(function (entity) { return !!entity; });
+    };
+    /**
+     * Applies a transform matrix to entities opened for write.
+     *
+     * @param entities - Entities to transform.
+     * @param matrix - Transform to apply via {@link AcDbEntity.transformBy}.
+     * @returns Number of entities successfully transformed.
+     */
+    AcApEntityService.prototype.transformEntities = function (entities, matrix) {
+        var _this = this;
+        var count = 0;
+        entities.forEach(function (entity) {
+            var opened = _this.db.openEntityForWrite(entity);
+            if (!opened)
+                return;
+            opened.transformBy(matrix);
+            count++;
+        });
+        return count;
+    };
+    /**
+     * Translates entities by a displacement vector.
+     *
+     * @param entities - Entities to move.
+     * @param displacement - Translation vector in WCS.
+     * @returns Number of entities successfully translated.
+     */
+    AcApEntityService.prototype.translateEntities = function (entities, displacement) {
+        var matrix = new AcGeMatrix3d().makeTranslation(displacement.x, displacement.y, displacement.z);
+        return this.transformEntities(entities, matrix);
+    };
+    /**
+     * Rotates entities around a base point.
+     *
+     * @param entities - Entities to rotate.
+     * @param basePoint - Rotation origin in WCS.
+     * @param angleRad - Rotation angle in radians.
+     * @returns Number of entities successfully rotated.
+     */
+    AcApEntityService.prototype.rotateEntities = function (entities, basePoint, angleRad) {
+        var matrix = createRotationMatrix(basePoint, angleRad);
+        return this.transformEntities(entities, matrix);
+    };
+    /**
+     * Clones entities, transforms them, and optionally appends to model space.
+     *
+     * @param sourceEntities - Entities to clone.
+     * @param matrix - Transform applied to each clone.
+     * @param options - Append behavior.
+     * @returns Transformed clone instances.
+     */
+    AcApEntityService.prototype.cloneAndTransform = function (sourceEntities, matrix, options) {
+        var _a;
+        if (options === void 0) { options = {}; }
+        var append = (_a = options.append) !== null && _a !== void 0 ? _a : true;
+        var clones = sourceEntities
+            .map(function (entity) { return entity.clone(); })
+            .filter(function (entity) { return !!entity; });
+        clones.forEach(function (entity) { return entity.transformBy(matrix); });
+        if (append && clones.length > 0) {
+            this.db.tables.blockTable.modelSpace.appendEntity(clones);
+        }
+        return clones;
+    };
+    /**
+     * Erases entities by object id.
+     *
+     * @param objectIds - Entity ids to erase.
+     * @returns Number of entities successfully erased.
+     */
+    AcApEntityService.prototype.eraseEntities = function (objectIds) {
+        var _this = this;
+        var count = 0;
+        objectIds.forEach(function (objectId) {
+            var entity = _this.db.openEntityForWrite(objectId);
+            if (!entity)
+                return;
+            entity.erase();
+            count++;
+        });
+        return count;
+    };
+    /**
+     * Moves entities to the current layer (`CLAYER`).
+     *
+     * @param objectIds - Entity ids to reassign.
+     * @returns Counts of changed, skipped, and missing entities.
+     */
+    AcApEntityService.prototype.moveEntitiesToCurrentLayer = function (objectIds) {
+        var _this = this;
+        var _a;
+        var currentLayerName = (_a = this.db.clayer) === null || _a === void 0 ? void 0 : _a.trim();
+        var currentLayer = currentLayerName
+            ? this.db.tables.layerTable.getAt(currentLayerName)
+            : undefined;
+        if (!currentLayer) {
+            return {
+                changedCount: 0,
+                alreadyCurrent: 0,
+                missing: 0,
+                currentLayerMissing: true
+            };
+        }
+        var changedCount = 0;
+        var alreadyCurrent = 0;
+        var missing = 0;
+        new Set(objectIds).forEach(function (objectId) {
+            var entity = _this.db.tables.blockTable.getEntityById(objectId);
+            if (!entity) {
+                missing++;
+                return;
+            }
+            if (entity.layer === currentLayer.name) {
+                alreadyCurrent++;
+                return;
+            }
+            var opened = _this.db.openEntityForWrite(objectId);
+            if (!opened) {
+                missing++;
+                return;
+            }
+            opened.layer = currentLayer.name;
+            changedCount++;
+        });
+        return { changedCount: changedCount, alreadyCurrent: alreadyCurrent, missing: missing, currentLayerMissing: false };
+    };
+    /**
+     * Copies display traits from one entity to another.
+     *
+     * Copies layer, color, linetype, line weight, linetype scale, transparency,
+     * and visibility.
+     *
+     * @param source - Entity to copy traits from.
+     * @param target - Entity to receive traits.
+     */
+    AcApEntityService.copyDisplayTraits = function (source, target) {
+        target.layer = source.layer;
+        target.color = source.color.clone();
+        target.lineType = source.lineType;
+        target.lineWeight = source.lineWeight;
+        target.linetypeScale = source.linetypeScale;
+        target.transparency = source.transparency;
+        target.visibility = source.visibility;
+    };
+    /**
+     * Runs an entity edit with undo when outside a command transaction.
+     *
+     * @param label - Undo group label.
+     * @param fn - Mutation callback.
+     */
+    AcApEntityService.prototype.runEdit = function (label, fn) {
+        acapRunServiceEdit(this.db, label, fn);
+    };
+    /**
+     * Runs an entity edit with the default entity undo label.
+     *
+     * @param fn - Mutation callback.
+     */
+    AcApEntityService.prototype.runEntityEdit = function (fn) {
+        acapRunServiceEdit(this.db, ENTITY_EDIT_LABEL, fn);
+    };
+    return AcApEntityService;
+}());
+export { AcApEntityService };
+//# sourceMappingURL=AcApEntityService.js.map

package/lib/service/AcApEntityService.js.map

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

package/lib/{command/layer → service}/AcApLayerIsoState.d.ts

@@ -32,37 +32,19 @@ export interface AcApLayerIsoSnapshot {
     /** Layers whose state changed during `LAYISO`. */
     layers: AcApLayerIsoLayerSnapshot[];
 }
-/**
- * Stores the most recent `LAYISO` snapshot for `LAYUNISO`.
- */
-export declare class AcApLayerIsoState {
-    private static _snapshot;
-    /**
-     * Replaces the previous isolation snapshot.
-     *
-     * @param snapshot - Snapshot captured by the latest `LAYISO` run.
-     */
-    static set(snapshot: AcApLayerIsoSnapshot): void;
-    /**
-     * Consumes the current snapshot so `LAYUNISO` behaves as a one-shot restore.
-     *
-     * @returns Latest isolation snapshot, or `undefined` if `LAYISO` has not run.
-     */
-    static consume(): AcApLayerIsoSnapshot | undefined;
-}
 /**
  * Captures the layer state relevant to isolation.
  *
- * @param layer - Layer table record to inspect.
- * @returns Snapshot of visibility, freeze, and lock flags.
+ * @param layer - Layer table record to snapshot.
+ * @returns Off, frozen, and locked flags for the layer.
  */
 export declare function getLayerIsoState(layer: AcDbLayerTableRecord): AcApLayerIsoLayerState;
 /**
- * Compares two isolation layer states.
+ * Compares two isolation layer states for equality.
  *
- * @param a - First state.
- * @param b - Second state.
- * @returns `true` when all tracked flags match.
+ * @param a - First layer state.
+ * @param b - Second layer state.
+ * @returns `true` when off, frozen, and locked flags match.
  */
 export declare function isSameLayerIsoState(a: AcApLayerIsoLayerState, b: AcApLayerIsoLayerState): boolean;
 //# sourceMappingURL=AcApLayerIsoState.d.ts.map

package/lib/service/AcApLayerIsoState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApLayerIsoState.d.ts","sourceRoot":"","sources":["../../src/service/AcApLayerIsoState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAI5D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,uCAAuC;IACvC,KAAK,EAAE,OAAO,CAAA;IAEd,mCAAmC;IACnC,QAAQ,EAAE,OAAO,CAAA;IAEjB,mCAAmC;IACnC,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IAEZ,8CAA8C;IAC9C,MAAM,EAAE,sBAAsB,CAAA;IAE9B,uDAAuD;IACvD,QAAQ,EAAE,sBAAsB,CAAA;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,kBAAkB,EAAE,MAAM,CAAA;IAE1B,yDAAyD;IACzD,iBAAiB,EAAE,MAAM,CAAA;IAEzB,kDAAkD;IAClD,MAAM,EAAE,yBAAyB,EAAE,CAAA;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,oBAAoB,GAC1B,sBAAsB,CAMxB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,sBAAsB,EACzB,CAAC,EAAE,sBAAsB,WAO1B"}

package/lib/service/AcApLayerIsoState.js

@@ -0,0 +1,28 @@
+import { LAYER_LOCKED_FLAG } from './types';
+/**
+ * Captures the layer state relevant to isolation.
+ *
+ * @param layer - Layer table record to snapshot.
+ * @returns Off, frozen, and locked flags for the layer.
+ */
+export function getLayerIsoState(layer) {
+    var _a;
+    return {
+        isOff: layer.isOff,
+        isFrozen: layer.isFrozen,
+        isLocked: (((_a = layer.standardFlags) !== null && _a !== void 0 ? _a : 0) & LAYER_LOCKED_FLAG) !== 0
+    };
+}
+/**
+ * Compares two isolation layer states for equality.
+ *
+ * @param a - First layer state.
+ * @param b - Second layer state.
+ * @returns `true` when off, frozen, and locked flags match.
+ */
+export function isSameLayerIsoState(a, b) {
+    return (a.isOff === b.isOff &&
+        a.isFrozen === b.isFrozen &&
+        a.isLocked === b.isLocked);
+}
+//# sourceMappingURL=AcApLayerIsoState.js.map

package/lib/service/AcApLayerIsoState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApLayerIsoState.js","sourceRoot":"","sources":["../../src/service/AcApLayerIsoState.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AA4C3C;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAA2B;;IAE3B,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,CAAC,CAAC,MAAA,KAAK,CAAC,aAAa,mCAAI,CAAC,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC;KACjE,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,CAAyB,EACzB,CAAyB;IAEzB,OAAO,CACL,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QACnB,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;QACzB,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,CAC1B,CAAA;AACH,CAAC"}

package/lib/service/AcApLayerService.d.ts

@@ -0,0 +1,400 @@
+import { AcCmColor, AcDbDatabase, AcDbLayerTableRecord, AcDbObjectId, AcGiSubEntityTraits } from '@mlightcad/data-model';
+import type { AcApLayerPreviousSnapshot } from '../app/AcApLayerSessionState';
+import { AcApLayerIsoSnapshot } from './AcApLayerIsoState';
+import { AcApDeleteLayerResult, AcApLaydelEntitySnapshot, AcApLayerByEntityResult, AcApLayerIsolateResult, AcApLayerIsolationMode, AcApSetLayerOnOptions, AcApSetLayersVisibilityOptions } from './types';
+/** Summary row for layer listing commands and UI. */
+export interface AcApLayerSummary {
+    /** Layer name. */
+    name: string;
+    /** `*` when this layer is the current layer (`CLAYER`). */
+    current: string;
+    /** `Yes` or `No` visibility indicator. */
+    on: string;
+    /** `Yes` or `No` frozen indicator. */
+    frozen: string;
+    /** `Yes` or `No` locked indicator. */
+    locked: string;
+    /** String representation of the layer color. */
+    color: string;
+}
+/** Result of creating layers via the LAYER command New branch. */
+export interface AcApCreateLayersResult {
+    /** Number of layers created. */
+    created: number;
+    /** Names that already existed and were skipped. */
+    existed: string[];
+}
+/** Result of resolving layer names to table records. */
+export interface AcApResolveLayersResult {
+    /** Resolved layer table records. */
+    layers: AcDbLayerTableRecord[];
+    /** Names that were not found in the layer table. */
+    missing: string[];
+}
+/**
+ * Result of isolating layers, including the snapshot for `LAYUNISO`.
+ */
+export interface AcApLayerIsolateLayersResult extends AcApLayerIsolateResult {
+    /** Snapshot to store on the owning document for `LAYUNISO`. */
+    isoSnapshot: AcApLayerIsoSnapshot;
+}
+/**
+ * Centralizes layer table mutations for commands and UI consumers.
+ *
+ * Wraps on/off, freeze/thaw, lock/unlock, color, isolation (`LAYISO`/`LAYUNISO`),
+ * deletion (`LAYDEL`), and related operations with consistent undo handling.
+ * Document-scoped session state (`LAYERP`, `LAYUNISO` snapshots) lives on
+ * {@link AcApDocument}.
+ */
+export declare class AcApLayerService {
+    private readonly db;
+    /**
+     * Creates a layer service bound to a database.
+     *
+     * @param db - Database whose layer table will be mutated.
+     */
+    constructor(db: AcDbDatabase);
+    /** Opens an existing layer table record for write.
+     *
+     * @param db - Database containing the layer table.
+     * @param layerOrName - Layer record or name to open.
+     * @returns Opened layer record, or `undefined` when not found.
+     */
+    static openLayerForWrite(db: AcDbDatabase, layerOrName: AcDbLayerTableRecord | string): AcDbLayerTableRecord | undefined;
+    /** Sets or clears the frozen bit on a layer record.
+     *
+     * @param layer - Layer record to modify.
+     * @param frozen - Desired frozen state.
+     */
+    static setLayerFrozenState(layer: AcDbLayerTableRecord, frozen: boolean): void;
+    /** Sets or clears the locked bit on a layer record.
+     *
+     * @param layer - Layer record to modify.
+     * @param locked - Desired locked state.
+     */
+    static setLayerLockedState(layer: AcDbLayerTableRecord, locked: boolean): void;
+    /** Returns whether a layer is locked according to its standard flags.
+     *
+     * @param layer - Layer record to inspect.
+     * @returns `true` when the locked bit is set.
+     */
+    static isLayerLocked(layer: AcDbLayerTableRecord): boolean;
+    /**
+     * Applies a captured `LAYERP` snapshot to a database.
+     *
+     * @param db - Database whose layer table should be updated.
+     * @param snapshot - Snapshot previously captured on the owning document.
+     * @returns `true` when the snapshot's current layer still exists.
+     */
+    static applyLayerPreviousSnapshot(db: AcDbDatabase, snapshot: AcApLayerPreviousSnapshot): boolean;
+    /**
+     * Parses layer name input supporting `*` and comma-separated names.
+     *
+     * @param input - Raw user input (e.g. `A,B` or `*`).
+     * @returns Deduplicated list of layer names.
+     */
+    parseLayerNameInput(input: string): string[];
+    /**
+     * Resolves layer records by name.
+     *
+     * @param names - Layer names to look up.
+     * @returns Resolved records and names that were not found.
+     */
+    resolveLayers(names: string[]): AcApResolveLayersResult;
+    /**
+     * Returns summary rows for all layers.
+     *
+     * @returns Display-oriented summary for each layer in the table.
+     */
+    getLayerSummaries(): AcApLayerSummary[];
+    /**
+     * Creates missing layers.
+     *
+     * @param names - Layer names to create.
+     * @returns Count of created layers and names that already existed.
+     */
+    createLayers(names: string[]): AcApCreateLayersResult;
+    /**
+     * Sets current layer (`CLAYER`), ensuring it is on and thawed.
+     *
+     * @param name - Layer name to make current.
+     * @returns `true` when the layer exists and was set current.
+     */
+    setCurrentLayer(name: string): boolean;
+    /**
+     * Creates a layer if missing, then makes it current.
+     *
+     * @param name - Layer name to create or activate.
+     * @returns `true` when the layer is current after the operation.
+     */
+    makeLayer(name: string): boolean;
+    /**
+     * Turns a single layer on or off.
+     *
+     * When turning off the current layer, pass `{ switchCurrentLayer: true }`
+     * (as {@link AcApLayerStore} does) to move `CLAYER` first. CLI commands leave
+     * the default `false` and rely on batch helpers to skip the current layer.
+     *
+     * @param layerName - Target layer name.
+     * @param isOn - Desired visibility (`true` = on).
+     * @param options - Optional behavior when turning off the current layer.
+     * @returns `true` when the layer exists and was updated.
+     */
+    setLayerOn(layerName: string, isOn: boolean, options?: AcApSetLayerOnOptions): boolean;
+    /**
+     * Freezes or thaws a single layer.
+     *
+     * UI callers should pass `{ switchCurrentLayer: true }` when freezing the
+     * current layer so drawing continues on a visible, thawed layer.
+     *
+     * @param layerName - Target layer name.
+     * @param frozen - Desired frozen state.
+     * @param options - Optional behavior when freezing the current layer.
+     * @returns `true` when the layer exists and was updated.
+     */
+    setLayerFrozen(layerName: string, frozen: boolean, options?: AcApSetLayerOnOptions): boolean;
+    /**
+     * Locks or unlocks a single layer.
+     *
+     * @param layerName - Target layer name.
+     * @param locked - Desired locked state.
+     * @returns `true` when the layer exists and was updated.
+     */
+    setLayerLocked(layerName: string, locked: boolean): boolean;
+    /**
+     * Assigns line weight to a single layer.
+     *
+     * @param layerName - Target layer name.
+     * @param lineWeight - Line weight value to assign.
+     * @returns `true` when the layer exists and line weight was set.
+     */
+    setLayerLineWeight(layerName: string, lineWeight: number): boolean;
+    /**
+     * Keeps one layer visible and turns all others off (UI quick-isolate).
+     *
+     * Does not capture a `LAYUNISO` snapshot; use {@link isolateLayers} for
+     * command semantics.
+     *
+     * @param layerName - Layer to keep visible.
+     * @returns `true` when the layer exists and isolation was applied.
+     */
+    isolateSingleLayer(layerName: string): boolean;
+    /**
+     * Batch toggles layer visibility.
+     *
+     * @param names - Layer names to update.
+     * @param off - `true` to turn layers off, `false` to turn them on.
+     * @param options - Optional skip rules for the current layer.
+     * @returns Names of current layers skipped when turning off.
+     */
+    setLayersVisibility(names: string[], off: boolean, options?: AcApSetLayersVisibilityOptions): {
+        skippedCurrent: string[];
+    };
+    /**
+     * Turns on every layer in the table.
+     *
+     * @returns Number of layers changed from off to on.
+     */
+    setAllLayersOn(): number;
+    /**
+     * Turns off every layer except the current layer.
+     *
+     * @returns Number of layers turned off.
+     */
+    setAllLayersOffExceptCurrent(): number;
+    /**
+     * Batch toggles frozen state.
+     *
+     * @param names - Layer names to update.
+     * @param freeze - `true` to freeze, `false` to thaw.
+     * @param options - Optional skip rules for the current layer.
+     * @returns Names of current layers skipped when freezing.
+     */
+    setLayersFrozen(names: string[], freeze: boolean, options?: AcApSetLayersVisibilityOptions): {
+        skippedCurrent: string[];
+    };
+    /**
+     * Thaws all frozen layers in the table.
+     *
+     * @returns Number of layers thawed.
+     */
+    thawAllLayers(): number;
+    /**
+     * Batch toggles lock state.
+     *
+     * @param names - Layer names to update.
+     * @param lock - `true` to lock, `false` to unlock.
+     */
+    setLayersLocked(names: string[], lock: boolean): void;
+    /**
+     * Parses color input for layer color assignment.
+     *
+     * Accepts ACI index (1–255) or color strings understood by {@link AcCmColor.fromString}.
+     *
+     * @param input - Raw color string from the user or UI.
+     * @returns Parsed color, or `undefined` when invalid.
+     */
+    parseColorInput(input: string): AcCmColor | undefined;
+    /**
+     * Assigns color to a single layer.
+     *
+     * @param layerName - Target layer name.
+     * @param color - Color to assign.
+     * @returns `true` when the layer exists and color was set.
+     */
+    setLayerColor(layerName: string, color: AcCmColor): boolean;
+    /**
+     * Assigns the same color to multiple layers.
+     *
+     * @param names - Layer names to update.
+     * @param color - Color to assign to each resolved layer.
+     */
+    setLayersColor(names: string[], color: AcCmColor): void;
+    /**
+     * Updates a layer description.
+     *
+     * @param name - Target layer name.
+     * @param description - New description text.
+     * @returns `true` when the layer exists and description was set.
+     */
+    setLayerDescription(name: string, description: string): boolean;
+    /**
+     * Moves `CLAYER` away from a layer before turning it off or freezing it.
+     *
+     * @param targetLayerName - Layer that will be turned off or frozen.
+     * @returns `true` when `CLAYER` is no longer the target layer, or target was not current.
+     */
+    switchCurrentLayerIfNeeded(targetLayerName: string): boolean;
+    /**
+     * Resolves the layer name of an entity.
+     *
+     * @param objectId - Entity object id.
+     * @returns Trimmed layer name, or `undefined` when the entity is missing.
+     */
+    getLayerNameFromEntity(objectId: AcDbObjectId): string | undefined;
+    /**
+     * Collects distinct layer names from a set of entity ids.
+     *
+     * @param objectIds - Entity ids to inspect.
+     * @returns Resolved layer names and names missing from the layer table.
+     */
+    collectLayerNamesFromEntities(objectIds: AcDbObjectId[]): {
+        layerNames: string[];
+        missingLayerNames: string[];
+    };
+    /**
+     * Freezes the layer of a picked entity (`LAYFRZ`).
+     *
+     * @param objectId - Selected entity id.
+     * @returns Outcome with previous frozen state for session undo, or a failure reason.
+     */
+    freezeLayerByEntity(objectId: AcDbObjectId): AcApLayerByEntityResult;
+    /**
+     * Restores frozen state by layer name for `LAYFRZ` session undo.
+     *
+     * @param layerName - Target layer name.
+     * @param frozen - Frozen state to restore.
+     * @returns `true` when the layer exists and state was applied.
+     */
+    setLayerFrozenByName(layerName: string, frozen: boolean): boolean;
+    /**
+     * Turns off the layer of a picked entity (`LAYOFF`).
+     *
+     * @param objectId - Selected entity id.
+     * @returns Outcome with previous off state for session undo, or a failure reason.
+     */
+    turnOffLayerByEntity(objectId: AcDbObjectId): AcApLayerByEntityResult;
+    /**
+     * Restores off state by layer name for `LAYOFF` session undo.
+     *
+     * @param layerName - Target layer name.
+     * @param off - Off state to restore.
+     * @returns `true` when the layer exists and state was applied.
+     */
+    setLayerOffByName(layerName: string, off: boolean): boolean;
+    /**
+     * Locks the layer of a picked entity (`LAYLCK`).
+     *
+     * @param objectId - Selected entity id.
+     * @returns Success or failure outcome.
+     */
+    lockLayerByEntity(objectId: AcDbObjectId): AcApLayerByEntityResult;
+    /**
+     * Unlocks the layer of a picked entity (`LAYULK`).
+     *
+     * @param objectId - Selected entity id.
+     * @returns Success or failure outcome.
+     */
+    unlockLayerByEntity(objectId: AcDbObjectId): AcApLayerByEntityResult;
+    /**
+     * Isolates layers by name using `LAYISO` semantics.
+     *
+     * Target layers are turned on, thawed, and unlocked. Other layers are turned off
+     * or locked depending on `isolationMode`. `LockAndFade` locks only; the viewer
+     * does not render a fade effect.
+     *
+     * @param layerNames - Names of layers to keep visible.
+     * @param isolationMode - How non-isolated layers are hidden.
+     * @returns Isolation result with undo snapshot, or `undefined` when `layerNames` is empty.
+     */
+    isolateLayers(layerNames: string[], isolationMode: AcApLayerIsolationMode): AcApLayerIsolateLayersResult | undefined;
+    /**
+     * Restores a `LAYISO` snapshot.
+     *
+     * @param snapshot - Snapshot previously produced by {@link isolateLayers}.
+     * @returns Number of layers whose state was restored.
+     */
+    unisolateFromSnapshot(snapshot: AcApLayerIsoSnapshot): number;
+    /**
+     * Collects entity snapshots on a layer for `LAYDEL` undo.
+     *
+     * @param layerName - Layer whose entities should be snapshotted.
+     * @returns Cloned entities with owner and object ids.
+     */
+    collectLayerEntities(layerName: string): AcApLaydelEntitySnapshot[];
+    /**
+     * Removes entities previously captured for `LAYDEL`.
+     *
+     * @param deletedEntities - Entity snapshots to erase from their owners.
+     */
+    removeLayerEntities(deletedEntities: AcApLaydelEntitySnapshot[]): void;
+    /**
+     * Deletes a layer and all entities on it (`LAYDEL`).
+     *
+     * Layer `0` and the current layer cannot be deleted.
+     *
+     * @param layerName - Name of the layer to delete.
+     * @returns Success with undo snapshots, or a failure reason.
+     */
+    deleteLayer(layerName: string): AcApDeleteLayerResult;
+    /**
+     * Restores a deleted layer and its entities for `LAYDEL` session undo.
+     *
+     * @param layer - Cloned layer table record to re-add.
+     * @param entities - Entity snapshots to append back to their owners.
+     */
+    restoreDeletedLayer(layer: AcDbLayerTableRecord, entities: AcApLaydelEntitySnapshot[]): void;
+    /**
+     * Restores one layer from an isolation snapshot when its post-isolation state still matches.
+     *
+     * @param snapshot - Per-layer before/after isolation snapshot.
+     * @returns `true` when at least one flag was restored.
+     */
+    private restoreLayerIfUnchanged;
+    /**
+     * Resolves live layer-table traits for rendering and style synchronization.
+     *
+     * @param layerName - Name of the layer to resolve from the layer table.
+     * @returns Resolved sub-entity traits, or undefined when the layer is missing.
+     */
+    getEffectiveLayerTraits(layerName: string): Partial<AcGiSubEntityTraits> | undefined;
+    /**
+     * Resolves live layer-table traits from the given database.
+     *
+     * @param db - Database whose layer table supplies the record.
+     * @param layerName - Name of the layer to resolve.
+     * @returns Resolved sub-entity traits, or undefined when the layer is missing.
+     */
+    static resolveLayerTraits(db: AcDbDatabase, layerName: string): Partial<AcGiSubEntityTraits> | undefined;
+}
+//# sourceMappingURL=AcApLayerService.d.ts.map