feat: build workspace context then resolve dependencies (#68)

* refactor: generate workspace context

* remove virtual document

* remove compatible properties

* expose nameRange & specRange directly

* move specific logic into extractor

* extract package-manager-detect

* use more ResolvedDependencyInfo

* lazy init

* fix: get workspace file correctly

* fix: check resolvedProtocol instead of `isSupportedProtocol`

* fix: watch files change, more logs

* refactor: class WorkspaceContext

* rename

* update

* fix: correctly handle version spec

* ci: fix

* feat: get extractor by file extension

* fix: only watch document text changes, no active editor changes listening

* fix: ensure workspace context initial

* fix: issues reported by coderabbit

* refactor: re-organize

* reloadWorkspace when workspace-level files change

* don't require name and version

Author: 9romise

CONTRIBUTING.md

@@ -83,7 +83,10 @@ playground/             # Playground for testing
 res/                    # Assets (e.g. marketplace icon)
 src/                    # Extension source code
 ├── commands/           # Command handlers (vscode API only, no reactive-vscode)
-├── extractors/         # Extractors (package.json, pnpm-workspace.yaml)
+├── composables/        # Composables (reactive-vscode hooks)
+├── core/               # Core logic
+│   ├── extractors/     # Extractors (JSON, YAML)
+│   └── workspace.ts    # Workspace context resolution
 ├── providers/          # Providers
 │   ├── code-actions/   # Code action providers (quick fixes)
 │   ├── completion-item/ # Completion providers (version autocomplete)
@@ -101,9 +104,17 @@ tests/                  # Tests
 ├── __setup__/          # Test setup and utilities
 ├── code-actions/       # Code action tests
 ├── diagnostics/        # Diagnostic tests
+├── fixtures/           # Test fixtures (workspace scenarios)
 └── utils/              # Utility tests
 ```
 
+### Key concepts
+
+- **Extractor** – Parses a supported file (`package.json`, `pnpm-workspace.yaml`, `.yarnrc.yml`) and extracts dependency information with AST ranges. Each file format has its own extractor in `src/core/extractors/`.
+- **WorkspaceContext** – Holds per-workspace-folder state: detected package manager, resolved catalogs, and memoized dependency info. Created lazily and invalidated when workspace-level files change.
+- **ResolvedDependencyInfo** – A dependency with its protocol resolved (e.g., `catalog:` → actual version, `npm:alias@version` → underlying package). Providers consume resolved dependencies instead of raw AST data.
+- **Provider** – VS Code language feature (hover, completion, diagnostics, etc.) that operates on resolved dependencies.
+
 ## Code style
 
 When committing changes, try to keep an eye out for unintended formatting updates. These can make a pull request look noisier than it really is and slow down the review process. Sometimes IDEs automatically reformat files on save, which can unintentionally introduce extra changes.
@@ -122,7 +133,7 @@ If you want to get ahead of any formatting issues, you can also run `pnpm lint:f
 > This will be fixed by eslint.
 
 1. Type imports first (`import type { ... }`)
-2. Internal aliases (`#constants`, `#utils/`, `#composables/`, etc.)
+2. Internal aliases (`#constants`, `#state`, `#utils/`, `#core/`, `#composables/`, `#types/`, etc.)
 3. External packages (including `node:`)
 4. Relative imports (`./`, `../`)
 5. No blank lines between groups

README.md

@@ -27,6 +27,7 @@
 
 - **Hover Information** – Quick links to package details and documentation on [npmx.dev](https://npmx.dev), with provenance verification status.
 - **Version Completion** – Autocomplete package versions with provenance filtering and prerelease exclusion support.
+- **Workspace-Aware Resolution** – Dependencies in `package.json`, `pnpm-workspace.yaml`, and `.yarnrc.yml` are resolved from a shared workspace context, including catalogs and workspace references.
 - **Diagnostics**
   - Deprecated package warnings with deprecation messages
   - Package replacement suggestions (via [module-replacements](https://github.com/es-tooling/module-replacements))

eslint.config.js

@@ -9,7 +9,7 @@ export default defineConfig(
   {
     pnpm: true,
     typescript: true,
-    ignores: ['playground'],
+    ignores: ['playground', 'tests/fixtures'],
   },
   {
     name: 'extensions/all',

package.json

@@ -41,9 +41,7 @@
     "vscode": "^1.101.0"
   },
   "activationEvents": [
-    "workspaceContains:package.json",
-    "workspaceContains:pnpm-workspace.yaml",
-    "workspaceContains:.yarnrc.yml"
+    "workspaceContains:package.json"
   ],
   "contributes": {
     "configuration": {
@@ -231,6 +229,7 @@
     "msw": "catalog:test",
     "nano-staged": "catalog:dev",
     "ofetch": "catalog:inline",
+    "pathe": "catalog:inline",
     "perfect-debounce": "catalog:inline",
     "reactive-vscode": "catalog:inline",
     "semver": "catalog:inline",

pnpm-lock.yaml

@@ -16,6 +16,7 @@ catalogs:
     fast-npm-meta: ^1.3.0
     jsonc-parser: ^3.3.1
     ofetch: ^2.0.0-alpha.3
+    pathe: ^2.0.3
     perfect-debounce: ^2.1.0
     reactive-vscode: ^1.0.0-beta.2
     semver: ^7.7.4

pnpm-workspace.yaml

@@ -41,8 +41,8 @@ export async function openFileInNpmx(fileUri?: Uri) {
   // Construct the npmx.dev URL and open it. VSCode uses 0-indexed lines, npmx uses 1-indexed.
   const { selection } = textEditor ?? {}
   const url = npmxFileUrl(
-    manifest.name,
-    manifest.version,
+    manifest.name!,
+    manifest.version!,
     relativePath,
     openingActiveFile && selection ? selection.start.line + 1 : undefined,
     openingActiveFile && selection ? selection.end.line + 1 : undefined,

src/commands/open-file-in-npmx.ts

@@ -0,0 +1,45 @@
+import type { Uri } from 'vscode'
+import { SUPPORTED_DOCUMENT_PATTERN } from '#constants'
+import { deleteWorkspaceContextCache, getWorkspaceContext } from '#core/workspace'
+import { logger } from '#state'
+import { isSupportedDependencyDocument, isWorkspaceLevelFile } from '#utils/file'
+import { useDisposable, useFileSystemWatcher } from 'reactive-vscode'
+import { window, workspace } from 'vscode'
+
+export function useWorkspaceContext() {
+  useDisposable(workspace.onDidChangeWorkspaceFolders(({ removed }) => {
+    removed.forEach((folder) => {
+      deleteWorkspaceContextCache(folder)
+      logger.info(`[workspace-context] delete workspace folder cache: ${folder.uri.path}`)
+    })
+  }))
+
+  async function deleteCacheByUri(uri: Uri, reload = true) {
+    if (!isSupportedDependencyDocument(uri))
+      return
+
+    const ctx = await getWorkspaceContext(uri)
+    if (!ctx)
+      return
+
+    ctx.loadPackageManifestInfo.delete(uri)
+    ctx.loadWorkspaceCatalogInfo.delete(uri)
+    logger.info(`[workspace-context] delete dependencies cache: ${uri.path}`)
+    if (reload && isWorkspaceLevelFile(uri)) {
+      await ctx.loadWorkspace()
+    }
+  }
+
+  useDisposable(workspace.onDidChangeTextDocument(({ document }) => {
+    if (document !== window.activeTextEditor?.document)
+      return
+
+    deleteCacheByUri(document.uri, false)
+  }))
+
+  const { onDidCreate, onDidChange, onDidDelete } = useFileSystemWatcher(SUPPORTED_DOCUMENT_PATTERN)
+
+  onDidCreate(deleteCacheByUri)
+  onDidChange(deleteCacheByUri)
+  onDidDelete(deleteCacheByUri)
+}

src/composables/workspace-context.ts

@@ -2,6 +2,8 @@ export const PACKAGE_JSON_BASENAME = 'package.json'
 export const PNPM_WORKSPACE_BASENAME = 'pnpm-workspace.yaml'
 export const YARN_WORKSPACE_BASENAME = '.yarnrc.yml'
 
+export const SUPPORTED_DOCUMENT_PATTERN = `**/{${PACKAGE_JSON_BASENAME},${PNPM_WORKSPACE_BASENAME},${YARN_WORKSPACE_BASENAME}}`
+
 export const PRERELEASE_PATTERN = /-.+/
 
 export const CACHE_TTL_ONE_DAY = 1000 * 60 * 60 * 24

src/constants.ts

@@ -0,0 +1,21 @@
+import { extname } from 'pathe'
+import { JsonExtractor } from './json'
+import { YamlExtractor } from './yaml'
+
+const jsonExtractor = new JsonExtractor()
+const yamlExtractor = new YamlExtractor()
+
+const extractorsByExtension = {
+  '.json': jsonExtractor,
+  '.yaml': yamlExtractor,
+  '.yml': yamlExtractor,
+} as const satisfies Record<string, JsonExtractor | YamlExtractor>
+
+type ExtractorByExt<T extends string>
+  = T extends `${string}.json` ? JsonExtractor
+  : T extends `${string}.yaml` | `${string}.yml` ? YamlExtractor
+  : JsonExtractor | YamlExtractor | undefined
+
+export function getExtractor<T extends string>(filename: T): ExtractorByExt<T> {
+  return extractorsByExtension[extname(filename) as keyof typeof extractorsByExtension] as ExtractorByExt<T>
+}