eslint-plugin-sonarjs 4.0.2 → 4.1.0

package/types/S6439/generated-meta.d.ts

@@ -14,4 +14,5 @@ export declare const meta: {
 export declare const sonarKey = "S6439";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
-export declare const requiredDependency: never[];
+export declare const requiredDependency: string[];
+export declare const skipOnGeneratedSource = false;

package/types/S6442/generated-meta.d.ts

@@ -14,4 +14,5 @@ export declare const meta: {
 export declare const sonarKey = "S6442";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
-export declare const requiredDependency: never[];
+export declare const requiredDependency: string[];
+export declare const skipOnGeneratedSource = false;

package/types/S6443/generated-meta.d.ts

@@ -14,4 +14,5 @@ export declare const meta: {
 export declare const sonarKey = "S6443";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
-export declare const requiredDependency: never[];
+export declare const requiredDependency: string[];
+export declare const skipOnGeneratedSource = false;

package/types/S6486/generated-meta.d.ts

@@ -15,3 +15,4 @@ export declare const sonarKey = "S6486";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
 export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/S6564/generated-meta.d.ts

@@ -15,3 +15,4 @@ export declare const sonarKey = "S6564";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
 export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/S6594/generated-meta.d.ts

@@ -15,3 +15,4 @@ export declare const sonarKey = "S6594";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
 export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = true;

package/types/S6627/generated-meta.d.ts

@@ -15,3 +15,4 @@ export declare const sonarKey = "S6627";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
 export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/S6759/generated-meta.d.ts

@@ -15,3 +15,4 @@ export declare const sonarKey = "S6759";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
 export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/S6958/generated-meta.d.ts

@@ -15,3 +15,4 @@ export declare const sonarKey = "S6958";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
 export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/S6959/generated-meta.d.ts

@@ -15,3 +15,4 @@ export declare const sonarKey = "S6959";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
 export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/S7059/generated-meta.d.ts

@@ -15,3 +15,5 @@ export declare const sonarKey = "S7059";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
 export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;
+export declare const requiredEcmaVersion = 2017;

package/types/S7639/generated-meta.d.ts

@@ -15,3 +15,4 @@ export declare const sonarKey = "S7639";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
 export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/S7790/generated-meta.d.ts

@@ -15,3 +15,4 @@ export declare const sonarKey = "S7790";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
 export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/S8441/generated-meta.d.ts

@@ -15,3 +15,4 @@ export declare const sonarKey = "S8441";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
 export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/{S4787 → S8479}/generated-meta.d.ts

@@ -5,13 +5,14 @@ export declare const meta: {
         description: string;
         recommended: boolean;
         url: string;
-        requiresTypeChecking: false;
+        requiresTypeChecking: true;
     };
     fixable: undefined;
-    deprecated: true;
+    deprecated: false;
     defaultOptions: never[];
 };
-export declare const sonarKey = "S4787";
+export declare const sonarKey = "S8479";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
 export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/S8479/meta.d.ts

@@ -0,0 +1,2 @@
+export declare const implementation = "original";
+export declare const eslintId = "dompurify-unsafe-config";

package/types/S8754/generated-meta.d.ts

@@ -0,0 +1,18 @@
+export * from './meta.js';
+export declare const meta: {
+    type: "suggestion";
+    docs: {
+        description: string;
+        recommended: boolean;
+        url: string;
+        requiresTypeChecking: false;
+    };
+    fixable: undefined;
+    deprecated: false;
+    defaultOptions: never[];
+};
+export declare const sonarKey = "S8754";
+export declare const scope = "Tests";
+export declare const languages: ('js' | 'ts')[];
+export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/{S5743 → S8754}/meta.d.ts

@@ -1,3 +1,3 @@
 export declare const implementation = "original";
-export declare const eslintId = "dns-prefetching";
+export declare const eslintId = "no-duplicate-test-title";
 export declare const hasSecondaries = true;

package/types/{S4817 → S8780}/generated-meta.d.ts

@@ -8,10 +8,11 @@ export declare const meta: {
         requiresTypeChecking: false;
     };
     fixable: undefined;
-    deprecated: true;
+    deprecated: false;
     defaultOptions: never[];
 };
-export declare const sonarKey = "S4817";
-export declare const scope = "Main";
+export declare const sonarKey = "S8780";
+export declare const scope = "Tests";
 export declare const languages: ('js' | 'ts')[];
 export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/S8780/meta.d.ts

@@ -0,0 +1,2 @@
+export declare const implementation = "original";
+export declare const eslintId = "async-test-assertions";

package/types/S8781/generated-meta.d.ts

@@ -0,0 +1,18 @@
+export * from './meta.js';
+export declare const meta: {
+    type: "suggestion";
+    docs: {
+        description: string;
+        recommended: boolean;
+        url: string;
+        requiresTypeChecking: false;
+    };
+    fixable: undefined;
+    deprecated: false;
+    defaultOptions: never[];
+};
+export declare const sonarKey = "S8781";
+export declare const scope = "Tests";
+export declare const languages: ('js' | 'ts')[];
+export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/S8781/meta.d.ts

@@ -0,0 +1,2 @@
+export declare const implementation = "original";
+export declare const eslintId = "no-empty-test-title";

package/types/S8782/generated-meta.d.ts

@@ -0,0 +1,18 @@
+export * from './meta.js';
+export declare const meta: {
+    type: "suggestion";
+    docs: {
+        description: string;
+        recommended: boolean;
+        url: string;
+        requiresTypeChecking: false;
+    };
+    fixable: undefined;
+    deprecated: false;
+    defaultOptions: never[];
+};
+export declare const sonarKey = "S8782";
+export declare const scope = "Tests";
+export declare const languages: ('js' | 'ts')[];
+export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/S8782/meta.d.ts

@@ -0,0 +1,2 @@
+export declare const implementation = "original";
+export declare const eslintId = "hooks-before-test-cases";

package/types/S8783/generated-meta.d.ts

@@ -0,0 +1,18 @@
+export * from './meta.js';
+export declare const meta: {
+    type: "suggestion";
+    docs: {
+        description: string;
+        recommended: boolean;
+        url: string;
+        requiresTypeChecking: false;
+    };
+    fixable: undefined;
+    deprecated: false;
+    defaultOptions: never[];
+};
+export declare const sonarKey = "S8783";
+export declare const scope = "Tests";
+export declare const languages: ('js' | 'ts')[];
+export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/S8783/meta.d.ts

@@ -0,0 +1,2 @@
+export declare const implementation = "original";
+export declare const eslintId = "no-forced-browser-interaction";

package/types/{S4784 → S8786}/generated-meta.d.ts

@@ -1,6 +1,6 @@
 export * from './meta.js';
 export declare const meta: {
-    type: "problem";
+    type: "suggestion";
     docs: {
         description: string;
         recommended: boolean;
@@ -8,10 +8,11 @@ export declare const meta: {
         requiresTypeChecking: false;
     };
     fixable: undefined;
-    deprecated: true;
+    deprecated: false;
     defaultOptions: never[];
 };
-export declare const sonarKey = "S4784";
+export declare const sonarKey = "S8786";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
 export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/S8786/meta.d.ts

@@ -0,0 +1,2 @@
+export declare const implementation = "original";
+export declare const eslintId = "super-linear-regex";

package/types/S881/generated-meta.d.ts

@@ -15,3 +15,4 @@ export declare const sonarKey = "S881";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
 export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/S888/generated-meta.d.ts

@@ -15,3 +15,4 @@ export declare const sonarKey = "S888";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
 export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/S930/generated-meta.d.ts

@@ -15,3 +15,4 @@ export declare const sonarKey = "S930";
 export declare const scope = "Main";
 export declare const languages: ('js' | 'ts')[];
 export declare const requiredDependency: never[];
+export declare const skipOnGeneratedSource = false;

package/types/helpers/assertions-chai-common.d.ts

@@ -0,0 +1,7 @@
+import type estree from 'estree';
+export type ChaiPredicate = 'truthy' | 'falsy' | 'defined' | 'undefined' | 'null';
+export declare function getChaiPropertyPredicate(name: string): {
+    predicate: ChaiPredicate;
+    negated: boolean;
+} | null;
+export declare function getArgumentAtIndex(node: estree.CallExpression, index: number): estree.Node | null;

package/types/helpers/assertions-chai.d.ts

@@ -0,0 +1,4 @@
+import type { Rule } from 'eslint';
+import type estree from 'estree';
+import type { Assertion } from './assertions.js';
+export declare function extractChaiAssertion(context: Rule.RuleContext, node: estree.Node, allowGlobal: boolean): Assertion | null;

package/types/helpers/assertions-cypress.d.ts

@@ -0,0 +1,7 @@
+import type estree from 'estree';
+import type { Assertion } from './assertions.js';
+/**
+ * Covers Cypress chain assertions like `cy.wrap(value).should('be.true')` or `cy.wrap(value).and('be.null')`.
+ * The predicate is a Chai assertion string (dot-separated, optional `not.` prefix).
+ */
+export declare function extractCypressChainAssertion(node: estree.Node): Assertion | null;

package/types/helpers/assertions.d.ts

@@ -0,0 +1,39 @@
+import type { Rule } from 'eslint';
+import type estree from 'estree';
+type AssertionPredicate = 'truthy' | 'falsy' | 'defined' | 'undefined' | 'null';
+export type AssertionStyle = 'jest-like' | 'jasmine' | 'chai-bdd' | 'chai-assert' | 'cypress' | 'playwright' | 'node-assert';
+/**
+ * Cross-framework representation of a test assertion
+ */
+export type Assertion = PredicateAssertion | ComparisonAssertion;
+type AssertionBase = {
+    style: AssertionStyle;
+    node: estree.Node;
+    reportNode: estree.Node;
+    negated: boolean;
+};
+/**
+ * Covers predicate assertions:
+ * Jest: `expect(value).toBeTruthy()`, `expect(value).toBeNull()`, ...
+ * Node.js: `assert.ok(value)`, `assert.strictEqual(value, null)`, ...
+ * chai: `assert.ok(value)`, `assert.isNull(value)`, ...
+ */
+type PredicateAssertion = AssertionBase & {
+    kind: 'predicate';
+    predicate: AssertionPredicate;
+    actual: estree.Node;
+};
+/**
+ * Covers comparision assertions:
+ * Jest: `expect(value).toBe(value)`
+ * Node.js: `assert.strictEqual(value, value)`
+ * chai: `assert.strictEqual(value, value)`, `expect(value).toEqual(value)`, `value.should.equal(value)`, ...
+ */
+type ComparisonAssertion = AssertionBase & {
+    kind: 'comparison';
+    comparison: 'strict' | 'deep' | 'loose';
+    actual: estree.Node;
+    expected: estree.Node;
+};
+export declare function extractTestAssertion(context: Rule.RuleContext, node: estree.Node): Assertion | null;
+export {};

package/types/helpers/ast.d.ts

@@ -41,6 +41,11 @@ export declare function isCallingMethod(callExpr: estree.CallExpression, arity:
 };
 export declare function isModuleExports(node: estree.Node): boolean;
 export declare function isFunctionNode(node: estree.Node): node is FunctionNodeType;
+/**
+ * Returns whether a node shares its start or end line with an enclosing
+ * template literal.
+ */
+export declare function isOnEnclosingTemplateDelimiterLine(node: TSESTree.Node): boolean;
 export declare function isLiteral(n: estree.Node | null): n is estree.Literal;
 export declare function isNullLiteral(n: estree.Node): boolean;
 export declare function isFalseLiteral(n: estree.Node): boolean;
@@ -56,6 +61,10 @@ export declare function isElementWrite(statement: estree.ExpressionStatement, re
 export declare function isReferenceTo(ref: Scope.Reference, node: estree.Node): boolean;
 export declare function getUniqueWriteUsage(context: Rule.RuleContext, name: string, node: estree.Node): estree.Node | undefined;
 export declare function getUniqueWriteReference(variable: Scope.Variable | undefined): estree.Node | undefined;
+/**
+ * Returns all read references reachable from `scope`, including nested scopes.
+ */
+export declare function collectReferences(scope: Scope.Scope): Scope.Reference[];
 export declare function getUniqueWriteUsageOrNode(context: Rule.RuleContext, node: estree.Node, recursive?: boolean): estree.Node;
 export declare function getValueOfExpression<T extends estree.Node['type']>(context: Rule.RuleContext, expr: estree.Node | undefined | null, type: T, recursive?: boolean): Extract<estree.Node, {
     type: T;
@@ -96,6 +105,7 @@ export declare function resolveFromFunctionReference(context: Rule.RuleContext,
 export declare function resolveFunction(context: Rule.RuleContext, node: estree.Node): estree.Function | null;
 export declare function checkSensitiveCall(context: Rule.RuleContext, callExpression: estree.CallExpression, sensitiveArgumentIndex: number, sensitiveProperty: string, sensitivePropertyValue: boolean, message: string): void;
 export declare function isStringLiteral(node: estree.Node): node is StringLiteral;
+export declare function hasStringFirstArgument(node: estree.CallExpression): boolean;
 export declare function isBooleanLiteral(node: estree.Node): node is estree.Literal & {
     value: boolean;
 };

package/types/helpers/configs.d.ts

@@ -1,3 +1,4 @@
+import type { Rule } from 'eslint';
 type Default = string | boolean | number | string[] | number[] | Object;
 type ESLintConfigurationDefaultProperty = {
     default: Default;
@@ -28,42 +29,10 @@ type ESLintConfigurationNamedProperty = ESLintConfigurationProperty & {
 type ESLintConfigurationElement = ESLintConfigurationNamedProperty[] | ESLintConfigurationProperty;
 export type ESLintConfiguration = ESLintConfigurationElement[];
 export declare function defaultOptions(configuration?: ESLintConfiguration): Default[] | undefined;
-/**
- * Applies `customForConfiguration` transformations to merged configuration values.
- *
- * When SonarQube sends rule parameters, the values may not match what the underlying
- * ESLint rule expects. For example, S1441 (quotes) exposes a boolean `singleQuotes`
- * property in SonarQube, but the ESLint rule expects the string `"single"` or `"double"`.
- * The `customForConfiguration` function on a field definition bridges this gap.
- *
- * This function walks the `mergedValues` array (the result of merging default options
- * with user-provided configurations) and applies any `customForConfiguration` transform
- * found in the corresponding `fields` element. It handles both configuration patterns:
- *
- * - **Primitive elements** (e.g., S1441's boolean → string mapping): the transform is
- *   called directly on the merged value.
- * - **Object elements** (e.g., S6418's `randomnessSensibility` string → number): each
- *   named property within the object is checked individually, and only properties that
- *   define `customForConfiguration` are transformed.
- *
- * Values without a corresponding field definition or without `customForConfiguration`
- * are passed through unchanged.
- *
- * @param fields - The rule's field definitions from its `config.ts` (may contain transforms)
- * @param mergedValues - The merged configuration array (defaults + user overrides)
- * @returns A new array with transformed values ready to pass to the ESLint rule
- *
- * @example
- * // S1441: primitive transform (boolean → string)
- * // fields[0] has customForConfiguration: (v) => v ? 'single' : 'double'
- * applyTransformations(fields, [true, {avoidEscape: true}])
- * // → ['single', {avoidEscape: true}]
- *
- * @example
- * // S6418: object property transform (string → number)
- * // fields[0][1] has customForConfiguration: (v) => Number(v)
- * applyTransformations(fields, [{secretWords: 'api_key', randomnessSensibility: '5.0'}])
- * // → [{secretWords: 'api_key', randomnessSensibility: 5}]
- */
-export declare function applyTransformations(fields: ESLintConfiguration | undefined, mergedValues: unknown[] | undefined): unknown[];
+type RuleMetaWithFields = {
+    fields?: ESLintConfiguration;
+};
+export declare function materializeRuleOptions(ruleMeta: RuleMetaWithFields | undefined, ruleModule: Rule.RuleModule | undefined, configurations?: unknown[]): unknown[];
+export declare function mergeRuleOptions(...optionSets: (unknown[] | undefined)[]): unknown[];
+export declare function isObjectLike(value: unknown): value is Record<string, unknown>;
 export {};

package/types/helpers/cypress.d.ts

@@ -0,0 +1,11 @@
+import type estree from 'estree';
+import ts from 'typescript';
+/**
+ * Detects Cypress assertion calls on the global `cy` chain, e.g.:
+ *   cy.get('selector').should('be.visible')
+ *   cy.contains('text').and('have.attr', 'href')
+ *   cy.intercept(...).as(...); cy.wait('@alias').its('foo').should(...)
+ */
+export declare function isAssertion(node: estree.Node): boolean;
+export declare function isTSAssertion(node: ts.Node): boolean;
+export declare function chainStartsWithCy(node: estree.Node): boolean;

package/types/helpers/dependency-manifests/all-in-parent-dirs.d.ts

@@ -0,0 +1,18 @@
+import type { Filesystem } from '../find-up/find-minimatch.js';
+import type { PackageJson } from 'type-fest';
+import { type NormalizedAbsolutePath } from '../files.js';
+import type { Rule } from 'eslint';
+import { type DependencyManifest } from './resolvers/types.js';
+/**
+ * Returns the project manifests that are used to resolve the dependencies imported by
+ * the module named `filename`, up to the passed working directory.
+ */
+export declare const getPackageJsonManifests: (dir: NormalizedAbsolutePath, topDir?: NormalizedAbsolutePath, fileSystem?: Filesystem) => Array<PackageJson>;
+export declare const getPackageJsonManifestsSanitizePaths: (context: Rule.RuleContext, fileSystem?: Filesystem) => Array<PackageJson>;
+/**
+ * Returns dependency manifest files from closest-to-file and then up to root.
+ *
+ * For each directory, at most one Deno manifest is selected (`deno.json` > `deno.jsonc`)
+ * and `package.json` is always included when present.
+ */
+export declare const getDependencyManifests: (dir: NormalizedAbsolutePath, topDir?: NormalizedAbsolutePath, fileSystem?: Filesystem) => DependencyManifest[];

package/types/helpers/dependency-manifests/closest.d.ts

@@ -0,0 +1,5 @@
+import { type NormalizedAbsolutePath } from '../files.js';
+/**
+ * Finds the closest directory containing at least one dependency manifest.
+ */
+export declare function getClosestDependencyManifestDir(dir: NormalizedAbsolutePath, topDir?: NormalizedAbsolutePath): NormalizedAbsolutePath | undefined;

package/types/helpers/dependency-manifests/dependencies.d.ts

@@ -0,0 +1,73 @@
+import type { Rule } from 'eslint';
+import { ComputedCache } from '../cache.js';
+import { type NormalizedAbsolutePath } from '../files.js';
+import { type DependenciesList, type ModuleType } from './resolvers/types.js';
+/**
+ * Cache for the available dependencies by dirname. Exported for tests
+ */
+export declare const dependenciesCache: ComputedCache<NormalizedAbsolutePath, DependenciesList, NormalizedAbsolutePath>;
+/**
+ * Cache for module type signal by dirname. Exported for tests.
+ */
+export declare const moduleTypeCache: ComputedCache<NormalizedAbsolutePath, ModuleType | undefined, NormalizedAbsolutePath>;
+/**
+ * Retrieve the dependencies of all the dependency manifest files available for the given file.
+ *
+ * @param dir dirname of the context.filename
+ * @param topDir working dir, will search up to that root
+ * @returns Map of dependency names to their version strings
+ */
+export declare function getDependencies(dir: NormalizedAbsolutePath, topDir: NormalizedAbsolutePath): DependenciesList;
+/**
+ * Retrieve the module type signal for a file.
+ *
+ * Extension-specific module kinds (.mjs/.mts and .cjs/.cts) are explicit and
+ * take precedence. Otherwise, package.json#type from the closest manifest only
+ * is used. If that closest manifest exists but omits "type", default to CommonJS.
+ */
+export declare function getModuleType(filePath: NormalizedAbsolutePath, topDir: NormalizedAbsolutePath): ModuleType | undefined;
+export declare function setCurrentFileInlineDependencies(deps: DependenciesList | null): void;
+/**
+ * Merges inline npm: imports with manifest dependencies, giving precedence to inline imports.
+ */
+export declare function withCurrentFileInlineDependencies(manifest: DependenciesList): DependenciesList;
+export declare function getDependenciesSanitizePaths(context: Rule.RuleContext): DependenciesList;
+/**
+ * Gets the React version from the closest package.json.
+ *
+ * @param context ESLint rule context
+ * @returns React version string (coerced from range) or null if not found
+ */
+export declare function getReactVersion(context: Rule.RuleContext): string | null;
+/**
+ * Parses a React version string and returns a valid semver version.
+ * Exported for testing purposes.
+ *
+ * @param reactVersion Version string from package.json (e.g., "^18.0.0", "19.0", "catalog:frontend")
+ * @returns Valid semver version string or null if parsing fails
+ */
+export declare function parseReactVersion(reactVersion: string): string | null;
+export declare function getTypeScriptSignalsFromPackageJsonFiles(packageJsonFiles: Iterable<{
+    fileContent: string;
+}>): {
+    typeScriptVersionSignals: string[];
+    hasTypeScriptNativePreview: boolean;
+};
+/**
+ * Gets a Node.js version signal by walking up from `dir` toward `topDir`,
+ * picking the closest package.json with @types/node (preferred) or engines.node.
+ *
+ * @param dir directory to start the upward search from (e.g. tsconfig dir, file dir)
+ * @param topDir analysis base directory; walk stops here. Defaults to `dir` to
+ *   preserve the legacy "manifest at exactly this dir" semantics for callers
+ *   that don't yet provide a separate analysis root.
+ * @returns raw version string from @types/node or engines.node, or null if not found
+ */
+export declare function getNodeVersionSignal(dir: NormalizedAbsolutePath, topDir?: NormalizedAbsolutePath): string | null;
+/**
+ * Gets a TypeScript version signal from the closest package.json walking up
+ * from `dir` to `topDir`. Defaults `topDir = dir` for backward compatibility.
+ *
+ * @returns raw version string from typescript dependency, or null if not found
+ */
+export declare function getTypeScriptVersionSignal(dir: NormalizedAbsolutePath, topDir?: NormalizedAbsolutePath): string | null;

package/types/helpers/dependency-manifests/index.d.ts

@@ -0,0 +1,22 @@
+import type { File, NormalizedAbsolutePath } from '../files.js';
+export declare const PACKAGE_JSON = "package.json";
+export declare const DENO_JSON = "deno.json";
+export declare const DENO_JSONC = "deno.jsonc";
+export declare const PNPM_WORKSPACE_YAML = "pnpm-workspace.yaml";
+export declare const DEPENDENCY_MANIFESTS: readonly ["deno.json", "deno.jsonc", "package.json"];
+export declare const PRELOADABLE_DEPENDENCY_MANIFESTS: readonly ["deno.json", "deno.jsonc", "package.json", "pnpm-workspace.yaml"];
+export type PreloadableDependencyManifestName = (typeof PRELOADABLE_DEPENDENCY_MANIFESTS)[number];
+export declare function isPreloadableDependencyManifestPath(path: NormalizedAbsolutePath): boolean;
+/**
+ * Preloads manifest lookup caches so later rules can resolve manifests
+ * without re-walking the file system.
+ */
+export declare function fillManifestCaches(manifestName: PreloadableDependencyManifestName, manifests: Map<NormalizedAbsolutePath, File>, dirnameToParent: Map<NormalizedAbsolutePath, NormalizedAbsolutePath | undefined>, topDir: NormalizedAbsolutePath): void;
+/**
+ * In the case of SonarIDE, when a dependency manifest file changes, the cache can become obsolete.
+ */
+export declare function clearDependenciesCache(): void;
+/**
+ * Returns the preloadable dependency manifest filename if the path points to one.
+ */
+export declare function getPreloadableDependencyManifestName(path: NormalizedAbsolutePath): PreloadableDependencyManifestName | undefined;

package/types/helpers/dependency-manifests/parse.d.ts

@@ -0,0 +1,12 @@
+import type { PackageJson } from 'type-fest';
+import { type DependenciesList } from './resolvers/types.js';
+export declare function addDependencies(result: DependenciesList, dependencies: PackageJson.Dependency, isGlob?: boolean): void;
+export declare function addDependenciesArray(result: DependenciesList, dependencies: string[], isGlob?: boolean): void;
+type AddDependencyParameters = {
+    dependency: string;
+    isGlob: boolean;
+    version?: string;
+    alias?: string;
+};
+export declare function addDependency(result: DependenciesList, { dependency, isGlob, version, alias }: AddDependencyParameters): void;
+export {};

package/types/helpers/dependency-manifests/parsed-dependency-files.d.ts

@@ -0,0 +1,8 @@
+import type { PackageJson } from 'type-fest';
+import { type File } from '../files.js';
+import type { DenoJson, Workspace } from './resolvers/types.js';
+export declare function clearParsedDependencyFileCache(): void;
+export declare function parsePackageJson(file: File): PackageJson | undefined;
+export declare function parsePackageJsonContent(content: string, filePath?: string): PackageJson | undefined;
+export declare function parsePnpmWorkspace(file: File): Workspace | undefined;
+export declare function parseDenoManifest(file: File): DenoJson | undefined;

package/types/helpers/dependency-manifests/resolvers/deno.d.ts

@@ -0,0 +1,12 @@
+import type { ManifestResolver } from './types.js';
+type ImportMapSpecifier = {
+    packageName: string;
+    version?: string;
+};
+export declare const denoManifestResolver: ManifestResolver;
+/**
+ * Parses an import map URL Specifier matching Deno npm format:
+ * npm:<package>[@<version>][/<path>]
+ */
+export declare function parseInlineNPMImport(value: string): ImportMapSpecifier | undefined;
+export {};

package/types/helpers/dependency-manifests/resolvers/helpers.d.ts

@@ -0,0 +1,12 @@
+import { type NormalizedAbsolutePath, type File } from '../../files.js';
+import type { Filesystem } from '../../find-up/find-minimatch.js';
+/**
+ * Returns the manifest file at exactly `dir` (not a parent directory), or `undefined` if absent.
+ */
+export declare function getManifestFileInDir(manifestName: string, dir: NormalizedAbsolutePath, topDir: NormalizedAbsolutePath, fileSystem?: Filesystem): File | undefined;
+/**
+ * Get the parent directory of the given path.
+ * @param path Path to get the parent directory of.
+ * @returns The parent directory or `null` if it is the root directory.
+ */
+export declare function getParentDirPath(path: NormalizedAbsolutePath): NormalizedAbsolutePath | null;

package/types/helpers/dependency-manifests/resolvers/package-json.d.ts

@@ -0,0 +1,2 @@
+import type { ManifestResolver } from './types.js';
+export declare const packageJsonManifestResolver: ManifestResolver;