luau2ts 0.2.2 → 0.2.3

package/dist/rojo/walk-tree.d.ts

@@ -0,0 +1,40 @@
+import type { LuauScriptEntry, RojoProjectNode, ScriptKind } from './types.js';
+/** Classify a single filename by its Rojo-style suffix.
+ *
+ *  Returns:
+ *  - `{ kind, baseName, isInit }` for recognised script files
+ *  - `null` for anything we don't translate (json, csv, txt, unknown).
+ *
+ *  Suffix grammar (Rojo 7+ convention):
+ *  - `init.luau` / `init.lua`               → ModuleScript (folder collapses)
+ *  - `init.server.luau` / `init.server.lua` → Script
+ *  - `init.client.luau` / `init.client.lua` → LocalScript
+ *  - `<name>.luau` / `<name>.lua`           → ModuleScript named <name>
+ *  - `<name>.server.luau` / `<name>.server.lua` → Script named <name>
+ *  - `<name>.client.luau` / `<name>.client.lua` → LocalScript named <name>
+ *
+ *  Order matters: `foo.server.luau` must match `.server.luau` before
+ *  `.luau` so we check the longer suffix first.
+ */
+export declare function classifyFile(filename: string): {
+    kind: ScriptKind;
+    baseName: string;
+    isInit: boolean;
+} | null;
+/** Walk a single Rojo tree node, accumulating script entries.
+ *
+ *  - If the node has a `$path` pointing to a `.luau`/`.lua` file, record a
+ *    single script entry at the current instance path.
+ *  - If `$path` points to a directory, walk it: subdirectories nest as
+ *    Folder instances; files become scripts; `init.*` files collapse the
+ *    containing folder into a script of the matching kind.
+ *  - If the node has children (keys that don't start with `$`), recurse
+ *    into each child with its key as the next path component.
+ */
+export declare function walkNode(node: RojoProjectNode, instancePath: string[], projectDir: string, out: LuauScriptEntry[]): Promise<void>;
+/** Resolve the project file path: accept either a direct path to a
+ *  `*.project.json` file or a directory containing `default.project.json`. */
+export declare function resolveProjectFile(arg: string): Promise<string>;
+export declare function projectDirOf(projectFile: string): string;
+export declare function defaultProjectName(projectFile: string): string;
+//# sourceMappingURL=walk-tree.d.ts.map

package/dist/rojo/walk-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-tree.d.ts","sourceRoot":"","sources":["../../src/rojo/walk-tree.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC9C,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,IAAI,CAkBP;AAUD;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,eAAe,EACrB,YAAY,EAAE,MAAM,EAAE,EACtB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,eAAe,EAAE,GACrB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAwED;8EAC8E;AAC9E,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMrE;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAY9D"}

package/dist/rojo/walk-tree.js

@@ -0,0 +1,164 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { basename, dirname, extname, join, resolve } from 'node:path';
+/** Classify a single filename by its Rojo-style suffix.
+ *
+ *  Returns:
+ *  - `{ kind, baseName, isInit }` for recognised script files
+ *  - `null` for anything we don't translate (json, csv, txt, unknown).
+ *
+ *  Suffix grammar (Rojo 7+ convention):
+ *  - `init.luau` / `init.lua`               → ModuleScript (folder collapses)
+ *  - `init.server.luau` / `init.server.lua` → Script
+ *  - `init.client.luau` / `init.client.lua` → LocalScript
+ *  - `<name>.luau` / `<name>.lua`           → ModuleScript named <name>
+ *  - `<name>.server.luau` / `<name>.server.lua` → Script named <name>
+ *  - `<name>.client.luau` / `<name>.client.lua` → LocalScript named <name>
+ *
+ *  Order matters: `foo.server.luau` must match `.server.luau` before
+ *  `.luau` so we check the longer suffix first.
+ */
+export function classifyFile(filename) {
+    const lower = filename.toLowerCase();
+    const suffixes = [
+        { tail: '.server.luau', kind: 'Script' },
+        { tail: '.server.lua', kind: 'Script' },
+        { tail: '.client.luau', kind: 'LocalScript' },
+        { tail: '.client.lua', kind: 'LocalScript' },
+        { tail: '.luau', kind: 'ModuleScript' },
+        { tail: '.lua', kind: 'ModuleScript' },
+    ];
+    for (const { tail, kind } of suffixes) {
+        if (lower.endsWith(tail)) {
+            const baseName = filename.slice(0, filename.length - tail.length);
+            const isInit = baseName === 'init';
+            return { kind, baseName, isInit };
+        }
+    }
+    return null;
+}
+/** `$className` strings Rojo uses for explicit script-class assignment.
+ *  A node's `$className` overrides the kind inferred from its `$path`. */
+const SCRIPT_CLASS_NAMES = {
+    ModuleScript: 'ModuleScript',
+    Script: 'Script',
+    LocalScript: 'LocalScript',
+};
+/** Walk a single Rojo tree node, accumulating script entries.
+ *
+ *  - If the node has a `$path` pointing to a `.luau`/`.lua` file, record a
+ *    single script entry at the current instance path.
+ *  - If `$path` points to a directory, walk it: subdirectories nest as
+ *    Folder instances; files become scripts; `init.*` files collapse the
+ *    containing folder into a script of the matching kind.
+ *  - If the node has children (keys that don't start with `$`), recurse
+ *    into each child with its key as the next path component.
+ */
+export async function walkNode(node, instancePath, projectDir, out) {
+    if (node.$path !== undefined) {
+        const abs = resolve(projectDir, node.$path);
+        await walkPath(abs, instancePath, node.$className, out);
+    }
+    // Recurse into named children (anything not starting with `$`).
+    // Sort keys for deterministic output across filesystems / platforms.
+    const childKeys = Object.keys(node)
+        .filter((k) => !k.startsWith('$'))
+        .sort();
+    for (const childName of childKeys) {
+        const childNode = node[childName];
+        if (typeof childNode !== 'object' || childNode === null)
+            continue;
+        await walkNode(childNode, [...instancePath, childName], projectDir, out);
+    }
+}
+/** Walk a filesystem entry pointed at by a `$path`. */
+async function walkPath(absPath, instancePath, explicitClassName, out) {
+    let st;
+    try {
+        st = await stat(absPath);
+    }
+    catch {
+        // Missing $path is a Rojo project error, but we tolerate it here so a
+        // partial project still yields the scripts it does have. The CLI can
+        // surface a warning to the user.
+        return;
+    }
+    if (st.isFile()) {
+        const cls = classifyFile(basename(absPath));
+        if (!cls)
+            return;
+        const kind = (explicitClassName && SCRIPT_CLASS_NAMES[explicitClassName])
+            || cls.kind;
+        const source = await readFile(absPath, 'utf8');
+        out.push({ instancePath, scriptKind: kind, filePath: absPath, source });
+        return;
+    }
+    if (!st.isDirectory())
+        return;
+    // Directory: scan for init.* first to decide whether the directory
+    // itself collapses into a script, then recurse into children.
+    const entries = (await readdir(absPath)).sort();
+    let initKind = null;
+    let initFile = null;
+    for (const entry of entries) {
+        const cls = classifyFile(entry);
+        if (cls && cls.isInit) {
+            initKind = cls.kind;
+            initFile = join(absPath, entry);
+            break;
+        }
+    }
+    if (initFile) {
+        const kind = (explicitClassName && SCRIPT_CLASS_NAMES[explicitClassName])
+            || initKind;
+        const source = await readFile(initFile, 'utf8');
+        out.push({ instancePath, scriptKind: kind, filePath: initFile, source });
+    }
+    for (const entry of entries) {
+        const entryPath = join(absPath, entry);
+        const entryStat = await stat(entryPath);
+        if (entryStat.isDirectory()) {
+            await walkPath(entryPath, [...instancePath, entry], undefined, out);
+            continue;
+        }
+        if (!entryStat.isFile())
+            continue;
+        const cls = classifyFile(entry);
+        if (!cls || cls.isInit)
+            continue;
+        const source = await readFile(entryPath, 'utf8');
+        out.push({
+            instancePath: [...instancePath, cls.baseName],
+            scriptKind: cls.kind,
+            filePath: entryPath,
+            source,
+        });
+    }
+}
+/** Resolve the project file path: accept either a direct path to a
+ *  `*.project.json` file or a directory containing `default.project.json`. */
+export async function resolveProjectFile(arg) {
+    const abs = resolve(arg);
+    const st = await stat(abs);
+    if (st.isFile())
+        return abs;
+    if (st.isDirectory())
+        return join(abs, 'default.project.json');
+    throw new Error(`Project path is neither file nor directory: ${arg}`);
+}
+export function projectDirOf(projectFile) {
+    return dirname(projectFile);
+}
+export function defaultProjectName(projectFile) {
+    const base = basename(projectFile);
+    // Strip `.project.json` to derive a stable project name.
+    const ext = extname(base);
+    if (ext === '.json') {
+        const withoutJson = base.slice(0, -ext.length);
+        if (withoutJson.endsWith('.project')) {
+            return withoutJson.slice(0, -'.project'.length) || 'project';
+        }
+        return withoutJson;
+    }
+    return base;
+}
+//# sourceMappingURL=walk-tree.js.map

package/dist/rojo/walk-tree.js.map

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

package/dist/runtime/arith.d.ts

@@ -0,0 +1,13 @@
+export declare function luaAdd(a: unknown, b: unknown): number | unknown;
+export declare function luaSub(a: unknown, b: unknown): number | unknown;
+export declare function luaMul(a: unknown, b: unknown): number | unknown;
+export declare function luaDiv(a: unknown, b: unknown): number | unknown;
+export declare function luaIdiv(a: unknown, b: unknown): number | unknown;
+export declare function luaMod(a: unknown, b: unknown): number | unknown;
+export declare function luaPow(a: unknown, b: unknown): number | unknown;
+export declare function luaUnm(a: unknown): number | unknown;
+export declare function luaConcat(a: unknown, b: unknown): string | unknown;
+export declare function luaEq(a: unknown, b: unknown): boolean;
+export declare function luaLt(a: unknown, b: unknown): boolean;
+export declare function luaLe(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=arith.d.ts.map

package/dist/runtime/arith.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arith.d.ts","sourceRoot":"","sources":["../../src/runtime/arith.ts"],"names":[],"mappings":"AAyFA,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAE/D;AACD,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAE/D;AACD,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAE/D;AACD,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAE/D;AACD,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAEhE;AACD,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAG/D;AACD,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAE/D;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAOnD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAIlE;AAID,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAerD;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAMrD;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAWrD"}

package/dist/runtime/arith.js

@@ -0,0 +1,151 @@
+import { error, LuaError } from './pcall.js';
+import { getMetamethod } from './metatable.js';
+function toNumber(v) {
+    if (typeof v === 'number')
+        return v;
+    if (typeof v === 'string') {
+        const n = Number(v);
+        return Number.isNaN(n) ? undefined : n;
+    }
+    return undefined;
+}
+// Operations that are commutative — for these we try the second operand
+// as the receiver if the first doesn't provide the fluent method. Lets
+// `2 * vec3` route to `vec3.mul(2)`.
+const COMMUTATIVE = {
+    __add: true,
+    __mul: true,
+    __eq: true,
+};
+function callBinMetamethod(meta, opLabel, a, b) {
+    // First try a direct fluent method (.add/.sub/.mul/.div etc.) on either
+    // operand — this is what Roblox's Vector3 / CFrame / Color3 expose.
+    // For commutative ops we also try b's method if a doesn't have one.
+    const fluent = FLUENT_METHOD[meta];
+    if (fluent) {
+        const fluentA = a?.[fluent];
+        if (typeof fluentA === 'function') {
+            return fluentA.call(a, b);
+        }
+        if (COMMUTATIVE[meta]) {
+            const fluentB = b?.[fluent];
+            if (typeof fluentB === 'function') {
+                return fluentB.call(b, a);
+            }
+        }
+    }
+    const mm = getMetamethod(a, meta) ?? getMetamethod(b, meta);
+    if (typeof mm === 'function') {
+        return mm(a, b);
+    }
+    // One operand is null/undefined — common in real places where a
+    // FindFirstChild lookup didn't resolve. Logging once and returning the
+    // other operand keeps the script alive instead of taking down the page
+    // on what was probably a missing-instance issue elsewhere.
+    if (a == null || b == null) {
+        return a ?? b ?? 0;
+    }
+    return error(`attempt to perform arithmetic (${opLabel}) on incompatible values`);
+}
+const FLUENT_METHOD = {
+    __add: 'add',
+    __sub: 'sub',
+    __mul: 'mul',
+    __div: 'div',
+    __concat: 'concat',
+    __eq: 'eq',
+    __lt: 'lt',
+    __le: 'le',
+};
+function binNumeric(meta, opLabel, a, b, fn) {
+    const an = toNumber(a);
+    const bn = toNumber(b);
+    if (an !== undefined && bn !== undefined)
+        return fn(an, bn);
+    return callBinMetamethod(meta, opLabel, a, b);
+}
+export function luaAdd(a, b) {
+    return binNumeric('__add', 'add', a, b, (x, y) => x + y);
+}
+export function luaSub(a, b) {
+    return binNumeric('__sub', 'sub', a, b, (x, y) => x - y);
+}
+export function luaMul(a, b) {
+    return binNumeric('__mul', 'mul', a, b, (x, y) => x * y);
+}
+export function luaDiv(a, b) {
+    return binNumeric('__div', 'div', a, b, (x, y) => x / y);
+}
+export function luaIdiv(a, b) {
+    return binNumeric('__idiv', 'idiv', a, b, (x, y) => Math.floor(x / y));
+}
+export function luaMod(a, b) {
+    // Lua's % is floor modulo: ((a % b) + b) % b. JS's % is truncated.
+    return binNumeric('__mod', 'mod', a, b, (x, y) => x - Math.floor(x / y) * y);
+}
+export function luaPow(a, b) {
+    return binNumeric('__pow', 'pow', a, b, (x, y) => x ** y);
+}
+export function luaUnm(a) {
+    if (typeof a === 'number')
+        return -a;
+    const an = toNumber(a);
+    if (an !== undefined)
+        return -an;
+    const mm = getMetamethod(a, '__unm');
+    if (typeof mm === 'function')
+        return mm(a);
+    return error('attempt to perform arithmetic (unm) on incompatible value');
+}
+export function luaConcat(a, b) {
+    const ok = (v) => typeof v === 'string' || typeof v === 'number';
+    if (ok(a) && ok(b))
+        return `${a}${b}`;
+    return callBinMetamethod('__concat', 'concat', a, b);
+}
+// ─── Comparison helpers ─────────────────────────────────────────────────────
+export function luaEq(a, b) {
+    if (a === b)
+        return true;
+    // Lua maps JS null and undefined to nil; nil == nil is true, but JS
+    // `null === undefined` is false. Without this, a `FindFirstChild` result
+    // (null on miss) compared to `nil` via `x == nil` reads false, leaving
+    // scripts to dereference the miss.
+    if (a == null && b == null)
+        return true;
+    if (Number.isNaN(a) || Number.isNaN(b))
+        return false;
+    // Lua only consults __eq when types match and both are tables/userdata.
+    const sameType = typeof a === typeof b && a !== null && b !== null && typeof a === 'object';
+    if (sameType) {
+        const mm = getMetamethod(a, '__eq') ?? getMetamethod(b, '__eq');
+        if (typeof mm === 'function')
+            return Boolean(mm(a, b));
+    }
+    return false;
+}
+export function luaLt(a, b) {
+    if (typeof a === 'number' && typeof b === 'number')
+        return a < b;
+    if (typeof a === 'string' && typeof b === 'string')
+        return a < b;
+    const mm = getMetamethod(a, '__lt') ?? getMetamethod(b, '__lt');
+    if (typeof mm === 'function')
+        return Boolean(mm(a, b));
+    throw new LuaError('attempt to compare incompatible values');
+}
+export function luaLe(a, b) {
+    if (typeof a === 'number' && typeof b === 'number')
+        return a <= b;
+    if (typeof a === 'string' && typeof b === 'string')
+        return a <= b;
+    const mmLe = getMetamethod(a, '__le') ?? getMetamethod(b, '__le');
+    if (typeof mmLe === 'function')
+        return Boolean(mmLe(a, b));
+    // Fall back to !(b < a) with __lt
+    const mmLt = getMetamethod(a, '__lt') ?? getMetamethod(b, '__lt');
+    if (typeof mmLt === 'function')
+        return !Boolean(mmLt(b, a));
+    throw new LuaError('attempt to compare incompatible values');
+}
+//# sourceMappingURL=arith.js.map

package/dist/runtime/arith.js.map

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

package/dist/runtime/index-helper.d.ts

@@ -0,0 +1,3 @@
+export declare function luaIndex<T = unknown>(t: unknown, k: unknown): T;
+export declare function luaIndexSet(t: unknown, k: unknown, v: unknown): unknown;
+//# sourceMappingURL=index-helper.d.ts.map

package/dist/runtime/index-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-helper.d.ts","sourceRoot":"","sources":["../../src/runtime/index-helper.ts"],"names":[],"mappings":"AAkBA,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,CAAC,CAM/D;AAKD,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAQvE"}

package/dist/runtime/index-helper.js

@@ -0,0 +1,40 @@
+// luaIndex(t, k) — table[k] lookup with Lua-correct array indexing.
+//
+// Lua tables are 1-indexed; JS arrays are 0-indexed. The luau-to-ts
+// compiler used to emit an inline conditional that subtracted 1 from
+// every runtime numeric key:
+//
+//   t[(typeof k === "number" ? k - 1 : k)]
+//
+// That's correct for Lua sequence-style tables compiled to JS arrays
+// (where Lua `arr[1]` should hit JS `arr[0]`), but it's catastrophically
+// wrong for dictionary-style tables keyed by large numeric values —
+// Roblox developer-product IDs (3582943767), asset IDs, gamepass IDs, etc.
+// `productCash[3582943767]` ends up as `productCash[3582943766]` → undefined.
+//
+// This helper picks the right behavior dynamically:
+//   • Plain JS array, numeric key in range → subtract 1 (sequence access)
+//   • Anything else → pass through (dictionary access, string keys, etc.)
+export function luaIndex(t, k) {
+    if (t === null || t === undefined)
+        return undefined;
+    if (typeof k === 'number' && Array.isArray(t)) {
+        return t[k - 1];
+    }
+    return t[k];
+}
+// Companion to luaIndex for the `t[k] = v` write position. Same arrays-vs-
+// dictionaries discrimination — only Lua sequences compiled to JS arrays
+// get the 1-index subtraction.
+export function luaIndexSet(t, k, v) {
+    if (t === null || t === undefined)
+        return v;
+    if (typeof k === 'number' && Array.isArray(t)) {
+        t[k - 1] = v;
+    }
+    else {
+        t[k] = v;
+    }
+    return v;
+}
+//# sourceMappingURL=index-helper.js.map

package/dist/runtime/index-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-helper.js","sourceRoot":"","sources":["../../src/runtime/index-helper.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,oEAAoE;AACpE,qEAAqE;AACrE,6BAA6B;AAC7B,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,qEAAqE;AACrE,yEAAyE;AACzE,oEAAoE;AACpE,2EAA2E;AAC3E,8EAA8E;AAC9E,EAAE;AACF,oDAAoD;AACpD,0EAA0E;AAC1E,0EAA0E;AAE1E,MAAM,UAAU,QAAQ,CAAc,CAAU,EAAE,CAAU;IAC1D,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,SAAc,CAAC;IACzD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,OAAQ,CAAe,CAAC,CAAC,GAAG,CAAC,CAAM,CAAC;IACtC,CAAC;IACD,OAAQ,CAAsC,CAAC,CAAoB,CAAM,CAAC;AAC5E,CAAC;AAED,2EAA2E;AAC3E,yEAAyE;AACzE,+BAA+B;AAC/B,MAAM,UAAU,WAAW,CAAC,CAAU,EAAE,CAAU,EAAE,CAAU;IAC5D,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,CAAe,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;SAAM,CAAC;QACL,CAAsC,CAAC,CAAoB,CAAC,GAAG,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,13 @@
+export * from './truthy.js';
+export * from './length.js';
+export * from './pcall.js';
+export * from './iterator.js';
+export * from './tostring.js';
+export * from './metatable.js';
+export * from './arith.js';
+export * from './table-lib.js';
+export * from './pattern.js';
+export * from './string-lib.js';
+export * from './lua-stdlib.js';
+export * from './index-helper.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,13 @@
+export * from './truthy.js';
+export * from './length.js';
+export * from './pcall.js';
+export * from './iterator.js';
+export * from './tostring.js';
+export * from './metatable.js';
+export * from './arith.js';
+export * from './table-lib.js';
+export * from './pattern.js';
+export * from './string-lib.js';
+export * from './lua-stdlib.js';
+export * from './index-helper.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/runtime/iterator.d.ts

@@ -0,0 +1,58 @@
+type KeyReifier = (rawKey: unknown) => unknown;
+export declare function registerKeyReifier(fn: KeyReifier): void;
+export type IpairsState<T> = readonly [
+    iterFn: (state: readonly T[], i: number) => [number, T] | undefined,
+    state: readonly T[],
+    initial: number
+];
+export type PairsState<T> = readonly [
+    iterFn: (state: T, prev: keyof T | null) => [keyof T, T[keyof T]] | undefined,
+    state: T,
+    initial: null
+];
+export declare function ipairs<T>(t: readonly T[] | null | undefined): IpairsState<T>;
+export declare function pairs<T extends object>(t: T | null | undefined): PairsState<T>;
+export declare function next<T extends object>(t: T | null | undefined, k?: keyof T | null): [keyof T, T[keyof T]] | undefined;
+/** Generic-for protocol adapter. Luau lets you write
+ *  `for k, v in expr do … end` where `expr` can be any of:
+ *    - an iterator triple `(iterFn, state, initialCtrl)` returned by
+ *      `pairs(t)` / `ipairs(t)` / custom iterator constructors,
+ *    - a callable that mimics the iterator function directly,
+ *    - a table with an `__iter` metamethod,
+ *    - a plain array (Luau extension — common in Roblox code like
+ *      `for _, x in CollectionService:GetTagged("Tag") do`),
+ *    - a plain dictionary (Luau extension; same as `pairs(t)`).
+ *
+ *  The compiler used to emit a raw `[__iter, __state, __ctrl] = expr`
+ *  destructure that only worked for the triple form. Arrays and bare
+ *  tables silently iterated zero times because the first element
+ *  wasn't a function. This adapter normalizes every shape to a real
+ *  triple. */
+export declare function genericIter(value: unknown): readonly [
+    (state: unknown, ctrl: unknown) => unknown,
+    unknown,
+    unknown
+];
+/** Multi-return adapter for `local a, b = f()` where `f` returns a single
+ *  value (not a tuple). Luau pads missing returns with nil; JS destructuring
+ *  on a non-iterable throws. Wrap the call result so destructuring works:
+ *  `[a, b] = multiret(f())` → `a = result`, `b = undefined` when `f` returns
+ *  a non-array, and stays a no-op when `f` already returns an array tuple. */
+export declare function multiret(v: unknown): unknown[];
+/** Drop-in replacement for `Object.keys(t)` for the compiler's inlined
+ *  `for k in pairs(t)` form. Returns the original Instance object as the
+ *  key when the table was indexed with one, via the global key reifier
+ *  a host Roblox runtime installs. Without this, Instance-keyed
+ *  Lua tables collapse on shared Name (two parts named "Handle" share
+ *  the same string key) AND iteration yields the string key, so
+ *  `part.CFrame = ...` fails with "Cannot create property on string".
+ *
+ *  Falls back to the raw string for primitive keys and for the slow
+ *  path before the runtime has loaded. */
+export declare function pairKeys(t: unknown): unknown[];
+/** Companion lookup: `t[k]` where k may be a reified Instance. We use
+ *  String(k) to recover the original property key. For numeric keys the
+ *  compiler emits `t[k-1]` directly, so we only handle the reified case. */
+export declare function pairValue(t: unknown, k: unknown): unknown;
+export {};
+//# sourceMappingURL=iterator.d.ts.map

package/dist/runtime/iterator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterator.d.ts","sourceRoot":"","sources":["../../src/runtime/iterator.ts"],"names":[],"mappings":"AAAA,KAAK,UAAU,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;AAG/C,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAEvD;AAkBD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,SAAS;IACpC,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS;IACnE,KAAK,EAAE,SAAS,CAAC,EAAE;IACnB,OAAO,EAAE,MAAM;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,SAAS;IACnC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS;IAC7E,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,CAE5E;AAWD,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAE9E;AAMD,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EACnC,CAAC,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EACvB,CAAC,GAAE,MAAM,CAAC,GAAG,IAAW,GACvB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAEnC;AA4CD;;;;;;;;;;;;;;cAcc;AACd,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS;IACpD,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO;IAC1C,OAAO;IACP,OAAO;CACR,CAmCA;AAMD;;;;8EAI8E;AAC9E,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAE9C;AAED;;;;;;;;;0CAS0C;AAC1C,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAe9C;AAED;;4EAE4E;AAC5E,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAOzD"}