@ddd-ts-kit/eslint-plugin 0.0.0-stage → 0.1.0

package/dist/rules/scheduling-job-triggers-use-case.js

@@ -0,0 +1,129 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { className } from '../support/classes/class-name.js';
+import { constructorOf } from '../support/classes/constructor-of.js';
+import { exportedClasses } from '../support/classes/exported-classes.js';
+import { isCallable } from '../support/classes/is-callable.js';
+import { memberName } from '../support/classes/member-name.js';
+import { declarationReader } from '../support/declarations/declaration-reader.js';
+import { defineRule } from '../support/rule/define-rule.js';
+import { descendants } from '../support/descendants.js';
+import { propertyName } from '../support/globals/property-name.js';
+import { importListener } from '../support/imports/import-listener.js';
+import { inContext } from '../support/imports/in-context.js';
+import { dependencyListListener } from '../support/ports/dependency-list-listener.js';
+import { importedBindings } from '../support/ports/imported-bindings.js';
+import { isJobFile } from '../support/scheduling/is-job-file.js';
+import { registeredJob } from '../support/scheduling/registered-job.js';
+import { parameterTypeName } from '../support/types/parameter-type-name.js';
+const MODEL_FOLDERS = new Set(['aggregates', 'entities', 'services']);
+const IN_THE_COMMAND = 'A job is a schedule: it sends a command through the `CommandBus` and the work (loading aggregates, deciding, saving) is in the handler of that command, where it is authorized, transactional and tested like any other use case.';
+export const schedulingJobTriggersUseCase = defineRule({
+    id: 'scheduling/job-triggers-use-case',
+    type: 'problem',
+    recommended: 'error',
+    description: 'A job only triggers use cases: it lives in application/scheduling, implements ScheduledJob, sends a command and touches neither a repository nor the model.',
+    messages: {
+        notAJob: 'This job file exports no class implementing `ScheduledJob`. Export one class `<Name>Job implements ScheduledJob` with a `run(execution)` method that sends a command.',
+        noCommand: `{{className}}.run sends no command: nothing in it calls \`.execute(..)\`. ${IN_THE_COMMAND} Write \`await this.commands.execute(new <Command>(systemActor('<context>.<job>'), execution.scheduledAt))\`.`,
+        repository: `{{className}} is given the repository {{name}}. ${IN_THE_COMMAND} Depend on \`CommandBus\` only and move what reads or writes {{name}} to the handler.`,
+        model: `This job imports {{target}}. ${IN_THE_COMMAND} Remove the import and move what needs it to the handler.`,
+        misplaced: '{{className}} is a scheduled job but lives in {{file}}. Move it to application/scheduling/<name>.job.ts of its context: a job is found, read and tested in one place.',
+    },
+    create({ file, sourceCode, report }) {
+        if (inContext(file) === undefined || file.isTest) {
+            return {};
+        }
+        return isJobFile(file.config, file.path) ? jobFile(file, sourceCode, report) : elsewhere(file, sourceCode, report);
+    },
+});
+function jobFile(file, sourceCode, tell) {
+    const imported = importedBindings(file, sourceCode.ast);
+    const isRepository = (name) => name !== undefined && isRepositoryFile(imported.get(name)?.target);
+    const owner = () => exportedClasses(sourceCode.ast)[0]?.id?.name ?? 'The job';
+    const lists = dependencyListListener(sourceCode.ast, (dependency) => {
+        if (isRepository(dependency.name)) {
+            tell({ node: dependency, messageId: 'repository', data: { className: owner(), name: dependency.name } });
+        }
+    });
+    const imports = importListener(file, ({ node, target }) => {
+        if (isModel(target)) {
+            tell({ node, messageId: 'model', data: { target: describeModel(target) } });
+        }
+    });
+    return {
+        ...imports,
+        ...lists,
+        CallExpression(node) {
+            imports.CallExpression?.(node);
+            lists.CallExpression?.(node);
+        },
+        Program: (program) => judgeJobs(program, isRepository, tell),
+    };
+}
+function judgeJobs(program, isRepository, tell) {
+    const jobs = exportedClasses(program).filter((node) => node.implements.some((port) => port.expression.type === AST_NODE_TYPES.Identifier && port.expression.name === 'ScheduledJob'));
+    if (jobs.length === 0) {
+        tell({ loc: { line: 1, column: 0 }, messageId: 'notAJob' });
+    }
+    for (const job of jobs) {
+        judgeJob(job, isRepository, tell);
+    }
+}
+function judgeJob(job, isRepository, tell) {
+    const run = job.body.body.find((member) => isCallable(member) && memberName(member) === 'run');
+    if (run === undefined || !sendsCommand(run)) {
+        tell({ node: run ?? job.id ?? job, messageId: 'noCommand', data: { className: className(job) } });
+    }
+    for (const parameter of constructorOf(job.body)?.value.params ?? []) {
+        const name = parameterTypeName(parameter);
+        if (isRepository(name)) {
+            tell({ node: parameter, messageId: 'repository', data: { className: className(job), name } });
+        }
+    }
+}
+function sendsCommand(run) {
+    return [...descendants(run)].some((node) => node.type === AST_NODE_TYPES.CallExpression &&
+        node.callee.type === AST_NODE_TYPES.MemberExpression &&
+        propertyName(node.callee) === 'execute');
+}
+function isRepositoryFile(target) {
+    return (target?.kind === 'file' &&
+        target.location.area === 'context' &&
+        target.location.layer === 'domain' &&
+        target.location.inside[0] === 'repositories');
+}
+function isModel(target) {
+    if (target.kind !== 'file' || target.location.area !== 'context') {
+        return false;
+    }
+    const { layer, inside } = target.location;
+    return layer === 'infrastructure' || (layer === 'domain' && MODEL_FOLDERS.has(inside[0] ?? ''));
+}
+function describeModel(target) {
+    if (target.kind !== 'file' || target.location.area !== 'context') {
+        return 'the model';
+    }
+    return target.location.layer === 'infrastructure' ? 'infrastructure/' : `domain/${target.location.inside[0] ?? ''}/`;
+}
+/** Outside application/scheduling: no class carries `@Scheduled`, and a module registers only jobs that live there. */
+function elsewhere(file, sourceCode, tell) {
+    const declarationsOf = declarationReader(sourceCode.ast);
+    const imported = importedBindings(file, sourceCode.ast);
+    const judgeClass = (node) => {
+        for (const declaration of declarationsOf(node).filter((candidate) => candidate.name === 'Scheduled')) {
+            tell({ node: declaration.node, messageId: 'misplaced', data: { className: className(node), file: file.path } });
+        }
+    };
+    return {
+        ClassDeclaration: judgeClass,
+        ClassExpression: judgeClass,
+        CallExpression(node) {
+            const handler = registeredJob(node)?.handler;
+            const target = handler === undefined ? undefined : imported.get(handler.name)?.target;
+            if (handler !== undefined && target?.kind === 'file' && !isJobFile(file.config, target.path)) {
+                tell({ node: handler, messageId: 'misplaced', data: { className: handler.name, file: target.path } });
+            }
+        },
+    };
+}
+//# sourceMappingURL=scheduling-job-triggers-use-case.js.map

package/dist/rules/scheduling-job-triggers-use-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling-job-triggers-use-case.js","sourceRoot":"","sources":["../../src/rules/scheduling-job-triggers-use-case.ts"],"names":[],"mappings":"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"}

package/dist/rules/standard-no-parallel-interface.d.ts

@@ -0,0 +1,2 @@
+export declare const standardNoParallelInterface: import("@typescript-eslint/utils/ts-eslint").RuleModule<"parallel", [], import("../index.js").RuleDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+//# sourceMappingURL=standard-no-parallel-interface.d.ts.map

package/dist/rules/standard-no-parallel-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-no-parallel-interface.d.ts","sourceRoot":"","sources":["../../src/rules/standard-no-parallel-interface.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,2BAA2B,oKAmCtC,CAAC"}

package/dist/rules/standard-no-parallel-interface.js

@@ -0,0 +1,57 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { defineRule } from '../support/rule/define-rule.js';
+import { inSourceRoot } from '../support/imports/in-source-root.js';
+import { BOUNDARY_NAMES } from '../support/standard-interfaces/boundary-names.js';
+import { parallelNames } from '../support/standard-interfaces/parallel-names.js';
+import { standardNamesIn } from '../support/standard-interfaces/standard-names-in.js';
+export const standardNoParallelInterface = defineRule({
+    id: 'standard/no-parallel-interface',
+    type: 'suggestion',
+    recommended: 'warn',
+    description: 'No home-made copy of a standard interface of the kernel (ILogger, UserContext, PaginatedResult): use the kernel one and extend it by declaration merging.',
+    messages: {
+        parallel: '{{name}} is a home-made copy of a standard interface: use {{instead}}. Standard interfaces come from @ddd-ts-kit/kernel: import the one named here, and add the fields of the project by declaration merging of the extension interface it leaves open (SessionExtensions, ExecutionContextExtensions, ActorExtensions, LogFields, MetricLabels); an implementation is a class named after its technology (`PinoLogger implements Logger`).',
+    },
+    create({ file, report }) {
+        if (file.isTest || !inSourceRoot(file)) {
+            return {};
+        }
+        const names = parallelNames(file.config.standardInterfaces);
+        const judge = (node) => {
+            const name = node.id?.name ?? '';
+            const instead = names.get(name);
+            if (instead === undefined ||
+                node.id === null ||
+                isAtTheBoundary(file, name) ||
+                isImplementation(node, standardNamesIn(instead))) {
+                return;
+            }
+            report({ node: node.id, messageId: 'parallel', data: { name, instead } });
+        };
+        return { ClassDeclaration: judge, TSInterfaceDeclaration: judge, TSTypeAliasDeclaration: judge };
+    },
+});
+function isAtTheBoundary({ location }, name) {
+    if (!BOUNDARY_NAMES.includes(name)) {
+        return false;
+    }
+    return location.area === 'platform' || (location.area === 'context' && location.layer === 'presentation');
+}
+/** A class that implements or extends the standard interface is an implementation of it, not a second interface. */
+function isImplementation(node, standardNames) {
+    if (node.type !== AST_NODE_TYPES.ClassDeclaration) {
+        return false;
+    }
+    const heritage = [node.superClass, ...node.implements.map((port) => port.expression)];
+    return heritage.some((type) => type !== null && standardNames.includes(lastName(type) ?? ''));
+}
+/** `Logger` for `Logger` and for `kernel.Logger`. */
+function lastName(type) {
+    if (type.type === AST_NODE_TYPES.Identifier) {
+        return type.name;
+    }
+    return type.type === AST_NODE_TYPES.MemberExpression && type.property.type === AST_NODE_TYPES.Identifier
+        ? type.property.name
+        : undefined;
+}
+//# sourceMappingURL=standard-no-parallel-interface.js.map

package/dist/rules/standard-no-parallel-interface.js.map

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

package/dist/rules/test-no-mocks.d.ts

@@ -0,0 +1,2 @@
+export declare const testNoMocks: import("@typescript-eslint/utils/ts-eslint").RuleModule<"library" | "mock", [], import("../index.js").RuleDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+//# sourceMappingURL=test-no-mocks.d.ts.map

package/dist/rules/test-no-mocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-no-mocks.d.ts","sourceRoot":"","sources":["../../src/rules/test-no-mocks.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,WAAW,4KA+BtB,CAAC"}

package/dist/rules/test-no-mocks.js

@@ -0,0 +1,50 @@
+import { defineRule } from '../support/rule/define-rule.js';
+import { ambientName } from '../support/globals/ambient-name.js';
+import { propertyName } from '../support/globals/property-name.js';
+import { importListener } from '../support/imports/import-listener.js';
+const MOCKING_MEMBERS = new Set(['mock', 'doMock', 'unstable_mockModule', 'fn', 'spyOn', 'mocked']);
+const MOCKING_GLOBALS = new Set(['vi', 'jest']);
+const MOCKING_LIBRARIES = new Set([
+    'sinon',
+    'ts-mockito',
+    'jest-mock',
+    'jest-mock-extended',
+    'vitest-mock-extended',
+    'testdouble',
+    'ts-auto-mock',
+    'typemoq',
+    'moq.ts',
+    '@golevelup/ts-jest',
+    '@golevelup/ts-vitest',
+]);
+const INSTEAD = 'Use the fake of the port from test/fakes (a working in-memory implementation) and assert its state, the events on the in-memory bus or the returned value instead of calls.';
+export const testNoMocks = defineRule({
+    id: 'test/no-mocks',
+    type: 'suggestion',
+    recommended: 'warn',
+    description: "No vi.mock, jest.mock, vi.fn, jest.fn, vi.spyOn, jest.spyOn or mocking library in a context's tests: use the fake of the port.",
+    messages: {
+        mock: `The test uses {{what}}. ${INSTEAD}`,
+        library: `The test imports the mocking library "{{name}}". ${INSTEAD}`,
+    },
+    create({ file, sourceCode, report }) {
+        if (file.location.area !== 'context' || !file.isTest) {
+            return {};
+        }
+        return {
+            ...importListener(file, ({ node, target }) => {
+                if (target.kind === 'package' && MOCKING_LIBRARIES.has(target.name)) {
+                    report({ node, messageId: 'library', data: { name: target.name } });
+                }
+            }),
+            MemberExpression(node) {
+                const object = ambientName(sourceCode, node.object) ?? '';
+                const member = propertyName(node) ?? '';
+                if (MOCKING_GLOBALS.has(object) && MOCKING_MEMBERS.has(member)) {
+                    report({ node, messageId: 'mock', data: { what: `${object}.${member}` } });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=test-no-mocks.js.map

package/dist/rules/test-no-mocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-no-mocks.js","sourceRoot":"","sources":["../../src/rules/test-no-mocks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEvE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,qBAAqB,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AACpG,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,OAAO;IACP,YAAY;IACZ,WAAW;IACX,oBAAoB;IACpB,sBAAsB;IACtB,YAAY;IACZ,cAAc;IACd,SAAS;IACT,QAAQ;IACR,oBAAoB;IACpB,sBAAsB;CACvB,CAAC,CAAC;AAEH,MAAM,OAAO,GACX,6KAA6K,CAAC;AAEhL,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAqB;IACxD,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,MAAM;IACnB,WAAW,EACT,gIAAgI;IAClI,QAAQ,EAAE;QACR,IAAI,EAAE,2BAA2B,OAAO,EAAE;QAC1C,OAAO,EAAE,oDAAoD,OAAO,EAAE;KACvE;IACD,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE;QACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACrD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO;YACL,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;gBAC3C,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;oBACpE,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC,CAAC;YACF,gBAAgB,CAAC,IAAI;gBACnB,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC1D,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAExC,IAAI,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC/D,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC7E,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/tracing-platform-only.d.ts

@@ -0,0 +1,2 @@
+export declare const tracingPlatformOnly: import("@typescript-eslint/utils/ts-eslint").RuleModule<"tracing", [], import("../index.js").RuleDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+//# sourceMappingURL=tracing-platform-only.d.ts.map

package/dist/rules/tracing-platform-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-platform-only.d.ts","sourceRoot":"","sources":["../../src/rules/tracing-platform-only.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,mBAAmB,mKAyB9B,CAAC"}

package/dist/rules/tracing-platform-only.js

@@ -0,0 +1,52 @@
+import { importListener } from '../support/imports/import-listener.js';
+import { inSourceRoot } from '../support/imports/in-source-root.js';
+import { defineRule } from '../support/rule/define-rule.js';
+const TRACING_PACKAGE = '@ddd-ts-kit/tracing';
+const OPEN_TELEMETRY_SCOPE = '@opentelemetry/';
+export const tracingPlatformOnly = defineRule({
+    id: 'tracing/platform-only',
+    type: 'problem',
+    recommended: 'error',
+    description: 'Tracing is wired once: `@ddd-ts-kit/tracing` and `@opentelemetry/*` are imported only by the platform directory, `main.ts` and `apps/`.',
+    messages: {
+        tracing: '"{{specifier}}" is imported in {{place}}: tracing is wired once, by the platform. Remove the import: adapters, use cases, events and jobs are observed from outside by `traceApplication()`, given to the kernel module at the composition root; what has to open a span of its own lives in {{platform}}/.',
+    },
+    create({ file, report }) {
+        if (!isJudged(file)) {
+            return {};
+        }
+        return importListener(file, ({ node, specifier, target }) => {
+            if (target.kind === 'package' && isTracing(target.name)) {
+                report({
+                    node,
+                    messageId: 'tracing',
+                    data: { specifier, place: placeOf(file), platform: file.config.platformDir },
+                });
+            }
+        });
+    },
+});
+/** Every source under the source root, tests included, but the platform, `main.ts` and the entry points under `apps/`. */
+function isJudged(file) {
+    const { area } = file.location;
+    return (inSourceRoot(file) &&
+        area !== 'platform' &&
+        area !== 'main' &&
+        !file.path.startsWith(`${file.config.sourceRoot}/apps/`));
+}
+function isTracing(packageName) {
+    return packageName === TRACING_PACKAGE || packageName.startsWith(OPEN_TELEMETRY_SCOPE);
+}
+function placeOf({ location, path }) {
+    if (location.area === 'shared-kernel') {
+        return 'the shared kernel';
+    }
+    if (location.area !== 'context') {
+        return path;
+    }
+    if (location.layer === 'module') {
+        return `the module file of "${location.context}"`;
+    }
+    return location.layer === 'root' ? path : `${location.layer}/`;
+}
+//# sourceMappingURL=tracing-platform-only.js.map

package/dist/rules/tracing-platform-only.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-platform-only.js","sourceRoot":"","sources":["../../src/rules/tracing-platform-only.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAE5D,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAC9C,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAE/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAY;IACvD,EAAE,EAAE,uBAAuB;IAC3B,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,OAAO;IACpB,WAAW,EACT,yIAAyI;IAC3I,QAAQ,EAAE;QACR,OAAO,EACL,6SAA6S;KAChT;IACD,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;QACrB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,cAAc,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE;YAC1D,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxD,MAAM,CAAC;oBACL,IAAI;oBACJ,SAAS,EAAE,SAAS;oBACpB,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;iBAC7E,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAEH,0HAA0H;AAC1H,SAAS,QAAQ,CAAC,IAAgB;IAChC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;IAE/B,OAAO,CACL,YAAY,CAAC,IAAI,CAAC;QAClB,IAAI,KAAK,UAAU;QACnB,IAAI,KAAK,MAAM;QACf,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,QAAQ,CAAC,CACzD,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,WAAmB;IACpC,OAAO,WAAW,KAAK,eAAe,IAAI,WAAW,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAc;IAC7C,IAAI,QAAQ,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QACtC,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,uBAAuB,QAAQ,CAAC,OAAO,GAAG,CAAC;IACpD,CAAC;IAED,OAAO,QAAQ,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,GAAG,CAAC;AACjE,CAAC"}

package/dist/support/ancestors.d.ts

@@ -0,0 +1,4 @@
+import type { TSESTree } from '@typescript-eslint/utils';
+/** From the parent of `node` up to the program, whose own parent is absent. */
+export declare function ancestors(node: TSESTree.Node): Generator<TSESTree.Node>;
+//# sourceMappingURL=ancestors.d.ts.map

package/dist/support/ancestors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ancestors.d.ts","sourceRoot":"","sources":["../../src/support/ancestors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,+EAA+E;AAC/E,wBAAiB,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAIxE"}

package/dist/support/ancestors.js

@@ -0,0 +1,7 @@
+/** From the parent of `node` up to the program, whose own parent is absent. */
+export function* ancestors(node) {
+    for (let current = node.parent; current; current = current.parent) {
+        yield current;
+    }
+}
+//# sourceMappingURL=ancestors.js.map

package/dist/support/ancestors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ancestors.js","sourceRoot":"","sources":["../../src/support/ancestors.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,MAAM,SAAS,CAAC,CAAC,SAAS,CAAC,IAAmB;IAC5C,KAAK,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAClE,MAAM,OAAO,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/support/calls/accessed-name.d.ts

@@ -0,0 +1,4 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+/** The last name of an access: `access` for `access`, `this.access` and `this.#access` (with its hash). */
+export declare function accessedName(node: TSESTree.Node): string | undefined;
+//# sourceMappingURL=accessed-name.d.ts.map

package/dist/support/calls/accessed-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessed-name.d.ts","sourceRoot":"","sources":["../../../src/support/calls/accessed-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAIzE,2GAA2G;AAC3G,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,GAAG,MAAM,GAAG,SAAS,CAUpE"}

package/dist/support/calls/accessed-name.js

@@ -0,0 +1,14 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { keyName } from '../classes/key-name.js';
+import { propertyName } from '../globals/property-name.js';
+/** The last name of an access: `access` for `access`, `this.access` and `this.#access` (with its hash). */
+export function accessedName(node) {
+    if (node.type === AST_NODE_TYPES.Identifier) {
+        return node.name;
+    }
+    if (node.type !== AST_NODE_TYPES.MemberExpression) {
+        return undefined;
+    }
+    return node.computed ? propertyName(node) : keyName(node.property);
+}
+//# sourceMappingURL=accessed-name.js.map

package/dist/support/calls/accessed-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessed-name.js","sourceRoot":"","sources":["../../../src/support/calls/accessed-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,2GAA2G;AAC3G,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB,EAAE,CAAC;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACrE,CAAC"}

package/dist/support/calls/callee-name.d.ts

@@ -0,0 +1,4 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+/** The name a call is made under: `resolve` for `resolve(x)`, `bind` for `builder.bind(x)`. */
+export declare function calleeName(node: TSESTree.CallExpression | TSESTree.NewExpression): string | undefined;
+//# sourceMappingURL=callee-name.d.ts.map

package/dist/support/calls/callee-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callee-name.d.ts","sourceRoot":"","sources":["../../../src/support/calls/callee-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGzE,+FAA+F;AAC/F,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,cAAc,GAAG,QAAQ,CAAC,aAAa,GAAG,MAAM,GAAG,SAAS,CAQrG"}

package/dist/support/calls/callee-name.js

@@ -0,0 +1,11 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { propertyName } from '../globals/property-name.js';
+/** The name a call is made under: `resolve` for `resolve(x)`, `bind` for `builder.bind(x)`. */
+export function calleeName(node) {
+    const { callee } = node;
+    if (callee.type === AST_NODE_TYPES.Identifier) {
+        return callee.name;
+    }
+    return callee.type === AST_NODE_TYPES.MemberExpression ? propertyName(callee) : undefined;
+}
+//# sourceMappingURL=callee-name.js.map

package/dist/support/calls/callee-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callee-name.js","sourceRoot":"","sources":["../../../src/support/calls/callee-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,+FAA+F;AAC/F,MAAM,UAAU,UAAU,CAAC,IAAsD;IAC/E,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAExB,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU,EAAE,CAAC;QAC9C,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5F,CAAC"}

package/dist/support/calls/has-spread.d.ts

@@ -0,0 +1,4 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+/** With `{ ...defaults }` a key may be there without being written: the object cannot be judged for what it lacks. */
+export declare function hasSpread(object: TSESTree.ObjectExpression): boolean;
+//# sourceMappingURL=has-spread.d.ts.map

package/dist/support/calls/has-spread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-spread.d.ts","sourceRoot":"","sources":["../../../src/support/calls/has-spread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzE,sHAAsH;AACtH,wBAAgB,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,gBAAgB,GAAG,OAAO,CAEpE"}

package/dist/support/calls/has-spread.js

@@ -0,0 +1,6 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+/** With `{ ...defaults }` a key may be there without being written: the object cannot be judged for what it lacks. */
+export function hasSpread(object) {
+    return object.properties.some((property) => property.type === AST_NODE_TYPES.SpreadElement);
+}
+//# sourceMappingURL=has-spread.js.map

package/dist/support/calls/has-spread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-spread.js","sourceRoot":"","sources":["../../../src/support/calls/has-spread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AAEzE,sHAAsH;AACtH,MAAM,UAAU,SAAS,CAAC,MAAiC;IACzD,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,cAAc,CAAC,aAAa,CAAC,CAAC;AAC9F,CAAC"}

package/dist/support/calls/method-chain.d.ts

@@ -0,0 +1,8 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+export interface ChainLink {
+    readonly name: string;
+    readonly call: TSESTree.CallExpression;
+}
+/** `builder.command(X).requires(p).handledBy(H)` read from its last call: `command`, `requires`, `handledBy`. */
+export declare function methodChain(last: TSESTree.CallExpression): ChainLink[];
+//# sourceMappingURL=method-chain.d.ts.map

package/dist/support/calls/method-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-chain.d.ts","sourceRoot":"","sources":["../../../src/support/calls/method-chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGzE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC;CACxC;AAED,iHAAiH;AACjH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,cAAc,GAAG,SAAS,EAAE,CAUtE"}

package/dist/support/calls/method-chain.js

@@ -0,0 +1,13 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { propertyName } from '../globals/property-name.js';
+/** `builder.command(X).requires(p).handledBy(H)` read from its last call: `command`, `requires`, `handledBy`. */
+export function methodChain(last) {
+    const links = [];
+    let current = last;
+    while (current.type === AST_NODE_TYPES.CallExpression && current.callee.type === AST_NODE_TYPES.MemberExpression) {
+        links.unshift({ name: propertyName(current.callee) ?? '', call: current });
+        current = current.callee.object;
+    }
+    return links;
+}
+//# sourceMappingURL=method-chain.js.map

package/dist/support/calls/method-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-chain.js","sourceRoot":"","sources":["../../../src/support/calls/method-chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAO3D,iHAAiH;AACjH,MAAM,UAAU,WAAW,CAAC,IAA6B;IACvD,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,IAAI,OAAO,GAAkB,IAAI,CAAC;IAElC,OAAO,OAAO,CAAC,IAAI,KAAK,cAAc,CAAC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB,EAAE,CAAC;QACjH,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3E,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;IAClC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/support/calls/missing-keys.d.ts

@@ -0,0 +1,7 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+/**
+ * The keys of `required` an options argument visibly lacks. An argument that is not an object
+ * literal, or that spreads another object, is not judged: nothing is reported as missing.
+ */
+export declare function missingKeys(options: TSESTree.Node | undefined, required: readonly string[]): string[];
+//# sourceMappingURL=missing-keys.d.ts.map

package/dist/support/calls/missing-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-keys.d.ts","sourceRoot":"","sources":["../../../src/support/calls/missing-keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAKzE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,GAAG,SAAS,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAUrG"}

package/dist/support/calls/missing-keys.js

@@ -0,0 +1,28 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { staticString } from '../imports/static-string.js';
+import { propertyOf } from './property-of.js';
+import { hasSpread } from './has-spread.js';
+/**
+ * The keys of `required` an options argument visibly lacks. An argument that is not an object
+ * literal, or that spreads another object, is not judged: nothing is reported as missing.
+ */
+export function missingKeys(options, required) {
+    if (options === undefined) {
+        return [...required];
+    }
+    if (options.type !== AST_NODE_TYPES.ObjectExpression || hasSpread(options)) {
+        return [];
+    }
+    return required.filter((key) => !isGiven(propertyOf(options, key)));
+}
+function isGiven(property) {
+    if (property === undefined) {
+        return false;
+    }
+    const { value } = property;
+    if (value.type === AST_NODE_TYPES.Identifier && value.name === 'undefined') {
+        return false;
+    }
+    return staticString(value) !== '';
+}
+//# sourceMappingURL=missing-keys.js.map

package/dist/support/calls/missing-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-keys.js","sourceRoot":"","sources":["../../../src/support/calls/missing-keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAkC,EAAE,QAA2B;IACzF,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3E,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,OAAO,CAAC,QAAuC;IACtD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;IAE3B,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;AACpC,CAAC"}

package/dist/support/calls/property-of.d.ts

@@ -0,0 +1,3 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+export declare function propertyOf(object: TSESTree.ObjectExpression, key: string): TSESTree.Property | undefined;
+//# sourceMappingURL=property-of.d.ts.map

package/dist/support/calls/property-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-of.d.ts","sourceRoot":"","sources":["../../../src/support/calls/property-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGzE,wBAAgB,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,GAAG,SAAS,CAIxG"}

package/dist/support/calls/property-of.js

@@ -0,0 +1,8 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { keyName } from '../classes/key-name.js';
+export function propertyOf(object, key) {
+    return object.properties
+        .filter((property) => property.type === AST_NODE_TYPES.Property)
+        .find((property) => !property.computed && keyName(property.key) === key);
+}
+//# sourceMappingURL=property-of.js.map

package/dist/support/calls/property-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-of.js","sourceRoot":"","sources":["../../../src/support/calls/property-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,MAAM,UAAU,UAAU,CAAC,MAAiC,EAAE,GAAW;IACvE,OAAO,MAAM,CAAC,UAAU;SACrB,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,cAAc,CAAC,QAAQ,CAAC;SAC/D,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;AAC7E,CAAC"}

package/dist/support/classes/class-finder.d.ts

@@ -0,0 +1,18 @@
+import { type TSESLint, type TSESTree } from '@typescript-eslint/utils';
+import type { LintedFile } from '../../project/linted-file.js';
+type Parser = TSESLint.FlatConfig.Parser;
+/** A class and the program that declares it: the linted file, or the file it is imported from. */
+interface ClassSite {
+    readonly program: TSESTree.Program;
+    readonly node: TSESTree.ClassDeclaration;
+}
+export type ClassFinder = (name: string) => ClassSite | undefined;
+/**
+ * Finds the class behind a name of the linted file: declared at its top, or imported by name
+ * from a source of the project that exists on disk, which is then parsed with the parser of the
+ * run and nothing else (no types, no scope). A barrel, a renaming export or a file that cannot
+ * be read or parsed answers undefined: the caller then judges what it sees in the file alone.
+ */
+export declare function classFinder(file: LintedFile, program: TSESTree.Program, parser: Parser | undefined): ClassFinder;
+export {};
+//# sourceMappingURL=class-finder.d.ts.map

package/dist/support/classes/class-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-finder.d.ts","sourceRoot":"","sources":["../../../src/support/classes/class-finder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAG/D,KAAK,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;AAEzC,kGAAkG;AAClG,UAAU,SAAS;IACjB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,gBAAgB,CAAC;CAC1C;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,CAAC;AAgBlE;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAoBhH"}