dowel-ui 0.13.0 → 0.14.1

package/README.md

@@ -155,6 +155,32 @@ against a baseline, and a check that it carries no word of its own to translate
 
 Full vocabulary, shown rather than tabulated: **[colours](https://lacodda.github.io/dowel/reference/tokens/)** in both themes, **[the scales](https://lacodda.github.io/dowel/reference/scales/)** - radius, type, motion, elevation and stacking order - and **[the accents](https://lacodda.github.io/dowel/reference/accents/)**, where the same screen is drawn in every colour of the line.
 
+## Moving an existing project over
+
+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`) where dowel names them by what they are
+on a screen. The package ships the tools for that crossing:
+
+```console
+$ npx dowel check              # what is not on the dowel vocabulary yet
+$ npx dowel codemod --write    # rewrite the names that can be rewritten
+$ npx dowel doctor             # whether the installation itself is wired right
+$ npx dowel diff dialog        # what you changed since you copied it in
+```
+
+`check`, `doctor` and `diff` only read; `codemod` writes, and only when asked
+twice. Everything reads the catalogue inside the installed package, so none of
+it needs the network.
+
+Two things are deliberately never rewritten, and the tools say so rather than
+guessing: a colour, because which token it was reaching for is a decision; and
+`--accent`, because it is the one name both vocabularies use for opposite
+things - stock's hover fill and dowel's product hue. The first run of `check`
+against dowel's own stand reported twenty-four violations that were all correct
+code, which is exactly how that rule was learned - see
+[the migration guide](https://lacodda.github.io/dowel/guides/migration/).
+
 ## Roadmap
 
 Development goes in versions; each one is a single coherent theme, and ends in a release.
@@ -173,6 +199,7 @@ Development goes in versions; each one is a single coherent theme, and ends in a
 
 - [The stand](https://lacodda.github.io/dowel/stand/) - every component, live
 - [Getting started](https://lacodda.github.io/dowel/getting-started/), [the lint rules](https://lacodda.github.io/dowel/guides/linting/) and [what a component has to pass](https://lacodda.github.io/dowel/guides/gates/)
+- [Moving from stock shadcn](https://lacodda.github.io/dowel/guides/migration/) - the four commands and what they refuse to do
 - [Components](https://lacodda.github.io/dowel/components/button/)
 - [Tokens](https://lacodda.github.io/dowel/reference/tokens/), [scales](https://lacodda.github.io/dowel/reference/scales/) and [accents](https://lacodda.github.io/dowel/reference/accents/)
 - [The vocabulary](https://lacodda.github.io/dowel/concepts/vocabulary/) this system uses for its own parts, and [the mistakes](https://lacodda.github.io/dowel/concepts/anti-patterns/) that actually get made against it

package/dist/cli/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":""}

package/dist/cli/bin.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { run } from './index.js';
+/*
+ * The executable. Deliberately three lines: everything worth testing lives in
+ * `index.ts` and returns an exit code instead of calling `process.exit`, so a
+ * test can run a whole command without the runner exiting underneath it.
+ */
+process.exitCode = run(process.argv.slice(2));
+//# sourceMappingURL=bin.js.map

package/dist/cli/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAEhC;;;;GAIG;AAEH,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/dist/cli/codemod.d.ts

@@ -0,0 +1,22 @@
+/** One substitution made in one place. */
+export interface Change {
+    readonly line: number;
+    readonly from: string;
+    readonly to: string;
+}
+/** What the codemod did to one file, and what it declined to do. */
+export interface Rewrite {
+    readonly source: string;
+    readonly changes: Change[];
+    /** Stock names left alone because the table has no equivalent. These are
+     * the reason a run can be "successful" and still not finished. */
+    readonly skipped: {
+        readonly line: number;
+        readonly name: string;
+        readonly note: string;
+    }[];
+}
+/** Rewrite one file's text. Returns the new source and an account of what
+ * happened - the caller decides whether to write it. */
+export declare function rewriteSource(source: string): Rewrite;
+//# sourceMappingURL=codemod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codemod.d.ts","sourceRoot":"","sources":["../../src/cli/codemod.ts"],"names":[],"mappings":"AAsBA,0CAA0C;AAC1C,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB;AAED,oEAAoE;AACpE,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAA;IAC1B;sEACkE;IAClE,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC5F;AAwCD;wDACwD;AACxD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAmCrD"}

package/dist/cli/codemod.js

@@ -0,0 +1,69 @@
+import { stockNames, stockTokens } from './stock.js';
+/** The 1-based line an offset falls on. */
+function lineAt(source, index) {
+    let line = 1;
+    for (let i = 0; i < index; i += 1) {
+        if (source.charCodeAt(i) === 10 /* \n */)
+            line += 1;
+    }
+    return line;
+}
+/*
+ * The two shapes a stock name takes, as one pass.
+ *
+ * They are matched together rather than in two passes for a reason that cost
+ * an hour elsewhere in this repository: a second pass reads the output of the
+ * first, so a rename whose result contains another stock name gets renamed
+ * twice. `--accent` is exactly that case - stock `--accent` becomes `--soft`,
+ * and dowel's own `--accent` is a name the table also knows. One pass over the
+ * original text cannot double-apply.
+ *
+ * Alternation order is `stockNames`, which is longest-first, so `--sidebar-border`
+ * is matched whole rather than as `--sidebar` with a tail left behind.
+ */
+const UTILITY_PREFIXES = 'bg|text|border|fill|stroke|ring|outline|divide|shadow|from|via|to|accent|caret|decoration';
+function pattern() {
+    const names = stockNames.join('|');
+    return new RegExp(
+    // A custom property: `--muted-foreground`, in a stylesheet or in `var()`.
+    `--(?<property>${names})\\b` +
+        '|' +
+        // A utility: `bg-muted`, `hover:text-muted-foreground`. The opener is
+        // consumed so that `custom-bg-muted` does not match, and put back.
+        `(?<opener>^|[\\s"'\`:\\[({])(?<prefix>${UTILITY_PREFIXES})-(?<utility>${names})\\b`, 'gm');
+}
+/** Rewrite one file's text. Returns the new source and an account of what
+ * happened - the caller decides whether to write it. */
+export function rewriteSource(source) {
+    const changes = [];
+    const skipped = [];
+    const next = source.replace(pattern(), (match, ...args) => {
+        // The named groups arrive last; the offset is two from the end, before the
+        // whole string and the groups object.
+        const groups = args[args.length - 1];
+        const offset = args[args.length - 3];
+        const line = lineAt(source, offset);
+        const property = groups.property;
+        if (property) {
+            const replacement = stockTokens[property];
+            if (replacement.kind !== 'token') {
+                skipped.push({ line, name: `--${property}`, note: replacement.note });
+                return match;
+            }
+            changes.push({ line, from: `--${property}`, to: `--${replacement.token}` });
+            return `--${replacement.token}`;
+        }
+        const utility = groups.utility;
+        const prefix = groups.prefix;
+        const opener = groups.opener ?? '';
+        const replacement = stockTokens[utility];
+        if (replacement.kind !== 'token') {
+            skipped.push({ line, name: `${prefix}-${utility}`, note: replacement.note });
+            return match;
+        }
+        changes.push({ line, from: `${prefix}-${utility}`, to: `${prefix}-${replacement.token}` });
+        return `${opener}${prefix}-${replacement.token}`;
+    });
+    return { source: next, changes, skipped };
+}
+//# sourceMappingURL=codemod.js.map

package/dist/cli/codemod.js.map

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

package/dist/cli/diff.d.ts

@@ -0,0 +1,23 @@
+/** One line of a diff. */
+export interface DiffLine {
+    readonly kind: 'same' | 'added' | 'removed';
+    readonly text: string;
+}
+/** A run of changed lines with a little context, as a diff is normally read. */
+export interface Hunk {
+    /** 1-based line number in the registry's copy where this hunk starts. */
+    readonly fromLine: number;
+    /** 1-based line number in the project's copy where this hunk starts. */
+    readonly toLine: number;
+    readonly lines: readonly DiffLine[];
+}
+/** Every line of both files, marked. */
+export declare function diffLines(from: string, to: string): DiffLine[];
+/** Group the marked lines into hunks with `context` unchanged lines around
+ * each run of changes. A component that differs in two places should print two
+ * short passages, not four hundred lines with a mark in the margin. */
+export declare function hunks(marked: readonly DiffLine[], context?: number): Hunk[];
+/** Whether two files differ at all, ignoring line endings. Cheaper than
+ * diffing, and it is the question asked first. */
+export declare function differs(from: string, to: string): boolean;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/cli/diff.ts"],"names":[],"mappings":"AAoBA,0BAA0B;AAC1B,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,gFAAgF;AAChF,MAAM,WAAW,IAAI;IACnB,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;CACpC;AAwBD,wCAAwC;AACxC,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,EAAE,CA8B9D;AAED;;uEAEuE;AACvE,wBAAgB,KAAK,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,EAAE,OAAO,SAAI,GAAG,IAAI,EAAE,CAwCtE;AAED;kDACkD;AAClD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/dist/cli/diff.js

@@ -0,0 +1,122 @@
+/*
+ * What has this project done to a component since it was copied in?
+ *
+ * The registry's whole promise is that a component becomes your file. That is
+ * a real freedom and it has a real cost: nothing upstream reaches back in, and
+ * nothing tells you what you changed. A year later, a component is different
+ * from the one that shipped and there is no record of whether that is your
+ * deliberate edit or a fix you never received.
+ *
+ * `diff` answers exactly that, from the catalogue inside the installed
+ * package: here is the file the registry serves, here is yours, here is where
+ * they part. It does not merge, and it will not offer to - the copy is the
+ * consumer's, and a tool that silently reconciled it would be taking back the
+ * thing the registry gave.
+ *
+ * The algorithm is a plain longest-common-subsequence over lines. A component
+ * is a few hundred lines; the quadratic cost is invisible, and the output is
+ * the one every reader already knows how to read.
+ */
+/** Line endings are normalised before comparing.
+ *
+ * A checkout on Windows hands back CRLF for a file the registry serves with
+ * LF, and without this every single line of every component would differ - a
+ * report that is technically true and completely useless. The registry builder
+ * normalises for the same reason at the other end. */
+function lines(text) {
+    return text.replace(/\r\n/g, '\n').split('\n');
+}
+/** The classic table. `common[i][j]` is the length of the longest common
+ * subsequence of the first `i` lines of `a` and the first `j` of `b`. */
+function commonTable(a, b) {
+    const table = Array.from({ length: a.length + 1 }, () => new Array(b.length + 1).fill(0));
+    for (let i = a.length - 1; i >= 0; i -= 1) {
+        for (let j = b.length - 1; j >= 0; j -= 1) {
+            table[i][j] = a[i] === b[j] ? table[i + 1][j + 1] + 1 : Math.max(table[i + 1][j], table[i][j + 1]);
+        }
+    }
+    return table;
+}
+/** Every line of both files, marked. */
+export function diffLines(from, to) {
+    const a = lines(from);
+    const b = lines(to);
+    const table = commonTable(a, b);
+    const out = [];
+    let i = 0;
+    let j = 0;
+    while (i < a.length && j < b.length) {
+        if (a[i] === b[j]) {
+            out.push({ kind: 'same', text: a[i] });
+            i += 1;
+            j += 1;
+        }
+        else if (table[i + 1][j] >= table[i][j + 1]) {
+            out.push({ kind: 'removed', text: a[i] });
+            i += 1;
+        }
+        else {
+            out.push({ kind: 'added', text: b[j] });
+            j += 1;
+        }
+    }
+    while (i < a.length) {
+        out.push({ kind: 'removed', text: a[i] });
+        i += 1;
+    }
+    while (j < b.length) {
+        out.push({ kind: 'added', text: b[j] });
+        j += 1;
+    }
+    return out;
+}
+/** Group the marked lines into hunks with `context` unchanged lines around
+ * each run of changes. A component that differs in two places should print two
+ * short passages, not four hundred lines with a mark in the margin. */
+export function hunks(marked, context = 3) {
+    const changed = marked
+        .map((line, index) => (line.kind === 'same' ? -1 : index))
+        .filter((index) => index >= 0);
+    if (changed.length === 0)
+        return [];
+    /* Runs of change, merged when they are close enough that the context
+     * between them would overlap - otherwise the same lines print twice. */
+    const ranges = [];
+    for (const index of changed) {
+        const last = ranges[ranges.length - 1];
+        if (last && index - last.end <= context * 2) {
+            last.end = index;
+            continue;
+        }
+        ranges.push({ start: index, end: index });
+    }
+    /* Line numbers are counted by walking the marked list: a removed line
+     * advances only the "from" side, an added line only the "to" side. */
+    const fromNumbers = [];
+    const toNumbers = [];
+    let fromLine = 1;
+    let toLine = 1;
+    for (const line of marked) {
+        fromNumbers.push(fromLine);
+        toNumbers.push(toLine);
+        if (line.kind !== 'added')
+            fromLine += 1;
+        if (line.kind !== 'removed')
+            toLine += 1;
+    }
+    return ranges.map((range) => {
+        const start = Math.max(0, range.start - context);
+        const end = Math.min(marked.length - 1, range.end + context);
+        return {
+            fromLine: fromNumbers[start],
+            toLine: toNumbers[start],
+            lines: marked.slice(start, end + 1),
+        };
+    });
+}
+/** Whether two files differ at all, ignoring line endings. Cheaper than
+ * diffing, and it is the question asked first. */
+export function differs(from, to) {
+    return from.replace(/\r\n/g, '\n') !== to.replace(/\r\n/g, '\n');
+}
+//# sourceMappingURL=diff.js.map

package/dist/cli/diff.js.map

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

package/dist/cli/doctor.d.ts

@@ -0,0 +1,81 @@
+/** How serious a finding is.
+ *
+ * `problem` is something that is wrong now; `note` is something worth knowing
+ * that may be deliberate. The split matters because the exit code follows it -
+ * a tool that fails a build over a preference gets removed from the build. */
+export type Severity = 'problem' | 'note';
+export interface Diagnosis {
+    readonly severity: Severity;
+    /** What was checked, as a short label the reader can scan a column of. */
+    readonly check: string;
+    /** What was found. */
+    readonly message: string;
+    /** What to do about it, when there is a single obvious thing. */
+    readonly fix?: string;
+}
+/** The bits of a registry catalogue this reads. Deliberately a narrow shape:
+ * the catalogue is a published contract with a schema of its own, and copying
+ * that schema in here as types would be a second place for it to drift. */
+export interface Catalogue {
+    readonly items: readonly {
+        readonly name: string;
+        readonly type: string;
+        readonly dependencies?: readonly string[];
+        readonly files?: readonly {
+            readonly path: string;
+            readonly target?: string;
+        }[];
+    }[];
+}
+/** What the project looks like from the outside. Passed in rather than read
+ * here, so the checks below are pure and can be tested without a directory
+ * tree on disk for every case. */
+export interface ProjectFacts {
+    /** Absolute path to the project root, for messages. */
+    readonly root: string;
+    /** The project's `package.json`, if it has one. */
+    readonly manifest?: {
+        readonly dependencies?: Record<string, string>;
+        readonly devDependencies?: Record<string, string>;
+    };
+    /** The version of `dowel-ui` actually installed, from its own manifest in
+     * `node_modules` - which is the only honest answer. A range in the project
+     * manifest says what was asked for, not what resolved. */
+    readonly installedVersion?: string;
+    /** Every stylesheet in the project, by path, with its text. */
+    readonly stylesheets: readonly {
+        readonly path: string;
+        readonly source: string;
+    }[];
+    /** The project's `components.json`, if shadcn has been configured. */
+    readonly componentsConfig?: {
+        readonly aliases?: Record<string, string>;
+        readonly tailwind?: {
+            readonly css?: string;
+        };
+    };
+    /** The catalogue shipped by the installed package, if it is there. */
+    readonly catalogue?: Catalogue;
+    /** Files that look like copied registry components, by the registry path
+     * they correspond to. */
+    readonly installedComponents: readonly {
+        readonly name: string;
+        readonly source: string;
+    }[];
+}
+/**
+ * Examine a project and say what is wrong with its installation.
+ *
+ * The order is the order a reader can act in: whether the package is there at
+ * all, then whether the theme is reaching the screen, then the accent, then
+ * what has been copied in and whether it still matches.
+ */
+export declare function diagnose(facts: ProjectFacts): Diagnosis[];
+/** Read the catalogue out of the installed package.
+ *
+ * This is what makes the tools work offline: the registry a consumer needs to
+ * reason about is the one they installed from, and it travelled with the
+ * package. Returns undefined rather than throwing - a missing catalogue is one
+ * of the things being diagnosed. */
+export declare function readCatalogue(root: string): Catalogue | undefined;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAqBA;;;;8EAI8E;AAC9E,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;AAEzC,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,sBAAsB;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,iEAAiE;IACjE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;2EAE2E;AAC3E,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS;QACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;QACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAChF,EAAE,CAAA;CACJ;AAED;;kCAEkC;AAClC,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC9C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAClD,CAAA;IACD;;8DAE0D;IAC1D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACnF,sEAAsE;IACtE,QAAQ,CAAC,gBAAgB,CAAC,EAAE;QAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE;YAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAC9C,CAAA;IACD,sEAAsE;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;IAC9B;6BACyB;IACzB,QAAQ,CAAC,mBAAmB,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC5F;AA6BD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,EAAE,CAyIzD;AAED;;;;;oCAKoC;AACpC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAQjE"}

package/dist/cli/doctor.js

@@ -0,0 +1,185 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+/** Every accent file the line publishes is named for its product; a project
+ * importing two has two accents, and the later import wins silently. */
+const ACCENT_IMPORT = /@import\s+['"](?:dowel-ui\/accents\/([a-z-]+)\.css|[^'"]*accents\/([a-z-]+)\.css)['"]/g;
+/** The theme, however it is reached: from the package, or copied in by the
+ * registry and imported from wherever the project put it. */
+const THEME_IMPORT = /@import\s+['"](?:dowel-ui\/theme\.css|[^'"]*dowel\/theme\.css)['"]/;
+/** The one declaration a product outside the line makes for itself. */
+const ACCENT_BASE = /--accent-base\s*:/;
+/** Which version of the package a copied component was built against, from the
+ * dependency the registry records: `dowel-ui@^0.13.0`. */
+function requiredVersion(dependencies) {
+    const entry = dependencies?.find((name) => name.startsWith('dowel-ui@'));
+    return entry?.slice('dowel-ui@'.length);
+}
+/** The major and minor of a version, as numbers. Returns undefined for
+ * anything that is not a plain semver - a git URL, a workspace protocol - so
+ * a caller can decline to reason about it rather than guess. */
+function parseVersion(version) {
+    const match = /^\D*(\d+)\.(\d+)\./.exec(version);
+    if (!match)
+        return undefined;
+    return { major: Number(match[1]), minor: Number(match[2]) };
+}
+/**
+ * Examine a project and say what is wrong with its installation.
+ *
+ * The order is the order a reader can act in: whether the package is there at
+ * all, then whether the theme is reaching the screen, then the accent, then
+ * what has been copied in and whether it still matches.
+ */
+export function diagnose(facts) {
+    const found = [];
+    const declared = facts.manifest?.dependencies?.['dowel-ui'] ?? facts.manifest?.devDependencies?.['dowel-ui'];
+    /* The package itself. A project can use the registry without it - the
+     * components import `cn` from it, so in practice it cannot, but the check
+     * says so rather than assuming. */
+    if (!declared && !facts.installedVersion) {
+        found.push({
+            severity: 'problem',
+            check: 'package',
+            message: 'dowel-ui is not a dependency of this project.',
+            fix: 'pnpm add dowel-ui',
+        });
+    }
+    else if (declared && !facts.installedVersion) {
+        found.push({
+            severity: 'problem',
+            check: 'package',
+            message: `dowel-ui is declared as ${declared} but is not installed.`,
+            fix: 'Install dependencies.',
+        });
+    }
+    /* The theme. Without it every token is undefined, which in CSS is not an
+     * error - the property is simply dropped, and the screen renders in the
+     * browser's defaults with the layout intact. That is the single most
+     * confusing state this system has, and it looks like "the components are
+     * broken". */
+    const themeImports = facts.stylesheets.filter((sheet) => THEME_IMPORT.test(sheet.source));
+    if (themeImports.length === 0) {
+        found.push({
+            severity: 'problem',
+            check: 'theme',
+            message: 'No stylesheet imports the dowel theme, so every token is undefined.',
+            fix: "Add `@import 'dowel-ui/theme.css';` after `@import 'tailwindcss';`.",
+        });
+    }
+    else if (themeImports.length > 1) {
+        found.push({
+            severity: 'note',
+            check: 'theme',
+            message: `The theme is imported in ${themeImports.length} stylesheets: ${themeImports
+                .map((sheet) => sheet.path)
+                .join(', ')}.`,
+            fix: 'Import it once, in the entry stylesheet.',
+        });
+    }
+    /* The accent. A product of the line imports its file; anything else sets the
+     * one declaration. Neither is a hard error - the theme has a default - but a
+     * product with no accent is a product wearing dowel's own amber, which is
+     * almost never what was intended. */
+    const accents = new Set();
+    for (const sheet of facts.stylesheets) {
+        for (const match of sheet.source.matchAll(ACCENT_IMPORT)) {
+            accents.add(match[1] ?? match[2] ?? '');
+        }
+    }
+    const setsAccentBase = facts.stylesheets.some((sheet) => ACCENT_BASE.test(sheet.source));
+    if (accents.size === 0 && !setsAccentBase) {
+        found.push({
+            severity: 'note',
+            check: 'accent',
+            message: 'No accent is set, so the theme uses its own.',
+            fix: "Import your product's accent, or set `--accent-base` to your colour.",
+        });
+    }
+    else if (accents.size > 1) {
+        found.push({
+            severity: 'problem',
+            check: 'accent',
+            message: `Two accents are imported (${[...accents].sort().join(', ')}); whichever is imported last wins.`,
+            fix: 'Import one.',
+        });
+    }
+    else if (accents.size === 1 && setsAccentBase) {
+        found.push({
+            severity: 'note',
+            check: 'accent',
+            message: `An accent file is imported (${[...accents][0]}) and \`--accent-base\` is also set by hand; one of them is dead.`,
+        });
+    }
+    /* shadcn's own configuration. Without it `shadcn add` has nowhere to put a
+     * file, and the failure it produces talks about aliases rather than about
+     * this. */
+    if (!facts.componentsConfig) {
+        found.push({
+            severity: 'note',
+            check: 'components.json',
+            message: 'No components.json, so `shadcn add` cannot resolve where to write a component.',
+            fix: 'npx shadcn@latest init',
+        });
+    }
+    else if (!facts.componentsConfig.aliases?.ui) {
+        found.push({
+            severity: 'problem',
+            check: 'components.json',
+            message: 'components.json has no `ui` alias; every dowel component targets it.',
+            fix: 'Add an `aliases.ui` entry pointing at your components directory.',
+        });
+    }
+    /* What has been copied in, against what the catalogue says it needs. A
+     * component copied at 0.9 and left alone imports `cn` from a package that
+     * has moved four minors since; usually fine, occasionally not, and always
+     * worth knowing before debugging something else. */
+    const installed = parseVersion(facts.installedVersion ?? '');
+    if (facts.catalogue && installed) {
+        const behind = [];
+        for (const component of facts.installedComponents) {
+            const item = facts.catalogue.items.find((candidate) => candidate.name === component.name);
+            const required = requiredVersion(item?.dependencies);
+            const wanted = required ? parseVersion(required) : undefined;
+            if (!wanted)
+                continue;
+            if (wanted.major > installed.major || (wanted.major === installed.major && wanted.minor > installed.minor)) {
+                behind.push(`${component.name} (needs dowel-ui ${required})`);
+            }
+        }
+        if (behind.length > 0) {
+            found.push({
+                severity: 'problem',
+                check: 'components',
+                message: `Components copied in expect a newer package than is installed: ${behind.join(', ')}.`,
+                fix: 'Update dowel-ui.',
+            });
+        }
+    }
+    if (facts.catalogue && facts.installedComponents.length === 0) {
+        found.push({
+            severity: 'note',
+            check: 'components',
+            message: 'No dowel components found in this project.',
+            fix: 'npx shadcn@latest add https://lacodda.github.io/dowel/r/app.json',
+        });
+    }
+    return found;
+}
+/** Read the catalogue out of the installed package.
+ *
+ * This is what makes the tools work offline: the registry a consumer needs to
+ * reason about is the one they installed from, and it travelled with the
+ * package. Returns undefined rather than throwing - a missing catalogue is one
+ * of the things being diagnosed. */
+export function readCatalogue(root) {
+    const path = resolve(root, 'node_modules/dowel-ui/dist/registry.json');
+    if (!existsSync(path))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,8 @@
+/** What a command decided. The number is the process exit code, and it is
+ * deliberately narrow: 0 for a clean run, 1 for findings, 2 for being asked to
+ * do something impossible. A build that treats "found things" the same as
+ * "could not run" cannot be trusted either way. */
+type Outcome = 0 | 1 | 2;
+export declare function run(argv: readonly string[]): Outcome;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AA2CA;;;mDAGmD;AACnD,KAAK,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AA6WxB,wBAAgB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAqBpD"}