build: use built-ins, resolve via package.json, and avoid rootDir

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: na
  - task: lint_package_json
    status: passed
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: passed
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: na
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: Planeshifter

lib/node_modules/@stdlib/_tools/eslint/rules/tsdoc-doctest/lib/main.js

@@ -25,12 +25,16 @@
 var vm = require( 'vm' );
 var dirname = require( 'path' ).dirname;
 var resolve = require( 'path' ).resolve;
+var join = require( 'path' ).join;
 var existsSync = require( 'fs' ).existsSync; // eslint-disable-line node/no-sync
+var readFileSync = require( 'fs' ).readFileSync; // eslint-disable-line node/no-sync
 var logger = require( 'debug' );
 var isNull = require( '@stdlib/assert/is-null' );
 var isNumber = require( '@stdlib/assert/is-number' );
 var contains = require( '@stdlib/assert/contains' );
 var replace = require( '@stdlib/string/replace' );
+var endsWith = require( '@stdlib/string/ends-with' );
+var trim = require( '@stdlib/string/trim' );
 var objectKeys = require( '@stdlib/utils/keys' );
 var compareValues = require( '@stdlib/_tools/doctest/compare-values' );
 var createAnnotationValue = require( '@stdlib/_tools/doctest/create-annotation-value' );
@@ -63,7 +67,7 @@ var rule;
 * @returns {string} escaped string
 */
 function escapeRegex( str ) {
-	return str.replace( RE_SPECIAL_CHARS, '\\$&' );
+	return replace( str, RE_SPECIAL_CHARS, '\\$&' );
 }
 
 /**
@@ -133,22 +137,73 @@ function findName( scope, expected ) {
 }
 
 /**
-* Resolves the implementation path relative to a TypeScript declaration file.
+* Finds the nearest package.json file by traversing up the directory tree.
+*
+* @private
+* @param {string} filepath - starting file path
+* @returns {string|null} path to package.json or null if not found
+*/
+function findNearestPackageJSON( filepath ) {
+	var pkgPath;
+	var dir;
+
+	dir = dirname( resolve( filepath ) );
+	while ( dir !== dirname( dir ) ) { // Stop at root
+		pkgPath = join( dir, 'package.json' );
+		if ( existsSync( pkgPath ) ) {
+			return pkgPath;
+		}
+		dir = dirname( dir );
+	}
+	return null;
+}
+
+/**
+* Resolves the implementation path from package.json.
 *
 * @private
 * @param {string} filepath - TypeScript declaration file path
-* @param {string} implementationPath - relative path to implementation
 * @returns {string|null} resolved implementation path or null if not found
 */
-function resolveImplementationPath( filepath, implementationPath ) {
+function resolveImplementationPath( filepath ) {
 	var implPath;
-	var baseDir;
+	var mainPath;
+	var pkgJSON;
+	var pkgPath;
+	var pkgDir;
+
+	// Find the nearest package.json:
+	pkgPath = findNearestPackageJSON( filepath );
+	if ( !pkgPath ) {
+		debug( 'Could not find package.json for: ' + filepath );
+		return null;
+	}
+
+	// Read and parse package.json:
+	try {
+		pkgJSON = JSON.parse( readFileSync( pkgPath, 'utf8' ) );
+	} catch ( err ) {
+		debug( 'Could not read/parse package.json: ' + pkgPath + '. Error: ' + err.message );
+		return null;
+	}
+
+	// Get the main entry point:
+	mainPath = pkgJSON.main || './lib';
+	pkgDir = dirname( pkgPath );
+	implPath = resolve( pkgDir, mainPath );
 
-	baseDir = dirname( resolve( filepath ) );
-	implPath = resolve( baseDir, implementationPath );
+	// Check if it's a directory or file:
 	if ( existsSync( implPath ) ) {
 		return implPath;
 	}
+	// Try with index.js if it's a directory:
+	if ( existsSync( join( implPath, 'index.js' ) ) ) {
+		return join( implPath, 'index.js' );
+	}
+	// Try adding .js extension:
+	if ( existsSync( implPath + '.js' ) ) {
+		return implPath + '.js';
+	}
 	return null;
 }
 
@@ -161,7 +216,7 @@ function resolveImplementationPath( filepath, implementationPath ) {
 */
 function cleanTSDocComment( comment ) {
 	// Remove opening /** and closing */
-	var cleaned = comment.replace( /^\/\*\*/, '' ).replace( /\*\/$/, '' );
+	var cleaned = replace( replace( comment, /^\/\*\*/, '' ), /\*\/$/, '' );
 
 	// Remove * at the beginning of lines
 	cleaned = replace( cleaned, RE_COMMENT_PREFIX, '' );
@@ -329,15 +384,13 @@ function processExampleCode( code, commentIdx, comments, scope, report, opts, so
 function main( context ) {
 	var sourceCode;
 	var filename;
-	var options;
 	var dir;
 
 	sourceCode = context.getSourceCode();
 	filename = context.getFilename();
-	options = context.options[ 0 ] || {};
 
 	// Only process TypeScript declaration files:
-	if ( !filename.endsWith( '.d.ts' ) ) {
+	if ( !endsWith( filename, '.d.ts' ) ) {
 		return {};
 	}
 
@@ -379,7 +432,6 @@ function main( context ) {
 	* @private
 	*/
 	function validate() {
-		var implementationPath;
 		var implPath;
 		var examples;
 		var comments;
@@ -397,11 +449,10 @@ function main( context ) {
 		regexCache = {};
 		lineCountCache = {};
 
-		// Resolve implementation path relative to TypeScript declaration file path:
-		implementationPath = options.implementationPath || '../../lib';
-		implPath = resolveImplementationPath( filename, implementationPath );
+		// Resolve implementation path from nearest package.json:
+		implPath = resolveImplementationPath( filename );
 		if ( !implPath ) {
-			debug( 'Could not resolve implementation path: ' + implementationPath + ' from ' + filename );
+			debug( 'Could not resolve implementation path from package.json for: ' + filename );
 			return;
 		}
 
@@ -442,7 +493,7 @@ function main( context ) {
 			}
 
 			for ( j = 0; j < examples.length; j++ ) {
-				code = examples[ j ].trim();
+				code = trim( examples[ j ] );
 
 				// Process the example code and validate annotations (reusing VM context):
 				processExampleCode( code, i, comments, scope, report, opts, sourceCode );
@@ -465,18 +516,7 @@ rule = {
 			'description': 'ensure return annotations in TSDoc examples match the actual output'
 		},
 		'fixable': 'code',
-		'schema': [
-			{
-				'type': 'object',
-				'properties': {
-					'implementationPath': {
-						'type': 'string',
-						'default': '../../lib'
-					}
-				},
-				'additionalProperties': false
-			}
-		]
+		'schema': []
 	},
 	'create': main
 };

lib/node_modules/@stdlib/_tools/eslint/rules/tsdoc-doctest/test/fixtures/invalid.js

@@ -21,12 +21,10 @@
 // MODULES //
 
 var join = require( 'path' ).join;
-var rootDir = require( '@stdlib/_tools/utils/root-dir' );
 
 
 // VARIABLES //
 
-var ROOT_DIR = rootDir();
 var invalid = [];
 var test;
 
@@ -49,7 +47,7 @@ test = {
 		'',
 		'export = abs;'
 	].join( '\n' ),
-	'filename': join( ROOT_DIR, 'lib/node_modules/@stdlib/math/base/special/abs/docs/types/index.d.ts' ),
+	'filename': join( __dirname, 'packages/@stdlib/math/base/special/abs/docs/types/index.d.ts' ),
 	'output': [
 		'/**',
 		'* Returns the absolute value.',
@@ -92,7 +90,7 @@ test = {
 		'',
 		'export = ctor;'
 	].join( '\n' ),
-	'filename': join( ROOT_DIR, 'lib/node_modules/@stdlib/ndarray/vector/int32/docs/types/index.d.ts' ),
+	'filename': join( __dirname, 'packages/@stdlib/ndarray/vector/int32/docs/types/index.d.ts' ),
 	'output': [
 		'/**',
 		'* Abbreviated Int32Vector example (invalid).',
@@ -139,7 +137,7 @@ test = {
 		'',
 		'export = sqrt;'
 	].join( '\n' ),
-	'filename': join( ROOT_DIR, 'lib/node_modules/@stdlib/math/base/special/sqrt/docs/types/index.d.ts' ),
+	'filename': join( __dirname, 'packages/@stdlib/math/base/special/sqrt/docs/types/index.d.ts' ),
 	'output': [
 		'/**',
 		'* Returns the square root.',
@@ -181,7 +179,7 @@ test = {
 		'',
 		'export = PI;'
 	].join( '\n' ),
-	'filename': join( ROOT_DIR, 'lib/node_modules/@stdlib/constants/float64/pi/docs/types/index.d.ts' ),
+	'filename': join( __dirname, 'packages/@stdlib/constants/float64/pi/docs/types/index.d.ts' ),
 	'output': [
 		'/**',
 		'* The mathematical constant pi.',

lib/node_modules/@stdlib/_tools/eslint/rules/tsdoc-doctest/test/fixtures/packages/@stdlib/array/complex64/lib/index.js

@@ -0,0 +1,30 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+/* eslint-disable stdlib/jsdoc-main-export */
+
+// MODULES //
+
+var Complex64Array = require( '@stdlib/array/complex64' );
+
+
+// EXPORTS //
+
+module.exports = Complex64Array;

lib/node_modules/@stdlib/_tools/eslint/rules/tsdoc-doctest/test/fixtures/packages/@stdlib/array/complex64/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@stdlib/array/complex64",
+  "version": "0.0.0",
+  "description": "64-bit complex number array.",
+  "license": "Apache-2.0",
+  "author": {
+    "name": "The Stdlib Authors",
+    "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+  },
+  "contributors": [
+    {
+      "name": "The Stdlib Authors",
+      "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+    }
+  ],
+  "scripts": {},
+  "homepage": "https://github.com/stdlib-js/stdlib",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/stdlib-js/stdlib.git"
+  },
+  "bugs": {
+    "url": "https://github.com/stdlib-js/stdlib/issues"
+  },
+  "dependencies": {},
+  "devDependencies": {},
+  "engines": {
+    "node": ">=0.10.0",
+    "npm": ">2.7.0"
+  },
+  "main": "./lib",
+  "directories": {
+    "doc": "./docs",
+    "example": "./examples",
+    "lib": "./lib",
+    "test": "./test"
+  },
+  "types": "./docs/types",
+  "keywords": [
+    "stdlib",
+    "stdtypes",
+    "types",
+    "data",
+    "structure",
+    "array",
+    "typed",
+    "typed array",
+    "typed-array",
+    "complex64",
+    "complex",
+    "cmplx",
+    "float32",
+    "single",
+    "single-precision",
+    "float",
+    "floating",
+    "floating-point"
+  ]
+}

lib/node_modules/@stdlib/_tools/eslint/rules/tsdoc-doctest/test/fixtures/packages/@stdlib/constants/float64/pi/lib/index.js

@@ -0,0 +1,30 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+/* eslint-disable stdlib/jsdoc-main-export */
+
+// MODULES //
+
+var PI = require( '@stdlib/constants/float64/pi' );
+
+
+// EXPORTS //
+
+module.exports = PI;