molstar 4.0.1 → 4.2.0

package/lib/commonjs/extensions/meshes/mesh-extension.d.ts

@@ -39,17 +39,16 @@ declare const MeshlistStateObject_base: {
         label: string;
         description?: string | undefined;
     } | undefined): {
-        id: import("../../mol-util/uuid").UUID;
+        id: import("../../mol-util").UUID;
         /** Data type for `MeshlistStateObject` - list of meshes */
         type: PluginStateObject.TypeInfo;
         /** Data type for `MeshlistStateObject` - list of meshes */
         label: string;
-        /** Data type for `MeshlistStateObject` - list of meshes */
         description?: string | undefined;
         data: MeshlistData;
     };
     type: PluginStateObject.TypeInfo;
-    is(obj?: import("../../mol-state/object").StateObject<any, import("../../mol-state/object").StateObject.Type<any>> | undefined): obj is import("../../mol-state/object").StateObject<MeshlistData, PluginStateObject.TypeInfo>;
+    is(obj?: import("../../mol-state").StateObject<any, import("../../mol-state").StateObject.Type<any>> | undefined): obj is import("../../mol-state").StateObject<MeshlistData, PluginStateObject.TypeInfo>;
 };
 export declare class MeshlistStateObject extends MeshlistStateObject_base {
 }

package/lib/commonjs/extensions/meshes/mesh-streaming/behavior.d.ts

@@ -27,7 +27,7 @@ declare const MeshStreaming_base: {
         data: MeshStreaming.Behavior;
     };
     type: PluginStateObject.TypeInfo;
-    is(obj?: import("../../../mol-state/object").StateObject<any, import("../../../mol-state/object").StateObject.Type<any>> | undefined): obj is import("../../../mol-state/object").StateObject<MeshStreaming.Behavior, PluginStateObject.TypeInfo>;
+    is(obj?: import("../../../mol-state").StateObject<any, import("../../../mol-state").StateObject.Type<any>> | undefined): obj is import("../../../mol-state").StateObject<MeshStreaming.Behavior, PluginStateObject.TypeInfo>;
 };
 export declare class MeshStreaming extends MeshStreaming_base {
 }

package/lib/commonjs/extensions/meshes/mesh-streaming/server-info.d.ts

@@ -16,7 +16,7 @@ declare const MeshServerInfo_base: {
         label: string;
         description?: string | undefined;
     } | undefined): {
-        id: import("../../../mol-util/uuid").UUID;
+        id: import("../../../mol-util").UUID;
         type: PluginStateObject.TypeInfo;
         label: string;
         description?: string | undefined;
@@ -27,7 +27,7 @@ declare const MeshServerInfo_base: {
         }>;
     };
     type: PluginStateObject.TypeInfo;
-    is(obj?: import("../../../mol-state/object").StateObject<any, import("../../../mol-state/object").StateObject.Type<any>> | undefined): obj is import("../../../mol-state/object").StateObject<PD.Values<{
+    is(obj?: import("../../../mol-state").StateObject<any, import("../../../mol-state").StateObject.Type<any>> | undefined): obj is import("../../../mol-state").StateObject<PD.Values<{
         serverUrl: PD.Text<string>;
         source: PD.Select<"emdb" | "empiar">;
         entryId: PD.Text<string>;

package/lib/commonjs/extensions/model-archive/quality-assessment/behavior.d.ts

@@ -6,7 +6,7 @@
 import { ParamDefinition as PD } from '../../../mol-util/param-definition';
 import { PluginBehavior } from '../../../mol-plugin/behavior/behavior';
 import { StructureRepresentationPresetProvider } from '../../../mol-plugin-state/builder/structure/representation-preset';
-export declare const MAQualityAssessment: import("../../../mol-state/transformer").StateTransformer<PluginBehavior.Category, PluginBehavior.Behavior, {
+export declare const MAQualityAssessment: import("../../../mol-state").StateTransformer<PluginBehavior.Category, PluginBehavior.Behavior, {
     autoAttach: boolean;
     showTooltip: boolean;
 }>;
@@ -28,18 +28,18 @@ export declare const QualityAssessmentPLDDTPreset: StructureRepresentationPreset
     representations?: undefined;
 } | {
     components: {
-        polymer: import("../../../mol-state").StateObjectSelector<import("../../../mol-plugin-state/objects").PluginStateObject.Molecule.Structure, 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>> | undefined;
+        polymer: import("../../../mol-state").StateObjectSelector<import("../../../mol-plugin-state/objects").PluginStateObject.Molecule.Structure, 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>> | undefined;
     };
     representations: {
-        polymer: import("../../../mol-state").StateObjectSelector<import("../../../mol-plugin-state/objects").PluginStateObject.Molecule.Structure.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>>;
+        polymer: import("../../../mol-state").StateObjectSelector<import("../../../mol-plugin-state/objects").PluginStateObject.Molecule.Structure.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>>;
     };
 } | {
     components: {
-        all: import("../../../mol-state").StateObjectSelector<import("../../../mol-plugin-state/objects").PluginStateObject.Molecule.Structure, 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>> | undefined;
+        all: import("../../../mol-state").StateObjectSelector<import("../../../mol-plugin-state/objects").PluginStateObject.Molecule.Structure, 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>> | undefined;
         branched: undefined;
     };
     representations: {
-        all: import("../../../mol-state").StateObjectSelector<import("../../../mol-plugin-state/objects").PluginStateObject.Molecule.Structure.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>>;
+        all: import("../../../mol-state").StateObjectSelector<import("../../../mol-plugin-state/objects").PluginStateObject.Molecule.Structure.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>>;
     };
 }>;
 export declare const QualityAssessmentQmeanPreset: StructureRepresentationPresetProvider<{
@@ -60,17 +60,17 @@ export declare const QualityAssessmentQmeanPreset: StructureRepresentationPreset
     representations?: undefined;
 } | {
     components: {
-        polymer: import("../../../mol-state").StateObjectSelector<import("../../../mol-plugin-state/objects").PluginStateObject.Molecule.Structure, 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>> | undefined;
+        polymer: import("../../../mol-state").StateObjectSelector<import("../../../mol-plugin-state/objects").PluginStateObject.Molecule.Structure, 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>> | undefined;
     };
     representations: {
-        polymer: import("../../../mol-state").StateObjectSelector<import("../../../mol-plugin-state/objects").PluginStateObject.Molecule.Structure.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>>;
+        polymer: import("../../../mol-state").StateObjectSelector<import("../../../mol-plugin-state/objects").PluginStateObject.Molecule.Structure.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>>;
     };
 } | {
     components: {
-        all: import("../../../mol-state").StateObjectSelector<import("../../../mol-plugin-state/objects").PluginStateObject.Molecule.Structure, 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>> | undefined;
+        all: import("../../../mol-state").StateObjectSelector<import("../../../mol-plugin-state/objects").PluginStateObject.Molecule.Structure, 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>> | undefined;
         branched: undefined;
     };
     representations: {
-        all: import("../../../mol-state").StateObjectSelector<import("../../../mol-plugin-state/objects").PluginStateObject.Molecule.Structure.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>>;
+        all: import("../../../mol-state").StateObjectSelector<import("../../../mol-plugin-state/objects").PluginStateObject.Molecule.Structure.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>>;
     };
 }>;

package/lib/commonjs/extensions/model-export/index.d.ts

@@ -4,4 +4,4 @@
  * @author David Sehnal <david.sehnal@gmail.com>
  */
 import { PluginBehavior } from '../../mol-plugin/behavior/behavior';
-export declare const ModelExport: import("../../mol-state/transformer").StateTransformer<PluginBehavior.Category, PluginBehavior.Behavior, {}>;
+export declare const ModelExport: import("../../mol-state").StateTransformer<PluginBehavior.Category, PluginBehavior.Behavior, {}>;

package/lib/commonjs/extensions/mp4-export/index.d.ts

@@ -4,4 +4,4 @@
  * @author David Sehnal <david.sehnal@gmail.com>
  */
 import { PluginBehavior } from '../../mol-plugin/behavior/behavior';
-export declare const Mp4Export: import("../../mol-state/transformer").StateTransformer<PluginBehavior.Category, PluginBehavior.Behavior, {}>;
+export declare const Mp4Export: import("../../mol-state").StateTransformer<PluginBehavior.Category, PluginBehavior.Behavior, {}>;

package/lib/commonjs/extensions/mvs/behavior.d.ts

@@ -5,6 +5,6 @@
  */
 import { PluginBehavior } from '../../mol-plugin/behavior/behavior';
 /** Registers everything needed for loading MolViewSpec files */
-export declare const MolViewSpec: import("../../mol-state/transformer").StateTransformer<PluginBehavior.Category, PluginBehavior.Behavior, {
+export declare const MolViewSpec: import("../../mol-state").StateTransformer<PluginBehavior.Category, PluginBehavior.Behavior, {
     autoAttach: boolean;
 }>;

package/lib/commonjs/extensions/mvs/camera.d.ts

@@ -7,6 +7,8 @@ import { PluginContext } from '../../mol-plugin/context';
 import { StateObjectSelector } from '../../mol-state';
 import { ParamsOfKind } from './tree/generic/tree-schema';
 import { MolstarTree } from './tree/molstar/molstar-tree';
+/** Set the camera position to the current position (thus suppress automatic adjustment). */
+export declare function suppressCameraAutoreset(plugin: PluginContext): Promise<void>;
 /** Set the camera based on a camera node params. */
 export declare function setCamera(plugin: PluginContext, params: ParamsOfKind<MolstarTree, 'camera'>): Promise<void>;
 /** Focus the camera on the bounding sphere of a (sub)structure (or on the whole scene if `structureNodeSelector` is null).

package/lib/commonjs/extensions/mvs/camera.js

@@ -5,7 +5,8 @@
  * @author Adam Midlik <midlik@gmail.com>
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setCanvas = exports.setFocus = exports.setCamera = void 0;
+exports.setCanvas = exports.setFocus = exports.setCamera = exports.suppressCameraAutoreset = void 0;
+const canvas3d_1 = require("../../mol-canvas3d/canvas3d");
 const boundary_helper_1 = require("../../mol-math/geometry/boundary-helper");
 const linear_algebra_1 = require("../../mol-math/linear-algebra");
 const loci_1 = require("../../mol-model/loci");
@@ -22,6 +23,14 @@ const DefaultFocusOptions = {
 };
 const DefaultCanvasBackgroundColor = names_1.ColorNames.white;
 const _tmpVec = (0, linear_algebra_1.Vec3)();
+/** Set the camera position to the current position (thus suppress automatic adjustment). */
+async function suppressCameraAutoreset(plugin) {
+    var _a;
+    const snapshot = { ...(_a = plugin.canvas3d) === null || _a === void 0 ? void 0 : _a.camera.state, radius: Infinity }; // `radius: Infinity` avoids clipping when the scene expands
+    adjustSceneRadiusFactor(plugin, snapshot.target);
+    await commands_1.PluginCommands.Camera.SetSnapshot(plugin, { snapshot });
+}
+exports.suppressCameraAutoreset = suppressCameraAutoreset;
 /** Set the camera based on a camera node params. */
 async function setCamera(plugin, params) {
     const target = linear_algebra_1.Vec3.create(...params.target);
@@ -30,7 +39,8 @@ async function setCamera(plugin, params) {
         position = fovAdjustedPosition(target, position, plugin.canvas3d.camera.state.mode, plugin.canvas3d.camera.state.fov);
     const up = linear_algebra_1.Vec3.create(...params.up);
     linear_algebra_1.Vec3.orthogonalize(up, linear_algebra_1.Vec3.sub(_tmpVec, target, position), up);
-    const snapshot = { target, position, up, radius: 10000, 'radiusMax': 10000 };
+    const snapshot = { target, position, up, radius: Infinity }; // `radius: Infinity` avoids clipping (ensures covering the whole scene)
+    adjustSceneRadiusFactor(plugin, snapshot.target);
     await commands_1.PluginCommands.Camera.SetSnapshot(plugin, { snapshot });
 }
 exports.setCamera = setCamera;
@@ -61,10 +71,27 @@ async function setFocus(plugin, structureNodeSelector, params = mvs_defaults_1.M
             up,
             direction,
         });
+        resetSceneRadiusFactor(plugin);
         await commands_1.PluginCommands.Camera.SetSnapshot(plugin, { snapshot });
     }
 }
 exports.setFocus = setFocus;
+/** Adjust `sceneRadiusFactor` property so that the current scene is not cropped */
+function adjustSceneRadiusFactor(plugin, cameraTarget) {
+    var _a;
+    if (!cameraTarget)
+        return;
+    const boundingSphere = getPluginBoundingSphere(plugin);
+    const offset = linear_algebra_1.Vec3.distance(cameraTarget, boundingSphere.center);
+    const sceneRadiusFactor = boundingSphere.radius > 0 ? ((boundingSphere.radius + offset) / boundingSphere.radius) : 1;
+    (_a = plugin.canvas3d) === null || _a === void 0 ? void 0 : _a.setProps({ sceneRadiusFactor });
+}
+/** Reset `sceneRadiusFactor` property to the default value */
+function resetSceneRadiusFactor(plugin) {
+    var _a;
+    const sceneRadiusFactor = canvas3d_1.Canvas3DParams.sceneRadiusFactor.defaultValue;
+    (_a = plugin.canvas3d) === null || _a === void 0 ? void 0 : _a.setProps({ sceneRadiusFactor });
+}
 /** Return camera snapshot for focusing a sphere with given `center` and `radius`,
  * while ensuring given view `direction` (aligns with vector position->target)
  * and `up` (aligns with screen Y axis). */

package/lib/commonjs/extensions/mvs/components/annotation-label/representation.d.ts

@@ -51,6 +51,7 @@ export declare const MVSAnnotationLabelParams: {
     fontWeight: PD.Select<import("../../../../mol-geo/geometry/text/font-atlas").FontWeight>;
     background: PD.BooleanParam;
     borderWidth: PD.Numeric;
+    emissive: PD.Numeric;
     batchSize: PD.Numeric;
     material: PD.Group<PD.Normalize<{
         metalness: number;
@@ -76,6 +77,7 @@ export declare const MVSAnnotationLabelParams: {
     ignoreHydrogensVariant: PD.Select<"all" | "non-polar">;
     includeParent: PD.BooleanParam;
     unitKinds: PD.MultiSelect<"spheres" | "gaussians" | "atomic">;
+    /** Parameter values for representation type "MVS Annotation Label" */
     annotationId: PD.Text<string>;
     fieldName: PD.Text<string>;
 };
@@ -127,6 +129,7 @@ export declare const MVSAnnotationLabelRepresentationProvider: StructureRepresen
     fontWeight: PD.Select<import("../../../../mol-geo/geometry/text/font-atlas").FontWeight>;
     background: PD.BooleanParam;
     borderWidth: PD.Numeric;
+    emissive: PD.Numeric;
     batchSize: PD.Numeric;
     material: PD.Group<PD.Normalize<{
         metalness: number;
@@ -152,6 +155,7 @@ export declare const MVSAnnotationLabelRepresentationProvider: StructureRepresen
     ignoreHydrogensVariant: PD.Select<"all" | "non-polar">;
     includeParent: PD.BooleanParam;
     unitKinds: PD.MultiSelect<"spheres" | "gaussians" | "atomic">;
+    /** Parameter values for representation type "MVS Annotation Label" */
     annotationId: PD.Text<string>;
     fieldName: PD.Text<string>;
 }, "mvs-annotation-label">;

package/lib/commonjs/extensions/mvs/components/annotation-label/visual.d.ts

@@ -48,6 +48,7 @@ export declare const MVSAnnotationLabelTextParams: {
     fontWeight: PD.Select<import("../../../../mol-geo/geometry/text/font-atlas").FontWeight>;
     background: PD.BooleanParam;
     borderWidth: PD.Numeric;
+    emissive: PD.Numeric;
     batchSize: PD.Numeric;
     material: PD.Group<PD.Normalize<{
         metalness: number;

package/lib/commonjs/extensions/mvs/components/custom-label/representation.d.ts

@@ -15,7 +15,7 @@ export declare const CustomLabelParams: {
         defaultValue: import("../../../../mol-util/color").Color;
         type: "color";
         isExpanded?: boolean | undefined;
-        isOptional?: boolean | undefined; /** A thingy that is needed to register representation type "Custom Label", allowing user-defined labels at at user-defined positions */
+        isOptional?: boolean | undefined;
         label?: string | undefined;
         description?: string | undefined;
         legend?: import("../../../../mol-util/legend").Legend | undefined;
@@ -51,6 +51,7 @@ export declare const CustomLabelParams: {
     fontWeight: PD.Select<import("../../../../mol-geo/geometry/text/font-atlas").FontWeight>;
     background: PD.BooleanParam;
     borderWidth: PD.Numeric;
+    emissive: PD.Numeric;
     batchSize: PD.Numeric;
     material: PD.Group<PD.Normalize<{
         metalness: number;
@@ -100,7 +101,7 @@ export declare const CustomLabelRepresentationProvider: StructureRepresentationP
         defaultValue: import("../../../../mol-util/color").Color;
         type: "color";
         isExpanded?: boolean | undefined;
-        isOptional?: boolean | undefined; /** A thingy that is needed to register representation type "Custom Label", allowing user-defined labels at at user-defined positions */
+        isOptional?: boolean | undefined;
         label?: string | undefined;
         description?: string | undefined;
         legend?: import("../../../../mol-util/legend").Legend | undefined;
@@ -136,6 +137,7 @@ export declare const CustomLabelRepresentationProvider: StructureRepresentationP
     fontWeight: PD.Select<import("../../../../mol-geo/geometry/text/font-atlas").FontWeight>;
     background: PD.BooleanParam;
     borderWidth: PD.Numeric;
+    emissive: PD.Numeric;
     batchSize: PD.Numeric;
     material: PD.Group<PD.Normalize<{
         metalness: number;

package/lib/commonjs/extensions/mvs/components/custom-label/visual.d.ts

@@ -48,6 +48,7 @@ export declare const CustomLabelTextParams: {
     fontWeight: PD.Select<import("../../../../mol-geo/geometry/text/font-atlas").FontWeight>;
     background: PD.BooleanParam;
     borderWidth: PD.Numeric;
+    emissive: PD.Numeric;
     batchSize: PD.Numeric;
     material: PD.Group<PD.Normalize<{
         metalness: number;

package/lib/commonjs/extensions/mvs/components/formats.d.ts

@@ -18,7 +18,7 @@ declare const Mvs_base: {
         label: string;
         description?: string | undefined;
     } | undefined): {
-        id: import("../../../mol-util/uuid").UUID;
+        id: import("../../../mol-util").UUID;
         type: SO.TypeInfo;
         label: string;
         description?: string | undefined;
@@ -28,7 +28,7 @@ declare const Mvs_base: {
         };
     };
     type: SO.TypeInfo;
-    is(obj?: import("../../../mol-state/object").StateObject<any, import("../../../mol-state/object").StateObject.Type<any>> | undefined): obj is import("../../../mol-state/object").StateObject<{
+    is(obj?: import("../../../mol-state").StateObject<any, import("../../../mol-state").StateObject.Type<any>> | undefined): obj is import("../../../mol-state").StateObject<{
         mvsData: MVSData;
         sourceUrl?: string | undefined;
     }, SO.TypeInfo>;
@@ -37,18 +37,20 @@ declare const Mvs_base: {
 export declare class Mvs extends Mvs_base {
 }
 /** Transformer for parsing data in MVSJ format */
-export declare const ParseMVSJ: import("../../../mol-state/transformer").StateTransformer<SO.Data.String, Mvs, PD.Normalize<{}>>;
+export declare const ParseMVSJ: import("../../../mol-state").StateTransformer<SO.Data.String, Mvs, PD.Normalize<{}>>;
 /** Transformer for parsing data in MVSX format (= zipped MVSJ + referenced files like structures and annotations) */
-export declare const ParseMVSX: import("../../../mol-state/transformer").StateTransformer<SO.Data.Binary, Mvs, PD.Normalize<{
+export declare const ParseMVSX: import("../../../mol-state").StateTransformer<SO.Data.Binary, Mvs, PD.Normalize<{
     mainFilePath: string;
 }>>;
 /** Params for the `LoadMvsData` action */
 export declare const LoadMvsDataParams: {
     replaceExisting: PD.BooleanParam;
+    keepCamera: PD.BooleanParam;
 };
 /** State action which loads a MVS view into Mol* */
 export declare const LoadMvsData: StateAction<Mvs, void, PD.Normalize<{
     replaceExisting: boolean;
+    keepCamera: boolean;
 }>>;
 /** Data format provider for MVSJ format.
  * If Visuals:On, it will load the parsed MVS view;

package/lib/commonjs/extensions/mvs/components/formats.js

@@ -55,6 +55,7 @@ exports.ParseMVSX = (0, annotation_structure_component_1.MVSTransform)({
 /** Params for the `LoadMvsData` action */
 exports.LoadMvsDataParams = {
     replaceExisting: param_definition_1.ParamDefinition.Boolean(false, { description: 'If true, the loaded MVS view will replace the current state; if false, the MVS view will be added to the current state.' }),
+    keepCamera: param_definition_1.ParamDefinition.Boolean(false, { description: 'If true, any camera positioning from the MVS state will be ignored and the current camera position will be kept.' }),
 };
 /** State action which loads a MVS view into Mol* */
 exports.LoadMvsData = mol_state_1.StateAction.build({
@@ -63,7 +64,7 @@ exports.LoadMvsData = mol_state_1.StateAction.build({
     params: exports.LoadMvsDataParams,
 })(({ a, params }, plugin) => mol_task_1.Task.create('Load MVS Data', async () => {
     const { mvsData, sourceUrl } = a.data;
-    await (0, load_1.loadMVS)(plugin, mvsData, { replaceExisting: params.replaceExisting, sourceUrl: sourceUrl });
+    await (0, load_1.loadMVS)(plugin, mvsData, { replaceExisting: params.replaceExisting, keepCamera: params.keepCamera, sourceUrl: sourceUrl });
 }));
 /** Data format provider for MVSJ format.
  * If Visuals:On, it will load the parsed MVS view;

package/lib/commonjs/extensions/mvs/load-helpers.d.ts

@@ -48,7 +48,7 @@ export declare const UpdateTarget: {
     /** Create a new update, with `selector` pointing to the root. */
     create(plugin: PluginContext, replaceExisting: boolean): UpdateTarget;
     /** Add a child node to `target.selector`, return a new `UpdateTarget` pointing to the new child. */
-    apply<A extends StateObject<any, StateObject.Type<any>>, B extends StateObject<any, StateObject.Type<any>>, P extends {}>(target: UpdateTarget, transformer: StateTransformer<A, B, P>, params?: Partial<P> | undefined, options?: Partial<StateTransform.Options>): UpdateTarget;
+    apply<A extends StateObject<any, StateObject.Type<any>>, B extends StateObject<any, StateObject.Type<any>>, P extends {}>(target: UpdateTarget, transformer: StateTransformer<A, B, P>, params?: Partial<P>, options?: Partial<StateTransform.Options>): UpdateTarget;
     /** Delete all children of `target.selector`. */
     deleteChildren(target: UpdateTarget): UpdateTarget;
     /** Commit all changes done in the current update. */

package/lib/commonjs/extensions/mvs/load.d.ts

@@ -11,10 +11,12 @@ import { ParamsOfKind } from './tree/generic/tree-schema';
 import { MolstarNode, MolstarTree } from './tree/molstar/molstar-tree';
 /** Load a MolViewSpec (MVS) tree into the Mol* plugin.
  * If `options.replaceExisting`, remove all objects in the current Mol* state; otherwise add to the current state.
+ * If `options.keepCamera`, ignore any camera positioning from the MVS state and keep the current camera position instead.
  * If `options.sanityChecks`, run some sanity checks and print potential issues to the console.
  * `options.sourceUrl` serves as the base for resolving relative URLs/URIs and may itself be relative to the window URL. */
 export declare function loadMVS(plugin: PluginContext, data: MVSData, options?: {
     replaceExisting?: boolean;
+    keepCamera?: boolean;
     sanityChecks?: boolean;
     sourceUrl?: string;
 }): Promise<void>;

package/lib/commonjs/extensions/mvs/load.js

@@ -24,6 +24,7 @@ const molstar_tree_1 = require("./tree/molstar/molstar-tree");
 const mvs_tree_1 = require("./tree/mvs/mvs-tree");
 /** Load a MolViewSpec (MVS) tree into the Mol* plugin.
  * If `options.replaceExisting`, remove all objects in the current Mol* state; otherwise add to the current state.
+ * If `options.keepCamera`, ignore any camera positioning from the MVS state and keep the current camera position instead.
  * If `options.sanityChecks`, run some sanity checks and print potential issues to the console.
  * `options.sourceUrl` serves as the base for resolving relative URLs/URIs and may itself be relative to the window URL. */
 async function loadMVS(plugin, data, options = {}) {
@@ -53,14 +54,19 @@ async function loadMolstarTree(plugin, tree, options) {
     const context = {};
     await (0, load_helpers_1.loadTree)(plugin, tree, MolstarLoadingActions, context, options);
     (0, camera_1.setCanvas)(plugin, context.canvas);
-    if (((_a = context.focus) === null || _a === void 0 ? void 0 : _a.kind) === 'camera') {
-        await (0, camera_1.setCamera)(plugin, context.focus.params);
-    }
-    else if (((_b = context.focus) === null || _b === void 0 ? void 0 : _b.kind) === 'focus') {
-        await (0, camera_1.setFocus)(plugin, context.focus.focusTarget, context.focus.params);
+    if (options === null || options === void 0 ? void 0 : options.keepCamera) {
+        await (0, camera_1.suppressCameraAutoreset)(plugin);
     }
     else {
-        await (0, camera_1.setFocus)(plugin, undefined, undefined);
+        if (((_a = context.focus) === null || _a === void 0 ? void 0 : _a.kind) === 'camera') {
+            await (0, camera_1.setCamera)(plugin, context.focus.params);
+        }
+        else if (((_b = context.focus) === null || _b === void 0 ? void 0 : _b.kind) === 'focus') {
+            await (0, camera_1.setFocus)(plugin, context.focus.focusTarget, context.focus.params);
+        }
+        else {
+            await (0, camera_1.setFocus)(plugin, undefined, undefined);
+        }
     }
 }
 /** Loading actions for loading a `MolstarTree`, per node kind. */

package/lib/commonjs/extensions/mvs/tree/mvs/mvs-builder.d.ts

@@ -85,6 +85,7 @@ declare class _Base<TKind extends MVSKind> {
                 }[]>;
             };
             component_from_uri: {
+                /** Add a 'representation' node and return builder pointing to it. 'representation' node instructs to create a visual representation of a component. */
                 field_values: import("../generic/params-schema").OptionalField<string[] | null>;
                 uri: import("../generic/params-schema").RequiredField<string>;
                 format: import("../generic/params-schema").RequiredField<"json" | "cif" | "bcif">;
@@ -96,7 +97,6 @@ declare class _Base<TKind extends MVSKind> {
             };
             component_from_source: {
                 field_values: import("../generic/params-schema").OptionalField<string[] | null>;
-                /** Add a 'camera' node and return builder pointing to the root. 'camera' node instructs to set the camera position and orientation. */
                 schema: import("../generic/params-schema").RequiredField<"atom" | "residue" | "entity" | "chain" | "whole_structure" | "auth_chain" | "auth_residue" | "residue_range" | "auth_residue_range" | "auth_atom" | "all_atomic">;
                 block_header: import("../generic/params-schema").OptionalField<string | null>;
                 block_index: import("../generic/params-schema").OptionalField<number>;
@@ -152,7 +152,6 @@ declare class _Base<TKind extends MVSKind> {
                 field_name: import("../generic/params-schema").OptionalField<string>;
             };
             color_from_source: {
-                /** Add a 'camera' node and return builder pointing to the root. 'camera' node instructs to set the camera position and orientation. */
                 schema: import("../generic/params-schema").RequiredField<"atom" | "residue" | "entity" | "chain" | "whole_structure" | "auth_chain" | "auth_residue" | "residue_range" | "auth_residue_range" | "auth_atom" | "all_atomic">;
                 block_header: import("../generic/params-schema").OptionalField<string | null>;
                 block_index: import("../generic/params-schema").OptionalField<number>;
@@ -172,7 +171,6 @@ declare class _Base<TKind extends MVSKind> {
                 field_name: import("../generic/params-schema").OptionalField<string>;
             };
             label_from_source: {
-                /** Add a 'camera' node and return builder pointing to the root. 'camera' node instructs to set the camera position and orientation. */
                 schema: import("../generic/params-schema").RequiredField<"atom" | "residue" | "entity" | "chain" | "whole_structure" | "auth_chain" | "auth_residue" | "residue_range" | "auth_residue_range" | "auth_atom" | "all_atomic">;
                 block_header: import("../generic/params-schema").OptionalField<string | null>;
                 block_index: import("../generic/params-schema").OptionalField<number>;
@@ -192,7 +190,6 @@ declare class _Base<TKind extends MVSKind> {
                 field_name: import("../generic/params-schema").OptionalField<string>;
             };
             tooltip_from_source: {
-                /** Add a 'camera' node and return builder pointing to the root. 'camera' node instructs to set the camera position and orientation. */
                 schema: import("../generic/params-schema").RequiredField<"atom" | "residue" | "entity" | "chain" | "whole_structure" | "auth_chain" | "auth_residue" | "residue_range" | "auth_residue_range" | "auth_atom" | "all_atomic">;
                 block_header: import("../generic/params-schema").OptionalField<string | null>;
                 block_index: import("../generic/params-schema").OptionalField<number>;
@@ -269,6 +266,7 @@ declare class _Base<TKind extends MVSKind> {
                 }[]>;
             };
             component_from_uri: {
+                /** Add a 'representation' node and return builder pointing to it. 'representation' node instructs to create a visual representation of a component. */
                 field_values: import("../generic/params-schema").OptionalField<string[] | null>;
                 uri: import("../generic/params-schema").RequiredField<string>;
                 format: import("../generic/params-schema").RequiredField<"json" | "cif" | "bcif">;
@@ -280,7 +278,6 @@ declare class _Base<TKind extends MVSKind> {
             };
             component_from_source: {
                 field_values: import("../generic/params-schema").OptionalField<string[] | null>;
-                /** Add a 'camera' node and return builder pointing to the root. 'camera' node instructs to set the camera position and orientation. */
                 schema: import("../generic/params-schema").RequiredField<"atom" | "residue" | "entity" | "chain" | "whole_structure" | "auth_chain" | "auth_residue" | "residue_range" | "auth_residue_range" | "auth_atom" | "all_atomic">;
                 block_header: import("../generic/params-schema").OptionalField<string | null>;
                 block_index: import("../generic/params-schema").OptionalField<number>;
@@ -336,7 +333,6 @@ declare class _Base<TKind extends MVSKind> {
                 field_name: import("../generic/params-schema").OptionalField<string>;
             };
             color_from_source: {
-                /** Add a 'camera' node and return builder pointing to the root. 'camera' node instructs to set the camera position and orientation. */
                 schema: import("../generic/params-schema").RequiredField<"atom" | "residue" | "entity" | "chain" | "whole_structure" | "auth_chain" | "auth_residue" | "residue_range" | "auth_residue_range" | "auth_atom" | "all_atomic">;
                 block_header: import("../generic/params-schema").OptionalField<string | null>;
                 block_index: import("../generic/params-schema").OptionalField<number>;
@@ -356,7 +352,6 @@ declare class _Base<TKind extends MVSKind> {
                 field_name: import("../generic/params-schema").OptionalField<string>;
             };
             label_from_source: {
-                /** Add a 'camera' node and return builder pointing to the root. 'camera' node instructs to set the camera position and orientation. */
                 schema: import("../generic/params-schema").RequiredField<"atom" | "residue" | "entity" | "chain" | "whole_structure" | "auth_chain" | "auth_residue" | "residue_range" | "auth_residue_range" | "auth_atom" | "all_atomic">;
                 block_header: import("../generic/params-schema").OptionalField<string | null>;
                 block_index: import("../generic/params-schema").OptionalField<number>;
@@ -376,7 +371,6 @@ declare class _Base<TKind extends MVSKind> {
                 field_name: import("../generic/params-schema").OptionalField<string>;
             };
             tooltip_from_source: {
-                /** Add a 'camera' node and return builder pointing to the root. 'camera' node instructs to set the camera position and orientation. */
                 schema: import("../generic/params-schema").RequiredField<"atom" | "residue" | "entity" | "chain" | "whole_structure" | "auth_chain" | "auth_residue" | "residue_range" | "auth_residue_range" | "auth_atom" | "all_atomic">;
                 block_header: import("../generic/params-schema").OptionalField<string | null>;
                 block_index: import("../generic/params-schema").OptionalField<number>;

package/lib/commonjs/extensions/pdbe/structure-quality-report/behavior.d.ts

@@ -4,7 +4,7 @@
  * @author David Sehnal <david.sehnal@gmail.com>
  */
 import { PluginBehavior } from '../../../mol-plugin/behavior/behavior';
-export declare const PDBeStructureQualityReport: import("../../../mol-state/transformer").StateTransformer<PluginBehavior.Category, PluginBehavior.Behavior, {
+export declare const PDBeStructureQualityReport: import("../../../mol-state").StateTransformer<PluginBehavior.Category, PluginBehavior.Behavior, {
     autoAttach: boolean;
     showTooltip: boolean;
 }>;