@defold-typescript/types 0.49.0 → 0.50.0

package/api-targets.json

@@ -1,9 +1,9 @@
 {
   "targets": [
     {
-      "id": "defold-1.13.2",
+      "id": "defold-1.14.0",
       "default": true,
-      "fixturesDir": "fixtures/defold-1.13.2",
+      "fixturesDir": "fixtures/defold-1.14.0",
       "generatedDir": "generated",
       "coreTypesImport": "../src/core-types",
       "source": null,
@@ -391,6 +391,397 @@
         }
       ]
     },
+    {
+      "id": "defold-1.13.2",
+      "default": false,
+      "fixturesDir": "fixtures/defold-1.13.2",
+      "generatedDir": "generated/versions/defold-1.13.2",
+      "coreTypesImport": "../../../src/core-types",
+      "source": null,
+      "modules": [
+        {
+          "namespace": "b2d",
+          "fixture": "b2d_doc.json",
+          "outFile": "b2d.d.ts"
+        },
+        {
+          "namespace": "b2d.body",
+          "fixture": "b2d_body_doc.json",
+          "outFile": "b2d_body.d.ts",
+          "skipFunctions": ["get_user_data", "set_user_data"],
+          "skipOverloads": [
+            {
+              "name": "create_fixture",
+              "param": "shape",
+              "type": "b2Shape"
+            },
+            {
+              "name": "set_mass_data",
+              "param": "data",
+              "type": "b2MassData"
+            },
+            {
+              "name": "get_transform",
+              "returns": "b2Transform"
+            },
+            {
+              "name": "get_mass_data",
+              "returns": "b2MassData"
+            }
+          ]
+        },
+        {
+          "namespace": "b2d.chain",
+          "fixture": "b2d_chain_doc.json",
+          "outFile": "b2d_chain.d.ts"
+        },
+        {
+          "namespace": "b2d.fixture",
+          "fixture": "b2d_fixture_doc.json",
+          "outFile": "b2d_fixture.d.ts"
+        },
+        {
+          "namespace": "b2d.joint",
+          "fixture": "b2d_joint_doc.json",
+          "outFile": "b2d_joint.d.ts"
+        },
+        {
+          "namespace": "b2d.shape",
+          "fixture": "b2d_shape_doc.json",
+          "outFile": "b2d_shape.d.ts"
+        },
+        {
+          "namespace": "b2d.world",
+          "fixture": "b2d_world_doc.json",
+          "outFile": "b2d_world.d.ts"
+        },
+        {
+          "namespace": "buffer",
+          "fixture": "buffer_doc.json",
+          "outFile": "buffer.d.ts"
+        },
+        {
+          "namespace": "bullet3d",
+          "fixture": "bullet3d_doc.json",
+          "outFile": "bullet3d.d.ts"
+        },
+        {
+          "namespace": "bullet3d.collision_object",
+          "fixture": "bullet3d_collision_object_doc.json",
+          "outFile": "bullet3d_collision_object.d.ts"
+        },
+        {
+          "namespace": "bullet3d.constraint",
+          "fixture": "bullet3d_constraint_doc.json",
+          "outFile": "bullet3d_constraint.d.ts"
+        },
+        {
+          "namespace": "bullet3d.rigid_body",
+          "fixture": "bullet3d_rigid_body_doc.json",
+          "outFile": "bullet3d_rigid_body.d.ts"
+        },
+        {
+          "namespace": "bullet3d.shape",
+          "fixture": "bullet3d_shape_doc.json",
+          "outFile": "bullet3d_shape.d.ts"
+        },
+        {
+          "namespace": "bullet3d.world",
+          "fixture": "bullet3d_world_doc.json",
+          "outFile": "bullet3d_world.d.ts"
+        },
+        {
+          "namespace": "camera",
+          "fixture": "camera_doc.json",
+          "outFile": "camera.d.ts"
+        },
+        {
+          "namespace": "collectionfactory",
+          "fixture": "collectionfactory_doc.json",
+          "outFile": "collectionfactory.d.ts"
+        },
+        {
+          "namespace": "collectionproxy",
+          "fixture": "collectionproxy_doc.json",
+          "outFile": "collectionproxy.d.ts"
+        },
+        {
+          "namespace": "compute",
+          "fixture": "compute_doc.json",
+          "outFile": "compute.d.ts"
+        },
+        {
+          "namespace": "crash",
+          "fixture": "crash_doc.json",
+          "outFile": "crash.d.ts"
+        },
+        {
+          "namespace": "factory",
+          "fixture": "factory_doc.json",
+          "outFile": "factory.d.ts"
+        },
+        {
+          "namespace": "font",
+          "fixture": "font_doc.json",
+          "outFile": "font.d.ts"
+        },
+        {
+          "namespace": "go",
+          "fixture": "go_doc.json",
+          "outFile": "go.d.ts",
+          "skipFunctions": ["get", "set", "property"]
+        },
+        {
+          "namespace": "graphics",
+          "fixture": "graphics_doc.json",
+          "outFile": "graphics.d.ts"
+        },
+        {
+          "namespace": "gui",
+          "fixture": "gui_doc.json",
+          "outFile": "gui.d.ts"
+        },
+        {
+          "namespace": "html5",
+          "fixture": "html5_doc.json",
+          "outFile": "html5.d.ts"
+        },
+        {
+          "namespace": "http",
+          "fixture": "http_doc.json",
+          "outFile": "http.d.ts",
+          "skipFunctions": ["response"]
+        },
+        {
+          "namespace": "image",
+          "fixture": "image_doc.json",
+          "outFile": "image.d.ts"
+        },
+        {
+          "namespace": "json",
+          "fixture": "json_doc.json",
+          "outFile": "json.d.ts"
+        },
+        {
+          "namespace": "label",
+          "fixture": "label_doc.json",
+          "outFile": "label.d.ts"
+        },
+        {
+          "namespace": "liveupdate",
+          "fixture": "liveupdate_doc.json",
+          "outFile": "liveupdate.d.ts"
+        },
+        {
+          "namespace": "material",
+          "fixture": "material_doc.json",
+          "outFile": "material.d.ts"
+        },
+        {
+          "namespace": "model",
+          "fixture": "model_doc.json",
+          "outFile": "model.d.ts"
+        },
+        {
+          "namespace": "msg",
+          "fixture": "msg_doc.json",
+          "outFile": "msg.d.ts",
+          "skipFunctions": ["post", "url"]
+        },
+        {
+          "namespace": "particlefx",
+          "fixture": "particlefx_doc.json",
+          "outFile": "particlefx.d.ts"
+        },
+        {
+          "namespace": "physics",
+          "fixture": "physics_doc.json",
+          "outFile": "physics.d.ts"
+        },
+        {
+          "namespace": "profiler",
+          "fixture": "profiler_doc.json",
+          "outFile": "profiler.d.ts"
+        },
+        {
+          "namespace": "render",
+          "fixture": "render_doc.json",
+          "outFile": "render.d.ts",
+          "skipFunctions": ["render_target"]
+        },
+        {
+          "namespace": "resource",
+          "fixture": "resource_doc.json",
+          "outFile": "resource.d.ts"
+        },
+        {
+          "namespace": "socket",
+          "fixture": "socket_doc.json",
+          "outFile": "socket.d.ts"
+        },
+        {
+          "namespace": "sound",
+          "fixture": "sound_doc.json",
+          "outFile": "sound.d.ts"
+        },
+        {
+          "namespace": "sprite",
+          "fixture": "sprite_doc.json",
+          "outFile": "sprite.d.ts"
+        },
+        {
+          "namespace": "sys",
+          "fixture": "sys_doc.json",
+          "outFile": "sys.d.ts",
+          "skipFunctions": ["get_config_string", "set_engine_throttle"]
+        },
+        {
+          "namespace": "tilemap",
+          "fixture": "tilemap_doc.json",
+          "outFile": "tilemap.d.ts"
+        },
+        {
+          "namespace": "timer",
+          "fixture": "timer_doc.json",
+          "outFile": "timer.d.ts"
+        },
+        {
+          "namespace": "types",
+          "fixture": "types_doc.json",
+          "outFile": "types.d.ts"
+        },
+        {
+          "namespace": "vmath",
+          "fixture": "vmath_doc.json",
+          "outFile": "vmath.d.ts",
+          "skipFunctions": [
+            "clamp",
+            "euler_to_quat",
+            "lerp",
+            "slerp",
+            "mul_per_elem",
+            "normalize",
+            "vector"
+          ]
+        },
+        {
+          "namespace": "window",
+          "fixture": "window_doc.json",
+          "outFile": "window.d.ts"
+        },
+        {
+          "namespace": "zlib",
+          "fixture": "zlib_doc.json",
+          "outFile": "zlib.d.ts"
+        }
+      ],
+      "editorModules": [
+        {
+          "namespace": "editor",
+          "fixture": "editor_doc.json",
+          "outFile": "editor.d.ts",
+          "mapType": "editor",
+          "skipFunctions": [
+            "command",
+            "http.",
+            "image.",
+            "json.",
+            "localization.",
+            "pprint",
+            "tilemap.",
+            "zip.",
+            "zlib."
+          ]
+        },
+        {
+          "namespace": "http",
+          "fixture": "editor_http_doc.json",
+          "outFile": "editor-vm/http.d.ts",
+          "mapType": "editor",
+          "skipFunctions": ["server.local_url", "server.port", "server.route", "server.url"]
+        },
+        {
+          "namespace": "image",
+          "fixture": "editor_image_doc.json",
+          "outFile": "editor-vm/image.d.ts",
+          "mapType": "editor"
+        },
+        {
+          "namespace": "json",
+          "fixture": "editor_json_doc.json",
+          "outFile": "editor-vm/json.d.ts",
+          "mapType": "editor",
+          "skipFunctions": ["decode", "encode"]
+        },
+        {
+          "namespace": "localization",
+          "fixture": "editor_localization_doc.json",
+          "outFile": "editor-vm/localization.d.ts",
+          "mapType": "editor"
+        },
+        {
+          "namespace": "zip",
+          "fixture": "editor_zip_doc.json",
+          "outFile": "editor-vm/zip.d.ts",
+          "mapType": "editor",
+          "skipFunctions": ["METHOD.", "ON_CONFLICT.", "pack", "unpack"]
+        },
+        {
+          "namespace": "zlib",
+          "fixture": "editor_zlib_doc.json",
+          "outFile": "editor-vm/zlib.d.ts",
+          "mapType": "editor"
+        },
+        {
+          "namespace": "tilemap.tiles",
+          "fixture": "editor_tilemap_tiles_doc.json",
+          "outFile": "editor-vm/tilemap_tiles.d.ts",
+          "mapType": "editor"
+        }
+      ],
+      "luaStdlib": [
+        {
+          "namespace": "base",
+          "fixture": "base_doc.json"
+        },
+        {
+          "namespace": "bit",
+          "fixture": "bit_doc.json"
+        },
+        {
+          "namespace": "math",
+          "fixture": "math_doc.json"
+        },
+        {
+          "namespace": "os",
+          "fixture": "os_doc.json"
+        },
+        {
+          "namespace": "string",
+          "fixture": "string_doc.json"
+        },
+        {
+          "namespace": "table",
+          "fixture": "table_doc.json"
+        },
+        {
+          "namespace": "coroutine",
+          "fixture": "coroutine_doc.json"
+        },
+        {
+          "namespace": "debug",
+          "fixture": "debug_doc.json"
+        },
+        {
+          "namespace": "io",
+          "fixture": "io_doc.json"
+        },
+        {
+          "namespace": "package",
+          "fixture": "package_doc.json"
+        }
+      ]
+    },
     {
       "id": "defold-1.13.1",
       "default": false,

package/examples/translations.json

@@ -17,6 +17,12 @@
       "ts": "const body = b2d.get_body(\"#collisionobject\");\nif (body !== undefined) {\n  // Move a circle shape relative to the body origin.\n  const circle = b2d.fixture.get_shape(body, 1);\n  const radius = \"radius\" in circle ? circle.radius : undefined;\n  b2d.fixture.set_shape(body, 1, { type: b2d.shape.SHAPE_TYPE_CIRCLE, radius: radius ?? 16, center: vmath.vector3(24, 0, 0) }, true);\n\n  // Replace an edge shape's local endpoints.\n  b2d.fixture.set_shape(body, 2, {\n    type: b2d.shape.SHAPE_TYPE_EDGE,\n    v1: vmath.vector3(-32, 0, 0),\n    v2: vmath.vector3(32, 0, 0),\n  });\n\n  // Update a box shape using the polygon box convenience format.\n  // The existing polygon must already have four vertices.\n  b2d.fixture.set_shape(\n    body,\n    3,\n    {\n      type: b2d.shape.SHAPE_TYPE_BOX,\n      hx: 16,\n      hy: 8,\n      center: vmath.vector3(0, 20, 0),\n      angle: math.rad(30),\n    },\n    true,\n  );\n}"
     }
   ],
+  "b2d.get_gameobject_id": [
+    {
+      "sourceHash": "eb6ca97a8d3c27db",
+      "ts": "const body = b2d.get_body(\"#collisionobject\");\nif (body !== undefined) {\n  const id = b2d.get_gameobject_id(body);\n}"
+    }
+  ],
   "b2d.shape.set_shape": [
     {
       "sourceHash": "f31970e9ebb8d446",
@@ -89,6 +95,12 @@
       "ts": "// Join two bodies at matching local pivots and explicitly destroy the\n// constraint when the script is finalized:\nexport default defineScript({\n  init() {\n    const body_a = bullet3d.get_rigid_body(\"/body_a#collisionobject\");\n    const body_b = bullet3d.get_rigid_body(\"/body_b#collisionobject\");\n    let constraint: bullet3d.constraint.btTypedConstraint | undefined;\n    if (body_a !== undefined) {\n      constraint = bullet3d.constraint.create_point_to_point(body_a, body_b, {\n        pivot_a: vmath.vector3(0.5, 0, 0),\n        pivot_b: vmath.vector3(-0.5, 0, 0),\n      });\n    }\n    return { constraint };\n  },\n\n  final(self) {\n    if (self.constraint !== undefined && bullet3d.constraint.is_valid(self.constraint)) {\n      bullet3d.constraint.destroy(self.constraint);\n    }\n  },\n});"
     }
   ],
+  "bullet3d.get_gameobject_id": [
+    {
+      "sourceHash": "48ba7c199938dd13",
+      "ts": "const object = bullet3d.get_collision_object(\"#collisionobject\");\nif (object !== undefined) {\n  const id = bullet3d.get_gameobject_id(object);\n}"
+    }
+  ],
   "bullet3d.get_rigid_body": [
     {
       "sourceHash": "e09c75e81d50dd6c",

package/generated/b2d.d.ts

@@ -691,6 +691,21 @@ declare global {
      * @returns the body if successful. Otherwise `nil`.
      */
     function get_body(url: string | Hash | Url): Opaque<"b2Body"> | undefined;
+    /**
+     * Returns the id of the game object that owns the body's collision-object component.
+     * Raises a Lua error if the body handle is invalid or its game object has been deleted.
+     *
+     * @param body - the Box2D body
+     * @returns the game object id, or `nil` if the body has no associated game object
+     * @example
+     * ```ts
+     * const body = b2d.get_body("#collisionobject");
+     * if (body !== undefined) {
+     *   const id = b2d.get_gameobject_id(body);
+     * }
+     * ```
+     */
+    function get_gameobject_id(body: Opaque<"b2Body">): Hash | undefined;
     /**
      * Get the Box2D version information for the active backend.
      *

package/generated/bullet3d.d.ts

@@ -53,6 +53,22 @@ declare global {
      * @returns the collision object, or `nil`
      */
     function get_collision_object(url: string | Hash | Url): Opaque<"btCollisionObject" | "btRigidBody"> | undefined;
+    /**
+     * Returns the id of the game object that owns the collision-object component.
+     * Accepts both rigid bodies and ghost trigger objects.
+     * Raises a Lua error if the handle is invalid or its game object has been deleted.
+     *
+     * @param object - the Bullet collision object
+     * @returns the game object id, or `nil` if the collision object has no associated game object
+     * @example
+     * ```ts
+     * const object = bullet3d.get_collision_object("#collisionobject");
+     * if (object !== undefined) {
+     *   const id = bullet3d.get_gameobject_id(object);
+     * }
+     * ```
+     */
+    function get_gameobject_id(object: Opaque<"btCollisionObject" | "btRigidBody">): Hash | undefined;
     /**
      * Trigger components are ghost objects, so this function returns `nil` for them.
      * This function raises an error unless the collection uses 3D physics.

package/generated/font.d.ts

@@ -95,9 +95,13 @@ declare global {
      * A `link` tag uses `link` by default. Callers may select another named style,
      * such as `link:hover` or `link:active`, in response to input.
      * Font collections initially define these named styles. Each default contains
-     * a normalized RGBA face-color multiplier and no effects. The default `link`
-     * style also uses a solid underline, which remains when hover or active colors
-     * are applied:
+     * a normalized RGBA face color and no effects. Style RGB overrides the base
+     * text color, while alpha uses the lower of the style and base text alpha.
+     * Gradients override RGB and use the lower alpha in the same way. Inline colors
+     * and gradients take precedence over object styles, which take precedence over
+     * the named base style. Nested color or gradient tags override enclosing RGB
+     * in inline markup and named style definitions. The default `link` style also
+     * uses a solid underline, which remains when hover or active colors are applied:
      *
      * - `link`: `(0.10, 0.45, 0.90, 1.0)`, solid underline
      * - `link:hover`: `(0.30, 0.65, 1.00, 1.0)`

package/generated/graphics.d.ts

@@ -119,6 +119,7 @@ declare global {
     type COMPRESSION_TYPE = typeof graphics.COMPRESSION_TYPE_BASIS_ETC1S | typeof graphics.COMPRESSION_TYPE_BASIS_UASTC | typeof graphics.COMPRESSION_TYPE_DEFAULT | typeof graphics.COMPRESSION_TYPE_WEBP | typeof graphics.COMPRESSION_TYPE_WEBP_LOSSY;
     type CONTEXT_FEATURE = typeof graphics.CONTEXT_FEATURE_3D_TEXTURES | typeof graphics.CONTEXT_FEATURE_ASTC_ARRAY_TEXTURES | typeof graphics.CONTEXT_FEATURE_BC_ARRAY_TEXTURES | typeof graphics.CONTEXT_FEATURE_BLEND_EQUATION_MIN_MAX | typeof graphics.CONTEXT_FEATURE_COMPUTE_SHADER | typeof graphics.CONTEXT_FEATURE_INSTANCING | typeof graphics.CONTEXT_FEATURE_MULTI_TARGET_RENDERING | typeof graphics.CONTEXT_FEATURE_STORAGE_BUFFER | typeof graphics.CONTEXT_FEATURE_TEXTURE_ARRAY | typeof graphics.CONTEXT_FEATURE_VSYNC;
     type COORDINATE_SPACE = typeof graphics.COORDINATE_SPACE_DEFAULT | typeof graphics.COORDINATE_SPACE_LOCAL | typeof graphics.COORDINATE_SPACE_WORLD;
+    type CUBEMAP_FACE = typeof graphics.CUBEMAP_FACE_NEGATIVE_X | typeof graphics.CUBEMAP_FACE_NEGATIVE_Y | typeof graphics.CUBEMAP_FACE_NEGATIVE_Z | typeof graphics.CUBEMAP_FACE_POSITIVE_X | typeof graphics.CUBEMAP_FACE_POSITIVE_Y | typeof graphics.CUBEMAP_FACE_POSITIVE_Z;
     type DATA_TYPE = typeof graphics.DATA_TYPE_BYTE | typeof graphics.DATA_TYPE_FLOAT | typeof graphics.DATA_TYPE_INT | typeof graphics.DATA_TYPE_SHORT | typeof graphics.DATA_TYPE_UNSIGNED_BYTE | typeof graphics.DATA_TYPE_UNSIGNED_INT | typeof graphics.DATA_TYPE_UNSIGNED_SHORT;
     type FACE_TYPE = typeof graphics.FACE_TYPE_BACK | typeof graphics.FACE_TYPE_FRONT | typeof graphics.FACE_TYPE_FRONT_AND_BACK;
     type SEMANTIC_TYPE = typeof graphics.SEMANTIC_TYPE_BONE_INDICES | typeof graphics.SEMANTIC_TYPE_BONE_WEIGHTS | typeof graphics.SEMANTIC_TYPE_COLOR | typeof graphics.SEMANTIC_TYPE_MORPH_TARGET_WEIGHTS | typeof graphics.SEMANTIC_TYPE_NONE | typeof graphics.SEMANTIC_TYPE_NORMAL | typeof graphics.SEMANTIC_TYPE_NORMAL_MATRIX | typeof graphics.SEMANTIC_TYPE_PAGE_INDEX | typeof graphics.SEMANTIC_TYPE_POSITION | typeof graphics.SEMANTIC_TYPE_TANGENT | typeof graphics.SEMANTIC_TYPE_TEXCOORD | typeof graphics.SEMANTIC_TYPE_TEXTURE_TRANSFORM_2D | typeof graphics.SEMANTIC_TYPE_WORLD_MATRIX;
@@ -307,6 +308,12 @@ declare global {
      * World vertex attribute coordinate space.
      */
     const COORDINATE_SPACE_WORLD: number & { readonly __brand: "graphics.COORDINATE_SPACE_WORLD" };
+    const CUBEMAP_FACE_NEGATIVE_X: number & { readonly __brand: "graphics.CUBEMAP_FACE_NEGATIVE_X" };
+    const CUBEMAP_FACE_NEGATIVE_Y: number & { readonly __brand: "graphics.CUBEMAP_FACE_NEGATIVE_Y" };
+    const CUBEMAP_FACE_NEGATIVE_Z: number & { readonly __brand: "graphics.CUBEMAP_FACE_NEGATIVE_Z" };
+    const CUBEMAP_FACE_POSITIVE_X: number & { readonly __brand: "graphics.CUBEMAP_FACE_POSITIVE_X" };
+    const CUBEMAP_FACE_POSITIVE_Y: number & { readonly __brand: "graphics.CUBEMAP_FACE_POSITIVE_Y" };
+    const CUBEMAP_FACE_POSITIVE_Z: number & { readonly __brand: "graphics.CUBEMAP_FACE_POSITIVE_Z" };
     /**
      * Signed 8-bit vertex attribute data.
      */

package/generated/gui.d.ts

@@ -27,11 +27,11 @@ declare global {
        */
       text_length: number;
       /**
-       * lower-left x-coordinate relative to the text node's upper-left layout origin
+       * unscaled lower-left x-coordinate relative to the text node's pivot
        */
       x: number;
       /**
-       * lower-left y-coordinate relative to the text node's upper-left layout origin
+       * unscaled lower-left y-coordinate relative to the text node's pivot
        */
       y: number;
       /**
@@ -969,7 +969,7 @@ declare global {
     /**
      * Returns the sprites and links found in the text node's current layout.
      * Each object's `x` and `y` identify its lower-left corner relative to the
-     * text node's upper-left layout origin.
+     * text node's pivot, before applying the node's scale and rotation.
      *
      * @param node - text node to inspect
      * @returns layout objects in source order. **0️⃣ `text_offset` is 0-based; passed to Defold unchanged.**
@@ -1713,7 +1713,8 @@ declare global {
     function set_clipping_visible(node: Opaque<"node">, visible: boolean): void;
     /**
      * Sets the color of the supplied node. The components
-     * of the supplied vector3 or vector4 should contain the color channel values:
+     * of the supplied vector3 or vector4 should contain the color channel values
+     * in the range 0 to 1:
      *
      * Component
      * Color value

package/generated/label.d.ts

@@ -27,11 +27,11 @@ declare global {
        */
       text_length: number;
       /**
-       * lower-left x-coordinate relative to the label's upper-left layout origin
+       * unscaled lower-left x-coordinate relative to the label's pivot
        */
       x: number;
       /**
-       * lower-left y-coordinate relative to the label's upper-left layout origin
+       * unscaled lower-left y-coordinate relative to the label's pivot
        */
       y: number;
       /**
@@ -52,7 +52,7 @@ declare global {
      * Each entry contains `type`, `id`, the zero-based UTF-32 `text_offset`,
      * `text_length`, resolved `x`, `y`, `width`
      * and `height`, and an `attributes` table. The position is the lower-left
-     * object corner relative to the label's upper-left layout origin.
+     * object corner relative to the label's pivot, before applying scale and rotation.
      * Inline resource rendering is not part of this MVP; sprites use their explicit
      * dimensions or a one-em square fallback.
      *

package/generated/render.d.ts

@@ -102,7 +102,7 @@ declare global {
        */
       flags?: render.RENDER_TARGET_FLAG | number;
     }
-    type render_target_params = { sample_count?: number } & { [key: number]: render.render_target_buffer_params };
+    type render_target_params = { type?: graphics.TEXTURE_TYPE; sample_count?: number } & { [key: number]: render.render_target_buffer_params };
     /**
      * Render-target activation options
      */
@@ -111,6 +111,10 @@ declare global {
        * Buffers whose contents become undefined after the target is deactivated. Missing buffers are ignored; combined depth-stencil buffers remain non-transient unless both are selected.
        */
       transient?: graphics.BUFFER_TYPE[];
+      /**
+       * Cubemap face selected for rendering. Valid only for cubemap render targets.
+       */
+      face?: graphics.CUBEMAP_FACE;
     }
     type texture = Opaque<"texture">;
     type ClearBufferKey = typeof graphics.BUFFER_TYPE_COLOR0_BIT | typeof graphics.BUFFER_TYPE_DEPTH_BIT | typeof graphics.BUFFER_TYPE_STENCIL_BIT;
@@ -951,6 +955,16 @@ declare global {
      *
      * @param render_target - render target to set. Omit it, pass `nil`, or use render.RENDER_TARGET_DEFAULT to set the default render target
      * @param options - optional render-target activation options
+     *
+     * `face`
+     * number Cubemap face selected for rendering. This option is valid only for cubemap render targets and defaults to `graphics.CUBEMAP_FACE_POSITIVE_X`.
+     *
+     * - `graphics.CUBEMAP_FACE_POSITIVE_X`
+     * - `graphics.CUBEMAP_FACE_NEGATIVE_X`
+     * - `graphics.CUBEMAP_FACE_POSITIVE_Y`
+     * - `graphics.CUBEMAP_FACE_NEGATIVE_Y`
+     * - `graphics.CUBEMAP_FACE_POSITIVE_Z`
+     * - `graphics.CUBEMAP_FACE_NEGATIVE_Z`
      * @example
      * How to set a render target and draw to it and then switch back to the default render target
      * The render target defines the depth/stencil buffers as transient, when set_render_target is called the next time the buffers may be invalidated and allow for optimisations depending on driver support
@@ -1009,6 +1023,7 @@ declare global {
     /**
      * Sets the render target size for a render target created from
      * either a render script, or from a render target resource.
+     * Cubemap render targets require equal width and height.
      *
      * @param render_target - render target to set size for
      * @param width - new render target width