feat! Breaking API changes of NeCTI's LibCompiler and LibDebugger.

what:

- They've now become CompilerKit and DebuggerKit.
- Expanding XCoff for NeBoot PowerPC backend.

Signed-off-by: Amlal El Mahrouss <amlal@nekernel.org>

3 files changed, 222 insertions, 0 deletions

diff --git a/dev/CompilerKit/utils/AsmUtils.h b/dev/CompilerKit/utils/AsmUtils.h
new file mode 100644
index 0000000..f74fb1b
--- /dev/null
+++ b/dev/CompilerKit/utils/AsmUtils.h
@@ -0,0 +1,93 @@
+/* -------------------------------------------
+
+  Copyright (C) 2024-2025 Amlal EL Mahrouss, all rights reserved
+
+------------------------------------------- */
+
+#pragma once
+
+#include <CompilerKit/CodeGen.h>
+#include <CompilerKit/Frontend.h>
+
+#include <CompilerKit/utils/CompilerUtils.h>
+
+using namespace CompilerKit;
+
+/// @brief Get Number from lineBuffer.
+/// @param lineBuffer the lineBuffer to fetch from.
+/// @param numberKey where to seek that number.
+/// @return
+static NumberCast32 GetNumber32(std::string lineBuffer, std::string numberKey) {
+  auto pos = lineBuffer.find(numberKey) + numberKey.size();
+
+  while (lineBuffer[pos] == ' ') {
+    ++pos;
+  }
+
+  switch (lineBuffer[pos + 1]) {
+    case 'x': {
+      if (auto res = strtol(lineBuffer.substr(pos).c_str(), nullptr, 16); !res) {
+        if (errno != 0) {
+          Detail::print_error("invalid hex number: " + lineBuffer, "CompilerKit");
+          throw std::runtime_error("invalid_hex");
+        }
+      }
+
+      NumberCast32 numOffset(strtol(lineBuffer.substr(pos).c_str(), nullptr, 16));
+
+      if (kVerbose) {
+        kStdOut << "asm: found a base 16 number here: " << lineBuffer.substr(pos) << "\n";
+      }
+
+      return numOffset;
+    }
+    case 'b': {
+      if (auto res = strtol(lineBuffer.substr(pos).c_str(), nullptr, 2); !res) {
+        if (errno != 0) {
+          Detail::print_error("invalid binary number:" + lineBuffer, "CompilerKit");
+          throw std::runtime_error("invalid_bin");
+        }
+      }
+
+      NumberCast32 numOffset(strtol(lineBuffer.substr(pos).c_str(), nullptr, 2));
+
+      if (kVerbose) {
+        kStdOut << "asm: found a base 2 number here:" << lineBuffer.substr(pos) << "\n";
+      }
+
+      return numOffset;
+    }
+    case 'o': {
+      if (auto res = strtol(lineBuffer.substr(pos).c_str(), nullptr, 7); !res) {
+        if (errno != 0) {
+          Detail::print_error("invalid octal number: " + lineBuffer, "CompilerKit");
+          throw std::runtime_error("invalid_octal");
+        }
+      }
+
+      NumberCast32 numOffset(strtol(lineBuffer.substr(pos).c_str(), nullptr, 7));
+
+      if (kVerbose) {
+        kStdOut << "asm: found a base 8 number here:" << lineBuffer.substr(pos) << "\n";
+      }
+
+      return numOffset;
+    }
+    default: {
+      if (auto res = strtol(lineBuffer.substr(pos).c_str(), nullptr, 10); !res) {
+        if (errno != 0) {
+          Detail::print_error("invalid hex number: " + lineBuffer, "CompilerKit");
+          throw std::runtime_error("invalid_hex");
+        }
+      }
+
+      NumberCast32 numOffset(strtol(lineBuffer.substr(pos).c_str(), nullptr, 10));
+
+      if (kVerbose) {
+        kStdOut << "asm: found a base 10 number here:" << lineBuffer.substr(pos) << "\n";
+      }
+
+      return numOffset;
+    }
+  }
+}
diff --git a/dev/CompilerKit/utils/CompilerUtils.h b/dev/CompilerKit/utils/CompilerUtils.h
new file mode 100644
index 0000000..da35b2b
--- /dev/null
+++ b/dev/CompilerKit/utils/CompilerUtils.h
@@ -0,0 +1,116 @@
+/* -------------------------------------------
+
+  Copyright (C) 2024-2025 Amlal EL Mahrouss, all rights reserved
+
+------------------------------------------- */
+
+#pragma once
+
+#include <CompilerKit/CodeGen.h>
+#include <CompilerKit/ErrorID.h>
+#include <CompilerKit/Frontend.h>
+#include <CompilerKit/Version.h>
+#include <ThirdParty/Dialogs.h>
+#include <iostream>
+
+#define kZero64Section ".zero64"
+#define kCode64Section ".code64"
+#define kData64Section ".data64"
+
+#define kZero128Section ".zero128"
+#define kCode128Section ".code128"
+#define kData128Section ".data128"
+
+#define kBlank "\e[0;30m"
+#define kRed "\e[0;31m"
+#define kWhite "\e[0;97m"
+#define kYellow "\e[0;33m"
+
+#define kStdOut (std::cout << kRed << "drv: " << kWhite)
+#define kStdErr (std::cout << kYellow << "drv: " << kWhite)
+
+inline static UInt32 kErrorLimit       = 10;
+inline static UInt32 kAcceptableErrors = 0;
+inline static bool   kVerbose          = false;
+inline static bool   kOutputAsBinary   = false;
+
+namespace Detail {
+/// @brief Linker specific blob metadata structure
+struct DynamicLinkerBlob final {
+  std::vector<Char> mBlob{};       // PEF code/bss/data blob.
+  UIntPtr           mOffset{0UL};  // the offset of the PEF container header...
+};
+
+inline void print_error(std::string reason, std::string file) noexcept {
+  if (reason[0] == '\n') reason.erase(0, 1);
+
+  kStdErr << reason << kBlank << std::endl;
+
+  if (kAcceptableErrors > kErrorLimit) std::exit(LIBCOMPILER_EXEC_ERROR);
+
+  ++kAcceptableErrors;
+}
+
+inline void print_warning(std::string reason, std::string file) noexcept {
+  if (reason[0] == '\n') reason.erase(0, 1);
+
+  kStdOut << kYellow << reason << kBlank << std::endl;
+}
+
+/// @internal
+/// @brief Handler for SIGSEGV signal.
+inline void drvi_crash_handler(std::int32_t id) {
+  CompilerKit::STLString verbose_header = "LIBCOMPILER CRASH REPORT - ";
+  verbose_header += kDistVersion;
+  verbose_header += " - ";
+  verbose_header += CompilerKit::current_date();
+
+  for (auto& ch : verbose_header) {
+    std::cout << '=';
+  }
+
+  std::cout << std::endl;
+
+  std::cout << verbose_header << std::endl;
+
+  for (auto& ch : verbose_header) {
+    std::cout << '=';
+  }
+
+  std::cout << std::endl;
+
+  kStdOut << "DATE: " << CompilerKit::current_date() << std::endl;
+  kStdOut << "VERSION: " << kDistVersion << std::endl;
+  kStdOut << "ERRNO: " << errno << std::endl;
+  kStdOut << "ERRNO(STRING): " << strerror(errno) << std::endl;
+
+  switch (id) {
+    case SIGSEGV: {
+      kStdOut << "SIGNAL: Segmentation Fault." << kBlank << std::endl;
+      break;
+    }
+    case SIGABRT: {
+      kStdOut << "SIGNAL: Aborted." << kBlank << std::endl;
+      break;
+    }
+  }
+
+  std::cout << kWhite;
+
+  for (auto& ch : verbose_header) {
+    std::cout << '=';
+  }
+
+  std::cout << std::endl;
+
+  std::cout << verbose_header << std::endl;
+
+  for (auto& ch : verbose_header) {
+    std::cout << '=';
+  }
+
+  std::cout << std::endl;
+
+  std::exit(LIBCOMPILER_EXEC_ERROR);
+}
+}  // namespace Detail
diff --git a/dev/CompilerKit/utils/DylibHelpers.h b/dev/CompilerKit/utils/DylibHelpers.h
new file mode 100644
index 0000000..1ae7c03
--- /dev/null
+++ b/dev/CompilerKit/utils/DylibHelpers.h
@@ -0,0 +1,13 @@
+/* -------------------------------------------
+
+  Copyright (C) 2025 Amlal EL Mahrouss, all rights reserved
+
+------------------------------------------- */
+
+#pragma once
+
+#include <CompilerKit/Defines.h>
+#include <dlfcn.h>
+
+typedef Int32 (*CompilerKitEntrypoint)(Int32 argc, Char const* argv[]);
+typedef VoidPtr CompilerKitDylib;