@lightningjs/renderer 3.0.0-beta9 → 3.0.0

package/dist/src/core/platforms/web/lib/textureCompression.js

@@ -0,0 +1,301 @@
+/*
+ * 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 {} from '../../../textures/Texture.js';
+const PVR_MAGIC = 0x03525650; // 'PVR3' in little-endian
+const PVR_TO_GL_INTERNAL_FORMAT = {
+    0: 0x8c01,
+    1: 0x8c03,
+    2: 0x8c00,
+    3: 0x8c02, // PVRTC1
+    6: 0x8d64, // ETC1
+    7: 0x83f0,
+    8: 0x83f2,
+    9: 0x83f2,
+    10: 0x83f3,
+    11: 0x83f3, // DXT variants
+};
+const ASTC_MAGIC = 0x5ca1ab13;
+const ASTC_TO_GL_INTERNAL_FORMAT = {
+    '4x4': 0x93b0, // COMPRESSED_RGBA_ASTC_4x4_KHR
+    '5x5': 0x93b1, // COMPRESSED_RGBA_ASTC_5x5_KHR
+    '6x6': 0x93b2, // COMPRESSED_RGBA_ASTC_6x6_KHR
+    '8x8': 0x93b3, // COMPRESSED_RGBA_ASTC_8x8_KHR
+    '10x10': 0x93b4, // COMPRESSED_RGBA_ASTC_10x10_KHR
+    '12x12': 0x93b5, // COMPRESSED_RGBA_ASTC_12x12_KHR
+};
+// KTX file identifier
+const KTX_IDENTIFIER = [
+    0xab, 0x4b, 0x54, 0x58, 0x20, 0x31, 0x31, 0xbb, 0x0d, 0x0a, 0x1a, 0x0a,
+];
+/**
+ * Loads a compressed texture container
+ * @param url
+ * @returns
+ */
+export const loadCompressedTexture = async (url) => {
+    try {
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch compressed texture: ${response.status} ${response.statusText}`);
+        }
+        const arrayBuffer = await response.arrayBuffer();
+        // Ensure we have enough data to check magic numbers
+        if (arrayBuffer.byteLength < 16) {
+            throw new Error(`File too small to be a valid compressed texture (${arrayBuffer.byteLength} bytes). Expected at least 16 bytes for header inspection.`);
+        }
+        const view = new DataView(arrayBuffer);
+        const magic = view.getUint32(0, true);
+        if (magic === PVR_MAGIC) {
+            return loadPVR(view);
+        }
+        if (magic === ASTC_MAGIC) {
+            return loadASTC(view);
+        }
+        let isKTX = true;
+        for (let i = 0; i < KTX_IDENTIFIER.length; i++) {
+            if (view.getUint8(i) !== KTX_IDENTIFIER[i]) {
+                isKTX = false;
+                break;
+            }
+        }
+        if (isKTX === true) {
+            return loadKTX(view);
+        }
+        else {
+            throw new Error('Unrecognized compressed texture format');
+        }
+    }
+    catch (error) {
+        throw new Error(`Failed to load compressed texture from ${url}: ${error}`);
+    }
+};
+function readUint24(view, offset) {
+    return (view.getUint8(offset) +
+        (view.getUint8(offset + 1) << 8) +
+        (view.getUint8(offset + 2) << 16));
+}
+/**
+ * Loads an ASTC texture container and returns the texture data
+ * @param view
+ * @returns
+ */
+const loadASTC = async function (view) {
+    const blockX = view.getUint8(4);
+    const blockY = view.getUint8(5);
+    const sizeX = readUint24(view, 7);
+    const sizeY = readUint24(view, 10);
+    if (sizeX === 0 || sizeY === 0) {
+        throw new Error(`Invalid ASTC texture dimensions: ${sizeX}x${sizeY}`);
+    }
+    const expected = Math.ceil(sizeX / blockX) * Math.ceil(sizeY / blockY) * 16;
+    const dataSize = view.byteLength - 16;
+    if (expected !== dataSize) {
+        throw new Error(`Invalid ASTC texture data size: expected ${expected}, got ${dataSize}`);
+    }
+    const internalFormat = ASTC_TO_GL_INTERNAL_FORMAT[`${blockX}x${blockY}`];
+    if (internalFormat === undefined) {
+        throw new Error(`Unsupported ASTC block size: ${blockX}x${blockY}`);
+    }
+    const buffer = view.buffer;
+    const mipmaps = [];
+    mipmaps.push(buffer.slice(16));
+    return {
+        data: {
+            blockInfo: blockInfoMap[internalFormat],
+            glInternalFormat: internalFormat,
+            mipmaps,
+            w: sizeX,
+            h: sizeY,
+            type: 'ASTC',
+        },
+        premultiplyAlpha: false,
+    };
+};
+/**
+ * Loads a KTX texture container and returns the texture data
+ * @param view
+ * @returns
+ */
+const loadKTX = async function (view) {
+    const endianness = view.getUint32(12, true);
+    const littleEndian = endianness === 0x04030201;
+    if (littleEndian === false && endianness !== 0x01020304) {
+        throw new Error('Invalid KTX endianness value');
+    }
+    const glType = view.getUint32(16, littleEndian);
+    const glFormat = view.getUint32(24, littleEndian);
+    if (glType !== 0 || glFormat !== 0) {
+        throw new Error(`KTX texture is not compressed (glType: ${glType}, glFormat: ${glFormat})`);
+    }
+    const glInternalFormat = view.getUint32(28, littleEndian);
+    if (blockInfoMap[glInternalFormat] === undefined) {
+        throw new Error(`Unsupported KTX compressed texture format: 0x${glInternalFormat.toString(16)}`);
+    }
+    const width = view.getUint32(36, littleEndian);
+    const height = view.getUint32(40, littleEndian);
+    if (width === 0 || height === 0) {
+        throw new Error(`Invalid KTX texture dimensions: ${width}x${height}`);
+    }
+    const mipmapLevels = view.getUint32(56, littleEndian);
+    if (mipmapLevels === 0) {
+        throw new Error('KTX texture has no mipmap levels');
+    }
+    const bytesOfKeyValueData = view.getUint32(60, littleEndian);
+    const mipmaps = [];
+    const buffer = view.buffer;
+    let offset = 64 + bytesOfKeyValueData;
+    if (offset > view.byteLength) {
+        throw new Error('Invalid KTX file: key/value data exceeds file size');
+    }
+    for (let i = 0; i < mipmapLevels; i++) {
+        const imageSize = view.getUint32(offset, littleEndian);
+        offset += 4;
+        const end = offset + imageSize;
+        mipmaps.push(buffer.slice(offset, end));
+        offset = end;
+        if (offset % 4 !== 0) {
+            offset += 4 - (offset % 4);
+        }
+    }
+    return {
+        data: {
+            blockInfo: blockInfoMap[glInternalFormat],
+            glInternalFormat: glInternalFormat,
+            mipmaps,
+            w: width,
+            h: height,
+            type: 'KTX',
+        },
+        premultiplyAlpha: false,
+    };
+};
+function pvrtcMipSize(width, height, bpp) {
+    const minW = bpp === 2 ? 16 : 8;
+    const minH = 8;
+    const w = Math.max(width, minW);
+    const h = Math.max(height, minH);
+    return (w * h * bpp) / 8;
+}
+const loadPVR = async function (view) {
+    const pixelFormatLow = view.getUint32(8, true);
+    const internalFormat = PVR_TO_GL_INTERNAL_FORMAT[pixelFormatLow];
+    if (internalFormat === undefined) {
+        throw new Error(`Unsupported PVR pixel format: 0x${pixelFormatLow.toString(16)}`);
+    }
+    const height = view.getInt32(24, true);
+    const width = view.getInt32(28, true);
+    // validate dimensions
+    if (width === 0 || height === 0) {
+        throw new Error(`Invalid PVR texture dimensions: ${width}x${height}`);
+    }
+    const mipmapLevels = view.getInt32(44, true);
+    const metadataSize = view.getUint32(48, true);
+    const buffer = view.buffer;
+    let offset = 52 + metadataSize;
+    if (offset > buffer.byteLength) {
+        throw new Error('Invalid PVR file: metadata exceeds file size');
+    }
+    const mipmaps = [];
+    const block = blockInfoMap[internalFormat];
+    for (let i = 0; i < mipmapLevels; i++) {
+        const declaredSize = view.getUint32(offset, true);
+        const max = buffer.byteLength - (offset + 4);
+        if (declaredSize > 0 && declaredSize <= max) {
+            offset += 4;
+            const start = offset;
+            const end = offset + declaredSize;
+            mipmaps.push(buffer.slice(start, end));
+            offset = end;
+            offset = (offset + 3) & ~3; // align to 4 bytes
+            continue;
+        }
+        if (pixelFormatLow === 0 ||
+            pixelFormatLow === 1 ||
+            pixelFormatLow === 2 ||
+            pixelFormatLow === 3) {
+            const bpp = pixelFormatLow === 0 || pixelFormatLow === 1 ? 2 : 4;
+            const computed = pvrtcMipSize(width >> i, height >> i, bpp);
+            mipmaps.push(buffer.slice(offset, offset + computed));
+            offset += computed;
+            offset = (offset + 3) & ~3; // align to 4 bytes
+            continue;
+        }
+        if (block !== undefined) {
+            const blockW = Math.ceil((width >> i) / block.width);
+            const blockH = Math.ceil((height >> i) / block.height);
+            const computed = blockW * blockH * block.bytes;
+            mipmaps.push(buffer.slice(offset, offset + computed));
+            offset += computed;
+            offset = (offset + 3) & ~3;
+        }
+    }
+    return {
+        data: {
+            blockInfo: blockInfoMap[internalFormat],
+            glInternalFormat: internalFormat,
+            mipmaps,
+            w: width,
+            h: height,
+            type: 'PVR',
+        },
+        premultiplyAlpha: false,
+    };
+};
+// Predefined block info for common compressed texture formats
+const BLOCK_4x4x8 = { width: 4, height: 4, bytes: 8 };
+const BLOCK_4x4x16 = { width: 4, height: 4, bytes: 16 };
+const BLOCK_5x5x16 = { width: 5, height: 5, bytes: 16 };
+const BLOCK_6x6x16 = { width: 6, height: 6, bytes: 16 };
+const BLOCK_8x4x8 = { width: 8, height: 4, bytes: 8 };
+const BLOCK_8x8x16 = { width: 8, height: 8, bytes: 16 };
+const BLOCK_10x10x16 = { width: 10, height: 10, bytes: 16 };
+const BLOCK_12x12x16 = { width: 12, height: 12, bytes: 16 };
+// Map of GL internal formats to their corresponding block info
+export const blockInfoMap = {
+    // S3TC / DXTn (WEBGL_compressed_texture_s3tc, sRGB variants)
+    0x83f0: BLOCK_4x4x8, // COMPRESSED_RGB_S3TC_DXT1_EXT
+    0x83f1: BLOCK_4x4x8, // COMPRESSED_RGBA_S3TC_DXT1_EXT
+    0x83f2: BLOCK_4x4x16, // COMPRESSED_RGBA_S3TC_DXT3_EXT
+    0x83f3: BLOCK_4x4x16, // COMPRESSED_RGBA_S3TC_DXT5_EXT
+    // ETC1 / ETC2 / EAC
+    0x8d64: BLOCK_4x4x8, // COMPRESSED_RGB_ETC1_WEBGL
+    0x9274: BLOCK_4x4x8, // COMPRESSED_RGB8_ETC2
+    0x9275: BLOCK_4x4x8, // COMPRESSED_SRGB8_ETC2
+    0x9278: BLOCK_4x4x16, // COMPRESSED_RGBA8_ETC2_EAC
+    0x9279: BLOCK_4x4x16, // COMPRESSED_SRGB8_ALPHA8_ETC2_EAC
+    // PVRTC (WEBGL_compressed_texture_pvrtc)
+    0x8c00: BLOCK_4x4x8, // COMPRESSED_RGB_PVRTC_4BPPV1_IMG
+    0x8c02: BLOCK_4x4x8, // COMPRESSED_RGBA_PVRTC_4BPPV1_IMG
+    0x8c01: BLOCK_8x4x8, // COMPRESSED_RGB_PVRTC_2BPPV1_IMG
+    0x8c03: BLOCK_8x4x8,
+    // ASTC (WEBGL_compressed_texture_astc)
+    0x93b0: BLOCK_4x4x16, // COMPRESSED_RGBA_ASTC_4x4_KHR
+    0x93d0: BLOCK_4x4x16, // COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR
+    0x93b1: BLOCK_5x5x16, // 5x5
+    0x93d1: BLOCK_5x5x16,
+    0x93b2: BLOCK_6x6x16, // 6x6
+    0x93d2: BLOCK_6x6x16,
+    0x93b3: BLOCK_8x8x16, // 8x8
+    0x93d3: BLOCK_8x8x16,
+    0x93b4: BLOCK_10x10x16, // 10x10
+    0x93d4: BLOCK_10x10x16,
+    0x93b5: BLOCK_12x12x16, // 12x12
+    0x93d5: BLOCK_12x12x16,
+};
+//# sourceMappingURL=textureCompression.js.map

package/dist/src/core/platforms/web/lib/textureCompression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textureCompression.js","sourceRoot":"","sources":["../../../../../../src/core/platforms/web/lib/textureCompression.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAuB,MAAM,8BAA8B,CAAC;AAUnE,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,0BAA0B;AACxD,MAAM,yBAAyB,GAA2B;IACxD,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,MAAM,EAAE,SAAS;IACpB,CAAC,EAAE,MAAM,EAAE,OAAO;IAClB,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,MAAM;IACT,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM,EAAE,eAAe;CAC5B,CAAC;AACF,MAAM,UAAU,GAAG,UAAU,CAAC;AAE9B,MAAM,0BAA0B,GAA2B;IACzD,KAAK,EAAE,MAAM,EAAE,+BAA+B;IAC9C,KAAK,EAAE,MAAM,EAAE,+BAA+B;IAC9C,KAAK,EAAE,MAAM,EAAE,+BAA+B;IAC9C,KAAK,EAAE,MAAM,EAAE,+BAA+B;IAC9C,OAAO,EAAE,MAAM,EAAE,iCAAiC;IAClD,OAAO,EAAE,MAAM,EAAE,iCAAiC;CACnD,CAAC;AAEF,sBAAsB;AACtB,MAAM,cAAc,GAAG;IACrB,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CACvE,CAAC;AACF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EACxC,GAAW,EACa,EAAE;IAC1B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,uCAAuC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAChF,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;QAEjD,oDAAoD;QACpD,IAAI,WAAW,CAAC,UAAU,GAAG,EAAE,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,oDAAoD,WAAW,CAAC,UAAU,4DAA4D,CACvI,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAEtC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QAED,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;YACzB,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QAED,IAAI,KAAK,GAAG,IAAI,CAAC;QAEjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,KAAK,GAAG,KAAK,CAAC;gBACd,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,0CAA0C,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC,CAAC;AAEF,SAAS,UAAU,CAAC,IAAc,EAAE,MAAc;IAChD,OAAO,CACL,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QACrB,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAClC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,QAAQ,GAAG,KAAK,WAAW,IAAc;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAEnC,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,oCAAoC,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;IAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACtC,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,4CAA4C,QAAQ,SAAS,QAAQ,EAAE,CACxE,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,0BAA0B,CAAC,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;IACzE,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAqB,CAAC;IAE1C,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAE/B,OAAO;QACL,IAAI,EAAE;YACJ,SAAS,EAAE,YAAY,CAAC,cAAc,CAAE;YACxC,gBAAgB,EAAE,cAAc;YAChC,OAAO;YACP,CAAC,EAAE,KAAK;YACR,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,MAAM;SACb;QACD,gBAAgB,EAAE,KAAK;KACxB,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,OAAO,GAAG,KAAK,WAAW,IAAc;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,UAAU,KAAK,UAAU,CAAC;IAC/C,IAAI,YAAY,KAAK,KAAK,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IAClD,IAAI,MAAM,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,0CAA0C,MAAM,eAAe,QAAQ,GAAG,CAC3E,CAAC;IACJ,CAAC;IAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IAC1D,IAAI,YAAY,CAAC,gBAAgB,CAAC,KAAK,SAAS,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,gDAAgD,gBAAgB,CAAC,QAAQ,CACvE,EAAE,CACH,EAAE,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IAChD,IAAI,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,mCAAmC,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IACtD,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,mBAAmB,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAqB,CAAC;IAC1C,IAAI,MAAM,GAAG,EAAE,GAAG,mBAAmB,CAAC;IAEtC,IAAI,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACvD,MAAM,IAAI,CAAC,CAAC;QAEZ,MAAM,GAAG,GAAG,MAAM,GAAG,SAAS,CAAC;QAE/B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,CAAC;QACb,IAAI,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE;YACJ,SAAS,EAAE,YAAY,CAAC,gBAAgB,CAAE;YAC1C,gBAAgB,EAAE,gBAAgB;YAClC,OAAO;YACP,CAAC,EAAE,KAAK;YACR,CAAC,EAAE,MAAM;YACT,IAAI,EAAE,KAAK;SACZ;QACD,gBAAgB,EAAE,KAAK;KACxB,CAAC;AACJ,CAAC,CAAC;AAEF,SAAS,YAAY,CAAC,KAAa,EAAE,MAAc,EAAE,GAAU;IAC7D,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,CAAC,CAAC;IACf,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAChC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjC,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,OAAO,GAAG,KAAK,WAAW,IAAc;IAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC/C,MAAM,cAAc,GAAG,yBAAyB,CAAC,cAAc,CAAC,CAAC;IAEjE,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,mCAAmC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CACjE,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAEtC,sBAAsB;IACtB,IAAI,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,mCAAmC,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAqB,CAAC;IAE1C,IAAI,MAAM,GAAG,EAAE,GAAG,YAAY,CAAC;IAC/B,IAAI,MAAM,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,MAAM,KAAK,GAAG,YAAY,CAAC,cAAc,CAAE,CAAC;IAE5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAE7C,IAAI,YAAY,GAAG,CAAC,IAAI,YAAY,IAAI,GAAG,EAAE,CAAC;YAC5C,MAAM,IAAI,CAAC,CAAC;YACZ,MAAM,KAAK,GAAG,MAAM,CAAC;YACrB,MAAM,GAAG,GAAG,MAAM,GAAG,YAAY,CAAC;YAElC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;YACvC,MAAM,GAAG,GAAG,CAAC;YACb,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB;YAC/C,SAAS;QACX,CAAC;QAED,IACE,cAAc,KAAK,CAAC;YACpB,cAAc,KAAK,CAAC;YACpB,cAAc,KAAK,CAAC;YACpB,cAAc,KAAK,CAAC,EACpB,CAAC;YACD,MAAM,GAAG,GAAG,cAAc,KAAK,CAAC,IAAI,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACjE,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;YAE5D,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;YACtD,MAAM,IAAI,QAAQ,CAAC;YACnB,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB;YAC/C,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;YACvD,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC;YAE/C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;YACtD,MAAM,IAAI,QAAQ,CAAC;YACnB,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE;YACJ,SAAS,EAAE,YAAY,CAAC,cAAc,CAAE;YACxC,gBAAgB,EAAE,cAAc;YAChC,OAAO;YACP,CAAC,EAAE,KAAK;YACR,CAAC,EAAE,MAAM;YACT,IAAI,EAAE,KAAK;SACZ;QACD,gBAAgB,EAAE,KAAK;KACxB,CAAC;AACJ,CAAC,CAAC;AAiBF,8DAA8D;AAC9D,MAAM,WAAW,GAAc,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AACjE,MAAM,YAAY,GAAc,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACnE,MAAM,YAAY,GAAc,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACnE,MAAM,YAAY,GAAc,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACnE,MAAM,WAAW,GAAc,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AACjE,MAAM,YAAY,GAAc,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACnE,MAAM,cAAc,GAAc,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACvE,MAAM,cAAc,GAAc,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAEvE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,YAAY,GAAiC;IACxD,6DAA6D;IAC7D,MAAM,EAAE,WAAW,EAAE,+BAA+B;IACpD,MAAM,EAAE,WAAW,EAAE,gCAAgC;IACrD,MAAM,EAAE,YAAY,EAAE,gCAAgC;IACtD,MAAM,EAAE,YAAY,EAAE,gCAAgC;IAEtD,oBAAoB;IACpB,MAAM,EAAE,WAAW,EAAE,4BAA4B;IACjD,MAAM,EAAE,WAAW,EAAE,uBAAuB;IAC5C,MAAM,EAAE,WAAW,EAAE,wBAAwB;IAC7C,MAAM,EAAE,YAAY,EAAE,4BAA4B;IAClD,MAAM,EAAE,YAAY,EAAE,mCAAmC;IAEzD,yCAAyC;IACzC,MAAM,EAAE,WAAW,EAAE,kCAAkC;IACvD,MAAM,EAAE,WAAW,EAAE,mCAAmC;IACxD,MAAM,EAAE,WAAW,EAAE,kCAAkC;IACvD,MAAM,EAAE,WAAW;IAEnB,uCAAuC;IACvC,MAAM,EAAE,YAAY,EAAE,+BAA+B;IACrD,MAAM,EAAE,YAAY,EAAE,uCAAuC;IAC7D,MAAM,EAAE,YAAY,EAAE,MAAM;IAC5B,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY,EAAE,MAAM;IAC5B,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY,EAAE,MAAM;IAC5B,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,cAAc,EAAE,QAAQ;IAChC,MAAM,EAAE,cAAc;IACtB,MAAM,EAAE,cAAc,EAAE,QAAQ;IAChC,MAAM,EAAE,cAAc;CACvB,CAAC"}

package/dist/src/core/platforms/web/lib/textureSvg.d.ts

@@ -0,0 +1,7 @@
+import type { ImageResponse } from '../../../textures/ImageTexture.js';
+/**
+ * Loads a SVG image
+ * @param url
+ * @returns
+ */
+export declare const loadSvg: (url: string, width: number | null, height: number | null, sx: number | null, sy: number | null, sw: number | null, sh: number | null) => Promise<ImageResponse>;

package/dist/src/core/platforms/web/lib/textureSvg.js

@@ -0,0 +1,51 @@
+/*
+ * 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';
+/**
+ * Loads a SVG image
+ * @param url
+ * @returns
+ */
+export const loadSvg = (url, width, height, sx, sy, sw, sh) => {
+    return new Promise((resolve, reject) => {
+        const canvas = document.createElement('canvas');
+        const ctx = canvas.getContext('2d');
+        assertTruthy(ctx);
+        ctx.imageSmoothingEnabled = true;
+        const img = new Image();
+        img.onload = () => {
+            const x = sx ?? 0;
+            const y = sy ?? 0;
+            const w = width || img.width;
+            const h = height || img.height;
+            canvas.width = w;
+            canvas.height = h;
+            ctx.drawImage(img, 0, 0, w, h);
+            resolve({
+                data: ctx.getImageData(x, y, sw ?? w, sh ?? h),
+                premultiplyAlpha: false,
+            });
+        };
+        img.onerror = (err) => {
+            reject(err);
+        };
+        img.src = url;
+    });
+};
+//# sourceMappingURL=textureSvg.js.map

package/dist/src/core/platforms/web/lib/textureSvg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textureSvg.js","sourceRoot":"","sources":["../../../../../../src/core/platforms/web/lib/textureSvg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,GAAW,EACX,KAAoB,EACpB,MAAqB,EACrB,EAAiB,EACjB,EAAiB,EACjB,EAAiB,EACjB,EAAiB,EACO,EAAE;IAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACpC,YAAY,CAAC,GAAG,CAAC,CAAC;QAElB,GAAG,CAAC,qBAAqB,GAAG,IAAI,CAAC;QACjC,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE;YAChB,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAClB,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAClB,MAAM,CAAC,GAAG,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC;YAC7B,MAAM,CAAC,GAAG,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC;YAE/B,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;YACjB,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YAClB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAE/B,OAAO,CAAC;gBACN,IAAI,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;gBAC9C,gBAAgB,EAAE,KAAK;aACxB,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,GAAG,CAAC,OAAO,GAAG,CAAC,GAAG,EAAE,EAAE;YACpB,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC;QAEF,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/src/core/platforms/web/lib/utils.d.ts

@@ -0,0 +1,5 @@
+export declare const PROTOCOL_REGEX: RegExp;
+export declare function isBase64Image(src: string): boolean;
+export declare function dataURIToBlob(dataURI: string): Blob;
+export declare function convertUrlToAbsolute(url: string): string;
+export declare function createWebGLContext(canvas: HTMLCanvasElement | OffscreenCanvas, forceWebGL2?: boolean): WebGLRenderingContext;

package/dist/src/core/platforms/web/lib/utils.js

@@ -0,0 +1,86 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2026 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.
+ */
+export const PROTOCOL_REGEX = /^(data|ftps?|https?):/;
+export function isBase64Image(src) {
+    return src.startsWith('data:') === true;
+}
+export function dataURIToBlob(dataURI) {
+    dataURI = dataURI.replace(/^data:/, '');
+    const type = dataURI.match(/image\/[^;]+/)?.[0] || '';
+    const base64 = dataURI.replace(/^[^,]+,/, '');
+    const sliceSize = 1024;
+    const byteCharacters = atob(base64);
+    const bytesLength = byteCharacters.length;
+    const slicesCount = Math.ceil(bytesLength / sliceSize);
+    const byteArrays = new Array(slicesCount);
+    for (let sliceIndex = 0; sliceIndex < slicesCount; ++sliceIndex) {
+        const begin = sliceIndex * sliceSize;
+        const end = Math.min(begin + sliceSize, bytesLength);
+        const bytes = new Array(end - begin);
+        for (let offset = begin, i = 0; offset < end; ++i, ++offset) {
+            bytes[i] = byteCharacters[offset]?.charCodeAt(0);
+        }
+        byteArrays[sliceIndex] = new Uint8Array(bytes);
+    }
+    return new Blob(byteArrays, { type });
+}
+export function convertUrlToAbsolute(url) {
+    // handle local file imports if the url isn't remote resource or data blob
+    if (self.location.protocol === 'file:' && !PROTOCOL_REGEX.test(url)) {
+        const path = self.location.pathname.split('/');
+        path.pop();
+        const basePath = path.join('/');
+        const baseUrl = self.location.protocol + '//' + basePath;
+        // check if url has a leading dot
+        if (url.charAt(0) === '.') {
+            url = url.slice(1);
+        }
+        // check if url has a leading slash
+        if (url.charAt(0) === '/') {
+            url = url.slice(1);
+        }
+        return baseUrl + '/' + url;
+    }
+    const absoluteUrl = new URL(url, self.location.href);
+    return absoluteUrl.href;
+}
+export function createWebGLContext(canvas, forceWebGL2 = false) {
+    const config = {
+        alpha: true,
+        antialias: false,
+        depth: false,
+        stencil: true,
+        desynchronized: false,
+        // Disabled because it prevents Visual Regression Tests from working
+        // failIfMajorPerformanceCaveat: true,
+        powerPreference: 'high-performance',
+        premultipliedAlpha: true,
+        preserveDrawingBuffer: false,
+    };
+    const gl = 
+    // TODO: Remove this assertion once this issue is fixed in TypeScript
+    // https://github.com/microsoft/TypeScript/issues/53614
+    (canvas.getContext(forceWebGL2 ? 'webgl2' : 'webgl', config) ||
+        canvas.getContext('experimental-webgl', config));
+    if (!gl) {
+        throw new Error('Unable to create WebGL context');
+    }
+    return gl;
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/core/platforms/web/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../../src/core/platforms/web/lib/utils.ts"],"names":[],"mappings":"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"}

package/dist/src/core/renderers/CoreContextTexture.d.ts

@@ -6,7 +6,8 @@ export declare abstract class CoreContextTexture {
     state: 'freed' | 'loading' | 'loaded' | 'failed';
     constructor(memManager: TextureMemoryManager, textureSource: Texture);
     protected setTextureMemUse(byteSize: number): void;
-    abstract load(): void;
+    abstract load(): Promise<void>;
+    abstract release(): void;
     abstract free(): void;
     get renderable(): boolean;
 }

package/dist/src/core/renderers/CoreContextTexture.js.map

@@ -1 +1 @@
-{"version":3,"file":"CoreContextTexture.js","sourceRoot":"","sources":["../../../../src/core/renderers/CoreContextTexture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,MAAM,OAAgB,kBAAkB;IAC7B,aAAa,CAAU;IACxB,UAAU,CAAuB;IAClC,KAAK,GAA8C,OAAO,CAAC;IAElE,YAAY,UAAgC,EAAE,aAAsB;QAClE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAES,gBAAgB,CAAC,QAAgB;QACzC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;IAKD,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC;IACvC,CAAC;CACF"}
+{"version":3,"file":"CoreContextTexture.js","sourceRoot":"","sources":["../../../../src/core/renderers/CoreContextTexture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,MAAM,OAAgB,kBAAkB;IAC7B,aAAa,CAAU;IACxB,UAAU,CAAuB;IAClC,KAAK,GAA8C,OAAO,CAAC;IAElE,YAAY,UAAgC,EAAE,aAAsB;QAClE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAES,gBAAgB,CAAC,QAAgB;QACzC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;IAMD,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC;IACvC,CAAC;CACF"}

package/dist/src/core/renderers/CoreRenderer.d.ts

@@ -1,58 +1,22 @@
-import type { Dimensions } from '../../common/CommonTypes.js';
 import type { CoreNode } from '../CoreNode.js';
-import type { TextureOptions } from '../CoreTextureManager.js';
 import type { Stage } from '../Stage.js';
-import type { ContextSpy } from '../lib/ContextSpy.js';
-import type { RenderCoords } from '../lib/RenderCoords.js';
-import type { RectWithValid } from '../lib/utils.js';
 import type { CoreShaderProgram } from './CoreShaderProgram.js';
 import type { Texture, TextureCoords } from '../textures/Texture.js';
 import { CoreContextTexture } from './CoreContextTexture.js';
 import type { CoreShaderType, CoreShaderNode } from './CoreShaderNode.js';
-export interface QuadOptions {
-    width: number;
-    height: number;
-    colorTl: number;
-    colorTr: number;
-    colorBl: number;
-    colorBr: number;
-    texture: Texture | null;
-    textureOptions: TextureOptions | null;
-    textureCoords: TextureCoords | undefined;
-    zIndex: number;
-    shader: CoreShaderNode | null;
-    alpha: number;
-    clippingRect: RectWithValid;
-    tx: number;
-    ty: number;
-    ta: number;
-    tb: number;
-    tc: number;
-    td: number;
-    renderCoords?: RenderCoords;
-    rtt: boolean;
-    parentHasRenderTexture: boolean;
-    framebufferDimensions: Dimensions | null;
-}
-export interface CoreRendererOptions {
-    stage: Stage;
-    canvas: HTMLCanvasElement | OffscreenCanvas;
-    contextSpy: ContextSpy | null;
-    forceWebGL2: boolean;
-}
 export interface BufferInfo {
     totalUsed: number;
     totalAvailable: number;
 }
 export declare abstract class CoreRenderer {
-    options: CoreRendererOptions;
     mode: 'webgl' | 'canvas' | undefined;
+    defaultTextureCoords: TextureCoords | undefined;
     readonly stage: Stage;
     rttNodes: CoreNode[];
-    constructor(options: CoreRendererOptions);
+    constructor(stage: Stage);
     abstract reset(): void;
     abstract render(surface?: 'screen' | CoreContextTexture): void;
-    abstract addQuad(quad: QuadOptions): void;
+    abstract addQuad(node: CoreNode): void;
     abstract createCtxTexture(textureSource: Texture): CoreContextTexture;
     abstract createShaderProgram(shaderConfig: Readonly<CoreShaderType>, props?: Record<string, unknown>): CoreShaderProgram | null;
     abstract createShaderNode(shaderKey: string, shaderType: Readonly<CoreShaderType>, props?: Record<string, unknown>, program?: CoreShaderProgram): CoreShaderNode;
@@ -67,5 +31,5 @@ export declare abstract class CoreRenderer {
     abstract getQuadCount(): number | null;
     abstract updateViewport(): void;
     abstract updateClearColor(color: number): void;
-    getTextureCoords?(node: CoreNode): TextureCoords;
+    getTextureCoords?(node: CoreNode): TextureCoords | undefined;
 }

package/dist/src/core/renderers/CoreRenderer.js

@@ -18,14 +18,13 @@
  */
 import { CoreContextTexture } from './CoreContextTexture.js';
 export class CoreRenderer {
-    options;
     mode;
+    defaultTextureCoords = undefined;
     stage;
     //// Core Managers
     rttNodes = [];
-    constructor(options) {
-        this.options = options;
-        this.stage = options.stage;
+    constructor(stage) {
+        this.stage = stage;
     }
 }
 //# sourceMappingURL=CoreRenderer.js.map

package/dist/src/core/renderers/CoreRenderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"CoreRenderer.js","sourceRoot":"","sources":["../../../../src/core/renderers/CoreRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAWH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAyC7D,MAAM,OAAgB,YAAY;IACzB,OAAO,CAAsB;IAC7B,IAAI,CAAiC;IAEnC,KAAK,CAAQ;IAEtB,kBAAkB;IAClB,QAAQ,GAAe,EAAE,CAAC;IAE1B,YAAY,OAA4B;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,CAAC;CA4BF"}
+{"version":3,"file":"CoreRenderer.js","sourceRoot":"","sources":["../../../../src/core/renderers/CoreRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAQ7D,MAAM,OAAgB,YAAY;IACzB,IAAI,CAAiC;IAC5C,oBAAoB,GAA8B,SAAS,CAAC;IACnD,KAAK,CAAQ;IAEtB,kBAAkB;IAClB,QAAQ,GAAe,EAAE,CAAC;IAE1B,YAAY,KAAY;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CA4BF"}

package/dist/src/core/renderers/CoreShader.d.ts

@@ -0,0 +1,9 @@
+import type { CoreRenderOp } from './CoreRenderOp.js';
+export declare abstract class CoreShader {
+    static makeCacheKey(props: Record<string, unknown>): string | false;
+    static resolveDefaults(props: Record<string, unknown>): Record<string, unknown>;
+    abstract bindRenderOp(renderOp: CoreRenderOp, props: Record<string, unknown> | null): void;
+    protected abstract bindProps(props: Record<string, unknown>): void;
+    abstract attach(): void;
+    abstract detach(): void;
+}