react-cheminfo 0.70.0 → 0.71.0

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

@@ -4,12 +4,14 @@
  * name, a JSON Schema, and ajv.
  *
  * The names are pipeline's (`chem.molfile.2d`, `chem.ocl.id`…), plus
- * `chem.smiles`, which pipeline lists among its future schemas. A name with
- * children is a category whose schema every child satisfies, so `chem.molfile`
- * reads `chem.molfile.2d` and `chem.molfile.3d.h.energy` alike; the fields a
- * tool does not read are stripped rather than refused, so a host sending more
- * than it needs to is never turned away.
+ * `chem.smiles`, which pipeline lists among its future schemas, and the two
+ * infrared kinds of `./irKinds.ts`. A name with children is a category whose
+ * schema every child satisfies, so `chem.molfile` reads `chem.molfile.2d` and
+ * `chem.molfile.3d.h.energy` alike; the fields a tool does not read are
+ * stripped rather than refused, so a host sending more than it needs to is
+ * never turned away.
  */
+import type { IrJdxValue, IrPeaksValue } from './irKinds.ts';
 /** A molfile, V2000 or V3000. */
 export interface MolfileValue {
     molfile: string;
@@ -33,6 +35,12 @@ export type CheckedValue = {
 } | {
     kind: 'chem.smiles';
     value: SmilesValue;
+} | {
+    kind: 'spectra.ir.jdx';
+    value: IrJdxValue;
+} | {
+    kind: 'spectra.ir.peaks';
+    value: IrPeaksValue;
 };
 /** The name of a kind a tool can read. */
 export type KnownKind = CheckedValue['kind'];

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

@@ -1 +1 @@
-{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../../../src/host/core/kinds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,gBAAgB;AAChB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oEAAoE;AACpE,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC;AAEhD,0CAA0C;AAC1C,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAK7C,kCAAkC;AAClC,MAAM,MAAM,YAAY,GACtB;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAMtE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAE3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY,CAWxE"}
+{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../../../src/host/core/kinds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG7D,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,gBAAgB;AAChB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oEAAoE;AACpE,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAAC;AAEtD,0CAA0C;AAC1C,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAK7C,kCAAkC;AAClC,MAAM,MAAM,YAAY,GACtB;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAMtE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAE3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY,CAWxE"}

package/lib/host/core/kinds.js

@@ -4,13 +4,15 @@
  * name, a JSON Schema, and ajv.
  *
  * The names are pipeline's (`chem.molfile.2d`, `chem.ocl.id`…), plus
- * `chem.smiles`, which pipeline lists among its future schemas. A name with
- * children is a category whose schema every child satisfies, so `chem.molfile`
- * reads `chem.molfile.2d` and `chem.molfile.3d.h.energy` alike; the fields a
- * tool does not read are stripped rather than refused, so a host sending more
- * than it needs to is never turned away.
+ * `chem.smiles`, which pipeline lists among its future schemas, and the two
+ * infrared kinds of `./irKinds.ts`. A name with children is a category whose
+ * schema every child satisfies, so `chem.molfile` reads `chem.molfile.2d` and
+ * `chem.molfile.3d.h.energy` alike; the fields a tool does not read are
+ * stripped rather than refused, so a host sending more than it needs to is
+ * never turned away.
  */
 import { Ajv } from 'ajv';
+import { IR_JDX_SCHEMA, IR_PEAKS_SCHEMA } from "./irKinds.js";
 /**
  * Whether a kind falls under another: the same name, or a name under it on a
  * segment boundary. A list (`…[]`) never stands for one value, nor one value
@@ -84,5 +86,9 @@ const VALIDATORS = {
     'chem.molfile': ajv.compile(MOLFILE_SCHEMA),
     'chem.ocl.id': ajv.compile(OCL_ID_SCHEMA),
     'chem.smiles': ajv.compile(SMILES_SCHEMA),
+    // Written as plain schemas rather than `JSONSchemaType`, which would demand
+    // `nullable` on every optional field and so let a `null` band through.
+    'spectra.ir.jdx': ajv.compile(IR_JDX_SCHEMA),
+    'spectra.ir.peaks': ajv.compile(IR_PEAKS_SCHEMA),
 };
 //# sourceMappingURL=kinds.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"kinds.js","sourceRoot":"","sources":["../../../src/host/core/kinds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAkC1B;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,OAAe;IAC3D,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACnD,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,IAAe,EAAE,KAAc;IACxD,MAAM,QAAQ,GAAqB,UAAU,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,iEAAiE;QACjE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAkB,EAAE,CAAC;IACnE,CAAC;IACD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,YAAY,IAAI,GAAG,KAAK,KAAK,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,cAAc,GAAiC;IACnD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAC3C,QAAQ,EAAE,CAAC,SAAS,CAAC;IACrB,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAEF,MAAM,aAAa,GAA+B;IAChD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAChC;IACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC;IACnC,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAEF,MAAM,aAAa,GAAgC;IACjD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAC1C,QAAQ,EAAE,CAAC,QAAQ,CAAC;IACpB,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAEF,6EAA6E;AAC7E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;AAEhD,MAAM,UAAU,GAAuD;IACrE,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC;IAC3C,aAAa,EAAE,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC;IACzC,aAAa,EAAE,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC;CAC1C,CAAC"}
+{"version":3,"file":"kinds.js","sourceRoot":"","sources":["../../../src/host/core/kinds.ts"],"names":[],"mappings":"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"}

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

@@ -4,9 +4,10 @@
  *
  * Two messages travel between the windows — `hello`, from the tool, and
  * `connect`, the host's answer carrying a private `MessagePort` — and everything
- * else goes through that port: the host's requests (`load`, `get`) and the
- * tool's `result` for each. This module only spells the messages, and reads
- * what arrives as the untrusted input it is.
+ * else goes through that port: the host's requests (`load`, `get`), the tool's
+ * `result` for each, and the `output` the tool sends when a value the host
+ * takes back changes. This module only spells the messages, and reads what
+ * arrives as the untrusted input it is.
  */
 /** The version a tool speaks; a `connect` naming another is ignored. */
 export declare const PROTOCOL_VERSION = 1;
@@ -45,8 +46,23 @@ export interface ToolInput {
     key: string;
     /** Kinds in order of preference; a category accepts every kind under it. */
     kinds: readonly string[];
+    /**
+     * Whether it takes every item of its kinds, in the host's order, rather than
+     * the one it prefers — every spectrum of a sample.
+     * @default false
+     */
+    many?: boolean;
+    /**
+     * Whether a request may leave it without an item. A request is still
+     * refused when no input at all gets one.
+     * @default false
+     */
+    optional?: boolean;
 }
-/** One value the tool can hand back. */
+/**
+ * One value the tool can hand back: answered to `get`, and sent as `output`
+ * whenever it changes, when the host accepted it.
+ */
 export interface ToolOutput {
     key: string;
     kind: string;
@@ -75,6 +91,13 @@ export interface LoadRequest {
     /** What the data belongs to; the same document twice is applied once. */
     document: string;
     items: HostItem[];
+    /**
+     * The outputs the host takes back for this document, by key or by kind — a
+     * kind taking every kind under it: the tool sends an `output` whenever one
+     * of their values changes.
+     * @default undefined — nothing is sent unasked
+     */
+    accept?: string[];
 }
 /** `get`: the current value of some outputs. */
 export interface GetRequest {
@@ -102,25 +125,45 @@ export interface UsedItem {
     key: string;
     kind: string;
 }
-/** The answer to one request, carrying its `id`. */
+/**
+ * The answer to one request, carrying its `id`: which items a `load` used, or
+ * the values a `get` asked for.
+ */
 export type ResultMessage = {
     type: 'result';
     id: string;
     ok: true;
     used: UsedItem[];
+} | {
+    type: 'result';
+    id: string;
+    ok: true;
+    items: HostItem[];
 } | {
     type: 'result';
     id: string;
     ok: false;
     error: HostError;
 };
+/**
+ * Sent by the tool, unasked, when values the host accepted have changed — the
+ * user picked a band. It carries only the items that changed: one missing is
+ * unchanged, never deleted.
+ */
+export interface OutputMessage {
+    type: 'output';
+    /** The document the values belong to, as the host's `load` named it. */
+    document: string;
+    /** Each with its `key`, and the `id` of the item it was made from. */
+    items: HostItem[];
+}
 /**
  * Read a message that arrived through the port.
  *
  * Anything that is not a well-formed `load` or `get` is `null`, and goes
  * unanswered: an unknown request is a newer host talking, not an error. An item
- * without a string `kind` is dropped, and a label is cut to
- * {@link MAX_LABEL_LENGTH}.
+ * without a string `kind` is dropped, a label is cut to
+ * {@link MAX_LABEL_LENGTH}, and a `load` without `accept` takes nothing back.
  * @param data - What the port delivered.
  * @returns The request, or `null`.
  */

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

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

package/lib/host/core/protocol.js

@@ -4,9 +4,10 @@
  *
  * Two messages travel between the windows — `hello`, from the tool, and
  * `connect`, the host's answer carrying a private `MessagePort` — and everything
- * else goes through that port: the host's requests (`load`, `get`) and the
- * tool's `result` for each. This module only spells the messages, and reads
- * what arrives as the untrusted input it is.
+ * else goes through that port: the host's requests (`load`, `get`), the tool's
+ * `result` for each, and the `output` the tool sends when a value the host
+ * takes back changes. This module only spells the messages, and reads what
+ * arrives as the untrusted input it is.
  */
 /** The version a tool speaks; a `connect` naming another is ignored. */
 export const PROTOCOL_VERSION = 1;
@@ -23,8 +24,8 @@ export const MAX_LABEL_LENGTH = 80;
  *
  * Anything that is not a well-formed `load` or `get` is `null`, and goes
  * unanswered: an unknown request is a newer host talking, not an error. An item
- * without a string `kind` is dropped, and a label is cut to
- * {@link MAX_LABEL_LENGTH}.
+ * without a string `kind` is dropped, a label is cut to
+ * {@link MAX_LABEL_LENGTH}, and a `load` without `accept` takes nothing back.
  * @param data - What the port delivered.
  * @returns The request, or `null`.
  */
@@ -35,12 +36,15 @@ export function parseRequest(data) {
         if (typeof data.document !== 'string' || !Array.isArray(data.items)) {
             return null;
         }
-        return {
+        const load = {
             type: 'load',
             id: data.id,
             document: data.document,
             items: readItems(data.items),
         };
+        if (Array.isArray(data.accept))
+            load.accept = readStrings(data.accept);
+        return load;
     }
     if (data.type === 'get') {
         return { type: 'get', id: data.id, keys: readStrings(data.keys) };

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * Which items of a request each input of a tool takes, and the sentence a
+ * host is answered with when the request loads nothing.
+ */
+import type { CheckedValue } from './kinds.ts';
+import type { HostError, HostItem, ToolInterface } from './protocol.ts';
+/** The item an input took, and its value as the input's kind reads it. */
+export interface LoadedInput {
+    key: string;
+    item: HostItem;
+    checked: CheckedValue;
+}
+/** What choosing the items of a request gave. */
+export type InputSelection = {
+    ok: true;
+    inputs: LoadedInput[];
+} | {
+    ok: false;
+    error: HostError;
+};
+/**
+ * Give each input of the tool the items of a request it takes.
+ *
+ * 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 input taking `many` takes every such item instead, in the host's order.
+ * An item naming another input's `key` is left to that input.
+ *
+ * A required input left without an item refuses the request. An optional one
+ * is passed over, unless no input got an item at all.
+ * @param tool - What the tool takes.
+ * @param items - What the host sent.
+ * @returns The items the inputs took, or why the request loads nothing.
+ */
+export declare function selectInputs(tool: ToolInterface, items: readonly HostItem[]): InputSelection;
+//# sourceMappingURL=selectInputs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selectInputs.d.ts","sourceRoot":"","sources":["../../../src/host/core/selectInputs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,YAAY,CAAC;AAE1D,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EAER,aAAa,EACd,MAAM,eAAe,CAAC;AAEvB,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,iDAAiD;AACjD,MAAM,MAAM,cAAc,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAExE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,SAAS,QAAQ,EAAE,GACzB,cAAc,CAoBhB"}

package/lib/host/core/selectInputs.js

@@ -0,0 +1,110 @@
+/**
+ * Which items of a request each input of a tool takes, and the sentence a
+ * host is answered with when the request loads nothing.
+ */
+import { checkValue, isKnownKind, kindAccepts } from "./kinds.js";
+/**
+ * Give each input of the tool the items of a request it takes.
+ *
+ * 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 input taking `many` takes every such item instead, in the host's order.
+ * An item naming another input's `key` is left to that input.
+ *
+ * A required input left without an item refuses the request. An optional one
+ * is passed over, unless no input got an item at all.
+ * @param tool - What the tool takes.
+ * @param items - What the host sent.
+ * @returns The items the inputs took, or why the request loads nothing.
+ */
+export function selectInputs(tool, items) {
+    const inputs = [];
+    const passedOver = [];
+    for (const input of tool.inputs) {
+        const errors = [];
+        const taken = input.many
+            ? selectEvery(input, items, errors)
+            : selectFirst(input, items, errors);
+        if (taken.length > 0) {
+            inputs.push(...taken);
+        }
+        else if (input.optional) {
+            passedOver.push(...errors);
+        }
+        else {
+            return { ok: false, error: refusal(tool, [input], errors) };
+        }
+    }
+    if (inputs.length > 0 || tool.inputs.length === 0) {
+        return { ok: true, inputs };
+    }
+    return { ok: false, error: refusal(tool, tool.inputs, passedOver) };
+}
+function selectFirst(input, items, errors) {
+    for (const accepted of input.kinds) {
+        if (!isKnownKind(accepted))
+            continue;
+        for (const item of items) {
+            if (!isFor(input, accepted, item))
+                continue;
+            const loaded = checkItem(input.key, accepted, item, errors);
+            if (loaded !== null)
+                return [loaded];
+        }
+    }
+    return [];
+}
+function selectEvery(input, items, errors) {
+    const taken = [];
+    for (const item of items) {
+        for (const accepted of input.kinds) {
+            if (!isKnownKind(accepted) || !isFor(input, accepted, item))
+                continue;
+            const loaded = checkItem(input.key, accepted, item, errors);
+            if (loaded === null)
+                continue;
+            taken.push(loaded);
+            break;
+        }
+    }
+    return taken;
+}
+function isFor(input, accepted, item) {
+    if (item.key !== undefined && item.key !== input.key)
+        return false;
+    return kindAccepts(accepted, item.kind);
+}
+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;
+}
+/**
+ * Why a request loads nothing: some item had the wrong shape, or no item was
+ * of a kind the inputs take.
+ * @param tool - What the tool takes.
+ * @param inputs - The inputs left without an item.
+ * @param errors - What the schemas found.
+ * @returns The error the host is answered with.
+ */
+function refusal(tool, inputs, errors) {
+    if (errors.length > 0) {
+        const keys = inputs.map((input) => input.key);
+        return {
+            code: 'invalid',
+            message: `No item for ${LIST.format(keys)} has the shape its kind requires, so ${tool.name} loaded nothing.`,
+            errors,
+        };
+    }
+    const kinds = inputs.flatMap((input) => input.kinds);
+    return {
+        code: 'no-input',
+        message: `No item is a ${LIST.format(kinds)}, so ${tool.name} loaded nothing.`,
+    };
+}
+const LIST = new Intl.ListFormat('en', { type: 'disjunction' });
+//# sourceMappingURL=selectInputs.js.map

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

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

package/lib/host/testing/sciPeaks.d.ts

@@ -8,6 +8,10 @@
  * The sample is a real one, and so are its quirks: its molfile is V2000 with
  * every atom at the origin, its title is blank so the label is its first name,
  * and its formula travels as a kind no structure input reads.
+ *
+ * Its infrared spectrum is pinned here before the tool tab sends it: the bands
+ * are the sample's own, and the message is the one visualizer-helper's `ir`
+ * reader has to write.
  */
 import type { LoadRequest } from '../core/protocol.ts';
 /** How SciPeaks' tool tab introduces itself in `connect`. */
@@ -18,4 +22,31 @@ export declare const SCIPEAKS_ETHYLBENZENE_MOLFILE: string;
 export declare const SCIPEAKS_ETHYLBENZENE_LOAD: LoadRequest & {
     accept: string[];
 };
+/** Where SciPeaks keeps that sample's infrared spectrum: its attachment. */
+export declare const SCIPEAKS_ETHYLBENZENE_IR_FILENAME = "spectra/ir/spectra_ir_100-41-4-IR.jdx";
+/**
+ * The bands SciPeaks keeps for that spectrum, as stored: out of wavenumber
+ * order, a transmittance that is a fraction, and the visualizer's `_highlight`.
+ */
+export declare const SCIPEAKS_ETHYLBENZENE_IR_PEAKS: {
+    wavenumber: number;
+    absorbance: number;
+    transmittance: number;
+    kind: string;
+    _highlight: number;
+}[];
+/**
+ * The `load` the tool tab is to send that sample to a site that reads
+ * infrared spectra and hands their bands back, once its `ir` reader and its
+ * `save` exist: the structure as it is sent today, one `spectra.ir.jdx` item
+ * per spectrum — the attachment's text, its name and its bands, under the
+ * attachment's name as `id` — and `accept` naming the kind saved back, as
+ * the tool tab's `save` names it.
+ * @param jdx - The attachment's text, which SciPeaks serves at its `dUrl`.
+ * @returns The request, its bands copied so that reading them cannot strip
+ * this module's own.
+ */
+export declare function sciPeaksEthylbenzeneIrLoad(jdx: string): LoadRequest & {
+    accept: string[];
+};
 //# sourceMappingURL=sciPeaks.d.ts.map

package/lib/host/testing/sciPeaks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sciPeaks.d.ts","sourceRoot":"","sources":["../../../src/host/testing/sciPeaks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,aAAa,CAAC;AAE7C,8EAA8E;AAC9E,eAAO,MAAM,6BAA6B,QAuB9B,CAAC;AAEb,0EAA0E;AAC1E,eAAO,MAAM,0BAA0B,EAAE,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAqBxE,CAAC"}
+{"version":3,"file":"sciPeaks.d.ts","sourceRoot":"","sources":["../../../src/host/testing/sciPeaks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,aAAa,CAAC;AAE7C,8EAA8E;AAC9E,eAAO,MAAM,6BAA6B,QAuB9B,CAAC;AAEb,0EAA0E;AAC1E,eAAO,MAAM,0BAA0B,EAAE,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAqBxE,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,iCAAiC,0CACL,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,8BAA8B;;;;;;GAsE1C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,GACV,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAsBpC"}

package/lib/host/testing/sciPeaks.js

@@ -8,6 +8,10 @@
  * The sample is a real one, and so are its quirks: its molfile is V2000 with
  * every atom at the origin, its title is blank so the label is its first name,
  * and its formula travels as a kind no structure input reads.
+ *
+ * Its infrared spectrum is pinned here before the tool tab sends it: the bands
+ * are the sample's own, and the message is the one visualizer-helper's `ir`
+ * reader has to write.
  */
 /** How SciPeaks' tool tab introduces itself in `connect`. */
 export const SCIPEAKS_HOST_NAME = 'SciPeaks';
@@ -59,4 +63,73 @@ export const SCIPEAKS_ETHYLBENZENE_LOAD = {
     ],
     accept: [],
 };
+/** Where SciPeaks keeps that sample's infrared spectrum: its attachment. */
+export const SCIPEAKS_ETHYLBENZENE_IR_FILENAME = 'spectra/ir/spectra_ir_100-41-4-IR.jdx';
+/**
+ * The bands SciPeaks keeps for that spectrum, as stored: out of wavenumber
+ * order, a transmittance that is a fraction, and the visualizer's `_highlight`.
+ */
+export const SCIPEAKS_ETHYLBENZENE_IR_PEAKS = [
+    peak(1613.8583376884494, 0.473660722610156, 0.33599999999999997, 'm', 0.5620600551849647),
+    peak(1952.5275809045322, 0.13123804178794973, 0.7392, 'w', 0.5211472441361716),
+    peak(2872.4947788943773, 0.4610494379856386, 0.3459, 'm', 0.30496127508514037),
+    peak(2887.659073366737, 0.7066374452885544, 0.1965, 'S', 0.6306151483877337),
+    peak(2907.878132663217, 0.4962093169428189, 0.319, 'S', 0.7220300834282813),
+    peak(2944.9464080400967, 1.0867160982395816, 0.0819, 'S', 0.8391486100817713),
+    peak(2978.6448402008964, 1.7958800173440752, 0.016, 'S', 0.6098050482700554),
+    peak(3014.028193969736, 0.32975414692587596, 0.468, 'm', 0.39091552830124354),
+    peak(3039.302018090336, 1.0969100130080565, 0.08, 'S', 0.502385910408338),
+    peak(3076.3702934672156, 0.5831931281770556, 0.2611, 'S', 0.06293920935800923),
+    peak(3098.2742743717354, 0.38658105496542694, 0.4106, 'm', 0.4934643842659038),
+    peak(3118.493333668215, 0.16557929631846746, 0.6829999999999999, 'w', 0.05290000144269602),
+    peak(1875.0211869346824, 0.11935787359571505, 0.7597, 'w', 0.9972320630781272),
+    peak(1812.6790874371945, 0.11125903931710739, 0.774, 'w', 0.07102323198933491),
+    peak(1753.706831155787, 0.0834934128848443, 0.8251000000000001, 'w', 0.0750629173499594),
+];
+/**
+ * The `load` the tool tab is to send that sample to a site that reads
+ * infrared spectra and hands their bands back, once its `ir` reader and its
+ * `save` exist: the structure as it is sent today, one `spectra.ir.jdx` item
+ * per spectrum — the attachment's text, its name and its bands, under the
+ * attachment's name as `id` — and `accept` naming the kind saved back, as
+ * the tool tab's `save` names it.
+ * @param jdx - The attachment's text, which SciPeaks serves at its `dUrl`.
+ * @returns The request, its bands copied so that reading them cannot strip
+ * this module's own.
+ */
+export function sciPeaksEthylbenzeneIrLoad(jdx) {
+    return {
+        type: 'load',
+        id: 'load-1',
+        document: SCIPEAKS_ETHYLBENZENE_LOAD.document,
+        items: [
+            ...SCIPEAKS_ETHYLBENZENE_LOAD.items,
+            {
+                kind: 'spectra.ir.jdx',
+                id: SCIPEAKS_ETHYLBENZENE_IR_FILENAME,
+                label: 'spectra_ir_100-41-4-IR.jdx',
+                value: {
+                    jdx,
+                    filename: SCIPEAKS_ETHYLBENZENE_IR_FILENAME,
+                    peaks: SCIPEAKS_ETHYLBENZENE_IR_PEAKS.map((stored) => ({
+                        ...stored,
+                    })),
+                },
+            },
+        ],
+        accept: ['spectra.ir.peaks'],
+    };
+}
+/**
+ * One stored band.
+ * @param wavenumber - Where it sits, in cm⁻¹.
+ * @param absorbance - Its absorbance.
+ * @param transmittance - Its transmittance, a fraction.
+ * @param kind - Its strength letter.
+ * @param highlight - The visualizer's own `_highlight`, stored with it.
+ * @returns The band as SciPeaks stores it.
+ */
+function peak(wavenumber, absorbance, transmittance, kind, highlight) {
+    return { wavenumber, absorbance, transmittance, kind, _highlight: highlight };
+}
 //# sourceMappingURL=sciPeaks.js.map

package/lib/host/testing/sciPeaks.js.map

@@ -1 +1 @@
-{"version":3,"file":"sciPeaks.js","sourceRoot":"","sources":["../../../src/host/testing/sciPeaks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAE7C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,EAAE;IACF,kCAAkC;IAClC,EAAE;IACF,yCAAyC;IACzC,uEAAuE;IACvE,uEAAuE;IACvE,uEAAuE;IACvE,uEAAuE;IACvE,uEAAuE;IACvE,uEAAuE;IACvE,uEAAuE;IACvE,uEAAuE;IACvE,uBAAuB;IACvB,uBAAuB;IACvB,uBAAuB;IACvB,uBAAuB;IACvB,uBAAuB;IACvB,uBAAuB;IACvB,uBAAuB;IACvB,uBAAuB;IACvB,QAAQ;IACR,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,0EAA0E;AAC1E,MAAM,CAAC,MAAM,0BAA0B,GAAuC;IAC5E,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,QAAQ;IACZ,QAAQ,EAAE,sCAAsC;IAChD,KAAK,EAAE;QACL;YACE,IAAI,EAAE,iBAAiB;YACvB,KAAK,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE;YACjD,KAAK,EAAE,cAAc;SACtB;QACD;YACE,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE;gBACL,MAAM,EAAE,gBAAgB;gBACxB,WAAW,EAAE,MAAM,CAAC,GAAG,CAAA,uBAAuB;aAC/C;YACD,KAAK,EAAE,cAAc;SACtB;QACD,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE;KAC5C;IACD,MAAM,EAAE,EAAE;CACX,CAAC"}
+{"version":3,"file":"sciPeaks.js","sourceRoot":"","sources":["../../../src/host/testing/sciPeaks.ts"],"names":[],"mappings":"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"}

package/lib/host/testing/standInHost.d.ts

@@ -30,7 +30,7 @@ export interface StandInHost {
 export interface StandInHostLog {
     /** The tool's `hello`, or `null` before it came. */
     hello: HelloMessage | null;
-    /** Every message the tool sent on the port, in order. */
+    /** Every message the tool sent on the port, in order: results and outputs. */
     results: unknown[];
 }
 /**
@@ -44,4 +44,12 @@ export declare function startStandInHost(): Promise<StandInHost>;
  * @returns The log.
  */
 export declare function readStandInHostLog(): StandInHostLog;
+/**
+ * Send one more request on the port, once the tool has connected — a `get`
+ * after the user has worked. Runs in the page, as
+ * `page.evaluate(sendStandInHostRequest, request)`.
+ * @param request - What to send.
+ * @returns Whether there was a port to send it on.
+ */
+export declare function sendStandInHostRequest(request: unknown): boolean;
 //# sourceMappingURL=standInHost.d.ts.map

package/lib/host/testing/standInHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standInHost.d.ts","sourceRoot":"","sources":["../../../src/host/testing/standInHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,KAAK,MAAM,CAAC;IACnE,oBAAoB;IACpB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,yDAAyD;IACzD,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,WAAW,CAAC,CAyB7D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,CAEnD"}
+{"version":3,"file":"standInHost.d.ts","sourceRoot":"","sources":["../../../src/host/testing/standInHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,KAAK,MAAM,CAAC;IACnE,oBAAoB;IACpB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,8EAA8E;IAC9E,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,WAAW,CAAC,CA8B7D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,CAEnD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAMhE"}

package/lib/host/testing/standInHost.js

@@ -16,7 +16,9 @@ import { createServer } from 'node:http';
  * @returns The host; close it when the tests are done.
  */
 export async function startStandInHost() {
-    const server = createServer((_request, response) => {
+    // A setup carrying a spectrum is tens of kilobytes of address, past the
+    // 16 KiB Node allows a request's head by default.
+    const server = createServer({ maxHeaderSize: MAX_SETUP_BYTES }, (_request, response) => {
         response.writeHead(200, { 'content-type': 'text/html; charset=utf-8' });
         response.end(HOST_PAGE);
     });
@@ -49,6 +51,20 @@ export async function startStandInHost() {
 export function readStandInHostLog() {
     return globalThis.hostLog;
 }
+/**
+ * Send one more request on the port, once the tool has connected — a `get`
+ * after the user has worked. Runs in the page, as
+ * `page.evaluate(sendStandInHostRequest, request)`.
+ * @param request - What to send.
+ * @returns Whether there was a port to send it on.
+ */
+export function sendStandInHostRequest(request) {
+    const { hostPort } = globalThis;
+    hostPort?.postMessage(request);
+    return hostPort !== null;
+}
+/** How long the page's address may be, in bytes: Chrome's own limit is 2 MB. */
+const MAX_SETUP_BYTES = 2 * 1024 * 1024;
 /**
  * The page. Its setup is its own `?setup=`, so one page serves every test, and
  * it listens before it frames, so the tool's `hello` cannot be missed.
@@ -63,11 +79,13 @@ const { toolUrl, requests } = JSON.parse(new URLSearchParams(location.search).ge
 const toolOrigin = new URL(toolUrl).origin;
 const frame = document.querySelector('#tool');
 globalThis.hostLog = { hello: null, results: [] };
+globalThis.hostPort = null;
 globalThis.addEventListener('message', (event) => {
   if (event.source !== frame.contentWindow || event.origin !== toolOrigin) return;
   if (event.data?.type !== 'cheminfo:hello') return;
   globalThis.hostLog.hello = event.data;
   const channel = new MessageChannel();
+  globalThis.hostPort = channel.port1;
   channel.port1.onmessage = (answer) => {
     globalThis.hostLog.results.push(answer.data);
   };