updates

.clang-format

@@ -0,0 +1,124 @@
+# A complete list of style options can be found at:
+# https://clang.llvm.org/docs/ClangFormatStyleOptions.html
+#
+# Google C++ Style Guide
+# https://google.github.io/styleguide/cppguide.html
+
+# You can disable formatting of a piece of code like so:
+#
+# int formatted_code;
+# // clang-format off
+#     void    unformatted_code  ;
+# // clang-format on
+# void formatted_code_again;
+#
+
+Language: Cpp
+
+# Basic indentation and spacing rules:
+IndentWidth: 4
+ContinuationIndentWidth: 4
+UseCRLF: false
+Standard: c++20
+UseTab: Never
+MaxEmptyLinesToKeep: 1
+
+AccessModifierOffset: -4
+AlignAfterOpenBracket: AlwaysBreak
+AlignConsecutiveAssignments: true
+AlignConsecutiveDeclarations: false
+AlignConsecutiveMacros: true
+AlignEscapedNewlinesLeft: true
+AlignOperands: true
+AlignTrailingComments: true
+AllowAllParametersOfDeclarationOnNextLine: true
+AllowShortFunctionsOnASingleLine: Empty
+AllowShortBlocksOnASingleLine: true
+AllowShortIfStatementsOnASingleLine: false
+AllowShortLoopsOnASingleLine: false
+AllowShortLambdasOnASingleLine: Empty
+AllowShortCaseLabelsOnASingleLine: false
+AlwaysBreakBeforeMultilineStrings: true
+AlwaysBreakTemplateDeclarations: Yes
+
+# Configure each individual brace in BraceWrapping
+BraceWrapping:
+  AfterCaseLabel:        false
+  AfterClass:            true
+  AfterControlStatement: false
+  AfterEnum:             true
+  AfterFunction:         true
+  AfterNamespace:        true
+  AfterObjCDeclaration:  true
+  AfterStruct:           true
+  AfterUnion:            true
+  BeforeCatch:           false
+  BeforeElse:            false
+  IndentBraces:          false
+BreakBeforeBraces: Custom
+
+BinPackArguments: false
+BinPackParameters: false
+BreakBeforeBinaryOperators: false
+BreakBeforeTernaryOperators: false
+BreakConstructorInitializers: AfterColon
+BreakInheritanceList: AfterColon
+ColumnLimit: 120
+CompactNamespaces: true
+ConstructorInitializerAllOnOneLineOrOnePerLine: true
+ConstructorInitializerIndentWidth: 4
+Cpp11BracedListStyle: true
+DeriveLineEnding: true
+ExperimentalAutoDetectBinPacking: true
+FixNamespaceComments: true
+IndentCaseLabels: false
+IndentGotoLabels: false
+IndentPPDirectives: BeforeHash
+IndentFunctionDeclarationAfterType: false
+NamespaceIndentation: All
+ObjCSpaceBeforeProtocolList: false
+PenaltyBreakBeforeFirstCallParameter: 10
+PenaltyBreakComment: 60
+PenaltyBreakFirstLessLess: 20
+PenaltyBreakString: 1000
+PenaltyExcessCharacter: 1000000
+PenaltyReturnTypeOnItsOwnLine: 200
+SpaceAfterControlStatementKeyword: true
+SpaceBeforeParens: ControlStatements
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeRangeBasedForLoopColon: true
+SpaceBeforeSquareBrackets: false
+SpacesInAngles: false
+SpaceInEmptyBlock: true
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 1
+SpacesInCStyleCastParentheses: false
+SpacesInConditionalStatement: false
+SpacesInContainerLiterals: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+
+# int* value instead of int *value
+DerivePointerAlignment: false
+PointerAlignment: Left
+PointerBindsToType: true
+SpaceAroundPointerQualifiers: After
+
+# Prefer "east const", placing `const` after the type: int const instead of const int
+QualifierAlignment: Right
+
+SortIncludes: true
+IncludeBlocks: Regroup
+IncludeCategories:
+  # Headers in <> from specific external libraries.
+  - Regex:      '^<(fmt|gtest|gmock|SDL|spdlog|allegro)(\/)?([A-Za-z0-9.\/-_])+>'
+    Priority:   3
+  - Regex:      '^<fifechan/widgets/.*\.hpp>$'
+    Priority:   4
+  - Regex:      '^<fifechan/.*\.hpp>$'
+    Priority:   5
+  - Regex:      '^<[a-z0-9_]*\.hpp>$'
+    Priority:   6
+  # C++ standard library. These includes are all lowercase.
+  - Regex:      '^<[a-z0-9_]*>$'
+    Priority:   7

.clang-tidy

@@ -0,0 +1,46 @@
+#
+# clang-tidy configuration file.
+#
+# https://clang.llvm.org/extra/clang-tidy/
+# https://clang.llvm.org/extra/clang-tidy/checks/list.html
+#
+Checks: >
+  -*,
+  bugprone-*,
+  -bugprone-easily-swappable-parameters,
+  -bugprone-narrowing-conversions,
+  clang-diagnostic-*,
+  -clang-analyzer-*,
+  cert-err34-c,
+  cppcoreguidelines-*,
+  -cppcoreguidelines-avoid-non-const-global-variables,
+  -cppcoreguidelines-avoid-magic-numbers,
+  -cppcoreguidelines-narrowing-conversions,
+  -cppcoreguidelines-pro-bounds-constant-array-index,
+  -cppcoreguidelines-non-private-member-variables-in-classes,
+  -cppcoreguidelines-pro-type-union-access,
+  google-explicit-constructor,
+  misc*,
+  misc-uniqueptr-reset-release,
+  -misc-no-recursion,
+  -misc-include-cleaner,
+  -misc-non-private-member-variables-in-classes,
+  modernize*,
+  -modernize-use-auto,
+  -modernize-use-trailing-return-type,
+  -modernize-use-nodiscard,
+  performance-*,
+  portability-*,
+  readability-*,
+  -readability-identifier-length,
+  -readability-magic-numbers,
+  -readability-function-cognitive-complexity,
+  -readability-convert-member-functions-to-static
+
+WarningsAsErrors: >
+  clang-analyzer-security.*
+# Analyze only headers under include/ and not system headers.
+HeaderFilterRegex: '^include/.*'
+SystemHeaders: false
+# Use our .clang-format file when applying fixes.
+FormatStyle: file

.devcontainer/devcontainer.json

@@ -0,0 +1,25 @@
+{
+  "name": "Fife DevBox",
+  "image": "ghcr.io/jakoch/cpp-devbox:trixie-latest",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        // EditorConfig
+        "EditorConfig.EditorConfig",
+        // Git + Github
+        "GitHub.vscode-pull-request-github",
+        // C++
+        "ms-vscode.cpptools",
+        "ms-vscode.cpptools-extension-pack",
+        "ms-vscode.cpptools-themes",
+        // CMake
+        "ms-vscode.cmake-tools",
+        "twxs.cmake",
+        // Testing
+        "matepek.vscode-catch2-test-adapter",
+        "ms-vscode.test-adapter-converter",
+        "hbenl.vscode-test-explorer"
+      ]
+    }
+  }
+}

.editorconfig

@@ -0,0 +1,40 @@
+# This file configures editors using the EditorConfig scheme.
+# https://editorconfig.org/
+
+# Guideline support for "Visual Studio 2022" IDE using extension: "PaulHarrington.EditorGuidelinesPreview"
+# https://marketplace.visualstudio.com/items?itemName=PaulHarrington.EditorGuidelinesPreview
+
+# Editorconfig support for "VSCode" using extension: "editorconfig.editorconfig"
+# https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+insert_final_newline = true
+
+# "visual studio" specific
+spelling_languages = en-us
+guidelines = 80 dashed, 130
+
+[CMakeLists.txt, *.{cmake}]
+indent_size = 2
+
+[*.{c,cc,cpp,h,hpp,hxx,inl}]
+indent_size = 4
+trim_trailing_whitespace = true
+# "visual studio" specific
+vc_generate_documentation_comments = doxygen_slash_star
+
+[*.{json,yaml,yml}]
+indent_size = 2
+insert_final_newline = false
+
+[*.{md,markdown}]
+indent_size = 4
+trim_trailing_whitespace = false
+
+[*.{clang-format}]
+indent_size = 2

.gitattributes

@@ -0,0 +1,6 @@
+* eol=lf
+*.png binary
+*.xcf binary
+*.bmp binary
+*.exe binary
+*.ttf binary

.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,3 @@
+# Contributor Covenant Code of Conduct
+
+Please be nice and contribute positively to the project.

.github/CONTRIBUTING.md

@@ -0,0 +1,15 @@
+# Contributing to this project
+
+Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
+
+# Reporting Issues
+
+When reporting issues, please try to be as descriptive as possible, and include as much relevant information as you can. A step by step guide on how to reproduce the issue will greatly increase the chances of your issue being resolved in a timely manner.
+
+# Contributing policy
+
+Fork the project, create a feature branch, and send us a pull request.
+
+To ensure a consistent code base, you should make sure the code follows the used standards.
+
+If you would like to help, take a look at the list of open issues.

.github/FUNDING.yml

@@ -0,0 +1,12 @@
+# These are supported funding model platforms
+
+github: LinuxDonald # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+otechie: # Replace with a single Otechie username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,5 @@
+<!-- Please remember to select the appropriate branch:
+
+For bug fixes pick the oldest branch where the fix applies.
+
+For new features and everything else, use the main branch. Thank you. <3 -->

.github/dependabot.yml

@@ -0,0 +1,18 @@
+# dependabot.yml
+#
+# Dependabot updates dependencies automatically to their latest versions.
+#
+# Docs: https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+
+updates:
+  # Enable automatic version updates for Github Actions
+  - package-ecosystem: "github-actions"
+    # Look for `.github/workflows` in the `root` directory
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    ignore:
+      # ignore all updates for "https://github.com/actions/github-script"
+      - dependency-name: "github-script"