bc-stubs 125.0.1 → 126.0.0

package/bc/NativeDeclarations/Element.d.ts

@@ -33,3 +33,19 @@ declare namespace ElementSwipe {
 		animation?: Animation;
 	}
 }
+
+declare namespace ElementUnpackIDs {
+	/** Further options for {@link ElementUnpackIDs}. */
+	interface Options<T extends HTMLElement = HTMLElement> {
+		/**
+		 * The root node.
+		 * Generally only relevant when working within a shadow root or some other {@link DocumentFragment} that is not {@link document}.
+		 */
+		root?: Element;
+		/**
+		 * An {@link Array.filter} callback for filtering out specific element types.
+		 * Defaults to just filtering out `null` entries.
+		 */
+		filter?: (value: null | HTMLElement, index: number, array: (null | HTMLElement)[]) => value is T;
+	}
+}

package/bc/NativeDeclarations/Female3DCG_Types.d.ts

@@ -346,7 +346,7 @@ interface AssetGroupDefinitionBase extends AssetCommonPropertiesGroupAsset, Asse
 	 *
 	 * Those are used when generating random appearances or cycling colors in the wardrobe
 	 */
-	Color?: HexColor[];
+	Color?: BCColor[];
 
 	/**
 	 * A group that will be used to copy the size info from
@@ -412,7 +412,7 @@ interface AssetGroupDefinitionBase extends AssetCommonPropertiesGroupAsset, Asse
 	 */
 	ArousalZone?: AssetGroupItemName;
 
-	ColorSuffix?: Record<string, string>;
+	ColorSuffix?: Partial<Record<"HEX_COLOR" | BCColor, BCColor>>;
 	ExpressionPrerequisite?: AssetPrerequisite[];
 	HasPreviewImages?: boolean;
 }
@@ -464,7 +464,7 @@ interface AssetCommonPropertiesAssetLayer {
 	/** A list of alpha mask definitions. */
 	Alpha?: Alpha.Definition[];
 
-	ColorSuffix?: Record<string, string>;
+	ColorSuffix?: Partial<Record<"HEX_COLOR" | BCColor, BCColor>>;
 
 	/** Whether the asset is drawn at an absolute position. */
 	FixedPosition?: boolean;
@@ -747,7 +747,7 @@ interface AssetDefinitionBase extends AssetCommonPropertiesGroupAsset, AssetComm
 	/** Applies screen tints when the asset is worn */
 	Tint?: TintDefinition[];
 	/** The default tint color (unless overriden by {@link TintDefinition.DefaultColor} */
-	DefaultTint?: string;
+	DefaultTint?: BCColor;
 	Gender?: AssetGender;
 
 	/**

package/bc/NativeDeclarations/Messages.d.ts

@@ -53,7 +53,7 @@ interface ServerAccountData extends ServerAccountImmutableData {
 	ArousalSettings?: ArousalSettingsType;
 	OnlineSharedSettings?: CharacterOnlineSharedSettings;
 	Game?: CharacterGameParameters;
-	LabelColor?: string;
+	LabelColor?: "" | HexColor;
 	Appearance?: ServerAppearanceBundle;
 	Description?: string;
 	BlockItems?: ServerItemPermissionsPacked | ServerItemPermissions[];
@@ -436,7 +436,7 @@ interface ServerChatRoomSearchRequest {
 	Language: "" | ServerChatRoomLanguage | ServerChatRoomLanguage[];
     SearchDescs?: boolean;
 	ShowLocked?: boolean;
-    MapTypes?: string[];
+    MapTypes?: ChatRoomMapType[];
 }
 type ChatRoomSearchSettings = {
 	Language: "" | ServerChatRoomLanguage;
@@ -445,7 +445,7 @@ type ChatRoomSearchSettings = {
 	FullRooms: boolean;
 	ShowLocked: boolean;
 	SearchDescriptions: boolean;
-	MapTypes: string;
+	MapTypes: "" | ChatRoomMapType;
 	RoomMinSize: number;
 	RoomMaxSize: number;
 	FilterTerms: string;
@@ -1001,8 +1001,8 @@ interface ServerCharacterArousalResponse {
 interface ServerCharacterItemUpdate {
 	Target: number;
 	Group: AssetGroupName;
-	Name?: string;
-	Color: string | string[];
+	Name: string | undefined;
+	Color: ItemColor;
 	Difficulty: number;
 	Property?: ItemProperties;
 	Craft?: CraftingItem;

package/bc/NativeDeclarations/Typedef.d.ts

@@ -122,7 +122,7 @@ type HTMLOptions<T extends keyof HTMLElementTagNameMap> = {
 	/** Event listeners that will be attached to the HTML element (see {@link HTMLElement.addEventListener}). */
 	eventListeners?: { [k in keyof HTMLElementEventMap]?: (this: HTMLElementTagNameMap[T], event: HTMLElementEventMap[k]) => any };
 	/** The elements parent (if any) to which it will be attached (see {@link HTMLElement.parentElement}). */
-	parent?: ElementNoParent | Node;
+	parent?: null | ElementNoParent | Node;
 	/** A list of CSS classes to-be assigned to the element (see {@link HTMLElement.classList}). */
 	classList?: readonly (null | undefined | string)[];
 	/** Any to-be added child elements. */
@@ -1109,12 +1109,12 @@ interface AssetGroup {
 	readonly AllowColorize: boolean;
 	readonly AllowCustomize: boolean;
 	readonly Random?: boolean;
-	readonly ColorSchema: readonly string[];
+	readonly ColorSchema: readonly BCColor[];
 	/**
 	 * The first color in the groups {@link ColorSchema}.
 	 * The value is used for padding the {@link Asset.DefaultColor} array if required.
 	 */
-	readonly DefaultColor: string;
+	readonly DefaultColor: BCColor;
 	readonly ParentSize: AssetGroupName | "";
 	readonly ParentColor: AssetGroupName | "";
 	readonly Clothing: boolean;
@@ -1153,7 +1153,7 @@ interface AssetGroup {
 
 	/** A dict mapping colors to custom filename suffices.
 	The "HEX_COLOR" key is special-cased to apply to all color hex codes. */
-	readonly ColorSuffix: Readonly<Record<string, string>>;
+	readonly ColorSuffix: Readonly<Partial<Record<"HEX_COLOR" | BCColor, BCColor>>>;
 	readonly ExpressionPrerequisite?: readonly AssetPrerequisite[];
 	readonly HasPreviewImages: boolean;
 	/** Return whether this group belongs to the `Appearance` {@link AssetGroup.Category} */
@@ -1258,13 +1258,13 @@ interface AssetLayer {
 	readonly ShowForAttribute: readonly AssetAttribute[] | null;
 	/** Used along with a hook to make layers of an asset disappear in some cases. */
 	readonly Visibility: "Player" | "AllExceptPlayerDialog" | "Others" | "OthersExceptDialog" | "Owner" | "Lovers" | "Mistresses" | null;
-	readonly ColorSuffix: Readonly<Record<string, string>> | null;
+	readonly ColorSuffix: Readonly<Partial<Record<"HEX_COLOR" | BCColor, BCColor>>> | null;
 }
 
 interface TintDefinition {
-	Color: number | string;
+	Color: number | BCColor;
 	Strength: number;
-	DefaultColor?: string;
+	DefaultColor?: BCColor;
 }
 
 interface ResolvedTintDefinition extends TintDefinition {
@@ -1375,7 +1375,7 @@ interface Asset {
 	/**
 	 * The default color of the item: an array of length {@link Asset.ColorableLayerCount} consisting of {@link AssetGroup.DefaultColor} and/or valid color hex codes.
 	 */
-	readonly DefaultColor: readonly string[];
+	readonly DefaultColor: readonly BCColor[];
 	readonly Opacity: number;
 	readonly MinOpacity: number;
 	readonly MaxOpacity: number;
@@ -1404,7 +1404,7 @@ interface Asset {
 	/** A list of {@link TypeRecord} keys for which a single layer expects multiple type-specific .png files. */
 	readonly CreateLayerTypes: readonly string[];
 	/** A record that maps {@link ExtendedItemData.name} to a set with all option indices that support locks */
-	readonly AllowLockType: null | Record<string, Set<number>>;
+	readonly AllowLockType: null | Partial<Record<string, Set<number>>>;
 	/** @deprecated Removed without replacement: items _must_ support a "color all layers" button (to the extent that the item is colorable in the first place) */
 	readonly AllowColorizeAll?: never;
 	readonly AvailableLocations: readonly string[];
@@ -1421,10 +1421,10 @@ interface Asset {
 	readonly PreviewIcons: readonly InventoryIcon[];
 	readonly Tint: readonly Readonly<TintDefinition>[];
 	readonly AllowTint: boolean;
-	readonly DefaultTint?: string;
+	readonly DefaultTint?: BCColor;
 	readonly Gender?: AssetGender;
 	readonly CraftGroup: string;
-	readonly ColorSuffix: Readonly<Record<string, string>>;
+	readonly ColorSuffix: Readonly<Partial<Record<"HEX_COLOR" | BCColor, BCColor>>>;
 	readonly FullAlpha: boolean;
 	readonly ExpressionPrerequisite?: readonly AssetPrerequisite[];
 	readonly AllowColorize: boolean;
@@ -1520,7 +1520,7 @@ interface ItemActivity {
 	Blocked?: ItemActivityRestriction;
 }
 
-type ItemColor = string | string[];
+type ItemColor = BCColor | BCColor[];
 
 /** An item is a pair of asset and its dynamic properties that define a worn asset. */
 interface Item {
@@ -1538,7 +1538,7 @@ interface ItemColorProperties extends ItemProperties {
 
 /** An item subtype with a guaranteed color and opacity field. */
 interface ItemColorItem extends Item {
-	Color: string[];
+	Color: BCColor[];
 	Property: ItemColorProperties;
 }
 
@@ -2095,7 +2095,7 @@ interface Character {
 	AppearanceFull?: Item[]; // Private NPCs only
 	// Online character properties
 	Title?: TitleName;
-	LabelColor?: HexColor;
+	LabelColor?: "" | HexColor;
 	Creation?: number; // technically never as it is Online-only
 	Description?: string; // technically never as it is Online-only
 	OnlineSharedSettings?: CharacterOnlineSharedSettings;  // technically never as it is Online-only
@@ -2283,7 +2283,7 @@ interface PlayerCharacter extends Character {
 	// All the following are guaranteed to be set on login
 	MemberNumber: number;
 	Nickname: string;
-	LabelColor: HexColor;
+	LabelColor: "" | HexColor;
 	Game: CharacterGameParameters;
 	Description: string;
 	Creation: number;
@@ -4051,7 +4051,7 @@ type DrawOptions = {
 	/** Zoom factor */
 	Zoom?: number;
 	/* Color of the image to draw */
-	HexColor?: string;
+	HexColor?: HexColor;
 	/* Whether or not it is drawn in full alpha mode */
 	FullAlpha?: boolean;
 	/** A list of alpha masks to apply to the call */
@@ -4108,7 +4108,7 @@ type DrawImageCallback = (
  * @param {string} src - The URL of the image to draw
  * @param {number} x - The x coordinate to draw the image at
  * @param {number} y - The y coordinate to draw the image at
- * @param {string} color - The color to apply to the image
+ * @param {BCColor} color - The color to apply to the image
  * @param {boolean} fullAlpha - Whether or not to apply color to the entire image
  * @param {RectTuple[]} [alphaMasks] - A list of alpha masks to apply to the image when drawing
  * @param {number} [opacity=1] - The opacity at which to draw the image with
@@ -4163,7 +4163,7 @@ interface DynamicDrawingData<T extends Record<string, any> = Record<string, unkn
 	Y: number;
 	CA: Item;
 	GroupName: AssetGroupName;
-	Color: string;
+	Color: BCColor;
 	Opacity: number;
 	Property: ItemProperties;
 	A: Asset;
@@ -4186,7 +4186,7 @@ interface DynamicBeforeDrawOverrides {
 	Property?: ItemProperties;
 	CA?: Item;
 	GroupName?: AssetGroupName;
-	Color?: string;
+	Color?: BCColor;
 	Opacity?: number;
 	X?: number;
 	Y?: number;
@@ -4356,13 +4356,10 @@ interface CraftingItemSelected {
 	 * The first member of the {@link CraftingItemSelected.Assets} array.
 	 *
 	 * The asset is guaranteed to satisfy `Asset.Group.Name === Asset.DynamicGroupName` _if_ any of the list members satisfy this condition.
+	 *
+	 * Will be `undefined` upon creating a new craft prior to the user picking the underlying item.
 	 */
 	get Asset(): Asset | undefined;
-	/**
-	 * The crafted item propertty.
-	 * @deprecated superseded by {@link CraftingItemSelected .Effects}
-	 */
-	Property: CraftingPropertyType;
 	/** The crafted item properties mapped to their property strength. */
 	Effects: Partial<Record<CraftingPropertyType, number>>;
 	/** The lock as equipped on the item or, if absent, `null`. */
@@ -4381,8 +4378,8 @@ interface CraftingItemSelected {
 	 */
 	ItemProperty: ItemProperties;
 	/** Get or set the `OverridePriority` property of {@link CraftingItemSelected.ItemProperty} */
-	get OverridePriority(): null | AssetLayerOverridePriority;
-	set OverridePriority(value: null | AssetLayerOverridePriority);
+	get OverridePriority(): undefined | AssetLayerOverridePriority;
+	set OverridePriority(value: undefined | AssetLayerOverridePriority);
  }
 
 /**
@@ -4452,9 +4449,9 @@ interface ColorGroup {
 
 /** A fully mutable subset of {@link ItemColorStateType} */
 interface ItemColorExitState extends Pick<ItemColorStateType, "colors" | "initialColors" | "defaultColors" | "opacity" | "initialOpacity" | "defaultOpacity" | "editOpacity" > {
-	initialColors: string[];
+	initialColors: BCColor[];
 	initialOpacity: number[];
-	defaultColors: string[];
+	defaultColors: BCColor[];
 	defaultOpacity: number[];
 }
 
@@ -4474,14 +4471,14 @@ type ItemColorExitListener = (
 interface ItemColorStateType {
 	colorGroups: ColorGroup[];
 	/** The colors of the item */
-	colors: string[];
+	colors: BCColor[];
 	/** The initial colors of the item prior to editing */
-	initialColors: readonly string[];
+	initialColors: readonly BCColor[];
 	/**
 	 * The underlying assets default colors.
 	 * @see {@link Asset.DefaultColor}
 	 */
-	defaultColors: readonly string[];
+	defaultColors: readonly BCColor[];
 	/** The opacity of the item */
 	opacity: number[];
 	/** The initial opacity of the item prior to editing */
@@ -4508,7 +4505,21 @@ interface ItemColorStateType {
 }
 
 /** A hexadecimal color code */
-type HexColor = string;
+type HexColor = `#${string}`;
+
+/**
+ * A hexadecimal color code or one of BC's more specialized color literals (which an item may or may not support).
+ *
+ * * `Default`: Use the default color of the .png without modification
+ * * `White`/`Black`/`Asian`: Use skin color specific .png files (used by the body)
+ */
+type BCColor = (
+	"Default"
+	| "Black"
+	| "White"
+	| "Asian"
+	| HexColor
+)
 
 /** A HSV color value */
 interface HSVColor {
@@ -5150,7 +5161,7 @@ interface ChatRoomMapEffectStaticLighting {
 	/**
 	 * R [0; 255], G [0; 255], B [0; 255], A [0.0; 1.0]
 	 */
-	Color: [number, number, number, number];
+	Color: [r: number, g: number, b: number, a: number];
 }
 
 /**

package/bc/Screens/Character/Appearance/Appearance.d.ts

@@ -191,13 +191,13 @@ declare function AppearancePreviewUseCharacter(assetGroup: AssetGroup | null): b
  * @param {Character} C - The character whose appearance should be changed
  * @param {AssetGroupName} Group - The name of the corresponding groupr for the item
  * @param {Asset|null} ItemAsset - The asset collection of the item to be changed
- * @param {string|string[]} [NewColor] - The new color (as "#xxyyzz" hex value) for that item
- * @param {number} [DifficultyFactor=0] - The difficulty, on top of the base asset difficulty, that should be assigned
+ * @param {null | ItemColor} [NewColor] - The new color (as "#xxyyzz" hex value) for that item
+ * @param {null | number} [DifficultyFactor=0] - The difficulty, on top of the base asset difficulty, that should be assigned
  * to the item
- * @param {number} [ItemMemberNumber=-1] - The member number of the player adding the item - defaults to -1
+ * @param {null | number} [ItemMemberNumber=-1] - The member number of the player adding the item - defaults to -1
  * @returns {Item | null} - Thew newly created item or `undefined` if the asset does not exist
  */
-declare function CharacterAppearanceSetItem(C: Character, Group: AssetGroupName, ItemAsset: Asset | null, NewColor?: string | string[], DifficultyFactor?: number, ItemMemberNumber?: number): Item | null;
+declare function CharacterAppearanceSetItem(C: Character, Group: AssetGroupName, ItemAsset: Asset | null, NewColor?: null | ItemColor, DifficultyFactor?: null | number, ItemMemberNumber?: null | number): Item | null;
 /**
  * Cycle in the appearance assets to find the next item in a group
  * @param {Character} C - The character whose assets are used
@@ -223,11 +223,11 @@ declare function CharacterAppearanceMoveGroup(C: Character, Move: number): void;
 /**
  * Sets the color for a specific group
  * @param {Character} C - The character whose item group should be colored
- * @param {string} Color - The color (in the format "#rrggbb") to be applied to the group
+ * @param {BCColor} Color - The color (in the format "#rrggbb") to be applied to the group
  * @param {AssetGroupName} Group - The name of the group, whose color should be changed
  * @returns {void} - Nothing
  */
-declare function CharacterAppearanceSetColorForGroup(C: Character, Color: string, Group: AssetGroupName): void;
+declare function CharacterAppearanceSetColorForGroup(C: Character, Color: BCColor, Group: AssetGroupName): void;
 /**
  * Advance to the next reordering mode, or set the mode to the specified
  * value.  The reordering mode cycles through the values:

package/bc/Screens/Character/ItemColor/ItemColor.d.ts

@@ -1,9 +1,9 @@
 /**
  * Sanitize the color of the passed item, returning an array of valid color strings and of length {@link Asset.ColorableLayerCount}.
  * @param {Item} item - The item whose colors are to be validated
- * @returns {string[]} - The validated colors returned as array
+ * @returns {BCColor[]} - The validated colors returned as array
  */
-declare function ItemColorSanitizeColor(item: Item): string[];
+declare function ItemColorSanitizeColor(item: Item): BCColor[];
 /**
  * Sanitize the properties of the passed item in relation to any and all color & opacity related fields.
  * @param {Item} item - The item whose properties are to be validated
@@ -168,17 +168,17 @@ declare function ItemColorIsSimple(item: Item): boolean;
 /**
  * Fetches the color button text key for the provided item color. If the item's color is already a string, the color string is returned.
  * Otherwise, returns "Many" or "Default" as appropriate.
- * @param {string | readonly string[]} color - The item color
- * @returns {string} - The appropriate color button key for the provided item color(s)
+ * @param {"None" | BCColor | readonly BCColor[]} color - The item color
+ * @returns {"Many" | BCColor} - The appropriate color button key for the provided item color(s)
  */
-declare function ItemColorGetColorButtonTextKey(color: string | readonly string[]): string;
+declare function ItemColorGetColorButtonTextKey(color: "None" | BCColor | readonly BCColor[]): "Many" | BCColor;
 /**
  * Fetches the color button text for the provided item color. If the item's color is already a string, the color string is returned.
  * Otherwise, returns "Many" or "Default" as appropriate.
- * @param {string | readonly string[]} color - The item color
+ * @param {BCColor | readonly BCColor[]} color - The item color
  * @returns {string} - The appropriate color button text for the provided item color(s), translated to the current game language
  */
-declare function ItemColorGetColorButtonText(color: string | readonly string[]): string;
+declare function ItemColorGetColorButtonText(color: BCColor | readonly BCColor[]): string;
 /**
  * Registers an exit callback to the item color UI which will be called when the UI is exited.
  * @param {ItemColorExitListener} callback - The exit listener to register
@@ -253,13 +253,13 @@ declare let ItemColorLayerNames: null | TextCache;
 declare let ItemColorGroupNames: null | TextCache;
 /**
  * All (hex code) colors used within the current lifetime of the ItemColor subscreen.
- * @type {Set<HexColor>}
+ * @type {Set<BCColor>}
  */
-declare const ItemColorHistory: Set<HexColor>;
+declare const ItemColorHistory: Set<BCColor>;
 /**
  * A debounced callback for when the item color picker changes its value. This sets the color for the currently selected set of color
  * indices
  * @deprecated - Superseded by {@link ColorPicker.eventListeners.inputItemColor}
- * @type {(color: string) => void}
+ * @type {(color: BCColor) => void}
  */
-declare const ItemColorOnPickerChange: (color: string) => void;
+declare const ItemColorOnPickerChange: (color: BCColor) => void;

package/bc/Screens/Online/ChatRoom/ChatRoomMapView.d.ts

@@ -162,16 +162,16 @@ declare function ChatRoomMapViewGetConnectivityDirections(X: number, Y: number,
  * Returns the object located at a X and Y position on the map, or NULL if nothing
  * @param {number} X - The X position on the map
  * @param {number} Y - The Y position on the map
- * @returns {ChatRoomMapTile | null} - The object at the position
+ * @returns {ChatRoomMapTile | undefined} - The object at the position
  */
-declare function ChatRoomMapViewGetTileAtPos(X: number, Y: number): ChatRoomMapTile | null;
+declare function ChatRoomMapViewGetTileAtPos(X: number, Y: number): ChatRoomMapTile | undefined;
 /**
  * Returns the object located at a X and Y position on the map, or NULL if nothing
  * @param {number} X - The X position on the map
  * @param {number} Y - The Y position on the map
- * @returns {ChatRoomMapObject | null} - The object at the position
+ * @returns {ChatRoomMapObject | undefined} - The object at the position
  */
-declare function ChatRoomMapViewGetObjectAtPos(X: number, Y: number): ChatRoomMapObject | null;
+declare function ChatRoomMapViewGetObjectAtPos(X: number, Y: number): ChatRoomMapObject | undefined;
 /**
  * Returns TRUE if a given position cannot be entered
  * @param {number} X - The X position on the map
@@ -411,8 +411,10 @@ declare const ChatRoomMapViewRemoteRange: number;
 declare var ChatRoomMapViewVisibilityMask: boolean[];
 /** @type {boolean[]} */
 declare var ChatRoomMapViewAudibilityMask: boolean[];
-declare var ChatRoomMapViewTileFog: string;
-declare var ChatRoomMapViewObjectFog: string;
+/** @type {Uint16Array | null} */
+declare var ChatRoomMapViewTileFog: Uint16Array | null;
+/** @type {Uint16Array | null} */
+declare var ChatRoomMapViewObjectFog: Uint16Array | null;
 declare namespace ChatRoomMapViewKeysPressed {
     let u: boolean;
     let d: boolean;
@@ -420,6 +422,12 @@ declare namespace ChatRoomMapViewKeysPressed {
     let r: boolean;
 }
 declare var ChatRoomMapViewStartOfKeyPress: number;
+/** @type {Record<number, ChatRoomMapTile | undefined>} */
+declare var ChatRoomMapViewTileLookup: Record<number, ChatRoomMapTile | undefined>;
+/** @type {Record<number, ChatRoomMapObject | undefined>} */
+declare var ChatRoomMapViewObjectLookup: Record<number, ChatRoomMapObject | undefined>;
+/** @type {Map<number, Character>} */
+declare var ChatRoomMapViewCharacterMap: Map<number, Character>;
 declare const ChatRoomMapViewEffectStartID: 10;
 /**
  * A list of predefined lighting effects. May be replaced with a color picker in the future.
@@ -431,7 +439,7 @@ declare const ChatRoomMapViewTileList: ChatRoomMapTile[];
 /** @type {ChatRoomMapObject[]} */
 declare const ChatRoomMapViewObjectList: ChatRoomMapObject[];
 declare namespace ChatRoomMapManager {
-    export let Map: {
+    let Map: {
         /**
          * @type {MapData}
          * private
@@ -632,20 +640,18 @@ declare namespace ChatRoomMapManager {
          */
         _decodeEffects(str: string | undefined): ChatRoomMapEffect[][] | undefined;
     };
-    export { OnMapDataUpdated };
-    export { OnViewActivate };
+    /**
+     * This function should be called each time the external code updates {@link ChatRoomData.MapData}.
+     *
+     * This function decodes the updated map data and replaces
+     * the data stored in ${@link ChatRoomMapManager.Map} with the decoded map.
+     * @returns {void}
+     */
+    function OnMapDataUpdated(): void;
+    /**
+     * Initializes the map with the current global data if needed.
+     * Must be called in {@link ChatRoomMapViewActivate}.
+     * @returns {void}
+     */
+    function OnViewActivate(): void;
 }
-/**
- * This function should be called each time the external code updates {@link ChatRoomData.MapData}.
- *
- * This function decodes the updated map data and replaces
- * the data stored in ${@link ChatRoomMapManager.Map} with the decoded map.
- * @returns {void}
- */
-declare function OnMapDataUpdated(): void;
-/**
- * Initializes the map with the current global data if needed.
- * Must be called in {@link ChatRoomMapViewActivate}.
- * @returns {void}
- */
-declare function OnViewActivate(): void;

package/bc/Screens/Room/AsylumGGTS/AsylumGGTS.d.ts

@@ -89,9 +89,10 @@ declare function AsylumGGTSBuildPrivate(): void;
 /**
  * Gets the new character name based on it's GGTS level
  * @param {Character} C - The character to rename
+ * @param {string} Name - The normal (sanitized) display name of the character
  * @returns {string} - The new name for that character
  */
-declare function AsylumGGTSCharacterName(C: Character): string;
+declare function AsylumGGTSCharacterName(C: Character, Name: string): string;
 /**
  * Sends a chat message from the GGTS.  GGTS slowly replaces the player name by the player number as level rises.
  * @param {string} Msg - The message to publish
@@ -104,6 +105,14 @@ declare function AsylumGGTSMessage(Msg: string, Target?: Character): void;
  * @returns {void} - Nothing
  */
 declare function AsylumGGTSSetTimer(): void;
+/**
+ * Replaces the punctuation and capitalization in given text depending on the GGTS level.
+ * Makes it easier to respond to GGTS queries on lower levels.
+ * @param {number} Level - GGTS level
+ * @param {string} Text - the text to sanitize
+ * @return {string} - sanitized text
+ */
+declare function AsylumGGTSSanitizeText(Level: number, Text: string): string;
 /**
  * Returns TRUE if the query was answered by character number M
  * @param {number} Level - The player GGTS level, at level 4 or more, capital letters and punctuation matters

package/bc/Screens/Room/CollegeTheater/CollegeTheater.d.ts

@@ -93,4 +93,5 @@ declare var CollegeTheaterBackground: string;
 /** @type {null | NPCCharacter} */
 declare var CollegeTheaterJulia: null | NPCCharacter;
 declare var CollegeTheaterJuliaLove: number;
-declare var CollegeTheaterRandomColors: string[];
+/** @type {BCColor[]} */
+declare var CollegeTheaterRandomColors: BCColor[];

package/bc/Screens/Room/Crafting/Crafting.d.ts

@@ -94,9 +94,9 @@ declare function CraftingDecompressServerData(Data: string | undefined | (null |
 declare function CraftingLoadServer(Packet: string | (null | CraftingItem)[]): void;
 /**
  * Advance to the next crafting reordering mode, or set the mode to the specified value.
- * @param {CraftingReorderType} newmode - The mode to set.  If null, advance to next mode.
+ * @param {null | CraftingReorderType} newmode - The mode to set.  If null, advance to next mode.
  */
-declare function CraftingReorderModeSet(newmode?: CraftingReorderType): void;
+declare function CraftingReorderModeSet(newmode?: null | CraftingReorderType): void;
 declare function CraftingClick(event: MouseEvent | TouchEvent): void;
 /**
  * Refreshes the preview model with a slight delay so the item color process is done
@@ -105,9 +105,10 @@ declare function CraftingClick(event: MouseEvent | TouchEvent): void;
 declare function CraftingRefreshPreview(): void;
 /**
  * Converts the currently selected item into a crafting item.
+ * @param {CraftingItemSelected} item
  * @return {CraftingItem}
  * */
-declare function CraftingConvertSelectedToItem(): CraftingItem;
+declare function CraftingConvertSelectedToItem(item: CraftingItemSelected): CraftingItem;
 /**
  * Convert a crafting item to its selected format.
  * @param {CraftingItem} Craft
@@ -333,7 +334,8 @@ declare namespace CraftingEventListeners {
     function _ClickPadlock(this: HTMLButtonElement, ev: Event): void;
     function _ClickAsset(this: HTMLButtonElement, ev: Event): void;
     function _ClickRadio(this: HTMLButtonElement, ev: Event): void;
-    let _InputSearch: (this: HTMLInputElement, ev: Event) => Promise<void>;
+    function _InputSearch(this: HTMLInputElement): Promise<void>;
+    let _InputSearchEffect: (this: HTMLInputElement, ev: Event) => Promise<void>;
     function _ClickAsciiDescription(this: HTMLInputElement, ev: Event): void;
     function _ClickGroup(this: HTMLButtonElement, ev: MouseEvent): void;
     let _FocusSearchAsset: (this: HTMLInputElement, ev: FocusEvent) => Promise<void>;
@@ -345,9 +347,10 @@ declare namespace CraftingElements {
      * @param {string} id
      * @param {string} controls
      * @param {string} placeholder
+     * @param {"asset" | "lock" | "effect"} type
      * @returns {HTMLInputElement}
      */
-    function _SearchInput(id: string, controls: string, placeholder: string, assetSearch?: boolean): HTMLInputElement;
+    function _SearchInput(id: string, controls: string, placeholder: string, type: "asset" | "lock" | "effect"): HTMLInputElement;
     let _SearchCache: Map<"ALL" | AssetGroupItemName, readonly HTMLOptionElement[]>;
     /**
      * private
@@ -374,4 +377,4 @@ declare namespace CraftingElements {
  * @see {@link CratingValidationStruct}
  * @todo Let the Validate/GetDefault functions take the respective attribute rather than the entire {@link CraftingItem}
  */
-declare const CraftingValidationRecord: Record<keyof CraftingItem, CratingValidationStruct>;
+declare var CraftingValidationRecord: Record<keyof CraftingItem, CratingValidationStruct>;

package/bc/Screens/Room/Crafting/CraftingJSON.d.ts

@@ -13,13 +13,19 @@ declare namespace CraftingJSON {
     /**
      * private
      * @param {Element} fieldset
-     * @param {Element} radioContainer
+     * @param {null | Element} radioContainer
      * @param {Map<{ inputNew: HTMLInputElement, inputOld: HTMLInputElement }, boolean>} checkLog
      */
-    function _queueAdvance(fieldset: Element, radioContainer: Element, checkLog: Map<{
+    function _queueAdvance(fieldset: Element, radioContainer: null | Element, checkLog: Map<{
         inputNew: HTMLInputElement;
         inputOld: HTMLInputElement;
     }, boolean>): void;
+    /**
+     * private
+     * @param {null | HTMLElement} el
+     * @returns {el is HTMLElement}
+     */
+    function _isTooltip(el: null | HTMLElement): el is HTMLElement;
     namespace eventListeners {
         function focusTooltip(this: HTMLElement): void;
         function blurTooltip(this: HTMLElement): void;

package/bc/Screens/Room/MainHall/MainHall.d.ts

@@ -256,7 +256,8 @@ declare var MainHallPunishmentList: ({
     ItemHands: string;
 })[];
 declare var MainHallPunishmentChoice: number;
-declare var MainHallRopeColor: string;
+/** @type {BCColor} */
+declare var MainHallRopeColor: BCColor;
 declare namespace MainHallAllowIDToScreenMap {
     let Shop: string;
     let Private: string;

package/bc/Screens/Room/Management/Management.d.ts

@@ -456,10 +456,10 @@ declare function ManagementClubSlaveRandomActivityEnd(RepChange: number): void;
 declare function ManagementClubSlaveTransferToRoom(): void;
 /**
  * Triggered when the player earns the mistress clothes.
- * @param {string} Color - The color of the outfit
+ * @param {BCColor} Color - The color of the outfit
  * @returns {void} - Nothing.
  */
-declare function ManagementGetMistressOutfit(Color: string): void;
+declare function ManagementGetMistressOutfit(Color: BCColor): void;
 /**
  * Triggered when the player starts the Mistress introduction cutscene.
  * @returns {void} - Nothing.

package/bc/Screens/Room/Nursery/Nursery.d.ts

@@ -62,8 +62,8 @@ declare var NurseryCoolDownTime: number;
 /** @type {null | Item[]} */
 declare var NurseryPlayerAppearance: null | Item[];
 declare var RandomNumber: number;
-/** @type {null | string} */
-declare var RandomResult: null | string;
+/** @type {null | BCColor} */
+declare var RandomResult: null | BCColor;
 /** @type {null | string} */
 declare var RandomResultB: null | string;
 declare var PreviousDress: string;

package/bc/Screens/Room/Private/Private.d.ts

@@ -634,10 +634,10 @@ declare function PrivateStartGirlfriend(): void;
 /**
  * Puts a wedding ring of a specified color on a specified character
  * @param {Character} C - The character that must wear the ring.
- * @param {string} Color - The color of the ring #D0D000 is gold, #B0B0B0 is silver.
+ * @param {BCColor} Color - The color of the ring #D0D000 is gold, #B0B0B0 is silver.
  * @returns {void} - Nothing.
  */
-declare function PrivateWearRing(C: Character, Color: string): void;
+declare function PrivateWearRing(C: Character, Color: BCColor): void;
 /**
  * Triggered when the player upgrades her NPC girlfriend to Fiancee
  * @returns {void} - Nothing.

package/bc/Scripts/Asset.d.ts

@@ -223,11 +223,11 @@ declare function AssetLayerSort(layers: AssetLayer[]): AssetLayer[];
 /**
  * Convert {@link AssetDefinition} default color into a {@link Asset} default color list
  * @param {number} colorableLayerCount The number of colorable layers
- * @param {string} fillValue The default color. Usually `"Default"` though skin colors can also be supplied on occasion.
- * @param {string | readonly string[]} [color] See {@link AssetDefinition.DefaultColor}
- * @returns {string[]} See {@link Asset.DefaultColor}
+ * @param {BCColor} fillValue The default color. Usually `"Default"` though skin colors can also be supplied on occasion.
+ * @param {BCColor | readonly BCColor[]} [color] See {@link AssetDefinition.DefaultColor}
+ * @returns {BCColor[]} See {@link Asset.DefaultColor}
  */
-declare function AssetParseDefaultColor(colorableLayerCount: number, fillValue: string, color?: string | readonly string[]): string[];
+declare function AssetParseDefaultColor(colorableLayerCount: number, fillValue: BCColor, color?: BCColor | readonly BCColor[]): BCColor[];
 /**
  * Get the translated string for an asset-specific message
  * @param {string} msg

package/bc/Scripts/Character.d.ts

@@ -38,10 +38,10 @@ declare function CharacterLoadCSVDialog(C: Character, info?: DialogInfo<any>): v
  * Sets the clothes based on a character archetype
  * @param {Character} C - Character to set the clothes for
  * @param {"Maid" | "Mistress" | "Employee" | "AnimeGirl" | "Bunny" | "Succubus"} Archetype - Archetype to determine the clothes to put on
- * @param {string} [ForceColor] - Color to use for the added clothes
+ * @param {BCColor} [ForceColor] - Color to use for the added clothes
  * @returns {void} - Nothing
  */
-declare function CharacterArchetypeClothes(C: Character, Archetype: "Maid" | "Mistress" | "Employee" | "AnimeGirl" | "Bunny" | "Succubus", ForceColor?: string): void;
+declare function CharacterArchetypeClothes(C: Character, Archetype: "Maid" | "Mistress" | "Employee" | "AnimeGirl" | "Bunny" | "Succubus", ForceColor?: BCColor): void;
 /**
  * Loads an NPC into the character array. The appearance is randomized, and a type can be provided to dress them in a given style.
  * @template {ModuleType} T

package/bc/Scripts/Common.d.ts

@@ -150,11 +150,11 @@ declare function CommonTime(): number;
  * Checks if a given value is a valid HEX color code (optionally with alpha channel)
  * @param {string | undefined} Value - Potential HEX color code
  * @param {null | { allowAlpha?: boolean }} [options]
- * @returns {boolean} - Returns TRUE if the string is a valid HEX color
+ * @returns {Value is HexColor} - Returns TRUE if the string is a valid HEX color
  */
 declare function CommonIsColor(Value: string | undefined, options?: null | {
     allowAlpha?: boolean;
-}): boolean;
+}): Value is HexColor;
 /**
  * Checks whether an item's color has a valid value that can be interpreted by the drawing
  * functions. Valid values are null, undefined, strings, and an array containing any of the
@@ -163,6 +163,12 @@ declare function CommonIsColor(Value: string | undefined, options?: null | {
  * @returns {boolean} - Returns TRUE if the color is a valid item color
  */
 declare function CommonColorIsValid(Color?: null | string | readonly (null | string)[]): boolean;
+/**
+ * Remove the (potential present) alpha component of the passed color hex code, turning the likes of `RRGGBB(AA)` into `RRGGBB`.
+ * @param {HexColor} color The color hex code
+ * @returns {HexColor} The color hex code with its (potentially present) alpha component removed
+ */
+declare function CommonColorTrimAlpha(color: HexColor): HexColor;
 /**
  * Check that the passed string looks like an acceptable email address.
  *

package/bc/Scripts/CommonDraw.d.ts

@@ -74,16 +74,16 @@ declare function CommonDrawApplyLayerAlphaMasks(C: Character, layer: AssetLayer,
  * @param {Item} item
  * @param {AssetLayer} layer
  * @param {AssetGroupName} groupName
- * @param {HexColor} [initialColor] Used as the starting value to check that specific color and fully resolve it
+ * @param {BCColor} [initialColor] Used as the starting value to check that specific color and fully resolve it
  */
-declare function CommonDrawResolveLayerColor(C: Character, item: Item, layer: AssetLayer, groupName: AssetGroupName, initialColor?: HexColor): string;
+declare function CommonDrawResolveLayerColor(C: Character, item: Item, layer: AssetLayer, groupName: AssetGroupName, initialColor?: BCColor): BCColor;
 /**
  * Determines whether the provided color is valid
  * @param {string} Color - The color
  * @param {AssetGroup} AssetGroup - The asset group the color is being used fo
- * @returns {boolean} - Whether the color is valid
+ * @returns {Color is BCColor} - Whether the color is valid
  */
-declare function CommonDrawColorValid(Color: string, AssetGroup: AssetGroup): boolean;
+declare function CommonDrawColorValid(Color: string, AssetGroup: AssetGroup): Color is BCColor;
 /**
  * Finds the correct pose to draw for drawable layer for the provided character from the provided list of allowed poses
  * @param {Character} C - The character to check for poses against

package/bc/Scripts/Dialog.d.ts

@@ -649,10 +649,10 @@ declare function DialogSetTightenLoosenItem(Item: Item): void;
 /**
  * Validates that the player is allowed to change the item color and swaps it on the fly
  * @param {Character} C - The player who wants to change the color
- * @param {string} Color - The new color in the format "#rrggbb"
+ * @param {BCColor} Color - The new color in the format "#rrggbb"
  * @returns {void} - Nothing
  */
-declare function DialogChangeItemColor(C: Character, Color: string): void;
+declare function DialogChangeItemColor(C: Character, Color: BCColor): void;
 /**
  * Returns the button image name for a dialog menu button based on the button name.
  * @param {DialogMenuButton} ButtonName - The menu button name
@@ -780,9 +780,9 @@ declare function DialogMouseDown(event: MouseEvent | TouchEvent): void;
 declare var DialogTextDefaultDuration: number;
 /**
  * The default color to use when applying items.
- * @type {null | string}
+ * @type {null | HexColor}
  */
-declare var DialogColorSelect: null | string;
+declare var DialogColorSelect: null | HexColor;
 /**
  * The list of available items for the selected group.
  * @type {DialogInventoryItem[]}

package/bc/Scripts/Drawing.d.ts

@@ -6,10 +6,10 @@
 declare function DrawHexToRGB(color: string): RGBColor;
 /**
  * Converts a RGB color to a hex color string
- * @param {readonly number[]} color - RGB color to conver
- * @returns {string} - Hex color string
+ * @param {readonly [R: number, G: number, B: number]} color - RGB color to conver
+ * @returns {HexColor} - Hex color string
  */
-declare function DrawRGBToHex(color: readonly number[]): string;
+declare function DrawRGBToHex(color: readonly [R: number, G: number, B: number]): HexColor;
 /**
  * Loads the canvas to draw on with its style and event listeners.
  * @returns {void} - Nothing

package/bc/Scripts/Element.d.ts

@@ -659,6 +659,33 @@ declare namespace ElementDOMScreen {
      */
     function setHeading(root: ElementHelp.ElementOrId, heading: string | Element | readonly (string | Element)[]): void;
 }
+declare namespace ElementUnpackIDs {
+    /**
+     * Convert a list of IDs into their corresponding elements.
+     * @template {HTMLElement} [T=HTMLElement]
+     * @param {readonly string[]} list The list of element IDs
+     * @param {null | ElementUnpackIDs.Options<T>} [options] Further options
+     * @returns {T[]} The list of elements (may or may not be shorter than the ID list)
+     */
+    function fromList<T extends HTMLElement = HTMLElement>(list: readonly string[], options?: null | ElementUnpackIDs.Options<T>): T[];
+    /**
+     * Convert a space-separated stringified ID list into their corresponding elements.
+     * @template {HTMLElement} [T=HTMLElement]
+     * @param {string} string The stringified list of comma-separated element IDs
+     * @param {null | ElementUnpackIDs.Options<T>} [options] Further options
+     * @returns {T[]} The list of elements (may or may not be shorter than the ID list)
+     */
+    function fromString<T extends HTMLElement = HTMLElement>(string: string, options?: null | ElementUnpackIDs.Options<T>): T[];
+    /**
+     * Grab an attribute containing a space-separated stringified ID list and convert them into their corresponding elements.
+     * @template {HTMLElement} [T=HTMLElement]
+     * @param {Element} element The element
+     * @param {string} attrName The name of the attribute with the element IDs
+     * @param {null | Exclude<ElementUnpackIDs.Options<T>, "root">} [options] Further options
+     * @returns {T[]} The list of elements (may or may not be shorter than the ID list)
+     */
+    function fromAttribute<T extends HTMLElement = HTMLElement>(element: Element, attrName: string, options?: null | Exclude<ElementUnpackIDs.Options<T>, "root">): T[];
+}
 /**
  * HTML element for color tint pickers, functioning as some kind of 2D `<input type='range'>` input for selecting the color's saturation and brightness.
  */
@@ -673,21 +700,21 @@ declare class HTMLColorTintElement extends HTMLElement {
      */
     _pressedOldValue: null | string;
     connectedCallback(): void;
+    set value(value: HexColor);
     /**
      * Sets or retrieves the initial contents of the object.
      *
-     * See {@link HTMLInputElement.defaultValue}
-     * @type {string}
+     * See {@link HTMLInputElement.value}
+     * @type {HexColor}
      */
-    defaultValue: string;
-    set value(value: string);
+    get value(): HexColor;
     /**
      * Sets or retrieves the initial contents of the object.
      *
-     * See {@link HTMLInputElement.value}
+     * See {@link HTMLInputElement.defaultValue}
      * @type {string}
      */
-    get value(): string;
+    defaultValue: string;
     /**
      * @param {string} name
      * @param {null | string} oldValue

package/bc/Scripts/Inventory.d.ts

@@ -181,14 +181,14 @@ declare function InventoryCraftPropertyIs(): void;
  * @param {Character} C - The character that must wear the item
  * @param {string} AssetName - The name of the asset to wear
  * @param {AssetGroupName} AssetGroup - The name of the asset group to wear
- * @param {string | string[]} [ItemColor] - The hex color of the item, can be undefined or "Default"
- * @param {number} [Difficulty] - The difficulty, on top of the base asset difficulty, to assign to the item
- * @param {number} [MemberNumber] - The member number of the character putting the item on - defaults to -1
- * @param {CraftingItem} [Craft] - The crafting properties of the item
+ * @param {null | ItemColor} [ItemColor] - The hex color of the item, can be undefined or "Default"
+ * @param {null | number} [Difficulty] - The difficulty, on top of the base asset difficulty, to assign to the item
+ * @param {null | number} [MemberNumber] - The member number of the character putting the item on - defaults to -1
+ * @param {null | CraftingItem} [Craft] - The crafting properties of the item
  * @param {boolean} [Refresh] - Whether to refresh the character and push the changes to the server
  * @returns {Item | null} - Thew newly created item or `null` if the asset does not exist
  */
-declare function InventoryWear(C: Character, AssetName: string, AssetGroup: AssetGroupName, ItemColor?: string | string[], Difficulty?: number, MemberNumber?: number, Craft?: CraftingItem, Refresh?: boolean): Item | null;
+declare function InventoryWear(C: Character, AssetName: string, AssetGroup: AssetGroupName, ItemColor?: null | ItemColor, Difficulty?: null | number, MemberNumber?: null | number, Craft?: null | CraftingItem, Refresh?: boolean): Item | null;
 /**
 * Sets the difficulty to remove an item for a body area
 * @param {Character} C - The character that is wearing the item

package/bc/Scripts/Server.d.ts

@@ -156,11 +156,11 @@ declare function ServerBundledItemToAppearanceItem(assetFamily: IAssetFamily, it
 /**
  * Parses an item color, based on the allowed colorable layers on an asset, and the asset's color schema
  * @param {Asset} asset - The asset on which the color is set
- * @param {string | readonly string[]} color - The color value to parse
- * @param {readonly string[]} schema - The color schema to validate against
- * @returns {string|string[]} - A parsed valid item color
+ * @param {BCColor | readonly BCColor[]} color - The color value to parse
+ * @param {readonly BCColor[]} schema - The color schema to validate against
+ * @returns {BCColor | BCColor[]} - A parsed valid item color
  */
-declare function ServerParseColor(asset: Asset, color: string | readonly string[], schema: readonly string[]): string | string[];
+declare function ServerParseColor(asset: Asset, color: BCColor | readonly BCColor[], schema: readonly BCColor[]): BCColor | BCColor[];
 /**
  * Populates an appearance diff map with any required items, to ensure that all asset groups are present that need to
  * be.
@@ -171,12 +171,12 @@ declare function ServerParseColor(asset: Asset, color: string | readonly string[
 declare function ServerAddRequiredAppearance(assetFamily: IAssetFamily, diffMap: AppearanceDiffMap): void;
 /**
  * Validates and returns a color against a color schema
- * @param {string} Color - The color to validate
- * @param {readonly string[]} Schema - The color schema to validate against (a list of accepted Color values)
- * @returns {string} - The color if it is a valid hex color string or part of the color schema, or the default color
+ * @param {BCColor} Color - The color to validate
+ * @param {readonly BCColor[]} Schema - The color schema to validate against (a list of accepted Color values)
+ * @returns {BCColor} - The color if it is a valid hex color string or part of the color schema, or the default color
  *     from the color schema otherwise
  */
-declare function ServerValidateColorAgainstSchema(Color: string, Schema: readonly string[]): string;
+declare function ServerValidateColorAgainstSchema(Color: BCColor, Schema: readonly BCColor[]): BCColor;
 /**
  * Syncs the player appearance with the server database.
  *
@@ -277,14 +277,17 @@ declare const ServerScriptWarningStyle: string;
 /** @readonly */
 declare var ServerAccountUpdate: {
     /**
+     * private
      * @type {Map<keyof ServerAccountUpdateRequest, any>}
      */
     Queue: Map<keyof ServerAccountUpdateRequest, any>;
     /**
+     * private
      * @type {null | ReturnType<typeof setTimeout>}
      */
     Timeout: null | ReturnType<typeof setTimeout>;
     /**
+     * private
      * @type {number}
      */
     Start: number;
@@ -419,7 +422,7 @@ declare namespace ServerAccountDataSyncedValidate {
         ClubCard: GameClubCardParameters;
         Prison: GamePrisonParameters;
     };
-    function LabelColor(arg: string, C: Character): string;
+    function LabelColor(arg: Partial<"" | `#${string}`>, C: Character): `#${string}`;
     function Creation(arg: number, C: Character): number;
     function Description(arg: string, C: Character): string;
     function Ownership(arg: Partial<ServerOwnership>, C: Character): {

package/bc/Scripts/Toasts.d.ts

@@ -75,6 +75,7 @@ declare var ToastManager: {
      * Fills in any missing option fields with default values, then
      * attempts to process the queue to show toasts if slots are available.
      *
+     * private
      * @param {Toasts.Options} options - Configuration for the toast.
      * @returns {void}
      */
@@ -84,6 +85,7 @@ declare var ToastManager: {
      * if the active count is not currently at max capacity. Removes displayed toasts
      * from the queue and updates the active count.
      *
+     * private
      * @returns {void}
      */
     _process(): void;
@@ -91,6 +93,7 @@ declare var ToastManager: {
      * Builds the toast element, hooks up animations, buttons, and timers,
      * and tracks its lifetime until Void kidnaps it.
      *
+     * private
      * @param {Required<Toasts.Options>} _ - Fully resolved options for the toast to display.
      * @returns {void}
      */
@@ -98,6 +101,7 @@ declare var ToastManager: {
     /**
      * Retrieves an existing container element for toasts, or creates a new one if none exists.
      *
+     * private
      * @returns {HTMLDivElement} The container <div> element.
      */
     _getOrCreateContainer(): HTMLDivElement;
@@ -106,6 +110,7 @@ declare var ToastManager: {
      * Calls onFinish when the progress reaches its maximum. Returns a function that can
      * be called to stop the animation prematurely.
      *
+     * private
      * @param {HTMLProgressElement} progress - The <progress> element to animate.
      * @param {() => void | undefined} onFinish - Callback invoked when the animation completes.
      * @param {number} durationMs - Total time in milliseconds for the progress to fill.

package/bc/Scripts/Validation.d.ts

@@ -15,10 +15,11 @@ declare function ValidationCreateDiffParams(C: Character, sourceMemberNumber: nu
  * @param {Item|null} previousItem - The previous item that the target character had equipped (or null if none)
  * @param {Item|null} newItem - The new item to equip (may be identical to the previous item, or null if removing)
  * @param {AppearanceUpdateParameters} params - The appearance update parameters that apply to the diff
+ * @param {boolean} unknownAsset - Whether the incoming item is from an asset we're missing
  * @returns {ItemDiffResolution} - The diff resolution - a wrapper object containing the final item and a flag
  * indicating whether or not the change was valid.
  */
-declare function ValidationResolveAppearanceDiff(groupName: AssetGroupName, previousItem: Item | null, newItem: Item | null, params: AppearanceUpdateParameters): ItemDiffResolution;
+declare function ValidationResolveAppearanceDiff(groupName: AssetGroupName, previousItem: Item | null, newItem: Item | null, params: AppearanceUpdateParameters, unknownAsset: boolean): ItemDiffResolution;
 /**
  * Check whether newArray is different from oldArray.
  * @template T

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bc-stubs",
-  "version": "125.0.1",
+  "version": "126.0.0",
   "repository": {
     "type": "git",
     "url": "git+ssh://git@github.com/bananarama92/BC-stubs.git"