rbxts-transformer-t

TypeScript transformer which converts TypeScript types to t entities

Usage no npm install needed!

<script type="module">
  import rbxtsTransformerT from 'https://cdn.skypack.dev/rbxts-transformer-t';
</script>

README

rbxts-transformer-t

TypeScript transformer which converts TypeScript types to t entities

Installation

To install this package run the following command:

npm i rbxts-transformer-t

Usage

To use this transformer you have to add rbxts-transformer-t to your tsconfig.json file in compilerOptions config

"plugins": [
    {
        "transform": "rbxts-transformer-t",
    }
]

Before

import { $terrify } from "rbxts-transformer-t";

interface Data {
    Color: Color3;
    Name: string;
    Material: Enum.Material;
}

const tType = $terrify<Data>();

After

local t = TS.import(script, TS.getModule(script, "t").lib.ts).t

local tType = t.interface({
    Color = t.Color3,
    Name = t.string,
    Material = t.enum(Enum.Material),
})

About this transformer

What it can do

  1. Transform almost all TypeScript types into t models:
  • null, undefined, void, unknown
  • string, boolean and number literals
  • string, boolean, number, any and thread types
  • arrays, tuples, maps, objects and functions
  • type unions and intersections
  • interfaces types
  • roblox types such as Enum Axes
  • Enums to enum ex. Enum.Material => t.enum(Enum.Material)
  1. Compute expressions passed into it.

For example, this expression

$terrify<Omit<{ foo: 'bar', bar: number } & { data: string }, 'bar'>>()

will be converted into

local t = TS.import(script, TS.getModule(script, "t").lib.ts).t

t.interface({
    foo = t.literal("bar"),
    data = t.string,
})

What it can't do

  1. Transform classes.

  2. Work with dynamic type parameters, i.e. $terrify<T>() in the following code will error:

import { $terrify } from 'rbxts-transformer-t'

function convertEntity<T>(entity: T) {
  return $terrify<T>()
}