react-cheminfo 0.69.0 → 0.71.0

package/lib/host/core/connectHost.js

@@ -1,13 +1,15 @@
 /**
  * A tool's side of the host protocol: introduce itself to the page that
- * frames it, take the private port that page answers with, and serve what
- * arrives through it.
+ * frames it, take the private port that page answers with, serve what arrives
+ * through it, and send back what the host takes back.
  *
  * Free of React and of the DOM — the window is handed in — so a test drives the
  * whole exchange with a fake host and a real `MessageChannel`.
  */
-import { checkValue, isKnownKind, kindAccepts } from "./kinds.js";
+import { OUTPUT_DELAY, answerGet, createOutputPublisher, } from "./hostOutputs.js";
 import { HELLO_TYPE, PROTOCOL_VERSION, isConnect, parseRequest, } from "./protocol.js";
+import { selectInputs } from "./selectInputs.js";
+export { selectInputs } from "./selectInputs.js";
 /**
  * Say `hello` to the host, and serve its requests once it connects.
  *
@@ -15,22 +17,42 @@ import { HELLO_TYPE, PROTOCOL_VERSION, isConnect, parseRequest, } from "./protoc
  * one replaces the first — a host that reloads its own script connects again.
  * A document is applied once: the same one again is answered as before and
  * changes nothing, so a host re-sending it never overwrites the user's work.
+ * Requests are served one at a time, in order, so a `get` sent after a `load`
+ * reads what that load showed, however long it took.
  * @param options - The window, the tool, and its load function.
  * @returns The function that stops listening and closes the port.
  */
 export function connectHost(options) {
-    const { host, listen, tool, origin, build, load } = options;
+    const { host, listen, tool, origin, build, load, outputs } = options;
+    const { outputDelay = OUTPUT_DELAY } = options;
     let port = null;
     let appliedDocument = null;
     let appliedUsed = [];
+    let served = Promise.resolve();
+    const publisher = outputs === undefined
+        ? null
+        : createOutputPublisher(outputs, (message) => port?.postMessage(message), outputDelay);
+    const stopHearing = outputs?.subscribe(() => publisher?.changed());
     function serve(data) {
         const request = parseRequest(data);
         if (request === null)
             return;
-        const result = request.type === 'load' ? applyLoad(request) : answerGet(request, tool);
-        port?.postMessage(result);
+        served = served
+            .then(async () => {
+            const result = request.type === 'load'
+                ? await applyLoad(request)
+                : answerGet(request, tool, outputs);
+            port?.postMessage(result);
+        })
+            // A request that failed must not stop the ones after it being served,
+            // and must still be seen: it is thrown again, on its own.
+            .catch((error) => {
+            queueMicrotask(() => {
+                throw error;
+            });
+        });
     }
-    function applyLoad(request) {
+    async function applyLoad(request) {
         const { id, document, items } = request;
         if (document === appliedDocument) {
             return { type: 'result', id, ok: true, used: appliedUsed };
@@ -39,8 +61,11 @@ export function connectHost(options) {
         if (!selection.ok) {
             return { type: 'result', id, ok: false, error: selection.error };
         }
+        // An edit still settling belongs to the document on screen, which the
+        // outputs describe only until this one replaces it.
+        publisher?.flush();
         try {
-            load(selection.inputs);
+            await load(selection.inputs);
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
@@ -51,11 +76,15 @@ export function connectHost(options) {
                 error: { code: 'unreadable', message },
             };
         }
+        return applied(request, selection.inputs);
+    }
+    // Nothing else runs between a load's check and this: requests are served
+    // one at a time.
+    function applied(request, inputs) {
+        const { id, document, accept = [] } = request;
         appliedDocument = document;
-        appliedUsed = selection.inputs.map(({ key, item }) => ({
-            key,
-            kind: item.kind,
-        }));
+        appliedUsed = inputs.map(({ key, item }) => ({ key, kind: item.kind }));
+        publisher?.baseline(document, accept);
         return { type: 'result', id, ok: true, used: appliedUsed };
     }
     const stopListening = listen((event) => {
@@ -87,85 +116,10 @@ export function connectHost(options) {
     host.postMessage(hello, '*');
     return () => {
         stopListening();
+        stopHearing?.();
+        publisher?.stop();
         port?.close();
         port = null;
     };
 }
-/**
- * Give each input of the tool one item of a request.
- *
- * Each input tries its kinds in its own order of preference, and takes the
- * first item that falls under one and passes that kind's schema: the tool
- * knows which notation serves it best, whatever order the host listed them in.
- * An item naming another input's `key` is left to that input.
- * @param tool - What the tool takes.
- * @param items - What the host sent.
- * @returns One item per input, or why an input got none.
- */
-export function selectInputs(tool, items) {
-    const inputs = [];
-    for (const input of tool.inputs) {
-        const errors = [];
-        const loaded = selectInput(input, items, errors);
-        if (loaded !== null) {
-            inputs.push(loaded);
-            continue;
-        }
-        if (errors.length > 0) {
-            return {
-                ok: false,
-                error: {
-                    code: 'invalid',
-                    message: `No item for ${input.key} has the shape its kind requires, so ${tool.name} loaded nothing.`,
-                    errors,
-                },
-            };
-        }
-        return {
-            ok: false,
-            error: {
-                code: 'no-input',
-                message: `No item is a ${KIND_LIST.format(input.kinds)}, so ${tool.name} loaded nothing.`,
-            },
-        };
-    }
-    return { ok: true, inputs };
-}
-function selectInput(input, items, errors) {
-    for (const accepted of input.kinds) {
-        if (!isKnownKind(accepted))
-            continue;
-        for (const item of items) {
-            if (item.key !== undefined && item.key !== input.key)
-                continue;
-            if (!kindAccepts(accepted, item.kind))
-                continue;
-            const loaded = checkItem(input.key, accepted, item, errors);
-            if (loaded !== null)
-                return loaded;
-        }
-    }
-    return null;
-}
-function checkItem(key, accepted, item, errors) {
-    const outcome = checkValue(accepted, item.value);
-    if (outcome.valid)
-        return { key, item, checked: outcome.checked };
-    for (const error of outcome.errors)
-        errors.push(`${item.kind} ${error}`);
-    return null;
-}
-function answerGet(request, tool) {
-    // Nothing goes back yet: no tool declares an output.
-    return {
-        type: 'result',
-        id: request.id,
-        ok: false,
-        error: {
-            code: 'no-output',
-            message: `${tool.name} has nothing to give back yet.`,
-        },
-    };
-}
-const KIND_LIST = new Intl.ListFormat('en', { type: 'disjunction' });
 //# sourceMappingURL=connectHost.js.map

package/lib/host/core/connectHost.js.map

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

package/lib/host/core/hostOutputs.d.ts

@@ -0,0 +1,58 @@
+/**
+ * What a tool hands back: the values a `get` asks for, and the `output` it
+ * sends when a value the host accepted changes.
+ *
+ * An `output` carries only what changed, item by item, against what the host
+ * already has: the values as they stood once its document was applied, then
+ * every value sent since. Opening a document therefore never writes it back,
+ * and a band picked on one spectrum of a sample leaves the others alone.
+ */
+import type { GetRequest, HostItem, OutputMessage, ResultMessage, ToolInterface } from './protocol.ts';
+/** Where a tool's outputs are read, and how their changes are heard. */
+export interface HostOutputs {
+    /**
+     * The value of every output now, one item each, carrying its `key` and the
+     * `id` of the item it was made from. It must already show a document once
+     * `load` has returned, or the host is sent back what it just loaded.
+     */
+    read: () => readonly HostItem[];
+    /** Be told whenever they may have changed; the returned function stops it. */
+    subscribe: (listener: () => void) => () => void;
+}
+/**
+ * How long the outputs must stay still before a change is sent, in
+ * milliseconds: a burst of edits is one message.
+ */
+export declare const OUTPUT_DELAY = 300;
+/**
+ * Answer a `get` with the values it asks for — every output when it names
+ * none.
+ * @param request - The request.
+ * @param tool - What the tool hands back.
+ * @param outputs - Where the values are read, if anywhere.
+ * @returns The values, or `no-output` when the tool has none of those asked.
+ */
+export declare function answerGet(request: GetRequest, tool: ToolInterface, outputs: HostOutputs | undefined): ResultMessage;
+/** What the connection tells the publisher, and the means to stop it. */
+export interface OutputPublisher {
+    /** A document was applied: what the host has is what the tool now shows. */
+    baseline: (document: string, accept: readonly string[]) => void;
+    /** The outputs may have changed. */
+    changed: () => void;
+    /**
+     * Send what changed now rather than once it settles: another document is
+     * about to replace what the outputs are read from.
+     */
+    flush: () => void;
+    /** Send nothing more. */
+    stop: () => void;
+}
+/**
+ * Send the host what changed of the outputs it accepted, once they settle.
+ * @param outputs - Where the values are read.
+ * @param send - Posts a message to the host, when there is one.
+ * @param delay - How long the values must stay still, in milliseconds.
+ * @returns The publisher.
+ */
+export declare function createOutputPublisher(outputs: HostOutputs, send: (message: OutputMessage) => void, delay: number): OutputPublisher;
+//# sourceMappingURL=hostOutputs.d.ts.map

package/lib/host/core/hostOutputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostOutputs.d.ts","sourceRoot":"","sources":["../../../src/host/core/hostOutputs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,aAAa,EACb,aAAa,EACb,aAAa,EACd,MAAM,eAAe,CAAC;AAEvB,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,IAAI,EAAE,MAAM,SAAS,QAAQ,EAAE,CAAC;IAChC,8EAA8E;IAC9E,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACjD;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,WAAW,GAAG,SAAS,GAC/B,aAAa,CAsBf;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAChE,oCAAoC;IACpC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;OAGG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,yBAAyB;IACzB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,EACtC,KAAK,EAAE,MAAM,GACZ,eAAe,CA4CjB"}

package/lib/host/core/hostOutputs.js

@@ -0,0 +1,151 @@
+/**
+ * What a tool hands back: the values a `get` asks for, and the `output` it
+ * sends when a value the host accepted changes.
+ *
+ * An `output` carries only what changed, item by item, against what the host
+ * already has: the values as they stood once its document was applied, then
+ * every value sent since. Opening a document therefore never writes it back,
+ * and a band picked on one spectrum of a sample leaves the others alone.
+ */
+import { kindAccepts } from "./kinds.js";
+/**
+ * How long the outputs must stay still before a change is sent, in
+ * milliseconds: a burst of edits is one message.
+ */
+export const OUTPUT_DELAY = 300;
+/**
+ * Answer a `get` with the values it asks for — every output when it names
+ * none.
+ * @param request - The request.
+ * @param tool - What the tool hands back.
+ * @param outputs - Where the values are read, if anywhere.
+ * @returns The values, or `no-output` when the tool has none of those asked.
+ */
+export function answerGet(request, tool, outputs) {
+    const { id, keys } = request;
+    const declared = new Set();
+    for (const output of tool.outputs)
+        declared.add(output.key);
+    if (outputs === undefined || declared.size === 0) {
+        return noOutput(id, `${tool.name} has nothing to give back yet.`);
+    }
+    const wanted = keys.length === 0 ? declared : new Set();
+    for (const key of keys) {
+        if (declared.has(key))
+            wanted.add(key);
+    }
+    if (wanted.size === 0) {
+        return noOutput(id, `${tool.name} has no output called ${LIST.format(keys)}.`);
+    }
+    const items = [];
+    for (const item of outputs.read()) {
+        if (item.key !== undefined && wanted.has(item.key))
+            items.push(item);
+    }
+    return { type: 'result', id, ok: true, items };
+}
+/**
+ * Send the host what changed of the outputs it accepted, once they settle.
+ * @param outputs - Where the values are read.
+ * @param send - Posts a message to the host, when there is one.
+ * @param delay - How long the values must stay still, in milliseconds.
+ * @returns The publisher.
+ */
+export function createOutputPublisher(outputs, send, delay) {
+    let document = null;
+    let accepted = new Set();
+    let known = new Map();
+    let timer;
+    function flush() {
+        timer = undefined;
+        if (document === null)
+            return;
+        const items = [];
+        for (const [identity, entry] of readAccepted(outputs, accepted)) {
+            if (known.get(identity) === entry.text)
+                continue;
+            known.set(identity, entry.text);
+            items.push(entry.item);
+        }
+        if (items.length > 0)
+            send({ type: 'output', document, items });
+    }
+    function stop() {
+        clearTimeout(timer);
+        timer = undefined;
+    }
+    return {
+        baseline(next, accept) {
+            stop();
+            document = next;
+            accepted = new Set(accept);
+            known = new Map();
+            for (const [identity, entry] of readAccepted(outputs, accepted)) {
+                known.set(identity, entry.text);
+            }
+        },
+        changed() {
+            if (document === null || accepted.size === 0)
+                return;
+            stop();
+            timer = setTimeout(flush, delay);
+        },
+        flush() {
+            stop();
+            flush();
+        },
+        stop,
+    };
+}
+/**
+ * The accepted items, each under an identity that survives a re-read: its
+ * key, the id of the item it was made from, and its rank among items sharing
+ * both.
+ * @param outputs - Where the values are read.
+ * @param accepted - The keys and kinds the host takes back.
+ * @returns Each item with its value as text, by identity.
+ */
+function readAccepted(outputs, accepted) {
+    const entries = new Map();
+    if (accepted.size === 0)
+        return entries;
+    for (const item of outputs.read()) {
+        if (!isAccepted(item, accepted))
+            continue;
+        const base = `${item.key ?? item.kind}\n${item.id ?? ''}`;
+        let rank = 0;
+        while (entries.has(`${base}\n${rank}`))
+            rank++;
+        entries.set(`${base}\n${rank}`, {
+            item,
+            text: JSON.stringify(item.value),
+        });
+    }
+    return entries;
+}
+/**
+ * Whether the host takes an item back: `accept` names its output's key, or
+ * its kind — a kind taking every kind under it, as an input's does.
+ * @param item - The item.
+ * @param accepted - What the host takes back.
+ * @returns Whether it goes back.
+ */
+function isAccepted(item, accepted) {
+    if (item.key !== undefined && accepted.has(item.key))
+        return true;
+    for (const name of accepted) {
+        if (kindAccepts(name, item.kind))
+            return true;
+    }
+    return false;
+}
+function noOutput(id, message) {
+    return {
+        type: 'result',
+        id,
+        ok: false,
+        error: { code: 'no-output', message },
+    };
+}
+const LIST = new Intl.ListFormat('en', { type: 'disjunction' });
+//# sourceMappingURL=hostOutputs.js.map

package/lib/host/core/hostOutputs.js.map

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

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

@@ -1,9 +1,15 @@
-export type { HostConnectionOptions, HostMessageEvent, InputSelection, LoadedInput, } from './connectHost.ts';
-export { connectHost, selectInputs } from './connectHost.ts';
+export type { HostConnectionOptions, HostMessageEvent } from './connectHost.ts';
+export { connectHost } from './connectHost.ts';
+export type { HostOutputs, OutputPublisher } from './hostOutputs.ts';
+export { OUTPUT_DELAY, answerGet, createOutputPublisher, } from './hostOutputs.ts';
 export type { StructureValue } from './hostStructure.ts';
 export { STRUCTURE_KINDS, hostStructureLoader, hostStructureSource, readHostMolecule, } from './hostStructure.ts';
+export type { IrJdxValue, IrPeakValue, IrPeaksValue } from './irKinds.ts';
+export { IR_JDX_SCHEMA, IR_PEAKS_SCHEMA } from './irKinds.ts';
 export type { CheckOutcome, CheckedValue, KnownKind, MolfileValue, OclIdValue, SmilesValue, } from './kinds.ts';
 export { checkValue, isKnownKind, kindAccepts } from './kinds.ts';
-export type { GetRequest, HelloMessage, HostError, HostErrorCode, HostItem, HostRequest, LoadRequest, ResultMessage, ToolInput, ToolInterface, ToolOutput, UsedItem, } from './protocol.ts';
+export type { GetRequest, HelloMessage, HostError, HostErrorCode, HostItem, HostRequest, LoadRequest, OutputMessage, ResultMessage, ToolInput, ToolInterface, ToolOutput, UsedItem, } from './protocol.ts';
 export { CONNECT_TYPE, HELLO_TYPE, MAX_ITEMS, MAX_LABEL_LENGTH, PROTOCOL_VERSION, isConnect, parseRequest, } from './protocol.ts';
+export type { InputSelection, LoadedInput } from './selectInputs.ts';
+export { selectInputs } from './selectInputs.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EACV,UAAU,EACV,YAAY,EACZ,SAAS,EACT,aAAa,EACb,QAAQ,EACR,WAAW,EACX,WAAW,EACX,aAAa,EACb,SAAS,EACT,aAAa,EACb,UAAU,EACV,QAAQ,GACT,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,YAAY,EACZ,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,YAAY,GACb,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACL,YAAY,EACZ,SAAS,EACT,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC9D,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EACV,UAAU,EACV,YAAY,EACZ,SAAS,EACT,aAAa,EACb,QAAQ,EACR,WAAW,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,SAAS,EACT,aAAa,EACb,UAAU,EACV,QAAQ,GACT,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,YAAY,EACZ,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/host/core/index.js

@@ -1,5 +1,8 @@
-export { connectHost, selectInputs } from "./connectHost.js";
+export { connectHost } from "./connectHost.js";
+export { OUTPUT_DELAY, answerGet, createOutputPublisher, } from "./hostOutputs.js";
 export { STRUCTURE_KINDS, hostStructureLoader, hostStructureSource, readHostMolecule, } from "./hostStructure.js";
+export { IR_JDX_SCHEMA, IR_PEAKS_SCHEMA } from "./irKinds.js";
 export { checkValue, isKnownKind, kindAccepts } from "./kinds.js";
 export { CONNECT_TYPE, HELLO_TYPE, MAX_ITEMS, MAX_LABEL_LENGTH, PROTOCOL_VERSION, isConnect, parseRequest, } from "./protocol.js";
+export { selectInputs } from "./selectInputs.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/host/core/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAS5B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAelE,OAAO,EACL,YAAY,EACZ,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,YAAY,GACb,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/host/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EACL,YAAY,EACZ,SAAS,EACT,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAS9D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgBlE,OAAO,EACL,YAAY,EACZ,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/host/core/irKinds.d.ts

@@ -0,0 +1,124 @@
+/**
+ * The kinds a measured infrared spectrum travels as: the JCAMP-DX a notebook
+ * keeps with the bands picked on it, and those bands alone, which is what a
+ * tool hands back.
+ *
+ * Shaped on what SciPeaks keeps for a sample's infrared spectrum — a JCAMP-DX
+ * attachment and a `peak` list beside it — with the text of the attachment in
+ * place of its address, since a tool framed from another origin cannot fetch
+ * what the notebook serves its own pages. A band is written the way SciPeaks
+ * and `ir-spectrum` write one, so what a tool hands back can be stored as it
+ * arrives.
+ *
+ * Named after pipeline's `spectra.nmr.1d.jdx`. Pipeline's own `spectra.ir` is
+ * a computed spectrum — normal modes, not a measurement — and is not one of the
+ * kinds read here.
+ */
+/** One band of an infrared spectrum, as SciPeaks and `ir-spectrum` write it. */
+export interface IrPeakValue {
+    /** Where it sits, in cm⁻¹. */
+    wavenumber: number;
+    /**
+     * Its absorbance.
+     * @default read off the spectrum
+     */
+    absorbance?: number;
+    /**
+     * Its transmittance, as a fraction between 0 and 1 — not a percentage.
+     * @default read off the spectrum
+     */
+    transmittance?: number;
+    /**
+     * How strong it is: `w` weak, `m` medium, `S` strong. Any other letter is
+     * worked out again from the spectrum.
+     * @default worked out from the spectrum
+     */
+    kind?: string;
+}
+/** `spectra.ir.jdx`: a measured infrared spectrum and the bands picked on it. */
+export interface IrJdxValue {
+    /** The JCAMP-DX, as text. */
+    jdx: string;
+    /**
+     * The name the notebook keeps it under, e.g. `spectra/ir/sample.jdx`.
+     * @default undefined
+     */
+    filename?: string;
+    /**
+     * The bands picked on it. Absent or empty, the tool picks them itself.
+     * @default undefined
+     */
+    peaks?: IrPeakValue[];
+}
+/** `spectra.ir.peaks`: the bands picked on an infrared spectrum, alone. */
+export interface IrPeaksValue {
+    /** The bands, ascending by wavenumber. */
+    peaks: IrPeakValue[];
+}
+/** The schema of `spectra.ir.jdx`. */
+export declare const IR_JDX_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly jdx: {
+            readonly type: "string";
+        };
+        readonly filename: {
+            readonly type: "string";
+        };
+        readonly peaks: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly wavenumber: {
+                        readonly type: "number";
+                    };
+                    readonly absorbance: {
+                        readonly type: "number";
+                    };
+                    readonly transmittance: {
+                        readonly type: "number";
+                    };
+                    readonly kind: {
+                        readonly type: "string";
+                    };
+                };
+                readonly required: readonly ["wavenumber"];
+                readonly additionalProperties: false;
+            };
+        };
+    };
+    readonly required: readonly ["jdx"];
+    readonly additionalProperties: false;
+};
+/** The schema of `spectra.ir.peaks`. */
+export declare const IR_PEAKS_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly peaks: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly wavenumber: {
+                        readonly type: "number";
+                    };
+                    readonly absorbance: {
+                        readonly type: "number";
+                    };
+                    readonly transmittance: {
+                        readonly type: "number";
+                    };
+                    readonly kind: {
+                        readonly type: "string";
+                    };
+                };
+                readonly required: readonly ["wavenumber"];
+                readonly additionalProperties: false;
+            };
+        };
+    };
+    readonly required: readonly ["peaks"];
+    readonly additionalProperties: false;
+};
+//# sourceMappingURL=irKinds.d.ts.map

package/lib/host/core/irKinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"irKinds.d.ts","sourceRoot":"","sources":["../../../src/host/core/irKinds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAcD,sCAAsC;AACtC,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAShB,CAAC;AAEX,wCAAwC;AACxC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKlB,CAAC"}

package/lib/host/core/irKinds.js

@@ -0,0 +1,46 @@
+/**
+ * The kinds a measured infrared spectrum travels as: the JCAMP-DX a notebook
+ * keeps with the bands picked on it, and those bands alone, which is what a
+ * tool hands back.
+ *
+ * Shaped on what SciPeaks keeps for a sample's infrared spectrum — a JCAMP-DX
+ * attachment and a `peak` list beside it — with the text of the attachment in
+ * place of its address, since a tool framed from another origin cannot fetch
+ * what the notebook serves its own pages. A band is written the way SciPeaks
+ * and `ir-spectrum` write one, so what a tool hands back can be stored as it
+ * arrives.
+ *
+ * Named after pipeline's `spectra.nmr.1d.jdx`. Pipeline's own `spectra.ir` is
+ * a computed spectrum — normal modes, not a measurement — and is not one of the
+ * kinds read here.
+ */
+const IR_PEAK_SCHEMA = {
+    type: 'object',
+    properties: {
+        wavenumber: { type: 'number' },
+        absorbance: { type: 'number' },
+        transmittance: { type: 'number' },
+        kind: { type: 'string' },
+    },
+    required: ['wavenumber'],
+    additionalProperties: false,
+};
+/** The schema of `spectra.ir.jdx`. */
+export const IR_JDX_SCHEMA = {
+    type: 'object',
+    properties: {
+        jdx: { type: 'string' },
+        filename: { type: 'string' },
+        peaks: { type: 'array', items: IR_PEAK_SCHEMA },
+    },
+    required: ['jdx'],
+    additionalProperties: false,
+};
+/** The schema of `spectra.ir.peaks`. */
+export const IR_PEAKS_SCHEMA = {
+    type: 'object',
+    properties: { peaks: { type: 'array', items: IR_PEAK_SCHEMA } },
+    required: ['peaks'],
+    additionalProperties: false,
+};
+//# sourceMappingURL=irKinds.js.map

package/lib/host/core/irKinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"irKinds.js","sourceRoot":"","sources":["../../../src/host/core/irKinds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA8CH,MAAM,cAAc,GAAG;IACrB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACjC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACzB;IACD,QAAQ,EAAE,CAAC,YAAY,CAAC;IACxB,oBAAoB,EAAE,KAAK;CACnB,CAAC;AAEX,sCAAsC;AACtC,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACvB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE;KAChD;IACD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,oBAAoB,EAAE,KAAK;CACnB,CAAC;AAEX,wCAAwC;AACxC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;IAC/D,QAAQ,EAAE,CAAC,OAAO,CAAC;IACnB,oBAAoB,EAAE,KAAK;CACnB,CAAC"}