Move Projection operators to a dedicated namespace

.gitattributes

@@ -20,4 +20,5 @@ psalm-baseline.xml export-ignore
 # https://docs.github.com/en/repositories/working-with-files/managing-files/customizing-how-changed-files-appear-on-github
 /src/Builder/Expression/*.php linguist-generated=true
 /src/Builder/Query/*.php linguist-generated=true
+/src/Builder/Projection/*.php linguist-generated=true
 /src/Builder/Stage/*.php linguist-generated=true

generator/config/definitions.php

@@ -38,4 +38,15 @@
             OperatorFactoryGenerator::class,
         ],
     ],
+
+    // Projection Operators
+    [
+        'configFiles' => __DIR__ . '/projection',
+        'namespace' => 'MongoDB\\Builder\\Projection',
+        'classNameSuffix' => 'Operator',
+        'generators' => [
+            OperatorClassGenerator::class,
+            OperatorFactoryGenerator::class,
+        ],
+    ],
 ];

generator/config/expression/meta.yaml

@@ -4,7 +4,7 @@ category:
     - 'Text Expression Operator'
 link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/meta/'
 type:
-    - resolvesToDecimal
+    - resolvesToAny
 encode: single
 description: |
     Access available per-document metadata related to the aggregation operation.

generator/config/projection/elemMatch.yaml

@@ -0,0 +1,15 @@
+# $schema: ../schema.json
+name: $elemMatch
+category:
+    - 'Projection Operators'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/projection/elemMatch/'
+type:
+    - projection
+encode: object
+description: |
+    Projects the first element in an array that matches the specified $elemMatch condition.
+arguments:
+    -
+        name: query
+        type:
+            - query

generator/config/query/elemMatch.yaml

@@ -1,16 +1,15 @@
 # $schema: ../schema.json
 name: $elemMatch
 category:
-    - 'Projection Operators'
+    - 'Array Query Operators'
 link: 'https://www.mongodb.com/docs/manual/reference/operator/query/elemMatch/'
 type:
     - filter
-    - projection
 encode: object
 description: |
-    Projects the first element in an array that matches the specified $elemMatch condition.
+    The $elemMatch operator matches documents that contain an array field with at least one element that matches all the specified query criteria.
 arguments:
     -
-        name: queries
+        name: query
         type:
             - query

phpcs.xml.dist

@@ -20,7 +20,7 @@
     <file>rector.php</file>
 
     <!-- Ignore auto-generated code -->
-    <exclude-pattern>src/Builder/(Expression|Query|Stage)/*\.php</exclude-pattern>
+    <exclude-pattern>src/Builder/(Expression|Query|Projection|Stage)/*\.php</exclude-pattern>
 
     <!-- Target minimum supported PHP version -->
     <config name="php_version" value="70400"/>

src/Builder/Projection.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace MongoDB\Builder;
+
+use MongoDB\Builder\Projection\FactoryTrait;
+
+enum Projection
+{
+    use FactoryTrait;
+}

src/Builder/architecture.md

@@ -88,7 +88,7 @@ result types would be rejected.
 We rely on the server will reject the query if the expression is not of the expected type.
 
 
-# Query & Filter
+## Query & Filter
 
 The `query` are used in a `$match`, `$geoNear` or `$graphLookup` stages and `$elemMatch` operator.
 The `filter` are used compose query. A query is a map of field name to filter and/or a list of other queries.
@@ -127,10 +127,7 @@ Stage::match(Query::query(...));
 
 # Projection
 
-
-
-
-
+Projection operators have a dedicated namespace and interface.
 
 # Specificities