asset compression

interfaces/Crafter.Build-Asset.cppm

@@ -0,0 +1,39 @@
+/*
+Crafter® Build
+Copyright (C) 2026 Catcrafts®
+Catcrafts.net
+
+This library is free software; you can redistribute it and/or
+modify it under the terms of the GNU Lesser General Public
+License version 3.0 as published by the Free Software Foundation;
+
+This library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public
+License along with this library; if not, write to the Free Software
+Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301 USA
+*/
+
+module;
+#include "Crafter.Build-Api.h"
+export module Crafter.Build:Asset;
+import std;
+namespace fs = std::filesystem;
+
+namespace Crafter {
+    // Compress a build-time asset (.png/.obj) into its on-disk
+    // SaveCompressed counterpart (.ctex/.cmesh) using Crafter.Asset's
+    // library API in-process. Returns "" on success, an error message
+    // otherwise (matches Shader::Compile's contract).
+    //
+    // Real implementation lives in the impl unit and only compiles when
+    // CRAFTER_BUILD_HAS_ASSET is defined (i.e. when the build links
+    // Crafter.Asset). The bootstrap build.sh produces a stub variant
+    // that errors out at runtime if cfg.assets is non-empty — full
+    // 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);
+}