Numerous build and optimisation changes to speedup runtime performance

This change set implements significant build system and performance
improvements for the z80cpp Z80 emulator core. The primary goal is to
optimise runtime performance while modernising the build infrastructure.

**Changes:**

- Refactored from virtual dispatch to CRTP (Curiously Recurring Template
Pattern) for zero-overhead polymorphism
- Introduced performance optimisation macros (`Z80_FORCE_INLINE`,
`Z80_LIKELY`, `Z80_RESTRICT`)
- Modernised CMake build system with LTO, ccache support, and parallel
builds
- Added code quality tooling (clang-format, clang-tidy, GitHub Actions
CI)
- Renamed header files from `.hpp` to `.h` for C++ consistency
- Updated benchmark tests with higher performance expectations

Author: doraemoncito

.clang-format

@@ -0,0 +1,82 @@
+---
+Language: Cpp
+Standard: c++17
+BasedOnStyle: LLVM
+
+# Line length
+ColumnLimit: 120
+
+# Indentation
+IndentWidth: 4
+UseTab: Never
+IndentCaseLabels: true
+IndentPPDirectives: AfterHash
+
+# Spacing
+SpaceBeforeParens: ControlStatements
+SpaceAfterCStyleCast: false
+SpacesInAngles: false
+SpaceInEmptyParentheses: false
+SpaceBeforeAssignmentOperators: true
+
+# Pointers and references
+PointerAlignment: Left
+
+# Braces
+BraceWrapping:
+  AfterCaseLabel: false
+  AfterClass: false
+  AfterControlStatement: Never
+  AfterEnum: false
+  AfterFunction: false
+  AfterNamespace: false
+  AfterStruct: false
+  AfterUnion: false
+  AfterExternBlock: false
+  BeforeCatch: false
+  BeforeElse: false
+  BeforeLambdaBody: false
+  BeforeWhile: false
+  IndentBraces: false
+  SplitEmptyFunction: false
+  SplitEmptyRecord: false
+  SplitEmptyNamespace: false
+
+# Function definitions
+AllowShortFunctionsOnASingleLine: None
+SeparateDefinitionBlocks: Always
+AllowShortBlocksOnASingleLine: Empty
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLoopsOnASingleLine: false
+AllowAllArgumentsOnNextLine: true
+AllowAllParametersOfDeclarationOnNextLine: true
+
+# Constructor/Destructor
+ConstructorInitializerAllOnOneLineOrOnePerLine: true
+ConstructorInitializerIndentWidth: 4
+Cpp11BracedListStyle: true
+
+# Operators
+BreakBeforeBinaryOperators: NonAssignment
+BreakBeforeTernaryOperators: true
+
+# Includes
+SortIncludes: true
+IncludeBlocks: Preserve
+
+# Comments
+ReflowComments: true
+
+# Other
+AlignAfterOpenBracket: Align
+AlignConsecutiveAssignments: None
+AlignConsecutiveDeclarations: None
+AlignConsecutiveMacros: true
+AlignEscapedNewlines: Left
+AlignTrailingComments: true
+
+AccessModifierOffset: -2
+CompactNamespaces: false
+FixNamespaceComments: true
+MaxEmptyLinesToKeep: 1
+NamespaceIndentation: None

.clang-tidy

@@ -0,0 +1,45 @@
+---
+# Clang-tidy configuration for Z80 emulator project
+Checks: |
+  -*, 
+  readability-*,
+  performance-*,
+  modernize-*,
+  bugprone-*,
+  clang-diagnostic-*,
+  cppcoreguidelines-*,
+  google-*,
+  -readability-magic-numbers,
+  -readability-uppercase-literal-suffix,
+  -cppcoreguidelines-avoid-magic-numbers,
+  -cppcoreguidelines-pro-bounds-array-to-pointer-decay,
+  -cppcoreguidelines-pro-type-cstyle-cast,
+  -cppcoreguidelines-pro-type-reinterpret-cast,
+  -google-readability-function-size,
+  -google-runtime-references,
+  -modernize-use-trailing-return-type,
+  -cppcoreguidelines-pro-bounds-constant-array-index,
+  -readability-function-cognitive-complexity,
+  -readability-function-size
+
+WarningsAsErrors: ''
+
+# Configure individual checks
+CheckOptions:
+  - key: 'readability-function-cognitive-complexity.Threshold'
+    value: '25'
+  - key: 'readability-function-size.StatementThreshold'
+    value: '800'
+  - key: 'readability-identifier-length.MinimumVariableNameLength'
+    value: '2'
+  - key: 'readability-identifier-length.MinimumParameterNameLength'
+    value: '2'
+  - key: 'readability-identifier-length.MinimumLoopCounterNameLength'
+    value: '1'
+  - key: 'readability-line-length.LineLength'
+    value: '120'
+  - key: 'bugprone-easily-swappable-parameters.MinimumLength'
+    value: '3'
+
+HeaderFilterRegex: '.*'
+InheritParentConfig: true

.github/workflows/code-quality.yml

@@ -0,0 +1,68 @@
+name: Code Quality
+
+on: [push, pull_request]
+
+jobs:
+  formatting:
+    name: Check Code Formatting
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install clang-format
+        run: sudo apt-get install -y clang-format
+      
+      - name: Check formatting
+        run: |
+          files=$(find include tests -type f \( -name "*.cpp" -o -name "*.h" -o -name "*.tpp" \))
+          for file in $files; do
+            clang-format --dry-run -Werror "$file" || exit 1
+          done
+          echo "All files are properly formatted!"
+
+  static-analysis:
+    name: Static Analysis with clang-tidy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y clang-tidy cmake build-essential
+      
+      - name: Build with compile_commands.json
+        run: |
+          mkdir -p build
+          cd build
+          cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON ..
+          make
+      
+      - name: Run clang-tidy
+        run: |
+          cd build
+          files=$(find ../tests -type f -name "*.cpp")
+          clang-tidy -p . $files
+
+  build:
+    name: Build Project
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y cmake build-essential
+      
+      - name: Build
+        run: |
+          mkdir -p build
+          cd build
+          cmake ..
+          make -j4
+      
+      - name: Run tests
+        run: |
+          cd build
+          ctest --output-on-failure

.gitignore

@@ -1,5 +1,12 @@
+# Editor and OS files
 .cache/
 .idea/
 .vscode/
+.DS_Store
+
+# Build directories
 build*/
+
+# Test ROMs
+tests/roms/*
 tests/roms/*.tap