Merge branch '5.0' into response-tagget

Author: adriendupuis

.github/workflows/build.yaml

@@ -65,6 +65,18 @@ jobs:
                         exit 1
                     fi
 
+    markdownlint:
+        runs-on: ubuntu-latest
+        if: github.event_name == 'pull_request'
+
+        steps:
+            - uses: actions/checkout@v4
+
+            - name: Run markdownlint
+              uses: DavidAnson/markdownlint-cli2-action@v20
+              with:
+                  globs: "docs/**/*.md"
+
     vale-check:
         runs-on: ubuntu-latest
         if: github.event_name == 'pull_request'
@@ -82,7 +94,7 @@ jobs:
                   mv vale-styles-main/* vale-styles-main/.vale.ini .
 
             - name: Run Vale.sh
-              uses: errata-ai/vale-action@reviewdog
+              uses: vale-cli/vale-action@v2
               with:
                   reporter: github-check
                   filter_mode: added

.github/workflows/code_samples.yaml

@@ -9,6 +9,7 @@ jobs:
         runs-on: "ubuntu-22.04"
         strategy:
             matrix:
+                fail-fast: false
                 php:
                     - "8.4" # Upper supported version
                     - "8.3" # Lower supported version
@@ -45,12 +46,15 @@ jobs:
                   dependency-versions: highest
 
             - name: Run PHPStan analysis
+              continue-on-error: true
               run: composer phpstan
 
             - name: Run Deptrac analysis
+              continue-on-error: true
               run: composer deptrac
 
             - name: Run Rector check
+              continue-on-error: true
               run: composer check-rector
 
     code-samples-inclusion-check:

.markdownlint-cli2.yaml

@@ -0,0 +1,19 @@
+config:
+  default: false
+  heading-style: consistent
+  list-indent: true
+  no-reversed-links: true
+  no-missing-space-atx: true
+  heading-start-left: true
+  no-multiple-space-blockquote: true
+  no-blanks-blockquote: true
+  hr-style: true
+  no-empty-links: true
+  code-fence-style: backtick
+  strong-style: asterisk
+  table-pipe-style:
+    style: leading_and_trailing
+
+ignores:
+  - "docs/snippets/**"
+  - "docs/index.md"

.readthedocs.yml

@@ -5,7 +5,7 @@ mkdocs:
   fail_on_warning: true
 
 build:
-  os: ubuntu-20.04
+  os: ubuntu-24.04
   tools:
     python: "3.13"
 

README.md

@@ -20,18 +20,9 @@ If you'd like to see Ibexa DXP in your language, you can [contribute to the tran
 
 ### Contribute to API reference
 
-The REST API Reference is located in the `docs/api/rest_api/rest_api_reference/rest_api_reference.html` 
-file, which is generated automatically by the RAML2HTML tool.
-It is based on `*.raml` files located in the `docs/api/rest_api/rest_api_reference/input` directory that you can edit in your editor/IDE.
-
-After you modify relevant files in the input folder, you can generate an HTML file from repository root (this step can also be performed by one of the Tech Writers during PR review): 
-
-`php tools/raml2html/raml2html.php build --non-standard-http-methods=COPY,MOVE,PUBLISH,SWAP -t default -o docs/api/rest_api/rest_api_reference/output/ docs/api/rest_api/rest_api_reference/input/ibexa.raml`
-
-In case of errors, look for mistakes in the RAML file, for example, double apostrophes.
-Move `rest_api_reference.html`  from the output folder to `docs/api/rest_api/rest_api_reference/` root.
-
-See `tools/raml2html/README.md` for more information.
+The REST API Reference is located in the `docs/api/rest_api/rest_api_reference/` directory.
+It is based on an OpenAPI specification (`openapi.yaml` / `openapi.json`) generated from the Ibexa DXP source code.
+To contribute to the REST API reference, you must modify the source code annotations directly.
 
 ## Build and preview documentation
 
@@ -53,6 +44,28 @@ of the command.
 
 ## Testing the code samples
 
+### markdownlint
+
+This repository uses [markdownlint-cli2](https://github.com/DavidAnson/markdownlint-cli2) to check Markdown formatting, including table syntax.
+
+Install dependencies:
+
+```bash
+yarn install
+```
+
+Run the linter:
+
+```bash
+yarn markdownlint
+```
+
+Some issues can be fixed automatically:
+
+```bash
+yarn markdownlint --fix
+```
+
 ### PHPStan
 
 This repository uses PHPStan to test the code samples. To run the tests locally execute the commands below:

code_samples/ai_actions/config/packages/ibexa_connector_gemini.yaml

@@ -0,0 +1,20 @@
+ibexa_connector_gemini:
+    text_to_text:
+        models:
+            gemini-pro-latest:
+                label: 'Gemini Pro Latest'
+                max_tokens: 4096
+            gemini-flash-latest:
+                label: 'Gemini Flash Latest'
+                max_tokens: 4096
+        default_model: gemini-pro-latest
+        default_max_tokens: 4096 # Must be <= the model’s max_tokens
+        default_temperature: 0.8
+    image_to_text:
+        models:
+            gemini-flash-latest:
+                label: 'Gemini Flash Latest'
+                max_tokens: 4096
+        default_model: gemini-flash-latest
+        default_max_tokens: 4096
+        default_temperature: 1.0

code_samples/api/graphql/config/services.yaml

@@ -0,0 +1,5 @@
+services:
+    App\GraphQL\Schema\MyFieldDefinitionMapper:
+        decorates: Ibexa\GraphQL\Schema\Domain\Content\Mapper\FieldDefinition\DecoratingFieldDefinitionMapper
+        arguments:
+            $innerMapper: '@.inner'

code_samples/api/graphql/src/GraphQL/Schema/MyCustomFieldDefinitionMapper.php

@@ -0,0 +1,37 @@
+<?php declare(strict_types=1);
+
+namespace App\GraphQL\Schema;
+
+use Ibexa\Contracts\Core\Repository\Values\ContentType\ContentType;
+use Ibexa\Contracts\Core\Repository\Values\ContentType\FieldDefinition;
+use Ibexa\Contracts\GraphQL\Schema\Domain\Content\Mapper\FieldDefinition\FieldDefinitionMapper;
+use Ibexa\GraphQL\Schema\Domain\Content\Mapper\FieldDefinition\DecoratingFieldDefinitionMapper;
+use Symfony\Component\Serializer\NameConverter\CamelCaseToSnakeCaseNameConverter;
+
+class MyFieldDefinitionMapper extends DecoratingFieldDefinitionMapper implements FieldDefinitionMapper
+{
+    protected function getFieldTypeIdentifier(): string
+    {
+        return 'my_field_type';
+    }
+
+    public function mapToFieldValueInputType(ContentType $contentType, FieldDefinition $fieldDefinition): ?string
+    {
+        if (!$this->canMap($fieldDefinition)) {
+            return parent::mapToFieldValueInputType($contentType, $fieldDefinition);
+        }
+
+        return $this->nameMyFieldInputType($contentType, $fieldDefinition);
+    }
+
+    private function nameMyFieldInputType(ContentType $contentType, FieldDefinition $fieldDefinition): string
+    {
+        $converter = new CamelCaseToSnakeCaseNameConverter(null, false);
+
+        return sprintf(
+            '%s%sInput',
+            $converter->denormalize($contentType->identifier),
+            $converter->denormalize($fieldDefinition->identifier)
+        );
+    }
+}

code_samples/api/graphql/src/GraphQL/Schema/MyFieldDefinitionMapper.php

@@ -10,3 +10,18 @@ services:
     App\Security\Limitation\Mapper\CustomLimitationValueMapper:
         tags:
             - { name: 'ibexa.admin_ui.limitation.mapper.value', limitationType: 'CustomLimitation' }
+
+    App\Security\FormPolicyProvider:
+        tags:
+            - { name: ibexa.permissions.limitation_type }
+
+    App\Security\FormSubmissionsTabDecorator:
+        parent: Ibexa\FormBuilder\Tab\LocationView\SubmissionsTab
+        decorates: 'Ibexa\FormBuilder\Tab\LocationView\SubmissionsTab'
+        arguments:
+            $innerTab: '@.inner'
+
+    App\Security\FormSubmissionServiceDecorator:
+        decorates: Ibexa\FormBuilder\FormSubmission\FormSubmissionService
+        arguments:
+            $innerService: '@App\Security\FormSubmissionServiceDecorator.inner'