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

package/dist/rules/clean-function-ceiling.js

@@ -0,0 +1,32 @@
+import { FUNCTION_LINES_CEILING } from '../project/parse-config.js';
+import { defineRule } from '../support/rule/define-rule.js';
+import { codeLines } from '../support/functions/code-lines.js';
+import { describedFunction } from '../support/functions/described-function.js';
+/**
+ * The hard ceiling of clean/function-size. ESLint gives one severity to a rule name, so the
+ * part that is an error whatever the configured limit is a rule of its own.
+ */
+export const cleanFunctionCeiling = defineRule({
+    id: 'clean/function-size',
+    name: 'clean-function-ceiling',
+    type: 'suggestion',
+    recommended: 'error',
+    description: 'No function is longer than 100 lines of code, whatever the configured limit: not a test suite, not a module file.',
+    messages: {
+        ceiling: '{{name}} is {{count}} lines long: no function goes past {{limit}} lines, a `describe` callback and a module file included. Split it by responsibility: one function per step, one `describe` (or one spec file) per behaviour, one registration function per group of bindings.',
+    },
+    create({ sourceCode, report }) {
+        const judge = (node) => {
+            const count = codeLines(node, sourceCode);
+            if (count > FUNCTION_LINES_CEILING) {
+                report({
+                    loc: describedFunction(node, sourceCode).loc,
+                    messageId: 'ceiling',
+                    data: { name: describedFunction(node, sourceCode).name, count, limit: FUNCTION_LINES_CEILING },
+                });
+            }
+        };
+        return { FunctionDeclaration: judge, FunctionExpression: judge, ArrowFunctionExpression: judge };
+    },
+});
+//# sourceMappingURL=clean-function-ceiling.js.map

package/dist/rules/clean-function-ceiling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-function-ceiling.js","sourceRoot":"","sources":["../../src/rules/clean-function-ceiling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAG/E;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAY;IACxD,EAAE,EAAE,qBAAqB;IACzB,IAAI,EAAE,wBAAwB;IAC9B,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,OAAO;IACpB,WAAW,EACT,mHAAmH;IACrH,QAAQ,EAAE;QACR,OAAO,EACL,iRAAiR;KACpR;IACD,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE;QAC3B,MAAM,KAAK,GAAG,CAAC,IAAkB,EAAQ,EAAE;YACzC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAE1C,IAAI,KAAK,GAAG,sBAAsB,EAAE,CAAC;gBACnC,MAAM,CAAC;oBACL,GAAG,EAAE,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,GAAG;oBAC5C,SAAS,EAAE,SAAS;oBACpB,IAAI,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,EAAE;iBAC/F,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC;QAEF,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,uBAAuB,EAAE,KAAK,EAAE,CAAC;IACnG,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/clean-function-size.d.ts

@@ -0,0 +1,7 @@
+interface Options {
+    readonly maxParameters?: number;
+    readonly maxLines?: number;
+}
+export declare const cleanFunctionSize: import("@typescript-eslint/utils/ts-eslint").RuleModule<"lines" | "parameters", [Options], import("../index.js").RuleDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+export {};
+//# sourceMappingURL=clean-function-size.d.ts.map

package/dist/rules/clean-function-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-function-size.d.ts","sourceRoot":"","sources":["../../src/rules/clean-function-size.ts"],"names":[],"mappings":"AAOA,UAAU,OAAO;IACf,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAID,eAAO,MAAM,iBAAiB,uLA2C5B,CAAC"}

package/dist/rules/clean-function-size.js

@@ -0,0 +1,70 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { FUNCTION_LINES_CEILING } from '../project/parse-config.js';
+import { defineRule } from '../support/rule/define-rule.js';
+import { codeLines } from '../support/functions/code-lines.js';
+import { describedFunction } from '../support/functions/described-function.js';
+const GROUPING_CALLS = new Set(['describe', 'suite', 'context']);
+export const cleanFunctionSize = defineRule({
+    id: 'clean/function-size',
+    type: 'suggestion',
+    recommended: 'warn',
+    description: 'A function has at most 3 parameters and 30 lines (configurable, never above 100 lines); a longer one is doing more than one thing.',
+    messages: {
+        parameters: '{{name}} takes {{count}} parameters (limit {{limit}}). Group the parameters that travel together into a value object or a named parameter object: they are a concept that has no name yet.',
+        lines: '{{name}} is {{count}} lines long (limit {{limit}}). Extract each step into a function named after what it does, placed below this one, until the body reads as a list of intentions.',
+    },
+    schema: [
+        {
+            type: 'object',
+            additionalProperties: false,
+            properties: { maxParameters: { type: 'integer', minimum: 1 }, maxLines: { type: 'integer', minimum: 1 } },
+        },
+    ],
+    defaultOptions: [{}],
+    create({ file, sourceCode, options: [options], report }) {
+        const maxParameters = options.maxParameters ?? file.config.limits.maxParameters;
+        const maxLines = Math.min(options.maxLines ?? file.config.limits.maxFunctionLines, FUNCTION_LINES_CEILING);
+        const isComposition = file.location.area === 'context' && file.location.layer === 'module';
+        const judge = (node) => {
+            const { name, loc } = describedFunction(node, sourceCode);
+            const parameters = node.params.filter((parameter) => !isThisParameter(parameter)).length;
+            // A constructor lists the dependencies it is given: that is wiring, not a signature to shorten.
+            if (parameters > maxParameters && !isConstructor(node)) {
+                report({ loc, messageId: 'parameters', data: { name, count: parameters, limit: maxParameters } });
+            }
+            const lines = isComposition || isGroupingCallback(node) ? 0 : codeLines(node, sourceCode);
+            if (lines > maxLines) {
+                report({ loc, messageId: 'lines', data: { name, count: lines, limit: maxLines } });
+            }
+        };
+        return { FunctionDeclaration: judge, FunctionExpression: judge, ArrowFunctionExpression: judge };
+    },
+});
+function isThisParameter(parameter) {
+    return parameter.type === AST_NODE_TYPES.Identifier && parameter.name === 'this';
+}
+function isConstructor(node) {
+    return node.parent.type === AST_NODE_TYPES.MethodDefinition && node.parent.kind === 'constructor';
+}
+/** The callback of `describe(...)` holds tests, not steps: its length says nothing about one thing. */
+function isGroupingCallback(node) {
+    if (node.parent.type !== AST_NODE_TYPES.CallExpression ||
+        !node.parent.arguments.some((argument) => argument === node)) {
+        return false;
+    }
+    let callee = node.parent.callee;
+    if (isInjectedGrouping(callee)) {
+        return true;
+    }
+    while (callee.type === AST_NODE_TYPES.MemberExpression || callee.type === AST_NODE_TYPES.CallExpression) {
+        callee = callee.type === AST_NODE_TYPES.MemberExpression ? callee.object : callee.callee;
+    }
+    return callee.type === AST_NODE_TYPES.Identifier && GROUPING_CALLS.has(callee.name);
+}
+/** `runner.describe(...)`: a contract suite receives its test runner instead of importing it. */
+function isInjectedGrouping(callee) {
+    return (callee.type === AST_NODE_TYPES.MemberExpression &&
+        callee.property.type === AST_NODE_TYPES.Identifier &&
+        GROUPING_CALLS.has(callee.property.name));
+}
+//# sourceMappingURL=clean-function-size.js.map

package/dist/rules/clean-function-size.js.map

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

package/dist/rules/clean-no-commented-out-code.d.ts

@@ -0,0 +1,3 @@
+import type { TSESLint } from '@typescript-eslint/utils';
+export declare const cleanNoCommentedOutCode: TSESLint.RuleModule<"code", [], import("../index.js").RuleDocs, TSESLint.RuleListener>;
+//# sourceMappingURL=clean-no-commented-out-code.d.ts.map

package/dist/rules/clean-no-commented-out-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-no-commented-out-code.d.ts","sourceRoot":"","sources":["../../src/rules/clean-no-commented-out-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAOzD,eAAO,MAAM,uBAAuB,wFAuBlC,CAAC"}

package/dist/rules/clean-no-commented-out-code.js

@@ -0,0 +1,60 @@
+import { isCommentedOutCode } from '../support/comments/is-commented-out-code.js';
+import { isFragment } from '../support/comments/is-fragment.js';
+import { commentLines } from '../support/comments/comment-lines.js';
+import { isDirective } from '../support/comments/is-directive.js';
+import { defineRule } from '../support/rule/define-rule.js';
+export const cleanNoCommentedOutCode = defineRule({
+    id: 'clean/no-commented-out-code',
+    type: 'suggestion',
+    recommended: 'error',
+    description: 'No code in comments. Version control remembers.',
+    messages: {
+        code: 'The comment holds code: "{{excerpt}}". Delete it: version control keeps the old version, and code that does not run misleads the reader.',
+    },
+    create({ context, sourceCode, report }) {
+        const { parser } = context.languageOptions;
+        return {
+            Program() {
+                for (const paragraph of paragraphs(sourceCode)) {
+                    const culprit = firstCodeLine(paragraph, parser);
+                    if (culprit !== undefined) {
+                        report({ loc: culprit.loc, messageId: 'code', data: { excerpt: culprit.text.slice(0, 60) } });
+                    }
+                }
+            },
+        };
+    },
+});
+/** Consecutive comment lines are read together: a commented-out block is one finding. */
+function paragraphs(sourceCode) {
+    const groups = [];
+    let previous;
+    for (const line of commentLines(sourceCode)) {
+        if (line.jsdoc || line.sample || line.text === '' || isDirective(line.text)) {
+            continue;
+        }
+        const current = previous !== undefined && continues(previous, line) ? groups.at(-1) : undefined;
+        if (current === undefined) {
+            groups.push([line]);
+        }
+        else {
+            current.push(line);
+        }
+        previous = line;
+    }
+    return groups;
+}
+function continues(previous, line) {
+    if (previous.trailing || line.trailing || line.loc.start.line !== previous.loc.start.line + 1) {
+        return false;
+    }
+    return previous.comment === line.comment || (!previous.block && !line.block);
+}
+function firstCodeLine(paragraph, parser) {
+    const whole = paragraph.map((line) => line.text).join('\n');
+    if (paragraph.length > 1 && isCommentedOutCode(whole, parser)) {
+        return paragraph[0];
+    }
+    return (paragraph.find((line) => isCommentedOutCode(line.text, parser)) ?? paragraph.find((line) => isFragment(line.text)));
+}
+//# sourceMappingURL=clean-no-commented-out-code.js.map

package/dist/rules/clean-no-commented-out-code.js.map

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

package/dist/rules/clean-no-escape-hatch.d.ts

@@ -0,0 +1,15 @@
+import { type TSESLint } from '@typescript-eslint/utils';
+interface Options {
+    readonly typeAssertions?: boolean;
+    /** Posix globs, relative to the project root, of adapters and mappers that live outside a context. */
+    readonly adapterGlobs?: readonly string[];
+    /** Lets `value as T` through when `T` is a type parameter the caller chose and the function returns. */
+    readonly allowCallerClaimedGenerics?: boolean;
+}
+/**
+ * The part of clean/no-escape-hatch that no standard rule covers. `any`, the non-null
+ * assertion and the `@ts-` comments are held by typescript-eslint rules the presets enable.
+ */
+export declare const cleanNoEscapeHatch: TSESLint.RuleModule<"assertion" | "undescribedDisable", [Options], import("../index.js").RuleDocs, TSESLint.RuleListener>;
+export {};
+//# sourceMappingURL=clean-no-escape-hatch.d.ts.map

package/dist/rules/clean-no-escape-hatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-no-escape-hatch.d.ts","sourceRoot":"","sources":["../../src/rules/clean-no-escape-hatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,QAAQ,EAAiB,MAAM,0BAA0B,CAAC;AASzG,UAAU,OAAO;IACf,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,sGAAsG;IACtG,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,wGAAwG;IACxG,QAAQ,CAAC,0BAA0B,CAAC,EAAE,OAAO,CAAC;CAC/C;AAID;;;GAGG;AACH,eAAO,MAAM,kBAAkB,2HAkD7B,CAAC"}

package/dist/rules/clean-no-escape-hatch.js

@@ -0,0 +1,116 @@
+import { AST_NODE_TYPES, AST_TOKEN_TYPES } from '@typescript-eslint/utils';
+import { ancestors } from '../support/ancestors.js';
+import { defineRule } from '../support/rule/define-rule.js';
+import { globMatcher } from '../support/glob-matcher.js';
+const DISABLE = /^\s*(eslint-disable(?:-next-line|-line)?)\b(.*)$/s;
+/**
+ * The part of clean/no-escape-hatch that no standard rule covers. `any`, the non-null
+ * assertion and the `@ts-` comments are held by typescript-eslint rules the presets enable.
+ */
+export const cleanNoEscapeHatch = defineRule({
+    id: 'clean/no-escape-hatch',
+    type: 'problem',
+    recommended: 'error',
+    description: 'No type assertion outside mappers and infrastructure adapters, no eslint-disable without a reason.',
+    messages: {
+        assertion: 'The assertion to {{type}} overrules the compiler. Narrow with a type guard, parse the value with a schema, or annotate with `satisfies`; an assertion belongs in a *.mapper.ts or an infrastructure adapter, where foreign data enters.',
+        undescribedDisable: '{{directive}} gives no reason. Fix the diagnostic; if it cannot be fixed, name the rule and add the reason after `--`.',
+    },
+    schema: [
+        {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                typeAssertions: { type: 'boolean' },
+                adapterGlobs: { type: 'array', items: { type: 'string' }, uniqueItems: true },
+                allowCallerClaimedGenerics: { type: 'boolean' },
+            },
+        },
+    ],
+    defaultOptions: [{}],
+    create({ file, sourceCode, options: [options], report }) {
+        const judgesAssertions = options.typeAssertions !== false && !mayAssert(file) && !globMatcher(options.adapterGlobs ?? [])(file.path);
+        const isClaimed = (node) => options.allowCallerClaimedGenerics === true && isCallerClaimed(node, sourceCode);
+        const judge = (node) => {
+            if (judgesAssertions && isEscape(node) && !isClaimed(node)) {
+                report({ node, messageId: 'assertion', data: { type: sourceCode.getText(node.typeAnnotation) } });
+            }
+        };
+        return {
+            TSAsExpression: judge,
+            TSTypeAssertion: judge,
+            Program() {
+                for (const comment of sourceCode.getAllComments()) {
+                    const directive = undescribedDisable(comment.value);
+                    if (directive !== undefined) {
+                        report({ loc: comment.loc, messageId: 'undescribedDisable', data: { directive } });
+                    }
+                }
+            },
+        };
+    },
+});
+/** Mappers and infrastructure adapters translate rows and payloads the compiler knows nothing about. */
+function mayAssert(file) {
+    if (file.path.endsWith('.mapper.ts')) {
+        return true;
+    }
+    return file.location.area === 'context' && file.location.layer === 'infrastructure';
+}
+function isEscape(node) {
+    if (isAssertion(node.parent)) {
+        return false;
+    }
+    const type = node.typeAnnotation;
+    if (type.type === AST_NODE_TYPES.TSUnknownKeyword) {
+        return false;
+    }
+    return !(type.type === AST_NODE_TYPES.TSTypeReference &&
+        type.typeName.type === AST_NODE_TYPES.Identifier &&
+        type.typeName.name === 'const');
+}
+function isAssertion(node) {
+    return node.type === AST_NODE_TYPES.TSAsExpression || node.type === AST_NODE_TYPES.TSTypeAssertion;
+}
+/**
+ * `get<Body>(): Promise<Body>` answering `value as Body`: the type is a claim of the caller,
+ * which the function can only pass on. The type parameter has to appear in the return type.
+ */
+function isCallerClaimed(node, sourceCode) {
+    const type = node.typeAnnotation;
+    if (type.type !== AST_NODE_TYPES.TSTypeReference ||
+        type.typeName.type !== AST_NODE_TYPES.Identifier ||
+        type.typeArguments !== undefined) {
+        return false;
+    }
+    const { name } = type.typeName;
+    const returned = declaringFunction(node, name)?.returnType;
+    return (returned !== undefined &&
+        sourceCode.getTokens(returned).some((token) => token.type === AST_TOKEN_TYPES.Identifier && token.value === name));
+}
+/** The nearest function that declares `<name>`; a class declaring the same name in between hides it. */
+function declaringFunction(node, name) {
+    for (const parent of ancestors(node)) {
+        if (!('typeParameters' in parent) || parent.typeParameters?.type !== AST_NODE_TYPES.TSTypeParameterDeclaration) {
+            continue;
+        }
+        if (!parent.typeParameters.params.some((parameter) => parameter.name.name === name)) {
+            continue;
+        }
+        return isGeneric(parent) ? parent : undefined;
+    }
+    return undefined;
+}
+function isGeneric(node) {
+    return (node.type === AST_NODE_TYPES.FunctionDeclaration ||
+        node.type === AST_NODE_TYPES.FunctionExpression ||
+        node.type === AST_NODE_TYPES.ArrowFunctionExpression);
+}
+function undescribedDisable(comment) {
+    const match = DISABLE.exec(comment);
+    if (match === null || /--\s*\S/.test(match[2] ?? '')) {
+        return undefined;
+    }
+    return match[1];
+}
+//# sourceMappingURL=clean-no-escape-hatch.js.map

package/dist/rules/clean-no-escape-hatch.js.map

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

package/dist/rules/clean-no-flag-argument.d.ts

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

package/dist/rules/clean-no-flag-argument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-no-flag-argument.d.ts","sourceRoot":"","sources":["../../src/rules/clean-no-flag-argument.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,mBAAmB,gKAoC9B,CAAC"}

package/dist/rules/clean-no-flag-argument.js

@@ -0,0 +1,80 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { className } from '../support/classes/class-name.js';
+import { isCallable } from '../support/classes/is-callable.js';
+import { isFunction } from '../support/classes/is-function.js';
+import { memberName } from '../support/classes/member-name.js';
+import { visibilityOf } from '../support/classes/visibility-of.js';
+import { defineRule } from '../support/rule/define-rule.js';
+export const cleanNoFlagArgument = defineRule({
+    id: 'clean/no-flag-argument',
+    type: 'suggestion',
+    recommended: 'warn',
+    description: 'No boolean parameter on a public method of the domain or a use case: two intentions are two methods.',
+    messages: {
+        flag: '{{className}}.{{method}} takes the flag "{{flag}}". Split {{method}} into two methods named after each intention, so that a call site says what it does without a true or false to decode.',
+    },
+    create({ file, report }) {
+        if (file.location.area !== 'context' || file.isTest) {
+            return {};
+        }
+        return {
+            ClassBody(body) {
+                const owner = className(body.parent);
+                // Messages carry data: a command or a query is exempt.
+                if (/(?:Command|Query)$/.test(owner)) {
+                    return;
+                }
+                for (const member of body.body.filter(isCallable)) {
+                    const method = memberName(member) ?? '';
+                    if (visibilityOf(member) !== 'public' || !isJudged(file, method)) {
+                        continue;
+                    }
+                    for (const flag of flagsOf(member)) {
+                        report({ node: flag, messageId: 'flag', data: { className: owner, method, flag: flag.name } });
+                    }
+                }
+            },
+        };
+    },
+});
+/** Public behaviour of the domain, and the `execute` of a use case. */
+function isJudged(file, method) {
+    if (file.location.area !== 'context') {
+        return false;
+    }
+    return file.location.layer === 'domain' || (file.location.layer === 'application' && method === 'execute');
+}
+function flagsOf(member) {
+    const callable = member.value;
+    if (callable === null || !isFunction(callable)) {
+        return [];
+    }
+    return callable.params.flatMap((parameter) => {
+        const flag = flagOf(parameter);
+        return flag === undefined ? [] : [flag];
+    });
+}
+function flagOf(parameter) {
+    if (parameter.type === AST_NODE_TYPES.Identifier) {
+        return isBooleanType(parameter.typeAnnotation?.typeAnnotation) ? parameter : undefined;
+    }
+    if (parameter.type !== AST_NODE_TYPES.AssignmentPattern || parameter.left.type !== AST_NODE_TYPES.Identifier) {
+        return undefined;
+    }
+    const defaultsToBoolean = parameter.right.type === AST_NODE_TYPES.Literal && typeof parameter.right.value === 'boolean';
+    return defaultsToBoolean || isBooleanType(parameter.left.typeAnnotation?.typeAnnotation) ? parameter.left : undefined;
+}
+function isBooleanType(type) {
+    if (type === undefined) {
+        return false;
+    }
+    if (type.type === AST_NODE_TYPES.TSBooleanKeyword) {
+        return true;
+    }
+    if (type.type !== AST_NODE_TYPES.TSUnionType) {
+        return false;
+    }
+    const meaningful = type.types.filter((member) => member.type !== AST_NODE_TYPES.TSUndefinedKeyword && member.type !== AST_NODE_TYPES.TSNullKeyword);
+    return meaningful.length > 0 && meaningful.every((member) => member.type === AST_NODE_TYPES.TSBooleanKeyword);
+}
+//# sourceMappingURL=clean-no-flag-argument.js.map

package/dist/rules/clean-no-flag-argument.js.map

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

package/dist/rules/clean-no-hash-private.d.ts

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

package/dist/rules/clean-no-hash-private.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-no-hash-private.d.ts","sourceRoot":"","sources":["../../src/rules/clean-no-hash-private.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,kBAAkB,gKAmC7B,CAAC"}

package/dist/rules/clean-no-hash-private.js

@@ -0,0 +1,36 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { className } from '../support/classes/class-name.js';
+import { defineRule } from '../support/rule/define-rule.js';
+import { hashPrivateFix } from '../support/hash-private-fix.js';
+export const cleanNoHashPrivate = defineRule({
+    id: 'clean/no-hash-private',
+    type: 'suggestion',
+    recommended: 'error',
+    fixable: 'code',
+    description: 'A class member is `private`, never `#name`: one way to say private, the one the compiler checks and the tools of the kit read.',
+    messages: {
+        hash: '{{className}} declares #{{name}}. Write `private {{name}}`: a member is hidden with the `private` keyword, which reads the same on a field, a method, an accessor and a constructor parameter.',
+    },
+    create({ sourceCode, report }) {
+        return {
+            PrivateIdentifier(node) {
+                const member = node.parent;
+                const owner = member.parent?.parent;
+                if (member.type === AST_NODE_TYPES.MemberExpression || member.type === AST_NODE_TYPES.BinaryExpression) {
+                    return;
+                }
+                if (owner?.type !== AST_NODE_TYPES.ClassDeclaration && owner?.type !== AST_NODE_TYPES.ClassExpression) {
+                    return;
+                }
+                const fix = hashPrivateFix(sourceCode, owner, node.name);
+                report({
+                    node,
+                    messageId: 'hash',
+                    data: { className: className(owner), name: node.name },
+                    ...(fix === undefined ? {} : { fix }),
+                });
+            },
+        };
+    },
+});
+//# sourceMappingURL=clean-no-hash-private.js.map

package/dist/rules/clean-no-hash-private.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-no-hash-private.js","sourceRoot":"","sources":["../../src/rules/clean-no-hash-private.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAS;IACnD,EAAE,EAAE,uBAAuB;IAC3B,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,OAAO;IACpB,OAAO,EAAE,MAAM;IACf,WAAW,EACT,gIAAgI;IAClI,QAAQ,EAAE;QACR,IAAI,EAAE,gMAAgM;KACvM;IACD,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE;QAC3B,OAAO;YACL,iBAAiB,CAAC,IAAgC;gBAChD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;gBAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEpC,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB,EAAE,CAAC;oBACvG,OAAO;gBACT,CAAC;gBAED,IAAI,KAAK,EAAE,IAAI,KAAK,cAAc,CAAC,gBAAgB,IAAI,KAAK,EAAE,IAAI,KAAK,cAAc,CAAC,eAAe,EAAE,CAAC;oBACtG,OAAO;gBACT,CAAC;gBAED,MAAM,GAAG,GAAG,cAAc,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAEzD,MAAM,CAAC;oBACL,IAAI;oBACJ,SAAS,EAAE,MAAM;oBACjB,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;oBACtD,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;iBACtC,CAAC,CAAC;YACL,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/clean-no-noise-comment.d.ts

@@ -0,0 +1,5 @@
+import { type TSESLint } from '@typescript-eslint/utils';
+type Noise = 'banner' | 'closingBrace' | 'journal' | 'emptyTag' | 'ownerlessTodo';
+export declare const cleanNoNoiseComment: TSESLint.RuleModule<"restatesName" | Noise, [], import("../index.js").RuleDocs, TSESLint.RuleListener>;
+export {};
+//# sourceMappingURL=clean-no-noise-comment.d.ts.map

package/dist/rules/clean-no-noise-comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-no-noise-comment.d.ts","sourceRoot":"","sources":["../../src/rules/clean-no-noise-comment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,QAAQ,EAAiB,MAAM,0BAA0B,CAAC;AAQzF,KAAK,KAAK,GAAG,QAAQ,GAAG,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,eAAe,CAAC;AAiFlF,eAAO,MAAM,mBAAmB,wGAkD9B,CAAC"}