loading bar

interfaces/Crafter.Build-Progress.cppm

@@ -0,0 +1,57 @@
+/*
+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:Progress;
+import std;
+
+export namespace Crafter::Progress {
+    enum class Verbosity { Quiet, Default, Verbose };
+
+    CRAFTER_API void SetVerbosity(Verbosity v);
+    CRAFTER_API Verbosity GetVerbosity();
+
+    // RAII work-unit marker. Construction inflates the running total; destruction
+    // increments completed and (on Default + TTY) redraws the status line. Move
+    // semantics are disabled — keep these as plain stack locals inside the worker
+    // lambda so the destructor fires when that thread's work ends.
+    class CRAFTER_API Task {
+    public:
+        explicit Task(std::string label);
+        ~Task();
+        Task(const Task&) = delete;
+        Task& operator=(const Task&) = delete;
+        Task(Task&&) = delete;
+        Task& operator=(Task&&) = delete;
+    private:
+        std::string label_;
+    };
+
+    // Verbose-mode command echo. No-op outside Verbose.
+    CRAFTER_API void EchoCommand(std::string_view command);
+
+    // Erase the in-place status line so subsequent stderr writes (errors,
+    // banners) don't collide with it. No-op when not in TTY-redraw mode.
+    CRAFTER_API void Clear();
+
+    // Print "Built N targets in Xms" (or equivalent) and clear in-place state.
+    // Safe to call multiple times; subsequent calls are no-ops.
+    CRAFTER_API void Finalize();
+}