eslint-plugin-jsdoc 53.0.1 → 54.0.0

package/dist/utils/hasReturnValue.cjs.map

@@ -1 +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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"}
+{"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":[]}

package/package.json

@@ -18,9 +18,10 @@
   },
   "description": "JSDoc linting rules for ESLint.",
   "devDependencies": {
-    "@arethetypeswrong/core": "^0.18.2",
+    "@babel/cli": "^7.27.2",
     "@babel/core": "^7.27.4",
     "@babel/eslint-parser": "^7.27.5",
+    "@babel/node": "^7.27.1",
     "@babel/plugin-syntax-class-properties": "^7.12.13",
     "@babel/plugin-transform-flow-strip-types": "^7.27.1",
     "@babel/preset-env": "^7.27.2",
@@ -62,12 +63,11 @@
     "lodash.defaultsdeep": "^4.6.1",
     "mocha": "^11.7.0",
     "open-editor": "^5.1.0",
-    "publint": "^0.3.12",
+    "replace": "^1.2.2",
+    "rimraf": "^6.0.1",
     "semantic-release": "^24.2.5",
-    "tsdown": "^0.13.4",
     "typescript": "5.8.3",
-    "typescript-eslint": "^8.34.1",
-    "unplugin-unused": "^0.5.1"
+    "typescript-eslint": "^8.34.1"
   },
   "engines": {
     "node": ">=20.11.0"
@@ -82,42 +82,25 @@
     "*.js": "eslint --fix"
   },
   "type": "module",
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "default": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
+      "types": "./dist/index.d.ts",
+      "import": "./src/index.js",
+      "require": "./dist/index.cjs"
     },
     "./getJsdocProcessorPlugin.js": {
-      "import": {
-        "types": "./dist/getJsdocProcessorPlugin.d.ts",
-        "default": "./dist/getJsdocProcessorPlugin.js"
-      },
-      "default": {
-        "types": "./dist/getJsdocProcessorPlugin.d.cts",
-        "default": "./dist/getJsdocProcessorPlugin.cjs"
-      }
+      "types": "./dist/getJsdocProcessorPlugin.d.ts",
+      "import": "./dist/getJsdocProcessorPlugin.cjs",
+      "require": "./src/getJsdocProcessorPlugin.js"
     },
     "./iterateJsdoc.js": {
-      "import": {
-        "types": "./dist/iterateJsdoc.d.ts",
-        "default": "./dist/iterateJsdoc.js"
-      },
-      "default": {
-        "types": "./dist/iterateJsdoc.d.cts",
-        "default": "./dist/iterateJsdoc.cjs"
-      }
-    },
-    "./package.json": "./package.json"
+      "types": "./dist/iterateJsdoc.d.ts",
+      "import": "./dist/iterateJsdoc.cjs",
+      "require": "./src/iterateJsdoc.js"
+    }
   },
-  "files": [
-    "dist/"
-  ],
   "name": "eslint-plugin-jsdoc",
   "mocha": {
     "reporter": "dot",
@@ -156,11 +139,12 @@
   },
   "scripts": {
     "tsc": "tsc",
-    "build": "tsdown",
-    "check-docs": "node ./src/bin/generateDocs.js --check",
-    "create-docs": "pnpm run create-options && node ./src/bin/generateDocs.js",
-    "create-rule": "node ./src/bin/generateRule.js",
-    "create-options": "node ./src/bin/generateOptions.js",
+    "tsc-build": "tsc -p tsconfig-prod.json",
+    "build": "rimraf ./dist && NODE_ENV=production babel ./src --out-file-extension .cjs --out-dir ./dist --copy-files --source-maps --ignore ./src/bin/*.js --no-copy-ignored && replace 'require\\(\"\\.(.*?)\\.[^.]*?\"\\)' 'require(\".$1.cjs\")' 'dist' -r --include=\"*.cjs\" && pnpm tsc-build",
+    "check-docs": "babel-node ./src/bin/generateDocs.js --check",
+    "create-docs": "pnpm run create-options && babel-node ./src/bin/generateDocs.js",
+    "create-rule": "babel-node ./src/bin/generateRule.js",
+    "create-options": "node ./src/bin/generateOptions.mjs",
     "install-offline": "pnpm install --prefer-offline --no-audit",
     "lint": "eslint",
     "lint-fix": "eslint --fix",
@@ -170,5 +154,5 @@
     "test-cov": "TIMING=1 c8 --reporter text pnpm run test-no-cov",
     "test-index": "pnpm run test-no-cov test/rules/index.js"
   },
-  "version": "53.0.1"
+  "version": "54.0.0"
 }

package/src/WarnSettings.js

@@ -0,0 +1,34 @@
+const WarnSettings = function () {
+  /** @type {WeakMap<object, Set<string>>} */
+  const warnedSettings = new WeakMap();
+
+  return {
+    /**
+     * Warn only once for each context and setting
+     * @param {{}} context
+     * @param {string} setting
+     * @returns {boolean}
+     */
+    hasBeenWarned (context, setting) {
+      return warnedSettings.has(context) && /** @type {Set<string>} */ (
+        warnedSettings.get(context)
+      ).has(setting);
+    },
+
+    /**
+     * @param {{}} context
+     * @param {string} setting
+     * @returns {void}
+     */
+    markSettingAsWarned (context, setting) {
+      // c8 ignore else
+      if (!warnedSettings.has(context)) {
+        warnedSettings.set(context, new Set());
+      }
+
+      /** @type {Set<string>} */ (warnedSettings.get(context)).add(setting);
+    },
+  };
+};
+
+export default WarnSettings;

package/src/alignTransform.js

@@ -0,0 +1,358 @@
+/**
+ * Transform based on https://github.com/syavorsky/comment-parser/blob/master/src/transforms/align.ts
+ *
+ * It contains some customizations to align based on the tags, and some custom options.
+ */
+
+import {
+  // `comment-parser/primitives` export
+  util,
+} from 'comment-parser';
+
+/**
+ * @typedef {{
+ *   hasNoTypes: boolean,
+ *   maxNamedTagLength: import('./iterateJsdoc.js').Integer,
+ *   maxUnnamedTagLength: import('./iterateJsdoc.js').Integer
+ * }} TypelessInfo
+ */
+
+const {
+  rewireSource,
+} = util;
+
+/**
+ * @typedef {{
+ *   name: import('./iterateJsdoc.js').Integer,
+ *   start: import('./iterateJsdoc.js').Integer,
+ *   tag: import('./iterateJsdoc.js').Integer,
+ *   type: import('./iterateJsdoc.js').Integer
+ * }} Width
+ */
+
+/** @type {Width} */
+const zeroWidth = {
+  name: 0,
+  start: 0,
+  tag: 0,
+  type: 0,
+};
+
+/**
+ * @param {string[]} tags
+ * @param {import('./iterateJsdoc.js').Integer} index
+ * @param {import('comment-parser').Line[]} source
+ * @returns {boolean}
+ */
+const shouldAlign = (tags, index, source) => {
+  const tag = source[index].tokens.tag.replace('@', '');
+  const includesTag = tags.includes(tag);
+
+  if (includesTag) {
+    return true;
+  }
+
+  if (tag !== '') {
+    return false;
+  }
+
+  for (let iterator = index; iterator >= 0; iterator--) {
+    const previousTag = source[iterator].tokens.tag.replace('@', '');
+
+    if (previousTag !== '') {
+      if (tags.includes(previousTag)) {
+        return true;
+      }
+
+      return false;
+    }
+  }
+
+  return true;
+};
+
+/**
+ * @param {string[]} tags
+ * @returns {(
+ *   width: Width,
+ *   line: {
+ *     tokens: import('comment-parser').Tokens
+ *   },
+ *   index: import('./iterateJsdoc.js').Integer,
+ *   source: import('comment-parser').Line[]
+ * ) => Width}
+ */
+const getWidth = (tags) => {
+  return (width, {
+    tokens,
+  }, index, source) => {
+    if (!shouldAlign(tags, index, source)) {
+      return width;
+    }
+
+    return {
+      name: Math.max(width.name, tokens.name.length),
+      start: tokens.delimiter === '/**' ? tokens.start.length : width.start,
+      tag: Math.max(width.tag, tokens.tag.length),
+      type: Math.max(width.type, tokens.type.length),
+    };
+  };
+};
+
+/**
+ * @param {{
+ *   description: string;
+ *   tags: import('comment-parser').Spec[];
+ *   problems: import('comment-parser').Problem[];
+ * }} fields
+ * @returns {TypelessInfo}
+ */
+const getTypelessInfo = (fields) => {
+  const hasNoTypes = fields.tags.every(({
+    type,
+  }) => {
+    return !type;
+  });
+  const maxNamedTagLength = Math.max(...fields.tags.map(({
+    name,
+    tag,
+  }) => {
+    return name.length === 0 ? -1 : tag.length;
+  }).filter((length) => {
+    return length !== -1;
+  })) + 1;
+  const maxUnnamedTagLength = Math.max(...fields.tags.map(({
+    name,
+    tag,
+  }) => {
+    return name.length === 0 ? tag.length : -1;
+  }).filter((length) => {
+    return length !== -1;
+  })) + 1;
+  return {
+    hasNoTypes,
+    maxNamedTagLength,
+    maxUnnamedTagLength,
+  };
+};
+
+/**
+ * @param {import('./iterateJsdoc.js').Integer} len
+ * @returns {string}
+ */
+const space = (len) => {
+  return ''.padStart(len, ' ');
+};
+
+/**
+ * @param {{
+ *   customSpacings: import('../src/rules/checkLineAlignment.js').CustomSpacings,
+ *   tags: string[],
+ *   indent: string,
+ *   preserveMainDescriptionPostDelimiter: boolean,
+ *   wrapIndent: string,
+ *   disableWrapIndent: boolean,
+ * }} cfg
+ * @returns {(
+ *   block: import('comment-parser').Block
+ * ) => import('comment-parser').Block}
+ */
+const alignTransform = ({
+  customSpacings,
+  disableWrapIndent,
+  indent,
+  preserveMainDescriptionPostDelimiter,
+  tags,
+  wrapIndent,
+}) => {
+  let intoTags = false;
+  /** @type {Width} */
+  let width;
+
+  /**
+   * @param {import('comment-parser').Tokens} tokens
+   * @param {TypelessInfo} typelessInfo
+   * @returns {import('comment-parser').Tokens}
+   */
+  const alignTokens = (tokens, typelessInfo) => {
+    const nothingAfter = {
+      delim: false,
+      name: false,
+      tag: false,
+      type: false,
+    };
+
+    if (tokens.description === '') {
+      nothingAfter.name = true;
+      tokens.postName = '';
+
+      if (tokens.name === '') {
+        nothingAfter.type = true;
+        tokens.postType = '';
+
+        if (tokens.type === '') {
+          nothingAfter.tag = true;
+          tokens.postTag = '';
+
+          /* c8 ignore next: Never happens because the !intoTags return. But it's here for consistency with the original align transform */
+          if (tokens.tag === '') {
+            nothingAfter.delim = true;
+          }
+        }
+      }
+    }
+
+    let untypedNameAdjustment = 0;
+    let untypedTypeAdjustment = 0;
+    if (typelessInfo.hasNoTypes) {
+      nothingAfter.tag = true;
+      tokens.postTag = '';
+      if (tokens.name === '') {
+        untypedNameAdjustment = typelessInfo.maxNamedTagLength - tokens.tag.length;
+      } else {
+        untypedNameAdjustment = typelessInfo.maxNamedTagLength > typelessInfo.maxUnnamedTagLength ? 0 :
+          Math.max(0, typelessInfo.maxUnnamedTagLength - (tokens.tag.length + tokens.name.length + 1));
+        untypedTypeAdjustment = typelessInfo.maxNamedTagLength - tokens.tag.length;
+      }
+    }
+
+    // Todo: Avoid fixing alignment of blocks with multiline wrapping of type
+    if (tokens.tag === '' && tokens.type) {
+      return tokens;
+    }
+
+    const spacings = {
+      postDelimiter: customSpacings?.postDelimiter || 1,
+      postName: customSpacings?.postName || 1,
+      postTag: customSpacings?.postTag || 1,
+      postType: customSpacings?.postType || 1,
+    };
+
+    tokens.postDelimiter = nothingAfter.delim ? '' : space(spacings.postDelimiter);
+
+    if (!nothingAfter.tag) {
+      tokens.postTag = space(width.tag - tokens.tag.length + spacings.postTag);
+    }
+
+    if (!nothingAfter.type) {
+      tokens.postType = space(width.type - tokens.type.length + spacings.postType + untypedTypeAdjustment);
+    }
+
+    if (!nothingAfter.name) {
+      // If post name is empty for all lines (name width 0), don't add post name spacing.
+      tokens.postName = width.name === 0 ? '' : space(width.name - tokens.name.length + spacings.postName + untypedNameAdjustment);
+    }
+
+    return tokens;
+  };
+
+  /**
+   * @param {import('comment-parser').Line} line
+   * @param {import('./iterateJsdoc.js').Integer} index
+   * @param {import('comment-parser').Line[]} source
+   * @param {TypelessInfo} typelessInfo
+   * @param {string|false} indentTag
+   * @returns {import('comment-parser').Line}
+   */
+  const update = (line, index, source, typelessInfo, indentTag) => {
+    /** @type {import('comment-parser').Tokens} */
+    const tokens = {
+      ...line.tokens,
+    };
+
+    if (tokens.tag !== '') {
+      intoTags = true;
+    }
+
+    const isEmpty =
+      tokens.tag === '' &&
+      tokens.name === '' &&
+      tokens.type === '' &&
+      tokens.description === '';
+
+    // dangling '*/'
+    if (tokens.end === '*/' && isEmpty) {
+      tokens.start = indent + ' ';
+
+      return {
+        ...line,
+        tokens,
+      };
+    }
+
+    switch (tokens.delimiter) {
+      case '*':
+        tokens.start = indent + ' ';
+        break;
+      case '/**':
+        tokens.start = indent;
+        break;
+      default:
+        tokens.delimiter = '';
+
+        // compensate delimiter
+        tokens.start = indent + '  ';
+    }
+
+    if (!intoTags) {
+      if (tokens.description === '') {
+        tokens.postDelimiter = '';
+      } else if (!preserveMainDescriptionPostDelimiter) {
+        tokens.postDelimiter = ' ';
+      }
+
+      return {
+        ...line,
+        tokens,
+      };
+    }
+
+    const postHyphenSpacing = customSpacings?.postHyphen ?? 1;
+    const hyphenSpacing = /^\s*-\s+/v;
+    tokens.description = tokens.description.replace(
+      hyphenSpacing, '-' + ''.padStart(postHyphenSpacing, ' '),
+    );
+
+    // Not align.
+    if (shouldAlign(tags, index, source)) {
+      alignTokens(tokens, typelessInfo);
+      if (!disableWrapIndent && indentTag) {
+        tokens.postDelimiter += wrapIndent;
+      }
+    }
+
+    return {
+      ...line,
+      tokens,
+    };
+  };
+
+  return ({
+    source,
+    ...fields
+  }) => {
+    width = source.reduce(getWidth(tags), {
+      ...zeroWidth,
+    });
+
+    const typelessInfo = getTypelessInfo(fields);
+
+    let tagIndentMode = false;
+
+    return rewireSource({
+      ...fields,
+      source: source.map((line, index) => {
+        const indentTag = !disableWrapIndent && tagIndentMode && !line.tokens.tag && line.tokens.description;
+        const ret = update(line, index, source, typelessInfo, indentTag);
+
+        if (!disableWrapIndent && line.tokens.tag) {
+          tagIndentMode = true;
+        }
+
+        return ret;
+      }),
+    });
+  };
+};
+
+export default alignTransform;