babel-preset-proposal-typescript

Yet another Babel preset for TypeScript, only transforms proposals which TypeScript does not support now.

So that you can use babel to transform proposals which are current in stage 0-2 and TypeScript team will not implement them temporarily.

TOC

• Enabled proposal plugins
• Install
• Options
• Usage
  • Via .babelrc (Recommended)
  • Via CLI
  • Via Node API
  • Via webpack
• References
• Sponsors
• Backers
• Changelog
• License

Enabled proposal plugins

1. async-do-expressions
2. destructuring-private
3. do-expressions
4. duplicate-named-capturing-groups-regex
5. function-bind
6. function-sent
7. import-defer
8. import-wasm-source
9. optional-chaining-assign
10. partial-application
11. pipeline-operator
12. record-and-tuple
13. regexp-modifiers
14. throw-expressions
15. v8intrinsic - Further Detail

Install

1# yarn
2yarn add -D babel-preset-proposal-typescript
3
4# npm
5npm i -D babel-preset-proposal-typescript

Options

option	description	defaults
decoratorsBeforeExport	See Babel Document	undefined
decoratorsLegacy	Whether to use legacy decorators semantic	true
importDefer	Whether to enabled import-defer plugin, if true transform-modules-commonjs will be enabled automatically	false
isTSX	Whether to enable jsx plugin with typescript	false, but true for /\.[jt]sx$/
optionalChainingAssignVersion	Version for optional-chaining-assign plugin, only '2023-07' allowed for now	'2023-07'
pipelineOperator	Implementation of pipeline operator, minimal, smart or fsharp	minimal
recordTuplePolyfill	Whether to enable import record-tuple plugin and polyfill, or specific the polyfill module name	true for Node>=14.6, it represents @bloomberg/record-tuple-polyfill
recordTupleSyntaxType	record-tuple syntax, hash or bar	hash

Usage

Note that unlike plugins, the presets are applied in an order of last to first (https://babeljs.io/docs/en/presets/#preset-ordering), so please make sure proposal-typescript is used at the last.

Via .babelrc (Recommended)

.babelrc

1{
2  "presets": ["proposal-typescript"]
3}

Via CLI

1babel input.ts --presets proposal-typescript > output.ts

Via Node API

1require('@babel/core').transform('code', {
2  presets: ['proposal-typescript'],
3})

Via webpack

Pipe codes through babel-loader.

1loader = {
2  test: /\.[jt]sx?$/,
3  loader: 'babel-loader',
4  options: {
5    presets: ['@babel/typescript', 'proposal-typescript'],
6  },
7}
8
9// if you prefer `ts-loader` or `awesome-typescript-loader`
10loader = {
11  test: /\.tsx?$/,
12  use: [
13    {
14      loader: 'ts-loader',
15    },
16    {
17      loader: 'babel-loader',
18      options: {
19        presets: ['proposal-typescript'],
20      },
21    },
22  ],
23}

References

• TC39 Proposals
• Babel Proposals

Sponsors

1stG	RxTS	UnTS

Backers

1stG	RxTS	UnTS

Changelog

Detailed changes for each release are documented in CHANGELOG.md.

License

MIT © JounQin@1stG.me