react-cheminfo 0.8.0 → 0.9.0

package/lib/slides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slides.js","sourceRoot":"","sources":["../src/slides.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}

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":";AAUA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAOvE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE;IACnC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,mBAAoB,CAAC,CAAC;IAClD,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;AAC1C,CAAC,CAAC,CAAC;AA2DH;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,EACJ,QAAQ,EACR,QAAQ,GAAG,KAAK,EAChB,WAAW,GAAG,QAAQ,EACtB,KAAK,GAAG,EAAE,EACV,QAAQ,GAAG,CAAC,EACZ,QAAQ,GAAG,GAAG,EACd,SAAS,GAAG,GAAG,EACf,IAAI,GAAG,UAAU,EACjB,SAAS,EACT,KAAK,GACN,GAAG,KAAK,CAAC;IAEV,MAAM,YAAY,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEhE,OAAO,CACL,cACE,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,EAAE,GAAG,UAAU,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,YAE7C,KAAC,QAAQ,IAAC,QAAQ,EAAE,cAAK,KAAK,EAAE,aAAa,yCAA2B,YACtE,KAAC,YAAY,IAEX,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,IAAI,IALL,QAAQ,CAMb,GACO,GACP,CACP,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,YAAY,CACnB,QAAiD,EACjD,KAAa,EACb,QAAgB;IAEhB,MAAM,QAAQ,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC9B,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC/B,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,OAAO,WAAW,CAChB,CAAC,MAA6B,EAAE,EAAE;QAChC,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI;YAAE,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC9D,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC5B,OAAO;QACT,CAAC;QACD,QAAQ,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YACjC,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YACxB,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC,EACD,CAAC,KAAK,CAAC,CACR,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,GAAkB;IAChC,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,YAAY;IACvB,MAAM,EAAE,mBAAmB;IAC3B,YAAY,EAAE,CAAC;IACf,UAAU,EAAE,MAAM;CACnB,CAAC;AAEF,kEAAkE;AAClE,MAAM,aAAa,GAAkB;IACnC,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,QAAQ;IACpB,cAAc,EAAE,QAAQ;IACxB,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,EAAE;CACb,CAAC"}
+{"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"}

package/lib/tokens/core/checkTokens.js

@@ -0,0 +1,188 @@
+// tokens-ok: file — the checker names the colours it looks for.
+import { normalizeColor, readHexColor, readRgbColor } from "./colors.js";
+import { BANNED_COLORS } from "./rules.js";
+/**
+ * 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 function findTokenViolations(files, options = {}) {
+    const marker = (options.ignoreMarker ?? DEFAULT_IGNORE_MARKER).toLowerCase();
+    const allowed = new Set();
+    for (const entry of options.allow ?? []) {
+        const color = normalizeColor(entry);
+        if (color !== null)
+            allowed.add(color);
+    }
+    const violations = [];
+    for (const file of files) {
+        // A file whose opening lines carry the marker defines the palette rather
+        // than consuming it — the token block itself, the registry of banned
+        // colours, an image generated outside any page.
+        if (waivesWholeFile(file.text, marker))
+            continue;
+        const scan = scanFile(file.text, marker);
+        for (const candidate of scan.candidates) {
+            if (scan.markedLines.has(candidate.line))
+                continue;
+            if (candidate.color !== null && allowed.has(candidate.color))
+                continue;
+            violations.push({
+                file: file.path,
+                line: candidate.line,
+                column: candidate.column,
+                kind: candidate.kind,
+                text: candidate.text,
+                hint: candidate.hint,
+            });
+        }
+    }
+    return violations;
+}
+const DEFAULT_IGNORE_MARKER = 'tokens-ok';
+// How far into a file the whole-file waiver may sit: a licence header, an
+// import or two, and the comment saying why this file writes colours.
+const WAIVER_LINES = 6;
+function waivesWholeFile(text, marker) {
+    if (marker.length === 0)
+        return false;
+    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) {
+    const lower = text.toLowerCase();
+    const candidates = [];
+    const markedLines = new Set();
+    const rootBlocks = [];
+    // Which parentheses are open, and whether each is a `var(` past its comma —
+    // a colour there is a fallback for the token named beside it.
+    const parens = [];
+    let selectorStart = 0;
+    let line = 1;
+    let lineStart = 0;
+    for (let index = 0; index < lower.length; index++) {
+        const char = lower[index];
+        if (char === '\n') {
+            line++;
+            lineStart = index + 1;
+            continue;
+        }
+        if (marker.length > 0 &&
+            char === marker[0] &&
+            lower.startsWith(marker, index)) {
+            markedLines.add(line);
+            index += marker.length - 1;
+            continue;
+        }
+        if (char === '(') {
+            parens.push({
+                isVar: lower.startsWith('var(', index - 3),
+                sawComma: false,
+            });
+            continue;
+        }
+        if (char === ')') {
+            parens.pop();
+            continue;
+        }
+        if (char === ',') {
+            const open = parens.at(-1);
+            if (open !== undefined)
+                open.sawComma = true;
+            continue;
+        }
+        if (char === '{') {
+            rootBlocks.push(lower.slice(selectorStart, index).includes(':root'));
+            selectorStart = index + 1;
+            continue;
+        }
+        if (char === '}' || char === ';') {
+            if (char === '}')
+                rootBlocks.pop();
+            selectorStart = index + 1;
+            continue;
+        }
+        if (char === '#' || char === 'r') {
+            const match = char === '#' ? readHexColor(lower, index) : readRgbColor(lower, index);
+            if (match === null)
+                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) {
+                candidates.push({
+                    line,
+                    column: index - lineStart + 1,
+                    kind: rule.kind,
+                    text: text.slice(index, match.end),
+                    hint: rule.hint,
+                    color: match.color,
+                });
+            }
+            index = match.end - 1;
+            continue;
+        }
+        if (char === '-') {
+            const property = readBrandDeclaration(lower, index);
+            if (property === null)
+                continue;
+            if (rootBlocks.includes(true)) {
+                candidates.push({
+                    line,
+                    column: index - lineStart + 1,
+                    kind: 'redeclared-brand',
+                    text: property.name,
+                    hint: `render <SiteTheme siteId> instead of declaring ${property.name} in :root.`,
+                    color: null,
+                });
+            }
+            index = property.end - 1;
+        }
+    }
+    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

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

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

@@ -0,0 +1,42 @@
+/**
+ * Reading a colour out of source text, in both spellings the same value is
+ * written in: `#5f6b7c` and `rgb(95 107 124)`. Both come back as the same six
+ * lowercase hex digits, so a table of banned colours holds one entry per
+ * colour rather than one per way of typing it.
+ */
+/** A colour found in the text, and where it ends. */
+export 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. */
+    end: number;
+}
+/**
+ * The colour a hex literal starts at, in `#rgb`, `#rgba`, `#rrggbb` or
+ * `#rrggbbaa` form. The alpha, when there is one, says nothing about the
+ * colour and is dropped.
+ * @param lower - The text being scanned, already lowercased.
+ * @param start - The index of the `#`.
+ * @returns The colour and its end, or `null` when it is not a hex colour.
+ */
+export declare function readHexColor(lower: string, start: number): ColorMatch | null;
+/**
+ * The colour an `rgb()` or `rgba()` call starts at, in either the comma or the
+ * space separated spelling.
+ *
+ * Only a plain byte triple is read: a percentage, a decimal or a variable
+ * inside the call means the value cannot be compared with a hex literal, and
+ * is left alone rather than guessed at.
+ * @param lower - The text being scanned, already lowercased.
+ * @param start - The index of the `r`.
+ * @returns The colour and its end, or `null` when it is not one.
+ */
+export declare function readRgbColor(lower: string, start: number): ColorMatch | null;
+/**
+ * The `rrggbb` form of a colour written by hand — in an allow list, on a
+ * command line — in any of the spellings the scanner itself reads.
+ * @param value - The colour, with or without its `#`.
+ * @returns The six lowercase hex digits, or `null` when it is not a colour.
+ */
+export declare function normalizeColor(value: string): string | null;
+//# sourceMappingURL=colors.d.ts.map

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

@@ -0,0 +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"}

package/lib/tokens/core/colors.js

@@ -0,0 +1,119 @@
+// tokens-ok: file — the colour reader is tested against literals.
+/**
+ * Reading a colour out of source text, in both spellings the same value is
+ * written in: `#5f6b7c` and `rgb(95 107 124)`. Both come back as the same six
+ * lowercase hex digits, so a table of banned colours holds one entry per
+ * colour rather than one per way of typing it.
+ */
+/**
+ * The colour a hex literal starts at, in `#rgb`, `#rgba`, `#rrggbb` or
+ * `#rrggbbaa` form. The alpha, when there is one, says nothing about the
+ * colour and is dropped.
+ * @param lower - The text being scanned, already lowercased.
+ * @param start - The index of the `#`.
+ * @returns The colour and its end, or `null` when it is not a hex colour.
+ */
+export function readHexColor(lower, start) {
+    let end = start + 1;
+    while (isHexDigit(lower[end]))
+        end++;
+    // A run of hex digits running straight into a word is an identifier — a
+    // private field, an anchor — rather than a colour.
+    if (isWordChar(lower[end]))
+        return null;
+    const digits = end - start - 1;
+    if (digits === 3 || digits === 4) {
+        const red = lower[start + 1];
+        const green = lower[start + 2];
+        const blue = lower[start + 3];
+        return { color: `${red}${red}${green}${green}${blue}${blue}`, end };
+    }
+    if (digits === 6 || digits === 8) {
+        return { color: lower.slice(start + 1, start + 7), end };
+    }
+    return null;
+}
+/**
+ * The colour an `rgb()` or `rgba()` call starts at, in either the comma or the
+ * space separated spelling.
+ *
+ * Only a plain byte triple is read: a percentage, a decimal or a variable
+ * inside the call means the value cannot be compared with a hex literal, and
+ * is left alone rather than guessed at.
+ * @param lower - The text being scanned, already lowercased.
+ * @param start - The index of the `r`.
+ * @returns The colour and its end, or `null` when it is not one.
+ */
+export function readRgbColor(lower, start) {
+    let open = -1;
+    if (lower.startsWith('rgb(', start))
+        open = start + 3;
+    else if (lower.startsWith('rgba(', start))
+        open = start + 4;
+    if (open === -1)
+        return null;
+    const close = lower.indexOf(')', open);
+    if (close === -1)
+        return null;
+    const components = [];
+    let value = -1;
+    for (let index = open + 1; index < close; index++) {
+        const char = lower[index];
+        if (char !== undefined && char >= '0' && char <= '9') {
+            value = Math.max(value, 0) * 10 + Number(char);
+            continue;
+        }
+        if (value >= 0) {
+            components.push(value);
+            value = -1;
+        }
+        // The alpha of the modern syntax, which the colour does not depend on.
+        if (char === '/')
+            break;
+        if (char !== ' ' && char !== ',' && char !== '\t' && char !== '\n') {
+            return null;
+        }
+    }
+    if (value >= 0)
+        components.push(value);
+    if (components.length < 3)
+        return null;
+    let color = '';
+    for (let index = 0; index < 3; index++) {
+        const component = components[index];
+        if (component === undefined || component > 255)
+            return null;
+        color += component.toString(16).padStart(2, '0');
+    }
+    return { color, end: close + 1 };
+}
+/**
+ * The `rrggbb` form of a colour written by hand — in an allow list, on a
+ * command line — in any of the spellings the scanner itself reads.
+ * @param value - The colour, with or without its `#`.
+ * @returns The six lowercase hex digits, or `null` when it is not a colour.
+ */
+export function normalizeColor(value) {
+    const text = value.trim().toLowerCase();
+    if (text === '')
+        return null;
+    let match = null;
+    if (text.startsWith('#'))
+        match = readHexColor(text, 0);
+    else if (text.startsWith('rgb'))
+        match = readRgbColor(text, 0);
+    else
+        match = readHexColor(`#${text}`, 0);
+    return match === null ? null : match.color;
+}
+function isHexDigit(char) {
+    if (char === undefined)
+        return false;
+    return (char >= '0' && char <= '9') || (char >= 'a' && char <= 'f');
+}
+function isWordChar(char) {
+    if (char === undefined)
+        return false;
+    return ((char >= '0' && char <= '9') || (char >= 'a' && char <= 'z') || char === '_');
+}
+//# sourceMappingURL=colors.js.map

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

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

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

@@ -0,0 +1,3 @@
+export type { CheckTokensOptions, TokenViolation, TokenViolationKind, } from './checkTokens.ts';
+export { findTokenViolations } from './checkTokens.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tokens/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/tokens/core/index.js

@@ -0,0 +1,2 @@
+export { findTokenViolations } from "./checkTokens.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tokens/core/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,23 @@
+import type { TokenViolationKind } from './checkTokens.ts';
+/** What a colour a site may not write should have been. */
+export interface ColorRule {
+    /** Which kind of violation writing it raises. */
+    kind: TokenViolationKind;
+    /** The token to write instead, in one line. */
+    hint: string;
+}
+/**
+ * The colours a site may not write, keyed by their six lowercase hex digits.
+ *
+ * Two things land here. Blueprint's own neutrals and intent blue, which arrive
+ * by reading a value off a component and pasting it: they are near the
+ * family's greys without being them, which is what makes two of our sites
+ * opened side by side read as two products. And the family's own token values
+ * re-typed as literals, which pins the page to the colour the token held on
+ * the day it was copied — a retune then moves everything except it.
+ *
+ * `#ffffff` is deliberately absent: `--surface` is white, and so are a hundred
+ * legitimate whites in a shadow, a gradient or a `color-mix`.
+ */
+export declare const BANNED_COLORS: ReadonlyMap<string, ColorRule>;
+//# sourceMappingURL=rules.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/tokens/core/rules.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,2DAA2D;AAC3D,MAAM,WAAW,SAAS;IACxB,iDAAiD;IACjD,IAAI,EAAE,kBAAkB,CAAC;IACzB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CA8EvD,CAAC"}

package/lib/tokens/core/rules.js

@@ -0,0 +1,90 @@
+/**
+ * The colours a site may not write, keyed by their six lowercase hex digits.
+ *
+ * Two things land here. Blueprint's own neutrals and intent blue, which arrive
+ * by reading a value off a component and pasting it: they are near the
+ * family's greys without being them, which is what makes two of our sites
+ * opened side by side read as two products. And the family's own token values
+ * re-typed as literals, which pins the page to the colour the token held on
+ * the day it was copied — a retune then moves everything except it.
+ *
+ * `#ffffff` is deliberately absent: `--surface` is white, and so are a hundred
+ * legitimate whites in a shadow, a gradient or a `color-mix`.
+ */
+export const BANNED_COLORS = new Map([
+    [
+        'f6f7f9',
+        {
+            kind: 'blueprint-grey',
+            hint: "Blueprint's page grey — the family's page is var(--surface-sunken).",
+        },
+    ],
+    [
+        'd3d8de',
+        {
+            kind: 'blueprint-grey',
+            hint: "Blueprint's light grey — the family's line is var(--border).",
+        },
+    ],
+    [
+        '5f6b7c',
+        {
+            kind: 'blueprint-grey',
+            hint: "Blueprint's muted text — use var(--text-muted).",
+        },
+    ],
+    [
+        '2d72d2',
+        {
+            kind: 'blueprint-blue',
+            hint: "Blueprint's intent blue — the site's own colour is var(--accent).",
+        },
+    ],
+    [
+        '137cbd',
+        {
+            kind: 'blueprint-blue',
+            hint: "Blueprint's older intent blue — the site's own colour is var(--accent).",
+        },
+    ],
+    [
+        'f5f7fa',
+        {
+            kind: 'retyped-token',
+            hint: 'the value of --surface-sunken — use var(--surface-sunken).',
+        },
+    ],
+    [
+        'dfe3e8',
+        {
+            kind: 'retyped-token',
+            hint: 'the value of --border — use var(--border).',
+        },
+    ],
+    [
+        'c3cad3',
+        {
+            kind: 'retyped-token',
+            hint: 'the value of --border-strong — use var(--border-strong).',
+        },
+    ],
+    [
+        '16202c',
+        { kind: 'retyped-token', hint: 'the value of --text — use var(--text).' },
+    ],
+    [
+        '5b6875',
+        {
+            kind: 'retyped-token',
+            hint: 'the value of --text-muted — use var(--text-muted).',
+        },
+    ],
+    [
+        '8a96a3',
+        {
+            kind: 'retyped-token',
+            hint: 'the value of --text-faint — use var(--text-faint).',
+        },
+    ],
+]);
+//# sourceMappingURL=rules.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../src/tokens/core/rules.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,aAAa,GAAmC,IAAI,GAAG,CAGlE;IACA;QACE,QAAQ;QACR;YACE,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,qEAAqE;SAC5E;KACF;IACD;QACE,QAAQ;QACR;YACE,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,8DAA8D;SACrE;KACF;IACD;QACE,QAAQ;QACR;YACE,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,iDAAiD;SACxD;KACF;IACD;QACE,QAAQ;QACR;YACE,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,mEAAmE;SAC1E;KACF;IACD;QACE,QAAQ;QACR;YACE,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,yEAAyE;SAChF;KACF;IACD;QACE,QAAQ;QACR;YACE,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,4DAA4D;SACnE;KACF;IACD;QACE,QAAQ;QACR;YACE,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,4CAA4C;SACnD;KACF;IACD;QACE,QAAQ;QACR;YACE,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,0DAA0D;SACjE;KACF;IACD;QACE,QAAQ;QACR,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,wCAAwC,EAAE;KAC1E;IACD;QACE,QAAQ;QACR;YACE,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,oDAAoD;SAC3D;KACF;IACD;QACE,QAAQ;QACR;YACE,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,oDAAoD;SAC3D;KACF;CACF,CAAC,CAAC"}

package/lib/ui.d.ts

@@ -1,3 +1,4 @@
+export * from './about/ui/index.ts';
 export * from './capsule/ui/index.ts';
 export * from './chrome/ui/index.ts';
 export * from './citation/ui/index.ts';

package/lib/ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}

package/lib/ui.js

@@ -1,3 +1,4 @@
+export * from "./about/ui/index.js";
 export * from "./capsule/ui/index.js";
 export * from "./chrome/ui/index.js";
 export * from "./citation/ui/index.js";

package/lib/ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}