rbxts-transformer-path

rbxts-transformer-path

A transformer designed for roblox-ts that allows to convert from filesystem project paths to pure Roblox tree structure (rojo required)

import { $path } from "rbxts-transformer-path";

const scripts = $path<Folder>("src/server/scripts");

function getDescendantsWhichIsA<T extends keyof Instances>(
  parent: Instance,
  className: T
) {
  return parent
    .GetDescendants()
    .filter((object): object is Instances[T] => object.IsA(className));
}

getDescendantsWhichIsA(scripts, "ModuleScript").forEach((script) =>
  require(script)
);

Warning

• Client-side paths are not tested yet but planned in the next version
• It is designed for games, not plugins
• It is unhelpful to errors and debugging
• It defaults to default.project.json
• It is a bit unstable.
• It is slow because of function generator (I don't know how to optimize this)

Installation

1. Run this command below:

npm i rbxts-transformer-path

1. Head over to the tsconfig.json on your recent project and put the following under compilerOptions:

"plugins": [
	{ "transform": "rbxts-transformer-path" }
]

Credits

Credits for the code to:

• roblox-ts (for Rojo project stuff it's kinda complicated to make it one, well I did but it's not working)
• @flamework/transformer