From 4ea36250bec1d1d2f53b6ecfb2db7f06d3f24941 Mon Sep 17 00:00:00 2001
From: Kelsi <kelsihates2fa@gmail.com>
Date: Mon, 30 Mar 2026 18:42:02 -0700
Subject: [PATCH] chore: expand gitignore, document PKGBUILD deps, fix branch
 ref
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- .gitignore: add compile_commands.json, language server caches
  (.ccls-cache, .cache/clangd), and tag files (ctags, cscope)
- PKGBUILD: add per-dependency comments explaining purpose (SRP auth,
  Warden emulation, MPQ extraction, shader compilation, etc.)
- PKGBUILD: fix source branch from main → master (matches remote HEAD)
---
 .gitignore | 14 ++++++++++++++
 PKGBUILD   | 34 +++++++++++++++++-----------------
 2 files changed, 31 insertions(+), 17 deletions(-)

diff --git a/.gitignore b/.gitignore
index fb1c52e0..6b69ddff 100644
--- a/.gitignore
+++ b/.gitignore
@@ -46,6 +46,20 @@ wowee
 *~
 .DS_Store
 
+# Compilation database (regenerated by cmake)
+compile_commands.json
+
+# Language server caches
+.ccls
+.ccls-cache/
+.cache/clangd/
+
+# Tags
+tags
+TAGS
+.tags
+cscope.out
+
 # External dependencies (except submodules and vendored headers)
 extern/*
 !extern/.gitkeep
diff --git a/PKGBUILD b/PKGBUILD
index 013be0a1..ca419ffe 100644
--- a/PKGBUILD
+++ b/PKGBUILD
@@ -9,28 +9,28 @@ arch=('x86_64')
 url="https://github.com/Kelsidavis/WoWee"
 license=('MIT')
 depends=(
-  'sdl2'
-  'vulkan-icd-loader'
-  'openssl'
-  'zlib'
-  'ffmpeg'
-  'unicorn'
-  'glew'
-  'libx11'
-  'stormlib'  # AUR — required at runtime by wowee-extract-assets (libstorm.so)
+  'sdl2'              # Windowing and event loop
+  'vulkan-icd-loader' # Vulkan runtime (GPU driver communication)
+  'openssl'           # SRP6a auth protocol (key exchange + RC4 encryption)
+  'zlib'              # Network packet decompression and Warden module inflate
+  'ffmpeg'            # Video playback (login cinematics)
+  'unicorn'           # Warden anti-cheat x86 emulation (cross-platform, no Wine)
+  'glew'              # OpenGL extensions (legacy fallback, linked but unused at runtime)
+  'libx11'            # X11 windowing support
+  'stormlib'          # AUR — MPQ extraction (wowee-extract-assets uses libstorm.so)
 )
 makedepends=(
-  'git'
-  'cmake'
-  'pkgconf'
-  'glm'
-  'vulkan-headers'
-  'shaderc'
-  'python'
+  'git'               # Clone submodules (imgui, vk-bootstrap)
+  'cmake'             # Build system
+  'pkgconf'           # Dependency detection
+  'glm'               # Header-only math library (vectors, matrices, quaternions)
+  'vulkan-headers'    # Vulkan API definitions (build-time only)
+  'shaderc'           # GLSL → SPIR-V shader compilation
+  'python'            # Opcode registry generation and DBC validation scripts
 )
 provides=('wowee')
 conflicts=('wowee')
-source=("${pkgname}::git+https://github.com/Kelsidavis/WoWee.git#branch=main"
+source=("${pkgname}::git+https://github.com/Kelsidavis/WoWee.git#branch=master"
         "git+https://github.com/ocornut/imgui.git"
         "git+https://github.com/charles-lunarg/vk-bootstrap.git")
 sha256sums=('SKIP' 'SKIP' 'SKIP')