bc-stubs 130.0.0 → 131.0.0-Alpha.1

package/bc/Assets/Female3DCG/Female3DCG.d.ts

@@ -352,31 +352,45 @@ declare namespace AssetPoseMapping {
         let Hogtied_20: "Hide";
         export { Hogtied_20 as Hogtied };
     }
-    namespace AnkletLeft {
+    namespace Jewelry {
         let AllFours_23: "Hide";
         export { AllFours_23 as AllFours };
         let Hogtied_21: "Hide";
         export { Hogtied_21 as Hogtied };
-        let Kneel_7: "Hide";
+        let Kneel_7: "Kneel";
         export { Kneel_7 as Kneel };
-        let KneelingSpread_5: "Hide";
+        let KneelingSpread_5: "KneelingSpread";
         export { KneelingSpread_5 as KneelingSpread };
         let LegsClosed_4: "LegsClosed";
         export { LegsClosed_4 as LegsClosed };
         let Spread_3: "Spread";
         export { Spread_3 as Spread };
     }
-    namespace HandAccessoryLeft {
-        let AllFours_24: "AllFours";
+    namespace AnkletLeft {
+        let AllFours_24: "Hide";
         export { AllFours_24 as AllFours };
+        let Hogtied_22: "Hide";
+        export { Hogtied_22 as Hogtied };
+        let Kneel_8: "Hide";
+        export { Kneel_8 as Kneel };
+        let KneelingSpread_6: "Hide";
+        export { KneelingSpread_6 as KneelingSpread };
+        let LegsClosed_5: "LegsClosed";
+        export { LegsClosed_5 as LegsClosed };
+        let Spread_4: "Spread";
+        export { Spread_4 as Spread };
+    }
+    namespace HandAccessoryLeft {
+        let AllFours_25: "AllFours";
+        export { AllFours_25 as AllFours };
         let BackBoxTie_8: "BackBoxTie";
         export { BackBoxTie_8 as BackBoxTie };
         let BackCuffs_8: "BackCuffs";
         export { BackCuffs_8 as BackCuffs };
         let BackElbowTouch_8: "BackElbowTouch";
         export { BackElbowTouch_8 as BackElbowTouch };
-        let Hogtied_22: "Hide";
-        export { Hogtied_22 as Hogtied };
+        let Hogtied_23: "Hide";
+        export { Hogtied_23 as Hogtied };
         let OverTheHead_8: "OverTheHead";
         export { OverTheHead_8 as OverTheHead };
         let TapedHands_5: "TapedHands";
@@ -385,46 +399,46 @@ declare namespace AssetPoseMapping {
         export { Yoked_9 as Yoked };
     }
     namespace Nipples {
-        let AllFours_25: "Hide";
-        export { AllFours_25 as AllFours };
-    }
-    namespace Panties {
         let AllFours_26: "Hide";
         export { AllFours_26 as AllFours };
-        let Hogtied_23: "Hide";
-        export { Hogtied_23 as Hogtied };
     }
-    namespace Pussy {
+    namespace Panties {
         let AllFours_27: "Hide";
         export { AllFours_27 as AllFours };
         let Hogtied_24: "Hide";
         export { Hogtied_24 as Hogtied };
     }
-    namespace AnkletRight {
+    namespace Pussy {
         let AllFours_28: "Hide";
         export { AllFours_28 as AllFours };
         let Hogtied_25: "Hide";
         export { Hogtied_25 as Hogtied };
-        let Kneel_8: "Hide";
-        export { Kneel_8 as Kneel };
-        let KneelingSpread_6: "Hide";
-        export { KneelingSpread_6 as KneelingSpread };
-        let LegsClosed_5: "LegsClosed";
-        export { LegsClosed_5 as LegsClosed };
-        let Spread_4: "Spread";
-        export { Spread_4 as Spread };
     }
-    namespace HandAccessoryRight {
-        let AllFours_29: "AllFours";
+    namespace AnkletRight {
+        let AllFours_29: "Hide";
         export { AllFours_29 as AllFours };
+        let Hogtied_26: "Hide";
+        export { Hogtied_26 as Hogtied };
+        let Kneel_9: "Hide";
+        export { Kneel_9 as Kneel };
+        let KneelingSpread_7: "Hide";
+        export { KneelingSpread_7 as KneelingSpread };
+        let LegsClosed_6: "LegsClosed";
+        export { LegsClosed_6 as LegsClosed };
+        let Spread_5: "Spread";
+        export { Spread_5 as Spread };
+    }
+    namespace HandAccessoryRight {
+        let AllFours_30: "AllFours";
+        export { AllFours_30 as AllFours };
         let BackBoxTie_9: "BackBoxTie";
         export { BackBoxTie_9 as BackBoxTie };
         let BackCuffs_9: "BackCuffs";
         export { BackCuffs_9 as BackCuffs };
         let BackElbowTouch_9: "BackElbowTouch";
         export { BackElbowTouch_9 as BackElbowTouch };
-        let Hogtied_26: "Hide";
-        export { Hogtied_26 as Hogtied };
+        let Hogtied_27: "Hide";
+        export { Hogtied_27 as Hogtied };
         let OverTheHead_9: "OverTheHead";
         export { OverTheHead_9 as OverTheHead };
         let TapedHands_6: "TapedHands";
@@ -433,20 +447,6 @@ declare namespace AssetPoseMapping {
         export { Yoked_10 as Yoked };
     }
     namespace Shoes {
-        let AllFours_30: "Hide";
-        export { AllFours_30 as AllFours };
-        let Hogtied_27: "Hogtied";
-        export { Hogtied_27 as Hogtied };
-        let Kneel_9: "Kneel";
-        export { Kneel_9 as Kneel };
-        let KneelingSpread_7: "KneelingSpread";
-        export { KneelingSpread_7 as KneelingSpread };
-        let LegsClosed_6: "LegsClosed";
-        export { LegsClosed_6 as LegsClosed };
-        let Spread_5: "Spread";
-        export { Spread_5 as Spread };
-    }
-    namespace Socks {
         let AllFours_31: "Hide";
         export { AllFours_31 as AllFours };
         let Hogtied_28: "Hogtied";
@@ -460,7 +460,7 @@ declare namespace AssetPoseMapping {
         let Spread_6: "Spread";
         export { Spread_6 as Spread };
     }
-    namespace SocksLeft {
+    namespace Socks {
         let AllFours_32: "Hide";
         export { AllFours_32 as AllFours };
         let Hogtied_29: "Hogtied";
@@ -474,7 +474,7 @@ declare namespace AssetPoseMapping {
         let Spread_7: "Spread";
         export { Spread_7 as Spread };
     }
-    namespace SocksRight {
+    namespace SocksLeft {
         let AllFours_33: "Hide";
         export { AllFours_33 as AllFours };
         let Hogtied_30: "Hogtied";
@@ -488,17 +488,31 @@ declare namespace AssetPoseMapping {
         let Spread_8: "Spread";
         export { Spread_8 as Spread };
     }
-    namespace Suit {
+    namespace SocksRight {
         let AllFours_34: "Hide";
         export { AllFours_34 as AllFours };
+        let Hogtied_31: "Hogtied";
+        export { Hogtied_31 as Hogtied };
+        let Kneel_13: "Kneel";
+        export { Kneel_13 as Kneel };
+        let KneelingSpread_11: "KneelingSpread";
+        export { KneelingSpread_11 as KneelingSpread };
+        let LegsClosed_10: "LegsClosed";
+        export { LegsClosed_10 as LegsClosed };
+        let Spread_9: "Spread";
+        export { Spread_9 as Spread };
+    }
+    namespace Suit {
+        let AllFours_35: "Hide";
+        export { AllFours_35 as AllFours };
         let BackBoxTie_10: "BackBoxTie";
         export { BackBoxTie_10 as BackBoxTie };
         let BackCuffs_10: "BackCuffs";
         export { BackCuffs_10 as BackCuffs };
         let BackElbowTouch_10: "BackElbowTouch";
         export { BackElbowTouch_10 as BackElbowTouch };
-        let Hogtied_31: "Hogtied";
-        export { Hogtied_31 as Hogtied };
+        let Hogtied_32: "Hogtied";
+        export { Hogtied_32 as Hogtied };
         let OverTheHead_10: "OverTheHead";
         export { OverTheHead_10 as OverTheHead };
         let TapedHands_7: "TapedHands";
@@ -507,26 +521,30 @@ declare namespace AssetPoseMapping {
         export { Yoked_11 as Yoked };
     }
     namespace SuitLower {
-        let AllFours_35: "Hide";
-        export { AllFours_35 as AllFours };
-        let Hogtied_32: "Hogtied";
-        export { Hogtied_32 as Hogtied };
-        let Kneel_13: "Kneel";
-        export { Kneel_13 as Kneel };
-        let KneelingSpread_11: "KneelingSpread";
-        export { KneelingSpread_11 as KneelingSpread };
-        let LegsClosed_10: "LegsClosed";
-        export { LegsClosed_10 as LegsClosed };
-        let Spread_9: "Spread";
-        export { Spread_9 as Spread };
-    }
-    namespace Wings {
         let AllFours_36: "Hide";
         export { AllFours_36 as AllFours };
-        let Hogtied_33: "Hide";
+        let Hogtied_33: "Hogtied";
         export { Hogtied_33 as Hogtied };
+        let Kneel_14: "Kneel";
+        export { Kneel_14 as Kneel };
+        let KneelingSpread_12: "KneelingSpread";
+        export { KneelingSpread_12 as KneelingSpread };
+        let LegsClosed_11: "LegsClosed";
+        export { LegsClosed_11 as LegsClosed };
+        let Spread_10: "Spread";
+        export { Spread_10 as Spread };
+    }
+    namespace Wings {
+        let AllFours_37: "Hide";
+        export { AllFours_37 as AllFours };
+        let Hogtied_34: "Hide";
+        export { Hogtied_34 as Hogtied };
     }
 }
+/** @type {string[]} */
+declare const AssetMalePantiesList: string[];
+/** @type {string[]} */
+declare const AssetMaleChasityCagesList: string[];
 /**
  * 3D Custom Girl based assets
  * @type {AssetGroupDefinition[]}

package/bc/NativeDeclarations/{Preference.d.ts → Screens/Character/Preference/Preference.d.ts}

@@ -208,3 +208,9 @@ type PreferenceExtensionsMenuButtonInfo = {
 };
 
 // #endregion
+
+//#region Advanced rules
+
+type AdvancedRuleScreen = keyof typeof MainHallAllowIDToScreenMap;
+
+//#endregion

package/bc/NativeDeclarations/{Commands.d.ts → Screens/Online/ChatRoom/Commands.d.ts}

@@ -6,7 +6,7 @@ interface ICommand {
   /** Reference to another command, used for aliases */
   Reference?: string;
   /** The function that handles the command */
-  Action?: (this: ICommand[], argumentsString: string, message: string, arguments: string[]) => void;
+  Action?: (this: ICommand, argumentsString: string, message: string, arguments: string[]) => void;
   /** Function that returns whether the command can be executed */
   Prerequisite?: (this: ICommand) => boolean;
   /** Function to execute on autocomplete key (Tab default) press if chat input matches tag */

package/bc/NativeDeclarations/{Element.d.ts → Scripts/Element.d.ts}

@@ -78,3 +78,12 @@ declare namespace ElementSearchableDropdown {
 		parent?: Node;
 	}
 }
+
+declare namespace ElementSearchQuery {
+	interface Options {
+		/** Custom classes to-be applied to the hightlighted text. Defaults to `"highlight"`. */
+		classList?: readonly string[];
+		/** Custom tag to-be applied to the hightlighted text. Defaults to `<em>`. */
+		tag?: keyof HTMLElementTagNameMap;
+	}
+}

package/bc/NativeDeclarations/{Messages.d.ts → Scripts/Messages.d.ts}

@@ -832,6 +832,19 @@ interface ModSdkModsReplyPayloadDictionaryEntry {
 	ModsJson: string;
 }
 
+/**
+ * A tagged dictionary entry for a list of strings
+ */
+interface StringListDictionaryEntry<T> {
+	Tag: T;
+	Strings: string[];
+}
+
+type ForbiddenWordsDictionaryEntry = StringListDictionaryEntry<"ForbiddenWords">
+type BlockScreenDictionaryEntry = StringListDictionaryEntry<"BlockScreen">
+type BlockAppearanceDictionaryEntry = StringListDictionaryEntry<"BlockAppearance">
+type BlockItemGroupDictionaryEntry = StringListDictionaryEntry<"BlockItemGroup">
+
 /**
  * A dictionary entry with metadata about the chat message transmitted.
  *
@@ -866,7 +879,12 @@ type ChatMessageDictionaryEntry =
 	| MapViewChangeKeyEventDictionaryEntry
 	| GGTSDictionaryEntry
 	| ModSdkModsQueryPayloadDictionaryEntry
-	| ModSdkModsReplyPayloadDictionaryEntry;
+	| ModSdkModsReplyPayloadDictionaryEntry
+	| ForbiddenWordsDictionaryEntry
+	| BlockScreenDictionaryEntry
+	| BlockAppearanceDictionaryEntry
+	| BlockItemGroupDictionaryEntry
+;
 
 
 type ChatMessageDictionary = ChatMessageDictionaryEntry[];

package/bc/NativeDeclarations/{Toasts.d.ts → Scripts/Toasts.d.ts}

@@ -23,7 +23,7 @@ declare namespace Toasts {
 	/** Configuration options for displaying a toast notification. */
 	interface Options {
 		/** Text content of the toast. */
-		message: string;
+		message: string | Element | readonly (string | Element)[];
 		/** Title of the toast. */
 		title?: string;
 		/** Type and style of the toast. */

package/bc/NativeDeclarations/{Typedef.d.ts → Scripts/Typedef.d.ts}

@@ -69,6 +69,11 @@ interface GamepadButton {
 	repeat: boolean;
 }
 
+// Workaround for https://github.com/microsoft/TypeScript/issues/283
+interface Node {
+	cloneNode(deep?: boolean): this;
+}
+
 interface RGBColor {
 	r: number;
 	g: number;
@@ -507,6 +512,10 @@ type PickLockAvailability = "" | "Disabled" | "PermissionsDisabled" | "Inaccessi
 
 type ItemVulvaFuturisticVibratorAccessMode = "" | "ProhibitSelf" | "LockMember";
 
+type ItemVulvaChastityCageExcitementLevel = "Excited" | "Aroused" | "Horny";
+
+type ItemVulvaChastityCageArousalPunishmentType = "Warning" | "Shrink" | "";
+
 type SpeechTransformName = "gagGarble" | "stutter" | "babyTalk" | "deafen";
 
 /** The {@link EffectName} values for all gag-related effects. */
@@ -666,7 +675,7 @@ type AssetAttribute =
 	| "FuturisticRecolor" | "FuturisticRecolorDisplay" | "FuturisticLock"
 	| "PortalLinkLockable" | `PortalLinkChastity${string}` | `PortalLinkActivity${ActivityName}` | `PortalLinkTarget${AssetGroupItemName}`
 	| "Diaper" | `Diaper${AssetGenericSize}` | "IsNurseryOutfit" | "Pacifier"
-	| "PetSuit"
+	| "PetSuit" | "ArcadeGaming"
 	;
 
 type PosePrerequisite = `Can${AssetPoseName}`;
@@ -1443,7 +1452,7 @@ interface ClipboardItemBundle {
 	/** The item's asset name */
 	A: string;
 	/** The item's color */
-	C?: ItemColor;
+	C: BCColor[];
 }
 
 type ClipboardAppearanceBundle = ClipboardItemBundle[];
@@ -1462,7 +1471,7 @@ type ActivityNameBasic = "Bite" | "Brush" | "Caress" | "Choke" | "Clean" | "Cudd
 	"GagKiss" | "GaggedKiss" | "Grope" | "HandGag" | "Kick" |
 	"Kiss" | "Lick" | "MassageFeet" | "MassageHands" | "MasturbateFist" |
 	"MasturbateFoot" |"MasturbateHand" | "MasturbateTongue" |
-	"MoanGag" | "MoanGagAngry" | "MoanGagGiggle" | "MoanGagGroan" | "MoanGagTalk" |
+	"ChewItem" | "MoanGag" | "MoanGagAngry" | "MoanGagGiggle" | "MoanGagGroan" | "MoanGagTalk" |
 	"MoanGagWhimper" | "Nibble" | "Nod" | "PenetrateFast" |
 	"PenetrateSlow" | "Pet" | "Pinch" | "PoliteKiss" | "Pull" |
 	"RestHead" | "Rub" | "Scratch" | "Sit" | "Slap" | "Spank" | "Step" | "StruggleArms" | "StruggleLegs" |
@@ -1470,7 +1479,7 @@ type ActivityNameBasic = "Bite" | "Brush" | "Caress" | "Choke" | "Clean" | "Cudd
 	"SistersHug" | "BrothersHandshake" | "SiblingsCheekKiss" | "CollarGrab"
 ;
 
-type ActivityNameItem = "Inject" | "MasturbateItem" | "PenetrateItem" | "PourItem" | "RollItem" | "RubItem" | "BrushItem" | "ShockItem" | "SipItem" | "SpankItem" | "SqueezeItem" | "TickleItem" | "EatItem" | "Scratch" | "ThrowItem";
+type ActivityNameItem = "Inject" | "MasturbateItem" | "PenetrateItem" | "ChewItem" | "PourItem" | "RollItem" | "RubItem" | "BrushItem" | "ShockItem" | "SipItem" | "SpankItem" | "SqueezeItem" | "TickleItem" | "EatItem" | "Scratch" | "ThrowItem";
 
 type ActivityName = ActivityNameBasic | ActivityNameItem;
 
@@ -1514,13 +1523,17 @@ interface ItemActivity {
 
 type ItemColor = BCColor | BCColor[];
 
-/** An item is a pair of asset and its dynamic properties that define a worn asset. */
+/**
+ * An item is a pair of asset and its dynamic properties that define a worn asset.
+ *
+ * See the {@link InventoryItem} namespace for item construction helpers.
+ */
 interface Item {
 	Asset: Asset;
-	Color?: ItemColor;
-	Difficulty?: number;
+	Color: BCColor[];
+	Difficulty: number;
 	Craft?: CraftingItem;
-	Property?: ItemProperties;
+	Property: ItemProperties;
 }
 
 /** An item properties subtype with a guaranteed opacity field. */
@@ -1556,9 +1569,8 @@ interface InventoryBundle {
 	Group: AssetGroupName;
 	Name: string
 }
-interface InventoryItem extends InventoryBundle {
-	Asset: Asset;
-}
+
+type InventoryItem = InventoryBundle & Item;
 
 declare namespace InventoryPrerequisiteConflicts {
 	type ErrMessage = "" | "CannotBeUsedOverGag" | "MustBeUsedOverGag";
@@ -1845,7 +1857,7 @@ interface Character {
 	InventoryData?: string;
 	Appearance: Item[];
 	/**
-	 * private
+	 * @private
 	 * @see {@link Character.Stage}
 	 */
 	_Stage: string;
@@ -1853,7 +1865,7 @@ interface Character {
 	get Stage(): string;
 	set Stage(value: string);
 	/**
-	 * private
+	 * @private
 	 * @see {@link Character.CurrentDialog}
 	 */
 	_CurrentDialog: string;
@@ -2019,7 +2031,7 @@ interface Character {
 	HasHiddenItems: boolean;
 	SavedColors: HSVColor[];
 	/**
-	 * private
+	 * @private
 	 * The cached blind level; use {@link Character.GetBlindLevel} instead.
 	 */
 	_BlindLevel?: number;
@@ -2358,6 +2370,7 @@ interface PlayerCharacter extends Character {
 	 * Do not manipulate directly. Use {@link ChatRoomListUpdate}
 	 */
 	GhostList: number[];
+	Log: LogRecord[];
 	Wardrobe: (ItemBundle[] | null)[];
 	WardrobeCharacterNames: string[];
 	SavedExpressions: ({ Group: ExpressionGroupName, CurrentExpression?: ExpressionName }[] | null)[];
@@ -3243,6 +3256,12 @@ interface AssetDefinitionProperties {
 	 */
 	Opacity?: number | number[];
 
+	/**
+	 * A custom background for this option that overrides the default
+	 * @see {@link Asset.CustomBlindBackground}
+	 */
+	CustomBlindBackground?: string;
+
 	/**
 	 * A list of fetishes affected by the item
 	 * @see {@link Asset.Fetish}
@@ -3269,6 +3288,12 @@ interface ExpressionQueueItem {
 	Expression: ExpressionName;
 }
 
+type VoiceTriggerType =
+	| "Increase" | "Decrease" | "Disable"
+	| "Inflate" | "Deflate" | "Empty"
+	| "Shock"
+;
+
 /**
  * Base properties for extended items
  *
@@ -3490,6 +3515,21 @@ interface ItemPropertiesCustom {
 
 	/** Override the left-position of a layer. A value of {@link AssetOverride} will be override the _relative_ position of each and every layer individually. */
 	DrawingLeft?: TopLeft.ItemData;
+
+	// #region Techno Chastity Cage settings */
+
+	/** Time when autoshrink will happen */
+	NextShrinkTime?: number;
+	/** Time when last shrink warning happened */
+	LastShrinkWarningTime?: number;
+	/** Time before next warning or shrinkage will happen again */
+	ShrinkCooldown?: number;
+	/** A boolean to whether show messages related to shrink or warning */
+	ShowShrinkText?: boolean;
+	/** A threshold passing which going to trigger auto shrink/warning */
+	ArousalLvl?: ItemVulvaChastityCageExcitementLevel;
+
+	// #endregion
 }
 
 interface ItemProperties extends ItemPropertiesBase, AssetDefinitionProperties, ItemPropertiesCustom { }
@@ -4698,18 +4738,17 @@ interface ColorPickerInitOptions {
 interface LogRecord {
 	Name: LogNameType[LogGroupType];
 	Group: LogGroupType;
-	Value: number | undefined;
+	Value: number | string[] | undefined;
 }
 
 /** The logging groups as supported by the {@link LogRecord.Group} */
 type LogGroupType = keyof LogNameType;
 
-type LogNameAdvanced = (
-	`BlockScreen${string}`
-	| `BlockAppearance${string}`
-	| `BlockItemGroup${string}`
-	| `ForbiddenWords${string}`
-);
+type LogNameAdvanced =
+	| `BlockScreen`
+	| `BlockAppearance`
+	| `BlockItemGroup`
+;
 
 /** An interface mapping {@link LogRecord.Group} types to valid {@link LogRecord.Name} types */
 interface LogNameType {
@@ -4720,6 +4759,7 @@ interface LogNameType {
 	College: "TeacherKey",
 	Import: "BondageCollege",
 	Introduction: "MaidOpinion" | "DailyJobDone",
+	JoinedStable: "Pony" | "PonyExam" | "Trainer" | "TrainerExam",
 	LockPick: "FailedLockPick",
 	LoverRule: "BlockLoverLockSelf" | "BlockLoverLockOwner",
 	MagicSchool: "Mastery",
@@ -4735,7 +4775,6 @@ interface LogNameType {
 	"NPC-Julia": "Dominant" | "Submissive",
 	"NPC-Yuki": "Dominant" | "Submissive",
 	"NPC-Mildred": "Dominant" | "Submissive",
-	// NOTE: A number of owner rules can have arbitrary suffices, and can thus not be fully expressed as string literals
 	OwnerRule: (
 		"BlockChange"
 		| "BlockTalk"
@@ -4751,15 +4790,9 @@ interface LogNameType {
 		| "BlockRemoteSelf"
 		| "BlockNickname"
 		| "ReleasedCollar"
-		| "BlockScreen"
-		| "BlockAppearance"
-		| "BlockItemGroup"
-		| "ForbiddenWords"
-		| "BlockTalkForbiddenWords"
 		| LogNameAdvanced
+		| "ForbiddenWords"
 	),
-	Pony: "JoinedStable",
-	PonyExam: "JoinedStable",
 	PrivateRoom: (
 		"RentRoom"
 		| "Expansion"
@@ -4778,8 +4811,6 @@ interface LogNameType {
 	Shibari: "Training",
 	SkillModifier: "ModifierDuration" | "ModifierLevel",
 	SlaveMarket: "Auctioned",
-	Trainer: "JoinedStable",
-	TrainerExam: "JoinedStable",
 	Disclaimer: "Accepted",
 }
 
@@ -4967,7 +4998,7 @@ type ClubCardDefaultDecks =
 
 interface ClubCardPlayer {
 	Character: Character;
-	Control: string;
+	Control: "AI" | "Player" | "Online";
 	Index: number;
 	Sleeve: number;
 	Deck: ClubCard[];
@@ -4986,18 +5017,46 @@ interface ClubCardPlayer {
 	CardsPlayedThisTurn: Record<number, ClubCard[]>
 }
 
+type ClubCardMessageType =
+  | "Prerequisite"
+  | "StartTurnInfo"
+  | "SystemMessage"
+  | "PlayersMessage"
+  | "PlayersDisconnected"
+  | "CardsEffect"
+  | "TurnEndEffect"
+  | "KnotEvent"
+  | "Actions"
+  | "ActionSeparator"
+  | "FameMoneyInfo"
+  | "StartTurnEvent"
+  | "VictoryInfo"
+;
+
+type ClubCardPlaceholderKeysType =
+	| "MONEYLABEL"
+	| "FAMELABEL"
+	| "AMOUNT"
+	| "CARDNAME"
+	| "MONEYAMOUNT"
+	| "FAMEAMOUNT"
+	| "TURNNUMBER"
+	| "PLAYERNAME"
+;
+
 interface ClubCardMessage {
-	TextGetKey: string;         // Localization key
-	MessageText?: string;		// Message Text
-		MessageType: string;        // Type of message (e.g., ACTION, SYSTEM, IMMEDIATE)
-		PlayerId: string;           // ID of the player who triggered the message
-		TurnCounter: number;        // Turn number when the message was created
-		Placeholders: {             // Dynamic data for text replacement
-				[key: string]: string | number;
+	/** Localization key */
+	TextGetKey: string;
+	/** Type of message (e.g., ACTION, SYSTEM, IMMEDIATE) */
+	MessageType: ClubCardMessageType;
+	/** ID of the player who triggered the message */
+	PlayerId: string;
+	/** Turn number when the message was created */
+	TurnCounter: number;
+	/** Dynamic data for text replacement */
+	Placeholders: {
+		[key in ClubCardPlaceholderKeysType]?: string;
 	};
-	PlayerName?: string;
-		SourcePlayer?: string;
-		OpponentPlayer?: string;
 }
 
 /**
@@ -5218,3 +5277,13 @@ interface LayeringDisplay extends Rect {
 }
 
 // #endregion
+
+declare namespace Item {
+	interface Options {
+		/** The color of the item */
+		color?: Readonly<ItemColor>;
+		difficulty?: number;
+		craft?: Readonly<CraftingItem>;
+		property?: Readonly<ItemProperties>;
+	}
+}