dowel-ui 0.12.0 → 0.14.0

package/dist/cli/scan.js

@@ -0,0 +1,265 @@
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { relative, resolve, sep } from 'node:path';
+import { findRawColor } from '../eslint/no-raw-color.js';
+import { stockNames, stockTokens } from './stock.js';
+/** Which files are worth reading.
+ *
+ * CSS is here because the stock vocabulary lives in a stylesheet: a project
+ * migrating from shadcn has `--background: 0 0% 100%` in its own theme file,
+ * and that is the first thing to find. */
+const EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.css', '.mdx']);
+/** A test file, where a colour is the subject rather than the styling.
+ *
+ * The linter already exempts these - a test about the accent has to write a
+ * hex down to have something to assert - and this has to exempt exactly the
+ * same files. Sharing `findRawColor` keeps the two agreeing on what a colour
+ * *is*; it cannot make them agree on where one is allowed, and the first live
+ * run of `check` reported six violations in dowel's own stand that the linter
+ * passes. A report stricter than the build it precedes teaches a reader to
+ * ignore it. */
+const TEST_FILE = /\.(?:test|spec)\.[jt]sx?$/;
+/** Directories never worth walking into.
+ *
+ * `node_modules` would otherwise dominate the report with other people's
+ * colours, and a build output would report the same finding a second time from
+ * the compiled copy - which reads as two problems where there is one. */
+const SKIP_DIRECTORIES = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    'out',
+    '.next',
+    '.astro',
+    '.turbo',
+    'coverage',
+    'target',
+]);
+/** Every file under `root` worth scanning, as absolute paths, in a stable
+ * order - a report that reshuffles between runs cannot be diffed. */
+export function collectFiles(root) {
+    const found = [];
+    const walk = (directory) => {
+        let entries;
+        try {
+            entries = readdirSync(directory).sort();
+        }
+        catch {
+            // A directory that cannot be read is not a finding: it is somebody's
+            // permissions, and stopping the whole report over it would be worse
+            // than the gap.
+            return;
+        }
+        for (const entry of entries) {
+            const path = resolve(directory, entry);
+            let isDirectory;
+            try {
+                isDirectory = statSync(path).isDirectory();
+            }
+            catch {
+                continue;
+            }
+            if (isDirectory) {
+                if (SKIP_DIRECTORIES.has(entry) || entry.startsWith('.'))
+                    continue;
+                walk(path);
+                continue;
+            }
+            const dot = entry.lastIndexOf('.');
+            if (dot < 0)
+                continue;
+            if (!EXTENSIONS.has(entry.slice(dot)))
+                continue;
+            found.push(path);
+        }
+    };
+    walk(root);
+    return found;
+}
+/** A stock custom property, as it appears in either half of a project:
+ * `--muted-foreground` in a stylesheet, `var(--muted-foreground)` in a style
+ * object.
+ *
+ * Built from the table rather than written out, so a name added there is found
+ * here without a second edit. */
+const STOCK_PROPERTY = new RegExp(`--(${stockNames.join('|')})\\b`, 'g');
+/** The same names as Tailwind utilities, which is how they reach a component:
+ * `bg-muted`, `text-muted-foreground`, `border-input`, `hover:bg-accent`.
+ *
+ * The prefix list is what Tailwind actually generates from a colour token, and
+ * the opening character class is what keeps `bg-primary` from matching inside
+ * `custom-bg-primary`. */
+const UTILITY_PREFIXES = 'bg|text|border|fill|stroke|ring|outline|divide|shadow|from|via|to|accent|caret|decoration';
+const STOCK_UTILITY = new RegExp(`(?:^|[\\s"'\`:\\[({])((?:${UTILITY_PREFIXES})-(?:${stockNames.join('|')}))\\b`, 'g');
+/** Turn an offset into a 1-based line and column. */
+function locate(source, index) {
+    let line = 1;
+    let lineStart = 0;
+    for (let i = 0; i < index; i += 1) {
+        if (source.charCodeAt(i) === 10 /* \n */) {
+            line += 1;
+            lineStart = i + 1;
+        }
+    }
+    return { line, column: index - lineStart + 1 };
+}
+/** Every string literal in a source file, with where it starts.
+ *
+ * This is the textual stand-in for the rule's `Literal` and `TemplateElement`
+ * visitors, and it exists so that a colour is only reported where a colour
+ * could actually be written - in a string - rather than anywhere the
+ * characters happen to appear. Without it, a comment explaining the rule would
+ * be a finding: it has to write a colour down to say which ones are forbidden.
+ *
+ * It is a small scanner rather than a regular expression because quotes nest:
+ * an apostrophe inside double quotes is one string, not two.
+ */
+export function stringLiterals(source) {
+    const literals = [];
+    let i = 0;
+    while (i < source.length) {
+        const char = source[i];
+        // A line comment: skip to the newline. Nothing in it is a literal, and a
+        // commented-out colour is not a colour on a screen.
+        if (char === '/' && source[i + 1] === '/') {
+            while (i < source.length && source[i] !== '\n')
+                i += 1;
+            continue;
+        }
+        // A block comment. An opener inside a string is handled by the branch
+        // below taking the whole string first.
+        if (char === '/' && source[i + 1] === '*') {
+            const end = source.indexOf('*/', i + 2);
+            i = end < 0 ? source.length : end + 2;
+            continue;
+        }
+        if (char === '"' || char === "'" || char === '`') {
+            const quote = char;
+            const start = i + 1;
+            i = start;
+            while (i < source.length) {
+                if (source[i] === '\\') {
+                    i += 2;
+                    continue;
+                }
+                if (source[i] === quote)
+                    break;
+                i += 1;
+            }
+            literals.push({ text: source.slice(start, i), index: start });
+            i += 1;
+            continue;
+        }
+        i += 1;
+    }
+    return literals;
+}
+/** What to say about one match.
+ *
+ * One builder for both shapes a stock name takes, so that a custom property
+ * and the utility spelling of the same name cannot end up described
+ * differently - which they were, and the ambiguous case was the one that
+ * suffered: both branches said "has no dowel equivalent", and a name that
+ * exists in both vocabularies has the opposite problem.
+ *
+ * `subject` is the text as it was written, `prefix` is what a replacement has
+ * to keep in front of the token (`--`, or `bg-`). */
+function describe(subject, prefix, replacement) {
+    switch (replacement.kind) {
+        case 'token':
+            return `\`${subject}\` is the stock shadcn vocabulary; dowel calls this \`${prefix}${replacement.token}\`.`;
+        case 'unmapped':
+            return `\`${subject}\` is the stock shadcn vocabulary and has no dowel equivalent - ${replacement.note}`;
+        case 'ambiguous':
+            return `\`${subject}\` exists in both vocabularies: ${replacement.note}`;
+    }
+}
+/** Read one file and say what is wrong with it. */
+export function scanSource(source, file) {
+    const findings = [];
+    const isStylesheet = file.endsWith('.css');
+    /* Stock names are still reported in a test - a test on the old vocabulary
+     * has to be migrated with everything else. Only the colour pass is exempt. */
+    const isTest = TEST_FILE.test(file);
+    const add = (kind, index, text, message, replacement) => {
+        const { line, column } = locate(source, index);
+        findings.push({ file, line, column, kind, text, message, replacement });
+    };
+    /* Stock custom properties, anywhere in the file. In a stylesheet that is a
+     * declaration; in a component it is a `var()` call. Both are the same
+     * finding and take the same fix. */
+    for (const match of source.matchAll(STOCK_PROPERTY)) {
+        const name = match[1];
+        const replacement = stockTokens[name];
+        add('stock', match.index, match[0], describe(`--${name}`, '--', replacement), replacement);
+    }
+    /* The same names as utilities. Only in code: a stylesheet writing
+     * `bg-primary` is writing about a class, usually in an `@apply`, and the
+     * custom-property pass above has already spoken about the same file. */
+    if (!isStylesheet) {
+        for (const match of source.matchAll(STOCK_UTILITY)) {
+            const utility = match[1];
+            const name = stockNames.find((candidate) => utility.endsWith(`-${candidate}`));
+            if (!name)
+                continue;
+            const replacement = stockTokens[name];
+            const prefix = utility.slice(0, utility.length - name.length);
+            add('stock', match.index + match[0].indexOf(utility), utility, describe(utility, prefix, replacement), replacement);
+        }
+    }
+    /* Colours written down. In code this reads string literals, exactly like the
+     * rule does; a stylesheet is read whole, because that is where a colour
+     * appears outside any string - and where, in a theme file, it is supposed
+     * to. */
+    if (isTest) {
+        // Nothing: a test writes colours down on purpose, and the linter exempts
+        // the same files.
+    }
+    else if (isStylesheet) {
+        // A stylesheet that defines the dowel tokens is the one place raw colour
+        // belongs. Recognised by what it declares rather than by its name: a
+        // product may call its theme anything.
+        const definesTheme = /--accent-base\s*:/.test(source);
+        if (!definesTheme) {
+            for (const [index, line] of source.split('\n').entries()) {
+                const finding = findRawColor(line);
+                if (finding) {
+                    findings.push({
+                        file,
+                        line: index + 1,
+                        column: 1,
+                        kind: 'color',
+                        text: line.trim(),
+                        message: finding.message,
+                    });
+                }
+            }
+        }
+    }
+    else {
+        for (const literal of stringLiterals(source)) {
+            const finding = findRawColor(literal.text);
+            if (finding)
+                add('color', literal.index, literal.text.trim(), finding.message);
+        }
+    }
+    return findings.sort((a, b) => a.line - b.line || a.column - b.column);
+}
+/** Scan a whole project. Paths in the findings are relative to `root`, with
+ * forward slashes, so a report reads the same on either platform. */
+export function scanProject(root) {
+    const findings = [];
+    for (const file of collectFiles(root)) {
+        let source;
+        try {
+            source = readFileSync(file, 'utf8');
+        }
+        catch {
+            continue;
+        }
+        const name = relative(root, file).split(sep).join('/');
+        findings.push(...scanSource(source, name));
+    }
+    return findings;
+}
+//# sourceMappingURL=scan.js.map

package/dist/cli/scan.js.map

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

package/dist/cli/stock.d.ts

@@ -0,0 +1,29 @@
+/** What to do with a stock name that has been found. */
+export type Replacement = 
+/** A straight rename: this stock name means that dowel token. */
+{
+    readonly kind: 'token';
+    readonly token: string;
+    readonly note?: string;
+}
+/** Stock-only, and dowel has nothing that means it yet. */
+ | {
+    readonly kind: 'unmapped';
+    readonly note: string;
+}
+/** The name exists in both vocabularies. Reported with its ambiguity spelled
+ * out; never rewritten, because the tool cannot tell which one it is
+ * looking at and a wrong guess breaks a correct project. */
+ | {
+    readonly kind: 'ambiguous';
+    readonly stockMeaning: string;
+    readonly note: string;
+};
+export declare const stockTokens: Readonly<Record<string, Replacement>>;
+/** The stock names, longest first.
+ *
+ * Order matters wherever these are matched one after another: `--sidebar` is a
+ * prefix of `--sidebar-border`, and trying the short one first would rewrite
+ * half of the long one and leave `-border` dangling. */
+export declare const stockNames: readonly string[];
+//# sourceMappingURL=stock.d.ts.map

package/dist/cli/stock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stock.d.ts","sourceRoot":"","sources":["../../src/cli/stock.ts"],"names":[],"mappings":"AAoCA,wDAAwD;AACxD,MAAM,MAAM,WAAW;AACrB,iEAAiE;AAC/D;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAC5E,2DAA2D;GACzD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACtD;;4DAE4D;GAC1D;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAYxF,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CA2D7D,CAAA;AAED;;;;wDAIwD;AACxD,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAEvC,CAAA"}

package/dist/cli/stock.js

@@ -0,0 +1,104 @@
+/*
+ * The stock shadcn vocabulary, and what it means here.
+ *
+ * A product arriving at dowel almost never arrives from nothing. It arrives
+ * from stock shadcn/ui, whose theme names colours by their role in a page -
+ * `--background`, `--muted-foreground`, `--card` - and whose components are
+ * written against those names. dowel names them by what they are on a screen
+ * instead: a ground, a raised surface, dimmed ink. The two vocabularies
+ * overlap almost entirely in meaning and not at all in spelling.
+ *
+ * So the first thing a migration needs is this table, and it has to live in
+ * one place: `check` reports what it finds, `codemod` rewrites it, and the two
+ * disagreeing would be worse than either alone - a report that names a
+ * replacement the rewriter does not make.
+ *
+ * The mapping is deliberately incomplete in two directions.
+ *
+ * Every stock name is listed, because the point is to find all of them; but a
+ * few have no honest equivalent and say so, because guessing one would put a
+ * wrong colour on a screen and call the migration done. `--chart-1` is the
+ * clearest case: dowel has no chart palette until the charts version, and
+ * mapping it to the accent would make five series the same colour.
+ *
+ * And two names exist in *both* vocabularies meaning different things, which a
+ * table keyed by name cannot resolve. `--accent` is stock shadcn's hover fill
+ * and it is also dowel's flagship token - the product's own hue. A scanner
+ * reading names alone sees no difference between a project that has not
+ * migrated and one that has, so these are reported for a human to judge and
+ * never rewritten.
+ *
+ * That distinction is not theoretical: the first live run of `check` reported
+ * twenty-four violations in dowel's own stand, every one of them a correct use
+ * of `--accent`, and `codemod --write` would have rewritten them to `--soft`
+ * and broken a project that was already right.
+ */
+/*
+ * The table, in the order the tokens read on a screen: grounds, then surfaces,
+ * then ink, then the accent, then status, then the odd ones out.
+ *
+ * `--foreground` and `--background` are the pair everything else is defined
+ * against in stock shadcn, and they are the pair that most often survives a
+ * half-finished migration: a product swaps its components over and leaves the
+ * page itself on the old names, so the screen has two grounds that agree only
+ * by accident of both being near-black.
+ */
+export const stockTokens = {
+    background: { kind: 'token', token: 'bg' },
+    foreground: { kind: 'token', token: 'text' },
+    card: { kind: 'token', token: 'raise' },
+    'card-foreground': { kind: 'token', token: 'text' },
+    popover: { kind: 'token', token: 'raise' },
+    'popover-foreground': { kind: 'token', token: 'text' },
+    muted: { kind: 'token', token: 'soft' },
+    'muted-foreground': { kind: 'token', token: 'dim' },
+    border: { kind: 'token', token: 'line' },
+    input: { kind: 'token', token: 'line' },
+    ring: {
+        kind: 'token',
+        token: 'accent',
+        note: 'dowel draws focus from the accent; there is no separate ring colour.',
+    },
+    primary: { kind: 'token', token: 'accent' },
+    'primary-foreground': { kind: 'token', token: 'on-accent' },
+    secondary: { kind: 'token', token: 'soft' },
+    'secondary-foreground': { kind: 'token', token: 'text' },
+    /* The collision. Both vocabularies have this name and they mean opposite
+     * things: stock `--accent` is the quiet fill a row takes on hover, dowel's
+     * `--accent` is the product's own colour - the loudest thing on the screen.
+     * Rewriting it blindly turns every accent in a migrated project into a grey,
+     * so it is reported and left alone. */
+    accent: {
+        kind: 'ambiguous',
+        stockMeaning: 'soft',
+        note: "stock `--accent` is a hover fill; dowel's `--accent` is the product's own hue. If this project has not migrated yet, it means `--soft`; if it has, it is already right.",
+    },
+    'accent-foreground': {
+        kind: 'ambiguous',
+        stockMeaning: 'text',
+        note: "stock `--accent-foreground` is ink on a hover fill; dowel has `--on-accent` for ink on the accent itself. Which one this is depends on whether the project has migrated.",
+    },
+    destructive: { kind: 'token', token: 'bad' },
+    'destructive-foreground': { kind: 'token', token: 'on-bad' },
+    radius: { kind: 'token', token: 'radius-md', note: 'the control radius.' },
+    'chart-1': { kind: 'unmapped', note: 'dowel has no chart palette yet; leave it until the charts version.' },
+    'chart-2': { kind: 'unmapped', note: 'dowel has no chart palette yet; leave it until the charts version.' },
+    'chart-3': { kind: 'unmapped', note: 'dowel has no chart palette yet; leave it until the charts version.' },
+    'chart-4': { kind: 'unmapped', note: 'dowel has no chart palette yet; leave it until the charts version.' },
+    'chart-5': { kind: 'unmapped', note: 'dowel has no chart palette yet; leave it until the charts version.' },
+    sidebar: { kind: 'token', token: 'raise' },
+    'sidebar-foreground': { kind: 'token', token: 'text' },
+    'sidebar-primary': { kind: 'token', token: 'accent' },
+    'sidebar-primary-foreground': { kind: 'token', token: 'on-accent' },
+    'sidebar-accent': { kind: 'token', token: 'soft' },
+    'sidebar-accent-foreground': { kind: 'token', token: 'text' },
+    'sidebar-border': { kind: 'token', token: 'line' },
+    'sidebar-ring': { kind: 'token', token: 'accent' },
+};
+/** The stock names, longest first.
+ *
+ * Order matters wherever these are matched one after another: `--sidebar` is a
+ * prefix of `--sidebar-border`, and trying the short one first would rewrite
+ * half of the long one and leave `-border` dangling. */
+export const stockNames = Object.keys(stockTokens).sort((a, b) => b.length - a.length || a.localeCompare(b));
+//# sourceMappingURL=stock.js.map

package/dist/cli/stock.js.map

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