Update commit hashes and add function replacement patterns for optional parameters

Author: Logonz

WoW-API/COMMIT_HASHES.md

@@ -5,4 +5,4 @@ This API documentation was generated using the following commit hashes:
 - **vscode-wow-api**: `master` @ `a2e82582ac3f38c096ecc192fe701c3ba901d95d`
 - **WoWUI**: `vanilla` @ `b6262ddd722e41b0757e7c6ae2e2a83563044152`
 
-Generated on: 2025-12-10 15:12:04
+Generated on: 2025-12-10 16:04:56

WoW-API/_UI/Blizzard_DeprecatedSpellBook/Deprecated_SpellBook.lua

@@ -24,7 +24,7 @@ do
 	---@deprecated
 	---Deprecated by [C_SpellBook.IsSpellInSpellBook](https://warcraft.wiki.gg/wiki/API_C_SpellBook.IsSpellInSpellBook)
 	---@param spellID number
-	---@param isPet boolean
+	---@param isPet boolean?
 	---@return boolean isInSpellBook
 	function IsSpellKnown(spellID, isPet)
 		local spellBank = isPet and Enum.SpellBookSpellBank.Pet or Enum.SpellBookSpellBank.Player;
@@ -35,7 +35,7 @@ do
 	---@deprecated
 	---Deprecated by [C_SpellBook.IsSpellInSpellBook](https://warcraft.wiki.gg/wiki/API_C_SpellBook.IsSpellInSpellBook)
 	---@param spellID number
-	---@param isPet boolean
+	---@param isPet boolean?
 	---@return boolean isInSpellBook
 	function IsSpellKnownOrOverridesKnown(spellID, isPet)
 		local spellBank = isPet and Enum.SpellBookSpellBank.Pet or Enum.SpellBookSpellBank.Player;

generator/inject_annotations.py

@@ -3,6 +3,7 @@
 import re
 import argparse
 from inject_mixin_skip import MIXIN_SKIP_PATTERNS, FUNCTION_SKIP_PATTERNS
+from inject_replace import MIXIN_REPLACEMENT_PATTERNS, FUNCTION_REPLACEMENT_PATTERNS
 
 
 def parse_annotations(source_dir):
@@ -176,6 +177,31 @@ def inject_mixins(target_dir, mixins_map, dry_run=False):
                                 already_present = True
 
                         if not already_present and anno_lines:
+                            # --- Apply Regex Replacements (Mixins) ---
+                            replacement_rules = MIXIN_REPLACEMENT_PATTERNS.get(
+                                mixin_name, []
+                            )
+                            if replacement_rules:
+                                temp_lines = []
+                                for al_line in anno_lines:
+                                    replaced = False
+                                    for pattern, replacement in replacement_rules:
+                                        if re.match(pattern, al_line):
+                                            new_line = re.sub(
+                                                pattern, replacement, al_line
+                                            )
+                                            if al_line.endswith(
+                                                "\n"
+                                            ) and not new_line.endswith("\n"):
+                                                new_line += "\n"
+                                            temp_lines.append(new_line)
+                                            replaced = True
+                                            break
+                                    if not replaced:
+                                        temp_lines.append(al_line)
+                                anno_lines = temp_lines
+                            # -----------------------------------------
+
                             if dry_run:
                                 print(
                                     f"[Dry Run] Injecting mixin docs for: {mixin_name} in {path} (from {source_file})"
@@ -427,6 +453,32 @@ def inject_annotations(target_dir, annotations_map, dry_run=False):
                             # Inject annotations
                             # We prepend the indentation found on the function line
 
+                            # --- Apply Regex Replacements (Functions) ---
+                            replacement_rules = FUNCTION_REPLACEMENT_PATTERNS.get(
+                                func_name, []
+                            )
+                            if replacement_rules:
+                                temp_lines = []
+                                for al_line in anno_lines:
+                                    replaced = False
+                                    for pattern, replacement in replacement_rules:
+                                        if re.match(pattern, al_line):
+                                            new_line = re.sub(
+                                                pattern, replacement, al_line
+                                            )
+                                            # Ensure newline if lost
+                                            if al_line.endswith(
+                                                "\n"
+                                            ) and not new_line.endswith("\n"):
+                                                new_line += "\n"
+                                            temp_lines.append(new_line)
+                                            replaced = True
+                                            break
+                                    if not replaced:
+                                        temp_lines.append(al_line)
+                                anno_lines = temp_lines
+                            # --------------------------------------------
+
                             # Get skip patterns for this function
                             skip_patterns = [
                                 re.compile(p)

generator/inject_replace.py

@@ -0,0 +1,22 @@
+# Configuration for replacing matched annotation lines when injecting
+# Key: Function Name or Mixin Name
+# Value: List of (regex_pattern, replacement_string) tuples
+FUNCTION_REPLACEMENT_PATTERNS = {
+    # Spellbook functions with isPet parameter should have it as optional
+    "IsSpellKnownOrOverridesKnown": [
+        (r".*param\s*isPet\s*boolean", "---@param isPet boolean?"),
+    ],
+    "IsSpellKnown": [
+        (r".*param\s*isPet\s*boolean", "---@param isPet boolean?"),
+    ],
+}
+
+
+# Configuration for replacing matched annotation lines when injecting
+# Key: Mixin Name or Mixin Name
+# Value: List of (regex_pattern, replacement_string) tuples
+MIXIN_REPLACEMENT_PATTERNS = {
+    # "PlayerLocationMixin": [
+    #     (r".*field\s*IsGUID", "---@field IsGUID boolean?"),
+    # ],
+}