Apply consistent code formatting with clang-format

- Add .clang-format config: Allman braces, 4-space indent, no braces for single statements
- Add .githooks/pre-commit for auto-formatting on commit
- Add CI workflow to check formatting on PRs
- Format all source files for consistency

Author: 0xeb

.clang-format

@@ -0,0 +1,54 @@
+# Clang-Format configuration for fastmcpp
+# Style: Allman braces, 4-space indent, no braces for single statements
+
+BasedOnStyle: LLVM
+
+# Braces on their own line (Allman style)
+BreakBeforeBraces: Allman
+
+# Indentation - 4 spaces
+IndentWidth: 4
+TabWidth: 4
+UseTab: Never
+ColumnLimit: 100
+
+# Remove braces from single-statement if/else/loop bodies
+RemoveBracesLLVM: true
+
+# Allow short control statements
+AllowShortBlocksOnASingleLine: Empty
+AllowShortFunctionsOnASingleLine: Empty
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLoopsOnASingleLine: false
+
+# Alignment
+AlignAfterOpenBracket: Align
+AlignConsecutiveAssignments: false
+AlignConsecutiveDeclarations: false
+AlignOperands: true
+AlignTrailingComments: true
+
+# Spacing
+SpaceAfterCStyleCast: false
+SpaceAfterTemplateKeyword: true
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeParens: ControlStatements
+SpaceInEmptyParentheses: false
+SpacesInAngles: false
+SpacesInContainerLiterals: false
+SpacesInCStyleCastParentheses: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+
+# Breaking
+AlwaysBreakAfterReturnType: None
+AlwaysBreakTemplateDeclarations: Yes
+BreakBeforeBinaryOperators: None
+BreakBeforeTernaryOperators: true
+BreakConstructorInitializers: BeforeColon
+BreakInheritanceList: BeforeColon
+
+# Other
+PointerAlignment: Left
+SortIncludes: true
+IncludeBlocks: Regroup

.githooks/pre-commit

@@ -0,0 +1,26 @@
+#!/bin/bash
+# Pre-commit hook: auto-format staged C++ files
+#
+# Enable with: git config core.hooksPath .githooks
+
+STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\.(cpp|hpp)$')
+
+if [ -z "$STAGED_FILES" ]; then
+    exit 0
+fi
+
+# Check if clang-format is available
+if ! command -v clang-format &> /dev/null; then
+    echo "Warning: clang-format not found, skipping auto-format"
+    exit 0
+fi
+
+# Auto-format and re-stage
+for file in $STAGED_FILES; do
+    if [ -f "$file" ]; then
+        clang-format -i "$file"
+        git add "$file"
+    fi
+done
+
+exit 0

.github/workflows/format-check.yml

@@ -0,0 +1,42 @@
+name: Format Check
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+jobs:
+  format-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install clang-format
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y clang-format-17
+
+      - name: Check formatting
+        run: |
+          # Find all source files (excluding build dirs and deps)
+          FILES=$(find src include examples tests -name "*.cpp" -o -name "*.hpp" 2>/dev/null)
+
+          # Check if any files need formatting
+          UNFORMATTED=""
+          for f in $FILES; do
+            if ! clang-format-17 --dry-run --Werror "$f" 2>/dev/null; then
+              UNFORMATTED="$UNFORMATTED $f"
+            fi
+          done
+
+          if [ -n "$UNFORMATTED" ]; then
+            echo "::error::The following files need formatting:"
+            for f in $UNFORMATTED; do
+              echo "  - $f"
+            done
+            echo ""
+            echo "Run: find src include examples tests -name '*.cpp' -o -name '*.hpp' | xargs clang-format -i"
+            exit 1
+          fi
+
+          echo "All files are properly formatted!"