eslint-plugin-jsdoc 63.3.3 → 64.0.1

package/dist/index.d.ts

@@ -1,4 +1,18 @@
 export default index;
+/** @type {import('eslint').ESLint.Plugin['rules']} */
+export const rules: import("eslint").ESLint.Plugin["rules"];
+/**
+ * @type {Record<
+ *      FlatConfigNames,
+ *       import('eslint').Linter.Config
+ *     > &
+ *     Record<
+ *       "examples"|"default-expressions"|"examples-and-default-expressions",
+ *       import('eslint').Linter.Config[]
+ *     > &
+ *     Record<"flat/recommended-mixed", import('eslint').Linter.Config[]>
+  } */
+export const configs: Record<FlatConfigNames, import("eslint").Linter.Config> & Record<"examples" | "default-expressions" | "examples-and-default-expressions", import("eslint").Linter.Config[]> & Record<"flat/recommended-mixed", import("eslint").Linter.Config[]>;
 /**
  * @type {((
  *   cfg?: import('eslint').Linter.Config & {

package/package.json

@@ -5,12 +5,12 @@
     "url": "http://gajus.com"
   },
   "dependencies": {
-    "@es-joy/jsdoccomment": "~0.91.0",
+    "@es-joy/jsdoccomment": "~0.93.1",
     "@es-joy/resolve.exports": "1.2.0",
-    "are-docs-informative": "^0.0.2",
-    "comment-parser": "1.4.7",
+    "are-docs-informative": "^0.1.1",
+    "comment-parser": "1.4.8",
     "debug": "^4.4.3",
-    "escape-string-regexp": "^4.0.0",
+    "escape-string-regexp": "^5.0.0",
     "espree": "^11.2.0",
     "esquery": "^1.7.0",
     "html-entities": "^2.6.0",
@@ -23,16 +23,14 @@
   "description": "JSDoc linting rules for ESLint.",
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
-    "@babel/cli": "8.0.4",
     "@babel/core": "8.0.1",
     "@babel/eslint-parser": "8.0.1",
     "@babel/plugin-transform-flow-strip-types": "8.0.1",
     "@babel/preset-env": "8.0.2",
     "@es-joy/escodegen": "^4.2.0",
-    "@es-joy/jsdoc-eslint-parser": "^0.27.0",
+    "@es-joy/jsdoc-eslint-parser": "^0.28.0",
     "@eslint/core": "^1.2.1",
     "@hkdobrev/run-if-changed": "^0.9.0",
-    "@rollup/plugin-node-resolve": "^16.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/github": "^12.0.9",
     "@semantic-release/npm": "^13.1.5",
@@ -42,41 +40,39 @@
     "@types/estree": "^1.0.9",
     "@types/json-schema": "^7.0.15",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^26.1.2",
+    "@types/node": "^26.2.0",
     "@types/semver": "^7.8.0",
     "@types/spdx-expression-parse": "^4.0.0",
-    "@typescript-eslint/types": "8.65.0",
+    "@typescript-eslint/types": "8.66.0",
     "babel-plugin-add-module-exports": "^1.0.4",
-    "babel-plugin-istanbul": "^8.0.0",
     "babel-plugin-transform-import-meta": "^3.0.0",
     "c8": "^12.0.0",
     "camelcase": "^9.0.0",
     "chai": "^6.2.2",
     "decamelize": "^6.0.1",
-    "eslint": "10.8.0",
+    "eslint": "10.8.1",
     "eslint-config-canonical": "^47.4.2",
     "gitdown": "^4.1.1",
     "glob": "^13.0.6",
     "globals": "^17.9.0",
     "husky": "^9.1.7",
-    "jsdoc-type-pratt-parser": "^8.0.0",
+    "jsdoc-type-pratt-parser": "^9.0.0",
     "json-schema": "^0.4.0",
     "json-schema-to-typescript": "^15.0.4",
     "lint-staged": "^17.3.0",
-    "mocha": "^11.7.6",
+    "mocha": "^11.8.0",
     "open-editor": "^6.0.0",
     "playwright": "^1.62.1",
     "replace": "^1.2.2",
     "rimraf": "^6.1.3",
-    "rollup": "^4.62.4",
-    "semantic-release": "^25.0.8",
+    "semantic-release": "^25.0.9",
     "sinon": "^22.1.0",
     "ts-api-utils": "^2.5.0",
     "typescript": "5.9.3",
-    "typescript-eslint": "8.65.0"
+    "typescript-eslint": "8.66.0"
   },
   "engines": {
-    "node": "^22.13.0 || >=24"
+    "node": "^22.22.2 || >=24.15.0"
   },
   "keywords": [
     "eslint",
@@ -88,38 +84,19 @@
     "*.js": "eslint --fix"
   },
   "type": "module",
-  "main": "./dist/index.cjs",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./src/index.js"
-      },
-      "require": {
-        "types": "./dist/cjs/index.cjs.d.cts",
-        "default": "./dist/index-cjs.cjs"
-      }
+      "types": "./dist/index.d.ts",
+      "default": "./src/index.js"
     },
     "./getJsdocProcessorPlugin.js": {
-      "import": {
-        "types": "./dist/getJsdocProcessorPlugin.d.ts",
-        "default": "./src/getJsdocProcessorPlugin.js"
-      },
-      "require": {
-        "types": "./dist/cjs/getJsdocProcessorPlugin.d.cts",
-        "default": "./dist/getJsdocProcessorPlugin.cjs"
-      }
+      "types": "./dist/getJsdocProcessorPlugin.d.ts",
+      "default": "./src/getJsdocProcessorPlugin.js"
     },
     "./iterateJsdoc.js": {
-      "import": {
-        "types": "./dist/iterateJsdoc.d.ts",
-        "default": "./src/iterateJsdoc.js"
-      },
-      "require": {
-        "types": "./dist/cjs/iterateJsdoc.d.cts",
-        "default": "./dist/iterateJsdoc.cjs"
-      }
+      "types": "./dist/iterateJsdoc.d.ts",
+      "default": "./src/iterateJsdoc.js"
     }
   },
   "name": "eslint-plugin-jsdoc",
@@ -162,10 +139,8 @@
     "ruleTypes": "node ./src/bin/generateRuleTypes.js",
     "tsc": "tsc",
     "tsc-build": "tsc -p tsconfig-prod.json",
-    "tsc-cjs": "tsc -p tsconfig-cjs.json",
-    "rollup": "rollup -c",
-    "build": "node ./src/bin/buildEntryFileForTS.js && rimraf ./dist && mkdir dist && pnpm rollup && NODE_ENV=production babel ./src --out-file-extension .cjs --out-dir ./dist --copy-files --source-maps --ignore ./src/bin/*.js --no-copy-ignored && replace 'to-valid-identifier' '../to-valid-identifier.cjs' 'dist' -r --include=\"*.cjs\" && replace 'require\\(\"\\.(.*?)\\.[^.]*?\"\\)' 'require(\".$1.cjs\")' 'dist' -r --include=\"*.cjs\" && pnpm tsc-build && pnpm tsc-cjs",
-    "attw": "attw --pack .",
+    "build": "rimraf ./dist && mkdir dist && pnpm tsc-build && cp src/rules.d.ts dist/rules.d.ts",
+    "attw": "attw --profile esm-only --pack .",
     "check-docs": "node ./src/bin/generateDocs.js --check",
     "create-docs": "pnpm run create-options && node ./src/bin/generateDocs.js && pnpm ruleTypes",
     "create-rule": "node ./src/bin/generateRule.js",
@@ -175,10 +150,10 @@
     "lint": "eslint",
     "lint-fix": "eslint --fix",
     "prepare": "husky",
-    "test-no-cov": "BABEL_ENV=test mocha",
+    "test-no-cov": "mocha",
     "test": "c8 pnpm run test-no-cov",
     "test-cov": "TIMING=1 c8 --reporter text pnpm run test-no-cov",
     "test-index": "pnpm run test-no-cov test/rules/index.js"
   },
-  "version": "63.3.3"
+  "version": "64.0.1"
 }

package/src/index.js

@@ -1,9 +1,3 @@
-/* AUTO-GENERATED BY build SCRIPT */
-/* eslint-disable perfectionist/sort-imports -- For auto-generate; Do not remove */
-import {
-  merge,
-} from 'object-deep-merge';
-
 import {
   buildForbidRuleDefinition,
 } from './buildForbidRuleDefinition.js';
@@ -83,6 +77,9 @@ import validTypes from './rules/validTypes.js';
 import {
   ESLint,
 } from 'eslint';
+import {
+  merge,
+} from 'object-deep-merge';
 import semver from 'semver';
 
 /**
@@ -765,6 +762,25 @@ index.configs['flat/recommended-mixed'] = [
 
 export default index;
 
+// Named exports (rather than only properties of the default export) so that
+//   Node's `require(esm)` interop exposes `.rules`/`.configs` directly, as
+//   needed by legacy `plugin:jsdoc/*` config resolution in CJS.
+/** @type {import('eslint').ESLint.Plugin['rules']} */
+export const rules = index.rules;
+
+/**
+ * @type {Record<
+ *      FlatConfigNames,
+ *       import('eslint').Linter.Config
+ *     > &
+ *     Record<
+ *       "examples"|"default-expressions"|"examples-and-default-expressions",
+ *       import('eslint').Linter.Config[]
+ *     > &
+ *     Record<"flat/recommended-mixed", import('eslint').Linter.Config[]>
+  } */
+export const configs = index.configs;
+
 /**
  * @type {((
  *   cfg?: import('eslint').Linter.Config & {

package/dist/WarnSettings.cjs

@@ -1,38 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-const WarnSettings = function () {
-  /** @type {WeakMap<object, Set<string>>} */
-  const warnedSettings = new WeakMap();
-  return {
-    /**
-     * Warn only once for each context and setting
-     * @param {import('eslint').Rule.RuleContext} context
-     * @param {string} setting
-     * @returns {boolean}
-     */
-    hasBeenWarned(context, setting) {
-      return warnedSettings.has(context) && /** @type {Set<string>} */warnedSettings.get(context).has(setting);
-    },
-    /**
-     * @param {import('eslint').Rule.RuleContext} 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);
-    }
-  };
-};
-var _default = exports.default = WarnSettings;
-module.exports = exports.default;
-//# sourceMappingURL=WarnSettings.cjs.map

package/dist/WarnSettings.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"WarnSettings.cjs","names":[],"sources":["../src/WarnSettings.js"],"sourcesContent":["const WarnSettings = function () {\n  /** @type {WeakMap<object, Set<string>>} */\n  const warnedSettings = new WeakMap();\n\n  return {\n    /**\n     * Warn only once for each context and setting\n     * @param {import('eslint').Rule.RuleContext} context\n     * @param {string} setting\n     * @returns {boolean}\n     */\n    hasBeenWarned (context, setting) {\n      return warnedSettings.has(context) && /** @type {Set<string>} */ (\n        warnedSettings.get(context)\n      ).has(setting);\n    },\n\n    /**\n     * @param {import('eslint').Rule.RuleContext} context\n     * @param {string} setting\n     * @returns {void}\n     */\n    markSettingAsWarned (context, setting) {\n      // c8 ignore else\n      if (!warnedSettings.has(context)) {\n        warnedSettings.set(context, new Set());\n      }\n\n      /** @type {Set<string>} */ (warnedSettings.get(context)).add(setting);\n    },\n  };\n};\n\nexport default WarnSettings;\n"],"mappings":";;;;;;AAAA,MAAM,YAAY,GAAG,YAAY;EAC/B;EACA,MAAM,cAAc,GAAG,IAAI,OAAO,CAAC,CAAC;EAEpC,OAAO;IACL;AACJ;AACA;AACA;AACA;AACA;IACI,aAAa,CAAE,OAAO,EAAE,OAAO,EAAE;MAC/B,OAAO,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,0BACpC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAC3B,GAAG,CAAC,OAAO,CAAC;IAChB,CAAC;IAED;AACJ;AACA;AACA;AACA;IACI,mBAAmB,CAAE,OAAO,EAAE,OAAO,EAAE;MACrC;MACA,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;QAChC,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;MACxC;;MAEA;MAA4B,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAE,GAAG,CAAC,OAAO,CAAC;IACvE;EACF,CAAC;AACH,CAAC;AAAC,iCAEa,YAAY;AAAA","ignoreList":[]}

package/dist/alignTransform.cjs

@@ -1,402 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-var _commentParser = require("comment-parser");
-/**
- * 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.
- */
-
-/**
- * Detects if a line starts with a markdown list marker
- * Supports: -, *, numbered lists (1., 2., etc.)
- * This explicitly excludes hyphens that are part of JSDoc tag syntax
- * @param {string} text - The text to check
- * @param {boolean} isFirstLineOfTag - True if this is the first line (tag line)
- * @returns {boolean} - True if the text starts with a list marker
- */
-const startsWithListMarker = (text, isFirstLineOfTag = false) => {
-  // On the first line of a tag, the hyphen is typically the JSDoc separator,
-  // not a list marker
-  if (isFirstLineOfTag) {
-    return false;
-  }
-
-  // Match lines that start with optional whitespace, then a list marker
-  // - or * followed by a space
-  // or a number followed by . or ) and a space
-  return /^\s*(?:[\-*]|\d+(?:\.|\)))\s+/v.test(text);
-};
-
-/**
- * @typedef {{
- *   hasNoTypes: boolean,
- *   maxNamedTagLength: import('./iterateJsdoc.js').Integer,
- *   maxUnnamedTagLength: import('./iterateJsdoc.js').Integer
- * }} TypelessInfo
- */
-
-const {
-  rewireSource
-} = _commentParser.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, ' ');
-};
-
-/**
- * Check if a tag or any of its lines contain list markers
- * @param {import('./iterateJsdoc.js').Integer} index - Current line index
- * @param {import('comment-parser').Line[]} source - All source lines
- * @returns {{hasListMarker: boolean, tagStartIndex: import('./iterateJsdoc.js').Integer}}
- */
-const checkForListMarkers = (index, source) => {
-  let hasListMarker = false;
-  let tagStartIndex = index;
-  while (tagStartIndex > 0 && source[tagStartIndex].tokens.tag === '') {
-    tagStartIndex--;
-  }
-  for (let idx = tagStartIndex; idx <= index; idx++) {
-    const isFirstLine = idx === tagStartIndex;
-    if (source[idx]?.tokens?.description && startsWithListMarker(source[idx].tokens.description, isFirstLine)) {
-      hasListMarker = true;
-      break;
-    }
-  }
-  return {
-    hasListMarker,
-    tagStartIndex
-  };
-};
-
-/**
- * Calculate extra indentation for list items relative to the first continuation line
- * @param {import('./iterateJsdoc.js').Integer} index - Current line index
- * @param {import('./iterateJsdoc.js').Integer} tagStartIndex - Index of the tag line
- * @param {import('comment-parser').Line[]} source - All source lines
- * @returns {string} - Extra indentation spaces
- */
-const calculateListExtraIndent = (index, tagStartIndex, source) => {
-  // Find the first continuation line to use as baseline
-  let firstContinuationIndent = null;
-  for (let idx = tagStartIndex + 1; idx < source.length; idx++) {
-    if (source[idx].tokens.description && !source[idx].tokens.tag) {
-      firstContinuationIndent = source[idx].tokens.postDelimiter.length;
-      break;
-    }
-  }
-
-  // Calculate the extra indentation of current line relative to the first continuation line
-  const currentOriginalIndent = source[index].tokens.postDelimiter.length;
-  const extraIndent = firstContinuationIndent !== null && currentOriginalIndent > firstContinuationIndent ? ' '.repeat(currentOriginalIndent - firstContinuationIndent) : '';
-  return extraIndent;
-};
-
-/**
- * @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) {
-        const {
-          hasListMarker,
-          tagStartIndex
-        } = checkForListMarkers(index, source);
-        if (hasListMarker && index > tagStartIndex) {
-          const extraIndent = calculateListExtraIndent(index, tagStartIndex, source);
-          tokens.postDelimiter += wrapIndent + extraIndent;
-        } else {
-          // Normal case: add wrapIndent after the aligned delimiter
-          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;
-      })
-    });
-  };
-};
-var _default = exports.default = alignTransform;
-module.exports = exports.default;
-//# sourceMappingURL=alignTransform.cjs.map