@carbonenginejs/runtime 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/index.js

@@ -51,6 +51,8 @@ export { IListNotify } from './global/blue/IListNotify.js';
 export { INotify, IsMatch } from './global/blue/INotify.js';
 export { CjsBluePaths } from './global/blue/CjsBluePaths.js';
 export { IBluePaths } from './global/blue/IBluePaths.js';
+export { IBlueClasses } from './global/blue/IBlueClasses.js';
+export { BlueClasses } from './global/blue/BlueClasses.js';
 export { blue } from './global/blue/blue.js';
 export { CjsBlueEnumRegistry, EnumRegistrationType } from './global/blue/enums/CjsBlueEnumRegistry.js';
 import * as index from './global/consts/index.js';
@@ -149,6 +151,13 @@ export { Tr2RenderStateSetup } from './resource/shader/reflection/Tr2RenderState
 export { SHADER_STAGE_COUNT, ShaderStageType, requireShaderStageType } from './resource/shader/reflection/shaderStage.js';
 export { Tr2SamplerSetup } from './resource/shader/sampler/Tr2SamplerSetup.js';
 export { RegisterShaderResources, ShaderResourceExtensions } from './resource/shader/registerShaderResources.js';
+export { CjsTextureArrayConstructor, RegisterTextureArray, TextureArrayPrefix } from './resource/texture/CjsTextureArrayConstructor.js';
+export { CjsTexturePipelineStepArray } from './resource/texture/CjsTexturePipelineStepArray.js';
+export { CjsTexturePipelineStepPack } from './resource/texture/CjsTexturePipelineStepPack.js';
+export { CjsTexturePackConstructor, RegisterTexturePack, TexturePackPrefix } from './resource/texture/CjsTexturePackConstructor.js';
+export { CjsTexturePipelineStepConvert } from './resource/texture/CjsTexturePipelineStepConvert.js';
+export { CjsTexturePipelineStepResize } from './resource/texture/CjsTexturePipelineStepResize.js';
+export { RegisterTextureResources, TextureResourceExtensions } from './resource/texture/registerTextureResources.js';
 export { CjsTextureArrayRes } from './resource/texture/CjsTextureArrayRes.js';
 export { CjsTextureArrayResParameterProxy } from './resource/texture/CjsTextureArrayResParameterProxy.js';
 export { RegisterSolidColorTexture, SolidColorTextureConstructor } from './resource/texture/SolidColorTextureConstructor.js';
@@ -541,13 +550,13 @@ export { EveSpriteSetItem } from './trinity/eve/attachment/sprite/EveSpriteSetIt
 export { EveTurretAiming } from './trinity/eve/attachment/turrets/EveTurretAiming.js';
 export { EveTurretFiringFX } from './trinity/eve/attachment/turrets/EveTurretFiringFX.js';
 export { EveTurretSet } from './trinity/eve/attachment/turrets/EveTurretSet.js';
-export { EveTurretTarget } from './trinity/eve/attachment/turrets/EveTurretTarget.js';
+export { EVE_TURRET_RANDOM_DELAY_MAX, EveTurretTarget } from './trinity/eve/attachment/turrets/EveTurretTarget.js';
 export { EveLocator2 } from './trinity/eve/locator/EveLocator2.js';
 export { EveGetLocatorPose, EveLocatorSets } from './trinity/eve/locator/EveLocatorSets.js';
 export { Locator } from './trinity/eve/locator/Locator.js';
 export { LocatorData } from './trinity/eve/locator/LocatorData.js';
 export { EveMeshOverlayEffect } from './trinity/eve/overlays/EveMeshOverlayEffect.js';
-export { EveDamageOverlay } from './trinity/eve/overlays/EveDamageOverlay.js';
+export { EveDamageOverlay, IMPACT_ARMOR_SIZE_FACTOR, IMPACT_ARMOR_SIZE_MAX } from './trinity/eve/overlays/EveDamageOverlay.js';
 export { EveParticleDirectForce } from './trinity/eve/particles/force/EveParticleDirectForce.js';
 export { EveParticleDragForce } from './trinity/eve/particles/force/EveParticleDragForce.js';
 export { EveParticleSpring } from './trinity/eve/particles/force/EveParticleSpring.js';
@@ -842,6 +851,7 @@ export { Tr2VolumetricsRenderer } from './trinity/core/volumetrics/Tr2Volumetric
 export { Tr2StreamingBitmapSaver } from './trinity/core/Tr2StreamingBitmapSaver.js';
 export { Tr2TextureArrayElement } from './trinity/core/Tr2TextureArray/Tr2TextureArrayElement.js';
 export { Tr2TextureArray } from './trinity/core/Tr2TextureArray/Tr2TextureArray.js';
+export { Tr2TextureReference } from './trinity/core/Tr2TextureReference.js';
 export { Tr2PresentParameters } from './trinity/ui/Tr2PresentParameters.js';
 export { Tr2ProjectBoundingBoxBracket } from './trinity/ui/Tr2ProjectBoundingBoxBracket.js';
 export { EveCloudEditableVolume } from './trinity/generated/eve/child/EveCloudEditableVolume.js';
@@ -890,7 +900,6 @@ export { Tr2ReflectionProbe } from './trinity/generated/trinityCore/Tr2Reflectio
 export { Tr2SSSSS } from './trinity/generated/trinityCore/Tr2SSSSS.js';
 export { Tr2TextureAtlas } from './trinity/generated/trinityCore/Tr2TextureAtlas.js';
 export { Tr2TextureAtlasMan } from './trinity/generated/trinityCore/Tr2TextureAtlasMan.js';
-export { Tr2TextureReference } from './trinity/generated/trinityCore/Tr2TextureReference.js';
 export { Tr2TransientTextureReference } from './trinity/generated/trinityCore/Tr2TransientTextureReference.js';
 export { RenderBatchSortType, SSAOQuality, ShadowQuality, TR2SHADERMODEL, Tr2DxtCompressionFormat, Tr2DxtCompressionSquishQuality, Tr2RenderReason, Tr2StandardIlluminant, Tr2TransformModifier, Tr2VolumerticQuality, TriFrustumTestResult, TriVariableContentType } from './trinity/generated/trinityCore/enums.js';
 export { INPUTTYPE, UIALIGN, UIANCHOR, UIBOX, UICONTROLTYPE, UICURSOR, UID, UIFONTSIZE, UIFONTSTYLE, UIHITAREA, UIINITPOS, UIMESSAGE, UISTATE, UITRAVERSE } from './trinity/generated/ui/enums.js';
@@ -1152,7 +1161,6 @@ export { Tr2VideoDriver } from './core/platform/Tr2VideoDriver.js';
 export { AudioChannelLayout, AudioSampleFormat, normalizeAudioSampleFormat } from './global/consts/audio/audioFormats.js';
 export { BLUEERROR, BLUELISTEVENT } from './global/consts/blue.js';
 export { CJS_OPERATION_CANCELLED, CjsCancellationError } from './global/utils/errors/CjsCancellationError.js';
-export { CarbonPixelFormatToWebGpu, DxgiFormatToPixelFormat, GpuTextureFormat, PixelFormatToWebGpu, SrgbSiblingOf, dxgiToPixelFormat, toWebGpuTextureFormat } from './global/consts/webgpu/textureFormats.js';
 export { CjsError } from './global/utils/errors/CjsError.js';
 export { ColorSpace, normalizeColorSpace } from './global/consts/graphics/colorSpaces.js';
 export { D3dPrimitiveTopology } from './global/consts/d3d/primitiveTopology.js';

package/dist/index.js.map

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

package/dist/resource/CjsResMan.js

@@ -1034,8 +1034,8 @@ class CjsResMan {
     if (!key) {
       throw new TypeError("CjsResMan.RegisterResourceConstructor requires a name.");
     }
-    if (typeof constructor?.GetResource !== "function") {
-      throw new TypeError(`CjsResMan dynamic resource constructor "${key}" must implement GetResource.`);
+    if (typeof constructor?.GetResource !== "function" || typeof constructor.IsCacheable !== "function") {
+      throw new TypeError(`CjsResMan dynamic resource constructor "${key}" must implement IBlueDynamicResourceConstructor (GetResource and IsCacheable).`);
     }
     this.#dynamicConstructors.set(key, constructor);
     return this;
@@ -1090,6 +1090,11 @@ class CjsResMan {
    * @throws {Error} If MotherLode is inactive or displaced-resource cleanup fails.
    */
   GetResource(path, options = {}) {
+    // An invalid call throws; a resource that cannot be fetched is recorded on
+    // the resource instead (_RequestResource).
+    if (typeof path !== "string" || !path) {
+      throw new TypeError("CjsResMan.GetResource requires a non-empty path string.");
+    }
     if (!options || typeof options !== "object" || Array.isArray(options)) {
       throw new TypeError("CjsResMan.GetResource options must be an object.");
     }
@@ -1167,9 +1172,37 @@ class CjsResMan {
     }
     this.#BindResourceLifecycle(cacheKey, canonical);
     this.motherLode.KeepAlive(cacheKey);
+
+    // A reload request drives its own load (ReloadResource / GetObject).
+    if (!existing && options.reload !== true) this._RequestResource(canonical, options);
     return canonical;
   }
 
+  /**
+   * Starts loading a resource just handed out.
+   *
+   * Asking for a resource requests it, as Carbon's does: GetResource calls
+   * Initialize, which queues the load (BlueResMan.cpp:276-288,
+   * BlueAsyncRes.cpp:191-230). A later Ready() joins this operation. A load
+   * that fails, whether before its promise exists or after, is recorded on
+   * the resource rather than thrown from GetResource; a caller that wants the
+   * outcome awaits Ready(), which also retries a resource with no payload.
+   *
+   * The request carries the options GetResource was given, including per-call
+   * controls such as `cacheSource`, which the resource's own loader does not
+   * retain; the request is made here, so that is where they apply.
+   *
+   * @param {CjsResource} resource The resource to request.
+   * @param {object} options The options GetResource was given.
+   */
+  _RequestResource(resource, options) {
+    try {
+      resource.Ready(options).catch(() => {});
+    } catch (error) {
+      resource.SetError(error);
+    }
+  }
+
   /**
    * Resolve one object outcome for a canonical resource identity. Concurrent
    * callers share only the active operation. Once settled, a resident payload
@@ -1208,6 +1241,12 @@ class CjsResMan {
       return Promise.resolve(getPublishedResourceObject(resource, this.#resourceExtensionRoutes.get(resource) || null, this.#resourceHandlerModes.get(resource) || null));
     }
     if (this.#dynamicResources.has(resource)) {
+      // One still building is waited for: a texture made from a pipeline loads
+      // its inputs first, as Carbon's .ctr texture does (TriTextureRes.cpp:238-258).
+      if (resource.IsLoading()) {
+        return new Promise((resolve, reject) => resource.OnCompleted(() => resource.HasPayload() ? resolve(this.GetObject(path, options)) : reject(resource.error || dynamicResourceError(resource.GetPath(), "", "CJS_RESMAN_DYNAMIC_RESOURCE_UNAVAILABLE", "dynamic resource finished without a payload"))));
+      }
+
       // A dynamic resource is built by its constructor, never read from a
       // source: without a payload it failed, and there is nothing to fetch.
       return Promise.reject(resource.error || dynamicResourceError(resource.GetPath(), "", "CJS_RESMAN_DYNAMIC_RESOURCE_UNAVAILABLE", "dynamic resource has no payload"));
@@ -1834,7 +1873,7 @@ class CjsResMan {
     const context = {
       ...createResourcePathContext(resource.GetPath(), READ_CONTEXTS.get(options)),
       Format,
-      format: Format?.id || Format?.name || "",
+      format: Format?.id || "",
       options,
       resMan: this
     };
@@ -1911,8 +1950,9 @@ class CjsResMan {
 
   /**
    * `dynamic:` branch of BlueResMan::GetResourceHelper (BlueResMan.cpp:219-245).
-   * Inserted not cacheable, Carbon's `CACHING_NOT_ALLOWED`: a dynamic resource is
-   * never admitted to the byte cache.
+   * Carbon inserts every dynamic resource `CACHING_NOT_ALLOWED`; here the
+   * constructor decides (`IBlueDynamicResourceConstructor.IsCacheable`), because
+   * rebuilding costs a network fetch and a decode rather than a disk read.
    *
    * @param {string} key Normalized `dynamic:/<name>/<query>` path.
    * @param {string} cacheKey MotherLode key.
@@ -1936,7 +1976,7 @@ class CjsResMan {
     resource.SetObjectLoader(() => this.GetObject(key));
     const insertion = this.motherLode.Insert(cacheKey, resource, {
       replace: true,
-      cacheable: false
+      cacheable: constructor.IsCacheable()
     });
     const canonical = insertion?.resource || resource;
     this.#BindResourceLifecycle(cacheKey, canonical);
@@ -3358,7 +3398,7 @@ function filterFormatDescriptors(descriptors, options) {
   if (options.format) {
     candidates = candidates.filter(({
       Format
-    }) => Format === options.format || Format.id === options.format || Format.name === options.format);
+    }) => Format === options.format || Format.id === options.format);
   }
   if (options.emit !== undefined) {
     candidates = candidates.filter(({