@xspr-parser-tool/core

TypeScript utilities for identifying and parsing legacy ?? asset files.

Usage

import { detectPal, parsePal } from "@xspr-parser-tool/core";

const buffer = await file.arrayBuffer();
if (detectPal(buffer)) {
  const result = parsePal(buffer);
  if (result.ok) {
    console.log(result.value.colorCount);
  }
}

Format Status

• .pal: Implemented as raw 256-color RGB table (768 bytes)
• .spr: Header + frame metadata parsed (no pixel decoding)
• .s32: Header + frame metadata parsed (no pixel decoding)
• .agf: Header + frame metadata parsed (no pixel decoding)
• .ytl: Insufficient information – need real file sample or C++ loading code
• .map: Insufficient information – need real file sample or C++ loading code

Requests Needed

Need clarification for each format:

• Do you have a hex dump of the first 64 bytes of a real .spr / .ytl file?
• Is there C++ code that shows the exact header layout?