@rushstack/heft-typescript-plugin 1.2.4 → 1.3.1

package/lib-commonjs/TypeScriptPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"TypeScriptPlugin.js","sourceRoot":"","sources":["../src/TypeScriptPlugin.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';\n\nimport type * as TTypescript from 'typescript';\nimport { SyncHook } from 'tapable';\n\nimport { FileSystem } from '@rushstack/node-core-library';\nimport type { ITerminal } from '@rushstack/terminal';\nimport { ProjectConfigurationFile, InheritanceType, PathResolutionMethod } from '@rushstack/heft-config-file';\nimport type {\n  HeftConfiguration,\n  IHeftTaskSession,\n  IHeftTaskPlugin,\n  IHeftTaskRunHookOptions,\n  IHeftTaskRunIncrementalHookOptions,\n  ICopyOperation,\n  IHeftTaskFileOperations,\n  ConfigurationFile\n} from '@rushstack/heft';\n\nimport { TypeScriptBuilder, type ITypeScriptBuilderConfiguration } from './TypeScriptBuilder';\nimport anythingSchema from './schemas/anything.schema.json';\nimport typescriptConfigSchema from './schemas/typescript.schema.json';\nimport { getTsconfigFilePath } from './tsconfigLoader';\n\n/**\n * The name of the plugin, as specified in heft-plugin.json\n *\n * @public\n */\nexport const PLUGIN_NAME: 'typescript-plugin' = 'typescript-plugin';\n\n/**\n * The ${configDir} token supported in TypeScript 5.5\n * @see {@link https://www.typescriptlang.org/docs/handbook/release-notes/typescript-5-5.html#the-configdir-template-variable-for-configuration-files}\n */\nconst CONFIG_DIR_TOKEN: '${configDir}' = '${configDir}';\n\n/**\n * @beta\n */\nexport interface IEmitModuleKind {\n  moduleKind: 'commonjs' | 'amd' | 'umd' | 'system' | 'es2015' | 'esnext';\n  outFolderName: string;\n  jsExtensionOverride?: string;\n}\n\n/**\n * @beta\n */\nexport interface IStaticAssetsCopyConfiguration {\n  fileExtensions: string[];\n  excludeGlobs: string[];\n  includeGlobs: string[];\n}\n\n/**\n * @beta\n */\nexport interface ITypeScriptConfigurationJson {\n  /**\n   * If provided, emit these module kinds in addition to the modules specified in the tsconfig.\n   * Note that this option only applies to the main tsconfig.json configuration.\n   */\n  additionalModuleKindsToEmit?: IEmitModuleKind[] | undefined;\n\n  /**\n   * If 'true', emit CommonJS output into the TSConfig outDir with the file extension '.cjs'\n   */\n  emitCjsExtensionForCommonJS?: boolean | undefined;\n\n  /**\n   * If 'true', emit ESModule output into the TSConfig outDir with the file extension '.mjs'\n   */\n  emitMjsExtensionForESModule?: boolean | undefined;\n\n  /**\n   * If true, enable behavior analogous to the \"tsc --build\" command. Will build projects referenced by the main project in dependency order.\n   * Note that this will effectively enable \\\"noEmitOnError\\\".\n   */\n  buildProjectReferences?: boolean;\n\n  /**\n   * If true, and the tsconfig has \\\"isolatedModules\\\": true, then transpilation will happen in parallel in a worker thread.\n   */\n  useTranspilerWorker?: boolean;\n\n  /**\n   * If true, the TypeScript compiler will only resolve symlinks to their targets if the links are in a node_modules folder.\n   * This significantly reduces file system operations in typical usage.\n   */\n  onlyResolveSymlinksInNodeModules?: boolean;\n\n  /*\n   * Specifies the tsconfig.json file that will be used for compilation. Equivalent to the \"project\" argument for the 'tsc' and 'tslint' command line tools.\n   *\n   * The default value is \"./tsconfig.json\"\n   */\n  project?: string;\n\n  /**\n   * Configures additional file types that should be copied into the TypeScript compiler's emit folders, for example\n   * so that these files can be resolved by import statements.\n   */\n  staticAssetsToCopy?: IStaticAssetsCopyConfiguration;\n}\n\n/**\n * @beta\n */\nexport interface IPartialTsconfigCompilerOptions {\n  outDir?: string;\n}\n\n/**\n * @beta\n */\nexport interface IPartialTsconfig {\n  compilerOptions?: IPartialTsconfigCompilerOptions;\n}\n\n/**\n * @beta\n */\nexport interface IChangedFilesHookOptions {\n  program: TTypescript.Program;\n  changedFiles?: ReadonlySet<TTypescript.SourceFile>;\n}\n\n/**\n * @beta\n */\nexport interface ITypeScriptPluginAccessor {\n  readonly onChangedFilesHook: SyncHook<IChangedFilesHookOptions>;\n}\n\nconst TYPESCRIPT_LOADER_CONFIG: ConfigurationFile.IProjectConfigurationFileSpecification<ITypeScriptConfigurationJson> =\n  {\n    projectRelativeFilePath: 'config/typescript.json',\n    jsonSchemaObject: typescriptConfigSchema,\n    propertyInheritance: {\n      staticAssetsToCopy: {\n        // When merging objects, arrays will be automatically appended\n        inheritanceType: InheritanceType.merge\n      }\n    },\n    jsonPathMetadata: {\n      '$.additionalModuleKindsToEmit.*.outFolderName': {\n        pathResolutionMethod: PathResolutionMethod.resolvePathRelativeToProjectRoot\n      }\n    }\n  };\n\n/**\n * @beta\n */\nexport async function loadTypeScriptConfigurationFileAsync(\n  heftConfiguration: HeftConfiguration,\n  terminal: ITerminal\n): Promise<ITypeScriptConfigurationJson | undefined> {\n  return await heftConfiguration.tryLoadProjectConfigurationFileAsync<ITypeScriptConfigurationJson>(\n    TYPESCRIPT_LOADER_CONFIG,\n    terminal\n  );\n}\n\nlet _partialTsconfigFileLoader: ProjectConfigurationFile<IPartialTsconfig> | undefined;\nconst _partialTsconfigFilePromiseCache: Map<string, Promise<IPartialTsconfig | undefined>> = new Map();\n\n/**\n * @beta\n */\nexport async function loadPartialTsconfigFileAsync(\n  heftConfiguration: HeftConfiguration,\n  terminal: ITerminal,\n  typeScriptConfigurationJson: ITypeScriptConfigurationJson | undefined\n): Promise<IPartialTsconfig | undefined> {\n  const buildFolderPath: string = heftConfiguration.buildFolderPath;\n\n  // Check the cache first\n  let partialTsconfigFilePromise: Promise<IPartialTsconfig | undefined> | undefined =\n    _partialTsconfigFilePromiseCache.get(buildFolderPath);\n\n  if (!partialTsconfigFilePromise) {\n    // We don't want to load the tsconfig.json file through the rig, but we do want to take\n    // advantage of the extends functionality that ConfigurationFile provides. So we'll\n    // check to see if the file exists and exit early if not.\n\n    const tsconfigFilePath: string = getTsconfigFilePath(\n      heftConfiguration,\n      typeScriptConfigurationJson?.project\n    );\n    terminal.writeVerboseLine(`Looking for tsconfig at ${tsconfigFilePath}`);\n    const tsconfigExists: boolean = await FileSystem.existsAsync(tsconfigFilePath);\n    if (!tsconfigExists) {\n      partialTsconfigFilePromise = Promise.resolve(undefined);\n    } else {\n      // Ensure that the file loader has been initialized.\n      if (!_partialTsconfigFileLoader) {\n        _partialTsconfigFileLoader = new ProjectConfigurationFile<IPartialTsconfig>({\n          projectRelativeFilePath: typeScriptConfigurationJson?.project || 'tsconfig.json',\n          jsonSchemaObject: anythingSchema,\n          propertyInheritance: {\n            compilerOptions: {\n              inheritanceType: InheritanceType.merge\n            }\n          },\n          jsonPathMetadata: {\n            '$.compilerOptions.outDir': {\n              pathResolutionMethod: PathResolutionMethod.custom,\n              customResolver(\n                resolverOptions: ConfigurationFile.IJsonPathMetadataResolverOptions<IPartialTsconfig>\n              ): string {\n                if (resolverOptions.propertyValue.includes(CONFIG_DIR_TOKEN)) {\n                  // Typescript 5.5. introduced the `${configDir}` token to refer to the directory containing the root tsconfig\n                  const configDir: string = path.dirname(tsconfigFilePath);\n                  // The token is an absolute path, so it should occur at most once.\n                  return path.resolve(resolverOptions.propertyValue.replace(CONFIG_DIR_TOKEN, configDir));\n                } else {\n                  const thisConfigDir: string = path.dirname(resolverOptions.configurationFilePath);\n                  return path.resolve(thisConfigDir, resolverOptions.propertyValue);\n                }\n              }\n            }\n          }\n        });\n      }\n\n      partialTsconfigFilePromise = _partialTsconfigFileLoader.loadConfigurationFileForProjectAsync(\n        terminal,\n        buildFolderPath,\n        heftConfiguration.rigConfig\n      );\n    }\n    _partialTsconfigFilePromiseCache.set(buildFolderPath, partialTsconfigFilePromise);\n  }\n\n  return await partialTsconfigFilePromise;\n}\n\ninterface ITypeScriptConfigurationJsonAndPartialTsconfigFile {\n  typeScriptConfigurationJson: ITypeScriptConfigurationJson | undefined;\n  partialTsconfigFile: IPartialTsconfig | undefined;\n}\n\nexport default class TypeScriptPlugin implements IHeftTaskPlugin {\n  public accessor: ITypeScriptPluginAccessor = {\n    onChangedFilesHook: new SyncHook<IChangedFilesHookOptions>(['changedFilesHookOptions'])\n  };\n\n  public apply(taskSession: IHeftTaskSession, heftConfiguration: HeftConfiguration): void {\n    taskSession.hooks.registerFileOperations.tapPromise(\n      PLUGIN_NAME,\n      async (fileOperations: IHeftTaskFileOperations): Promise<IHeftTaskFileOperations> => {\n        // TODO: We should consider maybe only doing one copy of static assets and pointing\n        // all source files to this set of static assets. This would allow us to avoid\n        // having to copy the static assets multiple times, increasing build times and\n        // package size.\n        for (const copyOperation of await this._getStaticAssetCopyOperationsAsync(\n          taskSession,\n          heftConfiguration\n        )) {\n          fileOperations.copyOperations.add(copyOperation);\n        }\n\n        return fileOperations;\n      }\n    );\n\n    taskSession.hooks.run.tapPromise(PLUGIN_NAME, async (runOptions: IHeftTaskRunHookOptions) => {\n      const builder: TypeScriptBuilder | false = await this._getTypeScriptBuilderAsync(\n        taskSession,\n        heftConfiguration\n      );\n      if (builder) {\n        await builder.invokeAsync();\n      }\n    });\n\n    let incrementalBuilder: TypeScriptBuilder | undefined | false;\n    taskSession.hooks.runIncremental.tapPromise(\n      PLUGIN_NAME,\n      async (runIncrementalOptions: IHeftTaskRunIncrementalHookOptions) => {\n        if (incrementalBuilder === undefined) {\n          // eslint-disable-next-line require-atomic-updates\n          incrementalBuilder = await this._getTypeScriptBuilderAsync(taskSession, heftConfiguration);\n        }\n\n        if (incrementalBuilder) {\n          await incrementalBuilder.invokeAsync(runIncrementalOptions.requestRun);\n        }\n      }\n    );\n  }\n\n  private async _getStaticAssetCopyOperationsAsync(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration\n  ): Promise<ICopyOperation[]> {\n    const { typeScriptConfigurationJson, partialTsconfigFile } = await this._loadConfigAsync(\n      taskSession,\n      heftConfiguration\n    );\n\n    // We only care about the copy if static assets were specified.\n    const copyOperations: ICopyOperation[] = [];\n    const staticAssetsConfig: IStaticAssetsCopyConfiguration | undefined =\n      typeScriptConfigurationJson?.staticAssetsToCopy;\n    if (\n      staticAssetsConfig &&\n      (staticAssetsConfig.fileExtensions?.length ||\n        staticAssetsConfig.includeGlobs?.length ||\n        staticAssetsConfig.excludeGlobs?.length)\n    ) {\n      const destinationFolderPaths: Set<string> = new Set<string>();\n\n      // Add the output folder and all additional module kind output folders as destinations\n      const tsconfigOutDir: string | undefined = partialTsconfigFile?.compilerOptions?.outDir;\n      if (tsconfigOutDir) {\n        destinationFolderPaths.add(tsconfigOutDir);\n      }\n\n      for (const emitModule of typeScriptConfigurationJson?.additionalModuleKindsToEmit || []) {\n        destinationFolderPaths.add(emitModule.outFolderName);\n      }\n\n      copyOperations.push({\n        ...staticAssetsConfig,\n\n        // For now - these may need to be revised later\n        sourcePath: path.resolve(heftConfiguration.buildFolderPath, 'src'),\n        destinationFolders: Array.from(destinationFolderPaths),\n        flatten: false,\n        hardlink: false\n      });\n    }\n\n    return copyOperations;\n  }\n\n  private async _getTypeScriptBuilderAsync(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration\n  ): Promise<TypeScriptBuilder | false> {\n    const { typeScriptConfigurationJson, partialTsconfigFile } = await this._loadConfigAsync(\n      taskSession,\n      heftConfiguration\n    );\n\n    if (!partialTsconfigFile) {\n      // There is no tsconfig file, we can exit early\n      // This check may need watch mode to break on tsconfig addition/deletion\n      return false;\n    }\n\n    // Build out the configuration\n    const typeScriptBuilderConfiguration: ITypeScriptBuilderConfiguration = {\n      buildFolderPath: heftConfiguration.buildFolderPath,\n      // Build metadata is just another build output, but we put it in the temp folder because it will\n      // usually be discarded when published.\n      buildMetadataFolderPath: taskSession.tempFolderPath,\n      heftConfiguration,\n\n      buildProjectReferences: typeScriptConfigurationJson?.buildProjectReferences,\n\n      useTranspilerWorker: typeScriptConfigurationJson?.useTranspilerWorker,\n\n      onlyResolveSymlinksInNodeModules: typeScriptConfigurationJson?.onlyResolveSymlinksInNodeModules,\n\n      tsconfigPath: getTsconfigFilePath(heftConfiguration, typeScriptConfigurationJson?.project),\n      additionalModuleKindsToEmit: typeScriptConfigurationJson?.additionalModuleKindsToEmit,\n      emitCjsExtensionForCommonJS: !!typeScriptConfigurationJson?.emitCjsExtensionForCommonJS,\n      emitMjsExtensionForESModule: !!typeScriptConfigurationJson?.emitMjsExtensionForESModule,\n      scopedLogger: taskSession.logger,\n      emitChangedFilesCallback: (\n        program: TTypescript.Program,\n        changedFiles?: Set<TTypescript.SourceFile>\n      ) => {\n        // Provide the typescript program dependent plugins\n        if (this.accessor.onChangedFilesHook.isUsed()) {\n          this.accessor.onChangedFilesHook.call({ program, changedFiles });\n        }\n      }\n    };\n\n    // Run the builder\n    const typeScriptBuilder: TypeScriptBuilder = new TypeScriptBuilder(typeScriptBuilderConfiguration);\n    return typeScriptBuilder;\n  }\n\n  private async _loadConfigAsync(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration\n  ): Promise<ITypeScriptConfigurationJsonAndPartialTsconfigFile> {\n    const terminal: ITerminal = taskSession.logger.terminal;\n\n    const typeScriptConfigurationJson: ITypeScriptConfigurationJson | undefined =\n      await loadTypeScriptConfigurationFileAsync(heftConfiguration, terminal);\n\n    const partialTsconfigFile: IPartialTsconfig | undefined = await loadPartialTsconfigFileAsync(\n      heftConfiguration,\n      terminal,\n      typeScriptConfigurationJson\n    );\n\n    return {\n      typeScriptConfigurationJson,\n      partialTsconfigFile\n    };\n  }\n}\n"]}
+{"version":3,"file":"TypeScriptPlugin.js","sourceRoot":"","sources":["../src/TypeScriptPlugin.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';\n\nimport type * as TTypescript from 'typescript';\nimport { SyncHook } from 'tapable';\n\nimport { FileSystem } from '@rushstack/node-core-library';\nimport type { ITerminal } from '@rushstack/terminal';\nimport { ProjectConfigurationFile, InheritanceType, PathResolutionMethod } from '@rushstack/heft-config-file';\nimport type {\n  HeftConfiguration,\n  IHeftTaskSession,\n  IHeftTaskPlugin,\n  IHeftTaskRunHookOptions,\n  IHeftTaskRunIncrementalHookOptions,\n  ICopyOperation,\n  IHeftTaskFileOperations,\n  ConfigurationFile\n} from '@rushstack/heft';\n\nimport { TypeScriptBuilder, type ITypeScriptBuilderConfiguration } from './TypeScriptBuilder';\nimport anythingSchema from './schemas/anything.schema.json';\nimport typescriptConfigSchema from './schemas/typescript.schema.json';\nimport { getTsconfigFilePath } from './tsconfigLoader';\n\n/**\n * The name of the plugin, as specified in heft-plugin.json\n *\n * @public\n */\nexport const PLUGIN_NAME: 'typescript-plugin' = 'typescript-plugin';\n\n/**\n * The ${configDir} token supported in TypeScript 5.5\n * @see {@link https://www.typescriptlang.org/docs/handbook/release-notes/typescript-5-5.html#the-configdir-template-variable-for-configuration-files}\n */\nconst CONFIG_DIR_TOKEN: '${configDir}' = '${configDir}';\n\n/**\n * @beta\n */\nexport interface IEmitModuleKind {\n  moduleKind: 'commonjs' | 'amd' | 'umd' | 'system' | 'es2015' | 'esnext';\n  outFolderName: string;\n  jsExtensionOverride?: string;\n  emitModulePackageJson?: boolean;\n}\n\n/**\n * @beta\n */\nexport interface IStaticAssetsCopyConfiguration {\n  fileExtensions: string[];\n  excludeGlobs: string[];\n  includeGlobs: string[];\n}\n\n/**\n * @beta\n */\nexport interface ITypeScriptConfigurationJson {\n  /**\n   * If provided, emit these module kinds in addition to the modules specified in the tsconfig.\n   * Note that this option only applies to the main tsconfig.json configuration.\n   */\n  additionalModuleKindsToEmit?: IEmitModuleKind[] | undefined;\n\n  /**\n   * If 'true', emit CommonJS output into the TSConfig outDir with the file extension '.cjs'\n   */\n  emitCjsExtensionForCommonJS?: boolean | undefined;\n\n  /**\n   * If 'true', emit ESModule output into the TSConfig outDir with the file extension '.mjs'\n   */\n  emitMjsExtensionForESModule?: boolean | undefined;\n\n  /**\n   * If true, enable behavior analogous to the \"tsc --build\" command. Will build projects referenced by the main project in dependency order.\n   * Note that this will effectively enable \\\"noEmitOnError\\\".\n   */\n  buildProjectReferences?: boolean;\n\n  /**\n   * If true, and the tsconfig has \\\"isolatedModules\\\": true, then transpilation will happen in parallel in a worker thread.\n   */\n  useTranspilerWorker?: boolean;\n\n  /**\n   * If true, the TypeScript compiler will only resolve symlinks to their targets if the links are in a node_modules folder.\n   * This significantly reduces file system operations in typical usage.\n   */\n  onlyResolveSymlinksInNodeModules?: boolean;\n\n  /*\n   * Specifies the tsconfig.json file that will be used for compilation. Equivalent to the \"project\" argument for the 'tsc' and 'tslint' command line tools.\n   *\n   * The default value is \"./tsconfig.json\"\n   */\n  project?: string;\n\n  /**\n   * Configures additional file types that should be copied into the TypeScript compiler's emit folders, for example\n   * so that these files can be resolved by import statements.\n   */\n  staticAssetsToCopy?: IStaticAssetsCopyConfiguration;\n}\n\n/**\n * @beta\n */\nexport interface IPartialTsconfigCompilerOptions {\n  outDir?: string;\n}\n\n/**\n * @beta\n */\nexport interface IPartialTsconfig {\n  compilerOptions?: IPartialTsconfigCompilerOptions;\n}\n\n/**\n * @beta\n */\nexport interface IChangedFilesHookOptions {\n  program: TTypescript.Program;\n  changedFiles?: ReadonlySet<TTypescript.SourceFile>;\n}\n\n/**\n * @beta\n */\nexport interface ITypeScriptPluginAccessor {\n  readonly onChangedFilesHook: SyncHook<IChangedFilesHookOptions>;\n}\n\nconst TYPESCRIPT_LOADER_CONFIG: ConfigurationFile.IProjectConfigurationFileSpecification<ITypeScriptConfigurationJson> =\n  {\n    projectRelativeFilePath: 'config/typescript.json',\n    jsonSchemaObject: typescriptConfigSchema,\n    propertyInheritance: {\n      staticAssetsToCopy: {\n        // When merging objects, arrays will be automatically appended\n        inheritanceType: InheritanceType.merge\n      }\n    },\n    jsonPathMetadata: {\n      '$.additionalModuleKindsToEmit.*.outFolderName': {\n        pathResolutionMethod: PathResolutionMethod.resolvePathRelativeToProjectRoot\n      }\n    }\n  };\n\n/**\n * @beta\n */\nexport async function loadTypeScriptConfigurationFileAsync(\n  heftConfiguration: HeftConfiguration,\n  terminal: ITerminal\n): Promise<ITypeScriptConfigurationJson | undefined> {\n  return await heftConfiguration.tryLoadProjectConfigurationFileAsync<ITypeScriptConfigurationJson>(\n    TYPESCRIPT_LOADER_CONFIG,\n    terminal\n  );\n}\n\nlet _partialTsconfigFileLoader: ProjectConfigurationFile<IPartialTsconfig> | undefined;\nconst _partialTsconfigFilePromiseCache: Map<string, Promise<IPartialTsconfig | undefined>> = new Map();\n\n/**\n * @beta\n */\nexport async function loadPartialTsconfigFileAsync(\n  heftConfiguration: HeftConfiguration,\n  terminal: ITerminal,\n  typeScriptConfigurationJson: ITypeScriptConfigurationJson | undefined\n): Promise<IPartialTsconfig | undefined> {\n  const buildFolderPath: string = heftConfiguration.buildFolderPath;\n\n  // Check the cache first\n  let partialTsconfigFilePromise: Promise<IPartialTsconfig | undefined> | undefined =\n    _partialTsconfigFilePromiseCache.get(buildFolderPath);\n\n  if (!partialTsconfigFilePromise) {\n    // We don't want to load the tsconfig.json file through the rig, but we do want to take\n    // advantage of the extends functionality that ConfigurationFile provides. So we'll\n    // check to see if the file exists and exit early if not.\n\n    const tsconfigFilePath: string = getTsconfigFilePath(\n      heftConfiguration,\n      typeScriptConfigurationJson?.project\n    );\n    terminal.writeVerboseLine(`Looking for tsconfig at ${tsconfigFilePath}`);\n    const tsconfigExists: boolean = await FileSystem.existsAsync(tsconfigFilePath);\n    if (!tsconfigExists) {\n      partialTsconfigFilePromise = Promise.resolve(undefined);\n    } else {\n      // Ensure that the file loader has been initialized.\n      if (!_partialTsconfigFileLoader) {\n        _partialTsconfigFileLoader = new ProjectConfigurationFile<IPartialTsconfig>({\n          projectRelativeFilePath: typeScriptConfigurationJson?.project || 'tsconfig.json',\n          jsonSchemaObject: anythingSchema,\n          propertyInheritance: {\n            compilerOptions: {\n              inheritanceType: InheritanceType.merge\n            }\n          },\n          jsonPathMetadata: {\n            '$.compilerOptions.outDir': {\n              pathResolutionMethod: PathResolutionMethod.custom,\n              customResolver(\n                resolverOptions: ConfigurationFile.IJsonPathMetadataResolverOptions<IPartialTsconfig>\n              ): string {\n                if (resolverOptions.propertyValue.includes(CONFIG_DIR_TOKEN)) {\n                  // Typescript 5.5. introduced the `${configDir}` token to refer to the directory containing the root tsconfig\n                  const configDir: string = path.dirname(tsconfigFilePath);\n                  // The token is an absolute path, so it should occur at most once.\n                  return path.resolve(resolverOptions.propertyValue.replace(CONFIG_DIR_TOKEN, configDir));\n                } else {\n                  const thisConfigDir: string = path.dirname(resolverOptions.configurationFilePath);\n                  return path.resolve(thisConfigDir, resolverOptions.propertyValue);\n                }\n              }\n            }\n          }\n        });\n      }\n\n      partialTsconfigFilePromise = _partialTsconfigFileLoader.loadConfigurationFileForProjectAsync(\n        terminal,\n        buildFolderPath,\n        heftConfiguration.rigConfig\n      );\n    }\n    _partialTsconfigFilePromiseCache.set(buildFolderPath, partialTsconfigFilePromise);\n  }\n\n  return await partialTsconfigFilePromise;\n}\n\ninterface ITypeScriptConfigurationJsonAndPartialTsconfigFile {\n  typeScriptConfigurationJson: ITypeScriptConfigurationJson | undefined;\n  partialTsconfigFile: IPartialTsconfig | undefined;\n}\n\nexport default class TypeScriptPlugin implements IHeftTaskPlugin {\n  public accessor: ITypeScriptPluginAccessor = {\n    onChangedFilesHook: new SyncHook<IChangedFilesHookOptions>(['changedFilesHookOptions'])\n  };\n\n  public apply(taskSession: IHeftTaskSession, heftConfiguration: HeftConfiguration): void {\n    taskSession.hooks.registerFileOperations.tapPromise(\n      PLUGIN_NAME,\n      async (fileOperations: IHeftTaskFileOperations): Promise<IHeftTaskFileOperations> => {\n        // TODO: We should consider maybe only doing one copy of static assets and pointing\n        // all source files to this set of static assets. This would allow us to avoid\n        // having to copy the static assets multiple times, increasing build times and\n        // package size.\n        for (const copyOperation of await this._getStaticAssetCopyOperationsAsync(\n          taskSession,\n          heftConfiguration\n        )) {\n          fileOperations.copyOperations.add(copyOperation);\n        }\n\n        return fileOperations;\n      }\n    );\n\n    taskSession.hooks.run.tapPromise(PLUGIN_NAME, async (runOptions: IHeftTaskRunHookOptions) => {\n      const builder: TypeScriptBuilder | false = await this._getTypeScriptBuilderAsync(\n        taskSession,\n        heftConfiguration\n      );\n      if (builder) {\n        await builder.invokeAsync();\n      }\n    });\n\n    let incrementalBuilder: TypeScriptBuilder | undefined | false;\n    taskSession.hooks.runIncremental.tapPromise(\n      PLUGIN_NAME,\n      async (runIncrementalOptions: IHeftTaskRunIncrementalHookOptions) => {\n        if (incrementalBuilder === undefined) {\n          // eslint-disable-next-line require-atomic-updates\n          incrementalBuilder = await this._getTypeScriptBuilderAsync(taskSession, heftConfiguration);\n        }\n\n        if (incrementalBuilder) {\n          await incrementalBuilder.invokeAsync(runIncrementalOptions.requestRun);\n        }\n      }\n    );\n  }\n\n  private async _getStaticAssetCopyOperationsAsync(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration\n  ): Promise<ICopyOperation[]> {\n    const { typeScriptConfigurationJson, partialTsconfigFile } = await this._loadConfigAsync(\n      taskSession,\n      heftConfiguration\n    );\n\n    // We only care about the copy if static assets were specified.\n    const copyOperations: ICopyOperation[] = [];\n    const staticAssetsConfig: IStaticAssetsCopyConfiguration | undefined =\n      typeScriptConfigurationJson?.staticAssetsToCopy;\n    if (\n      staticAssetsConfig &&\n      (staticAssetsConfig.fileExtensions?.length ||\n        staticAssetsConfig.includeGlobs?.length ||\n        staticAssetsConfig.excludeGlobs?.length)\n    ) {\n      const destinationFolderPaths: Set<string> = new Set<string>();\n\n      // Add the output folder and all additional module kind output folders as destinations\n      const tsconfigOutDir: string | undefined = partialTsconfigFile?.compilerOptions?.outDir;\n      if (tsconfigOutDir) {\n        destinationFolderPaths.add(tsconfigOutDir);\n      }\n\n      for (const emitModule of typeScriptConfigurationJson?.additionalModuleKindsToEmit || []) {\n        destinationFolderPaths.add(emitModule.outFolderName);\n      }\n\n      copyOperations.push({\n        ...staticAssetsConfig,\n\n        // For now - these may need to be revised later\n        sourcePath: path.resolve(heftConfiguration.buildFolderPath, 'src'),\n        destinationFolders: Array.from(destinationFolderPaths),\n        flatten: false,\n        hardlink: false\n      });\n    }\n\n    return copyOperations;\n  }\n\n  private async _getTypeScriptBuilderAsync(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration\n  ): Promise<TypeScriptBuilder | false> {\n    const { typeScriptConfigurationJson, partialTsconfigFile } = await this._loadConfigAsync(\n      taskSession,\n      heftConfiguration\n    );\n\n    if (!partialTsconfigFile) {\n      // There is no tsconfig file, we can exit early\n      // This check may need watch mode to break on tsconfig addition/deletion\n      return false;\n    }\n\n    // Build out the configuration\n    const typeScriptBuilderConfiguration: ITypeScriptBuilderConfiguration = {\n      buildFolderPath: heftConfiguration.buildFolderPath,\n      // Build metadata is just another build output, but we put it in the temp folder because it will\n      // usually be discarded when published.\n      buildMetadataFolderPath: taskSession.tempFolderPath,\n      heftConfiguration,\n\n      buildProjectReferences: typeScriptConfigurationJson?.buildProjectReferences,\n\n      useTranspilerWorker: typeScriptConfigurationJson?.useTranspilerWorker,\n\n      onlyResolveSymlinksInNodeModules: typeScriptConfigurationJson?.onlyResolveSymlinksInNodeModules,\n\n      tsconfigPath: getTsconfigFilePath(heftConfiguration, typeScriptConfigurationJson?.project),\n      additionalModuleKindsToEmit: typeScriptConfigurationJson?.additionalModuleKindsToEmit,\n      emitCjsExtensionForCommonJS: !!typeScriptConfigurationJson?.emitCjsExtensionForCommonJS,\n      emitMjsExtensionForESModule: !!typeScriptConfigurationJson?.emitMjsExtensionForESModule,\n      scopedLogger: taskSession.logger,\n      emitChangedFilesCallback: (\n        program: TTypescript.Program,\n        changedFiles?: Set<TTypescript.SourceFile>\n      ) => {\n        // Provide the typescript program dependent plugins\n        if (this.accessor.onChangedFilesHook.isUsed()) {\n          this.accessor.onChangedFilesHook.call({ program, changedFiles });\n        }\n      }\n    };\n\n    // Run the builder\n    const typeScriptBuilder: TypeScriptBuilder = new TypeScriptBuilder(typeScriptBuilderConfiguration);\n    return typeScriptBuilder;\n  }\n\n  private async _loadConfigAsync(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration\n  ): Promise<ITypeScriptConfigurationJsonAndPartialTsconfigFile> {\n    const terminal: ITerminal = taskSession.logger.terminal;\n\n    const typeScriptConfigurationJson: ITypeScriptConfigurationJson | undefined =\n      await loadTypeScriptConfigurationFileAsync(heftConfiguration, terminal);\n\n    const partialTsconfigFile: IPartialTsconfig | undefined = await loadPartialTsconfigFileAsync(\n      heftConfiguration,\n      terminal,\n      typeScriptConfigurationJson\n    );\n\n    return {\n      typeScriptConfigurationJson,\n      partialTsconfigFile\n    };\n  }\n}\n"]}

package/lib-commonjs/schemas/typescript.schema.json

@@ -31,6 +31,11 @@
           "outFolderName": {
             "type": "string",
             "pattern": "[^\\\\\\/]"
+          },
+
+          "emitModulePackageJson": {
+            "description": "If true, a package.json file will be written to the output folder with the appropriate \"type\" field for the specified module kind. This ensures that Node.js correctly interprets .js files in the output folder regardless of the nearest ancestor package.json \"type\" setting. Only valid for CommonJS, UMD, and ES module kinds.",
+            "type": "boolean"
           }
         },
         "required": ["moduleKind", "outFolderName"]

package/lib-commonjs/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D","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 type * as TTypescript from 'typescript';\n\nexport interface ITypescriptWorkerData {\n  /**\n   * Path to the version of TypeScript to use.\n   */\n  typeScriptToolPath: string;\n}\n\nexport interface ITranspilationRequestMessage {\n  /**\n   * Unique identifier for this request.\n   */\n  requestId: number;\n  /**\n   * The tsconfig compiler options to use for the request.\n   */\n  compilerOptions: TTypescript.CompilerOptions;\n  /**\n   * The variants to emit.\n   */\n  moduleKindsToEmit: ICachedEmitModuleKind[];\n  /**\n   * The set of files to build.\n   */\n  filesToTranspile: Map<string, string>;\n}\n\nexport interface ITranspilationSuccessMessage {\n  requestId: number;\n  type: 'success';\n  result: TTypescript.EmitResult;\n}\n\nexport interface ITranspilationErrorMessage {\n  requestId: number;\n  type: 'error';\n  result: {\n    message: string;\n    [key: string]: unknown;\n  };\n}\n\nexport type ITranspilationResponseMessage = ITranspilationSuccessMessage | ITranspilationErrorMessage;\n\nexport interface ICachedEmitModuleKind {\n  moduleKind: TTypescript.ModuleKind;\n\n  outFolderPath: string;\n\n  /**\n   * File extension to use instead of '.js' for emitted ECMAScript files.\n   * For example, '.cjs' to indicate commonjs content, or '.mjs' to indicate ECMAScript modules.\n   */\n  jsExtensionOverride: string | undefined;\n\n  /**\n   * Set to true if this is the emit kind that is specified in the tsconfig.json.\n   * Declarations are only emitted for the primary module kind.\n   */\n  isPrimary: boolean;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D","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 type * as TTypescript from 'typescript';\n\nexport interface ITypescriptWorkerData {\n  /**\n   * Path to the version of TypeScript to use.\n   */\n  typeScriptToolPath: string;\n}\n\nexport interface ITranspilationRequestMessage {\n  /**\n   * Unique identifier for this request.\n   */\n  requestId: number;\n  /**\n   * The tsconfig compiler options to use for the request.\n   */\n  compilerOptions: TTypescript.CompilerOptions;\n  /**\n   * The variants to emit.\n   */\n  moduleKindsToEmit: ICachedEmitModuleKind[];\n  /**\n   * The set of files to build.\n   */\n  filesToTranspile: Map<string, string>;\n}\n\nexport interface ITranspilationSuccessMessage {\n  requestId: number;\n  type: 'success';\n  result: TTypescript.EmitResult;\n}\n\nexport interface ITranspilationErrorMessage {\n  requestId: number;\n  type: 'error';\n  result: {\n    message: string;\n    [key: string]: unknown;\n  };\n}\n\nexport type ITranspilationResponseMessage = ITranspilationSuccessMessage | ITranspilationErrorMessage;\n\nexport interface ICachedEmitModuleKind {\n  moduleKind: TTypescript.ModuleKind;\n\n  outFolderPath: string;\n\n  /**\n   * File extension to use instead of '.js' for emitted ECMAScript files.\n   * For example, '.cjs' to indicate commonjs content, or '.mjs' to indicate ECMAScript modules.\n   */\n  jsExtensionOverride: string | undefined;\n\n  /**\n   * Set to true if this is the emit kind that is specified in the tsconfig.json.\n   * Declarations are only emitted for the primary module kind.\n   */\n  isPrimary: boolean;\n\n  /**\n   * If true, a package.json with the appropriate \"type\" field will be written\n   * to the output folder after emit.\n   */\n  emitModulePackageJson: boolean;\n}\n"]}

package/lib-dts/TypeScriptBuilder.d.ts

@@ -88,6 +88,12 @@ export declare class TypeScriptBuilder {
     private _buildWatchCompilerHost;
     private _changeCompilerHostToUseCache;
     private _buildWatchSolutionBuilderHost;
+    /**
+     * For each module kind configured with `emitModulePackageJson: true`, writes a
+     * `package.json` with the appropriate `"type"` field to ensure Node.js correctly
+     * interprets `.js` files in the output folder.
+     */
+    private _emitModulePackageJsonFiles;
     private _parseModuleKind;
     private _queueTranspileInWorker;
     private _cleanupWorker;

package/lib-dts/TypeScriptBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TypeScriptBuilder.d.ts","sourceRoot":"","sources":["../src/TypeScriptBuilder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TypeScriptBuilder.d.ts","sourceRoot":"","sources":["../src/TypeScriptBuilder.ts"],"names":[],"mappings":"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"}

package/lib-dts/TypeScriptPlugin.d.ts

@@ -15,6 +15,7 @@ export interface IEmitModuleKind {
     moduleKind: 'commonjs' | 'amd' | 'umd' | 'system' | 'es2015' | 'esnext';
     outFolderName: string;
     jsExtensionOverride?: string;
+    emitModulePackageJson?: boolean;
 }
 /**
  * @beta

package/lib-dts/TypeScriptPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TypeScriptPlugin.d.ts","sourceRoot":"","sources":["../src/TypeScriptPlugin.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,WAAW,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAMhB,MAAM,iBAAiB,CAAC;AAOzB;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,mBAAyC,CAAC;AAQpE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,2BAA2B,CAAC,EAAE,eAAe,EAAE,GAAG,SAAS,CAAC;IAE5D;;OAEG;IACH,2BAA2B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAElD;;OAEG;IACH,2BAA2B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAElD;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;OAGG;IACH,gCAAgC,CAAC,EAAE,OAAO,CAAC;IAO3C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,8BAA8B,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,EAAE,+BAA+B,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,CAAC,wBAAwB,CAAC,CAAC;CACjE;AAmBD;;GAEG;AACH,wBAAsB,oCAAoC,CACxD,iBAAiB,EAAE,iBAAiB,EACpC,QAAQ,EAAE,SAAS,GAClB,OAAO,CAAC,4BAA4B,GAAG,SAAS,CAAC,CAKnD;AAKD;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,iBAAiB,EAAE,iBAAiB,EACpC,QAAQ,EAAE,SAAS,EACnB,2BAA2B,EAAE,4BAA4B,GAAG,SAAS,GACpE,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CA8DvC;AAOD,MAAM,CAAC,OAAO,OAAO,gBAAiB,YAAW,eAAe;IACvD,QAAQ,EAAE,yBAAyB,CAExC;IAEK,KAAK,CAAC,WAAW,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,GAAG,IAAI;YA6CzE,kCAAkC;YA6ClC,0BAA0B;YAkD1B,gBAAgB;CAoB/B"}
+{"version":3,"file":"TypeScriptPlugin.d.ts","sourceRoot":"","sources":["../src/TypeScriptPlugin.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,WAAW,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAMhB,MAAM,iBAAiB,CAAC;AAOzB;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,mBAAyC,CAAC;AAQpE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,2BAA2B,CAAC,EAAE,eAAe,EAAE,GAAG,SAAS,CAAC;IAE5D;;OAEG;IACH,2BAA2B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAElD;;OAEG;IACH,2BAA2B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAElD;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;OAGG;IACH,gCAAgC,CAAC,EAAE,OAAO,CAAC;IAO3C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,8BAA8B,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,EAAE,+BAA+B,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,CAAC,wBAAwB,CAAC,CAAC;CACjE;AAmBD;;GAEG;AACH,wBAAsB,oCAAoC,CACxD,iBAAiB,EAAE,iBAAiB,EACpC,QAAQ,EAAE,SAAS,GAClB,OAAO,CAAC,4BAA4B,GAAG,SAAS,CAAC,CAKnD;AAKD;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,iBAAiB,EAAE,iBAAiB,EACpC,QAAQ,EAAE,SAAS,EACnB,2BAA2B,EAAE,4BAA4B,GAAG,SAAS,GACpE,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CA8DvC;AAOD,MAAM,CAAC,OAAO,OAAO,gBAAiB,YAAW,eAAe;IACvD,QAAQ,EAAE,yBAAyB,CAExC;IAEK,KAAK,CAAC,WAAW,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,GAAG,IAAI;YA6CzE,kCAAkC;YA6ClC,0BAA0B;YAkD1B,gBAAgB;CAoB/B"}

package/lib-dts/types.d.ts

@@ -50,5 +50,10 @@ export interface ICachedEmitModuleKind {
      * Declarations are only emitted for the primary module kind.
      */
     isPrimary: boolean;
+    /**
+     * If true, a package.json with the appropriate "type" field will be written
+     * to the output folder after emit.
+     */
+    emitModulePackageJson: boolean;
 }
 //# sourceMappingURL=types.d.ts.map

package/lib-dts/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,WAAW,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,eAAe,EAAE,WAAW,CAAC,eAAe,CAAC;IAC7C;;OAEG;IACH,iBAAiB,EAAE,qBAAqB,EAAE,CAAC;IAC3C;;OAEG;IACH,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC;CAChC;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED,MAAM,MAAM,6BAA6B,GAAG,4BAA4B,GAAG,0BAA0B,CAAC;AAEtG,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC;IAEnC,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;IAExC;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,WAAW,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,eAAe,EAAE,WAAW,CAAC,eAAe,CAAC;IAC7C;;OAEG;IACH,iBAAiB,EAAE,qBAAqB,EAAE,CAAC;IAC3C;;OAEG;IACH,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC;CAChC;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED,MAAM,MAAM,6BAA6B,GAAG,4BAA4B,GAAG,0BAA0B,CAAC;AAEtG,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC;IAEnC,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;IAExC;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,qBAAqB,EAAE,OAAO,CAAC;CAChC"}

package/lib-esm/TypeScriptBuilder.js

@@ -257,6 +257,7 @@ export class TypeScriptBuilder {
         ts.sys.writeFile, undefined, undefined, undefined);
         this._cleanupWorker();
         //#endregion
+        this._emitModulePackageJsonFiles(ts);
         this._logEmitPerformance(ts);
         //#region FINAL_ANALYSIS
         // Need to ensure that we include emit diagnostics, since they might not be part of the other sets
@@ -309,6 +310,7 @@ export class TypeScriptBuilder {
         tool.solutionBuilder.build();
         this._cleanupWorker();
         //#endregion
+        this._emitModulePackageJsonFiles(ts);
         if (pendingTranspilePromises.size) {
             const emitResults = await Promise.all(pendingTranspilePromises.values());
             for (const { diagnostics } of emitResults) {
@@ -422,7 +424,8 @@ export class TypeScriptBuilder {
         }
         if (this._configuration.emitCjsExtensionForCommonJS) {
             this._addModuleKindToEmit(ts.ModuleKind.CommonJS, tsconfig.options.outDir, 
-            /* isPrimary */ tsconfig.options.module === ts.ModuleKind.CommonJS, '.cjs');
+            /* isPrimary */ tsconfig.options.module === ts.ModuleKind.CommonJS, '.cjs', 
+            /* emitModulePackageJson */ false);
             const cjsReason = {
                 outDir: tsconfig.options.outDir,
                 kind: 'CommonJS',
@@ -434,7 +437,8 @@ export class TypeScriptBuilder {
         }
         if (this._configuration.emitMjsExtensionForESModule) {
             this._addModuleKindToEmit(ts.ModuleKind.ESNext, tsconfig.options.outDir, 
-            /* isPrimary */ tsconfig.options.module === ts.ModuleKind.ESNext, '.mjs');
+            /* isPrimary */ tsconfig.options.module === ts.ModuleKind.ESNext, '.mjs', 
+            /* emitModulePackageJson */ false);
             const mjsReason = {
                 outDir: tsconfig.options.outDir,
                 kind: 'ESNext',
@@ -447,7 +451,8 @@ export class TypeScriptBuilder {
         if (!specifiedKinds.has(tsconfig.options.module)) {
             this._addModuleKindToEmit(tsconfig.options.module, tsconfig.options.outDir, 
             /* isPrimary */ true, 
-            /* jsExtensionOverride */ undefined);
+            /* jsExtensionOverride */ undefined, 
+            /* emitModulePackageJson */ false);
             const tsConfigReason = {
                 outDir: tsconfig.options.outDir,
                 kind: ts.ModuleKind[tsconfig.options.module],
@@ -458,26 +463,27 @@ export class TypeScriptBuilder {
             specifiedOutDirs.set(`${tsconfig.options.outDir}:.js`, tsConfigReason);
         }
         if (this._configuration.additionalModuleKindsToEmit) {
-            for (const additionalModuleKindToEmit of this._configuration.additionalModuleKindsToEmit) {
-                const moduleKind = this._parseModuleKind(ts, additionalModuleKindToEmit.moduleKind);
-                const outDirKey = `${additionalModuleKindToEmit.outFolderName}:.js`;
+            for (const { moduleKind: moduleKindString, outFolderName, emitModulePackageJson = false } of this
+                ._configuration.additionalModuleKindsToEmit) {
+                const moduleKind = this._parseModuleKind(ts, moduleKindString);
+                const outDirKey = `${outFolderName}:.js`;
                 const moduleKindReason = {
                     kind: ts.ModuleKind[moduleKind],
-                    outDir: additionalModuleKindToEmit.outFolderName,
+                    outDir: outFolderName,
                     extension: '.js',
                     reason: `additionalModuleKindsToEmit`
                 };
                 const existingKind = specifiedKinds.get(moduleKind);
                 const existingDir = specifiedOutDirs.get(outDirKey);
                 if (existingKind) {
-                    throw new Error(`Module kind "${additionalModuleKindToEmit.moduleKind}" is already emitted at ${existingKind.outDir} with extension '${existingKind.extension}' by option ${existingKind.reason}.`);
+                    throw new Error(`Module kind "${moduleKind}" is already emitted at ${existingKind.outDir} with extension '${existingKind.extension}' by option ${existingKind.reason}.`);
                 }
                 else if (existingDir) {
-                    throw new Error(`Output folder "${additionalModuleKindToEmit.outFolderName}" already contains module kind ${existingDir.kind} with extension '${existingDir.extension}', specified by option ${existingDir.reason}.`);
+                    throw new Error(`Output folder "${outFolderName}" already contains module kind ${existingDir.kind} with extension '${existingDir.extension}', specified by option ${existingDir.reason}.`);
                 }
                 else {
-                    const outFolderKey = this._addModuleKindToEmit(moduleKind, additionalModuleKindToEmit.outFolderName, 
-                    /* isPrimary */ false, undefined);
+                    const outFolderKey = this._addModuleKindToEmit(moduleKind, outFolderName, 
+                    /* isPrimary */ false, undefined, emitModulePackageJson);
                     if (outFolderKey) {
                         specifiedKinds.set(moduleKind, moduleKindReason);
                         specifiedOutDirs.set(outFolderKey, moduleKindReason);
@@ -486,7 +492,7 @@ export class TypeScriptBuilder {
             }
         }
     }
-    _addModuleKindToEmit(moduleKind, outFolderPath, isPrimary, jsExtensionOverride) {
+    _addModuleKindToEmit(moduleKind, outFolderPath, isPrimary, jsExtensionOverride, emitModulePackageJson) {
         let outFolderName;
         if (path.isAbsolute(outFolderPath)) {
             outFolderName = path.relative(this._configuration.buildFolderPath, outFolderPath);
@@ -533,7 +539,8 @@ export class TypeScriptBuilder {
             outFolderPath,
             moduleKind,
             jsExtensionOverride,
-            isPrimary
+            isPrimary,
+            emitModulePackageJson
         });
         return `${outFolderName}:${jsExtensionOverride || '.js'}`;
     }
@@ -561,6 +568,7 @@ export class TypeScriptBuilder {
                 const result = originalEmit.call(newProgram, outerTargetSourceFile, outerWriteFile, outerCancellationToken, outerEmitOnlyDtsFiles, outerCustomTransformers);
                 result.changedSourceFiles = changedFiles;
                 this._typescriptTerminal.writeVerboseLine(`Emitting program "${innerCompilerOptions.configFilePath}"`);
+                this._emitModulePackageJsonFiles(ts);
                 this._logEmitPerformance(ts);
                 // Reset performance counters
                 ts.performance.disable();
@@ -639,6 +647,50 @@ export class TypeScriptBuilder {
         const host = ts.createSolutionBuilderWithWatchHost(system, this._getCreateBuilderProgram(ts), reportDiagnostic, reportDiagnostic, reportDiagnostic);
         return host;
     }
+    /**
+     * For each module kind configured with `emitModulePackageJson: true`, writes a
+     * `package.json` with the appropriate `"type"` field to ensure Node.js correctly
+     * interprets `.js` files in the output folder.
+     */
+    _emitModulePackageJsonFiles(ts) {
+        for (const { emitModulePackageJson, moduleKind, outFolderPath } of this._moduleKindsToEmit) {
+            if (!emitModulePackageJson) {
+                continue;
+            }
+            // "module" and "commonjs" are the only recognized values. See
+            // https://nodejs.org/api/packages.html#type
+            let moduleType;
+            switch (moduleKind) {
+                // UMD contains a CommonJS wrapper, so it should be treated as CommonJS for package.json generation purposes
+                case ts.ModuleKind.UMD:
+                case ts.ModuleKind.CommonJS: {
+                    moduleType = 'commonjs';
+                    break;
+                }
+                case ts.ModuleKind.AMD:
+                case ts.ModuleKind.None:
+                case ts.ModuleKind.Preserve:
+                case ts.ModuleKind.System: {
+                    moduleType = undefined;
+                    break;
+                }
+                default: {
+                    moduleType = 'module';
+                    break;
+                }
+            }
+            if (moduleType) {
+                const packageJsonPath = `${outFolderPath}package.json`;
+                const packageJsonContent = `{\n  "type": "${moduleType}"\n}\n`;
+                ts.sys.writeFile(packageJsonPath, packageJsonContent);
+                this._typescriptTerminal.writeVerboseLine(`Wrote ${packageJsonPath} with "type": "${moduleType}"`);
+            }
+            else {
+                throw new Error(`Unsupported module kind ${ts.ModuleKind[moduleKind]} for package.json generation. ` +
+                    `Remove the \`emitModulePackageJson\` option for this module kind.`);
+            }
+        }
+    }
     _parseModuleKind(ts, moduleKindName) {
         switch (moduleKindName.toLowerCase()) {
             case 'commonjs':