@defold-typescript/types 0.40.0 → 0.42.0

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

@@ -47,6 +47,13 @@ declare global {
      * @returns true if contact events are enabled
      */
     function are_contact_events_enabled(shape_id: Opaque<"b2Shape">): boolean;
+    /**
+     * Check if contact events are enabled for a shape.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @returns true if contact events are enabled
+     */
     function are_contact_events_enabled(body: Opaque<"b2Body">, shape_index: number): boolean;
     /**
      * Check if hit events are enabled for a shape.
@@ -55,6 +62,13 @@ declare global {
      * @returns true if hit events are enabled
      */
     function are_hit_events_enabled(shape_id: Opaque<"b2Shape">): boolean;
+    /**
+     * Check if hit events are enabled for a shape.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @returns true if hit events are enabled
+     */
     function are_hit_events_enabled(body: Opaque<"b2Body">, shape_index: number): boolean;
     /**
      * Check if pre-solve events are enabled for a shape.
@@ -63,6 +77,13 @@ declare global {
      * @returns true if pre-solve events are enabled
      */
     function are_pre_solve_events_enabled(shape_id: Opaque<"b2Shape">): boolean;
+    /**
+     * Check if pre-solve events are enabled for a shape.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @returns true if pre-solve events are enabled
+     */
     function are_pre_solve_events_enabled(body: Opaque<"b2Body">, shape_index: number): boolean;
     /**
      * Check if sensor events are enabled for a shape.
@@ -71,6 +92,13 @@ declare global {
      * @returns true if sensor events are enabled
      */
     function are_sensor_events_enabled(shape_id: Opaque<"b2Shape">): boolean;
+    /**
+     * Check if sensor events are enabled for a shape.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @returns true if sensor events are enabled
+     */
     function are_sensor_events_enabled(body: Opaque<"b2Body">, shape_index: number): boolean;
     /**
      * Enable or disable contact events for a shape.
@@ -79,6 +107,13 @@ declare global {
      * @param enable - true to enable contact events
      */
     function enable_contact_events(shape_id: Opaque<"b2Shape">, enable: boolean): void;
+    /**
+     * Enable or disable contact events for a shape.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @param enable - true to enable contact events
+     */
     function enable_contact_events(body: Opaque<"b2Body">, shape_index: number, enable: boolean): void;
     /**
      * Enable or disable hit events for a shape.
@@ -87,6 +122,13 @@ declare global {
      * @param enable - true to enable hit events
      */
     function enable_hit_events(shape_id: Opaque<"b2Shape">, enable: boolean): void;
+    /**
+     * Enable or disable hit events for a shape.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @param enable - true to enable hit events
+     */
     function enable_hit_events(body: Opaque<"b2Body">, shape_index: number, enable: boolean): void;
     /**
      * Enable or disable pre-solve events for a shape.
@@ -95,6 +137,13 @@ declare global {
      * @param enable - true to enable pre-solve events
      */
     function enable_pre_solve_events(shape_id: Opaque<"b2Shape">, enable: boolean): void;
+    /**
+     * Enable or disable pre-solve events for a shape.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @param enable - true to enable pre-solve events
+     */
     function enable_pre_solve_events(body: Opaque<"b2Body">, shape_index: number, enable: boolean): void;
     /**
      * Enable or disable sensor events for a shape.
@@ -103,6 +152,13 @@ declare global {
      * @param enable - true to enable sensor events
      */
     function enable_sensor_events(shape_id: Opaque<"b2Shape">, enable: boolean): void;
+    /**
+     * Enable or disable sensor events for a shape.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @param enable - true to enable sensor events
+     */
     function enable_sensor_events(body: Opaque<"b2Body">, shape_index: number, enable: boolean): void;
     /**
      * Get the body owning a shape.
@@ -111,6 +167,13 @@ declare global {
      * @returns owning body
      */
     function get_body(shape_id: Opaque<"b2Shape">): Opaque<"b2Body">;
+    /**
+     * Get the body owning a shape.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @returns owning body
+     */
     function get_body(body: Opaque<"b2Body">, shape_index: number): Opaque<"b2Body">;
     /**
      * Get the closest point on a shape.
@@ -120,6 +183,14 @@ declare global {
      * @returns closest world point on the shape
      */
     function get_closest_point(shape_id: Opaque<"b2Shape">, target: Vector3): Vector3;
+    /**
+     * Get the closest point on a shape.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @param target - world target point
+     * @returns closest world point on the shape
+     */
     function get_closest_point(body: Opaque<"b2Body">, shape_index: number, target: Vector3): Vector3;
     /**
      * Get shape contact capacity.
@@ -128,6 +199,13 @@ declare global {
      * @returns maximum contact data count
      */
     function get_contact_capacity(shape_id: Opaque<"b2Shape">): number;
+    /**
+     * Get shape contact capacity.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @returns maximum contact data count
+     */
     function get_contact_capacity(body: Opaque<"b2Body">, shape_index: number): number;
     /**
      * Get touching contact data for a shape.
@@ -136,6 +214,13 @@ declare global {
      * @returns array of contact tables
      */
     function get_contact_data(shape_id: Opaque<"b2Shape">): Record<string | number, unknown>;
+    /**
+     * Get touching contact data for a shape.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @returns array of contact tables
+     */
     function get_contact_data(body: Opaque<"b2Body">, shape_index: number): Record<string | number, unknown>;
     /**
      * Get mass data for a shape.
@@ -144,6 +229,13 @@ declare global {
      * @returns table with `mass`, `center`, and `inertia`
      */
     function get_mass_data(shape_id: Opaque<"b2Shape">): { mass: number; center: Vector3; inertia: number };
+    /**
+     * Get mass data for a shape.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @returns table with `mass`, `center`, and `inertia`
+     */
     function get_mass_data(body: Opaque<"b2Body">, shape_index: number): { mass: number; center: Vector3; inertia: number };
     /**
      * Get shape material id.
@@ -152,6 +244,13 @@ declare global {
      * @returns shape material id
      */
     function get_material(shape_id: Opaque<"b2Shape">): number;
+    /**
+     * Get shape material id.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @returns shape material id
+     */
     function get_material(body: Opaque<"b2Body">, shape_index: number): number;
     /**
      * Get sensor overlap capacity.
@@ -160,6 +259,13 @@ declare global {
      * @returns maximum sensor overlap count
      */
     function get_sensor_capacity(shape_id: Opaque<"b2Shape">): number;
+    /**
+     * Get sensor overlap capacity.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @returns maximum sensor overlap count
+     */
     function get_sensor_capacity(body: Opaque<"b2Body">, shape_index: number): number;
     /**
      * Get sensor overlaps.
@@ -168,6 +274,13 @@ declare global {
      * @returns array of shape info tables
      */
     function get_sensor_overlaps(shape_id: Opaque<"b2Shape">): { shape_id: number }[];
+    /**
+     * Get sensor overlaps.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @returns array of shape info tables
+     */
     function get_sensor_overlaps(body: Opaque<"b2Body">, shape_index: number): { shape_id: number }[];
     /**
      * Get a shape's geometry.
@@ -175,8 +288,15 @@ declare global {
      * @param shape_id - shape handle from a shape info table, or pass `body, shape_index`
      * @returns shape table with numeric `type` from `b2d.shape.SHAPE_TYPE_*`
      */
-    function get_shape(shape_id: Opaque<"b2Shape">): { 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">, shape_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(shape_id: Opaque<"b2Shape">): { 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 a shape's geometry.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @returns shape table with numeric `type` from `b2d.shape.SHAPE_TYPE_*`
+     */
+    function get_shape(body: Opaque<"b2Body">, shape_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 world owning a shape.
      *
@@ -184,6 +304,13 @@ declare global {
      * @returns owning world
      */
     function get_world(shape_id: Opaque<"b2Shape">): Opaque<"b2World">;
+    /**
+     * Get the world owning a shape.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @returns owning world
+     */
     function get_world(body: Opaque<"b2Body">, shape_index: number): Opaque<"b2World">;
     /**
      * Validate a shape handle.
@@ -192,6 +319,13 @@ declare global {
      * @returns true if the shape handle still refers to a live Box2D shape
      */
     function is_valid(shape_id: Opaque<"b2Shape">): boolean;
+    /**
+     * Validate a shape handle.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @returns true if the shape handle still refers to a live Box2D shape
+     */
     function is_valid(body: Opaque<"b2Body">, shape_index: number): boolean;
     /**
      * Ray cast a shape directly.
@@ -202,8 +336,18 @@ declare global {
      * @param max_fraction - optional maximum translation fraction, defaults to 1
      * @returns hit table with `point`, `normal`, `fraction`, and `iterations`, or nil
      */
-    function ray_cast(shape_id: Opaque<"b2Shape">, origin: Vector3, translation: Vector3, max_fraction?: number): { point: Vector3; normal: Vector3; fraction: number; iterations: number };
-    function ray_cast(body: Opaque<"b2Body">, shape_index: number, origin: Vector3, translation: Vector3, max_fraction?: number): { point: Vector3; normal: Vector3; fraction: number; iterations: number };
+    function ray_cast(shape_id: Opaque<"b2Shape">, origin: Vector3, translation: Vector3, max_fraction?: number): { point: Vector3; normal: Vector3; fraction: number; iterations: number } | undefined;
+    /**
+     * Ray cast a shape directly.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @param origin - world ray origin
+     * @param translation - world ray translation
+     * @param max_fraction - optional maximum translation fraction, defaults to 1
+     * @returns hit table with `point`, `normal`, `fraction`, and `iterations`, or nil
+     */
+    function ray_cast(body: Opaque<"b2Body">, shape_index: number, origin: Vector3, translation: Vector3, max_fraction?: number): { point: Vector3; normal: Vector3; fraction: number; iterations: number } | undefined;
     /**
      * Set shape material id.
      *
@@ -211,6 +355,13 @@ declare global {
      * @param material - shape material id
      */
     function set_material(shape_id: Opaque<"b2Shape">, material: number): void;
+    /**
+     * Set shape material id.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @param material - shape material id
+     */
     function set_material(body: Opaque<"b2Body">, shape_index: number, material: number): void;
     /**
      * This updates the shape geometry using the same table format as
@@ -225,14 +376,24 @@ declare global {
      * const body = b2d.get_body("#collisionobject");
      * if (body !== undefined) {
      *   const circle = b2d.shape.get_shape(body, 1);
-     *   circle.center = vmath.vector3(24, 0, 0);
-     *   b2d.shape.set_shape(body, 1, circle, true);
+     *   const radius = "radius" in circle ? circle.radius : undefined;
+     *   b2d.shape.set_shape(body, 1, { type: b2d.shape.SHAPE_TYPE_CIRCLE, radius: radius ?? 16, center: vmath.vector3(24, 0, 0) }, true);
      *   b2d.shape.set_shape(body, 2, { type: b2d.shape.SHAPE_TYPE_SEGMENT, v1: vmath.vector3(-32, 0, 0), v2: vmath.vector3(32, 0, 0) });
      * }
      * ```
      */
-    function set_shape(shape_id: Opaque<"b2Shape">, definition: { 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">, shape_index: number, definition: { 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(shape_id: Opaque<"b2Shape">, definition: { 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 }, update_mass?: boolean): void;
+    /**
+     * This updates the shape geometry using the same table format as
+     * `b2d.body.create_shape` and `b2d.shape.get_shape`. The body mass is not
+     * updated unless `update_mass` is true.
+     *
+     * @param body - The body that owns the shape.
+     * @param shape_index - The shape's position on that body, in the order `b2d.body.get_shapes` lists them. **⚠️ 1-based; passed to Defold unchanged.**
+     * @param definition - shape table with numeric `type` from `b2d.shape.SHAPE_TYPE_*`
+     * @param update_mass - true to reset body mass from shapes
+     */
+    function set_shape(body: Opaque<"b2Body">, shape_index: number, definition: { 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 }, update_mass?: boolean): void;
   }
 }
 

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

@@ -17,7 +17,7 @@ declare global {
      * @param filter - optional query filter with `category_bits` and `mask_bits`
      * @returns travel fraction before collision
      */
-    function cast_mover(world: Opaque<"b2World">, capsule: { center1?: Vector3; center2?: Vector3; radius?: number }, translation: Vector3, filter?: { category_bits?: number; mask_bits?: number }): number;
+    function cast_mover(world: Opaque<"b2World">, capsule: { center1: Vector3; center2: Vector3; radius: number }, translation: Vector3, filter?: { category_bits?: number; mask_bits?: number }): number;
     /**
      * Cast a ray.
      *
@@ -48,7 +48,7 @@ declare global {
      * @param filter - optional query filter with `category_bits`, `mask_bits`, and optional `group_index`
      * @returns hit table with `fixture`, `shape`, `point`, `normal`, `fraction`, `node_visits`, and `leaf_visits`, or nil
      */
-    function cast_ray_closest(world: Opaque<"b2World">, origin: Vector3, translation: Vector3, filter: { category_bits?: number; mask_bits?: number; group_index?: number }): { fixture: number; shape: number; point: Vector3; normal: Vector3; fraction: number; node_visits: number; leaf_visits: number };
+    function cast_ray_closest(world: Opaque<"b2World">, origin: Vector3, translation: Vector3, filter: { category_bits?: number; mask_bits?: number; group_index?: number }): { fixture: number; shape: number; point: Vector3; normal: Vector3; fraction: number; node_visits: number; leaf_visits: number } | undefined;
     /**
      * The translation is the ray displacement from `origin`.
      *
@@ -69,7 +69,7 @@ declare global {
      * @param filter - optional query filter with `category_bits`, `mask_bits`, and optional `group_index`
      * @param max_results - optional maximum result count
      */
-    function cast_shape(world: Opaque<"b2World">, 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 }, translation: Vector3, filter: { category_bits?: number; mask_bits?: number; group_index?: number }, max_results: number): LuaMultiReturn<[{ fixture: number; shape: number; point: Vector3; normal: Vector3; fraction: number }[], { node_visits: number; leaf_visits: number }]>;
+    function cast_shape(world: Opaque<"b2World">, 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; v0?: Vector3; v3?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CHAIN; vertices: Vector3[]; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, translation: Vector3, filter: { category_bits?: number; mask_bits?: number; group_index?: number }, max_results: number): LuaMultiReturn<[{ fixture: number; shape: number; point: Vector3; normal: Vector3; fraction: number }[], { node_visits: number; leaf_visits: number }]>;
     /**
      * The shape table uses the same circle, capsule, segment, polygon, and box formats
      * as `b2d.body.create_shape`. The translation is the shape displacement.
@@ -80,7 +80,7 @@ declare global {
      * @param filter - optional query filter with `category_bits` and `mask_bits`
      * @param max_results - optional maximum result count. Omit or pass 0 for unlimited results.
      */
-    function cast_shape(world: Opaque<"b2World">, 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 }, translation: Vector3, filter?: { category_bits?: number; mask_bits?: number; group_index?: number }, max_results?: number): LuaMultiReturn<[{ fixture: number; shape: number; point: Vector3; normal: Vector3; fraction: number }[], { node_visits: number; leaf_visits: number }]>;
+    function cast_shape(world: Opaque<"b2World">, 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; v0?: Vector3; v3?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CHAIN; vertices: Vector3[]; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, translation: Vector3, filter?: { category_bits?: number; mask_bits?: number; group_index?: number }, max_results?: number): LuaMultiReturn<[{ fixture: number; shape: number; point: Vector3; normal: Vector3; fraction: number }[], { node_visits: number; leaf_visits: number }]>;
     /**
      * The capsule table has `center1`, `center2`, and `radius` fields. Plane result
      * tables include `shape`, `normal`, `offset`, and `hit`.
@@ -91,7 +91,7 @@ declare global {
      * @param max_results - optional maximum result count. Omit or pass 0 for unlimited results.
      * @returns array of plane result tables
      */
-    function collide_mover(world: Opaque<"b2World">, capsule: { center1?: Vector3; center2?: Vector3; radius?: number }, filter?: { category_bits?: number; mask_bits?: number }, max_results?: number): Record<string | number, unknown>;
+    function collide_mover(world: Opaque<"b2World">, capsule: { center1: Vector3; center2: Vector3; radius: number }, filter?: { category_bits?: number; mask_bits?: number }, max_results?: number): Record<string | number, unknown>;
     /**
      * Enable or disable continuous collision.
      *
@@ -127,7 +127,7 @@ declare global {
      * @param world - world
      * @param definition - explosion definition
      */
-    function explode(world: Opaque<"b2World">, definition: Record<string | number, unknown>): void;
+    function explode(world: Opaque<"b2World">, definition: { position: Vector3; radius: number; falloff: number; impulse_per_length: number; mask_bits?: number }): void;
     /**
      * Get the number of awake bodies.
      *
@@ -227,8 +227,11 @@ declare global {
      * @param aabb - table with `lower` and `upper` vector3 fields
      * @param filter - optional query filter with `category_bits`, `mask_bits`, and optional `group_index`
      * @param max_results - optional maximum result count
+     * @returns `[fixtures, stats]`:
+     * - `fixtures` — array of fixture info tables. **⚠️ `index` is 1-based; passed to Defold unchanged.**
+     * - `stats` — table with `node_visits` and `leaf_visits`
      */
-    function overlap_aabb(world: Opaque<"b2World">, aabb: { lower?: Vector3; upper?: Vector3 }, filter: { category_bits?: number; mask_bits?: number; group_index?: number }, max_results: number): LuaMultiReturn<[{ index: number; type: number; sensor: boolean; density: number; friction: number; restitution: number; child_count: number }[], { node_visits: number; leaf_visits: number }]>;
+    function overlap_aabb(world: Opaque<"b2World">, aabb: { lower: Vector3; upper: Vector3 }, filter: { category_bits?: number; mask_bits?: number; group_index?: number }, max_results: number): LuaMultiReturn<[{ index: number; type: number; sensor: boolean; density: number; friction: number; restitution: number; child_count: number }[], { node_visits: number; leaf_visits: number }]>;
     /**
      * The AABB table has `lower` and `upper` `vector3` fields.
      *
@@ -237,7 +240,7 @@ declare global {
      * @param filter - optional query filter with `category_bits` and `mask_bits`
      * @param max_results - optional maximum result count. Omit or pass 0 for unlimited results.
      */
-    function overlap_aabb(world: Opaque<"b2World">, aabb: { lower?: Vector3; upper?: Vector3 }, filter?: { category_bits?: number; mask_bits?: number; group_index?: number }, max_results?: number): LuaMultiReturn<[{ shape_id: number }[], { node_visits: number; leaf_visits: number }]>;
+    function overlap_aabb(world: Opaque<"b2World">, aabb: { lower: Vector3; upper: Vector3 }, filter?: { category_bits?: number; mask_bits?: number; group_index?: number }, max_results?: number): LuaMultiReturn<[{ shape_id: number }[], { node_visits: number; leaf_visits: number }]>;
     /**
      * Overlap a shape.
      *
@@ -245,8 +248,11 @@ declare global {
      * @param shape - shape table using the same format as the `shape` field in `b2d.body.create_fixture`
      * @param filter - optional query filter with `category_bits`, `mask_bits`, and optional `group_index`
      * @param max_results - optional maximum result count
+     * @returns `[fixtures, stats]`:
+     * - `fixtures` — array of fixture info tables. **⚠️ `index` is 1-based; passed to Defold unchanged.**
+     * - `stats` — table with `node_visits` and `leaf_visits`
      */
-    function overlap_shape(world: Opaque<"b2World">, 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 }, filter: { category_bits?: number; mask_bits?: number; group_index?: number }, max_results: number): LuaMultiReturn<[{ index: number; type: number; sensor: boolean; density: number; friction: number; restitution: number; child_count: number }[], { node_visits: number; leaf_visits: number }]>;
+    function overlap_shape(world: Opaque<"b2World">, 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; v0?: Vector3; v3?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CHAIN; vertices: Vector3[]; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, filter: { category_bits?: number; mask_bits?: number; group_index?: number }, max_results: number): LuaMultiReturn<[{ index: number; type: number; sensor: boolean; density: number; friction: number; restitution: number; child_count: number }[], { node_visits: number; leaf_visits: number }]>;
     /**
      * The shape table uses the same circle, capsule, segment, polygon, and box formats
      * as `b2d.body.create_shape`.
@@ -256,7 +262,7 @@ declare global {
      * @param filter - optional query filter with `category_bits` and `mask_bits`
      * @param max_results - optional maximum result count. Omit or pass 0 for unlimited results.
      */
-    function overlap_shape(world: Opaque<"b2World">, 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 }, filter?: { category_bits?: number; mask_bits?: number; group_index?: number }, max_results?: number): LuaMultiReturn<[{ shape_id: number }[], { node_visits: number; leaf_visits: number }]>;
+    function overlap_shape(world: Opaque<"b2World">, 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; v0?: Vector3; v3?: Vector3 } | { type: typeof b2d.shape.SHAPE_TYPE_CHAIN; vertices: Vector3[]; loop?: boolean; prev_vertex?: Vector3; next_vertex?: Vector3 }, filter?: { category_bits?: number; mask_bits?: number; group_index?: number }, max_results?: number): LuaMultiReturn<[{ shape_id: number }[], { node_visits: number; leaf_visits: number }]>;
     /**
      * Rebuild the static broad-phase tree.
      *

package/generated/versions/defold-1.13.0/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.
      *