feat:Add MSVC toolchain support, timezone shims, and update roadmap docs

Author: murapadev

.github/workflows/ci.yml

@@ -23,11 +23,15 @@ jobs:
       run: |
         make
 
+    - name: Configure on Windows
+      if: runner.os == 'Windows'
+      run: |
+        cmake -S . -B build -G "Visual Studio 17 2022" -A x64 -DSTRAP_BUILD_TESTS=ON -DSTRAP_BUILD_BENCHMARKS=OFF -DCMAKE_BUILD_TYPE=Release
+
     - name: Build on Windows
       if: runner.os == 'Windows'
       run: |
-        gcc -Wall -Wextra -O2 -c strap.c -o strap.o
-        ar rcs libstrap.a strap.o
+        cmake --build build --config Release
 
     - name: Run tests on Linux/macOS
       if: runner.os != 'Windows'
@@ -39,9 +43,7 @@ jobs:
     - name: Run tests on Windows
       if: runner.os == 'Windows'
       run: |
-        cd tests
-        gcc -I.. -L.. -o test_strap.exe test_strap.c -lstrap
-        ./test_strap.exe
+        ctest --test-dir build --config Release --output-on-failure
 
   release:
     needs: build

CMakeLists.txt

@@ -0,0 +1,56 @@
+cmake_minimum_required(VERSION 3.14)
+
+project(strap LANGUAGES C)
+
+option(STRAP_BUILD_TESTS "Build STRAP tests" ON)
+option(STRAP_BUILD_BENCHMARKS "Build STRAP benchmarks" OFF)
+
+add_library(strap STATIC strap.c)
+target_include_directories(
+    strap
+    PUBLIC
+        $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}>
+        $<INSTALL_INTERFACE:include>)
+target_compile_features(strap PRIVATE c_std_99)
+
+if(MSVC)
+    target_compile_options(strap PRIVATE /W4 /permissive-)
+    target_compile_definitions(
+        strap
+        PRIVATE
+            _CRT_SECURE_NO_WARNINGS
+            _CRT_NONSTDC_NO_DEPRECATE)
+else()
+    target_compile_options(strap PRIVATE -Wall -Wextra)
+endif()
+
+if(STRAP_BUILD_TESTS)
+    enable_testing()
+    add_executable(strap_tests tests/test_strap.c)
+    target_link_libraries(strap_tests PRIVATE strap)
+    if(MSVC)
+        target_compile_definitions(
+            strap_tests
+            PRIVATE
+                _CRT_SECURE_NO_WARNINGS
+                _CRT_NONSTDC_NO_DEPRECATE)
+    endif()
+    add_test(NAME strap_tests COMMAND strap_tests)
+endif()
+
+if(STRAP_BUILD_BENCHMARKS)
+    add_executable(strap_bench benchmarks/strap_bench.c)
+    target_link_libraries(strap_bench PRIVATE strap)
+    if(MSVC)
+        target_compile_definitions(
+            strap_bench
+            PRIVATE
+                _CRT_SECURE_NO_WARNINGS
+                _CRT_NONSTDC_NO_DEPRECATE)
+    endif()
+endif()
+
+include(GNUInstallDirs)
+install(TARGETS strap
+    ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR})
+install(FILES strap.h DESTINATION ${CMAKE_INSTALL_INCLUDEDIR})

README.md

@@ -12,6 +12,7 @@ A small, efficient C library providing missing utilities for safe and comfortabl
 - **[🚀 Quick Start Guide](../../wiki/Quick-Start)** - Get up and running in minutes
 - **[📋 API Reference](../../wiki/API-Reference)** - Detailed function documentation
 - **[💡 Examples](../../wiki/Examples)** - Code examples and use cases
+- **[🧰 Cookbook](../../wiki/Cookbook)** - Practical recipes for common tasks
 
 ## 🚀 Quick Start
 
@@ -29,6 +30,17 @@ make bench
 ./benchmarks/strap_bench
 ```
 
+### Windows (MSVC + CMake)
+
+```powershell
+# From a Visual Studio Developer Command Prompt
+git clone https://github.com/murapadev/strap.git
+cd strap
+scripts\build_windows_msvc.bat Release
+```
+
+The helper script configures the Visual Studio generator via CMake, builds the static library, and runs the unit tests. Adjust the generator string or build type inside the script to match your environment.
+
 ## 🔔 What's New in v0.2
 
 - Faster joins and file reads through tighter allocation strategies
@@ -97,6 +109,21 @@ Call `strap_clear_error()` when you want to reset the status manually.
 - [x] Optional arena allocator for transient strings
 - [x] Timezone-aware time helpers
 
+### v0.4 (Upcoming)
+
+- [x] Additional performance optimizations
+  - [x] SIMD-accelerated paths for common hot functions (`strtrim`, `strjoin`)
+  - [x] Streaming-friendly buffering for `afgets` and file helpers (`strap_line_buffer_read`)
+- [x] Extended string manipulation utilities
+  - [x] High-level split helpers with delimiter limits and predicates (`strsplit_limit`, `strsplit_predicate`)
+  - [x] Case-insensitive comparison helpers (`strap_strcasecmp`, `strcaseeq`)
+- [x] Cross-platform improvements
+  - [x] Official Windows/MSVC build scripts and CI coverage
+  - [x] Locale/timezone shims for BSD and musl-targeted systems
+- [x] Enhanced documentation
+  - [x] Cookbook-style guides for common patterns (log parsing, CSV wrangling)
+  - [x] API reference refresh with usage notes and complexity details
+
 ## 📄 License
 
 MIT Licensed - see [LICENSE](LICENSE) for details.

scripts/build_windows_msvc.bat

@@ -0,0 +1,26 @@
+@echo off
+setlocal enabledelayedexpansion
+
+set "BUILD_TYPE=%~1"
+if "%BUILD_TYPE%"=="" set BUILD_TYPE=Release
+
+set "ROOT=%~dp0.."
+set "BUILD_DIR=%ROOT%\build\msvc"
+
+echo Configuring STRAP (%BUILD_TYPE%)...
+cmake -S "%ROOT%" -B "%BUILD_DIR%" -G "Visual Studio 17 2022" -A x64 -DSTRAP_BUILD_TESTS=ON -DSTRAP_BUILD_BENCHMARKS=OFF -DCMAKE_BUILD_TYPE=%BUILD_TYPE%
+if errorlevel 1 (
+    echo Failed to configure STRAP project.
+    exit /b 1
+)
+
+echo Building STRAP...
+cmake --build "%BUILD_DIR%" --config %BUILD_TYPE%
+if errorlevel 1 (
+    echo Build failed.
+    exit /b 1
+)
+
+echo Running tests...
+ctest --test-dir "%BUILD_DIR%" --config %BUILD_TYPE% --output-on-failure
+exit /b %errorlevel%