@bis-toolkit/edds 1.0.0

package/README.md

@@ -0,0 +1,49 @@
+````markdown
+# @bis-toolkit/edds
+
+Library for reading EDDS (DayZ compressed DDS) files and obtaining RGBA pixel data for previews or further processing.
+
+Part of the [BIS Toolkit TypeScript](../../README.md) monorepo.
+
+## Features
+
+- Parse EDDS containers (DDS header + LZ4/COPY mip blocks)
+- Validate headers and mip sizes
+- Decode BC1/BC2/BC3 and RGBA/BGRA mipmaps to RGBA buffers
+- Small, dependency-light build (custom LZ4 block decoder)
+- Works in Node.js and browsers (ESM build bundled for the demo)
+
+## Install
+
+```bash
+npm install @bis-toolkit/edds
+```
+
+## Quick Start
+
+```typescript
+import { Edds } from '@bis-toolkit/edds';
+import * as fs from 'fs';
+
+const buffer = fs.readFileSync('texture.edds');
+const edds = new Edds();
+edds.read(buffer);
+
+console.log(`Format: ${edds.formatName}`);
+console.log(`Mipmaps: ${edds.mipmaps.length}`);
+
+// Get RGBA pixels for the top mip level
+const rgba = edds.getRgbaPixelData(0);
+console.log(`First pixel RGBA: ${Array.from(rgba.slice(0, 4))}`);
+```
+
+### Supported output formats
+
+- BC1 / DXT1 -> RGBA
+- BC2 / DXT3/2 -> RGBA
+- BC3 / DXT5/4 -> RGBA
+- RGBA8 / BGRA8 -> RGBA
+
+## LICENSE
+
+GPLv3 © Alpine Labs - see [LICENSE](LICENSE).

package/dist/Edds.d.ts

@@ -0,0 +1,17 @@
+export type EddsFormat = 'BC1' | 'BC2' | 'BC3' | 'BC4' | 'BC5' | 'BC6' | 'BC7' | 'RGBA8' | 'BGRA8' | 'UNKNOWN';
+export interface EddsMipMap {
+    width: number;
+    height: number;
+    data: Uint8Array;
+    compression?: 'COPY' | 'LZ4';
+}
+export declare class Edds {
+    width: number;
+    height: number;
+    format: EddsFormat;
+    formatDetails: string;
+    mipmaps: EddsMipMap[];
+    read(buffer: Buffer | Uint8Array): void;
+    getRgbaPixelData(mipLevel?: number): Uint8Array;
+    get formatName(): string;
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * EDDS (compressed DDS) reader with RGBA output
+ */
+export { Edds, type EddsFormat, type EddsMipMap } from './Edds';