feat: captions api

Author: iamsirenstorm

p2ce/caption.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @packageDocumentation
+ * Captioning Interface
+ */
+
+interface CaptionUnit {
+    text: string;
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+
+interface Caption {
+    bLowPriority: boolean;
+    bSFX: boolean;
+    noRepeat: number;
+    delay: number;
+    lifetimeOverride: number;
+    units: Array<CaptionUnit>;
+    options: Map<string, string>;
+}
+
+interface GlobalEventNameMap {
+    BadCaptionRequest: (token: string, lifetime: number) => void;
+    DisplayCaptionRequest: (token: string, caption: Caption, lifetime: number) => void;
+    DisplayRawCaptionRequest: (text: string, lifetime: number) => void;
+    CaptionTick: (time: number) => void;
+}

shared/panels.d.ts

@@ -447,6 +447,18 @@ declare interface Label extends AbstractPanel<'Label'> {
 	SetLocalizationString(text: string): void;
 
 	SetProceduralTextThatIPromiseIsLocalizedAndEscaped(text: string, allowDialogVariables: boolean): void;
+
+	/**
+	 * Sets the color for a specified range of characters.
+	 * This doesn't work if you are trying to set a color for range of 0 - x, set the base style instead!
+	 */
+	SetTextColorRange(startChar: number, endChar: number, colorR: number, colorG: number, colorB: number, colorA: number ): void;
+
+	/**
+	 * Approximates the height this label would have
+	 * if the passed in text was set, given a pre-determined width.
+	 */ 
+	GetHeightForText(width: number, text: string): number;
 }
 
 declare interface Movie extends AbstractPanel<'Movie'> {