react-cheminfo 0.76.0 → 0.78.0

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

@@ -4,14 +4,17 @@
  * 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, and the two
- * infrared kinds of `./irKinds.ts`. A name with children is a category whose
+ * `chem.smiles`, which pipeline lists among its future schemas, the two
+ * infrared kinds of `./irKinds.ts`, and the kinds a tool hands back, of
+ * `./resultKinds.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';
+import type { HostItem } from './protocol.ts';
+import type { NameValue, SvgImageValue, TableValue } from './resultKinds.ts';
 /** A molfile, V2000 or V3000. */
 export interface MolfileValue {
     molfile: string;
@@ -41,9 +44,22 @@ export type CheckedValue = {
 } | {
     kind: 'spectra.ir.peaks';
     value: IrPeaksValue;
+} | {
+    kind: 'image.svg';
+    value: SvgImageValue;
+} | {
+    kind: 'chem.name';
+    value: NameValue;
+} | {
+    kind: 'data.table';
+    value: TableValue;
 };
-/** The name of a kind a tool can read. */
+/** The name of a kind there is a schema for: one a tool reads, or one it hands back. */
 export type KnownKind = CheckedValue['kind'];
+/** A checked value of one kind. */
+export type CheckedOf<K extends KnownKind> = Extract<CheckedValue, {
+    kind: K;
+}>;
 /** What checking a value gave. */
 export type CheckOutcome = {
     valid: true;
@@ -78,4 +94,16 @@ export declare function isKnownKind(kind: string): kind is KnownKind;
  * them, `'/idCode: must be string'`.
  */
 export declare function checkValue(kind: KnownKind, value: unknown): CheckOutcome;
+/**
+ * Read the value a tool handed back under an output, as the kind the host
+ * asked for: the item must be of that kind or one under it, and pass that
+ * kind's schema.
+ * @param items - What the tool handed back.
+ * @param key - The output.
+ * @param kind - The kind it is read as.
+ * @returns The value tagged with the kind, or `undefined` when the tool handed
+ * nothing back under that key.
+ * @throws {Error} When the item is of another kind, or not of its shape.
+ */
+export declare function readOutput<K extends KnownKind>(items: readonly HostItem[], key: string, kind: K): CheckedOf<K> | undefined;
 //# sourceMappingURL=kinds.d.ts.map

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;;;;;;;;;;;;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"}
+{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../../../src/host/core/kinds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG7E,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,GACjD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAE9C,wFAAwF;AACxF,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAE7C,mCAAmC;AACnC,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AAKhF,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;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,SAAS,EAC5C,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,GACN,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAc1B"}

package/lib/host/core/kinds.js

@@ -4,8 +4,9 @@
  * 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, and the two
- * infrared kinds of `./irKinds.ts`. A name with children is a category whose
+ * `chem.smiles`, which pipeline lists among its future schemas, the two
+ * infrared kinds of `./irKinds.ts`, and the kinds a tool hands back, of
+ * `./resultKinds.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
@@ -13,6 +14,7 @@
  */
 import { Ajv } from 'ajv';
 import { IR_JDX_SCHEMA, IR_PEAKS_SCHEMA } from "./irKinds.js";
+import { NAME_SCHEMA, SVG_IMAGE_SCHEMA, TABLE_SCHEMA } from "./resultKinds.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
@@ -59,6 +61,31 @@ export function checkValue(kind, value) {
     }
     return { valid: false, errors };
 }
+/**
+ * Read the value a tool handed back under an output, as the kind the host
+ * asked for: the item must be of that kind or one under it, and pass that
+ * kind's schema.
+ * @param items - What the tool handed back.
+ * @param key - The output.
+ * @param kind - The kind it is read as.
+ * @returns The value tagged with the kind, or `undefined` when the tool handed
+ * nothing back under that key.
+ * @throws {Error} When the item is of another kind, or not of its shape.
+ */
+export function readOutput(items, key, kind) {
+    const item = items.find((entry) => entry.key === key);
+    if (item === undefined)
+        return undefined;
+    if (!kindAccepts(kind, item.kind)) {
+        throw new Error(`The ${key} handed back is a ${item.kind}, not a ${kind}.`);
+    }
+    const outcome = checkValue(kind, item.value);
+    if (!outcome.valid) {
+        throw new Error(`The ${key} handed back is not shaped as a ${kind}: ${outcome.errors.join('; ')}.`);
+    }
+    // The validator of `kind` just vouched for the shape of the value.
+    return outcome.checked;
+}
 const MOLFILE_SCHEMA = {
     type: 'object',
     properties: { molfile: { type: 'string' } },
@@ -80,8 +107,9 @@ const SMILES_SCHEMA = {
     required: ['smiles'],
     additionalProperties: false,
 };
-// `removeAdditional` strips what `additionalProperties: false` would refuse.
-const ajv = new Ajv({ removeAdditional: true });
+// `removeAdditional` strips what `additionalProperties: false` would refuse;
+// a table's cell is a string, a number or null, which is a union of types.
+const ajv = new Ajv({ removeAdditional: true, allowUnionTypes: true });
 const VALIDATORS = {
     'chem.molfile': ajv.compile(MOLFILE_SCHEMA),
     'chem.ocl.id': ajv.compile(OCL_ID_SCHEMA),
@@ -90,5 +118,8 @@ const VALIDATORS = {
     // `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),
+    'image.svg': ajv.compile(SVG_IMAGE_SCHEMA),
+    'chem.name': ajv.compile(NAME_SCHEMA),
+    'data.table': ajv.compile(TABLE_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;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG1B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAoC9D;;;;;;;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;IACzC,4EAA4E;IAC5E,uEAAuE;IACvE,gBAAgB,EAAE,GAAG,CAAC,OAAO,CAAa,aAAa,CAAC;IACxD,kBAAkB,EAAE,GAAG,CAAC,OAAO,CAAe,eAAe,CAAC;CAC/D,CAAC"}
+{"version":3,"file":"kinds.js","sourceRoot":"","sources":["../../../src/host/core/kinds.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,29 @@
+/**
+ * The values inside a protocol message, read as the untrusted input they are,
+ * on either side of the frame boundary.
+ */
+import type { HostItem } from './protocol.ts';
+/** How many items one message may carry; the rest are dropped. */
+export declare const MAX_ITEMS = 64;
+/** How long a label may be, in characters; a longer one is cut. */
+export declare const MAX_LABEL_LENGTH = 80;
+/**
+ * Read the items of a message, dropping those without a string `kind`, at
+ * most {@link MAX_ITEMS} of them, each label cut to {@link MAX_LABEL_LENGTH}.
+ * @param values - The items as they arrived.
+ * @returns The items.
+ */
+export declare function readItems(values: readonly unknown[]): HostItem[];
+/**
+ * Read a list of strings, dropping anything else.
+ * @param value - The list as it arrived.
+ * @returns Its strings, or none when it is not a list.
+ */
+export declare function readStrings(value: unknown): string[];
+/**
+ * Whether a value is a plain object, as every message is.
+ * @param value - The value.
+ * @returns `true` for an object that is not an array.
+ */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=messageValues.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messageValues.d.ts","sourceRoot":"","sources":["../../../src/host/core/messageValues.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,kEAAkE;AAClE,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,QAAQ,EAAE,CAehE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAOpD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}

package/lib/host/core/messageValues.js

@@ -0,0 +1,57 @@
+/**
+ * The values inside a protocol message, read as the untrusted input they are,
+ * on either side of the frame boundary.
+ */
+/** How many items one message may carry; the rest are dropped. */
+export const MAX_ITEMS = 64;
+/** How long a label may be, in characters; a longer one is cut. */
+export const MAX_LABEL_LENGTH = 80;
+/**
+ * Read the items of a message, dropping those without a string `kind`, at
+ * most {@link MAX_ITEMS} of them, each label cut to {@link MAX_LABEL_LENGTH}.
+ * @param values - The items as they arrived.
+ * @returns The items.
+ */
+export function readItems(values) {
+    const items = [];
+    const count = Math.min(values.length, MAX_ITEMS);
+    for (let index = 0; index < count; index++) {
+        const value = values[index];
+        if (!isRecord(value) || typeof value.kind !== 'string')
+            continue;
+        const item = { kind: value.kind, value: value.value };
+        if (typeof value.id === 'string')
+            item.id = value.id;
+        if (typeof value.key === 'string')
+            item.key = value.key;
+        if (typeof value.label === 'string') {
+            item.label = value.label.slice(0, MAX_LABEL_LENGTH);
+        }
+        items.push(item);
+    }
+    return items;
+}
+/**
+ * Read a list of strings, dropping anything else.
+ * @param value - The list as it arrived.
+ * @returns Its strings, or none when it is not a list.
+ */
+export function readStrings(value) {
+    if (!Array.isArray(value))
+        return [];
+    const strings = [];
+    for (const entry of value) {
+        if (typeof entry === 'string')
+            strings.push(entry);
+    }
+    return strings;
+}
+/**
+ * Whether a value is a plain object, as every message is.
+ * @param value - The value.
+ * @returns `true` for an object that is not an array.
+ */
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=messageValues.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messageValues.js","sourceRoot":"","sources":["../../../src/host/core/messageValues.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,kEAAkE;AAClE,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAE5B,mEAAmE;AACnE,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,MAA0B;IAClD,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,SAAS;QACjE,MAAM,IAAI,GAAa,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;QAChE,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;YAAE,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;QACrD,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;YAAE,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACxD,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

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

@@ -9,16 +9,13 @@
  * takes back changes. This module only spells the messages, and reads what
  * arrives as the untrusted input it is.
  */
+export { MAX_ITEMS, MAX_LABEL_LENGTH } from './messageValues.ts';
 /** The version a tool speaks; a `connect` naming another is ignored. */
 export declare const PROTOCOL_VERSION = 1;
 /** Posted to the parent frame or the opener at start-up: who the tool is. */
 export declare const HELLO_TYPE = "cheminfo:hello";
 /** The host's answer to `hello`, carrying the port the rest goes through. */
 export declare const CONNECT_TYPE = "cheminfo:connect";
-/** How many items one request may carry; the rest are dropped. */
-export declare const MAX_ITEMS = 64;
-/** How long a label may be, in characters; a longer one is cut. */
-export declare const MAX_LABEL_LENGTH = 80;
 /** One typed value crossing the frame boundary. */
 export interface HostItem {
     /** A kind name, e.g. `'chem.molfile.2d'`. */
@@ -163,7 +160,7 @@ export interface OutputMessage {
  * 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, a label is cut to
- * {@link MAX_LABEL_LENGTH}, and a `load` without `accept` takes nothing back.
+ * `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

@@ -9,23 +9,21 @@
  * takes back changes. This module only spells the messages, and reads what
  * arrives as the untrusted input it is.
  */
+import { isRecord, readItems, readStrings } from "./messageValues.js";
+export { MAX_ITEMS, MAX_LABEL_LENGTH } from "./messageValues.js";
 /** The version a tool speaks; a `connect` naming another is ignored. */
 export const PROTOCOL_VERSION = 1;
 /** Posted to the parent frame or the opener at start-up: who the tool is. */
 export const HELLO_TYPE = 'cheminfo:hello';
 /** The host's answer to `hello`, carrying the port the rest goes through. */
 export const CONNECT_TYPE = 'cheminfo:connect';
-/** How many items one request may carry; the rest are dropped. */
-export const MAX_ITEMS = 64;
-/** How long a label may be, in characters; a longer one is cut. */
-export const MAX_LABEL_LENGTH = 80;
 /**
  * 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, a label is cut to
- * {@link MAX_LABEL_LENGTH}, and a `load` without `accept` takes nothing back.
+ * `MAX_LABEL_LENGTH`, and a `load` without `accept` takes nothing back.
  * @param data - What the port delivered.
  * @returns The request, or `null`.
  */
@@ -61,36 +59,4 @@ export function isConnect(data) {
         data.type === CONNECT_TYPE &&
         data.version === PROTOCOL_VERSION);
 }
-function readItems(values) {
-    const items = [];
-    const count = Math.min(values.length, MAX_ITEMS);
-    for (let index = 0; index < count; index++) {
-        const value = values[index];
-        if (!isRecord(value) || typeof value.kind !== 'string')
-            continue;
-        const item = { kind: value.kind, value: value.value };
-        if (typeof value.id === 'string')
-            item.id = value.id;
-        if (typeof value.key === 'string')
-            item.key = value.key;
-        if (typeof value.label === 'string') {
-            item.label = value.label.slice(0, MAX_LABEL_LENGTH);
-        }
-        items.push(item);
-    }
-    return items;
-}
-function readStrings(value) {
-    if (!Array.isArray(value))
-        return [];
-    const strings = [];
-    for (const entry of value) {
-        if (typeof entry === 'string')
-            strings.push(entry);
-    }
-    return strings;
-}
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
 //# sourceMappingURL=protocol.js.map

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":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,UAAU,GAAG,gBAAgB,CAAC;AAE3C,6EAA6E;AAC7E,MAAM,CAAC,MAAM,YAAY,GAAG,kBAAkB,CAAC;AA6I/C;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAChE,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACpE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAgB;YACxB,IAAI,EAAE,MAAM;YACZ,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;SAC7B,CAAC;QACF,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACpE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,OAAO,CACL,QAAQ,CAAC,IAAI,CAAC;QACd,IAAI,CAAC,IAAI,KAAK,YAAY;QAC1B,IAAI,CAAC,OAAO,KAAK,gBAAgB,CAClC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,74 @@
+/**
+ * The kinds a tool hands back to the page that frames it: a picture of what it
+ * shows, a name it worked out, a table of values it predicted.
+ *
+ * A host checks what comes back as a tool checks what it is sent: against the
+ * kind it asked for, stripped of the fields that kind does not name.
+ * `chem.name` is a category — a tool names its preferred IUPAC name
+ * `chem.name.iupac` — so a host asking for any name reads every one of them.
+ */
+/** `image.svg`: a picture, as an SVG document. */
+export interface SvgImageValue {
+    /** The SVG document, as text. */
+    svg: string;
+}
+/** `chem.name`: a name a structure goes by. */
+export interface NameValue {
+    /** The name, as written. */
+    name: string;
+}
+/** One cell of a `data.table`: a number, a text, or `null` where there is none. */
+export type TableCell = string | number | null;
+/** `data.table`: values laid out as a table, headings first. */
+export interface TableValue {
+    /** The heading of each column, in order. */
+    columns: string[];
+    /** The rows, each holding one cell per column. */
+    rows: TableCell[][];
+}
+/** The schema of `image.svg`. */
+export declare const SVG_IMAGE_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly svg: {
+            readonly type: "string";
+        };
+    };
+    readonly required: readonly ["svg"];
+    readonly additionalProperties: false;
+};
+/** The schema of `chem.name`. */
+export declare const NAME_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly name: {
+            readonly type: "string";
+        };
+    };
+    readonly required: readonly ["name"];
+    readonly additionalProperties: false;
+};
+/** The schema of `data.table`. */
+export declare const TABLE_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly columns: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly rows: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: readonly ["string", "number", "null"];
+                };
+            };
+        };
+    };
+    readonly required: readonly ["columns", "rows"];
+    readonly additionalProperties: false;
+};
+//# sourceMappingURL=resultKinds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resultKinds.d.ts","sourceRoot":"","sources":["../../../src/host/core/resultKinds.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,+CAA+C;AAC/C,MAAM,WAAW,SAAS;IACxB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mFAAmF;AACnF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAE/C,gEAAgE;AAChE,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kDAAkD;IAClD,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC;CACrB;AAED,iCAAiC;AACjC,eAAO,MAAM,gBAAgB;;;;;;;;;CAKnB,CAAC;AAEX,iCAAiC;AACjC,eAAO,MAAM,WAAW;;;;;;;;;CAKd,CAAC;AAEX,kCAAkC;AAClC,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;CAcf,CAAC"}

package/lib/host/core/resultKinds.js

@@ -0,0 +1,40 @@
+/**
+ * The kinds a tool hands back to the page that frames it: a picture of what it
+ * shows, a name it worked out, a table of values it predicted.
+ *
+ * A host checks what comes back as a tool checks what it is sent: against the
+ * kind it asked for, stripped of the fields that kind does not name.
+ * `chem.name` is a category — a tool names its preferred IUPAC name
+ * `chem.name.iupac` — so a host asking for any name reads every one of them.
+ */
+/** The schema of `image.svg`. */
+export const SVG_IMAGE_SCHEMA = {
+    type: 'object',
+    properties: { svg: { type: 'string' } },
+    required: ['svg'],
+    additionalProperties: false,
+};
+/** The schema of `chem.name`. */
+export const NAME_SCHEMA = {
+    type: 'object',
+    properties: { name: { type: 'string' } },
+    required: ['name'],
+    additionalProperties: false,
+};
+/** The schema of `data.table`. */
+export const TABLE_SCHEMA = {
+    type: 'object',
+    properties: {
+        columns: { type: 'array', items: { type: 'string' } },
+        rows: {
+            type: 'array',
+            items: {
+                type: 'array',
+                items: { type: ['string', 'number', 'null'] },
+            },
+        },
+    },
+    required: ['columns', 'rows'],
+    additionalProperties: false,
+};
+//# sourceMappingURL=resultKinds.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resultKinds.js","sourceRoot":"","sources":["../../../src/host/core/resultKinds.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyBH,iCAAiC;AACjC,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IACvC,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,oBAAoB,EAAE,KAAK;CACnB,CAAC;AAEX,iCAAiC;AACjC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IACxC,QAAQ,EAAE,CAAC,MAAM,CAAC;IAClB,oBAAoB,EAAE,KAAK;CACnB,CAAC;AAEX,kCAAkC;AAClC,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QACrD,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE;aAC9C;SACF;KACF;IACD,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,KAAK;CACnB,CAAC"}

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

@@ -0,0 +1,24 @@
+/**
+ * What a framed tool sends its host, read as the untrusted input it is: the
+ * `hello` it posts to the window, and on the port the `result` of each request
+ * and the `output` it sends when a value the host takes back changes.
+ *
+ * Anything that is not well formed is `null` and is ignored, as a tool ignores
+ * a request it does not know: a newer tool talking, not an error.
+ */
+import type { HelloMessage, OutputMessage, ResultMessage } from './protocol.ts';
+/** What a tool says of itself in `hello`. */
+export type ToolHello = HelloMessage['tool'];
+/**
+ * Read a tool's `hello`, in this version of the protocol.
+ * @param data - What the window delivered.
+ * @returns What the tool takes and gives, or `null` for anything else.
+ */
+export declare function readHello(data: unknown): ToolHello | null;
+/**
+ * Read a message a tool sent through the port.
+ * @param data - What the port delivered.
+ * @returns The `result` or the `output`, or `null` for anything else.
+ */
+export declare function readToolMessage(data: unknown): ResultMessage | OutputMessage | null;
+//# sourceMappingURL=toolMessages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolMessages.d.ts","sourceRoot":"","sources":["../../../src/host/core/toolMessages.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EACV,YAAY,EAGZ,aAAa,EACb,aAAa,EAId,MAAM,eAAe,CAAC;AAGvB,6CAA6C;AAC7C,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAY7C;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAuBzD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,GACZ,aAAa,GAAG,aAAa,GAAG,IAAI,CAqBtC"}