ris-framework 0.1.0 → 0.2.0-dev.12

package/dist/api/content/IContentManager.d.ts

@@ -1,9 +1,13 @@
+import type { ICamera } from "../camera/ICamera.js";
+import type { GeometryFormat } from "../geometry/GeometryFormat.js";
+import type { IRenderableMesh } from "../meshes/IRenderableMesh.js";
 import type { IShaderModuleLoader } from "../shader/IShaderModuleLoader.js";
 import type { IShaderModule } from "../shader/IShaderModule.js";
 import type { ITexture2D } from "../rendering/texture/ITexture2D.js";
 import { TextureDescriptor } from "../rendering/texture/TextureDescriptor.js";
 import { ContentConfig } from "./ContentConfig.js";
 import type { IKtx2Texture } from "ris-ktx2";
+import type { IMesh } from "../meshes/IMesh.js";
 /**
  * The content manager.
  */
@@ -22,9 +26,12 @@ export interface IContentManager {
     /**
      * Loads a shader module.
      * @param shaderAssetId - The id of a shader asset.
+     * @param keyValueDictionary - If present, tries to find key in shader such that it replaced ##DIRECTIONAL_LIGHT_COUNT## by given value for key DIRECTIONAL_LIGHST_COUNT.
      * @returns The shader module.
      */
-    loadShaderModule(shaderAssetId: string): IShaderModule;
+    loadShaderModule(shaderAssetId: string, keyValueDictionary?: {
+        [id: string]: number;
+    }): IShaderModule;
     /**
      * Loads a texture2D.
      * @param path - The file path to the texture.
@@ -33,5 +40,32 @@ export interface IContentManager {
      * @returns The Texture2D.
      */
     loadTexture2DAsync(path: string, desc?: TextureDescriptor, contentConfig?: ContentConfig): Promise<ITexture2D>;
+    /**
+     * Loads a plain mesh (geometry and buffers only, no material or transform) from an OBJ (Wavefront) file,
+     * like C# `ContentManager.LoadMesh`. Materials (.mtl) are not loaded.
+     * @param path The path or url to the .obj file.
+     * @param geometryFormat The vertex layout of the buffers, e.g. the format of the material it will be drawn with.
+     * @return The mesh.
+     */
+    loadMeshAsync(path: string, geometryFormat: GeometryFormat): Promise<IMesh>;
+    /**
+     * Loads an OBJ mesh with unlit materials, through `framework.objLoader`.
+     * The root mesh has no material; each `usemtl` range is a sub mesh with an unlit material
+     * (`Kd` as diffuse colour, `d` as alpha, white when missing). Add it with `scene.add(mesh)`.
+     * @param path The path or url to the .obj file.
+     * @param camera The optional camera; `scene.update()` assigns the scene camera anyway.
+     * @return The root mesh.
+     */
+    loadUnlitMeshAsync(path: string, camera?: ICamera): Promise<IRenderableMesh>;
+    /**
+     * Loads an OBJ mesh with Blinn-Phong materials: shorthand for
+     * `framework.objLoader.loadAsync(path, {projectionViewBuffer: camera.projectionViewBuffer, cameraPositionBuffer: camera.positionBuffer})`.
+     * See `ObjLoader.loadAsync` for the .mtl mapping. Add it with `scene.add(mesh)`; the scene assigns its camera and lights.
+     * @param path The path or url to the .obj file. A relative `mtllib` is resolved against it.
+     * @param camera An initialized camera (e.g. `scene.camera`).
+     * @return The root mesh.
+     * @throws Error when the camera has no buffers.
+     */
+    loadBlinnPhongMeshAsync(path: string, camera: ICamera): Promise<IRenderableMesh>;
 }
 //# sourceMappingURL=IContentManager.d.ts.map

package/dist/api/content/IContentManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IContentManager.d.ts","sourceRoot":"","sources":["../../../src/api/content/IContentManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAC,iBAAiB,EAAC,MAAM,2CAA2C,CAAC;AAC5E,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,eAAe;IAE5B;;OAEG;IACH,QAAQ,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;IAEjD;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE3E;;;;OAIG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,CAAC;IAEvD;;;;;;OAMG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAClH"}
+{"version":3,"file":"IContentManager.d.ts","sourceRoot":"","sources":["../../../src/api/content/IContentManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAC,iBAAiB,EAAC,MAAM,2CAA2C,CAAC;AAC5E,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,oBAAoB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,eAAe;IAE5B;;OAEG;IACH,QAAQ,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;IAEjD;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE3E;;;;;OAKG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE;QAAE,CAAC,EAAE,EAAC,MAAM,GAAG,MAAM,CAAA;KAAC,GAAG,aAAa,CAAC;IAEpG;;;;;;OAMG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE/G;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAE5E;;;;;;;OAOG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE7E;;;;;;;;OAQG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAEpF"}

package/dist/api/content/ShaderModuleContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShaderModuleContent.d.ts","sourceRoot":"","sources":["../../../src/api/content/ShaderModuleContent.ts"],"names":[],"mappings":"AASA;;;;;;;;;GASG;AAGH,eAAO,MAAM,mBAAmB,EAAG;IAAC,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,CAAA;CAyBpD,CAAA"}
+{"version":3,"file":"ShaderModuleContent.d.ts","sourceRoot":"","sources":["../../../src/api/content/ShaderModuleContent.ts"],"names":[],"mappings":"AAYA;;;;;;;;;GASG;AAGH,eAAO,MAAM,mBAAmB,EAAG;IAAC,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,CAAA;CA+BpD,CAAA"}

package/dist/api/data/Color.d.ts

@@ -115,5 +115,10 @@ export declare class Color implements Iterable<number> {
      * @param o - The color that receives value.
      */
     lerp(a: Color, b: Color, t: number, o: Color): void;
+    /**
+     * Copy self and return new instance with same values.
+     * @return Color
+     * */
+    copy(): Color;
 }
 //# sourceMappingURL=Color.d.ts.map

package/dist/api/data/Color.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Color.d.ts","sourceRoot":"","sources":["../../../src/api/data/Color.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEvC;;GAEG;AACH,qBAAa,KAAM,YAAW,QAAQ,CAAC,MAAM,CAAC;IAE1C,OAAO,CAAC,OAAO,CAAa;IAE5B;;;;;;OAMG;gBAEE,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,SAAI;IAQV,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC;IAI/C;;OAEG;IACH,IAAW,CAAC,IAAK,MAAM,CAEtB;IAED,IAAW,CAAC,CAAC,KAAK,EAAE,MAAM,EAEzB;IAED;;OAEG;IACH,IAAW,CAAC,IAAK,MAAM,CAEtB;IAED,IAAW,CAAC,CAAC,KAAK,EAAE,MAAM,EAEzB;IAED;;OAEG;IACH,IAAW,CAAC,IAAK,MAAM,CAEtB;IAED,IAAW,CAAC,CAAC,KAAK,EAAE,MAAM,EAEzB;IAED;;OAEG;IACH,IAAW,CAAC,IAAK,MAAM,CAEtB;IAED,IAAW,CAAC,CAAC,KAAK,EAAE,MAAM,EAEzB;IAED;;OAEG;WACW,KAAK,IAAI,KAAK;IAI5B;;OAEG;WACW,KAAK,IAAI,KAAK;IAI5B,6BAA6B;WACf,WAAW;IAIzB;;OAEG;WACW,SAAS,IAAI,KAAK;IAIhC;;OAEG;WACW,GAAG,IAAI,KAAK;IAI1B;;OAEG;WACW,KAAK,IAAI,KAAK;IAI5B;;OAEG;WACW,IAAI,IAAI,KAAK;IAI3B;;OAEG;WACW,IAAI,IAAI,KAAK;IAI3B;;OAEG;WACW,MAAM,IAAI,KAAK;IAI7B;;OAEG;WACW,KAAK,IAAI,KAAK;IAI5B;;OAEG;WACW,UAAU,IAAI,KAAK;IAIjC;;OAEG;WACW,SAAS,IAAI,KAAK;IAIhC;;OAEG;WACW,gBAAgB,IAAI,KAAK;IAIvC;;OAEG;WACW,MAAM,IAAI,KAAK;IAI7B;;;OAGG;IACI,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAO9B;;;OAGG;IACI,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAOpC;;;OAGG;IACI,SAAS,IAAI,IAAI;IAIxB;;;OAGG;IACI,SAAS,IAAI,IAAI;IAIxB;;;;;;OAMG;IACI,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK;CAQtD"}
+{"version":3,"file":"Color.d.ts","sourceRoot":"","sources":["../../../src/api/data/Color.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEvC;;GAEG;AACH,qBAAa,KAAM,YAAW,QAAQ,CAAC,MAAM,CAAC;IAE1C,OAAO,CAAC,OAAO,CAAa;IAE5B;;;;;;OAMG;gBAEE,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,SAAI;IAQV,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC;IAI/C;;OAEG;IACH,IAAW,CAAC,IAAK,MAAM,CAEtB;IAED,IAAW,CAAC,CAAC,KAAK,EAAE,MAAM,EAEzB;IAED;;OAEG;IACH,IAAW,CAAC,IAAK,MAAM,CAEtB;IAED,IAAW,CAAC,CAAC,KAAK,EAAE,MAAM,EAEzB;IAED;;OAEG;IACH,IAAW,CAAC,IAAK,MAAM,CAEtB;IAED,IAAW,CAAC,CAAC,KAAK,EAAE,MAAM,EAEzB;IAED;;OAEG;IACH,IAAW,CAAC,IAAK,MAAM,CAEtB;IAED,IAAW,CAAC,CAAC,KAAK,EAAE,MAAM,EAEzB;IAED;;OAEG;WACW,KAAK,IAAI,KAAK;IAI5B;;OAEG;WACW,KAAK,IAAI,KAAK;IAI5B,6BAA6B;WACf,WAAW;IAIzB;;OAEG;WACW,SAAS,IAAI,KAAK;IAIhC;;OAEG;WACW,GAAG,IAAI,KAAK;IAI1B;;OAEG;WACW,KAAK,IAAI,KAAK;IAI5B;;OAEG;WACW,IAAI,IAAI,KAAK;IAI3B;;OAEG;WACW,IAAI,IAAI,KAAK;IAI3B;;OAEG;WACW,MAAM,IAAI,KAAK;IAI7B;;OAEG;WACW,KAAK,IAAI,KAAK;IAI5B;;OAEG;WACW,UAAU,IAAI,KAAK;IAIjC;;OAEG;WACW,SAAS,IAAI,KAAK;IAIhC;;OAEG;WACW,gBAAgB,IAAI,KAAK;IAIvC;;OAEG;WACW,MAAM,IAAI,KAAK;IAI7B;;;OAGG;IACI,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAO9B;;;OAGG;IACI,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAOpC;;;OAGG;IACI,SAAS,IAAI,IAAI;IAIxB;;;OAGG;IACI,SAAS,IAAI,IAAI;IAIxB;;;;;;OAMG;IACI,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK;IAOnD;;;SAGK;IACE,IAAI,IAAI,KAAK;CAGvB"}

package/dist/api/geometry/BaseGeometry.d.ts

@@ -5,6 +5,15 @@ import type { IGeometry } from "../index.js";
  * The default IGeometry implementation. GeometryBuilder fills it with vertex data.
  */
 export declare class BaseGeometry implements IGeometry {
+    /**
+     * Initializes a new instance of the BaseGeometry class.
+     * @param positions The optional positions of the geometry.
+     * @param indices The optional indices of the geometry.
+     * @param normals The optional normals of the geometry.
+     * @param textureCoords The optional texture coordinates of the geometry.
+     * @param colors The optional colors of the geometry.
+     */
+    constructor(positions?: number[], indices?: number[], normals?: number[], textureCoords?: number[], colors?: number[]);
     /** @inheritdoc */
     vertexCount: number;
     /** @inheritdoc */

package/dist/api/geometry/BaseGeometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseGeometry.d.ts","sourceRoot":"","sources":["../../../src/api/geometry/BaseGeometry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,qBAAa,YAAa,YAAW,SAAS;IAE1C,kBAAkB;IACX,WAAW,EAAE,MAAM,CAAK;IAE/B,kBAAkB;IACX,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,kBAAkB;IACX,eAAe,EAAE,YAAY,CAA2B;IAE/D,kBAAkB;IACX,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,kBAAkB;IACX,WAAW,EAAE,YAAY,CAA2B;IAE3D,kBAAkB;IACX,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhC,kBAAkB;IACX,aAAa,EAAE,YAAY,CAA2B;IAE7D,kBAAkB;IACX,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,kBAAkB;IACX,aAAa,EAAE,YAAY,CAA2B;IAE7D,+BAA+B;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;IA6ClB;;;;OAIG;IACI,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE;CA+DzD"}
+{"version":3,"file":"BaseGeometry.d.ts","sourceRoot":"","sources":["../../../src/api/geometry/BaseGeometry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AAG3C;;GAEG;AACH,qBAAa,YAAa,YAAW,SAAS;IAE1C;;;;;;;OAOG;gBACS,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE;IAcrH,kBAAkB;IACX,WAAW,EAAE,MAAM,CAAK;IAE/B,kBAAkB;IACX,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,kBAAkB;IACX,eAAe,EAAE,YAAY,CAA2B;IAE/D,kBAAkB;IACX,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,kBAAkB;IACX,WAAW,EAAE,YAAY,CAA2B;IAE3D,kBAAkB;IACX,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhC,kBAAkB;IACX,aAAa,EAAE,YAAY,CAA2B;IAE7D,kBAAkB;IACX,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,kBAAkB;IACX,aAAa,EAAE,YAAY,CAA2B;IAE7D,+BAA+B;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;IA6ClB;;;;OAIG;IACI,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE;CA+DzD"}

package/dist/api/geometry/GeometryBuilder.d.ts

@@ -1,5 +1,5 @@
 import { vec2 } from "gl-matrix";
-import type { IGeometry, IGeometryBuilder } from "../index.js";
+import type { IGeometry, IGeometryBuilder, GeometryDescriptor } from "../index.js";
 /**
  * The GeometryBuilder class provides methods for creating various types of geometries, such as quads, with specified parameters like scale and winding order.
  */
@@ -7,5 +7,7 @@ export declare class GeometryBuilder implements IGeometryBuilder {
     static DEFAULT_SCALE: vec2;
     /** @inheritdoc */
     quadGeometry(scale?: vec2 | null, counterClockwise?: boolean): IGeometry;
+    /** @inheritdoc */
+    create(descriptor: GeometryDescriptor): IGeometry;
 }
 //# sourceMappingURL=GeometryBuilder.d.ts.map

package/dist/api/geometry/GeometryBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeometryBuilder.d.ts","sourceRoot":"","sources":["../../../src/api/geometry/GeometryBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,KAAK,EAAC,SAAS,EAAE,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAE7D;;GAEG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IAEpD,MAAM,CAAC,aAAa,OAAwB;IAE5C,kBAAkB;IACX,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,gBAAgB,GAAE,OAAc,GAAG,SAAS;CA6CxF"}
+{"version":3,"file":"GeometryBuilder.d.ts","sourceRoot":"","sources":["../../../src/api/geometry/GeometryBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,KAAK,EAAC,SAAS,EAAE,gBAAgB,EAAE,kBAAkB,EAAC,MAAM,aAAa,CAAC;AAEjF;;GAEG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IAEpD,MAAM,CAAC,aAAa,OAAwB;IAE5C,kBAAkB;IACX,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,gBAAgB,GAAE,OAAc,GAAG,SAAS;IA8CrF,kBAAkB;IACX,MAAM,CAAC,UAAU,EAAE,kBAAkB,GAAG,SAAS;CAU3D"}

package/dist/api/geometry/IGeometryBuilder.d.ts

@@ -1,5 +1,21 @@
 import type { IGeometry } from "./IGeometry.js";
 import { vec2 } from "gl-matrix";
+/**
+ * The geometry descriptor.
+ * @public
+ */
+export interface GeometryDescriptor {
+    /** Positions, 3 per vertex. */
+    readonly positions: number[];
+    /** Triangle indices, 3 per triangle. Optional for non-indexed geometry. */
+    readonly indices?: number[];
+    /** Normals, 3 per vertex. */
+    readonly normals?: number[];
+    /** Texture coordinates, 2 per vertex. */
+    readonly textureCoords?: number[];
+    /** RGBA colours, 4 per vertex. */
+    readonly colors?: number[];
+}
 /**
  * The geometry builder.
  */
@@ -11,5 +27,13 @@ export interface IGeometryBuilder {
      * @returns The geometry.
      */
     quadGeometry(scale?: vec2, counterClockwise?: boolean): IGeometry;
+    /**
+     * Creates geometry from a plain descriptor.
+     * Attributes a material's geometry format needs but the descriptor lacks are filled with defaults:
+     * white colours, zero texture coordinates and zero normals.
+     * @param descriptor - The geometry descriptor. Its arrays are copied.
+     * @returns The geometry.
+     */
+    create(descriptor: GeometryDescriptor): IGeometry;
 }
 //# sourceMappingURL=IGeometryBuilder.d.ts.map

package/dist/api/geometry/IGeometryBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IGeometryBuilder.d.ts","sourceRoot":"","sources":["../../../src/api/geometry/IGeometryBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAEjC;;;;;OAKG;IACD,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAEnE"}
+{"version":3,"file":"IGeometryBuilder.d.ts","sourceRoot":"","sources":["../../../src/api/geometry/IGeometryBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAE/B;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAE/B,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAE7B,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,yCAAyC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAElC,kCAAkC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAEjC;;;;;OAKG;IACD,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAEpE;;;;;;OAMG;IACD,MAAM,CAAC,UAAU,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACnD"}

package/dist/api/geometry/_export-geometry.d.ts

@@ -2,4 +2,5 @@ export * from "./IGeometryBuilder.js";
 export * from "./IGeometry.js";
 export * from "./VertexFormat.js";
 export * from "./GeometryFormat.js";
+export * from "./BaseGeometry.js";
 //# sourceMappingURL=_export-geometry.d.ts.map

package/dist/api/geometry/_export-geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_export-geometry.d.ts","sourceRoot":"","sources":["../../../src/api/geometry/_export-geometry.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"_export-geometry.d.ts","sourceRoot":"","sources":["../../../src/api/geometry/_export-geometry.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/dist/api/input/InputManager.d.ts

@@ -13,6 +13,8 @@ export declare class InputManager implements IInputManager {
     private readonly _touchCapabilities;
     private readonly _contacts;
     private _touchListening;
+    /** Aborting it removes every canvas listener added in initialize(). */
+    private _listeners;
     /** Set in update, consumed in afterUpdate. Ageing before a publish would hide the press. */
     private _touchPublished;
     private static readonly _PHASE_BEGIN;
@@ -34,6 +36,8 @@ export declare class InputManager implements IInputManager {
     getTouchCollection(): TouchCollection;
     /** @inheritDoc */
     getTouchCapabilities(): TouchPanelCapabilities;
+    /** Removes the canvas listeners. Called from `Framework.dispose()`. */
+    dispose(): void;
     /** @inheritDoc */
     initialize(): void;
     private _handleMouseEvents;

package/dist/api/input/InputManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InputManager.d.ts","sourceRoot":"","sources":["../../../src/api/input/InputManager.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,aAAa,EAEb,UAAU,EACV,eAAe,EAEf,sBAAsB,EACzB,MAAM,aAAa,CAAC;AAmCrB,qBAAa,YAAa,YAAW,aAAa;IAiC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IA/B9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAI/B;IAED,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAiB;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiB;IAC7C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAiB;IACtD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkC;IACnE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAkC;IAEvE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IACnD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAyB;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,eAAe,CAAS;IAChC,4FAA4F;IAC5F,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAK;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAK;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAK;IACvC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAK;IAC1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAA6C;IAE1F;;;OAGG;gBACiC,UAAU,EAAE,UAAU;IAkB1D,kBAAkB,SAAO;IAGzB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,YAAY;IAIpD,gBAAgB,IAAI,aAAa;IAIjC,kBAAkB;IACX,aAAa,IAAI,UAAU;IAIlC,kBAAkB;IACX,kBAAkB,IAAI,eAAe;IAI5C,kBAAkB;IACX,oBAAoB,IAAI,sBAAsB;IAIrD,kBAAkB;IACX,UAAU,IAAI,IAAI;IAOzB,OAAO,CAAC,kBAAkB;IA0C1B,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAG5B;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAG3B;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAE1B;IAEF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAE7B;IAEF,OAAO,CAAC,yBAAyB;IAMjC,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,SAAS;IAyBjB,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,0BAA0B;IASlC,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,wBAAwB;IAShC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAqCxB,OAAO,CAAC,eAAe;IAoCvB;;;OAGG;IACH,OAAO,CAAC,WAAW;IA+BnB,kBAAkB;IACX,MAAM,IAAI,IAAI;IAOrB,kBAAkB;IACX,WAAW,IAAI,IAAI;CAiB7B"}
+{"version":3,"file":"InputManager.d.ts","sourceRoot":"","sources":["../../../src/api/input/InputManager.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,aAAa,EAEb,UAAU,EACV,eAAe,EAEf,sBAAsB,EACzB,MAAM,aAAa,CAAC;AAmCrB,qBAAa,YAAa,YAAW,aAAa;IAmC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAjC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAI/B;IAED,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAiB;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiB;IAC7C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAiB;IACtD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkC;IACnE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAkC;IAEvE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IACnD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAyB;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,eAAe,CAAS;IAChC,uEAAuE;IACvE,OAAO,CAAC,UAAU,CAAyB;IAC3C,4FAA4F;IAC5F,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAK;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAK;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAK;IACvC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAK;IAC1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAA6C;IAE1F;;;OAGG;gBACiC,UAAU,EAAE,UAAU;IAkB1D,kBAAkB,SAAO;IAGzB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,YAAY;IAIpD,gBAAgB,IAAI,aAAa;IAIjC,kBAAkB;IACX,aAAa,IAAI,UAAU;IAIlC,kBAAkB;IACX,kBAAkB,IAAI,eAAe;IAI5C,kBAAkB;IACX,oBAAoB,IAAI,sBAAsB;IAIrD,uEAAuE;IAChE,OAAO,IAAI,IAAI;IAMtB,kBAAkB;IACX,UAAU,IAAI,IAAI;IAOzB,OAAO,CAAC,kBAAkB;IA0C1B,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAG5B;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAG3B;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAE1B;IAEF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAE7B;IAEF,OAAO,CAAC,yBAAyB;IAMjC,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,SAAS;IAyBjB,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,0BAA0B;IASlC,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,wBAAwB;IAShC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAqCxB,OAAO,CAAC,eAAe;IAoCvB;;;OAGG;IACH,OAAO,CAAC,WAAW;IA+BnB,kBAAkB;IACX,MAAM,IAAI,IAAI;IAOrB,kBAAkB;IACX,WAAW,IAAI,IAAI;CAiB7B"}

package/dist/api/lights/AmbientLight.d.ts

@@ -0,0 +1,35 @@
+import { Color } from "../data/Color.js";
+import type { Scene } from "../scene/Scene.js";
+/** The descriptor for an ambient light. All fields are optional. */
+export interface AmbientLightDescriptor {
+    /** The unique id. Assigned automatically when omitted. */
+    id?: number;
+    /** The optional name for a light. */
+    name?: string;
+    /** The light colour. Alpha is ignored. Defaults to black. */
+    color?: Color;
+    /** Multiplies the colour. Defaults to 1. */
+    intensity?: number;
+}
+/**
+ * The ambient light. Plain data: it has no GPU resources.
+ * Put it into a {@link LightsBuffer} to use it in shaders.
+ * @public
+ */
+export declare class AmbientLight {
+    /**
+     * The constructor.
+     * @param descriptor The optional descriptor. The colour is copied.
+     * @param scene The optional scene to register with.
+     */
+    constructor(descriptor?: AmbientLightDescriptor, scene?: Scene);
+    /** The unique id of this light. */
+    readonly id: number;
+    /** The optional name for a light. */
+    name?: string;
+    /** The light color. Alpha is ignored. */
+    color: Color;
+    /** Multiplies {@link color} when written to the lights buffer. */
+    intensity: number;
+}
+//# sourceMappingURL=AmbientLight.d.ts.map

package/dist/api/lights/AmbientLight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AmbientLight.d.ts","sourceRoot":"","sources":["../../../src/api/lights/AmbientLight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAC;AAEvC,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,mBAAmB,CAAC;AAE7C,oEAAoE;AACpE,MAAM,WAAW,sBAAsB;IACnC,0DAA0D;IAC1D,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,6DAA6D;IAC7D,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,YAAY;IAErB;;;;OAIG;gBACgB,UAAU,CAAC,EAAE,sBAAsB,EAAE,KAAK,CAAC,EAAE,KAAK;IAUrE,mCAAmC;IACnC,SAAgB,EAAE,EAAE,MAAM,CAAC;IAE3B,qCAAqC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IAErB,yCAAyC;IAClC,KAAK,EAAE,KAAK,CAAC;IAEpB,kEAAkE;IAC3D,SAAS,EAAE,MAAM,CAAC;CAC5B"}

package/dist/api/lights/DirectionalLight.d.ts

@@ -0,0 +1,40 @@
+import { vec3 } from "gl-matrix";
+import { Color } from "../data/Color.js";
+import type { Scene } from "../scene/Scene.js";
+/** The descriptor for a directional light. All fields are optional. */
+export interface DirectionalLightDescriptor {
+    /** The unique id. Assigned automatically when omitted. */
+    id?: number;
+    /** The optional name for a light. */
+    name?: string;
+    /** The light colour. Alpha is ignored. Defaults to white. */
+    color?: Color;
+    /** Multiplies the colour. Defaults to 1. */
+    intensity?: number;
+    /** The direction in which the light travels. Defaults to straight down, (0, -1, 0). */
+    direction?: vec3;
+}
+/**
+ * The directional light. Plain data: it has no GPU resources.
+ * @public
+ */
+export declare class DirectionalLight {
+    /**
+     * The constructor.
+     * @param descriptor The optional descriptor. Colour and direction are copied.
+     * @param scene The optional scene; the light adds itself via {@link Scene.add}.
+     * @throws Error when the scene has no free directional light slot left (the light is then not in the scene).
+     */
+    constructor(descriptor?: DirectionalLightDescriptor, scene?: Scene);
+    /** The unique id of this light. */
+    readonly id: number;
+    /** The optional name for a light. */
+    name?: string;
+    /** The light colour. Alpha is ignored. */
+    color: Color;
+    /** Multiplies {@link color} when written to the lights buffer. */
+    intensity: number;
+    /** The direction in which the light travels. */
+    direction: vec3;
+}
+//# sourceMappingURL=DirectionalLight.d.ts.map

package/dist/api/lights/DirectionalLight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirectionalLight.d.ts","sourceRoot":"","sources":["../../../src/api/lights/DirectionalLight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAC;AAEvC,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,mBAAmB,CAAC;AAE7C,uEAAuE;AACvE,MAAM,WAAW,0BAA0B;IACvC,0DAA0D;IAC1D,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,6DAA6D;IAC7D,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,uFAAuF;IACvF,SAAS,CAAC,EAAE,IAAI,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAEzB;;;;;OAKG;gBACgB,UAAU,CAAC,EAAE,0BAA0B,EAAE,KAAK,CAAC,EAAE,KAAK;IAUzE,mCAAmC;IACnC,SAAgB,EAAE,EAAE,MAAM,CAAC;IAE3B,qCAAqC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IAErB,0CAA0C;IACnC,KAAK,EAAE,KAAK,CAAC;IAEpB,kEAAkE;IAC3D,SAAS,EAAE,MAAM,CAAC;IAEzB,gDAAgD;IACzC,SAAS,EAAE,IAAI,CAAC;CAC1B"}

package/dist/api/lights/LightFactory.d.ts

@@ -0,0 +1,18 @@
+import type { AmbientLight, AmbientLightDescriptor } from "./AmbientLight.js";
+import type { Scene } from "../scene/Scene.js";
+import type { LightsBuffer, LightsBufferDescriptor } from "./LightsBuffer.js";
+/** The light factory */
+export interface AmbientLightFactory {
+    /**
+     * Creates the ambient light.
+     * @param desc The descriptor for ambient light. The colour defaults to a dim grey; the id is assigned automatically.
+     * @param scene The optional scene to register the light with.
+     */
+    createAmbientLight(desc?: AmbientLightDescriptor, scene?: Scene): AmbientLight;
+    /**
+     * Creates a lights buffer, which owns the uniform buffer with all lights for shaders.
+     * @param desc The optional descriptor with the initial lights and directional light count.
+     */
+    __createLightsBuffer(desc?: LightsBufferDescriptor): LightsBuffer;
+}
+//# sourceMappingURL=LightFactory.d.ts.map

package/dist/api/lights/LightFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LightFactory.d.ts","sourceRoot":"","sources":["../../../src/api/lights/LightFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAE,sBAAsB,EAAC,MAAM,mBAAmB,CAAC;AAC5E,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAC,YAAY,EAAE,sBAAsB,EAAC,MAAM,mBAAmB,CAAC;AAE5E,wBAAwB;AACxB,MAAM,WAAW,mBAAmB;IAEhC;;;;OAIG;IACH,kBAAkB,CAAC,IAAI,CAAC,EAAE,sBAAsB,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,YAAY,CAAC;IAE/E;;;OAGG;IACH,oBAAoB,CAAC,IAAI,CAAC,EAAE,sBAAsB,GAAG,YAAY,CAAC;CAErE"}

package/dist/api/lights/LightId.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns a new unique light id. Light constructors call this when no id is given.
+ * @internal
+ */
+export declare function createLightId(): number;
+//# sourceMappingURL=LightId.d.ts.map

package/dist/api/lights/LightId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LightId.d.ts","sourceRoot":"","sources":["../../../src/api/lights/LightId.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/api/lights/LightsBuffer.d.ts

@@ -0,0 +1,77 @@
+import type { AmbientLight } from "./AmbientLight.js";
+import type { DirectionalLight } from "./DirectionalLight.js";
+import type { PointLight } from "./PointLight.js";
+import type { IUniformBuffer } from "../rendering/buffers/IUniformBuffer.js";
+import type { IDisposable } from "../core/IDisposable.js";
+/** The number of directional lights the lights buffer and the Blinn-Phong shader hold by default. */
+export declare const DEFAULT_DIRECTIONAL_LIGHTS_COUNT = 3;
+/** The number of point lights the lights buffer and the Blinn-Phong shader hold by default. */
+export declare const DEFAULT_POINT_LIGHTS_COUNT = 3;
+/** The descriptor for a lights buffer. */
+export interface LightsBufferDescriptor {
+    /** The ambient light. Defaults to a black ambient light. */
+    ambientLight?: AmbientLight;
+    /** The initial directional lights. More than {@link maxDirectionalLights} throws. */
+    directionalLights?: DirectionalLight[];
+    /**
+     * The number of directional light slots. Must match `DIRECTIONAL_LIGHTS_COUNT` in the shader.
+     * Defaults to {@link DEFAULT_DIRECTIONAL_LIGHTS_COUNT}.
+     */
+    maxDirectionalLights?: number;
+    /** The initial point lights. More than {@link maxPointLights} throws. */
+    pointLights?: PointLight[];
+    /**
+     * The number of point light slots. Must match `POINT_LIGHTS_COUNT` in the shader.
+     * Defaults to {@link DEFAULT_POINT_LIGHTS_COUNT}.
+     */
+    maxPointLights?: number;
+}
+/**
+ * Holds lights and owns the uniform buffer that shaders read them from.
+ * Each lit material (`ForwardBlinnPhongMaterial`) owns one.
+ *
+ *
+ * std140 layout of the `LightsBuffer` block:
+ * Every light colour is written premultiplied by its intensity, so the layout has no intensity field.
+ * - `vec3 u_ambientLight` at offset 0, padded to 16 bytes.
+ * - `DirectionalLight u_directionalLight[N]` from offset 16, 32 bytes each:
+ *   `vec3 light` at +0 and `vec3 direction` at +16.
+ * - `PointLight u_pointLight[M]` after the directional lights, 48 bytes each:
+ *   `vec3 light` at +0, `float constant` at +12, `vec3 position` at +16, `float linear` at +28, `float quadratic` at +32.
+ */
+export interface LightsBuffer extends IDisposable {
+    /** The ambient light written to the buffer. */
+    ambientLight: AmbientLight;
+    /**
+     * The directional lights written to the buffer. Can be replaced by another list, which is then used by reference
+     * (a lit material uses the scene's list). Only the first {@link maxDirectionalLights} are written; unused slots are black.
+     */
+    directionalLights: DirectionalLight[];
+    /** The number of directional light slots in the buffer. */
+    readonly maxDirectionalLights: number;
+    /**
+     * The point lights written to the buffer. Can be replaced by another list, which is then used by reference.
+     * Only the first {@link maxPointLights} are written; unused slots are black.
+     */
+    pointLights: PointLight[];
+    /** The number of point light slots in the buffer. */
+    readonly maxPointLights: number;
+    /**
+     * The uniform buffer holding the lights for shaders.
+     * NOTE: Intended to be used internally, never set this value manually.
+     */
+    readonly buffer: IUniformBuffer;
+    /**
+     * Adds a directional or point light. Adding a light that is already in the buffer does nothing.
+     * @throws Error when all slots for that kind of light are in use.
+     */
+    add(light: DirectionalLight | PointLight): void;
+    /**
+     * Removes a directional or point light.
+     * @returns True when the light was in the buffer.
+     */
+    remove(light: DirectionalLight | PointLight): boolean;
+    /** Writes the lights to {@link buffer} if anything changed since the last update. Call once per frame before rendering. */
+    update(): void;
+}
+//# sourceMappingURL=LightsBuffer.d.ts.map

package/dist/api/lights/LightsBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LightsBuffer.d.ts","sourceRoot":"","sources":["../../../src/api/lights/LightsBuffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,wCAAwC,CAAC;AAC3E,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,wBAAwB,CAAC;AAExD,qGAAqG;AACrG,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD,+FAA+F;AAC/F,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,0CAA0C;AAC1C,MAAM,WAAW,sBAAsB;IAEnC,4DAA4D;IAC5D,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B,qFAAqF;IACrF,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEvC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,yEAAyE;IACzE,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAE3B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,YAAa,SAAQ,WAAW;IAE7C,+CAA+C;IAC/C,YAAY,EAAE,YAAY,CAAC;IAE3B;;;OAGG;IACH,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IAEtC,2DAA2D;IAC3D,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IAEtC;;;OAGG;IACH,WAAW,EAAE,UAAU,EAAE,CAAC;IAE1B,qDAAqD;IACrD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEhC;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,GAAG,IAAI,CAAC;IAEhD;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,GAAG,OAAO,CAAC;IAEtD,2HAA2H;IAC3H,MAAM,IAAI,IAAI,CAAC;CAClB"}

package/dist/api/lights/PointLight.d.ts

@@ -0,0 +1,59 @@
+import { vec3 } from "gl-matrix";
+import { Color } from "../data/Color.js";
+import type { Scene } from "../scene/Scene.js";
+/** The descriptor for a point light. All fields are optional. */
+export interface PointLightDescriptor {
+    /** The unique id. Assigned automatically when omitted. */
+    id?: number;
+    /** The optional name for a light. */
+    name?: string;
+    /** The light colour. Alpha is ignored. Defaults to white. */
+    color?: Color;
+    /** Multiplies the colour. Defaults to 1. */
+    intensity?: number;
+    /** World-space position. Defaults to the origin. */
+    position?: vec3;
+    /** Constant attenuation term. Defaults to 1. */
+    constant?: number;
+    /** Linear attenuation term. Defaults to 0.09 (about 50 units of range). */
+    linear?: number;
+    /** Quadratic attenuation term. Defaults to 0.032 (about 50 units of range). */
+    quadratic?: number;
+}
+/**
+ * The point light. Plain data: it has no GPU resources.
+ * Attenuation is `1 / (constant + linear * d + quadratic * d²)` for distance `d`.
+ * @public
+ */
+export declare class PointLight {
+    /** The default constant attenuation. */
+    static readonly DEFAULT_CONSTANT = 1;
+    /** The default linear attenuation. */
+    static readonly DEFAULT_LINEAR = 0.09;
+    /** The default quadratic attenuation. */
+    static readonly DEFAULT_QUADRATIC = 0.032;
+    /**
+     * The constructor.
+     * @param descriptor The optional descriptor. Colour and position are copied.
+     * @param scene The optional scene; the light adds itself via {@link Scene.add}.
+     * @throws Error when the scene has no free point light slot left (the light is then not in the scene).
+     */
+    constructor(descriptor?: PointLightDescriptor, scene?: Scene);
+    /** The unique id of this light. */
+    readonly id: number;
+    /** The optional name for a light. */
+    name?: string;
+    /** The light colour. Alpha is ignored. */
+    color: Color;
+    /** Multiplies {@link color} when written to the lights buffer. */
+    intensity: number;
+    /** World-space position of the light. */
+    position: vec3;
+    /** Constant attenuation term. */
+    constant: number;
+    /** Linear attenuation term. */
+    linear: number;
+    /** Quadratic attenuation term. */
+    quadratic: number;
+}
+//# sourceMappingURL=PointLight.d.ts.map

package/dist/api/lights/PointLight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointLight.d.ts","sourceRoot":"","sources":["../../../src/api/lights/PointLight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAC;AAEvC,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,mBAAmB,CAAC;AAE7C,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACjC,0DAA0D;IAC1D,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,6DAA6D;IAC7D,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,IAAI,CAAC;IAEhB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,UAAU;IAEnB,wCAAwC;IACxC,gBAAuB,gBAAgB,KAAK;IAE5C,sCAAsC;IACtC,gBAAuB,cAAc,QAAQ;IAE7C,yCAAyC;IACzC,gBAAuB,iBAAiB,SAAS;IAEjD;;;;;OAKG;gBACgB,UAAU,CAAC,EAAE,oBAAoB,EAAE,KAAK,CAAC,EAAE,KAAK;IAanE,mCAAmC;IACnC,SAAgB,EAAE,EAAE,MAAM,CAAC;IAE3B,qCAAqC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IAErB,0CAA0C;IACnC,KAAK,EAAE,KAAK,CAAC;IAEpB,kEAAkE;IAC3D,SAAS,EAAE,MAAM,CAAC;IAEzB,yCAAyC;IAClC,QAAQ,EAAE,IAAI,CAAC;IAEtB,iCAAiC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IAExB,+BAA+B;IACxB,MAAM,EAAE,MAAM,CAAC;IAEtB,kCAAkC;IAC3B,SAAS,EAAE,MAAM,CAAC;CAC5B"}

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

@@ -0,0 +1,6 @@
+export * from "./AmbientLight.js";
+export * from "./DirectionalLight.js";
+export * from "./PointLight.js";
+export * from "./LightsBuffer.js";
+export * from "./LightFactory.js";
+//# sourceMappingURL=_export.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_export.d.ts","sourceRoot":"","sources":["../../../src/api/lights/_export.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,19 @@
+import type { GeometryDescriptor } from "../geometry/IGeometryBuilder.js";
+import type { ObjGeometryDefinition } from "./obj/index.js";
+/**
+ * Maps plain OBJ geometry definitions from {@link ObjParser} onto the framework's {@link GeometryDescriptor}.
+ * Pass the result to `geometryBuilder.create`.
+ * Not part of the public API: `content.loadMeshAsync` and `content.loadBlinnPhongMeshAsync` use it.
+ * @internal
+ */
+export declare class ObjGeometryMapper {
+    /**
+     * Creates a geometry descriptor from an OBJ geometry definition.
+     * @param definition The geometry definition, e.g. `result.geometry` from `ObjParser.loadAsync`.
+     * @param useMaterialColors True keeps the loader's per-vertex `Kd` colours; false (the default) uses white,
+     * for when each submesh's material carries the colour instead.
+     * @returns The descriptor. It references the definition's arrays; `geometryBuilder.create` copies them.
+     */
+    static toDescriptor(definition: ObjGeometryDefinition, useMaterialColors?: boolean): GeometryDescriptor;
+}
+//# sourceMappingURL=ObjGeometryMapper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ObjGeometryMapper.d.ts","sourceRoot":"","sources":["../../../src/api/loaders/ObjGeometryMapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,gBAAgB,CAAC;AAE1D;;;;;GAKG;AACH,qBAAa,iBAAiB;IAE1B;;;;;;OAMG;WACW,YAAY,CAAC,UAAU,EAAE,qBAAqB,EAAE,iBAAiB,UAAQ,GAAG,kBAAkB;CAS/G"}

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

@@ -0,0 +1,61 @@
+import type { IFramework } from "../IFramework.js";
+import type { IRenderableMesh } from "../meshes/IRenderableMesh.js";
+import type { IMaterial } from "../material/IMaterial.js";
+import { ForwardBlinnPhongMaterialDescriptor } from "../material/ForwardBlinnPhongMaterial.js";
+import type { ObjLoadOptions, ObjModel, ObjSubMesh } from "./obj/ObjTypes.js";
+/** Creates the material for one OBJ sub mesh (`usemtl` range). */
+export type ObjMaterialFactory = (subMesh: ObjSubMesh) => IMaterial;
+/**
+ * Loads OBJ (Wavefront) models into renderable meshes (C# `ObjLoader`). Available as `framework.objLoader`.
+ *
+ * The returned root mesh has no material and owns the vertex and index buffers; each `usemtl` range is a sub mesh
+ * with its own material (ranges with the same material name share one material instance).
+ * Vertex colours are white, the materials carry the colour. Parsing is done by the engine-independent {@link ObjParser}.
+ * @public
+ */
+export declare class ObjLoader {
+    private readonly _framework;
+    /** Default specular colour when the .mtl has no `Ks` (0.5 grey). */
+    static readonly DEFAULT_SPECULAR = 0.5;
+    /** Default shininess when the .mtl has no `Ns`. */
+    static readonly DEFAULT_SHININESS = 32;
+    /**
+     * The constructor.
+     * @param _framework The framework.
+     */
+    constructor(_framework: IFramework);
+    /**
+     * Parses an .obj file (and its .mtl files) into plain data. Creates no GPU resources (C# `ObjLoader.Parse`).
+     * @param path The .obj URL.
+     * @param options Optional: how to resolve `mtllib` names, or skip materials.
+     * @returns The model.
+     */
+    static parseAsync(path: string, options?: ObjLoadOptions): Promise<ObjModel>;
+    /**
+     * Loads an .obj file into a renderable mesh with one Blinn-Phong material per `usemtl` range.
+     * The .mtl values map onto `ForwardBlinnPhongMaterial`: `Kd` (with `d` as alpha) → diffuse colour (white when missing),
+     * `Ka` → ambient colour (falls back to `Kd`), `Ks` → specular colour (0.5 grey), `Ns` → shininess (32).
+     * @param path The .obj URL. A relative `mtllib` is resolved against it.
+     * @param descriptor The descriptor every material is created with (camera buffers, primitive state).
+     * @param options Optional parser options.
+     * @returns The root mesh.
+     */
+    loadAsync(path: string, descriptor: ForwardBlinnPhongMaterialDescriptor, options?: ObjLoadOptions): Promise<IRenderableMesh>;
+    /**
+     * Loads an .obj file into a renderable mesh, creating each sub mesh's material with a callback.
+     * @param path The .obj URL.
+     * @param createMaterial Called once per distinct `usemtl` name.
+     * @param options Optional parser options.
+     * @returns The root mesh.
+     */
+    loadAsync(path: string, createMaterial: ObjMaterialFactory, options?: ObjLoadOptions): Promise<IRenderableMesh>;
+    /**
+     * Creates a renderable mesh from a parsed model.
+     * @param model The model, e.g. from {@link parseAsync}.
+     * @param createMaterial Creates the material per distinct `usemtl` name.
+     * @returns The root mesh, without a material, with one sub mesh per range.
+     */
+    createMesh(model: ObjModel, createMaterial: ObjMaterialFactory): IRenderableMesh;
+    private _blinnPhongFactory;
+}
+//# sourceMappingURL=ObjLoader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ObjLoader.d.ts","sourceRoot":"","sources":["../../../src/api/loaders/ObjLoader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAElE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAC,mCAAmC,EAAC,MAAM,0CAA0C,CAAC;AAG7F,OAAO,KAAK,EAAC,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAG5E,kEAAkE;AAClE,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,UAAU,KAAK,SAAS,CAAC;AAEpE;;;;;;;GAOG;AACH,qBAAa,SAAS;IAYC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAV9C,oEAAoE;IACpE,gBAAuB,gBAAgB,OAAO;IAE9C,mDAAmD;IACnD,gBAAuB,iBAAiB,MAAM;IAE9C;;;OAGG;gBACiC,UAAU,EAAE,UAAU;IAG1D;;;;;OAKG;WACW,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAInF;;;;;;;;OAQG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,mCAAmC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAEnI;;;;;;OAMG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAatH;;;;;OAKG;IACI,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,kBAAkB,GAAG,eAAe;IAyBvF,OAAO,CAAC,kBAAkB;CAiB7B"}

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

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

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

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