https://github.com/dropbox/ts-transform-react-constant-elements

A TypeScript AST Transformer that can speed up reconciliation and reduce garbage collection pressure by hoisting React elements to the highest possible scope.
https://github.com/dropbox/ts-transform-react-constant-elements

ast constant elements optimization react transform typescript

Last synced: 3 months ago
JSON representation

A TypeScript AST Transformer that can speed up reconciliation and reduce garbage collection pressure by hoisting React elements to the highest possible scope.

• Host: GitHub
• URL: https://github.com/dropbox/ts-transform-react-constant-elements
• Owner: dropbox
• License: apache-2.0
• Created: 2018-12-18T19:59:46.000Z (almost 6 years ago)
• Default Branch: main
• Last Pushed: 2023-08-29T21:27:45.000Z (about 1 year ago)
• Last Synced: 2024-07-31T14:44:51.739Z (3 months ago)
• Topics: ast, constant, elements, optimization, react, transform, typescript
• Language: TypeScript
• Homepage:
• Size: 143 KB
• Stars: 44
• Watchers: 10
• Forks: 6
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-typescript-ecosystem - ts-transform-react-constant-elements - A TypeScript AST Transformer that can speed up reconciliation and reduce garbage collection pressure by hoisting React elements to the highest possible scope (Transformers / React)

README

        
# ts-transform-react-constant-elements

![build status](https://travis-ci.org/dropbox/ts-transform-react-constant-elements.svg?branch=master)

This is a TypeScript AST Transformer that can speed up reconciliation and reduce garbage collection pressure by hoisting React elements to the highest possible scope, preventing multiple unnecessary reinstantiations, similar to [babel-plugin-transform-react-constant-elements](https://babeljs.io/docs/en/babel-plugin-transform-react-constant-elements).

Example:

```ts

const Hr = () => {

  return 
;

};


// becomes 

const _ref = 
;


const Hr = () => {

  return _ref;

};

```

This is especially useful for hoisting static but expensive content such as SVG.

## Usage

First of all, you need some level of familiarity with the [TypeScript Compiler API](https://github.com/Microsoft/TypeScript/wiki/Using-the-Compiler-API).

`compile.ts` & tests should have examples of how this works. The available options are:

### `verbose?: boolean`

Enabling this will allow this transformer to log out which nodes are hoisted.

## License

Copyright (c) 2018 Dropbox, Inc.

Licensed under the Apache License, Version 2.0 (the "License");

you may not use this file except in compliance with the License.

You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software

distributed under the License is distributed on an "AS IS" BASIS,

WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

See the License for the specific language governing permissions and

limitations under the License.