@defold-typescript/types 0.37.0 → 0.39.0

package/examples/translations.json

@@ -2,7 +2,7 @@
   "b2d.body.create_chain": [
     {
       "sourceHash": "a4547c6be36805bc",
-      "ts": "const [chain, segments] = b2d.body.create_chain(body, {\n  vertices: [vmath.vector3(-64, 0, 0), vmath.vector3(0, 16, 0), vmath.vector3(64, 0, 0)],\n  prev_vertex: vmath.vector3(-96, 0, 0), next_vertex: vmath.vector3(96, 0, 0), friction: 0.6,\n});"
+      "ts": "const body = b2d.get_body(\"#collisionobject\");\nif (body !== undefined) {\n  const [chain, segments] = b2d.body.create_chain(body, {\n    vertices: [vmath.vector3(-64, 0, 0), vmath.vector3(0, 16, 0), vmath.vector3(64, 0, 0)],\n    prev_vertex: vmath.vector3(-96, 0, 0), next_vertex: vmath.vector3(96, 0, 0), friction: 0.6,\n  });\n}"
     }
   ],
   "b2d.body.create_fixture": [
@@ -26,13 +26,13 @@
   "buffer.copy_buffer": [
     {
       "sourceHash": "314e1246a630d761",
-      "ts": "// How to copy elements (e.g. vertices) from one buffer to another\n// copy entire buffer\nbuffer.copy_buffer(dstbuffer, 0, srcbuffer, 0, srcbuffer.length);\n\n// copy last 10 elements to the front of another buffer\nbuffer.copy_buffer(dstbuffer, 0, srcbuffer, srcbuffer.length - 10, 10);"
+      "ts": "// How to copy elements (e.g. vertices) from one buffer to another\nconst element_count = 64;\nconst srcbuffer = resource.get_buffer(\"/src.bufferc\");\nconst dstbuffer = resource.get_buffer(\"/dst.bufferc\");\n\n// copy entire buffer\nbuffer.copy_buffer(dstbuffer, 0, srcbuffer, 0, element_count);\n\n// copy last 10 elements to the front of another buffer\nbuffer.copy_buffer(dstbuffer, 0, srcbuffer, element_count - 10, 10);"
     }
   ],
   "buffer.copy_stream": [
     {
       "sourceHash": "359ea94639622db5",
-      "ts": "// How to update a texture of a sprite:\n// copy entire stream\nconst srcstream = buffer.get_stream(srcbuffer, hash(\"xyz\"));\nconst dststream = buffer.get_stream(dstbuffer, hash(\"xyz\"));\nbuffer.copy_stream(dststream, 0, srcstream, 0, srcstream.length);"
+      "ts": "// How to update a texture of a sprite:\nconst srcbuffer = resource.get_buffer(\"/src.bufferc\");\nconst dstbuffer = resource.get_buffer(\"/dst.bufferc\");\n\n// copy entire stream\nconst srcstream = buffer.get_stream(srcbuffer, hash(\"xyz\"));\nconst dststream = buffer.get_stream(dstbuffer, hash(\"xyz\"));\nbuffer.copy_stream(dststream, 0, srcstream, 0, srcstream.length);"
     }
   ],
   "buffer.create": [
@@ -44,19 +44,19 @@
   "buffer.get_metadata": [
     {
       "sourceHash": "fab020678d7483db",
-      "ts": "// How to get a metadata entry from a buffer\n// retrieve a metadata entry named \"somefloats\" and its numeric type\nconst [values, type] = buffer.get_metadata(buf, hash(\"somefloats\"));\nif (values) print(`${values.length} values in 'somefloats'`);"
+      "ts": "// How to get a metadata entry from a buffer\nconst buf = resource.get_buffer(\"/my.bufferc\");\n\n// retrieve a metadata entry named \"somefloats\" and its numeric type\nconst [values, type] = buffer.get_metadata(buf, hash(\"somefloats\"));\nif (values) print(`${values.length} values in 'somefloats'`);"
     }
   ],
   "buffer.set_metadata": [
     {
       "sourceHash": "d2835d9dc456523a",
-      "ts": "// How to set a metadata entry on a buffer\n// create a new metadata entry with three floats\nbuffer.set_metadata(buf, hash(\"somefloats\"), [1.5, 3.2, 7.9], buffer.VALUE_TYPE_FLOAT32);\n// ...\n// update to a new set of values\nbuffer.set_metadata(buf, hash(\"somefloats\"), [-2.5, 10.0, 32.2], buffer.VALUE_TYPE_FLOAT32);"
+      "ts": "// How to set a metadata entry on a buffer\nconst buf = resource.get_buffer(\"/my.bufferc\");\n\n// create a new metadata entry with three floats\nbuffer.set_metadata(buf, hash(\"somefloats\"), [1.5, 3.2, 7.9], buffer.VALUE_TYPE_FLOAT32);\n// ...\n// update to a new set of values\nbuffer.set_metadata(buf, hash(\"somefloats\"), [-2.5, 10.0, 32.2], buffer.VALUE_TYPE_FLOAT32);"
     }
   ],
   "camera.get_cameras": [
     {
       "sourceHash": "d332d9320898b958",
-      "ts": "for (const camera_id of camera.get_cameras()) {\n  render.set_camera(camera_id);\n  render.draw(predicate);\n  render.set_camera();\n}"
+      "ts": "const predicate = render.predicate([hash(\"my_tag\")]);\nfor (const camera_id of camera.get_cameras()) {\n  render.set_camera(camera_id);\n  render.draw(predicate);\n  render.set_camera();\n}"
     }
   ],
   "camera.screen_to_world": [
@@ -80,7 +80,7 @@
   "collectionfactory.create": [
     {
       "sourceHash": "5a49721288808772",
-      "ts": "// How to spawn a collection of game objects:\nexport default defineScript({\n  init(self) {\n    // Spawn a small group of enemies.\n    const pos = vmath.vector3(100, 12.5, 0);\n    const rot = vmath.quat_rotation_z(Math.PI / 2);\n    const scale = 0.5;\n    const props = {\n      [hash(\"/enemy_leader\")]: { health: 1000.0 },\n      [hash(\"/enemy_1\")]: { health: 200.0 },\n      [hash(\"/enemy_2\")]: { health: 400.0, color: hash(\"green\") },\n    };\n\n    self.enemy_ids = collectionfactory.create(\"#enemyfactory\", pos, rot, props, scale);\n    // enemy_ids now map to the spawned instance ids:\n    //\n    // pprint(self.enemy_ids)\n    //\n    // DEBUG:SCRIPT:\n    // {\n    //   hash: [/enemy_leader] = hash: [/collection0/enemy_leader],\n    //   hash: [/enemy_1] = hash: [/collection0/enemy_1],\n    //   hash: [/enemy_2] = hash: [/collection0/enemy_2]\n    // }\n\n    // Send \"attack\" message to the leader. First look up its instance id.\n    const leader_id = self.enemy_ids[hash(\"/enemy_leader\")];\n    msg.post(leader_id, \"attack\");\n  },\n});\n\n// How to delete a spawned collection:\ngo.delete(self.enemy_ids);"
+      "ts": "// How to spawn a collection of game objects:\nexport default defineScript({\n  init(self) {\n    // Spawn a small group of enemies.\n    const pos = vmath.vector3(100, 12.5, 0);\n    const rot = vmath.quat_rotation_z(Math.PI / 2);\n    const scale = 0.5;\n    const props = {\n      [hash(\"/enemy_leader\")]: { health: 1000.0 },\n      [hash(\"/enemy_1\")]: { health: 200.0 },\n      [hash(\"/enemy_2\")]: { health: 400.0, color: hash(\"green\") },\n    };\n\n    self.enemy_ids = collectionfactory.create(\"#enemyfactory\", pos, rot, props, scale);\n    // enemy_ids now map to the spawned instance ids:\n    //\n    // pprint(self.enemy_ids)\n    //\n    // DEBUG:SCRIPT:\n    // {\n    //   hash: [/enemy_leader] = hash: [/collection0/enemy_leader],\n    //   hash: [/enemy_1] = hash: [/collection0/enemy_1],\n    //   hash: [/enemy_2] = hash: [/collection0/enemy_2]\n    // }\n\n    // Send \"attack\" message to the leader. First look up its instance id.\n    const leader_id = self.enemy_ids[hash(\"/enemy_leader\")];\n    msg.post(leader_id, \"attack\");\n  },\n});\n\n// How to delete a spawned collection:\nfunction delete_enemies(self: { enemy_ids: Hash[] }) {\n  go.delete(self.enemy_ids);\n}"
     }
   ],
   "collectionfactory.load": [
@@ -104,7 +104,7 @@
   "collectionproxy.get_resources": [
     {
       "sourceHash": "5bba0e0917a2a842",
-      "ts": "function print_resources(self, cproxy) {\n  const resources = collectionproxy.get_resources(cproxy);\n  for (const v of resources) {\n    print(`Resource: ${v}`);\n  }\n}"
+      "ts": "function print_resources(self: unknown, cproxy: Url) {\n  const resources = collectionproxy.get_resources(cproxy);\n  for (const v of resources) {\n    print(`Resource: ${v}`);\n  }\n}"
     }
   ],
   "collectionproxy.load": [
@@ -253,32 +253,52 @@
   ],
   "go.animate": [
     {
-      "sourceHash": "ec6a31d150125e06",
-      "ts": "// Animate the position of a game object to x = 10 during 1 second, then\n// y = 20 during 1 second:\ngo.animate(go.get_id(), \"position.x\", go.PLAYBACK_ONCE_FORWARD, 10, go.EASING_LINEAR, 1, 0, () => {\n  go.animate(go.get_id(), \"position.y\", go.PLAYBACK_ONCE_FORWARD, 20, go.EASING_LINEAR, 1);\n});\n\n// Animate the y position of a game object using a crazy custom easing curve:\nconst values = [\n  0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1,\n  0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1,\n  0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1,\n  0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1,\n];\nconst vec = vmath.vector(values);\ngo.animate(\"go\", \"position.y\", go.PLAYBACK_LOOP_PINGPONG, 100, vec, 2.0);"
+      "sourceHash": "c4fc72e0b8812778",
+      "ts": "go.animate(go.get_id(), \"position.x\", go.PLAYBACK_ONCE_FORWARD, 10, go.EASING_LINEAR, 1, 0, () => {\n  go.animate(go.get_id(), \"position.y\", go.PLAYBACK_ONCE_FORWARD, 20, go.EASING_LINEAR, 1);\n});"
+    },
+    {
+      "sourceHash": "97218eef909de34f",
+      "ts": "const values = [\n  0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1,\n  0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1,\n  0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1,\n  0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1,\n];\nconst vec = vmath.vector(values);\ngo.animate(\"go\", \"position.y\", go.PLAYBACK_LOOP_PINGPONG, 100, vec, 2.0);"
     }
   ],
   "go.cancel_animations": [
     {
-      "sourceHash": "4f012d6eb3d73ce9",
-      "ts": "// Cancel the animation of the position of a game object:\ngo.cancel_animations(go.get_id(), \"position\");\n\n// Cancel all property animations of the current game object:\ngo.cancel_animations(\".\");\n\n// Cancel all property animations of the sprite component of the current game object:\ngo.cancel_animations(\"#sprite\");"
+      "sourceHash": "86ed1a1a22f1883a",
+      "ts": "go.cancel_animations(go.get_id(), \"position\");"
+    },
+    {
+      "sourceHash": "a56dbdf46c4ad3b2",
+      "ts": "go.cancel_animations(\".\");"
+    },
+    {
+      "sourceHash": "997c90a6a68b8f88",
+      "ts": "go.cancel_animations(\"#sprite\");"
     }
   ],
   "go.delete": [
     {
-      "sourceHash": "63517a8a15d5d030",
-      "ts": "// This example demonstrates how to delete game objects:\n// Delete the script's own game object.\ngo.delete();\n// Delete a game object with the id \"my_game_object\".\nconst id = go.get_id(\"my_game_object\");\ngo.delete(id);\n// Delete a list of game objects.\nconst ids = [hash(\"/my_object_1\"), hash(\"/my_object_2\"), hash(\"/my_object_3\")];\ngo.delete(ids);\n\n// This example demonstrates how to delete game objects and their children\n// (child-to-parent order):\n// Delete the script's own game object and its children.\ngo.delete(true);\n// Delete a game object with the id \"my_game_object\" and its children.\nconst id2 = go.get_id(\"my_game_object\");\ngo.delete(id2, true);\n// Delete a list of game objects and their children.\nconst ids2 = [hash(\"/my_object_1\"), hash(\"/my_object_2\"), hash(\"/my_object_3\")];\ngo.delete(ids2, true);"
+      "sourceHash": "eb1a20098678b7b1",
+      "ts": "// Delete the script's own game object.\ngo.delete();\n// Delete a game object with the id \"my_game_object\".\nconst id = go.get_id(\"my_game_object\");\ngo.delete(id);\n// Delete a list of game objects.\nconst ids = [hash(\"/my_object_1\"), hash(\"/my_object_2\"), hash(\"/my_object_3\")];\ngo.delete(ids);"
+    },
+    {
+      "sourceHash": "15be7513485334cf",
+      "ts": "// Delete the script's own game object and its children.\ngo.delete(true);\n// Delete a game object with the id \"my_game_object\" and its children.\nconst id = go.get_id(\"my_game_object\");\ngo.delete(id, true);\n// Delete a list of game objects and their children.\nconst ids = [hash(\"/my_object_1\"), hash(\"/my_object_2\"), hash(\"/my_object_3\")];\ngo.delete(ids, true);"
     }
   ],
   "go.exists": [
     {
-      "sourceHash": "377b4eb5d71df398",
-      "ts": "// Check if game object \"my_game_object\" exists in the current collection:\ngo.exists(\"/my_game_object\");\n\n// Check if game object exists in another collection:\ngo.exists(\"other_collection:/my_game_object\");"
+      "sourceHash": "610b20b7cdbe9792",
+      "ts": "go.exists(\"/my_game_object\");"
+    },
+    {
+      "sourceHash": "902851e29bcce669",
+      "ts": "go.exists(\"other_collection:/my_game_object\");"
     }
   ],
   "go.get": [
     {
       "sourceHash": "7cac2203eda50a5e",
-      "ts": "// Get a property \"speed\" from a script \"player\"; the property must be declared\n// in the player script:\ngo.property(\"speed\", 50);\n\n// Then in the calling script (assumed to belong to the same game object, but it\n// does not have to):\nconst speed = go.get(\"#player\", \"speed\");\n\n// Get a value in a material property array (the glsl indices are 0-based):\ngo.get(url, \"example\", { index: 1 }); // the first vector4 in the array: example[0]\ngo.get(url, \"example\", { index: 16 }); // the last vector4 in the array: example[15]\ngo.get(url, \"example.x\", { index: 1 }); // an element of a vector4: example[0].x\n\n// Get all values in a material property array as a table:\ngo.get(url, \"example\"); // => [vector4, vector4, ...]\ngo.get(url, \"example.x\"); // => [number1, number2, ...]\n\n// Get a named property (the resource of a certain gui font):\nconst font_hash = go.get(\"#gui\", \"fonts\", { key: \"system_font_BIG\" });\n\n// Get a property from a sub-component, using the \"keys\" options table\n// (addressing the first level of a component):\ngo.get(\"#particlefx\", \"material\", { keys: [\"cone_emitter\"] });\n\n// Get a property in a deeper sub-hierarchy (if the component supports it).\n// Note: no built-in component supports this yet, but a custom one could.\ngo.get(\"#my_component\", \"some_property\", { keys: [\"root\", \"child_node\"] });"
+      "ts": "// Get a property \"speed\" from a script \"player\"; the property must be declared\n// in the player script:\ngo.property(\"speed\", 50);\n\n// Then in the calling script (assumed to belong to the same game object, but it\n// does not have to):\nconst speed = go.get(\"#player\", \"speed\");\n\n// Get a value in a material property array (the glsl indices are 0-based):\nconst url = msg.url(\"#mesh\");\ngo.get(url, \"example\", { index: 1 }); // the first vector4 in the array: example[0]\ngo.get(url, \"example\", { index: 16 }); // the last vector4 in the array: example[15]\ngo.get(url, \"example.x\", { index: 1 }); // an element of a vector4: example[0].x\n\n// Get all values in a material property array as a table:\ngo.get(url, \"example\"); // => [vector4, vector4, ...]\ngo.get(url, \"example.x\"); // => [number1, number2, ...]\n\n// Get a named property (the resource of a certain gui font):\nconst font_hash = go.get(\"#gui\", \"fonts\", { key: \"system_font_BIG\" });\n\n// Get a property from a sub-component, using the \"keys\" options table\n// (addressing the first level of a component):\ngo.get(\"#particlefx\", \"material\", { keys: [\"cone_emitter\"] });\n\n// Get a property in a deeper sub-hierarchy (if the component supports it).\n// Note: no built-in component supports this yet, but a custom one could.\ngo.get(\"#my_component\", \"some_property\", { keys: [\"root\", \"child_node\"] });"
     }
   ],
   "go.get_id": [
@@ -289,62 +309,102 @@
   ],
   "go.get_parent": [
     {
-      "sourceHash": "6e98305fd4cd8f14",
-      "ts": "// Get parent of the instance containing the calling script:\nconst parent_id = go.get_parent();\n\n// Get parent of the instance with id \"x\":\nconst parent_id2 = go.get_parent(\"x\");"
+      "sourceHash": "434d482e8248704d",
+      "ts": "const parent_id = go.get_parent();"
+    },
+    {
+      "sourceHash": "668765191be47af9",
+      "ts": "const parent_id = go.get_parent(\"x\");"
     }
   ],
   "go.get_position": [
     {
-      "sourceHash": "958a14823ca50504",
-      "ts": "// Get the position of the game object the script is attached to:\nconst p = go.get_position();\n\n// Get the position of another game object \"my_gameobject\":\nconst pos = go.get_position(\"my_gameobject\");"
+      "sourceHash": "37ab8f7b8b14f4ea",
+      "ts": "const p = go.get_position();"
+    },
+    {
+      "sourceHash": "75d15265b5277990",
+      "ts": "const pos = go.get_position(\"my_gameobject\");"
     }
   ],
   "go.get_rotation": [
     {
-      "sourceHash": "46e4f7ff790322c3",
-      "ts": "// Get the rotation of the game object the script is attached to:\nconst r = go.get_rotation();\n\n// Get the rotation of another game object with id \"x\":\nconst r2 = go.get_rotation(\"x\");"
+      "sourceHash": "9789a55fd1d86205",
+      "ts": "const r = go.get_rotation();"
+    },
+    {
+      "sourceHash": "871aa52a5ec2b871",
+      "ts": "const r = go.get_rotation(\"x\");"
     }
   ],
   "go.get_scale": [
     {
-      "sourceHash": "b6a9bd9d19741cdd",
-      "ts": "// Get the scale of the game object the script is attached to:\nconst s = go.get_scale();\n\n// Get the scale of another game object with id \"x\":\nconst s2 = go.get_scale(\"x\");"
+      "sourceHash": "e213e818ecd4cb1c",
+      "ts": "const s = go.get_scale();"
+    },
+    {
+      "sourceHash": "d91ff62c48d3223a",
+      "ts": "const s = go.get_scale(\"x\");"
     }
   ],
   "go.get_scale_uniform": [
     {
-      "sourceHash": "0add83a46d3434c3",
-      "ts": "// Get the uniform scale of the game object the script is attached to:\nconst s = go.get_scale_uniform();\n\n// Get the uniform scale of another game object with id \"x\":\nconst s2 = go.get_scale_uniform(\"x\");"
+      "sourceHash": "d63cb41c211275d3",
+      "ts": "const s = go.get_scale_uniform();"
+    },
+    {
+      "sourceHash": "99ee7b666f1b339b",
+      "ts": "const s = go.get_scale_uniform(\"x\");"
     }
   ],
   "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 — relative addressing, no socket prefix:\nconst p2 = go.get_world_position(\"x\");"
+      "sourceHash": "6e33af505543920b",
+      "ts": "const p = go.get_world_position();"
+    },
+    {
+      "sourceHash": "147cd749a9dc03d3",
+      "ts": "// Relative addressing by id — no socket prefix:\nconst p = go.get_world_position(\"x\");"
     }
   ],
   "go.get_world_rotation": [
     {
-      "sourceHash": "05c7e59676f614f9",
-      "ts": "// Get the world rotation of the game object the script is attached to:\nconst r = go.get_world_rotation();\n\n// Get the world rotation of another game object with id \"x\":\nconst r2 = go.get_world_rotation(\"x\");"
+      "sourceHash": "034bc38d83c5bbec",
+      "ts": "const r = go.get_world_rotation();"
+    },
+    {
+      "sourceHash": "ca4f41fe8d61dd4a",
+      "ts": "const r = go.get_world_rotation(\"x\");"
     }
   ],
   "go.get_world_scale": [
     {
-      "sourceHash": "bbbe0d3b0c6a9153",
-      "ts": "// Get the world 3D scale of the game object the script is attached to:\nconst s = go.get_world_scale();\n\n// Get the world scale of another game object \"x\":\nconst s2 = go.get_world_scale(\"x\");"
+      "sourceHash": "5966d75fdfac664f",
+      "ts": "const s = go.get_world_scale();"
+    },
+    {
+      "sourceHash": "7f93e96d6c6d567f",
+      "ts": "const s = go.get_world_scale(\"x\");"
     }
   ],
   "go.get_world_scale_uniform": [
     {
-      "sourceHash": "14162dd238db34dd",
-      "ts": "// Get the world uniform scale of the game object the script is attached to:\nconst s = go.get_world_scale_uniform();\n\n// Get the world uniform scale of another game object with id \"x\":\nconst s2 = go.get_world_scale_uniform(\"x\");"
+      "sourceHash": "22473e9aa97e88ec",
+      "ts": "const s = go.get_world_scale_uniform();"
+    },
+    {
+      "sourceHash": "5d546c291638cc4a",
+      "ts": "const s = go.get_world_scale_uniform(\"x\");"
     }
   ],
   "go.get_world_transform": [
     {
-      "sourceHash": "832de2e98a73e953",
-      "ts": "// Get the world transform of the game object the script is attached to:\nconst m = go.get_world_transform();\n\n// Get the world transform of another game object with id \"x\":\nconst m2 = go.get_world_transform(\"x\");"
+      "sourceHash": "2839422dc878a66f",
+      "ts": "const m = go.get_world_transform();"
+    },
+    {
+      "sourceHash": "50412f3fb6a3e39f",
+      "ts": "const m = go.get_world_transform(\"x\");"
     }
   ],
   "go.property": [
@@ -356,43 +416,71 @@
   "go.set": [
     {
       "sourceHash": "2ca1763ad71c1232",
-      "ts": "// Set a property \"speed\" of a script \"player\"; the property must be declared in\n// the player script:\ngo.property(\"speed\", 50);\n\n// Then in the calling script (assumed to belong to the same game object, but it\n// does not have to):\ngo.set(\"#player\", \"speed\", 100);\n\n// Set a vector4 in a material property array (the glsl indices are 0-based):\ngo.set(url, \"example\", vmath.vector4(1, 1, 1, 1), { index: 1 }); // example[0] = v\ngo.set(url, \"example\", vmath.vector4(2, 2, 2, 2), { index: 16 }); // example[15] = v\ngo.set(url, \"example.x\", 7, { index: 1 }); // example[0].x = 7\n\n// Set a material property array by a table of vector4 (only the first two are\n// set; extra array elements are ignored):\ngo.set(url, \"example\", [vmath.vector4(1, 1, 1, 1), vmath.vector4(2, 2, 2, 2)]);\n\n// Set a named property (inside init(self)):\ngo.property(\"big_font\", resource.font());\ngo.set(\"#gui\", \"fonts\", self.big_font, { key: \"system_font_BIG\" });\n\n// Set a property on a sub-component, using the \"keys\" options table (inside\n// init(self)):\ngo.property(\"my_material\", resource.material);\ngo.set(\"#particlefx\", \"material\", self.my_material, { keys: [\"cone_emitter\"] });\n\n// Set a property in a deeper sub-hierarchy (if the component supports it).\n// Note: no built-in component supports this yet, but a custom one could.\ngo.set(\"#my_component\", \"some_property\", some_value, { keys: [\"root\", \"child_node\"] });"
+      "ts": "// Set a property \"speed\" of a script \"player\"; the property must be declared in\n// the player script:\ngo.property(\"speed\", 50);\n\n// Then in the calling script (assumed to belong to the same game object, but it\n// does not have to):\ngo.set(\"#player\", \"speed\", 100);\n\n// Set a vector4 in a material property array (the glsl indices are 0-based):\nconst url = msg.url(\"#mesh\");\ngo.set(url, \"example\", vmath.vector4(1, 1, 1, 1), { index: 1 }); // example[0] = v\ngo.set(url, \"example\", vmath.vector4(2, 2, 2, 2), { index: 16 }); // example[15] = v\ngo.set(url, \"example.x\", 7, { index: 1 }); // example[0].x = 7\n\n// Set a material property array by a table of vector4 (only the first two are\n// set; extra array elements are ignored):\ngo.set(url, \"example\", [vmath.vector4(1, 1, 1, 1), vmath.vector4(2, 2, 2, 2)]);\n\n// Set a named property (inside init(self)):\ngo.property(\"big_font\", resource.font());\n\nfunction set_named_font(self: { big_font: Hash }) {\n  go.set(\"#gui\", \"fonts\", self.big_font, { key: \"system_font_BIG\" });\n}\n\n// Set a property on a sub-component, using the \"keys\" options table (inside\n// init(self)):\ngo.property(\"my_material\", resource.material);\n\nfunction set_sub_component_material(self: { my_material: Hash }) {\n  go.set(\"#particlefx\", \"material\", self.my_material, { keys: [\"cone_emitter\"] });\n}\n\n// Set a property in a deeper sub-hierarchy (if the component supports it).\n// Note: no built-in component supports this yet, but a custom one could.\nconst some_value = 1;\ngo.set(\"#my_component\", \"some_property\", some_value, { keys: [\"root\", \"child_node\"] });"
     }
   ],
   "go.set_parent": [
     {
-      "sourceHash": "2822e1839ed2a321",
-      "ts": "// Attach myself to another instance \"my_parent\":\ngo.set_parent(go.get_id(), go.get_id(\"my_parent\"));\n\n// Attach an instance \"my_instance\" to another instance \"my_parent\":\ngo.set_parent(go.get_id(\"my_instance\"), go.get_id(\"my_parent\"));\n\n// Detach an instance \"my_instance\" from its parent (if any):\ngo.set_parent(go.get_id(\"my_instance\"));"
+      "sourceHash": "6b1747286d3ffe0e",
+      "ts": "go.set_parent(go.get_id(), go.get_id(\"my_parent\"));"
+    },
+    {
+      "sourceHash": "bd49a2fdce4a6b26",
+      "ts": "go.set_parent(go.get_id(\"my_instance\"), go.get_id(\"my_parent\"));"
+    },
+    {
+      "sourceHash": "d16a1b6edf422448",
+      "ts": "go.set_parent(go.get_id(\"my_instance\"));"
     }
   ],
   "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 — relative addressing, no socket prefix:\ngo.set_position(p, \"x\");"
+      "sourceHash": "ecc2445f2b8dc35c",
+      "ts": "// `p` is the desired position (a Vector3).\nconst p = vmath.vector3();\ngo.set_position(p);"
+    },
+    {
+      "sourceHash": "53b1e5cd24447416",
+      "ts": "// `p` is the desired position (a Vector3).\nconst p = vmath.vector3();\n\n// Relative addressing by id — no socket prefix:\ngo.set_position(p, \"x\");"
     }
   ],
   "go.set_rotation": [
     {
-      "sourceHash": "782b2092fc7f641f",
-      "ts": "// `r` is the desired rotation (a Quaternion).\nconst r = vmath.quat();\n\n// Set the rotation of the game object the script is attached to:\ngo.set_rotation(r);\n\n// Set the rotation of another game object with id \"x\":\ngo.set_rotation(r, \"x\");"
+      "sourceHash": "82ce8a803b606397",
+      "ts": "// `r` is the desired rotation (a Quaternion).\nconst r = vmath.quat();\ngo.set_rotation(r);"
+    },
+    {
+      "sourceHash": "e83143a6f2e2aafb",
+      "ts": "// `r` is the desired rotation (a Quaternion).\nconst r = vmath.quat();\ngo.set_rotation(r, \"x\");"
     }
   ],
   "go.set_scale": [
     {
-      "sourceHash": "456df524622a534f",
-      "ts": "// Set the scale of the game object the script is attached to:\nconst s = vmath.vector3(2.0, 1.0, 1.0);\ngo.set_scale(s);\n\n// Set the scale of another game object with id \"obj_id\":\nconst s2 = 1.2;\ngo.set_scale(s2, \"obj_id\");"
+      "sourceHash": "60c5ef571b15ad1c",
+      "ts": "const s = vmath.vector3(2.0, 1.0, 1.0);\ngo.set_scale(s);"
+    },
+    {
+      "sourceHash": "fe995a14ec731da3",
+      "ts": "const s = 1.2;\ngo.set_scale(s, \"obj_id\");"
     }
   ],
   "go.set_scale_xy": [
     {
-      "sourceHash": "6d23b1a65292cf1f",
-      "ts": "// Set the scale of the game object the script is attached to:\nconst s = vmath.vector3(2.0, 1.0, 5.0);\ngo.set_scale_xy(s); // z will not be set here, only x and y\n\n// Set the scale of another game object with id \"obj_id\":\nconst s2 = 1.2;\ngo.set_scale_xy(s2, \"obj_id\"); // z will not be set here, only x and y"
+      "sourceHash": "1b80e34a394c163a",
+      "ts": "const s = vmath.vector3(2.0, 1.0, 5.0);\ngo.set_scale_xy(s); // z will not be set here, only x and y"
+    },
+    {
+      "sourceHash": "6afb14c6bf68e351",
+      "ts": "const s = 1.2;\ngo.set_scale_xy(s, \"obj_id\"); // z will not be set here, only x and y"
     }
   ],
   "go.update_world_transform": [
     {
-      "sourceHash": "0c189fdea4a6d715",
-      "ts": "// Update this game object's world transform:\ngo.update_world_transform();\n\n// Update another game object's world transform:\ngo.update_world_transform(\"/other\");"
+      "sourceHash": "ce32b76e7d8c835d",
+      "ts": "go.update_world_transform();"
+    },
+    {
+      "sourceHash": "190e7045e4302208",
+      "ts": "go.update_world_transform(\"/other\");"
     }
   ],
   "go.world_to_local_position": [
@@ -409,8 +497,16 @@
   ],
   "gui.animate": [
     {
-      "sourceHash": "afd63fafe7e65e70",
-      "ts": "// How to start a simple color animation, where the node fades in to white during 0.5 seconds:\ngui.set_color(node, vmath.vector4(0, 0, 0, 0)); // node is fully transparent\ngui.animate(node, gui.PROP_COLOR, vmath.vector4(1, 1, 1, 1), gui.EASING_INOUTQUAD, 0.5); // start animation\n\n// 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, 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 defineScript({\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});\n\n// How to animate a node's y position using a crazy custom easing curve:\nexport default defineScript({\n  init(self) {\n    const values = [\n      0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1,\n      0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1,\n      0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1,\n      0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1,\n    ];\n    const vec = vmath.vector(values);\n    const node = gui.get_node(\"box\");\n    gui.animate(node, \"position.y\", 100, vec, 4.0, 0, undefined, gui.PLAYBACK_LOOP_PINGPONG);\n  },\n});"
+      "sourceHash": "2469bb86819278c2",
+      "ts": "// How to start a simple color animation, where the node fades in to white during 0.5 seconds:\nconst node = gui.get_node(\"my_node\");\ngui.set_color(node, vmath.vector4(0, 0, 0, 0)); // node is fully transparent\ngui.animate(node, gui.PROP_COLOR, vmath.vector4(1, 1, 1, 1), gui.EASING_INOUTQUAD, 0.5); // start animation"
+    },
+    {
+      "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});"
+    },
+    {
+      "sourceHash": "3d5dcef3260b5964",
+      "ts": "// How to animate a node's y position using a crazy custom easing curve:\nexport default defineGuiScript({\n  init(self) {\n    const values = [\n      0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1,\n      0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1,\n      0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1,\n      0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1,\n    ];\n    const vec = vmath.vector(values);\n    const node = gui.get_node(\"box\");\n    gui.animate(node, \"position.y\", 100, vec, 4.0, 0, undefined, gui.PLAYBACK_LOOP_PINGPONG);\n  },\n});"
     }
   ],
   "gui.cancel_animations": [
@@ -434,7 +530,7 @@
   "gui.delete_texture": [
     {
       "sourceHash": "360a3c74413c6a02",
-      "ts": "export default defineScript({\n  init(self) {\n    // Create a texture.\n    if (gui.new_texture(\"temp_tx\", 10, 10, \"rgb\", \"\\0\".repeat(10 * 10 * 3))) {\n      // Do something with the texture.\n      // ...\n\n      // Delete the texture\n      gui.delete_texture(\"temp_tx\");\n    }\n  },\n});"
+      "ts": "export default defineGuiScript({\n  init(self) {\n    // Create a texture.\n    if (gui.new_texture(\"temp_tx\", 10, 10, \"rgb\", \"\\0\".repeat(10 * 10 * 3))) {\n      // Do something with the texture.\n      // ...\n\n      // Delete the texture\n      gui.delete_texture(\"temp_tx\");\n    }\n  },\n});"
     }
   ],
   "gui.get": [
@@ -446,7 +542,7 @@
   "gui.get_font_resource": [
     {
       "sourceHash": "8eda6241dbbefbbb",
-      "ts": "// Get the text metrics for a text\nexport default defineScript({\n  init(self) {\n    const node = gui.get_node(\"name\");\n    const font_name = gui.get_font(node);\n    const font = gui.get_font_resource(font_name);\n    const metrics = resource.get_text_metrics(font, \"The quick brown fox\\n jumps over the lazy dog\");\n  },\n});"
+      "ts": "// Get the text metrics for a text\nexport default defineGuiScript({\n  init(self) {\n    const node = gui.get_node(\"name\");\n    const font_name = gui.get_font(node);\n    const font = gui.get_font_resource(font_name);\n    const metrics = resource.get_text_metrics(font, \"The quick brown fox\\n jumps over the lazy dog\");\n  },\n});"
     }
   ],
   "gui.get_id": [
@@ -476,19 +572,19 @@
   "gui.new_texture": [
     {
       "sourceHash": "192ba6f4b864704a",
-      "ts": "// How to create a texture and apply it to a new box node:\nexport default defineScript({\n  init(self) {\n    const w = 200;\n    const h = 300;\n\n    // A nice orange. String with the RGB values.\n    const orange = String.fromCharCode(0xff, 0x80, 0x10);\n\n    // Create the texture. Repeat the color string for each pixel.\n    const [ok, reason] = gui.new_texture(\"orange_tx\", w, h, \"rgb\", orange.repeat(w * h));\n    if (ok) {\n      // Create a box node and apply the texture to it.\n      const n = gui.new_box_node(vmath.vector3(200, 200, 0), vmath.vector3(w, h, 0));\n      gui.set_texture(n, \"orange_tx\");\n    } else {\n      // Could not create texture for some reason...\n      if (reason === gui.RESULT_TEXTURE_ALREADY_EXISTS) {\n        // ...\n      } else {\n        // ...\n      }\n    }\n  },\n});\n\n// How to create a texture using .astc format\nconst path = \"/assets/images/logo_4x4.astc\";\nconst buffer = sys.load_resource(path);\nconst n = gui.new_box_node(pos, vmath.vector3(size, size, 0));\n// size is read from the .astc buffer\n// flip is not supported\ngui.new_texture(path, 0, 0, \"astc\", buffer, false);\ngui.set_texture(n, path);"
+      "ts": "// How to create a texture and apply it to a new box node:\nexport default defineGuiScript({\n  init(self) {\n    const w = 200;\n    const h = 300;\n\n    // A nice orange. String with the RGB values.\n    const orange = String.fromCharCode(0xff, 0x80, 0x10);\n\n    // Create the texture. Repeat the color string for each pixel.\n    const [ok, reason] = gui.new_texture(\"orange_tx\", w, h, \"rgb\", orange.repeat(w * h));\n    if (ok) {\n      // Create a box node and apply the texture to it.\n      const n = gui.new_box_node(vmath.vector3(200, 200, 0), vmath.vector3(w, h, 0));\n      gui.set_texture(n, \"orange_tx\");\n    } else {\n      // Could not create texture for some reason...\n      if (reason === gui.RESULT_TEXTURE_ALREADY_EXISTS) {\n        // ...\n      } else {\n        // ...\n      }\n    }\n  },\n});\n\n// How to create a texture using .astc format\nconst size = 4;\nconst pos = vmath.vector3(200, 200, 0);\nconst path = \"/assets/images/logo_4x4.astc\";\nconst buffer = sys.load_resource(path);\nconst n = gui.new_box_node(pos, vmath.vector3(size, size, 0));\n// size is read from the .astc buffer\n// flip is not supported\ngui.new_texture(path, 0, 0, \"astc\", buffer, false);\ngui.set_texture(n, path);"
     }
   ],
   "gui.play_flipbook": [
     {
       "sourceHash": "341233e631c23020",
-      "ts": "// Set the texture of a node to a flipbook animation from an atlas:\nfunction anim_callback(self, node) {\n  // Take action after animation has played.\n}\n\nexport default defineScript({\n  init(self) {\n    // Create a new node and set the texture to a flipbook animation\n    const node = gui.get_node(\"button_node\");\n    gui.set_texture(node, \"gui_sprites\");\n    gui.play_flipbook(node, \"animated_button\");\n  },\n});\n\n// Set the texture of a node to an image from an atlas:\n// Create a new node and set the texture to a \"button.png\" from atlas\nconst node = gui.get_node(\"button_node\");\ngui.set_texture(node, \"gui_sprites\");\ngui.play_flipbook(node, \"button\");"
+      "ts": "// Set the texture of a node to a flipbook animation from an atlas:\nfunction anim_callback(self: unknown, node: unknown) {\n  // Take action after animation has played.\n}\n\nexport default defineGuiScript({\n  init(self) {\n    // Create a new node and set the texture to a flipbook animation\n    const node = gui.get_node(\"button_node\");\n    gui.set_texture(node, \"gui_sprites\");\n    gui.play_flipbook(node, \"animated_button\");\n  },\n});\n\n// Set the texture of a node to an image from an atlas:\n// Create a new node and set the texture to a \"button.png\" from atlas\nconst node = gui.get_node(\"button_node\");\ngui.set_texture(node, \"gui_sprites\");\ngui.play_flipbook(node, \"button\");"
     }
   ],
   "gui.play_particlefx": [
     {
       "sourceHash": "19a26b6e14ad0997",
-      "ts": "// How to play a particle fx when a gui node is created.\n// The callback receives the gui node, the hash of the id\n// of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.\nfunction emitter_state_change(self, node, emitter, state) {\n  if (emitter === hash(\"exhaust\") && state === particlefx.EMITTER_STATE_POSTSPAWN) {\n    // exhaust is done spawning particles...\n  }\n}\n\nexport default defineScript({\n  init(self) {\n    gui.play_particlefx(gui.get_node(\"particlefx\"), emitter_state_change);\n  },\n});"
+      "ts": "// How to play a particle fx when a gui node is created.\n// The callback receives the gui node, the hash of the id\n// of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.\nfunction emitter_state_change(self: unknown, node: unknown, emitter: unknown, state: unknown) {\n  if (emitter === hash(\"exhaust\") && state === particlefx.EMITTER_STATE_POSTSPAWN) {\n    // exhaust is done spawning particles...\n  }\n}\n\nexport default defineGuiScript({\n  init(self) {\n    gui.play_particlefx(gui.get_node(\"particlefx\"), emitter_state_change);\n  },\n});"
     }
   ],
   "gui.reset_material": [
@@ -500,17 +596,17 @@
   "gui.screen_to_local": [
     {
       "sourceHash": "3e442324e48a7f04",
-      "ts": "// Animate a node to the pressed pointer position:\nexport default defineScript({\n  init() {\n    msg.post(\".\", \"acquire_input_focus\");\n    return { marker: gui.get_node(\"marker\") };\n  },\n\n  on_input(self, action_id, action) {\n    if (action_id === hash(\"touch\") && action.pressed) {\n      const screen_position = vmath.vector3(action.screen_x, action.screen_y, 0);\n      const target_position = gui.screen_to_local(self.marker, screen_position);\n      gui.animate(self.marker, gui.PROP_POSITION, target_position, gui.EASING_OUTQUAD, 0.2);\n      return true;\n    }\n  },\n});"
+      "ts": "// Animate a node to the pressed pointer position:\nexport default defineGuiScript({\n  init() {\n    msg.post(\".\", \"acquire_input_focus\");\n    return { marker: gui.get_node(\"marker\") };\n  },\n\n  on_input(self, action_id, action) {\n    if (action_id === hash(\"touch\") && action.pressed) {\n      const screen_position = vmath.vector3(action.screen_x, action.screen_y, 0);\n      const target_position = gui.screen_to_local(self.marker, screen_position);\n      gui.animate(self.marker, gui.PROP_POSITION, target_position, gui.EASING_OUTQUAD, 0.2);\n      return true;\n    }\n  },\n});"
     }
   ],
   "gui.set": [
     {
       "sourceHash": "a609fdbcee772fac",
-      "ts": "// Updates the position property on an existing node:\nconst node = gui.get_node(\"my_box_node\");\nconst node_position = gui.get(node, \"position\");\ngui.set(node, \"position.x\", node_position.x + 128);\n\n// Updates the rotation property on an existing node:\ngui.set(node, \"rotation\", vmath.quat_rotation_z(math.rad(45)));\n// this is equivalent to:\ngui.set(node, \"euler.z\", 45);\n// or using the entire vector:\ngui.set(node, \"euler\", vmath.vector3(0, 0, 45));\n// or using the set_rotation\ngui.set_rotation(node, vmath.vector3(0, 0, 45));\n\n// Sets various material constants for a 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 });\n\n// Set a named property\nexport default defineScript({\n  on_message(self, message_id, message) {\n    if (message_id === hash(\"set_font\")) {\n      gui.set(msg.url(), \"fonts\", message.font, { key: \"my_font_name\" });\n      gui.set_font(gui.get_node(\"text\"), \"my_font_name\");\n    } else if (message_id === hash(\"set_texture\")) {\n      gui.set(msg.url(), \"textures\", message.texture, { key: \"my_texture\" });\n      gui.set_texture(gui.get_node(\"box\"), \"my_texture\");\n      gui.play_flipbook(gui.get_node(\"box\"), \"logo_256\");\n    }\n  },\n});\n\n// Remove a named runtime texture resource mapping:\nconst atlas_id = resource.create_atlas(\"/runtime.texturesetc\", atlas_params);\ngui.set(msg.url(), \"textures\", atlas_id, { key: \"runtime_texture\" });\ngui.set_texture(gui.get_node(\"box\"), \"runtime_texture\");\n\n// Later, remove the GUI mapping before releasing the atlas resource.\ngui.set(msg.url(), \"textures\", undefined, { key: \"runtime_texture\" });\nresource.release(atlas_id);"
+      "ts": "// Updates the position property on an existing node:\nconst node = gui.get_node(\"my_box_node\");\nconst node_position = gui.get(node, \"position\");\ngui.set(node, \"position.x\", node_position.x + 128);\n\n// Updates the rotation property on an existing node:\ngui.set(node, \"rotation\", vmath.quat_rotation_z(math.rad(45)));\n// this is equivalent to:\ngui.set(node, \"euler.z\", 45);\n// or using the entire vector:\ngui.set(node, \"euler\", vmath.vector3(0, 0, 45));\n// or using the set_rotation\ngui.set_rotation(node, vmath.vector3(0, 0, 45));\n\n// Sets various material constants for a 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 });\n\n// Set a named property\nexport default defineGuiScript({\n  on_message(self, message_id, message) {\n    if (message_id === hash(\"set_font\")) {\n      gui.set(msg.url(), \"fonts\", message.font, { key: \"my_font_name\" });\n      gui.set_font(gui.get_node(\"text\"), \"my_font_name\");\n    } else if (message_id === hash(\"set_texture\")) {\n      gui.set(msg.url(), \"textures\", message.texture, { key: \"my_texture\" });\n      gui.set_texture(gui.get_node(\"box\"), \"my_texture\");\n      gui.play_flipbook(gui.get_node(\"box\"), \"logo_256\");\n    }\n  },\n});\n\n// Remove a named runtime texture resource mapping:\nconst atlas_params = { texture: \"/runtime.texturec\", animations: [], geometries: [] };\nconst atlas_id = resource.create_atlas(\"/runtime.texturesetc\", atlas_params);\ngui.set(msg.url(), \"textures\", atlas_id, { key: \"runtime_texture\" });\ngui.set_texture(gui.get_node(\"box\"), \"runtime_texture\");\n\n// Later, remove the GUI mapping before releasing the atlas resource.\ngui.set(msg.url(), \"textures\", undefined, { key: \"runtime_texture\" });\nresource.release(atlas_id);"
     },
     {
       "sourceHash": "d195edde0a9fd170",
-      "ts": "// Updates the position property on an existing node:\nconst node = gui.get_node(\"my_box_node\");\nconst node_position = gui.get(node, \"position\");\ngui.set(node, \"position.x\", node_position.x + 128);\n\n// Updates the rotation property on an existing node:\ngui.set(node, \"rotation\", vmath.quat_rotation_z(math.rad(45)));\n// this is equivalent to:\ngui.set(node, \"euler.z\", 45);\n// or using the entire vector:\ngui.set(node, \"euler\", vmath.vector3(0, 0, 45));\n// or using the set_rotation\ngui.set_rotation(node, vmath.vector3(0, 0, 45));\n\n// Sets various material constants for a 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 });\n\n// Set a named property\nexport default defineScript({\n  on_message(self, message_id, message) {\n    if (message_id === hash(\"set_font\")) {\n      gui.set(msg.url(), \"fonts\", message.font, { key: \"my_font_name\" });\n      gui.set_font(gui.get_node(\"text\"), \"my_font_name\");\n    } else if (message_id === hash(\"set_texture\")) {\n      gui.set(msg.url(), \"textures\", message.texture, { key: \"my_texture\" });\n      gui.set_texture(gui.get_node(\"box\"), \"my_texture\");\n      gui.play_flipbook(gui.get_node(\"box\"), \"logo_256\");\n    }\n  },\n});"
+      "ts": "// Updates the position property on an existing node:\nconst node = gui.get_node(\"my_box_node\");\nconst node_position = gui.get(node, \"position\");\ngui.set(node, \"position.x\", node_position.x + 128);\n\n// Updates the rotation property on an existing node:\ngui.set(node, \"rotation\", vmath.quat_rotation_z(math.rad(45)));\n// this is equivalent to:\ngui.set(node, \"euler.z\", 45);\n// or using the entire vector:\ngui.set(node, \"euler\", vmath.vector3(0, 0, 45));\n// or using the set_rotation\ngui.set_rotation(node, vmath.vector3(0, 0, 45));\n\n// Sets various material constants for a 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 });\n\n// Set a named property\nexport default defineGuiScript({\n  on_message(self, message_id, message) {\n    if (message_id === hash(\"set_font\")) {\n      gui.set(msg.url(), \"fonts\", message.font, { key: \"my_font_name\" });\n      gui.set_font(gui.get_node(\"text\"), \"my_font_name\");\n    } else if (message_id === hash(\"set_texture\")) {\n      gui.set(msg.url(), \"textures\", message.texture, { key: \"my_texture\" });\n      gui.set_texture(gui.get_node(\"box\"), \"my_texture\");\n      gui.play_flipbook(gui.get_node(\"box\"), \"logo_256\");\n    }\n  },\n});"
     }
   ],
   "gui.set_id": [
@@ -534,7 +630,7 @@
   "gui.set_texture_data": [
     {
       "sourceHash": "86e3fd4362242ba1",
-      "ts": "export default defineScript({\n  init(self) {\n    const w = 200;\n    const h = 300;\n\n    // Create a dynamic texture, all white.\n    if (gui.new_texture(\"dynamic_tx\", w, h, \"rgb\", String.fromCharCode(0xff).repeat(w * h * 3))) {\n      // Create a box node and apply the texture to it.\n      const n = gui.new_box_node(vmath.vector3(200, 200, 0), vmath.vector3(w, h, 0));\n      gui.set_texture(n, \"dynamic_tx\");\n\n      // ...\n\n      // Change the data in the texture to a nice orange.\n      const orange = String.fromCharCode(0xff, 0x80, 0x10);\n      if (gui.set_texture_data(\"dynamic_tx\", w, h, \"rgb\", orange.repeat(w * h))) {\n        // Go on and to more stuff\n        // ...\n      }\n    } else {\n      // Something went wrong\n      // ...\n    }\n  },\n});"
+      "ts": "export default defineGuiScript({\n  init(self) {\n    const w = 200;\n    const h = 300;\n\n    // Create a dynamic texture, all white.\n    if (gui.new_texture(\"dynamic_tx\", w, h, \"rgb\", String.fromCharCode(0xff).repeat(w * h * 3))) {\n      // Create a box node and apply the texture to it.\n      const n = gui.new_box_node(vmath.vector3(200, 200, 0), vmath.vector3(w, h, 0));\n      gui.set_texture(n, \"dynamic_tx\");\n\n      // ...\n\n      // Change the data in the texture to a nice orange.\n      const orange = String.fromCharCode(0xff, 0x80, 0x10);\n      if (gui.set_texture_data(\"dynamic_tx\", w, h, \"rgb\", orange.repeat(w * h))) {\n        // Go on and to more stuff\n        // ...\n      }\n    } else {\n      // Something went wrong\n      // ...\n    }\n  },\n});"
     }
   ],
   "html5.run": [
@@ -546,13 +642,13 @@
   "html5.set_interaction_listener": [
     {
       "sourceHash": "edc07489a3fc761c",
-      "ts": "function on_interaction(self) {\n  print(\"on_interaction called\");\n  html5.set_interaction_listener(undefined);\n}\n\nexport default defineScript({\n  init() {\n    html5.set_interaction_listener(on_interaction);\n  },\n});"
+      "ts": "function on_interaction(self: unknown) {\n  print(\"on_interaction called\");\n  html5.set_interaction_listener(undefined);\n}\n\nexport default defineScript({\n  init() {\n    html5.set_interaction_listener(on_interaction);\n  },\n});"
     }
   ],
   "http.request": [
     {
       "sourceHash": "170c94c250c1ce49",
-      "ts": "// Basic HTTP-GET request. The callback receives a table with the response\n// in the fields status, the response (the data) and headers (a table).\nexport default defineScript({\n  init() {\n    http.request(\n      \"http://www.google.com\",\n      \"GET\",\n      (self, _id, response) => {\n        if (response.bytes_total !== undefined) {\n          update_my_progress_bar(self, response.bytes_received / response.bytes_total);\n        } else {\n          print(response.status);\n          print(response.response);\n          pprint(response.headers);\n        }\n      },\n      undefined,\n      undefined,\n      { report_progress: true },\n    );\n  },\n});"
+      "ts": "function update_my_progress_bar(self: unknown, fraction: number) {\n  // draw the progress bar at the given fraction\n}\n\n// Basic HTTP-GET request. The callback receives a table with the response\n// in the fields status, the response (the data) and headers (a table).\nexport default defineScript({\n  init() {\n    http.request(\n      \"http://www.google.com\",\n      \"GET\",\n      (self, _id, response) => {\n        if (response.bytes_total !== undefined) {\n          update_my_progress_bar(self, response.bytes_received / response.bytes_total);\n        } else {\n          print(response.status);\n          print(response.response);\n          pprint(response.headers);\n        }\n      },\n      undefined,\n      undefined,\n      { report_progress: true },\n    );\n  },\n});"
     }
   ],
   "image.get_astc_header": [
@@ -710,13 +806,13 @@
   "model.get_mesh_enabled": [
     {
       "sourceHash": "b2f9e47a91bc3f12",
-      "ts": "export default defineScript({\n  init(self) {\n    if (model.get_mesh_enabled(\"#model\", \"Sword\")) {\n      // set properties specific for the sword\n      self.weapon_properties = game.data.weapons[\"Sword\"];\n    }\n  },\n});"
+      "ts": "// shared weapon data, e.g. required from your own module\nconst game = { data: { weapons: { Sword: { damage: 10 } } } };\n\nexport default defineScript({\n  init(self) {\n    if (model.get_mesh_enabled(\"#model\", \"Sword\")) {\n      // set properties specific for the sword\n      self.weapon_properties = game.data.weapons[\"Sword\"];\n    }\n  },\n});"
     }
   ],
   "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:\nfunction anim_done(self, message_id, message, sender) {\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 url = msg.url(\"#model\");\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: 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});"
     }
   ],
   "model.reset_constant": [
@@ -740,7 +836,7 @@
   "msg.post": [
     {
       "sourceHash": "8eb90635d0b538fe",
-      "ts": "// Send \"enable\" to the sprite \"my_sprite\" in \"my_gameobject\":\nmsg.post(\"my_gameobject#my_sprite\", \"enable\");\n\n// Send a \"my_message\" to a url with some additional data:\nconst params = { my_parameter: \"my_value\" };\nmsg.post(my_url, \"my_message\", params);"
+      "ts": "// Send \"enable\" to the sprite \"my_sprite\" in \"my_gameobject\":\nmsg.post(\"my_gameobject#my_sprite\", \"enable\");\n\n// Send a \"my_message\" to a url with some additional data:\nconst my_url = msg.url(\"my_gameobject#my_script\");\nconst params = { my_parameter: \"my_value\" };\nmsg.post(my_url, \"my_message\", params);"
     }
   ],
   "msg.url": [
@@ -764,13 +860,17 @@
     },
     {
       "sourceHash": "cc835ea429adc693",
-      "ts": "export default defineScript({\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});"
+      "ts": "export default defineGuiScript({\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": "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 — 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});"
+      "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\") };\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": [
@@ -786,7 +886,7 @@
   "particlefx.play": [
     {
       "sourceHash": "01a21997b47ac4fc",
-      "ts": "// How to play a particle fx when a game object is created.\n// The callback receives the hash of the path to the particlefx, the hash of the id\n// of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.\nfunction emitter_state_change(self, id, emitter, state) {\n  if (emitter === hash(\"exhaust\") && state === particlefx.EMITTER_STATE_POSTSPAWN) {\n    // exhaust is done spawning particles...\n  }\n}\n\nexport default defineScript({\n  init(self) {\n    particlefx.play(\"#particlefx\", emitter_state_change);\n  },\n});"
+      "ts": "// How to play a particle fx when a game object is created.\n// The callback receives the hash of the path to the particlefx, the hash of the id\n// of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.\nfunction emitter_state_change(self: unknown, id: unknown, emitter: unknown, state: unknown) {\n  if (emitter === hash(\"exhaust\") && state === particlefx.EMITTER_STATE_POSTSPAWN) {\n    // exhaust is done spawning particles...\n  }\n}\n\nexport default defineScript({\n  init(self) {\n    particlefx.play(\"#particlefx\", emitter_state_change);\n  },\n});"
     }
   ],
   "particlefx.reset_constant": [
@@ -816,23 +916,23 @@
   "physics.raycast": [
     {
       "sourceHash": "3e0c534d741f0120",
-      "ts": "// How to perform a ray cast synchronously:\nexport default defineScript({\n  init(self) {\n    self.groups = [hash(\"world\"), hash(\"enemy\")];\n  },\n\n  update(self, dt) {\n    // request ray cast\n    const result = physics.raycast(from, to, self.groups, { all: true });\n    if (result !== undefined) {\n      // act on the hit (see 'ray_cast_response')\n      for (const result of results) {\n        handle_result(result);\n      }\n    }\n  },\n});"
+      "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(self) {\n    self.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      for (const result of results) {\n        handle_result(result);\n      }\n    }\n  },\n});"
     }
   ],
   "physics.raycast_async": [
     {
       "sourceHash": "746b7900ebaa1f10",
-      "ts": "// How to perform a ray cast asynchronously:\nexport default defineScript({\n  init(self) {\n    self.my_groups = [hash(\"my_group1\"), hash(\"my_group2\")];\n  },\n\n  update(self, dt) {\n    // request ray cast\n    physics.raycast_async(my_start, my_end, self.my_groups);\n  },\n\n  on_message(self, message_id, message, sender) {\n    // check for the response\n    if (message_id === hash(\"ray_cast_response\")) {\n      // act on the hit\n    } else if (message_id === hash(\"ray_cast_missed\")) {\n      // act on the miss\n    }\n  },\n});"
+      "ts": "// How to perform a ray cast asynchronously:\nexport default defineScript({\n  init(self) {\n    self.my_groups = [hash(\"my_group1\"), hash(\"my_group2\")];\n  },\n\n  update(self, dt) {\n    // request ray cast\n    const my_start = go.get_world_position();\n    const my_end = vmath.vector3(my_start.x, my_start.y - 100, my_start.z);\n    physics.raycast_async(my_start, my_end, self.my_groups);\n  },\n\n  on_message(self, message_id, message, sender) {\n    // check for the response\n    if (message_id === hash(\"ray_cast_response\")) {\n      // act on the hit\n    } else if (message_id === hash(\"ray_cast_missed\")) {\n      // act on the miss\n    }\n  },\n});"
     }
   ],
   "physics.set_event_listener": [
     {
       "sourceHash": "5d31d05d52e50c3f",
-      "ts": "function physics_world_listener(self, events) {\n  for (const event of events) {\n    const event_type = event[\"type\"];\n    if (event_type === hash(\"contact_point_event\")) {\n      pprint(event);\n      // {\n      //  distance = 2.1490633487701,\n      //  applied_impulse = 0\n      //  a = { --[[0x113f7c6c0]]\n      //    group = hash: [box],\n      //    id = hash: [/box]\n      //    mass = 0,\n      //    normal = vmath.vector3(0.379, 0.925, -0),\n      //    position = vmath.vector3(517.337, 235.068, 0),\n      //    instance_position = vmath.vector3(480, 144, 0),\n      //    relative_velocity = vmath.vector3(-0, -0, -0),\n      //  },\n      //  b = { --[[0x113f7c840]]\n      //    group = hash: [circle],\n      //    id = hash: [/circle]\n      //    mass = 0,\n      //    normal = vmath.vector3(-0.379, -0.925, 0),\n      //    position = vmath.vector3(517.337, 235.068, 0),\n      //    instance_position = vmath.vector3(-0.0021, 0, -0.0022),\n      //    relative_velocity = vmath.vector3(0, 0, 0),\n      //  },\n      // }\n    } else if (event === hash(\"collision_event\")) {\n      pprint(event);\n      // {\n      //  a = {\n      //          group = hash: [default],\n      //          position = vmath.vector3(183, 666, 0),\n      //          id = hash: [/go1]\n      //      },\n      //  b = {\n      //          group = hash: [default],\n      //          position = vmath.vector3(185, 704.05865478516, 0),\n      //          id = hash: [/go2]\n      //      }\n      // }\n    } else if (event === hash(\"trigger_event\")) {\n      pprint(event);\n      // {\n      //  enter = true,\n      //  b = {\n      //      group = hash: [default],\n      //      id = hash: [/go2]\n      //  },\n      //  a = {\n      //      group = hash: [default],\n      //      id = hash: [/go1]\n      //  }\n      // },\n    } else if (event === hash(\"ray_cast_response\")) {\n      pprint(event);\n      // {\n      //  group = hash: [default],\n      //  request_id = 0,\n      //  position = vmath.vector3(249.92222595215, 249.92222595215, 0),\n      //  fraction = 0.68759721517563,\n      //  normal = vmath.vector3(0, 1, 0),\n      //  id = hash: [/go]\n      // }\n    } else if (event === hash(\"ray_cast_missed\")) {\n      pprint(event);\n      // {\n      //  request_id = 0\n      // },\n    }\n  }\n}\n\nexport default defineScript({\n  init(self) {\n    physics.set_event_listener(physics_world_listener);\n  },\n});"
+      "ts": "function physics_world_listener(self: unknown, events: unknown) {\n  for (const event of events as Record<string, unknown>[]) {\n    const event_type = event[\"type\"];\n    if (event_type === hash(\"contact_point_event\")) {\n      pprint(event);\n      // {\n      //  distance = 2.1490633487701,\n      //  applied_impulse = 0\n      //  a = { --[[0x113f7c6c0]]\n      //    group = hash: [box],\n      //    id = hash: [/box]\n      //    mass = 0,\n      //    normal = vmath.vector3(0.379, 0.925, -0),\n      //    position = vmath.vector3(517.337, 235.068, 0),\n      //    instance_position = vmath.vector3(480, 144, 0),\n      //    relative_velocity = vmath.vector3(-0, -0, -0),\n      //  },\n      //  b = { --[[0x113f7c840]]\n      //    group = hash: [circle],\n      //    id = hash: [/circle]\n      //    mass = 0,\n      //    normal = vmath.vector3(-0.379, -0.925, 0),\n      //    position = vmath.vector3(517.337, 235.068, 0),\n      //    instance_position = vmath.vector3(-0.0021, 0, -0.0022),\n      //    relative_velocity = vmath.vector3(0, 0, 0),\n      //  },\n      // }\n    } else if (event_type === hash(\"collision_event\")) {\n      pprint(event);\n      // {\n      //  a = {\n      //          group = hash: [default],\n      //          position = vmath.vector3(183, 666, 0),\n      //          id = hash: [/go1]\n      //      },\n      //  b = {\n      //          group = hash: [default],\n      //          position = vmath.vector3(185, 704.05865478516, 0),\n      //          id = hash: [/go2]\n      //      }\n      // }\n    } else if (event_type === hash(\"trigger_event\")) {\n      pprint(event);\n      // {\n      //  enter = true,\n      //  b = {\n      //      group = hash: [default],\n      //      id = hash: [/go2]\n      //  },\n      //  a = {\n      //      group = hash: [default],\n      //      id = hash: [/go1]\n      //  }\n      // },\n    } else if (event_type === hash(\"ray_cast_response\")) {\n      pprint(event);\n      // {\n      //  group = hash: [default],\n      //  request_id = 0,\n      //  position = vmath.vector3(249.92222595215, 249.92222595215, 0),\n      //  fraction = 0.68759721517563,\n      //  normal = vmath.vector3(0, 1, 0),\n      //  id = hash: [/go]\n      // }\n    } else if (event_type === hash(\"ray_cast_missed\")) {\n      pprint(event);\n      // {\n      //  request_id = 0\n      // },\n    }\n  }\n}\n\nexport default defineScript({\n  init(self) {\n    physics.set_event_listener(physics_world_listener);\n  },\n});"
     },
     {
       "sourceHash": "ac24712f2e988ba4",
-      "ts": "function physics_world_listener(self, events) {\n  for (const event of events) {\n    const event_type = event[\"type\"];\n    if (event_type === hash(\"contact_point_event\")) {\n      pprint(event);\n      // {\n      //  distance = 2.1490633487701,\n      //  applied_impulse = 0\n      //  a = { --[[0x113f7c6c0]]\n      //    group = hash: [box],\n      //    id = hash: [/box]\n      //    mass = 0,\n      //    normal = vmath.vector3(0.379, 0.925, -0),\n      //    position = vmath.vector3(517.337, 235.068, 0),\n      //    instance_position = vmath.vector3(480, 144, 0),\n      //    relative_velocity = vmath.vector3(-0, -0, -0),\n      //  },\n      //  b = { --[[0x113f7c840]]\n      //    group = hash: [circle],\n      //    id = hash: [/circle]\n      //    mass = 0,\n      //    normal = vmath.vector3(-0.379, -0.925, 0),\n      //    position = vmath.vector3(517.337, 235.068, 0),\n      //    instance_position = vmath.vector3(-0.0021, 0, -0.0022),\n      //    relative_velocity = vmath.vector3(0, 0, 0),\n      //  },\n      // }\n    } else if (event === hash(\"collision_event\")) {\n      pprint(event);\n      // {\n      //  a = {\n      //          group = hash: [default],\n      //          position = vmath.vector3(183, 666, 0),\n      //          id = hash: [/go1]\n      //      },\n      //  b = {\n      //          group = hash: [default],\n      //          position = vmath.vector3(185, 704.05865478516, 0),\n      //          id = hash: [/go2]\n      //      }\n      // }\n    } else if (event === hash(\"trigger_event\")) {\n      pprint(event);\n      // {\n      //  enter = true,\n      //  b = {\n      //      group = hash: [default],\n      //      id = hash: [/go2]\n      //  },\n      //  a = {\n      //      group = hash: [default],\n      //      id = hash: [/go1]\n      //  }\n      // },\n    } else if (event === hash(\"ray_cast_response\")) {\n      pprint(event);\n      // {\n      //  group = hash: [default],\n      //  request_id = 0,\n      //  position = vmath.vector3(249.92222595215, 249.92222595215, 0),\n      //  fraction = 0.68759721517563,\n      //  normal = vmath.vector3(0, 1, 0),\n      //  id = hash: [/go]\n      // }\n    } else if (event === hash(\"ray_cast_missed\")) {\n      pprint(event);\n      // {\n      //  request_id = 0\n      // },\n    }\n  }\n}\n\nexport default defineScript({\n  init(self) {\n    physics.set_event_listener(physics_world_listener);\n  },\n});"
+      "ts": "function physics_world_listener(self: unknown, events: unknown) {\n  for (const event of events as Record<string, unknown>[]) {\n    const event_type = event[\"type\"];\n    if (event_type === hash(\"contact_point_event\")) {\n      pprint(event);\n      // {\n      //  distance = 2.1490633487701,\n      //  applied_impulse = 0\n      //  a = { --[[0x113f7c6c0]]\n      //    group = hash: [box],\n      //    id = hash: [/box]\n      //    mass = 0,\n      //    normal = vmath.vector3(0.379, 0.925, -0),\n      //    position = vmath.vector3(517.337, 235.068, 0),\n      //    instance_position = vmath.vector3(480, 144, 0),\n      //    relative_velocity = vmath.vector3(-0, -0, -0),\n      //  },\n      //  b = { --[[0x113f7c840]]\n      //    group = hash: [circle],\n      //    id = hash: [/circle]\n      //    mass = 0,\n      //    normal = vmath.vector3(-0.379, -0.925, 0),\n      //    position = vmath.vector3(517.337, 235.068, 0),\n      //    instance_position = vmath.vector3(-0.0021, 0, -0.0022),\n      //    relative_velocity = vmath.vector3(0, 0, 0),\n      //  },\n      // }\n    } else if (event_type === hash(\"collision_event\")) {\n      pprint(event);\n      // {\n      //  a = {\n      //          group = hash: [default],\n      //          position = vmath.vector3(183, 666, 0),\n      //          id = hash: [/go1]\n      //      },\n      //  b = {\n      //          group = hash: [default],\n      //          position = vmath.vector3(185, 704.05865478516, 0),\n      //          id = hash: [/go2]\n      //      }\n      // }\n    } else if (event_type === hash(\"trigger_event\")) {\n      pprint(event);\n      // {\n      //  enter = true,\n      //  b = {\n      //      group = hash: [default],\n      //      id = hash: [/go2]\n      //  },\n      //  a = {\n      //      group = hash: [default],\n      //      id = hash: [/go1]\n      //  }\n      // },\n    } else if (event_type === hash(\"ray_cast_response\")) {\n      pprint(event);\n      // {\n      //  group = hash: [default],\n      //  request_id = 0,\n      //  position = vmath.vector3(249.92222595215, 249.92222595215, 0),\n      //  fraction = 0.68759721517563,\n      //  normal = vmath.vector3(0, 1, 0),\n      //  id = hash: [/go]\n      // }\n    } else if (event_type === hash(\"ray_cast_missed\")) {\n      pprint(event);\n      // {\n      //  request_id = 0\n      // },\n    }\n  }\n}\n\nexport default defineScript({\n  init(self) {\n    physics.set_event_listener(physics_world_listener);\n  },\n});"
     }
   ],
   "physics.set_gravity": [
@@ -886,7 +986,7 @@
   "profiler.log_text": [
     {
       "sourceHash": "86c7e0a666f0147e",
-      "ts": "profiler.log_text(`Event: ${name}`);"
+      "ts": "const name = \"my_event\";\nprofiler.log_text(`Event: ${name}`);"
     }
   ],
   "profiler.recorded_frame_count": [
@@ -898,7 +998,7 @@
   "profiler.scope_begin": [
     {
       "sourceHash": "fa297bd541df8930",
-      "ts": "// Go back one frame\nprofiler.scope_begin(\"test_function\");\ntest_function();\nprofiler.scope_end();"
+      "ts": "function test_function() {\n  // the work being measured\n}\n\n// Go back one frame\nprofiler.scope_begin(\"test_function\");\ntest_function();\nprofiler.scope_end();"
     }
   ],
   "profiler.set_ui_mode": [
@@ -934,67 +1034,75 @@
   "render.constant_buffer": [
     {
       "sourceHash": "851cc71b74ec904a",
-      "ts": "// Set a \"tint\" constant in a constant buffer in the render script:\nconst constants = render.constant_buffer();\nconstants.tint = vmath.vector4(1, 1, 1, 1);\n\n// Then use the constant buffer when drawing a predicate:\nrender.draw(self.my_pred, { constants });\n\n// The constant buffer also supports array values by specifying constants in an array:\nconst constants2 = render.constant_buffer();\nconstants2.light_colors = [];\nconstants2.light_colors[0] = vmath.vector4(1, 0, 0, 1);\nconstants2.light_colors[1] = vmath.vector4(0, 1, 0, 1);\nconstants2.light_colors[2] = vmath.vector4(0, 0, 1, 1);\n\n// You can also create the array by passing the vectors directly:\nconst constants3 = render.constant_buffer();\nconstants3.light_colors = [\n  vmath.vector4(1, 0, 0, 1),\n  vmath.vector4(0, 1, 0, 1),\n  vmath.vector4(0, 0, 1, 1),\n];\n\n// Add more constants to the array\nconstants3.light_colors[3] = vmath.vector4(1, 1, 1, 1);"
+      "ts": "export default defineRenderScript({\n  init() {\n    return { my_pred: render.predicate([hash(\"my_tag\")]) };\n  },\n\n  update(self, dt) {\n    // Set a \"tint\" constant in a constant buffer in the render script:\n    const constants = render.constant_buffer();\n    constants.tint = vmath.vector4(1, 1, 1, 1);\n\n    // Then use the constant buffer when drawing a predicate:\n    render.draw(self.my_pred, { constants });\n\n    // The constant buffer also supports array values by specifying constants in an array:\n    const constants2 = render.constant_buffer();\n    constants2.light_colors = [];\n    constants2.light_colors[0] = vmath.vector4(1, 0, 0, 1);\n    constants2.light_colors[1] = vmath.vector4(0, 1, 0, 1);\n    constants2.light_colors[2] = vmath.vector4(0, 0, 1, 1);\n\n    // You can also create the array by passing the vectors directly:\n    const constants3 = render.constant_buffer();\n    constants3.light_colors = [\n      vmath.vector4(1, 0, 0, 1),\n      vmath.vector4(0, 1, 0, 1),\n      vmath.vector4(0, 0, 1, 1),\n    ];\n\n    // Add more constants to the array\n    constants3.light_colors[3] = vmath.vector4(1, 1, 1, 1);\n  },\n});"
     }
   ],
   "render.delete_render_target": [
     {
       "sourceHash": "e535502af5d49877",
-      "ts": "// How to delete a render target:\nrender.delete_render_target(self.my_render_target);"
+      "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});"
     }
   ],
   "render.disable_material": [
     {
       "sourceHash": "256ae7b73905f4b2",
-      "ts": "// Enable material named \"glow\", then draw my_pred with it.\nrender.enable_material(\"glow\");\nrender.draw(self.my_pred);\nrender.disable_material();"
+      "ts": "export default defineRenderScript({\n  init() {\n    return { my_pred: render.predicate([hash(\"my_tag\")]) };\n  },\n\n  update(self, dt) {\n    // Enable material named \"glow\", then draw my_pred with it.\n    render.enable_material(\"glow\");\n    render.draw(self.my_pred);\n    render.disable_material();\n  },\n});"
     }
   ],
   "render.disable_state": [
     {
       "sourceHash": "9ec916d3d474ace5",
-      "ts": "// Disable face culling when drawing the tile predicate:\nrender.disable_state(graphics.STATE_CULL_FACE);\nrender.draw(self.tile_pred);"
+      "ts": "export default defineRenderScript({\n  init() {\n    return { tile_pred: render.predicate([hash(\"tile\")]) };\n  },\n\n  update(self, dt) {\n    // Disable face culling when drawing the tile predicate:\n    render.disable_state(graphics.STATE_CULL_FACE);\n    render.draw(self.tile_pred);\n  },\n});"
     }
   ],
   "render.disable_texture": [
     {
       "sourceHash": "77eefc5b608dd2e6",
-      "ts": "export default defineScript({\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  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});"
     }
   ],
   "render.dispatch_compute": [
     {
       "sourceHash": "af76607a05354da7",
-      "ts": "export default defineScript({\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      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});\n\n// Dispatch a compute program with a constant buffer:\nconst constants = render.constant_buffer();\nconstants.tint = vmath.vector4(1, 1, 1, 1);\nrender.dispatch_compute(32, 32, 32, { constants });"
+      "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      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});\n\n// Dispatch a compute program with a constant buffer:\nconst constants = render.constant_buffer();\nconstants.tint = vmath.vector4(1, 1, 1, 1);\nrender.dispatch_compute(32, 32, 32, { constants });"
     }
   ],
   "render.draw": [
     {
       "sourceHash": "47232b75e7b74189",
-      "ts": "export default defineScript({\n  init() {\n    // define a predicate matching anything with material tag \"my_tag\"\n    return { my_pred: render.predicate([hash(\"my_tag\")]) };\n  },\n\n  update(self, dt) {\n    // draw everything in the my_pred predicate\n    render.draw(self.my_pred);\n  },\n});\n\n// Draw predicate with constants:\nconst constants = render.constant_buffer();\nconstants.tint = vmath.vector4(1, 1, 1, 1);\nrender.draw(self.my_pred, { constants });\n\n// Draw with predicate and frustum culling (without near+far planes):\nconst frustum = self.proj.mul(self.view);\nrender.draw(self.my_pred, { frustum });\n\n// Draw with predicate and frustum culling (with near+far planes):\nconst frustum2 = self.proj.mul(self.view);\nrender.draw(self.my_pred, { frustum: frustum2, frustum_planes: render.FRUSTUM_PLANES_ALL });"
+      "ts": "export default defineRenderScript({\n  init() {\n    // define a predicate matching anything with material tag \"my_tag\"\n    return { my_pred: render.predicate([hash(\"my_tag\")]) };\n  },\n\n  update(self, dt) {\n    // draw everything in the my_pred predicate\n    render.draw(self.my_pred);\n\n    // Draw predicate with constants:\n    const constants = render.constant_buffer();\n    constants.tint = vmath.vector4(1, 1, 1, 1);\n    render.draw(self.my_pred, { constants });\n\n    // Draw with predicate and frustum culling (without near+far planes):\n    const frustum = self.proj.mul(self.view);\n    render.draw(self.my_pred, { frustum });\n\n    // Draw with predicate and frustum culling (with near+far planes):\n    const frustum2 = self.proj.mul(self.view);\n    render.draw(self.my_pred, { frustum: frustum2, frustum_planes: render.FRUSTUM_PLANES_ALL });\n  },\n});"
     }
   ],
   "render.draw_debug3d": [
     {
       "sourceHash": "b200f780e2bf16f3",
-      "ts": "export default defineScript({\n  update(self, dt) {\n    // draw debug visualization\n    render.draw_debug3d();\n  },\n});"
+      "ts": "export default defineRenderScript({\n  update(self, dt) {\n    // draw debug visualization\n    render.draw_debug3d();\n  },\n});"
     }
   ],
   "render.enable_material": [
     {
       "sourceHash": "256ae7b73905f4b2",
-      "ts": "// Enable material named \"glow\", then draw my_pred with it.\nrender.enable_material(\"glow\");\nrender.draw(self.my_pred);\nrender.disable_material();"
+      "ts": "export default defineRenderScript({\n  init() {\n    return { my_pred: render.predicate([hash(\"my_tag\")]) };\n  },\n\n  update(self, dt) {\n    // Enable material named \"glow\", then draw my_pred with it.\n    render.enable_material(\"glow\");\n    render.draw(self.my_pred);\n    render.disable_material();\n  },\n});"
     }
   ],
   "render.enable_state": [
     {
       "sourceHash": "d08dd567d90c4036",
-      "ts": "// Enable stencil test when drawing the gui predicate, then disable it:\nrender.enable_state(graphics.STATE_STENCIL_TEST);\nrender.draw(self.gui_pred);\nrender.disable_state(graphics.STATE_STENCIL_TEST);"
+      "ts": "export default defineRenderScript({\n  init() {\n    return { gui_pred: render.predicate([hash(\"gui\")]) };\n  },\n\n  update(self, dt) {\n    // Enable stencil test when drawing the gui predicate, then disable it:\n    render.enable_state(graphics.STATE_STENCIL_TEST);\n    render.draw(self.gui_pred);\n    render.disable_state(graphics.STATE_STENCIL_TEST);\n  },\n});"
     }
   ],
   "render.enable_texture": [
     {
-      "sourceHash": "4dd1d2618c062e70",
-      "ts": "export default defineScript({\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});\n\n// Or enable a render target by resource id:\nexport default defineScript({\n  update(self, dt) {\n    render.set_render_target(\"my_rt_resource\");\n    render.draw(self.my_pred);\n    render.set_render_target(render.RENDER_TARGET_DEFAULT);\n\n    render.enable_texture(0, \"my_rt_resource\", 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});\n\n// Or bind a texture handle directly:\nexport default defineScript({\n  update(self, dt) {\n    // bind a texture to the texture unit 0\n    render.enable_texture(0, self.my_texture_handle);\n    // bind the same texture to a named sampler\n    render.enable_texture(\"my_texture_sampler\", self.my_texture_handle);\n  },\n});"
+      "sourceHash": "410c8dd98e44842a",
+      "ts": "export default defineRenderScript({\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});"
+    },
+    {
+      "sourceHash": "dc0ea083dbea5fe1",
+      "ts": "// Or enable a render target by resource id:\nexport default defineRenderScript({\n  update(self, dt) {\n    render.set_render_target(\"my_rt_resource\");\n    render.draw(self.my_pred);\n    render.set_render_target(render.RENDER_TARGET_DEFAULT);\n\n    render.enable_texture(0, \"my_rt_resource\", 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": "49503c29f0de95f3",
+      "ts": "// Or bind a texture handle directly:\nexport default defineRenderScript({\n  update(self, dt) {\n    // bind a texture to the texture unit 0\n    render.enable_texture(0, self.my_texture_handle);\n    // bind the same texture to a named sampler\n    render.enable_texture(\"my_texture_sampler\", self.my_texture_handle);\n  },\n});"
     }
   ],
   "render.get_height": [
@@ -1006,13 +1114,13 @@
   "render.get_render_target_height": [
     {
       "sourceHash": "f509a9b954573583",
-      "ts": "// get the height of the render target color buffer\nconst h = render.get_render_target_height(self.target_right, graphics.BUFFER_TYPE_COLOR0_BIT);\n// get the height of a render target resource\nconst w = render.get_render_target_height(\"my_rt_resource\", graphics.BUFFER_TYPE_COLOR0_BIT);"
+      "ts": "export 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    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});"
     }
   ],
   "render.get_render_target_width": [
     {
       "sourceHash": "25c6d828a4ae3706",
-      "ts": "// get the width of the render target color buffer\nconst w = render.get_render_target_width(self.target_right, graphics.BUFFER_TYPE_COLOR0_BIT);\n// get the width of a render target resource\nconst w2 = render.get_render_target_width(\"my_rt_resource\", graphics.BUFFER_TYPE_COLOR0_BIT);"
+      "ts": "export 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    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});"
     }
   ],
   "render.get_width": [
@@ -1041,12 +1149,16 @@
   ],
   "render.render_target": [
     {
-      "sourceHash": "608b59338c18571b",
-      "ts": "// How to create a new render target and draw to it:\nexport default defineScript({\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    };\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});\n\n// How to create a render target with multiple outputs:\nexport default defineScript({\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    };\n  },\n\n  update(self, dt) {\n    // enable target so all drawing is done to it\n    render.enable_render_target(self.my_render_target);\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n  },\n});"
+      "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    };\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});"
+    },
+    {
+      "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    // 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    };\n  },\n\n  update(self, dt) {\n    // enable target so all drawing is done to it\n    render.enable_render_target(self.my_render_target);\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n  },\n});"
     },
     {
-      "sourceHash": "766fbfcc7bc21b4b",
-      "ts": "// How to create a new render target and draw to it:\nexport default defineScript({\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    };\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});\n\n// How to create a render target with multiple outputs:\nexport default defineScript({\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    };\n  },\n\n  update(self, dt) {\n    // enable target so all drawing is done to it\n    render.enable_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    };\n  },\n\n  update(self, dt) {\n    // enable target so all drawing is done to it\n    render.enable_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": [
@@ -1070,7 +1182,7 @@
   "render.set_camera": [
     {
       "sourceHash": "6ee012d07a0487a6",
-      "ts": "// Set the current camera to be used for rendering\nrender.set_camera(\"main:/my_go#camera\");\nrender.draw(self.my_pred);\nrender.set_camera(undefined);\n\n// Use the camera frustum for frustum culling together with a specific frustum plane option for the draw command\n// The camera frustum will take precedence over the frustum plane option in render.draw\nrender.set_camera(\"main:/my_go#camera\", { use_frustum: true });\n// However, we can still customize the frustum planes regardless of the camera option!\nrender.draw(self.my_pred, { frustum_planes: render.FRUSTUM_PLANES_ALL });\nrender.set_camera();"
+      "ts": "export default defineRenderScript({\n  init() {\n    return { my_pred: render.predicate([hash(\"my_tag\")]) };\n  },\n\n  update(self, dt) {\n    // Set the current camera to be used for rendering\n    render.set_camera(\"main:/my_go#camera\");\n    render.draw(self.my_pred);\n    render.set_camera(undefined);\n\n    // Use the camera frustum for frustum culling together with a specific frustum plane option for the draw command\n    // The camera frustum will take precedence over the frustum plane option in render.draw\n    render.set_camera(\"main:/my_go#camera\", { use_frustum: true });\n    // However, we can still customize the frustum planes regardless of the camera option!\n    render.draw(self.my_pred, { frustum_planes: render.FRUSTUM_PLANES_ALL });\n    render.set_camera();\n  },\n});"
     }
   ],
   "render.set_color_mask": [
@@ -1082,7 +1194,7 @@
   "render.set_compute": [
     {
       "sourceHash": "5e76b88c05d9f3f7",
-      "ts": "// Enable compute program named \"fractals\", then dispatch it.\nrender.set_compute(\"fractals\");\nrender.enable_texture(0, self.backing_texture);\nrender.dispatch_compute(128, 128, 1);\nrender.set_compute();"
+      "ts": "export default defineRenderScript({\n  init() {\n    return { backing_texture: \"my_texture_resource\" };\n  },\n\n  update(self, dt) {\n    // Enable compute program named \"fractals\", then dispatch it.\n    render.set_compute(\"fractals\");\n    render.enable_texture(0, self.backing_texture);\n    render.dispatch_compute(128, 128, 1);\n    render.set_compute();\n  },\n});"
     }
   ],
   "render.set_cull_face": [
@@ -1106,7 +1218,7 @@
   "render.set_listener": [
     {
       "sourceHash": "6fc340897eeb1ab9",
-      "ts": "// Set listener and handle render context events.\n// custom.render_script\nexport default defineScript({\n  init() {\n    render.set_listener((self, event_type) => {\n      if (event_type === render.CONTEXT_EVENT_CONTEXT_LOST) {\n        // Some stuff when rendering context is lost\n      } else if (event_type === render.CONTEXT_EVENT_CONTEXT_RESTORED) {\n        // Start reload resources, reload game, etc.\n      }\n    });\n  },\n});"
+      "ts": "// Set listener and handle render context events.\n// custom.render_script\nexport default defineRenderScript({\n  init() {\n    render.set_listener((self, event_type) => {\n      if (event_type === render.CONTEXT_EVENT_CONTEXT_LOST) {\n        // Some stuff when rendering context is lost\n      } else if (event_type === render.CONTEXT_EVENT_CONTEXT_RESTORED) {\n        // Start reload resources, reload game, etc.\n      }\n    });\n  },\n});"
     }
   ],
   "render.set_polygon_offset": [
@@ -1123,14 +1235,18 @@
   ],
   "render.set_render_target": [
     {
-      "sourceHash": "b30691f486beb1fa",
-      "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 defineScript({\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});\n\n// Or set the render target by a render target resource identifier:\nexport default defineScript({\n  update(self, dt) {\n    render.set_render_target(\"my_rt_resource\");\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n\n    // reset the render target to the default backbuffer\n    render.set_render_target(render.RENDER_TARGET_DEFAULT);\n  },\n});"
+      "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  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});"
+    },
+    {
+      "sourceHash": "bb08db5e232c5b5e",
+      "ts": "// Or set the render target by a render target resource identifier:\nexport default defineRenderScript({\n  update(self, dt) {\n    render.set_render_target(\"my_rt_resource\");\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n\n    // reset the render target to the default backbuffer\n    render.set_render_target(render.RENDER_TARGET_DEFAULT);\n  },\n});"
     }
   ],
   "render.set_render_target_size": [
     {
       "sourceHash": "00274352e6327274",
-      "ts": "// Resize render targets to the current window size:\nrender.set_render_target_size(self.my_render_target, render.get_window_width(), render.get_window_height());\nrender.set_render_target_size(\"my_rt_resource\", render.get_window_width(), render.get_window_height());"
+      "ts": "export default defineRenderScript({\n  init() {\n    return { my_render_target: render.render_target(\"my_target\", {}) };\n  },\n\n  update(self, dt) {\n    // Resize render targets to the current window size:\n    render.set_render_target_size(self.my_render_target, render.get_window_width(), render.get_window_height());\n    render.set_render_target_size(\"my_rt_resource\", render.get_window_width(), render.get_window_height());\n  },\n});"
     }
   ],
   "render.set_stencil_func": [
@@ -1154,7 +1270,7 @@
   "render.set_view": [
     {
       "sourceHash": "7a30b4955abb3844",
-      "ts": "// How to set the view and projection matrices according to\n// the values supplied by a camera.\nexport default defineScript({\n  init() {\n    return {\n      view: vmath.matrix4(),\n      projection: vmath.matrix4(),\n    };\n  },\n\n  update(self, dt) {\n    // set the view to the stored view value\n    render.set_view(self.view);\n    // now we can draw with this view\n  },\n\n  on_message(self, message_id, message) {\n    if (message_id === hash(\"set_view_projection\")) {\n      // camera view and projection arrives here.\n      self.view = message.view;\n      self.projection = message.projection;\n    }\n  },\n});"
+      "ts": "// How to set the view and projection matrices according to\n// the values supplied by a camera.\nexport default defineRenderScript({\n  init() {\n    return {\n      view: vmath.matrix4(),\n      projection: vmath.matrix4(),\n    };\n  },\n\n  update(self, dt) {\n    // set the view to the stored view value\n    render.set_view(self.view);\n    // now we can draw with this view\n  },\n\n  on_message(self, message_id, message) {\n    if (message_id === hash(\"set_view_projection\")) {\n      // camera view and projection arrives here.\n      self.view = message.view;\n      self.projection = message.projection;\n    }\n  },\n});"
     }
   ],
   "render.set_viewport": [
@@ -1165,8 +1281,12 @@
   ],
   "resource.atlas": [
     {
-      "sourceHash": "ee6a5c4c09121554",
-      "ts": "// Load an atlas and set it to a sprite:\ngo.property(\"my_atlas\", resource.atlas(\"/atlas.atlas\"));\n\nexport default defineScript({\n  init(self) {\n    go.set(\"#sprite\", \"image\", self.my_atlas);\n  },\n});\n\n// Load an atlas and set it to a gui:\ngo.property(\"my_atlas\", resource.atlas(\"/atlas.atlas\"));\n\nexport default defineScript({\n  init(self) {\n    go.set(\"#gui\", \"textures\", self.my_atlas, { key: \"my_atlas\" });\n  },\n});"
+      "sourceHash": "10e8e4948751ccc8",
+      "ts": "// Load an atlas and set it to a sprite:\ngo.property(\"my_atlas\", resource.atlas(\"/atlas.atlas\"));\n\nexport default defineScript({\n  init(self) {\n    go.set(\"#sprite\", \"image\", self.my_atlas);\n  },\n});"
+    },
+    {
+      "sourceHash": "46638db8e246e1ed",
+      "ts": "// Load an atlas and set it to a gui:\ngo.property(\"my_atlas\", resource.atlas(\"/atlas.atlas\"));\n\nexport default defineScript({\n  init(self) {\n    go.set(\"#gui\", \"textures\", self.my_atlas, { key: \"my_atlas\" });\n  },\n});"
     }
   ],
   "resource.buffer": [
@@ -1183,8 +1303,12 @@
   ],
   "resource.create_buffer": [
     {
-      "sourceHash": "436c1c10688cba69",
-      "ts": "// Create a buffer object and bind it to a buffer resource\nexport default defineScript({\n  init() {\n    const size = 1;\n    const positions = [\n      // triangle 1\n      size, size, 0,\n      -size, -size, 0,\n      size, -size, 0,\n      // triangle 2\n      size, size, 0,\n      -size, size, 0,\n      -size, -size, 0,\n    ];\n\n    const buffer_handle = buffer.create(positions.length, [\n      {\n        name: hash(\"position\"),\n        type: buffer.VALUE_TYPE_FLOAT32,\n        count: 3,\n      },\n    ]);\n\n    const stream = buffer.get_stream(buffer_handle, hash(\"position\"));\n\n    // transfer vertex data to buffer\n    for (let k = 0; k < positions.length; k++) {\n      stream[k] = positions[k];\n    }\n\n    const my_buffer = resource.create_buffer(\"/my_buffer.bufferc\", { buffer: buffer_handle });\n    go.set(\"/go#mesh\", \"vertices\", my_buffer);\n  },\n});\n\n// Create a buffer resource from existing resource\nexport default defineScript({\n  init() {\n    const res = resource.get_buffer(\"/my_buffer_path.bufferc\");\n    // create a cloned buffer resource from another resource buffer\n    const buf = resource.create_buffer(\"/my_cloned_buffer.bufferc\", { buffer: res });\n    // assign cloned buffer to a mesh component\n    go.set(\"/go#mesh\", \"vertices\", buf);\n  },\n});"
+      "sourceHash": "a4804ebe744d930a",
+      "ts": "// Create a buffer object and bind it to a buffer resource\nexport default defineScript({\n  init() {\n    const size = 1;\n    const positions = [\n      // triangle 1\n      size, size, 0,\n      -size, -size, 0,\n      size, -size, 0,\n      // triangle 2\n      size, size, 0,\n      -size, size, 0,\n      -size, -size, 0,\n    ];\n\n    const buffer_handle = buffer.create(positions.length, [\n      {\n        name: hash(\"position\"),\n        type: buffer.VALUE_TYPE_FLOAT32,\n        count: 3,\n      },\n    ]);\n\n    const stream = buffer.get_stream(buffer_handle, hash(\"position\"));\n\n    // transfer vertex data to buffer\n    for (let k = 0; k < positions.length; k++) {\n      stream[k] = positions[k];\n    }\n\n    const my_buffer = resource.create_buffer(\"/my_buffer.bufferc\", { buffer: buffer_handle });\n    go.set(\"/go#mesh\", \"vertices\", my_buffer);\n  },\n});"
+    },
+    {
+      "sourceHash": "eef45bf7aae2047d",
+      "ts": "// Create a buffer resource from existing resource\nexport default defineScript({\n  init() {\n    const res = resource.get_buffer(\"/my_buffer_path.bufferc\");\n    // create a cloned buffer resource from another resource buffer\n    const buf = resource.create_buffer(\"/my_cloned_buffer.bufferc\", { buffer: res });\n    // assign cloned buffer to a mesh component\n    go.set(\"/go#mesh\", \"vertices\", buf);\n  },\n});"
     }
   ],
   "resource.create_sound_data": [
@@ -1195,24 +1319,44 @@
   ],
   "resource.create_texture": [
     {
-      "sourceHash": "f510168083ffdd30",
-      "ts": "// How to create an 128x128 RGBA texture resource and assign it to a model\nexport default defineScript({\n  init() {\n    const tparams = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format: graphics.TEXTURE_FORMAT_RGBA,\n    };\n    const my_texture_id = resource.create_texture(\"/my_custom_texture.texturec\", tparams);\n    go.set(\"#model\", \"texture0\", my_texture_id);\n  },\n});\n\n// How to create an 128x128 floating point texture (RGBA32F) resource from a buffer object\nexport default defineScript({\n  init() {\n    // Create a new buffer with 4 components and FLOAT32 type\n    const tbuffer = buffer.create(128 * 128, [{ name: hash(\"rgba\"), type: buffer.VALUE_TYPE_FLOAT32, count: 4 }]);\n    const tstream = buffer.get_stream(tbuffer, hash(\"rgba\"));\n\n    // Fill the buffer stream with some float values\n    for (let y = 0; y < 128; y++) {\n      for (let x = 0; x < 128; x++) {\n        const index = y * 128 * 4 + x * 4;\n        tstream[index + 0] = 999.0;\n        tstream[index + 1] = -1.0;\n        tstream[index + 2] = 0.5;\n        tstream[index + 3] = 1.0;\n      }\n    }\n\n    // Create a 2D Texture with a RGBA23F format\n    const tparams = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format: graphics.TEXTURE_FORMAT_RGBA32F,\n    };\n\n    // Note that we pass the buffer as the last argument here!\n    const my_texture_id = resource.create_texture(\"/my_custom_texture.texturec\", tparams, tbuffer);\n\n    // assign the texture to a model\n    go.set(\"#model\", \"texture0\", my_texture_id);\n  },\n});\n\n// How to create a 32x32x32 floating point 3D texture that can be used to generate volumetric data in a compute shader\nexport default defineScript({\n  init() {\n    const t_volume = resource.create_texture(\"/my_backing_texture.texturec\", {\n      type: graphics.TEXTURE_TYPE_IMAGE_3D,\n      width: 32,\n      height: 32,\n      depth: 32,\n      format: resource.TEXTURE_FORMAT_RGBA32F,\n      flags: resource.TEXTURE_USAGE_FLAG_STORAGE + resource.TEXTURE_USAGE_FLAG_SAMPLE,\n    });\n\n    // pass the backing texture to the render script\n    msg.post(\"@render:\", \"add_textures\", [t_volume]);\n  },\n});\n\n// How to create 512x512 texture array with 5 pages.\nconst new_tex = resource.create_texture(\"/runtime/example_array.texturec\", {\n  type: graphics.TEXTURE_TYPE_2D_ARRAY,\n  width: 512,\n  height: 512,\n  page_count: 5,\n  format: graphics.TEXTURE_FORMAT_RGB,\n});"
+      "sourceHash": "717b1b10958e5fa2",
+      "ts": "// How to create an 128x128 RGBA texture resource and assign it to a model\nexport default defineScript({\n  init() {\n    const tparams = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format: graphics.TEXTURE_FORMAT_RGBA,\n    };\n    const my_texture_id = resource.create_texture(\"/my_custom_texture.texturec\", tparams);\n    go.set(\"#model\", \"texture0\", my_texture_id);\n  },\n});"
+    },
+    {
+      "sourceHash": "71bd6ae180eb83d6",
+      "ts": "// How to create an 128x128 floating point texture (RGBA32F) resource from a buffer object\nexport default defineScript({\n  init() {\n    // Create a new buffer with 4 components and FLOAT32 type\n    const tbuffer = buffer.create(128 * 128, [{ name: hash(\"rgba\"), type: buffer.VALUE_TYPE_FLOAT32, count: 4 }]);\n    const tstream = buffer.get_stream(tbuffer, hash(\"rgba\"));\n\n    // Fill the buffer stream with some float values\n    for (let y = 0; y < 128; y++) {\n      for (let x = 0; x < 128; x++) {\n        const index = y * 128 * 4 + x * 4;\n        tstream[index + 0] = 999.0;\n        tstream[index + 1] = -1.0;\n        tstream[index + 2] = 0.5;\n        tstream[index + 3] = 1.0;\n      }\n    }\n\n    // Create a 2D Texture with a RGBA23F format\n    const tparams = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format: graphics.TEXTURE_FORMAT_RGBA32F,\n    };\n\n    // Note that we pass the buffer as the last argument here!\n    const my_texture_id = resource.create_texture(\"/my_custom_texture.texturec\", tparams, tbuffer);\n\n    // assign the texture to a model\n    go.set(\"#model\", \"texture0\", my_texture_id);\n  },\n});"
+    },
+    {
+      "sourceHash": "be4f6e903c862a52",
+      "ts": "// How to create a 32x32x32 floating point 3D texture that can be used to generate volumetric data in a compute shader\nexport default defineScript({\n  init() {\n    const t_volume = resource.create_texture(\"/my_backing_texture.texturec\", {\n      type: graphics.TEXTURE_TYPE_IMAGE_3D,\n      width: 32,\n      height: 32,\n      depth: 32,\n      format: resource.TEXTURE_FORMAT_RGBA32F,\n      flags: resource.TEXTURE_USAGE_FLAG_STORAGE + resource.TEXTURE_USAGE_FLAG_SAMPLE,\n    });\n\n    // pass the backing texture to the render script\n    msg.post(\"@render:\", \"add_textures\", [t_volume]);\n  },\n});"
     },
     {
-      "sourceHash": "41e0481ae55c393d",
-      "ts": "// How to create an 128x128 RGBA texture resource and assign it to a model\nexport default defineScript({\n  init() {\n    const tparams = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format: graphics.TEXTURE_FORMAT_RGBA,\n    };\n    const my_texture_id = resource.create_texture(\"/my_custom_texture.texturec\", tparams);\n    go.set(\"#model\", \"texture0\", my_texture_id);\n  },\n});\n\n// How to create an 128x128 floating point texture (RGBA32F) resource from a buffer object\nexport default defineScript({\n  init() {\n    // Create a new buffer with 4 components and FLOAT32 type\n    const tbuffer = buffer.create(128 * 128, [{ name: hash(\"rgba\"), type: buffer.VALUE_TYPE_FLOAT32, count: 4 }]);\n    const tstream = buffer.get_stream(tbuffer, hash(\"rgba\"));\n\n    // Fill the buffer stream with some float values\n    for (let y = 0; y < 128; y++) {\n      for (let x = 0; x < 128; x++) {\n        const index = y * 128 * 4 + x * 4;\n        tstream[index + 0] = 999.0;\n        tstream[index + 1] = -1.0;\n        tstream[index + 2] = 0.5;\n        tstream[index + 3] = 1.0;\n      }\n    }\n\n    // Create a 2D Texture with a RGBA23F format\n    const tparams = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format: graphics.TEXTURE_FORMAT_RGBA32F,\n    };\n\n    // Note that we pass the buffer as the last argument here!\n    const my_texture_id = resource.create_texture(\"/my_custom_texture.texturec\", tparams, tbuffer);\n\n    // assign the texture to a model\n    go.set(\"#model\", \"texture0\", my_texture_id);\n  },\n});\n\n// How to create a 32x32x32 floating point 3D texture that can be used to generate volumetric data in a compute shader\nexport default defineScript({\n  init() {\n    const t_volume = resource.create_texture(\"/my_backing_texture.texturec\", {\n      type: graphics.TEXTURE_TYPE_IMAGE_3D,\n      width: 32,\n      height: 32,\n      depth: 32,\n      format: resource.TEXTURE_FORMAT_RGBA32F,\n      flags: resource.TEXTURE_USAGE_FLAG_STORAGE + resource.TEXTURE_USAGE_FLAG_SAMPLE,\n    });\n\n    // pass the backing texture to the render script\n    msg.post(\"@render:\", \"add_textures\", [t_volume]);\n  },\n});\n\n// How to create 512x512 texture array with 5 pages.\nconst new_tex = resource.create_texture(\"/runtime/example_array.texturec\", {\n  type: graphics.TEXTURE_TYPE_2D_ARRAY,\n  width: 512,\n  height: 512,\n  page_count: 5,\n  format: graphics.TEXTURE_FORMAT_RGB,\n});"
+      "sourceHash": "b1535ccf9e09d259",
+      "ts": "// How to create 512x512 texture array with 5 pages.\nconst new_tex = resource.create_texture(\"/runtime/example_array.texturec\", {\n  type: graphics.TEXTURE_TYPE_2D_ARRAY,\n  width: 512,\n  height: 512,\n  page_count: 5,\n  format: graphics.TEXTURE_FORMAT_RGB,\n});"
+    },
+    {
+      "sourceHash": "54a85cf9f38f2521",
+      "ts": "// How to create a 32x32x32 floating point 3D texture that can be used to generate volumetric data in a compute shader\nexport default defineScript({\n  init() {\n    const t_volume = resource.create_texture(\"/my_backing_texture.texturec\", {\n      type: graphics.TEXTURE_TYPE_IMAGE_3D,\n      width: 32,\n      height: 32,\n      depth: 32,\n      format: resource.TEXTURE_FORMAT_RGBA32F,\n      flags: resource.TEXTURE_USAGE_FLAG_STORAGE + resource.TEXTURE_USAGE_FLAG_SAMPLE,\n    });\n\n    // pass the backing texture to the render script\n    msg.post(\"@render:\", \"add_textures\", [t_volume]);\n  },\n});"
     }
   ],
   "resource.create_texture_async": [
     {
-      "sourceHash": "b90223f19d598eaa",
-      "ts": "// Create a texture resource asyncronously with a buffer and a callback\nfunction callback(self, request_id, resource) {\n  // The resource has been updated with a new texture,\n  // so we can update other systems with the new handle,\n  // or update components to use the resource if we want\n  const tinfo = resource.get_texture_info(resource);\n  msg.post(\"@render:\", \"set_backing_texture\", tinfo.handle);\n}\n\nexport default defineScript({\n  init() {\n    // Create a texture resource async\n    const tparams = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format: graphics.TEXTURE_FORMAT_RGBA,\n    };\n\n    // Create a new buffer with 4 components\n    const tbuffer = buffer.create(tparams.width * tparams.height, [{ name: hash(\"rgba\"), type: buffer.VALUE_TYPE_UINT8, count: 4 }]);\n    const tstream = buffer.get_stream(tbuffer, hash(\"rgba\"));\n\n    // Fill the buffer stream with some float values\n    for (let y = 0; y < tparams.width; y++) {\n      for (let x = 0; x < tparams.height; x++) {\n        const index = y * 128 * 4 + x * 4;\n        tstream[index + 0] = 255;\n        tstream[index + 1] = 0;\n        tstream[index + 2] = 255;\n        tstream[index + 3] = 255;\n      }\n    }\n    // create the texture\n    const [tpath, request_id] = resource.create_texture_async(\"/my_texture.texturec\", tparams, tbuffer, callback);\n    // at this point you can use the resource as-is, but note that the texture will be a blank 1x1 texture\n    // that will be removed once the new texture has been updated\n    go.set(\"#model\", \"texture0\", tpath);\n  },\n});\n\n// Create a texture resource asyncronously without a callback\nexport default defineScript({\n  init() {\n    // Create a texture resource async\n    const tparams = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format: graphics.TEXTURE_FORMAT_RGBA,\n    };\n\n    // Create a new buffer with 4 components\n    const tbuffer = buffer.create(tparams.width * tparams.height, [{ name: hash(\"rgba\"), type: buffer.VALUE_TYPE_UINT8, count: 4 }]);\n    const tstream = buffer.get_stream(tbuffer, hash(\"rgba\"));\n\n    // Fill the buffer stream with some float values\n    for (let y = 0; y < tparams.width; y++) {\n      for (let x = 0; x < tparams.height; x++) {\n        const index = y * 128 * 4 + x * 4;\n        tstream[index + 0] = 255;\n        tstream[index + 1] = 0;\n        tstream[index + 2] = 255;\n        tstream[index + 3] = 255;\n      }\n    }\n    // create the texture\n    const [tpath, request_id] = resource.create_texture_async(\"/my_texture.texturec\", tparams, tbuffer);\n    // at this point you can use the resource as-is, but note that the texture will be a blank 1x1 texture\n    // that will be removed once the new texture has been updated\n    go.set(\"#model\", \"texture0\", tpath);\n  },\n});"
+      "sourceHash": "f1188598b3ca5eb1",
+      "ts": "// Create a texture resource asyncronously with a buffer and a callback\nfunction callback(self: unknown, request_id: unknown, texture_path: unknown) {\n  // The resource has been updated with a new texture,\n  // so we can update other systems with the new handle,\n  // or update components to use the resource if we want\n  const tinfo = resource.get_texture_info(texture_path as Hash);\n  msg.post(\"@render:\", \"set_backing_texture\", { handle: tinfo.handle });\n}\n\nexport default defineScript({\n  init() {\n    // Create a texture resource async\n    const tparams = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format: graphics.TEXTURE_FORMAT_RGBA,\n    };\n\n    // Create a new buffer with 4 components\n    const tbuffer = buffer.create(tparams.width * tparams.height, [{ name: hash(\"rgba\"), type: buffer.VALUE_TYPE_UINT8, count: 4 }]);\n    const tstream = buffer.get_stream(tbuffer, hash(\"rgba\"));\n\n    // Fill the buffer stream with some float values\n    for (let y = 0; y < tparams.width; y++) {\n      for (let x = 0; x < tparams.height; x++) {\n        const index = y * 128 * 4 + x * 4;\n        tstream[index + 0] = 255;\n        tstream[index + 1] = 0;\n        tstream[index + 2] = 255;\n        tstream[index + 3] = 255;\n      }\n    }\n    // create the texture\n    const [tpath, request_id] = resource.create_texture_async(\"/my_texture.texturec\", tparams, tbuffer, callback);\n    // at this point you can use the resource as-is, but note that the texture will be a blank 1x1 texture\n    // that will be removed once the new texture has been updated\n    go.set(\"#model\", \"texture0\", tpath);\n  },\n});"
+    },
+    {
+      "sourceHash": "921632059c7abb58",
+      "ts": "// Create a texture resource asyncronously without a callback\nexport default defineScript({\n  init() {\n    // Create a texture resource async\n    const tparams = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format: graphics.TEXTURE_FORMAT_RGBA,\n    };\n\n    // Create a new buffer with 4 components\n    const tbuffer = buffer.create(tparams.width * tparams.height, [{ name: hash(\"rgba\"), type: buffer.VALUE_TYPE_UINT8, count: 4 }]);\n    const tstream = buffer.get_stream(tbuffer, hash(\"rgba\"));\n\n    // Fill the buffer stream with some float values\n    for (let y = 0; y < tparams.width; y++) {\n      for (let x = 0; x < tparams.height; x++) {\n        const index = y * 128 * 4 + x * 4;\n        tstream[index + 0] = 255;\n        tstream[index + 1] = 0;\n        tstream[index + 2] = 255;\n        tstream[index + 3] = 255;\n      }\n    }\n    // create the texture\n    const [tpath, request_id] = resource.create_texture_async(\"/my_texture.texturec\", tparams, tbuffer);\n    // at this point you can use the resource as-is, but note that the texture will be a blank 1x1 texture\n    // that will be removed once the new texture has been updated\n    go.set(\"#model\", \"texture0\", tpath);\n  },\n});"
     }
   ],
   "resource.font": [
     {
-      "sourceHash": "f6d4ca24e4f87bfe",
-      "ts": "// Load a font and set it to a label:\ngo.property(\"my_font\", resource.font(\"/font.font\"));\n\nexport default defineScript({\n  init(self) {\n    go.set(\"#label\", \"font\", self.my_font);\n  },\n});\n\n// Load a font and set it to a gui:\ngo.property(\"my_font\", resource.font(\"/font.font\"));\n\nexport default defineScript({\n  init(self) {\n    go.set(\"#gui\", \"fonts\", self.my_font, { key: \"my_font\" });\n  },\n});"
+      "sourceHash": "3e41babc3620a985",
+      "ts": "// Load a font and set it to a label:\ngo.property(\"my_font\", resource.font(\"/font.font\"));\n\nexport default defineScript({\n  init(self) {\n    go.set(\"#label\", \"font\", self.my_font);\n  },\n});"
+    },
+    {
+      "sourceHash": "8eb5018038b320d3",
+      "ts": "// Load a font and set it to a gui:\ngo.property(\"my_font\", resource.font(\"/font.font\"));\n\nexport default defineScript({\n  init(self) {\n    go.set(\"#gui\", \"fonts\", self.my_font, { key: \"my_font\" });\n  },\n});"
     }
   ],
   "resource.get_buffer": [
@@ -1223,8 +1367,12 @@
   ],
   "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});"
+      "sourceHash": "8ae55f299be441f4",
+      "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});"
+    },
+    {
+      "sourceHash": "9356cfca159697a1",
+      "ts": "// 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": [
@@ -1235,8 +1383,12 @@
   ],
   "resource.get_texture_info": [
     {
-      "sourceHash": "4164f100ea5a8c15",
-      "ts": "// Create a new texture and get the metadata from it\nexport default defineScript({\n  init() {\n    // create an empty texture\n    const tparams = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format: graphics.TEXTURE_FORMAT_RGBA,\n    };\n\n    const my_texture_path = resource.create_texture(\"/my_texture.texturec\", tparams);\n    const my_texture_info = resource.get_texture_info(my_texture_path);\n\n    // my_texture_info now contains\n    // {\n    //      handle = <the-numeric-handle>,\n    //      width = 128,\n    //      height = 128,\n    //      depth = 1\n    //      mipmaps = 1,\n    //      page_count = 1,\n    //      type = graphics.TEXTURE_TYPE_2D,\n    //      flags = graphics.TEXTURE_USAGE_FLAG_SAMPLE\n    // }\n  },\n});\n\n// Get the meta data from an atlas resource\nexport default defineScript({\n  init() {\n    const my_atlas_info = resource.get_atlas(\"/my_atlas.a.texturesetc\");\n    const my_texture_info = resource.get_texture_info(my_atlas_info.texture);\n\n    // my_texture_info now contains the information about the texture that is backing the atlas\n  },\n});"
+      "sourceHash": "2d4a0b27a192425a",
+      "ts": "// Create a new texture and get the metadata from it\nexport default defineScript({\n  init() {\n    // create an empty texture\n    const tparams = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format: graphics.TEXTURE_FORMAT_RGBA,\n    };\n\n    const my_texture_path = resource.create_texture(\"/my_texture.texturec\", tparams);\n    const my_texture_info = resource.get_texture_info(my_texture_path);\n\n    // my_texture_info now contains\n    // {\n    //      handle = <the-numeric-handle>,\n    //      width = 128,\n    //      height = 128,\n    //      depth = 1\n    //      mipmaps = 1,\n    //      page_count = 1,\n    //      type = graphics.TEXTURE_TYPE_2D,\n    //      flags = graphics.TEXTURE_USAGE_FLAG_SAMPLE\n    // }\n  },\n});"
+    },
+    {
+      "sourceHash": "4fed93d6cd7f9380",
+      "ts": "// Get the meta data from an atlas resource\nexport default defineScript({\n  init() {\n    const my_atlas_info = resource.get_atlas(\"/my_atlas.a.texturesetc\");\n    const my_texture_info = resource.get_texture_info(my_atlas_info.texture);\n\n    // my_texture_info now contains the information about the texture that is backing the atlas\n  },\n});"
     }
   ],
   "resource.load": [
@@ -1247,8 +1399,12 @@
   ],
   "resource.material": [
     {
-      "sourceHash": "5bc0271405b04027",
-      "ts": "// Load a material and set it to a sprite:\ngo.property(\"my_material\", resource.material(\"/material.material\"));\n\nexport default defineScript({\n  init(self) {\n    go.set(\"#sprite\", \"material\", self.my_material);\n  },\n});\n\n// Load a material resource and update a named material with the resource:\ngo.property(\"my_material\", resource.material(\"/material.material\"));\n\nexport default defineScript({\n  init(self) {\n    go.set(\"#gui\", \"materials\", self.my_material, { key: \"my_material\" });\n  },\n});"
+      "sourceHash": "444ac3e37fe7401e",
+      "ts": "// Load a material and set it to a sprite:\ngo.property(\"my_material\", resource.material(\"/material.material\"));\n\nexport default defineScript({\n  init(self) {\n    go.set(\"#sprite\", \"material\", self.my_material);\n  },\n});"
+    },
+    {
+      "sourceHash": "7de09b2a13f4e657",
+      "ts": "// Load a material resource and update a named material with the resource:\ngo.property(\"my_material\", resource.material(\"/material.material\"));\n\nexport default defineScript({\n  init(self) {\n    go.set(\"#gui\", \"materials\", self.my_material, { key: \"my_material\" });\n  },\n});"
     }
   ],
   "resource.render_target": [
@@ -1265,24 +1421,44 @@
   ],
   "resource.set_atlas": [
     {
-      "sourceHash": "349576ce8a915179",
-      "ts": "// Add a new animation to an existing atlas\nexport default defineScript({\n  init() {\n    const data = resource.get_atlas(\"/main/my_atlas.a.texturesetc\");\n    const my_animation = {\n      id: \"my_new_animation\",\n      width: 128,\n      height: 128,\n      frame_start: 1,\n      frame_end: 6,\n      playback: go.PLAYBACK_LOOP_PINGPONG,\n      fps: 8,\n    };\n    data.animations.push(my_animation);\n    resource.set_atlas(\"/main/my_atlas.a.texturesetc\", data);\n  },\n});\n\n// Sets atlas data for a 256x256 texture with a single animation being rendered as a quad\nexport default defineScript({\n  init() {\n    const params = {\n      texture: \"/main/my_256x256_texture.texturec\",\n      animations: [\n        {\n          id: \"my_animation\",\n          width: 256,\n          height: 256,\n          frames: [1],\n        },\n      ],\n      geometries: [\n        {\n          vertices: [0, 0, 0, 256, 256, 256, 256, 0],\n          uvs: [0, 0, 0, 256, 256, 256, 256, 0],\n          indices: [0, 1, 2, 0, 2, 3],\n        },\n      ],\n    };\n    resource.set_atlas(\"/main/test.a.texturesetc\", params);\n  },\n});"
+      "sourceHash": "58ec7c40c31875a4",
+      "ts": "// Add a new animation to an existing atlas\nexport default defineScript({\n  init() {\n    const data = resource.get_atlas(\"/main/my_atlas.a.texturesetc\");\n    const my_animation = {\n      id: \"my_new_animation\",\n      width: 128,\n      height: 128,\n      frame_start: 1,\n      frame_end: 6,\n      playback: go.PLAYBACK_LOOP_PINGPONG,\n      fps: 8,\n    };\n    data.animations.push(my_animation);\n    resource.set_atlas(\"/main/my_atlas.a.texturesetc\", data);\n  },\n});"
+    },
+    {
+      "sourceHash": "c672fd8c9d921f68",
+      "ts": "// Sets atlas data for a 256x256 texture with a single animation being rendered as a quad\nexport default defineScript({\n  init() {\n    const params = {\n      texture: \"/main/my_256x256_texture.texturec\",\n      animations: [\n        {\n          id: \"my_animation\",\n          width: 256,\n          height: 256,\n          frames: [1],\n        },\n      ],\n      geometries: [\n        {\n          vertices: [0, 0, 0, 256, 256, 256, 256, 0],\n          uvs: [0, 0, 0, 256, 256, 256, 256, 0],\n          indices: [0, 1, 2, 0, 2, 3],\n        },\n      ],\n    };\n    resource.set_atlas(\"/main/test.a.texturesetc\", params);\n  },\n});"
     }
   ],
   "resource.set_buffer": [
     {
       "sourceHash": "a52fd8ac7453f601",
-      "ts": "// How to set the data from a buffer\nfunction fill_stream(stream, verts) {\n  verts.forEach((value, key) => {\n    stream[key] = verts[key];\n  });\n}\n\nexport default defineScript({\n  init() {\n    const res_path = go.get(\"#mesh\", \"vertices\");\n\n    const positions = [\n      1, -1, 0,\n      1, 1, 0,\n      -1, -1, 0,\n    ];\n\n    const num_verts = positions.length / 3;\n\n    // create a new buffer\n    let buf = buffer.create(num_verts, [{ name: hash(\"position\"), type: buffer.VALUE_TYPE_FLOAT32, count: 3 }]);\n\n    buf = resource.get_buffer(res_path);\n    const stream_positions = buffer.get_stream(buf, \"position\");\n\n    fill_stream(stream_positions, positions);\n\n    resource.set_buffer(res_path, buf);\n  },\n});"
+      "ts": "// How to set the data from a buffer\nfunction fill_stream(stream: { [index: number]: number }, verts: number[]) {\n  verts.forEach((value, key) => {\n    stream[key] = value;\n  });\n}\n\nexport default defineScript({\n  init() {\n    const res_path = go.get(\"#mesh\", \"vertices\");\n\n    const positions = [\n      1, -1, 0,\n      1, 1, 0,\n      -1, -1, 0,\n    ];\n\n    const num_verts = positions.length / 3;\n\n    // create a new buffer\n    let buf = buffer.create(num_verts, [{ name: hash(\"position\"), type: buffer.VALUE_TYPE_FLOAT32, count: 3 }]);\n\n    buf = resource.get_buffer(res_path);\n    const stream_positions = buffer.get_stream(buf, \"position\");\n\n    fill_stream(stream_positions, positions);\n\n    resource.set_buffer(res_path, buf);\n  },\n});"
     }
   ],
   "resource.set_texture": [
     {
-      "sourceHash": "1f7a5108992a12f0",
-      "ts": "// How to set all pixels of an atlas\nexport default defineScript({\n  init(self) {\n    self.height = 128;\n    self.width = 128;\n    self.buffer = buffer.create(self.width * self.height, [{ name: hash(\"rgb\"), type: buffer.VALUE_TYPE_UINT8, count: 3 }]);\n    self.stream = buffer.get_stream(self.buffer, hash(\"rgb\"));\n\n    for (let y = 0; y < self.height; y++) {\n      for (let x = 0; x < self.width; x++) {\n        const index = y * self.width * 3 + x * 3;\n        self.stream[index + 0] = 0xff;\n        self.stream[index + 1] = 0x80;\n        self.stream[index + 2] = 0x10;\n      }\n    }\n\n    const resource_path = go.get(\"#model\", \"texture0\");\n    const args = { width: self.width, height: self.height, type: graphics.TEXTURE_TYPE_2D, format: graphics.TEXTURE_FORMAT_RGB, num_mip_maps: 1 };\n    resource.set_texture(resource_path, args, self.buffer);\n  },\n});\n\n// How to update a specific region of an atlas by using the x,y values. Assumes the already set atlas is a 128x128 texture.\nexport default defineScript({\n  init(self) {\n    self.x = 16;\n    self.y = 16;\n    self.height = 128 - self.x * 2;\n    self.width = 128 - self.y * 2;\n    self.buffer = buffer.create(self.width * self.height, [{ name: hash(\"rgb\"), type: buffer.VALUE_TYPE_UINT8, count: 3 }]);\n    self.stream = buffer.get_stream(self.buffer, hash(\"rgb\"));\n\n    for (let y = 0; y < self.height; y++) {\n      for (let x = 0; x < self.width; x++) {\n        const index = y * self.width * 3 + x * 3;\n        self.stream[index + 0] = 0xff;\n        self.stream[index + 1] = 0x80;\n        self.stream[index + 2] = 0x10;\n      }\n    }\n\n    const resource_path = go.get(\"#model\", \"texture0\");\n    const args = { width: self.width, height: self.height, x: self.x, y: self.y, type: graphics.TEXTURE_TYPE_2D, format: graphics.TEXTURE_FORMAT_RGB, num_mip_maps: 1 };\n    resource.set_texture(resource_path, args, self.buffer);\n  },\n});\n\n// Update a texture from a buffer resource\ngo.property(\"my_buffer\", resource.buffer(\"/my_default_buffer.buffer\"));\n\nexport default defineScript({\n  init(self) {\n    const resource_path = go.get(\"#model\", \"texture0\");\n    // the \"my_buffer\" resource is expected to hold 128 * 128 * 3 bytes!\n    const args = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format: graphics.TEXTURE_FORMAT_RGB,\n    };\n    // Note that the extra resource.get_buffer call is a requirement here\n    // since the \"self.my_buffer\" is just pointing to a buffer resource path\n    // and not an actual buffer object or buffer resource.\n    resource.set_texture(resource_path, args, resource.get_buffer(self.my_buffer));\n  },\n});\n\n// Update an existing 3D texture from a buffer\nexport default defineScript({\n  init() {\n    // create a buffer that can hold the data of a 8x8x8 texture\n    const tbuffer = buffer.create(8 * 8 * 8, [{ name: hash(\"rgba\"), type: buffer.VALUE_TYPE_FLOAT32, count: 4 }]);\n    const tstream = buffer.get_stream(tbuffer, hash(\"rgba\"));\n\n    // populate the buffer with some data\n    let index = 0;\n    for (let z = 0; z < 8; z++) {\n      for (let y = 0; y < 8; y++) {\n        for (let x = 0; x < 8; x++) {\n          tstream[index + 0] = x;\n          tstream[index + 1] = y;\n          tstream[index + 2] = z;\n          tstream[index + 3] = 1.0;\n          index = index + 4;\n        }\n      }\n    }\n\n    const t_args = {\n      type: graphics.TEXTURE_TYPE_IMAGE_3D,\n      width: 8,\n      height: 8,\n      depth: 8,\n      format: resource.TEXTURE_FORMAT_RGBA32F,\n    };\n\n    // This expects that the texture resource \"/my_3d_texture.texturec\" already exists\n    // and is a 3D texture resource. To create a dynamic 3D texture resource\n    // use the \"resource.create_texture\" function.\n    resource.set_texture(\"/my_3d_texture.texturec\", t_args, tbuffer);\n  },\n});\n\n// Update texture 2nd array page with loaded texture from png\n// new_tex is resource handle of texture which was created via resource.create_resource\nconst tex_path = \"/bundle_resources/page_02.png\";\nconst [data] = sys.load_resource(tex_path);\nconst buf = image.load_buffer(data);\nresource.set_texture(\n  new_tex,\n  {\n    type: graphics.TEXTURE_TYPE_2D_ARRAY,\n    width: buf.width,\n    height: buf.height,\n    page: 1,\n    format: graphics.TEXTURE_FORMAT_RGB,\n  },\n  buf.buffer,\n);\ngo.set(\"#mesh\", \"texture0\", new_tex);"
+      "sourceHash": "fe312c35ef2ab0f4",
+      "ts": "// How to set all pixels of an atlas\nexport default defineScript({\n  init(self) {\n    self.height = 128;\n    self.width = 128;\n    self.buffer = buffer.create(self.width * self.height, [{ name: hash(\"rgb\"), type: buffer.VALUE_TYPE_UINT8, count: 3 }]);\n    self.stream = buffer.get_stream(self.buffer, hash(\"rgb\"));\n\n    for (let y = 0; y < self.height; y++) {\n      for (let x = 0; x < self.width; x++) {\n        const index = y * self.width * 3 + x * 3;\n        self.stream[index + 0] = 0xff;\n        self.stream[index + 1] = 0x80;\n        self.stream[index + 2] = 0x10;\n      }\n    }\n\n    const resource_path = go.get(\"#model\", \"texture0\");\n    const args = { width: self.width, height: self.height, type: graphics.TEXTURE_TYPE_2D, format: graphics.TEXTURE_FORMAT_RGB, num_mip_maps: 1 };\n    resource.set_texture(resource_path, args, self.buffer);\n  },\n});"
+    },
+    {
+      "sourceHash": "b4098f0f37b9c1d0",
+      "ts": "// How to update a specific region of an atlas by using the x,y values. Assumes the already set atlas is a 128x128 texture.\nexport default defineScript({\n  init(self) {\n    self.x = 16;\n    self.y = 16;\n    self.height = 128 - self.x * 2;\n    self.width = 128 - self.y * 2;\n    self.buffer = buffer.create(self.width * self.height, [{ name: hash(\"rgb\"), type: buffer.VALUE_TYPE_UINT8, count: 3 }]);\n    self.stream = buffer.get_stream(self.buffer, hash(\"rgb\"));\n\n    for (let y = 0; y < self.height; y++) {\n      for (let x = 0; x < self.width; x++) {\n        const index = y * self.width * 3 + x * 3;\n        self.stream[index + 0] = 0xff;\n        self.stream[index + 1] = 0x80;\n        self.stream[index + 2] = 0x10;\n      }\n    }\n\n    const resource_path = go.get(\"#model\", \"texture0\");\n    const args = { width: self.width, height: self.height, x: self.x, y: self.y, type: graphics.TEXTURE_TYPE_2D, format: graphics.TEXTURE_FORMAT_RGB, num_mip_maps: 1 };\n    resource.set_texture(resource_path, args, self.buffer);\n  },\n});"
+    },
+    {
+      "sourceHash": "02d7f2ec29971bf1",
+      "ts": "// Update a texture from a buffer resource\ngo.property(\"my_buffer\", resource.buffer(\"/my_default_buffer.buffer\"));\n\nexport default defineScript({\n  init(self) {\n    const resource_path = go.get(\"#model\", \"texture0\");\n    // the \"my_buffer\" resource is expected to hold 128 * 128 * 3 bytes!\n    const args = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format: graphics.TEXTURE_FORMAT_RGB,\n    };\n    // Note that the extra resource.get_buffer call is a requirement here\n    // since the \"self.my_buffer\" is just pointing to a buffer resource path\n    // and not an actual buffer object or buffer resource.\n    resource.set_texture(resource_path, args, resource.get_buffer(self.my_buffer));\n  },\n});"
+    },
+    {
+      "sourceHash": "15829bfe1b186bc3",
+      "ts": "// Update an existing 3D texture from a buffer\nexport default defineScript({\n  init() {\n    // create a buffer that can hold the data of a 8x8x8 texture\n    const tbuffer = buffer.create(8 * 8 * 8, [{ name: hash(\"rgba\"), type: buffer.VALUE_TYPE_FLOAT32, count: 4 }]);\n    const tstream = buffer.get_stream(tbuffer, hash(\"rgba\"));\n\n    // populate the buffer with some data\n    let index = 0;\n    for (let z = 0; z < 8; z++) {\n      for (let y = 0; y < 8; y++) {\n        for (let x = 0; x < 8; x++) {\n          tstream[index + 0] = x;\n          tstream[index + 1] = y;\n          tstream[index + 2] = z;\n          tstream[index + 3] = 1.0;\n          index = index + 4;\n        }\n      }\n    }\n\n    const t_args = {\n      type: graphics.TEXTURE_TYPE_IMAGE_3D,\n      width: 8,\n      height: 8,\n      depth: 8,\n      format: resource.TEXTURE_FORMAT_RGBA32F,\n    };\n\n    // This expects that the texture resource \"/my_3d_texture.texturec\" already exists\n    // and is a 3D texture resource. To create a dynamic 3D texture resource\n    // use the \"resource.create_texture\" function.\n    resource.set_texture(\"/my_3d_texture.texturec\", t_args, tbuffer);\n  },\n});"
+    },
+    {
+      "sourceHash": "f9b616092f8c1b6a",
+      "ts": "// Update texture 2nd array page with loaded texture from png\nconst tex_path = \"/bundle_resources/page_02.png\";\nconst [data] = sys.load_resource(tex_path);\nif (data !== undefined) {\n  const buf = image.load_buffer(data);\n  if (buf !== undefined) {\n    // new_tex is the resource handle of a texture created via resource.create_texture\n    const new_tex = resource.create_texture(\"/my_array_texture.texturec\", {\n      type: graphics.TEXTURE_TYPE_2D_ARRAY,\n      width: buf.width,\n      height: buf.height,\n      page_count: 2,\n      format: graphics.TEXTURE_FORMAT_RGB,\n    });\n    resource.set_texture(\n      new_tex,\n      {\n        type: graphics.TEXTURE_TYPE_2D_ARRAY,\n        width: buf.width,\n        height: buf.height,\n        page: 1,\n        format: graphics.TEXTURE_FORMAT_RGB,\n      },\n      buf.buffer,\n    );\n    go.set(\"#mesh\", \"texture0\", new_tex);\n  }\n}"
     },
     {
-      "sourceHash": "48a7f4c2c8433aed",
-      "ts": "// How to set all pixels of an atlas\nexport default defineScript({\n  init(self) {\n    self.height = 128;\n    self.width = 128;\n    self.buffer = buffer.create(self.width * self.height, [{ name: hash(\"rgb\"), type: buffer.VALUE_TYPE_UINT8, count: 3 }]);\n    self.stream = buffer.get_stream(self.buffer, hash(\"rgb\"));\n\n    for (let y = 0; y < self.height; y++) {\n      for (let x = 0; x < self.width; x++) {\n        const index = y * self.width * 3 + x * 3;\n        self.stream[index + 0] = 0xff;\n        self.stream[index + 1] = 0x80;\n        self.stream[index + 2] = 0x10;\n      }\n    }\n\n    const resource_path = go.get(\"#model\", \"texture0\");\n    const args = { width: self.width, height: self.height, type: graphics.TEXTURE_TYPE_2D, format: graphics.TEXTURE_FORMAT_RGB, num_mip_maps: 1 };\n    resource.set_texture(resource_path, args, self.buffer);\n  },\n});\n\n// How to update a specific region of an atlas by using the x,y values. Assumes the already set atlas is a 128x128 texture.\nexport default defineScript({\n  init(self) {\n    self.x = 16;\n    self.y = 16;\n    self.height = 128 - self.x * 2;\n    self.width = 128 - self.y * 2;\n    self.buffer = buffer.create(self.width * self.height, [{ name: hash(\"rgb\"), type: buffer.VALUE_TYPE_UINT8, count: 3 }]);\n    self.stream = buffer.get_stream(self.buffer, hash(\"rgb\"));\n\n    for (let y = 0; y < self.height; y++) {\n      for (let x = 0; x < self.width; x++) {\n        const index = y * self.width * 3 + x * 3;\n        self.stream[index + 0] = 0xff;\n        self.stream[index + 1] = 0x80;\n        self.stream[index + 2] = 0x10;\n      }\n    }\n\n    const resource_path = go.get(\"#model\", \"texture0\");\n    const args = { width: self.width, height: self.height, x: self.x, y: self.y, type: graphics.TEXTURE_TYPE_2D, format: graphics.TEXTURE_FORMAT_RGB, num_mip_maps: 1 };\n    resource.set_texture(resource_path, args, self.buffer);\n  },\n});\n\n// Update a texture from a buffer resource\ngo.property(\"my_buffer\", resource.buffer(\"/my_default_buffer.buffer\"));\n\nexport default defineScript({\n  init(self) {\n    const resource_path = go.get(\"#model\", \"texture0\");\n    // the \"my_buffer\" resource is expected to hold 128 * 128 * 3 bytes!\n    const args = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format: graphics.TEXTURE_FORMAT_RGB,\n    };\n    // Note that the extra resource.get_buffer call is a requirement here\n    // since the \"self.my_buffer\" is just pointing to a buffer resource path\n    // and not an actual buffer object or buffer resource.\n    resource.set_texture(resource_path, args, resource.get_buffer(self.my_buffer));\n  },\n});\n\n// Update an existing 3D texture from a buffer\nexport default defineScript({\n  init() {\n    // create a buffer that can hold the data of a 8x8x8 texture\n    const tbuffer = buffer.create(8 * 8 * 8, [{ name: hash(\"rgba\"), type: buffer.VALUE_TYPE_FLOAT32, count: 4 }]);\n    const tstream = buffer.get_stream(tbuffer, hash(\"rgba\"));\n\n    // populate the buffer with some data\n    let index = 0;\n    for (let z = 0; z < 8; z++) {\n      for (let y = 0; y < 8; y++) {\n        for (let x = 0; x < 8; x++) {\n          tstream[index + 0] = x;\n          tstream[index + 1] = y;\n          tstream[index + 2] = z;\n          tstream[index + 3] = 1.0;\n          index = index + 4;\n        }\n      }\n    }\n\n    const t_args = {\n      type: graphics.TEXTURE_TYPE_IMAGE_3D,\n      width: 8,\n      height: 8,\n      depth: 8,\n      format: resource.TEXTURE_FORMAT_RGBA32F,\n    };\n\n    // This expects that the texture resource \"/my_3d_texture.texturec\" already exists\n    // and is a 3D texture resource. To create a dynamic 3D texture resource\n    // use the \"resource.create_texture\" function.\n    resource.set_texture(\"/my_3d_texture.texturec\", t_args, tbuffer);\n  },\n});\n\n// Update texture 2nd array page with loaded texture from png\n// new_tex is resource handle of texture which was created via resource.create_resource\nconst tex_path = \"/bundle_resources/page_02.png\";\nconst [data] = sys.load_resource(tex_path);\nconst buf = image.load_buffer(data);\nresource.set_texture(\n  new_tex,\n  {\n    type: graphics.TEXTURE_TYPE_2D_ARRAY,\n    width: buf.width,\n    height: buf.height,\n    page: 1,\n    format: graphics.TEXTURE_FORMAT_RGB,\n  },\n  buf.buffer,\n);\ngo.set(\"#mesh\", \"texture0\", new_tex);"
+      "sourceHash": "34dce6f8362c0e92",
+      "ts": "// Update an existing 3D texture from a buffer\nexport default defineScript({\n  init() {\n    // create a buffer that can hold the data of a 8x8x8 texture\n    const tbuffer = buffer.create(8 * 8 * 8, [{ name: hash(\"rgba\"), type: buffer.VALUE_TYPE_FLOAT32, count: 4 }]);\n    const tstream = buffer.get_stream(tbuffer, hash(\"rgba\"));\n\n    // populate the buffer with some data\n    let index = 0;\n    for (let z = 0; z < 8; z++) {\n      for (let y = 0; y < 8; y++) {\n        for (let x = 0; x < 8; x++) {\n          tstream[index + 0] = x;\n          tstream[index + 1] = y;\n          tstream[index + 2] = z;\n          tstream[index + 3] = 1.0;\n          index = index + 4;\n        }\n      }\n    }\n\n    const t_args = {\n      type: graphics.TEXTURE_TYPE_IMAGE_3D,\n      width: 8,\n      height: 8,\n      depth: 8,\n      format: resource.TEXTURE_FORMAT_RGBA32F,\n    };\n\n    // This expects that the texture resource \"/my_3d_texture.texturec\" already exists\n    // and is a 3D texture resource. To create a dynamic 3D texture resource\n    // use the \"resource.create_texture\" function.\n    resource.set_texture(\"/my_3d_texture.texturec\", t_args, tbuffer);\n  },\n});"
     }
   ],
   "resource.texture": [
@@ -1306,7 +1482,7 @@
   "socket.newtry": [
     {
       "sourceHash": "38a669dbf612b327",
-      "ts": "// Perform operations on an open socket c:\n// create a try function that closes 'c' on error\nconst try_ = socket.newtry(() => c.close());\n// do everything reassured c will be closed\ntry_(c.send(\"hello there?\\r\\n\"));\nconst answer = try_(c.receive());\n// ...\ntry_(c.send(\"good bye\\r\\n\"));\nc.close();"
+      "ts": "// Perform operations on an open socket c:\nconst [c] = socket.connect(\"localhost\", 80);\nif (c !== undefined) {\n  // create a try function that closes 'c' on error\n  const try_ = socket.newtry(() => c.close());\n  // do everything reassured c will be closed\n  try_(c.send(\"hello there?\\r\\n\"));\n  const answer = try_(c.receive());\n  // ...\n  try_(c.send(\"good bye\\r\\n\"));\n  c.close();\n}"
     }
   ],
   "socket.protect": [
@@ -1318,7 +1494,7 @@
   "socket.skip": [
     {
       "sourceHash": "3a75c35a80c48e9e",
-      "ts": "// Instead of doing the following with dummy variables:\n// get the status code and separator from SMTP server reply\nconst [dummy1, dummy2, code, sep] = string.find(line, \"^(%d%d%d)(.?)\");\n\n// You can skip a number of variables:\n// get the status code and separator from SMTP server reply\nconst [code, sep] = socket.skip(2, string.find(line, \"^(%d%d%d)(.?)\"));"
+      "ts": "const line = \"250 OK\";\n\n// Instead of doing the following with dummy variables:\n// get the status code and separator from SMTP server reply\nconst [dummy1, dummy2, code, sep] = string.find(line, \"^(%d%d%d)(.?)\");\n\n// You can skip a number of variables:\n// get the status code and separator from SMTP server reply\nconst [code, sep] = socket.skip(2, string.find(line, \"^(%d%d%d)(.?)\"));"
     }
   ],
   "sound.get_group_gain": [
@@ -1372,7 +1548,7 @@
   "sound.play": [
     {
       "sourceHash": "fcfbfd341c41ec59",
-      "ts": "// Assuming the script belongs to an instance with a sound-component with id\n// \"sound\", this will make the component play its sound after 1 second:\nsound.play(\"#sound\", { delay: 1, gain: 0.9, pan: -1.0 });\n\n// Using the callback argument, you can chain several sounds together:\nfunction sound_done(self, message_id, message, sender) {\n  // play 'boom' sound fx when the countdown has completed\n  if (message_id === hash(\"sound_done\") && message.play_id === self.countdown_id) {\n    sound.play(\"#boom\", undefined, sound_done);\n  }\n}\n\nexport default defineScript({\n  init(self) {\n    self.countdown_id = sound.play(\"#countdown\", undefined, sound_done);\n  },\n});"
+      "ts": "// Assuming the script belongs to an instance with a sound-component with id\n// \"sound\", this will make the component play its sound after 1 second:\nsound.play(\"#sound\", { delay: 1, gain: 0.9, pan: -1.0 });\n\n// Using the callback argument, you can chain several sounds together:\nfunction sound_done(self: unknown, message_id: unknown, message: unknown, sender: unknown) {\n  // play 'boom' sound fx when the countdown has completed\n  const { play_id } = message as { play_id: number };\n  if (message_id === hash(\"sound_done\") && play_id === (self as { countdown_id: number }).countdown_id) {\n    sound.play(\"#boom\", undefined, sound_done);\n  }\n}\n\nexport default defineScript({\n  init(self) {\n    self.countdown_id = sound.play(\"#countdown\", undefined, sound_done);\n  },\n});"
     }
   ],
   "sound.set_gain": [
@@ -1426,13 +1602,13 @@
   "sys.deserialize": [
     {
       "sourceHash": "3129688709daf585",
-      "ts": "// Deserialize a table that was previously serialized:\nconst buffer = sys.serialize(my_table);\nconst table = sys.deserialize(buffer);"
+      "ts": "// Deserialize a table that was previously serialized:\nconst my_table = { score: 100, level: 3 };\nconst buffer = sys.serialize(my_table);\nconst table = sys.deserialize(buffer);"
     }
   ],
   "sys.exists": [
     {
       "sourceHash": "7e98945102ff1ab7",
-      "ts": "// Load data but return nil if path didn't exist\nif (!sys.exists(path)) {\n  return undefined;\n}\nreturn sys.load(path); // returns {} if it failed"
+      "ts": "// Load data but return nil if path didn't exist\nconst path = \"/save/game.dat\";\nif (!sys.exists(path)) {\n  return undefined;\n}\nreturn sys.load(path); // returns {} if it failed"
     }
   ],
   "sys.exit": [
@@ -1492,7 +1668,7 @@
   "sys.get_host_path": [
     {
       "sourceHash": "a059ecb3d55d5c22",
-      "ts": "// Save data on the host\nconst host_path = sys.get_host_path(\"logs/test.txt\");\nsys.save(host_path, mytable);\n\n// Load data from the host\nconst host_path = sys.get_host_path(\"logs/test.txt\");\nconst table = sys.load(host_path);"
+      "ts": "// Save data on the host\nconst mytable = { score: 100, level: 3 };\nconst host_path = sys.get_host_path(\"logs/test.txt\");\nsys.save(host_path, mytable);\n\n// Load data from the host\nconst host_path = sys.get_host_path(\"logs/test.txt\");\nconst table = sys.load(host_path);"
     }
   ],
   "sys.get_ifaddrs": [
@@ -1528,7 +1704,7 @@
   "sys.load_buffer_async": [
     {
       "sourceHash": "6a383bca91cf11eb",
-      "ts": "// Load binary data from a custom project resource and update a texture resource:\nfunction my_callback(self, request_id, result) {\n  if (result.status === resource.REQUEST_STATUS_FINISHED) {\n    resource.set_texture(\"/my_texture\", {}, result.buf); // texture args\n  }\n}\n\nconst my_request = sys.load_buffer_async(\"/assets/my_level_data.bin\", my_callback);\n\n// Load binary data from non-custom resource files on disk:\nfunction my_callback(self, request_id, result) {\n  if (result.status !== sys.REQUEST_STATUS_FINISHED) {\n    // uh oh! File could not be found, do something graceful\n  } else if (request_id === self.first_asset) {\n    // result.buffer contains data from my_level_asset.bin\n  } else if (request_id === self.second_asset) {\n    // result.buffer contains data from 'my_level.bin'\n  }\n}\n\nexport default defineScript({\n  init(self) {\n    self.first_asset = hash(\"folder_next_to_binary/my_level_asset.bin\");\n    self.second_asset = hash(\"/some_absolute_path/my_level.bin\");\n    self.first_request = sys.load_buffer_async(self.first_asset, my_callback);\n    self.second_request = sys.load_buffer_async(self.second_asset, my_callback);\n  },\n});"
+      "ts": "// Load binary data from a custom project resource and update a texture resource:\nfunction my_callback(self: unknown, request_id: unknown, result: unknown) {\n  const { status, buf } = result as { status: number; buf: Opaque<\"buffer\"> };\n  if (status === resource.REQUEST_STATUS_FINISHED) {\n    resource.set_texture(\"/my_texture\", {}, buf); // texture args\n  }\n}\n\nconst my_request = sys.load_buffer_async(\"/assets/my_level_data.bin\", my_callback);\n\n// Load binary data from non-custom resource files on disk:\nfunction my_callback(self: unknown, request_id: unknown, result: unknown) {\n  const { first_asset, second_asset } = self as { first_asset: Hash; second_asset: Hash };\n  if ((result as { status: number }).status !== sys.REQUEST_STATUS_FINISHED) {\n    // uh oh! File could not be found, do something graceful\n  } else if (request_id === first_asset) {\n    // result.buffer contains data from my_level_asset.bin\n  } else if (request_id === second_asset) {\n    // result.buffer contains data from 'my_level.bin'\n  }\n}\n\nexport default defineScript({\n  init(self) {\n    self.first_asset = hash(\"folder_next_to_binary/my_level_asset.bin\");\n    self.second_asset = hash(\"/some_absolute_path/my_level.bin\");\n    self.first_request = sys.load_buffer_async(self.first_asset, my_callback);\n    self.second_request = sys.load_buffer_async(self.second_asset, my_callback);\n  },\n});"
     }
   ],
   "sys.load_resource": [
@@ -1576,7 +1752,7 @@
   "sys.set_error_handler": [
     {
       "sourceHash": "7346508f30f50bc9",
-      "ts": "// Install error handler that just prints the errors\nfunction my_error_handler(source, message, traceback) {\n  print(source); //> lua\n  print(message); //> main/my.script:10: attempt to perform arithmetic on a string value\n  print(traceback); //> stack traceback:\n  //>         main/test.script:10: in function 'boom'\n  //>         main/test.script:15: in function <main/my.script:13>\n}\n\nfunction boom() {\n  return 10 + \"string\";\n}\n\nexport default defineScript({\n  init() {\n    sys.set_error_handler(my_error_handler);\n    boom();\n  },\n});"
+      "ts": "// Install error handler that just prints the errors\nfunction my_error_handler(source: unknown, message: unknown, traceback: unknown) {\n  print(source); //> lua\n  print(message); //> main/my.script:10: attempt to perform arithmetic on a string value\n  print(traceback); //> stack traceback:\n  //>         main/test.script:10: in function 'boom'\n  //>         main/test.script:15: in function <main/my.script:13>\n}\n\nfunction boom() {\n  return 10 + \"string\";\n}\n\nexport default defineScript({\n  init() {\n    sys.set_error_handler(my_error_handler);\n    boom();\n  },\n});"
     }
   ],
   "sys.set_render_enable": [
@@ -1606,19 +1782,19 @@
   "tilemap.get_tile": [
     {
       "sourceHash": "a4284f541bd0cf03",
-      "ts": "// get the tile under the player.\nconst tileno = tilemap.get_tile(\"/level#tilemap\", \"foreground\", self.player_x, self.player_y);"
+      "ts": "function tile_under_player(self: { player_x: number; player_y: number }) {\n  // get the tile under the player.\n  const tileno = tilemap.get_tile(\"/level#tilemap\", \"foreground\", self.player_x, self.player_y);\n}"
     }
   ],
   "tilemap.get_tile_info": [
     {
       "sourceHash": "a05cf9c118a0d36c",
-      "ts": "// get the tile under the player.\nconst tile_info = tilemap.get_tile_info(\"/level#tilemap\", \"foreground\", self.player_x, self.player_y);\npprint(tile_info);\n// {\n//    index = 0,\n//    h_flip = false,\n//    v_flip = true,\n//    rotate_90 = false\n// }"
+      "ts": "function tile_info_under_player(self: { player_x: number; player_y: number }) {\n  // get the tile under the player.\n  const tile_info = tilemap.get_tile_info(\"/level#tilemap\", \"foreground\", self.player_x, self.player_y);\n  pprint(tile_info);\n  // {\n  //    index = 0,\n  //    h_flip = false,\n  //    v_flip = true,\n  //    rotate_90 = false\n  // }\n}"
     }
   ],
   "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[row_index][column_index];\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": [
@@ -1630,7 +1806,7 @@
   "tilemap.set_tile": [
     {
       "sourceHash": "bc75d2a572ada34d",
-      "ts": "// Clear the tile under the player.\ntilemap.set_tile(\"/level#tilemap\", \"foreground\", self.player_x, self.player_y, 0);\n\n// Set tile with different combination of flip and rotation\ntilemap.set_tile(\"#tilemap\", \"layer1\", x, y, 0, tilemap.H_FLIP + tilemap.V_FLIP + tilemap.ROTATE_90);\ntilemap.set_tile(\"#tilemap\", \"layer1\", x, y, 0, tilemap.H_FLIP + tilemap.ROTATE_270);\ntilemap.set_tile(\"#tilemap\", \"layer1\", x, y, 0, tilemap.V_FLIP + tilemap.H_FLIP);\ntilemap.set_tile(\"#tilemap\", \"layer1\", x, y, 0, tilemap.ROTATE_180);"
+      "ts": "function set_tiles(self: { player_x: number; player_y: number }, x: number, y: number) {\n  // Clear the tile under the player.\n  tilemap.set_tile(\"/level#tilemap\", \"foreground\", self.player_x, self.player_y, 0);\n\n  // Set tile with different combination of flip and rotation\n  tilemap.set_tile(\"#tilemap\", \"layer1\", x, y, 0, tilemap.H_FLIP + tilemap.V_FLIP + tilemap.ROTATE_90);\n  tilemap.set_tile(\"#tilemap\", \"layer1\", x, y, 0, tilemap.H_FLIP + tilemap.ROTATE_270);\n  tilemap.set_tile(\"#tilemap\", \"layer1\", x, y, 0, tilemap.V_FLIP + tilemap.H_FLIP);\n  tilemap.set_tile(\"#tilemap\", \"layer1\", x, y, 0, tilemap.ROTATE_180);\n}"
     }
   ],
   "tilemap.set_visible": [
@@ -1642,25 +1818,25 @@
   "timer.cancel": [
     {
       "sourceHash": "00f46bbbb35028b3",
-      "ts": "self.handle = timer.delay(1, true, () => print(\"print every second\"));\n// ...\nconst result = timer.cancel(self.handle);\nif (!result) {\n  print(\"the timer is already cancelled\");\n}"
+      "ts": "function cancel_ticking(self: { handle: number }) {\n  self.handle = timer.delay(1, true, () => print(\"print every second\"));\n  // ...\n  const result = timer.cancel(self.handle);\n  if (!result) {\n    print(\"the timer is already cancelled\");\n  }\n}"
     }
   ],
   "timer.delay": [
     {
       "sourceHash": "d50acfc0a9d925a8",
-      "ts": "// A simple one-shot timer\ntimer.delay(1, false, () => print(\"print in one second\"));\n\n// Repetitive timer which canceled after 10 calls\nfunction call_every_second(self, handle, time_elapsed) {\n  self.counter = self.counter + 1;\n  print(\"Call #\", self.counter);\n  if (self.counter === 10) {\n    timer.cancel(handle); // cancel timer after 10 calls\n  }\n}\n\nself.counter = 0;\ntimer.delay(1, true, call_every_second);"
+      "ts": "// A simple one-shot timer\ntimer.delay(1, false, () => print(\"print in one second\"));\n\n// Repetitive timer which canceled after 10 calls\nfunction call_every_second(self: unknown, handle: unknown, time_elapsed: unknown) {\n  const state = self as { counter: number };\n  state.counter = state.counter + 1;\n  print(\"Call #\", state.counter);\n  if (state.counter === 10) {\n    timer.cancel(handle as number); // cancel timer after 10 calls\n  }\n}\n\nfunction start_counting(self: { counter: number }) {\n  self.counter = 0;\n  timer.delay(1, true, call_every_second);\n}"
     }
   ],
   "timer.get_info": [
     {
       "sourceHash": "f2fcacbd1849146e",
-      "ts": "self.handle = timer.delay(1, true, () => print(\"print every second\"));\n// ...\nconst result = timer.get_info(self.handle);\nif (!result) {\n  print(\"the timer is already cancelled or complete\");\n} else {\n  pprint(result); // delay, time_remaining, repeating\n}"
+      "ts": "function report_ticking(self: { handle: number }) {\n  self.handle = timer.delay(1, true, () => print(\"print every second\"));\n  // ...\n  const result = timer.get_info(self.handle);\n  if (!result) {\n    print(\"the timer is already cancelled or complete\");\n  } else {\n    pprint(result); // delay, time_remaining, repeating\n  }\n}"
     }
   ],
   "timer.trigger": [
     {
       "sourceHash": "3d4814c0a3380acf",
-      "ts": "self.handle = timer.delay(1, true, () => print(\"print every second or manually by timer.trigger\"));\n// ...\nconst result = timer.trigger(self.handle);\nif (!result) {\n  print(\"the timer is already cancelled or complete\");\n}"
+      "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 result = timer.trigger(self.handle);\n  if (!result) {\n    print(\"the timer is already cancelled or complete\");\n  }\n}"
     }
   ],
   "update": [
@@ -1694,7 +1870,7 @@
   "vmath.dot": [
     {
       "sourceHash": "4f4a1c2d340af81b",
-      "ts": "if (vmath.dot(vector1, vector2) === 0) {\n  // The two vectors are perpendicular (at right-angles to each other)\n  // ...\n}"
+      "ts": "const vector1 = vmath.vector3(1, 0, 0);\nconst vector2 = vmath.vector3(0, 1, 0);\n\nif (vmath.dot(vector1, vector2) === 0) {\n  // The two vectors are perpendicular (at right-angles to each other)\n  // ...\n}"
     }
   ],
   "vmath.euler_to_quat": [
@@ -1712,13 +1888,13 @@
   "vmath.length": [
     {
       "sourceHash": "740d91676dd23d10",
-      "ts": "if (vmath.length(self.velocity) < max_velocity) {\n  // The speed (velocity vector) is below max.\n\n  // TODO: max_velocity can be expressed as squared\n  // so we can compare with length_sqr() instead.\n  // ...\n}"
+      "ts": "function below_max_speed(self: { velocity: Vector3 }, max_velocity: number) {\n  if (vmath.length(self.velocity) < max_velocity) {\n    // The speed (velocity vector) is below max.\n\n    // TODO: max_velocity can be expressed as squared\n    // so we can compare with length_sqr() instead.\n    // ...\n  }\n}"
     }
   ],
   "vmath.length_sqr": [
     {
       "sourceHash": "221e411fbcc2c4f8",
-      "ts": "if (vmath.length_sqr(vector1) < vmath.length_sqr(vector2)) {\n  // Vector 1 has less magnitude than vector 2\n  // ...\n}"
+      "ts": "const vector1 = vmath.vector3(1, 0, 0);\nconst vector2 = vmath.vector3(0, 2, 0);\n\nif (vmath.length_sqr(vector1) < vmath.length_sqr(vector2)) {\n  // Vector 1 has less magnitude than vector 2\n  // ...\n}"
     }
   ],
   "vmath.lerp": [
@@ -1828,7 +2004,7 @@
   "vmath.mul_per_elem": [
     {
       "sourceHash": "49995280c8b8dc5a",
-      "ts": "const blend_color = vmath.mul_per_elem(color1, color2);"
+      "ts": "const color1 = vmath.vector4(1, 0.5, 0.5, 1);\nconst color2 = vmath.vector4(0.5, 1, 0.5, 1);\nconst blend_color = vmath.mul_per_elem(color1, color2);"
     }
   ],
   "vmath.normalize": [
@@ -1966,7 +2142,7 @@
   "window.set_listener": [
     {
       "sourceHash": "5075cb14faa9510b",
-      "ts": "function window_callback(self, event, data) {\n  if (event === window.WINDOW_EVENT_FOCUS_LOST) {\n    print(\"window.WINDOW_EVENT_FOCUS_LOST\");\n  } else if (event === window.WINDOW_EVENT_FOCUS_GAINED) {\n    print(\"window.WINDOW_EVENT_FOCUS_GAINED\");\n  } else if (event === window.WINDOW_EVENT_ICONFIED) {\n    print(\"window.WINDOW_EVENT_ICONFIED\");\n  } else if (event === window.WINDOW_EVENT_DEICONIFIED) {\n    print(\"window.WINDOW_EVENT_DEICONIFIED\");\n  } else if (event === window.WINDOW_EVENT_RESIZED) {\n    print(\"Window resized: \", data.width, data.height);\n  }\n}\n\nexport default defineScript({\n  init() {\n    window.set_listener(window_callback);\n  },\n});"
+      "ts": "function window_callback(self: unknown, event: unknown, data: Record<string | number, unknown>) {\n  if (event === window.WINDOW_EVENT_FOCUS_LOST) {\n    print(\"window.WINDOW_EVENT_FOCUS_LOST\");\n  } else if (event === window.WINDOW_EVENT_FOCUS_GAINED) {\n    print(\"window.WINDOW_EVENT_FOCUS_GAINED\");\n  } else if (event === window.WINDOW_EVENT_ICONFIED) {\n    print(\"window.WINDOW_EVENT_ICONFIED\");\n  } else if (event === window.WINDOW_EVENT_DEICONIFIED) {\n    print(\"window.WINDOW_EVENT_DEICONIFIED\");\n  } else if (event === window.WINDOW_EVENT_RESIZED) {\n    print(\"Window resized: \", data.width, data.height);\n  }\n}\n\nexport default defineScript({\n  init() {\n    window.set_listener(window_callback);\n  },\n});"
     }
   ],
   "zlib.deflate": [