@tilua/compiler 7.0.0 → 8.0.0

package/README.md

@@ -74,9 +74,10 @@ JavaScript module the build loads.
 | `const` / `let` | `local` |
 | `class C { … }` | one table for the class, one per instance — see below |
 | `return [a, b]` | `return { a, b }` — several results are an array |
-| `for (const item in xs)` | `for _, item in xs do … end` — an array or a table walked for its values |
-| `for (const item in step)` | `for item in step do … end` — an iterator function |
-| `for (const [k, v] in pairs(t))` | `for item in unpack(pairs(t), 1, 3) do local k, v = item[1], item[2] … end` — an iteration is `[step, state, first]` |
+| `for (const item of xs)` | `for _, item in xs do … end` — an array or a table walked for its values |
+| `for (const item of step)` | `for item in step do … end` — an iterator function |
+| `for (const [k, v] of pairs(t))` | `for item in unpack(pairs(t), 1, 3) do local k, v = item[1], item[2] … end` — an iteration is `[step, state, first]` |
+| `for (const key in t)` | `for key in pairs(t) do … end` — a table's keys, as in TypeScript |
 | `t ??= v` | `if t == nil then t = v end` — what addresses `t` read once, into locals |
 | `{ m() { … } }` | `{ m = function(this) … end }` — called with `:` |
 | `break outer` from a loop inside `outer` | a flag `outer` declares, raised, and a `break`; after each loop on the way out, a check that breaks again — or, at `outer`, does the `break` or `continue` |
@@ -117,7 +118,7 @@ Luau without asking:
 | `a += b`, `a // b` | `a = a + (b)`, `math.floor(a / (b))` | as written |
 | `continue` | a `break` out of a one-pass `repeat` | as written |
 | `c ? a : b`, `a?.b`, `a ?? b` | `and`/`or` where neither arm can be `false`, else a function called on the spot | `if c then a else b` |
-| `for (const x in xs)` | `ipairs(xs)` where `xs` is an array by its type; otherwise `tilua_each(xs)`, which walks a table as Luau would — its `__iter` if it has one, `next` if not | `for _, x in xs do` |
+| `for (const x of xs)` | `ipairs(xs)` where `xs` is an array by its type; otherwise `tilua_each(xs)`, which walks a table as Luau would — its `__iter` if it has one, `next` if not | `for _, x in xs do` |
 | `1_000`, `0b101` | plain numbers | as written |
 | `@native` and other attributes | dropped | kept |
 | another file of the bundle | `loadfile` | `require` by path |
@@ -430,6 +431,17 @@ How a file is loaded depends on the Lua (see [Lua and Luau](#lua-and-luau)):
 Either way the files have to stay where they were written, relative to the
 entry's.
 
+<!-- compatibility:start -->
+## Compatibility
+
+`@tilua/compiler@8.0.0` works with these tilua packages. *Released with* is the
+version it was built and tested against.
+
+| Package | Range | Released with | |
+| --- | --- | --- | --- |
+| `@tilua/parser` | `^8.0.0` | 8.0.0 | dependency |
+<!-- compatibility:end -->
+
 ## Development
 
 ```bash

package/dist/{chunk-NM3EVX2J.js → chunk-TOP7NC3Z.js}

@@ -1448,8 +1448,15 @@ end`).body.statements, out);
           item = this.names.fresh("item");
           prelude.push(...this.destructure(variable, identifier(item), "declare"));
         }
-        const form = this.options.types?.loops.get(node) ?? { walks: "values", viaIter: false };
+        const form = this.options.types?.loops.get(node) ?? { walks: node.over === "keys" ? "keys" : "values", viaIter: false };
         let source = this.expression(node.iterator);
+        if (form.walks === "keys") {
+          return [genericFor(
+            [item],
+            [call(this.builtin("pairs"), [source])],
+            this.loopBody51(this.block(node.body, prelude)).statements
+          )];
+        }
         if (form.viaIter) source = methodCall(source, "__iter", []);
         const variables = form.walks === "values" ? [this.names.fresh("_"), item] : [item];
         let iterators = form.walks === "iteration" ? [call(this.helper("unpack"), [source, number(1), number(3)])] : [source];
@@ -2570,6 +2577,7 @@ function usesVararg(node) {
   return Object.values(record).some(usesVararg);
 }
 function calleePath(path) {
+  if (!/^[A-Za-z_]\w*(\.[A-Za-z_]\w*)*$/.test(path)) return parseExpressionFromSource(path);
   const [head, ...rest] = path.split(".");
   return rest.reduce((value, name) => member(value, name), identifier(head));
 }
@@ -2791,6 +2799,7 @@ import {
   directivesOf,
   applyDirectives,
   UNUSED_EXPECT_ERROR,
+  UNUSED_EXPECT_WARNING,
   ParseError,
   LexError,
   luauString as luauString4
@@ -3212,7 +3221,7 @@ async function bundle(options) {
   }
   for (const [file, fileDirectives] of directives) {
     const semantic = diagnostics.filter((d) => d.file === file && (d.category === "scope" || d.category === "type"));
-    const { kept, unusedExpectErrors } = applyDirectives(fileDirectives, semantic, (d) => d.line);
+    const { kept, unusedExpectErrors, unusedExpectWarnings } = applyDirectives(fileDirectives, semantic, (d) => d.line, (d) => d.severity === "warning");
     const suppressed = new Set(semantic.filter((d) => !kept.includes(d)));
     const remaining = diagnostics.filter((d) => !suppressed.has(d));
     diagnostics.length = 0;
@@ -3221,6 +3230,9 @@ async function bundle(options) {
     for (const d of unusedExpectErrors) {
       diagnostics.push({ file, message: UNUSED_EXPECT_ERROR, line: d.line, column: d.column, category: "type" });
     }
+    for (const d of unusedExpectWarnings) {
+      diagnostics.push({ file, message: UNUSED_EXPECT_WARNING, line: d.line, column: d.column, category: "type", severity: "warning" });
+    }
   }
   const moduleProblems = new Set(diagnostics.filter((d) => d.category === "module").map((d) => `${d.file}:${d.line}:${d.column}:${d.message}`));
   const reported = diagnostics.filter((d) => d.category !== "type" || !moduleProblems.has(`${d.file}:${d.line}:${d.column}:${d.message}`));

package/dist/cli.cjs

@@ -1465,8 +1465,15 @@ end`).body.statements, out2);
           item = this.names.fresh("item");
           prelude.push(...this.destructure(variable, identifier(item), "declare"));
         }
-        const form = this.options.types?.loops.get(node) ?? { walks: "values", viaIter: false };
+        const form = this.options.types?.loops.get(node) ?? { walks: node.over === "keys" ? "keys" : "values", viaIter: false };
         let source = this.expression(node.iterator);
+        if (form.walks === "keys") {
+          return [genericFor(
+            [item],
+            [call(this.builtin("pairs"), [source])],
+            this.loopBody51(this.block(node.body, prelude)).statements
+          )];
+        }
         if (form.viaIter) source = methodCall(source, "__iter", []);
         const variables = form.walks === "values" ? [this.names.fresh("_"), item] : [item];
         let iterators = form.walks === "iteration" ? [call(this.helper("unpack"), [source, number(1), number(3)])] : [source];
@@ -2587,6 +2594,7 @@ function usesVararg(node) {
   return Object.values(record).some(usesVararg);
 }
 function calleePath(path) {
+  if (!/^[A-Za-z_]\w*(\.[A-Za-z_]\w*)*$/.test(path)) return (0, import_luau_parser.parseExpressionFromSource)(path);
   const [head, ...rest] = path.split(".");
   return rest.reduce((value, name) => member(value, name), identifier(head));
 }
@@ -3209,7 +3217,7 @@ async function bundle(options) {
   }
   for (const [file, fileDirectives] of directives) {
     const semantic = diagnostics.filter((d) => d.file === file && (d.category === "scope" || d.category === "type"));
-    const { kept, unusedExpectErrors } = (0, import_parser7.applyDirectives)(fileDirectives, semantic, (d) => d.line);
+    const { kept, unusedExpectErrors, unusedExpectWarnings } = (0, import_parser7.applyDirectives)(fileDirectives, semantic, (d) => d.line, (d) => d.severity === "warning");
     const suppressed = new Set(semantic.filter((d) => !kept.includes(d)));
     const remaining = diagnostics.filter((d) => !suppressed.has(d));
     diagnostics.length = 0;
@@ -3218,6 +3226,9 @@ async function bundle(options) {
     for (const d of unusedExpectErrors) {
       diagnostics.push({ file, message: import_parser7.UNUSED_EXPECT_ERROR, line: d.line, column: d.column, category: "type" });
     }
+    for (const d of unusedExpectWarnings) {
+      diagnostics.push({ file, message: import_parser7.UNUSED_EXPECT_WARNING, line: d.line, column: d.column, category: "type", severity: "warning" });
+    }
   }
   const moduleProblems = new Set(diagnostics.filter((d) => d.category === "module").map((d) => `${d.file}:${d.line}:${d.column}:${d.message}`));
   const reported = diagnostics.filter((d) => d.category !== "type" || !moduleProblems.has(`${d.file}:${d.line}:${d.column}:${d.message}`));

package/dist/cli.js

@@ -2,7 +2,7 @@
 import {
   bundle,
   resolveConfig
-} from "./chunk-NM3EVX2J.js";
+} from "./chunk-TOP7NC3Z.js";
 
 // src/cli.ts
 import { mkdirSync, writeFileSync } from "fs";

package/dist/index.cjs

@@ -1488,8 +1488,15 @@ end`).body.statements, out);
           item = this.names.fresh("item");
           prelude.push(...this.destructure(variable, identifier(item), "declare"));
         }
-        const form = this.options.types?.loops.get(node) ?? { walks: "values", viaIter: false };
+        const form = this.options.types?.loops.get(node) ?? { walks: node.over === "keys" ? "keys" : "values", viaIter: false };
         let source = this.expression(node.iterator);
+        if (form.walks === "keys") {
+          return [genericFor(
+            [item],
+            [call(this.builtin("pairs"), [source])],
+            this.loopBody51(this.block(node.body, prelude)).statements
+          )];
+        }
         if (form.viaIter) source = methodCall(source, "__iter", []);
         const variables = form.walks === "values" ? [this.names.fresh("_"), item] : [item];
         let iterators = form.walks === "iteration" ? [call(this.helper("unpack"), [source, number(1), number(3)])] : [source];
@@ -2610,6 +2617,7 @@ function usesVararg(node) {
   return Object.values(record).some(usesVararg);
 }
 function calleePath(path) {
+  if (!/^[A-Za-z_]\w*(\.[A-Za-z_]\w*)*$/.test(path)) return (0, import_luau_parser.parseExpressionFromSource)(path);
   const [head, ...rest] = path.split(".");
   return rest.reduce((value, name) => member(value, name), identifier(head));
 }
@@ -3232,7 +3240,7 @@ async function bundle(options) {
   }
   for (const [file, fileDirectives] of directives) {
     const semantic = diagnostics.filter((d) => d.file === file && (d.category === "scope" || d.category === "type"));
-    const { kept, unusedExpectErrors } = (0, import_parser7.applyDirectives)(fileDirectives, semantic, (d) => d.line);
+    const { kept, unusedExpectErrors, unusedExpectWarnings } = (0, import_parser7.applyDirectives)(fileDirectives, semantic, (d) => d.line, (d) => d.severity === "warning");
     const suppressed = new Set(semantic.filter((d) => !kept.includes(d)));
     const remaining = diagnostics.filter((d) => !suppressed.has(d));
     diagnostics.length = 0;
@@ -3241,6 +3249,9 @@ async function bundle(options) {
     for (const d of unusedExpectErrors) {
       diagnostics.push({ file, message: import_parser7.UNUSED_EXPECT_ERROR, line: d.line, column: d.column, category: "type" });
     }
+    for (const d of unusedExpectWarnings) {
+      diagnostics.push({ file, message: import_parser7.UNUSED_EXPECT_WARNING, line: d.line, column: d.column, category: "type", severity: "warning" });
+    }
   }
   const moduleProblems = new Set(diagnostics.filter((d) => d.category === "module").map((d) => `${d.file}:${d.line}:${d.column}:${d.message}`));
   const reported = diagnostics.filter((d) => d.category !== "type" || !moduleProblems.has(`${d.file}:${d.line}:${d.column}:${d.message}`));

package/dist/index.js

@@ -4,7 +4,7 @@ import {
   lower,
   program,
   resolveConfig
-} from "./chunk-NM3EVX2J.js";
+} from "./chunk-TOP7NC3Z.js";
 
 // src/compile.ts
 import { readFileSync } from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tilua/compiler",
-  "version": "7.0.0",
+  "version": "8.0.0",
   "description": "Compiles tilua to Luau: lowers the @tilua/parser AST to a luau-parser AST and prints it",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -38,7 +38,7 @@
   "type": "module",
   "dependencies": {
     "luau-parser": "^1.0.3",
-    "@tilua/parser": "^7.0.0"
+    "@tilua/parser": "^8.0.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.2",