luau2ts 0.2.2 → 0.2.3

package/dist/runtime/iterator.js

@@ -0,0 +1,181 @@
+const identityReifier = (k) => k;
+let keyReifier = identityReifier;
+export function registerKeyReifier(fn) {
+    keyReifier = fn;
+}
+// Side-channel: a host runtime (e.g. a Roblox runtime that supports
+// Instance-keyed tables) installs the reifier via globalThis on its own
+// load. Read it through getKeyReifier so the value is picked up the
+// moment a runtime registers, not at module load.
+const g = globalThis;
+function getKeyReifier() {
+    if (keyReifier === identityReifier && typeof g.__rbxKeyReifier === 'function') {
+        keyReifier = g.__rbxKeyReifier;
+    }
+    return keyReifier;
+}
+export function ipairs(t) {
+    return [ipairsIter, (t ?? []), 0];
+}
+function ipairsIter(state, i) {
+    if (state == null)
+        return undefined;
+    const next = i + 1;
+    // 1-indexed: state[next - 1] is Lua index `next`.
+    const value = state[next - 1];
+    if (value === undefined || value === null)
+        return undefined;
+    return [next, value];
+}
+export function pairs(t) {
+    return [pairsIter, (t ?? {}), null];
+}
+// Lua's `next(t, k)` — returns the key/value pair following `k` (or the first
+// pair when `k` is nil), or nil when there is no successor. The dominant idiom
+// in Lua libraries is `next(t) == nil` to test emptiness; we support both
+// shapes. Returned as a JS array so destructuring `[k, v] = next(t)` works.
+export function next(t, k = null) {
+    return pairsIter(t, k);
+}
+function pairsIter(state, prev) {
+    if (state == null)
+        return undefined;
+    // pairs() iterates every key — numeric AND string. JS arrays can carry
+    // string-keyed properties (Lua scripts that index a table with an
+    // Instance hit this path), so we have to consult Object.keys plus the
+    // numeric array length. Without the array slice, an `offsets[part] = X`
+    // pattern on an array-backed Lua table iterates zero times.
+    const keys = orderedRawPairKeys(state);
+    let idx = 0;
+    if (prev !== null) {
+        // For Instance-keyed tables, prev is the reified value (e.g. an
+        // Instance) but `keys` is the raw string list. Convert prev to its
+        // string form for comparison.
+        const prevStr = typeof prev === 'object' && prev !== null ? String(prev) : prev;
+        idx = keys.findIndex((k) => k === prevStr) + 1;
+    }
+    while (idx < keys.length) {
+        const rawKey = keys[idx];
+        const lookupKey = Array.isArray(state) && typeof rawKey === 'number' ? rawKey - 1 : rawKey;
+        const value = state[lookupKey];
+        if (value !== undefined && value !== null) {
+            return [getKeyReifier()(rawKey), value];
+        }
+        idx += 1;
+    }
+    return undefined;
+}
+function orderedRawPairKeys(state) {
+    const numericStringKeys = Object.keys(state)
+        .filter((k) => /^\d+$/.test(k))
+        .map((k) => Number(k))
+        .sort((a, b) => a - b);
+    const stringKeys = Object.keys(state).filter((k) => !/^\d+$/.test(k)).sort();
+    if (!Array.isArray(state))
+        return [...numericStringKeys, ...stringKeys];
+    const numericKeys = state.map((_, i) => i + 1);
+    return [...numericKeys, ...stringKeys];
+}
+/** 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 function genericIter(value) {
+    if (value == null) {
+        return [emptyIter, null, null];
+    }
+    if (typeof value === 'function') {
+        return [value, null, null];
+    }
+    if (Array.isArray(value)) {
+        const [maybeIter, maybeState, maybeCtrl] = value;
+        if (typeof maybeIter === 'function') {
+            // Already a triple: pairs(t) / ipairs(t) / custom iterator.
+            return [
+                maybeIter,
+                maybeState ?? null,
+                maybeCtrl ?? null,
+            ];
+        }
+        // Plain JS array. Iterate as ipairs would.
+        return [ipairsIter, value, 0];
+    }
+    if (typeof value === 'object') {
+        const obj = value;
+        if (typeof obj.__iter === 'function') {
+            const triple = obj.__iter();
+            if (Array.isArray(triple) && typeof triple[0] === 'function') {
+                return [
+                    triple[0],
+                    triple[1] ?? null,
+                    triple[2] ?? null,
+                ];
+            }
+        }
+        return [pairsIter, value, null];
+    }
+    return [emptyIter, null, null];
+}
+function emptyIter() {
+    return undefined;
+}
+/** 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 function multiret(v) {
+    return Array.isArray(v) ? v : [v];
+}
+/** 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 function pairKeys(t) {
+    if (t == null || typeof t !== 'object')
+        return [];
+    const reifier = getKeyReifier();
+    const out = [];
+    // Mixed arrays: include numeric indices first (Lua 1-based), then
+    // string-keyed properties. Array.isArray + Object.keys may overlap,
+    // so check the raw key for digit-only and emit the numeric form.
+    for (const k of orderedRawPairKeys(t)) {
+        if (typeof k === 'number') {
+            out.push(k);
+        }
+        else {
+            out.push(reifier(k));
+        }
+    }
+    return out;
+}
+/** 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 function pairValue(t, k) {
+    if (t == null || typeof t !== 'object')
+        return undefined;
+    const key = typeof k === 'object' && k !== null ? String(k) : k;
+    if (Array.isArray(t) && typeof key === 'number') {
+        return t[key - 1];
+    }
+    return t[key];
+}
+//# sourceMappingURL=iterator.js.map

package/dist/runtime/iterator.js.map

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

package/dist/runtime/length.d.ts

@@ -0,0 +1,2 @@
+export declare function lualen(value: unknown): number;
+//# sourceMappingURL=length.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"length.d.ts","sourceRoot":"","sources":["../../src/runtime/length.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAa7C"}

package/dist/runtime/length.js

@@ -0,0 +1,15 @@
+export function lualen(value) {
+    if (typeof value === 'string') {
+        return new TextEncoder().encode(value).length;
+    }
+    if (Array.isArray(value)) {
+        return value.length;
+    }
+    if (value && typeof value === 'object') {
+        // For string-keyed plain objects (used to represent string-keyed Lua
+        // tables), Lua's # returns 0. Same here.
+        return 0;
+    }
+    throw new TypeError(`attempt to get length of a ${typeof value} value`);
+}
+//# sourceMappingURL=length.js.map

package/dist/runtime/length.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"length.js","sourceRoot":"","sources":["../../src/runtime/length.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IAChD,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,qEAAqE;QACrE,yCAAyC;QACzC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,IAAI,SAAS,CAAC,8BAA8B,OAAO,KAAK,QAAQ,CAAC,CAAC;AAC1E,CAAC"}

package/dist/runtime/lua-stdlib.d.ts

@@ -0,0 +1,186 @@
+import { stringByte, stringChar, stringFind, stringFormat, stringGmatch, stringGsub, stringLen, stringLower, stringMatch, stringRep, stringReverse, stringSub, stringUpper } from './string-lib.js';
+import { tableClear, tableClone, tableConcat, tableFind, tableFreeze, tableInsert, tableIsFrozen, tableMaxn, tableMove, tablePack, tableRemove, tableSort, tableUnpack } from './table-lib.js';
+declare function stringSplit(s: string, sep?: string): string[];
+export declare const string: {
+    readonly byte: typeof stringByte;
+    readonly char: typeof stringChar;
+    readonly find: typeof stringFind;
+    readonly format: typeof stringFormat;
+    readonly gmatch: typeof stringGmatch;
+    readonly gsub: typeof stringGsub;
+    readonly len: typeof stringLen;
+    readonly lower: typeof stringLower;
+    readonly match: typeof stringMatch;
+    readonly rep: typeof stringRep;
+    readonly reverse: typeof stringReverse;
+    readonly sub: typeof stringSub;
+    readonly upper: typeof stringUpper;
+    readonly split: typeof stringSplit;
+    readonly pack: (..._args: unknown[]) => string;
+    readonly unpack: (..._args: unknown[]) => unknown[];
+    readonly packsize: (_fmt: string) => number;
+};
+export declare const table: {
+    readonly insert: typeof tableInsert;
+    readonly remove: typeof tableRemove;
+    readonly concat: typeof tableConcat;
+    readonly sort: typeof tableSort;
+    readonly unpack: typeof tableUnpack;
+    readonly pack: typeof tablePack;
+    readonly find: typeof tableFind;
+    readonly clear: typeof tableClear;
+    readonly clone: typeof tableClone;
+    readonly freeze: typeof tableFreeze;
+    readonly isfrozen: typeof tableIsFrozen;
+    readonly move: typeof tableMove;
+    readonly maxn: typeof tableMaxn;
+    readonly create: <T>(count: number, value?: T) => T[];
+    readonly foreach: <T>(t: Record<string, T>, fn: (k: string, v: T) => void) => void;
+    readonly foreachi: <T>(t: T[], fn: (i: number, v: T) => void) => void;
+    readonly getn: <T>(t: T[]) => number;
+};
+declare function _mathRandom(m?: number, n?: number): number;
+declare function _mathRandomSeed(seed?: number): void;
+export declare const math: {
+    readonly abs: (x: number) => number;
+    readonly acos: (x: number) => number;
+    readonly asin: (x: number) => number;
+    readonly atan: (x: number) => number;
+    readonly atan2: (y: number, x: number) => number;
+    readonly ceil: (x: number) => number;
+    readonly clamp: (x: number, lo: number, hi: number) => number;
+    readonly cos: (x: number) => number;
+    readonly cosh: (x: number) => number;
+    readonly deg: (x: number) => number;
+    readonly exp: (x: number) => number;
+    readonly floor: (x: number) => number;
+    readonly fmod: (x: number, y: number) => number;
+    readonly frexp: (x: number) => [number, number];
+    readonly huge: number;
+    readonly ldexp: (m: number, e: number) => number;
+    readonly log: (x: number, base?: number) => number;
+    readonly log10: (x: number) => number;
+    readonly max: (...values: number[]) => number;
+    readonly min: (...values: number[]) => number;
+    readonly modf: (x: number) => [number, number];
+    readonly noise: (x?: number, y?: number, z?: number) => number;
+    readonly pi: number;
+    readonly pow: (x: number, y: number) => number;
+    readonly rad: (x: number) => number;
+    readonly random: typeof _mathRandom;
+    readonly randomseed: typeof _mathRandomSeed;
+    readonly round: (x: number) => number;
+    readonly sign: (x: number) => number;
+    readonly sin: (x: number) => number;
+    readonly sinh: (x: number) => number;
+    readonly sqrt: (x: number) => number;
+    readonly tan: (x: number) => number;
+    readonly tanh: (x: number) => number;
+    readonly map: (x: number, inMin: number, inMax: number, outMin: number, outMax: number) => number;
+    readonly lerp: (a: number, b: number, t: number) => number;
+};
+declare function _osTime(t?: {
+    year?: number;
+    month?: number;
+    day?: number;
+    hour?: number;
+    min?: number;
+    sec?: number;
+}): number;
+declare function _osDate(format?: string, t?: number): string | Record<string, unknown>;
+export declare const os: {
+    readonly time: typeof _osTime;
+    readonly date: typeof _osDate;
+    readonly difftime: (t2: number, t1: number) => number;
+    readonly clock: () => number;
+    readonly getenv: (_name: string) => string | null;
+};
+export declare const bit32: {
+    readonly band: (...args: number[]) => number;
+    readonly bor: (...args: number[]) => number;
+    readonly bxor: (...args: number[]) => number;
+    readonly bnot: (x: number) => number;
+    readonly lshift: (x: number, n: number) => number;
+    readonly rshift: (x: number, n: number) => number;
+    readonly arshift: (x: number, n: number) => number;
+    readonly btest: (...args: number[]) => boolean;
+    readonly extract: (n: number, field: number, width?: number) => number;
+    readonly replace: (n: number, v: number, field: number, width?: number) => number;
+    readonly lrotate: (n: number, i: number) => number;
+    readonly rrotate: (n: number, i: number) => number;
+    readonly countlz: (n: number) => number;
+    readonly countrz: (n: number) => number;
+};
+export declare const utf8: {
+    readonly charpattern: "[\0-Â-ý][€-¿]*";
+    readonly char: (...codes: number[]) => string;
+    readonly codepoint: (s: string, i?: number, j?: number) => number[];
+    readonly codes: (s: string) => Generator<[number, number]>;
+    readonly len: (s: string, _i?: number, _j?: number) => number;
+    readonly offset: (_s: string, _n: number, _i?: number) => number | undefined;
+};
+export interface LuaBuffer {
+    __isLuaBuffer: true;
+    bytes: Uint8Array;
+    view: DataView;
+}
+export declare const buffer: {
+    readonly create: (size: number) => LuaBuffer;
+    readonly fromstring: (s: string) => LuaBuffer;
+    readonly tostring: (b: LuaBuffer) => string;
+    readonly len: (b: LuaBuffer) => number;
+    readonly copy: (dst: LuaBuffer, dstOff: number, src: LuaBuffer, srcOff?: number, count?: number) => void;
+    readonly fill: (b: LuaBuffer, off: number, value: number, count?: number) => void;
+    readonly readi8: (b: LuaBuffer, off: number) => number;
+    readonly readu8: (b: LuaBuffer, off: number) => number;
+    readonly readi16: (b: LuaBuffer, off: number) => number;
+    readonly readu16: (b: LuaBuffer, off: number) => number;
+    readonly readi32: (b: LuaBuffer, off: number) => number;
+    readonly readu32: (b: LuaBuffer, off: number) => number;
+    readonly readf32: (b: LuaBuffer, off: number) => number;
+    readonly readf64: (b: LuaBuffer, off: number) => number;
+    readonly writei8: (b: LuaBuffer, off: number, v: number) => void;
+    readonly writeu8: (b: LuaBuffer, off: number, v: number) => void;
+    readonly writei16: (b: LuaBuffer, off: number, v: number) => void;
+    readonly writeu16: (b: LuaBuffer, off: number, v: number) => void;
+    readonly writei32: (b: LuaBuffer, off: number, v: number) => void;
+    readonly writeu32: (b: LuaBuffer, off: number, v: number) => void;
+    readonly writef32: (b: LuaBuffer, off: number, v: number) => void;
+    readonly writef64: (b: LuaBuffer, off: number, v: number) => void;
+    readonly readstring: (b: LuaBuffer, off: number, count: number) => string;
+    readonly writestring: (b: LuaBuffer, off: number, s: string, count?: number) => void;
+};
+export declare const debug: {
+    readonly traceback: (message?: string, _level?: number) => string;
+    readonly getinfo: (_target: unknown, _what?: string) => Record<string, unknown>;
+    readonly profilebegin: (_label: string) => void;
+    readonly profileend: () => void;
+    readonly setmemorycategory: (_category: string) => void;
+    readonly resetmemorycategory: () => void;
+    readonly info: (..._args: unknown[]) => unknown[];
+};
+/** Lua's `type(v)` — returns the basic Lua type name (string/number/boolean/
+ *  function/table/nil/userdata/thread). */
+export declare function luaType(v: unknown): string;
+/** Roblox's `typeof(v)` — returns the Roblox-specific class name for
+ *  Vector3, CFrame, EnumItem, Instance, etc.; falls back to `type()` for
+ *  primitives. */
+export declare function luaTypeof(v: unknown): string;
+/** Lua's `select(i, ...)` — `select('#', ...)` returns count; `select(n, ...)`
+ *  returns `args[n], args[n+1], …`. */
+export declare function select(i: number | '#', ...args: unknown[]): unknown;
+/** Lua's `unpack(t, i, j)` — alias for `table.unpack`. */
+export declare function unpack<T>(t: T[], i?: number, j?: number): T[];
+/** Lua's `newproxy([metatable])` — creates an empty userdata with optional
+ *  metatable. We approximate with a frozen empty object whose metatable is
+ *  set via setmetatable elsewhere. The boolean variant adds a basic mt. */
+export declare function newproxy(addMetatable?: boolean): object;
+/** Roblox global tables — `_G` is shared between all scripts. */
+export declare const _G: Record<string, unknown>;
+/** Per-script environment — Luau scripts read it as themselves. We expose
+ *  the same shared object as `_G` since we don't model per-script envs. */
+export declare const _ENV: Record<string, unknown>;
+/** Lua version string. Roblox runs Luau, which forks 5.1; report that. */
+export declare const _VERSION = "Luau";
+export {};
+//# sourceMappingURL=lua-stdlib.d.ts.map

package/dist/runtime/lua-stdlib.d.ts.map

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