@defold-typescript/transpiler 0.50.1 → 0.52.0

package/dist/index.js

@@ -172,22 +172,26 @@ var FACTORY_SPECIFIERS = new Set([
   `${FACTORY_MODULE}/gui-script`,
   `${FACTORY_MODULE}/render-script`
 ]);
-function resolvesToFactoryExport(callee, checker) {
+function factoryExportName(callee, checker) {
   let symbol = checker.getSymbolAtLocation(callee);
   if (symbol === undefined) {
-    return false;
+    return;
   }
   if (symbol.flags & ts2.SymbolFlags.Alias) {
     symbol = checker.getAliasedSymbol(symbol);
   }
-  if (!FACTORY_NAMES.has(symbol.getName())) {
-    return false;
+  const name = symbol.getName();
+  if (!FACTORY_NAMES.has(name)) {
+    return;
   }
   const declaration = symbol.valueDeclaration ?? symbol.declarations?.[0];
   if (declaration === undefined) {
-    return false;
+    return;
   }
-  return declaration.getSourceFile().fileName.includes(FACTORY_MODULE);
+  return declaration.getSourceFile().fileName.includes(FACTORY_MODULE) ? name : undefined;
+}
+function resolvesToFactoryExport(callee, checker) {
+  return factoryExportName(callee, checker) !== undefined;
 }
 function isThisParameter2(param) {
   return ts2.isIdentifier(param.name) && ts2.identifierToKeywordKind(param.name) === ts2.SyntaxKind.ThisKeyword;
@@ -270,6 +274,15 @@ function emitInitMerge(fn, context, property) {
   const initFn = createFunctionExpression2(createBlock2([stateDecl, guard]), [createIdentifier2("self")], undefined, NodeFlags2.Declaration, fn);
   return [builderDecl, createAssignmentStatement(createIdentifier2("init"), initFn, property)];
 }
+var RESOURCE_PROPERTY_MARKERS = new Set([
+  "resource.atlas",
+  "resource.buffer",
+  "resource.font",
+  "resource.material",
+  "resource.render_target",
+  "resource.texture",
+  "resource.tile_source"
+]);
 function propertyMembers(property) {
   if (!ts2.isPropertyAssignment(property) || !ts2.isObjectLiteralExpression(property.initializer)) {
     return [];
@@ -306,11 +319,108 @@ function isPropertiesHook(property) {
 function emitPropertyRegistrations(property, context) {
   return propertyMembers(property).map(({ name, initializer }) => createExpressionStatement(createCallExpression2(createTableIndexExpression(createIdentifier2("go"), createStringLiteral2("property")), [createStringLiteral2(name), context.transformExpression(initializer)])));
 }
+function scriptOnlyProperties(property, factory) {
+  const file = property.getSourceFile();
+  const start = property.getStart(file);
+  return {
+    file,
+    start,
+    length: property.getEnd() - start,
+    category: ts2.DiagnosticCategory.Error,
+    code: 0,
+    messageText: `\`${factory}\` cannot declare \`properties\`: Defold builds \`go.property\` only in \`.script\` files. Declare the property in a \`defineScript\` and send its value with \`msg.post\`.`
+  };
+}
+function outermostWrapper(node) {
+  let current = node;
+  while (ts2.isParenthesizedExpression(current.parent) || ts2.isAsExpression(current.parent) || ts2.isSatisfiesExpression(current.parent) || ts2.isNonNullExpression(current.parent) || ts2.isTypeAssertionExpression(current.parent)) {
+    current = current.parent;
+  }
+  return current;
+}
+function innermostExpression(node) {
+  let current = node;
+  while (ts2.isParenthesizedExpression(current) || ts2.isAsExpression(current) || ts2.isSatisfiesExpression(current) || ts2.isNonNullExpression(current) || ts2.isTypeAssertionExpression(current)) {
+    current = current.expression;
+  }
+  return current;
+}
+function globalName(symbol, checker) {
+  if (symbol === undefined) {
+    return;
+  }
+  const fqn = checker.getFullyQualifiedName(symbol);
+  return fqn.startsWith("global.") ? fqn.slice("global.".length) : undefined;
+}
+function calledGlobal(call, checker) {
+  const declaration = checker.getResolvedSignature(call)?.declaration;
+  if (declaration === undefined || !ts2.isFunctionDeclaration(declaration) || declaration.name === undefined) {
+    return;
+  }
+  return globalName(checker.getSymbolAtLocation(declaration.name), checker);
+}
+function isPropertyDefault(call, checker) {
+  const value = outermostWrapper(call);
+  const parent = value.parent;
+  if (ts2.isCallExpression(parent)) {
+    return parent.arguments[1] === value && calledGlobal(parent, checker) === "go.property";
+  }
+  const properties = parent?.parent?.parent;
+  if (properties === undefined || !ts2.isPropertyAssignment(properties) || !isPropertiesHook(properties)) {
+    return false;
+  }
+  const hooks = properties.parent;
+  return ts2.isObjectLiteralExpression(hooks) && factoryHooks(hooks.parent, checker) === hooks && propertyMembers(properties).some((member) => member.initializer === value);
+}
+function misplacedMarker(node, marker) {
+  const file = node.getSourceFile();
+  const start = node.getStart(file);
+  return {
+    file,
+    start,
+    length: node.getEnd() - start,
+    category: ts2.DiagnosticCategory.Error,
+    code: 0,
+    messageText: `\`${marker}\` is a build-time marker: Defold's build reads it only in a \`go.property\` default, and the engine binds no such function. Use it as a \`defineScript\` \`properties\` default.`
+  };
+}
+function readsAsMarker(call) {
+  const callee = innermostExpression(call.expression);
+  if (ts2.isOptionalChain(call) || ts2.isOptionalChain(callee)) {
+    return false;
+  }
+  if (!ts2.isPropertyAccessExpression(callee) && !(ts2.isElementAccessExpression(callee) && ts2.isStringLiteralLike(innermostExpression(callee.argumentExpression)))) {
+    return false;
+  }
+  const receiver = innermostExpression(callee.expression);
+  if (!ts2.isIdentifier(receiver) || receiver.text !== "resource") {
+    return false;
+  }
+  const [path] = call.arguments;
+  return path === undefined || ts2.isStringLiteralLike(innermostExpression(path));
+}
+function unreadableMarker(node, marker) {
+  const file = node.getSourceFile();
+  const start = node.getStart(file);
+  return {
+    file,
+    start,
+    length: node.getEnd() - start,
+    category: ts2.DiagnosticCategory.Error,
+    code: 0,
+    messageText: `\`${marker}\` in a property default must be written \`${marker}("<path>")\`, with a string literal path: Defold's build reads no other form.`
+  };
+}
+function isCallee(node) {
+  const callee = outermostWrapper(node);
+  return ts2.isCallExpression(callee.parent) && callee.parent.expression === callee;
+}
 function eraseFactoryCall(expression, context) {
   const hooks = factoryHooks(expression, context.checker);
-  if (hooks === undefined) {
+  if (hooks === undefined || !ts2.isCallExpression(expression)) {
     return;
   }
+  const factory = factoryExportName(expression.expression, context.checker);
   const registrations = [];
   const statements = [];
   for (const property of hooks.properties) {
@@ -319,7 +429,11 @@ function eraseFactoryCall(expression, context) {
       continue;
     }
     if (name === "properties") {
-      registrations.push(...emitPropertyRegistrations(property, context));
+      if (factory === "defineScript") {
+        registrations.push(...emitPropertyRegistrations(property, context));
+      } else if (factory !== undefined && propertyMembers(property).length > 0) {
+        context.diagnostics.push(scriptOnlyProperties(property, factory));
+      }
       continue;
     }
     const fn = hookFunction(property);
@@ -373,7 +487,37 @@ var lifecycleErasurePlugin = {
       }
       return context.superTransformStatements(node);
     },
-    [ts2.SyntaxKind.ImportDeclaration]: (node, context) => isFactoryOnlyImport(node) ? [] : context.superTransformStatements(node)
+    [ts2.SyntaxKind.ImportDeclaration]: (node, context) => isFactoryOnlyImport(node) ? [] : context.superTransformStatements(node),
+    [ts2.SyntaxKind.CallExpression]: (node, context) => {
+      const marker = node.parent === undefined ? undefined : calledGlobal(node, context.checker);
+      if (marker !== undefined && RESOURCE_PROPERTY_MARKERS.has(marker)) {
+        if (!isPropertyDefault(node, context.checker)) {
+          context.diagnostics.push(misplacedMarker(node, marker));
+        } else if (!readsAsMarker(node)) {
+          context.diagnostics.push(unreadableMarker(node, marker));
+        }
+      }
+      return context.superTransformExpression(node);
+    },
+    [ts2.SyntaxKind.PropertyAccessExpression]: (node, context) => {
+      if (node.parent !== undefined && !isCallee(node)) {
+        const marker = globalName(context.checker.getSymbolAtLocation(node.name), context.checker);
+        if (marker !== undefined && RESOURCE_PROPERTY_MARKERS.has(marker)) {
+          context.diagnostics.push(misplacedMarker(node, marker));
+        }
+      }
+      return context.superTransformExpression(node);
+    },
+    [ts2.SyntaxKind.ElementAccessExpression]: (node, context) => {
+      if (node.parent !== undefined && !isCallee(node)) {
+        const key = innermostExpression(node.argumentExpression);
+        const marker = ts2.isStringLiteralLike(key) ? globalName(context.checker.getPropertyOfType(context.checker.getTypeAtLocation(node.expression), key.text), context.checker) : undefined;
+        if (marker !== undefined && RESOURCE_PROPERTY_MARKERS.has(marker)) {
+          context.diagnostics.push(misplacedMarker(node, marker));
+        }
+      }
+      return context.superTransformExpression(node);
+    }
   }
 };
 
@@ -2225,7 +2369,7 @@ function computeOutputRel(rel, config, kind) {
   return baseRel.replace(/\.ts$/, SCRIPT_SUFFIX_BY_KIND[kind]);
 }
 // src/program-diagnostics.ts
-import * as ts10 from "typescript";
+import * as ts11 from "typescript";
 import * as tstl from "typescript-to-lua";
 
 // src/message-guard-lowering.ts
@@ -2269,38 +2413,81 @@ var messageGuardLoweringPlugin = {
   }
 };
 
-// src/timers-lowering.ts
+// src/physics-event-guard-lowering.ts
 import * as ts7 from "typescript";
+import {
+  createBinaryExpression as createBinaryExpression4,
+  createCallExpression as createCallExpression4,
+  createIdentifier as createIdentifier4,
+  createStringLiteral as createStringLiteral3,
+  createTableIndexExpression as createTableIndexExpression2,
+  SyntaxKind as SyntaxKind10
+} from "typescript-to-lua";
+var GUARD_MODULE2 = "@defold-typescript/types";
+var GUARD_NAME2 = "isPhysicsEvent";
+function resolvesToGuardExport2(callee, checker) {
+  let symbol = checker.getSymbolAtLocation(callee);
+  if (symbol === undefined) {
+    return false;
+  }
+  if (symbol.flags & ts7.SymbolFlags.Alias) {
+    symbol = checker.getAliasedSymbol(symbol);
+  }
+  if (symbol.getName() !== GUARD_NAME2) {
+    return false;
+  }
+  const declaration = symbol.valueDeclaration ?? symbol.declarations?.[0];
+  if (declaration === undefined) {
+    return false;
+  }
+  return declaration.getSourceFile().fileName.includes(GUARD_MODULE2);
+}
+var physicsEventGuardLoweringPlugin = {
+  visitors: {
+    [ts7.SyntaxKind.CallExpression]: (node, context) => {
+      const [eventArg, nameArg] = node.arguments;
+      if (node.arguments.length === 2 && eventArg !== undefined && nameArg !== undefined && resolvesToGuardExport2(node.expression, context.checker)) {
+        const event = context.transformExpression(eventArg);
+        const name = context.transformExpression(nameArg);
+        return createBinaryExpression4(createTableIndexExpression2(event, createStringLiteral3("type")), createCallExpression4(createIdentifier4("hash"), [name]), SyntaxKind10.EqualityOperator, node);
+      }
+      return context.superTransformExpression(node);
+    }
+  }
+};
+
+// src/timers-lowering.ts
+import * as ts8 from "typescript";
 import { LuaLibFeature as LuaLibFeature2 } from "typescript-to-lua";
 function isTimersSpecifier(node) {
-  return ts7.isStringLiteral(node) && node.text === TIMERS_MODULE_SPECIFIER;
+  return ts8.isStringLiteral(node) && node.text === TIMERS_MODULE_SPECIFIER;
 }
 function importsTimersModule(sourceFile) {
-  return sourceFile.statements.some((statement) => ts7.isImportDeclaration(statement) && isTimersSpecifier(statement.moduleSpecifier));
+  return sourceFile.statements.some((statement) => ts8.isImportDeclaration(statement) && isTimersSpecifier(statement.moduleSpecifier));
 }
 var TIMERS_REQUIRE_PATH = `@NoResolution:${TIMERS_REQUIRE_NAME}`;
 var timersLoweringPlugin = {
   visitors: {
-    [ts7.SyntaxKind.ImportDeclaration]: (node, context) => {
+    [ts8.SyntaxKind.ImportDeclaration]: (node, context) => {
       if (!isTimersSpecifier(node.moduleSpecifier)) {
         return context.superTransformStatements(node);
       }
       context.usedLuaLibFeatures.add(LuaLibFeature2.Promise);
       context.usedLuaLibFeatures.add(LuaLibFeature2.New);
-      const rewritten = ts7.factory.updateImportDeclaration(node, node.modifiers, node.importClause, ts7.factory.createStringLiteral(TIMERS_REQUIRE_PATH), node.attributes);
+      const rewritten = ts8.factory.updateImportDeclaration(node, node.modifiers, node.importClause, ts8.factory.createStringLiteral(TIMERS_REQUIRE_PATH), node.attributes);
       return context.superTransformStatements(rewritten);
     }
   }
 };
 
 // src/type-application-erasure.ts
-import * as ts8 from "typescript";
+import * as ts9 from "typescript";
 var TYPE_APPLICATION_APIS = new Set(["go.get", "go.set"]);
 function isTypeApplication(call, checker) {
   if (call.arguments.length !== 0)
     return false;
   const declaration = checker.getResolvedSignature(call)?.declaration;
-  if (declaration === undefined || !ts8.isFunctionDeclaration(declaration))
+  if (declaration === undefined || !ts9.isFunctionDeclaration(declaration))
     return false;
   if (declaration.parameters.length !== 0 || declaration.typeParameters === undefined)
     return false;
@@ -2314,7 +2501,7 @@ function isTypeApplication(call, checker) {
 }
 var typeApplicationErasurePlugin = {
   visitors: {
-    [ts8.SyntaxKind.CallExpression]: (node, context) => {
+    [ts9.SyntaxKind.CallExpression]: (node, context) => {
       if (isTypeApplication(node, context.checker)) {
         return context.transformExpression(node.expression);
       }
@@ -2324,38 +2511,38 @@ var typeApplicationErasurePlugin = {
 };
 
 // src/window-event-guard-lowering.ts
-import * as ts9 from "typescript";
+import * as ts10 from "typescript";
 import {
-  createBinaryExpression as createBinaryExpression4,
-  SyntaxKind as SyntaxKind12
+  createBinaryExpression as createBinaryExpression5,
+  SyntaxKind as SyntaxKind14
 } from "typescript-to-lua";
-var GUARD_MODULE2 = "@defold-typescript/types";
-var GUARD_NAME2 = "isWindowEvent";
-function resolvesToGuardExport2(callee, checker) {
+var GUARD_MODULE3 = "@defold-typescript/types";
+var GUARD_NAME3 = "isWindowEvent";
+function resolvesToGuardExport3(callee, checker) {
   let symbol = checker.getSymbolAtLocation(callee);
   if (symbol === undefined) {
     return false;
   }
-  if (symbol.flags & ts9.SymbolFlags.Alias) {
+  if (symbol.flags & ts10.SymbolFlags.Alias) {
     symbol = checker.getAliasedSymbol(symbol);
   }
-  if (symbol.getName() !== GUARD_NAME2) {
+  if (symbol.getName() !== GUARD_NAME3) {
     return false;
   }
   const declaration = symbol.valueDeclaration ?? symbol.declarations?.[0];
   if (declaration === undefined) {
     return false;
   }
-  return declaration.getSourceFile().fileName.includes(GUARD_MODULE2);
+  return declaration.getSourceFile().fileName.includes(GUARD_MODULE3);
 }
 var windowEventGuardLoweringPlugin = {
   visitors: {
-    [ts9.SyntaxKind.CallExpression]: (node, context) => {
+    [ts10.SyntaxKind.CallExpression]: (node, context) => {
       const [eventArg, , expectedArg] = node.arguments;
-      if (node.arguments.length === 3 && eventArg !== undefined && expectedArg !== undefined && resolvesToGuardExport2(node.expression, context.checker)) {
+      if (node.arguments.length === 3 && eventArg !== undefined && expectedArg !== undefined && resolvesToGuardExport3(node.expression, context.checker)) {
         const event = context.transformExpression(eventArg);
         const expected = context.transformExpression(expectedArg);
-        return createBinaryExpression4(event, expected, SyntaxKind12.EqualityOperator, node);
+        return createBinaryExpression5(event, expected, SyntaxKind14.EqualityOperator, node);
       }
       return context.superTransformExpression(node);
     }
@@ -2367,6 +2554,7 @@ var LUA_PLUGINS = [
   lifecycleErasurePlugin,
   messageGuardLoweringPlugin,
   windowEventGuardLoweringPlugin,
+  physicsEventGuardLoweringPlugin,
   messageDispatchLoweringPlugin,
   timersLoweringPlugin,
   typeApplicationErasurePlugin
@@ -2376,7 +2564,7 @@ function isAmbient(fileName) {
   return /[\\/]node_modules[\\/]/.test(fileName) || /(^|[\\/])lib\.[^\\/]*\.d\.ts$/.test(fileName);
 }
 function getProgramDiagnostics(program, sourceFile) {
-  const { diagnostics } = tstl.getProgramTranspileResult(ts10.sys, noopWriteFile, {
+  const { diagnostics } = tstl.getProgramTranspileResult(ts11.sys, noopWriteFile, {
     program,
     plugins: LUA_PLUGINS,
     ...sourceFile ? { sourceFiles: [sourceFile] } : {}
@@ -2947,21 +3135,21 @@ function relativeAddressesFrom(index, context) {
 import { readFileSync as readFileSync2 } from "node:fs";
 import { createRequire as createRequire2 } from "node:module";
 import * as path4 from "node:path";
-import * as ts14 from "typescript";
+import * as ts15 from "typescript";
 import * as tstl3 from "typescript-to-lua";
 
 // src/companion-emit.ts
-import * as ts11 from "typescript";
+import * as ts12 from "typescript";
 import {
   createAssignmentStatement as createAssignmentStatement2,
-  createCallExpression as createCallExpression4,
+  createCallExpression as createCallExpression5,
   createFile,
-  createIdentifier as createIdentifier4,
+  createIdentifier as createIdentifier5,
   createReturnStatement as createReturnStatement2,
-  createStringLiteral as createStringLiteral3,
+  createStringLiteral as createStringLiteral4,
   createTableExpression,
   createTableFieldExpression,
-  createTableIndexExpression as createTableIndexExpression2,
+  createTableIndexExpression as createTableIndexExpression3,
   createVariableDeclarationStatement as createVariableDeclarationStatement3,
   isBlock as isBlock3,
   isCallExpression as isCallExpression4,
@@ -2981,12 +3169,12 @@ import {
 } from "typescript-to-lua";
 var EXPORTS_NAME = "____exports";
 function exportsIdentifier() {
-  return createIdentifier4(EXPORTS_NAME);
+  return createIdentifier5(EXPORTS_NAME);
 }
 function isRuntimeScriptSource(sourceFile, checker) {
   return sourceFile.statements.some((statement) => {
-    const expression = ts11.isExpressionStatement(statement) ? statement.expression : ts11.isExportAssignment(statement) && !statement.isExportEquals ? statement.expression : undefined;
-    return expression !== undefined && ts11.isCallExpression(expression) && resolvesToFactoryExport(expression.expression, checker);
+    const expression = ts12.isExpressionStatement(statement) ? statement.expression : ts12.isExportAssignment(statement) && !statement.isExportEquals ? statement.expression : undefined;
+    return expression !== undefined && ts12.isCallExpression(expression) && resolvesToFactoryExport(expression.expression, checker);
   });
 }
 function planFor(sourceFile, checker) {
@@ -3138,11 +3326,11 @@ function freeNames(statements) {
 function resolvedRequirePaths(sourceFile, checker) {
   const paths = new Map;
   for (const statement of sourceFile.statements) {
-    const specifier = ts11.isImportDeclaration(statement) || ts11.isExportDeclaration(statement) ? statement.moduleSpecifier : undefined;
-    if (specifier === undefined || !ts11.isStringLiteral(specifier)) {
+    const specifier = ts12.isImportDeclaration(statement) || ts12.isExportDeclaration(statement) ? statement.moduleSpecifier : undefined;
+    if (specifier === undefined || !ts12.isStringLiteral(specifier)) {
       continue;
     }
-    const target = checker.getSymbolAtLocation(specifier)?.declarations?.find((declaration) => ts11.isSourceFile(declaration));
+    const target = checker.getSymbolAtLocation(specifier)?.declarations?.find((declaration) => ts12.isSourceFile(declaration));
     if (target === undefined || target.isDeclarationFile) {
       continue;
     }
@@ -3195,7 +3383,7 @@ function withResolvedRequire(statement, paths) {
   if (resolved === argument.value) {
     return statement;
   }
-  return createVariableDeclarationStatement3(createIdentifier4(name.text), createCallExpression4(createIdentifier4("require"), [createStringLiteral3(resolved)]));
+  return createVariableDeclarationStatement3(createIdentifier5(name.text), createCallExpression5(createIdentifier5("require"), [createStringLiteral4(resolved)]));
 }
 function copiedPrelude(halves, importBindings) {
   const needed = new Set(importBindings);
@@ -3248,7 +3436,7 @@ function isHoistedNameDeclaration(statement) {
   return isVariableDeclarationStatement(statement) && statement.right === undefined;
 }
 function internalsField(name) {
-  return createTableIndexExpression2(createTableIndexExpression2(exportsIdentifier(), createStringLiteral3(COMPANION_INTERNAL_FIELD)), createStringLiteral3(name));
+  return createTableIndexExpression3(createTableIndexExpression3(exportsIdentifier(), createStringLiteral4(COMPANION_INTERNAL_FIELD)), createStringLiteral4(name));
 }
 function requireInsertionPoint(script, reads) {
   let index = 0;
@@ -3311,11 +3499,11 @@ function createCompanionEmitPlugin() {
     return statements;
   }
   const visitors = {
-    [ts11.SyntaxKind.VariableStatement]: capture,
-    [ts11.SyntaxKind.FunctionDeclaration]: capture,
-    [ts11.SyntaxKind.ClassDeclaration]: capture,
-    [ts11.SyntaxKind.EnumDeclaration]: capture,
-    [ts11.SyntaxKind.ExportDeclaration]: capture
+    [ts12.SyntaxKind.VariableStatement]: capture,
+    [ts12.SyntaxKind.FunctionDeclaration]: capture,
+    [ts12.SyntaxKind.ClassDeclaration]: capture,
+    [ts12.SyntaxKind.EnumDeclaration]: capture,
+    [ts12.SyntaxKind.ExportDeclaration]: capture
   };
   let configuredNoResolvePaths = [];
   const plugin = {
@@ -3353,13 +3541,13 @@ function emitCompanion(program, emitHost, file, sourceFile, plan, owned, compani
   const halves = split(luaAst.statements, owned);
   const requirePaths = resolvedRequirePaths(sourceFile, program.getTypeChecker());
   resolveMovedRequires(halves.companion, requirePaths);
-  const closureTable = createTableExpression(plan.internals.map((name) => createTableFieldExpression(createIdentifier4(name), createStringLiteral3(name))));
+  const closureTable = createTableExpression(plan.internals.map((name) => createTableFieldExpression(createIdentifier5(name), createStringLiteral4(name))));
   const companionStatements = [
     createVariableDeclarationStatement3(exportsIdentifier(), createTableExpression()),
     ...copiedPrelude(halves, plan.importBindings).map((statement) => withResolvedRequire(statement, requirePaths)),
     ...halves.companion,
     ...plan.internals.length > 0 ? [
-      createAssignmentStatement2(createTableIndexExpression2(exportsIdentifier(), createStringLiteral3(COMPANION_INTERNAL_FIELD)), closureTable)
+      createAssignmentStatement2(createTableIndexExpression3(exportsIdentifier(), createStringLiteral4(COMPANION_INTERNAL_FIELD)), closureTable)
     ] : [],
     createReturnStatement2([exportsIdentifier()])
   ];
@@ -3367,8 +3555,8 @@ function emitCompanion(program, emitHost, file, sourceFile, plan, owned, compani
   const insertAt = requireInsertionPoint(halves.script, reads);
   const scriptStatements = [
     ...halves.script.slice(0, insertAt),
-    createVariableDeclarationStatement3(exportsIdentifier(), createCallExpression4(createIdentifier4("require"), [createStringLiteral3(plan.requirePath)])),
-    ...plan.internals.map((name) => createVariableDeclarationStatement3(createIdentifier4(name), internalsField(name))),
+    createVariableDeclarationStatement3(exportsIdentifier(), createCallExpression5(createIdentifier5("require"), [createStringLiteral4(plan.requirePath)])),
+    ...plan.internals.map((name) => createVariableDeclarationStatement3(createIdentifier5(name), internalsField(name))),
     ...halves.script.slice(insertAt),
     createReturnStatement2([exportsIdentifier()])
   ];
@@ -3384,7 +3572,7 @@ function emitCompanion(program, emitHost, file, sourceFile, plan, owned, compani
 }
 
 // src/editor-script-erasure.ts
-import * as ts12 from "typescript";
+import * as ts13 from "typescript";
 import {
   createReturnStatement as createReturnStatement3
 } from "typescript-to-lua";
@@ -3404,7 +3592,7 @@ function resolveEditorFactoryExport(callee, checker) {
   if (symbol === undefined) {
     return;
   }
-  if (symbol.flags & ts12.SymbolFlags.Alias) {
+  if (symbol.flags & ts13.SymbolFlags.Alias) {
     symbol = checker.getAliasedSymbol(symbol);
   }
   const name = symbol.getName();
@@ -3418,7 +3606,7 @@ function resolveEditorFactoryExport(callee, checker) {
   return declaration.getSourceFile().fileName.includes(EDITOR_FACTORY_MODULE) ? name : undefined;
 }
 function lowerEditorFactoryCall(expression, context) {
-  if (!ts12.isCallExpression(expression)) {
+  if (!ts13.isCallExpression(expression)) {
     return;
   }
   if (resolveEditorFactoryExport(expression.expression, context.checker) !== EDITOR_SCRIPT_FACTORY_NAME) {
@@ -3431,7 +3619,7 @@ function lowerEditorFactoryCall(expression, context) {
   return [createReturnStatement3([context.transformExpression(module)])];
 }
 function isEditorFactoryOnlyImport(node) {
-  if (!ts12.isStringLiteral(node.moduleSpecifier) || !EDITOR_FACTORY_SPECIFIERS.has(node.moduleSpecifier.text)) {
+  if (!ts13.isStringLiteral(node.moduleSpecifier) || !EDITOR_FACTORY_SPECIFIERS.has(node.moduleSpecifier.text)) {
     return false;
   }
   const clause = node.importClause;
@@ -3442,7 +3630,7 @@ function isEditorFactoryOnlyImport(node) {
     return false;
   }
   const bindings = clause.namedBindings;
-  if (bindings === undefined || !ts12.isNamedImports(bindings)) {
+  if (bindings === undefined || !ts13.isNamedImports(bindings)) {
     return false;
   }
   const runtime = bindings.elements.filter((element) => !element.isTypeOnly);
@@ -3453,7 +3641,7 @@ function isEditorFactoryOnlyImport(node) {
 }
 var editorScriptErasurePlugin = {
   visitors: {
-    [ts12.SyntaxKind.ExportAssignment]: (node, context) => {
+    [ts13.SyntaxKind.ExportAssignment]: (node, context) => {
       if (!node.isExportEquals) {
         const lowered = lowerEditorFactoryCall(node.expression, context);
         if (lowered !== undefined) {
@@ -3462,14 +3650,14 @@ var editorScriptErasurePlugin = {
       }
       return context.superTransformStatements(node);
     },
-    [ts12.SyntaxKind.CallExpression]: (node, context) => {
+    [ts13.SyntaxKind.CallExpression]: (node, context) => {
       const command = node.arguments[0];
       if (command !== undefined && resolveEditorFactoryExport(node.expression, context.checker) === EDITOR_COMMAND_FACTORY_NAME) {
         return context.transformExpression(command);
       }
       return context.superTransformExpression(node);
     },
-    [ts12.SyntaxKind.ImportDeclaration]: (node, context) => isEditorFactoryOnlyImport(node) ? [] : context.superTransformStatements(node)
+    [ts13.SyntaxKind.ImportDeclaration]: (node, context) => isEditorFactoryOnlyImport(node) ? [] : context.superTransformStatements(node)
   }
 };
 
@@ -3480,17 +3668,17 @@ import * as path3 from "node:path";
 import * as tstl2 from "typescript-to-lua";
 
 // src/go-property-direct-call.ts
-import * as ts13 from "typescript";
+import * as ts14 from "typescript";
 var GO_PROPERTY_DIRECT_CALL_MESSAGE = "`go.property` called directly is deprecated; declare the property in `defineScript({ properties })` so it types onto `self` (the transpiler emits the registration for you).";
 function findDirectGoPropertyCalls(sourceFile) {
   const calls = [];
   const visit = (node) => {
-    if (ts13.isCallExpression(node) && ts13.isPropertyAccessExpression(node.expression) && node.expression.name.text === "property" && ts13.isIdentifier(node.expression.expression) && node.expression.expression.text === "go") {
+    if (ts14.isCallExpression(node) && ts14.isPropertyAccessExpression(node.expression) && node.expression.name.text === "property" && ts14.isIdentifier(node.expression.expression) && node.expression.expression.text === "go") {
       calls.push(node);
     }
-    ts13.forEachChild(node, visit);
+    ts14.forEachChild(node, visit);
   };
-  ts13.forEachChild(sourceFile, visit);
+  ts14.forEachChild(sourceFile, visit);
   return calls;
 }
 
@@ -3650,6 +3838,7 @@ function collectOutputs(transpiledFiles, diagnostics, userKeys, emittedCompanion
     }
   }
   const hsm = hsmClosure([...Object.values(lua), ...Object.values(companions)], compileHsmModules);
+  const hsmSourceMaps = hsm === undefined ? undefined : selectHsmSourceMaps(Object.keys(hsm));
   return {
     lua,
     sourceMaps,
@@ -3657,9 +3846,21 @@ function collectOutputs(transpiledFiles, diagnostics, userKeys, emittedCompanion
     ...Object.keys(companions).length > 0 ? { companions } : {},
     ...lualib !== undefined ? { lualib } : {},
     ...timersImported ? { timersRuntime: TIMERS_RUNTIME } : {},
-    ...hsm !== undefined ? { hsmModules: hsm } : {}
+    ...hsm !== undefined ? { hsmModules: hsm } : {},
+    ...hsmSourceMaps !== undefined ? { hsmSourceMaps } : {}
   };
 }
+function selectHsmSourceMaps(names) {
+  const maps = compileHsmSourceMaps();
+  const selected = {};
+  for (const name of names) {
+    const map = maps[name];
+    if (map !== undefined) {
+      selected[name] = map;
+    }
+  }
+  return selected;
+}
 function transpileVirtual(files, companionEmit, overrides = {}) {
   return tstl2.transpileVirtualProject({ ...AMBIENT_FILES, ...files }, {
     luaTarget: tstl2.LuaTarget.Lua51,
@@ -3673,6 +3874,7 @@ function transpileVirtual(files, companionEmit, overrides = {}) {
       { plugin: editorScriptErasurePlugin },
       { plugin: messageGuardLoweringPlugin },
       { plugin: windowEventGuardLoweringPlugin },
+      { plugin: physicsEventGuardLoweringPlugin },
       { plugin: messageDispatchLoweringPlugin },
       { plugin: timersLoweringPlugin },
       { plugin: hsmLoweringPlugin },
@@ -3693,6 +3895,12 @@ function requiresLualib(lua) {
   return scanEmittedRequires(lua).some(({ path: requirePath }) => requirePath === "lualib_bundle");
 }
 function compileHsmModules() {
+  return compileHsm().lua;
+}
+function compileHsmSourceMaps() {
+  return compileHsm().sourceMaps;
+}
+function compileHsm() {
   if (compiledHsm !== undefined) {
     return compiledHsm;
   }
@@ -3707,6 +3915,7 @@ function compileHsmModules() {
   const result = transpileVirtual(files, createCompanionEmitPlugin(), { removeComments: true });
   const problems = result.diagnostics.map((d) => `${d.file?.fileName ?? "(project)"}: ${flattenDiagnosticMessage(d.messageText)}`);
   const lua = {};
+  const sourceMaps = {};
   for (const file of result.transpiledFiles) {
     if (isLualibBundle(file)) {
       continue;
@@ -3720,14 +3929,17 @@ function compileHsmModules() {
       problems.push(`the compiled ${name} module requires lualib_bundle`);
     }
     lua[name] = file.lua;
+    if (typeof file.luaSourceMap === "string") {
+      sourceMaps[name] = file.luaSourceMap;
+    }
   }
   if (problems.length > 0) {
     throw new Error(`@defold-typescript/transpiler: the hsm library does not compile:
   ${problems.join(`
   `)}`);
   }
-  compiledHsm = lua;
-  return lua;
+  compiledHsm = { lua, sourceMaps };
+  return compiledHsm;
 }
 function transpile(source) {
   const project = transpileProject({ files: { "main.ts": source } });
@@ -3753,6 +3965,7 @@ function compilerOptions(companionEmit) {
       { plugin: editorScriptErasurePlugin },
       { plugin: messageGuardLoweringPlugin },
       { plugin: windowEventGuardLoweringPlugin },
+      { plugin: physicsEventGuardLoweringPlugin },
       { plugin: messageDispatchLoweringPlugin },
       { plugin: timersLoweringPlugin },
       { plugin: hsmLoweringPlugin },
@@ -3799,7 +4012,7 @@ function createTranspileSession() {
       if (cached) {
         return cached;
       }
-      const created = ts14.createSourceFile(fileName, content, ts14.ScriptTarget.Latest, false);
+      const created = ts15.createSourceFile(fileName, content, ts15.ScriptTarget.Latest, false);
       sourceFileCache.set(normalized, created);
       return created;
     }
@@ -3818,7 +4031,7 @@ function createTranspileSession() {
         return cached;
       }
       const fileContent = readFileSync2(filePath, "utf8");
-      const created = ts14.createSourceFile(filePath, fileContent, ts14.ScriptTarget.Latest, false);
+      const created = ts15.createSourceFile(filePath, fileContent, ts15.ScriptTarget.Latest, false);
       libCache.set(fileName, created);
       return created;
     }
@@ -3831,10 +4044,10 @@ function createTranspileSession() {
     return AMBIENT_FILES[normalized];
   }
   const host = {
-    fileExists: (fileName) => mergedContent(normalizeSlashes(fileName)) !== undefined || ts14.sys.fileExists(fileName),
+    fileExists: (fileName) => mergedContent(normalizeSlashes(fileName)) !== undefined || ts15.sys.fileExists(fileName),
     getCanonicalFileName: (fileName) => fileName,
     getCurrentDirectory: () => "",
-    getDefaultLibFileName: ts14.getDefaultLibFileName,
+    getDefaultLibFileName: ts15.getDefaultLibFileName,
     readFile: () => "",
     getNewLine: () => `
 `,
@@ -3856,15 +4069,15 @@ function createTranspileSession() {
     const userKeys = new Set(userFiles.keys());
     const rootNames = [...Object.keys(AMBIENT_FILES).map(normalizeSlashes), ...userKeys];
     const companionEmit = createCompanionEmitPlugin();
-    program = ts14.createProgram(rootNames, compilerOptions(companionEmit), host, program);
-    const preEmitDiagnostics = ts14.getPreEmitDiagnostics(program);
+    program = ts15.createProgram(rootNames, compilerOptions(companionEmit), host, program);
+    const preEmitDiagnostics = ts15.getPreEmitDiagnostics(program);
     const collector = createOutputCollector();
     const { diagnostics: transpileDiagnostics } = new tstl3.Transpiler().emit({
       program,
       writeFile: collector.writeFile
     });
     const diagnostics = [
-      ...ts14.sortAndDeduplicateDiagnostics([...preEmitDiagnostics, ...transpileDiagnostics])
+      ...ts15.sortAndDeduplicateDiagnostics([...preEmitDiagnostics, ...transpileDiagnostics])
     ];
     return collectOutputs(collector.files, diagnostics, userKeys, companionEmit.companions);
   }
@@ -3874,7 +4087,7 @@ function createTranspileSession() {
   };
 }
 // src/text-script-property.ts
-import * as ts15 from "typescript";
+import * as ts16 from "typescript";
 function findTextScriptProperties(program, fileNames) {
   const checker = program.getTypeChecker();
   const findings = [];
@@ -3885,7 +4098,7 @@ function findTextScriptProperties(program, fileNames) {
     }
     const located = [];
     const visit = (node) => {
-      if (ts15.isCallExpression(node)) {
+      if (ts16.isCallExpression(node)) {
         const hooks = factoryHooks(node, checker);
         for (const property of hooks?.properties ?? []) {
           if (!isPropertiesHook(property)) {
@@ -3898,7 +4111,7 @@ function findTextScriptProperties(program, fileNames) {
           }
         }
       }
-      ts15.forEachChild(node, visit);
+      ts16.forEachChild(node, visit);
     };
     visit(sourceFile);
     for (const call of findDirectGoPropertyCalls(sourceFile)) {
@@ -3907,7 +4120,7 @@ function findTextScriptProperties(program, fileNames) {
         continue;
       }
       if (mayHoldString(checker.getTypeAtLocation(value), checker)) {
-        const name = ts15.isStringLiteralLike(nameArgument) ? nameArgument.text : nameArgument.getText(sourceFile);
+        const name = ts16.isStringLiteralLike(nameArgument) ? nameArgument.text : nameArgument.getText(sourceFile);
         located.push({ name, value });
       }
     }
@@ -3924,20 +4137,20 @@ function mayHoldString(type, checker, visited = new Set) {
     return false;
   }
   visited.add(type);
-  if (type.flags & ts15.TypeFlags.StringLike) {
+  if (type.flags & ts16.TypeFlags.StringLike) {
     return true;
   }
   if (type.isUnionOrIntersection()) {
     return type.types.some((member) => mayHoldString(member, checker, visited));
   }
-  if (type.flags & ts15.TypeFlags.Instantiable) {
+  if (type.flags & ts16.TypeFlags.Instantiable) {
     const constraint = checker.getBaseConstraintOfType(type);
     return constraint !== undefined && constraint !== type ? mayHoldString(constraint, checker, visited) : false;
   }
   return false;
 }
 // src/url-address-slots.ts
-import * as ts16 from "typescript";
+import * as ts17 from "typescript";
 var ADDRESS_CLASSES = {
   "game-object": true,
   component: true,
@@ -3956,7 +4169,7 @@ function isFragmentCaret(slot, position) {
   return slot.fragmentStart !== -1 && position >= slot.fragmentStart;
 }
 function tableKey(checker, callee) {
-  const symbol = checker.getSymbolAtLocation(ts16.isIdentifier(callee) ? callee : callee.name);
+  const symbol = checker.getSymbolAtLocation(ts17.isIdentifier(callee) ? callee : callee.name);
   if (!symbol)
     return;
   const fqn = checker.getFullyQualifiedName(symbol);
@@ -3964,43 +4177,43 @@ function tableKey(checker, callee) {
 }
 function parameterName(checker, call, index) {
   const declaration = checker.getResolvedSignature(call)?.declaration;
-  if (!declaration || !ts16.isFunctionLike(declaration))
+  if (!declaration || !ts17.isFunctionLike(declaration))
     return;
   const parameter = declaration.parameters[index];
-  if (!parameter || parameter.dotDotDotToken || !ts16.isIdentifier(parameter.name))
+  if (!parameter || parameter.dotDotDotToken || !ts17.isIdentifier(parameter.name))
     return;
   return parameter.name.text;
 }
 var EQUALITY_OPERATORS = new Set([
-  ts16.SyntaxKind.EqualsEqualsEqualsToken,
-  ts16.SyntaxKind.ExclamationEqualsEqualsToken,
-  ts16.SyntaxKind.EqualsEqualsToken,
-  ts16.SyntaxKind.ExclamationEqualsToken
+  ts17.SyntaxKind.EqualsEqualsEqualsToken,
+  ts17.SyntaxKind.ExclamationEqualsEqualsToken,
+  ts17.SyntaxKind.EqualsEqualsToken,
+  ts17.SyntaxKind.ExclamationEqualsToken
 ]);
 function comparisonSatisfied(checker, entry, call) {
   if (entry.comparedParameter === undefined)
     return true;
   let node = call;
-  while (ts16.isParenthesizedExpression(node.parent))
+  while (ts17.isParenthesizedExpression(node.parent))
     node = node.parent;
   const comparison = node.parent;
-  if (!ts16.isBinaryExpression(comparison))
+  if (!ts17.isBinaryExpression(comparison))
     return false;
   if (!EQUALITY_OPERATORS.has(comparison.operatorToken.kind))
     return false;
   const other = comparison.left === node ? comparison.right : comparison.left;
   const symbol = checker.getSymbolAtLocation(other);
-  return (symbol?.declarations ?? []).some((declaration) => ts16.isParameter(declaration) && ts16.isIdentifier(declaration.name) && declaration.name.text === entry.comparedParameter);
+  return (symbol?.declarations ?? []).some((declaration) => ts17.isParameter(declaration) && ts17.isIdentifier(declaration.name) && declaration.name.text === entry.comparedParameter);
 }
 function classifiedEntryOfArgument(checker, table, argument) {
   const call = argument.parent;
-  if (!ts16.isCallExpression(call))
+  if (!ts17.isCallExpression(call))
     return;
   const argumentIndex = call.arguments.indexOf(argument);
   if (argumentIndex === -1)
     return;
   const callee = call.expression;
-  if (!ts16.isPropertyAccessExpression(callee) && !ts16.isIdentifier(callee))
+  if (!ts17.isPropertyAccessExpression(callee) && !ts17.isIdentifier(callee))
     return;
   const fqn = tableKey(checker, callee);
   if (fqn === undefined)
@@ -4017,10 +4230,10 @@ function classifiedEntryOfArgument(checker, table, argument) {
 }
 function slotThroughHashedCall(checker, table, literal) {
   const call = literal.parent;
-  if (!ts16.isCallExpression(call))
+  if (!ts17.isCallExpression(call))
     return;
   const callee = call.expression;
-  if (!ts16.isPropertyAccessExpression(callee) && !ts16.isIdentifier(callee))
+  if (!ts17.isPropertyAccessExpression(callee) && !ts17.isIdentifier(callee))
     return;
   if (tableKey(checker, callee) !== "hash")
     return;
@@ -4038,24 +4251,24 @@ function addressTextOf(checker, entry, call) {
   if (entry.addressParameter === undefined)
     return;
   const declaration = checker.getResolvedSignature(call)?.declaration;
-  if (!declaration || !ts16.isFunctionLike(declaration))
+  if (!declaration || !ts17.isFunctionLike(declaration))
     return;
-  const index = declaration.parameters.findIndex((parameter) => !parameter.dotDotDotToken && ts16.isIdentifier(parameter.name) && parameter.name.text === entry.addressParameter);
+  const index = declaration.parameters.findIndex((parameter) => !parameter.dotDotDotToken && ts17.isIdentifier(parameter.name) && parameter.name.text === entry.addressParameter);
   if (index === -1)
     return;
   const argument = call.arguments[index];
-  return argument && ts16.isStringLiteralLike(argument) ? argument.text : undefined;
+  return argument && ts17.isStringLiteralLike(argument) ? argument.text : undefined;
 }
 function innermostLiteralAt(sourceFile, position) {
   let found;
   const visit = (node) => {
     if (position < node.getStart(sourceFile) || position > node.getEnd())
       return;
-    if (ts16.isStringLiteralLike(node))
+    if (ts17.isStringLiteralLike(node))
       found = node;
-    ts16.forEachChild(node, visit);
+    ts17.forEachChild(node, visit);
   };
-  ts16.forEachChild(sourceFile, visit);
+  ts17.forEachChild(sourceFile, visit);
   return found;
 }
 function resolveClassifiedSlotAtPosition(input) {
@@ -4089,23 +4302,23 @@ function resolveClassifiedSlotAtPosition(input) {
   };
 }
 // src/url-cross-world-address.ts
-import * as ts18 from "typescript";
+import * as ts19 from "typescript";
 
 // src/url-address-literals.ts
-import * as ts17 from "typescript";
+import * as ts18 from "typescript";
 function isAmbient2(fileName) {
   return /[\\/]node_modules[\\/]/.test(fileName) || /(^|[\\/])lib\.[^\\/]*\.d\.ts$/.test(fileName);
 }
 function referenceTargetSymbol(type) {
-  if ((type.flags & ts17.TypeFlags.Object) === 0)
+  if ((type.flags & ts18.TypeFlags.Object) === 0)
     return;
-  if ((type.objectFlags & ts17.ObjectFlags.Reference) === 0)
+  if ((type.objectFlags & ts18.ObjectFlags.Reference) === 0)
     return;
   return type.target.symbol;
 }
 function ambientHashAliasTargets(checker, anchor) {
   const targets = new Set;
-  for (const symbol of checker.getSymbolsInScope(anchor, ts17.SymbolFlags.Type)) {
+  for (const symbol of checker.getSymbolsInScope(anchor, ts18.SymbolFlags.Type)) {
     if (symbol.name !== "Hash")
       continue;
     const target = referenceTargetSymbol(checker.getDeclaredTypeOfSymbol(symbol));
@@ -4121,7 +4334,7 @@ function canonicalHashSymbols(checker, program) {
   if (!anchor)
     return canonical;
   const aliased = ambientHashAliasTargets(checker, anchor);
-  for (const symbol of checker.getSymbolsInScope(anchor, ts17.SymbolFlags.Function)) {
+  for (const symbol of checker.getSymbolsInScope(anchor, ts18.SymbolFlags.Function)) {
     if (symbol.name !== "hash")
       continue;
     const declaration = symbol.declarations?.[0];
@@ -4143,7 +4356,7 @@ function hashedSourceOfType(checker, type, canonical) {
   return source?.isStringLiteral() ? source.value : undefined;
 }
 function staticAddressTextOf(checker, node, canonical) {
-  return ts17.isStringLiteralLike(node) ? node.text : hashedSourceOfType(checker, checker.getTypeAtLocation(node), canonical);
+  return ts18.isStringLiteralLike(node) ? node.text : hashedSourceOfType(checker, checker.getTypeAtLocation(node), canonical);
 }
 
 // src/url-cross-world-address.ts
@@ -4167,7 +4380,7 @@ function checkCrossWorldAddresses(input) {
     if (worlds.length === 0)
       continue;
     const visit = (node) => {
-      if (ts18.isExpression(node)) {
+      if (ts19.isExpression(node)) {
         const entry = addressEntryOfArgument(checker, table, node);
         if (entry !== undefined && slotRejectsForeignSocket(entry)) {
           const address = staticAddressTextOf(checker, node, canonical);
@@ -4184,14 +4397,14 @@ function checkCrossWorldAddresses(input) {
           }
         }
       }
-      ts18.forEachChild(node, visit);
+      ts19.forEachChild(node, visit);
     };
-    ts18.forEachChild(sourceFile, visit);
+    ts19.forEachChild(sourceFile, visit);
   }
   return findings;
 }
 // src/url-fragment-reachability.ts
-import * as ts19 from "typescript";
+import * as ts20 from "typescript";
 function pathOfKey(key) {
   const socket = socketOfAddress(key);
   return socket === undefined ? key : key.slice(socket.length + 1);
@@ -4236,7 +4449,7 @@ function checkUrlFragmentReachability(input) {
     if (isAmbient2(sourceFile.fileName))
       continue;
     const visit = (node) => {
-      if (ts19.isExpression(node) && isAddressClass(addressClassOfArgument(checker, table, node))) {
+      if (ts20.isExpression(node) && isAddressClass(addressClassOfArgument(checker, table, node))) {
         const text = staticAddressTextOf(checker, node, canonical);
         if (text !== undefined) {
           const hash = text.indexOf("#");
@@ -4255,9 +4468,9 @@ function checkUrlFragmentReachability(input) {
           }
         }
       }
-      ts19.forEachChild(node, visit);
+      ts20.forEachChild(node, visit);
     };
-    ts19.forEachChild(sourceFile, visit);
+    ts20.forEachChild(sourceFile, visit);
   }
   return { kind: "checked", findings };
 }
@@ -4333,6 +4546,7 @@ export {
   resolveClassifiedSlotAtPosition,
   resolveHsmSourceDir,
   rewriteEmittedRequires,
+  scanEmittedRequires,
   slotRejectsForeignSocket,
   socketOfAddress,
   stripIncludeBase,