react-cheminfo 0.39.1 → 0.40.1

package/lib/molstar/core/hover.js

@@ -0,0 +1,92 @@
+/**
+ * What the pointer rests on, as a line of text.
+ *
+ * Every drawing our sites make carries a label already — `C1 sp³ σ to H5 (+)`,
+ * `C3 along [111]` — but molstar's own UI is not mounted, so nothing shows
+ * them. This turns the plugin's hover behaviour into that one string, which the
+ * canvas renders itself.
+ */
+import { isEmptyLoci, isEveryLoci } from 'molstar/lib/mol-model/loci.js';
+import { Bond, StructureElement, StructureProperties, } from 'molstar/lib/mol-model/structure.js';
+import { lociLabel } from 'molstar/lib/mol-theme/label.js';
+/**
+ * Report whatever the pointer rests on.
+ * @param plugin - The molstar context.
+ * @param listener - Called with the loci, or `null` when the pointer is over
+ * nothing. The pointer over the background reports an empty loci, whose label
+ * is the word "Nothing" — a sentence, not an absence — so it arrives as `null`.
+ * @returns The unsubscribe function.
+ */
+export function subscribeHover(plugin, listener) {
+    const subscription = plugin.behaviors.interaction.hover.subscribe((event) => {
+        const { loci } = event.current;
+        listener(isEmptyLoci(loci) || isEveryLoci(loci) ? null : loci);
+    });
+    return () => {
+        subscription.unsubscribe();
+    };
+}
+/**
+ * The one line a loci is worth, in molstar's own words.
+ * @param loci - What the pointer is over.
+ * @returns The label, stripped of the markup molstar writes into it, or `null`
+ * when there is nothing to say.
+ */
+export function lociText(loci) {
+    if (isEmptyLoci(loci) || isEveryLoci(loci))
+        return null;
+    const label = stripMarkup(lociLabel(loci, { granularity: 'element' }));
+    return label === '' ? null : label;
+}
+/**
+ * The atoms a loci holds, in words a reader wants.
+ *
+ * molstar names one after the row it parsed — `xyz | Model 0 | Instance 1_555 |
+ * A | MOL 1 | O [idx 1]` — which is the address of a line in a file we wrote to
+ * hand it the atoms, and says nothing a student wants. The element and which
+ * atom of the scene it is do: the two hydrogens of water can then be told apart.
+ * @param loci - What the pointer rests on: an atom, or the two ends of a bond.
+ * @returns `O 1`, `Si 4 — O 8`, or `null` when the loci holds no atom.
+ */
+export function atomText(loci) {
+    const atoms = StructureElement.Loci.is(loci)
+        ? loci
+        : Bond.isLoci(loci)
+            ? Bond.toStructureElementLoci(loci)
+            : null;
+    if (atoms === null)
+        return null;
+    const names = [];
+    StructureElement.Loci.forEachLocation(atoms, (location) => {
+        names.push(atomName(String(StructureProperties.atom.type_symbol(location)), StructureProperties.atom.sourceIndex(location)));
+    });
+    return names.length === 0 ? null : names.join(' — ');
+}
+/**
+ * What a site calls one atom of its scene.
+ *
+ * molstar upper-cases an element symbol on its way in, so the atom it hands
+ * back from an `Si` it was given is an `SI`, which is not how anybody writes
+ * silicon. The number is which atom of the scene it is, counting from one.
+ * @param element - Its element symbol, in any case.
+ * @param index - Its place in the file the viewer was handed, from zero.
+ * @returns `O 1`, `Si 4`.
+ */
+export function atomName(element, index) {
+    const symbol = element.charAt(0).toUpperCase() + element.slice(1).toLowerCase();
+    return `${symbol} ${index + 1}`;
+}
+/**
+ * Molstar's label providers return HTML, and a readout is plain text.
+ * @param label - The provider's label.
+ * @returns The same label with its tags and entities resolved.
+ */
+function stripMarkup(label) {
+    return label
+        .replaceAll(/<[^>]*>/g, ' ')
+        .replaceAll('&nbsp;', ' ')
+        .replaceAll('&amp;', '&')
+        .replaceAll(/\s+/g, ' ')
+        .trim();
+}
+//# sourceMappingURL=hover.js.map

package/lib/molstar/core/hover.js.map

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

package/lib/molstar/core/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The molstar layer under the 3D views: the plugin lifecycle, the camera, the
+ * hover labels, the measurements and the picture of a scene.
+ *
+ * Three of our sites mount a headless molstar canvas — the molecule viewer
+ * here, lcao's orbitals and symmetry's crystals — and each of them had its own
+ * copy of the lifecycle, the spec and the spin. This is that one copy; what
+ * stays in a site is the scene it draws.
+ *
+ * **Importing this pulls molstar in statically**, which is why it is reached
+ * through the `./molstar/*` pattern rather than a plain subpath: molstar is an
+ * optional peer, so a plain subpath would be one the package test imports —
+ * in a project that installs no optional peer — and it cannot succeed there.
+ * A site that only wants `<MoleculeViewer3D>` imports `react-cheminfo/molecule3d`,
+ * whose canvas is lazy and whose barrel stays molstar-free.
+ */
+export type { CameraPose, CameraReference, PoseOptions } from './cameraPose.ts';
+export { cameraToPose, poseToCamera } from './cameraPose.ts';
+export { DEFAULT_CAMERA_DURATION, DEFAULT_SPIN_SPEED, FRAMING_MARGIN, MINIMUM_FRAMING_RADIUS, framedRadius, setSpin, } from './camera.ts';
+export { atomName, atomText, lociText, subscribeHover } from './hover.ts';
+export type { MolstarPluginOptions } from './plugin.ts';
+export { MolstarPlugin } from './plugin.ts';
+export { captureScene } from './captureScene.ts';
+export type { MoleculeStructureSource } from './measurements.ts';
+export { MeasurementPicker, atomReferenceOf, clearMeasurements, renderMeasurements, } from './measurements.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/molstar/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/molstar/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,YAAY,EACZ,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1E,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC"}

package/lib/molstar/core/index.js

@@ -0,0 +1,23 @@
+/**
+ * The molstar layer under the 3D views: the plugin lifecycle, the camera, the
+ * hover labels, the measurements and the picture of a scene.
+ *
+ * Three of our sites mount a headless molstar canvas — the molecule viewer
+ * here, lcao's orbitals and symmetry's crystals — and each of them had its own
+ * copy of the lifecycle, the spec and the spin. This is that one copy; what
+ * stays in a site is the scene it draws.
+ *
+ * **Importing this pulls molstar in statically**, which is why it is reached
+ * through the `./molstar/*` pattern rather than a plain subpath: molstar is an
+ * optional peer, so a plain subpath would be one the package test imports —
+ * in a project that installs no optional peer — and it cannot succeed there.
+ * A site that only wants `<MoleculeViewer3D>` imports `react-cheminfo/molecule3d`,
+ * whose canvas is lazy and whose barrel stays molstar-free.
+ */
+export { cameraToPose, poseToCamera } from "./cameraPose.js";
+export { DEFAULT_CAMERA_DURATION, DEFAULT_SPIN_SPEED, FRAMING_MARGIN, MINIMUM_FRAMING_RADIUS, framedRadius, setSpin, } from "./camera.js";
+export { atomName, atomText, lociText, subscribeHover } from "./hover.js";
+export { MolstarPlugin } from "./plugin.js";
+export { captureScene } from "./captureScene.js";
+export { MeasurementPicker, atomReferenceOf, clearMeasurements, renderMeasurements, } from "./measurements.js";
+//# sourceMappingURL=index.js.map

package/lib/molstar/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/molstar/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,YAAY,EACZ,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC"}

package/lib/{molecule3d/ui → molstar/core}/measurements.d.ts

@@ -9,16 +9,25 @@
  * instead of moving the camera, and once enough atoms are in it they become a
  * measurement.
  */
+import type { ElementIndex, Structure } from 'molstar/lib/mol-model/structure.js';
 import type { PluginContext } from 'molstar/lib/mol-plugin/context.js';
-import type { Measurement, MeasurementKind } from '../core/measurement.ts';
+import type { AtomReference, Measurement, MeasurementKind } from '../../molecule3d/core/measurement.ts';
+/**
+ * Where the atoms a measurement addresses are found in the plugin's state.
+ *
+ * Every site builds its scene under refs of its own, so it says here which
+ * structure the clicks and the labels are read against.
+ */
+export type MoleculeStructureSource = (plugin: PluginContext) => Structure | undefined;
 /**
  * Draw exactly `measurements` over the current molecule. An atom the structure
  * does not have skips its measurement rather than failing the scene.
  * @param plugin - The molstar context.
  * @param measurements - Everything to show, replacing what is shown.
+ * @param structureOf - See {@link MoleculeStructureSource}.
  * @returns Nothing; resolves once every label is on screen.
  */
-export declare function renderMeasurements(plugin: PluginContext, measurements: readonly Measurement[]): Promise<void>;
+export declare function renderMeasurements(plugin: PluginContext, measurements: readonly Measurement[], structureOf: MoleculeStructureSource): Promise<void>;
 /**
  * Remove every measurement from the scene.
  * @param plugin - The molstar context.
@@ -32,8 +41,9 @@ export declare class MeasurementPicker {
      * Start listening to the selection history of `plugin`.
      * @param plugin - The molstar context.
      * @param onMeasure - Called with each measurement once its atoms are picked.
+     * @param structureOf - See {@link MoleculeStructureSource}.
      */
-    constructor(plugin: PluginContext, onMeasure: (measurement: Measurement) => void);
+    constructor(plugin: PluginContext, onMeasure: (measurement: Measurement) => void, structureOf: MoleculeStructureSource);
     /**
      * Choose what the next clicks measure. Atoms already picked are dropped.
      * @param kind - The measurement to build, or `null` to give clicks back to
@@ -43,4 +53,14 @@ export declare class MeasurementPicker {
     /** Stop listening to the plugin. */
     dispose(): void;
 }
+/**
+ * Address one atom of a structure the way a {@link Measurement} does.
+ *
+ * A site that builds its own scene numbers atoms by their position in the file
+ * it drew; this is how that number becomes a reference a measurement keeps.
+ * @param structure - The structure on screen.
+ * @param element - The atom's index in the model, i.e. its position in the file.
+ * @returns The reference, or `undefined` when the structure has no such atom.
+ */
+export declare function atomReferenceOf(structure: Structure, element: ElementIndex): AtomReference | undefined;
 //# sourceMappingURL=measurements.d.ts.map

package/lib/molstar/core/measurements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurements.d.ts","sourceRoot":"","sources":["../../../src/molstar/core/measurements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACV,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAIvE,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,eAAe,EAChB,MAAM,sCAAsC,CAAC;AAM9C;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,CACpC,MAAM,EAAE,aAAa,KAClB,SAAS,GAAG,SAAS,CAAC;AAE3B;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,SAAS,WAAW,EAAE,EACpC,WAAW,EAAE,uBAAuB,GACnC,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ5E;AAED,2EAA2E;AAC3E,qBAAa,iBAAiB;;IAO5B;;;;;OAKG;gBAED,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,EAC7C,WAAW,EAAE,uBAAuB;IAmBtC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI;IAO3C,oCAAoC;IACpC,OAAO,IAAI,IAAI;CAqBhB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,YAAY,GACpB,aAAa,GAAG,SAAS,CAS3B"}

package/lib/{molecule3d/ui → molstar/core}/measurements.js

@@ -9,12 +9,11 @@
  * instead of moving the camera, and once enough atoms are in it they become a
  * measurement.
  */
-import { OrderedSet } from 'molstar/lib/mol-data/int.js';
+import { OrderedSet, SortedArray } from 'molstar/lib/mol-data/int.js';
 import { StructureElement } from 'molstar/lib/mol-model/structure.js';
 import { MeasurementGroupTag } from 'molstar/lib/mol-plugin-state/manager/structure/measurement.js';
 import { StateSelection, StateTransform } from 'molstar/lib/mol-state/index.js';
-import { MEASUREMENT_ATOM_COUNTS } from "../core/measurement.js";
-import { moleculeStructure } from "./renderMolecule.js";
+import { MEASUREMENT_ATOM_COUNTS } from "../../molecule3d/core/measurement.js";
 // Lowercased: it is a factory, not a constructor.
 const elementLoci = StructureElement.Loci;
 /**
@@ -22,11 +21,12 @@ const elementLoci = StructureElement.Loci;
  * does not have skips its measurement rather than failing the scene.
  * @param plugin - The molstar context.
  * @param measurements - Everything to show, replacing what is shown.
+ * @param structureOf - See {@link MoleculeStructureSource}.
  * @returns Nothing; resolves once every label is on screen.
  */
-export async function renderMeasurements(plugin, measurements) {
+export async function renderMeasurements(plugin, measurements, structureOf) {
     await clearMeasurements(plugin);
-    const structure = moleculeStructure(plugin);
+    const structure = structureOf(plugin);
     if (structure === undefined)
         return;
     const manager = plugin.managers.structure.measurement;
@@ -61,15 +61,18 @@ export class MeasurementPicker {
     #plugin;
     #onMeasure;
     #unsubscribe;
+    #structureOf;
     #kind = null;
     /**
      * Start listening to the selection history of `plugin`.
      * @param plugin - The molstar context.
      * @param onMeasure - Called with each measurement once its atoms are picked.
+     * @param structureOf - See {@link MoleculeStructureSource}.
      */
-    constructor(plugin, onMeasure) {
+    constructor(plugin, onMeasure, structureOf) {
         this.#plugin = plugin;
         this.#onMeasure = onMeasure;
+        this.#structureOf = structureOf;
         // A molfile is one residue: at molstar's default granularity a click
         // would pick the whole molecule.
         plugin.managers.interactivity.setProps({ granularity: 'element' });
@@ -98,7 +101,7 @@ export class MeasurementPicker {
     }
     #collect() {
         const kind = this.#kind;
-        const structure = moleculeStructure(this.#plugin);
+        const structure = this.#structureOf(this.#plugin);
         if (kind === null || structure === undefined)
             return;
         const needed = MEASUREMENT_ATOM_COUNTS[kind];
@@ -117,6 +120,27 @@ export class MeasurementPicker {
         this.#onMeasure({ kind, atoms: atoms.toReversed() });
     }
 }
+/**
+ * Address one atom of a structure the way a {@link Measurement} does.
+ *
+ * A site that builds its own scene numbers atoms by their position in the file
+ * it drew; this is how that number becomes a reference a measurement keeps.
+ * @param structure - The structure on screen.
+ * @param element - The atom's index in the model, i.e. its position in the file.
+ * @returns The reference, or `undefined` when the structure has no such atom.
+ */
+export function atomReferenceOf(structure, element) {
+    const units = structure.units;
+    for (let unit = 0; unit < units.length; unit++) {
+        const elements = units[unit]?.elements;
+        if (elements === undefined)
+            continue;
+        const index = SortedArray.indexOf(elements, element);
+        if (index !== -1)
+            return { unit, element: index };
+    }
+    return undefined;
+}
 function atomReference(structure, loci) {
     if (!StructureElement.Loci.is(loci))
         return undefined;

package/lib/molstar/core/measurements.js.map

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

package/lib/molstar/core/plugin.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Lifecycle of one headless molstar canvas: created now, disposed whenever,
+ * every call queued behind initialisation.
+ *
+ * The constructor is **synchronous** on purpose. React 19 runs an effect, its
+ * cleanup and the effect again on every mount in development, so an `await`ed
+ * constructor hands the cleanup nothing to dispose and leaks a WebGL context
+ * per mount — browsers drop the oldest after about sixteen, and the viewer
+ * silently goes blank. Returning the handle immediately means `dispose()` can
+ * always be called, even before initialisation has finished; the work is queued
+ * behind `ready`.
+ *
+ * molstar's own UI is never mounted: every control on our sites is ours.
+ */
+import type { PluginContext } from 'molstar/lib/mol-plugin/context.js';
+import type { PluginSpec } from 'molstar/lib/mol-plugin/spec.js';
+/** Settings fixed for the life of a plugin. */
+export interface MolstarPluginOptions {
+    /**
+     * Scene background, as `#rrggbb`. A WebGL clear colour, so it cannot be a CSS
+     * custom property.
+     * @default '#ffffff'
+     */
+    background?: string;
+    /**
+     * How long molstar animates a reframe it decided on itself; 0 jumps.
+     *
+     * Replacing a scene commits several times — the old drawing is deleted, the
+     * new one added — and molstar glides the camera on each, so the model appears
+     * to drift into place. Reframing is right; animating it between two unrelated
+     * scenes is not.
+     * @default molstar's own 250 ms
+     */
+    cameraResetDurationMilliseconds?: number;
+    /**
+     * The last word on the spec, applied over everything above: a site that needs
+     * a behaviour dropped, a marking colour or a renderer setting of its own
+     * passes it here rather than mounting its own view model.
+     */
+    spec?: (spec: PluginSpec) => PluginSpec;
+}
+/** One molstar canvas, and the queue everything drawn on it goes through. */
+export declare class MolstarPlugin {
+    #private;
+    /** Resolves once the canvas exists; every call awaits it internally. */
+    readonly ready: Promise<void>;
+    /**
+     * Mount a canvas in `container` and start initialising it.
+     * @param container - An element with `position: relative`; molstar inserts
+     * its own canvas into it.
+     * @param options - See {@link MolstarPluginOptions}.
+     */
+    constructor(container: HTMLElement, options?: MolstarPluginOptions);
+    /**
+     * Whether {@link dispose} has been called.
+     * @returns True once the canvas has been torn down.
+     */
+    get disposed(): boolean;
+    /**
+     * Wait for initialisation, then run `action` on the plugin.
+     * @param action - What to do with the molstar context.
+     * @returns What `action` returned, or `undefined` once the plugin has been
+     * disposed — before the call or while `action` was still running. An
+     * initialisation failure, and anything `action` throws while the plugin is
+     * alive, still reach the caller.
+     */
+    run<Result>(action: (plugin: PluginContext) => Result | Promise<Result>): Promise<Result | undefined>;
+    /**
+     * Start a subscription once the plugin exists.
+     * @param start - Subscribes, and returns its own unsubscribe function.
+     * @returns A function that stops the subscription, or stops it from ever
+     * starting; safe to call at any time.
+     */
+    subscribe(start: (plugin: PluginContext) => () => void): () => void;
+    /** Re-read the container's size. Call from a `ResizeObserver`. */
+    handleResize(): void;
+    /**
+     * Tear the canvas down and release its WebGL context. Idempotent, and safe to
+     * call before initialisation has finished.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/lib/molstar/core/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/molstar/core/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAKjE,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;OAQG;IACH,+BAA+B,CAAC,EAAE,MAAM,CAAC;IACzC;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,UAAU,CAAC;CACzC;AAED,6EAA6E;AAC7E,qBAAa,aAAa;;IAIxB,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B;;;;;OAKG;gBACS,SAAS,EAAE,WAAW,EAAE,OAAO,GAAE,oBAAyB;IA0BtE;;;OAGG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;;;OAOG;IACG,GAAG,CAAC,MAAM,EACd,MAAM,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAC1D,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAY9B;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,IAAI,GAAG,MAAM,IAAI;IAcnE,kEAAkE;IAClE,YAAY,IAAI,IAAI;IAKpB;;;OAGG;IACH,OAAO,IAAI,IAAI;CAahB"}

package/lib/molstar/core/plugin.js

@@ -0,0 +1,128 @@
+/**
+ * Lifecycle of one headless molstar canvas: created now, disposed whenever,
+ * every call queued behind initialisation.
+ *
+ * The constructor is **synchronous** on purpose. React 19 runs an effect, its
+ * cleanup and the effect again on every mount in development, so an `await`ed
+ * constructor hands the cleanup nothing to dispose and leaks a WebGL context
+ * per mount — browsers drop the oldest after about sixteen, and the viewer
+ * silently goes blank. Returning the handle immediately means `dispose()` can
+ * always be called, even before initialisation has finished; the work is queued
+ * behind `ready`.
+ *
+ * molstar's own UI is never mounted: every control on our sites is ours.
+ */
+import { PluginViewModel } from 'molstar/lib/extensions/plugin/view-model.js';
+// Lowercased on import: it is a factory, not a constructor.
+import { DefaultPluginSpec as defaultPluginSpec } from 'molstar/lib/mol-plugin/spec.js';
+import { Color } from 'molstar/lib/mol-util/color/color.js';
+/** One molstar canvas, and the queue everything drawn on it goes through. */
+export class MolstarPlugin {
+    #model;
+    #disposed = false;
+    /** Resolves once the canvas exists; every call awaits it internally. */
+    ready;
+    /**
+     * Mount a canvas in `container` and start initialising it.
+     * @param container - An element with `position: relative`; molstar inserts
+     * its own canvas into it.
+     * @param options - See {@link MolstarPluginOptions}.
+     */
+    constructor(container, options = {}) {
+        const { background = '#ffffff', // tokens-ok: a WebGL clear colour
+        cameraResetDurationMilliseconds, spec: refine, } = options;
+        const base = defaultPluginSpec();
+        const spec = {
+            ...base,
+            canvas3d: {
+                ...base.canvas3d,
+                renderer: { backgroundColor: Color.fromHexStyle(background) },
+                // A scene is read from its own shape, never from the world axes.
+                camera: { helper: { axes: { name: 'off', params: {} } } },
+                ...(cameraResetDurationMilliseconds === undefined
+                    ? {}
+                    : { cameraResetDurationMs: cameraResetDurationMilliseconds }),
+            },
+        };
+        this.#model = new PluginViewModel({
+            spec: refine === undefined ? spec : refine(spec),
+        });
+        this.#model.mount(container);
+        this.ready = this.#model.initialized;
+    }
+    /**
+     * Whether {@link dispose} has been called.
+     * @returns True once the canvas has been torn down.
+     */
+    get disposed() {
+        return this.#disposed;
+    }
+    /**
+     * Wait for initialisation, then run `action` on the plugin.
+     * @param action - What to do with the molstar context.
+     * @returns What `action` returned, or `undefined` once the plugin has been
+     * disposed — before the call or while `action` was still running. An
+     * initialisation failure, and anything `action` throws while the plugin is
+     * alive, still reach the caller.
+     */
+    async run(action) {
+        if (this.#disposed)
+            return undefined;
+        await this.ready;
+        if (this.#disposed)
+            return undefined;
+        try {
+            return await action(this.#model.plugin);
+        }
+        catch (error) {
+            if (this.#disposed)
+                return undefined;
+            throw error;
+        }
+    }
+    /**
+     * Start a subscription once the plugin exists.
+     * @param start - Subscribes, and returns its own unsubscribe function.
+     * @returns A function that stops the subscription, or stops it from ever
+     * starting; safe to call at any time.
+     */
+    subscribe(start) {
+        let stop = null;
+        let cancelled = false;
+        void this.run((plugin) => {
+            if (cancelled)
+                return;
+            stop = start(plugin);
+        });
+        return () => {
+            cancelled = true;
+            stop?.();
+            stop = null;
+        };
+    }
+    /** Re-read the container's size. Call from a `ResizeObserver`. */
+    handleResize() {
+        if (this.#disposed)
+            return;
+        this.#model.plugin.handleResize();
+    }
+    /**
+     * Tear the canvas down and release its WebGL context. Idempotent, and safe to
+     * call before initialisation has finished.
+     */
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        // `mount` creates the canvas synchronously, so the context exists even when
+        // initialisation went on to fail; releasing it is what stops the browser
+        // dropping an older viewer's. A rejected `ready` must not escape here
+        // either — nobody is left to handle it.
+        void this.ready
+            .catch(() => undefined)
+            .then(() => {
+            this.#model.plugin.dispose();
+        });
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/lib/molstar/core/plugin.js.map

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

package/lib/structure/ui/ConformerTable.d.ts

@@ -59,6 +59,14 @@ export interface ConformerTableProps {
      * @default undefined — every column keeps its own
      */
     columnLabels?: Partial<Record<ConformerColumn, string>>;
+    /**
+     * Whether the energies on screen are expected to be replaced — a force
+     * field's numbers while a better method is still working on the set. They
+     * are then drawn muted, so a reader can tell at a glance which of the two
+     * rankings they are looking at.
+     * @default false
+     */
+    provisional?: boolean;
 }
 /**
  * The conformers of a set, as a selectable table.

package/lib/structure/ui/ConformerTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConformerTable.d.ts","sourceRoot":"","sources":["../../../src/structure/ui/ConformerTable.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAgC,YAAY,EAAE,MAAM,OAAO,CAAC;AAUxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO7D,uCAAuC;AACvC,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,UAAU,EAAE,SAAS,YAAY,EAAE,CAAC;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACrC;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IACjC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;CACzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,mBAAmB,GACzB,YAAY,GAAG,IAAI,CA4IrB"}
+{"version":3,"file":"ConformerTable.d.ts","sourceRoot":"","sources":["../../../src/structure/ui/ConformerTable.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAgC,YAAY,EAAE,MAAM,OAAO,CAAC;AAUxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO7D,uCAAuC;AACvC,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,UAAU,EAAE,SAAS,YAAY,EAAE,CAAC;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACrC;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IACjC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,mBAAmB,GACzB,YAAY,GAAG,IAAI,CA6IrB"}

package/lib/structure/ui/ConformerTable.js

@@ -32,7 +32,7 @@ import { CONFORMER_COLUMN_LABELS, NUMERIC_CONFORMER_COLUMNS, PICKER_COLUMNS, } f
  * @returns The table, or `null` when there is nothing to show.
  */
 export function ConformerTable(props) {
-    const { conformers, columns = PICKER_COLUMNS, ranking = 'force-field', selectedId = null, onSelect, temperature = ROOM_TEMPERATURE, label = 'Conformers, most stable first', rowName = String, columnLabels, } = props;
+    const { conformers, columns = PICKER_COLUMNS, ranking = 'force-field', selectedId = null, onSelect, temperature = ROOM_TEMPERATURE, label = 'Conformers, most stable first', rowName = String, columnLabels, provisional = false, } = props;
     const bodyRef = useRef(null);
     const shares = useMemo(() => {
         if (!columns.includes('population'))
@@ -93,7 +93,7 @@ export function ConformerTable(props) {
                             return copyableHere &&
                                 COPY_LABELS[column] !== undefined &&
                                 typeof content === 'string' &&
-                                content !== '—' ? (_jsx(ClickToCopy, { as: "td", style: cellStyle(column), value: content, label: COPY_LABELS[column], testId: CELL_TEST_IDS[column], children: content }, column)) : (_jsx("td", { style: cellStyle(column), "data-testid": CELL_TEST_IDS[column], children: content }, column));
+                                content !== '—' ? (_jsx(ClickToCopy, { as: "td", style: cellStyle(column, provisional), value: content, label: COPY_LABELS[column], testId: CELL_TEST_IDS[column], children: content }, column)) : (_jsx("td", { style: cellStyle(column, provisional), "data-testid": CELL_TEST_IDS[column], children: content }, column));
                         }) }, conformer.id));
                 }) })] }));
 }
@@ -200,14 +200,34 @@ const ENERGY_RESOLUTION = 0.005;
 function headerStyle(column) {
     return NUMERIC_CONFORMER_COLUMNS.has(column) ? numericStyle : undefined;
 }
-function cellStyle(column) {
-    return NUMERIC_CONFORMER_COLUMNS.has(column) ? numericStyle : undefined;
+/**
+ * A cell's own style: numbers are right-aligned and tabular, and every cell a
+ * better method will restate is muted while it works. The rank is not one of
+ * them — it names the row rather than measuring it, and it is what a reader
+ * follows as the order changes under them.
+ * @param column - The column the cell is in.
+ * @param provisional - Whether the energies are still expected to change.
+ * @returns The cell's inline style, or `undefined` when it needs none.
+ */
+function cellStyle(column, provisional) {
+    const numeric = NUMERIC_CONFORMER_COLUMNS.has(column);
+    if (!provisional || column === 'id') {
+        return numeric ? numericStyle : undefined;
+    }
+    return numeric ? provisionalNumericStyle : provisionalStyle;
 }
 const tableStyle = { width: '100%' };
 const numericStyle = {
     textAlign: 'right',
     fontVariantNumeric: 'tabular-nums',
 };
+const provisionalStyle = {
+    color: 'var(--text-muted)',
+};
+const provisionalNumericStyle = {
+    ...numericStyle,
+    ...provisionalStyle,
+};
 /**
  * The selected row is tinted with the site's own accent, so the table belongs
  * to whichever site draws it; a row is a pointer only where a click does