@defold-typescript/types 0.39.0 → 0.41.0

package/generated/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 {
   /**
@@ -8,6 +8,7 @@ declare global {
   namespace b2d.body {
     type b2Body = Opaque<"b2Body">;
     type b2World = Opaque<"b2World">;
+    type B2 = typeof b2d.body.B2_DYNAMIC_BODY | typeof b2d.body.B2_KINEMATIC_BODY | typeof b2d.body.B2_STATIC_BODY;
     /**
      * Dynamic body
      */
@@ -74,33 +75,14 @@ declare global {
      * Compute the world AABB of all body shapes.
      *
      * @param body - body
-     * @returns table with `lower` and `upper` vector3 fields
+     * @returns body bounds
      */
-    function compute_aabb(body: Opaque<"b2Body">): { lower: Vector3; upper: Vector3 };
+    function compute_aabb(body: Opaque<"b2Body">): b2d.aabb;
     /**
      * Chains are one-sided connected segments with optional ghost vertices at
      * the ends of open chains. Ghost vertices are creation-time chain data only and
      * cannot be added to arbitrary shapes, bodies, or joints after creation.
      *
-     * `definition.vertices`
-     * table array of local `vector3` vertices. Open chains require at least 2 vertices. Loop chains require at least 4 vertices.
-     * `definition.loop`
-     * boolean true to create a closed loop chain.
-     * `definition.prev_vertex`
-     * vector3 optional ghost vertex before the first vertex for open chains.
-     * `definition.next_vertex`
-     * vector3 optional ghost vertex after the last vertex for open chains.
-     * `definition.friction`
-     * number optional friction.
-     * `definition.restitution`
-     * number optional restitution.
-     * `definition.material`
-     * number optional material id.
-     * `definition.filter`
-     * table optional filter with `category_bits`, `mask_bits`, and `group_index`.
-     * `definition.enable_sensor_events`
-     * boolean true to enable sensor events for chain segments.
-     *
      * @param body - body
      * @param definition - the chain definition
      * @example
@@ -114,7 +96,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: b2d.chain_definition): LuaMultiReturn<[Opaque<"b2Chain">, b2d.shape_info[]]>;
     /**
      * 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
@@ -123,16 +105,8 @@ declare global {
      * Contacts are not created until the next time step.
      *
      * @param body - body
-     * @param definition - fixture definition table with:
-     * `shape` = shape table, `friction` = number, `restitution` = number,
-     * `density` = number, `sensor` = boolean, and optional `filter` table.
-     * Supported shape tables are:
-     * `circle` = `{ type = b2d.shape.SHAPE_TYPE_CIRCLE, radius = number, center = vector3_or_nil }`
-     * `edge` = `{ type = b2d.shape.SHAPE_TYPE_EDGE, v1 = vector3, v2 = vector3, v0 = vector3_or_nil, v3 = vector3_or_nil }`
-     * `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`
+     * @param definition - fixture definition
+     * @returns fixture information. **⚠️ `index` is 1-based; passed to Defold unchanged.**
      * @example
      * ```ts
      * const body = b2d.get_body("#collisionobject");
@@ -144,35 +118,22 @@ 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 } }): b2d.fixture_info;
     /**
      * Creates a shape and attaches it to this body.
      * If the density is non-zero, this function automatically updates the mass of the body.
      * Contacts are not created until the next time step.
-     * The definition may include `density`, `friction`, `restitution`, `material`,
-     * `sensor` or `is_sensor`, `filter`, and the shape table itself. The shape table
-     * can be in `definition.shape` or directly in `definition`.
      *
      * @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 +144,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;
     /**
@@ -240,21 +201,14 @@ declare global {
      * @param body - body
      * @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">;
+    function get_contact_data(body: Opaque<"b2Body">): b2d.contact_data[];
     /**
      * 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 the attached fixtures. **⚠️ `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 }[];
+    function get_fixtures(body: Opaque<"b2Body">): b2d.fixture_info[];
     /**
      * Get the total force currently applied on this object
      *
@@ -279,9 +233,9 @@ declare global {
      * Get the joints attached to this body.
      *
      * @param body - body
-     * @returns array of `b2Joint` handles created by `b2d.joint`
+     * @returns joint handles created by b2d.joint
      */
-    function get_joints(body: Opaque<"b2Body">): number[];
+    function get_joints(body: Opaque<"b2Body">): Opaque<"b2Joint">[];
     /**
      * Get the linear damping of the body.
      *
@@ -353,9 +307,9 @@ declare global {
      * Get the mass data of the body.
      *
      * @param body - body
-     * @returns table with `mass`, `center` in local coordinates, and `inertia`.
+     * @returns the mass data
      */
-    function get_mass_data(body: Opaque<"b2Body">): { mass: number; center: Vector3; inertia: number };
+    function get_mass_data(body: Opaque<"b2Body">): b2d.mass_data;
     /**
      * Get the mass data of the body.
      *
@@ -367,16 +321,16 @@ declare global {
      * Get the body name.
      *
      * @param body - body
-     * @returns body name, or nil if no name is set
+     * @returns body name, or `nil` if no name is set
      */
-    function get_name(body: Opaque<"b2Body">): string;
+    function get_name(body: Opaque<"b2Body">): string | undefined;
     /**
      * Get the next body in the world's body list.
      *
      * @param body - body
-     * @returns the next body
+     * @returns the next body, or `nil` if this is the last body
      */
-    function get_next(body: Opaque<"b2Body">): Opaque<"b2Body">;
+    function get_next(body: Opaque<"b2Body">): Opaque<"b2Body"> | undefined;
     /**
      * Get the world body origin position.
      *
@@ -395,9 +349,9 @@ declare global {
      * Get the list of all shapes attached to this body.
      *
      * @param body - body
-     * @returns a table of shape info entries. Each entry includes `shape_id` for use with `b2d.shape` functions.
+     * @returns attached shapes
      */
-    function get_shapes(body: Opaque<"b2Body">): { shape_id: number }[];
+    function get_shapes(body: Opaque<"b2Body">): b2d.shape_info[];
     /**
      * Get the sleep velocity threshold.
      *
@@ -409,9 +363,9 @@ declare global {
      * Get the body transform for the body's origin.
      *
      * @param body - body
-     * @returns table with `position` and `angle` in radians.
+     * @returns the body transform
      */
-    function get_transform(body: Opaque<"b2Body">): { position: Vector3; angle: number };
+    function get_transform(body: Opaque<"b2Body">): b2d.transform;
     /**
      * Get the body transform for the body's origin.
      *
@@ -426,26 +380,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.
      *
@@ -611,16 +551,9 @@ declare global {
      * Set the mass properties to override the mass properties of the fixtures.
      *
      * @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.
+     * @param data - the mass data
      */
-    function set_mass_data(body: Opaque<"b2Body">, data: Opaque<"b2MassData">): void;
+    function set_mass_data(body: Opaque<"b2Body">, data: b2d.mass_data): void;
     /**
      * Set the body name.
      *
@@ -668,13 +601,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/b2d_chain.d.ts

@@ -30,13 +30,12 @@ declare global {
      */
     function get_friction(chain: Opaque<"b2Chain">): number;
     /**
-     * Returns a chain geometry table with `loop`, `segment_count`, and `vertices`.
-     * Open chains also include `prev_vertex` and `next_vertex` ghost vertices.
+     * Get the chain geometry.
      *
      * @param chain - chain
-     * @returns chain geometry table
+     * @returns chain geometry
      */
-    function get_geometry(chain: Opaque<"b2Chain">): Record<string | number, unknown>;
+    function get_geometry(chain: Opaque<"b2Chain">): b2d.chain_geometry;
     /**
      * Get chain material id.
      *
@@ -62,9 +61,9 @@ declare global {
      * Get the segment shapes owned by a chain.
      *
      * @param chain - chain
-     * @returns array of shape info tables for the chain segments. Each entry includes `shape_id`.
+     * @returns chain segment shapes
      */
-    function get_segments(chain: Opaque<"b2Chain">): { shape_id: number }[];
+    function get_segments(chain: Opaque<"b2Chain">): b2d.shape_info[];
     /**
      * Get the world owning a chain.
      *

package/generated/b2d_fixture.d.ts

@@ -11,16 +11,16 @@ 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
-     * @returns table with `lower` and `upper`
+     * @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 the fixture AABB
      */
-    function get_aabb(body: Opaque<"b2Body">, fixture_index: number, child_index: number): { lower: Vector3; upper: Vector3 };
+    function get_aabb(body: Opaque<"b2Body">, fixture_index: number, child_index: number): b2d.aabb;
     /**
      * 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,56 +28,52 @@ 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
-     * @returns table with `category_bits`, `mask_bits`, and `group_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 the filter data
      */
-    function get_filter_data(body: Opaque<"b2Body">, fixture_index: number, child_index: number): { category_bits: number; mask_bits: number; group_index: number };
+    function get_filter_data(body: Opaque<"b2Body">, fixture_index: number, child_index: number): b2d.filter;
     /**
      * 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`
-     * @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.
+     * @param fixture_index - 1-based fixture index from b2d.body.get_fixtures. **⚠️ 1-based; passed to Defold unchanged.**
+     * @returns the shape definition, suitable for reuse in b2d.body.create_fixture
      */
-    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): b2d.shape.definition;
     /**
      * 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;
+    function get_type(body: Opaque<"b2Body">, fixture_index: number): b2d.shape.SHAPE_TYPE;
     /**
      * 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,69 +81,69 @@ 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 filter - table with `category_bits`, `mask_bits`, and `group_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 - the filter data
      */
-    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: b2d.filter): 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;
     /**
      * This updates the existing Box2D v2 shape using the same table format as
-     * `b2d.body.create_fixture` and `b2d.fixture.get_shape`.
+     * b2d.body.create_fixture and b2d.fixture.get_shape.
      * The shape type must match the current fixture shape type. Polygon updates must
      * keep the same vertex count. Chain shape geometry cannot be updated in-place.
      * 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 shape - shape table with numeric `type` from `b2d.shape.SHAPE_TYPE_*`
+     * @param fixture_index - 1-based fixture index from b2d.body.get_fixtures. **⚠️ 1-based; passed to Defold unchanged.**
+     * @param shape - the shape definition
      * @param update_mass - if true, reset body mass data after the change
      * @example
      * ```ts
      * 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;