@defold-typescript/types 0.52.0 → 0.54.0

package/dist/src/index.d.ts

@@ -0,0 +1,18 @@
+export { type ApiAvailability, type ApiMigrationCatalog, type ApiMigrationEntry, type ApiSymbolIdentity, type AvailabilityLabel, type AvailabilityLabelKind, type AvailabilityLabelOptions, applyMigrationOverlay, availabilityLabel, type Box2dBackend, collectSymbolIdentities, deriveAvailabilityMatrix, groupByLogicalName, isSignatureTransition, type LogicalNameGroup, normalizedFunctionSignature, signatureTransitionNames, symbolIdentityKey, symbolNameKey, type VersionSurface, validateAvailability, } from "./api-availability";
+export type { ApiFunction, ApiModule, ApiParameter, ApiVariable, SkipOverloadRule, } from "./api-doc";
+export { parseDefoldApiDoc, withholdOverloads } from "./api-doc";
+export { DEFOLD_TYPE_MAP, type Hash, type Matrix4, type Quaternion, type Url, type Vector, type Vector3, type Vector4, } from "./core-types";
+export { type DocCommentParts, type ExampleSegment, type ExampleSegmentation, examplesHtmlToMarkdown, htmlToCodeText, htmlToDocText, renderDocComment, segmentExampleRegions, splitExampleSources, } from "./doc-comment";
+export { defineEditorScript, type EditorCommand, type EditorScriptModule, } from "./editor";
+export { type EmitOptions, emitDeclarations, emitSymbolSignatures, firstSlotAlternativeOf, routeTypeDeclarations, type SlotType, type SlotTypes, type SymbolSignature, TS_IDENTIFIER, TS_RESERVED_NAMES, } from "./emit-dts";
+export { ENGINE_TYPE_NAME_OVERRIDES, engineTypeName } from "./engine-type-name";
+export { hashExampleSource, lookupExampleSegments, lookupExampleTranslations, lookupTranslation, proseLuaFences, type Translation, type TranslationStore, translateProseFences, } from "./example-store";
+export { type EngineIndexBaseRow, engineIndexBaseRows, engineIndexBaseTable, } from "./index-base-table";
+export { appendNotes, INDEX_SLOT_CLASSIFICATIONS, type IndexSlotClass, type IndexSlotClassification, type LibraryIndexSlotClassifications, libraryIndexBaseNotes, parseLibraryIndexSlotClassifications, withIndexBaseNotes, withLibraryIndexBaseNotes, } from "./index-slot-classifications";
+export { hasTopLevelUnion, luaMultiReturn, needsArrayParens, varargElementType, } from "./library-signature";
+export { defineGuiScript, defineRenderScript, defineScript, type GuiScriptHooks, type GuiScriptHooksWithProperties, type InputAction, type InputTouch, type RenderScriptHooks, type RenderScriptHooksWithProperties, SCRIPT_HOOK_NAMES, type ScriptHookName, type ScriptHooks, type ScriptHooksWithProperties, type ScriptProperties, type ScriptPropertiesOf, type ScriptProperty, } from "./lifecycle";
+export { LUALS_VARARG_TOKEN, type LualsLeafResolver, type LualsMapResult, type LualsPosition, mapLualsCallSignatureExpression, mapLualsExpression, matchBracket, splitTopLevel, } from "./luals-type-expr";
+export { type ModuleWrapOptions, type WrapOptions, wrapAsAmbientGlobal, wrapAsGlobalTableModule, wrapAsModule, } from "./publish-dts";
+export { lookupSignature, type SignatureOverride, type SignatureStore, signatureArmsFor, signatureStoreFor, } from "./signature-store";
+export { classifyUrlParameter, collectParameterSlots, collectUrlParameterSlots, parameterTypesSatisfyClass, REQUIRED_TYPES, type SocketScope, slotAcceptsForeignSocket, type UrlParameterClass, type UrlParameterEntry, type UrlParameterSlot, type UrlParameterSource, type UrlParameterTable, } from "./url-parameters";
+//# sourceMappingURL=index.d.ts.map

package/examples/translations.json

@@ -80,19 +80,19 @@
   "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});"
+      "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});"
+      "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});"
+      "ts": "// Join two bodies at matching local pivots and explicitly destroy the\n// constraint when the script is finalized:\nexport default defineScript({\n  init() {\n    const body_a = bullet3d.get_rigid_body(\"/body_a#collisionobject\");\n    const body_b = bullet3d.get_rigid_body(\"/body_b#collisionobject\");\n    let constraint: bullet3d.constraint.BtTypedConstraint | undefined;\n    if (body_a !== undefined) {\n      constraint = bullet3d.constraint.create_point_to_point(body_a, body_b, {\n        pivot_a: vmath.vector3(0.5, 0, 0),\n        pivot_b: vmath.vector3(-0.5, 0, 0),\n      });\n    }\n    return { constraint };\n  },\n\n  final(self) {\n    if (self.constraint !== undefined && bullet3d.constraint.is_valid(self.constraint)) {\n      bullet3d.constraint.destroy(self.constraint);\n    }\n  },\n});"
     }
   ],
   "bullet3d.get_gameobject_id": [
@@ -930,7 +930,7 @@
     },
     {
       "sourceHash": "877de2c1daa19e58",
-      "ts": "export default defineScript({\n  init() {\n    const text = go.get<label.properties>()(\"#label\", \"text\");\n    print(text);\n  },\n});"
+      "ts": "export default defineScript({\n  init() {\n    const text = go.get<label.Properties>()(\"#label\", \"text\");\n    print(text);\n  },\n});"
     }
   ],
   "label.set_text": [
@@ -940,7 +940,7 @@
     },
     {
       "sourceHash": "2ac0aeb70ccdc6bf",
-      "ts": "export default defineScript({\n  init() {\n    go.set<label.properties>()(\"#label\", \"text\", \"Hello World!\");\n  },\n});"
+      "ts": "export default defineScript({\n  init() {\n    go.set<label.Properties>()(\"#label\", \"text\", \"Hello World!\");\n  },\n});"
     }
   ],
   "liveupdate.add_mount": [
@@ -1687,7 +1687,7 @@
     },
     {
       "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});"
+      "ts": "// Create a texture resource asyncronously with a buffer and a callback\nfunction callback(self: unknown, request_id: number, result: resource.TextureCreationResult) {\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": [
@@ -1703,7 +1703,7 @@
   "resource.get_buffer": [
     {
       "sourceHash": "ed7d361c7f5d2e35",
-      "ts": "// How to get the data from a buffer\nexport default defineScript({\n  init() {\n    const res_path = go.get<mesh.properties>()(\"#mesh\", \"vertices\");\n    const buf = resource.get_buffer(res_path);\n    const stream_positions = buffer.get_stream(buf, \"position\");\n\n    for (let i = 0; i < stream_positions.length(); i++) {\n      print(i, stream_positions[i]);\n    }\n  },\n});"
+      "ts": "// How to get the data from a buffer\nexport default defineScript({\n  init() {\n    const res_path = go.get<mesh.Properties>()(\"#mesh\", \"vertices\");\n    const buf = resource.get_buffer(res_path);\n    const stream_positions = buffer.get_stream(buf, \"position\");\n\n    for (let i = 0; i < stream_positions.length(); i++) {\n      print(i, stream_positions[i]);\n    }\n  },\n});"
     }
   ],
   "resource.get_render_target_info": [
@@ -1719,7 +1719,7 @@
   "resource.get_text_metrics": [
     {
       "sourceHash": "d63156dd59513358",
-      "ts": "export default defineScript({\n  init() {\n    const font = go.get<label.properties>()(\"#label\", \"font\");\n    const metrics = resource.get_text_metrics(font, \"The quick brown fox\\n jumps over the lazy dog\");\n    pprint(metrics);\n  },\n});"
+      "ts": "export default defineScript({\n  init() {\n    const font = go.get<label.Properties>()(\"#label\", \"font\");\n    const metrics = resource.get_text_metrics(font, \"The quick brown fox\\n jumps over the lazy dog\");\n    pprint(metrics);\n  },\n});"
     }
   ],
   "resource.get_texture_info": [
@@ -1761,7 +1761,7 @@
   "resource.set": [
     {
       "sourceHash": "fd3445f93ecdd85e",
-      "ts": "// Assuming the folder \"/res\" is added to the project custom resources:\n// load a texture resource and set it on a sprite\nconst buffer = resource.load(\"/res/new.texturec\");\nresource.set(go.get<sprite.properties>()(\"#sprite\", \"texture0\"), buffer);"
+      "ts": "// Assuming the folder \"/res\" is added to the project custom resources:\n// load a texture resource and set it on a sprite\nconst buffer = resource.load(\"/res/new.texturec\");\nresource.set(go.get<sprite.Properties>()(\"#sprite\", \"texture0\"), buffer);"
     }
   ],
   "resource.set_atlas": [
@@ -1777,21 +1777,21 @@
   "resource.set_buffer": [
     {
       "sourceHash": "a52fd8ac7453f601",
-      "ts": "// How to set the data from a buffer\nfunction fill_stream(stream: { [index: number]: number }, verts: number[]) {\n  verts.forEach((value, key) => {\n    stream[key] = value;\n  });\n}\n\nexport default defineScript({\n  init() {\n    const res_path = go.get<mesh.properties>()(\"#mesh\", \"vertices\");\n\n    const positions = [\n      1, -1, 0,\n      1, 1, 0,\n      -1, -1, 0,\n    ];\n\n    const num_verts = positions.length / 3;\n\n    // create a new buffer\n    let buf = buffer.create(num_verts, [{ name: hash(\"position\"), type: buffer.VALUE_TYPE_FLOAT32, count: 3 }]);\n\n    buf = resource.get_buffer(res_path);\n    const stream_positions = buffer.get_stream(buf, \"position\");\n\n    fill_stream(stream_positions, positions);\n\n    resource.set_buffer(res_path, buf);\n  },\n});"
+      "ts": "// How to set the data from a buffer\nfunction fill_stream(stream: { [index: number]: number }, verts: number[]) {\n  verts.forEach((value, key) => {\n    stream[key] = value;\n  });\n}\n\nexport default defineScript({\n  init() {\n    const res_path = go.get<mesh.Properties>()(\"#mesh\", \"vertices\");\n\n    const positions = [\n      1, -1, 0,\n      1, 1, 0,\n      -1, -1, 0,\n    ];\n\n    const num_verts = positions.length / 3;\n\n    // create a new buffer\n    let buf = buffer.create(num_verts, [{ name: hash(\"position\"), type: buffer.VALUE_TYPE_FLOAT32, count: 3 }]);\n\n    buf = resource.get_buffer(res_path);\n    const stream_positions = buffer.get_stream(buf, \"position\");\n\n    fill_stream(stream_positions, positions);\n\n    resource.set_buffer(res_path, buf);\n  },\n});"
     }
   ],
   "resource.set_texture": [
     {
       "sourceHash": "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    // 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});"
+      "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    // 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});"
+      "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    // 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});"
+      "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",
@@ -2117,11 +2117,11 @@
     },
     {
       "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);"
+      "ts": "// Load binary data from a custom project resource and update a texture resource:\nfunction my_callback(self: unknown, request_id: number, result: sys.LoadBufferResult) {\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});"
+      "ts": "// Load binary data from non-custom resource files on disk:\nfunction my_callback(self: unknown, request_id: number, result: sys.LoadBufferResult) {\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": [