@lightningjs/renderer 0.3.1 → 0.3.2

package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/SpecialCodepoints.js

@@ -2,7 +2,7 @@
  * If not stated otherwise in this file or this component's LICENSE file the
  * following copyright and licenses apply:
  *
- * Copyright 2023 Comcast
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
  *
  * Licensed under the Apache License, Version 2.0 (the License);
  * you may not use this file except in compliance with the License.

package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/constants.js

@@ -2,7 +2,7 @@
  * If not stated otherwise in this file or this component's LICENSE file the
  * following copyright and licenses apply:
  *
- * Copyright 2023 Comcast
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
  *
  * Licensed under the Apache License, Version 2.0 (the License);
  * you may not use this file except in compliance with the License.

package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/getStartConditions.js

@@ -2,7 +2,7 @@
  * If not stated otherwise in this file or this component's LICENSE file the
  * following copyright and licenses apply:
  *
- * Copyright 2023 Comcast
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
  *
  * Licensed under the Apache License, Version 2.0 (the License);
  * you may not use this file except in compliance with the License.

package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/getUnicodeCodepoints.js

@@ -2,7 +2,7 @@
  * If not stated otherwise in this file or this component's LICENSE file the
  * following copyright and licenses apply:
  *
- * Copyright 2023 Comcast
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
  *
  * Licensed under the Apache License, Version 2.0 (the License);
  * you may not use this file except in compliance with the License.

package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/layoutText.js

@@ -2,7 +2,7 @@
  * If not stated otherwise in this file or this component's LICENSE file the
  * following copyright and licenses apply:
  *
- * Copyright 2023 Comcast
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
  *
  * Licensed under the Apache License, Version 2.0 (the License);
  * you may not use this file except in compliance with the License.

package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/makeRenderWindow.js

@@ -2,7 +2,7 @@
  * If not stated otherwise in this file or this component's LICENSE file the
  * following copyright and licenses apply:
  *
- * Copyright 2023 Comcast
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
  *
  * Licensed under the Apache License, Version 2.0 (the License);
  * you may not use this file except in compliance with the License.

package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/measureText.js

@@ -2,7 +2,7 @@
  * If not stated otherwise in this file or this component's LICENSE file the
  * following copyright and licenses apply:
  *
- * Copyright 2023 Comcast
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
  *
  * Licensed under the Apache License, Version 2.0 (the License);
  * you may not use this file except in compliance with the License.

package/dist/src/core/text-rendering/renderers/TextRenderer.js

@@ -2,7 +2,7 @@
  * If not stated otherwise in this file or this component's LICENSE file the
  * following copyright and licenses apply:
  *
- * Copyright 2023 Comcast
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
  *
  * Licensed under the Apache License, Version 2.0 (the License);
  * you may not use this file except in compliance with the License.

package/dist/src/core/textures/ColorTexture.js

@@ -2,7 +2,7 @@
  * If not stated otherwise in this file or this component's LICENSE file the
  * following copyright and licenses apply:
  *
- * Copyright 2023 Comcast
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
  *
  * Licensed under the Apache License, Version 2.0 (the License);
  * you may not use this file except in compliance with the License.

package/dist/src/core/textures/ImageTexture.js

@@ -2,7 +2,7 @@
  * If not stated otherwise in this file or this component's LICENSE file the
  * following copyright and licenses apply:
  *
- * Copyright 2023 Comcast
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
  *
  * Licensed under the Apache License, Version 2.0 (the License);
  * you may not use this file except in compliance with the License.

package/dist/src/core/textures/NoiseTexture.js

@@ -2,7 +2,7 @@
  * If not stated otherwise in this file or this component's LICENSE file the
  * following copyright and licenses apply:
  *
- * Copyright 2023 Comcast
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
  *
  * Licensed under the Apache License, Version 2.0 (the License);
  * you may not use this file except in compliance with the License.

package/dist/src/core/textures/SubTexture.js

@@ -2,7 +2,7 @@
  * If not stated otherwise in this file or this component's LICENSE file the
  * following copyright and licenses apply:
  *
- * Copyright 2023 Comcast
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
  *
  * Licensed under the Apache License, Version 2.0 (the License);
  * you may not use this file except in compliance with the License.

package/dist/src/core/textures/Texture.js

@@ -2,7 +2,7 @@
  * If not stated otherwise in this file or this component's LICENSE file the
  * following copyright and licenses apply:
  *
- * Copyright 2023 Comcast
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
  *
  * Licensed under the Apache License, Version 2.0 (the License);
  * you may not use this file except in compliance with the License.

package/dist/src/core/utils.js

@@ -2,7 +2,7 @@
  * If not stated otherwise in this file or this component's LICENSE file the
  * following copyright and licenses apply:
  *
- * Copyright 2023 Comcast
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
  *
  * Licensed under the Apache License, Version 2.0 (the License);
  * you may not use this file except in compliance with the License.

package/dist/src/main-api/INode.js

@@ -2,7 +2,7 @@
  * If not stated otherwise in this file or this component's LICENSE file the
  * following copyright and licenses apply:
  *
- * Copyright 2023 Comcast
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
  *
  * Licensed under the Apache License, Version 2.0 (the License);
  * you may not use this file except in compliance with the License.

package/dist/src/main-api/IRenderDriver.js

@@ -2,7 +2,7 @@
  * If not stated otherwise in this file or this component's LICENSE file the
  * following copyright and licenses apply:
  *
- * Copyright 2023 Comcast
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
  *
  * Licensed under the Apache License, Version 2.0 (the License);
  * you may not use this file except in compliance with the License.

package/dist/src/main-api/RendererMain.js

@@ -2,7 +2,7 @@
  * If not stated otherwise in this file or this component's LICENSE file the
  * following copyright and licenses apply:
  *
- * Copyright 2023 Comcast
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
  *
  * Licensed under the Apache License, Version 2.0 (the License);
  * you may not use this file except in compliance with the License.

package/dist/src/main-api/TextureRegistry.d.ts

@@ -0,0 +1,33 @@
+import type { TextureDesc } from "./RendererMain.js";
+interface TextureRefInfo {
+    /**
+     * Texture Reference ID
+     */
+    id: number;
+    /**
+     * The number of references to this texture that are currently assigned to
+     * Nodes.
+     */
+    nodeRefCount: number;
+    /**
+     * The last time the texture reference count was updated.
+     *
+     * @remarks
+     * This is used to determine when a texture is no longer referenced by any
+     * Nodes and can be removed from the GPU.
+     */
+    lastUpdate: number;
+}
+/**
+ * Usage-based Texture Garbage Collection Registry
+ */
+export declare class TextureRegistry {
+    protected releaseCallback: (textureDescId: number) => void;
+    textureMap: Map<number, TextureRefInfo>;
+    zeroReferenceTextureSet: Set<TextureRefInfo>;
+    constructor(releaseCallback: (textureDescId: number) => void);
+    registerTexture(texture: TextureDesc): void;
+    incrementTextureRefCount(texture: TextureDesc): void;
+    decrementTextureRefCount(texture: TextureDesc): void;
+}
+export {};

package/dist/src/main-api/TextureRegistry.js

@@ -0,0 +1,97 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { assertTruthy } from "../utils.js";
+const TEXTURE_CLEANUP_INTERVAL_MS = 1000;
+const TEXTURE_CLEANUP_AGE_THREADHOLD_MS = 5000;
+/**
+ * Usage-based Texture Garbage Collection Registry
+ */
+export class TextureRegistry {
+    releaseCallback;
+    textureMap = new Map();
+    zeroReferenceTextureSet = new Set();
+    constructor(releaseCallback) {
+        this.releaseCallback = releaseCallback;
+        // Periodically check for textures that are no longer referenced by any
+        // Nodes and notify RendererMain to release them.
+        setInterval(() => {
+            const now = Date.now();
+            for (const textureRefInfo of this.zeroReferenceTextureSet) {
+                if (now - textureRefInfo.lastUpdate > TEXTURE_CLEANUP_AGE_THREADHOLD_MS) {
+                    this.releaseCallback(textureRefInfo.id);
+                    this.textureMap.delete(textureRefInfo.id);
+                    this.zeroReferenceTextureSet.delete(textureRefInfo);
+                }
+            }
+        }, TEXTURE_CLEANUP_INTERVAL_MS);
+    }
+    registerTexture(texture) {
+        const textureId = texture.options?.id;
+        assertTruthy(textureId, 'Texture must have an id to be registered');
+        if (!this.textureMap.has(textureId)) {
+            const textureRefInfo = {
+                id: textureId,
+                nodeRefCount: 0,
+                lastUpdate: Date.now()
+            };
+            this.textureMap.set(textureId, textureRefInfo);
+            this.zeroReferenceTextureSet.add(textureRefInfo);
+        }
+    }
+    incrementTextureRefCount(texture) {
+        const textureId = texture.options?.id;
+        assertTruthy(textureId, 'Texture must have an id to be registered');
+        let textureRefInfo = this.textureMap.get(textureId);
+        if (!textureRefInfo) {
+            // Texture has not been registered yet, so register it now.
+            // This may happen if the TextureDesc was cleaned up from the registry
+            // but was still alive in memory and eventually re-used.
+            this.registerTexture(texture);
+            textureRefInfo = this.textureMap.get(textureId);
+        }
+        assertTruthy(textureRefInfo, 'Texture must have been registered');
+        if (texture.txType === 'SubTexture') {
+            // If this is a SubTexture, then increment the reference count of the
+            // parent texture as well.
+            this.incrementTextureRefCount(texture.props.texture);
+        }
+        textureRefInfo.nodeRefCount++;
+        textureRefInfo.lastUpdate = Date.now();
+        if (this.zeroReferenceTextureSet.has(textureRefInfo)) {
+            this.zeroReferenceTextureSet.delete(textureRefInfo);
+        }
+    }
+    decrementTextureRefCount(texture) {
+        const textureId = texture.options?.id;
+        assertTruthy(textureId, 'Texture must have an id to be registered');
+        const textureRefInfo = this.textureMap.get(textureId);
+        assertTruthy(textureRefInfo, 'Texture must have been registered');
+        textureRefInfo.nodeRefCount--;
+        textureRefInfo.lastUpdate = Date.now();
+        if (textureRefInfo.nodeRefCount === 0) {
+            this.zeroReferenceTextureSet.add(textureRefInfo);
+        }
+        if (texture.txType === 'SubTexture') {
+            // If this is a SubTexture, then decrement the reference count of the
+            // parent texture as well.
+            this.decrementTextureRefCount(texture.props.texture);
+        }
+    }
+}
+//# sourceMappingURL=TextureRegistry.js.map

package/dist/src/main-api/TextureRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureRegistry.js","sourceRoot":"","sources":["../../../src/main-api/TextureRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,MAAM,2BAA2B,GAAG,IAAI,CAAC;AACzC,MAAM,iCAAiC,GAAG,IAAI,CAAC;AAsB/C;;GAEG;AACH,MAAM,OAAO,eAAe;IAIJ;IAHtB,UAAU,GAAgC,IAAI,GAAG,EAAE,CAAC;IACpD,uBAAuB,GAAwB,IAAI,GAAG,EAAE,CAAC;IAEzD,YAAsB,eAAgD;QAAhD,oBAAe,GAAf,eAAe,CAAiC;QACpE,uEAAuE;QACvE,iDAAiD;QACjD,WAAW,CAAC,GAAG,EAAE;YACf,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,KAAK,MAAM,cAAc,IAAI,IAAI,CAAC,uBAAuB,EAAE;gBACzD,IAAI,GAAG,GAAG,cAAc,CAAC,UAAU,GAAG,iCAAiC,EAAE;oBACvE,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;oBACxC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;oBAC1C,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;iBACrD;aACF;QACH,CAAC,EAAE,2BAA2B,CAAC,CAAC;IAClC,CAAC;IAED,eAAe,CAAC,OAAoB;QAClC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACtC,YAAY,CAAC,SAAS,EAAE,0CAA0C,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;YACnC,MAAM,cAAc,GAAmB;gBACrC,EAAE,EAAE,SAAS;gBACb,YAAY,EAAE,CAAC;gBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;aACvB,CAAC;YACF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YAC/C,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;SAClD;IACH,CAAC;IAED,wBAAwB,CAAC,OAAoB;QAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACtC,YAAY,CAAC,SAAS,EAAE,0CAA0C,CAAC,CAAC;QACpE,IAAI,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,cAAc,EAAE;YACnB,2DAA2D;YAC3D,sEAAsE;YACtE,wDAAwD;YACxD,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC9B,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;SACjD;QACD,YAAY,CAAC,cAAc,EAAE,mCAAmC,CAAC,CAAC;QAClE,IAAI,OAAO,CAAC,MAAM,KAAK,YAAY,EAAE;YACnC,qEAAqE;YACrE,0BAA0B;YAC1B,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;SACtD;QACD,cAAc,CAAC,YAAY,EAAE,CAAC;QAC9B,cAAc,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE;YACpD,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;SACrD;IACH,CAAC;IAED,wBAAwB,CAAC,OAAoB;QAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACtC,YAAY,CAAC,SAAS,EAAE,0CAA0C,CAAC,CAAC;QACpE,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtD,YAAY,CAAC,cAAc,EAAE,mCAAmC,CAAC,CAAC;QAClE,cAAc,CAAC,YAAY,EAAE,CAAC;QAC9B,cAAc,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvC,IAAI,cAAc,CAAC,YAAY,KAAK,CAAC,EAAE;YACrC,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;SAClD;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,YAAY,EAAE;YACnC,qEAAqE;YACrE,0BAA0B;YAC1B,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;SACtD;IACH,CAAC;CACF"}

package/dist/src/main-api/TextureUsageRegistry/TextureRegistry.d.ts

@@ -0,0 +1,33 @@
+import type { TextureDesc } from "../RendererMain.js";
+interface TextureRefInfo {
+    /**
+     * Texture Reference ID
+     */
+    id: number;
+    /**
+     * The number of references to this texture that are currently assigned to
+     * Nodes.
+     */
+    nodeRefCount: number;
+    /**
+     * The last time the texture reference count was updated.
+     *
+     * @remarks
+     * This is used to determine when a texture is no longer referenced by any
+     * Nodes and can be removed from the GPU.
+     */
+    lastUpdate: number;
+}
+/**
+ * Usage-based Texture Garbage Collection Registry
+ */
+export declare class TextureRegistry {
+    protected releaseCallback: (textureDescId: number) => void;
+    textureMap: Map<number, TextureRefInfo>;
+    zeroReferenceTextureSet: Set<TextureRefInfo>;
+    constructor(releaseCallback: (textureDescId: number) => void);
+    registerTexture(texture: TextureDesc): void;
+    incrementTextureRefCount(texture: TextureDesc): void;
+    decrementTextureRefCount(texture: TextureDesc): void;
+}
+export {};

package/dist/src/main-api/TextureUsageRegistry/TextureRegistry.js

@@ -0,0 +1,97 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { assertTruthy } from "../../utils.js";
+const TEXTURE_CLEANUP_INTERVAL_MS = 1000;
+const TEXTURE_CLEANUP_AGE_THREADHOLD_MS = 5000;
+/**
+ * Usage-based Texture Garbage Collection Registry
+ */
+export class TextureRegistry {
+    releaseCallback;
+    textureMap = new Map();
+    zeroReferenceTextureSet = new Set();
+    constructor(releaseCallback) {
+        this.releaseCallback = releaseCallback;
+        // Periodically check for textures that are no longer referenced by any
+        // Nodes and notify RendererMain to release them.
+        setInterval(() => {
+            const now = Date.now();
+            for (const textureRefInfo of this.zeroReferenceTextureSet) {
+                if (now - textureRefInfo.lastUpdate > TEXTURE_CLEANUP_AGE_THREADHOLD_MS) {
+                    this.releaseCallback(textureRefInfo.id);
+                    this.textureMap.delete(textureRefInfo.id);
+                    this.zeroReferenceTextureSet.delete(textureRefInfo);
+                }
+            }
+        }, TEXTURE_CLEANUP_INTERVAL_MS);
+    }
+    registerTexture(texture) {
+        const textureId = texture.options?.id;
+        assertTruthy(textureId, 'Texture must have an id to be registered');
+        if (!this.textureMap.has(textureId)) {
+            const textureRefInfo = {
+                id: textureId,
+                nodeRefCount: 0,
+                lastUpdate: Date.now()
+            };
+            this.textureMap.set(textureId, textureRefInfo);
+            this.zeroReferenceTextureSet.add(textureRefInfo);
+        }
+    }
+    incrementTextureRefCount(texture) {
+        const textureId = texture.options?.id;
+        assertTruthy(textureId, 'Texture must have an id to be registered');
+        let textureRefInfo = this.textureMap.get(textureId);
+        if (!textureRefInfo) {
+            // Texture has not been registered yet, so register it now.
+            // This may happen if the TextureDesc was cleaned up from the registry
+            // but was still alive in memory and eventually re-used.
+            this.registerTexture(texture);
+            textureRefInfo = this.textureMap.get(textureId);
+        }
+        assertTruthy(textureRefInfo, 'Texture must have been registered');
+        if (texture.txType === 'SubTexture') {
+            // If this is a SubTexture, then increment the reference count of the
+            // parent texture as well.
+            this.incrementTextureRefCount(texture.props.texture);
+        }
+        textureRefInfo.nodeRefCount++;
+        textureRefInfo.lastUpdate = Date.now();
+        if (this.zeroReferenceTextureSet.has(textureRefInfo)) {
+            this.zeroReferenceTextureSet.delete(textureRefInfo);
+        }
+    }
+    decrementTextureRefCount(texture) {
+        const textureId = texture.options?.id;
+        assertTruthy(textureId, 'Texture must have an id to be registered');
+        const textureRefInfo = this.textureMap.get(textureId);
+        assertTruthy(textureRefInfo, 'Texture must have been registered');
+        textureRefInfo.nodeRefCount--;
+        textureRefInfo.lastUpdate = Date.now();
+        if (textureRefInfo.nodeRefCount === 0) {
+            this.zeroReferenceTextureSet.add(textureRefInfo);
+        }
+        if (texture.txType === 'SubTexture') {
+            // If this is a SubTexture, then decrement the reference count of the
+            // parent texture as well.
+            this.decrementTextureRefCount(texture.props.texture);
+        }
+    }
+}
+//# sourceMappingURL=TextureRegistry.js.map

package/dist/src/main-api/TextureUsageRegistry/TextureRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureRegistry.js","sourceRoot":"","sources":["../../../../src/main-api/TextureUsageRegistry/TextureRegistry.ts"],"names":[],"mappings":"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"}

package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.d.ts

@@ -0,0 +1,9 @@
+import type { TextureRef } from '../RendererMain.js';
+import { TextureUsageTracker } from './TextureUsageTracker.js';
+export declare class FinalizationRegistryTextureUsageTracker extends TextureUsageTracker {
+    private registry;
+    constructor(releaseCallback: (textureDescId: number) => void);
+    registerTexture(texture: TextureRef): void;
+    incrementTextureRefCount(): void;
+    decrementTextureRefCount(): void;
+}

package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.js

@@ -0,0 +1,38 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { assertTruthy } from '../../utils.js';
+import { TextureUsageTracker } from './TextureUsageTracker.js';
+export class FinalizationRegistryTextureUsageTracker extends TextureUsageTracker {
+    registry;
+    constructor(releaseCallback) {
+        super(releaseCallback);
+        this.registry = new FinalizationRegistry(releaseCallback);
+    }
+    registerTexture(texture) {
+        assertTruthy(texture.options?.id, 'Texture must have an ID to be registered');
+        this.registry.register(texture, texture.options?.id);
+    }
+    incrementTextureRefCount() {
+        // No-op for FinalizationRegistry
+    }
+    decrementTextureRefCount() {
+        // No-op for FinalizationRegistry
+    }
+}
+//# sourceMappingURL=FinalizationRegistryTextureUsageTracker.js.map

package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FinalizationRegistryTextureUsageTracker.js","sourceRoot":"","sources":["../../../../src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,OAAO,uCAAwC,SAAQ,mBAAmB;IACtE,QAAQ,CAA+B;IAE/C,YAAY,eAAgD;QAC1D,KAAK,CAAC,eAAe,CAAC,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,IAAI,oBAAoB,CAAC,eAAe,CAAC,CAAC;IAC5D,CAAC;IAEQ,eAAe,CAAC,OAAmB;QAC1C,YAAY,CACV,OAAO,CAAC,OAAO,EAAE,EAAE,EACnB,0CAA0C,CAC3C,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IACQ,wBAAwB;QAC/B,iCAAiC;IACnC,CAAC;IACQ,wBAAwB;QAC/B,iCAAiC;IACnC,CAAC;CACF"}

package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.d.ts

@@ -0,0 +1,56 @@
+import type { TextureRef } from '../RendererMain.js';
+import { TextureUsageTracker } from './TextureUsageTracker.js';
+interface TextureRefInfo {
+    /**
+     * Texture Reference ID
+     */
+    id: number;
+    /**
+     * The number of references to this texture that are currently assigned to
+     * Nodes.
+     */
+    nodeRefCount: number;
+    /**
+     * The last time the texture reference count was updated.
+     *
+     * @remarks
+     * This is used to determine when a texture is no longer referenced by any
+     * Nodes and can be removed from the GPU.
+     */
+    lastUpdate: number;
+}
+export interface ManualCountTextureUsageTrackerOptions {
+    /**
+     * The interval at which to check if textures that are no longer referenced
+     * by any Nodes can be released from the Core Space Texture Usage Cache.
+     *
+     * @remarks
+     * Only valid when the {@link ManualCountTextureUsageTracker} is used.
+     *
+     * @defaultValue 10000 (10 seconds)
+     */
+    textureCleanupIntervalMs?: number;
+    /**
+     * The age at which a texture is considered to be no longer referenced by any
+     * Nodes and can be released from the Core Space Texture Usage Cache.
+     *
+     * @remarks
+     * Only valid when the {@link ManualCountTextureUsageTracker} is used.
+     *
+     * @defaultValue 60000 (1 minute)
+     */
+    textureCleanupAgeThreadholdMs?: number;
+}
+/**
+ * Usage-based Texture Garbage Collection Registry
+ */
+export declare class ManualCountTextureUsageTracker extends TextureUsageTracker {
+    textureMap: Map<number, TextureRefInfo>;
+    zeroReferenceTextureSet: Set<TextureRefInfo>;
+    options: Required<ManualCountTextureUsageTrackerOptions>;
+    constructor(releaseCallback: (textureDescId: number) => void, options: ManualCountTextureUsageTrackerOptions);
+    registerTexture(texture: TextureRef): void;
+    incrementTextureRefCount(texture: TextureRef): void;
+    decrementTextureRefCount(texture: TextureRef): void;
+}
+export {};