Update to latest 12.1 PTR build: ForbiddenAspect/security expansion, Aura Container systems, BattleNet/EditMode/Housing additions; regen auto pages

Author: DanderBot

docs/patches/12.1.0/auras.md

@@ -110,3 +110,25 @@
 **Changed:**
 
 - **`TooltipDataLineType`** (enum) — added `ItemSpellTriggerOnUse (44), ItemSpellTriggerOnEquip (45), ItemSpellTriggerOnProc (46)` — tag tooltip lines for an item's Use/Equip/on-proc spell effects.
+
+---
+
+## Later PTR build additions (2026-06-20)
+
+### ForbiddenAspectConstantsDocumentation
+
+The forbidden-partition security layer behind Aura Buttons expanded substantially.
+
+**New:**
+
+- `ForbiddenAspectInheritance` (enum) — how forbidden aspects propagate. Values: `Parent` (through object hierarchies), `Layout` (through the anchor graph).
+
+**Changed:** `ForbiddenAspect` (enum) — added values (bitmask), each restricting a facet of the security system:
+
+- `UntrustedScriptExecution` (4) — blocks execution of all scripts on the object (propagates to children).
+- `UntrustedLayoutScriptExecution` (8) — blocks layout scripts (e.g. OnSizeChanged); propagates to children and anything anchored to it.
+- `EventRegistrations` (16) — blocks querying/modifying registered script events.
+- `AlwaysPropagateInput` (32) — forces mouse/keypress input propagation (propagates to children).
+- `ScriptedInput` (64) — blocks APIs that trigger synthetic input from scripts.
+- `QueryFocus` (128) — blocks APIs that query input focus state.
+- `Shown` (256) — blocks control of a region's shown state.

docs/patches/12.1.0/edit-mode.md

@@ -51,3 +51,19 @@
 
 - **`GetFlavorNodeForCompanion(companionID: number?) → nodeID: number`** — the flavor trait node ID for a delve companion.
 - **`GetFlavorNodeNameForCompanion(companionID: number?) → name: cstring`** — the display name of that flavor node.
+
+---
+
+## Later PTR build additions (2026-06-20)
+
+### EditModeManagerConstantsDocumentation
+
+**New:**
+
+- `EditModeLossOfControlSetting` (enum) — settings for the Loss of Control edit-mode system. Values: `Size`.
+- `RaidDispelOverlayType` (enum) — raid dispel overlay style. Values: `Disabled`, `UseDebuffColor`, `UseBlack`.
+
+**Changed:**
+
+- `EditModeSystem` (enum) — added `LossOfControl`.
+- `EditModeAccountSetting` (enum) — added `ShowLossOfControl`.

docs/patches/12.1.0/field-level.md

@@ -50,6 +50,7 @@ Changes *inside* API entries that exist in both builds — struct fields, enum v
   isOnline: bool
   isGameBusy: bool
   isGameAFK: bool
++ isAppearOffline: bool
   wowProjectID: number?
   characterName: string?
   realmName: string?
@@ -286,13 +287,14 @@ Info for an instance of Housing Decor that has been/is being placed within a Hou
   uiTextureKit: textureKit
   hideWarboardHeader: bool
   keepOpenAfterChoice: bool
-  showChoicesAsList: bool
   requiresSelection: bool
-  showChoicesAsGrid: bool
 + hideAnswerArt: bool
++ playerChoiceLayout: PlayerChoiceLayout
   options: table
   soundKitID: number?
   closeUISoundKitID: number?
+- showChoicesAsList: bool
+- showChoicesAsGrid: bool
 ```
 
 ### `TieredEntranceTierInfo` (struct)
@@ -307,6 +309,7 @@ Info for an instance of Housing Decor that has been/is being placed within a Hou
   modifierUIWidgetSetID: number
   lockedReason: cstring?
 + isLFG: bool
++ difficultyID: number
 ```
 
 ### `UnitPrivateAuraAnchorInfo` (struct)
@@ -332,17 +335,20 @@ Info for an instance of Housing Decor that has been/is being placed within a Hou
 - **`ClubStreamType`** — added `Discord`.
 - **`CompanionConfigSlotTypes`** — added `Flavor`.
 - **`CooldownViewerCategory`** — added `EquipSlotEssential`, `EquipSlotTracked`, `GroupBuff`, `SpecAgnosticEssential`, `SpecAgnosticTracked`.
-- **`EditModeAccountSetting`** — added `ShowRaidWarning`.
+- **`EditModeAccountSetting`** — added `ShowLossOfControl`, `ShowRaidWarning`.
 - **`EditModeMinimapSetting`** — added `IconScale`.
-- **`EditModeSystem`** — added `RaidWarning`.
+- **`EditModeSystem`** — added `LossOfControl`, `RaidWarning`.
 - **`EditModeUnitFrameSetting`** — added `BuffIconSize`, `DebuffIconSize`; removed `IconSize`.
 - **`FragmentID`** — added `FMapObject`, `FWorldStateListenerData`.
 - **`FrameTutorialAccount`** — added `HousingPetBeds`.
 - **`HouseFinderSuggestionReason`** — added `Relinquished`.
-- **`HousingResult`** — added `BlueprintCodeInvalid`, `BlueprintGenericExportError`, `BlueprintGenericImportError`, `BlueprintLocationInvalid`, `BlueprintNameInvalid`, `BlueprintNotFound`, `BlueprintRequirementsUnmet`, `BlueprintStorageLimit`, `BlueprintTypeInvalid`, `BlueprintVersionInvalid`, `InsufficientRoomBudget`, `InvalidExteriorDocument`, `InvalidInteriorDocument`, `RoomPlacementOutOfBounds`.
+- **`HousingResult`** — added `AccountBanned`, `BlueprintCodeInvalid`, `BlueprintGenericExportError`, `BlueprintGenericImportError`, `BlueprintLocationInvalid`, `BlueprintNameInvalid`, `BlueprintNotFound`, `BlueprintRequirementsUnmet`, `BlueprintRoomPlacementRequired`, `BlueprintStorageLimit`, `BlueprintTypeInvalid`, `BlueprintVersionInvalid`, `InsufficientRoomBudget`, `InvalidExteriorDocument`, `InvalidInteriorDocument`, `MaxPlacedDecorReached`, `MaxStorageDecorReached`, `RoomPlacementOutOfBounds`; removed `MaxDecorReached`.
 - **`NamePlateStyle`** — added `Classic`.
 - **`PingResult`** — added `FailedSilent`.
 - **`PingSubjectType`** — added `ActionOnCooldown`, `ActionReady`, `ActionUnavailable`.
+- **`ReportMajorCategory`** — added `InappropriateBlueprint`.
+- **`ReportMinorCategory`** — added `HousingBlueprint`.
+- **`ReportType`** — added `HousingBlueprint`.
 - **`SecretAspect`** — added `RadialProgress`.
 - **`TieredEntranceType`** — added `Lairs`.
 - **`TooltipDataLineType`** — added `ItemSpellTriggerOnEquip`, `ItemSpellTriggerOnProc`, `ItemSpellTriggerOnUse`.
@@ -527,5 +533,6 @@ Creates a secure delegate closure for a Lua function. The delegate invokes the o
 - **`ChatMsgWhisper`** — payload `text: cstring, playerName: cstring, languageName: cstring, channelName: cstring, playerName2: cstring, specialFlags: cstring, zoneChannelID: number, channelIndex: number, channelBaseName: cstring, languageID: number, lineID: number, guid: WOWGUID, bnSenderID: number, isMobile: bool, isSubtitle: bool, hideSenderInLetterbox: bool, suppressRaidIcons: bool` → `text: cstring, playerName: cstring, languageName: cstring, channelName: cstring, playerName2: cstring, specialFlags: cstring, zoneChannelID: number, channelIndex: number, channelBaseName: cstring, languageID: number, lineID: number, guid: WOWGUID, bnSenderID: number, isMobile: bool, isSubtitle: bool, hideSenderInLetterbox: bool, suppressRaidIcons: bool, discordInfo: DiscordChatInfo`
 - **`ChatMsgWhisperInform`** — payload `text: cstring, playerName: cstring, languageName: cstring, channelName: cstring, playerName2: cstring, specialFlags: cstring, zoneChannelID: number, channelIndex: number, channelBaseName: cstring, languageID: number, lineID: number, guid: WOWGUID, bnSenderID: number, isMobile: bool, isSubtitle: bool, hideSenderInLetterbox: bool, suppressRaidIcons: bool` → `text: cstring, playerName: cstring, languageName: cstring, channelName: cstring, playerName2: cstring, specialFlags: cstring, zoneChannelID: number, channelIndex: number, channelBaseName: cstring, languageID: number, lineID: number, guid: WOWGUID, bnSenderID: number, isMobile: bool, isSubtitle: bool, hideSenderInLetterbox: bool, suppressRaidIcons: bool, discordInfo: DiscordChatInfo`
 - **`ChatMsgYell`** — payload `text: cstring, playerName: cstring, languageName: cstring, channelName: cstring, playerName2: cstring, specialFlags: cstring, zoneChannelID: number, channelIndex: number, channelBaseName: cstring, languageID: number, lineID: number, guid: WOWGUID, bnSenderID: number, isMobile: bool, isSubtitle: bool, hideSenderInLetterbox: bool, suppressRaidIcons: bool` → `text: cstring, playerName: cstring, languageName: cstring, channelName: cstring, playerName2: cstring, specialFlags: cstring, zoneChannelID: number, channelIndex: number, channelBaseName: cstring, languageID: number, lineID: number, guid: WOWGUID, bnSenderID: number, isMobile: bool, isSubtitle: bool, hideSenderInLetterbox: bool, suppressRaidIcons: bool, discordInfo: DiscordChatInfo`
+- **`HousingLayoutFloorplanSelectionChanged`** — Fired when a room option in the House Chest has been selected or deselected — payload `hasSelection: bool, roomID: number` → `hasSelection: bool, roomID: number, blueprintShareCode: cstring?`
 - **`SpellUpdateCooldown`** — payload `spellID: number?, baseSpellID: number?, category: number?, startRecoveryCategory: number?` → `spellID: number?, baseSpellID: number?, category: number?, startRecoveryCategory: number?, itemID: number?`
 

docs/patches/12.1.0/frames.md

@@ -99,3 +99,28 @@
 **New:**
 
 - **`SetIconScale(scale: number)`** — sets the scale applied to minimap icons.
+
+---
+
+## Later PTR build additions (2026-06-20)
+
+### FrameScript
+
+**New:**
+
+- `settablesecurity(table: LuaValueVariant, option: TableSecurityOption)` — applies a table security option (`DisallowTaintedAccess`, `DisallowSecretKeys`, `SecretWrapContents`). Replaces the removed `SetTableSecurityOption`.
+
+**Removed:**
+
+- `SetTableSecurityOption` — replaced by `settablesecurity`.
+
+### SimpleFrameScriptObjectAPI
+
+**New:**
+
+- `GetForbiddenAspects() → aspects: ForbiddenAspect` — the mask of all forbidden aspects applied to this object.
+- `GetInheritableForbiddenAspects(inheritance: ForbiddenAspectInheritance) → aspects: ForbiddenAspect` — the mask of forbidden aspects that can propagate to others.
+
+**Removed:**
+
+- `HasAnyForbiddenAspect` (singular) — removed; the plural `HasAnyForbiddenAspects(aspects: ForbiddenAspect) → bool` is retained.

docs/patches/12.1.0/gameplay.md

@@ -65,3 +65,28 @@
 **Removed:**
 
 - **`GetDyeColorForItem(itemLinkOrID: ItemInfo) → dyeColorID: number?`** and `GetDyeColorForItemLocation(itemLocation: ItemLocation) → dyeColorID: number?` — replaced by the plural versions that return a table of IDs.
+
+---
+
+## Later PTR build additions (2026-06-20)
+
+### C_EncounterJournal (EncounterJournalDocumentation)
+
+**New:**
+
+- `GetDungeonEntrancesForMap(uiMapID: number) → dungeonEntrances: table<DungeonEntranceMapInfo>` — dungeon entrances on a UI map.
+- `InstanceHasDifficultyID(difficultyID: number) → bool` — whether the current instance supports a difficulty id.
+
+### C_Navigation (InGameNavigationDocumentation)
+
+**New:**
+
+- `GetNextWaypointForMap(uiMapID: number) → x: number, y: number, waypointDescription: string` — the next waypoint on a UI map (may return nothing). Moved from `C_SuperTrack` (which removed it).
+
+### PlayerChoiceConstantsDocumentation *(new namespace)*
+
+**New:**
+
+- `PlayerChoiceFlags` (enum, bitmask) — display/behaviour flags, e.g. `InfiniteRange`, `KeepOpenAfterChoice`, `ShowChoicesAsList` / `Grid` / `Columns`, `RequiresSelection`, `HideAnswerArt`.
+- `PlayerChoiceLayout` (enum) — `Default`, `Grid`, `List`, `Columns`.
+- `PlayerChoiceResponseFlags` (enum) — per-response flags, e.g. `ShowAnswerDisabled`, `ShowArtDesaturated`, `HideButton`, `ShowAnswerSelected`.