feat(hook): add hook that can rewrite output paths before files are emitted.

Author: wessberg

README.md

@@ -77,6 +77,20 @@ In comparison with the [official plugin](https://github.com/rollup/rollup-plugin
  - [Typescript, Babel, and Browserslist example](#typescript-babel-and-browserslist-example)
  - [Pure Typescript with CustomTransformers](#pure-typescript-with-customtransformers)
  - [Advanced example of using Typescript, Babel, and Browserslists together](#advanced-example-of-using-typescript-babel-and-browserslists-together)
+- [Hooks](#hooks)
+ - [The `outputPath` hook](#the-outputpath-hook)
+- [Full list of plugin options](#full-list-of-plugin-options)
+ - [`transpiler`](#transpiler)
+ - [`babelConfig`](#babelconfig)
+ - [`tsconfig`](#tsconfig)
+ - [`browserslist`](#browserslist)
+ - [`cwd`](#cwd)
+ - [`transformers`](#transformers)
+ - [`include`](#include)
+ - [`exclude`](#exclude)
+ - [`transpileOnly`](#transpileonly)
+ - [`fileSystem`](#filesystem)
+ - [`hook`](#hook)
 - [Ignored/overridden options](#ignoredoverridden-options)
  - [Ignored/overridden Typescript options](#ignoredoverridden-typescript-options)
  - [Ignored/overridden Babel options](#ignoredoverridden-babel-options)
@@ -349,9 +363,7 @@ This example shows how you can use this plugin to accomplish quite advanced thin
 
 ```javascript
 const IS_PRODUCTION = (process.env.NODE_ENV = "production");
-const BUNDLE_TARGET = process.env.NODE_ENV;
-const BROWSERSLIST_MODERN = ["since 2015", "not dead", "> 5%"];
-const BROWSERSLIST_LEGACY = ["defaults"];
+const BUNDLE_TARGET = process.env.BUNDLE_TARGET;
 const APP_ROOT = "/some/project/root/folder";
 const awesomeFrameworkTransformers = getAwesomeFrameworkCustomTransformers();
 
@@ -377,6 +389,113 @@ ts({
 });
 ```
 
+## Hooks
+
+`rollup-plugin-ts` provides a few hooks that allow you to hook into and augment the internal behavior of the plugin.
+
+These can be provided in the plugin options for the `hook` property:
+
+```typescript
+ts({
+hook: {
+// Add hooks here
+}
+});
+```
+
+The next few subsections describe the different hooks that can be provided
+
+### The `outputPath` hook
+
+Type: `(path: string, kind: "declaration" | "declarationMap") => string | undefined`
+
+The `outputPath` hook can be used to rewrite the location on the filesystem that assets produced by `rollup-plugin-ts` are written to.
+It is invoked immediately before assets such as _declarations_ or _declaration maps_ are emitted.
+
+The hook is invoked with the output path as well as the kind of asset the path represents as arguments.
+If you return a `string` from the hook, the alternative location will be used instead. If you return undefined, the current path will be used.
+
+```typescript
+ts({
+hook: {
+outputPath: (path, kind) => rewritePathSomehow(path, kind)
+}
+});
+```
+
+For example, the `path` may be `/some/path/index.d.ts`, and `kind` be `declaration`, and you might want to rewrite this to `/some/path/my-typings.d.ts`.
+
+## Full list of plugin options
+
+The plugin options are documented in more detail across this README, but the full list of options is:
+
+#### `transpiler`
+
+Type: `"typescript" | "babel"`
+
+Can be any of `"babel"` or `"typescript"` (default: `"typescript"`).
+See [this section](#combining-typescript-with-babel) and [this section](#when-combined-with-babel-what-does-typescript-do-and-what-does-babel-do) for details on how `rollup-plugin-ts` works when `"babel"` is being used as a transpiler.
+
+#### `babelConfig`
+
+Type: `string | Partial<IBabelInputOptions>`
+
+This option will only be respected when `"babel"` is being used as the `transpiler` and can be used to provide a [Babel config](https://babeljs.io/docs/en/options) or a path to one.
+
+#### `tsconfig`
+
+Type: `string | Partial<CompilerOptions> | Partial<Record<keyof CompilerOptions, string | number | boolean>> | ParsedCommandLine | TsConfigResolver | TsConfigResolverWithFileName`
+
+Provide the Typescript [CompilerOptions](https://www.typescriptlang.org/docs/handbook/compiler-options.html) to use, or a path to a `tsconfig` with this property.
+See [this section](#using-it-with-just-typescript) for details on the many ways this property can be configured.
+
+#### `browserslist`
+
+Type: `false | string[] | string | BrowserslistConfig`
+
+Provide the [Browserslist](https://github.com/browserslist/browserslist) to use, or a path to a `.browserslistrc` with this property.
+See [this section](#combining-typescript-with-a-browserslist) for details on the many ways this property can be configured.
+
+#### `cwd`
+
+Type: `string`
+
+Use this property to overwrite whatever is considered the root directory. The default value is `process.cwd()`.
+
+#### `transformers`
+
+Type: `(CustomTransformers | CustomTransformersFunction)[] | CustomTransformers | CustomTransformersFunction`
+
+Use this property to provide Typescript [`CustomTransformers`](https://github.com/Microsoft/TypeScript/pull/13940).
+See [this section](#using-customtransformers) for more details on how to configure this property.
+
+#### `include`
+
+Type: `string[]|string`
+
+This option takes a minimatch pattern or an array of minimatch patterns and only transforms files with filenames that the pattern matches.
+
+#### `exclude`
+
+Type: `string[]|string`
+
+This option takes a minimatch pattern or an array of minimatch patterns and only transforms files with filenames that the pattern doesn't match.
+
+#### `transpileOnly`
+
+Type: `boolean`
+
+If this option is `true`, diagnostics won't be generated. This will improve performance since Typescript but ignores all syntactical and semantic errors or warnings that may arise.
+
+#### `fileSystem`
+
+Optionally the [FileSystem](https://github.com/wessberg/rollup-plugin-ts/blob/master/src/util/file-system/file-system.ts) to use. This is useful for example when you want to provide a virtual FileSystem to read from or write to.
+
+#### `hook`
+
+Use this property to get hooks into the internals of `rollup-plugin-ts`.
+See [this section](#hooks) for more details.
+
 ## Ignored/overridden options
 
 Typescript and Babel are powerful tools in their own right. Combined with Rollup, they become even more powerful.

package.json

@@ -49,42 +49,42 @@
 ],
 "license": "MIT",
 "devDependencies": {
-"@wessberg/rollup-plugin-ts": "^1.1.63",
+"@wessberg/rollup-plugin-ts": "^1.1.64",
 "@wessberg/scaffold": "^1.0.19",
 "@wessberg/ts-config": "^0.0.41",
-"ava": "2.3.0",
-"husky": "^3.0.4",
-"np": "^5.0.3",
+"ava": "2.4.0",
+"husky": "^3.0.7",
+"np": "^5.1.0",
 "prettier": "^1.18.2",
 "pretty-quick": "^1.11.1",
-"rollup": "^1.20.3",
+"rollup": "^1.22.0",
 "standard-changelog": "^2.0.13",
-"ts-node": "8.3.0",
-"tslint": "^5.19.0",
-"typescript": "^3.6.2"
+"ts-node": "8.4.1",
+"tslint": "^5.20.0",
+"typescript": "^3.6.3"
 },
 "dependencies": {
-"@babel/core": "^7.5.5",
+"@babel/core": "^7.6.2",
 "@babel/plugin-proposal-async-generator-functions": "^7.2.0",
 "@babel/plugin-proposal-json-strings": "^7.2.0",
-"@babel/plugin-proposal-object-rest-spread": "^7.5.5",
+"@babel/plugin-proposal-object-rest-spread": "^7.6.2",
 "@babel/plugin-proposal-optional-catch-binding": "^7.2.0",
-"@babel/plugin-proposal-unicode-property-regex": "^7.4.4",
+"@babel/plugin-proposal-unicode-property-regex": "^7.6.2",
 "@babel/plugin-syntax-dynamic-import": "^7.2.0",
-"@babel/plugin-transform-runtime": "^7.5.5",
-"@babel/preset-env": "^7.5.5",
-"@babel/runtime": "^7.5.5",
+"@babel/plugin-transform-runtime": "^7.6.2",
+"@babel/preset-env": "^7.6.2",
+"@babel/runtime": "^7.6.2",
 "@types/mkdirp": "^0.5.2",
-"@types/node": "^12.7.2",
+"@types/node": "^12.7.8",
 "@types/resolve": "0.0.8",
-"@wessberg/browserslist-generator": "1.0.23",
+"@wessberg/browserslist-generator": "1.0.26",
 "@wessberg/stringutil": "^1.0.18",
-"browserslist": "4.6.6",
+"browserslist": "4.7.0",
 "find-up": "^4.1.0",
-"magic-string": "^0.25.3",
+"magic-string": "^0.25.4",
 "mkdirp": "^0.5.1",
 "resolve": "^1.12.0",
-"rollup-pluginutils": "^2.8.1",
+"rollup-pluginutils": "^2.8.2",
 "slash": "^3.0.0",
 "tslib": "^1.10.0"
 },

rollup.config.js

@@ -26,6 +26,8 @@ export default {
 ...builtinModules,
 ...Object.keys(packageJson.dependencies),
 ...Object.keys(packageJson.devDependencies),
-...Object.keys(packageJson.peerDependencies)
+...Object.keys(packageJson.peerDependencies),
+"@babel/core/lib/config/files/configuration",
+"@babel/core/lib/config/files/package"
 ]
 };

src/plugin/i-typescript-plugin-options.ts

@@ -22,6 +22,13 @@ export interface TsConfigResolverWithFileName {
 
 export type TsConfigResolver = TsConfigResolverWithFileName["hook"];
 
+export type OutputPathKind = "declaration" | "declarationMap";
+export type OutputPathHook = (path: string, kind: OutputPathKind) => string | undefined;
+
+export interface HookRecord {
+outputPath: OutputPathHook;
+}
+
 export interface ITypescriptPluginBaseOptions {
 transpiler: Transpiler;
 tsconfig?:
@@ -38,6 +45,7 @@ export interface ITypescriptPluginBaseOptions {
 exclude: string[] | string;
 transpileOnly?: boolean;
 fileSystem: FileSystem;
+hook: Partial<HookRecord>;
 }
 
 export interface ITypescriptPluginTypescriptOptions extends ITypescriptPluginBaseOptions {

src/plugin/typescript-plugin.ts

@@ -392,7 +392,7 @@ export default function typescriptRollupPlugin(pluginInputOptions: Partial<Types
 const generateMap = Boolean(parsedCommandLineResult.parsedCommandLine.options.declarationMap);
 
 const chunkToOriginalFileMap: Map<string, string[]> = new Map(
-chunks.map<[string, string[]]>(chunk => [join(declarationOutDir, normalize(chunk.fileName)), Object.keys(chunk.modules).map(normalize)])
+chunks.map<[string, string[]]>(chunk => [join(outDir, normalize(chunk.fileName)), Object.keys(chunk.modules).map(normalize)])
 );
 const moduleNames = [
 ...new Set(
@@ -431,6 +431,7 @@ export default function typescriptRollupPlugin(pluginInputOptions: Partial<Types
 outDir,
 cwd,
 outputOptions,
+pluginOptions,
 languageService,
 languageServiceHost,
 emitCache,

src/service/transformer/declaration-bundler/util/module-specifier/normalize-module-specifier.ts

@@ -34,8 +34,9 @@ export function normalizeModuleSpecifier({
 const normalizedAbsoluteModuleSpecifierText = getChunkFilename(absoluteModuleSpecifierText, supportedExtensions, chunkToOriginalFileMap);
 
 // Potentially rewrite the ModuleSpecifier text to refer to one of the generated chunk filenames (which may not be the same or named the same)
-const normalizedModuleSpecifier = stripExtension(
-ensureHasLeadingDotAndPosix(relative(dirname(absoluteOutFileName), normalizedAbsoluteModuleSpecifierText))
+const normalizedModuleSpecifier = ensureHasLeadingDotAndPosix(
+stripExtension(relative(dirname(absoluteOutFileName), normalizedAbsoluteModuleSpecifierText)),
+false
 );
 
 return {

src/service/transformer/declaration-tree-shaker/after-declarations/after-declarations.ts

@@ -7,11 +7,11 @@ import {mergeImports} from "../util/merge-imports/merge-imports";
 import {mergeExports} from "../util/merge-exports/merge-exports";
 import {normalize} from "path";
 
-export function afterDeclarations({relativeOutFileName}: IDeclarationTreeShakerOptions): TransformerFactory<SourceFile> {
+export function afterDeclarations({declarationFilename}: IDeclarationTreeShakerOptions): TransformerFactory<SourceFile> {
 return context => {
 return sourceFile => {
 // If the SourceFile is not part of the local module names, remove all statements from it and return immediately
-if (normalize(sourceFile.fileName) !== normalize(relativeOutFileName)) return updateSourceFileNode(sourceFile, [], true);
+if (normalize(sourceFile.fileName) !== normalize(declarationFilename)) return updateSourceFileNode(sourceFile, [], true);
 
 // Prepare a cache
 const cache: ReferenceCache = {

src/service/transformer/declaration-tree-shaker/i-declaration-tree-shaker-options.ts

@@ -1,3 +1,4 @@
 export interface IDeclarationTreeShakerOptions {
 relativeOutFileName: string;
+declarationFilename: string;
 }

src/util/emit-declarations/i-emit-declarations-options.ts

@@ -3,6 +3,7 @@ import {LanguageService} from "typescript";
 import {IncrementalLanguageService} from "../../service/language-service/incremental-language-service";
 import {IEmitCache} from "../../service/cache/emit-cache/i-emit-cache";
 import {FileSystem} from "../file-system/file-system";
+import {TypescriptPluginOptions} from "../../plugin/i-typescript-plugin-options";
 
 export interface IEmitDeclarationsOptions {
 pluginContext: PluginContext;
@@ -15,6 +16,7 @@ export interface IEmitDeclarationsOptions {
 moduleNames: string[];
 localModuleNames: string[];
 entryFileNames: string[];
+pluginOptions: TypescriptPluginOptions;
 outputOptions: OutputOptions;
 languageService: LanguageService;
 languageServiceHost: IncrementalLanguageService;