@woosh/meep-engine 2.107.0 → 2.108.0

package/src/core/graph/graph_k_means_cluster.js

@@ -1,122 +1,7 @@
 //
-import { seededRandom } from "../math/random/seededRandom.js";
-import { SquareMatrix } from "./SquareMatrix.js";
-import { BinaryDataType } from "../binary/type/BinaryDataType.js";
-import { BitSet } from "../binary/BitSet.js";
-import FastBinaryHeap from "../collection/heap/FastBinaryHeap.js";
 import { randomIntegerBetween } from "../math/random/randomIntegerBetween.js";
-
-/**
- * @template N
- * @param {N} n0
- * @param {N} n1
- * @param {Graph<N>} graph
- * @returns {number}
- */
-function node_distance(n0, n1, graph) {
-    const path = graph.findPath(n0, n1);
-
-    if (path === null) {
-        return Number.POSITIVE_INFINITY;
-    }
-
-    return path.length;
-}
-
-/**
- * Produce a distance matrix from an input graph, tracing distances from each node to every node specified in target vector
- * @see "A Fast Algorithm to Find All-Pairs Shortest Paths in Complex Networks" by Wei Peng et Al. 2012
- * @template T
- * @param {Graph<T>} graph
- * @param {T[]} node_array graph nodes as an array
- * @param {number[]} targets node indices, distances to which need to be calculated
- * @param {Map<T, number>} node_index_map
- * @returns {SquareMatrix}
- */
-function build_distance_matrix(graph, node_array, targets, node_index_map) {
-    const node_count = node_array.length;
-
-    const m_distances = new SquareMatrix(node_count, BinaryDataType.Float32);
-
-    const flags = BitSet.fixedSize(node_count);
-
-    // initialize distances
-    m_distances.fill(Number.POSITIVE_INFINITY);
-
-    let source_node;
-
-    /**
-     *
-     * @param {number} other_node
-     * @returns {number}
-     */
-    function score(other_node) {
-        return m_distances.getCellValue(source_node, other_node);
-    }
-
-    for (let i = 0; i < targets.length; i++) {
-        source_node = targets[i];
-
-        // distance to self is always 0
-        m_distances.setCellValue(source_node, source_node, 0);
-
-        const heap = new FastBinaryHeap(score);
-        heap.push(source_node);
-
-        while (!heap.isEmpty()) {
-            const t = heap.pop();
-
-            const distance_to_this_node = m_distances.getCellValue(source_node, t);
-            if (flags.get(t)) {
-                // already visited
-                for (let v = 0; v < node_count; v++) {
-                    const shortcut_distance = distance_to_this_node + m_distances.getCellValue(t, v);
-
-                    if (shortcut_distance < m_distances.getCellValue(source_node, v)) {
-                        m_distances.setCellValue(source_node, v, shortcut_distance)
-                    }
-
-                }
-            } else {
-                // not visited yet
-                const t_node = node_array[t];
-
-                const t_node_container = graph.getNodeContainer(t_node);
-
-                const node_edges = t_node_container.getEdges();
-                const node_edge_count = node_edges.length;
-
-                for (let i1 = 0; i1 < node_edge_count; i1++) {
-
-                    const node_edge = node_edges[i1];
-
-                    const neighbour_node = node_edge.other(t_node);
-
-                    const neighbour_node_index = node_index_map.get(neighbour_node);
-
-                    if (neighbour_node_index === -1) {
-                        // not in the input set
-                        continue;
-                    }
-
-                    const transition_cost = node_edge.weight + 1e-5;
-
-                    const distance_to_neighbour = distance_to_this_node + transition_cost;
-
-                    if (distance_to_neighbour < m_distances.getCellValue(source_node, neighbour_node_index)) {
-                        m_distances.setCellValue(source_node, neighbour_node_index, distance_to_neighbour);
-
-                        heap.push(neighbour_node_index);
-                    }
-                }
-            }
-        }
-
-        flags.set(source_node, true);
-    }
-
-    return m_distances;
-}
+import { seededRandom } from "../math/random/seededRandom.js";
+import { graph_compute_distance_matrix } from "./graph_compute_distance_matrix.js";
 
 
 /**
@@ -172,7 +57,7 @@ export function graph_k_means_cluster_detailed(
         clusters[i] = [node_index];
     }
 
-    const m_distances = build_distance_matrix(graph, node_array, clusters_seeds, node_index_map);
+    const m_distances = graph_compute_distance_matrix(graph, node_array, clusters_seeds, node_index_map);
 
     for (let node_index = 0; node_index < total_node_count; node_index++) {
 
@@ -218,7 +103,7 @@ export function graph_k_means_cluster(graph, k, random_seed) {
 
     /**
      *
-     * @type {number[]}
+     * @type {Uint8Array}
      */
     const node_cluster_assignments = new Uint8Array(node_count);
     // fill with "UNASSIGNED" value

package/src/core/graph/{coarsen_graph.d.ts → mn_graph_coarsen.d.ts}

@@ -5,5 +5,5 @@
  * @param {Graph<MultiNode<T>>} graph
  * @param {number} max_node_limit Maximum number of "source" nodes per joined node
  */
-export function coarsen_graph<T>(graph: Graph<MultiNode<T>>, max_node_limit: number): void;
-//# sourceMappingURL=coarsen_graph.d.ts.map
+export function mn_graph_coarsen<T>(graph: Graph<MultiNode<T>>, max_node_limit: number): void;
+//# sourceMappingURL=mn_graph_coarsen.d.ts.map

package/src/core/graph/mn_graph_coarsen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mn_graph_coarsen.d.ts","sourceRoot":"","sources":["../../../../src/core/graph/mn_graph_coarsen.js"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,gFAFW,MAAM,QAuBhB"}

package/src/core/graph/{coarsen_graph.js → mn_graph_coarsen.js}

@@ -9,7 +9,7 @@ import { WeightedEdge } from "./WeightedEdge.js";
  * @param {Graph<MultiNode<T>>} graph
  * @param {number} max_node_limit Maximum number of "source" nodes per joined node
  */
-export function coarsen_graph(graph, max_node_limit) {
+export function mn_graph_coarsen(graph, max_node_limit) {
 
     /**
      *

package/src/core/graph/mn_graph_coarsen.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mn_graph_coarsen.spec.d.ts.map

package/src/core/graph/mn_graph_coarsen.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mn_graph_coarsen.spec.d.ts","sourceRoot":"","sources":["../../../../src/core/graph/mn_graph_coarsen.spec.js"],"names":[],"mappings":""}

package/src/core/graph/{coarsen_graph.spec.js → mn_graph_coarsen.spec.js}

@@ -1,7 +1,7 @@
-import { Graph } from "./v2/Graph.js";
+import { mn_graph_coarsen } from "./mn_graph_coarsen.js";
 import { MultiNode } from "./MultiNode.js";
+import { Graph } from "./v2/Graph.js";
 import { WeightedEdge } from "./WeightedEdge.js";
-import { coarsen_graph } from "./coarsen_graph.js";
 
 test('coarsen 2 node graph with 1 edge', () => {
     const graph = new Graph();
@@ -13,7 +13,7 @@ test('coarsen 2 node graph with 1 edge', () => {
 
     graph.addEdge(new WeightedEdge(n0, n1));
 
-    coarsen_graph(graph, 2);
+    mn_graph_coarsen(graph, 2);
 });
 
 test('coarsen chain, all nodes must still be linked', () => {
@@ -37,7 +37,7 @@ test('coarsen chain, all nodes must still be linked', () => {
         g.addEdge(new WeightedEdge(n0, n1));
     }
 
-    coarsen_graph(g, 100);
+    mn_graph_coarsen(g, 100);
 
     expect(g.getNodeCount()).toBe(1);
 });

package/src/core/graph/mn_graph_collapse_weighted_edge.d.ts

@@ -1,4 +1,5 @@
 /**
+ * Multi-node graph function
  * @template N
  * @param {Graph<MultiNode<N>>} graph
  * @param {WeightedEdge<MultiNode<N>>} edge

package/src/core/graph/mn_graph_collapse_weighted_edge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mn_graph_collapse_weighted_edge.d.ts","sourceRoot":"","sources":["../../../../src/core/graph/mn_graph_collapse_weighted_edge.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,+HAJW,MAAM,2BAEJ,OAAO,CAoEnB"}
+{"version":3,"file":"mn_graph_collapse_weighted_edge.d.ts","sourceRoot":"","sources":["../../../../src/core/graph/mn_graph_collapse_weighted_edge.js"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,+HAJW,MAAM,2BAEJ,OAAO,CAyEnB"}

package/src/core/graph/mn_graph_collapse_weighted_edge.js

@@ -1,4 +1,5 @@
 /**
+ * Multi-node graph function
  * @template N
  * @param {Graph<MultiNode<N>>} graph
  * @param {WeightedEdge<MultiNode<N>>} edge
@@ -6,7 +7,12 @@
  * @param {BinaryHeap<Edge>} heap
  * @returns {boolean} whether collapse was performed or rejected
  */
-export function mn_graph_collapse_weighted_edge(graph, edge, source_limit, heap) {
+export function mn_graph_collapse_weighted_edge(
+    graph,
+    edge,
+    source_limit,
+    heap
+) {
 
     const successor_node = edge.first;
     const victim_node = edge.second;

package/src/core/math/physics/brdf/brdf_burley.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brdf_burley.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/brdf/brdf_burley.js"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;GAaG;AACH,iCANW,MAAM,OACN,MAAM,OACN,MAAM,aACN,MAAM,GACJ,MAAM,CASlB"}
+{"version":3,"file":"brdf_burley.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/brdf/brdf_burley.js"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;GAaG;AACH,iCANW,MAAM,OACN,MAAM,OACN,MAAM,aACN,MAAM,GACJ,MAAM,CASlB"}

package/src/core/math/physics/brdf/brdf_burley.js

@@ -1,8 +1,16 @@
 import { PI_RECIPROCAL } from "../../PI_RECIPROCAL.js";
+import { fresnel_Schlick } from "./fresnel_Schlick.js";
 
+/**
+ *
+ * @param {number} u
+ * @param {number} f0
+ * @param {number} f90
+ * @return {number}
+ */
 function F_Schlick(u, f0, f90) {
 
-    return f0 + (f90 - f0) * Math.pow(1.0 - u, 5.0);
+    return f0 + (f90 - f0) * fresnel_Schlick(u);
 }
 
 /**

package/src/core/math/physics/brdf/{D_GGX.d.ts → diffuse_GGX.d.ts}

@@ -5,5 +5,5 @@
  * @param {number} roughness
  * @returns {number}
  */
-export function D_GGX(NoH: number, roughness: number): number;
-//# sourceMappingURL=D_GGX.d.ts.map
+export function diffuse_GGX(NoH: number, roughness: number): number;
+//# sourceMappingURL=diffuse_GGX.d.ts.map

package/src/core/math/physics/brdf/diffuse_GGX.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diffuse_GGX.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/brdf/diffuse_GGX.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,iCAJW,MAAM,aACN,MAAM,GACJ,MAAM,CAQlB"}

package/src/core/math/physics/brdf/{D_GGX.js → diffuse_GGX.js}

@@ -7,7 +7,7 @@ import { PI_RECIPROCAL } from "../../PI_RECIPROCAL.js";
  * @param {number} roughness
  * @returns {number}
  */
-export function D_GGX(NoH, roughness) {
+export function diffuse_GGX(NoH, roughness) {
     const a = NoH * roughness;
 
     const k = roughness / (1 - NoH * NoH + a * a);

package/src/core/math/physics/brdf/fresnel_Schlick.d.ts

@@ -0,0 +1,3 @@
+export const fresnel_Schlick: typeof fresnel_Schlick_optimized;
+import { fresnel_Schlick_optimized } from "./fresnel_Schlick_optimized.js";
+//# sourceMappingURL=fresnel_Schlick.d.ts.map

package/src/core/math/physics/brdf/fresnel_Schlick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fresnel_Schlick.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/brdf/fresnel_Schlick.js"],"names":[],"mappings":"AAEA,+DAAyD;0CAFf,gCAAgC"}

package/src/core/math/physics/brdf/fresnel_Schlick.js

@@ -0,0 +1,3 @@
+import { fresnel_Schlick_optimized } from "./fresnel_Schlick_optimized.js";
+
+export const fresnel_Schlick = fresnel_Schlick_optimized;

package/src/core/math/physics/brdf/fresnel_Schlick_optimized.d.ts

@@ -0,0 +1,9 @@
+/**
+ *
+ * Optimized variant (presented by Epic at SIGGRAPH '13)
+ * https://cdn2.unrealengine.com/Resources/files/2013SiggraphPresentationsNotes-26915738.pdf
+ * @param {number} dotVH
+ * @return {number}
+ */
+export function fresnel_Schlick_optimized(dotVH: number): number;
+//# sourceMappingURL=fresnel_Schlick_optimized.d.ts.map

package/src/core/math/physics/brdf/fresnel_Schlick_optimized.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fresnel_Schlick_optimized.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/brdf/fresnel_Schlick_optimized.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,iDAHW,MAAM,GACL,MAAM,CAIjB"}

package/src/core/math/physics/brdf/fresnel_Schlick_optimized.js

@@ -0,0 +1,12 @@
+import { exp2 } from "../../exp2.js";
+
+/**
+ *
+ * Optimized variant (presented by Epic at SIGGRAPH '13)
+ * https://cdn2.unrealengine.com/Resources/files/2013SiggraphPresentationsNotes-26915738.pdf
+ * @param {number} dotVH
+ * @return {number}
+ */
+export function fresnel_Schlick_optimized(dotVH) {
+    return exp2((-5.55473 * dotVH - 6.98316) * dotVH);
+}

package/src/core/math/physics/brdf/fresnel_Schlick_original.d.ts

@@ -0,0 +1,9 @@
+/**
+ *
+ * Original approximation by Christophe Schlick '94
+ * NOTE: prefer to use {@link fresnel_Schlick_optimized} instead, this primarily exists for reference purposes
+ * @param dotVH
+ * @return {number}
+ */
+declare function fresnel_Schlick_original(dotVH: any): number;
+//# sourceMappingURL=fresnel_Schlick_original.d.ts.map

package/src/core/math/physics/brdf/fresnel_Schlick_original.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fresnel_Schlick_original.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/brdf/fresnel_Schlick_original.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,uDAFY,MAAM,CAIjB"}

package/src/core/math/physics/brdf/fresnel_Schlick_original.js

@@ -0,0 +1,10 @@
+/**
+ *
+ * Original approximation by Christophe Schlick '94
+ * NOTE: prefer to use {@link fresnel_Schlick_optimized} instead, this primarily exists for reference purposes
+ * @param dotVH
+ * @return {number}
+ */
+function fresnel_Schlick_original(dotVH) {
+    return Math.pow(1.0 - dotVH, 5.0)
+}

package/src/core/math/physics/bsdf/bsdf_schlick.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bsdf_schlick.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/bsdf/bsdf_schlick.js"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,iCALW,MAAM,OACN,MAAM,SACN,MAAM,GACJ,MAAM,CAalB"}
+{"version":3,"file":"bsdf_schlick.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/bsdf/bsdf_schlick.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,iCALW,MAAM,OACN,MAAM,SACN,MAAM,GACJ,MAAM,CAMlB"}

package/src/core/math/physics/bsdf/bsdf_schlick.js

@@ -1,5 +1,4 @@
-import { exp2 } from "../../exp2.js";
-
+import { fresnel_Schlick } from "../brdf/fresnel_Schlick.js";
 
 /**
  *
@@ -9,14 +8,7 @@ import { exp2 } from "../../exp2.js";
  * @returns {number}
  */
 export function bsdf_schlick(f0, f90, dotVH) {
+    const fresnel = fresnel_Schlick(dotVH);
 
-    // Original approximation by Christophe Schlick '94
-    // float fresnel = pow( 1.0 - dotVH, 5.0 );
-
-    // Optimized variant (presented by Epic at SIGGRAPH '13)
-    // https://cdn2.unrealengine.com/Resources/files/2013SiggraphPresentationsNotes-26915738.pdf
-
-    const fresnel = exp2(((-5.55473) * dotVH - 6.98316) * dotVH);
-
-    return ((f0 * (1.0 - fresnel)) + (f90 * fresnel));
+    return f0 * (1.0 - fresnel) + f90 * fresnel;
 }

package/src/core/math/physics/ior_to_reflectivity.d.ts

@@ -0,0 +1,7 @@
+/**
+ *
+ * @param {number} ior index of refraction
+ * @return {number}
+ */
+export function ior_to_reflectivity(ior: number): number;
+//# sourceMappingURL=ior_to_reflectivity.d.ts.map

package/src/core/math/physics/ior_to_reflectivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ior_to_reflectivity.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/physics/ior_to_reflectivity.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,yCAHW,MAAM,GACL,MAAM,CAIjB"}

package/src/core/math/physics/ior_to_reflectivity.js

@@ -0,0 +1,9 @@
+/**
+ *
+ * @param {number} ior index of refraction
+ * @return {number}
+ */
+export function ior_to_reflectivity(ior) {
+    return 2.5 * (ior - 1) / (ior + 1)
+}
+

package/src/core/math/physics/pdf/README.md

@@ -0,0 +1 @@
+Probability Distribution Functions

package/src/core/math/physics/pdf/pdf_GGX.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Returns the PDF for a particular GGX sample after reflecting the view vector
+ * about a microfacet normal (includes the Jacobian for going from half vector to lighting vector)
+ *
+ * N = surface normal
+ * L = light direction
+ * V = view direction
+ * H = normalize( V + L )
+ *
+ * @param {number} nDotH dot product of N and H
+ * @param {number} hDotV dot product of H and V
+ * @param {number} roughness
+ * @returns {number}
+ */
+export function pdf_GGX(nDotH: number, hDotV: number, roughness: number): number;
+//# sourceMappingURL=pdf_GGX.d.ts.map

package/src/core/math/physics/pdf/pdf_GGX.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf_GGX.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/pdf/pdf_GGX.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,+BALW,MAAM,SACN,MAAM,aACN,MAAM,GACJ,MAAM,CAYlB"}

package/src/core/math/physics/pdf/pdf_GGX.js

@@ -0,0 +1,25 @@
+/**
+ * Returns the PDF for a particular GGX sample after reflecting the view vector
+ * about a microfacet normal (includes the Jacobian for going from half vector to lighting vector)
+ *
+ * N = surface normal
+ * L = light direction
+ * V = view direction
+ * H = normalize( V + L )
+ *
+ * @param {number} nDotH dot product of N and H
+ * @param {number} hDotV dot product of H and V
+ * @param {number} roughness
+ * @returns {number}
+ */
+export function pdf_GGX(nDotH, hDotV, roughness) {
+    const m2 = roughness * roughness;
+
+    const X = nDotH * nDotH * (m2 - 1) + 1;
+
+    const d = m2 / (Math.PI * X * X);
+
+    const pM = d * nDotH;
+
+    return pM / (4 * hDotV);
+}

package/src/core/math/physics/reflectivity_to_ior.d.ts

@@ -0,0 +1,7 @@
+/**
+ *
+ * @param {number} reflectivity
+ * @return {number} index of refraction (IOR)
+ */
+export function reflectivity_to_ior(reflectivity: number): number;
+//# sourceMappingURL=reflectivity_to_ior.d.ts.map

package/src/core/math/physics/reflectivity_to_ior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflectivity_to_ior.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/physics/reflectivity_to_ior.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,kDAHW,MAAM,GACL,MAAM,CAIjB"}

package/src/core/math/physics/reflectivity_to_ior.js

@@ -0,0 +1,8 @@
+/**
+ *
+ * @param {number} reflectivity
+ * @return {number} index of refraction (IOR)
+ */
+export function reflectivity_to_ior(reflectivity) {
+    return (1 + 0.4 * reflectivity) / (1 - 0.4 * reflectivity)
+}

package/src/engine/EngineHarness.d.ts

@@ -58,12 +58,20 @@ export class EngineHarness {
      * @param {EntityComponentDataset} [param.ecd]
      * @param {number} [param.shadowmapResolution]
      * @param {boolean} [param.castShadow]
+     * @param {Color} [param.sun]
+     * @param {number} [param.sunIntensity]
+     * @param {Color} [param.ambient]
+     * @param {number} [param.ambientIntensity]
      */
-    static buildLights({ engine, ecd, shadowmapResolution, castShadow }: {
+    static buildLights({ engine, ecd, shadowmapResolution, castShadow, sun, sunIntensity, sunDirection, ambient, ambientIntensity }: {
         engine: Engine;
         ecd?: EntityComponentDataset;
         shadowmapResolution?: number;
         castShadow?: boolean;
+        sun?: Color;
+        sunIntensity?: number;
+        ambient?: Color;
+        ambientIntensity?: number;
     }): Promise<void>;
     /**
      * @param {Object} param
@@ -120,5 +128,6 @@ import Engine from "./Engine.js";
 import { EngineConfiguration } from "./EngineConfiguration.js";
 import Vector3 from "../core/geom/Vector3.js";
 import Entity from "./ecs/Entity.js";
+import { Color } from "../core/color/Color.js";
 import Terrain from "./ecs/terrain/ecs/Terrain.js";
 //# sourceMappingURL=EngineHarness.d.ts.map

package/src/engine/EngineHarness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EngineHarness.d.ts","sourceRoot":"","sources":["../../../src/engine/EngineHarness.js"],"names":[],"mappings":"AAsDA;IAmBI;;;OAGG;IACH,6BAFW,MAAM,QAYhB;IAkED;;;;;;;;;;;;;OAaG;IACH;QAZyB,MAAM,EAApB,MAAM;QACyB,GAAG;QAClB,MAAM,GAAtB,OAAO;QACQ,QAAQ,GAAvB,MAAM;QACS,KAAK,GAApB,MAAM;QACS,GAAG,GAAlB,MAAM;QACU,QAAQ,GAAxB,OAAO;QACQ,WAAW,GAA1B,MAAM;QACS,WAAW,GAA1B,MAAM;QACS,WAAW,GAA1B,MAAM;QACJ,MAAM,CA+DlB;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,oQAnBW,MAAM,iBAmFhB;IAGD;;;;;;OAMG;IACH;QALyB,MAAM,EAApB,MAAM;QACyB,GAAG;QACnB,mBAAmB,GAAlC,MAAM;QACU,UAAU,GAA1B,OAAO;sBAqDjB;IAED;;;;;;;OAOG;IACH;QAN0B,YAAY,GAA3B,MAAM;QACQ,MAAM,EAApB,MAAM;QACS,WAAW,GAA1B,MAAM;QACyB,GAAG;QAChC,MAAM,CA2ClB;IAGD;;;;;;;;;;;OAWG;IACH,mGAVW,MAAM,GAQJ,OAAO,CAuDnB;IAvbG;;;OAGG;IACH,QAFU,MAAM,CAEiC;IAMjD;;;OAGG;IACH,YAFU,eAAQ,IAAI,CAET;IAmBjB;;;;OAIG;IACH,8DAJmB,mBAAmB,UAAQ,MAAM,WAEvC,QAAQ,MAAM,CAAC,CA2D3B;CAyVJ;;IAID;;;OAGG;IACH,uCAMC;;mBAhfkB,aAAa;oCACI,0BAA0B;oBAX1C,yBAAyB;mBAK1B,iBAAiB;oBAEhB,8BAA8B"}
+{"version":3,"file":"EngineHarness.d.ts","sourceRoot":"","sources":["../../../src/engine/EngineHarness.js"],"names":[],"mappings":"AAuDA;IAmBI;;;OAGG;IACH,6BAFW,MAAM,QAYhB;IAkED;;;;;;;;;;;;;OAaG;IACH;QAZyB,MAAM,EAApB,MAAM;QACyB,GAAG;QAClB,MAAM,GAAtB,OAAO;QACQ,QAAQ,GAAvB,MAAM;QACS,KAAK,GAApB,MAAM;QACS,GAAG,GAAlB,MAAM;QACU,QAAQ,GAAxB,OAAO;QACQ,WAAW,GAA1B,MAAM;QACS,WAAW,GAA1B,MAAM;QACS,WAAW,GAA1B,MAAM;QACJ,MAAM,CA+DlB;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,oQAnBW,MAAM,iBAmFhB;IAGD;;;;;;;;;;OAUG;IACH;QATyB,MAAM,EAApB,MAAM;QACyB,GAAG;QACnB,mBAAmB,GAAlC,MAAM;QACU,UAAU,GAA1B,OAAO;QACO,GAAG,GAAjB,KAAK;QACU,YAAY,GAA3B,MAAM;QACQ,OAAO,GAArB,KAAK;QACU,gBAAgB,GAA/B,MAAM;sBAqDhB;IAED;;;;;;;OAOG;IACH;QAN0B,YAAY,GAA3B,MAAM;QACQ,MAAM,EAApB,MAAM;QACS,WAAW,GAA1B,MAAM;QACyB,GAAG;QAChC,MAAM,CA2ClB;IAGD;;;;;;;;;;;OAWG;IACH,mGAVW,MAAM,GAQJ,OAAO,CAuDnB;IA3bG;;;OAGG;IACH,QAFU,MAAM,CAEiC;IAMjD;;;OAGG;IACH,YAFU,eAAQ,IAAI,CAET;IAmBjB;;;;OAIG;IACH,8DAJmB,mBAAmB,UAAQ,MAAM,WAEvC,QAAQ,MAAM,CAAC,CA2D3B;CA6VJ;;IAID;;;OAGG;IACH,uCAMC;;mBApfkB,aAAa;oCACI,0BAA0B;oBAX1C,yBAAyB;mBAK1B,iBAAiB;sBATd,wBAAwB;oBAW1B,8BAA8B"}

package/src/engine/EngineHarness.js

@@ -1,4 +1,5 @@
 import Stats from "three/examples/jsm/libs/stats.module.js";
+import { Color } from "../core/color/Color.js";
 
 import { noop } from "../core/function/noop.js";
 import Vector2 from "../core/geom/Vector2.js";
@@ -322,12 +323,21 @@ export class EngineHarness {
      * @param {EntityComponentDataset} [param.ecd]
      * @param {number} [param.shadowmapResolution]
      * @param {boolean} [param.castShadow]
+     * @param {Color} [param.sun]
+     * @param {number} [param.sunIntensity]
+     * @param {Color} [param.ambient]
+     * @param {number} [param.ambientIntensity]
      */
     static async buildLights({
                                  engine,
                                  ecd = engine.entityManager.dataset,
                                  shadowmapResolution = 1024,
-                                 castShadow = true
+                                 castShadow = true,
+                                 sun = Color.white,
+                                 sunIntensity = 0.9,
+                                 sunDirection = new Vector3(0.1, -1, 0.1),
+                                 ambient = Color.white,
+                                 ambientIntensity = 0.1
                              }) {
         const em = engine.entityManager;
 
@@ -343,18 +353,13 @@ export class EngineHarness {
 
         const key = new Light();
         key.type.set(Light.Type.DIRECTION);
-        key.color.setRGB(1, 1, 1);
-        key.intensity.set(0.8);
+        key.color.copy(sun);
+        key.intensity.set(sunIntensity);
         key.castShadow.set(castShadow);
 
         const transform = new Transform();
         transform.position.set(30, 70, 30);
-        transform.rotation.set(
-            -0.18780341950959473,
-            0.8049745556929917,
-            -0.4533975611897181,
-            -0.3334313787830773
-        );
+        transform.rotation.lookRotation(sunDirection);
 
         new Entity()
             .add(key)
@@ -365,8 +370,8 @@ export class EngineHarness {
 
         const fill = new Light();
         fill.type.set(Light.Type.AMBIENT);
-        fill.color.setRGB(1, 1, 1);
-        fill.intensity.set(0.1);
+        fill.color.copy(ambient);
+        fill.intensity.set(ambientIntensity);
 
 
         new Entity()

package/src/engine/asset/loaders/image/png/PNGReader.d.ts

@@ -11,16 +11,37 @@ export class PNGReader {
      * @constructor
      */
     constructor(bytes: ArrayBuffer);
+    /**
+     * current pointer
+     * @type {number}
+     */
     i: number;
+    /**
+     * bytes buffer
+     * @type {Uint8Array}
+     */
     bytes: Uint8Array;
+    /**
+     * Output object
+     * @type {PNG}
+     */
     png: PNG;
     dataChunks: any[];
+    /**
+     *
+     * @type {BinaryBuffer}
+     */
     buffer: BinaryBuffer;
     /**
      * Whether CRC should be performed or not
      * @type {boolean}
      */
     crc_enabled: boolean;
+    /**
+     *
+     * @type {Uint8Array}
+     */
+    header: Uint8Array;
     /**
      *
      * @param {number} length
@@ -31,7 +52,6 @@ export class PNGReader {
      * http://www.w3.org/TR/2003/REC-PNG-20031110/#5PNG-file-signature
      */
     decodeHeader(): void;
-    header: Uint8Array;
     /**
      * http://www.w3.org/TR/2003/REC-PNG-20031110/#5Chunk-layout
      *
@@ -119,7 +139,10 @@ export class PNGReader {
      * Uncompress IDAT chunks
      */
     decodePixels(): void;
-    interlaceNone(data: any): void;
+    /**
+     * @param {Uint8Array} data
+     */
+    interlaceNone(data: Uint8Array): void;
     /**
      * De-interlace image according to Adam 7 scheme
      * @param {Uint8Array} data
@@ -168,15 +191,6 @@ export class PNGReader {
     unFilterPaeth(scanline: any, scanline_offset: any, pixels: any, bpp: any, of: any, length: any): void;
     /**
      * Parse the PNG file
-     *
-     * reader.parse(options, callback)
-     * OR
-     * reader.parse(callback)
-     *
-     * OPTIONS:
-     *    option  | type     | default
-     *    ----------------------------
-     *    data      boolean    true    should it read the pixel data
      * @returns {PNG}
      */
     parse(): PNG;