react-cheminfo 0.8.0 → 0.10.0

package/lib/spectra/ui/matrixSteps.js

@@ -0,0 +1,92 @@
+import { MATRIX_FILTER_NAMES } from "../core/settingsProblems.js";
+/**
+ * What the editor knows about the three steps the matrix stage dispatches.
+ *
+ * Keyed by the name rather than listed, so a name the processor's own switch
+ * does not match cannot reach the menu: an unknown name is the one way this
+ * stage throws.
+ */
+export const MATRIX_STEPS = {
+    pqn: {
+        label: 'Probabilistic quotient normalization',
+        summary: 'Divides every spectrum by its own dilution factor, read against the median spectrum. Min is declared upstream but never read.',
+        fields: [
+            { key: 'min', label: 'Min' },
+            { key: 'max', label: 'Max', placeholder: '100' },
+        ],
+    },
+    centerMean: {
+        label: 'Centre on the mean',
+        summary: 'Subtracts the mean of every column. It takes no options: anything set here is ignored.',
+        fields: [],
+    },
+    rescale: {
+        label: 'Rescale',
+        summary: 'Brings the whole matrix between two values.',
+        fields: [
+            { key: 'min', label: 'Min', placeholder: '0' },
+            { key: 'max', label: 'Max', placeholder: '1' },
+        ],
+    },
+};
+/** The add menu: the empty prompt, then the only three names that run. */
+export const MATRIX_ADD_OPTIONS = [
+    { value: '', label: 'Add a matrix step…' },
+    ...MATRIX_FILTER_NAMES.map((name) => ({
+        value: name,
+        label: MATRIX_STEPS[name].label,
+    })),
+];
+/**
+ * What the editor knows about a step, when it knows it at all.
+ * @param name - The name the settings hold.
+ * @returns Its entry, or undefined for a name the processor would throw on.
+ */
+export function matrixStep(name) {
+    if (name === undefined)
+        return undefined;
+    return Object.hasOwn(MATRIX_STEPS, name)
+        ? MATRIX_STEPS[name]
+        : undefined;
+}
+/**
+ * What one option of a step is set to.
+ * @param step - The step.
+ * @param key - Which option to read.
+ * @returns The number, or undefined when the step leaves it to upstream.
+ */
+export function readMatrixOption(step, key) {
+    const options = step.options;
+    if (typeof options !== 'object' || options === null)
+        return undefined;
+    const held = options[key];
+    return typeof held === 'number' ? held : undefined;
+}
+/**
+ * The step with one option set, or dropped when the box was emptied.
+ *
+ * Dropping rather than writing `undefined` is what lets a cleared box mean
+ * "whatever upstream does", which is the only way back to the default once a
+ * reader has typed over it.
+ * @param step - The step.
+ * @param key - Which option to write.
+ * @param value - What to set it to, or undefined to clear it.
+ * @returns A new step.
+ */
+export function writeMatrixOption(step, key, value) {
+    const held = step.options;
+    const source = typeof held === 'object' && held !== null
+        ? held
+        : {};
+    const options = {};
+    for (const [name, option] of Object.entries(source)) {
+        if (name !== key)
+            options[name] = option;
+    }
+    if (value !== undefined)
+        options[key] = value;
+    if (Object.keys(options).length === 0)
+        return { name: step.name };
+    return { name: step.name, options };
+}
+//# sourceMappingURL=matrixSteps.js.map

package/lib/spectra/ui/matrixSteps.js.map

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

package/lib/spectra/ui/problemsAbout.d.ts

@@ -0,0 +1,14 @@
+import type { SettingsProblem } from '../core/problems.ts';
+/**
+ * The problems whose `where` is, or starts with, one of the given words.
+ *
+ * The `where` strings are what `settingsProblems` writes, so a part of the
+ * panel asks for its own by naming the same words it is headed with — which
+ * keeps a problem next to the field that causes it rather than in one list at
+ * the top, far from anything the reader can act on.
+ * @param problems - Every problem the settings have.
+ * @param prefixes - The `where` strings the part answers for.
+ * @returns Only those problems, in the order they were found.
+ */
+export declare function problemsAbout(problems: readonly SettingsProblem[], ...prefixes: readonly string[]): SettingsProblem[];
+//# sourceMappingURL=problemsAbout.d.ts.map

package/lib/spectra/ui/problemsAbout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"problemsAbout.d.ts","sourceRoot":"","sources":["../../../src/spectra/ui/problemsAbout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,eAAe,EAAE,EACpC,GAAG,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC7B,eAAe,EAAE,CAInB"}

package/lib/spectra/ui/problemsAbout.js

@@ -0,0 +1,15 @@
+/**
+ * The problems whose `where` is, or starts with, one of the given words.
+ *
+ * The `where` strings are what `settingsProblems` writes, so a part of the
+ * panel asks for its own by naming the same words it is headed with — which
+ * keeps a problem next to the field that causes it rather than in one list at
+ * the top, far from anything the reader can act on.
+ * @param problems - Every problem the settings have.
+ * @param prefixes - The `where` strings the part answers for.
+ * @returns Only those problems, in the order they were found.
+ */
+export function problemsAbout(problems, ...prefixes) {
+    return problems.filter((entry) => prefixes.some((prefix) => entry.where.startsWith(prefix)));
+}
+//# sourceMappingURL=problemsAbout.js.map

package/lib/spectra/ui/problemsAbout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"problemsAbout.js","sourceRoot":"","sources":["../../../src/spectra/ui/problemsAbout.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAoC,EACpC,GAAG,QAA2B;IAE9B,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAC/B,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAC1D,CAAC;AACJ,CAAC"}

package/lib/spectra/ui/rowKeys.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A key no row is using yet.
+ *
+ * A row of the settings — a zone, a matrix step, a range — carries no identity
+ * of its own, so one is kept beside the list. Without it React reuses a removed
+ * row's box for the row that slides up, and the half-typed number in it goes
+ * with the wrong entry.
+ * @param keys - The keys in force.
+ * @returns The next free one.
+ */
+export declare function nextKey(keys: readonly number[]): number;
+/**
+ * The keys brought back in step with a list that changed from outside.
+ * @param keys - The keys in force.
+ * @param length - How many rows there now are.
+ * @returns One key per row.
+ */
+export declare function fitKeys(keys: readonly number[], length: number): number[];
+/**
+ * A list with one entry moved to another position.
+ * @param list - What to reorder.
+ * @param index - Which entry to move.
+ * @param target - Where it lands.
+ * @returns A new list.
+ */
+export declare function reorder<T>(list: readonly T[], index: number, target: number): T[];
+//# sourceMappingURL=rowKeys.d.ts.map

package/lib/spectra/ui/rowKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowKeys.d.ts","sourceRoot":"","sources":["../../../src/spectra/ui/rowKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAMvD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAIzE;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,CAAC,EAAE,CAKL"}

package/lib/spectra/ui/rowKeys.js

@@ -0,0 +1,45 @@
+/**
+ * A key no row is using yet.
+ *
+ * A row of the settings — a zone, a matrix step, a range — carries no identity
+ * of its own, so one is kept beside the list. Without it React reuses a removed
+ * row's box for the row that slides up, and the half-typed number in it goes
+ * with the wrong entry.
+ * @param keys - The keys in force.
+ * @returns The next free one.
+ */
+export function nextKey(keys) {
+    let highest = -1;
+    for (const key of keys) {
+        if (key > highest)
+            highest = key;
+    }
+    return highest + 1;
+}
+/**
+ * The keys brought back in step with a list that changed from outside.
+ * @param keys - The keys in force.
+ * @param length - How many rows there now are.
+ * @returns One key per row.
+ */
+export function fitKeys(keys, length) {
+    const fitted = keys.slice(0, length);
+    while (fitted.length < length)
+        fitted.push(nextKey(fitted));
+    return fitted;
+}
+/**
+ * A list with one entry moved to another position.
+ * @param list - What to reorder.
+ * @param index - Which entry to move.
+ * @param target - Where it lands.
+ * @returns A new list.
+ */
+export function reorder(list, index, target) {
+    const moved = [...list];
+    const [entry] = moved.splice(index, 1);
+    if (entry !== undefined)
+        moved.splice(target, 0, entry);
+    return moved;
+}
+//# sourceMappingURL=rowKeys.js.map

package/lib/spectra/ui/rowKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowKeys.js","sourceRoot":"","sources":["../../../src/spectra/ui/rowKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO,CAAC,IAAuB;IAC7C,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;IACjB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,GAAG,OAAO;YAAE,OAAO,GAAG,GAAG,CAAC;IACnC,CAAC;IACD,OAAO,OAAO,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAuB,EAAE,MAAc;IAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,MAAM,GAAG,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CACrB,IAAkB,EAClB,KAAa,EACb,MAAc;IAEd,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACxB,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACvC,IAAI,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IACxD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/spectra/ui/scaleOptions.d.ts

@@ -0,0 +1,50 @@
+import type { ScaleSettings } from '../core/settings.ts';
+/** The stretch of x a scaling is measured over. */
+export type ScaleRange = NonNullable<ScaleSettings['range']>;
+/** The method menu: leaving the spectra alone, then the only four that run. */
+export declare const SCALE_METHOD_OPTIONS: ReadonlyArray<{
+    value: string;
+    label: string;
+}>;
+/**
+ * The method menu with whatever the settings actually hold in it.
+ *
+ * A menu that does not carry the held value draws the first option instead, so
+ * a settings object saying `MAX` — or saying something the processor throws on
+ * — would be shown as `None` while meaning nothing of the sort. The held
+ * spelling is added rather than corrected, because the panel reports what the
+ * settings say and never quietly rewrites them.
+ * @param method - What the settings hold.
+ * @returns The None prompt and the four scalings, plus the held one when the
+ * menu lacks it.
+ */
+export declare function scaleMethodOptions(method: string | undefined): ReadonlyArray<{
+    value: string;
+    label: string;
+}>;
+/**
+ * The scaling with another method, or with none when `None` is picked.
+ *
+ * A picked `None` drops the key rather than writing an empty string, because
+ * the processor reads any falsy method as "do not scale" and a key that is
+ * there but empty reads, to anyone looking at the settings, as a mistake.
+ * @param value - How every spectrum is scaled.
+ * @param method - What was picked.
+ * @returns A new scaling.
+ */
+export declare function withScaleMethod(value: ScaleSettings, method: string): ScaleSettings;
+/**
+ * The scaling with another reference, or with none when the box was emptied.
+ * @param value - How every spectrum is scaled.
+ * @param targetID - What was picked or typed.
+ * @returns A new scaling.
+ */
+export declare function withScaleTarget(value: ScaleSettings, targetID: string): ScaleSettings;
+/**
+ * The scaling measured over another window, dropping what is not set.
+ * @param value - How every spectrum is scaled.
+ * @param patch - The bounds that changed.
+ * @returns A new scaling, without a window at all once every bound is cleared.
+ */
+export declare function withScaleRange(value: ScaleSettings, patch: ScaleRange): ScaleSettings;
+//# sourceMappingURL=scaleOptions.d.ts.map

package/lib/spectra/ui/scaleOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaleOptions.d.ts","sourceRoot":"","sources":["../../../src/spectra/ui/scaleOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,mDAAmD;AACnD,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAU7D,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAMA,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBjD;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,GACb,aAAa,CAKf;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,GACf,aAAa,CAKf;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,UAAU,GAChB,aAAa,CAYf"}

package/lib/spectra/ui/scaleOptions.js

@@ -0,0 +1,103 @@
+import { SCALE_METHODS } from "../core/settingsProblems.js";
+/** What each scaling is called, in the order the processor's switch lists them. */
+const METHOD_LABELS = {
+    min: 'Smallest value',
+    max: 'Largest value',
+    minmax: 'Both ends',
+    integration: 'Integral',
+};
+/** The method menu: leaving the spectra alone, then the only four that run. */
+export const SCALE_METHOD_OPTIONS = [
+    { value: '', label: 'None — every spectrum is left as it is' },
+    ...SCALE_METHODS.map((method) => ({
+        value: method,
+        label: METHOD_LABELS[method] ?? method,
+    })),
+];
+/**
+ * The method menu with whatever the settings actually hold in it.
+ *
+ * A menu that does not carry the held value draws the first option instead, so
+ * a settings object saying `MAX` — or saying something the processor throws on
+ * — would be shown as `None` while meaning nothing of the sort. The held
+ * spelling is added rather than corrected, because the panel reports what the
+ * settings say and never quietly rewrites them.
+ * @param method - What the settings hold.
+ * @returns The None prompt and the four scalings, plus the held one when the
+ * menu lacks it.
+ */
+export function scaleMethodOptions(method) {
+    if (method === undefined || method === '')
+        return SCALE_METHOD_OPTIONS;
+    for (const option of SCALE_METHOD_OPTIONS) {
+        if (option.value === method)
+            return SCALE_METHOD_OPTIONS;
+    }
+    const known = METHOD_LABELS[method.toLowerCase()];
+    return [
+        ...SCALE_METHOD_OPTIONS,
+        {
+            value: method,
+            label: known === undefined
+                ? `${method} — not a scaling the processor knows`
+                : `${method} — ${known}`,
+        },
+    ];
+}
+/**
+ * The scaling with another method, or with none when `None` is picked.
+ *
+ * A picked `None` drops the key rather than writing an empty string, because
+ * the processor reads any falsy method as "do not scale" and a key that is
+ * there but empty reads, to anyone looking at the settings, as a mistake.
+ * @param value - How every spectrum is scaled.
+ * @param method - What was picked.
+ * @returns A new scaling.
+ */
+export function withScaleMethod(value, method) {
+    const next = { ...value };
+    if (method === '')
+        delete next.method;
+    else
+        next.method = method;
+    return next;
+}
+/**
+ * The scaling with another reference, or with none when the box was emptied.
+ * @param value - How every spectrum is scaled.
+ * @param targetID - What was picked or typed.
+ * @returns A new scaling.
+ */
+export function withScaleTarget(value, targetID) {
+    const next = { ...value };
+    if (targetID === '')
+        delete next.targetID;
+    else
+        next.targetID = targetID;
+    return next;
+}
+/**
+ * The scaling measured over another window, dropping what is not set.
+ * @param value - How every spectrum is scaled.
+ * @param patch - The bounds that changed.
+ * @returns A new scaling, without a window at all once every bound is cleared.
+ */
+export function withScaleRange(value, patch) {
+    const merged = { ...value.range, ...patch };
+    const range = {};
+    if (merged.from !== undefined)
+        range.from = merged.from;
+    if (merged.to !== undefined)
+        range.to = merged.to;
+    if (merged.fromIndex !== undefined)
+        range.fromIndex = merged.fromIndex;
+    if (merged.toIndex !== undefined)
+        range.toIndex = merged.toIndex;
+    const next = { ...value };
+    if (Object.keys(range).length === 0)
+        delete next.range;
+    else
+        next.range = range;
+    return next;
+}
+//# sourceMappingURL=scaleOptions.js.map

package/lib/spectra/ui/scaleOptions.js.map

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

package/lib/structure/ui/StructureEditor.js

@@ -66,7 +66,7 @@ const ROOT_STYLE = {
     position: 'relative',
     overflow: 'hidden',
     boxSizing: 'border-box',
-    border: '1px solid #d3d8de',
+    border: '1px solid var(--border, #d3d8de)',
     borderRadius: 6,
     background: '#fff',
 };
@@ -77,7 +77,7 @@ const LOADING_STYLE = {
     display: 'flex',
     alignItems: 'center',
     justifyContent: 'center',
-    color: '#8a96a3',
+    color: 'var(--text-faint, #8a96a3)',
     fontSize: 13,
 };
 //# sourceMappingURL=StructureEditor.js.map

package/lib/structure/ui/StructureEditor.js.map

@@ -1 +1 @@
-{"version":3,"file":"StructureEditor.js","sourceRoot":"","sources":["../../../src/structure/ui/StructureEditor.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"StructureEditor.js","sourceRoot":"","sources":["../../../src/structure/ui/StructureEditor.tsx"],"names":[],"mappings":"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"}

package/lib/structure/ui/StructurePlaceholder.js

@@ -13,7 +13,7 @@ const PLACEHOLDER_STYLE = {
     display: 'inline-flex',
     alignItems: 'center',
     justifyContent: 'center',
-    color: '#8a96a3',
+    color: 'var(--text-faint, #8a96a3)',
     fontSize: '0.75rem',
 };
 //# sourceMappingURL=StructurePlaceholder.js.map

package/lib/structure/ui/StructurePlaceholder.js.map

@@ -1 +1 @@
-{"version":3,"file":"StructurePlaceholder.js","sourceRoot":"","sources":["../../../src/structure/ui/StructurePlaceholder.tsx"],"names":[],"mappings":";AAwBA;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAgC;IAEhC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAC1C,OAAO,CACL,eAAM,KAAK,EAAE,EAAE,GAAG,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAc,MAAM,YACrE,QAAQ,GACJ,CACR,CAAC;AACJ,CAAC;AAED,MAAM,iBAAiB,GAAkB;IACvC,OAAO,EAAE,aAAa;IACtB,UAAU,EAAE,QAAQ;IACpB,cAAc,EAAE,QAAQ;IACxB,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,SAAS;CACpB,CAAC"}
+{"version":3,"file":"StructurePlaceholder.js","sourceRoot":"","sources":["../../../src/structure/ui/StructurePlaceholder.tsx"],"names":[],"mappings":";AAwBA;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAgC;IAEhC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAC1C,OAAO,CACL,eAAM,KAAK,EAAE,EAAE,GAAG,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAc,MAAM,YACrE,QAAQ,GACJ,CACR,CAAC;AACJ,CAAC;AAED,MAAM,iBAAiB,GAAkB;IACvC,OAAO,EAAE,aAAa;IACtB,UAAU,EAAE,QAAQ;IACpB,cAAc,EAAE,QAAQ;IACxB,KAAK,EAAE,4BAA4B;IACnC,QAAQ,EAAE,SAAS;CACpB,CAAC"}

package/lib/tokens/core/checkTokens.d.ts

@@ -0,0 +1,51 @@
+/** What a site got wrong where a token was called for. */
+export type TokenViolationKind = 'blueprint-grey' | 'blueprint-blue' | 'retyped-token' | 'redeclared-brand';
+/** One place a site writes a colour that is not its own to write. */
+export interface TokenViolation {
+    /** The file it is written in, named as the caller named it. */
+    file: string;
+    /** Which line, counting from 1. */
+    line: number;
+    /** Which column, counting from 1. */
+    column: number;
+    /** What kind of mistake it is. */
+    kind: TokenViolationKind;
+    /** The text as written — the hex, the `rgb()` call, the property name. */
+    text: string;
+    /** The token to use instead, in one line. */
+    hint: string;
+}
+/** How forgiving a scan is. */
+export interface CheckTokensOptions {
+    /**
+     * Colours the project legitimately owns — a subject-matter palette, a logo
+     * of somebody else.
+     * @default []
+     */
+    allow?: readonly string[];
+    /**
+     * Lines carrying this marker are skipped, for the rare deliberate literal.
+     * @default 'tokens-ok'
+     */
+    ignoreMarker?: string;
+}
+/**
+ * Every colour a set of files writes that belongs to the family rather than to
+ * the site.
+ *
+ * The neutrals, the geometry and the type are shared, and the two colours a
+ * site owns come from `<SiteTheme siteId>`; a site that re-types either — a
+ * Blueprint grey because a component used it, `#f5f7fa` because that is what
+ * the token holds today, `--brand` because the palette was declared by hand —
+ * leaves its page unable to follow the family. Both spellings of one colour
+ * are caught, `#5f6b7c` and `rgb(95 107 124)` alike, and reading a token
+ * through `var()` is never a violation.
+ * @param files - The files to read, each with the path a report names it by.
+ * @param options - The colours the project owns, and the marker waiving a line.
+ * @returns Every violation, in file order and then in reading order.
+ */
+export declare function findTokenViolations(files: ReadonlyArray<{
+    path: string;
+    text: string;
+}>, options?: CheckTokensOptions): TokenViolation[];
+//# sourceMappingURL=checkTokens.d.ts.map

package/lib/tokens/core/checkTokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkTokens.d.ts","sourceRoot":"","sources":["../../../src/tokens/core/checkTokens.ts"],"names":[],"mappings":"AAIA,0DAA0D;AAC1D,MAAM,MAAM,kBAAkB,GAC5B,gBAAgB,GAAG,gBAAgB,GAAG,eAAe,GAAG,kBAAkB,CAAC;AAE7E,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,EAAE,kBAAkB,CAAC;IACzB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACpD,OAAO,GAAE,kBAAuB,GAC/B,cAAc,EAAE,CA6BlB"}