@carbonenginejs/runtime-utils 0.1.1 → 0.1.3

package/src/object.js

@@ -1,39 +1,39 @@
-/**
- * Invokes handlers for keys explicitly owned by a source object.
- *
- * @param {object|Function} source Source values.
- * @param {object} handlers Property-keyed handler functions.
- * @param {*} [context=null] Optional `this` value for handlers.
- * @returns {number} Number of invoked handlers.
- */
-export function hasOwnThen(source, handlers, context = null)
-{
-    if (!source || (typeof source !== "object" && typeof source !== "function"))
-    {
-        throw new TypeError("hasOwnThen source must be an object or function.");
-    }
-
-    if (!handlers || typeof handlers !== "object" || Array.isArray(handlers))
-    {
-        throw new TypeError("hasOwnThen handlers must be an object.");
-    }
-
-    let invoked = 0;
-
-    for (const property of Reflect.ownKeys(handlers))
-    {
-        if (!Object.hasOwn(source, property)) continue;
-
-        const handler = handlers[property];
-
-        if (typeof handler !== "function")
-        {
-            throw new TypeError(`hasOwnThen handler must be a function: ${String(property)}.`);
-        }
-
-        handler.call(context, source[property], source, property);
-        invoked++;
-    }
-
-    return invoked;
-}
+/**
+ * Invokes handlers for keys explicitly owned by a source object.
+ *
+ * @param {object|Function} source Source values.
+ * @param {object} handlers Property-keyed handler functions.
+ * @param {*} [context=null] Optional `this` value for handlers.
+ * @returns {number} Number of invoked handlers.
+ */
+export function hasOwnThen(source, handlers, context = null)
+{
+    if (!source || (typeof source !== "object" && typeof source !== "function"))
+    {
+        throw new TypeError("hasOwnThen source must be an object or function.");
+    }
+
+    if (!handlers || typeof handlers !== "object" || Array.isArray(handlers))
+    {
+        throw new TypeError("hasOwnThen handlers must be an object.");
+    }
+
+    let invoked = 0;
+
+    for (const property of Reflect.ownKeys(handlers))
+    {
+        if (!Object.hasOwn(source, property)) continue;
+
+        const handler = handlers[property];
+
+        if (typeof handler !== "function")
+        {
+            throw new TypeError(`hasOwnThen handler must be a function: ${String(property)}.`);
+        }
+
+        handler.call(context, source[property], source, property);
+        invoked++;
+    }
+
+    return invoked;
+}

package/src/path.js

@@ -1,53 +1,53 @@
-/**
- * Normalizes slash direction and repeated separators without resolving dot
- * segments. URI-style scheme separators retain their authored slash count.
- */
-export function normalizePath(value, options = {})
-{
-    let result = String(value ?? "").trim().replace(/\\/gu, "/");
-    const scheme = /^([A-Za-z][A-Za-z0-9+.-]*:)(\/+)/u.exec(result);
-
-    if (scheme)
-    {
-        const prefix = scheme[0];
-        result = `${prefix}${result.slice(prefix.length).replace(/\/+/gu, "/")}`;
-    }
-    else
-    {
-        result = result.replace(/\/+/gu, "/");
-    }
-
-    return options.lowerCase ? result.toLowerCase() : result;
-}
-
-/** Normalizes a case-insensitive URI-style resource path. */
-export function normalizeResourcePath(value)
-{
-    return normalizePath(value, { lowerCase: true });
-}
-
-/** Returns the normalized extension of a URI-style resource path. */
-export function getResourceExtension(value)
-{
-    const path = normalizeResourcePath(value);
-    const queryIndex = path.search(/[?#]/u);
-    const cleanPath = queryIndex === -1 ? path : path.slice(0, queryIndex);
-    const slashIndex = cleanPath.lastIndexOf("/");
-    const dotIndex = cleanPath.lastIndexOf(".");
-
-    if (dotIndex === -1 || dotIndex < slashIndex)
-    {
-        return "";
-    }
-
-    return cleanPath.slice(dotIndex + 1);
-}
-
-/** Normalizes a resource extension without its optional leading dot. */
-export function normalizeResourceExtension(value)
-{
-    return String(value ?? "")
-        .trim()
-        .replace(/^\./u, "")
-        .toLowerCase();
-}
+/**
+ * Normalizes slash direction and repeated separators without resolving dot
+ * segments. URI-style scheme separators retain their authored slash count.
+ */
+export function normalizePath(value, options = {})
+{
+    let result = String(value ?? "").trim().replace(/\\/gu, "/");
+    const scheme = /^([A-Za-z][A-Za-z0-9+.-]*:)(\/+)/u.exec(result);
+
+    if (scheme)
+    {
+        const prefix = scheme[0];
+        result = `${prefix}${result.slice(prefix.length).replace(/\/+/gu, "/")}`;
+    }
+    else
+    {
+        result = result.replace(/\/+/gu, "/");
+    }
+
+    return options.lowerCase ? result.toLowerCase() : result;
+}
+
+/** Normalizes a case-insensitive URI-style resource path. */
+export function normalizeResourcePath(value)
+{
+    return normalizePath(value, { lowerCase: true });
+}
+
+/** Returns the normalized extension of a URI-style resource path. */
+export function getResourceExtension(value)
+{
+    const path = normalizeResourcePath(value);
+    const queryIndex = path.search(/[?#]/u);
+    const cleanPath = queryIndex === -1 ? path : path.slice(0, queryIndex);
+    const slashIndex = cleanPath.lastIndexOf("/");
+    const dotIndex = cleanPath.lastIndexOf(".");
+
+    if (dotIndex === -1 || dotIndex < slashIndex)
+    {
+        return "";
+    }
+
+    return cleanPath.slice(dotIndex + 1);
+}
+
+/** Normalizes a resource extension without its optional leading dot. */
+export function normalizeResourceExtension(value)
+{
+    return String(value ?? "")
+        .trim()
+        .replace(/^\./u, "")
+        .toLowerCase();
+}

package/src/pln.js

@@ -85,11 +85,11 @@ pln.create = vec4.create;
  * @param {vec3} p   - Point to compare
  * @returns {number} - The distance between them
  */
-pln.distanceToPoint = function(a, p)
-{
-    const length = Math.hypot(a[0], a[1], a[2]);
-    const distance = (a[0] * p[0] + a[1] * p[1] + a[2] * p[2]) + a[3];
-    return length === 0 ? distance : distance / length;
+pln.distanceToPoint = function(a, p)
+{
+    const length = Math.hypot(a[0], a[1], a[2]);
+    const distance = (a[0] * p[0] + a[1] * p[1] + a[2] * p[2]) + a[3];
+    return length === 0 ? distance : distance / length;
 };
 
 /**
@@ -100,10 +100,10 @@ pln.distanceToPoint = function(a, p)
  * @param {number} radius - sphere radius to compare
  * @returns {number}      - The distance between them
  */
-pln.distanceToPositionRadius = function(a, position, radius)
-{
-    return pln.distanceToPoint(a, position) - radius;
-};
+pln.distanceToPositionRadius = function(a, position, radius)
+{
+    return pln.distanceToPoint(a, position) - radius;
+};
 
 /**
  * Gets the distance from a plane to a Float32Array(4) sphere
@@ -112,10 +112,10 @@ pln.distanceToPositionRadius = function(a, position, radius)
  * @param {sph3} sphere - sphere to compare
  * @returns {number}    - The distance between them
  */
-pln.distanceToSph3 = function(a, sphere)
-{
-    return pln.distanceToPoint(a, sphere) - sphere[3];
-};
+pln.distanceToSph3 = function(a, sphere)
+{
+    return pln.distanceToPoint(a, sphere) - sphere[3];
+};
 
 /**
  * Gets the distance from a plane to a point's values
@@ -126,11 +126,11 @@ pln.distanceToSph3 = function(a, sphere)
  * @param {Number} pz - Point z to compare
  * @returns {number}  - The distance between them
  */
-pln.distanceToValues = function(a, px, py, pz)
-{
-    const length = Math.hypot(a[0], a[1], a[2]);
-    const distance = (a[0] * px + a[1] * py + a[2] * pz) + a[3];
-    return length === 0 ? distance : distance / length;
+pln.distanceToValues = function(a, px, py, pz)
+{
+    const length = Math.hypot(a[0], a[1], a[2]);
+    const distance = (a[0] * px + a[1] * py + a[2] * pz) + a[3];
+    return length === 0 ? distance : distance / length;
 };
 
 /**
@@ -293,18 +293,18 @@ pln.fromNormalAndCoplanarPoint = function(out, normal, point)
  * @param {pln} a      - the source plane
  * @returns {vec3} out - receiving vec3
  */
-pln.getCoplanarPoint = function(out, a)
-{
-    const lengthSquared = a[0] * a[0] + a[1] * a[1] + a[2] * a[2];
-    if (lengthSquared === 0)
-    {
-        out[0] = out[1] = out[2] = 0;
-        return out;
-    }
-    const inverseLengthSquared = 1 / lengthSquared;
-    out[0] = a[0] * -a[3] * inverseLengthSquared;
-    out[1] = a[1] * -a[3] * inverseLengthSquared;
-    out[2] = a[2] * -a[3] * inverseLengthSquared;
+pln.getCoplanarPoint = function(out, a)
+{
+    const lengthSquared = a[0] * a[0] + a[1] * a[1] + a[2] * a[2];
+    if (lengthSquared === 0)
+    {
+        out[0] = out[1] = out[2] = 0;
+        return out;
+    }
+    const inverseLengthSquared = 1 / lengthSquared;
+    out[0] = a[0] * -a[3] * inverseLengthSquared;
+    out[1] = a[1] * -a[3] * inverseLengthSquared;
+    out[2] = a[2] * -a[3] * inverseLengthSquared;
     return out;
 };
 
@@ -346,14 +346,14 @@ pln.getIntersectLne3 = function(out, a, l)
             return out;
         }
 
-        return null;
+        return null;
     }
 
-    let t = -((lsx * a[0] + lsy * a[1] + lsz * a[2]) + a[3]) / den;
+    let t = -((lsx * a[0] + lsy * a[1] + lsz * a[2]) + a[3]) / den;
 
     if (t < 0 || t > 1)
     {
-        return null;
+        return null;
     }
 
     out[0] = (dirX * t) + lsx;
@@ -373,13 +373,13 @@ pln.getIntersectLne3 = function(out, a, l)
  * @param {vec3} lineEnd
  * @returns {vec3}
  */
-pln.getIntersectStartEnd = function(out, a, lineStart, lineEnd)
-{
-    const vec6_0 = box3.alloc();
-    box3.from(vec6_0, lineStart, lineEnd);
-    const result = pln.getIntersectLne3(out, a, vec6_0);
-    box3.unalloc(vec6_0);
-    return result;
+pln.getIntersectStartEnd = function(out, a, lineStart, lineEnd)
+{
+    const vec6_0 = box3.alloc();
+    box3.from(vec6_0, lineStart, lineEnd);
+    const result = pln.getIntersectLne3(out, a, vec6_0);
+    box3.unalloc(vec6_0);
+    return result;
 };
 
 /**
@@ -405,16 +405,16 @@ pln.getNormal = function(out, a)
  * @param {vec3} p      - the point to project
  * @returns {vec3} out  - receiving vec3
  */
-pln.getOrthoPoint = function(out, a, p)
-{
-    const
-        lengthSquared = a[0] * a[0] + a[1] * a[1] + a[2] * a[2],
-        scale = lengthSquared === 0 ? 0 :
-            ((a[0] * p[0] + a[1] * p[1] + a[2] * p[2]) + a[3]) / lengthSquared;
-
-    out[0] = a[0] * scale;
-    out[1] = a[1] * scale;
-    out[2] = a[2] * scale;
+pln.getOrthoPoint = function(out, a, p)
+{
+    const
+        lengthSquared = a[0] * a[0] + a[1] * a[1] + a[2] * a[2],
+        scale = lengthSquared === 0 ? 0 :
+            ((a[0] * p[0] + a[1] * p[1] + a[2] * p[2]) + a[3]) / lengthSquared;
+
+    out[0] = a[0] * scale;
+    out[1] = a[1] * scale;
+    out[2] = a[2] * scale;
     return out;
 };
 
@@ -475,8 +475,8 @@ pln.intersectsLne3 = function(a, l)
 {
     let startSign = (a[0] * l[0] + a[1] * l[1] + a[2] * l[2]) + a[3];
     let endSign = (a[0] * l[3] + a[1] * l[4] + a[2] * l[5]) + a[3];
-    return startSign === 0 || endSign === 0 ||
-        (startSign < 0 && endSign > 0) || (endSign < 0 && startSign > 0);
+    return startSign === 0 || endSign === 0 ||
+        (startSign < 0 && endSign > 0) || (endSign < 0 && startSign > 0);
 };
 
 /**
@@ -487,13 +487,13 @@ pln.intersectsLne3 = function(a, l)
  * @param {number} radius - sphere radius compare
  * @returns {boolean}     - true if intersection occurs
  */
-pln.intersectsPositionRadius = function(a, position, radius)
-{
-    const
-        distance = position[0] * a[0] + position[1] * a[1] + position[2] * a[2] + a[3],
-        normalLength = Math.hypot(a[0], a[1], a[2]);
-    return radius >= 0 && Math.abs(distance) <= radius * (normalLength || 1);
-};
+pln.intersectsPositionRadius = function(a, position, radius)
+{
+    const
+        distance = position[0] * a[0] + position[1] * a[1] + position[2] * a[2] + a[3],
+        normalLength = Math.hypot(a[0], a[1], a[2]);
+    return radius >= 0 && Math.abs(distance) <= radius * (normalLength || 1);
+};
 
 /**
  * Checks if a plane intersects a sph3
@@ -502,13 +502,13 @@ pln.intersectsPositionRadius = function(a, position, radius)
  * @param {sph3} s    - sphere to compare
  * @returns {boolean} - true if intersection occurs
  */
-pln.intersectsSph3 = function(a, s)
-{
-    const
-        distance = s[0] * a[0] + s[1] * a[1] + s[2] * a[2] + a[3],
-        normalLength = Math.hypot(a[0], a[1], a[2]);
-    return s[3] >= 0 && Math.abs(distance) <= s[3] * (normalLength || 1);
-};
+pln.intersectsSph3 = function(a, s)
+{
+    const
+        distance = s[0] * a[0] + s[1] * a[1] + s[2] * a[2] + a[3],
+        normalLength = Math.hypot(a[0], a[1], a[2]);
+    return s[3] >= 0 && Math.abs(distance) <= s[3] * (normalLength || 1);
+};
 
 /**
  * Checks if a plane intersects a lne3's components
@@ -522,8 +522,8 @@ pln.intersectsStartEnd = function(a, start, end)
 {
     let startSign = (a[0] * start[0] + a[1] * start[1] + a[2] * start[2]) + a[3];
     let endSign = (a[0] * end[0] + a[1] * end[1] + a[2] * end[2]) + a[3];
-    return startSign === 0 || endSign === 0 ||
-        (startSign < 0 && endSign > 0) || (endSign < 0 && startSign > 0);
+    return startSign === 0 || endSign === 0 ||
+        (startSign < 0 && endSign > 0) || (endSign < 0 && startSign > 0);
 };
 
 /**
@@ -646,12 +646,12 @@ pln.toArray = function(a, arr, offset = 0)
  * @param {mat3} [nMatrix] - optional normal matrix
  * @returns {pln} out      - the receiving plane
  */
-pln.transformMat4 = function(out, a, m, nMatrix)
-{
-    const sourceLengthSquared = a[0] * a[0] + a[1] * a[1] + a[2] * a[2];
-    if (sourceLengthSquared === 0) return pln.copy(out, a);
-
-    let mat3_0;
+pln.transformMat4 = function(out, a, m, nMatrix)
+{
+    const sourceLengthSquared = a[0] * a[0] + a[1] * a[1] + a[2] * a[2];
+    if (sourceLengthSquared === 0) return pln.copy(out, a);
+
+    let mat3_0;
     if (!nMatrix)
     {
         mat3_0 = mat3.alloc();
@@ -659,10 +659,10 @@ pln.transformMat4 = function(out, a, m, nMatrix)
     }
 
     // Coplanar Point
-    const inverseLengthSquared = 1 / sourceLengthSquared;
-    let cpX = a[0] * -a[3] * inverseLengthSquared,
-        cpY = a[1] * -a[3] * inverseLengthSquared,
-        cpZ = a[2] * -a[3] * inverseLengthSquared;
+    const inverseLengthSquared = 1 / sourceLengthSquared;
+    let cpX = a[0] * -a[3] * inverseLengthSquared,
+        cpY = a[1] * -a[3] * inverseLengthSquared,
+        cpZ = a[2] * -a[3] * inverseLengthSquared;
 
     // Create reference point from Coplanar Point transformed by the affine mat4
     let rX = m[0] * cpX + m[4] * cpY + m[8] * cpZ + m[12],
@@ -710,53 +710,53 @@ pln.transformMat4 = function(out, a, m, nMatrix)
  * @param {vec3} v    - the vector to translate with
  * @returns {pln} out - the receiving plane
  */
-pln.translate = function(out, a, v)
-{
+pln.translate = function(out, a, v)
+{
     out[0] = a[0];
     out[1] = a[1];
     out[2] = a[2];
-    out[3] = a[3] - (v[0] * a[0] + v[1] * a[1] + v[2] * a[2]);
-    return out;
-};
-
-export const {
-    alloc,
-    unalloc,
-    $normal,
-    clone,
-    constant,
-    copy,
-    create,
-    distanceToPoint,
-    distanceToPositionRadius,
-    distanceToSph3,
-    distanceToValues,
-    equals,
-    equalsNormalConstant,
-    exactEquals,
-    exactEqualsNormalConstant,
-    extract,
-    fromNormalConstant,
-    fromCoplanarPoints,
-    fromNormalAndCoplanarPoint,
-    getCoplanarPoint,
-    getIntersectLne3,
-    getIntersectStartEnd,
-    getNormal,
-    getOrthoPoint,
-    getProjectedPoint,
-    intersectsBounds,
-    intersectsBox3,
-    intersectsLne3,
-    intersectsPositionRadius,
-    intersectsSph3,
-    intersectsStartEnd,
-    negate,
-    normalize,
-    set,
-    setAndNormalize,
-    setArray,
-    toArray,
-    transformMat4,
-    translate
-} = pln;
+    out[3] = a[3] - (v[0] * a[0] + v[1] * a[1] + v[2] * a[2]);
+    return out;
+};
+
+export const {
+    alloc,
+    unalloc,
+    $normal,
+    clone,
+    constant,
+    copy,
+    create,
+    distanceToPoint,
+    distanceToPositionRadius,
+    distanceToSph3,
+    distanceToValues,
+    equals,
+    equalsNormalConstant,
+    exactEquals,
+    exactEqualsNormalConstant,
+    extract,
+    fromNormalConstant,
+    fromCoplanarPoints,
+    fromNormalAndCoplanarPoint,
+    getCoplanarPoint,
+    getIntersectLne3,
+    getIntersectStartEnd,
+    getNormal,
+    getOrthoPoint,
+    getProjectedPoint,
+    intersectsBounds,
+    intersectsBox3,
+    intersectsLne3,
+    intersectsPositionRadius,
+    intersectsSph3,
+    intersectsStartEnd,
+    negate,
+    normalize,
+    set,
+    setAndNormalize,
+    setArray,
+    toArray,
+    transformMat4,
+    translate
+} = pln;

package/src/pool.js

@@ -149,12 +149,12 @@ export function createPool()
 
 }
 
-export const pool = createPool();
-
-export const {
-    allocF32,
-    allocType,
-    unalloc,
-    freeType,
-    free
-} = pool;
+export const pool = createPool();
+
+export const {
+    allocF32,
+    allocType,
+    unalloc,
+    freeType,
+    free
+} = pool;