@defold-typescript/types 0.53.0 → 0.54.0

package/fixtures/defold-1.14.0/window_doc.json

@@ -0,0 +1,426 @@
+{
+  "elements": [
+    {
+      "type": "ENUM",
+      "name": "window.DIMMING",
+      "brief": "Screen-dimming modes",
+      "description": "Screen-dimming modes",
+      "returnvalues": [],
+      "parameters": [],
+      "examples": "",
+      "replaces": "",
+      "error": "",
+      "tparams": [],
+      "members": [
+        {
+          "name": "window.DIMMING_OFF",
+          "doc": "dimming mode off Dimming mode is used to control whether or not a mobile device should dim the screen after a period without user interaction.",
+          "type": ""
+        },
+        {
+          "name": "window.DIMMING_ON",
+          "doc": "dimming mode on Dimming mode is used to control whether or not a mobile device should dim the screen after a period without user interaction.",
+          "type": ""
+        },
+        {
+          "name": "window.DIMMING_UNKNOWN",
+          "doc": "dimming mode unknown Dimming mode is used to control whether or not a mobile device should dim the screen after a period without user interaction. This mode indicates that the dim mode can't be determined, or that the platform doesn't support dimming.",
+          "type": ""
+        }
+      ],
+      "notes": [],
+      "language": ""
+    },
+    {
+      "type": "ENUM",
+      "name": "window.WINDOW_EVENT",
+      "brief": "Window events",
+      "description": "Window events",
+      "returnvalues": [],
+      "parameters": [],
+      "examples": "",
+      "replaces": "",
+      "error": "",
+      "tparams": [],
+      "members": [
+        {
+          "name": "window.WINDOW_EVENT_DEICONIFIED",
+          "doc": "deiconified window event <span class=\"icon-osx\"></span> <span class=\"icon-windows\"></span> <span class=\"icon-linux\"></span> This event is sent to a window event listener when the game window or app screen is restored after being iconified.",
+          "type": ""
+        },
+        {
+          "name": "window.WINDOW_EVENT_FOCUS_GAINED",
+          "doc": "focus gained window event This event is sent to a window event listener when the game window or app screen has gained focus. This event is also sent at game startup and the engine gives focus to the game.",
+          "type": ""
+        },
+        {
+          "name": "window.WINDOW_EVENT_FOCUS_LOST",
+          "doc": "focus lost window event This event is sent to a window event listener when the game window or app screen has lost focus.",
+          "type": ""
+        },
+        {
+          "name": "window.WINDOW_EVENT_ICONIFIED",
+          "doc": "iconify window event <span class=\"icon-osx\"></span> <span class=\"icon-windows\"></span> <span class=\"icon-linux\"></span> This event is sent to a window event listener when the game window or app screen is iconified (reduced to an application icon in a toolbar, application tray or similar).",
+          "type": ""
+        },
+        {
+          "name": "window.WINDOW_EVENT_RESIZED",
+          "doc": "resized window event This event is sent to a window event listener when the game window or app screen is resized. The new size is passed along in the data field to the event listener.",
+          "type": ""
+        }
+      ],
+      "notes": [],
+      "language": ""
+    },
+    {
+      "type": "STRUCT",
+      "name": "window.event_data",
+      "brief": "Window event data",
+      "description": "Width and height are present for <a href=\"/ref/window#window.WINDOW_EVENT_RESIZED\">window.WINDOW_EVENT_RESIZED</a> and\nabsent for other window events.",
+      "returnvalues": [],
+      "parameters": [],
+      "examples": "",
+      "replaces": "",
+      "error": "",
+      "tparams": [],
+      "members": [
+        {
+          "name": "width?",
+          "doc": "Window width after a resize.",
+          "type": "integer"
+        },
+        {
+          "name": "height?",
+          "doc": "Window height after a resize.",
+          "type": "integer"
+        }
+      ],
+      "notes": [],
+      "language": ""
+    },
+    {
+      "type": "STRUCT",
+      "name": "window.safe_area",
+      "brief": "Window safe-area data",
+      "description": "Window safe-area data",
+      "returnvalues": [],
+      "parameters": [],
+      "examples": "",
+      "replaces": "",
+      "error": "",
+      "tparams": [],
+      "members": [
+        {
+          "name": "x",
+          "doc": "Safe-area x-coordinate.",
+          "type": "integer"
+        },
+        {
+          "name": "y",
+          "doc": "Safe-area y-coordinate.",
+          "type": "integer"
+        },
+        {
+          "name": "width",
+          "doc": "Safe-area width.",
+          "type": "integer"
+        },
+        {
+          "name": "height",
+          "doc": "Safe-area height.",
+          "type": "integer"
+        },
+        {
+          "name": "inset_left",
+          "doc": "Inset from the left window edge.",
+          "type": "integer"
+        },
+        {
+          "name": "inset_top",
+          "doc": "Inset from the top window edge.",
+          "type": "integer"
+        },
+        {
+          "name": "inset_right",
+          "doc": "Inset from the right window edge.",
+          "type": "integer"
+        },
+        {
+          "name": "inset_bottom",
+          "doc": "Inset from the bottom window edge.",
+          "type": "integer"
+        }
+      ],
+      "notes": [],
+      "language": ""
+    },
+    {
+      "type": "FUNCTION",
+      "name": "window.set_listener",
+      "brief": "sets a window event listener",
+      "description": "Sets a window event listener. Only one window event listener can be set at a time.",
+      "returnvalues": [],
+      "parameters": [
+        {
+          "name": "callback",
+          "doc": "A callback which receives info about window events. Pass an empty function or <code>nil</code> if you no longer wish to receive callbacks.",
+          "types": [
+            "fun(self:script_instance, event:window.WINDOW_EVENT, data:window.event_data)",
+            "nil"
+          ],
+          "is_optional": "False"
+        }
+      ],
+      "examples": "<div class=\"codehilite\"><pre><span></span><code><span class=\"kr\">function</span> <span class=\"nf\">window_callback</span><span class=\"p\">(</span><span class=\"n\">self</span><span class=\"p\">,</span> <span class=\"n\">event</span><span class=\"p\">,</span> <span class=\"n\">data</span><span class=\"p\">)</span>\n    <span class=\"kr\">if</span> <span class=\"n\">event</span> <span class=\"o\">==</span> <span class=\"n\">window</span><span class=\"p\">.</span><span class=\"n\">WINDOW_EVENT_FOCUS_LOST</span> <span class=\"kr\">then</span>\n        <span class=\"nb\">print</span><span class=\"p\">(</span><span class=\"s2\">&quot;window.WINDOW_EVENT_FOCUS_LOST&quot;</span><span class=\"p\">)</span>\n    <span class=\"kr\">elseif</span> <span class=\"n\">event</span> <span class=\"o\">==</span> <span class=\"n\">window</span><span class=\"p\">.</span><span class=\"n\">WINDOW_EVENT_FOCUS_GAINED</span> <span class=\"kr\">then</span>\n        <span class=\"nb\">print</span><span class=\"p\">(</span><span class=\"s2\">&quot;window.WINDOW_EVENT_FOCUS_GAINED&quot;</span><span class=\"p\">)</span>\n    <span class=\"kr\">elseif</span> <span class=\"n\">event</span> <span class=\"o\">==</span> <span class=\"n\">window</span><span class=\"p\">.</span><span class=\"n\">WINDOW_EVENT_ICONIFIED</span> <span class=\"kr\">then</span>\n        <span class=\"nb\">print</span><span class=\"p\">(</span><span class=\"s2\">&quot;window.WINDOW_EVENT_ICONIFIED&quot;</span><span class=\"p\">)</span>\n    <span class=\"kr\">elseif</span> <span class=\"n\">event</span> <span class=\"o\">==</span> <span class=\"n\">window</span><span class=\"p\">.</span><span class=\"n\">WINDOW_EVENT_DEICONIFIED</span> <span class=\"kr\">then</span>\n        <span class=\"nb\">print</span><span class=\"p\">(</span><span class=\"s2\">&quot;window.WINDOW_EVENT_DEICONIFIED&quot;</span><span class=\"p\">)</span>\n    <span class=\"kr\">elseif</span> <span class=\"n\">event</span> <span class=\"o\">==</span> <span class=\"n\">window</span><span class=\"p\">.</span><span class=\"n\">WINDOW_EVENT_RESIZED</span> <span class=\"kr\">then</span>\n        <span class=\"nb\">print</span><span class=\"p\">(</span><span class=\"s2\">&quot;Window resized: &quot;</span><span class=\"p\">,</span> <span class=\"n\">data</span><span class=\"p\">.</span><span class=\"n\">width</span><span class=\"p\">,</span> <span class=\"n\">data</span><span class=\"p\">.</span><span class=\"n\">height</span><span class=\"p\">)</span>\n    <span class=\"kr\">end</span>\n<span class=\"kr\">end</span>\n\n<span class=\"kr\">function</span> <span class=\"nf\">init</span><span class=\"p\">(</span><span class=\"n\">self</span><span class=\"p\">)</span>\n    <span class=\"n\">window</span><span class=\"p\">.</span><span class=\"n\">set_listener</span><span class=\"p\">(</span><span class=\"n\">window_callback</span><span class=\"p\">)</span>\n<span class=\"kr\">end</span>\n</code></pre></div>",
+      "replaces": "",
+      "error": "",
+      "tparams": [],
+      "members": [],
+      "notes": [],
+      "language": ""
+    },
+    {
+      "type": "FUNCTION",
+      "name": "window.set_mouse_lock",
+      "brief": "set the locking state for current mouse cursor",
+      "description": "Set the locking state for current mouse cursor on a PC platform.\nThis function locks or unlocks the mouse cursor to the center point of the window. While the cursor is locked,\nmouse position updates will still be sent to the scripts as usual.",
+      "returnvalues": [],
+      "parameters": [
+        {
+          "name": "flag",
+          "doc": "The lock state for the mouse cursor",
+          "types": ["boolean"],
+          "is_optional": "False"
+        }
+      ],
+      "examples": "",
+      "replaces": "",
+      "error": "",
+      "tparams": [],
+      "members": [],
+      "notes": [],
+      "language": ""
+    },
+    {
+      "type": "FUNCTION",
+      "name": "window.set_dim_mode",
+      "brief": "set the mode for screen dimming",
+      "description": "<span class=\"icon-ios\"></span> <span class=\"icon-android\"></span> Sets the dimming mode on a mobile device.\nThe dimming mode specifies whether or not a mobile device should dim the screen after a period without user interaction. The dimming mode will only affect the mobile device while the game is in focus on the device, but not when the game is running in the background.\nThis function has no effect on platforms that does not support dimming.",
+      "returnvalues": [],
+      "parameters": [
+        {
+          "name": "mode",
+          "doc": "The mode for screen dimming",
+          "types": ["window.DIMMING"],
+          "is_optional": "False"
+        }
+      ],
+      "examples": "",
+      "replaces": "",
+      "error": "",
+      "tparams": [],
+      "members": [],
+      "notes": [],
+      "language": ""
+    },
+    {
+      "type": "FUNCTION",
+      "name": "window.get_dim_mode",
+      "brief": "get the mode for screen dimming",
+      "description": "<span class=\"icon-ios\"></span> <span class=\"icon-android\"></span> Returns the current dimming mode set on a mobile device.\nThe dimming mode specifies whether or not a mobile device should dim the screen after a period without user interaction.\nOn platforms that does not support dimming, <code>window.DIMMING_UNKNOWN</code> is always returned.",
+      "returnvalues": [
+        {
+          "name": "mode",
+          "doc": "The mode for screen dimming",
+          "types": ["window.DIMMING"]
+        }
+      ],
+      "parameters": [],
+      "examples": "",
+      "replaces": "",
+      "error": "",
+      "tparams": [],
+      "members": [],
+      "notes": [],
+      "language": ""
+    },
+    {
+      "type": "FUNCTION",
+      "name": "window.get_size",
+      "brief": "get the window size",
+      "description": "This returns the current window size (width and height).",
+      "returnvalues": [
+        {
+          "name": "width",
+          "doc": "The window width",
+          "types": ["integer"]
+        },
+        {
+          "name": "height",
+          "doc": "The window height",
+          "types": ["integer"]
+        }
+      ],
+      "parameters": [],
+      "examples": "",
+      "replaces": "",
+      "error": "",
+      "tparams": [],
+      "members": [],
+      "notes": [],
+      "language": ""
+    },
+    {
+      "type": "FUNCTION",
+      "name": "window.get_safe_area",
+      "brief": "get the safe area",
+      "description": "This returns the safe area rectangle (x, y, width, height) and the inset\nvalues relative to the window edges. On platforms without a safe area,\nthis returns the full window size and zero insets.",
+      "returnvalues": [
+        {
+          "name": "safe_area",
+          "doc": "safe area data",
+          "types": ["window.safe_area"]
+        }
+      ],
+      "parameters": [],
+      "examples": "",
+      "replaces": "",
+      "error": "",
+      "tparams": [],
+      "members": [],
+      "notes": [],
+      "language": ""
+    },
+    {
+      "type": "FUNCTION",
+      "name": "window.get_mouse_lock",
+      "brief": "get the cursor lock state",
+      "description": "This returns the current lock state of the mouse cursor",
+      "returnvalues": [
+        {
+          "name": "state",
+          "doc": "The lock state",
+          "types": ["boolean"]
+        }
+      ],
+      "parameters": [],
+      "examples": "",
+      "replaces": "",
+      "error": "",
+      "tparams": [],
+      "members": [],
+      "notes": [],
+      "language": ""
+    },
+    {
+      "type": "FUNCTION",
+      "name": "window.get_display_scale",
+      "brief": "get the display scale",
+      "description": "This returns the content scale of the current display.",
+      "returnvalues": [
+        {
+          "name": "scale",
+          "doc": "The display scale",
+          "types": ["number"]
+        }
+      ],
+      "parameters": [],
+      "examples": "",
+      "replaces": "",
+      "error": "",
+      "tparams": [],
+      "members": [],
+      "notes": [],
+      "language": ""
+    },
+    {
+      "type": "FUNCTION",
+      "name": "window.set_title",
+      "brief": "set the title of the window",
+      "description": "Sets the window title. Works on desktop platforms.",
+      "returnvalues": [],
+      "parameters": [
+        {
+          "name": "title",
+          "doc": "The title, encoded as UTF-8",
+          "types": ["string"],
+          "is_optional": "False"
+        }
+      ],
+      "examples": "",
+      "replaces": "",
+      "error": "",
+      "tparams": [],
+      "members": [],
+      "notes": [],
+      "language": ""
+    },
+    {
+      "type": "FUNCTION",
+      "name": "window.set_size",
+      "brief": "set the size of the window",
+      "description": "Sets the window size. Works on desktop platforms only.",
+      "returnvalues": [],
+      "parameters": [
+        {
+          "name": "width",
+          "doc": "Width of window",
+          "types": ["integer"],
+          "is_optional": "False"
+        },
+        {
+          "name": "height",
+          "doc": "Height of window",
+          "types": ["integer"],
+          "is_optional": "False"
+        }
+      ],
+      "examples": "",
+      "replaces": "",
+      "error": "",
+      "tparams": [],
+      "members": [],
+      "notes": [],
+      "language": ""
+    },
+    {
+      "type": "FUNCTION",
+      "name": "window.set_position",
+      "brief": "set the position of the window",
+      "description": "Sets the window position.",
+      "returnvalues": [],
+      "parameters": [
+        {
+          "name": "x",
+          "doc": "Horizontal position of window",
+          "types": ["integer"],
+          "is_optional": "False"
+        },
+        {
+          "name": "y",
+          "doc": "Vertical position of window",
+          "types": ["integer"],
+          "is_optional": "False"
+        }
+      ],
+      "examples": "",
+      "replaces": "",
+      "error": "",
+      "tparams": [],
+      "members": [],
+      "notes": [],
+      "language": ""
+    }
+  ],
+  "info": {
+    "namespace": "window",
+    "name": "Window",
+    "brief": "Window API documentation",
+    "description": "Functions and constants to access the window, window event listeners\nand screen dimming.",
+    "path": "engine/gamesys/src/gamesys/scripts/script_window.cpp",
+    "file": "",
+    "notes": [],
+    "language": "Lua"
+  },
+  "format_version": 2
+}

package/fixtures/defold-1.14.0/zlib_doc.json

@@ -0,0 +1,71 @@
+{
+  "elements": [
+    {
+      "type": "FUNCTION",
+      "name": "zlib.inflate",
+      "brief": "Inflate (decompress) a buffer",
+      "description": "A lua error is raised is on error",
+      "returnvalues": [
+        {
+          "name": "buf",
+          "doc": "inflated buffer",
+          "types": ["string"]
+        }
+      ],
+      "parameters": [
+        {
+          "name": "buf",
+          "doc": "buffer to inflate",
+          "types": ["string"],
+          "is_optional": "False"
+        }
+      ],
+      "examples": "<div class=\"codehilite\"><pre><span></span><code><span class=\"kd\">local</span> <span class=\"n\">data</span> <span class=\"o\">=</span> <span class=\"s2\">&quot;</span><span class=\"se\">\\120\\94\\11\\201\\200\\44\\86\\0\\162\\68\\133\\226\\146\\162\\204\\188\\116\\133\\242\\204\\146\\12\\133\\210\\188\\228\\252\\220\\130\\162\\212\\226\\226\\212\\20\\133\\148\\196\\146\\68\\61\\0\\44\\67\\14\\201</span><span class=\"s2\">&quot;</span>\n<span class=\"kd\">local</span> <span class=\"n\">uncompressed_data</span> <span class=\"o\">=</span> <span class=\"n\">zlib</span><span class=\"p\">.</span><span class=\"n\">inflate</span><span class=\"p\">(</span><span class=\"n\">data</span><span class=\"p\">)</span>\n<span class=\"nb\">print</span><span class=\"p\">(</span><span class=\"n\">uncompressed_data</span><span class=\"p\">)</span> <span class=\"c1\">--&gt; This is a string with uncompressed data.</span>\n</code></pre></div>",
+      "replaces": "",
+      "error": "",
+      "tparams": [],
+      "members": [],
+      "notes": [],
+      "language": ""
+    },
+    {
+      "type": "FUNCTION",
+      "name": "zlib.deflate",
+      "brief": "Deflate (compress) a buffer",
+      "description": "A lua error is raised is on error",
+      "returnvalues": [
+        {
+          "name": "buf",
+          "doc": "deflated buffer",
+          "types": ["string"]
+        }
+      ],
+      "parameters": [
+        {
+          "name": "buf",
+          "doc": "buffer to deflate",
+          "types": ["string"],
+          "is_optional": "False"
+        }
+      ],
+      "examples": "<div class=\"codehilite\"><pre><span></span><code><span class=\"kd\">local</span> <span class=\"n\">data</span> <span class=\"o\">=</span> <span class=\"s2\">&quot;This is a string with uncompressed data.&quot;</span>\n<span class=\"kd\">local</span> <span class=\"n\">compressed_data</span> <span class=\"o\">=</span> <span class=\"n\">zlib</span><span class=\"p\">.</span><span class=\"n\">deflate</span><span class=\"p\">(</span><span class=\"n\">data</span><span class=\"p\">)</span>\n<span class=\"kd\">local</span> <span class=\"n\">s</span> <span class=\"o\">=</span> <span class=\"s2\">&quot;&quot;</span>\n<span class=\"kr\">for</span> <span class=\"n\">c</span> <span class=\"kr\">in</span> <span class=\"nb\">string.gmatch</span><span class=\"p\">(</span><span class=\"n\">compressed_data</span><span class=\"p\">,</span> <span class=\"s2\">&quot;.&quot;</span><span class=\"p\">)</span> <span class=\"kr\">do</span>\n    <span class=\"n\">s</span> <span class=\"o\">=</span> <span class=\"n\">s</span> <span class=\"o\">..</span> <span class=\"s1\">&#39;</span><span class=\"se\">\\\\</span><span class=\"s1\">&#39;</span> <span class=\"o\">..</span> <span class=\"nb\">string.byte</span><span class=\"p\">(</span><span class=\"n\">c</span><span class=\"p\">)</span>\n<span class=\"kr\">end</span>\n<span class=\"nb\">print</span><span class=\"p\">(</span><span class=\"n\">s</span><span class=\"p\">)</span> <span class=\"c1\">--&gt; \\120\\94\\11\\201\\200\\44\\86\\0\\162\\68\\133\\226\\146\\162 ...</span>\n</code></pre></div>",
+      "replaces": "",
+      "error": "",
+      "tparams": [],
+      "members": [],
+      "notes": [],
+      "language": ""
+    }
+  ],
+  "info": {
+    "namespace": "zlib",
+    "name": "Zlib",
+    "brief": "Zlib compression API documentation",
+    "description": "Functions for compression and decompression of string buffers.",
+    "path": "engine/script/src/script_zlib.cpp",
+    "file": "",
+    "notes": [],
+    "language": "Lua"
+  },
+  "format_version": 2
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defold-typescript/types",
-  "version": "0.53.0",
+  "version": "0.54.0",
   "description": "TypeScript types for the Defold engine's Lua APIs.",
   "license": "MIT",
   "repository": {
@@ -57,6 +57,11 @@
     "./hsm/defold": {
       "types": "./hsm/defold.d.ts"
     },
+    "./cli-runtime": {
+      "types": "./scripts/cli-runtime.ts",
+      "bun": "./scripts/cli-runtime.ts",
+      "default": "./dist/cli-runtime.js"
+    },
     "./api-availability.json": "./api-availability.json",
     "./api-signatures.json": "./api-signatures.json",
     "./url-parameters.json": "./url-parameters.json",
@@ -74,11 +79,12 @@
     "api-signatures.json",
     "url-parameters.json",
     "index.d.ts",
+    "dist/cli-runtime.js",
     "fixtures/messages_doc.json",
-    "fixtures/defold-*",
-    "!fixtures/defold-*/engine-bindings",
-    "!fixtures/defold-*/engine-evidence",
-    "!fixtures/defold-*/annotations",
+    "fixtures/defold-*/**",
+    "!fixtures/defold-*/engine-bindings/**",
+    "!fixtures/defold-*/engine-evidence/**",
+    "!fixtures/defold-*/annotations/**",
     "examples/translations.json",
     "!src/**/*.test.ts",
     "!scripts/**/*.test.ts",
@@ -111,7 +117,8 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "tsc -p tsconfig.build.json && bun run build:cli-runtime",
+    "build:cli-runtime": "bun build scripts/cli-runtime.ts --target=node --format=esm --packages=external --outdir=dist",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "regen": "bun scripts/regen.ts",
     "generate-api-availability": "bun scripts/generate-api-availability.ts",

package/scripts/cli-runtime.ts

@@ -0,0 +1,18 @@
+// The one entry the CLI loads the generator through, published as
+// `@defold-typescript/types/cli-runtime`. Node's loader refuses a `.ts` file
+// under `node_modules` and reads a bare Windows path as a URL scheme, so the
+// CLI never imports these scripts by path: Bun resolves the export's `bun`
+// condition to this source, Node its `default` to the bundle built beside it
+// (`dist/cli-runtime.js`, `bun run build:cli-runtime`). Anything the CLI needs
+// at runtime is added here, never imported by path.
+
+export {
+  buildVersionedSurfaceFiles,
+  materializeVersionedSurface,
+  RESTRICTED_SRC_AUGMENTATIONS,
+  RUNTIME_KIND_MANIFEST,
+  renderMaterializedKindIndex,
+  targetKindManifest,
+} from "./materialize-version";
+export { generateGlobalTableDeclaration, generateModuleDeclaration } from "./regen";
+export { readZip, scriptApiToFixtureJson, type ZipAccessor } from "./sync-api-docs";

package/scripts/example-store-io.ts

@@ -5,8 +5,8 @@ import type { ProseLuaKeepStore, TranslationStore } from "../src/example-store";
 // Build-time only: lives under `scripts/` (never reachable from the shipped
 // `src/index.ts` graph) so its `node:fs` import cannot leak into a consumer's
 // typecheck. `src/example-store.ts` stays pure for exactly that reason.
-const TRANSLATIONS_PATH = resolve(import.meta.dir, "..", "examples", "translations.json");
-const PROSE_LUA_KEPT_PATH = resolve(import.meta.dir, "..", "examples", "prose-lua-kept.json");
+const TRANSLATIONS_PATH = resolve(import.meta.dirname, "..", "examples", "translations.json");
+const PROSE_LUA_KEPT_PATH = resolve(import.meta.dirname, "..", "examples", "prose-lua-kept.json");
 
 export function loadTranslations(path: string = TRANSLATIONS_PATH): TranslationStore {
   let raw: string;

package/scripts/extension-goldens.ts

@@ -10,15 +10,19 @@ import type { ModuleManifestEntry } from "./regen";
 // break every installed `resolve`.
 export const EXTENSION_GOLDENS_DIR = "extension-goldens";
 
-const PACKAGE_ROOT = resolve(import.meta.dir, "..");
+const PACKAGE_ROOT = resolve(import.meta.dirname, "..");
 const EXTENSION_GOLDEN_NAMESPACES = ["iac", "iap", "push", "webview"] as const;
 
+// Each golden's doc is the conversion of the extension's `.script_api` at its
+// `packages/library-types/defold-extensions.json` pin, the same JSON the
+// Libraries pages render, so a golden carries the namespace's constants, optional
+// slots and callback arguments exactly as `resolve` would emit them for a project.
+const EXTENSION_DOCS_DIR = resolve(PACKAGE_ROOT, "../library-types/defold-extensions/api-doc");
+
 export const EXTENSION_GOLDEN_MANIFEST: readonly ModuleManifestEntry[] =
   EXTENSION_GOLDEN_NAMESPACES.map((namespace) => ({
     namespace,
-    doc: JSON.parse(
-      readFileSync(resolve(PACKAGE_ROOT, "fixtures", `${namespace}_doc.json`), "utf8"),
-    ),
+    doc: JSON.parse(readFileSync(resolve(EXTENSION_DOCS_DIR, `${namespace}.json`), "utf8")),
     outFile: `${namespace}.d.ts`,
-    indexBaseSource: { pages: [] },
+    indexBaseSource: { pages: [], classifications: new Map() },
   }));

package/scripts/generate-api-availability.ts

@@ -30,7 +30,7 @@ import { splitTopLevel } from "../src/luals-type-expr";
 import { type ApiTarget, loadApiTargets, loadTargetModules } from "./regen";
 import { compareVersions, versionOf } from "./target-version";
 
-const PACKAGE_ROOT = resolve(import.meta.dir, "..");
+const PACKAGE_ROOT = resolve(import.meta.dirname, "..");
 const MIGRATIONS_PATH = resolve(PACKAGE_ROOT, "api-migrations.json");
 const AVAILABILITY_PATH = resolve(PACKAGE_ROOT, "api-availability.json");
 

package/scripts/generate-api-signatures.ts

@@ -14,7 +14,7 @@ import {
 import { loadSignatureFile } from "./signature-store-fs";
 import { versionOf } from "./target-version";
 
-const PACKAGE_ROOT = resolve(import.meta.dir, "..");
+const PACKAGE_ROOT = resolve(import.meta.dirname, "..");
 const SIGNATURES_PATH = resolve(PACKAGE_ROOT, "api-signatures.json");
 
 export interface SignaturesArtifact {

package/scripts/import-defold-release.ts

@@ -17,7 +17,7 @@ import {
 
 const EXACT_VERSION = /^\d+\.\d+\.\d+$/;
 const DECLARED_NAME_KINDS = new Set(["CONSTANT", "ENUM", "STRUCT", "TYPEDEF", "CLASS"]);
-const PACKAGE_ROOT = resolve(import.meta.dir, "..");
+const PACKAGE_ROOT = resolve(import.meta.dirname, "..");
 
 // Editor-scripting namespaces are mapped, but not by `api-targets.json`: they
 // emit through `EDITOR_MODULE_MANIFEST` rather than the runtime module set the