test(valid-types): example demonstrating array object properties; closes #596

Author: brettz9

README.md

@@ -22663,6 +22663,18 @@ function quux() {
  */
 function quux ( id, options ) {
 }
+
+
+/**
+ * Assign the project to a list of employees.
+ * @param {Object[]} employees - The employees who are responsible for the project.
+ * @param {string} employees[].name - The name of an employee.
+ * @param {string} employees[].department - The employee's department.
+ */
+function assign(employees) {
+  // ...
+}
+// "jsdoc/valid-types": ["error"|"warn", {"allowEmptyNamepaths":true,"checkSeesForNamepaths":false}]
 ````
 
 

src/rules/noUndefinedTypes.js

@@ -19,8 +19,8 @@ const extraTypes = [
   'Array', 'Object', 'RegExp', 'Date', 'Function',
 ];
 
-// https://www.typescriptlang.org/docs/handbook/utility-types.html
 const typescriptGlobals = [
+  // https://www.typescriptlang.org/docs/handbook/utility-types.html
   'Partial',
   'Required',
   'Readonly',

test/rules/assertions/validTypes.js

@@ -1619,5 +1619,25 @@ export default {
       `,
       ignoreReadme: true,
     },
+    {
+      code: `
+
+      /**
+       * Assign the project to a list of employees.
+       * @param {Object[]} employees - The employees who are responsible for the project.
+       * @param {string} employees[].name - The name of an employee.
+       * @param {string} employees[].department - The employee's department.
+       */
+      function assign(employees) {
+        // ...
+      }
+      `,
+      options: [
+        {
+          allowEmptyNamepaths: true,
+          checkSeesForNamepaths: false,
+        },
+      ],
+    },
   ],
 };