fix: address Codex review (exit codes, partial staging, PowerShell)

- Propagate clang-format/xargs/docker exit codes in format_run_src and format_files_inplace; fix_formatting.sh exits with the real status. - Check $LASTEXITCODE after native clang-format in fix_formatting.ps1. - Pre-commit: git stash --keep-index before format so git add does not pull in unstaged hunks; restore stash after. Co-authored-by: Cursor <cursoragent@cursor.com>
fix: consolidate format helpers and batch pre-commit Docker runs
2026-07-27 16:47:11 -07:00 · 2026-05-15 21:19:28 +03:00 · 2026-05-15 16:13:40 +03:00 · 2026-05-15 16:03:25 +03:00 · 2026-05-15 15:58:27 +03:00 · 2026-05-15 15:47:36 +03:00
196 changed files with 5156 additions and 13228 deletions
@@ -1,3 +1,197 @@
-BasedOnStyle: WebKit
+# ------------------------------------------------------------------------------
+# Formatting is pinned to clang-format 14 — run ./fix_formatting.sh or fix_formatting.ps1.
+#
+# clang-format has NO version conditionals and NO "ignore unknown keys" mode:
+# an older binary errors out if this file contains options it does not know.
+#
+# The same .clang-format also does NOT guarantee the same output across versions:
+# clang-format 17+ uses different rules (e.g. spaces inside #define bodies).
+# With THIS file, versions 14 / 15 / 16 match each other; 17+ may still differ.
+# ------------------------------------------------------------------------------
+
+AccessModifierOffset: -4
+AlignAfterOpenBracket: DontAlign
+AlignArrayOfStructures: None
+AlignConsecutiveMacros: None
+AlignConsecutiveAssignments: None
+AlignConsecutiveBitFields: None
+AlignConsecutiveDeclarations: None
+AlignEscapedNewlines: Right
+AlignOperands:   DontAlign
+AlignTrailingComments: false
+AllowAllArgumentsOnNextLine: true
+AllowAllParametersOfDeclarationOnNextLine: true
+AllowShortEnumsOnASingleLine: true
+AllowShortBlocksOnASingleLine: Empty
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: All
+AllowShortLambdasOnASingleLine: All
 AllowShortIfStatementsOnASingleLine: WithoutElse
+AllowShortLoopsOnASingleLine: false
+AlwaysBreakAfterDefinitionReturnType: None
+AlwaysBreakAfterReturnType: None
+AlwaysBreakBeforeMultilineStrings: false
+AlwaysBreakTemplateDeclarations: MultiLine
+AttributeMacros:
+  - __capability
+BinPackArguments: true
+BinPackParameters: true
+BraceWrapping:
+  AfterCaseLabel:  false
+  AfterClass:      false
+  AfterControlStatement: Never
+  AfterEnum:       false
+  AfterFunction:   true
+  AfterNamespace:  false
+  AfterObjCDeclaration: false
+  AfterStruct:     false
+  AfterUnion:      false
+  AfterExternBlock: false
+  BeforeCatch:     false
+  BeforeElse:      false
+  BeforeLambdaBody: false
+  BeforeWhile:     false
+  IndentBraces:    false
+  SplitEmptyFunction: true
+  SplitEmptyRecord: true
+  SplitEmptyNamespace: true
+BreakBeforeBinaryOperators: All
+BreakBeforeConceptDeclarations: true
+BreakBeforeBraces: WebKit
+BreakBeforeInheritanceComma: false
+BreakInheritanceList: BeforeColon
+BreakBeforeTernaryOperators: true
+BreakConstructorInitializersBeforeComma: false
+BreakConstructorInitializers: BeforeComma
+BreakAfterJavaFieldAnnotations: false
+BreakStringLiterals: true
+ColumnLimit:     0
+CommentPragmas:  '^ IWYU pragma:'
+QualifierAlignment: Leave
+CompactNamespaces: false
+ConstructorInitializerIndentWidth: 4
+ContinuationIndentWidth: 4
+Cpp11BracedListStyle: false
+DeriveLineEnding: true
+DerivePointerAlignment: false
+DisableFormat:   false
+EmptyLineAfterAccessModifier: Never
+EmptyLineBeforeAccessModifier: LogicalBlock
+ExperimentalAutoDetectBinPacking: false
+PackConstructorInitializers: BinPack
+AllowAllConstructorInitializersOnNextLine: true
 FixNamespaceComments: true
+ForEachMacros:
+  - foreach
+  - Q_FOREACH
+  - BOOST_FOREACH
+IfMacros:
+  - KJ_IF_MAYBE
+IncludeBlocks:   Preserve
+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: ''
+IndentAccessModifiers: false
+IndentCaseLabels: false
+IndentCaseBlocks: false
+IndentGotoLabels: true
+IndentPPDirectives: None
+IndentExternBlock: AfterExternBlock
+IndentRequires:  false
+IndentWidth:     4
+IndentWrappedFunctionNames: false
+InsertTrailingCommas: None
+JavaScriptQuotes: Leave
+JavaScriptWrapImports: true
+KeepEmptyLinesAtTheStartOfBlocks: true
+LambdaBodyIndentation: Signature
+MacroBlockBegin: ''
+MacroBlockEnd:   ''
+MaxEmptyLinesToKeep: 1
+NamespaceIndentation: Inner
+ObjCBinPackProtocolList: Auto
+ObjCBlockIndentWidth: 4
+ObjCBreakBeforeNestedBlockParam: true
+ObjCSpaceAfterProperty: true
+ObjCSpaceBeforeProtocolList: true
+PenaltyBreakAssignment: 2
+PenaltyBreakBeforeFirstCallParameter: 19
+PenaltyBreakComment: 300
+PenaltyBreakFirstLessLess: 120
+PenaltyBreakOpenParenthesis: 0
+PenaltyBreakString: 1000
+PenaltyBreakTemplateDeclaration: 10
+PenaltyExcessCharacter: 1000000
+PenaltyReturnTypeOnItsOwnLine: 60
+PenaltyIndentedWhitespace: 0
+PointerAlignment: Left
+PPIndentWidth:   -1
+ReferenceAlignment: Pointer
+ReflowComments:  true
+RemoveBracesLLVM: false
+SeparateDefinitionBlocks: Leave
+ShortNamespaceLines: 1
+SortIncludes:    CaseSensitive
+SortJavaStaticImport: Before
+SortUsingDeclarations: true
+SpaceAfterCStyleCast: false
+SpaceAfterLogicalNot: false
+SpaceAfterTemplateKeyword: true
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeCaseColon: false
+SpaceBeforeCpp11BracedList: true
+SpaceBeforeCtorInitializerColon: true
+SpaceBeforeInheritanceColon: true
+SpaceBeforeParens: ControlStatements
+SpaceBeforeParensOptions:
+  AfterControlStatements: true
+  AfterForeachMacros: true
+  AfterFunctionDefinitionName: false
+  AfterFunctionDeclarationName: false
+  AfterIfMacros:   true
+  AfterOverloadedOperator: false
+  BeforeNonEmptyParentheses: false
+SpaceAroundPointerQualifiers: Default
+SpaceBeforeRangeBasedForLoopColon: true
+SpaceInEmptyBlock: true
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 1
+SpacesInAngles:  Never
+SpacesInConditionalStatement: false
+SpacesInContainerLiterals: true
+SpacesInCStyleCastParentheses: false
+SpacesInLineCommentPrefix:
+  Minimum:         1
+  Maximum:         -1
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+SpaceBeforeSquareBrackets: false
+BitFieldColonSpacing: Both
+Standard:        Latest
+StatementAttributeLikeMacros:
+  - Q_EMIT
+StatementMacros:
+  - Q_UNUSED
+  - QT_REQUIRE_VERSION
+TabWidth:        8
+UseCRLF:         false
+UseTab:          Never
+WhitespaceSensitiveMacros:
+  - STRINGIZE
+  - PP_STRINGIZE
+  - BOOST_PP_STRINGIZE
+  - NS_SWIFT_NAME
+  - CF_SWIFT_NAME
+
@@ -14,6 +14,8 @@
 *.xml text eol=lf
 *.yml text eol=lf
 .clang-format text eol=lf
+.githooks/* text eol=lf
+scripts/format-common.sh text eol=lf
 .editorconfig text eol=lf
 .gitattributes text eol=lf
 .gitignore text eol=lf
@@ -0,0 +1,67 @@
+#!/bin/sh
+# Format staged *.cc / *.h with clang-format 14 before commit.
+# IDE-agnostic: runs for any `git commit` (CLI, VS, CLion, etc.).
+# If clang-format 14 is unavailable, prints a warning and does not block the commit.
+
+set -u
+
+ROOT=$(git rev-parse --show-toplevel) || exit 0
+cd "$ROOT" || exit 0
+
+# shellcheck source=scripts/format-common.sh
+. "$ROOT/scripts/format-common.sh"
+
+HOOK_STASHED=0
+
+hook_cleanup() {
+    if [ "$HOOK_STASHED" -eq 1 ]; then
+        git stash pop -q 2>/dev/null || git stash pop -q 2>/dev/null || true
+        HOOK_STASHED=0
+    fi
+}
+
+list=$(mktemp "${TMPDIR:-/tmp}/f2ce-fmt.XXXXXX") || exit 0
+trap 'rm -f "$list"; hook_cleanup' EXIT INT HUP
+
+git diff --cached --name-only --diff-filter=ACM |
+    grep -E '\.(cc|h)$' >"$list" 2>/dev/null || true
+
+if [ ! -s "$list" ]; then
+    exit 0
+fi
+
+set --
+while IFS= read -r file || [ -n "$file" ]; do
+    [ -z "$file" ] && continue
+    [ -f "$file" ] || continue
+    set -- "$@" "$file"
+done <"$list"
+
+if [ "$#" -eq 0 ]; then
+    exit 0
+fi
+
+# Hide unstaged edits so `git add` only updates already-staged hunks (git add -p safe).
+if ! git diff --quiet; then
+    if git stash push --keep-index -q -m "f2ce-pre-commit-format"; then
+        HOOK_STASHED=1
+    fi
+fi
+
+format_rc=0
+format_files_inplace "$@" || format_rc=$?
+
+if [ "$format_rc" -ne 0 ]; then
+    hook_cleanup
+    if [ "$format_rc" -eq 1 ] && ! format_find_clang_format >/dev/null 2>&1 && ! format_have_docker; then
+        format_print_hook_warning
+    else
+        format_print_hook_format_failed
+    fi
+    exit 0
+fi
+
+git add "$@"
+hook_cleanup
+
+exit 0
@@ -15,7 +15,9 @@

 **Important Notes** 

- *Preview builds are not available for pull requests from forked repositories.* To enable preview builds, submit the PR from a branch within this repository. 
+- *Preview builds are not available for pull requests from forked repositories.* To enable preview builds, submit the PR from a branch within this repository.
+
+- **Formatting:** Run `./fix_formatting.sh` (Linux/macOS/Git Bash) or `.\fix_formatting.ps1` (Windows) before pushing. Optional: `git config --local core.hooksPath .githooks` once per clone to format staged `*.cc`/`*.h` on commit (warn-only if clang-format 14 is missing).

 --->

@@ -22,12 +22,17 @@ jobs:
          ref: ${{ github.head_ref || github.ref_name  }}
          token: ${{ secrets.PAT_FOR_ACTIONS }}

-      - name: Run clang-format via Docker
+      - name: Install clang-format 14
        run: |
-          docker run --rm \
-            -v ${{ github.workspace }}:/app --workdir /app  \
-            --user $(id -u):$(id -g) silkeh/clang:18 \
-            bash -c 'find src -type f \( -name "*.cc" -o -name "*.h" \) -print0 | xargs -0 clang-format -i'
+          sudo apt-get update
+          if apt-cache show clang-format-14 &>/dev/null; then
+            sudo apt-get install -y clang-format-14
+          else
+            sudo apt-get install -y clang-format
+          fi
+
+      - name: Run clang-format
+        run: ./fix_formatting.sh


      # https://github.com/actions/checkout?tab=readme-ov-file#push-a-commit-to-a-pr-using-the-built-in-token
@@ -46,9 +46,17 @@ jobs:
      - name: Clone
        uses: actions/checkout@v4

-      - name: Show clang-format version
+      - name: Install clang-format 14
        run: |
-          clang-format --version
+          sudo apt-get update
+          if apt-cache show clang-format-14 &>/dev/null; then
+            sudo apt-get install -y clang-format-14
+          else
+            sudo apt-get install -y clang-format
+          fi
+
+      - name: Show clang-format version
+        run: ./fix_formatting.sh --version

      - name: clang-format
        run: |
@@ -59,7 +67,7 @@ jobs:
            if gh pr view ${{ github.event.pull_request.number }} --repo "${{ github.repository }}" --json labels --jq '.labels[].name' | grep -q "skip-formatting"; then
              echo "skip-formatting label found - do not raise error"
              echo "==============================="
-              find src -type f \( -name \*.cc -o -name \*.h \) | xargs clang-format --dry-run
+              ./fix_formatting.sh --dry-run
              exit 0
            fi
            echo "skip-formatting label not found - raise error if formatting is not correct"
@@ -67,12 +75,61 @@ jobs:
            echo "Not a PR, do not check labels"
          fi

-          find src -type f \( -name \*.cc -o -name \*.h \) | xargs clang-format --dry-run --Werror
+          ./fix_formatting.sh --check

          echo "Code is formatted correctly"
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

+  code-format-macos:
+    name: Code format check (macOS script)
+
+    runs-on: macos-latest
+
+    steps:
+      - name: Clone
+        uses: actions/checkout@v4
+
+      - name: Install clang-format 14
+        run: |
+          brew install llvm@14
+          echo "$(brew --prefix llvm@14)/bin" >> "$GITHUB_PATH"
+
+      - name: Verify fix_formatting.sh
+        run: |
+          ./fix_formatting.sh --version
+          ./fix_formatting.sh --check
+
+      - name: Verify git pre-commit hook
+        run: |
+          git config --local core.hooksPath .githooks
+          .githooks/pre-commit
+
+  code-format-windows:
+    name: Code format check (Windows script)
+
+    runs-on: windows-latest
+
+    steps:
+      - name: Clone
+        uses: actions/checkout@v4
+
+      - name: Install LLVM 14 (clang-format)
+        shell: pwsh
+        run: |
+          $installer = "$env:RUNNER_TEMP\LLVM-14.0.6-win64.exe"
+          Invoke-WebRequest `
+            -Uri "https://github.com/llvm/llvm-project/releases/download/llvmorg-14.0.6/LLVM-14.0.6-win64.exe" `
+            -OutFile $installer
+          Start-Process -FilePath $installer -ArgumentList "/S" -Wait
+          "C:\Program Files\LLVM\bin" >> $env:GITHUB_PATH
+
+      - name: Verify fix_formatting.ps1
+        shell: pwsh
+        run: |
+          .\fix_formatting.ps1 --version
+          .\fix_formatting.ps1 --check
+
  android:
    name: Android

@@ -122,7 +179,6 @@ jobs:
          mkdir -p out/dist/fallout2-ce-android-debug
          cp os/android/app/build/outputs/apk/debug/app-debug.apk out/dist/fallout2-ce-android-debug/fallout2-ce.apk
          cp out/dist/ce.dat out/dist/fallout2-ce-android-debug/ce.dat
-          cp files/fallout2.cfg out/dist/fallout2-ce-android-debug/EXAMPLE_fallout2.cfg
          cd out/dist
          zip -r fallout2-ce-android-debug.zip fallout2-ce-android-debug

@@ -179,7 +235,6 @@ jobs:
          mkdir -p out/dist/fallout2-ce-ios
          cp out/build/ios/fallout2-ce.ipa out/dist/fallout2-ce-ios/fallout2-ce-ios.ipa
          cp out/dist/ce.dat out/dist/fallout2-ce-ios/ce.dat
-          cp files/fallout2.cfg out/dist/fallout2-ce-ios/EXAMPLE_fallout2.cfg
          cd out/dist
          zip -r fallout2-ce-ios.zip fallout2-ce-ios

@@ -245,7 +300,6 @@ jobs:
          mkdir -p out/dist/fallout2-ce-linux-${{ matrix.arch }}
          cp out/build/linux-${{ matrix.arch }}-debug/fallout2-ce out/dist/fallout2-ce-linux-${{ matrix.arch }}/fallout2-ce
          cp out/dist/ce.dat out/dist/fallout2-ce-linux-${{ matrix.arch }}/ce.dat
-          cp files/fallout2.cfg out/dist/fallout2-ce-linux-${{ matrix.arch }}/EXAMPLE_fallout2.cfg
          tar -czvf out/dist/fallout2-ce-linux-${{ matrix.arch }}.tar.gz -C out/dist fallout2-ce-linux-${{ matrix.arch }}

      - name: Upload
@@ -255,38 +309,23 @@ jobs:
          path: out/dist/fallout2-ce-linux-${{ matrix.arch }}.tar.gz
          retention-days: 7

-  linux-arm:
-    name: Linux (${{ matrix.arch }})
+  linux-armhf:
+    name: Linux (armhf)

    runs-on: ubuntu-22.04-arm
    needs: [ce-dat]

-    strategy:
-      fail-fast: false
-      matrix:
-        arch:
-          - armhf
-          - arm64
-
    steps:
      - name: Clone
        uses: actions/checkout@v4

-      - name: Dependencies (armhf)
-        if: matrix.arch == 'armhf'
+      - name: Dependencies
        run: |
          sudo dpkg --add-architecture armhf
          sudo apt update
          sudo apt install gcc-arm-linux-gnueabihf g++-arm-linux-gnueabihf libsdl2-dev:armhf zlib1g-dev:armhf

-      - name: Dependencies (arm64)
-        if: matrix.arch == 'arm64'
-        run: |
-          sudo apt update
-          sudo apt install libsdl2-dev zlib1g-dev
-
-      - name: Configure (armhf)
-        if: matrix.arch == 'armhf'
+      - name: Configure
        run: |
          cmake \
            -B build \
@@ -297,8 +336,45 @@ jobs:
            -D CMAKE_CXX_COMPILER=arm-linux-gnueabihf-g++ \
            # EOL

-      - name: Configure (arm64)
-        if: matrix.arch == 'arm64'
+      - name: Build
+        run: cmake --build build
+
+      - name: Download ce.dat
+        uses: actions/download-artifact@v4
+        with:
+          name: ce-dat
+          path: out/dist
+
+      - name: Package
+        run: |
+          mkdir -p out/dist/fallout2-ce-linux-armhf
+          cp build/fallout2-ce out/dist/fallout2-ce-linux-armhf/fallout2-ce
+          cp out/dist/ce.dat out/dist/fallout2-ce-linux-armhf/ce.dat
+          tar -czvf out/dist/fallout2-ce-linux-armhf.tar.gz -C out/dist fallout2-ce-linux-armhf
+
+      - name: Upload
+        uses: actions/upload-artifact@v4
+        with:
+          name: fallout2-ce-linux-armhf
+          path: out/dist/fallout2-ce-linux-armhf.tar.gz
+          retention-days: 7
+
+  linux-arm64:
+    name: Linux (arm64)
+
+    runs-on: ubuntu-22.04-arm
+    needs: [ce-dat]
+
+    steps:
+      - name: Clone
+        uses: actions/checkout@v4
+
+      - name: Dependencies
+        run: |
+          sudo apt update
+          sudo apt install libsdl2-dev zlib1g-dev
+
+      - name: Configure
        run: cmake -B build -D CMAKE_BUILD_TYPE=Debug -D FALLOUT_VENDORED=OFF

      - name: Build
@@ -312,17 +388,16 @@ jobs:

      - name: Package
        run: |
-          mkdir -p out/dist/fallout2-ce-linux-${{ matrix.arch }}
-          cp build/fallout2-ce out/dist/fallout2-ce-linux-${{ matrix.arch }}/fallout2-ce
-          cp out/dist/ce.dat out/dist/fallout2-ce-linux-${{ matrix.arch }}/ce.dat
-          cp files/fallout2.cfg out/dist/fallout2-ce-linux-${{ matrix.arch }}/EXAMPLE_fallout2.cfg
-          tar -czvf out/dist/fallout2-ce-linux-${{ matrix.arch }}.tar.gz -C out/dist fallout2-ce-linux-${{ matrix.arch }}
+          mkdir -p out/dist/fallout2-ce-linux-arm64
+          cp build/fallout2-ce out/dist/fallout2-ce-linux-arm64/fallout2-ce
+          cp out/dist/ce.dat out/dist/fallout2-ce-linux-arm64/ce.dat
+          tar -czvf out/dist/fallout2-ce-linux-arm64.tar.gz -C out/dist fallout2-ce-linux-arm64

      - name: Upload
        uses: actions/upload-artifact@v4
        with:
-          name: fallout2-ce-linux-${{ matrix.arch }}
-          path: out/dist/fallout2-ce-linux-${{ matrix.arch }}.tar.gz
+          name: fallout2-ce-linux-arm64
+          path: out/dist/fallout2-ce-linux-arm64.tar.gz
          retention-days: 7

  macos:
@@ -413,7 +488,6 @@ jobs:
          mkdir -p out/dist/fallout2-ce-windows-${{ matrix.arch }}
          cp out/build/windows-${{ matrix.arch }}/RelWithDebInfo/fallout2-ce.exe out/dist/fallout2-ce-windows-${{ matrix.arch }}/fallout2-ce.exe
          cp out/dist/ce.dat out/dist/fallout2-ce-windows-${{ matrix.arch }}/ce.dat
-          cp files/fallout2.cfg out/dist/fallout2-ce-windows-${{ matrix.arch }}/EXAMPLE_fallout2.cfg
          cd out/dist
          7z a fallout2-ce-windows-${{ matrix.arch }}.zip fallout2-ce-windows-${{ matrix.arch }}

@@ -428,7 +502,7 @@ jobs:
  release:
    name: Release Continuous build
    runs-on: ubuntu-latest
-    needs: [android, ios, linux, linux-arm, macos, windows]
+    needs: [android, ios, linux, linux-armhf, linux-arm64, macos, windows]
    permissions:
      contents: write
    steps:
@@ -70,7 +70,6 @@ jobs:
          mkdir -p out/dist/fallout2-ce-android
          cp os/android/app/build/outputs/apk/release/app-release.apk out/dist/fallout2-ce-android/fallout2-ce-android.apk
          cp out/dist/ce.dat out/dist/fallout2-ce-android/ce.dat
-          cp files/fallout2.cfg out/dist/fallout2-ce-android/EXAMPLE_fallout2.cfg
          cd out/dist
          zip -r fallout2-ce-android.zip fallout2-ce-android
          gh release upload ${{ github.event.release.tag_name }} fallout2-ce-android.zip
@@ -131,7 +130,6 @@ jobs:
          mkdir -p out/dist/fallout2-ce-ios
          cp build/fallout2-ce.ipa out/dist/fallout2-ce-ios/fallout2-ce-ios.ipa
          cp out/dist/ce.dat out/dist/fallout2-ce-ios/ce.dat
-          cp files/fallout2.cfg out/dist/fallout2-ce-ios/EXAMPLE_fallout2.cfg
          cd out/dist
          zip -r fallout2-ce-ios.zip fallout2-ce-ios
          gh release upload ${{ github.event.release.tag_name }} fallout2-ce-ios.zip
@@ -213,7 +211,6 @@ jobs:
          mkdir -p out/dist/fallout2-ce-linux-${{ matrix.arch }}
          cp build/fallout2-ce out/dist/fallout2-ce-linux-${{ matrix.arch }}/fallout2-ce
          cp out/dist/ce.dat out/dist/fallout2-ce-linux-${{ matrix.arch }}/ce.dat
-          cp files/fallout2.cfg out/dist/fallout2-ce-linux-${{ matrix.arch }}/EXAMPLE_fallout2.cfg
          tar -czvf fallout2-ce-linux-${{ matrix.arch }}.tar.gz -C out/dist fallout2-ce-linux-${{ matrix.arch }}
          gh release upload ${{ github.event.release.tag_name }} fallout2-ce-linux-${{ matrix.arch }}.tar.gz
          rm fallout2-ce-linux-${{ matrix.arch }}.tar.gz
@@ -344,7 +341,6 @@ jobs:
          mkdir -p out/dist/fallout2-ce-windows-${{ matrix.arch }}
          cp out/build/windows-${{ matrix.arch }}/RelWithDebInfo/fallout2-ce.exe out/dist/fallout2-ce-windows-${{ matrix.arch }}/fallout2-ce.exe
          cp out/dist/ce.dat out/dist/fallout2-ce-windows-${{ matrix.arch }}/ce.dat
-          cp files/fallout2.cfg out/dist/fallout2-ce-windows-${{ matrix.arch }}/EXAMPLE_fallout2.cfg
          cd out/dist
          7z a fallout2-ce-windows-${{ matrix.arch }}.zip fallout2-ce-windows-${{ matrix.arch }}
          gh release upload ${{ github.event.release.tag_name }} fallout2-ce-windows-${{ matrix.arch }}.zip
@@ -47,6 +47,8 @@ set(FALLOUT_ENGINE_SOURCES
    "src/animation.h"
    "src/art.cc"
    "src/art.h"
+    "src/audio_file.cc"
+    "src/audio_file.h"
    "src/audio.cc"
    "src/audio.h"
    "src/automap.cc"
@@ -159,8 +161,6 @@ set(FALLOUT_ENGINE_SOURCES
    "src/map_defs.h"
    "src/map.cc"
    "src/map.h"
-    "src/map_edge.cc"
-    "src/map_edge.h"
    "src/memory_defs.h"
    "src/memory_manager.cc"
    "src/memory_manager.h"
@@ -372,33 +372,14 @@ if(WIN32)
    )
 endif()

-if(MINGW)
-     target_compile_definitions(${EXECUTABLE_NAME} PUBLIC
-        _USE_MATH_DEFINES
-    )
-endif()
-
 if(WIN32)
    target_link_libraries(${EXECUTABLE_NAME}
        winmm
-    )
-endif()
-
-if(MSVC)
-    target_link_libraries(${EXECUTABLE_NAME} 
        debug libcpmtd
        optimized libcpmt
    )
 endif()

-if(MINGW)
-    target_link_options(${EXECUTABLE_NAME} PRIVATE
-        -static
-        -static-libgcc
-        -static-libstdc++
-    )
-endif()
-
 if(WIN32)
    target_sources(${EXECUTABLE_NAME} PUBLIC
        "os/windows/fallout2-ce.ico"
@@ -515,7 +496,6 @@ target_link_libraries(${EXECUTABLE_NAME} ${ZLIB_LIBRARIES})
 target_include_directories(${EXECUTABLE_NAME} PRIVATE ${ZLIB_INCLUDE_DIRS})

 target_link_libraries(${EXECUTABLE_NAME} ${SDL2_LIBRARIES})
-target_link_libraries(${EXECUTABLE_NAME} ${SDL2_MAIN_LIBRARIES})
 target_include_directories(${EXECUTABLE_NAME} PRIVATE ${SDL2_INCLUDE_DIRS})

 if((NOT ANDROID) AND (NOT IOS) AND (NOT CMAKE_SYSTEM_NAME MATCHES "Emscripten"))
@@ -542,13 +522,6 @@ if((NOT ANDROID) AND (NOT IOS) AND (NOT CMAKE_SYSTEM_NAME MATCHES "Emscripten"))
    if(WIN32)
        target_link_libraries(ce-dat-tool winmm)
    endif()
-    if(MINGW)
-        target_link_options(ce-dat-tool PRIVATE
-            -static
-            -static-libgcc
-            -static-libstdc++
-        )
-    endif()
    target_include_directories(ce-dat-tool PRIVATE "src")
    target_include_directories(ce-dat-tool PRIVATE ${ZLIB_INCLUDE_DIRS})
    target_include_directories(ce-dat-tool PRIVATE ${SDL2_INCLUDE_DIRS})
@@ -572,14 +545,6 @@ if((NOT ANDROID) AND (NOT IOS) AND (NOT CMAKE_SYSTEM_NAME MATCHES "Emscripten"))
    target_include_directories(ce-frm2png PRIVATE ${ZLIB_INCLUDE_DIRS})
    target_link_libraries(ce-frm2png ${SDL2_LIBRARIES})
    target_link_libraries(ce-frm2png ${ZLIB_LIBRARIES})
-    
-    if(MINGW)
-        target_link_options(ce-frm2png PRIVATE
-            -static
-            -static-libgcc
-            -static-libstdc++
-        )
-    endif()

    if(APPLE)
        file(GLOB_RECURSE CE_DAT_INPUTS CONFIGURE_DEPENDS "${CMAKE_SOURCE_DIR}/files/ce.dat/*")
@@ -614,8 +579,6 @@ if((NOT ANDROID) AND (NOT IOS) AND (NOT CMAKE_SYSTEM_NAME MATCHES "Emscripten"))
    target_sources(mapper-ce PUBLIC
        ${FALLOUT_ENGINE_SOURCES}
        ${FALLOUT_PLATFORM_SOURCES}
-        "src/mapper/map_edge_setup.cc"
-        "src/mapper/map_edge_setup.h"
        "src/mapper/map_func.cc"
        "src/mapper/map_func.h"
        "src/mapper/mapper.cc"
@@ -628,8 +591,6 @@ if((NOT ANDROID) AND (NOT IOS) AND (NOT CMAKE_SYSTEM_NAME MATCHES "Emscripten"))
        "src/mapper/mp_scrpt.h"
        "src/mapper/mp_targt.cc"
        "src/mapper/mp_targt.h"
-        "src/mapper/mp_utils.cc"
-        "src/mapper/mp_utils.h"
        "src/mapper/mp_text.cc"
        "src/mapper/mp_text.h"
    )
@@ -644,30 +605,11 @@ if((NOT ANDROID) AND (NOT IOS) AND (NOT CMAKE_SYSTEM_NAME MATCHES "Emscripten"))
            WIN32_LEAN_AND_MEAN
            _STATIC_CPPLIB
        )
-
-        if(MINGW)
-            target_compile_definitions(mapper-ce PUBLIC
-                _USE_MATH_DEFINES
-            )
-
-            target_link_options(mapper-ce PRIVATE
-                -static
-                -static-libgcc
-                -static-libstdc++
-            )
-        endif()
-
        target_link_libraries(mapper-ce
            winmm
+            debug libcpmtd
+            optimized libcpmt
        )
-        
-        if(MSVC)
-            target_link_libraries(mapper-ce
-                debug libcpmtd
-                optimized libcpmt
-            )
-        endif()
-
        target_sources(mapper-ce PUBLIC
            "os/windows/fallout2-ce.rc"
        )
@@ -691,7 +633,6 @@ if((NOT ANDROID) AND (NOT IOS) AND (NOT CMAKE_SYSTEM_NAME MATCHES "Emscripten"))
        fpattern_windows::fpattern_windows
        ${ZLIB_LIBRARIES}
        ${SDL2_LIBRARIES}
-        ${SDL2_MAIN_LIBRARIES}
    )
 endif()

@@ -139,77 +139,6 @@
            "cacheVariables": {
                "CMAKE_SYSTEM_NAME": "iOS"
            }
-        },
-        {
-            "name": "Mingw-base",
-            "hidden": true,
-            "description": "Base preset for all MinGW builds.",
-            "inherits":[
-                "base"
-            ],
-            "generator": "Ninja",
-            "toolchainFile": "${sourceDir}/cmake/toolchain/mingw.cmake",
-            "cacheVariables": {
-                "CMAKE_SYSTEM_NAME": "Windows"
-            }
-        },
-        {
-            "name": "Mingw-x86-base",
-            "hidden": true,
-            "description": "Base preset for all MinGW x86 builds.",
-            "inherits": [
-                "Mingw-base"
-            ],
-            "cacheVariables": {
-                "CMAKE_C_FLAGS": "-m32",
-                "CMAKE_CXX_FLAGS": "-m32",
-                "CMAKE_SYSTEM_PROCESSOR": "i686"
-            }
-        },
-        {
-            "name": "Mingw-x86-debug",
-            "displayName": "MinGW x86 Debug",
-            "description": "Cross-compile a Debug Windows x86 build with MinGW-w64 and Ninja.",
-            "inherits": [
-                "Mingw-x86-base"
-            ],
-            "cacheVariables": {
-                "CMAKE_BUILD_TYPE": "Debug"
-            }
-        },
-        {
-            "name": "Mingw-x86-release",
-            "displayName": "MinGW x86 Release",
-            "description": "Cross-compile a RelWithDebInfo Windows x86 build with MinGW-w64 and Ninja.",
-            "inherits": [
-                "Mingw-x86-debug"
-            ],
-            "cacheVariables": {
-                "CMAKE_BUILD_TYPE": "RelWithDebInfo"
-            }
-        },
-        {
-            "name": "Mingw-x64-debug",
-            "displayName": "MinGW x64 Debug",
-            "description": "Cross-compile a Debug Windows x64 build with MinGW-w64 and Ninja.",
-            "inherits": [
-                "Mingw-base"
-            ],
-            "cacheVariables": {
-                "CMAKE_SYSTEM_PROCESSOR": "x86_64",
-                "CMAKE_BUILD_TYPE": "Debug"
-            }
-        },
-        {
-            "name": "Mingw-x64-release",
-            "displayName": "MinGW x64 Release",
-            "description": "Cross-compile a RelWithDebInfo Windows x64 build with MinGW-w64 and Ninja.",
-            "inherits": [
-                "Mingw-x64-debug"
-            ],
-            "cacheVariables": {
-                "CMAKE_BUILD_TYPE": "RelWithDebInfo"
-            }
        }
    ],
    "buildPresets": [
@@ -268,26 +197,6 @@
            "name": "ios-release",
            "configurePreset": "ios",
            "configuration": "RelWithDebInfo"
-        },
-        {
-            "name": "Mingw-x86-Debug",
-            "displayName": "MinGW x86 Debug",
-            "configurePreset": "Mingw-x86-debug"
-        },
-        {
-            "name": "Mingw-x86-Release",
-            "displayName": "MinGW x86 Release",
-            "configurePreset": "Mingw-x86-release"
-        },
-        {
-            "name": "Mingw-x64-Debug",
-            "displayName": "MinGW x64 Debug",
-            "configurePreset": "Mingw-x64-debug"
-        },
-        {
-            "name": "Mingw-x64-Release",
-            "displayName": "MinGW x64 Release",
-            "configurePreset": "Mingw-x64-release"
        }
    ]
 }
@@ -51,6 +51,25 @@ cmake --build out/build/linux-x64-debug --target fallout2-ce

 TODO: add Visual Studio build instructions. This will likely need a Visual Studio generator or preset plus the MSVC toolchain and Windows SDK.

+## Code formatting
+
+C++ sources under `src/` are formatted with **clang-format 14** (see `.clang-format`).
+
+- Format everything: `./fix_formatting.sh` (Linux / macOS / Git Bash) or `.\fix_formatting.ps1` (PowerShell). Both use local clang-format 14, or Docker (`silkeh/clang:14`) if 14 is not on `PATH`.
+- CI uses the same major version; see `fix_formatting.sh --check`.
+
+### Optional: format staged files on `git commit`
+
+After cloning, run **once per clone** (`--local` affects only this repository; any IDE that uses Git will run the hook):
+
+```sh
+git config --local core.hooksPath .githooks
+```
+
+The `pre-commit` hook is already executable in the repo. It formats staged `*.cc` / `*.h` with clang-format 14 (or Docker if 14 is missing). Unstaged edits are stashed temporarily so partial commits (`git add -p`) stay safe. If no formatter is available, it prints a warning and **does not block** the commit.
+
+Install clang-format 14 before relying on the hook — see `fix_formatting.sh` / `fix_formatting.ps1` help output.
+
 ## `.dat` CLI Tool

 There is a small command-line archive tool in this repo for inspecting Fallout `.dat` files. It supports both Fallout 2 and Fallout 1 archives.
@@ -66,9 +85,8 @@ Available commands:
 1. `./<BUILD_DIR>/ce-dat-tool <archive.dat> list [pattern]`
 2. `ce-dat-tool <archive.dat> info [pattern]`
 3. `ce-dat-tool <archive.dat> extract [--lower] <output-dir> [pattern]`
-4. `ce-dat-tool <archive.dat> extract [--lower] (--file-list|--files-from) <list-file> <output-dir>`
-5. `ce-dat-tool <archive.dat> cat <entry>`
-6. `ce-dat-tool create <input-dir> <archive.dat>`
+4. `ce-dat-tool <archive.dat> cat <entry>`
+5. `ce-dat-tool create <input-dir> <archive.dat>`

 Use `--lower` with `extract` when you want every extracted file and directory name forced to lowercase.
 For example:
@@ -77,7 +95,7 @@ For example:

 ## `ce-frm2png` CLI Tool

-There is also a small FRM conversion tool in this repo for converting Fallout art between `.frm` and `.png`.
+There is also a small FRM conversion tool in this repo for exporting Fallout `.frm` art to `.png`.

 From the repo root, build it with your normal CMake workflow, targeting `ce-frm2png`:

@@ -90,26 +108,18 @@ Basic usage:
 1. `./<BUILD_DIR>/ce-frm2png <input.frm> [output.png]`
 2. `./<BUILD_DIR>/ce-frm2png <input.frm> [output.png] --palette <path-to-color.pal>`
 3. `./<BUILD_DIR>/ce-frm2png <input.frm> [output.png] --frame <index> --direction <index>`
-4. `./<BUILD_DIR>/ce-frm2png <input.png> [output.frm] --palette <path-to-color.pal>`
-5. `./<BUILD_DIR>/ce-frm2png <input.png> [output.frm] --fps 10 --action-frame 0 --x-offset 0 --y-offset 0`
-6. `./<BUILD_DIR>/ce-frm2png <input.png> <output.png> --palette <path-to-color.pal>`
-7. `./<BUILD_DIR>/ce-frm2png - [output.png|-] --from-frm --palette <path-to-color.pal>`
-8. `./<BUILD_DIR>/ce-frm2png - [output.frm|-] --from-png --palette <path-to-color.pal>`
+4. `./<BUILD_DIR>/ce-frm2png - [output.png|-] --palette <path-to-color.pal>`

-`-` can be used to take input from stdin (e.g. from `ce-dat-tool cat`) or write to stdout. When reading from stdin, pass `--from-frm` or `--from-png`. Output defaults to PNG for FRM input and FRM for PNG input when output is omitted or `-`; use `--to-png` for PNG output to stdout from PNG input.
+`-` can be used to take input from stdin (e.g. from `ce-dat-tool cat` or write to stdout).

-Output file extensions are validated against the selected conversion. For example, PNG-to-FRM output must use `.frm`, and PNG output must use `.png`.
-
-If `--palette` isn't specified, it will pick up `color.pal` in the input file's directory or cwd.
+If `--palette` isn't specified, it will pick up `color.pal` in the .frm's directory or cwd.

 Notes:

 - The tool expects a raw `color.pal` file. It does not read palettes directly from `master.dat`, so extract `color.pal` first if needed.
 - A typical extraction flow is: `ce-dat-tool master.dat extract --lower . 'color.pal'`
 - By default palette index `0` becomes transparent in the output PNG. Pass `--opaque` to keep it opaque.
- PNG output is always palette-indexed and preserves Fallout palette indices when possible.
- For `png -> frm`, transparent pixels (alpha below 128) map to palette index `0` by default. Pass `--opaque` to quantize every pixel instead.
- The current `png -> frm` implementation writes a single-frame FRM and points all six direction slots at the same frame payload.
+- The current implementation writes RGBA PNGs. It does not preserve the original Fallout palette indices as a palette-indexed PNG.

 ## Updating SDL

@@ -1,102 +1,18 @@
 # Fallout 2 Community Engine

-Fallout 2 Community Engine is a fully working re-implementation of the Fallout 2 engine, optimized for a hassle-free experience on multiple platforms, including Windows, Mac, iOS, Android, and Linux.  It provides high resolution support, quality-of-life improvements, and dozens upon dozens of bug fixes.
+Fallout 2 Community Engine is a fully working re-implementation of the Fallout 2 engine, optimized for a hassle-free experience on multiple platforms.  It provides high resolution support, quality-of-life improvements, and dozens of bug fixes.

 This is a fork of the original Fallout2: CE project, which is no longer getting regular updates.

-Popular Fallout 2 total conversion mods are partially supported. Nevada and Sonora work. [Fallout 2 Restoration Project](https://github.com/BGforgeNet/Fallout2_Restoration_Project) is supported (in Beta). [Fallout Et Tu](https://github.com/rotators/Fo1in2) and [Olympus 2207](https://olympus2207.com) are not yet supported. Other mods (particularly Resurrection and Yesterday) are not tested.
+Popular Fallout 2 total conversion mods are partially supported. Original versions of Nevada and Sonora (that do not rely on extended features provided by Sfall) work. [Fallout 2 Restoration Project](https://github.com/BGforgeNet/Fallout2_Restoration_Project) is supported (in Beta). [Fallout Et Tu](https://github.com/rotators/Fo1in2) and [Olympus 2207](https://olympus2207.com) are not yet supported. Other mods (particularly Resurrection and Yesterday) are not tested.

-Fallout2: CE has broad (though not total) compatibility with [Sfall](https://github.com/sfall-team/sfall) scripting extensions.  Many traditional Fallout mods work out of the box, including NPC Armor, Party Orders, FO2Tweaks (we recommend v14.5+), Talking Heads, and many others.
+Fallout2: CE has broad (though not total) compatibility with [Sfall](https://github.com/sfall-team/sfall) scripting extensions.  Many traditional Fallout mods work out of the box.

-## Installation — [Download Latest CE Release](https://github.com/fallout2-ce/fallout2-ce/releases)
+There is also [Fallout 1 Community Edition](https://github.com/alexbatalov/fallout1-ce) (not affiliated with this fork).

-You *must* own the game to play. Purchase your copy on [GOG](https://www.gog.com/game/fallout_2), [Epic Games](https://store.epicgames.com/p/fallout-2) or [Steam](https://store.steampowered.com/app/38410).
+## Installation

-Download CE from the link above, then extract the archive into your game folder. Launch `fallout2-ce.exe` on Windows (or the platform-specific executable) to play. CE has a lot of enhancements that require configuration. See [Configuration](#configuration) for examples.
-
-For detailed instructions on how to play on Mac, Linux, iOS, or Android, see the [Platform-specific instructions](#platform-specific-installation).
-
-## Quality of life benefits over vanilla Fallout
-
-* High resolution support
-* Party members can loot and barter in place of PC
-* Directly equip party members instead of convincing them to use the right equipment.
-* Expanded 2-column inventory, loot screens
-* Expanded 4-row barter screen
-* Expanded AP bar
-* Ctrl-click to quickly move items when bartering, looting, or stealing, and auto-balance caps
-* Music continues playing between maps
-* Auto open doors
-* Integrated "HELP" menu
-* 44.1 kHz stereo sound/music supported, in .ogg and .wav format as well as legacy .acm
-* Last used save slot is remembered
-* Item/Corpse/Container/Critter highlighting (configure using [mods/sfall-mods.ini](https://github.com/sfall-team/sfall/blob/master/artifacts/config_files/sfall-mods.ini))
-
-<table>
-  <tr>
-    <td align="center">
-    <img src="docs/images/two-column-inventory.jpg" alt="Expanded 2-column inventory" width="360"><br>
-    <sub>Expanded 2-column inventory</sub>
-    </td>
-    <td align="center">
-      <img src="docs/images/companion-equip.gif" alt="Companion equip screen" width="360"><br>
-      <sub>Companion equip screen</sub>
-    </td>
-
-  </tr>
-  <tr>
-    <td align="center">
-      <img src="docs/images/party-member-loot.gif" alt="Party member loot" width="360"><br>
-      <sub>Party member loot</sub>
-    </td>
-    <td align="center">
-      <img src="docs/images/help-menu.gif" alt="Integrated HELP menu" width="360"><br>
-      <sub>Integrated HELP menu</sub>
-    </td>
-  </tr>
-</table>
-
-There are also dozens of small things that just work a little better than they did in the original.  Better pathfinding, fewer graphics glitches, less finicky weapon stacking, and much more.
-
-## Configuration
-
-The main configuration file is `fallout2.cfg`. This contains original game config as well as new CE settings.
-
-Additional settings for screen resolution, UI customization, and map options are now integrated into the main `fallout2.cfg` file (previously part of `f2_res.ini` from Mash's HRP).
-
-Here are some important settings in `fallout2.cfg` under the `[screen]` and `[ui]` sections.  See [the example config](https://github.com/fallout2-ce/fallout2-ce/tree/refs/heads/main/files/fallout2.cfg) for a full list of settings.
-
-```ini
-[screen]
-resolution_x=1600 ; actual game window size (screen resolution), in pixels
-resolution_y=1080
-windowed=1 ; 0 = fullscreen
-scale=2 ; 1 = original scale, 2 = 2x scale, etc. (e.g. at scale 2 and screen resolution 1920x1080, in-game resolution will be 960x540, thus every pixel is twice as wide and tall)
-
-[ui]
-; Maximum number of columns shown in the main inventory and loot/steal windows (valid range: 1..2)
-inventory_columns=2
-
-; Set to 1 to expand the barter/trade window vertically, adding a 4th item slot per side (requires ce.dat)
-expand_barter_window=1
-
-[qol]
-; Allow opening party member inventory from the long-press context menu.
-party_trade_from_menu=1
-
-; Allow switching to companions' inventories in loot screens (and barter, in the future)
-party_loot_and_barter=1
-```
-
-**Recommendations:**
- **Desktops**: Use any size you see fit.
- **Tablets**: Set these values to logical resolution of your device, for example iPad Pro 11 is 1668x2388 (pixels), but its logical resolution is 834x1194 (points).
- **Mobile phones**: Set height to 480, calculate width according to your device screen (aspect) ratio, for example Samsung S21 is 20:9 device, so the width should be 480 * 20 / 9 = 1067.
-
-In time this stuff will receive an in-game interface, right now you have to do it manually. To see all currently working fallout2.cfg settings, just run the game once and quit. It will be automatically updated with defaults for every supported setting.
-*Note*: Use of the IFACE_BAR settings requires the `f2_res.dat` file, which contains graphical assets. Various versions are available, but one compatible with the above settings can be found here: [f2_res.dat](https://github.com/fallout2-ce/fallout2-ce/raw/refs/heads/main/files/f2_res.dat)
-
-## Platform-specific installation
+You *must* own the game to play. Purchase your copy on [GOG](https://www.gog.com/game/fallout_2), [Epic Games](https://store.epicgames.com/p/fallout-2) or [Steam](https://store.steampowered.com/app/38410). Download latest [release](https://github.com/fallout2-ce/fallout2-ce/releases) or build from source.

 ### Windows

@@ -187,23 +103,63 @@ docker run --rm -v $(pwd):/src emscripten/emsdk:3.1.74 sh -c 'git config --globa
 ```
 - Demo available at https://github.com/ololoken/fallout2-ce-ems.git

+## Configuration
+
+The main configuration file is `fallout2.cfg`. There are several important settings you might need to adjust for your installation. Depending on your Fallout distribution main game assets `master.dat`, `critter.dat`, `patch000.dat`, and `data` folder might be either all lowercased, or all uppercased. You can either update `master_dat`, `critter_dat`, `master_patches` and `critter_patches` settings to match your file names, or rename files to match entries in your `fallout2.cfg`.
+
+The `sound` folder (with `music` folder inside) might be located either in `data` folder, or be in the Fallout folder. Update `music_path1` setting to match your hierarchy, usually it's `data/sound/music/` or `sound/music/`. Make sure it matches your path exactly (so it might be `SOUND/MUSIC/` if you've installed Fallout from CD). Music files themselves (with `ACM` extension) should be all uppercased, regardless of `sound` and `music` folders.
+
+Additional settings for screen resolution, UI customization, and map options are now integrated into the main `fallout2.cfg` file (previously part of `f2_res.ini` from Mash's HRP). When Fallout 2 CE starts, if it detects an existing `f2_res.ini` file, it automatically migrates these settings into `fallout2.cfg`. After migration, `fallout2.cfg` becomes the single source of truth for this configuration.
+
+Here are some important settings in `fallout2.cfg` under the `[screen]` and `[ui]` sections.  See [the example config](https://github.com/fallout2-ce/fallout2-ce/tree/refs/heads/main/files/fallout2.cfg) for a full list of settings.
+
+```ini
+[screen]
+resolution_x=1600 ; actual game window size (screen resolution), in pixels
+resolution_y=1080
+windowed=1 ; 0 = fullscreen
+scale=2 ; 1 = original scale, 2 = 2x scale, etc. (e.g. at scale 2 and screen resolution 1920x1080, in-game resolution will be 960x540, thus every pixel is twice as wide and tall)
+
+[ui]
+;Set to 1 to expand the barter/trade window vertically, adding a 4th item slot per side (requires ce.dat)
+expand_barter_window=1
+;Maximum number of columns shown in the main inventory and loot/steal windows (valid range: 1..2)
+inventory_columns=2
+splash_screen_size=1 ; Splash screen scaling (0=original size, 1=fit preserving aspect, 2=stretch to fill)
+quick_toolbar_visible=0 ; Skills quick access toolbar visibility (iOS only) (0=hidden, 1=visible)
+```
+
+**Recommendations:**
+- **Desktops**: Use any size you see fit.
+- **Tablets**: Set these values to logical resolution of your device, for example iPad Pro 11 is 1668x2388 (pixels), but it's logical resolution is 834x1194 (points).
+- **Mobile phones**: Set height to 480, calculate width according to your device screen (aspect) ratio, for example Samsung S21 is 20:9 device, so the width should be 480 * 20 / 9 = 1067.
+
+In time this stuff will receive in-game interface, right now you have to do it manually. To see all currently working fallout2.cfg settings, just run the game once and quit. It will be automatically updated with defaults for every supported setting.
+*Note*: Use of the IFACE_BAR settings requires the `f2_res.dat` file, which contains graphical assets. Various versions are available, but one compatible with the above settings can be found here: [f2_res.dat](https://github.com/fallout2-ce/fallout2-ce/raw/refs/heads/main/files/f2_res.dat)
+
+## Quality of life benefits over vanilla Fallout
+
+* High resolution support
+* Expanded 2-column inventory
+* Expanded 4-row barter screen
+* Expanded AP bar
+* Party members can loot and barter in place of PC
+* Increased pathfinding nodes 5x for more accurate pathfinding
+* Ctrl-click to quickly move items when bartering, looting, or stealing
+* _a_ to select "all" when selecting item quantity
+* _a_ to `Take All` when looting
+* When bartering, caps default to the right amount to balance the trade (if possible)
+* Music continues playing between maps
+* Auto open doors

 ## Contributing

-For build instructions and contributor notes, see [CONTRIBUTING.md](CONTRIBUTING.md).
+For build instructions and contributor notes, see [CONTRIBUTING.md](CONTRIBUTING.md). To optionally format staged C++ files on commit: `git config --local core.hooksPath .githooks` (once per clone).

 Integrating Sfall goodies is the top priority. Quality of life updates are OK too.  In any case open up an issue with your suggestion or to notify other people that something is being worked on.

 For current sfall compatibility status and the remaining work needed to close gaps, see [SFALL_COMPATIBILITY.md](SFALL_COMPATIBILITY.md).

-## For modders
-
-* Robust (though not 100%) Sfall opcode and hook support
-* .ogg/.wav support for map music
-* .png support for static assets (must be 8bit indexed)
-* .zip support for .dat archives
-* Working BIS mapper
-
 ## License

 The source code is this repository is available under the [Sustainable Use License](LICENSE.md).
@@ -4,18 +4,6 @@ This document tracks Fallout 2 CE compatibility with sfall.  This is for modders

 For now, this covers opcodes/metarules, and hooks.  In the future, it will include other ways of modifying the engine (like ini files), and other Sfall-specific behaviour.

-## HRP EDG Scroll-Blocker Support
-
-CE supports the `.edg` file format from the HRP (High Resolution Patch), which defines per-map scroll boundaries and square-level render clipping.
-
-**How it works in CE:**
-
- On map load, `maps/<mapname>.edg` is read if present. Missing file = silent fallback to the scroll-blocker object system.
- The `.edg` file defines per-elevation rectangle boundary zones. Multiple chained zones per elevation are supported.
- When loaded, these zones are used for both scroll blocking and visible area clipping (black bars), replacing both vanilla scroll blocking and CE hi-res stencil system.
- v2 EDG files also contain a `SquareRect` that defines "Angled edges", or square-grid stencil. This is also supported.
-
-
 ## Settings (ddraw.ini → fallout2.cfg / game.cfg)

 Settings previously read from `ddraw.ini` have been moved into standard CE config files.
@@ -38,12 +26,6 @@ The following settings were moved into [`fallout2.cfg`](files/fallout2.cfg) inst
 | `Misc` | `UseWalkDistance` | `qol` | `use_walk_distance` |
 | `Misc` | `AutoOpenDoors` | `qol` | `auto_open_doors` |

-The following settings were moved into [`<DAT>/config/game.cfg`](files/ce.dat/config/game.cfg):
-
-| ddraw.ini section | ddraw.ini key | game.cfg section | game.cfg key |
-| --- | --- | --- | --- |
-| `Misc` | `StartGDialogFix` | `dialog` | `start_gdialog_fix` |
-
 ## Opcodes / Metarules

 See [`https://sfall-team.github.io/sfall/`](https://sfall-team.github.io/sfall/) for documentation on specific functions.
@@ -59,7 +41,7 @@ See [`https://sfall-team.github.io/sfall/`](https://sfall-team.github.io/sfall/)
 | Perks and traits | set_perk_image<br>set_perk_*<br>set_pyromaniac_mod<br>apply_heaveho_fix<br>set_swiftlearner_mod<br>has/set_fake_perk<br>has/set_fake_trait<br>set_selectable_perk<br>set_perkbox_title<br>show/hide_real_perks<br>perk_add_mode<br>clear_selectable_perks<br>add/remove_trait<br>seq_perk_freq | not implemented | - |
 | Virtual file system | fs_create<br>fs_copy<br>fs_find<br>fs_read/write_*<br>fs_delete<br>fs_size<br>fs_pos<br>fs_seek<br>fs_resize | 🚫 | Open an issue if you have a use case for these |
 | Combat / Knockback | set_weapon_knockback<br>set_target_knockback<br>set_attacker_knockback<br>remove_weapon_knockback<br>remove_target_knockback<br>remove_attacker_knockback | not implemented | - |
-| Maps and encounters | in_world_map<br>force_encounter{_with_flags}<br>set_map_time_multi<br>get/set_map_enter_position<br>exec_map_update_scripts<br>get/set_terrain_name<br>set_town_title<br>get/set_can_rest_on_map<br>set_rest_heal_time<br>set_rest_mode<br>set_worldmap_heal_time | implemented: in_world_map, force_encounter, force_encounter_with_flags, set_map_time_multi, get_terrain_name, set_terrain_name | - |
+| Maps and encounters | in_world_map<br>force_encounter<br>force_encounter_with_flags<br>set_map_time_multi<br>get/set_map_enter_position<br>exec_map_update_scripts<br>get/set_terrain_name<br>set_town_title<br>get/set_can_rest_on_map<br>set_rest_heal_time<br>set_rest_mode<br>set_worldmap_heal_time | implemented: in_world_map, force_encounter, force_encounter_with_flags, set_map_time_multi | - |
 | Maps and encounters / Worldmap | get_world_map_x/y_pos<br>set_world_map_pos | ✅ | - |
 | Audio | play_sfall_sound<br>stop_sfall_sound | ✅ | `play_sfall_sound` currently supports `.acm`, `.wav`, `.ogg` formats, and can load from `.dat` archives. `.mp3` is not yet supported. |
 | Combat / Weapons and ammo | get/set_weapon_ammo_pid<br>get/set_weapon_ammo_count | ✅ | - |
@@ -69,32 +51,30 @@ See [`https://sfall-team.github.io/sfall/`](https://sfall-team.github.io/sfall/)
 | Lists | list_begin<br>list_next<br>list_end<br>list_as_array<br>party_member_list | ✅ | - |
 | Explosions | set_attack_explosion_pattern<br>set_attack_explosion_art<br>set_attack_explosion_radius<br>set_attack_is_explosion_fire<br>set_explosion_radius<br>set_dynamite_damage<br>set_plastic_damage<br>get_explosion_damage<br>set_explosion_max_targets<br>item_make_explosive | ✅ except item_make_explosive | - |
 | Animations | reg_anim_combat_check<br>reg_anim_destroy<br>reg_anim_animate_and_hide<br>reg_anim_light<br>reg_anim_change_fid<br>reg_anim_take_out<br>reg_anim_turn_towards<br>reg_anim_callback<br>reg_anim_animate_and_move | ✅ except reg_anim_callback | - |
-| Art and appearance | art_exists<br>art_frame_data<br>refresh_pc_art<br>art_cache_clear | ✅ | - |
+| Art and appearance | art_exists<br>refresh_pc_art<br>art_cache_clear<br>set_hero_race<br>set_hero_style | implemented: art_exists, refresh_pc_art, art_cache_clear | - |
 | Tiles and paths | get_tile_fid<br>tile_under_cursor<br>tile_light<br>tile_get_objs<br>tile_refresh_display<br>obj_blocking_tile<br>tile_by_position<br>get_tile_ground_fid<br>get_tile_roof_fid<br>obj_blocking_line<br>path_find_to<br>objects_in_radius | ✅ | - |
 | Utility | sprintf<br>typeof<br>atoi<br>atof | ✅ | - |
 | Utility / Strings | string_split<br>substr<br>strlen<br>charcode<br>get_string_pointer<br>string_find<br>string_find_from<br>string_format<br>string_format_array<br>string_replace<br>string_to_case<br>string_compare | ✅ | `get_string_pointer` is deprecated and intentionally omitted. |
-| Interface / Tags | show_iface_tag<br>hide_iface_tag<br>is_iface_tag_active<br>set_iface_tag_text<br>add_iface_tag | ✅ | Legacy `BoxBarCount`, `BoxBarColors` ddraw.ini settings not supported. |
+| Interface / Tags | show_iface_tag<br>hide_iface_tag<br>is_iface_tag_active<br>set_iface_tag_text<br>add_iface_tag | ✅ except set_iface_tag_text, add_iface_tag | CE only handles built-in interface tags here; custom tag creation/text is not supported yet. |
 | Global variables | set_sfall_global<br>get_sfall_global_int<br>get_sfall_global_float | ✅ except get_sfall_global_float | Current CE storage is int-backed; `set_sfall_global` stores integer values |
 | Hooks / Hook functions | init_hook<br>get_sfall_arg<br>get_sfall_args<br>get_sfall_arg_at<br>set_sfall_return<br>set_sfall_arg<br>register_hook<br>register_hook_proc<br>register_hook_proc_spec | ✅ | See below for implemented hooks. `init_hook` is deprecated and will not be implemented. register_hook_proc and register_hook_proc_spec both add hooks to the *end* of the hook list, instead of beginning and end, respectively. |
 | Arrays / Array functions | create_array<br>temp_array<br>fix_array<br>get/set_array<br>resize_array<br>free_array<br>scan_array<br>len_array<br>save/load_array<br>array_key<br>arrayexpr | ✅ | - |
 | Perks and traits / NPC perks | set_fake_perk_npc<br>set_fake_trait_npc<br>set_selectable_perk_npc<br>has_fake_perk_npc<br>has_fake_trait_npc | not implemented | - |
 | Global scripts / Global script functions | set_global_script_repeat<br>set_global_script_type<br>available_global_script_types | ✅ except available_global_script_types | - |
-| Combat | attack_is_aimed<br>block_combat<br>force_aimed_shots<br>disable_aimed_shots<br>get_attack_type<br>get/set_bodypart_hit_modifier<br>combat_data<br>get/set/reset_critical_table<br>get_last_target<br>get_last_attacker<br>set_critter_burst_disable<br>get/set_critter_current_ap<br>set_spray_settings<br>get/set_combat_free_move | ✅ except block_combat, force_aimed_shots, disable_aimed_shots, get_last_target, get_last_attacker, set_spray_settings | - |
+| Combat | attack_is_aimed<br>block_combat<br>force_aimed_shots<br>disable_aimed_shots<br>get_attack_type<br>get/set_bodypart_hit_modifier<br>combat_data<br>get/set/reset_critical_table<br>get_last_target<br>get_last_attacker<br>set_critter_burst_disable<br>get/set_critter_current_ap<br>set_spray_settings<br>get/set_combat_free_move | implemented: get_attack_type, get/set_bodypart_hit_modifier, combat_data, get/set_critter_current_ap, get/set_combat_free_move | - |
 | Car | set_car_current_town<br>car_gas_amount<br>set_car_intface_art | implemented: all except set_car_intface_art | - |
-| Interface / Windows and images | interface_art_draw<br>interface_print<br>draw_image{_scaled}<br>get_window_under_mouse<br>create_win<br>get_window_attribute<br>message_box<br>set_window_flag<br>win_fill_color<br>interface_overlay<br>dialog_message<br>get_text_width<br>hide_window<br>show_window<br>create_message_window | ✅ except interface_print, interface_overlay | - |
+| Interface / Windows and images | art_frame_data<br>interface_art_draw<br>interface_print<br>draw_image<br>draw_image_scaled<br>get_window_under_mouse<br>create_win<br>get_window_attribute<br>message_box<br>set_window_flag<br>win_fill_color<br>interface_overlay<br>dialog_message<br>get_text_width<br>hide_window<br>show_window<br>create_message_window | implemented: only message_box, get_text_width, show_window, create_message_window | - |
 | Interface / Outline | outlined_object<br>get_outline<br>set_outline | ✅ | - |
 | Interface / Main interface | intface_is_hidden<br>intface_redraw<br>intface_hide<br>intface_show<br>set_quest_failure_value | implemented: only intface_redraw | `intface_redraw` only supports the zero-argument form; the optional-argument path is explicitly unimplemented. |
-| Interface / Inventory | display_stats<br>inventory_redraw<br>critter_inven_obj2<br>get_current_inven_size<br>item_weight | ✅ except get_current_inven_size | - |
+| Interface / Inventory | display_stats<br>inventory_redraw<br>critter_inven_obj2<br>get_current_inven_size<br>item_weight | implemented: critter_inven_obj2, item_weight | - |
 | Interface / Cursor | get/set_cursor_mode | ✅ | - |
 | Locks | lock_is_jammed<br>unjam_lock<br>set_unjam_locks_time | not implemented | - |
-| INI settings | get_ini_setting<br>get_ini_string<br>get_ini_section<br>get_ini_sections<br>get_ini_config<br>get_ini_config_db<br>set_ini_setting | ✅ | `modified_ini` is intentionally omitted as deprecated. |
-| Objects and scripts | set_self<br>set_dude_obj<br>real_dude_obj<br>remove_script<br>get/set_script<br>obj_is_carrying_obj<br>loot_obj<br>dialog_obj<br>obj_under_cursor<br>get/set_object_data<br>get/set_flags<br>set_unique_id<br>set_scr_name<br>obj_is_openable<br>get/set_proto_data<br>get_object_ai_data | ✅ except set_dude_obj, set_scr_name | `get/set_object_data` maps supported object and `C_ATTACK_*` offsets instead of exposing arbitrary raw memory offsets. |
+| INI settings | get_ini_setting<br>get_ini_string<br>get_ini_section<br>get_ini_sections<br>get_ini_config<br>get_ini_config_db<br>set_ini_setting | ✅ except get_ini_config, get_ini_config_db | `modified_ini` is intentionally omitted as deprecated. |
+| Objects and scripts | set_self<br>set_dude_obj<br>real_dude_obj<br>remove_script<br>get/set_script<br>obj_is_carrying_obj<br>loot_obj<br>dialog_obj<br>obj_under_cursor<br>get/set_object_data<br>get/set_flags<br>set_unique_id<br>set_scr_name<br>obj_is_openable<br>get/set_proto_data<br>get_object_ai_data | implemented: set_self, get/set/remove_script, obj_is_carrying_obj, loot_obj, dialog_obj, obj_under_cursor, get_object_data, get_flags, set_flags, obj_is_openable, get_proto_data, set_proto_data | - |
 | Other / Game management | set_movie_path<br>stop/resume_game<br>mark_movie_played<br>game_loaded<br>get_game_mode<br>get_uptime<br>signal_close_game | implemented: game_loaded, get_game_mode, get_uptime, signal_close_game | - |
 | Gameplay tweaks | set_pickpocket_max<br>set_hit_chance_max<br>set_xp_mod<br>set_critter_hit_chance_mod<br>set_base_hit_chance_mod<br>set_hp_per_level_mod<br>gdialog_get_barter_mod<br>get/set_unspent_ap_bonus<br>get/set_unspent_ap_perk_bonus<br>set_base_pickpocket_mod<br>set_critter_pickpocket_mod<br>get/set_inven_ap_cost<br>set_drugs_data<br>get_kill_counter<br>mod_kill_counter<br>set_pipboy_available | implemented: gdialog_get_barter_mod, get/set_unspent_ap{_perk}_bonus, get/set_inven_ap_cost | - |
 | NPCs | inc_npc_level<br>get_npc_level<br>npc_engine_level_up | not implemented | - |
-| Hero Appearance | set_dm/df_model<br>hero_select_win<br>set_hero_race<br>set_hero_style | not implemented | - |
-| Events | add_g_timer_event<br>remove_timer_event<br>create_spatial<br>spatial_radius | not implemented | - |
-| Other | get_year<br>active_hand<br>toggle_active_hand<br>get/set_viewport_x/y<br>get_light_level<br>message_str_game<br>sneak_success<br>unwield_slot<br>add_extra_msg_file<br>get_metarule_table<br>metarule_exist<br> | ✅ except get/set_viewport_x/y, sneak_success  | `input_funcs_available`, `nb_create_char` are deprecated in sfall and intentionally absent in CE. `add_extra_msg_file` does not support the explicit `fileNumber` form in CE. |
+| Other | get_year<br>set_dm/df_model<br>active_hand<br>toggle_active_hand<br>get/set_viewport_x/y<br>hero_select_win<br>get_light_level<br>message_str_game<br>sneak_success<br>create_spatial<br>unwield_slot<br>add_g_timer_event<br>add_extra_msg_file<br>get_metarule_table<br>metarule_exist<br>remove_timer_event<br>spatial_radius | implemented: get_year, active_hand, toggle_active_hand, get_light_level, message_str_game, add_extra_msg_file, metarule_exist | `input_funcs_available`, `nb_create_char` are deprecated in sfall and intentionally absent in CE. `add_extra_msg_file` does not support the explicit `fileNumber` form in CE. |

 ## Hooks

@@ -110,14 +90,14 @@ See [`https://sfall-team.github.io/sfall/`](https://sfall-team.github.io/sfall/)
 | FindTarget | `HOOK_FINDTARGET` | 🚫 | (maybe) |
 | UseObjOn | `HOOK_USEOBJON` | ✅ | - |
 | UseObj | `HOOK_USEOBJ` | ✅ | CE notes an sfall-matching inconsistency around return code `2` behavior between interface contexts. |
-| RemoveInvenObj | `HOOK_REMOVEINVENOBJ` | ✅ | - |
+| RemoveInvenObj | `HOOK_REMOVEINVENOBJ` | 🚫 | - |
 | BarterPrice | `HOOK_BARTERPRICE` | ✅ | - |
-| ItemDamage | `HOOK_ITEMDAMAGE` | ✅ | - |
-| MoveCost | `HOOK_MOVECOST` | ✅ | - |
+| MoveCost | `HOOK_MOVECOST` | 🚫 | - |
+| ItemDamage | `HOOK_ITEMDAMAGE` | 🚫 | - |
 | AmmoCost | `HOOK_AMMOCOST` | ✅ | Requires `check_weapon_ammo_cost=1` if you want pre-attack ammo validation to respect per-shot/per-round overrides. |
 | KeyPress | `HOOK_KEYPRESS` | ✅ | Third hook arg is currently `0`; CE doesn't use VK codes. |
 | MouseClick | `HOOK_MOUSECLICK` | ✅ | - |
-| UseSkill | `HOOK_USESKILL` | ✅ | - |
+| UseSkill | `HOOK_USESKILL` | 🚫 | - |
 | Steal | `HOOK_STEAL` | ✅ | - |
 | WithinPerception | `HOOK_WITHINPERCEPTION` | ✅ | - |
 | InventoryMove | `HOOK_INVENTORYMOVE` | ✅ | - |
@@ -133,7 +113,7 @@ See [`https://sfall-team.github.io/sfall/`](https://sfall-team.github.io/sfall/)
 | UseAnimObj | `HOOK_USEANIMOBJ` | 🚫 | Et tu; (maybe) |
 | ExplosiveTimer | `HOOK_EXPLOSIVETIMER` | ✅ | - |
 | DescriptionObj | `HOOK_DESCRIPTIONOBJ` | 🚫 | Et tu |
-| UseSkillOn | `HOOK_USESKILLON` | ✅ | - |
+| UseSkillOn | `HOOK_USESKILLON` | 🚫 | Et tu |
 | OnExplosion | `HOOK_ONEXPLOSION` | 🚫 | (maybe) |
 | SubCombatDamage | `HOOK_SUBCOMBATDAMAGE` | 🚫 | (maybe) |
 | SetLighting | `HOOK_SETLIGHTING` | 🚫 | Et tu; (maybe) |
@@ -1,18 +0,0 @@
-# specify the cross compiler
-set(CMAKE_C_COMPILER ${CMAKE_SYSTEM_PROCESSOR}-w64-mingw32-gcc)
-set(CMAKE_CXX_COMPILER ${CMAKE_SYSTEM_PROCESSOR}-w64-mingw32-g++)
-set(CMAKE_RC_COMPILER ${CMAKE_SYSTEM_PROCESSOR}-w64-mingw32-windres)
-
-# where is the target environment
-set(CMAKE_FIND_ROOT_PATH /usr/${CMAKE_SYSTEM_PROCESSOR}-w64-mingw32)
-
-# search for programs in the build host directories
-set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
-# for libraries and headers in the target directories
-set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
-set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
-set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)
-
-# CMake determines how to examine dependencies based on the *host* system, leading to
-# a `file unknown error` unless the target platform is explicitly specified.
-set(CMAKE_GET_RUNTIME_DEPENDENCIES_PLATFORM "windows+pe")
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Vasilii RoginandCursor	6875fbd439	fix: address Codex review (exit codes, partial staging, PowerShell) - Propagate clang-format/xargs/docker exit codes in format_run_src and format_files_inplace; fix_formatting.sh exits with the real status. - Check $LASTEXITCODE after native clang-format in fix_formatting.ps1. - Pre-commit: git stash --keep-index before format so git add does not pull in unstaged hunks; restore stash after. Co-authored-by: Cursor <cursoragent@cursor.com>	2026-05-15 21:19:28 +03:00
Vasilii RoginandCursor	0d00b1d7d4	fix: consolidate format helpers and batch pre-commit Docker runs Share logic in format-common.sh (fix_formatting.sh sources it). Pre-commit formats all staged files in one clang-format/Docker invocation. Skip docker --user on Windows; harden ps1 Docker command quoting and use relative paths. Co-authored-by: Cursor <cursoragent@cursor.com>	2026-05-15 16:13:40 +03:00
Vasilii RoginandCursor	6727c15970	feat: add Docker fallback to fix_formatting.ps1 on Windows Match fix_formatting.sh: use silkeh/clang:14 when clang-format 14 is not on PATH. Omit docker --user on Windows; keep it on Linux/macOS. Co-authored-by: Cursor <cursoragent@cursor.com>	2026-05-15 16:03:25 +03:00
Vasilii RoginandCursor	3301a299fb	chore: drop setup-git-hooks scripts, document git config one-liner pre-commit is already executable in git (100755). Contributors only need git config --local core.hooksPath .githooks once per clone. Co-authored-by: Cursor <cursoragent@cursor.com>	2026-05-15 15:58:27 +03:00
Vasilii RoginandCursor	cf09aefc79	feat: add optional pre-commit hook for staged C++ formatting Add .githooks/pre-commit (clang-format 14 on staged .cc/.h, warn-only if unavailable) and setup scripts for core.hooksPath. Document in CONTRIBUTING.md and verify the hook on the macOS format CI job. Co-authored-by: Cursor <cursoragent@cursor.com>	2026-05-15 15:47:36 +03:00
Vasilii RoginandCursor	eea43435ac	ci: verify fix_formatting scripts on macOS and Windows Add code-format-macos and code-format-windows jobs that install LLVM 14 and run --version/--check. Clarify that winget is not available on every Windows install and may not offer clang-format 14. Co-authored-by: Cursor <cursoragent@cursor.com>	2026-05-15 15:28:57 +03:00
Vasilii RoginandCursor	64de200bc3	fix: harden formatting scripts and install clang-format-14 in CI Install clang-format-14 on GitHub runners so CI does not depend on Docker. Warn when a non-14 clang-format is on PATH, require repo root, and format Windows files one-by-one to avoid command-line limits. Drop an invalid .clang-format key left over from the style dump. Co-authored-by: Cursor <cursoragent@cursor.com>	2026-05-15 15:26:08 +03:00
Vasilii RoginandCursor	33ad3bc0f2	feat: use native clang-format 14 when available, add Windows script fix_formatting.sh prefers local clang-format 14 and only uses Docker as fallback. Add fix_formatting.ps1 for Windows/Visual Studio devs without Docker, with install hints when the tool is missing. Co-authored-by: Cursor <cursoragent@cursor.com>	2026-05-15 15:23:29 +03:00
Vasilii RoginandCursor	d1f45423da	docs: explain clang-format cross-version limits in .clang-format Document that clang-format has no version conditionals, older binaries reject unknown keys, and only 14–16 share the same output with this file. Co-authored-by: Cursor <cursoragent@cursor.com>	2026-05-15 15:13:42 +03:00
Vasilii RoginandCursor	a8870fbb04	chore: route all formatting through fix_formatting.sh Add --check, --dry-run, and --version flags for CI. Use the script in format check and auto-format workflows; simplify PR template to only reference ./fix_formatting.sh. Co-authored-by: Cursor <cursoragent@cursor.com>	2026-05-15 14:51:48 +03:00
Vasilii RoginandCursor	4713bb6102	chore: pin formatting to clang-format 14 Use an explicit clang-format 14 config and silkeh/clang:14 in CI, auto-format, and fix_formatting.sh. Clang 14–16 produce identical output with this config; clang 17+ may still reformat a few files. Co-authored-by: Cursor <cursoragent@cursor.com>	2026-05-15 14:50:34 +03:00
Vasilii RoginandCursor	74dfde35cd	chore: expand .clang-format and pin CI to clang-format 18 Expand the style file to an explicit clang-format 18 config so local formatters do not infer different WebKit defaults. Run the format check job via silkeh/clang:18 (matching auto-format) instead of Ubuntu's clang-format 14, and document the pinned version in the PR template. Co-authored-by: Cursor <cursoragent@cursor.com>	2026-05-15 14:44:24 +03:00