tsconfck

A utility to find and parse tsconfig files without depending on typescript

[!NOTE] This fork is intended to quickly deliver some patches that nanobundle relies on and no longer used.

Why

Because no simple official api exists and tsconfig.json isn't actual json.

Features

• find closest tsconfig.json
• convert tsconfig.json to actual json and parse it
• resolve "extends"
• resolve "references" of solution-style tsconfig
• optional findNative and parseNative to use official typescript api
• zero dependencies (typescript optional)
• extensive testsuite

Install

1npm install --save-dev tsconfck # or pnpm, yarn

Usage

without typescript installed

1import { parse } from 'tsconfck';
2const {
3	tsconfigFile, // full path to found tsconfig
4	tsconfig, // tsconfig object including merged values from extended configs
5	extended, // separate unmerged results of all tsconfig files that contributed to tsconfig
6	solution, // solution result if tsconfig is part of a solution
7	referenced // referenced tsconfig results if tsconfig is a solution
8} = await parse('foo/bar.ts');

with typescript

1import { parseNative } from 'tsconfck';
2const {
3	tsconfigFile, // full path to found tsconfig
4	tsconfig, // tsconfig object including merged values from extended configs, normalized
5	result, // output of ts.parseJsonConfigFileContent
6	solution, // solution result if tsconfig is part of a solution
7	referenced // referenced tsconfig results if tsconfig is a solution
8} = await parseNative('foo/bar.ts');

API

see API-DOCS

Advanced

caching

You can use a map to cache results and avoid reparsing if you process multiple ts files that share few tsconfig files

1import { parse } from 'tsconfck';
2// 1. create cache instance
3const cache = new Map();
4// 2. pass cache instance in options
5const fooResult = await parse('src/foo.ts', { cache });
6// 3. profit (if they share the same tsconfig.json, it is not parsed again)
7const barResult = await parse('src/bar.ts', { cache });

You are responsible for clearing the cache if tsconfig files change on disk during its lifetime.

Always clear the whole cache if anything changes as objects in the cache can ref each other

Returned results are direct cache objects.

If you want to modify them, deep-clone first.

reduce fs.stat overhead

You can specify a root directory and provide a set of known tsconfig locations to improve performance in large projects

1import { parse, findAll } from 'tsconfck';
2const root = '.';
3const tsConfigPaths = new Set([
4	...(await findAll(root, { skip: (dir) => dir === 'node_modules' || dir === '.git' }))
5]);
6const cache = new Map();
7const parseOptions = { cache, root, tsConfigPaths };
8// these calls use minimal fs
9const fooResult = await parse('src/foo.ts', parseOptions);
10const barResult = await parse('src/bar.ts', parseOptions);

Using the root option can lead to errors if there is no tsconfig inside root.

You are responsible for updating tsConfigPaths if tsconfig files are added/removed on disk during its lifetime.

error handling

find and parse reject for all errors they encounter.

For parse, you can choose to resolve with an empty result instead if no tsconfig file was found

1import { parse } from 'tsconfck';
2const result = await parse('some/path/without/tsconfig/foo.ts', {
3	resolveWithEmptyIfConfigNotFound: true
4});
5// result = { tsconfigFile: 'no_tsconfig_file_found',tsconfig: {} }

TSConfig type (optional, requires typescript as devDependency)

1import type { TSConfig } from 'pkg-types';

Check out https://github.com/unjs/pkg-types

cli

A simple cli wrapper is included, you can use it like this

find

1# prints /path/to/tsconfig.json on stdout
2tsconfck find src/index.ts

find-all

1# prints all tsconfig.json in dir on stdout
2tsconfck find-all src/

parse

1# print content of ParseResult.tsconfig on stdout
2tsconfck parse src/index.ts
3
4# print to file
5tsconfck parse src/index.ts > output.json

parse-result

1# print content of ParseResult on stdout
2tsconfck parse-result src/index.ts
3
4# print to file
5tsconfck parse-result src/index.ts > output.json

help

1# print usage
2tsconfck -h # or --help, -?, help

Links

• changelog

Develop

This repo uses

• pnpm
• conventional-changelog/commitlint

In addition to default commit-msg prefixes you can use 'wip: ' for commit messages in branches. PRs are going to be squash-merged

1# install dependencies
2pnpm install
3# run tests
4pnpm test
5#run tests in watch mode (doesn't require dev in parallel)
6pnpm test:watch

License

MIT