universal-game-modder 0.1.4

package/dist/core/router.js.map

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

package/dist/core/session.js

@@ -0,0 +1,114 @@
+import { eventBus } from './event-bus.js';
+class GameSession {
+    state;
+    constructor() {
+        this.state = this.createEmptyState();
+    }
+    createEmptyState() {
+        return {
+            gamePath: null,
+            gameName: null,
+            engine: null,
+            engineVersion: null,
+            runtime: null,
+            loadedAssemblies: [],
+            loadedUnrealGame: null,
+            openJarSessions: [],
+            discoveredTypes: new Map(),
+            discoveredValues: new Map(),
+            decompilationCache: new Map(),
+            modFramework: null,
+            modProjectPath: null,
+            lastBuildResult: null,
+            deployPath: null,
+            toolCallHistory: [],
+        };
+    }
+    getState() {
+        return this.state;
+    }
+    getSerializableState() {
+        return {
+            gamePath: this.state.gamePath,
+            gameName: this.state.gameName,
+            engine: this.state.engine,
+            engineVersion: this.state.engineVersion,
+            runtime: this.state.runtime,
+            loadedAssemblies: this.state.loadedAssemblies,
+            loadedUnrealGame: this.state.loadedUnrealGame,
+            openJarSessions: this.state.openJarSessions,
+            discoveredTypesCount: this.state.discoveredTypes.size,
+            discoveredValuesCount: this.state.discoveredValues.size,
+            decompilationCacheSize: this.state.decompilationCache.size,
+            modFramework: this.state.modFramework,
+            modProjectPath: this.state.modProjectPath,
+            lastBuildResult: this.state.lastBuildResult,
+            deployPath: this.state.deployPath,
+            toolCallCount: this.state.toolCallHistory.length,
+            recentToolCalls: this.state.toolCallHistory.slice(-20),
+        };
+    }
+    setGame(gamePath, gameName, engine, runtime) {
+        this.state.gamePath = gamePath;
+        this.state.gameName = gameName;
+        this.state.engine = engine;
+        this.state.runtime = runtime;
+        eventBus.emit('session:updated', {
+            gamePath,
+            gameName,
+            engine,
+            runtime,
+        });
+    }
+    addAssembly(key, path, typeCount) {
+        const existing = this.state.loadedAssemblies.find(a => a.key === key);
+        if (existing) {
+            existing.typeCount = typeCount;
+        }
+        else {
+            this.state.loadedAssemblies.push({ key, path, typeCount });
+        }
+    }
+    cacheType(name, info) {
+        this.state.discoveredTypes.set(name, info);
+    }
+    cacheValue(key, info) {
+        this.state.discoveredValues.set(key, info);
+    }
+    cacheDecompilation(typeKey, source) {
+        this.state.decompilationCache.set(typeKey, source);
+    }
+    getCachedDecompilation(typeKey) {
+        return this.state.decompilationCache.get(typeKey);
+    }
+    recordToolCall(record) {
+        this.state.toolCallHistory.push(record);
+        // Keep last 500 entries
+        if (this.state.toolCallHistory.length > 500) {
+            this.state.toolCallHistory = this.state.toolCallHistory.slice(-500);
+        }
+    }
+    setModFramework(framework) {
+        this.state.modFramework = framework;
+    }
+    setBuildResult(result) {
+        this.state.lastBuildResult = result;
+    }
+    setDeployPath(path) {
+        this.state.deployPath = path;
+    }
+    setModProjectPath(path) {
+        this.state.modProjectPath = path;
+    }
+    reset() {
+        this.state = this.createEmptyState();
+        eventBus.emit('session:updated', {
+            gamePath: null,
+            gameName: null,
+            engine: null,
+            runtime: null,
+        });
+    }
+}
+export const session = new GameSession();
+//# sourceMappingURL=session.js.map

package/dist/decoders/audio-export.js

@@ -0,0 +1,57 @@
+/**
+ * audio-export.ts — turn Unity AudioClip stream bytes into a playable file.
+ *
+ * No codec library is needed for the two formats Baldi uses (verified by recon):
+ *   - PCM  : the stream bytes are raw little-endian samples; we prepend a 44-byte WAV header.
+ *   - Vorbis: Unity stores the bytes as a COMPLETE Ogg-Vorbis stream; we write them verbatim as .ogg.
+ *
+ * Other formats (ADPCM, MP3, etc.) are not handled here — the caller checks compressionFormat
+ * and records a noted decoded=0 row rather than producing a broken file.
+ */
+import { AudioCompressionFormat } from './unity/audioclip.js';
+/** Build a canonical 44-byte WAV (RIFF/PCM) header for the given format + data length. */
+function wavHeader(channels, sampleRate, bitsPerSample, dataLen) {
+    const h = Buffer.alloc(44);
+    const byteRate = (sampleRate * channels * bitsPerSample) / 8;
+    const blockAlign = (channels * bitsPerSample) / 8;
+    h.write('RIFF', 0, 'ascii');
+    h.writeUInt32LE(36 + dataLen, 4); // ChunkSize
+    h.write('WAVE', 8, 'ascii');
+    h.write('fmt ', 12, 'ascii');
+    h.writeUInt32LE(16, 16); // Subchunk1Size (PCM)
+    h.writeUInt16LE(1, 20); // AudioFormat = 1 (PCM)
+    h.writeUInt16LE(channels, 22);
+    h.writeUInt32LE(sampleRate, 24);
+    h.writeUInt32LE(byteRate, 28);
+    h.writeUInt16LE(blockAlign, 32);
+    h.writeUInt16LE(bitsPerSample, 34);
+    h.write('data', 36, 'ascii');
+    h.writeUInt32LE(dataLen, 40); // Subchunk2Size
+    return h;
+}
+/**
+ * Export an AudioClip's stream bytes. Returns null (caller notes it) for an unsupported
+ * compression format. `streamBytes` is what the .resource reader returned at offset/size.
+ */
+export function exportAudio(clip, streamBytes) {
+    switch (clip.compressionFormat) {
+        case AudioCompressionFormat.PCM: {
+            const bits = clip.bitsPerSample > 0 ? clip.bitsPerSample : 16;
+            const header = wavHeader(clip.channels, clip.frequency, bits, streamBytes.length);
+            return { ext: 'wav', bytes: Buffer.concat([header, streamBytes]) };
+        }
+        case AudioCompressionFormat.Vorbis: {
+            // Unity's Vorbis payload is a complete Ogg stream — write verbatim.
+            // Sanity: a real Ogg stream begins with the "OggS" capture pattern.
+            if (streamBytes.length >= 4 && streamBytes.toString('ascii', 0, 4) === 'OggS') {
+                return { ext: 'ogg', bytes: streamBytes };
+            }
+            // Some Unity builds wrap Vorbis with an FSB5 header before the Ogg pages; if we don't
+            // see OggS we cannot safely passthrough — let the caller note it rather than emit garbage.
+            return null;
+        }
+        default:
+            return null; // ADPCM / MP3 / etc. — unsupported in this slice
+    }
+}
+//# sourceMappingURL=audio-export.js.map

package/dist/decoders/mesh-export.d.ts

@@ -0,0 +1,20 @@
+/**
+ * mesh-export.ts — turn a ParsedMesh into a standard 3D file.
+ *
+ * Two outputs, both hand-rolled (no native dep — same clean-install rule as the rest):
+ *   - glTF binary (.glb): the primary, modern format. A glb is a tiny binary container:
+ *       12-byte header + a JSON chunk (the glTF document) + a BIN chunk (the raw buffers).
+ *     We emit one mesh, one primitive, with POSITION/NORMAL/TEXCOORD_0 accessors and an
+ *     indices accessor. This loads in Blender, three.js, Windows 3D Viewer, etc.
+ *   - Wavefront OBJ (.obj): a dead-simple text fallback (v / vn / vt / f lines). No deps,
+ *     universally readable, lossy on anything fancy but perfect for a geometry sanity check.
+ *
+ * The glb writer is intentionally minimal and spec-correct for the single-mesh case; it is
+ * not a general glTF library. Coordinates are written as-is (Unity's left-handed Y-up) — a
+ * handedness flip is a downstream concern we note rather than silently apply.
+ */
+import type { ParsedMesh } from './unity/mesh.js';
+/** Export a parsed mesh to a .glb byte buffer. Throws if there are no positions. */
+export declare function exportGlb(mesh: ParsedMesh): Buffer;
+/** Export a parsed mesh to Wavefront OBJ text. Simple, lossless on geometry, no deps. */
+export declare function exportObj(mesh: ParsedMesh): Buffer;

package/dist/decoders/mesh-export.js

@@ -0,0 +1,174 @@
+/**
+ * mesh-export.ts — turn a ParsedMesh into a standard 3D file.
+ *
+ * Two outputs, both hand-rolled (no native dep — same clean-install rule as the rest):
+ *   - glTF binary (.glb): the primary, modern format. A glb is a tiny binary container:
+ *       12-byte header + a JSON chunk (the glTF document) + a BIN chunk (the raw buffers).
+ *     We emit one mesh, one primitive, with POSITION/NORMAL/TEXCOORD_0 accessors and an
+ *     indices accessor. This loads in Blender, three.js, Windows 3D Viewer, etc.
+ *   - Wavefront OBJ (.obj): a dead-simple text fallback (v / vn / vt / f lines). No deps,
+ *     universally readable, lossy on anything fancy but perfect for a geometry sanity check.
+ *
+ * The glb writer is intentionally minimal and spec-correct for the single-mesh case; it is
+ * not a general glTF library. Coordinates are written as-is (Unity's left-handed Y-up) — a
+ * handedness flip is a downstream concern we note rather than silently apply.
+ */
+const GLB_MAGIC = 0x46546c67; // "glTF"
+const GLB_VERSION = 2;
+const CHUNK_JSON = 0x4e4f534a; // "JSON"
+const CHUNK_BIN = 0x004e4942; // "BIN\0"
+const COMPONENT_FLOAT = 5126;
+const COMPONENT_UINT = 5125;
+const TARGET_ARRAY_BUFFER = 34962;
+const TARGET_ELEMENT_ARRAY_BUFFER = 34963;
+function pad4(n) {
+    return (4 - (n % 4)) % 4;
+}
+/** Min/max per component, for the glTF accessor (required on POSITION). */
+function minMax(arr, dim) {
+    const min = new Array(dim).fill(Infinity);
+    const max = new Array(dim).fill(-Infinity);
+    for (let i = 0; i < arr.length; i += dim) {
+        for (let c = 0; c < dim; c++) {
+            const v = arr[i + c];
+            if (v < min[c])
+                min[c] = v;
+            if (v > max[c])
+                max[c] = v;
+        }
+    }
+    return { min, max };
+}
+/** Export a parsed mesh to a .glb byte buffer. Throws if there are no positions. */
+export function exportGlb(mesh) {
+    if (!mesh.positions || mesh.vertexCount === 0) {
+        throw new Error(`exportGlb("${mesh.name}"): no positions to export`);
+    }
+    // Build the BIN buffer: positions, [normals], [uvs], indices — each 4-byte aligned.
+    const parts = [];
+    let binLength = 0;
+    const pushFloat = (arr) => {
+        const b = Buffer.from(arr.buffer, arr.byteOffset, arr.byteLength);
+        const byteOffset = binLength;
+        parts.push({ data: b, byteOffset, byteLength: b.length });
+        binLength += b.length + pad4(b.length);
+        return byteOffset;
+    };
+    const posOffset = pushFloat(mesh.positions);
+    const normOffset = mesh.normals ? pushFloat(mesh.normals) : -1;
+    const uvOffset = mesh.uvs ? pushFloat(mesh.uvs) : -1;
+    // indices as uint32
+    const idxBuf = Buffer.from(mesh.indices.buffer, mesh.indices.byteOffset, mesh.indices.byteLength);
+    const idxOffset = binLength;
+    parts.push({ data: idxBuf, byteOffset: idxOffset, byteLength: idxBuf.length });
+    binLength += idxBuf.length + pad4(idxBuf.length);
+    const bin = Buffer.alloc(binLength);
+    for (const part of parts)
+        part.data.copy(bin, part.byteOffset);
+    // Accessors + bufferViews.
+    const posMM = minMax(mesh.positions, 3);
+    const bufferViews = [];
+    const accessors = [];
+    const addView = (byteOffset, byteLength, target) => {
+        bufferViews.push({ buffer: 0, byteOffset, byteLength, target });
+        return bufferViews.length - 1;
+    };
+    const addAccessor = (a) => {
+        accessors.push(a);
+        return accessors.length - 1;
+    };
+    const posView = addView(posOffset, mesh.positions.byteLength, TARGET_ARRAY_BUFFER);
+    const posAcc = addAccessor({
+        bufferView: posView,
+        componentType: COMPONENT_FLOAT,
+        count: mesh.vertexCount,
+        type: 'VEC3',
+        min: posMM.min,
+        max: posMM.max,
+    });
+    const attributes = { POSITION: posAcc };
+    if (mesh.normals && normOffset >= 0) {
+        const v = addView(normOffset, mesh.normals.byteLength, TARGET_ARRAY_BUFFER);
+        attributes.NORMAL = addAccessor({ bufferView: v, componentType: COMPONENT_FLOAT, count: mesh.vertexCount, type: 'VEC3' });
+    }
+    if (mesh.uvs && uvOffset >= 0) {
+        const v = addView(uvOffset, mesh.uvs.byteLength, TARGET_ARRAY_BUFFER);
+        attributes.TEXCOORD_0 = addAccessor({ bufferView: v, componentType: COMPONENT_FLOAT, count: mesh.vertexCount, type: 'VEC2' });
+    }
+    const idxView = addView(idxOffset, idxBuf.length, TARGET_ELEMENT_ARRAY_BUFFER);
+    const idxAcc = addAccessor({
+        bufferView: idxView,
+        componentType: COMPONENT_UINT,
+        count: mesh.indices.length,
+        type: 'SCALAR',
+    });
+    const gltf = {
+        asset: { version: '2.0', generator: 'autopsy-engine/decode_assets' },
+        buffers: [{ byteLength: binLength }],
+        bufferViews,
+        accessors,
+        meshes: [{ name: mesh.name, primitives: [{ attributes, indices: idxAcc, mode: 4 /* TRIANGLES */ }] }],
+        nodes: [{ name: mesh.name, mesh: 0 }],
+        scenes: [{ nodes: [0] }],
+        scene: 0,
+    };
+    let jsonStr = JSON.stringify(gltf);
+    // JSON chunk must be 4-byte aligned, padded with spaces.
+    const jsonPad = pad4(Buffer.byteLength(jsonStr, 'utf8'));
+    jsonStr += ' '.repeat(jsonPad);
+    const jsonBuf = Buffer.from(jsonStr, 'utf8');
+    // BIN chunk padded with zeros (already aligned via binLength).
+    const totalLength = 12 + 8 + jsonBuf.length + 8 + bin.length;
+    const out = Buffer.alloc(totalLength);
+    let o = 0;
+    out.writeUInt32LE(GLB_MAGIC, o);
+    o += 4;
+    out.writeUInt32LE(GLB_VERSION, o);
+    o += 4;
+    out.writeUInt32LE(totalLength, o);
+    o += 4;
+    out.writeUInt32LE(jsonBuf.length, o);
+    o += 4;
+    out.writeUInt32LE(CHUNK_JSON, o);
+    o += 4;
+    jsonBuf.copy(out, o);
+    o += jsonBuf.length;
+    out.writeUInt32LE(bin.length, o);
+    o += 4;
+    out.writeUInt32LE(CHUNK_BIN, o);
+    o += 4;
+    bin.copy(out, o);
+    o += bin.length;
+    return out;
+}
+/** Export a parsed mesh to Wavefront OBJ text. Simple, lossless on geometry, no deps. */
+export function exportObj(mesh) {
+    if (!mesh.positions || mesh.vertexCount === 0) {
+        throw new Error(`exportObj("${mesh.name}"): no positions to export`);
+    }
+    const lines = [`# ${mesh.name} — exported by autopsy-engine/decode_assets`, `o ${mesh.name}`];
+    for (let i = 0; i < mesh.vertexCount; i++) {
+        lines.push(`v ${mesh.positions[i * 3]} ${mesh.positions[i * 3 + 1]} ${mesh.positions[i * 3 + 2]}`);
+    }
+    if (mesh.normals) {
+        for (let i = 0; i < mesh.vertexCount; i++) {
+            lines.push(`vn ${mesh.normals[i * 3]} ${mesh.normals[i * 3 + 1]} ${mesh.normals[i * 3 + 2]}`);
+        }
+    }
+    if (mesh.uvs) {
+        for (let i = 0; i < mesh.vertexCount; i++) {
+            lines.push(`vt ${mesh.uvs[i * 2]} ${mesh.uvs[i * 2 + 1]}`);
+        }
+    }
+    const hasN = !!mesh.normals;
+    const hasUV = !!mesh.uvs;
+    for (let i = 0; i + 2 < mesh.indices.length; i += 3) {
+        const a = mesh.indices[i] + 1;
+        const b = mesh.indices[i + 1] + 1;
+        const c = mesh.indices[i + 2] + 1;
+        const ref = (v) => (hasUV && hasN ? `${v}/${v}/${v}` : hasN ? `${v}//${v}` : hasUV ? `${v}/${v}` : `${v}`);
+        lines.push(`f ${ref(a)} ${ref(b)} ${ref(c)}`);
+    }
+    return Buffer.from(lines.join('\n') + '\n', 'utf8');
+}
+//# sourceMappingURL=mesh-export.js.map

package/dist/decoders/mesh-export.js.map

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

package/dist/decoders/native/disassembler.js

@@ -0,0 +1,85 @@
+/**
+ * disassembler.ts — PR-3.1 (V3 Native Comprehension): the disassembly binding.
+ *
+ * Wraps capstone-wasm (chosen 2026-07-01 by an evidence-based 3-way probe vs a
+ * real notepad.exe .text section — see .forge/pr_log.md). The WASM binding won
+ * on install story (0 deps, pure bundle), correctness (byte-identical to the
+ * proven mko/ Python Capstone oracle), and in-process speed. The native addon
+ * `capstone@3.0.1` was ELIMINATED (dead node-ffi/ref, won't build on Node 22);
+ * Python-Capstone via child-process is retained ONLY as an offline verify oracle.
+ *
+ * Two gotchas this module hides from callers (both learned in the probe):
+ *  1. disasm(bytes, { address }) — the base VA is an OPTIONS field, NOT positional.
+ *     Passing a bare number silently decodes from address 0.
+ *  2. address must be a BigInt for 64-bit runtime VAs (e.g. 0x140001000); a plain
+ *     number works for small values but BigInt is correct across the range. The
+ *     library returns Insn.address as number | bigint — we normalise on the way out.
+ */
+import { Capstone, Const, loadCapstone } from 'capstone-wasm';
+/**
+ * capstone-wasm must be initialised (WASM compiled/instantiated) exactly once
+ * per process before any Capstone instance is constructed. loadCapstone() is
+ * idempotent-safe to await, but we guard so concurrent tool calls share one init.
+ */
+let initPromise = null;
+export async function ensureCapstone() {
+    if (!initPromise)
+        initPromise = loadCapstone();
+    await initPromise;
+}
+/** Convert Insn.address (number | bigint) to a safe JS number. */
+function toNum(v) {
+    return typeof v === 'bigint' ? Number(v) : v;
+}
+/** Convert raw insn bytes to "48 8b 05" style hex. */
+function bytesToHex(bytes) {
+    return Array.from(bytes)
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join(' ');
+}
+/**
+ * Disassemble a raw byte range as x86-64. `bytes` is the exact code slice; the
+ * caller has already resolved section/offset and knows the runtime VA the first
+ * byte maps to. Returns normalised instructions with both VA and RVA.
+ *
+ * Read-only: this touches no files and mutates nothing — the caller reads the
+ * binary; we only decode the bytes it hands us.
+ */
+export async function disassembleX64(bytes, opts) {
+    await ensureCapstone();
+    const cs = new Capstone(Const.CS_ARCH_X86, Const.CS_MODE_64);
+    try {
+        // GOTCHA 1 + 2: address is an options field, and BigInt for 64-bit VAs.
+        const insns = cs.disasm(bytes, {
+            address: BigInt(opts.runtimeVA),
+            ...(opts.maxInsns && opts.maxInsns > 0 ? { count: opts.maxInsns } : {}),
+        });
+        return insns.map((i) => {
+            const va = toNum(i.address);
+            return {
+                va,
+                rva: va - opts.imageBase,
+                size: i.size,
+                mnemonic: i.mnemonic,
+                opStr: i.opStr ?? '',
+                bytes: bytesToHex(i.bytes),
+            };
+        });
+    }
+    finally {
+        // Free the WASM handle; a leaked handle would grow WASM memory across calls.
+        try {
+            cs.close();
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+}
+/** The capstone-wasm version, for provenance/reporting. */
+export async function capstoneVersion() {
+    await ensureCapstone();
+    const v = Capstone.version();
+    return `${v.major}.${v.minor}`;
+}
+//# sourceMappingURL=disassembler.js.map

package/dist/decoders/native/disassembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disassembler.js","sourceRoot":"","sources":["../../../src/decoders/native/disassembler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AA2B9D;;;;GAIG;AACH,IAAI,WAAW,GAAyB,IAAI,CAAC;AAC7C,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC,WAAW;QAAE,WAAW,GAAG,YAAY,EAAE,CAAC;IAC/C,MAAM,WAAW,CAAC;AACpB,CAAC;AAED,kEAAkE;AAClE,SAAS,KAAK,CAAC,CAAkB;IAC/B,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,sDAAsD;AACtD,SAAS,UAAU,CAAC,KAAiB;IACnC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;SACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SAC3C,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAiB,EACjB,IAAmB;IAEnB,MAAM,cAAc,EAAE,CAAC;IAEvB,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC7D,IAAI,CAAC;QACH,wEAAwE;QACxE,MAAM,KAAK,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;YAC7B,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;YAC/B,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxE,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAc,EAAE;YACjC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO;gBACL,EAAE;gBACF,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS;gBACxB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;gBACpB,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;aAC3B,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,6EAA6E;QAC7E,IAAI,CAAC;YACH,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,cAAc,EAAE,CAAC;IACvB,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC7B,OAAO,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;AACjC,CAAC"}

package/dist/decoders/png-encode.d.ts

@@ -0,0 +1,17 @@
+/**
+ * png-encode.ts — encode tightly-packed RGBA8 pixels to a PNG buffer.
+ *
+ * Unity textures are stored bottom-up (origin at the lower-left). PNG (and every image
+ * viewer) expects top-down. We flip vertically here so the exported PNG looks correct
+ * when opened — the single most common "the decode worked but the image is upside down"
+ * bug, handled once, centrally.
+ *
+ * Uses pngjs (pure-JS, no native compile — same install-cleanliness rule as better-sqlite3).
+ */
+/**
+ * @param rgba   tightly packed RGBA8, length === width*height*4, bottom-up (Unity order)
+ * @param width  texture width in pixels
+ * @param height texture height in pixels
+ * @returns PNG file bytes (top-down, RGBA)
+ */
+export declare function encodePng(rgba: Buffer, width: number, height: number): Buffer;

package/dist/decoders/png-encode.js

@@ -0,0 +1,33 @@
+/**
+ * png-encode.ts — encode tightly-packed RGBA8 pixels to a PNG buffer.
+ *
+ * Unity textures are stored bottom-up (origin at the lower-left). PNG (and every image
+ * viewer) expects top-down. We flip vertically here so the exported PNG looks correct
+ * when opened — the single most common "the decode worked but the image is upside down"
+ * bug, handled once, centrally.
+ *
+ * Uses pngjs (pure-JS, no native compile — same install-cleanliness rule as better-sqlite3).
+ */
+import { PNG } from 'pngjs';
+/**
+ * @param rgba   tightly packed RGBA8, length === width*height*4, bottom-up (Unity order)
+ * @param width  texture width in pixels
+ * @param height texture height in pixels
+ * @returns PNG file bytes (top-down, RGBA)
+ */
+export function encodePng(rgba, width, height) {
+    const expected = width * height * 4;
+    if (rgba.length < expected) {
+        throw new RangeError(`encodePng: rgba length ${rgba.length} < expected ${expected} for ${width}x${height}`);
+    }
+    const png = new PNG({ width, height, colorType: 6 /* RGBA */ });
+    const rowBytes = width * 4;
+    // Flip vertically: source row (height-1-y) -> destination row y.
+    for (let y = 0; y < height; y++) {
+        const srcStart = (height - 1 - y) * rowBytes;
+        const dstStart = y * rowBytes;
+        rgba.copy(png.data, dstStart, srcStart, srcStart + rowBytes);
+    }
+    return PNG.sync.write(png);
+}
+//# sourceMappingURL=png-encode.js.map