@defold-typescript/types 0.40.0 → 0.41.0

package/generated/tilemap.d.ts

@@ -6,6 +6,7 @@ declare global {
    * Functions and messages used to manipulate tile map components.
    */
   namespace tilemap {
+    type TRANSFORM = typeof tilemap.H_FLIP | typeof tilemap.ROTATE_180 | typeof tilemap.ROTATE_270 | typeof tilemap.ROTATE_90 | typeof tilemap.V_FLIP;
     /**
      * flip tile horizontally
      */
@@ -34,6 +35,11 @@ declare global {
      * the bounds are calculated as if all layers were collapsed into one.
      *
      * @param url - the tile map
+     * @returns `[x, y, w, h]`:
+     * - `x` — x coordinate of the bottom left corner. **⚠️ 1-based; passed to Defold unchanged.**
+     * - `y` — y coordinate of the bottom left corner. **⚠️ 1-based; passed to Defold unchanged.**
+     * - `w` — number of columns (width) in the tile map
+     * - `h` — number of rows (height) in the tile map
      * @example
      * ```ts
      * // get the level bounds.
@@ -50,8 +56,8 @@ declare global {
      *
      * @param url - the tile map
      * @param layer - name of the layer for the tile
-     * @param x - x-coordinate of the tile
-     * @param y - y-coordinate of the tile
+     * @param x - x-coordinate of the tile. **⚠️ 1-based; passed to Defold unchanged.**
+     * @param y - y-coordinate of the tile. **⚠️ 1-based; passed to Defold unchanged.**
      * @returns index of the tile
      * @example
      * ```ts
@@ -71,9 +77,9 @@ declare global {
      *
      * @param url - the tile map
      * @param layer - name of the layer for the tile
-     * @param x - x-coordinate of the tile
-     * @param y - y-coordinate of the tile
-     * @returns index of the tile
+     * @param x - x-coordinate of the tile. **⚠️ 1-based; passed to Defold unchanged.**
+     * @param y - y-coordinate of the tile. **⚠️ 1-based; passed to Defold unchanged.**
+     * @returns full tile information
      * @example
      * ```ts
      * function tile_info_under_player(self: { player_x: number; player_y: number }) {
@@ -113,7 +119,7 @@ declare global {
      * }
      * ```
      */
-    function get_tiles(url: string | Hash | Url, layer: string | Hash): LuaMap<number, LuaMap<number, number>>;
+    function get_tiles(url: string | Hash | Url, layer: string | Hash): LuaTable<number, LuaTable<number, number>>;
     /**
      * Resets a shader constant for a tile map component.
      * The constant must be defined in the material assigned to the tile map.
@@ -134,27 +140,26 @@ declare global {
      * above and to the right of origin has coordinates 1,1.
      * Tiles to the left of and below origin are indexed 0, -1, -2 and so forth.
      *
+     * ```text
      * +-------+-------+------+------+
-     * | 0,3 | 1,3 | 2,3 | 3,3 |
+     * |  0,3  |  1,3  | 2,3  | 3,3  |
      * +-------+-------+------+------+
-     * | 0,2 | 1,2 | 2,2 | 3,2 |
+     * |  0,2  |  1,2  | 2,2  | 3,2  |
      * +-------+-------+------+------+
-     * | 0,1 | 1,1 | 2,1 | 3,1 |
+     * |  0,1  |  1,1  | 2,1  | 3,1  |
      * +-------O-------+------+------+
-     * | 0,0 | 1,0 | 2,0 | 3,0 |
+     * |  0,0  |  1,0  | 2,0  | 3,0  |
      * +-------+-------+------+------+
+     * ```
      *
      * The coordinates must be within the bounds of the tile map as it were created.
      * That is, it is not possible to extend the size of a tile map by setting tiles outside the edges.
      * To clear a tile, set the tile to number 0. Which tile map and layer to manipulate is identified by the URL and the layer name parameters.
-     * Transform bitmask is arithmetic sum of one or both FLIP constants (`tilemap.H_FLIP`, `tilemap.V_FLIP`) and/or one of ROTATION constants
-     * (`tilemap.ROTATE_90`, `tilemap.ROTATE_180`, `tilemap.ROTATE_270`).
-     * Flip always applies before rotation (clockwise).
      *
      * @param url - the tile map
      * @param layer - name of the layer for the tile
-     * @param x - x-coordinate of the tile
-     * @param y - y-coordinate of the tile
+     * @param x - x-coordinate of the tile. **⚠️ 1-based; passed to Defold unchanged.**
+     * @param y - y-coordinate of the tile. **⚠️ 1-based; passed to Defold unchanged.**
      * @param tile - index of new tile to set. 0 resets the cell
      * @param transform_bitmask - optional flip and/or rotation should be applied to the tile
      * @example
@@ -171,7 +176,7 @@ declare global {
      * }
      * ```
      */
-    function set_tile(url: string | Hash | Url, layer: string | Hash, x: number, y: number, tile: number, transform_bitmask?: number): void;
+    function set_tile(url: string | Hash | Url, layer: string | Hash, x: number, y: number, tile: number, transform_bitmask?: tilemap.TRANSFORM | number): boolean;
     /**
      * Sets the visibility of the tilemap layer
      *

package/generated/timer.d.ts

@@ -8,6 +8,24 @@ declare global {
    * also affect the new timer.
    */
   namespace timer {
+    /**
+     * Timer information
+     */
+    interface info {
+      /**
+       * Time remaining until the next callback.
+       */
+      time_remaining: number;
+      /**
+       * Timer interval.
+       */
+      delay: number;
+      /**
+       * Whether the timer repeats until cancelled.
+       */
+      repeating: boolean;
+    }
+    type timer_handle = number;
     /**
      * Indicates an invalid timer handle
      */
@@ -17,14 +35,14 @@ declare global {
      * Cancelling a timer that is already executed or cancelled is safe.
      *
      * @param handle - the timer handle returned by timer.delay()
-     * @returns if the timer was active, false if the timer is already cancelled / complete
+     * @returns `true` if the timer was active and cancelled, `false` if the timer was already cancelled or complete
      * @example
      * ```ts
      * function cancel_ticking(self: { handle: number }) {
      *   self.handle = timer.delay(1, true, () => print("print every second"));
      *   // ...
-     *   const result = timer.cancel(self.handle);
-     *   if (!result) {
+     *   const cancelled = timer.cancel(self.handle);
+     *   if (!cancelled) {
      *     print("the timer is already cancelled");
      *   }
      * }
@@ -44,18 +62,20 @@ declare global {
      * @param callback - timer callback function
      *
      * `self`
-     * object The current object
+     * script_instance The current script instance
      * `handle`
-     * number The handle of the timer
+     * timer_handle The handle of the timer
      * `time_elapsed`
      * number The elapsed time - on first trigger it is time since timer.delay call, otherwise time since last trigger
      * @returns identifier for the create timer, returns timer.INVALID_TIMER_HANDLE if the timer can not be created
      * @example
+     * A simple one-shot timer
      * ```ts
-     * // A simple one-shot timer
      * timer.delay(1, false, () => print("print in one second"));
-     *
-     * // Repetitive timer which canceled after 10 calls
+     * ```
+     * @example
+     * Repetitive timer which canceled after 10 calls
+     * ```ts
      * function call_every_second(self: unknown, handle: unknown, time_elapsed: unknown) {
      *   const state = self as { counter: number };
      *   state.counter = state.counter + 1;
@@ -71,19 +91,12 @@ declare global {
      * }
      * ```
      */
-    function delay(delay: number, repeating: boolean, callback: (self: unknown, handle: unknown, time_elapsed: unknown) => void): number;
+    function delay(delay: number, repeating: boolean, callback: (self: unknown, handle: number, time_elapsed: number) => void): number;
     /**
      * Get information about timer.
      *
      * @param handle - the timer handle returned by timer.delay()
-     * @returns table or `nil` if timer is cancelled/completed. table with data in the following fields:
-     *
-     * `time_remaining`
-     * number Time remaining until the next time a timer.delay() fires.
-     * `delay`
-     * number Time interval.
-     * `repeating`
-     * boolean true = repeat timer until cancel, false = one-shot timer.
+     * @returns timer information, or `nil` if the timer is cancelled or complete
      * @example
      * ```ts
      * function report_ticking(self: { handle: number }) {
@@ -98,19 +111,19 @@ declare global {
      * }
      * ```
      */
-    function get_info(handle: number): { time_remaining: number; delay: number; repeating: boolean } | undefined;
+    function get_info(handle: number): timer.info | undefined;
     /**
      * Manual triggering a callback for a timer.
      *
      * @param handle - the timer handle returned by timer.delay()
-     * @returns if the timer was active, false if the timer is already cancelled / complete
+     * @returns `true` if the timer was active and triggered, `false` if the timer was already cancelled or complete
      * @example
      * ```ts
      * function trigger_ticking(self: { handle: number }) {
      *   self.handle = timer.delay(1, true, () => print("print every second or manually by timer.trigger"));
      *   // ...
-     *   const result = timer.trigger(self.handle);
-     *   if (!result) {
+     *   const triggered = timer.trigger(self.handle);
+     *   if (!triggered) {
      *     print("the timer is already cancelled or complete");
      *   }
      * }

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

@@ -243,13 +243,6 @@ declare global {
      * @returns true if the body is allowed to sleep
      */
     function is_sleeping_enabled(body: Opaque<"b2Body">): boolean;
-    /**
-     * This resets the mass properties to the sum of the mass properties of the fixtures.
-     * This normally does not need to be called unless you called SetMassData to override
-     *
-     * @param body - body
-     */
-    function reset_mass_data(body: Opaque<"b2Body">): void;
     /**
      * Set the active state of the body. An inactive body is not
      * simulated and cannot be collided with or woken up.

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

@@ -102,9 +102,7 @@ declare global {
      * @param declaration - A table where each entry (table) describes a stream
      *
      * - hash | string `name`: The name of the stream
-     *
      * - constant `type`: The data type of the stream
-     *
      * - number `count`: The number of values each element should hold
      * @returns the new buffer
      * @example
@@ -131,7 +129,7 @@ declare global {
      * });
      * ```
      */
-    function create(element_count: number, declaration: { name?: Hash | string; type?: buffer.ValueType; count?: number }[]): Opaque<"buffer">;
+    function create(element_count: number, declaration: { name?: Hash | string; type: buffer.ValueType; count?: number }[]): Opaque<"buffer">;
     /**
      * Get a copy of all the bytes from a specified stream as a Lua string.
      *

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

@@ -1,5 +1,5 @@
 /** @noSelfInFile */
-import type { Matrix4, Url, Vector3 } from "../../../src/core-types";
+import type { Hash, Matrix4, Url, Vector3 } from "../../../src/core-types";
 
 declare global {
   /**
@@ -28,7 +28,7 @@ declare global {
      * @param camera - camera id
      * @returns the effective aspect ratio.
      */
-    function get_aspect_ratio(camera?: Url | number): number;
+    function get_aspect_ratio(camera?: Url | number | string | Hash): number;
     /**
      * Returns whether auto aspect ratio is enabled. When enabled, the camera automatically
      * calculates aspect ratio from render target dimensions. When disabled, uses the
@@ -37,7 +37,7 @@ declare global {
      * @param camera - camera id
      * @returns true if auto aspect ratio is enabled
      */
-    function get_auto_aspect_ratio(camera?: Url | number): boolean;
+    function get_auto_aspect_ratio(camera?: Url | number | string | Hash): boolean;
     /**
      * This function returns a table with all the camera URLs that have been
      * registered in the render context.
@@ -60,28 +60,28 @@ declare global {
      * @param camera - camera id
      * @returns true if the camera is enabled
      */
-    function get_enabled(camera?: Url | number): boolean;
+    function get_enabled(camera?: Url | number | string | Hash): boolean;
     /**
      * get far z
      *
      * @param camera - camera id
      * @returns the far z.
      */
-    function get_far_z(camera?: Url | number): number;
+    function get_far_z(camera?: Url | number | string | Hash): number;
     /**
      * get field of view
      *
      * @param camera - camera id
      * @returns the field of view.
      */
-    function get_fov(camera?: Url | number): number;
+    function get_fov(camera?: Url | number | string | Hash): number;
     /**
      * get near z
      *
      * @param camera - camera id
      * @returns the near z.
      */
-    function get_near_z(camera?: Url | number): number;
+    function get_near_z(camera?: Url | number | string | Hash): number;
     /**
      * get orthographic zoom mode
      *
@@ -89,28 +89,28 @@ declare global {
      * @returns one of camera.ORTHO_MODE_FIXED, camera.ORTHO_MODE_AUTO_FIT or
      * camera.ORTHO_MODE_AUTO_COVER
      */
-    function get_orthographic_mode(camera?: Url | number): number;
+    function get_orthographic_mode(camera?: Url | number | string | Hash): number;
     /**
      * get orthographic zoom
      *
      * @param camera - camera id
      * @returns the zoom level when the camera uses orthographic projection.
      */
-    function get_orthographic_zoom(camera?: Url | number): number;
+    function get_orthographic_zoom(camera?: Url | number | string | Hash): number;
     /**
      * get projection matrix
      *
      * @param camera - camera id
      * @returns the projection matrix.
      */
-    function get_projection(camera?: Url | number): Matrix4;
+    function get_projection(camera?: Url | number | string | Hash): Matrix4;
     /**
      * get view matrix
      *
      * @param camera - camera id
      * @returns the view matrix.
      */
-    function get_view(camera?: Url | number): Matrix4;
+    function get_view(camera?: Url | number | string | Hash): Matrix4;
     /**
      * Converts a screen-space 2D point with view depth to a 3D world point.
      * z is the view depth in world units measured from the camera plane along the camera forward axis.
@@ -143,7 +143,7 @@ declare global {
      * });
      * ```
      */
-    function screen_to_world(pos: Vector3, camera?: Url | number): Vector3;
+    function screen_to_world(pos: Vector3, camera?: Url | number | string | Hash): Vector3;
     /**
      * Converts 2D screen coordinates (x,y) to the 3D world-space point on the camera's near plane for that pixel.
      * If a camera isn't specified, the last enabled camera is used.
@@ -167,7 +167,7 @@ declare global {
      * });
      * ```
      */
-    function screen_xy_to_world(x: number, y: number, camera?: Url | number): Vector3;
+    function screen_xy_to_world(x: number, y: number, camera?: Url | number | string | Hash): Vector3;
     /**
      * Sets the manual aspect ratio for the camera. This value is only used when
      * auto aspect ratio is disabled. To disable auto aspect ratio and use this
@@ -176,7 +176,7 @@ declare global {
      * @param camera - camera id
      * @param aspect_ratio - the manual aspect ratio value.
      */
-    function set_aspect_ratio(camera: Url | number | undefined, aspect_ratio: number): void;
+    function set_aspect_ratio(camera: Url | number | string | Hash | undefined, aspect_ratio: number): void;
     /**
      * Enables or disables automatic aspect ratio calculation. When enabled (true),
      * the camera automatically calculates aspect ratio from render target dimensions.
@@ -185,42 +185,42 @@ declare global {
      * @param camera - camera id
      * @param auto_aspect_ratio - true to enable auto aspect ratio
      */
-    function set_auto_aspect_ratio(camera: Url | number | undefined, auto_aspect_ratio: boolean): void;
+    function set_auto_aspect_ratio(camera: Url | number | string | Hash | undefined, auto_aspect_ratio: boolean): void;
     /**
      * set far z
      *
      * @param camera - camera id
      * @param far_z - the far z.
      */
-    function set_far_z(camera: Url | number | undefined, far_z: number): void;
+    function set_far_z(camera: Url | number | string | Hash | undefined, far_z: number): void;
     /**
      * set field of view
      *
      * @param camera - camera id
      * @param fov - the field of view.
      */
-    function set_fov(camera: Url | number | undefined, fov: number): void;
+    function set_fov(camera: Url | number | string | Hash | undefined, fov: number): void;
     /**
      * set near z
      *
      * @param camera - camera id
      * @param near_z - the near z.
      */
-    function set_near_z(camera: Url | number | undefined, near_z: number): void;
+    function set_near_z(camera: Url | number | string | Hash | undefined, near_z: number): void;
     /**
      * set orthographic zoom mode
      *
      * @param camera - camera id
      * @param mode - camera.ORTHO_MODE_FIXED, camera.ORTHO_MODE_AUTO_FIT or camera.ORTHO_MODE_AUTO_COVER
      */
-    function set_orthographic_mode(camera: Url | number | undefined, mode: number): void;
+    function set_orthographic_mode(camera: Url | number | string | Hash | undefined, mode: number): void;
     /**
      * set orthographic zoom
      *
      * @param camera - camera id
      * @param orthographic_zoom - the zoom level when the camera uses orthographic projection.
      */
-    function set_orthographic_zoom(camera: Url | number | undefined, orthographic_zoom: number): void;
+    function set_orthographic_zoom(camera: Url | number | string | Hash | undefined, orthographic_zoom: number): void;
     /**
      * Converts a 3D world position to screen-space coordinates with view depth.
      * Returns a vector3 where x and y are in screen pixels and z is the view depth in world units
@@ -239,7 +239,7 @@ declare global {
      * const screen_pos = camera.world_to_screen(world_pos);
      * ```
      */
-    function world_to_screen(world_pos: Vector3, camera?: Url | number): Vector3;
+    function world_to_screen(world_pos: Vector3, camera?: Url | number | string | Hash): Vector3;
   }
 }
 

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

@@ -43,8 +43,8 @@ declare global {
      * @param scale - uniform scaling to apply to the newly spawned collection (must be greater than 0).
      * @returns a table mapping the id:s from the collection to the new instance id:s
      * @example
+     * How to spawn a collection of game objects:
      * ```ts
-     * // How to spawn a collection of game objects:
      * export default defineScript({
      *   init() {
      *     // Spawn a small group of enemies.
@@ -76,8 +76,10 @@ declare global {
      *     return { enemy_ids };
      *   },
      * });
-     *
-     * // How to delete a spawned collection:
+     * ```
+     * @example
+     * How to delete a spawned collection:
+     * ```ts
      * function delete_enemies(self: { enemy_ids: Hash[] }) {
      *   go.delete(self.enemy_ids);
      * }
@@ -92,12 +94,10 @@ declare global {
      * @returns status of the collection factory component
      *
      * - `collectionfactory.STATUS_UNLOADED`
-     *
      * - `collectionfactory.STATUS_LOADING`
-     *
      * - `collectionfactory.STATUS_LOADED`
      */
-    function get_status(url?: string | Hash | Url): collectionfactory.Status;
+    function get_status(url: string | Hash | Url): collectionfactory.Status;
     /**
      * Resources loaded are referenced by the collection factory component until the existing (parent) collection is destroyed or collectionfactory.unload is called.
      * Calling this function when the factory is not marked as dynamic loading does nothing.
@@ -117,7 +117,7 @@ declare global {
      * collectionfactory.load("#factory", (self, url, result) => {});
      * ```
      */
-    function load(url?: string | Hash | Url, complete_function?: (self: unknown, url: unknown, result: unknown) => void): void;
+    function load(url: string | Hash | Url, complete_function: (self: unknown, url: unknown, result: unknown) => void): void;
     /**
      * Changes the prototype for the collection factory.
      * Setting the prototype to "nil" will revert back to the original prototype.
@@ -132,7 +132,7 @@ declare global {
      * const ids = collectionfactory.create("#factory", go.get_world_position(), vmath.quat());
      * ```
      */
-    function set_prototype(url?: string | Hash | Url, prototype?: string): void;
+    function set_prototype(url: string | Hash | Url, prototype: string | undefined): void;
     /**
      * This decreases the reference count for each resource loaded with collectionfactory.load. If reference is zero, the resource is destroyed.
      * Calling this function when the factory is not marked as dynamic loading does nothing.
@@ -144,7 +144,7 @@ declare global {
      * collectionfactory.unload("#factory");
      * ```
      */
-    function unload(url?: string | Hash | Url): void;
+    function unload(url: string | Hash | Url): void;
   }
 }
 

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

@@ -40,7 +40,7 @@ declare global {
      * }
      * ```
      */
-    function get_resources(collectionproxy: Url): Hash[];
+    function get_resources(collectionproxy: Url | string | Hash): string[];
     /**
      * The collection should be loaded by the collection proxy.
      * Setting the collection to "nil" will revert it back to the original collection.
@@ -64,7 +64,7 @@ declare global {
      * msg.post("/go#collectionproxy", "enable");
      * ```
      */
-    function set_collection(url?: string | Hash | Url, prototype?: string): LuaMultiReturn<[boolean, number]>;
+    function set_collection(url: string | Hash | Url, prototype: string | undefined): LuaMultiReturn<[boolean, number]>;
   }
 }
 

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

@@ -99,7 +99,7 @@ declare global {
      * 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;
@@ -127,7 +127,7 @@ 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;

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

@@ -35,8 +35,8 @@ declare global {
      * @param scale - the scale of the new game object (must be greater than 0), the scale of the game object containing the factory is used by default, or if the value is `nil`
      * @returns the global id of the spawned game object
      * @example
+     * How to create a new game object:
      * ```ts
-     * // How to create a new game object:
      * export default defineScript({
      *   init(self) {
      *     // create a new game object and provide property values
@@ -45,16 +45,17 @@ declare global {
      *     msg.post(created, "hello");
      *   },
      * });
+     * ```
+     * @example
+     * And then let the new game object have a script attached:
+     * ```ts
+     * go.property("my_value", 0);
      *
-     * // And then let the new game object have a script attached, in its own file:
-     * //
-     * //   go.property("my_value", 0);
-     * //
-     * //   export default defineScript({
-     * //     init(self) {
-     * //       // do something with self.my_value which is now one
-     * //     },
-     * //   });
+     * export default defineScript({
+     *   init(self) {
+     *     // do something with self.my_value which is now one
+     *   },
+     * });
      * ```
      */
     function create(url: string | Hash | Url, position?: Vector3, rotation?: Quaternion, properties?: Record<string | number, unknown>, scale?: number | Vector3): Hash;
@@ -67,12 +68,10 @@ declare global {
      * @returns status of the factory component
      *
      * - `factory.STATUS_UNLOADED`
-     *
      * - `factory.STATUS_LOADING`
-     *
      * - `factory.STATUS_LOADED`
      */
-    function get_status(url?: string | Hash | Url): factory.Status;
+    function get_status(url: string | Hash | Url): factory.Status;
     /**
      * Resources are referenced by the factory component until the existing (parent) collection is destroyed or factory.unload is called.
      * Calling this function when the factory is not marked as dynamic loading does nothing.
@@ -92,7 +91,7 @@ declare global {
      * factory.load("#factory", (self, url, result) => {});
      * ```
      */
-    function load(url?: string | Hash | Url, complete_function?: (self: unknown, url: unknown, result: unknown) => void): void;
+    function load(url: string | Hash | Url, complete_function: (self: unknown, url: unknown, result: unknown) => void): void;
     /**
      * Changes the prototype for the factory.
      *
@@ -106,7 +105,7 @@ declare global {
      * const id = factory.create("#factory", go.get_world_position(), vmath.quat());
      * ```
      */
-    function set_prototype(url?: string | Hash | Url, prototype?: string): void;
+    function set_prototype(url: string | Hash | Url, prototype: string | undefined): void;
     /**
      * This decreases the reference count for each resource loaded with factory.load. If reference is zero, the resource is destroyed.
      * Calling this function when the factory is not marked as dynamic loading does nothing.
@@ -118,7 +117,7 @@ declare global {
      * factory.unload("#factory");
      * ```
      */
-    function unload(url?: string | Hash | Url): void;
+    function unload(url: string | Hash | Url): void;
   }
 }
 

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

@@ -217,15 +217,10 @@ declare global {
      * @param playback - playback mode of the animation
      *
      * - `go.PLAYBACK_ONCE_FORWARD`
-     *
      * - `go.PLAYBACK_ONCE_BACKWARD`
-     *
      * - `go.PLAYBACK_ONCE_PINGPONG`
-     *
      * - `go.PLAYBACK_LOOP_FORWARD`
-     *
      * - `go.PLAYBACK_LOOP_BACKWARD`
-     *
      * - `go.PLAYBACK_LOOP_PINGPONG`
      * @param to - target property value
      * @param easing - easing to use during animation. Either specify a constant, see the animation guide for a complete list, or a vmath.vector with a curve
@@ -287,7 +282,7 @@ declare global {
      * go.cancel_animations("#sprite");
      * ```
      */
-    export function cancel_animations(url: SceneAddress | Hash | Url, property?: string | Hash): void;
+    export function cancel_animations(url?: SceneAddress | Hash | Url, property?: string | Hash): void;
     /**
      * Delete one or more game objects identified by id. Deletion is asynchronous meaning that
      * the game object(s) are scheduled for deletion which will happen at the end of the current
@@ -378,7 +373,6 @@ declare global {
      * of the absolute path to the instance.
      *
      * - If `path` is specified, it can either be absolute or relative to the instance of the calling script.
-     *
      * - If `path` is not specified, the id of the game object instance the script is attached to will be returned.
      *
      * @param path - path of the instance for which to return the id
@@ -740,7 +734,7 @@ declare global {
      *
      * @param self - reference to the script state to be used for storing data
      * @param action_id - id of the received input action, as mapped in the input_binding-file
-     * @param action - a table containing the input data, see above for a description
+     * @param action - a table containing the input data, see above for a description. **0️⃣ `gamepad` is 0-based; passed to Defold unchanged.**
      * @returns optional boolean to signal if the input should be consumed (not passed on to others) or not, default is false
      * @example
      * ```ts
@@ -1043,7 +1037,7 @@ declare global {
      * const new_position = go.world_to_local_position(test_pos, "/child");
      * ```
      */
-    export function world_to_local_position(position: Vector3, url: SceneGameObjectAddress | Hash | Url): Vector3;
+    export function world_to_local_position(position: Vector3, url?: SceneGameObjectAddress | Hash | Url): Vector3;
     /**
      * The function uses world transformation calculated at the end of previous frame.
      *
@@ -1058,7 +1052,7 @@ declare global {
      * const result_transform = go.world_to_local_transform(test_transform, "/child");
      * ```
      */
-    export function world_to_local_transform(transformation: Matrix4, url: SceneGameObjectAddress | Hash | Url): Matrix4;
+    export function world_to_local_transform(transformation: Matrix4, url?: SceneGameObjectAddress | Hash | Url): Matrix4;
     export { _delete as delete };
     export interface properties {
       /**
@@ -1078,9 +1072,9 @@ declare global {
        */
       rotation: Quaternion;
       /**
-       * The uniform scale of the game object. The type of the property is number.
+       * The scale of the game object. `go.get` returns a vector3; `go.set` and `go.animate` also take a number, which sets a uniform scale.
        */
-      scale: number;
+      scale: number | Vector3;
     }
   }
 }