Suggestion - Improve type definitions generation example to support extended tsconfig files.

[gablabelle]

A lot of monorepo projects will make use of the extends property in their tsconfig files in order to keep things DRY where possible. It took me a few minutes to understand what was wrong with my config.

Quick example:

{
  "extends": "../../tsconfig.settings.json",
  "compilerOptions": {
    "composite": true,
    "outDir": "dist",
    "rootDir": "src"
  },
  "include": ["src/**/*"]
}

estrella/examples/typedef-generation/build.js

Line 20 in aca6a68

...tsconfig.compilerOptions,

Here are the changes I've had to make to the generateTypeDefs function in the example.

function generateTypeDefs(config, entryfiles, outdir = 'dist') {
  const filenames = Array.from(
    new Set(
      (Array.isArray(entryfiles) ? entryfiles : [entryfiles]).concat(
        config.include || [],
      ),
    ),
  ).filter((v) => v);
  log.info('Generating type declaration files for', filenames.join(', '));
  let extendedCompilerOptions = {};
  if (config.extends) {
    const rawExtendedTsConfig = fs.readFileSync(config.extends);
    const extendedTsConfig = JSON.parse(rawExtendedTsConfig);
    if (extendedTsConfig.compilerOptions) {
      extendedCompilerOptions = extendedTsConfig.compilerOptions;
    }
  }
  const compilerOptions = {
    ...extendedCompilerOptions,
    ...config.compilerOptions,
    moduleResolution: undefined,
    declaration: true,
    outDir: outdir,
  };
  const program = ts.ts.createProgram(filenames, compilerOptions);
  const targetSourceFile = undefined;
  const writeFile = undefined;
  const cancellationToken = undefined;
  const emitOnlyDtsFiles = true;
  program.emit(
    targetSourceFile,
    writeFile,
    cancellationToken,
    emitOnlyDtsFiles,
  );
  log.info('Wrote', glob(`${outdir}/*.d.ts`).join(', '));
}

Hope it helps.