@defold-typescript/types 0.39.0 → 0.41.0

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

@@ -34,6 +34,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 +55,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,8 +76,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
@@ -120,15 +125,17 @@ 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.
@@ -139,8 +146,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.**
      * @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
@@ -157,7 +164,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?: number): boolean;
     /**
      * Sets the visibility of the tilemap layer
      *

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

@@ -51,11 +51,13 @@ declare global {
      * 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;

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

@@ -49,7 +49,7 @@ declare global {
     function conj(q1: Quaternion): Quaternion;
     /**
      * Given two linearly independent vectors P and Q, the cross product,
-     * P × Q, is a vector that is perpendicular to both P and Q and
+     * P × Q, is a vector that is perpendicular to both P and Q and
      * therefore normal to the plane containing them.
      * If the two vectors have the same direction (or have the exact
      * opposite direction from one another, i.e. are not linearly independent)
@@ -70,13 +70,11 @@ declare global {
     function cross(v1: Vector3, v2: Vector3): Vector3;
     /**
      * The returned value is a scalar defined as:
-     * `P ⋅ Q = |P| |Q| cos θ`
-     * where θ is the angle between the vectors P and Q.
+     * `P ⋅ Q = |P| |Q| cos θ`
+     * where θ is the angle between the vectors P and Q.
      *
      * - If the dot product is positive then the angle between the vectors is below 90 degrees.
-     *
      * - If the dot product is zero the vectors are perpendicular (at right-angles to each other).
-     *
      * - If the dot product is negative then the angle between the vectors is more than 90 degrees.
      *
      * @param v1 - first vector
@@ -437,8 +435,8 @@ declare global {
     /**
      * Calculates the extent the projection of the first vector onto the second.
      * The returned value is a scalar p defined as:
-     * `p = |P| cos θ / |Q|`
-     * where θ is the angle between the vectors P and Q.
+     * `p = |P| cos θ / |Q|`
+     * where θ is the angle between the vectors P and Q.
      *
      * @param v1 - vector to be projected on the second
      * @param v2 - vector onto which the first will be projected, must not have zero length
@@ -643,25 +641,6 @@ declare global {
      * ```
      */
     function rotate(q: Quaternion, v1: Vector3): Vector3;
-    /**
-     * Creates a vector of arbitrary size. The vector is initialized
-     * with numeric values from a table.
-     * The table values are converted to floating point
-     * values. If a value cannot be converted, a 0 is stored in that
-     * value position in the vector.
-     *
-     * @param t - table of numbers
-     * @returns new vector
-     * @example
-     * ```ts
-     * // How to create a vector with custom data to be used for animation easing:
-     * const values = [0, 0.5, 0];
-     * const vec = vmath.vector(values);
-     * print(vec); // => vmath.vector (size: 3)
-     * print(vec[2]); // => 0.5
-     * ```
-     */
-    function vector(t: number[]): Vector;
     /**
      * Creates a new zero vector with all components set to 0.
      *

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

@@ -53,9 +53,7 @@ declare global {
      * @returns The mode for screen dimming
      *
      * - `window.DIMMING_UNKNOWN`
-     *
      * - `window.DIMMING_ON`
-     *
      * - `window.DIMMING_OFF`
      */
     function get_dim_mode(): window.DimModeState;
@@ -82,19 +80,12 @@ declare global {
      * table table containing these keys:
      *
      * - number `x`
-     *
      * - number `y`
-     *
      * - number `width`
-     *
      * - number `height`
-     *
      * - number `inset_left`
-     *
      * - number `inset_top`
-     *
      * - number `inset_right`
-     *
      * - number `inset_bottom`
      */
     function get_safe_area(): { x: number; y: number; width: number; height: number; inset_left: number; inset_top: number; inset_right: number; inset_bottom: number };
@@ -110,7 +101,6 @@ declare global {
      * @param mode - The mode for screen dimming
      *
      * - `window.DIMMING_ON`
-     *
      * - `window.DIMMING_OFF`
      */
     function set_dim_mode(mode: window.DimModeStateSettable): void;
@@ -125,20 +115,15 @@ declare global {
      * constant The type of event. Can be one of these:
      *
      * - `window.WINDOW_EVENT_FOCUS_LOST`
-     *
      * - `window.WINDOW_EVENT_FOCUS_GAINED`
-     *
      * - `window.WINDOW_EVENT_RESIZED`
-     *
      * - `window.WINDOW_EVENT_ICONIFIED`
-     *
      * - `window.WINDOW_EVENT_DEICONIFIED`
      *
      * `data`
      * table The callback value `data` is a table which currently holds these values
      *
      * - number `width`: The width of a resize event. nil otherwise.
-     *
      * - number `height`: The height of a resize event. nil otherwise.
      * @example
      * ```ts
@@ -163,7 +148,7 @@ declare global {
      * });
      * ```
      */
-    function set_listener(callback?: (self: unknown, event: typeof WINDOW_EVENT_FOCUS_LOST | typeof WINDOW_EVENT_FOCUS_GAINED | typeof WINDOW_EVENT_RESIZED | typeof WINDOW_EVENT_ICONFIED | typeof WINDOW_EVENT_DEICONIFIED, data: Record<string | number, unknown>) => void): void;
+    function set_listener(callback: ((self: unknown, event: (typeof window)[Extract<keyof typeof window, `WINDOW_EVENT_${string}`>], data: Record<string | number, unknown>) => void) | undefined): void;
     /**
      * Set the locking state for current mouse cursor on a PC platform.
      * This function locks or unlocks the mouse cursor to the center point of the window. While the cursor is locked,

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

@@ -1,5 +1,5 @@
 /** @noSelfInFile */
-import type { Hash, Opaque, Vector3 } from "../../../src/core-types";
+import type { Opaque, Vector3 } from "../../../src/core-types";
 
 declare global {
   /**
@@ -114,7 +114,7 @@ declare global {
      * }
      * ```
      */
-    function create_chain(body: Opaque<"b2Body">, definition: Record<string | number, unknown>): LuaMultiReturn<[Opaque<"b2Chain">, { shape_id: number }[]]>;
+    function create_chain(body: Opaque<"b2Body">, definition: { vertices: Vector3[]; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3; friction?: number; restitution?: number; material?: number; filter?: { category_bits?: number; mask_bits?: number; group_index?: number }; enable_sensor_events?: boolean }): LuaMultiReturn<[Opaque<"b2Chain">, { shape_id: number }[]]>;
     /**
      * Creates a fixture and attach it to this body. Use this function if you need
      * to set some fixture parameters, like friction. Otherwise you can create the
@@ -132,7 +132,7 @@ declare global {
      * `polygon` = `{ type = b2d.shape.SHAPE_TYPE_POLYGON, vertices = { vector3, ... } }`
      * `box` = `{ type = b2d.shape.SHAPE_TYPE_BOX, hx = number, hy = number, center = vector3_or_nil, angle = radians_or_nil }`
      * `chain` = `{ type = b2d.shape.SHAPE_TYPE_CHAIN, vertices = { vector3, ... }, loop = boolean_or_nil, prev_vertex = vector3_or_nil, next_vertex = vector3_or_nil }`
-     * @returns fixture info table with `index`, `type`, `sensor`, `density`, `friction`, `restitution`, and `child_count`
+     * @returns fixture info table with `index`, `type`, `sensor`, `density`, `friction`, `restitution`, and `child_count`. **⚠️ `index` is 1-based; passed to Defold unchanged.**
      * @example
      * ```ts
      * const body = b2d.get_body("#collisionobject");
@@ -144,18 +144,7 @@ declare global {
      * }
      * ```
      */
-    function create_fixture(body: Opaque<"b2Body">, definition: { shape?: { type?: number; radius?: number; center?: Vector3; v0?: Vector3; v1?: Vector3; v2?: Vector3; v3?: Vector3; vertices?: Vector3[]; hx?: number; hy?: number; angle?: number; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }; friction?: number; restitution?: number; density?: number; sensor?: boolean; filter?: { category_bits?: number; mask_bits?: number; group_index?: number } }): { index: number; type: number; sensor: boolean; density: number; friction: number; restitution: number; child_count: number };
-    /**
-     * Creates a fixture from a shape and attach it to this body.
-     * This is a convenience function. Use b2FixtureDef if you need to set parameters
-     * like friction, restitution, user data, or filtering.
-     * If the density is non-zero, this function automatically updates the mass of the body.
-     *
-     * @param body - body
-     * @param shape - the shape to be cloned.
-     * @param density - the shape density (set to zero for static bodies).
-     */
-    function create_fixture(body: Opaque<"b2Body">, shape: Opaque<"b2Shape">, density: number): void;
+    function create_fixture(body: Opaque<"b2Body">, definition: { shape: { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; hx: number; hy: number; center?: Vector3; angle?: number } | { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; vertices: Vector3[] } | { type: typeof b2d.shape.SHAPE_TYPE_CIRCLE; radius: number; center?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_EDGE; v1: Vector3; v2: Vector3; v0?: Vector3; v3?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CHAIN; vertices: Vector3[]; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }; friction?: number; restitution?: number; density?: number; sensor?: boolean; is_sensor?: boolean; filter?: { category_bits: number; mask_bits: number; group_index: number } }): { index: number; type: number; sensor: boolean; density: number; friction: number; restitution: number; child_count: number };
     /**
      * Creates a shape and attaches it to this body.
      * If the density is non-zero, this function automatically updates the mass of the body.
@@ -166,13 +155,14 @@ declare global {
      *
      * @param body - body
      * @param definition - the shape definition.
+     * @returns **⚠️ `index` is 1-based; passed to Defold unchanged.**
      */
-    function create_shape(body: Opaque<"b2Body">, definition: Record<string | number, unknown>): void;
+    function create_shape(body: Opaque<"b2Body">, definition: ({ shape: { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; hx: number; hy: number; center?: Vector3; angle?: number } | { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; vertices: Vector3[] } | { type: typeof b2d.shape.SHAPE_TYPE_CIRCLE; radius: number; center?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CAPSULE; radius: number; center1: Vector3; center2: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_EDGE | typeof b2d.shape.SHAPE_TYPE_SEGMENT; v1: Vector3; v2: Vector3 } } | { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; hx: number; hy: number; center?: Vector3; angle?: number } | { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; vertices: Vector3[] } | { type: typeof b2d.shape.SHAPE_TYPE_CIRCLE; radius: number; center?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CAPSULE; radius: number; center1: Vector3; center2: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_EDGE | typeof b2d.shape.SHAPE_TYPE_SEGMENT; v1: Vector3; v2: Vector3 }) & { density?: number; friction?: number; restitution?: number; material?: number; sensor?: boolean; is_sensor?: boolean; filter?: { category_bits: number; mask_bits: number; group_index: number } }): { index: number; shape_id: Opaque<"b2Shape">; type: number; sensor: boolean; density: number; friction: number; restitution: number; material: number; child_count: number; is_chain_segment: boolean };
     /**
      * Destroy a fixture from a body.
      *
      * @param body - body
-     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`
+     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`. **⚠️ 1-based; passed to Defold unchanged.**
      */
     function destroy_fixture(body: Opaque<"b2Body">, fixture_index: number): void;
     /**
@@ -183,7 +173,7 @@ declare global {
      * All shapes attached to a body are implicitly destroyed when the body is destroyed.
      *
      * @param body - body
-     * @param shape_index - 1-based shape index from `b2d.body.get_shapes`
+     * @param shape_index - 1-based shape index from `b2d.body.get_shapes`. **⚠️ 1-based; passed to Defold unchanged.**
      */
     function destroy_shape(body: Opaque<"b2Body">, shape_index: number): void;
     /**
@@ -241,18 +231,11 @@ declare global {
      * @returns array of contact tables
      */
     function get_contact_data(body: Opaque<"b2Body">): Record<string | number, unknown>;
-    /**
-     * Get the list of all contacts attached to this body.
-     *
-     * @param body - body
-     * @returns the first edge
-     */
-    function get_contact_list(body: Opaque<"b2Body">): Opaque<"b2ContactEdge">;
     /**
      * Get the fixtures attached to this body.
      *
      * @param body - body
-     * @returns array of fixture info tables with `index`, `type`, `sensor`, `density`, `friction`, `restitution`, and `child_count`
+     * @returns array of fixture info tables with `index`, `type`, `sensor`, `density`, `friction`, `restitution`, and `child_count`. **⚠️ `index` is 1-based; passed to Defold unchanged.**
      */
     function get_fixtures(body: Opaque<"b2Body">): { index: number; type: number; sensor: boolean; density: number; friction: number; restitution: number; child_count: number }[];
     /**
@@ -426,26 +409,12 @@ declare global {
      * @returns the body type
      */
     function get_type(body: Opaque<"b2Body">): (number & { readonly __brand: "b2d.body.B2_DYNAMIC_BODY" }) | (number & { readonly __brand: "b2d.body.B2_KINEMATIC_BODY" }) | (number & { readonly __brand: "b2d.body.B2_STATIC_BODY" });
-    /**
-     * Get the user data pointer that was provided in the body definition.
-     *
-     * @param body - body
-     * @returns the game object id this body is connected to
-     */
-    function get_user_data(body: Opaque<"b2Body">): Hash;
     /**
      * Get the parent world of this body.
      *
      * @param body - body
      */
     function get_world(body: Opaque<"b2Body">): Opaque<"b2World">;
-    /**
-     * Get the angle in radians.
-     *
-     * @param body - body
-     * @returns the current world rotation angle in radians.
-     */
-    function get_world_center(body: Opaque<"b2Body">): number;
     /**
      * Get the world position of the center of mass.
      *
@@ -613,14 +582,7 @@ declare global {
      * @param body - body
      * @param data - table with `mass`, `center` in local coordinates, and `inertia`.
      */
-    function set_mass_data(body: Opaque<"b2Body">, data: { mass?: number; center?: Vector3; inertia?: number }): void;
-    /**
-     * Set the mass properties to override the mass properties of the shapes.
-     *
-     * @param body - body
-     * @param data - the mass properties.
-     */
-    function set_mass_data(body: Opaque<"b2Body">, data: Opaque<"b2MassData">): void;
+    function set_mass_data(body: Opaque<"b2Body">, data: { mass: number; center: Vector3; inertia: number }): void;
     /**
      * Set the body name.
      *
@@ -668,13 +630,6 @@ declare global {
      * @param type - the body type
      */
     function set_type(body: Opaque<"b2Body">, type: (number & { readonly __brand: "b2d.body.B2_DYNAMIC_BODY" }) | (number & { readonly __brand: "b2d.body.B2_KINEMATIC_BODY" }) | (number & { readonly __brand: "b2d.body.B2_STATIC_BODY" })): void;
-    /**
-     * Set the user data. Use this to store your application specific data.
-     *
-     * @param body - body
-     * @param id - the game object id
-     */
-    function set_user_data(body: Opaque<"b2Body">, id: Hash): void;
   }
 }
 

package/generated/versions/defold-1.13.0/b2d_fixture.d.ts

@@ -11,8 +11,8 @@ declare global {
      * Get fixture AABB for a child shape.
      *
      * @param body - body
-     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`
-     * @param child_index - 1-based child shape index
+     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`. **⚠️ 1-based; passed to Defold unchanged.**
+     * @param child_index - 1-based child shape index. **⚠️ 1-based; passed to Defold unchanged.**
      * @returns table with `lower` and `upper`
      */
     function get_aabb(body: Opaque<"b2Body">, fixture_index: number, child_index: number): { lower: Vector3; upper: Vector3 };
@@ -20,7 +20,7 @@ declare global {
      * Get fixture density.
      *
      * @param body - body
-     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`
+     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`. **⚠️ 1-based; passed to Defold unchanged.**
      * @returns density in kg/m^2
      */
     function get_density(body: Opaque<"b2Body">, fixture_index: number): number;
@@ -28,8 +28,8 @@ declare global {
      * Get fixture filter data for a child shape.
      *
      * @param body - body
-     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`
-     * @param child_index - 1-based child shape index
+     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`. **⚠️ 1-based; passed to Defold unchanged.**
+     * @param child_index - 1-based child shape index. **⚠️ 1-based; passed to Defold unchanged.**
      * @returns table with `category_bits`, `mask_bits`, and `group_index`
      */
     function get_filter_data(body: Opaque<"b2Body">, fixture_index: number, child_index: number): { category_bits: number; mask_bits: number; group_index: number };
@@ -37,47 +37,47 @@ declare global {
      * Get fixture friction.
      *
      * @param body - body
-     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`
+     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`. **⚠️ 1-based; passed to Defold unchanged.**
      */
     function get_friction(body: Opaque<"b2Body">, fixture_index: number): number;
     /**
      * Get fixture restitution.
      *
      * @param body - body
-     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`
+     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`. **⚠️ 1-based; passed to Defold unchanged.**
      */
     function get_restitution(body: Opaque<"b2Body">, fixture_index: number): number;
     /**
      * Get the fixture shape as a functional shape table.
      *
      * @param body - body
-     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`
+     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`. **⚠️ 1-based; passed to Defold unchanged.**
      * @returns shape table with numeric `type` from `b2d.shape.SHAPE_TYPE_*`,
      * suitable for reuse in `b2d.body.create_fixture`.
      * Circle shapes use `radius` and `center`, edge shapes use `v1`, `v2`, optional `v0`, `v3`,
      * polygon shapes use `vertices`, and chain shapes use `vertices`, `loop`, optional `prev_vertex`, and `next_vertex`.
      * Any angle values are in radians.
      */
-    function get_shape(body: Opaque<"b2Body">, fixture_index: number): { type: number; radius?: number; center?: Vector3; v0?: Vector3; v1?: Vector3; v2?: Vector3; v3?: Vector3; vertices?: Vector3[]; hx?: number; hy?: number; angle?: number; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 };
+    function get_shape(body: Opaque<"b2Body">, fixture_index: number): { type: number; radius?: number; center?: Vector3; v0?: Vector3; v1?: Vector3; v2?: Vector3; v3?: Vector3; vertices?: Vector3[]; hx?: number; hy?: number; angle?: number; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3; center1?: Vector3; center2?: Vector3 };
     /**
      * Get the fixture type.
      *
      * @param body - body
-     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`
+     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`. **⚠️ 1-based; passed to Defold unchanged.**
      */
     function get_type(body: Opaque<"b2Body">, fixture_index: number): number;
     /**
      * Check if a fixture is a sensor.
      *
      * @param body - body
-     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`
+     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`. **⚠️ 1-based; passed to Defold unchanged.**
      */
     function is_sensor(body: Opaque<"b2Body">, fixture_index: number): boolean;
     /**
      * Refilter a fixture.
      *
      * @param body - body
-     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`
+     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`. **⚠️ 1-based; passed to Defold unchanged.**
      * @param touch_proxies - if true, touch broad-phase proxies
      */
     function refilter(body: Opaque<"b2Body">, fixture_index: number, touch_proxies: boolean): void;
@@ -85,39 +85,39 @@ declare global {
      * Set fixture density.
      *
      * @param body - body
-     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`
+     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`. **⚠️ 1-based; passed to Defold unchanged.**
      * @param density - density in kg/m^2
      * @param update_mass - if true, reset body mass data after the change
      */
-    function set_density(body: Opaque<"b2Body">, fixture_index: number, density: number, update_mass: boolean): void;
+    function set_density(body: Opaque<"b2Body">, fixture_index: number, density: number, update_mass?: boolean): void;
     /**
      * Set fixture filter data for a child shape.
      *
      * @param body - body
-     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`
-     * @param child_index - 1-based child shape index
+     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`. **⚠️ 1-based; passed to Defold unchanged.**
+     * @param child_index - 1-based child shape index. **⚠️ 1-based; passed to Defold unchanged.**
      * @param filter - table with `category_bits`, `mask_bits`, and `group_index`
      */
-    function set_filter_data(body: Opaque<"b2Body">, fixture_index: number, child_index: number, filter: { category_bits?: number; mask_bits?: number; group_index?: number }): void;
+    function set_filter_data(body: Opaque<"b2Body">, fixture_index: number, child_index: number, filter: { category_bits: number; mask_bits: number; group_index: number }): void;
     /**
      * Set fixture friction.
      *
      * @param body - body
-     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`
+     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`. **⚠️ 1-based; passed to Defold unchanged.**
      */
     function set_friction(body: Opaque<"b2Body">, fixture_index: number, friction: number): void;
     /**
      * Set fixture restitution.
      *
      * @param body - body
-     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`
+     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`. **⚠️ 1-based; passed to Defold unchanged.**
      */
     function set_restitution(body: Opaque<"b2Body">, fixture_index: number, restitution: number): void;
     /**
      * Set sensor mode for a fixture.
      *
      * @param body - body
-     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`
+     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`. **⚠️ 1-based; passed to Defold unchanged.**
      */
     function set_sensor(body: Opaque<"b2Body">, fixture_index: number, enabled: boolean): void;
     /**
@@ -128,7 +128,7 @@ declare global {
      * The body mass is not updated unless `update_mass` is true.
      *
      * @param body - body
-     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`
+     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`. **⚠️ 1-based; passed to Defold unchanged.**
      * @param shape - shape table with numeric `type` from `b2d.shape.SHAPE_TYPE_*`
      * @param update_mass - if true, reset body mass data after the change
      * @example
@@ -136,18 +136,18 @@ declare global {
      * const body = b2d.get_body("#collisionobject");
      * if (body !== undefined) {
      *   const circle = b2d.fixture.get_shape(body, 1);
-     *   circle.center = vmath.vector3(24, 0, 0);
-     *   b2d.fixture.set_shape(body, 1, circle, true);
+     *   const radius = "radius" in circle ? circle.radius : undefined;
+     *   b2d.fixture.set_shape(body, 1, { type: b2d.shape.SHAPE_TYPE_CIRCLE, radius: radius ?? 16, center: vmath.vector3(24, 0, 0) }, true);
      *   b2d.fixture.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_EDGE, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });
      * }
      * ```
      */
-    function set_shape(body: Opaque<"b2Body">, fixture_index: number, shape: { type?: number; radius?: number; center?: Vector3; v0?: Vector3; v1?: Vector3; v2?: Vector3; v3?: Vector3; vertices?: Vector3[]; hx?: number; hy?: number; angle?: number; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, update_mass?: boolean): void;
+    function set_shape(body: Opaque<"b2Body">, fixture_index: number, shape: { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; hx: number; hy: number; center?: Vector3; angle?: number } | { type: typeof b2d.shape.SHAPE_TYPE_POLYGON | typeof b2d.shape.SHAPE_TYPE_BOX; vertices: Vector3[] } | { type: typeof b2d.shape.SHAPE_TYPE_CIRCLE; radius: number; center?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_EDGE; v1: Vector3; v2: Vector3; v0?: Vector3; v3?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CHAIN; vertices: Vector3[]; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, update_mass?: boolean): void;
     /**
      * Test a point against a fixture.
      *
      * @param body - body
-     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`
+     * @param fixture_index - 1-based fixture index from `b2d.body.get_fixtures`. **⚠️ 1-based; passed to Defold unchanged.**
      * @param point - point in world coordinates
      */
     function test_point(body: Opaque<"b2Body">, fixture_index: number, point: Vector3): boolean;