@carbonenginejs/runtime-resource 0.9.1 → 0.10.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/{CjsResource.js → resource/CjsResource.js}

@@ -1,7 +1,7 @@
-import { identity as _identity, applyDecs2311 as _applyDecs2311 } from './_virtual/_rollupPluginBabelHelpers.js';
-import { CjsEventEmitter } from '@carbonenginejs/core-types/model';
-import { type, carbon, impl, CjsSchema } from '@carbonenginejs/core-types/schema';
-import { normalizeResourcePath, getResourceExtension } from './resourcePath.js';
+import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../_virtual/_rollupPluginBabelHelpers.js';
+import { CjsEventEmitter } from '@carbonenginejs/runtime-utils/model';
+import { normalizeResourcePath, normalizeResourceExtension, getResourceExtension } from '@carbonenginejs/runtime-utils/path';
+import { type, carbon, impl, CjsSchema } from '@carbonenginejs/runtime-utils/schema';
 
 let _initProto, _initClass, _init_path, _init_extra_path, _init_ext, _init_extra_ext, _init_requirement, _init_extra_requirement, _init_state, _init_extra_state;
 
@@ -14,8 +14,10 @@ let _initProto, _initClass, _init_path, _init_extra_path, _init_ext, _init_extra
  */
 
 /**
- * Manager-owned callbacks attached while a resource has canonical ownership.
- * The controller deliberately contains no load, fetch, prepare, or reload hook.
+ * Manager-owned callbacks attached while a resource has canonical ownership,
+ * and detached the moment it ends. The controller carries no load, fetch, or
+ * prepare hook; recovery lives in the separate reload hook, which deliberately
+ * outlives ownership because losing ownership is exactly when it is needed.
  *
  * @typedef {object} CjsResourceLifecycleController
  * @property {Function} [isCurrent] Tests exact canonical manager ownership without renewing activity.
@@ -37,12 +39,34 @@ new class extends _identity {
       })], [[[type, type.path], 16, "path"], [[type, type.string], 16, "ext"], [[type, type.string], 16, "requirement"], [[type, type.string], 16, "state"], [[carbon, carbon.method, impl, impl.adapted], 18, "Initialize"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetPath"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetExt"], [[carbon, carbon.method, impl, impl.adapted], 18, "IsLoading"], [[carbon, carbon.method, impl, impl.adapted], 18, "HasLoaded"], [[carbon, carbon.method, impl, impl.adapted], 18, "IsPrepared"], [[carbon, carbon.method, impl, impl.adapted], 18, "IsGood"], [[carbon, carbon.method, impl, impl.adapted], 18, "IsFailed"]], 0, void 0, CjsEventEmitter));
     }
     #payload = (_initProto(this), null);
+
+    /** Reloads attempted since the last successful load. */
+    #reloadAttempts = 0;
+
+    /**
+     * How many times a purged or failed resource reloads itself before giving up.
+     *
+     * Per class so a subclass can be more or less patient. Counted per resource
+     * and reset on every successful load, so this bounds consecutive failures,
+     * not the lifetime total.
+     */
+
     path = _init_path(this, "");
     ext = (_init_extra_path(this), _init_ext(this, ""));
     requirement = (_init_extra_ext(this), _init_requirement(this, ""));
     state = (_init_extra_requirement(this), _init_state(this, _CjsResource.State.EMPTY));
+
+    /**
+     * Identifies this class as a runtime resource.
+     *
+     * Static, so a schema field declared as `@type.objectRef("TriGeometryRes")`
+     * can be known to hold a resource without an instance existing - the
+     * declaration alone is enough, resolved through `CjsSchema.GetConstructor`.
+     */
+
+    /** Identifies this handle as a runtime resource. */
     get isResource() {
-      return true;
+      return this.constructor.isResource === true;
     }
 
     /**
@@ -78,6 +102,12 @@ new class extends _identity {
         configurable: true,
         writable: true
       });
+      Object.defineProperty(this, "__reloadHook", {
+        value: null,
+        enumerable: false,
+        configurable: true,
+        writable: true
+      });
       if (values) {
         this.SetValues(values);
       }
@@ -124,7 +154,7 @@ new class extends _identity {
      */
     Initialize(path, ext = null, requirement = "") {
       this.path = normalizeResourcePath(path);
-      this.ext = ext ? String(ext).replace(/^\./u, "").toLowerCase() : getResourceExtension(this.path);
+      this.ext = ext ? normalizeResourceExtension(ext) : getResourceExtension(this.path);
       this.requirement = requirement === null || requirement === undefined ? "" : String(requirement).trim().toLowerCase();
       this.state = _CjsResource.State.EMPTY;
       this.error = null;
@@ -187,11 +217,35 @@ new class extends _identity {
     }
 
     /**
-     * Return true when preparation completed successfully.
+     * Return true when this resource finished trying to load, either way.
+     *
+     * The pull form of the `completed` event. Carbon expresses this as a
+     * predicate because it has no events - `m_isPrepared` is set on the failure
+     * path too (`BlueAsyncRes.cpp:183`) - so `IsPrepared()` there means "finished
+     * trying" while ours keeps the narrower "succeeded".
+     *
+     * `PURGED` is not completion: nothing was tried and nothing concluded, the
+     * payload was simply taken away.
+     *
+     * @returns {boolean}
+     */
+    HasCompleted() {
+      return this.state === _CjsResource.State.PREPARED || this.state === _CjsResource.State.FAILED;
+    }
+
+    /**
+     * Return true when preparation completed successfully, and renew this
+     * resource.
+     *
+     * Every caller of `IsGood()` is about to use the resource, so renewal always
+     * follows the query. Merging them - as ccpwgl does in `Tw2Resource.js:108` -
+     * closes that gap permanently instead of relying on call-site discipline, and
+     * means a purged resource reloads itself the moment anything asks for it.
      *
      * @returns {boolean}
      */
     IsGood() {
+      this.KeepAlive();
       return this.IsPrepared();
     }
 
@@ -203,32 +257,91 @@ new class extends _identity {
     IsFailed() {
       return this.state === _CjsResource.State.FAILED;
     }
+
+    /**
+     * Changes state and emits the state-specific, statechange, and - on reaching
+     * a load outcome - completed events.
+     */
     SetState(state, ...details) {
-      if (!_CjsResource.IsValidState(state)) {
+      if (!_CjsResource.isValidState(state)) {
         throw new TypeError(`Invalid CjsResource state: ${state}`);
       }
       const previous = this.state;
       if (previous === state) return this;
       this.state = state;
+      // A successful load clears the budget, so the cap bounds consecutive
+      // failures rather than how many times a resource may ever be purged.
+      if (state === _CjsResource.State.PREPARED) this.#reloadAttempts = 0;
       this.EmitEvent?.(state, this, ...details);
       this.EmitEvent?.("statechange", this, state, previous);
+      // Fires again after a purge and reload, so subscribers rebuild whatever
+      // they derived from the payload that was deleted.
+      if (this.HasCompleted()) this.EmitEvent?.("completed", this, ...details);
       return this;
     }
+
+    /**
+     * Subscribe to this resource finishing, firing immediately when it already
+     * has.
+     *
+     * The immediate call is the point. A plain emitter drops late subscribers on
+     * the floor - subscribe after `PREPARED` and nothing ever arrives - which is
+     * why callers end up doing work synchronously "just in case" instead of
+     * subscribing. ccpwgl solves this by replaying current state at registration
+     * (`Tw2Resource.onNotification`), and a subscriber satisfied that way is
+     * never stored at all, so only subscriptions genuinely still waiting
+     * accumulate.
+     *
+     * The listener runs for both outcomes and branches itself:
+     *
+     * ```js
+     * res.OnCompleted(res => { if (res.IsPrepared()) something; else somethingElse; });
+     * ```
+     *
+     * It may run more than once - a purge and reload completes again - so
+     * handlers must be written to be re-entered rather than assuming first load.
+     *
+     * @param {Function} listener Called with this resource once it has finished.
+     * @param {*} [source=null] Optional owner used for bulk removal.
+     * @returns {CjsResource} This resource.
+     */
+    OnCompleted(listener, source = null) {
+      if (typeof listener !== "function") {
+        throw new TypeError("CjsResource.OnCompleted requires a function.");
+      }
+      if (this.HasCompleted()) {
+        listener(this);
+        return this;
+      }
+      return this.OnEvent("completed", listener, source);
+    }
+
+    /** Marks this resource as requested. */
     MarkRequested() {
       return this.SetState(_CjsResource.State.REQUESTED);
     }
+
+    /** Marks this resource as actively loading. */
     MarkLoading() {
       return this.SetState(_CjsResource.State.LOADING);
     }
+
+    /** Marks this resource's CPU payload as loaded. */
     MarkLoaded() {
       return this.SetState(_CjsResource.State.LOADED);
     }
+
+    /** Marks this resource as preparing its semantic result. */
     MarkPreparing() {
       return this.SetState(_CjsResource.State.PREPARING);
     }
+
+    /** Marks this resource as successfully prepared. */
     MarkPrepared() {
       return this.SetState(_CjsResource.State.PREPARED);
     }
+
+    /** Marks this resource as successfully prepared. */
     MarkGood() {
       return this.MarkPrepared();
     }
@@ -253,6 +366,8 @@ new class extends _identity {
     IsPurged() {
       return this.state === _CjsResource.State.PURGED;
     }
+
+    /** Stores a load failure and marks this resource as failed. */
     SetError(error) {
       this.error = error || null;
       return this.SetState(_CjsResource.State.FAILED, this.error);
@@ -351,10 +466,15 @@ new class extends _identity {
     }
 
     /**
-     * Explicitly renew this resource's canonical identity activity.
-     * Unlike ccpwgl compatibility behavior, `IsGood()`, `HasLoaded()`, and other
-     * state queries never call this method implicitly. Renewal never fetches or
-     * reloads a purged resource.
+     * Renew this resource's canonical identity activity, and reload it when
+     * it has been purged.
+     *
+     * Purge is deletion - the payload is gone and nothing restores it - so
+     * revival is an ordinary reload along the first-load path. Consumers
+     * therefore never have to know a purge happened: they ask for what they need
+     * and this makes it be there.
+     *
+     * `IsGood()` calls this, so most callers never invoke it directly.
      *
      * @param {CjsResourceActivityOptions} [options={}] Optional deterministic activity values.
      * @returns {CjsResource} This resource, whether bound or detached.
@@ -362,6 +482,86 @@ new class extends _identity {
      */
     KeepAlive(options = {}) {
       this.__lifecycleController?.keepAlive?.(options);
+      if (this.IsPurged()) this.Reload(options);
+      return this;
+    }
+
+    /**
+     * Re-register this handle with its manager and reload it into itself.
+     *
+     * Runs only from `PURGED` or `FAILED` - the two states where the payload is
+     * absent but recoverable. It does nothing to a resource that is loaded or
+     * still loading, so it is not a way to force a refetch of something already
+     * there.
+     *
+     * Bounded by `maxReloadAttempts`, because `KeepAlive()` calls this and the
+     * render path calls that every frame: without a cap, one missing texture
+     * becomes a permanent retry storm against the thing least likely to succeed.
+     * Attempts are spaced by real load round-trips rather than frames - starting
+     * one leaves `PURGED`/`FAILED`, so nothing re-enters until it settles - and
+     * the count resets on any successful load.
+     *
+     * The distinction that matters: the reload must fill THIS handle, not resolve
+     * whatever the manager currently caches for the same path. A consumer holding
+     * a purged handle has no way to discover a replacement, so handing it a fresh
+     * instance elsewhere leaves it dead forever.
+     *
+     * Detached handles have no manager to re-register with and stay as they are.
+     *
+     * @param {CjsResourceActivityOptions} [options={}] Optional deterministic activity values.
+     * @returns {boolean} Whether a reload was started.
+     */
+    Reload(options = {}) {
+      if (!this.IsPurged() && !this.IsFailed()) return false;
+      if (this.#reloadAttempts >= this.constructor.maxReloadAttempts) return false;
+      if (typeof this.__reloadHook !== "function") return false;
+      this.#reloadAttempts += 1;
+      return this.__reloadHook(options) !== false;
+    }
+
+    /**
+     * Bind the manager callback that restores this handle after it loses its
+     * payload.
+     *
+     * Deliberately separate from the lifecycle controller, which is detached the
+     * moment canonical ownership ends. Recovery has to survive exactly that
+     * event: a purged handle with no route back to its manager is unrecoverable,
+     * which is the failure this whole contract exists to prevent.
+     *
+     * @param {Function|null} hook Manager callback, or `null` to detach it.
+     * @returns {CjsResource} This resource.
+     * @throws {TypeError} If the hook is neither a function nor null.
+     */
+    SetReloadHook(hook = null) {
+      if (hook !== null && typeof hook !== "function") {
+        throw new TypeError("CjsResource.SetReloadHook requires a function or null.");
+      }
+      this.__reloadHook = hook;
+      return this;
+    }
+
+    /**
+     * Return how many reloads have been attempted since the last successful load.
+     *
+     * @returns {number}
+     */
+    GetReloadAttempts() {
+      return this.#reloadAttempts;
+    }
+
+    /**
+     * Clear the reload attempt count, so a resource that exhausted its attempts
+     * can be asked again.
+     *
+     * This is the deliberate "try it again" gesture - a user retrying a failed
+     * load, say. It is separate from `Reload()` because the cap exists precisely
+     * to stop the automatic path retrying forever, so lifting it has to be a
+     * decision someone made.
+     *
+     * @returns {CjsResource} This resource.
+     */
+    ResetReloadAttempts() {
+      this.#reloadAttempts = 0;
       return this;
     }
 
@@ -440,8 +640,9 @@ new class extends _identity {
      * Concurrent callers share one in-flight operation. A resident payload is
      * returned without source work; after explicit payload release, this call is
      * an explicit reconstruction request and may load/prepare through the bound
-     * manager. Detached or purged handles do not revive themselves: their loader
-     * resolves the manager's current canonical identity.
+     * manager. This loader resolves the manager's current canonical identity, so
+     * on a purged handle it may answer with a different instance - use
+     * `KeepAlive()`/`Reload()` to revive this handle itself.
      *
      * Promised-output fields retained by the handle take precedence over fields
      * supplied here; operation policy such as cache/reload controls may still be
@@ -517,7 +718,7 @@ new class extends _identity {
       const name = String(key);
       const value = this.__adapterResources[name];
       if (value && options.destroy !== false) {
-        DestroyAdapterValue(value);
+        destroyAdapterValue(value);
       }
       delete this.__adapterResources[name];
       return this;
@@ -535,10 +736,24 @@ new class extends _identity {
       }
       return this;
     }
-    static IsValidState(state) {
+    /** Returns true when a value belongs to the resource state vocabulary. */
+    static isValidState(state) {
       return Object.values(_CjsResource.State).includes(state);
     }
+
+    /**
+     * Returns true when a resource state cannot continue its current operation.
+     *
+     * `PURGED` is deliberately absent: a purged resource reloads itself
+     * through `KeepAlive()`, so purge is a transition out of a settled state
+     * rather than a resting place.
+     */
+    static isTerminalState(state) {
+      return state === _CjsResource.State.PREPARED || state === _CjsResource.State.FAILED || state === _CjsResource.State.UNLOADED;
+    }
   }];
+  maxReloadAttempts = 3;
+  isResource = true;
   State = Object.freeze({
     EMPTY: "empty",
     REQUESTED: "requested",
@@ -554,7 +769,7 @@ new class extends _identity {
     super(_CjsResource), _initClass();
   }
 }();
-function DestroyAdapterValue(value) {
+function destroyAdapterValue(value) {
   if (!value || typeof value !== "object") return;
   const destroy = value.Destroy || value.Dispose || value.destroy || value.dispose;
   if (typeof destroy === "function") {

package/dist/resource/CjsResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsResource.js","sources":["../../../src/resource/CjsResource.js"],"sourcesContent":["import { CjsEventEmitter } from \"@carbonenginejs/runtime-utils/model\";\nimport {\n  getResourceExtension,\n  normalizeResourceExtension,\n  normalizeResourcePath\n} from \"@carbonenginejs/runtime-utils/path\";\nimport { CjsSchema, carbon, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\n\n/**\n * Deterministic activity values accepted by resource-facing lease methods.\n *\n * @typedef {object} CjsResourceActivityOptions\n * @property {number} [frame] Explicit non-negative activity frame.\n * @property {number} [time] Explicit non-negative activity timestamp in milliseconds.\n */\n\n/**\n * Manager-owned callbacks attached while a resource has canonical ownership,\n * and detached the moment it ends. The controller carries no load, fetch, or\n * prepare hook; recovery lives in the separate reload hook, which deliberately\n * outlives ownership because losing ownership is exactly when it is needed.\n *\n * @typedef {object} CjsResourceLifecycleController\n * @property {Function} [isCurrent] Tests exact canonical manager ownership without renewing activity.\n * @property {Function} [keepAlive] Renews canonical identity activity.\n * @property {Function} [keepPayloadAlive] Renews identity and CPU-payload activity.\n * @property {Function} [lock] Adds one inactivity-purge lock and returns its count.\n * @property {Function} [unlock] Releases one inactivity-purge lock and returns its count.\n */\n\n@type.define({ className: \"CjsResource\", family: \"resource\" })\n/**\n * ResMan-owned runtime resource.\n *\n * Resources are not model graph objects: BLACK/RED graphs persist resource\n * paths (including empty paths), while CjsResMan constructs, initializes,\n * caches, and hydrates the corresponding runtime resource instances.\n */\nexport class CjsResource extends CjsEventEmitter\n{\n  #payload = null;\n\n  /** Reloads attempted since the last successful load. */\n  #reloadAttempts = 0;\n\n  /**\n   * How many times a purged or failed resource reloads itself before giving up.\n   *\n   * Per class so a subclass can be more or less patient. Counted per resource\n   * and reset on every successful load, so this bounds consecutive failures,\n   * not the lifetime total.\n   */\n  static maxReloadAttempts = 3;\n\n  @type.path\n  path = \"\";\n\n  @type.string\n  ext = \"\";\n\n  @type.string\n  requirement = \"\";\n\n  @type.string\n  state = CjsResource.State.EMPTY;\n\n  /**\n   * Identifies this class as a runtime resource.\n   *\n   * Static, so a schema field declared as `@type.objectRef(\"TriGeometryRes\")`\n   * can be known to hold a resource without an instance existing - the\n   * declaration alone is enough, resolved through `CjsSchema.GetConstructor`.\n   */\n  static isResource = true;\n\n  /** Identifies this handle as a runtime resource. */\n  get isResource() {\n    return this.constructor.isResource === true;\n  }\n\n  /**\n   * Create a detached runtime resource with empty identity and payload state.\n   * Schema values are applied without attaching manager lifecycle callbacks;\n   * CjsResMan supplies those callbacks after canonical insertion.\n   *\n   * @param {object|null} [values=null] Initial decorated schema-field values.\n   */\n  constructor(values = null) {\n    super();\n    Object.defineProperty(this, \"__adapterResources\", {\n      value: Object.create(null),\n      enumerable: false,\n      configurable: true,\n      writable: true\n    });\n    Object.defineProperty(this, \"__objectLoader\", {\n      value: null,\n      enumerable: false,\n      configurable: true,\n      writable: true\n    });\n    Object.defineProperty(this, \"__objectRequest\", {\n      value: null,\n      enumerable: false,\n      configurable: true,\n      writable: true\n    });\n    Object.defineProperty(this, \"__lifecycleController\", {\n      value: null,\n      enumerable: false,\n      configurable: true,\n      writable: true\n    });\n    Object.defineProperty(this, \"__reloadHook\", {\n      value: null,\n      enumerable: false,\n      configurable: true,\n      writable: true\n    });\n    if (values)\n    {\n      this.SetValues(values);\n    }\n  }\n\n  /**\n   * Apply resource identity or metadata values without model graph semantics.\n   *\n   * @param {object|null} values\n   * @returns {CjsResource}\n   */\n  SetValues(values = null) {\n    if (!values || typeof values !== \"object\") return this;\n    const fields = CjsSchema.getSchema(this.constructor).fields;\n    for (const field of fields) {\n      if (Object.prototype.hasOwnProperty.call(values, field.name)) {\n        this[field.name] = values[field.name];\n      }\n    }\n    return this;\n  }\n\n  /**\n   * Export resource identity and schema metadata. Runtime state is not a model\n   * graph node; graph fields normally persist only their resource path.\n   *\n   * @returns {object}\n   */\n  GetValues() {\n    const result = {};\n    for (const field of CjsSchema.getSchema(this.constructor).fields) {\n      result[field.name] = this[field.name];\n    }\n    return result;\n  }\n\n  /**\n   * Initialize the resource identity from a path and optional extension.\n   *\n   * @param {string} path\n   * @param {string|null} ext\n   * @param {string|null} requirement\n   * @returns {CjsResource}\n   */\n  @carbon.method\n  @impl.adapted\n  Initialize(path, ext = null, requirement = \"\") {\n    this.path = normalizeResourcePath(path);\n    this.ext = ext ? normalizeResourceExtension(ext) : getResourceExtension(this.path);\n    this.requirement = requirement === null || requirement === undefined\n      ? \"\"\n      : String(requirement).trim().toLowerCase();\n    this.state = CjsResource.State.EMPTY;\n    this.error = null;\n    return this;\n  }\n\n  /**\n   * Get the normalized resource path.\n   *\n   * @returns {string}\n   */\n  @carbon.method\n  @impl.adapted\n  GetPath() {\n    return this.path;\n  }\n\n  /**\n   * Get the normalized resource extension.\n   *\n   * @returns {string}\n   */\n  @carbon.method\n  @impl.adapted\n  GetExt() {\n    return this.ext;\n  }\n\n  /**\n   * Return the normalized semantic outcome requested from this source path.\n   * This metadata query is pure and does not renew manager activity.\n   *\n   * @returns {string} Lowercase requirement name, or an empty string.\n   */\n  GetRequirement() {\n    return this.requirement;\n  }\n\n  /**\n   * Return true when the resource is currently loading.\n   *\n   * @returns {boolean}\n   */\n  @carbon.method\n  @impl.adapted\n  IsLoading() {\n    return this.state === CjsResource.State.REQUESTED || this.state === CjsResource.State.LOADING;\n  }\n\n  /**\n   * Return true when CPU resource payload data has been loaded.\n   *\n   * @returns {boolean}\n   */\n  @carbon.method\n  @impl.adapted\n  HasLoaded() {\n    return this.state === CjsResource.State.LOADED\n      || this.state === CjsResource.State.PREPARING\n      || this.state === CjsResource.State.PREPARED;\n  }\n\n  /**\n   * Return true when preparation has completed or produced a good resource.\n   *\n   * @returns {boolean}\n   */\n  @carbon.method\n  @impl.adapted\n  IsPrepared() {\n    return this.state === CjsResource.State.PREPARED;\n  }\n\n  /**\n   * Return true when this resource finished trying to load, either way.\n   *\n   * The pull form of the `completed` event. Carbon expresses this as a\n   * predicate because it has no events - `m_isPrepared` is set on the failure\n   * path too (`BlueAsyncRes.cpp:183`) - so `IsPrepared()` there means \"finished\n   * trying\" while ours keeps the narrower \"succeeded\".\n   *\n   * `PURGED` is not completion: nothing was tried and nothing concluded, the\n   * payload was simply taken away.\n   *\n   * @returns {boolean}\n   */\n  HasCompleted() {\n    return this.state === CjsResource.State.PREPARED\n      || this.state === CjsResource.State.FAILED;\n  }\n\n  /**\n   * Return true when preparation completed successfully, and renew this\n   * resource.\n   *\n   * Every caller of `IsGood()` is about to use the resource, so renewal always\n   * follows the query. Merging them - as ccpwgl does in `Tw2Resource.js:108` -\n   * closes that gap permanently instead of relying on call-site discipline, and\n   * means a purged resource reloads itself the moment anything asks for it.\n   *\n   * @returns {boolean}\n   */\n  @carbon.method\n  @impl.adapted\n  IsGood() {\n    this.KeepAlive();\n    return this.IsPrepared();\n  }\n\n  /**\n   * Return true when preparation failed.\n   *\n   * @returns {boolean}\n   */\n  @carbon.method\n  @impl.adapted\n  IsFailed() {\n    return this.state === CjsResource.State.FAILED;\n  }\n\n  /**\n   * Changes state and emits the state-specific, statechange, and - on reaching\n   * a load outcome - completed events.\n   */\n  SetState(state, ...details) {\n    if (!CjsResource.isValidState(state)) {\n      throw new TypeError(`Invalid CjsResource state: ${state}`);\n    }\n    const previous = this.state;\n    if (previous === state) return this;\n    this.state = state;\n    // A successful load clears the budget, so the cap bounds consecutive\n    // failures rather than how many times a resource may ever be purged.\n    if (state === CjsResource.State.PREPARED) this.#reloadAttempts = 0;\n    this.EmitEvent?.(state, this, ...details);\n    this.EmitEvent?.(\"statechange\", this, state, previous);\n    // Fires again after a purge and reload, so subscribers rebuild whatever\n    // they derived from the payload that was deleted.\n    if (this.HasCompleted()) this.EmitEvent?.(\"completed\", this, ...details);\n    return this;\n  }\n\n  /**\n   * Subscribe to this resource finishing, firing immediately when it already\n   * has.\n   *\n   * The immediate call is the point. A plain emitter drops late subscribers on\n   * the floor - subscribe after `PREPARED` and nothing ever arrives - which is\n   * why callers end up doing work synchronously \"just in case\" instead of\n   * subscribing. ccpwgl solves this by replaying current state at registration\n   * (`Tw2Resource.onNotification`), and a subscriber satisfied that way is\n   * never stored at all, so only subscriptions genuinely still waiting\n   * accumulate.\n   *\n   * The listener runs for both outcomes and branches itself:\n   *\n   * ```js\n   * res.OnCompleted(res => { if (res.IsPrepared()) something; else somethingElse; });\n   * ```\n   *\n   * It may run more than once - a purge and reload completes again - so\n   * handlers must be written to be re-entered rather than assuming first load.\n   *\n   * @param {Function} listener Called with this resource once it has finished.\n   * @param {*} [source=null] Optional owner used for bulk removal.\n   * @returns {CjsResource} This resource.\n   */\n  OnCompleted(listener, source = null)\n  {\n    if (typeof listener !== \"function\")\n    {\n      throw new TypeError(\"CjsResource.OnCompleted requires a function.\");\n    }\n    if (this.HasCompleted())\n    {\n      listener(this);\n      return this;\n    }\n    return this.OnEvent(\"completed\", listener, source);\n  }\n\n  /** Marks this resource as requested. */\n  MarkRequested() {\n    return this.SetState(CjsResource.State.REQUESTED);\n  }\n\n  /** Marks this resource as actively loading. */\n  MarkLoading() {\n    return this.SetState(CjsResource.State.LOADING);\n  }\n\n  /** Marks this resource's CPU payload as loaded. */\n  MarkLoaded() {\n    return this.SetState(CjsResource.State.LOADED);\n  }\n\n  /** Marks this resource as preparing its semantic result. */\n  MarkPreparing() {\n    return this.SetState(CjsResource.State.PREPARING);\n  }\n\n  /** Marks this resource as successfully prepared. */\n  MarkPrepared() {\n    return this.SetState(CjsResource.State.PREPARED);\n  }\n\n  /** Marks this resource as successfully prepared. */\n  MarkGood() {\n    return this.MarkPrepared();\n  }\n\n  /**\n   * Mark this detached resource handle as purged after a successful\n   * manager-owned policy eviction, such as inactivity or recorded-byte cache\n   * pressure, released its adapter allocations and payload.\n   *\n   * @returns {CjsResource} This purged resource.\n   */\n  MarkPurged()\n  {\n    return this.SetState(CjsResource.State.PURGED);\n  }\n\n  /**\n   * Return whether deterministic manager cleanup has purged this handle.\n   * This is a pure state query and never renews resource activity.\n   *\n   * @returns {boolean} `true` when the current state is `PURGED`.\n   */\n  IsPurged()\n  {\n    return this.state === CjsResource.State.PURGED;\n  }\n\n  /** Stores a load failure and marks this resource as failed. */\n  SetError(error) {\n    this.error = error || null;\n    return this.SetState(CjsResource.State.FAILED, this.error);\n  }\n\n  /**\n   * Store the plain CPU payload associated with this resource.\n   * Concrete resource classes validate the fields they require before calling\n   * this method. If the compatibility `object` property still aliases the\n   * previous payload, it is updated to the replacement; semantic resources\n   * whose `object` points to the resource itself are unaffected. A non-null\n   * payload explicitly renews its manager-owned identity and payload leases;\n   * payload reads remain pure and do not renew either lease.\n   *\n   * @param {*} payload Plain reader/converter output, or `null` to clear it.\n   * @returns {CjsResource} This resource with the supplied payload reference.\n   */\n  SetPayload(payload = null) {\n    const previous = this.#payload;\n    this.#payload = payload;\n    if (this.object === previous) this.object = payload;\n    if (this.HasPayload()) this.KeepPayloadAlive();\n    return this;\n  }\n\n  /**\n   * Read the plain CPU payload associated with this resource.\n   *\n   * The query is pure and does not renew the payload lease.\n   *\n   * @returns {*} Current payload reference, or `null` after release.\n   */\n  GetPayload() {\n    return this.#payload;\n  }\n\n  /**\n   * Return whether a payload has been explicitly assigned. This query is pure\n   * and does not renew the payload lease.\n   *\n   * @returns {boolean} Whether a non-null payload is attached.\n   */\n  HasPayload() {\n    return this.#payload !== null && this.#payload !== undefined;\n  }\n\n  /**\n   * Release the complete payload reference after consumers have retained the\n   * scalars and typed-array views they require. When the compatibility\n   * `object` property still aliases that exact payload, it is cleared as part\n   * of the same ownership release. Semantic resources whose `object` property\n   * points to the resource itself are unaffected.\n   *\n   * @returns {CjsResource} This resource without its former payload reference.\n   */\n  ReleasePayload() {\n    const payload = this.#payload;\n    this.#payload = null;\n    if (this.object === payload) this.object = null;\n    return this;\n  }\n\n  /**\n   * Bind or detach the manager callbacks used by explicit resource-facing\n   * liveness operations. Runtime resources remain usable when unbound; their\n   * liveness methods then become deterministic no-ops.\n   *\n   * @param {CjsResourceLifecycleController|null} controller Manager callbacks, or `null` after canonical ownership ends.\n   * @returns {CjsResource} This resource.\n   * @throws {TypeError} If the controller or any supplied callback is invalid.\n   */\n  SetLifecycleController(controller = null)\n  {\n    if (controller !== null && (typeof controller !== \"object\" || Array.isArray(controller)))\n    {\n      throw new TypeError(\"CjsResource lifecycle controller must be an object or null.\");\n    }\n    for (const name of [ \"isCurrent\", \"keepAlive\", \"keepPayloadAlive\", \"lock\", \"unlock\" ])\n    {\n      if (controller?.[name] !== undefined && typeof controller[name] !== \"function\")\n      {\n        throw new TypeError(`CjsResource lifecycle controller ${name} must be a function.`);\n      }\n    }\n    this.__lifecycleController = controller;\n    return this;\n  }\n\n  /**\n   * Return whether this handle is still the manager's canonical resource.\n   *\n   * Engine adapters use this immediately before synchronously attaching a\n   * completed backend candidate. Detached resources return `false`; the query\n   * never renews activity, reloads data, or mutates lifecycle state.\n   *\n   * @returns {boolean} Whether the bound manager still owns this exact handle.\n   */\n  IsCurrent()\n  {\n    return Boolean(this.__lifecycleController?.isCurrent?.());\n  }\n\n  /**\n   * Renew this resource's canonical identity activity, and reload it when\n   * it has been purged.\n   *\n   * Purge is deletion - the payload is gone and nothing restores it - so\n   * revival is an ordinary reload along the first-load path. Consumers\n   * therefore never have to know a purge happened: they ask for what they need\n   * and this makes it be there.\n   *\n   * `IsGood()` calls this, so most callers never invoke it directly.\n   *\n   * @param {CjsResourceActivityOptions} [options={}] Optional deterministic activity values.\n   * @returns {CjsResource} This resource, whether bound or detached.\n   * @throws {TypeError} If the bound manager rejects invalid activity values.\n   */\n  KeepAlive(options = {})\n  {\n    this.__lifecycleController?.keepAlive?.(options);\n    if (this.IsPurged()) this.Reload(options);\n    return this;\n  }\n\n  /**\n   * Re-register this handle with its manager and reload it into itself.\n   *\n   * Runs only from `PURGED` or `FAILED` - the two states where the payload is\n   * absent but recoverable. It does nothing to a resource that is loaded or\n   * still loading, so it is not a way to force a refetch of something already\n   * there.\n   *\n   * Bounded by `maxReloadAttempts`, because `KeepAlive()` calls this and the\n   * render path calls that every frame: without a cap, one missing texture\n   * becomes a permanent retry storm against the thing least likely to succeed.\n   * Attempts are spaced by real load round-trips rather than frames - starting\n   * one leaves `PURGED`/`FAILED`, so nothing re-enters until it settles - and\n   * the count resets on any successful load.\n   *\n   * The distinction that matters: the reload must fill THIS handle, not resolve\n   * whatever the manager currently caches for the same path. A consumer holding\n   * a purged handle has no way to discover a replacement, so handing it a fresh\n   * instance elsewhere leaves it dead forever.\n   *\n   * Detached handles have no manager to re-register with and stay as they are.\n   *\n   * @param {CjsResourceActivityOptions} [options={}] Optional deterministic activity values.\n   * @returns {boolean} Whether a reload was started.\n   */\n  Reload(options = {})\n  {\n    if (!this.IsPurged() && !this.IsFailed()) return false;\n    if (this.#reloadAttempts >= this.constructor.maxReloadAttempts) return false;\n    if (typeof this.__reloadHook !== \"function\") return false;\n\n    this.#reloadAttempts += 1;\n    return this.__reloadHook(options) !== false;\n  }\n\n  /**\n   * Bind the manager callback that restores this handle after it loses its\n   * payload.\n   *\n   * Deliberately separate from the lifecycle controller, which is detached the\n   * moment canonical ownership ends. Recovery has to survive exactly that\n   * event: a purged handle with no route back to its manager is unrecoverable,\n   * which is the failure this whole contract exists to prevent.\n   *\n   * @param {Function|null} hook Manager callback, or `null` to detach it.\n   * @returns {CjsResource} This resource.\n   * @throws {TypeError} If the hook is neither a function nor null.\n   */\n  SetReloadHook(hook = null)\n  {\n    if (hook !== null && typeof hook !== \"function\")\n    {\n      throw new TypeError(\"CjsResource.SetReloadHook requires a function or null.\");\n    }\n    this.__reloadHook = hook;\n    return this;\n  }\n\n  /**\n   * Return how many reloads have been attempted since the last successful load.\n   *\n   * @returns {number}\n   */\n  GetReloadAttempts()\n  {\n    return this.#reloadAttempts;\n  }\n\n  /**\n   * Clear the reload attempt count, so a resource that exhausted its attempts\n   * can be asked again.\n   *\n   * This is the deliberate \"try it again\" gesture - a user retrying a failed\n   * load, say. It is separate from `Reload()` because the cap exists precisely\n   * to stop the automatic path retrying forever, so lifting it has to be a\n   * decision someone made.\n   *\n   * @returns {CjsResource} This resource.\n   */\n  ResetReloadAttempts()\n  {\n    this.#reloadAttempts = 0;\n    return this;\n  }\n\n  /**\n   * Explicitly renew both canonical identity activity and the attached CPU\n   * payload lease. Reading the payload through `GetPayload()` or\n   * `HasPayload()` remains pure.\n   *\n   * @param {CjsResourceActivityOptions} [options={}] Optional deterministic activity values.\n   * @returns {CjsResource} This resource, whether a payload exists or not.\n   * @throws {TypeError} If the bound manager rejects invalid activity values.\n   */\n  KeepPayloadAlive(options = {})\n  {\n    this.__lifecycleController?.keepPayloadAlive?.(options);\n    return this;\n  }\n\n  /**\n   * Add one explicit purge lock through the bound manager and renew identity\n   * activity. Locking never reloads or prepares a resource.\n   *\n   * @returns {number} New lock count, or `0` when this resource is detached.\n   */\n  Lock()\n  {\n    return this.__lifecycleController?.lock?.() || 0;\n  }\n\n  /**\n   * Release one explicit purge lock without allowing the count to underflow.\n   * Unlocking does not immediately purge or release a payload.\n   *\n   * @returns {number} Remaining lock count, or `0` when detached or unlocked.\n   */\n  Unlock()\n  {\n    return this.__lifecycleController?.unlock?.() || 0;\n  }\n\n  /**\n   * Bind the manager-owned object operation and compact reconstruction request\n   * for this shared resource handle. The request contains source provenance\n   * and requested-output defaults, not reader implementations or registry\n   * history.\n   *\n   * @param {Function|null} loader Manager callback, or `null` to detach it.\n   * @param {object|null} [request=null] Compact reconstruction defaults retained with the handle.\n   * @returns {CjsResource} This resource with the supplied loader binding.\n   * @throws {TypeError} If the loader or reconstruction request is invalid.\n   */\n  SetObjectLoader(loader = null, request = null)\n  {\n    if (loader !== null && typeof loader !== \"function\")\n    {\n      throw new TypeError(\"CjsResource.SetObjectLoader requires a function or null.\");\n    }\n    if (request !== null && (!request || typeof request !== \"object\" || Array.isArray(request)))\n    {\n      throw new TypeError(\"CjsResource.SetObjectLoader request must be an object or null.\");\n    }\n    this.__objectLoader = loader;\n    this.__objectRequest = request === null ? null : Object.freeze({ ...request });\n    return this;\n  }\n\n  /**\n   * Return the compact manager request retained for explicit reconstruction.\n   * This query is pure and exposes no reader, constructor, or implementation\n   * identity.\n   *\n   * @returns {Readonly<object>|null} Frozen reconstruction defaults, or `null` when unbound.\n   */\n  GetObjectRequest()\n  {\n    return this.__objectRequest;\n  }\n\n  /**\n   * Return the manager-owned object outcome for this resource identity.\n   * Concurrent callers share one in-flight operation. A resident payload is\n   * returned without source work; after explicit payload release, this call is\n   * an explicit reconstruction request and may load/prepare through the bound\n   * manager. This loader resolves the manager's current canonical identity, so\n   * on a purged handle it may answer with a different instance - use\n   * `KeepAlive()`/`Reload()` to revive this handle itself.\n   *\n   * Promised-output fields retained by the handle take precedence over fields\n   * supplied here; operation policy such as cache/reload controls may still be\n   * overridden.\n   *\n   * @param {object} [options={}] Source, format, semantic outcome, and queue options forwarded to the manager.\n   * @returns {Promise<*>} In-flight, resident, or reconstructed object outcome.\n   */\n  GetObject(options = {})\n  {\n    if (!this.__objectLoader)\n    {\n      const error = new Error(`Resource has no object loader: ${this.path}`);\n      error.code = \"CJS_RESOURCE_LOADER_UNBOUND\";\n      return Promise.reject(error);\n    }\n    return this.__objectLoader(options);\n  }\n\n  /**\n   * Promise-shaped alias for {@link CjsResource#GetObject}. Readiness shares an\n   * in-flight operation, returns resident payload without loading, and treats a\n   * call after payload release as an explicit reconstruction request.\n   *\n   * @param {object} [options={}] Source, format, semantic outcome, and queue options forwarded to the manager.\n   * @returns {Promise<*>} In-flight, resident, or reconstructed object outcome.\n   */\n  Ready(options = {})\n  {\n    return this.GetObject(options);\n  }\n\n  /**\n   * Attach an opaque engine-owned resource object.\n   *\n   * Runtime-resource stores this value but does not inspect GPU APIs.\n   *\n   * @param {string} key\n   * @param {*} value\n   * @returns {CjsResource}\n   */\n  SetAdapterResource(key, value) {\n    if (!key) throw new TypeError(\"CjsResource.SetAdapterResource requires a key.\");\n    this.__adapterResources[String(key)] = value;\n    return this;\n  }\n\n  /**\n   * Get an opaque engine-owned resource object.\n   *\n   * @param {string} key\n   * @returns {*}\n   */\n  GetAdapterResource(key) {\n    return this.__adapterResources[String(key)] ?? null;\n  }\n\n  /**\n   * Returns true when an adapter resource exists for the given key.\n   *\n   * @param {string} key\n   * @returns {boolean}\n   */\n  HasAdapterResource(key) {\n    return Object.prototype.hasOwnProperty.call(this.__adapterResources, String(key));\n  }\n\n  /**\n   * Remove an adapter resource and optionally call its destroy/dispose method.\n   *\n   * @param {string} key\n   * @param {object} options\n   * @returns {CjsResource}\n   */\n  DestroyAdapterResource(key, options = {}) {\n    const name = String(key);\n    const value = this.__adapterResources[name];\n    if (value && options.destroy !== false) {\n      destroyAdapterValue(value);\n    }\n    delete this.__adapterResources[name];\n    return this;\n  }\n\n  /**\n   * Remove all adapter resources and optionally call their destroy/dispose methods.\n   *\n   * @param {object} options\n   * @returns {CjsResource}\n   */\n  DestroyAdapterResources(options = {}) {\n    for (const key of Object.keys(this.__adapterResources)) {\n      this.DestroyAdapterResource(key, options);\n    }\n    return this;\n  }\n\n  static State = Object.freeze({\n    EMPTY: \"empty\",\n    REQUESTED: \"requested\",\n    LOADING: \"loading\",\n    LOADED: \"loaded\",\n    PREPARING: \"preparing\",\n    PREPARED: \"prepared\",\n    FAILED: \"failed\",\n    UNLOADED: \"unloaded\",\n    PURGED: \"purged\"\n  });\n\n  /** Returns true when a value belongs to the resource state vocabulary. */\n  static isValidState(state)\n  {\n    return Object.values(CjsResource.State).includes(state);\n  }\n\n  /**\n   * Returns true when a resource state cannot continue its current operation.\n   *\n   * `PURGED` is deliberately absent: a purged resource reloads itself\n   * through `KeepAlive()`, so purge is a transition out of a settled state\n   * rather than a resting place.\n   */\n  static isTerminalState(state)\n  {\n    return state === CjsResource.State.PREPARED\n      || state === CjsResource.State.FAILED\n      || state === CjsResource.State.UNLOADED;\n  }\n}\n\nfunction destroyAdapterValue(value) {\n  if (!value || typeof value !== \"object\") return;\n  const destroy = value.Destroy || value.Dispose || value.destroy || value.dispose;\n  if (typeof destroy === \"function\") {\n    destroy.call(value);\n  }\n}\n"],"names":["_CjsResource","_identity","CjsResource","CjsEventEmitter","e","_init_path","_init_extra_path","_init_ext","_init_extra_ext","_init_requirement","_init_extra_requirement","_init_state","_init_extra_state","_initProto","c","_initClass","_applyDecs","type","define","className","family","path","string","carbon","method","impl","adapted","ext","requirement","state","State","EMPTY","isResource","constructor","values","Object","defineProperty","value","create","enumerable","configurable","writable","SetValues","fields","CjsSchema","getSchema","field","prototype","hasOwnProperty","call","name","GetValues","result","Initialize","normalizeResourcePath","normalizeResourceExtension","getResourceExtension","undefined","String","trim","toLowerCase","error","GetPath","GetExt","GetRequirement","IsLoading","REQUESTED","LOADING","HasLoaded","LOADED","PREPARING","PREPARED","IsPrepared","HasCompleted","FAILED","IsGood","KeepAlive","IsFailed","SetState","details","isValidState","TypeError","previous","EmitEvent","OnCompleted","listener","source","OnEvent","MarkRequested","MarkLoading","MarkLoaded","MarkPreparing","MarkPrepared","MarkGood","MarkPurged","PURGED","IsPurged","SetError","SetPayload","payload","object","HasPayload","KeepPayloadAlive","GetPayload","ReleasePayload","SetLifecycleController","controller","Array","isArray","__lifecycleController","IsCurrent","Boolean","isCurrent","options","keepAlive","Reload","maxReloadAttempts","__reloadHook","SetReloadHook","hook","GetReloadAttempts","ResetReloadAttempts","keepPayloadAlive","Lock","lock","Unlock","unlock","SetObjectLoader","loader","request","__objectLoader","__objectRequest","freeze","GetObjectRequest","GetObject","Error","code","Promise","reject","Ready","SetAdapterResource","key","__adapterResources","GetAdapterResource","HasAdapterResource","DestroyAdapterResource","destroy","destroyAdapterValue","DestroyAdapterResources","keys","includes","isTerminalState","UNLOADED","Destroy","Dispose","dispose"],"mappings":"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"}

package/dist/{resources → resource}/Tr2LightProfileRes.js

@@ -1,7 +1,7 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../_virtual/_rollupPluginBabelHelpers.js';
-import { type } from '@carbonenginejs/core-types/schema';
-import { CjsResource as _CjsResource } from '../CjsResource.js';
-import { AssertResourcePayloadObject } from './resourceBoundary.js';
+import { type } from '@carbonenginejs/runtime-utils/schema';
+import { CjsResource as _CjsResource } from './CjsResource.js';
+import { assertResourcePayloadObject } from './resourceBoundary.js';
 
 let _initClass;
 
@@ -20,12 +20,13 @@ new class extends _identity {
         family: "resources"
       })], [], 0, void 0, _CjsResource).c;
     }
+    /** Updates payload in the current resource payload lifecycle. */
     SetPayload(payload = null) {
       if (payload === null) {
         super.SetPayload(null);
         return this;
       }
-      AssertResourcePayloadObject("Tr2LightProfileRes", payload);
+      assertResourcePayloadObject("Tr2LightProfileRes", payload);
       super.SetPayload(payload);
       return this;
     }

package/dist/resource/Tr2LightProfileRes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2LightProfileRes.js","sources":["../../../src/resource/Tr2LightProfileRes.js"],"sourcesContent":["// Source: trinity/trinity/Resources/Tr2LightProfileRes.h\nimport { type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsResource } from \"./CjsResource.js\";\nimport { assertResourcePayloadObject } from \"./resourceBoundary.js\";\n\n/**\n * Runtime-owned light-profile resource.\n *\n * The attached plain payload may be richer than the data retained by the\n * resource or active engine adapter.\n */\n@type.define({ className: \"Tr2LightProfileRes\", family: \"resources\" })\nexport class Tr2LightProfileRes extends CjsResource\n{\n  /** Updates payload in the current resource payload lifecycle. */\n  SetPayload(payload = null)\n  {\n    if (payload === null)\n    {\n      super.SetPayload(null);\n      return this;\n    }\n    assertResourcePayloadObject(\"Tr2LightProfileRes\", payload);\n    super.SetPayload(payload);\n    return this;\n  }\n\n  static payload = \"light-profile\";\n}\n"],"names":["_Tr2LightProfileRes","_identity","Tr2LightProfileRes","CjsResource","_initClass","_applyDecs","type","define","className","family","c","SetPayload","payload","assertResourcePayloadObject","constructor"],"mappings":";;;;;;;AAKA;AACA;AACA;AACA;AACA;AACA;AALA,IAAAA;AAAA,IAAA,cAAAC,SAAA,CAAA;AAAA,EAAA,QAMA,MAAAC,kBAAA,SACwCC,YAAW,CACnD;AAAA,IAAA;MAAA,CAAAH,mBAAA,EAAAI,UAAA,CAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,QAAAA,SAAS,EAAE,oBAAoB;AAAEC,QAAAA,MAAM,EAAE;AAAY,OAAC,CAAC,CAAA,EAAA,EAAA,EAAA,CAAA,EAAA,MAAA,EAC9BN,YAAW,CAAA,CAAAO,CAAA;AAAA;AAEjD;AACAC,IAAAA,UAAUA,CAACC,OAAO,GAAG,IAAI,EACzB;MACE,IAAIA,OAAO,KAAK,IAAI,EACpB;AACE,QAAA,KAAK,CAACD,UAAU,CAAC,IAAI,CAAC;AACtB,QAAA,OAAO,IAAI;AACb,MAAA;AACAE,MAAAA,2BAA2B,CAAC,oBAAoB,EAAED,OAAO,CAAC;AAC1D,MAAA,KAAK,CAACD,UAAU,CAACC,OAAO,CAAC;AACzB,MAAA,OAAO,IAAI;AACb,IAAA;GAGD;AADQA,EAAAA,OAAO,GAAG,eAAe;EAACE,WAAAA,GAAA;IAAA,KAAA,CAAAd,mBAAA,GAAAI,UAAA,EAAA;AAAA,EAAA;AAAA,CAAA,EAAA;;;;"}

package/dist/{resources → resource/audio}/AudioGeometryResData.js

@@ -1,7 +1,7 @@
-import { applyDecs2311 as _applyDecs2311 } from '../_virtual/_rollupPluginBabelHelpers.js';
-import { type } from '@carbonenginejs/core-types/schema';
-import { CjsModel } from '@carbonenginejs/core-types/model';
-import { vec3 } from '@carbonenginejs/core-math/vec3';
+import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { type } from '@carbonenginejs/runtime-utils/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { vec3 } from '@carbonenginejs/runtime-utils/vec3';
 
 let _initClass, _init_id, _init_extra_id, _init_vertices, _init_extra_vertices, _init_indices, _init_extra_indices, _init_minBounds, _init_extra_minBounds, _init_maxBounds, _init_extra_maxBounds, _init_s_nextId, _init_extra_s_nextId;
 

package/dist/resource/audio/AudioGeometryResData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioGeometryResData.js","sources":["../../../../src/resource/audio/AudioGeometryResData.js"],"sourcesContent":["// Source: trinity/trinity/Resources/TriGeometryRes.h\r\n// Schema: format-carbon resources/AudioGeometryResData.json; maintained by runtime-resource.\r\nimport { type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\r\n\r\n/** AudioGeometryResData (resources) - maintained from schema shapeHash 89e7ddb7.... */\r\n@type.define({ className: \"AudioGeometryResData\", family: \"resources\" })\r\nexport class AudioGeometryResData extends CjsModel\r\n{\r\n\r\n  /** m_id (uint64_t) */\r\n  @type.uint64\r\n  id = 0;\r\n\r\n  /** m_vertices (std::vector<Vector3>) */\r\n  @type.list(\"Vector3\")\r\n  vertices = [];\r\n\r\n  /** m_indices (std::vector<uint32_t>) */\r\n  @type.list(\"uint32_t\")\r\n  indices = [];\r\n\r\n  /** m_minBounds (Vector3) */\r\n  @type.vec3\r\n  minBounds = vec3.create();\r\n\r\n  /** m_maxBounds (Vector3) */\r\n  @type.vec3\r\n  maxBounds = vec3.create();\r\n\r\n  /** s_nextId (static std::atomic<uint64_t>) */\r\n  @type.rawStruct(\"static std::atomic<uint64_t>\")\r\n  s_nextId = null;\r\n\r\n}\r\n"],"names":["_AudioGeometryResData","AudioGeometryResData","CjsModel","e","_init_id","_init_extra_id","_init_vertices","_init_extra_vertices","_init_indices","_init_extra_indices","_init_minBounds","_init_extra_minBounds","_init_maxBounds","_init_extra_maxBounds","_init_s_nextId","_init_extra_s_nextId","c","_initClass","_applyDecs","type","define","className","family","uint64","list","vec3","rawStruct","constructor","args","id","vertices","indices","minBounds","create","maxBounds","s_nextId"],"mappings":";;;;;;;AAMA;AAAA,IAAAA;AACA,MAAAC,oBAAA,SAC0CC,QAAQ,CAClD;AAAA,EAAA;AAAA,IAAA,CAAA;MAAAC,CAAA,EAAA,CAAAC,QAAA,EAAAC,cAAA,EAAAC,cAAA,EAAAC,oBAAA,EAAAC,aAAA,EAAAC,mBAAA,EAAAC,eAAA,EAAAC,qBAAA,EAAAC,eAAA,EAAAC,qBAAA,EAAAC,cAAA,EAAAC,oBAAA,CAAA;MAAAC,CAAA,EAAA,CAAAhB,qBAAA,EAAAiB,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,sBAAsB;AAAEC,MAAAA,MAAM,EAAE;AAAY,KAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAKrEH,IAAI,EAAJA,IAAI,CAACI,MAAM,CAAA,EAAA,EAAA,EAAA,IAAA,CAAA,EAAA,CAIXJ,IAAI,CAACK,IAAI,CAAC,SAAS,CAAC,mBAIpBL,IAAI,CAACK,IAAI,CAAC,UAAU,CAAC,EAAA,CAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAIrBL,IAAI,EAAJA,IAAI,CAACM,IAAI,CAAA,EAAA,EAAA,EAAA,WAAA,CAAA,EAAA,CAAA,CAITN,IAAI,EAAJA,IAAI,CAACM,IAAI,CAAA,EAAA,EAAA,EAAA,WAAA,CAAA,EAAA,CAITN,IAAI,CAACO,SAAS,CAAC,8BAA8B,CAAC,8BAxBPxB,QAAQ,CAAA;AAAA;AAAAyB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAb,oBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAGhD;EAEAc,EAAE,GAAAzB,QAAA,CAAA,IAAA,EAAG,CAAC,CAAA;;AAEN;AAEA0B,EAAAA,QAAQ,IAAAzB,cAAA,CAAA,IAAA,CAAA,EAAAC,cAAA,OAAG,EAAE,CAAA;;AAEb;AAEAyB,EAAAA,OAAO,IAAAxB,oBAAA,CAAA,IAAA,CAAA,EAAAC,aAAA,OAAG,EAAE,CAAA;;AAEZ;EAEAwB,SAAS,IAAAvB,mBAAA,CAAA,IAAA,CAAA,EAAAC,eAAA,OAAGe,IAAI,CAACQ,MAAM,EAAE,CAAA;;AAEzB;EAEAC,SAAS,IAAAvB,qBAAA,CAAA,IAAA,CAAA,EAAAC,eAAA,OAAGa,IAAI,CAACQ,MAAM,EAAE,CAAA;;AAEzB;AAEAE,EAAAA,QAAQ,IAAAtB,qBAAA,CAAA,IAAA,CAAA,EAAAC,cAAA,OAAG,IAAI,CAAA;AAAC,EAAA;IAAAG,UAAA,EAAA;AAAA;AAElB;;;;"}

package/dist/resource/audio/CjsAudioBufferRes.js

@@ -0,0 +1,86 @@
+import { CjsError } from '@carbonenginejs/runtime-utils/errors';
+import { CjsResource as _CjsResource } from '../CjsResource.js';
+
+/**
+ * Physical audio byte-owner resource whose payload may back one complete file or several logical audio files.
+ *
+ * CjsResMan owns loading, canonical identity, and payload retention. This
+ * class only exposes the loaded payload as bytes without interpreting BNK or
+ * media semantics.
+ */
+class CjsAudioBufferRes extends _CjsResource {
+  #audioInfo = Object.freeze({});
+
+  /** Creates an unregistered physical audio resource with optional metadata. */
+  constructor(values = null) {
+    super();
+    this.SetAudioInfo(values);
+  }
+
+  /** Replaces immutable physical-source metadata before the resource loads. */
+  SetAudioInfo(values = null) {
+    if (values === null || values === undefined) {
+      this.#audioInfo = Object.freeze({});
+      return this;
+    }
+    if (!values || typeof values !== "object" || Array.isArray(values)) {
+      throw new TypeError("CjsAudioBufferRes info must be an object");
+    }
+    this.#audioInfo = Object.freeze({
+      ...values
+    });
+    return this;
+  }
+
+  /** Returns immutable physical-source metadata supplied by an audio library. */
+  GetAudioInfo() {
+    return this.#audioInfo;
+  }
+
+  /**
+   * Returns a view of the manager-owned payload while the caller holds a lock.
+   *
+   * The returned view may retain a complete bank buffer. Public media reads
+   * should use CjsAudioRes.GetBytes(), which copies only the requested window.
+   */
+  async GetByteView(options = {}) {
+    await super.GetObject(options);
+    this.KeepPayloadAlive();
+    return CjsAudioBufferRes.toUint8Array(this.GetPayload(), this.GetPath());
+  }
+
+  /** Returns a detached copy of the complete physical source. */
+  async GetBytes(options = {}) {
+    this.Lock();
+    try {
+      const view = await this.GetByteView(options);
+      return view.slice().buffer;
+    } finally {
+      this.Unlock();
+    }
+  }
+
+  /** Extracts bytes from raw reader payloads used by registered audio formats. */
+  static toUint8Array(value, path = "") {
+    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);
+    }
+    if (value && typeof value === "object" && "bytes" in value) {
+      return this.toUint8Array(value.bytes, path);
+    }
+    throw new CjsError("CJS_AUDIO_BYTES_UNAVAILABLE", `Audio resource did not produce bytes: ${path}`, {
+      details: {
+        path: String(path ?? "")
+      }
+    });
+  }
+}
+
+export { CjsAudioBufferRes };
+//# sourceMappingURL=CjsAudioBufferRes.js.map