chore: Nectar grunt work on runtime library and test code.

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

1 files changed, 43 insertions, 0 deletions

diff --git a/include/LibNectar/base_alloc.h b/include/LibNectar/base_alloc.h
new file mode 100644
index 0000000..81a3299
--- /dev/null
+++ b/include/LibNectar/base_alloc.h
@@ -0,0 +1,43 @@
+// Copyright 2024-2025, Amlal El Mahrouss (amlal@nekernel.org)
+// Licensed under the Apache License, Version 2.0 (See accompanying
+// file LICENSE or copy at http://www.apache.org/licenses/LICENSE-2.0)
+// Official repository: https://github.com/nekernel-org/nectar
+
+#ifndef NECTAR_LIBNECTAR_BASE_ALLOC_H
+#define NECTAR_LIBNECTAR_BASE_ALLOC_H
+
+#include <LibNectar/defines.h>
+
+/// @brief allocate a new class.
+/// @tparam KindClass the class type to allocate.
+template <class KindClass, typename... Args>
+inline KindClass* allocate(Args&&... args) {
+  return new KindClass(forward(args)...);
+}
+
+/// @brief allocate a new class.
+/// @note aborts on error.
+/// @tparam KindClass the class type to allocate.
+template <class KindClass, typename... Args>
+inline KindClass* allocate_nothrow(Args&&... args) noexcept {
+  return allocate(forward(args)...);
+}
+
+/// @brief free a class.
+/// @tparam KindClass the class type to allocate.
+template <class KindClass>
+inline void release(KindClass ptr) {
+  if (!ptr) return;
+
+  delete ptr;
+}
+
+/// @brief destroy and free a class.
+/// @note aborts on error.
+/// @tparam KindClass the class type to allocate.
+template <class KindClass>
+inline void release_nothrow(KindClass ptr) noexcept {
+  release(ptr);
+}
+
+#endif  // NECTAR_LIBNECTAR_BASE_ALLOC_H