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

package/dist/support/classes/class-finder.js

@@ -0,0 +1,76 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { resolveImport } from '../../project/resolve-import.js';
+import { isRecord } from '../../project/is-record.js';
+import { topLevelClasses } from './top-level-classes.js';
+const PARSER_OPTIONS = { sourceType: 'module', ecmaVersion: 'latest', range: true, loc: true };
+const sources = new Map();
+/**
+ * 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 function classFinder(file, program, parser) {
+    return (name) => {
+        const local = classNamed(program, name);
+        if (local !== undefined) {
+            return { program, node: local };
+        }
+        const origin = importOrigin(program, name);
+        const target = origin === undefined ? undefined : resolveImport(file.config, file.path, origin.specifier);
+        if (origin === undefined || target?.kind !== 'file' || parser === undefined) {
+            return undefined;
+        }
+        const foreign = readProgram(path.resolve(file.root, target.path), parser);
+        const node = foreign === undefined ? undefined : classNamed(foreign, origin.exported);
+        return foreign === undefined || node === undefined ? undefined : { program: foreign, node };
+    };
+}
+function classNamed(program, name) {
+    return topLevelClasses(program).find((declaration) => declaration.id?.name === name);
+}
+function importOrigin(program, local) {
+    for (const statement of program.body) {
+        if (statement.type !== AST_NODE_TYPES.ImportDeclaration) {
+            continue;
+        }
+        const specifier = statement.specifiers.find((candidate) => candidate.type === AST_NODE_TYPES.ImportSpecifier && candidate.local.name === local);
+        if (specifier?.type !== AST_NODE_TYPES.ImportSpecifier) {
+            continue;
+        }
+        const exported = specifier.imported.type === AST_NODE_TYPES.Identifier ? specifier.imported.name : specifier.imported.value;
+        return { specifier: statement.source.value, exported };
+    }
+    return undefined;
+}
+/** Parsed once per file and per change of the file: an editor session sees an edit of the imported file. */
+function readProgram(absolute, parser) {
+    const modifiedAt = fs.statSync(absolute, { throwIfNoEntry: false })?.mtimeMs;
+    if (modifiedAt === undefined) {
+        return undefined;
+    }
+    const known = sources.get(absolute);
+    if (known?.modifiedAt === modifiedAt) {
+        return known.program;
+    }
+    const program = parseFile(absolute, parser);
+    sources.set(absolute, { modifiedAt, program });
+    return program;
+}
+function parseFile(absolute, parser) {
+    try {
+        const text = fs.readFileSync(absolute, 'utf8');
+        const options = { ...PARSER_OPTIONS, filePath: absolute };
+        const parsed = 'parseForESLint' in parser ? parser.parseForESLint(text, options).ast : parser.parse(text, options);
+        return isProgram(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isProgram(value) {
+    return isRecord(value) && value['type'] === AST_NODE_TYPES.Program && Array.isArray(value['body']);
+}
+//# sourceMappingURL=class-finder.js.map

package/dist/support/classes/class-finder.js.map

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

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

@@ -0,0 +1,4 @@
+import type { TSESTree } from '@typescript-eslint/utils';
+export type ClassNode = TSESTree.ClassDeclaration | TSESTree.ClassExpression;
+export declare function className(node: ClassNode): string;
+//# sourceMappingURL=class-name.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"class-name.d.ts","sourceRoot":"","sources":["../../../src/support/classes/class-name.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,gBAAgB,GAAG,QAAQ,CAAC,eAAe,CAAC;AAE7E,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEjD"}

package/dist/support/classes/class-name.js

@@ -0,0 +1,4 @@
+export function className(node) {
+    return node.id?.name ?? 'the class';
+}
+//# sourceMappingURL=class-name.js.map

package/dist/support/classes/class-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-name.js","sourceRoot":"","sources":["../../../src/support/classes/class-name.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,SAAS,CAAC,IAAe;IACvC,OAAO,IAAI,CAAC,EAAE,EAAE,IAAI,IAAI,WAAW,CAAC;AACtC,CAAC"}

package/dist/support/classes/constructor-of.d.ts

@@ -0,0 +1,3 @@
+import type { TSESTree } from '@typescript-eslint/utils';
+export declare function constructorOf(body: TSESTree.ClassBody): TSESTree.MethodDefinition | undefined;
+//# sourceMappingURL=constructor-of.d.ts.map

package/dist/support/classes/constructor-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructor-of.d.ts","sourceRoot":"","sources":["../../../src/support/classes/constructor-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGzD,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,gBAAgB,GAAG,SAAS,CAE7F"}

package/dist/support/classes/constructor-of.js

@@ -0,0 +1,5 @@
+import { isConstructor } from './is-constructor.js';
+export function constructorOf(body) {
+    return body.body.find(isConstructor);
+}
+//# sourceMappingURL=constructor-of.js.map

package/dist/support/classes/constructor-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructor-of.js","sourceRoot":"","sources":["../../../src/support/classes/constructor-of.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,UAAU,aAAa,CAAC,IAAwB;IACpD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACvC,CAAC"}

package/dist/support/classes/enclosing-member.d.ts

@@ -0,0 +1,8 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+export interface MemberSite {
+    readonly member: TSESTree.ClassElement;
+    readonly body: TSESTree.ClassBody;
+}
+/** The class member a node belongs to, for the innermost class around it. */
+export declare function enclosingMember(node: TSESTree.Node): MemberSite | undefined;
+//# sourceMappingURL=enclosing-member.d.ts.map

package/dist/support/classes/enclosing-member.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enclosing-member.d.ts","sourceRoot":"","sources":["../../../src/support/classes/enclosing-member.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGzE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC;CACnC;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,GAAG,UAAU,GAAG,SAAS,CAc3E"}

package/dist/support/classes/enclosing-member.js

@@ -0,0 +1,15 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { ancestors } from '../ancestors.js';
+/** The class member a node belongs to, for the innermost class around it. */
+export function enclosingMember(node) {
+    let child = node;
+    for (const parent of ancestors(node)) {
+        if (parent.type === AST_NODE_TYPES.ClassBody) {
+            const member = parent.body.find((candidate) => candidate === child);
+            return member === undefined ? undefined : { member, body: parent };
+        }
+        child = parent;
+    }
+    return undefined;
+}
+//# sourceMappingURL=enclosing-member.js.map

package/dist/support/classes/enclosing-member.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enclosing-member.js","sourceRoot":"","sources":["../../../src/support/classes/enclosing-member.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAO5C,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,IAAmB;IACjD,IAAI,KAAK,GAAG,IAAI,CAAC;IAEjB,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,SAAS,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC;YAEpE,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACrE,CAAC;QAED,KAAK,GAAG,MAAM,CAAC;IACjB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/support/classes/exported-classes.d.ts

@@ -0,0 +1,4 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+/** Those a module exports: inline, by `export { A }` or by `export default A`. */
+export declare function exportedClasses(program: TSESTree.Program): TSESTree.ClassDeclaration[];
+//# sourceMappingURL=exported-classes.d.ts.map

package/dist/support/classes/exported-classes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exported-classes.d.ts","sourceRoot":"","sources":["../../../src/support/classes/exported-classes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAIzE,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,gBAAgB,EAAE,CActF"}

package/dist/support/classes/exported-classes.js

@@ -0,0 +1,22 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { topLevelClasses } from './top-level-classes.js';
+import { isInlineExport } from './is-inline-export.js';
+/** Those a module exports: inline, by `export { A }` or by `export default A`. */
+export function exportedClasses(program) {
+    const inline = new Set(program.body.flatMap((statement) => isInlineExport(statement) && statement.declaration?.type === AST_NODE_TYPES.ClassDeclaration
+        ? [statement.declaration]
+        : []));
+    const exportedNames = new Set(program.body.flatMap(exportedLocalNames));
+    return topLevelClasses(program).filter((declaration) => inline.has(declaration) || exportedNames.has(declaration.id?.name ?? ''));
+}
+/** Names exported after their declaration: `export { IssueInvoiceHandler }` and `export default IssueInvoiceHandler`. */
+function exportedLocalNames(statement) {
+    if (statement.type === AST_NODE_TYPES.ExportDefaultDeclaration) {
+        return statement.declaration.type === AST_NODE_TYPES.Identifier ? [statement.declaration.name] : [];
+    }
+    if (statement.type !== AST_NODE_TYPES.ExportNamedDeclaration || statement.source !== null) {
+        return [];
+    }
+    return statement.specifiers.map((specifier) => specifier.local.name);
+}
+//# sourceMappingURL=exported-classes.js.map

package/dist/support/classes/exported-classes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exported-classes.js","sourceRoot":"","sources":["../../../src/support/classes/exported-classes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,kFAAkF;AAClF,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CACjC,cAAc,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,WAAW,EAAE,IAAI,KAAK,cAAc,CAAC,gBAAgB;QAC1F,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC;QACzB,CAAC,CAAC,EAAE,CACP,CACF,CAAC;IAEF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAExE,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,CACpC,CAAC,WAAW,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAC1F,CAAC;AACJ,CAAC;AAED,yHAAyH;AACzH,SAAS,kBAAkB,CAAC,SAAoC;IAC9D,IAAI,SAAS,CAAC,IAAI,KAAK,cAAc,CAAC,wBAAwB,EAAE,CAAC;QAC/D,OAAO,SAAS,CAAC,WAAW,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtG,CAAC;IAED,IAAI,SAAS,CAAC,IAAI,KAAK,cAAc,CAAC,sBAAsB,IAAI,SAAS,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC1F,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACvE,CAAC"}

package/dist/support/classes/is-callable.d.ts

@@ -0,0 +1,4 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+/** A method with a body, or a property holding a function: what a reader calls a method. */
+export declare function isCallable(member: TSESTree.ClassElement): member is TSESTree.MethodDefinition | TSESTree.PropertyDefinition;
+//# sourceMappingURL=is-callable.d.ts.map

package/dist/support/classes/is-callable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-callable.d.ts","sourceRoot":"","sources":["../../../src/support/classes/is-callable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGzE,4FAA4F;AAC5F,wBAAgB,UAAU,CACxB,MAAM,EAAE,QAAQ,CAAC,YAAY,GAC5B,MAAM,IAAI,QAAQ,CAAC,gBAAgB,GAAG,QAAQ,CAAC,kBAAkB,CAMnE"}

package/dist/support/classes/is-callable.js

@@ -0,0 +1,10 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { isFunction } from './is-function.js';
+/** A method with a body, or a property holding a function: what a reader calls a method. */
+export function isCallable(member) {
+    if (member.type === AST_NODE_TYPES.MethodDefinition) {
+        return member.kind !== 'constructor' && member.value.type === AST_NODE_TYPES.FunctionExpression;
+    }
+    return member.type === AST_NODE_TYPES.PropertyDefinition && member.value !== null && isFunction(member.value);
+}
+//# sourceMappingURL=is-callable.js.map

package/dist/support/classes/is-callable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-callable.js","sourceRoot":"","sources":["../../../src/support/classes/is-callable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,4FAA4F;AAC5F,MAAM,UAAU,UAAU,CACxB,MAA6B;IAE7B,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB,EAAE,CAAC;QACpD,OAAO,MAAM,CAAC,IAAI,KAAK,aAAa,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,kBAAkB,CAAC;IAClG,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,kBAAkB,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChH,CAAC"}

package/dist/support/classes/is-constructor.d.ts

@@ -0,0 +1,3 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+export declare function isConstructor(member: TSESTree.ClassElement): member is TSESTree.MethodDefinition;
+//# sourceMappingURL=is-constructor.d.ts.map

package/dist/support/classes/is-constructor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-constructor.d.ts","sourceRoot":"","sources":["../../../src/support/classes/is-constructor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzE,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,GAAG,MAAM,IAAI,QAAQ,CAAC,gBAAgB,CAEhG"}

package/dist/support/classes/is-constructor.js

@@ -0,0 +1,5 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+export function isConstructor(member) {
+    return member.type === AST_NODE_TYPES.MethodDefinition && member.kind === 'constructor';
+}
+//# sourceMappingURL=is-constructor.js.map

package/dist/support/classes/is-constructor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-constructor.js","sourceRoot":"","sources":["../../../src/support/classes/is-constructor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AAEzE,MAAM,UAAU,aAAa,CAAC,MAA6B;IACzD,OAAO,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,CAAC;AAC1F,CAAC"}

package/dist/support/classes/is-function.d.ts

@@ -0,0 +1,3 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+export declare function isFunction(node: TSESTree.Node): node is TSESTree.ArrowFunctionExpression | TSESTree.FunctionExpression;
+//# sourceMappingURL=is-function.d.ts.map

package/dist/support/classes/is-function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-function.d.ts","sourceRoot":"","sources":["../../../src/support/classes/is-function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzE,wBAAgB,UAAU,CACxB,IAAI,EAAE,QAAQ,CAAC,IAAI,GAClB,IAAI,IAAI,QAAQ,CAAC,uBAAuB,GAAG,QAAQ,CAAC,kBAAkB,CAExE"}

package/dist/support/classes/is-function.js

@@ -0,0 +1,5 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+export function isFunction(node) {
+    return node.type === AST_NODE_TYPES.ArrowFunctionExpression || node.type === AST_NODE_TYPES.FunctionExpression;
+}
+//# sourceMappingURL=is-function.js.map

package/dist/support/classes/is-function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-function.js","sourceRoot":"","sources":["../../../src/support/classes/is-function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AAEzE,MAAM,UAAU,UAAU,CACxB,IAAmB;IAEnB,OAAO,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,uBAAuB,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,kBAAkB,CAAC;AACjH,CAAC"}

package/dist/support/classes/is-inline-export.d.ts

@@ -0,0 +1,3 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+export declare function isInlineExport(statement: TSESTree.ProgramStatement): statement is TSESTree.ExportNamedDeclaration | TSESTree.ExportDefaultDeclaration;
+//# sourceMappingURL=is-inline-export.d.ts.map

package/dist/support/classes/is-inline-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-inline-export.d.ts","sourceRoot":"","sources":["../../../src/support/classes/is-inline-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzE,wBAAgB,cAAc,CAC5B,SAAS,EAAE,QAAQ,CAAC,gBAAgB,GACnC,SAAS,IAAI,QAAQ,CAAC,sBAAsB,GAAG,QAAQ,CAAC,wBAAwB,CAKlF"}

package/dist/support/classes/is-inline-export.js

@@ -0,0 +1,6 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+export function isInlineExport(statement) {
+    return (statement.type === AST_NODE_TYPES.ExportNamedDeclaration ||
+        statement.type === AST_NODE_TYPES.ExportDefaultDeclaration);
+}
+//# sourceMappingURL=is-inline-export.js.map

package/dist/support/classes/is-inline-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-inline-export.js","sourceRoot":"","sources":["../../../src/support/classes/is-inline-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AAEzE,MAAM,UAAU,cAAc,CAC5B,SAAoC;IAEpC,OAAO,CACL,SAAS,CAAC,IAAI,KAAK,cAAc,CAAC,sBAAsB;QACxD,SAAS,CAAC,IAAI,KAAK,cAAc,CAAC,wBAAwB,CAC3D,CAAC;AACJ,CAAC"}

package/dist/support/classes/is-keyed.d.ts

@@ -0,0 +1,5 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+type Keyed = TSESTree.MethodDefinition | TSESTree.PropertyDefinition | TSESTree.AccessorProperty | TSESTree.TSAbstractMethodDefinition | TSESTree.TSAbstractPropertyDefinition | TSESTree.TSAbstractAccessorProperty;
+export declare function isKeyed(member: TSESTree.ClassElement): member is Keyed;
+export {};
+//# sourceMappingURL=is-keyed.d.ts.map

package/dist/support/classes/is-keyed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-keyed.d.ts","sourceRoot":"","sources":["../../../src/support/classes/is-keyed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzE,KAAK,KAAK,GACN,QAAQ,CAAC,gBAAgB,GACzB,QAAQ,CAAC,kBAAkB,GAC3B,QAAQ,CAAC,gBAAgB,GACzB,QAAQ,CAAC,0BAA0B,GACnC,QAAQ,CAAC,4BAA4B,GACrC,QAAQ,CAAC,0BAA0B,CAAC;AAExC,wBAAgB,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,GAAG,MAAM,IAAI,KAAK,CAEtE"}

package/dist/support/classes/is-keyed.js

@@ -0,0 +1,5 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+export function isKeyed(member) {
+    return member.type !== AST_NODE_TYPES.StaticBlock && member.type !== AST_NODE_TYPES.TSIndexSignature;
+}
+//# sourceMappingURL=is-keyed.js.map

package/dist/support/classes/is-keyed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-keyed.js","sourceRoot":"","sources":["../../../src/support/classes/is-keyed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AAUzE,MAAM,UAAU,OAAO,CAAC,MAA6B;IACnD,OAAO,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB,CAAC;AACvG,CAAC"}

package/dist/support/classes/key-name.d.ts

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

package/dist/support/classes/key-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-name.d.ts","sourceRoot":"","sources":["../../../src/support/classes/key-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzE,wBAAgB,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,GAAG,MAAM,GAAG,SAAS,CAU9D"}

package/dist/support/classes/key-name.js

@@ -0,0 +1,11 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+export function keyName(key) {
+    if (key.type === AST_NODE_TYPES.PrivateIdentifier) {
+        return `#${key.name}`;
+    }
+    if (key.type === AST_NODE_TYPES.Identifier) {
+        return key.name;
+    }
+    return key.type === AST_NODE_TYPES.Literal && typeof key.value === 'string' ? key.value : undefined;
+}
+//# sourceMappingURL=key-name.js.map

package/dist/support/classes/key-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-name.js","sourceRoot":"","sources":["../../../src/support/classes/key-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AAEzE,MAAM,UAAU,OAAO,CAAC,GAAkB;IACxC,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,CAAC,iBAAiB,EAAE,CAAC;QAClD,OAAO,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU,EAAE,CAAC;QAC3C,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,OAAO,GAAG,CAAC,IAAI,KAAK,cAAc,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACtG,CAAC"}

package/dist/support/classes/member-name.d.ts

@@ -0,0 +1,4 @@
+import type { TSESTree } from '@typescript-eslint/utils';
+/** `#secret` keeps its hash, so a private name never collides with a public one. */
+export declare function memberName(member: TSESTree.ClassElement): string | undefined;
+//# sourceMappingURL=member-name.d.ts.map

package/dist/support/classes/member-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-name.d.ts","sourceRoot":"","sources":["../../../src/support/classes/member-name.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAIzD,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,GAAG,MAAM,GAAG,SAAS,CAE5E"}

package/dist/support/classes/member-name.js

@@ -0,0 +1,7 @@
+import { keyName } from './key-name.js';
+import { isKeyed } from './is-keyed.js';
+/** `#secret` keeps its hash, so a private name never collides with a public one. */
+export function memberName(member) {
+    return isKeyed(member) && !member.computed ? keyName(member.key) : undefined;
+}
+//# sourceMappingURL=member-name.js.map

package/dist/support/classes/member-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-name.js","sourceRoot":"","sources":["../../../src/support/classes/member-name.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,oFAAoF;AACpF,MAAM,UAAU,UAAU,CAAC,MAA6B;IACtD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/E,CAAC"}

package/dist/support/classes/top-level-classes.d.ts

@@ -0,0 +1,4 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+/** The classes declared at the top of a module, exported or not. */
+export declare function topLevelClasses(program: TSESTree.Program): TSESTree.ClassDeclaration[];
+//# sourceMappingURL=top-level-classes.d.ts.map

package/dist/support/classes/top-level-classes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"top-level-classes.d.ts","sourceRoot":"","sources":["../../../src/support/classes/top-level-classes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGzE,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,gBAAgB,EAAE,CAMtF"}

package/dist/support/classes/top-level-classes.js

@@ -0,0 +1,10 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { isInlineExport } from './is-inline-export.js';
+/** The classes declared at the top of a module, exported or not. */
+export function topLevelClasses(program) {
+    return program.body.flatMap((statement) => {
+        const declaration = isInlineExport(statement) ? statement.declaration : statement;
+        return declaration?.type === AST_NODE_TYPES.ClassDeclaration ? [declaration] : [];
+    });
+}
+//# sourceMappingURL=top-level-classes.js.map

package/dist/support/classes/top-level-classes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"top-level-classes.js","sourceRoot":"","sources":["../../../src/support/classes/top-level-classes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QACxC,MAAM,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;QAElF,OAAO,WAAW,EAAE,IAAI,KAAK,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/support/classes/visibility-of.d.ts

@@ -0,0 +1,4 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+export type Visibility = 'public' | 'protected' | 'private';
+export declare function visibilityOf(member: TSESTree.ClassElement): Visibility;
+//# sourceMappingURL=visibility-of.d.ts.map

package/dist/support/classes/visibility-of.d.ts.map

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

package/dist/support/classes/visibility-of.js

@@ -0,0 +1,12 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { isKeyed } from './is-keyed.js';
+export function visibilityOf(member) {
+    if (!isKeyed(member)) {
+        return 'public';
+    }
+    if (member.key.type === AST_NODE_TYPES.PrivateIdentifier) {
+        return 'private';
+    }
+    return member.accessibility ?? 'public';
+}
+//# sourceMappingURL=visibility-of.js.map

package/dist/support/classes/visibility-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility-of.js","sourceRoot":"","sources":["../../../src/support/classes/visibility-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAIxC,MAAM,UAAU,YAAY,CAAC,MAA6B;IACxD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,cAAc,CAAC,iBAAiB,EAAE,CAAC;QACzD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC,aAAa,IAAI,QAAQ,CAAC;AAC1C,CAAC"}

package/dist/support/comments/comment-lines.d.ts

@@ -0,0 +1,15 @@
+import { type TSESLint, type TSESTree } from '@typescript-eslint/utils';
+/** One line of comment text, whatever the comment syntax, with what the comment rules need to know. */
+export interface CommentLine {
+    readonly text: string;
+    readonly loc: TSESTree.SourceLocation;
+    readonly comment: TSESTree.Comment;
+    readonly block: boolean;
+    readonly jsdoc: boolean;
+    /** True when code precedes the comment on its line. */
+    readonly trailing: boolean;
+    /** Inside a JSDoc `@example` or a fenced block: code is expected there. */
+    readonly sample: boolean;
+}
+export declare function commentLines(sourceCode: Readonly<TSESLint.SourceCode>): CommentLine[];
+//# sourceMappingURL=comment-lines.d.ts.map

package/dist/support/comments/comment-lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-lines.d.ts","sourceRoot":"","sources":["../../../src/support/comments/comment-lines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAIzF,uGAAuG;AACvG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,cAAc,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,WAAW,EAAE,CAMrF"}

package/dist/support/comments/comment-lines.js

@@ -0,0 +1,47 @@
+import { AST_TOKEN_TYPES } from '@typescript-eslint/utils';
+import { sharesLineWithCode } from '../suppressions/shares-line-with-code.js';
+import { isJsdoc } from './is-jsdoc.js';
+export function commentLines(sourceCode) {
+    return sourceCode
+        .getAllComments()
+        .flatMap((comment) => comment.type === AST_TOKEN_TYPES.Line ? [lineOf(sourceCode, comment)] : blockLines(sourceCode, comment));
+}
+function lineOf(sourceCode, comment) {
+    return {
+        text: comment.value.trim(),
+        loc: comment.loc,
+        comment,
+        block: false,
+        jsdoc: false,
+        trailing: sharesLineWithCode(sourceCode, comment),
+        sample: false,
+    };
+}
+function blockLines(sourceCode, comment) {
+    const jsdoc = isJsdoc(comment);
+    let inExample = false;
+    let fenced = false;
+    return comment.value.split('\n').map((raw, index) => {
+        const text = raw.replace(/^\s*\*+ ?/, '').trim();
+        const fence = text.startsWith('```');
+        if (fence) {
+            fenced = !fenced;
+        }
+        else if (text.startsWith('@')) {
+            inExample = text.startsWith('@example');
+        }
+        return {
+            text,
+            loc: lineLocation(sourceCode, comment.loc.start.line + index),
+            comment,
+            block: true,
+            jsdoc,
+            trailing: false,
+            sample: inExample || fenced || fence,
+        };
+    });
+}
+function lineLocation(sourceCode, line) {
+    return { start: { line, column: 0 }, end: { line, column: sourceCode.lines[line - 1]?.length ?? 0 } };
+}
+//# sourceMappingURL=comment-lines.js.map

package/dist/support/comments/comment-lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-lines.js","sourceRoot":"","sources":["../../../src/support/comments/comment-lines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAgC,MAAM,0BAA0B,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAexC,MAAM,UAAU,YAAY,CAAC,UAAyC;IACpE,OAAO,UAAU;SACd,cAAc,EAAE;SAChB,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CACnB,OAAO,CAAC,IAAI,KAAK,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,CACxG,CAAC;AACN,CAAC;AAED,SAAS,MAAM,CAAC,UAAyC,EAAE,OAAyB;IAClF,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO;QACP,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC;QACjD,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,UAAyC,EAAE,OAAyB;IACtF,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAClD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAErC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,GAAG,CAAC,MAAM,CAAC;QACnB,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO;YACL,IAAI;YACJ,GAAG,EAAE,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC;YAC7D,OAAO;YACP,KAAK,EAAE,IAAI;YACX,KAAK;YACL,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,SAAS,IAAI,MAAM,IAAI,KAAK;SACrC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,UAAyC,EAAE,IAAY;IAC3E,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,EAAE,EAAE,CAAC;AACxG,CAAC"}

package/dist/support/comments/is-commented-out-code.d.ts

@@ -0,0 +1,6 @@
+import type { TSESLint } from '@typescript-eslint/utils';
+type Parser = TSESLint.Parser.LooseParserModule;
+/** True when the text reads as source code rather than as a sentence. */
+export declare function isCommentedOutCode(text: string, parser: Parser | undefined): boolean;
+export {};
+//# sourceMappingURL=is-commented-out-code.d.ts.map

package/dist/support/comments/is-commented-out-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-commented-out-code.d.ts","sourceRoot":"","sources":["../../../src/support/comments/is-commented-out-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAQzD,KAAK,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC;AAkDhD,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAiBpF"}

package/dist/support/comments/is-commented-out-code.js

@@ -0,0 +1,108 @@
+import { isRecord } from '../../project/is-record.js';
+import { PROSE_OPENING } from './prose-opening.js';
+import { isFragment } from './is-fragment.js';
+import { readsAsProse } from './reads-as-prose.js';
+const PARSE_OPTIONS = {
+    ecmaVersion: 'latest',
+    sourceType: 'module',
+    range: false,
+    loc: false,
+    comment: false,
+    tokens: false,
+};
+/** How a comment body is offered to the parser: as statements, as a function body, as class members. */
+const WRAPPERS = [
+    (text) => text,
+    (text) => `async function wrapper() {\n${text}\n}`,
+    (text) => `class Wrapper {\n${text}\n}`,
+];
+const STATEMENTS_THAT_ARE_CODE = new Set([
+    'FunctionDeclaration',
+    'ClassDeclaration',
+    'ImportDeclaration',
+    'ExportNamedDeclaration',
+    'ExportDefaultDeclaration',
+    'ExportAllDeclaration',
+    'TSTypeAliasDeclaration',
+    'TSInterfaceDeclaration',
+    'TSEnumDeclaration',
+    'TSModuleDeclaration',
+    'TSDeclareFunction',
+    'IfStatement',
+    'ForStatement',
+    'ForInStatement',
+    'ForOfStatement',
+    'WhileStatement',
+    'DoWhileStatement',
+    'SwitchStatement',
+    'TryStatement',
+]);
+const EXPRESSIONS_THAT_ACT = new Set(['CallExpression', 'AssignmentExpression', 'UpdateExpression', 'NewExpression']);
+const TRANSPARENT = new Set(['AwaitExpression', 'ChainExpression', 'TSNonNullExpression']);
+const CODE_CHARACTER = /[;(){}[\]=<>'"`]/;
+/** `timeout (ms)` parses as a call, yet nobody writes a call with a space before its parenthesis. */
+const PARENTHETICAL = /^(?!(?:if|for|while|switch|catch|return|await|function|typeof|new|throw|async|export|const|let|var)\b)[\w$.]+\s+\(/;
+/** True when the text reads as source code rather than as a sentence. */
+export function isCommentedOutCode(text, parser) {
+    const candidate = text.trim();
+    if (!CODE_CHARACTER.test(candidate) ||
+        PROSE_OPENING.test(candidate) ||
+        PARENTHETICAL.test(candidate) ||
+        readsAsProse(candidate)) {
+        return false;
+    }
+    if (parser === undefined) {
+        return isFragment(candidate);
+    }
+    return WRAPPERS.some((wrap, index) => statementsOf(parse(parser, wrap(candidate)), index > 0).some(isCode));
+}
+function parse(parser, text) {
+    try {
+        return 'parseForESLint' in parser
+            ? parser.parseForESLint(text, PARSE_OPTIONS).ast
+            : parser.parse(text, PARSE_OPTIONS);
+    }
+    catch {
+        return undefined;
+    }
+}
+function statementsOf(ast, wrapped) {
+    const body = nodes(isRecord(ast) ? ast['body'] : undefined);
+    if (!wrapped) {
+        return body;
+    }
+    const wrapper = body[0]?.['body'];
+    return nodes(isRecord(wrapper) ? wrapper['body'] : undefined);
+}
+function isCode(node) {
+    const type = typeof node['type'] === 'string' ? node['type'] : '';
+    return STATEMENTS_THAT_ARE_CODE.has(type) || (CONDITIONAL_CODE[type]?.(node) ?? false);
+}
+/** Statements that are code only in some shapes: `let go` and a lone `return` also read as English. */
+const CONDITIONAL_CODE = {
+    VariableDeclaration: (node) => nodes(node['declarations']).some((declarator) => isPresent(declarator['init']) || hasTypeAnnotation(declarator['id'])),
+    ReturnStatement: (node) => isPresent(node['argument']),
+    ThrowStatement: (node) => isPresent(node['argument']),
+    ExpressionStatement: (node) => acts(node['expression']),
+    MethodDefinition: (node) => isRecord(node['value']) && isPresent(node['value']['body']),
+    PropertyDefinition: (node) => isPresent(node['accessibility']) || node['static'] === true || node['readonly'] === true,
+};
+function acts(expression) {
+    if (!isRecord(expression) || typeof expression['type'] !== 'string') {
+        return false;
+    }
+    if (TRANSPARENT.has(expression['type'])) {
+        return acts(expression['argument'] ?? expression['expression']);
+    }
+    return EXPRESSIONS_THAT_ACT.has(expression['type']);
+}
+function hasTypeAnnotation(pattern) {
+    return isRecord(pattern) && isPresent(pattern['typeAnnotation']);
+}
+function nodes(value) {
+    return Array.isArray(value) ? value.filter(isRecord) : [];
+}
+function isPresent(value) {
+    return value !== undefined && value !== null;
+}
+//# sourceMappingURL=is-commented-out-code.js.map