@nfq/eslint-config 4.0.0-beta.10 → 4.0.0-beta.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/esm/rules/custom/component-file-structure.js +1 -1
- package/dist/esm/rules/custom/component-file-structure.js.map +1 -1
- package/dist/esm/rules/custom/no-unbound-method.js +60 -1
- package/dist/esm/rules/custom/no-unbound-method.js.map +1 -1
- package/dist/index.js +61 -2
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
|
@@ -144,7 +144,7 @@ const componentFileStructure = createRule$b({
|
|
|
144
144
|
if (isComponentExport(statement, componentName) || isDefaultComponentExport(statement, componentName)) {
|
|
145
145
|
return 6;
|
|
146
146
|
}
|
|
147
|
-
if (
|
|
147
|
+
if (isNonPropsTypeDeclaration(statement) && statement.range[0] < componentInfo.statement.range[0]) {
|
|
148
148
|
return 2;
|
|
149
149
|
}
|
|
150
150
|
if (isStyledDeclaration(statement) || isStyledFactoryDeclaration(statement) || isNonPropsTypeDeclaration(statement)) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"component-file-structure.js","sources":["../../../../src/rules/custom/component-file-structure.ts"],"sourcesContent":["import {ESLintUtils} from '@typescript-eslint/utils';\n\nimport {\n collectTypeReferences,\n getComponentInfoFromStatement,\n getTypeDeclarationInfo,\n isComponentExport,\n isDefaultComponentExport,\n isDisplayNameAssignment,\n isStyledDeclaration,\n isStyledFactoryDeclaration\n} from './utils/component-file-structure-utils';\n\nimport type {ComponentInfo} from './utils/component-file-structure-utils';\nimport type {TSESLint, TSESTree} from '@typescript-eslint/utils';\n\nconst createRule = ESLintUtils.RuleCreator(\n name => `https://github.com/nfqde/eslint-config-nfq/blob/master/docs/rules/${name}.md`\n);\n\ntype MessageIds = 'invalidOrder' | 'missingDisplayName' | 'missingNamedExport';\n\nconst ORDER_LABELS = [\n 'Imports',\n 'Optional declarations',\n 'Props types',\n 'Component',\n 'Component helpers and displayName',\n 'Exports',\n 'Styled components and local helper types'\n];\nconst ORDER_MESSAGE = ORDER_LABELS.join(' -> ');\n// eslint-disable-next-line jsdoc/require-jsdoc\nconst getSectionLabel = (section: number) => ORDER_LABELS[section - 1] ?? 'Unknown';\nconst PAGE_TYPE_NAMES = new Set([\n 'NextPage',\n 'NextPageWithLayout',\n 'NextSSRPage',\n 'NextSSRPageWithLayout',\n 'NextSSGPageWithLayout'\n]);\n\nexport const componentFileStructure = createRule<[], MessageIds>({\n defaultOptions: [],\n meta: {\n docs: {description: 'Enforce file structure order for React component files.'},\n messages: {\n // eslint-disable-next-line @stylistic/max-len\n invalidOrder: 'This file structure block is out of order. {{currentName}} is a {{current}} and should be before {{previousName}}. Expected order: {{order}}.',\n missingDisplayName: 'Component {{name}} must set displayName.',\n missingNamedExport: 'Component {{name}} must be exported by name.'\n },\n schema: [],\n type: 'suggestion'\n },\n name: 'component-file-structure',\n /**\n * Creates the rule listener for enforcing component file structure ordering. It analyzes the program body to\n * identify the primary component, its props types, and structural sections. It then reports ordering issues and\n * missing requirements like displayName or named exports.\n *\n * @param context The ESLint rule context used to access source code and report diagnostics.\n * @returns A rule listener that validates component file structure and reports issues.\n *\n * @example\n * ```tsx\n * // eslint-disable-next-line @nfq/component-file-structure\n * const listener = componentFileStructure.create(context);\n * ```\n */\n // eslint-disable-next-line max-lines-per-function\n create(context) {\n const {sourceCode} = context;\n const programBody = sourceCode.ast.body;\n const componentCandidates = programBody\n .filter((statement): statement is TSESTree.Statement => statement.type !== 'TSModuleDeclaration')\n .map(statement => getComponentInfoFromStatement(statement))\n .filter((info): info is ComponentInfo => Boolean(info));\n\n if (componentCandidates.length === 0) {\n return {};\n }\n\n const componentInfo = componentCandidates.sort(\n (left, right) => left.statement.range[0] - right.statement.range[0]\n )[0];\n const componentName = componentInfo.name;\n const typeDeclarations = new Map<string, TSESTree.Node>();\n\n for (const statement of programBody) {\n const info = getTypeDeclarationInfo(statement as TSESTree.Statement);\n\n if (info) {\n typeDeclarations.set(info.name, info.statement);\n }\n }\n\n const propsTypeNames = new Set<string>();\n const propsTypeRefs = new Set<string>();\n const propsTypeNode = componentInfo.propsTypeNode ?? null;\n /**\n * Determines whether the component uses a page-specific type alias. It inspects the component type node\n * and collects all referenced type names. It then checks if any of those names match known page types to\n * decide if the component is a page component.\n *\n * @returns True when the component type includes a known page type; otherwise false.\n *\n * @example\n * ```tsx\n * const isPage = isPageType();\n * ```\n */\n const isPageType = () => {\n const typeNode = componentInfo.componentTypeNode ?? null;\n\n if (!typeNode) {\n return false;\n }\n\n const typeRefs = new Set<string>();\n\n collectTypeReferences(typeNode, typeRefs);\n\n return Array.from(typeRefs).some(name => PAGE_TYPE_NAMES.has(name));\n };\n\n /**\n * Checks whether a statement assigns a page layout helper to the component. It ensures the statement is\n * an assignment expression targeting a member of the component identifier. It then verifies the member name\n * matches supported layout assignment properties.\n *\n * @param statement The statement to inspect for a layout assignment.\n * @returns True when the statement assigns a layout helper on the component; otherwise false.\n *\n * @example\n * ```tsx\n * const hasLayout = isPageLayoutAssignment(statement);\n * ```\n */\n const isPageLayoutAssignment = (statement: TSESTree.Statement) => {\n if (statement.type !== 'ExpressionStatement') {\n return false;\n }\n\n const {expression} = statement;\n\n if (expression.type !== 'AssignmentExpression') {\n return false;\n }\n\n const {left} = expression;\n\n if (left.type !== 'MemberExpression' || left.object.type !== 'Identifier') {\n return false;\n }\n\n if (left.object.name !== componentName || left.property.type !== 'Identifier') {\n return false;\n }\n\n return left.property.name === 'getLayout' || left.property.name === 'getLayoutKey';\n };\n\n const hasDefaultExport = programBody\n .some(statement => isDefaultComponentExport(statement as TSESTree.Statement, componentName));\n const hasLayoutAssignment = programBody\n .some(statement => isPageLayoutAssignment(statement as TSESTree.Statement));\n const isPageComponent = hasDefaultExport && (hasLayoutAssignment || isPageType());\n\n /**\n * Determines whether a class element represents a static displayName member. It checks that the element is a supported\n * property definition shape and that it is declared as static. It then verifies the identifier name matches the expected\n * displayName property, which signals a static display name assignment on a class.\n *\n * @returns True when the element is a static displayName property; otherwise false.\n *\n * @example\n * ```tsx\n * const isDisplayName = hasDisplayNameMember(member);\n * ```\n */\n const hasStaticDisplayName = () => {\n /**\n * Determines whether a class element represents a static displayName member. It checks that the element is a supported\n * property definition shape and that it is declared as static. It then verifies the identifier name matches the expected\n * displayName property, which signals a static display name assignment on a class.\n *\n * @param member The class element to inspect for a static displayName property.\n * @returns True when the element is a static displayName property; otherwise false.\n *\n * @example\n * ```tsx\n * const isDisplayName = hasDisplayNameMember(member);\n * ```\n */\n const hasDisplayNameMember = (member: TSESTree.ClassElement) => {\n // @ts-expect-error\n if (member.type !== 'PropertyDefinition' && member.type !== 'ClassProperty') {\n return false;\n }\n\n if (!member.static || member.key.type !== 'Identifier') {\n return false;\n }\n\n return member.key.name === 'displayName';\n };\n\n if (componentInfo.statement.type === 'ClassDeclaration') {\n return componentInfo.statement.id?.name === componentName\n && componentInfo.statement.body.body.some(hasDisplayNameMember);\n }\n\n if (componentInfo.statement.type === 'VariableDeclaration') {\n for (const declarator of componentInfo.statement.declarations) {\n if (declarator.id.type !== 'Identifier' || declarator.id.name !== componentName) {\n continue;\n }\n\n const {init} = declarator;\n\n if (init?.type === 'ClassExpression') {\n return init.body.body.some(hasDisplayNameMember);\n }\n }\n }\n\n return false;\n };\n\n if (propsTypeNode) {\n collectTypeReferences(propsTypeNode, propsTypeRefs);\n\n for (const name of propsTypeRefs) {\n if (typeDeclarations.has(name)) {\n propsTypeNames.add(name);\n }\n }\n }\n\n /**\n * Determines whether a statement declares a type that is used as the component props. It inspects the statement\n * for a type declaration and compares the declared name against the collected props type names. It returns a\n * boolean so callers can classify statements into the props type section.\n *\n * @param statement The statement to inspect for a props type declaration.\n * @returns True when the statement declares a props type; otherwise false.\n *\n * @example\n * ```tsx\n * const isProps = isPropsTypeDeclaration(statement);\n * ```\n */\n const isPropsTypeDeclaration = (statement: TSESTree.Statement) => {\n const info = getTypeDeclarationInfo(statement);\n\n return Boolean(info && propsTypeNames.has(info.name));\n };\n\n /**\n * Determines whether a statement declares a type that is not used as the component props. It inspects the\n * statement for a type declaration and ensures the declared name is not among the collected props type names.\n * It returns a boolean so callers can classify statements into non-props type sections.\n *\n * @param statement The statement to inspect for a non-props type declaration.\n * @returns True when the statement declares a non-props type; otherwise false.\n *\n * @example\n * ```tsx\n * const isNonProps = isNonPropsTypeDeclaration(statement);\n * ```\n */\n const isNonPropsTypeDeclaration = (statement: TSESTree.Statement) => {\n const info = getTypeDeclarationInfo(statement);\n\n return Boolean(info && !propsTypeNames.has(info.name));\n };\n\n /**\n * Determines whether a statement is an optional variable-like declaration in the component file structure. It\n * filters out the main component statement and styled declarations to avoid misclassification. It considers\n * variable declarations, non-component function declarations, and enum declarations as optional declarations.\n *\n * @param statement The statement to evaluate for optional declaration status.\n * @returns True when the statement should be treated as an optional declaration; otherwise false.\n *\n * @example\n * ```tsx\n * const isOptional = isOptionalVarDeclaration(statement);\n * ```\n */\n const isOptionalVarDeclaration = (statement: TSESTree.Statement) => {\n if (statement.type === 'VariableDeclaration') {\n if (\n statement === componentInfo.statement\n || isStyledDeclaration(statement)\n || isStyledFactoryDeclaration(statement)\n ) {\n return false;\n }\n\n return true;\n }\n\n if (statement.type === 'FunctionDeclaration') {\n return statement !== componentInfo.statement;\n }\n\n return statement.type === 'TSEnumDeclaration';\n };\n\n /**\n * Determines the structural section number for a given statement in a component file. It checks the statement\n * against known component structure elements like imports, the main component, displayName assignment, exports,\n * styled declarations, optional declarations, and props types. It returns a numeric section marker to help\n * enforce ordering rules or null when the statement does not belong to a tracked section.\n *\n * @param statement The statement to classify within the component file structure.\n * @returns The numeric section identifier for the statement, or null when it does not match a section.\n *\n * @example\n * ```tsx\n * const section = sectionForStatement(statement);\n * ```\n */\n const sectionForStatement = (statement: TSESTree.Statement) => {\n if (statement.type === 'ImportDeclaration') {\n return 1;\n }\n\n if (statement === componentInfo.statement) {\n // eslint-disable-next-line @nfq/no-magic-numbers\n return 4;\n }\n\n if (isDisplayNameAssignment(statement, componentName)) {\n // eslint-disable-next-line @nfq/no-magic-numbers\n return 5;\n }\n\n if (\n isComponentExport(statement, componentName)\n || isDefaultComponentExport(statement, componentName)\n ) {\n // eslint-disable-next-line @nfq/no-magic-numbers\n return 6;\n }\n\n if (\n isPageComponent\n && isNonPropsTypeDeclaration(statement)\n && statement.range[0] < componentInfo.statement.range[0]\n ) {\n // eslint-disable-next-line @nfq/no-magic-numbers\n return 2;\n }\n\n if (\n isStyledDeclaration(statement)\n || isStyledFactoryDeclaration(statement)\n || isNonPropsTypeDeclaration(statement)\n ) {\n // eslint-disable-next-line @nfq/no-magic-numbers\n return 7;\n }\n\n if (isOptionalVarDeclaration(statement)) {\n if (statement.range[0] > componentInfo.statement.range[0]) {\n // eslint-disable-next-line @nfq/no-magic-numbers\n return 5;\n }\n\n // eslint-disable-next-line @nfq/no-magic-numbers\n return 2;\n }\n\n if (isPropsTypeDeclaration(statement)) {\n // eslint-disable-next-line @nfq/no-magic-numbers\n return 3;\n }\n\n return null;\n };\n\n /**\n * Determines a human-readable label for a statement within the component file structure. It inspects the statement\n * type and section to produce a meaningful name for reporting order violations. It also handles special cases like\n * displayName assignments and exports so diagnostics are clear and actionable.\n *\n * @param statement The statement to derive a label for.\n * @param section The section number associated with the statement.\n * @returns A descriptive name for the statement within its section.\n *\n * @example\n * ```tsx\n * const name = getStatementName(statement, 4);\n * ```\n */\n const getStatementName = (statement: TSESTree.Statement, section: number) => {\n // eslint-disable-next-line @nfq/no-magic-numbers\n if (section === 4) {\n return componentName;\n }\n\n // eslint-disable-next-line @nfq/no-magic-numbers\n if (section === 5 && isDisplayNameAssignment(statement, componentName)) {\n return `${componentName}.displayName`;\n }\n\n if (statement.type === 'VariableDeclaration') {\n const first = statement.declarations[0];\n\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n if (first?.id.type === 'Identifier') {\n return first.id.name;\n }\n }\n\n if (statement.type === 'FunctionDeclaration' || statement.type === 'ClassDeclaration') {\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n return statement.id?.name ?? getSectionLabel(section);\n }\n\n if (statement.type === 'ExportDefaultDeclaration') {\n const {declaration} = statement;\n\n if (declaration.type === 'Identifier') {\n return `export default ${declaration.name}`;\n }\n\n if (declaration.type === 'ClassDeclaration' || declaration.type === 'FunctionDeclaration') {\n if (declaration.id?.name) {\n return `export default ${declaration.id.name}`;\n }\n }\n\n return 'export default';\n }\n\n if (statement.type === 'ExportNamedDeclaration') {\n const names = statement.specifiers\n .filter(specifier => specifier.local.type === 'Identifier')\n // @ts-expect-error\n .map(specifier => specifier.local.name as string);\n\n if (names.length === 1) {\n return `export {${names[0]}}`;\n }\n\n if (names.length > 1) {\n return 'export {...}';\n }\n }\n\n return getSectionLabel(section);\n };\n\n return {\n /**\n * Iterates over the program body statements to validate their order based on the defined component file structure. It\n * tracks the last seen section and reports any statement that appears in an earlier section than the last one. It also checks\n * for the presence of a displayName assignment and a named export for the component, reporting if either is missing.\n * This ensures that the component file adheres to the expected structure and includes necessary metadata for better maintainability and clarity.\n *\n * @example\n * ```tsx\n * Program();\n * ```\n */\n Program() {\n let lastSection = 0;\n let lastSectionName = '';\n let hasDisplayName = hasStaticDisplayName();\n let hasNamedExport = false;\n\n for (const statement of programBody) {\n const section = sectionForStatement(statement as TSESTree.Statement);\n\n // eslint-disable-next-line @nfq/no-magic-numbers\n if (section === 5) {\n hasDisplayName = true;\n }\n\n // eslint-disable-next-line @nfq/no-magic-numbers\n if (section === 6) {\n hasNamedExport = true;\n }\n\n if (!section) {\n continue;\n }\n\n if (section < lastSection) {\n context.report({\n data: {\n current: getSectionLabel(section),\n currentName: getStatementName(statement as TSESTree.Statement, section),\n order: ORDER_MESSAGE,\n previous: getSectionLabel(lastSection),\n previousName: lastSectionName || getSectionLabel(lastSection)\n },\n messageId: 'invalidOrder',\n node: statement\n });\n } else {\n lastSection = section;\n lastSectionName = getStatementName(statement as TSESTree.Statement, section);\n }\n }\n\n if (!hasDisplayName && !isPageComponent) {\n context.report({\n data: {name: componentName},\n messageId: 'missingDisplayName',\n node: componentInfo.statement\n });\n }\n\n if (!hasNamedExport && !isPageComponent) {\n context.report({\n data: {name: componentName},\n messageId: 'missingNamedExport',\n node: componentInfo.statement\n });\n }\n }\n } as TSESLint.RuleListener;\n }\n});"],"names":["createRule","ESLintUtils","RuleCreator","name","ORDER_LABELS","ORDER_MESSAGE","join","getSectionLabel","section","PAGE_TYPE_NAMES","Set","componentFileStructure","defaultOptions","meta","docs","description","messages","invalidOrder","missingDisplayName","missingNamedExport","schema","type","create","context","sourceCode","programBody","ast","body","componentCandidates","filter","statement","map","getComponentInfoFromStatement","info","Boolean","length","componentInfo","sort","left","right","range","componentName","typeDeclarations","Map","getTypeDeclarationInfo","set","propsTypeNames","propsTypeRefs","propsTypeNode","isPageType","typeNode","componentTypeNode","typeRefs","collectTypeReferences","Array","from","some","has","isPageLayoutAssignment","expression","object","property","hasDefaultExport","isDefaultComponentExport","hasLayoutAssignment","isPageComponent","hasStaticDisplayName","hasDisplayNameMember","member","static","key","id","declarator","declarations","init","add","isPropsTypeDeclaration","isNonPropsTypeDeclaration","isOptionalVarDeclaration","isStyledDeclaration","isStyledFactoryDeclaration","sectionForStatement","isDisplayNameAssignment","isComponentExport","getStatementName","first","declaration","names","specifiers","specifier","local","Program","lastSection","lastSectionName","hasDisplayName","hasNamedExport","report","data","current","currentName","order","previous","previousName","messageId","node"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"component-file-structure.js","sources":["../../../../src/rules/custom/component-file-structure.ts"],"sourcesContent":["import {ESLintUtils} from '@typescript-eslint/utils';\n\nimport {\n collectTypeReferences,\n getComponentInfoFromStatement,\n getTypeDeclarationInfo,\n isComponentExport,\n isDefaultComponentExport,\n isDisplayNameAssignment,\n isStyledDeclaration,\n isStyledFactoryDeclaration\n} from './utils/component-file-structure-utils';\n\nimport type {ComponentInfo} from './utils/component-file-structure-utils';\nimport type {TSESLint, TSESTree} from '@typescript-eslint/utils';\n\nconst createRule = ESLintUtils.RuleCreator(\n name => `https://github.com/nfqde/eslint-config-nfq/blob/master/docs/rules/${name}.md`\n);\n\ntype MessageIds = 'invalidOrder' | 'missingDisplayName' | 'missingNamedExport';\n\nconst ORDER_LABELS = [\n 'Imports',\n 'Optional declarations',\n 'Props types',\n 'Component',\n 'Component helpers and displayName',\n 'Exports',\n 'Styled components and local helper types'\n];\nconst ORDER_MESSAGE = ORDER_LABELS.join(' -> ');\n// eslint-disable-next-line jsdoc/require-jsdoc\nconst getSectionLabel = (section: number) => ORDER_LABELS[section - 1] ?? 'Unknown';\nconst PAGE_TYPE_NAMES = new Set([\n 'NextPage',\n 'NextPageWithLayout',\n 'NextSSRPage',\n 'NextSSRPageWithLayout',\n 'NextSSGPageWithLayout'\n]);\n\nexport const componentFileStructure = createRule<[], MessageIds>({\n defaultOptions: [],\n meta: {\n docs: {description: 'Enforce file structure order for React component files.'},\n messages: {\n // eslint-disable-next-line @stylistic/max-len\n invalidOrder: 'This file structure block is out of order. {{currentName}} is a {{current}} and should be before {{previousName}}. Expected order: {{order}}.',\n missingDisplayName: 'Component {{name}} must set displayName.',\n missingNamedExport: 'Component {{name}} must be exported by name.'\n },\n schema: [],\n type: 'suggestion'\n },\n name: 'component-file-structure',\n /**\n * Creates the rule listener for enforcing component file structure ordering. It analyzes the program body to\n * identify the primary component, its props types, and structural sections. It then reports ordering issues and\n * missing requirements like displayName or named exports.\n *\n * @param context The ESLint rule context used to access source code and report diagnostics.\n * @returns A rule listener that validates component file structure and reports issues.\n *\n * @example\n * ```tsx\n * // eslint-disable-next-line @nfq/component-file-structure\n * const listener = componentFileStructure.create(context);\n * ```\n */\n // eslint-disable-next-line max-lines-per-function\n create(context) {\n const {sourceCode} = context;\n const programBody = sourceCode.ast.body;\n const componentCandidates = programBody\n .filter((statement): statement is TSESTree.Statement => statement.type !== 'TSModuleDeclaration')\n .map(statement => getComponentInfoFromStatement(statement))\n .filter((info): info is ComponentInfo => Boolean(info));\n\n if (componentCandidates.length === 0) {\n return {};\n }\n\n const componentInfo = componentCandidates.sort(\n (left, right) => left.statement.range[0] - right.statement.range[0]\n )[0];\n const componentName = componentInfo.name;\n const typeDeclarations = new Map<string, TSESTree.Node>();\n\n for (const statement of programBody) {\n const info = getTypeDeclarationInfo(statement as TSESTree.Statement);\n\n if (info) {\n typeDeclarations.set(info.name, info.statement);\n }\n }\n\n const propsTypeNames = new Set<string>();\n const propsTypeRefs = new Set<string>();\n const propsTypeNode = componentInfo.propsTypeNode ?? null;\n /**\n * Determines whether the component uses a page-specific type alias. It inspects the component type node\n * and collects all referenced type names. It then checks if any of those names match known page types to\n * decide if the component is a page component.\n *\n * @returns True when the component type includes a known page type; otherwise false.\n *\n * @example\n * ```tsx\n * const isPage = isPageType();\n * ```\n */\n const isPageType = () => {\n const typeNode = componentInfo.componentTypeNode ?? null;\n\n if (!typeNode) {\n return false;\n }\n\n const typeRefs = new Set<string>();\n\n collectTypeReferences(typeNode, typeRefs);\n\n return Array.from(typeRefs).some(name => PAGE_TYPE_NAMES.has(name));\n };\n\n /**\n * Checks whether a statement assigns a page layout helper to the component. It ensures the statement is\n * an assignment expression targeting a member of the component identifier. It then verifies the member name\n * matches supported layout assignment properties.\n *\n * @param statement The statement to inspect for a layout assignment.\n * @returns True when the statement assigns a layout helper on the component; otherwise false.\n *\n * @example\n * ```tsx\n * const hasLayout = isPageLayoutAssignment(statement);\n * ```\n */\n const isPageLayoutAssignment = (statement: TSESTree.Statement) => {\n if (statement.type !== 'ExpressionStatement') {\n return false;\n }\n\n const {expression} = statement;\n\n if (expression.type !== 'AssignmentExpression') {\n return false;\n }\n\n const {left} = expression;\n\n if (left.type !== 'MemberExpression' || left.object.type !== 'Identifier') {\n return false;\n }\n\n if (left.object.name !== componentName || left.property.type !== 'Identifier') {\n return false;\n }\n\n return left.property.name === 'getLayout' || left.property.name === 'getLayoutKey';\n };\n\n const hasDefaultExport = programBody\n .some(statement => isDefaultComponentExport(statement as TSESTree.Statement, componentName));\n const hasLayoutAssignment = programBody\n .some(statement => isPageLayoutAssignment(statement as TSESTree.Statement));\n const isPageComponent = hasDefaultExport && (hasLayoutAssignment || isPageType());\n\n /**\n * Determines whether a class element represents a static displayName member. It checks that the element is a supported\n * property definition shape and that it is declared as static. It then verifies the identifier name matches the expected\n * displayName property, which signals a static display name assignment on a class.\n *\n * @returns True when the element is a static displayName property; otherwise false.\n *\n * @example\n * ```tsx\n * const isDisplayName = hasDisplayNameMember(member);\n * ```\n */\n const hasStaticDisplayName = () => {\n /**\n * Determines whether a class element represents a static displayName member. It checks that the element is a supported\n * property definition shape and that it is declared as static. It then verifies the identifier name matches the expected\n * displayName property, which signals a static display name assignment on a class.\n *\n * @param member The class element to inspect for a static displayName property.\n * @returns True when the element is a static displayName property; otherwise false.\n *\n * @example\n * ```tsx\n * const isDisplayName = hasDisplayNameMember(member);\n * ```\n */\n const hasDisplayNameMember = (member: TSESTree.ClassElement) => {\n // @ts-expect-error\n if (member.type !== 'PropertyDefinition' && member.type !== 'ClassProperty') {\n return false;\n }\n\n if (!member.static || member.key.type !== 'Identifier') {\n return false;\n }\n\n return member.key.name === 'displayName';\n };\n\n if (componentInfo.statement.type === 'ClassDeclaration') {\n return componentInfo.statement.id?.name === componentName\n && componentInfo.statement.body.body.some(hasDisplayNameMember);\n }\n\n if (componentInfo.statement.type === 'VariableDeclaration') {\n for (const declarator of componentInfo.statement.declarations) {\n if (declarator.id.type !== 'Identifier' || declarator.id.name !== componentName) {\n continue;\n }\n\n const {init} = declarator;\n\n if (init?.type === 'ClassExpression') {\n return init.body.body.some(hasDisplayNameMember);\n }\n }\n }\n\n return false;\n };\n\n if (propsTypeNode) {\n collectTypeReferences(propsTypeNode, propsTypeRefs);\n\n for (const name of propsTypeRefs) {\n if (typeDeclarations.has(name)) {\n propsTypeNames.add(name);\n }\n }\n }\n\n /**\n * Determines whether a statement declares a type that is used as the component props. It inspects the statement\n * for a type declaration and compares the declared name against the collected props type names. It returns a\n * boolean so callers can classify statements into the props type section.\n *\n * @param statement The statement to inspect for a props type declaration.\n * @returns True when the statement declares a props type; otherwise false.\n *\n * @example\n * ```tsx\n * const isProps = isPropsTypeDeclaration(statement);\n * ```\n */\n const isPropsTypeDeclaration = (statement: TSESTree.Statement) => {\n const info = getTypeDeclarationInfo(statement);\n\n return Boolean(info && propsTypeNames.has(info.name));\n };\n\n /**\n * Determines whether a statement declares a type that is not used as the component props. It inspects the\n * statement for a type declaration and ensures the declared name is not among the collected props type names.\n * It returns a boolean so callers can classify statements into non-props type sections.\n *\n * @param statement The statement to inspect for a non-props type declaration.\n * @returns True when the statement declares a non-props type; otherwise false.\n *\n * @example\n * ```tsx\n * const isNonProps = isNonPropsTypeDeclaration(statement);\n * ```\n */\n const isNonPropsTypeDeclaration = (statement: TSESTree.Statement) => {\n const info = getTypeDeclarationInfo(statement);\n\n return Boolean(info && !propsTypeNames.has(info.name));\n };\n\n /**\n * Determines whether a statement is an optional variable-like declaration in the component file structure. It\n * filters out the main component statement and styled declarations to avoid misclassification. It considers\n * variable declarations, non-component function declarations, and enum declarations as optional declarations.\n *\n * @param statement The statement to evaluate for optional declaration status.\n * @returns True when the statement should be treated as an optional declaration; otherwise false.\n *\n * @example\n * ```tsx\n * const isOptional = isOptionalVarDeclaration(statement);\n * ```\n */\n const isOptionalVarDeclaration = (statement: TSESTree.Statement) => {\n if (statement.type === 'VariableDeclaration') {\n if (\n statement === componentInfo.statement\n || isStyledDeclaration(statement)\n || isStyledFactoryDeclaration(statement)\n ) {\n return false;\n }\n\n return true;\n }\n\n if (statement.type === 'FunctionDeclaration') {\n return statement !== componentInfo.statement;\n }\n\n return statement.type === 'TSEnumDeclaration';\n };\n\n /**\n * Determines the structural section number for a given statement in a component file. It checks the statement\n * against known component structure elements like imports, the main component, displayName assignment, exports,\n * styled declarations, optional declarations, and props types. It returns a numeric section marker to help\n * enforce ordering rules or null when the statement does not belong to a tracked section.\n *\n * @param statement The statement to classify within the component file structure.\n * @returns The numeric section identifier for the statement, or null when it does not match a section.\n *\n * @example\n * ```tsx\n * const section = sectionForStatement(statement);\n * ```\n */\n const sectionForStatement = (statement: TSESTree.Statement) => {\n if (statement.type === 'ImportDeclaration') {\n return 1;\n }\n\n if (statement === componentInfo.statement) {\n // eslint-disable-next-line @nfq/no-magic-numbers\n return 4;\n }\n\n if (isDisplayNameAssignment(statement, componentName)) {\n // eslint-disable-next-line @nfq/no-magic-numbers\n return 5;\n }\n\n if (\n isComponentExport(statement, componentName)\n || isDefaultComponentExport(statement, componentName)\n ) {\n // eslint-disable-next-line @nfq/no-magic-numbers\n return 6;\n }\n\n if (\n isNonPropsTypeDeclaration(statement)\n && statement.range[0] < componentInfo.statement.range[0]\n ) {\n // eslint-disable-next-line @nfq/no-magic-numbers\n return 2;\n }\n\n if (\n isStyledDeclaration(statement)\n || isStyledFactoryDeclaration(statement)\n || isNonPropsTypeDeclaration(statement)\n ) {\n // eslint-disable-next-line @nfq/no-magic-numbers\n return 7;\n }\n\n if (isOptionalVarDeclaration(statement)) {\n if (statement.range[0] > componentInfo.statement.range[0]) {\n // eslint-disable-next-line @nfq/no-magic-numbers\n return 5;\n }\n\n // eslint-disable-next-line @nfq/no-magic-numbers\n return 2;\n }\n\n if (isPropsTypeDeclaration(statement)) {\n // eslint-disable-next-line @nfq/no-magic-numbers\n return 3;\n }\n\n return null;\n };\n\n /**\n * Determines a human-readable label for a statement within the component file structure. It inspects the statement\n * type and section to produce a meaningful name for reporting order violations. It also handles special cases like\n * displayName assignments and exports so diagnostics are clear and actionable.\n *\n * @param statement The statement to derive a label for.\n * @param section The section number associated with the statement.\n * @returns A descriptive name for the statement within its section.\n *\n * @example\n * ```tsx\n * const name = getStatementName(statement, 4);\n * ```\n */\n const getStatementName = (statement: TSESTree.Statement, section: number) => {\n // eslint-disable-next-line @nfq/no-magic-numbers\n if (section === 4) {\n return componentName;\n }\n\n // eslint-disable-next-line @nfq/no-magic-numbers\n if (section === 5 && isDisplayNameAssignment(statement, componentName)) {\n return `${componentName}.displayName`;\n }\n\n if (statement.type === 'VariableDeclaration') {\n const first = statement.declarations[0];\n\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n if (first?.id.type === 'Identifier') {\n return first.id.name;\n }\n }\n\n if (statement.type === 'FunctionDeclaration' || statement.type === 'ClassDeclaration') {\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n return statement.id?.name ?? getSectionLabel(section);\n }\n\n if (statement.type === 'ExportDefaultDeclaration') {\n const {declaration} = statement;\n\n if (declaration.type === 'Identifier') {\n return `export default ${declaration.name}`;\n }\n\n if (declaration.type === 'ClassDeclaration' || declaration.type === 'FunctionDeclaration') {\n if (declaration.id?.name) {\n return `export default ${declaration.id.name}`;\n }\n }\n\n return 'export default';\n }\n\n if (statement.type === 'ExportNamedDeclaration') {\n const names = statement.specifiers\n .filter(specifier => specifier.local.type === 'Identifier')\n // @ts-expect-error\n .map(specifier => specifier.local.name as string);\n\n if (names.length === 1) {\n return `export {${names[0]}}`;\n }\n\n if (names.length > 1) {\n return 'export {...}';\n }\n }\n\n return getSectionLabel(section);\n };\n\n return {\n /**\n * Iterates over the program body statements to validate their order based on the defined component file structure. It\n * tracks the last seen section and reports any statement that appears in an earlier section than the last one. It also checks\n * for the presence of a displayName assignment and a named export for the component, reporting if either is missing.\n * This ensures that the component file adheres to the expected structure and includes necessary metadata for better maintainability and clarity.\n *\n * @example\n * ```tsx\n * Program();\n * ```\n */\n Program() {\n let lastSection = 0;\n let lastSectionName = '';\n let hasDisplayName = hasStaticDisplayName();\n let hasNamedExport = false;\n\n for (const statement of programBody) {\n const section = sectionForStatement(statement as TSESTree.Statement);\n\n // eslint-disable-next-line @nfq/no-magic-numbers\n if (section === 5) {\n hasDisplayName = true;\n }\n\n // eslint-disable-next-line @nfq/no-magic-numbers\n if (section === 6) {\n hasNamedExport = true;\n }\n\n if (!section) {\n continue;\n }\n\n if (section < lastSection) {\n context.report({\n data: {\n current: getSectionLabel(section),\n currentName: getStatementName(statement as TSESTree.Statement, section),\n order: ORDER_MESSAGE,\n previous: getSectionLabel(lastSection),\n previousName: lastSectionName || getSectionLabel(lastSection)\n },\n messageId: 'invalidOrder',\n node: statement\n });\n } else {\n lastSection = section;\n lastSectionName = getStatementName(statement as TSESTree.Statement, section);\n }\n }\n\n if (!hasDisplayName && !isPageComponent) {\n context.report({\n data: {name: componentName},\n messageId: 'missingDisplayName',\n node: componentInfo.statement\n });\n }\n\n if (!hasNamedExport && !isPageComponent) {\n context.report({\n data: {name: componentName},\n messageId: 'missingNamedExport',\n node: componentInfo.statement\n });\n }\n }\n } as TSESLint.RuleListener;\n }\n});"],"names":["createRule","ESLintUtils","RuleCreator","name","ORDER_LABELS","ORDER_MESSAGE","join","getSectionLabel","section","PAGE_TYPE_NAMES","Set","componentFileStructure","defaultOptions","meta","docs","description","messages","invalidOrder","missingDisplayName","missingNamedExport","schema","type","create","context","sourceCode","programBody","ast","body","componentCandidates","filter","statement","map","getComponentInfoFromStatement","info","Boolean","length","componentInfo","sort","left","right","range","componentName","typeDeclarations","Map","getTypeDeclarationInfo","set","propsTypeNames","propsTypeRefs","propsTypeNode","isPageType","typeNode","componentTypeNode","typeRefs","collectTypeReferences","Array","from","some","has","isPageLayoutAssignment","expression","object","property","hasDefaultExport","isDefaultComponentExport","hasLayoutAssignment","isPageComponent","hasStaticDisplayName","hasDisplayNameMember","member","static","key","id","declarator","declarations","init","add","isPropsTypeDeclaration","isNonPropsTypeDeclaration","isOptionalVarDeclaration","isStyledDeclaration","isStyledFactoryDeclaration","sectionForStatement","isDisplayNameAssignment","isComponentExport","getStatementName","first","declaration","names","specifiers","specifier","local","Program","lastSection","lastSectionName","hasDisplayName","hasNamedExport","report","data","current","currentName","order","previous","previousName","messageId","node"],"mappings":"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"}
|
|
@@ -40,6 +40,64 @@ const noUnboundMethod = createRule$4({
|
|
|
40
40
|
const reportCache = new Map();
|
|
41
41
|
const aliasCache = new Map();
|
|
42
42
|
const memberSymbolCache = new Map();
|
|
43
|
+
const classAutoBindCache = new WeakMap();
|
|
44
|
+
const isAutoBindOption = node => {
|
|
45
|
+
if (!ts.isObjectLiteralExpression(node)) {
|
|
46
|
+
return false;
|
|
47
|
+
}
|
|
48
|
+
return node.properties.some(property => {
|
|
49
|
+
if (!ts.isPropertyAssignment(property)) {
|
|
50
|
+
return false;
|
|
51
|
+
}
|
|
52
|
+
const name = ts.isIdentifier(property.name) ? property.name.text : ts.isStringLiteral(property.name) ? property.name.text : null;
|
|
53
|
+
if (name !== 'autoBind') {
|
|
54
|
+
return false;
|
|
55
|
+
}
|
|
56
|
+
return property.initializer.kind === ts.SyntaxKind.TrueKeyword;
|
|
57
|
+
});
|
|
58
|
+
};
|
|
59
|
+
const isMakeAutoObservableCallee = node => {
|
|
60
|
+
if (ts.isIdentifier(node)) {
|
|
61
|
+
return node.text === 'makeAutoObservable';
|
|
62
|
+
}
|
|
63
|
+
return ts.isPropertyAccessExpression(node) && node.name.text === 'makeAutoObservable';
|
|
64
|
+
};
|
|
65
|
+
const hasAutoBindInConstructor = classDecl => {
|
|
66
|
+
const cached = classAutoBindCache.get(classDecl);
|
|
67
|
+
if (cached !== undefined) {
|
|
68
|
+
return cached;
|
|
69
|
+
}
|
|
70
|
+
const ctor = classDecl.members.find(member => ts.isConstructorDeclaration(member));
|
|
71
|
+
if (!ctor?.body) {
|
|
72
|
+
classAutoBindCache.set(classDecl, false);
|
|
73
|
+
return false;
|
|
74
|
+
}
|
|
75
|
+
for (const statement of ctor.body.statements) {
|
|
76
|
+
if (!ts.isExpressionStatement(statement)) {
|
|
77
|
+
continue;
|
|
78
|
+
}
|
|
79
|
+
const expr = statement.expression;
|
|
80
|
+
if (!ts.isCallExpression(expr)) {
|
|
81
|
+
continue;
|
|
82
|
+
}
|
|
83
|
+
if (!isMakeAutoObservableCallee(expr.expression)) {
|
|
84
|
+
continue;
|
|
85
|
+
}
|
|
86
|
+
if (expr.arguments.length < 2) {
|
|
87
|
+
continue;
|
|
88
|
+
}
|
|
89
|
+
if (expr.arguments[0].kind !== ts.SyntaxKind.ThisKeyword) {
|
|
90
|
+
continue;
|
|
91
|
+
}
|
|
92
|
+
const hasAutoBind = expr.arguments.slice(1).some(arg => isAutoBindOption(arg));
|
|
93
|
+
if (hasAutoBind) {
|
|
94
|
+
classAutoBindCache.set(classDecl, true);
|
|
95
|
+
return true;
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
classAutoBindCache.set(classDecl, false);
|
|
99
|
+
return false;
|
|
100
|
+
};
|
|
43
101
|
const resolveSymbol = symbol => {
|
|
44
102
|
const cached = aliasCache.get(symbol);
|
|
45
103
|
if (cached) {
|
|
@@ -74,6 +132,7 @@ const noUnboundMethod = createRule$4({
|
|
|
74
132
|
return Boolean(name && decoratorNames.has(name));
|
|
75
133
|
}));
|
|
76
134
|
const info = {
|
|
135
|
+
autoBind: hasAutoBindInConstructor(methodDecl.parent),
|
|
77
136
|
hasDecorator,
|
|
78
137
|
isStatic,
|
|
79
138
|
usesThis: methodUsesThis(methodDecl)
|
|
@@ -92,7 +151,7 @@ const noUnboundMethod = createRule$4({
|
|
|
92
151
|
reportCache.set(aliased, false);
|
|
93
152
|
return false;
|
|
94
153
|
}
|
|
95
|
-
const shouldReport = !info.isStatic && info.usesThis && !info.hasDecorator;
|
|
154
|
+
const shouldReport = !info.autoBind && !info.isStatic && info.usesThis && !info.hasDecorator;
|
|
96
155
|
reportCache.set(aliased, shouldReport);
|
|
97
156
|
return shouldReport;
|
|
98
157
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"no-unbound-method.js","sources":["../../../../src/rules/custom/no-unbound-method.ts"],"sourcesContent":["import {AST_NODE_TYPES, ESLintUtils} from '@typescript-eslint/utils';\nimport ts from 'typescript';\n\nimport {\n DEFAULT_DECORATORS,\n getDecoratorName,\n isCallbackUsage,\n isThisBindCall,\n methodUsesThis,\n normalizeDecoratorNames,\n unwrapExpression\n} from './utils/no-unbound-method-utils';\n\nimport type {TSESLint, TSESTree} from '@typescript-eslint/utils';\n\nconst createRule = ESLintUtils.RuleCreator(\n name => `https://github.com/nfqde/eslint-config-nfq/blob/master/docs/rules/${name}.md`\n);\n\ntype RuleOptions = [\n {decoratorNames?: string[]}?\n];\n\ntype MessageIds = 'constructorBind' | 'unboundMethod';\n\ntype MethodInfo = {\n hasDecorator: boolean;\n isStatic: boolean;\n usesThis: boolean;\n};\n\nexport const noUnboundMethod = createRule<RuleOptions, MessageIds>({\n defaultOptions: [{decoratorNames: DEFAULT_DECORATORS}],\n meta: {\n docs: {description: 'Warn when unbound class methods that use this are passed as callbacks.'},\n messages: {\n constructorBind: 'Do not bind in the constructor; prefer {{decoratorName}}.',\n unboundMethod: 'Method {{methodName}} uses this and is passed unbound. Add {{decoratorName}} or bind it.'\n },\n schema: [\n {\n additionalProperties: false,\n properties: {\n decoratorNames: {\n items: {type: 'string'},\n type: 'array',\n uniqueItems: true\n }\n },\n type: 'object'\n }\n ],\n type: 'problem'\n },\n name: 'no-unbound-method',\n /**\n * Creates the rule listeners and initializes caches for symbol analysis.\n * It wires the parser services to the TypeScript type checker and configures decorator handling.\n * It returns ESLint listeners that report unbound method usage in callbacks and constructor binding.\n *\n * @param context Rule context used to access parser services and report issues.\n * @returns The rule listener map for this rule.\n *\n * @example\n * ```tsx\n * const listeners = rule.create(context);\n * ```\n */\n create(context) {\n const services = ESLintUtils.getParserServices(context);\n const checker = services.program.getTypeChecker();\n const decoratorNames = normalizeDecoratorNames(context.options[0]?.decoratorNames);\n const decoratorLabel = `@${Array.from(decoratorNames)[0] ?? 'autobind'}`;\n const methodCache = new Map<ts.Symbol, MethodInfo>();\n const reportCache = new Map<ts.Symbol, boolean>();\n const aliasCache = new Map<ts.Symbol, ts.Symbol>();\n const memberSymbolCache = new Map<TSESTree.MemberExpression, ts.Symbol | null>();\n\n /**\n * Resolves an alias symbol to its original symbol and caches the result for reuse.\n * This function avoids repeated TypeScript checker work by memoizing alias resolutions.\n * It ensures downstream analysis consistently uses the same canonical symbol instance.\n *\n * @param symbol The symbol that may be an alias and needs resolution.\n * @returns The resolved canonical symbol for further analysis.\n *\n * @example\n * ```tsx\n * const resolved = resolveSymbol(methodSymbol);\n * ```\n */\n const resolveSymbol = (symbol: ts.Symbol): ts.Symbol => {\n const cached = aliasCache.get(symbol);\n\n if (cached) {\n return cached;\n }\n\n // eslint-disable-next-line no-bitwise\n const resolved = symbol.flags & ts.SymbolFlags.Alias ? checker.getAliasedSymbol(symbol) : symbol;\n\n aliasCache.set(symbol, resolved);\n\n return resolved;\n };\n\n /**\n * Computes metadata about a method-like symbol and caches the result for later use.\n * This function filters out non-method symbols and constructor declarations before gathering details.\n * It also determines decorator presence, static status, and whether the method uses `this`.\n *\n * @param symbol The symbol to inspect for method information.\n * @returns The resolved method info or null when the symbol is not a supported method.\n *\n * @example\n * ```tsx\n * const info = getMethodInfo(methodSymbol);\n * ```\n */\n const getMethodInfo = (symbol: ts.Symbol): MethodInfo | null => {\n const aliased = resolveSymbol(symbol);\n const cached = methodCache.get(aliased);\n\n if (cached) {\n return cached;\n }\n\n if (!(\n // eslint-disable-next-line no-bitwise\n aliased.flags\n & (\n // eslint-disable-next-line no-bitwise\n ts.SymbolFlags.Method\n | ts.SymbolFlags.Property\n | ts.SymbolFlags.Function\n | ts.SymbolFlags.GetAccessor\n | ts.SymbolFlags.SetAccessor\n )\n )) {\n return null;\n }\n\n const declarations = aliased.getDeclarations() ?? [];\n const methodDecl = declarations\n .find(decl => ts.isMethodDeclaration(decl));\n\n if (!methodDecl?.parent || !ts.isClassLike(methodDecl.parent)) {\n return null;\n }\n\n if (ts.isIdentifier(methodDecl.name) && methodDecl.name.text === 'constructor') {\n return null;\n }\n\n const flags = ts.getCombinedModifierFlags(methodDecl);\n // eslint-disable-next-line no-bitwise\n const isStatic = Boolean(flags & ts.ModifierFlags.Static);\n const decorators = ts.canHaveDecorators(methodDecl) ? ts.getDecorators(methodDecl) : undefined;\n const hasDecorator = Boolean(decorators?.some(decorator => {\n const name = getDecoratorName(decorator);\n\n return Boolean(name && decoratorNames.has(name));\n }));\n\n const info: MethodInfo = {\n hasDecorator,\n isStatic,\n usesThis: methodUsesThis(methodDecl)\n };\n\n methodCache.set(aliased, info);\n\n return info;\n };\n\n /**\n * Determines whether a symbol should be reported as an unbound method.\n * It resolves aliases and consults cached results to avoid repeated analysis.\n * It evaluates method metadata to ensure only non-static methods that use `this` and lack decorators are flagged.\n *\n * @param symbol The symbol to evaluate for reporting eligibility.\n * @returns True when the symbol represents an unbound method that should be reported.\n *\n * @example\n * ```tsx\n * const shouldReport = shouldReportSymbol(methodSymbol);\n * ```\n */\n const shouldReportSymbol = (symbol: ts.Symbol): boolean => {\n const aliased = resolveSymbol(symbol);\n const cached = reportCache.get(aliased);\n\n if (cached !== undefined) {\n return cached;\n }\n\n const info = getMethodInfo(aliased);\n\n if (!info) {\n reportCache.set(aliased, false);\n\n return false;\n }\n\n const shouldReport = !info.isStatic && info.usesThis && !info.hasDecorator;\n\n reportCache.set(aliased, shouldReport);\n\n return shouldReport;\n };\n\n /**\n * Resolves the TypeScript symbol associated with a member expression node.\n * It caches the resolved symbol to minimize repeated checker lookups.\n * It supports both property access and string-literal element access expressions.\n *\n * @param node The member expression node to resolve into a symbol.\n * @returns The resolved symbol, or null when no symbol can be determined.\n *\n * @example\n * ```tsx\n * const symbol = getSymbolForMember(memberExpression);\n * ```\n */\n const getSymbolForMember = (node: TSESTree.MemberExpression): ts.Symbol | null => {\n const cached = memberSymbolCache.get(node);\n\n if (cached !== undefined) {\n return cached;\n }\n\n const tsNode = services.esTreeNodeToTSNodeMap.get(node);\n\n if (ts.isPropertyAccessExpression(tsNode)) {\n const symbol = checker.getSymbolAtLocation(tsNode.name) ?? null;\n\n memberSymbolCache.set(node, symbol);\n\n return symbol;\n }\n\n if (ts.isElementAccessExpression(tsNode)) {\n const arg = tsNode.argumentExpression;\n\n if (ts.isStringLiteralLike(arg)) {\n const symbol = checker.getSymbolAtLocation(arg) ?? null;\n\n memberSymbolCache.set(node, symbol);\n\n return symbol;\n }\n }\n\n memberSymbolCache.set(node, null);\n\n return null;\n };\n\n /**\n * Reports a constructor binding assignment for a method name.\n * It formats the report data with the decorator label and method name.\n * It delegates to the ESLint context to surface the diagnostic at the provided node.\n *\n * @param methodName The name of the method that was bound in the constructor.\n * @param node The AST node that represents the binding expression.\n *\n * @example\n * ```tsx\n * reportConstructorBinding('handleClick', expressionNode);\n * ```\n */\n const reportConstructorBinding = (methodName: string, node: TSESTree.Node) => {\n context.report({\n data: {\n decoratorName: decoratorLabel,\n methodName\n },\n messageId: 'constructorBind',\n node\n });\n };\n\n const listeners: TSESLint.RuleListener = {\n /**\n * Processes a member expression node to determine whether it represents an unbound method usage that\n * should be reported. It performs multiple early returns based on node shape, parent usage, callback context,\n * binding checks, and symbol eligibility. It ultimately reports a linting issue when all conditions\n * indicate a problematic unbound method reference.\n *\n * @param node The member expression node to analyze for unbound method usage.\n *\n * @example\n * ```tsx\n * MemberExpression(node);\n * ```\n */\n MemberExpression(node: TSESTree.MemberExpression) {\n if (node.property.type !== AST_NODE_TYPES.Identifier) {\n return;\n }\n\n const {parent} = node;\n\n if (\n (parent.type === AST_NODE_TYPES.CallExpression || parent.type === AST_NODE_TYPES.NewExpression)\n && parent.callee === node\n ) {\n return;\n }\n\n if (!isCallbackUsage(node)) {\n return;\n }\n\n if (isThisBindCall(node)) {\n return;\n }\n\n const symbol = getSymbolForMember(node);\n\n if (!symbol) {\n return;\n }\n\n if (!shouldReportSymbol(symbol)) {\n return;\n }\n\n context.report({\n data: {\n decoratorName: decoratorLabel,\n methodName: node.property.name\n },\n messageId: 'unboundMethod',\n node\n });\n },\n /**\n * Inspects constructor method definitions to detect assignments where a class method\n * is bound to `this` via `.bind(this)`, and reports such bindings for further handling.\n *\n * @param node The method definition node to analyze.\n */\n MethodDefinition(node: TSESTree.MethodDefinition) {\n if (node.kind !== 'constructor' || !node.value.body) {\n return;\n }\n\n const constructorBody = node.value.body;\n\n for (const statement of constructorBody.body) {\n if (statement.type !== AST_NODE_TYPES.ExpressionStatement) {\n continue;\n }\n\n const {expression} = statement;\n\n if (expression.type !== AST_NODE_TYPES.AssignmentExpression || expression.operator !== '=') {\n continue;\n }\n\n const {left, right} = expression;\n\n if (\n left.type !== AST_NODE_TYPES.MemberExpression\n || left.property.type !== AST_NODE_TYPES.Identifier\n ) {\n continue;\n }\n\n if (left.object.type !== AST_NODE_TYPES.ThisExpression) {\n continue;\n }\n\n if (right.type !== AST_NODE_TYPES.CallExpression) {\n continue;\n }\n\n const {callee} = right;\n\n if (callee.type !== AST_NODE_TYPES.MemberExpression) {\n continue;\n }\n\n if (\n callee.object.type !== AST_NODE_TYPES.MemberExpression\n || callee.object.object.type !== AST_NODE_TYPES.ThisExpression\n || callee.object.property.type !== AST_NODE_TYPES.Identifier\n || callee.object.property.name !== left.property.name\n ) {\n continue;\n }\n\n if (\n callee.property.type !== AST_NODE_TYPES.Identifier\n || callee.property.name !== 'bind'\n ) {\n continue;\n }\n\n if (right.arguments.length === 0) {\n continue;\n }\n\n const firstArg = unwrapExpression(right.arguments[0] as TSESTree.Expression);\n\n if (firstArg.type !== AST_NODE_TYPES.ThisExpression) {\n continue;\n }\n\n reportConstructorBinding(left.property.name, expression);\n }\n }\n };\n\n return listeners;\n }\n});"],"names":["createRule","ESLintUtils","RuleCreator","name","noUnboundMethod","defaultOptions","decoratorNames","DEFAULT_DECORATORS","meta","docs","description","messages","constructorBind","unboundMethod","schema","additionalProperties","properties","items","type","uniqueItems","create","context","services","getParserServices","checker","program","getTypeChecker","normalizeDecoratorNames","options","decoratorLabel","Array","from","methodCache","Map","reportCache","aliasCache","memberSymbolCache","resolveSymbol","symbol","cached","get","resolved","flags","ts","SymbolFlags","Alias","getAliasedSymbol","set","getMethodInfo","aliased","Method","Property","Function","GetAccessor","SetAccessor","declarations","getDeclarations","methodDecl","find","decl","isMethodDeclaration","parent","isClassLike","isIdentifier","text","getCombinedModifierFlags","isStatic","Boolean","ModifierFlags","Static","decorators","canHaveDecorators","getDecorators","undefined","hasDecorator","some","decorator","getDecoratorName","has","info","usesThis","methodUsesThis","shouldReportSymbol","shouldReport","getSymbolForMember","node","tsNode","esTreeNodeToTSNodeMap","isPropertyAccessExpression","getSymbolAtLocation","isElementAccessExpression","arg","argumentExpression","isStringLiteralLike","reportConstructorBinding","methodName","report","data","decoratorName","messageId","listeners","MemberExpression","property","AST_NODE_TYPES","Identifier","CallExpression","NewExpression","callee","isCallbackUsage","isThisBindCall","MethodDefinition","kind","value","body","constructorBody","statement","ExpressionStatement","expression","AssignmentExpression","operator","left","right","object","ThisExpression","arguments","length","firstArg","unwrapExpression"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"no-unbound-method.js","sources":["../../../../src/rules/custom/no-unbound-method.ts"],"sourcesContent":["import {AST_NODE_TYPES, ESLintUtils} from '@typescript-eslint/utils';\nimport ts from 'typescript';\n\nimport {\n DEFAULT_DECORATORS,\n getDecoratorName,\n isCallbackUsage,\n isThisBindCall,\n methodUsesThis,\n normalizeDecoratorNames,\n unwrapExpression\n} from './utils/no-unbound-method-utils';\n\nimport type {TSESLint, TSESTree} from '@typescript-eslint/utils';\n\nconst createRule = ESLintUtils.RuleCreator(\n name => `https://github.com/nfqde/eslint-config-nfq/blob/master/docs/rules/${name}.md`\n);\n\ntype RuleOptions = [\n {decoratorNames?: string[]}?\n];\n\ntype MessageIds = 'constructorBind' | 'unboundMethod';\n\ntype MethodInfo = {\n autoBind: boolean;\n hasDecorator: boolean;\n isStatic: boolean;\n usesThis: boolean;\n};\n\nexport const noUnboundMethod = createRule<RuleOptions, MessageIds>({\n defaultOptions: [{decoratorNames: DEFAULT_DECORATORS}],\n meta: {\n docs: {description: 'Warn when unbound class methods that use this are passed as callbacks.'},\n messages: {\n constructorBind: 'Do not bind in the constructor; prefer {{decoratorName}}.',\n unboundMethod: 'Method {{methodName}} uses this and is passed unbound. Add {{decoratorName}} or bind it.'\n },\n schema: [\n {\n additionalProperties: false,\n properties: {\n decoratorNames: {\n items: {type: 'string'},\n type: 'array',\n uniqueItems: true\n }\n },\n type: 'object'\n }\n ],\n type: 'problem'\n },\n name: 'no-unbound-method',\n /**\n * Creates the rule listeners and initializes caches for symbol analysis.\n * It wires the parser services to the TypeScript type checker and configures decorator handling.\n * It returns ESLint listeners that report unbound method usage in callbacks and constructor binding.\n *\n * @param context Rule context used to access parser services and report issues.\n * @returns The rule listener map for this rule.\n *\n * @example\n * ```tsx\n * const listeners = rule.create(context);\n * ```\n */\n create(context) {\n const services = ESLintUtils.getParserServices(context);\n const checker = services.program.getTypeChecker();\n const decoratorNames = normalizeDecoratorNames(context.options[0]?.decoratorNames);\n const decoratorLabel = `@${Array.from(decoratorNames)[0] ?? 'autobind'}`;\n const methodCache = new Map<ts.Symbol, MethodInfo>();\n const reportCache = new Map<ts.Symbol, boolean>();\n const aliasCache = new Map<ts.Symbol, ts.Symbol>();\n const memberSymbolCache = new Map<TSESTree.MemberExpression, ts.Symbol | null>();\n const classAutoBindCache = new WeakMap<ts.ClassLikeDeclaration, boolean>();\n\n const isAutoBindOption = (node: ts.Expression): boolean => {\n if (!ts.isObjectLiteralExpression(node)) {\n return false;\n }\n\n return node.properties.some(property => {\n if (!ts.isPropertyAssignment(property)) {\n return false;\n }\n\n const name = ts.isIdentifier(property.name)\n ? property.name.text\n : ts.isStringLiteral(property.name)\n ? property.name.text\n : null;\n\n if (name !== 'autoBind') {\n return false;\n }\n\n return property.initializer.kind === ts.SyntaxKind.TrueKeyword;\n });\n };\n\n const isMakeAutoObservableCallee = (node: ts.Expression): boolean => {\n if (ts.isIdentifier(node)) {\n return node.text === 'makeAutoObservable';\n }\n\n return ts.isPropertyAccessExpression(node) && node.name.text === 'makeAutoObservable';\n };\n\n const hasAutoBindInConstructor = (classDecl: ts.ClassLikeDeclaration): boolean => {\n const cached = classAutoBindCache.get(classDecl);\n\n if (cached !== undefined) {\n return cached;\n }\n\n const ctor = classDecl.members.find(member => ts.isConstructorDeclaration(member));\n\n if (!ctor?.body) {\n classAutoBindCache.set(classDecl, false);\n\n return false;\n }\n\n for (const statement of ctor.body.statements) {\n if (!ts.isExpressionStatement(statement)) {\n continue;\n }\n\n const expr = statement.expression;\n\n if (!ts.isCallExpression(expr)) {\n continue;\n }\n\n if (!isMakeAutoObservableCallee(expr.expression)) {\n continue;\n }\n\n if (expr.arguments.length < 2) {\n continue;\n }\n\n if (expr.arguments[0].kind !== ts.SyntaxKind.ThisKeyword) {\n continue;\n }\n\n const hasAutoBind = expr.arguments.slice(1).some(arg => isAutoBindOption(arg));\n\n if (hasAutoBind) {\n classAutoBindCache.set(classDecl, true);\n\n return true;\n }\n }\n\n classAutoBindCache.set(classDecl, false);\n\n return false;\n };\n\n /**\n * Resolves an alias symbol to its original symbol and caches the result for reuse.\n * This function avoids repeated TypeScript checker work by memoizing alias resolutions.\n * It ensures downstream analysis consistently uses the same canonical symbol instance.\n *\n * @param symbol The symbol that may be an alias and needs resolution.\n * @returns The resolved canonical symbol for further analysis.\n *\n * @example\n * ```tsx\n * const resolved = resolveSymbol(methodSymbol);\n * ```\n */\n const resolveSymbol = (symbol: ts.Symbol): ts.Symbol => {\n const cached = aliasCache.get(symbol);\n\n if (cached) {\n return cached;\n }\n\n // eslint-disable-next-line no-bitwise\n const resolved = symbol.flags & ts.SymbolFlags.Alias ? checker.getAliasedSymbol(symbol) : symbol;\n\n aliasCache.set(symbol, resolved);\n\n return resolved;\n };\n\n /**\n * Computes metadata about a method-like symbol and caches the result for later use.\n * This function filters out non-method symbols and constructor declarations before gathering details.\n * It also determines decorator presence, static status, and whether the method uses `this`.\n *\n * @param symbol The symbol to inspect for method information.\n * @returns The resolved method info or null when the symbol is not a supported method.\n *\n * @example\n * ```tsx\n * const info = getMethodInfo(methodSymbol);\n * ```\n */\n const getMethodInfo = (symbol: ts.Symbol): MethodInfo | null => {\n const aliased = resolveSymbol(symbol);\n const cached = methodCache.get(aliased);\n\n if (cached) {\n return cached;\n }\n\n if (!(\n // eslint-disable-next-line no-bitwise\n aliased.flags\n & (\n // eslint-disable-next-line no-bitwise\n ts.SymbolFlags.Method\n | ts.SymbolFlags.Property\n | ts.SymbolFlags.Function\n | ts.SymbolFlags.GetAccessor\n | ts.SymbolFlags.SetAccessor\n )\n )) {\n return null;\n }\n\n const declarations = aliased.getDeclarations() ?? [];\n const methodDecl = declarations\n .find(decl => ts.isMethodDeclaration(decl));\n\n if (!methodDecl?.parent || !ts.isClassLike(methodDecl.parent)) {\n return null;\n }\n\n if (ts.isIdentifier(methodDecl.name) && methodDecl.name.text === 'constructor') {\n return null;\n }\n\n const flags = ts.getCombinedModifierFlags(methodDecl);\n // eslint-disable-next-line no-bitwise\n const isStatic = Boolean(flags & ts.ModifierFlags.Static);\n const decorators = ts.canHaveDecorators(methodDecl) ? ts.getDecorators(methodDecl) : undefined;\n const hasDecorator = Boolean(decorators?.some(decorator => {\n const name = getDecoratorName(decorator);\n\n return Boolean(name && decoratorNames.has(name));\n }));\n\n const info: MethodInfo = {\n autoBind: hasAutoBindInConstructor(methodDecl.parent),\n hasDecorator,\n isStatic,\n usesThis: methodUsesThis(methodDecl)\n };\n\n methodCache.set(aliased, info);\n\n return info;\n };\n\n /**\n * Determines whether a symbol should be reported as an unbound method.\n * It resolves aliases and consults cached results to avoid repeated analysis.\n * It evaluates method metadata to ensure only non-static methods that use `this` and lack decorators are flagged.\n *\n * @param symbol The symbol to evaluate for reporting eligibility.\n * @returns True when the symbol represents an unbound method that should be reported.\n *\n * @example\n * ```tsx\n * const shouldReport = shouldReportSymbol(methodSymbol);\n * ```\n */\n const shouldReportSymbol = (symbol: ts.Symbol): boolean => {\n const aliased = resolveSymbol(symbol);\n const cached = reportCache.get(aliased);\n\n if (cached !== undefined) {\n return cached;\n }\n\n const info = getMethodInfo(aliased);\n\n if (!info) {\n reportCache.set(aliased, false);\n\n return false;\n }\n\n const shouldReport = !info.autoBind && !info.isStatic && info.usesThis && !info.hasDecorator;\n\n reportCache.set(aliased, shouldReport);\n\n return shouldReport;\n };\n\n /**\n * Resolves the TypeScript symbol associated with a member expression node.\n * It caches the resolved symbol to minimize repeated checker lookups.\n * It supports both property access and string-literal element access expressions.\n *\n * @param node The member expression node to resolve into a symbol.\n * @returns The resolved symbol, or null when no symbol can be determined.\n *\n * @example\n * ```tsx\n * const symbol = getSymbolForMember(memberExpression);\n * ```\n */\n const getSymbolForMember = (node: TSESTree.MemberExpression): ts.Symbol | null => {\n const cached = memberSymbolCache.get(node);\n\n if (cached !== undefined) {\n return cached;\n }\n\n const tsNode = services.esTreeNodeToTSNodeMap.get(node);\n\n if (ts.isPropertyAccessExpression(tsNode)) {\n const symbol = checker.getSymbolAtLocation(tsNode.name) ?? null;\n\n memberSymbolCache.set(node, symbol);\n\n return symbol;\n }\n\n if (ts.isElementAccessExpression(tsNode)) {\n const arg = tsNode.argumentExpression;\n\n if (ts.isStringLiteralLike(arg)) {\n const symbol = checker.getSymbolAtLocation(arg) ?? null;\n\n memberSymbolCache.set(node, symbol);\n\n return symbol;\n }\n }\n\n memberSymbolCache.set(node, null);\n\n return null;\n };\n\n /**\n * Reports a constructor binding assignment for a method name.\n * It formats the report data with the decorator label and method name.\n * It delegates to the ESLint context to surface the diagnostic at the provided node.\n *\n * @param methodName The name of the method that was bound in the constructor.\n * @param node The AST node that represents the binding expression.\n *\n * @example\n * ```tsx\n * reportConstructorBinding('handleClick', expressionNode);\n * ```\n */\n const reportConstructorBinding = (methodName: string, node: TSESTree.Node) => {\n context.report({\n data: {\n decoratorName: decoratorLabel,\n methodName\n },\n messageId: 'constructorBind',\n node\n });\n };\n\n const listeners: TSESLint.RuleListener = {\n /**\n * Processes a member expression node to determine whether it represents an unbound method usage that\n * should be reported. It performs multiple early returns based on node shape, parent usage, callback context,\n * binding checks, and symbol eligibility. It ultimately reports a linting issue when all conditions\n * indicate a problematic unbound method reference.\n *\n * @param node The member expression node to analyze for unbound method usage.\n *\n * @example\n * ```tsx\n * MemberExpression(node);\n * ```\n */\n MemberExpression(node: TSESTree.MemberExpression) {\n if (node.property.type !== AST_NODE_TYPES.Identifier) {\n return;\n }\n\n const {parent} = node;\n\n if (\n (parent.type === AST_NODE_TYPES.CallExpression || parent.type === AST_NODE_TYPES.NewExpression)\n && parent.callee === node\n ) {\n return;\n }\n\n if (!isCallbackUsage(node)) {\n return;\n }\n\n if (isThisBindCall(node)) {\n return;\n }\n\n const symbol = getSymbolForMember(node);\n\n if (!symbol) {\n return;\n }\n\n if (!shouldReportSymbol(symbol)) {\n return;\n }\n\n context.report({\n data: {\n decoratorName: decoratorLabel,\n methodName: node.property.name\n },\n messageId: 'unboundMethod',\n node\n });\n },\n /**\n * Inspects constructor method definitions to detect assignments where a class method\n * is bound to `this` via `.bind(this)`, and reports such bindings for further handling.\n *\n * @param node The method definition node to analyze.\n */\n MethodDefinition(node: TSESTree.MethodDefinition) {\n if (node.kind !== 'constructor' || !node.value.body) {\n return;\n }\n\n const constructorBody = node.value.body;\n\n for (const statement of constructorBody.body) {\n if (statement.type !== AST_NODE_TYPES.ExpressionStatement) {\n continue;\n }\n\n const {expression} = statement;\n\n if (expression.type !== AST_NODE_TYPES.AssignmentExpression || expression.operator !== '=') {\n continue;\n }\n\n const {left, right} = expression;\n\n if (\n left.type !== AST_NODE_TYPES.MemberExpression\n || left.property.type !== AST_NODE_TYPES.Identifier\n ) {\n continue;\n }\n\n if (left.object.type !== AST_NODE_TYPES.ThisExpression) {\n continue;\n }\n\n if (right.type !== AST_NODE_TYPES.CallExpression) {\n continue;\n }\n\n const {callee} = right;\n\n if (callee.type !== AST_NODE_TYPES.MemberExpression) {\n continue;\n }\n\n if (\n callee.object.type !== AST_NODE_TYPES.MemberExpression\n || callee.object.object.type !== AST_NODE_TYPES.ThisExpression\n || callee.object.property.type !== AST_NODE_TYPES.Identifier\n || callee.object.property.name !== left.property.name\n ) {\n continue;\n }\n\n if (\n callee.property.type !== AST_NODE_TYPES.Identifier\n || callee.property.name !== 'bind'\n ) {\n continue;\n }\n\n if (right.arguments.length === 0) {\n continue;\n }\n\n const firstArg = unwrapExpression(right.arguments[0] as TSESTree.Expression);\n\n if (firstArg.type !== AST_NODE_TYPES.ThisExpression) {\n continue;\n }\n\n reportConstructorBinding(left.property.name, expression);\n }\n }\n };\n\n return listeners;\n }\n});"],"names":["createRule","ESLintUtils","RuleCreator","name","noUnboundMethod","defaultOptions","decoratorNames","DEFAULT_DECORATORS","meta","docs","description","messages","constructorBind","unboundMethod","schema","additionalProperties","properties","items","type","uniqueItems","create","context","services","getParserServices","checker","program","getTypeChecker","normalizeDecoratorNames","options","decoratorLabel","Array","from","methodCache","Map","reportCache","aliasCache","memberSymbolCache","classAutoBindCache","WeakMap","isAutoBindOption","node","ts","isObjectLiteralExpression","some","property","isPropertyAssignment","isIdentifier","text","isStringLiteral","initializer","kind","SyntaxKind","TrueKeyword","isMakeAutoObservableCallee","isPropertyAccessExpression","hasAutoBindInConstructor","classDecl","cached","get","undefined","ctor","members","find","member","isConstructorDeclaration","body","set","statement","statements","isExpressionStatement","expr","expression","isCallExpression","arguments","length","ThisKeyword","hasAutoBind","slice","arg","resolveSymbol","symbol","resolved","flags","SymbolFlags","Alias","getAliasedSymbol","getMethodInfo","aliased","Method","Property","Function","GetAccessor","SetAccessor","declarations","getDeclarations","methodDecl","decl","isMethodDeclaration","parent","isClassLike","getCombinedModifierFlags","isStatic","Boolean","ModifierFlags","Static","decorators","canHaveDecorators","getDecorators","hasDecorator","decorator","getDecoratorName","has","info","autoBind","usesThis","methodUsesThis","shouldReportSymbol","shouldReport","getSymbolForMember","tsNode","esTreeNodeToTSNodeMap","getSymbolAtLocation","isElementAccessExpression","argumentExpression","isStringLiteralLike","reportConstructorBinding","methodName","report","data","decoratorName","messageId","listeners","MemberExpression","AST_NODE_TYPES","Identifier","CallExpression","NewExpression","callee","isCallbackUsage","isThisBindCall","MethodDefinition","value","constructorBody","ExpressionStatement","AssignmentExpression","operator","left","right","object","ThisExpression","firstArg","unwrapExpression"],"mappings":";;;;AAeA,MAAMA,YAAU,GAAGC,WAAW,CAACC,WAAW,CACtCC,IAAI,IAAI,CAAA,kEAAA,EAAqEA,IAAI,CAAA,GAAA,CACrF,CAAC;AAeM,MAAMC,eAAe,GAAGJ,YAAU,CAA0B;AAC/DK,EAAAA,cAAc,EAAE,CAAC;AAACC,IAAAA,cAAc,EAAEC;AAAkB,GAAC,CAAC;AACtDC,EAAAA,IAAI,EAAE;AACFC,IAAAA,IAAI,EAAE;AAACC,MAAAA,WAAW,EAAE;KAAyE;AAC7FC,IAAAA,QAAQ,EAAE;AACNC,MAAAA,eAAe,EAAE,2DAA2D;AAC5EC,MAAAA,aAAa,EAAE;KAClB;AACDC,IAAAA,MAAM,EAAE,CACJ;AACIC,MAAAA,oBAAoB,EAAE,KAAK;AAC3BC,MAAAA,UAAU,EAAE;AACRV,QAAAA,cAAc,EAAE;AACZW,UAAAA,KAAK,EAAE;AAACC,YAAAA,IAAI,EAAE;WAAS;AACvBA,UAAAA,IAAI,EAAE,OAAO;AACbC,UAAAA,WAAW,EAAE;AACjB;OACH;AACDD,MAAAA,IAAI,EAAE;AACV,KAAC,CACJ;AACDA,IAAAA,IAAI,EAAE;GACT;AACDf,EAAAA,IAAI,EAAE,mBAAmB;EAczBiB,MAAMA,CAACC,OAAO,EAAE;AACZ,IAAA,MAAMC,QAAQ,GAAGrB,WAAW,CAACsB,iBAAiB,CAACF,OAAO,CAAC;IACvD,MAAMG,OAAO,GAAGF,QAAQ,CAACG,OAAO,CAACC,cAAc,EAAE;AACjD,IAAA,MAAMpB,cAAc,GAAGqB,uBAAuB,CAACN,OAAO,CAACO,OAAO,CAAC,CAAC,CAAC,EAAEtB,cAAc,CAAC;AAClF,IAAA,MAAMuB,cAAc,GAAG,CAAA,CAAA,EAAIC,KAAK,CAACC,IAAI,CAACzB,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,CAAA,CAAE;AACxE,IAAA,MAAM0B,WAAW,GAAG,IAAIC,GAAG,EAAyB;AACpD,IAAA,MAAMC,WAAW,GAAG,IAAID,GAAG,EAAsB;AACjD,IAAA,MAAME,UAAU,GAAG,IAAIF,GAAG,EAAwB;AAClD,IAAA,MAAMG,iBAAiB,GAAG,IAAIH,GAAG,EAA+C;AAChF,IAAA,MAAMI,kBAAkB,GAAG,IAAIC,OAAO,EAAoC;IAE1E,MAAMC,gBAAgB,GAAIC,IAAmB,IAAc;AACvD,MAAA,IAAI,CAACC,EAAE,CAACC,yBAAyB,CAACF,IAAI,CAAC,EAAE;AACrC,QAAA,OAAO,KAAK;AAChB,MAAA;AAEA,MAAA,OAAOA,IAAI,CAACxB,UAAU,CAAC2B,IAAI,CAACC,QAAQ,IAAI;AACpC,QAAA,IAAI,CAACH,EAAE,CAACI,oBAAoB,CAACD,QAAQ,CAAC,EAAE;AACpC,UAAA,OAAO,KAAK;AAChB,QAAA;AAEA,QAAA,MAAMzC,IAAI,GAAGsC,EAAE,CAACK,YAAY,CAACF,QAAQ,CAACzC,IAAI,CAAC,GACrCyC,QAAQ,CAACzC,IAAI,CAAC4C,IAAI,GAClBN,EAAE,CAACO,eAAe,CAACJ,QAAQ,CAACzC,IAAI,CAAC,GAC7ByC,QAAQ,CAACzC,IAAI,CAAC4C,IAAI,GAClB,IAAI;QAEd,IAAI5C,IAAI,KAAK,UAAU,EAAE;AACrB,UAAA,OAAO,KAAK;AAChB,QAAA;QAEA,OAAOyC,QAAQ,CAACK,WAAW,CAACC,IAAI,KAAKT,EAAE,CAACU,UAAU,CAACC,WAAW;AAClE,MAAA,CAAC,CAAC;IACN,CAAC;IAED,MAAMC,0BAA0B,GAAIb,IAAmB,IAAc;AACjE,MAAA,IAAIC,EAAE,CAACK,YAAY,CAACN,IAAI,CAAC,EAAE;AACvB,QAAA,OAAOA,IAAI,CAACO,IAAI,KAAK,oBAAoB;AAC7C,MAAA;AAEA,MAAA,OAAON,EAAE,CAACa,0BAA0B,CAACd,IAAI,CAAC,IAAIA,IAAI,CAACrC,IAAI,CAAC4C,IAAI,KAAK,oBAAoB;IACzF,CAAC;IAED,MAAMQ,wBAAwB,GAAIC,SAAkC,IAAc;AAC9E,MAAA,MAAMC,MAAM,GAAGpB,kBAAkB,CAACqB,GAAG,CAACF,SAAS,CAAC;MAEhD,IAAIC,MAAM,KAAKE,SAAS,EAAE;AACtB,QAAA,OAAOF,MAAM;AACjB,MAAA;AAEA,MAAA,MAAMG,IAAI,GAAGJ,SAAS,CAACK,OAAO,CAACC,IAAI,CAACC,MAAM,IAAItB,EAAE,CAACuB,wBAAwB,CAACD,MAAM,CAAC,CAAC;AAElF,MAAA,IAAI,CAACH,IAAI,EAAEK,IAAI,EAAE;AACb5B,QAAAA,kBAAkB,CAAC6B,GAAG,CAACV,SAAS,EAAE,KAAK,CAAC;AAExC,QAAA,OAAO,KAAK;AAChB,MAAA;MAEA,KAAK,MAAMW,SAAS,IAAIP,IAAI,CAACK,IAAI,CAACG,UAAU,EAAE;AAC1C,QAAA,IAAI,CAAC3B,EAAE,CAAC4B,qBAAqB,CAACF,SAAS,CAAC,EAAE;AACtC,UAAA;AACJ,QAAA;AAEA,QAAA,MAAMG,IAAI,GAAGH,SAAS,CAACI,UAAU;AAEjC,QAAA,IAAI,CAAC9B,EAAE,CAAC+B,gBAAgB,CAACF,IAAI,CAAC,EAAE;AAC5B,UAAA;AACJ,QAAA;AAEA,QAAA,IAAI,CAACjB,0BAA0B,CAACiB,IAAI,CAACC,UAAU,CAAC,EAAE;AAC9C,UAAA;AACJ,QAAA;AAEA,QAAA,IAAID,IAAI,CAACG,SAAS,CAACC,MAAM,GAAG,CAAC,EAAE;AAC3B,UAAA;AACJ,QAAA;AAEA,QAAA,IAAIJ,IAAI,CAACG,SAAS,CAAC,CAAC,CAAC,CAACvB,IAAI,KAAKT,EAAE,CAACU,UAAU,CAACwB,WAAW,EAAE;AACtD,UAAA;AACJ,QAAA;AAEA,QAAA,MAAMC,WAAW,GAAGN,IAAI,CAACG,SAAS,CAACI,KAAK,CAAC,CAAC,CAAC,CAAClC,IAAI,CAACmC,GAAG,IAAIvC,gBAAgB,CAACuC,GAAG,CAAC,CAAC;AAE9E,QAAA,IAAIF,WAAW,EAAE;AACbvC,UAAAA,kBAAkB,CAAC6B,GAAG,CAACV,SAAS,EAAE,IAAI,CAAC;AAEvC,UAAA,OAAO,IAAI;AACf,QAAA;AACJ,MAAA;AAEAnB,MAAAA,kBAAkB,CAAC6B,GAAG,CAACV,SAAS,EAAE,KAAK,CAAC;AAExC,MAAA,OAAO,KAAK;IAChB,CAAC;IAeD,MAAMuB,aAAa,GAAIC,MAAiB,IAAgB;AACpD,MAAA,MAAMvB,MAAM,GAAGtB,UAAU,CAACuB,GAAG,CAACsB,MAAM,CAAC;AAErC,MAAA,IAAIvB,MAAM,EAAE;AACR,QAAA,OAAOA,MAAM;AACjB,MAAA;AAGA,MAAA,MAAMwB,QAAQ,GAAGD,MAAM,CAACE,KAAK,GAAGzC,EAAE,CAAC0C,WAAW,CAACC,KAAK,GAAG5D,OAAO,CAAC6D,gBAAgB,CAACL,MAAM,CAAC,GAAGA,MAAM;AAEhG7C,MAAAA,UAAU,CAAC+B,GAAG,CAACc,MAAM,EAAEC,QAAQ,CAAC;AAEhC,MAAA,OAAOA,QAAQ;IACnB,CAAC;IAeD,MAAMK,aAAa,GAAIN,MAAiB,IAAwB;AAC5D,MAAA,MAAMO,OAAO,GAAGR,aAAa,CAACC,MAAM,CAAC;AACrC,MAAA,MAAMvB,MAAM,GAAGzB,WAAW,CAAC0B,GAAG,CAAC6B,OAAO,CAAC;AAEvC,MAAA,IAAI9B,MAAM,EAAE;AACR,QAAA,OAAOA,MAAM;AACjB,MAAA;AAEA,MAAA,IAAI,EAEA8B,OAAO,CAACL,KAAK,IAGTzC,EAAE,CAAC0C,WAAW,CAACK,MAAM,GACnB/C,EAAE,CAAC0C,WAAW,CAACM,QAAQ,GACvBhD,EAAE,CAAC0C,WAAW,CAACO,QAAQ,GACvBjD,EAAE,CAAC0C,WAAW,CAACQ,WAAW,GAC1BlD,EAAE,CAAC0C,WAAW,CAACS,WAAW,CAC/B,CACJ,EAAE;AACC,QAAA,OAAO,IAAI;AACf,MAAA;MAEA,MAAMC,YAAY,GAAGN,OAAO,CAACO,eAAe,EAAE,IAAI,EAAE;AACpD,MAAA,MAAMC,UAAU,GAAGF,YAAY,CAC1B/B,IAAI,CAACkC,IAAI,IAAIvD,EAAE,CAACwD,mBAAmB,CAACD,IAAI,CAAC,CAAC;AAE/C,MAAA,IAAI,CAACD,UAAU,EAAEG,MAAM,IAAI,CAACzD,EAAE,CAAC0D,WAAW,CAACJ,UAAU,CAACG,MAAM,CAAC,EAAE;AAC3D,QAAA,OAAO,IAAI;AACf,MAAA;AAEA,MAAA,IAAIzD,EAAE,CAACK,YAAY,CAACiD,UAAU,CAAC5F,IAAI,CAAC,IAAI4F,UAAU,CAAC5F,IAAI,CAAC4C,IAAI,KAAK,aAAa,EAAE;AAC5E,QAAA,OAAO,IAAI;AACf,MAAA;AAEA,MAAA,MAAMmC,KAAK,GAAGzC,EAAE,CAAC2D,wBAAwB,CAACL,UAAU,CAAC;MAErD,MAAMM,QAAQ,GAAGC,OAAO,CAACpB,KAAK,GAAGzC,EAAE,CAAC8D,aAAa,CAACC,MAAM,CAAC;AACzD,MAAA,MAAMC,UAAU,GAAGhE,EAAE,CAACiE,iBAAiB,CAACX,UAAU,CAAC,GAAGtD,EAAE,CAACkE,aAAa,CAACZ,UAAU,CAAC,GAAGpC,SAAS;MAC9F,MAAMiD,YAAY,GAAGN,OAAO,CAACG,UAAU,EAAE9D,IAAI,CAACkE,SAAS,IAAI;AACvD,QAAA,MAAM1G,IAAI,GAAG2G,gBAAgB,CAACD,SAAS,CAAC;QAExC,OAAOP,OAAO,CAACnG,IAAI,IAAIG,cAAc,CAACyG,GAAG,CAAC5G,IAAI,CAAC,CAAC;AACpD,MAAA,CAAC,CAAC,CAAC;AAEH,MAAA,MAAM6G,IAAgB,GAAG;AACrBC,QAAAA,QAAQ,EAAE1D,wBAAwB,CAACwC,UAAU,CAACG,MAAM,CAAC;QACrDU,YAAY;QACZP,QAAQ;QACRa,QAAQ,EAAEC,cAAc,CAACpB,UAAU;OACtC;AAED/D,MAAAA,WAAW,CAACkC,GAAG,CAACqB,OAAO,EAAEyB,IAAI,CAAC;AAE9B,MAAA,OAAOA,IAAI;IACf,CAAC;IAeD,MAAMI,kBAAkB,GAAIpC,MAAiB,IAAc;AACvD,MAAA,MAAMO,OAAO,GAAGR,aAAa,CAACC,MAAM,CAAC;AACrC,MAAA,MAAMvB,MAAM,GAAGvB,WAAW,CAACwB,GAAG,CAAC6B,OAAO,CAAC;MAEvC,IAAI9B,MAAM,KAAKE,SAAS,EAAE;AACtB,QAAA,OAAOF,MAAM;AACjB,MAAA;AAEA,MAAA,MAAMuD,IAAI,GAAG1B,aAAa,CAACC,OAAO,CAAC;MAEnC,IAAI,CAACyB,IAAI,EAAE;AACP9E,QAAAA,WAAW,CAACgC,GAAG,CAACqB,OAAO,EAAE,KAAK,CAAC;AAE/B,QAAA,OAAO,KAAK;AAChB,MAAA;AAEA,MAAA,MAAM8B,YAAY,GAAG,CAACL,IAAI,CAACC,QAAQ,IAAI,CAACD,IAAI,CAACX,QAAQ,IAAIW,IAAI,CAACE,QAAQ,IAAI,CAACF,IAAI,CAACJ,YAAY;AAE5F1E,MAAAA,WAAW,CAACgC,GAAG,CAACqB,OAAO,EAAE8B,YAAY,CAAC;AAEtC,MAAA,OAAOA,YAAY;IACvB,CAAC;IAeD,MAAMC,kBAAkB,GAAI9E,IAA+B,IAAuB;AAC9E,MAAA,MAAMiB,MAAM,GAAGrB,iBAAiB,CAACsB,GAAG,CAAClB,IAAI,CAAC;MAE1C,IAAIiB,MAAM,KAAKE,SAAS,EAAE;AACtB,QAAA,OAAOF,MAAM;AACjB,MAAA;MAEA,MAAM8D,MAAM,GAAGjG,QAAQ,CAACkG,qBAAqB,CAAC9D,GAAG,CAAClB,IAAI,CAAC;AAEvD,MAAA,IAAIC,EAAE,CAACa,0BAA0B,CAACiE,MAAM,CAAC,EAAE;QACvC,MAAMvC,MAAM,GAAGxD,OAAO,CAACiG,mBAAmB,CAACF,MAAM,CAACpH,IAAI,CAAC,IAAI,IAAI;AAE/DiC,QAAAA,iBAAiB,CAAC8B,GAAG,CAAC1B,IAAI,EAAEwC,MAAM,CAAC;AAEnC,QAAA,OAAOA,MAAM;AACjB,MAAA;AAEA,MAAA,IAAIvC,EAAE,CAACiF,yBAAyB,CAACH,MAAM,CAAC,EAAE;AACtC,QAAA,MAAMzC,GAAG,GAAGyC,MAAM,CAACI,kBAAkB;AAErC,QAAA,IAAIlF,EAAE,CAACmF,mBAAmB,CAAC9C,GAAG,CAAC,EAAE;UAC7B,MAAME,MAAM,GAAGxD,OAAO,CAACiG,mBAAmB,CAAC3C,GAAG,CAAC,IAAI,IAAI;AAEvD1C,UAAAA,iBAAiB,CAAC8B,GAAG,CAAC1B,IAAI,EAAEwC,MAAM,CAAC;AAEnC,UAAA,OAAOA,MAAM;AACjB,QAAA;AACJ,MAAA;AAEA5C,MAAAA,iBAAiB,CAAC8B,GAAG,CAAC1B,IAAI,EAAE,IAAI,CAAC;AAEjC,MAAA,OAAO,IAAI;IACf,CAAC;AAeD,IAAA,MAAMqF,wBAAwB,GAAGA,CAACC,UAAkB,EAAEtF,IAAmB,KAAK;MAC1EnB,OAAO,CAAC0G,MAAM,CAAC;AACXC,QAAAA,IAAI,EAAE;AACFC,UAAAA,aAAa,EAAEpG,cAAc;AAC7BiG,UAAAA;SACH;AACDI,QAAAA,SAAS,EAAE,iBAAiB;AAC5B1F,QAAAA;AACJ,OAAC,CAAC;IACN,CAAC;AAED,IAAA,MAAM2F,SAAgC,GAAG;MAcrCC,gBAAgBA,CAAC5F,IAA+B,EAAE;QAC9C,IAAIA,IAAI,CAACI,QAAQ,CAAC1B,IAAI,KAAKmH,cAAc,CAACC,UAAU,EAAE;AAClD,UAAA;AACJ,QAAA;QAEA,MAAM;AAACpC,UAAAA;AAAM,SAAC,GAAG1D,IAAI;QAErB,IACI,CAAC0D,MAAM,CAAChF,IAAI,KAAKmH,cAAc,CAACE,cAAc,IAAIrC,MAAM,CAAChF,IAAI,KAAKmH,cAAc,CAACG,aAAa,KAC3FtC,MAAM,CAACuC,MAAM,KAAKjG,IAAI,EAC3B;AACE,UAAA;AACJ,QAAA;AAEA,QAAA,IAAI,CAACkG,eAAe,CAAClG,IAAI,CAAC,EAAE;AACxB,UAAA;AACJ,QAAA;AAEA,QAAA,IAAImG,cAAc,CAACnG,IAAI,CAAC,EAAE;AACtB,UAAA;AACJ,QAAA;AAEA,QAAA,MAAMwC,MAAM,GAAGsC,kBAAkB,CAAC9E,IAAI,CAAC;QAEvC,IAAI,CAACwC,MAAM,EAAE;AACT,UAAA;AACJ,QAAA;AAEA,QAAA,IAAI,CAACoC,kBAAkB,CAACpC,MAAM,CAAC,EAAE;AAC7B,UAAA;AACJ,QAAA;QAEA3D,OAAO,CAAC0G,MAAM,CAAC;AACXC,UAAAA,IAAI,EAAE;AACFC,YAAAA,aAAa,EAAEpG,cAAc;AAC7BiG,YAAAA,UAAU,EAAEtF,IAAI,CAACI,QAAQ,CAACzC;WAC7B;AACD+H,UAAAA,SAAS,EAAE,eAAe;AAC1B1F,UAAAA;AACJ,SAAC,CAAC;MACN,CAAC;MAODoG,gBAAgBA,CAACpG,IAA+B,EAAE;AAC9C,QAAA,IAAIA,IAAI,CAACU,IAAI,KAAK,aAAa,IAAI,CAACV,IAAI,CAACqG,KAAK,CAAC5E,IAAI,EAAE;AACjD,UAAA;AACJ,QAAA;AAEA,QAAA,MAAM6E,eAAe,GAAGtG,IAAI,CAACqG,KAAK,CAAC5E,IAAI;AAEvC,QAAA,KAAK,MAAME,SAAS,IAAI2E,eAAe,CAAC7E,IAAI,EAAE;AAC1C,UAAA,IAAIE,SAAS,CAACjD,IAAI,KAAKmH,cAAc,CAACU,mBAAmB,EAAE;AACvD,YAAA;AACJ,UAAA;UAEA,MAAM;AAACxE,YAAAA;AAAU,WAAC,GAAGJ,SAAS;AAE9B,UAAA,IAAII,UAAU,CAACrD,IAAI,KAAKmH,cAAc,CAACW,oBAAoB,IAAIzE,UAAU,CAAC0E,QAAQ,KAAK,GAAG,EAAE;AACxF,YAAA;AACJ,UAAA;UAEA,MAAM;YAACC,IAAI;AAAEC,YAAAA;AAAK,WAAC,GAAG5E,UAAU;AAEhC,UAAA,IACI2E,IAAI,CAAChI,IAAI,KAAKmH,cAAc,CAACD,gBAAgB,IAC1Cc,IAAI,CAACtG,QAAQ,CAAC1B,IAAI,KAAKmH,cAAc,CAACC,UAAU,EACrD;AACE,YAAA;AACJ,UAAA;UAEA,IAAIY,IAAI,CAACE,MAAM,CAAClI,IAAI,KAAKmH,cAAc,CAACgB,cAAc,EAAE;AACpD,YAAA;AACJ,UAAA;AAEA,UAAA,IAAIF,KAAK,CAACjI,IAAI,KAAKmH,cAAc,CAACE,cAAc,EAAE;AAC9C,YAAA;AACJ,UAAA;UAEA,MAAM;AAACE,YAAAA;AAAM,WAAC,GAAGU,KAAK;AAEtB,UAAA,IAAIV,MAAM,CAACvH,IAAI,KAAKmH,cAAc,CAACD,gBAAgB,EAAE;AACjD,YAAA;AACJ,UAAA;UAEA,IACIK,MAAM,CAACW,MAAM,CAAClI,IAAI,KAAKmH,cAAc,CAACD,gBAAgB,IACnDK,MAAM,CAACW,MAAM,CAACA,MAAM,CAAClI,IAAI,KAAKmH,cAAc,CAACgB,cAAc,IAC3DZ,MAAM,CAACW,MAAM,CAACxG,QAAQ,CAAC1B,IAAI,KAAKmH,cAAc,CAACC,UAAU,IACzDG,MAAM,CAACW,MAAM,CAACxG,QAAQ,CAACzC,IAAI,KAAK+I,IAAI,CAACtG,QAAQ,CAACzC,IAAI,EACvD;AACE,YAAA;AACJ,UAAA;AAEA,UAAA,IACIsI,MAAM,CAAC7F,QAAQ,CAAC1B,IAAI,KAAKmH,cAAc,CAACC,UAAU,IAC/CG,MAAM,CAAC7F,QAAQ,CAACzC,IAAI,KAAK,MAAM,EACpC;AACE,YAAA;AACJ,UAAA;AAEA,UAAA,IAAIgJ,KAAK,CAAC1E,SAAS,CAACC,MAAM,KAAK,CAAC,EAAE;AAC9B,YAAA;AACJ,UAAA;UAEA,MAAM4E,QAAQ,GAAGC,gBAAgB,CAACJ,KAAK,CAAC1E,SAAS,CAAC,CAAC,CAAwB,CAAC;AAE5E,UAAA,IAAI6E,QAAQ,CAACpI,IAAI,KAAKmH,cAAc,CAACgB,cAAc,EAAE;AACjD,YAAA;AACJ,UAAA;UAEAxB,wBAAwB,CAACqB,IAAI,CAACtG,QAAQ,CAACzC,IAAI,EAAEoE,UAAU,CAAC;AAC5D,QAAA;AACJ,MAAA;KACH;AAED,IAAA,OAAO4D,SAAS;AACpB,EAAA;AACJ,CAAC;;;;"}
|
package/dist/index.js
CHANGED
|
@@ -2155,7 +2155,7 @@ const componentFileStructure = createRule$b({
|
|
|
2155
2155
|
if (isComponentExport(statement, componentName) || isDefaultComponentExport(statement, componentName)) {
|
|
2156
2156
|
return 6;
|
|
2157
2157
|
}
|
|
2158
|
-
if (
|
|
2158
|
+
if (isNonPropsTypeDeclaration(statement) && statement.range[0] < componentInfo.statement.range[0]) {
|
|
2159
2159
|
return 2;
|
|
2160
2160
|
}
|
|
2161
2161
|
if (isStyledDeclaration(statement) || isStyledFactoryDeclaration(statement) || isNonPropsTypeDeclaration(statement)) {
|
|
@@ -3883,6 +3883,64 @@ const noUnboundMethod = createRule$4({
|
|
|
3883
3883
|
const reportCache = new Map();
|
|
3884
3884
|
const aliasCache = new Map();
|
|
3885
3885
|
const memberSymbolCache = new Map();
|
|
3886
|
+
const classAutoBindCache = new WeakMap();
|
|
3887
|
+
const isAutoBindOption = node => {
|
|
3888
|
+
if (!ts__default.default.isObjectLiteralExpression(node)) {
|
|
3889
|
+
return false;
|
|
3890
|
+
}
|
|
3891
|
+
return node.properties.some(property => {
|
|
3892
|
+
if (!ts__default.default.isPropertyAssignment(property)) {
|
|
3893
|
+
return false;
|
|
3894
|
+
}
|
|
3895
|
+
const name = ts__default.default.isIdentifier(property.name) ? property.name.text : ts__default.default.isStringLiteral(property.name) ? property.name.text : null;
|
|
3896
|
+
if (name !== 'autoBind') {
|
|
3897
|
+
return false;
|
|
3898
|
+
}
|
|
3899
|
+
return property.initializer.kind === ts__default.default.SyntaxKind.TrueKeyword;
|
|
3900
|
+
});
|
|
3901
|
+
};
|
|
3902
|
+
const isMakeAutoObservableCallee = node => {
|
|
3903
|
+
if (ts__default.default.isIdentifier(node)) {
|
|
3904
|
+
return node.text === 'makeAutoObservable';
|
|
3905
|
+
}
|
|
3906
|
+
return ts__default.default.isPropertyAccessExpression(node) && node.name.text === 'makeAutoObservable';
|
|
3907
|
+
};
|
|
3908
|
+
const hasAutoBindInConstructor = classDecl => {
|
|
3909
|
+
const cached = classAutoBindCache.get(classDecl);
|
|
3910
|
+
if (cached !== undefined) {
|
|
3911
|
+
return cached;
|
|
3912
|
+
}
|
|
3913
|
+
const ctor = classDecl.members.find(member => ts__default.default.isConstructorDeclaration(member));
|
|
3914
|
+
if (!ctor?.body) {
|
|
3915
|
+
classAutoBindCache.set(classDecl, false);
|
|
3916
|
+
return false;
|
|
3917
|
+
}
|
|
3918
|
+
for (const statement of ctor.body.statements) {
|
|
3919
|
+
if (!ts__default.default.isExpressionStatement(statement)) {
|
|
3920
|
+
continue;
|
|
3921
|
+
}
|
|
3922
|
+
const expr = statement.expression;
|
|
3923
|
+
if (!ts__default.default.isCallExpression(expr)) {
|
|
3924
|
+
continue;
|
|
3925
|
+
}
|
|
3926
|
+
if (!isMakeAutoObservableCallee(expr.expression)) {
|
|
3927
|
+
continue;
|
|
3928
|
+
}
|
|
3929
|
+
if (expr.arguments.length < 2) {
|
|
3930
|
+
continue;
|
|
3931
|
+
}
|
|
3932
|
+
if (expr.arguments[0].kind !== ts__default.default.SyntaxKind.ThisKeyword) {
|
|
3933
|
+
continue;
|
|
3934
|
+
}
|
|
3935
|
+
const hasAutoBind = expr.arguments.slice(1).some(arg => isAutoBindOption(arg));
|
|
3936
|
+
if (hasAutoBind) {
|
|
3937
|
+
classAutoBindCache.set(classDecl, true);
|
|
3938
|
+
return true;
|
|
3939
|
+
}
|
|
3940
|
+
}
|
|
3941
|
+
classAutoBindCache.set(classDecl, false);
|
|
3942
|
+
return false;
|
|
3943
|
+
};
|
|
3886
3944
|
const resolveSymbol = symbol => {
|
|
3887
3945
|
const cached = aliasCache.get(symbol);
|
|
3888
3946
|
if (cached) {
|
|
@@ -3917,6 +3975,7 @@ const noUnboundMethod = createRule$4({
|
|
|
3917
3975
|
return Boolean(name && decoratorNames.has(name));
|
|
3918
3976
|
}));
|
|
3919
3977
|
const info = {
|
|
3978
|
+
autoBind: hasAutoBindInConstructor(methodDecl.parent),
|
|
3920
3979
|
hasDecorator,
|
|
3921
3980
|
isStatic,
|
|
3922
3981
|
usesThis: methodUsesThis(methodDecl)
|
|
@@ -3935,7 +3994,7 @@ const noUnboundMethod = createRule$4({
|
|
|
3935
3994
|
reportCache.set(aliased, false);
|
|
3936
3995
|
return false;
|
|
3937
3996
|
}
|
|
3938
|
-
const shouldReport = !info.isStatic && info.usesThis && !info.hasDecorator;
|
|
3997
|
+
const shouldReport = !info.autoBind && !info.isStatic && info.usesThis && !info.hasDecorator;
|
|
3939
3998
|
reportCache.set(aliased, shouldReport);
|
|
3940
3999
|
return shouldReport;
|
|
3941
4000
|
};
|