react-cheminfo 0.9.0 → 0.10.0

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

@@ -0,0 +1,136 @@
+import type { FilterField, FilterGroup } from './filterFields.ts';
+/** What the editor knows about one chain step. */
+export interface FilterCatalogEntry {
+    /** What the step is called. */
+    label: string;
+    /** Which part of the signal it works on. */
+    group: FilterGroup;
+    /** One sentence on what it does to the data. */
+    summary: string;
+    /** Its editable options, in the order they are drawn. */
+    fields: readonly FilterField[];
+    /**
+     * The parameters upstream fixes and does not forward, so a reader is told
+     * there are no knobs rather than left hunting for them.
+     * @default undefined — every parameter of the step is editable
+     */
+    fixed?: string;
+    /**
+     * The way the step is most often got wrong.
+     * @default undefined — the step holds no trap
+     */
+    caution?: string;
+}
+/** The x bounds every cropping and resampling step asks for. */
+export declare const RANGE_FIELDS: readonly FilterField[];
+/** The two zone lists a step offers when it can keep or drop stretches of x. */
+export declare const ZONE_FIELDS: readonly FilterField[];
+/** The five baseline estimates, none of which forwards a parameter. */
+export declare const BASELINE_ENTRIES: {
+    readonly airPLSBaseline: {
+        readonly label: "airPLS baseline";
+        readonly group: "baseline";
+        readonly summary: "Subtracts an asymmetrically weighted penalized least-squares baseline — the general-purpose choice for a broad drift.";
+        readonly fields: readonly [];
+        readonly fixed: "Fitted against the point index, 100 iterations, tolerance 0.001.";
+    };
+    readonly iterativePolynomialBaseline: {
+        readonly label: "Iterative polynomial baseline";
+        readonly group: "baseline";
+        readonly summary: "Fits a polynomial to the signal, iterating until the peaks stop pulling it up.";
+        readonly fields: readonly [];
+        readonly fixed: "Fitted against the point index, 100 iterations, tolerance 0.001.";
+    };
+    readonly rollingAverageBaseline: {
+        readonly label: "Rolling-average baseline";
+        readonly group: "baseline";
+        readonly summary: "Subtracts a rolling mean. Cheap, and it eats into a broad peak.";
+        readonly fields: readonly [];
+        readonly fixed: "Window of a tenth of the points, duplicated at the edges.";
+    };
+    readonly rollingBallBaseline: {
+        readonly label: "Rolling-ball baseline";
+        readonly group: "baseline";
+        readonly summary: "Rolls a ball under the signal — the robust choice when peaks overlap.";
+        readonly fields: readonly [];
+        readonly fixed: "Windows of 4 % and 8 % of the points.";
+    };
+    readonly rollingMedianBaseline: {
+        readonly label: "Rolling-median baseline";
+        readonly group: "baseline";
+        readonly summary: "Subtracts a rolling median, which a peak pulls on far less than a mean.";
+        readonly fields: readonly [];
+        readonly fixed: "Window of a tenth of the points, duplicated at the edges.";
+    };
+};
+/** Smoothing, the derivatives, and everything that changes the y scale. */
+export declare const SIGNAL_ENTRIES: {
+    readonly savitzkyGolay: {
+        readonly label: "Savitzky–Golay smoothing";
+        readonly group: "smoothing";
+        readonly summary: "Fits a polynomial over a sliding window; with a derivative above zero it is the general form of the three below.";
+        readonly fields: readonly [...FilterField[], FilterField];
+    };
+    readonly firstDerivative: {
+        readonly label: "First derivative";
+        readonly group: "smoothing";
+        readonly summary: "dy/dx by Savitzky–Golay. Removes an additive baseline and turns every peak into a zero crossing.";
+        readonly fields: readonly FilterField[];
+    };
+    readonly secondDerivative: {
+        readonly label: "Second derivative";
+        readonly group: "smoothing";
+        readonly summary: "d²y/dx² by Savitzky–Golay — the classic way to pull apart overlapping infrared bands.";
+        readonly fields: readonly FilterField[];
+    };
+    readonly thirdDerivative: {
+        readonly label: "Third derivative";
+        readonly group: "smoothing";
+        readonly summary: "d³y/dx³ by Savitzky–Golay. Rarely worth it: noise dominates.";
+        readonly fields: readonly FilterField[];
+    };
+    readonly centerMean: {
+        readonly label: "Centre on the mean";
+        readonly group: "scaling";
+        readonly summary: "Subtracts the mean of y, so the spectrum sits about zero.";
+        readonly fields: readonly [];
+    };
+    readonly centerMedian: {
+        readonly label: "Centre on the median";
+        readonly group: "scaling";
+        readonly summary: "Subtracts the median of y — the same idea, unmoved by a few large peaks.";
+        readonly fields: readonly [];
+    };
+    readonly divideBySD: {
+        readonly label: "Divide by the standard deviation";
+        readonly group: "scaling";
+        readonly summary: "Divides y by its standard deviation; after centring on the mean this is autoscaling.";
+        readonly fields: readonly [];
+    };
+    readonly paretoNormalization: {
+        readonly label: "Pareto scaling";
+        readonly group: "scaling";
+        readonly summary: "Divides y by the square root of its standard deviation, so magnitude survives and noise is amplified less than by autoscaling.";
+        readonly fields: readonly [];
+    };
+    readonly normed: {
+        readonly label: "Normalize";
+        readonly group: "scaling";
+        readonly summary: "Divides y so that a chosen aggregate reaches the value asked for.";
+        readonly fields: readonly [FilterField, FilterField];
+    };
+    readonly rescale: {
+        readonly label: "Rescale between two values";
+        readonly group: "scaling";
+        readonly summary: "Maps y linearly onto the range given.";
+        readonly fields: readonly [FilterField, FilterField];
+    };
+    readonly yFunction: {
+        readonly label: "Apply a formula to y";
+        readonly group: "y-axis";
+        readonly summary: "Rewrites every y through an expression. A run of lowercase letters is read as a Math function, so `log10(y)` works as typed.";
+        readonly fields: readonly [FilterField];
+    };
+};
+/** Everything that moves, crops or resamples the x axis, and the two housekeeping steps. */
+//# sourceMappingURL=filterEntries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filterEntries.d.ts","sourceRoot":"","sources":["../../../src/spectra/core/filterEntries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AASlE,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,EAAE,WAAW,CAAC;IACnB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAiBD,gEAAgE;AAChE,eAAO,MAAM,YAAY,EAAE,SAAS,WAAW,EAG9C,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,WAAW,EAAE,SAAS,WAAW,EAO7C,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC0B,CAAC;AAExD,2EAA2E;AAC3E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwG4B,CAAC;AAExD,4FAA4F"}

package/lib/spectra/core/filterEntries.js

@@ -0,0 +1,139 @@
+import { enumField, formulaField, integerField, numberField, zonesField, } from "./filterFields.js";
+const SG_FIELDS = [
+    integerField('windowSize', 'Window size', '9', 'An odd number of points, 5 or more.'),
+    integerField('polynomial', 'Polynomial degree', '3', 'Below the window size; 6 and above oscillates.'),
+];
+/** The x bounds every cropping and resampling step asks for. */
+export const RANGE_FIELDS = [
+    numberField('from', 'From (x)', 'the first x'),
+    numberField('to', 'To (x)', 'the last x'),
+];
+/** The two zone lists a step offers when it can keep or drop stretches of x. */
+export const ZONE_FIELDS = [
+    zonesField('zones', 'Zones to keep'),
+    zonesField('exclusions', 'Zones to drop', 'Dropping wins: name zones or exclusions, not both.'),
+];
+/** The five baseline estimates, none of which forwards a parameter. */
+export const BASELINE_ENTRIES = {
+    airPLSBaseline: {
+        label: 'airPLS baseline',
+        group: 'baseline',
+        summary: 'Subtracts an asymmetrically weighted penalized least-squares baseline — the general-purpose choice for a broad drift.',
+        fields: [],
+        fixed: 'Fitted against the point index, 100 iterations, tolerance 0.001.',
+    },
+    iterativePolynomialBaseline: {
+        label: 'Iterative polynomial baseline',
+        group: 'baseline',
+        summary: 'Fits a polynomial to the signal, iterating until the peaks stop pulling it up.',
+        fields: [],
+        fixed: 'Fitted against the point index, 100 iterations, tolerance 0.001.',
+    },
+    rollingAverageBaseline: {
+        label: 'Rolling-average baseline',
+        group: 'baseline',
+        summary: 'Subtracts a rolling mean. Cheap, and it eats into a broad peak.',
+        fields: [],
+        fixed: 'Window of a tenth of the points, duplicated at the edges.',
+    },
+    rollingBallBaseline: {
+        label: 'Rolling-ball baseline',
+        group: 'baseline',
+        summary: 'Rolls a ball under the signal — the robust choice when peaks overlap.',
+        fields: [],
+        fixed: 'Windows of 4 % and 8 % of the points.',
+    },
+    rollingMedianBaseline: {
+        label: 'Rolling-median baseline',
+        group: 'baseline',
+        summary: 'Subtracts a rolling median, which a peak pulls on far less than a mean.',
+        fields: [],
+        fixed: 'Window of a tenth of the points, duplicated at the edges.',
+    },
+};
+/** Smoothing, the derivatives, and everything that changes the y scale. */
+export const SIGNAL_ENTRIES = {
+    savitzkyGolay: {
+        label: 'Savitzky–Golay smoothing',
+        group: 'smoothing',
+        summary: 'Fits a polynomial over a sliding window; with a derivative above zero it is the general form of the three below.',
+        fields: [
+            ...SG_FIELDS,
+            integerField('derivative', 'Derivative', '0', 'Zero smooths; one, two and three differentiate.'),
+        ],
+    },
+    firstDerivative: {
+        label: 'First derivative',
+        group: 'smoothing',
+        summary: 'dy/dx by Savitzky–Golay. Removes an additive baseline and turns every peak into a zero crossing.',
+        fields: SG_FIELDS,
+    },
+    secondDerivative: {
+        label: 'Second derivative',
+        group: 'smoothing',
+        summary: 'd²y/dx² by Savitzky–Golay — the classic way to pull apart overlapping infrared bands.',
+        fields: SG_FIELDS,
+    },
+    thirdDerivative: {
+        label: 'Third derivative',
+        group: 'smoothing',
+        summary: 'd³y/dx³ by Savitzky–Golay. Rarely worth it: noise dominates.',
+        fields: SG_FIELDS,
+    },
+    centerMean: {
+        label: 'Centre on the mean',
+        group: 'scaling',
+        summary: 'Subtracts the mean of y, so the spectrum sits about zero.',
+        fields: [],
+    },
+    centerMedian: {
+        label: 'Centre on the median',
+        group: 'scaling',
+        summary: 'Subtracts the median of y — the same idea, unmoved by a few large peaks.',
+        fields: [],
+    },
+    divideBySD: {
+        label: 'Divide by the standard deviation',
+        group: 'scaling',
+        summary: 'Divides y by its standard deviation; after centring on the mean this is autoscaling.',
+        fields: [],
+    },
+    paretoNormalization: {
+        label: 'Pareto scaling',
+        group: 'scaling',
+        summary: 'Divides y by the square root of its standard deviation, so magnitude survives and noise is amplified less than by autoscaling.',
+        fields: [],
+    },
+    normed: {
+        label: 'Normalize',
+        group: 'scaling',
+        summary: 'Divides y so that a chosen aggregate reaches the value asked for.',
+        fields: [
+            enumField('algorithm', 'Divide by', [
+                { value: 'absolute', label: 'Sum of absolute values' },
+                { value: 'max', label: 'Largest value' },
+                { value: 'sum', label: 'Signed sum' },
+            ], 'Largest value with 100 is the familiar “normalize to 100 %”.'),
+            numberField('value', 'Target', '1'),
+        ],
+    },
+    rescale: {
+        label: 'Rescale between two values',
+        group: 'scaling',
+        summary: 'Maps y linearly onto the range given.',
+        fields: [
+            numberField('min', 'Minimum', '0'),
+            numberField('max', 'Maximum', '1'),
+        ],
+    },
+    yFunction: {
+        label: 'Apply a formula to y',
+        group: 'y-axis',
+        summary: 'Rewrites every y through an expression. A run of lowercase letters is read as a Math function, so `log10(y)` works as typed.',
+        fields: [
+            formulaField('function', 'Expression in y', 'For instance -log10(y), which reads transmittance as absorbance.'),
+        ],
+    },
+};
+/** Everything that moves, crops or resamples the x axis, and the two housekeeping steps. */
+//# sourceMappingURL=filterEntries.js.map

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

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

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

@@ -0,0 +1,94 @@
+/** What a chain step's option is edited with. */
+export type FilterFieldKind = 'boolean' | 'enum' | 'formula' | 'integer' | 'number' | 'zones';
+/** One choice of an `enum` field. */
+export interface FilterChoice {
+    /** What goes into the options object. */
+    value: string;
+    /** What the reader picks. */
+    label: string;
+}
+/** One editable option of a chain step. */
+export interface FilterField {
+    /**
+     * Where the value sits inside the step's `options`, dotted for a nested one
+     * such as `gsd.minMaxRatio`.
+     */
+    key: string;
+    /** What the field is called. */
+    label: string;
+    /** What it is edited with. */
+    kind: FilterFieldKind;
+    /**
+     * What upstream does when the field is left empty, shown in the control.
+     * @default undefined — the control carries no placeholder
+     */
+    placeholder?: string;
+    /**
+     * The choices, for an `enum` field.
+     * @default undefined — the field is not an enum
+     */
+    choices?: readonly FilterChoice[];
+    /**
+     * One line saying what the option changes, hung off the label.
+     * @default undefined — the label says enough
+     */
+    help?: string;
+}
+/** Which part of the signal a step works on, and so where it belongs in the menu. */
+export type FilterGroup = 'baseline' | 'scaling' | 'smoothing' | 'utility' | 'x-axis' | 'y-axis';
+/** The groups in the order a chain is usually built: shape, then scale, then axis. */
+export declare const FILTER_GROUPS: readonly FilterGroup[];
+/** What each group is called above its slice of the menu. */
+export declare const FILTER_GROUP_LABELS: Readonly<Record<FilterGroup, string>>;
+/**
+ * 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 declare function integerField(key: string, label: string, placeholder?: string, help?: string): FilterField;
+/**
+ * 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 declare function numberField(key: string, label: string, placeholder?: string, help?: string): FilterField;
+/**
+ * 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 declare function enumField(key: string, label: string, choices: readonly FilterChoice[], help?: string): FilterField;
+/**
+ * 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 declare function booleanField(key: string, label: string, help?: string): FilterField;
+/**
+ * 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 declare function formulaField(key: string, label: string, help?: string): FilterField;
+/**
+ * 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 declare function zonesField(key: string, label: string, help?: string): FilterField;
+//# sourceMappingURL=filterFields.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filterFields.d.ts","sourceRoot":"","sources":["../../../src/spectra/core/filterFields.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,MAAM,eAAe,GACzB,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElE,qCAAqC;AACrC,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,IAAI,EAAE,eAAe,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAClC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qFAAqF;AACrF,MAAM,MAAM,WAAW,GACrB,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzE,sFAAsF;AACtF,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAO/C,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAOrE,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,MAAM,GACZ,WAAW,CAEb;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,MAAM,GACZ,WAAW,CAEb;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,IAAI,CAAC,EAAE,MAAM,GACZ,WAAW,CAEb;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,WAAW,CAEb;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,WAAW,CAEb;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,WAAW,CAEb"}

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"}