docs: server-driven captchaType

The captcha type is now configured in the Prosopo portal per site key,
not as a client-side data-captcha-type attribute / render-option prop.
Update captcha-types.mdx + invisible-captcha.mdx to explain the new flow
and patch stale references in client-side-rendering.mdx + faq.mdx.

English versions are updated in-place. The other five language variants
(de/es/fr/it/pt-br) are ported with i18nReady: false on the changed pages
so translators can revisit.

Author: HughParry

src/content/docs/de/basics/captcha-types.mdx

@@ -1,89 +1,84 @@
 ---
-title: "CAPTCHA-Typen"
-description: "Stellen Sie verschiedene CAPTCHA-Typen bereit, indem Sie `captchaType` auf `frictionless`, `pow` oder `image` setzen."
-i18nReady: true
+title: CAPTCHA Types
+description: Choose between frictionless, pow, image, or puzzle CAPTCHA challenges. The type is configured in the Prosopo portal — the widget always asks the server which to render.
+i18nReady: false
 ---
 import {Image} from 'astro:assets';
 import ProcaptchaGIF from '~/assets/procaptcha-pow.gif';
 import ImageCaptcha from '~/assets/image-captcha.png';
 import PoWSettings from '~/assets/pow-settings.png';
 import ImageSettings from '~/assets/image-settings.png';
 
-Stellen Sie **verschiedene** CAPTCHA-Typen bereit, indem Sie `captchaType` auf `frictionless`, `pow` oder `image` setzen.
+Procaptcha supports four CAPTCHA types: `frictionless`, `pow`, `image`, and `puzzle`. The type is configured **per site key in the [Prosopo portal](https://portal.prosopo.io)** — the widget itself does not pick the type. On every challenge the widget calls the server, and the server returns the type to render based on your site-key settings.
 
 ## Frictionless CAPTCHA
 
-Die standardmäßige `frictionless`-Funktion von Procaptcha erkennt dynamisch, ob der Benutzer einen normalen Browser oder automatisierte,
-headless Browser wie [playwright](https://playwright.dev/) oder [selenium](https://www.selenium.dev/) verwendet. Wenn der Benutzer
-wahrscheinlich ein Bot ist, wird dem Benutzer eine Bild-CAPTCHA-Herausforderung präsentiert. Wenn der Benutzer wahrscheinlich ein *Mensch* ist, wird
-dem Benutzer *keine* Bild-CAPTCHA-Herausforderung präsentiert und stattdessen wird eine einfache, unsichtbare Proof of Work
-(PoW)-Herausforderung gelöst.
+Procaptcha's default `frictionless` type dynamically detects whether the user is using a normal browser or an automated, headless browser such as [Playwright](https://playwright.dev/) or [Selenium](https://www.selenium.dev/). If the user is likely to be a bot, the server returns an **image** challenge. If the user is likely to be a *human*, the server returns an invisible **Proof of Work** challenge.
+
+In other words, `frictionless` is a routing decision made by the server: it looks at the bot score, access policies, and other signals, then picks one of `image`, `pow`, or `puzzle` for that specific request.
 
 ## Proof of Work (PoW) CAPTCHA
 
-Eine Proof of Work (`pow`) CAPTCHA-Herausforderung erfordert, dass der Benutzer ein Rechenpuzzle löst, bevor das Formular übermittelt wird. Es ist für Menschen einfach zu lösen, aber rechnerisch teuer für Bots.
+A Proof of Work (`pow`) CAPTCHA challenge requires the user's browser to solve a computational puzzle before submitting the form. It is easy for humans to solve but computationally expensive for bots.
 
 <Image src={ProcaptchaGIF} alt={'prosopo procaptcha pow captcha challenge'} style="margin: 20px auto;"/>
 
-Der Proof of Work CAPTCHA-Typ untersucht nicht die Browserumgebung des Benutzers, verwenden Sie dafür `frictionless` (siehe oben).
+The PoW type does not interrogate the user's browser environment — use `frictionless` if you want that.
 
-## Bild-CAPTCHA
+## Image CAPTCHA
 
-Eine Bild-CAPTCHA-Herausforderung erfordert, dass der Benutzer das/die richtige(n) Bild(er) auswählt, das/die der gegebenen Aufforderung entspricht/entsprechen.
+An image CAPTCHA challenge requires the user to select the correct image(s) that match the given prompt.
 
 <Image
     src={ImageCaptcha}
     alt="prosopo procaptcha image captcha challenge"
     style="margin: 0 auto;"
 />
 
-Der Bild-CAPTCHA-Typ untersucht nicht die Browserumgebung des Benutzers, verwenden Sie dafür `frictionless` (siehe oben).
-
-## Typ implizit setzen
+The Image type does not interrogate the user's browser environment — use `frictionless` if you want that.
 
-### 1. Setzen Sie den Typ in der Widget-Konfiguration
+## Puzzle CAPTCHA
 
-Hier setzen wir `captchaType` auf Proof-of-Work `pow`.
+A puzzle CAPTCHA challenge requires the user to drag a piece into a target slot. It does not interrogate the user's browser environment — use `frictionless` if you want that.
 
-```html
-<div class="procaptcha" data-sitekey="your_site_key" data-captcha-type="pow"></div>
-```
+## Configuring the CAPTCHA type
 
-### 2. Setzen Sie den Typ im Portal
+The CAPTCHA type is configured **per site key** in the Prosopo portal. The widget on your page does not select the type — it always asks the server, and the server replies with the configured type (or, when configured as `frictionless`, with whichever type the decision machine selected for that request).
 
-Navigieren Sie zum [Prosopo Portal](https://portal.prosopo.io) und aktualisieren Sie den CAPTCHA-Typ in den Einstellungen auf `pow`.
-
-<Image
-    src={PoWSettings}
-    alt="prosopo pow setting"/>
+### 1. Add the widget to your page
 
-## Typ explizit setzen
+Whether you choose `frictionless`, `pow`, `image`, or `puzzle`, your HTML/JS stays the same:
 
-### 1. Setzen Sie den Typ in der Widget-Konfiguration
+```html
+<div class="procaptcha" data-sitekey="your_site_key"></div>
+```
 
-Hier setzen wir `captchaType` auf Bild `image`.
+Or with the explicit render API:
 
 ```javascript
 document.getElementById('procaptcha-script').addEventListener('load', function () {
     function onCaptchaVerified(output) {
         console.log('Captcha verified, output: ' + JSON.stringify(output))
     }
-    // Get the Element using elementId
     const captchaContainer = document.getElementById('procaptcha-container')
     window.procaptcha.render(captchaContainer, {
         siteKey: 'YOUR_SITE_KEY',
         theme: 'dark',
         callback: onCaptchaVerified,
-        captchaType: 'image', // `pow` or leave blank for `frictionless`
     })
 })
 ```
 
-### 2. Setzen Sie den Typ im Portal
+### 2. Set the type in the portal
+
+Navigate to the [Prosopo portal](https://portal.prosopo.io) and update the CAPTCHA type in the site key's settings. Pick `frictionless`, `pow`, `image`, or `puzzle`.
 
-Navigieren Sie zum [Prosopo Portal](https://portal.prosopo.io) und aktualisieren Sie den CAPTCHA-Typ in den Einstellungen auf `image`.
+<Image
+    src={PoWSettings}
+    alt="prosopo pow setting"/>
 
 <Image
     src={ImageSettings}
     alt="prosopo image setting"/>
 
+To use a different type for a different surface (for example, `pow` on one page and `image` on another), create a separate site key for each surface and set its type independently.

src/content/docs/de/basics/client-side-rendering.mdx

@@ -1,7 +1,7 @@
 ---
 title: "Clientseitiges Rendering"
 description: "Rendern Sie das Procaptcha Widget auf Ihrer Website mit der Procaptcha JavaScript-Ressource."
-i18nReady: true
+i18nReady: false
 ---
 
 Zuerst müssen Sie die Procaptcha JavaScript-Ressource irgendwo in Ihrer HTML-Seite einbinden. Das `<script>` muss
@@ -113,7 +113,6 @@ folgenden Felder enthalten:
 | siteKey              | string             | Der sitekey Ihrer Anwendung / Website. Dies ist erforderlich.                                                                                                    | ✓            |
 | callback             | string or function | Der Name der Window-Funktion oder eine Funktion, die aufgerufen wird, wenn das CAPTCHA verifiziert wurde.                                                        | ✗            |
 | theme                | string             | Das Theme des CAPTCHA-Widgets. Der Standard ist `light`. Die andere Option ist `dark`.                                                                           | ✗            |
-| captchaType          | string             | Der Typ des zu rendernden CAPTCHA. Der Standard ist `frictionless`. Andere Optionen sind `image`, `pow`.                                                         | ✗            |
 | chalexpired-callback | string or function | Der Name der Window-Funktion oder eine Funktion, die aufgerufen wird, wenn die CAPTCHA-Herausforderung abläuft.                                                  | ✗            |
 | error-callback       | string or function | Der Name der Window-Funktion oder eine Funktion, die aufgerufen wird, wenn ein Fehler auftritt.                                                                  | ✗            |
 | close-callback       | string or function | Der Name der Window-Funktion oder eine Funktion, die aufgerufen wird, wenn das CAPTCHA geschlossen wird.                                                         | ✗            |
@@ -139,7 +138,21 @@ und die Callback-Funktion am Window-Objekt definieren.
 <div class="procaptcha" data-sitekey="your_site_key" data-callback="yourCallbackFunction"></div>
 ```
 
-### `captchaType`
+### CAPTCHA Type
+
+The CAPTCHA type is configured **per site key in the [Prosopo portal](https://portal.prosopo.io)** — the widget itself does not select the type, and there is no client-side option to set it. On every challenge the widget asks the server, and the server returns the type to render based on the site-key settings.
+
+Available types:
+
+| Type           | Description                                                                                                                                                                                                                                                                           |
+| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `frictionless` | The default CAPTCHA type. The server inspects the request and serves the lightest challenge that's safe — typically an invisible [Proof of Work challenge](https://en.wikipedia.org/wiki/Proof_of_work) for likely humans, and an image, pow, or puzzle challenge when the request looks suspicious. |
+| `pow`          | The user's browser solves a cryptographic puzzle. Easy for humans, computationally expensive for bots in volume.                                                                                                                                                                      |
+| `image`        | The user selects images that match a prompt. The familiar reCAPTCHA-style challenge.                                                                                                                                                                                                  |
+| `puzzle`       | The user drags a puzzle piece into a target slot.                                                                                                                                                                                                                                     |
+
+For full details see [CAPTCHA Types](/de/basics/captcha-types/).
+
 
 Sie können beim Rendern der Procaptcha-Komponente jeden der folgenden CAPTCHA-Typen implementieren:
 

src/content/docs/de/basics/faq.mdx

@@ -1,7 +1,7 @@
 ---
 title: "Häufig gestellte Fragen"
 description: "Häufige Fragen und Antworten zu Procaptcha."
-i18nReady: true
+i18nReady: false
 ---
 
 ### Was bedeutet `Site Key not Registered`?
@@ -18,10 +18,9 @@ Dieser Fehler tritt auf, wenn die Domain des sitekey nicht mit der Domain der We
 verwendet wird. Um diesen Fehler zu beheben, stellen Sie sicher, dass die Domain des sitekey mit der Domain der Website übereinstimmt, indem Sie
 sich beim [Prosopo Portal](https://portal.prosopo.io) anmelden und die Domain aktualisieren.
 
-### Was bedeutet `Incorrect CAPTCHA type`?
-Dieser Fehler tritt auf, wenn der [CAPTCHA-Typ](/de/basics/captcha-types) nicht korrekt gesetzt ist. Der Standard-`captchaType` ist
-`frictionless`. Wenn Sie `pow` oder `image` verwenden möchten, müssen Sie Ihren `captchaType` in der Widget-Konfiguration auf `pow`
-oder `image` setzen. Sie müssen auch Ihre [Portaleinstellungen](https://portal.prosopo.io) entsprechend aktualisieren.
+### What does `Incorrect CAPTCHA type` mean?
+This error means the request hit an endpoint that doesn't match the [captcha type](/de/basics/captcha-types) configured for the site key. The CAPTCHA type lives **only** in the [Prosopo portal](https://portal.prosopo.io) — set it on the site key, and the widget will pick it up automatically on the next render.
+
 
 ### Was bedeutet `Session not found`?
 Dieser Fehler tritt auf, wenn die Sitzung nicht gefunden wird. Dies kann passieren, wenn die Sitzung abgelaufen ist oder wenn die Sitzungs-ID