@defold-typescript/types 0.50.1 → 0.52.0

package/api-targets.json

@@ -148,7 +148,8 @@
         {
           "namespace": "gui",
           "fixture": "gui_doc.json",
-          "outFile": "gui.d.ts"
+          "outFile": "gui.d.ts",
+          "skipFunctions": ["animate", "get", "set"]
         },
         {
           "namespace": "html5",
@@ -270,6 +271,7 @@
             "slerp",
             "mul_per_elem",
             "normalize",
+            "dot",
             "vector"
           ]
         },
@@ -539,7 +541,8 @@
         {
           "namespace": "gui",
           "fixture": "gui_doc.json",
-          "outFile": "gui.d.ts"
+          "outFile": "gui.d.ts",
+          "skipFunctions": ["animate", "get", "set"]
         },
         {
           "namespace": "html5",
@@ -661,6 +664,7 @@
             "slerp",
             "mul_per_elem",
             "normalize",
+            "dot",
             "vector"
           ]
         },
@@ -900,7 +904,8 @@
         {
           "namespace": "gui",
           "fixture": "gui_doc.json",
-          "outFile": "gui.d.ts"
+          "outFile": "gui.d.ts",
+          "skipFunctions": ["animate", "get", "set"]
         },
         {
           "namespace": "html5",
@@ -1021,6 +1026,7 @@
             "slerp",
             "mul_per_elem",
             "normalize",
+            "dot",
             "vector"
           ]
         },
@@ -1260,7 +1266,8 @@
         {
           "namespace": "gui",
           "fixture": "gui_doc.json",
-          "outFile": "gui.d.ts"
+          "outFile": "gui.d.ts",
+          "skipFunctions": ["animate", "get", "set"]
         },
         {
           "namespace": "html5",
@@ -1381,6 +1388,7 @@
             "slerp",
             "mul_per_elem",
             "normalize",
+            "dot",
             "vector"
           ]
         },
@@ -1563,7 +1571,8 @@
         {
           "namespace": "gui",
           "fixture": "gui_doc.json",
-          "outFile": "gui.d.ts"
+          "outFile": "gui.d.ts",
+          "skipFunctions": ["animate", "get", "set"]
         },
         {
           "namespace": "html5",
@@ -1679,6 +1688,7 @@
             "slerp",
             "mul_per_elem",
             "normalize",
+            "dot",
             "vector"
           ]
         },

package/examples/translations.json

@@ -338,7 +338,7 @@
   "factory.create": [
     {
       "sourceHash": "df32ef57d1e2366e",
-      "ts": "export 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});"
+      "ts": "export 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    if (created !== undefined) {\n      msg.post(created, \"hello\");\n    }\n  },\n});"
     },
     {
       "sourceHash": "981a4891837250a9",
@@ -363,12 +363,6 @@
       "ts": "// How to unload resources of a factory prototype loaded with factory.load:\nfactory.unload(\"#factory\");"
     }
   ],
-  "final": [
-    {
-      "sourceHash": "ebc3cae218af001a",
-      "ts": "export default defineScript({\n  init() {\n    return { some_value: 0 };\n  },\n\n  final(self) {\n    // report finalization\n    msg.post(\"my_friend_instance\", \"im_dead\", { my_stats: self.some_value });\n  },\n});"
-    }
-  ],
   "font.add_font": [
     {
       "sourceHash": "eb23e196a4edbd74",
@@ -708,7 +702,7 @@
     },
     {
       "sourceHash": "7234f15bfdc28abb",
-      "ts": "// How to start a sequenced animation where the node fades in to white during 0.5\n// seconds, stays visible for 2 seconds and then fades out:\nfunction on_animation_done(self: unknown, node: unknown) {\n  // fade out node, but wait 2 seconds before the animation starts\n  gui.animate(node as Opaque<\"node\">, gui.PROP_COLOR, vmath.vector4(0, 0, 0, 0), gui.EASING_OUTQUAD, 0.5, 2.0);\n}\n\nexport default defineGuiScript({\n  init(self) {\n    // fetch the node we want to animate\n    const my_node = gui.get_node(\"my_node\");\n    // node is initially set to fully transparent\n    gui.set_color(my_node, vmath.vector4(0, 0, 0, 0));\n    // animate the node immediately and call on_animation_done when the animation has completed\n    gui.animate(my_node, gui.PROP_COLOR, vmath.vector4(1, 1, 1, 1), gui.EASING_INOUTQUAD, 0.5, 0.0, on_animation_done);\n  },\n});"
+      "ts": "// How to start a sequenced animation where the node fades in to white during 0.5\n// seconds, stays visible for 2 seconds and then fades out:\nfunction on_animation_done(self: unknown, node: Opaque<\"node\">) {\n  // fade out node, but wait 2 seconds before the animation starts\n  gui.animate(node, gui.PROP_COLOR, vmath.vector4(0, 0, 0, 0), gui.EASING_OUTQUAD, 0.5, 2.0);\n}\n\nexport default defineGuiScript({\n  init(self) {\n    // fetch the node we want to animate\n    const my_node = gui.get_node(\"my_node\");\n    // node is initially set to fully transparent\n    gui.set_color(my_node, vmath.vector4(0, 0, 0, 0));\n    // animate the node immediately and call on_animation_done when the animation has completed\n    gui.animate(my_node, gui.PROP_COLOR, vmath.vector4(1, 1, 1, 1), gui.EASING_INOUTQUAD, 0.5, 0.0, on_animation_done);\n  },\n});"
     },
     {
       "sourceHash": "3d5dcef3260b5964",
@@ -820,7 +814,7 @@
   "gui.set": [
     {
       "sourceHash": "0b505e5f92fd4aff",
-      "ts": "const node = gui.get_node(\"my_box_node\");\nconst node_position = gui.get(node, \"position\") as Vector3;\ngui.set(node, \"position.x\", node_position.x + 128);"
+      "ts": "const node = gui.get_node(\"my_box_node\");\nconst node_position = gui.get(node, \"position\");\ngui.set(node, \"position.x\", node_position.x + 128);"
     },
     {
       "sourceHash": "8ed6f5c059ba2496",
@@ -828,7 +822,7 @@
     },
     {
       "sourceHash": "2a8317babd507565",
-      "ts": "const node = gui.get_node(\"my_box_node\");\ngui.set(node, \"tint\", vmath.vector4(1, 0, 0, 1));\n// matrix4 is also supported\ngui.set(node, \"light_matrix\", vmath.matrix4());\n// update a constant in an array at position 4. the array is specified in the shader as:\n// uniform vec4 tint_array[4]; // lua is 1 based, shader is 0 based\ngui.set(node, \"tint_array\", vmath.vector4(1, 0, 0, 1), { index: 4 });\n// update a matrix constant in an array at position 4. the array is specified in the shader as:\n// uniform mat4 light_matrix_array[4];\ngui.set(node, \"light_matrix_array\", vmath.matrix4(), { index: 4 });\n// update a sub-element in a constant\ngui.set(node, \"tint.x\", 1);\n// update a sub-element in an array constant at position 4\ngui.set(node, \"tint_array.x\", 1, { index: 4 });"
+      "ts": "const node = gui.get_node(\"my_box_node\");\ngui.set(node, hash(\"tint\"), vmath.vector4(1, 0, 0, 1));\n// matrix4 is also supported\ngui.set(node, hash(\"light_matrix\"), vmath.matrix4());\n// update a constant in an array at position 4. the array is specified in the shader as:\n// uniform vec4 tint_array[4]; // lua is 1 based, shader is 0 based\ngui.set(node, hash(\"tint_array\"), vmath.vector4(1, 0, 0, 1), { index: 4 });\n// update a matrix constant in an array at position 4. the array is specified in the shader as:\n// uniform mat4 light_matrix_array[4];\ngui.set(node, hash(\"light_matrix_array\"), vmath.matrix4(), { index: 4 });\n// update a sub-element in a constant\ngui.set(node, hash(\"tint.x\"), 1);\n// update a sub-element in an array constant at position 4\ngui.set(node, hash(\"tint_array.x\"), 1, { index: 4 });"
     },
     {
       "sourceHash": "b52d73e25b02e93f",
@@ -903,12 +897,6 @@
       "ts": "// Load an image from an URL as a buffer and create a texture resource from it:\nconst imgurl = \"http://www.site.com/image.png\";\nhttp.request(imgurl, \"GET\", (self, id, response) => {\n  const img =\n    response.response !== undefined\n      ? image.load_buffer(response.response, { flip_vertically: true })\n      : undefined;\n  // the engine registers a texture format only when the driver supports it\n  const format = graphics.TEXTURE_FORMAT_RGBA;\n  if (img !== undefined && format !== undefined) {\n    const tparams = {\n      width: img.width,\n      height: img.height,\n      type: graphics.TEXTURE_TYPE_2D,\n      format,\n    };\n\n    const my_texture_id = resource.create_texture(\"/my_custom_texture.texturec\", tparams, img.buffer);\n    // Apply the texture to a model\n    go.set(\"/go1#model\", \"texture0\", my_texture_id);\n  }\n});"
     }
   ],
-  "init": [
-    {
-      "sourceHash": "70267e467e6e247e",
-      "ts": "export default defineScript({\n  init() {\n    // set up useful data\n    return { my_value: 1 };\n  },\n});"
-    }
-  ],
   "json.decode": [
     {
       "sourceHash": "8dcdd6f81ef65528",
@@ -1072,7 +1060,7 @@
   "model.play_anim": [
     {
       "sourceHash": "64d6b46054d23a1b",
-      "ts": "// The following examples assume that the model has id \"model\".\n// How to play the \"jump\" animation followed by the \"run\" animation:\nconst url = msg.url(\"#model\");\n\nfunction anim_done(self: unknown, message_id: unknown, message: unknown, sender: unknown) {\n  if (message_id === hash(\"model_animation_done\")) {\n    const { animation_id } = message as { animation_id: Hash };\n    if (animation_id === hash(\"jump\")) {\n      // open animation done, chain with \"run\"\n      const properties = { blend_duration: 0.2 };\n      model.play_anim(url, \"run\", go.PLAYBACK_LOOP_FORWARD, properties, anim_done);\n    }\n  }\n}\n\nexport default defineScript({\n  init(self) {\n    const play_properties = { blend_duration: 0.1 };\n    // first blend during 0.1 sec into the jump, then during 0.2 s into the run animation\n    model.play_anim(url, \"jump\", go.PLAYBACK_ONCE_FORWARD, play_properties, anim_done);\n  },\n});"
+      "ts": "// The following examples assume that the model has id \"model\".\n// How to play the \"jump\" animation followed by the \"run\" animation:\nconst url = msg.url(\"#model\");\n\nfunction anim_done(self: unknown, message_id: Hash, message: { animation_id: Hash }) {\n  if (message_id === hash(\"model_animation_done\")) {\n    if (message.animation_id === hash(\"jump\")) {\n      // open animation done, chain with \"run\"\n      const properties = { blend_duration: 0.2 };\n      model.play_anim(url, \"run\", go.PLAYBACK_LOOP_FORWARD, properties, anim_done);\n    }\n  }\n}\n\nexport default defineScript({\n  init(self) {\n    const play_properties = { blend_duration: 0.1 };\n    // first blend during 0.1 sec into the jump, then during 0.2 s into the run animation\n    model.play_anim(url, \"jump\", go.PLAYBACK_ONCE_FORWARD, play_properties, anim_done);\n  },\n});"
     }
   ],
   "model.reset_constant": [
@@ -1117,36 +1105,6 @@
       "ts": "const my_url = msg.url(\"#my_component\");\nprint(my_url); // => url: [current_collection:/my_instance#my_component]\n\nconst my_collection_url = msg.url(\"my_collection:/my_sub_collection/my_instance#my_component\");\nprint(my_collection_url); // => url: [my_collection:/my_sub_collection/my_instance#my_component]\n\nconst my_socket_url = msg.url(\"my_socket:\");\nprint(my_socket_url); // => url: [my_collection:]"
     }
   ],
-  "on_input": [
-    {
-      "sourceHash": "86c70cf4ccb7381e",
-      "ts": "// This example demonstrates how a game object instance can be moved as a response to user input.\nexport default defineScript({\n  init() {\n    // acquire input focus\n    msg.post(\".\", \"acquire_input_focus\");\n    return {\n      // maximum speed the instance can be moved\n      max_speed: 2,\n      // velocity of the instance, initially zero\n      velocity: vmath.vector3(),\n    };\n  },\n\n  update(self, dt) {\n    // move the instance\n    go.set_position(go.get_position().add(self.velocity.mul(dt)));\n  },\n\n  on_input(self, action_id, action) {\n    // check for movement input\n    if (action_id === hash(\"right\")) {\n      if (action.released) {\n        // reset velocity if input was released\n        self.velocity = vmath.vector3();\n      } else {\n        // update velocity\n        self.velocity = vmath.vector3((action.value ?? 0) * self.max_speed, 0, 0);\n      }\n    }\n  },\n});"
-    },
-    {
-      "sourceHash": "cc835ea429adc693",
-      "ts": "export default defineGuiScript({\n  init(): { my_value: number | undefined } {\n    return { my_value: undefined };\n  },\n\n  on_input(self, action_id, action) {\n    // check for input\n    if (action_id === hash(\"my_action\")) {\n      // take appropriate action\n      self.my_value = action.value;\n    }\n    // consume input\n    return true;\n  },\n});"
-    }
-  ],
-  "on_message": [
-    {
-      "sourceHash": "d5850f2009394171",
-      "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});"
-    },
-    {
-      "sourceHash": "9f37896589565629",
-      "ts": "// 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\"), important_value: 0 };\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 && typeof message.important_value === \"number\") {\n      // use the data in some way\n      self.important_value = message.important_value;\n    }\n  },\n});"
-    }
-  ],
-  "on_reload": [
-    {
-      "sourceHash": "ba39c0b0d5170ccb",
-      "ts": "// This example demonstrates how to tweak the speed of a game object instance that is moved on user input.\nexport default defineScript({\n  init() {\n    // acquire input focus\n    msg.post(\".\", \"acquire_input_focus\");\n    return {\n      // maximum speed the instance can be moved, this value is tweaked in the on_reload function below\n      max_speed: 2,\n      // velocity of the instance, initially zero\n      velocity: vmath.vector3(),\n    };\n  },\n\n  update(self, dt) {\n    // move the instance\n    go.set_position(go.get_position().add(self.velocity.mul(dt)));\n  },\n\n  on_input(self, action_id, action) {\n    // check for movement input\n    if (action_id === hash(\"right\")) {\n      if (action.released) {\n        // reset velocity if input was released\n        self.velocity = vmath.vector3();\n      } else {\n        // update velocity\n        self.velocity = vmath.vector3((action.value ?? 0) * self.max_speed, 0, 0);\n      }\n    }\n  },\n\n  on_reload(self) {\n    // edit this value and reload the script component\n    self.max_speed = 100;\n  },\n});"
-    },
-    {
-      "sourceHash": "e89fe0d0bd51ed98",
-      "ts": "export default defineGuiScript({\n  init() {\n    return { my_original_color: gui.get_color(gui.get_node(\"my_node\")) };\n  },\n\n  on_reload(self) {\n    // restore some color (or similar)\n    gui.set_color(gui.get_node(\"my_node\"), self.my_original_color);\n  },\n});"
-    }
-  ],
   "particlefx.play": [
     {
       "sourceHash": "01a21997b47ac4fc",
@@ -1198,7 +1156,7 @@
   "physics.raycast": [
     {
       "sourceHash": "3e0c534d741f0120",
-      "ts": "function handle_result(hit: { fraction: number; position: Vector3; normal: Vector3; id: Hash; group: Hash; request_id: number }) {\n  // act on the hit (see 'ray_cast_response')\n}\n\n// How to perform a ray cast synchronously:\nexport default defineScript({\n  init() {\n    return { groups: [hash(\"world\"), hash(\"enemy\")] };\n  },\n\n  update(self, dt) {\n    // request ray cast\n    const from = go.get_world_position();\n    const to = vmath.vector3(from.x, from.y - 100, from.z);\n    const results = physics.raycast(from, to, self.groups, { all: true });\n    if (results !== undefined) {\n      // with `all` set, the ray cast returns every hit as a list\n      for (const result of Array.isArray(results) ? results : [results]) {\n        handle_result(result);\n      }\n    }\n  },\n});"
+      "ts": "function handle_result(hit: { fraction: number; position: Vector3; normal: Vector3; id: Hash; group: Hash }) {\n  // act on the hit (see 'ray_cast_response')\n}\n\n// How to perform a ray cast synchronously:\nexport default defineScript({\n  init() {\n    return { groups: [hash(\"world\"), hash(\"enemy\")] };\n  },\n\n  update(self, dt) {\n    // request ray cast\n    const from = go.get_world_position();\n    const to = vmath.vector3(from.x, from.y - 100, from.z);\n    const results = physics.raycast(from, to, self.groups, { all: true });\n    if (results !== undefined) {\n      // with `all` set, the ray cast returns every hit as a list\n      for (const result of Array.isArray(results) ? results : [results]) {\n        handle_result(result);\n      }\n    }\n  },\n});"
     }
   ],
   "physics.raycast_async": [
@@ -1358,7 +1316,7 @@
   "render.delete_render_target": [
     {
       "sourceHash": "e535502af5d49877",
-      "ts": "export default defineRenderScript({\n  init() {\n    return { my_render_target: render.render_target(\"my_target\", {}) };\n  },\n\n  final(self) {\n    // How to delete a render target:\n    render.delete_render_target(self.my_render_target);\n  },\n});"
+      "ts": "export default defineRenderScript({\n  init() {\n    return { my_render_target: render.render_target(\"my_target\", {}) };\n  },\n\n  // A render script has no final hook, so free the target on a message.\n  on_message(self, message_id) {\n    if (message_id === hash(\"release_target\")) {\n      // How to delete a render target:\n      render.delete_render_target(self.my_render_target);\n    }\n  },\n});"
     }
   ],
   "render.disable_material": [
@@ -1376,13 +1334,13 @@
   "render.disable_texture": [
     {
       "sourceHash": "77eefc5b608dd2e6",
-      "ts": "export default defineRenderScript({\n  init() {\n    const color_params = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n    };\n    return {\n      my_render_target: render.render_target({ [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    render.enable_texture(0, self.my_render_target, graphics.BUFFER_TYPE_COLOR0_BIT);\n    // draw a predicate with the render target available as texture 0 in the predicate\n    // material shader.\n    render.draw(self.my_pred);\n    // done, disable the texture\n    render.disable_texture(0);\n  },\n});"
+      "ts": "export default defineRenderScript({\n  init() {\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGBA;\n    if (format === undefined) return undefined;\n    const color_params = {\n      format,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n    };\n    return {\n      my_render_target: render.render_target({ [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    if (self === undefined) return;\n    render.enable_texture(0, self.my_render_target, graphics.BUFFER_TYPE_COLOR0_BIT);\n    // draw a predicate with the render target available as texture 0 in the predicate\n    // material shader.\n    render.draw(self.my_pred);\n    // done, disable the texture\n    render.disable_texture(0);\n  },\n});"
     }
   ],
   "render.dispatch_compute": [
     {
       "sourceHash": "75d02543f0e1f325",
-      "ts": "export default defineRenderScript({\n  init() {\n    const color_params = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n    };\n    return {\n      backing_texture: resource.get_texture_info(\"/main/backing.texturec\").handle,\n      scene_rt: render.render_target({ [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params }),\n    };\n  },\n\n  update(self, dt) {\n    render.set_compute(\"bloom\");\n    render.enable_texture(0, self.backing_texture);\n    render.enable_texture(1, self.scene_rt);\n    render.dispatch_compute(128, 128, 1);\n    render.set_compute();\n  },\n});"
+      "ts": "export default defineRenderScript({\n  init() {\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGBA;\n    if (format === undefined) return undefined;\n    const color_params = {\n      format,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n    };\n    return {\n      backing_texture: resource.get_texture_info(\"/main/backing.texturec\").handle,\n      scene_rt: render.render_target({ [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params }),\n    };\n  },\n\n  update(self, dt) {\n    if (self === undefined) return;\n    render.set_compute(\"bloom\");\n    render.enable_texture(0, self.backing_texture);\n    render.enable_texture(1, self.scene_rt);\n    render.dispatch_compute(128, 128, 1);\n    render.set_compute();\n  },\n});"
     },
     {
       "sourceHash": "839cd1accd7a318c",
@@ -1428,7 +1386,7 @@
   "render.enable_texture": [
     {
       "sourceHash": "410c8dd98e44842a",
-      "ts": "export default defineRenderScript({\n  init() {\n    const color_params = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n    };\n    return {\n      my_render_target: render.render_target({ [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    // enable target so all drawing is done to it\n    render.set_render_target(self.my_render_target);\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n\n    // disable target\n    render.set_render_target(render.RENDER_TARGET_DEFAULT);\n\n    render.enable_texture(0, self.my_render_target, graphics.BUFFER_TYPE_COLOR0_BIT);\n    // draw a predicate with the render target available as texture 0 in the predicate\n    // material shader.\n    render.draw(self.my_pred);\n  },\n});"
+      "ts": "export default defineRenderScript({\n  init() {\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGBA;\n    if (format === undefined) return undefined;\n    const color_params = {\n      format,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n    };\n    return {\n      my_render_target: render.render_target({ [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    if (self === undefined) return;\n    // enable target so all drawing is done to it\n    render.set_render_target(self.my_render_target);\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n\n    // disable target\n    render.set_render_target(render.RENDER_TARGET_DEFAULT);\n\n    render.enable_texture(0, self.my_render_target, graphics.BUFFER_TYPE_COLOR0_BIT);\n    // draw a predicate with the render target available as texture 0 in the predicate\n    // material shader.\n    render.draw(self.my_pred);\n  },\n});"
     },
     {
       "sourceHash": "dc0ea083dbea5fe1",
@@ -1448,13 +1406,13 @@
   "render.get_render_target_height": [
     {
       "sourceHash": "f509a9b954573583",
-      "ts": "export default defineRenderScript({\n  init() {\n    const color_params = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n    };\n    return {\n      target_right: render.render_target(\"right\", {\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params,\n      }),\n    };\n  },\n\n  update(self, dt) {\n    // get the height of the render target color buffer\n    const h = render.get_render_target_height(self.target_right, graphics.BUFFER_TYPE_COLOR0_BIT);\n    // get the height of a render target resource\n    const w = render.get_render_target_height(\"my_rt_resource\", graphics.BUFFER_TYPE_COLOR0_BIT);\n  },\n});"
+      "ts": "export default defineRenderScript({\n  init() {\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGBA;\n    if (format === undefined) return undefined;\n    const color_params = {\n      format,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n    };\n    return {\n      target_right: render.render_target(\"right\", {\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params,\n      }),\n    };\n  },\n\n  update(self, dt) {\n    if (self === undefined) return;\n    // get the height of the render target color buffer\n    const h = render.get_render_target_height(self.target_right, graphics.BUFFER_TYPE_COLOR0_BIT);\n    // get the height of a render target resource\n    const w = render.get_render_target_height(\"my_rt_resource\", graphics.BUFFER_TYPE_COLOR0_BIT);\n  },\n});"
     }
   ],
   "render.get_render_target_width": [
     {
       "sourceHash": "25c6d828a4ae3706",
-      "ts": "export default defineRenderScript({\n  init() {\n    const color_params = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n    };\n    return {\n      target_right: render.render_target(\"right\", {\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params,\n      }),\n    };\n  },\n\n  update(self, dt) {\n    // get the width of the render target color buffer\n    const w = render.get_render_target_width(self.target_right, graphics.BUFFER_TYPE_COLOR0_BIT);\n    // get the width of a render target resource\n    const w2 = render.get_render_target_width(\"my_rt_resource\", graphics.BUFFER_TYPE_COLOR0_BIT);\n  },\n});"
+      "ts": "export default defineRenderScript({\n  init() {\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGBA;\n    if (format === undefined) return undefined;\n    const color_params = {\n      format,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n    };\n    return {\n      target_right: render.render_target(\"right\", {\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params,\n      }),\n    };\n  },\n\n  update(self, dt) {\n    if (self === undefined) return;\n    // get the width of the render target color buffer\n    const w = render.get_render_target_width(self.target_right, graphics.BUFFER_TYPE_COLOR0_BIT);\n    // get the width of a render target resource\n    const w2 = render.get_render_target_width(\"my_rt_resource\", graphics.BUFFER_TYPE_COLOR0_BIT);\n  },\n});"
     }
   ],
   "render.get_width": [
@@ -1484,15 +1442,15 @@
   "render.render_target": [
     {
       "sourceHash": "0c72f5142a3a57da",
-      "ts": "// How to create a new render target and draw to it:\nexport default defineRenderScript({\n  init() {\n    // render target buffer parameters\n    const color_params = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    const depth_params = {\n      format: graphics.TEXTURE_FORMAT_DEPTH,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    return {\n      my_render_target: render.render_target({\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params,\n        [graphics.BUFFER_TYPE_DEPTH_BIT]: depth_params,\n      }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    // enable target so all drawing is done to it\n    render.set_render_target(self.my_render_target);\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n  },\n});"
+      "ts": "// How to create a new render target and draw to it:\nexport default defineRenderScript({\n  init() {\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGBA;\n    if (format === undefined) return undefined;\n    // render target buffer parameters\n    const color_params = {\n      format,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    const depth_params = {\n      format: graphics.TEXTURE_FORMAT_DEPTH,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    return {\n      my_render_target: render.render_target({\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params,\n        [graphics.BUFFER_TYPE_DEPTH_BIT]: depth_params,\n      }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    if (self === undefined) return;\n    // enable target so all drawing is done to it\n    render.set_render_target(self.my_render_target);\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n  },\n});"
     },
     {
       "sourceHash": "271ca31f05e103b5",
-      "ts": "// How to create a render target with multiple outputs:\nexport default defineRenderScript({\n  init() {\n    // render target buffer parameters\n    const color_params_rgba = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    const color_params_float = {\n      format: graphics.TEXTURE_FORMAT_RG32F,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n\n    // the engine registers the extra color attachments only when the driver supports them\n    const color1 = graphics.BUFFER_TYPE_COLOR1_BIT;\n    const color2 = graphics.BUFFER_TYPE_COLOR2_BIT;\n    if (color1 === undefined || color2 === undefined) return undefined;\n\n    // Create a render target with three color attachments\n    // Note: No depth buffer is attached here\n    return {\n      my_render_target: render.render_target({\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params_rgba,\n        [color1]: color_params_rgba,\n        [color2]: color_params_float,\n      }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    if (self === undefined) return;\n    // set target so all drawing is done to it\n    render.set_render_target(self.my_render_target);\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n  },\n});"
+      "ts": "// How to create a render target with multiple outputs:\nexport default defineRenderScript({\n  init() {\n    // the engine registers a texture format or an extra color attachment only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGBA;\n    const rg32f = graphics.TEXTURE_FORMAT_RG32F;\n    const color1 = graphics.BUFFER_TYPE_COLOR1_BIT;\n    const color2 = graphics.BUFFER_TYPE_COLOR2_BIT;\n    if (format === undefined || rg32f === undefined || color1 === undefined || color2 === undefined) return undefined;\n    // render target buffer parameters\n    const color_params_rgba = {\n      format,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    const color_params_float = {\n      format: rg32f,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n\n    // Create a render target with three color attachments\n    // Note: No depth buffer is attached here\n    return {\n      my_render_target: render.render_target({\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params_rgba,\n        [color1]: color_params_rgba,\n        [color2]: color_params_float,\n      }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    if (self === undefined) return;\n    // set target so all drawing is done to it\n    render.set_render_target(self.my_render_target);\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n  },\n});"
     },
     {
       "sourceHash": "e39f13af5d65d01d",
-      "ts": "// How to create a render target with multiple outputs:\nexport default defineRenderScript({\n  init() {\n    // render target buffer parameters\n    const color_params_rgba = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    const color_params_float = {\n      format: graphics.TEXTURE_FORMAT_RG32F,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n\n    // Create a render target with three color attachments\n    // Note: No depth buffer is attached here\n    return {\n      my_render_target: render.render_target({\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params_rgba,\n        [graphics.BUFFER_TYPE_COLOR1_BIT]: color_params_rgba,\n        [graphics.BUFFER_TYPE_COLOR2_BIT]: color_params_float,\n      }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    // enable target so all drawing is done to it\n    render.set_render_target(self.my_render_target);\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n  },\n});"
+      "ts": "// How to create a render target with multiple outputs:\nexport default defineRenderScript({\n  init() {\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGBA;\n    const rg32f = graphics.TEXTURE_FORMAT_RG32F;\n    if (format === undefined || rg32f === undefined) return undefined;\n    // render target buffer parameters\n    const color_params_rgba = {\n      format,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    const color_params_float = {\n      format: rg32f,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n\n    // Create a render target with three color attachments\n    // Note: No depth buffer is attached here\n    return {\n      my_render_target: render.render_target({\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params_rgba,\n        [graphics.BUFFER_TYPE_COLOR1_BIT]: color_params_rgba,\n        [graphics.BUFFER_TYPE_COLOR2_BIT]: color_params_float,\n      }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    if (self === undefined) return;\n    // enable target so all drawing is done to it\n    render.set_render_target(self.my_render_target);\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n  },\n});"
     },
     {
       "sourceHash": "582c319c90bcf7ad",
@@ -1500,7 +1458,7 @@
     },
     {
       "sourceHash": "eec69c97bf2815ed",
-      "ts": "// How to create a new render target and draw to it:\nexport default defineRenderScript({\n  init() {\n    // render target buffer parameters\n    const color_params = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    const depth_params = {\n      format: graphics.TEXTURE_FORMAT_DEPTH,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    return {\n      my_render_target: render.render_target({\n        sample_count: 4,\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params,\n        [graphics.BUFFER_TYPE_DEPTH_BIT]: depth_params,\n      }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    // enable target so all drawing is done to it\n    render.set_render_target(self.my_render_target);\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n  },\n});"
+      "ts": "// How to create a new render target and draw to it:\nexport default defineRenderScript({\n  init() {\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGBA;\n    if (format === undefined) return undefined;\n    // render target buffer parameters\n    const color_params = {\n      format,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    const depth_params = {\n      format: graphics.TEXTURE_FORMAT_DEPTH,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    return {\n      my_render_target: render.render_target({\n        sample_count: 4,\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params,\n        [graphics.BUFFER_TYPE_DEPTH_BIT]: depth_params,\n      }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    if (self === undefined) return;\n    // enable target so all drawing is done to it\n    render.set_render_target(self.my_render_target);\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n  },\n});"
     }
   ],
   "render.set_blend_equation_separate": [
@@ -1582,7 +1540,7 @@
   "render.set_render_target": [
     {
       "sourceHash": "c6e25f5038d19bee",
-      "ts": "// How to set a render target and draw to it and then switch back to the default render target\n// 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\nexport default defineRenderScript({\n  init() {\n    const color_params = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n    };\n    return {\n      my_render_target: render.render_target({ [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    // set render target so all drawing is done to it\n    render.set_render_target(self.my_render_target, {\n      transient: [graphics.BUFFER_TYPE_DEPTH_BIT, graphics.BUFFER_TYPE_STENCIL_BIT],\n    });\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n\n    // set default render target. This also invalidates the depth and stencil buffers of the current target (self.my_render_target)\n    //  which can be an optimisation on some hardware\n    render.set_render_target(render.RENDER_TARGET_DEFAULT);\n  },\n});"
+      "ts": "// How to set a render target and draw to it and then switch back to the default render target\n// 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\nexport default defineRenderScript({\n  init() {\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGBA;\n    if (format === undefined) return undefined;\n    const color_params = {\n      format,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n    };\n    return {\n      my_render_target: render.render_target({ [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    if (self === undefined) return;\n    // set render target so all drawing is done to it\n    render.set_render_target(self.my_render_target, {\n      transient: [graphics.BUFFER_TYPE_DEPTH_BIT, graphics.BUFFER_TYPE_STENCIL_BIT],\n    });\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n\n    // set default render target. This also invalidates the depth and stencil buffers of the current target (self.my_render_target)\n    //  which can be an optimisation on some hardware\n    render.set_render_target(render.RENDER_TARGET_DEFAULT);\n  },\n});"
     },
     {
       "sourceHash": "bb08db5e232c5b5e",
@@ -2151,7 +2109,7 @@
   "sys.load_buffer_async": [
     {
       "sourceHash": "91d84e7dc569ae20",
-      "ts": "function my_callback(self: unknown, request_id: unknown, result: unknown) {\n  const { status, buf } = result as { status: number; buf: Opaque<\"buffer\"> };\n  if (status === sys.REQUEST_STATUS_FINISHED) {\n    resource.set_texture(\"/my_texture\", { type: graphics.TEXTURE_TYPE_2D, width: 128, height: 128, format: graphics.TEXTURE_FORMAT_RGBA }, buf);\n  }\n}\n\nconst my_request = sys.load_buffer_async(\"/assets/my_level_data.bin\", my_callback);"
+      "ts": "function my_callback(self: unknown, request_id: unknown, result: unknown) {\n  const { status, buf } = result as { status: number; buf: ReturnType<typeof sys.load_buffer> };\n  if (status === sys.REQUEST_STATUS_FINISHED) {\n    resource.set_texture(\"/my_texture\", { type: graphics.TEXTURE_TYPE_2D, width: 128, height: 128, format: graphics.TEXTURE_FORMAT_RGBA }, buf);\n  }\n}\n\nconst my_request = sys.load_buffer_async(\"/assets/my_level_data.bin\", my_callback);"
     },
     {
       "sourceHash": "5545b8901e6ec4c5",
@@ -2261,7 +2219,7 @@
   "tilemap.get_tiles": [
     {
       "sourceHash": "61b14de4991f966b",
-      "ts": "const [left, bottom, columns_count, rows_count] = tilemap.get_bounds(\"#tilemap\");\nconst tiles = tilemap.get_tiles(\"#tilemap\", \"layer\");\nlet tile = 0;\nlet count = 0;\nfor (let row_index = bottom; row_index <= bottom + rows_count - 1; row_index++) {\n  for (let column_index = left; column_index <= left + columns_count - 1; column_index++) {\n    tile = tiles.get(row_index)?.get(column_index) ?? 0;\n    count = count + 1;\n  }\n}"
+      "ts": "const [left, bottom, columns_count, rows_count] = tilemap.get_bounds(\"#tilemap\");\nconst tiles = tilemap.get_tiles(\"#tilemap\", \"layer\");\nlet tile = 0;\nlet count = 0;\nfor (let row_index = bottom; row_index <= bottom + rows_count - 1; row_index++) {\n  for (let column_index = left; column_index <= left + columns_count - 1; column_index++) {\n    tile = tiles?.get(row_index)?.get(column_index) ?? 0;\n    count = count + 1;\n  }\n}"
     }
   ],
   "tilemap.reset_constant": [
@@ -2318,16 +2276,6 @@
       "ts": "function trigger_ticking(self: { handle: number }) {\n  self.handle = timer.delay(1, true, () => print(\"print every second or manually by timer.trigger\"));\n  // ...\n  const triggered = timer.trigger(self.handle);\n  if (!triggered) {\n    print(\"the timer is already cancelled or complete\");\n  }\n}"
     }
   ],
-  "update": [
-    {
-      "sourceHash": "1019c7620d797753",
-      "ts": "// This example demonstrates how to move a game object instance through the script component:\nexport default defineScript({\n  init() {\n    // set initial velocity to be 1 along world x-axis\n    return { my_velocity: vmath.vector3(1, 0, 0) };\n  },\n\n  update(self, dt) {\n    // move the game object instance\n    go.set_position(go.get_position().add(self.my_velocity.mul(dt)));\n  },\n});"
-    },
-    {
-      "sourceHash": "f4f87939dbdd5fc3",
-      "ts": "// This example demonstrates how to update a text node that displays game score\n// in a counting fashion. It is assumed that the gui component receives messages\n// from the game when a new score is to be shown.\nexport default defineGuiScript({\n  init() {\n    return {\n      // fetch the score text node for later use (assumes it is called \"score\")\n      score_node: gui.get_node(\"score\"),\n      // keep track of the current score counted up so far\n      current_score: 0,\n      // keep track of the target score we should count up to\n      target_score: 0,\n      // how fast we will update the score, in score/second\n      score_update_speed: 1,\n    };\n  },\n\n  update(self, dt) {\n    // check if target score is more than current score\n    if (self.current_score < self.target_score) {\n      // increment current score according to the speed\n      self.current_score = self.current_score + dt * self.score_update_speed;\n      // check if we went past the target score, clamp current score in that case\n      if (self.current_score > self.target_score) {\n        self.current_score = self.target_score;\n      }\n      // update the score text node\n      gui.set_text(self.score_node, \"\" + math.floor(self.current_score));\n    }\n  },\n\n  on_message(self, message_id, message) {\n    // check the message\n    if (message_id === hash(\"set_score\") && typeof message.score === \"number\") {\n      self.target_score = message.score;\n    }\n  },\n});"
-    }
-  ],
   "vmath.clamp": [
     {
       "sourceHash": "ce47102e76e3186d",

package/fixtures/messages_doc.json

@@ -1,7 +1,7 @@
 {
   "info": {
     "namespace": "builtin_messages",
-    "version": "1.13.0",
+    "version": "1.14.0",
     "description": "Defold's built-in message ids and the payload shape each one carries."
   },
   "messages": [
@@ -37,14 +37,14 @@
         {
           "name": "parent_id",
           "types": ["hash"],
-          "optional": true,
-          "doc": "Hash of the new parent (omit or nil to clear)."
+          "optional": false,
+          "doc": "The id of the new parent."
         },
         {
           "name": "keep_world_transform",
           "types": ["0", "1"],
-          "optional": true,
-          "doc": "1 to preserve world transform; 0 (default) to keep local transform."
+          "optional": false,
+          "doc": "If the world transform of the instance should be preserved when changing spaces, 0 for false and 1 for true. The default value is 1."
         }
       ]
     },
@@ -58,6 +58,18 @@
           "types": ["hash"],
           "optional": false,
           "doc": "Hashed animation id."
+        },
+        {
+          "name": "offset",
+          "types": ["number"],
+          "optional": false,
+          "doc": "Normalized initial value of the animation cursor when the animation starts playing."
+        },
+        {
+          "name": "playback_rate",
+          "types": ["number"],
+          "optional": false,
+          "doc": "Rate the animation plays at. Must be positive."
         }
       ]
     },
@@ -288,12 +300,6 @@
       "origin": "physics",
       "description": "Reported when an asynchronous ray cast hits nothing.",
       "payload": [
-        {
-          "name": "group",
-          "types": ["hash"],
-          "optional": false,
-          "doc": "Collision group mask used for the ray cast."
-        },
         {
           "name": "request_id",
           "types": ["number"],
@@ -383,7 +389,7 @@
         {
           "name": "gain",
           "types": ["number"],
-          "optional": false,
+          "optional": true,
           "doc": "Target gain between 0 and 1."
         }
       ]
@@ -396,7 +402,7 @@
         {
           "name": "play_id",
           "types": ["number"],
-          "optional": false,
+          "optional": true,
           "doc": "The id passed to play_sound."
         }
       ]
@@ -409,7 +415,7 @@
         {
           "name": "play_id",
           "types": ["number"],
-          "optional": false,
+          "optional": true,
           "doc": "The id passed to play_sound."
         }
       ]
@@ -507,31 +513,6 @@
         }
       ]
     },
-    {
-      "name": "set_view_projection",
-      "origin": "render",
-      "description": "Posted automatically by camera components to the render script with the active view and projection matrices.",
-      "payload": [
-        {
-          "name": "id",
-          "types": ["hash"],
-          "optional": false,
-          "doc": "Id of the camera component that posted the matrices."
-        },
-        {
-          "name": "view",
-          "types": ["matrix4"],
-          "optional": false,
-          "doc": "View matrix of the camera."
-        },
-        {
-          "name": "projection",
-          "types": ["matrix4"],
-          "optional": false,
-          "doc": "Projection matrix of the camera."
-        }
-      ]
-    },
     {
       "name": "draw_line",
       "origin": "render",

package/generated/b2d_world.d.ts

@@ -26,7 +26,7 @@ declare global {
      * @param filter - optional query filter
      * @param max_results - optional maximum result count
      */
-    function cast_ray(world: Opaque<"b2World">, origin: Vector3, translation: Vector3, filter?: b2d.query_filter, max_results?: number): LuaMultiReturn<[b2d.fixture_cast_hit[], b2d.tree_stats]>;
+    function cast_ray<Backend extends "v2" = "v2">(world: Opaque<"b2World">, origin: Vector3, translation: Vector3, filter?: b2d.query_filter, max_results?: number): LuaMultiReturn<[b2d.fixture_cast_hit[], b2d.tree_stats]>;
     /**
      * The translation is the ray displacement from `origin`. Result order is not
      * guaranteed by Box2D.
@@ -37,7 +37,7 @@ declare global {
      * @param filter - optional query filter
      * @param max_results - optional maximum result count. Omit or pass 0 for unlimited results.
      */
-    function cast_ray(world: Opaque<"b2World">, origin: Vector3, translation: Vector3, filter?: b2d.query_filter, max_results?: number): LuaMultiReturn<[b2d.shape_cast_hit[], b2d.tree_stats]>;
+    function cast_ray<Backend extends "v3">(world: Opaque<"b2World">, origin: Vector3, translation: Vector3, filter?: b2d.query_filter, max_results?: number): LuaMultiReturn<[b2d.shape_cast_hit[], b2d.tree_stats]>;
     /**
      * Cast a ray and return the closest hit.
      *
@@ -47,7 +47,7 @@ declare global {
      * @param filter - optional query filter
      * @returns closest hit, or `nil`
      */
-    function cast_ray_closest(world: Opaque<"b2World">, origin: Vector3, translation: Vector3, filter?: b2d.query_filter): b2d.fixture_cast_hit | undefined;
+    function cast_ray_closest<Backend extends "v2" = "v2">(world: Opaque<"b2World">, origin: Vector3, translation: Vector3, filter?: b2d.query_filter): b2d.fixture_cast_hit | undefined;
     /**
      * The translation is the ray displacement from `origin`.
      *
@@ -57,7 +57,7 @@ declare global {
      * @param filter - optional query filter
      * @returns closest hit, or `nil`
      */
-    function cast_ray_closest(world: Opaque<"b2World">, origin: Vector3, translation: Vector3, filter?: b2d.query_filter): b2d.shape_cast_hit | undefined;
+    function cast_ray_closest<Backend extends "v3">(world: Opaque<"b2World">, origin: Vector3, translation: Vector3, filter?: b2d.query_filter): b2d.shape_cast_hit | undefined;
     /**
      * Uses Box2D v2 time-of-impact for fixture child shapes that support distance proxies.
      * Grid fixture children are skipped.
@@ -68,7 +68,7 @@ declare global {
      * @param filter - optional query filter
      * @param max_results - optional maximum result count
      */
-    function cast_shape(world: Opaque<"b2World">, shape: { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; hx: number; hy: number; center?: Vector3; angle?: number } | { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; vertices: Vector3[] } | { type: typeof b2d.shape.SHAPE_TYPE_CIRCLE; radius: number; center?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CAPSULE; radius: number; center1: Vector3; center2: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_EDGE | typeof b2d.shape.SHAPE_TYPE_SEGMENT; v1: Vector3; v2: Vector3; v0?: Vector3; v3?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CHAIN; vertices: Vector3[]; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, translation: Vector3, filter?: b2d.query_filter, max_results?: number): LuaMultiReturn<[b2d.fixture_cast_hit[], b2d.tree_stats]>;
+    function cast_shape<Backend extends "v2" = "v2">(world: Opaque<"b2World">, shape: { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; hx: number; hy: number; center?: Vector3; angle?: number } | { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; vertices: Vector3[] } | { type: typeof b2d.shape.SHAPE_TYPE_CIRCLE; radius: number; center?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CAPSULE; radius: number; center1: Vector3; center2: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_EDGE | typeof b2d.shape.SHAPE_TYPE_SEGMENT; v1: Vector3; v2: Vector3; v0?: Vector3; v3?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CHAIN; vertices: Vector3[]; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, translation: Vector3, filter?: b2d.query_filter, max_results?: number): LuaMultiReturn<[b2d.fixture_cast_hit[], b2d.tree_stats]>;
     /**
      * The translation is the shape displacement.
      *
@@ -78,7 +78,7 @@ declare global {
      * @param filter - optional query filter
      * @param max_results - optional maximum result count. Omit or pass 0 for unlimited results.
      */
-    function cast_shape(world: Opaque<"b2World">, shape: { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; hx: number; hy: number; center?: Vector3; angle?: number } | { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; vertices: Vector3[] } | { type: typeof b2d.shape.SHAPE_TYPE_CIRCLE; radius: number; center?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CAPSULE; radius: number; center1: Vector3; center2: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_EDGE | typeof b2d.shape.SHAPE_TYPE_SEGMENT; v1: Vector3; v2: Vector3; v0?: Vector3; v3?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CHAIN; vertices: Vector3[]; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, translation: Vector3, filter?: b2d.query_filter, max_results?: number): LuaMultiReturn<[b2d.shape_cast_hit[], b2d.tree_stats]>;
+    function cast_shape<Backend extends "v3">(world: Opaque<"b2World">, shape: { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; hx: number; hy: number; center?: Vector3; angle?: number } | { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; vertices: Vector3[] } | { type: typeof b2d.shape.SHAPE_TYPE_CIRCLE; radius: number; center?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CAPSULE; radius: number; center1: Vector3; center2: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_EDGE | typeof b2d.shape.SHAPE_TYPE_SEGMENT; v1: Vector3; v2: Vector3; v0?: Vector3; v3?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CHAIN; vertices: Vector3[]; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, translation: Vector3, filter?: b2d.query_filter, max_results?: number): LuaMultiReturn<[b2d.shape_cast_hit[], b2d.tree_stats]>;
     /**
      * Collide a mover capsule against the world.
      *
@@ -220,7 +220,7 @@ declare global {
      * - `fixtures` — overlapping fixtures. **⚠️ `index` is 1-based; passed to Defold unchanged.**
      * - `stats` — broad-phase query statistics
      */
-    function overlap_aabb(world: Opaque<"b2World">, aabb: b2d.aabb, filter?: b2d.query_filter, max_results?: number): LuaMultiReturn<[b2d.fixture_info[], b2d.tree_stats]>;
+    function overlap_aabb<Backend extends "v2" = "v2">(world: Opaque<"b2World">, aabb: b2d.aabb, filter?: b2d.query_filter, max_results?: number): LuaMultiReturn<[b2d.fixture_info[], b2d.tree_stats]>;
     /**
      * Find shapes overlapping an AABB.
      *
@@ -229,7 +229,7 @@ declare global {
      * @param filter - optional query filter
      * @param max_results - optional maximum result count. Omit or pass 0 for unlimited results.
      */
-    function overlap_aabb(world: Opaque<"b2World">, aabb: b2d.aabb, filter?: b2d.query_filter, max_results?: number): LuaMultiReturn<[b2d.shape_info[], b2d.tree_stats]>;
+    function overlap_aabb<Backend extends "v3">(world: Opaque<"b2World">, aabb: b2d.aabb, filter?: b2d.query_filter, max_results?: number): LuaMultiReturn<[b2d.shape_info[], b2d.tree_stats]>;
     /**
      * Overlap a shape.
      *
@@ -241,7 +241,7 @@ declare global {
      * - `fixtures` — overlapping fixtures. **⚠️ `index` is 1-based; passed to Defold unchanged.**
      * - `stats` — broad-phase query statistics
      */
-    function overlap_shape(world: Opaque<"b2World">, shape: { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; hx: number; hy: number; center?: Vector3; angle?: number } | { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; vertices: Vector3[] } | { type: typeof b2d.shape.SHAPE_TYPE_CIRCLE; radius: number; center?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CAPSULE; radius: number; center1: Vector3; center2: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_EDGE | typeof b2d.shape.SHAPE_TYPE_SEGMENT; v1: Vector3; v2: Vector3; v0?: Vector3; v3?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CHAIN; vertices: Vector3[]; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, filter?: b2d.query_filter, max_results?: number): LuaMultiReturn<[b2d.fixture_info[], b2d.tree_stats]>;
+    function overlap_shape<Backend extends "v2" = "v2">(world: Opaque<"b2World">, shape: { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; hx: number; hy: number; center?: Vector3; angle?: number } | { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; vertices: Vector3[] } | { type: typeof b2d.shape.SHAPE_TYPE_CIRCLE; radius: number; center?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CAPSULE; radius: number; center1: Vector3; center2: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_EDGE | typeof b2d.shape.SHAPE_TYPE_SEGMENT; v1: Vector3; v2: Vector3; v0?: Vector3; v3?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CHAIN; vertices: Vector3[]; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, filter?: b2d.query_filter, max_results?: number): LuaMultiReturn<[b2d.fixture_info[], b2d.tree_stats]>;
     /**
      * Find shapes overlapping a shape proxy.
      *
@@ -250,7 +250,7 @@ declare global {
      * @param filter - optional query filter
      * @param max_results - optional maximum result count. Omit or pass 0 for unlimited results.
      */
-    function overlap_shape(world: Opaque<"b2World">, shape: { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; hx: number; hy: number; center?: Vector3; angle?: number } | { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; vertices: Vector3[] } | { type: typeof b2d.shape.SHAPE_TYPE_CIRCLE; radius: number; center?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CAPSULE; radius: number; center1: Vector3; center2: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_EDGE | typeof b2d.shape.SHAPE_TYPE_SEGMENT; v1: Vector3; v2: Vector3; v0?: Vector3; v3?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CHAIN; vertices: Vector3[]; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, filter?: b2d.query_filter, max_results?: number): LuaMultiReturn<[b2d.shape_info[], b2d.tree_stats]>;
+    function overlap_shape<Backend extends "v3">(world: Opaque<"b2World">, shape: { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; hx: number; hy: number; center?: Vector3; angle?: number } | { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; vertices: Vector3[] } | { type: typeof b2d.shape.SHAPE_TYPE_CIRCLE; radius: number; center?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CAPSULE; radius: number; center1: Vector3; center2: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_EDGE | typeof b2d.shape.SHAPE_TYPE_SEGMENT; v1: Vector3; v2: Vector3; v0?: Vector3; v3?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CHAIN; vertices: Vector3[]; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, filter?: b2d.query_filter, max_results?: number): LuaMultiReturn<[b2d.shape_info[], b2d.tree_stats]>;
     /**
      * Rebuild the static broad-phase tree.
      *