ts-transformer-export-default-name
This is a TypeScript AST transformer [1] that assigns a name to each arrow/anonymous function and class exported as default (e.g. export default () ⇒ 42
).
The name is derived from the name of the source file or its directory, in the case of index
file.
This transformer does basically the same as babel-plugin-transform-export-default-name but it’s implemented for the TypeScript compiler. See README of the aforesaid Babel plugin for the explanation why is this useful.
Examples
Arrow Function
export default () => 42
This will be transformed to:
const fortyTwo = () => 42;
export default fortyTwo;
Anonymous Function Declaration
export default function () {
return 42
}
This will be transformed to:
export default function fortyTwo() {
return 42;
}
Anonymous Class Declaration
export default class {
get answer () { return 42 }
}
This will be transformed to:
export default class FortyTwo {
get answer() { return 42; }
}
How to Use
Add ts-transformer-export-default-name package to your project as a development dependency and register it as a custom transformer.
Unfortunately, TypeScript itself does not currently provide any easy way to use custom transformers (see Microsoft/TypeScript#14419). Fortunately, there are few solutions.
TTypescript
If you don’t use any bundler such as Rollup or webpack, TTypescript is the way to go.
It provides wrappers ttsc
and ttserver
for the tsc
and tsserver
commands that add support for custom transformers.
All you have to do is to use these wrappers instead of the original commands and define the transformer in your tsconfig.json
:
{
"compilerOptions": {
// ...
"plugins": [
{ "transform": "ts-transformer-export-default-name" }
]
},
// ...
}
Rollup (with rollup-plugin-typescript2)
import typescript from 'rollup-plugin-typescript2'
import exportDefaultNameTransformer from 'ts-transformer-export-default-name'
export default {
// ...
plugins: [
typescript({
transformers: [
(service) => ({
before: [ exportDefaultNameTransformer(service.getProgram()) ],
after: [],
}),
],
}),
],
}
Webpack (with ts-loader or awesome-typescript-loader)
const exportDefaultNameTransformer = require('ts-transformer-export-default-name').default
module.exports = {
// ...
module: {
rules: [
{
test: /\.ts$/,
loader: 'ts-loader', // or 'awesome-typescript-loader',
options: {
getCustomTransformers: (program) => ({
before: [
exportDefaultNameTransformer(program),
],
}),
},
},
],
},
}
Development
System Requirements
-
NodeJS 10.13+
-
Pandoc and Asciidoctor (used only for converting README.adoc to Markdown for npmjs)
Used Tools
-
TypeScript the language
-
yarn for dependencies management and building
-
ESLint for linting JS/TypeScript code
-
tape for testing
-
Istanbul for tracking test coverage
How to Start
-
Clone this repository:
git clone https://github.com/jirutka/ts-transformer-export-default-name.git cd ts-transformer-export-default-name
-
Install Yarn (if you don’t have it already):
npm install -g yarn
-
Install all JS dependencies:
yarn install
-
Build the project:
yarn build
-
Run tests and generate code coverage:
yarn test
-
Run linter:
yarn lint
Visual Studio Code
If you use Visual Studio Code, you may find the following extensions useful:
Credits
-
This project is highly inspired by babel-plugin-transform-export-default-name.
License
This project is licensed under MIT License. For the full text of the license, see the LICENSE file.