diff --git a/.yarn/cache/@es-joy-jsdoccomment-npm-0.36.1-de9c38dcc4-28e6977792.zip b/.yarn/cache/@es-joy-jsdoccomment-npm-0.36.1-de9c38dcc4-28e6977792.zip deleted file mode 100644 index 7562d40e84bc..000000000000 Binary files a/.yarn/cache/@es-joy-jsdoccomment-npm-0.36.1-de9c38dcc4-28e6977792.zip and /dev/null differ diff --git a/.yarn/cache/@es-joy-jsdoccomment-npm-0.39.4-48cba32ec8-efae229ae9.zip b/.yarn/cache/@es-joy-jsdoccomment-npm-0.39.4-48cba32ec8-efae229ae9.zip new file mode 100644 index 000000000000..0463d6249482 Binary files /dev/null and b/.yarn/cache/@es-joy-jsdoccomment-npm-0.39.4-48cba32ec8-efae229ae9.zip differ diff --git a/.yarn/cache/are-docs-informative-npm-0.0.2-92d10d3088-7a48ca90d6.zip b/.yarn/cache/are-docs-informative-npm-0.0.2-92d10d3088-7a48ca90d6.zip new file mode 100644 index 000000000000..b1b603846540 Binary files /dev/null and b/.yarn/cache/are-docs-informative-npm-0.0.2-92d10d3088-7a48ca90d6.zip differ diff --git a/.yarn/cache/eslint-plugin-jsdoc-npm-40.0.0-17c381e02e-ef8b45cdfd.zip b/.yarn/cache/eslint-plugin-jsdoc-npm-40.0.0-17c381e02e-ef8b45cdfd.zip deleted file mode 100644 index a54c2850b8c8..000000000000 Binary files a/.yarn/cache/eslint-plugin-jsdoc-npm-40.0.0-17c381e02e-ef8b45cdfd.zip and /dev/null differ diff --git a/.yarn/cache/eslint-plugin-jsdoc-npm-46.4.4-4882d4b62d-bc97f2f146.zip b/.yarn/cache/eslint-plugin-jsdoc-npm-46.4.4-4882d4b62d-bc97f2f146.zip new file mode 100644 index 000000000000..7d4fa7a59f21 Binary files /dev/null and b/.yarn/cache/eslint-plugin-jsdoc-npm-46.4.4-4882d4b62d-bc97f2f146.zip differ diff --git a/.yarn/cache/is-builtin-module-npm-3.2.0-8f435dc375-0315751b89.zip b/.yarn/cache/is-builtin-module-npm-3.2.1-2f92a5d353-e8f0ffc19a.zip similarity index 52% rename from .yarn/cache/is-builtin-module-npm-3.2.0-8f435dc375-0315751b89.zip rename to .yarn/cache/is-builtin-module-npm-3.2.1-2f92a5d353-e8f0ffc19a.zip index c9f1eaeed757..be908976b53b 100644 Binary files a/.yarn/cache/is-builtin-module-npm-3.2.0-8f435dc375-0315751b89.zip and b/.yarn/cache/is-builtin-module-npm-3.2.1-2f92a5d353-e8f0ffc19a.zip differ diff --git a/.yarn/cache/jsdoc-type-pratt-parser-npm-3.1.0-9148b2c1c9-2f437b5762.zip b/.yarn/cache/jsdoc-type-pratt-parser-npm-3.1.0-9148b2c1c9-2f437b5762.zip deleted file mode 100644 index ab3ba20bc161..000000000000 Binary files a/.yarn/cache/jsdoc-type-pratt-parser-npm-3.1.0-9148b2c1c9-2f437b5762.zip and /dev/null differ diff --git a/.yarn/cache/jsdoc-type-pratt-parser-npm-4.0.0-7b035921c4-af0629c951.zip b/.yarn/cache/jsdoc-type-pratt-parser-npm-4.0.0-7b035921c4-af0629c951.zip new file mode 100644 index 000000000000..975b3d2ec29a Binary files /dev/null and b/.yarn/cache/jsdoc-type-pratt-parser-npm-4.0.0-7b035921c4-af0629c951.zip differ diff --git a/.yarn/cache/semver-npm-7.5.3-275095dbf3-9d58db1652.zip b/.yarn/cache/semver-npm-7.5.4-c4ad957fcd-12d8ad952f.zip similarity index 77% rename from .yarn/cache/semver-npm-7.5.3-275095dbf3-9d58db1652.zip rename to .yarn/cache/semver-npm-7.5.4-c4ad957fcd-12d8ad952f.zip index 79b7d4718cac..f8689471f58f 100644 Binary files a/.yarn/cache/semver-npm-7.5.3-275095dbf3-9d58db1652.zip and b/.yarn/cache/semver-npm-7.5.4-c4ad957fcd-12d8ad952f.zip differ diff --git a/config/eslint-config-carbon/package.json b/config/eslint-config-carbon/package.json index aae1410bd332..0afbf46c6133 100644 --- a/config/eslint-config-carbon/package.json +++ b/config/eslint-config-carbon/package.json @@ -41,7 +41,7 @@ "eslint-plugin-import": "^2.27.5", "eslint-plugin-jest": "^27.0.0", "eslint-plugin-jest-dom": "^5.0.0", - "eslint-plugin-jsdoc": "^40.0.0", + "eslint-plugin-jsdoc": "^46.0.0", "eslint-plugin-jsx-a11y": "^6.7.1", "eslint-plugin-prettier": "^4.2.1", "eslint-plugin-react": "^7.32.2", diff --git a/packages/react/src/components/OverflowMenu/OverflowMenu.js b/packages/react/src/components/OverflowMenu/OverflowMenu.js index 86d5e66e9bbe..8497fa4d4421 100644 --- a/packages/react/src/components/OverflowMenu/OverflowMenu.js +++ b/packages/react/src/components/OverflowMenu/OverflowMenu.js @@ -36,7 +36,7 @@ const on = (element, ...args) => { /** * The CSS property names of the arrow keyed by the floating menu direction. - * @type {Object} + * @type {[key: string]: string} */ const triggerButtonPositionProps = { [DIRECTION_TOP]: 'bottom', @@ -45,7 +45,7 @@ const triggerButtonPositionProps = { /** * Determines how the position of arrow should affect the floating menu position. - * @type {Object} + * @type {[key: string]: number} */ const triggerButtonPositionFactors = { [DIRECTION_TOP]: -2, diff --git a/packages/react/src/prop-types/isRequiredOneOf.js b/packages/react/src/prop-types/isRequiredOneOf.js index 253bf7d97509..9c89311a3250 100644 --- a/packages/react/src/prop-types/isRequiredOneOf.js +++ b/packages/react/src/prop-types/isRequiredOneOf.js @@ -6,8 +6,8 @@ */ /** - * @param {Object} propTypes The list of type checkers, keyed by prop names. - * @returns {Object} + * @param {[key: string]: Function)} propTypes The list of type checkers, keyed by prop names. + * @returns {[key: string]: Function} * The new prop type checkers that checks if one of the given props exist, * in addition to the original type checkings. */ diff --git a/packages/upgrade/src/commands/migrate.js b/packages/upgrade/src/commands/migrate.js index 129fffe57dfd..2e6f4a0ceb83 100644 --- a/packages/upgrade/src/commands/migrate.js +++ b/packages/upgrade/src/commands/migrate.js @@ -71,7 +71,7 @@ function listMigrations(migrations) { } /** - * @param {Object} migration + * @param {object} migration * @param {Array} workspaces * @returns {} */ diff --git a/yarn.lock b/yarn.lock index 6bf898f2f332..60156ce9324c 100644 --- a/yarn.lock +++ b/yarn.lock @@ -3195,14 +3195,14 @@ __metadata: languageName: node linkType: hard -"@es-joy/jsdoccomment@npm:~0.36.1": - version: 0.36.1 - resolution: "@es-joy/jsdoccomment@npm:0.36.1" +"@es-joy/jsdoccomment@npm:~0.39.4": + version: 0.39.4 + resolution: "@es-joy/jsdoccomment@npm:0.39.4" dependencies: comment-parser: 1.3.1 - esquery: ^1.4.0 - jsdoc-type-pratt-parser: ~3.1.0 - checksum: 28e697779230dc6a95b1f233a8c2a72b64fbea686e407106e5d4292083421a997452731c414de26c10bee86e8e0397c5fb84d6ecfd4b472a29735e1af103ddb6 + esquery: ^1.5.0 + jsdoc-type-pratt-parser: ~4.0.0 + checksum: efae229ae998840fdcb4faf44574bcc0a070e4aa6df69c01afedaeaddf6d2ea857a68b463df45f9437231201201f092402968c0c53c34e3c09842fef0da7f2d4 languageName: node linkType: hard @@ -9041,6 +9041,13 @@ __metadata: languageName: node linkType: hard +"are-docs-informative@npm:^0.0.2": + version: 0.0.2 + resolution: "are-docs-informative@npm:0.0.2" + checksum: 7a48ca90d66e29afebc4387d7029d86cfe97bad7e796c8e7de01309e02dcfc027250231c02d4ca208d2984170d09026390b946df5d3d02ac638ab35f74501c74 + languageName: node + linkType: hard + "are-we-there-yet@npm:^2.0.0": version: 2.0.0 resolution: "are-we-there-yet@npm:2.0.0" @@ -14238,7 +14245,7 @@ __metadata: eslint-plugin-import: ^2.27.5 eslint-plugin-jest: ^27.0.0 eslint-plugin-jest-dom: ^5.0.0 - eslint-plugin-jsdoc: ^40.0.0 + eslint-plugin-jsdoc: ^46.0.0 eslint-plugin-jsx-a11y: ^6.7.1 eslint-plugin-prettier: ^4.2.1 eslint-plugin-react: ^7.32.2 @@ -14512,20 +14519,22 @@ __metadata: languageName: node linkType: hard -"eslint-plugin-jsdoc@npm:^40.0.0": - version: 40.0.0 - resolution: "eslint-plugin-jsdoc@npm:40.0.0" +"eslint-plugin-jsdoc@npm:^46.0.0": + version: 46.4.4 + resolution: "eslint-plugin-jsdoc@npm:46.4.4" dependencies: - "@es-joy/jsdoccomment": ~0.36.1 + "@es-joy/jsdoccomment": ~0.39.4 + are-docs-informative: ^0.0.2 comment-parser: 1.3.1 debug: ^4.3.4 escape-string-regexp: ^4.0.0 - esquery: ^1.4.0 - semver: ^7.3.8 + esquery: ^1.5.0 + is-builtin-module: ^3.2.1 + semver: ^7.5.1 spdx-expression-parse: ^3.0.1 peerDependencies: eslint: ^7.0.0 || ^8.0.0 - checksum: ef8b45cdfd931675afa9fe7e85c079f8c6e6966d44037275617e48d1f64166f84b97ddc7f6e21b4ff7687a327de771fba9795c232ff59f4adbd60a383e99f8c4 + checksum: bc97f2f146aedcf43b1610a80eb9623deb365a30ba54eb37e6f82c6f205136aa51f67a65b0625729cb33ec941710bfa08d9d18b59296e2d84c2fd6a57d63c2be languageName: node linkType: hard @@ -14833,7 +14842,7 @@ __metadata: languageName: node linkType: hard -"esquery@npm:^1.4.0, esquery@npm:^1.4.2": +"esquery@npm:^1.4.2, esquery@npm:^1.5.0": version: 1.5.0 resolution: "esquery@npm:1.5.0" dependencies: @@ -17841,12 +17850,12 @@ __metadata: languageName: node linkType: hard -"is-builtin-module@npm:^3.2.0": - version: 3.2.0 - resolution: "is-builtin-module@npm:3.2.0" +"is-builtin-module@npm:^3.2.0, is-builtin-module@npm:^3.2.1": + version: 3.2.1 + resolution: "is-builtin-module@npm:3.2.1" dependencies: builtin-modules: ^3.3.0 - checksum: 0315751b898feff0646511c896e88b608a755c5025d0ce9a3ad25783de50be870e47dafb838cebbb06fbb2a948b209ea55348eee267836c9dd40d3a11ec717d3 + checksum: e8f0ffc19a98240bda9c7ada84d846486365af88d14616e737d280d378695c8c448a621dcafc8332dbf0fcd0a17b0763b845400709963fa9151ddffece90ae88 languageName: node linkType: hard @@ -19888,10 +19897,10 @@ __metadata: languageName: node linkType: hard -"jsdoc-type-pratt-parser@npm:~3.1.0": - version: 3.1.0 - resolution: "jsdoc-type-pratt-parser@npm:3.1.0" - checksum: 2f437b57621f1e481918165f6cf0e48256628a9e510d8b3f88a2ab667bf2128bf8b94c628b57c43e78f555ca61983e9c282814703840dc091d2623992214a061 +"jsdoc-type-pratt-parser@npm:~4.0.0": + version: 4.0.0 + resolution: "jsdoc-type-pratt-parser@npm:4.0.0" + checksum: af0629c9517e484be778d8564440fec8de5b7610e0c9c88a3ba4554321364faf72b46689c8d8845faa12c0718437a9ed97e231977efc0f2d50e8a2dbad807eb3 languageName: node linkType: hard @@ -28053,14 +28062,14 @@ __metadata: languageName: node linkType: hard -"semver@npm:^7.0.0, semver@npm:^7.1.1, semver@npm:^7.3.2, semver@npm:^7.3.4, semver@npm:^7.3.5, semver@npm:^7.3.7, semver@npm:^7.3.8": - version: 7.5.3 - resolution: "semver@npm:7.5.3" +"semver@npm:^7.0.0, semver@npm:^7.1.1, semver@npm:^7.3.2, semver@npm:^7.3.4, semver@npm:^7.3.5, semver@npm:^7.3.7, semver@npm:^7.3.8, semver@npm:^7.5.1": + version: 7.5.4 + resolution: "semver@npm:7.5.4" dependencies: lru-cache: ^6.0.0 bin: semver: bin/semver.js - checksum: 9d58db16525e9f749ad0a696a1f27deabaa51f66e91d2fa2b0db3de3e9644e8677de3b7d7a03f4c15bc81521e0c3916d7369e0572dbde250d9bedf5194e2a8a7 + checksum: 12d8ad952fa353b0995bf180cdac205a4068b759a140e5d3c608317098b3575ac2f1e09182206bf2eb26120e1c0ed8fb92c48c592f6099680de56bb071423ca3 languageName: node linkType: hard