ts-import-resolver

Lightweight, fast utility that resolves TypeScript import paths to absolute file paths without TypeScript compiler.

Installation

1npm install ts-import-resolver

Features

• Resolves TypeScript imports to their absolute file paths
• Supports path aliases, baseUrl, and other module resolution options defined in tsconfig.json
• Lightweight and efficient with zero dependencies
• Blazing fast resolution without TypeScript compiler overhead

Usage

1import { resolveTsImportPath } from 'ts-import-resolver';
2import fs from 'fs';
3import path from 'path';
4
5// Load your tsconfig.json
6const tsconfig = JSON.parse(fs.readFileSync('./tsconfig.json', 'utf8'));
7const cwd = path.resolve('.');
8
9const absolutePath = resolveTsImportPath({
10  path: '@/components/Button',  // The import path to resolve
11  importer: '/path/to/your/file.ts',  // The file containing the import
12  tsconfig,  // Your parsed tsconfig object
13  cwd,  // Project root directory
14});
15
16if (absolutePath) {
17  console.log(`Resolved to: ${absolutePath}`);
18} else {
19  console.log('Could not resolve the import');
20}

API Reference

resolveTsImportPath(options)

Resolves a TypeScript import path to its absolute file path.

Options

1interface resolveTsImportPathOptions {
2  /**
3   * The import path to resolve (e.g., './utils', '@/components', etc.)
4   */
5  path: string;
6  
7  /**
8   * The absolute path of the file containing the import
9   */
10  importer: string;
11  
12  /**
13   * The parsed TypeScript configuration object if available
14   */
15  tsconfig: Record<string, unknown> | null | undefined;
16  
17  /**
18   * The custom root of the project
19   */
20  cwd: string;
21}

Returns

• string | null - The absolute path to the imported module if found, or null if it couldn't be resolved.

License

MIT