ddd-ts-kit 0.0.0-stage → 0.1.0

package/dist/check/comments/is-directive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-directive.d.ts","sourceRoot":"","sources":["../../../src/check/comments/is-directive.ts"],"names":[],"mappings":"AAGA,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD"}

package/dist/check/comments/is-directive.js

@@ -0,0 +1,6 @@
+const DIRECTIVE = /^(?:\/?ddd-ts-kit[-:]|eslint-|@ts-|prettier-|biome-|istanbul |c8 |v8 |#region|#endregion|@vitest-|@jest-|\/ <reference)/;
+/** Comments that are instructions to a tool, not prose: never judged as code or noise. */
+export function isDirective(text) {
+    return DIRECTIVE.test(text);
+}
+//# sourceMappingURL=is-directive.js.map

package/dist/check/comments/is-directive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-directive.js","sourceRoot":"","sources":["../../../src/check/comments/is-directive.ts"],"names":[],"mappings":"AAAA,MAAM,SAAS,GACb,yHAAyH,CAAC;AAE5H,0FAA0F;AAC1F,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/check/comments/looks-like-code.d.ts

@@ -0,0 +1,2 @@
+export declare function looksLikeCode(text: string): boolean;
+//# sourceMappingURL=looks-like-code.d.ts.map

package/dist/check/comments/looks-like-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"looks-like-code.d.ts","sourceRoot":"","sources":["../../../src/check/comments/looks-like-code.ts"],"names":[],"mappings":"AAwBA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAiBnD"}

package/dist/check/comments/looks-like-code.js

@@ -0,0 +1,42 @@
+import { isDirective } from './is-directive.js';
+const CODE_SHAPES = [
+    /;\s*$/,
+    /^[)}\]]+[;,]?$/,
+    /[^\s]\s*\{$/,
+    /^(?:const|let|var)\s+[\w${[][^=]*=/,
+    /^import\s.*\bfrom\s+['"]/,
+    /^import\s+['"]/,
+    /^export\s+(?:const|let|function|class|default|type|interface|\{|\*)/,
+    /^return\s+[^.]*[;)\]}]$/,
+    /^(?:if|for|while|switch)\s*\(.*\)\s*\{?$/,
+    /^(?:else|try|finally)\s*\{$/,
+    /^await\s+[\w$.]+\(/,
+    /^[\w$.]+\s*(?:=|\+=|-=)\s*[^=].*[;)\]}'"\w]$/,
+    /=>\s*[{(]/,
+    /\([^)]*\)\s*=>/,
+    /^[\w$.#]+\([^)]*\)[;,]?$/,
+    /^(?:public|private|protected|static|readonly|async)\s+[\w$#]+\s*[(:=]/,
+];
+/** Prose sometimes ends like code; these openings are never statements. */
+const PROSE = /^(?:TODO|FIXME|NOTE|See |see |e\.g\.|i\.e\.|https?:)/;
+export function looksLikeCode(text) {
+    // Code quoted in backticks inside a sentence is documentation, not a leftover.
+    const trimmed = text.replace(/`[^`]*`/g, '').trim();
+    if (PROSE.test(trimmed) || isDirective(trimmed)) {
+        return false;
+    }
+    if (trimmed.length < 3) {
+        return /^[)}\]]+;?$/.test(trimmed);
+    }
+    if (readsAsProse(trimmed)) {
+        return false;
+    }
+    return CODE_SHAPES.some((shape) => shape.test(trimmed));
+}
+/** A sentence is mostly plain words; a statement is mostly identifiers glued to punctuation. */
+function readsAsProse(text) {
+    const tokens = text.split(/\s+/);
+    const words = tokens.filter((token) => /^[A-Za-z'`-]+[,.:;!?]?$/.test(token));
+    return tokens.length >= 5 && words.length / tokens.length >= 0.8;
+}
+//# sourceMappingURL=looks-like-code.js.map

package/dist/check/comments/looks-like-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"looks-like-code.js","sourceRoot":"","sources":["../../../src/check/comments/looks-like-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,WAAW,GAAsB;IACrC,OAAO;IACP,gBAAgB;IAChB,aAAa;IACb,oCAAoC;IACpC,0BAA0B;IAC1B,gBAAgB;IAChB,qEAAqE;IACrE,yBAAyB;IACzB,0CAA0C;IAC1C,6BAA6B;IAC7B,oBAAoB;IACpB,8CAA8C;IAC9C,WAAW;IACX,gBAAgB;IAChB,0BAA0B;IAC1B,uEAAuE;CACxE,CAAC;AAEF,2EAA2E;AAC3E,MAAM,KAAK,GAAG,sDAAsD,CAAC;AAErE,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,+EAA+E;IAC/E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAEpD,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,gGAAgG;AAChG,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAE9E,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC;AACnE,CAAC"}

package/dist/check/comments/restates-name.d.ts

@@ -0,0 +1,3 @@
+/** True when the description says nothing the name does not already say. */
+export declare function restatesName(description: string, name: string): boolean;
+//# sourceMappingURL=restates-name.d.ts.map

package/dist/check/comments/restates-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restates-name.d.ts","sourceRoot":"","sources":["../../../src/check/comments/restates-name.ts"],"names":[],"mappings":"AAuCA,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAevE"}

package/dist/check/comments/restates-name.js

@@ -0,0 +1,49 @@
+import { splitWords } from '../../naming/index.js';
+import { sameWord } from '../language/same-word.js';
+/** Words that add nothing to the name they sit next to. */
+const FILLER = new Set([
+    'the',
+    'a',
+    'an',
+    'of',
+    'this',
+    'that',
+    'for',
+    'to',
+    'is',
+    'it',
+    'its',
+    'new',
+    'given',
+    'current',
+    'class',
+    'function',
+    'method',
+    'property',
+    'field',
+    'constructor',
+    'instance',
+    'object',
+    'value',
+    'get',
+    'set',
+    'return',
+    'create',
+    'represent',
+    'define',
+    'implementation',
+    'interface',
+    'type',
+]);
+/** True when the description says nothing the name does not already say. */
+export function restatesName(description, name) {
+    const said = splitWords(description.replace(/[.`'"]/g, ' '));
+    if (said.length === 0 || said.length > 8) {
+        return false;
+    }
+    const named = splitWords(name);
+    return said.every((word) => FILLER.has(word) ||
+        [...FILLER].some((filler) => sameWord(filler, word)) ||
+        named.some((part) => sameWord(part, word)));
+}
+//# sourceMappingURL=restates-name.js.map

package/dist/check/comments/restates-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restates-name.js","sourceRoot":"","sources":["../../../src/check/comments/restates-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,2DAA2D;AAC3D,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC;IACrB,KAAK;IACL,GAAG;IACH,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,MAAM;IACN,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,KAAK;IACL,OAAO;IACP,SAAS;IACT,OAAO;IACP,UAAU;IACV,QAAQ;IACR,UAAU;IACV,OAAO;IACP,aAAa;IACb,UAAU;IACV,QAAQ;IACR,OAAO;IACP,KAAK;IACL,KAAK;IACL,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,gBAAgB;IAChB,WAAW;IACX,MAAM;CACP,CAAC,CAAC;AAEH,4EAA4E;AAC5E,MAAM,UAAU,YAAY,CAAC,WAAmB,EAAE,IAAY;IAC5D,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IAE7D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAE/B,OAAO,IAAI,CAAC,KAAK,CACf,CAAC,IAAI,EAAE,EAAE,CACP,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QAChB,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAC7C,CAAC;AACJ,CAAC"}

package/dist/check/configuration/config-inspection.d.ts

@@ -0,0 +1,28 @@
+import { type ContextConfig } from '../../config/index.js';
+import type { Project } from '../model/project.js';
+import type { Report } from '../model/report.js';
+import type { Violation } from '../model/violation.js';
+/** What `config/valid` looks at in one project, each finding placed on a line of the config file. */
+export declare class ConfigInspection {
+    private readonly project;
+    private readonly report;
+    constructor(project: Project, report: Report);
+    declaredContext(name: string, context: ContextConfig): Violation[];
+    undeclaredDirectories(): Violation[];
+    ruleSettings(known: readonly string[]): Violation[];
+    guardMode(): Violation[];
+    /** A limit above the ceiling is read as the ceiling: the config says something the checker does not do. */
+    functionLinesLimit(): Violation[];
+    /** A commit limit that is not a positive integer is read as its default: the config says something nothing does. */
+    commitLimits(): Violation[];
+    /** A threshold that is not a percentage is read as the reference: the config says something no run enforces. */
+    coverageThresholds(): Violation[];
+    /** An entry without a file or without a reason allows nothing: it is ignored, and has to be said. */
+    onePerFileAllowances(): Violation[];
+    private classification;
+    private upstream;
+    private presence;
+    /** A violation located on the line of the config file that first quotes `needle`. */
+    private inConfig;
+}
+//# sourceMappingURL=config-inspection.d.ts.map

package/dist/check/configuration/config-inspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-inspection.d.ts","sourceRoot":"","sources":["../../../src/check/configuration/config-inspection.ts"],"names":[],"mappings":"AAAA,OAAO,EAUL,KAAK,aAAa,EAEnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAMvD,qGAAqG;AACrG,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFzB,YACmB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EAC7B;IAEJ,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,SAAS,EAAE,CAMjE;IAED,qBAAqB,IAAI,SAAS,EAAE,CAanC;IAED,YAAY,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAAE,CAoBlD;IAED,SAAS,IAAI,SAAS,EAAE,CAcvB;IAED,2GAA2G;IAC3G,kBAAkB,IAAI,SAAS,EAAE,CAiBhC;IAED,oHAAoH;IACpH,YAAY,IAAI,SAAS,EAAE,CAI1B;IAED,gHAAgH;IAChH,kBAAkB,IAAI,SAAS,EAAE,CAIhC;IAED,qGAAqG;IACrG,oBAAoB,IAAI,SAAS,EAAE,CA4BlC;IAED,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,QAAQ;IAgChB,OAAO,CAAC,QAAQ;IAiBhB,qFAAqF;IACrF,OAAO,CAAC,QAAQ;CAGjB"}

package/dist/check/configuration/config-inspection.js

@@ -0,0 +1,141 @@
+import { CLASSIFICATIONS, commitLimitProblems, coverageProblems, CONFIG_FILE, FUNCTION_LINES_CEILING, GUARD_MODES, isOneOf, RELATIONSHIPS, SEVERITIES, } from '../../config/index.js';
+import { isRecord } from '../support/is-record.js';
+import { lineOf } from '../support/line-of.js';
+import { lineOfSequence } from '../support/line-of-sequence.js';
+import { rawConfig } from './raw-config.js';
+/** What `config/valid` looks at in one project, each finding placed on a line of the config file. */
+export class ConfigInspection {
+    project;
+    report;
+    constructor(project, report) {
+        this.project = project;
+        this.report = report;
+    }
+    declaredContext(name, context) {
+        return [
+            ...this.classification(name, context),
+            ...context.upstreams.flatMap((upstream) => this.upstream(name, upstream)),
+            ...this.presence(name, context),
+        ];
+    }
+    undeclaredDirectories() {
+        const { contextsDir, contexts } = this.project.config;
+        const fix = `Declare it under "contexts" in ${CONFIG_FILE} with its classification and upstreams.`;
+        return this.project.contextsOnDisk
+            .filter((name) => contexts[name] === undefined)
+            .map((name) => this.report({ file: `${contextsDir}/${name}`, line: 1 }, `The directory ${contextsDir}/${name} is not a declared context.`, fix));
+    }
+    ruleSettings(known) {
+        return Object.entries(this.project.config.rules).flatMap(([id, severity]) => {
+            if (!known.includes(id)) {
+                return [
+                    this.inConfig(id, `The rule "${id}" does not exist.`, 'Fix the id; `ddd-ts-kit rules` lists the valid ones.'),
+                ];
+            }
+            if (!isOneOf(SEVERITIES, severity)) {
+                return [
+                    this.inConfig(id, `The rule "${id}" has the severity "${severity}".`, `Use one of: ${SEVERITIES.join(', ')}.`),
+                ];
+            }
+            return [];
+        });
+    }
+    guardMode() {
+        const { guard } = this.project.config;
+        if (isOneOf(GUARD_MODES, guard)) {
+            return [];
+        }
+        return [
+            this.inConfig('guard', `"guard" is "${guard}".`, `Use one of: ${GUARD_MODES.join(', ')} (how the editor hook reacts to a violation: refuse the write, only report it, or stay silent).`),
+        ];
+    }
+    /** A limit above the ceiling is read as the ceiling: the config says something the checker does not do. */
+    functionLinesLimit() {
+        const limits = rawConfig(this.project)['limits'];
+        const written = isRecord(limits) ? limits['maxFunctionLines'] : undefined;
+        if (typeof written !== 'number' || written <= FUNCTION_LINES_CEILING) {
+            return [];
+        }
+        const fix = `Set "limits.maxFunctionLines" to ${FUNCTION_LINES_CEILING} or less: no function is longer than ${FUNCTION_LINES_CEILING} lines, whatever the config says.`;
+        return [
+            this.inConfig('maxFunctionLines', `"limits.maxFunctionLines" is ${written}, above the ceiling of ${FUNCTION_LINES_CEILING}: it is read as ${FUNCTION_LINES_CEILING}.`, fix),
+        ];
+    }
+    /** A commit limit that is not a positive integer is read as its default: the config says something nothing does. */
+    commitLimits() {
+        return commitLimitProblems(rawConfig(this.project)['commit']).map(({ key, message, fix }) => this.inConfig(key, message, fix));
+    }
+    /** A threshold that is not a percentage is read as the reference: the config says something no run enforces. */
+    coverageThresholds() {
+        return coverageProblems(rawConfig(this.project)['coverage']).map(({ where, message, fix }) => this.report({ file: CONFIG_FILE, line: lineOfSequence(this.project.configText, where) }, message, fix));
+    }
+    /** An entry without a file or without a reason allows nothing: it is ignored, and has to be said. */
+    onePerFileAllowances() {
+        const onePerFile = rawConfig(this.project)['onePerFile'];
+        const entries = isRecord(onePerFile) && Array.isArray(onePerFile['allow']) ? onePerFile['allow'] : [];
+        const fix = 'Write each entry as { "file": "<path or glob from the project root>", "reason": "<why these exports are one thing>" }, or remove it.';
+        return entries.flatMap((entry, index) => {
+            const missing = missingOf(entry);
+            if (missing === undefined) {
+                return [];
+            }
+            const line = lineOfSequence(this.project.configText, [
+                '"onePerFile"',
+                '"allow"',
+                ...Array.from({ length: index + 1 }, () => '{'),
+            ]);
+            return [
+                this.report({ file: CONFIG_FILE, line }, `Entry ${index + 1} of "onePerFile.allow" has no ${missing}: it is ignored.`, fix),
+            ];
+        });
+    }
+    classification(name, context) {
+        if (isOneOf(CLASSIFICATIONS, context.classification)) {
+            return [];
+        }
+        return [
+            this.inConfig(name, `The context "${name}" has the classification "${context.classification}".`, `Set contexts.${name}.classification to one of: ${CLASSIFICATIONS.join(', ')}.`),
+        ];
+    }
+    upstream(name, upstream) {
+        const violations = [];
+        if (upstream.context === name) {
+            violations.push(this.inConfig(name, `The context "${name}" lists itself as an upstream.`, 'Remove the entry: a context does not depend on itself.'));
+        }
+        else if (this.project.config.contexts[upstream.context] === undefined) {
+            const create = `\`ddd-ts-kit generate context ${upstream.context} --classification <core|supporting|generic>\``;
+            violations.push(this.inConfig(upstream.context, `The context "${name}" declares the unknown upstream "${upstream.context}".`, `Fix the name, or create the context with ${create}.`));
+        }
+        if (!isOneOf(RELATIONSHIPS, upstream.relationship)) {
+            const message = `The relationship "${upstream.relationship}" between "${name}" and "${upstream.context}" is unknown.`;
+            violations.push(this.inConfig(upstream.relationship, message, `Use one of: ${RELATIONSHIPS.join(', ')}.`));
+        }
+        return violations;
+    }
+    presence(name, context) {
+        if (this.project.contextsOnDisk.includes(name)) {
+            return [];
+        }
+        const { contextsDir } = this.project.config;
+        const create = `\`ddd-ts-kit generate context ${name} --classification ${context.classification || 'core'}\``;
+        return [
+            this.inConfig(name, `The context "${name}" is declared but ${contextsDir}/${name} does not exist.`, `Create it with ${create}, or remove it from the config.`),
+        ];
+    }
+    /** A violation located on the line of the config file that first quotes `needle`. */
+    inConfig(needle, message, fix) {
+        return this.report({ file: CONFIG_FILE, line: lineOf(this.project.configText, `"${needle}"`) }, message, fix);
+    }
+}
+function missingOf(entry) {
+    const record = isRecord(entry) ? entry : {};
+    const has = (key) => {
+        const value = record[key];
+        return typeof value === 'string' && value.trim() !== '';
+    };
+    if (!has('file')) {
+        return has('reason') ? 'file' : 'file and no reason';
+    }
+    return has('reason') ? undefined : 'reason';
+}
+//# sourceMappingURL=config-inspection.js.map

package/dist/check/configuration/config-inspection.js.map

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

package/dist/check/configuration/raw-config.d.ts

@@ -0,0 +1,4 @@
+import type { Project } from '../model/project.js';
+/** The config as it is written, before parsing clamps a limit or drops an entry: what `config/valid` has to see. */
+export declare function rawConfig(project: Project): Record<string, unknown>;
+//# sourceMappingURL=raw-config.d.ts.map

package/dist/check/configuration/raw-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-config.d.ts","sourceRoot":"","sources":["../../../src/check/configuration/raw-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,oHAAoH;AACpH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQnE"}

package/dist/check/configuration/raw-config.js

@@ -0,0 +1,12 @@
+import { isRecord } from '../support/is-record.js';
+/** The config as it is written, before parsing clamps a limit or drops an entry: what `config/valid` has to see. */
+export function rawConfig(project) {
+    try {
+        const parsed = JSON.parse(project.configText);
+        return isRecord(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=raw-config.js.map

package/dist/check/configuration/raw-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-config.js","sourceRoot":"","sources":["../../../src/check/configuration/raw-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGnD,oHAAoH;AACpH,MAAM,UAAU,SAAS,CAAC,OAAgB;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAEvD,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/check/coverage/ignore-hints.d.ts

@@ -0,0 +1,6 @@
+import type { DecisionRecords } from '../governance/decision-records.js';
+import type { Finding } from '../model/finding.js';
+import type { SourceFile } from '../model/source-file.js';
+/** The ignore hints of a production source that no decision record covers: each one lowers what the threshold measures. */
+export declare function ignoreHints(file: SourceFile, records: DecisionRecords): Finding[];
+//# sourceMappingURL=ignore-hints.d.ts.map

package/dist/check/coverage/ignore-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-hints.d.ts","sourceRoot":"","sources":["../../../src/check/coverage/ignore-hints.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAK1D,2HAA2H;AAC3H,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,EAAE,CAoBjF"}

package/dist/check/coverage/ignore-hints.js

@@ -0,0 +1,30 @@
+import { commentLines } from '../comments/comment-lines.js';
+import { ADR_DIRECTORY } from '../governance/adr-directory.js';
+import { referencedRecord } from '../governance/referenced-record.js';
+/** A comment that tells the coverage provider to leave code out of the measure: `v8 ignore next`, `istanbul ignore if`, `c8 ignore start`. */
+const HINT = /\b((?:v8|c8|istanbul)\s+ignore\b(?:\s+(?:next|start|stop|if|else|file))?)/;
+/** The ignore hints of a production source that no decision record covers: each one lowers what the threshold measures. */
+export function ignoreHints(file, records) {
+    if (file.isTest) {
+        return [];
+    }
+    return commentLines(file).flatMap((comment) => {
+        const hint = comment.sample ? undefined : HINT.exec(comment.text)?.[1];
+        if (hint === undefined || isRecorded(comment.text, records)) {
+            return [];
+        }
+        return [
+            {
+                line: comment.line,
+                message: `The comment "${hint}" hides code from the coverage measure and points to no decision record.`,
+                fix: `Remove the comment and test the code, or delete the code if nothing can reach it; if the exclusion is deliberate, write ${ADR_DIRECTORY}/NNNN-<slug>.md (what is left out, why no test can reach it, condition for removing it) and end the comment with \`-- ADR-NNNN: <reason>\`.`,
+            },
+        ];
+    });
+}
+function isRecorded(text, records) {
+    const reason = text.split('--').slice(1).join('--');
+    const number = referencedRecord(reason);
+    return number !== undefined && records.has(number);
+}
+//# sourceMappingURL=ignore-hints.js.map

package/dist/check/coverage/ignore-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-hints.js","sourceRoot":"","sources":["../../../src/check/coverage/ignore-hints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAItE,8IAA8I;AAC9I,MAAM,IAAI,GAAG,2EAA2E,CAAC;AAEzF,2HAA2H;AAC3H,MAAM,UAAU,WAAW,CAAC,IAAgB,EAAE,OAAwB;IACpE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAEvE,IAAI,IAAI,KAAK,SAAS,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;YAC5D,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO;YACL;gBACE,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO,EAAE,gBAAgB,IAAI,0EAA0E;gBACvG,GAAG,EAAE,2HAA2H,aAAa,6IAA6I;aAC3R;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,OAAwB;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAExC,OAAO,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACrD,CAAC"}

package/dist/check/coverage/runner-settings.d.ts

@@ -0,0 +1,8 @@
+import type { Finding } from '../model/finding.js';
+import type { Project } from '../model/project.js';
+export interface RunnerFinding extends Finding {
+    readonly file: string;
+}
+/** What the test runner configs at the root of a project say about coverage that the config file does not govern. */
+export declare function runnerSettings(project: Project): RunnerFinding[];
+//# sourceMappingURL=runner-settings.d.ts.map

package/dist/check/coverage/runner-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-settings.d.ts","sourceRoot":"","sources":["../../../src/check/coverage/runner-settings.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AA8BnD,MAAM,WAAW,aAAc,SAAQ,OAAO;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,qHAAqH;AACrH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,EAAE,CAehE"}

package/dist/check/coverage/runner-settings.js

@@ -0,0 +1,85 @@
+import fs from 'node:fs';
+import { CONFIG_FILE } from '../../config/index.js';
+import { readProjectFile } from '../alias/read-project-file.js';
+import { scan } from '../scan/scan.js';
+import { matchingBracket } from '../text/matching-bracket.js';
+/** The config of the unit and integration specs: the one a coverage run reads. */
+const MAIN_CONFIG = /^(vitest|jest)\.config\.[cm]?[jt]s$/;
+const ANY_CONFIG = /^(vitest|jest)(?:\.[\w-]+)*\.(?:config|workspace)\.[cm]?[jt]s$/;
+const READER = { vitest: 'governedCoverage', jest: 'governedJestCoverage' };
+const SPREAD = {
+    vitest: '`...governedCoverage(mode)` into `test.coverage`',
+    jest: '`...governedJestCoverage()` into the config',
+};
+/** What a hand-written setting does to the measure, by the key that writes it. */
+const BY_HAND = {
+    vitest: {
+        include: 'replaces the measured layers',
+        exclude: 'hides files from the measure',
+        thresholds: 'replaces the governed thresholds',
+        ignoreClassMethods: 'hides methods from the measure',
+    },
+    jest: {
+        collectCoverageFrom: 'replaces the measured layers',
+        coveragePathIgnorePatterns: 'hides files from the measure',
+        coverageThreshold: 'replaces the governed thresholds',
+    },
+};
+/** What the test runner configs at the root of a project say about coverage that the config file does not govern. */
+export function runnerSettings(project) {
+    return rootFiles(project.root).flatMap((file) => {
+        const runner = ANY_CONFIG.exec(file)?.[1];
+        const text = runner === undefined ? undefined : readProjectFile(project, file);
+        if (runner === undefined || text === undefined) {
+            return [];
+        }
+        const scanned = scan(text);
+        const lineAt = (offset) => scanned.lineAt(offset);
+        const findings = [...notGoverned(file, runner, scanned.code), ...byHand(runner, scanned.code, lineAt)];
+        return findings.map((finding) => ({ file, ...finding }));
+    });
+}
+function notGoverned(file, runner, code) {
+    const reader = READER[runner] ?? '';
+    if (!MAIN_CONFIG.test(file) || new RegExp(String.raw `\b${reader}\s*\(`).test(code)) {
+        return [];
+    }
+    return [
+        {
+            line: 1,
+            message: `${file} does not read its coverage thresholds from ${CONFIG_FILE}.`,
+            fix: `Import \`${reader}\` from '@ddd-ts-kit/testing/coverage' and spread ${SPREAD[runner] ?? ''}: the four layers of every context are then measured against the "coverage" thresholds of ${CONFIG_FILE}, written once.`,
+        },
+    ];
+}
+function byHand(runner, code, lineAt) {
+    const settings = BY_HAND[runner] ?? {};
+    const scope = runner === 'vitest' ? coverageBlocks(code) : [{ start: 0, end: code.length }];
+    return scope.flatMap(({ start, end }) => Object.entries(settings).flatMap(([key, effect]) => {
+        const found = new RegExp(String.raw `(?<![\w.$])${key}\s*:`).exec(code.slice(start, end));
+        return found === null ? [] : [handWritten(key, effect, lineAt(start + found.index))];
+    }));
+}
+function handWritten(key, effect, line) {
+    return {
+        line,
+        message: `The coverage setting "${key}" is written by hand: it ${effect}.`,
+        fix: `Remove "${key}": what is measured and the floor of each layer come from the "coverage" key of ${CONFIG_FILE} alone. To lower a threshold, change it there and record the deviation ("what": "coverage.<layer>.<rate>") with its decision record.`,
+    };
+}
+/** The object literals written after a `coverage:` key. */
+function coverageBlocks(code) {
+    return [...code.matchAll(/(?<![\w.$])coverage\s*:\s*\{/g)].map((match) => {
+        const open = match.index + match[0].length - 1;
+        return { start: open, end: matchingBracket(code, open) };
+    });
+}
+function rootFiles(root) {
+    try {
+        return fs.readdirSync(root).sort();
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=runner-settings.js.map

package/dist/check/coverage/runner-settings.js.map

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

package/dist/check/coverage/script-flags.d.ts

@@ -0,0 +1,8 @@
+import type { Finding } from '../model/finding.js';
+import type { Project } from '../model/project.js';
+export interface ScriptFinding extends Finding {
+    readonly file: string;
+}
+/** The scripts of the manifest that set by a flag what the config file governs. */
+export declare function scriptFlags(project: Project): ScriptFinding[];
+//# sourceMappingURL=script-flags.d.ts.map

package/dist/check/coverage/script-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-flags.d.ts","sourceRoot":"","sources":["../../../src/check/coverage/script-flags.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAUnD,MAAM,WAAW,aAAc,SAAQ,OAAO;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,EAAE,CAqB7D"}

package/dist/check/coverage/script-flags.js

@@ -0,0 +1,29 @@
+import { CONFIG_FILE } from '../../config/index.js';
+import { parseJsonc } from '../alias/parse-jsonc.js';
+import { readProjectFile } from '../alias/read-project-file.js';
+import { isRecord } from '../support/is-record.js';
+import { lineOf } from '../support/line-of.js';
+const MANIFEST = 'package.json';
+/** A flag of the test runner that changes what a coverage run measures or the floor it is held to. */
+const FLAG = /--(coverage\.(?:include|exclude|thresholds|ignoreClassMethods)|collectCoverageFrom|coveragePathIgnorePatterns|coverageThreshold)\b/;
+/** The scripts of the manifest that set by a flag what the config file governs. */
+export function scriptFlags(project) {
+    const text = readProjectFile(project, MANIFEST);
+    const manifest = text === undefined ? undefined : parseJsonc(text);
+    const scripts = manifest !== undefined && isRecord(manifest['scripts']) ? manifest['scripts'] : {};
+    return Object.entries(scripts).flatMap(([name, command]) => {
+        const flag = typeof command === 'string' ? FLAG.exec(command)?.[1] : undefined;
+        if (flag === undefined) {
+            return [];
+        }
+        return [
+            {
+                file: MANIFEST,
+                line: lineOf(text ?? '', `"${name}"`),
+                message: `The script "${name}" sets "--${flag}" by hand: it changes what the coverage run measures or the floor it is held to.`,
+                fix: `Remove the flag: what is measured and the floor of each layer come from the "coverage" key of ${CONFIG_FILE} alone.`,
+            },
+        ];
+    });
+}
+//# sourceMappingURL=script-flags.js.map

package/dist/check/coverage/script-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-flags.js","sourceRoot":"","sources":["../../../src/check/coverage/script-flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,MAAM,QAAQ,GAAG,cAAc,CAAC;AAEhC,sGAAsG;AACtG,MAAM,IAAI,GACR,oIAAoI,CAAC;AAMvI,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEnG,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE;QACzD,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE/E,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO;YACL;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,IAAI,IAAI,GAAG,CAAC;gBACrC,OAAO,EAAE,eAAe,IAAI,aAAa,IAAI,kFAAkF;gBAC/H,GAAG,EAAE,iGAAiG,WAAW,SAAS;aAC3H;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/check/declarations/arguments-of.d.ts

@@ -0,0 +1,6 @@
+import type { Scan } from '../scan/scan.js';
+import type { ListPart } from '../text/list-part.js';
+import type { Decoration } from './decoration.js';
+/** The blanked code of each argument of a decorator, trimmed, with the offset it starts at. */
+export declare function argumentsOf(scan: Scan, { open, close }: Decoration): ListPart[];
+//# sourceMappingURL=arguments-of.d.ts.map

package/dist/check/declarations/arguments-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arguments-of.d.ts","sourceRoot":"","sources":["../../../src/check/declarations/arguments-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,UAAU,GAAG,QAAQ,EAAE,CAK/E"}

package/dist/check/declarations/arguments-of.js

@@ -0,0 +1,9 @@
+import { splitTopLevel } from '../text/split-top-level.js';
+/** The blanked code of each argument of a decorator, trimmed, with the offset it starts at. */
+export function argumentsOf(scan, { open, close }) {
+    return splitTopLevel(scan.code.slice(open + 1, close)).map((part) => ({
+        code: part.code,
+        start: open + 1 + part.start,
+    }));
+}
+//# sourceMappingURL=arguments-of.js.map

package/dist/check/declarations/arguments-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arguments-of.js","sourceRoot":"","sources":["../../../src/check/declarations/arguments-of.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,+FAA+F;AAC/F,MAAM,UAAU,WAAW,CAAC,IAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAc;IACjE,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpE,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK;KAC7B,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/check/declarations/binding-call.d.ts

@@ -0,0 +1,12 @@
+import type { ListPart } from '../text/list-part.js';
+/** A call that names an injection token: `bind(X)`, `rebind(X)`, `resolve(X)`, `fake(X, ..)` or `override(X, ..)`. */
+export interface BindingCall {
+    readonly method: string;
+    readonly line: number;
+    /** Offsets of the parentheses around the arguments. */
+    readonly open: number;
+    readonly close: number;
+    /** The first argument, when the call has one. */
+    readonly token: ListPart | undefined;
+}
+//# sourceMappingURL=binding-call.d.ts.map

package/dist/check/declarations/binding-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-call.d.ts","sourceRoot":"","sources":["../../../src/check/declarations/binding-call.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,sHAAsH;AACtH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;CACtC"}

package/dist/check/declarations/binding-call.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=binding-call.js.map

package/dist/check/declarations/binding-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-call.js","sourceRoot":"","sources":["../../../src/check/declarations/binding-call.ts"],"names":[],"mappings":""}