@flighthq/texture-formats 0.1.0

package/dist/byteReader.d.ts

@@ -0,0 +1,14 @@
+export interface ByteReader {
+    readonly view: DataView;
+    offset: number;
+}
+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 readByteReaderU24BigEndian(reader: ByteReader): number;
+export declare function readByteReaderU32(reader: ByteReader): number;
+export declare function readByteReaderU32BigEndian(reader: ByteReader): number;
+export declare function readByteReaderU64(reader: ByteReader): number;
+export declare function readByteReaderU8(reader: ByteReader): number;
+export declare function skipByteReader(reader: ByteReader, count: number): void;
+//# sourceMappingURL=byteReader.d.ts.map

package/dist/byteReader.d.ts.map

@@ -0,0 +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"}

package/dist/byteReader.js

@@ -0,0 +1,51 @@
+// A minimal cursor over a byte buffer, shared by every container parser. KTX2, DDS, and the Basis
+// container are little-endian (the `read*U16`/`U32`/`U64` helpers); ATF stores its block and header
+// lengths big-endian, so `readByteReaderU24BigEndian` reads a legacy ATF's 3-byte block-length prefix
+// and `readByteReaderU32BigEndian` reads a versioned ATF's 4-byte block/header lengths. The cursor
+// is a plain `{ view, offset }` value with an advancing `offset`; read functions advance it, and every
+// parser guards a read against `hasByteReaderBytes` first so a truncated file returns a sentinel `null`
+// rather than throwing a `DataView` `RangeError`. `readByteReaderU64` returns the value as a JavaScript
+// number, exact for the sub-2^53 offsets/lengths real containers use.
+export function createByteReader(bytes, offset = 0) {
+    return { view: new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength), offset };
+}
+export function hasByteReaderBytes(reader, count) {
+    return count >= 0 && reader.offset + count <= reader.view.byteLength;
+}
+export function readByteReaderU16(reader) {
+    const value = reader.view.getUint16(reader.offset, true);
+    reader.offset += 2;
+    return value;
+}
+export function readByteReaderU24BigEndian(reader) {
+    const view = reader.view;
+    const offset = reader.offset;
+    const value = (view.getUint8(offset) << 16) | (view.getUint8(offset + 1) << 8) | view.getUint8(offset + 2);
+    reader.offset += 3;
+    return value;
+}
+export function readByteReaderU32(reader) {
+    const value = reader.view.getUint32(reader.offset, true);
+    reader.offset += 4;
+    return value;
+}
+export function readByteReaderU32BigEndian(reader) {
+    const value = reader.view.getUint32(reader.offset, false);
+    reader.offset += 4;
+    return value;
+}
+export function readByteReaderU64(reader) {
+    const low = reader.view.getUint32(reader.offset, true);
+    const high = reader.view.getUint32(reader.offset + 4, true);
+    reader.offset += 8;
+    return high * 0x1_0000_0000 + low;
+}
+export function readByteReaderU8(reader) {
+    const value = reader.view.getUint8(reader.offset);
+    reader.offset += 1;
+    return value;
+}
+export function skipByteReader(reader, count) {
+    reader.offset += count;
+}
+//# sourceMappingURL=byteReader.js.map

package/dist/byteReader.js.map

@@ -0,0 +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"}

package/dist/detectTextureContainer.d.ts

@@ -0,0 +1,2 @@
+export declare function detectTextureContainer(bytes: Readonly<Uint8Array>): 'atf' | 'basis' | 'dds' | 'ktx2' | null;
+//# sourceMappingURL=detectTextureContainer.d.ts.map

package/dist/detectTextureContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectTextureContainer.d.ts","sourceRoot":"","sources":["../src/detectTextureContainer.ts"],"names":[],"mappings":"AAMA,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,CAW3G"}

package/dist/detectTextureContainer.js

@@ -0,0 +1,31 @@
+// Sniffs which GPU texture container a byte buffer holds from its magic bytes — `'ktx2'`, `'dds'`,
+// `'basis'`, `'atf'`, or `null` when the header is too short or unrecognized. The texture-container
+// sibling of `detectImageMimeType`: a cheap dispatcher to pick a `parse*` function without fully
+// parsing, and the single point of container identification in the SDK. `'atf'` alone maps to the
+// array-returning `parseAtf` (an ATF holds one-or-more peer encodings); the others map to a single
+// `parse*` returning one `TextureContainer`.
+export function detectTextureContainer(bytes) {
+    if (bytes.byteLength >= 12 && isKtx2Magic(bytes))
+        return 'ktx2';
+    // DDS: 'DDS ' (0x44 0x44 0x53 0x20)
+    if (bytes.byteLength >= 4 && bytes[0] === 0x44 && bytes[1] === 0x44 && bytes[2] === 0x53 && bytes[3] === 0x20) {
+        return 'dds';
+    }
+    // ATF: 'ATF' (0x41 0x54 0x46)
+    if (bytes.byteLength >= 3 && bytes[0] === 0x41 && bytes[1] === 0x54 && bytes[2] === 0x46)
+        return 'atf';
+    // Basis: m_sig 0x4273 little-endian ('s' then 'B')
+    if (bytes.byteLength >= 2 && bytes[0] === 0x73 && bytes[1] === 0x42)
+        return 'basis';
+    return null;
+}
+function isKtx2Magic(bytes) {
+    for (let i = 0; i < 12; i += 1) {
+        if (bytes[i] !== ktx2Magic[i])
+            return false;
+    }
+    return true;
+}
+// «KTX 20»\r\n\x1A\n
+const ktx2Magic = [0xab, 0x4b, 0x54, 0x58, 0x20, 0x32, 0x30, 0xbb, 0x0d, 0x0a, 0x1a, 0x0a];
+//# sourceMappingURL=detectTextureContainer.js.map

package/dist/detectTextureContainer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectTextureContainer.js","sourceRoot":"","sources":["../src/detectTextureContainer.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,oGAAoG;AACpG,iGAAiG;AACjG,kGAAkG;AAClG,mGAAmG;AACnG,6CAA6C;AAC7C,MAAM,UAAU,sBAAsB,CAAC,KAA2B;IAChE,IAAI,KAAK,CAAC,UAAU,IAAI,EAAE,IAAI,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAChE,oCAAoC;IACpC,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9G,OAAO,KAAK,CAAC;IACf,CAAC;IACD,8BAA8B;IAC9B,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACvG,mDAAmD;IACnD,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC;IACpF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,KAA2B;IAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qBAAqB;AACrB,MAAM,SAAS,GAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './detectTextureContainer';
+export * from './parseAtf';
+export * from './parseBasis';
+export * from './parseDds';
+export * from './parseKtx2';
+export * from './selectTextureContainer';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './detectTextureContainer';
+export * from './parseAtf';
+export * from './parseBasis';
+export * from './parseDds';
+export * from './parseKtx2';
+export * from './selectTextureContainer';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/parseAtf.d.ts

@@ -0,0 +1,3 @@
+import type { TextureContainer } from '@flighthq/types';
+export declare function parseAtf(bytes: Readonly<Uint8Array>): TextureContainer[] | null;
+//# sourceMappingURL=parseAtf.d.ts.map

package/dist/parseAtf.d.ts.map

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

package/dist/parseAtf.js

@@ -0,0 +1,139 @@
+import { createByteReader, hasByteReaderBytes, readByteReaderU24BigEndian, readByteReaderU32BigEndian, } from './byteReader';
+// Parses an ATF (Adobe Texture Format) container into an ARRAY of peer `TextureContainer`s, or returns
+// `null` if the bytes are not ATF, are truncated, or carry an unsupported ATF format code. ATF is the
+// Flash/Stage3D/AIR GPU-texture container (an OpenFL/Lime feature target). Unlike KTX2/DDS/Basis, a
+// single ATF embeds the SAME texture in several GPU encodings (DXT + ETC + PVRTC, and — from version 3 —
+// ETC2) so a Stage3D runtime picks the one its GPU supports at upload time. Flight expresses that
+// multiplicity as the return cardinality — a single-format ATF yields a 1-element array; a
+// cross-platform ATF yields N peer containers (no "primary"; use `selectTextureContainer` to pick one by
+// GPU support). Each element is a standard single-format `TextureContainer`; the descriptor shape is
+// unchanged from the other parsers.
+//
+// Container parse only: it locates each embedded encoding's format and per-level byte ranges. It never
+// decodes pixels. The block byte ranges are reported "as stored"; for a cube map the six sides of one
+// encoding become that encoding's container's `faces`.
+//
+// Header and block framing follow OpenFL's `ATFReader` (the ground-truth reader). The signature is
+// `'ATF'`. A versioned file follows the signature marker byte `0xFF` at offset 6 with a version byte and
+// a 32-bit big-endian payload length, putting the format header at offset 12; a legacy file (version 0)
+// has no marker and carries a 24-bit big-endian length, putting the format header at offset 6. The
+// format header is a type/format byte (bit 7 = cube-map flag, low 7 bits = ATF format code), then
+// `log2(width)`, `log2(height)`, and the mip count. Blocks then follow as `side → mip level → GPU
+// format`, each a big-endian length prefix (24-bit in a legacy file, 32-bit otherwise) followed by that
+// many bytes; a zero length marks an absent block. The GPU-format slot order is fixed —
+// 0 = DXT (`bc1`/`bc3`), 1 = ETC1, 2 = PVRTC 4bpp, and (version ≥ 3 only) 3 = ETC2 — so this parser
+// walks every slot for every (side, level) and groups the non-empty blocks by slot into one peer
+// `TextureContainer` each. Only the raw-compressed format codes are supported (2/3/12 opaque,
+// 4/5/13 with alpha); the raw-BGRA codes (0/1) and the JPEG-XR/LZMA-wrapped variants are unsupported and
+// return `null`.
+export function parseAtf(bytes) {
+    if (!hasAtfSignature(bytes))
+        return null;
+    const versioned = bytes[6] === atfNewVersionMarker;
+    const headerOffset = versioned ? atfNewHeaderOffset : atfLegacyHeaderOffset;
+    if (bytes.byteLength < headerOffset + 4)
+        return null;
+    // `version` selects the block-length width (u24 for the legacy version-0 layout, u32 otherwise) and
+    // whether an ETC2 slot follows the DXT/ETC1/PVRTC trio.
+    const version = versioned ? bytes[7] : 0;
+    // The declared payload runs from the format header to the end; reject a file that claims more than it
+    // carries before walking any block.
+    const lengthReader = createByteReader(bytes, versioned ? 8 : 3);
+    const payloadLength = versioned ? readByteReaderU32BigEndian(lengthReader) : readByteReaderU24BigEndian(lengthReader);
+    if (headerOffset + payloadLength > bytes.byteLength)
+        return null;
+    const typeFormatByte = bytes[headerOffset];
+    const log2Width = bytes[headerOffset + 1];
+    const log2Height = bytes[headerOffset + 2];
+    const mipCount = bytes[headerOffset + 3];
+    const formatCode = typeFormatByte & atfFormatCodeMask;
+    const alpha = atfAlphaFormatCodes.has(formatCode);
+    if (!alpha && !atfOpaqueFormatCodes.has(formatCode))
+        return null; // raw-BGRA / JPEG-XR / LZMA — unsupported
+    if (log2Width > atfMaxLog2Dimension || log2Height > atfMaxLog2Dimension)
+        return null;
+    if (mipCount < 1)
+        return null;
+    const cube = (typeFormatByte & atfCubeFlag) !== 0;
+    const faces = cube ? 6 : 1;
+    const width = 1 << log2Width;
+    const height = 1 << log2Height;
+    // Slot order is fixed by the format: DXT, ETC1, PVRTC, then ETC2 only from version 3 onward.
+    const slotFormats = alpha ? atfAlphaSlotFormats : atfOpaqueSlotFormats;
+    const slotCount = version < atfEtc2Version ? atfBaseSlotCount : atfBaseSlotCount + 1;
+    // One located-level list per GPU-format slot, filled in the file's `side → level` walk order (so each
+    // list is face-major, then mip). A slot with no non-empty block is not a real peer and is dropped.
+    const perSlotLevels = [];
+    for (let slot = 0; slot < slotCount; slot += 1)
+        perSlotLevels.push([]);
+    const reader = createByteReader(bytes, headerOffset + 4);
+    const lengthWidth = version === 0 ? 3 : 4;
+    for (let side = 0; side < faces; side += 1) {
+        for (let level = 0; level < mipCount; level += 1) {
+            for (let slot = 0; slot < slotCount; slot += 1) {
+                if (!hasByteReaderBytes(reader, lengthWidth))
+                    return null;
+                const blockLength = version === 0 ? readByteReaderU24BigEndian(reader) : readByteReaderU32BigEndian(reader);
+                if (!hasByteReaderBytes(reader, blockLength))
+                    return null;
+                if (blockLength === 0)
+                    continue; // absent encoding for this (side, level)
+                const byteOffset = reader.offset;
+                reader.offset += blockLength;
+                perSlotLevels[slot].push({
+                    byteLength: blockLength,
+                    byteOffset,
+                    height: Math.max(1, height >> level),
+                    width: Math.max(1, width >> level),
+                });
+            }
+        }
+    }
+    const containers = [];
+    for (let slot = 0; slot < slotCount; slot += 1) {
+        const levels = perSlotLevels[slot];
+        if (levels.length === 0)
+            continue;
+        containers.push({
+            depth: 1,
+            faces,
+            format: slotFormats[slot],
+            height,
+            layers: 1,
+            levels,
+            // The populated mip count, NOT the header's declared `mipCount`. png2atf "empty mipmaps"
+            // files declare the full chain (e.g. 9 for 256x256) but store only the base level; the empty
+            // levels are length-0 and skipped, so `levels` holds `faces * populatedMips` entries. Reporting
+            // the declared count would leave mipLevels inconsistent with levels.length.
+            mipLevels: levels.length / faces,
+            supercompression: 'None',
+            width,
+        });
+    }
+    if (containers.length === 0)
+        return null;
+    return containers;
+}
+function hasAtfSignature(bytes) {
+    // 'ATF' — 0x41 0x54 0x46. Seven bytes is the shortest header that can carry the version marker at 6.
+    return bytes.byteLength >= 7 && bytes[0] === 0x41 && bytes[1] === 0x54 && bytes[2] === 0x46;
+}
+const atfCubeFlag = 0x80;
+const atfFormatCodeMask = 0x7f;
+const atfLegacyHeaderOffset = 6;
+const atfNewHeaderOffset = 12;
+const atfNewVersionMarker = 0xff;
+// 2^13 = 8192 is beyond any Stage3D texture; a larger shift signals a corrupt log2 dimension byte.
+const atfMaxLog2Dimension = 13;
+// Version 3 introduced the fourth (ETC2) GPU-format slot after the DXT/ETC1/PVRTC trio.
+const atfEtc2Version = 3;
+const atfBaseSlotCount = 3;
+// The supported ATF format codes. Opaque codes carry a DXT1 (`bc1`) slot; alpha codes carry DXT5
+// (`bc3`). The raw-BGRA codes 0/1 and the JPEG-XR/LZMA-wrapped variants are not supported.
+const atfOpaqueFormatCodes = new Set([2, 3, 12]);
+const atfAlphaFormatCodes = new Set([4, 5, 13]);
+// GPU-format slot order (index = slot): DXT, ETC1, PVRTC 4bpp, ETC2. Sliced to `slotCount` so a
+// version-0/1/2 file exposes only the first three.
+const atfOpaqueSlotFormats = ['bc1', 'etc1', 'pvrtc4bppRgb', 'etc2Rgb'];
+const atfAlphaSlotFormats = ['bc3', 'etc1', 'pvrtc4bppRgba', 'etc2Rgba'];
+//# sourceMappingURL=parseAtf.js.map

package/dist/parseAtf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseAtf.js","sourceRoot":"","sources":["../src/parseAtf.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAEtB,uGAAuG;AACvG,sGAAsG;AACtG,oGAAoG;AACpG,yGAAyG;AACzG,kGAAkG;AAClG,2FAA2F;AAC3F,yGAAyG;AACzG,qGAAqG;AACrG,oCAAoC;AACpC,EAAE;AACF,uGAAuG;AACvG,sGAAsG;AACtG,uDAAuD;AACvD,EAAE;AACF,mGAAmG;AACnG,yGAAyG;AACzG,wGAAwG;AACxG,mGAAmG;AACnG,kGAAkG;AAClG,kGAAkG;AAClG,wGAAwG;AACxG,wFAAwF;AACxF,oGAAoG;AACpG,iGAAiG;AACjG,8FAA8F;AAC9F,yGAAyG;AACzG,iBAAiB;AACjB,MAAM,UAAU,QAAQ,CAAC,KAA2B;IAClD,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,mBAAmB,CAAC;IACnD,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,qBAAqB,CAAC;IAC5E,IAAI,KAAK,CAAC,UAAU,GAAG,YAAY,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAErD,oGAAoG;IACpG,wDAAwD;IACxD,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzC,sGAAsG;IACtG,oCAAoC;IACpC,MAAM,YAAY,GAAG,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,MAAM,aAAa,GAAG,SAAS,CAAC,CAAC,CAAC,0BAA0B,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,YAAY,CAAC,CAAC;IACtH,IAAI,YAAY,GAAG,aAAa,GAAG,KAAK,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAEjE,MAAM,cAAc,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;IAEzC,MAAM,UAAU,GAAG,cAAc,GAAG,iBAAiB,CAAC;IACtD,MAAM,KAAK,GAAG,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,0CAA0C;IAC5G,IAAI,SAAS,GAAG,mBAAmB,IAAI,UAAU,GAAG,mBAAmB;QAAE,OAAO,IAAI,CAAC;IACrF,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9B,MAAM,IAAI,GAAG,CAAC,cAAc,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,IAAI,SAAS,CAAC;IAC7B,MAAM,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC;IAE/B,6FAA6F;IAC7F,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,oBAAoB,CAAC;IACvE,MAAM,SAAS,GAAG,OAAO,GAAG,cAAc,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC;IAErF,sGAAsG;IACtG,mGAAmG;IACnG,MAAM,aAAa,GAA8B,EAAE,CAAC;IACpD,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,EAAE,IAAI,IAAI,CAAC;QAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEvE,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAC3C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACjD,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;gBAC/C,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC;oBAAE,OAAO,IAAI,CAAC;gBAC1D,MAAM,WAAW,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC;gBAC5G,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC;oBAAE,OAAO,IAAI,CAAC;gBAC1D,IAAI,WAAW,KAAK,CAAC;oBAAE,SAAS,CAAC,yCAAyC;gBAC1E,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;gBACjC,MAAM,CAAC,MAAM,IAAI,WAAW,CAAC;gBAC7B,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;oBACvB,UAAU,EAAE,WAAW;oBACvB,UAAU;oBACV,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,IAAI,KAAK,CAAC;oBACpC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,IAAI,KAAK,CAAC;iBACnC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAuB,EAAE,CAAC;IAC1C,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAClC,UAAU,CAAC,IAAI,CAAC;YACd,KAAK,EAAE,CAAC;YACR,KAAK;YACL,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC;YACzB,MAAM;YACN,MAAM,EAAE,CAAC;YACT,MAAM;YACN,yFAAyF;YACzF,6FAA6F;YAC7F,gGAAgG;YAChG,4EAA4E;YAC5E,SAAS,EAAE,MAAM,CAAC,MAAM,GAAG,KAAK;YAChC,gBAAgB,EAAE,MAAM;YACxB,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,eAAe,CAAC,KAA2B;IAClD,qGAAqG;IACrG,OAAO,KAAK,CAAC,UAAU,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAC9F,CAAC;AAED,MAAM,WAAW,GAAG,IAAI,CAAC;AACzB,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAChC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAC9B,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACjC,mGAAmG;AACnG,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAC/B,wFAAwF;AACxF,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAE3B,iGAAiG;AACjG,2FAA2F;AAC3F,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AACtE,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAErE,gGAAgG;AAChG,mDAAmD;AACnD,MAAM,oBAAoB,GAAsC,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;AAC3G,MAAM,mBAAmB,GAAsC,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC"}

package/dist/parseBasis.d.ts

@@ -0,0 +1,3 @@
+import type { TextureContainer } from '@flighthq/types';
+export declare function parseBasis(bytes: Readonly<Uint8Array>): TextureContainer | null;
+//# sourceMappingURL=parseBasis.d.ts.map

package/dist/parseBasis.d.ts.map

@@ -0,0 +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"}

package/dist/parseBasis.js

@@ -0,0 +1,82 @@
+import { createByteReader, hasByteReaderBytes, readByteReaderU16, 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.
+//
+// Reads the `basis_file_header` (`m_total_slices`, `m_total_images`, `m_tex_format` — ETC1S or UASTC —
+// and `m_slice_desc_file_ofs`) and each `basis_slice_desc` (`m_level_index`, `m_orig_width/height`,
+// `m_file_ofs`, `m_file_size`). Every slice becomes one `TextureContainerLevel` in slice-table order;
+// `mipLevels` is the max `level_index` + 1 and `layers` is `m_total_images`. The payload is left
+// 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).
+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)
+    if (format === undefined)
+        return null;
+    if (totalSlices === 0)
+        return null;
+    const sliceDescReader = createByteReader(bytes, basisSliceDescOffsetField);
+    const sliceDescOffset = readByteReaderU32(sliceDescReader);
+    const table = createByteReader(bytes, sliceDescOffset);
+    if (!hasByteReaderBytes(table, totalSlices * basisSliceDescSize))
+        return null;
+    const levels = [];
+    let baseWidth = 0;
+    let baseHeight = 0;
+    let maxLevel = 0;
+    for (let slice = 0; slice < totalSlices; slice += 1) {
+        const imageIndex = readByteReaderU16(table);
+        const levelIndex = readByteReaderU8(table);
+        readByteReaderU8(table); // m_flags
+        const width = readByteReaderU16(table);
+        const height = readByteReaderU16(table);
+        readByteReaderU16(table); // m_num_blocks_x
+        readByteReaderU16(table); // m_num_blocks_y
+        const byteOffset = readByteReaderU32(table);
+        const byteLength = readByteReaderU32(table);
+        readByteReaderU16(table); // m_slice_data_crc16
+        if (byteOffset + byteLength > bytes.byteLength)
+            return null;
+        if (imageIndex === 0 && levelIndex === 0) {
+            baseWidth = width;
+            baseHeight = height;
+        }
+        if (levelIndex + 1 > maxLevel)
+            maxLevel = levelIndex + 1;
+        levels.push({ byteLength, byteOffset, height, width });
+    }
+    return {
+        depth: 1,
+        faces: 1,
+        format,
+        height: baseHeight || (levels[0]?.height ?? 0),
+        layers: Math.max(1, totalImages),
+        levels,
+        mipLevels: Math.max(1, maxLevel),
+        supercompression: 'None',
+        width: baseWidth || (levels[0]?.width ?? 0),
+    };
+}
+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 basisTexFormat = {
+    0: 'etc1s',
+    1: 'uastc',
+};
+//# sourceMappingURL=parseBasis.js.map

package/dist/parseBasis.js.map

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

package/dist/parseDds.d.ts

@@ -0,0 +1,3 @@
+import type { TextureContainer } from '@flighthq/types';
+export declare function parseDds(bytes: Readonly<Uint8Array>): TextureContainer | null;
+//# sourceMappingURL=parseDds.d.ts.map

package/dist/parseDds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseDds.d.ts","sourceRoot":"","sources":["../src/parseDds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAiBxD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,gBAAgB,GAAG,IAAI,CAsE7E"}

package/dist/parseDds.js

@@ -0,0 +1,151 @@
+import { createByteReader, hasByteReaderBytes, readByteReaderU32, skipByteReader } from './byteReader';
+import { computeTextureContainerLevels } from './textureLevelLayout';
+// Parses a DDS container (DirectDraw Surface) into a `TextureContainer`, or returns `null` if the bytes
+// are not DDS, are truncated, or carry a pixel format this package does not map (e.g. a legacy 16/24-bit
+// layout, a YUV/luminance format, or a volume texture).
+//
+// Reads the `DDS_HEADER` (`dwHeight`/`dwWidth`/`dwMipMapCount`, the `DDS_PIXELFORMAT` FourCC, and
+// `dwCaps2` for cubemaps) and, when the FourCC is `DX10`, the `DDS_HEADER_DXT10` extension
+// (`dxgiFormat`, `miscFlag` for cube, `arraySize`). The format comes from the DXGI code, the FourCC
+// (DXT1-5 / ATI1/2 / BC4-5 / DX9 float codes), or the RGBA channel masks for uncompressed data. DDS
+// carries no level index, so every mip's byte range is computed from the block size (see
+// `computeTextureContainerLevels`): sub-images are nested layer → face → mip, matching D3D subresource
+// order (a cubemap's 6 faces each hold a full mip chain).
+export function parseDds(bytes) {
+    if (!hasDdsMagic(bytes))
+        return null;
+    if (bytes.byteLength < ddsDataOffset)
+        return null;
+    const reader = createByteReader(bytes, 4);
+    skipByteReader(reader, 4); // dwSize
+    skipByteReader(reader, 4); // dwFlags
+    const dwHeight = readByteReaderU32(reader);
+    const dwWidth = readByteReaderU32(reader);
+    skipByteReader(reader, 4); // dwPitchOrLinearSize
+    const dwDepth = readByteReaderU32(reader);
+    const dwMipMapCount = readByteReaderU32(reader);
+    reader.offset = 80; // DDS_PIXELFORMAT.dwFlags
+    const pfFlags = readByteReaderU32(reader);
+    const fourCC = readByteReaderU32(reader);
+    const rgbBitCount = readByteReaderU32(reader);
+    const rMask = readByteReaderU32(reader);
+    const gMask = readByteReaderU32(reader);
+    const bMask = readByteReaderU32(reader);
+    const aMask = readByteReaderU32(reader);
+    reader.offset = 112; // dwCaps2
+    const caps2 = readByteReaderU32(reader);
+    if ((caps2 & ddsCaps2Volume) !== 0 || dwDepth > 1)
+        return null; // volume textures not modeled yet
+    let format;
+    let cube = (caps2 & ddsCaps2Cubemap) !== 0;
+    let layers = 1;
+    let dataOffset = ddsDataOffset;
+    if ((pfFlags & ddsPfFourCC) !== 0 && fourCC === ddsFourCcDx10) {
+        if (!hasByteReaderBytes(createByteReader(bytes, ddsDataOffset), 20))
+            return null;
+        const dx10 = createByteReader(bytes, ddsDataOffset);
+        const dxgiFormat = readByteReaderU32(dx10);
+        skipByteReader(dx10, 4); // resourceDimension
+        const miscFlag = readByteReaderU32(dx10);
+        const arraySize = readByteReaderU32(dx10);
+        format = ddsDxgiFormat[dxgiFormat] ?? null;
+        cube = cube || (miscFlag & ddsDx10MiscCube) !== 0;
+        layers = Math.max(1, arraySize);
+        dataOffset = ddsDataOffset + 20;
+    }
+    else if ((pfFlags & ddsPfFourCC) !== 0) {
+        format = ddsFourCcFormat[fourCC] ?? null;
+    }
+    else if ((pfFlags & ddsPfRgb) !== 0) {
+        format = mapDdsUncompressed(rgbBitCount, rMask, gMask, bMask, aMask);
+    }
+    else {
+        format = null;
+    }
+    if (format === null)
+        return null;
+    const width = Math.max(1, dwWidth);
+    const height = Math.max(1, dwHeight);
+    const faces = cube ? 6 : 1;
+    const mipLevels = Math.max(1, dwMipMapCount);
+    const layout = computeTextureContainerLevels(format, width, height, mipLevels, layers, faces, dataOffset);
+    if (layout === null || layout.endOffset > bytes.byteLength)
+        return null;
+    return {
+        depth: 1,
+        faces,
+        format,
+        height,
+        layers,
+        levels: layout.levels,
+        mipLevels,
+        supercompression: 'None',
+        width,
+    };
+}
+function hasDdsMagic(bytes) {
+    return bytes.byteLength >= 4 && bytes[0] === 0x44 && bytes[1] === 0x44 && bytes[2] === 0x53 && bytes[3] === 0x20;
+}
+function mapDdsUncompressed(rgbBitCount, rMask, gMask, bMask, aMask) {
+    if (rgbBitCount !== 32)
+        return null;
+    if (rMask === 0x00ff0000 && gMask === 0x0000ff00 && bMask === 0x000000ff && aMask === 0xff000000) {
+        return 'bgra8unorm';
+    }
+    if (rMask === 0x000000ff && gMask === 0x0000ff00 && bMask === 0x00ff0000 && aMask === 0xff000000) {
+        return 'rgba8unorm';
+    }
+    return null;
+}
+// 4 (magic) + 124 (DDS_HEADER). A DX10 file adds a 20-byte DDS_HEADER_DXT10 after this.
+const ddsDataOffset = 128;
+const ddsCaps2Cubemap = 0x200;
+const ddsCaps2Volume = 0x20_0000;
+const ddsDx10MiscCube = 0x4;
+const ddsFourCcDx10 = 0x3031_5844; // 'DX10'
+const ddsPfFourCC = 0x4;
+const ddsPfRgb = 0x40;
+// DXGI_FORMAT → `TextureContainerFormat`. The BC set (with sRGB twins), 8-bit RGBA/BGRA, and the two
+// standard float formats. `_TYPELESS` and unmapped codes → `null`.
+const ddsDxgiFormat = {
+    2: 'rgba32f',
+    10: 'rgba16f',
+    28: 'rgba8unorm',
+    29: 'rgba8Srgb',
+    49: 'rg8unorm',
+    61: 'r8unorm',
+    71: 'bc1',
+    72: 'bc1Srgb',
+    74: 'bc2',
+    75: 'bc2Srgb',
+    77: 'bc3',
+    78: 'bc3Srgb',
+    80: 'bc4',
+    81: 'bc4Snorm',
+    83: 'bc5',
+    84: 'bc5Snorm',
+    87: 'bgra8unorm',
+    91: 'bgra8Srgb',
+    95: 'bc6hUfloat',
+    96: 'bc6hSfloat',
+    98: 'bc7',
+    99: 'bc7Srgb',
+};
+// DDS_PIXELFORMAT.dwFourCC → format. Includes the DXT1-5 / ATI1-2 / BC4-5 block codes and the DX9
+// D3DFMT float codes (113 = A16B16G16R16F, 116 = A32B32G32R32F) some tools store in the FourCC slot.
+const ddsFourCcFormat = {
+    113: 'rgba16f',
+    116: 'rgba32f',
+    0x3154_5844: 'bc1', // DXT1
+    0x3254_5844: 'bc2', // DXT2
+    0x3354_5844: 'bc2', // DXT3
+    0x3454_5844: 'bc3', // DXT4
+    0x3554_5844: 'bc3', // DXT5
+    0x3149_5441: 'bc4', // ATI1
+    0x5534_4342: 'bc4', // BC4U
+    0x5334_4342: 'bc4Snorm', // BC4S
+    0x3249_5441: 'bc5', // ATI2
+    0x5535_4342: 'bc5', // BC5U
+    0x5335_4342: 'bc5Snorm', // BC5S
+};
+//# sourceMappingURL=parseDds.js.map

package/dist/parseDds.js.map

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

package/dist/parseKtx2.d.ts

@@ -0,0 +1,3 @@
+import type { TextureContainer } from '@flighthq/types';
+export declare function parseKtx2(bytes: Readonly<Uint8Array>): TextureContainer | null;
+//# sourceMappingURL=parseKtx2.d.ts.map

package/dist/parseKtx2.d.ts.map

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