react-cheminfo 0.64.0 → 0.65.0

package/lib/moleculesClient/core/requestRetry.js

@@ -0,0 +1,108 @@
+import { toError } from "../../error/core/toError.js";
+/**
+ * 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 function requestSignal(signal, timeoutMs) {
+    const timeout = AbortSignal.timeout(timeoutMs);
+    return signal === undefined ? timeout : AbortSignal.any([signal, timeout]);
+}
+/**
+ * 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 function retryAfter(header, now) {
+    if (header === null || header.trim() === '')
+        return undefined;
+    const seconds = Number(header);
+    if (Number.isFinite(seconds))
+        return Math.max(0, seconds * 1000);
+    const date = Date.parse(header);
+    return Number.isNaN(date) ? undefined : Math.max(0, date - now);
+}
+/**
+ * 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 function messageOf(text) {
+    if (text.trim() === '')
+        return undefined;
+    try {
+        const body = JSON.parse(text);
+        if (typeof body?.message === 'string')
+            return body.message;
+    }
+    catch {
+        return text.slice(0, 500);
+    }
+    return text.slice(0, 500);
+}
+/**
+ * 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 function causeOf(error) {
+    if (!(error instanceof Error))
+        return String(error);
+    const { cause, message } = error;
+    if (!(cause instanceof Error))
+        return message;
+    const first = cause instanceof AggregateError ? cause.errors[0] : undefined;
+    const code = cause.code;
+    const detail = cause.message ||
+        (first instanceof Error ? first.message : '') ||
+        (typeof code === 'string' ? code : '') ||
+        cause.name;
+    return `${message}: ${detail}`;
+}
+/**
+ * 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 async function gzipBody(text) {
+    const stream = new Blob([text])
+        .stream()
+        .pipeThrough(new CompressionStream('gzip'));
+    return new Uint8Array(await new Response(stream).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 function pause(milliseconds, signal) {
+    return new Promise((done, fail) => {
+        if (signal?.aborted) {
+            fail(toError(signal.reason));
+            return;
+        }
+        const abort = () => {
+            clearTimeout(timer);
+            fail(toError(signal?.reason));
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', abort);
+            done();
+        }, milliseconds);
+        signal?.addEventListener('abort', abort, { once: true });
+    });
+}
+//# sourceMappingURL=requestRetry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"requestRetry.js","sourceRoot":"","sources":["../../../src/moleculesClient/core/requestRetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAEtD;;;;GAIG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,MAA+B,EAC/B,SAAiB;IAEjB,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/C,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,MAAqB,EACrB,GAAW;IAEX,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiC,CAAC;QAC9D,IAAI,OAAO,IAAI,EAAE,OAAO,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IACjC,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9C,MAAM,KAAK,GACT,KAAK,YAAY,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;IAChD,MAAM,MAAM,GACV,KAAK,CAAC,OAAO;QACb,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC;IACb,OAAO,GAAG,OAAO,KAAK,MAAM,EAAE,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY;IACzC,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;SAC5B,MAAM,EAAE;SACR,WAAW,CAAC,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,OAAO,IAAI,UAAU,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CACnB,YAAoB,EACpB,MAA+B;IAE/B,OAAO,IAAI,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QAChC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAChC,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC5C,IAAI,EAAE,CAAC;QACT,CAAC,EAAE,YAAY,CAAC,CAAC;QACjB,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -24,9 +24,10 @@ export declare const MINIMUM_FRAMING_RADIUS = 0.5;
  * measured against — so reading a camera and applying it are the same move in
  * opposite directions.
  * @param radius - Radius of the scene's visible bounding sphere.
+ * @param margin - Fraction of the radius kept as breathing room.
  * @returns The framed radius.
  */
-export declare function framedRadius(radius: number): number;
+export declare function framedRadius(radius: number, margin?: number): number;
 /**
  * Turn the automatic spin on or off. It moves the camera, never the object.
  * @param plugin - The molstar context.

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

@@ -1 +1 @@
-{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../../src/molstar/core/camera.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAEvE,8EAA8E;AAC9E,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAK1C;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,OAAO,EACjB,KAAK,SAAqB,GACzB,IAAI,CAQN"}
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../../src/molstar/core/camera.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAEvE,8EAA8E;AAC9E,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAK1C;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,SAAiB,GAAG,MAAM,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,OAAO,EACjB,KAAK,SAAqB,GACzB,IAAI,CAQN"}

package/lib/molstar/core/camera.js

@@ -26,10 +26,11 @@ const SPIN_AXIS = Vec3.create(0, 1, 0);
  * measured against — so reading a camera and applying it are the same move in
  * opposite directions.
  * @param radius - Radius of the scene's visible bounding sphere.
+ * @param margin - Fraction of the radius kept as breathing room.
  * @returns The framed radius.
  */
-export function framedRadius(radius) {
-    return Math.max(radius * (1 + FRAMING_MARGIN), MINIMUM_FRAMING_RADIUS);
+export function framedRadius(radius, margin = FRAMING_MARGIN) {
+    return Math.max(radius * (1 + margin), MINIMUM_FRAMING_RADIUS);
 }
 /**
  * Turn the automatic spin on or off. It moves the camera, never the object.

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

@@ -1 +1 @@
-{"version":3,"file":"camera.js","sourceRoot":"","sources":["../../../src/molstar/core/camera.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,wCAAwC,CAAC;AAG9D,8EAA8E;AAC9E,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,gFAAgF;AAChF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAG,CAAC,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAEnC,uEAAuE;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C,sDAAsD;AACtD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,cAAc,CAAC,EAAE,sBAAsB,CAAC,CAAC;AACzE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CACrB,MAAqB,EACrB,QAAiB,EACjB,KAAK,GAAG,kBAAkB;IAE1B,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC;QACxB,SAAS,EAAE;YACT,OAAO,EAAE,QAAQ;gBACf,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;gBACtD,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;SAChC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"camera.js","sourceRoot":"","sources":["../../../src/molstar/core/camera.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,wCAAwC,CAAC;AAG9D,8EAA8E;AAC9E,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,gFAAgF;AAChF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAG,CAAC,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAEnC,uEAAuE;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C,sDAAsD;AACtD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,MAAM,GAAG,cAAc;IAClE,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,sBAAsB,CAAC,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CACrB,MAAqB,EACrB,QAAiB,EACjB,KAAK,GAAG,kBAAkB;IAE1B,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC;QACxB,SAAS,EAAE;YACT,OAAO,EAAE,QAAQ;gBACf,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;gBACtD,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;SAChC;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,102 @@
+/**
+ * Framing a scene: the sphere everything on screen fits in, the camera moved
+ * to show it whole, and the zoom onto one point of it.
+ *
+ * What is on screen is measured rather than read off molstar: a canvas's own
+ * `boundingSphereVisible` is read once when the canvas is built, a
+ * ball-and-stick representation pads its sphere by the largest ball it could
+ * ever draw, and an isosurface reports the whole sampled box. So a site hands
+ * the spheres it measured itself, and names which render objects are worth
+ * their own sphere — a mesh it built, whose sphere is exactly its vertices.
+ */
+import type { GraphicsRenderObject } from 'molstar/lib/mol-gl/render-object.js';
+import { Sphere3D } from 'molstar/lib/mol-math/geometry.js';
+import type { PluginContext } from 'molstar/lib/mol-plugin/context.js';
+/**
+ * Frame everything on screen.
+ *
+ * Without an orientation the camera keeps the direction it already points in,
+ * which is what a reframe after a reader turned the scene must do. A scene with
+ * nothing measured is framed by molstar's own reset.
+ * @param plugin - The molstar context.
+ * @param options - What to frame, from where, and how fast.
+ */
+export declare function resetCamera(plugin: PluginContext, options?: ResetCameraOptions): void;
+/**
+ * Frame one ball of the scene: an atom picked, the centre of a bond, the
+ * whole scene.
+ *
+ * The canvas is committed first — `add()` only queues, and a queued object
+ * belongs to no bounding sphere yet — and the ball is framed with no padding
+ * of molstar's own, whose 4 Å default leaves water a twentieth of the canvas.
+ * @param plugin - The molstar context.
+ * @param centre - What to frame, Cartesian ångström.
+ * @param radius - Radius of the ball to fit, ångström.
+ * @param options - From where, and how fast.
+ */
+export declare function focusPoint(plugin: PluginContext, centre: Point3, radius: number, options?: FocusOptions): void;
+/**
+ * The one sphere everything worth framing fits in: the spheres a site
+ * measured itself, and those of the render objects it names.
+ * @param plugin - The molstar context.
+ * @param options - The measured spheres, and which render objects count.
+ * @returns The sphere, or `null` when nothing was measured.
+ */
+export declare function sceneSphere(plugin: PluginContext, options?: SceneSphereOptions): Sphere3D | null;
+/**
+ * The smallest sphere holding a set of spheres, as molstar's own camera
+ * manager computes it.
+ * @param spheres - The spheres to hold.
+ * @returns It, the one sphere itself when there is one, `null` when there is none.
+ */
+export declare function unionSphere(spheres: readonly Sphere3D[]): Sphere3D | null;
+/** A point in Cartesian ångström. */
+export type Point3 = readonly [x: number, y: number, z: number];
+/** Where the camera stands to look at a scene. */
+export interface ViewOrientation {
+    /** The direction from what is looked at to the eye. */
+    eye: Point3;
+    /** The direction that is up on screen. */
+    up: Point3;
+}
+/** How {@link focusPoint} moves the camera. */
+export interface FocusOptions {
+    /**
+     * Transition length, in milliseconds; 0 jumps.
+     * @default 250
+     */
+    durationMs?: number;
+    /**
+     * Where to look from.
+     * @default undefined — the direction the camera already points in
+     */
+    orientation?: ViewOrientation;
+}
+/** What {@link sceneSphere} measures. */
+export interface SceneSphereOptions {
+    /**
+     * Spheres the site measured itself: a model from its own atoms, a part of
+     * the scene registered as it was drawn.
+     * @default []
+     */
+    spheres?: readonly Sphere3D[];
+    /**
+     * Which render objects of the canvas count with their own sphere.
+     * @default undefined — none does
+     */
+    include?: (object: GraphicsRenderObject) => boolean;
+}
+/** What {@link resetCamera} frames, and how. */
+export interface ResetCameraOptions extends SceneSphereOptions, FocusOptions {
+    /**
+     * The sphere to frame, measured by the caller, instead of the scene's.
+     * @default undefined — the sphere `sceneSphere` measures
+     */
+    sphere?: Sphere3D | null;
+    /**
+     * Fraction of the radius kept as breathing room around the scene.
+     * @default 0.08
+     */
+    margin?: number;
+}
+//# sourceMappingURL=framing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"framing.d.ts","sourceRoot":"","sources":["../../../src/molstar/core/framing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAEhF,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AASvE;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,kBAAuB,GAC/B,IAAI,CAgBN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,YAAiB,GACzB,IAAI,CAyBN;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,kBAAuB,GAC/B,QAAQ,GAAG,IAAI,CAgBjB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ,GAAG,IAAI,CASzE;AAED,qCAAqC;AACrC,MAAM,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AAEhE,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,OAAO,CAAC;CACrD;AAED,gDAAgD;AAChD,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB,EAAE,YAAY;IAC1E;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/lib/molstar/core/framing.js

@@ -0,0 +1,120 @@
+/**
+ * Framing a scene: the sphere everything on screen fits in, the camera moved
+ * to show it whole, and the zoom onto one point of it.
+ *
+ * What is on screen is measured rather than read off molstar: a canvas's own
+ * `boundingSphereVisible` is read once when the canvas is built, a
+ * ball-and-stick representation pads its sphere by the largest ball it could
+ * ever draw, and an isosurface reports the whole sampled box. So a site hands
+ * the spheres it measured itself, and names which render objects are worth
+ * their own sphere — a mesh it built, whose sphere is exactly its vertices.
+ */
+import { BoundaryHelper } from 'molstar/lib/mol-math/geometry/boundary-helper.js';
+import { Sphere3D } from 'molstar/lib/mol-math/geometry.js';
+import { Vec3 } from 'molstar/lib/mol-math/linear-algebra.js';
+import { DEFAULT_CAMERA_DURATION, FRAMING_MARGIN, MINIMUM_FRAMING_RADIUS, framedRadius, } from "./camera.js";
+/**
+ * Frame everything on screen.
+ *
+ * Without an orientation the camera keeps the direction it already points in,
+ * which is what a reframe after a reader turned the scene must do. A scene with
+ * nothing measured is framed by molstar's own reset.
+ * @param plugin - The molstar context.
+ * @param options - What to frame, from where, and how fast.
+ */
+export function resetCamera(plugin, options = {}) {
+    const { durationMs = DEFAULT_CAMERA_DURATION, margin = FRAMING_MARGIN } = options;
+    const { sphere, orientation } = options;
+    plugin.canvas3d?.commit(true);
+    const scene = sphere === undefined ? sceneSphere(plugin, options) : sphere;
+    if (scene === null || scene.radius <= 0) {
+        plugin.managers.camera.reset(undefined, durationMs);
+        return;
+    }
+    const { center, radius } = scene;
+    const [x = 0, y = 0, z = 0] = center;
+    focusPoint(plugin, [x, y, z], framedRadius(radius, margin), {
+        durationMs,
+        orientation,
+    });
+}
+/**
+ * Frame one ball of the scene: an atom picked, the centre of a bond, the
+ * whole scene.
+ *
+ * The canvas is committed first — `add()` only queues, and a queued object
+ * belongs to no bounding sphere yet — and the ball is framed with no padding
+ * of molstar's own, whose 4 Å default leaves water a twentieth of the canvas.
+ * @param plugin - The molstar context.
+ * @param centre - What to frame, Cartesian ångström.
+ * @param radius - Radius of the ball to fit, ångström.
+ * @param options - From where, and how fast.
+ */
+export function focusPoint(plugin, centre, radius, options = {}) {
+    const { durationMs = DEFAULT_CAMERA_DURATION, orientation } = options;
+    plugin.canvas3d?.commit(true);
+    const target = Vec3.create(centre[0], centre[1], centre[2]);
+    const camera = plugin.canvas3d?.camera;
+    if (orientation !== undefined && camera !== undefined) {
+        // `getFocus` only matches the sign of a direction against the current
+        // camera; `getInvariantFocus` takes the direction and the up as given.
+        const { eye, up } = orientation;
+        plugin.managers.camera.setSnapshot(camera.getInvariantFocus(target, Math.max(radius, MINIMUM_FRAMING_RADIUS), Vec3.create(up[0], up[1], up[2]), Vec3.create(-eye[0], -eye[1], -eye[2])), durationMs);
+        return;
+    }
+    plugin.managers.camera.focusSphere(Sphere3D.create(target, radius), {
+        extraRadius: 0,
+        minRadius: MINIMUM_FRAMING_RADIUS,
+        durationMs,
+    });
+}
+/**
+ * The one sphere everything worth framing fits in: the spheres a site
+ * measured itself, and those of the render objects it names.
+ * @param plugin - The molstar context.
+ * @param options - The measured spheres, and which render objects count.
+ * @returns The sphere, or `null` when nothing was measured.
+ */
+export function sceneSphere(plugin, options = {}) {
+    const spheres = [];
+    for (const sphere of options.spheres ?? []) {
+        if (sphere.radius > 0)
+            spheres.push(sphere);
+    }
+    const { include } = options;
+    const canvas3d = plugin.canvas3d;
+    if (include !== undefined && canvas3d !== undefined) {
+        canvas3d.commit(true);
+        for (const object of canvas3d.getRenderObjects()) {
+            if (!include(object))
+                continue;
+            const sphere = object.values.boundingSphere.ref.value;
+            if (sphere.radius > 0)
+                spheres.push(sphere);
+        }
+    }
+    return unionSphere(spheres);
+}
+/**
+ * The smallest sphere holding a set of spheres, as molstar's own camera
+ * manager computes it.
+ * @param spheres - The spheres to hold.
+ * @returns It, the one sphere itself when there is one, `null` when there is none.
+ */
+export function unionSphere(spheres) {
+    const first = spheres[0];
+    if (first === undefined)
+        return null;
+    if (spheres.length === 1)
+        return first;
+    boundary.reset();
+    for (const sphere of spheres)
+        boundary.includeSphere(sphere);
+    boundary.finishedIncludeStep();
+    for (const sphere of spheres)
+        boundary.radiusSphere(sphere);
+    return boundary.getSphere();
+}
+// Reused across calls, as molstar's own camera manager does.
+const boundary = new BoundaryHelper('98');
+//# sourceMappingURL=framing.js.map

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

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

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

@@ -17,6 +17,22 @@ import type { PluginContext } from 'molstar/lib/mol-plugin/context.js';
  * @returns The unsubscribe function.
  */
 export declare function subscribeHover(plugin: PluginContext, listener: (loci: Loci | null) => void): () => void;
+/** What the pointer rests on, in a line, and the loci it names. */
+export interface HoverLabel {
+    /** `O 1`, `Si 4 — O 8`, or the label a drawing of the site carries. */
+    label: string;
+    /** The loci, for a site that wants more of it — the atom it holds, say. */
+    loci: Loci;
+}
+/**
+ * Report the label of whatever the pointer rests on: an atom named as a
+ * reader would name it, anything else by the label it was drawn with.
+ * @param plugin - The molstar context.
+ * @param listener - Called with the label and its loci, or `null` when the
+ * pointer leaves everything or rests on something with nothing to say.
+ * @returns The unsubscribe function.
+ */
+export declare function subscribeHoverLabel(plugin: PluginContext, listener: (hover: HoverLabel | null) => void): () => void;
 /**
  * The one line a loci is worth, in molstar's own words.
  * @param loci - What the pointer is over.

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

@@ -1 +1 @@
-{"version":3,"file":"hover.d.ts","sourceRoot":"","sources":["../../../src/molstar/core/hover.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAO1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAGvE;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,GACpC,MAAM,IAAI,CAQZ;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAIlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAiBlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI/D"}
+{"version":3,"file":"hover.d.ts","sourceRoot":"","sources":["../../../src/molstar/core/hover.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAO1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAGvE;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,GACpC,MAAM,IAAI,CAQZ;AAED,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,IAAI,EAAE,IAAI,CAAC;CACZ;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,GAC3C,MAAM,IAAI,CAKZ;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAIlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAiBlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI/D"}

package/lib/molstar/core/hover.js

@@ -26,6 +26,20 @@ export function subscribeHover(plugin, listener) {
         subscription.unsubscribe();
     };
 }
+/**
+ * Report the label of whatever the pointer rests on: an atom named as a
+ * reader would name it, anything else by the label it was drawn with.
+ * @param plugin - The molstar context.
+ * @param listener - Called with the label and its loci, or `null` when the
+ * pointer leaves everything or rests on something with nothing to say.
+ * @returns The unsubscribe function.
+ */
+export function subscribeHoverLabel(plugin, listener) {
+    return subscribeHover(plugin, (loci) => {
+        const label = loci === null ? null : (atomText(loci) ?? lociText(loci));
+        listener(label === null || loci === null ? null : { label, loci });
+    });
+}
 /**
  * The one line a loci is worth, in molstar's own words.
  * @param loci - What the pointer is over.

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

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

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

@@ -17,8 +17,11 @@
 export type { CameraPose, CameraReference, PoseOptions } from './cameraPose.ts';
 export { cameraToPose, poseToCamera } from './cameraPose.ts';
 export { DEFAULT_CAMERA_DURATION, DEFAULT_SPIN_SPEED, FRAMING_MARGIN, MINIMUM_FRAMING_RADIUS, framedRadius, setSpin, } from './camera.ts';
+export type { FocusOptions, Point3, ResetCameraOptions, SceneSphereOptions, ViewOrientation, } from './framing.ts';
+export { focusPoint, resetCamera, sceneSphere, unionSphere, } from './framing.ts';
 export { HighlightPainter, highlightOverpaint } from './highlights.ts';
-export { atomName, atomText, lociText, subscribeHover } from './hover.ts';
+export type { HoverLabel } from './hover.ts';
+export { atomName, atomText, lociText, subscribeHover, subscribeHoverLabel, } from './hover.ts';
 export type { MolstarPluginOptions } from './plugin.ts';
 export { MolstarPlugin } from './plugin.ts';
 export { captureScene } from './captureScene.ts';

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

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

package/lib/molstar/core/index.js

@@ -16,8 +16,9 @@
  */
 export { cameraToPose, poseToCamera } from "./cameraPose.js";
 export { DEFAULT_CAMERA_DURATION, DEFAULT_SPIN_SPEED, FRAMING_MARGIN, MINIMUM_FRAMING_RADIUS, framedRadius, setSpin, } from "./camera.js";
+export { focusPoint, resetCamera, sceneSphere, unionSphere, } from "./framing.js";
 export { HighlightPainter, highlightOverpaint } from "./highlights.js";
-export { atomName, atomText, lociText, subscribeHover } from "./hover.js";
+export { atomName, atomText, lociText, subscribeHover, subscribeHoverLabel, } from "./hover.js";
 export { MolstarPlugin } from "./plugin.js";
 export { captureScene } from "./captureScene.js";
 export { MeasurementPicker, atomReferenceOf, clearMeasurements, renderMeasurements, } from "./measurements.js";

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

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

package/lib/pedagogy/core/answers.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Reading what a student typed into an answer box, and the verdicts a grader
+ * gives a box it cannot grade.
+ */
+import type { Language } from '../../i18n/core/languages.ts';
+import type { FieldCase } from './series.ts';
+/**
+ * Read a number the way a student types it: `42`, `+5`, `−3` with a real minus
+ * sign, `1,5` with a decimal comma, `75.8 %`, `1 000`.
+ *
+ * What a typed answer carries beyond a number box — a typographic minus, a
+ * percent sign, a space between thousands — is taken off first; the number
+ * itself is read by `readNumber`, as every box of the family reads one.
+ * @param text - What was typed.
+ * @param integer - Whether only a whole number is an answer.
+ * @default integer false
+ * @returns The number, or undefined when the text is not one.
+ */
+export declare function readAnswerNumber(text: string, integer?: boolean): number | undefined;
+/**
+ * Write a signed whole number the way an oxidation state or a charge is
+ * written: `+5`, `−2`, `0`.
+ * @param value - The number.
+ * @returns The number with its sign, and a true minus sign.
+ */
+export declare function formatSigned(value: number): string;
+/**
+ * The verdict on a field left empty.
+ * @param label - The field, as its box labels it.
+ * @param what - What the box asks for, e.g. `a number of electrons`.
+ * @param language - The language the reason is written in.
+ * @default language 'en'
+ * @returns A failed case that says what to type.
+ */
+export declare function emptyCase(label: string, what: string, language?: Language): FieldCase;
+/**
+ * The verdict on a field that does not read as the kind of value it asks for.
+ * @param label - The field, as its box labels it.
+ * @param typed - What was typed.
+ * @param what - What the box asks for, e.g. `a whole number`.
+ * @param language - The language the reason is written in.
+ * @default language 'en'
+ * @returns A failed case quoting what was typed.
+ */
+export declare function unreadableCase(label: string, typed: string, what: string, language?: Language): FieldCase;
+//# sourceMappingURL=answers.d.ts.map

package/lib/pedagogy/core/answers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answers.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/core/answers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAK7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,UAAQ,GACd,MAAM,GAAG,SAAS,CAOpB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,QAA2B,GACpC,SAAS,CAQX;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,QAA2B,GACpC,SAAS,CAQX"}

package/lib/pedagogy/core/answers.js

@@ -0,0 +1,77 @@
+/**
+ * Reading what a student typed into an answer box, and the verdicts a grader
+ * gives a box it cannot grade.
+ */
+import { CHROME_CATALOG } from "../../i18n/core/chromeCatalog.js";
+import { DEFAULT_LANGUAGE } from "../../i18n/core/languages.js";
+import { catalogTranslate } from "../../i18n/core/translate.js";
+import { readNumber } from "../../number/core/numberText.js";
+/**
+ * Read a number the way a student types it: `42`, `+5`, `−3` with a real minus
+ * sign, `1,5` with a decimal comma, `75.8 %`, `1 000`.
+ *
+ * What a typed answer carries beyond a number box — a typographic minus, a
+ * percent sign, a space between thousands — is taken off first; the number
+ * itself is read by `readNumber`, as every box of the family reads one.
+ * @param text - What was typed.
+ * @param integer - Whether only a whole number is an answer.
+ * @default integer false
+ * @returns The number, or undefined when the text is not one.
+ */
+export function readAnswerNumber(text, integer = false) {
+    const cleaned = text
+        .trim()
+        .replaceAll(/[−–]/gu, '-')
+        .replace(/\s*%$/u, '')
+        .replaceAll(/\s/gu, '');
+    return readNumber(cleaned, integer);
+}
+/**
+ * Write a signed whole number the way an oxidation state or a charge is
+ * written: `+5`, `−2`, `0`.
+ * @param value - The number.
+ * @returns The number with its sign, and a true minus sign.
+ */
+export function formatSigned(value) {
+    if (value > 0)
+        return `+${value}`;
+    if (value < 0)
+        return `−${-value}`;
+    return '0';
+}
+/**
+ * The verdict on a field left empty.
+ * @param label - The field, as its box labels it.
+ * @param what - What the box asks for, e.g. `a number of electrons`.
+ * @param language - The language the reason is written in.
+ * @default language 'en'
+ * @returns A failed case that says what to type.
+ */
+export function emptyCase(label, what, language = DEFAULT_LANGUAGE) {
+    const t = catalogTranslate(CHROME_CATALOG, language);
+    return {
+        label,
+        passed: false,
+        reason: t('pedagogy.answerEmpty', { what }),
+        actual: null,
+    };
+}
+/**
+ * The verdict on a field that does not read as the kind of value it asks for.
+ * @param label - The field, as its box labels it.
+ * @param typed - What was typed.
+ * @param what - What the box asks for, e.g. `a whole number`.
+ * @param language - The language the reason is written in.
+ * @default language 'en'
+ * @returns A failed case quoting what was typed.
+ */
+export function unreadableCase(label, typed, what, language = DEFAULT_LANGUAGE) {
+    const t = catalogTranslate(CHROME_CATALOG, language);
+    return {
+        label,
+        passed: false,
+        reason: t('pedagogy.answerUnreadable', { typed: typed.trim(), what }),
+        actual: typed,
+    };
+}
+//# sourceMappingURL=answers.js.map

package/lib/pedagogy/core/answers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answers.js","sourceRoot":"","sources":["../../../src/pedagogy/core/answers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAElE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAI7D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,OAAO,GAAG,KAAK;IAEf,MAAM,OAAO,GAAG,IAAI;SACjB,IAAI,EAAE;SACN,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC;SACzB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC1B,OAAO,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,IAAI,KAAK,EAAE,CAAC;IAClC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACnC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CACvB,KAAa,EACb,IAAY,EACZ,WAAqB,gBAAgB;IAErC,MAAM,CAAC,GAAG,gBAAgB,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IACrD,OAAO;QACL,KAAK;QACL,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,CAAC,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,CAAC;QAC3C,MAAM,EAAE,IAAI;KACb,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,KAAa,EACb,IAAY,EACZ,WAAqB,gBAAgB;IAErC,MAAM,CAAC,GAAG,gBAAgB,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IACrD,OAAO;QACL,KAAK;QACL,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,CAAC,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC;QACrE,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC"}