@eidolonmc/wasm 0.0.1-alpha → 0.0.3-alpha

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@eidolonmc/wasm",
-  "version": "0.0.1-alpha",
+  "version": "0.0.3-alpha",
   "description": "WebAssembly bindings for Eidolon Minecraft skin renderer",
+  "homepage": "https://github.com/bingling-sama/eidolon",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bingling-sama/eidolon.git"
+  },
   "type": "module",
   "main": "./pkg/eidolon.js",
   "types": "./pkg/eidolon.d.ts",
@@ -13,16 +18,12 @@
     }
   },
   "files": [
-    "pkg/eidolon_bg.wasm",
-    "pkg/eidolon_bg.wasm.d.ts",
-    "pkg/eidolon.js",
-    "pkg/eidolon.d.ts",
-    "pkg/package.json"
+    "pkg"
   ],
   "license": "MIT",
   "scripts": {
-    "build": "wasm-pack build --target bundler --out-dir pkg",
-    "build:dev": "wasm-pack build --dev --target bundler --out-dir pkg",
-    "build:web": "wasm-pack build --target web --out-dir pkg/web"
+    "build": "wasm-pack build --target bundler --out-dir pkg && rm -f pkg/.gitignore",
+    "build:dev": "wasm-pack build --dev --target bundler --out-dir pkg && rm -f pkg/.gitignore",
+    "build:web": "wasm-pack build --target web --out-dir pkg/web && rm -f pkg/web/.gitignore"
   }
 }

package/pkg/eidolon.d.ts

@@ -0,0 +1,177 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/**
+ * Real-time canvas renderer — presents directly to a `<canvas>` element at 60fps.
+ *
+ * No readback, no PNG encode — GPU renders straight to the canvas swapchain.
+ */
+export class CanvasRenderer {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Advance playback by a browser-provided frame delta in seconds.
+     */
+    advance_animation(delta_seconds: number): void;
+    /**
+     * Natural cycle duration of the selected animation, in seconds.
+     */
+    animation_duration(): number;
+    /**
+     * Whether a one-shot timeline has reached its final pose.
+     */
+    animation_finished(): boolean;
+    /**
+     * Whether the timeline is currently playing.
+     */
+    animation_playing(): boolean;
+    /**
+     * Current playback position in seconds.
+     */
+    animation_time(): number;
+    /**
+     * Offscreen render at high resolution, return encoded image bytes for download.
+     * Renders at the given size independently of the canvas.
+     * Supports "png" (default), "webp", and "jpeg"/"jpg".
+     */
+    capture_frame(width: number, height: number, format?: string | null): Promise<Uint8Array>;
+    /**
+     * Disable cape rendering.
+     */
+    clear_cape(): void;
+    /**
+     * Disable elytra rendering.
+     */
+    clear_elytra(): void;
+    /**
+     * Remove the player nametag.
+     */
+    clear_nametag(): void;
+    /**
+     * Disable skin/body rendering.
+     */
+    clear_skin(): void;
+    /**
+     * Current elytra pitch in degrees.
+     */
+    elytra_pitch(): number;
+    /**
+     * Current elytra opening angle in degrees.
+     */
+    elytra_spread(): number;
+    /**
+     * Load a cape from PNG bytes and enable cape rendering.
+     */
+    load_cape(bytes: Uint8Array): void;
+    /**
+     * Load a Back equipment atlas from PNG bytes and select Elytra presentation.
+     */
+    load_elytra(bytes: Uint8Array): void;
+    /**
+     * Load a skin from PNG bytes. Must be called before `render_frame`.
+     */
+    load_skin(bytes: Uint8Array): void;
+    /**
+     * Current nametag text, or `None` if hidden.
+     */
+    nametag(): string | undefined;
+    /**
+     * Whether nametag see-through occlusion is enabled.
+     */
+    nametag_see_through(): boolean;
+    /**
+     * Attach to a `<canvas>` element. Call as `await CanvasRenderer.new(canvas)`.
+     */
+    static new(canvas: HTMLCanvasElement): Promise<CanvasRenderer>;
+    /**
+     * Present one frame to the canvas. Call in a rAF loop at 60fps.
+     */
+    render_frame(): void;
+    /**
+     * Remove the manual elytra override and return control to the animation.
+     */
+    reset_elytra_angles(): void;
+    /**
+     * Update surface size after canvas resize. Call from ResizeObserver.
+     */
+    resize(width: number, height: number): void;
+    /**
+     * Seek the selected animation to an explicit position in seconds.
+     *
+     * Kept for compatibility with older browser clients; new clients should
+     * use `advance_animation` and the playback controls below.
+     */
+    sample_animation(time_seconds: number): void;
+    /**
+     * Select a procedural animation and reset it to phase zero.
+     */
+    set_animation(preset: string): void;
+    /**
+     * Select looping (`true`) or one-shot (`false`) playback.
+     */
+    set_animation_loop(looping: boolean): void;
+    /**
+     * Start or pause playback.
+     */
+    set_animation_playing(playing: boolean): void;
+    /**
+     * Set playback speed; values are clamped to the core timeline range.
+     */
+    set_animation_speed(speed: number): void;
+    /**
+     * Set background clear color. `r`,`g`,`b`,`a` in 0.0-1.0 range.
+     * Default is transparent black `(0,0,0,0)`.
+     */
+    set_background(r: number, g: number, b: number, a: number): void;
+    /**
+     * Set camera orbit. `yaw`/`pitch` in degrees, `scale` > 0 (higher = closer).
+     */
+    set_camera(yaw: number, pitch: number, scale: number): void;
+    /**
+     * Override elytra pitch and opening angle in degrees.
+     */
+    set_elytra_angles(pitch: number, spread: number): void;
+    /**
+     * Set or clear the player nametag. An empty string or whitespace removes the nametag.
+     */
+    set_nametag(text: string): void;
+    /**
+     * Set whether occluded nametag pixels remain visible at reduced opacity.
+     */
+    set_nametag_see_through(see_through: boolean): void;
+    /**
+     * Set posture by preset. `"stand"`, `"wave"`, `"walking"`, `"running"`, `"flying"`.
+     */
+    set_posture(preset: string): void;
+    /**
+     * Set arm width. `"classic"` (4px) or `"slim"` (3px).
+     */
+    set_skin_type(skin_type: string): void;
+}
+
+/**
+ * JS-accessible representation of a texture inspection report.
+ */
+export class JsTextureReport {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly can_auto_upgrade: boolean;
+    readonly description: string;
+    readonly hd_scale: number;
+    readonly height: number;
+    readonly is_hd: boolean;
+    readonly kind: string;
+    readonly width: number;
+}
+
+/**
+ * Initialize `console_log` so Rust `log` macros print to the browser console.
+ */
+export function init_logger(): void;
+
+/**
+ * Inspect and classify a Minecraft texture from raw image bytes (e.g. PNG).
+ */
+export function inspect_texture(bytes: Uint8Array): JsTextureReport;

package/pkg/eidolon.js

@@ -0,0 +1,9 @@
+/* @ts-self-types="./eidolon.d.ts" */
+import * as wasm from "./eidolon_bg.wasm";
+import { __wbg_set_wasm } from "./eidolon_bg.js";
+
+__wbg_set_wasm(wasm);
+wasm.__wbindgen_start();
+export {
+    CanvasRenderer, JsTextureReport, init_logger, inspect_texture
+} from "./eidolon_bg.js";