🤖 Merge PR DefinitelyTyped#73940 feat(emscripten): add stringToNewUTF8 and stringToUTF8OnStack function definitions by @jermy

Co-authored-by: Jeremy James <[email protected]>

Author: jermy

types/emscripten/emscripten-tests.ts

@@ -194,6 +194,8 @@ function StringConv(): void {
     stringToUTF16(s, p, 42);
     stringToUTF32(s, p);
     stringToUTF32(s, p, 42);
+    p = stringToNewUTF8(s);
+    Module._free(p);
     p = allocateUTF8(s);
     Module._free(p);
 }
@@ -202,7 +204,8 @@ function StringConv(): void {
 function StackAlloc() {
     const stack = stackSave();
     const ptr = stackAlloc(42);
-    const strPtr = allocateUTF8OnStack("testString");
+    const strPtr = stringToUTF8OnStack("testString");
+    const legacyStrPtr = allocateUTF8OnStack("testString");
     stackRestore(stack);
 }
 

types/emscripten/index.d.ts

@@ -467,8 +467,12 @@ declare function AsciiToString(ptr: number): string;
 declare function UTF8ToString(ptr: number, maxBytesToRead?: number): string;
 declare function stringToUTF8(str: string, outPtr: number, maxBytesToRead?: number): void;
 declare function lengthBytesUTF8(str: string): number;
+/** @deprecated - Use `stringToNewUTF8` instead */
 declare function allocateUTF8(str: string): number;
+/** @deprecated - Use `stringToUTF8OnStack` instead */
 declare function allocateUTF8OnStack(str: string): number;
+declare function stringToNewUTF8(str: string): number;
+declare function stringToUTF8OnStack(str: string): number;
 declare function UTF16ToString(ptr: number): string;
 declare function stringToUTF16(str: string, outPtr: number, maxBytesToRead?: number): void;
 declare function lengthBytesUTF16(str: string): number;