@carbonenginejs/runtime-utils 0.1.1 → 0.1.3

package/src/is.js

@@ -1,5 +1,5 @@
-
-import { equals } from "./num.js";
+
+import { equals } from "./num.js";
 
 
 const toString = Object.prototype.toString;
@@ -34,15 +34,15 @@ export function isSet(o)
     return !!(o && o instanceof Set);
 }
 
-/**
- * Checks if an object is iterable
- * @param {*} a
- * @returns {boolean}
- */
-export function isIterable(a)
-{
-    return a !== null && a !== undefined && typeof a[Symbol.iterator] === "function";
-}
+/**
+ * Checks if an object is iterable
+ * @param {*} a
+ * @returns {boolean}
+ */
+export function isIterable(a)
+{
+    return a !== null && a !== undefined && typeof a[Symbol.iterator] === "function";
+}
 
 /**
  * Checks if a value is an array
@@ -53,14 +53,14 @@ export const isArray = Array.isArray;
 
 /**
  * Checks if a value is an array or a typed array
- * @param {*} a
- * @param {number} [minLength=0]
- * @returns {Boolean}
- */
-export function isArrayLike(a, minLength = 0)
-{
-    return !!(a && (isArray(a) || isTyped(a)) && a.length >= minLength);
-}
+ * @param {*} a
+ * @param {number} [minLength=0]
+ * @returns {Boolean}
+ */
+export function isArrayLike(a, minLength = 0)
+{
+    return !!(a && (isArray(a) || isTyped(a)) && a.length >= minLength);
+}
 
 /**
  * Checks if a function is async
@@ -88,9 +88,9 @@ export function isBoolean(a)
  * @param {*} a
  * @returns {Boolean}
  */
-export function isCanvas(a)
-{
-    return typeof HTMLCanvasElement !== "undefined" && a instanceof HTMLCanvasElement;
+export function isCanvas(a)
+{
+    return typeof HTMLCanvasElement !== "undefined" && a instanceof HTMLCanvasElement;
 }
 
 /**
@@ -123,9 +123,9 @@ export function isDescriptor(a)
  * Checks if a value is a valid sof DNA string
  * @param {*} a
  */
-export function isDNA(a)
-{
-    return isString(a) && /^[\w-]+:[\w-]+:[\w-]+$/.test(a);
+export function isDNA(a)
+{
+    return isString(a) && /^[\w-]+:[\w-]+:[\w-]+$/.test(a);
 }
 
 /**
@@ -133,9 +133,9 @@ export function isDNA(a)
  * @param {*} a
  * @returns {Boolean}
  */
-export function isError(a)
-{
-    return !!(a && (a instanceof Error || a.constructor?.__category === "Error"));
+export function isError(a)
+{
+    return !!(a && (a instanceof Error || a.constructor?.__category === "Error"));
 }
 
 /**
@@ -148,6 +148,68 @@ export function isNumber(a)
     return isTag(a, "[object Number]");
 }
 
+/**
+ * Checks if a value fits a signed 8-bit integer.
+ * @param {*} value
+ * @returns {Boolean}
+ */
+export function isInt8(value)
+{
+    return Number.isInteger(value) && value >= -0x80 && value <= 0x7f;
+}
+
+/**
+ * Checks if a value fits an unsigned 8-bit integer.
+ * @param {*} value
+ * @returns {Boolean}
+ */
+export function isUint8(value)
+{
+    return Number.isInteger(value) && value >= 0 && value <= 0xff;
+}
+
+/**
+ * Checks if a value fits a signed 16-bit integer.
+ * @param {*} value
+ * @returns {Boolean}
+ */
+export function isInt16(value)
+{
+    return Number.isInteger(value) && value >= -0x8000 && value <= 0x7fff;
+}
+
+/**
+ * Checks if a value fits an unsigned 16-bit integer.
+ * @param {*} value
+ * @returns {Boolean}
+ */
+export function isUint16(value)
+{
+    return Number.isInteger(value) && value >= 0 && value <= 0xffff;
+}
+
+/**
+ * Checks if a value fits a signed 32-bit integer.
+ * @param {*} value
+ * @returns {Boolean}
+ */
+export function isInt32(value)
+{
+    return Number.isInteger(value)
+        && value >= -0x80000000
+        && value <= 0x7fffffff;
+}
+
+/**
+ * Checks if a value fits an unsigned 32-bit integer.
+ * @param {*} value
+ * @returns {Boolean}
+ */
+export function isUint32(value)
+{
+    return Number.isInteger(value) && value >= 0 && value <= 0xffffffff;
+}
+
 /**
  * Checks if a value is a function
  * @param {*} a
@@ -452,7 +514,7 @@ export function isPrimaryEqual(a, b)
 {
     if (a === b) return true;
 
-    return isNumber(a) && isNumber(b) ? equals(a, b) : false;
+    return isNumber(a) && isNumber(b) ? equals(a, b) : false;
 }
 
 /**
@@ -490,12 +552,12 @@ export function isDateEqual(a, b)
  * @param {String|Boolean|Number|Array|TypedArray} b
  * @returns {boolean}
  */
-export function isEqual(a, b)
-{
+export function isEqual(a, b)
+{
     if (a === b) return true;
 
     // allow "almost" equal numbers
-    if (isNumber(a)) return isNumber(b) ? equals(a, b) : false;
+    if (isNumber(a)) return isNumber(b) ? equals(a, b) : false;
     //if(isDate(a))) return isDate(b) ? isEqual(a, b) : false;
     if (isVector(a)) return isVector(b) ? isVectorEqual(a, b) : false;
     if (!isObjectObject(a) || !isObjectObject(b)) return false;
@@ -507,18 +569,18 @@ export function isEqual(a, b)
 
     if (aKeys.length !== bKeys.length) return false;
 
-    for (let i = 0; i < aKeys.length; i++)
-    {
-        let key = aKeys[i];
-        if (!Object.prototype.hasOwnProperty.call(b, key)) return false;
-        if (!isEqual(a[key], b[key])) return false;
+    for (let i = 0; i < aKeys.length; i++)
+    {
+        let key = aKeys[i];
+        if (!Object.prototype.hasOwnProperty.call(b, key)) return false;
+        if (!isEqual(a[key], b[key])) return false;
     }
-
-    return true;
-}
-
-// Neutral runtime-utils spellings preserve the established core predicates.
-export const isNullish = isNoU;
-export const isPlainObject = isPlain;
-export const isPromiseLike = isPromise;
-export const isTypedArray = isTyped;
+
+    return true;
+}
+
+// Neutral runtime-utils spellings preserve the established core predicates.
+export const isNullish = isNoU;
+export const isPlainObject = isPlain;
+export const isPromiseLike = isPromise;
+export const isTypedArray = isTyped;

package/src/json.js

@@ -1,23 +1,23 @@
-import { decodeUtf8, encodeUtf8 } from "./text.js";
-
-/** Encodes JSON with explicit indentation and trailing-newline behavior. */
-export function encodeJson(value, options = {})
-{
-    const space = options.space ?? 2;
-    const text = JSON.stringify(value, options.replacer ?? null, space);
-
-    if (text === undefined)
-    {
-        throw new TypeError("JSON input is not serializable as a top-level value.");
-    }
-
-    return encodeUtf8(options.trailingNewline === false ? text : `${text}\n`);
-}
-
-/** Decodes JSON from a string or UTF-8 byte input. */
-export function decodeJson(value, options = {})
-{
-    const text = typeof value === "string" ? value : decodeUtf8(value, options);
-
-    return JSON.parse(text, options.reviver);
-}
+import { decodeUtf8, encodeUtf8 } from "./text.js";
+
+/** Encodes JSON with explicit indentation and trailing-newline behavior. */
+export function encodeJson(value, options = {})
+{
+    const space = options.space ?? 2;
+    const text = JSON.stringify(value, options.replacer ?? null, space);
+
+    if (text === undefined)
+    {
+        throw new TypeError("JSON input is not serializable as a top-level value.");
+    }
+
+    return encodeUtf8(options.trailingNewline === false ? text : `${text}\n`);
+}
+
+/** Decodes JSON from a string or UTF-8 byte input. */
+export function decodeJson(value, options = {})
+{
+    const text = typeof value === "string" ? value : decodeUtf8(value, options);
+
+    return JSON.parse(text, options.reviver);
+}

package/src/lifecycle/CjsLifecycleState.js

@@ -1,77 +1,77 @@
-import { ensureRuntimeState, getRuntimeState } from "../runtime/CjsRuntimeState.js";
-
-export const CJS_LIFECYCLE = Object.freeze({
-    ALIVE: "alive",
-    DESTROY_PENDING: "destroyPending",
-    DESTROYING: "destroying",
-    DESTROYED: "destroyed"
-});
-
-/** Inspectable lifecycle state shared by participating runtime objects. */
-export class CjsLifecycleState
-{
-
-    status = CJS_LIFECYCLE.ALIVE;
-
-    Is(status)
-    {
-        return this.status === status;
-    }
-
-    IsAlive()
-    {
-        return this.Is(CJS_LIFECYCLE.ALIVE);
-    }
-
-    IsAvailable()
-    {
-        return this.IsAlive();
-    }
-
-}
-
-/**
- * Installs shared, non-enumerable lifecycle state on an object.
- *
- * @param {object|Function} target
- * @returns {CjsLifecycleState}
- */
-export function initializeLifecycleState(target)
-{
-    const state = ensureRuntimeState(target);
-    if (Object.prototype.hasOwnProperty.call(state, "lifecycle"))
-    {
-        if (!(state.lifecycle instanceof CjsLifecycleState))
-        {
-            throw new TypeError("Existing __state.lifecycle must be a CjsLifecycleState.");
-        }
-        return state.lifecycle;
-    }
-
-    const lifecycle = new CjsLifecycleState();
-    Object.defineProperty(state, "lifecycle", {
-        value: lifecycle,
-        enumerable: true,
-        configurable: false,
-        writable: false
-    });
-    return lifecycle;
-}
-
-/**
- * Gets lifecycle state without enrolling the target in lifecycle management.
- *
- * An absent state means the target is ordinarily alive and unmanaged.
- *
- * @param {object|Function} target
- * @returns {CjsLifecycleState|null}
- */
-export function getLifecycleState(target)
-{
-    const lifecycle = getRuntimeState(target)?.lifecycle ?? null;
-    if (lifecycle !== null && !(lifecycle instanceof CjsLifecycleState))
-    {
-        throw new TypeError("Existing __state.lifecycle must be a CjsLifecycleState.");
-    }
-    return lifecycle;
-}
+import { ensureRuntimeState, getRuntimeState } from "../runtime/CjsRuntimeState.js";
+
+export const CJS_LIFECYCLE = Object.freeze({
+    ALIVE: "alive",
+    DESTROY_PENDING: "destroyPending",
+    DESTROYING: "destroying",
+    DESTROYED: "destroyed"
+});
+
+/** Inspectable lifecycle state shared by participating runtime objects. */
+export class CjsLifecycleState
+{
+
+    status = CJS_LIFECYCLE.ALIVE;
+
+    Is(status)
+    {
+        return this.status === status;
+    }
+
+    IsAlive()
+    {
+        return this.Is(CJS_LIFECYCLE.ALIVE);
+    }
+
+    IsAvailable()
+    {
+        return this.IsAlive();
+    }
+
+}
+
+/**
+ * Installs shared, non-enumerable lifecycle state on an object.
+ *
+ * @param {object|Function} target
+ * @returns {CjsLifecycleState}
+ */
+export function initializeLifecycleState(target)
+{
+    const state = ensureRuntimeState(target);
+    if (Object.prototype.hasOwnProperty.call(state, "lifecycle"))
+    {
+        if (!(state.lifecycle instanceof CjsLifecycleState))
+        {
+            throw new TypeError("Existing __state.lifecycle must be a CjsLifecycleState.");
+        }
+        return state.lifecycle;
+    }
+
+    const lifecycle = new CjsLifecycleState();
+    Object.defineProperty(state, "lifecycle", {
+        value: lifecycle,
+        enumerable: true,
+        configurable: false,
+        writable: false
+    });
+    return lifecycle;
+}
+
+/**
+ * Gets lifecycle state without enrolling the target in lifecycle management.
+ *
+ * An absent state means the target is ordinarily alive and unmanaged.
+ *
+ * @param {object|Function} target
+ * @returns {CjsLifecycleState|null}
+ */
+export function getLifecycleState(target)
+{
+    const lifecycle = getRuntimeState(target)?.lifecycle ?? null;
+    if (lifecycle !== null && !(lifecycle instanceof CjsLifecycleState))
+    {
+        throw new TypeError("Existing __state.lifecycle must be a CjsLifecycleState.");
+    }
+    return lifecycle;
+}

package/src/lifecycle/index.js

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

package/src/lne3.js

@@ -90,9 +90,9 @@ lne3.closestPointToPointParameter = function(a, point, clampToLine)
     startEnd[1] = a[4] - a[1];
     startEnd[2] = a[5] - a[2];
 
-    let startEnd2 = startEnd[0] * startEnd[0] + startEnd[1] * startEnd[1] + startEnd[2] * startEnd[2],
-        startEnd_startP = startEnd[0] * startP[0] + startEnd[1] * startP[1] + startEnd[2] * startP[2],
-        t = startEnd2 === 0 ? 0 : startEnd_startP / startEnd2;
+    let startEnd2 = startEnd[0] * startEnd[0] + startEnd[1] * startEnd[1] + startEnd[2] * startEnd[2],
+        startEnd_startP = startEnd[0] * startP[0] + startEnd[1] * startP[1] + startEnd[2] * startP[2],
+        t = startEnd2 === 0 ? 0 : startEnd_startP / startEnd2;
 
     vec3.unalloc(startP);
     vec3.unalloc(startEnd);
@@ -186,7 +186,7 @@ lne3.equalsStartEnd = box3.equalsBounds;
  * @param {lne3} b
  * @returns {boolean}
  */
-lne3.exactEquals = box3.exactEquals;
+lne3.exactEquals = box3.exactEquals;
 
 /**
  * Checks for exact equality between a lne3 and components
@@ -271,13 +271,13 @@ lne3.getCenter = function(out, a)
  * @param {boolean} clampToLine - optional setting to clamp the result to a line segment
  * @returns {vec3} out          - receiving vec3
  */
-lne3.getClosestPointToPoint = function(out, a, point, clampToLine)
-{
-    const t = lne3.closestPointToPointParameter(a, point, clampToLine);
-    out[0] = (a[3] - a[0]) * t + a[0];
-    out[1] = (a[4] - a[1]) * t + a[1];
-    out[2] = (a[5] - a[2]) * t + a[2];
-    return out;
+lne3.getClosestPointToPoint = function(out, a, point, clampToLine)
+{
+    const t = lne3.closestPointToPointParameter(a, point, clampToLine);
+    out[0] = (a[3] - a[0]) * t + a[0];
+    out[1] = (a[4] - a[1]) * t + a[1];
+    out[2] = (a[5] - a[2]) * t + a[2];
+    return out;
 };
 
 /**
@@ -327,8 +327,8 @@ lne3.intersectsNormalConstant = function(a, n, c)
         startSign = (n[0] * a[0] + n[1] * a[1] + n[2] * a[2]) + c,
         endSign = (n[0] * a[3] + n[1] * a[4] + n[2] * a[5]) + c;
 
-    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);
 };
 
 /**
@@ -417,27 +417,27 @@ lne3.setEnd = box3.setMaxBounds;
  * @param {mat4} m
  * @returns {lne3} out
  */
-lne3.transformMat4 = function(out, a, m)
-{
+lne3.transformMat4 = function(out, a, m)
+{
     let ax = a[0],
         ay = a[1],
         az = a[2],
         bx = a[3],
-        by = a[4],
-        bz = a[5],
-        aw = m[3] * ax + m[7] * ay + m[11] * az + m[15],
-        bw = m[3] * bx + m[7] * by + m[11] * bz + m[15];
-
-    aw = aw || 1;
-    bw = bw || 1;
-
-    out[0] = (m[0] * ax + m[4] * ay + m[8] * az + m[12]) / aw;
-    out[1] = (m[1] * ax + m[5] * ay + m[9] * az + m[13]) / aw;
-    out[2] = (m[2] * ax + m[6] * ay + m[10] * az + m[14]) / aw;
-
-    out[3] = (m[0] * bx + m[4] * by + m[8] * bz + m[12]) / bw;
-    out[4] = (m[1] * bx + m[5] * by + m[9] * bz + m[13]) / bw;
-    out[5] = (m[2] * bx + m[6] * by + m[10] * bz + m[14]) / bw;
+        by = a[4],
+        bz = a[5],
+        aw = m[3] * ax + m[7] * ay + m[11] * az + m[15],
+        bw = m[3] * bx + m[7] * by + m[11] * bz + m[15];
+
+    aw = aw || 1;
+    bw = bw || 1;
+
+    out[0] = (m[0] * ax + m[4] * ay + m[8] * az + m[12]) / aw;
+    out[1] = (m[1] * ax + m[5] * ay + m[9] * az + m[13]) / aw;
+    out[2] = (m[2] * ax + m[6] * ay + m[10] * az + m[14]) / aw;
+
+    out[3] = (m[0] * bx + m[4] * by + m[8] * bz + m[12]) / bw;
+    out[4] = (m[1] * bx + m[5] * by + m[9] * bz + m[13]) / bw;
+    out[5] = (m[2] * bx + m[6] * by + m[10] * bz + m[14]) / bw;
 
     return out;
 };
@@ -450,48 +450,48 @@ lne3.transformMat4 = function(out, a, m)
  * @param {vec3} v
  * @returns {lne3} out
  */
-lne3.translate = function(out, a, v)
-{
+lne3.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] + v[0];
     out[4] = a[4] + v[1];
-    out[5] = a[5] + v[2];
-    return out;
-};
-
-export const {
-    alloc,
-    unalloc,
-    $end,
-    $start,
-    clone,
-    closestPointToPointParameter,
-    copy,
-    copyStart,
-    copyEnd,
-    create,
-    equals,
-    equalsStartEnd,
-    exactEquals,
-    exactEqualsStartEnd,
-    fromArray,
-    fromStartEnd,
-    get,
-    getCenter,
-    getClosestPointToPoint,
-    getEnd,
-    getDelta,
-    getStart,
-    intersectsNormalConstant,
-    length,
-    set,
-    squaredLength,
-    toArray,
-    toStartEnd,
-    setStart,
-    setEnd,
-    transformMat4,
-    translate
-} = lne3;
+    out[5] = a[5] + v[2];
+    return out;
+};
+
+export const {
+    alloc,
+    unalloc,
+    $end,
+    $start,
+    clone,
+    closestPointToPointParameter,
+    copy,
+    copyStart,
+    copyEnd,
+    create,
+    equals,
+    equalsStartEnd,
+    exactEquals,
+    exactEqualsStartEnd,
+    fromArray,
+    fromStartEnd,
+    get,
+    getCenter,
+    getClosestPointToPoint,
+    getEnd,
+    getDelta,
+    getStart,
+    intersectsNormalConstant,
+    length,
+    set,
+    squaredLength,
+    toArray,
+    toStartEnd,
+    setStart,
+    setEnd,
+    transformMat4,
+    translate
+} = lne3;