@flighthq/texture-formats 0.2.1-next.451.d9a4a4e → 0.2.1-next.530.a223ca9

package/dist/byteReader.d.ts

@@ -5,6 +5,7 @@ export interface ByteReader {
 export declare function createByteReader(bytes: Readonly<Uint8Array>, offset?: number): ByteReader;
 export declare function hasByteReaderBytes(reader: Readonly<ByteReader>, count: number): boolean;
 export declare function readByteReaderU16(reader: ByteReader): number;
+export declare function readByteReaderU24(reader: ByteReader): number;
 export declare function readByteReaderU24BigEndian(reader: ByteReader): number;
 export declare function readByteReaderU32(reader: ByteReader): number;
 export declare function readByteReaderU32BigEndian(reader: ByteReader): number;

package/dist/byteReader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"byteReader.d.ts","sourceRoot":"","sources":["../src/byteReader.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,SAAI,GAAG,UAAU,CAEpF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAI5D;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAMrE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAI5D;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAIrE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAK5D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAI3D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEtE"}
+{"version":3,"file":"byteReader.d.ts","sourceRoot":"","sources":["../src/byteReader.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,SAAI,GAAG,UAAU,CAEpF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAI5D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAM5D;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAMrE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAI5D;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAIrE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAK5D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAI3D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEtE"}

package/dist/byteReader.js

@@ -17,6 +17,13 @@ export function readByteReaderU16(reader) {
     reader.offset += 2;
     return value;
 }
+export function readByteReaderU24(reader) {
+    const view = reader.view;
+    const offset = reader.offset;
+    const value = view.getUint8(offset) | (view.getUint8(offset + 1) << 8) | (view.getUint8(offset + 2) << 16);
+    reader.offset += 3;
+    return value;
+}
 export function readByteReaderU24BigEndian(reader) {
     const view = reader.view;
     const offset = reader.offset;

package/dist/byteReader.js.map

@@ -1 +1 @@
-{"version":3,"file":"byteReader.js","sourceRoot":"","sources":["../src/byteReader.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,oGAAoG;AACpG,sGAAsG;AACtG,mGAAmG;AACnG,uGAAuG;AACvG,wGAAwG;AACxG,wGAAwG;AACxG,sEAAsE;AAOtE,MAAM,UAAU,gBAAgB,CAAC,KAA2B,EAAE,MAAM,GAAG,CAAC;IACtE,OAAO,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAA4B,EAAE,KAAa;IAC5E,OAAO,KAAK,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzD,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACnB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAkB;IAC3D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3G,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACnB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzD,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACnB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAkB;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1D,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACnB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;IAC5D,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACnB,OAAO,IAAI,GAAG,aAAa,GAAG,GAAG,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACnB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAkB,EAAE,KAAa;IAC9D,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC;AACzB,CAAC"}
+{"version":3,"file":"byteReader.js","sourceRoot":"","sources":["../src/byteReader.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -4,4 +4,5 @@ export * from './parseBasis';
 export * from './parseDds';
 export * from './parseKtx2';
 export * from './selectTextureContainer';
+export * from './textureLevelLayout';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -4,4 +4,5 @@ export * from './parseBasis';
 export * from './parseDds';
 export * from './parseKtx2';
 export * from './selectTextureContainer';
+export * from './textureLevelLayout';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC"}

package/dist/parseBasis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parseBasis.d.ts","sourceRoot":"","sources":["../src/parseBasis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAwBxD,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,gBAAgB,GAAG,IAAI,CAqD/E"}
+{"version":3,"file":"parseBasis.d.ts","sourceRoot":"","sources":["../src/parseBasis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AA0BxD,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,gBAAgB,GAAG,IAAI,CAuD/E"}

package/dist/parseBasis.js

@@ -1,4 +1,4 @@
-import { createByteReader, hasByteReaderBytes, readByteReaderU16, readByteReaderU32, readByteReaderU8, } from './byteReader';
+import { createByteReader, hasByteReaderBytes, readByteReaderU16, readByteReaderU24, readByteReaderU32, readByteReaderU8, } from './byteReader';
 // Parses a Basis Universal `.basis` container into a `TextureContainer`, or returns `null` if the bytes
 // are not a `.basis` file, are truncated, or carry an unknown texture format.
 //
@@ -9,21 +9,25 @@ import { createByteReader, hasByteReaderBytes, readByteReaderU16, readByteReader
 // compressed — transcoding ETC1S/UASTC to a GPU format is the caller's / `flight-rs`'s job.
 //
 // The ETC1S codebook/selector/table sections and per-slice CRCs are not read (they are inputs to the
-// transcoder, not to locating a slice). Basis cube/video texture types are not distinguished — every
-// image is reported as an array layer (`faces` = 1).
+// transcoder, not to locating a slice). 2D/array images become layers, cubemap-array images become six
+// faces per layer, and volume images become depth slices. Video frames are rejected because the common
+// container descriptor cannot preserve their temporal/conditional-replenishment semantics truthfully.
 export function parseBasis(bytes) {
     if (!hasBasisSignature(bytes))
         return null;
     if (bytes.byteLength < basisHeaderMinSize)
         return null;
     const header = createByteReader(bytes, basisTotalSlicesOffset);
-    const totalSlices = readByteReaderU16(header); // m_total_slices (offset 12)
-    const totalImages = readByteReaderU16(header); // m_total_images (offset 14)
-    const format = basisTexFormat[bytes[basisTexFormatOffset]]; // m_tex_format (offset 16)
+    const totalSlices = readByteReaderU24(header); // m_total_slices (offset 14)
+    const totalImages = readByteReaderU24(header); // m_total_images (offset 17)
+    const format = basisTexFormat[bytes[basisTexFormatOffset]]; // m_tex_format (offset 20)
     if (format === undefined)
         return null;
     if (totalSlices === 0)
         return null;
+    const shape = getBasisTextureShape(bytes[basisTexTypeOffset], totalImages);
+    if (shape === null)
+        return null;
     const sliceDescReader = createByteReader(bytes, basisSliceDescOffsetField);
     const sliceDescOffset = readByteReaderU32(sliceDescReader);
     const table = createByteReader(bytes, sliceDescOffset);
@@ -34,7 +38,7 @@ export function parseBasis(bytes) {
     let baseHeight = 0;
     let maxLevel = 0;
     for (let slice = 0; slice < totalSlices; slice += 1) {
-        const imageIndex = readByteReaderU16(table);
+        const imageIndex = readByteReaderU24(table);
         const levelIndex = readByteReaderU8(table);
         readByteReaderU8(table); // m_flags
         const width = readByteReaderU16(table);
@@ -55,26 +59,50 @@ export function parseBasis(bytes) {
         levels.push({ byteLength, byteOffset, height, width });
     }
     return {
-        depth: 1,
-        faces: 1,
+        depth: shape.depth,
+        faces: shape.faces,
         format,
         height: baseHeight || (levels[0]?.height ?? 0),
-        layers: Math.max(1, totalImages),
+        layers: shape.layers,
         levels,
         mipLevels: Math.max(1, maxLevel),
         supercompression: 'None',
         width: baseWidth || (levels[0]?.width ?? 0),
     };
 }
+function getBasisTextureShape(textureType, totalImages) {
+    const images = Math.max(1, totalImages);
+    switch (textureType) {
+        case basisTextureType2d:
+        case basisTextureType2dArray:
+            return { depth: 1, faces: 1, layers: images };
+        case basisTextureTypeCubemapArray:
+            if (totalImages === 0 || totalImages % 6 !== 0)
+                return null;
+            return { depth: 1, faces: 6, layers: totalImages / 6 };
+        case basisTextureTypeVideoFrames:
+            return null;
+        case basisTextureTypeVolume:
+            return { depth: images, faces: 1, layers: 1 };
+        default:
+            return null;
+    }
+}
 function hasBasisSignature(bytes) {
     // m_sig = 0x4273, stored little-endian: byte 0 = 0x73 ('s'), byte 1 = 0x42 ('B').
     return bytes.byteLength >= 2 && bytes[0] === 0x73 && bytes[1] === 0x42;
 }
-const basisTotalSlicesOffset = 12;
-const basisTexFormatOffset = 16;
-const basisSliceDescOffsetField = 61;
-const basisHeaderMinSize = 65; // through m_slice_desc_file_ofs (offset 61, 4 bytes)
-const basisSliceDescSize = 22;
+const basisTotalSlicesOffset = 14;
+const basisTexFormatOffset = 20;
+const basisTexTypeOffset = 23;
+const basisSliceDescOffsetField = 63;
+const basisHeaderMinSize = 67; // through m_slice_desc_file_ofs (offset 63, 4 bytes)
+const basisSliceDescSize = 23;
+const basisTextureType2d = 0;
+const basisTextureType2dArray = 1;
+const basisTextureTypeCubemapArray = 2;
+const basisTextureTypeVideoFrames = 3;
+const basisTextureTypeVolume = 4;
 const basisTexFormat = {
     0: 'etc1s',
     1: 'uastc',

package/dist/parseBasis.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseBasis.js","sourceRoot":"","sources":["../src/parseBasis.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parseBasis.js","sourceRoot":"","sources":["../src/parseBasis.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,wGAAwG;AACxG,8EAA8E;AAC9E,EAAE;AACF,uGAAuG;AACvG,oGAAoG;AACpG,sGAAsG;AACtG,iGAAiG;AACjG,4FAA4F;AAC5F,EAAE;AACF,qGAAqG;AACrG,uGAAuG;AACvG,uGAAuG;AACvG,sGAAsG;AACtG,MAAM,UAAU,UAAU,CAAC,KAA2B;IACpD,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,KAAK,CAAC,UAAU,GAAG,kBAAkB;QAAE,OAAO,IAAI,CAAC;IAEvD,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,6BAA6B;IAC5E,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,6BAA6B;IAC5E,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,2BAA2B;IACvF,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,WAAW,CAAC,CAAC;IAC3E,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,MAAM,eAAe,GAAG,gBAAgB,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;IAC3E,MAAM,eAAe,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAE3D,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IACvD,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,kBAAkB,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9E,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,WAAW,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC3C,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU;QACnC,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACxC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB;QAC3C,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB;QAC3C,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC5C,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,qBAAqB;QAC/C,IAAI,UAAU,GAAG,UAAU,GAAG,KAAK,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAE5D,IAAI,UAAU,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;YACzC,SAAS,GAAG,KAAK,CAAC;YAClB,UAAU,GAAG,MAAM,CAAC;QACtB,CAAC;QACD,IAAI,UAAU,GAAG,CAAC,GAAG,QAAQ;YAAE,QAAQ,GAAG,UAAU,GAAG,CAAC,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM;QACN,MAAM,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;QAC9C,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM;QACN,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC;QAChC,gBAAgB,EAAE,MAAM;QACxB,KAAK,EAAE,SAAS,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,WAAmB,EACnB,WAAmB;IAEnB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IACxC,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,kBAAkB,CAAC;QACxB,KAAK,uBAAuB;YAC1B,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAChD,KAAK,4BAA4B;YAC/B,IAAI,WAAW,KAAK,CAAC,IAAI,WAAW,GAAG,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC5D,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,CAAC,EAAE,CAAC;QACzD,KAAK,2BAA2B;YAC9B,OAAO,IAAI,CAAC;QACd,KAAK,sBAAsB;YACzB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,KAA2B;IACpD,kFAAkF;IAClF,OAAO,KAAK,CAAC,UAAU,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AACzE,CAAC;AAED,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAClC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAChC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAC9B,MAAM,yBAAyB,GAAG,EAAE,CAAC;AACrC,MAAM,kBAAkB,GAAG,EAAE,CAAC,CAAC,qDAAqD;AACpF,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAClC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AACvC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AACtC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAEjC,MAAM,cAAc,GAAqD;IACvE,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,OAAO;CACX,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/texture-formats",
-  "version": "0.2.1-next.451.d9a4a4e",
+  "version": "0.2.1-next.530.a223ca9",
   "repository": {
     "type": "git",
     "url": "https://github.com/flighthq/flight.git",
@@ -32,11 +32,11 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/types": "0.2.1-next.451.d9a4a4e"
+    "@flighthq/types": "0.2.1-next.530.a223ca9"
   },
   "devDependencies": {
     "typescript": "^5.3.0"
   },
-  "description": "Tree-shakable GPU texture-container parsers (KTX2 / DDS / Basis) — identify format and locate per-level byte ranges, no transcode",
+  "description": "Tree-shakable GPU texture-container parsers (KTX2 / DDS / Basis / ATF), peer selection, and level layout — no transcode",
   "sideEffects": false
 }

package/src/byteReader.test.ts

@@ -4,6 +4,7 @@ import {
   createByteReader,
   hasByteReaderBytes,
   readByteReaderU16,
+  readByteReaderU24,
   readByteReaderU24BigEndian,
   readByteReaderU32,
   readByteReaderU32BigEndian,
@@ -43,6 +44,19 @@ describe('readByteReaderU16', () => {
   });
 });
 
+describe('readByteReaderU24', () => {
+  it('reads a 3-byte little-endian value and advances 3', () => {
+    const reader = createByteReader(new Uint8Array([0x56, 0x34, 0x12]));
+    expect(readByteReaderU24(reader)).toBe(0x123456);
+    expect(reader.offset).toBe(3);
+  });
+
+  it('reads the full 24-bit range without sign issues', () => {
+    const reader = createByteReader(new Uint8Array([0xff, 0xff, 0xff]));
+    expect(readByteReaderU24(reader)).toBe(0xffffff);
+  });
+});
+
 describe('readByteReaderU24BigEndian', () => {
   it('reads a 3-byte big-endian value and advances 3', () => {
     const reader = createByteReader(new Uint8Array([0x12, 0x34, 0x56]));

package/src/parseBasis.test.ts

@@ -14,14 +14,21 @@ interface BasisSlice {
 interface BasisOptions {
   totalImages?: number;
   texFormat?: number;
+  texType?: number;
   slices: readonly BasisSlice[];
 }
 
 const basisHeaderSize = 77;
-const basisSliceDescSize = 22;
+const basisSliceDescSize = 23;
+
+function setU24(dv: DataView, offset: number, value: number): void {
+  dv.setUint8(offset, value & 0xff);
+  dv.setUint8(offset + 1, (value >>> 8) & 0xff);
+  dv.setUint8(offset + 2, (value >>> 16) & 0xff);
+}
 
 function buildBasis(opts: BasisOptions): Uint8Array {
-  const { totalImages = 1, texFormat = 0, slices } = opts;
+  const { totalImages = 1, texFormat = 0, texType = 0, slices } = opts;
   const sliceTableOffset = basisHeaderSize;
   const dataStart = sliceTableOffset + slices.length * basisSliceDescSize;
   const total = slices.reduce((max, s) => Math.max(max, s.fileOfs + s.fileSize), dataStart);
@@ -29,18 +36,19 @@ function buildBasis(opts: BasisOptions): Uint8Array {
   const dv = new DataView(bytes.buffer);
   bytes[0] = 0x73; // 's'
   bytes[1] = 0x42; // 'B'
-  dv.setUint16(12, slices.length, true); // m_total_slices
-  dv.setUint16(14, totalImages, true); // m_total_images
-  bytes[16] = texFormat; // m_tex_format
-  dv.setUint32(61, sliceTableOffset, true); // m_slice_desc_file_ofs
+  setU24(dv, 14, slices.length); // m_total_slices
+  setU24(dv, 17, totalImages); // m_total_images
+  bytes[20] = texFormat; // m_tex_format
+  bytes[23] = texType; // m_tex_type
+  dv.setUint32(63, sliceTableOffset, true); // m_slice_desc_file_ofs
   let off = sliceTableOffset;
   for (const slice of slices) {
-    dv.setUint16(off + 0, slice.imageIndex, true);
-    bytes[off + 2] = slice.levelIndex;
-    dv.setUint16(off + 4, slice.width, true);
-    dv.setUint16(off + 6, slice.height, true);
-    dv.setUint32(off + 12, slice.fileOfs, true);
-    dv.setUint32(off + 16, slice.fileSize, true);
+    setU24(dv, off, slice.imageIndex);
+    bytes[off + 3] = slice.levelIndex;
+    dv.setUint16(off + 5, slice.width, true);
+    dv.setUint16(off + 7, slice.height, true);
+    dv.setUint32(off + 13, slice.fileOfs, true);
+    dv.setUint32(off + 17, slice.fileSize, true);
     off += basisSliceDescSize;
   }
   return bytes;
@@ -49,7 +57,7 @@ function buildBasis(opts: BasisOptions): Uint8Array {
 describe('parseBasis', () => {
   it('parses a single-slice ETC1S image', () => {
     const container = parseBasis(
-      buildBasis({ slices: [{ fileOfs: 99, fileSize: 8, height: 4, imageIndex: 0, levelIndex: 0, width: 4 }] }),
+      buildBasis({ slices: [{ fileOfs: 100, fileSize: 8, height: 4, imageIndex: 0, levelIndex: 0, width: 4 }] }),
     );
     expect(container).not.toBeNull();
     expect(container!.format).toBe('etc1s');
@@ -59,28 +67,28 @@ describe('parseBasis', () => {
     expect(container!.layers).toBe(1);
     expect(container!.faces).toBe(1);
     expect(container!.supercompression).toBe('None');
-    expect(container!.levels).toEqual([{ byteLength: 8, byteOffset: 99, height: 4, width: 4 }]);
+    expect(container!.levels).toEqual([{ byteLength: 8, byteOffset: 100, height: 4, width: 4 }]);
   });
 
   it('reports a mip chain from the slice level indices', () => {
     const container = parseBasis(
       buildBasis({
         slices: [
-          { fileOfs: 121, fileSize: 8, height: 4, imageIndex: 0, levelIndex: 0, width: 4 },
-          { fileOfs: 129, fileSize: 4, height: 2, imageIndex: 0, levelIndex: 1, width: 2 },
+          { fileOfs: 123, fileSize: 8, height: 4, imageIndex: 0, levelIndex: 0, width: 4 },
+          { fileOfs: 131, fileSize: 4, height: 2, imageIndex: 0, levelIndex: 1, width: 2 },
         ],
       }),
     );
     expect(container).not.toBeNull();
     expect(container!.mipLevels).toBe(2);
     expect(container!.levels.map((l) => l.width)).toEqual([4, 2]);
-    expect(container!.levels.map((l) => l.byteOffset)).toEqual([121, 129]);
+    expect(container!.levels.map((l) => l.byteOffset)).toEqual([123, 131]);
   });
 
   it('maps the UASTC texture format', () => {
     const container = parseBasis(
       buildBasis({
-        slices: [{ fileOfs: 99, fileSize: 16, height: 4, imageIndex: 0, levelIndex: 0, width: 4 }],
+        slices: [{ fileOfs: 100, fileSize: 16, height: 4, imageIndex: 0, levelIndex: 0, width: 4 }],
         texFormat: 1,
       }),
     );
@@ -91,8 +99,8 @@ describe('parseBasis', () => {
     const container = parseBasis(
       buildBasis({
         slices: [
-          { fileOfs: 121, fileSize: 8, height: 4, imageIndex: 0, levelIndex: 0, width: 4 },
-          { fileOfs: 129, fileSize: 8, height: 4, imageIndex: 1, levelIndex: 0, width: 4 },
+          { fileOfs: 123, fileSize: 8, height: 4, imageIndex: 0, levelIndex: 0, width: 4 },
+          { fileOfs: 131, fileSize: 8, height: 4, imageIndex: 1, levelIndex: 0, width: 4 },
         ],
         totalImages: 2,
       }),
@@ -101,13 +109,54 @@ describe('parseBasis', () => {
     expect(container!.levels).toHaveLength(2);
   });
 
+  it('reads 24-bit image counts and slice image indices', () => {
+    const container = parseBasis(
+      buildBasis({
+        slices: [{ fileOfs: 100, fileSize: 8, height: 4, imageIndex: 70_000, levelIndex: 0, width: 4 }],
+        totalImages: 70_001,
+      }),
+    );
+    expect(container).not.toBeNull();
+    expect(container!.layers).toBe(70_001);
+    expect(container!.levels).toEqual([{ byteLength: 8, byteOffset: 100, height: 4, width: 4 }]);
+  });
+
+  it('preserves cubemap-array faces and layers', () => {
+    const slices: BasisSlice[] = [];
+    for (let imageIndex = 0; imageIndex < 12; imageIndex++) {
+      slices.push({ fileOfs: 353 + imageIndex * 8, fileSize: 8, height: 4, imageIndex, levelIndex: 0, width: 4 });
+    }
+    const container = parseBasis(buildBasis({ slices, texType: 2, totalImages: 12 }));
+    expect(container).not.toBeNull();
+    expect(container!.faces).toBe(6);
+    expect(container!.layers).toBe(2);
+    expect(container!.depth).toBe(1);
+    expect(container!.levels).toHaveLength(12);
+  });
+
+  it('preserves volume depth and rejects temporal or malformed cube shapes', () => {
+    const slices = [
+      { fileOfs: 146, fileSize: 8, height: 4, imageIndex: 0, levelIndex: 0, width: 4 },
+      { fileOfs: 154, fileSize: 8, height: 4, imageIndex: 1, levelIndex: 0, width: 4 },
+      { fileOfs: 162, fileSize: 8, height: 4, imageIndex: 2, levelIndex: 0, width: 4 },
+    ];
+    const volume = parseBasis(buildBasis({ slices, texType: 4, totalImages: 3 }));
+    expect(volume).not.toBeNull();
+    expect(volume!.depth).toBe(3);
+    expect(volume!.faces).toBe(1);
+    expect(volume!.layers).toBe(1);
+
+    expect(parseBasis(buildBasis({ slices, texType: 3, totalImages: 3 }))).toBeNull();
+    expect(parseBasis(buildBasis({ slices, texType: 2, totalImages: 3 }))).toBeNull();
+  });
+
   it('returns null for a non-Basis, truncated, or unknown-format buffer', () => {
     expect(parseBasis(new Uint8Array([0x44, 0x44, 0x53, 0x20]))).toBeNull();
     expect(parseBasis(new Uint8Array([0x73, 0x42, 0, 0]))).toBeNull();
     expect(
       parseBasis(
         buildBasis({
-          slices: [{ fileOfs: 99, fileSize: 8, height: 4, imageIndex: 0, levelIndex: 0, width: 4 }],
+          slices: [{ fileOfs: 100, fileSize: 8, height: 4, imageIndex: 0, levelIndex: 0, width: 4 }],
           texFormat: 5,
         }),
       ),
@@ -116,9 +165,9 @@ describe('parseBasis', () => {
 
   it('returns null when the slice table runs past the buffer', () => {
     const bytes = buildBasis({
-      slices: [{ fileOfs: 99, fileSize: 8, height: 4, imageIndex: 0, levelIndex: 0, width: 4 }],
+      slices: [{ fileOfs: 100, fileSize: 8, height: 4, imageIndex: 0, levelIndex: 0, width: 4 }],
     });
-    new DataView(bytes.buffer).setUint32(61, 1_000_000, true); // corrupt m_slice_desc_file_ofs
+    new DataView(bytes.buffer).setUint32(63, 1_000_000, true); // corrupt m_slice_desc_file_ofs
     expect(parseBasis(bytes)).toBeNull();
   });
 });

package/src/parseDds.test.ts

@@ -131,6 +131,25 @@ describe('parseDds', () => {
     expect(container!.levels[0].byteOffset).toBe(148); // data follows the 20-byte DX10 header
   });
 
+  it('lays out every DX10 array layer as an independent subresource chain', () => {
+    const container = parseDds(
+      buildDds({
+        dx10: { arraySize: 3, dxgiFormat: 98 },
+        fourCC: fourCC('DX10'),
+        height: 4,
+        pfFlags: 0x4,
+        width: 4,
+      }),
+    );
+    expect(container).not.toBeNull();
+    expect(container!.layers).toBe(3);
+    expect(container!.levels).toEqual([
+      { byteLength: 16, byteOffset: 148, height: 4, width: 4 },
+      { byteLength: 16, byteOffset: 164, height: 4, width: 4 },
+      { byteLength: 16, byteOffset: 180, height: 4, width: 4 },
+    ]);
+  });
+
   it('returns null for a non-DDS, truncated, unknown-format, or volume texture', () => {
     expect(parseDds(new Uint8Array([0xab, 0x4b, 0x54, 0x58]))).toBeNull();
     expect(parseDds(new Uint8Array([0x44, 0x44, 0x53, 0x20, 0, 0, 0, 0]))).toBeNull();

package/src/parseKtx2.test.ts

@@ -74,6 +74,25 @@ describe('parseKtx2', () => {
     expect(container!.levels.map((l) => l.byteOffset)).toEqual([104, 168, 232, 296, 360, 424]);
   });
 
+  it('splits an uncompressed array level into one range per layer', () => {
+    const container = parseKtx2(
+      buildKtx2({
+        layerCount: 3,
+        levels: [{ byteLength: 192, byteOffset: 104 }],
+        vkFormat: 37,
+        width: 4,
+        height: 4,
+      }),
+    );
+    expect(container).not.toBeNull();
+    expect(container!.layers).toBe(3);
+    expect(container!.levels).toEqual([
+      { byteLength: 64, byteOffset: 104, height: 4, width: 4 },
+      { byteLength: 64, byteOffset: 168, height: 4, width: 4 },
+      { byteLength: 64, byteOffset: 232, height: 4, width: 4 },
+    ]);
+  });
+
   it('reports each mip of a mip chain from the level index', () => {
     const container = parseKtx2(
       buildKtx2({
@@ -112,6 +131,27 @@ describe('parseKtx2', () => {
     expect(container!.format).toBe('uastc');
   });
 
+  it('preserves Zstd and ZLIB supercompressed levels as indivisible blobs', () => {
+    for (const [scheme, supercompression] of [
+      [2, 'Zstd'],
+      [3, 'ZLIB'],
+    ] as const) {
+      const container = parseKtx2(
+        buildKtx2({
+          layerCount: 2,
+          levels: [{ byteLength: 48, byteOffset: 104 }],
+          scheme,
+          vkFormat: 37,
+          width: 4,
+          height: 4,
+        }),
+      );
+      expect(container).not.toBeNull();
+      expect(container!.supercompression).toBe(supercompression);
+      expect(container!.levels).toEqual([{ byteLength: 48, byteOffset: 104, height: 4, width: 4 }]);
+    }
+  });
+
   it('returns null for a non-KTX2 buffer', () => {
     expect(parseKtx2(new Uint8Array([0x44, 0x44, 0x53, 0x20]))).toBeNull();
   });