├── .prettierrc.json
├── LICENSE
├── README.md
├── assets
    ├── dist
    │   ├── controller.d.ts
    │   ├── controller.js
    │   ├── controllers
    │   │   ├── range-slider_controller.d.ts
    │   │   ├── range-slider_controller.js
    │   │   ├── refinement-list_controller.d.ts
    │   │   └── refinement-list_controller.js
    │   └── default.min.css
    └── package.json
├── compose.yaml
├── composer.json
├── config
    └── services.php
├── docs
    ├── components
    │   ├── ClearRefinements.md
    │   ├── CurrentRefinements.md
    │   ├── Facet
    │   │   ├── RangeInput.md
    │   │   ├── RangeSlider.md
    │   │   └── RefinementList.md
    │   ├── Hits.md
    │   ├── HitsPerPage.md
    │   ├── Layout.md
    │   ├── Pagination.md
    │   ├── SearchInput.md
    │   ├── SortBy.md
    │   └── TotalHits.md
    ├── create-own-adapter.md
    ├── image
    │   └── preview.png
    └── usage
    │   ├── algolia.md
    │   ├── customize-your-search.md
    │   ├── doctrine.md
    │   └── meilisearch.md
├── eslint.config.mjs
├── package-lock.json
├── phpunit.dist.xml
├── src
    ├── Adapter
    │   ├── AbstractAdapter.php
    │   ├── AdapterFactoryInterface.php
    │   ├── AdapterInterface.php
    │   ├── AdapterProvider.php
    │   ├── Algolia
    │   │   ├── AlgoliaAdapter.php
    │   │   ├── AlgoliaFactory.php
    │   │   └── QueryBuilder.php
    │   ├── Doctrine
    │   │   ├── DoctrineAdapter.php
    │   │   ├── DoctrineFactory.php
    │   │   └── QueryBuilderHelper.php
    │   └── Meilisearch
    │   │   ├── MeilisearchAdapter.php
    │   │   ├── MeilisearchFactory.php
    │   │   └── QueryBuilder.php
    ├── Attribute
    │   └── AsSearch.php
    ├── Context
    │   ├── Context.php
    │   └── ContextProvider.php
    ├── DependencyInjection
    │   ├── AdapterFactoryPass.php
    │   ├── RegisterSearchPass.php
    │   └── UrlFormaterPass.php
    ├── Event
    │   ├── PostSearchEvent.php
    │   └── PreSearchEvent.php
    ├── EventSubscriber
    │   └── ContextSubscriber.php
    ├── Exception
    │   ├── AdapterException.php
    │   ├── ContextException.php
    │   ├── DoctrineAdapterException.php
    │   ├── ResultSetException.php
    │   ├── SearchException.php
    │   └── UrlFormaterException.php
    ├── Maker
    │   └── MakeSearch.php
    ├── MezcalitoUxSearchBundle.php
    ├── Search
    │   ├── AbstractSearch.php
    │   ├── Facet.php
    │   ├── Filter
    │   │   ├── AbstractFilter.php
    │   │   ├── FilterInterface.php
    │   │   ├── RangeFilter.php
    │   │   └── TermFilter.php
    │   ├── Query.php
    │   ├── ResultSet
    │   │   ├── FacetStat.php
    │   │   ├── FacetTermDistribution.php
    │   │   ├── Hit.php
    │   │   └── ResultSet.php
    │   ├── SearchInterface.php
    │   ├── SearchProvider.php
    │   ├── Searcher.php
    │   ├── Sort.php
    │   └── Url
    │   │   ├── CurrentRequest.php
    │   │   ├── DefaultUrlFormater.php
    │   │   ├── UrlFormaterInterface.php
    │   │   └── UrlFormaterProvider.php
    └── Twig
    │   ├── Components
    │       ├── ClearRefinements.php
    │       ├── CurrentRefinements.php
    │       ├── Facet.php
    │       ├── Facet
    │       │   ├── AbstractFacet.php
    │       │   ├── RangeInput.php
    │       │   ├── RangeSlider.php
    │       │   └── RefinementList.php
    │       ├── Hits.php
    │       ├── HitsPerPage.php
    │       ├── Layout.php
    │       ├── Pagination.php
    │       ├── SearchInput.php
    │       ├── SortBy.php
    │       └── TotalHits.php
    │   └── UxSearchExtension.php
├── templates
    ├── ClearRefinements.html.twig
    ├── CurrentRefinements.html.twig
    ├── Facet.html.twig
    ├── Facet
    │   ├── RangeInput.html.twig
    │   ├── RangeSlider.html.twig
    │   └── RefinementList.html.twig
    ├── Hits.html.twig
    ├── HitsPerPage.html.twig
    ├── Layout.html.twig
    ├── Pagination.html.twig
    ├── SearchInput.html.twig
    ├── SortBy.html.twig
    ├── TotalHits.html.twig
    └── skeleton
    │   └── search.tpl.php
└── translations
    ├── mezcalito_ux_search.en.php
    └── mezcalito_ux_search.fr.php


/.prettierrc.json:
--------------------------------------------------------------------------------
1 | {
2 |   "tabWidth": 2,
3 |   "singleQuote": true,
4 |   "trailingComma": "all",
5 |   "arrowParens": "avoid",
6 |   "printWidth": 120
7 | }


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | Copyright (c) 2024 Mezcalito
 2 | 
 3 | Permission is hereby granted, free of charge, to any person obtaining a copy
 4 | of this software and associated documentation files (the "Software"), to deal
 5 | in the Software without restriction, including without limitation the rights
 6 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 7 | copies of the Software, and to permit persons to whom the Software is furnished
 8 | to do so, subject to the following conditions:
 9 | 
10 | The above copyright notice and this permission notice shall be included in all
11 | copies or substantial portions of the Software.
12 | 
13 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
14 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
15 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
16 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
17 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
18 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
19 | THE SOFTWARE.


--------------------------------------------------------------------------------
/assets/dist/controller.d.ts:
--------------------------------------------------------------------------------
 1 | import { type ActionEvent, Controller } from '@hotwired/stimulus';
 2 | import { type Component } from '@symfony/ux-live-component';
 3 | import './styles/default.scss';
 4 | export default class extends Controller<HTMLElement> {
 5 |     component: Component;
 6 |     initialize(): Promise<void>;
 7 |     connect(): void;
 8 |     private handleHistoryUpdate;
 9 |     updateFacetRange(event: SubmitEvent & ActionEvent): Promise<void>;
10 |     private getRangeValues;
11 |     updateUrl(url: string): void;
12 |     disconnect(): void;
13 | }
14 | 


--------------------------------------------------------------------------------
/assets/dist/controller.js:
--------------------------------------------------------------------------------
 1 | import { Controller } from '@hotwired/stimulus';
 2 | import { getComponent } from '@symfony/ux-live-component';
 3 | 
 4 | class controller extends Controller {
 5 |     async initialize() {
 6 |         this.component = await getComponent(this.element);
 7 |     }
 8 |     connect() {
 9 |         window.addEventListener('history:update', this.handleHistoryUpdate);
10 |     }
11 |     handleHistoryUpdate = (event) => {
12 |         const customEvent = event;
13 |         this.updateUrl(customEvent.detail.url);
14 |     };
15 |     async updateFacetRange(event) {
16 |         const { property, rangeMin, rangeMax } = event.params;
17 |         const form = event.currentTarget;
18 |         const { min, max } = this.getRangeValues(form, property, parseFloat(rangeMin), parseFloat(rangeMax));
19 |         await this.component.action('updateFacetRange', { property, min, max });
20 |     }
21 |     getRangeValues(form, property, rangeMin, rangeMax) {
22 |         const data = new FormData(form);
23 |         const getValue = (suffix) => {
24 |             const value = data.get(`${property}-${suffix}`);
25 |             return value?.length ? Number(value) : null;
26 |         };
27 |         const min = getValue('min');
28 |         const max = getValue('max');
29 |         return {
30 |             min: typeof min === 'number' ? (min > rangeMin ? min : null) : null,
31 |             max: typeof max === 'number' ? (max < rangeMax ? max : null) : null,
32 |         };
33 |     }
34 |     updateUrl(url) {
35 |         history.replaceState(history.state, '', url);
36 |     }
37 |     disconnect() {
38 |         window.removeEventListener('history:update', this.handleHistoryUpdate);
39 |     }
40 | }
41 | 
42 | export { controller as default };
43 | 


--------------------------------------------------------------------------------
/assets/dist/controllers/range-slider_controller.d.ts:
--------------------------------------------------------------------------------
 1 | import { Controller } from '@hotwired/stimulus';
 2 | export default class extends Controller<HTMLElement> {
 3 |     static values: {
 4 |         precision: {
 5 |             type: NumberConstructor;
 6 |             default: number;
 7 |         };
 8 |         leading: {
 9 |             type: StringConstructor;
10 |             default: string;
11 |         };
12 |         trailing: {
13 |             type: StringConstructor;
14 |             default: string;
15 |         };
16 |         isReady: {
17 |             type: BooleanConstructor;
18 |             default: boolean;
19 |         };
20 |     };
21 |     precisionValue: number;
22 |     leadingValue: string;
23 |     trailingValue: string;
24 |     isReadyValue: boolean;
25 |     static targets: string[];
26 |     formTarget: HTMLFormElement;
27 |     minInputTarget: HTMLInputElement;
28 |     maxInputTarget: HTMLInputElement;
29 |     hasMinValueTarget: boolean;
30 |     minValueTarget: HTMLElement;
31 |     hasMaxValueTarget: boolean;
32 |     maxValueTarget: HTMLElement;
33 |     formTargetConnected(): void;
34 |     updateFloor: () => void;
35 |     updateCeil: () => void;
36 |     update(method?: 'floor' | 'ceil'): void;
37 |     submit(): void;
38 | }
39 | 


--------------------------------------------------------------------------------
/assets/dist/controllers/range-slider_controller.js:
--------------------------------------------------------------------------------
 1 | import { Controller } from '@hotwired/stimulus';
 2 | 
 3 | class default_1 extends Controller {
 4 |     static values = {
 5 |         precision: {
 6 |             type: Number,
 7 |             default: 3,
 8 |         },
 9 |         leading: {
10 |             type: String,
11 |             default: '',
12 |         },
13 |         trailing: {
14 |             type: String,
15 |             default: '',
16 |         },
17 |         isReady: {
18 |             type: Boolean,
19 |             default: false,
20 |         },
21 |     };
22 |     static targets = ['form', 'minInput', 'maxInput', 'minValue', 'maxValue'];
23 |     formTargetConnected() {
24 |         this.update();
25 |         this.isReadyValue = true;
26 |     }
27 |     updateFloor = () => this.update('floor');
28 |     updateCeil = () => this.update('ceil');
29 |     update(method = 'ceil') {
30 |         const min = parseFloat(this.minInputTarget.min);
31 |         const max = parseFloat(this.maxInputTarget.max);
32 |         const step = parseFloat(this.minInputTarget.step);
33 |         const minValue = parseFloat(this.minInputTarget.value);
34 |         const maxValue = parseFloat(this.maxInputTarget.value);
35 |         const midValue = (maxValue - minValue) / 2;
36 |         const mid = minValue + Math[method](midValue / step) * step;
37 |         const range = max - min;
38 |         const thumbWidthVariable = getComputedStyle(this.minInputTarget).getPropertyValue('--ux-search-range-slider-thumb-width');
39 |         const thumbWidth = parseFloat(thumbWidthVariable);
40 |         const thumbWidthUnit = thumbWidthVariable.replace(/^[\d.]+/, '');
41 |         const leftWidth = ((mid - min) / range) * 100;
42 |         const rightWidth = ((max - mid) / range) * 100;
43 |         this.minInputTarget.style.flexBasis = `calc(${leftWidth}% + ${thumbWidthVariable})`;
44 |         this.maxInputTarget.style.flexBasis = `calc(${rightWidth}% + ${thumbWidthVariable})`;
45 |         this.minInputTarget.max = mid.toFixed(this.precisionValue);
46 |         this.maxInputTarget.min = mid.toFixed(this.precisionValue);
47 |         const minFill = (minValue - min) / (mid - min) || 0;
48 |         const maxFill = (maxValue - mid) / (max - mid) || 0;
49 |         const minFillThumb = ((0.5 - minFill) * thumbWidth).toFixed(this.precisionValue);
50 |         const maxFillThumb = ((0.5 - maxFill) * thumbWidth).toFixed(this.precisionValue);
51 |         this.element.style.setProperty('--ux-search-range-slider-min-gradient-position', `calc(${(minFill * 100).toFixed(this.precisionValue)}% + ${minFillThumb}${thumbWidthUnit})`);
52 |         this.element.style.setProperty('--ux-search-range-slider-max-gradient-position', `calc(${(maxFill * 100).toFixed(this.precisionValue)}% + ${maxFillThumb}${thumbWidthUnit})`);
53 |         if (this.hasMinValueTarget) {
54 |             this.minValueTarget.innerHTML = `${this.leadingValue}${this.minInputTarget.value}${this.trailingValue}`;
55 |         }
56 |         if (this.hasMaxValueTarget) {
57 |             this.maxValueTarget.innerHTML = `${this.leadingValue}${this.maxInputTarget.value}${this.trailingValue}`;
58 |         }
59 |     }
60 |     submit() {
61 |         this.formTarget.requestSubmit();
62 |     }
63 | }
64 | 
65 | export { default_1 as default };
66 | 


--------------------------------------------------------------------------------
/assets/dist/controllers/refinement-list_controller.d.ts:
--------------------------------------------------------------------------------
 1 | import { Controller } from '@hotwired/stimulus';
 2 | export default class extends Controller {
 3 |     static values: {
 4 |         isShowingMore: {
 5 |             type: BooleanConstructor;
 6 |             default: boolean;
 7 |         };
 8 |         showMoreLabel: StringConstructor;
 9 |         showLessLabel: StringConstructor;
10 |     };
11 |     isShowingMoreValue: boolean;
12 |     showMoreLabelValue: string;
13 |     showLessLabelValue: string;
14 |     static targets: string[];
15 |     hasToggleTarget: boolean;
16 |     toggleTarget: HTMLFormElement;
17 |     mutationObserver: MutationObserver;
18 |     initialize(): void;
19 |     connect(): void;
20 |     private handleMutation;
21 |     isShowingMoreValueChanged(): void;
22 |     toggleShowMore(): void;
23 |     private updateToggleLabel;
24 |     disconnect(): void;
25 | }
26 | 


--------------------------------------------------------------------------------
/assets/dist/controllers/refinement-list_controller.js:
--------------------------------------------------------------------------------
 1 | import { Controller } from '@hotwired/stimulus';
 2 | 
 3 | class default_1 extends Controller {
 4 |     static values = {
 5 |         isShowingMore: {
 6 |             type: Boolean,
 7 |             default: false,
 8 |         },
 9 |         showMoreLabel: String,
10 |         showLessLabel: String,
11 |     };
12 |     static targets = ['toggle'];
13 |     mutationObserver;
14 |     initialize() {
15 |         this.mutationObserver = new MutationObserver(this.handleMutation);
16 |     }
17 |     connect() {
18 |         this.mutationObserver.observe(this.element, {
19 |             childList: true,
20 |         });
21 |     }
22 |     handleMutation = () => {
23 |         this.updateToggleLabel();
24 |     };
25 |     isShowingMoreValueChanged() {
26 |         this.updateToggleLabel();
27 |     }
28 |     toggleShowMore() {
29 |         this.isShowingMoreValue = !this.isShowingMoreValue;
30 |     }
31 |     updateToggleLabel() {
32 |         if (!this.hasToggleTarget)
33 |             return;
34 |         this.toggleTarget.innerHTML = this.isShowingMoreValue ? this.showLessLabelValue : this.showMoreLabelValue;
35 |     }
36 |     disconnect() {
37 |         this.mutationObserver.disconnect();
38 |     }
39 | }
40 | 
41 | export { default_1 as default };
42 | 


--------------------------------------------------------------------------------
/assets/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "@mezcalito/ux-search",
 3 |   "description": "Search interface for Symfony application",
 4 |   "main": "dist/controller.js",
 5 |   "types": "dist/controller.d.ts",
 6 |   "version": "1.0.0",
 7 |   "license": "MIT",
 8 |   "symfony": {
 9 |     "controllers": {
10 |       "ux-search": {
11 |         "main": "dist/controller.js",
12 |         "name": "ux-search",
13 |         "webpackMode": "eager",
14 |         "fetch": "eager",
15 |         "enabled": true,
16 |         "autoimport": {
17 |           "@mezcalito/ux-search/dist/default.min.css": true
18 |         }
19 |       },
20 |       "ux-search--refinement-list": {
21 |         "main": "dist/controllers/refinement-list_controller.js",
22 |         "name": "ux-search--refinement-list",
23 |         "webpackMode": "eager",
24 |         "fetch": "eager",
25 |         "enabled": true
26 |       },
27 |       "ux-search-range-slider": {
28 |         "main": "dist/controllers/range-slider_controller.js",
29 |         "name": "ux-search-range-slider",
30 |         "webpackMode": "eager",
31 |         "fetch": "eager",
32 |         "enabled": true
33 |       }
34 |     },
35 |     "importmap": {
36 |       "@hotwired/stimulus": "^3.2.0",
37 |       "@mezcalito/ux-search": "path:%PACKAGE%/dist/controller.js"
38 |     }
39 |   },
40 |   "peerDependencies": {
41 |     "@hotwired/stimulus": "^3.2.0"
42 |   },
43 |   "devDependencies": {
44 |     "@hotwired/stimulus": "^3.2.0"
45 |   }
46 | }
47 | 


--------------------------------------------------------------------------------
/compose.yaml:
--------------------------------------------------------------------------------
 1 | services:
 2 |   php:
 3 |     build: $PWD/.infrastructure/frankenphp
 4 |     restart: on-failure
 5 |     environment:
 6 |       SERVER_NAME: ${SERVER_NAME:-localhost, caddy:80}
 7 |     volumes:
 8 |       - ./:/srv/app
 9 |     ports:
10 |       # HTTP
11 |       - target: 80
12 |         published: ${HTTP_PORT:-80}
13 |         protocol: tcp
14 |       # HTTPS
15 |       - target: 443
16 |         published: ${HTTPS_PORT:-443}
17 |         protocol: tcp
18 |       # HTTP/3
19 |       - target: 443
20 |         published: ${HTTP3_PORT:-443}
21 |         protocol: udp
22 | 
23 |   node:
24 |     build: $PWD/.infrastructure/node
25 |     restart: on-failure
26 |     volumes:
27 |       - ./:/srv/app:rw,cached
28 | 
29 |   meilisearch:
30 |     image: getmeili/meilisearch:latest
31 |     container_name: uxsearch_meilisearch
32 |     restart: on-failure
33 |     volumes:
34 |       - search_data:/meili_data
35 |     environment:
36 |       - MEILI_MASTER_KEY=secret
37 |       - MEILI_NO_ANALYTICS=true
38 |     ports:
39 |       - "7700:7700"
40 | 
41 | volumes:
42 |   search_data: ~
43 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "mezcalito/ux-search",
 3 |   "type": "symfony-bundle",
 4 |   "description": "Effortless search and faceted search with Symfony UX and Mezcalito UX Search",
 5 |   "homepage": "https://github.com/Mezcalito/ux-search",
 6 |   "keywords": [
 7 |     "symfony-ux", "listing", "search", "meilisearch", "faceted search"
 8 |   ],
 9 |   "license": "MIT",
10 |   "require": {
11 |     "php": ">=8.3",
12 |     "nyholm/psr7": "^1.0",
13 |     "phpdocumentor/reflection-docblock": "^5.4",
14 |     "symfony/asset": "^6.4|^7.0",
15 |     "symfony/config": "^6.4|^7.0",
16 |     "symfony/dependency-injection": "^6.4|^7.0",
17 |     "symfony/http-client": "^6.4|^7.0",
18 |     "symfony/options-resolver": "^6.4|^7.0",
19 |     "symfony/serializer": "^6.4|^7.0",
20 |     "symfony/ux-live-component": "^2.20",
21 |     "symfony/ux-twig-component": "^2.20",
22 |     "twig/twig": "^3.8"
23 |   },
24 |   "require-dev": {
25 |     "algolia/search-bundle": "^6.0|^7.0",
26 |     "doctrine/doctrine-bundle": "^2.13",
27 |     "doctrine/orm": "^3.3",
28 |     "friendsofphp/php-cs-fixer": "^3.64",
29 |     "meilisearch/meilisearch-php": "^1.10",
30 |     "phpstan/phpstan": "^1.12",
31 |     "phpstan/phpstan-symfony": "^1.4",
32 |     "phpunit/phpunit": "^11.4",
33 |     "rector/rector": "^1.2",
34 |     "symfony/asset-mapper": "^6.4|^7.0",
35 |     "symfony/framework-bundle": "^6.4|^7.0",
36 |     "symfony/maker-bundle": "^1.62",
37 |     "symfony/runtime": "^6.4|^7.0",
38 |     "symfony/translation": "^7.2",
39 |     "symfony/web-profiler-bundle": "^6.4|^7.0"
40 |   },
41 |   "suggest": {
42 |     "algolia/search-bundle": "Needed to use Algolia adapter",
43 |     "doctrine/doctrine-bundle": "Needed to use Orm adapter",
44 |     "meilisearch/meilisearch-php": "Needed to use Meilisearch adapter"
45 |   },
46 |   "config": {
47 |     "sort-packages": true,
48 |     "allow-plugins": {
49 |       "symfony/runtime": true,
50 |       "php-http/discovery": true
51 |     }
52 |   },
53 |   "autoload": {
54 |     "psr-4": {
55 |       "Mezcalito\\UxSearchBundle\\": "src/"
56 |     }
57 |   },
58 |   "autoload-dev": {
59 |     "psr-4": {
60 |       "Mezcalito\\UxSearchBundle\\Tests\\": "tests",
61 |       "Mezcalito\\UxSearchBundle\\Tests\\TestApplication\\": "tests/TestApplication/src"
62 |     }
63 |   }
64 | }
65 | 


--------------------------------------------------------------------------------
/config/services.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /*
  4 |  * This file is part of the UxSearch project.
  5 |  *
  6 |  * (c) Mezcalito (https://www.mezcalito.fr)
  7 |  *
  8 |  * For the full copyright and license information, please view the LICENSE
  9 |  * file that was distributed with this source code.
 10 |  */
 11 | 
 12 | declare(strict_types=1);
 13 | 
 14 | namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 15 | 
 16 | use Doctrine\Persistence\ManagerRegistry;
 17 | use Mezcalito\UxSearchBundle\Adapter\AdapterProvider;
 18 | use Mezcalito\UxSearchBundle\Adapter\Algolia\AlgoliaFactory;
 19 | use Mezcalito\UxSearchBundle\Adapter\Doctrine\DoctrineFactory;
 20 | use Mezcalito\UxSearchBundle\Adapter\Meilisearch\MeilisearchFactory;
 21 | use Mezcalito\UxSearchBundle\Adapter\Meilisearch\QueryBuilder;
 22 | use Mezcalito\UxSearchBundle\Context\ContextProvider;
 23 | use Mezcalito\UxSearchBundle\EventSubscriber\ContextSubscriber;
 24 | use Mezcalito\UxSearchBundle\Maker\MakeSearch;
 25 | use Mezcalito\UxSearchBundle\Search\Searcher;
 26 | use Mezcalito\UxSearchBundle\Search\SearchProvider;
 27 | use Mezcalito\UxSearchBundle\Search\Url\DefaultUrlFormater;
 28 | use Mezcalito\UxSearchBundle\Search\Url\UrlFormaterProvider;
 29 | use Mezcalito\UxSearchBundle\Twig\Components\ClearRefinements;
 30 | use Mezcalito\UxSearchBundle\Twig\Components\CurrentRefinements;
 31 | use Mezcalito\UxSearchBundle\Twig\Components\Facet;
 32 | use Mezcalito\UxSearchBundle\Twig\Components\Hits;
 33 | use Mezcalito\UxSearchBundle\Twig\Components\HitsPerPage;
 34 | use Mezcalito\UxSearchBundle\Twig\Components\Layout;
 35 | use Mezcalito\UxSearchBundle\Twig\Components\Pagination;
 36 | use Mezcalito\UxSearchBundle\Twig\Components\SearchInput;
 37 | use Mezcalito\UxSearchBundle\Twig\Components\SortBy;
 38 | use Mezcalito\UxSearchBundle\Twig\Components\TotalHits;
 39 | use Mezcalito\UxSearchBundle\Twig\UxSearchExtension;
 40 | use Symfony\Component\HttpFoundation\RequestStack;
 41 | use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
 42 | use Symfony\UX\LiveComponent\LiveResponder;
 43 | 
 44 | return static function (ContainerConfigurator $container) {
 45 |     $container->services()
 46 |         ->set(DoctrineFactory::class)
 47 |             ->arg('$managerRegistry', service(ManagerRegistry::class)->nullOnInvalid())
 48 |             ->tag('mezcalito_ux_search.adapter_factory')
 49 |         ->set(MeilisearchFactory::class)
 50 |             ->arg('$httpClient', service('psr18.http_client'))
 51 |             ->tag('mezcalito_ux_search.adapter_factory')
 52 |         ->set(AlgoliaFactory::class)->tag('mezcalito_ux_search.adapter_factory')
 53 |         ->set(Searcher::class)
 54 |             ->arg('$adapterProvider', service(AdapterProvider::class))
 55 |             ->arg('$contextProvider', service(ContextProvider::class))
 56 |         ->set(QueryBuilder::class)
 57 |         ->set(ContextProvider::class)
 58 |         ->set(AdapterProvider::class)
 59 |             ->arg('$defaultAdapterName', param('mezcalito_ux_search.default_adapter'))
 60 |             ->arg('$adapterConfiguration', param('mezcalito_ux_search.adapters'))
 61 |         ->set(SearchProvider::class)
 62 |         ->set(UrlFormaterProvider::class)
 63 |         ->set(Layout::class)
 64 |             ->arg('$searchConfigurationProvider', service(SearchProvider::class))
 65 |             ->arg('$searcher', service(Searcher::class))
 66 |             ->arg('$requestStack', service(RequestStack::class))
 67 |             ->arg('$urlFormaterProvider', service(UrlFormaterProvider::class))
 68 |             ->call('setLiveResponder', [service(LiveResponder::class)])
 69 |             ->tag('twig.component', [
 70 |                 'key' => 'Mezcalito:UxSearch:Layout',
 71 |                 'expose_public_props' => true,
 72 |                 'attributes_var' => 'attributes',
 73 |                 'live' => true,
 74 |                 'csrf' => true,
 75 |                 'route' => 'ux_live_component',
 76 |                 'method' => 'post',
 77 |                 'url_reference_type' => true,
 78 |             ])
 79 |             ->tag('controller.service_arguments')
 80 |             ->public()
 81 |         ->set(Hits::class)
 82 |             ->arg('$contextProvider', service(ContextProvider::class))
 83 |             ->tag('twig.component', ['key' => 'Mezcalito:UxSearch:Hits'])
 84 |         ->set(TotalHits::class)
 85 |             ->arg('$contextProvider', service(ContextProvider::class))
 86 |             ->tag('twig.component', ['key' => 'Mezcalito:UxSearch:TotalHits'])
 87 |         ->set(SortBy::class)
 88 |             ->arg('$contextProvider', service(ContextProvider::class))
 89 |             ->tag('twig.component', ['key' => 'Mezcalito:UxSearch:SortBy'])
 90 |         ->set(HitsPerPage::class)
 91 |             ->arg('$contextProvider', service(ContextProvider::class))
 92 |             ->tag('twig.component', ['key' => 'Mezcalito:UxSearch:HitsPerPage'])
 93 |         ->set(Pagination::class)
 94 |             ->arg('$contextProvider', service(ContextProvider::class))
 95 |             ->tag('twig.component', [
 96 |                 'key' => 'Mezcalito:UxSearch:Pagination',
 97 |                 'expose_public_props' => true,
 98 |             ])
 99 |         ->set(Facet::class)
100 |             ->arg('$contextProvider', service(ContextProvider::class))
101 |             ->tag('twig.component', [
102 |                 'key' => 'Mezcalito:UxSearch:Facet',
103 |                 'expose_public_props' => true,
104 |             ])
105 |         ->set(Facet\RefinementList::class)
106 |             ->arg('$contextProvider', service(ContextProvider::class))
107 |             ->tag('twig.component', ['key' => 'Mezcalito:UxSearch:Facet:RefinementList'])
108 |         ->set(Facet\RangeInput::class)
109 |             ->arg('$contextProvider', service(ContextProvider::class))
110 |             ->tag('twig.component', ['key' => 'Mezcalito:UxSearch:Facet:RangeInput'])
111 |         ->set(Facet\RangeSlider::class)
112 |             ->arg('$contextProvider', service(ContextProvider::class))
113 |             ->tag('twig.component', ['key' => 'Mezcalito:UxSearch:Facet:RangeSlider'])
114 |         ->set(CurrentRefinements::class)
115 |             ->arg('$contextProvider', service(ContextProvider::class))
116 |             ->tag('twig.component', ['key' => 'Mezcalito:UxSearch:CurrentRefinements'])
117 |         ->set(ClearRefinements::class)
118 |             ->arg('$contextProvider', service(ContextProvider::class))
119 |             ->tag('twig.component', ['key' => 'Mezcalito:UxSearch:ClearRefinements'])
120 |         ->set(SearchInput::class)
121 |             ->tag('twig.component', ['key' => 'Mezcalito:UxSearch:SearchInput'])
122 |         ->set(ContextSubscriber::class)
123 |             ->arg('$contextProvider', service(ContextProvider::class))
124 |         ->set(UxSearchExtension::class)->tag('twig.extension')
125 |         ->set(DefaultUrlFormater::class)
126 |             ->arg('$urlGenerator', service(UrlGeneratorInterface::class))
127 |             ->tag('mezcalito_ux_search.url_formater')
128 |         ->set('maker.maker.make_search', MakeSearch::class)
129 |             ->tag('maker.command')
130 |     ;
131 | };
132 | 


--------------------------------------------------------------------------------
/docs/components/ClearRefinements.md:
--------------------------------------------------------------------------------
 1 | # ClearRefinements
 2 | 
 3 | The `ClearRefinements` component displays a button that lets users clean every refinement applied to the search.
 4 | 
 5 | ## Block available
 6 | 
 7 | | name    | Description |
 8 | |---------|-------------|
 9 | | content | -           |
10 | 
11 | 
12 | ## Default layout
13 | 
14 | ```twig
15 | {% block content %}
16 |     {%- if activeFilters is defined and activeFilters|length > 0 %}
17 |         <button 
18 |             {{ attributes.defaults({
19 |                 'class': 'ux-search-clear-refinements ux-search-button',
20 |                 'data-action': 'live#action:prevent',
21 |                 'data-live-action-param': 'clearRefinements'
22 |             }) }}
23 |         >
24 |             {{ 'reset_filters'|trans(domain='mezcalito_ux_search') }}
25 |         </button>
26 |     {% endif %}
27 | {% endblock -%}
28 | ```
29 | 
30 | ## Default HTML output
31 | ```html
32 | <button class="ux-search-clear-refinements ux-search-button" data-action="live#action:prevent" data-live-action-param="clearRefinements">
33 |     Reset filters
34 | </button>
35 | ```
36 | 


--------------------------------------------------------------------------------
/docs/components/Facet/RangeInput.md:
--------------------------------------------------------------------------------
 1 | # RangeInput
 2 | 
 3 | The `RangeInput` component displays allows a user to select a numeric range using a minimum and maximum input.
 4 | 
 5 | ## Block available
 6 | 
 7 | | name   | Description |
 8 | |--------|-------------|
 9 | | label  | -           |
10 | | form   | -           |
11 | | submit | -           |
12 | 
13 | ## Default layout
14 | 
15 | ```twig
16 | <fieldset {{ attributes.defaults({
17 |     'class': 'ux-search-facet ux-search-range-input',
18 |     'data-skip-morph': true
19 | }) }}>
20 |     <legend class="ux-search-facet__title">{% block label %}{{ label }}{% endblock %}</legend>
21 |     {% block form %}
22 |         <form
23 |             class="ux-search-range-input__form"
24 |             data-action="submit->ux-search#updateFacetRange:prevent"
25 |             data-ux-search-property-param="{{ property }}"
26 |             data-ux-search-range-min-param="{{ facetStat.min }}"
27 |             data-ux-search-range-max-param="{{ facetStat.max }}"
28 |         >
29 |             <div class="ux-search-range-input__box">
30 |                 <label class="ux-search-range-input__label ux-search-sr-only" for="{{ property }}-min">{{ 'range.min'|trans(domain='mezcalito_ux_search') }}</label>
31 |                 <input
32 |                     class="ux-search-range-input__input ux-search-input"
33 |                     type="number"
34 |                     min="{{ facetStat.min }}"
35 |                     max="{{ facetStat.max }}"
36 |                     id="{{ property }}-min"
37 |                     name="{{ property }}-min"
38 |                     placeholder="{{ facetStat.min }}"
39 |                     value="{{ facetStat.userMin }}"
40 |                     step="any"
41 |                 >
42 |             </div>
43 |             <div class="ux-search-range-input__box">
44 |                 <label class="ux-search-range-input__label ux-search-sr-only" for="{{ property }}-max">{{ 'range.max'|trans(domain='mezcalito_ux_search') }}</label>
45 |                 <input
46 |                     class="ux-search-range-input__input ux-search-input"
47 |                     type="number"
48 |                     min="{{ facetStat.min }}"
49 |                     max="{{ facetStat.max }}"
50 |                     id="{{ property }}-max"
51 |                     name="{{ property }}-max"
52 |                     placeholder="{{ facetStat.max }}"
53 |                     value="{{ facetStat.userMax }}"
54 |                     step="any"
55 |                 >
56 |             </div>
57 |             {% block submit %}
58 |                 <button class="ux-search-range-input__submit ux-search-button" type="submit">
59 |                     {{ 'go'|trans(domain='mezcalito_ux_search') }}
60 |                 </button>
61 |             {% endblock %}
62 |         </form>
63 |     {% endblock %}
64 | </fieldset>
65 | ```
66 | 
67 | ## Default HTML output
68 | ```html
69 | <fieldset class="ux-search-facet ux-search-range-input" data-skip-morph="">
70 |     <legend class="ux-search-facet__title">Price</legend>
71 |     <form class="ux-search-range-input__form" data-action="submit->ux-search#updateFacetRange:prevent" data-ux-search-property-param="o.price" data-ux-search-range-min-param="1.99" data-ux-search-range-max-param="4999.98">
72 |         <div class="ux-search-range-input__box">
73 |             <label class="ux-search-range-input__label ux-search-sr-only" for="o.price-min">Min</label>
74 |             <input class="ux-search-range-input__input ux-search-input" type="number" min="1.99" max="4999.98" id="o.price-min" name="o.price-min" placeholder="1.99" value="" step="any">
75 |         </div>
76 |         <div class="ux-search-range-input__box">
77 |             <label class="ux-search-range-input__label ux-search-sr-only" for="o.price-max">Max</label>
78 |             <input class="ux-search-range-input__input ux-search-input" type="number" min="1.99" max="4999.98" id="o.price-max" name="o.price-max" placeholder="4999.98" value="" step="any">
79 |         </div>
80 |         <button class="ux-search-range-input__submit ux-search-button" type="submit">
81 |             Go
82 |         </button>
83 |     </form>
84 | </fieldset>
85 | ```
86 | 


--------------------------------------------------------------------------------
/docs/components/Facet/RangeSlider.md:
--------------------------------------------------------------------------------
  1 | # RangeSlider
  2 | 
  3 | The `RangeSlider` component provides a user-friendly way to filter the results, based on a single numeric range.
  4 | 
  5 | ## Default layout
  6 | 
  7 | ```twig
  8 | <fieldset {{ attributes.defaults({
  9 |     'class': 'ux-search-facet ux-search-range-slider',
 10 |     'data-controller': 'ux-search-range-slider',
 11 |     'data-ux-search-range-slider-leading-value': this.leading|default(''),
 12 |     'data-ux-search-range-slider-trailing-value': this.trailing|default(''),
 13 |     'data-skip-morph': true
 14 | }) }}>
 15 |     <legend class="ux-search-facet__title">{{ label }}</legend>
 16 |     <form
 17 |         class="ux-search-range-slider__form"
 18 |         data-ux-search-range-slider-target="form"
 19 |         data-action="submit->ux-search#updateFacetRange:prevent"
 20 |         data-ux-search-property-param="{{ property }}"
 21 |         data-ux-search-range-min-param="{{ facetStat.min }}"
 22 |         data-ux-search-range-max-param="{{ facetStat.max }}"
 23 |     >
 24 |         <input
 25 |             id="{{ property }}-min"
 26 |             name="{{ property }}-min"
 27 |             aria-label="Minimum {{ property }}"
 28 |             aria-describedby="{{ property }}-min-value"
 29 |             class="ux-search-range-slider__input ux-search-range-slider__input--min"
 30 |             type="range"
 31 |             min="{{ facetStat.min }}"
 32 |             max="{{ facetStat.max }}"
 33 |             placeholder="{{ facetStat.min }}"
 34 |             value="{{ (facetStat.userMin is not null) ? facetStat.userMin : facetStat.min }}"
 35 |             step="{{ this.step }}"
 36 |             data-ux-search-range-slider-target="minInput"
 37 |             data-action="
 38 |                 input->ux-search-range-slider#updateCeil
 39 |                 focus->ux-search-range-slider#updateCeil
 40 |                 mousedown->ux-search-range-slider#updateCeil
 41 |                 touchstart->ux-search-range-slider#updateCeil
 42 |                 change->ux-search-range-slider#submit
 43 |             "
 44 |         />
 45 |         <input
 46 |             id="{{ property }}-max"
 47 |             name="{{ property }}-max"
 48 |             aria-label="Maximum {{ property }}"
 49 |             aria-describedby="{{ property }}-max-value"
 50 |             class="ux-search-range-slider__input ux-search-range-slider__input--max"
 51 |             type="range"
 52 |             min="{{ facetStat.min }}"
 53 |             max="{{ facetStat.max }}"
 54 |             placeholder="{{ facetStat.max }}"
 55 |             value="{{ (facetStat.userMax is not null) ? facetStat.userMax : facetStat.max }}"
 56 |             step="{{ this.step }}"
 57 |             data-ux-search-range-slider-target="maxInput"
 58 |             data-action="
 59 |                 input->ux-search-range-slider#updateFloor
 60 |                 focus->ux-search-range-slider#updateFloor
 61 |                 mousedown->ux-search-range-slider#updateFloor
 62 |                 touchstart->ux-search-range-slider#updateFloor
 63 |                 change->ux-search-range-slider#submit
 64 |             "
 65 |         />
 66 |     </form>
 67 |     <div class="ux-search-range-slider__values">
 68 |         <span
 69 |             id="{{ property }}-min-value"
 70 |             class="ux-search-range-slider__value ux-search-range-slider__value--min"
 71 |             data-ux-search-range-slider-target="minValue"
 72 |         >
 73 |             {{ this.leading ~ facetStat.userMin|default(facetStat.min) ~ this.trailing }}
 74 |         </span>
 75 |         <span
 76 |             id="{{ property }}-max-value"
 77 |             class="ux-search-range-slider__value ux-search-range-slider__value--max"
 78 |             data-ux-search-range-slider-target="maxValue"
 79 |         >
 80 |             {{ this.leading ~ facetStat.userMax|default(facetStat.max) ~ this.trailing }}
 81 |         </span>
 82 |     </div>
 83 | </fieldset>
 84 | ```
 85 | 
 86 | ## Default HTML output
 87 | ```html
 88 | <fieldset class="ux-search-facet ux-search-range-slider" data-controller="ux-search-range-slider" data-ux-search-range-slider-leading-value="" data-ux-search-range-slider-trailing-value="" data-skip-morph="" style="--ux-search-range-slider-min-gradient-position: calc(0% + 0.625rem); --ux-search-range-slider-max-gradient-position: calc(99% + -0.625rem);" data-ux-search-range-slider-is-ready-value="true">
 89 |     <legend class="ux-search-facet__title">Price</legend>
 90 |     <form class="ux-search-range-slider__form" data-ux-search-range-slider-target="form" data-action="submit->ux-search#updateFacetRange:prevent" data-ux-search-property-param="price" data-ux-search-range-min-param="1.99" data-ux-search-range-max-param="4999.98">
 91 |         <input id="price-min" name="price-min" aria-label="Minimum price" aria-describedby="price-min-value" class="ux-search-range-slider__input ux-search-range-slider__input--min" type="range" min="1.99" max="2500.990" placeholder="1.99" value="1.99" step="1" data-ux-search-range-slider-target="minInput" data-action="
 92 |             input->ux-search-range-slider#updateCeil
 93 |             focus->ux-search-range-slider#updateCeil
 94 |             mousedown->ux-search-range-slider#updateCeil
 95 |             touchstart->ux-search-range-slider#updateCeil
 96 |             change->ux-search-range-slider#submit" 
 97 |         style="flex-basis: calc(50% + 1.25rem);">
 98 |         <input id="price-max" name="price-max" aria-label="Maximum price" aria-describedby="price-max-value" class="ux-search-range-slider__input ux-search-range-slider__input--max" type="range" min="2500.990" max="4999.98" placeholder="4999.98" value="4999.98" step="1" data-ux-search-range-slider-target="maxInput" data-action="
 99 |             input->ux-search-range-slider#updateFloor
100 |             focus->ux-search-range-slider#updateFloor
101 |             mousedown->ux-search-range-slider#updateFloor
102 |             touchstart->ux-search-range-slider#updateFloor
103 |             change->ux-search-range-slider#submit" 
104 |         style="flex-basis: calc(49% + 1.25rem);">
105 |     </form>
106 |     <div class="ux-search-range-slider__values">
107 |         <span id="price-min-value" class="ux-search-range-slider__value ux-search-range-slider__value--min" data-ux-search-range-slider-target="minValue">1.99</span>
108 |         <span id="price-max-value" class="ux-search-range-slider__value ux-search-range-slider__value--max" data-ux-search-range-slider-target="maxValue">4998.99</span>
109 |     </div>
110 | </fieldset>
111 | ```
112 | 


--------------------------------------------------------------------------------
/docs/components/Facet/RefinementList.md:
--------------------------------------------------------------------------------
 1 | # RefinementList
 2 | 
 3 | The `RefinementList` component allow users can filter the dataset based on facets.
 4 | 
 5 | The widget only displays the most relevant facet values for the current search context.
 6 | The sort option only affects the facets that are returned by the engine, not which facets are returned.
 7 | 
 8 | | name      | Description |
 9 | |-----------|-------------|
10 | | label     | -           |
11 | | list      | -           |
12 | | show_more | -           |
13 | 
14 | ## Default layout
15 | 
16 | ```twig
17 | <fieldset {{ attributes.defaults({ 
18 |     class: 'ux-search-facet ux-search-refinement-list',
19 |     'data-skip-morph': true,
20 |     'data-controller': 'ux-search--refinement-list',
21 |     'data-ux-search--refinement-list-limit-value': this.limit,
22 |     'data-ux-search--refinement-list-show-more-label-value': 'show_more'|trans(domain='mezcalito_ux_search'),
23 |     'data-ux-search--refinement-list-show-less-label-value': 'show_less'|trans(domain='mezcalito_ux_search')
24 | }) }}>
25 |     <legend class="ux-search-facet__title ux-search-refinement-list__title">{% block label %}{{ label }}{% endblock %}</legend>
26 |     
27 |     {% block list %}
28 |         <ul class="ux-search-refinement-list__list">
29 |             {%- for key,value in distribution.values %}
30 |                 <li
31 |                     class="ux-search-refinement-list__item{{ loop.index > this.limit ? ' ux-search-refinement-list__item--exceed-limit' }}"
32 |                 >
33 |                     <input
34 |                         class="ux-search-refinement-list__input"
35 |                         value="{{ key }}"
36 |                         type="checkbox"
37 |                         id="{{ property }}-{{ key }}"
38 |                         {%- if distribution.isChecked(key) %} checked {% endif -%}
39 |                         data-action="live#action"
40 |                         data-live-action-param="toggleFacetTerm"
41 |                         data-live-property-param="{{ property }}"
42 |                         data-live-value-param="{{ key }}"
43 |                     >
44 |                     <label class="ux-search-refinement-list__label" for="{{ property }}-{{ key }}">
45 |                         <span class="ux-search-refinement-list__label-text">{{ key }}</span>
46 |                         <span class="ux-search-refinement-list__count">{{ value }}</span>
47 |                     </label>
48 |                 </li>
49 |             {% endfor -%}
50 |         </ul>
51 |     {% endblock %}  
52 | 
53 |     {% if distribution.values|length > this.limit %}
54 |         {% block show_more %}
55 |             <button
56 |                 class="ux-search-refinement-list__show-more"
57 |                 type="button"
58 |                 data-ux-search--refinement-list-target="toggle"
59 |                 data-action="ux-search--refinement-list#toggleShowMore"
60 |             >
61 |                 {{ 'show_more'|trans(domain='mezcalito_ux_search') }}
62 |             </button>
63 |         {% endblock %}
64 |     {% endif %}
65 | </fieldset>
66 | 
67 | ```
68 | 
69 | ## Default HTML output
70 | ```html
71 | <fieldset class="ux-search-facet ux-search-refinement-list" data-skip-morph="" data-controller="ux-search--refinement-list" data-ux-search--refinement-list-limit-value="2" data-ux-search--refinement-list-show-more-label-value="Show more" data-ux-search--refinement-list-show-less-label-value="Show less">
72 |     <legend class="ux-search-facet__title ux-search-refinement-list__title">Type</legend>
73 |     <ul class="ux-search-refinement-list__list">                
74 |         <li class="ux-search-refinement-list__item">
75 |             <input class="ux-search-refinement-list__input" value="Trend cases" type="checkbox" id="type-Trend cases" data-action="live#action" data-live-action-param="toggleFacetTerm" data-live-property-param="type" data-live-value-param="Trend cases">
76 |             <label class="ux-search-refinement-list__label" for="type-Trend cases">
77 |                 <span class="ux-search-refinement-list__label-text">Trend cases</span>
78 |                 <span class="ux-search-refinement-list__count">537</span>
79 |             </label>
80 |         </li>
81 |         <li class="ux-search-refinement-list__item">
82 |             <input class="ux-search-refinement-list__input" value="Ult protection cases" type="checkbox" id="type-Ult protection cases" data-action="live#action" data-live-action-param="toggleFacetTerm" data-live-property-param="type" data-live-value-param="Ult protection cases">
83 |             <label class="ux-search-refinement-list__label" for="type-Ult protection cases">
84 |                 <span class="ux-search-refinement-list__label-text">Ult protection cases</span>
85 |                 <span class="ux-search-refinement-list__count">289</span>
86 |             </label>
87 |         </li>
88 |         // ...
89 |     </ul>
90 |     <button class="ux-search-refinement-list__show-more" type="button" data-ux-search--refinement-list-target="toggle" data-action="ux-search--refinement-list#toggleShowMore">Show more</button>
91 | </fieldset>
92 | ```
93 | 


--------------------------------------------------------------------------------
/docs/components/Hits.md:
--------------------------------------------------------------------------------
 1 | # Hits
 2 | 
 3 | The `Hits` component displays a list of refinements applied to the search.
 4 | 
 5 | ## Block available
 6 | 
 7 | | name     | Description |
 8 | |----------|-------------|
 9 | | content  | -           |
10 | | hit      | -           |
11 | | noResult | -           |
12 | 
13 | ## Default layout
14 | 
15 | ```twig
16 | {% block content %}
17 |     <div {{ attributes.defaults({
18 |             class: 'ux-search-hits'
19 |     }) }}>
20 |         {% if results.hits|length > 0 %}
21 |             <div class="ux-search-hits__list">
22 |                 {% for hit in results.hits %}
23 |                     {% block hit %}
24 |                         <div class="ux-search-hits__item" style="max-width: 100%; overflow: auto;">
25 |                             <pre style="font-family: monospace">{{ hit.data|json_encode(constant('JSON_PRETTY_PRINT')) }}</pre>
26 |                         </div>
27 |                     {% endblock %}
28 |                 {% endfor %}
29 |             </div>
30 |         {% else %}
31 |             {% block noResult %}
32 |                 <div class="ux-search-hits__no-result">{{ 'no_result'|trans(domain='mezcalito_ux_search') }}</div>
33 |             {% endblock %}
34 |         {% endif %}
35 |     </div>
36 | {% endblock %}
37 | ```
38 | 
39 | ## Default HTML output
40 | ```html
41 | <div class="ux-search-hits">
42 |     <div class="ux-search-hits__list">
43 |         <div class="ux-search-hits__item" style="max-width: 100%; overflow: auto;">
44 |             <pre style="font-family: monospace">
45 |                 // ...
46 |             </pre>
47 |         </div>
48 |         <div class="ux-search-hits__item" style="max-width: 100%; overflow: auto;">
49 |             <pre style="font-family: monospace">
50 |                 // ...
51 |             </pre>
52 |         </div>
53 |         // ...
54 |     </div>
55 | </div>
56 | ```
57 | 


--------------------------------------------------------------------------------
/docs/components/HitsPerPage.md:
--------------------------------------------------------------------------------
 1 | # HitsPerPage
 2 | 
 3 | The `HitsPerPage` component displays a dropdown menu to let users change the number of displayed hits.
 4 | 
 5 | ## Block available
 6 | 
 7 | | name     | Description |
 8 | |----------|-------------|
 9 | | content  | -           |
10 | 
11 | ## Default layout
12 | 
13 | ```twig
14 | {% block content %}
15 |     <div {{ attributes.defaults({
16 |         'class': 'ux-search-hits-per-page ux-search-select',
17 |     }) }}>
18 |         <select data-model="query.activeHitsPerPage">
19 |             {% for option in availableHitsPerPage %}
20 |                 <option value="{{ option }}" {% if option == activeHitPerPage %}selected{% endif %}>{{ option }}</option>
21 |             {% endfor %}
22 |         </select>
23 |         <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-down"><path d="m6 9 6 6 6-6"/></svg>
24 |     </div>
25 | {% endblock %}
26 | ```
27 | 
28 | ## Default HTML output
29 | ```html
30 | <div class="ux-search-hits-per-page ux-search-select">
31 |     <select data-model="query.activeHitsPerPage">
32 |         <option value="3">3</option>
33 |         <option value="6">6</option>
34 |         <option value="12" selected="">12</option>
35 |     </select>
36 |     <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-down"><path d="m6 9 6 6 6-6"></path></svg>
37 | </div>
38 | ```
39 | 


--------------------------------------------------------------------------------
/docs/components/Layout.md:
--------------------------------------------------------------------------------
 1 | # Layout
 2 | 
 3 | The `Layout` is the root wrapper component for all components
 4 | 
 5 | ## Block available
 6 | 
 7 | | name       |
 8 | |------------|
 9 | | content    |
10 | | form       |
11 | | toolbar    |
12 | | facets     |
13 | | listing    |
14 | | stats      |
15 | | hits       |
16 | | pagination |
17 | 
18 | ## Default layout
19 | 
20 | ```twig
21 | <div {{ attributes.defaults({
22 |     'class': 'ux-search',
23 |     'data-controller': 'ux-search',
24 |     'data-loading': 'addClass(ux-search--is-loading)'
25 | }) }}>
26 |     {% block content %}
27 |         <div class="ux-search__inner">
28 |             <div class="ux-search__form">
29 |                 {% block form %}
30 |                     <twig:Mezcalito:UxSearch:SearchInput />
31 |                 {% endblock %}
32 |             </div>
33 |         
34 |             <div class="ux-search__toolbar">
35 |                 {% block toolbar %}
36 |                     <twig:Mezcalito:UxSearch:CurrentRefinements/>
37 |                     <twig:Mezcalito:UxSearch:ClearRefinements />
38 |                     <twig:Mezcalito:UxSearch:HitsPerPage/>
39 |                     <twig:Mezcalito:UxSearch:SortBy/>
40 |                 {% endblock %}
41 |             </div>
42 |         
43 |             <div class="ux-search__facets">
44 |                 {% block facets %}
45 |                     {% for facet in search.facets %}
46 |                         <twig:Mezcalito:UxSearch:Facet :property="facet.property" />
47 |                     {% endfor %}
48 |                 {% endblock %}
49 |             </div>
50 |         
51 |             <div class="ux-search__listing">
52 |                 {% block listing %}
53 |                     <div class="ux-search__stats">
54 |                         {% block stats %}
55 |                             <twig:Mezcalito:UxSearch:TotalHits/>
56 |                         {% endblock %}
57 |                     </div>
58 |             
59 |                     {% block hits %}
60 |                         <twig:Mezcalito:UxSearch:Hits />
61 |                     {% endblock %}
62 |             
63 |                     {% block pagination %}
64 |                         <twig:Mezcalito:UxSearch:Pagination />
65 |                     {% endblock %}
66 |                 {% endblock %}
67 |             </div>
68 |         </div>
69 |     {% endblock %}
70 | </div>
71 | ```
72 | 


--------------------------------------------------------------------------------
/docs/components/SearchInput.md:
--------------------------------------------------------------------------------
 1 | # SearchInput
 2 | 
 3 | The `SearchInput` component is used to let users perform a text-based query.
 4 | 
 5 | ## Block available
 6 | 
 7 | | name    | Description |
 8 | |---------|-------------|
 9 | | content | -           |
10 | 
11 | 
12 | ## Default layout
13 | 
14 | ```twig
15 | {% block content %}
16 |     <input {{ attributes.defaults({
17 |     'class': 'ux-search-search-input ux-search-input',
18 |     'type': 'search',
19 |     'data-model': 'debounce(400)|query.queryString',
20 |     'placeholder': 'search.placeholder'|trans(domain='mezcalito_ux_search')
21 |     }) }}>
22 | {% endblock %}
23 | ```
24 | 
25 | ## Default HTML output
26 | ```html
27 | <input class="ux-search-search-input ux-search-input" type="search" data-model="debounce(400)|query.queryString" placeholder="Search here...">
28 | ```
29 | 


--------------------------------------------------------------------------------
/docs/components/SortBy.md:
--------------------------------------------------------------------------------
 1 | # SortBy
 2 | 
 3 | The `SortBy` component displays a list of sorting possibility, allowing a user to change the way hits are sorted.
 4 | 
 5 | ## Block available
 6 | 
 7 | | name    | Description |
 8 | |---------|-------------|
 9 | | content |             |
10 | 
11 | 
12 | ## Default layout
13 | 
14 | ```twig
15 | {% block content %}
16 |     <div {{ attributes.defaults({
17 |     'class': 'ux-search-sort-by ux-search-select',
18 |     }) }}>
19 |         <select data-model="query.activeSort">
20 |             {% for option in availableSorts %}
21 |             <option value="{{ option.key }}" {% if option.key == activeSort %}selected{% endif %}>{{ option.label }}</option>
22 |             {% endfor %}
23 |         </select>
24 |         <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-down"><path d="m6 9 6 6 6-6"/></svg>
25 |     </div>
26 | {% endblock %}
27 | ```
28 | 
29 | ## Default HTML output
30 | ```html
31 | <div class="ux-search-sort-by ux-search-select">
32 |     <select data-model="query.activeSort">
33 |         <option value="price:asc" selected>Price ↑</option>
34 |         <option value="price:desc">Price ↓</option>
35 |         <option value="popularity:asc">Popularity ↑</option>
36 |         <option value="popularity:desc">Popularity ↓</option>
37 |     </select>
38 |     <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-down"><path d="m6 9 6 6 6-6"></path></svg>
39 | </div>
40 | ```
41 | 


--------------------------------------------------------------------------------
/docs/components/TotalHits.md:
--------------------------------------------------------------------------------
 1 | # TotalHits
 2 | 
 3 | The `TotalHits` component displays the total number of matching hits.
 4 | 
 5 | ## Block available
 6 | 
 7 | | name    | Description |
 8 | |---------|-------------|
 9 | | content | -           |
10 | 
11 | 
12 | ## Default layout
13 | 
14 | ```twig
15 | {% block content %}
16 |     <span {{ attributes.defaults({
17 |         'class': 'ux-search-total-hits'
18 |     }) }} >
19 |         {{ 'results'|trans({'%count%': totalHits}, domain='mezcalito_ux_search') }}
20 |     </span>
21 | {% endblock %}
22 | ```
23 | 
24 | ## Default HTML output
25 | ```html
26 | <div class="ux-search__stats">
27 |     <span class="ux-search-total-hits">
28 |         10000 results
29 |     </span>
30 | </div>
31 | ```
32 | 


--------------------------------------------------------------------------------
/docs/create-own-adapter.md:
--------------------------------------------------------------------------------
 1 | # Create own Adapter
 2 | 
 3 | In this part of the documentation describes how to create an own adapter. Before you start with it let us know via an [issue](https://github.com/mezcalito/ux-search/issues) if it maybe an Adapter which make sense to add to the project, and we can work together to get it in it.
 4 | 
 5 | ## Create Basic Classes
 6 | 
 7 | ### Create Adapter
 8 | 
 9 | ```php
10 | <?php
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace My\Own\Adapter;
15 | 
16 | use Mezcalito\UxSearchBundle\Adapter\AdapterInterface;
17 | use Mezcalito\UxSearchBundle\Search\Query;
18 | use Mezcalito\UxSearchBundle\Search\SearchInterface;
19 | use Symfony\Component\OptionsResolver\OptionsResolver;
20 | 
21 | final readonly class MyAdapter implements AdapterInterface
22 | {
23 |     
24 |     public function search(Query $query, SearchInterface $search): ResultSet
25 |     {
26 |         // Your logic
27 |     }
28 | 
29 |     public function configureParameters(OptionsResolver $resolver): void
30 |     {
31 |         // Your logic
32 |     }
33 | }
34 | ```
35 | 
36 | ### Create Factory
37 | 
38 | ```php
39 | <?php
40 | 
41 | declare(strict_types=1);
42 | 
43 | namespace My\Own\Adapter;
44 | 
45 | use Mezcalito\UxSearchBundle\Adapter\AdapterFactoryInterface;
46 | use Mezcalito\UxSearchBundle\Adapter\AdapterInterface;
47 | 
48 | readonly class MyAdapterFactory implements AdapterFactoryInterface
49 | {
50 |     public function support(string $dsn): bool
51 |     {
52 |         return str_starts_with($dsn, 'myAdapter'); // Or your own logic
53 |     }
54 | 
55 |     public function createAdapter(string $dsn): AdapterInterface
56 |     {
57 |         // Your own logic
58 | 
59 |         return new YourAdapter();
60 |     }
61 | }
62 | ```
63 | 
64 | ## And "Et voilà"
65 | 
66 | You just need to add your Adapter to the configuration. 
67 | 
68 | ```yaml
69 | mezcalito_search:
70 |     default_adapter: 'myAdapter'
71 |     adapter:
72 |         myAdapter: 'myAdapter://what_you_need',
73 | ```
74 | 
75 | 
76 | 


--------------------------------------------------------------------------------
/docs/image/preview.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Mezcalito/ux-search/039116730876de3966f01ee6984e93d894325782/docs/image/preview.png


--------------------------------------------------------------------------------
/docs/usage/algolia.md:
--------------------------------------------------------------------------------
 1 | # Algolia
 2 | 
 3 | ## Available configuration for adapter
 4 | 
 5 | | Constant name                              | Algolia name                     | Type     | Default value                          |
 6 | |--------------------------------------------|----------------------------------|----------|----------------------------------------|
 7 | | ADVANCED_SYNTAX_PARAM                      | advancedSyntax                   | bool     | false                                  |
 8 | | ADVANCED_SYNTAX_FEATURES_PARAM             | advancedSyntaxFeatures           | string[] | ['exactPhrase', 'excludeWords']        |
 9 | | ALLOW_TYPOS_ON_NUMERIC_TOKENS_PARAM        | allowTyposOnNumericTokens        | bool     | true                                   |
10 | | ALTERNATIVES_AS_EXACT_PARAM                | alternativesAsExact              | string[] | ['ignorePlurals', 'singleWordSynonym'] |
11 | | ANALYTICS_PARAM                            | analytics                        | bool     | true                                   |
12 | | ANALYTICS_TAGS_PARAM                       | analyticsTags                    | string[] | []                                     |
13 | | ATTRIBUTES_TO_HIGHLIGHT_PARAM              | attributesToHighlight            | string[] | ['*']                                  |
14 | | ATTRIBUTES_TO_RETRIEVE_PARAM               | attributesToRetrieve             | string[] | ['*']                                  |
15 | | DECOMPOUND_QUERY_PARAM                     | decompoundQuery                  | bool     | true                                   |
16 | | DISABLE_EXACT_ON_ATTRIBUTES_PARAM          | disableExactOnAttributes         | string[] | []                                     |
17 | | DISABLE_TYPO_TOLERANCE_ON_ATTRIBUTES_PARAM | disableTypoToleranceOnAttributes | string[] | []                                     |
18 | | ENABLE_AB_TEST_PARAM                       | enableABTest                     | bool     | true                                   |
19 | | ENABLE_PERSONALIZATION_PARAM               | enablePersonalization            | bool     | false                                  |
20 | | HIGHLIGHT_POST_TAG_PARAM                   | highlightPostTag                 | string   | &lt;/em&gt;                            |
21 | | HIGHLIGHT_PRE_TAG_PARAM                    | highlightPreTag                  | string   | &lt;em&gt;                             |
22 | | MAX_VALUES_PER_FACET_PARAM                 | maxValuesPerFacet                | int      | 100                                    |
23 | | QUERY_TYPE_PARAM                           | queryType                        | string   | prefixLast                             |
24 | | SORT_FACET_VALUES_BY_PARAM                 | sortFacetValuesBy                | string   | count                                  |
25 | | SYNONYMS_PARAM                             | synonyms                         | bool     | true                                   |
26 | 
27 | If you need more inforamtion about this configuration check [Algolia documentation](https://www.meilisearch.com/docs/reference/api/search#body)
28 | 
29 | 
30 | 


--------------------------------------------------------------------------------
/docs/usage/customize-your-search.md:
--------------------------------------------------------------------------------
  1 | # Customize your search
  2 | 
  3 | > [!IMPORTANT]
  4 | > If you haven't used the maker, you first need to create a class and add the `AsSearch` attribute to it.
  5 | 
  6 | **Create a search**
  7 | ```php
  8 | <?php
  9 | 
 10 | declare(strict_types=1);
 11 | 
 12 | namespace App\Search;
 13 | 
 14 | use Mezcalito\UxSearchBundle\Attribute\AsSearch;
 15 | use Mezcalito\UxSearchBundle\Search\AbstractSearch;
 16 | 
 17 | #[AsSearch('products')]
 18 | class ListingSearch extends AbstractSearch
 19 | {
 20 | }
 21 | ```
 22 | 
 23 | **Now you can add plenty of features to your search.**
 24 | 
 25 | ## Add facets
 26 | 
 27 | If you wish, you can add facets to your Search. To do this, you need to use the `addFacet` method.
 28 | This method takes the following parameters:
 29 | 
 30 | | Parameter        | Description                 | Type   | Required |
 31 | |------------------|-----------------------------|--------|----------|
 32 | | property         | Property name               | string | ✅        |
 33 | | label            | Label displayed             | string | ✅        |
 34 | | displayComponent | FQCN of your Twig component | string | ❌        |
 35 | | props            | Props to pass to component  | array  | ❌        |
 36 | 
 37 | 
 38 | ```php
 39 | <?php
 40 | 
 41 | declare(strict_types=1);
 42 | 
 43 | namespace Mezcalito\UxSearchBundle\Tests\TestApplication\Search;
 44 | 
 45 | use Mezcalito\UxSearchBundle\Adapter\Meilisearch\MeilisearchAdapter;
 46 | use Mezcalito\UxSearchBundle\Attribute\AsSearch;
 47 | use Mezcalito\UxSearchBundle\Search\AbstractSearch;
 48 | use Mezcalito\UxSearchBundle\Search\Facet;
 49 | use Mezcalito\UxSearchBundle\Twig\Component\Facet\RangeInput;
 50 | 
 51 | #[AsSearch('products', name: 'listing', adapter: 'meilisearch')]
 52 | class MeilisearchSearch extends AbstractSearch
 53 | {
 54 |     public function build(array $options = []): void
 55 |     {
 56 |         $this
 57 |             ->addFacet('type', 'Type')
 58 |             ->addFacet('price', 'Price', RangeInput::class)
 59 |             ->addFacet('price', 'Price', null, ['limit' => 20])
 60 |         ;
 61 |     }
 62 | }
 63 | ```
 64 | 
 65 | ## Add sort
 66 | 
 67 | You can also add sorting options to your Search. To do this, you need to use the `addAvailableSort` method.
 68 | This method takes 2 mandatory parameters:
 69 | 
 70 | | Parameter | Description                             | Type    |
 71 | |-----------|-----------------------------------------|---------|
 72 | | key       | Attribute key and order separate by ':' | ?string |
 73 | | label     | Label displayed                         | string  |
 74 | 
 75 | If you do not specify a sort or if the key is empty, the default sorting of your adapter will be applied.
 76 | 
 77 | ```php
 78 |     use Mezcalito\UxSearchBundle\Search\Sort;
 79 |     
 80 |     // ..
 81 |     
 82 |     public function build(array $options = []): void
 83 |     {
 84 |         $this
 85 |             // ..
 86 |             ->addAvailableSort(null, 'Relevancy') 
 87 |             ->addAvailableSort('price:asc', 'Price ↑')
 88 |             ->addAvailableSort('price:desc', 'Price ↓')
 89 |         ;
 90 |     }
 91 | ```
 92 | 
 93 | ## Add EventListener or EventSubscriber
 94 | For example, you can modify the `ResultSet` on the `PostSearchEvent` to enrich a `Hit` with data from database.
 95 | 
 96 | ```php
 97 |     use Mezcalito\UxSearchBundle\Event\PreSearchEvent;
 98 |     use Mezcalito\UxSearchBundle\Event\PostSearchEvent;
 99 |     // ..
100 |     
101 |     public function build(array $options = []): void
102 |     {
103 |         $this 
104 |             // ...
105 |             ->addEventListener(PreSearchEvent::class, function (PreSearchEvent $event) {
106 |                 // $event->getSearch();   
107 |                 // $event->getQuery();   
108 |             })
109 |             ->addEventListener(PostSearchEvent::class, function (PostSearchEvent $event) {
110 |                 // $event->getSearch();
111 |                 // $event->getQuery();
112 |                 // $event->getResultSet();    
113 |            })
114 |            ->addEventSubscriber(YourEventSubscriber::cass)
115 |         ;
116 |     }
117 | ```
118 | 
119 | ## Enable urlRewriting and set up an urlFormater
120 | It is possible to enable a URL rewriting system to allow sharing of configured search URLs. To do this, simply add the `->enableUrlRewriting` method. By default, a `DefaultUrlFormater` is provided in the bundle. This allows you to add query parameters with the values of the selected facets.
121 | 
122 | ```php
123 | 
124 |     public function build(array $options = []): void
125 |     {
126 |         $this
127 |             // ...
128 |             ->enableUrlRewriting()
129 |         ;
130 |     }
131 | ```
132 | 
133 | You can also create your own UrlFormater. To do so, you need to implement the `UrlFormaterInterface` and define your own logic in the `generateUrl` and `applyFilters` methods. All that is left is to use it in a search via the `->setUrlFormater()` method.
134 | 
135 | ```php
136 |     use App\Url\YourCustomUrlFormater;
137 |     // ...
138 | 
139 |     public function build(array $options = []): void
140 |     {
141 |         $this
142 |             // ...
143 |             ->enableUrlRewriting()
144 |             ->setUrlFormater(YourCustomUrlFormater::class)
145 |         ;
146 |     }
147 | ```
148 | 


--------------------------------------------------------------------------------
/docs/usage/doctrine.md:
--------------------------------------------------------------------------------
 1 | # Doctrine
 2 | 
 3 | ## Available configuration for adapter
 4 | 
 5 | | Constant name          | type     | default value                              |
 6 | |------------------------|----------|--------------------------------------------|
 7 | | MAX_FACET_VALUES_PARAM | int      | 100                                        |
 8 | | QUERY_BUILDER_ALIAS    | string   | o                                          |
 9 | | QUERY_BUILDER          | closure  | `function (QueryBuilder $queryBuilder) {}` |
10 | | SEARCH_FIELDS          | string[] | []                                         |
11 | 


--------------------------------------------------------------------------------
/docs/usage/meilisearch.md:
--------------------------------------------------------------------------------
 1 | # Meilisearch
 2 | 
 3 | ## Available configuration for adapter 
 4 | 
 5 | | Constant name                 | Meilisearch name      | Type     | Default value |
 6 | |-------------------------------|-----------------------|----------|---------------|
 7 | | ATTRIBUTES_TO_RETRIEVE_PARAM  | attributesToRetrieve  | string[] | ['*']         |
 8 | | ATTRIBUTES_TO_CROP_PARAM      | attributesToCrop      | string[] | []            |
 9 | | CROP_LENGTH_PARAM             | cropLength            | int      | 10            |
10 | | CROP_MARKER_PARAM             | cropMarker            | string   | ...           |
11 | | ATTRIBUTES_TO_HIGHLIGHT_PARAM | attributesToHighlight | string[] | []            |
12 | | HIGHLIGHT_PRE_TAG_PARAM       | highlightPreTag       | string   | &lt;em&gt;    |
13 | | HIGHLIGHT_POST_TAG_PARAM      | highlightPostTag      | string   | &lt;/em&gt;   |
14 | 
15 | If you need more inforamtion about this configuration check [Meilisearch documentation](https://www.meilisearch.com/docs/reference/api/search#body)
16 | 


--------------------------------------------------------------------------------
/eslint.config.mjs:
--------------------------------------------------------------------------------
 1 | import globals from 'globals';
 2 | import pluginJs from '@eslint/js';
 3 | import pluginTypescript from 'typescript-eslint';
 4 | import pluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
 5 | 
 6 | export default [
 7 |   { files: ['**/*.{js,mjs,cjs,ts}'] },
 8 |   {
 9 |     ignores: ['**/build', '**/dist', '**/public', '**/var', '**/vendor', '**/coverage', '**/tests', 'rollup.config.js'],
10 |   },
11 |   { languageOptions: { globals: globals.browser } },
12 |   pluginJs.configs.recommended,
13 |   ...pluginTypescript.configs.recommended,
14 |   pluginPrettierRecommended,
15 | 
16 |   // Override rules
17 |   {
18 |     rules: {
19 |       'no-duplicate-imports': 'warn',
20 |       'no-console': ['warn', { allow: ['warn', 'error'] }],
21 | 
22 |       // TypeScript
23 |       '@typescript-eslint/ban-ts-comment': 'off',
24 |       '@typescript-eslint/consistent-type-imports': [
25 |         'warn',
26 |         {
27 |           prefer: 'type-imports',
28 |           disallowTypeAnnotations: false,
29 |           fixStyle: 'inline-type-imports',
30 |         },
31 |       ],
32 |     },
33 |   },
34 | ];
35 | 


--------------------------------------------------------------------------------
/phpunit.dist.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3 |          xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.5/phpunit.xsd"
 4 |          backupGlobals="false"
 5 |          backupStaticProperties="false"
 6 |          bootstrap="tests/bootstrap.php"
 7 |          cacheDirectory=".phpunit.cache"
 8 |          colors="true"
 9 |          processIsolation="false"
10 |          stopOnFailure="false"
11 | >
12 |     <php>
13 |         <env name="APP_ENV" value="test" />
14 |         <env name="KERNEL_CLASS" value="Mezcalito\UxSearchBundle\Tests\TestApplication\Kernel" />
15 |         <server name="SHELL_VERBOSITY" value="-1" />
16 |     </php>
17 | 
18 |     <testsuites>
19 |         <testsuite name="UxSearch Test Suite">
20 |             <directory>tests</directory>
21 |         </testsuite>
22 |     </testsuites>
23 | 
24 |     <source>
25 |         <include>
26 |             <directory suffix=".php">src</directory>
27 |         </include>
28 |     </source>
29 | </phpunit>
30 | 


--------------------------------------------------------------------------------
/src/Adapter/AbstractAdapter.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /*
  4 |  * This file is part of the UxSearch project.
  5 |  *
  6 |  * (c) Mezcalito (https://www.mezcalito.fr)
  7 |  *
  8 |  * For the full copyright and license information, please view the LICENSE
  9 |  * file that was distributed with this source code.
 10 |  */
 11 | 
 12 | declare(strict_types=1);
 13 | 
 14 | namespace Mezcalito\UxSearchBundle\Adapter;
 15 | 
 16 | use Mezcalito\UxSearchBundle\Search\Facet;
 17 | use Mezcalito\UxSearchBundle\Search\Filter\FilterInterface;
 18 | use Mezcalito\UxSearchBundle\Search\Filter\RangeFilter;
 19 | use Mezcalito\UxSearchBundle\Search\Filter\TermFilter;
 20 | use Mezcalito\UxSearchBundle\Search\Query;
 21 | use Mezcalito\UxSearchBundle\Search\ResultSet\FacetStat;
 22 | use Mezcalito\UxSearchBundle\Search\ResultSet\FacetTermDistribution;
 23 | use Mezcalito\UxSearchBundle\Search\SearchInterface;
 24 | 
 25 | abstract class AbstractAdapter implements AdapterInterface
 26 | {
 27 |     abstract public function getFacetDistributionKey(): string;
 28 | 
 29 |     abstract public function getFacetStatsKey(): string;
 30 | 
 31 |     protected function getFacets(array $results, SearchInterface $search, Query $query): array
 32 |     {
 33 |         $facetDistributionKey = $this->getFacetDistributionKey();
 34 |         $facetStatsKey = $this->getFacetStatsKey();
 35 | 
 36 |         $mergedFacetDistribution = array_reduce($results['results'], function ($carry, $result) use ($facetDistributionKey) {
 37 |             if (isset($result[$facetDistributionKey])) {
 38 |                 foreach ($result[$facetDistributionKey] as $facetKey => $facetValues) {
 39 |                     $carry[$facetKey] = $facetValues;
 40 |                 }
 41 |             }
 42 | 
 43 |             return $carry;
 44 |         }, []);
 45 | 
 46 |         $mergedFacetStats = array_reduce($results['results'], function ($carry, $result) use ($facetStatsKey) {
 47 |             if (isset($result[$facetStatsKey])) {
 48 |                 foreach ($result[$facetStatsKey] as $facetKey => $facetStat) {
 49 |                     $carry[$facetKey] = $facetStat;
 50 |                 }
 51 |             }
 52 | 
 53 |             return $carry;
 54 |         }, []);
 55 | 
 56 |         $facetsDistributions = [];
 57 | 
 58 |         foreach ($search->getFacets() as $facet) {
 59 |             $filter = $query->getActiveFilter($facet->getProperty());
 60 |             $facetsDistributions[$facet->getProperty()] = $this->hydrateTermDistribution($mergedFacetDistribution, $facet, $filter);
 61 | 
 62 |             if (!isset($mergedFacetStats[$facet->getProperty()])) {
 63 |                 $mergedFacetStats[$facet->getProperty()] = ['min' => 0, 'max' => 0];
 64 |             }
 65 |         }
 66 | 
 67 |         foreach ($facetsDistributions as $property => $distribution) {
 68 |             if ($distribution instanceof FacetTermDistribution) {
 69 |                 $values = $distribution->getValues();
 70 |                 $checkedValues = $distribution->getCheckedValues();
 71 | 
 72 |                 $checkedFacets = [];
 73 |                 $uncheckedFacets = [];
 74 | 
 75 |                 foreach ($values as $key => $value) {
 76 |                     if (\in_array($key, $checkedValues)) {
 77 |                         $checkedFacets[$key] = $value;
 78 |                     } else {
 79 |                         $uncheckedFacets[$key] = $value;
 80 |                     }
 81 |                 }
 82 | 
 83 |                 $sortedFacets = $checkedFacets + $uncheckedFacets;
 84 | 
 85 |                 $distribution->setValues($sortedFacets);
 86 |             }
 87 |         }
 88 | 
 89 |         $facetStats = [];
 90 |         foreach ($mergedFacetStats as $property => $values) {
 91 |             $filter = $query->getActiveFilter($property);
 92 |             if ($filter instanceof RangeFilter) {
 93 |                 $userMin = $filter->getMin();
 94 |                 $userMax = $filter->getMax();
 95 |             }
 96 | 
 97 |             $facetStats[] = new FacetStat($property, $values['min'], $values['max'], $userMin ?? null, $userMax ?? null);
 98 |         }
 99 | 
100 |         return [$facetsDistributions, $facetStats];
101 |     }
102 | 
103 |     protected function hydrateTermDistribution(array $mergedFacetDistribution, Facet $facet, ?FilterInterface $filter): FacetTermDistribution
104 |     {
105 |         $values = $mergedFacetDistribution[$facet->getProperty()] ?? [];
106 | 
107 |         $termDistribution = (new FacetTermDistribution())
108 |             ->setProperty($facet->getProperty())
109 |             ->setValues($values)
110 |         ;
111 | 
112 |         if ($filter instanceof TermFilter) {
113 |             $termDistribution->setCheckedValues($filter->getValues());
114 |         }
115 | 
116 |         return $termDistribution;
117 |     }
118 | }
119 | 


--------------------------------------------------------------------------------
/src/Adapter/AdapterFactoryInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Adapter;
15 | 
16 | interface AdapterFactoryInterface
17 | {
18 |     public function support(string $dsn): bool;
19 | 
20 |     public function createAdapter(string $dsn): AdapterInterface;
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Adapter/AdapterInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Adapter;
15 | 
16 | use Mezcalito\UxSearchBundle\Search\Query;
17 | use Mezcalito\UxSearchBundle\Search\ResultSet\ResultSet;
18 | use Mezcalito\UxSearchBundle\Search\SearchInterface;
19 | use Symfony\Component\OptionsResolver\OptionsResolver;
20 | 
21 | interface AdapterInterface
22 | {
23 |     public function search(Query $query, SearchInterface $search): ResultSet;
24 | 
25 |     public function configureParameters(OptionsResolver $resolver): void;
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Adapter/AdapterProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Adapter;
15 | 
16 | use Mezcalito\UxSearchBundle\Exception\AdapterException;
17 | 
18 | readonly class AdapterProvider
19 | {
20 |     public function __construct(
21 |         private string $defaultAdapterName,
22 |         private array $adapterConfiguration,
23 |         private iterable $factories,
24 |     ) {
25 |     }
26 | 
27 |     public function getAdapter(?string $name = null): AdapterInterface
28 |     {
29 |         if (null === $name) {
30 |             $name = $this->defaultAdapterName;
31 |         }
32 | 
33 |         if (!\array_key_exists($name, $this->adapterConfiguration)) {
34 |             throw AdapterException::configurationNotFound($name);
35 |         }
36 | 
37 |         $dsn = $this->adapterConfiguration[$name]['dsn'];
38 | 
39 |         foreach ($this->factories as $factory) {
40 |             if ($factory->support($dsn)) {
41 |                 return $factory->createAdapter($dsn);
42 |             }
43 |         }
44 | 
45 |         throw AdapterException::factoryNotFound($dsn);
46 |     }
47 | }
48 | 


--------------------------------------------------------------------------------
/src/Adapter/Algolia/AlgoliaAdapter.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /*
  4 |  * This file is part of the UxSearch project.
  5 |  *
  6 |  * (c) Mezcalito (https://www.mezcalito.fr)
  7 |  *
  8 |  * For the full copyright and license information, please view the LICENSE
  9 |  * file that was distributed with this source code.
 10 |  */
 11 | 
 12 | declare(strict_types=1);
 13 | 
 14 | namespace Mezcalito\UxSearchBundle\Adapter\Algolia;
 15 | 
 16 | use Algolia\AlgoliaSearch\SearchClient;
 17 | use Mezcalito\UxSearchBundle\Adapter\AbstractAdapter;
 18 | use Mezcalito\UxSearchBundle\Search\Query;
 19 | use Mezcalito\UxSearchBundle\Search\ResultSet\Hit;
 20 | use Mezcalito\UxSearchBundle\Search\ResultSet\ResultSet;
 21 | use Mezcalito\UxSearchBundle\Search\SearchInterface;
 22 | use Symfony\Component\OptionsResolver\OptionsResolver;
 23 | 
 24 | class AlgoliaAdapter extends AbstractAdapter
 25 | {
 26 |     public const string ADVANCED_SYNTAX_PARAM = 'advancedSyntax';
 27 | 
 28 |     public const string ADVANCED_SYNTAX_FEATURES_PARAM = 'advancedSyntaxFeatures';
 29 | 
 30 |     public const string ALLOW_TYPOS_ON_NUMERIC_TOKENS_PARAM = 'allowTyposOnNumericTokens';
 31 | 
 32 |     public const string ALTERNATIVES_AS_EXACT_PARAM = 'alternativesAsExact';
 33 | 
 34 |     public const string ANALYTICS_PARAM = 'analytics';
 35 | 
 36 |     public const string ANALYTICS_TAGS_PARAM = 'analyticsTags';
 37 | 
 38 |     public const string ATTRIBUTES_TO_HIGHLIGHT_PARAM = 'attributesToHighlight';
 39 | 
 40 |     public const string ATTRIBUTES_TO_RETRIEVE_PARAM = 'attributesToRetrieve';
 41 | 
 42 |     public const string DECOMPOUND_QUERY_PARAM = 'decompoundQuery';
 43 | 
 44 |     public const string DISABLE_EXACT_ON_ATTRIBUTES_PARAM = 'disableExactOnAttributes';
 45 | 
 46 |     public const string DISABLE_TYPO_TOLERANCE_ON_ATTRIBUTES_PARAM = 'disableTypoToleranceOnAttributes';
 47 | 
 48 |     public const string ENABLE_AB_TEST_PARAM = 'enableABTest';
 49 | 
 50 |     public const string ENABLE_PERSONALIZATION_PARAM = 'enablePersonalization';
 51 | 
 52 |     public const string HIGHLIGHT_POST_TAG_PARAM = 'highlightPostTag';
 53 | 
 54 |     public const string HIGHLIGHT_PRE_TAG_PARAM = 'highlightPreTag';
 55 | 
 56 |     public const string MAX_VALUES_PER_FACET_PARAM = 'maxValuesPerFacet';
 57 | 
 58 |     public const string QUERY_TYPE_PARAM = 'queryType';
 59 | 
 60 |     public const string SORT_FACET_VALUES_BY_PARAM = 'sortFacetValuesBy';
 61 | 
 62 |     public const string SYNONYMS_PARAM = 'synonyms';
 63 | 
 64 |     public function __construct(
 65 |         private readonly SearchClient $client,
 66 |         private readonly QueryBuilder $queryBuilder,
 67 |     ) {
 68 |     }
 69 | 
 70 |     public function getFacetDistributionKey(): string
 71 |     {
 72 |         return 'facets';
 73 |     }
 74 | 
 75 |     public function getFacetStatsKey(): string
 76 |     {
 77 |         return 'facets_stats';
 78 |     }
 79 | 
 80 |     public function search(Query $query, SearchInterface $search): ResultSet
 81 |     {
 82 |         $queries = $this->queryBuilder->build($query, $search);
 83 | 
 84 |         $results = $this->client->search($queries);
 85 | 
 86 |         $resultsToProcess = $results['results'][0];
 87 | 
 88 |         $hits = [];
 89 |         foreach ($resultsToProcess['hits'] as $hit) {
 90 |             $hits[] = new Hit($hit, $hit['_rankingInfo']['userScore']);
 91 |         }
 92 | 
 93 |         [$facetsDistributions, $facetStats] = $this->getFacets($results, $search, $query);
 94 | 
 95 |         return (new ResultSet())
 96 |             ->setIndexUid($resultsToProcess['index'])
 97 |             ->setHits($hits)
 98 |             ->setTotalResults($resultsToProcess['nbHits'])
 99 |             ->setFacetDistributions($facetsDistributions)
100 |             ->setFacetStats($facetStats)
101 |         ;
102 |     }
103 | 
104 |     public function configureParameters(OptionsResolver $resolver): void
105 |     {
106 |         $resolver->setDefaults([
107 |             self::ADVANCED_SYNTAX_PARAM => false,
108 |             self::ADVANCED_SYNTAX_FEATURES_PARAM => ['exactPhrase', 'excludeWords'],
109 |             self::ALLOW_TYPOS_ON_NUMERIC_TOKENS_PARAM => true,
110 |             self::ALTERNATIVES_AS_EXACT_PARAM => ['ignorePlurals', 'singleWordSynonym'],
111 |             self::ANALYTICS_PARAM => true,
112 |             self::ANALYTICS_TAGS_PARAM => [],
113 |             self::ATTRIBUTES_TO_HIGHLIGHT_PARAM => ['*'],
114 |             self::ATTRIBUTES_TO_RETRIEVE_PARAM => ['*'],
115 |             self::DECOMPOUND_QUERY_PARAM => true,
116 |             self::DISABLE_EXACT_ON_ATTRIBUTES_PARAM => [],
117 |             self::DISABLE_TYPO_TOLERANCE_ON_ATTRIBUTES_PARAM => [],
118 |             self::ENABLE_AB_TEST_PARAM => true,
119 |             self::ENABLE_PERSONALIZATION_PARAM => false,
120 |             self::HIGHLIGHT_POST_TAG_PARAM => '</em>',
121 |             self::HIGHLIGHT_PRE_TAG_PARAM => '<em>',
122 |             self::MAX_VALUES_PER_FACET_PARAM => 100,
123 |             self::QUERY_TYPE_PARAM => 'prefixLast',
124 |             self::SORT_FACET_VALUES_BY_PARAM => 'count',
125 |             self::SYNONYMS_PARAM => true,
126 |         ]);
127 | 
128 |         $resolver->setAllowedTypes(self::ADVANCED_SYNTAX_PARAM, 'bool');
129 |         $resolver->setAllowedTypes(self::ADVANCED_SYNTAX_FEATURES_PARAM, 'string[]');
130 |         $resolver->setAllowedTypes(self::ALLOW_TYPOS_ON_NUMERIC_TOKENS_PARAM, 'bool');
131 |         $resolver->setAllowedTypes(self::ALTERNATIVES_AS_EXACT_PARAM, 'string[]');
132 |         $resolver->setAllowedTypes(self::ANALYTICS_PARAM, 'bool');
133 |         $resolver->setAllowedTypes(self::ANALYTICS_TAGS_PARAM, 'string[]');
134 |         $resolver->setAllowedTypes(self::ATTRIBUTES_TO_HIGHLIGHT_PARAM, 'string[]');
135 |         $resolver->setAllowedTypes(self::ATTRIBUTES_TO_RETRIEVE_PARAM, 'string[]');
136 |         $resolver->setAllowedTypes(self::DECOMPOUND_QUERY_PARAM, 'bool');
137 |         $resolver->setAllowedTypes(self::DISABLE_EXACT_ON_ATTRIBUTES_PARAM, 'string[]');
138 |         $resolver->setAllowedTypes(self::DISABLE_TYPO_TOLERANCE_ON_ATTRIBUTES_PARAM, 'string[]');
139 |         $resolver->setAllowedTypes(self::ENABLE_AB_TEST_PARAM, 'bool');
140 |         $resolver->setAllowedTypes(self::ENABLE_PERSONALIZATION_PARAM, 'bool');
141 |         $resolver->setAllowedTypes(self::HIGHLIGHT_POST_TAG_PARAM, 'string');
142 |         $resolver->setAllowedTypes(self::HIGHLIGHT_PRE_TAG_PARAM, 'string');
143 |         $resolver->setAllowedTypes(self::MAX_VALUES_PER_FACET_PARAM, 'int');
144 |         $resolver->setAllowedTypes(self::QUERY_TYPE_PARAM, 'string');
145 |         $resolver->setAllowedTypes(self::SORT_FACET_VALUES_BY_PARAM, 'string');
146 |         $resolver->setAllowedTypes(self::SYNONYMS_PARAM, 'bool');
147 | 
148 |         $resolver->setAllowedValues(self::ADVANCED_SYNTAX_FEATURES_PARAM, function (array $values) {
149 |             foreach ($values as $value) {
150 |                 if (!\in_array($value, ['exactPhrase', 'excludeWords'])) {
151 |                     return false;
152 |                 }
153 |             }
154 | 
155 |             return true;
156 |         });
157 |         $resolver->setAllowedValues(self::ALTERNATIVES_AS_EXACT_PARAM, function (array $values) {
158 |             foreach ($values as $value) {
159 |                 if (!\in_array($value, ['ignoreConjugations', 'ignorePlurals', 'multiWordsSynonym', 'singleWordSynonym'])) {
160 |                     return false;
161 |                 }
162 |             }
163 | 
164 |             return true;
165 |         });
166 |         $resolver->setAllowedValues(self::MAX_VALUES_PER_FACET_PARAM, fn (int $value): bool => $value <= 1000);
167 |         $resolver->setAllowedValues(self::QUERY_TYPE_PARAM, ['prefixAll', 'prefixLast', 'prefixNone']);
168 |         $resolver->setAllowedValues(self::SORT_FACET_VALUES_BY_PARAM, ['count', 'alpha']);
169 |     }
170 | }
171 | 


--------------------------------------------------------------------------------
/src/Adapter/Algolia/AlgoliaFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Adapter\Algolia;
15 | 
16 | use Algolia\AlgoliaSearch\SearchClient;
17 | use Mezcalito\UxSearchBundle\Adapter\AdapterFactoryInterface;
18 | use Mezcalito\UxSearchBundle\Adapter\AdapterInterface;
19 | 
20 | readonly class AlgoliaFactory implements AdapterFactoryInterface
21 | {
22 |     public function support(string $dsn): bool
23 |     {
24 |         return str_starts_with($dsn, 'algolia');
25 |     }
26 | 
27 |     public function createAdapter(string $dsn): AdapterInterface
28 |     {
29 |         return new AlgoliaAdapter($this->createClient($dsn), new QueryBuilder());
30 |     }
31 | 
32 |     public function createClient(string $dsn): SearchClient
33 |     {
34 |         if (!class_exists(SearchClient::class)) {
35 |             throw new \LogicException(\sprintf('You cannot use the "%s" as Algolia, Client is not installed. Try running "composer require algolia/search-bundle".', self::class));
36 |         }
37 | 
38 |         $parsedDsn = parse_url($dsn);
39 | 
40 |         return SearchClient::create($parsedDsn['host'], $parsedDsn['user']);
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Adapter/Algolia/QueryBuilder.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /*
  4 |  * This file is part of the UxSearch project.
  5 |  *
  6 |  * (c) Mezcalito (https://www.mezcalito.fr)
  7 |  *
  8 |  * For the full copyright and license information, please view the LICENSE
  9 |  * file that was distributed with this source code.
 10 |  */
 11 | 
 12 | declare(strict_types=1);
 13 | 
 14 | namespace Mezcalito\UxSearchBundle\Adapter\Algolia;
 15 | 
 16 | use Mezcalito\UxSearchBundle\Search\Filter\FilterInterface;
 17 | use Mezcalito\UxSearchBundle\Search\Filter\RangeFilter;
 18 | use Mezcalito\UxSearchBundle\Search\Filter\TermFilter;
 19 | use Mezcalito\UxSearchBundle\Search\Query;
 20 | use Mezcalito\UxSearchBundle\Search\SearchInterface;
 21 | 
 22 | class QueryBuilder
 23 | {
 24 |     public function build(Query $query, SearchInterface $search): array
 25 |     {
 26 |         $indexName = $search->getIndexName();
 27 |         $options = $search->getResolvedAdapterParameters();
 28 | 
 29 |         $hitsPerPage = $query->getActiveHitsPerPage();
 30 |         $queries = [];
 31 | 
 32 |         if ($query->getActiveSort()) {
 33 |             $indexName = $query->getActiveSort();
 34 |         }
 35 | 
 36 |         $displayedFacets = [];
 37 | 
 38 |         foreach ($search->getFacets() as $facet) {
 39 |             $displayedFacets[] = $facet->getProperty();
 40 |         }
 41 | 
 42 |         $algoliaQuery = array_merge($options, [
 43 |             'indexName' => $indexName,
 44 |             'getRankingInfo' => true,
 45 |             'query' => $query->getQueryString(),
 46 |             'filters' => $this->formatFilters($query->getActiveFilters()),
 47 |             'hitsPerPage' => $hitsPerPage,
 48 |             'page' => ($query->getCurrentPage() - 1), // Algolia page start to 0
 49 |         ]);
 50 | 
 51 |         if ([] !== $displayedFacets) {
 52 |             $algoliaQuery['facets'] = $displayedFacets;
 53 |         }
 54 | 
 55 |         $queries[] = $algoliaQuery;
 56 | 
 57 |         $activeFilters = $query->getActiveFilters();
 58 | 
 59 |         foreach ($activeFilters as $activeFilter) {
 60 |             $otherFilters = [];
 61 |             foreach ($activeFilters as $filter) {
 62 |                 if ($filter->getProperty() !== $activeFilter->getProperty()) {
 63 |                     $otherFilters[] = $filter;
 64 |                 }
 65 |             }
 66 | 
 67 |             $queries[] = [
 68 |                 'indexName' => $indexName,
 69 |                 'query' => $query->getQueryString(),
 70 |                 'facets' => [$activeFilter->getProperty()],
 71 |                 'filters' => $this->formatFilters($otherFilters),
 72 |             ];
 73 |         }
 74 | 
 75 |         return $queries;
 76 |     }
 77 | 
 78 |     /**
 79 |      * @param FilterInterface[] $filters
 80 |      */
 81 |     private function formatFilters(array $filters): string
 82 |     {
 83 |         $formated = [];
 84 |         foreach ($filters as $filter) {
 85 |             switch ($filter::class) {
 86 |                 case TermFilter::class:
 87 |                     $or = [];
 88 |                     foreach ($filter->getValues() as $value) {
 89 |                         $or[] = \sprintf('%s:"%s"', $filter->getProperty(), addslashes((string) $value));
 90 |                     }
 91 | 
 92 |                     $formated[] = implode(' OR ', $or);
 93 |                     break;
 94 |                 case RangeFilter::class:
 95 |                     if ($filter->getMin()) {
 96 |                         $formated[] = \sprintf('%s >= %d', $filter->getProperty(), $filter->getMin());
 97 |                     }
 98 | 
 99 |                     if ($filter->getMax()) {
100 |                         $formated[] = \sprintf('%s <= %d', $filter->getProperty(), $filter->getMax());
101 |                     }
102 | 
103 |                     break;
104 |                 default:
105 |                     throw new \Exception(\sprintf('Facet filter "%s" not supported', $filter::class));
106 |             }
107 |         }
108 | 
109 |         return implode(' AND ', $formated);
110 |     }
111 | }
112 | 


--------------------------------------------------------------------------------
/src/Adapter/Doctrine/DoctrineAdapter.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /*
  4 |  * This file is part of the UxSearch project.
  5 |  *
  6 |  * (c) Mezcalito (https://www.mezcalito.fr)
  7 |  *
  8 |  * For the full copyright and license information, please view the LICENSE
  9 |  * file that was distributed with this source code.
 10 |  */
 11 | 
 12 | declare(strict_types=1);
 13 | 
 14 | namespace Mezcalito\UxSearchBundle\Adapter\Doctrine;
 15 | 
 16 | use Doctrine\ORM\EntityManagerInterface;
 17 | use Doctrine\ORM\QueryBuilder;
 18 | use Doctrine\ORM\Tools\Pagination\Paginator;
 19 | use Mezcalito\UxSearchBundle\Adapter\AdapterInterface;
 20 | use Mezcalito\UxSearchBundle\Search\Filter\RangeFilter;
 21 | use Mezcalito\UxSearchBundle\Search\Filter\TermFilter;
 22 | use Mezcalito\UxSearchBundle\Search\Query;
 23 | use Mezcalito\UxSearchBundle\Search\ResultSet\FacetStat;
 24 | use Mezcalito\UxSearchBundle\Search\ResultSet\FacetTermDistribution;
 25 | use Mezcalito\UxSearchBundle\Search\ResultSet\Hit;
 26 | use Mezcalito\UxSearchBundle\Search\ResultSet\ResultSet;
 27 | use Mezcalito\UxSearchBundle\Search\SearchInterface;
 28 | use Symfony\Component\OptionsResolver\OptionsResolver;
 29 | 
 30 | readonly class DoctrineAdapter implements AdapterInterface
 31 | {
 32 |     public const string MAX_FACET_VALUES_PARAM = 'maxFacetValues';
 33 | 
 34 |     public const string QUERY_BUILDER_ALIAS = 'queryBuilderAlias';
 35 | 
 36 |     public const string QUERY_BUILDER = 'queryBuilder';
 37 | 
 38 |     public const string SEARCH_FIELDS = 'searchFields';
 39 | 
 40 |     public function __construct(private EntityManagerInterface $manager)
 41 |     {
 42 |     }
 43 | 
 44 |     public function search(Query $query, SearchInterface $search): ResultSet
 45 |     {
 46 |         $helper = new QueryBuilderHelper($this->manager, $query, $search);
 47 | 
 48 |         $paginator = new Paginator($helper->getResultsQuery()->getQuery(), fetchJoinCollection: true);
 49 |         $hits = [];
 50 |         foreach ($paginator as $item) {
 51 |             $hits[] = new Hit($item, 1);
 52 |         }
 53 | 
 54 |         $total = $helper->getTotalResultsQuery()->getQuery()->getSingleScalarResult();
 55 | 
 56 |         return (new ResultSet())
 57 |             ->setIndexUid($search->getIndexName())
 58 |             ->setHits($hits)
 59 |             ->setFacetDistributions($this->getFacetDistributions($query, $search))
 60 |             ->setFacetStats($this->getFacetStats($query, $search))
 61 |             ->setTotalResults($total);
 62 |     }
 63 | 
 64 |     public function configureParameters(OptionsResolver $resolver): void
 65 |     {
 66 |         $resolver->setDefaults([
 67 |             self::MAX_FACET_VALUES_PARAM => 100,
 68 |             self::QUERY_BUILDER_ALIAS => 'o',
 69 |             self::QUERY_BUILDER => function (QueryBuilder $queryBuilder) {},
 70 |             self::SEARCH_FIELDS => [],
 71 |         ]);
 72 | 
 73 |         $resolver->setAllowedTypes(self::MAX_FACET_VALUES_PARAM, 'int');
 74 |         $resolver->setAllowedTypes(self::QUERY_BUILDER_ALIAS, 'string');
 75 |         $resolver->setAllowedTypes(self::QUERY_BUILDER, 'Closure');
 76 |         $resolver->setAllowedTypes(self::SEARCH_FIELDS, 'string[]');
 77 |     }
 78 | 
 79 |     private function getFacetDistributions(Query $query, SearchInterface $search): array
 80 |     {
 81 |         $distributions = [];
 82 | 
 83 |         $helper = new QueryBuilderHelper($this->manager, $query, $search);
 84 | 
 85 |         foreach ($search->getFacets() as $facet) {
 86 |             $filter = $query->getActiveFilter($facet->getProperty());
 87 |             $checkedValues = [];
 88 |             if ($filter instanceof TermFilter) {
 89 |                 $checkedValues = $filter->getValues();
 90 |             }
 91 | 
 92 |             $checkedFacets = [];
 93 |             $uncheckedFacets = [];
 94 |             $qb = $helper->getFacetTermQuery($facet);
 95 |             foreach ($qb->getQuery()->getArrayResult() as $row) {
 96 |                 $rowValue = $row['value'] instanceof \BackedEnum ? $row['value']->value : $row['value'];
 97 | 
 98 |                 if (\in_array($rowValue, $checkedValues)) {
 99 |                     $checkedFacets[$rowValue] = $row['total'];
100 |                 } else {
101 |                     $uncheckedFacets[$rowValue] = $row['total'];
102 |                 }
103 |             }
104 | 
105 |             $values = $checkedFacets + $uncheckedFacets;
106 | 
107 |             $distributions[] = (new FacetTermDistribution())
108 |                 ->setProperty($facet->getProperty())
109 |                 ->setValues($values)
110 |                 ->setCheckedValues($checkedValues);
111 |         }
112 | 
113 |         return $distributions;
114 |     }
115 | 
116 |     private function getFacetStats(Query $query, SearchInterface $search): array
117 |     {
118 |         $stats = [];
119 | 
120 |         $helper = new QueryBuilderHelper($this->manager, $query, $search);
121 | 
122 |         foreach ($search->getFacets() as $facet) {
123 |             $filter = $query->getActiveFilter($facet->getProperty());
124 | 
125 |             $userMin = null;
126 |             $userMax = null;
127 |             if ($filter instanceof RangeFilter) {
128 |                 $userMin = $filter->getMin();
129 |                 $userMax = $filter->getMax();
130 |             }
131 | 
132 |             $qb = $helper->getFacetStatsQuery($facet);
133 | 
134 |             $rs = $qb->getQuery()->getArrayResult()[0];
135 | 
136 |             if (\is_string($rs['min']) || \is_string($rs['max'])) {
137 |                 continue;
138 |             }
139 | 
140 |             $stats[] = (new FacetStat(
141 |                 property: $facet->getProperty(),
142 |                 min: $rs['min'] ?? 0,
143 |                 max: $rs['max'] ?? 0,
144 |                 userMin: $userMin,
145 |                 userMax: $userMax
146 |             ));
147 |         }
148 | 
149 |         return $stats;
150 |     }
151 | }
152 | 


--------------------------------------------------------------------------------
/src/Adapter/Doctrine/DoctrineFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Adapter\Doctrine;
15 | 
16 | use Doctrine\ORM\EntityManager;
17 | use Doctrine\Persistence\ManagerRegistry;
18 | use Mezcalito\UxSearchBundle\Adapter\AdapterFactoryInterface;
19 | use Mezcalito\UxSearchBundle\Adapter\AdapterInterface;
20 | use Mezcalito\UxSearchBundle\Exception\DoctrineAdapterException;
21 | 
22 | readonly class DoctrineFactory implements AdapterFactoryInterface
23 | {
24 |     public function __construct(private ?ManagerRegistry $managerRegistry = null)
25 |     {
26 |     }
27 | 
28 |     public function support(string $dsn): bool
29 |     {
30 |         return str_starts_with($dsn, 'doctrine');
31 |     }
32 | 
33 |     public function createAdapter(string $dsn): AdapterInterface
34 |     {
35 |         if (!$this->managerRegistry instanceof ManagerRegistry) {
36 |             throw new \LogicException(\sprintf('You cannot use the "%s" as Doctrine ORM is not installed. Try running "composer require symfony/orm-pack".', self::class));
37 |         }
38 | 
39 |         $parsedDsn = parse_url($dsn);
40 |         $managerName = $parsedDsn['host'] ?? 'default';
41 | 
42 |         $manager = $this->managerRegistry->getManager($managerName);
43 | 
44 |         if (!$manager instanceof EntityManager) {
45 |             throw DoctrineAdapterException::isNotOrmManager($managerName);
46 |         }
47 | 
48 |         return new DoctrineAdapter($manager);
49 |     }
50 | }
51 | 


--------------------------------------------------------------------------------
/src/Adapter/Doctrine/QueryBuilderHelper.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /*
  4 |  * This file is part of the UxSearch project.
  5 |  *
  6 |  * (c) Mezcalito (https://www.mezcalito.fr)
  7 |  *
  8 |  * For the full copyright and license information, please view the LICENSE
  9 |  * file that was distributed with this source code.
 10 |  */
 11 | 
 12 | declare(strict_types=1);
 13 | 
 14 | namespace Mezcalito\UxSearchBundle\Adapter\Doctrine;
 15 | 
 16 | use Doctrine\ORM\EntityManagerInterface;
 17 | use Doctrine\ORM\QueryBuilder;
 18 | use Mezcalito\UxSearchBundle\Search\Facet;
 19 | use Mezcalito\UxSearchBundle\Search\Filter\FilterInterface;
 20 | use Mezcalito\UxSearchBundle\Search\Filter\RangeFilter;
 21 | use Mezcalito\UxSearchBundle\Search\Filter\TermFilter;
 22 | use Mezcalito\UxSearchBundle\Search\Query;
 23 | use Mezcalito\UxSearchBundle\Search\SearchInterface;
 24 | 
 25 | use function Symfony\Component\String\u;
 26 | 
 27 | readonly class QueryBuilderHelper
 28 | {
 29 |     public function __construct(
 30 |         private EntityManagerInterface $manager,
 31 |         private Query $query,
 32 |         private SearchInterface $search,
 33 |     ) {
 34 |     }
 35 | 
 36 |     public function getTotalResultsQuery(): QueryBuilder
 37 |     {
 38 |         $qb = $this->createBaseQueryBuilder()
 39 |             ->select(\sprintf('count(DISTINCT (%s)) AS total', $this->getIdentifierField()));
 40 | 
 41 |         $this->applyQueryString($qb);
 42 | 
 43 |         foreach ($this->query->getActiveFilters() as $filter) {
 44 |             $this->applyFilter($qb, $filter);
 45 |         }
 46 | 
 47 |         return $qb;
 48 |     }
 49 | 
 50 |     public function getResultsQuery(): QueryBuilder
 51 |     {
 52 |         $qb = $this->createBaseQueryBuilder();
 53 |         $this->applyPagination($qb);
 54 |         $this->applySort($qb);
 55 |         $this->applyQueryString($qb);
 56 | 
 57 |         foreach ($this->query->getActiveFilters() as $filter) {
 58 |             $this->applyFilter($qb, $filter);
 59 |         }
 60 | 
 61 |         return $qb;
 62 |     }
 63 | 
 64 |     public function getFacetTermQuery(Facet $facet): QueryBuilder
 65 |     {
 66 |         $qb = $this->createBaseQueryBuilder();
 67 | 
 68 |         [$alias, $property] = $this->extractAliasAndProperty($facet->getProperty());
 69 |         $this->updateQueryBuilderAssociations($qb, $alias);
 70 | 
 71 |         $qb
 72 |             ->select(\sprintf('%s.%s as value, count(%s.%s) AS total', $alias, $property, $alias, $property))
 73 |             ->orderBy('total', 'desc')
 74 |             ->groupBy(\sprintf('%s.%s', $alias, $property))
 75 |             ->setMaxResults($this->search->getResolvedAdapterParameter(DoctrineAdapter::MAX_FACET_VALUES_PARAM));
 76 | 
 77 |         $this->applyQueryString($qb);
 78 | 
 79 |         foreach ($this->query->getActiveFilters() as $filter) {
 80 |             if ($filter->getProperty() === $facet->getProperty()) {
 81 |                 continue;
 82 |             }
 83 | 
 84 |             $this->applyFilter($qb, $filter);
 85 |         }
 86 | 
 87 |         return $qb;
 88 |     }
 89 | 
 90 |     public function getFacetStatsQuery(mixed $facet): QueryBuilder
 91 |     {
 92 |         $qb = $this->createBaseQueryBuilder();
 93 | 
 94 |         [$alias, $property] = $this->extractAliasAndProperty($facet->getProperty());
 95 |         $this->updateQueryBuilderAssociations($qb, $alias);
 96 | 
 97 |         $qb
 98 |             ->select(\sprintf('min(%s.%s) as min, max(%s.%s) AS max', $alias, $property, $alias, $property));
 99 | 
100 |         $this->applyQueryString($qb);
101 | 
102 |         foreach ($this->query->getActiveFilters() as $filter) {
103 |             if ($filter->getProperty() === $facet->getProperty()) {
104 |                 continue;
105 |             }
106 | 
107 |             $this->applyFilter($qb, $filter);
108 |         }
109 | 
110 |         return $qb;
111 |     }
112 | 
113 |     private function createBaseQueryBuilder(): QueryBuilder
114 |     {
115 |         $qb = $this->manager
116 |             ->getRepository($this->search->getIndexName())
117 |             ->createQueryBuilder($this->search->getResolvedAdapterParameter(DoctrineAdapter::QUERY_BUILDER_ALIAS));
118 | 
119 |         $this->search->getResolvedAdapterParameter(DoctrineAdapter::QUERY_BUILDER)($qb);
120 | 
121 |         return $qb;
122 |     }
123 | 
124 |     private function extractAliasAndProperty(string $property): array
125 |     {
126 |         if (str_contains($property, '.')) {
127 |             return explode('.', $property);
128 |         }
129 | 
130 |         return ['o', $property];
131 |     }
132 | 
133 |     private function updateQueryBuilderAssociations(QueryBuilder $qb, string $alias): void
134 |     {
135 |         if ('o' === $alias) {
136 |             return;
137 |         }
138 | 
139 |         $metadata = $this->manager->getClassMetadata($this->search->getIndexName());
140 |         if (\array_key_exists($alias, $metadata->associationMappings) && !\in_array($alias, $qb->getAllAliases(), true)) {
141 |             $qb->leftJoin('o.'.$alias, $alias);
142 |         }
143 |     }
144 | 
145 |     private function getIdentifierField(): string
146 |     {
147 |         $metadata = $this->manager->getClassMetadata($this->search->getIndexName());
148 | 
149 |         return \sprintf('%s.%s',
150 |             $this->search->getResolvedAdapterParameter(DoctrineAdapter::QUERY_BUILDER_ALIAS),
151 |             $metadata->getIdentifier()[0]
152 |         );
153 |     }
154 | 
155 |     private function applyFilter(QueryBuilder $qb, FilterInterface $filter)
156 |     {
157 |         [$alias, $property] = $this->extractAliasAndProperty($filter->getProperty());
158 |         $this->updateQueryBuilderAssociations($qb, $alias);
159 | 
160 |         if ($filter instanceof TermFilter && $filter->hasValues()) {
161 |             $parameterName = u(\sprintf('%s_%s_terms', $alias, $property))->snake()->toString();
162 | 
163 |             $qb->andWhere(\sprintf('%s.%s in (:%s)', $alias, $property, $parameterName));
164 |             $qb->setParameter($parameterName, array_values($filter->getValues()));
165 |         }
166 | 
167 |         if ($filter instanceof RangeFilter && $filter->getMax()) {
168 |             $parameterName = u(\sprintf('%s_%s_max', $alias, $property))->snake()->toString();
169 |             $qb->andWhere(\sprintf('%s.%s <= :%s ', $alias, $property, $parameterName));
170 |             $qb->setParameter($parameterName, $filter->getMax());
171 |         }
172 | 
173 |         if ($filter instanceof RangeFilter && $filter->getMin()) {
174 |             $parameterName = u(\sprintf('%s_%s_min', $alias, $property))->snake()->toString();
175 |             $qb->andWhere(\sprintf('%s.%s >= :%s', $alias, $property, $parameterName));
176 |             $qb->setParameter($parameterName, $filter->getMin());
177 |         }
178 |     }
179 | 
180 |     private function applyPagination(QueryBuilder $qb): void
181 |     {
182 |         $qb
183 |             ->setFirstResult($this->query->getActiveHitsPerPage() * ($this->query->getCurrentPage() - 1))
184 |             ->setMaxResults($this->query->getActiveHitsPerPage());
185 |     }
186 | 
187 |     private function applySort(QueryBuilder $qb): void
188 |     {
189 |         if ($this->query->getActiveSort()) {
190 |             [$sort, $order] = explode(':', $this->query->getActiveSort());
191 |             $qb->orderBy($sort, $order);
192 |         }
193 |     }
194 | 
195 |     private function applyQueryString(QueryBuilder $qb)
196 |     {
197 |         $fields = $this->search->getResolvedAdapterParameter(DoctrineAdapter::SEARCH_FIELDS);
198 |         if ('' === $this->query->getQueryString() || 0 === \count($fields)) {
199 |             return;
200 |         }
201 | 
202 |         $orX = $qb->expr()->orX();
203 |         foreach ($fields as $fieldName) {
204 |             $orX->add(\sprintf('%s like :queryString', $fieldName));
205 |         }
206 | 
207 |         $qb->add('where', $orX);
208 | 
209 |         $qb->setParameter('queryString', \sprintf('%%%s%%', $this->query->getQueryString()));
210 |     }
211 | }
212 | 


--------------------------------------------------------------------------------
/src/Adapter/Meilisearch/MeilisearchAdapter.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /*
  4 |  * This file is part of the UxSearch project.
  5 |  *
  6 |  * (c) Mezcalito (https://www.mezcalito.fr)
  7 |  *
  8 |  * For the full copyright and license information, please view the LICENSE
  9 |  * file that was distributed with this source code.
 10 |  */
 11 | 
 12 | declare(strict_types=1);
 13 | 
 14 | namespace Mezcalito\UxSearchBundle\Adapter\Meilisearch;
 15 | 
 16 | use Meilisearch\Client;
 17 | use Mezcalito\UxSearchBundle\Adapter\AbstractAdapter;
 18 | use Mezcalito\UxSearchBundle\Search\Query;
 19 | use Mezcalito\UxSearchBundle\Search\ResultSet\Hit;
 20 | use Mezcalito\UxSearchBundle\Search\ResultSet\ResultSet;
 21 | use Mezcalito\UxSearchBundle\Search\SearchInterface;
 22 | use Symfony\Component\OptionsResolver\OptionsResolver;
 23 | 
 24 | class MeilisearchAdapter extends AbstractAdapter
 25 | {
 26 |     public const string ATTRIBUTES_TO_RETRIEVE_PARAM = 'attributesToRetrieve';
 27 | 
 28 |     public const string ATTRIBUTES_TO_CROP_PARAM = 'attributesToCrop';
 29 | 
 30 |     public const string CROP_LENGTH_PARAM = 'cropLength';
 31 | 
 32 |     public const string CROP_MARKER_PARAM = 'cropMarker';
 33 | 
 34 |     public const string ATTRIBUTES_TO_HIGHLIGHT_PARAM = 'attributesToHighlight';
 35 | 
 36 |     public const string HIGHLIGHT_PRE_TAG_PARAM = 'highlightPreTag';
 37 | 
 38 |     public const string HIGHLIGHT_POST_TAG_PARAM = 'highlightPostTag';
 39 | 
 40 |     public function __construct(
 41 |         private readonly Client $client,
 42 |         private readonly QueryBuilder $queryBuilder,
 43 |     ) {
 44 |     }
 45 | 
 46 |     public function getFacetDistributionKey(): string
 47 |     {
 48 |         return 'facetDistribution';
 49 |     }
 50 | 
 51 |     public function getFacetStatsKey(): string
 52 |     {
 53 |         return 'facetStats';
 54 |     }
 55 | 
 56 |     public function search(Query $query, SearchInterface $search): ResultSet
 57 |     {
 58 |         $queries = $this->queryBuilder->build($query, $search);
 59 | 
 60 |         $results = $this->client->multiSearch($queries);
 61 | 
 62 |         $resultsToProcess = $results['results'][0];
 63 | 
 64 |         $hits = [];
 65 |         foreach ($resultsToProcess['hits'] as $hit) {
 66 |             $hits[] = new Hit($hit, $hit['_rankingScore']);
 67 |         }
 68 | 
 69 |         [$facetsDistributions, $facetStats] = $this->getFacets($results, $search, $query);
 70 | 
 71 |         return (new ResultSet())
 72 |             ->setIndexUid($resultsToProcess['indexUid'])
 73 |             ->setHits($hits)
 74 |             ->setTotalResults($resultsToProcess['totalHits'])
 75 |             ->setFacetDistributions($facetsDistributions)
 76 |             ->setFacetStats($facetStats)
 77 |         ;
 78 |     }
 79 | 
 80 |     public function configureParameters(OptionsResolver $resolver): void
 81 |     {
 82 |         $resolver->setDefaults([
 83 |             self::ATTRIBUTES_TO_RETRIEVE_PARAM => ['*'],
 84 |             self::ATTRIBUTES_TO_CROP_PARAM => [],
 85 |             self::CROP_LENGTH_PARAM => 10,
 86 |             self::CROP_MARKER_PARAM => '...',
 87 |             self::ATTRIBUTES_TO_HIGHLIGHT_PARAM => [],
 88 |             self::HIGHLIGHT_PRE_TAG_PARAM => '<em>',
 89 |             self::HIGHLIGHT_POST_TAG_PARAM => '</em>',
 90 |         ]);
 91 | 
 92 |         $resolver->setAllowedTypes(self::ATTRIBUTES_TO_RETRIEVE_PARAM, 'string[]');
 93 |         $resolver->setAllowedTypes(self::ATTRIBUTES_TO_CROP_PARAM, 'string[]');
 94 |         $resolver->setAllowedTypes(self::CROP_LENGTH_PARAM, 'int');
 95 |         $resolver->setAllowedTypes(self::CROP_MARKER_PARAM, 'string');
 96 |         $resolver->setAllowedTypes(self::ATTRIBUTES_TO_HIGHLIGHT_PARAM, 'string[]');
 97 |         $resolver->setAllowedTypes(self::HIGHLIGHT_PRE_TAG_PARAM, 'string');
 98 |         $resolver->setAllowedTypes(self::HIGHLIGHT_POST_TAG_PARAM, 'string');
 99 |     }
100 | }
101 | 


--------------------------------------------------------------------------------
/src/Adapter/Meilisearch/MeilisearchFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Adapter\Meilisearch;
15 | 
16 | use Meilisearch\Client;
17 | use Mezcalito\UxSearchBundle\Adapter\AdapterFactoryInterface;
18 | use Mezcalito\UxSearchBundle\Adapter\AdapterInterface;
19 | use Psr\Http\Client\ClientInterface;
20 | 
21 | readonly class MeilisearchFactory implements AdapterFactoryInterface
22 | {
23 |     public function __construct(private ClientInterface $httpClient)
24 |     {
25 |     }
26 | 
27 |     public function support(string $dsn): bool
28 |     {
29 |         return str_starts_with($dsn, 'meilisearch');
30 |     }
31 | 
32 |     public function createAdapter(string $dsn): AdapterInterface
33 |     {
34 |         return new MeilisearchAdapter($this->createClient($dsn), new QueryBuilder());
35 |     }
36 | 
37 |     public function createClient(string $dsn): Client
38 |     {
39 |         if (!class_exists(Client::class)) {
40 |             throw new \LogicException(\sprintf('You cannot use the "%s" as Meilisearch Client is not installed. Try running "composer require meilisearch/meilisearch-php".', self::class));
41 |         }
42 | 
43 |         $parsedDsn = parse_url($dsn);
44 |         parse_str($parsedDsn['query'] ?? '', $params);
45 | 
46 |         $tls = !isset($params['tls']) || 'true' === $params['tls'];
47 | 
48 |         $url = \sprintf('%s://%s:%s',
49 |             $tls ? 'https' : 'http',
50 |             $parsedDsn['host'] ?? 'localhost',
51 |             $parsedDsn['port'] ?? '7700',
52 |         );
53 | 
54 |         return new Client($url, $parsedDsn['user'] ?? null, $this->httpClient);
55 |     }
56 | }
57 | 


--------------------------------------------------------------------------------
/src/Adapter/Meilisearch/QueryBuilder.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /*
  4 |  * This file is part of the UxSearch project.
  5 |  *
  6 |  * (c) Mezcalito (https://www.mezcalito.fr)
  7 |  *
  8 |  * For the full copyright and license information, please view the LICENSE
  9 |  * file that was distributed with this source code.
 10 |  */
 11 | 
 12 | declare(strict_types=1);
 13 | 
 14 | namespace Mezcalito\UxSearchBundle\Adapter\Meilisearch;
 15 | 
 16 | use Meilisearch\Contracts\SearchQuery;
 17 | use Mezcalito\UxSearchBundle\Search\Filter\FilterInterface;
 18 | use Mezcalito\UxSearchBundle\Search\Filter\RangeFilter;
 19 | use Mezcalito\UxSearchBundle\Search\Filter\TermFilter;
 20 | use Mezcalito\UxSearchBundle\Search\Query;
 21 | use Mezcalito\UxSearchBundle\Search\SearchInterface;
 22 | 
 23 | class QueryBuilder
 24 | {
 25 |     public function build(Query $query, SearchInterface $search): array
 26 |     {
 27 |         $options = $search->getResolvedAdapterParameters();
 28 | 
 29 |         $hitsPerPage = $query->getActiveHitsPerPage();
 30 |         $queries = [];
 31 | 
 32 |         $formatedSorting = $query->getActiveSort() ? [$query->getActiveSort()] : [];
 33 |         $displayedFacets = [];
 34 | 
 35 |         foreach ($search->getFacets() as $facet) {
 36 |             $displayedFacets[] = $facet->getProperty();
 37 |         }
 38 | 
 39 |         $indexName = $search->getIndexName();
 40 | 
 41 |         $meilisearchQuery = (new SearchQuery())
 42 |             ->setIndexUid($indexName)
 43 |             ->setQuery($query->getQueryString())
 44 |             ->setFilter($this->formatFilters($query->getActiveFilters()))
 45 |             ->setSort($formatedSorting)
 46 |             ->setShowRankingScore(true)
 47 |             ->setHitsPerPage($hitsPerPage)
 48 |             ->setPage($query->getCurrentPage())
 49 |             ->setAttributesToRetrieve($options['attributesToRetrieve'])
 50 |             ->setAttributesToCrop($options['attributesToCrop'])
 51 |             ->setCropLength($options['cropLength'])
 52 |             ->setCropMarker($options['cropMarker'])
 53 |             ->setAttributesToHighlight($options['attributesToHighlight'])
 54 |             ->setHighlightPreTag($options['highlightPreTag'])
 55 |             ->setHighlightPostTag($options['highlightPostTag'])
 56 |         ;
 57 | 
 58 |         if ([] !== $displayedFacets) {
 59 |             $meilisearchQuery->setFacets($displayedFacets);
 60 |         }
 61 | 
 62 |         $queries[] = $meilisearchQuery;
 63 | 
 64 |         $activeFilters = $query->getActiveFilters();
 65 | 
 66 |         foreach ($activeFilters as $activeFilter) {
 67 |             $otherFilters = [];
 68 |             foreach ($activeFilters as $filter) {
 69 |                 if ($filter->getProperty() !== $activeFilter->getProperty()) {
 70 |                     $otherFilters[] = $filter;
 71 |                 }
 72 |             }
 73 | 
 74 |             $queries[] = (new SearchQuery())
 75 |                 ->setIndexUid($indexName)
 76 |                 ->setQuery($query->getQueryString())
 77 |                 ->setFacets([$activeFilter->getProperty()])
 78 |                 ->setFilter($this->formatFilters($otherFilters))
 79 |                 ->setLimit(0);
 80 |         }
 81 | 
 82 |         return $queries;
 83 |     }
 84 | 
 85 |     /**
 86 |      * @param FilterInterface[] $filters
 87 |      */
 88 |     private function formatFilters(array $filters): array
 89 |     {
 90 |         $formated = [];
 91 |         foreach ($filters as $filter) {
 92 |             switch ($filter::class) {
 93 |                 case TermFilter::class:
 94 |                     $or = [];
 95 |                     foreach ($filter->getValues() as $value) {
 96 |                         $or[] = \sprintf('%s = "%s"', $filter->getProperty(), addslashes((string) $value));
 97 |                     }
 98 | 
 99 |                     $formated[] = $or;
100 |                     break;
101 |                 case RangeFilter::class:
102 |                     if ($filter->getMin()) {
103 |                         $formated[] = \sprintf('%s >= %d', $filter->getProperty(), $filter->getMin());
104 |                     }
105 | 
106 |                     if ($filter->getMax()) {
107 |                         $formated[] = \sprintf('%s <= %d', $filter->getProperty(), $filter->getMax());
108 |                     }
109 | 
110 |                     break;
111 |                 default:
112 |                     throw new \Exception(\sprintf('Facet filter "%s" not supported', $filter::class));
113 |             }
114 |         }
115 | 
116 |         return $formated;
117 |     }
118 | }
119 | 


--------------------------------------------------------------------------------
/src/Attribute/AsSearch.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Attribute;
15 | 
16 | #[\Attribute(\Attribute::TARGET_CLASS)]
17 | class AsSearch
18 | {
19 |     public function __construct(public string $index, public ?string $name = null, public ?string $adapter = null)
20 |     {
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Context/Context.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Context;
15 | 
16 | use Mezcalito\UxSearchBundle\Search\Query;
17 | use Mezcalito\UxSearchBundle\Search\ResultSet\ResultSet;
18 | use Mezcalito\UxSearchBundle\Search\SearchInterface;
19 | 
20 | class Context
21 | {
22 |     private Query $query;
23 | 
24 |     private SearchInterface $search;
25 | 
26 |     private ?ResultSet $results = null;
27 | 
28 |     public function getQuery(): Query
29 |     {
30 |         return $this->query;
31 |     }
32 | 
33 |     public function setQuery(Query $query): static
34 |     {
35 |         $this->query = $query;
36 | 
37 |         return $this;
38 |     }
39 | 
40 |     public function getSearch(): SearchInterface
41 |     {
42 |         return $this->search;
43 |     }
44 | 
45 |     public function setSearch(SearchInterface $search): static
46 |     {
47 |         $this->search = $search;
48 | 
49 |         return $this;
50 |     }
51 | 
52 |     public function getResults(): ?ResultSet
53 |     {
54 |         return $this->results;
55 |     }
56 | 
57 |     public function setResults(?ResultSet $results): static
58 |     {
59 |         $this->results = $results;
60 | 
61 |         return $this;
62 |     }
63 | }
64 | 


--------------------------------------------------------------------------------
/src/Context/ContextProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Context;
15 | 
16 | use Mezcalito\UxSearchBundle\Exception\ContextException;
17 | use Mezcalito\UxSearchBundle\Search\Query;
18 | use Mezcalito\UxSearchBundle\Search\SearchInterface;
19 | 
20 | class ContextProvider
21 | {
22 |     private ?Context $context = null;
23 | 
24 |     public function init(Query $query, SearchInterface $search): void
25 |     {
26 |         $this->context = (new Context())
27 |             ->setQuery($query)
28 |             ->setSearch($search)
29 |         ;
30 |     }
31 | 
32 |     public function hasCurrentContext(): bool
33 |     {
34 |         return $this->context instanceof Context;
35 |     }
36 | 
37 |     public function getCurrentContext(): Context
38 |     {
39 |         if (!$this->hasCurrentContext()) {
40 |             throw ContextException::contextNotInitialized();
41 |         }
42 | 
43 |         return $this->context;
44 |     }
45 | }
46 | 


--------------------------------------------------------------------------------
/src/DependencyInjection/AdapterFactoryPass.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\DependencyInjection;
15 | 
16 | use Mezcalito\UxSearchBundle\Adapter\AdapterProvider;
17 | use Symfony\Component\DependencyInjection\Argument\IteratorArgument;
18 | use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
19 | use Symfony\Component\DependencyInjection\Compiler\PriorityTaggedServiceTrait;
20 | use Symfony\Component\DependencyInjection\ContainerBuilder;
21 | use Symfony\Component\DependencyInjection\Reference;
22 | 
23 | class AdapterFactoryPass implements CompilerPassInterface
24 | {
25 |     use PriorityTaggedServiceTrait;
26 | 
27 |     public function process(ContainerBuilder $container): void
28 |     {
29 |         $taggedServices = $container->findTaggedServiceIds('mezcalito_ux_search.adapter_factory');
30 | 
31 |         $factories = array_map(fn ($fqcn) => new Reference($fqcn), array_keys($taggedServices));
32 | 
33 |         $container
34 |             ->getDefinition(AdapterProvider::class)
35 |             ->setArgument('$factories', new IteratorArgument($factories))
36 |         ;
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/src/DependencyInjection/RegisterSearchPass.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\DependencyInjection;
15 | 
16 | use Mezcalito\UxSearchBundle\Search\SearchProvider;
17 | use Symfony\Component\DependencyInjection\Argument\IteratorArgument;
18 | use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
19 | use Symfony\Component\DependencyInjection\Compiler\PriorityTaggedServiceTrait;
20 | use Symfony\Component\DependencyInjection\ContainerBuilder;
21 | use Symfony\Component\DependencyInjection\Reference;
22 | 
23 | class RegisterSearchPass implements CompilerPassInterface
24 | {
25 |     use PriorityTaggedServiceTrait;
26 | 
27 |     public function process(ContainerBuilder $container): void
28 |     {
29 |         $taggedServices = $container->findTaggedServiceIds('mezcalito_ux_search.search');
30 |         $listSearchTypes = array_combine(
31 |             array_map(fn ($attr) => $attr[0]['name'], $taggedServices),
32 |             array_map(fn ($fqcn) => new Reference($fqcn), array_keys($taggedServices))
33 |         );
34 | 
35 |         $container
36 |             ->getDefinition(SearchProvider::class)
37 |             ->setArgument('$searchs', new IteratorArgument($listSearchTypes))
38 |         ;
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/DependencyInjection/UrlFormaterPass.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\DependencyInjection;
15 | 
16 | use Mezcalito\UxSearchBundle\Search\Url\UrlFormaterProvider;
17 | use Symfony\Component\DependencyInjection\Argument\IteratorArgument;
18 | use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
19 | use Symfony\Component\DependencyInjection\Compiler\PriorityTaggedServiceTrait;
20 | use Symfony\Component\DependencyInjection\ContainerBuilder;
21 | use Symfony\Component\DependencyInjection\Reference;
22 | 
23 | class UrlFormaterPass implements CompilerPassInterface
24 | {
25 |     use PriorityTaggedServiceTrait;
26 | 
27 |     public function process(ContainerBuilder $container): void
28 |     {
29 |         $taggedServices = $container->findTaggedServiceIds('mezcalito_ux_search.url_formater');
30 | 
31 |         $formaters = array_combine(
32 |             array_keys($taggedServices),
33 |             array_map(fn ($fqcn) => new Reference($fqcn), array_keys($taggedServices))
34 |         );
35 | 
36 |         $container
37 |             ->getDefinition(UrlFormaterProvider::class)
38 |             ->setArgument('$formaters', new IteratorArgument($formaters))
39 |         ;
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Event/PostSearchEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Event;
15 | 
16 | use Mezcalito\UxSearchBundle\Search\Query;
17 | use Mezcalito\UxSearchBundle\Search\ResultSet\ResultSet;
18 | use Mezcalito\UxSearchBundle\Search\SearchInterface;
19 | use Symfony\Contracts\EventDispatcher\Event;
20 | 
21 | class PostSearchEvent extends Event
22 | {
23 |     public function __construct(
24 |         private readonly Query $query,
25 |         private readonly SearchInterface $search,
26 |         private readonly ResultSet $resultSet,
27 |     ) {
28 |     }
29 | 
30 |     public function getQuery(): Query
31 |     {
32 |         return $this->query;
33 |     }
34 | 
35 |     public function getSearch(): SearchInterface
36 |     {
37 |         return $this->search;
38 |     }
39 | 
40 |     public function getResultSet(): ResultSet
41 |     {
42 |         return $this->resultSet;
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/src/Event/PreSearchEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Event;
15 | 
16 | use Mezcalito\UxSearchBundle\Search\Query;
17 | use Mezcalito\UxSearchBundle\Search\SearchInterface;
18 | use Symfony\Contracts\EventDispatcher\Event;
19 | 
20 | class PreSearchEvent extends Event
21 | {
22 |     public function __construct(
23 |         private readonly Query $query,
24 |         private readonly SearchInterface $search,
25 |     ) {
26 |     }
27 | 
28 |     public function getQuery(): Query
29 |     {
30 |         return $this->query;
31 |     }
32 | 
33 |     public function getSearch(): SearchInterface
34 |     {
35 |         return $this->search;
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/EventSubscriber/ContextSubscriber.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\EventSubscriber;
15 | 
16 | use Mezcalito\UxSearchBundle\Context\ContextProvider;
17 | use Mezcalito\UxSearchBundle\Event\PostSearchEvent;
18 | use Mezcalito\UxSearchBundle\Event\PreSearchEvent;
19 | use Symfony\Component\EventDispatcher\EventSubscriberInterface;
20 | 
21 | readonly class ContextSubscriber implements EventSubscriberInterface
22 | {
23 |     public function __construct(
24 |         private ContextProvider $contextProvider,
25 |     ) {
26 |     }
27 | 
28 |     public static function getSubscribedEvents(): array
29 |     {
30 |         return [
31 |             PreSearchEvent::class => 'onPreSearchEvent',
32 |             PostSearchEvent::class => 'onPostSearchEvent',
33 |         ];
34 |     }
35 | 
36 |     public function onPreSearchEvent(PreSearchEvent $event): void
37 |     {
38 |         $this->contextProvider->init($event->getQuery(), $event->getSearch());
39 |     }
40 | 
41 |     public function onPostSearchEvent(PostSearchEvent $event): void
42 |     {
43 |         $this->contextProvider->getCurrentContext()->setResults($event->getResultSet());
44 |     }
45 | }
46 | 


--------------------------------------------------------------------------------
/src/Exception/AdapterException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Exception;
15 | 
16 | class AdapterException extends \RuntimeException
17 | {
18 |     public static function configurationNotFound(string $name): self
19 |     {
20 |         return new self(\sprintf('Configuration for name "%s" is not found', $name));
21 |     }
22 | 
23 |     public static function factoryNotFound(string $name): self
24 |     {
25 |         return new self(\sprintf('Factory with "%s" support not found', $name));
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Exception/ContextException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Exception;
15 | 
16 | class ContextException extends \RuntimeException
17 | {
18 |     public static function contextNotInitialized(): self
19 |     {
20 |         return new self('Context is not initialized');
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Exception/DoctrineAdapterException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Exception;
15 | 
16 | class DoctrineAdapterException extends \RuntimeException
17 | {
18 |     public static function isNotOrmManager(string $name): self
19 |     {
20 |         return new self(\sprintf('Manager "%s" is not a EntityManager', $name));
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Exception/ResultSetException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Exception;
15 | 
16 | class ResultSetException extends \RuntimeException
17 | {
18 |     public static function facetDistributionNotFound(string $property): self
19 |     {
20 |         return new self(\sprintf('Facet distribution "%s" is not found', $property));
21 |     }
22 | 
23 |     public static function facetStatNotFound(string $property): self
24 |     {
25 |         return new self(\sprintf('Facet stat "%s" is not found', $property));
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Exception/SearchException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Exception;
15 | 
16 | class SearchException extends \RuntimeException
17 | {
18 |     public static function facetNotConfigured(string $property): self
19 |     {
20 |         return new self(\sprintf('Facet "%s" is not configured', $property));
21 |     }
22 | 
23 |     public static function nameNotFound(string $name): self
24 |     {
25 |         return new self(\sprintf('Search with name "%s" is not found', $name));
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Exception/UrlFormaterException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Exception;
15 | 
16 | class UrlFormaterException extends \RuntimeException
17 | {
18 |     public static function urlFormaterNotFound(string $fqcn): self
19 |     {
20 |         return new self(\sprintf('Url Formater with "%s" FQCN not found', $fqcn));
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Maker/MakeSearch.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /*
  4 |  * This file is part of the UxSearch project.
  5 |  *
  6 |  * (c) Mezcalito (https://www.mezcalito.fr)
  7 |  *
  8 |  * For the full copyright and license information, please view the LICENSE
  9 |  * file that was distributed with this source code.
 10 |  */
 11 | 
 12 | declare(strict_types=1);
 13 | 
 14 | namespace Mezcalito\UxSearchBundle\Maker;
 15 | 
 16 | use Mezcalito\UxSearchBundle\Attribute\AsSearch;
 17 | use Mezcalito\UxSearchBundle\Search\AbstractSearch;
 18 | use Symfony\Bundle\MakerBundle\ConsoleStyle;
 19 | use Symfony\Bundle\MakerBundle\DependencyBuilder;
 20 | use Symfony\Bundle\MakerBundle\Generator;
 21 | use Symfony\Bundle\MakerBundle\InputConfiguration;
 22 | use Symfony\Bundle\MakerBundle\Maker\AbstractMaker;
 23 | use Symfony\Bundle\MakerBundle\Str;
 24 | use Symfony\Component\Console\Command\Command;
 25 | use Symfony\Component\Console\Input\InputArgument;
 26 | use Symfony\Component\Console\Input\InputInterface;
 27 | 
 28 | class MakeSearch extends AbstractMaker
 29 | {
 30 |     private array $classesToBeImported = [];
 31 | 
 32 |     public static function getCommandName(): string
 33 |     {
 34 |         return 'make:search';
 35 |     }
 36 | 
 37 |     public static function getCommandDescription(): string
 38 |     {
 39 |         return 'Create a new search class';
 40 |     }
 41 | 
 42 |     public function configureCommand(Command $command, InputConfiguration $inputConfig): void
 43 |     {
 44 |         $command
 45 |             ->addArgument('name', InputArgument::OPTIONAL, \sprintf('Choose a search name (e.g. <fg=yellow>%sSearch</>)', Str::asClassName(Str::getRandomTerm())))
 46 |             ->addArgument('indexName', InputArgument::OPTIONAL, 'Define your index name or Doctrine entity FQCN (Post::class)')
 47 |         ;
 48 |     }
 49 | 
 50 |     public function generate(InputInterface $input, ConsoleStyle $io, Generator $generator): int
 51 |     {
 52 |         $searchName = trim((string) $input->getArgument('name'));
 53 |         $searchNameHasSearchSuffix = str_ends_with($searchName, 'Search');
 54 | 
 55 |         $indexName = trim((string) $input->getArgument('indexName'));
 56 |         $indexNameIsClassName = str_ends_with($indexName, '::class');
 57 | 
 58 |         $searchClassNameDetails = $generator->createClassNameDetails(
 59 |             $searchNameHasSearchSuffix ? substr($searchName, 0, -6) : $searchName,
 60 |             'Search\\',
 61 |             'Search'
 62 |         );
 63 | 
 64 |         $this->classesToBeImported = [
 65 |             AsSearch::class,
 66 |             AbstractSearch::class,
 67 |         ];
 68 | 
 69 |         if ($indexNameIsClassName) {
 70 |             $boundClassDetails = $generator->createClassNameDetails(
 71 |                 substr($indexName, 0, -7),
 72 |                 'Entity\\'
 73 |             );
 74 | 
 75 |             $this->addUseStatement($boundClassDetails->getFullName());
 76 |         }
 77 | 
 78 |         $generator->generateClass(
 79 |             $searchClassNameDetails->getFullName(),
 80 |             __DIR__.'/../../templates/skeleton/search.tpl.php',
 81 |             [
 82 |                 'use_statements' => $this->generateUse(),
 83 |                 'search_name' => $searchClassNameDetails->getShortName(),
 84 |                 'index_name' => $indexNameIsClassName ? \sprintf('%s::class', $boundClassDetails->getShortName()) : \sprintf("'%s'", $indexName),
 85 |             ]
 86 |         );
 87 | 
 88 |         $generator->writeChanges();
 89 | 
 90 |         $this->writeSuccessMessage($io);
 91 |         $io->text([
 92 |             'Next: open your new search class and customize it!',
 93 |             'Find the documentation at <fg=yellow>https://github.com/Mezcalito/ux-search/blob/0.x/docs/usage/customize-your-search.md</>',
 94 |         ]);
 95 | 
 96 |         return Command::SUCCESS;
 97 |     }
 98 | 
 99 |     public function configureDependencies(DependencyBuilder $dependencies): void
100 |     {
101 |     }
102 | 
103 |     // Override based on UseStatementGenerator::class because is @internal
104 |     public function generateUse(): string
105 |     {
106 |         $transformed = [];
107 |         foreach ($this->classesToBeImported as $key => $class) {
108 |             $transformedClass = str_replace('\\', ' ', $class);
109 |             if (!\in_array($transformedClass, $transformed, true)) {
110 |                 $transformed[$key] = $transformedClass;
111 |             }
112 |         }
113 | 
114 |         asort($transformed);
115 | 
116 |         $statements = '';
117 | 
118 |         foreach (array_keys($transformed) as $key) {
119 |             $importedClass = $this->classesToBeImported[$key];
120 | 
121 |             $statements .= \sprintf("use %s;\n", $importedClass);
122 |         }
123 | 
124 |         return $statements;
125 |     }
126 | 
127 |     public function addUseStatement(string $className): void
128 |     {
129 |         if (\in_array($className, $this->classesToBeImported, true)) {
130 |             return;
131 |         }
132 | 
133 |         $this->classesToBeImported[] = $className;
134 |     }
135 | }
136 | 


--------------------------------------------------------------------------------
/src/MezcalitoUxSearchBundle.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /*
  4 |  * This file is part of the UxSearch project.
  5 |  *
  6 |  * (c) Mezcalito (https://www.mezcalito.fr)
  7 |  *
  8 |  * For the full copyright and license information, please view the LICENSE
  9 |  * file that was distributed with this source code.
 10 |  */
 11 | 
 12 | declare(strict_types=1);
 13 | 
 14 | namespace Mezcalito\UxSearchBundle;
 15 | 
 16 | use Mezcalito\UxSearchBundle\Adapter\AdapterFactoryInterface;
 17 | use Mezcalito\UxSearchBundle\Attribute\AsSearch;
 18 | use Mezcalito\UxSearchBundle\DependencyInjection\AdapterFactoryPass;
 19 | use Mezcalito\UxSearchBundle\DependencyInjection\RegisterSearchPass;
 20 | use Mezcalito\UxSearchBundle\DependencyInjection\UrlFormaterPass;
 21 | use Mezcalito\UxSearchBundle\Search\Url\UrlFormaterInterface;
 22 | use Symfony\Component\AssetMapper\AssetMapperInterface;
 23 | use Symfony\Component\Config\Definition\Builder\ArrayNodeDefinition;
 24 | use Symfony\Component\Config\Definition\Configurator\DefinitionConfigurator;
 25 | use Symfony\Component\DependencyInjection\ChildDefinition;
 26 | use Symfony\Component\DependencyInjection\ContainerBuilder;
 27 | use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
 28 | use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
 29 | 
 30 | class MezcalitoUxSearchBundle extends AbstractBundle
 31 | {
 32 |     public function configure(DefinitionConfigurator $definition): void
 33 |     {
 34 |         /** @var ArrayNodeDefinition $rootNode */
 35 |         $rootNode = $definition->rootNode();
 36 |         $rootNode
 37 |             ->children()
 38 |                 ->scalarNode('default_adapter')->defaultValue('default')->end()
 39 |             ->end()
 40 |             ->children()
 41 |                 ->arrayNode('adapters')
 42 |                     ->isRequired()
 43 |                     ->normalizeKeys(false)
 44 |                     ->useAttributeAsKey('name')
 45 |                     ->arrayPrototype()
 46 |                         ->beforeNormalization()
 47 |                             ->ifString()
 48 |                             ->then(fn (string $v): array => ['dsn' => $v])
 49 |                         ->end()
 50 |                         ->children()
 51 |                             ->scalarNode('dsn')->isRequired()->end()
 52 |                         ->end()
 53 |                     ->end()
 54 |                 ->end()
 55 |             ->end()
 56 |         ;
 57 |     }
 58 | 
 59 |     public function loadExtension(array $config, ContainerConfigurator $container, ContainerBuilder $builder): void
 60 |     {
 61 |         $container->import('../config/services.php');
 62 | 
 63 |         $builder->setParameter('mezcalito_ux_search.default_adapter', $config['default_adapter']);
 64 |         $builder->setParameter('mezcalito_ux_search.adapters', $config['adapters']);
 65 | 
 66 |         $builder->registerAttributeForAutoconfiguration(AsSearch::class, static function (ChildDefinition $definition, AsSearch $attribute, \Reflector $reflector) {
 67 |             $tagAttributes = get_object_vars($attribute);
 68 |             if (null === $tagAttributes['name'] && $reflector instanceof \ReflectionClass) {
 69 |                 $tagAttributes['name'] = strtolower(str_replace('Search', '', $reflector->getShortName()));
 70 |             }
 71 | 
 72 |             $definition->addTag('mezcalito_ux_search.search', $tagAttributes);
 73 |         });
 74 | 
 75 |         $builder->registerForAutoconfiguration(AdapterFactoryInterface::class)->addTag('mezcalito_ux_search.adapter_factory');
 76 |         $builder->registerForAutoconfiguration(UrlFormaterInterface::class)->addTag('mezcalito_ux_search.url_formater');
 77 |     }
 78 | 
 79 |     public function build(ContainerBuilder $container): void
 80 |     {
 81 |         parent::build($container);
 82 | 
 83 |         $container->addCompilerPass(new RegisterSearchPass());
 84 |         $container->addCompilerPass(new AdapterFactoryPass());
 85 |         $container->addCompilerPass(new UrlFormaterPass());
 86 |     }
 87 | 
 88 |     public function prependExtension(ContainerConfigurator $container, ContainerBuilder $builder): void
 89 |     {
 90 |         $builder->prependExtensionConfig('twig_component', [
 91 |             'defaults' => [
 92 |                 'Mezcalito\UxSearchBundle\Twig\Components\\' => [
 93 |                     'template_directory' => '@MezcalitoUxSearch/',
 94 |                     'name_prefix' => 'Mezcalito:UxSearch',
 95 |                 ],
 96 |             ],
 97 |         ]);
 98 | 
 99 |         if ($this->isAssetMapperAvailable($builder)) {
100 |             $builder->prependExtensionConfig('framework', [
101 |                 'asset_mapper' => [
102 |                     'paths' => [
103 |                         __DIR__.'/../assets/dist' => '@mezcalito/ux-search',
104 |                     ],
105 |                 ],
106 |             ]);
107 |         }
108 |     }
109 | 
110 |     private function isAssetMapperAvailable(ContainerBuilder $builder): bool
111 |     {
112 |         if (!interface_exists(AssetMapperInterface::class)) {
113 |             return false;
114 |         }
115 | 
116 |         // check that FrameworkBundle 6.3 or higher is installed
117 |         $bundlesMetadata = $builder->getParameter('kernel.bundles_metadata');
118 |         if (!isset($bundlesMetadata['FrameworkBundle'])) {
119 |             return false;
120 |         }
121 | 
122 |         return is_file($bundlesMetadata['FrameworkBundle']['path'].'/Resources/config/asset_mapper.php');
123 |     }
124 | }
125 | 


--------------------------------------------------------------------------------
/src/Search/AbstractSearch.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /*
  4 |  * This file is part of the UxSearch project.
  5 |  *
  6 |  * (c) Mezcalito (https://www.mezcalito.fr)
  7 |  *
  8 |  * For the full copyright and license information, please view the LICENSE
  9 |  * file that was distributed with this source code.
 10 |  */
 11 | 
 12 | declare(strict_types=1);
 13 | 
 14 | namespace Mezcalito\UxSearchBundle\Search;
 15 | 
 16 | use Mezcalito\UxSearchBundle\Attribute\AsSearch;
 17 | use Mezcalito\UxSearchBundle\Exception\SearchException;
 18 | use Mezcalito\UxSearchBundle\Search\Url\DefaultUrlFormater;
 19 | use Symfony\Component\EventDispatcher\EventDispatcher;
 20 | use Symfony\Component\EventDispatcher\EventSubscriberInterface;
 21 | 
 22 | abstract class AbstractSearch implements SearchInterface
 23 | {
 24 |     /** @var int[] */
 25 |     private array $availableHitsPerPage = [12];
 26 | 
 27 |     /** @var Sort[] */
 28 |     private array $availableSorts = [];
 29 | 
 30 |     /** @var Facet[] */
 31 |     private array $facets = [];
 32 | 
 33 |     private ?EventDispatcher $eventDispatcher = null;
 34 | 
 35 |     private array $adapterParameters = [];
 36 | 
 37 |     private array $resolvedAdapterParameters = [];
 38 | 
 39 |     private bool $urlRewritting = false;
 40 | 
 41 |     private ?string $urlFormater = null;
 42 | 
 43 |     public function create(array $options = []): static
 44 |     {
 45 |         $this->eventDispatcher = new EventDispatcher();
 46 |         $this->build($options);
 47 | 
 48 |         return $this;
 49 |     }
 50 | 
 51 |     public function build(array $options = []): void
 52 |     {
 53 |     }
 54 | 
 55 |     public function getIndexName(): ?string
 56 |     {
 57 |         if ($attribute = (new \ReflectionClass(static::class))->getAttributes(AsSearch::class)) {
 58 |             return $attribute[0]->newInstance()->index;
 59 |         }
 60 | 
 61 |         return null;
 62 |     }
 63 | 
 64 |     public function getAdapterName(): ?string
 65 |     {
 66 |         if ($attribute = (new \ReflectionClass(static::class))->getAttributes(AsSearch::class)) {
 67 |             return $attribute[0]->newInstance()->adapter;
 68 |         }
 69 | 
 70 |         return null;
 71 |     }
 72 | 
 73 |     public function getAvailableHitsPerPage(): array
 74 |     {
 75 |         return $this->availableHitsPerPage;
 76 |     }
 77 | 
 78 |     public function setAvailableHitsPerPage(array $availableHitsPerPage): static
 79 |     {
 80 |         $this->availableHitsPerPage = $availableHitsPerPage;
 81 | 
 82 |         return $this;
 83 |     }
 84 | 
 85 |     public function addAvailableSort(?string $key, string $label): static
 86 |     {
 87 |         $this->availableSorts[] = new Sort($key, $label);
 88 | 
 89 |         return $this;
 90 |     }
 91 | 
 92 |     public function getAvailableSorts(): array
 93 |     {
 94 |         return $this->availableSorts;
 95 |     }
 96 | 
 97 |     public function addFacet(string $property, string $label, ?string $displayComponent = null, array $props = []): static
 98 |     {
 99 |         $this->facets[] = (new Facet($property, $label, $displayComponent, $props));
100 | 
101 |         return $this;
102 |     }
103 | 
104 |     public function getFacets(): array
105 |     {
106 |         return $this->facets;
107 |     }
108 | 
109 |     public function getFacet(string $property): ?Facet
110 |     {
111 |         foreach ($this->getFacets() as $facet) {
112 |             if ($facet->getProperty() === $property) {
113 |                 return $facet;
114 |             }
115 |         }
116 | 
117 |         throw SearchException::facetNotConfigured($property);
118 |     }
119 | 
120 |     public function getEventDispatcher(): EventDispatcher
121 |     {
122 |         return $this->eventDispatcher;
123 |     }
124 | 
125 |     public function addEventSubscriber(EventSubscriberInterface $eventSubscriber): static
126 |     {
127 |         $this->eventDispatcher->addSubscriber($eventSubscriber);
128 | 
129 |         return $this;
130 |     }
131 | 
132 |     public function addEventListener(string $eventName, callable $listener, int $priority = 0): static
133 |     {
134 |         $this->eventDispatcher->addListener($eventName, $listener, $priority);
135 | 
136 |         return $this;
137 |     }
138 | 
139 |     public function getAdapterParameters(): array
140 |     {
141 |         return $this->adapterParameters;
142 |     }
143 | 
144 |     public function setAdapterParameters(array $adapterParameters): static
145 |     {
146 |         $this->adapterParameters = $adapterParameters;
147 | 
148 |         return $this;
149 |     }
150 | 
151 |     public function getResolvedAdapterParameters(): array
152 |     {
153 |         return $this->resolvedAdapterParameters;
154 |     }
155 | 
156 |     public function getResolvedAdapterParameter(string $name): mixed
157 |     {
158 |         return $this->resolvedAdapterParameters[$name] ?? null;
159 |     }
160 | 
161 |     public function setResolvedAdapterParameters(array $resolvedAdapterParameters): static
162 |     {
163 |         $this->resolvedAdapterParameters = $resolvedAdapterParameters;
164 | 
165 |         return $this;
166 |     }
167 | 
168 |     public function createQuery(): Query
169 |     {
170 |         $query = new Query();
171 | 
172 |         if ($this->availableHitsPerPage) {
173 |             $query->setActiveHitsPerPage(current($this->availableHitsPerPage));
174 |         }
175 | 
176 |         if ($this->availableSorts) {
177 |             /** @var Sort $defaultSort */
178 |             $defaultSort = current($this->availableSorts);
179 |             $query->setActiveSort($defaultSort->getKey());
180 |         }
181 | 
182 |         return $query;
183 |     }
184 | 
185 |     public function enableUrlRewriting(): static
186 |     {
187 |         $this->urlRewritting = true;
188 | 
189 |         return $this;
190 |     }
191 | 
192 |     public function hasUrlRewriting(): bool
193 |     {
194 |         return $this->urlRewritting;
195 |     }
196 | 
197 |     public function getUrlFormater(): string
198 |     {
199 |         return $this->urlFormater ?? DefaultUrlFormater::class;
200 |     }
201 | 
202 |     public function setUrlFormater(string $urlFormater): static
203 |     {
204 |         $this->urlFormater = $urlFormater;
205 | 
206 |         return $this;
207 |     }
208 | }
209 | 


--------------------------------------------------------------------------------
/src/Search/Facet.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Search;
15 | 
16 | readonly class Facet
17 | {
18 |     public function __construct(
19 |         private string $property,
20 |         private string $label,
21 |         private ?string $displayComponent = null,
22 |         private array $props = [],
23 |     ) {
24 |     }
25 | 
26 |     public function getProperty(): string
27 |     {
28 |         return $this->property;
29 |     }
30 | 
31 |     public function getLabel(): string
32 |     {
33 |         return $this->label;
34 |     }
35 | 
36 |     public function getDisplayComponent(): ?string
37 |     {
38 |         return $this->displayComponent;
39 |     }
40 | 
41 |     public function getProps(): array
42 |     {
43 |         return $this->props;
44 |     }
45 | }
46 | 


--------------------------------------------------------------------------------
/src/Search/Filter/AbstractFilter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Search\Filter;
15 | 
16 | abstract class AbstractFilter implements FilterInterface
17 | {
18 |     public function __construct(private readonly ?string $property)
19 |     {
20 |     }
21 | 
22 |     public function getProperty(): ?string
23 |     {
24 |         return $this->property;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Search/Filter/FilterInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Search\Filter;
15 | 
16 | use Symfony\Component\Serializer\Attribute\DiscriminatorMap;
17 | 
18 | #[DiscriminatorMap(typeProperty: 'type', mapping: [
19 |     'range' => RangeFilter::class,
20 |     'term' => TermFilter::class,
21 | ])]
22 | interface FilterInterface
23 | {
24 |     public function getProperty(): ?string;
25 | 
26 |     public function hasValues(): bool;
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Search/Filter/RangeFilter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Search\Filter;
15 | 
16 | class RangeFilter extends AbstractFilter
17 | {
18 |     public function __construct(
19 |         string $property,
20 |         private int|float|null $min = null,
21 |         private int|float|null $max = null,
22 |     ) {
23 |         parent::__construct($property);
24 |     }
25 | 
26 |     public function getMin(): int|float|null
27 |     {
28 |         return $this->min;
29 |     }
30 | 
31 |     public function setMin(int|float|null $min): static
32 |     {
33 |         $this->min = $min;
34 | 
35 |         return $this;
36 |     }
37 | 
38 |     public function getMax(): int|float|null
39 |     {
40 |         return $this->max;
41 |     }
42 | 
43 |     public function setMax(int|float|null $max): static
44 |     {
45 |         $this->max = $max;
46 | 
47 |         return $this;
48 |     }
49 | 
50 |     public function hasValues(): bool
51 |     {
52 |         return $this->min || $this->max;
53 |     }
54 | }
55 | 


--------------------------------------------------------------------------------
/src/Search/Filter/TermFilter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Search\Filter;
15 | 
16 | class TermFilter extends AbstractFilter
17 | {
18 |     public function __construct(string $property, private array $values = [])
19 |     {
20 |         parent::__construct($property);
21 |     }
22 | 
23 |     public function getValues(): array
24 |     {
25 |         return $this->values;
26 |     }
27 | 
28 |     public function setValues(array $values): static
29 |     {
30 |         $this->values = $values;
31 | 
32 |         return $this;
33 |     }
34 | 
35 |     public function hasValue(string $value): bool
36 |     {
37 |         return \in_array($value, $this->values);
38 |     }
39 | 
40 |     public function hasValues(): bool
41 |     {
42 |         return [] !== $this->values;
43 |     }
44 | 
45 |     public function addValue(string $value): void
46 |     {
47 |         $this->values[] = $value;
48 |     }
49 | 
50 |     public function removeValue(string $value): void
51 |     {
52 |         if (($key = array_search($value, $this->values, true)) !== false) {
53 |             unset($this->values[$key]);
54 |         }
55 |     }
56 | 
57 |     public function toggleValue(string $value): void
58 |     {
59 |         if ($this->hasValue($value)) {
60 |             $this->removeValue($value);
61 |         } else {
62 |             $this->addValue($value);
63 |         }
64 |     }
65 | }
66 | 


--------------------------------------------------------------------------------
/src/Search/Query.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /*
  4 |  * This file is part of the UxSearch project.
  5 |  *
  6 |  * (c) Mezcalito (https://www.mezcalito.fr)
  7 |  *
  8 |  * For the full copyright and license information, please view the LICENSE
  9 |  * file that was distributed with this source code.
 10 |  */
 11 | 
 12 | declare(strict_types=1);
 13 | 
 14 | namespace Mezcalito\UxSearchBundle\Search;
 15 | 
 16 | use Mezcalito\UxSearchBundle\Search\Filter\FilterInterface;
 17 | 
 18 | class Query
 19 | {
 20 |     private string $queryString = '';
 21 | 
 22 |     /** @var FilterInterface[] */
 23 |     private array $activeFilters = [];
 24 | 
 25 |     private int $currentPage = 1;
 26 | 
 27 |     private ?string $activeSort = null;
 28 | 
 29 |     private ?int $activeHitsPerPage = 12;
 30 | 
 31 |     public function getQueryString(): string
 32 |     {
 33 |         return $this->queryString;
 34 |     }
 35 | 
 36 |     public function setQueryString(string $queryString): static
 37 |     {
 38 |         $this->queryString = $queryString;
 39 | 
 40 |         return $this;
 41 |     }
 42 | 
 43 |     public function getActiveFilters(): array
 44 |     {
 45 |         return $this->activeFilters;
 46 |     }
 47 | 
 48 |     public function setActiveFilters(array $activeFilters): static
 49 |     {
 50 |         $this->activeFilters = $activeFilters;
 51 | 
 52 |         return $this;
 53 |     }
 54 | 
 55 |     public function getActiveFilter(string $property): ?FilterInterface
 56 |     {
 57 |         foreach ($this->activeFilters as $activeFilter) {
 58 |             if ($activeFilter->getProperty() === $property) {
 59 |                 return $activeFilter;
 60 |             }
 61 |         }
 62 | 
 63 |         return null;
 64 |     }
 65 | 
 66 |     public function addActiveFilter(FilterInterface $filter): static
 67 |     {
 68 |         $this->activeFilters[] = $filter;
 69 | 
 70 |         return $this;
 71 |     }
 72 | 
 73 |     public function hasActiveFilter(string $property): bool
 74 |     {
 75 |         return $this->getActiveFilter($property) instanceof FilterInterface;
 76 |     }
 77 | 
 78 |     public function getCurrentPage(): int
 79 |     {
 80 |         return $this->currentPage;
 81 |     }
 82 | 
 83 |     public function setCurrentPage(int $currentPage): static
 84 |     {
 85 |         $this->currentPage = $currentPage;
 86 | 
 87 |         return $this;
 88 |     }
 89 | 
 90 |     public function setActiveSort(?string $sort): static
 91 |     {
 92 |         $this->activeSort = $sort;
 93 | 
 94 |         return $this;
 95 |     }
 96 | 
 97 |     public function getActiveSort(): ?string
 98 |     {
 99 |         return $this->activeSort;
100 |     }
101 | 
102 |     public function getActiveHitsPerPage(): int
103 |     {
104 |         return $this->activeHitsPerPage;
105 |     }
106 | 
107 |     public function setActiveHitsPerPage(int $activeHitsPerPage): static
108 |     {
109 |         $this->activeHitsPerPage = $activeHitsPerPage;
110 | 
111 |         return $this;
112 |     }
113 | 
114 |     public function removeActiveFilter(FilterInterface $filter): void
115 |     {
116 |         $this->activeFilters = array_filter($this->activeFilters, fn (FilterInterface $activeFilter) => $activeFilter !== $filter);
117 |     }
118 | }
119 | 


--------------------------------------------------------------------------------
/src/Search/ResultSet/FacetStat.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Search\ResultSet;
15 | 
16 | readonly class FacetStat
17 | {
18 |     public function __construct(
19 |         private string $property,
20 |         private int|float $min,
21 |         private int|float $max,
22 |         private int|float|null $userMin = null,
23 |         private int|float|null $userMax = null,
24 |     ) {
25 |     }
26 | 
27 |     public function getProperty(): string
28 |     {
29 |         return $this->property;
30 |     }
31 | 
32 |     public function getMin(): float|int
33 |     {
34 |         return $this->min;
35 |     }
36 | 
37 |     public function getMax(): float|int
38 |     {
39 |         return $this->max;
40 |     }
41 | 
42 |     public function getUserMin(): float|int|null
43 |     {
44 |         return $this->userMin;
45 |     }
46 | 
47 |     public function getUserMax(): float|int|null
48 |     {
49 |         return $this->userMax;
50 |     }
51 | }
52 | 


--------------------------------------------------------------------------------
/src/Search/ResultSet/FacetTermDistribution.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Search\ResultSet;
15 | 
16 | class FacetTermDistribution
17 | {
18 |     private string $property;
19 | 
20 |     /** @var array<mixed, int> */
21 |     private array $values = [];
22 | 
23 |     private array $checkedValues = [];
24 | 
25 |     public function getProperty(): string
26 |     {
27 |         return $this->property;
28 |     }
29 | 
30 |     public function setProperty(string $property): static
31 |     {
32 |         $this->property = $property;
33 | 
34 |         return $this;
35 |     }
36 | 
37 |     public function getValues(): array
38 |     {
39 |         return $this->values;
40 |     }
41 | 
42 |     public function setValues(array $values): static
43 |     {
44 |         $this->values = $values;
45 | 
46 |         return $this;
47 |     }
48 | 
49 |     public function getCheckedValues(): array
50 |     {
51 |         return $this->checkedValues;
52 |     }
53 | 
54 |     public function setCheckedValues(array $checkedValues): static
55 |     {
56 |         $this->checkedValues = $checkedValues;
57 | 
58 |         return $this;
59 |     }
60 | 
61 |     public function isChecked(mixed $value): bool
62 |     {
63 |         return \in_array($value, $this->checkedValues);
64 |     }
65 | }
66 | 


--------------------------------------------------------------------------------
/src/Search/ResultSet/Hit.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Search\ResultSet;
15 | 
16 | class Hit
17 | {
18 |     public function __construct(
19 |         private array|object $data,
20 |         private float $score,
21 |     ) {
22 |     }
23 | 
24 |     public function getData(): object|array
25 |     {
26 |         return $this->data;
27 |     }
28 | 
29 |     public function setData(object|array $data): self
30 |     {
31 |         $this->data = $data;
32 | 
33 |         return $this;
34 |     }
35 | 
36 |     public function getScore(): float
37 |     {
38 |         return $this->score;
39 |     }
40 | 
41 |     public function setScore(float $score): self
42 |     {
43 |         $this->score = $score;
44 | 
45 |         return $this;
46 |     }
47 | }
48 | 


--------------------------------------------------------------------------------
/src/Search/ResultSet/ResultSet.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /*
  4 |  * This file is part of the UxSearch project.
  5 |  *
  6 |  * (c) Mezcalito (https://www.mezcalito.fr)
  7 |  *
  8 |  * For the full copyright and license information, please view the LICENSE
  9 |  * file that was distributed with this source code.
 10 |  */
 11 | 
 12 | declare(strict_types=1);
 13 | 
 14 | namespace Mezcalito\UxSearchBundle\Search\ResultSet;
 15 | 
 16 | use Mezcalito\UxSearchBundle\Exception\ResultSetException;
 17 | 
 18 | class ResultSet
 19 | {
 20 |     private ?string $indexUid = null;
 21 | 
 22 |     /** @var Hit[] */
 23 |     private array $hits = [];
 24 | 
 25 |     public int $totalResults = 0;
 26 | 
 27 |     /** @var FacetTermDistribution[] */
 28 |     public array $facetDistributions = [];
 29 | 
 30 |     /** @var FacetStat[] */
 31 |     public array $facetStats = [];
 32 | 
 33 |     public function getIndexUid(): ?string
 34 |     {
 35 |         return $this->indexUid;
 36 |     }
 37 | 
 38 |     public function setIndexUid(?string $indexUid): static
 39 |     {
 40 |         $this->indexUid = $indexUid;
 41 | 
 42 |         return $this;
 43 |     }
 44 | 
 45 |     public function getHits(): array
 46 |     {
 47 |         return $this->hits;
 48 |     }
 49 | 
 50 |     public function setHits(array $hits): static
 51 |     {
 52 |         $this->hits = $hits;
 53 | 
 54 |         return $this;
 55 |     }
 56 | 
 57 |     public function getTotalResults(): int
 58 |     {
 59 |         return $this->totalResults;
 60 |     }
 61 | 
 62 |     public function setTotalResults(int $totalResults): static
 63 |     {
 64 |         $this->totalResults = $totalResults;
 65 | 
 66 |         return $this;
 67 |     }
 68 | 
 69 |     public function getFacetDistributions(): array
 70 |     {
 71 |         return $this->facetDistributions;
 72 |     }
 73 | 
 74 |     public function setFacetDistributions(array $facetDistributions): static
 75 |     {
 76 |         $this->facetDistributions = $facetDistributions;
 77 | 
 78 |         return $this;
 79 |     }
 80 | 
 81 |     public function getFacetDistribution(string $property): FacetTermDistribution
 82 |     {
 83 |         foreach ($this->facetDistributions as $facetDistribution) {
 84 |             if ($facetDistribution->getProperty() === $property) {
 85 |                 return $facetDistribution;
 86 |             }
 87 |         }
 88 | 
 89 |         throw ResultSetException::facetDistributionNotFound($property);
 90 |     }
 91 | 
 92 |     public function getFacetStats(): array
 93 |     {
 94 |         return $this->facetStats;
 95 |     }
 96 | 
 97 |     public function setFacetStats(array $facetStats): static
 98 |     {
 99 |         $this->facetStats = $facetStats;
100 | 
101 |         return $this;
102 |     }
103 | 
104 |     public function getFacetStat(string $property): FacetStat
105 |     {
106 |         foreach ($this->facetStats as $facetStat) {
107 |             if ($facetStat->getProperty() === $property) {
108 |                 return $facetStat;
109 |             }
110 |         }
111 | 
112 |         throw ResultSetException::facetStatNotFound($property);
113 |     }
114 | }
115 | 


--------------------------------------------------------------------------------
/src/Search/SearchInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Search;
15 | 
16 | use Symfony\Component\EventDispatcher\EventDispatcher;
17 | use Symfony\Component\EventDispatcher\EventSubscriberInterface;
18 | 
19 | interface SearchInterface
20 | {
21 |     public function create(array $options = []): static;
22 | 
23 |     public function build(array $options = []): void;
24 | 
25 |     public function getIndexName(): ?string;
26 | 
27 |     public function getAdapterName(): ?string;
28 | 
29 |     public function getAvailableHitsPerPage(): array;
30 | 
31 |     public function setAvailableHitsPerPage(array $availableHitsPerPage): static;
32 | 
33 |     public function addAvailableSort(?string $key, string $label): static;
34 | 
35 |     public function getAvailableSorts(): array;
36 | 
37 |     public function addFacet(string $property, string $label, ?string $displayComponent = null, array $props = []): static;
38 | 
39 |     /**
40 |      * @return Facet[]
41 |      */
42 |     public function getFacets(): array;
43 | 
44 |     public function getFacet(string $property): ?Facet;
45 | 
46 |     public function getEventDispatcher(): EventDispatcher;
47 | 
48 |     public function addEventSubscriber(EventSubscriberInterface $eventSubscriber): static;
49 | 
50 |     public function addEventListener(string $eventName, callable $listener, int $priority = 0): static;
51 | 
52 |     public function getAdapterParameters(): array;
53 | 
54 |     public function setAdapterParameters(array $adapterParameters): static;
55 | 
56 |     public function getResolvedAdapterParameters(): array;
57 | 
58 |     public function getResolvedAdapterParameter(string $name): mixed;
59 | 
60 |     public function setResolvedAdapterParameters(array $resolvedAdapterParameters): static;
61 | 
62 |     public function createQuery(): Query;
63 | 
64 |     public function hasUrlRewriting(): bool;
65 | 
66 |     public function enableUrlRewriting(): static;
67 | 
68 |     public function getUrlFormater(): string;
69 | 
70 |     public function setUrlFormater(string $urlFormater): static;
71 | }
72 | 


--------------------------------------------------------------------------------
/src/Search/SearchProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Search;
15 | 
16 | use Mezcalito\UxSearchBundle\Exception\SearchException;
17 | 
18 | readonly class SearchProvider
19 | {
20 |     public function __construct(
21 |         private iterable $searchs,
22 |     ) {
23 |     }
24 | 
25 |     public function getSearch(string $name): SearchInterface
26 |     {
27 |         /** @var SearchInterface $search */
28 |         foreach ($this->searchs as $searchName => $search) {
29 |             if ($name === $searchName) {
30 |                 return $search;
31 |             }
32 |         }
33 | 
34 |         throw SearchException::nameNotFound($name);
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Search/Searcher.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Search;
15 | 
16 | use Mezcalito\UxSearchBundle\Adapter\AdapterProvider;
17 | use Mezcalito\UxSearchBundle\Context\ContextProvider;
18 | use Mezcalito\UxSearchBundle\Event\PostSearchEvent;
19 | use Mezcalito\UxSearchBundle\Event\PreSearchEvent;
20 | use Mezcalito\UxSearchBundle\EventSubscriber\ContextSubscriber;
21 | use Symfony\Component\OptionsResolver\OptionsResolver;
22 | 
23 | readonly class Searcher
24 | {
25 |     public function __construct(
26 |         private AdapterProvider $adapterProvider,
27 |         private ContextProvider $contextProvider,
28 |     ) {
29 |     }
30 | 
31 |     public function search(Query $query, SearchInterface $search): ResultSet\ResultSet
32 |     {
33 |         $eventDispatcher = $search->getEventDispatcher();
34 |         $search->addEventSubscriber(new ContextSubscriber($this->contextProvider));
35 | 
36 |         $eventDispatcher->dispatch(new PreSearchEvent($query, $search));
37 | 
38 |         $adapter = $this->adapterProvider->getAdapter($search->getAdapterName());
39 | 
40 |         $optionResolver = new OptionsResolver();
41 |         $adapter->configureParameters($optionResolver);
42 |         $search->setResolvedAdapterParameters($optionResolver->resolve($search->getAdapterParameters()));
43 | 
44 |         $results = $adapter->search($query, $search);
45 | 
46 |         $eventDispatcher->dispatch(new PostSearchEvent($query, $search, $results));
47 | 
48 |         return $results;
49 |     }
50 | }
51 | 


--------------------------------------------------------------------------------
/src/Search/Sort.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Search;
15 | 
16 | readonly class Sort
17 | {
18 |     public function __construct(
19 |         private ?string $key,
20 |         private string $label,
21 |     ) {
22 |     }
23 | 
24 |     public function getKey(): ?string
25 |     {
26 |         return $this->key;
27 |     }
28 | 
29 |     public function getLabel(): string
30 |     {
31 |         return $this->label;
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/src/Search/Url/CurrentRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Search\Url;
15 | 
16 | use Symfony\Component\HttpFoundation\Request;
17 | 
18 | readonly class CurrentRequest
19 | {
20 |     public function __construct(
21 |         public string $route,
22 |         public array $parameters,
23 |     ) {
24 |     }
25 | 
26 |     public static function fromRequest(Request $request): self
27 |     {
28 |         $parameters = array_filter(array_merge($request->attributes->all(), $request->query->all()), fn ($key) => !str_starts_with((string) $key, '_'), \ARRAY_FILTER_USE_KEY);
29 | 
30 |         return new self($request->attributes->get('_route'), $parameters);
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Search/Url/DefaultUrlFormater.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /*
  4 |  * This file is part of the UxSearch project.
  5 |  *
  6 |  * (c) Mezcalito (https://www.mezcalito.fr)
  7 |  *
  8 |  * For the full copyright and license information, please view the LICENSE
  9 |  * file that was distributed with this source code.
 10 |  */
 11 | 
 12 | declare(strict_types=1);
 13 | 
 14 | namespace Mezcalito\UxSearchBundle\Search\Url;
 15 | 
 16 | use Mezcalito\UxSearchBundle\Search\Filter\RangeFilter;
 17 | use Mezcalito\UxSearchBundle\Search\Filter\TermFilter;
 18 | use Mezcalito\UxSearchBundle\Search\Query;
 19 | use Mezcalito\UxSearchBundle\Search\SearchInterface;
 20 | use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
 21 | 
 22 | class DefaultUrlFormater implements UrlFormaterInterface
 23 | {
 24 |     private const string QUERY = 'query';
 25 | 
 26 |     private const string PAGE = 'page';
 27 | 
 28 |     private const string SORT_BY = 'sortBy';
 29 | 
 30 |     public function __construct(private readonly UrlGeneratorInterface $urlGenerator)
 31 |     {
 32 |     }
 33 | 
 34 |     public function generateUrl(CurrentRequest $currentRequest, SearchInterface $search, Query $query): string
 35 |     {
 36 |         $params = $this->clearParameters($currentRequest->parameters, $search);
 37 | 
 38 |         if ('' !== $query->getQueryString()) {
 39 |             $params[self::QUERY] = $query->getQueryString();
 40 |         }
 41 | 
 42 |         if ($query->getActiveSort()) {
 43 |             $params[self::SORT_BY] = $query->getActiveSort();
 44 |         }
 45 | 
 46 |         if ($query->getCurrentPage() > 1) {
 47 |             $params[self::PAGE] = $query->getCurrentPage();
 48 |         }
 49 | 
 50 |         foreach ($query->getActiveFilters() as $filter) {
 51 |             $propertyForUrl = str_replace('.', '_', $filter->getProperty());
 52 |             if ($filter instanceof TermFilter) {
 53 |                 $params[$propertyForUrl] = implode('~~', $filter->getValues());
 54 |             }
 55 | 
 56 |             if ($filter instanceof RangeFilter) {
 57 |                 $params[$propertyForUrl.'Min'] = $filter->getMin();
 58 |                 $params[$propertyForUrl.'Max'] = $filter->getMax();
 59 |             }
 60 |         }
 61 | 
 62 |         return $this->urlGenerator->generate($currentRequest->route, $params, UrlGeneratorInterface::ABSOLUTE_URL);
 63 |     }
 64 | 
 65 |     public function applyFilters(CurrentRequest $currentRequest, SearchInterface $search, Query $query): void
 66 |     {
 67 |         if ($q = $currentRequest->parameters[self::QUERY] ?? null) {
 68 |             $query->setQueryString($q);
 69 |         }
 70 | 
 71 |         if ($s = $currentRequest->parameters[self::SORT_BY] ?? null) {
 72 |             $query->setActiveSort($s);
 73 |         }
 74 | 
 75 |         if ($p = $currentRequest->parameters[self::PAGE] ?? null) {
 76 |             $query->setCurrentPage((int) $p);
 77 |         }
 78 | 
 79 |         foreach ($search->getFacets() as $facet) {
 80 |             $property = $facet->getProperty();
 81 |             $propertyInUrl = str_replace('.', '_', $property);
 82 | 
 83 |             if ($value = $currentRequest->parameters[$propertyInUrl] ?? null) {
 84 |                 $query->addActiveFilter(new TermFilter($property, explode('~~', (string) $value)));
 85 |             }
 86 | 
 87 |             $minValue = $currentRequest->parameters[$propertyInUrl.'Min'] ?? null;
 88 |             $maxValue = $currentRequest->parameters[$propertyInUrl.'Max'] ?? null;
 89 |             if ($minValue || $maxValue) {
 90 |                 $query->addActiveFilter(new RangeFilter(
 91 |                     $property,
 92 |                     null !== $minValue ? (float) $minValue : null,
 93 |                     null !== $maxValue ? (float) $maxValue : null
 94 |                 ));
 95 |             }
 96 |         }
 97 |     }
 98 | 
 99 |     private function clearParameters(array $params, SearchInterface $search): array
100 |     {
101 |         $searchableParameterKeys = $this->getSearchableParameterKeys($search);
102 | 
103 |         return array_filter($params, fn ($key) => !\in_array($key, $searchableParameterKeys), \ARRAY_FILTER_USE_KEY);
104 |     }
105 | 
106 |     private function getSearchableParameterKeys(SearchInterface $search): array
107 |     {
108 |         $keys = [self::PAGE, self::SORT_BY];
109 |         foreach ($search->getFacets() as $facet) {
110 |             $propertyInUrl = str_replace('.', '_', $facet->getProperty());
111 |             $keys[] = $propertyInUrl;
112 |             $keys[] = $propertyInUrl.'Min';
113 |             $keys[] = $propertyInUrl.'Max';
114 |         }
115 | 
116 |         return $keys;
117 |     }
118 | }
119 | 


--------------------------------------------------------------------------------
/src/Search/Url/UrlFormaterInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Search\Url;
15 | 
16 | use Mezcalito\UxSearchBundle\Search\Query;
17 | use Mezcalito\UxSearchBundle\Search\SearchInterface;
18 | 
19 | interface UrlFormaterInterface
20 | {
21 |     public function generateUrl(CurrentRequest $currentRequest, SearchInterface $search, Query $query): string;
22 | 
23 |     public function applyFilters(CurrentRequest $currentRequest, SearchInterface $search, Query $query): void;
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Search/Url/UrlFormaterProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Search\Url;
15 | 
16 | use Mezcalito\UxSearchBundle\Exception\UrlFormaterException;
17 | 
18 | readonly class UrlFormaterProvider
19 | {
20 |     public function __construct(
21 |         private iterable $formaters,
22 |     ) {
23 |     }
24 | 
25 |     public function getUrlFormater(string $fqcn): UrlFormaterInterface
26 |     {
27 |         /** @var UrlFormaterInterface $formater */
28 |         foreach ($this->formaters as $urlFormaterName => $formater) {
29 |             if ($fqcn === $urlFormaterName) {
30 |                 return $formater;
31 |             }
32 |         }
33 | 
34 |         throw UrlFormaterException::urlFormaterNotFound($fqcn);
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Twig/Components/ClearRefinements.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Twig\Components;
15 | 
16 | use Mezcalito\UxSearchBundle\Context\ContextProvider;
17 | use Symfony\UX\TwigComponent\Attribute\ExposeInTemplate;
18 | 
19 | class ClearRefinements
20 | {
21 |     public function __construct(
22 |         private readonly ContextProvider $contextProvider,
23 |     ) {
24 |     }
25 | 
26 |     #[ExposeInTemplate]
27 |     public function getActiveFilters(): array
28 |     {
29 |         return $this->contextProvider->getCurrentContext()->getQuery()->getActiveFilters();
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Twig/Components/CurrentRefinements.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Twig\Components;
15 | 
16 | use Mezcalito\UxSearchBundle\Context\ContextProvider;
17 | use Symfony\UX\TwigComponent\Attribute\ExposeInTemplate;
18 | 
19 | class CurrentRefinements
20 | {
21 |     public function __construct(
22 |         private readonly ContextProvider $contextProvider,
23 |     ) {
24 |     }
25 | 
26 |     #[ExposeInTemplate]
27 |     public function getActiveFilters(): array
28 |     {
29 |         return $this->contextProvider->getCurrentContext()->getQuery()->getActiveFilters();
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Twig/Components/Facet.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Twig\Components;
15 | 
16 | use Mezcalito\UxSearchBundle\Context\ContextProvider;
17 | use Mezcalito\UxSearchBundle\Twig\Components\Facet\RefinementList;
18 | use Symfony\UX\TwigComponent\Attribute\ExposeInTemplate;
19 | 
20 | class Facet
21 | {
22 |     public string $property = '';
23 | 
24 |     public function __construct(
25 |         private readonly ContextProvider $contextProvider,
26 |     ) {
27 |     }
28 | 
29 |     #[ExposeInTemplate]
30 |     public function getComponent(): string
31 |     {
32 |         $facet = $this->contextProvider->getCurrentContext()->getSearch()->getFacet($this->property);
33 | 
34 |         return $facet->getDisplayComponent() ?? RefinementList::class;
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Twig/Components/Facet/AbstractFacet.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Twig\Components\Facet;
15 | 
16 | use Mezcalito\UxSearchBundle\Context\ContextProvider;
17 | use Mezcalito\UxSearchBundle\Search\Facet;
18 | use Symfony\UX\TwigComponent\Attribute\ExposeInTemplate;
19 | use Symfony\UX\TwigComponent\Attribute\PreMount;
20 | 
21 | abstract class AbstractFacet
22 | {
23 |     public string $property;
24 | 
25 |     public function __construct(protected ContextProvider $contextProvider)
26 |     {
27 |     }
28 | 
29 |     #[ExposeInTemplate]
30 |     public function getLabel(): string
31 |     {
32 |         return $this->getFacet()->getLabel();
33 |     }
34 | 
35 |     #[ExposeInTemplate]
36 |     protected function getFacet(): Facet
37 |     {
38 |         return $this->contextProvider->getCurrentContext()->getSearch()->getFacet($this->property);
39 |     }
40 | 
41 |     #[PreMount(priority: -100)]
42 |     public function mergeFacetData(array $data): array
43 |     {
44 |         $facet = $this->contextProvider->getCurrentContext()->getSearch()->getFacet($data['property']);
45 | 
46 |         return array_merge($facet->getProps(), $data);
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Twig/Components/Facet/RangeInput.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Twig\Components\Facet;
15 | 
16 | use Mezcalito\UxSearchBundle\Search\ResultSet\FacetStat;
17 | use Symfony\UX\TwigComponent\Attribute\ExposeInTemplate;
18 | 
19 | class RangeInput extends AbstractFacet
20 | {
21 |     #[ExposeInTemplate]
22 |     public function getFacetStat(): FacetStat
23 |     {
24 |         return $this->contextProvider->getCurrentContext()->getResults()->getFacetStat($this->property);
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Twig/Components/Facet/RangeSlider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Twig\Components\Facet;
15 | 
16 | use Mezcalito\UxSearchBundle\Search\ResultSet\FacetStat;
17 | use Symfony\UX\TwigComponent\Attribute\ExposeInTemplate;
18 | 
19 | class RangeSlider extends AbstractFacet
20 | {
21 |     public float|string $step = 1;
22 | 
23 |     public string $leading = '';
24 | 
25 |     public string $trailing = '';
26 | 
27 |     #[ExposeInTemplate]
28 |     public function getFacetStat(): FacetStat
29 |     {
30 |         return $this->contextProvider->getCurrentContext()->getResults()->getFacetStat($this->property);
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Twig/Components/Facet/RefinementList.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Twig\Components\Facet;
15 | 
16 | use Mezcalito\UxSearchBundle\Search\ResultSet\FacetTermDistribution;
17 | use Symfony\UX\TwigComponent\Attribute\ExposeInTemplate;
18 | 
19 | class RefinementList extends AbstractFacet
20 | {
21 |     public int $limit = 10;
22 | 
23 |     #[ExposeInTemplate]
24 |     public function getDistribution(): FacetTermDistribution
25 |     {
26 |         return $this->contextProvider->getCurrentContext()->getResults()->getFacetDistribution($this->property);
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Twig/Components/Hits.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Twig\Components;
15 | 
16 | use Mezcalito\UxSearchBundle\Context\ContextProvider;
17 | use Mezcalito\UxSearchBundle\Search\ResultSet\ResultSet;
18 | use Symfony\UX\TwigComponent\Attribute\ExposeInTemplate;
19 | 
20 | class Hits
21 | {
22 |     public function __construct(
23 |         private readonly ContextProvider $contextProvider,
24 |     ) {
25 |     }
26 | 
27 |     #[ExposeInTemplate]
28 |     public function getResults(): ResultSet
29 |     {
30 |         return $this->contextProvider->getCurrentContext()->getResults();
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Twig/Components/HitsPerPage.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Twig\Components;
15 | 
16 | use Mezcalito\UxSearchBundle\Context\ContextProvider;
17 | use Symfony\UX\TwigComponent\Attribute\ExposeInTemplate;
18 | 
19 | class HitsPerPage
20 | {
21 |     public function __construct(
22 |         private readonly ContextProvider $contextProvider,
23 |     ) {
24 |     }
25 | 
26 |     #[ExposeInTemplate]
27 |     public function getAvailableHitsPerPage(): array
28 |     {
29 |         return $this->contextProvider->getCurrentContext()->getSearch()->getAvailableHitsPerPage();
30 |     }
31 | 
32 |     #[ExposeInTemplate]
33 |     public function getActiveHitPerPage(): int
34 |     {
35 |         return $this->contextProvider->getCurrentContext()->getQuery()->getActiveHitsPerPage();
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/Twig/Components/Layout.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /*
  4 |  * This file is part of the UxSearch project.
  5 |  *
  6 |  * (c) Mezcalito (https://www.mezcalito.fr)
  7 |  *
  8 |  * For the full copyright and license information, please view the LICENSE
  9 |  * file that was distributed with this source code.
 10 |  */
 11 | 
 12 | declare(strict_types=1);
 13 | 
 14 | namespace Mezcalito\UxSearchBundle\Twig\Components;
 15 | 
 16 | use Mezcalito\UxSearchBundle\Search\Filter\RangeFilter;
 17 | use Mezcalito\UxSearchBundle\Search\Filter\TermFilter;
 18 | use Mezcalito\UxSearchBundle\Search\Query;
 19 | use Mezcalito\UxSearchBundle\Search\Searcher;
 20 | use Mezcalito\UxSearchBundle\Search\SearchInterface;
 21 | use Mezcalito\UxSearchBundle\Search\SearchProvider;
 22 | use Mezcalito\UxSearchBundle\Search\Url\CurrentRequest;
 23 | use Mezcalito\UxSearchBundle\Search\Url\UrlFormaterInterface;
 24 | use Mezcalito\UxSearchBundle\Search\Url\UrlFormaterProvider;
 25 | use Symfony\Component\HttpFoundation\RequestStack;
 26 | use Symfony\UX\LiveComponent\Attribute\LiveAction;
 27 | use Symfony\UX\LiveComponent\Attribute\LiveArg;
 28 | use Symfony\UX\LiveComponent\Attribute\LiveProp;
 29 | use Symfony\UX\LiveComponent\Attribute\PreReRender;
 30 | use Symfony\UX\LiveComponent\ComponentToolsTrait;
 31 | use Symfony\UX\LiveComponent\DefaultActionTrait;
 32 | use Symfony\UX\TwigComponent\Attribute\PreMount;
 33 | 
 34 | class Layout
 35 | {
 36 |     use ComponentToolsTrait;
 37 |     use DefaultActionTrait;
 38 | 
 39 |     #[LiveProp(writable: ['queryString', 'activeSort', 'activeHitsPerPage'], useSerializerForHydration: true)]
 40 |     public ?Query $query = null;
 41 | 
 42 |     #[LiveProp]
 43 |     public ?string $name = null;
 44 | 
 45 |     #[LiveProp]
 46 |     public array $options = [];
 47 | 
 48 |     public ?SearchInterface $search = null;
 49 | 
 50 |     #[LiveProp(useSerializerForHydration: true)]
 51 |     public ?CurrentRequest $currentRequest = null;
 52 | 
 53 |     public function __construct(
 54 |         private readonly SearchProvider $searchConfigurationProvider,
 55 |         private readonly Searcher $searcher,
 56 |         private readonly RequestStack $requestStack,
 57 |         private readonly UrlFormaterProvider $urlFormaterProvider,
 58 |     ) {
 59 |     }
 60 | 
 61 |     #[PreMount]
 62 |     public function onInitialMount(array $data): void
 63 |     {
 64 |         $this->search = $this->getSearch($data['name'])->create($data['options'] ?? []);
 65 |         $this->query = $this->getSearch($data['name'])->createQuery();
 66 |         $this->currentRequest = CurrentRequest::fromRequest($this->requestStack->getMainRequest());
 67 | 
 68 |         if ($this->search->hasUrlRewriting()) {
 69 |             $this->getUrlFormater()->applyFilters($this->currentRequest, $this->search, $this->query);
 70 |         }
 71 | 
 72 |         $this->searcher->search($this->query, $this->search);
 73 |     }
 74 | 
 75 |     #[PreReRender]
 76 |     public function onReRender(): void
 77 |     {
 78 |         $this->search = $this->getSearch($this->name)->create($this->options);
 79 |         $this->searcher->search($this->query, $this->search);
 80 | 
 81 |         if ($this->search->hasUrlRewriting()) {
 82 |             $this->dispatchBrowserEvent('history:update', ['url' => $this->getUrlFormater()->generateUrl($this->currentRequest, $this->search, $this->query)]);
 83 |         }
 84 |     }
 85 | 
 86 |     #[LiveAction]
 87 |     public function changeCurrentPage(#[LiveArg] int $page): void
 88 |     {
 89 |         $this->query->setCurrentPage($page);
 90 |     }
 91 | 
 92 |     #[LiveAction]
 93 |     public function toggleFacetTerm(#[LiveArg] string $property, #[LiveArg] string $value): void
 94 |     {
 95 |         $filter = $this->query->getActiveFilter($property);
 96 | 
 97 |         if (!$filter instanceof TermFilter) {
 98 |             $filter = new TermFilter($property);
 99 |             $this->query->addActiveFilter($filter);
100 |         }
101 | 
102 |         $filter->toggleValue($value);
103 | 
104 |         if (!$filter->hasValues()) {
105 |             $this->query->removeActiveFilter($filter);
106 |         }
107 | 
108 |         $this->query->setCurrentPage(1);
109 |     }
110 | 
111 |     #[LiveAction]
112 |     public function updateFacetRange(#[LiveArg] string $property, #[LiveArg] float|int|null $min, #[LiveArg] float|int|null $max): void
113 |     {
114 |         $filter = $this->query->getActiveFilter($property);
115 | 
116 |         if (!$filter instanceof RangeFilter) {
117 |             $filter = new RangeFilter($property);
118 |             $this->query->addActiveFilter($filter);
119 |         }
120 | 
121 |         $filter->setMin($min);
122 |         $filter->setMax($max);
123 | 
124 |         if (!$filter->hasValues()) {
125 |             $this->query->removeActiveFilter($filter);
126 |         }
127 | 
128 |         $this->query->setCurrentPage(1);
129 |     }
130 | 
131 |     #[LiveAction]
132 |     public function clearRefinements(): void
133 |     {
134 |         $this->query->setActiveFilters([]);
135 |     }
136 | 
137 |     private function getSearch(string $name): SearchInterface
138 |     {
139 |         return $this->searchConfigurationProvider->getSearch($name);
140 |     }
141 | 
142 |     private function getUrlFormater(): UrlFormaterInterface
143 |     {
144 |         return $this->urlFormaterProvider->getUrlFormater($this->search->getUrlFormater());
145 |     }
146 | }
147 | 


--------------------------------------------------------------------------------
/src/Twig/Components/Pagination.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Twig\Components;
15 | 
16 | use Mezcalito\UxSearchBundle\Context\ContextProvider;
17 | use Symfony\UX\TwigComponent\Attribute\ExposeInTemplate;
18 | 
19 | class Pagination
20 | {
21 |     public int $range = 2;
22 | 
23 |     public function __construct(
24 |         private readonly ContextProvider $contextProvider,
25 |     ) {
26 |     }
27 | 
28 |     #[ExposeInTemplate]
29 |     public function getStartRange(): int
30 |     {
31 |         return max($this->contextProvider->getCurrentContext()->getQuery()->getCurrentPage() - $this->range, 1);
32 |     }
33 | 
34 |     #[ExposeInTemplate]
35 |     public function getEndRange(): int
36 |     {
37 |         $endRange = min($this->contextProvider->getCurrentContext()->getQuery()->getCurrentPage() + $this->range, $this->getTotalPage() - $this->range);
38 | 
39 |         return 0 == $endRange ? $this->getTotalPage() : $endRange;
40 |     }
41 | 
42 |     #[ExposeInTemplate]
43 |     public function getTotalPage(): int
44 |     {
45 |         return (int) ceil($this->contextProvider->getCurrentContext()->getResults()->getTotalResults() / $this->contextProvider->getCurrentContext()->getQuery()->getActiveHitsPerPage());
46 |     }
47 | 
48 |     #[ExposeInTemplate]
49 |     public function getPage(): int
50 |     {
51 |         return $this->contextProvider->getCurrentContext()->getQuery()->getCurrentPage();
52 |     }
53 | }
54 | 


--------------------------------------------------------------------------------
/src/Twig/Components/SearchInput.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Twig\Components;
15 | 
16 | class SearchInput
17 | {
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Twig/Components/SortBy.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Twig\Components;
15 | 
16 | use Mezcalito\UxSearchBundle\Context\ContextProvider;
17 | use Symfony\UX\TwigComponent\Attribute\ExposeInTemplate;
18 | 
19 | class SortBy
20 | {
21 |     public function __construct(
22 |         private readonly ContextProvider $contextProvider,
23 |     ) {
24 |     }
25 | 
26 |     #[ExposeInTemplate]
27 |     public function getAvailableSorts(): array
28 |     {
29 |         return $this->contextProvider->getCurrentContext()->getSearch()->getAvailableSorts();
30 |     }
31 | 
32 |     #[ExposeInTemplate]
33 |     public function getActiveSort(): ?string
34 |     {
35 |         return $this->contextProvider->getCurrentContext()->getQuery()->getActiveSort();
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/Twig/Components/TotalHits.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Twig\Components;
15 | 
16 | use Mezcalito\UxSearchBundle\Context\ContextProvider;
17 | use Symfony\UX\TwigComponent\Attribute\ExposeInTemplate;
18 | 
19 | class TotalHits
20 | {
21 |     public function __construct(
22 |         private readonly ContextProvider $contextProvider,
23 |     ) {
24 |     }
25 | 
26 |     #[ExposeInTemplate]
27 |     public function getTotalHits(): int
28 |     {
29 |         return $this->contextProvider->getCurrentContext()->getResults()->getTotalResults();
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Twig/UxSearchExtension.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | namespace Mezcalito\UxSearchBundle\Twig;
15 | 
16 | use Mezcalito\UxSearchBundle\Search\Filter\FilterInterface;
17 | use Mezcalito\UxSearchBundle\Search\Filter\RangeFilter;
18 | use Mezcalito\UxSearchBundle\Search\Filter\TermFilter;
19 | use Twig\Extension\AbstractExtension;
20 | use Twig\TwigFunction;
21 | 
22 | class UxSearchExtension extends AbstractExtension
23 | {
24 |     public function getFunctions(): array
25 |     {
26 |         return [
27 |             new TwigFunction('ux_search_is_range_filter', $this->isRangeFilter(...)),
28 |             new TwigFunction('ux_search_is_term_filter', $this->isTermFilter(...)),
29 |         ];
30 |     }
31 | 
32 |     public function isRangeFilter(FilterInterface $filter): bool
33 |     {
34 |         return $filter instanceof RangeFilter;
35 |     }
36 | 
37 |     public function isTermFilter(FilterInterface $filter): bool
38 |     {
39 |         return $filter instanceof TermFilter;
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/templates/ClearRefinements.html.twig:
--------------------------------------------------------------------------------
 1 | {% block content %}
 2 |     {%- if activeFilters is defined and activeFilters|length > 0 %}
 3 |         <button
 4 |             {{ attributes.defaults({
 5 |                 'class': 'ux-search-clear-refinements ux-search-button',
 6 |                 'data-action': 'live#action:prevent',
 7 |                 'data-live-action-param': 'clearRefinements'
 8 |             }) }}
 9 |         >
10 |             {{ 'reset_filters'|trans(domain='mezcalito_ux_search') }}
11 |         </button>
12 |     {% endif %}
13 | {% endblock -%}
14 | 


--------------------------------------------------------------------------------
/templates/CurrentRefinements.html.twig:
--------------------------------------------------------------------------------
 1 | {% block content %}
 2 |     <div {{ attributes.defaults({
 3 |         'class': 'ux-search-current-refinements'
 4 |     }) }}>
 5 |         <ul class="ux-search-current-refinements__list">
 6 |             {%- for active_filter in activeFilters %}
 7 |                 {% if ux_search_is_term_filter(active_filter) %}
 8 |                     {% for value in active_filter.values %}
 9 |                         <li class="ux-search-current-refinements__item">
10 |                             <span class="ux-search-current-refinements__value">{{ value }}</span>
11 |                             <button
12 |                                 class="ux-search-current-refinements__remove"
13 |                                 type="button"
14 |                                 data-action="live#action:prevent"
15 |                                 data-live-action-param="toggleFacetTerm"
16 |                                 data-live-property-param="{{ active_filter.property }}"
17 |                                 data-live-value-param="{{ value }}"
18 |                             >
19 |                                 <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-x"><path d="M18 6 6 18"/><path d="m6 6 12 12"/></svg>
20 |                                 <span class="ux-search-sr-only">{{ 'remove'|trans(domain='mezcalito_ux_search') }}</span>
21 |                             </button>
22 |                         </li>
23 |                     {% endfor %}
24 |                 {% elseif ux_search_is_range_filter(active_filter) %}
25 |                     {% if active_filter.min is not null %}
26 |                         <li class="ux-search-current-refinements__item">
27 |                             <span class="ux-search-current-refinements__value">{{ active_filter.property }} >= {{ active_filter.min }}</span>
28 | 
29 |                             <button
30 |                                 class="ux-search-current-refinements__remove"
31 |                                 type="button"
32 |                                 data-action="live#action:prevent"
33 |                                 data-live-action-param="updateFacetRange"
34 |                                 data-live-property-param="{{ active_filter.property }}"
35 |                                 {% if active_filter.max is not null %}data-live-max-param="{{ active_filter.max }}"{% endif %}
36 |                             >
37 |                                 <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-x"><path d="M18 6 6 18"/><path d="m6 6 12 12"/></svg>
38 |                                 <span class="ux-search-sr-only">{{ 'remove'|trans(domain='mezcalito_ux_search') }}</span>
39 |                             </button>
40 |                         </li>
41 |                     {% endif %}
42 | 
43 |                     {% if active_filter.max is not null %}
44 |                         <li class="ux-search-current-refinements__item">
45 |                             <span class="ux-search-current-refinements__value">{{ active_filter.property }} <= {{ active_filter.max }}</span>
46 | 
47 |                             <button
48 |                                 class="ux-search-current-refinements__remove"
49 |                                 type="button"
50 |                                 data-action="live#action:prevent"
51 |                                 data-live-action-param="updateFacetRange"
52 |                                 data-live-property-param="{{ active_filter.property }}"
53 |                                 {% if active_filter.min is not null %}data-live-min-param="{{ active_filter.min }}"{% endif %}
54 |                             >
55 |                                 <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-x"><path d="M18 6 6 18"/><path d="m6 6 12 12"/></svg>
56 |                                 <span class="ux-search-sr-only">{{ 'remove'|trans(domain='mezcalito_ux_search') }}</span>
57 |                             </button>
58 |                         </li>
59 |                     {% endif %}
60 |                 {% endif %}
61 |             {% endfor -%}
62 |         </ul>
63 |     </div>
64 | {% endblock %}
65 | 


--------------------------------------------------------------------------------
/templates/Facet.html.twig:
--------------------------------------------------------------------------------
1 | {{ component(component, {property: property}) }}
2 | 


--------------------------------------------------------------------------------
/templates/Facet/RangeInput.html.twig:
--------------------------------------------------------------------------------
 1 | <fieldset {{ attributes.defaults({
 2 |     'class': 'ux-search-facet ux-search-range-input',
 3 |     'data-skip-morph': true
 4 | }) }}>
 5 |     <legend class="ux-search-facet__title">{% block label %}{{ label }}{% endblock %}</legend>
 6 |     {% block form %}
 7 |         <form
 8 |             class="ux-search-range-input__form"
 9 |             data-action="submit->ux-search#updateFacetRange:prevent"
10 |             data-ux-search-property-param="{{ property }}"
11 |             data-ux-search-range-min-param="{{ facetStat.min }}"
12 |             data-ux-search-range-max-param="{{ facetStat.max }}"
13 |         >
14 |             <div class="ux-search-range-input__box">
15 |                 <label class="ux-search-range-input__label ux-search-sr-only" for="{{ property }}-min">{{ 'range.min'|trans(domain='mezcalito_ux_search') }}</label>
16 |                 <input
17 |                     class="ux-search-range-input__input ux-search-input"
18 |                     type="number"
19 |                     min="{{ facetStat.min }}"
20 |                     max="{{ facetStat.max }}"
21 |                     id="{{ property }}-min"
22 |                     name="{{ property }}-min"
23 |                     placeholder="{{ facetStat.min }}"
24 |                     value="{{ facetStat.userMin }}"
25 |                     step="any"
26 |                 >
27 |             </div>
28 |             <div class="ux-search-range-input__box">
29 |                 <label class="ux-search-range-input__label ux-search-sr-only" for="{{ property }}-max">{{ 'range.max'|trans(domain='mezcalito_ux_search') }}</label>
30 |                 <input
31 |                     class="ux-search-range-input__input ux-search-input"
32 |                     type="number"
33 |                     min="{{ facetStat.min }}"
34 |                     max="{{ facetStat.max }}"
35 |                     id="{{ property }}-max"
36 |                     name="{{ property }}-max"
37 |                     placeholder="{{ facetStat.max }}"
38 |                     value="{{ facetStat.userMax }}"
39 |                     step="any"
40 |                 >
41 |             </div>
42 |             {% block submit %}
43 |                 <button class="ux-search-range-input__submit ux-search-button" type="submit">
44 |                     {{ 'go'|trans(domain='mezcalito_ux_search') }}
45 |                 </button>
46 |             {% endblock %}
47 |         </form>
48 |     {% endblock %}
49 | </fieldset>
50 | 


--------------------------------------------------------------------------------
/templates/Facet/RangeSlider.html.twig:
--------------------------------------------------------------------------------
 1 | <fieldset {{ attributes.defaults({
 2 |     'class': 'ux-search-facet ux-search-range-slider',
 3 |     'data-controller': 'ux-search-range-slider',
 4 |     'data-ux-search-range-slider-leading-value': this.leading|default(''),
 5 |     'data-ux-search-range-slider-trailing-value': this.trailing|default(''),
 6 |     'data-skip-morph': true
 7 | }) }}>
 8 |     <legend class="ux-search-facet__title">{{ label }}</legend>
 9 |     <form
10 |         class="ux-search-range-slider__form"
11 |         data-ux-search-range-slider-target="form"
12 |         data-action="submit->ux-search#updateFacetRange:prevent"
13 |         data-ux-search-property-param="{{ property }}"
14 |         data-ux-search-range-min-param="{{ facetStat.min }}"
15 |         data-ux-search-range-max-param="{{ facetStat.max }}"
16 |     >
17 |         <input
18 |             id="{{ property }}-min"
19 |             name="{{ property }}-min"
20 |             aria-label="Minimum {{ property }}"
21 |             aria-describedby="{{ property }}-min-value"
22 |             class="ux-search-range-slider__input ux-search-range-slider__input--min"
23 |             type="range"
24 |             min="{{ facetStat.min }}"
25 |             max="{{ facetStat.max }}"
26 |             placeholder="{{ facetStat.min }}"
27 |             value="{{ (facetStat.userMin is not null) ? facetStat.userMin : facetStat.min }}"
28 |             step="{{ this.step }}"
29 |             data-ux-search-range-slider-target="minInput"
30 |             data-action="
31 |                 input->ux-search-range-slider#updateCeil
32 |                 focus->ux-search-range-slider#updateCeil
33 |                 mousedown->ux-search-range-slider#updateCeil
34 |                 touchstart->ux-search-range-slider#updateCeil
35 |                 change->ux-search-range-slider#submit
36 |             "
37 |         />
38 |         <input
39 |             id="{{ property }}-max"
40 |             name="{{ property }}-max"
41 |             aria-label="Maximum {{ property }}"
42 |             aria-describedby="{{ property }}-max-value"
43 |             class="ux-search-range-slider__input ux-search-range-slider__input--max"
44 |             type="range"
45 |             min="{{ facetStat.min }}"
46 |             max="{{ facetStat.max }}"
47 |             placeholder="{{ facetStat.max }}"
48 |             value="{{ (facetStat.userMax is not null) ? facetStat.userMax : facetStat.max }}"
49 |             step="{{ this.step }}"
50 |             data-ux-search-range-slider-target="maxInput"
51 |             data-action="
52 |                 input->ux-search-range-slider#updateFloor
53 |                 focus->ux-search-range-slider#updateFloor
54 |                 mousedown->ux-search-range-slider#updateFloor
55 |                 touchstart->ux-search-range-slider#updateFloor
56 |                 change->ux-search-range-slider#submit
57 |             "
58 |         />
59 |     </form>
60 |     <div class="ux-search-range-slider__values">
61 |         <span
62 |             id="{{ property }}-min-value"
63 |             class="ux-search-range-slider__value ux-search-range-slider__value--min"
64 |             data-ux-search-range-slider-target="minValue"
65 |         >
66 |             {{ this.leading ~ facetStat.userMin|default(facetStat.min) ~ this.trailing }}
67 |         </span>
68 |         <span
69 |             id="{{ property }}-max-value"
70 |             class="ux-search-range-slider__value ux-search-range-slider__value--max"
71 |             data-ux-search-range-slider-target="maxValue"
72 |         >
73 |             {{ this.leading ~ facetStat.userMax|default(facetStat.max) ~ this.trailing }}
74 |         </span>
75 |     </div>
76 | </fieldset>
77 | 


--------------------------------------------------------------------------------
/templates/Facet/RefinementList.html.twig:
--------------------------------------------------------------------------------
 1 | <fieldset {{ attributes.defaults({
 2 |     class: 'ux-search-facet ux-search-refinement-list',
 3 |     'data-skip-morph': true,
 4 |     'data-controller': 'ux-search--refinement-list',
 5 |     'data-ux-search--refinement-list-limit-value': this.limit,
 6 |     'data-ux-search--refinement-list-show-more-label-value': 'show_more'|trans(domain='mezcalito_ux_search'),
 7 |     'data-ux-search--refinement-list-show-less-label-value': 'show_less'|trans(domain='mezcalito_ux_search')
 8 | }) }}>
 9 |     <legend class="ux-search-facet__title ux-search-refinement-list__title">{% block label %}{{ label }}{% endblock %}</legend>
10 |     {% block list %}
11 |         <ul class="ux-search-refinement-list__list">
12 |             {%- for key,value in distribution.values %}
13 |                 <li
14 |                     class="ux-search-refinement-list__item{{ loop.index > this.limit ? ' ux-search-refinement-list__item--exceed-limit' }}"
15 |                 >
16 |                     <input
17 |                         class="ux-search-refinement-list__input"
18 |                         value="{{ key }}"
19 |                         type="checkbox"
20 |                         id="{{ property }}-{{ key }}"
21 |                         {%- if distribution.isChecked(key) %} checked {% endif -%}
22 |                         data-action="live#action"
23 |                         data-live-action-param="toggleFacetTerm"
24 |                         data-live-property-param="{{ property }}"
25 |                         data-live-value-param="{{ key }}"
26 |                     >
27 |                     <label class="ux-search-refinement-list__label" for="{{ property }}-{{ key }}">
28 |                         <span class="ux-search-refinement-list__label-text">{{ key }}</span>
29 |                         <span class="ux-search-refinement-list__count">{{ value }}</span>
30 |                     </label>
31 |                 </li>
32 |             {% endfor -%}
33 |         </ul>
34 |     {% endblock %}
35 |     {% if distribution.values|length > this.limit %}
36 |         {% block show_more %}
37 |             <button
38 |                 class="ux-search-refinement-list__show-more"
39 |                 type="button"
40 |                 data-ux-search--refinement-list-target="toggle"
41 |                 data-action="ux-search--refinement-list#toggleShowMore"
42 |             >
43 |                 {{ 'show_more'|trans(domain='mezcalito_ux_search') }}
44 |             </button>
45 |         {% endblock %}
46 |     {% endif %}
47 | </fieldset>
48 | 


--------------------------------------------------------------------------------
/templates/Hits.html.twig:
--------------------------------------------------------------------------------
 1 | {% block content %}
 2 |     <div {{ attributes.defaults({
 3 |         class: 'ux-search-hits'
 4 |     }) }}>
 5 |         {% if results.hits|length > 0 %}
 6 |             <div class="ux-search-hits__list">
 7 |                 {% for hit in results.hits %}
 8 |                     {% block hit %}
 9 |                         <div class="ux-search-hits__item" style="max-width: 100%; overflow: auto;">
10 |                             <pre style="font-family: monospace">{{ hit.data|json_encode(constant('JSON_PRETTY_PRINT')) }}</pre>
11 |                         </div>
12 |                     {% endblock %}
13 |                 {% endfor %}
14 |             </div>
15 |         {% else %}
16 |             {% block noResult %}
17 |                 <div class="ux-search-hits__no-result">{{ 'no_result'|trans(domain='mezcalito_ux_search') }}</div>
18 |             {% endblock %}
19 |         {% endif %}
20 |     </div>
21 | {% endblock %}
22 | 


--------------------------------------------------------------------------------
/templates/HitsPerPage.html.twig:
--------------------------------------------------------------------------------
 1 | {% block content %}
 2 |     <div {{ attributes.defaults({
 3 |         'class': 'ux-search-hits-per-page ux-search-select',
 4 |     }) }}>
 5 |         <select data-model="query.activeHitsPerPage">
 6 |             {% for option in availableHitsPerPage %}
 7 |                 <option value="{{ option }}" {% if option == activeHitPerPage %}selected{% endif %}>{{ option }}</option>
 8 |             {% endfor %}
 9 |         </select>
10 |         <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-down"><path d="m6 9 6 6 6-6"/></svg>
11 |     </div>
12 | {% endblock %}
13 | 


--------------------------------------------------------------------------------
/templates/Layout.html.twig:
--------------------------------------------------------------------------------
 1 | <div {{ attributes.defaults({
 2 |     'class': 'ux-search',
 3 |     'data-controller': 'ux-search',
 4 |     'data-loading': 'addClass(ux-search--is-loading)'
 5 | }) }}>
 6 |     {% block content %}
 7 |         <div class="ux-search__inner">
 8 |             <div class="ux-search__form">
 9 |                 {% block form %}
10 |                     <twig:Mezcalito:UxSearch:SearchInput />
11 |                 {% endblock %}
12 |             </div>
13 | 
14 |             <div class="ux-search__toolbar">
15 |                 {% block toolbar %}
16 |                     <twig:Mezcalito:UxSearch:CurrentRefinements/>
17 |                     <twig:Mezcalito:UxSearch:ClearRefinements />
18 |                     <twig:Mezcalito:UxSearch:HitsPerPage/>
19 |                     <twig:Mezcalito:UxSearch:SortBy/>
20 |                 {% endblock %}
21 |             </div>
22 | 
23 |             <div class="ux-search__facets">
24 |                 {% block facets %}
25 |                     {% for facet in search.facets %}
26 |                          <twig:Mezcalito:UxSearch:Facet :property="facet.property" />
27 |                     {% endfor %}
28 |                 {% endblock %}
29 |             </div>
30 | 
31 |             <div class="ux-search__listing">
32 |                 {% block listing %}
33 |                     <div class="ux-search__stats">
34 |                         {% block stats %}
35 |                             <twig:Mezcalito:UxSearch:TotalHits/>
36 |                         {% endblock %}
37 |                     </div>
38 | 
39 |                     {% block hits %}
40 |                         <twig:Mezcalito:UxSearch:Hits />
41 |                     {% endblock %}
42 | 
43 |                     {% block pagination %}
44 |                         <twig:Mezcalito:UxSearch:Pagination />
45 |                     {% endblock %}
46 |                 {% endblock %}
47 |             </div>
48 |         </div>
49 |     {% endblock %}
50 | </div>
51 | 


--------------------------------------------------------------------------------
/templates/Pagination.html.twig:
--------------------------------------------------------------------------------
  1 | {%- block content %}
  2 |     {%- if totalPage > 1 %}
  3 |         <nav {{ attributes.defaults({
  4 |             'class': 'ux-search-pagination'
  5 |         }) }} >
  6 |             <ul class="ux-search-pagination__list">
  7 |                 {% if (page - 1) >= 1 %}
  8 |                     <li class="ux-search-pagination__item">
  9 |                         <a
 10 |                             class="ux-search-pagination__link"
 11 |                             href="?page={{ page - 1 }}"
 12 |                             data-action="live#action:prevent"
 13 |                             data-live-action-param="changeCurrentPage"
 14 |                             data-live-page-param="{{ page - 1 }}"
 15 |                             rel="prev"
 16 |                         >
 17 |                             <span class="ux-search-sr-only">{{ 'pagination.previous_page'|trans(domain='mezcalito_ux_search') }}</span>
 18 |                             <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-left"><path d="m15 18-6-6 6-6"/></svg>
 19 |                         </a>
 20 |                     </li>
 21 |                 {% endif %}
 22 | 
 23 |                 {% if startRange > range %}
 24 |                     {% for i in 1..range %}
 25 |                         <li class="ux-search-pagination__item">
 26 |                             {{ _self.link(i, page) }}
 27 |                         </li>
 28 |                     {% endfor %}
 29 |                 {% endif %}
 30 | 
 31 |                 {% if startRange - 1 == 1 %}
 32 |                     <li class="ux-search-pagination__item">
 33 |                         {{ _self.link(1, page) }}
 34 |                     </li>
 35 |                 {% elseif startRange - 1 == range + 1 %}
 36 |                     <li class="ux-search-pagination__item">
 37 |                         {{ _self.link(range + 1, page) }}
 38 |                     </li>
 39 |                 {% elseif startRange - 1 >= range + 2 %}
 40 |                     <li class="ux-search-pagination__item">
 41 |                         {{ _self.elipsis() }}
 42 |                     </li>
 43 |                 {% endif %}
 44 | 
 45 |                 {% for i in  startRange..endRange %}
 46 |                     <li class="ux-search-pagination__item">
 47 |                         {{ _self.link(i, page) }}
 48 |                     </li>
 49 |                 {% endfor %}
 50 | 
 51 |                 <li class="ux-search-pagination__item">
 52 |                     {% if endRange + range <= totalPage - range %}
 53 |                         {{ _self.elipsis() }}
 54 |                     {% elseif endRange + 1 == totalPage - (range + 1)  %}
 55 |                         {{ _self.link(endRange + 1, page) }}
 56 |                     {% endif %}
 57 |                 </li>
 58 | 
 59 |                 {% if endRange < totalPage %}
 60 |                     {% for i in (totalPage - range + 1)..totalPage %}
 61 |                         <li class="ux-search-pagination__item">
 62 |                             {{ _self.link(i, page) }}
 63 |                         </li>
 64 |                     {% endfor %}
 65 |                 {% endif %}
 66 | 
 67 |                 {% if page < totalPage %}
 68 |                     <li class="ux-search-pagination__item">
 69 |                         <a
 70 |                             class="ux-search-pagination__link{{ page < totalPage ? '' : ' is-disabled'}}"
 71 |                             href="?page={{ page + 1 }}"
 72 |                             data-action="live#action:prevent"
 73 |                             data-live-action-param="changeCurrentPage"
 74 |                             data-live-page-param="{{ page + 1 }}"
 75 |                             rel="next"
 76 |                         >
 77 |                             <span class="ux-search-sr-only">{{ 'pagination.next_page'|trans(domain='mezcalito_ux_search') }}</span>
 78 |                             <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right"><path d="m9 18 6-6-6-6"/></svg>
 79 |                         </a>
 80 |                     </li>
 81 |                 {% endif %}
 82 |             </ul>
 83 |         </nav>
 84 |     {% endif -%}
 85 | 
 86 |     {%- macro link(iterator, page) %}
 87 |         {%- if page == iterator %}
 88 |             <span class="ux-search-pagination__link is-current">{{ iterator }}</span>
 89 |         {% else %}
 90 |             <a
 91 |                 class="ux-search-pagination__link"
 92 |                 href="?page={{ iterator }}"
 93 |                 data-action="live#action:prevent"
 94 |                 data-live-action-param="changeCurrentPage"
 95 |                 data-live-page-param="{{ iterator }}"
 96 |             >
 97 |                 {{ iterator }}
 98 |             </a>
 99 |         {% endif -%}
100 |     {% endmacro -%}
101 | 
102 |     {%- macro elipsis() %}
103 |         <span class="ux-search-pagination__link ux-search-pagination__ellipsis">...</span>
104 |     {% endmacro -%}
105 | {% endblock -%}
106 | 


--------------------------------------------------------------------------------
/templates/SearchInput.html.twig:
--------------------------------------------------------------------------------
1 | {% block content %}
2 |     <input {{ attributes.defaults({
3 |         'class': 'ux-search-search-input ux-search-input',
4 |         'type': 'search',
5 |         'data-model': 'debounce(400)|query.queryString',
6 |         'placeholder': 'search.placeholder'|trans(domain='mezcalito_ux_search')
7 |     }) }}>
8 | {% endblock %}
9 | 


--------------------------------------------------------------------------------
/templates/SortBy.html.twig:
--------------------------------------------------------------------------------
 1 | {% block content %}
 2 |     <div {{ attributes.defaults({
 3 |         'class': 'ux-search-sort-by ux-search-select',
 4 |     }) }}>
 5 |         <select data-model="query.activeSort">
 6 |             {% for option in availableSorts %}
 7 |                 <option value="{{ option.key }}" {% if option.key == activeSort %}selected{% endif %}>{{ option.label }}</option>
 8 |             {% endfor %}
 9 |         </select>
10 |         <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-down"><path d="m6 9 6 6 6-6"/></svg>
11 |     </div>
12 | {% endblock %}
13 | 


--------------------------------------------------------------------------------
/templates/TotalHits.html.twig:
--------------------------------------------------------------------------------
1 | {% block content %}
2 |     <span {{ attributes.defaults({
3 |         'class': 'ux-search-total-hits'
4 |     }) }} >
5 |         {{ 'results'|trans({'%count%': totalHits}, domain='mezcalito_ux_search') }}
6 |     </span>
7 | {% endblock %}
8 | 


--------------------------------------------------------------------------------
/templates/skeleton/search.tpl.php:
--------------------------------------------------------------------------------
 1 | <?php echo "<?php\n"; ?>
 2 | 
 3 | namespace <?php echo $namespace; ?>;
 4 | 
 5 | <?php echo $use_statements; ?>
 6 | 
 7 | #[AsSearch(<?php echo $index_name; ?>)]
 8 | class <?php echo $class_name; ?> extends AbstractSearch
 9 | {
10 | 
11 |     public function build(array $options = []): void
12 |     {
13 |         // ->addFacet('type', 'Type', null, ['limit' => 2])
14 |         // ->addFacet('brand', 'Brand')
15 |         // ->addFacet('rating', 'Rating')
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/translations/mezcalito_ux_search.en.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | return [
15 |     'go' => 'Go',
16 |     'show_more' => 'Show more',
17 |     'show_less' => 'Show less',
18 |     'remove' => 'Remove',
19 |     'reset_filters' => 'Reset filters',
20 |     'results' => '{0} 0 result|{1} 1 result|]1,Inf] %count% results',
21 |     'no_result' => 'No result',
22 |     'range' => [
23 |         'min' => 'Min',
24 |         'max' => 'Max',
25 |     ],
26 |     'pagination' => [
27 |         'previous_page' => 'Previous page',
28 |         'next_page' => 'Next page',
29 |     ],
30 |     'search' => [
31 |         'placeholder' => 'Search here...',
32 |     ],
33 | ];
34 | 


--------------------------------------------------------------------------------
/translations/mezcalito_ux_search.fr.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 |  * This file is part of the UxSearch project.
 5 |  *
 6 |  * (c) Mezcalito (https://www.mezcalito.fr)
 7 |  *
 8 |  * For the full copyright and license information, please view the LICENSE
 9 |  * file that was distributed with this source code.
10 |  */
11 | 
12 | declare(strict_types=1);
13 | 
14 | return [
15 |     'go' => 'Go',
16 |     'show_more' => 'Voir plus',
17 |     'show_less' => 'Voir moins',
18 |     'remove' => 'Retirer',
19 |     'reset_filters' => 'Réinitialiser',
20 |     'results' => '{0} 0 résultat|{1} 1 résultat|]1,Inf] %count% résultats',
21 |     'no_result' => 'Aucun résultat',
22 |     'range' => [
23 |         'min' => 'Min',
24 |         'max' => 'Max',
25 |     ],
26 |     'pagination' => [
27 |         'previous_page' => 'Page précédente',
28 |         'next_page' => 'Page suivante',
29 |     ],
30 |     'search' => [
31 |         'placeholder' => 'Rechercher...',
32 |     ],
33 | ];
34 | 


--------------------------------------------------------------------------------