react-cheminfo 0.8.0 → 0.10.0

package/lib/spectra/core/filterFields.js

@@ -0,0 +1,82 @@
+/** The groups in the order a chain is usually built: shape, then scale, then axis. */
+export const FILTER_GROUPS = [
+    'baseline',
+    'smoothing',
+    'scaling',
+    'y-axis',
+    'x-axis',
+    'utility',
+];
+/** What each group is called above its slice of the menu. */
+export const FILTER_GROUP_LABELS = {
+    baseline: 'Baseline',
+    smoothing: 'Smoothing and derivatives',
+    scaling: 'Scaling',
+    'y-axis': 'y axis',
+    'x-axis': 'x axis',
+    utility: 'Housekeeping',
+};
+/**
+ * A whole number field.
+ * @param key - Where the value sits in the step's options.
+ * @param label - What the field is called.
+ * @param placeholder - What upstream does when it is empty.
+ * @param help - One line saying what it changes.
+ * @returns The descriptor.
+ */
+export function integerField(key, label, placeholder, help) {
+    return { key, label, kind: 'integer', placeholder, help };
+}
+/**
+ * A field taking any number.
+ * @param key - Where the value sits in the step's options.
+ * @param label - What the field is called.
+ * @param placeholder - What upstream does when it is empty.
+ * @param help - One line saying what it changes.
+ * @returns The descriptor.
+ */
+export function numberField(key, label, placeholder, help) {
+    return { key, label, kind: 'number', placeholder, help };
+}
+/**
+ * A field taking one of a fixed set of values.
+ * @param key - Where the value sits in the step's options.
+ * @param label - What the field is called.
+ * @param choices - What may be picked.
+ * @param help - One line saying what it changes.
+ * @returns The descriptor.
+ */
+export function enumField(key, label, choices, help) {
+    return { key, label, kind: 'enum', choices, help };
+}
+/**
+ * A yes-or-no field.
+ * @param key - Where the value sits in the step's options.
+ * @param label - What the field is called.
+ * @param help - One line saying what it changes.
+ * @returns The descriptor.
+ */
+export function booleanField(key, label, help) {
+    return { key, label, kind: 'boolean', help };
+}
+/**
+ * A field taking an expression over one variable.
+ * @param key - Where the value sits in the step's options.
+ * @param label - What the field is called.
+ * @param help - One line saying what it changes.
+ * @returns The descriptor.
+ */
+export function formulaField(key, label, help) {
+    return { key, label, kind: 'formula', help };
+}
+/**
+ * A field taking a list of `from` / `to` stretches.
+ * @param key - Where the value sits in the step's options.
+ * @param label - What the field is called.
+ * @param help - One line saying what it changes.
+ * @returns The descriptor.
+ */
+export function zonesField(key, label, help) {
+    return { key, label, kind: 'zones', help };
+}
+//# sourceMappingURL=filterFields.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filterFields.js","sourceRoot":"","sources":["../../../src/spectra/core/filterFields.ts"],"names":[],"mappings":"AA4CA,sFAAsF;AACtF,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,UAAU;IACV,WAAW;IACX,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,SAAS;CACV,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,mBAAmB,GAA0C;IACxE,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,2BAA2B;IACtC,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,cAAc;CACxB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAW,EACX,KAAa,EACb,WAAoB,EACpB,IAAa;IAEb,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,GAAW,EACX,KAAa,EACb,WAAoB,EACpB,IAAa;IAEb,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC3D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CACvB,GAAW,EACX,KAAa,EACb,OAAgC,EAChC,IAAa;IAEb,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAW,EACX,KAAa,EACb,IAAa;IAEb,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAW,EACX,KAAa,EACb,IAAa;IAEb,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CACxB,GAAW,EACX,KAAa,EACb,IAAa;IAEb,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC7C,CAAC"}

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

@@ -0,0 +1,14 @@
+export type { ProblemSeverity, SettingsProblem } from './problems.ts';
+export { formulaProblem, isUsableLabel } from './problems.ts';
+export type { FilterCatalogEntry } from './filterEntries.ts';
+export type { FilterChoice, FilterField, FilterFieldKind, FilterGroup, } from './filterFields.ts';
+export { FILTER_GROUPS, FILTER_GROUP_LABELS } from './filterFields.ts';
+export { FILTER_CATALOG, FILTER_NAMES, filterEntry, filterMenu, filterNamesInGroup, } from './filterCatalog.ts';
+export { addFilter, defaultFilter, duplicateFilter, filterOptions, moveFilter, readFilterOption, removeFilter, setFilterOption, } from './filterChain.ts';
+export type { PrincipalComponentSelection, PrincipalComponentSettings, } from './principalComponents.ts';
+export { DEFAULT_PRINCIPAL_COMPONENTS, PCA_METHODS, clampPrincipalComponents, principalComponentChoices, principalComponentLabel, selectedExplainedVariance, } from './principalComponents.ts';
+export type { ExclusionZone, MatrixFilter, MatrixFilterName, NormalizationSettings, PostProcessingSettings, ScaleMethod, ScaleSettings, SpectraCalculation, SpectraProcessorSettings, SpectraRange, SpectraSettings, SpectrumFilter, SpectrumFilterName, } from './settings.ts';
+export { DEFAULT_MAX_MEMORY, DEFAULT_NUMBER_OF_POINTS, EMPTY_SETTINGS, normalizationFilters, withNormalizationFilters, } from './settings.ts';
+export { MATRIX_FILTER_NAMES, SCALE_METHODS, settingsProblems, } from './settingsProblems.ts';
+export { chainProblems } from './chainProblems.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/spectra/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,cAAc,EACd,YAAY,EACZ,WAAW,EACX,UAAU,EACV,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,SAAS,EACT,aAAa,EACb,eAAe,EACf,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,4BAA4B,EAC5B,WAAW,EACX,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/lib/spectra/core/index.js

@@ -0,0 +1,9 @@
+export { formulaProblem, isUsableLabel } from "./problems.js";
+export { FILTER_GROUPS, FILTER_GROUP_LABELS } from "./filterFields.js";
+export { FILTER_CATALOG, FILTER_NAMES, filterEntry, filterMenu, filterNamesInGroup, } from "./filterCatalog.js";
+export { addFilter, defaultFilter, duplicateFilter, filterOptions, moveFilter, readFilterOption, removeFilter, setFilterOption, } from "./filterChain.js";
+export { DEFAULT_PRINCIPAL_COMPONENTS, PCA_METHODS, clampPrincipalComponents, principalComponentChoices, principalComponentLabel, selectedExplainedVariance, } from "./principalComponents.js";
+export { DEFAULT_MAX_MEMORY, DEFAULT_NUMBER_OF_POINTS, EMPTY_SETTINGS, normalizationFilters, withNormalizationFilters, } from "./settings.js";
+export { MATRIX_FILTER_NAMES, SCALE_METHODS, settingsProblems, } from "./settingsProblems.js";
+export { chainProblems } from "./chainProblems.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/spectra/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAQ9D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,cAAc,EACd,YAAY,EACZ,WAAW,EACX,UAAU,EACV,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,SAAS,EACT,aAAa,EACb,eAAe,EACf,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EACL,4BAA4B,EAC5B,WAAW,EACX,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAgBlC,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,70 @@
+import type { PCAOptions } from 'ml-pca';
+/**
+ * How the principal components are computed.
+ *
+ * `spectra-processor` hands out the normalized matrix and stops there, so the
+ * decomposition is the consumer's `new PCA(matrix, options)` call — these are
+ * that call's options, read off `ml-pca` rather than retyped.
+ */
+export type PrincipalComponentSettings = Omit<PCAOptions, 'isCovarianceMatrix'>;
+/**
+ * Which two components a score plot is drawn against.
+ *
+ * Both are columns of the score matrix, counting from zero: `PC1` is `0`. The
+ * labels say `PC1` because that is what a chemist writes; the numbers stay
+ * zero-based because that is what indexes the matrix.
+ */
+export interface PrincipalComponentSelection {
+    /** The component along x — `0` is `PC1`. */
+    x: number;
+    /** The component along y — `1` is `PC2`. */
+    y: number;
+}
+/** The first two components, which is what a score plot opens on. */
+export declare const DEFAULT_PRINCIPAL_COMPONENTS: PrincipalComponentSelection;
+/** How `ml-pca` may be asked to decompose the matrix. */
+export declare const PCA_METHODS: ReadonlyArray<{
+    value: NonNullable<PCAOptions['method']>;
+    label: string;
+}>;
+/**
+ * What one component is called, with the share of the variance it carries.
+ * @param index - The component, counting from zero.
+ * @param explainedVariance - What `pca.getExplainedVariance()` returned, as fractions.
+ * @returns For instance `PC1 — 74.2 %`, or just `PC1` when no variance is known.
+ */
+export declare function principalComponentLabel(index: number, explainedVariance?: readonly number[]): string;
+/**
+ * Every component that can be picked, in order.
+ *
+ * A component nobody can read is worse than none, so the share of the variance
+ * travels with the label: a reader picking `PC7 — 0.3 %` can see they are about
+ * to plot noise.
+ * @param count - How many components the decomposition produced.
+ * @param explainedVariance - What `pca.getExplainedVariance()` returned.
+ * @returns The choices, one per component.
+ */
+export declare function principalComponentChoices(count: number, explainedVariance?: readonly number[]): ReadonlyArray<{
+    index: number;
+    label: string;
+}>;
+/**
+ * The selection made safe against the decomposition that actually came back.
+ *
+ * A saved selection outlives the data it was made on: reload with fewer spectra
+ * and `PC8` no longer exists. Rather than let a plot ask for a column that is
+ * not there, the pair is pulled back inside what was computed, and the two axes
+ * are kept apart so the plot never collapses onto its diagonal.
+ * @param selection - What the reader picked, possibly on other data.
+ * @param count - How many components the decomposition produced.
+ * @returns A selection both of whose components exist.
+ */
+export declare function clampPrincipalComponents(selection: PrincipalComponentSelection, count: number): PrincipalComponentSelection;
+/**
+ * The share of the variance the two picked components carry together.
+ * @param selection - Which components are drawn.
+ * @param explainedVariance - What `pca.getExplainedVariance()` returned.
+ * @returns The sum as a fraction, or undefined when either share is unknown.
+ */
+export declare function selectedExplainedVariance(selection: PrincipalComponentSelection, explainedVariance: readonly number[]): number | undefined;
+//# sourceMappingURL=principalComponents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"principalComponents.d.ts","sourceRoot":"","sources":["../../../src/spectra/core/principalComponents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC1C,4CAA4C;IAC5C,CAAC,EAAE,MAAM,CAAC;IACV,4CAA4C;IAC5C,CAAC,EAAE,MAAM,CAAC;CACX;AAED,qEAAqE;AACrE,eAAO,MAAM,4BAA4B,EAAE,2BAG1C,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC;IACtC,KAAK,EAAE,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf,CAIA,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,GACpC,MAAM,CAKR;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,GACpC,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CASjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,2BAA2B,EACtC,KAAK,EAAE,MAAM,GACZ,2BAA2B,CAO7B;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,2BAA2B,EACtC,iBAAiB,EAAE,SAAS,MAAM,EAAE,GACnC,MAAM,GAAG,SAAS,CAKpB"}

package/lib/spectra/core/principalComponents.js

@@ -0,0 +1,90 @@
+/** The first two components, which is what a score plot opens on. */
+export const DEFAULT_PRINCIPAL_COMPONENTS = {
+    x: 0,
+    y: 1,
+};
+/** How `ml-pca` may be asked to decompose the matrix. */
+export const PCA_METHODS = [
+    { value: 'SVD', label: 'Singular value decomposition' },
+    { value: 'NIPALS', label: 'NIPALS' },
+    { value: 'covarianceMatrix', label: 'Covariance matrix' },
+];
+/**
+ * What one component is called, with the share of the variance it carries.
+ * @param index - The component, counting from zero.
+ * @param explainedVariance - What `pca.getExplainedVariance()` returned, as fractions.
+ * @returns For instance `PC1 — 74.2 %`, or just `PC1` when no variance is known.
+ */
+export function principalComponentLabel(index, explainedVariance) {
+    const name = `PC${String(index + 1)}`;
+    const share = explainedVariance?.[index];
+    if (share === undefined || !Number.isFinite(share))
+        return name;
+    return `${name} — ${(share * 100).toFixed(1)} %`;
+}
+/**
+ * Every component that can be picked, in order.
+ *
+ * A component nobody can read is worse than none, so the share of the variance
+ * travels with the label: a reader picking `PC7 — 0.3 %` can see they are about
+ * to plot noise.
+ * @param count - How many components the decomposition produced.
+ * @param explainedVariance - What `pca.getExplainedVariance()` returned.
+ * @returns The choices, one per component.
+ */
+export function principalComponentChoices(count, explainedVariance) {
+    const choices = [];
+    for (let index = 0; index < count; index++) {
+        choices.push({
+            index,
+            label: principalComponentLabel(index, explainedVariance),
+        });
+    }
+    return choices;
+}
+/**
+ * The selection made safe against the decomposition that actually came back.
+ *
+ * A saved selection outlives the data it was made on: reload with fewer spectra
+ * and `PC8` no longer exists. Rather than let a plot ask for a column that is
+ * not there, the pair is pulled back inside what was computed, and the two axes
+ * are kept apart so the plot never collapses onto its diagonal.
+ * @param selection - What the reader picked, possibly on other data.
+ * @param count - How many components the decomposition produced.
+ * @returns A selection both of whose components exist.
+ */
+export function clampPrincipalComponents(selection, count) {
+    if (count < 1)
+        return { x: 0, y: 0 };
+    const last = count - 1;
+    const x = clamp(selection.x, last);
+    let y = clamp(selection.y, last);
+    if (y === x && count > 1)
+        y = x === 0 ? 1 : x - 1;
+    return { x, y };
+}
+/**
+ * The share of the variance the two picked components carry together.
+ * @param selection - Which components are drawn.
+ * @param explainedVariance - What `pca.getExplainedVariance()` returned.
+ * @returns The sum as a fraction, or undefined when either share is unknown.
+ */
+export function selectedExplainedVariance(selection, explainedVariance) {
+    const along = explainedVariance[selection.x];
+    const up = explainedVariance[selection.y];
+    if (along === undefined || up === undefined)
+        return undefined;
+    return along + up;
+}
+/**
+ * A component index brought inside the components that exist.
+ * @param index - What was asked for.
+ * @param last - The highest component there is.
+ * @returns A whole number between zero and `last`.
+ */
+function clamp(index, last) {
+    if (!Number.isFinite(index))
+        return 0;
+    return Math.min(Math.max(Math.round(index), 0), last);
+}
+//# sourceMappingURL=principalComponents.js.map

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

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

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

@@ -0,0 +1,57 @@
+/** How much a problem matters. */
+export type ProblemSeverity = 'error' | 'warning';
+/** Something the settings get wrong, or probably get wrong. */
+export interface SettingsProblem {
+    /**
+     * `error` when the processor throws or the matrix comes out wrong;
+     * `warning` when it runs and the reader most likely did not mean it.
+     */
+    severity: ProblemSeverity;
+    /** Which part of the settings it is about, as the panel labels that part. */
+    where: string;
+    /** What is wrong, in one sentence a reader can act on. */
+    message: string;
+}
+/**
+ * A problem, spelled out.
+ * @param severity - How much it matters.
+ * @param where - Which part of the settings it is about.
+ * @param message - What is wrong.
+ * @returns The problem.
+ */
+export declare function problem(severity: ProblemSeverity, where: string, message: string): SettingsProblem;
+/**
+ * Whether a value is a number the processor can work with.
+ * @param value - What the settings hold.
+ * @returns True when it is a finite number.
+ */
+export declare function isNumber(value: unknown): value is number;
+/**
+ * Whether a value is a whole number.
+ * @param value - What the settings hold.
+ * @returns True when it is a finite integer.
+ */
+export declare function isWholeNumber(value: unknown): value is number;
+/**
+ * Whether a label can stand as the name of a variable.
+ *
+ * A range's label becomes a parameter of the function the calculations are
+ * compiled into, so a label with a space in it fails far from the field that
+ * caused it — which is why it is checked here instead.
+ * @param label - What the reader typed.
+ * @returns True when the label can be a variable name.
+ */
+export declare function isUsableLabel(label: string): boolean;
+/**
+ * What is wrong with an expression, as far as can be told without running it.
+ *
+ * The expression is compiled by the processor, not here, so this catches what
+ * a reader actually mistypes — an empty box, unclosed brackets, a variable that
+ * never appears — and stays silent about the rest rather than pretending to be
+ * a parser.
+ * @param formula - What the reader typed.
+ * @param variable - The one name the expression may read, `x` or `y`.
+ * @returns The complaint, or undefined when nothing obvious is wrong.
+ */
+export declare function formulaProblem(formula: string, variable: string): string | undefined;
+//# sourceMappingURL=problems.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"problems.d.ts","sourceRoot":"","sources":["../../../src/spectra/core/problems.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,CAAC;AAElD,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,EAAE,eAAe,CAAC;IAC1B,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,eAAe,CAEjB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAcpB"}

package/lib/spectra/core/problems.js

@@ -0,0 +1,121 @@
+/**
+ * A problem, spelled out.
+ * @param severity - How much it matters.
+ * @param where - Which part of the settings it is about.
+ * @param message - What is wrong.
+ * @returns The problem.
+ */
+export function problem(severity, where, message) {
+    return { severity, where, message };
+}
+/**
+ * Whether a value is a number the processor can work with.
+ * @param value - What the settings hold.
+ * @returns True when it is a finite number.
+ */
+export function isNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value);
+}
+/**
+ * Whether a value is a whole number.
+ * @param value - What the settings hold.
+ * @returns True when it is a finite integer.
+ */
+export function isWholeNumber(value) {
+    return isNumber(value) && Number.isInteger(value);
+}
+/**
+ * Whether a label can stand as the name of a variable.
+ *
+ * A range's label becomes a parameter of the function the calculations are
+ * compiled into, so a label with a space in it fails far from the field that
+ * caused it — which is why it is checked here instead.
+ * @param label - What the reader typed.
+ * @returns True when the label can be a variable name.
+ */
+export function isUsableLabel(label) {
+    return /^[A-Za-z_$][\w$]*$/.test(label) && !RESERVED_WORDS.has(label);
+}
+/**
+ * What is wrong with an expression, as far as can be told without running it.
+ *
+ * The expression is compiled by the processor, not here, so this catches what
+ * a reader actually mistypes — an empty box, unclosed brackets, a variable that
+ * never appears — and stays silent about the rest rather than pretending to be
+ * a parser.
+ * @param formula - What the reader typed.
+ * @param variable - The one name the expression may read, `x` or `y`.
+ * @returns The complaint, or undefined when nothing obvious is wrong.
+ */
+export function formulaProblem(formula, variable) {
+    const trimmed = formula.trim();
+    if (trimmed === '')
+        return 'The expression is empty.';
+    if (!new RegExp(String.raw `\b${variable}\b`).test(trimmed)) {
+        return `The expression never reads ${variable}, so every point would get the same value.`;
+    }
+    let depth = 0;
+    for (const character of trimmed) {
+        if (character === '(')
+            depth++;
+        if (character === ')')
+            depth--;
+        if (depth < 0)
+            return 'A closing bracket has nothing to close.';
+    }
+    if (depth > 0)
+        return 'A bracket is left open.';
+    return undefined;
+}
+/** The names a range may not take, because a function cannot be given them. */
+const RESERVED_WORDS = new Set([
+    'arguments',
+    'await',
+    'break',
+    'case',
+    'catch',
+    'class',
+    'const',
+    'continue',
+    'debugger',
+    'default',
+    'delete',
+    'do',
+    'else',
+    'enum',
+    'eval',
+    'export',
+    'extends',
+    'false',
+    'finally',
+    'for',
+    'function',
+    'if',
+    'implements',
+    'import',
+    'in',
+    'instanceof',
+    'interface',
+    'let',
+    'new',
+    'null',
+    'package',
+    'private',
+    'protected',
+    'public',
+    'return',
+    'static',
+    'super',
+    'switch',
+    'this',
+    'throw',
+    'true',
+    'try',
+    'typeof',
+    'var',
+    'void',
+    'while',
+    'with',
+    'yield',
+]);
+//# sourceMappingURL=problems.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"problems.js","sourceRoot":"","sources":["../../../src/spectra/core/problems.ts"],"names":[],"mappings":"AAgBA;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CACrB,QAAyB,EACzB,KAAa,EACb,OAAe;IAEf,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,QAAgB;IAEhB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,0BAA0B,CAAC;IACtD,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3D,OAAO,8BAA8B,QAAQ,4CAA4C,CAAC;IAC5F,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;QAChC,IAAI,SAAS,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;QAC/B,IAAI,SAAS,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;QAC/B,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,yCAAyC,CAAC;IAClE,CAAC;IACD,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,yBAAyB,CAAC;IAChD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,+EAA+E;AAC/E,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IAClD,WAAW;IACX,OAAO;IACP,OAAO;IACP,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IACP,UAAU;IACV,UAAU;IACV,SAAS;IACT,QAAQ;IACR,IAAI;IACJ,MAAM;IACN,MAAM;IACN,MAAM;IACN,QAAQ;IACR,SAAS;IACT,OAAO;IACP,SAAS;IACT,KAAK;IACL,UAAU;IACV,IAAI;IACJ,YAAY;IACZ,QAAQ;IACR,IAAI;IACJ,YAAY;IACZ,WAAW;IACX,KAAK;IACL,KAAK;IACL,MAAM;IACN,SAAS;IACT,SAAS;IACT,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,MAAM;IACN,OAAO;IACP,MAAM;IACN,KAAK;IACL,QAAQ;IACR,KAAK;IACL,MAAM;IACN,OAAO;IACP,MAAM;IACN,OAAO;CACR,CAAC,CAAC"}

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

@@ -0,0 +1,67 @@
+import type { FilterXYType } from 'ml-signal-processing';
+import type { SpectraProcessor } from 'spectra-processor';
+/** Everything `new SpectraProcessor(…)` is built with. */
+export type SpectraProcessorSettings = NonNullable<ConstructorParameters<typeof SpectraProcessor>[0]>;
+/**
+ * How every spectrum is brought onto one x grid. Until this is settled no two
+ * spectra can be compared, which is why it is the first thing the editor asks.
+ */
+export type NormalizationSettings = NonNullable<SpectraProcessorSettings['normalization']>;
+/** A stretch of x the resampling grid skips. */
+export type ExclusionZone = NonNullable<NormalizationSettings['exclusions']>[number];
+/** What `getPostProcessedData` reads, once every spectrum shares one grid. */
+export type PostProcessingSettings = NonNullable<Parameters<SpectraProcessor['getPostProcessedData']>[0]>;
+/** How every spectrum is scaled onto a reference one. */
+export type ScaleSettings = NonNullable<PostProcessingSettings['scale']>;
+/** A named stretch of x whose integral is reported per spectrum. */
+export type SpectraRange = NonNullable<PostProcessingSettings['ranges']>[number];
+/** A formula over the range integrals, reported per spectrum. */
+export type SpectraCalculation = NonNullable<PostProcessingSettings['calculations']>[number];
+/** One step of the matrix stage, which works across spectra rather than along one. */
+export type MatrixFilter = NonNullable<PostProcessingSettings['filters']>[number];
+/**
+ * One step of the per-spectrum chain.
+ *
+ * `spectra-processor` types the same array as `{ name: string }`, which accepts
+ * names `filterXY` throws on. The editor holds the union `filterXY` actually
+ * dispatches, so a chain that type-checks is a chain that runs.
+ */
+export type SpectrumFilter = FilterXYType;
+/** The name of a chain step — the 23 `filterXY` knows. */
+export type SpectrumFilterName = FilterXYType['name'];
+/** The three names `getPostProcessedData`'s own switch matches. */
+export type MatrixFilterName = 'centerMean' | 'pqn' | 'rescale';
+/** The four scalings `getPostProcessedData` matches, lower-cased. */
+export type ScaleMethod = 'integration' | 'max' | 'min' | 'minmax';
+/** Both settings objects the processor takes, which are independent of each other. */
+export interface SpectraSettings {
+    /** What the constructor is handed. */
+    processor: SpectraProcessorSettings;
+    /** What `getPostProcessedData` is handed. */
+    postProcessing: PostProcessingSettings;
+}
+/** The bytes of original data kept before the processor starts discarding it. */
+export declare const DEFAULT_MAX_MEMORY: number;
+/** Points the injected resampling lands on when the settings name no number. */
+export declare const DEFAULT_NUMBER_OF_POINTS = 1024;
+/** Nothing set: the processor's own defaults, spelled out so a reset is one value. */
+export declare const EMPTY_SETTINGS: SpectraSettings;
+/**
+ * The chain as the editor understands it.
+ *
+ * The single cast in the package. Upstream types the array as
+ * `{ name: string; options?: any }[]` while its own `getNormalized` types the
+ * very same array as `FilterXYType[]`; this reads it back at the narrower type
+ * its consumer already assumes.
+ * @param settings - What the constructor would be handed.
+ * @returns The chain steps, in the order they run.
+ */
+export declare function normalizationFilters(settings: SpectraProcessorSettings): readonly SpectrumFilter[];
+/**
+ * The same settings with a different chain, leaving every other field alone.
+ * @param settings - What the constructor would be handed.
+ * @param filters - The chain to put in its place.
+ * @returns A new settings object.
+ */
+export declare function withNormalizationFilters(settings: SpectraProcessorSettings, filters: readonly SpectrumFilter[]): SpectraProcessorSettings;
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../src/spectra/core/settings.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,0DAA0D;AAC1D,MAAM,MAAM,wBAAwB,GAAG,WAAW,CAChD,qBAAqB,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAClD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAC7C,wBAAwB,CAAC,eAAe,CAAC,CAC1C,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG,WAAW,CACrC,qBAAqB,CAAC,YAAY,CAAC,CACpC,CAAC,MAAM,CAAC,CAAC;AAEV,8EAA8E;AAC9E,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAC9C,UAAU,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,CACxD,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;AAEzE,oEAAoE;AACpE,MAAM,MAAM,YAAY,GAAG,WAAW,CACpC,sBAAsB,CAAC,QAAQ,CAAC,CACjC,CAAC,MAAM,CAAC,CAAC;AAEV,iEAAiE;AACjE,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAC1C,sBAAsB,CAAC,cAAc,CAAC,CACvC,CAAC,MAAM,CAAC,CAAC;AAEV,sFAAsF;AACtF,MAAM,MAAM,YAAY,GAAG,WAAW,CACpC,sBAAsB,CAAC,SAAS,CAAC,CAClC,CAAC,MAAM,CAAC,CAAC;AAEV;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC;AAE1C,0DAA0D;AAC1D,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAEtD,mEAAmE;AACnE,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,KAAK,GAAG,SAAS,CAAC;AAEhE,qEAAqE;AACrE,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEnE,sFAAsF;AACtF,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,SAAS,EAAE,wBAAwB,CAAC;IACpC,6CAA6C;IAC7C,cAAc,EAAE,sBAAsB,CAAC;CACxC;AAED,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,QAAoB,CAAC;AAEpD,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,sFAAsF;AACtF,eAAO,MAAM,cAAc,EAAE,eAG5B,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,wBAAwB,GACjC,SAAS,cAAc,EAAE,CAE3B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,SAAS,cAAc,EAAE,GACjC,wBAAwB,CAK1B"}

package/lib/spectra/core/settings.js

@@ -0,0 +1,35 @@
+/** The bytes of original data kept before the processor starts discarding it. */
+export const DEFAULT_MAX_MEMORY = 256 * 1024 * 1024;
+/** Points the injected resampling lands on when the settings name no number. */
+export const DEFAULT_NUMBER_OF_POINTS = 1024;
+/** Nothing set: the processor's own defaults, spelled out so a reset is one value. */
+export const EMPTY_SETTINGS = {
+    processor: { normalization: {} },
+    postProcessing: {},
+};
+/**
+ * The chain as the editor understands it.
+ *
+ * The single cast in the package. Upstream types the array as
+ * `{ name: string; options?: any }[]` while its own `getNormalized` types the
+ * very same array as `FilterXYType[]`; this reads it back at the narrower type
+ * its consumer already assumes.
+ * @param settings - What the constructor would be handed.
+ * @returns The chain steps, in the order they run.
+ */
+export function normalizationFilters(settings) {
+    return (settings.normalization?.filters ?? []);
+}
+/**
+ * The same settings with a different chain, leaving every other field alone.
+ * @param settings - What the constructor would be handed.
+ * @param filters - The chain to put in its place.
+ * @returns A new settings object.
+ */
+export function withNormalizationFilters(settings, filters) {
+    return {
+        ...settings,
+        normalization: { ...settings.normalization, filters: [...filters] },
+    };
+}
+//# sourceMappingURL=settings.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../../src/spectra/core/settings.ts"],"names":[],"mappings":"AA4EA,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpD,gFAAgF;AAChF,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,sFAAsF;AACtF,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,SAAS,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE;IAChC,cAAc,EAAE,EAAE;CACnB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAkC;IAElC,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,IAAI,EAAE,CAA8B,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAkC,EAClC,OAAkC;IAElC,OAAO;QACL,GAAG,QAAQ;QACX,aAAa,EAAE,EAAE,GAAG,QAAQ,CAAC,aAAa,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE;KACpE,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { SettingsProblem } from './problems.ts';
+import type { MatrixFilterName, ScaleMethod, SpectraSettings } from './settings.ts';
+/** The only three names `getPostProcessedData` matches; anything else throws. */
+export declare const MATRIX_FILTER_NAMES: readonly MatrixFilterName[];
+/** The only four scalings it matches, which it lower-cases before comparing. */
+export declare const SCALE_METHODS: readonly ScaleMethod[];
+/**
+ * Everything wrong, or probably wrong, with a whole settings object.
+ *
+ * Nothing here blocks: the editor is not a gate, and a reader mid-thought is
+ * allowed to hold settings that would throw. What it does is name the value the
+ * processor will fail on before the reader hands it over and reads a stack
+ * trace instead.
+ * @param settings - Both objects the processor would be handed.
+ * @returns Every problem found, errors and advice together.
+ */
+export declare function settingsProblems(settings: SpectraSettings): SettingsProblem[];
+//# sourceMappingURL=settingsProblems.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settingsProblems.d.ts","sourceRoot":"","sources":["../../../src/spectra/core/settingsProblems.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,eAAe,EAChB,MAAM,eAAe,CAAC;AAGvB,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAI1D,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAK/C,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,EAAE,CA+C7E"}