@carbonenginejs/runtime-utils 0.1.1 → 0.1.3

package/src/schema/index.js

@@ -2,12 +2,12 @@ import { CJS_ENUM_NAME, CjsSchema } from "./CjsSchema.js";
 
 // Namespace decorators re-exported as named bindings so consumers can write
 // `import { type, io } from ".../schema"` and `@type.string` instead of `@CjsSchema.type.string`.
-const { type, io, jessica, impl, carbon, components } = CjsSchema;
+const { type, io, jessica, impl, carbon, components } = CjsSchema;
 
 export {
-    carbon,
-    components,
-    CJS_ENUM_NAME,
+    carbon,
+    components,
+    CJS_ENUM_NAME,
     CjsSchema,
     CjsSchema as schema,
     impl,

package/src/shader/index.js

@@ -1 +1 @@
-export * from "./shaderStages.js";
+export * from "./shaderStages.js";

package/src/shader/shaderStages.js

@@ -1,37 +1,37 @@
-/**
- * Canonical shader stage tokens.
- */
-export const ShaderStage = Object.freeze({
-    VERTEX: "vertex",
-    FRAGMENT: "fragment",
-    PIXEL: "pixel",
-    COMPUTE: "compute",
-    GEOMETRY: "geometry",
-    HULL: "hull",
-    DOMAIN: "domain"
-});
-
-/**
- * Canonical shader model/profile tokens.
- */
-export const ShaderModel = Object.freeze({
-    UNKNOWN: "unknown",
-    SM2: "sm2",
-    SM3: "sm3",
-    SM4: "sm4",
-    SM5: "sm5",
-    SM6: "sm6",
-    GLSL_ES_300: "glsl-es-300",
-    WGSL: "wgsl"
-});
-
-/**
- * Normalize a shader stage token.
- *
- * @param {string} stage Shader stage token.
- * @returns {string} Canonical lowercase token.
- */
-export function normalizeShaderStage(stage)
-{
-    return stage ? String(stage).trim().toLowerCase() : "";
-}
+/**
+ * Canonical shader stage tokens.
+ */
+export const ShaderStage = Object.freeze({
+    VERTEX: "vertex",
+    FRAGMENT: "fragment",
+    PIXEL: "pixel",
+    COMPUTE: "compute",
+    GEOMETRY: "geometry",
+    HULL: "hull",
+    DOMAIN: "domain"
+});
+
+/**
+ * Canonical shader model/profile tokens.
+ */
+export const ShaderModel = Object.freeze({
+    UNKNOWN: "unknown",
+    SM2: "sm2",
+    SM3: "sm3",
+    SM4: "sm4",
+    SM5: "sm5",
+    SM6: "sm6",
+    GLSL_ES_300: "glsl-es-300",
+    WGSL: "wgsl"
+});
+
+/**
+ * Normalize a shader stage token.
+ *
+ * @param {string} stage Shader stage token.
+ * @returns {string} Canonical lowercase token.
+ */
+export function normalizeShaderStage(stage)
+{
+    return stage ? String(stage).trim().toLowerCase() : "";
+}

package/src/sph3.js

@@ -9,35 +9,35 @@ import { box3 } from "./box3.js";
  * @typedef {Float32Array} sph3
  */
 
-export const sph3 = {};
-
-// Scratch
-let sph3_0 = null;
-let box3_0 = null;
-
-/**
- * Allocates a pooled sph3
- * @returns {Float32Array|sph3}
- */
-sph3.alloc = vec4.alloc;
-
-/**
- * Unallocates a pooled sph3
- * @param {sph3|Float32Array} a
- */
-sph3.unalloc = vec4.unalloc;
-
-/**
- * Returns a subarray containing the position component of the sph3
- * - Why does webpack fail to resolve this if referencing pln.normal?
+export const sph3 = {};
+
+// Scratch
+let sph3_0 = null;
+let box3_0 = null;
+
+/**
+ * Allocates a pooled sph3
+ * @returns {Float32Array|sph3}
+ */
+sph3.alloc = vec4.alloc;
+
+/**
+ * Unallocates a pooled sph3
+ * @param {sph3|Float32Array} a
+ */
+sph3.unalloc = vec4.unalloc;
+
+/**
+ * Returns a subarray containing the position component of the sph3
+ * - Why does webpack fail to resolve this if referencing pln.normal?
  *
  * @param {sph3} a
  * @returns {sph3}
  */
-sph3.$position = function(a)
-{
-    return a.subarray(0, 3);
-};
+sph3.$position = function(a)
+{
+    return a.subarray(0, 3);
+};
 
 /**
  * Clones a sphere
@@ -54,10 +54,10 @@ sph3.clone = vec4.clone;
  * @param {vec3} p
  * @returns {boolean}
  */
-sph3.containsPoint = function(a, p)
-{
-    if (sph3.isEmpty(a)) return false;
-
+sph3.containsPoint = function(a, p)
+{
+    if (sph3.isEmpty(a)) return false;
+
     let x = p[0] - a[0],
         y = p[1] - a[1],
         z = p[2] - a[2];
@@ -79,9 +79,9 @@ sph3.copy = vec4.copy;
  *
  * @returns {sph3}
  */
-sph3.create = function()
-{
-    return new Float32Array([ 0, 0, 0, -1 ]);
+sph3.create = function()
+{
+    return new Float32Array([ 0, 0, 0, -1 ]);
 };
 
 /**
@@ -91,10 +91,10 @@ sph3.create = function()
  * @param {sph3} b
  * @returns {number}
  */
-sph3.distance = function(a, b)
-{
-    if (sph3.isEmpty(a) || sph3.isEmpty(b)) return Infinity;
-
+sph3.distance = function(a, b)
+{
+    if (sph3.isEmpty(a) || sph3.isEmpty(b)) return Infinity;
+
     let x = b[0] - a[0],
         y = b[1] - a[1],
         z = b[2] - a[2],
@@ -110,10 +110,10 @@ sph3.distance = function(a, b)
  * @param {vec3} p
  * @returns {number}
  */
-sph3.distanceToPoint = function(a, p)
-{
-    if (sph3.isEmpty(a)) return Infinity;
-
+sph3.distanceToPoint = function(a, p)
+{
+    if (sph3.isEmpty(a)) return Infinity;
+
     let x = p[0] - a[0],
         y = p[1] - a[1],
         z = p[2] - a[2];
@@ -126,12 +126,12 @@ sph3.distanceToPoint = function(a, p)
  * @param {sph3} a
  * @returns {sph3} a
  */
-sph3.empty = function(a)
-{
+sph3.empty = function(a)
+{
     a[0] = 0;
     a[1] = 0;
     a[2] = 0;
-    a[3] = -1;
+    a[3] = -1;
     return a;
 };
 
@@ -189,10 +189,10 @@ sph3.extract = pln.extract;
  * @param {box3} b
  * @return {sph3} out
  */
-sph3.fromBox3 = function(out, b)
-{
-    if (box3.isEmpty(b)) return sph3.empty(out);
-
+sph3.fromBox3 = function(out, b)
+{
+    if (box3.isEmpty(b)) return sph3.empty(out);
+
     let sX = b[3] - b[0],
         sY = b[4] - b[1],
         sZ = b[5] - b[2];
@@ -235,9 +235,9 @@ sph3.fromBounds = function(out, min, max)
  * @param {number} r
  * @returns {sph3} out
  */
-sph3.fromPositionRadius = pln.fromNormalConstant;
-
-sph3.from = sph3.fromPositionRadius;
+sph3.fromPositionRadius = pln.fromNormalConstant;
+
+sph3.from = sph3.fromPositionRadius;
 
 /**
  * Sets a sphere from a mat4's translation and a given radius
@@ -247,12 +247,12 @@ sph3.from = sph3.fromPositionRadius;
  * @param {number} radius
  * @returns {sph3} out
  */
-sph3.fromTranslationRadius = function(out, a, radius)
-{
-    const offset = a.length >= 15 ? 12 : 0;
-    out[0] = a[offset];
-    out[1] = a[offset + 1];
-    out[2] = a[offset + 2];
+sph3.fromTranslationRadius = function(out, a, radius)
+{
+    const offset = a.length >= 15 ? 12 : 0;
+    out[0] = a[offset];
+    out[1] = a[offset + 1];
+    out[2] = a[offset + 2];
     out[3] = radius;
     return out;
 };
@@ -286,11 +286,11 @@ let aPosition,
  * @param {sph3} b
  * @returns {sph3} out
  */
-sph3.union = function(out, a, b)
-{
-    if (sph3.isEmpty(a)) return sph3.copy(out, b);
-    if (sph3.isEmpty(b)) return sph3.copy(out, a);
-
+sph3.union = function(out, a, b)
+{
+    if (sph3.isEmpty(a)) return sph3.copy(out, b);
+    if (sph3.isEmpty(b)) return sph3.copy(out, a);
+
     if (!aPosition)
     {
         aPosition = vec3.create();
@@ -331,11 +331,11 @@ sph3.union = function(out, a, b)
  * @param {Number} radius
  * @returns {sph3}
  */
-sph3.unionPositionRadius = function(out, a, position, radius)
-{
-    if (!sph3_0) sph3_0 = sph3.create();
-    return sph3.union(out, a, sph3.fromPositionRadius(sph3_0, position, radius));
-};
+sph3.unionPositionRadius = function(out, a, position, radius)
+{
+    if (!sph3_0) sph3_0 = sph3.create();
+    return sph3.union(out, a, sph3.fromPositionRadius(sph3_0, position, radius));
+};
 
 /**
  * Gets a point clamped to the sphere
@@ -346,14 +346,14 @@ sph3.unionPositionRadius = function(out, a, position, radius)
  * @param {vec3} p
  * @returns {vec3} out
  */
-sph3.getClampedPoint = function(out, a, p)
-{
+sph3.getClampedPoint = function(out, a, p)
+{
     out[0] = p[0];
     out[1] = p[1];
-    out[2] = p[2];
-
-    if (sph3.isEmpty(a)) return out;
-
+    out[2] = p[2];
+
+    if (sph3.isEmpty(a)) return out;
+
     let x = a[0] - p[0],
         y = a[1] - p[1],
         z = a[2] - p[2];
@@ -407,10 +407,10 @@ sph3.getPosition = pln.getNormal;
  * @param {sph3} b
  * @returns {boolean}
  */
-sph3.intersectsSph3 = function(a, b)
-{
-    if (sph3.isEmpty(a) || sph3.isEmpty(b)) return false;
-
+sph3.intersectsSph3 = function(a, b)
+{
+    if (sph3.isEmpty(a) || sph3.isEmpty(b)) return false;
+
     let x = b[0] - a[0],
         y = b[1] - a[1],
         z = b[2] - a[2];
@@ -426,9 +426,9 @@ sph3.intersectsSph3 = function(a, b)
  * @param {box3} b
  * @returns {boolean}
  */
-sph3.intersectsBox3 = function(a, b)
-{
-    return !sph3.isEmpty(a) && !box3.isEmpty(b) && box3.intersectsSph3(b, a);
+sph3.intersectsBox3 = function(a, b)
+{
+    return !sph3.isEmpty(a) && !box3.isEmpty(b) && box3.intersectsSph3(b, a);
 };
 
 /**
@@ -439,10 +439,10 @@ sph3.intersectsBox3 = function(a, b)
  * @param {vec3} max
  * @returns {boolean}
  */
-sph3.intersectsBounds = function(a, min, max)
-{
-    if (sph3.isEmpty(a) || box3.bounds.isEmpty(min, max)) return false;
-
+sph3.intersectsBounds = function(a, min, max)
+{
+    if (sph3.isEmpty(a) || box3.bounds.isEmpty(min, max)) return false;
+
     let x = Math.max(min[0], Math.min(max[0], a[0])) - a[0],
         y = Math.max(min[1], Math.min(max[1], a[1])) - a[1],
         z = Math.max(min[2], Math.min(max[2], a[2])) - a[2];
@@ -458,10 +458,10 @@ sph3.intersectsBounds = function(a, min, max)
  * @param {number} r
  * @returns {boolean}
  */
-sph3.intersectsPositionRadius = function(a, p, r)
-{
-    if (sph3.isEmpty(a) || r < 0) return false;
-
+sph3.intersectsPositionRadius = function(a, p, r)
+{
+    if (sph3.isEmpty(a) || r < 0) return false;
+
     let x = p[0] - a[0],
         y = p[1] - a[1],
         z = p[2] - a[2];
@@ -490,15 +490,15 @@ sph3.intersectsPln = function(a, p)
  * @param {number} c - plane constant
  * @returns {boolean}
  */
-sph3.intersectsNormalConstant = function(a, n, c)
-{
-    if (sph3.isEmpty(a)) return false;
-
-    const
-        distance = a[0] * n[0] + a[1] * n[1] + a[2] * n[2] + c,
-        normalLength = Math.hypot(n[0], n[1], n[2]);
-    return Math.abs(distance) <= a[3] * normalLength;
-};
+sph3.intersectsNormalConstant = function(a, n, c)
+{
+    if (sph3.isEmpty(a)) return false;
+
+    const
+        distance = a[0] * n[0] + a[1] * n[1] + a[2] * n[2] + c,
+        normalLength = Math.hypot(n[0], n[1], n[2]);
+    return Math.abs(distance) <= a[3] * normalLength;
+};
 
 /**
  * Checks if a sph3 is empty
@@ -506,9 +506,9 @@ sph3.intersectsNormalConstant = function(a, n, c)
  * @param {sph3} a
  * @returns {boolean}
  */
-sph3.isEmpty = function(a)
-{
-    return a[3] < 0;
+sph3.isEmpty = function(a)
+{
+    return a[3] < 0;
 };
 
 /**
@@ -549,10 +549,10 @@ sph3.setArray = vec4.setArray;
  * @param {vec3} [position] - An optional center position
  * @returns {sph3} out      - the receiving sphere
  */
-sph3.setPoints = function(out, points, position)
-{
-    if (!points.length) return sph3.empty(out);
-
+sph3.setPoints = function(out, points, position)
+{
+    if (!points.length) return sph3.empty(out);
+
     if (!box3_0) box3_0 = box3.create();
 
     if (position)
@@ -591,16 +591,16 @@ sph3.setPoints = function(out, points, position)
  * @param {sph3} b
  * @returns {number}
  */
-sph3.squaredDistance = function(a, b)
-{
-    if (sph3.isEmpty(a) || sph3.isEmpty(b)) return Infinity;
-
+sph3.squaredDistance = function(a, b)
+{
+    if (sph3.isEmpty(a) || sph3.isEmpty(b)) return Infinity;
+
     let x = b[0] - a[0],
         y = b[1] - a[1],
-        z = b[2] - a[2],
-        distance = Math.sqrt(x * x + y * y + z * z) - (b[3] + a[3]);
-
-    return distance * distance;
+        z = b[2] - a[2],
+        distance = Math.sqrt(x * x + y * y + z * z) - (b[3] + a[3]);
+
+    return distance * distance;
 };
 
 /**
@@ -610,17 +610,17 @@ sph3.squaredDistance = function(a, b)
  * @param {vec3} p
  * @returns {number}
  */
-sph3.squaredDistanceToPoint = function(a, p)
-{
-    if (sph3.isEmpty(a)) return Infinity;
-
-    let x = p[0] - a[0],
-        y = p[1] - a[1],
-        z = p[2] - a[2],
-        distance = Math.sqrt(x * x + y * y + z * z) - a[3];
-
-    return distance * distance;
-};
+sph3.squaredDistanceToPoint = function(a, p)
+{
+    if (sph3.isEmpty(a)) return Infinity;
+
+    let x = p[0] - a[0],
+        y = p[1] - a[1],
+        z = p[2] - a[2],
+        distance = Math.sqrt(x * x + y * y + z * z) - a[3];
+
+    return distance * distance;
+};
 
 /**
  * Sets an array at an optional offset, with the values of a sph3
@@ -669,10 +669,10 @@ sph3.toPositionRadius = function(a, position)
  * @param {mat4} m   - the matrix to transform by
  * @returns {sph3}
  */
-sph3.transformMat4 = function(out, a, m)
-{
-    if (sph3.isEmpty(a)) return sph3.empty(out);
-
+sph3.transformMat4 = function(out, a, m)
+{
+    if (sph3.isEmpty(a)) return sph3.empty(out);
+
     let x = a[0],
         y = a[1],
         z = a[2];
@@ -697,58 +697,58 @@ sph3.transformMat4 = function(out, a, m)
  * @param {vec3} v   - the vector to translate with
  * @returns {sph3}
  */
-sph3.translate = function(out, a, v)
-{
-    out[0] = a[0] + v[0];
-    out[1] = a[1] + v[1];
-    out[2] = a[2] + v[2];
-    out[3] = a[3];
-    return out;
-};
-
-export const {
-    alloc,
-    unalloc,
-    $position,
-    clone,
-    containsPoint,
-    copy,
-    create,
-    distance,
-    distanceToPoint,
-    empty,
-    equals,
-    equalsPositionRadius,
-    exactEquals,
-    exactEqualsPositionRadius,
-    extract,
-    fromBox3,
-    fromBounds,
-    fromPositionRadius,
-    from,
-    fromTranslationRadius,
-    fromMat4,
-    union,
-    unionPositionRadius,
-    getClampedPoint,
-    getPointFromLongLat,
-    getPosition,
-    intersectsSph3,
-    intersectsBox3,
-    intersectsBounds,
-    intersectsPositionRadius,
-    intersectsPln,
-    intersectsNormalConstant,
-    isEmpty,
-    radius,
-    set,
-    setArray,
-    setPoints,
-    squaredDistance,
-    squaredDistanceToPoint,
-    toArray,
-    toBounds,
-    toPositionRadius,
-    transformMat4,
-    translate
-} = sph3;
+sph3.translate = function(out, a, v)
+{
+    out[0] = a[0] + v[0];
+    out[1] = a[1] + v[1];
+    out[2] = a[2] + v[2];
+    out[3] = a[3];
+    return out;
+};
+
+export const {
+    alloc,
+    unalloc,
+    $position,
+    clone,
+    containsPoint,
+    copy,
+    create,
+    distance,
+    distanceToPoint,
+    empty,
+    equals,
+    equalsPositionRadius,
+    exactEquals,
+    exactEqualsPositionRadius,
+    extract,
+    fromBox3,
+    fromBounds,
+    fromPositionRadius,
+    from,
+    fromTranslationRadius,
+    fromMat4,
+    union,
+    unionPositionRadius,
+    getClampedPoint,
+    getPointFromLongLat,
+    getPosition,
+    intersectsSph3,
+    intersectsBox3,
+    intersectsBounds,
+    intersectsPositionRadius,
+    intersectsPln,
+    intersectsNormalConstant,
+    isEmpty,
+    radius,
+    set,
+    setArray,
+    setPoints,
+    squaredDistance,
+    squaredDistanceToPoint,
+    toArray,
+    toBounds,
+    toPositionRadius,
+    transformMat4,
+    translate
+} = sph3;