react-cheminfo 0.11.0 → 0.13.0

package/lib/hooks/ui/useActiveHeading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActiveHeading.js","sourceRoot":"","sources":["../../../src/hooks/ui/useActiveHeading.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAiB1D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAAwB,EACxB,UAAgC,EAAE;IAElC,MAAM,EAAE,QAAQ,GAAG,gBAAgB,EAAE,WAAW,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAClE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAE9D,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAgC,CAAC;QAC7D,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO;QACnC,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,SAAS,OAAO;YACd,KAAK,GAAG,CAAC,CAAC;YACV,MAAM,OAAO,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;YAChD,IAAI,OAAO,KAAK,IAAI;gBAAE,OAAO;YAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YACpD,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YACxD,WAAW,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,QAAQ,CAAC,KAAK,CAAa,CAAC,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,SAAS,QAAQ;YACf,KAAK,KAAK,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC;QAED,QAAQ,EAAE,CAAC;QACX,MAAM,SAAS,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACnD,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QACzD,UAAU,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;YAC5D,UAAU,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACnD,IAAI,KAAK,KAAK,CAAC;gBAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;IAEvC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,gBAAgB,GAAG,wBAAwB,CAAC"}

package/lib/hooks/ui/useAsync.d.ts

@@ -0,0 +1,19 @@
+import type { AsyncState } from './asyncState.ts';
+/**
+ * Run an async task and follow where it stands, as a discriminated union.
+ *
+ * The task runs on mount and again whenever it or `refreshKey` changes. A
+ * re-run does not flip the state back to `loading`: what is on screen stays
+ * until the new answer arrives, and a refresh that fails keeps it rather than
+ * replacing it with an error. An answer that arrives after the component
+ * unmounted, or after a newer run started, is ignored.
+ *
+ * The task is a dependency, so pass a stable function — declared at module
+ * scope, or wrapped in `useCallback` over the values it reads.
+ * @param task - The async function to run.
+ * @param refreshKey - Changing it runs the task again; only its identity
+ * matters. Defaults to `undefined`.
+ * @returns Where the latest run stands.
+ */
+export declare function useAsync<TData>(task: () => Promise<TData>, refreshKey?: unknown): AsyncState<TData>;
+//# sourceMappingURL=useAsync.d.ts.map

package/lib/hooks/ui/useAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAsync.d.ts","sourceRoot":"","sources":["../../../src/hooks/ui/useAsync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAC5B,IAAI,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,EAC1B,UAAU,CAAC,EAAE,OAAO,GACnB,UAAU,CAAC,KAAK,CAAC,CAmBnB"}

package/lib/hooks/ui/useAsync.js

@@ -0,0 +1,36 @@
+import { useEffect, useState } from 'react';
+import { ASYNC_LOADING, asyncFailed, asyncSucceeded } from "./asyncState.js";
+/**
+ * Run an async task and follow where it stands, as a discriminated union.
+ *
+ * The task runs on mount and again whenever it or `refreshKey` changes. A
+ * re-run does not flip the state back to `loading`: what is on screen stays
+ * until the new answer arrives, and a refresh that fails keeps it rather than
+ * replacing it with an error. An answer that arrives after the component
+ * unmounted, or after a newer run started, is ignored.
+ *
+ * The task is a dependency, so pass a stable function — declared at module
+ * scope, or wrapped in `useCallback` over the values it reads.
+ * @param task - The async function to run.
+ * @param refreshKey - Changing it runs the task again; only its identity
+ * matters. Defaults to `undefined`.
+ * @returns Where the latest run stands.
+ */
+export function useAsync(task, refreshKey) {
+    const [state, setState] = useState(ASYNC_LOADING);
+    useEffect(() => {
+        let cancelled = false;
+        task().then((data) => {
+            if (!cancelled)
+                setState(asyncSucceeded(data));
+        }, (error) => {
+            if (!cancelled)
+                setState((previous) => asyncFailed(previous, error));
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [task, refreshKey]);
+    return state;
+}
+//# sourceMappingURL=useAsync.js.map

package/lib/hooks/ui/useAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAsync.js","sourceRoot":"","sources":["../../../src/hooks/ui/useAsync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE7E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,QAAQ,CACtB,IAA0B,EAC1B,UAAoB;IAEpB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAoB,aAAa,CAAC,CAAC;IAErE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,EAAE,CAAC,IAAI,CACT,CAAC,IAAI,EAAE,EAAE;YACP,IAAI,CAAC,SAAS;gBAAE,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QACjD,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,IAAI,CAAC,SAAS;gBAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;QACvE,CAAC,CACF,CAAC;QACF,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;IAEvB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/hooks/ui/useDocumentListNavigation.d.ts

@@ -0,0 +1,28 @@
+import type { RefObject } from 'react';
+import type { DocumentListNavigationOptions } from './documentListNavigation.ts';
+/** What {@link useDocumentListNavigation} is given. */
+export interface DocumentListNavigationHookOptions extends DocumentListNavigationOptions {
+    /**
+     * Finds the selected row inside the container, to scroll it into view when
+     * a key moved the selection.
+     * @default '[aria-selected="true"], [data-selected="true"]'
+     */
+    selectedSelector?: string;
+}
+/**
+ * Arrow-key navigation for a list the visitor does not have to click first.
+ *
+ * The keys are heard on the whole document, and the options are read through a
+ * ref, so the one listener always acts on the list as it now is. `ArrowUp` and
+ * `ArrowDown` move the selection, `Enter` activates it when `onActivate` is
+ * given, and nothing is taken from a text field, a modified key or a key an
+ * earlier handler already used. When a key moved the selection, the selected
+ * row is scrolled into view inside the container the returned ref is put on,
+ * on the next frame, once the page has drawn it. A selection set any other way
+ * — a click, the address, the first render — is left where it is, so a page
+ * never jumps on load.
+ * @param options - See {@link DocumentListNavigationHookOptions}.
+ * @returns The ref to put on the scrolling container of the rows.
+ */
+export declare function useDocumentListNavigation<TElement extends Element>(options: DocumentListNavigationHookOptions): RefObject<TElement | null>;
+//# sourceMappingURL=useDocumentListNavigation.d.ts.map

package/lib/hooks/ui/useDocumentListNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDocumentListNavigation.d.ts","sourceRoot":"","sources":["../../../src/hooks/ui/useDocumentListNavigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAGjF,uDAAuD;AACvD,MAAM,WAAW,iCAAkC,SAAQ,6BAA6B;IACtF;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,SAAS,OAAO,EAChE,OAAO,EAAE,iCAAiC,GACzC,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,CAkC5B"}

package/lib/hooks/ui/useDocumentListNavigation.js

@@ -0,0 +1,53 @@
+import { useEffect, useRef } from 'react';
+import { handleDocumentListKey } from "./documentListNavigation.js";
+/**
+ * Arrow-key navigation for a list the visitor does not have to click first.
+ *
+ * The keys are heard on the whole document, and the options are read through a
+ * ref, so the one listener always acts on the list as it now is. `ArrowUp` and
+ * `ArrowDown` move the selection, `Enter` activates it when `onActivate` is
+ * given, and nothing is taken from a text field, a modified key or a key an
+ * earlier handler already used. When a key moved the selection, the selected
+ * row is scrolled into view inside the container the returned ref is put on,
+ * on the next frame, once the page has drawn it. A selection set any other way
+ * — a click, the address, the first render — is left where it is, so a page
+ * never jumps on load.
+ * @param options - See {@link DocumentListNavigationHookOptions}.
+ * @returns The ref to put on the scrolling container of the rows.
+ */
+export function useDocumentListNavigation(options) {
+    const containerRef = useRef(null);
+    const optionsRef = useRef(options);
+    useEffect(() => {
+        optionsRef.current = options;
+    });
+    useEffect(() => {
+        const document = globalThis.document;
+        if (document === undefined)
+            return;
+        let frame;
+        function onKeyDown(event) {
+            const current = optionsRef.current;
+            if (!handleDocumentListKey(event, current))
+                return;
+            const selector = current.selectedSelector ?? SELECTED_SELECTOR;
+            if (frame !== undefined)
+                cancelAnimationFrame(frame);
+            frame = requestAnimationFrame(() => {
+                frame = undefined;
+                containerRef.current
+                    ?.querySelector(selector)
+                    ?.scrollIntoView({ block: 'nearest' });
+            });
+        }
+        document.addEventListener('keydown', onKeyDown);
+        return () => {
+            document.removeEventListener('keydown', onKeyDown);
+            if (frame !== undefined)
+                cancelAnimationFrame(frame);
+        };
+    }, []);
+    return containerRef;
+}
+const SELECTED_SELECTOR = '[aria-selected="true"], [data-selected="true"]';
+//# sourceMappingURL=useDocumentListNavigation.js.map

package/lib/hooks/ui/useDocumentListNavigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDocumentListNavigation.js","sourceRoot":"","sources":["../../../src/hooks/ui/useDocumentListNavigation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAYpE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAA0C;IAE1C,MAAM,YAAY,GAAG,MAAM,CAAW,IAAI,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnC,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAgC,CAAC;QAC7D,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO;QACnC,IAAI,KAAyB,CAAC;QAE9B,SAAS,SAAS,CAAC,KAAoB;YACrC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;YACnC,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC;gBAAE,OAAO;YACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,IAAI,iBAAiB,CAAC;YAC/D,IAAI,KAAK,KAAK,SAAS;gBAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC;YACrD,KAAK,GAAG,qBAAqB,CAAC,GAAG,EAAE;gBACjC,KAAK,GAAG,SAAS,CAAC;gBAClB,YAAY,CAAC,OAAO;oBAClB,EAAE,aAAa,CAAC,QAAQ,CAAC;oBACzB,EAAE,cAAc,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YAC3C,CAAC,CAAC,CAAC;QACL,CAAC;QAED,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAChD,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACnD,IAAI,KAAK,KAAK,SAAS;gBAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACvD,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,iBAAiB,GAAG,gDAAgD,CAAC"}

package/lib/hooks/ui/usePolling.d.ts

@@ -0,0 +1,30 @@
+import type { PollingOptions, PollingSnapshot } from './pollingController.ts';
+/** What {@link usePolling} is given. */
+export interface UsePollingOptions<TValue> extends PollingOptions<TValue> {
+    /**
+     * Whether the polling runs. Turning it off stops it and forgets what it
+     * learned; turning it on starts a fresh run.
+     * @default true
+     */
+    enabled?: boolean;
+}
+/** Where the polling stands, and how to start it over. */
+export interface PollingState<TValue> extends PollingSnapshot<TValue> {
+    /** Forget what was learned and poll again from now, e.g. after a job was launched. */
+    restart: () => void;
+}
+/**
+ * Poll a backend job until it is done.
+ *
+ * One request at a time: the next poll is scheduled once the previous one
+ * settled, a failed poll keeps the last answer and is retried, and nothing is
+ * asked while the tab is hidden. A new `fetcher` — the status of another job —
+ * starts a fresh run and forgets what the previous one learned, as turning
+ * `enabled` off and on and `restart` do, so pass a stable function; `interval`
+ * and `isDone` are read at each poll and may be inline.
+ * @param fetcher - Asks the backend once.
+ * @param options - See {@link UsePollingOptions}.
+ * @returns The latest answer, the latest failure, whether it is done, and `restart`.
+ */
+export declare function usePolling<TValue>(fetcher: () => Promise<TValue>, options: UsePollingOptions<TValue>): PollingState<TValue>;
+//# sourceMappingURL=usePolling.d.ts.map

package/lib/hooks/ui/usePolling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePolling.d.ts","sourceRoot":"","sources":["../../../src/hooks/ui/usePolling.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EAEd,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAOhC,wCAAwC;AACxC,MAAM,WAAW,iBAAiB,CAAC,MAAM,CAAE,SAAQ,cAAc,CAAC,MAAM,CAAC;IACvE;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,0DAA0D;AAC1D,MAAM,WAAW,YAAY,CAAC,MAAM,CAAE,SAAQ,eAAe,CAAC,MAAM,CAAC;IACnE,sFAAsF;IACtF,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EAC9B,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,GACjC,YAAY,CAAC,MAAM,CAAC,CAmDtB"}

package/lib/hooks/ui/usePolling.js

@@ -0,0 +1,52 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { POLLING_IDLE, isNewPollingRun, startPolling, } from "./pollingController.js";
+/**
+ * Poll a backend job until it is done.
+ *
+ * One request at a time: the next poll is scheduled once the previous one
+ * settled, a failed poll keeps the last answer and is retried, and nothing is
+ * asked while the tab is hidden. A new `fetcher` — the status of another job —
+ * starts a fresh run and forgets what the previous one learned, as turning
+ * `enabled` off and on and `restart` do, so pass a stable function; `interval`
+ * and `isDone` are read at each poll and may be inline.
+ * @param fetcher - Asks the backend once.
+ * @param options - See {@link UsePollingOptions}.
+ * @returns The latest answer, the latest failure, whether it is done, and `restart`.
+ */
+export function usePolling(fetcher, options) {
+    const { enabled = true, interval, retryInterval, isDone, pauseWhenHidden = true, } = options;
+    const [snapshot, setSnapshot] = useState(POLLING_IDLE);
+    const [run, setRun] = useState(0);
+    const [currentRun, setCurrentRun] = useState({
+        fetcher,
+        enabled,
+    });
+    if (isNewPollingRun(currentRun, { fetcher, enabled })) {
+        setCurrentRun({ fetcher, enabled });
+        setSnapshot(POLLING_IDLE);
+    }
+    const latestRef = useRef({ interval, isDone });
+    useEffect(() => {
+        latestRef.current = { interval, isDone };
+    });
+    const fixedRetryInterval = retryInterval ?? (typeof interval === 'number' ? interval : undefined);
+    useEffect(() => {
+        if (!enabled)
+            return;
+        return startPolling(fetcher, {
+            interval: (value) => {
+                const current = latestRef.current.interval;
+                return typeof current === 'number' ? current : current(value);
+            },
+            retryInterval: fixedRetryInterval,
+            isDone: (value) => latestRef.current.isDone?.(value) ?? false,
+            pauseWhenHidden,
+        }, setSnapshot);
+    }, [fetcher, enabled, run, fixedRetryInterval, pauseWhenHidden]);
+    const restart = useCallback(() => {
+        setSnapshot(POLLING_IDLE);
+        setRun((count) => count + 1);
+    }, []);
+    return useMemo(() => ({ ...snapshot, restart }), [snapshot, restart]);
+}
+//# sourceMappingURL=usePolling.js.map

package/lib/hooks/ui/usePolling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePolling.js","sourceRoot":"","sources":["../../../src/hooks/ui/usePolling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAO1E,OAAO,EACL,YAAY,EACZ,eAAe,EACf,YAAY,GACb,MAAM,wBAAwB,CAAC;AAkBhC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CACxB,OAA8B,EAC9B,OAAkC;IAElC,MAAM,EACJ,OAAO,GAAG,IAAI,EACd,QAAQ,EACR,aAAa,EACb,MAAM,EACN,eAAe,GAAG,IAAI,GACvB,GAAG,OAAO,CAAC;IACZ,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAC3B,QAAQ,CAA0B,YAAY,CAAC,CAAC;IAClD,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAqB;QAC/D,OAAO;QACP,OAAO;KACR,CAAC,CAAC;IACH,IAAI,eAAe,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QACtD,aAAa,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACpC,WAAW,CAAC,YAAY,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/C,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,CAAC,OAAO,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,MAAM,kBAAkB,GACtB,aAAa,IAAI,CAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEzE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,OAAO,YAAY,CACjB,OAAO,EACP;YACE,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;gBAClB,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC;gBAC3C,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAChE,CAAC;YACD,aAAa,EAAE,kBAAkB;YACjC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK;YAC7D,eAAe;SAChB,EACD,WAAW,CACZ,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,kBAAkB,EAAE,eAAe,CAAC,CAAC,CAAC;IAEjE,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,WAAW,CAAC,YAAY,CAAC,CAAC;QAC1B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC/B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AACxE,CAAC"}

package/lib/hooks/ui/useResizeObserver.d.ts

@@ -1,4 +1,4 @@
-import type { RefObject } from 'react';
+import type { ElementTarget } from './elementTarget.ts';
 /** The content-box size of an element, in CSS pixels. */
 export interface ElementSize {
     /** Content-box width. */
@@ -13,8 +13,10 @@ export interface ElementSize {
  * passed on every render without tearing the observer down and setting it up
  * again. Nothing is observed where `ResizeObserver` is missing — a server
  * render, or a test rendering to a string — so the hook is safe to call there.
- * @param ref - Ref holding the element to watch.
+ * @param target - Ref holding the element to watch, or the element itself.
+ * Pass the element when it mounts later than the component, so the observer
+ * follows it.
  * @param callback - Receives the new content-box size.
  */
-export declare function useResizeObserver(ref: RefObject<Element | null>, callback: (size: ElementSize) => void): void;
+export declare function useResizeObserver(target: ElementTarget, callback: (size: ElementSize) => void): void;
 //# sourceMappingURL=useResizeObserver.d.ts.map

package/lib/hooks/ui/useResizeObserver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useResizeObserver.d.ts","sourceRoot":"","sources":["../../../src/hooks/ui/useResizeObserver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,EAC9B,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,GACpC,IAAI,CAyBN"}
+{"version":3,"file":"useResizeObserver.d.ts","sourceRoot":"","sources":["../../../src/hooks/ui/useResizeObserver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,GACpC,IAAI,CAyBN"}

package/lib/hooks/ui/useResizeObserver.js

@@ -1,4 +1,5 @@
 import { useEffect, useRef } from 'react';
+import { resolveElementTarget } from "./elementTarget.js";
 /**
  * Call `callback` whenever the observed element's content box changes size.
  *
@@ -6,16 +7,18 @@ import { useEffect, useRef } from 'react';
  * passed on every render without tearing the observer down and setting it up
  * again. Nothing is observed where `ResizeObserver` is missing — a server
  * render, or a test rendering to a string — so the hook is safe to call there.
- * @param ref - Ref holding the element to watch.
+ * @param target - Ref holding the element to watch, or the element itself.
+ * Pass the element when it mounts later than the component, so the observer
+ * follows it.
  * @param callback - Receives the new content-box size.
  */
-export function useResizeObserver(ref, callback) {
+export function useResizeObserver(target, callback) {
     const callbackRef = useRef(callback);
     useEffect(() => {
         callbackRef.current = callback;
     });
     useEffect(() => {
-        const element = ref.current;
+        const element = resolveElementTarget(target);
         const Observer = globalThis.ResizeObserver;
         if (element === null || Observer === undefined)
             return;
@@ -32,6 +35,6 @@ export function useResizeObserver(ref, callback) {
         return () => {
             observer.disconnect();
         };
-    }, [ref]);
+    }, [target]);
 }
 //# sourceMappingURL=useResizeObserver.js.map

package/lib/hooks/ui/useResizeObserver.js.map

@@ -1 +1 @@
-{"version":3,"file":"useResizeObserver.js","sourceRoot":"","sources":["../../../src/hooks/ui/useResizeObserver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAU1C;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAA8B,EAC9B,QAAqC;IAErC,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAErC,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC5B,MAAM,QAAQ,GAAG,UAAU,CAAC,cACO,CAAC;QACpC,IAAI,OAAO,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO;QACvD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE;YACxC,MAAM,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7B,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO;YAChC,WAAW,CAAC,OAAO,CAAC;gBAClB,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,KAAK;gBAC9B,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,MAAM;aACjC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1B,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACZ,CAAC"}
+{"version":3,"file":"useResizeObserver.js","sourceRoot":"","sources":["../../../src/hooks/ui/useResizeObserver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAU1D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAqB,EACrB,QAAqC;IAErC,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAErC,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,UAAU,CAAC,cACO,CAAC;QACpC,IAAI,OAAO,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO;QACvD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE;YACxC,MAAM,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7B,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO;YAChC,WAAW,CAAC,OAAO,CAAC;gBAClB,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,KAAK;gBAC9B,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,MAAM;aACjC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1B,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AACf,CAAC"}

package/lib/molecule3d/core/exportImage.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The pieces of an image export that need neither React nor molstar: wrapping
+ * a rendered picture in an SVG file, and reading a data URI back as bytes.
+ */
+/** The pixel size of a rendered image. */
+export interface ImageSize {
+    width: number;
+    height: number;
+}
+/**
+ * An SVG document holding one raster image at its own size.
+ *
+ * A molecule rendered by WebGL has no vector form, so its SVG is the picture
+ * itself, embedded: it opens in every editor and can be placed beside vector
+ * artwork, but it does not stay sharp past the resolution it was rendered at.
+ * @param dataUri - The image, as a `data:` URI.
+ * @param size - Its pixel size.
+ * @returns The SVG markup.
+ */
+export declare function rasterSvgMarkup(dataUri: string, size: ImageSize): string;
+/**
+ * Decode a base64 `data:` URI into its bytes, without `fetch`, which a page's
+ * content security policy may forbid for `data:` addresses.
+ * @param dataUri - A base64 data URI, e.g. `data:image/png;base64,iVBOR…`.
+ * @returns The decoded bytes.
+ * @throws {Error} When the URI is not base64-encoded.
+ */
+export declare function dataUriBytes(dataUri: string): Uint8Array<ArrayBuffer>;
+//# sourceMappingURL=exportImage.d.ts.map

package/lib/molecule3d/core/exportImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportImage.d.ts","sourceRoot":"","sources":["../../../src/molecule3d/core/exportImage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAIxE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAWrE"}

package/lib/molecule3d/core/exportImage.js

@@ -0,0 +1,42 @@
+/**
+ * The pieces of an image export that need neither React nor molstar: wrapping
+ * a rendered picture in an SVG file, and reading a data URI back as bytes.
+ */
+/**
+ * An SVG document holding one raster image at its own size.
+ *
+ * A molecule rendered by WebGL has no vector form, so its SVG is the picture
+ * itself, embedded: it opens in every editor and can be placed beside vector
+ * artwork, but it does not stay sharp past the resolution it was rendered at.
+ * @param dataUri - The image, as a `data:` URI.
+ * @param size - Its pixel size.
+ * @returns The SVG markup.
+ */
+export function rasterSvgMarkup(dataUri, size) {
+    const { width, height } = size;
+    const href = escapeAttribute(dataUri);
+    return `<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}"><image width="${width}" height="${height}" href="${href}" xlink:href="${href}"/></svg>`;
+}
+/**
+ * Decode a base64 `data:` URI into its bytes, without `fetch`, which a page's
+ * content security policy may forbid for `data:` addresses.
+ * @param dataUri - A base64 data URI, e.g. `data:image/png;base64,iVBOR…`.
+ * @returns The decoded bytes.
+ * @throws {Error} When the URI is not base64-encoded.
+ */
+export function dataUriBytes(dataUri) {
+    const comma = dataUri.indexOf(',');
+    if (comma === -1 || !dataUri.slice(0, comma).endsWith(';base64')) {
+        throw new Error('Expected a base64 data URI.');
+    }
+    const binary = atob(dataUri.slice(comma + 1));
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.codePointAt(i) ?? 0;
+    }
+    return bytes;
+}
+function escapeAttribute(value) {
+    return value.replaceAll('&', '&amp;').replaceAll('"', '&quot;');
+}
+//# sourceMappingURL=exportImage.js.map

package/lib/molecule3d/core/exportImage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportImage.js","sourceRoot":"","sources":["../../../src/molecule3d/core/exportImage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,IAAe;IAC9D,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC/B,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,6FAA6F,KAAK,aAAa,MAAM,kBAAkB,KAAK,IAAI,MAAM,mBAAmB,KAAK,aAAa,MAAM,WAAW,IAAI,iBAAiB,IAAI,WAAW,CAAC;AAC1P,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAClE,CAAC"}

package/lib/molecule3d/core/gestures.d.ts

@@ -0,0 +1,17 @@
+/**
+ * What the mouse and the keyboard do on the molecule canvas: molstar's default
+ * trackball and focus bindings, which the viewer keeps.
+ */
+/** A key, drawn as a key cap. */
+export interface Molecule3DGestureKey {
+    key: string;
+}
+/** One gesture and what it does. */
+export interface Molecule3DGesture {
+    /** Keys, and plain text for the mouse part; unique within one gesture. */
+    input: ReadonlyArray<string | Molecule3DGestureKey>;
+    action: string;
+}
+/** The gestures, in the order the help popover lists them. */
+export declare const MOLECULE_3D_GESTURES: readonly Molecule3DGesture[];
+//# sourceMappingURL=gestures.d.ts.map

package/lib/molecule3d/core/gestures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gestures.d.ts","sourceRoot":"","sources":["../../../src/molecule3d/core/gestures.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iCAAiC;AACjC,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,oCAAoC;AACpC,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,KAAK,EAAE,aAAa,CAAC,MAAM,GAAG,oBAAoB,CAAC,CAAC;IACpD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,EAAE,SAAS,iBAAiB,EAgB5D,CAAC"}

package/lib/molecule3d/core/gestures.js

@@ -0,0 +1,23 @@
+/**
+ * What the mouse and the keyboard do on the molecule canvas: molstar's default
+ * trackball and focus bindings, which the viewer keeps.
+ */
+/** The gestures, in the order the help popover lists them. */
+export const MOLECULE_3D_GESTURES = [
+    { input: ['Drag'], action: 'Rotate' },
+    {
+        input: [{ key: 'Shift' }, '+', { key: 'Ctrl' }, '+ drag'],
+        action: 'Rotate in the plane of the screen',
+    },
+    {
+        input: [{ key: 'Q' }, 'or', { key: 'E' }],
+        action: 'Rotate in the plane, while held',
+    },
+    { input: ['Right-drag'], action: 'Move' },
+    { input: [{ key: 'Ctrl' }, '+ drag'], action: 'Move' },
+    { input: ['Scroll'], action: 'Zoom' },
+    { input: [{ key: 'Shift' }, '+ scroll'], action: 'Clip around the centre' },
+    { input: ['Click an atom'], action: 'Centre on it' },
+    { input: ['Click the background'], action: 'Centre on the molecule' },
+];
+//# sourceMappingURL=gestures.js.map

package/lib/molecule3d/core/gestures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gestures.js","sourceRoot":"","sources":["../../../src/molecule3d/core/gestures.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,oBAAoB,GAAiC;IAChE,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE;IACrC;QACE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC;QACzD,MAAM,EAAE,mCAAmC;KAC5C;IACD;QACE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QACzC,MAAM,EAAE,iCAAiC;KAC1C;IACD,EAAE,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE;IACzC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE;IACtD,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE;IACrC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,wBAAwB,EAAE;IAC3E,EAAE,KAAK,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE;IACpD,EAAE,KAAK,EAAE,CAAC,sBAAsB,CAAC,EAAE,MAAM,EAAE,wBAAwB,EAAE;CACtE,CAAC"}

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

@@ -0,0 +1,9 @@
+export type { ImageSize } from './exportImage.ts';
+export { dataUriBytes, rasterSvgMarkup } from './exportImage.ts';
+export type { Molecule3DGesture, Molecule3DGestureKey } from './gestures.ts';
+export { MOLECULE_3D_GESTURES } from './gestures.ts';
+export type { AtomReference, Measurement, MeasurementKind, } from './measurement.ts';
+export { MEASUREMENT_ATOM_COUNTS, MEASUREMENT_KINDS, MEASUREMENT_LABELS, } from './measurement.ts';
+export type { Molecule3DFile, Molecule3DSettings, Molecule3DTools, RepresentationId, SurfaceColoringId, } from './settings.ts';
+export { DEFAULT_MOLECULE_3D_SETTINGS, DEFAULT_MOLECULE_3D_TOOLS, MOLECULE_3D_RANGES, REPRESENTATIONS, REPRESENTATION_LABELS, SURFACE_CHARGE_COLORS, SURFACE_COLORINGS, SURFACE_COLORING_LABELS, isRepresentationId, isSurfaceColoringId, normalizeMolecule3DSettings, resolveMolecule3DTools, } from './settings.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/molecule3d/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EACV,aAAa,EACb,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,eAAe,CAAC"}

package/lib/molecule3d/core/index.js

@@ -0,0 +1,5 @@
+export { dataUriBytes, rasterSvgMarkup } from "./exportImage.js";
+export { MOLECULE_3D_GESTURES } from "./gestures.js";
+export { MEASUREMENT_ATOM_COUNTS, MEASUREMENT_KINDS, MEASUREMENT_LABELS, } from "./measurement.js";
+export { DEFAULT_MOLECULE_3D_SETTINGS, DEFAULT_MOLECULE_3D_TOOLS, MOLECULE_3D_RANGES, REPRESENTATIONS, REPRESENTATION_LABELS, SURFACE_CHARGE_COLORS, SURFACE_COLORINGS, SURFACE_COLORING_LABELS, isRepresentationId, isSurfaceColoringId, normalizeMolecule3DSettings, resolveMolecule3DTools, } from "./settings.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/molecule3d/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAMrD,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,eAAe,CAAC"}

package/lib/molecule3d/core/measurement.d.ts

@@ -0,0 +1,30 @@
+/**
+ * What a measurement on a 3D molecule is, without React and without molstar,
+ * so a site can store, persist or share measurements on its own.
+ *
+ * Atoms are named by position rather than by molstar loci, so a measurement
+ * taken on one conformer lands on the same atoms of every other conformer of
+ * the same molecule — which is what lets a reader watch a dihedral change down
+ * a list of conformers.
+ */
+/** The three geometric measurements, in the order the toolbar offers them. */
+export declare const MEASUREMENT_KINDS: readonly ["distance", "angle", "dihedral"];
+/** One of {@link MEASUREMENT_KINDS}. */
+export type MeasurementKind = (typeof MEASUREMENT_KINDS)[number];
+/** How many atoms each kind is measured between. */
+export declare const MEASUREMENT_ATOM_COUNTS: Record<MeasurementKind, number>;
+/** What the toolbar calls each kind. */
+export declare const MEASUREMENT_LABELS: Record<MeasurementKind, string>;
+/** One atom of the displayed structure, by position. */
+export interface AtomReference {
+    /** Index of the unit in molstar's `structure.units`; 0 for a molfile. */
+    unit: number;
+    /** Index of the atom inside that unit. */
+    element: number;
+}
+/** One measurement, with its atoms in the order they were picked. */
+export interface Measurement {
+    kind: MeasurementKind;
+    atoms: readonly AtomReference[];
+}
+//# sourceMappingURL=measurement.d.ts.map

package/lib/molecule3d/core/measurement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurement.d.ts","sourceRoot":"","sources":["../../../src/molecule3d/core/measurement.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,4CAA6C,CAAC;AAE5E,wCAAwC;AACxC,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,oDAAoD;AACpD,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAInE,CAAC;AAEF,wCAAwC;AACxC,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAI9D,CAAC;AAEF,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CACjC"}

package/lib/molecule3d/core/measurement.js

@@ -0,0 +1,24 @@
+/**
+ * What a measurement on a 3D molecule is, without React and without molstar,
+ * so a site can store, persist or share measurements on its own.
+ *
+ * Atoms are named by position rather than by molstar loci, so a measurement
+ * taken on one conformer lands on the same atoms of every other conformer of
+ * the same molecule — which is what lets a reader watch a dihedral change down
+ * a list of conformers.
+ */
+/** The three geometric measurements, in the order the toolbar offers them. */
+export const MEASUREMENT_KINDS = ['distance', 'angle', 'dihedral'];
+/** How many atoms each kind is measured between. */
+export const MEASUREMENT_ATOM_COUNTS = {
+    distance: 2,
+    angle: 3,
+    dihedral: 4,
+};
+/** What the toolbar calls each kind. */
+export const MEASUREMENT_LABELS = {
+    distance: 'Distance',
+    angle: 'Angle',
+    dihedral: 'Dihedral angle',
+};
+//# sourceMappingURL=measurement.js.map

package/lib/molecule3d/core/measurement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurement.js","sourceRoot":"","sources":["../../../src/molecule3d/core/measurement.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC;AAK5E,oDAAoD;AACpD,MAAM,CAAC,MAAM,uBAAuB,GAAoC;IACtE,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,CAAC;IACR,QAAQ,EAAE,CAAC;CACZ,CAAC;AAEF,wCAAwC;AACxC,MAAM,CAAC,MAAM,kBAAkB,GAAoC;IACjE,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,gBAAgB;CAC3B,CAAC"}