molstar 4.0.1 → 4.2.0

package/lib/commonjs/mol-plugin-state/manager/structure/measurement.d.ts

@@ -1,18 +1,20 @@
 /**
- * Copyright (c) 2019-2021 mol* contributors, licensed under MIT, See LICENSE file for more info.
+ * Copyright (c) 2019-2024 mol* contributors, licensed under MIT, See LICENSE file for more info.
  *
  * @author David Sehnal <david.sehnal@gmail.com>
  * @author Alexander Rose <alexander.rose@weirdbyte.de>
+ * @author Ryan DiRisio <rjdiris@gmail.com>
  */
 import { StructureElement } from '../../../mol-model/structure';
 import { PluginContext } from '../../../mol-plugin/context';
-import { StateTransform, StateTransformer, StateObjectCell } from '../../../mol-state';
+import { StateTransform, StateTransformer, StateObject, StateObjectCell } from '../../../mol-state';
 import { StateTransforms } from '../../transforms';
 import { PluginStateObject } from '../../objects';
 import { StatefulPluginComponent } from '../../component';
 import { ParamDefinition as PD } from '../../../mol-util/param-definition';
 import { LociLabelTextParams } from '../../../mol-repr/shape/loci/common';
 import { LineParams } from '../../../mol-repr/structure/representation/line';
+import { Color } from '../../../mol-util/color';
 export { StructureMeasurementManager };
 export declare const MeasurementGroupTag = "measurement-group";
 export declare const MeasurementOrderLabelTag = "measurement-order-label";
@@ -48,19 +50,349 @@ declare class StructureMeasurementManager extends StatefulPluginComponent<Struct
     setOptions(options: StructureMeasurementOptions): Promise<void>;
     addDistance(a: StructureElement.Loci, b: StructureElement.Loci, options?: StructureMeasurementManagerAddOptions & {
         visualParams?: Partial<StateTransformer.Params<typeof StateTransforms.Representation.StructureSelectionsDistance3D>>;
-    }): Promise<void>;
+    }): Promise<{
+        selection: import("../../../mol-state").StateObjectSelector<PluginStateObject.Molecule.Structure.Selections, StateTransformer<PluginStateObject.Root, PluginStateObject.Molecule.Structure.Selections, PD.Normalize<{
+            selections: PD.Normalize<{
+                key: any;
+                ref: any;
+                groupId: any;
+                expression: any;
+            }>[];
+            isTransitive: boolean | undefined;
+            label: string | undefined;
+        }>>>;
+        representation: import("../../../mol-state").StateObjectSelector<PluginStateObject.Shape.Representation3D, StateTransformer<PluginStateObject.Molecule.Structure.Selections, PluginStateObject.Shape.Representation3D, PD.Normalize<{
+            visuals: ("text" | "lines")[];
+            unitLabel: string;
+            borderWidth: number;
+            customText: string;
+            textColor: Color;
+            textSize: number;
+            sizeFactor: number;
+            borderColor: Color;
+            offsetX: number;
+            offsetY: number;
+            offsetZ: number;
+            background: boolean;
+            backgroundMargin: number;
+            backgroundColor: Color;
+            backgroundOpacity: number;
+            tether: boolean;
+            tetherLength: number;
+            tetherBaseWidth: number;
+            attachment: "bottom-left" | "bottom-center" | "bottom-right" | "middle-left" | "middle-center" | "middle-right" | "top-left" | "top-center" | "top-right";
+            fontFamily: import("../../../mol-geo/geometry/text/font-atlas").FontFamily;
+            fontQuality: number;
+            fontStyle: import("../../../mol-geo/geometry/text/font-atlas").FontStyle;
+            fontVariant: import("../../../mol-geo/geometry/text/font-atlas").FontVariant;
+            fontWeight: import("../../../mol-geo/geometry/text/font-atlas").FontWeight;
+            alpha: number;
+            quality: "auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest";
+            material: PD.Normalize<{
+                metalness: number;
+                roughness: number;
+                bumpiness: number;
+            }>;
+            clip: PD.Normalize<{
+                variant: any;
+                objects: any;
+            }>;
+            emissive: number;
+            instanceGranularity: boolean;
+            lod: import("../../../mol-math/linear-algebra").Vec3;
+            cellSize: number;
+            batchSize: number;
+            lineSizeAttenuation: boolean;
+            linesColor: Color;
+            linesSize: number;
+            dashLength: number;
+        }>>>;
+    } | undefined>;
     addAngle(a: StructureElement.Loci, b: StructureElement.Loci, c: StructureElement.Loci, options?: StructureMeasurementManagerAddOptions & {
         visualParams?: Partial<StateTransformer.Params<typeof StateTransforms.Representation.StructureSelectionsAngle3D>>;
-    }): Promise<void>;
+    }): Promise<{
+        selection: import("../../../mol-state").StateObjectSelector<PluginStateObject.Molecule.Structure.Selections, StateTransformer<PluginStateObject.Root, PluginStateObject.Molecule.Structure.Selections, PD.Normalize<{
+            selections: PD.Normalize<{
+                key: any;
+                ref: any;
+                groupId: any;
+                expression: any;
+            }>[];
+            isTransitive: boolean | undefined;
+            label: string | undefined;
+        }>>>;
+        representation: import("../../../mol-state").StateObjectSelector<PluginStateObject.Shape.Representation3D, StateTransformer<PluginStateObject.Molecule.Structure.Selections, PluginStateObject.Shape.Representation3D, PD.Normalize<{
+            visuals: ("text" | "vectors" | "sector" | "arc")[];
+            borderWidth: number;
+            customText: string;
+            textColor: Color;
+            textSize: number;
+            sizeFactor: number;
+            borderColor: Color;
+            offsetX: number;
+            offsetY: number;
+            offsetZ: number;
+            background: boolean;
+            backgroundMargin: number;
+            backgroundColor: Color;
+            backgroundOpacity: number;
+            tether: boolean;
+            tetherLength: number;
+            tetherBaseWidth: number;
+            attachment: "bottom-left" | "bottom-center" | "bottom-right" | "middle-left" | "middle-center" | "middle-right" | "top-left" | "top-center" | "top-right";
+            fontFamily: import("../../../mol-geo/geometry/text/font-atlas").FontFamily;
+            fontQuality: number;
+            fontStyle: import("../../../mol-geo/geometry/text/font-atlas").FontStyle;
+            fontVariant: import("../../../mol-geo/geometry/text/font-atlas").FontVariant;
+            fontWeight: import("../../../mol-geo/geometry/text/font-atlas").FontWeight;
+            alpha: number;
+            quality: "auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest";
+            material: PD.Normalize<{
+                metalness: number;
+                roughness: number;
+                bumpiness: number;
+            }>;
+            clip: PD.Normalize<{
+                variant: any;
+                objects: any;
+            }>;
+            emissive: number;
+            instanceGranularity: boolean;
+            lod: import("../../../mol-math/linear-algebra").Vec3;
+            cellSize: number;
+            batchSize: number;
+            ignoreLight: boolean;
+            sectorOpacity: number;
+            color: Color;
+            arcScale: number;
+            doubleSided: boolean;
+            flipSided: boolean;
+            flatShaded: boolean;
+            xrayShaded: boolean | "inverted";
+            transparentBackfaces: "on" | "off" | "opaque";
+            bumpFrequency: number;
+            bumpAmplitude: number;
+            lineSizeAttenuation: boolean;
+            linesSize: number;
+            dashLength: number;
+        }>>>;
+    } | undefined>;
     addDihedral(a: StructureElement.Loci, b: StructureElement.Loci, c: StructureElement.Loci, d: StructureElement.Loci, options?: StructureMeasurementManagerAddOptions & {
         visualParams?: Partial<StateTransformer.Params<typeof StateTransforms.Representation.StructureSelectionsDihedral3D>>;
-    }): Promise<void>;
+    }): Promise<{
+        selection: import("../../../mol-state").StateObjectSelector<PluginStateObject.Molecule.Structure.Selections, StateTransformer<PluginStateObject.Root, PluginStateObject.Molecule.Structure.Selections, PD.Normalize<{
+            selections: PD.Normalize<{
+                key: any;
+                ref: any;
+                groupId: any;
+                expression: any;
+            }>[];
+            isTransitive: boolean | undefined;
+            label: string | undefined;
+        }>>>;
+        representation: import("../../../mol-state").StateObjectSelector<PluginStateObject.Shape.Representation3D, StateTransformer<PluginStateObject.Molecule.Structure.Selections, PluginStateObject.Shape.Representation3D, PD.Normalize<{
+            visuals: ("text" | "vectors" | "sector" | "arc" | "extenders" | "arms" | "connector")[];
+            borderWidth: number;
+            customText: string;
+            textColor: Color;
+            textSize: number;
+            sizeFactor: number;
+            borderColor: Color;
+            offsetX: number;
+            offsetY: number;
+            offsetZ: number;
+            background: boolean;
+            backgroundMargin: number;
+            backgroundColor: Color;
+            backgroundOpacity: number;
+            tether: boolean;
+            tetherLength: number;
+            tetherBaseWidth: number;
+            attachment: "bottom-left" | "bottom-center" | "bottom-right" | "middle-left" | "middle-center" | "middle-right" | "top-left" | "top-center" | "top-right";
+            fontFamily: import("../../../mol-geo/geometry/text/font-atlas").FontFamily;
+            fontQuality: number;
+            fontStyle: import("../../../mol-geo/geometry/text/font-atlas").FontStyle;
+            fontVariant: import("../../../mol-geo/geometry/text/font-atlas").FontVariant;
+            fontWeight: import("../../../mol-geo/geometry/text/font-atlas").FontWeight;
+            alpha: number;
+            quality: "auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest";
+            material: PD.Normalize<{
+                metalness: number;
+                roughness: number;
+                bumpiness: number;
+            }>;
+            clip: PD.Normalize<{
+                variant: any;
+                objects: any;
+            }>;
+            emissive: number;
+            instanceGranularity: boolean;
+            lod: import("../../../mol-math/linear-algebra").Vec3;
+            cellSize: number;
+            batchSize: number;
+            ignoreLight: boolean;
+            sectorOpacity: number;
+            color: Color;
+            arcScale: number;
+            doubleSided: boolean;
+            flipSided: boolean;
+            flatShaded: boolean;
+            xrayShaded: boolean | "inverted";
+            transparentBackfaces: "on" | "off" | "opaque";
+            bumpFrequency: number;
+            bumpAmplitude: number;
+            lineSizeAttenuation: boolean;
+            linesSize: number;
+            dashLength: number;
+        }>>>;
+    } | undefined>;
     addLabel(a: StructureElement.Loci, options?: Omit<StructureMeasurementManagerAddOptions, 'customText' | 'lineParams'> & {
         visualParams?: Partial<StateTransformer.Params<typeof StateTransforms.Representation.StructureSelectionsLabel3D>>;
-    }): Promise<void>;
-    addOrientation(locis: StructureElement.Loci[]): Promise<void>;
-    addPlane(locis: StructureElement.Loci[]): Promise<void>;
-    addOrderLabels(locis: StructureElement.Loci[]): Promise<void>;
+    }): Promise<{
+        selection: import("../../../mol-state").StateObjectSelector<PluginStateObject.Molecule.Structure.Selections, StateTransformer<PluginStateObject.Root, PluginStateObject.Molecule.Structure.Selections, PD.Normalize<{
+            selections: PD.Normalize<{
+                key: any;
+                ref: any;
+                groupId: any;
+                expression: any;
+            }>[];
+            isTransitive: boolean | undefined;
+            label: string | undefined;
+        }>>>;
+        representation: import("../../../mol-state").StateObjectSelector<PluginStateObject.Shape.Representation3D, StateTransformer<PluginStateObject.Molecule.Structure.Selections, PluginStateObject.Shape.Representation3D, PD.Normalize<{
+            scaleByRadius: boolean;
+            visuals: "text"[];
+            snapshotKey: string;
+            tooltip: string;
+            borderWidth: number;
+            customText: string;
+            textColor: Color;
+            textSize: number;
+            sizeFactor: number;
+            borderColor: Color;
+            offsetX: number;
+            offsetY: number;
+            offsetZ: number;
+            background: boolean;
+            backgroundMargin: number;
+            backgroundColor: Color;
+            backgroundOpacity: number;
+            tether: boolean;
+            tetherLength: number;
+            tetherBaseWidth: number;
+            attachment: "bottom-left" | "bottom-center" | "bottom-right" | "middle-left" | "middle-center" | "middle-right" | "top-left" | "top-center" | "top-right";
+            fontFamily: import("../../../mol-geo/geometry/text/font-atlas").FontFamily;
+            fontQuality: number;
+            fontStyle: import("../../../mol-geo/geometry/text/font-atlas").FontStyle;
+            fontVariant: import("../../../mol-geo/geometry/text/font-atlas").FontVariant;
+            fontWeight: import("../../../mol-geo/geometry/text/font-atlas").FontWeight;
+            alpha: number;
+            quality: "auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest";
+            material: PD.Normalize<{
+                metalness: number;
+                roughness: number;
+                bumpiness: number;
+            }>;
+            clip: PD.Normalize<{
+                variant: any;
+                objects: any;
+            }>;
+            emissive: number;
+            instanceGranularity: boolean;
+            lod: import("../../../mol-math/linear-algebra").Vec3;
+            cellSize: number;
+            batchSize: number;
+        }>>>;
+    } | undefined>;
+    addOrientation(locis: StructureElement.Loci[]): Promise<{
+        selection: import("../../../mol-state").StateObjectSelector<PluginStateObject.Molecule.Structure.Selections, StateTransformer<PluginStateObject.Root, PluginStateObject.Molecule.Structure.Selections, PD.Normalize<{
+            selections: PD.Normalize<{
+                key: any;
+                ref: any;
+                groupId: any;
+                expression: any;
+            }>[];
+            isTransitive: boolean | undefined;
+            label: string | undefined;
+        }>>>;
+        representation: import("../../../mol-state").StateObjectSelector<PluginStateObject.Shape.Representation3D, StateTransformer<PluginStateObject.Molecule.Structure.Selections, PluginStateObject.Shape.Representation3D, PD.Normalize<{
+            visuals: ("box" | "axes" | "ellipsoid")[];
+            color: Color;
+            scaleFactor: number;
+            radiusScale: number;
+            doubleSided: boolean;
+            flipSided: boolean;
+            flatShaded: boolean;
+            ignoreLight: boolean;
+            xrayShaded: boolean | "inverted";
+            transparentBackfaces: "on" | "off" | "opaque";
+            bumpFrequency: number;
+            bumpAmplitude: number;
+            alpha: number;
+            quality: "auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest";
+            material: PD.Normalize<{
+                metalness: number;
+                roughness: number;
+                bumpiness: number;
+            }>;
+            clip: PD.Normalize<{
+                variant: any;
+                objects: any;
+            }>;
+            emissive: number;
+            instanceGranularity: boolean;
+            lod: import("../../../mol-math/linear-algebra").Vec3;
+            cellSize: number;
+            batchSize: number;
+        }>>>;
+    } | undefined>;
+    addPlane(locis: StructureElement.Loci[]): Promise<{
+        selection: import("../../../mol-state").StateObjectSelector<PluginStateObject.Molecule.Structure.Selections, StateTransformer<PluginStateObject.Root, PluginStateObject.Molecule.Structure.Selections, PD.Normalize<{
+            selections: PD.Normalize<{
+                key: any;
+                ref: any;
+                groupId: any;
+                expression: any;
+            }>[];
+            isTransitive: boolean | undefined;
+            label: string | undefined;
+        }>>>;
+        representation: import("../../../mol-state").StateObjectSelector<PluginStateObject.Shape.Representation3D, StateTransformer<PluginStateObject.Molecule.Structure.Selections, PluginStateObject.Shape.Representation3D, PD.Normalize<{
+            visuals: "plane"[];
+            color: Color;
+            scaleFactor: number;
+            doubleSided: boolean;
+            flipSided: boolean;
+            flatShaded: boolean;
+            ignoreLight: boolean;
+            xrayShaded: boolean | "inverted";
+            transparentBackfaces: "on" | "off" | "opaque";
+            bumpFrequency: number;
+            bumpAmplitude: number;
+            alpha: number;
+            quality: "auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest";
+            material: PD.Normalize<{
+                metalness: number;
+                roughness: number;
+                bumpiness: number;
+            }>;
+            clip: PD.Normalize<{
+                variant: any;
+                objects: any;
+            }>;
+            emissive: number;
+            instanceGranularity: boolean;
+            lod: import("../../../mol-math/linear-algebra").Vec3;
+            cellSize: number;
+            batchSize: number;
+        }>>>;
+    } | undefined>;
+    addOrderLabels(locis: StructureElement.Loci[]): Promise<{
+        representation: import("../../../mol-state").StateObjectSelector<StateObject<any, StateObject.Type<any>>, StateTransformer<StateObject<any, StateObject.Type<any>>, StateObject<any, StateObject.Type<any>>, any>> | import("../../../mol-state").StateObjectSelector<StateObject<any, StateObject.Type<any>>, StateTransformer<never, PluginStateObject.Group, PD.Normalize<{
+            label: string;
+            description: string | undefined;
+        }>>>;
+    }>;
     private _empty;
     private getTransforms;
     private sync;

package/lib/commonjs/mol-plugin-state/manager/structure/measurement.js

@@ -1,9 +1,10 @@
 "use strict";
 /**
- * Copyright (c) 2019-2021 mol* contributors, licensed under MIT, See LICENSE file for more info.
+ * Copyright (c) 2019-2024 mol* contributors, licensed under MIT, See LICENSE file for more info.
  *
  * @author David Sehnal <david.sehnal@gmail.com>
  * @author Alexander Rose <alexander.rose@weirdbyte.de>
+ * @author Ryan DiRisio <rjdiris@gmail.com>
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StructureMeasurementParams = exports.MeasurementOrderLabelTag = exports.MeasurementGroupTag = exports.StructureMeasurementManager = void 0;
@@ -67,7 +68,7 @@ class StructureMeasurementManager extends component_1.StatefulPluginComponent {
         const dependsOn = [cellA.transform.ref];
         (0, array_1.arraySetAdd)(dependsOn, cellB.transform.ref);
         const update = this.getGroup();
-        update
+        const selection = update
             .apply(transforms_1.StateTransforms.Model.MultiStructureSelectionFromExpression, {
             selections: [
                 { key: 'a', groupId: 'a', ref: cellA.transform.ref, expression: structure_1.StructureElement.Loci.toExpression(a) },
@@ -75,7 +76,8 @@ class StructureMeasurementManager extends component_1.StatefulPluginComponent {
             ],
             isTransitive: true,
             label: 'Distance'
-        }, { dependsOn, tags: options === null || options === void 0 ? void 0 : options.selectionTags })
+        }, { dependsOn, tags: options === null || options === void 0 ? void 0 : options.selectionTags });
+        const representation = selection
             .apply(transforms_1.StateTransforms.Representation.StructureSelectionsDistance3D, {
             customText: (options === null || options === void 0 ? void 0 : options.customText) || '',
             unitLabel: this.state.options.distanceUnitLabel,
@@ -85,7 +87,8 @@ class StructureMeasurementManager extends component_1.StatefulPluginComponent {
             ...options === null || options === void 0 ? void 0 : options.visualParams
         }, { tags: options === null || options === void 0 ? void 0 : options.reprTags });
         const state = this.plugin.state.data;
-        await commands_1.PluginCommands.State.Update(this.plugin, { state, tree: update, options: { doNotLogTiming: true } });
+        await commands_1.PluginCommands.State.Update(this.plugin, { state, tree: representation, options: { doNotLogTiming: true } });
+        return { selection: selection.selector, representation: representation.selector };
     }
     async addAngle(a, b, c, options) {
         const cellA = this.plugin.helpers.substructureParent.get(a.structure);
@@ -97,7 +100,7 @@ class StructureMeasurementManager extends component_1.StatefulPluginComponent {
         (0, array_1.arraySetAdd)(dependsOn, cellB.transform.ref);
         (0, array_1.arraySetAdd)(dependsOn, cellC.transform.ref);
         const update = this.getGroup();
-        update
+        const selection = update
             .apply(transforms_1.StateTransforms.Model.MultiStructureSelectionFromExpression, {
             selections: [
                 { key: 'a', ref: cellA.transform.ref, expression: structure_1.StructureElement.Loci.toExpression(a) },
@@ -106,7 +109,8 @@ class StructureMeasurementManager extends component_1.StatefulPluginComponent {
             ],
             isTransitive: true,
             label: 'Angle'
-        }, { dependsOn, tags: options === null || options === void 0 ? void 0 : options.selectionTags })
+        }, { dependsOn, tags: options === null || options === void 0 ? void 0 : options.selectionTags });
+        const representation = selection
             .apply(transforms_1.StateTransforms.Representation.StructureSelectionsAngle3D, {
             customText: (options === null || options === void 0 ? void 0 : options.customText) || '',
             textColor: this.state.options.textColor,
@@ -115,7 +119,8 @@ class StructureMeasurementManager extends component_1.StatefulPluginComponent {
             ...options === null || options === void 0 ? void 0 : options.visualParams
         }, { tags: options === null || options === void 0 ? void 0 : options.reprTags });
         const state = this.plugin.state.data;
-        await commands_1.PluginCommands.State.Update(this.plugin, { state, tree: update, options: { doNotLogTiming: true } });
+        await commands_1.PluginCommands.State.Update(this.plugin, { state, tree: representation, options: { doNotLogTiming: true } });
+        return { selection: selection.selector, representation: representation.selector };
     }
     async addDihedral(a, b, c, d, options) {
         const cellA = this.plugin.helpers.substructureParent.get(a.structure);
@@ -129,7 +134,7 @@ class StructureMeasurementManager extends component_1.StatefulPluginComponent {
         (0, array_1.arraySetAdd)(dependsOn, cellC.transform.ref);
         (0, array_1.arraySetAdd)(dependsOn, cellD.transform.ref);
         const update = this.getGroup();
-        update
+        const selection = update
             .apply(transforms_1.StateTransforms.Model.MultiStructureSelectionFromExpression, {
             selections: [
                 { key: 'a', ref: cellA.transform.ref, expression: structure_1.StructureElement.Loci.toExpression(a) },
@@ -139,8 +144,8 @@ class StructureMeasurementManager extends component_1.StatefulPluginComponent {
             ],
             isTransitive: true,
             label: 'Dihedral'
-        }, { dependsOn, tags: options === null || options === void 0 ? void 0 : options.selectionTags })
-            .apply(transforms_1.StateTransforms.Representation.StructureSelectionsDihedral3D, {
+        }, { dependsOn, tags: options === null || options === void 0 ? void 0 : options.selectionTags });
+        const representation = selection.apply(transforms_1.StateTransforms.Representation.StructureSelectionsDihedral3D, {
             customText: (options === null || options === void 0 ? void 0 : options.customText) || '',
             textColor: this.state.options.textColor,
             ...options === null || options === void 0 ? void 0 : options.lineParams,
@@ -148,7 +153,8 @@ class StructureMeasurementManager extends component_1.StatefulPluginComponent {
             ...options === null || options === void 0 ? void 0 : options.visualParams
         }, { tags: options === null || options === void 0 ? void 0 : options.reprTags });
         const state = this.plugin.state.data;
-        await commands_1.PluginCommands.State.Update(this.plugin, { state, tree: update, options: { doNotLogTiming: true } });
+        await commands_1.PluginCommands.State.Update(this.plugin, { state, tree: representation, options: { doNotLogTiming: true } });
+        return { selection: selection.selector, representation: representation.selector };
     }
     async addLabel(a, options) {
         const cellA = this.plugin.helpers.substructureParent.get(a.structure);
@@ -156,21 +162,23 @@ class StructureMeasurementManager extends component_1.StatefulPluginComponent {
             return;
         const dependsOn = [cellA.transform.ref];
         const update = this.getGroup();
-        update
+        const selection = update
             .apply(transforms_1.StateTransforms.Model.MultiStructureSelectionFromExpression, {
             selections: [
                 { key: 'a', ref: cellA.transform.ref, expression: structure_1.StructureElement.Loci.toExpression(a) },
             ],
             isTransitive: true,
             label: 'Label'
-        }, { dependsOn, tags: options === null || options === void 0 ? void 0 : options.selectionTags })
+        }, { dependsOn, tags: options === null || options === void 0 ? void 0 : options.selectionTags });
+        const representation = selection
             .apply(transforms_1.StateTransforms.Representation.StructureSelectionsLabel3D, {
             textColor: this.state.options.textColor,
             ...options === null || options === void 0 ? void 0 : options.labelParams,
             ...options === null || options === void 0 ? void 0 : options.visualParams
         }, { tags: options === null || options === void 0 ? void 0 : options.reprTags });
         const state = this.plugin.state.data;
-        await commands_1.PluginCommands.State.Update(this.plugin, { state, tree: update, options: { doNotLogTiming: true } });
+        await commands_1.PluginCommands.State.Update(this.plugin, { state, tree: representation, options: { doNotLogTiming: true } });
+        return { selection: selection.selector, representation: representation.selector };
     }
     async addOrientation(locis) {
         const selections = [];
@@ -186,15 +194,17 @@ class StructureMeasurementManager extends component_1.StatefulPluginComponent {
         if (selections.length === 0)
             return;
         const update = this.getGroup();
-        update
+        const selection = update
             .apply(transforms_1.StateTransforms.Model.MultiStructureSelectionFromExpression, {
             selections,
             isTransitive: true,
             label: 'Orientation'
-        }, { dependsOn })
+        }, { dependsOn });
+        const representation = selection
             .apply(transforms_1.StateTransforms.Representation.StructureSelectionsOrientation3D);
         const state = this.plugin.state.data;
-        await commands_1.PluginCommands.State.Update(this.plugin, { state, tree: update, options: { doNotLogTiming: true } });
+        await commands_1.PluginCommands.State.Update(this.plugin, { state, tree: representation, options: { doNotLogTiming: true } });
+        return { selection: selection.selector, representation: representation.selector };
     }
     async addPlane(locis) {
         const selections = [];
@@ -210,15 +220,17 @@ class StructureMeasurementManager extends component_1.StatefulPluginComponent {
         if (selections.length === 0)
             return;
         const update = this.getGroup();
-        update
+        const selection = update
             .apply(transforms_1.StateTransforms.Model.MultiStructureSelectionFromExpression, {
             selections,
             isTransitive: true,
             label: 'Plane'
-        }, { dependsOn })
+        }, { dependsOn });
+        const representation = selection
             .apply(transforms_1.StateTransforms.Representation.StructureSelectionsPlane3D);
         const state = this.plugin.state.data;
         await commands_1.PluginCommands.State.Update(this.plugin, { state, tree: update, options: { doNotLogTiming: true } });
+        return { selection: selection.selector, representation: representation.selector };
     }
     async addOrderLabels(locis) {
         const update = this.getGroup();
@@ -250,6 +262,7 @@ class StructureMeasurementManager extends component_1.StatefulPluginComponent {
         }
         const state = this.plugin.state.data;
         await commands_1.PluginCommands.State.Update(this.plugin, { state, tree: update, options: { doNotLogTiming: true } });
+        return { representation: update.selector };
     }
     getTransforms(transformer) {
         const state = this.plugin.state.data;

package/lib/commonjs/mol-plugin-state/manager/structure/selection.d.ts

@@ -70,7 +70,7 @@ export declare class StructureSelectionManager extends StatefulPluginComponent<S
             min: Vec3;
             max: Vec3;
         };
-        sphere: import("../../../mol-math/geometry/primitives/sphere3d").Sphere3D;
+        sphere: import("../../../mol-math/geometry").Sphere3D;
     };
     getPrincipalAxes(): PrincipalAxes;
     modify(modifier: StructureSelectionModifier, loci: Loci): void;

package/lib/commonjs/mol-plugin-state/manager/volume/hierarchy.d.ts

@@ -22,7 +22,7 @@ export declare class VolumeHierarchyManager extends PluginComponent {
     setCurrent(volume?: VolumeRef): void;
     remove(refs: (VolumeHierarchyRef | string)[], canUndo?: boolean): Promise<void> | undefined;
     toggleVisibility(refs: ReadonlyArray<VolumeHierarchyRef>, action?: 'show' | 'hide'): void;
-    addRepresentation(ref: VolumeRef, type: string): Promise<import("../../../mol-state").StateObjectSelector<import("../../objects").PluginStateObject.Volume.Representation3D, import("../../../mol-state/transformer").StateTransformer<import("../../../mol-state/object").StateObject<any, import("../../../mol-state/object").StateObject.Type<any>>, import("../../../mol-state/object").StateObject<any, import("../../../mol-state/object").StateObject.Type<any>>, any>>>;
+    addRepresentation(ref: VolumeRef, type: string): Promise<import("../../../mol-state").StateObjectSelector<import("../../objects").PluginStateObject.Volume.Representation3D, import("../../../mol-state").StateTransformer<import("../../../mol-state").StateObject<any, import("../../../mol-state").StateObject.Type<any>>, import("../../../mol-state").StateObject<any, import("../../../mol-state").StateObject.Type<any>>, any>>>;
     constructor(plugin: PluginContext);
 }
 export declare namespace VolumeHierarchyManager {