react-cheminfo 0.65.0 → 0.66.0

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

@@ -1,17 +1,22 @@
 /**
- * What an infrared spectrum is once it has been read, whatever it was read from.
+ * What a vibrational spectrum is once it has been read, whatever it was read
+ * from.
  *
- * One acquisition becomes one `IrSpectrum` carrying **both** value axes —
- * absorbance and percent transmittance — over one shared array of wavenumbers.
- * Both are held rather than one being derived on demand because `ir-spectrum`
- * already produces both when it reads a file: it adds an `a` and a `t` variable
- * to every spectrum whichever of the two the instrument wrote, so the conversion
- * happens once, in the one place that knows what the file's y axis meant. Holding
- * the answer means switching what is drawn costs nothing, and means the two
- * axes can never drift apart through a round trip.
+ * One infrared acquisition becomes one `IrSpectrum` carrying **both** value
+ * axes — absorbance and percent transmittance — over one shared array of
+ * wavenumbers. Both are held rather than one being derived on demand because
+ * `ir-spectrum` already produces both when it reads a file: it adds an `a` and
+ * a `t` variable to every spectrum whichever of the two the instrument wrote, so
+ * the conversion happens once, in the one place that knows what the file's y
+ * axis meant. Holding the answer means switching what is drawn costs nothing,
+ * and means the two axes can never drift apart through a round trip.
+ *
+ * A Raman acquisition carries its intensity instead, over its Raman shifts —
+ * also wavenumbers in cm⁻¹ — and neither infrared axis: there is no
+ * transmittance of scattered light to convert it to.
  *
  * The arrays are `Float64Array` and are replaced on a change, never written
- * into, since every consumer holds the same object by reference. An infrared
+ * into, since every consumer holds the same object by reference. A vibrational
  * spectrum is a few thousand points rather than a mass spectrum's few hundred
  * thousand, so holding two value axes costs nothing worth counting.
  */
@@ -26,8 +31,11 @@ import type { ChartDomain } from '../../chart/core/chartDomain.ts';
  * adapter at each boundary.
  */
 export type IrTrace = DataXY<Float64Array>;
-/** The formats a spectrum can have been read from. */
-export type IrFormat = 'jcamp' | 'spc' | 'text' | 'calculated';
+/**
+ * The formats a spectrum can have been read from. `wdf` is Renishaw's Raman
+ * format, which a host reads with its own parser and hands over.
+ */
+export type IrFormat = 'jcamp' | 'spc' | 'text' | 'wdf' | 'calculated';
 /**
  * Where a spectrum came from, and what the file said about the acquisition.
  *
@@ -79,8 +87,11 @@ export interface IrMeta {
     /** The fields that are populated, in display order. */
     fields: IrMetaField[];
 }
-/** Which value axis is being drawn and read. */
-export type IrMode = 'absorbance' | 'transmittance';
+/**
+ * Which value axis is being drawn and read: absorbance or percent
+ * transmittance for an infrared spectrum, intensity for a Raman one.
+ */
+export type IrMode = 'absorbance' | 'transmittance' | 'intensity';
 /** One spectrum as the viewer holds it. */
 export interface IrSpectrum {
     /** Identity, stable across edits so a selection survives a rename. */
@@ -90,19 +101,33 @@ export interface IrSpectrum {
     /** The colour it is drawn in. */
     color: string;
     /**
-     * The wavenumbers in cm⁻¹, **ascending**.
+     * The wavenumbers in cm⁻¹, **ascending** — of the light absorbed for an
+     * infrared spectrum, the Raman shift for a Raman one.
      *
-     * Ascending even though the axis is read from 4000 down to 400: which way the
-     * numbers run on screen is the chart's business, and every binary search and
-     * every extent taken off index zero downstream wants them in order. Reversing
-     * the data instead would make the drawing simpler once and everything else
-     * wrong.
+     * Ascending even though the infrared axis is read from 4000 down to 400:
+     * which way the numbers run on screen is the chart's business, and every
+     * binary search and every extent taken off index zero downstream wants them in
+     * order. Reversing the data instead would make the drawing simpler once and
+     * everything else wrong.
      */
     wavenumber: Float64Array;
-    /** Absorbance at each wavenumber, as `ir-spectrum` supplied it. */
-    absorbance: Float64Array;
-    /** Percent transmittance at each wavenumber, likewise. */
-    transmittance: Float64Array;
+    /**
+     * Absorbance at each wavenumber, as `ir-spectrum` supplied it. An infrared
+     * spectrum carries it beside `transmittance`.
+     * @default undefined
+     */
+    absorbance?: Float64Array;
+    /**
+     * Percent transmittance at each wavenumber, likewise.
+     * @default undefined
+     */
+    transmittance?: Float64Array;
+    /**
+     * Intensity at each Raman shift, which a Raman spectrum carries instead of
+     * the two infrared axes.
+     * @default undefined
+     */
+    intensity?: Float64Array;
     /** What the file said about the acquisition, `null` when it said nothing. */
     meta: IrMeta | null;
     /** Where it came from. */
@@ -134,7 +159,8 @@ export type IrDomain = ChartDomain;
  * render of every spectrum is a copy per frame for no gain.
  * @param spectrum - The spectrum.
  * @param mode - Which value axis is being drawn.
- * @returns The trace, sharing the spectrum's own arrays.
+ * @returns The trace, sharing the spectrum's own arrays, or `undefined` when the
+ * spectrum carries no such axis — a Raman spectrum has no absorbance.
  */
-export declare function traceOf(spectrum: IrSpectrum, mode: IrMode): IrTrace;
+export declare function traceOf(spectrum: IrSpectrum, mode: IrMode): IrTrace | undefined;
 //# sourceMappingURL=irSpectrum.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"irSpectrum.d.ts","sourceRoot":"","sources":["../../../src/ir/core/irSpectrum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAE3C,sDAAsD;AACtD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,YAAY,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,mCAAmC;IACnC,MAAM,EAAE,QAAQ,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM;IACrB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,uDAAuD;IACvD,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,gDAAgD;AAChD,MAAM,MAAM,MAAM,GAAG,YAAY,GAAG,eAAe,CAAC;AAEpD,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;;OAQG;IACH,UAAU,EAAE,YAAY,CAAC;IACzB,mEAAmE;IACnE,UAAU,EAAE,YAAY,CAAC;IACzB,0DAA0D;IAC1D,aAAa,EAAE,YAAY,CAAC;IAC5B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,0BAA0B;IAC1B,MAAM,EAAE,QAAQ,CAAC;IACjB,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC;AAEnC;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKnE"}
+{"version":3,"file":"irSpectrum.d.ts","sourceRoot":"","sources":["../../../src/ir/core/irSpectrum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,YAAY,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,mCAAmC;IACnC,MAAM,EAAE,QAAQ,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM;IACrB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,uDAAuD;IACvD,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG,YAAY,GAAG,eAAe,GAAG,WAAW,CAAC;AAElE,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;;;OASG;IACH,UAAU,EAAE,YAAY,CAAC;IACzB;;;;OAIG;IACH,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,6EAA6E;IAC7E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,0BAA0B;IAC1B,MAAM,EAAE,QAAQ,CAAC;IACjB,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC;AAEnC;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,UAAU,EACpB,IAAI,EAAE,MAAM,GACX,OAAO,GAAG,SAAS,CAKrB"}

package/lib/ir/core/irSpectrum.js

@@ -1,17 +1,22 @@
 /**
- * What an infrared spectrum is once it has been read, whatever it was read from.
+ * What a vibrational spectrum is once it has been read, whatever it was read
+ * from.
  *
- * One acquisition becomes one `IrSpectrum` carrying **both** value axes —
- * absorbance and percent transmittance — over one shared array of wavenumbers.
- * Both are held rather than one being derived on demand because `ir-spectrum`
- * already produces both when it reads a file: it adds an `a` and a `t` variable
- * to every spectrum whichever of the two the instrument wrote, so the conversion
- * happens once, in the one place that knows what the file's y axis meant. Holding
- * the answer means switching what is drawn costs nothing, and means the two
- * axes can never drift apart through a round trip.
+ * One infrared acquisition becomes one `IrSpectrum` carrying **both** value
+ * axes — absorbance and percent transmittance — over one shared array of
+ * wavenumbers. Both are held rather than one being derived on demand because
+ * `ir-spectrum` already produces both when it reads a file: it adds an `a` and
+ * a `t` variable to every spectrum whichever of the two the instrument wrote, so
+ * the conversion happens once, in the one place that knows what the file's y
+ * axis meant. Holding the answer means switching what is drawn costs nothing,
+ * and means the two axes can never drift apart through a round trip.
+ *
+ * A Raman acquisition carries its intensity instead, over its Raman shifts —
+ * also wavenumbers in cm⁻¹ — and neither infrared axis: there is no
+ * transmittance of scattered light to convert it to.
  *
  * The arrays are `Float64Array` and are replaced on a change, never written
- * into, since every consumer holds the same object by reference. An infrared
+ * into, since every consumer holds the same object by reference. A vibrational
  * spectrum is a few thousand points rather than a mass spectrum's few hundred
  * thousand, so holding two value axes costs nothing worth counting.
  */
@@ -23,12 +28,13 @@
  * render of every spectrum is a copy per frame for no gain.
  * @param spectrum - The spectrum.
  * @param mode - Which value axis is being drawn.
- * @returns The trace, sharing the spectrum's own arrays.
+ * @returns The trace, sharing the spectrum's own arrays, or `undefined` when the
+ * spectrum carries no such axis — a Raman spectrum has no absorbance.
  */
 export function traceOf(spectrum, mode) {
-    return {
-        x: spectrum.wavenumber,
-        y: mode === 'absorbance' ? spectrum.absorbance : spectrum.transmittance,
-    };
+    const values = spectrum[mode];
+    return values === undefined
+        ? undefined
+        : { x: spectrum.wavenumber, y: values };
 }
 //# sourceMappingURL=irSpectrum.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"irSpectrum.js","sourceRoot":"","sources":["../../../src/ir/core/irSpectrum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA2HH;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO,CAAC,QAAoB,EAAE,IAAY;IACxD,OAAO;QACL,CAAC,EAAE,QAAQ,CAAC,UAAU;QACtB,CAAC,EAAE,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa;KACxE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"irSpectrum.js","sourceRoot":"","sources":["../../../src/ir/core/irSpectrum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA+IH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CACrB,QAAoB,EACpB,IAAY;IAEZ,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,MAAM,KAAK,SAAS;QACzB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;AAC5C,CAAC"}

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

@@ -14,6 +14,7 @@
  */
 import type { IrSidePanelId } from './irSidePanels.ts';
 import type { IrDomain, IrMode, IrSpectrum } from './irSpectrum.ts';
+import type { IrTechnique } from './irTechnique.ts';
 import type { PickBandsOptions } from './pickBands.ts';
 /** The document: what a file holds. */
 export interface IrData {
@@ -43,7 +44,12 @@ export interface IrView {
 }
 /** The workspace: how every spectrum is drawn, whichever ones are open. */
 export interface IrSettings {
-    /** Which value axis the spectra are read in. */
+    /**
+     * What the spectra were measured with. Chosen when the viewer opens and fixed
+     * from then on: a change asking for another is ignored.
+     */
+    technique: IrTechnique;
+    /** Which value axis the spectra are read in, always one the technique offers. */
     mode: IrMode;
     /** Whether the bands are picked at all. */
     pickBands: boolean;
@@ -92,6 +98,36 @@ export declare const DEFAULT_LABEL_LIMIT = 12;
 export declare const DEFAULT_PICKING: PickBandsOptions;
 /** The workspace a fresh viewer starts from. */
 export declare const DEFAULT_SETTINGS: IrSettings;
+/** What a viewer opens on. */
+export interface CreateIrStateOptions {
+    /**
+     * The spectra to open on.
+     * @default []
+     */
+    spectra?: IrSpectrum[];
+    /**
+     * The workspace to open in. Its `technique` is fixed for the life of the
+     * viewer, and its `mode` falls back to the technique's first when the
+     * technique does not offer it.
+     * @default DEFAULT_SETTINGS
+     */
+    settings?: Partial<IrSettings>;
+    /**
+     * The panels open to begin with.
+     * @default DEFAULT_SIDE_PANELS
+     */
+    panelIds?: IrSidePanelId[];
+}
+/**
+ * The state a viewer opens with.
+ *
+ * The panel list is spread rather than stored by reference: a caller's array is
+ * the caller's to mutate, and a viewer holding it would find its open panels
+ * changing under it.
+ * @param options - What it opens on.
+ * @returns The state.
+ */
+export declare function createIrState(options?: CreateIrStateOptions): IrState;
 /**
  * Fold a change into the workspace, refusing what no chart survives.
  *
@@ -99,7 +135,9 @@ export declare const DEFAULT_SETTINGS: IrSettings;
  * not yet a number — a lone minus sign, an empty box — and a limit of `NaN`
  * silently stops every label being drawn. So each is checked, and the current
  * value is kept where the new one is unusable rather than the field being
- * fought with while it is being typed in.
+ * fought with while it is being typed in. The technique is never changed, and a
+ * mode it does not offer is refused the same way: a Raman spectrum has no
+ * absorbance to draw.
  * @param current - The workspace in force.
  * @param change - What to change about it.
  * @returns The new workspace.

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

@@ -1 +1 @@
-{"version":3,"file":"irState.d.ts","sourceRoot":"","sources":["../../../src/ir/core/irState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,uCAAuC;AACvC,MAAM,WAAW,MAAM;IACrB,kDAAkD;IAClD,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,8DAA8D;AAC9D,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEpC,mCAAmC;AACnC,MAAM,WAAW,MAAM;IACrB,mEAAmE;IACnE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;;;OAMG;IACH,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,uEAAuE;IACvE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,2EAA2E;AAC3E,MAAM,WAAW,UAAU;IACzB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,OAAO,EAAE,gBAAgB,CAAC;IAC1B,6EAA6E;IAC7E,eAAe,EAAE,OAAO,CAAC;IACzB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,mCAAmC;AACnC,MAAM,WAAW,OAAO;IACtB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACvB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;CAChC;AAED,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,EAAE,aAAyB,CAAC;AAE3D;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAAa,EAAyB,CAAC;AAEzE,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,2CAA2C;AAC3C,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,0DAA0D;AAC1D,eAAO,MAAM,eAAe,EAAE,gBAG7B,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,gBAAgB,EAAE,UAO9B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,UAAU,EACnB,MAAM,GAAE,OAAO,CAAC,UAAU,CAAM,GAC/B,UAAU,CAeZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAEpD"}
+{"version":3,"file":"irState.d.ts","sourceRoot":"","sources":["../../../src/ir/core/irState.ts"],"names":[],"mappings":"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"}

package/lib/ir/core/irState.js

@@ -12,6 +12,7 @@
  * kept in step with its own inputs — `useIrEditor` recomputes them instead, and
  * a stale band is then impossible rather than merely unlikely.
  */
+import { defaultIrMode, irModeFor, offersIrMode } from "./irTechnique.js";
 /** The panel the splitter brings back when it is dragged open on nothing. */
 export const DEFAULT_SIDE_PANEL = 'spectra';
 /**
@@ -33,6 +34,7 @@ export const DEFAULT_PICKING = {
 };
 /** The workspace a fresh viewer starts from. */
 export const DEFAULT_SETTINGS = {
+    technique: 'infrared',
     mode: 'transmittance',
     pickBands: true,
     picking: DEFAULT_PICKING,
@@ -40,6 +42,35 @@ export const DEFAULT_SETTINGS = {
     labelLimit: DEFAULT_LABEL_LIMIT,
     assignmentTolerance: 5,
 };
+/**
+ * The state a viewer opens with.
+ *
+ * The panel list is spread rather than stored by reference: a caller's array is
+ * the caller's to mutate, and a viewer holding it would find its open panels
+ * changing under it.
+ * @param options - What it opens on.
+ * @returns The state.
+ */
+export function createIrState(options = {}) {
+    const { spectra = [], settings, panelIds } = options;
+    const technique = settings?.technique ?? DEFAULT_SETTINGS.technique;
+    const opened = {
+        ...DEFAULT_SETTINGS,
+        technique,
+        mode: defaultIrMode(technique),
+    };
+    return {
+        data: { spectra: [...spectra] },
+        view: {
+            selectedId: spectra[0]?.id ?? null,
+            domain: null,
+            tool: 'read',
+            openPanelIds: [...(panelIds ?? DEFAULT_SIDE_PANELS)],
+            error: null,
+        },
+        settings: mergeIrSettings(opened, settings),
+    };
+}
 /**
  * Fold a change into the workspace, refusing what no chart survives.
  *
@@ -47,7 +78,9 @@ export const DEFAULT_SETTINGS = {
  * not yet a number — a lone minus sign, an empty box — and a limit of `NaN`
  * silently stops every label being drawn. So each is checked, and the current
  * value is kept where the new one is unusable rather than the field being
- * fought with while it is being typed in.
+ * fought with while it is being typed in. The technique is never changed, and a
+ * mode it does not offer is refused the same way: a Raman spectrum has no
+ * absorbance to draw.
  * @param current - The workspace in force.
  * @param change - What to change about it.
  * @returns The new workspace.
@@ -58,6 +91,10 @@ export function mergeIrSettings(current, change = {}) {
     return {
         ...current,
         ...change,
+        technique: current.technique,
+        mode: offersIrMode(current.technique, change.mode)
+            ? change.mode
+            : irModeFor(current.technique, current.mode),
         picking: { ...current.picking, ...change.picking },
         labelLimit: Number.isFinite(asked)
             ? Math.min(MAXIMUM_LABEL_LIMIT, Math.max(0, Math.round(asked)))

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

@@ -1 +1 @@
-{"version":3,"file":"irState.js","sourceRoot":"","sources":["../../../src/ir/core/irState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAuEH,6EAA6E;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAAkB,SAAS,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAoB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAEzE,iEAAiE;AACjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C,iBAAiB,EAAE,IAAI;IACvB,YAAY,EAAE,CAAC;CAChB,CAAC;AAEF,gDAAgD;AAChD,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,IAAI,EAAE,eAAe;IACrB,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,eAAe;IACxB,eAAe,EAAE,KAAK;IACtB,UAAU,EAAE,mBAAmB;IAC/B,mBAAmB,EAAE,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAmB,EACnB,SAA8B,EAAE;IAEhC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IACtD,MAAM,SAAS,GAAG,MAAM,CAAC,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAC5E,OAAO;QACL,GAAG,OAAO;QACV,GAAG,MAAM;QACT,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE;QAClD,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAChC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YAC/D,CAAC,CAAC,OAAO,CAAC,UAAU;QACtB,mBAAmB,EACjB,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC;YAC1C,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,OAAO,CAAC,mBAAmB;KAClC,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,MAAgB;IACzC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ,CAAC,MAAwB;IACxC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC;IAC1B,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;AACnE,CAAC"}
+{"version":3,"file":"irState.js","sourceRoot":"","sources":["../../../src/ir/core/irState.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,94 @@
+/**
+ * Everything that differs between an infrared spectrum and a Raman one.
+ *
+ * Both are vibrational spectra over wavenumbers in cm⁻¹, and the viewer reads
+ * them the same way — one chart, one set of panels, one set of gestures — so
+ * what is left to differ is a handful of facts: which value axes a spectrum is
+ * read on, what the horizontal axis is called and which way it runs, whether the
+ * correlation table has anything to say about a band, and what a written file
+ * calls itself. They are gathered here for the reason `IR_MODE_RULES` gathers
+ * what differs between the value axes: a component that asked which technique
+ * it was drawing would be the first of many to ask, and they would come to
+ * disagree.
+ */
+import type { IrMode } from './irSpectrum.ts';
+/** What was measured: the light a sample absorbs, or the light it scatters. */
+export type IrTechnique = 'infrared' | 'raman';
+/** What is true of one technique. */
+export interface IrTechniqueRules {
+    /** How it is written inside a sentence; a sentence opening on it capitalises it. */
+    name: string;
+    /** The value axes a spectrum is read on, in the order a control offers them. */
+    modes: readonly IrMode[];
+    /** What the horizontal axis is called. */
+    xTitle: string;
+    /** Whether the horizontal axis runs from high at the left to low at the right. */
+    reverseX: boolean;
+    /** Whether the correlation table is asked what a band might be. */
+    assignments: boolean;
+    /** The `##DATA TYPE=` a written spectrum states when its file stated none. */
+    dataType: string;
+}
+/** The techniques, in the order a control would offer them. */
+export declare const IR_TECHNIQUES: readonly IrTechnique[];
+/** How each technique behaves, every fact in one place. */
+export declare const IR_TECHNIQUE_RULES: {
+    readonly infrared: {
+        readonly name: "infrared";
+        readonly modes: readonly ["transmittance", "absorbance"];
+        readonly xTitle: "wavenumber (cm⁻¹)";
+        /**
+         * 4000 at the left and 400 at the right, which is how every infrared
+         * spectrum has been printed since the instruments scanned that way.
+         */
+        readonly reverseX: true;
+        readonly assignments: true;
+        readonly dataType: "INFRARED SPECTRUM";
+    };
+    readonly raman: {
+        readonly name: "Raman";
+        /** One axis: a Raman spectrum is the light scattered, and nothing else. */
+        readonly modes: readonly ["intensity"];
+        readonly xTitle: "Raman shift (cm⁻¹)";
+        /** The shift grows away from the laser line, left to right. */
+        readonly reverseX: false;
+        /**
+         * The table holds infrared group frequencies and infrared strengths. A
+         * vibration strong in one technique is often weak or silent in the other,
+         * so its candidates offered for a Raman band would claim what the table
+         * does not know.
+         */
+        readonly assignments: false;
+        readonly dataType: "RAMAN SPECTRUM";
+    };
+};
+/**
+ * The value axis a viewer of a technique opens on.
+ * @param technique - What was measured.
+ * @returns Its first mode.
+ */
+export declare function defaultIrMode(technique: IrTechnique): IrMode;
+/**
+ * Whether a technique reads its spectra on a value axis.
+ * @param technique - What was measured.
+ * @param mode - The axis asked about; `undefined` is offered by none.
+ * @returns Whether the technique offers it.
+ */
+export declare function offersIrMode(technique: IrTechnique, mode: IrMode | undefined): mode is IrMode;
+/**
+ * The value axis to read a technique's spectra on, given the one asked for.
+ * @param technique - What was measured.
+ * @param mode - The axis asked for, if any.
+ * @returns It when the technique offers it, the technique's first otherwise.
+ */
+export declare function irModeFor(technique: IrTechnique, mode?: IrMode): IrMode;
+/**
+ * The technique that reads its spectra on a value axis.
+ *
+ * Every axis belongs to exactly one technique, so the axis a file was written
+ * on says what was measured.
+ * @param mode - The value axis.
+ * @returns The technique offering it.
+ */
+export declare function irModeTechnique(mode: IrMode): IrTechnique;
+//# sourceMappingURL=irTechnique.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"irTechnique.d.ts","sourceRoot":"","sources":["../../../src/ir/core/irTechnique.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,+EAA+E;AAC/E,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAE/C,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,QAAQ,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,WAAW,EAAE,OAAO,CAAC;IACrB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,+DAA+D;AAC/D,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAA0B,CAAC;AAE3E,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB;;;;;QAK3B;;;WAGG;;;;;;;QAOH,2EAA2E;;;QAG3E,+DAA+D;;QAE/D;;;;;WAKG;;;;CAImD,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,WAAW,EACtB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,IAAI,IAAI,MAAM,CAIhB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAEzD"}

package/lib/ir/core/irTechnique.js

@@ -0,0 +1,87 @@
+/**
+ * Everything that differs between an infrared spectrum and a Raman one.
+ *
+ * Both are vibrational spectra over wavenumbers in cm⁻¹, and the viewer reads
+ * them the same way — one chart, one set of panels, one set of gestures — so
+ * what is left to differ is a handful of facts: which value axes a spectrum is
+ * read on, what the horizontal axis is called and which way it runs, whether the
+ * correlation table has anything to say about a band, and what a written file
+ * calls itself. They are gathered here for the reason `IR_MODE_RULES` gathers
+ * what differs between the value axes: a component that asked which technique
+ * it was drawing would be the first of many to ask, and they would come to
+ * disagree.
+ */
+/** The techniques, in the order a control would offer them. */
+export const IR_TECHNIQUES = ['infrared', 'raman'];
+/** How each technique behaves, every fact in one place. */
+export const IR_TECHNIQUE_RULES = {
+    infrared: {
+        name: 'infrared',
+        modes: ['transmittance', 'absorbance'],
+        xTitle: 'wavenumber (cm⁻¹)',
+        /**
+         * 4000 at the left and 400 at the right, which is how every infrared
+         * spectrum has been printed since the instruments scanned that way.
+         */
+        reverseX: true,
+        assignments: true,
+        dataType: 'INFRARED SPECTRUM',
+    },
+    raman: {
+        name: 'Raman',
+        /** One axis: a Raman spectrum is the light scattered, and nothing else. */
+        modes: ['intensity'],
+        xTitle: 'Raman shift (cm⁻¹)',
+        /** The shift grows away from the laser line, left to right. */
+        reverseX: false,
+        /**
+         * The table holds infrared group frequencies and infrared strengths. A
+         * vibration strong in one technique is often weak or silent in the other,
+         * so its candidates offered for a Raman band would claim what the table
+         * does not know.
+         */
+        assignments: false,
+        dataType: 'RAMAN SPECTRUM',
+    },
+};
+/**
+ * The value axis a viewer of a technique opens on.
+ * @param technique - What was measured.
+ * @returns Its first mode.
+ */
+export function defaultIrMode(technique) {
+    return IR_TECHNIQUE_RULES[technique].modes[0];
+}
+/**
+ * Whether a technique reads its spectra on a value axis.
+ * @param technique - What was measured.
+ * @param mode - The axis asked about; `undefined` is offered by none.
+ * @returns Whether the technique offers it.
+ */
+export function offersIrMode(technique, mode) {
+    if (mode === undefined)
+        return false;
+    const modes = IR_TECHNIQUE_RULES[technique].modes;
+    return modes.includes(mode);
+}
+/**
+ * The value axis to read a technique's spectra on, given the one asked for.
+ * @param technique - What was measured.
+ * @param mode - The axis asked for, if any.
+ * @returns It when the technique offers it, the technique's first otherwise.
+ */
+export function irModeFor(technique, mode) {
+    return offersIrMode(technique, mode) ? mode : defaultIrMode(technique);
+}
+/**
+ * The technique that reads its spectra on a value axis.
+ *
+ * Every axis belongs to exactly one technique, so the axis a file was written
+ * on says what was measured.
+ * @param mode - The value axis.
+ * @returns The technique offering it.
+ */
+export function irModeTechnique(mode) {
+    return offersIrMode('raman', mode) ? 'raman' : 'infrared';
+}
+//# sourceMappingURL=irTechnique.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"irTechnique.js","sourceRoot":"","sources":["../../../src/ir/core/irTechnique.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAuBH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,aAAa,GAA2B,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAE3E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,CAAC,eAAe,EAAE,YAAY,CAAC;QACtC,MAAM,EAAE,mBAAmB;QAC3B;;;WAGG;QACH,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,mBAAmB;KAC9B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,2EAA2E;QAC3E,KAAK,EAAE,CAAC,WAAW,CAAC;QACpB,MAAM,EAAE,oBAAoB;QAC5B,+DAA+D;QAC/D,QAAQ,EAAE,KAAK;QACf;;;;;WAKG;QACH,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE,gBAAgB;KAC3B;CACuD,CAAC;AAE3D;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,SAAsB;IAClD,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAsB,EACtB,IAAwB;IAExB,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrC,MAAM,KAAK,GAAsB,kBAAkB,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC;IACrE,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,SAAsB,EAAE,IAAa;IAC7D,OAAO,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;AACzE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;AAC5D,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * The commands each technique's viewer offers.
+ *
+ * A Raman viewer offers the infrared table less the commands with nothing to
+ * act on — one value axis is nothing to toggle, and no assignment is nothing to
+ * name — and words the rest without the absorbance and transmittance it does
+ * not have. It is built from the infrared table, so a command added there
+ * reaches both.
+ */
+import type { IrCommandId, IrCommandTable } from './irCommands.ts';
+import type { IrTechnique } from './irTechnique.ts';
+/**
+ * Whether a viewer of a technique offers a command at all.
+ * @param technique - What was measured.
+ * @param id - Which command.
+ * @returns False for the toggle of a technique with one value axis, and for
+ * the assignments of one the correlation table says nothing about.
+ */
+export declare function irCommandOffered(technique: IrTechnique, id: IrCommandId): boolean;
+/**
+ * Everything a viewer of a technique offers, in the order it is reached for.
+ * @param technique - What was measured.
+ * @returns The table; for infrared, `irCommands` itself.
+ */
+export declare function irCommandsFor(technique: IrTechnique): IrCommandTable;
+//# sourceMappingURL=irTechniqueCommands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"irTechniqueCommands.d.ts","sourceRoot":"","sources":["../../../src/ir/core/irTechniqueCommands.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAa,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,WAAW,EACtB,EAAE,EAAE,WAAW,GACd,OAAO,CAKT;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,WAAW,GAAG,cAAc,CAEpE"}

package/lib/ir/core/irTechniqueCommands.js

@@ -0,0 +1,68 @@
+/**
+ * The commands each technique's viewer offers.
+ *
+ * A Raman viewer offers the infrared table less the commands with nothing to
+ * act on — one value axis is nothing to toggle, and no assignment is nothing to
+ * name — and words the rest without the absorbance and transmittance it does
+ * not have. It is built from the infrared table, so a command added there
+ * reaches both.
+ */
+import { irCommands } from "./irCommands.js";
+import { IR_TECHNIQUE_RULES } from "./irTechnique.js";
+/**
+ * Whether a viewer of a technique offers a command at all.
+ * @param technique - What was measured.
+ * @param id - Which command.
+ * @returns False for the toggle of a technique with one value axis, and for
+ * the assignments of one the correlation table says nothing about.
+ */
+export function irCommandOffered(technique, id) {
+    const { modes, assignments } = IR_TECHNIQUE_RULES[technique];
+    if (id === 'toggleMode')
+        return modes.length > 1;
+    if (id === 'toggleAssignments')
+        return assignments;
+    return true;
+}
+/**
+ * Everything a viewer of a technique offers, in the order it is reached for.
+ * @param technique - What was measured.
+ * @returns The table; for infrared, `irCommands` itself.
+ */
+export function irCommandsFor(technique) {
+    return COMMAND_TABLES[technique];
+}
+/** Where the chart is, for a gesture made anywhere on it. */
+const OVER_THE_CHART = 'Over the chart';
+/** How a Raman viewer words the commands it shares with infrared. */
+const RAMAN_WORDING = {
+    about: { title: 'About the Raman viewer' },
+    documentation: {
+        description: 'How the bands are read, and every gesture.',
+    },
+    readTool: {
+        description: 'A drag narrows the Raman shift axis. Released past the baseline, it takes the intensity axis with it.',
+        gestures: [{ title: OVER_THE_CHART, shortcuts: ['Drag'] }],
+    },
+    boxTool: {
+        description: 'A drag zooms to exactly the rectangle it sweeps out, both axes at once — for looking into a baseline or a shoulder rather than across the spectrum.',
+    },
+    zoomIn: {
+        description: 'Brings the weak bands up, scaling the intensity axis about zero.',
+        gestures: [{ title: OVER_THE_CHART, shortcuts: ['Scroll wheel'] }],
+    },
+    zoomOut: {
+        gestures: [{ title: OVER_THE_CHART, shortcuts: ['Scroll wheel'] }],
+    },
+    togglePicking: {
+        description: 'Finds the bands of the selected spectrum, marks them on the chart and lists them.',
+    },
+};
+/** The command table of each technique. */
+const COMMAND_TABLES = {
+    infrared: irCommands,
+    raman: Object.fromEntries(Object.keys(irCommands)
+        .filter((id) => irCommandOffered('raman', id))
+        .map((id) => [id, { ...irCommands[id], ...RAMAN_WORDING[id] }])),
+};
+//# sourceMappingURL=irTechniqueCommands.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"irTechniqueCommands.js","sourceRoot":"","sources":["../../../src/ir/core/irTechniqueCommands.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAAsB,EACtB,EAAe;IAEf,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC7D,IAAI,EAAE,KAAK,YAAY;QAAE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACjD,IAAI,EAAE,KAAK,mBAAmB;QAAE,OAAO,WAAW,CAAC;IACnD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,SAAsB;IAClD,OAAO,cAAc,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;AAED,6DAA6D;AAC7D,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAExC,qEAAqE;AACrE,MAAM,aAAa,GAAqD;IACtE,KAAK,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE;IAC1C,aAAa,EAAE;QACb,WAAW,EAAE,4CAA4C;KAC1D;IACD,QAAQ,EAAE;QACR,WAAW,EACT,uGAAuG;QACzG,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;KAC3D;IACD,OAAO,EAAE;QACP,WAAW,EACT,qJAAqJ;KACxJ;IACD,MAAM,EAAE;QACN,WAAW,EACT,kEAAkE;QACpE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC;KACnE;IACD,OAAO,EAAE;QACP,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC;KACnE;IACD,aAAa,EAAE;QACb,WAAW,EACT,mFAAmF;KACtF;CACF,CAAC;AAEF,2CAA2C;AAC3C,MAAM,cAAc,GAAwC;IAC1D,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,MAAM,CAAC,WAAW,CACtB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAmB;SACvC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;SAC7C,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC,EAAE,GAAG,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAClE;CACF,CAAC"}