react-cheminfo 0.17.0 → 0.19.0

package/lib/molecule3d/ui/viewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../../../src/molecule3d/ui/viewer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAe1D,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EACb,YAAY,EACb,MAAM,kBAAkB,CAAC;AAE1B;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,WAAW,EACtB,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CAElB;AAED;;;GAGG;AACH,qBAAa,gBAAgB;;IAK3B,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B;;;;OAIG;gBACS,SAAS,EAAE,WAAW,EAAE,OAAO,GAAE,uBAA4B;IAyBzE;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3E;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7B;;;;OAIG;IACH,WAAW,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;;OAIG;IACH,gBAAgB,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE;;;;OAIG;IACH,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAgB1D;;;;;OAKG;IACH,WAAW,CACT,oBAAoB,SAA0B,EAC9C,SAAS,UAAQ,GAChB,OAAO,CAAC,IAAI,CAAC;IAMhB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,SAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrE,kEAAkE;IAClE,YAAY,IAAI,IAAI;IAKpB,sEAAsE;IACtE,OAAO,IAAI,IAAI;CAwBhB"}
+{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../../../src/molecule3d/ui/viewer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAmB1D,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EACb,YAAY,EACb,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,qBAAa,gBAAgB;;IAK3B,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B;;;;OAIG;gBACS,SAAS,EAAE,WAAW,EAAE,OAAO,GAAE,uBAA4B;IAczE;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3E;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7B;;;;OAIG;IACH,WAAW,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;;OAIG;IACH,gBAAgB,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE;;;;OAIG;IACH,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAI1D;;;;;OAKG;IACH,WAAW,CACT,oBAAoB,SAA0B,EAC9C,SAAS,UAAQ,GAChB,OAAO,CAAC,IAAI,CAAC;IAMhB;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,oBAAoB,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5E;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI;IAa5E;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,SAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrE,kEAAkE;IAClE,YAAY,IAAI,IAAI;IAKpB,sEAAsE;IACtE,OAAO,IAAI,IAAI;CAwBhB"}

package/lib/molecule3d/ui/viewer.js

@@ -1,31 +1,18 @@
 /**
- * Lifecycle of one molstar molecule viewer.
+ * Lifecycle of one molstar molecule viewer: `createMolecule3DViewer` builds
+ * one, and every operation a component performs on it is a method here.
  *
- * `createMolecule3DViewer` is **synchronous** on purpose. React 19 runs an
- * effect, its cleanup and the effect again on every mount in development, so an
- * awaited constructor hands the cleanup nothing to dispose and leaks a WebGL
- * context per mount. Returning the handle immediately means `dispose()` can
- * always be called; the work is queued behind `ready`.
- *
- * molstar's own UI is not mounted: every control is the component's.
+ * The constructor returns before the canvas exists — see `createViewer.ts` —
+ * so every method queues its work behind `ready` and resolves to nothing once
+ * the viewer has been disposed. molstar's own UI is not mounted: every control
+ * is the component's.
  */
-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';
-import { DEFAULT_CAMERA_DURATION, DEFAULT_SPIN_SPEED, resetCamera, setSpin, } from "./camera.js";
+import { DEFAULT_CAMERA_DURATION, DEFAULT_SPIN_SPEED, applyCamera, resetCamera, setSpin, watchCamera, } from "./camera.js";
+import { captureScene } from "./captureScene.js";
 import { MeasurementPicker, clearMeasurements, renderMeasurements, } from "./measurements.js";
 import { clearMolecule, renderMolecule } from "./renderMolecule.js";
 import { clearSurface, renderSurface } from "./renderSurface.js";
-/**
- * Create a viewer inside `container` and start initialising it.
- * @param container - A positioned element; molstar inserts its canvas into it.
- * @param options - See {@link Molecule3DViewerOptions}.
- * @returns A handle that is safe to dispose immediately.
- */
-export function createMolecule3DViewer(container, options = {}) {
-    return new Molecule3DViewer(container, options);
-}
+import { mountMolecule3DPlugin } from "./viewerSpec.js";
 /**
  * One molstar canvas, and every operation the component performs on it. Every
  * method resolves to nothing once `dispose` has been called.
@@ -44,18 +31,7 @@ export class Molecule3DViewer {
     constructor(container, options = {}) {
         const { background = '#ffffff', // tokens-ok: a WebGL clear colour
         onMeasure = ignore, } = options;
-        const spec = defaultPluginSpec();
-        this.#model = new PluginViewModel({
-            spec: {
-                ...spec,
-                canvas3d: {
-                    ...spec.canvas3d,
-                    renderer: { backgroundColor: Color.fromHexStyle(background) },
-                    camera: { helper: { axes: { name: 'off', params: {} } } },
-                },
-            },
-        });
-        this.#model.mount(container);
+        this.#model = mountMolecule3DPlugin(container, background);
         this.ready = this.#model.initialized;
         // Registered before any `#run`, so the picker exists by the time one runs.
         this.ready.then(() => {
@@ -128,19 +104,7 @@ export class Molecule3DViewer {
      * @throws {Error} When the plugin has no screenshot helper.
      */
     captureImage(size) {
-        return this.#run(async (plugin) => {
-            const helper = plugin.helpers.viewportScreenshot;
-            if (helper === undefined) {
-                throw new Error('This viewer cannot take a picture of its scene.');
-            }
-            helper.behaviors.values.next({
-                ...helper.values,
-                resolution: { name: 'custom', params: size },
-                axes: { name: 'off', params: {} },
-                transparent: false,
-            });
-            return helper.getImageDataUri();
-        });
+        return this.#run((plugin) => captureScene(plugin, size));
     }
     /**
      * Frame everything on screen.
@@ -153,6 +117,36 @@ export class Molecule3DViewer {
             resetCamera(plugin, durationMilliseconds, fromFront);
         });
     }
+    /**
+     * Put the camera where a link says it stood.
+     * @param camera - Where to stand.
+     * @param durationMilliseconds - Transition length; 0 jumps.
+     * @returns Nothing; resolves once the move has been ordered.
+     */
+    setCamera(camera, durationMilliseconds = 0) {
+        return this.#run((plugin) => {
+            applyCamera(plugin, camera, durationMilliseconds);
+        });
+    }
+    /**
+     * Follow the camera, however it moves.
+     * @param listener - Called after every move.
+     * @returns A function that stops calling the listener; safe to call before
+     * the canvas exists.
+     */
+    watchCamera(listener) {
+        let stop = null;
+        let cancelled = false;
+        void this.#run((plugin) => {
+            if (!cancelled)
+                stop = watchCamera(plugin, listener);
+        });
+        return () => {
+            cancelled = true;
+            stop?.();
+            stop = null;
+        };
+    }
     /**
      * Turn the automatic spin on or off.
      * @param spinning - Whether the scene should keep turning.

package/lib/molecule3d/ui/viewer.js.map

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

package/lib/molecule3d/ui/viewerSpec.d.ts

@@ -0,0 +1,17 @@
+/**
+ * How the molecule viewer configures molstar: the plugin spec it mounts with.
+ *
+ * molstar's own UI is not mounted — every control is the component's — and the
+ * axes helper is off, since a molecule is read from its own shape rather than
+ * from the world axes.
+ */
+import { PluginViewModel } from 'molstar/lib/extensions/plugin/view-model.js';
+/**
+ * Build a view model for one canvas and mount it.
+ * @param container - A positioned element; molstar inserts its canvas into it.
+ * @param background - Scene background as `#rrggbb`; a WebGL clear colour, so
+ * it cannot be a CSS custom property.
+ * @returns The mounted view model, still initialising.
+ */
+export declare function mountMolecule3DPlugin(container: HTMLElement, background: string): PluginViewModel;
+//# sourceMappingURL=viewerSpec.d.ts.map

package/lib/molecule3d/ui/viewerSpec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewerSpec.d.ts","sourceRoot":"","sources":["../../../src/molecule3d/ui/viewerSpec.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAK9E;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,WAAW,EACtB,UAAU,EAAE,MAAM,GACjB,eAAe,CAcjB"}

package/lib/molecule3d/ui/viewerSpec.js

@@ -0,0 +1,34 @@
+/**
+ * How the molecule viewer configures molstar: the plugin spec it mounts with.
+ *
+ * molstar's own UI is not mounted — every control is the component's — and the
+ * axes helper is off, since a molecule is read from its own shape rather than
+ * from the world axes.
+ */
+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';
+/**
+ * Build a view model for one canvas and mount it.
+ * @param container - A positioned element; molstar inserts its canvas into it.
+ * @param background - Scene background as `#rrggbb`; a WebGL clear colour, so
+ * it cannot be a CSS custom property.
+ * @returns The mounted view model, still initialising.
+ */
+export function mountMolecule3DPlugin(container, background) {
+    const spec = defaultPluginSpec();
+    const model = new PluginViewModel({
+        spec: {
+            ...spec,
+            canvas3d: {
+                ...spec.canvas3d,
+                renderer: { backgroundColor: Color.fromHexStyle(background) },
+                camera: { helper: { axes: { name: 'off', params: {} } } },
+            },
+        },
+    });
+    model.mount(container);
+    return model;
+}
+//# sourceMappingURL=viewerSpec.js.map

package/lib/molecule3d/ui/viewerSpec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewerSpec.js","sourceRoot":"","sources":["../../../src/molecule3d/ui/viewerSpec.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAC9E,4DAA4D;AAC5D,OAAO,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxF,OAAO,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAsB,EACtB,UAAkB;IAElB,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC;QAChC,IAAI,EAAE;YACJ,GAAG,IAAI;YACP,QAAQ,EAAE;gBACR,GAAG,IAAI,CAAC,QAAQ;gBAChB,QAAQ,EAAE,EAAE,eAAe,EAAE,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE;gBAC7D,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE;aAC1D;SACF;KACF,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/structure/core/editorGuide.d.ts

@@ -0,0 +1,69 @@
+/**
+ * What the keyboard and the mouse do in the openchemlib canvas editor, beyond
+ * what its toolbar shows: the keys that change the atom or the bond under the
+ * pointer, the selection gestures and the stereo conventions.
+ */
+/** A key, drawn as a key cap. `Mod` is ⌘ on a Mac and Ctrl elsewhere. */
+export interface EditorGuideKey {
+    key: string;
+}
+/** Which editors a gesture applies to. */
+export type EditorGuideScope = 'fragment' | 'molecule' | 'reaction';
+/** One gesture and what it does. */
+export interface EditorGesture {
+    /** Keys, and plain text for the mouse part; unique within one gesture. */
+    input: ReadonlyArray<string | EditorGuideKey>;
+    action: string;
+    /**
+     * The only editor the gesture works in.
+     * @default undefined — every editor
+     */
+    only?: EditorGuideScope;
+}
+/** Gestures that share a context, such as the pointer resting on an atom. */
+export interface EditorGuideSection {
+    title: string;
+    gestures: readonly EditorGesture[];
+    /**
+     * A sentence read after the gestures.
+     * @default undefined
+     */
+    note?: string;
+}
+/** A page of the full documentation. */
+export interface EditorGuideLink {
+    title: string;
+    url: string;
+}
+/** The sections, in the order the guide lists them. */
+export declare const STRUCTURE_EDITOR_GUIDE: readonly EditorGuideSection[];
+/** The documentation this guide summarises. */
+export declare const STRUCTURE_EDITOR_DOCS: readonly EditorGuideLink[];
+/** The editor a guide is written for. */
+export interface EditorGuideOptions {
+    /**
+     * Whether the editor draws one structure or a reaction.
+     * @default 'molecule'
+     */
+    mode?: 'molecule' | 'reaction';
+    /**
+     * Whether the editor draws a query fragment.
+     * @default false
+     */
+    fragment?: boolean;
+}
+/**
+ * The guide for one editor: gestures that do nothing there are left out, and so
+ * is a section left with nothing to say.
+ * @param options - The editor the guide is for.
+ * @returns The sections to show.
+ */
+export declare function editorGuideSections(options?: EditorGuideOptions): EditorGuideSection[];
+/**
+ * The text of a key cap.
+ * @param key - The key, `Mod` standing for the platform's shortcut modifier.
+ * @param isMac - Whether the page runs on a Mac.
+ * @returns What the cap shows.
+ */
+export declare function editorKeyLabel(key: string, isMac: boolean): string;
+//# sourceMappingURL=editorGuide.d.ts.map

package/lib/structure/core/editorGuide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorGuide.d.ts","sourceRoot":"","sources":["../../../src/structure/core/editorGuide.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,0CAA0C;AAC1C,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AAEpE,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,KAAK,EAAE,aAAa,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IACnC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,uDAAuD;AACvD,eAAO,MAAM,sBAAsB,EAAE,SAAS,kBAAkB,EA2G/D,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,qBAAqB,EAAE,SAAS,eAAe,EAU3D,CAAC;AAEF,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,kBAAuB,GAC/B,kBAAkB,EAAE,CAWtB;AAYD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAGlE"}

package/lib/structure/core/editorGuide.js

@@ -0,0 +1,162 @@
+/**
+ * What the keyboard and the mouse do in the openchemlib canvas editor, beyond
+ * what its toolbar shows: the keys that change the atom or the bond under the
+ * pointer, the selection gestures and the stereo conventions.
+ */
+/** The sections, in the order the guide lists them. */
+export const STRUCTURE_EDITOR_GUIDE = [
+    {
+        title: 'Pointer on an atom',
+        gestures: [
+            { input: ['Type', { key: 'n' }, { key: 'a' }], action: 'Make it Na' },
+            {
+                input: ['Type', { key: 'p' }, { key: 'h' }],
+                action: 'Attach a phenyl; Me, Et, Boc, TMS… work too',
+            },
+            {
+                input: [{ key: 'Enter' }, 'or', { key: 'Esc' }],
+                action: 'Apply or forget what was typed',
+            },
+            {
+                input: [{ key: '1' }, '…', { key: '9' }],
+                action: 'Attach a chain of that many carbons',
+            },
+            {
+                input: [{ key: '+' }, 'or', { key: '-' }],
+                action: 'Raise or lower the charge',
+            },
+            { input: [{ key: '.' }], action: 'Add or remove a radical' },
+            { input: [{ key: ':' }], action: 'Make it a triplet, then a singlet' },
+            { input: [{ key: '?' }], action: 'Make it a connection point' },
+            {
+                input: [{ key: 'q' }],
+                action: 'Edit its query features',
+                only: 'fragment',
+            },
+            { input: [{ key: 'x' }], action: 'Accept any halogen', only: 'fragment' },
+            { input: [{ key: 'Delete' }], action: 'Delete it' },
+        ],
+        note: 'What is typed shows black for an element, blue for a group, grey while incomplete and red when unknown.',
+    },
+    {
+        title: 'Pointer on a bond',
+        gestures: [
+            {
+                input: [{ key: '1' }, { key: '2' }, { key: '3' }],
+                action: 'Single, double or triple',
+            },
+            { input: [{ key: '0' }], action: 'Zero-order (metal–ligand) bond' },
+            {
+                input: [{ key: 'u' }, 'or', { key: 'd' }],
+                action: 'Up or down stereo bond',
+            },
+            { input: [{ key: 'c' }], action: 'Double bond of unknown geometry' },
+            { input: [{ key: 'v' }], action: 'Fuse a 3-membered ring' },
+            {
+                input: [{ key: '4' }, '…', { key: '7' }],
+                action: 'Fuse a ring of that size',
+            },
+            {
+                input: [{ key: 'a' }, 'or', { key: 'b' }],
+                action: 'Fuse a benzene ring',
+            },
+            {
+                input: [{ key: 'q' }],
+                action: 'Edit its query features',
+                only: 'fragment',
+            },
+            { input: [{ key: 'Delete' }], action: 'Delete it' },
+        ],
+    },
+    {
+        title: 'Anywhere',
+        gestures: [
+            { input: [{ key: 'Mod' }, { key: 'Z' }], action: 'Undo' },
+            { input: [{ key: 'Mod' }, { key: 'C' }], action: 'Copy the structure' },
+            {
+                input: [{ key: 'Mod' }, { key: 'V' }],
+                action: 'Paste a molfile, a SMILES or an idCode',
+            },
+            { input: [{ key: 'Delete' }], action: 'Delete the selection' },
+            {
+                input: [{ key: 'h' }, 'or', { key: 'v' }],
+                action: 'Flip horizontally or vertically',
+                only: 'molecule',
+            },
+            { input: [{ key: 'F1' }], action: 'Open this guide' },
+        ],
+        note: 'Keys act once the drawing has been clicked. On empty canvas, a key picks the tool whose tooltip shows it.',
+    },
+    {
+        title: 'Selecting',
+        gestures: [
+            { input: ['Drag'], action: 'Select what the lasso encloses' },
+            { input: [{ key: 'Alt' }, '+ drag'], action: 'Select a rectangle' },
+            { input: [{ key: 'Shift' }, '+ drag'], action: 'Add to the selection' },
+            { input: ['Drag the selection'], action: 'Move it' },
+            {
+                input: [{ key: 'Shift' }, '+ drag the selection'],
+                action: 'Copy it',
+            },
+            {
+                input: ['Double-click'],
+                action: 'Edit the query features of an atom, a bond or the selection',
+                only: 'fragment',
+            },
+        ],
+        note: 'These need the Select tool, which Space picks.',
+    },
+    {
+        title: 'Stereochemistry',
+        gestures: [],
+        note: 'Pink bonds flag a stereocentre with too little or too much information. Draw an up or down bond with its narrow end on the centre, then use the enhanced stereo tool to say whether the drawing is this enantiomer (abs), both of them (&) or one of the two (or).',
+    },
+];
+/** The documentation this guide summarises. */
+export const STRUCTURE_EDITOR_DOCS = [
+    { title: 'Tools and keys', url: 'https://docs.nmrium.org/help/ocl/' },
+    {
+        title: 'Atom properties',
+        url: 'https://docs.nmrium.org/chemical_structure/ocl/atom-properties/',
+    },
+    {
+        title: 'Stereochemistry',
+        url: 'https://docs.nmrium.org/ocl/stereochemistry/',
+    },
+];
+/**
+ * The guide for one editor: gestures that do nothing there are left out, and so
+ * is a section left with nothing to say.
+ * @param options - The editor the guide is for.
+ * @returns The sections to show.
+ */
+export function editorGuideSections(options = {}) {
+    const { mode = 'molecule', fragment = false } = options;
+    const sections = [];
+    for (const section of STRUCTURE_EDITOR_GUIDE) {
+        const gestures = section.gestures.filter(({ only }) => appliesTo(only, mode, fragment));
+        if (gestures.length === 0 && section.note === undefined)
+            continue;
+        sections.push({ ...section, gestures });
+    }
+    return sections;
+}
+function appliesTo(only, mode, fragment) {
+    if (only === undefined)
+        return true;
+    if (only === 'fragment')
+        return fragment;
+    return only === mode;
+}
+/**
+ * The text of a key cap.
+ * @param key - The key, `Mod` standing for the platform's shortcut modifier.
+ * @param isMac - Whether the page runs on a Mac.
+ * @returns What the cap shows.
+ */
+export function editorKeyLabel(key, isMac) {
+    if (key !== 'Mod')
+        return key;
+    return isMac ? '⌘' : 'Ctrl';
+}
+//# sourceMappingURL=editorGuide.js.map

package/lib/structure/core/editorGuide.js.map

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

package/lib/structure/core/editorToolbar.d.ts

@@ -0,0 +1,45 @@
+/**
+ * What each button of the openchemlib canvas editor's toolbar does.
+ *
+ * The toolbar is one canvas painted from a sprite, so there is no element per
+ * button to carry a title: the button under the pointer is found from where
+ * the pointer is (see `editorToolbarGeometry.ts`) and its entry here is what
+ * the tooltip says.
+ */
+/**
+ * Which editor a button works in. The reaction-only button is drawn greyed in
+ * a molecule editor, and the text tool is greyed in every editor react-ocl
+ * builds, since neither enables drawing objects.
+ */
+export type EditorToolbarAvailability = 'always' | 'reaction' | 'never';
+/** One button of the toolbar. */
+export interface EditorToolbarButton {
+    /** What the button is called. */
+    name: string;
+    /** What it does, in a sentence or two. */
+    description: string;
+    /**
+     * Keys that pick the tool, pressed while the pointer is over empty canvas.
+     * `Mod` stands for ⌘ on a Mac and Ctrl elsewhere.
+     * @default undefined — no key
+     */
+    keys?: readonly string[];
+    /**
+     * Which editor the button works in.
+     * @default 'always'
+     */
+    availability?: EditorToolbarAvailability;
+}
+/**
+ * The buttons, in the order the toolbar numbers them: down the first column,
+ * then down the second.
+ */
+export declare const EDITOR_TOOLBAR_BUTTONS: readonly EditorToolbarButton[];
+/**
+ * Whether a button can be used in an editor of the given kind.
+ * @param button - The button.
+ * @param mode - The kind of editor.
+ * @returns True when pressing the button selects its tool.
+ */
+export declare function isEditorToolbarButtonAvailable(button: EditorToolbarButton, mode: 'molecule' | 'reaction'): boolean;
+//# sourceMappingURL=editorToolbar.d.ts.map

package/lib/structure/core/editorToolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorToolbar.d.ts","sourceRoot":"","sources":["../../../src/structure/core/editorToolbar.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAExE,iCAAiC;AACjC,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB;;;OAGG;IACH,YAAY,CAAC,EAAE,yBAAyB,CAAC;CAC1C;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,mBAAmB,EAwGhE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,UAAU,GAAG,UAAU,GAC5B,OAAO,CAIT"}

package/lib/structure/core/editorToolbar.js

@@ -0,0 +1,132 @@
+/**
+ * What each button of the openchemlib canvas editor's toolbar does.
+ *
+ * The toolbar is one canvas painted from a sprite, so there is no element per
+ * button to carry a title: the button under the pointer is found from where
+ * the pointer is (see `editorToolbarGeometry.ts`) and its entry here is what
+ * the tooltip says.
+ */
+/**
+ * The buttons, in the order the toolbar numbers them: down the first column,
+ * then down the second.
+ */
+export const EDITOR_TOOLBAR_BUTTONS = [
+    { name: 'Clear', description: 'Erase the whole drawing.' },
+    {
+        name: 'Clean up',
+        description: 'Redraw the structure with fresh 2D coordinates. With part of it selected, the rest keeps its layout.',
+    },
+    {
+        name: 'Select',
+        description: 'Drag around atoms to select them: hold Alt for a rectangle, Shift to add to the selection. Drag a selection to move it, Shift-drag to copy it.',
+        keys: ['Space'],
+    },
+    {
+        name: 'Unknown configuration',
+        description: 'Click a stereocentre to mark its configuration as unknown; click again to undo it.',
+    },
+    {
+        name: 'Delete',
+        description: 'Click an atom or a bond to delete it.',
+        keys: ['0'],
+    },
+    {
+        name: 'Single bond',
+        description: 'Click empty space for a new bond, or drag from an atom. Clicking a bond again makes it double, then triple.',
+        keys: ['1'],
+    },
+    {
+        name: 'Up bond',
+        description: 'Wedged stereo bond, pointing toward the viewer. Its narrow end goes on the stereocentre.',
+        keys: ['u'],
+    },
+    ring('3-membered ring', '3'),
+    ring('5-membered ring', '5'),
+    ring('7-membered ring', '7'),
+    {
+        name: 'Positive charge',
+        description: 'Click an atom to raise its charge by one.',
+        keys: ['+'],
+    },
+    atom('Carbon', 'C', 'c'),
+    atom('Nitrogen', 'N', 'n'),
+    atom('Oxygen', 'O', 'o'),
+    atom('Fluorine', 'F', 'f'),
+    atom('Bromine', 'Br', 'b'),
+    atom('Hydrogen', 'H'),
+    { name: 'Undo', description: 'Revert the last change.', keys: ['Mod', 'Z'] },
+    {
+        name: 'Zoom and rotate',
+        description: 'Press where the centre should be, then drag up or down to zoom and sideways to rotate. With a selection, only that part moves.',
+        keys: ['z'],
+    },
+    {
+        name: 'Atom mapping',
+        description: 'Drag from a reactant atom to the same atom in a product: both get the same number. Click a mapped atom to unmap it.',
+        keys: ['m'],
+        availability: 'reaction',
+    },
+    {
+        name: 'Enhanced stereo',
+        description: 'Click a stereo bond to say what its centre means: abs, this enantiomer; &, both (racemic); or, one of the two. Press the button again to switch between the three.',
+    },
+    {
+        name: 'Text',
+        description: 'Place a text label in the drawing.',
+        availability: 'never',
+    },
+    {
+        name: 'Chain',
+        description: 'Drag from empty space or from an atom to draw a zigzag carbon chain.',
+        keys: ['2'],
+    },
+    {
+        name: 'Down bond',
+        description: 'Hashed stereo bond, pointing away from the viewer. Its narrow end goes on the stereocentre.',
+        keys: ['d'],
+    },
+    ring('4-membered ring', '4'),
+    ring('6-membered ring', '6'),
+    ring('Benzene ring', 'a'),
+    {
+        name: 'Negative charge',
+        description: 'Click an atom to lower its charge by one.',
+        keys: ['-'],
+    },
+    atom('Silicon', 'Si'),
+    atom('Phosphorus', 'P', 'p'),
+    atom('Sulfur', 'S', 's'),
+    atom('Chlorine', 'Cl', 'l'),
+    atom('Iodine', 'I', 'i'),
+    {
+        name: 'Any atom',
+        description: 'Pick any element, isotope, valence or radical in a dialog, then click to place it or to change an atom. Alt-click an atom to edit its own properties.',
+        keys: ['.'],
+    },
+];
+/**
+ * Whether a button can be used in an editor of the given kind.
+ * @param button - The button.
+ * @param mode - The kind of editor.
+ * @returns True when pressing the button selects its tool.
+ */
+export function isEditorToolbarButtonAvailable(button, mode) {
+    const { availability = 'always' } = button;
+    if (availability === 'always')
+        return true;
+    return availability === 'reaction' && mode === 'reaction';
+}
+function ring(name, key) {
+    return {
+        name,
+        description: 'Click empty space for a new ring, a bond to fuse one onto it, or an atom for a spiro ring.',
+        keys: [key],
+    };
+}
+function atom(name, symbol, key) {
+    const description = `Click empty space for a new ${symbol} atom, or an atom to turn it into ${symbol}.`;
+    return key === undefined
+        ? { name, description }
+        : { name, description, keys: [key] };
+}
+//# sourceMappingURL=editorToolbar.js.map

package/lib/structure/core/editorToolbar.js.map

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