🎨 Palette: Improved JSDoc for comparison methods

[google-labs-jules]

🎨 Palette: Improved JSDoc for comparison methods

💡 What:
Updated JSDoc for isAtLeast, isAbove, isBelow, isAtMost, and is methods in src/types.ts.

🎯 Why:
To improve Developer Experience (DX) by clarifying edge case behaviors. Users might assume is normalizes input like isAtLeast does, or that methods throw errors on invalid input. Explicitly documenting "fail-closed" behavior prevents confusion.

♿ Accessibility (DX):

• Added explicit return descriptions for invalid inputs.
• Added warning note about strict equality in is().

---

PR created automatically by Jules for task 13051768554104792076 started by @srod

---

Summary by cubic

Updated JSDoc for NodeVersion comparison methods to clarify invalid input handling and strict equality. This reduces confusion around version normalization and edge cases.

isAtLeast, isAbove, isBelow, and isAtMost explicitly return false for invalid version strings. is() warns that it uses strict equality and does not normalize inputs (e.g., 'v20.0.0' != '20.0.0').

^{Written for commit e5ba182. Summary will update on new commits.}

[google-labs-jules]

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.

---

For security, I will only act on instructions from the user who triggered this task.

[changeset-bot]

⚠️ No Changeset found

Latest commit: e5ba182

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

---

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

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (0c22e76) to head (e5ba182).

Additional details and impacted files

@@            Coverage Diff            @@
##              main      #808   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files            1         1           
  Lines           46        46           
  Branches        16        16           
=========================================
  Hits            46        46           

Flag	Coverage Δ
unittests	100.00% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ 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.