ris-framework 0.1.0-dev.7 → 0.1.0

package/dist/webgl/utilities/WebGlSamplerUtilities.d.ts

@@ -1,5 +1,5 @@
-import { SamplerCompareFunction } from '../../common/sampler-enums';
-import { MipMapSamplerFilter, SamplerAddressMode, SamplerFilter } from "ris-framework-api";
+import { SamplerCompareFunction } from '../../api/rendering/sampler/sampler-enums';
+import { MipMapSamplerFilter, SamplerAddressMode, SamplerFilter } from "../../api/index.js";
 /**
  * The utility class for working with WebGLSampler object.
  */
@@ -16,7 +16,7 @@ export declare class WebGlSamplerUtilities {
      * @param compareFunction The compare function of the sampler. This is used for shadow samplers.
      * @param _anisotropy The anisotropy level of the sampler. This is used for anisotropic filtering. The default value is 1, which means no anisotropic filtering.
      * @param label The label of the sampler. This is used for debugging purposes and can be viewed in graphics debuggers like SpectorJS.
-     * @returns
+     * @returns The created WebGLSampler.
      */
     create(gl: WebGL2RenderingContext, minFilter?: SamplerFilter, magFilter?: SamplerFilter, mipMapFilter?: MipMapSamplerFilter, addressModeU?: SamplerAddressMode, addressModeV?: SamplerAddressMode, addressModeW?: SamplerAddressMode, compareFunction?: SamplerCompareFunction, _anisotropy?: number, label?: string): WebGLSampler;
 }

package/dist/webgl/utilities/WebGlSamplerUtilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebGlSamplerUtilities.d.ts","sourceRoot":"","sources":["../../../src/webgl/utilities/WebGlSamplerUtilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EAAC,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,EAAC,MAAM,mBAAmB,CAAC;AAEzF;;GAEG;AACH,qBAAa,qBAAqB;IAE9B;;;;;;;;;;;;;OAaG;IACI,MAAM,CAAC,EAAE,EAAE,sBAAsB,EAC1B,SAAS,GAAE,aAAoC,EAC/C,SAAS,GAAE,aAAoC,EAC/C,YAAY,GAAE,mBAA8C,EAC5D,YAAY,GAAE,kBAAqD,EACnE,YAAY,GAAE,kBAAqD,EACnE,YAAY,GAAE,kBAAqD,EACnE,eAAe,GAAE,sBAAqD,EACtE,WAAW,GAAE,MAAU,EACjC,KAAK,GAAE,MAAW,GAAI,YAAY;CA+CzC"}
+{"version":3,"file":"WebGlSamplerUtilities.d.ts","sourceRoot":"","sources":["../../../src/webgl/utilities/WebGlSamplerUtilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAGnF,OAAO,EAAC,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAE1F;;GAEG;AACH,qBAAa,qBAAqB;IAE9B;;;;;;;;;;;;;OAaG;IACI,MAAM,CAAC,EAAE,EAAE,sBAAsB,EAC1B,SAAS,GAAE,aAAoC,EAC/C,SAAS,GAAE,aAAoC,EAC/C,YAAY,GAAE,mBAA8C,EAC5D,YAAY,GAAE,kBAAqD,EACnE,YAAY,GAAE,kBAAqD,EACnE,YAAY,GAAE,kBAAqD,EACnE,eAAe,GAAE,sBAAqD,EACtE,WAAW,GAAE,MAAU,EACjC,KAAK,GAAE,MAAW,GAAI,YAAY;CA+CzC"}

package/dist/webgl/utilities/WebGlTextureUtilities.d.ts

@@ -1,4 +1,4 @@
-import { TextureFormat } from "ris-framework-api";
+import { TextureFormat } from "../../api/index.js";
 import { vec2 } from "gl-matrix";
 /**
  * The utilities for working with WebGL textures.
@@ -10,7 +10,7 @@ export declare class WebGlTextureUtilities {
      * @param width The width of the texture.
      * @param height The height of the texture.
      * @param data The texture data. If null, an uninitialized texture will be created.
-     * @param textureFormat The format of the texture. If not specified, BGRA_8_UNORM will be used.
+     * @param textureFormat The format of the texture. If not specified, RGBA_8_UNORM will be used.
      * @param useMipMaps True to generate mipmaps for the texture, false otherwise. By default, it is false.
      * @param anisotropy The level of anisotropic filtering to use when sampling the texture. A value of 1 means no anisotropic filtering, while higher values (e.g., 4, 8, 16) indicate increasing levels of anisotropic filtering. By default, it is 1 (no anisotropic filtering).
      * @param label The label for the texture. This can be used for debugging purposes to identify the texture in graphics debuggers.
@@ -23,11 +23,11 @@ export declare class WebGlTextureUtilities {
      * @param dimension The dimensions of the texture.
      * @param blockSize The block size of a compressed format.
      * @param data The texture data. If null, an uninitialized texture will be created.
-     * @param textureFormat The format of the texture. If not specified, BGRA_8_UNORM will be used.
-     * @param anisotropy The level of anisotropic filtering to use when sampling the texture. A value of 1 means no anisotropic filtering, while higher values (e.g., 4, 8, 16) indicate increasing levels of anisotropic filtering. By default, it is 1 (no anisotropic filtering).
      * @param label The label for the texture. This can be used for debugging purposes to identify the texture in graphics debuggers.
+     * @param textureFormat The format of the texture. If not specified, RGBA_8_UNORM will be used.
+     * @param anisotropy The level of anisotropic filtering to use when sampling the texture. A value of 1 means no anisotropic filtering, while higher values (e.g., 4, 8, 16) indicate increasing levels of anisotropic filtering. By default, it is 1 (no anisotropic filtering).
      * @returns The created WebGL texture.
      */
-    createCompressedTexture2D(gl: WebGL2RenderingContext, dimension: vec2, _blockSize: vec2, data?: Uint8Array[] | null, label?: string | null, textureFormat?: TextureFormat, anisotropy?: number): WebGLTexture;
+    createCompressedTexture2D(gl: WebGL2RenderingContext, dimension: vec2, blockSize: vec2, data?: Uint8Array[] | null, label?: string | null, textureFormat?: TextureFormat, anisotropy?: number): WebGLTexture;
 }
 //# sourceMappingURL=WebGlTextureUtilities.d.ts.map

package/dist/webgl/utilities/WebGlTextureUtilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebGlTextureUtilities.d.ts","sourceRoot":"","sources":["../../../src/webgl/utilities/WebGlTextureUtilities.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAE/B;;GAEG;AACH,qBAAa,qBAAqB;IAE9B;;;;;;;;;;;OAWG;IACI,eAAe,CAClB,EAAE,EAAE,sBAAsB,EAC1B,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAC7B,IAAI,GAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,GAAG,IAAW,EACrD,aAAa,gBAA6B,EAC1C,UAAU,UAAQ,EAClB,UAAU,SAAM,EAChB,KAAK,GAAE,MAAM,GAAG,IAAW,GAC5B,YAAY;IA6Df;;;;;;;;;;OAUG;IACI,yBAAyB,CAC5B,EAAE,EAAE,sBAAsB,EAC1B,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EACjC,IAAI,GAAE,UAAU,EAAE,GAAG,IAAW,EAChC,KAAK,GAAE,MAAM,GAAG,IAAW,EAC3B,aAAa,gBAA6B,EAC1C,UAAU,SAAM,GACjB,YAAY;CAqDlB"}
+{"version":3,"file":"WebGlTextureUtilities.d.ts","sourceRoot":"","sources":["../../../src/webgl/utilities/WebGlTextureUtilities.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAE/B;;GAEG;AACH,qBAAa,qBAAqB;IAE9B;;;;;;;;;;;OAWG;IACI,eAAe,CAClB,EAAE,EAAE,sBAAsB,EAC1B,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAC7B,IAAI,GAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,GAAG,IAAW,EACrD,aAAa,gBAA6B,EAC1C,UAAU,UAAQ,EAClB,UAAU,SAAM,EAChB,KAAK,GAAE,MAAM,GAAG,IAAW,GAC5B,YAAY;IA2Df;;;;;;;;;;OAUG;IACI,yBAAyB,CAC5B,EAAE,EAAE,sBAAsB,EAC1B,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAChC,IAAI,GAAE,UAAU,EAAE,GAAG,IAAW,EAChC,KAAK,GAAE,MAAM,GAAG,IAAW,EAC3B,aAAa,gBAA6B,EAC1C,UAAU,SAAM,GACjB,YAAY;CAgElB"}

package/dist/webgl/utilities/webgl-culling-utilities.d.ts

@@ -1,4 +1,4 @@
-import { Culling } from "../../core/renderer/enums";
+import { Culling } from "../../api/rendering/enums.js";
 /**
  * The WebGL culling utilities.
  */

package/dist/webgl/utilities/webgl-culling-utilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgl-culling-utilities.d.ts","sourceRoot":"","sources":["../../../src/webgl/utilities/webgl-culling-utilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAGpD;;GAEG;AACH,qBAAa,qBAAqB;IAE9B;;;;OAIG;IACI,UAAU,CAAC,EAAE,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO;CASjE"}
+{"version":3,"file":"webgl-culling-utilities.d.ts","sourceRoot":"","sources":["../../../src/webgl/utilities/webgl-culling-utilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAGvD;;GAEG;AACH,qBAAa,qBAAqB;IAE9B;;;;OAIG;IACI,UAAU,CAAC,EAAE,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO;CASjE"}

package/dist/webgl/utilities/webgl-filter-anisotropic-utilities.d.ts

@@ -10,7 +10,7 @@ export declare class WebGLFilterAnisotropicUtilities {
     /**
      * Gets the max anisotropy.
      * @param gl The WebGL2 rendering context.
-     * @returns The maximum supported level of anisotropic filtering. <c>0</c> if not supported.
+     * @returns The maximum supported level of anisotropic filtering. `0` if not supported.
      */
     getMaxAnisotropy(gl: WebGL2RenderingContext): number;
     /**

package/dist/webgl/utilities/webgl-renderbuffer-utilities.d.ts

@@ -1,4 +1,4 @@
-import type { TextureFormat } from "ris-framework-api";
+import type { TextureFormat } from "../../api/index.js";
 /**
  * The utility class for WebGL render buffer operations. It provides methods for creating render buffers with specified formats, dimensions, and labels. Render buffers are used in WebGL for off-screen rendering, particularly for depth and stencil attachments in framebuffers. This class abstracts the details of creating and configuring render buffers, making it easier to manage them in a WebGL application.
  */

package/dist/webgl/utilities/webgl-renderbuffer-utilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgl-renderbuffer-utilities.d.ts","sourceRoot":"","sources":["../../../src/webgl/utilities/webgl-renderbuffer-utilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD;;GAEG;AACH,qBAAa,0BAA0B;IACnC;;;;;;;;OAQG;IACI,MAAM,CAAC,EAAE,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,iBAAiB;CAiB/J"}
+{"version":3,"file":"webgl-renderbuffer-utilities.d.ts","sourceRoot":"","sources":["../../../src/webgl/utilities/webgl-renderbuffer-utilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD;;GAEG;AACH,qBAAa,0BAA0B;IACnC;;;;;;;;OAQG;IACI,MAAM,CAAC,EAAE,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,iBAAiB;CAiB/J"}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "ris-framework",
-  "version": "0.1.0-dev.7",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/luka712/ris-framework-ts"
@@ -22,18 +23,17 @@
     "build:lib": "rm -rf dist && vite build --config vite.lib.config.ts && tsc -p tsconfig.lib.json && node scripts/rewrite-declaration-extensions.mjs",
     "build:app": "vite build",
     "preview": "vite preview",
-    "test": "tsc --noEmit"
+    "test": "tsc --noEmit && tsc -p tsconfig.test.json --noEmit && vitest run"
   },
   "devDependencies": {
-    "ris-ktx2": "^0.1.0-dev.2",
     "typescript": "~5.9.3",
-    "vite": "^7.2.4"
+    "vite": "^7.2.4",
+    "vitest": "^5.0.3"
   },
   "dependencies": {
     "gl-matrix": "^3.4.4",
     "reflect-metadata": "^0.2.2",
-    "ris-framework-api": "0.1.0-dev.5",
-    "ris-ktx2-api": "^0.1.0-dev.2.4",
+    "ris-ktx2": "^0.1.0",
     "tsyringe": "^4.10.0"
   },
   "files": [
@@ -42,6 +42,7 @@
     "shaders",
     "LICENSES",
     "LICENSE",
+    "NOTICE",
     "README.md",
     "CHANGELOG.md",
     "THIRD_PARTY_NOTICES.md"

package/shaders/glsl/sprite_fs.glsl

@@ -10,5 +10,5 @@ uniform sampler2D u_texture;
 
 void main()
 {
-    o_outputColor = texture(u_texture, v_texCoords) * v_color;
+    o_outputColor = texture(u_texture, v_texCoords) * v_color + vec4(1.0);
 }

package/src/{core/Framework.ts → Framework.ts}

@@ -1,32 +1,50 @@
 import {container, type DependencyContainer} from "tsyringe";
-import {WindowManager} from "./window/window-manager.ts";
-import {FrameworkConfig} from "./FrameworkConfig.ts";
-import {IFrameworkSymbol} from "./dependency-injection/register-services-interface.ts";
-import { RenderConfiguration, RenderConfigurationSymbol} from "./renderer/renderer-interface.ts";
-import {GeometryBuilder} from "../geometry/GeometryBuilder.ts";
-import {ContentManager} from "./content/ContentManager.ts";
-import {WebGlRenderer} from "../webgl/WebGlRenderer.ts";
-import {WebGlBuffersFactory} from "../webgl/buffers/WebGlBuffersFactory.ts";
+import {WindowManager} from "./api/window/WindowManager.ts";
+import {FrameworkConfiguration} from "./api/FrameworkConfiguration.ts";
+import {type IRendererConfiguration, RenderConfigurationSymbol} from "./api/rendering/renderer-interface.ts";
+import {GeometryBuilder} from "./api/geometry/GeometryBuilder.ts";
+import {ContentManager} from "./api/content/ContentManager.ts";
+import {WebGlRenderer} from "./webgl/WebGlRenderer.ts";
+import {WebGlBuffersFactory} from "./webgl/buffers/WebGlBuffersFactory.ts";
 import {
-    CameraFactory, CpuImageProcessor, GameTime,
-    type IBufferFactory, type IGeometryBuilder, type IGraphicsDevice, type IImageProcessor, type IInputManager,
+    type ICameraFactory,
+    type IContentManager,
+    type IFramework, IFrameworkConfiguration,
+    type IImageLoader,
+    type IRenderer,
+    type IRenderPipelineFactory,
+    type IWindowManager
+} from "./api/index.ts";
+import {
+    CameraFactory,
+    CpuImageProcessor,
+    GameTime,
+    type IBufferFactory,
+    type IGeometryBuilder,
+    type IGraphicsDevice,
+    type IImageProcessor,
+    type IInputManager,
     ImageLoader,
-    type IMeshFactory, type ISpriteBatch, type ITextureFactory, type ITimeManager, RenderingBackend, TimeManager
-} from "ris-framework-api";
-import {WebGlShaderModuleLoader} from "../webgl/shader/WebGlShaderModuleLoader.ts";
-import {TextureSamplerFilteringPreset} from "./rendering/enums.ts";
-import {SpriteBatch} from "./sprite-batch/SpriteBatch.ts";
-import type {ICameraFactory, IContentManager, IFramework, IImageLoader,
-    IRenderer,
-    IWindowManager
-} from "ris-framework-api";
-import {WebGlTextureFactory} from "../webgl/texture/WebGlTextureFactory.ts";
-import {WebGlRenderPipelineFactory} from "../webgl/render-pipelines/WebGlRenderPipelineFactory.ts";
-import type {IRenderPipelineFactory} from "ris-framework-api";
-import {MeshFactory, type IMaterialFactory, MaterialFactory} from "ris-framework-api";
-import {InputManager} from "./input/InputManager.ts";
+    type IMaterialFactory,
+    type IMeshFactory,
+    type ISpriteBatch,
+    type ITextureFactory,
+    type ITimeManager,
+    MaterialFactory,
+    MeshFactory,
+    RenderingBackend,
+    TimeManager
+} from "./api/index.ts";
+import {WebGlShaderModuleLoader} from "./webgl/shader/WebGlShaderModuleLoader.ts";
+import {TextureSamplerFilteringPreset} from "./core/rendering/enums.ts";
+import {SpriteBatch} from "./api/sprites/SpriteBatch.ts";
+import {WebGlTextureFactory} from "./webgl/texture/WebGlTextureFactory.ts";
+import {WebGlRenderPipelineFactory} from "./webgl/render-pipelines/WebGlRenderPipelineFactory.ts";
+import {InputManager} from "./api/input/InputManager.ts";
+import type {IKtx2Factory} from "ris-ktx2";
 import {Ktx2Factory} from "ris-ktx2";
-import type {IKtx2Factory} from "ris-ktx2-api";
+import {PowerPreferenceType} from "./api/rendering/PowerPreference.ts";
+import {vec2} from "gl-matrix";
 
 export class Framework implements IFramework {
 
@@ -44,19 +62,27 @@ export class Framework implements IFramework {
 
     /**
      * The constructor for the Framework class.
-     * @param options The optional options for them framework.
+     * @param options The optional framework configuration. When omitted, a default `FrameworkConfiguration` is used.
      */
-    constructor(options: FrameworkConfig | null = null) {
-        options = options ?? new FrameworkConfig();
+    constructor(options?: IFrameworkConfiguration) {
+        options = options ?? new FrameworkConfiguration();
+
+        // Without a canvas, WindowManager creates one and appends it to document.body.
+        if(!options.canvas){
+            console.warn("Canvas not provided. Creating canvas and appending it to document.body.")
+        }
+        options.backBufferSize = options.backBufferSize ?? vec2.fromValues(800, 600);
 
         this._container = container.createChildContainer();
-        this.windowManager = new WindowManager(options.canvas);
+        this.windowManager = new WindowManager(options.canvas ?? null);
 
         // Setup container.
-        this._container.registerInstance(IFrameworkSymbol, this);
-        const rendererConfig = new RenderConfiguration();
-        rendererConfig.backBufferSize = options.backBufferSize;
-        rendererConfig.textureFiltering = options.textureFiltering ?? TextureSamplerFilteringPreset.BILINEAR;
+        const rendererConfig: IRendererConfiguration = {
+            backBufferSize: options.backBufferSize,
+            textureFiltering: options.textureFiltering ?? TextureSamplerFilteringPreset.BILINEAR,
+            alpha: options.alpha ?? false,
+            powerPreference: options.powerPreference ?? PowerPreferenceType.DEFAULT
+        };
         this._container.registerInstance(RenderConfigurationSymbol, rendererConfig);
         this.renderer = new WebGlRenderer(this, rendererConfig);
         this.renderingBackend = RenderingBackend.WEB_GL;
@@ -107,7 +133,7 @@ export class Framework implements IFramework {
 
     /** @inheritDoc */
     public removeOnInitializedListener(event: () => void): void {
-        this._onInitializeListeners.splice(this._onInitializeListeners.indexOf(event), 1);
+        Framework._removeListener(this._onInitializeListeners, event);
     }
 
     /** @inheritdoc */
@@ -117,7 +143,7 @@ export class Framework implements IFramework {
 
     /** @inheritdoc */
     public removeOnLoadContentListener(event: () => void): void {
-        this._onLoadContentListeners.splice(this._onLoadContentListeners.indexOf(event), 1);
+        Framework._removeListener(this._onLoadContentListeners, event);
     }
 
     /** @inheritdoc */
@@ -127,7 +153,7 @@ export class Framework implements IFramework {
 
     /** @inheritdoc */
     public removeOnUpdateListener(event: (gameTime: GameTime) => void): void {
-        this._onUpdateListeners.splice(this._onUpdateListeners.indexOf(event), 1);
+        Framework._removeListener(this._onUpdateListeners, event);
     }
 
     /** @inheritdoc */
@@ -137,7 +163,18 @@ export class Framework implements IFramework {
 
     /** @inheritdoc */
     public removeOnRenderListener(event: () => void): void {
-        this._onRenderListeners.splice(this._onRenderListeners.indexOf(event), 1);
+        Framework._removeListener(this._onRenderListeners, event);
+    }
+
+    /**
+     * Removes a listener if it is registered. An unknown listener is ignored,
+     * instead of `splice(-1, 1)` removing the last registered one.
+     */
+    private static _removeListener<T>(listeners: T[], listener: T): void {
+        const index = listeners.indexOf(listener);
+        if (index >= 0) {
+            listeners.splice(index, 1);
+        }
     }
 
     /** @inheritdoc */
@@ -188,7 +225,10 @@ export class Framework implements IFramework {
     /** @inheritdoc */
     public initialize(): void {
 
-        this.ktx2Factory?.initializeAsync();
+        if(this.ktx2Factory) {
+            this.ktx2Factory.initializeAsync();
+        }
+
         (this.renderer as WebGlRenderer).initialize();
         this.spriteBatch.initialize();
         this.input.initialize();

package/src/api/FrameworkConfiguration.ts

@@ -0,0 +1,29 @@
+import { TextureSamplerFilteringPreset } from "../core/rendering/enums.ts";
+import {vec2} from "gl-matrix";
+import type {IFrameworkConfiguration} from "./IFrameworkConfiguration.ts";
+import {PowerPreferenceType} from "./rendering/PowerPreference.ts";
+
+/**
+ * The options for configuring the Framework.
+ * @public
+ */
+export class FrameworkConfiguration implements IFrameworkConfiguration {
+
+    /** @inheritDoc */
+    useKtx2 = false;
+
+    /** @inheritDoc */
+    canvas?: HTMLCanvasElement;
+
+    /** @inheritDoc */
+    backBufferSize?: vec2;
+
+    /** @inheritDoc */
+    textureFiltering? = TextureSamplerFilteringPreset.BILINEAR;
+
+    /** @inheritDoc */
+    alpha = false;
+
+    /** @inheritDoc */
+    powerPreference = PowerPreferenceType.DEFAULT;
+}

package/src/api/IFramework.ts

@@ -0,0 +1,153 @@
+import {RenderingBackend} from "./rendering/RenderingBackend.ts";
+import type { ISpriteBatch } from "./sprites/ISpriteBatch.ts";
+import type { IRenderer } from "./rendering/IRenderer.ts";
+import type { IGraphicsDevice } from "./rendering/IGraphicsDevice.ts";
+import type { IRenderPipelineFactory } from "./rendering/render-pipelines/IRenderPipelineFactory.ts";
+import type { IBufferFactory } from "./rendering/buffers/IBufferFactory.ts";
+import type { IGeometryBuilder } from "./geometry/IGeometryBuilder.ts";
+import type { ICameraFactory } from "./camera/ICameraFactory.ts";
+import type { ITextureFactory } from "./rendering/texture/ITextureFactory.ts";
+import type { IContentManager } from "./content/IContentManager.ts";
+import type { IImageLoader } from "./loaders/IImageLoader.ts";
+import type { IMeshFactory } from "./meshes/IMeshFactory.ts";
+import type { IMaterialFactory } from "./material/IMaterialFactory.ts";
+import type { ITimeManager } from "./time/ITimeManager.ts";
+import type { IInputManager } from "./input/IInputManager.ts";
+import type { IWindowManager } from "./window/IWindowManager.ts";
+import {GameTime} from "./time/GameTime.ts";
+import type { IImageProcessor } from "./image/IImageProcessor.ts";
+import type { IKtx2Factory } from "ris-ktx2";
+import type { IDisposable } from "./core/IDisposable.ts";
+
+/** The framework interface. */
+export interface IFramework extends IDisposable {
+
+    /**
+     * The image loader.
+     */
+    readonly imageLoader: IImageLoader;
+
+    /**
+     * The used rendering backend.
+     */
+    readonly renderingBackend: RenderingBackend;
+
+    /**
+     * The sprite batches.
+     */
+    readonly spriteBatch: ISpriteBatch;
+
+    /**
+     * The renderer used by the framework.
+     */
+    readonly renderer: IRenderer;
+
+    /**
+     * The graphics device used by the framework.
+     */
+    readonly graphicsDevice: IGraphicsDevice;
+
+    /**
+     * The pipeline factory.
+     * Responsible for creating low-level rendering pipelines.
+     * Pipeline includes everything necessary to render some geometry
+     * and can be thought of as a material or renderer.
+     */
+    readonly renderPipelineFactory: IRenderPipelineFactory;
+
+    /**
+     * The buffer factory, responsible for creating GPU memory buffers.
+     */
+    readonly bufferFactory: IBufferFactory;
+
+    /**
+     * The geometry builder.
+     */
+    readonly geometryBuilder: IGeometryBuilder;
+
+    /** The texture factory. */
+    readonly textureFactory: ITextureFactory;
+
+    /** The KTX2 factory. Initialized only if KTX2 is requested or loaded. */
+    readonly ktx2Factory?: IKtx2Factory;
+
+    /**
+     * The camera factory.
+     */
+    readonly cameraFactory: ICameraFactory;
+
+    /**
+     * The content manager.
+     */
+    readonly content: IContentManager;
+
+    /**
+     * The mesh factory.
+     */
+    readonly meshFactory: IMeshFactory;
+
+    /**
+     * The material factory.
+     */
+    readonly materialFactory: IMaterialFactory;
+
+    /**
+     * The time manager.
+     */
+    readonly timeManager: ITimeManager;
+
+    /** The input manager. */
+    readonly input: IInputManager;
+
+    /** The window manager. */
+    readonly windowManager: IWindowManager;
+
+    /** The image processor. */
+    readonly imageProcessor: IImageProcessor;
+
+    /**
+     * Called right after the framework is initialized and before the render loop starts.
+     * Content can be loaded here.
+     */
+    addOnLoadContentListener(event: () => void): void;
+
+    /**
+     * Called right after the framework is initialized and before the render loop starts.
+     * Content can be loaded here.
+     */
+    removeOnLoadContentListener(event: () => void): void;
+
+    /**
+     * Called when the framework is initialized.
+     */
+    addOnInitializedListener(event: () => void): void;
+
+    /**
+     * Called when the framework is initialized.
+     */
+    removeOnInitializedListener(event: () => void): void;
+
+    /**
+     * Called when framework is updated.
+     */
+    addOnUpdateListener(event: (gameTime: GameTime) => void): void;
+
+    /**
+     * Called when framework is updated.
+     */
+    removeOnUpdateListener(event: (gameTime: GameTime) => void): void;
+
+    /**
+     * Called when the framework is rendered.
+     */
+    addOnRenderListener(event: () => void): void;
+
+    /**
+     * Called when the framework is rendered.
+     */
+    removeOnRenderListener(event: () => void): void;
+
+    /** Initializes the framework. */
+    initialize(): void;
+
+}

package/src/api/IFrameworkConfiguration.ts

@@ -0,0 +1,30 @@
+import {PowerPreferenceType} from "./rendering/PowerPreference.ts";
+import type {vec2} from "gl-matrix";
+import type {TextureSamplerFilteringPreset} from "../core/rendering/enums.ts";
+
+/**
+ * The configuration for the framework.
+ * @public
+ **/
+export class IFrameworkConfiguration {
+    /** If true, creates and makes the KTX2 factory available. */
+    useKtx2?: boolean;
+
+    /** The size of back buffer. */
+    backBufferSize?: vec2;
+
+    /** The texture filtering to configure */
+    textureFiltering?: TextureSamplerFilteringPreset;
+
+    /**
+     * The HTMLCanvasElement to use for rendering.
+     * If null, a new canvas will be created and added to the document body.
+     */
+    canvas?: HTMLCanvasElement;
+
+    /** Should back buffer use alpha. */
+    alpha?: boolean;
+
+    /** The preference when it comes to selecting GPU device. Only makes sense to set on multi-GPU devices. */
+    powerPreference ?: PowerPreferenceType;
+}

package/src/api/_export.ts

@@ -0,0 +1,26 @@
+export * from "./IFramework.ts";
+export * from "./IFrameworkConfiguration.ts";
+export * from "./rendering/texture/_export-texture.ts";
+export * from "./rendering/buffers/_export-buffers.ts";
+export * from "./data/_export.ts";
+export * from "./geometry/_export-geometry.ts";
+export * from "./rendering/_export-rendering.ts";
+export * from "./rendering/render-pipelines/_export-render-pipelines.ts";
+export * from "./sprites/_export_sprites.ts";
+export * from "./camera/_export.ts";
+export * from "./time/_export_time.ts";
+export * from "./core/_export-core.ts";
+export * from "./shader/_export-shader.ts";
+export * from "./content/_export-content.ts";
+export * from "./rendering/primitive/_export.ts";
+export * from "./rendering/blending/_export.ts";
+export * from "./loaders/_export.ts";
+export * from "./rendering/renderpass/_export.ts";
+export * from "./window/_export.ts";
+export * from "./rendering/swapchain/_export.ts";
+export * from "./rendering/sampler/_export.ts"
+export * from "./utilities/_export.ts"
+export * from "./meshes/_export.ts";
+export * from "./material/_export.ts";
+export * from "./input/_export.ts";
+export * from "./image/_export.ts";

package/src/api/camera/CameraFactory.ts

@@ -0,0 +1,56 @@
+import  {vec2} from "gl-matrix";
+import type { ICameraFactory } from "./ICameraFactory.ts";
+import type { IFramework } from "../IFramework.ts";
+import type { IOrthographicCamera } from "./IOrthographicCamera.ts";
+import {OrthographicCamera} from "./OrthographicCamera.ts";
+import {OrbitCamera} from "./OrbitCamera.ts";
+import {PerspectiveCamera} from "./PerspectiveCamera.ts";
+import {MathHelper} from "../utilities/MathHelper.ts";
+
+/** The Camera Factory */
+export class CameraFactory implements ICameraFactory {
+
+    static DEFAULT_ORIGIN = vec2.fromValues(0,0);
+
+    /**
+     * The constructor.
+     * @param _framework
+     */
+    public constructor(private readonly _framework: IFramework) {}
+
+    /** @inheritDoc */
+    public createDefaultOrthographicCamera(origin?: vec2): IOrthographicCamera {
+
+        origin = origin ?? CameraFactory.DEFAULT_ORIGIN;
+
+        const framework = this._framework;
+        const left = -framework.renderer.backBufferSize[0] * origin[0];
+        const top = -framework.renderer.backBufferSize[1] * origin[1];
+        const right = left + framework.renderer.backBufferSize[0];
+        const bottom = top + framework.renderer.backBufferSize[1];
+
+        return this.createOrthographicCamera(left, right, top, bottom, 0, 1);
+    }
+
+    /** @inheritDoc */
+    public createOrthographicCamera(left: number, right: number, top: number, bottom: number, near: number, far: number): IOrthographicCamera {
+        const camera = new OrthographicCamera(this._framework, left, right, top, bottom, near, far);
+        camera.initialize();
+        return camera;
+    }
+
+    /** @inheritDoc */
+    public createOrbitCamera(fov = 60, aspectRatio = 1, near = 0.01, far = 100): OrbitCamera {
+        return new OrbitCamera(this.createPerspectiveCamera(fov, aspectRatio, near, far), this._framework.input);
+
+    }
+
+    /** @inheritDoc */
+    public createPerspectiveCamera(fov= 60, aspectRatio = 1, near= 0.01, far = 100): PerspectiveCamera {
+        fov = MathHelper.toRadians(fov);
+        const camera = new PerspectiveCamera(this._framework, fov, aspectRatio, near, far);
+        camera.initialize();
+        return camera;
+    }
+
+}