goudengine 0.0.826 → 0.0.828

package/wasm/goud_engine.d.ts

@@ -1,75 +1,129 @@
 /* tslint:disable */
 /* eslint-disable */
 
-/**
- * Chroma subsampling format
- */
-export enum ChromaSampling {
-    /**
-     * Both vertically and horizontally subsampled.
-     */
-    Cs420 = 0,
-    /**
-     * Horizontally subsampled.
-     */
-    Cs422 = 1,
-    /**
-     * Not subsampled.
-     */
-    Cs444 = 2,
-    /**
-     * Monochrome.
-     */
-    Cs400 = 3,
+export class WasmContact {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    normal_x: number;
+    normal_y: number;
+    penetration: number;
+    point_x: number;
+    point_y: number;
 }
 
+/**
+ * The primary game handle for browser-based games.
+ *
+ * Owns the ECS world, input state, frame timing, and an optional wgpu
+ * rendering backend attached to an HTML canvas element.
+ */
 export class WasmGame {
     free(): void;
     [Symbol.dispose](): void;
+    aabb_overlap(min_ax: number, min_ay: number, max_ax: number, max_ay: number, min_bx: number, min_by: number, max_bx: number, max_by: number): boolean;
     add_name(entity_bits: bigint, name: string): void;
     add_scroll_delta(dx: number, dy: number): void;
+    add_sprite(entity_bits: bigint, texture_handle: number, r: number, g: number, b: number, a: number, flip_x: boolean, flip_y: boolean, anchor_x: number, anchor_y: number): void;
     add_transform2d(entity_bits: bigint, px: number, py: number, rotation: number, sx: number, sy: number): void;
+    /**
+     * Advances frame timing and prepares the wgpu surface for drawing.
+     *
+     * Call this at the start of each `requestAnimationFrame` callback.
+     */
     begin_frame(delta_time: number): void;
+    circle_overlap(x1: number, y1: number, r1: number, x2: number, y2: number, r2: number): boolean;
+    collision_aabb_aabb(center_ax: number, center_ay: number, half_wa: number, half_ha: number, center_bx: number, center_by: number, half_wb: number, half_hb: number): WasmContact | undefined;
+    collision_circle_aabb(cx: number, cy: number, cr: number, bx: number, by: number, bhw: number, bhh: number): WasmContact | undefined;
+    collision_circle_circle(center_ax: number, center_ay: number, radius_a: number, center_bx: number, center_by: number, radius_b: number): WasmContact | undefined;
     /**
      * Creates a game instance with wgpu rendering attached to a canvas.
      */
     static createWithCanvas(canvas: HTMLCanvasElement, width: number, height: number, title: string): Promise<WasmGame>;
     despawn(entity_bits: bigint): boolean;
+    /**
+     * Despawns multiple entities at once. Returns the number of entities
+     * successfully despawned.
+     */
+    despawn_batch(entity_bits: BigUint64Array): number;
     destroy_texture(handle: number): void;
+    distance(x1: number, y1: number, x2: number, y2: number): number;
+    distance_squared(x1: number, y1: number, x2: number, y2: number): number;
     draw_quad(x: number, y: number, w: number, h: number, r: number, g: number, b: number, a: number): void;
     draw_sprite(texture: number, x: number, y: number, w: number, h: number, rotation: number, r: number, g: number, b: number, a: number): void;
+    draw_sprite_rect(texture: number, x: number, y: number, w: number, h: number, rotation: number, src_x: number, src_y: number, src_w: number, src_h: number, r: number, g: number, b: number, a: number): boolean;
+    /**
+     * Flushes queued draw calls and presents the frame to the canvas.
+     *
+     * Call this at the end of each `requestAnimationFrame` callback.
+     */
     end_frame(): void;
     entity_count(): number;
     get_name(entity_bits: bigint): string | undefined;
+    /**
+     * Returns render statistics for the current frame, or `None` if
+     * rendering is not active.
+     */
+    get_render_stats(): WasmRenderStats | undefined;
+    get_sprite(entity_bits: bigint): WasmSprite | undefined;
     get_transform2d(entity_bits: bigint): WasmTransform2D | undefined;
     has_name(entity_bits: bigint): boolean;
     /**
-     * Whether wgpu rendering is active.
+     * Returns `true` when wgpu rendering is active (canvas was provided at
+     * construction time).
      */
     has_renderer(): boolean;
+    has_sprite(entity_bits: bigint): boolean;
     has_transform2d(entity_bits: bigint): boolean;
+    /**
+     * Returns `true` if any key mapped to the given action was just pressed
+     * this frame (not held from previous frame).
+     */
+    is_action_just_pressed(action: string): boolean;
+    /**
+     * Returns `true` if any key mapped to the given action was just released
+     * this frame (held previous frame but not current).
+     */
+    is_action_just_released(action: string): boolean;
+    /**
+     * Returns `true` if any key mapped to the given action is currently held.
+     */
+    is_action_pressed(action: string): boolean;
     is_alive(entity_bits: bigint): boolean;
     is_key_just_pressed(key_code: number): boolean;
     is_key_just_released(key_code: number): boolean;
     is_key_pressed(key_code: number): boolean;
     is_mouse_button_just_pressed(button: number): boolean;
+    is_mouse_button_just_released(button: number): boolean;
     is_mouse_button_pressed(button: number): boolean;
     /**
-     * Loads a texture from a URL. Returns the texture handle (1-based;
-     * 0 is reserved for the white fallback texture used by draw_quad).
+     * Maps an action name to a key code. Multiple keys can be mapped
+     * to the same action. Returns `true` on success.
      */
-    load_texture(url: string): Promise<number>;
+    map_action_key(action: string, key: number): boolean;
     mouse_x(): number;
     mouse_y(): number;
     /**
      * Creates a new game instance without rendering (ECS-only mode).
      */
     constructor(width: number, height: number, title: string);
+    point_in_circle(px: number, py: number, cx: number, cy: number, r: number): boolean;
+    point_in_rect(px: number, py: number, rx: number, ry: number, rw: number, rh: number): boolean;
     press_key(key_code: number): void;
     press_mouse_button(button: number): void;
+    /**
+     * Registers a texture from raw image bytes (PNG, JPG, etc.).
+     *
+     * The browser-side SDK fetches the image data asynchronously, then
+     * passes the raw bytes here for synchronous decode + GPU upload.
+     * Returns the texture handle (1-based; 0 is reserved for the white
+     * fallback texture used by `draw_quad`).
+     */
+    register_texture_from_bytes(data: Uint8Array): number;
     release_key(key_code: number): void;
     release_mouse_button(button: number): void;
     remove_name(entity_bits: bigint): boolean;
+    remove_sprite(entity_bits: bigint): boolean;
     remove_transform2d(entity_bits: bigint): boolean;
     scroll_dx(): number;
     scroll_dy(): number;
@@ -78,23 +132,81 @@ export class WasmGame {
      */
     set_canvas_size(width: number, height: number): void;
     /**
-     * Sets the background clear color (called before begin_frame or via
-     * the TypeScript SDK's beginFrame parameters).
+     * Sets the background clear color.
+     *
+     * Takes effect on the next `begin_frame` / `end_frame` pair.
      */
     set_clear_color(r: number, g: number, b: number, a: number): void;
     set_mouse_position(x: number, y: number): void;
+    set_sprite(entity_bits: bigint, texture_handle: number, r: number, g: number, b: number, a: number, flip_x: boolean, flip_y: boolean, anchor_x: number, anchor_y: number): void;
     set_transform2d(entity_bits: bigint, px: number, py: number, rotation: number, sx: number, sy: number): void;
     spawn_batch(count: number): BigUint64Array;
     spawn_empty(): bigint;
+    /**
+     * Seconds elapsed since the previous frame.
+     */
     readonly delta_time: number;
+    /**
+     * Approximate frames per second based on the most recent delta.
+     */
     readonly fps: number;
+    /**
+     * Number of frames rendered since the game started.
+     */
     readonly frame_count: bigint;
+    /**
+     * The title string passed at construction time.
+     */
     readonly title: string;
+    /**
+     * Total seconds elapsed since the game started.
+     */
     readonly total_time: number;
+    /**
+     * Logical canvas height in pixels.
+     */
     readonly window_height: number;
+    /**
+     * Logical canvas width in pixels.
+     */
     readonly window_width: number;
 }
 
+/**
+ * Per-frame rendering statistics exposed to JavaScript.
+ */
+export class WasmRenderStats {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    draw_calls: number;
+    texture_binds: number;
+    triangles: number;
+}
+
+/**
+ * A plain-data snapshot of a `Sprite` component, safe to pass across
+ * the wasm-bindgen boundary.
+ */
+export class WasmSprite {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    a: number;
+    anchor_x: number;
+    anchor_y: number;
+    b: number;
+    flip_x: boolean;
+    flip_y: boolean;
+    g: number;
+    r: number;
+    texture_handle: number;
+}
+
+/**
+ * A plain-data snapshot of a `Transform2D` component, safe to pass across
+ * the wasm-bindgen boundary.
+ */
 export class WasmTransform2D {
     private constructor();
     free(): void;
@@ -110,65 +222,124 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
-    readonly __wbg_get_wasmtransform2d_position_x: (a: number) => number;
-    readonly __wbg_get_wasmtransform2d_position_y: (a: number) => number;
-    readonly __wbg_get_wasmtransform2d_rotation: (a: number) => number;
-    readonly __wbg_get_wasmtransform2d_scale_x: (a: number) => number;
-    readonly __wbg_get_wasmtransform2d_scale_y: (a: number) => number;
-    readonly __wbg_set_wasmtransform2d_position_x: (a: number, b: number) => void;
-    readonly __wbg_set_wasmtransform2d_position_y: (a: number, b: number) => void;
-    readonly __wbg_set_wasmtransform2d_rotation: (a: number, b: number) => void;
-    readonly __wbg_set_wasmtransform2d_scale_x: (a: number, b: number) => void;
-    readonly __wbg_set_wasmtransform2d_scale_y: (a: number, b: number) => void;
-    readonly __wbg_wasmgame_free: (a: number, b: number) => void;
-    readonly __wbg_wasmtransform2d_free: (a: number, b: number) => void;
-    readonly wasmgame_add_name: (a: number, b: bigint, c: number, d: number) => void;
     readonly wasmgame_add_scroll_delta: (a: number, b: number, c: number) => void;
-    readonly wasmgame_add_transform2d: (a: number, b: bigint, c: number, d: number, e: number, f: number, g: number) => void;
-    readonly wasmgame_begin_frame: (a: number, b: number) => void;
-    readonly wasmgame_createWithCanvas: (a: any, b: number, c: number, d: number, e: number) => any;
-    readonly wasmgame_delta_time: (a: number) => number;
-    readonly wasmgame_despawn: (a: number, b: bigint) => number;
     readonly wasmgame_destroy_texture: (a: number, b: number) => void;
     readonly wasmgame_draw_quad: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
     readonly wasmgame_draw_sprite: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => void;
-    readonly wasmgame_end_frame: (a: number) => void;
-    readonly wasmgame_entity_count: (a: number) => number;
-    readonly wasmgame_fps: (a: number) => number;
-    readonly wasmgame_frame_count: (a: number) => bigint;
-    readonly wasmgame_get_name: (a: number, b: bigint) => [number, number];
-    readonly wasmgame_get_transform2d: (a: number, b: bigint) => number;
-    readonly wasmgame_has_name: (a: number, b: bigint) => number;
-    readonly wasmgame_has_renderer: (a: number) => number;
-    readonly wasmgame_has_transform2d: (a: number, b: bigint) => number;
-    readonly wasmgame_is_alive: (a: number, b: bigint) => number;
+    readonly wasmgame_draw_sprite_rect: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number) => number;
+    readonly wasmgame_get_render_stats: (a: number) => number;
+    readonly wasmgame_is_action_just_pressed: (a: number, b: number, c: number) => number;
+    readonly wasmgame_is_action_just_released: (a: number, b: number, c: number) => number;
+    readonly wasmgame_is_action_pressed: (a: number, b: number, c: number) => number;
     readonly wasmgame_is_key_just_pressed: (a: number, b: number) => number;
     readonly wasmgame_is_key_just_released: (a: number, b: number) => number;
     readonly wasmgame_is_key_pressed: (a: number, b: number) => number;
     readonly wasmgame_is_mouse_button_just_pressed: (a: number, b: number) => number;
+    readonly wasmgame_is_mouse_button_just_released: (a: number, b: number) => number;
     readonly wasmgame_is_mouse_button_pressed: (a: number, b: number) => number;
-    readonly wasmgame_load_texture: (a: number, b: number, c: number) => any;
+    readonly wasmgame_map_action_key: (a: number, b: number, c: number, d: number) => number;
     readonly wasmgame_mouse_x: (a: number) => number;
     readonly wasmgame_mouse_y: (a: number) => number;
-    readonly wasmgame_new: (a: number, b: number, c: number, d: number) => number;
     readonly wasmgame_press_key: (a: number, b: number) => void;
     readonly wasmgame_press_mouse_button: (a: number, b: number) => void;
+    readonly wasmgame_register_texture_from_bytes: (a: number, b: number, c: number) => [number, number, number];
     readonly wasmgame_release_key: (a: number, b: number) => void;
     readonly wasmgame_release_mouse_button: (a: number, b: number) => void;
-    readonly wasmgame_remove_name: (a: number, b: bigint) => number;
-    readonly wasmgame_remove_transform2d: (a: number, b: bigint) => number;
     readonly wasmgame_scroll_dx: (a: number) => number;
     readonly wasmgame_scroll_dy: (a: number) => number;
-    readonly wasmgame_set_canvas_size: (a: number, b: number, c: number) => void;
-    readonly wasmgame_set_clear_color: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly wasmgame_set_mouse_position: (a: number, b: number, c: number) => void;
+    readonly wasmgame_add_name: (a: number, b: bigint, c: number, d: number) => void;
+    readonly wasmgame_add_sprite: (a: number, b: bigint, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => void;
+    readonly wasmgame_add_transform2d: (a: number, b: bigint, c: number, d: number, e: number, f: number, g: number) => void;
+    readonly wasmgame_despawn: (a: number, b: bigint) => number;
+    readonly wasmgame_despawn_batch: (a: number, b: number, c: number) => number;
+    readonly wasmgame_entity_count: (a: number) => number;
+    readonly wasmgame_get_name: (a: number, b: bigint) => [number, number];
+    readonly wasmgame_get_sprite: (a: number, b: bigint) => number;
+    readonly wasmgame_get_transform2d: (a: number, b: bigint) => number;
+    readonly wasmgame_has_name: (a: number, b: bigint) => number;
+    readonly wasmgame_has_sprite: (a: number, b: bigint) => number;
+    readonly wasmgame_has_transform2d: (a: number, b: bigint) => number;
+    readonly wasmgame_is_alive: (a: number, b: bigint) => number;
+    readonly wasmgame_remove_name: (a: number, b: bigint) => number;
+    readonly wasmgame_remove_sprite: (a: number, b: bigint) => number;
+    readonly wasmgame_remove_transform2d: (a: number, b: bigint) => number;
+    readonly wasmgame_set_sprite: (a: number, b: bigint, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => void;
     readonly wasmgame_set_transform2d: (a: number, b: bigint, c: number, d: number, e: number, f: number, g: number) => void;
     readonly wasmgame_spawn_batch: (a: number, b: number) => [number, number];
     readonly wasmgame_spawn_empty: (a: number) => bigint;
+    readonly __wbg_get_wasmcontact_normal_x: (a: number) => number;
+    readonly __wbg_get_wasmcontact_normal_y: (a: number) => number;
+    readonly __wbg_get_wasmcontact_penetration: (a: number) => number;
+    readonly __wbg_get_wasmcontact_point_x: (a: number) => number;
+    readonly __wbg_get_wasmcontact_point_y: (a: number) => number;
+    readonly __wbg_get_wasmrenderstats_draw_calls: (a: number) => number;
+    readonly __wbg_get_wasmrenderstats_texture_binds: (a: number) => number;
+    readonly __wbg_get_wasmrenderstats_triangles: (a: number) => number;
+    readonly __wbg_get_wasmsprite_anchor_x: (a: number) => number;
+    readonly __wbg_get_wasmsprite_anchor_y: (a: number) => number;
+    readonly __wbg_get_wasmsprite_flip_x: (a: number) => number;
+    readonly __wbg_get_wasmsprite_flip_y: (a: number) => number;
+    readonly __wbg_set_wasmcontact_normal_x: (a: number, b: number) => void;
+    readonly __wbg_set_wasmcontact_normal_y: (a: number, b: number) => void;
+    readonly __wbg_set_wasmcontact_penetration: (a: number, b: number) => void;
+    readonly __wbg_set_wasmcontact_point_x: (a: number, b: number) => void;
+    readonly __wbg_set_wasmcontact_point_y: (a: number, b: number) => void;
+    readonly __wbg_set_wasmrenderstats_draw_calls: (a: number, b: number) => void;
+    readonly __wbg_set_wasmrenderstats_texture_binds: (a: number, b: number) => void;
+    readonly __wbg_set_wasmrenderstats_triangles: (a: number, b: number) => void;
+    readonly __wbg_set_wasmsprite_anchor_x: (a: number, b: number) => void;
+    readonly __wbg_set_wasmsprite_anchor_y: (a: number, b: number) => void;
+    readonly __wbg_set_wasmsprite_flip_x: (a: number, b: number) => void;
+    readonly __wbg_set_wasmsprite_flip_y: (a: number, b: number) => void;
+    readonly __wbg_wasmcontact_free: (a: number, b: number) => void;
+    readonly __wbg_wasmgame_free: (a: number, b: number) => void;
+    readonly __wbg_wasmrenderstats_free: (a: number, b: number) => void;
+    readonly __wbg_wasmsprite_free: (a: number, b: number) => void;
+    readonly wasmgame_aabb_overlap: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => number;
+    readonly wasmgame_begin_frame: (a: number, b: number) => void;
+    readonly wasmgame_circle_overlap: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
+    readonly wasmgame_collision_aabb_aabb: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => number;
+    readonly wasmgame_collision_circle_aabb: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
+    readonly wasmgame_collision_circle_circle: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
+    readonly wasmgame_createWithCanvas: (a: any, b: number, c: number, d: number, e: number) => any;
+    readonly wasmgame_delta_time: (a: number) => number;
+    readonly wasmgame_distance: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly wasmgame_distance_squared: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly wasmgame_end_frame: (a: number) => void;
+    readonly wasmgame_fps: (a: number) => number;
+    readonly wasmgame_frame_count: (a: number) => bigint;
+    readonly wasmgame_has_renderer: (a: number) => number;
+    readonly wasmgame_new: (a: number, b: number, c: number, d: number) => number;
+    readonly wasmgame_point_in_circle: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+    readonly wasmgame_point_in_rect: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
+    readonly wasmgame_set_canvas_size: (a: number, b: number, c: number) => void;
+    readonly wasmgame_set_clear_color: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly wasmgame_title: (a: number) => [number, number];
     readonly wasmgame_total_time: (a: number) => number;
     readonly wasmgame_window_height: (a: number) => number;
     readonly wasmgame_window_width: (a: number) => number;
+    readonly __wbg_set_wasmsprite_a: (a: number, b: number) => void;
+    readonly __wbg_set_wasmsprite_b: (a: number, b: number) => void;
+    readonly __wbg_set_wasmsprite_g: (a: number, b: number) => void;
+    readonly __wbg_set_wasmsprite_r: (a: number, b: number) => void;
+    readonly __wbg_set_wasmsprite_texture_handle: (a: number, b: number) => void;
+    readonly __wbg_set_wasmtransform2d_position_x: (a: number, b: number) => void;
+    readonly __wbg_set_wasmtransform2d_position_y: (a: number, b: number) => void;
+    readonly __wbg_set_wasmtransform2d_rotation: (a: number, b: number) => void;
+    readonly __wbg_set_wasmtransform2d_scale_x: (a: number, b: number) => void;
+    readonly __wbg_set_wasmtransform2d_scale_y: (a: number, b: number) => void;
+    readonly __wbg_get_wasmsprite_a: (a: number) => number;
+    readonly __wbg_get_wasmsprite_b: (a: number) => number;
+    readonly __wbg_get_wasmsprite_g: (a: number) => number;
+    readonly __wbg_get_wasmsprite_r: (a: number) => number;
+    readonly __wbg_get_wasmsprite_texture_handle: (a: number) => number;
+    readonly __wbg_get_wasmtransform2d_position_x: (a: number) => number;
+    readonly __wbg_get_wasmtransform2d_position_y: (a: number) => number;
+    readonly __wbg_get_wasmtransform2d_rotation: (a: number) => number;
+    readonly __wbg_get_wasmtransform2d_scale_x: (a: number) => number;
+    readonly __wbg_get_wasmtransform2d_scale_y: (a: number) => number;
+    readonly __wbg_wasmtransform2d_free: (a: number, b: number) => void;
     readonly wasm_bindgen__closure__destroy__h34b32f47e9536ad7: (a: number, b: number) => void;
     readonly wasm_bindgen__closure__destroy__hb7ee5c5d3fd608d4: (a: number, b: number) => void;
     readonly wasm_bindgen__convert__closures_____invoke__h6c9ef6970fdda1f4: (a: number, b: number, c: any) => [number, number];