@carbonenginejs/runtime-resource 0.1.0 → 0.7.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 (186) hide show
  1. package/FORMAT-PROVENANCE.md +14 -5
  2. package/README.md +537 -241
  3. package/dist/CjsMotherLode.js +1244 -29
  4. package/dist/CjsMotherLode.js.map +1 -1
  5. package/dist/CjsResMan.js +2537 -272
  6. package/dist/CjsResMan.js.map +1 -1
  7. package/dist/CjsResource.js +218 -18
  8. package/dist/CjsResource.js.map +1 -1
  9. package/dist/format/CjsBlueReader.js +269 -0
  10. package/dist/format/CjsBlueReader.js.map +1 -0
  11. package/dist/format/CjsFormat.js +44 -30
  12. package/dist/format/CjsFormat.js.map +1 -1
  13. package/dist/format/CjsReader.js +18 -0
  14. package/dist/format/CjsReader.js.map +1 -0
  15. package/dist/format/CjsResourceProbe.js +12 -4
  16. package/dist/format/CjsResourceProbe.js.map +1 -1
  17. package/dist/formats/black/CjsBlackFormat.js +12 -6
  18. package/dist/formats/black/CjsBlackFormat.js.map +1 -1
  19. package/dist/formats/black/core/CjsBlackReader.js +27 -148
  20. package/dist/formats/black/core/CjsBlackReader.js.map +1 -1
  21. package/dist/formats/bnk/CjsBnkFormat.js +140 -147
  22. package/dist/formats/bnk/CjsBnkFormat.js.map +1 -1
  23. package/dist/formats/bnk/core/graph.js +140 -0
  24. package/dist/formats/bnk/core/graph.js.map +1 -0
  25. package/dist/formats/bnk/core/helpers.js +58 -3
  26. package/dist/formats/bnk/core/helpers.js.map +1 -1
  27. package/dist/formats/bnk/core/musicNodes.js +521 -0
  28. package/dist/formats/bnk/core/musicNodes.js.map +1 -0
  29. package/dist/formats/bnk/index.js +0 -1
  30. package/dist/formats/bnk/index.js.map +1 -1
  31. package/dist/formats/cmf/CjsCmfFormat.js +14 -8
  32. package/dist/formats/cmf/CjsCmfFormat.js.map +1 -1
  33. package/dist/formats/dds/CjsDdsFormat.js +12 -6
  34. package/dist/formats/dds/CjsDdsFormat.js.map +1 -1
  35. package/dist/formats/fbx/CjsFbxFormat.js +12 -6
  36. package/dist/formats/fbx/CjsFbxFormat.js.map +1 -1
  37. package/dist/formats/flac/CjsFlacFormat.js +10 -4
  38. package/dist/formats/flac/CjsFlacFormat.js.map +1 -1
  39. package/dist/formats/gif/CjsGifFormat.js +11 -5
  40. package/dist/formats/gif/CjsGifFormat.js.map +1 -1
  41. package/dist/formats/gltf/CjsGltfFormat.js +12 -6
  42. package/dist/formats/gltf/CjsGltfFormat.js.map +1 -1
  43. package/dist/formats/jpeg/CjsJpegFormat.js +11 -5
  44. package/dist/formats/jpeg/CjsJpegFormat.js.map +1 -1
  45. package/dist/formats/mp3/CjsMp3Format.js +11 -5
  46. package/dist/formats/mp3/CjsMp3Format.js.map +1 -1
  47. package/dist/formats/mp4/CjsMp4Format.js +10 -4
  48. package/dist/formats/mp4/CjsMp4Format.js.map +1 -1
  49. package/dist/formats/obj/CjsObjFormat.js +12 -6
  50. package/dist/formats/obj/CjsObjFormat.js.map +1 -1
  51. package/dist/formats/ogg/CjsOggFormat.js +9 -3
  52. package/dist/formats/ogg/CjsOggFormat.js.map +1 -1
  53. package/dist/formats/png/CjsPngFormat.js +11 -5
  54. package/dist/formats/png/CjsPngFormat.js.map +1 -1
  55. package/dist/formats/red/CjsRedFormat.js +19 -5
  56. package/dist/formats/red/CjsRedFormat.js.map +1 -1
  57. package/dist/formats/red/core/CjsRedReader.js +63 -70
  58. package/dist/formats/red/core/CjsRedReader.js.map +1 -1
  59. package/dist/formats/red/core/helpers.js +3 -0
  60. package/dist/formats/red/core/helpers.js.map +1 -1
  61. package/dist/formats/stl/CjsStlFormat.js +77 -16
  62. package/dist/formats/stl/CjsStlFormat.js.map +1 -1
  63. package/dist/formats/stl/core/helpers.js +4 -0
  64. package/dist/formats/stl/core/helpers.js.map +1 -1
  65. package/dist/formats/stl/core/stl.js +100 -15
  66. package/dist/formats/stl/core/stl.js.map +1 -1
  67. package/dist/formats/tga/CjsTgaFormat.js +11 -5
  68. package/dist/formats/tga/CjsTgaFormat.js.map +1 -1
  69. package/dist/formats/wav/CjsWavFormat.js +11 -5
  70. package/dist/formats/wav/CjsWavFormat.js.map +1 -1
  71. package/dist/formats/webm/CjsWebmFormat.js +10 -4
  72. package/dist/formats/webm/CjsWebmFormat.js.map +1 -1
  73. package/dist/formats/webp/CjsWebpFormat.js +9 -3
  74. package/dist/formats/webp/CjsWebpFormat.js.map +1 -1
  75. package/dist/formats/wem/CjsWemFormat.js +50 -6
  76. package/dist/formats/wem/CjsWemFormat.js.map +1 -1
  77. package/dist/formats/wem/core/helpers.js +84 -3
  78. package/dist/formats/wem/core/helpers.js.map +1 -1
  79. package/dist/formats/wem/core/ptadpcm.js +77 -0
  80. package/dist/formats/wem/core/ptadpcm.js.map +1 -0
  81. package/dist/formats/wem/core/resolve.js +121 -0
  82. package/dist/formats/wem/core/resolve.js.map +1 -0
  83. package/dist/formats/yaml/CjsYamlFormat.js +11 -5
  84. package/dist/formats/yaml/CjsYamlFormat.js.map +1 -1
  85. package/dist/formats/yaml/core/CjsYamlReader.js +3 -2
  86. package/dist/formats/yaml/core/CjsYamlReader.js.map +1 -1
  87. package/dist/index.js +28 -32
  88. package/dist/index.js.map +1 -1
  89. package/dist/{generated/resources → resources}/AudioGeometryResData.js +2 -2
  90. package/dist/resources/AudioGeometryResData.js.map +1 -0
  91. package/dist/{generated/resources → resources}/GStateBindingCallbackData.js +2 -2
  92. package/dist/resources/GStateBindingCallbackData.js.map +1 -0
  93. package/dist/{generated/resources → resources}/MeshDecalData.js +2 -2
  94. package/dist/resources/MeshDecalData.js.map +1 -0
  95. package/dist/{generated/resources → resources}/MeshDecalLodData.js +2 -2
  96. package/dist/resources/MeshDecalLodData.js.map +1 -0
  97. package/dist/resources/Tr2GrannyIntersectionResult.js +60 -0
  98. package/dist/resources/Tr2GrannyIntersectionResult.js.map +1 -0
  99. package/dist/{generated/resources → resources}/Tr2MaterialArea.js +2 -2
  100. package/dist/resources/Tr2MaterialArea.js.map +1 -0
  101. package/dist/{generated/resources → resources}/Tr2MaterialMesh.js +2 -2
  102. package/dist/resources/Tr2MaterialMesh.js.map +1 -0
  103. package/dist/{generated/resources → resources}/Tr2MaterialRes.js +2 -2
  104. package/dist/resources/Tr2MaterialRes.js.map +1 -0
  105. package/dist/{generated/resources → resources}/Tr2ShaderPermutation.js +2 -2
  106. package/dist/resources/Tr2ShaderPermutation.js.map +1 -0
  107. package/dist/{generated/resources → resources}/Tr2TextureLodManager.js +50 -10
  108. package/dist/resources/Tr2TextureLodManager.js.map +1 -0
  109. package/dist/{generated/resources → resources}/Tr2TextureLodUpdateRequest.js +2 -2
  110. package/dist/resources/Tr2TextureLodUpdateRequest.js.map +1 -0
  111. package/dist/{generated/resources → resources}/Tr2TexturePackChannel.js +2 -2
  112. package/dist/resources/Tr2TexturePackChannel.js.map +1 -0
  113. package/dist/resources/Tr2TexturePipeline.js +68 -0
  114. package/dist/resources/Tr2TexturePipeline.js.map +1 -0
  115. package/dist/{generated/resources → resources}/Tr2TexturePipelineParams.js +2 -2
  116. package/dist/resources/Tr2TexturePipelineParams.js.map +1 -0
  117. package/dist/{generated/resources → resources}/Tr2TexturePipelineStepCompress.js +3 -3
  118. package/dist/resources/Tr2TexturePipelineStepCompress.js.map +1 -0
  119. package/dist/{generated/resources → resources}/Tr2TexturePipelineStepLimitSize.js +2 -2
  120. package/dist/resources/Tr2TexturePipelineStepLimitSize.js.map +1 -0
  121. package/dist/{generated/resources → resources}/Tr2TexturePipelineStepLoad.js +2 -2
  122. package/dist/resources/Tr2TexturePipelineStepLoad.js.map +1 -0
  123. package/dist/{generated/resources → resources}/Tr2TexturePipelineStepPack.js +3 -3
  124. package/dist/resources/Tr2TexturePipelineStepPack.js.map +1 -0
  125. package/dist/{generated/resources → resources}/TriGeometryResAreaData.js +2 -2
  126. package/dist/resources/TriGeometryResAreaData.js.map +1 -0
  127. package/dist/{generated/resources → resources}/TriGeometryResJointData.js +2 -2
  128. package/dist/resources/TriGeometryResJointData.js.map +1 -0
  129. package/dist/{generated/resources → resources}/TriGeometryResLodData.js +2 -2
  130. package/dist/resources/TriGeometryResLodData.js.map +1 -0
  131. package/dist/{generated/resources → resources}/TriGeometryResMeshData.js +2 -2
  132. package/dist/resources/TriGeometryResMeshData.js.map +1 -0
  133. package/dist/{generated/resources → resources}/TriGeometryResSkeletonData.js +2 -2
  134. package/dist/resources/TriGeometryResSkeletonData.js.map +1 -0
  135. package/dist/{generated/resources → resources}/TriJointBinding.js +2 -2
  136. package/dist/resources/TriJointBinding.js.map +1 -0
  137. package/dist/{generated/resources → resources}/TriMorphTargetGeometryConstants.js +2 -2
  138. package/dist/resources/TriMorphTargetGeometryConstants.js.map +1 -0
  139. package/dist/{generated/resources → resources}/TriRtGeometryConstants.js +2 -2
  140. package/dist/resources/TriRtGeometryConstants.js.map +1 -0
  141. package/dist/resources/enums.js.map +1 -0
  142. package/dist/resources/texturePipelineBehavior.js +320 -0
  143. package/dist/resources/texturePipelineBehavior.js.map +1 -0
  144. package/format-notices/bnk/NOTICE +7 -4
  145. package/package.json +51 -51
  146. package/resource-lifecycle.md +262 -70
  147. package/dist/generated/resources/AudioGeometryResData.js.map +0 -1
  148. package/dist/generated/resources/CmfVertexReader.js +0 -46
  149. package/dist/generated/resources/CmfVertexReader.js.map +0 -1
  150. package/dist/generated/resources/GStateBindingCallbackData.js.map +0 -1
  151. package/dist/generated/resources/MeshDecalData.js.map +0 -1
  152. package/dist/generated/resources/MeshDecalLodData.js.map +0 -1
  153. package/dist/generated/resources/Tr2AsyncSave.js +0 -46
  154. package/dist/generated/resources/Tr2AsyncSave.js.map +0 -1
  155. package/dist/generated/resources/Tr2CmfContents.js +0 -37
  156. package/dist/generated/resources/Tr2CmfContents.js.map +0 -1
  157. package/dist/generated/resources/Tr2GrannyIntersectionResult.js +0 -58
  158. package/dist/generated/resources/Tr2GrannyIntersectionResult.js.map +0 -1
  159. package/dist/generated/resources/Tr2LoadPrepareFence.js +0 -37
  160. package/dist/generated/resources/Tr2LoadPrepareFence.js.map +0 -1
  161. package/dist/generated/resources/Tr2MaterialArea.js.map +0 -1
  162. package/dist/generated/resources/Tr2MaterialMesh.js.map +0 -1
  163. package/dist/generated/resources/Tr2MaterialRes.js.map +0 -1
  164. package/dist/generated/resources/Tr2ShaderPermutation.js.map +0 -1
  165. package/dist/generated/resources/Tr2TextureLodManager.js.map +0 -1
  166. package/dist/generated/resources/Tr2TextureLodUpdateRequest.js.map +0 -1
  167. package/dist/generated/resources/Tr2TexturePackChannel.js.map +0 -1
  168. package/dist/generated/resources/Tr2TexturePipeline.js +0 -44
  169. package/dist/generated/resources/Tr2TexturePipeline.js.map +0 -1
  170. package/dist/generated/resources/Tr2TexturePipelineParams.js.map +0 -1
  171. package/dist/generated/resources/Tr2TexturePipelineStepCompress.js.map +0 -1
  172. package/dist/generated/resources/Tr2TexturePipelineStepLimitSize.js.map +0 -1
  173. package/dist/generated/resources/Tr2TexturePipelineStepLoad.js.map +0 -1
  174. package/dist/generated/resources/Tr2TexturePipelineStepPack.js.map +0 -1
  175. package/dist/generated/resources/TriGeometryResAreaData.js.map +0 -1
  176. package/dist/generated/resources/TriGeometryResJointData.js.map +0 -1
  177. package/dist/generated/resources/TriGeometryResLodData.js.map +0 -1
  178. package/dist/generated/resources/TriGeometryResMeshData.js.map +0 -1
  179. package/dist/generated/resources/TriGeometryResSkeletonData.js.map +0 -1
  180. package/dist/generated/resources/TriJointBinding.js.map +0 -1
  181. package/dist/generated/resources/TriMorphTargetGeometryConstants.js.map +0 -1
  182. package/dist/generated/resources/TriRtGeometryConstants.js.map +0 -1
  183. package/dist/generated/resources/enums.js.map +0 -1
  184. package/dist/generated/resources/index.js +0 -32
  185. package/dist/generated/resources/index.js.map +0 -1
  186. /package/dist/{generated/resources → resources}/enums.js +0 -0
@@ -4,6 +4,26 @@ import { type, carbon, impl, CjsSchema } from '@carbonenginejs/core-types/schema
4
4
  import { normalizeResourcePath, getResourceExtension } from './resourcePath.js';
5
5
 
6
6
  let _initProto, _initClass, _init_path, _init_extra_path, _init_ext, _init_extra_ext, _init_requirement, _init_extra_requirement, _init_state, _init_extra_state;
7
+
8
+ /**
9
+ * Deterministic activity values accepted by resource-facing lease methods.
10
+ *
11
+ * @typedef {object} CjsResourceActivityOptions
12
+ * @property {number} [frame] Explicit non-negative activity frame.
13
+ * @property {number} [time] Explicit non-negative activity timestamp in milliseconds.
14
+ */
15
+
16
+ /**
17
+ * Manager-owned callbacks attached while a resource has canonical ownership.
18
+ * The controller deliberately contains no load, fetch, prepare, or reload hook.
19
+ *
20
+ * @typedef {object} CjsResourceLifecycleController
21
+ * @property {Function} [isCurrent] Tests exact canonical manager ownership without renewing activity.
22
+ * @property {Function} [keepAlive] Renews canonical identity activity.
23
+ * @property {Function} [keepPayloadAlive] Renews identity and CPU-payload activity.
24
+ * @property {Function} [lock] Adds one inactivity-purge lock and returns its count.
25
+ * @property {Function} [unlock] Releases one inactivity-purge lock and returns its count.
26
+ */
7
27
  let _CjsResource;
8
28
  new class extends _identity {
9
29
  static [class CjsResource extends CjsEventEmitter {
@@ -24,6 +44,14 @@ new class extends _identity {
24
44
  get isResource() {
25
45
  return true;
26
46
  }
47
+
48
+ /**
49
+ * Create a detached runtime resource with empty identity and payload state.
50
+ * Schema values are applied without attaching manager lifecycle callbacks;
51
+ * CjsResMan supplies those callbacks after canonical insertion.
52
+ *
53
+ * @param {object|null} [values=null] Initial decorated schema-field values.
54
+ */
27
55
  constructor(values = null) {
28
56
  super(), _init_extra_state(this);
29
57
  Object.defineProperty(this, "__adapterResources", {
@@ -38,6 +66,18 @@ new class extends _identity {
38
66
  configurable: true,
39
67
  writable: true
40
68
  });
69
+ Object.defineProperty(this, "__objectRequest", {
70
+ value: null,
71
+ enumerable: false,
72
+ configurable: true,
73
+ writable: true
74
+ });
75
+ Object.defineProperty(this, "__lifecycleController", {
76
+ value: null,
77
+ enumerable: false,
78
+ configurable: true,
79
+ writable: true
80
+ });
41
81
  if (values) {
42
82
  this.SetValues(values);
43
83
  }
@@ -109,7 +149,12 @@ new class extends _identity {
109
149
  return this.ext;
110
150
  }
111
151
 
112
- /** Return the semantic outcome requested from this source path. */
152
+ /**
153
+ * Return the normalized semantic outcome requested from this source path.
154
+ * This metadata query is pure and does not renew manager activity.
155
+ *
156
+ * @returns {string} Lowercase requirement name, or an empty string.
157
+ */
113
158
  GetRequirement() {
114
159
  return this.requirement;
115
160
  }
@@ -187,6 +232,27 @@ new class extends _identity {
187
232
  MarkGood() {
188
233
  return this.MarkPrepared();
189
234
  }
235
+
236
+ /**
237
+ * Mark this detached resource handle as purged after a successful
238
+ * manager-owned policy eviction, such as inactivity or recorded-byte cache
239
+ * pressure, released its adapter allocations and payload.
240
+ *
241
+ * @returns {CjsResource} This purged resource.
242
+ */
243
+ MarkPurged() {
244
+ return this.SetState(_CjsResource.State.PURGED);
245
+ }
246
+
247
+ /**
248
+ * Return whether deterministic manager cleanup has purged this handle.
249
+ * This is a pure state query and never renews resource activity.
250
+ *
251
+ * @returns {boolean} `true` when the current state is `PURGED`.
252
+ */
253
+ IsPurged() {
254
+ return this.state === _CjsResource.State.PURGED;
255
+ }
190
256
  SetError(error) {
191
257
  this.error = error || null;
192
258
  return this.SetState(_CjsResource.State.FAILED, this.error);
@@ -195,29 +261,39 @@ new class extends _identity {
195
261
  /**
196
262
  * Store the plain CPU payload associated with this resource.
197
263
  * Concrete resource classes validate the fields they require before calling
198
- * this method.
264
+ * this method. If the compatibility `object` property still aliases the
265
+ * previous payload, it is updated to the replacement; semantic resources
266
+ * whose `object` points to the resource itself are unaffected. A non-null
267
+ * payload explicitly renews its manager-owned identity and payload leases;
268
+ * payload reads remain pure and do not renew either lease.
199
269
  *
200
- * @param {*} payload
201
- * @returns {CjsResource}
270
+ * @param {*} payload Plain reader/converter output, or `null` to clear it.
271
+ * @returns {CjsResource} This resource with the supplied payload reference.
202
272
  */
203
273
  SetPayload(payload = null) {
274
+ const previous = this.#payload;
204
275
  this.#payload = payload;
276
+ if (this.object === previous) this.object = payload;
277
+ if (this.HasPayload()) this.KeepPayloadAlive();
205
278
  return this;
206
279
  }
207
280
 
208
281
  /**
209
282
  * Read the plain CPU payload associated with this resource.
210
283
  *
211
- * @returns {*}
284
+ * The query is pure and does not renew the payload lease.
285
+ *
286
+ * @returns {*} Current payload reference, or `null` after release.
212
287
  */
213
288
  GetPayload() {
214
289
  return this.#payload;
215
290
  }
216
291
 
217
292
  /**
218
- * Returns true when a payload has been explicitly assigned.
293
+ * Return whether a payload has been explicitly assigned. This query is pure
294
+ * and does not renew the payload lease.
219
295
  *
220
- * @returns {boolean}
296
+ * @returns {boolean} Whether a non-null payload is attached.
221
297
  */
222
298
  HasPayload() {
223
299
  return this.#payload !== null && this.#payload !== undefined;
@@ -225,32 +301,154 @@ new class extends _identity {
225
301
 
226
302
  /**
227
303
  * Release the complete payload reference after consumers have retained the
228
- * scalars and typed-array views they require.
304
+ * scalars and typed-array views they require. When the compatibility
305
+ * `object` property still aliases that exact payload, it is cleared as part
306
+ * of the same ownership release. Semantic resources whose `object` property
307
+ * points to the resource itself are unaffected.
308
+ *
309
+ * @returns {CjsResource} This resource without its former payload reference.
229
310
  */
230
311
  ReleasePayload() {
312
+ const payload = this.#payload;
231
313
  this.#payload = null;
314
+ if (this.object === payload) this.object = null;
232
315
  return this;
233
316
  }
234
317
 
235
318
  /**
236
- * Bind the manager-owned object operation for this shared resource handle.
319
+ * Bind or detach the manager callbacks used by explicit resource-facing
320
+ * liveness operations. Runtime resources remain usable when unbound; their
321
+ * liveness methods then become deterministic no-ops.
237
322
  *
238
- * @param {Function|null} loader
239
- * @returns {CjsResource}
323
+ * @param {CjsResourceLifecycleController|null} controller Manager callbacks, or `null` after canonical ownership ends.
324
+ * @returns {CjsResource} This resource.
325
+ * @throws {TypeError} If the controller or any supplied callback is invalid.
326
+ */
327
+ SetLifecycleController(controller = null) {
328
+ if (controller !== null && (typeof controller !== "object" || Array.isArray(controller))) {
329
+ throw new TypeError("CjsResource lifecycle controller must be an object or null.");
330
+ }
331
+ for (const name of ["isCurrent", "keepAlive", "keepPayloadAlive", "lock", "unlock"]) {
332
+ if (controller?.[name] !== undefined && typeof controller[name] !== "function") {
333
+ throw new TypeError(`CjsResource lifecycle controller ${name} must be a function.`);
334
+ }
335
+ }
336
+ this.__lifecycleController = controller;
337
+ return this;
338
+ }
339
+
340
+ /**
341
+ * Return whether this handle is still the manager's canonical resource.
342
+ *
343
+ * Engine adapters use this immediately before synchronously attaching a
344
+ * completed backend candidate. Detached resources return `false`; the query
345
+ * never renews activity, reloads data, or mutates lifecycle state.
346
+ *
347
+ * @returns {boolean} Whether the bound manager still owns this exact handle.
348
+ */
349
+ IsCurrent() {
350
+ return Boolean(this.__lifecycleController?.isCurrent?.());
351
+ }
352
+
353
+ /**
354
+ * Explicitly renew this resource's canonical identity activity.
355
+ * Unlike ccpwgl compatibility behavior, `IsGood()`, `HasLoaded()`, and other
356
+ * state queries never call this method implicitly. Renewal never fetches or
357
+ * reloads a purged resource.
358
+ *
359
+ * @param {CjsResourceActivityOptions} [options={}] Optional deterministic activity values.
360
+ * @returns {CjsResource} This resource, whether bound or detached.
361
+ * @throws {TypeError} If the bound manager rejects invalid activity values.
362
+ */
363
+ KeepAlive(options = {}) {
364
+ this.__lifecycleController?.keepAlive?.(options);
365
+ return this;
366
+ }
367
+
368
+ /**
369
+ * Explicitly renew both canonical identity activity and the attached CPU
370
+ * payload lease. Reading the payload through `GetPayload()` or
371
+ * `HasPayload()` remains pure.
372
+ *
373
+ * @param {CjsResourceActivityOptions} [options={}] Optional deterministic activity values.
374
+ * @returns {CjsResource} This resource, whether a payload exists or not.
375
+ * @throws {TypeError} If the bound manager rejects invalid activity values.
376
+ */
377
+ KeepPayloadAlive(options = {}) {
378
+ this.__lifecycleController?.keepPayloadAlive?.(options);
379
+ return this;
380
+ }
381
+
382
+ /**
383
+ * Add one explicit purge lock through the bound manager and renew identity
384
+ * activity. Locking never reloads or prepares a resource.
385
+ *
386
+ * @returns {number} New lock count, or `0` when this resource is detached.
240
387
  */
241
- SetObjectLoader(loader = null) {
388
+ Lock() {
389
+ return this.__lifecycleController?.lock?.() || 0;
390
+ }
391
+
392
+ /**
393
+ * Release one explicit purge lock without allowing the count to underflow.
394
+ * Unlocking does not immediately purge or release a payload.
395
+ *
396
+ * @returns {number} Remaining lock count, or `0` when detached or unlocked.
397
+ */
398
+ Unlock() {
399
+ return this.__lifecycleController?.unlock?.() || 0;
400
+ }
401
+
402
+ /**
403
+ * Bind the manager-owned object operation and compact reconstruction request
404
+ * for this shared resource handle. The request contains source provenance
405
+ * and requested-output defaults, not reader implementations or registry
406
+ * history.
407
+ *
408
+ * @param {Function|null} loader Manager callback, or `null` to detach it.
409
+ * @param {object|null} [request=null] Compact reconstruction defaults retained with the handle.
410
+ * @returns {CjsResource} This resource with the supplied loader binding.
411
+ * @throws {TypeError} If the loader or reconstruction request is invalid.
412
+ */
413
+ SetObjectLoader(loader = null, request = null) {
242
414
  if (loader !== null && typeof loader !== "function") {
243
415
  throw new TypeError("CjsResource.SetObjectLoader requires a function or null.");
244
416
  }
417
+ if (request !== null && (!request || typeof request !== "object" || Array.isArray(request))) {
418
+ throw new TypeError("CjsResource.SetObjectLoader request must be an object or null.");
419
+ }
245
420
  this.__objectLoader = loader;
421
+ this.__objectRequest = request === null ? null : Object.freeze({
422
+ ...request
423
+ });
246
424
  return this;
247
425
  }
248
426
 
249
427
  /**
250
- * Return the manager-owned, deduplicated object operation.
428
+ * Return the compact manager request retained for explicit reconstruction.
429
+ * This query is pure and exposes no reader, constructor, or implementation
430
+ * identity.
251
431
  *
252
- * @param {object} options
253
- * @returns {Promise<*>}
432
+ * @returns {Readonly<object>|null} Frozen reconstruction defaults, or `null` when unbound.
433
+ */
434
+ GetObjectRequest() {
435
+ return this.__objectRequest;
436
+ }
437
+
438
+ /**
439
+ * Return the manager-owned object outcome for this resource identity.
440
+ * Concurrent callers share one in-flight operation. A resident payload is
441
+ * returned without source work; after explicit payload release, this call is
442
+ * an explicit reconstruction request and may load/prepare through the bound
443
+ * manager. Detached or purged handles do not revive themselves: their loader
444
+ * resolves the manager's current canonical identity.
445
+ *
446
+ * Promised-output fields retained by the handle take precedence over fields
447
+ * supplied here; operation policy such as cache/reload controls may still be
448
+ * overridden.
449
+ *
450
+ * @param {object} [options={}] Source, format, semantic outcome, and queue options forwarded to the manager.
451
+ * @returns {Promise<*>} In-flight, resident, or reconstructed object outcome.
254
452
  */
255
453
  GetObject(options = {}) {
256
454
  if (!this.__objectLoader) {
@@ -262,10 +460,12 @@ new class extends _identity {
262
460
  }
263
461
 
264
462
  /**
265
- * Promise-shaped readiness boundary for callers that already hold a resource.
463
+ * Promise-shaped alias for {@link CjsResource#GetObject}. Readiness shares an
464
+ * in-flight operation, returns resident payload without loading, and treats a
465
+ * call after payload release as an explicit reconstruction request.
266
466
  *
267
- * @param {object} options
268
- * @returns {Promise<*>}
467
+ * @param {object} [options={}] Source, format, semantic outcome, and queue options forwarded to the manager.
468
+ * @returns {Promise<*>} In-flight, resident, or reconstructed object outcome.
269
469
  */
270
470
  Ready(options = {}) {
271
471
  return this.GetObject(options);
@@ -1 +1 @@
1
- {"version":3,"file":"CjsResource.js","sources":["../../src/CjsResource.js"],"sourcesContent":["import { CjsEventEmitter } from \"@carbonenginejs/core-types/model\";\nimport { CjsSchema, carbon, impl, type } from \"@carbonenginejs/core-types/schema\";\nimport { getResourceExtension, normalizeResourcePath } from \"./resourcePath.js\";\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 @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 get isResource() {\n return true;\n }\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 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 ? String(ext).replace(/^\\./u, \"\").toLowerCase() : 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 /** Return the semantic outcome requested from this source path. */\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 preparation completed successfully.\n *\n * @returns {boolean}\n */\n @carbon.method\n @impl.adapted\n IsGood() {\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 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 this.EmitEvent?.(state, this, ...details);\n this.EmitEvent?.(\"statechange\", this, state, previous);\n return this;\n }\n\n MarkRequested() {\n return this.SetState(CjsResource.State.REQUESTED);\n }\n\n MarkLoading() {\n return this.SetState(CjsResource.State.LOADING);\n }\n\n MarkLoaded() {\n return this.SetState(CjsResource.State.LOADED);\n }\n\n MarkPreparing() {\n return this.SetState(CjsResource.State.PREPARING);\n }\n\n MarkPrepared() {\n return this.SetState(CjsResource.State.PREPARED);\n }\n\n MarkGood() {\n return this.MarkPrepared();\n }\n\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.\n *\n * @param {*} payload\n * @returns {CjsResource}\n */\n SetPayload(payload = null) {\n this.#payload = payload;\n return this;\n }\n\n /**\n * Read the plain CPU payload associated with this resource.\n *\n * @returns {*}\n */\n GetPayload() {\n return this.#payload;\n }\n\n /**\n * Returns true when a payload has been explicitly assigned.\n *\n * @returns {boolean}\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.\n */\n ReleasePayload() {\n this.#payload = null;\n return this;\n }\n\n /**\n * Bind the manager-owned object operation for this shared resource handle.\n *\n * @param {Function|null} loader\n * @returns {CjsResource}\n */\n SetObjectLoader(loader = null)\n {\n if (loader !== null && typeof loader !== \"function\")\n {\n throw new TypeError(\"CjsResource.SetObjectLoader requires a function or null.\");\n }\n this.__objectLoader = loader;\n return this;\n }\n\n /**\n * Return the manager-owned, deduplicated object operation.\n *\n * @param {object} options\n * @returns {Promise<*>}\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 readiness boundary for callers that already hold a resource.\n *\n * @param {object} options\n * @returns {Promise<*>}\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 static IsValidState(state) {\n return Object.values(CjsResource.State).includes(state);\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","String","replace","toLowerCase","getResourceExtension","undefined","trim","error","GetPath","GetExt","GetRequirement","IsLoading","REQUESTED","LOADING","HasLoaded","LOADED","PREPARING","PREPARED","IsPrepared","IsGood","IsFailed","FAILED","SetState","details","IsValidState","TypeError","previous","EmitEvent","MarkRequested","MarkLoading","MarkLoaded","MarkPreparing","MarkPrepared","MarkGood","SetError","SetPayload","payload","GetPayload","HasPayload","ReleasePayload","SetObjectLoader","loader","__objectLoader","GetObject","options","Error","code","Promise","reject","Ready","SetAdapterResource","key","__adapterResources","GetAdapterResource","HasAdapterResource","DestroyAdapterResource","destroy","DestroyAdapterValue","DestroyAdapterResources","keys","includes","freeze","UNLOADED","PURGED","Destroy","Dispose","dispose"],"mappings":"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"}
1
+ {"version":3,"file":"CjsResource.js","sources":["../../src/CjsResource.js"],"sourcesContent":["import { CjsEventEmitter } from \"@carbonenginejs/core-types/model\";\nimport { CjsSchema, carbon, impl, type } from \"@carbonenginejs/core-types/schema\";\nimport { getResourceExtension, normalizeResourcePath } from \"./resourcePath.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 * The controller deliberately contains no load, fetch, prepare, or reload hook.\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 @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 get isResource() {\n return 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 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 ? String(ext).replace(/^\\./u, \"\").toLowerCase() : 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 preparation completed successfully.\n *\n * @returns {boolean}\n */\n @carbon.method\n @impl.adapted\n IsGood() {\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 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 this.EmitEvent?.(state, this, ...details);\n this.EmitEvent?.(\"statechange\", this, state, previous);\n return this;\n }\n\n MarkRequested() {\n return this.SetState(CjsResource.State.REQUESTED);\n }\n\n MarkLoading() {\n return this.SetState(CjsResource.State.LOADING);\n }\n\n MarkLoaded() {\n return this.SetState(CjsResource.State.LOADED);\n }\n\n MarkPreparing() {\n return this.SetState(CjsResource.State.PREPARING);\n }\n\n MarkPrepared() {\n return this.SetState(CjsResource.State.PREPARED);\n }\n\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 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 * Explicitly renew this resource's canonical identity activity.\n * Unlike ccpwgl compatibility behavior, `IsGood()`, `HasLoaded()`, and other\n * state queries never call this method implicitly. Renewal never fetches or\n * reloads a purged resource.\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 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. Detached or purged handles do not revive themselves: their loader\n * resolves the manager's current canonical identity.\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 static IsValidState(state) {\n return Object.values(CjsResource.State).includes(state);\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","String","replace","toLowerCase","getResourceExtension","undefined","trim","error","GetPath","GetExt","GetRequirement","IsLoading","REQUESTED","LOADING","HasLoaded","LOADED","PREPARING","PREPARED","IsPrepared","IsGood","IsFailed","FAILED","SetState","details","IsValidState","TypeError","previous","EmitEvent","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","KeepAlive","options","keepAlive","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","UNLOADED","Destroy","Dispose","dispose"],"mappings":"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"}