@tilua/compiler 8.0.0 → 8.1.0

package/README.md

@@ -14,7 +14,7 @@ npx tilua src/main.tilua --out build/main.luau
 
 ```
 tilua <entry> [--out <file>] [--output single|chunks|modules] [--config <tilua.config.json>]
-              [--noCheck]
+              [--noCheck] [--noLineMap]
 ```
 
 Every module the entry imports is bundled in. Problems are reported as
@@ -296,6 +296,16 @@ With several files each has its own line map, and a position is read by the
 map of the file it names — matched by the end of that file's path, since the
 Lua running it may call it by a full path, a relative one, or an Instance's.
 
+The map is packed — the files it names once, then three base-64 VLQ numbers a
+line, each counted from the line before — and read out the first time a line
+is looked up, so a program that never fails never unpacks it.
+
+For a release nobody will debug, `"lineMap": false` in `tilua.config.json`
+(or `--noLineMap`, or `bundle({ lineMap: false })`) leaves out the map and
+everything that reads it: the entry runs without `xpcall`, a callback handed
+to Roblox is passed through unwrapped, and an error names the bundle's own
+lines, as plain Luau would.
+
 ## Modules
 
 Roblox's `require` takes an Instance, so the bundle has its own. Each module
@@ -434,12 +444,12 @@ entry's.
 <!-- compatibility:start -->
 ## Compatibility
 
-`@tilua/compiler@8.0.0` works with these tilua packages. *Released with* is the
+`@tilua/compiler@8.1.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 |
+| `@tilua/parser` | `^8.1.0` | 8.1.0 | dependency |
 <!-- compatibility:end -->
 
 ## Development

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

@@ -3101,10 +3101,33 @@ function buildLineMap(emitted, printed, origins) {
   }
   return map;
 }
-function lineMapSource(map) {
+var VLQ_DIGITS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+function vlq(n) {
+  let value = n < 0 ? -n * 2 + 1 : n * 2;
+  let out = "";
+  do {
+    const digit = value % 32;
+    value = Math.floor(value / 32);
+    out += VLQ_DIGITS[value > 0 ? digit + 32 : digit];
+  } while (value > 0);
+  return out;
+}
+function lineMapSource(map, unpack) {
   const entries = [...map.entries()].sort((a, b) => a[0] - b[0]);
-  const quoted = (s) => luauString3(s.replace(/\\/g, "/"));
-  return `{${entries.map(([line, o]) => `[${line}]={${quoted(o.file)},${o.line}}`).join(",")}}`;
+  const files = [];
+  const indexes = /* @__PURE__ */ new Map();
+  let data = "";
+  let line = 0, file = 0, source = 0;
+  for (const [at, origin] of entries) {
+    const name = origin.file.replace(/\\/g, "/");
+    if (!indexes.has(name)) indexes.set(name, files.push(name));
+    const index2 = indexes.get(name);
+    data += vlq(at - line) + vlq(index2 - file) + vlq(origin.line - source);
+    line = at;
+    file = index2;
+    source = origin.line;
+  }
+  return `${unpack}({${files.map(luauString3).join(",")}},${luauString3(data)})`;
 }
 
 // src/bundle.ts
@@ -3152,6 +3175,7 @@ async function bundle(options) {
   const origins = /* @__PURE__ */ new WeakMap();
   const shared = new SharedRuntime(names);
   const shaking = options.treeShaking ?? config?.treeShaking ?? false;
+  const mapping = options.lineMap ?? config?.lineMap ?? true;
   const resolveIn = (file) => (specifier) => {
     const found = resolveModulePath(file, specifier, config);
     return found !== void 0 && sources.has(found) ? found : void 0;
@@ -3190,8 +3214,8 @@ async function bundle(options) {
         import: importExpression,
         // One file has one line map. Several have one each, and a
         // module reads the one of the file it is in.
-        lines: mode === "single" ? `${G}.lines` : `${G}.maps[${luauString4(source.name)}]`,
-        fail: `${G}.fail`,
+        lines: !mapping ? void 0 : mode === "single" ? `${G}.lines` : `${G}.maps[${luauString4(source.name)}]`,
+        fail: mapping ? `${G}.fail` : void 0,
         arrays: `${G}.arrays`,
         resolve: (specifier, dynamic) => {
           const found = resolveModulePath(file, specifier, config);
@@ -3255,7 +3279,8 @@ async function bundle(options) {
     several,
     byPath,
     files: elsewhere,
-    imports: lowered.some((m) => m.dynamicImports.size > 0)
+    imports: lowered.some((m) => m.dynamicImports.size > 0),
+    mapping
   }));
   const assignment = program2.body.statements[1];
   if (usesScriptArgs) {
@@ -3272,21 +3297,23 @@ async function bundle(options) {
   program2.body.statements.unshift(...helpers.declare);
   const ok = names.fresh("ok");
   const result2 = names.fresh("result");
-  const entryStatements = parseLuau2(`
+  const entryName = luauString4(sources.get(entry).name);
+  const returnsExports = modules.get(entry).info.exports;
+  const entryStatements = parseLuau2(!mapping ? `${returnsExports ? "return " : ""}${G}.require(${entryName})` : `
 local ${ok}, ${result2} = xpcall(function()
-    return ${G}.require(${luauString4(sources.get(entry).name)})
+    return ${G}.require(${entryName})
 end, ${G}.fail)
 if not ${ok} then
     error(${result2}, 0)
 end
-${modules.get(entry).info.exports ? `return ${result2}` : ""}
+${returnsExports ? `return ${result2}` : ""}
 `).body.statements;
   program2.body.statements.push(...entryStatements);
-  const map = buildLineMap(program2, parseLuau2(print(program2)), origins);
-  if (map.size || several) {
+  const map = mapping ? buildLineMap(program2, parseLuau2(print(program2)), origins) : /* @__PURE__ */ new Map();
+  if (mapping && (map.size || several)) {
     const mapStatements = [assign(
       [member(identifier(G), "lines")],
-      [parseExpressionFromSource2(lineMapSource(map))]
+      [parseExpressionFromSource2(lineMapSource(map, `${G}.lineMap`))]
     )];
     if (several) mapStatements.push(...mapRegistration(G, layout[0], `${G}.lines`));
     program2.body.statements.splice(program2.body.statements.length - entryStatements.length, 0, ...mapStatements);
@@ -3304,8 +3331,11 @@ ${modules.get(entry).info.exports ? `return ${result2}` : ""}
       ));
     }
     const chunk = program([returns([functionExpression(functionBody([G], body))])]);
-    const lines = buildLineMap(chunk, parseLuau2(print(chunk)), origins);
-    body.push(...mapRegistration(G, file, lineMapSource(lines)), ...fileHelpers.define);
+    if (mapping) {
+      const lines = buildLineMap(chunk, parseLuau2(print(chunk)), origins);
+      body.push(...mapRegistration(G, file, lineMapSource(lines, `${G}.lineMap`)));
+    }
+    body.push(...fileHelpers.define);
     files.push({ path: file.path, code: print(chunk) + "\n", modules: file.modules.map((m) => m.name) });
   }
   return { code: files[0].code, files, modules: moduleNames, diagnostics };
@@ -3403,7 +3433,7 @@ function loader(G, byPath) {
         require(file)(${G})`;
 }
 function runtime(G, options) {
-  const { several } = options;
+  const { several, mapping } = options;
   const files = [...options.files].map(([name, file]) => `[${luauString4(name)}] = ${luauString4(file)}`).join(", ");
   return `
 local ${G}
@@ -3411,7 +3441,7 @@ ${G} = {
     modules = {},
     -- Every array the program made, so \`typeof\` can tell one from an object.
     -- The keys are held weakly: being written down keeps no array alive.
-    arrays = setmetatable({}, { __mode = "k" }),
+    arrays = setmetatable({}, { __mode = "k" }),${mapping ? `
     -- Filled in just before the entry runs: bundle line -> { file, line }.
     lines = nil,
     -- What an error nothing caught says, in the project's files: the bundle's
@@ -3579,13 +3609,49 @@ ${several ? `
         end
         return mapped .. "\\n" .. table.concat(frames, "\\n")
     end,
+    -- A line map as it is written: the files it names, and base-64 VLQ
+    -- numbers, three to a line \u2014 how far down the bundle, which file, how far
+    -- down that file, each counted from the line before. It is read out the
+    -- first time a line is looked up, which is when something went wrong.
+    lineMap = function(files, data)
+        local map = {}
+        return setmetatable(map, { __index = function(_, key)
+            setmetatable(map, nil)
+            local digits = {}
+            for i = 1, 64 do
+                digits[("${VLQ_DIGITS}"):byte(i)] = i - 1
+            end
+            local at = 1
+            local function read()
+                local value, scale = 0, 1
+                repeat
+                    local digit = digits[data:byte(at)]
+                    at = at + 1
+                    value = value + digit % 32 * scale
+                    scale = scale * 32
+                until digit < 32
+                if value % 2 == 1 then
+                    return -math.floor(value / 2)
+                end
+                return math.floor(value / 2)
+            end
+            local line, file, source = 0, 0, 0
+            while at <= #data do
+                line = line + read()
+                file = file + read()
+                source = source + read()
+                map[line] = { files[file], source }
+            end
+            return map[key]
+        end })
+    end,` : ""}
     records = {},${several ? `
     -- The file each module outside this one is in, as \`load\` is handed it.
     files = { ${files} },
-    loaded = {},
+    loaded = {},${mapping ? `
     -- Every file's line map: by the module, and by the file's name.
     maps = {},
-    sources = {},
+    sources = {},` : ""}
     -- Another of the bundle's files: a function that adds its modules here.
     load = function(file)
         if ${G}.loaded[file] then

package/dist/cli.cjs

@@ -3070,10 +3070,33 @@ function buildLineMap(emitted, printed, origins) {
   }
   return map;
 }
-function lineMapSource(map) {
+var VLQ_DIGITS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+function vlq(n) {
+  let value = n < 0 ? -n * 2 + 1 : n * 2;
+  let out2 = "";
+  do {
+    const digit = value % 32;
+    value = Math.floor(value / 32);
+    out2 += VLQ_DIGITS[value > 0 ? digit + 32 : digit];
+  } while (value > 0);
+  return out2;
+}
+function lineMapSource(map, unpack) {
   const entries = [...map.entries()].sort((a, b) => a[0] - b[0]);
-  const quoted = (s) => (0, import_parser6.luauString)(s.replace(/\\/g, "/"));
-  return `{${entries.map(([line, o]) => `[${line}]={${quoted(o.file)},${o.line}}`).join(",")}}`;
+  const files = [];
+  const indexes = /* @__PURE__ */ new Map();
+  let data = "";
+  let line = 0, file = 0, source = 0;
+  for (const [at, origin] of entries) {
+    const name = origin.file.replace(/\\/g, "/");
+    if (!indexes.has(name)) indexes.set(name, files.push(name));
+    const index2 = indexes.get(name);
+    data += vlq(at - line) + vlq(index2 - file) + vlq(origin.line - source);
+    line = at;
+    file = index2;
+    source = origin.line;
+  }
+  return `${unpack}({${files.map(import_parser6.luauString).join(",")}},${(0, import_parser6.luauString)(data)})`;
 }
 
 // src/lowering.ts
@@ -3148,6 +3171,7 @@ async function bundle(options) {
   const origins = /* @__PURE__ */ new WeakMap();
   const shared = new SharedRuntime(names);
   const shaking = options.treeShaking ?? config2?.treeShaking ?? false;
+  const mapping = options.lineMap ?? config2?.lineMap ?? true;
   const resolveIn = (file) => (specifier) => {
     const found = (0, import_parser7.resolveModulePath)(file, specifier, config2);
     return found !== void 0 && sources.has(found) ? found : void 0;
@@ -3186,8 +3210,8 @@ async function bundle(options) {
         import: importExpression,
         // One file has one line map. Several have one each, and a
         // module reads the one of the file it is in.
-        lines: mode === "single" ? `${G}.lines` : `${G}.maps[${(0, import_parser7.luauString)(source.name)}]`,
-        fail: `${G}.fail`,
+        lines: !mapping ? void 0 : mode === "single" ? `${G}.lines` : `${G}.maps[${(0, import_parser7.luauString)(source.name)}]`,
+        fail: mapping ? `${G}.fail` : void 0,
         arrays: `${G}.arrays`,
         resolve: (specifier, dynamic) => {
           const found = (0, import_parser7.resolveModulePath)(file, specifier, config2);
@@ -3251,7 +3275,8 @@ async function bundle(options) {
     several,
     byPath,
     files: elsewhere,
-    imports: lowered.some((m) => m.dynamicImports.size > 0)
+    imports: lowered.some((m) => m.dynamicImports.size > 0),
+    mapping
   }));
   const assignment = program2.body.statements[1];
   if (usesScriptArgs) {
@@ -3268,21 +3293,23 @@ async function bundle(options) {
   program2.body.statements.unshift(...helpers.declare);
   const ok = names.fresh("ok");
   const result2 = names.fresh("result");
-  const entryStatements = (0, import_luau_parser2.parse)(`
+  const entryName = (0, import_parser7.luauString)(sources.get(entry2).name);
+  const returnsExports = modules.get(entry2).info.exports;
+  const entryStatements = (0, import_luau_parser2.parse)(!mapping ? `${returnsExports ? "return " : ""}${G}.require(${entryName})` : `
 local ${ok}, ${result2} = xpcall(function()
-    return ${G}.require(${(0, import_parser7.luauString)(sources.get(entry2).name)})
+    return ${G}.require(${entryName})
 end, ${G}.fail)
 if not ${ok} then
     error(${result2}, 0)
 end
-${modules.get(entry2).info.exports ? `return ${result2}` : ""}
+${returnsExports ? `return ${result2}` : ""}
 `).body.statements;
   program2.body.statements.push(...entryStatements);
-  const map = buildLineMap(program2, (0, import_luau_parser2.parse)((0, import_luau_parser2.print)(program2)), origins);
-  if (map.size || several) {
+  const map = mapping ? buildLineMap(program2, (0, import_luau_parser2.parse)((0, import_luau_parser2.print)(program2)), origins) : /* @__PURE__ */ new Map();
+  if (mapping && (map.size || several)) {
     const mapStatements = [assign(
       [member(identifier(G), "lines")],
-      [(0, import_luau_parser2.parseExpressionFromSource)(lineMapSource(map))]
+      [(0, import_luau_parser2.parseExpressionFromSource)(lineMapSource(map, `${G}.lineMap`))]
     )];
     if (several) mapStatements.push(...mapRegistration(G, layout[0], `${G}.lines`));
     program2.body.statements.splice(program2.body.statements.length - entryStatements.length, 0, ...mapStatements);
@@ -3300,8 +3327,11 @@ ${modules.get(entry2).info.exports ? `return ${result2}` : ""}
       ));
     }
     const chunk = program([returns([functionExpression(functionBody([G], body))])]);
-    const lines = buildLineMap(chunk, (0, import_luau_parser2.parse)((0, import_luau_parser2.print)(chunk)), origins);
-    body.push(...mapRegistration(G, file, lineMapSource(lines)), ...fileHelpers.define);
+    if (mapping) {
+      const lines = buildLineMap(chunk, (0, import_luau_parser2.parse)((0, import_luau_parser2.print)(chunk)), origins);
+      body.push(...mapRegistration(G, file, lineMapSource(lines, `${G}.lineMap`)));
+    }
+    body.push(...fileHelpers.define);
     files.push({ path: file.path, code: (0, import_luau_parser2.print)(chunk) + "\n", modules: file.modules.map((m) => m.name) });
   }
   return { code: files[0].code, files, modules: moduleNames, diagnostics };
@@ -3399,7 +3429,7 @@ function loader(G, byPath) {
         require(file)(${G})`;
 }
 function runtime(G, options) {
-  const { several } = options;
+  const { several, mapping } = options;
   const files = [...options.files].map(([name, file]) => `[${(0, import_parser7.luauString)(name)}] = ${(0, import_parser7.luauString)(file)}`).join(", ");
   return `
 local ${G}
@@ -3407,7 +3437,7 @@ ${G} = {
     modules = {},
     -- Every array the program made, so \`typeof\` can tell one from an object.
     -- The keys are held weakly: being written down keeps no array alive.
-    arrays = setmetatable({}, { __mode = "k" }),
+    arrays = setmetatable({}, { __mode = "k" }),${mapping ? `
     -- Filled in just before the entry runs: bundle line -> { file, line }.
     lines = nil,
     -- What an error nothing caught says, in the project's files: the bundle's
@@ -3575,13 +3605,49 @@ ${several ? `
         end
         return mapped .. "\\n" .. table.concat(frames, "\\n")
     end,
+    -- A line map as it is written: the files it names, and base-64 VLQ
+    -- numbers, three to a line \u2014 how far down the bundle, which file, how far
+    -- down that file, each counted from the line before. It is read out the
+    -- first time a line is looked up, which is when something went wrong.
+    lineMap = function(files, data)
+        local map = {}
+        return setmetatable(map, { __index = function(_, key)
+            setmetatable(map, nil)
+            local digits = {}
+            for i = 1, 64 do
+                digits[("${VLQ_DIGITS}"):byte(i)] = i - 1
+            end
+            local at = 1
+            local function read()
+                local value, scale = 0, 1
+                repeat
+                    local digit = digits[data:byte(at)]
+                    at = at + 1
+                    value = value + digit % 32 * scale
+                    scale = scale * 32
+                until digit < 32
+                if value % 2 == 1 then
+                    return -math.floor(value / 2)
+                end
+                return math.floor(value / 2)
+            end
+            local line, file, source = 0, 0, 0
+            while at <= #data do
+                line = line + read()
+                file = file + read()
+                source = source + read()
+                map[line] = { files[file], source }
+            end
+            return map[key]
+        end })
+    end,` : ""}
     records = {},${several ? `
     -- The file each module outside this one is in, as \`load\` is handed it.
     files = { ${files} },
-    loaded = {},
+    loaded = {},${mapping ? `
     -- Every file's line map: by the module, and by the file's name.
     maps = {},
-    sources = {},
+    sources = {},` : ""}
     -- Another of the bundle's files: a function that adds its modules here.
     load = function(file)
         if ${G}.loaded[file] then
@@ -3822,18 +3888,20 @@ function allStatements(statements) {
 }
 
 // src/cli.ts
-var usage = "usage: tilua <entry> [--out <file>] [--output single|chunks|modules] [--config <tilua.config.json>] [--noCheck]";
+var usage = "usage: tilua <entry> [--out <file>] [--output single|chunks|modules] [--config <tilua.config.json>] [--noCheck] [--noLineMap]";
 var args = process.argv.slice(2);
 var entry;
 var out;
 var config;
 var typeCheck = true;
+var lineMap;
 var output;
 for (let i = 0; i < args.length; i++) {
   const arg = args[i];
   if (arg === "--out") out = args[++i];
   else if (arg === "--config") config = args[++i];
   else if (arg === "--noCheck") typeCheck = false;
+  else if (arg === "--noLineMap") lineMap = false;
   else if (arg === "--target") {
     console.error(`--target is gone: the output runs on Lua 5.1 to 5.4, LuaJIT and Luau, and a library says what more its Lua has \u2014 add "luau" to the config's 'types'`);
     process.exit(2);
@@ -3863,6 +3931,7 @@ async function main(from) {
     config,
     typeCheck,
     output: mode,
+    lineMap,
     outFile: entryFile !== void 0 ? (0, import_node_path3.basename)(entryFile) : void 0
   });
   for (const d of result2.diagnostics) {

package/dist/cli.js

@@ -2,23 +2,25 @@
 import {
   bundle,
   resolveConfig
-} from "./chunk-TOP7NC3Z.js";
+} from "./chunk-WOBHMGGC.js";
 
 // src/cli.ts
 import { mkdirSync, writeFileSync } from "fs";
 import { basename, dirname, join, relative, resolve } from "path";
-var usage = "usage: tilua <entry> [--out <file>] [--output single|chunks|modules] [--config <tilua.config.json>] [--noCheck]";
+var usage = "usage: tilua <entry> [--out <file>] [--output single|chunks|modules] [--config <tilua.config.json>] [--noCheck] [--noLineMap]";
 var args = process.argv.slice(2);
 var entry;
 var out;
 var config;
 var typeCheck = true;
+var lineMap;
 var output;
 for (let i = 0; i < args.length; i++) {
   const arg = args[i];
   if (arg === "--out") out = args[++i];
   else if (arg === "--config") config = args[++i];
   else if (arg === "--noCheck") typeCheck = false;
+  else if (arg === "--noLineMap") lineMap = false;
   else if (arg === "--target") {
     console.error(`--target is gone: the output runs on Lua 5.1 to 5.4, LuaJIT and Luau, and a library says what more its Lua has \u2014 add "luau" to the config's 'types'`);
     process.exit(2);
@@ -48,6 +50,7 @@ async function main(from) {
     config,
     typeCheck,
     output: mode,
+    lineMap,
     outFile: entryFile !== void 0 ? basename(entryFile) : void 0
   });
   for (const d of result.diagnostics) {

package/dist/index.cjs

@@ -3093,10 +3093,33 @@ function buildLineMap(emitted, printed, origins) {
   }
   return map;
 }
-function lineMapSource(map) {
+var VLQ_DIGITS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+function vlq(n) {
+  let value = n < 0 ? -n * 2 + 1 : n * 2;
+  let out = "";
+  do {
+    const digit = value % 32;
+    value = Math.floor(value / 32);
+    out += VLQ_DIGITS[value > 0 ? digit + 32 : digit];
+  } while (value > 0);
+  return out;
+}
+function lineMapSource(map, unpack) {
   const entries = [...map.entries()].sort((a, b) => a[0] - b[0]);
-  const quoted = (s) => (0, import_parser6.luauString)(s.replace(/\\/g, "/"));
-  return `{${entries.map(([line, o]) => `[${line}]={${quoted(o.file)},${o.line}}`).join(",")}}`;
+  const files = [];
+  const indexes = /* @__PURE__ */ new Map();
+  let data = "";
+  let line = 0, file = 0, source = 0;
+  for (const [at, origin] of entries) {
+    const name = origin.file.replace(/\\/g, "/");
+    if (!indexes.has(name)) indexes.set(name, files.push(name));
+    const index2 = indexes.get(name);
+    data += vlq(at - line) + vlq(index2 - file) + vlq(origin.line - source);
+    line = at;
+    file = index2;
+    source = origin.line;
+  }
+  return `${unpack}({${files.map(import_parser6.luauString).join(",")}},${(0, import_parser6.luauString)(data)})`;
 }
 
 // src/lowering.ts
@@ -3171,6 +3194,7 @@ async function bundle(options) {
   const origins = /* @__PURE__ */ new WeakMap();
   const shared = new SharedRuntime(names);
   const shaking = options.treeShaking ?? config?.treeShaking ?? false;
+  const mapping = options.lineMap ?? config?.lineMap ?? true;
   const resolveIn = (file) => (specifier) => {
     const found = (0, import_parser7.resolveModulePath)(file, specifier, config);
     return found !== void 0 && sources.has(found) ? found : void 0;
@@ -3209,8 +3233,8 @@ async function bundle(options) {
         import: importExpression,
         // One file has one line map. Several have one each, and a
         // module reads the one of the file it is in.
-        lines: mode === "single" ? `${G}.lines` : `${G}.maps[${(0, import_parser7.luauString)(source.name)}]`,
-        fail: `${G}.fail`,
+        lines: !mapping ? void 0 : mode === "single" ? `${G}.lines` : `${G}.maps[${(0, import_parser7.luauString)(source.name)}]`,
+        fail: mapping ? `${G}.fail` : void 0,
         arrays: `${G}.arrays`,
         resolve: (specifier, dynamic) => {
           const found = (0, import_parser7.resolveModulePath)(file, specifier, config);
@@ -3274,7 +3298,8 @@ async function bundle(options) {
     several,
     byPath,
     files: elsewhere,
-    imports: lowered.some((m) => m.dynamicImports.size > 0)
+    imports: lowered.some((m) => m.dynamicImports.size > 0),
+    mapping
   }));
   const assignment = program2.body.statements[1];
   if (usesScriptArgs) {
@@ -3291,21 +3316,23 @@ async function bundle(options) {
   program2.body.statements.unshift(...helpers.declare);
   const ok = names.fresh("ok");
   const result2 = names.fresh("result");
-  const entryStatements = (0, import_luau_parser2.parse)(`
+  const entryName = (0, import_parser7.luauString)(sources.get(entry).name);
+  const returnsExports = modules.get(entry).info.exports;
+  const entryStatements = (0, import_luau_parser2.parse)(!mapping ? `${returnsExports ? "return " : ""}${G}.require(${entryName})` : `
 local ${ok}, ${result2} = xpcall(function()
-    return ${G}.require(${(0, import_parser7.luauString)(sources.get(entry).name)})
+    return ${G}.require(${entryName})
 end, ${G}.fail)
 if not ${ok} then
     error(${result2}, 0)
 end
-${modules.get(entry).info.exports ? `return ${result2}` : ""}
+${returnsExports ? `return ${result2}` : ""}
 `).body.statements;
   program2.body.statements.push(...entryStatements);
-  const map = buildLineMap(program2, (0, import_luau_parser2.parse)((0, import_luau_parser2.print)(program2)), origins);
-  if (map.size || several) {
+  const map = mapping ? buildLineMap(program2, (0, import_luau_parser2.parse)((0, import_luau_parser2.print)(program2)), origins) : /* @__PURE__ */ new Map();
+  if (mapping && (map.size || several)) {
     const mapStatements = [assign(
       [member(identifier(G), "lines")],
-      [(0, import_luau_parser2.parseExpressionFromSource)(lineMapSource(map))]
+      [(0, import_luau_parser2.parseExpressionFromSource)(lineMapSource(map, `${G}.lineMap`))]
     )];
     if (several) mapStatements.push(...mapRegistration(G, layout[0], `${G}.lines`));
     program2.body.statements.splice(program2.body.statements.length - entryStatements.length, 0, ...mapStatements);
@@ -3323,8 +3350,11 @@ ${modules.get(entry).info.exports ? `return ${result2}` : ""}
       ));
     }
     const chunk = program([returns([functionExpression(functionBody([G], body))])]);
-    const lines = buildLineMap(chunk, (0, import_luau_parser2.parse)((0, import_luau_parser2.print)(chunk)), origins);
-    body.push(...mapRegistration(G, file, lineMapSource(lines)), ...fileHelpers.define);
+    if (mapping) {
+      const lines = buildLineMap(chunk, (0, import_luau_parser2.parse)((0, import_luau_parser2.print)(chunk)), origins);
+      body.push(...mapRegistration(G, file, lineMapSource(lines, `${G}.lineMap`)));
+    }
+    body.push(...fileHelpers.define);
     files.push({ path: file.path, code: (0, import_luau_parser2.print)(chunk) + "\n", modules: file.modules.map((m) => m.name) });
   }
   return { code: files[0].code, files, modules: moduleNames, diagnostics };
@@ -3422,7 +3452,7 @@ function loader(G, byPath) {
         require(file)(${G})`;
 }
 function runtime(G, options) {
-  const { several } = options;
+  const { several, mapping } = options;
   const files = [...options.files].map(([name, file]) => `[${(0, import_parser7.luauString)(name)}] = ${(0, import_parser7.luauString)(file)}`).join(", ");
   return `
 local ${G}
@@ -3430,7 +3460,7 @@ ${G} = {
     modules = {},
     -- Every array the program made, so \`typeof\` can tell one from an object.
     -- The keys are held weakly: being written down keeps no array alive.
-    arrays = setmetatable({}, { __mode = "k" }),
+    arrays = setmetatable({}, { __mode = "k" }),${mapping ? `
     -- Filled in just before the entry runs: bundle line -> { file, line }.
     lines = nil,
     -- What an error nothing caught says, in the project's files: the bundle's
@@ -3598,13 +3628,49 @@ ${several ? `
         end
         return mapped .. "\\n" .. table.concat(frames, "\\n")
     end,
+    -- A line map as it is written: the files it names, and base-64 VLQ
+    -- numbers, three to a line \u2014 how far down the bundle, which file, how far
+    -- down that file, each counted from the line before. It is read out the
+    -- first time a line is looked up, which is when something went wrong.
+    lineMap = function(files, data)
+        local map = {}
+        return setmetatable(map, { __index = function(_, key)
+            setmetatable(map, nil)
+            local digits = {}
+            for i = 1, 64 do
+                digits[("${VLQ_DIGITS}"):byte(i)] = i - 1
+            end
+            local at = 1
+            local function read()
+                local value, scale = 0, 1
+                repeat
+                    local digit = digits[data:byte(at)]
+                    at = at + 1
+                    value = value + digit % 32 * scale
+                    scale = scale * 32
+                until digit < 32
+                if value % 2 == 1 then
+                    return -math.floor(value / 2)
+                end
+                return math.floor(value / 2)
+            end
+            local line, file, source = 0, 0, 0
+            while at <= #data do
+                line = line + read()
+                file = file + read()
+                source = source + read()
+                map[line] = { files[file], source }
+            end
+            return map[key]
+        end })
+    end,` : ""}
     records = {},${several ? `
     -- The file each module outside this one is in, as \`load\` is handed it.
     files = { ${files} },
-    loaded = {},
+    loaded = {},${mapping ? `
     -- Every file's line map: by the module, and by the file's name.
     maps = {},
-    sources = {},
+    sources = {},` : ""}
     -- Another of the bundle's files: a function that adds its modules here.
     load = function(file)
         if ${G}.loaded[file] then

package/dist/index.d.cts

@@ -22,6 +22,9 @@ interface TiluaConfigJson {
     noLib?: boolean;
     /** Leave out of the bundle what the entry never reaches (`treeShake`). */
     treeShaking?: boolean;
+    /** Write the map from the bundle's lines back to the project's, which
+     *  error reports and `console` read. Default: true. */
+    lineMap?: boolean;
 }
 /** A config file's path, or the config itself. Relative paths — to a config
  *  file, and inside an inline config — resolve from `cwd`. */
@@ -51,6 +54,10 @@ interface BundleOptions {
     /** Leave out what the entry never reaches. Overrides the config's
      *  `treeShaking`; off without either. */
     readonly treeShaking?: boolean;
+    /** Write the map from the bundle's lines back to the project's. Overrides
+     *  the config's `lineMap`; on without either. Without it an error names
+     *  the bundle's lines, and the entry does not run under `xpcall`. */
+    readonly lineMap?: boolean;
     /** What the entry's file is called: `main.luau`. The other files of
      *  `"chunks"` are named after it (`main_shop.luau`), and every file takes
      *  its extension. Default: the entry's own name, with `.luau`. */

package/dist/index.d.ts

@@ -22,6 +22,9 @@ interface TiluaConfigJson {
     noLib?: boolean;
     /** Leave out of the bundle what the entry never reaches (`treeShake`). */
     treeShaking?: boolean;
+    /** Write the map from the bundle's lines back to the project's, which
+     *  error reports and `console` read. Default: true. */
+    lineMap?: boolean;
 }
 /** A config file's path, or the config itself. Relative paths — to a config
  *  file, and inside an inline config — resolve from `cwd`. */
@@ -51,6 +54,10 @@ interface BundleOptions {
     /** Leave out what the entry never reaches. Overrides the config's
      *  `treeShaking`; off without either. */
     readonly treeShaking?: boolean;
+    /** Write the map from the bundle's lines back to the project's. Overrides
+     *  the config's `lineMap`; on without either. Without it an error names
+     *  the bundle's lines, and the entry does not run under `xpcall`. */
+    readonly lineMap?: boolean;
     /** What the entry's file is called: `main.luau`. The other files of
      *  `"chunks"` are named after it (`main_shop.luau`), and every file takes
      *  its extension. Default: the entry's own name, with `.luau`. */

package/dist/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tilua/compiler",
-  "version": "8.0.0",
+  "version": "8.1.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": "^8.0.0"
+    "@tilua/parser": "^8.1.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.2",