feat(query): add dis max compound query

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: Spamercz

doc/02-query-objects.md

@@ -310,6 +310,20 @@ new \Spameri\ElasticQuery\Query\ConstantScore(
 );
 ```
 
+##### DisMax Query
+Best-of-many — returns the highest-scoring sub-query per document, with `tie_breaker` for the rest.
+- Class: `\Spameri\ElasticQuery\Query\DisMax`
+- [Documentation](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-dis-max-query.html)
+- [Implementation](https://github.com/Spameri/ElasticQuery/blob/master/src/Query/DisMax.php)
+
+```php
+$disMax = new \Spameri\ElasticQuery\Query\DisMax(
+	query: new \Spameri\ElasticQuery\Query\Term('title', 'foo'),
+	tieBreaker: 0.7,
+);
+$disMax->addQuery(new \Spameri\ElasticQuery\Query\Term('body', 'foo'));
+```
+
 ##### Boosting Query
 Match `positive` docs but lower the score of `negative` matches.
 - Class: `\Spameri\ElasticQuery\Query\Boosting`

src/Query/DisMax.php

@@ -0,0 +1,65 @@
+<?php
+
+declare(strict_types = 1);
+
+namespace Spameri\ElasticQuery\Query;
+
+/**
+ * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-dis-max-query.html
+ */
+class DisMax implements \Spameri\ElasticQuery\Query\LeafQueryInterface
+{
+
+	/**
+	 * @var array<int, \Spameri\ElasticQuery\Query\LeafQueryInterface>
+	 */
+	private array $queries;
+
+
+	public function __construct(
+		\Spameri\ElasticQuery\Query\LeafQueryInterface $query,
+		private float $tieBreaker = 0.0,
+		private float $boost = 1.0,
+	)
+	{
+		$this->queries = [$query];
+	}
+
+
+	public function addQuery(\Spameri\ElasticQuery\Query\LeafQueryInterface $query): void
+	{
+		$this->queries[] = $query;
+	}
+
+
+	public function key(): string
+	{
+		$keys = [];
+		foreach ($this->queries as $query) {
+			$keys[] = $query->key();
+		}
+
+		return 'dis_max_' . \implode('-', $keys);
+	}
+
+
+	/**
+	 * @return array<string, array<string, mixed>>
+	 */
+	public function toArray(): array
+	{
+		$queries = [];
+		foreach ($this->queries as $query) {
+			$queries[] = $query->toArray();
+		}
+
+		return [
+			'dis_max' => [
+				'queries' => $queries,
+				'tie_breaker' => $this->tieBreaker,
+				'boost' => $this->boost,
+			],
+		];
+	}
+
+}

tests/SpameriTests/ElasticQuery/Query/DisMax.phpt

@@ -0,0 +1,64 @@
+<?php declare(strict_types = 1);
+
+namespace SpameriTests\ElasticQuery\Query;
+
+require_once __DIR__ . '/../../bootstrap.php';
+
+
+class DisMax extends \Tester\TestCase
+{
+
+	private const INDEX = 'spameri_test_query_dis_max';
+
+
+	public function setUp(): void
+	{
+		$ch = \curl_init();
+		\curl_setopt($ch, \CURLOPT_URL, \ELASTICSEARCH_HOST . '/' . self::INDEX);
+		\curl_setopt($ch, \CURLOPT_RETURNTRANSFER, 1);
+		\curl_setopt($ch, \CURLOPT_CUSTOMREQUEST, 'PUT');
+		\curl_setopt($ch, \CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
+
+		\curl_exec($ch);
+	}
+
+
+	public function testToArray(): void
+	{
+		$disMax = new \Spameri\ElasticQuery\Query\DisMax(
+			query: new \Spameri\ElasticQuery\Query\Term('title', 'foo'),
+			tieBreaker: 0.7,
+		);
+		$disMax->addQuery(new \Spameri\ElasticQuery\Query\Term('body', 'foo'));
+
+		$array = $disMax->toArray();
+
+		\Tester\Assert::same(0.7, $array['dis_max']['tie_breaker']);
+		\Tester\Assert::count(2, $array['dis_max']['queries']);
+	}
+
+
+	public function testKey(): void
+	{
+		$disMax = new \Spameri\ElasticQuery\Query\DisMax(
+			new \Spameri\ElasticQuery\Query\Term('title', 'foo'),
+		);
+
+		\Tester\Assert::same('dis_max_term_title_foo', $disMax->key());
+	}
+
+
+	public function tearDown(): void
+	{
+		$ch = \curl_init();
+		\curl_setopt($ch, \CURLOPT_URL, \ELASTICSEARCH_HOST . '/' . self::INDEX);
+		\curl_setopt($ch, \CURLOPT_RETURNTRANSFER, 1);
+		\curl_setopt($ch, \CURLOPT_CUSTOMREQUEST, 'DELETE');
+		\curl_setopt($ch, \CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
+
+		\curl_exec($ch);
+	}
+
+}
+
+(new DisMax())->run();