@defold-typescript/types 0.25.0 → 0.26.0

package/api-signatures.json

@@ -1,6 +1,6 @@
 {
   "versions": {
-    "1.13.0": {
+    "1.13.1": {
       "b2d\u0000FUNCTION\u0000b2d.get_body\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false}]->[{\"types\":[\"b2Body\"],\"isOptional\":false}]": "function get_body(url: string | Hash | Url): Opaque<\"b2Body\">;",
       "b2d\u0000FUNCTION\u0000b2d.get_version\u0000[]->[{\"types\":[\"table\"],\"isOptional\":false}]": "function get_version(): { version: number; major: number; middle: number; minor: number };",
       "b2d\u0000FUNCTION\u0000b2d.get_world\u0000[]->[{\"types\":[\"b2World\"],\"isOptional\":false}]": "function get_world(): Opaque<\"b2World\">;",
@@ -369,6 +369,7 @@
       "collectionproxy\u0000CONSTANT\u0000collectionproxy.RESULT_LOADING\u0000": "const RESULT_LOADING: number & { readonly __brand: \"collectionproxy.RESULT_LOADING\" };",
       "collectionproxy\u0000CONSTANT\u0000collectionproxy.RESULT_NOT_EXCLUDED\u0000": "const RESULT_NOT_EXCLUDED: number & { readonly __brand: \"collectionproxy.RESULT_NOT_EXCLUDED\" };",
       "collectionproxy\u0000FUNCTION\u0000collectionproxy.get_resources\u0000[{\"types\":[\"url\"],\"isOptional\":false}]->[{\"types\":[\"table\"],\"isOptional\":false}]": "function get_resources(collectionproxy: Url): Hash[];",
+      "collectionproxy\u0000FUNCTION\u0000collectionproxy.load\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"nil\",\"table\"],\"isOptional\":false},{\"types\":[\"function(self, message_id, message, sender)\"],\"isOptional\":false}]->[]": "function load(url: string | Hash | Url, options: Record<string | number, unknown> | undefined, callback: (self: unknown, message_id: unknown, message: unknown, sender: unknown) => void): void;",
       "collectionproxy\u0000FUNCTION\u0000collectionproxy.set_collection\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":true},{\"types\":[\"nil\",\"string\"],\"isOptional\":true}]->[{\"types\":[\"boolean\"],\"isOptional\":false},{\"types\":[\"number\"],\"isOptional\":false}]": "function set_collection(url?: string | Hash | Url, prototype?: string): LuaMultiReturn<[boolean, number]>;",
       "compute\u0000FUNCTION\u0000compute.get_constants\u0000[{\"types\":[\"hash\",\"string\"],\"isOptional\":false}]->[{\"types\":[\"table\"],\"isOptional\":false}]": "function get_constants(path: Hash | string): { name: Hash; type: number; value: Vector4 | Matrix4 }[];",
       "compute\u0000FUNCTION\u0000compute.get_samplers\u0000[{\"types\":[\"hash\",\"string\"],\"isOptional\":false}]->[{\"types\":[\"table\"],\"isOptional\":false}]": "function get_samplers(path: Hash | string): { name: Hash; u_wrap: number; v_wrap: number; min_filter: number; mag_filter: number; max_anisotropy: number }[];",
@@ -797,7 +798,7 @@
       "gui\u0000FUNCTION\u0000gui.reset_material\u0000[{\"types\":[\"node\"],\"isOptional\":false}]->[]": "function reset_material(node: Opaque<\"node\">): void;",
       "gui\u0000FUNCTION\u0000gui.reset_nodes\u0000[]->[]": "function reset_nodes(): void;",
       "gui\u0000FUNCTION\u0000gui.screen_to_local\u0000[{\"types\":[\"node\"],\"isOptional\":false},{\"types\":[\"vector3\"],\"isOptional\":false}]->[{\"types\":[\"vector3\"],\"isOptional\":false}]": "function screen_to_local(node: Opaque<\"node\">, screen_position: Vector3): Vector3;",
-      "gui\u0000FUNCTION\u0000gui.set\u0000[{\"types\":[\"node\",\"url\"],\"isOptional\":false},{\"types\":[\"constant\",\"hash\",\"string\"],\"isOptional\":false},{\"types\":[\"number\",\"quaternion\",\"vector3\",\"vector4\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":true}]->[]": "function set(node: Opaque<\"node\"> | Url, property: string | Hash | Opaque<\"constant\">, value: number | Vector4 | Vector3 | Quaternion, options?: { index?: number; key?: Hash }): void;",
+      "gui\u0000FUNCTION\u0000gui.set\u0000[{\"types\":[\"node\",\"url\"],\"isOptional\":false},{\"types\":[\"constant\",\"hash\",\"string\"],\"isOptional\":false},{\"types\":[\"nil\",\"number\",\"quaternion\",\"vector3\",\"vector4\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":true}]->[]": "function set(node: Opaque<\"node\"> | Url, property: string | Hash | Opaque<\"constant\">, value?: number | Vector4 | Vector3 | Quaternion, options?: { index?: number; key?: Hash }): void;",
       "gui\u0000FUNCTION\u0000gui.set_adjust_mode\u0000[{\"types\":[\"node\"],\"isOptional\":false},{\"types\":[\"constant\"],\"isOptional\":false}]->[]": "function set_adjust_mode(node: Opaque<\"node\">, adjust_mode: Opaque<\"constant\">): void;",
       "gui\u0000FUNCTION\u0000gui.set_alpha\u0000[{\"types\":[\"node\"],\"isOptional\":false},{\"types\":[\"number\"],\"isOptional\":false}]->[]": "function set_alpha(node: Opaque<\"node\">, alpha: number): void;",
       "gui\u0000FUNCTION\u0000gui.set_blend_mode\u0000[{\"types\":[\"node\"],\"isOptional\":false},{\"types\":[\"constant\"],\"isOptional\":false}]->[]": "function set_blend_mode(node: Opaque<\"node\">, blend_mode: Opaque<\"constant\">): void;",

package/api-targets.json

@@ -1,9 +1,9 @@
 {
   "targets": [
     {
-      "id": "defold-1.13.0",
+      "id": "defold-1.13.1",
       "default": true,
-      "fixturesDir": "fixtures/defold-1.13.0",
+      "fixturesDir": "fixtures/defold-1.13.1",
       "generatedDir": "generated",
       "coreTypesImport": "../src/core-types",
       "source": null,
@@ -251,6 +251,7 @@
           "skipFunctions": [
             "command",
             "http.",
+            "image.",
             "json.",
             "localization.",
             "pprint",
@@ -266,6 +267,12 @@
           "mapType": "editor",
           "skipFunctions": ["server.local_url", "server.port", "server.route", "server.url"]
         },
+        {
+          "namespace": "image",
+          "fixture": "editor_image_doc.json",
+          "outFile": "editor-vm/image.d.ts",
+          "mapType": "editor"
+        },
         {
           "namespace": "json",
           "fixture": "editor_json_doc.json",

package/generated/collectionproxy.d.ts

@@ -41,6 +41,28 @@ declare global {
      * ```
      */
     function get_resources(collectionproxy: Url): Hash[];
+    /**
+     * Loads the collection referenced by a collection proxy. The proxy is also
+     * initialized and the callback receives `proxy_loading`, `proxy_ready`, or
+     * `proxy_error` messages.
+     *
+     * @param url - the collection proxy component
+     * @param options - options table, currently unused
+     * @param callback - callback
+     * @example
+     * ```ts
+     * collectionproxy.load("#proxy", undefined, (self, message_id, message, sender) => {
+     *   if (message_id === hash("proxy_ready")) {
+     *     print("proxy is ready");
+     *   } else if (message_id === hash("proxy_loading")) {
+     *     print("progress", message.progress);
+     *   } else if (message_id === hash("proxy_error")) {
+     *     print("error", message.code);
+     *   }
+     * });
+     * ```
+     */
+    function load(url: string | Hash | Url, options: Record<string | number, unknown> | undefined, callback: (self: unknown, message_id: unknown, message: unknown, sender: unknown) => void): void;
     /**
      * The collection should be loaded by the collection proxy.
      * Setting the collection to "nil" will revert it back to the original collection.

package/generated/editor-vm/http.d.ts

@@ -8,8 +8,8 @@ declare global {
      * Perform an HTTP request
      *
      * @param url - request URL
-     * @param opts - Additional request options, a table with the following keys:`method string`request method, defaults to `"GET"``headers table`request headers, a table with string keys and values`body string`request body`as string`response body converter, either `"string"` or `"json"`
-     * @returns HTTP response, a table with the following keys:`status integer`response code`headers table`response headers, a table where each key is a lower-cased string, and each value is either a string or an array of strings if the header was repeated`body string, any, nil`response body, present only when `as` option was provided, either a string or a parsed json value
+     * @param opts - Additional request options, a table with the following keys:`method string`request method, defaults to `"GET"``headers table`request headers, a table with string keys and values`body string`request body`as string`response body converter, either `"string"` or `"json"`; mutually exclusive with `path``path string`destination file path, resolved against project root if relative; mutually exclusive with `as`
+     * @returns HTTP response, a table with the following keys:`status integer`response code`headers table`response headers, a table where each key is a lower-cased string, and each value is either a string or an array of strings if the header was repeated`body string, any, nil`response body, present only when `as` option was provided, either a string or a parsed json value`path string, nil`resolved absolute destination path, present only after a successful response was written when the `path` option was provided
      */
     function request(url: string, opts?: Record<string | number, unknown>): Record<string | number, unknown>;
     namespace server {

package/generated/editor-vm/image.d.ts

@@ -0,0 +1,48 @@
+/** @noSelfInFile */
+declare global {
+  /**
+   * Editor scripting documentation
+   */
+  namespace image {
+    /**
+     * Load an image file for reading
+     *
+     * @param path - External file path, resolved against project root if relative
+     * @returns image userdata
+     */
+    function load_file(path: string): unknown;
+    /**
+     * Return the color of a pixel from a loaded image.
+     * Coordinates are 1-based, with `1, 1` at the top-left corner.
+     *
+     * @param image - image userdata returned by `image.load_file()`
+     * @param x - 1-based horizontal pixel coordinate
+     * @param y - 1-based vertical pixel coordinate
+     */
+    function pixel(image: unknown, x: number, y: number): LuaMultiReturn<[number, number, number, number]>;
+    /**
+     * Iterate over pixels in a loaded image.
+     * The iterator returns pixels row by row from top-left to bottom-right. Coordinates are 1-based.
+     *
+     * @param image - image userdata returned by `image.load_file()`
+     * @returns iterator function returning `x, y, r, g, b, a` for each pixel
+     * @example
+     * ```lua
+     * local img = image.load_file("assets/source.png")
+     * local width, height = image.size(img)
+     * for x, y, r, g, b, a in image.pixels(img) do
+     *   print(x, y, r, g, b, a)
+     * end
+     * ```
+     */
+    function pixels(image: unknown): (...args: unknown[]) => unknown;
+    /**
+     * Return the width and height of a loaded image.
+     *
+     * @param image - image userdata returned by `image.load_file()`
+     */
+    function size(image: unknown): LuaMultiReturn<[number, number]>;
+  }
+}
+
+export {};

package/generated/editor.d.ts

@@ -60,35 +60,35 @@ declare global {
      */
     function browse(url: string): void;
     /**
-     * Check if `editor.tx.add()` (as well as `editor.tx.clear()` and `editor.tx.remove()`) transaction with this property won't throw an error
+     * Check whether this list property supports add, clear, and remove operations on the supplied node.
      *
      * @param node - Either resource path (e.g. `"/main/game.script"`), or internal node id passed to the script by the editor
      * @param property - Either `"path"`, `"text"`, or a property from the Outline view (hover the label to see its editor script name)
      */
     function can_add(node: string | Opaque<"userdata">, property: string): boolean;
     /**
-     * Check if you can get this property so `editor.get()` won't throw an error
+     * Check whether this property is exposed for reading on the supplied node or resource.
      *
      * @param node - Either resource path (e.g. `"/main/game.script"`), or internal node id passed to the script by the editor
      * @param property - Either `"path"`, `"text"`, or a property from the Outline view (hover the label to see its editor script name)
      */
     function can_get(node: string | Opaque<"userdata">, property: string): boolean;
     /**
-     * Check if `editor.tx.reorder()` transaction with this property won't throw an error
+     * Check whether this list property supports reordering on the supplied node.
      *
      * @param node - Either resource path (e.g. `"/main/game.script"`), or internal node id passed to the script by the editor
      * @param property - Either `"path"`, `"text"`, or a property from the Outline view (hover the label to see its editor script name)
      */
     function can_reorder(node: string | Opaque<"userdata">, property: string): boolean;
     /**
-     * Check if `editor.tx.reset()` transaction with this property won't throw an error
+     * Check whether this property supports reset on the supplied node.
      *
      * @param node - Either resource path (e.g. `"/main/game.script"`), or internal node id passed to the script by the editor
      * @param property - Either `"path"`, `"text"`, or a property from the Outline view (hover the label to see its editor script name)
      */
     function can_reset(node: string | Opaque<"userdata">, property: string): boolean;
     /**
-     * Check if `editor.tx.set()` transaction with this property won't throw an error
+     * Check whether this property is exposed for setting on the supplied node.
      *
      * @param node - Either resource path (e.g. `"/main/game.script"`), or internal node id passed to the script by the editor
      * @param property - Either `"path"`, `"text"`, or a property from the Outline view (hover the label to see its editor script name)
@@ -172,6 +172,11 @@ declare global {
      * @returns A table with the following keys: `path string` resolved file path `exists boolean` whether there is a file system entry at the path `is_file boolean` whether the path corresponds to a file `is_directory boolean` whether the path corresponds to a directory
      */
     function external_file_attributes(path: string): Record<string | number, unknown>;
+    /**
+     * Download the latest version of the project library dependencies and reload library-provided editor scripts.
+     * This function may replace library-provided editor commands, hooks, routes, and UI contributed by editor scripts, so it should typically be the last operation performed by a command.
+     */
+    function fetch_libraries(): void;
     /**
      * Get a value of a node property inside the editor.
      * Some properties might be read-only, and some might be unavailable in different contexts, so you should use `editor.can_get()` before reading them and `editor.can_set()` before making the editor set them.
@@ -453,7 +458,7 @@ declare global {
       /**
        * Check box with a label
        *
-       * @param props - Optional props: `value boolean`determines if the checkbox should appear checked`on_value_changed function`change callback, will receive the new value`text string, message`the text, either a string or a localization message`text_alignment string`text alignment within paragraph bounds; either:
+       * @param props - Optional props: `value boolean`determines if the checkbox should appear checked`on_value_changed function`change callback, will receive the new value`indeterminate boolean`determines if the checkbox should appear in the mixed state`text string, message`the text, either a string or a localization message`text_alignment string`text alignment within paragraph bounds; either:
        * - `editor.ui.TEXT_ALIGNMENT.LEFT`
        * - `editor.ui.TEXT_ALIGNMENT.CENTER`
        * - `editor.ui.TEXT_ALIGNMENT.RIGHT`
@@ -482,7 +487,7 @@ declare global {
       /**
        * Dialog component, a top-level window component that can't be used as a child of other components
        *
-       * @param props - Required props: `title string, message`OS dialog window title, either a string or a localization message Optional props: `header component`top part of the dialog, defaults to `editor.ui.heading({text = props.title})``content component`content of the dialog`buttons component[]`array of `editor.ui.dialog_button(...)` components, footer of the dialog. Defaults to a single Close button
+       * @param props - Required props: `title string, message`OS dialog window title, either a string or a localization message Optional props: `header component`top part of the dialog, defaults to `editor.ui.heading({text = props.title})``content component`content of the dialog`width number`initial width of the dialog window in pixels`height number`initial height of the dialog window in pixels`resizable boolean`determines if the dialog window can be resized by the user`buttons component[]`array of `editor.ui.dialog_button(...)` components, footer of the dialog. Defaults to a single Close button`modal boolean`if set to `false`, the dialog window stays on top but does not block interaction with the editor
        * @returns UI component
        */
       function dialog(props: Record<string | number, unknown>): Opaque<"component">;
@@ -776,7 +781,7 @@ declare global {
        */
       function separator(props: Record<string | number, unknown>): Opaque<"component">;
       /**
-       * Show a modal dialog and await a result
+       * Show a dialog and await a result
        *
        * @param dialog - a component that resolves to `editor.ui.dialog(...)`
        * @returns dialog result, the value used as a `result` prop in a `editor.ui.dialog_button({...})` selected by the user, or `nil` if the dialog was closed and there was no `cancel = true` dialog button with `result` prop set
@@ -819,6 +824,20 @@ declare global {
        * @returns UI component
        */
       function string_field(props: Record<string | number, unknown>): Opaque<"component">;
+      /**
+       * Tab used in the `tabs` prop of `editor.ui.tabs(...)`
+       *
+       * @param props - Required props: `text string, message`tab header text, either a string or a localization message Optional props: `content component`tab content component`icon component`tab header icon component`enabled boolean`determines if the tab can be selected
+       * @returns UI component
+       */
+      function tab(props: Record<string | number, unknown>): Opaque<"component">;
+      /**
+       * Layout container that shows one selected tab content at a time
+       *
+       * @param props - Optional props: `tabs component[]`array of `editor.ui.tab(...)` components`grow boolean`determines if the component should grow to fill available space in a `horizontal` or `vertical` layout container`row_span integer`how many rows the component spans inside a grid container, must be positive. This prop is only useful for components inside a `grid` container.`column_span integer`how many columns the component spans inside a grid container, must be positive. This prop is only useful for components inside a `grid` container.
+       * @returns UI component
+       */
+      function tabs(props: Record<string | number, unknown>): Opaque<"component">;
       /**
        * A hook that caches the result of a computation between re-renders.
        * See `editor.ui.component` for hooks caveats and rules. If any of the arguments to `use_memo` change during a component refresh (checked with `==`), the value will be recomputed.

package/generated/gui.d.ts

@@ -1667,11 +1667,31 @@ declare global {
      */
     function reset_nodes(): void;
     /**
-     * Convert the screen position to the local position of supplied node
+     * Converts a screen-space position to the local position value for the supplied node.
+     * The conversion takes the parent transform, anchors, adjust mode, and adjust reference into account.
      *
-     * @param node - node used for getting local transformation matrix
-     * @param screen_position - screen position
-     * @returns local position
+     * @param node - node whose local position space should be used
+     * @param screen_position - screen-space position
+     * @returns local position value for the node
+     * @example
+     * ```ts
+     * // Animate a node to the pressed pointer position:
+     * export default defineScript({
+     *   init() {
+     *     msg.post(".", "acquire_input_focus");
+     *     return { marker: gui.get_node("marker") };
+     *   },
+     *
+     *   on_input(self, action_id, action) {
+     *     if (action_id === hash("touch") && action.pressed) {
+     *       const screen_position = vmath.vector3(action.screen_x, action.screen_y, 0);
+     *       const target_position = gui.screen_to_local(self.marker, screen_position);
+     *       gui.animate(self.marker, gui.PROP_POSITION, target_position, gui.EASING_OUTQUAD, 0.2);
+     *       return true;
+     *     }
+     *   },
+     * });
+     * ```
      */
     function screen_to_local(node: Opaque<"node">, screen_position: Vector3): Vector3;
     /**
@@ -1719,7 +1739,7 @@ declare global {
      *
      * @param node - node to set the property for, or msg.url() to the gui itself
      * @param property - the property to set
-     * @param value - the property to set
+     * @param value - the property to set. `nil` is only supported for removing runtime texture mappings with `gui.set(msg.url(), "textures", nil, {key = ...})`.
      * @param options - optional options table (only applicable for material constants)
      * - `index` number index into array property (1 based)
      * - `key` hash name of internal property
@@ -1767,9 +1787,18 @@ declare global {
      *     }
      *   },
      * });
+     *
+     * // Remove a named runtime texture resource mapping:
+     * const atlas_id = resource.create_atlas("/runtime.texturesetc", atlas_params);
+     * gui.set(msg.url(), "textures", atlas_id, { key: "runtime_texture" });
+     * gui.set_texture(gui.get_node("box"), "runtime_texture");
+     *
+     * // Later, remove the GUI mapping before releasing the atlas resource.
+     * gui.set(msg.url(), "textures", undefined, { key: "runtime_texture" });
+     * resource.release(atlas_id);
      * ```
      */
-    function set(node: Opaque<"node"> | Url, property: string | Hash | Opaque<"constant">, value: number | Vector4 | Vector3 | Quaternion, options?: { index?: number; key?: Hash }): void;
+    function set(node: Opaque<"node"> | Url, property: string | Hash | Opaque<"constant">, value?: number | Vector4 | Vector3 | Quaternion, options?: { index?: number; key?: Hash }): void;
     /**
      * Sets the adjust mode on a node.
      * The adjust mode defines how the node will adjust itself to screen

package/generated/kinds/editor-script.d.ts

@@ -1,6 +1,7 @@
 /// <reference types="lua-types/5.1" />
 import "../editor";
 import "../editor-vm/http";
+import "../editor-vm/image";
 import "../editor-vm/json";
 import "../editor-vm/localization";
 import "../editor-vm/zip";

package/generated/material.d.ts

@@ -239,6 +239,8 @@ declare global {
      * - `graphics.SEMANTIC_TYPE_BONE_INDICES`
      *
      * - `graphics.SEMANTIC_TYPE_TEXTURE_TRANSFORM_2D`
+     *
+     * - `graphics.SEMANTIC_TYPE_MORPH_TARGET_WEIGHTS`
      * @example
      * ```ts
      * const vertex_attributes = material.get_vertex_attributes(resource.material("/my_material.materialc"));
@@ -432,6 +434,8 @@ declare global {
      * - `graphics.SEMANTIC_TYPE_BONE_INDICES`
      *
      * - `graphics.SEMANTIC_TYPE_TEXTURE_TRANSFORM_2D`
+     *
+     * - `graphics.SEMANTIC_TYPE_MORPH_TARGET_WEIGHTS`
      * @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 } });

package/generated/versions/defold-1.12.4/gui.d.ts

@@ -1726,49 +1726,49 @@ declare global {
      * - `index` number index into array property (1 based)
      * - `key` hash name of internal property
      * @example
-     * ```ts
-     * // Updates the position property on an existing node:
-     * const node = gui.get_node("my_box_node");
-     * const node_position = gui.get(node, "position");
-     * gui.set(node, "position.x", node_position.x + 128);
-     *
-     * // Updates the rotation property on an existing node:
-     * gui.set(node, "rotation", vmath.quat_rotation_z(math.rad(45)));
-     * // this is equivalent to:
-     * gui.set(node, "euler.z", 45);
-     * // or using the entire vector:
-     * gui.set(node, "euler", vmath.vector3(0, 0, 45));
-     * // or using the set_rotation
-     * gui.set_rotation(node, vmath.vector3(0, 0, 45));
-     *
-     * // Sets various material constants for a node:
-     * gui.set(node, "tint", vmath.vector4(1, 0, 0, 1));
-     * // matrix4 is also supported
-     * gui.set(node, "light_matrix", vmath.matrix4());
-     * // update a constant in an array at position 4. the array is specified in the shader as:
-     * // uniform vec4 tint_array[4]; // lua is 1 based, shader is 0 based
-     * gui.set(node, "tint_array", vmath.vector4(1, 0, 0, 1), { index: 4 });
-     * // update a matrix constant in an array at position 4. the array is specified in the shader as:
-     * // uniform mat4 light_matrix_array[4];
-     * gui.set(node, "light_matrix_array", vmath.matrix4(), { index: 4 });
-     * // update a sub-element in a constant
-     * gui.set(node, "tint.x", 1);
-     * // update a sub-element in an array constant at position 4
-     * gui.set(node, "tint_array.x", 1, { index: 4 });
-     *
-     * // Set a named property
-     * export default defineScript({
-     *   on_message(self, message_id, message) {
-     *     if (message_id === hash("set_font")) {
-     *       gui.set(msg.url(), "fonts", message.font, { key: "my_font_name" });
-     *       gui.set_font(gui.get_node("text"), "my_font_name");
-     *     } else if (message_id === hash("set_texture")) {
-     *       gui.set(msg.url(), "textures", message.texture, { key: "my_texture" });
-     *       gui.set_texture(gui.get_node("box"), "my_texture");
-     *       gui.play_flipbook(gui.get_node("box"), "logo_256");
-     *     }
-     *   },
-     * });
+     * ```lua
+     * Updates the position property on an existing node:
+     * local node = gui.get_node("my_box_node")
+     * local node_position = gui.get(node, "position")
+     * gui.set(node, "position.x", node_position.x + 128)
+     *
+     * Updates the rotation property on an existing node:
+     * local node = gui.get_node("my_box_node")
+     * gui.set(node, "rotation", vmath.quat_rotation_z(math.rad(45)))
+     * -- this is equivalent to:
+     * gui.set(node, "euler.z", 45)
+     * -- or using the entire vector:
+     * gui.set(node, "euler", vmath.vector3(0,0,45))
+     * -- or using the set_rotation
+     * gui.set_rotation(node, vmath.vector3(0,0,45))
+     *
+     * Sets various material constants for a node:
+     * local node = gui.get_node("my_box_node")
+     * gui.set(node, "tint", vmath.vector4(1,0,0,1))
+     * -- matrix4 is also supported
+     * gui.set(node, "light_matrix", vmath.matrix4())
+     * -- update a constant in an array at position 4. the array is specified in the shader as:
+     * -- uniform vec4 tint_array[4]; // lua is 1 based, shader is 0 based
+     * gui.set(node, "tint_array", vmath.vector4(1,0,0,1), { index = 4 })
+     * -- update a matrix constant in an array at position 4. the array is specified in the shader as:
+     * -- uniform mat4 light_matrix_array[4];
+     * gui.set(node, "light_matrix_array", vmath.matrix4(), { index = 4 })
+     * -- update a sub-element in a constant
+     * gui.set(node, "tint.x", 1)
+     * -- update a sub-element in an array constant at position 4
+     * gui.set(node, "tint_array.x", 1, {index = 4})
+     *
+     * Set a named property
+     * function on_message(self, message_id, message, sender)
+     *    if message_id == hash("set_font") then
+     *        gui.set(msg.url(), "fonts", message.font, {key = "my_font_name"})
+     *        gui.set_font(gui.get_node("text"), "my_font_name")
+     *    elseif message_id == hash("set_texture") then
+     *        gui.set(msg.url(), "textures", message.texture, {key = "my_texture"})
+     *        gui.set_texture(gui.get_node("box"), "my_texture")
+     *        gui.play_flipbook(gui.get_node("box"), "logo_256")
+     *    end
+     * end
      * ```
      */
     function set(node: Opaque<"node"> | Url, property: string | Hash | Opaque<"constant">, value: number | Vector4 | Vector3 | Quaternion, options?: { index?: number; key?: Hash }): void;

package/index.d.ts

@@ -61,13 +61,16 @@ export {
   type ApiSymbolIdentity,
   type AvailabilityLabel,
   type AvailabilityLabelKind,
+  type AvailabilityLabelOptions,
   availabilityLabel,
   deriveAvailabilityMatrix,
   groupByLogicalName,
   isSignatureTransition,
   type LogicalNameGroup,
   normalizedFunctionSignature,
+  signatureTransitionNames,
   symbolIdentityKey,
+  symbolNameKey,
   type VersionSurface,
 } from "./src/api-availability";
 export type { ApiFunction, ApiModule, ApiParameter, ApiVariable } from "./src/api-doc";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defold-typescript/types",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "TypeScript types for the Defold engine's Lua APIs.",
   "license": "MIT",
   "repository": {

package/scripts/import-defold-release.ts

@@ -4,6 +4,7 @@ import { isKnownDefoldTypeToken } from "../src/emit-dts";
 import { refDocCacheDir, resolveRefDoc } from "./doc-source";
 import {
   apiElementIdentity,
+  EDITOR_MANIFEST,
   IGNORED_UPSTREAM,
   mergeApiDocs,
   readZip,
@@ -15,6 +16,14 @@ const EXACT_VERSION = /^\d+\.\d+\.\d+$/;
 const LUA_NAMESPACE = /^[a-z][a-z0-9]*(\.[a-z][a-z0-9]*)*$/;
 const PACKAGE_ROOT = resolve(import.meta.dir, "..");
 
+// Editor-scripting namespaces are mapped, but not by `api-targets.json`: they
+// emit through `EDITOR_MODULE_MANIFEST` rather than the runtime module set the
+// baseline is built from, so the baseline can never vouch for them. Only
+// `EDITOR_MANIFEST` is consulted — `EDITOR_VM_MANIFEST` entries are split out of
+// the editor document and never surface as an upstream `info.namespace`, so
+// excusing their bare names would suppress a real runtime namespace instead.
+const EDITOR_MAPPED_NAMESPACES = new Set(EDITOR_MANIFEST.map((source) => source.namespace));
+
 // The set of namespaces promoted into the generated surface at Defold 1.13.0.
 // Held here rather than derived from the root release model because the
 // per-package `rootDir` boundary forbids importing outside this package tree;
@@ -325,6 +334,7 @@ export function buildReleaseImportPlan(input: {
       (source) =>
         source.functionCount > 0 &&
         !baselineByNamespace.has(source.namespace) &&
+        !EDITOR_MAPPED_NAMESPACES.has(source.namespace) &&
         !IGNORED_UPSTREAM.has(source.namespace),
     )
     .map((source) => ({

package/scripts/sync-api-docs.ts

@@ -11,7 +11,7 @@ import { MODULE_MANIFEST } from "./regen";
 // model because the per-package `rootDir` boundary forbids a types-package
 // module importing outside its own tree; `scripts/release-model.test.ts`
 // correspondence-guards these against the model so drift fails CI.
-export const DEFOLD_VERSION = "1.13.0";
+export const DEFOLD_VERSION = "1.13.1";
 export const refDocUrl = (version = DEFOLD_VERSION): string =>
   `https://github.com/defold/defold/releases/download/${version}/ref-doc.zip`;
 
@@ -184,6 +184,7 @@ export const EDITOR_MANIFEST: readonly SyncManifestEntry[] = [
 // `http_doc.json` / `json_doc.json` / `zlib_doc.json`.
 export const EDITOR_VM_MANIFEST: readonly SyncManifestEntry[] = [
   editorVm("http"),
+  editorVm("image"),
   editorVm("json"),
   editorVm("localization"),
   editorVm("zip"),
@@ -204,7 +205,7 @@ function editorVm(namespace: string): SyncManifestEntry {
 function entry(
   namespace: string,
   zipEntry: string,
-  fixture: string = `fixtures/defold-1.13.0/${namespace.replace(/\./g, "_")}_doc.json`,
+  fixture: string = `fixtures/defold-1.13.1/${namespace.replace(/\./g, "_")}_doc.json`,
   mergeEntries?: readonly string[],
 ): SyncManifestEntry {
   return { namespace, zipEntry, fixture, ...(mergeEntries ? { mergeEntries } : {}) };
@@ -235,7 +236,7 @@ function ext(namespace: string, repo: string, tag: string, path: string): Extens
     repo,
     tag,
     path,
-    fixture: `fixtures/defold-1.13.0/${namespace}_doc.json`,
+    fixture: `fixtures/defold-1.13.1/${namespace}_doc.json`,
   };
 }
 

package/src/emit-dts.ts

@@ -157,6 +157,12 @@ export const ARBITRARY_TABLE_SLOTS = new Set([
   // is opaque to the field-list parser and the whole-slot `Record` is faithful.
   "render.render_target",
   "render.set_render_target",
+  // reserved-but-undocumented options bag: `collectionproxy.load`'s `options`
+  // slot is documented verbatim as "options table, currently unused" and accepts
+  // `nil`, so upstream defines no field list to emit. The whole-slot `Record` is
+  // faithful to what is documented today. If a later release fills the bag in,
+  // drop this entry so the missing fields resurface under `recordTables`.
+  "collectionproxy.load",
 ]);
 
 // Per-slot companion to ARBITRARY_TABLE_SLOTS (`element:kind:name`), for a

package/src/index.ts

@@ -5,6 +5,7 @@ export {
   type ApiSymbolIdentity,
   type AvailabilityLabel,
   type AvailabilityLabelKind,
+  type AvailabilityLabelOptions,
   applyMigrationOverlay,
   availabilityLabel,
   type Box2dBackend,
@@ -14,7 +15,9 @@ export {
   isSignatureTransition,
   type LogicalNameGroup,
   normalizedFunctionSignature,
+  signatureTransitionNames,
   symbolIdentityKey,
+  symbolNameKey,
   type VersionSurface,
   validateAvailability,
 } from "./api-availability";