rbxts-transformer-t

1.1.5 • Public • Published

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>()
}

Package Sidebar

Install

npm i rbxts-transformer-t

Weekly Downloads

75

Version

1.1.5

License

ISC

Unpacked Size

61.9 kB

Total Files

18

Last publish

Collaborators

  • alihsaas