fix: resolve QA errors and merge docs into single README

- Fix phpstan errors (type safety, return types, mixed handling)
- Fix codesniffer errors (method order, parent spacing, annotations)
- Merge seznamcaptcha docs into main README.md
- Remove @license annotations (forbidden by ruleset)

Author: claude

.docs/README.md

@@ -9,7 +9,7 @@
 - Controls
   - [Date/time inputs](#date-time-inputs) (DateTimeInput, DateInput, TimeInput)
 - Captcha
-  - [Seznam Captcha](seznamcaptcha/README.md)
+  - [Seznam Captcha](#seznam-captcha)
 
 ## Setup
 
@@ -348,3 +348,118 @@ $control->setValueAs(DateTime::class); // value in input timezone as \DateTime
 $control->setValueInTzAs(DateTime::class); // value in server default timezone as \DateTime
 $control->setValueInTzAs(DateTime::class, new DateTimeZone('Americe/New_York')); // value in given timezone as \DateTime
 ```
+
+## Captcha
+
+### Seznam Captcha
+
+Integration with [Seznam.cz Captcha](https://captcha.seznam.cz) service.
+
+#### Usage
+
+```neon
+extensions:
+	captcha: Contributte\Forms\Captcha\Seznam\DI\SeznamCaptchaExtension
+```
+
+#### Configuration
+
+By default is `auto: on` and `method: http`, you can disable it and bind addCaptcha to your forms by yourself.
+
+```neon
+captcha:
+	auto: off # on | off
+	method: xmlrpc # http | xmlrpc
+```
+
+#### Form
+
+![captcha](seznamcaptcha/captcha.png)
+
+Just register an extension and keep `auto` argument as it is.
+
+```php
+use Nette\Application\UI\Form;
+
+protected function createComponentForm(): Form
+{
+	$form = new Form();
+
+	$form->addCaptcha('captcha')
+		->setRequired('Are you robot?');
+
+	$form->addSubmit('send');
+
+	$form->onSuccess[] = function (Form $form): void {
+		dump($form['captcha']);
+	};
+
+	return $form;
+}
+```
+
+#### Rendering
+
+##### Automatic
+
+```latte
+{control form}
+```
+
+##### Manual
+
+It needs a `CaptchaContainer` consists of 2 inputs `image` and `code`.
+
+```latte
+<form n:name="form">
+    {input captcha-image}
+    {input captcha-code}
+</form>
+```
+
+#### Example
+
+```php
+use Contributte\Forms\Captcha\Seznam\CaptchaValidator;
+use Contributte\Forms\Captcha\Seznam\Forms\CaptchaHash;
+use Contributte\Forms\Captcha\Seznam\Forms\CaptchaImage;
+use Contributte\Forms\Captcha\Seznam\Forms\CaptchaInput;
+use Contributte\Forms\Captcha\Seznam\Provider\ProviderFactory;
+use Nette\Application\UI\Form;
+
+/** @var ProviderFactory @inject */
+public ProviderFactory $providerFactory;
+
+protected function createComponentForm(): Form
+{
+	$form = new Form();
+
+	$provider = $this->providerFactory->create();
+	$form['image'] = new CaptchaImage('Captcha', $provider);
+	$form['hash'] = new CaptchaHash($provider);
+	$form['code'] = new CaptchaInput('Code');
+
+	$form->addSubmit('send');
+
+	$form->onValidate[] = function (Form $form) use ($provider): void {
+		$validator = new CaptchaValidator($provider);
+
+		$hash = $form['hash']->getHttpHash();
+		$code = $form['code']->getHttpCode();
+
+		if ($validator->validate($code, $hash) !== true) {
+			$form->addError('Are you robot?');
+		}
+	};
+
+	$form->onSuccess[] = function (Form $form): void {
+		dump($form);
+	};
+
+	return $form;
+}
+```
+
+For better usability add this functionality to your `BaseForms`, `BaseFormFactory` or something like this.
+
+You can also create a trait for it.

.docs/seznamcaptcha/README.md

@@ -2,11 +2,6 @@
 
 namespace Contributte\Forms\Captcha\Seznam\Backend;
 
-use RuntimeException;
-
-/**
- * @license https://github.com/seznam/captcha-client
- */
 abstract class Client
 {
 

src/Captcha/Seznam/Backend/Client.php

@@ -4,42 +4,9 @@
 
 use RuntimeException;
 
-/**
- * @license https://github.com/seznam/captcha-client
- */
 class HttpClient extends Client
 {
 
-	/**
-	 * @param array<string, mixed> $params
-	 * @return array{status: int, data: string|false}
-	 */
-	protected function call(string $methodName, array $params = []): array
-	{
-		$url = sprintf('https://%s:%d/%s?%s', $this->serverHostname, $this->serverPort, $methodName, http_build_query($params));
-		$ch = curl_init($url);
-
-		if ($ch === false) {
-			throw new RuntimeException('Failed to initialize curl');
-		}
-
-		curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
-
-		if ($this->proxyHostname !== null) {
-			curl_setopt($ch, CURLOPT_PROXY, $this->proxyHostname);
-			curl_setopt($ch, CURLOPT_PROXYPORT, $this->proxyPort);
-		}
-
-		$response = curl_exec($ch);
-		$info = curl_getinfo($ch);
-		curl_close($ch);
-
-		return [
-			'status' => (int) $info['http_code'],
-			'data' => $response,
-		];
-	}
-
 	public function create(): string
 	{
 		$result = $this->call('captcha.create');
@@ -84,4 +51,35 @@ public function check(string $hash, string $code): bool
 		return $result['status'] === 200;
 	}
 
+	/**
+	 * @param array<string, mixed> $params
+	 * @return array{status: int, data: string|false}
+	 */
+	protected function call(string $methodName, array $params = []): array
+	{
+		$url = sprintf('https://%s:%d/%s?%s', $this->serverHostname, $this->serverPort, $methodName, http_build_query($params));
+		$ch = curl_init($url);
+
+		if ($ch === false) {
+			throw new RuntimeException('Failed to initialize curl');
+		}
+
+		curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+
+		if ($this->proxyHostname !== null) {
+			curl_setopt($ch, CURLOPT_PROXY, $this->proxyHostname);
+			curl_setopt($ch, CURLOPT_PROXYPORT, $this->proxyPort);
+		}
+
+		/** @var string|false $response */
+		$response = curl_exec($ch);
+		$info = curl_getinfo($ch);
+		curl_close($ch);
+
+		return [
+			'status' => $info['http_code'],
+			'data' => $response,
+		];
+	}
+
 }