compile_vfp()

compile_vfp(input_path: pathlib.Path, output_path: pathlib.Path, *,
            chunk_size: int = 16, include_preview: bool = True,
            include_runtime_caches: bool = True,
            include_render_cache: bool = False,
            include_animation_cache: bool = True) -> dict[str, object]

完整 JSON Writer。include_runtime_caches 写 VBUF/PMSH，include_render_cache 写 RND0，include_animation_cache 写 ANM0，include_preview 写 PRVW。每项均为派生数据，不改变 VOX0、PAL0 或 sourceHash。

from pathlib import Path
from voxelkit import compile_vfp
report = compile_vfp(Path("source.json"), Path("asset.vfp"), include_preview=False, include_render_cache=True)