@defold-typescript/types 0.40.0 → 0.41.0

package/examples/translations.json

@@ -14,13 +14,13 @@
   "b2d.fixture.set_shape": [
     {
       "sourceHash": "ff836b80569f5d30",
-      "ts": "const body = b2d.get_body(\"#collisionobject\");\nif (body !== undefined) {\n  const circle = b2d.fixture.get_shape(body, 1);\n  circle.center = vmath.vector3(24, 0, 0);\n  b2d.fixture.set_shape(body, 1, circle, true);\n  b2d.fixture.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_EDGE, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });\n}"
+      "ts": "const body = b2d.get_body(\"#collisionobject\");\nif (body !== undefined) {\n  const circle = b2d.fixture.get_shape(body, 1);\n  const radius = \"radius\" in circle ? circle.radius : undefined;\n  b2d.fixture.set_shape(body, 1, { type: b2d.shape.SHAPE_TYPE_CIRCLE, radius: radius ?? 16, center: vmath.vector3(24, 0, 0) }, true);\n  b2d.fixture.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_EDGE, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });\n}"
     }
   ],
   "b2d.shape.set_shape": [
     {
       "sourceHash": "f31970e9ebb8d446",
-      "ts": "const body = b2d.get_body(\"#collisionobject\");\nif (body !== undefined) {\n  const circle = b2d.shape.get_shape(body, 1);\n  circle.center = vmath.vector3(24, 0, 0);\n  b2d.shape.set_shape(body, 1, circle, true);\n  b2d.shape.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_SEGMENT, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });\n}"
+      "ts": "const body = b2d.get_body(\"#collisionobject\");\nif (body !== undefined) {\n  const circle = b2d.shape.get_shape(body, 1);\n  const radius = \"radius\" in circle ? circle.radius : undefined;\n  b2d.shape.set_shape(body, 1, { type: b2d.shape.SHAPE_TYPE_CIRCLE, radius: radius ?? 16, center: vmath.vector3(24, 0, 0) }, true);\n  b2d.shape.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_SEGMENT, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });\n}"
     }
   ],
   "buffer.copy_buffer": [
@@ -53,6 +53,102 @@
       "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);"
     }
   ],
+  "bullet3d.collision_object.get_shapes": [
+    {
+      "sourceHash": "253c074f6a45c615",
+      "ts": "// Enumerate the logical shapes attached to a collision object:\nexport default defineScript({\n  init() {\n    const object = bullet3d.get_collision_object(\"#collisionobject\");\n    if (object === undefined) return;\n    for (const shape of bullet3d.collision_object.get_shapes(object)) {\n      const index = bullet3d.shape.get_index(shape);\n      const data = bullet3d.shape.get_shape(shape);\n      print(\"shape\", index, \"type\", data.type);\n    }\n  },\n});"
+    }
+  ],
+  "bullet3d.collision_object.set_ccd_motion_threshold": [
+    {
+      "sourceHash": "0969c6cba121a215",
+      "ts": "// Enable continuous collision detection for a small, fast-moving body:\nexport default defineScript({\n  init() {\n    const body = bullet3d.get_rigid_body(\"#collisionobject\");\n    if (body === undefined) return;\n    bullet3d.collision_object.set_ccd_swept_sphere_radius(body, 0.25);\n    bullet3d.collision_object.set_ccd_motion_threshold(body, 0.5);\n  },\n});"
+    }
+  ],
+  "bullet3d.collision_object.set_world_transform": [
+    {
+      "sourceHash": "23d7b59707855f9f",
+      "ts": "// Move a collision object while preserving its rotation:\nexport default defineScript({\n  init() {\n    const object = bullet3d.get_collision_object(\"#collisionobject\");\n    if (object === undefined) return;\n    const [position, rotation] = bullet3d.collision_object.get_world_transform(object);\n    bullet3d.collision_object.set_world_transform(object, position.add(vmath.vector3(0, 5, 0)), rotation);\n    bullet3d.collision_object.activate(object, true);\n  },\n});"
+    }
+  ],
+  "bullet3d.constraint.create_generic_6dof_spring": [
+    {
+      "sourceHash": "208db6534df9ca4a",
+      "ts": "// Create a spring that moves along its first linear axis:\nexport default defineScript({\n  init() {\n    const body_a = bullet3d.get_rigid_body(\"/body_a#collisionobject\");\n    const body_b = bullet3d.get_rigid_body(\"/body_b#collisionobject\");\n    let spring: bullet3d.constraint.btTypedConstraint | undefined;\n    if (body_a !== undefined && body_b !== undefined) {\n      spring = bullet3d.constraint.create_generic_6dof_spring(body_a, body_b, {\n        frame_a_position: vmath.vector3(),\n        frame_a_rotation: vmath.quat(),\n        frame_b_position: vmath.vector3(),\n        frame_b_rotation: vmath.quat(),\n      });\n      bullet3d.constraint.set_limit(spring, 1, -1, 1);\n      bullet3d.constraint.enable_spring(spring, 1, true);\n      bullet3d.constraint.set_spring_stiffness(spring, 1, 20);\n      bullet3d.constraint.set_spring_damping(spring, 1, 0.5);\n      bullet3d.constraint.set_spring_equilibrium_point(spring, 1, 0);\n    }\n    return { spring };\n  },\n\n  final(self) {\n    if (self.spring !== undefined && bullet3d.constraint.is_valid(self.spring)) {\n      bullet3d.constraint.destroy(self.spring);\n    }\n  },\n});"
+    }
+  ],
+  "bullet3d.constraint.create_hinge": [
+    {
+      "sourceHash": "76ffd570e08f0b18",
+      "ts": "// Create a motorized hinge with a 90-degree range:\nexport default defineScript({\n  init() {\n    const body_a = bullet3d.get_rigid_body(\"/door#collisionobject\");\n    const body_b = bullet3d.get_rigid_body(\"/frame#collisionobject\");\n    let hinge: bullet3d.constraint.btTypedConstraint | undefined;\n    if (body_a !== undefined) {\n      hinge = bullet3d.constraint.create_hinge(body_a, body_b, {\n        frame_a_position: vmath.vector3(-0.5, 0, 0),\n        frame_a_rotation: vmath.quat(),\n        frame_b_position: vmath.vector3(0.5, 0, 0),\n        frame_b_rotation: vmath.quat(),\n      });\n      bullet3d.constraint.set_hinge_limits(hinge, -math.pi / 4, math.pi / 4);\n      bullet3d.constraint.set_hinge_motor(hinge, true, 1.5, 2.5);\n    }\n    return { hinge };\n  },\n\n  final(self) {\n    if (self.hinge !== undefined && bullet3d.constraint.is_valid(self.hinge)) {\n      bullet3d.constraint.destroy(self.hinge);\n    }\n  },\n});"
+    }
+  ],
+  "bullet3d.constraint.create_point_to_point": [
+    {
+      "sourceHash": "91bc34d28899d0c1",
+      "ts": "// Join two bodies at matching local pivots and explicitly destroy the\n// constraint when the script is finalized:\nexport default defineScript({\n  init() {\n    const body_a = bullet3d.get_rigid_body(\"/body_a#collisionobject\");\n    const body_b = bullet3d.get_rigid_body(\"/body_b#collisionobject\");\n    let constraint: bullet3d.constraint.btTypedConstraint | undefined;\n    if (body_a !== undefined) {\n      constraint = bullet3d.constraint.create_point_to_point(body_a, body_b, {\n        pivot_a: vmath.vector3(0.5, 0, 0),\n        pivot_b: vmath.vector3(-0.5, 0, 0),\n      });\n    }\n    return { constraint };\n  },\n\n  final(self) {\n    if (self.constraint !== undefined && bullet3d.constraint.is_valid(self.constraint)) {\n      bullet3d.constraint.destroy(self.constraint);\n    }\n  },\n});"
+    }
+  ],
+  "bullet3d.get_rigid_body": [
+    {
+      "sourceHash": "e09c75e81d50dd6c",
+      "ts": "const world = bullet3d.get_world();\nconst body = bullet3d.get_rigid_body(\"#collisionobject\");\nif (world !== undefined && body !== undefined && bullet3d.rigid_body.is_valid(body)) {\n  bullet3d.rigid_body.apply_central_impulse(body, vmath.vector3(0, 10, 0));\n}\n\n// A trigger is a collision object, not a rigid body.\nconst trigger = bullet3d.get_collision_object(\"#trigger\");\nassert(trigger !== undefined && bullet3d.get_rigid_body(\"#trigger\") === undefined);"
+    }
+  ],
+  "bullet3d.rigid_body.apply_force": [
+    {
+      "sourceHash": "9f7182e8b1f12712",
+      "ts": "// Apply an upward force at the game object's current world position:\nexport default defineScript({\n  init() {\n    const body = bullet3d.get_rigid_body(\"#collisionobject\");\n    if (body === undefined) return;\n    const force = vmath.vector3(0, 100, 0);\n    bullet3d.rigid_body.apply_force(body, force, go.get_world_position());\n  },\n});"
+    }
+  ],
+  "bullet3d.rigid_body.set_gravity": [
+    {
+      "sourceHash": "c790938f15458c40",
+      "ts": "// Give one body persistent custom gravity without discarding its other flags:\nexport default defineScript({\n  init() {\n    const body = bullet3d.get_rigid_body(\"#collisionobject\");\n    if (body === undefined) return;\n    let flags = bullet3d.rigid_body.get_flags(body);\n    flags = bit.bor(flags, bullet3d.rigid_body.BT_DISABLE_WORLD_GRAVITY);\n    bullet3d.rigid_body.set_flags(body, flags);\n    bullet3d.rigid_body.set_gravity(body, vmath.vector3(0, 4, 0));\n  },\n});"
+    }
+  ],
+  "bullet3d.rigid_body.set_mass": [
+    {
+      "sourceHash": "6f1ffcb5da18e9db",
+      "ts": "// Change the mass of a dynamic collision object and inspect its recalculated inertia:\nexport default defineScript({\n  init() {\n    const body = bullet3d.get_rigid_body(\"#collisionobject\");\n    if (body === undefined) return;\n    bullet3d.rigid_body.set_mass(body, 5);\n    print(\"local inertia\", bullet3d.rigid_body.get_local_inertia(body));\n  },\n});"
+    }
+  ],
+  "bullet3d.shape.set_shape": [
+    {
+      "sourceHash": "822278c5e2152e23",
+      "ts": "// Increase the dimensions of the first box shape by 50 percent for this instance:\nexport default defineScript({\n  init() {\n    const object = bullet3d.get_collision_object(\"#collisionobject\");\n    if (object === undefined) return;\n    const shape = bullet3d.collision_object.get_shape(object, 1);\n    const data = bullet3d.shape.get_shape(shape);\n\n    if (data.type === bullet3d.shape.SHAPE_TYPE_BOX && \"dimensions\" in data) {\n      data.dimensions = data.dimensions.mul(1.5);\n      bullet3d.shape.set_shape(shape, data);\n    }\n  },\n});"
+    }
+  ],
+  "bullet3d.world.cast_ray_async": [
+    {
+      "sourceHash": "bcd124b063567325",
+      "ts": "// Queue a downward cast and inspect only the closest non-trigger hit:\nconst world = bullet3d.get_world();\nif (world !== undefined) {\n  bullet3d.world.cast_ray_async(\n    world,\n    go.get_world_position(),\n    vmath.vector3(0, -100, 0),\n    (self, hits) => {\n      const hit = hits[0];\n      if (hit !== undefined) {\n        print(\"hit\", hit.object);\n      }\n    },\n    { include_triggers: false },\n    1,\n  );\n}"
+    }
+  ],
+  "bullet3d.world.cast_ray_closest": [
+    {
+      "sourceHash": "e0695680d5f69806",
+      "ts": "// Cast downward and report the closest non-trigger hit:\nexport default defineScript({\n  init() {\n    const world = bullet3d.get_world();\n    if (world === undefined) return;\n    const origin = go.get_world_position();\n    const translation = vmath.vector3(0, -100, 0);\n    const filter = { include_triggers: false };\n\n    const hit = bullet3d.world.cast_ray_closest(world, origin, translation, filter);\n    if (hit !== undefined) {\n      const distance = vmath.length(translation) * hit.fraction;\n      print(\"hit\", hit.object, \"after\", distance, \"units\");\n    }\n  },\n});"
+    }
+  ],
+  "bullet3d.world.contact_test": [
+    {
+      "sourceHash": "24e4e290d62e54f3",
+      "ts": "// Inspect current contacts for this collision object:\nexport default defineScript({\n  update(self, dt) {\n    const world = bullet3d.get_world();\n    const object = bullet3d.get_collision_object(\"#collisionobject\");\n    if (world === undefined || object === undefined) return;\n    const filter = { include_triggers: false };\n    const contacts = bullet3d.world.contact_test(world, object, filter);\n\n    for (const contact of contacts) {\n      if (contact.distance < 0) {\n        print(\"penetration\", -contact.distance, \"against\", contact.object_b);\n      }\n    }\n  },\n});"
+    }
+  ],
+  "bullet3d.world.overlap_shape": [
+    {
+      "sourceHash": "2b15e4c9166eeb30",
+      "ts": "// Find non-trigger objects overlapping a two-unit sphere around this game object:\nexport default defineScript({\n  init() {\n    const world = bullet3d.get_world();\n    if (world === undefined) return;\n    const shape = {\n      type: bullet3d.shape.SHAPE_TYPE_SPHERE,\n      diameter: 2,\n      position: go.get_world_position(),\n    };\n    const filter = { include_triggers: false };\n    const overlaps = bullet3d.world.overlap_shape(world, shape, filter);\n\n    for (const object of overlaps) {\n      print(\"overlap\", object);\n    }\n  },\n});"
+    }
+  ],
+  "bullet3d.world.set_gravity": [
+    {
+      "sourceHash": "d97b405b0c249b8c",
+      "ts": "// Set gravity for the current collection's physics world:\nexport default defineScript({\n  init() {\n    const world = bullet3d.get_world();\n    if (world !== undefined) {\n      bullet3d.world.set_gravity(world, vmath.vector3(0, -9.81, 0));\n    }\n  },\n});"
+    }
+  ],
   "camera.get_cameras": [
     {
       "sourceHash": "d332d9320898b958",
@@ -79,8 +175,12 @@
   ],
   "collectionfactory.create": [
     {
-      "sourceHash": "5a49721288808772",
-      "ts": "// How to spawn a collection of game objects:\nexport default defineScript({\n  init() {\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 = new LuaMap<Hash, Record<string, unknown>>();\n    props.set(hash(\"/enemy_leader\"), { health: 1000.0 });\n    props.set(hash(\"/enemy_1\"), { health: 200.0 });\n    props.set(hash(\"/enemy_2\"), { health: 400.0, color: hash(\"green\") });\n\n    const 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 = enemy_ids.get(hash(\"/enemy_leader\"));\n    if (leader_id !== undefined) {\n      msg.post(leader_id, \"attack\");\n    }\n    return { enemy_ids };\n  },\n});\n\n// How to delete a spawned collection:\nfunction delete_enemies(self: { enemy_ids: Hash[] }) {\n  go.delete(self.enemy_ids);\n}"
+      "sourceHash": "1ba3a94b5d04c5a0",
+      "ts": "export default defineScript({\n  init() {\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 = new LuaMap<Hash, Record<string, unknown>>();\n    props.set(hash(\"/enemy_leader\"), { health: 1000.0 });\n    props.set(hash(\"/enemy_1\"), { health: 200.0 });\n    props.set(hash(\"/enemy_2\"), { health: 400.0, color: hash(\"green\") });\n\n    const 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 = enemy_ids.get(hash(\"/enemy_leader\"));\n    if (leader_id !== undefined) {\n      msg.post(leader_id, \"attack\");\n    }\n    return { enemy_ids };\n  },\n});"
+    },
+    {
+      "sourceHash": "4a14456855350b8c",
+      "ts": "function delete_enemies(self: { enemy_ids: Hash[] }) {\n  go.delete(self.enemy_ids);\n}"
     }
   ],
   "collectionfactory.load": [
@@ -157,8 +257,16 @@
   ],
   "editor.bob": [
     {
-      "sourceHash": "3d4699538f2b8207",
-      "ts": "// Print help in the console:\neditor.bob({ help: true });\n\n// Bundle the game for the host platform:\nconst opts = { archive: true, platform: editor.platform };\neditor.bob(opts, \"distclean\", \"resolve\", \"build\", \"bundle\");\n\n// Using snake_cased and repeated options:\nconst bundleOpts = {\n  archive: true,\n  platform: editor.platform,\n  build_server: \"https://build.my-company.com\",\n  settings: [\"test.ini\", \"headless.ini\"],\n};\neditor.bob(bundleOpts, \"distclean\", \"resolve\", \"build\");"
+      "sourceHash": "2d2af2a8d67e6042",
+      "ts": "editor.bob({ help: true });"
+    },
+    {
+      "sourceHash": "daf12f556b1915ae",
+      "ts": "const opts = { archive: true, platform: editor.platform };\neditor.bob(opts, \"distclean\", \"resolve\", \"build\", \"bundle\");"
+    },
+    {
+      "sourceHash": "9e755fcbee26e790",
+      "ts": "const opts = {\n  archive: true,\n  platform: editor.platform,\n  build_server: \"https://build.my-company.com\",\n  settings: [\"test.ini\", \"headless.ini\"],\n};\neditor.bob(opts, \"distclean\", \"resolve\", \"build\");"
     }
   ],
   "editor.command": [
@@ -175,8 +283,16 @@
   ],
   "editor.create_resources": [
     {
-      "sourceHash": "b650f0d98eccb0fd",
-      "ts": "// Create a single resource from template:\neditor.create_resources([\"/npc.go\"]);\n\n// Create multiple resources:\neditor.create_resources([\"/npc.go\", \"/levels/1.collection\", \"/levels/2.collection\"]);\n\n// Create a resource with custom content:\neditor.create_resources([[\"/npc.script\", \"go.property('hp', 100)\"]]);"
+      "sourceHash": "dd9b866b84f9de49",
+      "ts": "editor.create_resources([\"/npc.go\"]);"
+    },
+    {
+      "sourceHash": "86faf70ca56cf8a6",
+      "ts": "editor.create_resources([\"/npc.go\", \"/levels/1.collection\", \"/levels/2.collection\"]);"
+    },
+    {
+      "sourceHash": "f29c4cbd5eb7bb65",
+      "ts": "editor.create_resources([{ 1: \"/npc.script\", 2: \"go.property('hp', 100)\" }]);"
     }
   ],
   "editor.delete_directory": [
@@ -187,14 +303,18 @@
   ],
   "editor.execute": [
     {
-      "sourceHash": "b22ea40a2a3595b2",
-      "ts": "// Make a directory with spaces in it:\neditor.execute(\"mkdir\", \"new dir\");\n\n// Read the git status:\nconst status = editor.execute(\"git\", \"status\", \"--porcelain\", {\n  reload_resources: false,\n  out: \"capture\",\n});"
+      "sourceHash": "d5e0db47ebda0546",
+      "ts": "editor.execute(\"mkdir\", \"new dir\");"
+    },
+    {
+      "sourceHash": "5044e4584bab1ea9",
+      "ts": "const status = editor.execute(\"git\", \"status\", \"--porcelain\", {\n  reload_resources: false,\n  out: \"capture\",\n});"
     }
   ],
   "editor.ui.use_memo": [
     {
       "sourceHash": "dac97ede337c4f69",
-      "ts": "function increment(n: unknown): number {\n  return (n as number) + 1;\n}\n\nfunction makeListener(setCount: unknown) {\n  return () => {\n    (setCount as (update: unknown) => unknown)(increment);\n  };\n}\n\nconst counterButton = editor.ui.component((props) => {\n  const [count, setCount] = editor.ui.use_state((props as { count: unknown }).count);\n  const onPressed = editor.ui.use_memo(makeListener, setCount);\n  return editor.ui.button({\n    text: tostring(count),\n    on_pressed: onPressed,\n  });\n});"
+      "ts": "function increment(n: unknown): number {\n  return (n as number) + 1;\n}\n\nfunction makeListener(setCount: unknown) {\n  return () => {\n    (setCount as (update: unknown) => unknown)(increment);\n  };\n}\n\nconst counterButton = editor.ui.component((props) => {\n  const [count, setCount] = editor.ui.use_state((props as { count: unknown }).count);\n  const onPressed = editor.ui.use_memo(makeListener, setCount) as () => void;\n  return editor.ui.button({\n    text: tostring(count),\n    on_pressed: onPressed,\n  });\n});"
     }
   ],
   "editor.ui.use_state": [
@@ -205,8 +325,12 @@
   ],
   "factory.create": [
     {
-      "sourceHash": "d2cd2037a9127ec6",
-      "ts": "// How to create a new game object:\nexport default defineScript({\n  init(self) {\n    // create a new game object and provide property values\n    const created = factory.create(\"#factory\", undefined, undefined, { my_value: 1 });\n    // communicate with the object\n    msg.post(created, \"hello\");\n  },\n});\n\n// And then let the new game object have a script attached, in its own file:\n//\n//   go.property(\"my_value\", 0);\n//\n//   export default defineScript({\n//     init(self) {\n//       // do something with self.my_value which is now one\n//     },\n//   });"
+      "sourceHash": "df32ef57d1e2366e",
+      "ts": "export default defineScript({\n  init(self) {\n    // create a new game object and provide property values\n    const created = factory.create(\"#factory\", undefined, undefined, { my_value: 1 });\n    // communicate with the object\n    msg.post(created, \"hello\");\n  },\n});"
+    },
+    {
+      "sourceHash": "981a4891837250a9",
+      "ts": "go.property(\"my_value\", 0);\n\nexport default defineScript({\n  init(self) {\n    // do something with self.my_value which is now one\n  },\n});"
     }
   ],
   "factory.load": [
@@ -251,6 +375,12 @@
       "ts": "const font_hash = hash(\"/assets/fonts/roboto.fontc\");\nconst ttf_hash = hash(\"/assets/fonts/Roboto/Roboto-Bold.ttf\");\nfont.remove_font(font_hash, ttf_hash);"
     }
   ],
+  "font.set_style": [
+    {
+      "sourceHash": "ec2d9af51ad582c9",
+      "ts": "font.set_style(\"/fonts/ui.fontc\", \"link:hover\", \"<color=#66b3ff><outline color=#000000 size=1><shake amplitude=0.2>\");"
+    }
+  ],
   "go.animate": [
     {
       "sourceHash": "c4fc72e0b8812778",
@@ -297,8 +427,36 @@
   ],
   "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):\nconst url = msg.url(\"#mesh\");\ngo.get(url, \"example\", { index: 0 }); // the first vector4 in the array: example[0]\ngo.get(url, \"example\", { index: 15 }); // the last vector4 in the array: example[15]\ngo.get(url, \"example.x\", { index: 0 }); // 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\"] });"
+      "sourceHash": "bf6bc560db059a69",
+      "ts": "go.property(\"speed\", 50);"
+    },
+    {
+      "sourceHash": "6c13a2e33f4f0c98",
+      "ts": "const speed = go.get(\"#player\", \"speed\");"
+    },
+    {
+      "sourceHash": "decf402c4b246359",
+      "ts": "// 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"
+    },
+    {
+      "sourceHash": "cd59aaeb4278cdfc",
+      "ts": "const url = msg.url(\"#mesh\");\ngo.get(url, \"example\"); // => [vector4, vector4, ...]\ngo.get(url, \"example.x\"); // => [number1, number2, ...]"
+    },
+    {
+      "sourceHash": "4b5cae0c647b3381",
+      "ts": "// get the resource of a certain gui font\nconst font_hash = go.get(\"#gui\", \"fonts\", { key: \"system_font_BIG\" });"
+    },
+    {
+      "sourceHash": "ecf8c97d1bcaf7d3",
+      "ts": "// Addressing the first level of a component:\ngo.get(\"#particlefx\", \"material\", { keys: [\"cone_emitter\"] });"
+    },
+    {
+      "sourceHash": "df724fc6773a584b",
+      "ts": "// Note: no built-in component supports this yet, but a custom one could.\ngo.get(\"#my_component\", \"some_property\", { keys: [\"root\", \"child_node\"] });"
+    },
+    {
+      "sourceHash": "3ba93bc03f7948cc",
+      "ts": "const url = msg.url(\"#mesh\");\n// get all vector4's in the constant array\ngo.get(url, \"example\"); // => [vector4, vector4, ...]\n// get all elements of the vector4's from an array\ngo.get(url, \"example.x\"); // => [number1, number2, ...]"
     }
   ],
   "go.get_id": [
@@ -411,12 +569,48 @@
     {
       "sourceHash": "96e6079cda36fa54",
       "ts": "// This example defines a property \"health\" in a script. The health is decreased\n// whenever someone sends a \"take_damage\" message to the script.\n\n// The payload of your own message id, declared once for the whole program\n// (usually in a .d.ts of its own).\ndeclare global {\n  interface CustomMessages {\n    take_damage: { damage: number };\n  }\n}\n\nexport default defineScript({\n  // Never call `go.property` yourself: the transpiler emits the chunk-scope\n  // `go.property(\"health\", 100)` registration from this field, and only this\n  // field types the property onto `self`.\n  properties: { health: 100 },\n\n  init(self) {\n    // prints 100 to the output\n    print(self.health);\n  },\n\n  on_message(self, message_id, message) {\n    if (isMessage(message_id, message, \"take_damage\")) {\n      self.health = self.health - message.damage;\n      print(`Ouch! My health is now: ${self.health}`);\n    }\n  },\n});"
+    },
+    {
+      "sourceHash": "94d9f68e3db7056c",
+      "ts": "// This example defines a property \"health\" in a script. The health is decreased\n// whenever someone sends a \"take_damage\" message to the script.\n\n// The payload of your own message id, declared once for the whole program\n// (usually in a .d.ts of its own).\ndeclare global {\n  interface CustomMessages {\n    take_damage: { damage: number };\n  }\n}\n\nexport default defineScript({\n  // Never call `go.property` yourself: the transpiler emits the chunk-scope\n  // `go.property(\"health\", 100)` registration from this field, and only this\n  // field types the property onto `self`.\n  properties: { health: 100 },\n\n  init(self) {\n    // prints 100 to the output\n    print(self.health);\n  },\n\n  on_message(self, message_id, message) {\n    if (isMessage(message_id, message, \"take_damage\")) {\n      self.health = self.health - message.damage;\n      print(`Ouch! My health is now: ${self.health}`);\n    }\n  },\n});"
+    },
+    {
+      "sourceHash": "a56e7919856fdf57",
+      "ts": "// Text properties can contain UTF-8 and newline characters:\nexport default defineScript({\n  // Never call `go.property` yourself: the transpiler emits the chunk-scope\n  // registrations from this field, and only this field types them onto `self`.\n  properties: { player_name: \"Player One\", dialogue: \"First line\\nSecond line\" },\n});"
     }
   ],
   "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):\nconst url = msg.url(\"#mesh\");\ngo.set(url, \"example\", vmath.vector4(1, 1, 1, 1), { index: 0 }); // example[0] = v\ngo.set(url, \"example\", vmath.vector4(2, 2, 2, 2), { index: 15 }); // example[15] = v\ngo.set(url, \"example.x\", 7, { index: 0 }); // 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\"] });"
+      "sourceHash": "bf6bc560db059a69",
+      "ts": "go.property(\"speed\", 50);"
+    },
+    {
+      "sourceHash": "dcb0970a052d80a0",
+      "ts": "go.set(\"#player\", \"speed\", 100);"
+    },
+    {
+      "sourceHash": "150af4281adacf42",
+      "ts": "// 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"
+    },
+    {
+      "sourceHash": "fb7b5aefbb9fad4b",
+      "ts": "// set the first two vector4's in the array\n// if the array has more than two elements in the array they will not be set\nconst url = msg.url(\"#mesh\");\ngo.set(url, \"example\", [vmath.vector4(1, 1, 1, 1), vmath.vector4(2, 2, 2, 2)]);"
+    },
+    {
+      "sourceHash": "ea5b1b6430458d24",
+      "ts": "go.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}"
+    },
+    {
+      "sourceHash": "bb73335ad4c5f1fe",
+      "ts": "go.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}"
+    },
+    {
+      "sourceHash": "2a68fe57bedcd5c1",
+      "ts": "// 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\"] });"
+    },
+    {
+      "sourceHash": "54eab9a4ddd280ac",
+      "ts": "go.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}"
     }
   ],
   "go.set_parent": [
@@ -511,8 +705,12 @@
   ],
   "gui.cancel_animations": [
     {
-      "sourceHash": "ac678b79b816b54d",
-      "ts": "// Start an animation of the position property of a node, then cancel parts of\n// the animation:\nconst node = gui.get_node(\"my_node\");\n// animate to new position\nconst pos = vmath.vector3(100, 100, 0);\ngui.animate(node, \"position\", pos, gui.EASING_LINEAR, 2);\n// ...\n// cancel animation of the x component.\ngui.cancel_animations(node, \"position.x\");\n\n// Cancels all property animations on a node in a single call:\n// animate to new position and scale\ngui.animate(node, \"position\", vmath.vector3(100, 100, 0), gui.EASING_LINEAR, 5);\ngui.animate(node, \"scale\", vmath.vector3(0.5), gui.EASING_LINEAR, 5);\n// ...\n// cancel positioning and scaling at once\ngui.cancel_animations(node);"
+      "sourceHash": "4887f66e427b7c8e",
+      "ts": "const node = gui.get_node(\"my_node\");\n// animate to new position\nconst pos = vmath.vector3(100, 100, 0);\ngui.animate(node, \"position\", pos, gui.EASING_LINEAR, 2);\n// ...\n// cancel animation of the x component.\ngui.cancel_animations(node, \"position.x\");"
+    },
+    {
+      "sourceHash": "62239db9b4ffcfec",
+      "ts": "const node = gui.get_node(\"my_node\");\n// animate to new position and scale\ngui.animate(node, \"position\", vmath.vector3(100, 100, 0), gui.EASING_LINEAR, 5);\ngui.animate(node, \"scale\", vmath.vector3(0.5), gui.EASING_LINEAR, 5);\n// ...\n// cancel positioning and scaling at once\ngui.cancel_animations(node);"
     }
   ],
   "gui.cancel_flipbook": [
@@ -571,14 +769,22 @@
   ],
   "gui.new_texture": [
     {
-      "sourceHash": "192ba6f4b864704a",
-      "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 [data] = sys.load_resource(path);\nif (data !== undefined) {\n  const n = gui.new_box_node(pos, vmath.vector3(size, size, 0));\n  // size is read from the .astc buffer\n  // flip is not supported\n  gui.new_texture(path, 0, 0, \"astc\", data, false);\n  gui.set_texture(n, path);\n}"
+      "sourceHash": "b649d09aecc014e4",
+      "ts": "export 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});"
+    },
+    {
+      "sourceHash": "3279c780ce37ad44",
+      "ts": "const size = 4;\nconst pos = vmath.vector3(200, 200, 0);\nconst path = \"/assets/images/logo_4x4.astc\";\nconst [data] = sys.load_resource(path);\nif (data !== undefined) {\n  const n = gui.new_box_node(pos, vmath.vector3(size, size, 0));\n  // size is read from the .astc buffer\n  // flip is not supported\n  gui.new_texture(path, 0, 0, \"astc\", data, false);\n  gui.set_texture(n, path);\n}"
     }
   ],
   "gui.play_flipbook": [
     {
-      "sourceHash": "341233e631c23020",
-      "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\");"
+      "sourceHash": "766767de34e4e6a2",
+      "ts": "function 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});"
+    },
+    {
+      "sourceHash": "90aa26229f63af7e",
+      "ts": "// 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": [
@@ -601,12 +807,24 @@
   ],
   "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\") as Vector3;\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]; // TypeScript and the shader are both 0 based\ngui.set(node, \"tint_array\", vmath.vector4(1, 0, 0, 1), { index: 3 });\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: 3 });\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: 3 });\n\n// Set a named property\nexport default defineGuiScript({\n  on_message(self, message_id, message) {\n    if (message_id === hash(\"set_font\") && types.is_hash(message.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\") && types.is_hash(message.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": "0b505e5f92fd4aff",
+      "ts": "const node = gui.get_node(\"my_box_node\");\nconst node_position = gui.get(node, \"position\") as Vector3;\ngui.set(node, \"position.x\", node_position.x + 128);"
     },
     {
-      "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\") as Vector3;\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]; // TypeScript and the shader are both 0 based\ngui.set(node, \"tint_array\", vmath.vector4(1, 0, 0, 1), { index: 3 });\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: 3 });\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: 3 });\n\n// Set a named property\nexport default defineGuiScript({\n  on_message(self, message_id, message) {\n    if (message_id === hash(\"set_font\") && types.is_hash(message.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\") && types.is_hash(message.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});"
+      "sourceHash": "8ed6f5c059ba2496",
+      "ts": "const node = gui.get_node(\"my_box_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));"
+    },
+    {
+      "sourceHash": "2a8317babd507565",
+      "ts": "const node = gui.get_node(\"my_box_node\");\ngui.set(node, \"tint\", vmath.vector4(1, 0, 0, 1));\n// matrix4 is also supported\ngui.set(node, \"light_matrix\", vmath.matrix4());\n// update a constant in an array at position 4. the array is specified in the shader as:\n// uniform vec4 tint_array[4]; // lua is 1 based, shader is 0 based\ngui.set(node, \"tint_array\", vmath.vector4(1, 0, 0, 1), { index: 4 });\n// update a matrix constant in an array at position 4. the array is specified in the shader as:\n// uniform mat4 light_matrix_array[4];\ngui.set(node, \"light_matrix_array\", vmath.matrix4(), { index: 4 });\n// update a sub-element in a constant\ngui.set(node, \"tint.x\", 1);\n// update a sub-element in an array constant at position 4\ngui.set(node, \"tint_array.x\", 1, { index: 4 });"
+    },
+    {
+      "sourceHash": "b52d73e25b02e93f",
+      "ts": "export default defineGuiScript({\n  on_message(self, message_id, message) {\n    if (message_id === hash(\"set_font\") && types.is_hash(message.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\") && types.is_hash(message.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});"
+    },
+    {
+      "sourceHash": "8e2e40668493072c",
+      "ts": "const atlas_params = {\n  texture: \"/runtime.texturec\",\n  animations: [{ id: \"runtime\", width: 1, height: 1, frames: [1] }],\n  geometries: [{ vertices: [0, 0, 0, 1, 1, 1, 1, 0], uvs: [0, 0, 0, 1, 1, 1, 1, 0], indices: [0, 1, 2, 0, 2, 3] }],\n} satisfies Parameters<typeof resource.create_atlas>[1];\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);"
     }
   ],
   "gui.set_id": [
@@ -623,8 +841,12 @@
   ],
   "gui.set_texture": [
     {
-      "sourceHash": "8c3b738f1772c4fa",
-      "ts": "// To set a texture (or animation) from an atlas:\nconst node = gui.get_node(\"box_node\");\ngui.set_texture(node, \"my_atlas\");\ngui.play_flipbook(node, \"image\");\n\n// Set a dynamically created texture to a node. Note that there is only\n// one texture image in this case so gui.set_texture() is sufficient.\nconst w = 200;\nconst h = 300;\n// A nice orange. String with the RGB values.\nconst orange = String.fromCharCode(0xff, 0x80, 0x10);\n// Create the texture. Repeat the color string for each pixel.\nif (gui.new_texture(\"orange_tx\", w, h, \"rgb\", orange.repeat(w * h))) {\n  gui.set_texture(node, \"orange_tx\");\n}"
+      "sourceHash": "27917506578ef40c",
+      "ts": "const node = gui.get_node(\"box_node\");\ngui.set_texture(node, \"my_atlas\");\ngui.play_flipbook(node, \"image\");"
+    },
+    {
+      "sourceHash": "63abf329a2522305",
+      "ts": "const w = 200;\nconst h = 300;\n// A nice orange. String with the RGB values.\nconst orange = String.fromCharCode(0xff, 0x80, 0x10);\n// Create the texture. Repeat the color string for each pixel.\nconst [ok] = gui.new_texture(\"orange_tx\", w, h, \"rgb\", orange.repeat(w * h));\nif (ok) {\n  const node = gui.get_node(\"box_node\");\n  gui.set_texture(node, \"orange_tx\");\n}"
     }
   ],
   "gui.set_texture_data": [
@@ -666,7 +888,7 @@
   "image.load_buffer": [
     {
       "sourceHash": "55649cadc660e25e",
-      "ts": "// Load an image from an URL as a buffer and create a texture resource from it:\nconst imgurl = \"http://www.site.com/image.png\";\nhttp.request(imgurl, \"GET\", (self, id, response) => {\n  const img =\n    response.response !== undefined\n      ? image.load_buffer(response.response, { flip_vertically: true })\n      : undefined;\n  if (img !== undefined) {\n    const tparams = {\n      width: img.width,\n      height: img.height,\n      type: graphics.TEXTURE_TYPE_2D,\n      format: graphics.TEXTURE_FORMAT_RGBA,\n    };\n\n    const my_texture_id = resource.create_texture(\"/my_custom_texture.texturec\", tparams, img.buffer);\n    // Apply the texture to a model\n    go.set(\"/go1#model\", \"texture0\", my_texture_id);\n  }\n});"
+      "ts": "// Load an image from an URL as a buffer and create a texture resource from it:\nconst imgurl = \"http://www.site.com/image.png\";\nhttp.request(imgurl, \"GET\", (self, id, response) => {\n  const img =\n    response.response !== undefined\n      ? image.load_buffer(response.response, { flip_vertically: true })\n      : undefined;\n  // the engine registers a texture format only when the driver supports it\n  const format = graphics.TEXTURE_FORMAT_RGBA;\n  if (img !== undefined && format !== undefined) {\n    const tparams = {\n      width: img.width,\n      height: img.height,\n      type: graphics.TEXTURE_TYPE_2D,\n      format,\n    };\n\n    const my_texture_id = resource.create_texture(\"/my_custom_texture.texturec\", tparams, img.buffer);\n    // Apply the texture to a model\n    go.set(\"/go1#model\", \"texture0\", my_texture_id);\n  }\n});"
     }
   ],
   "init": [
@@ -677,26 +899,48 @@
   ],
   "json.decode": [
     {
-      "sourceHash": "a9970c96ca5954c6",
-      "ts": "// Converting a string containing JSON data into a table:\nexport default defineScript({\n  init() {\n    const jsonstring = '{\"persons\":[{\"name\":\"John Doe\"},{\"name\":\"Darth Vader\"}]}';\n    const data = json.decode(jsonstring);\n    pprint(data);\n  },\n});\n\n// Results in the following printout:\n// {\n//   persons = {\n//     1 = {\n//       name = John Doe,\n//     }\n//     2 = {\n//       name = Darth Vader,\n//     }\n//   }\n// }"
+      "sourceHash": "8dcdd6f81ef65528",
+      "ts": "export default defineScript({\n  init() {\n    const jsonstring = '{\"persons\":[{\"name\":\"John Doe\"},{\"name\":\"Darth Vader\"}]}';\n    const data = json.decode(jsonstring);\n    pprint(data);\n  },\n});"
+    },
+    {
+      "sourceHash": "4cd6b13a31344b55",
+      "ts": "// {\n//   persons = {\n//     1 = {\n//       name = John Doe,\n//     }\n//     2 = {\n//       name = Darth Vader,\n//     }\n//   }\n// }"
     }
   ],
   "json.encode": [
     {
-      "sourceHash": "e87a21865ef89cd4",
-      "ts": "// Convert a table to a JSON string:\nexport default defineScript({\n  init() {\n    const tbl = {\n      persons: [{ name: \"John Doe\" }, { name: \"Darth Vader\" }],\n    };\n    const jsonstring = json.encode(tbl);\n    pprint(jsonstring);\n  },\n});\n\n// Results in the following printout:\n// {\"persons\":[{\"name\":\"John Doe\"},{\"name\":\"Darth Vader\"}]}"
+      "sourceHash": "cd58784a46da5fcb",
+      "ts": "export default defineScript({\n  init() {\n    const tbl = {\n      persons: [{ name: \"John Doe\" }, { name: \"Darth Vader\" }],\n    };\n    const jsonstring = json.encode(tbl);\n    pprint(jsonstring);\n  },\n});"
+    },
+    {
+      "sourceHash": "2bb4b4f7cdbb2f0f",
+      "ts": "// {\"persons\":[{\"name\":\"John Doe\"},{\"name\":\"Darth Vader\"}]}"
+    }
+  ],
+  "label.get_layout_objects": [
+    {
+      "sourceHash": "cb0d030f627da4ea",
+      "ts": "const objects = label.get_layout_objects(\"#label\");\nfor (const object of objects) {\n  if (object.type === \"link\") {\n    print(object.attributes.get(\"src\"), object.text_offset, object.text_length);\n  } else if (object.type === \"sprite\") {\n    print(object.attributes.get(\"src\"), object.x, object.y, object.width, object.height);\n  }\n}"
     }
   ],
   "label.get_text": [
     {
       "sourceHash": "f1c34d0aca8a07d9",
       "ts": "export default defineScript({\n  init(self) {\n    const text = label.get_text(\"#label\");\n    print(text);\n  },\n});"
+    },
+    {
+      "sourceHash": "877de2c1daa19e58",
+      "ts": "export default defineScript({\n  init() {\n    const text = go.get<label.properties>()(\"#label\", \"text\");\n    print(text);\n  },\n});"
     }
   ],
   "label.set_text": [
     {
       "sourceHash": "0d47c9a209b0d646",
       "ts": "export default defineScript({\n  init(self) {\n    label.set_text(\"#label\", \"Hello World!\");\n  },\n});"
+    },
+    {
+      "sourceHash": "2ac0aeb70ccdc6bf",
+      "ts": "export default defineScript({\n  init() {\n    go.set<label.properties>()(\"#label\", \"text\", \"Hello World!\");\n  },\n});"
     }
   ],
   "liveupdate.add_mount": [
@@ -711,12 +955,16 @@
   ],
   "liveupdate.get_mounts": [
     {
-      "sourceHash": "1d7c8369562acce9",
-      "ts": "// Output the current resource mounts\npprint(\"MOUNTS\", liveupdate.get_mounts());\n\n// Give an output like:\n// DEBUG:SCRIPT: MOUNTS,\n// {\n//   1 = {\n//     name = \"liveupdate\",\n//     uri = \"zip:/device/path/to/acchives/liveupdate.zip\",\n//     priority = 5\n//   },\n//   2 = {\n//     name = \"_base\",\n//     uri = \"archive:build/default/game.dmanifest\",\n//     priority = -10\n//   }\n// }"
+      "sourceHash": "5c7eede2122552e2",
+      "ts": "pprint(\"MOUNTS\", liveupdate.get_mounts());"
     },
     {
-      "sourceHash": "f79283b7edf516cf",
-      "ts": "// Output the current resource mounts\npprint(\"MOUNTS\", liveupdate.get_mounts());\n\n// Give an output like:\n// DEBUG:SCRIPT: MOUNTS,\n// {\n//   1 = {\n//     name = \"liveupdate\",\n//     uri = \"zip:/device/path/to/acchives/liveupdate.zip\",\n//     priority = 5\n//   },\n//   2 = {\n//     name = \"_base\",\n//     uri = \"archive:build/default/game.dmanifest\",\n//     priority = -10\n//   }\n// }"
+      "sourceHash": "8f1c19f5a5d6e4b1",
+      "ts": "// DEBUG:SCRIPT: MOUNTS,\n// {\n//   1 = {\n//     name = hash: [liveupdate],\n//     uri = \"zip:/device/path/to/acchives/liveupdate.zip\",\n//     priority = 5\n//   },\n//   2 = {\n//     name = hash: [_base],\n//     uri = \"archive:build/default/game.dmanifest\",\n//     priority = -10\n//   }\n// }"
+    },
+    {
+      "sourceHash": "a93aeb64f6460957",
+      "ts": "// DEBUG:SCRIPT: MOUNTS,\n// {\n//   1 = {\n//     name = \"liveupdate\",\n//     uri = \"zip:/device/path/to/acchives/liveupdate.zip\",\n//     priority = 5\n//   },\n//   2 = {\n//     name = \"_base\",\n//     uri = \"archive:build/default/game.dmanifest\",\n//     priority = -10\n//   }\n// }"
     }
   ],
   "liveupdate.is_built_with_excluded_files": [
@@ -835,8 +1083,12 @@
   ],
   "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 my_url = msg.url(\"my_gameobject#my_script\");\nconst params = { my_parameter: \"my_value\" };\nmsg.post(my_url, \"my_message\", params);"
+      "sourceHash": "3bb511425986efad",
+      "ts": "msg.post(\"my_gameobject#my_sprite\", \"enable\");"
+    },
+    {
+      "sourceHash": "bb0ad09dd9648670",
+      "ts": "const my_url = msg.url(\"my_gameobject#my_script\");\nconst params = { my_parameter: \"my_value\" };\nmsg.post(my_url, \"my_message\", params);"
     }
   ],
   "msg.url": [
@@ -913,10 +1165,28 @@
       "ts": "export default defineScript({\n  init(self) {\n    let gravity = physics.get_gravity();\n    // Inverse gravity!\n    gravity = vmath.vector3(-gravity.x, -gravity.y, -gravity.z);\n    physics.set_gravity(gravity);\n  },\n});"
     }
   ],
+  "physics.get_group": [
+    {
+      "sourceHash": "c8144370669b125f",
+      "ts": "function check_is_enemy(): boolean {\n  const group = physics.get_group(\"#collisionobject\");\n  return group === hash(\"enemy\");\n}"
+    }
+  ],
+  "physics.get_maskbit": [
+    {
+      "sourceHash": "8679181844a752a4",
+      "ts": "function is_invincible(): boolean {\n  // check if the collisionobject would collide with the \"bullet\" group\n  const invincible = physics.get_maskbit(\"#collisionobject\", \"bullet\");\n  return invincible;\n}"
+    }
+  ],
+  "physics.get_shape": [
+    {
+      "sourceHash": "82791cbb5f80661a",
+      "ts": "function get_shape_meta() {\n  const sphere = physics.get_shape(\"#collisionobject\", \"my_sphere_shape\");\n  // returns a table with sphere.diameter\n  return sphere;\n}"
+    }
+  ],
   "physics.raycast": [
     {
       "sourceHash": "3e0c534d741f0120",
-      "ts": "function handle_result(hit: { fraction: number; position: Vector3; normal: Vector3; id: Hash; group: Hash; request_id: number }) {\n  // act on the hit (see 'ray_cast_response')\n}\n\n// How to perform a ray cast synchronously:\nexport default defineScript({\n  init() {\n    return { groups: [hash(\"world\"), hash(\"enemy\")] };\n  },\n\n  update(self, dt) {\n    // request ray cast\n    const from = go.get_world_position();\n    const to = vmath.vector3(from.x, from.y - 100, from.z);\n    const results = physics.raycast(from, to, self.groups, { all: true });\n    if (results !== undefined) {\n      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() {\n    return { groups: [hash(\"world\"), hash(\"enemy\")] };\n  },\n\n  update(self, dt) {\n    // request ray cast\n    const from = go.get_world_position();\n    const to = vmath.vector3(from.x, from.y - 100, from.z);\n    const results = physics.raycast(from, to, self.groups, { all: true });\n    if (results !== undefined) {\n      // with `all` set, the ray cast returns every hit as a list\n      for (const result of Array.isArray(results) ? results : [results]) {\n        handle_result(result);\n      }\n    }\n  },\n});"
     }
   ],
   "physics.raycast_async": [
@@ -941,12 +1211,30 @@
       "ts": "export default defineScript({\n  init(self) {\n    // Set \"upside down\" gravity for this collection.\n    physics.set_gravity(vmath.vector3(0, 10.0, 0));\n  },\n});"
     }
   ],
+  "physics.set_group": [
+    {
+      "sourceHash": "c4125b51c18c0a63",
+      "ts": "function change_collision_group() {\n  physics.set_group(\"#collisionobject\", \"enemy\");\n}"
+    }
+  ],
   "physics.set_hflip": [
     {
       "sourceHash": "71a627e46d2e651e",
       "ts": "export default defineScript({\n  init() {\n    const fliph = true; // set on some condition\n    physics.set_hflip(\"#collisionobject\", fliph);\n    return { fliph };\n  },\n});"
     }
   ],
+  "physics.set_maskbit": [
+    {
+      "sourceHash": "a4b238ed0887509f",
+      "ts": "function make_invincible() {\n  // no longer collide with the \"bullet\" group\n  physics.set_maskbit(\"#collisionobject\", \"bullet\", false);\n}"
+    }
+  ],
+  "physics.set_shape": [
+    {
+      "sourceHash": "12a0293fcc2f7687",
+      "ts": "function set_shape_data() {\n  // set capsule shape data\n  physics.set_shape(\"#collisionobject\", \"my_capsule_shape\", {\n    type: physics.SHAPE_TYPE_CAPSULE,\n    diameter: 10,\n    height: 20,\n  });\n\n  // set sphere shape data\n  physics.set_shape(\"#collisionobject\", \"my_sphere_shape\", {\n    type: physics.SHAPE_TYPE_SPHERE,\n    diameter: 10,\n  });\n\n  // set box shape data\n  physics.set_shape(\"#collisionobject\", \"my_box_shape\", {\n    type: physics.SHAPE_TYPE_BOX,\n    dimensions: vmath.vector3(10, 10, 5),\n  });\n}"
+    }
+  ],
   "physics.set_vflip": [
     {
       "sourceHash": "7b5832955ec6635c",
@@ -959,6 +1247,12 @@
       "ts": "physics.update_mass(\"#collisionobject\", 14);"
     }
   ],
+  "physics.wakeup": [
+    {
+      "sourceHash": "8bda507f7a5248c1",
+      "ts": "export default defineScript({\n  on_input(self, action_id, action) {\n    if (action_id === hash(\"test\") && action.pressed) {\n      physics.wakeup(\"#collisionobject\");\n    }\n  },\n});"
+    }
+  ],
   "profiler.dump_frame": [
     {
       "sourceHash": "54342e4fc710032d",
@@ -1033,8 +1327,20 @@
   ],
   "render.constant_buffer": [
     {
-      "sourceHash": "851cc71b74ec904a",
-      "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});"
+      "sourceHash": "16ded57baadade85",
+      "ts": "const constants = render.constant_buffer();\nconstants.tint = vmath.vector4(1, 1, 1, 1);"
+    },
+    {
+      "sourceHash": "d89056c8f1a576bb",
+      "ts": "function draw_tinted(self: { my_pred: Opaque<\"render_predicate\"> }) {\n  const constants = render.constant_buffer();\n  constants.tint = vmath.vector4(1, 1, 1, 1);\n  render.draw(self.my_pred, { constants });\n}"
+    },
+    {
+      "sourceHash": "2c9cd28e1eb6e610",
+      "ts": "const constants = render.constant_buffer();\nconstants.light_colors = [];\nconstants.light_colors[0] = vmath.vector4(1, 0, 0, 1);\nconstants.light_colors[1] = vmath.vector4(0, 1, 0, 1);\nconstants.light_colors[2] = vmath.vector4(0, 0, 1, 1);"
+    },
+    {
+      "sourceHash": "d1c04a81200daf67",
+      "ts": "const constants = render.constant_buffer();\nconstants.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\nconstants.light_colors[3] = vmath.vector4(1, 1, 1, 1);"
     }
   ],
   "render.delete_render_target": [
@@ -1063,14 +1369,30 @@
   ],
   "render.dispatch_compute": [
     {
-      "sourceHash": "af76607a05354da7",
-      "ts": "export default defineRenderScript({\n  init() {\n    const color_params = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n    };\n    return {\n      backing_texture: resource.get_texture_info(\"/main/backing.texturec\").handle,\n      scene_rt: render.render_target({ [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params }),\n    };\n  },\n\n  update(self, dt) {\n    render.set_compute(\"bloom\");\n    render.enable_texture(0, self.backing_texture);\n    render.enable_texture(1, self.scene_rt);\n    render.dispatch_compute(128, 128, 1);\n    render.set_compute();\n  },\n});\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 });"
+      "sourceHash": "75d02543f0e1f325",
+      "ts": "export default defineRenderScript({\n  init() {\n    const color_params = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n    };\n    return {\n      backing_texture: resource.get_texture_info(\"/main/backing.texturec\").handle,\n      scene_rt: render.render_target({ [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params }),\n    };\n  },\n\n  update(self, dt) {\n    render.set_compute(\"bloom\");\n    render.enable_texture(0, self.backing_texture);\n    render.enable_texture(1, self.scene_rt);\n    render.dispatch_compute(128, 128, 1);\n    render.set_compute();\n  },\n});"
+    },
+    {
+      "sourceHash": "839cd1accd7a318c",
+      "ts": "const 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 defineRenderScript({\n  init() {\n    return {\n      // define a predicate matching anything with material tag \"my_tag\"\n      my_pred: render.predicate([hash(\"my_tag\")]),\n      proj: vmath.matrix4_perspective(math.rad(45), render.get_window_width() / render.get_window_height(), 0.1, 1000),\n      view: vmath.matrix4_look_at(vmath.vector3(0, 0, 10), vmath.vector3(0, 0, 0), vmath.vector3(0, 1, 0)),\n    };\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});"
+      "sourceHash": "5f241f4874a8bc1a",
+      "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});"
+    },
+    {
+      "sourceHash": "50e774f222fef263",
+      "ts": "function draw_tinted(self: { my_pred: Opaque<\"render_predicate\"> }) {\n  const constants = render.constant_buffer();\n  constants.tint = vmath.vector4(1, 1, 1, 1);\n  render.draw(self.my_pred, { constants });\n}"
+    },
+    {
+      "sourceHash": "19aaab03c8a4c8e7",
+      "ts": "function draw_culled(self: { my_pred: Opaque<\"render_predicate\">; proj: Matrix4; view: Matrix4 }) {\n  const frustum = self.proj.mul(self.view);\n  render.draw(self.my_pred, { frustum });\n}"
+    },
+    {
+      "sourceHash": "d1cbea5554766082",
+      "ts": "function draw_culled(self: { my_pred: Opaque<\"render_predicate\">; proj: Matrix4; view: Matrix4 }) {\n  const frustum = self.proj.mul(self.view);\n  render.draw(self.my_pred, { frustum, frustum_planes: render.FRUSTUM_PLANES_ALL });\n}"
     }
   ],
   "render.draw_debug3d": [
@@ -1154,11 +1476,19 @@
     },
     {
       "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      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    // enable target so all drawing is done to it\n    render.set_render_target(self.my_render_target);\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n  },\n});"
+      "ts": "// How to create a render target with multiple outputs:\nexport default defineRenderScript({\n  init() {\n    // render target buffer parameters\n    const color_params_rgba = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    const color_params_float = {\n      format: graphics.TEXTURE_FORMAT_RG32F,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n\n    // the engine registers the extra color attachments only when the driver supports them\n    const color1 = graphics.BUFFER_TYPE_COLOR1_BIT;\n    const color2 = graphics.BUFFER_TYPE_COLOR2_BIT;\n    if (color1 === undefined || color2 === undefined) return undefined;\n\n    // Create a render target with three color attachments\n    // Note: No depth buffer is attached here\n    return {\n      my_render_target: render.render_target({\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params_rgba,\n        [color1]: color_params_rgba,\n        [color2]: color_params_float,\n      }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    if (self === undefined) return;\n    // 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": "e39f13af5d65d01d",
       "ts": "// How to create a render target with multiple outputs:\nexport default defineRenderScript({\n  init() {\n    // render target buffer parameters\n    const color_params_rgba = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    const color_params_float = {\n      format: graphics.TEXTURE_FORMAT_RG32F,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n\n    // Create a render target with three color attachments\n    // Note: No depth buffer is attached here\n    return {\n      my_render_target: render.render_target({\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params_rgba,\n        [graphics.BUFFER_TYPE_COLOR1_BIT]: color_params_rgba,\n        [graphics.BUFFER_TYPE_COLOR2_BIT]: color_params_float,\n      }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    // enable target so all drawing is done to it\n    render.set_render_target(self.my_render_target);\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n  },\n});"
+    },
+    {
+      "sourceHash": "582c319c90bcf7ad",
+      "ts": "export default defineRenderScript({\n  init() {\n    if (graphics.BUFFER_TYPE_COLOR1_BIT === undefined) {\n      // this devices does not support multiple color attachments\n    }\n  },\n});"
+    },
+    {
+      "sourceHash": "eec69c97bf2815ed",
+      "ts": "// How to create a new render target and draw to it:\nexport default defineRenderScript({\n  init() {\n    // render target buffer parameters\n    const color_params = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    const depth_params = {\n      format: graphics.TEXTURE_FORMAT_DEPTH,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    return {\n      my_render_target: render.render_target({\n        sample_count: 4,\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params,\n        [graphics.BUFFER_TYPE_DEPTH_BIT]: depth_params,\n      }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    // enable target so all drawing is done to it\n    render.set_render_target(self.my_render_target);\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n  },\n});"
     }
   ],
   "render.set_blend_equation_separate": [
@@ -1181,8 +1511,12 @@
   ],
   "render.set_camera": [
     {
-      "sourceHash": "6ee012d07a0487a6",
-      "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});"
+      "sourceHash": "b107acc1597639c2",
+      "ts": "function draw_through_camera(self: { my_pred: Opaque<\"render_predicate\"> }) {\n  render.set_camera(\"main:/my_go#camera\");\n  render.draw(self.my_pred);\n  render.set_camera(undefined);\n}"
+    },
+    {
+      "sourceHash": "4fc6efe0ea0a194d",
+      "ts": "function draw_through_camera(self: { my_pred: Opaque<\"render_predicate\"> }) {\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}"
     }
   ],
   "render.set_color_mask": [
@@ -1298,7 +1632,7 @@
   "resource.create_atlas": [
     {
       "sourceHash": "987cf3d09a4ce250",
-      "ts": "// Create a backing texture and an atlas\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    const my_texture_id = resource.create_texture(\"/my_texture.texturec\", tparams);\n\n    // optionally use resource.set_texture to upload data to texture\n\n    // create an atlas with one animation and one square geometry\n    // note that the function doesn't support hashes for the texture,\n    // you need to use a string for the texture path here aswell\n    const aparams = {\n      texture: \"/my_texture.texturec\",\n      animations: [\n        {\n          id: \"my_animation\",\n          width: 128,\n          height: 128,\n          frames: [1],\n        },\n      ],\n      geometries: [\n        {\n          id: \"idle0\",\n          width: 128,\n          height: 128,\n          pivot_x: 0.5,\n          pivot_y: 0.5,\n          vertices: [0, 0, 0, 128, 128, 128, 128, 0],\n          uvs: [0, 0, 0, 128, 128, 128, 128, 0],\n          indices: [0, 1, 2, 0, 2, 3],\n        },\n      ],\n    };\n    const my_atlas_id = resource.create_atlas(\"/my_atlas.texturesetc\", aparams);\n\n    // assign the atlas to the 'sprite' component on the same go\n    go.set(\"#sprite\", \"image\", my_atlas_id);\n  },\n});"
+      "ts": "// Create a backing texture and an atlas\nexport default defineScript({\n  init() {\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGBA;\n    if (format === undefined) return;\n    // create an empty texture\n    const tparams = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format,\n    };\n    const my_texture_id = resource.create_texture(\"/my_texture.texturec\", tparams);\n\n    // optionally use resource.set_texture to upload data to texture\n\n    // create an atlas with one animation and one square geometry\n    // note that the function doesn't support hashes for the texture,\n    // you need to use a string for the texture path here aswell\n    const aparams = {\n      texture: \"/my_texture.texturec\",\n      animations: [\n        {\n          id: \"my_animation\",\n          width: 128,\n          height: 128,\n          frames: [1],\n        },\n      ],\n      geometries: [\n        {\n          id: \"idle0\",\n          width: 128,\n          height: 128,\n          pivot_x: 0.5,\n          pivot_y: 0.5,\n          vertices: [0, 0, 0, 128, 128, 128, 128, 0],\n          uvs: [0, 0, 0, 128, 128, 128, 128, 0],\n          indices: [0, 1, 2, 0, 2, 3],\n        },\n      ],\n    } satisfies Parameters<typeof resource.create_atlas>[1];\n    const my_atlas_id = resource.create_atlas(\"/my_atlas.texturesetc\", aparams);\n\n    // assign the atlas to the 'sprite' component on the same go\n    go.set(\"#sprite\", \"image\", my_atlas_id);\n  },\n});"
     }
   ],
   "resource.create_buffer": [
@@ -1320,23 +1654,39 @@
   "resource.create_texture": [
     {
       "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});"
+      "ts": "// How to create an 128x128 RGBA texture resource and assign it to a model\nexport default defineScript({\n  init() {\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGBA;\n    if (format === undefined) return;\n    const tparams = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format,\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});"
+      "ts": "// How to create an 128x128 floating point texture (RGBA32F) resource from a buffer object\nexport default defineScript({\n  init() {\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGBA32F;\n    if (format === undefined) return;\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,\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: graphics.TEXTURE_FORMAT_RGBA32F,\n      flags: graphics.TEXTURE_USAGE_FLAG_STORAGE + graphics.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});"
+      "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    // the engine registers a texture type or format only when the driver supports it\n    const type = graphics.TEXTURE_TYPE_IMAGE_3D;\n    const format = graphics.TEXTURE_FORMAT_RGBA32F;\n    if (type === undefined || format === undefined) return;\n    const t_volume = resource.create_texture(\"/my_backing_texture.texturec\", {\n      type,\n      width: 32,\n      height: 32,\n      depth: 32,\n      format,\n      flags: graphics.TEXTURE_USAGE_FLAG_STORAGE + graphics.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": "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});"
+      "ts": "// How to create 512x512 texture array with 5 pages.\n// the engine registers a texture format only when the driver supports it\nconst format = graphics.TEXTURE_FORMAT_RGB;\nif (format !== undefined) {\n  const 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,\n  });\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: graphics.TEXTURE_FORMAT_RGBA32F,\n      flags: graphics.TEXTURE_USAGE_FLAG_STORAGE + graphics.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": "805bde1e64372a97",
+      "ts": "if (graphics.TEXTURE_FORMAT_RGBA16F !== undefined) {\n  // it is safe to use this format\n}"
+    },
+    {
+      "sourceHash": "51b59b3d6e594c38",
+      "ts": "if (graphics.TEXTURE_TYPE_3D !== undefined) {\n  // Device and graphics adapter support 3D textures\n}"
+    },
+    {
+      "sourceHash": "99a0f19709b55611",
+      "ts": "if (graphics.TEXTURE_FORMAT_RGBA16F !== undefined) {\n  // It is safe to use this format.\n}"
+    },
+    {
+      "sourceHash": "a2e9eeb06d748575",
+      "ts": "if (graphics.TEXTURE_TYPE_3D !== undefined) {\n  // The device and graphics adapter support 3D textures.\n}"
     }
   ],
   "resource.create_texture_async": [
@@ -1346,7 +1696,28 @@
     },
     {
       "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});"
+      "ts": "// Create a texture resource asyncronously without handling its completion\nexport default defineScript({\n  init() {\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGBA;\n    if (format === undefined) return;\n    // Create a texture resource async\n    const tparams = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format,\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    // the binding requires a callback function, so pass one that does nothing\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});",
+      "prose": "Create a texture resource asynchronously with a callback that does nothing"
+    },
+    {
+      "sourceHash": "805bde1e64372a97",
+      "ts": "if (graphics.TEXTURE_FORMAT_RGBA16F !== undefined) {\n  // it is safe to use this format\n}"
+    },
+    {
+      "sourceHash": "51b59b3d6e594c38",
+      "ts": "if (graphics.TEXTURE_TYPE_3D !== undefined) {\n  // Device and graphics adapter support 3D textures\n}"
+    },
+    {
+      "sourceHash": "99a0f19709b55611",
+      "ts": "if (graphics.TEXTURE_FORMAT_RGBA16F !== undefined) {\n  // It is safe to use this format.\n}"
+    },
+    {
+      "sourceHash": "a2e9eeb06d748575",
+      "ts": "if (graphics.TEXTURE_TYPE_3D !== undefined) {\n  // The device and graphics adapter support 3D textures.\n}"
+    },
+    {
+      "sourceHash": "66e3c1c627270938",
+      "ts": "// Create a texture resource asyncronously with a buffer and a callback\nfunction callback(self: unknown, request_id: number, result: resource.texture_creation_result) {\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(result.path);\n  msg.post(\"@render:\", \"set_backing_texture\", { handle: tinfo.handle });\n}\n\nexport default defineScript({\n  init() {\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGBA;\n    if (format === undefined) return;\n    // Create a texture resource async\n    const tparams = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format,\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});"
     }
   ],
   "resource.font": [
@@ -1384,7 +1755,7 @@
   "resource.get_texture_info": [
     {
       "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});"
+      "ts": "// Create a new texture and get the metadata from it\nexport default defineScript({\n  init() {\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGBA;\n    if (format === undefined) return;\n    // create an empty texture\n    const tparams = {\n      width: 128,\n      height: 128,\n      type: graphics.TEXTURE_TYPE_2D,\n      format,\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",
@@ -1393,8 +1764,12 @@
   ],
   "resource.load": [
     {
-      "sourceHash": "051230427173b08a",
-      "ts": "// read custom resource data into buffer\nconst buffer = resource.load(\"/resources/datafile\");\n\n// In order for the engine to include custom resources in the build process, you\n// need to specify them in the \"game.project\" settings file:\n// [project]\n// title = My project\n// version = 0.1\n// custom_resources = resources/,assets/level_data.json"
+      "sourceHash": "dfc400954f81d242",
+      "ts": "// read custom resource data into buffer\nconst buffer = resource.load(\"/resources/datafile\");"
+    },
+    {
+      "sourceHash": "f02ab4b1fbd6e499",
+      "ts": "// [project]\n// title = My project\n// version = 0.1\n// custom_resources = resources/,assets/level_data.json"
     }
   ],
   "resource.material": [
@@ -1422,11 +1797,11 @@
   "resource.set_atlas": [
     {
       "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      flip_vertical: false,\n      flip_horizontal: false,\n    };\n    data.animations.push(my_animation);\n    resource.set_atlas(\"/main/my_atlas.a.texturesetc\", data);\n  },\n});"
+      "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      flip_vertical: false,\n      flip_horizontal: false,\n    };\n    // set_atlas takes each animation's frames as a non-empty list\n    const animations = data.animations.flatMap((animation) => {\n      // an animation described by frame_start/frame_end passes through as-is\n      if (!(\"frames\" in animation)) return [animation];\n      const [first, ...rest] = (animation.frames as number[] | undefined) ?? [];\n      return first === undefined ? [] : [{ ...animation, frames: [first, ...rest] as [number, ...number[]] }];\n    });\n    // set_atlas needs at least one animation and one geometry\n    const [first_geometry, ...geometries] = data.geometries;\n    if (first_geometry !== undefined) {\n      resource.set_atlas(\"/main/my_atlas.a.texturesetc\", {\n        ...data,\n        animations: [my_animation, ...animations],\n        geometries: [first_geometry, ...geometries],\n      });\n    }\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});"
+      "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    } satisfies Parameters<typeof resource.set_atlas>[1];\n    resource.set_atlas(\"/main/test.a.texturesetc\", params);\n  },\n});"
     }
   ],
   "resource.set_buffer": [
@@ -1438,15 +1813,15 @@
   "resource.set_texture": [
     {
       "sourceHash": "fe312c35ef2ab0f4",
-      "ts": "// How to set all pixels of an atlas\nexport default defineScript({\n  init() {\n    const height = 128;\n    const width = 128;\n    const buf = buffer.create(width * height, [{ name: hash(\"rgb\"), type: buffer.VALUE_TYPE_UINT8, count: 3 }]);\n    const stream = buffer.get_stream(buf, hash(\"rgb\"));\n\n    for (let y = 0; y < height; y++) {\n      for (let x = 0; x < width; x++) {\n        const index = y * width * 3 + x * 3;\n        stream[index + 0] = 0xff;\n        stream[index + 1] = 0x80;\n        stream[index + 2] = 0x10;\n      }\n    }\n\n    const resource_path = go.get<model.properties>()(\"#model\", \"texture0\");\n    const args = { width, height, type: graphics.TEXTURE_TYPE_2D, format: graphics.TEXTURE_FORMAT_RGB, num_mip_maps: 1 };\n    resource.set_texture(resource_path, args, buf);\n    return { buffer: buf, stream };\n  },\n});"
+      "ts": "// How to set all pixels of an atlas\nexport default defineScript({\n  init() {\n    const height = 128;\n    const width = 128;\n    const buf = buffer.create(width * height, [{ name: hash(\"rgb\"), type: buffer.VALUE_TYPE_UINT8, count: 3 }]);\n    const stream = buffer.get_stream(buf, hash(\"rgb\"));\n\n    for (let y = 0; y < height; y++) {\n      for (let x = 0; x < width; x++) {\n        const index = y * width * 3 + x * 3;\n        stream[index + 0] = 0xff;\n        stream[index + 1] = 0x80;\n        stream[index + 2] = 0x10;\n      }\n    }\n\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGB;\n    if (format !== undefined) {\n      const resource_path = go.get<model.properties>()(\"#model\", \"texture0\");\n      const args = { width, height, type: graphics.TEXTURE_TYPE_2D, format, num_mip_maps: 1 };\n      resource.set_texture(resource_path, args, buf);\n    }\n    return { buffer: buf, stream };\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() {\n    const x = 16;\n    const y = 16;\n    const height = 128 - x * 2;\n    const width = 128 - y * 2;\n    const buf = buffer.create(width * height, [{ name: hash(\"rgb\"), type: buffer.VALUE_TYPE_UINT8, count: 3 }]);\n    const stream = buffer.get_stream(buf, hash(\"rgb\"));\n\n    for (let row = 0; row < height; row++) {\n      for (let col = 0; col < width; col++) {\n        const index = row * width * 3 + col * 3;\n        stream[index + 0] = 0xff;\n        stream[index + 1] = 0x80;\n        stream[index + 2] = 0x10;\n      }\n    }\n\n    const resource_path = go.get<model.properties>()(\"#model\", \"texture0\");\n    const args = { width, height, x, y, type: graphics.TEXTURE_TYPE_2D, format: graphics.TEXTURE_FORMAT_RGB, num_mip_maps: 1 };\n    resource.set_texture(resource_path, args, buf);\n    return { buffer: buf, stream };\n  },\n});"
+      "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() {\n    const x = 16;\n    const y = 16;\n    const height = 128 - x * 2;\n    const width = 128 - y * 2;\n    const buf = buffer.create(width * height, [{ name: hash(\"rgb\"), type: buffer.VALUE_TYPE_UINT8, count: 3 }]);\n    const stream = buffer.get_stream(buf, hash(\"rgb\"));\n\n    for (let row = 0; row < height; row++) {\n      for (let col = 0; col < width; col++) {\n        const index = row * width * 3 + col * 3;\n        stream[index + 0] = 0xff;\n        stream[index + 1] = 0x80;\n        stream[index + 2] = 0x10;\n      }\n    }\n\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGB;\n    if (format !== undefined) {\n      const resource_path = go.get<model.properties>()(\"#model\", \"texture0\");\n      const args = { width, height, x, y, type: graphics.TEXTURE_TYPE_2D, format, num_mip_maps: 1 };\n      resource.set_texture(resource_path, args, buf);\n    }\n    return { buffer: buf, stream };\n  },\n});"
     },
     {
       "sourceHash": "02d7f2ec29971bf1",
-      "ts": "// Update a texture from a buffer resource\nexport default defineScript({\n  // Never call `go.property` yourself: the transpiler emits the chunk-scope\n  // registration from this field, and only this field types the property onto `self`.\n  properties: { my_buffer: resource.buffer(\"/my_default_buffer.buffer\") },\n\n  init(self) {\n    const resource_path = go.get<model.properties>()(\"#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});"
+      "ts": "// Update a texture from a buffer resource\nexport default defineScript({\n  // Never call `go.property` yourself: the transpiler emits the chunk-scope\n  // registration from this field, and only this field types the property onto `self`.\n  properties: { my_buffer: resource.buffer(\"/my_default_buffer.buffer\") },\n\n  init(self) {\n    // the engine registers a texture format only when the driver supports it\n    const format = graphics.TEXTURE_FORMAT_RGB;\n    if (format === undefined) return;\n    const resource_path = go.get<model.properties>()(\"#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,\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",
@@ -1454,11 +1829,31 @@
     },
     {
       "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}"
+      "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);\n// the engine registers a texture format only when the driver supports it\nconst format = graphics.TEXTURE_FORMAT_RGB;\nif (data !== undefined && format !== 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,\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,\n      },\n      buf.buffer,\n    );\n    go.set(\"#mesh\", \"texture0\", new_tex);\n  }\n}"
     },
     {
       "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: graphics.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": "805bde1e64372a97",
+      "ts": "if (graphics.TEXTURE_FORMAT_RGBA16F !== undefined) {\n  // it is safe to use this format\n}"
+    },
+    {
+      "sourceHash": "51b59b3d6e594c38",
+      "ts": "if (graphics.TEXTURE_TYPE_3D !== undefined) {\n  // Device and graphics adapter support 3D textures\n}"
+    },
+    {
+      "sourceHash": "99a0f19709b55611",
+      "ts": "if (graphics.TEXTURE_FORMAT_RGBA16F !== undefined) {\n  // It is safe to use this format.\n}"
+    },
+    {
+      "sourceHash": "a2e9eeb06d748575",
+      "ts": "if (graphics.TEXTURE_TYPE_3D !== undefined) {\n  // The device and graphics adapter support 3D textures.\n}"
+    },
+    {
+      "sourceHash": "e051bd09ecb32c90",
+      "ts": "// Update an existing 3D texture from a lua buffer\nexport default defineScript({\n  init() {\n    // the engine registers a texture type or format only when the driver supports it\n    const type = graphics.TEXTURE_TYPE_IMAGE_3D;\n    const format = graphics.TEXTURE_FORMAT_RGBA32F;\n    if (type === undefined || format === undefined) return;\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 = 1; z <= 8; z++) {\n      for (let y = 1; y <= 8; y++) {\n        for (let x = 1; 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,\n      width: 8,\n      height: 8,\n      depth: 8,\n      format,\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": [
@@ -1493,8 +1888,12 @@
   ],
   "socket.skip": [
     {
-      "sourceHash": "3a75c35a80c48e9e",
-      "ts": "const line = \"250 OK\";\n\n// Instead of doing the following with dummy variables:\n{\n  // get the status code and separator from SMTP server reply\n  const [dummy1, dummy2, code, sep] = string.find(line, \"^(%d%d%d)(.?)\");\n}\n\n// You can skip a number of variables:\n{\n  // get the status code and separator from SMTP server reply\n  const [code, sep] = socket.skip(2, string.find(line, \"^(%d%d%d)(.?)\"));\n}"
+      "sourceHash": "4a23a75fe4aaaca9",
+      "ts": "const line = \"250 OK\";\n// get the status code and separator from SMTP server reply\nconst [dummy1, dummy2, code, sep] = string.find(line, \"^(%d%d%d)(.?)\");"
+    },
+    {
+      "sourceHash": "76686918042071bd",
+      "ts": "const line = \"250 OK\";\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": [
@@ -1547,8 +1946,12 @@
   ],
   "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: 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() {\n    return { countdown_id: sound.play(\"#countdown\", undefined, sound_done) };\n  },\n});"
+      "sourceHash": "657f9fcfa39cf3af",
+      "ts": "sound.play(\"#sound\", { delay: 1, gain: 0.9, pan: -1.0 });"
+    },
+    {
+      "sourceHash": "181c1feca6bf14c8",
+      "ts": "function 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() {\n    return { countdown_id: sound.play(\"#countdown\", undefined, sound_done) };\n  },\n});"
     }
   ],
   "sound.set_gain": [
@@ -1577,8 +1980,12 @@
   ],
   "sprite.play_flipbook": [
     {
-      "sourceHash": "6bac8dc702dfffec",
-      "ts": "// Assuming the sprite has id \"sprite\": play the \"jump\" animation followed by the\n// \"run\" animation:\nexport default defineScript({\n  init() {\n    const url = msg.url(\"#sprite\");\n    sprite.play_flipbook(url, \"jump\", (self, message_id, message) => {\n      if (message_id === hash(\"animation_done\") && message.id === hash(\"jump\")) {\n        // jump animation done, chain with \"run\"\n        sprite.play_flipbook(url, \"run\");\n      }\n    });\n  },\n});"
+      "sourceHash": "69a3c26fd553ffa4",
+      "ts": "const url = msg.url(\"#sprite\");\n\nfunction anim_done(self: unknown, message_id: Hash, message: { id: Hash }) {\n  if (message_id === hash(\"animation_done\") && message.id === hash(\"jump\")) {\n    // jump animation done, chain with \"run\"\n    sprite.play_flipbook(url, \"run\");\n  }\n}"
+    },
+    {
+      "sourceHash": "286542aa4db17a87",
+      "ts": "export default defineScript({\n  init() {\n    const url = msg.url(\"#sprite\");\n    sprite.play_flipbook(url, \"jump\", (self, message_id, message) => {\n      if (message_id === hash(\"animation_done\") && message.id === hash(\"jump\")) {\n        // jump animation done, chain with \"run\"\n        sprite.play_flipbook(url, \"run\");\n      }\n    });\n  },\n});"
     }
   ],
   "sprite.reset_constant": [
@@ -1619,8 +2026,12 @@
   ],
   "sys.get_application_info": [
     {
-      "sourceHash": "e13c2cc712709832",
-      "ts": "// Check if twitter is installed:\nconst sysinfo = sys.get_sys_info();\nlet twitter: { installed?: boolean } = {};\n\nif (sysinfo.system_name === \"Android\") {\n  twitter = sys.get_application_info(\"com.twitter.android\");\n} else if (sysinfo.system_name === \"iPhone OS\") {\n  twitter = sys.get_application_info(\"twitter:\");\n}\n\nif (twitter.installed) {\n  // twitter is installed!\n}\n\n// Info.plist for the iOS app needs to list the schemes that are queried:\n// ...\n// <key>LSApplicationQueriesSchemes</key>\n//  <array>\n//    <string>twitter</string>\n//  </array>\n// ..."
+      "sourceHash": "326e42d5ff9baf96",
+      "ts": "const sysinfo = sys.get_sys_info();\nlet twitter: { installed?: boolean } = {};\n\nif (sysinfo.system_name === \"Android\") {\n  twitter = sys.get_application_info(\"com.twitter.android\");\n} else if (sysinfo.system_name === \"iPhone OS\") {\n  twitter = sys.get_application_info(\"twitter:\");\n}\n\nif (twitter.installed) {\n  // twitter is installed!\n}"
+    },
+    {
+      "sourceHash": "1dd1eced66cc1e10",
+      "ts": "// ...\n// <key>LSApplicationQueriesSchemes</key>\n//  <array>\n//    <string>twitter</string>\n//  </array>\n// ..."
     }
   ],
   "sys.get_application_path": [
@@ -1637,8 +2048,12 @@
   ],
   "sys.get_config_int": [
     {
-      "sourceHash": "f384eab53a7c1bda",
-      "ts": "// Get user config value\nconst speed = sys.get_config_int(\"my_game.speed\", 20); // with default value\n\nconst testmode = sys.get_config_int(\"my_game.testmode\"); // without default value\nif (testmode !== undefined) {\n  // do stuff\n}"
+      "sourceHash": "cadf71c740165693",
+      "ts": "const speed = sys.get_config_int(\"my_game.speed\", 20); // with default value"
+    },
+    {
+      "sourceHash": "9365fae7e38c060c",
+      "ts": "const testmode = sys.get_config_int(\"my_game.testmode\"); // without default value\nif (testmode !== undefined) {\n  // do stuff\n}"
     }
   ],
   "sys.get_config_number": [
@@ -1649,8 +2064,20 @@
   ],
   "sys.get_config_string": [
     {
-      "sourceHash": "4aeb12fca87c114c",
-      "ts": "// Get user config value\nconst text = sys.get_config_string(\"my_game.text\", \"default text\");\n\n// Start the engine with a bootstrap config override and add a custom config value\n// $ dmengine --config=bootstrap.main_collection=/mytest.collectionc --config=mygame.testmode=1\n\n// Read the custom config value from the command line\nconst testmode = sys.get_config_int(\"mygame.testmode\");"
+      "sourceHash": "0bf7e3158e38a94a",
+      "ts": "const text = sys.get_config_string(\"my_game.text\", \"default text\");"
+    },
+    {
+      "sourceHash": "a4703f05ae2e55b8",
+      "ts": "// $ dmengine --config=bootstrap.main_collection=/mytest.collectionc --config=mygame.testmode=1"
+    },
+    {
+      "sourceHash": "4bf891e310fb931a",
+      "ts": "const testmode = sys.get_config_int(\"mygame.testmode\");"
+    },
+    {
+      "sourceHash": "c1b9b57492dd68a7",
+      "ts": "const text = sys.get_config_string(\"my_game.text\", \"default text\");"
     }
   ],
   "sys.get_connectivity": [
@@ -1667,8 +2094,12 @@
   ],
   "sys.get_host_path": [
     {
-      "sourceHash": "a059ecb3d55d5c22",
-      "ts": "// Save data on the host\n{\n  const mytable = { score: 100, level: 3 };\n  const host_path = sys.get_host_path(\"logs/test.txt\");\n  sys.save(host_path, mytable);\n}\n\n// Load data from the host\n{\n  const host_path = sys.get_host_path(\"logs/test.txt\");\n  const table = sys.load(host_path);\n}"
+      "sourceHash": "cea90df8f93a0217",
+      "ts": "const mytable = { score: 100, level: 3 };\nconst host_path = sys.get_host_path(\"logs/test.txt\");\nsys.save(host_path, mytable);"
+    },
+    {
+      "sourceHash": "8b9a6ad30303b25e",
+      "ts": "const host_path = sys.get_host_path(\"logs/test.txt\");\nconst table = sys.load(host_path);"
     }
   ],
   "sys.get_ifaddrs": [
@@ -1697,14 +2128,30 @@
   ],
   "sys.load_buffer": [
     {
-      "sourceHash": "106462121a6dfc78",
-      "ts": "// Load binary data from a custom project resource:\nconst my_buffer = sys.load_buffer(\"/assets/my_level_data.bin\");\nconst data_str = buffer.get_bytes(my_buffer, \"data\");\nconst has_my_header = data_str.slice(0, 6) === \"D3F0LD\";\n\n// Load binary data from non-custom resource files on disk:\nconst asset_1 = sys.load_buffer(\"folder_next_to_binary/my_level_asset.txt\");\nconst asset_2 = sys.load_buffer(\"/my/absolute/path\");"
+      "sourceHash": "485ff25191819692",
+      "ts": "const my_buffer = sys.load_buffer(\"/assets/my_level_data.bin\");\nconst data_str = buffer.get_bytes(my_buffer, \"data\");\nconst has_my_header = data_str.slice(0, 6) === \"D3F0LD\";"
+    },
+    {
+      "sourceHash": "ff532f8e663a09ba",
+      "ts": "const asset_1 = sys.load_buffer(\"folder_next_to_binary/my_level_asset.txt\");\nconst asset_2 = sys.load_buffer(\"/my/absolute/path\");"
     }
   ],
   "sys.load_buffer_async": [
     {
-      "sourceHash": "6a383bca91cf11eb",
-      "ts": "// Load binary data from a custom project resource and update a texture resource:\n{\n  function my_callback(self: unknown, request_id: unknown, result: unknown) {\n    const { status, buf } = result as { status: number; buf: Opaque<\"buffer\"> };\n    if (status === sys.REQUEST_STATUS_FINISHED) {\n      resource.set_texture(\"/my_texture\", {}, buf); // texture args\n    }\n  }\n\n  const my_request = sys.load_buffer_async(\"/assets/my_level_data.bin\", my_callback);\n}\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() {\n    const first_path = \"folder_next_to_binary/my_level_asset.bin\";\n    const second_path = \"/some_absolute_path/my_level.bin\";\n    return {\n      first_asset: hash(first_path),\n      second_asset: hash(second_path),\n      first_request: sys.load_buffer_async(first_path, my_callback),\n      second_request: sys.load_buffer_async(second_path, my_callback),\n    };\n  },\n});"
+      "sourceHash": "91d84e7dc569ae20",
+      "ts": "function my_callback(self: unknown, request_id: unknown, result: unknown) {\n  const { status, buf } = result as { status: number; buf: Opaque<\"buffer\"> };\n  if (status === sys.REQUEST_STATUS_FINISHED) {\n    resource.set_texture(\"/my_texture\", { type: graphics.TEXTURE_TYPE_2D, width: 128, height: 128, format: graphics.TEXTURE_FORMAT_RGBA }, buf);\n  }\n}\n\nconst my_request = sys.load_buffer_async(\"/assets/my_level_data.bin\", my_callback);"
+    },
+    {
+      "sourceHash": "5545b8901e6ec4c5",
+      "ts": "function 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() {\n    const first_path = \"folder_next_to_binary/my_level_asset.bin\";\n    const second_path = \"/some_absolute_path/my_level.bin\";\n    return {\n      first_asset: hash(first_path),\n      second_asset: hash(second_path),\n      first_request: sys.load_buffer_async(first_path, my_callback),\n      second_request: sys.load_buffer_async(second_path, my_callback),\n    };\n  },\n});"
+    },
+    {
+      "sourceHash": "7f66d3285b20ff78",
+      "ts": "// Load binary data from a custom project resource and update a texture resource:\nfunction my_callback(self: unknown, request_id: number, result: sys.load_buffer_result) {\n  const format = graphics.TEXTURE_FORMAT_RGBA;\n  if (result.status === sys.REQUEST_STATUS_FINISHED && result.buffer !== undefined && format !== undefined) {\n    resource.set_texture(\"/my_texture\", { type: graphics.TEXTURE_TYPE_2D, width: 128, height: 128, format }, result.buffer);\n  }\n}\n\nconst my_request = sys.load_buffer_async(\"/assets/my_level_data.bin\", my_callback);"
+    },
+    {
+      "sourceHash": "9be4f92f718990af",
+      "ts": "// Load binary data from non-custom resource files on disk:\nfunction my_callback(self: unknown, request_id: number, result: sys.load_buffer_result) {\n  const { first_request, second_request } = self as { first_request: number; second_request: number };\n  if (result.status !== sys.REQUEST_STATUS_FINISHED) {\n    // uh oh! File could not be found, do something graceful\n  } else if (request_id === first_request) {\n    // result.buffer contains data from my_level_asset.bin\n  } else if (request_id === second_request) {\n    // result.buffer contains data from 'my_level.bin'\n  }\n}\n\nexport default defineScript({\n  init() {\n    return {\n      first_request: sys.load_buffer_async(\"folder_next_to_binary/my_level_asset.bin\", my_callback),\n      second_request: sys.load_buffer_async(\"/some_absolute_path/my_level.bin\", my_callback),\n    };\n  },\n});"
     }
   ],
   "sys.load_resource": [
@@ -1745,8 +2192,12 @@
   ],
   "sys.set_engine_throttle": [
     {
-      "sourceHash": "66eae5cfa23de217",
-      "ts": "// Disable throttling\nsys.set_engine_throttle(false);\n\n// Enable throttling\nsys.set_engine_throttle(true, 1.5);"
+      "sourceHash": "3e3d6cc6b4f7ebb6",
+      "ts": "sys.set_engine_throttle(false);"
+    },
+    {
+      "sourceHash": "8bf9b8da4d26c449",
+      "ts": "sys.set_engine_throttle(true, 1.5);"
     }
   ],
   "sys.set_error_handler": [
@@ -1755,10 +2206,10 @@
       "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": [
+  "sys.set_render_enabled": [
     {
       "sourceHash": "aa4a8e62d5eddb0b",
-      "ts": "// Disable rendering\nsys.set_render_enable(false);"
+      "ts": "// Disable rendering\nsys.set_render_enabled(false);"
     }
   ],
   "sys.set_update_frequency": [
@@ -1771,6 +2222,10 @@
     {
       "sourceHash": "95117be25e11bf9f",
       "ts": "// Setting the swap intervall to swap every v-blank\nsys.set_vsync_swap_interval(1);"
+    },
+    {
+      "sourceHash": "3b6e97f1ef4ca783",
+      "ts": "// Setting the swap interval to swap every v-blank\nsys.set_vsync_swap_interval(1);"
     }
   ],
   "tilemap.get_bounds": [
@@ -1819,12 +2274,20 @@
     {
       "sourceHash": "00f46bbbb35028b3",
       "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}"
+    },
+    {
+      "sourceHash": "ad9e37f1a30347b3",
+      "ts": "function cancel_ticking(self: { handle: number }) {\n  self.handle = timer.delay(1, true, () => print(\"print every second\"));\n  // ...\n  const cancelled = timer.cancel(self.handle);\n  if (!cancelled) {\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: 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}"
+      "sourceHash": "afdbd5fc199b8290",
+      "ts": "timer.delay(1, false, () => print(\"print in one second\"));"
+    },
+    {
+      "sourceHash": "777732bd4b7c14a2",
+      "ts": "function 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": [
@@ -1837,6 +2300,10 @@
     {
       "sourceHash": "3d4814c0a3380acf",
       "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}"
+    },
+    {
+      "sourceHash": "96cf34367a47da0b",
+      "ts": "function trigger_ticking(self: { handle: number }) {\n  self.handle = timer.delay(1, true, () => print(\"print every second or manually by timer.trigger\"));\n  // ...\n  const triggered = timer.trigger(self.handle);\n  if (!triggered) {\n    print(\"the timer is already cancelled or complete\");\n  }\n}"
     }
   ],
   "update": [
@@ -2143,6 +2610,10 @@
     {
       "sourceHash": "5075cb14faa9510b",
       "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});"
+    },
+    {
+      "sourceHash": "c4168599cd777bb9",
+      "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_ICONIFIED) {\n    print(\"window.WINDOW_EVENT_ICONIFIED\");\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": [