API Style Update (December 2025)

API Style Update

Author: jamon-bailey

.clang-format

@@ -1,140 +1,189 @@
 ---
 Language:        Cpp
+# BasedOnStyle:  Microsoft
 
 DisableFormat:   false
 
-# GENERAL INDENTATION
-UseTab: Never
-TabWidth: 4
-IndentWidth: 4
-
 AccessModifierOffset: -2
-
 AlignAfterOpenBracket: BlockIndent
 AlignArrayOfStructures: Right
+
 AlignConsecutiveAssignments:
-  Enabled: true
-  AcrossEmptyLines: true
-  AcrossComments: false
-  AlignCompound: false
+  Enabled:         true
+  AcrossEmptyLines: false
+  AcrossComments:  false
+  AlignCompound:   false
   AlignFunctionPointers: false
-  PadOperators: true
+  PadOperators:    true
+
+AlignConsecutiveBitFields:
+  Enabled:         false
+  AcrossEmptyLines: false
+  AcrossComments:  false
+  AlignCompound:   false
+  AlignFunctionPointers: false
+  PadOperators:    false
+
+AlignConsecutiveDeclarations:
+  Enabled:         false
+  AcrossEmptyLines: false
+  AcrossComments:  false
+  AlignCompound:   false
+  AlignFunctionPointers: false
+  PadOperators:    false
+
 AlignConsecutiveMacros:
-  Enabled: true
-  AcrossEmptyLines: true
-  AcrossComments: false
-  AlignCompound: false
+  Enabled:         false
+  AcrossEmptyLines: false
+  AcrossComments:  false
+  AlignCompound:   false
   AlignFunctionPointers: false
-  PadOperators: false
+  PadOperators:    false
+
+AlignConsecutiveShortCaseStatements:
+  Enabled:         false
+  AcrossEmptyLines: false
+  AcrossComments:  false
+  AlignCaseColons: false
+
 AlignEscapedNewlines: Right
-AlignOperands: Align
+AlignOperands:   Align
+
 AlignTrailingComments:
-  Kind: Always
-  OverEmptyLines: 2
+  Kind:            Always
+  OverEmptyLines:  2
 
 AllowAllArgumentsOnNextLine: true
 AllowAllParametersOfDeclarationOnNextLine: true
-AllowBreakBeforeNoexceptSpecifier: Always
-AllowShortBlocksOnASingleLine: Never
+AllowBreakBeforeNoexceptSpecifier: Never
+AllowShortBlocksOnASingleLine: Empty
 AllowShortCaseLabelsOnASingleLine: false
-AllowShortCompoundRequirementOnASingleLine: false
+AllowShortCompoundRequirementOnASingleLine: true
 AllowShortEnumsOnASingleLine: true
-AllowShortFunctionsOnASingleLine: InlineOnly
+AllowShortFunctionsOnASingleLine: None
 AllowShortIfStatementsOnASingleLine: Never
-AllowShortLambdasOnASingleLine: All
+AllowShortLambdasOnASingleLine: Empty
 AllowShortLoopsOnASingleLine: false
-
-AlwaysBreakAfterReturnType: None
+#AllowShortNamespacesOnASingleLine: true
 AlwaysBreakAfterDefinitionReturnType: None
-AlwaysBreakBeforeMultilineStrings: false
+AlwaysBreakAfterReturnType: None
+AlwaysBreakBeforeMultilineStrings: true
 AlwaysBreakTemplateDeclarations: true
 
+# AttributeMacros:
+#   - __capability
+
 BinPackArguments: false
-BinPackParameters: false
+BinPackParameters: true
+BitFieldColonSpacing: Both
 
 BreakBeforeBraces: Custom
 BraceWrapping:
-  AfterCaseLabel: true
-  AfterClass: false
+  AfterCaseLabel:  true
+  AfterClass:      false
   AfterControlStatement: false
-  AfterEnum: false
+  AfterEnum:       false
   AfterExternBlock: true
-  AfterFunction: true
-  AfterNamespace: true
-  AfterStruct: false
-  AfterUnion: false
-  BeforeCatch: false
-  BeforeElse: false
+  AfterFunction:   true
+  AfterNamespace:  true
+  AfterStruct:     false
+  AfterUnion:      false
+  BeforeCatch:     false
+  BeforeElse:      false
   BeforeLambdaBody: true
-  BeforeWhile: false
-  IndentBraces: false
+  BeforeWhile:     false
+  IndentBraces:    false
   SplitEmptyFunction: false
   SplitEmptyRecord: false
-  SplitEmptyNamespace: true
+  SplitEmptyNamespace: false
+
 BreakAdjacentStringLiterals: true
-BreakAfterAttributes: Never
-#BreakAfterReturnType: Automatic
+BreakAfterAttributes: Leave
+BreakArrays:     true
 BreakBeforeBinaryOperators: None
 BreakBeforeConceptDeclarations: Always
+BreakBeforeInlineASMColon: OnlyMultiline
 BreakBeforeTernaryOperators: false
 BreakConstructorInitializers: BeforeColon
 BreakInheritanceList: AfterColon
 BreakStringLiterals: true
-
-ColumnLimit: 95
+ColumnLimit:     95
+CommentPragmas:  '^ IWYU pragma:'
 CompactNamespaces: false
 ConstructorInitializerIndentWidth: 4
 ContinuationIndentWidth: 4
-Cpp11BracedListStyle: false
-
+Cpp11BracedListStyle: true
 DerivePointerAlignment: false
-
 EmptyLineAfterAccessModifier: Never
-EmptyLineBeforeAccessModifier: Always
-ExperimentalAutoDetectBinPacking: true
-
+EmptyLineBeforeAccessModifier: LogicalBlock
+ExperimentalAutoDetectBinPacking: false
 FixNamespaceComments: true
 
-IncludeBlocks: Preserve
+# ForEachMacros:
+#   - foreach
+#   - Q_FOREACH
+#   - BOOST_FOREACH
+# IfMacros:
+#   - KJ_IF_MAYBE
+
+IncludeCategories:
+  - Regex:           '^"(llvm|llvm-c|clang|clang-c)/'
+    Priority:        2
+    SortPriority:    0
+    CaseSensitive:   false
+  - Regex:           '^(<|"(gtest|gmock|isl|json)/)'
+    Priority:        3
+    SortPriority:    0
+    CaseSensitive:   false
+  - Regex:           '.*'
+    Priority:        1
+    SortPriority:    0
+    CaseSensitive:   false
+
+IncludeIsMainRegex: '(Test)?$'
+IncludeIsMainSourceRegex: ''
+IncludeBlocks:   Preserve
 IndentAccessModifiers: false
 IndentCaseBlocks: false
 IndentCaseLabels: false
 IndentExternBlock: NoIndent
-IndentGotoLabels: false
-IndentPPDirectives: BeforeHash
-IndentRequiresClause: false
+IndentGotoLabels: true
+IndentPPDirectives: AfterHash
+IndentRequiresClause: true
+IndentWidth:     4
 IndentWrappedFunctionNames: false
-InsertBraces: false
+InsertBraces:    false
+InsertNewlineAtEOF: false
 InsertTrailingCommas: None
+
 IntegerLiteralSeparator:
-  Binary: 0
-  Decimal: 3
-  Hex: 4
+  Binary:          0
+  Decimal:         3
+  Hex:             4
 
+KeepEmptyLinesAtTheStartOfBlocks: false
+KeepEmptyLinesAtEOF: true
 LambdaBodyIndentation: Signature
-
+LineEnding:      DeriveLF
+MacroBlockBegin: ''
+MacroBlockEnd:   ''
 MaxEmptyLinesToKeep: 2
-
-NamespaceIndentation: All
-
+NamespaceIndentation: None
 PackConstructorInitializers: BinPack
 PointerAlignment: Left
-PPIndentWidth: -1
-
+PPIndentWidth:   -1
 QualifierAlignment: Leave
-
 ReferenceAlignment: Pointer
-ReflowComments: true
+ReflowComments:  true
+RemoveBracesLLVM: false
 RemoveParentheses: Leave
 RemoveSemicolon: false
-#RequiresClausePosition: OwnLineWithBrace
+RequiresClausePosition: OwnLine
 RequiresExpressionIndentation: OuterScope
-
 SeparateDefinitionBlocks: Always
-ShortNamespaceLines: 3
-#SortIncludes:
-#  Enabled: true
-#  IgnoreCase: false
+ShortNamespaceLines: 1
+SkipMacroDefinitionBody: false
+SortIncludes:    CaseSensitive
 SortUsingDeclarations: LexicographicNumeric
 SpaceAfterCStyleCast: false
 SpaceAfterLogicalNot: false
@@ -145,35 +194,67 @@ SpaceBeforeCaseColon: false
 SpaceBeforeCpp11BracedList: false
 SpaceBeforeCtorInitializerColon: true
 SpaceBeforeInheritanceColon: true
+SpaceBeforeJsonColon: false
+
 SpaceBeforeParens: Custom
 SpaceBeforeParensOptions:
   AfterControlStatements: true
   AfterForeachMacros: true
   AfterFunctionDefinitionName: false
   AfterFunctionDeclarationName: false
-  AfterIfMacros: true
+  AfterIfMacros:   true
   AfterOverloadedOperator: false
   AfterPlacementOperator: true
   AfterRequiresInClause: false
   AfterRequiresInExpression: false
   BeforeNonEmptyParentheses: false
+
 SpaceBeforeRangeBasedForLoopColon: true
 SpaceBeforeSquareBrackets: false
 SpaceInEmptyBlock: true
 SpacesBeforeTrailingComments: 1
+SpacesInAngles:  Never
+SpacesInContainerLiterals: true
 
-# PENALTIES:
-PenaltyReturnTypeOnItsOwnLine: 10000
-PenaltyBreakTemplateDeclaration: 10000
-#PenaltyBreakBeforeMemberAccess: 10000
-PenaltyBreakAssignment: 800
-PenaltyBreakScopeResolution: 500
+SpacesInLineCommentPrefix:
+  Minimum:         1
+  Maximum:         -1
+
+SpacesInParens:  Never
+SpacesInParensOptions:
+  InCStyleCasts:   false
+  InConditionalStatements: false
+  InEmptyParentheses: false
+  Other:           false
+
+SpacesInSquareBrackets: false
+Standard:        Latest
+TabWidth:        4
+UseTab:          Never
+VerilogBreakBetweenInstancePorts: true
+
+# StatementAttributeLikeMacros:
+#   - Q_EMIT
+
+# StatementMacros:
+#   - Q_UNUSED
+#   - QT_REQUIRE_VERSION
+
+# WhitespaceSensitiveMacros:
+#   - BOOST_PP_STRINGIZE
+#   - CF_SWIFT_NAME
+#   - NS_SWIFT_NAME
+#   - PP_STRINGIZE
+#   - STRINGIZE
+
+PenaltyBreakAssignment: 2
+PenaltyBreakBeforeFirstCallParameter: 10
 PenaltyBreakComment: 500
 PenaltyBreakFirstLessLess: 120
-PenaltyExcessCharacter: 100
-PenaltyBreakBeforeFirstCallParameter: 10
-PenaltyBreakString: 10
-PenaltyBreakOpenParenthesis: 10
+PenaltyBreakOpenParenthesis: 0
+PenaltyBreakScopeResolution: 500
+PenaltyBreakString: 100
+PenaltyBreakTemplateDeclaration: 10
+PenaltyExcessCharacter: 1000000
 PenaltyIndentedWhitespace: 0
-
-...
+PenaltyReturnTypeOnItsOwnLine: 10000

.clang-tidy

@@ -0,0 +1,33 @@
+Checks: >
+    -*,
+    misc-*,
+    cert-*,
+    bugprone-*,
+    cppcoreguidelines-*,
+    modernize-*,
+    performance-*,
+    portability-*,
+    readability-*,
+    
+    # Explicitly disable some checks that might be noisy
+    -cppcoreguidelines-avoid-magic-numbers,
+    -cppcoreguidelines-pro-type-member-init,
+    -modernize-use-auto,
+    -cppcoreguidelines-pro-bounds-pointer-arithmetic,
+    -modernize-use-trailing-return-type,
+    -readability-function-size,
+    -readability-magic-numbers,
+    -readability-identifier-length,
+    -readability-avoid-const-params-in-decls,
+    
+WarningsAsErrors: ''
+
+FormatStyle: none
+
+# CheckOptions:
+    
+HeaderFilterRegex: ''
+
+SystemHeaders: false
+
+InheritParentConfig: false

.github/disabled_workflows/linux-build.yml

@@ -17,7 +17,12 @@ jobs:
         fail-fast: false
 
         matrix:
-            cmake_preset: ["linux-x64-Debug", "linux-x64-Release"]
+            cmake_preset: [
+              "linux-x64-gcc-debug",
+              "linux-x64-clang-debug",
+              "linux-x64-gcc-release",
+              "linux-x64-clang-release"
+            ]
 
     steps:
         - name: Checkout Repository

.github/disabled_workflows/macos-build.yml

@@ -17,7 +17,7 @@ jobs:
         fail-fast: false
 
         matrix:
-            cmake_preset: ["macos-x64-Debug", "macos-x64-Release"]
+            cmake_preset: ["macos-x64-clang-debug", "macos-x64-clang-release"]
 
     steps:
         - name: Checkout Repository