compile_json()

compile_json(input_path: str, output_path: str, *, chunk_size: int = 16,
             preview: bool = False) -> dict[str, object]

简化的 PixForge JSON → VFP 入口。chunk_size 必须是 1..255；preview=True 写 PRVW。它始终沿用完整 Writer 的默认运行时缓存与 ANM0 配置，不支持 THMB、VOX 或缓存重建参数。

from voxelkit import compile_json
report = compile_json("source.json", "asset.vfp", chunk_size=16, preview=True)
print(report["sourceHash"], report["vfpBytes"])

格式错误抛出 VfpError，文件读写失败抛出 OSError。