🤖 Merge PR DefinitelyTyped#70139 [@types/cloudflare-turnstile] Add "execution" to cloudflare turnstile render params by @pkong-ds

Author: pkong-ds

types/cloudflare-turnstile/cloudflare-turnstile-tests.ts

@@ -35,6 +35,9 @@ const refreshTimeoutNever: Turnstile.RefreshTimeoutMode = "never";
 const refreshTimeoutManual: Turnstile.RefreshTimeoutMode = "manual";
 const refreshTimeoutAuto: Turnstile.RefreshTimeoutMode = "auto";
 
+const executionRender: Turnstile.ExecutionMode = "render";
+const executionExecute: Turnstile.ExecutionMode = "execute";
+
 // @ts-expect-error
 turnstile.ready();
 // $ExpectType void

types/cloudflare-turnstile/index.d.ts

@@ -87,6 +87,14 @@ declare namespace Turnstile {
      */
     type RefreshTimeoutMode = "never" | "manual" | "auto";
 
+    /**
+     * The execution mode to controls when to obtain the widget token
+     * The default is "render". "render" will make the challenge runs automatically after calling the render() function, while
+     * "execute" will make the challenge runs after the render() function has been called, by invoking the turnstile.execute function separately.
+     * This detaches the appearance and rendering of a widget from its execution.
+     */
+    type ExecutionMode = "render" | "execute";
+
     /**
      * Parameters for the turnstile.render() method.
      */
@@ -219,5 +227,12 @@ declare namespace Turnstile {
          * @default "auto"
          */
         "refresh-timeout"?: RefreshTimeoutMode | undefined;
+
+        /**
+         * Optional
+         * @see ExecutionMode
+         * @default "render"
+         */
+        execution?: ExecutionMode | undefined;
     }
 }