react-cheminfo 0.11.0 → 0.12.0

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.d.ts

@@ -8,7 +8,7 @@
  */
 import type { ReactElement, ReactNode } from 'react';
 /** Props of {@link StructurePlaceholder}. */
-export interface StructurePlaceholderProps {
+interface StructurePlaceholderProps {
     /** Width of the box, in pixels: the width the picture would have had. */
     width: number;
     /** Height of the box, in pixels. */
@@ -26,4 +26,5 @@ export interface StructurePlaceholderProps {
  * @returns The placeholder.
  */
 export declare function StructurePlaceholder(props: StructurePlaceholderProps): ReactElement;
+export {};
 //# sourceMappingURL=StructurePlaceholder.d.ts.map

package/lib/structure/ui/StructurePlaceholder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StructurePlaceholder.d.ts","sourceRoot":"","sources":["../../../src/structure/ui/StructurePlaceholder.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAiB,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEpE,6CAA6C;AAC7C,MAAM,WAAW,yBAAyB;IACxC,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,yBAAyB,GAC/B,YAAY,CAOd"}
+{"version":3,"file":"StructurePlaceholder.d.ts","sourceRoot":"","sources":["../../../src/structure/ui/StructurePlaceholder.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAiB,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIpE,6CAA6C;AAC7C,UAAU,yBAAyB;IACjC,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,yBAAyB,GAC/B,YAAY,CAOd"}

package/lib/structure/ui/StructurePlaceholder.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { TOKEN } from "../../tokens/core/familyTokens.js";
 /**
  * A box the size of the picture that is not there, holding whatever the caller
  * wants said instead.
@@ -13,7 +14,7 @@ const PLACEHOLDER_STYLE = {
     display: 'inline-flex',
     alignItems: 'center',
     justifyContent: 'center',
-    color: 'var(--text-faint, #8a96a3)',
+    color: TOKEN.textFaint,
     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,4BAA4B;IACnC,QAAQ,EAAE,SAAS;CACpB,CAAC"}
+{"version":3,"file":"StructurePlaceholder.js","sourceRoot":"","sources":["../../../src/structure/ui/StructurePlaceholder.tsx"],"names":[],"mappings":";AAWA,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAe1D;;;;;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,KAAK,CAAC,SAAS;IACtB,QAAQ,EAAE,SAAS;CACpB,CAAC"}

package/lib/structure/ui/StructureSvg.d.ts

@@ -3,14 +3,15 @@
  * picked.
  *
  * `Structure` holds it behind `React.lazy`, and the barrel deliberately does
- * not export it: this is the file that value-imports react-ocl, so
- * anything able to reach it statically drags openchemlib into every bundle,
- * including the ones that only ever wanted the Tools menu.
+ * not export it: this is the file that value-imports react-ocl and
+ * openchemlib, so anything able to reach it statically drags openchemlib into
+ * every bundle, including the ones that only ever wanted the Tools menu.
  */
 import type { ReactElement, ReactNode } from 'react';
+import type { AtomLabelPlacement } from '../core/atomLabels.ts';
 import type { StructureSource } from '../core/structureSource.ts';
 /** Props of {@link StructureSvg}. */
-export interface StructureSvgProps {
+interface StructureSvgProps {
     /** The notation to draw, as `structureSource` picked it. */
     source: StructureSource;
     /** Width of the picture, in pixels. */
@@ -41,18 +42,38 @@ export interface StructureSvgProps {
     showBondNumber: boolean;
     /** Write the reaction mapping number of every mapped atom. */
     showMapping: boolean;
+    /** Write the CIP descriptor, R or S, next to every stereocentre. */
+    showCIPParity: boolean;
     /**
      * A caption drawn inside the picture, under the structure.
      * @default undefined
      */
     label?: string;
-    /** What is shown in place of a structure react-ocl refuses to read. */
+    /**
+     * Text written on atoms, keyed by atom index from 0.
+     * @default undefined
+     */
+    atomLabels?: ReadonlyMap<number, string>;
+    /** Where the atom labels are written. */
+    atomLabelPlacement: AtomLabelPlacement;
+    /**
+     * Called with the index of the atom that was clicked.
+     * @default undefined
+     */
+    onAtomClick?: (atom: number) => void;
+    /**
+     * Called with the index of the bond that was clicked.
+     * @default undefined
+     */
+    onBondClick?: (bond: number) => void;
+    /** What is shown in place of a structure openchemlib refuses to read. */
     fallback: ReactNode;
 }
 /**
- * Draw the picture with the renderer the notation calls for.
+ * Read the notation and draw the picture.
  * @param props - See {@link StructureSvgProps}.
  * @returns The svg, or the placeholder when the notation cannot be read.
  */
 export declare function StructureSvg(props: StructureSvgProps): ReactElement;
+export {};
 //# sourceMappingURL=StructureSvg.d.ts.map

package/lib/structure/ui/StructureSvg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StructureSvg.d.ts","sourceRoot":"","sources":["../../../src/structure/ui/StructureSvg.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAiB,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAIlE,qCAAqC;AACrC,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,MAAM,EAAE,eAAe,CAAC;IACxB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,oDAAoD;IACpD,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,oDAAoD;IACpD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;IACxB,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;IACxB,8DAA8D;IAC9D,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAsBnE"}
+{"version":3,"file":"StructureSvg.d.ts","sourceRoot":"","sources":["../../../src/structure/ui/StructureSvg.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAIlE,qCAAqC;AACrC,UAAU,iBAAiB;IACzB,4DAA4D;IAC5D,MAAM,EAAE,eAAe,CAAC;IACxB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,oDAAoD;IACpD,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,oDAAoD;IACpD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;IACxB,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;IACxB,8DAA8D;IAC9D,WAAW,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,aAAa,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,yCAAyC;IACzC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,yEAAyE;IACzE,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAoDnE"}

package/lib/structure/ui/StructureSvg.js

@@ -1,33 +1,74 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The react-ocl depiction of a structure whose notation has already been
+ * picked.
+ *
+ * `Structure` holds it behind `React.lazy`, and the barrel deliberately does
+ * not export it: this is the file that value-imports react-ocl and
+ * openchemlib, so anything able to reach it statically drags openchemlib into
+ * every bundle, including the ones that only ever wanted the Tools menu.
+ */
+import { Molecule } from 'openchemlib';
 import { useMemo } from 'react';
-import { IdcodeSvgRenderer, MolfileSvgRenderer, SmilesSvgRenderer, } from 'react-ocl';
+import { SvgRenderer } from 'react-ocl';
+import { applyAtomLabels } from "../core/atomLabels.js";
 import { StructurePlaceholder } from "./StructurePlaceholder.js";
 /**
- * Draw the picture with the renderer the notation calls for.
+ * Read the notation and draw the picture.
  * @param props - See {@link StructureSvgProps}.
  * @returns The svg, or the placeholder when the notation cannot be read.
  */
 export function StructureSvg(props) {
-    const { source, fallback, ...rest } = props;
-    const ErrorComponent = useMemo(() => createFallbackRenderer(fallback), [fallback]);
-    const shared = { ...rest, ErrorComponent };
-    if (source.kind === 'idcode') {
-        return (_jsx(IdcodeSvgRenderer, { idcode: source.value, coordinates: source.coordinates, ...shared }));
-    }
-    if (source.kind === 'molfile') {
-        return _jsx(MolfileSvgRenderer, { molfile: source.value, ...shared });
+    const { source, fallback, atomLabels, atomLabelPlacement, onAtomClick, onBondClick, showCIPParity, ...rest } = props;
+    const { kind, value, coordinates } = source;
+    // A map a caller builds during render is a new object every time; its
+    // content is what decides whether the molecule has to be read again.
+    const labelsKey = atomLabels === undefined ? '' : JSON.stringify([...atomLabels]);
+    const drawing = useMemo(() => readDrawing(kind, value, coordinates, labelsKey, atomLabelPlacement), [kind, value, coordinates, labelsKey, atomLabelPlacement]);
+    if (drawing === null) {
+        return (_jsx(StructurePlaceholder, { width: rest.width, height: rest.height, children: fallback }));
     }
-    return _jsx(SmilesSvgRenderer, { smiles: source.value, ...shared });
+    return (_jsx(SvgRenderer, { ...rest, molecule: drawing.molecule, noCarbonLabelWithCustomLabel: drawing.labelled, suppressCIPParity: !showCIPParity, onAtomClick: onAtomClick === undefined
+            ? undefined
+            : (atom) => {
+                onAtomClick(atom);
+            }, onBondClick: onBondClick === undefined
+            ? undefined
+            : (bond) => {
+                onBondClick(bond);
+            } }));
 }
 /**
- * Build the renderer react-ocl falls back to, so a structure it refuses looks
- * like one that was never supplied rather than like an error.
- * @param fallback - What the caller wants shown instead of the structure.
- * @returns The component react-ocl renders in place of the picture.
+ * Parse the notation and write the labels on the result.
+ * @param kind - Which notation `value` is written in.
+ * @param value - The notation.
+ * @param coordinates - The idCode's encoded coordinates, when it has them.
+ * @param labelsKey - The atom labels, as `JSON.stringify` wrote their entries;
+ * empty for none.
+ * @param placement - Where the labels go.
+ * @returns The molecule, or `null` when it cannot be read or holds no atom.
  */
-function createFallbackRenderer(fallback) {
-    return function StructureFallback(props) {
-        return (_jsx(StructurePlaceholder, { width: props.width, height: props.height, children: fallback }));
-    };
+function readDrawing(kind, value, coordinates, labelsKey, placement) {
+    let molecule;
+    try {
+        molecule = parseMolecule(kind, value, coordinates);
+    }
+    catch {
+        return null;
+    }
+    if (molecule.getAllAtoms() === 0)
+        return null;
+    if (labelsKey === '')
+        return { molecule, labelled: false };
+    const labels = new Map(JSON.parse(labelsKey));
+    const written = applyAtomLabels(molecule, labels, placement);
+    return { molecule, labelled: written > 0 };
+}
+function parseMolecule(kind, value, coordinates) {
+    if (kind === 'idcode')
+        return Molecule.fromIDCode(value, coordinates);
+    if (kind === 'molfile')
+        return Molecule.fromMolfile(value);
+    return Molecule.fromSmiles(value);
 }
 //# sourceMappingURL=StructureSvg.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"StructureSvg.js","sourceRoot":"","sources":["../../../src/structure/ui/StructureSvg.tsx"],"names":[],"mappings":";AAWA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAInB,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA4B,CAAC;AA2ClE;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IAE5C,MAAM,cAAc,GAAG,OAAO,CAC5B,GAAG,EAAE,CAAC,sBAAsB,CAAC,QAAQ,CAAC,EACtC,CAAC,QAAQ,CAAC,CACX,CAAC;IACF,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,cAAc,EAAE,CAAC;IAE3C,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,CACL,KAAC,iBAAiB,IAChB,MAAM,EAAE,MAAM,CAAC,KAAK,EACpB,WAAW,EAAE,MAAM,CAAC,WAAW,KAC3B,MAAM,GACV,CACH,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,KAAC,kBAAkB,IAAC,OAAO,EAAE,MAAM,CAAC,KAAK,KAAM,MAAM,GAAI,CAAC;IACnE,CAAC;IACD,OAAO,KAAC,iBAAiB,IAAC,MAAM,EAAE,MAAM,CAAC,KAAK,KAAM,MAAM,GAAI,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,SAAS,sBAAsB,CAC7B,QAAmB;IAEnB,OAAO,SAAS,iBAAiB,CAAC,KAA0B;QAC1D,OAAO,CACL,KAAC,oBAAoB,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,YAC3D,QAAQ,GACY,CACxB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"StructureSvg.js","sourceRoot":"","sources":["../../../src/structure/ui/StructureSvg.tsx"],"names":[],"mappings":"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"}

package/lib/structure/ui/useToolbarFloor.d.ts

@@ -1,4 +1,5 @@
 import type { RefObject } from 'react';
+/** What {@link useToolbarFloor} needs. */
 export interface ToolbarFloorOptions {
     /**
      * Smallest height of the drawing area, in pixels. Raised to whatever the

package/lib/structure/ui/useToolbarFloor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useToolbarFloor.d.ts","sourceRoot":"","sources":["../../../src/structure/ui/useToolbarFloor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,OAAO,GAAE,mBAAwB,GAChC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAyClC"}
+{"version":3,"file":"useToolbarFloor.d.ts","sourceRoot":"","sources":["../../../src/structure/ui/useToolbarFloor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,OAAO,GAAE,mBAAwB,GAChC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAyClC"}

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

@@ -1 +1 @@
-{"version":3,"file":"useToolbarFloor.js","sourceRoot":"","sources":["../../../src/structure/ui/useToolbarFloor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAiB7D;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,UAA+B,EAAE;IAEjC,MAAM,EAAE,SAAS,GAAG,GAAG,EAAE,QAAQ,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAClD,MAAM,YAAY,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAElD,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;QACvC,IAAI,SAAS,KAAK,IAAI;YAAE,OAAO;QAE/B,IAAI,QAAQ,GAA0B,IAAI,CAAC;QAC3C,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,QAAQ,GAAG,CAAC,CAAC;QAEjB,yEAAyE;QACzE,0EAA0E;QAC1E,sEAAsE;QACtE,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;YACvC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,QAAQ,EAAE,CAAC;gBACX,IAAI,QAAQ,GAAG,YAAY;oBAAE,OAAO;gBACpC,KAAK,GAAG,UAAU,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;gBACjD,OAAO;YACT,CAAC;YACD,QAAQ,GAAG,IAAI,cAAc,CAAC,GAAG,EAAE;gBACjC,uEAAuE;gBACvE,8DAA8D;gBAC9D,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;gBAClE,SAAS,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,KAAK,IAAI,CAAC;YAC3C,CAAC,CAAC,CAAC;YACH,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC,CAAC;QAEF,MAAM,EAAE,CAAC;QAET,OAAO,GAAG,EAAE;YACV,IAAI,KAAK,KAAK,CAAC;gBAAE,UAAU,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;YACxD,QAAQ,EAAE,UAAU,EAAE,CAAC;QACzB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE1B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,2EAA2E;AAC3E,MAAM,YAAY,GAAG,GAAG,CAAC;AAEzB;;;;;;;GAOG;AACH,SAAS,WAAW,CAAC,SAAsB;IACzC,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QACtD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,UAAU,EAAE,QAAQ,IAAI,EAAE,EAAE,CAAC;YACvD,IAAI,KAAK,YAAY,iBAAiB;gBAAE,OAAO,KAAK,CAAC;QACvD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"useToolbarFloor.js","sourceRoot":"","sources":["../../../src/structure/ui/useToolbarFloor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAkB7D;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,UAA+B,EAAE;IAEjC,MAAM,EAAE,SAAS,GAAG,GAAG,EAAE,QAAQ,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAClD,MAAM,YAAY,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAElD,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;QACvC,IAAI,SAAS,KAAK,IAAI;YAAE,OAAO;QAE/B,IAAI,QAAQ,GAA0B,IAAI,CAAC;QAC3C,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,QAAQ,GAAG,CAAC,CAAC;QAEjB,yEAAyE;QACzE,0EAA0E;QAC1E,sEAAsE;QACtE,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;YACvC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,QAAQ,EAAE,CAAC;gBACX,IAAI,QAAQ,GAAG,YAAY;oBAAE,OAAO;gBACpC,KAAK,GAAG,UAAU,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;gBACjD,OAAO;YACT,CAAC;YACD,QAAQ,GAAG,IAAI,cAAc,CAAC,GAAG,EAAE;gBACjC,uEAAuE;gBACvE,8DAA8D;gBAC9D,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;gBAClE,SAAS,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,KAAK,IAAI,CAAC;YAC3C,CAAC,CAAC,CAAC;YACH,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC,CAAC;QAEF,MAAM,EAAE,CAAC;QAET,OAAO,GAAG,EAAE;YACV,IAAI,KAAK,KAAK,CAAC;gBAAE,UAAU,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;YACxD,QAAQ,EAAE,UAAU,EAAE,CAAC;QACzB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE1B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,2EAA2E;AAC3E,MAAM,YAAY,GAAG,GAAG,CAAC;AAEzB;;;;;;;GAOG;AACH,SAAS,WAAW,CAAC,SAAsB;IACzC,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QACtD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,UAAU,EAAE,QAAQ,IAAI,EAAE,EAAE,CAAC;YACvD,IAAI,KAAK,YAAY,iBAAiB;gBAAE,OAAO,KAAK,CAAC;QACvD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -1,5 +1,4 @@
-/** What a site got wrong where a token was called for. */
-export type TokenViolationKind = 'blueprint-grey' | 'blueprint-blue' | 'retyped-token' | 'redeclared-brand';
+import type { TokenViolationKind } from './types.ts';
 /** 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. */
@@ -28,6 +27,14 @@ export interface CheckTokensOptions {
      * @default 'tokens-ok'
      */
     ignoreMarker?: string;
+    /**
+     * Whether the fallback written inside `var()` is read too: the fallback of
+     * one of the family's tokens that is not that token's value in `chrome.css`,
+     * and a banned colour in the fallback of any other property, are then
+     * reported.
+     * @default false
+     */
+    fallbacks?: boolean;
 }
 /**
  * Every colour a set of files writes that belongs to the family rather than to
@@ -38,8 +45,9 @@ export interface CheckTokensOptions {
  * 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.
+ * are caught, `#5f6b7c` and `rgb(95 107 124)` alike. Reading a token through
+ * `var()` is never a violation; its fallback is read only when `fallbacks` is
+ * set.
  * @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.

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

@@ -1 +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"}
+{"version":3,"file":"checkTokens.d.ts","sourceRoot":"","sources":["../../../src/tokens/core/checkTokens.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,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;IACtB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;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"}

package/lib/tokens/core/checkTokens.js

@@ -1,5 +1,6 @@
 // tokens-ok: file — the checker names the colours it looks for.
 import { normalizeColor, readHexColor, readRgbColor } from "./colors.js";
+import { driftedFallback, readBrandDeclaration, readVarToken, } from "./cssReading.js";
 import { BANNED_COLORS } from "./rules.js";
 /**
  * Every colour a set of files writes that belongs to the family rather than to
@@ -10,8 +11,9 @@ import { BANNED_COLORS } from "./rules.js";
  * 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.
+ * are caught, `#5f6b7c` and `rgb(95 107 124)` alike. Reading a token through
+ * `var()` is never a violation; its fallback is read only when `fallbacks` is
+ * set.
  * @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.
@@ -31,7 +33,7 @@ export function findTokenViolations(files, options = {}) {
         // colours, an image generated outside any page.
         if (waivesWholeFile(file.text, marker))
             continue;
-        const scan = scanFile(file.text, marker);
+        const scan = scanFile(file.text, marker, options.fallbacks === true);
         for (const candidate of scan.candidates) {
             if (scan.markedLines.has(candidate.line))
                 continue;
@@ -59,11 +61,9 @@ function waivesWholeFile(text, marker) {
     const head = text.split('\n', WAIVER_LINES).join('\n').toLowerCase();
     return head.includes(`${marker}: file`);
 }
-// Longest first, so `--brand-alt` is never read as `--brand`.
-const BRAND_PROPERTIES = ['--brand-alt', '--brand', '--accent'];
 // One pass over the file: the marker, the block structure and every colour are
 // all read from the same walk, so nothing is matched a second time per line.
-function scanFile(text, marker) {
+function scanFile(text, marker, checkFallbacks) {
     const lower = text.toLowerCase();
     const candidates = [];
     const markedLines = new Set();
@@ -89,20 +89,33 @@ function scanFile(text, marker) {
             continue;
         }
         if (char === '(') {
+            const isVar = lower.startsWith('var(', index - 3);
             parens.push({
-                isVar: lower.startsWith('var(', index - 3),
-                sawComma: false,
+                isVar,
+                token: isVar ? readVarToken(lower, index + 1) : null,
+                fallbackStart: -1,
+                fallbackLine: line,
+                fallbackLineStart: lineStart,
             });
             continue;
         }
         if (char === ')') {
-            parens.pop();
+            const open = parens.pop();
+            if (checkFallbacks && open !== undefined) {
+                const drifted = driftedFallback(text, open, index);
+                if (drifted !== null) {
+                    candidates.push({ ...drifted, kind: 'drifted-fallback' });
+                }
+            }
             continue;
         }
         if (char === ',') {
             const open = parens.at(-1);
-            if (open !== undefined)
-                open.sawComma = true;
+            if (open?.fallbackStart === -1) {
+                open.fallbackStart = index + 1;
+                open.fallbackLine = line;
+                open.fallbackLineStart = lineStart;
+            }
             continue;
         }
         if (char === '{') {
@@ -122,8 +135,11 @@ function scanFile(text, marker) {
                 continue;
             const rule = BANNED_COLORS.get(match.color);
             const open = parens.at(-1);
-            const isFallback = open !== undefined && open.isVar && open.sawComma;
-            if (rule !== undefined && !isFallback) {
+            const isFallback = open?.isVar === true && open.fallbackStart !== -1;
+            // A token's own fallback is judged whole when its `var(` closes; the
+            // fallback of any other property still may not be a banned colour.
+            const judged = !isFallback || (checkFallbacks && open.token === null);
+            if (rule !== undefined && judged) {
                 candidates.push({
                     line,
                     column: index - lineStart + 1,
@@ -155,34 +171,4 @@ function scanFile(text, marker) {
     }
     return { candidates, markedLines };
 }
-// A declaration of one of the palette properties. Reading one — `var(--brand)`
-// — has no colon after the name, so it never lands here.
-function readBrandDeclaration(lower, start) {
-    for (const name of BRAND_PROPERTIES) {
-        if (!lower.startsWith(name, start))
-            continue;
-        const after = start + name.length;
-        // `--brand-alt-text` is its own property, not `--brand-alt`.
-        if (isNameChar(lower[after]))
-            return null;
-        let index = after;
-        while (isSpace(lower[index]))
-            index++;
-        if (lower[index] !== ':')
-            return null;
-        return { name, end: after };
-    }
-    return null;
-}
-function isNameChar(char) {
-    if (char === undefined)
-        return false;
-    return ((char >= '0' && char <= '9') ||
-        (char >= 'a' && char <= 'z') ||
-        char === '-' ||
-        char === '_');
-}
-function isSpace(char) {
-    return char === ' ' || char === '\t';
-}
 //# sourceMappingURL=checkTokens.js.map

package/lib/tokens/core/checkTokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"checkTokens.js","sourceRoot":"","sources":["../../../src/tokens/core/checkTokens.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"checkTokens.js","sourceRoot":"","sources":["../../../src/tokens/core/checkTokens.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA0C3C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAoD,EACpD,UAA8B,EAAE;IAEhC,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,qBAAqB,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7E,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,UAAU,GAAqB,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,yEAAyE;QACzE,qEAAqE;QACrE,gDAAgD;QAChD,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;YAAE,SAAS;QACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC;QACrE,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACxC,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;gBAAE,SAAS;YACnD,IAAI,SAAS,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC;gBAAE,SAAS;YACvE,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,MAAM,EAAE,SAAS,CAAC,MAAM;gBACxB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,IAAI,EAAE,SAAS,CAAC,IAAI;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,qBAAqB,GAAG,WAAW,CAAC;AAE1C,0EAA0E;AAC1E,sEAAsE;AACtE,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB,SAAS,eAAe,CAAC,IAAY,EAAE,MAAc;IACnD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACrE,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,MAAM,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAYD,+EAA+E;AAC/E,6EAA6E;AAC7E,SAAS,QAAQ,CACf,IAAY,EACZ,MAAc,EACd,cAAuB;IAEvB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,MAAM,UAAU,GAAc,EAAE,CAAC;IACjC,4EAA4E;IAC5E,8DAA8D;IAC9D,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,IAAI,EAAE,CAAC;YACP,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC;YACtB,SAAS;QACX,CAAC;QACD,IACE,MAAM,CAAC,MAAM,GAAG,CAAC;YACjB,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC;YAClB,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,EAC/B,CAAC;YACD,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtB,KAAK,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK;gBACL,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;gBACpD,aAAa,EAAE,CAAC,CAAC;gBACjB,YAAY,EAAE,IAAI;gBAClB,iBAAiB,EAAE,SAAS;aAC7B,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;YAC1B,IAAI,cAAc,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACzC,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;gBACnD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;oBACrB,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBAC5D,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,IAAI,EAAE,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC,aAAa,GAAG,KAAK,GAAG,CAAC,CAAC;gBAC/B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;gBACzB,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;YACrC,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YACrE,aAAa,GAAG,KAAK,GAAG,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjC,IAAI,IAAI,KAAK,GAAG;gBAAE,UAAU,CAAC,GAAG,EAAE,CAAC;YACnC,aAAa,GAAG,KAAK,GAAG,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjC,MAAM,KAAK,GACT,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACzE,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAS;YAC7B,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,UAAU,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC;YACrE,qEAAqE;YACrE,mEAAmE;YACnE,MAAM,MAAM,GAAG,CAAC,UAAU,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;YACtE,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,EAAE,CAAC;gBACjC,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI;oBACJ,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,CAAC;oBAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC;oBAClC,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,KAAK,EAAE,KAAK,CAAC,KAAK;iBACnB,CAAC,CAAC;YACL,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;YACtB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACpD,IAAI,QAAQ,KAAK,IAAI;gBAAE,SAAS;YAChC,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI;oBACJ,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,CAAC;oBAC7B,IAAI,EAAE,kBAAkB;oBACxB,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,IAAI,EAAE,kDAAkD,QAAQ,CAAC,IAAI,YAAY;oBACjF,KAAK,EAAE,IAAI;iBACZ,CAAC,CAAC;YACL,CAAC;YACD,KAAK,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;AACrC,CAAC"}

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

@@ -5,7 +5,7 @@
  * colour rather than one per way of typing it.
  */
 /** A colour found in the text, and where it ends. */
-export interface ColorMatch {
+interface ColorMatch {
     /** The value, as six lowercase hex digits, without its `#`. */
     color: string;
     /** The index just past the last character the colour is written with. */
@@ -39,4 +39,5 @@ export declare function readRgbColor(lower: string, start: number): ColorMatch |
  * @returns The six lowercase hex digits, or `null` when it is not a colour.
  */
 export declare function normalizeColor(value: string): string | null;
+export {};
 //# sourceMappingURL=colors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../src/tokens/core/colors.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAmB5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAqC5E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3D"}
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../src/tokens/core/colors.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,qDAAqD;AACrD,UAAU,UAAU;IAClB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAmB5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAqC5E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3D"}

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

@@ -0,0 +1,62 @@
+/**
+ * The pieces of CSS the token checker reads beyond a colour: a declaration of
+ * one of the site's own palette properties, the token a `var()` reads, and
+ * whether the fallback written after it is that token's value.
+ */
+import type { FamilyToken } from './familyTokens.ts';
+/**
+ * A declaration of one of the palette properties a site renders through
+ * `<SiteTheme siteId>`. Reading one — `var(--brand)` — has no colon after the
+ * name, so it is never returned.
+ * @param lower - The text being scanned, already lowercased.
+ * @param start - The index of the first dash.
+ * @returns The property and the index just past its name, or `null`.
+ */
+export declare function readBrandDeclaration(lower: string, start: number): {
+    name: string;
+    end: number;
+} | null;
+/**
+ * The family token a `var()` reads, when it reads one.
+ * @param lower - The text being scanned, already lowercased.
+ * @param start - The index just past the `var(`.
+ * @returns The token, or `null` for any other property.
+ */
+export declare function readVarToken(lower: string, start: number): FamilyToken | null;
+/** A parenthesis the scanner has opened and not yet closed. */
+export interface OpenParen {
+    /** Whether it opens a `var(`. */
+    isVar: boolean;
+    /** The family token the `var(` reads, or `null`. */
+    token: FamilyToken | null;
+    /** Where the fallback starts, just past the first comma, or -1. */
+    fallbackStart: number;
+    /** The line the first comma is on. */
+    fallbackLine: number;
+    /** The index the line of the first comma starts at. */
+    fallbackLineStart: number;
+}
+/** A fallback that is not its token's value, and where it is written. */
+export interface DriftedFallback {
+    /** Which line its first character is on, counting from 1. */
+    line: number;
+    /** Which column, counting from 1. */
+    column: number;
+    /** The fallback as written, without its surrounding spaces. */
+    text: string;
+    /** The value the token holds, and what to write instead. */
+    hint: string;
+    /** The fallback as a colour, or `null` when it is not one. */
+    color: string | null;
+}
+/**
+ * The fallback of a family token that is not that token's value, reported at
+ * its first character.
+ * @param text - The file, as written.
+ * @param open - The `var(` being closed.
+ * @param end - The index of its closing parenthesis.
+ * @returns Where the fallback is and what it should be, or `null` when it is
+ * the token's value or there is none.
+ */
+export declare function driftedFallback(text: string, open: OpenParen, end: number): DriftedFallback | null;
+//# sourceMappingURL=cssReading.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cssReading.d.ts","sourceRoot":"","sources":["../../../src/tokens/core/cssReading.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAYtC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAO7E;AAED,+DAA+D;AAC/D,MAAM,WAAW,SAAS;IACxB,iCAAiC;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,oDAAoD;IACpD,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,GACV,eAAe,GAAG,IAAI,CAuBxB"}