react-cheminfo 0.64.0 → 0.65.0

package/lib/molecule3d/ui/useMoleculeScene.js

@@ -5,10 +5,11 @@
  * The draw is coalesced into one animation frame, so dragging a slider costs
  * one rebuild rather than one per pixel, and the camera is framed only when the
  * molecule is new — a restyle that snapped the view back would undo the
- * reader's orientation.
+ * reader's orientation. What each draw rebuilds is the scene drawer's call: a
+ * change of the measurements alone redraws them and nothing else.
  */
 import { useCallback, useEffect, useRef } from 'react';
-import { drawScene } from "./drawScene.js";
+import { SceneDrawer } from "./sceneDrawer.js";
 import { DEFAULT_CAMERA_SETTLE_DELAY, useSharedCamera, } from "./useSharedCamera.js";
 /**
  * Draw the scene the options describe, and keep it drawn.
@@ -17,7 +18,7 @@ import { DEFAULT_CAMERA_SETTLE_DELAY, useSharedCamera, } from "./useSharedCamera
  */
 export function useMoleculeScene(options) {
     const { container, viewerRef, molfile, frameNewMolecule, settings, measurements, spinning, onFailureChange, camera: cameraProps, } = options;
-    const framedRef = useRef(null);
+    const drawerRef = useRef(null);
     const reportFailure = useRef(onFailureChange);
     useEffect(() => {
         reportFailure.current = onFailureChange;
@@ -34,27 +35,17 @@ export function useMoleculeScene(options) {
         const viewer = viewerRef.current;
         if (container === null || viewer === null)
             return;
+        // A new viewer starts from an empty scene, so it gets a drawer of its own.
+        if (drawerRef.current?.viewer !== viewer) {
+            drawerRef.current = new SceneDrawer(viewer, camera.takeLinkedCamera);
+        }
+        const drawer = drawerRef.current;
         let cancelled = false;
         const frame = requestAnimationFrame(() => {
-            const framed = framedRef.current;
-            const isNew = molfile !== null &&
-                (framed?.molfile !== molfile || framed.viewer !== viewer);
-            framedRef.current = molfile === null ? null : { molfile, viewer };
-            // The link's camera is spent on the first molecule framed; afterwards the
-            // camera is the reader's and a new molecule is framed as usual.
-            const linked = isNew
-                ? camera.takeLinkedCamera()
-                : null;
-            const frameCamera = isNew && linked === null ? frameNewMolecule : 'none';
-            void drawScene(viewer, molfile, settings, measurements, frameCamera)
-                .then(() => {
-                if (cancelled)
-                    return;
-                if (linked !== null)
-                    void viewer.setCamera(linked);
-                reportFailure.current(null);
-            })
-                .catch((error) => {
+            drawer.draw({ molfile, settings, measurements, frameNewMolecule }).then(() => {
+                if (!cancelled)
+                    reportFailure.current(null);
+            }, (error) => {
                 if (cancelled)
                     return;
                 reportFailure.current(error instanceof Error ? error.message : String(error));

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

@@ -1 +1 @@
-{"version":3,"file":"useMoleculeScene.js","sourceRoot":"","sources":["../../../src/molecule3d/ui/useMoleculeScene.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useMoleculeScene.js","sourceRoot":"","sources":["../../../src/molecule3d/ui/useMoleculeScene.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAMvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,2BAA2B,EAC3B,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAkC9B;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA6B;IAC5D,MAAM,EACJ,SAAS,EACT,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,MAAM,EAAE,WAAW,GACpB,GAAG,OAAO,CAAC;IACZ,MAAM,SAAS,GAAG,MAAM,CAAqB,IAAI,CAAC,CAAC;IACnD,MAAM,aAAa,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;IAC9C,SAAS,CAAC,GAAG,EAAE;QACb,aAAa,CAAC,OAAO,GAAG,eAAe,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,eAAe,CAAC;QAC7B,SAAS;QACT,SAAS;QACT,QAAQ;QACR,aAAa,EAAE,WAAW,CAAC,aAAa,IAAI,IAAI;QAChD,cAAc,EAAE,WAAW,CAAC,cAAc;QAC1C,WAAW,EAAE,WAAW,CAAC,iBAAiB,IAAI,2BAA2B;KAC1E,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;QACjC,IAAI,SAAS,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO;QAClD,2EAA2E;QAC3E,IAAI,SAAS,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;YACzC,SAAS,CAAC,OAAO,GAAG,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;QACjC,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAG,EAAE;YACvC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC,CAAC,IAAI,CACrE,GAAG,EAAE;gBACH,IAAI,CAAC,SAAS;oBAAE,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC9C,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;gBACjB,IAAI,SAAS;oBAAE,OAAO;gBACtB,aAAa,CAAC,OAAO,CACnB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;YACJ,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;YACjB,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC,CAAC;IACJ,CAAC,EAAE;QACD,SAAS;QACT,SAAS;QACT,OAAO;QACP,gBAAgB;QAChB,QAAQ;QACR,YAAY;QACZ,MAAM;KACP,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;QACjC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAClB,KAAK,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;IACxC,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAExB,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC"}

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

@@ -29,9 +29,7 @@ export interface SharedCameraOptions {
 }
 /**
  * What {@link useSharedCamera} answers. The same object on every render: the
- * draw effect keys on it, and a fresh one would tear the scene down and build
- * it again — which makes molstar frame the model afresh and loses the camera a
- * link had just restored.
+ * draw effect keys on it, and a fresh one would run it again for nothing.
  */
 export interface SharedCamera {
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"useSharedCamera.d.ts","sourceRoot":"","sources":["../../../src/molecule3d/ui/useSharedCamera.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,iFAAiF;AACjF,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,gCAAgC;IAChC,SAAS,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC9C,iEAAiE;IACjE,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACvC,2DAA2D;IAC3D,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACpD,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,gBAAgB,GAAG,IAAI,CAAC;IAChD,mEAAmE;IACnE,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CA6D1E"}
+{"version":3,"file":"useSharedCamera.d.ts","sourceRoot":"","sources":["../../../src/molecule3d/ui/useSharedCamera.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,iFAAiF;AACjF,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,gCAAgC;IAChC,SAAS,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC9C,iEAAiE;IACjE,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACvC,2DAA2D;IAC3D,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACpD,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,gBAAgB,GAAG,IAAI,CAAC;IAChD,mEAAmE;IACnE,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CA6D1E"}

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

@@ -1 +1 @@
-{"version":3,"file":"useSharedCamera.js","sourceRoot":"","sources":["../../../src/molecule3d/ui/useSharedCamera.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAGhE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,iFAAiF;AACjF,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAmC/C;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAA4B;IAC1D,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IACtD,sCAAsC;IACtC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,4EAA4E;IAC5E,4DAA4D;IAC5D,MAAM,WAAW,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IAChD,6EAA6E;IAC7E,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;QAChC,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;IAC1B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,gBAAgB,GAAG,WAAW,CAAC,GAAG,EAAE;QACxC,IAAI,SAAS,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QACnC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC;QAC5C,IAAI,MAAM,KAAK,IAAI;YAAE,WAAW,CAAC,OAAO,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC1E,OAAO,MAAM,CAAC;IAChB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,6EAA6E;IAC7E,yEAAyE;IACzE,4EAA4E;IAC5E,wDAAwD;IACxD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;QACjC,IAAI,SAAS,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO;QAClD,IAAI,KAAK,GAAyC,IAAI,CAAC;QACvD,SAAS,CAAC,gBAAgB,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QACpD,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,EAAE;YACjD,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO;YAC5B,IAAI,KAAK,KAAK,IAAI;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YACxC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,KAAK,GAAG,IAAI,CAAC;gBACb,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;gBAC/B,IAAI,OAAO,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,OAAO;oBAAE,OAAO;gBAClD,MAAM,IAAI,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;gBAC5C,IAAI,IAAI,KAAK,WAAW,CAAC,OAAO;oBAAE,OAAO;gBACzC,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;gBAC3B,OAAO,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC,EAAE,WAAW,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,IAAI,KAAK,KAAK,IAAI;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YACxC,SAAS,CAAC,mBAAmB,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;YACvD,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACjD,YAAY,EAAE,CAAC;QACjB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IAElD,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC,EACtC,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAC7B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"useSharedCamera.js","sourceRoot":"","sources":["../../../src/molecule3d/ui/useSharedCamera.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAGhE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,iFAAiF;AACjF,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAiC/C;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAA4B;IAC1D,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IACtD,sCAAsC;IACtC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,4EAA4E;IAC5E,4DAA4D;IAC5D,MAAM,WAAW,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IAChD,6EAA6E;IAC7E,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;QAChC,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;IAC1B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,gBAAgB,GAAG,WAAW,CAAC,GAAG,EAAE;QACxC,IAAI,SAAS,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QACnC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC;QAC5C,IAAI,MAAM,KAAK,IAAI;YAAE,WAAW,CAAC,OAAO,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC1E,OAAO,MAAM,CAAC;IAChB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,6EAA6E;IAC7E,yEAAyE;IACzE,4EAA4E;IAC5E,wDAAwD;IACxD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;QACjC,IAAI,SAAS,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO;QAClD,IAAI,KAAK,GAAyC,IAAI,CAAC;QACvD,SAAS,CAAC,gBAAgB,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QACpD,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,EAAE;YACjD,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO;YAC5B,IAAI,KAAK,KAAK,IAAI;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YACxC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,KAAK,GAAG,IAAI,CAAC;gBACb,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;gBAC/B,IAAI,OAAO,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,OAAO;oBAAE,OAAO;gBAClD,MAAM,IAAI,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;gBAC5C,IAAI,IAAI,KAAK,WAAW,CAAC,OAAO;oBAAE,OAAO;gBACzC,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;gBAC3B,OAAO,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC,EAAE,WAAW,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,IAAI,KAAK,KAAK,IAAI;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YACxC,SAAS,CAAC,mBAAmB,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;YACvD,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACjD,YAAY,EAAE,CAAC;QACjB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IAElD,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC,EACtC,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAC7B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,5 @@
+export { createMoleculesClient } from './moleculesClient.ts';
+export type { MoleculesClient, MoleculesClientOptions, } from './moleculesClientApi.ts';
+export { MoleculesError } from './moleculesClientApi.ts';
+export type { ImportStarted, ImportState, LookupResponse, LookupResult, MoleculeInfo, MoleculeInput, PurgeResponse, RetryDetails, SubmitResponse, SubmitResult, SubmitSummary, } from './moleculesTypes.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/moleculesClient/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EACV,eAAe,EACf,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,GACd,MAAM,qBAAqB,CAAC"}

package/lib/moleculesClient/core/index.js

@@ -0,0 +1,3 @@
+export { createMoleculesClient } from "./moleculesClient.js";
+export { MoleculesError } from "./moleculesClientApi.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/moleculesClient/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAK7D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC"}

package/lib/moleculesClient/core/moleculesClient.d.ts

@@ -0,0 +1,12 @@
+import type { MoleculesClient, MoleculesClientOptions } from './moleculesClientApi.ts';
+/**
+ * A client of the routes a source writes through on molecules.cheminfo.org,
+ * retrying while the server is busy (503), throttling (429), being restarted
+ * (502, 504) or out of reach. Each attempt has its own deadline, the pauses
+ * double with a spread and honour `Retry-After`, and bodies travel gzipped.
+ * Browser-safe: it reads no Node module.
+ * @param options - Where it answers, the token, and how hard to insist.
+ * @returns The client.
+ */
+export declare function createMoleculesClient(options: MoleculesClientOptions): MoleculesClient;
+//# sourceMappingURL=moleculesClient.d.ts.map

package/lib/moleculesClient/core/moleculesClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moleculesClient.d.ts","sourceRoot":"","sources":["../../../src/moleculesClient/core/moleculesClient.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AA0CjC;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,GAC9B,eAAe,CAkHjB"}

package/lib/moleculesClient/core/moleculesClient.js

@@ -0,0 +1,105 @@
+import { XSadd } from 'ml-xsadd';
+import { trimTrailingSlash } from "../../router/core/address.js";
+import { MoleculesError } from "./moleculesClientApi.js";
+import { causeOf, gzipBody, messageOf, pause, requestSignal, retryAfter, } from "./requestRetry.js";
+/** Statuses a request is tried again on: the server is busy or in between. */
+const RETRIED_STATUSES = new Set([429, 502, 503, 504]);
+/** The doublings of the pause, after which it stays where it is. */
+const MAX_DOUBLINGS = 20;
+/**
+ * A client of the routes a source writes through on molecules.cheminfo.org,
+ * retrying while the server is busy (503), throttling (429), being restarted
+ * (502, 504) or out of reach. Each attempt has its own deadline, the pauses
+ * double with a spread and honour `Retry-After`, and bodies travel gzipped.
+ * Browser-safe: it reads no Node module.
+ * @param options - Where it answers, the token, and how hard to insist.
+ * @returns The client.
+ */
+export function createMoleculesClient(options) {
+    const { token, maxRetryMs = 1_800_000, initialDelayMs = 1000, maxDelayMs = 60_000, requestTimeoutMs = 600_000, signal, onRetry, fetch: fetchImplementation = globalThis.fetch, random = new XSadd().random, } = options;
+    const baseUrl = trimTrailingSlash(options.baseUrl);
+    async function attemptOnce(call) {
+        let response;
+        try {
+            response = await fetchImplementation(`${baseUrl}${call.path}`, {
+                method: call.method,
+                headers: {
+                    authorization: `Bearer ${token}`,
+                    ...(call.payload === undefined
+                        ? {}
+                        : {
+                            'content-type': 'application/json',
+                            'content-encoding': 'gzip',
+                        }),
+                },
+                body: call.payload,
+                signal: requestSignal(signal, requestTimeoutMs),
+            });
+            if (response.ok) {
+                return { answered: true, value: (await response.json()) };
+            }
+        }
+        catch (error) {
+            if (signal?.aborted)
+                throw signal.reason;
+            return {
+                answered: false,
+                status: undefined,
+                reason: causeOf(error),
+                retryAfterMs: undefined,
+            };
+        }
+        const text = await response.text();
+        const reason = messageOf(text) ?? response.statusText;
+        if (!RETRIED_STATUSES.has(response.status)) {
+            throw new MoleculesError(`${call.method} ${call.path} answered ${response.status}: ${reason}`, response.status, text);
+        }
+        const asked = retryAfter(response.headers.get('retry-after'), Date.now());
+        return {
+            answered: false,
+            status: response.status,
+            reason,
+            retryAfterMs: asked,
+        };
+    }
+    async function attempt(call, number) {
+        signal?.throwIfAborted();
+        const outcome = await attemptOnce(call);
+        if (outcome.answered)
+            return outcome.value;
+        const backoff = initialDelayMs *
+            2 ** Math.min(number - 1, MAX_DOUBLINGS) *
+            (0.5 + random() * 0.5);
+        const delayMs = Math.min(maxDelayMs, outcome.retryAfterMs ?? backoff);
+        const elapsed = Date.now() - call.started;
+        if (elapsed + delayMs > maxRetryMs) {
+            throw new MoleculesError(`${call.method} ${call.path} kept failing for ${Math.round(elapsed / 1000)} s: ${outcome.reason}`, outcome.status ?? 0, outcome.reason);
+        }
+        onRetry?.({
+            method: call.method,
+            path: call.path,
+            attempt: number,
+            status: outcome.status,
+            reason: outcome.reason,
+            delayMs,
+        });
+        await pause(delayMs, signal);
+        return attempt(call, number + 1);
+    }
+    async function request(method, path, body) {
+        const started = Date.now();
+        const payload = body === undefined ? undefined : await gzipBody(JSON.stringify(body));
+        return attempt({ method, path, payload, started }, 1);
+    }
+    return {
+        startImport: () => request('POST', '/v1/imports'),
+        importState: () => request('GET', '/v1/imports'),
+        submit: (molecules, { returnInfo = false } = {}) => request('POST', '/v1/submit', { molecules, returnInfo }),
+        lookup: (queries, kind) => request('POST', '/v1/batch', { queries, kind }),
+        purge: (importKey, { dryRun = false, force = false } = {}) => request('POST', `/v1/imports/${importKey}/purge`, {
+            dryRun,
+            force,
+        }),
+    };
+}
+//# sourceMappingURL=moleculesClient.js.map

package/lib/moleculesClient/core/moleculesClient.js.map

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

package/lib/moleculesClient/core/moleculesClientApi.d.ts

@@ -0,0 +1,100 @@
+import type { ImportStarted, ImportState, LookupResponse, MoleculeInput, PurgeResponse, RetryDetails, SubmitResponse } from './moleculesTypes.ts';
+/** How a client reaches molecules.cheminfo.org, and how hard it insists. */
+export interface MoleculesClientOptions {
+    /** Where molecules.cheminfo.org answers, e.g. `https://molecules.cheminfo.org`. */
+    baseUrl: string;
+    /** The token issued for the source the client writes for. */
+    token: string;
+    /**
+     * How long one request may keep being retried while the server is busy or
+     * unreachable, in milliseconds.
+     * @default 1_800_000 - half an hour
+     */
+    maxRetryMs?: number;
+    /**
+     * The first pause before a retry; each next one doubles, up to `maxDelayMs`.
+     * @default 1000
+     */
+    initialDelayMs?: number;
+    /**
+     * The longest pause between two attempts, a `Retry-After` included.
+     * @default 60_000
+     */
+    maxDelayMs?: number;
+    /**
+     * How long one attempt may take before it is given up and retried.
+     * @default 600_000
+     */
+    requestTimeoutMs?: number;
+    /**
+     * Stops every request, and every pause between two attempts.
+     * @default undefined - nothing stops them
+     */
+    signal?: AbortSignal;
+    /**
+     * Told about every retry, e.g. to log it.
+     * @default undefined - retries are silent
+     */
+    onRetry?: (details: RetryDetails) => void;
+    /**
+     * The fetch to use, for tests.
+     * @default globalThis.fetch
+     */
+    fetch?: typeof fetch;
+    /**
+     * A number from 0 to 1 that spreads the pauses, so clients that failed
+     * together do not all come back at the same instant.
+     * @default an unseeded `XSadd`
+     */
+    random?: () => number;
+}
+/** The routes a source writes through on molecules.cheminfo.org. */
+export interface MoleculesClient {
+    /** Take the source's next import key: the start of a full import. */
+    startImport: () => Promise<ImportStarted>;
+    /** Where the source's import stands. */
+    importState: () => Promise<ImportState>;
+    /**
+     * Send up to 1000 molecules for the source, under its current import key.
+     * @param molecules - Each with its identifier and exactly one notation.
+     * @param options - Whether every answer carries the molecule's properties.
+     * @param options.returnInfo - Ask for them; `false` by default.
+     */
+    submit: (molecules: MoleculeInput[], options?: {
+        returnInfo?: boolean;
+    }) => Promise<SubmitResponse>;
+    /**
+     * Compute up to 1000 molecules without storing anything, for a source
+     * molecules.cheminfo.org imports itself.
+     * @param queries - The structures, all in one notation.
+     * @param kind - The notation.
+     */
+    lookup: (queries: string[], kind: 'smiles' | 'molfile' | 'idCode') => Promise<LookupResponse>;
+    /**
+     * Remove the entries an import did not send again.
+     * @param importKey - The key the import took.
+     * @param options - Only count, or remove even more than half.
+     * @param options.dryRun - Only count; `false` by default.
+     * @param options.force - Remove even when that is more than half; `false` by
+     * default.
+     */
+    purge: (importKey: number, options?: {
+        dryRun?: boolean;
+        force?: boolean;
+    }) => Promise<PurgeResponse>;
+}
+/** A request molecules.cheminfo.org refused, or that kept failing. */
+export declare class MoleculesError extends Error {
+    /** The status answered, or 0 when nothing was. */
+    readonly status: number;
+    /** What the server said, as text. */
+    readonly body: string;
+    /**
+     * A failed request, with what the server answered.
+     * @param message - What failed, and why.
+     * @param status - The status answered, or 0 when nothing was.
+     * @param body - What the server said.
+     */
+    constructor(message: string, status: number, body: string);
+}
+//# sourceMappingURL=moleculesClientApi.d.ts.map

package/lib/moleculesClient/core/moleculesClientApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moleculesClientApi.d.ts","sourceRoot":"","sources":["../../../src/moleculesClient/core/moleculesClientApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACd,aAAa,EACb,aAAa,EACb,YAAY,EACZ,cAAc,EACf,MAAM,qBAAqB,CAAC;AAE7B,4EAA4E;AAC5E,MAAM,WAAW,sBAAsB;IACrC,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IAC1C;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACvB;AAED,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,WAAW,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1C,wCAAwC;IACxC,WAAW,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IACxC;;;;;OAKG;IACH,MAAM,EAAE,CACN,SAAS,EAAE,aAAa,EAAE,EAC1B,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,KAC/B,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B;;;;;OAKG;IACH,MAAM,EAAE,CACN,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,KAClC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B;;;;;;;OAOG;IACH,KAAK,EAAE,CACL,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,KAC5C,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7B;AAED,sEAAsE;AACtE,qBAAa,cAAe,SAAQ,KAAK;IACvC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAM1D"}

package/lib/moleculesClient/core/moleculesClientApi.js

@@ -0,0 +1,20 @@
+/** A request molecules.cheminfo.org refused, or that kept failing. */
+export class MoleculesError extends Error {
+    /** The status answered, or 0 when nothing was. */
+    status;
+    /** What the server said, as text. */
+    body;
+    /**
+     * A failed request, with what the server answered.
+     * @param message - What failed, and why.
+     * @param status - The status answered, or 0 when nothing was.
+     * @param body - What the server said.
+     */
+    constructor(message, status, body) {
+        super(message);
+        this.name = 'MoleculesError';
+        this.status = status;
+        this.body = body;
+    }
+}
+//# sourceMappingURL=moleculesClientApi.js.map

package/lib/moleculesClient/core/moleculesClientApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moleculesClientApi.js","sourceRoot":"","sources":["../../../src/moleculesClient/core/moleculesClientApi.ts"],"names":[],"mappings":"AAoGA,sEAAsE;AACtE,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,kDAAkD;IACzC,MAAM,CAAS;IACxB,qCAAqC;IAC5B,IAAI,CAAS;IAEtB;;;;;OAKG;IACH,YAAY,OAAe,EAAE,MAAc,EAAE,IAAY;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/lib/moleculesClient/core/moleculesTypes.d.ts

@@ -0,0 +1,154 @@
+/** One molecule a source sends: its identifier, and exactly one notation. */
+export interface MoleculeInput {
+    /** The source's identifier for it, which its address is written with. */
+    id: string;
+    /**
+     * The structure as SMILES.
+     * @default undefined - another notation is given
+     */
+    smiles?: string;
+    /**
+     * The structure as a molfile.
+     * @default undefined - another notation is given
+     */
+    molfile?: string;
+    /**
+     * The structure as an OpenChemLib idCode.
+     * @default undefined - another notation is given
+     */
+    idCode?: string;
+}
+/** What molecules.cheminfo.org computed for a structure. */
+export interface MoleculeInfo {
+    mf: string;
+    mw: number;
+    em: number;
+    charge: number;
+    idCode: string;
+    noStereoID: string;
+    noStereoTautomerID: string;
+    failedTautomerID: number;
+    /** The 512-bit FragFp, sixteen signed 32-bit words. */
+    ssIndex: number[];
+    logS: number;
+    logP: number;
+    acceptorCount: number;
+    donorCount: number;
+    stereoCenterCount: number;
+    rotatableBondCount: number;
+    polarSurfaceArea: number;
+    nbFragments: number;
+    /**
+     * The degree of unsaturation, when the formula has one.
+     * @default undefined
+     */
+    unsaturation?: number;
+    atoms: Record<string, number>;
+    /** The hashes, as 16 hex digits: never JSON numbers, which would round them. */
+    idCodeHash: string;
+    noStereoHash: string;
+    noStereoTautomerHash: string;
+    createdAt: number | null;
+}
+/** What became of one molecule a source sent. */
+export interface SubmitResult {
+    id: string | null;
+    /**
+     * The structure it was read as.
+     * @default undefined - it could not be read
+     */
+    idCode?: string;
+    /**
+     * Whether molecules.cheminfo.org held the structure already.
+     * @default undefined - it could not be read
+     */
+    molecule?: 'created' | 'existing';
+    /**
+     * What became of the source's entry.
+     * @default undefined - it could not be read
+     */
+    link?: 'added' | 'unchanged' | 'moved';
+    /**
+     * The computed properties, when they were asked for.
+     * @default undefined
+     */
+    info?: MoleculeInfo;
+    /**
+     * Why the molecule was refused.
+     * @default undefined - it was taken
+     */
+    error?: string;
+}
+/** How a batch was taken. */
+export interface SubmitSummary {
+    total: number;
+    /** Molecules new to molecules.cheminfo.org. */
+    created: number;
+    /** Entries new to the source. */
+    added: number;
+    /** Identifiers moved to another structure. */
+    moved: number;
+    unchanged: number;
+    failed: number;
+}
+/** What `POST /v1/submit` answers: one result per molecule, in their order. */
+export interface SubmitResponse {
+    source: string;
+    results: SubmitResult[];
+    summary: SubmitSummary;
+}
+/** What `POST /v1/imports` answers: the start of a full import. */
+export interface ImportStarted {
+    source: string;
+    importKey: number;
+    importStartedAt: number;
+}
+/** What `GET /v1/imports` answers: where the source's import stands. */
+export interface ImportState {
+    source: string;
+    importKey: number;
+    importStartedAt: number | null;
+    updatedAt: number | null;
+    entries: number;
+    stale: number;
+}
+/** What a purge answers. */
+export interface PurgeResponse {
+    source: string;
+    importKey: number;
+    dryRun: boolean;
+    /** The entries the import did not send again, removed or to be removed. */
+    removed: number;
+    /** The entries the source holds after. */
+    remaining: number;
+}
+/** One answer of `POST /v1/batch`: the molecule a query reads as, or why not. */
+export interface LookupResult {
+    query: string;
+    result: MoleculeInfo | null;
+    /** Whether molecules.cheminfo.org lists it, rather than computing it now. */
+    cached: boolean;
+    /**
+     * Why the query could not be read.
+     * @default undefined - it was read
+     */
+    error?: string;
+}
+/** What `POST /v1/batch` answers: one result per query, in their order. */
+export interface LookupResponse {
+    results: LookupResult[];
+}
+/** Why a request is tried again, and when. */
+export interface RetryDetails {
+    method: string;
+    path: string;
+    attempt: number;
+    /**
+     * The status that was answered.
+     * @default undefined - nothing was answered
+     */
+    status?: number;
+    reason: string;
+    delayMs: number;
+}
+//# sourceMappingURL=moleculesTypes.d.ts.map

package/lib/moleculesClient/core/moleculesTypes.d.ts.map

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

package/lib/moleculesClient/core/moleculesTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=moleculesTypes.js.map

package/lib/moleculesClient/core/moleculesTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moleculesTypes.js","sourceRoot":"","sources":["../../../src/moleculesClient/core/moleculesTypes.ts"],"names":[],"mappings":""}

package/lib/moleculesClient/core/requestRetry.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The pieces of a request that is tried again: its deadline, the pause the
+ * server asks for, what an error answer says, and what a failed fetch says.
+ * Browser-safe: no Node module is read.
+ */
+/**
+ * The signal one attempt runs under: the caller's, and its own deadline.
+ * @param signal - The caller's, if any.
+ * @param timeoutMs - How long the attempt may take.
+ * @returns The signal.
+ */
+export declare function requestSignal(signal: AbortSignal | undefined, timeoutMs: number): AbortSignal;
+/**
+ * How long a `Retry-After` header asks to wait.
+ * @param header - Its value: seconds, or an HTTP date.
+ * @param now - The current instant, in epoch milliseconds.
+ * @returns The pause in milliseconds, or `undefined` when there is none to read.
+ */
+export declare function retryAfter(header: string | null, now: number): number | undefined;
+/**
+ * The message of an error body Fastify wrote, or the body itself.
+ * @param text - The body.
+ * @returns The message, or `undefined` when the body is empty.
+ */
+export declare function messageOf(text: string): string | undefined;
+/**
+ * What a failed fetch says, its cause included: undici reports a refused
+ * connection as `fetch failed` with the reason in `cause` — and when several
+ * addresses were tried, in the first error of an AggregateError whose own
+ * message is empty.
+ * @param error - What was thrown.
+ * @returns The message, e.g. `fetch failed: connect ECONNREFUSED 127.0.0.1:11980`.
+ */
+export declare function causeOf(error: unknown): string;
+/**
+ * A request body gzipped, as HTTP's `Content-Encoding: gzip` carries it: a
+ * batch of molfiles shrinks several times over.
+ * @param text - The body, written out.
+ * @returns The gzipped bytes.
+ */
+export declare function gzipBody(text: string): Promise<Uint8Array<ArrayBuffer>>;
+/**
+ * Wait, unless the signal stops the wait first.
+ * @param milliseconds - How long.
+ * @param signal - What stops it, if anything.
+ * @returns When the time has passed.
+ * @throws {unknown} The signal's reason, when it aborts first.
+ */
+export declare function pause(milliseconds: number, signal: AbortSignal | undefined): Promise<void>;
+//# sourceMappingURL=requestRetry.d.ts.map

package/lib/moleculesClient/core/requestRetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestRetry.d.ts","sourceRoot":"","sources":["../../../src/moleculesClient/core/requestRetry.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,SAAS,EAAE,MAAM,GAChB,WAAW,CAGb;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAMpB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS1D;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAa9C;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAK7E;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CACnB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,IAAI,CAAC,CAgBf"}