@defold-typescript/types 0.39.0 → 0.41.0

package/generated/compute.d.ts

@@ -1,5 +1,5 @@
 /** @noSelfInFile */
-import type { Hash, Matrix4, Vector3, Vector4 } from "../src/core-types";
+import type { Hash } from "../src/core-types";
 
 declare global {
   /**
@@ -10,285 +10,59 @@ declare global {
      * Returns a table of all the shader constants in the compute program.
      *
      * @param path - The path to the resource
-     * @returns A table of tables, where each entry contains info about the shader constants:
-     *
-     * `name`
-     * hash the hashed name of the constant
-     * `type`
-     * number the type of the constant. Supported values:
-     *
-     * - `material.CONSTANT_TYPE_USER`
-     *
-     * - `material.CONSTANT_TYPE_USER_MATRIX4`
-     *
-     * - `material.CONSTANT_TYPE_VIEWPROJ`
-     *
-     * - `material.CONSTANT_TYPE_WORLD`
-     *
-     * - `material.CONSTANT_TYPE_TEXTURE`
-     *
-     * - `material.CONSTANT_TYPE_VIEW`
-     *
-     * - `material.CONSTANT_TYPE_PROJECTION`
-     *
-     * - `material.CONSTANT_TYPE_NORMAL`
-     *
-     * - `material.CONSTANT_TYPE_WORLDVIEW`
-     *
-     * - `material.CONSTANT_TYPE_WORLDVIEWPROJ`
-     *
-     * - `material.CONSTANT_TYPE_TIME`
-     *
-     * - `material.CONSTANT_TYPE_WORLD_INVERSE`
-     *
-     * - `material.CONSTANT_TYPE_VIEW_INVERSE`
-     *
-     * - `material.CONSTANT_TYPE_PROJECTION_INVERSE`
-     *
-     * - `material.CONSTANT_TYPE_VIEWPROJ_INVERSE`
-     *
-     * - `material.CONSTANT_TYPE_WORLDVIEW_INVERSE`
-     *
-     * - `material.CONSTANT_TYPE_WORLDVIEWPROJ_INVERSE`
-     *
-     * `value`
-     * vmath.vector4 | vmath.matrix4 the value(s) of the constant. If the constant is an array, the value will be a table of vmath.vector4 or vmath.matrix4 if the type is `material.CONSTANT_TYPE_USER_MATRIX4`.
+     * @returns Information about the shader constants.
      * @example
      * ```ts
      * const constants = compute.get_constants("/my_compute.computec");
      * ```
      */
-    function get_constants(path: Hash | string): { name: Hash; type: number; value: Vector4 | Matrix4 }[];
+    function get_constants(path: Hash | string): material.constant_info[];
     /**
      * Returns a table of all the texture samplers in the compute program. This function will return all the texture samplers
      * that are available, even the ones that have not been specified in the compute resource.
      *
      * @param path - The path to the resource
-     * @returns A table of tables, where each entry contains info about the texture samplers:
-     *
-     * `name`
-     * hash the hashed name of the texture sampler
-     * `u_wrap`
-     * number the u wrap mode of the texture sampler. Supported values:
-     *
-     * - `graphics.TEXTURE_WRAP_CLAMP_TO_BORDER`
-     *
-     * - `graphics.TEXTURE_WRAP_CLAMP_TO_EDGE`
-     *
-     * - `graphics.TEXTURE_WRAP_MIRRORED_REPEAT`
-     *
-     * - `graphics.TEXTURE_WRAP_REPEAT`
-     *
-     * `v_wrap`
-     * number the v wrap mode of the texture sampler. Supported values:
-     *
-     * - `graphics.TEXTURE_WRAP_CLAMP_TO_BORDER`
-     *
-     * - `graphics.TEXTURE_WRAP_CLAMP_TO_EDGE`
-     *
-     * - `graphics.TEXTURE_WRAP_MIRRORED_REPEAT`
-     *
-     * - `graphics.TEXTURE_WRAP_REPEAT`
-     *
-     * `min_filter`
-     * number the min filter mode of the texture sampler. Supported values:
-     *
-     * - `graphics.TEXTURE_FILTER_DEFAULT`
-     *
-     * - `graphics.TEXTURE_FILTER_NEAREST`
-     *
-     * - `graphics.TEXTURE_FILTER_LINEAR`
-     *
-     * - `graphics.TEXTURE_FILTER_NEAREST_MIPMAP_NEAREST`
-     *
-     * - `graphics.TEXTURE_FILTER_NEAREST_MIPMAP_LINEAR`
-     *
-     * - `graphics.TEXTURE_FILTER_LINEAR_MIPMAP_NEAREST`
-     *
-     * - `graphics.TEXTURE_FILTER_LINEAR_MIPMAP_LINEAR`
-     *
-     * `mag_filter`
-     * number the mag filter mode of the texture sampler
-     *
-     * - `graphics.TEXTURE_FILTER_DEFAULT`
-     *
-     * - `graphics.TEXTURE_FILTER_NEAREST`
-     *
-     * - `graphics.TEXTURE_FILTER_LINEAR`
-     *
-     * `max_anisotropy`
-     * number the max anisotropy of the texture sampler
+     * @returns Information about the texture samplers.
      * @example
      * ```ts
      * const samplers = compute.get_samplers("/my_compute.computec");
      * ```
      */
-    function get_samplers(path: Hash | string): { name: Hash; u_wrap: number; v_wrap: number; min_filter: number; mag_filter: number; max_anisotropy: number }[];
+    function get_samplers(path: Hash | string): material.sampler_info[];
     /**
      * Returns a table of all the textures from the compute program.
      *
      * @param path - The path to the resource
-     * @returns A table of tables, where each entry contains info about the compute textures:
-     *
-     * `path`
-     * hash the resource path of the texture. Only available if the texture is a resource.
-     * `handle`
-     * hash the runtime handle of the texture.
-     * `width`
-     * number the width of the texture
-     * `height`
-     * number the height of the texture
-     * `depth`
-     * number the depth of the texture. Corresponds to the number of layers in an array texture.
-     * `mipmaps`
-     * number the number of mipmaps in the texture
-     * `type`
-     * number the type of the texture. Supported values:
-     *
-     * - `graphics.TEXTURE_TYPE_2D`
-     *
-     * - `graphics.TEXTURE_TYPE_2D_ARRAY`
-     *
-     * - `graphics.TEXTURE_TYPE_CUBE_MAP`
-     *
-     * - `graphics.TEXTURE_TYPE_IMAGE_2D`
-     *
-     * - `graphics.TEXTURE_TYPE_3D`
-     *
-     * - `graphics.TEXTURE_TYPE_IMAGE_3D`
-     *
-     * `flags`
-     * number the flags of the texture. This field is a bit mask of these supported flags:
-     *
-     * - `graphics.TEXTURE_USAGE_FLAG_SAMPLE`
-     *
-     * - `graphics.TEXTURE_USAGE_FLAG_MEMORYLESS`
-     *
-     * - `graphics.TEXTURE_USAGE_FLAG_STORAGE`
-     *
-     * - `graphics.TEXTURE_USAGE_FLAG_INPUT`
-     *
-     * - `graphics.TEXTURE_USAGE_FLAG_COLOR`
+     * @returns Information about the compute textures.
      * @example
      * ```ts
      * const textures = compute.get_textures("/my_compute.computec");
      * ```
      */
-    function get_textures(path: Hash | string): { path: Hash; handle: Hash; width: number; height: number; depth: number; mipmaps: number; type: number; flags: number }[];
+    function get_textures(path: Hash | string): material.texture_info[];
     /**
      * Sets shader constants in a compute program, if the constants exist.
      *
      * @param path - The path to the resource
-     * @param constants - A table keyed by constant name with args tables as values. Constants can be partially updated. Supported entries:
-     *
-     * `type`
-     * number the type of the constant. Supported values:
-     *
-     * - `material.CONSTANT_TYPE_USER`
-     *
-     * - `material.CONSTANT_TYPE_USER_MATRIX4`
-     *
-     * - `material.CONSTANT_TYPE_VIEWPROJ`
-     *
-     * - `material.CONSTANT_TYPE_WORLD`
-     *
-     * - `material.CONSTANT_TYPE_TEXTURE`
-     *
-     * - `material.CONSTANT_TYPE_VIEW`
-     *
-     * - `material.CONSTANT_TYPE_PROJECTION`
-     *
-     * - `material.CONSTANT_TYPE_NORMAL`
-     *
-     * - `material.CONSTANT_TYPE_WORLDVIEW`
-     *
-     * - `material.CONSTANT_TYPE_WORLDVIEWPROJ`
-     *
-     * - `material.CONSTANT_TYPE_TIME`
-     *
-     * - `material.CONSTANT_TYPE_WORLD_INVERSE`
-     *
-     * - `material.CONSTANT_TYPE_VIEW_INVERSE`
-     *
-     * - `material.CONSTANT_TYPE_PROJECTION_INVERSE`
-     *
-     * - `material.CONSTANT_TYPE_VIEWPROJ_INVERSE`
-     *
-     * - `material.CONSTANT_TYPE_WORLDVIEW_INVERSE`
-     *
-     * - `material.CONSTANT_TYPE_WORLDVIEWPROJ_INVERSE`
-     *
-     * `value`
-     * vmath.vector4 | vmath.vector3 | vmath.matrix4 | number | table the value(s) of the constant. If the shader constant is an array, the amount of values to update depends on how many values that are passed in the 'value' field.
+     * @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) } });
      * ```
      */
-    function set_constants(path: Hash | string, constants: Record<string, { type?: number; value?: Vector4 | Vector3 | Matrix4 | number | (Vector4 | Matrix4)[] }>): void;
+    function set_constants(path: Hash | string, constants: LuaMap<string | Hash, material.constant_options> | Record<string, material.constant_options>): void;
     /**
      * Sets texture samplers in a compute program, if the samplers exist. Use this function to change the settings of texture samplers.
      * To set actual textures that should be bound to the samplers, use the `compute.set_textures` function instead.
      *
      * @param path - The path to the resource
-     * @param samplers - A table keyed by sampler name with args tables as values. Partial updates are supported. Supported entries:
-     *
-     * `u_wrap`
-     * number the u wrap mode of the texture sampler. Supported values:
-     *
-     * - `graphics.TEXTURE_WRAP_CLAMP_TO_BORDER`
-     *
-     * - `graphics.TEXTURE_WRAP_CLAMP_TO_EDGE`
-     *
-     * - `graphics.TEXTURE_WRAP_MIRRORED_REPEAT`
-     *
-     * - `graphics.TEXTURE_WRAP_REPEAT`
-     *
-     * `v_wrap`
-     * number the v wrap mode of the texture sampler. Supported values:
-     *
-     * - `graphics.TEXTURE_WRAP_CLAMP_TO_BORDER`
-     *
-     * - `graphics.TEXTURE_WRAP_CLAMP_TO_EDGE`
-     *
-     * - `graphics.TEXTURE_WRAP_MIRRORED_REPEAT`
-     *
-     * - `graphics.TEXTURE_WRAP_REPEAT`
-     *
-     * `min_filter`
-     * number the min filter mode of the texture sampler. Supported values:
-     *
-     * - `graphics.TEXTURE_FILTER_DEFAULT`
-     *
-     * - `graphics.TEXTURE_FILTER_NEAREST`
-     *
-     * - `graphics.TEXTURE_FILTER_LINEAR`
-     *
-     * - `graphics.TEXTURE_FILTER_NEAREST_MIPMAP_NEAREST`
-     *
-     * - `graphics.TEXTURE_FILTER_NEAREST_MIPMAP_LINEAR`
-     *
-     * - `graphics.TEXTURE_FILTER_LINEAR_MIPMAP_NEAREST`
-     *
-     * - `graphics.TEXTURE_FILTER_LINEAR_MIPMAP_LINEAR`
-     *
-     * `mag_filter`
-     * number the mag filter mode of the texture sampler
-     *
-     * - `graphics.TEXTURE_FILTER_DEFAULT`
-     *
-     * - `graphics.TEXTURE_FILTER_NEAREST`
-     *
-     * - `graphics.TEXTURE_FILTER_LINEAR`
-     *
-     * `max_anisotropy`
-     * number the max anisotropy of the texture sampler
+     * @param samplers - Sampler options keyed by sampler name. Partial updates are supported.
      * @example
      * ```ts
      * compute.set_samplers("/my_compute.computec", { texture_sampler: { u_wrap: graphics.TEXTURE_WRAP_REPEAT, v_wrap: graphics.TEXTURE_WRAP_MIRRORED_REPEAT } });
      * ```
      */
-    function set_samplers(path: Hash | string, samplers: Record<string, { u_wrap?: number; v_wrap?: number; min_filter?: number; mag_filter?: number; max_anisotropy?: number }>): void;
+    function set_samplers(path: Hash | string, samplers: LuaMap<string | Hash, material.sampler_options> | Record<string, material.sampler_options>): void;
     /**
      * Sets textures in a compute program, if the samplers exist.
      *
@@ -299,7 +73,7 @@ declare global {
      * compute.set_textures("/my_compute.computec", { my_texture: resource.texture() });
      * ```
      */
-    function set_textures(path: Hash | string, textures: LuaMap<string, Hash>): void;
+    function set_textures(path: Hash | string, textures: LuaMap<string | Hash, string | Hash> | Record<string, string | Hash>): void;
   }
 }
 

package/generated/crash.d.ts

@@ -4,6 +4,21 @@ declare global {
    * Native crash logging functions and constants.
    */
   namespace crash {
+    /**
+     * Loaded crash module
+     */
+    interface module_info {
+      /**
+       * module name
+       */
+      name: string;
+      /**
+       * module load address
+       */
+      address: string;
+    }
+    type USERFIELD = number;
+    type SYSFIELD = typeof crash.SYSFIELD_ENGINE_VERSION | typeof crash.SYSFIELD_ENGINE_HASH | typeof crash.SYSFIELD_DEVICE_MODEL | typeof crash.SYSFIELD_MANUFACTURER | typeof crash.SYSFIELD_SYSTEM_NAME | typeof crash.SYSFIELD_SYSTEM_VERSION | typeof crash.SYSFIELD_LANGUAGE | typeof crash.SYSFIELD_DEVICE_LANGUAGE | typeof crash.SYSFIELD_TERRITORY | typeof crash.SYSFIELD_ANDROID_BUILD_FINGERPRINT;
     /**
      * android build fingerprint
      */
@@ -62,7 +77,7 @@ declare global {
      * @param handle - crash dump handle
      * @returns table containing the backtrace
      */
-    function get_backtrace(handle: number): Record<string | number, unknown>;
+    function get_backtrace(handle: number): string[];
     /**
      * The format of read text blob is platform specific
      * and not guaranteed
@@ -73,13 +88,12 @@ declare global {
      */
     function get_extra_data(handle: number): string;
     /**
-     * The function returns a table containing entries with sub-tables that
-     * have fields 'name' and 'address' set for all loaded modules.
+     * get all loaded modules from when the crash occured
      *
      * @param handle - crash dump handle
-     * @returns module table
+     * @returns loaded modules
      */
-    function get_modules(handle: number): Record<string | number, unknown>;
+    function get_modules(handle: number): crash.module_info[];
     /**
      * read signal number from a crash report
      *
@@ -94,15 +108,15 @@ declare global {
      * @param index - system field enum. Must be less than crash.SYSFIELD_MAX
      * @returns value recorded in the crash dump, or `nil` if it didn't exist
      */
-    function get_sys_field(handle: number, index: number): string | undefined;
+    function get_sys_field(handle: number, index: crash.SYSFIELD): string | undefined;
     /**
      * reads user field from a loaded crash dump
      *
      * @param handle - crash dump handle
-     * @param index - user data slot index
+     * @param index - user data slot index. **0️⃣ 0-based; passed to Defold unchanged.**
      * @returns user data value recorded in the crash dump
      */
-    function get_user_field(handle: number, index: number): string;
+    function get_user_field(handle: number, index: crash.USERFIELD): string;
     /**
      * The crash dump will be removed from disk upon a successful
      * load, so loading is one-shot.
@@ -127,10 +141,10 @@ declare global {
      * a crash occurs. This can be user id:s, breadcrumb data etc.
      * There are 32 slots indexed from 0. Each slot stores at most 255 characters.
      *
-     * @param index - slot index. 0-indexed
+     * @param index - slot index. 0-indexed. **0️⃣ 0-based; passed to Defold unchanged.**
      * @param value - string value to store
      */
-    function set_user_field(index: number, value: string): void;
+    function set_user_field(index: crash.USERFIELD, value: string): void;
     /**
      * Performs the same steps as if a crash had just occured but
      * allows the program to continue.

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

@@ -1,18 +1,101 @@
 /** @noSelfInFile */
+import type { Opaque } from "../../src/core-types";
+
 declare global {
   /**
    * Editor scripting documentation
    */
   namespace http {
+    type response = Opaque<"http.response">;
+    type route = Opaque<"http.route">;
     /**
      * 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"`; 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
+     * @param opts - request options
+     * @returns HTTP response
      */
-    function request(url: string, opts?: Record<string | number, unknown>): Record<string | number, unknown>;
+    function request(url: string, opts?: http.request.options): http.request.response;
+    namespace request {
+      type method = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS" | string;
+      /**
+       * Options for http.request
+       */
+      interface options {
+        /**
+         * request method, defaults to `"GET"`
+         */
+        method?: http.request.method;
+        /**
+         * request headers
+         */
+        headers?: LuaTable<string, string>;
+        /**
+         * request body
+         */
+        body?: string;
+        /**
+         * response body converter; mutually exclusive with `path`
+         */
+        as?: "string" | "json";
+        /**
+         * destination file path, resolved against project root if relative; mutually exclusive with `as`
+         */
+        path?: string;
+      }
+      /**
+       * Response returned by http.request
+       */
+      interface response {
+        /**
+         * response code
+         */
+        status: number;
+        /**
+         * response headers, where keys are lowercase and repeated headers have arrays of values
+         */
+        headers: LuaTable<string, string | string[]>;
+        /**
+         * response body, present only when the `as` option was provided
+         */
+        body?: unknown;
+        /**
+         * resolved absolute destination path, present after a successful response was written using the `path` option
+         */
+        path?: string;
+      }
+    }
     namespace server {
+      type handler = (request: http.server.request) => LuaMultiReturn<[http.response | number | undefined, LuaTable<string, string> | undefined, string | undefined]>;
+      /**
+       * HTTP server request
+       */
+      interface request {
+        /**
+         * route path parameter extracted from a path pattern
+         */
+        "[string]": unknown;
+        /**
+         * full matched path, starting with `/`
+         */
+        path: string;
+        /**
+         * HTTP request method, e.g. `"POST"`
+         */
+        method: string;
+        /**
+         * request headers, keyed by lowercase header name
+         */
+        headers: LuaTable<string, string | string[]>;
+        /**
+         * query string
+         */
+        query?: string;
+        /**
+         * request body, whose type depends on the route's `as` argument
+         */
+        body?: unknown;
+      }
       /**
        * Create HTTP response that will stream the content of a file defined by the path
        *
@@ -21,7 +104,7 @@ declare global {
        * @param headers - HTTP response headers, a table from lower-case header names to header values
        * @returns HTTP response value, userdata
        */
-      function external_file_response(path: string, status?: number, headers?: unknown): unknown;
+      function external_file_response(path: string, status?: number, headers?: LuaMap<string, string> | Record<string, string>): http.response;
       /**
        * Create HTTP response with a JSON value
        *
@@ -30,7 +113,7 @@ declare global {
        * @param headers - HTTP response headers, a table from lower-case header names to header values
        * @returns HTTP response value, userdata
        */
-      function json_response(value: unknown, status?: number, headers?: unknown): unknown;
+      function json_response(value: unknown, status?: number, headers?: LuaMap<string, string> | Record<string, string>): http.response;
       /**
        * Create HTTP response that will stream the content of a resource defined by the resource path
        *
@@ -39,7 +122,7 @@ declare global {
        * @param headers - HTTP response headers, a table from lower-case header names to header values
        * @returns HTTP response value, userdata
        */
-      function resource_response(resource_path: string, status?: number, headers?: unknown): unknown;
+      function resource_response(resource_path: string, status?: number, headers?: LuaMap<string, string> | Record<string, string>): http.response;
       /**
        * Create HTTP response
        *
@@ -48,7 +131,7 @@ declare global {
        * @param body - HTTP response body
        * @returns HTTP response value, userdata
        */
-      function response(status?: number, headers?: unknown, body?: string): unknown;
+      function response(status?: number, headers?: LuaMap<string, string> | Record<string, string>, body?: string): http.response;
     }
   }
 }

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

@@ -10,22 +10,22 @@ declare global {
      * @param path - External file path, resolved against project root if relative
      * @returns image userdata
      */
-    function load_file(path: string): unknown;
+    function load_file(path: string): editor.image;
     /**
      * 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
+     * @param x - 1-based horizontal pixel coordinate. **⚠️ 1-based; passed to Defold unchanged.**
+     * @param y - 1-based vertical pixel coordinate. **⚠️ 1-based; passed to Defold unchanged.**
      */
-    function pixel(image: unknown, x: number, y: number): LuaMultiReturn<[number, number, number, number]>;
+    function pixel(image: editor.image, 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
+     * @returns iterator function returning `x, y, r, g, b, a` for each pixel. **⚠️ 1-based; passed to Defold unchanged.**
      * @example
      * ```lua
      * local img = image.load_file("assets/source.png")
@@ -35,13 +35,13 @@ declare global {
      * end
      * ```
      */
-    function pixels(image: unknown): (...args: unknown[]) => unknown;
+    function pixels(image: editor.image): (...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]>;
+    function size(image: editor.image): LuaMultiReturn<[number, number]>;
   }
 }
 

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

@@ -4,6 +4,17 @@ declare global {
    * Editor scripting documentation
    */
   namespace json {
+    namespace decode {
+      /**
+       * Options for json.decode
+       */
+      interface options {
+        /**
+         * if true, decodes all JSON values in a string and returns an array
+         */
+        all?: boolean;
+      }
+    }
   }
 }
 

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

@@ -9,18 +9,18 @@ declare global {
     /**
      * Create a message pattern that renders a list with the "and" conjunction (for example: a, b, and c) once it is stringified
      *
-     * @param items - ] array of values; each value may be `nil`, `boolean`, `number`, `string`, or another `message` instance
+     * @param items - array of values; each value may be `nil`, `boolean`, `number`, `string`, or another `message` instance
      * @returns a userdata value that, when stringified with `tostring()`, will produce a localized text according to the currently selected language in the editor
      */
-    function and_list(items: unknown[]): Opaque<"message">;
+    function and_list(items: (undefined | boolean | number | string | Opaque<"message">)[]): Opaque<"message">;
     /**
      * Create a message pattern that concatenates values (similar to `table.concat`) and performs the actual concatenation when stringified
      *
-     * @param items - ] array of values; each value may be `nil`, `boolean`, `number`, `string`, or another `message` instance
+     * @param items - array of values; each value may be `nil`, `boolean`, `number`, `string`, or another `message` instance
      * @param separator - optional separator inserted between values; defaults to an empty string
      * @returns a userdata value that, when stringified with `tostring()`, will produce a localized text according to the currently selected language in the editor
      */
-    function concat(items: unknown[], separator?: boolean | number | string | Opaque<"message">): Opaque<"message">;
+    function concat(items: (undefined | boolean | number | string | Opaque<"message">)[], separator?: boolean | number | string | Opaque<"message">): Opaque<"message">;
     /**
      * Create a message pattern for a localization key defined in an `.editor_localization` file; the actual localization happens when the returned value is stringified
      *
@@ -28,14 +28,14 @@ declare global {
      * @param vars - optional table with variables to be substituted in the localized string that uses ICU Message Format syntax; keys must be strings; values must be either `nil`, `boolean`, `number`, `string`, or another `message` instance
      * @returns a userdata value that, when stringified with `tostring()`, will produce a localized text according to the currently selected language in the editor
      */
-    function message(key: string, vars?: Record<string | number, unknown>): Opaque<"message">;
+    function message(key: string, vars?: LuaMap<string, undefined | boolean | number | string | Opaque<"message">> | Record<string, undefined | boolean | number | string | Opaque<"message">>): Opaque<"message">;
     /**
      * Create a message pattern that renders a list with the "or" conjunction (for example: a, b, or c) once it is stringified
      *
-     * @param items - ] array of values; each value may be `nil`, `boolean`, `number`, `string`, or another `message` instance
+     * @param items - array of values; each value may be `nil`, `boolean`, `number`, `string`, or another `message` instance
      * @returns a userdata value that, when stringified with `tostring()`, will produce a localized text according to the currently selected language in the editor
      */
-    function or_list(items: unknown[]): Opaque<"message">;
+    function or_list(items: (undefined | boolean | number | string | Opaque<"message">)[]): Opaque<"message">;
   }
 }