@defold-typescript/types 0.44.1 → 0.46.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  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}"
+      "ts": "const body = b2d.get_body(\"#collisionobject\");\nif (body !== undefined) {\n  // Move a circle shape relative to the body origin.\n  const circle = b2d.fixture.get_shape(body, 1);\n  const radius = \"radius\" in circle ? circle.radius : undefined;\n  b2d.fixture.set_shape(body, 1, { type: b2d.shape.SHAPE_TYPE_CIRCLE, radius: radius ?? 16, center: vmath.vector3(24, 0, 0) }, true);\n\n  // Replace an edge shape's local endpoints.\n  b2d.fixture.set_shape(body, 2, {\n    type: b2d.shape.SHAPE_TYPE_EDGE,\n    v1: vmath.vector3(-32, 0, 0),\n    v2: vmath.vector3(32, 0, 0),\n  });\n\n  // Update a box shape using the polygon box convenience format.\n  // The existing polygon must already have four vertices.\n  b2d.fixture.set_shape(\n    body,\n    3,\n    {\n      type: b2d.shape.SHAPE_TYPE_BOX,\n      hx: 16,\n      hy: 8,\n      center: vmath.vector3(0, 20, 0),\n      angle: math.rad(30),\n    },\n    true,\n  );\n}"
     }
   ],
   "b2d.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  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}"
+      "ts": "const body = b2d.get_body(\"#collisionobject\");\nif (body !== undefined) {\n  // Move a circle shape relative to the body origin.\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\n  // Replace a segment shape's local endpoints.\n  b2d.shape.set_shape(body, 2, {\n    type: b2d.shape.SHAPE_TYPE_SEGMENT,\n    v1: vmath.vector3(-32, 0, 0),\n    v2: vmath.vector3(32, 0, 0),\n  });\n\n  // Update a box shape using the polygon box convenience format.\n  b2d.shape.set_shape(\n    body,\n    3,\n    {\n      type: b2d.shape.SHAPE_TYPE_BOX,\n      hx: 16,\n      hy: 8,\n      center: vmath.vector3(0, 20, 0),\n      angle: math.rad(30),\n    },\n    true,\n  );\n}"
     }
   ],
   "buffer.copy_buffer": [
@@ -240,7 +240,7 @@
   "compute.set_constants": [
     {
       "sourceHash": "e14e2048f75cadc6",
-      "ts": "compute.set_constants(\"/my_compute.computec\", { tint: { value: vmath.vector4(1, 0, 0, 1) } });"
+      "ts": "// Set a shader constant in a compute program\nexport default defineScript({\n  init() {\n    return { my_view_proj: vmath.matrix4() };\n  },\n\n  update(self) {\n    // update the 'tint' constant\n    compute.set_constants(\"/my_compute.computec\", {\n      tint: { value: vmath.vector4(1, 0, 0, 1) },\n    });\n    // change the type of the 'view_proj' constant to CONSTANT_TYPE_USER_MATRIX4 so the renderer can set our custom data\n    compute.set_constants(\"/my_compute.computec\", {\n      view_proj: { value: self.my_view_proj, type: material.CONSTANT_TYPE_USER_MATRIX4 },\n    });\n  },\n});"
     }
   ],
   "compute.set_samplers": [
@@ -252,7 +252,7 @@
   "compute.set_textures": [
     {
       "sourceHash": "87edc357f8852364",
-      "ts": "compute.set_textures(\"/my_compute.computec\", { my_texture: resource.texture() });"
+      "ts": "// Set a texture in a compute program from a 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_texture: resource.texture() },\n\n  init(self) {\n    compute.set_textures(\"/my_compute.computec\", {\n      my_texture: self.my_texture,\n    });\n  },\n});"
     }
   ],
   "editor.bob": [
@@ -408,11 +408,11 @@
   "go.delete": [
     {
       "sourceHash": "eb1a20098678b7b1",
-      "ts": "// Delete the script's own game object.\ngo.delete();\n// Delete a game object with the id \"my_game_object\".\nconst id = go.get_id(\"my_game_object\");\ngo.delete(id);\n// Delete a list of game objects.\nconst ids = [hash(\"/my_object_1\"), hash(\"/my_object_2\"), hash(\"/my_object_3\")];\ngo.delete(ids);"
+      "ts": "// Delete the script's own game object.\ngo.delete();\n// Delete a game object with the id \"my_game_object\".\nconst id = go.get_id(\"my_game_object\"); // retrieve the id of the game object to be deleted\ngo.delete(id);\n// Delete a list of game objects.\nconst ids = [hash(\"/my_object_1\"), hash(\"/my_object_2\"), hash(\"/my_object_3\")];\ngo.delete(ids);"
     },
     {
       "sourceHash": "15be7513485334cf",
-      "ts": "// Delete the script's own game object and its children.\ngo.delete(true);\n// Delete a game object with the id \"my_game_object\" and its children.\nconst id = go.get_id(\"my_game_object\");\ngo.delete(id, true);\n// Delete a list of game objects and their children.\nconst ids = [hash(\"/my_object_1\"), hash(\"/my_object_2\"), hash(\"/my_object_3\")];\ngo.delete(ids, true);"
+      "ts": "// Delete the script's own game object and its children.\ngo.delete(true);\n// Delete a game object with the id \"my_game_object\" and its children.\nconst id = go.get_id(\"my_game_object\"); // retrieve the id of the game object to be deleted\ngo.delete(id, true);\n// Delete a list of game objects and their children.\nconst ids = [hash(\"/my_object_1\"), hash(\"/my_object_2\"), hash(\"/my_object_3\")];\ngo.delete(ids, true);"
     }
   ],
   "go.exists": [
@@ -436,11 +436,11 @@
     },
     {
       "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"
+      "ts": "const url = msg.url(\"#mesh\");\n// get the first vector4 in the array: example[0] (the glsl indices are 0-based)\ngo.get(url, \"example\", { index: 1 });\n\n// get the last vector4 in the array: example[15] (the glsl indices are 0-based)\ngo.get(url, \"example\", { index: 16 });\n\n// get an element of a vector4 in the array: example[0].x (the glsl indices are 0-based)\ngo.get(url, \"example.x\", { index: 1 });"
     },
     {
       "sourceHash": "cd59aaeb4278cdfc",
-      "ts": "const url = msg.url(\"#mesh\");\ngo.get(url, \"example\"); // => [vector4, vector4, ...]\ngo.get(url, \"example.x\"); // => [number1, number2, ...]"
+      "ts": "const url = msg.url(\"#mesh\");\n// get all vector4's in the constant array\ngo.get(url, \"example\");\n// result: [vector4, vector4, ...]\n// get all elements of the vector4's from an array\ngo.get(url, \"example.x\");\n// result: [number1, number2, ...]"
     },
     {
       "sourceHash": "4b5cae0c647b3381",
@@ -456,7 +456,7 @@
     },
     {
       "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, ...]"
+      "ts": "const url = msg.url(\"#mesh\");\n// get all vector4's in the constant array\ngo.get(url, \"example\");\n// result: [vector4, vector4, ...]\n\n// get all elements of the vector4's from an array\ngo.get(url, \"example.x\");\n// result: [number1, number2, ...]"
     }
   ],
   "go.get_id": [
@@ -590,11 +590,11 @@
     },
     {
       "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"
+      "ts": "const url = msg.url(\"#mesh\");\n// set the first vector4 in the array: example[0] = v (the glsl indices are 0-based)\ngo.set(url, \"example\", vmath.vector4(1, 1, 1, 1), { index: 1 });\n\n// set the last vector4 in the array: example[15] = v (the glsl indices are 0-based)\ngo.set(url, \"example\", vmath.vector4(2, 2, 2, 2), { index: 16 });\n\n// set an element of a vector4 in the array: example[0].x = 7 (the glsl indices are 0-based)\ngo.set(url, \"example.x\", 7, { index: 1 });"
     },
     {
       "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)]);"
+      "ts": "const url = msg.url(\"#mesh\");\n// 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\ngo.set(url, \"example\", [vmath.vector4(1, 1, 1, 1), vmath.vector4(2, 2, 2, 2)]);"
     },
     {
       "sourceHash": "ea5b1b6430458d24",
@@ -602,7 +602,7 @@
     },
     {
       "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}"
+      "ts": "export 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_material: resource.material() },\n\n  init(self) {\n    go.set(\"#particlefx\", \"material\", self.my_material, { keys: [\"cone_emitter\"] });\n  },\n});"
     },
     {
       "sourceHash": "2a68fe57bedcd5c1",
@@ -790,7 +790,7 @@
   "gui.play_particlefx": [
     {
       "sourceHash": "19a26b6e14ad0997",
-      "ts": "// How to play a particle fx when a gui node is created.\n// The callback receives the gui node, the hash of the id\n// of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.\nfunction emitter_state_change(self: unknown, node: unknown, emitter: unknown, state: unknown) {\n  if (emitter === hash(\"exhaust\") && state === particlefx.EMITTER_STATE_POSTSPAWN) {\n    // exhaust is done spawning particles...\n  }\n}\n\nexport default defineGuiScript({\n  init(self) {\n    gui.play_particlefx(gui.get_node(\"particlefx\"), emitter_state_change);\n  },\n});"
+      "ts": "// How to play a particle fx when a gui node is created.\n// The callback receives the gui node, the hash of the id\n// of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.\nexport default defineGuiScript({\n  init(self) {\n    gui.play_particlefx(gui.get_node(\"particlefx\"), (self, node, emitter, state) => {\n      if (emitter === hash(\"exhaust\") && state === particlefx.EMITTER_STATE_POSTSPAWN) {\n        // exhaust is done spawning particles...\n      }\n    });\n  },\n});"
     }
   ],
   "gui.reset_material": [
@@ -982,49 +982,49 @@
   "material.get_constants": [
     {
       "sourceHash": "6409de8793053165",
-      "ts": "const constants = material.get_constants(resource.material(\"/my_material.materialc\"));"
+      "ts": "// Get the shader constants from a material specified as a resource property\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_material: resource.material() },\n\n  init(self) {\n    const constants = material.get_constants(self.my_material);\n  },\n});"
     }
   ],
   "material.get_samplers": [
     {
       "sourceHash": "e346ac9f6ec55d31",
-      "ts": "const samplers = material.get_samplers(resource.material(\"/my_material.materialc\"));"
+      "ts": "// Get the texture samplers from a material specified as a resource property\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_material: resource.material() },\n\n  init(self) {\n    const samplers = material.get_samplers(self.my_material);\n  },\n});"
     }
   ],
   "material.get_textures": [
     {
       "sourceHash": "350415f3b2ba725d",
-      "ts": "const textures = material.get_textures(resource.material(\"/my_material.materialc\"));"
+      "ts": "// Get the textures from a material specified as a resource property\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_material: resource.material() },\n\n  init(self) {\n    const textures = material.get_textures(self.my_material);\n  },\n});"
     }
   ],
   "material.get_vertex_attributes": [
     {
       "sourceHash": "e835376dd87b4332",
-      "ts": "const vertex_attributes = material.get_vertex_attributes(resource.material(\"/my_material.materialc\"));"
+      "ts": "// Get the vertex attributes from a material specified as a resource property\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_material: resource.material() },\n\n  init(self) {\n    const vertex_attributes = material.get_vertex_attributes(self.my_material);\n  },\n});"
     }
   ],
   "material.set_constants": [
     {
       "sourceHash": "4f7ec4631253a3dc",
-      "ts": "material.set_constants(resource.material(\"/my_material.materialc\"), { tint: { value: vmath.vector4(1, 0, 0, 1) } });"
+      "ts": "// Set a shader constant in a material specified as a resource property\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_material: resource.material() },\n\n  init() {\n    return { my_view_proj: vmath.matrix4() };\n  },\n\n  update(self) {\n    // update the 'tint' constant\n    material.set_constants(self.my_material, {\n      tint: { value: vmath.vector4(1, 0, 0, 1) },\n    });\n    // change the type of the 'view_proj' constant to CONSTANT_TYPE_USER_MATRIX4 so the renderer can set our custom data\n    material.set_constants(self.my_material, {\n      view_proj: { value: self.my_view_proj, type: material.CONSTANT_TYPE_USER_MATRIX4 },\n    });\n  },\n});"
     }
   ],
   "material.set_samplers": [
     {
       "sourceHash": "3d29dbd58cf503ad",
-      "ts": "material.set_samplers(resource.material(\"/my_material.materialc\"), { texture_sampler: { u_wrap: graphics.TEXTURE_WRAP_REPEAT, v_wrap: graphics.TEXTURE_WRAP_MIRRORED_REPEAT } });"
+      "ts": "// Configures a sampler in a material specified as a resource property\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_material: resource.material() },\n\n  init(self) {\n    material.set_samplers(self.my_material, {\n      texture_sampler: { u_wrap: graphics.TEXTURE_WRAP_REPEAT, v_wrap: graphics.TEXTURE_WRAP_MIRRORED_REPEAT },\n    });\n  },\n});"
     }
   ],
   "material.set_textures": [
     {
       "sourceHash": "8b7930f275efc915",
-      "ts": "material.set_textures(resource.material(\"/my_material.materialc\"), { my_texture: resource.texture() });"
+      "ts": "// Set a texture in a material from a resource\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: { my_material: resource.material(), my_texture: resource.texture() },\n\n  init(self) {\n    material.set_textures(self.my_material, {\n      my_texture: self.my_texture,\n    });\n  },\n});"
     }
   ],
   "material.set_vertex_attributes": [
     {
       "sourceHash": "a78800caef15ee12",
-      "ts": "material.set_vertex_attributes(resource.material(\"/my_material.materialc\"), { tint_attribute: { value: vmath.vector4(1, 0, 0, 1), semantic_type: graphics.SEMANTIC_TYPE_COLOR } });"
+      "ts": "// Configures a vertex attribute in a material specified as a resource property\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_material: resource.material() },\n\n  init(self) {\n    material.set_vertex_attributes(self.my_material, {\n      tint_attribute: { value: vmath.vector4(1, 0, 0, 1), semantic_type: graphics.SEMANTIC_TYPE_COLOR },\n      weights: { value: vmath.vector4(0, 1, 0, 0), semantic_type: graphics.SEMANTIC_TYPE_NONE },\n    });\n  },\n});"
     }
   ],
   "model.get_aabb": [
@@ -1036,7 +1036,7 @@
   "model.get_blend_weights": [
     {
       "sourceHash": "a4945bd4efb90dd9",
-      "ts": "const weights = model.get_blend_weights(\"#model\");\nweights[1] = 0.75;\nweights[2] = 0.25;\nmodel.set_blend_weights(\"#model\", weights);"
+      "ts": "const w = model.get_blend_weights(\"#model\");\nw.forEach((weight, i) => {\n  print(i + 1, weight);\n});\n// change the data in the table and then set the weights again\nw[0] = 0.75;\nw[1] = 0.25;\nmodel.set_blend_weights(\"#model\", w);"
     }
   ],
   "model.get_go": [
@@ -1072,7 +1072,7 @@
   "model.set_blend_weights": [
     {
       "sourceHash": "74fd31c0afc44481",
-      "ts": "model.set_blend_weights(\"#model\", [0, 1, 0.5, 0]);\nmodel.set_blend_weights(\"#model\");"
+      "ts": "// set the weights for the first 4 morph targets\nmodel.set_blend_weights(\"#model\", [0, 1, 0.5, 0]);\n// clear the override, animation will continue if the weights are driven by an animation\nmodel.set_blend_weights(\"#model\"); // clear script override"
     }
   ],
   "model.set_mesh_enabled": [
@@ -1138,7 +1138,7 @@
   "particlefx.play": [
     {
       "sourceHash": "01a21997b47ac4fc",
-      "ts": "// How to play a particle fx when a game object is created.\n// The callback receives the hash of the path to the particlefx, the hash of the id\n// of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.\nfunction emitter_state_change(self: unknown, id: unknown, emitter: unknown, state: unknown) {\n  if (emitter === hash(\"exhaust\") && state === particlefx.EMITTER_STATE_POSTSPAWN) {\n    // exhaust is done spawning particles...\n  }\n}\n\nexport default defineScript({\n  init(self) {\n    particlefx.play(\"#particlefx\", emitter_state_change);\n  },\n});"
+      "ts": "// How to play a particle fx when a game object is created.\n// The callback receives the hash of the path to the particlefx, the hash of the id\n// of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.\nexport default defineScript({\n  init(self) {\n    particlefx.play(\"#particlefx\", (self, id, emitter, state) => {\n      if (emitter === hash(\"exhaust\") && state === particlefx.EMITTER_STATE_POSTSPAWN) {\n        // exhaust is done spawning particles...\n      }\n    });\n  },\n});"
     }
   ],
   "particlefx.reset_constant": [
@@ -1332,7 +1332,7 @@
     },
     {
       "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}"
+      "ts": "export default defineRenderScript({\n  init() {\n    return { my_pred: render.predicate([hash(\"my_tag\")]) };\n  },\n\n  update(self, dt) {\n    const constants = render.constant_buffer();\n    render.draw(self.my_pred, { constants });\n  },\n});"
     },
     {
       "sourceHash": "2c9cd28e1eb6e610",
@@ -1420,11 +1420,11 @@
     },
     {
       "sourceHash": "dc0ea083dbea5fe1",
-      "ts": "// Or enable a render target by resource id:\nexport default defineRenderScript({\n  init() {\n    return { my_pred: render.predicate([hash(\"my_tag\")]) };\n  },\n\n  update(self, dt) {\n    render.set_render_target(\"my_rt_resource\");\n    render.draw(self.my_pred);\n    render.set_render_target(render.RENDER_TARGET_DEFAULT);\n\n    render.enable_texture(0, \"my_rt_resource\", graphics.BUFFER_TYPE_COLOR0_BIT);\n    // draw a predicate with the render target available as texture 0 in the predicate\n    // material shader.\n    render.draw(self.my_pred);\n  },\n});"
+      "ts": "export default defineRenderScript({\n  init() {\n    return { my_pred: render.predicate([hash(\"my_tag\")]) };\n  },\n\n  update(self, dt) {\n    // enable render target by resource id\n    render.set_render_target(\"my_rt_resource\");\n    render.draw(self.my_pred);\n    render.set_render_target(render.RENDER_TARGET_DEFAULT);\n\n    render.enable_texture(0, \"my_rt_resource\", graphics.BUFFER_TYPE_COLOR0_BIT);\n    // draw a predicate with the render target available as texture 0 in the predicate\n    // material shader.\n    render.draw(self.my_pred);\n  },\n});"
     },
     {
       "sourceHash": "49503c29f0de95f3",
-      "ts": "// Or bind a texture handle directly:\nexport default defineRenderScript({\n  init() {\n    return { my_texture_handle: resource.get_texture_info(\"/main/my_texture.texturec\").handle };\n  },\n\n  update(self, dt) {\n    // bind a texture to the texture unit 0\n    render.enable_texture(0, self.my_texture_handle);\n    // bind the same texture to a named sampler\n    render.enable_texture(\"my_texture_sampler\", self.my_texture_handle);\n  },\n});"
+      "ts": "export default defineRenderScript({\n  init() {\n    return { my_texture_handle: resource.get_texture_info(\"/main/my_texture.texturec\").handle };\n  },\n\n  update(self, dt) {\n    // bind a texture to the texture unit 0\n    render.enable_texture(0, self.my_texture_handle);\n    // bind the same texture to a named sampler\n    render.enable_texture(\"my_texture_sampler\", self.my_texture_handle);\n  },\n});"
     }
   ],
   "render.get_height": [
@@ -1436,13 +1436,13 @@
   "render.get_render_target_height": [
     {
       "sourceHash": "f509a9b954573583",
-      "ts": "export default defineRenderScript({\n  init() {\n    // render target buffer parameters\n    const color_params = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    return {\n      target_right: render.render_target(\"right\", {\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params,\n      }),\n    };\n  },\n\n  update(self, dt) {\n    // get the height of the render target color buffer\n    const h = render.get_render_target_height(self.target_right, graphics.BUFFER_TYPE_COLOR0_BIT);\n    // get the height of a render target resource\n    const w = render.get_render_target_height(\"my_rt_resource\", graphics.BUFFER_TYPE_COLOR0_BIT);\n  },\n});"
+      "ts": "export default defineRenderScript({\n  init() {\n    const color_params = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n    };\n    return {\n      target_right: render.render_target(\"right\", {\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params,\n      }),\n    };\n  },\n\n  update(self, dt) {\n    // get the height of the render target color buffer\n    const h = render.get_render_target_height(self.target_right, graphics.BUFFER_TYPE_COLOR0_BIT);\n    // get the height of a render target resource\n    const w = render.get_render_target_height(\"my_rt_resource\", graphics.BUFFER_TYPE_COLOR0_BIT);\n  },\n});"
     }
   ],
   "render.get_render_target_width": [
     {
       "sourceHash": "25c6d828a4ae3706",
-      "ts": "export default defineRenderScript({\n  init() {\n    // render target buffer parameters\n    const color_params = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    return {\n      target_right: render.render_target(\"right\", {\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params,\n      }),\n    };\n  },\n\n  update(self, dt) {\n    // get the width of the render target color buffer\n    const w = render.get_render_target_width(self.target_right, graphics.BUFFER_TYPE_COLOR0_BIT);\n    // get the width of a render target resource\n    const w2 = render.get_render_target_width(\"my_rt_resource\", graphics.BUFFER_TYPE_COLOR0_BIT);\n  },\n});"
+      "ts": "export default defineRenderScript({\n  init() {\n    const color_params = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n    };\n    return {\n      target_right: render.render_target(\"right\", {\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params,\n      }),\n    };\n  },\n\n  update(self, dt) {\n    // get the width of the render target color buffer\n    const w = render.get_render_target_width(self.target_right, graphics.BUFFER_TYPE_COLOR0_BIT);\n    // get the width of a render target resource\n    const w2 = render.get_render_target_width(\"my_rt_resource\", graphics.BUFFER_TYPE_COLOR0_BIT);\n  },\n});"
     }
   ],
   "render.get_width": [
@@ -1476,7 +1476,7 @@
     },
     {
       "sourceHash": "271ca31f05e103b5",
-      "ts": "// How to create a render target with multiple outputs:\nexport default defineRenderScript({\n  init() {\n    // render target buffer parameters\n    const color_params_rgba = {\n      format: graphics.TEXTURE_FORMAT_RGBA,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n    const color_params_float = {\n      format: graphics.TEXTURE_FORMAT_RG32F,\n      width: render.get_window_width(),\n      height: render.get_window_height(),\n      min_filter: graphics.TEXTURE_FILTER_LINEAR,\n      mag_filter: graphics.TEXTURE_FILTER_LINEAR,\n      u_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n      v_wrap: graphics.TEXTURE_WRAP_CLAMP_TO_EDGE,\n    };\n\n    // the engine registers the extra color attachments only when the driver supports them\n    const color1 = graphics.BUFFER_TYPE_COLOR1_BIT;\n    const color2 = graphics.BUFFER_TYPE_COLOR2_BIT;\n    if (color1 === undefined || color2 === undefined) return undefined;\n\n    // Create a render target with three color attachments\n    // Note: No depth buffer is attached here\n    return {\n      my_render_target: render.render_target({\n        [graphics.BUFFER_TYPE_COLOR0_BIT]: color_params_rgba,\n        [color1]: color_params_rgba,\n        [color2]: color_params_float,\n      }),\n      my_pred: render.predicate([hash(\"my_tag\")]),\n    };\n  },\n\n  update(self, dt) {\n    if (self === undefined) return;\n    // 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    // set target so all drawing is done to it\n    render.set_render_target(self.my_render_target);\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n  },\n});"
     },
     {
       "sourceHash": "e39f13af5d65d01d",
@@ -1574,7 +1574,7 @@
     },
     {
       "sourceHash": "bb08db5e232c5b5e",
-      "ts": "// Or set the render target by a render target resource identifier:\nexport default defineRenderScript({\n  init() {\n    return { my_pred: render.predicate([hash(\"my_tag\")]) };\n  },\n\n  update(self, dt) {\n    render.set_render_target(\"my_rt_resource\");\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n\n    // reset the render target to the default backbuffer\n    render.set_render_target(render.RENDER_TARGET_DEFAULT);\n  },\n});"
+      "ts": "export default defineRenderScript({\n  init() {\n    return { my_pred: render.predicate([hash(\"my_tag\")]) };\n  },\n\n  update(self, dt) {\n    // set render target by a render target resource identifier\n    render.set_render_target(\"my_rt_resource\");\n\n    // draw a predicate to the render target\n    render.draw(self.my_pred);\n\n    // reset the render target to the default backbuffer\n    render.set_render_target(render.RENDER_TARGET_DEFAULT);\n  },\n});"
     }
   ],
   "render.set_render_target_size": [
@@ -2203,7 +2203,7 @@
   "sys.set_error_handler": [
     {
       "sourceHash": "7346508f30f50bc9",
-      "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});"
+      "ts": "function boom() {\n  return 10 + \"string\";\n}\n\nexport default defineScript({\n  init() {\n    // Install error handler that just prints the errors\n    sys.set_error_handler((source, message, traceback) => {\n      print(source); //> lua\n      print(message); //> main/my.script:10: attempt to perform arithmetic on a string value\n      print(traceback); //> stack traceback:\n      //>         main/test.script:10: in function 'boom'\n      //>         main/test.script:15: in function <main/my.script:13>\n    });\n    boom();\n  },\n});"
     }
   ],
   "sys.set_render_enabled": [
@@ -2609,11 +2609,11 @@
   "window.set_listener": [
     {
       "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});"
+      "ts": "export default defineScript({\n  init() {\n    window.set_listener((self, event, data) => {\n      if (event === window.WINDOW_EVENT_FOCUS_LOST) {\n        print(\"window.WINDOW_EVENT_FOCUS_LOST\");\n      } else if (event === window.WINDOW_EVENT_FOCUS_GAINED) {\n        print(\"window.WINDOW_EVENT_FOCUS_GAINED\");\n      } else if (event === window.WINDOW_EVENT_ICONFIED) {\n        print(\"window.WINDOW_EVENT_ICONFIED\");\n      } else if (event === window.WINDOW_EVENT_DEICONIFIED) {\n        print(\"window.WINDOW_EVENT_DEICONIFIED\");\n      } else if (event === window.WINDOW_EVENT_RESIZED) {\n        print(\"Window resized: \", data.width, data.height);\n      }\n    });\n  },\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});"
+      "ts": "export default defineScript({\n  init() {\n    window.set_listener((self, event, data) => {\n      if (event === window.WINDOW_EVENT_FOCUS_LOST) {\n        print(\"window.WINDOW_EVENT_FOCUS_LOST\");\n      } else if (event === window.WINDOW_EVENT_FOCUS_GAINED) {\n        print(\"window.WINDOW_EVENT_FOCUS_GAINED\");\n      } else if (event === window.WINDOW_EVENT_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  },\n});"
     }
   ],
   "zlib.deflate": [

package/generated/b2d_fixture.d.ts

@@ -131,10 +131,32 @@ declare global {
      * ```ts
      * const body = b2d.get_body("#collisionobject");
      * if (body !== undefined) {
+     *   // Move a circle shape relative to the body origin.
      *   const circle = b2d.fixture.get_shape(body, 1);
      *   const radius = "radius" in circle ? circle.radius : undefined;
      *   b2d.fixture.set_shape(body, 1, { type: b2d.shape.SHAPE_TYPE_CIRCLE, radius: radius ?? 16, center: vmath.vector3(24, 0, 0) }, true);
-     *   b2d.fixture.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_EDGE, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });
+     *
+     *   // Replace an edge shape's local endpoints.
+     *   b2d.fixture.set_shape(body, 2, {
+     *     type: b2d.shape.SHAPE_TYPE_EDGE,
+     *     v1: vmath.vector3(-32, 0, 0),
+     *     v2: vmath.vector3(32, 0, 0),
+     *   });
+     *
+     *   // Update a box shape using the polygon box convenience format.
+     *   // The existing polygon must already have four vertices.
+     *   b2d.fixture.set_shape(
+     *     body,
+     *     3,
+     *     {
+     *       type: b2d.shape.SHAPE_TYPE_BOX,
+     *       hx: 16,
+     *       hy: 8,
+     *       center: vmath.vector3(0, 20, 0),
+     *       angle: math.rad(30),
+     *     },
+     *     true,
+     *   );
      * }
      * ```
      */

package/generated/b2d_shape.d.ts

@@ -377,10 +377,31 @@ declare global {
      * ```ts
      * const body = b2d.get_body("#collisionobject");
      * if (body !== undefined) {
+     *   // Move a circle shape relative to the body origin.
      *   const circle = b2d.shape.get_shape(body, 1);
      *   const radius = "radius" in circle ? circle.radius : undefined;
      *   b2d.shape.set_shape(body, 1, { type: b2d.shape.SHAPE_TYPE_CIRCLE, radius: radius ?? 16, center: vmath.vector3(24, 0, 0) }, true);
-     *   b2d.shape.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_SEGMENT, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });
+     *
+     *   // Replace a segment shape's local endpoints.
+     *   b2d.shape.set_shape(body, 2, {
+     *     type: b2d.shape.SHAPE_TYPE_SEGMENT,
+     *     v1: vmath.vector3(-32, 0, 0),
+     *     v2: vmath.vector3(32, 0, 0),
+     *   });
+     *
+     *   // Update a box shape using the polygon box convenience format.
+     *   b2d.shape.set_shape(
+     *     body,
+     *     3,
+     *     {
+     *       type: b2d.shape.SHAPE_TYPE_BOX,
+     *       hx: 16,
+     *       hy: 8,
+     *       center: vmath.vector3(0, 20, 0),
+     *       angle: math.rad(30),
+     *     },
+     *     true,
+     *   );
      * }
      * ```
      */

package/generated/compute.d.ts

@@ -47,7 +47,23 @@ declare global {
      * @param constants - Constant options keyed by constant name. Partial updates are supported.
      * @example
      * ```ts
-     * compute.set_constants("/my_compute.computec", { tint: { value: vmath.vector4(1, 0, 0, 1) } });
+     * // Set a shader constant in a compute program
+     * export default defineScript({
+     *   init() {
+     *     return { my_view_proj: vmath.matrix4() };
+     *   },
+     *
+     *   update(self) {
+     *     // update the 'tint' constant
+     *     compute.set_constants("/my_compute.computec", {
+     *       tint: { value: vmath.vector4(1, 0, 0, 1) },
+     *     });
+     *     // change the type of the 'view_proj' constant to CONSTANT_TYPE_USER_MATRIX4 so the renderer can set our custom data
+     *     compute.set_constants("/my_compute.computec", {
+     *       view_proj: { value: self.my_view_proj, type: material.CONSTANT_TYPE_USER_MATRIX4 },
+     *     });
+     *   },
+     * });
      * ```
      */
     function set_constants(path: Hash | string, constants: LuaMap<string | Hash, material.constant_options> | Record<string, material.constant_options>): void;
@@ -70,7 +86,18 @@ declare global {
      * @param textures - A table keyed by sampler name with texture resources as values.
      * @example
      * ```ts
-     * compute.set_textures("/my_compute.computec", { my_texture: resource.texture() });
+     * // Set a texture in a compute program from a resource
+     * export default defineScript({
+     *   // Never call `go.property` yourself: the transpiler emits the chunk-scope
+     *   // registration from this field, and only this field types the property onto `self`.
+     *   properties: { my_texture: resource.texture() },
+     *
+     *   init(self) {
+     *     compute.set_textures("/my_compute.computec", {
+     *       my_texture: self.my_texture,
+     *     });
+     *   },
+     * });
      * ```
      */
     function set_textures(path: Hash | string, textures: LuaMap<string | Hash, string | Hash> | Record<string, string | Hash>): void;

package/generated/go.d.ts

@@ -316,7 +316,7 @@ declare global {
      * // Delete the script's own game object.
      * go.delete();
      * // Delete a game object with the id "my_game_object".
-     * const id = go.get_id("my_game_object");
+     * const id = go.get_id("my_game_object"); // retrieve the id of the game object to be deleted
      * go.delete(id);
      * // Delete a list of game objects.
      * const ids = [hash("/my_object_1"), hash("/my_object_2"), hash("/my_object_3")];
@@ -328,7 +328,7 @@ declare global {
      * // Delete the script's own game object and its children.
      * go.delete(true);
      * // Delete a game object with the id "my_game_object" and its children.
-     * const id = go.get_id("my_game_object");
+     * const id = go.get_id("my_game_object"); // retrieve the id of the game object to be deleted
      * go.delete(id, true);
      * // Delete a list of game objects and their children.
      * const ids = [hash("/my_object_1"), hash("/my_object_2"), hash("/my_object_3")];

package/generated/gui.d.ts

@@ -1490,15 +1490,13 @@ declare global {
      * // How to play a particle fx when a gui node is created.
      * // The callback receives the gui node, the hash of the id
      * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.
-     * function emitter_state_change(self: unknown, node: unknown, emitter: unknown, state: unknown) {
-     *   if (emitter === hash("exhaust") && state === particlefx.EMITTER_STATE_POSTSPAWN) {
-     *     // exhaust is done spawning particles...
-     *   }
-     * }
-     *
      * export default defineGuiScript({
      *   init(self) {
-     *     gui.play_particlefx(gui.get_node("particlefx"), emitter_state_change);
+     *     gui.play_particlefx(gui.get_node("particlefx"), (self, node, emitter, state) => {
+     *       if (emitter === hash("exhaust") && state === particlefx.EMITTER_STATE_POSTSPAWN) {
+     *         // exhaust is done spawning particles...
+     *       }
+     *     });
      *   },
      * });
      * ```

package/generated/material.d.ts

@@ -310,7 +310,16 @@ declare global {
      * @returns Shader constant information.
      * @example
      * ```ts
-     * const constants = material.get_constants(resource.material("/my_material.materialc"));
+     * // Get the shader constants from a material specified as a resource property
+     * export default defineScript({
+     *   // Never call `go.property` yourself: the transpiler emits the chunk-scope
+     *   // registration from this field, and only this field types the property onto `self`.
+     *   properties: { my_material: resource.material() },
+     *
+     *   init(self) {
+     *     const constants = material.get_constants(self.my_material);
+     *   },
+     * });
      * ```
      */
     function get_constants(path: Hash | string): material.constant_info[];
@@ -322,7 +331,16 @@ declare global {
      * @returns texture sampler information
      * @example
      * ```ts
-     * const samplers = material.get_samplers(resource.material("/my_material.materialc"));
+     * // Get the texture samplers from a material specified as a resource property
+     * export default defineScript({
+     *   // Never call `go.property` yourself: the transpiler emits the chunk-scope
+     *   // registration from this field, and only this field types the property onto `self`.
+     *   properties: { my_material: resource.material() },
+     *
+     *   init(self) {
+     *     const samplers = material.get_samplers(self.my_material);
+     *   },
+     * });
      * ```
      */
     function get_samplers(path: Hash | string): material.sampler_info[];
@@ -333,7 +351,16 @@ declare global {
      * @returns material texture information
      * @example
      * ```ts
-     * const textures = material.get_textures(resource.material("/my_material.materialc"));
+     * // Get the textures from a material specified as a resource property
+     * export default defineScript({
+     *   // Never call `go.property` yourself: the transpiler emits the chunk-scope
+     *   // registration from this field, and only this field types the property onto `self`.
+     *   properties: { my_material: resource.material() },
+     *
+     *   init(self) {
+     *     const textures = material.get_textures(self.my_material);
+     *   },
+     * });
      * ```
      */
     function get_textures(path: Hash | string): material.texture_info[];
@@ -345,7 +372,16 @@ declare global {
      * @returns vertex attribute information
      * @example
      * ```ts
-     * const vertex_attributes = material.get_vertex_attributes(resource.material("/my_material.materialc"));
+     * // Get the vertex attributes from a material specified as a resource property
+     * export default defineScript({
+     *   // Never call `go.property` yourself: the transpiler emits the chunk-scope
+     *   // registration from this field, and only this field types the property onto `self`.
+     *   properties: { my_material: resource.material() },
+     *
+     *   init(self) {
+     *     const vertex_attributes = material.get_vertex_attributes(self.my_material);
+     *   },
+     * });
      * ```
      */
     function get_vertex_attributes(path: Hash | string): material.vertex_attribute_info[];
@@ -356,7 +392,27 @@ declare global {
      * @param constants - Shader constant updates keyed by constant name. Partial updates are supported.
      * @example
      * ```ts
-     * material.set_constants(resource.material("/my_material.materialc"), { tint: { value: vmath.vector4(1, 0, 0, 1) } });
+     * // Set a shader constant in a material specified as a resource property
+     * export default defineScript({
+     *   // Never call `go.property` yourself: the transpiler emits the chunk-scope
+     *   // registration from this field, and only this field types the property onto `self`.
+     *   properties: { my_material: resource.material() },
+     *
+     *   init() {
+     *     return { my_view_proj: vmath.matrix4() };
+     *   },
+     *
+     *   update(self) {
+     *     // update the 'tint' constant
+     *     material.set_constants(self.my_material, {
+     *       tint: { value: vmath.vector4(1, 0, 0, 1) },
+     *     });
+     *     // change the type of the 'view_proj' constant to CONSTANT_TYPE_USER_MATRIX4 so the renderer can set our custom data
+     *     material.set_constants(self.my_material, {
+     *       view_proj: { value: self.my_view_proj, type: material.CONSTANT_TYPE_USER_MATRIX4 },
+     *     });
+     *   },
+     * });
      * ```
      */
     function set_constants(path: Hash | string, constants: LuaMap<string | Hash, material.constant_options> | Record<string, material.constant_options>): void;
@@ -368,7 +424,18 @@ declare global {
      * @param samplers - Sampler updates keyed by sampler name. Partial updates are supported.
      * @example
      * ```ts
-     * material.set_samplers(resource.material("/my_material.materialc"), { texture_sampler: { u_wrap: graphics.TEXTURE_WRAP_REPEAT, v_wrap: graphics.TEXTURE_WRAP_MIRRORED_REPEAT } });
+     * // Configures a sampler in a material specified as a resource property
+     * export default defineScript({
+     *   // Never call `go.property` yourself: the transpiler emits the chunk-scope
+     *   // registration from this field, and only this field types the property onto `self`.
+     *   properties: { my_material: resource.material() },
+     *
+     *   init(self) {
+     *     material.set_samplers(self.my_material, {
+     *       texture_sampler: { u_wrap: graphics.TEXTURE_WRAP_REPEAT, v_wrap: graphics.TEXTURE_WRAP_MIRRORED_REPEAT },
+     *     });
+     *   },
+     * });
      * ```
      */
     function set_samplers(path: Hash | string, samplers: LuaMap<string | Hash, material.sampler_options> | Record<string, material.sampler_options>): void;
@@ -379,7 +446,18 @@ declare global {
      * @param textures - A table keyed by sampler name with texture resources as values.
      * @example
      * ```ts
-     * material.set_textures(resource.material("/my_material.materialc"), { my_texture: resource.texture() });
+     * // Set a texture in a material from a resource
+     * export default defineScript({
+     *   // Never call `go.property` yourself: the transpiler emits the chunk-scope
+     *   // registrations from this field, and only this field types them onto `self`.
+     *   properties: { my_material: resource.material(), my_texture: resource.texture() },
+     *
+     *   init(self) {
+     *     material.set_textures(self.my_material, {
+     *       my_texture: self.my_texture,
+     *     });
+     *   },
+     * });
      * ```
      */
     function set_textures(path: Hash | string, textures: LuaMap<string | Hash, string | Hash> | Record<string, string | Hash>): void;
@@ -390,7 +468,19 @@ declare global {
      * @param attributes - Vertex attributes keyed by name, or an array with explicit `name` fields. Partial updates are supported.
      * @example
      * ```ts
-     * material.set_vertex_attributes(resource.material("/my_material.materialc"), { tint_attribute: { value: vmath.vector4(1, 0, 0, 1), semantic_type: graphics.SEMANTIC_TYPE_COLOR } });
+     * // Configures a vertex attribute in a material specified as a resource property
+     * export default defineScript({
+     *   // Never call `go.property` yourself: the transpiler emits the chunk-scope
+     *   // registration from this field, and only this field types the property onto `self`.
+     *   properties: { my_material: resource.material() },
+     *
+     *   init(self) {
+     *     material.set_vertex_attributes(self.my_material, {
+     *       tint_attribute: { value: vmath.vector4(1, 0, 0, 1), semantic_type: graphics.SEMANTIC_TYPE_COLOR },
+     *       weights: { value: vmath.vector4(0, 1, 0, 0), semantic_type: graphics.SEMANTIC_TYPE_NONE },
+     *     });
+     *   },
+     * });
      * ```
      */
     function set_vertex_attributes(path: Hash | string, attributes: LuaMap<string | Hash, material.vertex_attribute_options> | Record<string, material.vertex_attribute_options> | material.named_vertex_attribute_options[]): void;