luau2ts 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tony Bolivar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,107 @@
+<div align="center">
+  <img src="static/img/logo.png" alt="luau2ts" width="200" />
+
+  # luau2ts
+
+  **A Luau-to-TypeScript compiler for Roblox.**
+
+  [![CI](https://github.com/luau2ts/luau2ts/actions/workflows/test.yml/badge.svg)](https://github.com/luau2ts/luau2ts/actions/workflows/test.yml)
+  [![codecov](https://codecov.io/gh/luau2ts/luau2ts/branch/main/graph/badge.svg)](https://codecov.io/gh/luau2ts/luau2ts)
+  [![npm](https://img.shields.io/npm/v/luau2ts.svg)](https://www.npmjs.com/package/luau2ts)
+  [![downloads](https://img.shields.io/npm/dm/luau2ts.svg)](https://www.npmjs.com/package/luau2ts)
+  [![license](https://img.shields.io/npm/l/luau2ts.svg)](./LICENSE)
+  [![node](https://img.shields.io/node/v/luau2ts.svg)](https://www.npmjs.com/package/luau2ts)
+</div>
+
+## Why?
+
+[`roblox-ts`](https://roblox-ts.com) compiles TypeScript to Luau so Roblox developers can write strongly-typed game code in TS.
+
+`luau2ts` is the mirror: it compiles **Luau to TypeScript**. Use it to migrate an existing Luau codebase to TypeScript, to keep two parallel runtimes in sync, or to run authored Luau through TS-native tooling. Output is idiomatic, readable TS, with optional 1:1 line-mapped source maps and a roblox-ts-compatible emit mode.
+
+## Install
+
+```bash
+npm install -g luau2ts
+```
+
+Or as a project dependency:
+
+```bash
+npm install --save-dev luau2ts
+```
+
+## Quick start
+
+Compile a single file:
+
+```bash
+luau2ts foo.luau                 # → stdout
+luau2ts foo.luau -o foo.ts       # → foo.ts
+```
+
+Compile every `.luau` and `.lua` file in a directory tree:
+
+```bash
+luau2ts src/ -o out/
+```
+
+Walk a Rojo project file and emit a parallel TypeScript tree:
+
+```bash
+luau2ts -p default.project.json -o out/
+```
+
+Use it as a library:
+
+```ts
+import { compile } from 'luau2ts';
+
+const result = await compile(`
+  local function greet(name)
+    print("Hello, " .. name)
+  end
+`);
+
+console.log(result.source);
+// // Compiled by luau2ts v0.1.0 (do not edit).
+// function greet(name) {
+//   print(`Hello, ${name}`);
+// }
+```
+
+## Compatibility
+
+`luau2ts` ships two emit modes. Switch with `--mode <name>` or `compatMode` in the library API.
+
+| Mode | What it emits | Pairs with |
+|---|---|---|
+| `rbxts` (default) | TS that mirrors what [roblox-ts](https://roblox-ts.com) accepts as input: `new Vector3(...)`, `import { Workspace } from '@rbxts/services'`, 0-indexed arrays for statically-typed arrays. | [`@rbxts/types`](https://www.npmjs.com/package/@rbxts/types), [`@rbxts/services`](https://www.npmjs.com/package/@rbxts/services), [`@rbxts/promise`](https://www.npmjs.com/package/@rbxts/promise), the `roblox-ts` build pipeline. |
+| `native` | TS that imports stdlib helpers from `luau2ts/runtime` (`luaIndex`, `lualen`, `pairKeys`, `multiret`, ...) and uses Roblox's native API surface (`Vector3.new(...)`, `game:GetService(...)`, 1-indexed arrays). | A host runtime that mirrors Roblox's Luau API surface. |
+
+## Status
+
+| | |
+|---|---|
+| Luau conformance | **53 / 53** upstream conformance tests pass (100%) |
+| Tests | **255 passing** across **9 test files** |
+| Roblox API coverage (rbxts mode) | **4798 / 4798** members across **682 classes** (100%) |
+
+## Docs
+
+Full guide and API reference at **[luau2ts.dev](https://luau2ts.com)**.
+
+Highlights:
+- [Quick start](https://luau2ts.com/docs/quick-start)
+- [Setup guide](https://luau2ts.com/docs/setup-guide)
+- [CLI usage](https://luau2ts.com/docs/usage)
+- [Rojo project conversion](https://luau2ts.com/docs/guides/rojo-project-conversion)
+- [Using with roblox-ts](https://luau2ts.com/docs/guides/using-with-roblox-ts)
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for build / test / release workflow.
+
+## License
+
+[MIT](./LICENSE) © Tony Bolivar

package/dist/cli/args.d.ts

@@ -0,0 +1,19 @@
+import type { CompatMode } from '../compile/context.js';
+export interface ParsedArgs {
+    /** Positional input: a `.luau`/`.lua` file, a directory, or undefined when `-p` is set. */
+    input: string | undefined;
+    /** Project file path, set by `-p` / `--project`. Mutually exclusive with `input`. */
+    project: string | undefined;
+    /** Output target. For single-file input: a file path (or `-` for stdout, the default).
+     *  For directory or project input: an output directory. */
+    output: string | undefined;
+    mode: CompatMode;
+    sourcemap: boolean;
+    help: boolean;
+    version: boolean;
+}
+export declare class ArgError extends Error {
+}
+export declare function parseArgs(argv: string[]): ParsedArgs;
+export declare const HELP_TEXT = "luau2ts \u2014 A Luau-to-TypeScript compiler for Roblox.\n\nUsage:\n  luau2ts <file.luau>                    Compile one file. Writes to stdout.\n  luau2ts <file.luau> -o <file.ts>       Compile one file. Writes to a file.\n  luau2ts <dir/> -o <out/>               Compile every .luau/.lua under <dir/>.\n                                          Mirrors the input tree into <out/>.\n  luau2ts -p <default.project.json> -o <out/>\n                                          Walk a Rojo project file, compile\n                                          every script it references, and\n                                          emit a roblox-ts-shaped tree.\n\nFlags:\n  -o, --output <path>     Output file or directory. Default: stdout for\n                          single-file input; required for dir/project.\n  -p, --project <path>    Path to a Rojo *.project.json file, or a directory\n                          containing default.project.json.\n      --mode <name>       Emit compatibility mode. One of:\n                            rbxts   (default) \u2014 emits TS that imports from\n                                                @rbxts/types, @rbxts/services,\n                                                etc. Pairs with roblox-ts.\n                            native           \u2014 emits TS that imports stdlib\n                                                helpers from 'luau2ts/runtime'.\n                                                Pairs with a host runtime that\n                                                provides Roblox's Luau API.\n      --sourcemap         Emit a .ts.map next to each .ts.\n  -h, --help              Show this help text.\n  -v, --version           Print the installed luau2ts version.\n";
+//# sourceMappingURL=args.d.ts.map

package/dist/cli/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,2FAA2F;IAC3F,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,qFAAqF;IACrF,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;+DAC2D;IAC3D,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,QAAS,SAAQ,KAAK;CAAG;AAEtC,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAkGpD;AAED,eAAO,MAAM,SAAS,+sDA4BrB,CAAC"}

package/dist/cli/args.js

@@ -0,0 +1,130 @@
+export class ArgError extends Error {
+}
+export function parseArgs(argv) {
+    const result = {
+        input: undefined,
+        project: undefined,
+        output: undefined,
+        mode: 'rbxts',
+        sourcemap: false,
+        help: false,
+        version: false,
+    };
+    const positional = [];
+    let i = 0;
+    while (i < argv.length) {
+        const arg = argv[i];
+        if (arg === '--') {
+            // All remaining args are positional, mirroring POSIX convention.
+            for (let j = i + 1; j < argv.length; j += 1)
+                positional.push(argv[j]);
+            break;
+        }
+        if (arg === '-h' || arg === '--help') {
+            result.help = true;
+            i += 1;
+            continue;
+        }
+        if (arg === '-v' || arg === '--version') {
+            result.version = true;
+            i += 1;
+            continue;
+        }
+        if (arg === '--sourcemap') {
+            result.sourcemap = true;
+            i += 1;
+            continue;
+        }
+        if (arg === '-o' || arg === '--output') {
+            const value = argv[i + 1];
+            if (value === undefined)
+                throw new ArgError(`Missing value for ${arg}`);
+            result.output = value;
+            i += 2;
+            continue;
+        }
+        if (arg.startsWith('--output=')) {
+            result.output = arg.slice('--output='.length);
+            i += 1;
+            continue;
+        }
+        if (arg === '-p' || arg === '--project') {
+            const value = argv[i + 1];
+            if (value === undefined)
+                throw new ArgError(`Missing value for ${arg}`);
+            result.project = value;
+            i += 2;
+            continue;
+        }
+        if (arg.startsWith('--project=')) {
+            result.project = arg.slice('--project='.length);
+            i += 1;
+            continue;
+        }
+        if (arg === '--mode') {
+            const value = argv[i + 1];
+            if (value === undefined)
+                throw new ArgError('Missing value for --mode');
+            if (value !== 'rbxts' && value !== 'native') {
+                throw new ArgError(`Invalid --mode value: ${value} (expected rbxts or native)`);
+            }
+            result.mode = value;
+            i += 2;
+            continue;
+        }
+        if (arg.startsWith('--mode=')) {
+            const value = arg.slice('--mode='.length);
+            if (value !== 'rbxts' && value !== 'native') {
+                throw new ArgError(`Invalid --mode value: ${value} (expected rbxts or native)`);
+            }
+            result.mode = value;
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith('-')) {
+            throw new ArgError(`Unknown flag: ${arg}`);
+        }
+        positional.push(arg);
+        i += 1;
+    }
+    if (positional.length > 1) {
+        throw new ArgError(`Too many positional arguments (expected 0 or 1, got ${positional.length}). `
+            + `Use -o for the output target.`);
+    }
+    if (positional.length === 1)
+        result.input = positional[0];
+    if (result.input && result.project) {
+        throw new ArgError('Cannot use a positional input and -p / --project together.');
+    }
+    return result;
+}
+export const HELP_TEXT = `luau2ts — A Luau-to-TypeScript compiler for Roblox.
+
+Usage:
+  luau2ts <file.luau>                    Compile one file. Writes to stdout.
+  luau2ts <file.luau> -o <file.ts>       Compile one file. Writes to a file.
+  luau2ts <dir/> -o <out/>               Compile every .luau/.lua under <dir/>.
+                                          Mirrors the input tree into <out/>.
+  luau2ts -p <default.project.json> -o <out/>
+                                          Walk a Rojo project file, compile
+                                          every script it references, and
+                                          emit a roblox-ts-shaped tree.
+
+Flags:
+  -o, --output <path>     Output file or directory. Default: stdout for
+                          single-file input; required for dir/project.
+  -p, --project <path>    Path to a Rojo *.project.json file, or a directory
+                          containing default.project.json.
+      --mode <name>       Emit compatibility mode. One of:
+                            rbxts   (default) — emits TS that imports from
+                                                @rbxts/types, @rbxts/services,
+                                                etc. Pairs with roblox-ts.
+                            native           — emits TS that imports stdlib
+                                                helpers from 'luau2ts/runtime'.
+                                                Pairs with a host runtime that
+                                                provides Roblox's Luau API.
+      --sourcemap         Emit a .ts.map next to each .ts.
+  -h, --help              Show this help text.
+  -v, --version           Print the installed luau2ts version.
+`;
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"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"}

package/dist/cli/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/cli/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":""}

package/dist/cli/bin.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+import { stat } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import process from 'node:process';
+import pkgJson from '../../package.json' with { type: 'json' };
+import { ArgError, HELP_TEXT, parseArgs } from './args.js';
+import { compileDirMode, compileFileMode, compileProjectMode, } from './modes.js';
+async function main() {
+    let args;
+    try {
+        args = parseArgs(process.argv.slice(2));
+    }
+    catch (err) {
+        if (err instanceof ArgError) {
+            process.stderr.write(`luau2ts: ${err.message}\n`);
+            process.stderr.write(`Run \`luau2ts --help\` for usage.\n`);
+            return 2;
+        }
+        throw err;
+    }
+    if (args.help) {
+        process.stdout.write(HELP_TEXT);
+        return 0;
+    }
+    if (args.version) {
+        const version = pkgJson.version;
+        process.stdout.write(`luau2ts ${version}\n`);
+        return 0;
+    }
+    const opts = { mode: args.mode, sourcemap: args.sourcemap };
+    if (args.project !== undefined) {
+        if (!args.output) {
+            process.stderr.write(`luau2ts: -p/--project requires -o/--output\n`);
+            return 2;
+        }
+        return compileProjectMode(args.project, args.output, opts);
+    }
+    if (args.input === undefined) {
+        process.stdout.write(HELP_TEXT);
+        return 0;
+    }
+    const inputAbs = resolve(args.input);
+    let inputStat;
+    try {
+        inputStat = await stat(inputAbs);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`luau2ts: cannot read ${args.input}: ${msg}\n`);
+        return 1;
+    }
+    if (inputStat.isDirectory()) {
+        if (!args.output) {
+            process.stderr.write(`luau2ts: directory input requires -o/--output\n`);
+            return 2;
+        }
+        return compileDirMode(args.input, args.output, opts);
+    }
+    return compileFileMode(args.input, args.output, opts);
+}
+main().then((code) => process.exit(code), (err) => {
+    process.stderr.write(`luau2ts: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/cli/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":"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"}

package/dist/cli/modes.d.ts

@@ -0,0 +1,17 @@
+import { extname } from 'node:path';
+import type { CompatMode } from '../compile/context.js';
+export interface ModeOptions {
+    mode: CompatMode;
+    sourcemap: boolean;
+}
+/** Single-file mode. If `outputArg` is undefined, writes to stdout. */
+export declare function compileFileMode(inputArg: string, outputArg: string | undefined, opts: ModeOptions): Promise<number>;
+/** Directory mode. Walks every `.luau`/`.lua` under `inputDir` and writes
+ *  a mirrored tree under `outputDir`. */
+export declare function compileDirMode(inputArg: string, outputArg: string, opts: ModeOptions): Promise<number>;
+/** Rojo project mode. Walks `default.project.json` (or the given file)
+ *  and emits one `.ts` per discovered Luau script, mirroring the project's
+ *  on-disk layout under `outputDir`. */
+export declare function compileProjectMode(projectArg: string, outputArg: string, opts: ModeOptions): Promise<number>;
+export { extname };
+//# sourceMappingURL=modes.d.ts.map

package/dist/cli/modes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modes.d.ts","sourceRoot":"","sources":["../../src/cli/modes.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,OAAO,EAA2B,MAAM,WAAW,CAAC;AAIhF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AA6DD,uEAAuE;AACvE,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED;yCACyC;AACzC,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAkBD;;wCAEwC;AACxC,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAID,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/cli/modes.js

@@ -0,0 +1,134 @@
+import { mkdir, readdir, readFile, stat, writeFile } from 'node:fs/promises';
+import { basename, dirname, extname, join, relative, resolve } from 'node:path';
+import { compile } from '../compile/index.js';
+import { loadProject } from '../rojo/index.js';
+import { classifyFile } from '../rojo/walk-tree.js';
+function compileOptionsFor(sourceFile, opts) {
+    const out = {
+        sourceFile,
+        compatMode: opts.mode,
+    };
+    if (opts.sourcemap)
+        out.sourceMap = true;
+    return out;
+}
+function reportErrors(filePath, result) {
+    if (result.errors.length === 0)
+        return false;
+    for (const err of result.errors) {
+        const line = err.line ?? 0;
+        const col = err.col ?? 0;
+        const msg = err.message ?? String(err);
+        process.stderr.write(`${filePath}:${line}:${col}: ${msg}\n`);
+    }
+    return true;
+}
+async function writeCompiled(outPath, result, sourcemap) {
+    await mkdir(dirname(outPath), { recursive: true });
+    let source = result.source;
+    if (sourcemap && result.sourceMap) {
+        const mapPath = `${outPath}.map`;
+        await writeFile(mapPath, JSON.stringify(result.sourceMap), 'utf8');
+        source += `//# sourceMappingURL=${basename(mapPath)}\n`;
+    }
+    await writeFile(outPath, source, 'utf8');
+}
+/** Translate a .luau source filename to its .ts counterpart, preserving
+ *  Rojo-style `.server` / `.client` suffixes so the output still maps to
+ *  the original instance kind. */
+function tsCounterpart(filename) {
+    const lower = filename.toLowerCase();
+    const replacements = [
+        { from: '.server.luau', to: '.server.ts' },
+        { from: '.server.lua', to: '.server.ts' },
+        { from: '.client.luau', to: '.client.ts' },
+        { from: '.client.lua', to: '.client.ts' },
+        { from: '.luau', to: '.ts' },
+        { from: '.lua', to: '.ts' },
+    ];
+    for (const { from, to } of replacements) {
+        if (lower.endsWith(from)) {
+            return filename.slice(0, filename.length - from.length) + to;
+        }
+    }
+    return filename;
+}
+/** Single-file mode. If `outputArg` is undefined, writes to stdout. */
+export async function compileFileMode(inputArg, outputArg, opts) {
+    const abs = resolve(inputArg);
+    const source = await readFile(abs, 'utf8');
+    const result = await compile(source, compileOptionsFor(abs, opts));
+    const hadErrors = reportErrors(abs, result);
+    if (outputArg === undefined || outputArg === '-') {
+        process.stdout.write(result.source);
+        if (opts.sourcemap && result.sourceMap) {
+            process.stderr.write(`[luau2ts] --sourcemap with stdout is a no-op; pass -o to emit a .ts.map.\n`);
+        }
+    }
+    else {
+        await writeCompiled(resolve(outputArg), result, opts.sourcemap);
+    }
+    return hadErrors ? 1 : 0;
+}
+/** Directory mode. Walks every `.luau`/`.lua` under `inputDir` and writes
+ *  a mirrored tree under `outputDir`. */
+export async function compileDirMode(inputArg, outputArg, opts) {
+    const inputRoot = resolve(inputArg);
+    const outputRoot = resolve(outputArg);
+    const inputStat = await stat(inputRoot);
+    if (!inputStat.isDirectory()) {
+        throw new Error(`Not a directory: ${inputArg}`);
+    }
+    let anyErrors = false;
+    let compiledCount = 0;
+    await walkDir(inputRoot, async (filePath) => {
+        if (!classifyFile(basename(filePath)))
+            return;
+        const source = await readFile(filePath, 'utf8');
+        const result = await compile(source, compileOptionsFor(filePath, opts));
+        if (reportErrors(filePath, result))
+            anyErrors = true;
+        const rel = relative(inputRoot, filePath);
+        const outRel = join(dirname(rel), tsCounterpart(basename(rel)));
+        await writeCompiled(join(outputRoot, outRel), result, opts.sourcemap);
+        compiledCount += 1;
+    });
+    process.stderr.write(`[luau2ts] compiled ${compiledCount} file(s) into ${outputRoot}\n`);
+    return anyErrors ? 1 : 0;
+}
+async function walkDir(dir, visit) {
+    const entries = await readdir(dir);
+    for (const entry of entries.sort()) {
+        const full = join(dir, entry);
+        const st = await stat(full);
+        if (st.isDirectory()) {
+            await walkDir(full, visit);
+        }
+        else if (st.isFile()) {
+            await visit(full);
+        }
+    }
+}
+/** Rojo project mode. Walks `default.project.json` (or the given file)
+ *  and emits one `.ts` per discovered Luau script, mirroring the project's
+ *  on-disk layout under `outputDir`. */
+export async function compileProjectMode(projectArg, outputArg, opts) {
+    const project = await loadProject(projectArg);
+    const outputRoot = resolve(outputArg);
+    const projectDir = dirname(project.projectFile);
+    let anyErrors = false;
+    for (const entry of project.scripts) {
+        const result = await compile(entry.source, compileOptionsFor(entry.filePath, opts));
+        if (reportErrors(entry.filePath, result))
+            anyErrors = true;
+        const rel = relative(projectDir, entry.filePath);
+        const outRel = join(dirname(rel), tsCounterpart(basename(rel)));
+        await writeCompiled(join(outputRoot, outRel), result, opts.sourcemap);
+    }
+    process.stderr.write(`[luau2ts] compiled ${project.scripts.length} script(s) from ${project.name} into ${outputRoot}\n`);
+    return anyErrors ? 1 : 0;
+}
+// Surface extname so the v8 minifier doesn't drop it as unused; we keep
+// the import explicit since it's used by tests of this module externally.
+export { extname };
+//# sourceMappingURL=modes.js.map

package/dist/cli/modes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modes.js","sourceRoot":"","sources":["../../src/cli/modes.ts"],"names":[],"mappings":"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"}

package/dist/compile/class-shape.d.ts

@@ -0,0 +1,31 @@
+import ts from 'typescript';
+import type { Expr, FunctionStat, Stat } from '../parser/index.js';
+import type { CompileContext } from './context.js';
+/** A detected class definition. The compiler will emit a single
+ *  `ts.ClassDeclaration` covering every statement in `consumed`; the
+ *  caller skips those statements when building its own output. */
+export interface ClassPattern {
+    /** Class name. */
+    name: string;
+    /** Optional superclass identifier (from the metatable's `__index`). */
+    superclass: string | null;
+    /** Indexes (within the parent block's body) of every statement that
+     *  contributes to the class — declaration, __index, .new factory,
+     *  :constructor, and every :method. The block compiler skips these. */
+    consumed: Set<number>;
+    /** The .new factory statement (only used to harvest the constructor
+     *  body if `:constructor` is missing). */
+    ctorFactory: FunctionStat | null;
+    /** The :constructor method statement, if any. */
+    constructor: FunctionStat | null;
+    /** All :method statements, in source order. */
+    methods: FunctionStat[];
+}
+/** Walk a flat list of statements and detect class patterns. Returns the
+ *  detected classes plus the union of consumed indexes (so callers can
+ *  skip them in the regular pipeline). */
+export declare function detectClasses(stmts: Stat[]): ClassPattern[];
+/** Compile a detected class pattern into a TS `class` declaration. The
+ *  returned node replaces the consumed statements in the output. */
+export declare function compileClassPattern(pattern: ClassPattern, ctx: CompileContext, compileBlockBody: (body: Stat, ctx: CompileContext) => ts.Statement[], compileExpr: (expr: Expr, ctx: CompileContext) => ts.Expression): ts.ClassDeclaration;
+//# sourceMappingURL=class-shape.d.ts.map

package/dist/compile/class-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-shape.d.ts","sourceRoot":"","sources":["../../src/compile/class-shape.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAEV,IAAI,EACJ,YAAY,EAEZ,IAAI,EACL,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAInD;;kEAEkE;AAClE,MAAM,WAAW,YAAY;IAC3B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;2EAEuE;IACvE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB;8CAC0C;IAC1C,WAAW,EAAE,YAAY,GAAG,IAAI,CAAC;IACjC,iDAAiD;IACjD,WAAW,EAAE,YAAY,GAAG,IAAI,CAAC;IACjC,+CAA+C;IAC/C,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;0CAE0C;AAC1C,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAmD3D;AAkED;oEACoE;AACpE,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,cAAc,EACnB,gBAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,cAAc,KAAK,EAAE,CAAC,SAAS,EAAE,EACrE,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,cAAc,KAAK,EAAE,CAAC,UAAU,GAC9D,EAAE,CAAC,gBAAgB,CAmErB"}