eslint-plugin-jsdoc 63.0.11 → 63.0.13

package/dist/generateRule.cjs

@@ -1,17 +1,17 @@
-/* eslint-disable no-console -- CLI */
-/**
+"use strict";
+
+var _camelcase = _interopRequireDefault(require("camelcase"));
+var _nodeFs = require("node:fs");
+var _promises = _interopRequireDefault(require("node:fs/promises"));
+var _nodePath = require("node:path");
+var _openEditor = _interopRequireDefault(require("open-editor"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); } /* eslint-disable no-console -- CLI */ /**
  * @example
  * ```shell
  * pnpm run create-rule my-new-rule -- --recommended
  * ```
  */
-
-import camelCase from 'camelcase';
-import { existsSync } from 'node:fs';
-import fs from 'node:fs/promises';
-import { resolve } from 'node:path';
-import open from 'open-editor';
-
 // Todo: Would ideally have prompts, e.g., to ask for whether
 //   type was problem/layout, etc.
 
@@ -27,14 +27,14 @@ const recommended = options.includes('--recommended');
     return;
   }
   const ruleNamesPath = './test/rules/ruleNames.json';
-  const ruleNames = JSON.parse(await fs.readFile(
+  const ruleNames = JSON.parse(await _promises.default.readFile(
   // eslint-disable-next-line unicorn/prefer-json-parse-buffer -- TypeScript
   ruleNamesPath, 'utf8'));
   if (!ruleNames.includes(ruleName)) {
     ruleNames.push(ruleName);
     ruleNames.sort();
   }
-  await fs.writeFile(ruleNamesPath, JSON.stringify(ruleNames, null, 2) + '\n');
+  await _promises.default.writeFile(ruleNamesPath, JSON.stringify(ruleNames, null, 2) + '\n');
   console.log('ruleNames', ruleNames);
   const ruleTemplate = `import iterateJsdoc from '../iterateJsdoc.js';
 
@@ -63,10 +63,10 @@ export default iterateJsdoc(({
   },
 });
 `;
-  const camelCasedRuleName = camelCase(ruleName);
+  const camelCasedRuleName = (0, _camelcase.default)(ruleName);
   const rulePath = `./src/rules/${camelCasedRuleName}.js`;
-  if (!existsSync(rulePath)) {
-    await fs.writeFile(rulePath, ruleTemplate);
+  if (!(0, _nodeFs.existsSync)(rulePath)) {
+    await _promises.default.writeFile(rulePath, ruleTemplate);
   }
   const ruleTestTemplate = `export default {
   invalid: [
@@ -90,8 +90,8 @@ export default iterateJsdoc(({
 };
 `;
   const ruleTestPath = `./test/rules/assertions/${camelCasedRuleName}.js`;
-  if (!existsSync(ruleTestPath)) {
-    await fs.writeFile(ruleTestPath, ruleTestTemplate);
+  if (!(0, _nodeFs.existsSync)(ruleTestPath)) {
+    await _promises.default.writeFile(ruleTestPath, ruleTestTemplate);
   }
   const ruleReadmeTemplate = `# \`${ruleName}\`
 
@@ -116,8 +116,8 @@ export default iterateJsdoc(({
 <!-- assertions-passing ${camelCasedRuleName} -->
 `;
   const ruleReadmePath = `./.README/rules/${ruleName}.md`;
-  if (!existsSync(ruleReadmePath)) {
-    await fs.writeFile(ruleReadmePath, ruleReadmeTemplate);
+  if (!(0, _nodeFs.existsSync)(ruleReadmePath)) {
+    await _promises.default.writeFile(ruleReadmePath, ruleReadmeTemplate);
   }
 
   /**
@@ -150,7 +150,7 @@ export default iterateJsdoc(({
      * @type {OffsetInfo[]}
      */
     const offsets = [];
-    let readme = await fs.readFile(path, 'utf8');
+    let readme = await _promises.default.readFile(path, 'utf8');
     readme.replace(oldRegex,
     /**
      * @param {string} matchedLine
@@ -199,7 +199,7 @@ export default iterateJsdoc(({
       console.log(`Rule name is already present in ${checkName}.`);
     } else {
       readme = readme.slice(0, item.offset) + (item.offset ? '\n' : '') + newLine + (item.offset ? '' : '\n') + readme.slice(item.offset);
-      await fs.writeFile(path, readme);
+      await _promises.default.writeFile(path, readme);
     }
   };
 
@@ -229,8 +229,8 @@ export default iterateJsdoc(({
     oldRegex: /\n\s{2}'(?<oldRule>[^']*)': [^,]*,/gv,
     path: './src/index-cjs.js'
   });
-  await import('./buildEntryFileForTS.js');
-  await import('./generateDocs.js');
+  await Promise.resolve().then(() => _interopRequireWildcard(require('./buildEntryFileForTS.js')));
+  await Promise.resolve().then(() => _interopRequireWildcard(require('./generateDocs.js')));
 
   /*
   console.log('Paths to open for further editing\n');
@@ -240,8 +240,8 @@ export default iterateJsdoc(({
   */
 
   // Set chdir as somehow still in operation from other test
-  process.chdir(resolve(__dirname, '../../'));
-  await open([
+  process.chdir((0, _nodePath.resolve)(__dirname, '../../'));
+  await (0, _openEditor.default)([
   // Could even add editor line column numbers like `${rulePath}:1:1`
   ruleReadmePath, ruleTestPath, rulePath]);
 })();

package/dist/generateRule.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"generateRule.cjs","names":[],"sources":["../src/bin/generateRule.js"],"sourcesContent":["/* eslint-disable no-console -- CLI */\n/**\n * @example\n * ```shell\n * pnpm run create-rule my-new-rule -- --recommended\n * ```\n */\n\nimport camelCase from 'camelcase';\nimport {\n  existsSync,\n} from 'node:fs';\nimport fs from 'node:fs/promises';\nimport {\n  resolve,\n} from 'node:path';\nimport open from 'open-editor';\n\n// Todo: Would ideally have prompts, e.g., to ask for whether\n//   type was problem/layout, etc.\n\nconst [\n  , , ruleName,\n  ...options\n] = process.argv;\n\nconst recommended = options.includes('--recommended');\n\n(async () => {\n  if (!ruleName) {\n    console.error('Please supply a rule name');\n\n    return;\n  }\n\n  if ((/[A-Z]/v).test(ruleName)) {\n    console.error('Please ensure the rule has no capital letters');\n\n    return;\n  }\n\n  const ruleNamesPath = './test/rules/ruleNames.json';\n  const ruleNames = JSON.parse(await fs.readFile(\n    // eslint-disable-next-line unicorn/prefer-json-parse-buffer -- TypeScript\n    ruleNamesPath, 'utf8',\n  ));\n  if (!ruleNames.includes(ruleName)) {\n    ruleNames.push(ruleName);\n    ruleNames.sort();\n  }\n\n  await fs.writeFile(ruleNamesPath, JSON.stringify(ruleNames, null, 2) + '\\n');\n  console.log('ruleNames', ruleNames);\n\n  const ruleTemplate = `import iterateJsdoc from '../iterateJsdoc.js';\n\nexport default iterateJsdoc(({\n  context,\n  utils,\n}) => {\n  // Rule here\n}, {\n  iterateAllJsdocs: true,\n  meta: {\n    docs: {\n      description: '',\n      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/${ruleName}.md#repos-sticky-header',\n    },\n    schema: [\n      {\n        additionalProperties: false,\n        properties: {\n          // Option properties here (or remove the object)\n        },\n        type: 'object',\n      },\n    ],\n    type: 'suggestion',\n  },\n});\n`;\n\n  const camelCasedRuleName = camelCase(ruleName);\n\n  const rulePath = `./src/rules/${camelCasedRuleName}.js`;\n\n  if (!existsSync(rulePath)) {\n    await fs.writeFile(rulePath, ruleTemplate);\n  }\n\n  const ruleTestTemplate = `export default {\n  invalid: [\n    {\n      code: \\`\n      \\`,\n      errors: [\n        {\n          line: 2,\n          message: '',\n        },\n      ],\n    },\n  ],\n  valid: [\n    {\n      code: \\`\n      \\`,\n    },\n  ],\n};\n`;\n\n  const ruleTestPath = `./test/rules/assertions/${camelCasedRuleName}.js`;\n  if (!existsSync(ruleTestPath)) {\n    await fs.writeFile(ruleTestPath, ruleTestTemplate);\n  }\n\n  const ruleReadmeTemplate = `# \\`${ruleName}\\`\n\n## Options\n\n{\"gitdown\": \"options\"}\n\n|||\n|---|---|\n|Context|everywhere|\n|Tags|\\`\\`|\n|Recommended|${recommended ? 'true' : 'false'}|\n|Settings||\n|Options||\n\n## Failing examples\n\n<!-- assertions-failing ${camelCasedRuleName} -->\n\n## Passing examples\n\n<!-- assertions-passing ${camelCasedRuleName} -->\n`;\n\n  const ruleReadmePath = `./.README/rules/${ruleName}.md`;\n  if (!existsSync(ruleReadmePath)) {\n    await fs.writeFile(ruleReadmePath, ruleReadmeTemplate);\n  }\n\n  /**\n   * @param {object} cfg\n   * @param {string} cfg.path\n   * @param {RegExp} cfg.oldRegex\n   * @param {string} cfg.checkName\n   * @param {string} cfg.newLine\n   * @param {boolean} [cfg.oldIsCamel]\n   * @returns {Promise<void>}\n   */\n  const replaceInOrder = async ({\n    checkName,\n    newLine,\n    oldIsCamel,\n    oldRegex,\n    path,\n  }) => {\n    /**\n     * @typedef {number} Integer\n     */\n    /**\n     * @typedef {{\n     *   matchedLine: string,\n     *   offset: Integer,\n     *   oldRule: string,\n     * }} OffsetInfo\n     */\n    /**\n     * @type {OffsetInfo[]}\n     */\n    const offsets = [];\n\n    let readme = await fs.readFile(path, 'utf8');\n    readme.replace(\n      oldRegex,\n      /**\n       * @param {string} matchedLine\n       * @param {string} n1\n       * @param {Integer} offset\n       * @param {string} str\n       * @param {object} groups\n       * @param {string} groups.oldRule\n       * @returns {string}\n       */\n      (matchedLine, n1, offset, str, {\n        oldRule,\n      }) => {\n        offsets.push({\n          matchedLine,\n          offset,\n          oldRule,\n        });\n\n        return matchedLine;\n      },\n    );\n\n    offsets.sort(({\n      oldRule,\n    }, {\n      oldRule: oldRuleB,\n    }) => {\n      return oldRule < oldRuleB ? -1 : (oldRule > oldRuleB ? 1 : 0);\n    });\n\n    let alreadyIncluded = false;\n    const itemIndex = offsets.findIndex(({\n      oldRule,\n    }) => {\n      alreadyIncluded ||= oldIsCamel ? camelCasedRuleName === oldRule : ruleName === oldRule;\n\n      return oldIsCamel ? camelCasedRuleName < oldRule : ruleName < oldRule;\n    });\n    let item = itemIndex !== undefined && offsets[itemIndex];\n    if (item && itemIndex === 0 &&\n\n      // This property would not always be sufficient but in this case it is.\n      oldIsCamel\n    ) {\n      item.offset = 0;\n    }\n\n    if (!item) {\n      item = /** @type {OffsetInfo} */ (offsets.pop());\n      item.offset += item.matchedLine.length;\n    }\n\n    if (alreadyIncluded) {\n      console.log(`Rule name is already present in ${checkName}.`);\n    } else {\n      readme = readme.slice(0, item.offset) +\n                (item.offset ? '\\n' : '') +\n                newLine +\n                (item.offset ? '' : '\\n') +\n                readme.slice(item.offset);\n\n      await fs.writeFile(path, readme);\n    }\n  };\n\n  // await replaceInOrder({\n  //   checkName: 'README',\n  //   newLine: `{\"gitdown\": \"include\", \"file\": \"./rules/${ruleName}.md\"}`,\n  //   oldRegex: /\\n\\{\"gitdown\": \"include\", \"file\": \".\\/rules\\/(?<oldRule>[^.]*).md\"\\}/gv,\n  //   path: './.README/README.md',\n  // });\n\n  await replaceInOrder({\n    checkName: 'index import',\n    newLine: `import ${camelCasedRuleName} from './rules/${camelCasedRuleName}.js';`,\n    oldIsCamel: true,\n    oldRegex: /\\nimport (?<oldRule>[^ ]*) from '.\\/rules\\/\\1\\.js';/gv,\n    path: './src/index-cjs.js',\n  });\n\n  await replaceInOrder({\n    checkName: 'index recommended',\n    newLine: `${' '.repeat(6)}'jsdoc/${ruleName}': ${recommended ? 'warnOrError' : '\\'off\\''},`,\n    oldRegex: /\\n\\s{6}'jsdoc\\/(?<oldRule>[^']*)': .*?,/gv,\n    path: './src/index-cjs.js',\n  });\n\n  await replaceInOrder({\n    checkName: 'index rules',\n    newLine: `${' '.repeat(2)}'${ruleName}': ${camelCasedRuleName},`,\n    oldRegex: /\\n\\s{2}'(?<oldRule>[^']*)': [^,]*,/gv,\n    path: './src/index-cjs.js',\n  });\n\n  await import('./buildEntryFileForTS.js');\n\n  await import('./generateDocs.js');\n\n  /*\n  console.log('Paths to open for further editing\\n');\n  console.log(`open ${ruleReadmePath}`);\n  console.log(`open ${rulePath}`);\n  console.log(`open ${ruleTestPath}\\n`);\n  */\n\n  // Set chdir as somehow still in operation from other test\n  process.chdir(resolve(import.meta.dirname, '../../'));\n  await open([\n    // Could even add editor line column numbers like `${rulePath}:1:1`\n    ruleReadmePath,\n    ruleTestPath,\n    rulePath,\n  ]);\n})();\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"generateRule.cjs","names":["fs","camelCase","existsSync","resolve","open"],"sources":["../src/bin/generateRule.js"],"sourcesContent":["/* eslint-disable no-console -- CLI */\n/**\n * @example\n * ```shell\n * pnpm run create-rule my-new-rule -- --recommended\n * ```\n */\n\nimport camelCase from 'camelcase';\nimport {\n  existsSync,\n} from 'node:fs';\nimport fs from 'node:fs/promises';\nimport {\n  resolve,\n} from 'node:path';\nimport open from 'open-editor';\n\n// Todo: Would ideally have prompts, e.g., to ask for whether\n//   type was problem/layout, etc.\n\nconst [\n  , , ruleName,\n  ...options\n] = process.argv;\n\nconst recommended = options.includes('--recommended');\n\n(async () => {\n  if (!ruleName) {\n    console.error('Please supply a rule name');\n\n    return;\n  }\n\n  if ((/[A-Z]/v).test(ruleName)) {\n    console.error('Please ensure the rule has no capital letters');\n\n    return;\n  }\n\n  const ruleNamesPath = './test/rules/ruleNames.json';\n  const ruleNames = JSON.parse(await fs.readFile(\n    // eslint-disable-next-line unicorn/prefer-json-parse-buffer -- TypeScript\n    ruleNamesPath, 'utf8',\n  ));\n  if (!ruleNames.includes(ruleName)) {\n    ruleNames.push(ruleName);\n    ruleNames.sort();\n  }\n\n  await fs.writeFile(ruleNamesPath, JSON.stringify(ruleNames, null, 2) + '\\n');\n  console.log('ruleNames', ruleNames);\n\n  const ruleTemplate = `import iterateJsdoc from '../iterateJsdoc.js';\n\nexport default iterateJsdoc(({\n  context,\n  utils,\n}) => {\n  // Rule here\n}, {\n  iterateAllJsdocs: true,\n  meta: {\n    docs: {\n      description: '',\n      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/${ruleName}.md#repos-sticky-header',\n    },\n    schema: [\n      {\n        additionalProperties: false,\n        properties: {\n          // Option properties here (or remove the object)\n        },\n        type: 'object',\n      },\n    ],\n    type: 'suggestion',\n  },\n});\n`;\n\n  const camelCasedRuleName = camelCase(ruleName);\n\n  const rulePath = `./src/rules/${camelCasedRuleName}.js`;\n\n  if (!existsSync(rulePath)) {\n    await fs.writeFile(rulePath, ruleTemplate);\n  }\n\n  const ruleTestTemplate = `export default {\n  invalid: [\n    {\n      code: \\`\n      \\`,\n      errors: [\n        {\n          line: 2,\n          message: '',\n        },\n      ],\n    },\n  ],\n  valid: [\n    {\n      code: \\`\n      \\`,\n    },\n  ],\n};\n`;\n\n  const ruleTestPath = `./test/rules/assertions/${camelCasedRuleName}.js`;\n  if (!existsSync(ruleTestPath)) {\n    await fs.writeFile(ruleTestPath, ruleTestTemplate);\n  }\n\n  const ruleReadmeTemplate = `# \\`${ruleName}\\`\n\n## Options\n\n{\"gitdown\": \"options\"}\n\n|||\n|---|---|\n|Context|everywhere|\n|Tags|\\`\\`|\n|Recommended|${recommended ? 'true' : 'false'}|\n|Settings||\n|Options||\n\n## Failing examples\n\n<!-- assertions-failing ${camelCasedRuleName} -->\n\n## Passing examples\n\n<!-- assertions-passing ${camelCasedRuleName} -->\n`;\n\n  const ruleReadmePath = `./.README/rules/${ruleName}.md`;\n  if (!existsSync(ruleReadmePath)) {\n    await fs.writeFile(ruleReadmePath, ruleReadmeTemplate);\n  }\n\n  /**\n   * @param {object} cfg\n   * @param {string} cfg.path\n   * @param {RegExp} cfg.oldRegex\n   * @param {string} cfg.checkName\n   * @param {string} cfg.newLine\n   * @param {boolean} [cfg.oldIsCamel]\n   * @returns {Promise<void>}\n   */\n  const replaceInOrder = async ({\n    checkName,\n    newLine,\n    oldIsCamel,\n    oldRegex,\n    path,\n  }) => {\n    /**\n     * @typedef {number} Integer\n     */\n    /**\n     * @typedef {{\n     *   matchedLine: string,\n     *   offset: Integer,\n     *   oldRule: string,\n     * }} OffsetInfo\n     */\n    /**\n     * @type {OffsetInfo[]}\n     */\n    const offsets = [];\n\n    let readme = await fs.readFile(path, 'utf8');\n    readme.replace(\n      oldRegex,\n      /**\n       * @param {string} matchedLine\n       * @param {string} n1\n       * @param {Integer} offset\n       * @param {string} str\n       * @param {object} groups\n       * @param {string} groups.oldRule\n       * @returns {string}\n       */\n      (matchedLine, n1, offset, str, {\n        oldRule,\n      }) => {\n        offsets.push({\n          matchedLine,\n          offset,\n          oldRule,\n        });\n\n        return matchedLine;\n      },\n    );\n\n    offsets.sort(({\n      oldRule,\n    }, {\n      oldRule: oldRuleB,\n    }) => {\n      return oldRule < oldRuleB ? -1 : (oldRule > oldRuleB ? 1 : 0);\n    });\n\n    let alreadyIncluded = false;\n    const itemIndex = offsets.findIndex(({\n      oldRule,\n    }) => {\n      alreadyIncluded ||= oldIsCamel ? camelCasedRuleName === oldRule : ruleName === oldRule;\n\n      return oldIsCamel ? camelCasedRuleName < oldRule : ruleName < oldRule;\n    });\n    let item = itemIndex !== undefined && offsets[itemIndex];\n    if (item && itemIndex === 0 &&\n\n      // This property would not always be sufficient but in this case it is.\n      oldIsCamel\n    ) {\n      item.offset = 0;\n    }\n\n    if (!item) {\n      item = /** @type {OffsetInfo} */ (offsets.pop());\n      item.offset += item.matchedLine.length;\n    }\n\n    if (alreadyIncluded) {\n      console.log(`Rule name is already present in ${checkName}.`);\n    } else {\n      readme = readme.slice(0, item.offset) +\n                (item.offset ? '\\n' : '') +\n                newLine +\n                (item.offset ? '' : '\\n') +\n                readme.slice(item.offset);\n\n      await fs.writeFile(path, readme);\n    }\n  };\n\n  // await replaceInOrder({\n  //   checkName: 'README',\n  //   newLine: `{\"gitdown\": \"include\", \"file\": \"./rules/${ruleName}.md\"}`,\n  //   oldRegex: /\\n\\{\"gitdown\": \"include\", \"file\": \".\\/rules\\/(?<oldRule>[^.]*).md\"\\}/gv,\n  //   path: './.README/README.md',\n  // });\n\n  await replaceInOrder({\n    checkName: 'index import',\n    newLine: `import ${camelCasedRuleName} from './rules/${camelCasedRuleName}.js';`,\n    oldIsCamel: true,\n    oldRegex: /\\nimport (?<oldRule>[^ ]*) from '.\\/rules\\/\\1\\.js';/gv,\n    path: './src/index-cjs.js',\n  });\n\n  await replaceInOrder({\n    checkName: 'index recommended',\n    newLine: `${' '.repeat(6)}'jsdoc/${ruleName}': ${recommended ? 'warnOrError' : '\\'off\\''},`,\n    oldRegex: /\\n\\s{6}'jsdoc\\/(?<oldRule>[^']*)': .*?,/gv,\n    path: './src/index-cjs.js',\n  });\n\n  await replaceInOrder({\n    checkName: 'index rules',\n    newLine: `${' '.repeat(2)}'${ruleName}': ${camelCasedRuleName},`,\n    oldRegex: /\\n\\s{2}'(?<oldRule>[^']*)': [^,]*,/gv,\n    path: './src/index-cjs.js',\n  });\n\n  await import('./buildEntryFileForTS.js');\n\n  await import('./generateDocs.js');\n\n  /*\n  console.log('Paths to open for further editing\\n');\n  console.log(`open ${ruleReadmePath}`);\n  console.log(`open ${rulePath}`);\n  console.log(`open ${ruleTestPath}\\n`);\n  */\n\n  // Set chdir as somehow still in operation from other test\n  process.chdir(resolve(import.meta.dirname, '../../'));\n  await open([\n    // Could even add editor line column numbers like `${rulePath}:1:1`\n    ruleReadmePath,\n    ruleTestPath,\n    rulePath,\n  ]);\n})();\n"],"mappings":"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","ignoreList":[]}

package/dist/generateRuleTypes.cjs

@@ -1,12 +1,15 @@
-import index from '../index.js';
-import { compile } from 'json-schema-to-typescript';
-import { writeFile } from 'node:fs/promises';
+"use strict";
+
+var _index = _interopRequireDefault(require("../index.cjs"));
+var _jsonSchemaToTypescript = require("json-schema-to-typescript");
+var _promises = require("node:fs/promises");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 let str = 'export interface Rules {\n';
 for (const [ruleName, rule] of Object.entries(/** @type {Record<string, import('@eslint/core').RuleDefinition<import('@eslint/core').RuleDefinitionTypeOptions>>} */
-index.rules)) {
+_index.default.rules)) {
   str += `  /** ${rule.meta?.docs?.description ?? ''} */\n`;
   str += `  "jsdoc/${ruleName}": `;
-  const ts = await compile({
+  const ts = await (0, _jsonSchemaToTypescript.compile)({
     items: rule?.meta?.schema || [],
     type: 'array'
   }, 'Test', {
@@ -15,7 +18,7 @@ index.rules)) {
   str += ts.replace(/^export type Test = ?/v, '').replace(/^export interface Test /v, '').replaceAll('\n', '\n  ').trimEnd().replace(/;$/v, '') + ';\n\n';
 }
 str = str.replace(/\n$/v, '') + '}\n';
-await writeFile(__dirname + '/../rules.d.ts', str);
+await (0, _promises.writeFile)(__dirname + '/../rules.d.ts', str);
 
 // console.log('str', str);
 //# sourceMappingURL=generateRuleTypes.cjs.map

package/dist/generateRuleTypes.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"generateRuleTypes.cjs","names":[],"sources":["../src/bin/generateRuleTypes.js"],"sourcesContent":["import index from '../index.js';\nimport {\n  compile,\n} from 'json-schema-to-typescript';\nimport {\n  writeFile,\n} from 'node:fs/promises';\n\nlet str = 'export interface Rules {\\n';\n\nfor (const [\n  ruleName,\n  rule,\n] of Object.entries(\n  /** @type {Record<string, import('@eslint/core').RuleDefinition<import('@eslint/core').RuleDefinitionTypeOptions>>} */ (\n      index.rules\n    ),\n  )\n) {\n  str += `  /** ${rule.meta?.docs?.description ?? ''} */\\n`;\n  str += `  \"jsdoc/${ruleName}\": `;\n  const ts = await compile({\n    items: rule?.meta?.schema || [],\n    type: 'array',\n  }, 'Test', {\n    bannerComment: '',\n  });\n\n  str += ts\n    .replace(/^export type Test = ?/v, '')\n    .replace(/^export interface Test /v, '')\n    .replaceAll('\\n', '\\n  ').trimEnd().replace(/;$/v, '') +\n      ';\\n\\n';\n}\n\nstr = str.replace(/\\n$/v, '') + '}\\n';\n\nawait writeFile(import.meta.dirname + '/../rules.d.ts', str);\n\n// console.log('str', str);\n"],"mappings":"AAAA,OAAO,KAAK,MAAM,aAAa;AAC/B,SACE,OAAO,QACF,2BAA2B;AAClC,SACE,SAAS,QACJ,kBAAkB;AAEzB,IAAI,GAAG,GAAG,4BAA4B;AAEtC,KAAK,MAAM,CACT,QAAQ,EACR,IAAI,CACL,IAAI,MAAM,CAAC,OAAO,CACjB;AACI,KAAK,CAAC,KAEV,CAAC,EACD;EACA,GAAG,IAAI,SAAS,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,IAAI,EAAE,OAAO;EACzD,GAAG,IAAI,YAAY,QAAQ,KAAK;EAChC,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC;IACvB,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,IAAI,EAAE;IAC/B,IAAI,EAAE;EACR,CAAC,EAAE,MAAM,EAAE;IACT,aAAa,EAAE;EACjB,CAAC,CAAC;EAEF,GAAG,IAAI,EAAE,CACN,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CACrC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CACvC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GACpD,OAAO;AACb;AAEA,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,KAAK;AAErC,MAAM,SAAS,CAAC,YAAsB,gBAAgB,EAAE,GAAG,CAAC;;AAE5D","ignoreList":[]}
+{"version":3,"file":"generateRuleTypes.cjs","names":["index","compile","writeFile"],"sources":["../src/bin/generateRuleTypes.js"],"sourcesContent":["import index from '../index.js';\nimport {\n  compile,\n} from 'json-schema-to-typescript';\nimport {\n  writeFile,\n} from 'node:fs/promises';\n\nlet str = 'export interface Rules {\\n';\n\nfor (const [\n  ruleName,\n  rule,\n] of Object.entries(\n  /** @type {Record<string, import('@eslint/core').RuleDefinition<import('@eslint/core').RuleDefinitionTypeOptions>>} */ (\n      index.rules\n    ),\n  )\n) {\n  str += `  /** ${rule.meta?.docs?.description ?? ''} */\\n`;\n  str += `  \"jsdoc/${ruleName}\": `;\n  const ts = await compile({\n    items: rule?.meta?.schema || [],\n    type: 'array',\n  }, 'Test', {\n    bannerComment: '',\n  });\n\n  str += ts\n    .replace(/^export type Test = ?/v, '')\n    .replace(/^export interface Test /v, '')\n    .replaceAll('\\n', '\\n  ').trimEnd().replace(/;$/v, '') +\n      ';\\n\\n';\n}\n\nstr = str.replace(/\\n$/v, '') + '}\\n';\n\nawait writeFile(import.meta.dirname + '/../rules.d.ts', str);\n\n// console.log('str', str);\n"],"mappings":";;AAAA;AACA;AAGA;AAE0B;AAE1B,IAAI,GAAG,GAAG,4BAA4B;AAEtC,KAAK,MAAM,CACT,QAAQ,EACR,IAAI,CACL,IAAI,MAAM,CAAC,OAAO,CACjB;AACIA,cAAK,CAAC,KAEV,CAAC,EACD;EACA,GAAG,IAAI,SAAS,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,IAAI,EAAE,OAAO;EACzD,GAAG,IAAI,YAAY,QAAQ,KAAK;EAChC,MAAM,EAAE,GAAG,MAAM,IAAAC,wBAAA,OAAO,EAAC;IACvB,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,IAAI,EAAE;IAC/B,IAAI,EAAE;EACR,CAAC,EAAE,MAAM,EAAE;IACT,aAAa,EAAE;EACjB,CAAC,CAAC;EAEF,GAAG,IAAI,EAAE,CACN,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CACrC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CACvC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GACpD,OAAO;AACb;AAEA,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,KAAK;AAErC,MAAM,IAAAC,UAAA,SAAS,EAAC,YAAsB,gBAAgB,EAAE,GAAG,CAAC;;AAE5D","ignoreList":[]}

package/dist/getDefaultTagStructureForMode.cjs

@@ -1,3 +1,9 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
 /**
  * @typedef {Map<string, Map<string, (string|boolean)>>} TagStructure
  */
@@ -278,5 +284,6 @@ const getDefaultTagStructureForMode = mode => {
   // Shows curly brackets in the signature and in the examples
   ['typeAllowed', true]])]]);
 };
-export default getDefaultTagStructureForMode;
+var _default = exports.default = getDefaultTagStructureForMode;
+module.exports = exports.default;
 //# sourceMappingURL=getDefaultTagStructureForMode.cjs.map

package/dist/getDefaultTagStructureForMode.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getDefaultTagStructureForMode.cjs","names":[],"sources":["../src/getDefaultTagStructureForMode.js"],"sourcesContent":["/**\n * @typedef {Map<string, Map<string, (string|boolean)>>} TagStructure\n */\n/**\n * @param {import('./jsdocUtils.js').ParserMode} mode\n * @returns {TagStructure}\n */\nconst getDefaultTagStructureForMode = (mode) => {\n  const isJsdoc = mode === 'jsdoc';\n  const isClosure = mode === 'closure';\n  const isTypescript = mode === 'typescript';\n  const isPermissive = mode === 'permissive';\n\n  const isJsdocOrPermissive = isJsdoc || isPermissive;\n  const isJsdocOrTypescript = isJsdoc || isTypescript;\n  const isTypescriptOrClosure = isTypescript || isClosure;\n  const isClosureOrPermissive = isClosure || isPermissive;\n  const isJsdocTypescriptOrPermissive = isJsdocOrTypescript || isPermissive;\n\n  // Properties:\n  // `namepathRole` - 'namepath-referencing'|'name-defining'|'namepath-defining'|'namepath-or-url-referencing'|'text'|false\n  // `typeAllowed` - boolean\n  // `nameRequired` - boolean\n  // `typeRequired` - boolean\n  // `typeOrNameRequired` - boolean\n\n  // All of `typeAllowed` have a signature with \"type\" except for\n  //  `augments`/`extends` (\"namepath\")\n  //  `param`/`arg`/`argument` (no signature)\n  //  `property`/`prop` (no signature)\n  //  `modifies` (undocumented)\n\n  // None of the `namepathRole: 'namepath-defining'` show as having curly\n  //  brackets for their name/namepath\n\n  // Among `namepath-defining` and `namepath-referencing`, these do not seem\n  //  to allow curly brackets in their doc signature or examples (`modifies`\n  //  references namepaths within its type brackets)\n\n  // Todo: Should support a `tutorialID` type (for `@tutorial` block and\n  //  inline)\n\n  /**\n   * @type {TagStructure}\n   */\n  return new Map([\n    [\n      'alias', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"namepath\" (and no counter-examples)\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // \"namepath\"\n        [\n          'typeOrNameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'arg', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // See `param`\n        [\n          'nameRequired', true,\n        ],\n\n        // Has no formal signature in the docs but shows curly brackets\n        //   in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'argument', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // See `param`\n        [\n          'nameRequired', true,\n        ],\n\n        // Has no formal signature in the docs but shows curly brackets\n        //   in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'augments', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"namepath\" (and no counter-examples)\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        // Does not show curly brackets in either the signature or examples\n        [\n          'typeAllowed', true,\n        ],\n\n        // \"namepath\"\n        [\n          'typeOrNameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'borrows', new Map(/** @type {[string, string|boolean][]} */ ([\n        // `borrows` has a different format, however, so needs special parsing;\n        //   seems to require both, and as \"namepath\"'s\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        // \"namepath\"\n        [\n          'typeOrNameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'callback', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Seems to require a \"namepath\" in the signature (with no\n        //   counter-examples); TypeScript does not enforce but seems\n        //   problematic as not attached so presumably not useable without it\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // \"namepath\"\n        [\n          'nameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'class', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Not in use, but should be this value if using to power `empty-tags`\n        [\n          'nameAllowed', true,\n        ],\n\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'const', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n    [\n      'constant', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n    [\n      'constructor', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'constructs', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        [\n          'nameRequired', false,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'define', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'typeRequired', isClosure,\n        ],\n      ])),\n    ],\n\n    [\n      'emits', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"name\" (of an event) and no counter-examples\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        [\n          'nameRequired', true,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'enum', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', 'name-defining',\n        ],\n        // Has example showing curly brackets but not in doc signature\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'event', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Appears to require a \"name\" in its signature, albeit somewhat\n        //  different from other \"name\"'s (including as described\n        //  at https://jsdoc.app/about-namepaths.html )\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // The doc signature of `event` seems to require a \"name\"\n        [\n          'nameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'exception', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the signature and in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    // Closure\n    [\n      'export', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'typeAllowed', isClosureOrPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'exports', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        [\n          'nameRequired', isJsdoc,\n        ],\n\n        [\n          'typeAllowed', isClosureOrPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'extends', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"namepath\" (and no counter-examples)\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        [\n          'nameRequired', isJsdoc,\n        ],\n\n        // Does not show curly brackets in either the signature or examples\n        [\n          'typeAllowed', isTypescriptOrClosure || isPermissive,\n        ],\n\n        // \"namepath\"\n        [\n          'typeOrNameRequired', isTypescriptOrClosure || isPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'external', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Appears to require a \"name\" in its signature, albeit somewhat\n        //  different from other \"name\"'s (including as described\n        //  at https://jsdoc.app/about-namepaths.html )\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // \"name\" (and a special syntax for the `external` name)\n        [\n          'nameRequired', true,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'fires', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"name\" (of an event) and no\n        //  counter-examples\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        [\n          'nameRequired', true,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'func', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n      ])),\n    ],\n    [\n      'function', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        [\n          'nameRequired', false,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'host', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Appears to require a \"name\" in its signature, albeit somewhat\n        //  different from other \"name\"'s (including as described\n        //  at https://jsdoc.app/about-namepaths.html )\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // See `external`\n        [\n          'nameRequired', true,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'implements', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the doc signature and examples\n        // \"typeExpression\"\n        [\n          'typeRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'interface', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Not in use, but should be this value if using to power `empty-tags`\n        [\n          'nameAllowed', isClosure,\n        ],\n\n        // Allows for \"name\" in signature, but indicates as optional\n        [\n          'namepathRole',\n          isJsdocTypescriptOrPermissive ? 'namepath-defining' : false,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'internal', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Not in use, but should be this value if using to power `empty-tags`\n        [\n          'nameAllowed', false,\n        ],\n        // https://www.typescriptlang.org/tsconfig/#stripInternal\n        [\n          'namepathRole', false,\n        ],\n      ])),\n    ],\n\n    [\n      'lends', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"namepath\" (and no counter-examples)\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        // \"namepath\"\n        [\n          'typeOrNameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'link', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a namepath OR URL and might be checked as such.\n        [\n          'namepathRole', 'namepath-or-url-referencing',\n        ],\n\n      ])),\n    ],\n\n    [\n      'linkcode', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Synonym for \"link\"\n        // Signature seems to require a namepath OR URL and might be checked as such.\n        [\n          'namepathRole', 'namepath-or-url-referencing',\n        ],\n      ])),\n    ],\n\n    [\n      'linkplain', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Synonym for \"link\"\n        // Signature seems to require a namepath OR URL and might be checked as such.\n        [\n          'namepathRole', 'namepath-or-url-referencing',\n        ],\n      ])),\n    ],\n\n    [\n      'listens', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"name\" (of an event) and no\n        //  counter-examples\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        [\n          'nameRequired', true,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'member', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // Has example showing curly brackets but not in doc signature\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'memberof!', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"namepath\" (and no counter-examples),\n        //  though it allows an incomplete namepath ending with connecting symbol\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        // \"namepath\"\n        [\n          'typeOrNameRequired', true,\n        ],\n      ])),\n    ],\n    [\n      'memberof', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"namepath\" (and no counter-examples),\n        //  though it allows an incomplete namepath ending with connecting symbol\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        // \"namepath\"\n        [\n          'typeOrNameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'method', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n      ])),\n    ],\n    [\n      'mixes', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"OtherObjectPath\" with no\n        //   counter-examples\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        // \"OtherObjectPath\"\n        [\n          'typeOrNameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'mixin', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        [\n          'nameRequired', false,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'modifies', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Has no documentation, but test example has curly brackets, and\n        //  \"name\" would be suggested rather than \"namepath\" based on example;\n        //  not sure if name is required\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'module', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Optional \"name\" and no curly brackets\n        //  this block impacts `no-undefined-types` and `valid-types` (search for\n        //  \"isNameOrNamepathDefiningTag|tagMightHaveNameOrNamepath|tagMightHaveEitherTypeOrNamePosition\")\n        [\n          'namepathRole', isJsdoc ? 'namepath-defining' : 'text',\n        ],\n\n        // Shows the signature with curly brackets but not in the example\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'name', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Seems to require a \"namepath\" in the signature (with no\n        //   counter-examples)\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // \"namepath\"\n        [\n          'nameRequired', true,\n        ],\n\n        // \"namepath\"\n        [\n          'typeOrNameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'namespace', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // Shows the signature with curly brackets but not in the example\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n    [\n      'package', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows the signature with curly brackets but not in the example\n        // \"typeExpression\"\n        [\n          'typeAllowed', isClosureOrPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'param', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // Though no signature provided requiring, per\n        //  https://jsdoc.app/tags-param.html:\n        // \"The @param tag requires you to specify the name of the parameter you\n        //  are documenting.\"\n        [\n          'nameRequired', true,\n        ],\n\n        // Has no formal signature in the docs but shows curly brackets\n        //   in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'private', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows the signature with curly brackets but not in the example\n        // \"typeExpression\"\n        [\n          'typeAllowed', isClosureOrPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'prop', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // See `property`\n        [\n          'nameRequired', true,\n        ],\n\n        // Has no formal signature in the docs but shows curly brackets\n        //   in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'property', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // No docs indicate required, but since parallel to `param`, we treat as\n        //   such:\n        [\n          'nameRequired', true,\n        ],\n\n        // Has no formal signature in the docs but shows curly brackets\n        //   in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'protected', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows the signature with curly brackets but not in the example\n        // \"typeExpression\"\n        [\n          'typeAllowed', isClosureOrPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'public', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Does not show a signature nor show curly brackets in the example\n        [\n          'typeAllowed', isClosureOrPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'requires', new Map(/** @type {[string, string|boolean][]} */ ([\n        // <someModuleName>\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        [\n          'nameRequired', true,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'return', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the signature and in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n    [\n      'returns', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the signature and in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'satisfies', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the doc signature and examples\n        [\n          'typeRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'see', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature allows for \"namepath\" or text, so user must configure to\n        //  'namepath-referencing' to enforce checks\n        [\n          'namepathRole', 'text',\n        ],\n      ])),\n    ],\n\n    [\n      'static', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Does not show a signature nor show curly brackets in the example\n        [\n          'typeAllowed', isClosureOrPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'suppress', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', !isClosure,\n        ],\n        [\n          'typeRequired', isClosure,\n        ],\n      ])),\n    ],\n\n    [\n      'template', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', isJsdoc ? 'text' : 'namepath-referencing',\n        ],\n\n        [\n          'nameRequired', !isJsdoc,\n        ],\n\n        // Though defines `namepathRole: 'namepath-defining'` in a sense, it is\n        //   not parseable in the same way for template (e.g., allowing commas),\n        //   so not adding\n        [\n          'typeAllowed', isTypescriptOrClosure || isPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'this', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"namepath\" (and no counter-examples)\n        // Not used with namepath in Closure/TypeScript, however\n        [\n          'namepathRole', isJsdoc ? 'namepath-referencing' : false,\n        ],\n\n        // namepath\n        [\n          'typeOrNameRequired', isJsdoc,\n        ],\n\n        [\n          'typeRequired', isTypescriptOrClosure,\n        ],\n      ])),\n    ],\n\n    [\n      'throws', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the signature and in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'tutorial', new Map(/** @type {[string, string|boolean][]} */ ([\n        // (a tutorial ID)\n        [\n          'nameRequired', true,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'type', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the doc signature and examples\n        // \"typeName\"\n        [\n          'typeRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'typedef', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Seems to require a \"namepath\" in the signature (with no\n        //  counter-examples)\n        [\n          'namepathRole', 'name-defining',\n        ],\n\n        // TypeScript may allow it to be dropped if followed by @property or @member;\n        //   also shown as missing in Closure\n        // \"namepath\"\n        [\n          'nameRequired', isJsdocOrPermissive,\n        ],\n\n        // Is not `typeRequired` for TypeScript because it gives an error:\n        // JSDoc '@typedef' tag should either have a type annotation or be followed by '@property' or '@member' tags.\n\n        // Has example showing curly brackets but not in doc signature\n        [\n          'typeAllowed', true,\n        ],\n\n        // TypeScript may allow it to be dropped if followed by @property or @member\n        // \"namepath\"\n        [\n          'typeOrNameRequired', !isTypescript,\n        ],\n      ])),\n    ],\n\n    [\n      'var', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // Has example showing curly brackets but not in doc signature\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'yield', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the signature and in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n    [\n      'yields', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the signature and in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n  ]);\n};\n\nexport default getDefaultTagStructureForMode;\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"getDefaultTagStructureForMode.cjs","names":[],"sources":["../src/getDefaultTagStructureForMode.js"],"sourcesContent":["/**\n * @typedef {Map<string, Map<string, (string|boolean)>>} TagStructure\n */\n/**\n * @param {import('./jsdocUtils.js').ParserMode} mode\n * @returns {TagStructure}\n */\nconst getDefaultTagStructureForMode = (mode) => {\n  const isJsdoc = mode === 'jsdoc';\n  const isClosure = mode === 'closure';\n  const isTypescript = mode === 'typescript';\n  const isPermissive = mode === 'permissive';\n\n  const isJsdocOrPermissive = isJsdoc || isPermissive;\n  const isJsdocOrTypescript = isJsdoc || isTypescript;\n  const isTypescriptOrClosure = isTypescript || isClosure;\n  const isClosureOrPermissive = isClosure || isPermissive;\n  const isJsdocTypescriptOrPermissive = isJsdocOrTypescript || isPermissive;\n\n  // Properties:\n  // `namepathRole` - 'namepath-referencing'|'name-defining'|'namepath-defining'|'namepath-or-url-referencing'|'text'|false\n  // `typeAllowed` - boolean\n  // `nameRequired` - boolean\n  // `typeRequired` - boolean\n  // `typeOrNameRequired` - boolean\n\n  // All of `typeAllowed` have a signature with \"type\" except for\n  //  `augments`/`extends` (\"namepath\")\n  //  `param`/`arg`/`argument` (no signature)\n  //  `property`/`prop` (no signature)\n  //  `modifies` (undocumented)\n\n  // None of the `namepathRole: 'namepath-defining'` show as having curly\n  //  brackets for their name/namepath\n\n  // Among `namepath-defining` and `namepath-referencing`, these do not seem\n  //  to allow curly brackets in their doc signature or examples (`modifies`\n  //  references namepaths within its type brackets)\n\n  // Todo: Should support a `tutorialID` type (for `@tutorial` block and\n  //  inline)\n\n  /**\n   * @type {TagStructure}\n   */\n  return new Map([\n    [\n      'alias', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"namepath\" (and no counter-examples)\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // \"namepath\"\n        [\n          'typeOrNameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'arg', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // See `param`\n        [\n          'nameRequired', true,\n        ],\n\n        // Has no formal signature in the docs but shows curly brackets\n        //   in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'argument', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // See `param`\n        [\n          'nameRequired', true,\n        ],\n\n        // Has no formal signature in the docs but shows curly brackets\n        //   in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'augments', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"namepath\" (and no counter-examples)\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        // Does not show curly brackets in either the signature or examples\n        [\n          'typeAllowed', true,\n        ],\n\n        // \"namepath\"\n        [\n          'typeOrNameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'borrows', new Map(/** @type {[string, string|boolean][]} */ ([\n        // `borrows` has a different format, however, so needs special parsing;\n        //   seems to require both, and as \"namepath\"'s\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        // \"namepath\"\n        [\n          'typeOrNameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'callback', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Seems to require a \"namepath\" in the signature (with no\n        //   counter-examples); TypeScript does not enforce but seems\n        //   problematic as not attached so presumably not useable without it\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // \"namepath\"\n        [\n          'nameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'class', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Not in use, but should be this value if using to power `empty-tags`\n        [\n          'nameAllowed', true,\n        ],\n\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'const', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n    [\n      'constant', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n    [\n      'constructor', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'constructs', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        [\n          'nameRequired', false,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'define', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'typeRequired', isClosure,\n        ],\n      ])),\n    ],\n\n    [\n      'emits', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"name\" (of an event) and no counter-examples\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        [\n          'nameRequired', true,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'enum', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', 'name-defining',\n        ],\n        // Has example showing curly brackets but not in doc signature\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'event', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Appears to require a \"name\" in its signature, albeit somewhat\n        //  different from other \"name\"'s (including as described\n        //  at https://jsdoc.app/about-namepaths.html )\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // The doc signature of `event` seems to require a \"name\"\n        [\n          'nameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'exception', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the signature and in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    // Closure\n    [\n      'export', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'typeAllowed', isClosureOrPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'exports', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        [\n          'nameRequired', isJsdoc,\n        ],\n\n        [\n          'typeAllowed', isClosureOrPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'extends', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"namepath\" (and no counter-examples)\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        [\n          'nameRequired', isJsdoc,\n        ],\n\n        // Does not show curly brackets in either the signature or examples\n        [\n          'typeAllowed', isTypescriptOrClosure || isPermissive,\n        ],\n\n        // \"namepath\"\n        [\n          'typeOrNameRequired', isTypescriptOrClosure || isPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'external', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Appears to require a \"name\" in its signature, albeit somewhat\n        //  different from other \"name\"'s (including as described\n        //  at https://jsdoc.app/about-namepaths.html )\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // \"name\" (and a special syntax for the `external` name)\n        [\n          'nameRequired', true,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'fires', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"name\" (of an event) and no\n        //  counter-examples\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        [\n          'nameRequired', true,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'func', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n      ])),\n    ],\n    [\n      'function', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        [\n          'nameRequired', false,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'host', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Appears to require a \"name\" in its signature, albeit somewhat\n        //  different from other \"name\"'s (including as described\n        //  at https://jsdoc.app/about-namepaths.html )\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // See `external`\n        [\n          'nameRequired', true,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'implements', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the doc signature and examples\n        // \"typeExpression\"\n        [\n          'typeRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'interface', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Not in use, but should be this value if using to power `empty-tags`\n        [\n          'nameAllowed', isClosure,\n        ],\n\n        // Allows for \"name\" in signature, but indicates as optional\n        [\n          'namepathRole',\n          isJsdocTypescriptOrPermissive ? 'namepath-defining' : false,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'internal', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Not in use, but should be this value if using to power `empty-tags`\n        [\n          'nameAllowed', false,\n        ],\n        // https://www.typescriptlang.org/tsconfig/#stripInternal\n        [\n          'namepathRole', false,\n        ],\n      ])),\n    ],\n\n    [\n      'lends', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"namepath\" (and no counter-examples)\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        // \"namepath\"\n        [\n          'typeOrNameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'link', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a namepath OR URL and might be checked as such.\n        [\n          'namepathRole', 'namepath-or-url-referencing',\n        ],\n\n      ])),\n    ],\n\n    [\n      'linkcode', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Synonym for \"link\"\n        // Signature seems to require a namepath OR URL and might be checked as such.\n        [\n          'namepathRole', 'namepath-or-url-referencing',\n        ],\n      ])),\n    ],\n\n    [\n      'linkplain', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Synonym for \"link\"\n        // Signature seems to require a namepath OR URL and might be checked as such.\n        [\n          'namepathRole', 'namepath-or-url-referencing',\n        ],\n      ])),\n    ],\n\n    [\n      'listens', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"name\" (of an event) and no\n        //  counter-examples\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        [\n          'nameRequired', true,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'member', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // Has example showing curly brackets but not in doc signature\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'memberof!', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"namepath\" (and no counter-examples),\n        //  though it allows an incomplete namepath ending with connecting symbol\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        // \"namepath\"\n        [\n          'typeOrNameRequired', true,\n        ],\n      ])),\n    ],\n    [\n      'memberof', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"namepath\" (and no counter-examples),\n        //  though it allows an incomplete namepath ending with connecting symbol\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        // \"namepath\"\n        [\n          'typeOrNameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'method', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n      ])),\n    ],\n    [\n      'mixes', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"OtherObjectPath\" with no\n        //   counter-examples\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        // \"OtherObjectPath\"\n        [\n          'typeOrNameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'mixin', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        [\n          'nameRequired', false,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'modifies', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Has no documentation, but test example has curly brackets, and\n        //  \"name\" would be suggested rather than \"namepath\" based on example;\n        //  not sure if name is required\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'module', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Optional \"name\" and no curly brackets\n        //  this block impacts `no-undefined-types` and `valid-types` (search for\n        //  \"isNameOrNamepathDefiningTag|tagMightHaveNameOrNamepath|tagMightHaveEitherTypeOrNamePosition\")\n        [\n          'namepathRole', isJsdoc ? 'namepath-defining' : 'text',\n        ],\n\n        // Shows the signature with curly brackets but not in the example\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'name', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Seems to require a \"namepath\" in the signature (with no\n        //   counter-examples)\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // \"namepath\"\n        [\n          'nameRequired', true,\n        ],\n\n        // \"namepath\"\n        [\n          'typeOrNameRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'namespace', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // Shows the signature with curly brackets but not in the example\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n    [\n      'package', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows the signature with curly brackets but not in the example\n        // \"typeExpression\"\n        [\n          'typeAllowed', isClosureOrPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'param', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // Though no signature provided requiring, per\n        //  https://jsdoc.app/tags-param.html:\n        // \"The @param tag requires you to specify the name of the parameter you\n        //  are documenting.\"\n        [\n          'nameRequired', true,\n        ],\n\n        // Has no formal signature in the docs but shows curly brackets\n        //   in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'private', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows the signature with curly brackets but not in the example\n        // \"typeExpression\"\n        [\n          'typeAllowed', isClosureOrPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'prop', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // See `property`\n        [\n          'nameRequired', true,\n        ],\n\n        // Has no formal signature in the docs but shows curly brackets\n        //   in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'property', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // No docs indicate required, but since parallel to `param`, we treat as\n        //   such:\n        [\n          'nameRequired', true,\n        ],\n\n        // Has no formal signature in the docs but shows curly brackets\n        //   in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'protected', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows the signature with curly brackets but not in the example\n        // \"typeExpression\"\n        [\n          'typeAllowed', isClosureOrPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'public', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Does not show a signature nor show curly brackets in the example\n        [\n          'typeAllowed', isClosureOrPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'requires', new Map(/** @type {[string, string|boolean][]} */ ([\n        // <someModuleName>\n        [\n          'namepathRole', 'namepath-referencing',\n        ],\n\n        [\n          'nameRequired', true,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'return', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the signature and in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n    [\n      'returns', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the signature and in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'satisfies', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the doc signature and examples\n        [\n          'typeRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'see', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature allows for \"namepath\" or text, so user must configure to\n        //  'namepath-referencing' to enforce checks\n        [\n          'namepathRole', 'text',\n        ],\n      ])),\n    ],\n\n    [\n      'static', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Does not show a signature nor show curly brackets in the example\n        [\n          'typeAllowed', isClosureOrPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'suppress', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', !isClosure,\n        ],\n        [\n          'typeRequired', isClosure,\n        ],\n      ])),\n    ],\n\n    [\n      'template', new Map(/** @type {[string, string|boolean][]} */ ([\n        [\n          'namepathRole', isJsdoc ? 'text' : 'namepath-referencing',\n        ],\n\n        [\n          'nameRequired', !isJsdoc,\n        ],\n\n        // Though defines `namepathRole: 'namepath-defining'` in a sense, it is\n        //   not parseable in the same way for template (e.g., allowing commas),\n        //   so not adding\n        [\n          'typeAllowed', isTypescriptOrClosure || isPermissive,\n        ],\n      ])),\n    ],\n\n    [\n      'this', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Signature seems to require a \"namepath\" (and no counter-examples)\n        // Not used with namepath in Closure/TypeScript, however\n        [\n          'namepathRole', isJsdoc ? 'namepath-referencing' : false,\n        ],\n\n        // namepath\n        [\n          'typeOrNameRequired', isJsdoc,\n        ],\n\n        [\n          'typeRequired', isTypescriptOrClosure,\n        ],\n      ])),\n    ],\n\n    [\n      'throws', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the signature and in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'tutorial', new Map(/** @type {[string, string|boolean][]} */ ([\n        // (a tutorial ID)\n        [\n          'nameRequired', true,\n        ],\n\n        [\n          'typeAllowed', false,\n        ],\n      ])),\n    ],\n\n    [\n      'type', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the doc signature and examples\n        // \"typeName\"\n        [\n          'typeRequired', true,\n        ],\n      ])),\n    ],\n\n    [\n      'typedef', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Seems to require a \"namepath\" in the signature (with no\n        //  counter-examples)\n        [\n          'namepathRole', 'name-defining',\n        ],\n\n        // TypeScript may allow it to be dropped if followed by @property or @member;\n        //   also shown as missing in Closure\n        // \"namepath\"\n        [\n          'nameRequired', isJsdocOrPermissive,\n        ],\n\n        // Is not `typeRequired` for TypeScript because it gives an error:\n        // JSDoc '@typedef' tag should either have a type annotation or be followed by '@property' or '@member' tags.\n\n        // Has example showing curly brackets but not in doc signature\n        [\n          'typeAllowed', true,\n        ],\n\n        // TypeScript may allow it to be dropped if followed by @property or @member\n        // \"namepath\"\n        [\n          'typeOrNameRequired', !isTypescript,\n        ],\n      ])),\n    ],\n\n    [\n      'var', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Allows for \"name\"'s in signature, but indicated as optional\n        [\n          'namepathRole', 'namepath-defining',\n        ],\n\n        // Has example showing curly brackets but not in doc signature\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n\n    [\n      'yield', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the signature and in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n    [\n      'yields', new Map(/** @type {[string, string|boolean][]} */ ([\n        // Shows curly brackets in the signature and in the examples\n        [\n          'typeAllowed', true,\n        ],\n      ])),\n    ],\n  ]);\n};\n\nexport default getDefaultTagStructureForMode;\n"],"mappings":"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","ignoreList":[]}

package/dist/getJsdocProcessorPlugin.cjs

@@ -1,9 +1,16 @@
-import { forEachPreferredTag, getPreferredTagName, getRegexFromString, getTagDescription, hasTag } from './jsdocUtils.js';
-import { parseComment } from '@es-joy/jsdoccomment';
-import * as espree from 'espree';
-import { decode } from 'html-entities';
-import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getJsdocProcessorPlugin = void 0;
+var _jsdocUtils = require("./jsdocUtils.cjs");
+var _jsdoccomment = require("@es-joy/jsdoccomment");
+var espree = _interopRequireWildcard(require("espree"));
+var _htmlEntities = require("html-entities");
+var _nodeFs = require("node:fs");
+var _nodePath = require("node:path");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 /**
  * @import {
  *   Integer,
@@ -17,7 +24,7 @@ import { join } from 'node:path';
 
 const {
   version
-} = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf8'));
+} = JSON.parse((0, _nodeFs.readFileSync)((0, _nodePath.join)(__dirname, '../package.json'), 'utf8'));
 
 // const zeroBasedLineIndexAdjust = -1;
 const likelyNestedJSDocIndentSpace = 1;
@@ -85,7 +92,7 @@ const getLinesCols = text => {
  * @param {JsdocProcessorOptions} [options]
  * @returns {ESLint.Plugin}
  */
-export const getJsdocProcessorPlugin = (options = {}) => {
+const getJsdocProcessorPlugin = (options = {}) => {
   /**
    * @typedef {{
    *   text: string,
@@ -116,10 +123,10 @@ export const getJsdocProcessorPlugin = (options = {}) => {
   /** @type {RegExp} */
   let rejectExampleCodeRegExp;
   if (exampleCodeRegex) {
-    exampleCodeRegExp = typeof exampleCodeRegex === 'string' ? getRegexFromString(exampleCodeRegex) : exampleCodeRegex;
+    exampleCodeRegExp = typeof exampleCodeRegex === 'string' ? (0, _jsdocUtils.getRegexFromString)(exampleCodeRegex) : exampleCodeRegex;
   }
   if (rejectExampleCodeRegex) {
-    rejectExampleCodeRegExp = typeof rejectExampleCodeRegex === 'string' ? getRegexFromString(rejectExampleCodeRegex) : rejectExampleCodeRegex;
+    rejectExampleCodeRegExp = typeof rejectExampleCodeRegex === 'string' ? (0, _jsdocUtils.getRegexFromString)(rejectExampleCodeRegex) : rejectExampleCodeRegex;
   }
 
   /**
@@ -235,7 +242,7 @@ export const getJsdocProcessorPlugin = (options = {}) => {
             if (/^#x\d+$/v.test(code)) {
               return String.fromCodePoint(Number.parseInt(code.slice(2), 16));
             }
-            return decode(_, {
+            return (0, _htmlEntities.decode)(_, {
               level: 'html5'
             });
           })
@@ -283,12 +290,12 @@ export const getJsdocProcessorPlugin = (options = {}) => {
     };
     if (checkDefaults) {
       const filenameInfo = getFilenameInfo(matchingFileNameDefaults, 'jsdoc-defaults');
-      forEachPreferredTag(jsdoc, 'default', (tag, targetTagName) => {
+      (0, _jsdocUtils.forEachPreferredTag)(jsdoc, 'default', (tag, targetTagName) => {
         if (!tag.description.trim()) {
           return;
         }
         checkSource({
-          source: `(${getTagDescription(tag)})`,
+          source: `(${(0, _jsdocUtils.getTagDescription)(tag)})`,
           targetTagName,
           ...filenameInfo
         });
@@ -296,7 +303,7 @@ export const getJsdocProcessorPlugin = (options = {}) => {
     }
     if (checkParams) {
       const filenameInfo = getFilenameInfo(matchingFileNameParams, 'jsdoc-params');
-      forEachPreferredTag(jsdoc, 'param', (tag, targetTagName) => {
+      (0, _jsdocUtils.forEachPreferredTag)(jsdoc, 'param', (tag, targetTagName) => {
         if (!tag.default || !tag.default.trim()) {
           return;
         }
@@ -309,7 +316,7 @@ export const getJsdocProcessorPlugin = (options = {}) => {
     }
     if (checkProperties) {
       const filenameInfo = getFilenameInfo(matchingFileNameProperties, 'jsdoc-properties');
-      forEachPreferredTag(jsdoc, 'property', (tag, targetTagName) => {
+      (0, _jsdocUtils.forEachPreferredTag)(jsdoc, 'property', (tag, targetTagName) => {
         if (!tag.default || !tag.default.trim()) {
           return;
         }
@@ -323,15 +330,15 @@ export const getJsdocProcessorPlugin = (options = {}) => {
     if (!checkExamples) {
       return textsAndFileNames;
     }
-    const tagName = /** @type {string} */getPreferredTagName(jsdoc, {
+    const tagName = /** @type {string} */(0, _jsdocUtils.getPreferredTagName)(jsdoc, {
       tagName: 'example'
     });
-    if (!hasTag(jsdoc, tagName)) {
+    if (!(0, _jsdocUtils.hasTag)(jsdoc, tagName)) {
       return textsAndFileNames;
     }
     const matchingFilenameInfo = getFilenameInfo(matchingFileName);
-    forEachPreferredTag(jsdoc, 'example', (tag, targetTagName) => {
-      let source = /** @type {string} */getTagDescription(tag);
+    (0, _jsdocUtils.forEachPreferredTag)(jsdoc, 'example', (tag, targetTagName) => {
+      let source = /** @type {string} */(0, _jsdocUtils.getTagDescription)(tag);
       const match = source.match(hasCaptionRegex);
       if (captionRequired && (!match || !match[1].trim())) {
         extraMessages.push({
@@ -552,7 +559,7 @@ export const getJsdocProcessorPlugin = (options = {}) => {
               //   ? 0
               //   : textToStart.slice(lastLinePos).length;
               commentLineCols.push([lines, cols]);
-              return parseComment(comment);
+              return (0, _jsdoccomment.parseComment)(comment);
             });
             return [text, ...jsdocComments.flatMap((jsdoc, idx) => {
               return getTextsAndFileNames(jsdoc, filename, commentLineCols[idx]);
@@ -576,4 +583,5 @@ export const getJsdocProcessorPlugin = (options = {}) => {
     }
   };
 };
+exports.getJsdocProcessorPlugin = getJsdocProcessorPlugin;
 //# sourceMappingURL=getJsdocProcessorPlugin.cjs.map