ris-framework 0.1.0-dev.6 → 0.1.0-dev.9

package/dist/api/input/gamepad/GamePadState.d.ts

@@ -0,0 +1,48 @@
+import { GamePadThumbSticks } from "./GamePadThumbSticks.js";
+import { vec2 } from "gl-matrix";
+import { Button } from "./Button.js";
+/**
+ * The state of the gamepad.
+ */
+export declare class GamePadState {
+    readonly isConnected: boolean;
+    private readonly _downButtons;
+    private readonly _releasedButtons;
+    private readonly _thumbSticks;
+    /**
+     * The constructor.
+     * @param isConnected - Set to true if gamepad is connected.
+     * @param downButtons - The down buttons.
+     * @param releasedButtons - The released buttons.
+     * @param leftThumbstick - The left thumbstick position.
+     * @param rightThumbstick - The right thumbstick position.
+     */
+    constructor(isConnected: boolean, _downButtons: {
+        [key: number]: boolean;
+    }, _releasedButtons: {
+        [key: number]: boolean;
+    }, leftThumbstick: vec2, rightThumbstick: vec2);
+    /**
+     * The thumbstick positions.
+     */
+    get thumbSticks(): GamePadThumbSticks;
+    /**
+     * Check if the button is down.
+     * @param button - The button to check.
+     * @returns true if button is down, false otherwise.
+     */
+    isButtonDown(button: Button): boolean;
+    /**
+     * Check if the button is up.
+     * @param button - The button to check.
+     * @returns true if button is up, false otherwise.
+     */
+    isButtonUp(button: Button): boolean;
+    /**
+     * Check if the button is released in current frame.
+     * @param button - The button to check.
+     * @returns true if button is released.
+     */
+    isButtonReleased(button: Button): boolean;
+}
+//# sourceMappingURL=GamePadState.d.ts.map

package/dist/api/input/gamepad/GamePadState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GamePadState.d.ts","sourceRoot":"","sources":["../../../../src/api/input/gamepad/GamePadState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAC,MAAM,EAAC,MAAM,aAAa,CAAC;AAEnC;;GAEG;AACH,qBAAa,YAAY;aAYD,WAAW,EAAE,OAAO;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAbrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAElD;;;;;;;OAOG;gBAEiB,WAAW,EAAE,OAAO,EACnB,YAAY,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EACxC,gBAAgB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EAC7D,cAAc,EAAE,IAAI,EACpB,eAAe,EAAE,IAAI;IAQzB;;OAEG;IACH,IAAW,WAAW,IAAI,kBAAkB,CAE3C;IAED;;;;OAIG;IACI,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5C;;;;OAIG;IACI,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI1C;;;;OAIG;IACI,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;CAGnD"}

package/dist/api/input/gamepad/GamePadThumbSticks.d.ts

@@ -0,0 +1,17 @@
+import { vec2 } from "gl-matrix";
+/**
+ * The thumbsticks of the gamepad.
+ * @param left - The left thumbstick.
+ * @param right - The right thumbstick.
+ */
+export declare class GamePadThumbSticks {
+    left: vec2;
+    right: vec2;
+    /**
+     * The thumbsticks of the gamepad.
+     * @param left - The left thumbstick.
+     * @param right - The right thumbstick.
+     */
+    constructor(left: vec2, right: vec2);
+}
+//# sourceMappingURL=GamePadThumbSticks.d.ts.map

package/dist/api/input/gamepad/GamePadThumbSticks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GamePadThumbSticks.d.ts","sourceRoot":"","sources":["../../../../src/api/input/gamepad/GamePadThumbSticks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAE/B;;;;GAIG;AACH,qBAAa,kBAAkB;IAOD,IAAI,EAAE,IAAI;IAAS,KAAK,EAAE,IAAI;IALxD;;;;OAIG;gBACuB,IAAI,EAAE,IAAI,EAAS,KAAK,EAAE,IAAI;CAG3D"}

package/dist/api/input/mouse/MouseButton.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The mouse buttons.
+ */
+export declare enum MouseButton {
+    NONE = 0,
+    LEFT = 1,
+    RIGHT = 2,
+    MIDDLE = 3
+}
+//# sourceMappingURL=MouseButton.d.ts.map

package/dist/api/input/mouse/MouseButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MouseButton.d.ts","sourceRoot":"","sources":["../../../../src/api/input/mouse/MouseButton.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,WAAW;IACrB,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,MAAM,IAAI;CACX"}

package/dist/api/input/mouse/MouseState.d.ts

@@ -0,0 +1,52 @@
+import { MouseButton } from "./MouseButton.js";
+import { vec2 } from "gl-matrix";
+/**
+ * The mouse state.
+ */
+export declare class MouseState {
+    private readonly _downButtons;
+    private readonly _releasedButtons;
+    position: vec2;
+    delta: vec2;
+    scrollWheelPosition: vec2;
+    /**
+     * The constructor. InputManager owns these objects and updates them in place.
+     * @param _downButtons - The buttons that are down, keyed by MouseButton.
+     * @param _releasedButtons - The buttons released this frame, keyed by MouseButton.
+     * @param position - The cursor position in viewport (clientX / clientY) CSS pixels.
+     * @param delta - The cursor movement since the previous frame.
+     * @param scrollWheelPosition - The wheel direction this frame. Each axis is -1, 0, or 1.
+     */
+    constructor(_downButtons: {
+        [key: number]: boolean;
+    }, _releasedButtons: {
+        [key: number]: boolean;
+    }, position: vec2, delta: vec2, scrollWheelPosition: vec2);
+    /** The x position. */
+    get x(): number;
+    /** The y position. */
+    get y(): number;
+    /** The delta x.*/
+    get dX(): number;
+    /** The delta y. */
+    get dY(): number;
+    /**
+     * Returns true if MouseButton is down in current frame.
+     * @param button - The button to check.
+     * @returns True if button is down.
+     */
+    isButtonDown(button: MouseButton): boolean;
+    /**
+     * Returns true if the button is up in current frame.
+     * @param button - The button to check.
+     * @returns True if the button is up.
+     */
+    isButtonUp(button: MouseButton): boolean;
+    /**
+     * Checks if the button is released in current frame.
+     * @param button - The button to check.
+     * @returns True if the button is released in current frame.
+     */
+    isButtonReleased(button: MouseButton): boolean;
+}
+//# sourceMappingURL=MouseState.d.ts.map

package/dist/api/input/mouse/MouseState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MouseState.d.ts","sourceRoot":"","sources":["../../../../src/api/input/mouse/MouseState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAE/B;;GAEG;AACH,qBAAa,UAAU;IAUA,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAC1B,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,IAAI;IACX,mBAAmB,EAAE,IAAI;IAZnD;;;;;;;OAOG;gBACiC,YAAY,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EACxC,gBAAgB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EACtD,QAAQ,EAAE,IAAI,EACd,KAAK,EAAE,IAAI,EACX,mBAAmB,EAAE,IAAI;IAGnD,sBAAsB;IACtB,IAAW,CAAC,IAAI,MAAM,CAErB;IAED,sBAAsB;IACtB,IAAW,CAAC,IAAI,MAAM,CAErB;IAED,kBAAkB;IAClB,IAAW,EAAE,IAAI,MAAM,CAEtB;IAED,mBAAmB;IACnB,IAAW,EAAE,IAAI,MAAM,CAEtB;IAED;;;;OAIG;IACI,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAIjD;;;;OAIG;IACI,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAI/C;;;;OAIG;IACI,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;CAGxD"}

package/dist/api/input/touch/TouchCollection.d.ts

@@ -0,0 +1,79 @@
+import { TouchLocation } from "./TouchLocation.js";
+import { TouchLocationState } from "./TouchLocationState.js";
+/**
+ * The touch locations for one frame.
+ * Slots are allocated once. clear and tryAdd reuse them, and reads do not allocate.
+ */
+export declare class TouchCollection {
+    /** Default number of simultaneous touches the collection stores. */
+    static readonly MAX_TOUCH_COUNT = 8;
+    /** The fixed number of slots in this collection. */
+    readonly maxTouchCount: number;
+    private readonly _locations;
+    private _count;
+    private _activeCount;
+    /**
+     * The constructor.
+     * @param maxTouchCount The fixed slot count. Values below 1 store no touches. The default is MAX_TOUCH_COUNT.
+     */
+    constructor(maxTouchCount?: number);
+    /** The number of touch locations written this frame, including releases. */
+    get count(): number;
+    /**
+     * The number of touches that were down when they were written.
+     * Pressed and moved contacts count. Released, cancelled, and invalid contacts do not.
+     * This is stored while contacts are written, not counted again on read.
+     */
+    get activeCount(): number;
+    /**
+     * Drops the frame's contacts.
+     * Slots stay allocated. The next tryAdd reuses them from the start.
+     */
+    clear(): void;
+    /**
+     * Writes the next contact into the next free slot.
+     * @param id The touch id.
+     * @param state The touch location state.
+     * @param x The x position.
+     * @param y The y position.
+     * @param pressure The pressure.
+     * @param previousState The previous state. Omit it when this is the first sample.
+     * @param previousX The previous x position.
+     * @param previousY The previous y position.
+     * @param previousPressure The previous pressure.
+     * @returns The slot that was written, or undefined when every slot is already used.
+     */
+    tryAdd(id: number, state: TouchLocationState, x: number, y: number, pressure?: number, previousState?: TouchLocationState, previousX?: number, previousY?: number, previousPressure?: number): TouchLocation | undefined;
+    /**
+     * The touch at an index in this frame.
+     * @param index The index, from 0 to count - 1.
+     * @returns The stored location, or undefined when the index is outside this frame.
+     */
+    get(index: number): TouchLocation | undefined;
+    /**
+     * Finds a touch by id.
+     * Scans only the contacts written this frame. The first match wins.
+     * @param id The touch id.
+     * @returns The stored location, or undefined when this frame has no contact with that id.
+     */
+    findById(id: number): TouchLocation | undefined;
+    /**
+     * True when the contact with this id is down.
+     * A missing id is not down.
+     * @param id The touch id.
+     */
+    isDown(id: number): boolean;
+    /**
+     * True when the contact with this id was released this frame.
+     * A missing id was not released.
+     * @param id The touch id.
+     */
+    isReleased(id: number): boolean;
+    /**
+     * True when the contact with this id was cancelled this frame.
+     * A missing id was not cancelled. A cancel is not a release.
+     * @param id The touch id.
+     */
+    isCancelled(id: number): boolean;
+}
+//# sourceMappingURL=TouchCollection.d.ts.map

package/dist/api/input/touch/TouchCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TouchCollection.d.ts","sourceRoot":"","sources":["../../../../src/api/input/touch/TouchCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAC,kBAAkB,EAAC,MAAM,yBAAyB,CAAC;AAE3D;;;GAGG;AACH,qBAAa,eAAe;IAExB,oEAAoE;IACpE,gBAAuB,eAAe,KAAK;IAE3C,oDAAoD;IACpD,SAAgB,aAAa,EAAE,MAAM,CAAC;IAEtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,YAAY,CAAK;IAEzB;;;OAGG;gBACgB,aAAa,SAAkC;IAUlE,4EAA4E;IAC5E,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED;;;;OAIG;IACH,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED;;;OAGG;IACI,KAAK,IAAI,IAAI;IAKpB;;;;;;;;;;;;OAYG;IACI,MAAM,CAAC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,kBAAkB,EACzB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,SAAI,EACZ,aAAa,CAAC,EAAE,kBAAkB,EAClC,SAAS,SAAI,EACb,SAAS,SAAI,EACb,gBAAgB,SAAI,GAAG,aAAa,GAAG,SAAS;IAkB9D;;;;OAIG;IACI,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAOpD;;;;;OAKG;IACI,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAYtD;;;;OAIG;IACI,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQlC;;;;OAIG;IACI,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQtC;;;;OAIG;IACI,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAO1C"}

package/dist/api/input/touch/TouchLocation.d.ts

@@ -0,0 +1,80 @@
+import { vec2 } from "gl-matrix";
+import { TouchLocationState } from "./TouchLocationState.js";
+/**
+ * A single touch contact.
+ * Position, delta, and the previous sample are stored on this object.
+ * Reading them again returns those same instances.
+ */
+export declare class TouchLocation {
+    /** The touch id. Stable for the lifetime of the contact. */
+    id: number;
+    /** The pressure, from 0 to 1. 0 when the device does not report pressure. */
+    pressure: number;
+    /**
+     * The position of the touch.
+     * Viewport coordinates in CSS pixels, the same space as MouseState (clientX, clientY).
+     */
+    readonly position: vec2;
+    /**
+     * The delta from the previous sample. Zero when this frame has no previous sample.
+     * Viewport coordinates in CSS pixels, the same space as MouseState delta.
+     */
+    readonly delta: vec2;
+    /**
+     * True when the contact is pressed or moved.
+     * Updated when state is written.
+     */
+    isDown: boolean;
+    private _state;
+    private _hasPrevious;
+    private readonly _previous;
+    /**
+     * The constructor.
+     * @param ownsPrevious True when this location keeps a previous sample. The previous sample does not keep one of its own.
+     */
+    constructor(ownsPrevious?: boolean);
+    /** The touch location state. */
+    get state(): TouchLocationState;
+    /** The touch location state. */
+    set state(value: TouchLocationState);
+    /** The x position. */
+    get x(): number;
+    /** The y position. */
+    get y(): number;
+    /** The delta x. */
+    get dX(): number;
+    /** The delta y. */
+    get dY(): number;
+    /** True when the contact started this frame. */
+    isPressed(): boolean;
+    /** True when the contact moved while held. */
+    isMoved(): boolean;
+    /** True when the contact was released this frame. */
+    isReleased(): boolean;
+    /** True when the contact was cancelled this frame. A cancel is not a finger lift. */
+    isCancelled(): boolean;
+    /**
+     * The previous sample of this contact.
+     * Undefined when this is the first sample. The same instance is returned for every call in the frame.
+     */
+    tryGetPreviousLocation(): TouchLocation | undefined;
+    /**
+     * Writes this sample.
+     * Clears the previous sample and sets delta to zero.
+     * @param id The touch id.
+     * @param state The touch location state.
+     * @param x The x position.
+     * @param y The y position.
+     * @param pressure The pressure.
+     */
+    write(id: number, state: TouchLocationState, x: number, y: number, pressure: number): void;
+    /**
+     * Writes the previous sample and caches delta as this position minus that position.
+     * @param state The previous touch location state.
+     * @param x The previous x position.
+     * @param y The previous y position.
+     * @param pressure The previous pressure.
+     */
+    writePrevious(state: TouchLocationState, x: number, y: number, pressure: number): void;
+}
+//# sourceMappingURL=TouchLocation.d.ts.map

package/dist/api/input/touch/TouchLocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TouchLocation.d.ts","sourceRoot":"","sources":["../../../../src/api/input/touch/TouchLocation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAC,kBAAkB,EAAC,MAAM,yBAAyB,CAAC;AAE3D;;;;GAIG;AACH,qBAAa,aAAa;IAEtB,4DAA4D;IACrD,EAAE,SAAK;IAEd,6EAA6E;IACtE,QAAQ,SAAK;IAEpB;;;OAGG;IACH,SAAgB,QAAQ,EAAE,IAAI,CAAiB;IAE/C;;;OAGG;IACH,SAAgB,KAAK,EAAE,IAAI,CAAiB;IAE5C;;;OAGG;IACI,MAAM,UAAS;IAEtB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IAEtD;;;OAGG;gBACgB,YAAY,UAAO;IAQtC,gCAAgC;IAChC,IAAW,KAAK,IAAI,kBAAkB,CAErC;IAED,gCAAgC;IAChC,IAAW,KAAK,CAAC,KAAK,EAAE,kBAAkB,EAIzC;IAED,sBAAsB;IACtB,IAAW,CAAC,IAAI,MAAM,CAErB;IAED,sBAAsB;IACtB,IAAW,CAAC,IAAI,MAAM,CAErB;IAED,mBAAmB;IACnB,IAAW,EAAE,IAAI,MAAM,CAEtB;IAED,mBAAmB;IACnB,IAAW,EAAE,IAAI,MAAM,CAEtB;IAED,gDAAgD;IACzC,SAAS,IAAI,OAAO;IAI3B,8CAA8C;IACvC,OAAO,IAAI,OAAO;IAIzB,qDAAqD;IAC9C,UAAU,IAAI,OAAO;IAI5B,qFAAqF;IAC9E,WAAW,IAAI,OAAO;IAI7B;;;OAGG;IACI,sBAAsB,IAAI,aAAa,GAAG,SAAS;IAO1D;;;;;;;;OAQG;IACI,KAAK,CAAC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,kBAAkB,EACzB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,EAAE,MAAM,GAAG,IAAI;IAWpC;;;;;;OAMG;IACI,aAAa,CAAC,KAAK,EAAE,kBAAkB,EACzB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,EAAE,MAAM,GAAG,IAAI;CAW/C"}

package/dist/api/input/touch/TouchLocationState.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The state of a touch location for the current frame.
+ */
+export declare enum TouchLocationState {
+    /** No contact. */
+    INVALID = 0,
+    /** The contact was released this frame. */
+    RELEASED = 1,
+    /** The contact started this frame. */
+    PRESSED = 2,
+    /** The contact moved while held. */
+    MOVED = 3,
+    /** The contact was cancelled this frame. This is not a finger lift. */
+    CANCELLED = 4
+}
+//# sourceMappingURL=TouchLocationState.d.ts.map

package/dist/api/input/touch/TouchLocationState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TouchLocationState.d.ts","sourceRoot":"","sources":["../../../../src/api/input/touch/TouchLocationState.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,kBAAkB;IAC1B,kBAAkB;IAClB,OAAO,IAAI;IACX,2CAA2C;IAC3C,QAAQ,IAAI;IACZ,sCAAsC;IACtC,OAAO,IAAI;IACX,oCAAoC;IACpC,KAAK,IAAI;IACT,uEAAuE;IACvE,SAAS,IAAI;CAChB"}

package/dist/api/input/touch/TouchPanelCapabilities.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Capabilities of the touch panel.
+ * Fields stay on this instance. Update them in place when the device changes.
+ */
+export declare class TouchPanelCapabilities {
+    isConnected: boolean;
+    maximumTouchCount: number;
+    hasPressure: boolean;
+    /**
+     * The constructor.
+     * @param isConnected True when a touch device is connected.
+     * @param maximumTouchCount The maximum number of simultaneous touches. 0 when none are supported.
+     * @param hasPressure True when contacts report pressure.
+     */
+    constructor(isConnected: boolean, maximumTouchCount: number, hasPressure: boolean);
+    /**
+     * Writes new capabilities into this instance.
+     * @param isConnected True when a touch device is connected.
+     * @param maximumTouchCount The maximum number of simultaneous touches. 0 when none are supported.
+     * @param hasPressure True when contacts report pressure.
+     */
+    set(isConnected: boolean, maximumTouchCount: number, hasPressure: boolean): void;
+}
+//# sourceMappingURL=TouchPanelCapabilities.d.ts.map

package/dist/api/input/touch/TouchPanelCapabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TouchPanelCapabilities.d.ts","sourceRoot":"","sources":["../../../../src/api/input/touch/TouchPanelCapabilities.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,sBAAsB;IAQL,WAAW,EAAE,OAAO;IACpB,iBAAiB,EAAE,MAAM;IACzB,WAAW,EAAE,OAAO;IAR9C;;;;;OAKG;gBACuB,WAAW,EAAE,OAAO,EACpB,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,OAAO;IAG9C;;;;;OAKG;IACI,GAAG,CAAC,WAAW,EAAE,OAAO,EACpB,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,OAAO,GAAG,IAAI;CAKzC"}

package/dist/api/loaders/IImageLoader.d.ts

@@ -0,0 +1,20 @@
+import { RawImageData } from "../image/RawImageData.js";
+/**
+ * The image loader interface.
+ */
+export interface IImageLoader {
+    /**
+     * Loads an image from a file.
+     * @param path - The file path.
+     * @param cache - Whether to cache the image in a persistent cache.
+     * @returns The raw image data.
+     */
+    loadAsync(path: string, cache?: boolean): Promise<RawImageData>;
+    /**
+     * Disposes of the temporary cache.
+     *
+     * Used internally, call only if you know what you are doing.
+     */
+    disposeOfTemporaryCache(): void;
+}
+//# sourceMappingURL=IImageLoader.d.ts.map

package/dist/api/loaders/IImageLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IImageLoader.d.ts","sourceRoot":"","sources":["../../../src/api/loaders/IImageLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,0BAA0B,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,YAAY;IAEzB;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEhE;;;;OAIG;IACH,uBAAuB,IAAI,IAAI,CAAC;CACnC"}

package/dist/api/loaders/ImageLoader.d.ts

@@ -0,0 +1,36 @@
+import type { IImageLoader } from "./IImageLoader.js";
+import type { IFramework } from "../IFramework.js";
+import { RawImageData } from "../image/RawImageData.js";
+/**
+ * The image loader.
+ *
+ * Loads images through the browser Fetch API and converts them
+ * into raw pixel data suitable for the rendering backend.
+ */
+export declare class ImageLoader implements IImageLoader {
+    private readonly _framework;
+    /**
+     * A temporary cache is released when the engine clears it.
+     * It exists only for the duration of a loading/initialization operation.
+     */
+    private readonly _tempCache;
+    /**
+     * Persistent cache is released only when the application
+     * is closed or the cache is manually cleared.
+     */
+    private readonly _permanentCache;
+    /**
+     * The constructor.
+     * @param _framework The framework.
+     */
+    constructor(_framework: IFramework);
+    /**
+     * Loads a PNG/JPEG/etc. image using fetch.
+     */
+    private _loadImage;
+    /** @inheritDoc */
+    loadAsync(path: string, cache?: boolean): Promise<RawImageData>;
+    /** @inheritDoc */
+    disposeOfTemporaryCache(): void;
+}
+//# sourceMappingURL=ImageLoader.d.ts.map

package/dist/api/loaders/ImageLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageLoader.d.ts","sourceRoot":"","sources":["../../../src/api/loaders/ImageLoader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAC,YAAY,EAAC,MAAM,0BAA0B,CAAC;AAEtD;;;;;GAKG;AACH,qBAAa,WAAY,YAAW,YAAY;IAmBxC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAjB/B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAE/D;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoC;IAEpE;;;OAGG;gBAEkB,UAAU,EAAE,UAAU;IAI3C;;OAEG;YACW,UAAU;IAmBxB,kBAAkB;IACL,SAAS,CAClB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,OAAe,GACvB,OAAO,CAAC,YAAY,CAAC;IAsBxB,kBAAkB;IACX,uBAAuB,IAAI,IAAI;CASzC"}

package/dist/api/loaders/_export.d.ts

@@ -0,0 +1,3 @@
+export * from "./IImageLoader.js";
+export * from "./ImageLoader.js";
+//# sourceMappingURL=_export.d.ts.map

package/dist/api/loaders/_export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_export.d.ts","sourceRoot":"","sources":["../../../src/api/loaders/_export.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA"}

package/dist/api/material/IMaterial.d.ts

@@ -0,0 +1,35 @@
+import { mat4 } from "gl-matrix";
+import type { IDisposable } from "../core/IDisposable.js";
+import { GeometryFormat } from "../geometry/GeometryFormat.js";
+import type { IMesh } from "../meshes/IMesh.js";
+import type { IVertexBuffer } from "../rendering/buffers/IVertexBuffer.js";
+import type { IIndexBuffer } from "../rendering/buffers/IIndexBuffer.js";
+/**
+ * The material interface.
+ */
+export interface IMaterial extends IDisposable {
+    /**
+     * The model matrix.
+     */
+    modelMatrix: mat4;
+    /**
+     * The geometry format required by the material.
+     */
+    readonly geometryFormat: GeometryFormat;
+    /**
+     * Called before rendering.
+     */
+    beforeRender(): void;
+    /**
+     * Renders the material.
+     * @param mesh - The mesh.
+     */
+    renderMesh(mesh: IMesh): void;
+    /**
+     * Renders the material.
+     * @param vertexBuffer - The vertex buffer.
+     * @param indexBuffer - The index buffer.
+     */
+    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer): void;
+}
+//# sourceMappingURL=IMaterial.d.ts.map

package/dist/api/material/IMaterial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMaterial.d.ts","sourceRoot":"","sources":["../../../src/api/material/IMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAC,cAAc,EAAC,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,WAAW;IAE1C;;OAEG;IACH,WAAW,EAAE,IAAI,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;OAEG;IACH,YAAY,IAAI,IAAI,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IAE9B;;;;OAIG;IACH,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,GAAG,IAAI,CAAC;CAExE"}

package/dist/api/material/IMaterialFactory.d.ts

@@ -0,0 +1,19 @@
+import { InspectTextureMipsMaterial } from "./InspectTextureMipsMaterial.js";
+import { UnlitMaterial, UnlitMaterialDescriptor } from "./UnlitMaterial.js";
+/**
+ * The material factory.
+ */
+export interface IMaterialFactory {
+    /**
+     * Creates a material for inspecting texture mips.
+     * @returns The Inspect Texture Mips Material.
+     */
+    createInspectTextureMipsMaterial(): InspectTextureMipsMaterial;
+    /**
+     * Creates an unlit material.
+     * @param config The optional additional configuration options for material, such as rendering options.
+     * @returns The Unlit Material.
+     */
+    createUnlitMaterial(config?: UnlitMaterialDescriptor): UnlitMaterial;
+}
+//# sourceMappingURL=IMaterialFactory.d.ts.map

package/dist/api/material/IMaterialFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMaterialFactory.d.ts","sourceRoot":"","sources":["../../../src/api/material/IMaterialFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,0BAA0B,EAAC,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAC,aAAa,EAAE,uBAAuB,EAAC,MAAM,oBAAoB,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAE7B;;;OAGG;IACH,gCAAgC,IAAI,0BAA0B,CAAC;IAE/D;;;;OAIG;IACH,mBAAmB,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,aAAa,CAAC;CACxE"}

package/dist/api/material/InspectTextureMipsMaterial.d.ts

@@ -0,0 +1,58 @@
+import type { IMesh } from "../meshes/IMesh.js";
+import type { ITexture2D } from "../rendering/texture/ITexture2D.js";
+import type { ISampler } from "../rendering/sampler/ISampler.js";
+import { mat4 } from "gl-matrix";
+import { GeometryFormat } from "../geometry/GeometryFormat.js";
+import type { IIndexBuffer } from "../rendering/buffers/IIndexBuffer.js";
+import type { IVertexBuffer } from "../rendering/buffers/IVertexBuffer.js";
+import type { IFramework } from "../IFramework.js";
+/**
+ * Material for inspecting texture mips.
+ */
+export declare class InspectTextureMipsMaterial {
+    private readonly _framework;
+    private _mipLevel;
+    private _pipeline;
+    private _projectionViewBuffer;
+    private _fragmentDataBuffer;
+    private _modelBuffer;
+    private _previousModelMatrix;
+    constructor(framework: IFramework);
+    /**
+     * The mip level to inspect.
+     */
+    mipLevel: number;
+    /**
+     * The texture to inspect.
+     */
+    get texture(): ITexture2D;
+    /**
+     * The texture to inspect.
+     */
+    set texture(value: ITexture2D);
+    /**
+     * The texture sampler.
+     */
+    get textureSampler(): ISampler | undefined;
+    /**
+     * The texture sampler.
+     */
+    set textureSampler(value: ISampler | undefined);
+    /**
+     * The model matrix.
+     */
+    modelMatrix: mat4;
+    /**
+     * The geometry format.
+     */
+    readonly geometryFormat = GeometryFormat.POS3_COLOR4_TEXTURECOORDS2;
+    /** @inheritDoc */
+    beforeRender(): void;
+    /** @inheritDoc */
+    renderMesh(mesh: IMesh): void;
+    /** @inheritDoc */
+    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer): void;
+    /** @inheritDoc */
+    dispose(): void;
+}
+//# sourceMappingURL=InspectTextureMipsMaterial.d.ts.map

package/dist/api/material/InspectTextureMipsMaterial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InspectTextureMipsMaterial.d.ts","sourceRoot":"","sources":["../../../src/api/material/InspectTextureMipsMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAErE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAC,cAAc,EAAC,MAAM,+BAA+B,CAAC;AAE7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD;;GAEG;AACH,qBAAa,0BAA0B;IAEnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,qBAAqB,CAAiB;IAC9C,OAAO,CAAC,mBAAmB,CAAiB;IAC5C,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,oBAAoB,CAAiB;gBAE1B,SAAS,EAAE,UAAU;IAcxC;;OAEG;IACI,QAAQ,EAAE,MAAM,CAAK;IAE5B;;OAEG;IACH,IAAW,OAAO,IAAI,UAAU,CAE/B;IAED;;OAEG;IACH,IAAW,OAAO,CAAC,KAAK,EAAE,UAAU,EAEnC;IAED;;OAEG;IACH,IAAW,cAAc,IAAI,QAAQ,GAAG,SAAS,CAEhD;IAED;;OAEG;IACH,IAAW,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAEpD;IAED;;OAEG;IACI,WAAW,EAAE,IAAI,CAAiB;IAEzC;;OAEG;IACH,SAAgB,cAAc,6CAA6C;IAE3E,kBAAkB;IACX,YAAY,IAAI,IAAI;IAY3B,kBAAkB;IACX,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAIpC,kBAAkB;IACX,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,GAAG,IAAI;IAI3E,kBAAkB;IACX,OAAO,IAAI,IAAI;CAMzB"}

package/dist/api/material/MaterialFactory.d.ts

@@ -0,0 +1,20 @@
+import { InspectTextureMipsMaterial } from "./InspectTextureMipsMaterial.js";
+import type { IFramework } from "../IFramework.js";
+import type { IMaterialFactory } from "./IMaterialFactory.js";
+import { UnlitMaterial, UnlitMaterialDescriptor } from "./UnlitMaterial.js";
+/**
+ * The material factory.
+ */
+export declare class MaterialFactory implements IMaterialFactory {
+    private readonly _framework;
+    /**
+     * The constructor.
+     * @param _framework The framework.
+     */
+    constructor(_framework: IFramework);
+    /** @inheritDoc */
+    createInspectTextureMipsMaterial(): InspectTextureMipsMaterial;
+    /** @inheritDoc */
+    createUnlitMaterial(descriptor?: UnlitMaterialDescriptor): UnlitMaterial;
+}
+//# sourceMappingURL=MaterialFactory.d.ts.map

package/dist/api/material/MaterialFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaterialFactory.d.ts","sourceRoot":"","sources":["../../../src/api/material/MaterialFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,0BAA0B,EAAC,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAC,aAAa,EAAE,uBAAuB,EAAC,MAAM,oBAAoB,CAAC;AAE1E;;GAEG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IAMjC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ9C;;;OAGG;gBACiC,UAAU,EAAE,UAAU;IAG1D,kBAAkB;IACX,gCAAgC,IAAI,0BAA0B;IAIrE,kBAAkB;IACX,mBAAmB,CAAC,UAAU,CAAC,EAAG,uBAAuB,GAAG,aAAa;CAGnF"}