react-cheminfo 0.8.0 → 0.10.0

package/lib/slides/ui/index.js

@@ -0,0 +1,10 @@
+export { BackToSlides } from "./BackToSlides.js";
+export { DemoLink } from "./DemoLink.js";
+export { EmbedSlide } from "./EmbedSlide.js";
+export { SectionSlide } from "./SectionSlide.js";
+export { SlideView } from "./Slide.js";
+export { SlideBody } from "./SlideBody.js";
+export { Slideshow } from "./Slideshow.js";
+export { SlideshowBar } from "./SlideshowBar.js";
+export { TalkList } from "./TalkList.js";
+//# sourceMappingURL=index.js.map

package/lib/slides/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/slides/ui/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAoB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAgB,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAkB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAoB,CAAC;AAElD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAa,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAiB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAiB,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAoB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAgB,CAAC"}

package/lib/slides/vite/index.d.ts

@@ -0,0 +1,3 @@
+export type { LoadedTalk, TalksOptions } from './talks.ts';
+export { cheminfoTalks, loadTalksFromDisk } from './talks.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/slides/vite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/slides/vite/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/lib/slides/vite/index.js

@@ -0,0 +1,2 @@
+export { cheminfoTalks, loadTalksFromDisk } from "./talks.js";
+//# sourceMappingURL=index.js.map

package/lib/slides/vite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/slides/vite/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/lib/slides/vite/talks.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Publish a site's talks so another site can list and play them.
+ *
+ * A deck is Markdown in the repository of the site whose subject it teaches,
+ * which is what keeps a talk reviewable. For learn.cheminfo.org to gather the
+ * family's talks it needs two static files per site and no API: a manifest of
+ * what exists, and the source of each deck. Both are written at build time and
+ * served with permissive CORS, because public teaching material is fetched from
+ * a page that is not ours.
+ */
+import type { Plugin } from 'vite';
+import type { SiteId } from '../../ecosystem/core/sites.ts';
+import type { Talk } from '../core/talk.ts';
+/** What the build needs to know to publish the decks. */
+export interface TalksOptions {
+    /** The site the talks belong to. */
+    site: SiteId;
+    /**
+     * Where the sources live, relative to the project root.
+     * @default 'src/talks'
+     */
+    dir?: string;
+    /**
+     * Where the site is served, used as the manifest's origin.
+     * @default `https://<the site's host>`
+     */
+    origin?: string;
+}
+/** One talk on disk: its id, its source, and what the source parses into. */
+export interface LoadedTalk {
+    /** The file name without extension, or the folder name for `<id>/index.md`. */
+    id: string;
+    /** The Markdown as written, which is what other sites fetch. */
+    source: string;
+    /** The parsed talk, for the manifest. */
+    talk: Talk;
+}
+/**
+ * Write `talks.json` and `talks/<id>.md` into the build.
+ * @param options - Which site, and where its decks are.
+ * @returns The Vite plugin.
+ */
+export declare function cheminfoTalks(options: TalksOptions): Plugin;
+/**
+ * Read every deck of a directory, in either of the two shapes a talk takes.
+ * @param directory - Absolute path of the talks directory.
+ * @returns The talks, sorted by id so a build is reproducible.
+ */
+export declare function loadTalksFromDisk(directory: string): LoadedTalk[];
+//# sourceMappingURL=talks.d.ts.map

package/lib/slides/vite/talks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"talks.d.ts","sourceRoot":"","sources":["../../../src/slides/vite/talks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAI5C,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,EAAE,EAAE,MAAM,CAAC;IACX,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,IAAI,EAAE,IAAI,CAAC;CACZ;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAiC3D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,CAgCjE"}

package/lib/slides/vite/talks.js

@@ -0,0 +1,87 @@
+/**
+ * Publish a site's talks so another site can list and play them.
+ *
+ * A deck is Markdown in the repository of the site whose subject it teaches,
+ * which is what keeps a talk reviewable. For learn.cheminfo.org to gather the
+ * family's talks it needs two static files per site and no API: a manifest of
+ * what exists, and the source of each deck. Both are written at build time and
+ * served with permissive CORS, because public teaching material is fetched from
+ * a page that is not ours.
+ */
+import { mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { siteById, siteUrl } from "../../ecosystem/core/index.js";
+import { parseTalk } from "../core/talk.js";
+import { buildTalkManifest } from "../core/talkManifest.js";
+/**
+ * Write `talks.json` and `talks/<id>.md` into the build.
+ * @param options - Which site, and where its decks are.
+ * @returns The Vite plugin.
+ */
+export function cheminfoTalks(options) {
+    const { site, dir = 'src/talks' } = options;
+    let root = process.cwd();
+    let outDir = 'dist';
+    return {
+        name: 'cheminfo-talks',
+        apply: 'build',
+        configResolved(config) {
+            root = config.root;
+            outDir = config.build.outDir;
+        },
+        closeBundle() {
+            const talks = loadTalksFromDisk(join(root, dir));
+            const origin = options.origin ?? siteUrl(siteById(site)).replace(/\/$/, '');
+            const manifest = buildTalkManifest({
+                site,
+                origin,
+                talks: talks.map((entry) => ({ id: entry.id, ...entry.talk })),
+            });
+            const target = resolve(root, outDir);
+            mkdirSync(join(target, 'talks'), { recursive: true });
+            writeFileSync(join(target, 'talks.json'), `${JSON.stringify(manifest, null, 2)}\n`);
+            for (const entry of talks) {
+                writeFileSync(join(target, 'talks', `${entry.id}.md`), entry.source);
+            }
+        },
+    };
+}
+/**
+ * Read every deck of a directory, in either of the two shapes a talk takes.
+ * @param directory - Absolute path of the talks directory.
+ * @returns The talks, sorted by id so a build is reproducible.
+ */
+export function loadTalksFromDisk(directory) {
+    const loaded = [];
+    let entries = [];
+    try {
+        entries = readdirSync(directory);
+    }
+    catch {
+        // A site with no talks yet still builds; it simply publishes an empty list.
+        return loaded;
+    }
+    for (const entry of entries) {
+        const path = join(directory, entry);
+        if (entry.endsWith('.md')) {
+            const source = readFileSync(path, 'utf8');
+            loaded.push({
+                id: entry.slice(0, -3),
+                source,
+                talk: parseTalk(source),
+            });
+            continue;
+        }
+        const index = join(path, 'index.md');
+        let source;
+        try {
+            source = readFileSync(index, 'utf8');
+        }
+        catch {
+            continue;
+        }
+        loaded.push({ id: entry, source, talk: parseTalk(source) });
+    }
+    return loaded.toSorted((left, right) => left.id.localeCompare(right.id));
+}
+//# sourceMappingURL=talks.js.map

package/lib/slides/vite/talks.js.map

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

package/lib/slides.d.ts

@@ -0,0 +1,3 @@
+export * from './slides/core/index.ts';
+export * from './slides/ui/index.ts';
+//# sourceMappingURL=slides.d.ts.map

package/lib/slides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slides.d.ts","sourceRoot":"","sources":["../src/slides.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}

package/lib/slides.js

@@ -0,0 +1,3 @@
+export * from "./slides/core/index.js";
+export * from "./slides/ui/index.js";
+//# sourceMappingURL=slides.js.map

package/lib/slides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slides.js","sourceRoot":"","sources":["../src/slides.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}

package/lib/spectra/core/axisEntries.d.ts

@@ -0,0 +1,50 @@
+export declare const AXIS_ENTRIES: {
+    readonly xFunction: {
+        readonly label: "Apply a formula to x";
+        readonly group: "x-axis";
+        readonly summary: "Rewrites every x through an expression, read the same way as the y one.";
+        readonly fields: readonly [import("./filterFields.ts").FilterField];
+        readonly caution: "Every range below is then read in the new units — including the resampling range, which runs last unless you resample first.";
+    };
+    readonly fromTo: {
+        readonly label: "Crop";
+        readonly group: "x-axis";
+        readonly summary: "Keeps one stretch of the spectrum and drops the rest.";
+        readonly fields: readonly [...import("./filterFields.ts").FilterField[], import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField];
+        readonly caution: "Give x values or point numbers, not both: a point number silently wins over an x value.";
+    };
+    readonly filterX: {
+        readonly label: "Keep or drop x zones";
+        readonly group: "x-axis";
+        readonly summary: "Keeps the points falling in the zones named, without resampling anything.";
+        readonly fields: readonly import("./filterFields.ts").FilterField[];
+    };
+    readonly equallySpaced: {
+        readonly label: "Resample on a regular grid";
+        readonly group: "x-axis";
+        readonly summary: "Interpolates onto evenly spaced x values.";
+        readonly fields: readonly import("./filterFields.ts").FilterField[];
+        readonly caution: "The settings above already resample once, so this resamples twice; whichever of the two runs last sets the point count.";
+    };
+    readonly calibrateX: {
+        readonly label: "Calibrate x on a peak";
+        readonly group: "x-axis";
+        readonly summary: "Finds the strongest peaks in a stretch and shifts the whole axis so their mean lands on the value asked for.";
+        readonly fields: readonly [...import("./filterFields.ts").FilterField[], import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField];
+        readonly caution: "When fewer peaks are found than asked for, the spectrum is returned untouched and nothing says so.";
+    };
+    readonly ensureGrowing: {
+        readonly label: "Make x strictly increasing";
+        readonly group: "utility";
+        readonly summary: "Drops the points that repeat or go backwards, which resampling and cropping both assume never happens.";
+        readonly fields: readonly [];
+    };
+    readonly reverseIfNeeded: {
+        readonly label: "Reverse a descending x";
+        readonly group: "utility";
+        readonly summary: "Turns a descending axis the right way round.";
+        readonly fields: readonly [];
+        readonly caution: "The chain already does this before every step, so adding it here changes nothing.";
+    };
+};
+//# sourceMappingURL=axisEntries.d.ts.map

package/lib/spectra/core/axisEntries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axisEntries.d.ts","sourceRoot":"","sources":["../../../src/spectra/core/axisEntries.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgG8B,CAAC"}

package/lib/spectra/core/axisEntries.js

@@ -0,0 +1,78 @@
+import { RANGE_FIELDS, ZONE_FIELDS } from "./filterEntries.js";
+import { booleanField, enumField, formulaField, integerField, numberField, } from "./filterFields.js";
+export const AXIS_ENTRIES = {
+    xFunction: {
+        label: 'Apply a formula to x',
+        group: 'x-axis',
+        summary: 'Rewrites every x through an expression, read the same way as the y one.',
+        fields: [
+            formulaField('function', 'Expression in x', 'For instance 10000000/x, which reads nanometres as wavenumbers.'),
+        ],
+        caution: 'Every range below is then read in the new units — including the resampling range, which runs last unless you resample first.',
+    },
+    fromTo: {
+        label: 'Crop',
+        group: 'x-axis',
+        summary: 'Keeps one stretch of the spectrum and drops the rest.',
+        fields: [
+            ...RANGE_FIELDS,
+            integerField('fromIndex', 'From (point)', '0'),
+            integerField('toIndex', 'To (point)', 'the last point'),
+        ],
+        caution: 'Give x values or point numbers, not both: a point number silently wins over an x value.',
+    },
+    filterX: {
+        label: 'Keep or drop x zones',
+        group: 'x-axis',
+        summary: 'Keeps the points falling in the zones named, without resampling anything.',
+        fields: [...RANGE_FIELDS, ...ZONE_FIELDS],
+    },
+    equallySpaced: {
+        label: 'Resample on a regular grid',
+        group: 'x-axis',
+        summary: 'Interpolates onto evenly spaced x values.',
+        fields: [
+            ...RANGE_FIELDS,
+            integerField('numberOfPoints', 'Number of points', '100'),
+            ...ZONE_FIELDS,
+        ],
+        caution: 'The settings above already resample once, so this resamples twice; whichever of the two runs last sets the point count.',
+    },
+    calibrateX: {
+        label: 'Calibrate x on a peak',
+        group: 'x-axis',
+        summary: 'Finds the strongest peaks in a stretch and shifts the whole axis so their mean lands on the value asked for.',
+        fields: [
+            ...RANGE_FIELDS,
+            integerField('nbPeaks', 'Peaks to find', '1'),
+            numberField('targetX', 'Move them to', '0'),
+            booleanField('gsd.smoothY', 'Smooth before picking'),
+            booleanField('gsd.maxCriteria', 'Pick maxima', 'Off picks minima instead.'),
+            numberField('gsd.minMaxRatio', 'Smallest peak kept', '0.00025', 'As a fraction of the tallest. A step added here starts at 0.1; empty the box and this far lower default takes over.'),
+            numberField('gsd.noiseLevel', 'Noise level', 'not set'),
+            booleanField('gsd.realTopDetection', 'Refine the summit'),
+            integerField('gsd.sgOptions.windowSize', 'Peak-picking window', '9'),
+            integerField('gsd.sgOptions.polynomial', 'Peak-picking polynomial', '3'),
+            enumField('gsd.peakDetectionAlgorithm', 'Detected on', [
+                { value: 'first', label: 'The first derivative' },
+                { value: 'second', label: 'The second derivative' },
+                { value: 'auto', label: 'Whichever fits' },
+            ]),
+        ],
+        caution: 'When fewer peaks are found than asked for, the spectrum is returned untouched and nothing says so.',
+    },
+    ensureGrowing: {
+        label: 'Make x strictly increasing',
+        group: 'utility',
+        summary: 'Drops the points that repeat or go backwards, which resampling and cropping both assume never happens.',
+        fields: [],
+    },
+    reverseIfNeeded: {
+        label: 'Reverse a descending x',
+        group: 'utility',
+        summary: 'Turns a descending axis the right way round.',
+        fields: [],
+        caution: 'The chain already does this before every step, so adding it here changes nothing.',
+    },
+};
+//# sourceMappingURL=axisEntries.js.map

package/lib/spectra/core/axisEntries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"axisEntries.js","sourceRoot":"","sources":["../../../src/spectra/core/axisEntries.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,SAAS,EAAE;QACT,KAAK,EAAE,sBAAsB;QAC7B,KAAK,EAAE,QAAQ;QACf,OAAO,EACL,yEAAyE;QAC3E,MAAM,EAAE;YACN,YAAY,CACV,UAAU,EACV,iBAAiB,EACjB,iEAAiE,CAClE;SACF;QACD,OAAO,EACL,8HAA8H;KACjI;IACD,MAAM,EAAE;QACN,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,uDAAuD;QAChE,MAAM,EAAE;YACN,GAAG,YAAY;YACf,YAAY,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,CAAC;YAC9C,YAAY,CAAC,SAAS,EAAE,YAAY,EAAE,gBAAgB,CAAC;SACxD;QACD,OAAO,EACL,yFAAyF;KAC5F;IACD,OAAO,EAAE;QACP,KAAK,EAAE,sBAAsB;QAC7B,KAAK,EAAE,QAAQ;QACf,OAAO,EACL,2EAA2E;QAC7E,MAAM,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,WAAW,CAAC;KAC1C;IACD,aAAa,EAAE;QACb,KAAK,EAAE,4BAA4B;QACnC,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,2CAA2C;QACpD,MAAM,EAAE;YACN,GAAG,YAAY;YACf,YAAY,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,KAAK,CAAC;YACzD,GAAG,WAAW;SACf;QACD,OAAO,EACL,yHAAyH;KAC5H;IACD,UAAU,EAAE;QACV,KAAK,EAAE,uBAAuB;QAC9B,KAAK,EAAE,QAAQ;QACf,OAAO,EACL,8GAA8G;QAChH,MAAM,EAAE;YACN,GAAG,YAAY;YACf,YAAY,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,CAAC;YAC7C,WAAW,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,CAAC;YAC3C,YAAY,CAAC,aAAa,EAAE,uBAAuB,CAAC;YACpD,YAAY,CACV,iBAAiB,EACjB,aAAa,EACb,2BAA2B,CAC5B;YACD,WAAW,CACT,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,EACT,qHAAqH,CACtH;YACD,WAAW,CAAC,gBAAgB,EAAE,aAAa,EAAE,SAAS,CAAC;YACvD,YAAY,CAAC,sBAAsB,EAAE,mBAAmB,CAAC;YACzD,YAAY,CAAC,0BAA0B,EAAE,qBAAqB,EAAE,GAAG,CAAC;YACpE,YAAY,CAAC,0BAA0B,EAAE,yBAAyB,EAAE,GAAG,CAAC;YACxE,SAAS,CAAC,4BAA4B,EAAE,aAAa,EAAE;gBACrD,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,sBAAsB,EAAE;gBACjD,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,uBAAuB,EAAE;gBACnD,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE;aAC3C,CAAC;SACH;QACD,OAAO,EACL,oGAAoG;KACvG;IACD,aAAa,EAAE;QACb,KAAK,EAAE,4BAA4B;QACnC,KAAK,EAAE,SAAS;QAChB,OAAO,EACL,wGAAwG;QAC1G,MAAM,EAAE,EAAE;KACX;IACD,eAAe,EAAE;QACf,KAAK,EAAE,wBAAwB;QAC/B,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,8CAA8C;QACvD,MAAM,EAAE,EAAE;QACV,OAAO,EACL,mFAAmF;KACtF;CACoD,CAAC"}

package/lib/spectra/core/chainProblems.d.ts

@@ -0,0 +1,14 @@
+import type { SettingsProblem } from './problems.ts';
+import type { SpectrumFilter } from './settings.ts';
+/**
+ * Everything wrong, or probably wrong, with one chain.
+ *
+ * The order of a chain is its meaning — scaling measured before a baseline is
+ * removed measures an offset that is about to change — so the advice below is
+ * as much about where a step sits as about what it is set to.
+ * @param chain - The steps, in the order they run.
+ * @param resampleFirst - Whether the settings resample before the chain runs.
+ * @returns Every problem found, errors and advice together.
+ */
+export declare function chainProblems(chain: readonly SpectrumFilter[], resampleFirst: boolean): SettingsProblem[];
+//# sourceMappingURL=chainProblems.d.ts.map

package/lib/spectra/core/chainProblems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainProblems.d.ts","sourceRoot":"","sources":["../../../src/spectra/core/chainProblems.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,eAAe,CAAC;AAuBxE;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,aAAa,EAAE,OAAO,GACrB,eAAe,EAAE,CAqHnB"}

package/lib/spectra/core/chainProblems.js

@@ -0,0 +1,100 @@
+import { filterStepLabel, findFilterEntry } from "./filterCatalog.js";
+import { problem } from "./problems.js";
+import { stepProblems } from "./stepProblems.js";
+/** The steps that all say "make the y scale comparable"; only the last survives. */
+const SCALING_STEPS = new Set([
+    'divideBySD',
+    'normed',
+    'paretoNormalization',
+    'rescale',
+]);
+/** The steps that hand on plain arrays, whatever they were given. */
+const UNTYPES_X = new Set([
+    'equallySpaced',
+    'filterX',
+]);
+/** The steps that read x as a typed array and throw on a plain one. */
+const NEEDS_TYPED_X = new Set([
+    'calibrateX',
+    'fromTo',
+]);
+/**
+ * Everything wrong, or probably wrong, with one chain.
+ *
+ * The order of a chain is its meaning — scaling measured before a baseline is
+ * removed measures an offset that is about to change — so the advice below is
+ * as much about where a step sits as about what it is set to.
+ * @param chain - The steps, in the order they run.
+ * @param resampleFirst - Whether the settings resample before the chain runs.
+ * @returns Every problem found, errors and advice together.
+ */
+export function chainProblems(chain, resampleFirst) {
+    const problems = [];
+    let baselines = 0;
+    let scalings = 0;
+    let firstScaling;
+    let plainX = resampleFirst;
+    let mayBePlainX = resampleFirst;
+    for (const [index, step] of chain.entries()) {
+        const where = filterStepLabel(step.name, index);
+        const entry = findFilterEntry(step.name);
+        problems.push(...stepProblems(step, where));
+        if (entry === undefined) {
+            problems.push(problem('warning', where, `${step.name} is not one of the steps this editor knows, so its options are left as they are. The processor throws on a name it cannot dispatch.`));
+            continue;
+        }
+        if (NEEDS_TYPED_X.has(step.name)) {
+            if (plainX) {
+                problems.push(problem('error', where, TYPED_X_MESSAGE));
+            }
+            else if (mayBePlainX) {
+                problems.push(problem('warning', where, MAY_BE_PLAIN_MESSAGE));
+            }
+        }
+        if (UNTYPES_X.has(step.name)) {
+            plainX = true;
+            mayBePlainX = true;
+        }
+        if (step.name === 'ensureGrowing')
+            mayBePlainX = true;
+        const { group } = entry;
+        if (group === 'baseline') {
+            baselines++;
+            if (firstScaling !== undefined) {
+                problems.push(problem('warning', where, `Step ${String(firstScaling + 1)} scales the signal before this levels it, so the scaling is measured against an offset that then changes. Level first.`));
+                firstScaling = undefined;
+            }
+        }
+        if (SCALING_STEPS.has(step.name)) {
+            scalings++;
+            firstScaling ??= index;
+        }
+        if (step.name === 'reverseIfNeeded') {
+            problems.push(problem('warning', where, 'The chain already turns a descending axis round before every step, so this one does nothing.'));
+        }
+        if (step.name === 'equallySpaced') {
+            problems.push(problem('warning', where, resampleFirst
+                ? 'The settings resample before the chain runs, so this resamples a second time and the point count set here is the one the matrix ends up with.'
+                : 'The settings resample after the chain runs, so this resamples a second time and the point count set above is the one the matrix ends up with.'));
+        }
+        if (!resampleFirst &&
+            (step.name === 'xFunction' || step.name === 'calibrateX')) {
+            problems.push(problem('warning', where, 'This changes the x axis before the resampling runs, so the range and the exclusions above are read in the new units.'));
+        }
+        if (resampleFirst && step.name === 'filterX') {
+            problems.push(problem('warning', where, 'Cropping after the resampling can leave each spectrum on its own grid, and the matrix then lines up rows that do not match. Pin the range above, or turn resampling back to last.'));
+        }
+    }
+    if (baselines > 1) {
+        problems.push(problem('warning', 'The chain', `${String(baselines)} baselines are subtracted one after another, each estimated from what the last one left.`));
+    }
+    if (scalings > 1) {
+        problems.push(problem('warning', 'The chain', `${String(scalings)} steps set the y scale; only the last of them still shows in the result.`));
+    }
+    return problems;
+}
+/** What a step reading x as a typed array is told when it cannot be one. */
+const TYPED_X_MESSAGE = 'This step reads x as a typed array, and resampling or cropping has already turned it into a plain one, so the processor throws. Move it before them, or turn resampling back to last.';
+/** The same, when only the data can settle whether x was untyped. */
+const MAY_BE_PLAIN_MESSAGE = 'This step reads x as a typed array. An earlier step turns x into a plain one whenever it has points to drop, and the processor then throws on this step.';
+//# sourceMappingURL=chainProblems.js.map

package/lib/spectra/core/chainProblems.js.map

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

package/lib/spectra/core/filterCatalog.d.ts

@@ -0,0 +1,57 @@
+import type { FilterCatalogEntry } from './filterEntries.ts';
+import type { FilterGroup } from './filterFields.ts';
+import type { SpectrumFilterName } from './settings.ts';
+/**
+ * What the editor knows about every step `filterXY` dispatches.
+ *
+ * Keyed by the name rather than listed, so the day `ml-signal-processing` adds
+ * a filter this object stops compiling and the gap is a build failure instead
+ * of a step nobody can reach.
+ */
+export declare const FILTER_CATALOG: Readonly<Record<SpectrumFilterName, FilterCatalogEntry>>;
+/** Every step name, in the order the menu offers them. */
+export declare const FILTER_NAMES: readonly SpectrumFilterName[];
+/**
+ * What the editor knows about one step.
+ * @param name - The step's name.
+ * @returns Its catalog entry.
+ */
+export declare function filterEntry(name: SpectrumFilterName): FilterCatalogEntry;
+/**
+ * What the editor knows about a step whose name it may not recognise.
+ *
+ * The settings the processor accepts are typed `{ name: string }`, and
+ * `filterXY` really does dispatch four more names than the union declares, so a
+ * chain reaching the editor can name a step the catalog has never heard of.
+ * Answering nothing lets the panel say so; throwing would take the whole page
+ * down over one row.
+ * @param name - The step's name, from settings that may come from anywhere.
+ * @returns Its catalog entry, or undefined when the name is not one of the 23.
+ */
+export declare function findFilterEntry(name: string): FilterCatalogEntry | undefined;
+/**
+ * How the panel labels one step of a chain, whether or not it knows the step.
+ * @param name - The step's name.
+ * @param position - Where it sits, counting from zero.
+ * @returns The label the row and every problem about it share.
+ */
+export declare function filterStepLabel(name: string, position: number): string;
+/**
+ * The steps of one group, in menu order.
+ * @param group - Which part of the signal the steps work on.
+ * @returns Their names.
+ */
+export declare function filterNamesInGroup(group: FilterGroup): readonly SpectrumFilterName[];
+/**
+ * The whole menu, group by group, skipping a group that holds nothing.
+ *
+ * The 23 steps are unreadable as one list, and grouping them by what they touch
+ * is the same order a chain is usually built in: level the baseline, smooth,
+ * scale, then move the axis.
+ * @returns Each group with its steps.
+ */
+export declare function filterMenu(): ReadonlyArray<{
+    group: FilterGroup;
+    names: readonly SpectrumFilterName[];
+}>;
+//# sourceMappingURL=filterCatalog.d.ts.map

package/lib/spectra/core/filterCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterCatalog.d.ts","sourceRoot":"","sources":["../../../src/spectra/core/filterCatalog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CACnC,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAK/C,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,YAAY,EAAE,SAAS,kBAAkB,EAE7B,CAAC;AAE1B;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,CAExE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAI5E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,GACjB,SAAS,kBAAkB,EAAE,CAM/B;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,aAAa,CAAC;IAC1C,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACtC,CAAC,CAUD"}

package/lib/spectra/core/filterCatalog.js

@@ -0,0 +1,81 @@
+import { AXIS_ENTRIES } from "./axisEntries.js";
+import { BASELINE_ENTRIES, SIGNAL_ENTRIES } from "./filterEntries.js";
+import { FILTER_GROUPS } from "./filterFields.js";
+/**
+ * What the editor knows about every step `filterXY` dispatches.
+ *
+ * Keyed by the name rather than listed, so the day `ml-signal-processing` adds
+ * a filter this object stops compiling and the gap is a build failure instead
+ * of a step nobody can reach.
+ */
+export const FILTER_CATALOG = {
+    ...BASELINE_ENTRIES,
+    ...SIGNAL_ENTRIES,
+    ...AXIS_ENTRIES,
+};
+/** Every step name, in the order the menu offers them. */
+export const FILTER_NAMES = Object.keys(FILTER_CATALOG);
+/**
+ * What the editor knows about one step.
+ * @param name - The step's name.
+ * @returns Its catalog entry.
+ */
+export function filterEntry(name) {
+    return FILTER_CATALOG[name];
+}
+/**
+ * What the editor knows about a step whose name it may not recognise.
+ *
+ * The settings the processor accepts are typed `{ name: string }`, and
+ * `filterXY` really does dispatch four more names than the union declares, so a
+ * chain reaching the editor can name a step the catalog has never heard of.
+ * Answering nothing lets the panel say so; throwing would take the whole page
+ * down over one row.
+ * @param name - The step's name, from settings that may come from anywhere.
+ * @returns Its catalog entry, or undefined when the name is not one of the 23.
+ */
+export function findFilterEntry(name) {
+    return Object.hasOwn(FILTER_CATALOG, name)
+        ? FILTER_CATALOG[name]
+        : undefined;
+}
+/**
+ * How the panel labels one step of a chain, whether or not it knows the step.
+ * @param name - The step's name.
+ * @param position - Where it sits, counting from zero.
+ * @returns The label the row and every problem about it share.
+ */
+export function filterStepLabel(name, position) {
+    return `Step ${String(position + 1)} — ${findFilterEntry(name)?.label ?? name}`;
+}
+/**
+ * The steps of one group, in menu order.
+ * @param group - Which part of the signal the steps work on.
+ * @returns Their names.
+ */
+export function filterNamesInGroup(group) {
+    const names = [];
+    for (const name of FILTER_NAMES) {
+        if (FILTER_CATALOG[name].group === group)
+            names.push(name);
+    }
+    return names;
+}
+/**
+ * The whole menu, group by group, skipping a group that holds nothing.
+ *
+ * The 23 steps are unreadable as one list, and grouping them by what they touch
+ * is the same order a chain is usually built in: level the baseline, smooth,
+ * scale, then move the axis.
+ * @returns Each group with its steps.
+ */
+export function filterMenu() {
+    const menu = [];
+    for (const group of FILTER_GROUPS) {
+        const names = filterNamesInGroup(group);
+        if (names.length > 0)
+            menu.push({ group, names });
+    }
+    return menu;
+}
+//# sourceMappingURL=filterCatalog.js.map

package/lib/spectra/core/filterCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterCatalog.js","sourceRoot":"","sources":["../../../src/spectra/core/filterCatalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAEvB;IACF,GAAG,gBAAgB;IACnB,GAAG,cAAc;IACjB,GAAG,YAAY;CAChB,CAAC;AAEF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,YAAY,GAAkC,MAAM,CAAC,IAAI,CACpE,cAAc,CACS,CAAC;AAE1B;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAwB;IAClD,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,IAAI,CAAC;QACxC,CAAC,CAAC,cAAc,CAAC,IAA0B,CAAC;QAC5C,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAAgB;IAC5D,OAAO,QAAQ,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC;AAClF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAkB;IAElB,MAAM,KAAK,GAAyB,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU;IAIxB,MAAM,IAAI,GAGL,EAAE,CAAC;IACR,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}