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

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

@@ -0,0 +1,33 @@
+import { TextureFormat } from "ris-framework-api";
+import { vec2 } from "gl-matrix";
+/**
+ * The utilities for working with WebGL textures.
+ */
+export declare class WebGlTextureUtilities {
+    /**
+     * Creates a 2D texture.
+     * @param gl The WebGL rendering context.
+     * @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 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.
+     * @returns The created WebGL texture.
+     */
+    createTexture2D(gl: WebGL2RenderingContext, width: number, height: number, data?: Uint8Array[] | HTMLImageElement[] | null, textureFormat?: TextureFormat, useMipMaps?: boolean, anisotropy?: number, label?: string | null): WebGLTexture;
+    /**
+     * Creates a compressed 2D texture.
+     * @param gl The WebGL rendering context.
+     * @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.
+     * @returns The created WebGL texture.
+     */
+    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

@@ -0,0 +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"}

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

@@ -0,0 +1,60 @@
+import { WebGLBlendingUtilities } from "./webgl-blending-utilities";
+import { WebGlBufferUtilities } from "./WebGlBufferUtilities.js";
+import { WebGLCullingUtilities } from "./webgl-culling-utilities";
+import { WebGLFilterAnisotropicUtilities } from "./webgl-filter-anisotropic-utilities";
+import { WebGlFrameBufferUtilities } from "./WebGlFrameBufferUtilities.js";
+import { WebGLProgramUtilities } from "./webgl-program-utilities";
+import { WebGLRenderbufferUtilities } from "./webgl-renderbuffer-utilities";
+import { WebGlSamplerUtilities } from "./WebGlSamplerUtilities.js";
+import { WebGlShaderUtilities } from "./WebGlShaderUtilities.js";
+import { WebGlTextureUtilities } from "./WebGlTextureUtilities.js";
+/**
+ * The utility class for WebGL operations.
+ */
+export declare class WebGlUtilities {
+    /**
+     * The WebGL blending utilities.
+     */
+    static readonly blending: WebGLBlendingUtilities;
+    /**
+     * The WebGL anisotropic filtering utilities.
+     */
+    static readonly anisotropy: WebGLFilterAnisotropicUtilities;
+    /**
+     * The WebGL culling utilities.
+     */
+    static readonly culling: WebGLCullingUtilities;
+    /**
+     * The WebGL texture utilities.
+     */
+    static readonly texture: WebGlTextureUtilities;
+    /**
+     * The WebGL framebuffer utilities.
+     */
+    static readonly framebuffer: WebGlFrameBufferUtilities;
+    /**
+     * The WebGL render buffer utilities.
+     */
+    static readonly renderbuffer: WebGLRenderbufferUtilities;
+    /**
+     * The WebGL buffer utilities.
+     */
+    static readonly buffer: WebGlBufferUtilities;
+    /**
+     * The WebGL render buffer utilities.
+     */
+    static readonly renderBuffer: WebGLRenderbufferUtilities;
+    /**
+     * The WebGL sampler utilities.
+     */
+    static readonly sampler: WebGlSamplerUtilities;
+    /**
+     * The WebGL shader utilities.
+     */
+    static readonly shader: WebGlShaderUtilities;
+    /**
+     * The WebGL program utilities.
+     */
+    static readonly program: WebGLProgramUtilities;
+}
+//# sourceMappingURL=WebGlUtilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebGlUtilities.d.ts","sourceRoot":"","sources":["../../../src/webgl/utilities/WebGlUtilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;GAEG;AACH,qBAAa,cAAc;IAEvB;;OAEG;IACH,gBAAuB,QAAQ,yBAAgC;IAE/D;;OAEG;IACH,gBAAuB,UAAU,kCAAyC;IAE1E;;OAEG;IACH,gBAAuB,OAAO,wBAA+B;IAE7D;;OAEG;IACH,gBAAuB,OAAO,wBAA+B;IAE7D;;OAEG;IACH,gBAAuB,WAAW,4BAAmC;IAErE;;OAEG;IACH,gBAAuB,YAAY,6BAAoC;IAEvE;;OAEG;IACH,gBAAuB,MAAM,uBAA8B;IAE3D;;OAEG;IACH,gBAAuB,YAAY,6BAAoC;IAEvE;;OAEG;IACH,gBAAuB,OAAO,wBAA+B;IAE7D;;OAEG;IACH,gBAAuB,MAAM,uBAA8B;IAE3D;;OAEG;IACH,gBAAuB,OAAO,wBAA+B;CAChE"}

package/dist/webgl/utilities/spector-js-utilities.d.ts

@@ -0,0 +1,9 @@
+export declare class SpectorJSUtilities {
+    /**
+     * Sets the label for a WebGL object to be used by Spector.js.
+     * @param target The WebGL object to set the label for (e.g., WebGLBuffer, WebGLTexture, WebGLFramebuffer, etc.).
+     * @param label The label to set for the WebGL object. This will be displayed in Spector.js for easier identification.
+     */
+    static setLabel(target: any, label: string): void;
+}
+//# sourceMappingURL=spector-js-utilities.d.ts.map

package/dist/webgl/utilities/spector-js-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spector-js-utilities.d.ts","sourceRoot":"","sources":["../../../src/webgl/utilities/spector-js-utilities.ts"],"names":[],"mappings":"AAAA,qBAAa,kBAAkB;IAE3B;;;;OAIG;WACW,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;CAK3D"}

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

@@ -0,0 +1,17 @@
+/**
+ * The utility class for WebGL blending operations.
+ */
+export declare class WebGLBlendingUtilities {
+    /**
+     * Enables blending with the specified parameters.
+     * @param gl The WebGL2RenderingContext context.
+     * @param colorFunc The color function. By default, it is FUNC_ADD.
+     * @param srcColorFactor The source color factor. By default, it is SRC_ALPHA.
+     * @param dstColorFactor The destination color factor. By default, it is ONE_MINUS_SRC_ALPHA.
+     * @param alphaFunc The alpha function. By default, it is FUNC_ADD.
+     * @param srcAlphaFactor The source alpha factor. By default, it is SRC_ALPHA.
+     * @param dstAlphaFactor The destination alpha factor. By default, it is ONE_MINUS_SRC_ALPHA.
+     */
+    enableBlend(gl: WebGL2RenderingContext, colorFunc?: number | null, srcColorFactor?: number | null, dstColorFactor?: number | null, alphaFunc?: number | null, srcAlphaFactor?: number | null, dstAlphaFactor?: number | null): void;
+}
+//# sourceMappingURL=webgl-blending-utilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webgl-blending-utilities.d.ts","sourceRoot":"","sources":["../../../src/webgl/utilities/webgl-blending-utilities.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,sBAAsB;IAC/B;;;;;;;;;OASG;IACI,WAAW,CACd,EAAE,EAAE,sBAAsB,EAC1B,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,cAAc,GAAE,MAAM,GAAG,IAAW,EACpC,cAAc,GAAE,MAAM,GAAG,IAAW,EACpC,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,cAAc,GAAE,MAAM,GAAG,IAAW,EACpC,cAAc,GAAE,MAAM,GAAG,IAAW,GACrC,IAAI;CA8DV"}

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

@@ -0,0 +1,13 @@
+import { Culling } from "../../core/renderer/enums";
+/**
+ * The WebGL culling utilities.
+ */
+export declare class WebGLCullingUtilities {
+    /**
+     * Sets the culling mode.
+     * @param gl The WebGL2RenderingContext.
+     * @param culling The culling mode.
+     */
+    setCulling(gl: WebGL2RenderingContext, culling: Culling): void;
+}
+//# sourceMappingURL=webgl-culling-utilities.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,24 @@
+/**
+ * The utility class for WebGL anisotropic filtering operations.
+ */
+export declare class WebGLFilterAnisotropicUtilities {
+    /**
+     * The max anisotropy extension string.
+     */
+    private MAX_ANISOTROPY_EXT;
+    private _extension;
+    /**
+     * Gets the max anisotropy.
+     * @param gl The WebGL2 rendering context.
+     * @returns The maximum supported level of anisotropic filtering. <c>0</c> if not supported.
+     */
+    getMaxAnisotropy(gl: WebGL2RenderingContext): number;
+    /**
+     * Sets the anisotropy filtering level for texture.
+     * @param gl The WebGL2 rendering context.
+     * @param texture The WebGL texture.
+     * @param anisotropy The level of anisotropic filtering
+     */
+    setAnisotropy(gl: WebGL2RenderingContext, texture: WebGLTexture, anisotropy: number): void;
+}
+//# sourceMappingURL=webgl-filter-anisotropic-utilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webgl-filter-anisotropic-utilities.d.ts","sourceRoot":"","sources":["../../../src/webgl/utilities/webgl-filter-anisotropic-utilities.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,+BAA+B;IACxC;;OAEG;IACH,OAAO,CAAC,kBAAkB,CAA4C;IAEtE,OAAO,CAAC,UAAU,CAAM;IAExB;;;;OAIG;IACI,gBAAgB,CAAC,EAAE,EAAE,sBAAsB,GAAG,MAAM;IAU3D;;;;;OAKG;IACI,aAAa,CAAC,EAAE,EAAE,sBAAsB,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM;CAI7F"}

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

@@ -0,0 +1,14 @@
+/**
+ * This module provides utility functions for working with WebGL programs, such as creating and linking shader programs.
+ */
+export declare class WebGLProgramUtilities {
+    /**
+     * Creates a WebGL program with the given vertex shader and fragment shader.
+     * @param gl The WebGL2 rendering context.
+     * @param vertexShader The vertex shader to be attached to the program.
+     * @param fragmentShader The fragment shader to be attached to the program.
+     * @returns The linked WebGLProgram object.
+     */
+    create(gl: WebGL2RenderingContext, vertexShader: WebGLShader, fragmentShader: WebGLShader): WebGLProgram;
+}
+//# sourceMappingURL=webgl-program-utilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webgl-program-utilities.d.ts","sourceRoot":"","sources":["../../../src/webgl/utilities/webgl-program-utilities.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,qBAAqB;IAE9B;;;;;;OAMG;IACI,MAAM,CAAC,EAAE,EAAE,sBAAsB,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,GAAG,YAAY;CAgBlH"}

package/dist/webgl/utilities/webgl-render-buffer-utilities.d.ts

@@ -0,0 +1,5 @@
+import type { TextureFormat } from "ris-framework-api";
+export declare class WebGLRenderBufferUtilities {
+    create(gl: WebGL2RenderingContext, internalFormat: TextureFormat, width: number, height: number, label?: string | null): WebGLRenderbuffer;
+}
+//# sourceMappingURL=webgl-render-buffer-utilities.d.ts.map

package/dist/webgl/utilities/webgl-render-buffer-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgl-render-buffer-utilities.d.ts","sourceRoot":"","sources":["../../../src/webgl/utilities/webgl-render-buffer-utilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,qBAAa,0BAA0B;IAG5B,MAAM,CAAC,EAAE,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,IAAW,GAAG,iBAAiB;CAgB1J"}

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

@@ -0,0 +1,17 @@
+import type { TextureFormat } from "ris-framework-api";
+/**
+ * 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.
+ */
+export declare class WebGLRenderbufferUtilities {
+    /**
+     * Creates a render buffer with the specified internal format, width, height, and label.
+     * @param gl The WebGL2 rendering context.
+     * @param internalFormat The internal format of the render buffer, which determines the type of data stored in the buffer (e.g., depth, stencil, or depth-stencil).
+     * @param width The width of the render buffer in pixels.
+     * @param height The height of the render buffer in pixels.
+     * @param label The label of the render buffer, which can be used for debugging purposes. It is optional and can be null or undefined.
+     * @returns The created WebGLRenderbuffer object.
+     */
+    create(gl: WebGL2RenderingContext, internalFormat: TextureFormat, width: number, height: number, label: string | null | undefined): WebGLRenderbuffer;
+}
+//# sourceMappingURL=webgl-renderbuffer-utilities.d.ts.map

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

@@ -0,0 +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"}

package/package.json

@@ -1,27 +1,31 @@
 {
   "name": "ris-framework",
-  "version": "0.1.0-dev.6",
+  "version": "0.1.0-dev.7",
   "repository": {
     "type": "git",
     "url": "https://github.com/luka712/ris-framework-ts"
   },
   "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./src/index.ts",
-      "import": "./src/index.ts",
-      "default": "./src/index.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     }
   },
   "scripts": {
     "dev": "vite",
-    "build": "tsc && vite build",
+    "build": "tsc --noEmit && npm run build:lib && npm run build:app",
+    "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"
   },
   "devDependencies": {
+    "ris-ktx2": "^0.1.0-dev.2",
     "typescript": "~5.9.3",
     "vite": "^7.2.4"
   },
@@ -29,16 +33,18 @@
     "gl-matrix": "^3.4.4",
     "reflect-metadata": "^0.2.2",
     "ris-framework-api": "0.1.0-dev.5",
-    "ris-ktx2": "^0.1.0-dev.2",
+    "ris-ktx2-api": "^0.1.0-dev.2.4",
     "tsyringe": "^4.10.0"
   },
   "files": [
     "dist",
     "src",
     "shaders",
+    "LICENSES",
     "LICENSE",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "THIRD_PARTY_NOTICES.md"
   ],
   "publishConfig": {
     "access": "public"

package/src/glsl-raw.d.ts

@@ -0,0 +1,4 @@
+declare module "*.glsl?raw" {
+    const source: string;
+    export default source;
+}

package/dist/assets/_ris-ktx2-node-module-stub-DwDS30PT.js

@@ -1 +0,0 @@
-function e(){throw new Error("ris-ktx2 Node loader is not included in the browser build.")}function r(){throw new Error("ris-ktx2 Node file loader is not included in the browser build.")}export{e as createKtxModuleNode,r as readFileBytes};

package/dist/assets/index-BmeGit54.css

@@ -1 +0,0 @@
-:root{font-family:system-ui,Avenir,Helvetica,Arial,sans-serif;line-height:1.5;font-weight:400;color-scheme:light dark;color:#ffffffde;background-color:#242424;font-synthesis:none;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}a{font-weight:500;color:#646cff;text-decoration:inherit}a:hover{color:#535bf2}body{margin:0;display:flex;place-items:center;min-width:320px;min-height:100vh}h1{font-size:3.2em;line-height:1.1}#app{max-width:1280px;margin:0 auto;padding:2rem;text-align:center}.logo{height:6em;padding:1.5em;will-change:filter;transition:filter .3s}.logo:hover{filter:drop-shadow(0 0 2em #646cffaa)}.logo.vanilla:hover{filter:drop-shadow(0 0 2em #3178c6aa)}.card{padding:2em}.read-the-docs{color:#888}button{border-radius:8px;border:1px solid transparent;padding:.6em 1.2em;font-size:1em;font-weight:500;font-family:inherit;background-color:#1a1a1a;cursor:pointer;transition:border-color .25s}button:hover{border-color:#646cff}button:focus,button:focus-visible{outline:4px auto -webkit-focus-ring-color}@media(prefers-color-scheme:light){:root{color:#213547;background-color:#fff}a:hover{color:#747bff}button{background-color:#f9f9f9}}