cmake: export/install crumbs package and add package config for find_package(crumbs)

Author: CameronBrooks11

CMakeLists.txt

@@ -48,11 +48,12 @@ add_library(crumbs STATIC ${CRUMBS_CORE_SOURCES})
 # Public headers live in src/ (for now)
 target_include_directories(crumbs
     PUBLIC
-        ${CMAKE_CURRENT_SOURCE_DIR}/src          # crumbs.h, crumbs_*.h, crumbs_linux.h
-        ${CMAKE_CURRENT_SOURCE_DIR}/src/core
-        ${CMAKE_CURRENT_SOURCE_DIR}/src/crc
-        ${CMAKE_CURRENT_SOURCE_DIR}/src/crc/c99
-        ${CMAKE_CURRENT_SOURCE_DIR}/src/hal/linux
+        $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/src>
+        $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/src/core>
+        $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/src/crc>
+        $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/src/crc/c99>
+        $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/src/hal/linux>
+        $<INSTALL_INTERFACE:include/crumbs>
 )
 
 # ---------------------------------------------------------------------------
@@ -131,8 +132,11 @@ endif()
 # ---------------------------------------------------------------------------
 
 # Install the static library
+# Install the static library and export targets so consumers can use find_package(crumbs)
 install(TARGETS crumbs
+    EXPORT crumbsTargets
     ARCHIVE DESTINATION lib
+    INCLUDES DESTINATION include/crumbs
 )
 
 # Install public headers under include/crumbs/
@@ -146,3 +150,34 @@ install(
         ${CMAKE_CURRENT_SOURCE_DIR}/src/crumbs_linux.h
     DESTINATION include/crumbs
 )
+
+# ---------------------------------------------------------------------------
+# Export / Config packaging for CMake consumers
+# ---------------------------------------------------------------------------
+include(CMakePackageConfigHelpers)
+
+set(config_install_dir "${CMAKE_INSTALL_LIBDIR}/cmake/crumbs")
+
+configure_package_config_file(
+    "${CMAKE_CURRENT_SOURCE_DIR}/cmake/crumbsConfig.cmake.in"
+    "${CMAKE_CURRENT_BINARY_DIR}/crumbsConfig.cmake"
+    INSTALL_DESTINATION ${config_install_dir}
+)
+
+write_basic_package_version_file(
+    "${CMAKE_CURRENT_BINARY_DIR}/crumbsConfigVersion.cmake"
+    VERSION ${PROJECT_VERSION}
+    COMPATIBILITY SameMajorVersion
+)
+
+install(EXPORT crumbsTargets
+    FILE crumbsTargets.cmake
+    NAMESPACE crumbs::
+    DESTINATION ${config_install_dir}
+)
+
+install(FILES
+    "${CMAKE_CURRENT_BINARY_DIR}/crumbsConfig.cmake"
+    "${CMAKE_CURRENT_BINARY_DIR}/crumbsConfigVersion.cmake"
+    DESTINATION ${config_install_dir}
+)

cmake/crumbsConfig.cmake.in

@@ -0,0 +1,4 @@
+@PACKAGE_INIT@
+
+# Load targets
+include("${CMAKE_CURRENT_LIST_DIR}/crumbsTargets.cmake")

docs/getting-started.md

@@ -11,6 +11,30 @@
 
 1. No external dependencies required.
 
+### Native C (CMake) installation
+
+You can build and install CRUMBS as a CMake library and then use `find_package(crumbs CONFIG)` from other projects.
+
+In the source tree:
+
+```bash
+cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
+cmake --build build --config Release --parallel
+cmake --install build --prefix /usr/local
+```
+
+After installation you can use CRUMBS in other CMake projects with:
+
+```cmake
+find_package(crumbs CONFIG REQUIRED)
+add_executable(myprog main.c)
+target_link_libraries(myprog PRIVATE crumbs::crumbs)
+```
+
+Tips
+- For local development prefer the in-tree example usage (examples/native/controller) which will link the in-repo `crumbs` target via `add_subdirectory`.
+- When packaging for distribution ensure you install the exported cmake files (the top-level CMake provided export/install rules place crumbs targets under lib/cmake/crumbs) so `find_package(crumbs CONFIG)` can locate them via CMAKE_PREFIX_PATH or an installed system prefix.
+
 ## Basic Usage
 
 ### Controller (Arduino — C API)