Skip to content

Conversation

@AlexSkrypnyk
Copy link
Member

@AlexSkrypnyk AlexSkrypnyk commented Oct 31, 2025

Summary by CodeRabbit

  • Chores
    • Added a development formatting plugin (prettier-plugin-jsdoc) and enabled it in the project's Prettier configuration.
  • Documentation
    • Cleaned up and standardized JSDoc comments in internal scripts for improved inline documentation and consistent formatting.

@coderabbitai
Copy link

coderabbitai bot commented Oct 31, 2025

Walkthrough

Added the Prettier JSDoc plugin to devDependencies and enabled it in Prettier config; adjusted JSDoc comment formatting in one JS file. No runtime logic or scripts changed.

Changes

Cohort / File(s) Summary
Prettier plugin dependency
package.json
Added devDependency prettier-plugin-jsdoc^1.5.0.
Prettier configuration
.prettierrc.json
Added top-level plugins entry with ["prettier-plugin-jsdoc"].
JSDoc comment tweaks
web/modules/custom/ys_base/js/ys_base.js
Minor JSDoc formatting/line-break adjustments for initCounterBlock and removeUpdatedClassAfterDelay params; no code behavior changes.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Verify package.json devDependency entry and version.
  • Confirm .prettierrc.json plugins entry is valid JSON and correctly references the plugin.
  • Skim ys_base.js to ensure JSDoc edits are comment-only.

Poem

🐇 I nibble docs with careful paws,
A plugin hops in to tidy the clause,
Lines aligned, annotations neat,
Prettier hums a tidy beat,
Hooray — comments look complete! ✨

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)
Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. You can run @coderabbitai generate docstrings to improve docstring coverage.
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title Check ✅ Passed The pull request title "Added prettier-plugin-jsdoc to the root FE deps and updated other deps." clearly identifies the primary change in the changeset: adding the prettier-plugin-jsdoc package as a devDependency in package.json and configuring it in .prettierrc.json. The title accurately reflects the main objective of the pull request and uses clear, concise language with proper code formatting. While "updated other deps" is somewhat general, it appropriately encompasses the JSDoc formatting updates in ys_base.js that result from applying the new prettier plugin configuration.
✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch feature/update-fe-deps

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: ASSERTIVE

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between e532337 and a9b855b.

⛔ Files ignored due to path filters (7)
  • .vortex/installer/tests/Fixtures/install/_baseline/.prettierrc.json is excluded by !.vortex/installer/tests/Fixtures/**
  • .vortex/installer/tests/Fixtures/install/_baseline/package.json is excluded by !.vortex/installer/tests/Fixtures/**
  • .vortex/installer/tests/Fixtures/install/_baseline/web/modules/custom/sw_base/js/sw_base.js is excluded by !.vortex/installer/tests/Fixtures/**
  • .vortex/installer/tests/Fixtures/install/hosting_acquia/docroot/modules/custom/sw_base/js/sw_base.js is excluded by !.vortex/installer/tests/Fixtures/**
  • .vortex/installer/tests/Fixtures/install/hosting_project_name___acquia/docroot/modules/custom/sw_base/js/sw_base.js is excluded by !.vortex/installer/tests/Fixtures/**
  • .vortex/installer/tests/Fixtures/install/names/web/modules/custom/the_force_base/js/the_force_base.js is excluded by !.vortex/installer/tests/Fixtures/**
  • yarn.lock is excluded by !**/yarn.lock, !**/*.lock
📒 Files selected for processing (3)
  • .prettierrc.json (1 hunks)
  • package.json (1 hunks)
  • web/modules/custom/ys_base/js/ys_base.js (3 hunks)
🧰 Additional context used
📓 Path-based instructions (1)
web/modules/custom/**

📄 CodeRabbit inference engine (CLAUDE.md)

Place all custom Drupal modules under web/modules/custom/[module_name]/.

Files:

  • web/modules/custom/ys_base/js/ys_base.js
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (14)
  • GitHub Check: build (1)
  • GitHub Check: build (0)
  • GitHub Check: vortex-test-workflow (1)
  • GitHub Check: vortex-test-workflow (3)
  • GitHub Check: vortex-test-workflow (4)
  • GitHub Check: vortex-test-workflow (2)
  • GitHub Check: vortex-test-workflow (0)
  • GitHub Check: vortex-test-deployment (1)
  • GitHub Check: vortex-test-deployment (0)
  • GitHub Check: vortex-test-installer (8.3)
  • GitHub Check: vortex-test-common
  • GitHub Check: vortex-test-installer (8.2)
  • GitHub Check: vortex-test-installer (8.4)
  • GitHub Check: vortex-test-docs
🔇 Additional comments (3)
.prettierrc.json (1)

6-6: Configuration correctly enables the Prettier JSDoc plugin.

The plugins configuration is properly placed and follows the documented setup for prettier-plugin-jsdoc.

web/modules/custom/ys_base/js/ys_base.js (2)

14-15: JSDoc formatting properly applied by the plugin.

The parameter description for context is reformatted across multiple lines by prettier-plugin-jsdoc for improved readability, consistent with the plugin's formatting rules. The content remains accurate and descriptive.


77-77: JSDoc parameter description reformatted consistently.

The element parameter description is updated by the plugin to maintain consistent formatting. The documentation content remains clear and accurate.


Comment @coderabbitai help to get the list of available commands and usage tips.

@AlexSkrypnyk AlexSkrypnyk added this to the 25.10.0 milestone Oct 31, 2025
@AlexSkrypnyk AlexSkrypnyk moved this from BACKLOG to In progress in Vortex Oct 31, 2025
@AlexSkrypnyk AlexSkrypnyk enabled auto-merge (rebase) October 31, 2025 02:14
@github-actions github-actions bot temporarily deployed to commit October 31, 2025 02:15 Inactive
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

📜 Review details

Configuration used: CodeRabbit UI

Review profile: ASSERTIVE

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 348f4fe and d290036.

⛔ Files ignored due to path filters (2)
  • .vortex/installer/tests/Fixtures/install/_baseline/package.json is excluded by !.vortex/installer/tests/Fixtures/**
  • yarn.lock is excluded by !**/yarn.lock, !**/*.lock
📒 Files selected for processing (1)
  • package.json (1 hunks)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (14)
  • GitHub Check: build (0)
  • GitHub Check: build (1)
  • GitHub Check: vortex-test-deployment (0)
  • GitHub Check: vortex-test-workflow (4)
  • GitHub Check: vortex-test-common
  • GitHub Check: vortex-test-workflow (3)
  • GitHub Check: vortex-test-deployment (1)
  • GitHub Check: vortex-test-workflow (1)
  • GitHub Check: vortex-test-workflow (2)
  • GitHub Check: vortex-test-workflow (0)
  • GitHub Check: vortex-test-installer (8.3)
  • GitHub Check: vortex-test-installer (8.2)
  • GitHub Check: vortex-test-installer (8.4)
  • GitHub Check: vortex-test-docs
🔇 Additional comments (2)
package.json (2)

1-31: PR title mentions "updated other deps" but only one dependency is added.

The PR title states: "Added prettier-plugin-jsdoc to the root FE deps and updated other deps" (emphasis added). However, the provided diff shows only the addition of prettier-plugin-jsdoc@^1.5.0.

Verify whether other dependencies were updated in this PR, or clarify the PR title if only this plugin was added.


1-31: Clarify scope: PR title mentions "updated other deps" but only one dependency is added.

The PR title states: "Added prettier-plugin-jsdoc to the root FE deps and updated other deps," but the provided diff shows only the addition of prettier-plugin-jsdoc.

Either other dependencies were updated in this PR (but not shown in the diff), or the PR title should be revised for clarity.

@AlexSkrypnyk AlexSkrypnyk disabled auto-merge October 31, 2025 02:23
@codecov
Copy link

codecov bot commented Oct 31, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 64.05%. Comparing base (348f4fe) to head (a9b855b).
⚠️ Report is 3 commits behind head on develop.

Additional details and impacted files
@@           Coverage Diff            @@
##           develop    #2067   +/-   ##
========================================
  Coverage    64.05%   64.05%           
========================================
  Files           92       92           
  Lines         5692     5692           
  Branches        44       44           
========================================
  Hits          3646     3646           
  Misses        2046     2046           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@AlexSkrypnyk AlexSkrypnyk force-pushed the feature/update-fe-deps branch from d290036 to e532337 Compare October 31, 2025 03:37
@github-actions github-actions bot temporarily deployed to commit October 31, 2025 03:39 Inactive
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

📜 Review details

Configuration used: CodeRabbit UI

Review profile: ASSERTIVE

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between d290036 and e532337.

⛔ Files ignored due to path filters (7)
  • .vortex/installer/tests/Fixtures/install/_baseline/.prettierrc.json is excluded by !.vortex/installer/tests/Fixtures/**
  • .vortex/installer/tests/Fixtures/install/_baseline/package.json is excluded by !.vortex/installer/tests/Fixtures/**
  • .vortex/installer/tests/Fixtures/install/_baseline/web/modules/custom/sw_base/js/sw_base.js is excluded by !.vortex/installer/tests/Fixtures/**
  • .vortex/installer/tests/Fixtures/install/hosting_acquia/docroot/modules/custom/sw_base/js/sw_base.js is excluded by !.vortex/installer/tests/Fixtures/**
  • .vortex/installer/tests/Fixtures/install/hosting_project_name___acquia/docroot/modules/custom/sw_base/js/sw_base.js is excluded by !.vortex/installer/tests/Fixtures/**
  • .vortex/installer/tests/Fixtures/install/names/web/modules/custom/the_force_base/js/the_force_base.js is excluded by !.vortex/installer/tests/Fixtures/**
  • yarn.lock is excluded by !**/yarn.lock, !**/*.lock
📒 Files selected for processing (3)
  • .prettierrc.json (1 hunks)
  • package.json (1 hunks)
  • web/modules/custom/ys_base/js/ys_base.js (2 hunks)
🧰 Additional context used
📓 Path-based instructions (1)
web/modules/custom/**

📄 CodeRabbit inference engine (CLAUDE.md)

Place all custom Drupal modules under web/modules/custom/[module_name]/.

Files:

  • web/modules/custom/ys_base/js/ys_base.js
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (14)
  • GitHub Check: build (0)
  • GitHub Check: build (1)
  • GitHub Check: vortex-test-deployment (1)
  • GitHub Check: vortex-test-workflow (4)
  • GitHub Check: vortex-test-deployment (0)
  • GitHub Check: vortex-test-workflow (2)
  • GitHub Check: vortex-test-workflow (3)
  • GitHub Check: vortex-test-workflow (1)
  • GitHub Check: vortex-test-workflow (0)
  • GitHub Check: vortex-test-common
  • GitHub Check: vortex-test-installer (8.4)
  • GitHub Check: vortex-test-installer (8.3)
  • GitHub Check: vortex-test-installer (8.2)
  • GitHub Check: vortex-test-docs
🔇 Additional comments (3)
.prettierrc.json (1)

6-6: Plugin registration correctly configured.

The prettier-plugin-jsdoc is now properly registered in the Prettier configuration and will be loaded at runtime. This aligns with the dependency addition and enables JSDoc formatting.

web/modules/custom/ys_base/js/ys_base.js (2)

14-15: JSDoc parameter description reformatted by plugin.

The context parameter description has been adjusted for line-break formatting. This is a documentation-only change with no impact on function behavior.


77-77: JSDoc parameter description consolidated to single line.

The element parameter description has been reformatted to a single line. This is a documentation-only change with no impact on function behavior.

"eslint-plugin-prettier": "^5.5.4",
"eslint-plugin-yml": "^1.16.0",
"prettier": "^3.6.2",
"prettier-plugin-jsdoc": "^1.5.0",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

Verify prettier-plugin-jsdoc version availability.

Previous review flagged version ^1.5.0 as potentially non-existent (suggesting 1.3.3 as the latest). Confirm that this version is currently available on npm and compatible with prettier@^3.6.2.


🌐 Web query:

What is the latest version of prettier-plugin-jsdoc available on npm?

💡 Result:

The latest version on npm is 1.3.3 (published 2 months ago, as of October 31, 2025). [1][2]

Sources:
[1] npm package page — prettier-plugin-jsdoc.
[2] jsDelivr/npm registry listing — prettier-plugin-jsdoc.


Update prettier-plugin-jsdoc to an available version.

The latest version available on npm is 1.3.3. Version 1.5.0 does not exist and will cause npm install to fail. Change to "prettier-plugin-jsdoc": "^1.3.3".

🤖 Prompt for AI Agents
In package.json around line 26, the dependency version for prettier-plugin-jsdoc
is incorrect (1.5.0 doesn't exist); update the version string to a valid
published version such as "^1.3.3" so npm install succeeds, then run npm install
(or yarn) and verify lockfile updates.

@AlexSkrypnyk AlexSkrypnyk force-pushed the feature/update-fe-deps branch from e532337 to a9b855b Compare October 31, 2025 04:10
@github-actions github-actions bot temporarily deployed to commit October 31, 2025 04:12 Inactive
@AlexSkrypnyk AlexSkrypnyk merged commit 3b22b25 into develop Oct 31, 2025
31 checks passed
@AlexSkrypnyk AlexSkrypnyk deleted the feature/update-fe-deps branch October 31, 2025 04:36
@github-project-automation github-project-automation bot moved this from In progress to Release queue in Vortex Oct 31, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Released in 25.10.0

Development

Successfully merging this pull request may close these issues.

2 participants