@design.estate/wcctools 6.0.0 → 6.1.0

package/dist_ts/standards/classes.standardtree.js

@@ -0,0 +1,207 @@
+import * as plugins from '../plugins.js';
+import * as ast from './helpers.ast.js';
+import { baseOf, isRepoPath, isTypeScriptSource, resolveSpecifier, specifierFor } from './helpers.paths.js';
+import { SourceEdits } from './classes.sourceedits.js';
+import { StandardProject } from './classes.standardproject.js';
+const ts = plugins.typescript;
+/** The changes one rule run collected. */
+export class FixBatch {
+    edits = new Map();
+    creates = new Map();
+    moves = new Map();
+    redirects = new Map();
+    edit(fileArg, startArg, endArg, textArg) {
+        this.edits.set(fileArg, [...(this.edits.get(fileArg) ?? []), { start: startArg, end: endArg, text: textArg }]);
+    }
+    create(fileArg, textArg) {
+        if (!this.creates.has(fileArg)) {
+            this.creates.set(fileArg, textArg);
+        }
+    }
+    move(fromArg, toArg) {
+        if (!this.moves.has(fromArg)) {
+            this.moves.set(fromArg, toArg);
+        }
+    }
+    redirectBarrelExports(targetArg, barrelTargetArg) {
+        this.redirects.set(targetArg, barrelTargetArg);
+    }
+}
+/**
+ * The fixer's in-memory copy of a repository: the tracked TypeScript sources and the side files the
+ * standard reads, with the moves and edits applied so far. Nothing touches the disk until the
+ * fixer commits the tree. Every path a batch names must be a repository path (see isRepoPath);
+ * a batch with any other path is rejected before it changes the tree.
+ */
+export class StandardTree {
+    files;
+    originalTexts = new Map();
+    /** Current path → original path, for moved files. */
+    originOf = new Map();
+    /** Original paths that were moved away. */
+    vacated = new Set();
+    created = new Set();
+    /** Current path → ids of the rules that changed the file. */
+    changedBy = new Map();
+    parseCache = new Map();
+    /** Every tracked file of the repository, including those the tree holds no text for (`.json`, `.css`, `.d.ts`, …). */
+    trackedFiles;
+    existsOnDisk;
+    constructor(filesArg, trackedFilesArg, existsOnDiskArg) {
+        this.files = new Map(filesArg);
+        for (const [file, text] of filesArg) {
+            this.originalTexts.set(file, text);
+        }
+        this.trackedFiles = new Set(trackedFilesArg);
+        this.existsOnDisk = existsOnDiskArg;
+    }
+    exists(fileArg) {
+        return this.files.has(fileArg) || (!this.vacated.has(fileArg) && this.existsOnDisk(fileArg));
+    }
+    /** The model of the tree's current state. */
+    project() {
+        return new StandardProject(this.files, (fileArg) => this.exists(fileArg), this.parseCache);
+    }
+    markChanged(fileArg, ruleIdArg) {
+        this.changedBy.set(fileArg, new Set([...(this.changedBy.get(fileArg) ?? []), ruleIdArg]));
+    }
+    /**
+     * Applies a batch: edits, then new files, then moves with import rewriting. Returns the number of
+     * applied changes. Throws without changing the tree when the batch names a path that is not a
+     * repository path.
+     */
+    apply(ruleIdArg, batchArg) {
+        const outside = [
+            ...batchArg.edits.keys(),
+            ...batchArg.creates.keys(),
+            ...[...batchArg.moves].flat(),
+            ...[...batchArg.redirects].flat(),
+        ].filter((pathArg) => !isRepoPath(pathArg));
+        if (outside.length > 0) {
+            throw new Error(`The fix of ${ruleIdArg} names paths outside the repository root: ${[...new Set(outside)].join(', ')}`);
+        }
+        let applied = 0;
+        for (const [file, edits] of batchArg.edits) {
+            const text = this.files.get(file);
+            if (text === undefined) {
+                continue;
+            }
+            const sourceEdits = new SourceEdits();
+            edits.forEach((editArg) => sourceEdits.add(editArg));
+            const next = sourceEdits.apply(text);
+            if (next !== text) {
+                this.files.set(file, next);
+                this.markChanged(file, ruleIdArg);
+                applied += sourceEdits.size;
+            }
+        }
+        for (const [file, text] of batchArg.creates) {
+            if (this.exists(file)) {
+                continue;
+            }
+            this.files.set(file, text);
+            this.created.add(file);
+            this.markChanged(file, ruleIdArg);
+            applied++;
+        }
+        const moves = new Map();
+        const targets = new Set();
+        for (const [from, to] of batchArg.moves) {
+            if (from === to || !this.files.has(from) || targets.has(to) || (this.exists(to) && !batchArg.moves.has(to))) {
+                continue;
+            }
+            moves.set(from, to);
+            targets.add(to);
+        }
+        if (moves.size > 0) {
+            this.rewriteSpecifiers(ruleIdArg, moves, batchArg.redirects);
+            const texts = new Map([...moves.keys()].map((fromArg) => [fromArg, this.files.get(fromArg)]));
+            for (const [from, to] of moves) {
+                this.files.delete(from);
+                if (this.created.delete(from)) {
+                    this.created.add(to);
+                }
+                else {
+                    const origin = this.originOf.get(from) ?? from;
+                    this.originOf.delete(from);
+                    if (origin !== to) {
+                        this.originOf.set(to, origin);
+                    }
+                    if (origin === from) {
+                        this.vacated.add(from);
+                    }
+                }
+                const changed = this.changedBy.get(from);
+                this.changedBy.delete(from);
+                if (changed) {
+                    this.changedBy.set(to, changed);
+                }
+            }
+            for (const [from, to] of moves) {
+                this.files.set(to, texts.get(from));
+                this.vacated.delete(to);
+            }
+            applied += moves.size;
+        }
+        return applied;
+    }
+    /**
+     * Rewrites every relative module specifier whose importing file or target moves, keeping its
+     * extension style. A specifier resolves to any tracked file (sources, `.d.ts`, `.json`, `.css`, …),
+     * so a moved file's imports of files that stay keep pointing at them. Barrel re-exports of a
+     * redirected target point at the redirect instead.
+     */
+    rewriteSpecifiers(ruleIdArg, movesArg, redirectsArg) {
+        const known = (fileArg) => this.files.has(fileArg) || (this.trackedFiles.has(fileArg) && !this.vacated.has(fileArg));
+        const project = this.project();
+        for (const [file, text] of [...this.files]) {
+            if (!isTypeScriptSource(file)) {
+                continue;
+            }
+            const newFile = movesArg.get(file) ?? file;
+            const sourceFile = project.sourceFile(file);
+            const edits = new SourceEdits();
+            for (const literal of ast.moduleSpecifierLiterals(sourceFile)) {
+                const resolved = resolveSpecifier(file, literal.text, known);
+                if (!resolved) {
+                    continue;
+                }
+                let target = movesArg.get(resolved.target) ?? resolved.target;
+                let viaFolder = resolved.viaFolder;
+                const redirect = redirectsArg.get(resolved.target);
+                if (redirect && redirect !== newFile && ts.isExportDeclaration(literal.parent) && baseOf(newFile) === 'index.ts') {
+                    target = redirect;
+                    viaFolder = true;
+                }
+                if (newFile === file && target === resolved.target) {
+                    continue;
+                }
+                const specifier = specifierFor(newFile, target, resolved.style, viaFolder);
+                if (specifier !== literal.text) {
+                    edits.add({ start: literal.getStart() + 1, end: literal.end - 1, text: specifier });
+                }
+            }
+            if (edits.size > 0) {
+                this.files.set(file, edits.apply(text));
+                this.markChanged(file, ruleIdArg);
+            }
+        }
+    }
+    /** The tree's changes against the repository it was read from. */
+    plan() {
+        const moves = [...this.originOf].map(([to, from]) => ({ from, to })).sort((a, b) => a.from.localeCompare(b.from));
+        const created = [...this.created].sort();
+        const edited = [];
+        for (const [file, ruleIds] of [...this.changedBy].sort(([a], [b]) => a.localeCompare(b))) {
+            if (this.created.has(file)) {
+                continue;
+            }
+            const origin = this.originOf.get(file) ?? file;
+            if (this.files.get(file) !== this.originalTexts.get(origin)) {
+                edited.push({ file, ruleIds: [...ruleIds].sort() });
+            }
+        }
+        return { moves, created, edited };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5zdGFuZGFyZHRyZWUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9zdGFuZGFyZHMvY2xhc3Nlcy5zdGFuZGFyZHRyZWUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxlQUFlLENBQUM7QUFDekMsT0FBTyxLQUFLLEdBQUcsTUFBTSxrQkFBa0IsQ0FBQztBQUN4QyxPQUFPLEVBQUUsTUFBTSxFQUFFLFVBQVUsRUFBRSxrQkFBa0IsRUFBRSxnQkFBZ0IsRUFBRSxZQUFZLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUM1RyxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDdkQsT0FBTyxFQUFFLGVBQWUsRUFBb0IsTUFBTSw4QkFBOEIsQ0FBQztBQUdqRixNQUFNLEVBQUUsR0FBRyxPQUFPLENBQUMsVUFBVSxDQUFDO0FBRTlCLDBDQUEwQztBQUMxQyxNQUFNLE9BQU8sUUFBUTtJQUNILEtBQUssR0FBRyxJQUFJLEdBQUcsRUFBZ0MsQ0FBQztJQUNoRCxPQUFPLEdBQUcsSUFBSSxHQUFHLEVBQWtCLENBQUM7SUFDcEMsS0FBSyxHQUFHLElBQUksR0FBRyxFQUFrQixDQUFDO0lBQ2xDLFNBQVMsR0FBRyxJQUFJLEdBQUcsRUFBa0IsQ0FBQztJQUUvQyxJQUFJLENBQUMsT0FBZSxFQUFFLFFBQWdCLEVBQUUsTUFBYyxFQUFFLE9BQWU7UUFDNUUsSUFBSSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsT0FBTyxFQUFFLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxJQUFJLEVBQUUsQ0FBQyxFQUFFLEVBQUUsS0FBSyxFQUFFLFFBQVEsRUFBRSxHQUFHLEVBQUUsTUFBTSxFQUFFLElBQUksRUFBRSxPQUFPLEVBQUUsQ0FBQyxDQUFDLENBQUM7SUFDakgsQ0FBQztJQUVNLE1BQU0sQ0FBQyxPQUFlLEVB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

package/dist_ts/standards/cli.d.ts

@@ -0,0 +1,7 @@
+import * as plugins from '../plugins.js';
+/**
+ * Registers `wcctools check` and `wcctools fix`. Both work on the current directory, the
+ * repository root that holds `.smartconfig.json`. Exit codes: 0 ok, 1 failing findings or a
+ * refused baseline update, 2 configuration or usage error (StandardConfigError/StandardUsageError).
+ */
+export declare const registerStandardCommands: (out: plugins.smartconsole.SmartConsole) => void;

package/dist_ts/standards/cli.js

@@ -0,0 +1,89 @@
+import * as plugins from '../plugins.js';
+import { checkStandard } from './checker.js';
+import { loadStandardProject } from './classes.standardproject.js';
+import { StandardFixer } from './classes.standardfixer.js';
+import { openStandardConfig } from './config.js';
+import { StandardUsageError } from './errors.js';
+import { renderFixResult, renderStandardReport } from './output.js';
+import { initBaselines, updateBaselines } from './ratchet.js';
+/**
+ * Registers `wcctools check` and `wcctools fix`. Both work on the current directory, the
+ * repository root that holds `.smartconfig.json`. Exit codes: 0 ok, 1 failing findings or a
+ * refused baseline update, 2 configuration or usage error (StandardConfigError/StandardUsageError).
+ */
+export const registerStandardCommands = (out) => {
+    out.cli.command({
+        name: 'check',
+        description: 'Check the catalog against the wcctools component standard (https://code.foss.global/design.estate/wcctools/src/branch/main/docs/standard.md)',
+        options: {
+            json: { type: 'boolean', description: 'Print the report as one JSON document (IStandardReport) and nothing else' },
+            verbose: { type: 'boolean', description: 'Also list info findings, findings covered by the allowlist or baselines, and baseline slack' },
+            initBaseline: { type: 'boolean', description: 'Record the current error counts as standard.baselines (only while none exist)' },
+            updateBaseline: { type: 'boolean', description: 'Lower standard.baselines to the current counts; refuses to raise any count' },
+        },
+    }, async ({ options }) => {
+        if (options.initBaseline && options.updateBaseline) {
+            throw new StandardUsageError('--init-baseline and --update-baseline exclude each other');
+        }
+        const rootDir = process.cwd();
+        const opened = openStandardConfig(rootDir);
+        const notes = [];
+        let report;
+        let refused = false;
+        if (options.initBaseline || options.updateBaseline) {
+            const result = options.initBaseline ? await initBaselines(rootDir, opened) : await updateBaselines(rootDir, opened);
+            report = result.report;
+            if (result.raised.length > 0) {
+                refused = true;
+                for (const raise of result.raised) {
+                    await out.error(`refusing to raise the ${raise.ruleId} baseline of ${raise.file}: ${raise.baseline} → ${raise.current}`);
+                }
+            }
+            else {
+                notes.push(`standard.baselines written: ${result.writtenFiles} file(s)`);
+            }
+        }
+        else {
+            report = checkStandard(await loadStandardProject(rootDir), opened.loaded);
+        }
+        if (options.json) {
+            await out.log(JSON.stringify(report));
+        }
+        else {
+            for (const line of [...renderStandardReport(report, !!options.verbose), ...notes]) {
+                await out.log(line);
+            }
+        }
+        process.exitCode = report.ok && !refused ? 0 : 1;
+    });
+    out.cli.command({
+        name: 'fix',
+        description: 'Fix findings of the wcctools component standard with span edits and git mv; needs a clean work tree, never commits',
+        options: {
+            rule: { type: 'strings', description: 'Fix only this rule (repeatable); opt-in rules run only when named' },
+            dryRun: { type: 'boolean', description: 'Show the changes without writing anything' },
+            json: { type: 'boolean', description: 'Print the result as one JSON document (IStandardFixResult) and nothing else' },
+            verbose: { type: 'boolean', description: 'Also list info and covered findings of the remaining check' },
+        },
+    }, async ({ options }) => {
+        const rootDir = process.cwd();
+        const opened = openStandardConfig(rootDir);
+        const result = await new StandardFixer({
+            rootDir,
+            loaded: opened.loaded,
+            rules: options.rule,
+            dryRun: !!options.dryRun,
+            configWriter: opened.writer,
+        }).run();
+        if (options.json) {
+            await out.log(JSON.stringify(result));
+        }
+        else {
+            for (const line of renderFixResult(result, !!options.verbose)) {
+                await out.log(line);
+            }
+        }
+        process.exitCode = result.remaining.ok ? 0 : 1;
+    });
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvc3RhbmRhcmRzL2NsaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQUN6QyxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sY0FBYyxDQUFDO0FBQzdDLE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBQ25FLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUMzRCxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDakQsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBQ2pELE9BQU8sRUFBRSxlQUFlLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDcEUsT0FBTyxFQUFFLGFBQWEsRUFBRSxlQUFlLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFFOUQ7Ozs7R0FJRztBQUNILE1BQU0sQ0FBQyxNQUFNLHdCQUF3QixHQUFHLENBQUMsR0FBc0MsRUFBUSxFQUFFO0lBQ3ZGLEdBQUcsQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDO1FBQ2QsSUFBSSxFQUFFLE9BQU87UUFDYixXQUFXLEVBQUUsOElBQThJO1FBQzNKLE9BQU8sRUFBRTtZQUNQLElBQUksRUFBRSxFQUFFLElBQUksRUFBRSxTQUFTLEVBQUUsV0FBVyxFQUFFLDBFQUEwRSxFQUFFO1lBQ2xILE9BQU8sRUFBRSxFQUFFLElBQUksRUFBRSxTQUFTLEVBQUUsV0FBVyxFQUFFLDZGQUE2RixFQUFFO1lBQ3hJLFlBQVksRUFBRSxFQUFFLElBQUksRUFBRSxTQUFTLEVBQUUsV0FBVyxFQUFFLCtFQUErRSxFQUFFO1lBQy9ILGNBQWMsRUFBRSxFQUFFLElBQUksRUFBRSxTQUFTLEVBQUUsV0FBVyxFQUFFLDRFQUE0RSxFQUFFO1NBQy9IO0tBQ0YsRUFBRSxLQUFLLEVB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

package/dist_ts/standards/config.d.ts

@@ -0,0 +1,33 @@
+import * as plugins from '../plugins.js';
+type IStandardConfig = plugins.interfaces.IStandardConfig;
+type TStandardProfile = plugins.interfaces.TStandardProfile;
+/** The key of wcctools' configuration in `.smartconfig.json`. */
+export declare const wcctoolsConfigKey = "@design.estate/wcctools";
+/** Persists the `standard` configuration of the repository it was read from. */
+export interface IStandardConfigWriter {
+    writeStandardConfig(configArg: IStandardConfig): Promise<void>;
+}
+export interface ILoadedStandardConfig {
+    config: IStandardConfig;
+    profile: TStandardProfile;
+}
+/** A validated configuration together with the writer bound to the `.smartconfig.json` it was read from. */
+export interface IOpenedStandardConfig {
+    loaded: ILoadedStandardConfig;
+    writer: IStandardConfigWriter;
+}
+/**
+ * Writes through the Smartconfig instance that read the configuration, so a write is refused
+ * (SmartconfigChangedError) when `.smartconfig.json` changed in between. Other keys of the
+ * `@design.estate/wcctools` block keep their values.
+ */
+export declare class SmartconfigStandardConfigWriter implements IStandardConfigWriter {
+    private readonly smartconfig;
+    constructor(smartconfigArg: plugins.smartconfig.Smartconfig);
+    writeStandardConfig(configArg: IStandardConfig): Promise<void>;
+}
+/** Validates the `standard` object; collects every problem into one StandardConfigError. */
+export declare const validateStandardConfig: (valueArg: unknown) => ILoadedStandardConfig;
+/** Reads and validates `.smartconfig.json` → `@design.estate/wcctools` → `standard` of a repository. */
+export declare const openStandardConfig: (rootDirArg: string) => IOpenedStandardConfig;
+export {};

package/dist_ts/standards/config.js

@@ -0,0 +1,139 @@
+import * as plugins from '../plugins.js';
+import { StandardConfigError } from './errors.js';
+import { severityIn } from './rule.js';
+import { standardRules } from './rules/index.js';
+/** The key of wcctools' configuration in `.smartconfig.json`. */
+export const wcctoolsConfigKey = '@design.estate/wcctools';
+/**
+ * Writes through the Smartconfig instance that read the configuration, so a write is refused
+ * (SmartconfigChangedError) when `.smartconfig.json` changed in between. Other keys of the
+ * `@design.estate/wcctools` block keep their values.
+ */
+export class SmartconfigStandardConfigWriter {
+    smartconfig;
+    constructor(smartconfigArg) {
+        this.smartconfig = smartconfigArg;
+    }
+    async writeStandardConfig(configArg) {
+        const block = this.smartconfig.dataFor(wcctoolsConfigKey, {});
+        await this.smartconfig.writeDataFor(wcctoolsConfigKey, { ...block, standard: configArg });
+    }
+}
+const isPlainObject = (valueArg) => typeof valueArg === 'object' && valueArg !== null && !Array.isArray(valueArg);
+const knownKeys = ['profile', 'tagPrefix', 'groupNames', 'allowlist', 'baselines'];
+/** Validates the `standard` object; collects every problem into one StandardConfigError. */
+export const validateStandardConfig = (valueArg) => {
+    const problems = [];
+    if (valueArg === undefined) {
+        throw new StandardConfigError([`"${wcctoolsConfigKey}".standard is missing`]);
+    }
+    if (!isPlainObject(valueArg)) {
+        throw new StandardConfigError([`"${wcctoolsConfigKey}".standard must be an object`]);
+    }
+    for (const key of Object.keys(valueArg)) {
+        if (!knownKeys.includes(key)) {
+            problems.push(`standard.${key} is not a known key (${knownKeys.join(', ')})`);
+        }
+    }
+    const profile = valueArg.profile ?? 'base';
+    if (profile !== 'base' && profile !== 'dees') {
+        problems.push(`standard.profile must be 'base' or 'dees'`);
+    }
+    if (valueArg.tagPrefix === undefined) {
+        problems.push('standard.tagPrefix is missing');
+    }
+    else if (typeof valueArg.tagPrefix !== 'string' || !/^[a-z][a-z0-9]*(-[a-z0-9]+)*$/.test(valueArg.tagPrefix)) {
+        problems.push('standard.tagPrefix must be a lowercase tag prefix without the trailing hyphen, e.g. "dees"');
+    }
+    if (valueArg.groupNames !== undefined) {
+        if (!isPlainObject(valueArg.groupNames)) {
+            problems.push('standard.groupNames must be an object of area → display name');
+        }
+        else {
+            for (const [area, name] of Object.entries(valueArg.groupNames)) {
+                if (typeof name !== 'string' || name.length === 0) {
+                    problems.push(`standard.groupNames.${area} must be a non-empty string`);
+                }
+            }
+        }
+    }
+    const rulesById = new Map(standardRules.map((ruleArg) => [ruleArg.id, ruleArg]));
+    if (valueArg.allowlist !== undefined) {
+        if (!isPlainObject(valueArg.allowlist)) {
+            problems.push('standard.allowlist must be an object of rule id → entries');
+        }
+        else {
+            for (const [ruleId, entries] of Object.entries(valueArg.allowlist)) {
+                const rule = rulesById.get(ruleId);
+                if (!rule) {
+                    problems.push(`standard.allowlist: unknown rule '${ruleId}'`);
+                    continue;
+                }
+                if (!rule.allowlistCategories) {
+                    problems.push(`standard.allowlist: rule '${ruleId}' takes no allowlist entries`);
+                    continue;
+                }
+                if (!isPlainObject(entries)) {
+                    problems.push(`standard.allowlist['${ruleId}'] must be an object of '<file>#<member>' → '<category>: <reason>'`);
+                    continue;
+                }
+                for (const [key, value] of Object.entries(entries)) {
+                    const match = typeof value === 'string' ? /^([a-z-]+):\s*(\S.*)$/.exec(value) : null;
+                    if (!match) {
+                        problems.push(`standard.allowlist['${ruleId}']['${key}'] must be '<category>: <reason>'`);
+                    }
+                    else if (!rule.allowlistCategories.includes(match[1])) {
+                        problems.push(`standard.allowlist['${ruleId}']['${key}']: unknown category '${match[1]}' (${rule.allowlistCategories.join(', ')})`);
+                    }
+                }
+            }
+        }
+    }
+    if (valueArg.baselines !== undefined) {
+        if (!isPlainObject(valueArg.baselines)) {
+            problems.push('standard.baselines must be an object of rule id → file → count');
+        }
+        else {
+            for (const [ruleId, counts] of Object.entries(valueArg.baselines)) {
+                const rule = rulesById.get(ruleId);
+                if (!rule) {
+                    problems.push(`standard.baselines: unknown rule '${ruleId}'`);
+                    continue;
+                }
+                if ((profile === 'base' || profile === 'dees') && severityIn(rule, profile) !== 'error') {
+                    problems.push(`standard.baselines: '${ruleId}' is not an error rule of the '${profile}' profile; baselines hold error rules only`);
+                    continue;
+                }
+                if (!isPlainObject(counts)) {
+                    problems.push(`standard.baselines['${ruleId}'] must be an object of file → count`);
+                    continue;
+                }
+                for (const [file, count] of Object.entries(counts)) {
+                    if (typeof count !== 'number' || !Number.isInteger(count) || count < 1) {
+                        problems.push(`standard.baselines['${ruleId}']['${file}'] must be an integer of at least 1`);
+                    }
+                }
+            }
+        }
+    }
+    if (problems.length > 0) {
+        throw new StandardConfigError(problems);
+    }
+    return { config: valueArg, profile: profile };
+};
+/** Reads and validates `.smartconfig.json` → `@design.estate/wcctools` → `standard` of a repository. */
+export const openStandardConfig = (rootDirArg) => {
+    let smartconfig;
+    try {
+        smartconfig = new plugins.smartconfig.Smartconfig(rootDirArg);
+    }
+    catch (error) {
+        throw new StandardConfigError([`.smartconfig.json cannot be read: ${error instanceof Error ? error.message : String(error)}`]);
+    }
+    if (!smartconfig.smartconfigJsonExists) {
+        throw new StandardConfigError([`${rootDirArg} has no .smartconfig.json`]);
+    }
+    const wcctoolsConfig = smartconfig.dataFor(wcctoolsConfigKey, {});
+    return { loaded: validateStandardConfig(wcctoolsConfig.standard), writer: new SmartconfigStandardConfigWriter(smartconfig) };
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvc3RhbmRhcmRzL2NvbmZpZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQUN6QyxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDbEQsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUN2QyxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFLakQsaUVBQWlFO0FBQ2pFLE1BQU0sQ0FBQyxNQUFNLGlCQUFpQixHQUFHLHlCQUF5QixDQUFDO0FBa0IzRDs7OztHQUlHO0FBQ0gsTUFBTSxPQUFPLCtCQUErQjtJQUN6QixXQUFXLENBQWtDO0lBRTlELFlBQVksY0FBK0M7UUFDekQsSUFBSSxDQUFDLFdBQVcsR0FBRyxjQUFjLENBQUM7SUFDcEMsQ0FBQztJQUVNLEtBQUssQ0FBQyxtQkFBbUIsQ0FBQyxTQUEwQjtRQUN6RCxNQUFNLEtBQUssR0FBRyxJQUFJLENBQUMsV0FBVyxDQUFDLE9BQU8sQ0FBMEIsaUJBQWlCLEVBQUUsRUFBRSxDQUFDLENBQUM7UUFDdkYsTUFBTSxJQUFJLENBQUMsV0FBVyxDQUFDLFlBQVksQ0FBQyxpQkFBaUIsRUFBRSxFQUFFLEdBQUcsS0FBSyxFQUFFLFFBQVEsRUFBRSxTQUFTLEVBQUUsQ0FBQyxDQUFDO0lBQzVGLENBQUM7Q0FDRjtBQUVELE1BQU0sYUFBYSxHQUFHLENBQUMsUUFBaUIsRUFBdUMsRUFBRSxDQUMvRSxPQUFPLFFBQVEsS0FBSyxRQUFRLElBQUksUUFBUSxLQUFLLElBQUksSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLENBQUM7QUFFaEYsTUFBTSxTQUFTLEdBQUcsQ0FBQyxTQUFTLEVBQUUsV0FBVyxFQUFFLFlBQVksRUFBRSxXQUFXLEVBQUUsV0FBVyxDQUFDLENBQUM7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

package/dist_ts/standards/errors.d.ts

@@ -0,0 +1,9 @@
+/** The `standard` configuration is missing or invalid; the CLI exits with code 2. */
+export declare class StandardConfigError extends Error {
+    readonly problems: string[];
+    constructor(problemsArg: string[]);
+}
+/** A precondition or argument of `check`/`fix` is not met; the CLI exits with code 2. */
+export declare class StandardUsageError extends Error {
+    constructor(messageArg: string);
+}

package/dist_ts/standards/errors.js

@@ -0,0 +1,17 @@
+/** The `standard` configuration is missing or invalid; the CLI exits with code 2. */
+export class StandardConfigError extends Error {
+    problems;
+    constructor(problemsArg) {
+        super(`Invalid wcctools standard configuration in .smartconfig.json:\n${problemsArg.map((problemArg) => `  - ${problemArg}`).join('\n')}`);
+        this.name = 'StandardConfigError';
+        this.problems = problemsArg;
+    }
+}
+/** A precondition or argument of `check`/`fix` is not met; the CLI exits with code 2. */
+export class StandardUsageError extends Error {
+    constructor(messageArg) {
+        super(messageArg);
+        this.name = 'StandardUsageError';
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvc3RhbmRhcmRzL2Vycm9ycy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxxRkFBcUY7QUFDckYsTUFBTSxPQUFPLG1CQUFvQixTQUFRLEtBQUs7SUFDNUIsUUFBUSxDQUFXO0lBRW5DLFlBQVksV0FBcUI7UUFDL0IsS0FBSyxDQUFDLGtFQUFrRSxXQUFXLENBQUMsR0FBRyxDQUFDLENBQUMsVUFBVSxFQUFFLEVBQUUsQ0FBQyxPQUFPLFVBQVUsRUFBRSxDQUFDLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsQ0FBQztRQUMzSSxJQUFJLENBQUMsSUFBSSxHQUFHLHFCQUFxQixDQUFDO1FBQ2xDLElBQUksQ0FBQyxRQUFRLEdBQUcsV0FBVyxDQUFDO0lBQzlCLENBQUM7Q0FDRjtBQUVELHlGQUF5RjtBQUN6RixNQUFNLE9BQU8sa0JBQW1CLFNBQVEsS0FBSztJQUMzQyxZQUFZLFVBQWtCO1FBQzVCLEtBQUssQ0FBQyxVQUFVLENBQUMsQ0FBQztRQUNsQixJQUFJLENBQUMsSUFBSSxHQUFHLG9CQUFvQixDQUFDO0lBQ25DLENBQUM7Q0FDRiJ9

package/dist_ts/standards/helpers.ast.d.ts

@@ -0,0 +1,56 @@
+import * as plugins from '../plugins.js';
+export type TNode = plugins.typescript.Node;
+export type TSourceFile = plugins.typescript.SourceFile;
+export type TClassDeclaration = plugins.typescript.ClassDeclaration;
+export type TClassElement = plugins.typescript.ClassElement;
+export type TPropertyDeclaration = plugins.typescript.PropertyDeclaration;
+export type TObjectLiteralExpression = plugins.typescript.ObjectLiteralExpression;
+export type TCallExpression = plugins.typescript.CallExpression;
+export type TExpression = plugins.typescript.Expression;
+export type TTypeNode = plugins.typescript.TypeNode;
+export type TStringLiteralLike = plugins.typescript.StringLiteralLike;
+export declare const parseSource: (fileArg: string, textArg: string) => TSourceFile;
+/** 1-based line and column of a position. */
+export declare const lineAndColumn: (sourceFileArg: TSourceFile, positionArg: number) => {
+    line: number;
+    column: number;
+};
+/** The called name of `name(...)` or `a.b.name(...)`. */
+export declare const calleeName: (expressionArg: TExpression) => string | null;
+/** The decorator call named `nameArg` on a node, e.g. `@customElement('x')`. */
+export declare const findDecoratorCall: (nodeArg: TNode, namesArg: readonly string[]) => {
+    name: string;
+    call: TCallExpression;
+} | null;
+export declare const hasModifier: (nodeArg: TNode, kindArg: plugins.typescript.SyntaxKind) => boolean;
+/** The text of a member name: identifier, private identifier (with '#'), string or numeric literal. */
+export declare const memberNameText: (memberArg: TClassElement) => string | null;
+export declare const isStatic: (memberArg: TNode) => boolean;
+/** The static property declaration `static <name> = …` of a class. */
+export declare const findStaticProperty: (classArg: TClassDeclaration, nameArg: string) => TPropertyDeclaration | null;
+export declare const isStringLiteralLike: (nodeArg: TNode | undefined) => nodeArg is TStringLiteralLike;
+/** A property assignment `key: value` of an object literal, by key. */
+export declare const objectProperty: (objectArg: TObjectLiteralExpression, keyArg: string) => plugins.typescript.PropertyAssignment | null;
+/** The source text of an object literal property's value, or null. */
+export declare const objectPropertyText: (objectArg: TObjectLiteralExpression, keyArg: string) => string | null;
+/** The indentation (leading whitespace) of the line a position is on. */
+export declare const indentationAt: (textArg: string, positionArg: number) => string;
+export interface ITextEdit {
+    start: number;
+    end: number;
+    text: string;
+}
+/**
+ * The edit that adds `propertyTextArg` (e.g. `reflect: true`) as the last property of an object
+ * literal, following the literal's own layout: inline literals stay on one line, multi-line
+ * literals get a new line with the indentation of their last property.
+ */
+export declare const appendObjectPropertyEdit: (objectArg: TObjectLiteralExpression, propertyTextArg: string) => ITextEdit;
+/** The edit that adds `propertyTextArg` (e.g. `type: String`) as the first property of an object literal. */
+export declare const prependObjectPropertyEdit: (objectArg: TObjectLiteralExpression, propertyTextArg: string) => ITextEdit;
+/** The position after the last import declaration, at the start of the following line; 0 without imports. */
+export declare const afterLastImport: (sourceFileArg: TSourceFile) => number;
+/** The module an identifier is imported from in a file, e.g. `html` → `lit`. */
+export declare const importSourceOf: (sourceFileArg: TSourceFile, identifierArg: string) => string | null;
+/** Every relative-capable module specifier literal of a file: imports, re-exports, dynamic `import()` and `import('…')` types. */
+export declare const moduleSpecifierLiterals: (sourceFileArg: TSourceFile) => TStringLiteralLike[];