@carbonenginejs/runtime-utils 0.1.1 → 0.1.3

package/src/bytes.js

@@ -1,56 +1,56 @@
-/** Returns a zero-copy Uint8Array view over supported byte input. */
-export function asUint8Array(value, label = "value")
-{
-    if (value instanceof Uint8Array)
-    {
-        return value;
-    }
-
-    if (value instanceof ArrayBuffer)
-    {
-        return new Uint8Array(value);
-    }
-
-    if (ArrayBuffer.isView(value))
-    {
-        return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
-    }
-
-    throw new TypeError(`${label} must be a Uint8Array, ArrayBuffer, or ArrayBuffer view.`);
-}
-
-/** Returns an owned copy of supported byte input. */
-export function copyBytes(value, label = "value")
-{
-    return asUint8Array(value, label).slice();
-}
-
-/** Copies exactly the visible byte range into a standalone ArrayBuffer. */
-export function toArrayBuffer(value, label = "value")
-{
-    const bytes = asUint8Array(value, label);
-
-    return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
-}
-
-/** Tests whether byte input starts with the complete supplied prefix. */
-export function hasBytePrefix(value, prefix)
-{
-    const bytes = asUint8Array(value, "value");
-    const expected = asUint8Array(prefix, "prefix");
-
-    if (bytes.byteLength < expected.byteLength)
-    {
-        return false;
-    }
-
-    for (let index = 0; index < expected.byteLength; index++)
-    {
-        if (bytes[index] !== expected[index])
-        {
-            return false;
-        }
-    }
-
-    return true;
-}
+/** Returns a zero-copy Uint8Array view over supported byte input. */
+export function asUint8Array(value, label = "value")
+{
+    if (value instanceof Uint8Array)
+    {
+        return value;
+    }
+
+    if (value instanceof ArrayBuffer)
+    {
+        return new Uint8Array(value);
+    }
+
+    if (ArrayBuffer.isView(value))
+    {
+        return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+    }
+
+    throw new TypeError(`${label} must be a Uint8Array, ArrayBuffer, or ArrayBuffer view.`);
+}
+
+/** Returns an owned copy of supported byte input. */
+export function copyBytes(value, label = "value")
+{
+    return asUint8Array(value, label).slice();
+}
+
+/** Copies exactly the visible byte range into a standalone ArrayBuffer. */
+export function toArrayBuffer(value, label = "value")
+{
+    const bytes = asUint8Array(value, label);
+
+    return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+}
+
+/** Tests whether byte input starts with the complete supplied prefix. */
+export function hasBytePrefix(value, prefix)
+{
+    const bytes = asUint8Array(value, "value");
+    const expected = asUint8Array(prefix, "prefix");
+
+    if (bytes.byteLength < expected.byteLength)
+    {
+        return false;
+    }
+
+    for (let index = 0; index < expected.byteLength; index++)
+    {
+        if (bytes[index] !== expected[index])
+        {
+            return false;
+        }
+    }
+
+    return true;
+}

package/src/compression.js

@@ -1,56 +1,56 @@
-import { asUint8Array, hasBytePrefix } from "./bytes.js";
-
-const GZIP_PREFIX = new Uint8Array([ 0x1f, 0x8b ]);
-
-/** Returns whether byte input has the gzip magic prefix. */
-export function isGzip(value)
-{
-    return hasBytePrefix(value, GZIP_PREFIX);
-}
-
-/** Decompresses bytes with the platform DecompressionStream API. */
-export async function decompressBytes(value, format, options = {})
-{
-    const DecompressionStreamClass = Object.hasOwn(options, "decompressionStreamClass")
-        ? options.decompressionStreamClass
-        : globalThis.DecompressionStream;
-    const ResponseClass = Object.hasOwn(options, "responseClass")
-        ? options.responseClass
-        : globalThis.Response;
-
-    if (typeof DecompressionStreamClass !== "function" || typeof ResponseClass !== "function")
-    {
-        const error = new Error(
-            `DecompressionStream support for ${JSON.stringify(format)} is unavailable in this environment.`
-        );
-
-        error.code = "CJS_DECOMPRESSION_UNSUPPORTED";
-        throw error;
-    }
-
-    const source = new ResponseClass(asUint8Array(value, "compressed input"));
-
-    if (!source.body)
-    {
-        throw new Error("The platform Response did not expose a readable byte stream.");
-    }
-
-    const stream = source.body.pipeThrough(new DecompressionStreamClass(String(format)));
-    const output = await new ResponseClass(stream).arrayBuffer();
-
-    return new Uint8Array(output);
-}
-
-/** Decompresses one gzip byte sequence. */
-export function decompressGzip(value, options = {})
-{
-    return decompressBytes(value, "gzip", options);
-}
-
-/** Decompresses gzip input and returns an unchanged view for plain bytes. */
-export function decompressGzipIfNeeded(value, options = {})
-{
-    const bytes = asUint8Array(value, "input");
-
-    return isGzip(bytes) ? decompressGzip(bytes, options) : Promise.resolve(bytes);
-}
+import { asUint8Array, hasBytePrefix } from "./bytes.js";
+
+const GZIP_PREFIX = new Uint8Array([ 0x1f, 0x8b ]);
+
+/** Returns whether byte input has the gzip magic prefix. */
+export function isGzip(value)
+{
+    return hasBytePrefix(value, GZIP_PREFIX);
+}
+
+/** Decompresses bytes with the platform DecompressionStream API. */
+export async function decompressBytes(value, format, options = {})
+{
+    const DecompressionStreamClass = Object.hasOwn(options, "decompressionStreamClass")
+        ? options.decompressionStreamClass
+        : globalThis.DecompressionStream;
+    const ResponseClass = Object.hasOwn(options, "responseClass")
+        ? options.responseClass
+        : globalThis.Response;
+
+    if (typeof DecompressionStreamClass !== "function" || typeof ResponseClass !== "function")
+    {
+        const error = new Error(
+            `DecompressionStream support for ${JSON.stringify(format)} is unavailable in this environment.`
+        );
+
+        error.code = "CJS_DECOMPRESSION_UNSUPPORTED";
+        throw error;
+    }
+
+    const source = new ResponseClass(asUint8Array(value, "compressed input"));
+
+    if (!source.body)
+    {
+        throw new Error("The platform Response did not expose a readable byte stream.");
+    }
+
+    const stream = source.body.pipeThrough(new DecompressionStreamClass(String(format)));
+    const output = await new ResponseClass(stream).arrayBuffer();
+
+    return new Uint8Array(output);
+}
+
+/** Decompresses one gzip byte sequence. */
+export function decompressGzip(value, options = {})
+{
+    return decompressBytes(value, "gzip", options);
+}
+
+/** Decompresses gzip input and returns an unchanged view for plain bytes. */
+export function decompressGzipIfNeeded(value, options = {})
+{
+    const bytes = asUint8Array(value, "input");
+
+    return isGzip(bytes) ? decompressGzip(bytes, options) : Promise.resolve(bytes);
+}

package/src/constants/index.js

@@ -1,7 +1,7 @@
-export * from "../media/index.js";
-export * from "../graphics/index.js";
-export * from "../audio/index.js";
-export * from "../shader/index.js";
-export * from "../d3d/index.js";
-export * from "../webgpu/index.js";
-export * from "./trinity.js";
+export * from "../media/index.js";
+export * from "../graphics/index.js";
+export * from "../audio/index.js";
+export * from "../shader/index.js";
+export * from "../d3d/index.js";
+export * from "../webgpu/index.js";
+export * from "./trinity.js";

package/src/constants/trinity.js

@@ -1,13 +1,13 @@
-// Source: trinity/trinity/Resources/Tr2LodResource.h
-
-/**
- * Shared Trinity level-of-detail values.
- */
-export const Tr2Lod = Object.freeze({
-    TR2_LOD_UNSPECIFIED: -1,
-    TR2_LOD_LOW: 0,
-    TR2_LOD_MEDIUM: 1,
-    TR2_LOD_HIGH: 2,
-    TR2_LOD_ULTRA: 3,
-    TR2_LOD_COUNT: 4
-});
+// Source: trinity/trinity/Resources/Tr2LodResource.h
+
+/**
+ * Shared Trinity level-of-detail values.
+ */
+export const Tr2Lod = Object.freeze({
+    TR2_LOD_UNSPECIFIED: -1,
+    TR2_LOD_LOW: 0,
+    TR2_LOD_MEDIUM: 1,
+    TR2_LOD_HIGH: 2,
+    TR2_LOD_ULTRA: 3,
+    TR2_LOD_COUNT: 4
+});

package/src/constants.js

@@ -1,15 +1,15 @@
-/**
- * Small WebGL numeric constants used by the typed-array pool helpers.
- *
- * These stay local to keep the math subpaths independently browser-friendly:
- * importing the old ccpwgl `constant` alias would pull the package back toward
- * an application-specific module graph.
- */
-
-export const GL_BYTE = 5120;
-export const GL_UNSIGNED_BYTE = 5121;
-export const GL_SHORT = 5122;
-export const GL_UNSIGNED_SHORT = 5123;
-export const GL_INT = 5124;
-export const GL_UNSIGNED_INT = 5125;
-export const GL_FLOAT = 5126;
+/**
+ * Small WebGL numeric constants used by the typed-array pool helpers.
+ *
+ * These stay local to keep the math subpaths independently browser-friendly:
+ * importing the old ccpwgl `constant` alias would pull the package back toward
+ * an application-specific module graph.
+ */
+
+export const GL_BYTE = 5120;
+export const GL_UNSIGNED_BYTE = 5121;
+export const GL_SHORT = 5122;
+export const GL_UNSIGNED_SHORT = 5123;
+export const GL_INT = 5124;
+export const GL_UNSIGNED_INT = 5125;
+export const GL_FLOAT = 5126;

package/src/curve.js

@@ -13,42 +13,42 @@ export const curve = {};
  * @param {Boolean} cycle
  * @param {number} duration
  */
-curve.evaluate = function(curve, time, value, cycle, duration)
-{
-    let count = curve.knots.length;
-    if (!count || !curve.dimension || !curve.controls.length) return value;
-
-    const lastKnot = curve.knots[count - 1];
-    if (cycle)
-    {
-        duration = duration > 0 ? duration : lastKnot;
-        if (duration > 0)
-        {
-            time = ((time % duration) + duration) % duration;
-        }
-    }
-    else if (time <= curve.knots[0] || time >= lastKnot)
-    {
-        const control = time <= curve.knots[0] ? 0 : count - 1;
-        for (let i = 0; i < curve.dimension; ++i)
-        {
-            value[i] = curve.controls[control * curve.dimension + i];
-        }
-        return value;
-    }
-
-    let knot = count - 1;
-    let t = 0;
-    if (cycle && (time < curve.knots[0] || time >= lastKnot))
-    {
-        knot = 0;
-    }
-    else for (let i = 0; i < curve.knots.length; ++i)
-    {
-        if (curve.knots[i] > time)
-        {
-            knot = i;
-            break;
+curve.evaluate = function(curve, time, value, cycle, duration)
+{
+    let count = curve.knots.length;
+    if (!count || !curve.dimension || !curve.controls.length) return value;
+
+    const lastKnot = curve.knots[count - 1];
+    if (cycle)
+    {
+        duration = duration > 0 ? duration : lastKnot;
+        if (duration > 0)
+        {
+            time = ((time % duration) + duration) % duration;
+        }
+    }
+    else if (time <= curve.knots[0] || time >= lastKnot)
+    {
+        const control = time <= curve.knots[0] ? 0 : count - 1;
+        for (let i = 0; i < curve.dimension; ++i)
+        {
+            value[i] = curve.controls[control * curve.dimension + i];
+        }
+        return value;
+    }
+
+    let knot = count - 1;
+    let t = 0;
+    if (cycle && (time < curve.knots[0] || time >= lastKnot))
+    {
+        knot = 0;
+    }
+    else for (let i = 0; i < curve.knots.length; ++i)
+    {
+        if (curve.knots[i] > time)
+        {
+            knot = i;
+            break;
         }
     }
 
@@ -59,32 +59,32 @@ curve.evaluate = function(curve, time, value, cycle, duration)
             value[i] = curve.controls[knot * curve.dimension + i];
         }
     }
-    else if (curve.degree === 1)
-    {
-        const knot0 = cycle ? (knot + count - 1) % count : knot === 0 ? 0 : knot - 1;
-        let
-            start = curve.knots[knot0],
-            end = curve.knots[knot],
-            localTime = time;
-
-        if (cycle && end < start)
-        {
-            end += duration;
-        }
-        if (cycle && localTime < start)
-        {
-            localTime += duration;
-        }
-        t = end !== start ? (localTime - start) / (end - start) : 0;
-
-        for (let i = 0; i < curve.dimension; ++i)
+    else if (curve.degree === 1)
+    {
+        const knot0 = cycle ? (knot + count - 1) % count : knot === 0 ? 0 : knot - 1;
+        let
+            start = curve.knots[knot0],
+            end = curve.knots[knot],
+            localTime = time;
+
+        if (cycle && end < start)
+        {
+            end += duration;
+        }
+        if (cycle && localTime < start)
+        {
+            localTime += duration;
+        }
+        t = end !== start ? (localTime - start) / (end - start) : 0;
+
+        for (let i = 0; i < curve.dimension; ++i)
         {
             value[i] = curve.controls[knot0 * curve.dimension + i] * (1 - t) + curve.controls[knot * curve.dimension + i] * t;
         }
     }
-    else
-    {
-        let k_2 = cycle ? (knot + count - 2) % count : knot === 0 ? 0 : Math.max(0, knot - 2);
+    else
+    {
+        let k_2 = cycle ? (knot + count - 2) % count : knot === 0 ? 0 : Math.max(0, knot - 2);
         let k_1 = cycle ? (knot + count - 1) % count : knot === 0 ? 0 : knot - 1;
 
         let p1 = (k_2) * curve.dimension;
@@ -121,9 +121,9 @@ curve.evaluate = function(curve, time, value, cycle, duration)
         let dL1_1 = ti - ti_2;
         let dL1_2 = ti1 - ti_1;
 
-        let L0 = dL0 !== 0 ? tmti_1 / dL0 : 0;
-        let L1_1 = dL1_1 !== 0 ? tmti_2 / dL1_1 : 0;
-        let L1_2 = dL1_2 !== 0 ? tmti_1 / dL1_2 : 0;
+        let L0 = dL0 !== 0 ? tmti_1 / dL0 : 0;
+        let L1_1 = dL1_1 !== 0 ? tmti_2 / dL1_1 : 0;
+        let L1_2 = dL1_2 !== 0 ? tmti_1 / dL1_2 : 0;
 
         let ci_2 = (L1_1 + L0) - L0 * L1_1;
         let ci = L0 * L1_2;
@@ -132,11 +132,11 @@ curve.evaluate = function(curve, time, value, cycle, duration)
 
         for (let i = 0; i < curve.dimension; ++i)
         {
-            value[i] = ci_2 * curve.controls[p1 + i] + ci_1 * curve.controls[p2 + i] + ci * curve.controls[p3 + i];
-        }
-    }
-    return value;
-};
+            value[i] = ci_2 * curve.controls[p1 + i] + ci_1 * curve.controls[p2 + i] + ci * curve.controls[p3 + i];
+        }
+    }
+    return value;
+};
 
 /**
  * ag_horner1
@@ -294,8 +294,8 @@ curve.ag_zeroin = function(a, b, tol, pars)
  * @param Roots
  * @returns {*}
  */
-curve.polyZeroes = function(Poly, deg, a, a_closed, b, b_closed, Roots)
-{
+curve.polyZeroes = function(Poly, deg, a, a_closed, b, b_closed, Roots)
+{
     let i, left_ok, right_ok, nr, ndr, skip;
 
     let e, f, s, pe, ps, tol, p, p_x = new Array(22),
@@ -406,14 +406,14 @@ curve.polyZeroes = function(Poly, deg, a, a_closed, b, b_closed, Roots)
             }
         }
     }
-
-    return (nr);
-};
-
-export const {
-    evaluate,
-    ag_horner1,
-    ag_zeroin2,
-    ag_zeroin,
-    polyZeroes
-} = curve;
+
+    return (nr);
+};
+
+export const {
+    evaluate,
+    ag_horner1,
+    ag_zeroin2,
+    ag_zeroin,
+    polyZeroes
+} = curve;

package/src/d3d/dxgiFormats.js

@@ -1,46 +1,46 @@
-/**
- * Small DXGI_FORMAT numeric mirror for formats currently needed by readers.
- *
- * Values match the public DXGI_FORMAT enum.
- */
-export const DxgiFormat = Object.freeze({
-    UNKNOWN: 0,
-    R32G32B32A32_FLOAT: 2,
-    R32G32_FLOAT: 16,
-    R32_FLOAT: 41,
-    R16G16B16A16_FLOAT: 10,
-    R8G8_UNORM: 49,
-    R8G8B8A8_UNORM: 28,
-    R8G8B8A8_UNORM_SRGB: 29,
-    R16_FLOAT: 54,
-    R8_UNORM: 61,
-    BC1_UNORM: 71,
-    BC1_UNORM_SRGB: 72,
-    BC2_UNORM: 74,
-    BC2_UNORM_SRGB: 75,
-    BC3_UNORM: 77,
-    BC3_UNORM_SRGB: 78,
-    BC4_UNORM: 80,
-    BC4_SNORM: 81,
-    BC5_UNORM: 83,
-    BC5_SNORM: 84,
-    B8G8R8A8_UNORM: 87,
-    B8G8R8X8_UNORM: 88,
-    B8G8R8A8_UNORM_SRGB: 91,
-    B8G8R8X8_UNORM_SRGB: 93,
-    BC6H_UF16: 95,
-    BC6H_SF16: 96,
-    BC7_UNORM: 98,
-    BC7_UNORM_SRGB: 99
-});
-
-/**
- * Normalize a DXGI numeric value.
- *
- * @param {number} value Candidate DXGI value.
- * @returns {number} Integer DXGI value or UNKNOWN.
- */
-export function normalizeDxgiFormat(value)
-{
-    return Number.isInteger(value) ? value : DxgiFormat.UNKNOWN;
-}
+/**
+ * Small DXGI_FORMAT numeric mirror for formats currently needed by readers.
+ *
+ * Values match the public DXGI_FORMAT enum.
+ */
+export const DxgiFormat = Object.freeze({
+    UNKNOWN: 0,
+    R32G32B32A32_FLOAT: 2,
+    R32G32_FLOAT: 16,
+    R32_FLOAT: 41,
+    R16G16B16A16_FLOAT: 10,
+    R8G8_UNORM: 49,
+    R8G8B8A8_UNORM: 28,
+    R8G8B8A8_UNORM_SRGB: 29,
+    R16_FLOAT: 54,
+    R8_UNORM: 61,
+    BC1_UNORM: 71,
+    BC1_UNORM_SRGB: 72,
+    BC2_UNORM: 74,
+    BC2_UNORM_SRGB: 75,
+    BC3_UNORM: 77,
+    BC3_UNORM_SRGB: 78,
+    BC4_UNORM: 80,
+    BC4_SNORM: 81,
+    BC5_UNORM: 83,
+    BC5_SNORM: 84,
+    B8G8R8A8_UNORM: 87,
+    B8G8R8X8_UNORM: 88,
+    B8G8R8A8_UNORM_SRGB: 91,
+    B8G8R8X8_UNORM_SRGB: 93,
+    BC6H_UF16: 95,
+    BC6H_SF16: 96,
+    BC7_UNORM: 98,
+    BC7_UNORM_SRGB: 99
+});
+
+/**
+ * Normalize a DXGI numeric value.
+ *
+ * @param {number} value Candidate DXGI value.
+ * @returns {number} Integer DXGI value or UNKNOWN.
+ */
+export function normalizeDxgiFormat(value)
+{
+    return Number.isInteger(value) ? value : DxgiFormat.UNKNOWN;
+}

package/src/d3d/index.js

@@ -1,2 +1,2 @@
-export * from "./dxgiFormats.js";
-export * from "./primitiveTopology.js";
+export * from "./dxgiFormats.js";
+export * from "./primitiveTopology.js";

package/src/d3d/primitiveTopology.js

@@ -1,11 +1,11 @@
-/**
- * D3D primitive topology numeric mirror for common geometry payloads.
- */
-export const D3dPrimitiveTopology = Object.freeze({
-    UNDEFINED: 0,
-    POINTLIST: 1,
-    LINELIST: 2,
-    LINESTRIP: 3,
-    TRIANGLELIST: 4,
-    TRIANGLESTRIP: 5
-});
+/**
+ * D3D primitive topology numeric mirror for common geometry payloads.
+ */
+export const D3dPrimitiveTopology = Object.freeze({
+    UNDEFINED: 0,
+    POINTLIST: 1,
+    LINELIST: 2,
+    LINESTRIP: 3,
+    TRIANGLELIST: 4,
+    TRIANGLESTRIP: 5
+});