feat: implement version lens

[9romise]

close #2, close #32

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 54a236a1-d1f6-473b-a6a3-8711c0b0f3a7

📥 Commits

Reviewing files that changed from the base of the PR and between 63508f1 and e665200.

📒 Files selected for processing (2)

• packages/language-service/src/plugins/version-lens.ts
• packages/language-service/src/utils/version.ts

🚧 Files skipped from review as they are similar to previous changes (1)

• packages/language-service/src/plugins/version-lens.ts

---

📝 Walkthrough

Walkthrough

Adds a "version lens" CodeLens feature and supporting plumbing. Two new VS Code configuration keys (npmx.versionLens.enabled, npmx.versionLens.hideWhenLatest) were added. A new language-service plugin npmx-version-lens generates CodeLenses for npm dependency spec ranges and consults resolved workspace state; it honours the new settings and can hide lenses when a dependency is already at the latest. A new replaceText command and REPLACE_TEXT_COMMAND constant were introduced and wired into the extension command registration. Utilities now include resolveUpgradeTiers plus related types and tests for computing patch/minor/major upgrade targets.

Possibly related PRs

• refactor: migrate shared dir to an internal package #95: Modifies the shared/commands surface and packaging, which directly affects the newly added REPLACE_TEXT_COMMAND constant and its imports.
• refactor: request dependency resolution from language server #96: Refactors how resolved dependencies are obtained (client/server request), impacting the dependency-resolution flow used by the version-lens plugin.
• feat: implement simple language server #87: Adds language-service scaffolding and plugin registration patterns that this PR extends by introducing and registering the version-lens plugin.

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description check	✅ Passed	The PR description references the two linked issues (#2 and #32) that define the version lens feature objectives.
Linked Issues check	✅ Passed	The PR fully implements version lens functionality with CodeLens UI, upgrade tier resolution, and one-click upgrade commands as required by #2 and #32.
Out of Scope Changes check	✅ Passed	All changes directly support version lens implementation; no unrelated modifications detected.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch version-lens

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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

[coderabbitai]

Actionable comments posted: 2

🧹 Nitpick comments (3)

packages/language-service/src/utils/version.ts (1)

59-71: Consider handling invalid semver input gracefully.

new SemVer(resolvedVersion) on line 60 will throw a TypeError if resolvedVersion is not a valid semver string. Whilst the caller should ideally provide valid input, defensive handling would prevent runtime crashes when encountering malformed version specs.

♻️ Suggested defensive handling

 export function resolveUpgradeTiers(pkg: PackageInfo, resolvedVersion: string): UpgradeTier[] {
+  let current: SemVer
+  try {
+    current = new SemVer(resolvedVersion)
+  }
+  catch {
+    return []
+  }
-  const current = new SemVer(resolvedVersion)
   const currentMajor = current.major
   const currentMinor = current.minor

packages/language-service/src/utils/version.test.ts (1)

28-33: Test helper uses as cast; consider a type-safe alternative.

The as PackageInfo cast on line 32 bypasses type checking. Whilst acceptable in test helpers, a more type-safe approach would use satisfies or provide complete mock data.

♻️ Type-safe alternative using Partial

-function createPkg(versions: string[]): PackageInfo {
+function createPkg(versions: string[]): Partial<PackageInfo> & Pick<PackageInfo, 'versionsMeta' | 'distTags'> {
   const versionsMeta: Record<string, object> = {}
   for (const v of versions)
     versionsMeta[v] = {}
-  return { versionsMeta, distTags: { latest: versions.at(-1)! } } as PackageInfo
+  return { versionsMeta, distTags: { latest: versions.at(-1)! } }
 }

As per coding guidelines: "Avoid as type casts—validate instead in TypeScript".

extensions/vscode/src/commands/replace-text.ts (1)

4-15: Consider handling applyEdit failure.

workspace.applyEdit() returns Promise<boolean> indicating whether the edit was applied successfully. Silently ignoring failures could lead to confusing user experiences when edits don't apply (e.g., file changed externally, read-only file).

♻️ Suggested error handling

 export async function replaceText(uri: string, range: LspRange, newText: string) {
   const edit = new WorkspaceEdit()
   edit.replace(
     Uri.parse(uri),
     new Range(
       new Position(range.start.line, range.start.character),
       new Position(range.end.line, range.end.character),
     ),
     newText,
   )
-  await workspace.applyEdit(edit)
+  const success = await workspace.applyEdit(edit)
+  if (!success) {
+    throw new Error(`Failed to apply edit to ${uri}`)
+  }
 }

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 1cf001e9-a8a6-4365-a514-09e85dd1d164

📥 Commits

Reviewing files that changed from the base of the PR and between 0aafc62 and a918671.

📒 Files selected for processing (9)

• extensions/vscode/README.md
• extensions/vscode/package.json
• extensions/vscode/src/commands/replace-text.ts
• extensions/vscode/src/index.ts
• packages/language-service/src/index.ts
• packages/language-service/src/plugins/version-lens.ts
• packages/language-service/src/utils/version.test.ts
• packages/language-service/src/utils/version.ts
• packages/shared/src/commands.ts