ris-framework 0.1.0-dev.9 → 0.2.0-dev.11

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,70 @@
+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 the lights of a scene and owns the uniform buffer that shaders read them from.
+ * Assign it to lit materials, e.g. `ForwardBlinnPhongMaterial.lightsBuffer`.
+ *
+ * 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. Read-only; use {@link add} and {@link remove}. Unused slots are black. */
+    readonly directionalLights: readonly DirectionalLight[];
+    /** The number of directional light slots in the buffer. */
+    readonly maxDirectionalLights: number;
+    /** The point lights written to the buffer. Read-only; use {@link add} and {@link remove}. Unused slots are black. */
+    readonly pointLights: readonly 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;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAa,SAAQ,WAAW;IAE7C,+CAA+C;IAC/C,YAAY,EAAE,YAAY,CAAC;IAE3B,2HAA2H;IAC3H,QAAQ,CAAC,iBAAiB,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAExD,2DAA2D;IAC3D,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IAEtC,qHAAqH;IACrH,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAE5C,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 ObjLoader} 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 `ObjLoader.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/_export.d.ts

@@ -1,3 +1,4 @@
 export * from "./IImageLoader.js";
 export * from "./ImageLoader.js";
+export * from "./obj/index.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"}

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

@@ -0,0 +1,29 @@
+import { ObjMaterialDefinition, type ObjLoadResult, type ObjLoadOptions } from "./ObjTypes.js";
+/**
+ * Loads .obj models (and their .mtl materials) from text or a URL into plain data.
+ * Engine-independent; uses only `fetch` and `URL`. `content.loadMeshAsync` turns the result into a framework mesh.
+ */
+export declare class ObjLoader {
+    /**
+     * Parses .mtl text.
+     * @param text The .mtl contents.
+     * @returns The material definitions, in file order.
+     */
+    parseMtl(text: string): ObjMaterialDefinition[];
+    /**
+     * Parses .obj text.
+     * @param text The .obj contents.
+     * @param materials Material definitions to use for `usemtl`, e.g. from {@link parseMtl}. Default none.
+     * @returns The geometry, materials and raw data.
+     */
+    fromText(text: string, materials?: ObjMaterialDefinition[]): ObjLoadResult;
+    /**
+     * Loads an .obj file and the .mtl files it references with `mtllib`.
+     * A missing or failing .mtl is skipped (logged as a warning); the model still loads with white vertex colours.
+     * @param filePath The .obj URL.
+     * @param options Optional: how to resolve `mtllib` names, or skip materials.
+     * @returns The geometry, materials and raw data.
+     */
+    loadAsync(filePath: string, options?: ObjLoadOptions): Promise<ObjLoadResult>;
+}
+//# sourceMappingURL=ObjLoader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ObjLoader.d.ts","sourceRoot":"","sources":["../../../../src/api/loaders/obj/ObjLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,qBAAqB,EAErB,KAAK,aAAa,EAClB,KAAK,cAAc,EAEtB,MAAM,eAAe,CAAC;AAiBvB;;;GAGG;AACH,qBAAa,SAAS;IAElB;;;;OAIG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAqEtD;;;;;OAKG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,qBAAqB,EAAO,GAAG,aAAa;IAiHrF;;;;;;OAMG;IACU,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAwC7F"}

package/dist/api/loaders/obj/ObjTypes.d.ts

@@ -0,0 +1,103 @@
+/** An RGB colour as read from an .mtl file, each channel usually in 0..1. */
+export type ObjColor = [r: number, g: number, b: number];
+/**
+ * A material definition read from an .mtl file (`newmtl` block).
+ * This is plain data, not a GPU material; map it onto a framework material yourself.
+ */
+export declare class ObjMaterialDefinition {
+    name: string;
+    /**
+     * The constructor.
+     * @param name The material name from `newmtl`.
+     */
+    constructor(name: string);
+    /** Ambient colour (`Ka`). */
+    ambientColor?: ObjColor;
+    /** Diffuse colour (`Kd`). */
+    diffuseColor?: ObjColor;
+    /** Specular colour (`Ks`). */
+    specularColor?: ObjColor;
+    /** Emissive colour (`Ke`). */
+    emissiveColor?: ObjColor;
+    /** Specular exponent (`Ns`). */
+    specularExponent?: number;
+    /** Opacity, from `d`, or `1 - Tr` when only `Tr` is given. */
+    opacity?: number;
+    /** Optical density / index of refraction (`Ni`). */
+    opticalDensity?: number;
+    /** Illumination model (`illum`). */
+    illuminationModel?: number;
+    /**
+     * Texture maps by statement name, e.g. `map_Kd`, `map_Ks`, `map_Bump`, `bump`, `disp`, `decal`, `refl`.
+     * The value is the file name (last token); map options such as `-bm 1` are kept in {@link mapOptions}.
+     */
+    maps: Record<string, string>;
+    /** Options written before the file name of a map statement, e.g. `{ map_Bump: "-bm 0.5" }`. */
+    mapOptions: Record<string, string>;
+}
+/** A run of triangles in the geometry's index buffer drawn with one material (`usemtl`). */
+export interface ObjMaterialRange {
+    /** The material name from `usemtl`, or undefined for faces before any `usemtl`. */
+    readonly materialName?: string;
+    /** First index in `geometry.indices`. */
+    readonly indexStart: number;
+    /** Number of indices (3 per triangle). */
+    readonly indexCount: number;
+}
+/** The OBJ data exactly as listed in the file, before expansion. */
+export interface ObjRawData {
+    /** `v` values, 3 per position. */
+    readonly positions: number[];
+    /** `vt` values, 2 per texture coordinate (a third `w` value is dropped). */
+    readonly textureCoords: number[];
+    /** `vn` values, 3 per normal. */
+    readonly normals: number[];
+    /**
+     * Triangulated face corners as zero-based `position, texcoord, normal` triplets.
+     * A missing texcoord or normal is -1.
+     */
+    readonly faceIndices: number[];
+}
+/**
+ * Renderable geometry as plain data: one vertex per unique position/texcoord/normal/material corner.
+ * Has no dependency on any engine; convert it to engine geometry yourself.
+ */
+export interface ObjGeometryDefinition {
+    /** Positions, 3 per vertex. */
+    readonly positions: number[];
+    /** Texture coordinates, 2 per vertex (0,0 when the corner has none). */
+    readonly textureCoords: number[];
+    /** Normals, 3 per vertex (0,0,0 when the corner has none). */
+    readonly normals: number[];
+    /** RGBA colours, 4 per vertex: the material's `Kd` with alpha from `d`, white without a material. */
+    readonly colors: number[];
+    /** Triangle indices, 3 per triangle. */
+    readonly indices: number[];
+    /** Number of vertices (`positions.length / 3`). */
+    readonly vertexCount: number;
+    /** Index ranges per `usemtl`, in file order. */
+    readonly materialRanges: ObjMaterialRange[];
+}
+/** The result of loading an OBJ file. */
+export interface ObjLoadResult {
+    /** The renderable geometry as plain data. */
+    readonly geometry: ObjGeometryDefinition;
+    /** Material definitions from the referenced .mtl files. Empty when there is no `mtllib` or it could not be loaded. */
+    readonly materials: ObjMaterialDefinition[];
+    /** Library file names from `mtllib`, in order. */
+    readonly materialLibraries: string[];
+    /** The raw OBJ lists. */
+    readonly raw: ObjRawData;
+}
+/** Options for {@link ObjLoader.loadAsync}. */
+export interface ObjLoadOptions {
+    /**
+     * Maps an `mtllib` name to the URL to fetch.
+     * By default, the name is resolved relative to the OBJ URL, which fails for `data:` or `blob:` URLs
+     * (for example a bundler-inlined asset); use this to point at the real file.
+     */
+    resolveMaterialUrl?: (libraryName: string) => string;
+    /** Skip fetching .mtl files. */
+    ignoreMaterials?: boolean;
+}
+//# sourceMappingURL=ObjTypes.d.ts.map

package/dist/api/loaders/obj/ObjTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjTypes.d.ts","sourceRoot":"","sources":["../../../../src/api/loaders/obj/ObjTypes.ts"],"names":[],"mappings":"AAKA,6EAA6E;AAC7E,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AAEzD;;;GAGG;AACH,qBAAa,qBAAqB;IAMJ,IAAI,EAAE,MAAM;IAJtC;;;OAGG;gBACuB,IAAI,EAAE,MAAM;IAGtC,6BAA6B;IACtB,YAAY,CAAC,EAAE,QAAQ,CAAC;IAE/B,6BAA6B;IACtB,YAAY,CAAC,EAAE,QAAQ,CAAC;IAE/B,8BAA8B;IACvB,aAAa,CAAC,EAAE,QAAQ,CAAC;IAEhC,8BAA8B;IACvB,aAAa,CAAC,EAAE,QAAQ,CAAC;IAEhC,gCAAgC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAEjC,8DAA8D;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IAExB,oDAAoD;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;IAE/B,oCAAoC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAElC;;;OAGG;IACI,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAEzC,+FAA+F;IACxF,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;CAClD;AAED,4FAA4F;AAC5F,MAAM,WAAW,gBAAgB;IAC7B,mFAAmF;IACnF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,yCAAyC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC/B;AAED,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACvB,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IACjC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,qGAAqG;IACrG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,cAAc,EAAE,gBAAgB,EAAE,CAAC;CAC/C;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,sHAAsH;IACtH,QAAQ,CAAC,SAAS,EAAE,qBAAqB,EAAE,CAAC;IAC5C,kDAAkD;IAClD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IACrC,yBAAyB;IACzB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;CAC5B;AAED,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC3B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;IACrD,gCAAgC;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B"}

package/dist/api/loaders/obj/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./ObjTypes.js";
+export * from "./ObjLoader.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/loaders/obj/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/loaders/obj/index.ts"],"names":[],"mappings":"AAGA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}