@storm-software/eslint 0.138.0 → 0.139.0

package/README.md

@@ -21,7 +21,7 @@ This package is part of the <b>⚡Storm-Ops</b> monorepo. The Storm-Ops packages
 
 <h3 align="center">💻 Visit <a href="https://stormsoftware.com" target="_blank">stormsoftware.com</a> to stay up to date with this developer</h3><br />
 
-[![Version](https://img.shields.io/badge/version-0.137.4-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://prettier.io/)&nbsp;[![Nx](https://img.shields.io/badge/Nx-17.0.2-lightgrey?style=for-the-badge&logo=nx&logoWidth=20&&color=1fb2a6)](http://nx.dev/)&nbsp;[![NextJs](https://img.shields.io/badge/Next.js-14.0.2-lightgrey?style=for-the-badge&logo=nextdotjs&logoWidth=20&color=1fb2a6)](https://nextjs.org/)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;[![documented with Fumadocs](https://img.shields.io/badge/documented_with-fumadocs-success.svg?style=for-the-badge&logo=readthedocs&color=1fb2a6)](https://fumadocs.vercel.app/)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/storm-ops/cr.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
+[![Version](https://img.shields.io/badge/version-0.138.1-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://prettier.io/)&nbsp;[![Nx](https://img.shields.io/badge/Nx-17.0.2-lightgrey?style=for-the-badge&logo=nx&logoWidth=20&&color=1fb2a6)](http://nx.dev/)&nbsp;[![NextJs](https://img.shields.io/badge/Next.js-14.0.2-lightgrey?style=for-the-badge&logo=nextdotjs&logoWidth=20&color=1fb2a6)](https://nextjs.org/)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;[![documented with Fumadocs](https://img.shields.io/badge/documented_with-fumadocs-success.svg?style=for-the-badge&logo=readthedocs&color=1fb2a6)](https://fumadocs.vercel.app/)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/storm-ops/cr.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
 
 <!-- prettier-ignore-start -->
 <!-- markdownlint-disable -->

package/dist/chunk-7JRBTALJ.js

@@ -0,0 +1,91 @@
+import {
+  correctPaths
+} from "./chunk-G7QVU75O.js";
+import {
+  __name
+} from "./chunk-SHUYVCID.js";
+
+// src/utils/find-workspace-root.ts
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+var MAX_PATH_SEARCH_DEPTH = 30;
+var depth = 0;
+function findFolderUp(startPath, endFileNames = [], endDirectoryNames = []) {
+  const _startPath = startPath ?? process.cwd();
+  if (endDirectoryNames.some((endDirName) => existsSync(join(_startPath, endDirName)))) {
+    return _startPath;
+  }
+  if (endFileNames.some((endFileName) => existsSync(join(_startPath, endFileName)))) {
+    return _startPath;
+  }
+  if (_startPath !== "/" && depth++ < MAX_PATH_SEARCH_DEPTH) {
+    const parent = join(_startPath, "..");
+    return findFolderUp(parent, endFileNames, endDirectoryNames);
+  }
+  return void 0;
+}
+__name(findFolderUp, "findFolderUp");
+var rootFiles = [
+  "storm-workspace.json",
+  "storm-workspace.json",
+  "storm-workspace.yaml",
+  "storm-workspace.yml",
+  "storm-workspace.js",
+  "storm-workspace.ts",
+  ".storm-workspace.json",
+  ".storm-workspace.yaml",
+  ".storm-workspace.yml",
+  ".storm-workspace.js",
+  ".storm-workspace.ts",
+  "lerna.json",
+  "nx.json",
+  "turbo.json",
+  "npm-workspace.json",
+  "yarn-workspace.json",
+  "pnpm-workspace.json",
+  "npm-workspace.yaml",
+  "yarn-workspace.yaml",
+  "pnpm-workspace.yaml",
+  "npm-workspace.yml",
+  "yarn-workspace.yml",
+  "pnpm-workspace.yml",
+  "npm-lock.json",
+  "yarn-lock.json",
+  "pnpm-lock.json",
+  "npm-lock.yaml",
+  "yarn-lock.yaml",
+  "pnpm-lock.yaml",
+  "npm-lock.yml",
+  "yarn-lock.yml",
+  "pnpm-lock.yml",
+  "bun.lockb"
+];
+var rootDirectories = [
+  ".storm-workspace",
+  ".nx",
+  ".github",
+  ".vscode",
+  ".verdaccio"
+];
+function findWorkspaceRootSafe(pathInsideMonorepo) {
+  if (process.env.STORM_WORKSPACE_ROOT || process.env.NX_WORKSPACE_ROOT_PATH) {
+    return correctPaths(process.env.STORM_WORKSPACE_ROOT ?? process.env.NX_WORKSPACE_ROOT_PATH);
+  }
+  return correctPaths(findFolderUp(pathInsideMonorepo ?? process.cwd(), rootFiles, rootDirectories));
+}
+__name(findWorkspaceRootSafe, "findWorkspaceRootSafe");
+function findWorkspaceRoot(pathInsideMonorepo) {
+  const result = findWorkspaceRootSafe(pathInsideMonorepo);
+  if (!result) {
+    throw new Error(`Cannot find workspace root upwards from known path. Files search list includes: 
+${rootFiles.join("\n")}
+Path: ${pathInsideMonorepo ? pathInsideMonorepo : process.cwd()}`);
+  }
+  return result;
+}
+__name(findWorkspaceRoot, "findWorkspaceRoot");
+
+export {
+  findWorkspaceRootSafe,
+  findWorkspaceRoot
+};

package/dist/{chunk-GXNMSXDL.js → chunk-D3EN5HD2.js}

@@ -1,16 +1,19 @@
+import {
+  joinPaths
+} from "./chunk-G7QVU75O.js";
 import {
   __name
 } from "./chunk-SHUYVCID.js";
 
 // src/utils/tsconfig-path.ts
 import { existsSync } from "node:fs";
-function getTsConfigPath() {
+function getTsConfigPath(basePath = "./") {
   let tsconfigPath = "tsconfig.json";
-  if (existsSync("tsconfig.base.json")) {
+  if (existsSync(joinPaths(basePath, "tsconfig.base.json"))) {
     tsconfigPath = "tsconfig.base.json";
-  } else if (existsSync("tsconfig.app.json")) {
+  } else if (existsSync(joinPaths(basePath, "tsconfig.app.json"))) {
     tsconfigPath = "tsconfig.app.json";
-  } else if (existsSync("tsconfig.lib.json")) {
+  } else if (existsSync(joinPaths(basePath, "tsconfig.lib.json"))) {
     tsconfigPath = "tsconfig.lib.json";
   } else {
     console.warn("No tsconfig.json found. Consider adding a tsconfig.json file to your project's ESLint configuration.");

package/dist/{chunk-BXVDD33Y.js → chunk-VMGPCABA.js}

@@ -1,6 +1,6 @@
 import {
   getFileBanner
-} from "./chunk-KDHZD7SF.js";
+} from "./chunk-ZUIV57VZ.js";
 import {
   GLOB_SRC
 } from "./chunk-AIKLBIPC.js";
@@ -166,11 +166,11 @@ var bannerRule = ESLintUtils.RuleCreator(() => `https://docs.stormsoftware.com/e
     {
       repositoryName: "",
       commentType: "block",
-      numNewlines: 1,
+      numNewlines: 2,
       lineEndings: "unix"
     }
   ],
-  create(context, [{ banner, repositoryName = "", commentType = "block", numNewlines = 1, lineEndings = "unix" }]) {
+  create(context, [{ banner, repositoryName = "", commentType = "block", numNewlines = 2, lineEndings = "unix" }]) {
     if (!banner) {
       banner = getFileBanner(repositoryName);
     }

package/dist/{chunk-KDHZD7SF.js → chunk-ZUIV57VZ.js}

@@ -6,15 +6,15 @@ import {
 } from "./chunk-SHUYVCID.js";
 
 // src/utils/get-file-banner.ts
-var getFileBanner = /* @__PURE__ */ __name((name = "") => {
-  if (!name) {
-    name = process.env.STORM_NAME || "";
+var getFileBanner = /* @__PURE__ */ __name((repositoryName = "") => {
+  if (!repositoryName) {
+    repositoryName = process.env.STORM_NAME || "";
   }
   let padding = "                               ";
-  for (let i = 0; i < name.length + 2 && padding.length > 4; i++) {
+  for (let i = 0; i < repositoryName.length + 2 && padding.length > 4; i++) {
     padding = padding.slice(0, -1);
   }
-  let titleName = name;
+  let titleName = repositoryName;
   if (titleName) {
     if (titleName?.startsWith("@")) {
       titleName = titleName.slice(1);
@@ -36,10 +36,10 @@ ${padding}\u26A1 Storm Software ${titleName ? `- ${titleName}` : ""}
  our licensing page.
 
  Website:         ${process.env.STORM_HOMEPAGE ?? "https://stormsoftware.com"}
- Repository:      ${process.env.STORM_REPOSITORY ?? `https://github.com/storm-software${name ? `/${name}` : ""}`}
- Documentation:   ${process.env.STORM_DOCS ? process.env.STORM_DOCS : `https://stormsoftware.com/${name ? `projects/${name}/` : ""}docs`}
+ Repository:      ${process.env.STORM_REPOSITORY ?? `https://github.com/storm-software${repositoryName ? `/${repositoryName}` : ""}`}
+ Documentation:   ${process.env.STORM_DOCS ? process.env.STORM_DOCS : `https://stormsoftware.com/${repositoryName ? `projects/${repositoryName}/` : ""}docs`}
  Contact:         ${process.env.STORM_HOMEPAGE ? process.env.STORM_HOMEPAGE.endsWith("/") ? process.env.STORM_HOMEPAGE.slice(-1) : process.env.STORM_HOMEPAGE : "https://stormsoftware.com"}/contact
- License:         ${process.env.STORM_LICENSING ? process.env.STORM_LICENSING : `https://stormsoftware.com/${name ? `projects/${name}/` : ""}license`}
+ License:         ${process.env.STORM_LICENSING ? process.env.STORM_LICENSING : `https://stormsoftware.com/${repositoryName ? `projects/${repositoryName}/` : ""}license`}
 
  ------------------------------------------------------------------- `;
 }, "getFileBanner");

package/dist/preset.d.ts

@@ -27,6 +27,6 @@ declare function getOverrides<K extends keyof OptionsConfig>(options: OptionsCon
  * @param options - The preset options.
  * @param userConfigs - Additional ESLint configurations.
  */
-declare function getStormConfig(options: OptionsConfig & Omit<TypedFlatConfigItem, "files">, ...userConfigs: Awaitable<TypedFlatConfigItem | TypedFlatConfigItem[] | FlatConfigComposer<any, any> | Linter.Config[]>[]): FlatConfigComposer<TypedFlatConfigItem, ConfigNames>;
+declare function getStormConfig(options: OptionsConfig & Omit<TypedFlatConfigItem, "files">, ...userConfigs: Awaitable<TypedFlatConfigItem | TypedFlatConfigItem[] | FlatConfigComposer<object, string> | Linter.Config[]>[]): FlatConfigComposer<TypedFlatConfigItem, ConfigNames>;
 
 export { type ResolvedOptions, getStormConfig as default, defaultPluginRenaming, getOverrides, getStormConfig, resolveSubOptions };

package/dist/preset.js

@@ -8,14 +8,11 @@ import {
 } from "./chunk-7NZUDX62.js";
 import {
   getTsConfigPath
-} from "./chunk-GXNMSXDL.js";
+} from "./chunk-D3EN5HD2.js";
 import {
   banner_plugin_default
-} from "./chunk-BXVDD33Y.js";
-import {
-  joinPaths
-} from "./chunk-G7QVU75O.js";
-import "./chunk-KDHZD7SF.js";
+} from "./chunk-VMGPCABA.js";
+import "./chunk-ZUIV57VZ.js";
 import {
   GLOB_ASTRO,
   GLOB_ASTRO_TS,
@@ -44,6 +41,12 @@ import {
   GLOB_XML,
   GLOB_YAML
 } from "./chunk-AIKLBIPC.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-7JRBTALJ.js";
+import {
+  joinPaths
+} from "./chunk-G7QVU75O.js";
 import {
   __name
 } from "./chunk-SHUYVCID.js";
@@ -113,10 +116,6 @@ __name(astro, "astro");
 import cspellConfig from "@cspell/eslint-plugin/recommended";
 async function cspell(options = {}) {
   const { configFile = "./.vscode/cspell.json", overrides = {} } = options;
-  let workspaceConfigFile = configFile;
-  if (process.env.STORM_WORKSPACE_ROOT || process.env.NX_WORKSPACE_ROOT_PATH) {
-    workspaceConfigFile = joinPaths(process.env.STORM_WORKSPACE_ROOT || process.env.NX_WORKSPACE_ROOT_PATH || "./", configFile);
-  }
   return [
     {
       name: "storm/cspell/rules",
@@ -126,7 +125,7 @@ async function cspell(options = {}) {
         "@cspell/spellchecker": [
           "warn",
           {
-            configFile: workspaceConfigFile,
+            configFile: joinPaths(findWorkspaceRoot(), configFile),
             generateSuggestions: true,
             numSuggestions: 10,
             autoFix: true
@@ -853,7 +852,7 @@ __name(imports, "imports");
 import defu2 from "defu";
 import globalsLib from "globals";
 async function javascript(options = {}) {
-  const { lineEndings = "unix", overrides = {}, name = "", globals = {} } = options;
+  const { lineEndings = "unix", overrides = {}, repositoryName, globals = {} } = options;
   return [
     {
       name: "storm/javascript/setup",
@@ -890,8 +889,8 @@ async function javascript(options = {}) {
           "error",
           {
             commentType: "block",
-            numNewlines: 1,
-            repositoryName: name,
+            numNewlines: 2,
+            repositoryName,
             lineEndings
           }
         ]
@@ -2423,6 +2422,7 @@ async function markdown(options = {}) {
       name: "storm/markdown/disables",
       rules: {
         "import/newline-after-import": "off",
+        "banner/banner": "off",
         "no-alert": "off",
         "no-console": "off",
         "no-labels": "off",
@@ -2703,6 +2703,44 @@ async function perfectionist() {
 }
 __name(perfectionist, "perfectionist");
 
+// src/configs/pnpm.ts
+async function pnpm(options = {}) {
+  const { overrides = {} } = options;
+  const [pluginPnpm, parserJsonc] = await Promise.all([
+    interopDefault(import("eslint-plugin-pnpm")),
+    interopDefault(import("jsonc-eslint-parser"))
+  ]);
+  return [
+    {
+      name: "storm/pnpm/setup",
+      plugins: {
+        pnpm: pluginPnpm
+      },
+      ignores: [
+        "**/node_modules/**",
+        "**/dist/**"
+      ],
+      files: [
+        "package.json",
+        "**/package.json"
+      ],
+      languageOptions: {
+        parser: parserJsonc
+      }
+    },
+    {
+      name: "storm/pnpm/rules",
+      rules: {
+        "pnpm/enforce-catalog": "error",
+        "pnpm/valid-catalog": "error",
+        "pnpm/prefer-workspace-settings": "error",
+        ...overrides
+      }
+    }
+  ];
+}
+__name(pnpm, "pnpm");
+
 // src/configs/prettier.ts
 import config from "eslint-config-prettier";
 async function prettier() {
@@ -3412,11 +3450,7 @@ __name(toml, "toml");
 
 // src/configs/typescript.ts
 async function typescript(options = {}) {
-  const { componentExts = [], overrides = {}, overridesTypeAware = {}, parserOptions = {}, type = "app" } = options;
-  let tsconfigRootDir = process.cwd();
-  if (process.env.STORM_WORKSPACE_ROOT || process.env.NX_WORKSPACE_ROOT_PATH) {
-    tsconfigRootDir = process.env.STORM_WORKSPACE_ROOT || process.env.NX_WORKSPACE_ROOT_PATH;
-  }
+  const { componentExts = [], overrides = {}, overridesTypeAware = {}, parserOptions = {}, tsdoc = "warn", type = "app" } = options;
   const files = options.files ?? [
     GLOB_TS,
     GLOB_TSX,
@@ -3430,10 +3464,8 @@ async function typescript(options = {}) {
     `${GLOB_MARKDOWN}/**`,
     GLOB_ASTRO_TS
   ];
-  let tsconfigPath = options?.tsconfigPath;
-  if (!tsconfigPath) {
-    tsconfigPath = getTsConfigPath();
-  }
+  const workspaceRoot = findWorkspaceRoot();
+  const tsconfigPath = getTsConfigPath(options?.tsconfigPath ?? workspaceRoot);
   const isTypeAware = !!tsconfigPath;
   const typeAwareRules = {
     "dot-notation": "off",
@@ -3470,6 +3502,10 @@ async function typescript(options = {}) {
     interopDefault(import("@typescript-eslint/eslint-plugin")),
     interopDefault(import("@typescript-eslint/parser"))
   ]);
+  let pluginTsdoc;
+  if (tsdoc !== false && tsdoc !== "off") {
+    pluginTsdoc = await interopDefault(import("eslint-plugin-tsdoc"));
+  }
   function makeParser(typeAware, files2, ignores2) {
     return {
       files: files2,
@@ -3489,7 +3525,7 @@ async function typescript(options = {}) {
               ],
               defaultProject: tsconfigPath
             },
-            tsconfigRootDir
+            tsconfigRootDir: workspaceRoot
           } : {},
           ...parserOptions
         }
@@ -3660,6 +3696,16 @@ async function typescript(options = {}) {
         ...overrides
       }
     },
+    pluginTsdoc && {
+      files,
+      name: "storm/typescript/rules-tsdoc",
+      plugins: {
+        tsdoc: pluginTsdoc
+      },
+      rules: {
+        "tsdoc/syntax": tsdoc
+      }
+    },
     ...isTypeAware ? [
       {
         files: filesTypeAware,
@@ -3671,7 +3717,7 @@ async function typescript(options = {}) {
         }
       }
     ] : []
-  ];
+  ].filter(Boolean);
 }
 __name(typescript, "typescript");
 
@@ -3851,7 +3897,7 @@ function getOverrides(options, key) {
 }
 __name(getOverrides, "getOverrides");
 function getStormConfig(options, ...userConfigs) {
-  const { name = "", globals = {}, lineEndings = "unix", astro: enableAstro = false, autoRenamePlugins = true, componentExts = [], gitignore: enableGitignore = true, jsx: enableJsx = true, cspell: enableCSpell = true, react: enableReact = false, "react-native": enableReactNative = false, regexp: enableRegexp = true, next: enableNext = false, graphql: enableGraphQL = false, storybook: enableStorybook = false, typescript: enableTypeScript = isPackageExists2("typescript"), unicorn: enableUnicorn = true, unocss: enableUnoCSS = false } = options;
+  const { repositoryName, globals = {}, lineEndings = "unix", astro: enableAstro = false, autoRenamePlugins = true, componentExts = [], gitignore: enableGitignore = true, jsx: enableJsx = true, cspell: enableCSpell = true, react: enableReact = false, "react-native": enableReactNative = false, regexp: enableRegexp = true, next: enableNext = false, graphql: enableGraphQL = false, storybook: enableStorybook = false, typescript: enableTypeScript = isPackageExists2("typescript"), unicorn: enableUnicorn = true, unocss: enableUnoCSS = false } = options;
   let isInEditor = options.isInEditor;
   if (isInEditor == null) {
     isInEditor = isInEditorEnv();
@@ -3884,7 +3930,7 @@ function getStormConfig(options, ...userConfigs) {
     tsconfigPath = getTsConfigPath();
   }
   configs2.push(ignores(options.ignores), javascript({
-    name,
+    repositoryName,
     globals,
     lineEndings,
     isInEditor,
@@ -3967,6 +4013,11 @@ function getStormConfig(options, ...userConfigs) {
       stylistic: stylisticOptions
     }));
   }
+  if (options.pnpm ?? true) {
+    configs2.push(pnpm({
+      overrides: getOverrides(options, "pnpm")
+    }));
+  }
   if (options.jsonc ?? true) {
     configs2.push(jsonc({
       overrides: getOverrides(options, "jsonc"),
@@ -4007,7 +4058,9 @@ function getStormConfig(options, ...userConfigs) {
     throw new Error('[@storm-software/eslint] The first argument should not contain the "files" property as the options are supposed to be global. Place it in the second or later config instead.');
   }
   const fusedConfig = flatConfigProps.reduce((acc, key) => {
-    if (key in options) acc[key] = options[key];
+    if (key in options) {
+      acc[key] = options[key];
+    }
     return acc;
   }, {});
   if (Object.keys(fusedConfig).length) configs2.push([

package/dist/types.d.ts

@@ -3740,6 +3740,21 @@ Backward pagination arguments
    * @see https://perfectionist.dev/rules/sort-variable-declarations
    */
   'perfectionist/sort-variable-declarations'?: Linter.RuleEntry<PerfectionistSortVariableDeclarations>
+  /**
+   * Enforce using "catalog:" in `package.json`
+   * @see https://github.com/antfu/eslint-plugin-pnpm/blob/main/src/rules/enforce-catalog.test.ts
+   */
+  'pnpm/enforce-catalog'?: Linter.RuleEntry<PnpmEnforceCatalog>
+  /**
+   * Prefer having pnpm settings in `pnpm-workspace.yaml` instead of `package.json`. This would requires pnpm v10.6+, see https://github.com/orgs/pnpm/discussions/9037.
+   * @see https://github.com/antfu/eslint-plugin-pnpm/blob/main/src/rules/prefer-workspace-settings.test.ts
+   */
+  'pnpm/prefer-workspace-settings'?: Linter.RuleEntry<PnpmPreferWorkspaceSettings>
+  /**
+   * Enforce using valid catalog in `package.json`
+   * @see https://github.com/antfu/eslint-plugin-pnpm/blob/main/src/rules/valid-catalog.test.ts
+   */
+  'pnpm/valid-catalog'?: Linter.RuleEntry<PnpmValidCatalog>
   /**
    * Require using arrow functions for callbacks
    * @see https://eslint.org/docs/latest/rules/prefer-arrow-callback
@@ -6498,6 +6513,11 @@ Backward pagination arguments
    * @see https://typescript-eslint.io/rules/use-unknown-in-catch-callback-variable
    */
   'ts/use-unknown-in-catch-callback-variable'?: Linter.RuleEntry<[]>
+  /**
+   * Validates that TypeScript documentation comments conform to the TSDoc standard
+   * @see https://tsdoc.org/pages/packages/eslint-plugin-tsdoc
+   */
+  'tsdoc/syntax'?: Linter.RuleEntry<[]>
   /**
    * Require or disallow Unicode byte order mark (BOM)
    * @see https://eslint.org/docs/latest/rules/unicode-bom
@@ -12687,6 +12707,30 @@ type PerfectionistSortVariableDeclarations = []|[{
   
   partitionByNewLine?: boolean
 }]
+// ----- pnpm/enforce-catalog -----
+type PnpmEnforceCatalog = []|[{
+  
+  allowedProtocols?: string[]
+  
+  autofix?: boolean
+  
+  defaultCatalog?: string
+  
+  reuseExistingCatalog?: boolean
+}]
+// ----- pnpm/prefer-workspace-settings -----
+type PnpmPreferWorkspaceSettings = []|[{
+  autofix?: boolean
+}]
+// ----- pnpm/valid-catalog -----
+type PnpmValidCatalog = []|[{
+  
+  autoInsert?: boolean
+  
+  autoInsertDefaultSpecifier?: string
+  
+  autofix?: boolean
+}]
 // ----- prefer-arrow-callback -----
 type PreferArrowCallback = []|[{
   allowNamedFunctions?: boolean
@@ -16285,7 +16329,7 @@ type Yoda = []|[("always" | "never")]|[("always" | "never"), {
   onlyEquality?: boolean
 }]
 // Names of all the configs
-type ConfigNames = 'storm/cspell/rules' | 'storm/astro/setup' | 'storm/astro/rules' | 'storm/formatter/setup' | 'storm/imports/rules' | 'storm/graphql/setup' | 'storm/graphql/rules' | 'storm/graphql/relay' | 'storm/javascript/setup' | 'storm/javascript/banner' | 'storm/javascript/rules' | 'storm/jsx/rules' | 'storm/jsdoc/rules' | 'storm/jsonc/setup' | 'storm/jsonc/rules' | 'storm/markdown/setup' | 'storm/markdown/processor' | 'storm/markdown/parser' | 'storm/markdown/disables' | 'storm/mdx/setup' | 'storm/node/rules' | 'storm/nx/setup' | 'storm/nx/schema' | 'storm/nx/dependency-check' | 'storm/nx/module-boundaries' | 'storm/next/rules' | 'storm/prettier/rules' | 'storm/perfectionist/rules' | 'storm/react/setup' | 'storm/react/rules' | 'storm/react-native/rules' | 'storm/sort/package-json' | 'storm/stylistic/rules' | 'storm/secrets/rules' | 'storm/storybook/setup' | 'storm/storybook/rules' | 'storm/storybook/main' | 'storm/test/setup' | 'storm/test/rules' | 'storm/toml/setup' | 'storm/toml/rules' | 'storm/regexp/rules' | 'storm/typescript/setup' | 'storm/typescript/parser' | 'storm/typescript/type-aware-parser' | 'storm/typescript/rules' | 'storm/typescript/rules-type-aware' | 'storm/unicorn/rules' | 'storm/unocss' | 'storm/yaml/setup' | 'storm/yaml/rules'
+type ConfigNames = 'storm/cspell/rules' | 'storm/astro/setup' | 'storm/astro/rules' | 'storm/formatter/setup' | 'storm/imports/rules' | 'storm/graphql/setup' | 'storm/graphql/rules' | 'storm/graphql/relay' | 'storm/javascript/setup' | 'storm/javascript/banner' | 'storm/javascript/rules' | 'storm/jsx/rules' | 'storm/jsdoc/rules' | 'storm/jsonc/setup' | 'storm/jsonc/rules' | 'storm/markdown/setup' | 'storm/markdown/processor' | 'storm/markdown/parser' | 'storm/markdown/disables' | 'storm/mdx/setup' | 'storm/node/rules' | 'storm/nx/setup' | 'storm/nx/schema' | 'storm/nx/dependency-check' | 'storm/nx/module-boundaries' | 'storm/next/rules' | 'storm/prettier/rules' | 'storm/perfectionist/rules' | 'storm/pnpm/setup' | 'storm/pnpm/rules' | 'storm/react/setup' | 'storm/react/rules' | 'storm/react-native/rules' | 'storm/sort/package-json' | 'storm/stylistic/rules' | 'storm/secrets/rules' | 'storm/storybook/setup' | 'storm/storybook/rules' | 'storm/storybook/main' | 'storm/test/setup' | 'storm/test/rules' | 'storm/toml/setup' | 'storm/toml/rules' | 'storm/regexp/rules' | 'storm/typescript/setup' | 'storm/typescript/parser' | 'storm/typescript/type-aware-parser' | 'storm/typescript/rules' | 'storm/typescript/rules-tsdoc' | 'storm/typescript/rules-type-aware' | 'storm/unicorn/rules' | 'storm/unocss' | 'storm/yaml/setup' | 'storm/yaml/rules'
 
 /**
  * Vendor types from Prettier so we don't rely on the dependency.
@@ -16523,6 +16567,14 @@ interface OptionsTypeScriptWithTypes {
      * Override type aware rules.
      */
     overridesTypeAware?: TypedFlatConfigItem["rules"];
+    /**
+     * The rule to use for eslint-plugin-tsdoc syntax checking. If set to `false`, it will disable the plugin.
+     *
+     * @see https://github.com/microsoft/tsdoc/tree/master/eslint-plugin
+     *
+     * @defaultValue 'warn'
+     */
+    tsdoc?: "warn" | "error" | "off" | false;
 }
 interface OptionsHasTypeScript {
     typescript?: boolean;
@@ -16770,7 +16822,7 @@ interface OptionsJavascript {
     /**
      * The name of the repository used in adding the banner comments
      */
-    name: string;
+    repositoryName?: string;
     /**
      * An object containing a list of extra global variables to include in the configuration.
      */
@@ -16823,6 +16875,14 @@ interface OptionsConfig extends OptionsComponentExts, OptionsJavascript, Options
      * Enable Nx monorepo support.
      */
     nx?: OptionsNx;
+    /**
+     * Enable PNPM related rules.
+     *
+     * @see https://github.com/antfu/pnpm-workspace-utils/tree/main/packages/eslint-plugin-pnpm
+     *
+     * @defaultValue true
+     */
+    pnpm?: boolean | OptionsOverrides;
     /**
      * Enable JSX related rules.
      *

package/dist/utils/banner-plugin.js

@@ -1,7 +1,7 @@
 import {
   banner_plugin_default
-} from "../chunk-BXVDD33Y.js";
-import "../chunk-KDHZD7SF.js";
+} from "../chunk-VMGPCABA.js";
+import "../chunk-ZUIV57VZ.js";
 import "../chunk-AIKLBIPC.js";
 import "../chunk-SHUYVCID.js";
 export {

package/dist/utils/find-workspace-root.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Find the monorepo root directory, searching upwards from `path`.
+ *
+ * @param pathInsideMonorepo - The path inside the monorepo to start searching from
+ * @returns The monorepo root directory
+ */
+declare function findWorkspaceRootSafe(pathInsideMonorepo?: string): string | undefined;
+/**
+ * Find the monorepo root directory, searching upwards from `path`.
+ *
+ * @param pathInsideMonorepo - The path inside the monorepo to start searching from
+ * @returns The monorepo root directory
+ */
+declare function findWorkspaceRoot(pathInsideMonorepo?: string): string;
+
+export { findWorkspaceRoot, findWorkspaceRootSafe };

package/dist/utils/find-workspace-root.js

@@ -0,0 +1,10 @@
+import {
+  findWorkspaceRoot,
+  findWorkspaceRootSafe
+} from "../chunk-7JRBTALJ.js";
+import "../chunk-G7QVU75O.js";
+import "../chunk-SHUYVCID.js";
+export {
+  findWorkspaceRoot,
+  findWorkspaceRootSafe
+};

package/dist/utils/get-file-banner.d.ts

@@ -1,9 +1,9 @@
 /**
  * Get a banner header to display at the top of a file
  *
- * @param name - The name to use in the display
+ * @param repositoryName - The name to use in the display
  * @returns The banner header
  */
-declare const getFileBanner: (name?: string) => string;
+declare const getFileBanner: (repositoryName?: string) => string;
 
 export { getFileBanner };

package/dist/utils/get-file-banner.js

@@ -1,6 +1,6 @@
 import {
   getFileBanner
-} from "../chunk-KDHZD7SF.js";
+} from "../chunk-ZUIV57VZ.js";
 import "../chunk-AIKLBIPC.js";
 import "../chunk-SHUYVCID.js";
 export {

package/dist/utils/index.js

@@ -1,9 +1,6 @@
 import {
   DEFAULT_IGNORES
 } from "../chunk-NXBMVNV2.js";
-import {
-  formatConfig
-} from "../chunk-FTXILLLE.js";
 import {
   ACRONYMS_LIST,
   GLOB_ALL_SRC,
@@ -40,6 +37,9 @@ import {
   GLOB_XML,
   GLOB_YAML
 } from "../chunk-AIKLBIPC.js";
+import {
+  formatConfig
+} from "../chunk-FTXILLLE.js";
 import "../chunk-SHUYVCID.js";
 export {
   ACRONYMS_LIST,

package/dist/utils/tsconfig-path.d.ts

@@ -1,3 +1,3 @@
-declare function getTsConfigPath(): string;
+declare function getTsConfigPath(basePath?: string): string;
 
 export { getTsConfigPath };

package/dist/utils/tsconfig-path.js

@@ -1,6 +1,7 @@
 import {
   getTsConfigPath
-} from "../chunk-GXNMSXDL.js";
+} from "../chunk-D3EN5HD2.js";
+import "../chunk-G7QVU75O.js";
 import "../chunk-SHUYVCID.js";
 export {
   getTsConfigPath

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storm-software/eslint",
-  "version": "0.138.0",
+  "version": "0.139.0",
   "type": "module",
   "description": "⚡ A package containing the base ESLint configuration used by Storm Software across many projects.",
   "repository": {
@@ -186,6 +186,7 @@
     "eslint-plugin-no-secrets": "^2.2.1",
     "eslint-plugin-paths": "^1.1.0",
     "eslint-plugin-perfectionist": "^4.9.0",
+    "eslint-plugin-pnpm": "^0.1.2",
     "eslint-plugin-prettier": "^5.2.3",
     "eslint-plugin-regexp": "^2.7.0",
     "eslint-plugin-toml": "^0.12.0",