feat: better compile; material token access; gui color scheme galleries

Author: Charliechen114514

base/CMakeLists.txt

@@ -1,6 +1,15 @@
 # Base library - fundamental utilities and platform abstractions
 cmake_minimum_required(VERSION 3.16)
 
+# ============================================================
+# Header-only library for base/include (utilities, hash, expected, etc.)
+# ============================================================
+add_library(cfbase_headers INTERFACE)
+target_include_directories(cfbase_headers INTERFACE
+    ${CMAKE_CURRENT_SOURCE_DIR}/include
+)
+add_library(CFDesktop::base_headers ALIAS cfbase_headers)
+
 # Include subdirectory CMakeLists (OBJECT libraries)
 add_subdirectory(system/cpu)
 add_subdirectory(system/memory)

base/include/base/hash/constexpr_fnv1a.hpp

@@ -0,0 +1,163 @@
+/**
+ * @file    constexpr_fnv1a.hpp
+ * @brief   Compile-time FNV-1a hash for string interning.
+ *
+ * Provides constexpr FNV-1a hashing algorithm for compile-time
+ * string hash computation. Supports both 32-bit and 64-bit variants.
+ *
+ * @author  Charliechen114514
+ * @date    2026-02-25
+ * @version 0.1
+ * @since   0.1
+ * @ingroup base_hash
+ */
+#pragma once
+
+#include <cstdint>
+#include <string_view>
+
+namespace cf::hash {
+
+/**
+ * @brief  FNV-1a 64-bit offset basis.
+ *
+ * @since  0.1
+ * @ingroup base_hash
+ * @internal
+ */
+inline constexpr uint64_t fnv1a64_offset_basis = 14695981039346656037ULL;
+
+/**
+ * @brief  FNV-1a 64-bit prime.
+ *
+ * @since  0.1
+ * @ingroup base_hash
+ * @internal
+ */
+inline constexpr uint64_t fnv1a64_prime = 1099511628211ULL;
+
+/**
+ * @brief  FNV-1a 32-bit offset basis.
+ *
+ * @since  0.1
+ * @ingroup base_hash
+ * @internal
+ */
+inline constexpr uint32_t fnv1a32_offset_basis = 2166136261U;
+
+/**
+ * @brief  FNV-1a 32-bit prime.
+ *
+ * @since  0.1
+ * @ingroup base_hash
+ * @internal
+ */
+inline constexpr uint32_t fnv1a32_prime = 16777619U;
+
+/**
+ * @brief  FNV-1a 64-bit hash constexpr implementation.
+ *
+ * Computes FNV-1a hash at compile time for string literals.
+ * The FNV-1a algorithm provides excellent distribution and
+ * minimal collisions for string identifiers.
+ *
+ * @param  str Null-terminated string to hash.
+ * @param  seed Starting hash value (default: FNV offset basis).
+ *
+ * @return     64-bit hash value.
+ *
+ * @throws     None.
+ *
+ * @note       The hash is computed at compile time for string literals.
+ *
+ * @warning    Different inputs may produce the same hash (collision).
+ *             Use string comparison as fallback when hashes match.
+ *
+ * @since      0.1
+ * @ingroup    base_hash
+ *
+ * @code
+ * constexpr uint64_t h1 = fnv1a64("TokenA");  // Compile-time
+ * constexpr uint64_t h2 = fnv1a64("TokenB");  // Different value
+ * static_assert(h1 != h2, "Hash collision!");
+ * @endcode
+ */
+constexpr uint64_t fnv1a64(const char* str, uint64_t seed = fnv1a64_offset_basis) {
+    return (*str == 0)
+        ? seed
+        : fnv1a64(str + 1, (seed ^ static_cast<uint64_t>(*str)) * fnv1a64_prime);
+}
+
+/**
+ * @brief  FNV-1a 64-bit hash for std::string_view (runtime/constexpr).
+ *
+ * @param  sv String view to hash.
+ * @param  seed Starting hash value (default: FNV offset basis).
+ *
+ * @return    64-bit hash value.
+ *
+ * @since     0.1
+ * @ingroup   base_hash
+ */
+constexpr uint64_t fnv1a64(std::string_view sv, uint64_t seed = fnv1a64_offset_basis) {
+    uint64_t result = seed;
+    for (char c : sv) {
+        result = (result ^ static_cast<uint64_t>(c)) * fnv1a64_prime;
+    }
+    return result;
+}
+
+/**
+ * @brief  FNV-1a 32-bit hash constexpr implementation.
+ *
+ * @param  str Null-terminated string to hash.
+ * @param  seed Starting hash value (default: FNV offset basis).
+ *
+ * @return     32-bit hash value.
+ *
+ * @since      0.1
+ * @ingroup    base_hash
+ */
+constexpr uint32_t fnv1a32(const char* str, uint32_t seed = fnv1a32_offset_basis) {
+    return (*str == 0)
+        ? seed
+        : fnv1a32(str + 1, (seed ^ static_cast<uint32_t>(*str)) * fnv1a32_prime);
+}
+
+/**
+ * @brief  FNV-1a 32-bit hash for std::string_view.
+ *
+ * @param  sv String view to hash.
+ * @param  seed Starting hash value (default: FNV offset basis).
+ *
+ * @return    32-bit hash value.
+ *
+ * @since     0.1
+ * @ingroup   base_hash
+ */
+constexpr uint32_t fnv1a32(std::string_view sv, uint32_t seed = fnv1a32_offset_basis) {
+    uint32_t result = seed;
+    for (char c : sv) {
+        result = (result ^ static_cast<uint32_t>(c)) * fnv1a32_prime;
+    }
+    return result;
+}
+
+/**
+ * @brief  User-defined literal for compile-time FNV-1a 64-bit hashing.
+ *
+ * Enables syntax: `"TokenName"_hash` for compile-time hash computation.
+ *
+ * @since 0.1
+ * @ingroup base_hash
+ *
+ * @code
+ * constexpr uint64_t h = "MyToken"_hash;  // Compile-time hash
+ * static_assert(h == fnv1a64("MyToken"), "Hash must match");
+ * @endcode
+ */
+constexpr uint64_t operator""_hash(const char* str, size_t) {
+    return fnv1a64(str);
+}
+
+} // namespace cf::hash

example/CMakeLists.txt

@@ -1,4 +1,5 @@
 log_info("Example" "Managing Example Components")
 
 add_subdirectory(base)
+add_subdirectory(gui)
 

example/gui/CMakeLists.txt

@@ -0,0 +1,3 @@
+log_info("Example GUI" "Managing GUI Examples")
+
+add_subdirectory(material_color_scheme)

example/gui/material_color_scheme/CMakeLists.txt

@@ -0,0 +1,24 @@
+# Material Color Scheme Gallery Example
+log_info("Material Color Scheme" "Building Color Gallery Example")
+
+add_executable(material_color_scheme_gallery
+    main.cpp
+    MaterialColorSchemeMainWindow.h
+    MaterialColorSchemeMainWindow.cpp
+)
+
+target_link_libraries(material_color_scheme_gallery PRIVATE
+    Qt6::Widgets
+    Qt6::Core
+    Qt6::Gui
+    cfui
+)
+
+# Windows 下设置为 GUI 应用（不显示控制台窗口）
+if(WIN32)
+    set_target_properties(material_color_scheme_gallery PROPERTIES
+        WIN32_EXECUTABLE TRUE
+    )
+    # 自动部署 Qt DLL
+    qt_add_windows_deploy(material_color_scheme_gallery AUTO_DEPLOY)
+endif()