🤖 Merge PR DefinitelyTyped#73311 [@types/pdfkit] add boundsOfString by @m4rvr

Author: lockinmarv

types/pdfkit/index.d.ts

@@ -577,6 +577,13 @@ declare namespace PDFKit.Mixins {
         structTypes?: [string | null, string | null, string | null] | undefined;
     }
 
+    interface TextBounds {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }
+
     interface PDFText {
         lineGap(lineGap: number): this;
         moveDown(line?: number): this;
@@ -585,6 +592,8 @@ declare namespace PDFKit.Mixins {
         text(text: string, options?: TextOptions): this;
         widthOfString(text: string, options?: TextOptions): number;
         heightOfString(text: string, options?: TextOptions): number;
+        boundsOfString(text: string, x?: number, y?: number, options?: TextOptions): TextBounds;
+        boundsOfString(text: string, options?: TextOptions): TextBounds;
         list(list: Array<string | any>, x?: number, y?: number, options?: TextOptions): this;
         list(list: Array<string | any>, options?: TextOptions): this;
     }

types/pdfkit/pdfkit-tests.ts

@@ -712,3 +712,13 @@ const optionalPDF: PDFKit.PDFDocument = new PDFDocument({
 
 // Test outlines
 doc.outline.addItem("A");
+
+// $ExpectType TextBounds
+doc.boundsOfString("Bounds of string", 50, 100, {
+    align: "left",
+});
+
+// $ExpectType TextBounds
+doc.boundsOfString("Bounds of string", {
+    align: "left",
+});