@carbonenginejs/runtime-resource 0.13.0 → 0.14.0

package/dist/resource/audio/CjsAudioRes.js

@@ -1,213 +1,213 @@
-import { CjsError } from '@carbonenginejs/runtime-utils/errors';
-import { CjsResource } from '../CjsResource.js';
-import { CjsAudioBufferRes } from './CjsAudioBufferRes.js';
-
-/**
- * Individually addressable audio resource representing one complete file over either a complete or windowed physical source.
- *
- * The resource keeps semantic media identity independent from its ingress.
- * Loose files, prepared files, API results, and bank windows therefore expose
- * the same byte and lifetime methods.
- */
-class CjsAudioRes extends CjsResource {
-  #audioInfo = Object.freeze({});
-  #backing = null;
-  #backingLocks = 0;
-  #byteLength = null;
-  #offset = 0;
-
-  /** Creates an unregistered semantic audio resource with optional metadata. */
-  constructor(values = null) {
-    super();
-    if (values) {
-      this.SetAudioInfo(values.info ?? values);
-      if (values.backing) {
-        this.SetBackingResource(values.backing, values);
-      }
-    }
-  }
-
-  /** Replaces immutable semantic metadata before the resource is registered. */
-  SetAudioInfo(values = null) {
-    if (!values || typeof values !== "object" || Array.isArray(values)) {
-      throw new TypeError("CjsAudioRes info must be an object");
-    }
-    this.#audioInfo = Object.freeze({
-      ...values
-    });
-    return this;
-  }
-
-  /** Returns immutable media, language, source, and path metadata. */
-  GetAudioInfo() {
-    return this.#audioInfo;
-  }
-
-  /** Binds the shared physical resource and this file's byte window. */
-  SetBackingResource(backing, {
-    offset = 0,
-    byteLength = null
-  } = {}) {
-    if (!(backing instanceof CjsAudioBufferRes)) {
-      throw new TypeError("CjsAudioRes backing must be a CjsAudioBufferRes");
-    }
-    const normalizedOffset = CjsAudioRes.normalizeNonNegativeInteger(offset, "CjsAudioRes offset");
-    const normalizedByteLength = byteLength === null || byteLength === undefined ? null : CjsAudioRes.normalizeNonNegativeInteger(byteLength, "CjsAudioRes byteLength");
-    if (this.#backing && this.#backing !== backing) {
-      throw new CjsError("CJS_AUDIO_RESOURCE_CONFLICT", `Audio resource backing changed: ${this.GetPath()}`, {
-        details: {
-          path: this.GetPath()
-        }
-      });
-    }
-    if (this.#backing && (this.#offset !== normalizedOffset || this.#byteLength !== normalizedByteLength)) {
-      throw new CjsError("CJS_AUDIO_RESOURCE_CONFLICT", `Audio resource window changed: ${this.GetPath()}`, {
-        details: {
-          path: this.GetPath()
-        }
-      });
-    }
-    this.#backing = backing;
-    this.#offset = normalizedOffset;
-    this.#byteLength = normalizedByteLength;
-    if (!this.IsPrepared()) {
-      this.MarkPrepared();
-    }
-    return this;
-  }
-
-  /** Returns the shared physical source resource. */
-  GetBackingResource() {
-    return this.#backing;
-  }
-
-  /** Returns this file's offset within the shared physical source. */
-  GetSourceOffset() {
-    return this.#offset;
-  }
-
-  /** Returns the declared file length, or null when it is source-sized. */
-  GetByteLength() {
-    return this.#byteLength;
-  }
-
-  /**
-   * Returns detached bytes and metadata for this file or one requested range.
-   *
-   * A temporary child/backing lock covers loading and copying. The returned
-   * ArrayBuffer cannot keep a complete bank payload alive accidentally.
-   */
-  async GetBytes({
-    offset = 0,
-    byteLength = null,
-    ...loadOptions
-  } = {}) {
-    if (!this.#backing) {
-      throw new CjsError("CJS_AUDIO_BACKING_UNAVAILABLE", `Audio resource has no backing source: ${this.GetPath()}`, {
-        details: {
-          path: this.GetPath()
-        }
-      });
-    }
-    this.Lock();
-    try {
-      const source = await this.#backing.GetByteView(loadOptions);
-      const available = source.byteLength - this.#offset;
-      const totalByteLength = this.#byteLength ?? available;
-      if (available < 0 || totalByteLength > available) {
-        throw new CjsError("CJS_AUDIO_SOURCE_WINDOW_INVALID", `Audio source window exceeds its backing bytes: ${this.GetPath()}`, {
-          details: {
-            path: this.GetPath(),
-            sourceOffset: this.#offset,
-            sourceByteLength: source.byteLength,
-            byteLength: totalByteLength
-          }
-        });
-      }
-      const range = CjsAudioRes.normalizeRange(offset, byteLength, totalByteLength);
-      const start = this.#offset + range.offset;
-      const bytes = source.slice(start, start + range.byteLength).buffer;
-      return Object.freeze({
-        ...this.#audioInfo,
-        bytes,
-        offset: range.offset,
-        byteLength: bytes.byteLength,
-        totalByteLength,
-        complete: range.offset === 0 && bytes.byteLength === totalByteLength
-      });
-    } finally {
-      this.Unlock();
-    }
-  }
-
-  /** Loads this semantic resource and resolves to the resource handle. */
-  async GetObject(options = {}) {
-    await this.GetBytes(options);
-    return this;
-  }
-
-  /** Renews both the child identity and its shared backing identity. */
-  KeepAlive(options = {}) {
-    super.KeepAlive(options);
-    this.#backing?.KeepAlive(options);
-    return this;
-  }
-
-  /** Renews the child identity and the shared backing payload lease. */
-  KeepPayloadAlive(options = {}) {
-    super.KeepAlive(options);
-    this.#backing?.KeepPayloadAlive(options);
-    return this;
-  }
-
-  /** Locks this child and increments the shared backing lock count. */
-  Lock() {
-    const count = super.Lock();
-    if (!this.#backing) {
-      return count;
-    }
-    try {
-      this.#backing.Lock();
-      this.#backingLocks += 1;
-      return count;
-    } catch (cause) {
-      super.Unlock();
-      throw cause;
-    }
-  }
-
-  /** Unlocks this child and releases one shared backing lock. */
-  Unlock() {
-    const count = super.Unlock();
-    if (this.#backingLocks > 0) {
-      this.#backingLocks -= 1;
-      this.#backing?.Unlock();
-    }
-    return count;
-  }
-
-  /** Normalizes one safe integer used by audio byte windows. */
-  static normalizeNonNegativeInteger(value, label) {
-    const number = Number(value);
-    if (!Number.isSafeInteger(number) || number < 0) {
-      throw new TypeError(`${label} must be a non-negative integer`);
-    }
-    return number;
-  }
-
-  /** Normalizes a requested range within one semantic audio file. */
-  static normalizeRange(offsetValue, byteLengthValue, totalByteLength) {
-    const offset = this.normalizeNonNegativeInteger(offsetValue, "Audio byte offset");
-    const byteLength = byteLengthValue === null || byteLengthValue === undefined ? totalByteLength - offset : this.normalizeNonNegativeInteger(byteLengthValue, "Audio byte length");
-    if (offset > totalByteLength || byteLength > totalByteLength - offset) {
-      throw new RangeError(`Audio byte range exceeds ${totalByteLength} bytes`);
-    }
-    return {
-      offset,
-      byteLength
-    };
-  }
-}
-
-export { CjsAudioRes };
-//# sourceMappingURL=CjsAudioRes.js.map
+import { CjsError } from '@carbonenginejs/runtime-utils/errors';
+import { CjsResource } from '../CjsResource.js';
+import { CjsAudioBufferRes } from './CjsAudioBufferRes.js';
+
+/**
+ * Individually addressable audio resource representing one complete file over either a complete or windowed physical source.
+ *
+ * The resource keeps semantic media identity independent from its ingress.
+ * Loose files, prepared files, API results, and bank windows therefore expose
+ * the same byte and lifetime methods.
+ */
+class CjsAudioRes extends CjsResource {
+  #audioInfo = Object.freeze({});
+  #backing = null;
+  #backingLocks = 0;
+  #byteLength = null;
+  #offset = 0;
+
+  /** Creates an unregistered semantic audio resource with optional metadata. */
+  constructor(values = null) {
+    super();
+    if (values) {
+      this.SetAudioInfo(values.info ?? values);
+      if (values.backing) {
+        this.SetBackingResource(values.backing, values);
+      }
+    }
+  }
+
+  /** Replaces immutable semantic metadata before the resource is registered. */
+  SetAudioInfo(values = null) {
+    if (!values || typeof values !== "object" || Array.isArray(values)) {
+      throw new TypeError("CjsAudioRes info must be an object");
+    }
+    this.#audioInfo = Object.freeze({
+      ...values
+    });
+    return this;
+  }
+
+  /** Returns immutable media, language, source, and path metadata. */
+  GetAudioInfo() {
+    return this.#audioInfo;
+  }
+
+  /** Binds the shared physical resource and this file's byte window. */
+  SetBackingResource(backing, {
+    offset = 0,
+    byteLength = null
+  } = {}) {
+    if (!(backing instanceof CjsAudioBufferRes)) {
+      throw new TypeError("CjsAudioRes backing must be a CjsAudioBufferRes");
+    }
+    const normalizedOffset = CjsAudioRes.normalizeNonNegativeInteger(offset, "CjsAudioRes offset");
+    const normalizedByteLength = byteLength === null || byteLength === undefined ? null : CjsAudioRes.normalizeNonNegativeInteger(byteLength, "CjsAudioRes byteLength");
+    if (this.#backing && this.#backing !== backing) {
+      throw new CjsError("CJS_AUDIO_RESOURCE_CONFLICT", `Audio resource backing changed: ${this.GetPath()}`, {
+        details: {
+          path: this.GetPath()
+        }
+      });
+    }
+    if (this.#backing && (this.#offset !== normalizedOffset || this.#byteLength !== normalizedByteLength)) {
+      throw new CjsError("CJS_AUDIO_RESOURCE_CONFLICT", `Audio resource window changed: ${this.GetPath()}`, {
+        details: {
+          path: this.GetPath()
+        }
+      });
+    }
+    this.#backing = backing;
+    this.#offset = normalizedOffset;
+    this.#byteLength = normalizedByteLength;
+    if (!this.IsPrepared()) {
+      this.MarkPrepared();
+    }
+    return this;
+  }
+
+  /** Returns the shared physical source resource. */
+  GetBackingResource() {
+    return this.#backing;
+  }
+
+  /** Returns this file's offset within the shared physical source. */
+  GetSourceOffset() {
+    return this.#offset;
+  }
+
+  /** Returns the declared file length, or null when it is source-sized. */
+  GetByteLength() {
+    return this.#byteLength;
+  }
+
+  /**
+   * Returns detached bytes and metadata for this file or one requested range.
+   *
+   * A temporary child/backing lock covers loading and copying. The returned
+   * ArrayBuffer cannot keep a complete bank payload alive accidentally.
+   */
+  async GetBytes({
+    offset = 0,
+    byteLength = null,
+    ...loadOptions
+  } = {}) {
+    if (!this.#backing) {
+      throw new CjsError("CJS_AUDIO_BACKING_UNAVAILABLE", `Audio resource has no backing source: ${this.GetPath()}`, {
+        details: {
+          path: this.GetPath()
+        }
+      });
+    }
+    this.Lock();
+    try {
+      const source = await this.#backing.GetByteView(loadOptions);
+      const available = source.byteLength - this.#offset;
+      const totalByteLength = this.#byteLength ?? available;
+      if (available < 0 || totalByteLength > available) {
+        throw new CjsError("CJS_AUDIO_SOURCE_WINDOW_INVALID", `Audio source window exceeds its backing bytes: ${this.GetPath()}`, {
+          details: {
+            path: this.GetPath(),
+            sourceOffset: this.#offset,
+            sourceByteLength: source.byteLength,
+            byteLength: totalByteLength
+          }
+        });
+      }
+      const range = CjsAudioRes.normalizeRange(offset, byteLength, totalByteLength);
+      const start = this.#offset + range.offset;
+      const bytes = source.slice(start, start + range.byteLength).buffer;
+      return Object.freeze({
+        ...this.#audioInfo,
+        bytes,
+        offset: range.offset,
+        byteLength: bytes.byteLength,
+        totalByteLength,
+        complete: range.offset === 0 && bytes.byteLength === totalByteLength
+      });
+    } finally {
+      this.Unlock();
+    }
+  }
+
+  /** Loads this semantic resource and resolves to the resource handle. */
+  async GetObject(options = {}) {
+    await this.GetBytes(options);
+    return this;
+  }
+
+  /** Renews both the child identity and its shared backing identity. */
+  KeepAlive(options = {}) {
+    super.KeepAlive(options);
+    this.#backing?.KeepAlive(options);
+    return this;
+  }
+
+  /** Renews the child identity and the shared backing payload lease. */
+  KeepPayloadAlive(options = {}) {
+    super.KeepAlive(options);
+    this.#backing?.KeepPayloadAlive(options);
+    return this;
+  }
+
+  /** Locks this child and increments the shared backing lock count. */
+  Lock() {
+    const count = super.Lock();
+    if (!this.#backing) {
+      return count;
+    }
+    try {
+      this.#backing.Lock();
+      this.#backingLocks += 1;
+      return count;
+    } catch (cause) {
+      super.Unlock();
+      throw cause;
+    }
+  }
+
+  /** Unlocks this child and releases one shared backing lock. */
+  Unlock() {
+    const count = super.Unlock();
+    if (this.#backingLocks > 0) {
+      this.#backingLocks -= 1;
+      this.#backing?.Unlock();
+    }
+    return count;
+  }
+
+  /** Normalizes one safe integer used by audio byte windows. */
+  static normalizeNonNegativeInteger(value, label) {
+    const number = Number(value);
+    if (!Number.isSafeInteger(number) || number < 0) {
+      throw new TypeError(`${label} must be a non-negative integer`);
+    }
+    return number;
+  }
+
+  /** Normalizes a requested range within one semantic audio file. */
+  static normalizeRange(offsetValue, byteLengthValue, totalByteLength) {
+    const offset = this.normalizeNonNegativeInteger(offsetValue, "Audio byte offset");
+    const byteLength = byteLengthValue === null || byteLengthValue === undefined ? totalByteLength - offset : this.normalizeNonNegativeInteger(byteLengthValue, "Audio byte length");
+    if (offset > totalByteLength || byteLength > totalByteLength - offset) {
+      throw new RangeError(`Audio byte range exceeds ${totalByteLength} bytes`);
+    }
+    return {
+      offset,
+      byteLength
+    };
+  }
+}
+
+export { CjsAudioRes };
+//# sourceMappingURL=CjsAudioRes.js.map

package/dist/resource/audio/index.js

@@ -1,4 +1,4 @@
-export { AudioGeometryResData } from './AudioGeometryResData.js';
-export { CjsAudioBufferRes } from './CjsAudioBufferRes.js';
-export { CjsAudioRes } from './CjsAudioRes.js';
-//# sourceMappingURL=index.js.map
+export { AudioGeometryResData } from './AudioGeometryResData.js';
+export { CjsAudioBufferRes } from './CjsAudioBufferRes.js';
+export { CjsAudioRes } from './CjsAudioRes.js';
+//# sourceMappingURL=index.js.map

package/dist/resource/geometry/MeshDecalData.js

@@ -1,37 +1,37 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import { type } from '@carbonenginejs/runtime-utils/schema';
-import { CjsModel } from '@carbonenginejs/runtime-utils/model';
-
-let _initClass, _init_indexBuffer, _init_extra_indexBuffer, _init_lodMask, _init_extra_lodMask, _init_lods, _init_extra_lods;
-
-/** MeshDecalData (resources) - maintained from schema shapeHash edd09cef.... */
-let _MeshDecalData;
-class MeshDecalData extends CjsModel {
-  static {
-    ({
-      e: [_init_indexBuffer, _init_extra_indexBuffer, _init_lodMask, _init_extra_lodMask, _init_lods, _init_extra_lods],
-      c: [_MeshDecalData, _initClass]
-    } = _applyDecs2311(this, [type.define({
-      className: "MeshDecalData",
-      family: "resources"
-    })], [[type.rawStruct("Tr2SuballocatedBuffer::Allocation"), 0, "indexBuffer"], [[type, type.uint32], 16, "lodMask"], [type.list("MeshDecalLodData"), 0, "lods"]], 0, void 0, CjsModel));
-  }
-  constructor(...args) {
-    super(...args);
-    _init_extra_lods(this);
-  }
-  /** m_indexBuffer (Tr2SuballocatedBuffer::Allocation) */
-  indexBuffer = _init_indexBuffer(this, null);
-
-  /** m_lodMask (uint32_t) */
-  lodMask = (_init_extra_indexBuffer(this), _init_lodMask(this, 0));
-
-  /** m_lods (std::vector<MeshDecalLodData>) */
-  lods = (_init_extra_lodMask(this), _init_lods(this, []));
-  static {
-    _initClass();
-  }
-}
-
-export { _MeshDecalData as MeshDecalData };
-//# sourceMappingURL=MeshDecalData.js.map
+import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { type } from '@carbonenginejs/runtime-utils/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+
+let _initClass, _init_indexBuffer, _init_extra_indexBuffer, _init_lodMask, _init_extra_lodMask, _init_lods, _init_extra_lods;
+
+/** MeshDecalData (resources) - maintained from schema shapeHash edd09cef.... */
+let _MeshDecalData;
+class MeshDecalData extends CjsModel {
+  static {
+    ({
+      e: [_init_indexBuffer, _init_extra_indexBuffer, _init_lodMask, _init_extra_lodMask, _init_lods, _init_extra_lods],
+      c: [_MeshDecalData, _initClass]
+    } = _applyDecs2311(this, [type.define({
+      className: "MeshDecalData",
+      family: "resources"
+    })], [[type.rawStruct("Tr2SuballocatedBuffer::Allocation"), 0, "indexBuffer"], [[type, type.uint32], 16, "lodMask"], [type.list("MeshDecalLodData"), 0, "lods"]], 0, void 0, CjsModel));
+  }
+  constructor(...args) {
+    super(...args);
+    _init_extra_lods(this);
+  }
+  /** m_indexBuffer (Tr2SuballocatedBuffer::Allocation) */
+  indexBuffer = _init_indexBuffer(this, null);
+
+  /** m_lodMask (uint32_t) */
+  lodMask = (_init_extra_indexBuffer(this), _init_lodMask(this, 0));
+
+  /** m_lods (std::vector<MeshDecalLodData>) */
+  lods = (_init_extra_lodMask(this), _init_lods(this, []));
+  static {
+    _initClass();
+  }
+}
+
+export { _MeshDecalData as MeshDecalData };
+//# sourceMappingURL=MeshDecalData.js.map

package/dist/resource/geometry/MeshDecalLodData.js

@@ -1,34 +1,34 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import { type } from '@carbonenginejs/runtime-utils/schema';
-import { CjsModel } from '@carbonenginejs/runtime-utils/model';
-
-let _initClass, _init_startIndex, _init_extra_startIndex, _init_primitiveCount, _init_extra_primitiveCount;
-
-/** MeshDecalLodData (resources) - maintained from schema shapeHash 932b2966.... */
-let _MeshDecalLodData;
-class MeshDecalLodData extends CjsModel {
-  static {
-    ({
-      e: [_init_startIndex, _init_extra_startIndex, _init_primitiveCount, _init_extra_primitiveCount],
-      c: [_MeshDecalLodData, _initClass]
-    } = _applyDecs2311(this, [type.define({
-      className: "MeshDecalLodData",
-      family: "resources"
-    })], [[[type, type.uint32], 16, "startIndex"], [[type, type.uint32], 16, "primitiveCount"]], 0, void 0, CjsModel));
-  }
-  constructor(...args) {
-    super(...args);
-    _init_extra_primitiveCount(this);
-  }
-  /** m_startIndex (uint32_t) */
-  startIndex = _init_startIndex(this, 0);
-
-  /** m_primitiveCount (uint32_t) */
-  primitiveCount = (_init_extra_startIndex(this), _init_primitiveCount(this, 0));
-  static {
-    _initClass();
-  }
-}
-
-export { _MeshDecalLodData as MeshDecalLodData };
-//# sourceMappingURL=MeshDecalLodData.js.map
+import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { type } from '@carbonenginejs/runtime-utils/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+
+let _initClass, _init_startIndex, _init_extra_startIndex, _init_primitiveCount, _init_extra_primitiveCount;
+
+/** MeshDecalLodData (resources) - maintained from schema shapeHash 932b2966.... */
+let _MeshDecalLodData;
+class MeshDecalLodData extends CjsModel {
+  static {
+    ({
+      e: [_init_startIndex, _init_extra_startIndex, _init_primitiveCount, _init_extra_primitiveCount],
+      c: [_MeshDecalLodData, _initClass]
+    } = _applyDecs2311(this, [type.define({
+      className: "MeshDecalLodData",
+      family: "resources"
+    })], [[[type, type.uint32], 16, "startIndex"], [[type, type.uint32], 16, "primitiveCount"]], 0, void 0, CjsModel));
+  }
+  constructor(...args) {
+    super(...args);
+    _init_extra_primitiveCount(this);
+  }
+  /** m_startIndex (uint32_t) */
+  startIndex = _init_startIndex(this, 0);
+
+  /** m_primitiveCount (uint32_t) */
+  primitiveCount = (_init_extra_startIndex(this), _init_primitiveCount(this, 0));
+  static {
+    _initClass();
+  }
+}
+
+export { _MeshDecalLodData as MeshDecalLodData };
+//# sourceMappingURL=MeshDecalLodData.js.map