Home

Awesome

<div align="center"> <img width="520" src="./media/Logo.svg">

ts-creator

A code generator to generate TypeScript code generator from TypeScript code

Build Status NPM version codecov

👉 Try It! 👈

</div>

How to use it:

npm install ts-creator

1. generate from code

import creator from 'ts-creator'

const generatedFactoryCode = creator(`const foo = "your code here"`)

2. transform source file

import { transformSourceFile } from 'ts-creator'

declare const file: ts.SourceFile
const factoryFile = transformSourceFile(file)

3. transform node

import { transformNode } from 'ts-creator'

declare const node: ts.Expression
const factoryNode = transformNode(node)

How does it work?

If you want to write a TypeScript codegen.

You got TypeScript code:

function foo(bar: number): number {
  return bar + 1
}

ts-creator generate TypeScript factory from given code to:

ts.createFunctionDeclaration(
  undefined,
  undefined,
  undefined,
  ts.createIdentifier('foo'),
  undefined,
  [
    ts.createParameter(
      undefined,
      undefined,
      undefined,
      ts.createIdentifier('bar'),
      undefined,
      ts.createKeywordTypeNode(ts.SyntaxKind.NumberKeyword),
      undefined
    )
  ],
  ts.createKeywordTypeNode(ts.SyntaxKind.NumberKeyword),
  ts.createBlock(
    [
      ts.createReturn(
        ts.createBinary(
          ts.createIdentifier('bar'),
          ts.createToken(ts.SyntaxKind.PlusToken),
          ts.createNumericLiteral('1')
        )
      )
    ],
    true
  )
)

Result after run the generated factory code:

function foo(bar: number): number {
    return bar + 1;
}

Cli usage

Use ts-creator cli to generate code:

ts-creator <input> [options]

Simple usage:

# print generate code
ts-creator foo.ts

# or read data from pipeline
echo 42 | ts-creator
cat foo.ts | ts-creator
ts-creator < foo.ts

# write to file
ts-creator foo.ts -o foo.js
ts-creator foo.ts > foo.js

Installation

You can install ts-creator globally.

npm i -g ts-creator
# or yarn
yarn global add ts-creator

If you install locally, may prepend npx or yarn you need.

# use npm
npm i ts-creator
npx ts-creator -h

# use yarn
yarn add ts-creator
yarn ts-creator -h

Cli options

optiondescriptiontypedefault
--target, -tgenerate targetsEnum { expression, runnable, esmodule, commonjs }expression
--output, -ooutput to filepathStringundefined
--tsxtsx supportBooleanfalse
--colorcolorful printBooleantrue
--semiprint semicolons at the ends of statementsBooleanfalse
--single-quoteuse single quotes instead of double quotesBooleantrue
--jsx-single-quoteuse single quotes in JSXBooleanfalse
--bracket-spacingprint spaces between brackets in object literalsBooleantrue
--tab-widthpecify the number of spaces per indentation-levelNumber2
--use-tabsindent lines with tabs instead of spacesBooleanfalse
--trailing-commaprint trailing commas wherever possibleEnum { none, es5, all }none
--prose-wraphow to wrap outputEnum { always, never, preserve }preserve
--version, -vshow ts-creator versionsBooleanfalse
--help, -hshow helperBooleanfalse

TODO: