Method resolvePathAlias

src/utils/router-parser.util.ts:1337–1381

* Resolve a TypeScript path alias (tsconfig compilerOptions.paths) to an absolute file path. * Also supports non-relative imports resolved via compilerOptions.baseUrl. * Returns undefined when no mapping matches or the tsconfig is unavailable.

(moduleSpecifier: string)

     * Returns undefined when no mapping matches or the tsconfig is unavailable.
     */
    private resolvePathAlias(moduleSpecifier: string): string | undefined {
        try {
            const tsconfigPath = Configuration.mainData.tsconfig;
            if (!tsconfigPath) return undefined;

            const tsconfig = readConfig(tsconfigPath);
            const compilerOptions = tsconfig?.compilerOptions;
            if (!compilerOptions) return undefined;

            const baseUrl = compilerOptions.baseUrl
                ? path.resolve(path.dirname(tsconfigPath), compilerOptions.baseUrl)
                : path.dirname(tsconfigPath);

            if (compilerOptions.paths) {
                for (const [pattern, replacements] of Object.entries(
                    compilerOptions.paths as Record<string, string[]>
                )) {
                    if (!Array.isArray(replacements) || replacements.length === 0) continue;

                    // Convert glob pattern to regex: "@shared/*" → /^@shared\/(.*)$/
                    const regexStr = pattern
                        .replace(/[-[\]{}()+?.,\\^$|#\s]/g, '\\$&')
                        .replace(/\*/g, '(.*)');
                    const regex = new RegExp('^' + regexStr + '$');
                    const match = moduleSpecifier.match(regex);

                    if (match) {
                        const resolved = (replacements[0] as string).replace(/\*/g, match[1] ?? '');
                        return path.resolve(baseUrl, resolved);
                    }
                }
            }

            const isNonRelative =
                !moduleSpecifier.startsWith('./') &&
                !moduleSpecifier.startsWith('../') &&
                !path.isAbsolute(moduleSpecifier);
            if (isNonRelative) {
                return path.resolve(baseUrl, moduleSpecifier);
            }
        } catch (_e) {
            // silently skip — tsconfig may not be readable at this point
        }
        return undefined;
    }

    public cleanFileSpreads(sourceFile: SourceFile): SourceFile {
        const file = sourceFile;