eslint-plugin-jsdoc 63.0.9 → 63.0.11
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/WarnSettings.cjs +1 -8
- package/dist/WarnSettings.cjs.map +1 -1
- package/dist/alignTransform.cjs +6 -10
- package/dist/alignTransform.cjs.map +1 -1
- package/dist/buildForbidRuleDefinition.cjs +3 -10
- package/dist/buildForbidRuleDefinition.cjs.map +1 -1
- package/dist/buildRejectOrPreferRuleDefinition.cjs +7 -14
- package/dist/buildRejectOrPreferRuleDefinition.cjs.map +1 -1
- package/dist/defaultTagOrder.cjs +1 -8
- package/dist/defaultTagOrder.cjs.map +1 -1
- package/dist/exportParser.cjs +6 -14
- package/dist/exportParser.cjs.map +1 -1
- package/dist/generateDocs.cjs +36 -44
- package/dist/generateDocs.cjs.map +1 -1
- package/dist/generateOptions.cjs +15 -18
- package/dist/generateOptions.cjs.map +1 -1
- package/dist/generateRule.cjs +24 -24
- package/dist/generateRule.cjs.map +1 -1
- package/dist/generateRuleTypes.cjs +6 -9
- package/dist/generateRuleTypes.cjs.map +1 -1
- package/dist/getDefaultTagStructureForMode.cjs +1 -8
- package/dist/getDefaultTagStructureForMode.cjs.map +1 -1
- package/dist/getJsdocProcessorPlugin.cjs +20 -28
- package/dist/getJsdocProcessorPlugin.cjs.map +1 -1
- package/dist/index-cjs.cjs +152 -159
- package/dist/index-cjs.cjs.map +1 -1
- package/dist/index-esm.cjs +16 -27
- package/dist/index-esm.cjs.map +1 -1
- package/dist/index.cjs +159 -172
- package/dist/index.cjs.map +1 -1
- package/dist/iterateJsdoc.cjs +22 -32
- package/dist/iterateJsdoc.cjs.map +1 -1
- package/dist/jsdocUtils.cjs +18 -86
- package/dist/jsdocUtils.cjs.map +1 -1
- package/dist/rules/checkAccess.cjs +2 -10
- package/dist/rules/checkAccess.cjs.map +1 -1
- package/dist/rules/checkAlignment.cjs +2 -10
- package/dist/rules/checkAlignment.cjs.map +1 -1
- package/dist/rules/checkExamples.cjs +6 -15
- package/dist/rules/checkExamples.cjs.map +1 -1
- package/dist/rules/checkIndentation.cjs +2 -9
- package/dist/rules/checkIndentation.cjs.map +1 -1
- package/dist/rules/checkLineAlignment.cjs +6 -14
- package/dist/rules/checkLineAlignment.cjs.map +1 -1
- package/dist/rules/checkParamNames.cjs +2 -9
- package/dist/rules/checkParamNames.cjs.map +1 -1
- package/dist/rules/checkPropertyNames.cjs +2 -9
- package/dist/rules/checkPropertyNames.cjs.map +1 -1
- package/dist/rules/checkSyntax.cjs +2 -10
- package/dist/rules/checkSyntax.cjs.map +1 -1
- package/dist/rules/checkTagNames.cjs +4 -11
- package/dist/rules/checkTagNames.cjs.map +1 -1
- package/dist/rules/checkTemplateNames.cjs +12 -21
- package/dist/rules/checkTemplateNames.cjs.map +1 -1
- package/dist/rules/checkTypes.cjs +4 -10
- package/dist/rules/checkTypes.cjs.map +1 -1
- package/dist/rules/checkValues.cjs +9 -17
- package/dist/rules/checkValues.cjs.map +1 -1
- package/dist/rules/convertToJsdocComments.cjs +13 -19
- package/dist/rules/convertToJsdocComments.cjs.map +1 -1
- package/dist/rules/emptyTags.cjs +2 -10
- package/dist/rules/emptyTags.cjs.map +1 -1
- package/dist/rules/escapeInlineTags.cjs +96 -42
- package/dist/rules/escapeInlineTags.cjs.map +1 -1
- package/dist/rules/implementsOnClasses.cjs +2 -10
- package/dist/rules/implementsOnClasses.cjs.map +1 -1
- package/dist/rules/importsAsDependencies.cjs +12 -20
- package/dist/rules/importsAsDependencies.cjs.map +1 -1
- package/dist/rules/informativeDocs.cjs +4 -12
- package/dist/rules/informativeDocs.cjs.map +1 -1
- package/dist/rules/linesBeforeBlock.cjs +2 -9
- package/dist/rules/linesBeforeBlock.cjs.map +1 -1
- package/dist/rules/matchDescription.cjs +2 -9
- package/dist/rules/matchDescription.cjs.map +1 -1
- package/dist/rules/matchName.cjs +2 -10
- package/dist/rules/matchName.cjs.map +1 -1
- package/dist/rules/multilineBlocks.cjs +2 -9
- package/dist/rules/multilineBlocks.cjs.map +1 -1
- package/dist/rules/noBadBlocks.cjs +4 -11
- package/dist/rules/noBadBlocks.cjs.map +1 -1
- package/dist/rules/noBlankBlockDescriptions.cjs +2 -10
- package/dist/rules/noBlankBlockDescriptions.cjs.map +1 -1
- package/dist/rules/noBlankBlocks.cjs +2 -10
- package/dist/rules/noBlankBlocks.cjs.map +1 -1
- package/dist/rules/noDefaults.cjs +2 -10
- package/dist/rules/noDefaults.cjs.map +1 -1
- package/dist/rules/noMissingSyntax.cjs +2 -9
- package/dist/rules/noMissingSyntax.cjs.map +1 -1
- package/dist/rules/noMultiAsterisks.cjs +2 -10
- package/dist/rules/noMultiAsterisks.cjs.map +1 -1
- package/dist/rules/noRestrictedSyntax.cjs +2 -9
- package/dist/rules/noRestrictedSyntax.cjs.map +1 -1
- package/dist/rules/noTypes.cjs +2 -9
- package/dist/rules/noTypes.cjs.map +1 -1
- package/dist/rules/noUndefinedTypes.cjs +13 -21
- package/dist/rules/noUndefinedTypes.cjs.map +1 -1
- package/dist/rules/preferImportTag.cjs +21 -28
- package/dist/rules/preferImportTag.cjs.map +1 -1
- package/dist/rules/requireAsteriskPrefix.cjs +2 -10
- package/dist/rules/requireAsteriskPrefix.cjs.map +1 -1
- package/dist/rules/requireDescription.cjs +2 -9
- package/dist/rules/requireDescription.cjs.map +1 -1
- package/dist/rules/requireDescriptionCompleteSentence.cjs +7 -15
- package/dist/rules/requireDescriptionCompleteSentence.cjs.map +1 -1
- package/dist/rules/requireExample.cjs +2 -10
- package/dist/rules/requireExample.cjs.map +1 -1
- package/dist/rules/requireFileOverview.cjs +2 -10
- package/dist/rules/requireFileOverview.cjs.map +1 -1
- package/dist/rules/requireHyphenBeforeParamDescription.cjs +2 -10
- package/dist/rules/requireHyphenBeforeParamDescription.cjs.map +1 -1
- package/dist/rules/requireJsdoc.cjs +17 -25
- package/dist/rules/requireJsdoc.cjs.map +1 -1
- package/dist/rules/requireParam.cjs +2 -9
- package/dist/rules/requireParam.cjs.map +1 -1
- package/dist/rules/requireParamDescription.cjs +2 -10
- package/dist/rules/requireParamDescription.cjs.map +1 -1
- package/dist/rules/requireParamName.cjs +2 -10
- package/dist/rules/requireParamName.cjs.map +1 -1
- package/dist/rules/requireParamType.cjs +2 -10
- package/dist/rules/requireParamType.cjs.map +1 -1
- package/dist/rules/requireProperty.cjs +2 -10
- package/dist/rules/requireProperty.cjs.map +1 -1
- package/dist/rules/requirePropertyDescription.cjs +2 -10
- package/dist/rules/requirePropertyDescription.cjs.map +1 -1
- package/dist/rules/requirePropertyName.cjs +2 -10
- package/dist/rules/requirePropertyName.cjs.map +1 -1
- package/dist/rules/requirePropertyType.cjs +2 -10
- package/dist/rules/requirePropertyType.cjs.map +1 -1
- package/dist/rules/requireRejects.cjs +2 -9
- package/dist/rules/requireRejects.cjs.map +1 -1
- package/dist/rules/requireReturns.cjs +4 -11
- package/dist/rules/requireReturns.cjs.map +1 -1
- package/dist/rules/requireReturnsCheck.cjs +8 -15
- package/dist/rules/requireReturnsCheck.cjs.map +1 -1
- package/dist/rules/requireReturnsDescription.cjs +2 -10
- package/dist/rules/requireReturnsDescription.cjs.map +1 -1
- package/dist/rules/requireReturnsType.cjs +2 -10
- package/dist/rules/requireReturnsType.cjs.map +1 -1
- package/dist/rules/requireTags.cjs +2 -9
- package/dist/rules/requireTags.cjs.map +1 -1
- package/dist/rules/requireTemplate.cjs +5 -13
- package/dist/rules/requireTemplate.cjs.map +1 -1
- package/dist/rules/requireThrows.cjs +2 -9
- package/dist/rules/requireThrows.cjs.map +1 -1
- package/dist/rules/requireYields.cjs +2 -9
- package/dist/rules/requireYields.cjs.map +1 -1
- package/dist/rules/requireYieldsCheck.cjs +2 -9
- package/dist/rules/requireYieldsCheck.cjs.map +1 -1
- package/dist/rules/sortTags.cjs +4 -12
- package/dist/rules/sortTags.cjs.map +1 -1
- package/dist/rules/tagLines.cjs +2 -9
- package/dist/rules/tagLines.cjs.map +1 -1
- package/dist/rules/textEscaping.cjs +2 -9
- package/dist/rules/textEscaping.cjs.map +1 -1
- package/dist/rules/tsMethodSignatureStyle.cjs +10 -18
- package/dist/rules/tsMethodSignatureStyle.cjs.map +1 -1
- package/dist/rules/tsNoEmptyObjectType.cjs +5 -13
- package/dist/rules/tsNoEmptyObjectType.cjs.map +1 -1
- package/dist/rules/tsNoUnnecessaryTemplateExpression.cjs +8 -16
- package/dist/rules/tsNoUnnecessaryTemplateExpression.cjs.map +1 -1
- package/dist/rules/tsPreferFunctionType.cjs +8 -16
- package/dist/rules/tsPreferFunctionType.cjs.map +1 -1
- package/dist/rules/typeFormatting.cjs +9 -17
- package/dist/rules/typeFormatting.cjs.map +1 -1
- package/dist/rules/validTypes.cjs +10 -18
- package/dist/rules/validTypes.cjs.map +1 -1
- package/dist/tagNames.cjs +4 -9
- package/dist/tagNames.cjs.map +1 -1
- package/dist/utils/hasReturnValue.cjs +1 -8
- package/dist/utils/hasReturnValue.cjs.map +1 -1
- package/package.json +21 -21
- package/src/rules/checkTemplateNames.js +0 -1
- package/src/rules/escapeInlineTags.js +142 -45
- package/src/rules/requireJsdoc.js +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"hasReturnValue.cjs","names":["isNewPromiseExpression","node","type","callee","name","isVoidPromise","typeArguments","params","typeParameters","undefinedKeywords","Set","hasReturnValue","throwOnNullReturn","promFilter","expression","body","some","bodyNode","consequent","alternate","value","argument","Error","cases","someCase","nde","block","handler","finalizer","returnType","typeAnnotation","has","exports","allBrancheshaveReturnValues","lastBodyNode","slice","test","every","consNode","error","message","hasNonEmptyResolverCall","resolverName","elements","element","left","right","arguments","length","undefined","decorators","decorator","computed","key","source","object","property","properties","expressions","subExpression","quasi","declarations","id","init","hasValueOrExecutorHasNonEmptyResolveValue","anyPromiseAsReturn","allBranches","hasReturnMethod","promiseFilter","hasReturn","Boolean","prom"],"sources":["../../src/utils/hasReturnValue.js"],"sourcesContent":["/**\n * @typedef {import('estree').Node|\n * import('@typescript-eslint/types').TSESTree.Node} ESTreeOrTypeScriptNode\n */\n\n/**\n * Checks if a node is a promise but has no resolve value or an empty value.\n * An `undefined` resolve does not count.\n * @param {ESTreeOrTypeScriptNode|undefined|null} node\n * @returns {boolean|undefined|null}\n */\nconst isNewPromiseExpression = (node) => {\n return node && node.type === 'NewExpression' && node.callee.type === 'Identifier' &&\n node.callee.name === 'Promise';\n};\n\n/**\n * @param {ESTreeOrTypeScriptNode|null|undefined} node\n * @returns {boolean}\n */\nconst isVoidPromise = (node) => {\n return /** @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} */ (node)?.typeArguments?.params?.[0]?.type === 'TSVoidKeyword'\n /* c8 ignore next 5 */\n // eslint-disable-next-line @stylistic/operator-linebreak -- c8\n || /** @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} */ (\n node\n // @ts-expect-error Ok\n )?.typeParameters?.params?.[0]?.type === 'TSVoidKeyword';\n};\n\nconst undefinedKeywords = new Set([\n 'TSNeverKeyword', 'TSUndefinedKeyword', 'TSVoidKeyword',\n]);\n\n/**\n * Checks if a node has a return statement. Void return does not count.\n * @param {ESTreeOrTypeScriptNode|undefined|null} node\n * @param {boolean} [throwOnNullReturn]\n * @param {PromiseFilter} [promFilter]\n * @returns {boolean|undefined}\n */\n// eslint-disable-next-line complexity\nconst hasReturnValue = (node, throwOnNullReturn, promFilter) => {\n if (!node) {\n return false;\n }\n\n switch (node.type) {\n case 'ArrowFunctionExpression':\n case 'FunctionDeclaration':\n case 'FunctionExpression': {\n return 'expression' in node && node.expression && (!isNewPromiseExpression(\n node.body,\n ) || !isVoidPromise(node.body)) ||\n hasReturnValue(node.body, throwOnNullReturn, promFilter);\n }\n\n case 'BlockStatement': {\n return node.body.some((bodyNode) => {\n return bodyNode.type !== 'FunctionDeclaration' && hasReturnValue(bodyNode, throwOnNullReturn, promFilter);\n });\n }\n\n case 'DoWhileStatement':\n case 'ForInStatement':\n case 'ForOfStatement':\n\n case 'ForStatement':\n\n case 'LabeledStatement':\n case 'WhileStatement':\n case 'WithStatement': {\n return hasReturnValue(node.body, throwOnNullReturn, promFilter);\n }\n\n case 'IfStatement': {\n return hasReturnValue(node.consequent, throwOnNullReturn, promFilter) ||\n hasReturnValue(node.alternate, throwOnNullReturn, promFilter);\n }\n\n case 'MethodDefinition':\n return hasReturnValue(node.value, throwOnNullReturn, promFilter);\n case 'ReturnStatement': {\n // void return does not count.\n if (node.argument === null) {\n if (throwOnNullReturn) {\n throw new Error('Null return');\n }\n\n return false;\n }\n\n if (promFilter && isNewPromiseExpression(node.argument)) {\n // Let caller decide how to filter, but this is, at the least,\n // a return of sorts and truthy\n return promFilter(node.argument);\n }\n\n return true;\n }\n\n case 'SwitchStatement': {\n return node.cases.some(\n (someCase) => {\n return someCase.consequent.some((nde) => {\n return hasReturnValue(nde, throwOnNullReturn, promFilter);\n });\n },\n );\n }\n\n case 'TryStatement': {\n return hasReturnValue(node.block, throwOnNullReturn, promFilter) ||\n hasReturnValue(node.handler && node.handler.body, throwOnNullReturn, promFilter) ||\n hasReturnValue(node.finalizer, throwOnNullReturn, promFilter);\n }\n\n case 'TSDeclareFunction':\n\n case 'TSFunctionType':\n\n case 'TSMethodSignature': {\n const type = node?.returnType?.typeAnnotation?.type;\n return type && !undefinedKeywords.has(type);\n }\n\n default: {\n return false;\n }\n }\n};\n\n/**\n * Checks if a node has a return statement. Void return does not count.\n * @param {ESTreeOrTypeScriptNode|null|undefined} node\n * @param {PromiseFilter} promFilter\n * @returns {undefined|boolean|ESTreeOrTypeScriptNode}\n */\n// eslint-disable-next-line complexity\nconst allBrancheshaveReturnValues = (node, promFilter) => {\n if (!node) {\n return false;\n }\n\n switch (node.type) {\n // case 'MethodDefinition':\n // return allBrancheshaveReturnValues(node.value, promFilter);\n case 'ArrowFunctionExpression':\n case 'FunctionDeclaration':\n case 'FunctionExpression': {\n return 'expression' in node && node.expression && (!isNewPromiseExpression(node.body) || !isVoidPromise(node.body)) ||\n allBrancheshaveReturnValues(node.body, promFilter) ||\n /** @type {import('@typescript-eslint/types').TSESTree.BlockStatement} */\n (node.body).body.some((nde) => {\n return nde.type === 'ReturnStatement';\n });\n }\n\n case 'BlockStatement': {\n const lastBodyNode = node.body.slice(-1)[0];\n return allBrancheshaveReturnValues(lastBodyNode, promFilter);\n }\n\n case 'DoWhileStatement':\n case 'WhileStatement':\n if (\n /**\n * @type {import('@typescript-eslint/types').TSESTree.Literal}\n */\n (node.test).value === true\n ) {\n // If this is an infinite loop, we assume only one branch\n // is needed to provide a return\n return hasReturnValue(node.body, false, promFilter);\n }\n\n // Fallthrough\n case 'ForStatement':\n if (node.test === null) {\n // If this is an infinite loop, we assume only one branch\n // is needed to provide a return\n return hasReturnValue(node.body, false, promFilter);\n }\n\n case 'ForInStatement':\n case 'ForOfStatement':\n\n case 'LabeledStatement':\n\n case 'WithStatement': {\n return allBrancheshaveReturnValues(node.body, promFilter);\n }\n\n case 'IfStatement': {\n return allBrancheshaveReturnValues(node.consequent, promFilter) &&\n allBrancheshaveReturnValues(node.alternate, promFilter);\n }\n\n case 'ReturnStatement': {\n // void return does not count.\n if (node.argument === null) {\n return false;\n }\n\n if (promFilter && isNewPromiseExpression(node.argument)) {\n // Let caller decide how to filter, but this is, at the least,\n // a return of sorts and truthy\n return promFilter(node.argument);\n }\n\n return true;\n }\n\n case 'SwitchStatement': {\n return /** @type {import('@typescript-eslint/types').TSESTree.SwitchStatement} */ (node).cases.every(\n (someCase) => {\n return !someCase.consequent.some((consNode) => {\n return consNode.type === 'BreakStatement' ||\n consNode.type === 'ReturnStatement' && consNode.argument === null;\n });\n },\n );\n }\n\n case 'ThrowStatement': {\n return true;\n }\n\n case 'TryStatement': {\n // If `finally` returns, all return\n return node.finalizer && allBrancheshaveReturnValues(node.finalizer, promFilter) ||\n // Return in `try`/`catch` may still occur despite `finally`\n allBrancheshaveReturnValues(node.block, promFilter) &&\n (!node.handler ||\n allBrancheshaveReturnValues(node.handler && node.handler.body, promFilter)) &&\n (!node.finalizer || (() => {\n try {\n hasReturnValue(node.finalizer, true, promFilter);\n } catch (error) {\n if (/** @type {Error} */ (error).message === 'Null return') {\n return false;\n }\n /* c8 ignore next 3 */\n // eslint-disable-next-line @stylistic/padding-line-between-statements -- c8\n throw error;\n }\n\n // As long as not an explicit empty return, then return true\n return true;\n })());\n }\n\n case 'TSDeclareFunction':\n\n case 'TSFunctionType':\n\n case 'TSMethodSignature': {\n const type = node?.returnType?.typeAnnotation?.type;\n return type && !undefinedKeywords.has(type);\n }\n\n default: {\n return false;\n }\n }\n};\n\n/**\n * @callback PromiseFilter\n * @param {ESTreeOrTypeScriptNode|undefined} node\n * @returns {boolean}\n */\n\n/**\n * Avoids further checking child nodes if a nested function shadows the\n * resolver, but otherwise, if name is used (by call or passed in as an\n * argument to another function), will be considered as non-empty.\n *\n * This could check for redeclaration of the resolver, but as such is\n * unlikely, we avoid the performance cost of checking everywhere for\n * (re)declarations or assignments.\n * @param {import('@typescript-eslint/types').TSESTree.Node|null|undefined} node\n * @param {string} resolverName\n * @returns {boolean}\n */\n// eslint-disable-next-line complexity\nconst hasNonEmptyResolverCall = (node, resolverName) => {\n if (!node) {\n return false;\n }\n\n // Arrow function without block\n switch (node.type) {\n case 'ArrayExpression':\n case 'ArrayPattern':\n return node.elements.some((element) => {\n return hasNonEmptyResolverCall(element, resolverName);\n });\n case 'ArrowFunctionExpression':\n case 'FunctionDeclaration':\n case 'FunctionExpression': {\n // Shadowing\n if (/** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n node.params[0]\n )?.name === resolverName) {\n return false;\n }\n\n return hasNonEmptyResolverCall(node.body, resolverName);\n }\n\n case 'AssignmentExpression':\n case 'BinaryExpression':\n case 'LogicalExpression': {\n return hasNonEmptyResolverCall(node.left, resolverName) ||\n hasNonEmptyResolverCall(node.right, resolverName);\n }\n\n case 'AssignmentPattern':\n return hasNonEmptyResolverCall(node.right, resolverName);\n case 'AwaitExpression':\n\n case 'SpreadElement':\n case 'UnaryExpression':\n case 'YieldExpression':\n return hasNonEmptyResolverCall(node.argument, resolverName);\n case 'BlockStatement':\n case 'ClassBody':\n return node.body.some((bodyNode) => {\n return hasNonEmptyResolverCall(bodyNode, resolverName);\n });\n /* c8 ignore next 2 -- In Babel? */\n case 'CallExpression':\n // @ts-expect-error Babel?\n case 'OptionalCallExpression':\n return /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n node.callee\n ).name === resolverName && (\n\n // Implicit or explicit undefined\n node.arguments.length > 1 || node.arguments[0] !== undefined\n ) ||\n node.arguments.some((nde) => {\n // Being passed in to another function (which might invoke it)\n return nde.type === 'Identifier' && nde.name === resolverName ||\n\n // Handle nested items\n hasNonEmptyResolverCall(nde, resolverName);\n });\n\n case 'ChainExpression':\n case 'Decorator':\n\n case 'ExpressionStatement':\n return hasNonEmptyResolverCall(node.expression, resolverName);\n\n case 'ClassDeclaration':\n\n case 'ClassExpression':\n return hasNonEmptyResolverCall(node.body, resolverName);\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error Babel?\n case 'ClassMethod':\n\n case 'MethodDefinition':\n return node.decorators && node.decorators.some((decorator) => {\n return hasNonEmptyResolverCall(decorator, resolverName);\n }) ||\n node.computed && hasNonEmptyResolverCall(node.key, resolverName) ||\n hasNonEmptyResolverCall(node.value, resolverName);\n\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error Babel?\n case 'ClassProperty':\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error Babel?\n case 'ObjectProperty':\n case 'Property':\n\n case 'PropertyDefinition':\n return node.computed && hasNonEmptyResolverCall(node.key, resolverName) ||\n hasNonEmptyResolverCall(node.value, resolverName);\n case 'ConditionalExpression':\n\n case 'IfStatement': {\n return hasNonEmptyResolverCall(node.test, resolverName) ||\n hasNonEmptyResolverCall(node.consequent, resolverName) ||\n hasNonEmptyResolverCall(node.alternate, resolverName);\n }\n\n case 'DoWhileStatement':\n case 'ForInStatement':\n case 'ForOfStatement':\n\n case 'ForStatement':\n case 'LabeledStatement':\n case 'WhileStatement':\n case 'WithStatement': {\n return hasNonEmptyResolverCall(node.body, resolverName);\n }\n\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error Babel?\n case 'Import':\n\n case 'ImportExpression':\n return hasNonEmptyResolverCall(node.source, resolverName);\n // ?.\n /* c8 ignore next 2 -- In Babel? */\n case 'MemberExpression':\n\n // @ts-expect-error Babel?\n case 'OptionalMemberExpression':\n return hasNonEmptyResolverCall(node.object, resolverName) ||\n hasNonEmptyResolverCall(node.property, resolverName);\n case 'ObjectExpression':\n case 'ObjectPattern':\n return node.properties.some((property) => {\n return hasNonEmptyResolverCall(property, resolverName);\n });\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error Babel?\n case 'ObjectMethod':\n /* c8 ignore next 6 -- In Babel? */\n // @ts-expect-error\n return node.computed && hasNonEmptyResolverCall(node.key, resolverName) ||\n // @ts-expect-error\n node.arguments.some((nde) => {\n return hasNonEmptyResolverCall(nde, resolverName);\n });\n\n case 'ReturnStatement': {\n if (node.argument === null) {\n return false;\n }\n\n return hasNonEmptyResolverCall(node.argument, resolverName);\n }\n\n // Comma\n case 'SequenceExpression':\n\n case 'TemplateLiteral':\n return node.expressions.some((subExpression) => {\n return hasNonEmptyResolverCall(subExpression, resolverName);\n });\n\n case 'SwitchStatement': {\n return node.cases.some(\n (someCase) => {\n return someCase.consequent.some((nde) => {\n return hasNonEmptyResolverCall(nde, resolverName);\n });\n },\n );\n }\n\n case 'TaggedTemplateExpression':\n return hasNonEmptyResolverCall(node.quasi, resolverName);\n\n case 'TryStatement': {\n return hasNonEmptyResolverCall(node.block, resolverName) ||\n hasNonEmptyResolverCall(node.handler && node.handler.body, resolverName) ||\n hasNonEmptyResolverCall(node.finalizer, resolverName);\n }\n\n case 'VariableDeclaration': {\n return node.declarations.some((nde) => {\n return hasNonEmptyResolverCall(nde, resolverName);\n });\n }\n\n case 'VariableDeclarator': {\n return hasNonEmptyResolverCall(node.id, resolverName) ||\n hasNonEmptyResolverCall(node.init, resolverName);\n }\n\n /*\n // Shouldn't need to parse literals/literal components, etc.\n\n case 'Identifier':\n case 'TemplateElement':\n case 'Super':\n // Exports not relevant in this context\n */\n default:\n return false;\n }\n};\n\n/**\n * Checks if a Promise executor has no resolve value or an empty value.\n * An `undefined` resolve does not count.\n * @param {ESTreeOrTypeScriptNode} node\n * @param {boolean} anyPromiseAsReturn\n * @param {boolean} [allBranches]\n * @returns {boolean}\n */\nconst hasValueOrExecutorHasNonEmptyResolveValue = (node, anyPromiseAsReturn, allBranches) => {\n const hasReturnMethod = allBranches ?\n /**\n * @param {ESTreeOrTypeScriptNode} nde\n * @param {PromiseFilter} promiseFilter\n * @returns {boolean}\n */\n (nde, promiseFilter) => {\n let hasReturn;\n try {\n hasReturn = hasReturnValue(nde, true, promiseFilter);\n } catch (error) {\n // c8 ignore else\n if (/** @type {Error} */ (error).message === 'Null return') {\n return false;\n }\n /* c8 ignore next 3 */\n // eslint-disable-next-line @stylistic/padding-line-between-statements -- c8\n throw error;\n }\n\n // `hasReturn` check needed since `throw` treated as valid return by\n // `allBrancheshaveReturnValues`\n return Boolean(hasReturn && allBrancheshaveReturnValues(nde, promiseFilter));\n } :\n /**\n * @param {ESTreeOrTypeScriptNode} nde\n * @param {PromiseFilter} promiseFilter\n * @returns {boolean}\n */\n (nde, promiseFilter) => {\n return Boolean(hasReturnValue(nde, false, promiseFilter));\n };\n\n return hasReturnMethod(node, (prom) => {\n if (anyPromiseAsReturn) {\n return true;\n }\n\n if (isVoidPromise(prom)) {\n return false;\n }\n\n const {\n body,\n params,\n } =\n /**\n * @type {import('@typescript-eslint/types').TSESTree.FunctionExpression|\n * import('@typescript-eslint/types').TSESTree.ArrowFunctionExpression}\n */ (\n /** @type {import('@typescript-eslint/types').TSESTree.NewExpression} */ (\n prom\n ).arguments[0]\n ) || {};\n\n if (!params?.length) {\n return false;\n }\n\n const {\n name: resolverName,\n } = /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n params[0]\n );\n\n return hasNonEmptyResolverCall(body, resolverName);\n });\n};\n\nexport {\n hasReturnValue,\n hasValueOrExecutorHasNonEmptyResolveValue,\n};\n"],"mappings":"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","ignoreList":[]}
|
|
1
|
+
{"version":3,"file":"hasReturnValue.cjs","names":[],"sources":["../../src/utils/hasReturnValue.js"],"sourcesContent":["/**\n * @typedef {import('estree').Node|\n * import('@typescript-eslint/types').TSESTree.Node} ESTreeOrTypeScriptNode\n */\n\n/**\n * Checks if a node is a promise but has no resolve value or an empty value.\n * An `undefined` resolve does not count.\n * @param {ESTreeOrTypeScriptNode|undefined|null} node\n * @returns {boolean|undefined|null}\n */\nconst isNewPromiseExpression = (node) => {\n return node && node.type === 'NewExpression' && node.callee.type === 'Identifier' &&\n node.callee.name === 'Promise';\n};\n\n/**\n * @param {ESTreeOrTypeScriptNode|null|undefined} node\n * @returns {boolean}\n */\nconst isVoidPromise = (node) => {\n return /** @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} */ (node)?.typeArguments?.params?.[0]?.type === 'TSVoidKeyword'\n /* c8 ignore next 5 */\n // eslint-disable-next-line @stylistic/operator-linebreak -- c8\n || /** @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} */ (\n node\n // @ts-expect-error Ok\n )?.typeParameters?.params?.[0]?.type === 'TSVoidKeyword';\n};\n\nconst undefinedKeywords = new Set([\n 'TSNeverKeyword', 'TSUndefinedKeyword', 'TSVoidKeyword',\n]);\n\n/**\n * Checks if a node has a return statement. Void return does not count.\n * @param {ESTreeOrTypeScriptNode|undefined|null} node\n * @param {boolean} [throwOnNullReturn]\n * @param {PromiseFilter} [promFilter]\n * @returns {boolean|undefined}\n */\n// eslint-disable-next-line complexity\nconst hasReturnValue = (node, throwOnNullReturn, promFilter) => {\n if (!node) {\n return false;\n }\n\n switch (node.type) {\n case 'ArrowFunctionExpression':\n case 'FunctionDeclaration':\n case 'FunctionExpression': {\n return 'expression' in node && node.expression && (!isNewPromiseExpression(\n node.body,\n ) || !isVoidPromise(node.body)) ||\n hasReturnValue(node.body, throwOnNullReturn, promFilter);\n }\n\n case 'BlockStatement': {\n return node.body.some((bodyNode) => {\n return bodyNode.type !== 'FunctionDeclaration' && hasReturnValue(bodyNode, throwOnNullReturn, promFilter);\n });\n }\n\n case 'DoWhileStatement':\n case 'ForInStatement':\n case 'ForOfStatement':\n\n case 'ForStatement':\n\n case 'LabeledStatement':\n case 'WhileStatement':\n case 'WithStatement': {\n return hasReturnValue(node.body, throwOnNullReturn, promFilter);\n }\n\n case 'IfStatement': {\n return hasReturnValue(node.consequent, throwOnNullReturn, promFilter) ||\n hasReturnValue(node.alternate, throwOnNullReturn, promFilter);\n }\n\n case 'MethodDefinition':\n return hasReturnValue(node.value, throwOnNullReturn, promFilter);\n case 'ReturnStatement': {\n // void return does not count.\n if (node.argument === null) {\n if (throwOnNullReturn) {\n throw new Error('Null return');\n }\n\n return false;\n }\n\n if (promFilter && isNewPromiseExpression(node.argument)) {\n // Let caller decide how to filter, but this is, at the least,\n // a return of sorts and truthy\n return promFilter(node.argument);\n }\n\n return true;\n }\n\n case 'SwitchStatement': {\n return node.cases.some(\n (someCase) => {\n return someCase.consequent.some((nde) => {\n return hasReturnValue(nde, throwOnNullReturn, promFilter);\n });\n },\n );\n }\n\n case 'TryStatement': {\n return hasReturnValue(node.block, throwOnNullReturn, promFilter) ||\n hasReturnValue(node.handler && node.handler.body, throwOnNullReturn, promFilter) ||\n hasReturnValue(node.finalizer, throwOnNullReturn, promFilter);\n }\n\n case 'TSDeclareFunction':\n\n case 'TSFunctionType':\n\n case 'TSMethodSignature': {\n const type = node?.returnType?.typeAnnotation?.type;\n return type && !undefinedKeywords.has(type);\n }\n\n default: {\n return false;\n }\n }\n};\n\n/**\n * Checks if a node has a return statement. Void return does not count.\n * @param {ESTreeOrTypeScriptNode|null|undefined} node\n * @param {PromiseFilter} promFilter\n * @returns {undefined|boolean|ESTreeOrTypeScriptNode}\n */\n// eslint-disable-next-line complexity\nconst allBrancheshaveReturnValues = (node, promFilter) => {\n if (!node) {\n return false;\n }\n\n switch (node.type) {\n // case 'MethodDefinition':\n // return allBrancheshaveReturnValues(node.value, promFilter);\n case 'ArrowFunctionExpression':\n case 'FunctionDeclaration':\n case 'FunctionExpression': {\n return 'expression' in node && node.expression && (!isNewPromiseExpression(node.body) || !isVoidPromise(node.body)) ||\n allBrancheshaveReturnValues(node.body, promFilter) ||\n /** @type {import('@typescript-eslint/types').TSESTree.BlockStatement} */\n (node.body).body.some((nde) => {\n return nde.type === 'ReturnStatement';\n });\n }\n\n case 'BlockStatement': {\n const lastBodyNode = node.body.slice(-1)[0];\n return allBrancheshaveReturnValues(lastBodyNode, promFilter);\n }\n\n case 'DoWhileStatement':\n case 'WhileStatement':\n if (\n /**\n * @type {import('@typescript-eslint/types').TSESTree.Literal}\n */\n (node.test).value === true\n ) {\n // If this is an infinite loop, we assume only one branch\n // is needed to provide a return\n return hasReturnValue(node.body, false, promFilter);\n }\n\n // Fallthrough\n case 'ForStatement':\n if (node.test === null) {\n // If this is an infinite loop, we assume only one branch\n // is needed to provide a return\n return hasReturnValue(node.body, false, promFilter);\n }\n\n case 'ForInStatement':\n case 'ForOfStatement':\n\n case 'LabeledStatement':\n\n case 'WithStatement': {\n return allBrancheshaveReturnValues(node.body, promFilter);\n }\n\n case 'IfStatement': {\n return allBrancheshaveReturnValues(node.consequent, promFilter) &&\n allBrancheshaveReturnValues(node.alternate, promFilter);\n }\n\n case 'ReturnStatement': {\n // void return does not count.\n if (node.argument === null) {\n return false;\n }\n\n if (promFilter && isNewPromiseExpression(node.argument)) {\n // Let caller decide how to filter, but this is, at the least,\n // a return of sorts and truthy\n return promFilter(node.argument);\n }\n\n return true;\n }\n\n case 'SwitchStatement': {\n return /** @type {import('@typescript-eslint/types').TSESTree.SwitchStatement} */ (node).cases.every(\n (someCase) => {\n return !someCase.consequent.some((consNode) => {\n return consNode.type === 'BreakStatement' ||\n consNode.type === 'ReturnStatement' && consNode.argument === null;\n });\n },\n );\n }\n\n case 'ThrowStatement': {\n return true;\n }\n\n case 'TryStatement': {\n // If `finally` returns, all return\n return node.finalizer && allBrancheshaveReturnValues(node.finalizer, promFilter) ||\n // Return in `try`/`catch` may still occur despite `finally`\n allBrancheshaveReturnValues(node.block, promFilter) &&\n (!node.handler ||\n allBrancheshaveReturnValues(node.handler && node.handler.body, promFilter)) &&\n (!node.finalizer || (() => {\n try {\n hasReturnValue(node.finalizer, true, promFilter);\n } catch (error) {\n if (/** @type {Error} */ (error).message === 'Null return') {\n return false;\n }\n /* c8 ignore next 3 */\n // eslint-disable-next-line @stylistic/padding-line-between-statements -- c8\n throw error;\n }\n\n // As long as not an explicit empty return, then return true\n return true;\n })());\n }\n\n case 'TSDeclareFunction':\n\n case 'TSFunctionType':\n\n case 'TSMethodSignature': {\n const type = node?.returnType?.typeAnnotation?.type;\n return type && !undefinedKeywords.has(type);\n }\n\n default: {\n return false;\n }\n }\n};\n\n/**\n * @callback PromiseFilter\n * @param {ESTreeOrTypeScriptNode|undefined} node\n * @returns {boolean}\n */\n\n/**\n * Avoids further checking child nodes if a nested function shadows the\n * resolver, but otherwise, if name is used (by call or passed in as an\n * argument to another function), will be considered as non-empty.\n *\n * This could check for redeclaration of the resolver, but as such is\n * unlikely, we avoid the performance cost of checking everywhere for\n * (re)declarations or assignments.\n * @param {import('@typescript-eslint/types').TSESTree.Node|null|undefined} node\n * @param {string} resolverName\n * @returns {boolean}\n */\n// eslint-disable-next-line complexity\nconst hasNonEmptyResolverCall = (node, resolverName) => {\n if (!node) {\n return false;\n }\n\n // Arrow function without block\n switch (node.type) {\n case 'ArrayExpression':\n case 'ArrayPattern':\n return node.elements.some((element) => {\n return hasNonEmptyResolverCall(element, resolverName);\n });\n case 'ArrowFunctionExpression':\n case 'FunctionDeclaration':\n case 'FunctionExpression': {\n // Shadowing\n if (/** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n node.params[0]\n )?.name === resolverName) {\n return false;\n }\n\n return hasNonEmptyResolverCall(node.body, resolverName);\n }\n\n case 'AssignmentExpression':\n case 'BinaryExpression':\n case 'LogicalExpression': {\n return hasNonEmptyResolverCall(node.left, resolverName) ||\n hasNonEmptyResolverCall(node.right, resolverName);\n }\n\n case 'AssignmentPattern':\n return hasNonEmptyResolverCall(node.right, resolverName);\n case 'AwaitExpression':\n\n case 'SpreadElement':\n case 'UnaryExpression':\n case 'YieldExpression':\n return hasNonEmptyResolverCall(node.argument, resolverName);\n case 'BlockStatement':\n case 'ClassBody':\n return node.body.some((bodyNode) => {\n return hasNonEmptyResolverCall(bodyNode, resolverName);\n });\n /* c8 ignore next 2 -- In Babel? */\n case 'CallExpression':\n // @ts-expect-error Babel?\n case 'OptionalCallExpression':\n return /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n node.callee\n ).name === resolverName && (\n\n // Implicit or explicit undefined\n node.arguments.length > 1 || node.arguments[0] !== undefined\n ) ||\n node.arguments.some((nde) => {\n // Being passed in to another function (which might invoke it)\n return nde.type === 'Identifier' && nde.name === resolverName ||\n\n // Handle nested items\n hasNonEmptyResolverCall(nde, resolverName);\n });\n\n case 'ChainExpression':\n case 'Decorator':\n\n case 'ExpressionStatement':\n return hasNonEmptyResolverCall(node.expression, resolverName);\n\n case 'ClassDeclaration':\n\n case 'ClassExpression':\n return hasNonEmptyResolverCall(node.body, resolverName);\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error Babel?\n case 'ClassMethod':\n\n case 'MethodDefinition':\n return node.decorators && node.decorators.some((decorator) => {\n return hasNonEmptyResolverCall(decorator, resolverName);\n }) ||\n node.computed && hasNonEmptyResolverCall(node.key, resolverName) ||\n hasNonEmptyResolverCall(node.value, resolverName);\n\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error Babel?\n case 'ClassProperty':\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error Babel?\n case 'ObjectProperty':\n case 'Property':\n\n case 'PropertyDefinition':\n return node.computed && hasNonEmptyResolverCall(node.key, resolverName) ||\n hasNonEmptyResolverCall(node.value, resolverName);\n case 'ConditionalExpression':\n\n case 'IfStatement': {\n return hasNonEmptyResolverCall(node.test, resolverName) ||\n hasNonEmptyResolverCall(node.consequent, resolverName) ||\n hasNonEmptyResolverCall(node.alternate, resolverName);\n }\n\n case 'DoWhileStatement':\n case 'ForInStatement':\n case 'ForOfStatement':\n\n case 'ForStatement':\n case 'LabeledStatement':\n case 'WhileStatement':\n case 'WithStatement': {\n return hasNonEmptyResolverCall(node.body, resolverName);\n }\n\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error Babel?\n case 'Import':\n\n case 'ImportExpression':\n return hasNonEmptyResolverCall(node.source, resolverName);\n // ?.\n /* c8 ignore next 2 -- In Babel? */\n case 'MemberExpression':\n\n // @ts-expect-error Babel?\n case 'OptionalMemberExpression':\n return hasNonEmptyResolverCall(node.object, resolverName) ||\n hasNonEmptyResolverCall(node.property, resolverName);\n case 'ObjectExpression':\n case 'ObjectPattern':\n return node.properties.some((property) => {\n return hasNonEmptyResolverCall(property, resolverName);\n });\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error Babel?\n case 'ObjectMethod':\n /* c8 ignore next 6 -- In Babel? */\n // @ts-expect-error\n return node.computed && hasNonEmptyResolverCall(node.key, resolverName) ||\n // @ts-expect-error\n node.arguments.some((nde) => {\n return hasNonEmptyResolverCall(nde, resolverName);\n });\n\n case 'ReturnStatement': {\n if (node.argument === null) {\n return false;\n }\n\n return hasNonEmptyResolverCall(node.argument, resolverName);\n }\n\n // Comma\n case 'SequenceExpression':\n\n case 'TemplateLiteral':\n return node.expressions.some((subExpression) => {\n return hasNonEmptyResolverCall(subExpression, resolverName);\n });\n\n case 'SwitchStatement': {\n return node.cases.some(\n (someCase) => {\n return someCase.consequent.some((nde) => {\n return hasNonEmptyResolverCall(nde, resolverName);\n });\n },\n );\n }\n\n case 'TaggedTemplateExpression':\n return hasNonEmptyResolverCall(node.quasi, resolverName);\n\n case 'TryStatement': {\n return hasNonEmptyResolverCall(node.block, resolverName) ||\n hasNonEmptyResolverCall(node.handler && node.handler.body, resolverName) ||\n hasNonEmptyResolverCall(node.finalizer, resolverName);\n }\n\n case 'VariableDeclaration': {\n return node.declarations.some((nde) => {\n return hasNonEmptyResolverCall(nde, resolverName);\n });\n }\n\n case 'VariableDeclarator': {\n return hasNonEmptyResolverCall(node.id, resolverName) ||\n hasNonEmptyResolverCall(node.init, resolverName);\n }\n\n /*\n // Shouldn't need to parse literals/literal components, etc.\n\n case 'Identifier':\n case 'TemplateElement':\n case 'Super':\n // Exports not relevant in this context\n */\n default:\n return false;\n }\n};\n\n/**\n * Checks if a Promise executor has no resolve value or an empty value.\n * An `undefined` resolve does not count.\n * @param {ESTreeOrTypeScriptNode} node\n * @param {boolean} anyPromiseAsReturn\n * @param {boolean} [allBranches]\n * @returns {boolean}\n */\nconst hasValueOrExecutorHasNonEmptyResolveValue = (node, anyPromiseAsReturn, allBranches) => {\n const hasReturnMethod = allBranches ?\n /**\n * @param {ESTreeOrTypeScriptNode} nde\n * @param {PromiseFilter} promiseFilter\n * @returns {boolean}\n */\n (nde, promiseFilter) => {\n let hasReturn;\n try {\n hasReturn = hasReturnValue(nde, true, promiseFilter);\n } catch (error) {\n // c8 ignore else\n if (/** @type {Error} */ (error).message === 'Null return') {\n return false;\n }\n /* c8 ignore next 3 */\n // eslint-disable-next-line @stylistic/padding-line-between-statements -- c8\n throw error;\n }\n\n // `hasReturn` check needed since `throw` treated as valid return by\n // `allBrancheshaveReturnValues`\n return Boolean(hasReturn && allBrancheshaveReturnValues(nde, promiseFilter));\n } :\n /**\n * @param {ESTreeOrTypeScriptNode} nde\n * @param {PromiseFilter} promiseFilter\n * @returns {boolean}\n */\n (nde, promiseFilter) => {\n return Boolean(hasReturnValue(nde, false, promiseFilter));\n };\n\n return hasReturnMethod(node, (prom) => {\n if (anyPromiseAsReturn) {\n return true;\n }\n\n if (isVoidPromise(prom)) {\n return false;\n }\n\n const {\n body,\n params,\n } =\n /**\n * @type {import('@typescript-eslint/types').TSESTree.FunctionExpression|\n * import('@typescript-eslint/types').TSESTree.ArrowFunctionExpression}\n */ (\n /** @type {import('@typescript-eslint/types').TSESTree.NewExpression} */ (\n prom\n ).arguments[0]\n ) || {};\n\n if (!params?.length) {\n return false;\n }\n\n const {\n name: resolverName,\n } = /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n params[0]\n );\n\n return hasNonEmptyResolverCall(body, resolverName);\n });\n};\n\nexport {\n hasReturnValue,\n hasValueOrExecutorHasNonEmptyResolveValue,\n};\n"],"mappings":"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","ignoreList":[]}
|
package/package.json
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
"url": "http://gajus.com"
|
|
6
6
|
},
|
|
7
7
|
"dependencies": {
|
|
8
|
-
"@es-joy/jsdoccomment": "~0.
|
|
8
|
+
"@es-joy/jsdoccomment": "~0.88.0",
|
|
9
9
|
"@es-joy/resolve.exports": "1.2.0",
|
|
10
10
|
"are-docs-informative": "^0.0.2",
|
|
11
11
|
"comment-parser": "1.4.7",
|
|
@@ -16,25 +16,25 @@
|
|
|
16
16
|
"html-entities": "^2.6.0",
|
|
17
17
|
"object-deep-merge": "^2.0.1",
|
|
18
18
|
"parse-imports-exports": "^0.2.4",
|
|
19
|
-
"semver": "^7.8.
|
|
19
|
+
"semver": "^7.8.5",
|
|
20
20
|
"spdx-expression-parse": "^4.0.0",
|
|
21
21
|
"to-valid-identifier": "^1.0.0"
|
|
22
22
|
},
|
|
23
23
|
"description": "JSDoc linting rules for ESLint.",
|
|
24
24
|
"devDependencies": {
|
|
25
|
-
"@arethetypeswrong/cli": "^0.18.
|
|
26
|
-
"@babel/cli": "8.0.
|
|
27
|
-
"@babel/core": "8.0.
|
|
28
|
-
"@babel/eslint-parser": "8.0.
|
|
29
|
-
"@babel/plugin-transform-flow-strip-types": "8.0.
|
|
30
|
-
"@babel/preset-env": "8.0.
|
|
25
|
+
"@arethetypeswrong/cli": "^0.18.4",
|
|
26
|
+
"@babel/cli": "8.0.1",
|
|
27
|
+
"@babel/core": "8.0.1",
|
|
28
|
+
"@babel/eslint-parser": "8.0.1",
|
|
29
|
+
"@babel/plugin-transform-flow-strip-types": "8.0.1",
|
|
30
|
+
"@babel/preset-env": "8.0.2",
|
|
31
31
|
"@es-joy/escodegen": "^4.2.0",
|
|
32
32
|
"@es-joy/jsdoc-eslint-parser": "^0.27.0",
|
|
33
33
|
"@eslint/core": "^1.2.1",
|
|
34
|
-
"@hkdobrev/run-if-changed": "^0.
|
|
34
|
+
"@hkdobrev/run-if-changed": "^0.9.0",
|
|
35
35
|
"@rollup/plugin-node-resolve": "^16.0.3",
|
|
36
36
|
"@semantic-release/commit-analyzer": "^13.0.1",
|
|
37
|
-
"@semantic-release/github": "^12.0.
|
|
37
|
+
"@semantic-release/github": "^12.0.9",
|
|
38
38
|
"@semantic-release/npm": "^13.1.5",
|
|
39
39
|
"@types/chai": "^5.2.3",
|
|
40
40
|
"@types/debug": "^4.1.13",
|
|
@@ -42,38 +42,38 @@
|
|
|
42
42
|
"@types/estree": "^1.0.9",
|
|
43
43
|
"@types/json-schema": "^7.0.15",
|
|
44
44
|
"@types/mocha": "^10.0.10",
|
|
45
|
-
"@types/node": "^
|
|
45
|
+
"@types/node": "^26.1.0",
|
|
46
46
|
"@types/semver": "^7.7.1",
|
|
47
47
|
"@types/spdx-expression-parse": "^4.0.0",
|
|
48
|
-
"@typescript-eslint/types": "8.
|
|
48
|
+
"@typescript-eslint/types": "8.62.1",
|
|
49
49
|
"babel-plugin-add-module-exports": "^1.0.4",
|
|
50
50
|
"babel-plugin-istanbul": "^8.0.0",
|
|
51
|
-
"babel-plugin-transform-import-meta": "^
|
|
51
|
+
"babel-plugin-transform-import-meta": "^3.0.0",
|
|
52
52
|
"c8": "^11.0.0",
|
|
53
53
|
"camelcase": "^9.0.0",
|
|
54
54
|
"chai": "^6.2.2",
|
|
55
55
|
"decamelize": "^6.0.1",
|
|
56
|
-
"eslint": "10.
|
|
56
|
+
"eslint": "10.6.0",
|
|
57
57
|
"eslint-config-canonical": "^47.4.2",
|
|
58
58
|
"gitdown": "^4.1.1",
|
|
59
59
|
"glob": "^13.0.6",
|
|
60
|
-
"globals": "^17.
|
|
60
|
+
"globals": "^17.7.0",
|
|
61
61
|
"husky": "^9.1.7",
|
|
62
62
|
"jsdoc-type-pratt-parser": "^7.2.0",
|
|
63
63
|
"json-schema": "^0.4.0",
|
|
64
64
|
"json-schema-to-typescript": "^15.0.4",
|
|
65
|
-
"lint-staged": "^17.0.
|
|
65
|
+
"lint-staged": "^17.0.8",
|
|
66
66
|
"mocha": "^11.7.6",
|
|
67
67
|
"open-editor": "^6.0.0",
|
|
68
|
-
"playwright": "^1.
|
|
68
|
+
"playwright": "^1.61.1",
|
|
69
69
|
"replace": "^1.2.2",
|
|
70
70
|
"rimraf": "^6.1.3",
|
|
71
|
-
"rollup": "^4.
|
|
72
|
-
"semantic-release": "^25.0.
|
|
71
|
+
"rollup": "^4.62.2",
|
|
72
|
+
"semantic-release": "^25.0.5",
|
|
73
73
|
"sinon": "^22.0.0",
|
|
74
74
|
"ts-api-utils": "^2.5.0",
|
|
75
75
|
"typescript": "5.9.3",
|
|
76
|
-
"typescript-eslint": "8.
|
|
76
|
+
"typescript-eslint": "8.62.1"
|
|
77
77
|
},
|
|
78
78
|
"engines": {
|
|
79
79
|
"node": "^22.13.0 || >=24"
|
|
@@ -179,5 +179,5 @@
|
|
|
179
179
|
"test-cov": "TIMING=1 c8 --reporter text pnpm run test-no-cov",
|
|
180
180
|
"test-index": "pnpm run test-no-cov test/rules/index.js"
|
|
181
181
|
},
|
|
182
|
-
"version": "63.0.
|
|
182
|
+
"version": "63.0.11"
|
|
183
183
|
}
|
|
@@ -113,7 +113,6 @@ export default iterateJsdoc(({
|
|
|
113
113
|
} else if (aliasDeclaration.type === 'ClassDeclaration') {
|
|
114
114
|
/* c8 ignore next -- TS */
|
|
115
115
|
for (const nde of aliasDeclaration?.body?.body ?? []) {
|
|
116
|
-
// @ts-expect-error Should be ok
|
|
117
116
|
const commentNode = getJSDocComment(sourceCode, nde, settings);
|
|
118
117
|
if (!commentNode) {
|
|
119
118
|
continue;
|
|
@@ -31,22 +31,148 @@ export default iterateJsdoc(({
|
|
|
31
31
|
const indexes = [];
|
|
32
32
|
|
|
33
33
|
const unescapedInlineTagRegex = /(?:^|\s)@(\w+)/gv;
|
|
34
|
+
|
|
35
|
+
const scopedPackageNameRegex = /^@[\w.\-]+\/[\w.\-]+/v;
|
|
36
|
+
|
|
37
|
+
const declarationReferenceInlineTags = new Set([
|
|
38
|
+
'inheritDoc',
|
|
39
|
+
'link',
|
|
40
|
+
'linkcode',
|
|
41
|
+
'linkplain',
|
|
42
|
+
]);
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* @param {string} desc
|
|
46
|
+
* @param {number} atSignIndex
|
|
47
|
+
* @returns {string}
|
|
48
|
+
*/
|
|
49
|
+
const getInlineTagName = (desc, atSignIndex) => {
|
|
50
|
+
const inlineTagStart = desc.lastIndexOf('{@', atSignIndex);
|
|
51
|
+
|
|
52
|
+
if (inlineTagStart === -1) {
|
|
53
|
+
return '';
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
const inlineTagEnd = desc.indexOf('}', inlineTagStart);
|
|
57
|
+
|
|
58
|
+
if (inlineTagEnd === -1 || inlineTagEnd <= atSignIndex) {
|
|
59
|
+
return '';
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
return desc.slice(inlineTagStart + 2).match(/^\w+/v)?.[0] || '';
|
|
63
|
+
};
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* @param {string} desc
|
|
67
|
+
* @param {string} match
|
|
68
|
+
* @param {number} offset
|
|
69
|
+
* @returns {boolean}
|
|
70
|
+
*/
|
|
71
|
+
const shouldIgnoreMatch = (desc, match, offset) => {
|
|
72
|
+
const atSignIndex = offset + match.lastIndexOf('@');
|
|
73
|
+
const inlineTagName = getInlineTagName(desc, atSignIndex);
|
|
74
|
+
|
|
75
|
+
return declarationReferenceInlineTags.has(inlineTagName) &&
|
|
76
|
+
scopedPackageNameRegex.test(desc.slice(atSignIndex));
|
|
77
|
+
};
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* @param {string} tagName
|
|
81
|
+
* @returns {[
|
|
82
|
+
* RegExp,
|
|
83
|
+
* (description: string) => string
|
|
84
|
+
* ]}
|
|
85
|
+
*/
|
|
86
|
+
const escapeInlineTags = (tagName) => {
|
|
87
|
+
const regex = new RegExp(`(^|\\s)@${
|
|
88
|
+
// No need to escape, as contains only safe characters
|
|
89
|
+
tagName
|
|
90
|
+
}`, 'gv');
|
|
91
|
+
|
|
92
|
+
return [
|
|
93
|
+
regex,
|
|
94
|
+
/**
|
|
95
|
+
* @param {string} desc
|
|
96
|
+
*/
|
|
97
|
+
(desc) => {
|
|
98
|
+
return desc.replaceAll(
|
|
99
|
+
regex,
|
|
100
|
+
(match, prefix, offset) => {
|
|
101
|
+
if (shouldIgnoreMatch(desc, match, offset)) {
|
|
102
|
+
return match;
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
return fixType === 'backticks' ?
|
|
106
|
+
prefix + '`@' + tagName + '`' :
|
|
107
|
+
prefix + '\\@' + tagName;
|
|
108
|
+
},
|
|
109
|
+
);
|
|
110
|
+
},
|
|
111
|
+
];
|
|
112
|
+
};
|
|
113
|
+
|
|
114
|
+
/**
|
|
115
|
+
* @param {string} desc
|
|
116
|
+
* @returns {string}
|
|
117
|
+
*/
|
|
118
|
+
const getUnescapedInlineTagName = (desc) => {
|
|
119
|
+
unescapedInlineTagRegex.lastIndex = 0;
|
|
120
|
+
|
|
121
|
+
let match;
|
|
122
|
+
while ((match = unescapedInlineTagRegex.exec(desc)) !== null) {
|
|
123
|
+
const [
|
|
124
|
+
fullMatch,
|
|
125
|
+
tagName,
|
|
126
|
+
] = match;
|
|
127
|
+
|
|
128
|
+
if (
|
|
129
|
+
allowedInlineTags.includes(tagName) ||
|
|
130
|
+
shouldIgnoreMatch(desc, fullMatch, match.index)
|
|
131
|
+
) {
|
|
132
|
+
continue;
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
return tagName;
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
return '';
|
|
139
|
+
};
|
|
140
|
+
|
|
141
|
+
const normalizedDescription = description.startsWith('\n') ?
|
|
142
|
+
description.slice(1) :
|
|
143
|
+
description;
|
|
144
|
+
|
|
145
|
+
let nextLineStartOffset = 0;
|
|
34
146
|
for (const [
|
|
35
147
|
idx,
|
|
36
148
|
descLine,
|
|
37
|
-
] of (
|
|
38
|
-
description.startsWith('\n') ? description.slice(1) : description
|
|
39
|
-
).split('\n').entries()
|
|
149
|
+
] of normalizedDescription.split('\n').entries()
|
|
40
150
|
) {
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
151
|
+
const lineStartOffset = nextLineStartOffset;
|
|
152
|
+
|
|
153
|
+
// +1 for the `\n` removed by split.
|
|
154
|
+
nextLineStartOffset += descLine.length + 1;
|
|
155
|
+
|
|
156
|
+
descLine.replaceAll(unescapedInlineTagRegex, (match, tagName, offset) => {
|
|
157
|
+
if (
|
|
158
|
+
allowedInlineTags.includes(tagName) ||
|
|
159
|
+
// Run ignore-detection against the full description text so that
|
|
160
|
+
// multi-line inline tags (e.g. `{@link` on one line and
|
|
161
|
+
// `@scope/pkg#Member}` on the next) are recognized as being inside an
|
|
162
|
+
// inline tag rather than scanned per-line.
|
|
163
|
+
shouldIgnoreMatch(
|
|
164
|
+
normalizedDescription,
|
|
165
|
+
match,
|
|
166
|
+
lineStartOffset + offset,
|
|
167
|
+
)
|
|
168
|
+
) {
|
|
169
|
+
return match;
|
|
44
170
|
}
|
|
45
171
|
|
|
46
172
|
tagNames.push(tagName);
|
|
47
173
|
indexes.push(idx);
|
|
48
174
|
|
|
49
|
-
return
|
|
175
|
+
return match;
|
|
50
176
|
});
|
|
51
177
|
}
|
|
52
178
|
|
|
@@ -61,15 +187,16 @@ export default iterateJsdoc(({
|
|
|
61
187
|
},
|
|
62
188
|
enableFixer ?
|
|
63
189
|
() => {
|
|
190
|
+
// `tagName` and `fixType` are constant here, so compute the escaper
|
|
191
|
+
// once rather than rebuilding the RegExp + closure for every line.
|
|
192
|
+
const [
|
|
193
|
+
,
|
|
194
|
+
escapeInlineTag,
|
|
195
|
+
] = escapeInlineTags(tagName);
|
|
196
|
+
|
|
64
197
|
utils.setBlockDescription((info, seedTokens, descLines) => {
|
|
65
198
|
return descLines.map((desc) => {
|
|
66
|
-
const newDesc = desc
|
|
67
|
-
new RegExp(`(^|\\s)@${
|
|
68
|
-
// No need to escape, as contains only safe characters
|
|
69
|
-
tagName
|
|
70
|
-
}`, 'gv'),
|
|
71
|
-
fixType === 'backticks' ? '$1`@' + tagName + '`' : '$1\\@' + tagName,
|
|
72
|
-
);
|
|
199
|
+
const newDesc = escapeInlineTag(desc);
|
|
73
200
|
|
|
74
201
|
return {
|
|
75
202
|
number: 0,
|
|
@@ -87,33 +214,6 @@ export default iterateJsdoc(({
|
|
|
87
214
|
);
|
|
88
215
|
}
|
|
89
216
|
|
|
90
|
-
/**
|
|
91
|
-
* @param {string} tagName
|
|
92
|
-
* @returns {[
|
|
93
|
-
* RegExp,
|
|
94
|
-
* (description: string) => string
|
|
95
|
-
* ]}
|
|
96
|
-
*/
|
|
97
|
-
const escapeInlineTags = (tagName) => {
|
|
98
|
-
const regex = new RegExp(`(^|\\s)@${
|
|
99
|
-
// No need to escape, as contains only safe characters
|
|
100
|
-
tagName
|
|
101
|
-
}`, 'gv');
|
|
102
|
-
|
|
103
|
-
return [
|
|
104
|
-
regex,
|
|
105
|
-
/**
|
|
106
|
-
* @param {string} desc
|
|
107
|
-
*/
|
|
108
|
-
(desc) => {
|
|
109
|
-
return desc.replaceAll(
|
|
110
|
-
regex,
|
|
111
|
-
fixType === 'backticks' ? '$1`@' + tagName + '`' : '$1\\@' + tagName,
|
|
112
|
-
);
|
|
113
|
-
},
|
|
114
|
-
];
|
|
115
|
-
};
|
|
116
|
-
|
|
117
217
|
for (const tag of jsdoc.tags) {
|
|
118
218
|
if (tag.tag === 'example') {
|
|
119
219
|
continue;
|
|
@@ -125,10 +225,7 @@ export default iterateJsdoc(({
|
|
|
125
225
|
utils.getTagDescription(tag, true)
|
|
126
226
|
// eslint-disable-next-line no-loop-func -- Safe
|
|
127
227
|
).some((desc) => {
|
|
128
|
-
tagName =
|
|
129
|
-
if (allowedInlineTags.includes(tagName)) {
|
|
130
|
-
return false;
|
|
131
|
-
}
|
|
228
|
+
tagName = getUnescapedInlineTagName(desc);
|
|
132
229
|
|
|
133
230
|
return tagName;
|
|
134
231
|
})) {
|
|
@@ -347,7 +347,6 @@ const isExemptedImplementer = (node, sourceCode, context, settings) => {
|
|
|
347
347
|
context.getScope()
|
|
348
348
|
));
|
|
349
349
|
if (interfaceMethodNode) {
|
|
350
|
-
// @ts-expect-error Ok
|
|
351
350
|
const comment = getJSDocComment(sourceCode, interfaceMethodNode, settings);
|
|
352
351
|
if (comment) {
|
|
353
352
|
return true;
|