Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

chore(assets): the asset census counts propagations still running

esengine3edc90dc9ccf
diff --git a/sdk/etc/index.api.md b/sdk/etc/index.api.md
index 61083f731..97033a791 100644
--- a/sdk/etc/index.api.md
+++ b/sdk/etc/index.api.md
@@ -977,7 +977,7 @@ ResourceDef<AssetsClass>
@internal releaseTyped: (type: string, ref: string) => void
@internal releaseTypedLease: (type: string, lease: AssetRefLease<PreparedLoad<unknown>>) => void
@internal resolveRegistryAsset: <T>(type: string, ref: string) => T | undefined
-@internal sizes: () => { textureCached: number; pendingLoads: number; refCounts: number; refRows: number; genericCaches: number; genericCached: number; handlePaths: number; invalidateListeners: number; registrySlots: number; trackedRefRows: number; }
+@internal sizes: () => { textureCached: number; pendingLoads: number; propagations: number; refCounts: number; refRows: number; genericCaches: number; genericCached: number; handlePaths: number; invalidateListeners: number; registrySlots: number; trackedRefRows: number; }
acquireSpine: (skeletonRef: string, atlasRef?: string) => Promise<AssetLease<SpineResult>>
acquireTexture: (ref: string) => Promise<AssetLease<TextureResult>>
acquireTyped: <T>(type: string, ref: string) => Promise<AssetLease<T>>
diff --git a/sdk/etc/index.native.api.md b/sdk/etc/index.native.api.md
index 748dcb3f5..d25cd8d36 100644
--- a/sdk/etc/index.native.api.md
+++ b/sdk/etc/index.native.api.md
@@ -977,7 +977,7 @@ ResourceDef<AssetsClass>
@internal releaseTyped: (type: string, ref: string) => void
@internal releaseTypedLease: (type: string, lease: AssetRefLease<PreparedLoad<unknown>>) => void
@internal resolveRegistryAsset: <T>(type: string, ref: string) => T | undefined
-@internal sizes: () => { textureCached: number; pendingLoads: number; refCounts: number; refRows: number; genericCaches: number; genericCached: number; handlePaths: number; invalidateListeners: number; registrySlots: number; trackedRefRows: number; }
+@internal sizes: () => { textureCached: number; pendingLoads: number; propagations: number; refCounts: number; refRows: number; genericCaches: number; genericCached: number; handlePaths: number; invalidateListeners: number; registrySlots: number; trackedRefRows: number; }
acquireSpine: (skeletonRef: string, atlasRef?: string) => Promise<AssetLease<SpineResult>>
acquireTexture: (ref: string) => Promise<AssetLease<TextureResult>>
acquireTyped: <T>(type: string, ref: string) => Promise<AssetLease<T>>
diff --git a/sdk/etc/index.node.api.md b/sdk/etc/index.node.api.md
index b26746218..c9bb4c734 100644
--- a/sdk/etc/index.node.api.md
+++ b/sdk/etc/index.node.api.md
@@ -972,7 +972,7 @@ ResourceDef<AssetsClass>
@internal releaseTyped: (type: string, ref: string) => void
@internal releaseTypedLease: (type: string, lease: AssetRefLease<PreparedLoad<unknown>>) => void
@internal resolveRegistryAsset: <T>(type: string, ref: string) => T | undefined
-@internal sizes: () => { textureCached: number; pendingLoads: number; refCounts: number; refRows: number; genericCaches: number; genericCached: number; handlePaths: number; invalidateListeners: number; registrySlots: number; trackedRefRows: number; }
+@internal sizes: () => { textureCached: number; pendingLoads: number; propagations: number; refCounts: number; refRows: number; genericCaches: number; genericCached: number; handlePaths: number; invalidateListeners: number; registrySlots: number; trackedRefRows: number; }
acquireSpine: (skeletonRef: string, atlasRef?: string) => Promise<AssetLease<SpineResult>>
acquireTexture: (ref: string) => Promise<AssetLease<TextureResult>>
acquireTyped: <T>(type: string, ref: string) => Promise<AssetLease<T>>
diff --git a/sdk/etc/minigame.api.md b/sdk/etc/minigame.api.md
index 792e35629..2bf570d80 100644
--- a/sdk/etc/minigame.api.md
+++ b/sdk/etc/minigame.api.md
@@ -972,7 +972,7 @@ ResourceDef<AssetsClass>
@internal releaseTyped: (type: string, ref: string) => void
@internal releaseTypedLease: (type: string, lease: AssetRefLease<PreparedLoad<unknown>>) => void
@internal resolveRegistryAsset: <T>(type: string, ref: string) => T | undefined
-@internal sizes: () => { textureCached: number; pendingLoads: number; refCounts: number; refRows: number; genericCaches: number; genericCached: number; handlePaths: number; invalidateListeners: number; registrySlots: number; trackedRefRows: number; }
+@internal sizes: () => { textureCached: number; pendingLoads: number; propagations: number; refCounts: number; refRows: number; genericCaches: number; genericCached: number; handlePaths: number; invalidateListeners: number; registrySlots: number; trackedRefRows: number; }
acquireSpine: (skeletonRef: string, atlasRef?: string) => Promise<AssetLease<SpineResult>>
acquireTexture: (ref: string) => Promise<AssetLease<TextureResult>>
acquireTyped: <T>(type: string, ref: string) => Promise<AssetLease<T>>
diff --git a/sdk/etc/wechat.api.md b/sdk/etc/wechat.api.md
index 2f894c81a..82d805bc9 100644
--- a/sdk/etc/wechat.api.md
+++ b/sdk/etc/wechat.api.md
@@ -972,7 +972,7 @@ ResourceDef<AssetsClass>
@internal releaseTyped: (type: string, ref: string) => void
@internal releaseTypedLease: (type: string, lease: AssetRefLease<PreparedLoad<unknown>>) => void
@internal resolveRegistryAsset: <T>(type: string, ref: string) => T | undefined
-@internal sizes: () => { textureCached: number; pendingLoads: number; refCounts: number; refRows: number; genericCaches: number; genericCached: number; handlePaths: number; invalidateListeners: number; registrySlots: number; trackedRefRows: number; }
+@internal sizes: () => { textureCached: number; pendingLoads: number; propagations: number; refCounts: number; refRows: number; genericCaches: number; genericCached: number; handlePaths: number; invalidateListeners: number; registrySlots: number; trackedRefRows: number; }
acquireSpine: (skeletonRef: string, atlasRef?: string) => Promise<AssetLease<SpineResult>>
acquireTexture: (ref: string) => Promise<AssetLease<TextureResult>>
acquireTyped: <T>(type: string, ref: string) => Promise<AssetLease<T>>
diff --git a/sdk/src/asset/Assets.ts b/sdk/src/asset/Assets.ts
index d24a11abc..49de887d2 100644
--- a/sdk/src/asset/Assets.ts
+++ b/sdk/src/asset/Assets.ts
@@ -1989,11 +1989,13 @@ export class Assets {
*
* Cache sizes are not expected to return to baseline — that is what a cache
* is for. `refCounts` and `handlePaths` are: every load handing one out has a
- * release taking it back. `pendingLoads` should be zero at rest.
+ * release taking it back. `pendingLoads` and `propagations` should be zero at rest.
*/
sizes(): {
textureCached: number;
pendingLoads: number;
+ /** Rebuilds of dependents still running after an invalidation. */
+ propagations: number;
refCounts: number;
refRows: number;
genericCaches: number;
@@ -2014,6 +2016,7 @@ export class Assets {
return {
textureCached: tex.cached,
pendingLoads: pending,
+ propagations: this.settling_.size,
refCounts: this.textureRefs_.size + this.genericRefs_.size,
refRows: this.textureRefs_.rows + this.genericRefs_.rows,
genericCaches: this.genericCache_.size,