From b74b077b58c693c943302290b563e08686ffd14b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=B4me=20Tamarelle?=
 <jerome.tamarelle@mongodb.com>
Date: Mon, 23 Dec 2024 18:03:38 +0100
Subject: [PATCH] Add links to custom types

---
 phpcs.xml.dist           |  4 ++++
 src/Schema/Blueprint.php | 12 ++++++++++--
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/phpcs.xml.dist b/phpcs.xml.dist
index 3b7cc671c..f83429905 100644
--- a/phpcs.xml.dist
+++ b/phpcs.xml.dist
@@ -53,4 +53,8 @@
     <rule ref="PSR1.Classes.ClassDeclaration.MultipleClasses">
         <exclude-pattern>tests/Ticket/*.php</exclude-pattern>
     </rule>
+
+    <rule ref="SlevomatCodingStandard.Commenting.DocCommentSpacing.IncorrectAnnotationsGroup">
+        <exclude-pattern>src/Schema/Blueprint.php</exclude-pattern>
+    </rule>
 </ruleset>
diff --git a/src/Schema/Blueprint.php b/src/Schema/Blueprint.php
index 961c9e1cb..65f53784a 100644
--- a/src/Schema/Blueprint.php
+++ b/src/Schema/Blueprint.php
@@ -17,6 +17,7 @@
 use function key;
 
 /**
+ * @link https://www.mongodb.com/docs/atlas/atlas-search/define-field-mappings/#std-label-fts-field-mappings
  * @phpstan-type TypeSearchIndexField array{
  *     type: 'boolean'|'date'|'dateFacet'|'objectId'|'stringFacet'|'uuid',
  * } | array{
@@ -51,6 +52,7 @@
  *     multi?: array<string, array<mixed>>,
  *     norms?: 'include'|'omit',
  * }
+ * @link https://www.mongodb.com/docs/atlas/atlas-search/analyzers/character-filters/
  * @phpstan-type TypeSearchIndexCharFilter array{
  *      type: 'icuNormalize'|'persian',
  *  } | array{
@@ -60,18 +62,22 @@
  *     type: 'mapping',
  *     mappings?: array<string, string>,
  * }
+ * @link https://www.mongodb.com/docs/atlas/atlas-search/analyzers/token-filters/
  * @phpstan-type TypeSearchIndexTokenFilter array{type: string, ...}
+ * @link https://www.mongodb.com/docs/atlas/atlas-search/analyzers/custom/
  * @phpstan-type TypeSearchIndexAnalyzer array{
  *     name: string,
  *     charFilters?: TypeSearchIndexCharFilter,
  *     tokenizer: array{type: string},
  *     tokenFilters?: TypeSearchIndexTokenFilter,
  * }
+ * @link https://www.mongodb.com/docs/atlas/atlas-search/stored-source-definition/#std-label-fts-stored-source-definition
  * @phpstan-type TypeSearchIndexStoredSource bool | array{
  *     includes: array<string>,
  * } | array{
  *     excludes: array<string>,
  * }
+ * @link https://www.mongodb.com/docs/manual/reference/command/createSearchIndexes/#std-label-search-index-definition-create
  * @phpstan-type TypeSearchIndexDefinition array{
  *     analyser?: string,
  *     analyzers?: TypeSearchIndexAnalyzer[],
@@ -79,6 +85,7 @@
  *     mappings: array{dynamic: true} | array{dynamic?: bool, fields: array<string, TypeSearchIndexField>},
  *     storedSource?: TypeSearchIndexStoredSource,
  * }
+ * @link https://www.mongodb.com/docs/atlas/atlas-vector-search/vector-search-type/#atlas-vector-search-index-fields
  * @phpstan-type TypeVectorSearchIndexField array{
  *     type: 'vector',
  *     path: string,
@@ -89,6 +96,7 @@
  *     type: 'filter',
  *     path: string,
  * }
+ * @link https://www.mongodb.com/docs/atlas/atlas-vector-search/vector-search-type/#atlas-vector-search-index-fields
  * @phpstan-type TypeVectorSearchIndexDefinition array{
  *     fields: array<string, TypeVectorSearchIndexField>,
  * }
@@ -383,7 +391,7 @@ public function sparse_and_unique($columns = null, $options = [])
     /**
      * Create an Atlas Search Index.
      *
-     * @see https://www.mongodb.com/docs/manual/reference/command/createSearchIndexes/
+     * @see https://www.mongodb.com/docs/manual/reference/command/createSearchIndexes/#std-label-search-index-definition-create
      *
      * @phpstan-param TypeSearchIndexDefinition $definition
      */
@@ -397,7 +405,7 @@ public function searchIndex(array $definition, string $name = 'default'): static
     /**
      * Create an Atlas Vector Search Index.
      *
-     * @see https://www.mongodb.com/docs/atlas/atlas-vector-search/
+     * @see https://www.mongodb.com/docs/manual/reference/command/createSearchIndexes/#std-label-vector-search-index-definition-create
      *
      * @phpstan-param TypeVectorSearchIndexDefinition $definition
      */