react-cheminfo 0.64.1 → 0.66.0

package/lib/fetch/core/fetchJson.js

@@ -0,0 +1,109 @@
+/**
+ * One JSON request to one of our backends, and its refusal as an error a page
+ * can show.
+ *
+ * Our backends are Fastify, and a refusal comes back as `{ statusCode, error,
+ * message }`: the message is written for the reader, so it is what the error
+ * says. Nothing here needs more than `fetch`, so it runs in a page, a worker
+ * and Node alike.
+ */
+import { ApiError } from "./apiError.js";
+/**
+ * Ask a backend one question and read its JSON answer.
+ *
+ * A refusal rejects with an {@link ApiError} carrying the server's own words
+ * and its status; a server that cannot be reached rejects with one of status
+ * 0. An abort is passed on untouched, so a caller tells "nobody asked any
+ * more" from a failure by the signal it aborted. A `204`, or an empty body,
+ * answers `undefined`.
+ * @param url - The address, absolute or relative to the page.
+ * @param options - The request, plus a `json` body and the `fetch` to use.
+ * @returns The parsed answer.
+ * @throws {ApiError} When the server refuses, cannot be reached, or answers
+ * something that is not JSON.
+ */
+export async function fetchJson(url, options = {}) {
+    const { json, fetch: send = globalThis.fetch, ...init } = options;
+    const headers = new Headers(init.headers);
+    if (!headers.has('Accept'))
+        headers.set('Accept', 'application/json');
+    if (json !== undefined && !headers.has('Content-Type')) {
+        headers.set('Content-Type', 'application/json');
+    }
+    const body = json === undefined ? init.body : JSON.stringify(json);
+    let response;
+    try {
+        response = await send(url, { ...init, headers, body });
+    }
+    catch (error) {
+        if (init.signal?.aborted === true)
+            throw error;
+        throw new ApiError('the server could not be reached', {
+            status: 0,
+            error: 'Network Error',
+            cause: error,
+        });
+    }
+    if (!response.ok)
+        throw await readApiError(response);
+    const text = await response.text();
+    if (response.status === 204 || text === '')
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        throw new ApiError('the server answered with something that is not JSON', {
+            status: response.status,
+            body: text,
+            cause: error,
+        });
+    }
+}
+/**
+ * The error a refusal stands for, in the server's words when it gave any: the
+ * `message` of a Fastify envelope, else a FastAPI `detail`, else the status.
+ * @param response - The response that was not ok.
+ * @returns The error, its body read.
+ */
+export async function readApiError(response) {
+    let body;
+    try {
+        const text = await response.text();
+        body = text === '' ? undefined : parseOrKeep(text);
+    }
+    catch {
+        body = undefined;
+    }
+    const envelope = isRecord(body) ? body : {};
+    const status = typeof envelope.statusCode === 'number'
+        ? envelope.statusCode
+        : response.status;
+    const error = typeof envelope.error === 'string' ? envelope.error : response.statusText;
+    return new ApiError(refusalMessage(envelope, response), {
+        status,
+        error,
+        body,
+    });
+}
+function refusalMessage(envelope, response) {
+    const { message, detail } = envelope;
+    if (typeof message === 'string' && message !== '')
+        return message;
+    if (typeof detail === 'string' && detail !== '')
+        return detail;
+    const text = response.statusText === '' ? '' : ` ${response.statusText}`;
+    return `the server answered ${response.status}${text}`;
+}
+function parseOrKeep(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=fetchJson.js.map

package/lib/fetch/core/fetchJson.js.map

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

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

@@ -0,0 +1,5 @@
+export type { ApiErrorOptions } from './apiError.ts';
+export { ApiError } from './apiError.ts';
+export type { FetchJsonOptions } from './fetchJson.ts';
+export { fetchJson, readApiError } from './fetchJson.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fetch/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/fetch/core/index.js

@@ -0,0 +1,3 @@
+export { ApiError } from "./apiError.js";
+export { fetchJson, readApiError } from "./fetchJson.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/fetch/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/formula/core/formulaText.d.ts

@@ -0,0 +1,46 @@
+/**
+ * One formula written several ways: canonically, so two spellings compare
+ * equal; as HTML, so a paste keeps its subscripts; in Unicode, for prose.
+ */
+import type { FormulaOptions, ParsedFormula } from './readFormula.ts';
+/** What {@link canonicalFormula} is told beyond the text. */
+export interface CanonicalFormulaOptions extends FormulaOptions {
+    /**
+     * Whether a formula typed in the wrong case is fixed first, so `c9h6n4`
+     * reads as `C9H6N4`. A tool reading exact isotopes and charges leaves it
+     * off: case is what tells `Co` from `CO`.
+     * @default false
+     */
+    fixCase?: boolean;
+}
+/**
+ * The canonical spelling of a formula, so two spellings of one compound
+ * compare equal: `NaOH`, `HONa` and `NaHO` all give the same string.
+ * @param text - A formula as typed.
+ * @param options - Whether the case is fixed, and the language of a failure.
+ * @returns The canonical formula.
+ * @throws {FormulaError} When the text is not a formula.
+ */
+export declare function canonicalFormula(text: string, options?: CanonicalFormulaOptions): string;
+/**
+ * Atom counts per element over a whole formula, isotopes folded into their
+ * element and every part added up.
+ * @param parsed - A formula as `readFormula` read it.
+ * @returns Symbol → count, in the order the formula first names each element.
+ */
+export declare function atomCounts(parsed: ParsedFormula): Map<string, number>;
+/**
+ * A formula as HTML, its subscripts and its charge marked up, so a value
+ * copied from the page keeps them when it is pasted into a document.
+ * @param text - A formula as typed.
+ * @returns The markup, or the text itself when it is not a formula.
+ */
+export declare function formulaHtml(text: string): string;
+/**
+ * A formula written for prose, with true subscripts and superscripts and its
+ * charge the way a chemist writes it: `NO₃⁻`, `Fe³⁺`, `²³⁸U¹⁹F₆`.
+ * @param text - A formula as typed.
+ * @returns The formula in Unicode, or the text itself when it is not one.
+ */
+export declare function formulaText(text: string): string;
+//# sourceMappingURL=formulaText.d.ts.map

package/lib/formula/core/formulaText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formulaText.d.ts","sourceRoot":"","sources":["../../../src/formula/core/formulaText.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtE,6DAA6D;AAC7D,MAAM,WAAW,uBAAwB,SAAQ,cAAc;IAC7D;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAQR;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAQrE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAchD"}

package/lib/formula/core/formulaText.js

@@ -0,0 +1,74 @@
+/**
+ * One formula written several ways: canonically, so two spellings compare
+ * equal; as HTML, so a paste keeps its subscripts; in Unicode, for prose.
+ */
+import { MF, ensureCase } from 'mf-parser';
+import { DEFAULT_LANGUAGE } from "../../i18n/core/languages.js";
+import { normalizeFormula } from "./normalizeFormula.js";
+import { FormulaError, parserMessage } from "./readFormula.js";
+/**
+ * The canonical spelling of a formula, so two spellings of one compound
+ * compare equal: `NaOH`, `HONa` and `NaHO` all give the same string.
+ * @param text - A formula as typed.
+ * @param options - Whether the case is fixed, and the language of a failure.
+ * @returns The canonical formula.
+ * @throws {FormulaError} When the text is not a formula.
+ */
+export function canonicalFormula(text, options = {}) {
+    const { fixCase = false, language = DEFAULT_LANGUAGE } = options;
+    const normalized = normalizeFormula(text);
+    try {
+        return new MF(fixCase ? ensureCase(normalized) : normalized).toMF();
+    }
+    catch (error) {
+        throw new FormulaError(parserMessage(text, error, language));
+    }
+}
+/**
+ * Atom counts per element over a whole formula, isotopes folded into their
+ * element and every part added up.
+ * @param parsed - A formula as `readFormula` read it.
+ * @returns Symbol → count, in the order the formula first names each element.
+ */
+export function atomCounts(parsed) {
+    const counts = new Map();
+    for (const part of parsed.parts) {
+        for (const atom of part.atoms) {
+            counts.set(atom.symbol, (counts.get(atom.symbol) ?? 0) + atom.count);
+        }
+    }
+    return counts;
+}
+/**
+ * A formula as HTML, its subscripts and its charge marked up, so a value
+ * copied from the page keeps them when it is pasted into a document.
+ * @param text - A formula as typed.
+ * @returns The markup, or the text itself when it is not a formula.
+ */
+export function formulaHtml(text) {
+    try {
+        return new MF(normalizeFormula(text)).toHtml();
+    }
+    catch {
+        return text.trim();
+    }
+}
+/**
+ * A formula written for prose, with true subscripts and superscripts and its
+ * charge the way a chemist writes it: `NO₃⁻`, `Fe³⁺`, `²³⁸U¹⁹F₆`.
+ * @param text - A formula as typed.
+ * @returns The formula in Unicode, or the text itself when it is not one.
+ */
+export function formulaText(text) {
+    let written;
+    try {
+        written = new MF(normalizeFormula(text)).toText();
+    }
+    catch {
+        return text.trim();
+    }
+    return written
+        .replaceAll(/\s+•\s+/gu, '·')
+        .replace(/(?<sign>[⁺⁻])(?<digits>[⁰¹²³⁴⁵⁶⁷⁸⁹]+)$/u, (_match, sign, digits) => `${digits === '¹' ? '' : digits}${sign}`);
+}
+//# sourceMappingURL=formulaText.js.map

package/lib/formula/core/formulaText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formulaText.js","sourceRoot":"","sources":["../../../src/formula/core/formulaText.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAa/D;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,UAAmC,EAAE;IAErC,MAAM,EAAE,OAAO,GAAG,KAAK,EAAE,QAAQ,GAAG,gBAAgB,EAAE,GAAG,OAAO,CAAC;IACjE,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;IACtE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAqB;IAC9C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IACD,OAAO,OAAO;SACX,UAAU,CAAC,WAAW,EAAE,GAAG,CAAC;SAC5B,OAAO,CACN,yCAAyC,EACzC,CAAC,MAAM,EAAE,IAAY,EAAE,MAAc,EAAE,EAAE,CACvC,GAAG,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,EAAE,CAC3C,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,6 @@
+export type { CanonicalFormulaOptions } from './formulaText.ts';
+export { atomCounts, canonicalFormula, formulaHtml, formulaText, } from './formulaText.ts';
+export { normalizeFormula } from './normalizeFormula.ts';
+export type { FormulaAtom, FormulaOptions, FormulaPart, ParsedFormula, } from './readFormula.ts';
+export { FormulaError, atomicNumber, elementName, readFormula, } from './readFormula.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/formula/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,GACZ,MAAM,kBAAkB,CAAC"}

package/lib/formula/core/index.js

@@ -0,0 +1,4 @@
+export { atomCounts, canonicalFormula, formulaHtml, formulaText, } from "./formulaText.js";
+export { normalizeFormula } from "./normalizeFormula.js";
+export { FormulaError, atomicNumber, elementName, readFormula, } from "./readFormula.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/formula/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAOzD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,GACZ,MAAM,kBAAkB,CAAC"}

package/lib/formula/core/normalizeFormula.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The ways a student types a charge or a hydrate, rewritten into the syntax
+ * `mf-parser` reads.
+ *
+ * The parser silently drops a trailing minus — `NO3-` would be read as neutral
+ * nitrate and `SO4--` as neutral sulfate — and reads the dot of `CuSO4.5H2O` as
+ * a decimal, giving `H2CuO5.5S`. Both are rewritten here, before the parser
+ * ever sees the text, rather than by every site that reads a formula.
+ */
+/**
+ * Rewrite the ways a charge and a hydrate are commonly typed into the syntax
+ * the parser reads.
+ *
+ * - `NO3-`, `SO4--`, `S2O3-2`, `CO3 2-`, `CO3^2-` → `NO3(-1)`, `SO4(-2)`, …
+ * - `CuSO4.5H2O`, `CuSO4·5H2O`, `CuSO4*5H2O` → `CuSO4 . 5H2O`
+ *
+ * A charge already written in parentheses, `Fe(3+)`, is left as it is.
+ * @param text - The formula as typed.
+ * @returns The formula the parser is given.
+ */
+export declare function normalizeFormula(text: string): string;
+//# sourceMappingURL=normalizeFormula.d.ts.map

package/lib/formula/core/normalizeFormula.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeFormula.d.ts","sourceRoot":"","sources":["../../../src/formula/core/normalizeFormula.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsBrD"}

package/lib/formula/core/normalizeFormula.js

@@ -0,0 +1,46 @@
+/**
+ * The ways a student types a charge or a hydrate, rewritten into the syntax
+ * `mf-parser` reads.
+ *
+ * The parser silently drops a trailing minus — `NO3-` would be read as neutral
+ * nitrate and `SO4--` as neutral sulfate — and reads the dot of `CuSO4.5H2O` as
+ * a decimal, giving `H2CuO5.5S`. Both are rewritten here, before the parser
+ * ever sees the text, rather than by every site that reads a formula.
+ */
+/**
+ * Rewrite the ways a charge and a hydrate are commonly typed into the syntax
+ * the parser reads.
+ *
+ * - `NO3-`, `SO4--`, `S2O3-2`, `CO3 2-`, `CO3^2-` → `NO3(-1)`, `SO4(-2)`, …
+ * - `CuSO4.5H2O`, `CuSO4·5H2O`, `CuSO4*5H2O` → `CuSO4 . 5H2O`
+ *
+ * A charge already written in parentheses, `Fe(3+)`, is left as it is.
+ * @param text - The formula as typed.
+ * @returns The formula the parser is given.
+ */
+export function normalizeFormula(text) {
+    let formula = text.trim().replaceAll(/[·•*]/g, '.');
+    formula = formula.replaceAll(/\s*\.\s*/g, ' . ');
+    const separated = /^(?<body>.*?\S)(?:\s+|\^)(?<digits>\d*)(?<signs>[+-]+)$/u.exec(formula);
+    if (separated?.groups) {
+        const { body = '', digits = '', signs = '' } = separated.groups;
+        return withCharge(body, signs, digits);
+    }
+    const signThenDigits = /^(?<body>.*?[^\s(])(?<sign>[+-])(?<digits>\d+)$/u.exec(formula);
+    if (signThenDigits?.groups) {
+        const { body = '', sign = '', digits = '' } = signThenDigits.groups;
+        return withCharge(body, sign, digits);
+    }
+    const trailingSigns = /^(?<body>.*?[^\s+-])(?<signs>[+-]+)$/u.exec(formula);
+    if (trailingSigns?.groups) {
+        const { body = '', signs = '' } = trailingSigns.groups;
+        return withCharge(body, signs, '');
+    }
+    return formula;
+}
+function withCharge(body, signs, digits) {
+    const sign = signs.startsWith('-') ? '-' : '+';
+    const magnitude = digits === '' ? signs.length : Number(digits);
+    return `${body.trim()}(${sign}${magnitude})`;
+}
+//# sourceMappingURL=normalizeFormula.js.map

package/lib/formula/core/normalizeFormula.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeFormula.js","sourceRoot":"","sources":["../../../src/formula/core/normalizeFormula.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAEjD,MAAM,SAAS,GACb,0DAA0D,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3E,IAAI,SAAS,EAAE,MAAM,EAAE,CAAC;QACtB,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC;QAChE,OAAO,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,cAAc,GAClB,kDAAkD,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnE,IAAI,cAAc,EAAE,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC;QACpE,OAAO,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IACD,MAAM,aAAa,GAAG,uCAAuC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5E,IAAI,aAAa,EAAE,MAAM,EAAE,CAAC;QAC1B,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC;QACvD,OAAO,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,KAAa,EAAE,MAAc;IAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC/C,MAAM,SAAS,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChE,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,GAAG,SAAS,GAAG,CAAC;AAC/C,CAAC"}

package/lib/formula/core/readFormula.d.ts

@@ -0,0 +1,73 @@
+/**
+ * A formula read into its parts, atoms and charges, with every failure
+ * explained in a sentence written for a student rather than for a parser.
+ */
+import type { Language } from '../../i18n/core/languages.ts';
+/** One kind of atom in one part of a formula. */
+export interface FormulaAtom {
+    /** Element symbol, e.g. `Fe`. */
+    symbol: string;
+    /** Mass number when the formula names the isotope, e.g. 56 in `[56Fe]`. */
+    massNumber: number | null;
+    /** How many of them the part holds. */
+    count: number;
+}
+/** One `.`-separated part of a formula: its atoms and its charge. */
+export interface FormulaPart {
+    /** The atoms of the part, in the order the formula first names them. */
+    atoms: FormulaAtom[];
+    /** The charge of the part. */
+    charge: number;
+}
+/** A formula as {@link readFormula} reads it. */
+export interface ParsedFormula {
+    /** What was handed to the parser, after {@link normalizeFormula}. */
+    formula: string;
+    /** Its `.`-separated parts. */
+    parts: FormulaPart[];
+    /** Sum of the charges of every part. */
+    charge: number;
+}
+/** What the formula readers are told beyond the text. */
+export interface FormulaOptions {
+    /**
+     * The language a failure is explained in.
+     * @default 'en'
+     */
+    language?: Language;
+}
+/** A formula that cannot be read, with a message written for a student. */
+export declare class FormulaError extends Error {
+    name: string;
+}
+/**
+ * Read a formula into its parts, atoms and charges.
+ * @param text - A formula as typed, e.g. `Fe(3+)`, `NO3-` or `[238U][19F]6`.
+ * @param options - The language a failure is explained in.
+ * @returns The parsed formula.
+ * @throws {FormulaError} When the text is empty or is not a formula.
+ */
+export declare function readFormula(text: string, options?: FormulaOptions): ParsedFormula;
+/**
+ * The atomic number of an element.
+ * @param symbol - Its symbol.
+ * @param options - The language a failure is explained in.
+ * @returns Z.
+ * @throws {FormulaError} When the symbol is not an element.
+ */
+export declare function atomicNumber(symbol: string, options?: FormulaOptions): number;
+/**
+ * The name of an element, as the periodic table writes it.
+ * @param symbol - Its symbol.
+ * @returns The English name, or the symbol itself for an unknown one.
+ */
+export declare function elementName(symbol: string): string;
+/**
+ * Explain a failure of the parser in a student's terms.
+ * @param text - The formula as typed.
+ * @param error - What the parser threw.
+ * @param language - The language of the sentence.
+ * @returns The sentence.
+ */
+export declare function parserMessage(text: string, error: unknown, language: Language): string;
+//# sourceMappingURL=readFormula.d.ts.map

package/lib/formula/core/readFormula.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readFormula.d.ts","sourceRoot":"","sources":["../../../src/formula/core/readFormula.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAO7D,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,2EAA2E;AAC3E,qBAAa,YAAa,SAAQ,KAAK;IAC5B,IAAI,SAAkB;CAChC;AAQD;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,cAAmB,GAC3B,aAAa,CA8Bf;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,cAAmB,GAC3B,MAAM,CAUR;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,QAAQ,GACjB,MAAM,CASR"}

package/lib/formula/core/readFormula.js

@@ -0,0 +1,132 @@
+/**
+ * A formula read into its parts, atoms and charges, with every failure
+ * explained in a sentence written for a student rather than for a parser.
+ */
+import { MF } from 'mf-parser';
+import { CHROME_CATALOG } from "../../i18n/core/chromeCatalog.js";
+import { DEFAULT_LANGUAGE } from "../../i18n/core/languages.js";
+import { catalogTranslate } from "../../i18n/core/translate.js";
+import { elementBySymbol } from "../../periodic/core/elements.js";
+import { normalizeFormula } from "./normalizeFormula.js";
+/** A formula that cannot be read, with a message written for a student. */
+export class FormulaError extends Error {
+    name = 'FormulaError';
+}
+/**
+ * Read a formula into its parts, atoms and charges.
+ * @param text - A formula as typed, e.g. `Fe(3+)`, `NO3-` or `[238U][19F]6`.
+ * @param options - The language a failure is explained in.
+ * @returns The parsed formula.
+ * @throws {FormulaError} When the text is empty or is not a formula.
+ */
+export function readFormula(text, options = {}) {
+    const { language = DEFAULT_LANGUAGE } = options;
+    const t = catalogTranslate(CHROME_CATALOG, language);
+    const formula = normalizeFormula(text);
+    if (formula === '')
+        throw new FormulaError(t('formula.typeFirst'));
+    let rawParts;
+    try {
+        rawParts = new MF(formula).toParts();
+    }
+    catch (error) {
+        throw new FormulaError(parserMessage(text, error, language));
+    }
+    const order = writtenOrder(formula);
+    const parts = [];
+    let total = 0;
+    for (const rawPart of rawParts) {
+        const part = readPart(text, rawPart, language);
+        part.atoms.sort((a, b) => (order.get(a.symbol) ?? order.size) -
+            (order.get(b.symbol) ?? order.size));
+        total += part.charge;
+        parts.push(part);
+    }
+    if (parts.every((part) => part.atoms.length === 0)) {
+        throw new FormulaError(t('formula.noAtom', { formula: text.trim() }));
+    }
+    return { formula, parts, charge: total };
+}
+/**
+ * The atomic number of an element.
+ * @param symbol - Its symbol.
+ * @param options - The language a failure is explained in.
+ * @returns Z.
+ * @throws {FormulaError} When the symbol is not an element.
+ */
+export function atomicNumber(symbol, options = {}) {
+    const element = elementBySymbol(symbol);
+    if (element === undefined) {
+        const t = catalogTranslate(CHROME_CATALOG, options.language ?? DEFAULT_LANGUAGE);
+        throw new FormulaError(t('formula.notElement', { symbol }));
+    }
+    return element.atomicNumber;
+}
+/**
+ * The name of an element, as the periodic table writes it.
+ * @param symbol - Its symbol.
+ * @returns The English name, or the symbol itself for an unknown one.
+ */
+export function elementName(symbol) {
+    return elementBySymbol(symbol)?.name ?? symbol;
+}
+/**
+ * Explain a failure of the parser in a student's terms.
+ * @param text - The formula as typed.
+ * @param error - What the parser threw.
+ * @param language - The language of the sentence.
+ * @returns The sentence.
+ */
+export function parserMessage(text, error, language) {
+    const t = catalogTranslate(CHROME_CATALOG, language);
+    const raw = error instanceof Error ? error.message : String(error);
+    const unknown = /element unknown: (?<symbol>\S+)/u.exec(raw);
+    if (unknown?.groups?.symbol) {
+        return t('formula.notElement', { symbol: unknown.groups.symbol });
+    }
+    const reason = raw.split('\n', 1)[0] ?? raw;
+    return t('formula.unreadable', { formula: text.trim(), reason });
+}
+/**
+ * Where each element first appears in a formula as it is written, so a table
+ * lists Sb before O for Sb2O5 rather than in the parser's canonical order.
+ * @param formula - The formula as given to the parser.
+ * @returns Symbol → position of its first appearance.
+ */
+function writtenOrder(formula) {
+    const order = new Map();
+    for (const match of formula.matchAll(/[A-Z][a-z]*/gu)) {
+        if (!order.has(match[0]))
+            order.set(match[0], order.size);
+    }
+    return order;
+}
+function readPart(text, rawPart, language) {
+    const t = catalogTranslate(CHROME_CATALOG, language);
+    const atoms = [];
+    let charge = 0;
+    for (const entry of rawPart) {
+        if (entry.kind === 'charge') {
+            charge += Number(entry.value);
+            continue;
+        }
+        const count = entry.multiplier ?? 1;
+        if (!Number.isInteger(count) || count <= 0) {
+            throw new FormulaError(t('formula.wholeCounts', { formula: text.trim(), count }));
+        }
+        if (entry.kind === 'atom' && typeof entry.value === 'string') {
+            atomicNumber(entry.value, { language });
+            atoms.push({ symbol: entry.value, massNumber: null, count });
+            continue;
+        }
+        if (entry.kind === 'isotope') {
+            const { atom, isotope } = entry.value;
+            atomicNumber(atom, { language });
+            atoms.push({ symbol: atom, massNumber: isotope, count });
+            continue;
+        }
+        throw new FormulaError(t('formula.unknownNotation', { formula: text.trim() }));
+    }
+    return { atoms, charge };
+}
+//# sourceMappingURL=readFormula.js.map

package/lib/formula/core/readFormula.js.map

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

package/lib/formula/ui/CopyableFormula.d.ts

@@ -0,0 +1,31 @@
+import type { ReactElement } from 'react';
+import type { ClickToCopyElement } from '../../clipboard/ui/ClickToCopy.tsx';
+/** What {@link CopyableFormula} draws and copies. */
+export interface CopyableFormulaProps {
+    /** The formula, as the data writes it: `NO3-`, `CuSO4.5H2O`, `C6H12O6`. */
+    formula: string;
+    /**
+     * The element drawn: a cell of its own inside a table.
+     * @default 'span'
+     */
+    as?: Extract<ClickToCopyElement, 'span' | 'td'>;
+    /**
+     * What the value is called in the hover title.
+     * @default the chrome's own word for it, in the language of the page
+     */
+    label?: string;
+    /**
+     * Class the value carries, in addition to `click-to-copy`.
+     * @default undefined
+     */
+    className?: string;
+}
+/**
+ * A formula drawn with its subscripts and copied by a click: as text for
+ * another tool, and as HTML, so a paste into a document keeps the subscripts
+ * and the charge.
+ * @param props - The formula, the element it is drawn as, and its label.
+ * @returns The formula.
+ */
+export declare function CopyableFormula(props: CopyableFormulaProps): ReactElement;
+//# sourceMappingURL=CopyableFormula.d.ts.map

package/lib/formula/ui/CopyableFormula.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopyableFormula.d.ts","sourceRoot":"","sources":["../../../src/formula/ui/CopyableFormula.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAM7E,qDAAqD;AACrD,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,EAAE,CAAC,EAAE,OAAO,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAChD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,CAazE"}

package/lib/formula/ui/CopyableFormula.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { MF } from 'react-mf';
+import { ClickToCopy } from "../../clipboard/ui/ClickToCopy.js";
+import { useChromeT } from "../../i18n/ui/useT.js";
+import { formulaHtml } from "../core/formulaText.js";
+import { normalizeFormula } from "../core/normalizeFormula.js";
+/**
+ * A formula drawn with its subscripts and copied by a click: as text for
+ * another tool, and as HTML, so a paste into a document keeps the subscripts
+ * and the charge.
+ * @param props - The formula, the element it is drawn as, and its label.
+ * @returns The formula.
+ */
+export function CopyableFormula(props) {
+    const { formula, as = 'span', label, className } = props;
+    const t = useChromeT();
+    return (_jsx(ClickToCopy, { as: as, className: className, label: label ?? t('formula.copyLabel'), value: { text: formula, html: formulaHtml(formula) }, children: _jsx(MF, { mf: normalizeFormula(formula) }) }));
+}
+//# sourceMappingURL=CopyableFormula.js.map