asset changes

interfaces/Crafter.Build-Asset.cppm

@@ -36,4 +36,26 @@ namespace Crafter {
     // support requires a self-host rebuild via crafter-build itself,
     // which resolves the Crafter.Asset dep through project.cpp.
     export CRAFTER_API std::string CompressAsset(const fs::path& input, const fs::path& output);
+
+    // Split a single .obj + .mtl file by material group into per-material
+    // .cmesh files, per-unique-albedo .ctex files, and a scene.txt manifest
+    // under outDir. All albedo textures are resized to albedoSize × albedoSize
+    // before compression (required for a texture_2d_array where all layers
+    // must have identical dimensions).
+    //
+    // scene.txt format (read by the Sponza example at runtime):
+    //   <albedoCount>
+    //   <meshCount>
+    //   <albedoIdx_for_mesh_0>   (-1 = no albedo)
+    //   ...
+    //
+    // Idempotent: returns "" immediately if outDir/scene.txt already exists,
+    // so repeated builds skip the expensive split+resize step.
+    // Returns "" on success, an error string on failure.
+    export CRAFTER_API std::string BuildOBJBundle(
+        const fs::path& objPath,
+        const fs::path& mtlPath,
+        const fs::path& outDir,
+        std::uint16_t   albedoSize = 1024
+    );
 }