chore: Merge 'doodlum/dev' into 'feature/hdr-output'

May not compile yet, no fixes applied only merge conflict resolution

Author: Dakraid

.clang-format

@@ -1,99 +1,100 @@
 ---
 AccessModifierOffset: -4
 AlignAfterOpenBracket: DontAlign
-AlignConsecutiveAssignments: 'false'
-AlignConsecutiveBitFields: 'false'
-AlignConsecutiveDeclarations: 'false'
-AlignConsecutiveMacros: 'false'
+AlignConsecutiveAssignments: false
+AlignConsecutiveBitFields: false
+AlignConsecutiveDeclarations: false
+AlignConsecutiveMacros: false
 AlignEscapedNewlines: Left
 AlignOperands: Align
-AlignTrailingComments: 'true'
-AllowAllArgumentsOnNextLine: 'false'
-AllowAllConstructorInitializersOnNextLine: 'false'
-AllowAllParametersOfDeclarationOnNextLine: 'false'
+AlignTrailingComments: true
+AllowAllArgumentsOnNextLine: false
+AllowAllConstructorInitializersOnNextLine: false
+AllowAllParametersOfDeclarationOnNextLine: false
 AllowShortBlocksOnASingleLine: Empty
-AllowShortCaseLabelsOnASingleLine: 'false'
-AllowShortEnumsOnASingleLine: 'true'
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortEnumsOnASingleLine: true
 AllowShortFunctionsOnASingleLine: All
 AllowShortIfStatementsOnASingleLine: Never
 AllowShortLambdasOnASingleLine: All
-AllowShortLoopsOnASingleLine: 'true'
+AllowShortLoopsOnASingleLine: true
 AlwaysBreakAfterReturnType: None
-AlwaysBreakBeforeMultilineStrings: 'true'
-AlwaysBreakTemplateDeclarations: 'Yes'
-BinPackArguments: 'true'
-BinPackParameters: 'true'
+AlwaysBreakBeforeMultilineStrings: true
+AlwaysBreakTemplateDeclarations: Yes
+BinPackArguments: true
+BinPackParameters: true
 BitFieldColonSpacing: After
 BraceWrapping:
-    AfterCaseLabel: 'true'
-    AfterClass: 'true'
-    AfterControlStatement: 'false'
-    AfterEnum: 'true'
-    AfterFunction: 'true'
-    AfterNamespace: 'true'
-    AfterStruct: 'true'
-    AfterUnion: 'true'
-    AfterExternBlock: 'true'
-    BeforeCatch: 'false'
-    BeforeElse: 'false'
-    BeforeLambdaBody: 'false'
-    BeforeWhile: 'false'
-    IndentBraces: 'false'
-    SplitEmptyFunction: 'false'
-    SplitEmptyRecord: 'false'
-    SplitEmptyNamespace: 'false'
+    AfterCaseLabel: true
+    AfterClass: true
+    AfterControlStatement: false
+    AfterEnum: true
+    AfterFunction: true
+    AfterNamespace: true
+    AfterStruct: true
+    AfterUnion: true
+    AfterExternBlock: true
+    BeforeCatch: false
+    BeforeElse: false
+    BeforeLambdaBody: false
+    BeforeWhile: false
+    IndentBraces: false
+    SplitEmptyFunction: false
+    SplitEmptyRecord: false
+    SplitEmptyNamespace: false
 BreakBeforeBinaryOperators: None
 BreakBeforeBraces: Custom
-BreakBeforeTernaryOperators: 'false'
+BreakBeforeTernaryOperators: false
 BreakConstructorInitializers: AfterColon
 BreakInheritanceList: AfterColon
-BreakStringLiterals: 'true'
+BreakStringLiterals: true
 ColumnLimit: 0
-CompactNamespaces: 'false'
-ConstructorInitializerAllOnOneLineOrOnePerLine: 'false'
+CompactNamespaces: false
+ConstructorInitializerAllOnOneLineOrOnePerLine: false
 ConstructorInitializerIndentWidth: 4
 ContinuationIndentWidth: 4
-Cpp11BracedListStyle: 'false'
-DeriveLineEnding: 'true'
-DerivePointerAlignment: 'false'
-DisableFormat: 'false'
-FixNamespaceComments: 'false'
+Cpp11BracedListStyle: false
+DeriveLineEnding: true
+DerivePointerAlignment: false
+DisableFormat: false
+FixNamespaceComments: false
 IncludeBlocks: Preserve
-IndentCaseBlocks: 'true'
-IndentCaseLabels: 'false'
+IndentCaseBlocks: true
+IndentCaseLabels: false
 IndentExternBlock: Indent
-IndentGotoLabels: 'false'
+IndentGotoLabels: false
 IndentPPDirectives: AfterHash
 IndentWidth: 4
-IndentWrappedFunctionNames: 'true'
-KeepEmptyLinesAtTheStartOfBlocks: 'false'
+IndentWrappedFunctionNames: false
+KeepEmptyLinesAtTheStartOfBlocks: false
 Language: Cpp
 MaxEmptyLinesToKeep: 1
 NamespaceIndentation: All
 PointerAlignment: Left
-ReflowComments : 'false'
-SortIncludes: 'true'
-SortUsingDeclarations: 'true'
-SpaceAfterCStyleCast: 'false'
-SpaceAfterLogicalNot: 'false'
-SpaceAfterTemplateKeyword: 'true'
-SpaceBeforeAssignmentOperators: 'true'
-SpaceBeforeCpp11BracedList: 'false'
-SpaceBeforeCtorInitializerColon: 'true'
-SpaceBeforeInheritanceColon: 'true'
+ReflowComments: false
+SortIncludes: true
+SortUsingDeclarations: true
+SpaceAfterCStyleCast: false
+SpaceAfterLogicalNot: false
+SpaceAfterTemplateKeyword: true
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeCpp11BracedList: false
+SpaceBeforeCtorInitializerColon: true
+SpaceBeforeInheritanceColon: true
 SpaceBeforeParens: ControlStatements
-SpaceBeforeRangeBasedForLoopColon: 'true'
-SpaceBeforeSquareBrackets: 'false'
-SpaceInEmptyBlock: 'false'
-SpaceInEmptyParentheses: 'false'
+SpaceBeforeRangeBasedForLoopColon: true
+SpaceBeforeSquareBrackets: false
+SpaceInEmptyBlock: false
+SpaceInEmptyParentheses: false
 SpacesBeforeTrailingComments: 2
-SpacesInAngles: 'false'
-SpacesInCStyleCastParentheses: 'false'
-SpacesInConditionalStatement: 'false'
-SpacesInContainerLiterals: 'true'
-SpacesInParentheses: 'false'
-SpacesInSquareBrackets: 'false'
+SpacesInAngles: false
+SpacesInCStyleCastParentheses: false
+SpacesInConditionalStatement: false
+SpacesInContainerLiterals: true
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
 Standard: Latest
 TabWidth: 4
-UseCRLF: 'true'
+UseCRLF: true
 UseTab: AlignWithSpaces
+PenaltyBreakBeforeFirstCallParameter: 1000

.coderabbit.yaml

@@ -0,0 +1,23 @@
+# CodeRabbit AI Configuration
+
+# Only adding custom instructions for conventional commit suggestions
+instructions: |
+    When reviewing PRs, please provide suggestions for:
+
+    1. **Conventional Commit Titles** (if not following https://www.conventionalcommits.org/ or
+    if the existing title does not describe the code changes):
+       Format: type(scope): description
+       Length: 50 characters limit for title, 72 for body
+       Style: lowercase description, no ending period
+       Examples:
+       - feat(vr): add cross-eye sampling
+       - fix(water): resolve flowmap bug
+       - docs: update shader documentation
+
+    2. **Issue References** (if PR fixes bugs or implements features):
+       Suggest adding appropriate GitHub keywords:
+       - "Fixes #123" or "Closes #123" for bug fixes
+       - "Implements #123" or "Addresses #123" for features
+       - "Related to #123" for partial implementations
+
+    Otherwise, use your standard review approach focusing on code quality.

.github/configs/README.md

@@ -0,0 +1,76 @@
+# Build Configuration Files
+
+This directory contains configuration files used by the CI/CD pipeline for build validation and testing.
+
+## Files
+
+-   `shader-validation.yaml`: Configuration for shader compilation validation using hlslkit (Skyrim SE)
+-   `shader-validation-vr.yaml`: VR Configuration for shader compilation validation using hlslkit (Skyrim VR)
+
+## Generating Configuration Files
+
+These configuration files can be regenerated using the `generate-shader-configs.ps1` script in this directory. This script requires:
+
+1. A valid Skyrim installation (SE and/or VR)
+2. The [hlslkit](https://github.com/alandtse/hlslkit) package installed (`pip install hlslkit`)
+3. Community Shaders to be run once with specific settings to generate the required log data
+
+### Prerequisites
+
+Before running the generation script, you must run each version of Skyrim (SE and VR) **once** with the following Community Shaders settings:
+
+1. **Set Debug Log Level**: In the Community Shaders menu, set the log level to "Debug" or "Trace"
+2. **Clear Disk Cache**: Clear the shader disk cache before running
+3. **Enable Disk Cache**: Ensure disk cache is enabled and will be saved
+4. **Run the Game**: Launch and wait for compilation to complete to generate shader compilation logs
+
+The required log files will be created at:
+
+-   **Skyrim SE**: `%USERPROFILE%\Documents\My Games\Skyrim Special Edition\SKSE\CommunityShaders.log`
+-   **Skyrim VR**: `%USERPROFILE%\Documents\My Games\Skyrim VR\SKSE\CommunityShaders.log`
+
+### Running the Script
+
+```powershell
+# From the repository root
+.\.github\configs\generate-shader-configs.ps1
+
+# Or from the configs directory
+cd .github\configs
+.\generate-shader-configs.ps1
+```
+
+The script will:
+
+1. Detect available Skyrim installations
+2. Check for required log files
+3. Generate configuration files using hlslkit
+4. Update the files in `.github\configs\`
+
+### Manual Generation
+
+You can also generate the files manually using hlslkit:
+
+```bash
+# For Skyrim SE
+hlslkit-generate --log "%USERPROFILE%\Documents\My Games\Skyrim Special Edition\SKSE\CommunityShaders.log" --output .\.github\configs\shader-validation.yaml
+
+# For Skyrim VR
+hlslkit-generate --log "%USERPROFILE%\Documents\My Games\Skyrim VR\SKSE\CommunityShaders.log" --output .\.github\configs\shader-validation-vr.yaml
+```
+
+## Usage in CI/CD
+
+These files are automatically used by the GitHub Actions workflows during shader validation. They define:
+
+-   Common shader compilation defines
+-   Expected warnings (with suppression)
+-   Shader file configurations
+-   Compilation parameters
+
+The files should be regenerated when:
+
+-   New shaders are added to the project
+-   Shader compilation behavior changes
+-   New warnings need to be suppressed
+-   Build configurations are modified