react-cheminfo 0.3.0 → 0.4.0

package/lib/orbital/ui/renderVolume.d.ts

@@ -15,6 +15,7 @@
  */
 import type { PluginContext } from 'molstar/lib/mol-plugin/context.js';
 import type { OrbitalGrid } from '../core/grid.ts';
+import type { OrbitalContour } from '../core/isovalue.ts';
 /** Colours and opacity of one signed isosurface pair. */
 export interface VolumeStyle {
     /**
@@ -28,8 +29,8 @@ export interface VolumeStyle {
      */
     negativeColour?: string;
     /**
-     * Isovalue as a multiple of the one enclosing `ENCLOSED_WEIGHT` of the
-     * orbital's weight. Larger means a tighter, smaller surface.
+     * Isovalue as a multiple of the contour's own cutoff. Larger means a
+     * tighter, smaller surface.
      * @default 1
      */
     relativeIsovalue?: number;
@@ -43,12 +44,14 @@ export interface VolumeStyle {
  * Replace the isosurface pair drawn from a sampled field.
  * @param plugin - The molstar context.
  * @param field - The field, as `sampleAtomicOrbital` produced it.
+ * @param contour - The isovalue and reach measured on that field, as
+ * `runAtomicSample` returned them.
  * @param style - See {@link VolumeStyle}.
  * @returns How far the drawn surface reaches from the centre of the box,
  * ångström — what a camera has to frame to fill the viewport with it.
  * @throws {Error} When the canvas is not ready.
  */
-export declare function renderSampledVolume(plugin: PluginContext, field: OrbitalGrid, style?: VolumeStyle): Promise<number>;
+export declare function renderSampledVolume(plugin: PluginContext, field: OrbitalGrid, contour: OrbitalContour, style?: VolumeStyle): Promise<number>;
 /**
  * Remove the sampled isosurfaces, leaving anything else on the canvas.
  * @param plugin - The molstar context.

package/lib/orbital/ui/renderVolume.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderVolume.d.ts","sourceRoot":"","sources":["../../../src/orbital/ui/renderVolume.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAOvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,WAAW,EAClB,KAAK,GAAE,WAAgB,GACtB,OAAO,CAAC,MAAM,CAAC,CAyCjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAQ9D"}
+{"version":3,"file":"renderVolume.d.ts","sourceRoot":"","sources":["../../../src/orbital/ui/renderVolume.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAMvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,cAAc,EACvB,KAAK,GAAE,WAAgB,GACtB,OAAO,CAAC,MAAM,CAAC,CA8CjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAQ9D"}

package/lib/orbital/ui/renderVolume.js

@@ -13,47 +13,40 @@
  * tree and are tracked per plugin, because every change of orbital replaces
  * them wholesale.
  */
-import { computeOrbitalIsocontourValues } from 'molstar/lib/extensions/alpha-orbitals/orbitals.js';
 import { createVolumeRepresentationParams } from 'molstar/lib/mol-plugin-state/helpers/volume-representation-params.js';
 import { Theme } from 'molstar/lib/mol-theme/theme.js';
 import { Color } from 'molstar/lib/mol-util/color/color.js';
-import { ENCLOSED_WEIGHT } from "../core/constants.js";
-import { DISPLAY_REACH, surfaceReach, toVolume } from "./volumeField.js";
+import { DISPLAY_REACH, toVolume } from "./volumeField.js";
 /**
  * Replace the isosurface pair drawn from a sampled field.
  * @param plugin - The molstar context.
  * @param field - The field, as `sampleAtomicOrbital` produced it.
+ * @param contour - The isovalue and reach measured on that field, as
+ * `runAtomicSample` returned them.
  * @param style - See {@link VolumeStyle}.
  * @returns How far the drawn surface reaches from the centre of the box,
  * ångström — what a camera has to frame to fill the viewport with it.
  * @throws {Error} When the canvas is not ready.
  */
-export async function renderSampledVolume(plugin, field, style = {}) {
+export async function renderSampledVolume(plugin, field, contour, style = {}) {
     const canvas3d = plugin.canvas3d;
     if (canvas3d === undefined) {
         throw new Error('renderSampledVolume: the molstar canvas is not ready.');
     }
     const { positiveColour = '#2563eb', negativeColour = '#dc2626', relativeIsovalue = 1, alpha = 0.72, } = style;
     clearSampledVolume(plugin);
-    const isovalues = computeOrbitalIsocontourValues(field.data, ENCLOSED_WEIGHT);
+    const { cutoff, reach } = contour;
     // Molstar's camera clamps both its target distance and its near plane, so it
     // cannot get close to a small object: uranium's 4f reaches 0.35 Å and would
     // stay a dot in the corner whatever the camera is asked to frame. Every
     // orbital is therefore drawn at one canonical size, and the true extent is
     // reported as ⟨r⟩ and on the radial plot instead of by the picture's scale.
-    const reach = surfaceReach(field, isovalues);
     const volume = toVolume(field, reach > 0 ? DISPLAY_REACH / reach : 1);
     // A nodeless orbital — every 1s — has no negative lobe at all, and asking for
     // its isosurface would draw an empty mesh at value 0.
     const surfaces = await Promise.all([
-        maybeSurface(plugin, volume, isovalues.positive, relativeIsovalue, {
-            colour: positiveColour,
-            alpha,
-        }),
-        maybeSurface(plugin, volume, isovalues.negative, relativeIsovalue, {
-            colour: negativeColour,
-            alpha,
-        }),
+        maybeSurface(plugin, volume, field.max >= cutoff ? cutoff : undefined, relativeIsovalue, { colour: positiveColour, alpha }),
+        maybeSurface(plugin, volume, field.min <= -cutoff ? -cutoff : undefined, relativeIsovalue, { colour: negativeColour, alpha }),
     ]);
     const drawn = surfaces.filter((surface) => surface !== null);
     representations.set(plugin, drawn);
@@ -100,7 +93,13 @@ async function createSurface(plugin, volume, isovalue, colour, alpha) {
             isoValue: { kind: 'absolute', absoluteValue: isovalue },
             alpha,
             xrayShaded: true,
-            tryUseGpu: true,
+            // Molstar's GPU marching cubes pits the outer lobe of a diffuse orbital
+            // with voxel-sized dimples — caesium's 6s and every 7s, 6d and 7p above
+            // it — and quantises the field to 255 steps on upload unless told
+            // otherwise, which terraces xenon's 4p. The surface is a thin shell
+            // whatever the box holds, so the CPU path costs 13–44 ms and returns
+            // 27 k vertices even on the 152³ grid the highest quality asks for.
+            tryUseGpu: false,
         },
         color: 'uniform',
         colorParams: { value: Color.fromHexStyle(colour) },

package/lib/orbital/ui/renderVolume.js.map

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

package/lib/orbital/ui/viewer.d.ts

@@ -13,6 +13,7 @@
  * molstar's own UI is not mounted: the surrounding site owns every control.
  */
 import type { OrbitalGrid } from '../core/grid.ts';
+import type { OrbitalContour } from '../core/isovalue.ts';
 import type { VolumeStyle } from './renderVolume.ts';
 /** Settings fixed for the life of a viewer. */
 export interface OrbitalViewerOptions {
@@ -49,11 +50,12 @@ export declare class OrbitalViewer {
     /**
      * Replace the isosurface pair with one drawn from a sampled field.
      * @param field - The sampled wavefunction, in ångström.
+     * @param contour - The isovalue and reach measured on that field.
      * @param style - See {@link VolumeStyle}.
      * @returns How far the drawn surface reaches, in scene units, for the camera
      * to frame; `undefined` once the viewer has been disposed.
      */
-    showOrbital(field: OrbitalGrid, style?: VolumeStyle): Promise<number | undefined>;
+    showOrbital(field: OrbitalGrid, contour: OrbitalContour, style?: VolumeStyle): Promise<number | undefined>;
     /**
      * Remove the isosurface pair.
      * @returns Nothing, once the surfaces are gone.

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

@@ -1 +1 @@
-{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../../../src/orbital/ui/viewer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,WAAW,EACtB,OAAO,GAAE,oBAAyB,GACjC,aAAa,CAEf;AAED;;;;;GAKG;AACH,qBAAa,aAAa;;IAIxB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBAElB,SAAS,EAAE,WAAW,EAAE,OAAO,GAAE,oBAAyB;IAiBtE;;;OAGG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;;OAMG;IACH,WAAW,CACT,KAAK,EAAE,WAAW,EAClB,KAAK,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAI9B;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;;;;;;OAOG;IACH,KAAK,CACH,aAAa,CAAC,EAAE,MAAM,EACtB,UAAU,SAA0B,GACnC,OAAO,CAAC,IAAI,CAAC;IAMhB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpD,kEAAkE;IAClE,YAAY,IAAI,IAAI;IAKpB;;;OAGG;IACH,OAAO,IAAI,IAAI;CAkChB"}
+{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../../../src/orbital/ui/viewer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,WAAW,EACtB,OAAO,GAAE,oBAAyB,GACjC,aAAa,CAEf;AAED;;;;;GAKG;AACH,qBAAa,aAAa;;IAIxB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBAElB,SAAS,EAAE,WAAW,EAAE,OAAO,GAAE,oBAAyB;IAiBtE;;;OAGG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;;;OAOG;IACH,WAAW,CACT,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,cAAc,EACvB,KAAK,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAM9B;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;;;;;;OAOG;IACH,KAAK,CACH,aAAa,CAAC,EAAE,MAAM,EACtB,UAAU,SAA0B,GACnC,OAAO,CAAC,IAAI,CAAC;IAMhB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpD,kEAAkE;IAClE,YAAY,IAAI,IAAI;IAKpB;;;OAGG;IACH,OAAO,IAAI,IAAI;CAkChB"}

package/lib/orbital/ui/viewer.js

@@ -65,12 +65,13 @@ export class OrbitalViewer {
     /**
      * Replace the isosurface pair with one drawn from a sampled field.
      * @param field - The sampled wavefunction, in ångström.
+     * @param contour - The isovalue and reach measured on that field.
      * @param style - See {@link VolumeStyle}.
      * @returns How far the drawn surface reaches, in scene units, for the camera
      * to frame; `undefined` once the viewer has been disposed.
      */
-    showOrbital(field, style) {
-        return this.#run((plugin) => renderSampledVolume(plugin, field, style));
+    showOrbital(field, contour, style) {
+        return this.#run((plugin) => renderSampledVolume(plugin, field, contour, style));
     }
     /**
      * Remove the isosurface pair.

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

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

package/lib/orbital/ui/volumeField.d.ts

@@ -1,9 +1,11 @@
 /**
  * Turning a field the caller sampled into the `Volume` molstar's isosurface
- * renderer wants, and measuring how far the surface inside it actually reaches.
+ * renderer wants.
  *
- * Both halves are arithmetic over the samples, which is why they are here
- * rather than in `renderVolume.ts` — that module is about representations.
+ * It is arithmetic over the samples, which is why it is here rather than in
+ * `renderVolume.ts` — that module is about representations. How far the
+ * surface inside the box reaches is measured in `core/isovalue.ts`, beside the
+ * isovalue it is measured against.
  */
 import type { Volume } from 'molstar/lib/mol-model/volume.js';
 import type { OrbitalGrid } from '../core/grid.ts';
@@ -15,24 +17,6 @@ import type { OrbitalGrid } from '../core/grid.ts';
  * impossible to fill the frame with.
  */
 export declare const DISPLAY_REACH = 12;
-/**
- * How far from the centre of the box the drawn surface actually reaches.
- *
- * Molstar sizes a volume representation's bounding sphere from the whole
- * sampled box, which is deliberately much larger than the isosurface inside it,
- * so a camera framing that sphere leaves the orbital a quarter of the frame
- * wide. Measuring the samples that are actually enclosed gives the camera the
- * real extent, and does it here because this is where the isovalue is known.
- * @param field - The sampled field.
- * @param isovalues - The two isovalues the surfaces were drawn at.
- * @param isovalues.negative - Isovalue the negative lobe was drawn at, if any.
- * @param isovalues.positive - Isovalue the positive lobe was drawn at, if any.
- * @returns The reach in ångström, or 0 when nothing was drawn.
- */
-export declare function surfaceReach(field: OrbitalGrid, isovalues: {
-    negative?: number | undefined;
-    positive?: number | undefined;
-}): number;
 /**
  * Wrap a sampled field in molstar's `Volume`.
  *

package/lib/orbital/ui/volumeField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"volumeField.d.ts","sourceRoot":"","sources":["../../../src/orbital/ui/volumeField.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAQ,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKnD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC1E,MAAM,CA2BR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CA2CzE"}
+{"version":3,"file":"volumeField.d.ts","sourceRoot":"","sources":["../../../src/orbital/ui/volumeField.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAQ,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKnD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CA2CzE"}

package/lib/orbital/ui/volumeField.js

@@ -1,9 +1,11 @@
 /**
  * Turning a field the caller sampled into the `Volume` molstar's isosurface
- * renderer wants, and measuring how far the surface inside it actually reaches.
+ * renderer wants.
  *
- * Both halves are arithmetic over the samples, which is why they are here
- * rather than in `renderVolume.ts` — that module is about representations.
+ * It is arithmetic over the samples, which is why it is here rather than in
+ * `renderVolume.ts` — that module is about representations. How far the
+ * surface inside the box reaches is measured in `core/isovalue.ts`, beside the
+ * isovalue it is measured against.
  */
 import { Mat4, Tensor, Vec3 } from 'molstar/lib/mol-math/linear-algebra.js';
 import { CustomProperties } from 'molstar/lib/mol-model/custom-property.js';
@@ -17,48 +19,6 @@ const { Space: createTensorSpace, Data1: asTensorData } = Tensor;
  * impossible to fill the frame with.
  */
 export const DISPLAY_REACH = 12;
-/**
- * How far from the centre of the box the drawn surface actually reaches.
- *
- * Molstar sizes a volume representation's bounding sphere from the whole
- * sampled box, which is deliberately much larger than the isosurface inside it,
- * so a camera framing that sphere leaves the orbital a quarter of the frame
- * wide. Measuring the samples that are actually enclosed gives the camera the
- * real extent, and does it here because this is where the isovalue is known.
- * @param field - The sampled field.
- * @param isovalues - The two isovalues the surfaces were drawn at.
- * @param isovalues.negative - Isovalue the negative lobe was drawn at, if any.
- * @param isovalues.positive - Isovalue the positive lobe was drawn at, if any.
- * @returns The reach in ångström, or 0 when nothing was drawn.
- */
-export function surfaceReach(field, isovalues) {
-    const cutoff = Math.min(Math.abs(isovalues.positive ?? Infinity), Math.abs(isovalues.negative ?? Infinity));
-    if (!Number.isFinite(cutoff) || cutoff <= 0)
-        return 0;
-    const { data, dimensions, origin, spacing } = field;
-    const [countX, countY, countZ] = dimensions;
-    const centreX = origin.x + ((countX - 1) * spacing) / 2;
-    const centreY = origin.y + ((countY - 1) * spacing) / 2;
-    const centreZ = origin.z + ((countZ - 1) * spacing) / 2;
-    let furthest = 0;
-    let index = 0;
-    for (let indexX = 0; indexX < countX; indexX++) {
-        const dx = origin.x + indexX * spacing - centreX;
-        for (let indexY = 0; indexY < countY; indexY++) {
-            const dy = origin.y + indexY * spacing - centreY;
-            for (let indexZ = 0; indexZ < countZ; indexZ++) {
-                const value = data[index++];
-                if (value < cutoff && value > -cutoff)
-                    continue;
-                const dz = origin.z + indexZ * spacing - centreZ;
-                const squared = dx * dx + dy * dy + dz * dz;
-                if (squared > furthest)
-                    furthest = squared;
-            }
-        }
-    }
-    return Math.sqrt(furthest);
-}
 /**
  * Wrap a sampled field in molstar's `Volume`.
  *

package/lib/orbital/ui/volumeField.js.map

@@ -1 +1 @@
-{"version":3,"file":"volumeField.js","sourceRoot":"","sources":["../../../src/orbital/ui/volumeField.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"volumeField.js","sourceRoot":"","sources":["../../../src/orbital/ui/volumeField.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAK5E,qEAAqE;AACrE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEhC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAkB,EAAE,YAAoB;IAC/D,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAC3E,MAAM,IAAI,GAAG,OAAO,GAAG,YAAY,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CACpC,IAAI,CAAC,IAAI,EAAE,EACX,IAAI,CAAC,MAAM,CACT,MAAM,CAAC,CAAC,GAAG,YAAY,EACvB,MAAM,CAAC,CAAC,GAAG,YAAY,EACvB,MAAM,CAAC,CAAC,GAAG,YAAY,CACxB,CACF,CAAC;IACF,MAAM,IAAI,GAAS;QACjB,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC;SAChD;QACD,uEAAuE;QACvE,KAAK,EAAE,MAAM,CAAC,MAAM,CAClB,iBAAiB,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC,EACtD,YAAY,CAAC,IAAI,CAAC,CACnB;QACD,KAAK,EAAE;YACL,GAAG;YACH,GAAG;YACH,IAAI;YACJ,yEAAyE;YACzE,0CAA0C;YAC1C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;SAC/B;KACF,CAAC;IACF,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC3C,UAAU,EAAE;YACV,IAAI,EAAE,gCAAgC;YACtC,IAAI,EAAE,sBAAsB;YAC5B,IAAI;SACL;QACD,gBAAgB,EAAE,IAAI,gBAAgB,EAAE;QACxC,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAA4B;QAC7D,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAA4B;KACnE,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,79 @@
+/**
+ * The `[[term]]` marker language, parsed without a DOM.
+ *
+ * Authored prose — tutorial steps, exercise descriptions, hints — links its
+ * jargon by wrapping it in `[[double brackets]]`. A marker may be written
+ * `[[term|displayed text]]` when the sentence needs a different wording than
+ * the glossary key. Parsing and resolution live here, in plain TypeScript, so
+ * both are unit-tested without rendering anything.
+ */
+/** One worked example inside a glossary entry. */
+export interface GlossaryExample {
+    /** The construct itself: a pattern, a SMILES, a LaTeX fragment, a layer. */
+    code: string;
+    /**
+     * What the construct is shown working on, for a term whose examples take an
+     * input. Left out when the example is about notation only.
+     * @default undefined
+     */
+    input?: string;
+    /**
+     * What this example demonstrates, in one line.
+     * @default undefined
+     */
+    note?: string;
+}
+/** One glossary term, shown wherever a `[[marker]]` names it. */
+export interface GlossaryEntry {
+    /** The term, spelled out as the heading of the tooltip. */
+    title: string;
+    /** One short paragraph — the whole definition. */
+    summary: string;
+    /** Worked examples, shown under the summary. */
+    examples: GlossaryExample[];
+}
+/**
+ * Every term a site defines, keyed by the lowercased text inside a `[[...]]`.
+ *
+ * A key that no marker names is simply never shown, and a marker naming no key
+ * renders as plain prose — so the two sides may be written in either order.
+ */
+export type Glossary = Record<string, GlossaryEntry>;
+/**
+ * One piece of parsed prose: either a run of text, or one marker.
+ *
+ * `start` is the offset of the piece in the source string, which makes it a
+ * stable and unique React key — an array index is neither.
+ */
+export type GlossarySegment = {
+    kind: 'text';
+    start: number;
+    text: string;
+} | {
+    kind: 'term';
+    start: number;
+    term: string;
+    text: string;
+};
+/**
+ * Split authored prose into prose runs and markers.
+ *
+ * A marker yields the lowercased lookup `term` and the `text` to display, which
+ * are the same thing unless the marker used the `term|text` form. The term is
+ * never checked against any glossary here: an unknown term still produces a
+ * `term` segment, and the renderer falls back to showing its text as plain
+ * prose — an author may link a term months before it is written, and the page
+ * must never show the brackets. Text that never closes its brackets (`[[foo`)
+ * is not a marker at all and comes back verbatim inside a `text` segment.
+ * @param text - Authored prose, with or without markers.
+ * @returns The segments, in order, with no empty run between adjacent markers.
+ */
+export declare function parseGlossaryMarkers(text: string): GlossarySegment[];
+/**
+ * Resolve a marker term against a glossary, case-insensitively.
+ * @param glossary - The terms the site defines.
+ * @param term - The text before the pipe of a `[[marker]]`, in any case.
+ * @returns The entry, or `undefined` when no such term has been written yet.
+ */
+export declare function lookupGlossaryTerm(glossary: Glossary, term: string): GlossaryEntry | undefined;
+//# sourceMappingURL=glossary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/core/glossary.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAErD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CAsBpE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,GACX,aAAa,GAAG,SAAS,CAI3B"}

package/lib/pedagogy/core/glossary.js

@@ -0,0 +1,71 @@
+/**
+ * The `[[term]]` marker language, parsed without a DOM.
+ *
+ * Authored prose — tutorial steps, exercise descriptions, hints — links its
+ * jargon by wrapping it in `[[double brackets]]`. A marker may be written
+ * `[[term|displayed text]]` when the sentence needs a different wording than
+ * the glossary key. Parsing and resolution live here, in plain TypeScript, so
+ * both are unit-tested without rendering anything.
+ */
+/**
+ * Split authored prose into prose runs and markers.
+ *
+ * A marker yields the lowercased lookup `term` and the `text` to display, which
+ * are the same thing unless the marker used the `term|text` form. The term is
+ * never checked against any glossary here: an unknown term still produces a
+ * `term` segment, and the renderer falls back to showing its text as plain
+ * prose — an author may link a term months before it is written, and the page
+ * must never show the brackets. Text that never closes its brackets (`[[foo`)
+ * is not a marker at all and comes back verbatim inside a `text` segment.
+ * @param text - Authored prose, with or without markers.
+ * @returns The segments, in order, with no empty run between adjacent markers.
+ */
+export function parseGlossaryMarkers(text) {
+    const segments = [];
+    // A fresh regexp per call: a /g/ literal carries `lastIndex` between calls.
+    const marker = new RegExp(MARKER_SOURCE, 'g');
+    let cursor = 0;
+    let match = marker.exec(text);
+    while (match !== null) {
+        if (match.index > cursor) {
+            segments.push({
+                kind: 'text',
+                start: cursor,
+                text: text.slice(cursor, match.index),
+            });
+        }
+        segments.push(toTermSegment(match.groups?.term ?? '', match.index));
+        cursor = match.index + match[0].length;
+        match = marker.exec(text);
+    }
+    if (cursor < text.length) {
+        segments.push({ kind: 'text', start: cursor, text: text.slice(cursor) });
+    }
+    return segments;
+}
+/**
+ * Resolve a marker term against a glossary, case-insensitively.
+ * @param glossary - The terms the site defines.
+ * @param term - The text before the pipe of a `[[marker]]`, in any case.
+ * @returns The entry, or `undefined` when no such term has been written yet.
+ */
+export function lookupGlossaryTerm(glossary, term) {
+    const key = term.trim().toLowerCase();
+    // `[[constructor]]` and `[[tostring]]` are prose, not inherited members.
+    return Object.hasOwn(glossary, key) ? glossary[key] : undefined;
+}
+const MARKER_SOURCE = String.raw `\[\[(?<term>[^\]]+)\]\]`;
+function toTermSegment(inner, start) {
+    const pipe = inner.indexOf('|');
+    const rawTerm = pipe === -1 ? inner : inner.slice(0, pipe);
+    const rawText = pipe === -1 ? inner : inner.slice(pipe + 1);
+    const term = rawTerm.trim().toLowerCase();
+    const text = rawText.trim();
+    return {
+        kind: 'term',
+        start,
+        term,
+        text: text === '' ? rawTerm.trim() : text,
+    };
+}
+//# sourceMappingURL=glossary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.js","sourceRoot":"","sources":["../../../src/pedagogy/core/glossary.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA+CH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,4EAA4E;IAC5E,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAC9C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,KAAK,KAAK,IAAI,EAAE,CAAC;QACtB,IAAI,KAAK,CAAC,KAAK,GAAG,MAAM,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC;aACtC,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,MAAM,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACvC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAkB,EAClB,IAAY;IAEZ,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtC,yEAAyE;IACzE,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC;AAED,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAA,yBAAyB,CAAC;AAE1D,SAAS,aAAa,CAAC,KAAa,EAAE,KAAa;IACjD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC5B,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,KAAK;QACL,IAAI;QACJ,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;KAC1C,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,8 @@
+export type { Glossary, GlossaryEntry, GlossaryExample, GlossarySegment, } from './glossary.ts';
+export { parseGlossaryMarkers } from './glossary.ts';
+export type { ExerciseProgress, LocalStorageProgressStoreOptions, ProgressRecords, ProgressStore, ProgressSummary, } from './progress.ts';
+export { localStorageProgressStore, progressSummary } from './progress.ts';
+export type { BaseExercise, ExerciseLevel, ExerciseSet, ExerciseStatus, TutorialStep, } from './types.ts';
+export type { FinishValidationOptions, TestCaseResult, ValidationResult, } from './validation.ts';
+export { failedValidation, finishValidation } from './validation.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EACV,gBAAgB,EAChB,gCAAgC,EAChC,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC3E,YAAY,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,uBAAuB,EACvB,cAAc,EACd,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/lib/pedagogy/core/index.js

@@ -0,0 +1,4 @@
+export { parseGlossaryMarkers } from "./glossary.js";
+export { localStorageProgressStore, progressSummary } from "./progress.js";
+export { failedValidation, finishValidation } from "./validation.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pedagogy/core/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAQrD,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAa3E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * Best-effort JSON access to `localStorage`.
+ *
+ * A page framed in a course may have no storage at all — third-party storage is
+ * partitioned in Chrome and blocked in Safari — and a full quota must never
+ * take the page down with it. So both calls swallow everything: an unreadable
+ * entry reads as nothing stored, and a refused write is simply lost.
+ */
+/**
+ * Read one entry back as JSON.
+ * @param key - The storage key.
+ * @returns What was parsed, or `undefined` when there is nothing readable.
+ */
+export declare function readJsonEntry(key: string): unknown;
+/**
+ * Write one entry as JSON.
+ * @param key - The storage key.
+ * @param value - What to store.
+ */
+export declare function writeJsonEntry(key: string, value: unknown): void;
+//# sourceMappingURL=jsonStorage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsonStorage.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/core/jsonStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAWlD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAQhE"}

package/lib/pedagogy/core/jsonStorage.js

@@ -0,0 +1,55 @@
+/**
+ * Best-effort JSON access to `localStorage`.
+ *
+ * A page framed in a course may have no storage at all — third-party storage is
+ * partitioned in Chrome and blocked in Safari — and a full quota must never
+ * take the page down with it. So both calls swallow everything: an unreadable
+ * entry reads as nothing stored, and a refused write is simply lost.
+ */
+/**
+ * Read one entry back as JSON.
+ * @param key - The storage key.
+ * @returns What was parsed, or `undefined` when there is nothing readable.
+ */
+export function readJsonEntry(key) {
+    const storage = getStorage();
+    if (storage === null)
+        return undefined;
+    try {
+        const raw = storage.getItem(key);
+        if (raw === null)
+            return undefined;
+        return JSON.parse(raw);
+    }
+    catch {
+        // Corrupt JSON, or a store that refuses to be read.
+        return undefined;
+    }
+}
+/**
+ * Write one entry as JSON.
+ * @param key - The storage key.
+ * @param value - What to store.
+ */
+export function writeJsonEntry(key, value) {
+    const storage = getStorage();
+    if (storage === null)
+        return;
+    try {
+        storage.setItem(key, JSON.stringify(value));
+    }
+    catch {
+        // Quota exceeded, or a store that refuses to be written.
+    }
+}
+function getStorage() {
+    try {
+        const candidate = globalThis.localStorage;
+        return candidate ?? null;
+    }
+    catch {
+        // Reading localStorage throws outright when storage is blocked.
+        return null;
+    }
+}
+//# sourceMappingURL=jsonStorage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsonStorage.js","sourceRoot":"","sources":["../../../src/pedagogy/core/jsonStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;QACpD,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,KAAc;IACxD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO;IAC7B,IAAI,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;AACH,CAAC;AAED,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,UAAU,CAAC,YAAmC,CAAC;QACjE,OAAO,SAAS,IAAI,IAAI,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}