@lightningtv/renderer 3.0.0-beta1 → 3.2.3

package/dist/src/core/lib/collectionUtils.js

@@ -0,0 +1,82 @@
+//Bucket sort implementation for sorting CoreNode arrays by zIndex
+export const bucketSortByZIndex = (nodes, min) => {
+    const buckets = [];
+    const bucketIndices = [];
+    //distribute nodes into buckets
+    for (let i = 0; i < nodes.length; i++) {
+        const node = nodes[i];
+        const index = node.props.zIndex - min;
+        //create bucket if it doesn't exist
+        if (buckets[index] === undefined) {
+            buckets[index] = [];
+            bucketIndices.push(index);
+        }
+        buckets[index].push(node);
+    }
+    //sort each bucket using insertion sort
+    for (let i = 1; i < bucketIndices.length; i++) {
+        const key = bucketIndices[i];
+        let j = i - 1;
+        while (j >= 0 && bucketIndices[j] > key) {
+            bucketIndices[j + 1] = bucketIndices[j];
+            j--;
+        }
+        bucketIndices[j + 1] = key;
+    }
+    //flatten buckets
+    let idx = 0;
+    for (let i = 0; i < bucketIndices.length; i++) {
+        const bucket = buckets[bucketIndices[i]];
+        for (let j = 0; j < bucket.length; j++) {
+            nodes[idx++] = bucket[j];
+        }
+    }
+    //clean up
+    buckets.length = 0;
+    bucketIndices.length = 0;
+};
+export const incrementalRepositionByZIndex = (changedNodes, nodes) => {
+    for (let i = 0; i < changedNodes.length; i++) {
+        const node = changedNodes[i];
+        const currentIndex = findChildIndexById(node, nodes);
+        if (currentIndex === -1)
+            continue;
+        const targetZIndex = node.props.zIndex;
+        //binary search for correct insertion position
+        let left = 0;
+        let right = nodes.length;
+        while (left < right) {
+            const mid = (left + right) >>> 1;
+            if (nodes[mid].props.zIndex <= targetZIndex) {
+                left = mid + 1;
+            }
+            else {
+                right = mid;
+            }
+        }
+        //adjust target position if it's after the current position
+        const targetIndex = left > currentIndex ? left - 1 : left;
+        //only reposition if target is different from current
+        if (targetIndex !== currentIndex) {
+            nodes.splice(currentIndex, 1);
+            nodes.splice(targetIndex, 0, node);
+        }
+    }
+};
+export const findChildIndexById = (node, children) => {
+    for (let i = 0; i < children.length; i++) {
+        const child = children[i];
+        // @ts-ignore - accessing protected property
+        if (child._id === node._id) {
+            return i;
+        }
+    }
+    return -1;
+};
+export const removeChild = (node, children) => {
+    const index = findChildIndexById(node, children);
+    if (index !== -1) {
+        children.splice(index, 1);
+    }
+};
+//# sourceMappingURL=collectionUtils.js.map

package/dist/src/core/lib/collectionUtils.js.map

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

package/dist/src/core/lib/colorCache.d.ts

@@ -0,0 +1 @@
+export declare function normalizeCanvasColor(color: number, isRGBA?: boolean): string;

package/dist/src/core/lib/colorCache.js

@@ -0,0 +1,19 @@
+import { parseToAbgrString, parseToRgbaString } from './colorParser.js';
+const parsedArgbColors = new Map();
+const parsedRgbaColors = new Map();
+export function normalizeCanvasColor(color, isRGBA = false) {
+    let targetCache = isRGBA === true ? parsedRgbaColors : parsedArgbColors;
+    let out = targetCache.get(color);
+    if (out !== undefined) {
+        return out;
+    }
+    if (isRGBA === true) {
+        out = parseToRgbaString(color);
+    }
+    else {
+        out = parseToAbgrString(color);
+    }
+    targetCache.set(color, out);
+    return out;
+}
+//# sourceMappingURL=colorCache.js.map

package/dist/src/core/lib/colorCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorCache.js","sourceRoot":"","sources":["../../../../src/core/lib/colorCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAExE,MAAM,gBAAgB,GAAwB,IAAI,GAAG,EAAE,CAAC;AACxD,MAAM,gBAAgB,GAAwB,IAAI,GAAG,EAAE,CAAC;AAExD,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,SAAkB,KAAK;IACzE,IAAI,WAAW,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC;IACxE,IAAI,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,GAAG,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC5B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/src/core/{renderers/canvas/internal/ColorUtils.js → lib/colorParser.js}

@@ -1,21 +1,3 @@
-/*
- * 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.
- */
 const WHITE = {
     isWhite: true,
     a: 1,
@@ -69,4 +51,4 @@ export function parseColorRgba(rgba) {
 export function formatRgba({ a, r, g, b }) {
     return `rgba(${r},${g},${b},${a})`;
 }
-//# sourceMappingURL=ColorUtils.js.map
+//# sourceMappingURL=colorParser.js.map

package/dist/src/core/lib/colorParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorParser.js","sourceRoot":"","sources":["../../../../src/core/lib/colorParser.ts"],"names":[],"mappings":"AAQA,MAAM,KAAK,GAAiB;IAC1B,OAAO,EAAE,IAAI;IACb,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;CACR,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;IACvC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IACrC,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;IACvC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IACrC,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7B,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IACrC,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;IACrC,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IACrC,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;IACrC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAgB;IACrD,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACrC,CAAC"}

package/dist/src/core/lib/textureCompression.d.ts

@@ -1,4 +1,6 @@
-import { type TextureData } from '../textures/Texture.js';
+import { type CompressedData, type TextureData } from '../textures/Texture.js';
+import type { WebGlContextWrapper } from './WebGlContextWrapper.js';
+export type UploadCompressedTextureFunction = (glw: WebGlContextWrapper, texture: WebGLTexture, data: CompressedData) => void;
 /**
  * Tests if the given location is a compressed texture container
  * @param url
@@ -7,10 +9,20 @@ import { type TextureData } from '../textures/Texture.js';
  * and only supports the following extensions: .ktx and .pvr
  * @returns
  */
-export declare function isCompressedTextureContainer(url: string): boolean;
+export declare function isCompressedTextureContainer(src: string): boolean;
 /**
  * Loads a compressed texture container
  * @param url
  * @returns
  */
 export declare const loadCompressedTexture: (url: string) => Promise<TextureData>;
+type BlockInfo = {
+    width: number;
+    height: number;
+    bytes: number;
+};
+export declare const blockInfoMap: {
+    [key: number]: BlockInfo;
+};
+export declare const uploadCompressedTexture: Record<string, UploadCompressedTextureFunction>;
+export {};

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

@@ -1,21 +1,3 @@
-/*
- * 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';
 /**
  * Tests if the given location is a compressed texture container
@@ -25,104 +7,357 @@ import {} from '../textures/Texture.js';
  * and only supports the following extensions: .ktx and .pvr
  * @returns
  */
-export function isCompressedTextureContainer(url) {
-    return /\.(ktx|pvr)$/.test(url);
+export function isCompressedTextureContainer(src) {
+    return /\.(ktx|pvr)$/.test(src);
 }
+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) => {
-    const response = await fetch(url);
-    const arrayBuffer = await response.arrayBuffer();
-    if (url.indexOf('.ktx') !== -1) {
-        return loadKTXData(arrayBuffer);
+    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}`);
     }
-    return loadPVRData(arrayBuffer);
 };
+function readUint24(view, offset) {
+    return (view.getUint8(offset) +
+        (view.getUint8(offset + 1) << 8) +
+        (view.getUint8(offset + 2) << 16));
+}
 /**
- * Loads a KTX texture container and returns the texture data
- * @param buffer
+ * Loads an ASTC texture container and returns the texture data
+ * @param view
  * @returns
  */
-const loadKTXData = async (buffer) => {
-    const view = new DataView(buffer);
-    const littleEndian = view.getUint32(12) === 16909060 ? true : false;
-    const mipmaps = [];
-    const data = {
-        glInternalFormat: view.getUint32(28, littleEndian),
-        pixelWidth: view.getUint32(36, littleEndian),
-        pixelHeight: view.getUint32(40, littleEndian),
-        numberOfMipmapLevels: view.getUint32(56, littleEndian),
-        bytesOfKeyValueData: view.getUint32(60, littleEndian),
-    };
-    let offset = 64;
-    // Key Value Pairs of data start at byte offset 64
-    // But the only known kvp is the API version, so skipping parsing.
-    offset += data.bytesOfKeyValueData;
-    for (let i = 0; i < data.numberOfMipmapLevels; i++) {
-        const imageSize = view.getUint32(offset);
-        offset += 4;
-        mipmaps.push(view.buffer.slice(offset, imageSize));
-        offset += imageSize;
+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: {
-            glInternalFormat: data.glInternalFormat,
+            blockInfo: blockInfoMap[internalFormat],
+            glInternalFormat: internalFormat,
             mipmaps,
-            width: data.pixelWidth || 0,
-            height: data.pixelHeight || 0,
-            type: 'ktx',
+            w: sizeX,
+            h: sizeY,
+            type: 'astc',
         },
         premultiplyAlpha: false,
     };
 };
+const uploadASTC = function (glw, texture, data) {
+    if (glw.getExtension('WEBGL_compressed_texture_astc') === null) {
+        throw new Error('ASTC compressed textures not supported by this device');
+    }
+    glw.bindTexture(texture);
+    const { glInternalFormat, mipmaps, w, h } = data;
+    if (mipmaps === undefined) {
+        return;
+    }
+    const view = new Uint8Array(mipmaps[0]);
+    glw.compressedTexImage2D(0, glInternalFormat, w, h, 0, view);
+    // ASTC textures MUST use no mipmaps unless stored
+    glw.texParameteri(glw.TEXTURE_WRAP_S, glw.CLAMP_TO_EDGE);
+    glw.texParameteri(glw.TEXTURE_WRAP_T, glw.CLAMP_TO_EDGE);
+    glw.texParameteri(glw.TEXTURE_MAG_FILTER, glw.LINEAR);
+    glw.texParameteri(glw.TEXTURE_MIN_FILTER, glw.LINEAR);
+};
 /**
- * Loads a PVR texture container and returns the texture data
- * @param buffer
+ * Loads a KTX texture container and returns the texture data
+ * @param view
  * @returns
  */
-const loadPVRData = async (buffer) => {
-    // pvr header length in 32 bits
-    const pvrHeaderLength = 13;
-    // for now only we only support: COMPRESSED_RGB_ETC1_WEBGL
-    const pvrFormatEtc1 = 0x8d64;
-    const pvrWidth = 7;
-    const pvrHeight = 6;
-    const pvrMipmapCount = 11;
-    const pvrMetadata = 12;
-    const arrayBuffer = buffer;
-    const header = new Int32Array(arrayBuffer, 0, pvrHeaderLength);
-    // @ts-expect-error Object possibly undefined
-    const dataOffset = header[pvrMetadata] + 52;
-    const pvrtcData = new Uint8Array(arrayBuffer, dataOffset);
+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 data = {
-        pixelWidth: header[pvrWidth],
-        pixelHeight: header[pvrHeight],
-        numberOfMipmapLevels: header[pvrMipmapCount] || 0,
+    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,
     };
-    let offset = 0;
-    let width = data.pixelWidth || 0;
-    let height = data.pixelHeight || 0;
-    for (let i = 0; i < data.numberOfMipmapLevels; i++) {
-        const level = ((width + 3) >> 2) * ((height + 3) >> 2) * 8;
-        const view = new Uint8Array(arrayBuffer, pvrtcData.byteOffset + offset, level);
-        mipmaps.push(view);
-        offset += level;
-        width = width >> 1;
-        height = height >> 1;
+};
+const uploadKTX = function (glw, texture, data) {
+    const { glInternalFormat, mipmaps, w: width, h: height, blockInfo } = data;
+    if (mipmaps === undefined) {
+        return;
+    }
+    glw.bindTexture(texture);
+    const blockWidth = blockInfo.width;
+    const blockHeight = blockInfo.height;
+    let w = width;
+    let h = height;
+    for (let i = 0; i < mipmaps.length; i++) {
+        let view = new Uint8Array(mipmaps[i]);
+        const uploadW = Math.ceil(w / blockWidth) * blockWidth;
+        const uploadH = Math.ceil(h / blockHeight) * blockHeight;
+        const expectedBytes = Math.ceil(w / blockWidth) * Math.ceil(h / blockHeight) * blockInfo.bytes;
+        if (view.byteLength < expectedBytes) {
+            const padded = new Uint8Array(expectedBytes);
+            padded.set(view);
+            view = padded;
+        }
+        glw.compressedTexImage2D(i, glInternalFormat, uploadW, uploadH, 0, view);
+        w = Math.max(1, w >> 1);
+        h = Math.max(1, h >> 1);
+    }
+    glw.texParameteri(glw.TEXTURE_WRAP_S, glw.CLAMP_TO_EDGE);
+    glw.texParameteri(glw.TEXTURE_WRAP_T, glw.CLAMP_TO_EDGE);
+    glw.texParameteri(glw.TEXTURE_MAG_FILTER, glw.LINEAR);
+    glw.texParameteri(glw.TEXTURE_MIN_FILTER, mipmaps.length > 1 ? glw.LINEAR_MIPMAP_LINEAR : glw.LINEAR);
+};
+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: {
-            glInternalFormat: pvrFormatEtc1,
-            mipmaps: mipmaps,
-            width: data.pixelWidth || 0,
-            height: data.pixelHeight || 0,
+            blockInfo: blockInfoMap[internalFormat],
+            glInternalFormat: internalFormat,
+            mipmaps,
+            w: width,
+            h: height,
             type: 'pvr',
         },
         premultiplyAlpha: false,
     };
 };
+const uploadPVR = function (glw, texture, data) {
+    const { glInternalFormat, mipmaps, w: width, h: height } = data;
+    if (mipmaps === undefined) {
+        return;
+    }
+    glw.bindTexture(texture);
+    let w = width;
+    let h = height;
+    for (let i = 0; i < mipmaps.length; i++) {
+        glw.compressedTexImage2D(i, glInternalFormat, w, h, 0, new Uint8Array(mipmaps[i]));
+        w = Math.max(1, w >> 1);
+        h = Math.max(1, h >> 1);
+    }
+    glw.texParameteri(glw.TEXTURE_WRAP_S, glw.CLAMP_TO_EDGE);
+    glw.texParameteri(glw.TEXTURE_WRAP_T, glw.CLAMP_TO_EDGE);
+    glw.texParameteri(glw.TEXTURE_MAG_FILTER, glw.LINEAR);
+    glw.texParameteri(glw.TEXTURE_MIN_FILTER, mipmaps.length > 1 ? glw.LINEAR_MIPMAP_LINEAR : glw.LINEAR);
+};
+// 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,
+};
+export const uploadCompressedTexture = {
+    ktx: uploadKTX,
+    pvr: uploadPVR,
+    astc: uploadASTC,
+};
 //# sourceMappingURL=textureCompression.js.map