@carbonenginejs/runtime-resource 0.12.1 → 0.13.0

package/dist/formats/cmf/core/binary.js

@@ -1,194 +1,194 @@
-const textDecoder = new TextDecoder();
-
-/** Returns a byte view over the supplied binary input for the CMF binary reader. */
-function asUint8Array(input) {
-  if (input instanceof Uint8Array) {
-    return input;
-  }
-  if (input instanceof ArrayBuffer) {
-    return new Uint8Array(input);
-  }
-  if (ArrayBuffer.isView(input)) {
-    return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
-  }
-  throw new TypeError("CMF input must be a Uint8Array, Buffer, ArrayBuffer, or typed-array view");
-}
-
-/**
- * Bounds-checked little-endian offset reader over CMF file bytes, including
- * 64-bit integer reads guarded against unsafe values.
- */
-class BinaryReader {
-  /** Creates a BinaryReader over caller-provided CMF bytes and reader options. */
-  constructor(bytes) {
-    this.bytes = asUint8Array(bytes);
-    this.view = new DataView(this.bytes.buffer, this.bytes.byteOffset, this.bytes.byteLength);
-  }
-
-  /**
-   * Validates the supplied value against CMF binary reader constraints and
-   * throws on failure.
-   */
-  require(offset, size, label = "read") {
-    if (!Number.isInteger(offset) || offset < 0 || offset + size > this.bytes.byteLength) {
-      throw new RangeError(`CMF ${label} is outside file bounds`);
-    }
-  }
-
-  /**
-   * Reads an unsigned 8-bit integer at the requested offset for the CMF binary
-   * reader.
-   */
-  u8(offset) {
-    this.require(offset, 1);
-    return this.view.getUint8(offset);
-  }
-
-  /**
-   * Reads an unsigned 16-bit little-endian integer at the requested offset for
-   * the CMF binary reader.
-   */
-  u16(offset) {
-    this.require(offset, 2);
-    return this.view.getUint16(offset, true);
-  }
-
-  /**
-   * Reads an unsigned 32-bit little-endian integer at the requested offset for
-   * the CMF binary reader.
-   */
-  u32(offset) {
-    this.require(offset, 4);
-    return this.view.getUint32(offset, true);
-  }
-
-  /**
-   * Reads a signed 32-bit little-endian integer at the requested offset for
-   * the CMF binary reader.
-   */
-  i32(offset) {
-    this.require(offset, 4);
-    return this.view.getInt32(offset, true);
-  }
-
-  /**
-   * Reads a 32-bit little-endian float at the requested offset for the CMF
-   * binary reader.
-   */
-  f32(offset) {
-    this.require(offset, 4);
-    return this.view.getFloat32(offset, true);
-  }
-
-  /**
-   * Reads a safe unsigned 64-bit little-endian integer at the requested offset
-   * for the CMF binary reader.
-   */
-  u64(offset) {
-    this.require(offset, 8);
-    const value = this.view.getBigUint64(offset, true);
-    if (value > BigInt(Number.MAX_SAFE_INTEGER)) {
-      throw new RangeError("CMF integer is larger than Number.MAX_SAFE_INTEGER");
-    }
-    return Number(value);
-  }
-
-  /**
-   * Reads a safe signed 64-bit little-endian integer at the requested offset
-   * for the CMF binary reader.
-   */
-  i64(offset) {
-    this.require(offset, 8);
-    const value = this.view.getBigInt64(offset, true);
-    if (value > BigInt(Number.MAX_SAFE_INTEGER) || value < BigInt(Number.MIN_SAFE_INTEGER)) {
-      throw new RangeError("CMF integer is outside the safe JavaScript number range");
-    }
-    return Number(value);
-  }
-
-  /**
-   * Returns a bounds-checked byte slice at the requested offset for the CMF
-   * binary reader.
-   */
-  bytesAt(offset, size) {
-    this.require(offset, size, "byte slice");
-    return this.bytes.subarray(offset, offset + size);
-  }
-
-  /** Decodes a UTF-8 string at the requested offset for the CMF binary reader. */
-  string(offset, byteSize) {
-    if (byteSize === 0) {
-      return "";
-    }
-    return textDecoder.decode(this.bytesAt(offset, byteSize));
-  }
-}
-
-/**
- * Returns the symbolic enum name or an unknown-value label for the CMF binary
- * reader.
- */
-function enumName(names, value) {
-  return names[value] ?? `Unknown(${value})`;
-}
-
-/** Reads a three-component vector from the CMF input for the CMF binary reader. */
-function readVector3(reader, offset) {
-  return [reader.f32(offset), reader.f32(offset + 4), reader.f32(offset + 8)];
-}
-
-/**
- * Reads a four-component quaternion from the CMF input for the CMF binary
- * reader.
- */
-function readQuaternion(reader, offset) {
-  return [reader.f32(offset), reader.f32(offset + 4), reader.f32(offset + 8), reader.f32(offset + 12)];
-}
-
-/** Reads a 4-by-4 matrix from the CMF input for the CMF binary reader. */
-function readMatrix(reader, offset) {
-  const values = [];
-  for (let i = 0; i < 16; i++) {
-    values.push(reader.f32(offset + i * 4));
-  }
-  return values;
-}
-
-/** Reads minimum and maximum bounds from the CMF input for the CMF binary reader. */
-function readBounds(reader, offset) {
-  return {
-    min: readVector3(reader, offset),
-    max: readVector3(reader, offset + 12)
-  };
-}
-
-/**
- * Computes a CRC-32 checksum over the requested byte range for the CMF binary
- * reader.
- */
-function crc32(bytes, start = 0, end = bytes.byteLength) {
-  let crc = 0xffffffff;
-  const table = crc32Table();
-  for (let i = start; i < end; i++) {
-    crc = crc >>> 8 ^ table[(crc ^ bytes[i]) & 0xff];
-  }
-  return (crc ^ 0xffffffff) >>> 0;
-}
-let cachedCrc32Table = null;
-function crc32Table() {
-  if (cachedCrc32Table) {
-    return cachedCrc32Table;
-  }
-  cachedCrc32Table = new Uint32Array(256);
-  for (let i = 0; i < 256; i++) {
-    let c = i;
-    for (let k = 0; k < 8; k++) {
-      c = c & 1 ? 0xedb88320 ^ c >>> 1 : c >>> 1;
-    }
-    cachedCrc32Table[i] = c >>> 0;
-  }
-  return cachedCrc32Table;
-}
-
-export { BinaryReader, asUint8Array, crc32, enumName, readBounds, readMatrix, readQuaternion, readVector3 };
-//# sourceMappingURL=binary.js.map
+const textDecoder = new TextDecoder();
+
+/** Returns a byte view over the supplied binary input for the CMF binary reader. */
+function asUint8Array(input) {
+  if (input instanceof Uint8Array) {
+    return input;
+  }
+  if (input instanceof ArrayBuffer) {
+    return new Uint8Array(input);
+  }
+  if (ArrayBuffer.isView(input)) {
+    return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
+  }
+  throw new TypeError("CMF input must be a Uint8Array, Buffer, ArrayBuffer, or typed-array view");
+}
+
+/**
+ * Bounds-checked little-endian offset reader over CMF file bytes, including
+ * 64-bit integer reads guarded against unsafe values.
+ */
+class BinaryReader {
+  /** Creates a BinaryReader over caller-provided CMF bytes and reader options. */
+  constructor(bytes) {
+    this.bytes = asUint8Array(bytes);
+    this.view = new DataView(this.bytes.buffer, this.bytes.byteOffset, this.bytes.byteLength);
+  }
+
+  /**
+   * Validates the supplied value against CMF binary reader constraints and
+   * throws on failure.
+   */
+  require(offset, size, label = "read") {
+    if (!Number.isInteger(offset) || offset < 0 || offset + size > this.bytes.byteLength) {
+      throw new RangeError(`CMF ${label} is outside file bounds`);
+    }
+  }
+
+  /**
+   * Reads an unsigned 8-bit integer at the requested offset for the CMF binary
+   * reader.
+   */
+  u8(offset) {
+    this.require(offset, 1);
+    return this.view.getUint8(offset);
+  }
+
+  /**
+   * Reads an unsigned 16-bit little-endian integer at the requested offset for
+   * the CMF binary reader.
+   */
+  u16(offset) {
+    this.require(offset, 2);
+    return this.view.getUint16(offset, true);
+  }
+
+  /**
+   * Reads an unsigned 32-bit little-endian integer at the requested offset for
+   * the CMF binary reader.
+   */
+  u32(offset) {
+    this.require(offset, 4);
+    return this.view.getUint32(offset, true);
+  }
+
+  /**
+   * Reads a signed 32-bit little-endian integer at the requested offset for
+   * the CMF binary reader.
+   */
+  i32(offset) {
+    this.require(offset, 4);
+    return this.view.getInt32(offset, true);
+  }
+
+  /**
+   * Reads a 32-bit little-endian float at the requested offset for the CMF
+   * binary reader.
+   */
+  f32(offset) {
+    this.require(offset, 4);
+    return this.view.getFloat32(offset, true);
+  }
+
+  /**
+   * Reads a safe unsigned 64-bit little-endian integer at the requested offset
+   * for the CMF binary reader.
+   */
+  u64(offset) {
+    this.require(offset, 8);
+    const value = this.view.getBigUint64(offset, true);
+    if (value > BigInt(Number.MAX_SAFE_INTEGER)) {
+      throw new RangeError("CMF integer is larger than Number.MAX_SAFE_INTEGER");
+    }
+    return Number(value);
+  }
+
+  /**
+   * Reads a safe signed 64-bit little-endian integer at the requested offset
+   * for the CMF binary reader.
+   */
+  i64(offset) {
+    this.require(offset, 8);
+    const value = this.view.getBigInt64(offset, true);
+    if (value > BigInt(Number.MAX_SAFE_INTEGER) || value < BigInt(Number.MIN_SAFE_INTEGER)) {
+      throw new RangeError("CMF integer is outside the safe JavaScript number range");
+    }
+    return Number(value);
+  }
+
+  /**
+   * Returns a bounds-checked byte slice at the requested offset for the CMF
+   * binary reader.
+   */
+  bytesAt(offset, size) {
+    this.require(offset, size, "byte slice");
+    return this.bytes.subarray(offset, offset + size);
+  }
+
+  /** Decodes a UTF-8 string at the requested offset for the CMF binary reader. */
+  string(offset, byteSize) {
+    if (byteSize === 0) {
+      return "";
+    }
+    return textDecoder.decode(this.bytesAt(offset, byteSize));
+  }
+}
+
+/**
+ * Returns the symbolic enum name or an unknown-value label for the CMF binary
+ * reader.
+ */
+function enumName(names, value) {
+  return names[value] ?? `Unknown(${value})`;
+}
+
+/** Reads a three-component vector from the CMF input for the CMF binary reader. */
+function readVector3(reader, offset) {
+  return [reader.f32(offset), reader.f32(offset + 4), reader.f32(offset + 8)];
+}
+
+/**
+ * Reads a four-component quaternion from the CMF input for the CMF binary
+ * reader.
+ */
+function readQuaternion(reader, offset) {
+  return [reader.f32(offset), reader.f32(offset + 4), reader.f32(offset + 8), reader.f32(offset + 12)];
+}
+
+/** Reads a 4-by-4 matrix from the CMF input for the CMF binary reader. */
+function readMatrix(reader, offset) {
+  const values = [];
+  for (let i = 0; i < 16; i++) {
+    values.push(reader.f32(offset + i * 4));
+  }
+  return values;
+}
+
+/** Reads minimum and maximum bounds from the CMF input for the CMF binary reader. */
+function readBounds(reader, offset) {
+  return {
+    min: readVector3(reader, offset),
+    max: readVector3(reader, offset + 12)
+  };
+}
+
+/**
+ * Computes a CRC-32 checksum over the requested byte range for the CMF binary
+ * reader.
+ */
+function crc32(bytes, start = 0, end = bytes.byteLength) {
+  let crc = 0xffffffff;
+  const table = crc32Table();
+  for (let i = start; i < end; i++) {
+    crc = crc >>> 8 ^ table[(crc ^ bytes[i]) & 0xff];
+  }
+  return (crc ^ 0xffffffff) >>> 0;
+}
+let cachedCrc32Table = null;
+function crc32Table() {
+  if (cachedCrc32Table) {
+    return cachedCrc32Table;
+  }
+  cachedCrc32Table = new Uint32Array(256);
+  for (let i = 0; i < 256; i++) {
+    let c = i;
+    for (let k = 0; k < 8; k++) {
+      c = c & 1 ? 0xedb88320 ^ c >>> 1 : c >>> 1;
+    }
+    cachedCrc32Table[i] = c >>> 0;
+  }
+  return cachedCrc32Table;
+}
+
+export { BinaryReader, asUint8Array, crc32, enumName, readBounds, readMatrix, readQuaternion, readVector3 };
+//# sourceMappingURL=binary.js.map