@defold-typescript/types 0.35.0 → 0.37.0

package/examples/translations.json

@@ -8,19 +8,19 @@
   "b2d.body.create_fixture": [
     {
       "sourceHash": "1f1d588d084c0e48",
-      "ts": "const body = b2d.get_body(\"#collisionobject\");\nconst triangle = b2d.body.create_fixture(body, {\n  density: 1.0, friction: 0.3,\n  shape: { type: b2d.shape.SHAPE_TYPE_POLYGON, vertices: [vmath.vector3(-16, -16, 0), vmath.vector3(16, -16, 0), vmath.vector3(0, 16, 0)] },\n});"
+      "ts": "const body = b2d.get_body(\"#collisionobject\");\nif (body !== undefined) {\n  const triangle = b2d.body.create_fixture(body, {\n    density: 1.0, friction: 0.3,\n    shape: { type: b2d.shape.SHAPE_TYPE_POLYGON, vertices: [vmath.vector3(-16, -16, 0), vmath.vector3(16, -16, 0), vmath.vector3(0, 16, 0)] },\n  });\n}"
     }
   ],
   "b2d.fixture.set_shape": [
     {
       "sourceHash": "ff836b80569f5d30",
-      "ts": "const body = b2d.get_body(\"#collisionobject\");\nconst circle = b2d.fixture.get_shape(body, 1);\ncircle.center = vmath.vector3(24, 0, 0);\nb2d.fixture.set_shape(body, 1, circle, true);\nb2d.fixture.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_EDGE, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });"
+      "ts": "const body = b2d.get_body(\"#collisionobject\");\nif (body !== undefined) {\n  const circle = b2d.fixture.get_shape(body, 1);\n  circle.center = vmath.vector3(24, 0, 0);\n  b2d.fixture.set_shape(body, 1, circle, true);\n  b2d.fixture.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_EDGE, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });\n}"
     }
   ],
   "b2d.shape.set_shape": [
     {
       "sourceHash": "f31970e9ebb8d446",
-      "ts": "const body = b2d.get_body(\"#collisionobject\");\nconst circle = b2d.shape.get_shape(body, 1);\ncircle.center = vmath.vector3(24, 0, 0);\nb2d.shape.set_shape(body, 1, circle, true);\nb2d.shape.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_SEGMENT, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });"
+      "ts": "const body = b2d.get_body(\"#collisionobject\");\nif (body !== undefined) {\n  const circle = b2d.shape.get_shape(body, 1);\n  circle.center = vmath.vector3(24, 0, 0);\n  b2d.shape.set_shape(body, 1, circle, true);\n  b2d.shape.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_SEGMENT, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });\n}"
     }
   ],
   "buffer.copy_buffer": [
@@ -206,7 +206,7 @@
   "factory.create": [
     {
       "sourceHash": "d2cd2037a9127ec6",
-      "ts": "// How to create a new game object:\nexport default defineScript({\n  init(self) {\n    // create a new game object and provide property values\n    self.my_created_object = factory.create(\"#factory\", undefined, undefined, { my_value: 1 });\n    // communicate with the object\n    msg.post(self.my_created_object, \"hello\");\n  },\n});\n\n// And then let the new game object have a script attached:\ngo.property(\"my_value\", 0);\n\nexport default defineScript({\n  init(self) {\n    // do something with self.my_value which is now one\n  },\n});"
+      "ts": "// How to create a new game object:\nexport default defineScript({\n  init(self) {\n    // create a new game object and provide property values\n    const created = factory.create(\"#factory\", undefined, undefined, { my_value: 1 });\n    // communicate with the object\n    msg.post(created, \"hello\");\n  },\n});\n\n// And then let the new game object have a script attached, in its own file:\n//\n//   go.property(\"my_value\", 0);\n//\n//   export default defineScript({\n//     init(self) {\n//       // do something with self.my_value which is now one\n//     },\n//   });"
     }
   ],
   "factory.load": [
@@ -320,7 +320,7 @@
   "go.get_world_position": [
     {
       "sourceHash": "ab804a5cdcfd4f7d",
-      "ts": "// Get the world position of the game object the script is attached to:\nconst p = go.get_world_position();\n\n// Reach a sibling game object by its id \u2014 relative addressing, no socket prefix:\nconst p2 = go.get_world_position(\"x\");"
+      "ts": "// Get the world position of the game object the script is attached to:\nconst p = go.get_world_position();\n\n// Reach a sibling game object by its id — relative addressing, no socket prefix:\nconst p2 = go.get_world_position(\"x\");"
     }
   ],
   "go.get_world_rotation": [
@@ -368,7 +368,7 @@
   "go.set_position": [
     {
       "sourceHash": "ad83d0274d776e8f",
-      "ts": "// `p` is the desired position (a Vector3).\nconst p = vmath.vector3();\n\n// Set the position of the game object the script is attached to:\ngo.set_position(p);\n\n// Reach a sibling game object by its id \u2014 relative addressing, no socket prefix:\ngo.set_position(p, \"x\");"
+      "ts": "// `p` is the desired position (a Vector3).\nconst p = vmath.vector3();\n\n// Set the position of the game object the script is attached to:\ngo.set_position(p);\n\n// Reach a sibling game object by its id — relative addressing, no socket prefix:\ngo.set_position(p, \"x\");"
     }
   ],
   "go.set_rotation": [
@@ -770,7 +770,7 @@
   "on_message": [
     {
       "sourceHash": "bfed6bd72e3242e2",
-      "ts": "// This example demonstrates how a game object instance, called \"a\", can communicate with another instance, called \"b\". It\n// is assumed that both script components of the instances has id \"script\".\n\n// a.script \u2014 Script of instance \"a\":\nexport default defineScript({\n  init() {\n    // let b know about some important data\n    msg.post(\"b#script\", \"my_data\", { important_value: 1 });\n  },\n});\n\n// b.script \u2014 Script of instance \"b\":\nexport default defineScript({\n  init() {\n    // store the url of instance \"a\" for later use, by specifying undefined as socket we\n    // automatically use our own socket\n    return { a_url: msg.url(undefined, go.get_id(\"a\"), \"script\") };\n  },\n\n  on_message(self, message_id, message, sender) {\n    // check message and sender\n    if (message_id === hash(\"my_data\") && sender === self.a_url) {\n      // use the data in some way\n      self.important_value = message.important_value;\n    }\n  },\n});"
+      "ts": "// This example demonstrates how a game object instance, called \"a\", can communicate with another instance, called \"b\". It\n// is assumed that both script components of the instances has id \"script\".\n\n// a.script — Script of instance \"a\":\nexport default defineScript({\n  init() {\n    // let b know about some important data\n    msg.post(\"b#script\", \"my_data\", { important_value: 1 });\n  },\n});\n\n// b.script — Script of instance \"b\":\nexport default defineScript({\n  init() {\n    // store the url of instance \"a\" for later use, by specifying undefined as socket we\n    // automatically use our own socket\n    return { a_url: msg.url(undefined, go.get_id(\"a\"), \"script\") };\n  },\n\n  on_message(self, message_id, message, sender) {\n    // check message and sender\n    if (message_id === hash(\"my_data\") && sender === self.a_url) {\n      // use the data in some way\n      self.important_value = message.important_value;\n    }\n  },\n});"
     }
   ],
   "on_reload": [
@@ -928,7 +928,7 @@
   "render.clear": [
     {
       "sourceHash": "70406f065fc91216",
-      "ts": "// Clear the color buffer and the depth buffer.\nrender.clear({\n  [graphics.BUFFER_TYPE_COLOR0_BIT]: vmath.vector4(0, 0, 0, 0),\n  [graphics.BUFFER_TYPE_DEPTH_BIT]: 1,\n});"
+      "ts": "// Clear the color buffer and the depth buffer.\nconst buffers = new LuaMap<render.ClearBufferKey, number | Vector4>();\nbuffers.set(graphics.BUFFER_TYPE_COLOR0_BIT, vmath.vector4(0, 0, 0, 0));\nbuffers.set(graphics.BUFFER_TYPE_DEPTH_BIT, 1);\nrender.clear(buffers);"
     }
   ],
   "render.constant_buffer": [
@@ -1224,7 +1224,7 @@
   "resource.get_render_target_info": [
     {
       "sourceHash": "5e526c539ed8ae25",
-      "ts": "// Get the metadata from a render target resource\nexport default defineScript({\n  init() {\n    const info = resource.get_render_target_info(\"/my_render_target.render_targetc\");\n    // the info table contains meta data about all the render target attachments\n    // so it's not necessary to use resource.get_texture here, but we do it here\n    // just to show that it's possible:\n    const info_attachment_1 = resource.get_texture_info(info.attachments[0].handle);\n  },\n});\n\n// Get a texture attachment from a render target and set it on a model component\nexport default defineScript({\n  init() {\n    const info = resource.get_render_target_info(\"/my_render_target.render_targetc\");\n    const attachment = info.attachments[0].texture;\n    // you can also get texture info from the 'texture' field, since it's a resource hash\n    const texture_info = resource.get_texture_info(attachment);\n    go.set(\"#model\", \"texture0\", attachment);\n  },\n});"
+      "ts": "// Get the metadata from a render target resource\nexport default defineScript({\n  init() {\n    const info = resource.get_render_target_info(\"/my_render_target.render_targetc\");\n    // the info table contains meta data about all the render target attachments\n    // so it's not necessary to use resource.get_texture here, but we do it here\n    // just to show that it's possible:\n    const info_attachment_1 = resource.get_texture_info(info.attachments[0]!.handle);\n  },\n});\n\n// Get a texture attachment from a render target and set it on a model component\nexport default defineScript({\n  init() {\n    const info = resource.get_render_target_info(\"/my_render_target.render_targetc\");\n    const attachment = info.attachments[0]!.texture!;\n    // you can also get texture info from the 'texture' field, since it's a resource hash\n    const texture_info = resource.get_texture_info(attachment);\n    go.set(\"#model\", \"texture0\", attachment);\n  },\n});"
     }
   ],
   "resource.get_text_metrics": [
@@ -1254,7 +1254,7 @@
   "resource.render_target": [
     {
       "sourceHash": "87231742204d2351",
-      "ts": "// Set a render target color attachment as a model texture:\ngo.property(\"my_render_target\", resource.render_target(\"/rt.render_target\"));\n\nexport default defineScript({\n  init(self) {\n    const rt_info = resource.get_render_target_info(self.my_render_target);\n    go.set(\"#model\", \"texture0\", rt_info.attachments[0].texture);\n  },\n});"
+      "ts": "// Set a render target color attachment as a model texture:\ngo.property(\"my_render_target\", resource.render_target(\"/rt.render_target\"));\n\nexport default defineScript({\n  init(self) {\n    const rt_info = resource.get_render_target_info(self.my_render_target);\n    go.set(\"#model\", \"texture0\", rt_info.attachments[0]!.texture!);\n  },\n});"
     }
   ],
   "resource.set": [
@@ -1978,7 +1978,7 @@
   "zlib.inflate": [
     {
       "sourceHash": "6b8b8cc6d9afe679",
-      "ts": "const data = \"\\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\";\nconst uncompressed_data = zlib.inflate(data);\nprint(uncompressed_data); //> This is a string with uncompressed data."
+      "ts": "const data =\n  \"\\x78\\x5e\\x0b\\xc9\\xc8\\x2c\\x56\\x00\\xa2\\x44\\x85\\xe2\\x92\\xa2\\xcc\\xbc\\x74\\x85\\xf2\\xcc\\x92\\x0c\\x85\\xd2\\xbc\\xe4\\xfc\\xdc\\x82\\xa2\\xd4\\xe2\\xe2\\xd4\\x14\\x85\\x94\\xc4\\x92\\x44\\x3d\\x00\\x2c\\x43\\x0e\\xc9\";\nconst uncompressed_data = zlib.inflate(data);\nprint(uncompressed_data); //> This is a string with uncompressed data."
     }
   ]
 }

package/generated/b2d.d.ts

@@ -14,7 +14,7 @@ declare global {
      * @param url - the url to the game object collision component
      * @returns the body if successful. Otherwise `nil`.
      */
-    function get_body(url: string | Hash | Url): Opaque<"b2Body">;
+    function get_body(url: string | Hash | Url): Opaque<"b2Body"> | undefined;
     /**
      * Get the Box2D version information for the active backend.
      *

package/generated/b2d_body.d.ts

@@ -133,10 +133,12 @@ declare global {
      * @example
      * ```ts
      * const body = b2d.get_body("#collisionobject");
-     * const triangle = b2d.body.create_fixture(body, {
-     *   density: 1.0, friction: 0.3,
-     *   shape: { type: b2d.shape.SHAPE_TYPE_POLYGON, vertices: [vmath.vector3(-16, -16, 0), vmath.vector3(16, -16, 0), vmath.vector3(0, 16, 0)] },
-     * });
+     * if (body !== undefined) {
+     *   const triangle = b2d.body.create_fixture(body, {
+     *     density: 1.0, friction: 0.3,
+     *     shape: { type: b2d.shape.SHAPE_TYPE_POLYGON, vertices: [vmath.vector3(-16, -16, 0), vmath.vector3(16, -16, 0), vmath.vector3(0, 16, 0)] },
+     *   });
+     * }
      * ```
      */
     function create_fixture(body: Opaque<"b2Body">, definition: { shape?: { type?: number; radius?: number; center?: Vector3; v0?: Vector3; v1?: Vector3; v2?: Vector3; v3?: Vector3; vertices?: Vector3[]; hx?: number; hy?: number; angle?: number; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }; friction?: number; restitution?: number; density?: number; sensor?: boolean; filter?: { category_bits?: number; mask_bits?: number; group_index?: number } }): { index: number; type: number; sensor: boolean; density: number; friction: number; restitution: number; child_count: number };

package/generated/b2d_fixture.d.ts

@@ -134,10 +134,12 @@ declare global {
      * @example
      * ```ts
      * const body = b2d.get_body("#collisionobject");
-     * const circle = b2d.fixture.get_shape(body, 1);
-     * circle.center = vmath.vector3(24, 0, 0);
-     * b2d.fixture.set_shape(body, 1, circle, true);
-     * b2d.fixture.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_EDGE, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });
+     * if (body !== undefined) {
+     *   const circle = b2d.fixture.get_shape(body, 1);
+     *   circle.center = vmath.vector3(24, 0, 0);
+     *   b2d.fixture.set_shape(body, 1, circle, true);
+     *   b2d.fixture.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_EDGE, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });
+     * }
      * ```
      */
     function set_shape(body: Opaque<"b2Body">, fixture_index: number, shape: { type?: number; radius?: number; center?: Vector3; v0?: Vector3; v1?: Vector3; v2?: Vector3; v3?: Vector3; vertices?: Vector3[]; hx?: number; hy?: number; angle?: number; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, update_mass?: boolean): void;

package/generated/b2d_shape.d.ts

@@ -202,10 +202,12 @@ declare global {
      * @example
      * ```ts
      * const body = b2d.get_body("#collisionobject");
-     * const circle = b2d.shape.get_shape(body, 1);
-     * circle.center = vmath.vector3(24, 0, 0);
-     * b2d.shape.set_shape(body, 1, circle, true);
-     * b2d.shape.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_SEGMENT, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });
+     * if (body !== undefined) {
+     *   const circle = b2d.shape.get_shape(body, 1);
+     *   circle.center = vmath.vector3(24, 0, 0);
+     *   b2d.shape.set_shape(body, 1, circle, true);
+     *   b2d.shape.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_SEGMENT, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });
+     * }
      * ```
      */
     function set_shape(shape_id: Opaque<"b2Shape">, definition: { type?: number; radius?: number; center?: Vector3; v0?: Vector3; v1?: Vector3; v2?: Vector3; v3?: Vector3; vertices?: Vector3[]; hx?: number; hy?: number; angle?: number; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, update_mass: boolean): void;

package/generated/factory.d.ts

@@ -39,20 +39,21 @@ declare global {
      * export default defineScript({
      *   init(self) {
      *     // create a new game object and provide property values
-     *     self.my_created_object = factory.create("#factory", undefined, undefined, { my_value: 1 });
+     *     const created = factory.create("#factory", undefined, undefined, { my_value: 1 });
      *     // communicate with the object
-     *     msg.post(self.my_created_object, "hello");
+     *     msg.post(created, "hello");
      *   },
      * });
      *
-     * // And then let the new game object have a script attached:
-     * go.property("my_value", 0);
-     *
-     * export default defineScript({
-     *   init(self) {
-     *     // do something with self.my_value which is now one
-     *   },
-     * });
+     * // And then let the new game object have a script attached, in its own file:
+     * //
+     * //   go.property("my_value", 0);
+     * //
+     * //   export default defineScript({
+     * //     init(self) {
+     * //       // do something with self.my_value which is now one
+     * //     },
+     * //   });
      * ```
      */
     function create(url: string | Hash | Url, position?: Vector3, rotation?: Quaternion, properties?: Record<string | number, unknown>, scale?: number | Vector3): Hash;

package/generated/render.d.ts

@@ -38,13 +38,13 @@ declare global {
      * @example
      * ```ts
      * // Clear the color buffer and the depth buffer.
-     * render.clear({
-     *   [graphics.BUFFER_TYPE_COLOR0_BIT]: vmath.vector4(0, 0, 0, 0),
-     *   [graphics.BUFFER_TYPE_DEPTH_BIT]: 1,
-     * });
+     * const buffers = new LuaMap<render.ClearBufferKey, number | Vector4>();
+     * buffers.set(graphics.BUFFER_TYPE_COLOR0_BIT, vmath.vector4(0, 0, 0, 0));
+     * buffers.set(graphics.BUFFER_TYPE_DEPTH_BIT, 1);
+     * render.clear(buffers);
      * ```
      */
-    function clear(buffers: LuaMap<number, number | Vector4>): void;
+    function clear(buffers: LuaMap<number & { readonly __brand: "graphics.BUFFER_TYPE_COLOR0_BIT" } | number & { readonly __brand: "graphics.BUFFER_TYPE_DEPTH_BIT" } | number & { readonly __brand: "graphics.BUFFER_TYPE_STENCIL_BIT" }, number | Vector4>): void;
     /**
      * Constant buffers are used to set shader program variables and are optionally passed to the `render.draw()` function.
      * The buffer's constant elements can be indexed like an ordinary Lua table, but you can't iterate over them with pairs() or ipairs().

package/generated/resource.d.ts

@@ -844,7 +844,7 @@ declare global {
      *     // the info table contains meta data about all the render target attachments
      *     // so it's not necessary to use resource.get_texture here, but we do it here
      *     // just to show that it's possible:
-     *     const info_attachment_1 = resource.get_texture_info(info.attachments[0].handle);
+     *     const info_attachment_1 = resource.get_texture_info(info.attachments[0]!.handle);
      *   },
      * });
      *
@@ -852,7 +852,7 @@ declare global {
      * export default defineScript({
      *   init() {
      *     const info = resource.get_render_target_info("/my_render_target.render_targetc");
-     *     const attachment = info.attachments[0].texture;
+     *     const attachment = info.attachments[0]!.texture!;
      *     // you can also get texture info from the 'texture' field, since it's a resource hash
      *     const texture_info = resource.get_texture_info(attachment);
      *     go.set("#model", "texture0", attachment);
@@ -860,7 +860,7 @@ declare global {
      * });
      * ```
      */
-    function get_render_target_info(path: Hash | string | number): { handle: number; width: number; height: number; depth: number; mipmaps: number; type: number; buffer_type: number; texture: Hash };
+    function get_render_target_info(path: Hash | string | number): { handle: number; attachments: { handle: number; width: number; height: number; depth: number; mipmaps: number; type: number; buffer_type: number; texture?: Hash }[] };
     /**
      * Gets the text metrics from a font
      *
@@ -1051,7 +1051,7 @@ declare global {
      * export default defineScript({
      *   init(self) {
      *     const rt_info = resource.get_render_target_info(self.my_render_target);
-     *     go.set("#model", "texture0", rt_info.attachments[0].texture);
+     *     go.set("#model", "texture0", rt_info.attachments[0]!.texture!);
      *   },
      * });
      * ```

package/generated/sys.d.ts

@@ -294,7 +294,7 @@ declare global {
      * }
      * ```
      */
-    function get_ifaddrs(): { name: string; address: string; mac: string; up: boolean; running: boolean }[];
+    function get_ifaddrs(): { name: string; address?: string; mac?: string; up: boolean; running: boolean }[];
     /**
      * The save-file path is operating system specific and is typically located under the user's home directory.
      * This function will raise a Lua error if unable to get the save file path.
@@ -365,7 +365,7 @@ declare global {
      * }
      * ```
      */
-    function get_sys_info(options?: { ignore_secure?: boolean }): { device_model: string; manufacturer: string; system_name: string; system_version: string; api_version: string; language: string; device_language: string; territory: string; gmt_offset: number; device_ident: string; user_agent: string };
+    function get_sys_info(options?: { ignore_secure?: boolean }): { device_model?: string; manufacturer?: string; system_name: string; system_version: string; api_version: string; language: string; device_language: string; territory: string; gmt_offset: number; device_ident?: string; user_agent?: string };
     /**
      * If the file exists, it must have been created by `sys.save` to be loaded.
      * This function will raise a Lua error if an error occurs while loading the file.

package/generated/versions/defold-1.12.4/b2d.d.ts

@@ -14,7 +14,7 @@ declare global {
      * @param url - the url to the game object collision component
      * @returns the body if successful. Otherwise `nil`.
      */
-    function get_body(url: string | Hash | Url): Opaque<"b2Body">;
+    function get_body(url: string | Hash | Url): Opaque<"b2Body"> | undefined;
     /**
      * Get the Box2D world from the current collection
      *

package/generated/versions/defold-1.12.4/factory.d.ts

@@ -39,20 +39,21 @@ declare global {
      * export default defineScript({
      *   init(self) {
      *     // create a new game object and provide property values
-     *     self.my_created_object = factory.create("#factory", undefined, undefined, { my_value: 1 });
+     *     const created = factory.create("#factory", undefined, undefined, { my_value: 1 });
      *     // communicate with the object
-     *     msg.post(self.my_created_object, "hello");
+     *     msg.post(created, "hello");
      *   },
      * });
      *
-     * // And then let the new game object have a script attached:
-     * go.property("my_value", 0);
-     *
-     * export default defineScript({
-     *   init(self) {
-     *     // do something with self.my_value which is now one
-     *   },
-     * });
+     * // And then let the new game object have a script attached, in its own file:
+     * //
+     * //   go.property("my_value", 0);
+     * //
+     * //   export default defineScript({
+     * //     init(self) {
+     * //       // do something with self.my_value which is now one
+     * //     },
+     * //   });
      * ```
      */
     function create(url: string | Hash | Url, position?: Vector3, rotation?: Quaternion, properties?: Record<string | number, unknown>, scale?: number | Vector3): Hash;

package/generated/versions/defold-1.12.4/render.d.ts

@@ -46,13 +46,13 @@ declare global {
      * @example
      * ```ts
      * // Clear the color buffer and the depth buffer.
-     * render.clear({
-     *   [graphics.BUFFER_TYPE_COLOR0_BIT]: vmath.vector4(0, 0, 0, 0),
-     *   [graphics.BUFFER_TYPE_DEPTH_BIT]: 1,
-     * });
+     * const buffers = new LuaMap<render.ClearBufferKey, number | Vector4>();
+     * buffers.set(graphics.BUFFER_TYPE_COLOR0_BIT, vmath.vector4(0, 0, 0, 0));
+     * buffers.set(graphics.BUFFER_TYPE_DEPTH_BIT, 1);
+     * render.clear(buffers);
      * ```
      */
-    function clear(buffers: LuaMap<number, number | Vector4>): void;
+    function clear(buffers: LuaMap<number & { readonly __brand: "graphics.BUFFER_TYPE_COLOR0_BIT" } | number & { readonly __brand: "graphics.BUFFER_TYPE_DEPTH_BIT" } | number & { readonly __brand: "graphics.BUFFER_TYPE_STENCIL_BIT" }, number | Vector4>): void;
     /**
      * Constant buffers are used to set shader program variables and are optionally passed to the `render.draw()` function.
      * The buffer's constant elements can be indexed like an ordinary Lua table, but you can't iterate over them with pairs() or ipairs().

package/generated/versions/defold-1.12.4/resource.d.ts

@@ -844,7 +844,7 @@ declare global {
      *     // the info table contains meta data about all the render target attachments
      *     // so it's not necessary to use resource.get_texture here, but we do it here
      *     // just to show that it's possible:
-     *     const info_attachment_1 = resource.get_texture_info(info.attachments[0].handle);
+     *     const info_attachment_1 = resource.get_texture_info(info.attachments[0]!.handle);
      *   },
      * });
      *
@@ -852,7 +852,7 @@ declare global {
      * export default defineScript({
      *   init() {
      *     const info = resource.get_render_target_info("/my_render_target.render_targetc");
-     *     const attachment = info.attachments[0].texture;
+     *     const attachment = info.attachments[0]!.texture!;
      *     // you can also get texture info from the 'texture' field, since it's a resource hash
      *     const texture_info = resource.get_texture_info(attachment);
      *     go.set("#model", "texture0", attachment);
@@ -860,7 +860,7 @@ declare global {
      * });
      * ```
      */
-    function get_render_target_info(path: Hash | string | number): { handle: number; width: number; height: number; depth: number; mipmaps: number; type: number; buffer_type: number; texture: Hash };
+    function get_render_target_info(path: Hash | string | number): { handle: number; attachments: { handle: number; width: number; height: number; depth: number; mipmaps: number; type: number; buffer_type: number; texture?: Hash }[] };
     /**
      * Gets the text metrics from a font
      *
@@ -1051,7 +1051,7 @@ declare global {
      * export default defineScript({
      *   init(self) {
      *     const rt_info = resource.get_render_target_info(self.my_render_target);
-     *     go.set("#model", "texture0", rt_info.attachments[0].texture);
+     *     go.set("#model", "texture0", rt_info.attachments[0]!.texture!);
      *   },
      * });
      * ```

package/generated/versions/defold-1.12.4/sys.d.ts

@@ -294,7 +294,7 @@ declare global {
      * }
      * ```
      */
-    function get_ifaddrs(): { name: string; address: string; mac: string; up: boolean; running: boolean }[];
+    function get_ifaddrs(): { name: string; address?: string; mac?: string; up: boolean; running: boolean }[];
     /**
      * The save-file path is operating system specific and is typically located under the user's home directory.
      * This function will raise a Lua error if unable to get the save file path.
@@ -365,7 +365,7 @@ declare global {
      * }
      * ```
      */
-    function get_sys_info(options?: { ignore_secure?: boolean }): { device_model: string; manufacturer: string; system_name: string; system_version: string; api_version: string; language: string; device_language: string; territory: string; gmt_offset: number; device_ident: string; user_agent: string };
+    function get_sys_info(options?: { ignore_secure?: boolean }): { device_model?: string; manufacturer?: string; system_name: string; system_version: string; api_version: string; language: string; device_language: string; territory: string; gmt_offset: number; device_ident?: string; user_agent?: string };
     /**
      * If the file exists, it must have been created by `sys.save` to be loaded.
      * This function will raise a Lua error if an error occurs while loading the file.

package/generated/versions/defold-1.12.4/window.d.ts

@@ -95,7 +95,7 @@ declare global {
      *
      * - number `inset_bottom`
      */
-    function get_safe_area(): { safe_area: { x: number; y: number; width: number; height: number; inset_left: number; inset_top: number; inset_right: number; inset_bottom: number } };
+    function get_safe_area(): { x: number; y: number; width: number; height: number; inset_left: number; inset_top: number; inset_right: number; inset_bottom: number };
     /**
      * This returns the current window size (width and height).
      */

package/generated/versions/defold-1.12.4/zlib.d.ts

@@ -28,7 +28,8 @@ declare global {
      * @returns inflated buffer
      * @example
      * ```ts
-     * const data = "\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";
+     * const data =
+     *   "\x78\x5e\x0b\xc9\xc8\x2c\x56\x00\xa2\x44\x85\xe2\x92\xa2\xcc\xbc\x74\x85\xf2\xcc\x92\x0c\x85\xd2\xbc\xe4\xfc\xdc\x82\xa2\xd4\xe2\xe2\xd4\x14\x85\x94\xc4\x92\x44\x3d\x00\x2c\x43\x0e\xc9";
      * const uncompressed_data = zlib.inflate(data);
      * print(uncompressed_data); //> This is a string with uncompressed data.
      * ```

package/generated/versions/defold-1.13.0/b2d.d.ts

@@ -14,7 +14,7 @@ declare global {
      * @param url - the url to the game object collision component
      * @returns the body if successful. Otherwise `nil`.
      */
-    function get_body(url: string | Hash | Url): Opaque<"b2Body">;
+    function get_body(url: string | Hash | Url): Opaque<"b2Body"> | undefined;
     /**
      * Get the Box2D version information for the active backend.
      *

package/generated/versions/defold-1.13.0/b2d_body.d.ts

@@ -133,10 +133,12 @@ declare global {
      * @example
      * ```ts
      * const body = b2d.get_body("#collisionobject");
-     * const triangle = b2d.body.create_fixture(body, {
-     *   density: 1.0, friction: 0.3,
-     *   shape: { type: b2d.shape.SHAPE_TYPE_POLYGON, vertices: [vmath.vector3(-16, -16, 0), vmath.vector3(16, -16, 0), vmath.vector3(0, 16, 0)] },
-     * });
+     * if (body !== undefined) {
+     *   const triangle = b2d.body.create_fixture(body, {
+     *     density: 1.0, friction: 0.3,
+     *     shape: { type: b2d.shape.SHAPE_TYPE_POLYGON, vertices: [vmath.vector3(-16, -16, 0), vmath.vector3(16, -16, 0), vmath.vector3(0, 16, 0)] },
+     *   });
+     * }
      * ```
      */
     function create_fixture(body: Opaque<"b2Body">, definition: { shape?: { type?: number; radius?: number; center?: Vector3; v0?: Vector3; v1?: Vector3; v2?: Vector3; v3?: Vector3; vertices?: Vector3[]; hx?: number; hy?: number; angle?: number; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }; friction?: number; restitution?: number; density?: number; sensor?: boolean; filter?: { category_bits?: number; mask_bits?: number; group_index?: number } }): { index: number; type: number; sensor: boolean; density: number; friction: number; restitution: number; child_count: number };

package/generated/versions/defold-1.13.0/b2d_fixture.d.ts

@@ -134,10 +134,12 @@ declare global {
      * @example
      * ```ts
      * const body = b2d.get_body("#collisionobject");
-     * const circle = b2d.fixture.get_shape(body, 1);
-     * circle.center = vmath.vector3(24, 0, 0);
-     * b2d.fixture.set_shape(body, 1, circle, true);
-     * b2d.fixture.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_EDGE, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });
+     * if (body !== undefined) {
+     *   const circle = b2d.fixture.get_shape(body, 1);
+     *   circle.center = vmath.vector3(24, 0, 0);
+     *   b2d.fixture.set_shape(body, 1, circle, true);
+     *   b2d.fixture.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_EDGE, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });
+     * }
      * ```
      */
     function set_shape(body: Opaque<"b2Body">, fixture_index: number, shape: { type?: number; radius?: number; center?: Vector3; v0?: Vector3; v1?: Vector3; v2?: Vector3; v3?: Vector3; vertices?: Vector3[]; hx?: number; hy?: number; angle?: number; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, update_mass?: boolean): void;

package/generated/versions/defold-1.13.0/b2d_shape.d.ts

@@ -202,10 +202,12 @@ declare global {
      * @example
      * ```ts
      * const body = b2d.get_body("#collisionobject");
-     * const circle = b2d.shape.get_shape(body, 1);
-     * circle.center = vmath.vector3(24, 0, 0);
-     * b2d.shape.set_shape(body, 1, circle, true);
-     * b2d.shape.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_SEGMENT, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });
+     * if (body !== undefined) {
+     *   const circle = b2d.shape.get_shape(body, 1);
+     *   circle.center = vmath.vector3(24, 0, 0);
+     *   b2d.shape.set_shape(body, 1, circle, true);
+     *   b2d.shape.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_SEGMENT, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });
+     * }
      * ```
      */
     function set_shape(shape_id: Opaque<"b2Shape">, definition: { type?: number; radius?: number; center?: Vector3; v0?: Vector3; v1?: Vector3; v2?: Vector3; v3?: Vector3; vertices?: Vector3[]; hx?: number; hy?: number; angle?: number; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, update_mass: boolean): void;

package/generated/versions/defold-1.13.0/factory.d.ts

@@ -39,20 +39,21 @@ declare global {
      * export default defineScript({
      *   init(self) {
      *     // create a new game object and provide property values
-     *     self.my_created_object = factory.create("#factory", undefined, undefined, { my_value: 1 });
+     *     const created = factory.create("#factory", undefined, undefined, { my_value: 1 });
      *     // communicate with the object
-     *     msg.post(self.my_created_object, "hello");
+     *     msg.post(created, "hello");
      *   },
      * });
      *
-     * // And then let the new game object have a script attached:
-     * go.property("my_value", 0);
-     *
-     * export default defineScript({
-     *   init(self) {
-     *     // do something with self.my_value which is now one
-     *   },
-     * });
+     * // And then let the new game object have a script attached, in its own file:
+     * //
+     * //   go.property("my_value", 0);
+     * //
+     * //   export default defineScript({
+     * //     init(self) {
+     * //       // do something with self.my_value which is now one
+     * //     },
+     * //   });
      * ```
      */
     function create(url: string | Hash | Url, position?: Vector3, rotation?: Quaternion, properties?: Record<string | number, unknown>, scale?: number | Vector3): Hash;

package/generated/versions/defold-1.13.0/render.d.ts

@@ -38,13 +38,13 @@ declare global {
      * @example
      * ```ts
      * // Clear the color buffer and the depth buffer.
-     * render.clear({
-     *   [graphics.BUFFER_TYPE_COLOR0_BIT]: vmath.vector4(0, 0, 0, 0),
-     *   [graphics.BUFFER_TYPE_DEPTH_BIT]: 1,
-     * });
+     * const buffers = new LuaMap<render.ClearBufferKey, number | Vector4>();
+     * buffers.set(graphics.BUFFER_TYPE_COLOR0_BIT, vmath.vector4(0, 0, 0, 0));
+     * buffers.set(graphics.BUFFER_TYPE_DEPTH_BIT, 1);
+     * render.clear(buffers);
      * ```
      */
-    function clear(buffers: LuaMap<number, number | Vector4>): void;
+    function clear(buffers: LuaMap<number & { readonly __brand: "graphics.BUFFER_TYPE_COLOR0_BIT" } | number & { readonly __brand: "graphics.BUFFER_TYPE_DEPTH_BIT" } | number & { readonly __brand: "graphics.BUFFER_TYPE_STENCIL_BIT" }, number | Vector4>): void;
     /**
      * Constant buffers are used to set shader program variables and are optionally passed to the `render.draw()` function.
      * The buffer's constant elements can be indexed like an ordinary Lua table, but you can't iterate over them with pairs() or ipairs().

package/generated/versions/defold-1.13.0/resource.d.ts

@@ -844,7 +844,7 @@ declare global {
      *     // the info table contains meta data about all the render target attachments
      *     // so it's not necessary to use resource.get_texture here, but we do it here
      *     // just to show that it's possible:
-     *     const info_attachment_1 = resource.get_texture_info(info.attachments[0].handle);
+     *     const info_attachment_1 = resource.get_texture_info(info.attachments[0]!.handle);
      *   },
      * });
      *
@@ -852,7 +852,7 @@ declare global {
      * export default defineScript({
      *   init() {
      *     const info = resource.get_render_target_info("/my_render_target.render_targetc");
-     *     const attachment = info.attachments[0].texture;
+     *     const attachment = info.attachments[0]!.texture!;
      *     // you can also get texture info from the 'texture' field, since it's a resource hash
      *     const texture_info = resource.get_texture_info(attachment);
      *     go.set("#model", "texture0", attachment);
@@ -860,7 +860,7 @@ declare global {
      * });
      * ```
      */
-    function get_render_target_info(path: Hash | string | number): { handle: number; width: number; height: number; depth: number; mipmaps: number; type: number; buffer_type: number; texture: Hash };
+    function get_render_target_info(path: Hash | string | number): { handle: number; attachments: { handle: number; width: number; height: number; depth: number; mipmaps: number; type: number; buffer_type: number; texture?: Hash }[] };
     /**
      * Gets the text metrics from a font
      *
@@ -1051,7 +1051,7 @@ declare global {
      * export default defineScript({
      *   init(self) {
      *     const rt_info = resource.get_render_target_info(self.my_render_target);
-     *     go.set("#model", "texture0", rt_info.attachments[0].texture);
+     *     go.set("#model", "texture0", rt_info.attachments[0]!.texture!);
      *   },
      * });
      * ```

package/generated/versions/defold-1.13.0/sys.d.ts

@@ -294,7 +294,7 @@ declare global {
      * }
      * ```
      */
-    function get_ifaddrs(): { name: string; address: string; mac: string; up: boolean; running: boolean }[];
+    function get_ifaddrs(): { name: string; address?: string; mac?: string; up: boolean; running: boolean }[];
     /**
      * The save-file path is operating system specific and is typically located under the user's home directory.
      * This function will raise a Lua error if unable to get the save file path.
@@ -365,7 +365,7 @@ declare global {
      * }
      * ```
      */
-    function get_sys_info(options?: { ignore_secure?: boolean }): { device_model: string; manufacturer: string; system_name: string; system_version: string; api_version: string; language: string; device_language: string; territory: string; gmt_offset: number; device_ident: string; user_agent: string };
+    function get_sys_info(options?: { ignore_secure?: boolean }): { device_model?: string; manufacturer?: string; system_name: string; system_version: string; api_version: string; language: string; device_language: string; territory: string; gmt_offset: number; device_ident?: string; user_agent?: string };
     /**
      * If the file exists, it must have been created by `sys.save` to be loaded.
      * This function will raise a Lua error if an error occurs while loading the file.

package/generated/versions/defold-1.13.0/window.d.ts

@@ -95,7 +95,7 @@ declare global {
      *
      * - number `inset_bottom`
      */
-    function get_safe_area(): { safe_area: { x: number; y: number; width: number; height: number; inset_left: number; inset_top: number; inset_right: number; inset_bottom: number } };
+    function get_safe_area(): { x: number; y: number; width: number; height: number; inset_left: number; inset_top: number; inset_right: number; inset_bottom: number };
     /**
      * This returns the current window size (width and height).
      */