npm - @carbonenginejs/runtime-resource - Versions diffs - 0.19.2 → 0.22.0 - Mend

@carbonenginejs/runtime-resource 0.19.2 → 0.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (308) hide show

package/dist/resource/CjsResource.js.map CHANGED Viewed

	@@ -1 +1 @@
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\";\nimport { ResourceHandlerMode } from \"./ResourceHandlerMode.js\";\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/\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 path = \"\";\n\n ext = \"\";\n\n requirement = \"\";\n\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 /* Declares that extension routes using this handler publish the resource. /\n static handlerMode = ResourceHandlerMode.RESOURCE;\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 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 GetPath() {\n return this.path;\n }\n\n /\n Get the normalized resource extension.\n \n @returns {string}\n /\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 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 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 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 IsGood() {\n this.KeepAlive();\n return this.IsPrepared();\n }\n\n /\n Return true when preparation failed.\n \n @returns {boolean}\n /\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\n// Declared as data rather than with decorators, so the resource tree stays\n// plain ESM that loads from source without a transform. Resources are not model\n// graph nodes - there is no Copy or Clone here, and SetValues/GetValues are a\n// flat schema-driven property copy - so nothing here needed the decorator form.\n// Field order is key order, and GetValues() exports in that order.\nCjsSchema.define(CjsResource, {\n className: \"CjsResource\",\n family: \"resource\",\n fields: {\n path: type.path,\n ext: type.string,\n requirement: type.string,\n state: type.string\n },\n methods: {\n Initialize: [ carbon.method, impl.adapted ],\n GetPath: [ carbon.method, impl.adapted ],\n GetExt: [ carbon.method, impl.adapted ],\n IsLoading: [ carbon.method, impl.adapted ],\n HasLoaded: [ carbon.method, impl.adapted ],\n IsPrepared: [ carbon.method, impl.adapted ],\n IsGood: [ carbon.method, impl.adapted ],\n IsFailed: [ carbon.method, impl.adapted ]\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","CjsEventEmitter","maxReloadAttempts","path","ext","requirement","state","State","EMPTY","isResource","handlerMode","ResourceHandlerMode","RESOURCE","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","__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","UNLOADED","includes","isTerminalState","define","className","family","type","string","methods","carbon","method","impl","adapted","Destroy","Dispose","dispose"],"mappings":"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"}
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\";\nimport { CjsFormatRoute } from \"../format/CjsFormatStore.js\";\nimport { ResourceHandlerMode } from \"./ResourceHandlerMode.js\";\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/\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 path = \"\";\n\n ext = \"\";\n\n requirement = \"\";\n\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 /* Declares that extension routes using this handler publish the resource. /\n static handlerMode = ResourceHandlerMode.RESOURCE;\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, \"__formatStore\", {\n value: 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 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 GetPath() {\n return this.path;\n }\n\n /\n Get the normalized resource extension.\n \n @returns {string}\n /\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 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 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 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 IsGood() {\n this.KeepAlive();\n return this.IsPrepared();\n }\n\n /\n Return true when preparation failed.\n \n @returns {boolean}\n /\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 Take over loading entirely, before the manager fetches anything.\n \n Returning `true` means this resource handled its own acquisition and the\n * manager stands down: no fetch, no queue entry. Returning `false` — the\n * default — means load it the ordinary way.\n \n This one IS optional, unlike `DoLoad`, and that is why it has a default\n * instead of a refusal. Most resources never take it. Declaring it here\n * rather than optional-chaining at the call site keeps the caller honest:\n * absence is a supported answer, so the base states the answer.\n \n @param {string} url Resolved source url.\n * @param {string} extension Lowercased extension including its dot.\n * @returns {boolean} Whether this resource handled its own load.\n /\n DoCustomLoad(url, extension) {\n return false;\n }\n\n /\n Bind the format store this resource may resolve its own reader from.\n \n A resource must not import its formats - every one of them is a\n * tree-shakeable subpath, so importing one here would drag it into every\n * consumer of this resource. Nor can it hardcode a list, because which\n * formats exist is a property of the composed application. The store is the\n * link that lets both stay true: the composition root registers what it\n * wants, and the resource asks.\n \n Optional. A resource loaded through `CjsResMan` never needs it, because the\n * manager resolves the reader from its own extension routes and hands the\n * outcome over as a payload. This is for the resource driving its own load.\n \n @param {import(\"../format/CjsFormatStore.js\").CjsFormatStore\|null} store\n * @returns {CjsResource} This resource.\n /\n SetFormatStore(store = null) {\n if (store !== null && typeof store?.Resolve !== \"function\") {\n throw new TypeError(\"CjsResource.SetFormatStore requires a format store or null.\");\n }\n this.__formatStore = store;\n return this;\n }\n\n /* The bound format store, or `null`. /\n GetFormatStore() {\n return this.__formatStore \|\| null;\n }\n\n /\n The route that should read this resource's source data.\n \n An explicitly supplied format always wins: a caller naming a reader knows\n * something the extension does not. It is wrapped in a route so callers have\n * one shape to handle either way.\n \n Otherwise the bound store answers from this resource's own extension, and\n * from an `output` only when the caller asks for one.\n \n `requirement` IS NOT THE OUTPUT, though it reads like it. It selects the\n * resource class — `CjsResMan.RegisterResourceType` keys on it. A format's\n * outputs are a different axis entirely: `texture` and `rgba` are two\n * representations of one DDS. Conflating them makes a resource loaded with\n * `requirement: \"geometry\"` filter for routes declaring an output named\n * `geometry`, find none, and resolve to null.\n \n Returns `null` when nothing answers, so the caller reports what it could\n * not read rather than handing bytes to a reader that never claimed them.\n \n @param {} [data] Source data, used to separate routes sharing an extension.\n @param {object\|null} [options] May carry an explicit `format`, `read` and `output`.\n * @returns {import(\"../format/CjsFormatStore.js\").CjsFormatRoute\|null}\n /\n ResolveFormat(data, options = null) {\n if (options?.format) {\n return new CjsFormatRoute(options.format, {\n read: options.read,\n output: options.output \|\| null\n });\n }\n return this.GetFormatStore()?.Resolve(this.ext, data, {\n output: options?.output \|\| null\n }) \|\| null;\n }\n\n /\n How this resource wants its source bytes delivered.\n \n The manager must fetch before it knows the format, so the resource states\n * what shape it needs. Defaults to the format-side default, which is what\n * every transport hardcodes today.\n \n @returns {string} A fetch response type.\n /\n GetRequestResponseType() {\n return \"arraybuffer\";\n }\n\n /\n Turn raw source bytes into this resource.\n \n Declared here rather than left to each subclass because it is the load\n * contract, not an optional capability. The base refuses rather than\n * silently succeeding: a resource reached by the loader that has not been\n * taught to read its own bytes is a registration mistake, and returning\n * quietly would publish an empty resource and mark it prepared.\n \n `Tr2EffectRes` already implements exactly this shape, and it is the only\n * resource that does. It takes container bytes and keeps the reader it\n * builds, because a shader body cannot be read later without it — strings\n * are offsets into an arena that lives in the header it consumed. No payload\n * hand-off could have carried that, which is why it bypassed the manager.\n \n @param {ArrayBuffer\|ArrayBufferView\|string} data Raw source data.\n * @param {object\|null} [options] Model values applied after the read.\n * @returns {CjsResource} This resource.\n * @throws {Error} When the concrete resource does not implement it.\n /\n DoLoad(data, options = null) {\n const className = this.constructor?.name \|\| \"CjsResource\";\n const error = new Error(\n `${className}.DoLoad is not implemented. A resource reached by the loader `\n + \"must turn its own source bytes into itself; implement DoLoad, or register \"\n + \"a format that populates this resource.\"\n );\n error.code = \"CJS_RESOURCE_LOAD_NOT_IMPLEMENTED\";\n error.className = className;\n throw error;\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\n// Declared as data rather than with decorators, so the resource tree stays\n// plain ESM that loads from source without a transform. Resources are not model\n// graph nodes - there is no Copy or Clone here, and SetValues/GetValues are a\n// flat schema-driven property copy - so nothing here needed the decorator form.\n// Field order is key order, and GetValues() exports in that order.\nCjsSchema.define(CjsResource, {\n className: \"CjsResource\",\n family: \"resource\",\n fields: {\n path: type.path,\n ext: type.string,\n requirement: type.string,\n state: type.string\n },\n methods: {\n Initialize: [ carbon.method, impl.adapted ],\n GetPath: [ carbon.method, impl.adapted ],\n GetExt: [ carbon.method, impl.adapted ],\n IsLoading: [ carbon.method, impl.adapted ],\n HasLoaded: [ carbon.method, impl.adapted ],\n IsPrepared: [ carbon.method, impl.adapted ],\n IsGood: [ carbon.method, impl.adapted ],\n IsFailed: [ carbon.method, impl.adapted ]\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","CjsEventEmitter","maxReloadAttempts","path","ext","requirement","state","State","EMPTY","isResource","handlerMode","ResourceHandlerMode","RESOURCE","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","DoCustomLoad","url","extension","SetFormatStore","store","Resolve","__formatStore","GetFormatStore","ResolveFormat","data","options","format","CjsFormatRoute","read","output","GetRequestResponseType","DoLoad","className","Error","code","GetPayload","ReleasePayload","SetLifecycleController","controller","Array","isArray","__lifecycleController","IsCurrent","Boolean","isCurrent","keepAlive","Reload","__reloadHook","SetReloadHook","hook","GetReloadAttempts","ResetReloadAttempts","keepPayloadAlive","Lock","lock","Unlock","unlock","SetObjectLoader","loader","request","__objectLoader","__objectRequest","freeze","GetObjectRequest","GetObject","Promise","reject","Ready","SetAdapterResource","key","__adapterResources","GetAdapterResource","HasAdapterResource","DestroyAdapterResource","destroy","destroyAdapterValue","DestroyAdapterResources","keys","UNLOADED","includes","isTerminalState","define","family","type","string","methods","carbon","method","impl","adapted","Destroy","Dispose","dispose"],"mappings":"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"}

package/dist/resource/ResourceRequirement.js ADDED Viewed

@@ -0,0 +1,42 @@
+/**
+ * The key that selects which resource class a path becomes.
+ *
+ * Carried by `CjsResource.requirement`, declared by each resource as
+ * `static payload`, and matched by `CjsResMan.RegisterResourceType` and
+ * `GetResource({ requirement })` — one vocabulary in three places, previously a
+ * bare literal in each, with nothing catching a typo between them.
+ *
+ * Not to be confused with a format's `outputs`, which declare each available
+ * representation rather than a class: one DDS read as `texture` or as `rgba` is
+ * the same file in the same resource.
+ *
+ * @readonly
+ * @enum {string}
+ */
+const ResourceRequirement = Object.freeze({
+  /** `TriTextureRes` */
+  TEXTURE: "texture",
+  /** `Tr2ImageRes` */
+  IMAGE: "image",
+  /** `CjsTextureArrayRes` */
+  TEXTURE_ARRAY: "texture-array",
+  /** `TriGeometryRes`, and `TriGrannyRes` — a `.gr2` is geometry, and which
+   *  geometry resource reads it is the extension route's decision. */
+  GEOMETRY: "geometry",
+  /** `Tr2GrannyStateRes` */
+  GRANNY_STATE: "granny-state",
+  /** `Tr2EffectRes` */
+  SHADER: "shader",
+  /** `Tr2LightProfileRes` */
+  LIGHT_PROFILE: "light-profile",
+  /** The audio resources. */
+  AUDIO: "audio"
+});
+/** Whether a value belongs to the requirement vocabulary. */
+function isResourceRequirement(value) {
+  return Object.values(ResourceRequirement).includes(value);
+}
+export { ResourceRequirement, isResourceRequirement };
+//# sourceMappingURL=ResourceRequirement.js.map

package/dist/resource/ResourceRequirement.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"ResourceRequirement.js","sources":["../../../src/resource/ResourceRequirement.js"],"sourcesContent":["/**\r\n * The key that selects which resource class a path becomes.\r\n *\r\n * Carried by `CjsResource.requirement`, declared by each resource as\r\n * `static payload`, and matched by `CjsResMan.RegisterResourceType` and\r\n * `GetResource({ requirement })` — one vocabulary in three places, previously a\r\n * bare literal in each, with nothing catching a typo between them.\r\n *\r\n * Not to be confused with a format's `outputs`, which declare each available\n * representation rather than a class: one DDS read as `texture` or as `rgba` is\n * the same file in the same resource.\r\n *\r\n * @readonly\r\n * @enum {string}\r\n */\r\nexport const ResourceRequirement = Object.freeze({\r\n /** `TriTextureRes` */\r\n TEXTURE: \"texture\",\r\n /** `Tr2ImageRes` */\r\n IMAGE: \"image\",\r\n /** `CjsTextureArrayRes` */\r\n TEXTURE_ARRAY: \"texture-array\",\r\n /** `TriGeometryRes`, and `TriGrannyRes` — a `.gr2` is geometry, and which\n * geometry resource reads it is the extension route's decision. */\n GEOMETRY: \"geometry\",\r\n /** `Tr2GrannyStateRes` */\r\n GRANNY_STATE: \"granny-state\",\r\n /** `Tr2EffectRes` */\r\n SHADER: \"shader\",\r\n /** `Tr2LightProfileRes` */\r\n LIGHT_PROFILE: \"light-profile\",\r\n /** The audio resources. */\r\n AUDIO: \"audio\"\r\n});\r\n\r\n/** Whether a value belongs to the requirement vocabulary. */\r\nexport function isResourceRequirement(value)\r\n{\r\n return Object.values(ResourceRequirement).includes(value);\r\n}\r\n\r\nexport default ResourceRequirement;\r\n"],"names":["ResourceRequirement","Object","freeze","TEXTURE","IMAGE","TEXTURE_ARRAY","GEOMETRY","GRANNY_STATE","SHADER","LIGHT_PROFILE","AUDIO","isResourceRequirement","value","values","includes"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;MACaA,mBAAmB,GAAGC,MAAM,CAACC,MAAM,CAAC;AAC/C;AACAC,EAAAA,OAAO,EAAE,SAAS;AAClB;AACAC,EAAAA,KAAK,EAAE,OAAO;AACd;AACAC,EAAAA,aAAa,EAAE,eAAe;AAC9B;AACF;AACEC,EAAAA,QAAQ,EAAE,UAAU;AACpB;AACAC,EAAAA,YAAY,EAAE,cAAc;AAC5B;AACAC,EAAAA,MAAM,EAAE,QAAQ;AAChB;AACAC,EAAAA,aAAa,EAAE,eAAe;AAC9B;AACAC,EAAAA,KAAK,EAAE;AACT,CAAC;;AAED;AACO,SAASC,qBAAqBA,CAACC,KAAK,EAC3C;EACE,OAAOX,MAAM,CAACY,MAAM,CAACb,mBAAmB,CAAC,CAACc,QAAQ,CAACF,KAAK,CAAC;AAC3D;;;;"}

package/dist/resource/Tr2LightProfileRes.js CHANGED Viewed

@@ -1,6 +1,7 @@
 import { CjsSchema } from '@carbonenginejs/runtime-utils/schema';
 import { CjsResource } from './CjsResource.js';
 import { assertResourcePayloadObject } from './resourceBoundary.js';
+import { ResourceRequirement } from './ResourceRequirement.js';
 // Source: trinity/trinity/Resources/Tr2LightProfileRes.h
@@ -21,7 +22,7 @@ class Tr2LightProfileRes extends CjsResource {
     super.SetPayload(payload);
     return this;
   }
-  static payload = "light-profile";
+  static payload = ResourceRequirement.LIGHT_PROFILE;
 }
 CjsSchema.define(Tr2LightProfileRes, {
   className: "Tr2LightProfileRes",

package/dist/resource/Tr2LightProfileRes.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Tr2LightProfileRes.js","sources":["../../../src/resource/Tr2LightProfileRes.js"],"sourcesContent":["// Source: trinity/trinity/Resources/Tr2LightProfileRes.h\nimport { CjsSchema } 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 /\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\nCjsSchema.define(Tr2LightProfileRes, {\n className: \"Tr2LightProfileRes\",\n family: \"resources\"\n});\n"],"names":["Tr2LightProfileRes","CjsResource","SetPayload","payload","assertResourcePayloadObject","CjsSchema","define","className","family"],"mappings":"~~;;;;~~AAAA;;~~AAKA~~;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,kBAAkB,SAASC,WAAW,CACnD;AACE;AACAC,EAAAA,UAAUA,CAACC,OAAO,GAAG,IAAI,EACzB;IACE,IAAIA,OAAO,KAAK,IAAI,EACpB;AACE,MAAA,KAAK,CAACD,UAAU,CAAC,IAAI,CAAC;AACtB,MAAA,OAAO,IAAI;AACb,IAAA;AACAE,IAAAA,2BAA2B,CAAC,oBAAoB,EAAED,OAAO,CAAC;AAC1D,IAAA,KAAK,CAACD,UAAU,CAACC,OAAO,CAAC;AACzB,IAAA,OAAO,IAAI;AACb,EAAA;~~EAEA~~,OAAOA,OAAO,~~GAAG~~,~~eAAe~~;~~AAClC~~;~~AAEAE~~,SAAS,CAACC,MAAM,~~CAACN~~,kBAAkB,EAAE;~~AACnCO~~,EAAAA,SAAS,EAAE,oBAAoB;AAC/BC,EAAAA,MAAM,EAAE;AACV,CAAC,CAAC;;;;"}
1	+ {"version":3,"file":"Tr2LightProfileRes.js","sources":["../../../src/resource/Tr2LightProfileRes.js"],"sourcesContent":["// Source: trinity/trinity/Resources/Tr2LightProfileRes.h\nimport { CjsSchema } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsResource } from \"./CjsResource.js\";\nimport { assertResourcePayloadObject } from \"./resourceBoundary.js\";\nimport { ResourceRequirement } from \"./ResourceRequirement.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 /\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 = ResourceRequirement.LIGHT_PROFILE;\n}\n\nCjsSchema.define(Tr2LightProfileRes, {\n className: \"Tr2LightProfileRes\",\n family: \"resources\"\n});\n"],"names":["Tr2LightProfileRes","CjsResource","SetPayload","payload","assertResourcePayloadObject","ResourceRequirement","LIGHT_PROFILE","CjsSchema","define","className","family"],"mappings":";;;;;AAAA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,kBAAkB,SAASC,WAAW,CACnD;AACE;AACAC,EAAAA,UAAUA,CAACC,OAAO,GAAG,IAAI,EACzB;IACE,IAAIA,OAAO,KAAK,IAAI,EACpB;AACE,MAAA,KAAK,CAACD,UAAU,CAAC,IAAI,CAAC;AACtB,MAAA,OAAO,IAAI;AACb,IAAA;AACAE,IAAAA,2BAA2B,CAAC,oBAAoB,EAAED,OAAO,CAAC;AAC1D,IAAA,KAAK,CAACD,UAAU,CAACC,OAAO,CAAC;AACzB,IAAA,OAAO,IAAI;AACb,EAAA;AAEA,EAAA,OAAOA,OAAO,GAAGE,mBAAmB,CAACC,aAAa;AACpD;AAEAC,SAAS,CAACC,MAAM,CAACR,kBAAkB,EAAE;AACnCS,EAAAA,SAAS,EAAE,oBAAoB;AAC/BC,EAAAA,MAAM,EAAE;AACV,CAAC,CAAC;;;;"}

package/dist/resource/geometry/TriGeometryRes.js CHANGED Viewed

@@ -1,3 +1,4 @@
+import { ResourceRequirement } from '../ResourceRequirement.js';
 import { CjsSchema, carbon, impl, type, io } from '@carbonenginejs/runtime-utils/schema';
 import { box3 } from '@carbonenginejs/runtime-utils/box3';
 import { triangleNormalTo } from '@carbonenginejs/runtime-utils/mesh';
@@ -8,10 +9,6 @@ import { vec4 } from '@carbonenginejs/runtime-utils/vec4';
 import { CjsResource } from '../CjsResource.js';
 import { assertResourcePayloadObject, assertResourcePayloadArray, resourcePayloadError, resourceBoundaryError } from '../resourceBoundary.js';
-// Source: trinity/trinity/Resources/TriGeometryRes.h
-// Source: trinity/trinity/Resources/TriGeometryRes.cpp
-// Source: trinity/trinity/Resources/TriGeometryRes_Blue.cpp
 /**
  * Resource record that owns geometry payload facts (meshes, optional
  * skeletons and animations) and LOD-force metadata, while engine packages
@@ -319,7 +316,7 @@ class TriGeometryRes extends CjsResource {
    * @returns {object}
    */
   GetIntersectionPointNormalBone(position, direction) {
-    return TriGeometryRes.intersectGeometry(this.GetPayload()?.meshes, position, direction, -1);
+    return TriGeometryRes.intersectGeometry(this.RequireIntersectionMeshes(), position, direction, -1);
   }
   /**
@@ -334,7 +331,37 @@ class TriGeometryRes extends CjsResource {
     if (!Number.isInteger(areaIndex) || areaIndex < -1) {
       throw new RangeError("TriGeometryRes area index must be -1 or a non-negative integer.");
     }
-    return TriGeometryRes.intersectGeometry(this.GetPayload()?.meshes, position, direction, areaIndex);
+    return TriGeometryRes.intersectGeometry(this.RequireIntersectionMeshes(), position, direction, areaIndex);
+  }
+  /**
+   * The CPU triangle data an intersection query needs, or a loud failure.
+   *
+   * A ray query used to read `GetPayload()?.meshes`, and `intersectGeometry`
+   * loops over `meshes?.length || 0`. So an absent payload produced a clean
+   * MISS: `hit: false`, no error, indistinguishable from the ray genuinely
+   * passing the object by. Picking would appear to work and simply stop
+   * hitting things, and the symptom reads as a maths bug rather than a
+   * residency one.
+   *
+   * Carbon never has to answer this, because it holds the loaded file for the
+   * resource's lifetime and its CPU data is always resident. Ours is
+   * releasable, so the unavailable case is real and must be named.
+   *
+   * Throwing is the interim answer, not the final one: once accuracy tiers
+   * exist a query degrades to bounds or sphere and reports which produced it.
+   * What it must never do again is report absence as a miss. See
+   * `/docs/contracts/cpu-geometry-residency.md`.
+   *
+   * @returns {Array<*>} Canonical CPU meshes.
+   * @throws {Error} When the CPU geometry is not resident.
+   */
+  RequireIntersectionMeshes() {
+    const meshes = this.GetPayload()?.meshes;
+    if (!Array.isArray(meshes)) {
+      throw new Error("TriGeometryRes cannot answer an intersection query: CPU geometry is " + "not resident. The payload was never loaded or has been released. " + "Reload through CjsResMan before querying.");
+    }
+    return meshes;
   }
   /**
@@ -360,7 +387,7 @@ class TriGeometryRes extends CjsResource {
   SaveMesh() {
     throw resourceBoundaryError("TriGeometryRes", "SaveMesh", "Use a geometry format writer with the resource payload and a caller-owned destination.");
   }
-  static payload = "geometry";
+  static payload = ResourceRequirement.GEOMETRY;
   // Carbon TriGeometryRes.cpp:158-178, declared beside the class
   // (TriGeometryRes.h:202) because it reads LOD data rather than resource