react-cheminfo 0.28.0 → 0.30.0

package/lib/ir/core/pickBands.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Finding the bands in a spectrum, which `ir-spectrum` does.
+ *
+ * Everything here is the two things that call needs and does not have: a
+ * `MeasurementXY` built out of the arrays the viewer holds, and the decision to
+ * pick on **absorbance** rather than on transmittance. That second one is the
+ * only judgement in the file and it is not a preference — peak picking finds
+ * maxima, and a band is a maximum in absorbance but a *minimum* in transmittance,
+ * so picking on transmittance would return the flat baseline between the bands
+ * and miss every band there is.
+ */
+import type { IrBand } from './irBand.ts';
+import type { IrSpectrum } from './irSpectrum.ts';
+/** How the bands are picked. */
+export interface PickBandsOptions {
+    /**
+     * Lowest wavenumber to pick in, in cm⁻¹.
+     * @default the start of the spectrum
+     */
+    from?: number;
+    /**
+     * Highest wavenumber to pick in, in cm⁻¹.
+     * @default the end of the spectrum
+     */
+    to?: number;
+    /**
+     * How tall a band must be against the tallest one to count, as a fraction.
+     *
+     * Two percent by default, which on a real ATR spectrum is a little above the
+     * noise and a long way below any band worth naming. Lowered, the fingerprint
+     * region fills with shoulders that have no assignment; raised past about a
+     * tenth, weak but diagnostic bands — a nitrile, an alkyne — stop being found.
+     * @default 0.02
+     */
+    minRelativeHeight?: number;
+    /**
+     * Narrowest band to keep, in cm⁻¹.
+     *
+     * A spike one point wide is a detector glitch rather than a vibration: real
+     * infrared bands are several wavenumbers across even at their sharpest.
+     * @default 4
+     */
+    minPeakWidth?: number;
+    /**
+     * At most how many bands to keep, the strongest first.
+     * @default every band found
+     */
+    limit?: number;
+}
+/**
+ * Pick the bands of one spectrum.
+ *
+ * The bands come back in ascending wavenumber, which is the order a spectrum is
+ * read in rather than the order they were found — `limit` cuts by height, and
+ * then what survives is put back in axis order, so a table of them reads like
+ * the chart.
+ *
+ * **A band centre is a sampled point, not an interpolated one.** `ir-spectrum`
+ * reports each picked band at the wavenumber of the sample it peaked on, so on a
+ * bench instrument's 4 cm⁻¹ grid a carbonyl centred at 1710 is reported at 1708
+ * or 1712. That is within the tolerance the assignment table is matched with, and
+ * refining it here would mean re-deriving a peak position this package has
+ * deliberately delegated — but it is why a band should never be quoted as though
+ * it were measured to the wavenumber.
+ * @param spectrum - The spectrum to pick from.
+ * @param options - Where to pick, and what to keep.
+ * @returns The bands, ascending by wavenumber.
+ */
+export declare function pickBands(spectrum: IrSpectrum, options?: PickBandsOptions): IrBand[];
+//# sourceMappingURL=pickBands.d.ts.map

package/lib/ir/core/pickBands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickBands.d.ts","sourceRoot":"","sources":["../../../src/ir/core/pickBands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,gCAAgC;AAChC,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,UAAU,EACpB,OAAO,GAAE,gBAAqB,GAC7B,MAAM,EAAE,CAuCV"}

package/lib/ir/core/pickBands.js

@@ -0,0 +1,125 @@
+/**
+ * Finding the bands in a spectrum, which `ir-spectrum` does.
+ *
+ * Everything here is the two things that call needs and does not have: a
+ * `MeasurementXY` built out of the arrays the viewer holds, and the decision to
+ * pick on **absorbance** rather than on transmittance. That second one is the
+ * only judgement in the file and it is not a preference — peak picking finds
+ * maxima, and a band is a maximum in absorbance but a *minimum* in transmittance,
+ * so picking on transmittance would return the flat baseline between the bands
+ * and miss every band there is.
+ */
+import { autoPeakPicking } from 'ir-spectrum';
+import { xMaxValue, xMinValue } from 'ml-spectra-processing';
+/**
+ * Pick the bands of one spectrum.
+ *
+ * The bands come back in ascending wavenumber, which is the order a spectrum is
+ * read in rather than the order they were found — `limit` cuts by height, and
+ * then what survives is put back in axis order, so a table of them reads like
+ * the chart.
+ *
+ * **A band centre is a sampled point, not an interpolated one.** `ir-spectrum`
+ * reports each picked band at the wavenumber of the sample it peaked on, so on a
+ * bench instrument's 4 cm⁻¹ grid a carbonyl centred at 1710 is reported at 1708
+ * or 1712. That is within the tolerance the assignment table is matched with, and
+ * refining it here would mean re-deriving a peak position this package has
+ * deliberately delegated — but it is why a band should never be quoted as though
+ * it were measured to the wavenumber.
+ * @param spectrum - The spectrum to pick from.
+ * @param options - Where to pick, and what to keep.
+ * @returns The bands, ascending by wavenumber.
+ */
+export function pickBands(spectrum, options = {}) {
+    const { from, to, minRelativeHeight = 0.02, minPeakWidth = 4, limit, } = options;
+    if (spectrum.wavenumber.length < 2)
+        return [];
+    const picked = autoPeakPicking(measurementOf(spectrum), {
+        // Absorbance, because a band is a maximum there and a minimum in the other.
+        yVariable: 'a',
+        minMaxRatio: minRelativeHeight,
+        minPeakWidth,
+        ...(from === undefined ? {} : { from }),
+        ...(to === undefined ? {} : { to }),
+    });
+    const bands = [];
+    for (const peak of picked) {
+        if (!Number.isFinite(peak.wavenumber))
+            continue;
+        bands.push({
+            spectrumId: spectrum.id,
+            wavenumber: peak.wavenumber,
+            absorbance: peak.absorbance,
+            // `ConvertedPeak.transmittance` is a fraction where the spectrum's own
+            // transmittance is a percentage; brought onto the one scale here so that
+            // nothing downstream has to remember which of the two it is holding.
+            transmittance: peak.transmittance * 100,
+            strength: peak.kind,
+        });
+    }
+    const kept = limit === undefined || bands.length <= limit
+        ? bands
+        : bands.toSorted(byDescendingAbsorbance).slice(0, limit);
+    return kept.toSorted(byAscendingWavenumber);
+}
+/**
+ * The spectrum as `ir-spectrum` wants it.
+ *
+ * The `t` variable is given its extremes, because that is what the strength
+ * letter is worked out from: without them the conversion assumes a spectrum
+ * running the full 0 to 100 percent, and every band of a shallow ATR trace that
+ * never leaves the eighties comes back weak.
+ * @param spectrum - The spectrum the viewer holds.
+ * @returns A measurement carrying all three variables.
+ */
+function measurementOf(spectrum) {
+    const transmittance = {
+        label: 'Transmittance (%)',
+        units: '%',
+        symbol: 't',
+        data: spectrum.transmittance,
+        min: xMinValue(spectrum.transmittance),
+        max: xMaxValue(spectrum.transmittance),
+    };
+    return {
+        variables: {
+            x: {
+                label: 'Wavenumber',
+                units: '1/cm',
+                symbol: 'x',
+                data: spectrum.wavenumber,
+            },
+            // `y` is required of every measurement, and stands for whichever axis was
+            // recorded. Nothing here reads it — the picking is told to use `a` and the
+            // strength letter is read off `t` — so it carries the transmittance rather
+            // than a third copy of anything.
+            y: transmittance,
+            a: {
+                label: 'Absorbance',
+                units: '',
+                symbol: 'a',
+                data: spectrum.absorbance,
+            },
+            t: transmittance,
+        },
+    };
+}
+/**
+ * Order two bands by height, tallest first.
+ * @param first - One band.
+ * @param second - The other.
+ * @returns The comparison.
+ */
+function byDescendingAbsorbance(first, second) {
+    return second.absorbance - first.absorbance;
+}
+/**
+ * Order two bands along the axis, lowest wavenumber first.
+ * @param first - One band.
+ * @param second - The other.
+ * @returns The comparison.
+ */
+function byAscendingWavenumber(first, second) {
+    return first.wavenumber - second.wavenumber;
+}
+//# sourceMappingURL=pickBands.js.map

package/lib/ir/core/pickBands.js.map

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

package/lib/ir/core/spectrumJcamp.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Writing spectra back out as JCAMP-DX, so what was loaded can be taken away.
+ *
+ * JCAMP is the format to write rather than two columns of text because it says
+ * what its second column means: an infrared spectrum is read either as
+ * absorbance or as percent transmittance, the two are the same measurement
+ * turned inside out, and a bare column of numbers leaves whoever opens it next
+ * to guess which. `##YUNITS=` states it, and `ir-spectrum` reads it back and
+ * derives the other axis from it, so a spectrum written here returns carrying
+ * both.
+ *
+ * The points are written as an `##PEAK TABLE=` of explicit `x y` pairs rather
+ * than as a compressed `##XYDATA=` record. An XYDATA record states a first
+ * wavenumber and an increment and lets the reader rebuild the axis, which is
+ * exact only for an evenly sampled trace — and an interferogram transformed onto
+ * a wavenumber grid is evenly sampled only until somebody trims or splices it.
+ * Explicit pairs round trip whatever the spacing.
+ */
+import type { IrMode, IrSpectrum } from './irSpectrum.ts';
+/** The extension a written spectrum is saved under. */
+export declare const JCAMP_EXTENSION = ".jdx";
+/** What a JCAMP-DX file is served as. */
+export declare const JCAMP_MIME_TYPE = "chemical/x-jcamp-dx";
+/** How the technique is named when the file that was read named nothing. */
+export declare const DEFAULT_DATA_TYPE = "INFRARED SPECTRUM";
+/**
+ * Write one spectrum as a JCAMP-DX block.
+ *
+ * The axis written is the one the instrument recorded wherever the file said
+ * which that was, and only otherwise the one being read. Writing what is on
+ * screen instead would export a spectrum that had been through a logarithm it
+ * was never measured with — and, where a band bottoms out at zero transmittance,
+ * an absorbance of infinity that no reader can take back.
+ * @param spectrum - The spectrum.
+ * @param mode - The axis being read, used when the file named none.
+ * @returns The block, `##TITLE=` through `##END=`.
+ */
+export declare function irSpectrumToJcamp(spectrum: IrSpectrum, mode: IrMode): string;
+/**
+ * Write every spectrum of a list as one JCAMP-DX file.
+ *
+ * One file rather than one download per spectrum: a browser asked for six files
+ * in a row blocks all but the first, and a sample and its background are wanted
+ * back as the pair they were compared as. The blocks go inside a `LINK` block,
+ * which is what JCAMP has for a container and what the instruments that write a
+ * pair already use, so dropping the file back on the chart brings the whole list
+ * back.
+ *
+ * A list of one is written as that block alone: wrapping a single spectrum in a
+ * container gains nothing, and the file is then exactly what asking for that one
+ * spectrum would have written.
+ * @param spectra - The spectra, in the order the list holds them.
+ * @param mode - The axis being read, used for a spectrum whose file named none.
+ * @param title - What to call the file's own outer block.
+ * @returns The file.
+ */
+export declare function irSpectraToJcamp(spectra: readonly IrSpectrum[], mode: IrMode, title?: string): string;
+//# sourceMappingURL=spectrumJcamp.d.ts.map

package/lib/ir/core/spectrumJcamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spectrumJcamp.d.ts","sourceRoot":"","sources":["../../../src/ir/core/spectrumJcamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE1D,uDAAuD;AACvD,eAAO,MAAM,eAAe,SAAS,CAAC;AAEtC,yCAAyC;AACzC,eAAO,MAAM,eAAe,wBAAwB,CAAC;AAErD,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ5E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,SAAuC,GAC3C,MAAM,CAeR"}

package/lib/ir/core/spectrumJcamp.js

@@ -0,0 +1,156 @@
+/**
+ * Writing spectra back out as JCAMP-DX, so what was loaded can be taken away.
+ *
+ * JCAMP is the format to write rather than two columns of text because it says
+ * what its second column means: an infrared spectrum is read either as
+ * absorbance or as percent transmittance, the two are the same measurement
+ * turned inside out, and a bare column of numbers leaves whoever opens it next
+ * to guess which. `##YUNITS=` states it, and `ir-spectrum` reads it back and
+ * derives the other axis from it, so a spectrum written here returns carrying
+ * both.
+ *
+ * The points are written as an `##PEAK TABLE=` of explicit `x y` pairs rather
+ * than as a compressed `##XYDATA=` record. An XYDATA record states a first
+ * wavenumber and an increment and lets the reader rebuild the axis, which is
+ * exact only for an evenly sampled trace — and an interferogram transformed onto
+ * a wavenumber grid is evenly sampled only until somebody trims or splices it.
+ * Explicit pairs round trip whatever the spacing.
+ */
+import { fromJSON } from 'convert-to-jcamp';
+/** The extension a written spectrum is saved under. */
+export const JCAMP_EXTENSION = '.jdx';
+/** What a JCAMP-DX file is served as. */
+export const JCAMP_MIME_TYPE = 'chemical/x-jcamp-dx';
+/** How the technique is named when the file that was read named nothing. */
+export const DEFAULT_DATA_TYPE = 'INFRARED SPECTRUM';
+/**
+ * Write one spectrum as a JCAMP-DX block.
+ *
+ * The axis written is the one the instrument recorded wherever the file said
+ * which that was, and only otherwise the one being read. Writing what is on
+ * screen instead would export a spectrum that had been through a logarithm it
+ * was never measured with — and, where a band bottoms out at zero transmittance,
+ * an absorbance of infinity that no reader can take back.
+ * @param spectrum - The spectrum.
+ * @param mode - The axis being read, used when the file named none.
+ * @returns The block, `##TITLE=` through `##END=`.
+ */
+export function irSpectrumToJcamp(spectrum, mode) {
+    const written = spectrum.origin.recorded ?? mode;
+    const values = written === 'absorbance' ? spectrum.absorbance : spectrum.transmittance;
+    return fromJSON({ x: spectrum.wavenumber, y: values }, { info: infoRecords(spectrum, written), meta: metaRecords(spectrum) });
+}
+/**
+ * Write every spectrum of a list as one JCAMP-DX file.
+ *
+ * One file rather than one download per spectrum: a browser asked for six files
+ * in a row blocks all but the first, and a sample and its background are wanted
+ * back as the pair they were compared as. The blocks go inside a `LINK` block,
+ * which is what JCAMP has for a container and what the instruments that write a
+ * pair already use, so dropping the file back on the chart brings the whole list
+ * back.
+ *
+ * A list of one is written as that block alone: wrapping a single spectrum in a
+ * container gains nothing, and the file is then exactly what asking for that one
+ * spectrum would have written.
+ * @param spectra - The spectra, in the order the list holds them.
+ * @param mode - The axis being read, used for a spectrum whose file named none.
+ * @param title - What to call the file's own outer block.
+ * @returns The file.
+ */
+export function irSpectraToJcamp(spectra, mode, title = `${spectra.length} infrared spectra`) {
+    const only = spectra.length === 1 ? spectra[0] : undefined;
+    if (only !== undefined)
+        return irSpectrumToJcamp(only, mode);
+    const blocks = [];
+    for (const spectrum of spectra) {
+        blocks.push(irSpectrumToJcamp(spectrum, mode));
+    }
+    return `##TITLE=${recordValue(title)}
+##JCAMP-DX=4.24
+##DATA TYPE=LINK
+##BLOCKS=${blocks.length}
+${blocks.join('\n')}
+##END=
+`;
+}
+/**
+ * The standard records of a block: what it is called, and what its axes are.
+ * @param spectrum - The spectrum.
+ * @param written - The axis being written.
+ * @returns The records, as `convert-to-jcamp` takes them.
+ */
+function infoRecords(spectrum, written) {
+    return {
+        title: recordValue(spectrum.name),
+        // The technique as the file stated it, so a Raman spectrum that was opened
+        // here is not written back out claiming to be infrared.
+        dataType: technique(spectrum) ?? DEFAULT_DATA_TYPE,
+        xUnits: '1/CM',
+        // Spelled the way `ir-spectrum` reads it: it takes the axis to be
+        // transmittance when the label says `trans`, and to be a percentage rather
+        // than a fraction when it carries a `%`.
+        yUnits: written === 'absorbance' ? 'ABSORBANCE' : 'Transmittance (%)',
+    };
+}
+/**
+ * The `$`-prefixed records of a block: the acquisition, as the file stated it.
+ *
+ * The table's labels are the record names themselves — the reader lists whatever
+ * `##$` records a block carried, under their own names — so writing it back is a
+ * matter of putting the `$` in front again. `Technique` is the one row that is
+ * not a record of that bag: it is the block's `##DATA TYPE=`, and it goes back
+ * there rather than becoming a user-defined record of its own.
+ * @param spectrum - The spectrum.
+ * @returns The records, keyed without their `##$`.
+ */
+function metaRecords(spectrum) {
+    const records = {};
+    const fields = spectrum.meta?.fields ?? [];
+    for (const field of fields) {
+        if (field.label === TECHNIQUE)
+            continue;
+        records[recordKey(field.label)] = recordValue(field.value);
+    }
+    return records;
+}
+/** The row of the table that holds the block's own data type. */
+const TECHNIQUE = 'Technique';
+/**
+ * What the file said the spectrum was, if it said.
+ * @param spectrum - The spectrum.
+ * @returns The technique, or `undefined` when the file stated none.
+ */
+function technique(spectrum) {
+    for (const field of spectrum.meta?.fields ?? []) {
+        if (field.label === TECHNIQUE)
+            return recordValue(field.value);
+    }
+    return undefined;
+}
+/**
+ * A label put where a JCAMP record's name goes.
+ *
+ * A record name runs to the `=` and holds no whitespace, so a label that picked
+ * up a space on its way through some other tool would otherwise write a record
+ * whose name is its first word and whose value starts with the rest of it.
+ * @param label - The row's label.
+ * @returns It as a record name.
+ */
+function recordKey(label) {
+    return label.replaceAll(/[\s=]+/g, '_');
+}
+/**
+ * A value put where a JCAMP record's value goes.
+ *
+ * A record is one line and `$$` opens a comment that runs to the end of it, so a
+ * value with a newline in it would otherwise either break the file in two or
+ * lose its tail. Both failures are silent on the way back in, which is why this
+ * is done to every value rather than to the ones known to be long.
+ * @param value - The value as it is held.
+ * @returns The value as one line, with no comment marker in it.
+ */
+function recordValue(value) {
+    return value.replaceAll(/\s+/g, ' ').replaceAll('$$', '$').trim();
+}
+//# sourceMappingURL=spectrumJcamp.js.map

package/lib/ir/core/spectrumJcamp.js.map

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

package/lib/ir/core/toIrSpectrum.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Turning what a reader produced into what the viewer holds.
+ *
+ * A reader answers about a file and knows nothing about the session it is being
+ * read into — which spectra are already open, what colours they took, what this
+ * one should be called. That is the gap this closes, and it is the only place an
+ * identity or a colour is invented.
+ */
+import type { LoadedIrSpectrum } from './analysisSpectra.ts';
+import type { IrSpectrum } from './irSpectrum.ts';
+/** What has to be decided for a loaded spectrum to become a held one. */
+export interface ToIrSpectrumOptions {
+    /**
+     * Identity, which every later edit and selection is keyed on.
+     * @default a fresh UUID
+     */
+    id?: string;
+    /**
+     * The colour to draw it in.
+     * @default the lowest hue not in `taken`
+     */
+    color?: string;
+    /**
+     * The colours the spectra already open have taken, so a new one is told apart
+     * from them. Ignored when `color` says outright.
+     * @default no colours taken
+     */
+    taken?: readonly string[];
+    /**
+     * What to call it, overriding the file's own title.
+     * @default the file's title, then its name, then `spectrum`
+     */
+    name?: string;
+    /**
+     * Whether it is drawn as soon as it is added.
+     * @default true
+     */
+    visible?: boolean;
+}
+/**
+ * Make a held spectrum out of a read one.
+ * @param loaded - What the reader produced.
+ * @param options - The identity, colour and name to give it.
+ * @returns The spectrum as the viewer holds it.
+ */
+export declare function toIrSpectrum(loaded: LoadedIrSpectrum, options?: ToIrSpectrumOptions): IrSpectrum;
+/**
+ * Make held spectra out of everything one file held.
+ *
+ * The colours are handed out one at a time against a growing list, so a file
+ * carrying a sample and its background gives two spectra of two colours rather
+ * than two of the same — `nextSpectrumColor` can only answer that if it is told
+ * what the previous call took.
+ * @param loaded - What the reader produced, in file order.
+ * @param options - The colours already taken, and whether the spectra are drawn.
+ * @returns The spectra, in the same order.
+ */
+export declare function toIrSpectra(loaded: readonly LoadedIrSpectrum[], options?: Pick<ToIrSpectrumOptions, 'taken' | 'visible'>): IrSpectrum[];
+//# sourceMappingURL=toIrSpectrum.d.ts.map

package/lib/ir/core/toIrSpectrum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toIrSpectrum.d.ts","sourceRoot":"","sources":["../../../src/ir/core/toIrSpectrum.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,mBAAwB,GAChC,UAAU,CAmBZ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,SAAS,gBAAgB,EAAE,EACnC,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,SAAS,CAAM,GAC3D,UAAU,EAAE,CAad"}

package/lib/ir/core/toIrSpectrum.js

@@ -0,0 +1,56 @@
+/**
+ * Turning what a reader produced into what the viewer holds.
+ *
+ * A reader answers about a file and knows nothing about the session it is being
+ * read into — which spectra are already open, what colours they took, what this
+ * one should be called. That is the gap this closes, and it is the only place an
+ * identity or a colour is invented.
+ */
+import { nextSpectrumColor } from "../../chart/core/spectrumColor.js";
+/**
+ * Make a held spectrum out of a read one.
+ * @param loaded - What the reader produced.
+ * @param options - The identity, colour and name to give it.
+ * @returns The spectrum as the viewer holds it.
+ */
+export function toIrSpectrum(loaded, options = {}) {
+    const { id = crypto.randomUUID(), taken = [], name, visible = true, } = options;
+    const color = options.color ?? nextSpectrumColor(taken);
+    return {
+        id,
+        name: name ?? loaded.name ?? loaded.origin.fileName ?? 'spectrum',
+        color,
+        wavenumber: loaded.wavenumber,
+        absorbance: loaded.absorbance,
+        transmittance: loaded.transmittance,
+        meta: loaded.meta,
+        origin: loaded.origin,
+        visible,
+    };
+}
+/**
+ * Make held spectra out of everything one file held.
+ *
+ * The colours are handed out one at a time against a growing list, so a file
+ * carrying a sample and its background gives two spectra of two colours rather
+ * than two of the same — `nextSpectrumColor` can only answer that if it is told
+ * what the previous call took.
+ * @param loaded - What the reader produced, in file order.
+ * @param options - The colours already taken, and whether the spectra are drawn.
+ * @returns The spectra, in the same order.
+ */
+export function toIrSpectra(loaded, options = {}) {
+    const { taken = [], visible } = options;
+    const colors = [...taken];
+    const spectra = [];
+    for (const entry of loaded) {
+        const spectrum = toIrSpectrum(entry, {
+            taken: colors,
+            ...(visible === undefined ? {} : { visible }),
+        });
+        colors.push(spectrum.color);
+        spectra.push(spectrum);
+    }
+    return spectra;
+}
+//# sourceMappingURL=toIrSpectrum.js.map

package/lib/ir/core/toIrSpectrum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toIrSpectrum.js","sourceRoot":"","sources":["../../../src/ir/core/toIrSpectrum.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAmCtE;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAwB,EACxB,UAA+B,EAAE;IAEjC,MAAM,EACJ,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,EACxB,KAAK,GAAG,EAAE,EACV,IAAI,EACJ,OAAO,GAAG,IAAI,GACf,GAAG,OAAO,CAAC;IACZ,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACxD,OAAO;QACL,EAAE;QACF,IAAI,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,UAAU;QACjE,KAAK;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CACzB,MAAmC,EACnC,UAA0D,EAAE;IAE5D,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACxC,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAC1B,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,EAAE;YACnC,KAAK,EAAE,MAAM;YACb,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;SAC9C,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/lib/ir/ui/BandMarks.d.ts

@@ -0,0 +1,52 @@
+import type { ReactElement } from 'react';
+import type { PlotRect } from '../../chart/core/chartGeometry.ts';
+import type { ChartScale } from '../../chart/core/chartScale.ts';
+import type { AssignedBand } from '../core/assignBands.ts';
+import type { IrBand } from '../core/irBand.ts';
+import type { IrMode } from '../core/irSpectrum.ts';
+export interface BandMarksProps {
+    /** The bands to mark, with whatever the table said about them. */
+    assigned: readonly AssignedBand[];
+    /** Where the plot sits inside the SVG. */
+    plot: PlotRect;
+    /** The wavenumber axis as it is currently zoomed. */
+    xScale: ChartScale;
+    /** The value axis as it is currently zoomed. */
+    yScale: ChartScale;
+    /** Which value axis is being drawn. */
+    mode: IrMode;
+    /**
+     * Whether each label names the assignment as well as the wavenumber.
+     * @default false
+     */
+    showAssignments?: boolean;
+    /**
+     * At most how many bands are named. Marks are drawn on all of them.
+     * @default 12
+     */
+    limit?: number;
+    /**
+     * The band the pointer has come to rest on, drawn larger, `null` for none.
+     * @default null
+     */
+    highlight?: IrBand | null;
+}
+/**
+ * A mark on every band, and a label on the ones there is room for.
+ *
+ * The mark reaches *away* from the label, into the band, because the clear space
+ * on the label's side is where the numbers are written and the mark is there to
+ * say which band they are about. So in transmittance both hang downwards from a
+ * dip and in absorbance both rise from a maximum, and the pair reads the same way
+ * up in either.
+ *
+ * A leader line is drawn only when a label had to be slid off its band to clear
+ * its neighbours — a leader from a label that is already directly above its band
+ * is a line saying what the position already said. A label slid too far is not
+ * drawn at all; the mark still says the band is there, which is the honest
+ * outcome, where a label hanging over a band it says nothing about is not.
+ * @param props - Component props.
+ * @returns The marks and labels, as SVG.
+ */
+export declare function BandMarks(props: BandMarksProps): ReactElement;
+//# sourceMappingURL=BandMarks.d.ts.map

package/lib/ir/ui/BandMarks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BandMarks.d.ts","sourceRoot":"","sources":["../../../src/ir/ui/BandMarks.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAMjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAClC,0CAA0C;IAC1C,IAAI,EAAE,QAAQ,CAAC;IACf,qDAAqD;IACrD,MAAM,EAAE,UAAU,CAAC;IACnB,gDAAgD;IAChD,MAAM,EAAE,UAAU,CAAC;IACnB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,CAyE7D"}