zsr-transpiler

library1.3.0jsnpmunverified

CLI tool for transpiling ZetSharpRoblox (.zsr) files to Roblox Luau (.luau) without requiring Python. Version 1.3.0, released under MIT license. Actively maintained with a watch mode for auto-transpilation and support for reverse transpilation. Key differentiators: no Python dependency, seamless Rojo integration, and a beginner-friendly language syntax. Prioritizes simplicity over advanced features, making it ideal for Roblox developers new to transpilation.

devops

npm install zsr-transpiler

github ↗package ↗

INSTALL

IMPORT

SIG · ZSR-TRANSPILER

zsr-transpiler

devopsjavascriptv1.3.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

zsr-transpiler (CLI)

✓ zsr-transpiler build src

✗ npx zsr-transpiler build

Install globally via npm install -g to use the command directly. npx works but requires network on first run.

Programmatic API (if any)

✓ Not available; CLI only

✗ require('zsr-transpiler')

This package is CLI-only; there is no programmatic API. Attempting to import it will fail.

Installs globally, creates a minimal ZSR project, transpiles a script to Luau, and demonstrates watch mode.

npm install -g zsr-transpiler mkdir my-game && cd my-game echo '@Players on Players.PlayerAdded(player) { log("Welcome, {player.Name}") }' > src/main.zsr zsr-transpiler build src # output: src/main.luau zsr-transpiler watch src # auto-transpile on save

zsr --version

Debug

Known issues

gotchaCLI must be installed globally or used via npx; local install may not expose the command directly.

fix

Run npm install -g zsr-transpiler to install globally, or use npx zsr-transpiler for on-demand usage.

affects: >=1.0.0

gotchaNo programmatic API; require('zsr-transpiler') will throw Module not found.

fix

Use the CLI via command line only; do not attempt to import in code.

affects: >=1.0.0

breakingWatch mode may fail on older Node versions (<18) due to dependency requirements.

fix

Upgrade Node.js to version 18 or higher.

affects: >=1.0.0

Errors

Common errors & fixes

zsr-transpiler: command not found

zsr-transpiler not installed globally or not in PATH.

fix

Run npm install -g zsr-transpiler to install globally, or use npx zsr-transpiler.

Error: Cannot find module 'chokidar'

Missing dependency due to incomplete installation.

fix

Reinstall the package with npm install -g zsr-transpiler to ensure all dependencies are installed.

Upgrade

Version history

1.3.0latest on npm

Audit

Dependencies

chokidarrequiredFile watching for watch command

Agent activity

40 hits · last 30 days

node

Resources

githubhttps://github.com/zetbytes/zetcoder ↗

packagehttps://www.npmjs.com/package/zsr-transpiler ↗