@defold-typescript/types 0.39.0 → 0.41.0

package/generated/html5.d.ts

@@ -18,7 +18,9 @@ declare global {
      * const res = html5.run("10 + 20"); // returns the string "30"
      * print(res);
      * const res_num = tonumber(res); // convert to number
-     * print(res_num - 20); // prints 10
+     * if (res_num !== undefined) {
+     *   print(res_num - 20); // prints 10
+     * }
      * ```
      */
     function run(code: string): string;
@@ -31,7 +33,7 @@ declare global {
      * @param callback - The interaction callback. Pass an empty function or `nil` if you no longer wish to receive callbacks.
      *
      * `self`
-     * object The calling script
+     * script_instance The calling script instance
      * @example
      * ```ts
      * function on_interaction(self: unknown) {
@@ -46,7 +48,7 @@ declare global {
      * });
      * ```
      */
-    function set_interaction_listener(callback?: (self: unknown) => void): void;
+    function set_interaction_listener(callback: ((self: unknown) => void) | undefined): void;
   }
 }
 

package/generated/http.d.ts

@@ -1,9 +1,36 @@
 /** @noSelfInFile */
+import type { Hash } from "../src/core-types";
+
 declare global {
   /**
    * Functions for performing HTTP and HTTPS requests.
    */
   namespace http {
+    /**
+     * HTTP request options
+     */
+    interface request_options {
+      /**
+       * timeout in seconds
+       */
+      timeout?: number;
+      /**
+       * absolute destination path; overwritten only for status 200
+       */
+      path?: string;
+      /**
+       * do not return cached data for status 304; unavailable on HTML5
+       */
+      ignore_cache?: boolean;
+      /**
+       * use chunked transfer encoding for HTTPS requests larger than 16 KB; defaults to true and is unavailable on HTML5
+       */
+      chunked_transfer?: boolean;
+      /**
+       * report transferred and total byte counts to the callback
+       */
+      report_progress?: boolean;
+    }
     /**
      * Perform a HTTP/HTTPS request.
      * If no timeout value is passed, the configuration value "network.http_timeout" is used. If that is not set, the timeout value is `0` (which blocks indefinitely).
@@ -13,44 +40,12 @@ declare global {
      * @param callback - response callback function
      *
      * `self`
-     * object The script instance
+     * script_instance The current script instance
      * `id`
      * hash Internal message identifier. Do not use!
-     * `response`
-     * table The response data. Contains the fields:
-     *
-     * - number `status`: the status of the response
-     *
-     * - string `response`: the response data (if not saved on disc)
-     *
-     * - table `headers`: all the returned headers (if status is 200 or 206)
-     *
-     * - string `path`: the stored path (if saved to disc)
-     *
-     * - string `error`: if any unforeseen errors occurred (e.g. file I/O)
-     *
-     * - number `bytes_received`: the amount of bytes received/sent for a request, only if option `report_progress` is true
-     *
-     * - number `bytes_total`: the total amount of bytes for a request, only if option `report_progress` is true
-     *
-     * - number `range_start`: the start offset into the requested file
-     *
-     * - number `range_end`: the end offset into the requested file (inclusive)
-     *
-     * - number `document_size`: the full size of the requested file
      * @param headers - optional table with custom headers
      * @param post_data - optional data to send
-     * @param options - optional table with request parameters. Supported entries:
-     *
-     * - number `timeout`: timeout in seconds
-     *
-     * - string `path`: path on disc where to download the file. Only overwrites the path if status is 200. Path should be absolute
-     *
-     * - boolean `ignore_cache`: don't return cached data if we get a 304. Not available in HTML5 build
-     *
-     * - boolean `chunked_transfer`: use chunked transfer encoding for https requests larger than 16kb. Defaults to true. Not available in HTML5 build
-     *
-     * - boolean `report_progress`: when it is true, the amount of bytes sent and/or received for a request will be passed into the callback function
+     * @param options - optional request options
      * @example
      * ```ts
      * function update_my_progress_bar(self: unknown, fraction: number) {
@@ -65,7 +60,7 @@ declare global {
      *       "http://www.google.com",
      *       "GET",
      *       (self, _id, response) => {
-     *         if (response.bytes_total !== undefined) {
+     *         if (response.bytes_received !== undefined && response.bytes_total !== undefined) {
      *           update_my_progress_bar(self, response.bytes_received / response.bytes_total);
      *         } else {
      *           print(response.status);
@@ -81,7 +76,7 @@ declare global {
      * });
      * ```
      */
-    function request(url: string, method: string, callback: (self: unknown, id: unknown, response: unknown) => void, headers?: LuaMap<string, string>, post_data?: string, options?: { timeout?: number; path?: string; ignore_cache?: boolean; chunked_transfer?: boolean; report_progress?: boolean }): void;
+    function request(url: string, method: string, callback: (self: unknown, id: Hash, response: { status: number; response?: string; headers?: LuaMap<string, string>; path?: string; error?: string; bytes_received?: number; bytes_total?: number; range_start?: number; range_end?: number; document_size?: number }) => void, headers?: LuaMap<string, string> | Record<string, string>, post_data?: string, options?: http.request_options): void;
   }
 }
 

package/generated/image.d.ts

@@ -7,132 +7,174 @@ declare global {
    */
   namespace image {
     /**
-     * luminance image type
+     * ASTC image header
      */
-    const TYPE_LUMINANCE: number & { readonly __brand: "image.TYPE_LUMINANCE" };
+    interface astc_header {
+      /**
+       * Image width.
+       */
+      width: number;
+      /**
+       * Image height.
+       */
+      height: number;
+      /**
+       * Image depth.
+       */
+      depth: number;
+      /**
+       * Block size on the x-axis.
+       */
+      block_size_x: number;
+      /**
+       * Block size on the y-axis.
+       */
+      block_size_y: number;
+      /**
+       * Block size on the z-axis.
+       */
+      block_size_z: number;
+    }
     /**
-     * luminance image type
+     * Loaded buffer image data
      */
-    const TYPE_LUMINANCE_ALPHA: number & { readonly __brand: "image.TYPE_LUMINANCE_ALPHA" };
+    interface load_buffer_result {
+      /**
+       * Image width.
+       */
+      width: number;
+      /**
+       * Image height.
+       */
+      height: number;
+      /**
+       * Image type.
+       */
+      type: image.TYPE;
+      /**
+       * Script buffer containing the decompressed image data.
+       */
+      buffer: Opaque<"buffer">;
+    }
     /**
-     * RGB image type
+     * Image loading options
      */
-    const TYPE_RGB: number & { readonly __brand: "image.TYPE_RGB" };
+    interface load_options {
+      /**
+       * Whether to premultiply alpha into the color components. Defaults to `false`.
+       */
+      premultiply_alpha?: boolean;
+      /**
+       * Whether to flip the image contents vertically. Defaults to `false`.
+       */
+      flip_vertically?: boolean;
+    }
     /**
-     * RGBA image type
+     * Loaded string image data
      */
-    const TYPE_RGBA: number & { readonly __brand: "image.TYPE_RGBA" };
+    interface load_result {
+      /**
+       * Image width.
+       */
+      width: number;
+      /**
+       * Image height.
+       */
+      height: number;
+      /**
+       * Image type.
+       */
+      type: image.TYPE;
+      /**
+       * Raw image data.
+       */
+      buffer: string;
+    }
+    type TYPE = typeof image.TYPE_RGB | typeof image.TYPE_RGBA | typeof image.TYPE_LUMINANCE | typeof image.TYPE_LUMINANCE_ALPHA;
+    /**
+     * Luminance image type.
+     */
+    const TYPE_LUMINANCE: string & { readonly __brand: "image.TYPE_LUMINANCE" };
+    /**
+     * Luminance-alpha image type.
+     */
+    const TYPE_LUMINANCE_ALPHA: string & { readonly __brand: "image.TYPE_LUMINANCE_ALPHA" };
+    /**
+     * RGB image type.
+     */
+    const TYPE_RGB: string & { readonly __brand: "image.TYPE_RGB" };
+    /**
+     * RGBA image type.
+     */
+    const TYPE_RGBA: string & { readonly __brand: "image.TYPE_RGBA" };
     /**
      * get the header of an .astc buffer
      *
      * @param buffer - .astc file data buffer
-     * @returns header or `nil` if buffer is not a valid .astc. The header has these fields:
-     *
-     * - number `width`: image width
-     *
-     * - number `height`: image height
-     *
-     * - number `depth`: image depth
-     *
-     * - number `block_size_x`: block size x
-     *
-     * - number `block_size_y`: block size y
-     *
-     * - number `block_size_z`: block size z
+     * @returns header, or `nil` if the buffer is not a valid ASTC image
      * @example
      * ```ts
      * // How to get the block size and dimensions from a .astc file
      * const [s] = sys.load_resource("/assets/cat.astc");
-     * const header = image.get_astc_header(s);
-     * pprint(s);
+     * if (s !== undefined) {
+     *   const header = image.get_astc_header(s);
+     *   pprint(s);
+     * }
      * ```
      */
-    function get_astc_header(buffer: string): { width: number; height: number; depth: number; block_size_x: number; block_size_y: number; block_size_z: number } | undefined;
+    function get_astc_header(buffer: string): image.astc_header | undefined;
     /**
      * Load image (PNG or JPEG) from buffer.
      *
      * @param buffer - image data buffer
-     * @param options - An optional table containing parameters for loading the image. Supported entries:
-     *
-     * `premultiply_alpha`
-     * boolean True if alpha should be premultiplied into the color components. Defaults to `false`.
-     * `flip_vertically`
-     * boolean True if the image contents should be flipped vertically. Defaults to `false`.
-     * @returns object or `nil` if loading fails. The object is a table with the following fields:
-     *
-     * - number `width`: image width
-     *
-     * - number `height`: image height
-     *
-     * - constant `type`: image type
-     *
-     * - `image.TYPE_RGB`
-     *
-     * - `image.TYPE_RGBA`
-     *
-     * - `image.TYPE_LUMINANCE`
-     *
-     * - `image.TYPE_LUMINANCE_ALPHA`
-     *
-     * - string `buffer`: the raw image data
+     * @param options - Optional loading parameters. A boolean is accepted for backwards compatibility and controls `premultiply_alpha`.
+     * @returns loaded image, or `nil` if loading fails
      * @example
      * ```ts
      * // How to load an image from an URL and create a GUI texture from it:
      * const imgurl = "http://www.site.com/image.png";
      * http.request(imgurl, "GET", (self, id, response) => {
-     *   const img = image.load(response.response);
-     *   const tx = gui.new_texture("image_node", img.width, img.height, img.type, img.buffer);
+     *   const img = response.response !== undefined ? image.load(response.response) : undefined;
+     *   if (img !== undefined) {
+     *     const tx = gui.new_texture("image_node", img.width, img.height, img.type, img.buffer);
+     *   }
      * });
      * ```
      */
-    function load(buffer: string, options?: { premultiply_alpha?: boolean; flip_vertically?: boolean }): { width: number; height: number; type: Opaque<"constant">; buffer: string } | undefined;
+    function load(buffer: string, options?: boolean | image.load_options): image.load_result | undefined;
     /**
      * Load image (PNG or JPEG) from a string buffer.
      *
      * @param buffer - image data buffer
-     * @param options - An optional table containing parameters for loading the image. Supported entries:
-     *
-     * `premultiply_alpha`
-     * boolean True if alpha should be premultiplied into the color components. Defaults to `false`.
-     * `flip_vertically`
-     * boolean True if the image contents should be flipped vertically. Defaults to `false`.
-     * @returns object or `nil` if loading fails. The object is a table with the following fields:
-     *
-     * - number `width`: image width
-     *
-     * - number `height`: image height
-     *
-     * - constant `type`: image type
-     *
-     * - `image.TYPE_RGB`
-     *
-     * - `image.TYPE_RGBA`
-     *
-     * - `image.TYPE_LUMINANCE`
-     *
-     * - `image.TYPE_LUMINANCE_ALPHA`
-     *
-     * - buffer `buffer`: the script buffer that holds the decompressed image data. See buffer.create how to use the buffer.
+     * @param options - Optional loading parameters. A boolean is accepted for backwards compatibility and controls `premultiply_alpha`.
+     * @returns loaded image, or `nil` if loading fails
      * @example
      * ```ts
      * // Load an image from an URL as a buffer and create a texture resource from it:
      * const imgurl = "http://www.site.com/image.png";
      * http.request(imgurl, "GET", (self, id, response) => {
-     *   const img = image.load_buffer(response.response, { flip_vertically: true });
-     *   const tparams = {
-     *     width: img.width,
-     *     height: img.height,
-     *     type: graphics.TEXTURE_TYPE_2D,
-     *     format: graphics.TEXTURE_FORMAT_RGBA,
-     *   };
-     *
-     *   const my_texture_id = resource.create_texture("/my_custom_texture.texturec", tparams, img.buffer);
-     *   // Apply the texture to a model
-     *   go.set("/go1#model", "texture0", my_texture_id);
+     *   const img =
+     *     response.response !== undefined
+     *       ? image.load_buffer(response.response, { flip_vertically: true })
+     *       : undefined;
+     *   // the engine registers a texture format only when the driver supports it
+     *   const format = graphics.TEXTURE_FORMAT_RGBA;
+     *   if (img !== undefined && format !== undefined) {
+     *     const tparams = {
+     *       width: img.width,
+     *       height: img.height,
+     *       type: graphics.TEXTURE_TYPE_2D,
+     *       format,
+     *     };
+     *
+     *     const my_texture_id = resource.create_texture("/my_custom_texture.texturec", tparams, img.buffer);
+     *     // Apply the texture to a model
+     *     go.set("/go1#model", "texture0", my_texture_id);
+     *   }
      * });
      * ```
      */
-    function load_buffer(buffer: string, options?: { premultiply_alpha?: boolean; flip_vertically?: boolean }): { width: number; height: number; type: Opaque<"constant">; buffer: Opaque<"buffer"> } | undefined;
+    function load_buffer(buffer: string, options?: boolean | image.load_options): image.load_buffer_result | undefined;
   }
 }
 

package/generated/json.d.ts

@@ -4,6 +4,24 @@ declare global {
    * Manipulation of JSON data strings.
    */
   namespace json {
+    /**
+     * JSON decoding options
+     */
+    export interface decode_options {
+      /**
+       * Decode JSON `null` as json.null instead of `nil`.
+       */
+      decode_null_as_userdata?: boolean;
+    }
+    /**
+     * JSON encoding options
+     */
+    export interface encode_options {
+      /**
+       * Encode an empty table as an object instead of an array. The default is true.
+       */
+      encode_empty_table_as_object?: boolean;
+    }
     /**
      * Represents the null primitive from a json file
      */
@@ -13,13 +31,11 @@ declare global {
      * A Lua error is raised for syntax errors.
      *
      * @param json - json data
-     * @param options - table with decode options
-     *
-     * - boolean `decode_null_as_userdata`: whether to decode a JSON null value as json.null or nil (default is nil)
-     * @returns decoded json
+     * @param options - optional decoding options
+     * @returns decoded JSON value
      * @example
+     * Converting a string containing JSON data into a Lua table:
      * ```ts
-     * // Converting a string containing JSON data into a table:
      * export default defineScript({
      *   init() {
      *     const jsonstring = '{"persons":[{"name":"John Doe"},{"name":"Darth Vader"}]}';
@@ -27,8 +43,10 @@ declare global {
      *     pprint(data);
      *   },
      * });
-     *
-     * // Results in the following printout:
+     * ```
+     * @example
+     * Results in the following printout:
+     * ```ts
      * // {
      * //   persons = {
      * //     1 = {
@@ -41,19 +59,17 @@ declare global {
      * // }
      * ```
      */
-    export function decode(json: string, options?: { decode_null_as_userdata?: boolean }): Record<string | number, unknown>;
+    export function decode(json: string, options?: json.decode_options): unknown;
     /**
      * Encode a lua table to a JSON string.
      * A Lua error is raised for syntax errors.
      *
-     * @param tbl - lua table to encode
-     * @param options - table with encode options
-     *
-     * - string `encode_empty_table_as_object`: whether to encode an empty table as an JSON object or array (default is object)
+     * @param tbl - Lua value to encode
+     * @param options - optional encoding options
      * @returns encoded json
      * @example
+     * Convert a lua table to a JSON string:
      * ```ts
-     * // Convert a table to a JSON string:
      * export default defineScript({
      *   init() {
      *     const tbl = {
@@ -63,12 +79,14 @@ declare global {
      *     pprint(jsonstring);
      *   },
      * });
-     *
-     * // Results in the following printout:
+     * ```
+     * @example
+     * Results in the following printout:
+     * ```ts
      * // {"persons":[{"name":"John Doe"},{"name":"Darth Vader"}]}
      * ```
      */
-    export function encode(tbl: Record<string | number, unknown>, options?: { encode_empty_table_as_object?: string }): string;
+    export function encode(tbl: unknown, options?: json.encode_options): string;
     export { _null as null };
   }
 }

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

@@ -8,6 +8,12 @@ import "../b2d_joint";
 import "../b2d_shape";
 import "../b2d_world";
 import "../buffer";
+import "../bullet3d";
+import "../bullet3d_collision_object";
+import "../bullet3d_constraint";
+import "../bullet3d_rigid_body";
+import "../bullet3d_shape";
+import "../bullet3d_world";
 import "../camera";
 import "../collectionfactory";
 import "../collectionproxy";
@@ -40,12 +46,14 @@ import "../types";
 import "../vmath";
 import "../window";
 import "../zlib";
+import "../../src/component-properties";
 import "../../src/custom-messages";
 import "../../src/engine-globals";
 import "../../src/go-overloads";
 import "../../src/message-guard";
 import "../../src/msg-overloads";
 import "../../src/scene-addresses";
+import "../../src/sys-overloads";
 import "../../src/vmath-overloads";
 import "../../src/window-event-guard";
 import "../builtin-messages";

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

@@ -8,6 +8,12 @@ import "../b2d_joint";
 import "../b2d_shape";
 import "../b2d_world";
 import "../buffer";
+import "../bullet3d";
+import "../bullet3d_collision_object";
+import "../bullet3d_constraint";
+import "../bullet3d_rigid_body";
+import "../bullet3d_shape";
+import "../bullet3d_world";
 import "../camera";
 import "../collectionfactory";
 import "../collectionproxy";
@@ -40,6 +46,7 @@ import "../types";
 import "../vmath";
 import "../window";
 import "../zlib";
+import "../../src/component-properties";
 import "../../src/custom-messages";
 import "../../src/engine-globals";
 import "../../src/go-overloads";
@@ -47,6 +54,7 @@ import "../../src/message-guard";
 import "../../src/msg-overloads";
 import "../../src/render-overloads";
 import "../../src/scene-addresses";
+import "../../src/sys-overloads";
 import "../../src/vmath-overloads";
 import "../../src/window-event-guard";
 import "../builtin-messages";

package/generated/kinds/script.d.ts

@@ -8,6 +8,12 @@ import "../b2d_joint";
 import "../b2d_shape";
 import "../b2d_world";
 import "../buffer";
+import "../bullet3d";
+import "../bullet3d_collision_object";
+import "../bullet3d_constraint";
+import "../bullet3d_rigid_body";
+import "../bullet3d_shape";
+import "../bullet3d_world";
 import "../camera";
 import "../collectionfactory";
 import "../collectionproxy";
@@ -40,12 +46,14 @@ import "../types";
 import "../vmath";
 import "../window";
 import "../zlib";
+import "../../src/component-properties";
 import "../../src/custom-messages";
 import "../../src/engine-globals";
 import "../../src/go-overloads";
 import "../../src/message-guard";
 import "../../src/msg-overloads";
 import "../../src/scene-addresses";
+import "../../src/sys-overloads";
 import "../../src/vmath-overloads";
 import "../../src/window-event-guard";
 import "../builtin-messages";