feat(ls): add lint rule for OpenAPI Operation Parameter defined in path template (#3629)

Refs #3546

Author: kowalczyk-krzysztof

packages/apidom-ls/src/services/validation/linter-functions.ts

@@ -1081,9 +1081,18 @@ export const standardLinterfunctions: FunctionItem[] = [
           isArrayElement(element.parent) &&
           includesClasses(['path-item-parameters'], element.parent);
 
-        if (!isInPathItemElement) return true;
+        const isInOperationElement =
+          isArrayElement(element.parent) &&
+          includesClasses(['operation-parameters'], element.parent);
+
+        if (!isInPathItemElement && !isInOperationElement) return true;
+
+        const pathItemElement: Element | undefined = isInOperationElement
+          ? element.parent?.parent?.parent?.parent?.parent
+          : element.parent?.parent?.parent;
+
+        if (pathItemElement?.element !== 'pathItem') return true;
 
-        const pathItemElement = element.parent.parent.parent;
         const isPathItemPartOfPathTemplating = isStringElement(pathItemElement.meta.get('path'));
 
         if (!isPathItemPartOfPathTemplating) return true;

packages/apidom-ls/test/fixtures/validation/oas/parameter-defined-within-path-template-2-0.yaml

@@ -28,4 +28,19 @@ paths:
         required: true
         type: string
         format: uuid
-  
+  /test:
+    get:
+      summary: Get test
+      operationId: getTest
+      responses:
+        '200':
+          description: Successful Response
+      parameters:
+        - name: x_id
+          in: path
+          required: true
+          type: string
+          schema:
+            type: string
+            format: uuid
+            title: X Id

packages/apidom-ls/test/fixtures/validation/oas/parameter-defined-within-path-template-3-0.yaml

@@ -71,4 +71,21 @@ paths:
               responses:
                 '202':
                   description: "OK"
-
+  /test:
+    get:
+      summary: Get test
+      operationId: getTest
+      responses:
+        '200':
+          description: Successful Response
+          content:
+            application/json:
+              schema: {}
+      parameters:
+        - name: x_id
+          in: path
+          required: true
+          schema:
+            type: string
+            format: uuid
+            title: X Id

packages/apidom-ls/test/fixtures/validation/oas/parameter-defined-within-path-template-3-1.yaml

@@ -90,3 +90,21 @@ paths:
               responses:
                 '202':
                   description: "OK"
+  /test:
+    get:
+      summary: Get test
+      operationId: getTest
+      responses:
+        '200':
+          description: Successful Response
+          content:
+            application/json:
+              schema: {}
+      parameters:
+        - name: x_id
+          in: path
+          required: true
+          schema:
+            type: string
+            format: uuid
+            title: X Id

packages/apidom-ls/test/validate.ts

@@ -3586,6 +3586,13 @@ describe('apidom-ls-validate', function () {
         code: 3102000,
         source: 'apilint',
       },
+      {
+        range: { start: { line: 38, character: 10 }, end: { line: 46, character: 0 } },
+        message: 'parameter is not defined within path template',
+        severity: 1,
+        code: 3102000,
+        source: 'apilint',
+      },
     ];
     assert.deepEqual(result, expected as Diagnostic[]);
 
@@ -3628,6 +3635,13 @@ describe('apidom-ls-validate', function () {
         code: 3102000,
         source: 'apilint',
       },
+      {
+        range: { start: { line: 84, character: 10 }, end: { line: 91, character: 0 } },
+        message: 'parameter is not defined within path template',
+        severity: 1,
+        code: 3102000,
+        source: 'apilint',
+      },
     ];
     assert.deepEqual(result, expected as Diagnostic[]);
 
@@ -3670,6 +3684,13 @@ describe('apidom-ls-validate', function () {
         code: 3102000,
         source: 'apilint',
       },
+      {
+        range: { start: { line: 103, character: 10 }, end: { line: 110, character: 0 } },
+        message: 'parameter is not defined within path template',
+        severity: 1,
+        code: 3102000,
+        source: 'apilint',
+      },
     ];
     assert.deepEqual(result, expected as Diagnostic[]);