@rushstack/trace-import 0.6.14 → 0.7.1

package/CHANGELOG.json

@@ -1,6 +1,58 @@
 {
   "name": "@rushstack/trace-import",
   "entries": [
+    {
+      "version": "0.7.1",
+      "tag": "@rushstack/trace-import_v0.7.1",
+      "date": "Fri, 20 Feb 2026 00:15:04 GMT",
+      "comments": {
+        "patch": [
+          {
+            "comment": "Add `\"node\"` condition before `\"import\"` in the `\"exports\"` map so that Node.js uses the CJS output (which handles extensionless imports), while bundlers still use ESM via `\"import\"`. Fixes https://github.com/microsoft/rushstack/issues/5644."
+          }
+        ],
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `5.20.1`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/terminal\" to `0.22.1`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/ts-command-line\" to `5.3.1`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.2.1`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "0.7.0",
+      "tag": "@rushstack/trace-import_v0.7.0",
+      "date": "Thu, 19 Feb 2026 00:04:53 GMT",
+      "comments": {
+        "minor": [
+          {
+            "comment": "Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `\"exports\"` field in `package.json`."
+          }
+        ],
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `5.20.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/terminal\" to `0.22.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/ts-command-line\" to `5.3.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.2.0`"
+          }
+        ]
+      }
+    },
     {
       "version": "0.6.14",
       "tag": "@rushstack/trace-import_v0.6.14",

package/CHANGELOG.md

@@ -1,6 +1,20 @@
 # Change Log - @rushstack/trace-import
 
-This log was last generated on Sat, 07 Feb 2026 01:13:26 GMT and should not be manually modified.
+This log was last generated on Fri, 20 Feb 2026 00:15:04 GMT and should not be manually modified.
+
+## 0.7.1
+Fri, 20 Feb 2026 00:15:04 GMT
+
+### Patches
+
+- Add `"node"` condition before `"import"` in the `"exports"` map so that Node.js uses the CJS output (which handles extensionless imports), while bundlers still use ESM via `"import"`. Fixes https://github.com/microsoft/rushstack/issues/5644.
+
+## 0.7.0
+Thu, 19 Feb 2026 00:04:53 GMT
+
+### Minor changes
+
+- Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `"exports"` field in `package.json`.
 
 ## 0.6.14
 Sat, 07 Feb 2026 01:13:26 GMT

package/bin/trace-import

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-require('../lib/start.js');
+require('../lib-commonjs/start.js');

package/lib-esm/TraceImportCommandLineParser.js

@@ -0,0 +1,67 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { CommandLineParser } from '@rushstack/ts-command-line';
+import { InternalError } from '@rushstack/node-core-library';
+import { Colorize } from '@rushstack/terminal';
+import { traceImport } from './traceImport';
+export class TraceImportCommandLineParser extends CommandLineParser {
+    constructor() {
+        super({
+            toolFilename: 'trace-import',
+            toolDescription: 'This tool analyzes import module paths, to determine the resolved target folder.  ' +
+                'For example, if the "semver" NPM package is installed, "trace-import --path semver/index" will ' +
+                'print output equivalent to the Node.js require.resolve() API.  ' +
+                'If "@types/semver" is installed, then "trace-import --resolution-type ts --path semver/index" will ' +
+                'print the .d.ts file path that would be resolved by a TypeScript import statement.'
+        });
+        this._debugParameter = this.defineFlagParameter({
+            parameterLongName: '--debug',
+            parameterShortName: '-d',
+            description: 'Show the full call stack if an error occurs while executing the tool'
+        });
+        this._pathParameter = this.defineStringParameter({
+            parameterLongName: '--path',
+            parameterShortName: '-p',
+            description: 'The import module path to be analyzed. For example, ' +
+                '"example" in expressions such as: require("example"); require.resolve("example"); import { Thing } from "example";',
+            argumentName: 'IMPORT_PATH',
+            required: true
+        });
+        this._baseFolderParameter = this.defineStringParameter({
+            parameterLongName: '--base-folder',
+            parameterShortName: '-b',
+            description: 'The "--path" string will be resolved as if the import statement appeared in a script located in this folder.  ' +
+                'If omitted, the current working directory is used.',
+            argumentName: 'FOLDER_PATH'
+        });
+        this._resolutionTypeParameter = this.defineChoiceParameter({
+            parameterLongName: '--resolution-type',
+            parameterShortName: '-t',
+            description: 'The type of module resolution to perform:  ' +
+                '"cjs" for CommonJS, "es" for ES modules, or "ts" for TypeScript typings',
+            alternatives: ['cjs', 'es', 'ts'],
+            defaultValue: 'cjs'
+        });
+    }
+    async onExecuteAsync() {
+        if (this._debugParameter.value) {
+            InternalError.breakInDebugger = true;
+        }
+        try {
+            traceImport({
+                importPath: this._pathParameter.value,
+                baseFolder: this._baseFolderParameter.value,
+                resolutionType: this._resolutionTypeParameter.value
+            });
+        }
+        catch (error) {
+            if (this._debugParameter.value) {
+                console.error('\n' + error.stack);
+            }
+            else {
+                console.error('\n' + Colorize.red('ERROR: ' + error.message.trim()));
+            }
+        }
+    }
+}
+//# sourceMappingURL=TraceImportCommandLineParser.js.map

package/lib-esm/TraceImportCommandLineParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TraceImportCommandLineParser.js","sourceRoot":"","sources":["../src/TraceImportCommandLineParser.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,EACL,iBAAiB,EAKlB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EAAuB,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjE,MAAM,OAAO,4BAA6B,SAAQ,iBAAiB;IAMjE;QACE,KAAK,CAAC;YACJ,YAAY,EAAE,cAAc;YAC5B,eAAe,EACb,oFAAoF;gBACpF,iGAAiG;gBACjG,iEAAiE;gBACjE,qGAAqG;gBACrG,oFAAoF;SACvF,CAAC,CAAC;QAEH,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,mBAAmB,CAAC;YAC9C,iBAAiB,EAAE,SAAS;YAC5B,kBAAkB,EAAE,IAAI;YACxB,WAAW,EAAE,sEAAsE;SACpF,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,qBAAqB,CAAC;YAC/C,iBAAiB,EAAE,QAAQ;YAC3B,kBAAkB,EAAE,IAAI;YACxB,WAAW,EACT,sDAAsD;gBACtD,oHAAoH;YACtH,YAAY,EAAE,aAAa;YAC3B,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QAEH,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,qBAAqB,CAAC;YACrD,iBAAiB,EAAE,eAAe;YAClC,kBAAkB,EAAE,IAAI;YACxB,WAAW,EACT,gHAAgH;gBAChH,oDAAoD;YACtD,YAAY,EAAE,aAAa;SAC5B,CAAC,CAAC;QAEH,IAAI,CAAC,wBAAwB,GAAG,IAAI,CAAC,qBAAqB,CAAiB;YACzE,iBAAiB,EAAE,mBAAmB;YACtC,kBAAkB,EAAE,IAAI;YACxB,WAAW,EACT,6CAA6C;gBAC7C,yEAAyE;YAC3E,YAAY,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC;YACjC,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;IACL,CAAC;IAEkB,KAAK,CAAC,cAAc;QACrC,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YAC/B,aAAa,CAAC,eAAe,GAAG,IAAI,CAAC;QACvC,CAAC;QACD,IAAI,CAAC;YACH,WAAW,CAAC;gBACV,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK;gBACrC,UAAU,EAAE,IAAI,CAAC,oBAAoB,CAAC,KAAK;gBAC3C,cAAc,EAAE,IAAI,CAAC,wBAAwB,CAAC,KAAK;aACpD,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;gBAC/B,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;IACH,CAAC;CACF","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport {\n  CommandLineParser,\n  type CommandLineFlagParameter,\n  type CommandLineStringParameter,\n  type IRequiredCommandLineStringParameter,\n  type IRequiredCommandLineChoiceParameter\n} from '@rushstack/ts-command-line';\nimport { InternalError } from '@rushstack/node-core-library';\nimport { Colorize } from '@rushstack/terminal';\n\nimport { type ResolutionType, traceImport } from './traceImport';\n\nexport class TraceImportCommandLineParser extends CommandLineParser {\n  private readonly _debugParameter: CommandLineFlagParameter;\n  private readonly _pathParameter: IRequiredCommandLineStringParameter;\n  private readonly _baseFolderParameter: CommandLineStringParameter;\n  private readonly _resolutionTypeParameter: IRequiredCommandLineChoiceParameter<ResolutionType>;\n\n  public constructor() {\n    super({\n      toolFilename: 'trace-import',\n      toolDescription:\n        'This tool analyzes import module paths, to determine the resolved target folder.  ' +\n        'For example, if the \"semver\" NPM package is installed, \"trace-import --path semver/index\" will ' +\n        'print output equivalent to the Node.js require.resolve() API.  ' +\n        'If \"@types/semver\" is installed, then \"trace-import --resolution-type ts --path semver/index\" will ' +\n        'print the .d.ts file path that would be resolved by a TypeScript import statement.'\n    });\n\n    this._debugParameter = this.defineFlagParameter({\n      parameterLongName: '--debug',\n      parameterShortName: '-d',\n      description: 'Show the full call stack if an error occurs while executing the tool'\n    });\n\n    this._pathParameter = this.defineStringParameter({\n      parameterLongName: '--path',\n      parameterShortName: '-p',\n      description:\n        'The import module path to be analyzed. For example, ' +\n        '\"example\" in expressions such as: require(\"example\"); require.resolve(\"example\"); import { Thing } from \"example\";',\n      argumentName: 'IMPORT_PATH',\n      required: true\n    });\n\n    this._baseFolderParameter = this.defineStringParameter({\n      parameterLongName: '--base-folder',\n      parameterShortName: '-b',\n      description:\n        'The \"--path\" string will be resolved as if the import statement appeared in a script located in this folder.  ' +\n        'If omitted, the current working directory is used.',\n      argumentName: 'FOLDER_PATH'\n    });\n\n    this._resolutionTypeParameter = this.defineChoiceParameter<ResolutionType>({\n      parameterLongName: '--resolution-type',\n      parameterShortName: '-t',\n      description:\n        'The type of module resolution to perform:  ' +\n        '\"cjs\" for CommonJS, \"es\" for ES modules, or \"ts\" for TypeScript typings',\n      alternatives: ['cjs', 'es', 'ts'],\n      defaultValue: 'cjs'\n    });\n  }\n\n  protected override async onExecuteAsync(): Promise<void> {\n    if (this._debugParameter.value) {\n      InternalError.breakInDebugger = true;\n    }\n    try {\n      traceImport({\n        importPath: this._pathParameter.value,\n        baseFolder: this._baseFolderParameter.value,\n        resolutionType: this._resolutionTypeParameter.value\n      });\n    } catch (error) {\n      if (this._debugParameter.value) {\n        console.error('\\n' + error.stack);\n      } else {\n        console.error('\\n' + Colorize.red('ERROR: ' + error.message.trim()));\n      }\n    }\n  }\n}\n"]}

package/lib-esm/start.js

@@ -0,0 +1,14 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { PackageJsonLookup } from '@rushstack/node-core-library';
+import { Colorize } from '@rushstack/terminal';
+import { TraceImportCommandLineParser } from './TraceImportCommandLineParser';
+const toolVersion = PackageJsonLookup.loadOwnPackageJson(__dirname).version;
+console.log();
+console.log(Colorize.bold(`trace-import ${toolVersion}`) + ' - ' + Colorize.cyan('https://rushstack.io'));
+console.log();
+const commandLine = new TraceImportCommandLineParser();
+commandLine.executeAsync().catch((error) => {
+    console.error(error);
+});
+//# sourceMappingURL=start.js.map

package/lib-esm/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAE9E,MAAM,WAAW,GAAW,iBAAiB,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;AAEpF,OAAO,CAAC,GAAG,EAAE,CAAC;AACd,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,WAAW,EAAE,CAAC,GAAG,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC;AAC1G,OAAO,CAAC,GAAG,EAAE,CAAC;AAEd,MAAM,WAAW,GAAiC,IAAI,4BAA4B,EAAE,CAAC;AACrF,WAAW,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACzC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { PackageJsonLookup } from '@rushstack/node-core-library';\nimport { Colorize } from '@rushstack/terminal';\n\nimport { TraceImportCommandLineParser } from './TraceImportCommandLineParser';\n\nconst toolVersion: string = PackageJsonLookup.loadOwnPackageJson(__dirname).version;\n\nconsole.log();\nconsole.log(Colorize.bold(`trace-import ${toolVersion}`) + ' - ' + Colorize.cyan('https://rushstack.io'));\nconsole.log();\n\nconst commandLine: TraceImportCommandLineParser = new TraceImportCommandLineParser();\ncommandLine.executeAsync().catch((error) => {\n  console.error(error);\n});\n"]}

package/lib-esm/traceImport.js

@@ -0,0 +1,272 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import * as path from 'node:path';
+import * as process from 'node:process';
+import * as Resolve from 'resolve';
+import { Colorize } from '@rushstack/terminal';
+import { FileSystem, JsonFile, PackageName } from '@rushstack/node-core-library';
+const jsExtensions = ['.js', '.cjs', '.jsx', '.json'];
+const tsExtensions = ['.d.ts', '.ts', '.tsx', '.json'];
+// Somewhat loosely matches inputs such as:
+//   my-package/path/to/file.js
+//   [group 1 ][group 2       ]
+//
+//   @scope/my-package/path/to/file.js
+//   [group 1        ][group 2       ]
+//
+//   @scope/my-package
+//   [group 1        ]
+const packageImportPathRegExp = /^((?:@[a-z0-9_][a-z0-9\-_\.]*\/)?[a-z0-9_][a-z0-9\-_\.]*)(\/.*)?$/i;
+function logInputField(title, value) {
+    console.log(Colorize.cyan(title.padEnd(25)) + value);
+}
+function logOutputField(title, value) {
+    console.log(Colorize.green(title.padEnd(25)) + value);
+}
+function traceTypeScriptPackage(options) {
+    const { packageSubpath, packageFolder, packageJson, atTypes, warnings } = options;
+    // For example, if we started with importFullPath="semver/index",
+    // here we may get normalizedImportFullPath="@types/semver/index"
+    const normalizedImportFullPath = packageJson.name + packageSubpath;
+    // First try to resolve the .js main index
+    let cjsTargetPath = undefined;
+    try {
+        cjsTargetPath = Resolve.sync(normalizedImportFullPath, {
+            basedir: packageFolder,
+            preserveSymlinks: false,
+            extensions: jsExtensions
+        });
+    }
+    catch (error) {
+        // not found
+    }
+    const mainIndexTitle = atTypes ? '@types main index:' : 'Main index:';
+    if (cjsTargetPath) {
+        const parsedPath = path.parse(cjsTargetPath);
+        // Is the resolved .js extension okay?
+        if (tsExtensions.indexOf(parsedPath.ext.toLocaleLowerCase()) >= 0) {
+            logOutputField(mainIndexTitle, '(inferred from .js main index)');
+            console.log();
+            logOutputField('Target path:', cjsTargetPath);
+            return true;
+        }
+        // Try to replace the file extension
+        const dtsTargetPath = path.join(parsedPath.dir, parsedPath.name + '.d.ts');
+        if (FileSystem.exists(dtsTargetPath)) {
+            logOutputField(mainIndexTitle, '(inferred from .js entry point)');
+            console.log();
+            logOutputField('Target path:', dtsTargetPath);
+            return true;
+        }
+    }
+    if (!packageSubpath) {
+        // Try importing the "types"/"typings" main index:
+        if (packageJson.types) {
+            logOutputField(mainIndexTitle, `"types": ${JSON.stringify(packageJson.types)}`);
+            console.log();
+            logOutputField('Target path:', path.join(packageFolder, packageJson.types));
+            return true;
+        }
+        if (packageJson.typings) {
+            logOutputField(mainIndexTitle, `"typings": ${JSON.stringify(packageJson.typings)}`);
+            console.log();
+            logOutputField('Target path:', path.join(packageFolder, packageJson.typings));
+            return true;
+        }
+        if (atTypes) {
+            warnings.push('The @types package does not define "types" or "typings" field.');
+        }
+    }
+    else {
+        // Try importing the .d.ts file directly
+        let dtsTargetPath = undefined;
+        try {
+            dtsTargetPath = Resolve.sync(normalizedImportFullPath, {
+                basedir: packageFolder,
+                preserveSymlinks: false,
+                extensions: tsExtensions
+            });
+        }
+        catch (error) {
+            // not found
+        }
+        if (dtsTargetPath) {
+            console.log();
+            logOutputField('Target path:', dtsTargetPath);
+            return true;
+        }
+    }
+    return false;
+}
+function traceImportInner(options, warnings) {
+    let baseFolder;
+    if (options.baseFolder) {
+        baseFolder = path.resolve(options.baseFolder);
+    }
+    else {
+        baseFolder = process.cwd();
+    }
+    const importFullPath = options.importPath.trim();
+    if (!importFullPath) {
+        throw new Error(`Invalid import path syntax: ${JSON.stringify(importFullPath)}`);
+    }
+    const match = packageImportPathRegExp.exec(importFullPath);
+    logInputField('Base folder:', baseFolder);
+    if (match) {
+        const importPackageName = match[1];
+        const packageSubpath = match[2];
+        const packageSubpathWithoutSlash = packageSubpath
+            ? packageSubpath.substring(1)
+            : undefined;
+        logInputField('Package name:', importPackageName);
+        logInputField('Package subpath:', packageSubpathWithoutSlash || '(not specified)');
+        console.log('\nResolving...\n');
+        // Resolve the NPM package first
+        let packageFolder;
+        let packageJson = undefined;
+        {
+            let resolvedPackageJsonPath;
+            try {
+                resolvedPackageJsonPath = Resolve.sync(`${importPackageName}/package.json`, {
+                    basedir: baseFolder,
+                    preserveSymlinks: false
+                });
+            }
+            catch (e) {
+                // Could not find NPM package
+            }
+            if (resolvedPackageJsonPath) {
+                packageFolder = path.dirname(resolvedPackageJsonPath);
+                logOutputField('Package folder:', packageFolder);
+                packageJson = JsonFile.load(resolvedPackageJsonPath);
+                logOutputField('package.json:', `${packageJson.name || '(missing name)'} (${packageJson.version || 'missing version'})`);
+            }
+        }
+        // Also try to resolve the @types package
+        let atTypesPackageFolder = undefined;
+        let atTypesPackageJson = undefined;
+        if (options.resolutionType === 'ts') {
+            if (!importPackageName.startsWith('@types/')) {
+                const parsedPackageName = PackageName.parse(importPackageName);
+                let atTypesPackageName;
+                if (parsedPackageName.scope) {
+                    atTypesPackageName = `@types/${parsedPackageName.scope}__${parsedPackageName.unscopedName}`;
+                }
+                else {
+                    atTypesPackageName = `@types/${parsedPackageName.unscopedName}`;
+                }
+                let atTypesPackageJsonPath;
+                try {
+                    atTypesPackageJsonPath = Resolve.sync(`${atTypesPackageName}/package.json`, {
+                        basedir: baseFolder,
+                        preserveSymlinks: false
+                    });
+                }
+                catch (e) {
+                    // Unable to resolve @types package
+                }
+                if (atTypesPackageJsonPath) {
+                    atTypesPackageFolder = path.dirname(atTypesPackageJsonPath);
+                    logOutputField('@types folder:', atTypesPackageFolder);
+                    atTypesPackageJson = JsonFile.load(atTypesPackageJsonPath);
+                    logOutputField('@types package.json:', `${atTypesPackageJson.name || '(missing name)'} (${atTypesPackageJson.version || 'missing version'})`);
+                }
+            }
+        }
+        switch (options.resolutionType) {
+            case 'cjs':
+                {
+                    if (!packageFolder || !packageJson) {
+                        throw new Error(`Cannot find package "${importPackageName}" from "${baseFolder}".`);
+                    }
+                    if (!packageSubpath) {
+                        if (packageJson.main) {
+                            logOutputField('Main index:', `"main": ${JSON.stringify(packageJson.main)}`);
+                        }
+                        else {
+                            logOutputField('Main index:', '(none)');
+                        }
+                    }
+                    let targetPath;
+                    try {
+                        targetPath = Resolve.sync(importFullPath, {
+                            basedir: packageFolder,
+                            preserveSymlinks: false,
+                            extensions: jsExtensions
+                        });
+                    }
+                    catch (error) {
+                        // Are we importing the main index?
+                        if (packageSubpath) {
+                            throw new Error(`Unable to resolve the module subpath: ...${packageSubpath}`);
+                        }
+                        else {
+                            console.log('\nThis package does not define a main index.');
+                            return;
+                        }
+                    }
+                    console.log();
+                    logOutputField('Target path:', targetPath);
+                }
+                break;
+            case 'ts':
+                if (!packageFolder || (!packageJson && !atTypesPackageFolder && !atTypesPackageJson)) {
+                    throw new Error(`Cannot find package "${importPackageName}" from "${baseFolder}".`);
+                }
+                if (packageFolder && packageJson) {
+                    if (traceTypeScriptPackage({ packageSubpath, packageFolder, packageJson, warnings })) {
+                        if (atTypesPackageFolder) {
+                            warnings.push('An @types package was found but not used.');
+                        }
+                        return;
+                    }
+                }
+                if (atTypesPackageFolder && atTypesPackageJson) {
+                    if (traceTypeScriptPackage({
+                        packageSubpath,
+                        packageFolder: atTypesPackageFolder,
+                        packageJson: atTypesPackageJson,
+                        warnings,
+                        atTypes: true
+                    })) {
+                        return;
+                    }
+                }
+                throw new Error(`Unable to resolve the module subpath: ...${packageSubpath}`);
+            default:
+                throw new Error(`The "${options.resolutionType}" resolution type is not implemented yet`);
+        }
+    }
+    else {
+        logInputField('Import path:', importFullPath);
+        console.log(`\nThe import path does not appear to reference an NPM package.`);
+        console.log('Resolving...\n');
+        let targetPath;
+        try {
+            targetPath = Resolve.sync(importFullPath, {
+                basedir: baseFolder,
+                preserveSymlinks: false,
+                extensions: options.resolutionType === 'ts' ? tsExtensions : jsExtensions
+            });
+        }
+        catch (error) {
+            throw new Error(`Unable to resolve the import path: ${importFullPath}`);
+        }
+        logOutputField('Target path:', targetPath);
+    }
+}
+export function traceImport(options) {
+    const warnings = [];
+    try {
+        traceImportInner(options, warnings);
+    }
+    finally {
+        if (warnings.length) {
+            console.log();
+            for (const warning of warnings) {
+                console.log(Colorize.yellow('Warning: ' + warning));
+            }
+        }
+    }
+}
+//# sourceMappingURL=traceImport.js.map

package/lib-esm/traceImport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceImport.js","sourceRoot":"","sources":["../src/traceImport.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport * as path from 'node:path';\nimport * as process from 'node:process';\n\nimport * as Resolve from 'resolve';\n\nimport { Colorize } from '@rushstack/terminal';\nimport {\n  FileSystem,\n  type IPackageJson,\n  type IParsedPackageName,\n  JsonFile,\n  PackageName\n} from '@rushstack/node-core-library';\n\nconst jsExtensions: string[] = ['.js', '.cjs', '.jsx', '.json'];\nconst tsExtensions: string[] = ['.d.ts', '.ts', '.tsx', '.json'];\n\nexport type ResolutionType = 'cjs' | 'es' | 'ts';\n\ninterface IExecuteOptions {\n  importPath: string;\n  baseFolder: string | undefined;\n  resolutionType: ResolutionType;\n}\n\n// Somewhat loosely matches inputs such as:\n//   my-package/path/to/file.js\n//   [group 1 ][group 2       ]\n//\n//   @scope/my-package/path/to/file.js\n//   [group 1        ][group 2       ]\n//\n//   @scope/my-package\n//   [group 1        ]\nconst packageImportPathRegExp: RegExp = /^((?:@[a-z0-9_][a-z0-9\\-_\\.]*\\/)?[a-z0-9_][a-z0-9\\-_\\.]*)(\\/.*)?$/i;\n\nfunction logInputField(title: string, value: string): void {\n  console.log(Colorize.cyan(title.padEnd(25)) + value);\n}\n\nfunction logOutputField(title: string, value: string): void {\n  console.log(Colorize.green(title.padEnd(25)) + value);\n}\n\nfunction traceTypeScriptPackage(options: {\n  packageSubpath: string;\n  packageFolder: string;\n  packageJson: IPackageJson;\n  warnings: string[];\n  atTypes?: boolean;\n}): boolean {\n  const { packageSubpath, packageFolder, packageJson, atTypes, warnings } = options;\n\n  // For example, if we started with importFullPath=\"semver/index\",\n  // here we may get normalizedImportFullPath=\"@types/semver/index\"\n  const normalizedImportFullPath: string = packageJson.name + packageSubpath;\n\n  // First try to resolve the .js main index\n  let cjsTargetPath: string | undefined = undefined;\n  try {\n    cjsTargetPath = Resolve.sync(normalizedImportFullPath, {\n      basedir: packageFolder,\n      preserveSymlinks: false,\n      extensions: jsExtensions\n    });\n  } catch (error) {\n    // not found\n  }\n\n  const mainIndexTitle: string = atTypes ? '@types main index:' : 'Main index:';\n\n  if (cjsTargetPath) {\n    const parsedPath: path.ParsedPath = path.parse(cjsTargetPath);\n\n    // Is the resolved .js extension okay?\n    if (tsExtensions.indexOf(parsedPath.ext.toLocaleLowerCase()) >= 0) {\n      logOutputField(mainIndexTitle, '(inferred from .js main index)');\n      console.log();\n      logOutputField('Target path:', cjsTargetPath);\n      return true;\n    }\n\n    // Try to replace the file extension\n    const dtsTargetPath: string = path.join(parsedPath.dir, parsedPath.name + '.d.ts');\n    if (FileSystem.exists(dtsTargetPath)) {\n      logOutputField(mainIndexTitle, '(inferred from .js entry point)');\n      console.log();\n      logOutputField('Target path:', dtsTargetPath);\n      return true;\n    }\n  }\n\n  if (!packageSubpath) {\n    // Try importing the \"types\"/\"typings\" main index:\n\n    if (packageJson.types) {\n      logOutputField(mainIndexTitle, `\"types\": ${JSON.stringify(packageJson.types)}`);\n      console.log();\n      logOutputField('Target path:', path.join(packageFolder, packageJson.types));\n      return true;\n    }\n\n    if (packageJson.typings) {\n      logOutputField(mainIndexTitle, `\"typings\": ${JSON.stringify(packageJson.typings)}`);\n      console.log();\n      logOutputField('Target path:', path.join(packageFolder, packageJson.typings));\n      return true;\n    }\n\n    if (atTypes) {\n      warnings.push('The @types package does not define \"types\" or \"typings\" field.');\n    }\n  } else {\n    // Try importing the .d.ts file directly\n    let dtsTargetPath: string | undefined = undefined;\n    try {\n      dtsTargetPath = Resolve.sync(normalizedImportFullPath, {\n        basedir: packageFolder,\n        preserveSymlinks: false,\n        extensions: tsExtensions\n      });\n    } catch (error) {\n      // not found\n    }\n\n    if (dtsTargetPath) {\n      console.log();\n      logOutputField('Target path:', dtsTargetPath);\n      return true;\n    }\n  }\n\n  return false;\n}\n\nfunction traceImportInner(options: IExecuteOptions, warnings: string[]): void {\n  let baseFolder: string;\n  if (options.baseFolder) {\n    baseFolder = path.resolve(options.baseFolder);\n  } else {\n    baseFolder = process.cwd();\n  }\n\n  const importFullPath: string = options.importPath.trim();\n  if (!importFullPath) {\n    throw new Error(`Invalid import path syntax: ${JSON.stringify(importFullPath)}`);\n  }\n  const match: RegExpExecArray | null = packageImportPathRegExp.exec(importFullPath);\n\n  logInputField('Base folder:', baseFolder);\n\n  if (match) {\n    const importPackageName: string = match[1];\n    const packageSubpath: string | undefined = match[2];\n    const packageSubpathWithoutSlash: string | undefined = packageSubpath\n      ? packageSubpath.substring(1)\n      : undefined;\n\n    logInputField('Package name:', importPackageName);\n    logInputField('Package subpath:', packageSubpathWithoutSlash || '(not specified)');\n\n    console.log('\\nResolving...\\n');\n\n    // Resolve the NPM package first\n    let packageFolder: string | undefined;\n    let packageJson: IPackageJson | undefined = undefined;\n    {\n      let resolvedPackageJsonPath: string | undefined;\n      try {\n        resolvedPackageJsonPath = Resolve.sync(`${importPackageName}/package.json`, {\n          basedir: baseFolder,\n          preserveSymlinks: false\n        });\n      } catch (e) {\n        // Could not find NPM package\n      }\n\n      if (resolvedPackageJsonPath) {\n        packageFolder = path.dirname(resolvedPackageJsonPath);\n        logOutputField('Package folder:', packageFolder);\n\n        packageJson = JsonFile.load(resolvedPackageJsonPath) as IPackageJson;\n        logOutputField(\n          'package.json:',\n          `${packageJson.name || '(missing name)'} (${packageJson.version || 'missing version'})`\n        );\n      }\n    }\n\n    // Also try to resolve the @types package\n    let atTypesPackageFolder: string | undefined = undefined;\n    let atTypesPackageJson: IPackageJson | undefined = undefined;\n\n    if (options.resolutionType === 'ts') {\n      if (!importPackageName.startsWith('@types/')) {\n        const parsedPackageName: IParsedPackageName = PackageName.parse(importPackageName);\n        let atTypesPackageName: string;\n        if (parsedPackageName.scope) {\n          atTypesPackageName = `@types/${parsedPackageName.scope}__${parsedPackageName.unscopedName}`;\n        } else {\n          atTypesPackageName = `@types/${parsedPackageName.unscopedName}`;\n        }\n\n        let atTypesPackageJsonPath: string | undefined;\n        try {\n          atTypesPackageJsonPath = Resolve.sync(`${atTypesPackageName}/package.json`, {\n            basedir: baseFolder,\n            preserveSymlinks: false\n          });\n        } catch (e) {\n          // Unable to resolve @types package\n        }\n\n        if (atTypesPackageJsonPath) {\n          atTypesPackageFolder = path.dirname(atTypesPackageJsonPath);\n          logOutputField('@types folder:', atTypesPackageFolder);\n\n          atTypesPackageJson = JsonFile.load(atTypesPackageJsonPath) as IPackageJson;\n          logOutputField(\n            '@types package.json:',\n            `${atTypesPackageJson.name || '(missing name)'} (${\n              atTypesPackageJson.version || 'missing version'\n            })`\n          );\n        }\n      }\n    }\n\n    switch (options.resolutionType) {\n      case 'cjs':\n        {\n          if (!packageFolder || !packageJson) {\n            throw new Error(`Cannot find package \"${importPackageName}\" from \"${baseFolder}\".`);\n          }\n\n          if (!packageSubpath) {\n            if (packageJson.main) {\n              logOutputField('Main index:', `\"main\": ${JSON.stringify(packageJson.main)}`);\n            } else {\n              logOutputField('Main index:', '(none)');\n            }\n          }\n\n          let targetPath: string;\n          try {\n            targetPath = Resolve.sync(importFullPath, {\n              basedir: packageFolder,\n              preserveSymlinks: false,\n              extensions: jsExtensions\n            });\n          } catch (error) {\n            // Are we importing the main index?\n            if (packageSubpath) {\n              throw new Error(`Unable to resolve the module subpath: ...${packageSubpath}`);\n            } else {\n              console.log('\\nThis package does not define a main index.');\n              return;\n            }\n          }\n          console.log();\n          logOutputField('Target path:', targetPath);\n        }\n        break;\n      case 'ts':\n        if (!packageFolder || (!packageJson && !atTypesPackageFolder && !atTypesPackageJson)) {\n          throw new Error(`Cannot find package \"${importPackageName}\" from \"${baseFolder}\".`);\n        }\n\n        if (packageFolder && packageJson) {\n          if (traceTypeScriptPackage({ packageSubpath, packageFolder, packageJson, warnings })) {\n            if (atTypesPackageFolder) {\n              warnings.push('An @types package was found but not used.');\n            }\n\n            return;\n          }\n        }\n\n        if (atTypesPackageFolder && atTypesPackageJson) {\n          if (\n            traceTypeScriptPackage({\n              packageSubpath,\n              packageFolder: atTypesPackageFolder,\n              packageJson: atTypesPackageJson,\n              warnings,\n              atTypes: true\n            })\n          ) {\n            return;\n          }\n        }\n\n        throw new Error(`Unable to resolve the module subpath: ...${packageSubpath}`);\n      default:\n        throw new Error(`The \"${options.resolutionType}\" resolution type is not implemented yet`);\n    }\n  } else {\n    logInputField('Import path:', importFullPath);\n    console.log(`\\nThe import path does not appear to reference an NPM package.`);\n    console.log('Resolving...\\n');\n\n    let targetPath: string;\n    try {\n      targetPath = Resolve.sync(importFullPath, {\n        basedir: baseFolder,\n        preserveSymlinks: false,\n        extensions: options.resolutionType === 'ts' ? tsExtensions : jsExtensions\n      });\n    } catch (error) {\n      throw new Error(`Unable to resolve the import path: ${importFullPath}`);\n    }\n\n    logOutputField('Target path:', targetPath);\n  }\n}\n\nexport function traceImport(options: IExecuteOptions): void {\n  const warnings: string[] = [];\n  try {\n    traceImportInner(options, warnings);\n  } finally {\n    if (warnings.length) {\n      console.log();\n      for (const warning of warnings) {\n        console.log(Colorize.yellow('Warning: ' + warning));\n      }\n    }\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/trace-import",
-  "version": "0.6.14",
+  "version": "0.7.1",
   "description": "CLI tool for understanding how require() and \"import\" statements get resolved",
   "repository": {
     "type": "git",
@@ -15,17 +15,37 @@
     "resolve": "~1.22.1",
     "semver": "~7.5.4",
     "typescript": "~5.8.2",
-    "@rushstack/node-core-library": "5.19.1",
-    "@rushstack/terminal": "0.21.0",
-    "@rushstack/ts-command-line": "5.2.0"
+    "@rushstack/node-core-library": "5.20.1",
+    "@rushstack/terminal": "0.22.1",
+    "@rushstack/ts-command-line": "5.3.1"
   },
   "devDependencies": {
     "@types/resolve": "1.20.2",
     "@types/semver": "7.5.0",
     "eslint": "~9.37.0",
-    "@rushstack/heft": "1.1.14",
+    "@rushstack/heft": "1.2.1",
     "local-node-rig": "1.0.0"
   },
+  "exports": {
+    "./lib/*": {
+      "types": "./lib-dts/*.d.ts",
+      "node": "./lib-commonjs/*.js",
+      "import": "./lib-esm/*.js",
+      "require": "./lib-commonjs/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "lib/*": [
+        "lib-dts/*"
+      ]
+    }
+  },
+  "sideEffects": [
+    "lib-commonjs/start.js",
+    "lib-esm/start.js"
+  ],
   "scripts": {
     "start": "node lib/start",
     "build": "heft build --clean",