@tilua/compiler 9.1.1 → 9.1.3

package/README.md

@@ -546,12 +546,12 @@ a script that requires any of them knows what it got.
 <!-- compatibility:start -->
 ## Compatibility
 
-`@tilua/compiler@9.1.1` works with these tilua packages. *Released with* is the
+`@tilua/compiler@9.1.3` works with these tilua packages. *Released with* is the
 version it was built and tested against.
 
 | Package | Range | Released with | |
 | --- | --- | --- | --- |
-| `@tilua/parser` | `^9.1.1` | 9.1.1 | dependency |
+| `@tilua/parser` | `^9.1.3` | 9.1.3 | dependency |
 <!-- compatibility:end -->
 
 ## Development

package/dist/{chunk-3RJVN4KC.js → chunk-YWRP7SXR.js}

@@ -710,6 +710,8 @@ var Lowerer = class {
         receiverGlobal,
         argumentCount: args.length,
         at: this.callSite(name),
+        perFile: this.options.perFile ?? false,
+        report: (message) => this.diagnostics.push({ message, line: node.line.start, column: node.column.start }),
         get arguments() {
           return info();
         },
@@ -739,6 +741,8 @@ var Lowerer = class {
         options: lowerings[i].options ?? {},
         name,
         at: this.callSite(node.callee),
+        perFile: this.options.perFile ?? false,
+        report: (message) => this.diagnostics.push({ message, line: node.line.start, column: node.column.start }),
         get arguments() {
           return info();
         },
@@ -754,11 +758,16 @@ var Lowerer = class {
     if (!lowerings?.some((l) => l.plugin.globalValue)) return void 0;
     const name = this.globalName(node);
     if (name === void 0) return void 0;
+    const called = this.readingCallee;
     for (let i = lowerings.length - 1; i >= 0; i--) {
       const answer = lowerings[i].plugin.globalValue?.({
         options: lowerings[i].options ?? {},
         name,
         at: this.callSite(node),
+        perFile: this.options.perFile ?? false,
+        report: (message) => {
+          if (!called) this.diagnostics.push({ message, line: node.line.start, column: node.column.start });
+        },
         use: (runtime2) => this.loweringRuntime(i, runtime2)
       });
       if (answer !== void 0) return this.libraryExpression(answer, i, node);
@@ -2122,8 +2131,14 @@ end
     if (node.type === "CallExpression" && object2.type === "Identifier") {
       return this.link(node, this.reference(object2));
     }
-    return this.link(node, this.expression(object2));
+    const callee = node.type === "CallExpression" && node.callee === object2;
+    const reading = this.readingCallee;
+    this.readingCallee = callee;
+    const lowered = this.expression(object2);
+    this.readingCallee = reading;
+    return this.link(node, lowered);
   }
+  readingCallee = false;
   /** A call is one value in tilua, and Luau would hand on every value one
    *  returns in the last place of an argument list or a `return`: it is
    *  kept to one there, `f((g()))`. Every value is taken only where the
@@ -2802,6 +2817,8 @@ import {
   analyzeScopes,
   analyzeTypes,
   moduleExports,
+  classesOf,
+  exportsFingerprint,
   resolveModulePath,
   resolveTypeLibraries,
   importExpressions,
@@ -3272,7 +3289,7 @@ async function bundle(options) {
     for (let n = 2; taken.has(pathKey(runtimeFile)); n++) runtimeFile = join(outDir, `_tilua${n}.luau`);
     for (let i = lowerings.length - 1; i >= 0 && !host; i--) {
       const { plugin: plugin3, options: own } = lowerings[i];
-      host = plugin3.files?.({ options: own ?? {}, directory: config?.directory ?? root, outDir, files: outputs, runtime: runtimeFile });
+      host = plugin3.files?.({ options: own ?? {}, directory: config?.directory ?? root, rootDir, outDir, files: outputs, runtime: runtimeFile });
     }
     for (const problem of host?.problems ?? []) {
       diagnostics.push({
@@ -3315,6 +3332,7 @@ async function bundle(options) {
     const dynamicImports = /* @__PURE__ */ new Set();
     const lowered2 = lower(source.program, source.scopes, {
       names,
+      perFile,
       types: analysis.types.get(file),
       lowerings,
       noLib: config?.noLib,
@@ -3493,6 +3511,27 @@ ${G}.arrays[${G}.scriptArgs] = true`).body.statements);
     files2.push({ path: runtimePath, code: `${runtimeCode}
 ${WRITTEN_BY_TILUA}: the runtime every file of the project requires.
 `, modules: [] });
+    try {
+      const more = await host?.output?.();
+      for (const { file, code } of more?.files ?? []) {
+        if (isOutside(outDir, resolve2(file))) return stop(`A library's file has to go inside outDir, not at ${file}`);
+        files2.push({ path: relative(outDir, file).replace(/\\/g, "/"), code: `${code}
+${WRITTEN_BY_TILUA}: a library's own file.
+`, modules: [] });
+      }
+      for (const problem of more?.problems ?? []) {
+        diagnostics.push({
+          file: problem.file ?? config?.path ?? anchor,
+          message: problem.message,
+          line: 1,
+          column: 1,
+          category: "config",
+          ...problem.severity === "warning" && { severity: "warning" }
+        });
+      }
+    } catch (error) {
+      return stop(`A library could not write its files: ${error.message}`);
+    }
     return { code: files2[0].code, files: files2, modules: moduleNames, diagnostics };
   }
   const several = mode !== "single";
@@ -4049,7 +4088,11 @@ ${several ? `
         })
         record = { loading = true, exports = exports }
         ${G}.records[name] = record
-        module.load(exports)
+        -- A module runs once, so nothing keeps its body: anything can reach
+        -- this table, and the body holds what the file kept to itself.
+        local run = module.load
+        module.load = nil
+        run(exports)
         record.loading = false
         return exports
     end,
@@ -4142,6 +4185,7 @@ function parsedLibrary(file) {
   return program2;
 }
 var moduleAnalyses = /* @__PURE__ */ new Map();
+var MAX_CYCLE_PASSES = 6;
 function analyzeModules(modules, config) {
   const out = [];
   const analyses = /* @__PURE__ */ new Map();
@@ -4160,12 +4204,14 @@ function analyzeModules(modules, config) {
   const inProgress = /* @__PURE__ */ new Set();
   const analyzed = /* @__PURE__ */ new Map();
   let partials = 0;
+  const cycles = /* @__PURE__ */ new Set();
+  const provisional = /* @__PURE__ */ new Map();
   const readWhile = /* @__PURE__ */ new Map();
   const settingFor = `${libraries.files.join("|")}#${config?.directory ?? ""}#${JSON.stringify(config?.paths ?? {})}`;
   const analyzeModule = (file, program2) => {
     const done = analyzed.get(file);
     if (done) return done;
-    const remembered = moduleAnalyses.get(file);
+    const remembered = cycles.size ? void 0 : moduleAnalyses.get(file);
     const script = scriptOf(file);
     const ownLibs = script ? [...libs, script] : libs;
     if (remembered && remembered.setting === settingFor && ownLibs.length === remembered.libs.length && remembered.libs.every((lib, i) => lib === ownLibs[i]) && remembered.program === program2 && [...remembered.read].every(([read3, stamp]) => stampOf(read3) === stamp)) {
@@ -4193,6 +4239,8 @@ function analyzeModules(modules, config) {
     const result2 = { types, diagnostics: said, scopes };
     if (partials === before) {
       analyzed.set(file, result2);
+    }
+    if (partials === before && !cycles.size) {
       const read3 = readWhile.get(file) ?? /* @__PURE__ */ new Map();
       const own = stampOf(file);
       if (own !== void 0) read3.set(file, own);
@@ -4215,7 +4263,8 @@ function analyzeModules(modules, config) {
     };
     if (inProgress.has(target)) {
       partials++;
-      return { values: /* @__PURE__ */ new Map(), types: /* @__PURE__ */ new Map(), partial: true };
+      cycles.add(target);
+      return provisional.get(target) ?? { values: /* @__PURE__ */ new Map(), types: /* @__PURE__ */ new Map(), partial: true };
     }
     const cached = exportsCache.get(target);
     if (cached) {
@@ -4242,11 +4291,6 @@ function analyzeModules(modules, config) {
       inProgress.delete(target);
     }
   };
-  for (const module of modules) {
-    const { types, diagnostics } = analyzeModule(module.file, module.program);
-    analyses.set(module.file, types);
-    out.push(...diagnostics);
-  }
   const exportsOf = (file) => {
     const cached = exportsCache.get(file);
     if (cached) return cached;
@@ -4256,6 +4300,30 @@ function analyzeModules(modules, config) {
     exportsCache.set(file, exports);
     return exports;
   };
+  const reported = out.length;
+  const libraryClasses = classesOf(libs);
+  const fingerprints = /* @__PURE__ */ new Map();
+  for (let pass = 1; ; pass++) {
+    out.length = reported;
+    for (const module of modules) {
+      const { types, diagnostics } = analyzeModule(module.file, module.program);
+      analyses.set(module.file, types);
+      out.push(...diagnostics);
+    }
+    if (!cycles.size || pass === MAX_CYCLE_PASSES) break;
+    let settled = pass > 1;
+    for (const file of cycles) {
+      const exports = byFile.has(file) ? exportsOf(file) : exportsCache.get(file);
+      if (exports && !exports.partial) provisional.set(file, exports);
+      const fingerprint = exports && !exports.partial ? exportsFingerprint(exports, libraryClasses) : void 0;
+      if (fingerprint === void 0 || fingerprint !== fingerprints.get(file)) settled = false;
+      fingerprints.set(file, fingerprint);
+    }
+    if (settled) break;
+    analyzed.clear();
+    exportsCache.clear();
+    readWhile.clear();
+  }
   return { types: analyses, diagnostics: out, lowerings: [...libraries.lowerings], exportsOf };
 }
 function allStatements(statements) {

package/dist/cli.cjs

@@ -727,6 +727,8 @@ var Lowerer = class {
         receiverGlobal,
         argumentCount: args2.length,
         at: this.callSite(name),
+        perFile: this.options.perFile ?? false,
+        report: (message) => this.diagnostics.push({ message, line: node.line.start, column: node.column.start }),
         get arguments() {
           return info();
         },
@@ -756,6 +758,8 @@ var Lowerer = class {
         options: lowerings[i].options ?? {},
         name,
         at: this.callSite(node.callee),
+        perFile: this.options.perFile ?? false,
+        report: (message) => this.diagnostics.push({ message, line: node.line.start, column: node.column.start }),
         get arguments() {
           return info();
         },
@@ -771,11 +775,16 @@ var Lowerer = class {
     if (!lowerings?.some((l) => l.plugin.globalValue)) return void 0;
     const name = this.globalName(node);
     if (name === void 0) return void 0;
+    const called = this.readingCallee;
     for (let i = lowerings.length - 1; i >= 0; i--) {
       const answer = lowerings[i].plugin.globalValue?.({
         options: lowerings[i].options ?? {},
         name,
         at: this.callSite(node),
+        perFile: this.options.perFile ?? false,
+        report: (message) => {
+          if (!called) this.diagnostics.push({ message, line: node.line.start, column: node.column.start });
+        },
         use: (runtime2) => this.loweringRuntime(i, runtime2)
       });
       if (answer !== void 0) return this.libraryExpression(answer, i, node);
@@ -2139,8 +2148,14 @@ end
     if (node.type === "CallExpression" && object2.type === "Identifier") {
       return this.link(node, this.reference(object2));
     }
-    return this.link(node, this.expression(object2));
+    const callee = node.type === "CallExpression" && node.callee === object2;
+    const reading = this.readingCallee;
+    this.readingCallee = callee;
+    const lowered = this.expression(object2);
+    this.readingCallee = reading;
+    return this.link(node, lowered);
   }
+  readingCallee = false;
   /** A call is one value in tilua, and Luau would hand on every value one
    *  returns in the last place of an argument list or a `return`: it is
    *  kept to one there, `f((g()))`. Every value is taken only where the
@@ -3265,7 +3280,7 @@ async function bundle(options) {
     for (let n = 2; taken.has(pathKey(runtimeFile)); n++) runtimeFile = (0, import_node_path2.join)(outDir, `_tilua${n}.luau`);
     for (let i = lowerings.length - 1; i >= 0 && !host; i--) {
       const { plugin: plugin3, options: own } = lowerings[i];
-      host = plugin3.files?.({ options: own ?? {}, directory: config2?.directory ?? root, outDir, files: outputs, runtime: runtimeFile });
+      host = plugin3.files?.({ options: own ?? {}, directory: config2?.directory ?? root, rootDir, outDir, files: outputs, runtime: runtimeFile });
     }
     for (const problem of host?.problems ?? []) {
       diagnostics.push({
@@ -3308,6 +3323,7 @@ async function bundle(options) {
     const dynamicImports = /* @__PURE__ */ new Set();
     const lowered2 = lower(source.program, source.scopes, {
       names,
+      perFile,
       types: analysis.types.get(file),
       lowerings,
       noLib: config2?.noLib,
@@ -3486,6 +3502,27 @@ ${G}.arrays[${G}.scriptArgs] = true`).body.statements);
     files2.push({ path: runtimePath, code: `${runtimeCode}
 ${WRITTEN_BY_TILUA}: the runtime every file of the project requires.
 `, modules: [] });
+    try {
+      const more = await host?.output?.();
+      for (const { file, code } of more?.files ?? []) {
+        if (isOutside(outDir, (0, import_node_path2.resolve)(file))) return stop(`A library's file has to go inside outDir, not at ${file}`);
+        files2.push({ path: (0, import_node_path2.relative)(outDir, file).replace(/\\/g, "/"), code: `${code}
+${WRITTEN_BY_TILUA}: a library's own file.
+`, modules: [] });
+      }
+      for (const problem of more?.problems ?? []) {
+        diagnostics.push({
+          file: problem.file ?? config2?.path ?? anchor,
+          message: problem.message,
+          line: 1,
+          column: 1,
+          category: "config",
+          ...problem.severity === "warning" && { severity: "warning" }
+        });
+      }
+    } catch (error) {
+      return stop(`A library could not write its files: ${error.message}`);
+    }
     return { code: files2[0].code, files: files2, modules: moduleNames, diagnostics };
   }
   const several = mode !== "single";
@@ -4042,7 +4079,11 @@ ${several ? `
         })
         record = { loading = true, exports = exports }
         ${G}.records[name] = record
-        module.load(exports)
+        -- A module runs once, so nothing keeps its body: anything can reach
+        -- this table, and the body holds what the file kept to itself.
+        local run = module.load
+        module.load = nil
+        run(exports)
         record.loading = false
         return exports
     end,
@@ -4135,6 +4176,7 @@ function parsedLibrary(file) {
   return program2;
 }
 var moduleAnalyses = /* @__PURE__ */ new Map();
+var MAX_CYCLE_PASSES = 6;
 function analyzeModules(modules, config2) {
   const out2 = [];
   const analyses = /* @__PURE__ */ new Map();
@@ -4153,12 +4195,14 @@ function analyzeModules(modules, config2) {
   const inProgress = /* @__PURE__ */ new Set();
   const analyzed = /* @__PURE__ */ new Map();
   let partials = 0;
+  const cycles = /* @__PURE__ */ new Set();
+  const provisional = /* @__PURE__ */ new Map();
   const readWhile = /* @__PURE__ */ new Map();
   const settingFor = `${libraries.files.join("|")}#${config2?.directory ?? ""}#${JSON.stringify(config2?.paths ?? {})}`;
   const analyzeModule = (file, program2) => {
     const done = analyzed.get(file);
     if (done) return done;
-    const remembered = moduleAnalyses.get(file);
+    const remembered = cycles.size ? void 0 : moduleAnalyses.get(file);
     const script = scriptOf(file);
     const ownLibs = script ? [...libs, script] : libs;
     if (remembered && remembered.setting === settingFor && ownLibs.length === remembered.libs.length && remembered.libs.every((lib, i) => lib === ownLibs[i]) && remembered.program === program2 && [...remembered.read].every(([read3, stamp]) => stampOf(read3) === stamp)) {
@@ -4186,6 +4230,8 @@ function analyzeModules(modules, config2) {
     const result2 = { types, diagnostics: said, scopes };
     if (partials === before) {
       analyzed.set(file, result2);
+    }
+    if (partials === before && !cycles.size) {
       const read3 = readWhile.get(file) ?? /* @__PURE__ */ new Map();
       const own = stampOf(file);
       if (own !== void 0) read3.set(file, own);
@@ -4208,7 +4254,8 @@ function analyzeModules(modules, config2) {
     };
     if (inProgress.has(target)) {
       partials++;
-      return { values: /* @__PURE__ */ new Map(), types: /* @__PURE__ */ new Map(), partial: true };
+      cycles.add(target);
+      return provisional.get(target) ?? { values: /* @__PURE__ */ new Map(), types: /* @__PURE__ */ new Map(), partial: true };
     }
     const cached = exportsCache.get(target);
     if (cached) {
@@ -4235,11 +4282,6 @@ function analyzeModules(modules, config2) {
       inProgress.delete(target);
     }
   };
-  for (const module2 of modules) {
-    const { types, diagnostics } = analyzeModule(module2.file, module2.program);
-    analyses.set(module2.file, types);
-    out2.push(...diagnostics);
-  }
   const exportsOf = (file) => {
     const cached = exportsCache.get(file);
     if (cached) return cached;
@@ -4249,6 +4291,30 @@ function analyzeModules(modules, config2) {
     exportsCache.set(file, exports2);
     return exports2;
   };
+  const reported = out2.length;
+  const libraryClasses = (0, import_parser7.classesOf)(libs);
+  const fingerprints = /* @__PURE__ */ new Map();
+  for (let pass = 1; ; pass++) {
+    out2.length = reported;
+    for (const module2 of modules) {
+      const { types, diagnostics } = analyzeModule(module2.file, module2.program);
+      analyses.set(module2.file, types);
+      out2.push(...diagnostics);
+    }
+    if (!cycles.size || pass === MAX_CYCLE_PASSES) break;
+    let settled = pass > 1;
+    for (const file of cycles) {
+      const exports2 = byFile.has(file) ? exportsOf(file) : exportsCache.get(file);
+      if (exports2 && !exports2.partial) provisional.set(file, exports2);
+      const fingerprint = exports2 && !exports2.partial ? (0, import_parser7.exportsFingerprint)(exports2, libraryClasses) : void 0;
+      if (fingerprint === void 0 || fingerprint !== fingerprints.get(file)) settled = false;
+      fingerprints.set(file, fingerprint);
+    }
+    if (settled) break;
+    analyzed.clear();
+    exportsCache.clear();
+    readWhile.clear();
+  }
   return { types: analyses, diagnostics: out2, lowerings: [...libraries.lowerings], exportsOf };
 }
 function allStatements(statements) {

package/dist/cli.js

@@ -3,7 +3,7 @@ import {
   WRITTEN_BY_TILUA,
   bundle,
   resolveConfig
-} from "./chunk-3RJVN4KC.js";
+} from "./chunk-YWRP7SXR.js";
 
 // src/cli.ts
 import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, rmdirSync, rmSync, watch, writeFileSync } from "fs";

package/dist/index.cjs

@@ -751,6 +751,8 @@ var Lowerer = class {
         receiverGlobal,
         argumentCount: args.length,
         at: this.callSite(name),
+        perFile: this.options.perFile ?? false,
+        report: (message) => this.diagnostics.push({ message, line: node.line.start, column: node.column.start }),
         get arguments() {
           return info();
         },
@@ -780,6 +782,8 @@ var Lowerer = class {
         options: lowerings[i].options ?? {},
         name,
         at: this.callSite(node.callee),
+        perFile: this.options.perFile ?? false,
+        report: (message) => this.diagnostics.push({ message, line: node.line.start, column: node.column.start }),
         get arguments() {
           return info();
         },
@@ -795,11 +799,16 @@ var Lowerer = class {
     if (!lowerings?.some((l) => l.plugin.globalValue)) return void 0;
     const name = this.globalName(node);
     if (name === void 0) return void 0;
+    const called = this.readingCallee;
     for (let i = lowerings.length - 1; i >= 0; i--) {
       const answer = lowerings[i].plugin.globalValue?.({
         options: lowerings[i].options ?? {},
         name,
         at: this.callSite(node),
+        perFile: this.options.perFile ?? false,
+        report: (message) => {
+          if (!called) this.diagnostics.push({ message, line: node.line.start, column: node.column.start });
+        },
         use: (runtime2) => this.loweringRuntime(i, runtime2)
       });
       if (answer !== void 0) return this.libraryExpression(answer, i, node);
@@ -2163,8 +2172,14 @@ end
     if (node.type === "CallExpression" && object2.type === "Identifier") {
       return this.link(node, this.reference(object2));
     }
-    return this.link(node, this.expression(object2));
+    const callee = node.type === "CallExpression" && node.callee === object2;
+    const reading = this.readingCallee;
+    this.readingCallee = callee;
+    const lowered = this.expression(object2);
+    this.readingCallee = reading;
+    return this.link(node, lowered);
   }
+  readingCallee = false;
   /** A call is one value in tilua, and Luau would hand on every value one
    *  returns in the last place of an argument list or a `return`: it is
    *  kept to one there, `f((g()))`. Every value is taken only where the
@@ -3289,7 +3304,7 @@ async function bundle(options) {
     for (let n = 2; taken.has(pathKey(runtimeFile)); n++) runtimeFile = (0, import_node_path2.join)(outDir, `_tilua${n}.luau`);
     for (let i = lowerings.length - 1; i >= 0 && !host; i--) {
       const { plugin: plugin3, options: own } = lowerings[i];
-      host = plugin3.files?.({ options: own ?? {}, directory: config?.directory ?? root, outDir, files: outputs, runtime: runtimeFile });
+      host = plugin3.files?.({ options: own ?? {}, directory: config?.directory ?? root, rootDir, outDir, files: outputs, runtime: runtimeFile });
     }
     for (const problem of host?.problems ?? []) {
       diagnostics.push({
@@ -3332,6 +3347,7 @@ async function bundle(options) {
     const dynamicImports = /* @__PURE__ */ new Set();
     const lowered2 = lower(source.program, source.scopes, {
       names,
+      perFile,
       types: analysis.types.get(file),
       lowerings,
       noLib: config?.noLib,
@@ -3510,6 +3526,27 @@ ${G}.arrays[${G}.scriptArgs] = true`).body.statements);
     files2.push({ path: runtimePath, code: `${runtimeCode}
 ${WRITTEN_BY_TILUA}: the runtime every file of the project requires.
 `, modules: [] });
+    try {
+      const more = await host?.output?.();
+      for (const { file, code } of more?.files ?? []) {
+        if (isOutside(outDir, (0, import_node_path2.resolve)(file))) return stop(`A library's file has to go inside outDir, not at ${file}`);
+        files2.push({ path: (0, import_node_path2.relative)(outDir, file).replace(/\\/g, "/"), code: `${code}
+${WRITTEN_BY_TILUA}: a library's own file.
+`, modules: [] });
+      }
+      for (const problem of more?.problems ?? []) {
+        diagnostics.push({
+          file: problem.file ?? config?.path ?? anchor,
+          message: problem.message,
+          line: 1,
+          column: 1,
+          category: "config",
+          ...problem.severity === "warning" && { severity: "warning" }
+        });
+      }
+    } catch (error) {
+      return stop(`A library could not write its files: ${error.message}`);
+    }
     return { code: files2[0].code, files: files2, modules: moduleNames, diagnostics };
   }
   const several = mode !== "single";
@@ -4066,7 +4103,11 @@ ${several ? `
         })
         record = { loading = true, exports = exports }
         ${G}.records[name] = record
-        module.load(exports)
+        -- A module runs once, so nothing keeps its body: anything can reach
+        -- this table, and the body holds what the file kept to itself.
+        local run = module.load
+        module.load = nil
+        run(exports)
         record.loading = false
         return exports
     end,
@@ -4159,6 +4200,7 @@ function parsedLibrary(file) {
   return program2;
 }
 var moduleAnalyses = /* @__PURE__ */ new Map();
+var MAX_CYCLE_PASSES = 6;
 function analyzeModules(modules, config) {
   const out = [];
   const analyses = /* @__PURE__ */ new Map();
@@ -4177,12 +4219,14 @@ function analyzeModules(modules, config) {
   const inProgress = /* @__PURE__ */ new Set();
   const analyzed = /* @__PURE__ */ new Map();
   let partials = 0;
+  const cycles = /* @__PURE__ */ new Set();
+  const provisional = /* @__PURE__ */ new Map();
   const readWhile = /* @__PURE__ */ new Map();
   const settingFor = `${libraries.files.join("|")}#${config?.directory ?? ""}#${JSON.stringify(config?.paths ?? {})}`;
   const analyzeModule = (file, program2) => {
     const done = analyzed.get(file);
     if (done) return done;
-    const remembered = moduleAnalyses.get(file);
+    const remembered = cycles.size ? void 0 : moduleAnalyses.get(file);
     const script = scriptOf(file);
     const ownLibs = script ? [...libs, script] : libs;
     if (remembered && remembered.setting === settingFor && ownLibs.length === remembered.libs.length && remembered.libs.every((lib, i) => lib === ownLibs[i]) && remembered.program === program2 && [...remembered.read].every(([read3, stamp]) => stampOf(read3) === stamp)) {
@@ -4210,6 +4254,8 @@ function analyzeModules(modules, config) {
     const result2 = { types, diagnostics: said, scopes };
     if (partials === before) {
       analyzed.set(file, result2);
+    }
+    if (partials === before && !cycles.size) {
       const read3 = readWhile.get(file) ?? /* @__PURE__ */ new Map();
       const own = stampOf(file);
       if (own !== void 0) read3.set(file, own);
@@ -4232,7 +4278,8 @@ function analyzeModules(modules, config) {
     };
     if (inProgress.has(target)) {
       partials++;
-      return { values: /* @__PURE__ */ new Map(), types: /* @__PURE__ */ new Map(), partial: true };
+      cycles.add(target);
+      return provisional.get(target) ?? { values: /* @__PURE__ */ new Map(), types: /* @__PURE__ */ new Map(), partial: true };
     }
     const cached = exportsCache.get(target);
     if (cached) {
@@ -4259,11 +4306,6 @@ function analyzeModules(modules, config) {
       inProgress.delete(target);
     }
   };
-  for (const module2 of modules) {
-    const { types, diagnostics } = analyzeModule(module2.file, module2.program);
-    analyses.set(module2.file, types);
-    out.push(...diagnostics);
-  }
   const exportsOf = (file) => {
     const cached = exportsCache.get(file);
     if (cached) return cached;
@@ -4273,6 +4315,30 @@ function analyzeModules(modules, config) {
     exportsCache.set(file, exports2);
     return exports2;
   };
+  const reported = out.length;
+  const libraryClasses = (0, import_parser7.classesOf)(libs);
+  const fingerprints = /* @__PURE__ */ new Map();
+  for (let pass = 1; ; pass++) {
+    out.length = reported;
+    for (const module2 of modules) {
+      const { types, diagnostics } = analyzeModule(module2.file, module2.program);
+      analyses.set(module2.file, types);
+      out.push(...diagnostics);
+    }
+    if (!cycles.size || pass === MAX_CYCLE_PASSES) break;
+    let settled = pass > 1;
+    for (const file of cycles) {
+      const exports2 = byFile.has(file) ? exportsOf(file) : exportsCache.get(file);
+      if (exports2 && !exports2.partial) provisional.set(file, exports2);
+      const fingerprint = exports2 && !exports2.partial ? (0, import_parser7.exportsFingerprint)(exports2, libraryClasses) : void 0;
+      if (fingerprint === void 0 || fingerprint !== fingerprints.get(file)) settled = false;
+      fingerprints.set(file, fingerprint);
+    }
+    if (settled) break;
+    analyzed.clear();
+    exportsCache.clear();
+    readWhile.clear();
+  }
   return { types: analyses, diagnostics: out, lowerings: [...libraries.lowerings], exportsOf };
 }
 function allStatements(statements) {

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as T from '@tilua/parser';
 import { OutputMode, TiluaConfig, ConfigProblem, LoweringPlugin, TypeAnalysis, ScopeAnalysis } from '@tilua/parser';
-export { EntryExports, EntryExportsLowering, FilesAnswer, FilesLayout, LoweringPlugin, LuaSyntax, MethodCall, MethodLowering, PluginContext } from '@tilua/parser';
+export { EntryExports, EntryExportsLowering, FilesAnswer, FilesLayout, FilesOutput, FilesProblem, LoweringPlugin, LuaSyntax, MethodCall, MethodLowering, PluginContext } from '@tilua/parser';
 import * as L from 'luau-parser';
 
 /** What `tilua.config.json` holds. */
@@ -264,6 +264,8 @@ interface ModuleContext {
     readonly arrays?: string;
 }
 interface LowerOptions {
+    /** The build is `"output": "files"`, as a library is told. */
+    readonly perFile?: boolean;
     /** Lower the file as a module of a bundle. Without it, `import` and
      *  `export` are errors. */
     readonly module?: ModuleContext;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as T from '@tilua/parser';
 import { OutputMode, TiluaConfig, ConfigProblem, LoweringPlugin, TypeAnalysis, ScopeAnalysis } from '@tilua/parser';
-export { EntryExports, EntryExportsLowering, FilesAnswer, FilesLayout, LoweringPlugin, LuaSyntax, MethodCall, MethodLowering, PluginContext } from '@tilua/parser';
+export { EntryExports, EntryExportsLowering, FilesAnswer, FilesLayout, FilesOutput, FilesProblem, LoweringPlugin, LuaSyntax, MethodCall, MethodLowering, PluginContext } from '@tilua/parser';
 import * as L from 'luau-parser';
 
 /** What `tilua.config.json` holds. */
@@ -264,6 +264,8 @@ interface ModuleContext {
     readonly arrays?: string;
 }
 interface LowerOptions {
+    /** The build is `"output": "files"`, as a library is told. */
+    readonly perFile?: boolean;
     /** Lower the file as a module of a bundle. Without it, `import` and
      *  `export` are errors. */
     readonly module?: ModuleContext;

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   program,
   resolveConfig,
   syntaxOf
-} from "./chunk-3RJVN4KC.js";
+} from "./chunk-YWRP7SXR.js";
 
 // src/compile.ts
 import { readFileSync } from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tilua/compiler",
-  "version": "9.1.1",
+  "version": "9.1.3",
   "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",
@@ -37,7 +37,7 @@
   "license": "ISC",
   "type": "module",
   "dependencies": {
-    "@tilua/parser": "^9.1.1",
+    "@tilua/parser": "^9.1.3",
     "luau-parser": "^1.1.0"
   },
   "devDependencies": {