@defold-typescript/transpiler 0.35.0 → 0.37.0

package/dist/companion-closure.d.ts

@@ -0,0 +1,57 @@
+import * as ts from "typescript";
+/**
+ * The exports-table field a companion exposes its private members on. Reserving
+ * one name keeps the field collision-safe without mangling every internal name,
+ * which is why a source exporting it is rejected rather than shadowed.
+ */
+export declare const COMPANION_INTERNAL_FIELD = "____closure";
+export type ClosureViolationKind = "shared-mutable" | "initialization-order" | "reserved-internal-name";
+export interface ClosureSite {
+    /** What this position is — the phrase the message uses for it. */
+    readonly role: string;
+    /** 1-based. */
+    readonly line: number;
+    /** 1-based. */
+    readonly column: number;
+}
+export interface ClosureViolation {
+    readonly kind: ClosureViolationKind;
+    /** The declaration the split cannot preserve. */
+    readonly member: string;
+    readonly sites: readonly ClosureSite[];
+    readonly message: string;
+}
+export interface CompanionClosure {
+    /** Top-level declarations that would move into the companion, in source order. */
+    readonly members: readonly string[];
+    /** The runtime value exports that open the companion, in source order. */
+    readonly exports: readonly string[];
+    /** Members outside `exports` the script still references, in source order. */
+    readonly internals: readonly string[];
+    /**
+     * The top-level statements carrying those members, in source order. A
+     * statement, not a name, is what the emit actually moves: one `const a = 1, b
+     * = 2;` is two members and one unit of code.
+     */
+    readonly statements: readonly ts.Statement[];
+    /**
+     * Import bindings the closure reaches, in source order. An import is copyable
+     * rather than movable — its statement never appears in `statements` — so the
+     * companion takes its own `require` of the same module instead.
+     */
+    readonly importBindings: readonly string[];
+    /** Shapes a split cannot preserve. Empty means the source is splittable. */
+    readonly violations: readonly ClosureViolation[];
+}
+/**
+ * Which of a script-kind source's top-level declarations would move into a
+ * companion module, and the shapes a split cannot preserve.
+ *
+ * The companion holds the transitive closure of top-level declarations
+ * reachable from the source's runtime value exports; everything else stays in
+ * the script and runs there once. Two shapes break that split — a binding
+ * reassigned on one side and read on the other, which a Lua local cannot carry,
+ * and effectful top-level work the split would reorder — and both are reported
+ * against the source rather than emitted.
+ */
+export declare function computeCompanionClosure(sourceFile: ts.SourceFile, checker: ts.TypeChecker): CompanionClosure;

package/dist/companion-emit.d.ts

@@ -0,0 +1,21 @@
+import { type Plugin } from "typescript-to-lua";
+export interface CompanionEmitter {
+    readonly plugin: Plugin;
+    /**
+     * Companion Lua by source file name, for the sources that produced one. Read
+     * after a transpile; a source absent from it emits a single chunk.
+     */
+    readonly companions: ReadonlyMap<string, string>;
+}
+/**
+ * Splits a script-kind source that exports runtime values into two chunks: a
+ * companion module holding the dependency closure of those exports, and the
+ * script, which requires it rather than redeclaring it. One definition then
+ * serves the script's own hooks and every importer, which is what makes a
+ * mutable export the same table on both sides.
+ *
+ * A factory rather than a shared constant: the captured chunks belong to one
+ * transpile, and a module-level plugin would leak them between the editor
+ * session's rebuilds.
+ */
+export declare function createCompanionEmitPlugin(): CompanionEmitter;

package/dist/emitted-requires.d.ts

@@ -0,0 +1,7 @@
+export declare const LUALIB_REQUIRE_NAME = "lualib_bundle";
+/**
+ * The distinct string-literal module paths an emitted Lua chunk requires, in
+ * source order. The two generated runtimes are skipped, as is any require whose
+ * argument is not a string literal — neither can name a source the build owns.
+ */
+export declare function findEmittedRequires(lua: string): string[];

package/dist/index.d.ts

@@ -1,6 +1,9 @@
+export type { ClosureSite, ClosureViolation, ClosureViolationKind, CompanionClosure, } from "./companion-closure";
+export { COMPANION_INTERNAL_FIELD, computeCompanionClosure } from "./companion-closure";
 export type { ComponentAnimationIndex } from "./component-animation-index";
 export { buildComponentAnimationIndex, componentIdOfSameObjectAddress, } from "./component-animation-index";
 export { buildConfigKeyIndex, readGameProjectSetting } from "./config-key-index";
+export { findEmittedRequires, LUALIB_REQUIRE_NAME } from "./emitted-requires";
 export type { GuiFlipbookIndex } from "./gui-flipbook-index";
 export { buildGuiFlipbookIndex } from "./gui-flipbook-index";
 export type { GuiNodeIndex } from "./gui-node-index";
@@ -10,9 +13,10 @@ export type { ExtensionDependency, LibraryIncludedEntries, LibrarySceneDocument,
 export { archiveWrapperOf, isContainedResourcePath, LIBRARY_DEPENDENCY_ROOT, libraryIncludedEntries, readGameProjectDependencies, readLibrarySceneDocuments, } from "./library-dependencies";
 export { findMainEntryFactoryImports } from "./main-entry-factory-imports";
 export type { BuildConfig, ScriptKind, SourceOutputKind } from "./output-paths";
-export { computeOutputRel, DEFAULT_INCLUDE, parseBuildConfig, SCRIPT_SUFFIX_BY_KIND, stripIncludeBase, } from "./output-paths";
+export { computeOutputRel, DEFAULT_INCLUDE, parseBuildConfig, projectRelativeBase, requirePathForRel, SCRIPT_SUFFIX_BY_KIND, stripIncludeBase, } from "./output-paths";
 export { getProgramDiagnostics } from "./program-diagnostics";
 export { isDefignoredPath, SCAFFOLDED_DEFIGNORE_LINES } from "./project-resources";
+export { rewriteEmittedRequires } from "./require-rewrite";
 export { buildSceneAddressDeclaration } from "./scene-address-declaration";
 export type { SceneCollectionRoles, SceneCollectionRolesInput } from "./scene-collection-roles";
 export { buildSceneCollectionRoles } from "./scene-collection-roles";
@@ -28,6 +32,7 @@ export type { SceneMessage } from "./scene-text-format";
 export { parseSceneTextFormat, SceneTextFormatError } from "./scene-text-format";
 export type { TranspileSession } from "./session";
 export { createTranspileSession } from "./session";
+export { TIMERS_REQUIRE_NAME } from "./timers-runtime";
 export type { TranspileDiagnostic, TranspileProjectInput, TranspileProjectResult, TranspileResult, } from "./transpile";
 export { transpile, transpileProject } from "./transpile";
 export type { ClassifiedSlot } from "./url-address-slots";