Skip to content

fix(extensions): declare the typescript peer for the Volar packages - #7232

Merged
arcanis merged 1 commit into
yarnpkg:masterfrom
zkochan:extensions-volar-typescript
Jul 26, 2026
Merged

arcanis merged 1 commit into
yarnpkg:masterfrom
zkochan:extensions-volar-typescript

Conversation

@zkochan

@zkochan zkochan commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

What's the problem this PR addresses?

Five packages in the Volar ecosystem import typescript from their published type declarations without declaring it in dependencies or peerDependencies:

package latest .d.ts files importing typescript example
@volar/typescript 2.4.28 15 index.d.ts:9 — import type * as ts from 'typescript'
@volar/language-server 2.4.28 7 lib/project/typescriptProject.d.ts:2
@volar/language-service 2.4.28 2 lib/types.d.ts:2
volar-service-typescript 0.0.71 14 index.d.ts:4 — create(ts: typeof import('typescript'), …)
volar-service-typescript-twoslash-queries 0.0.71 1 index.d.ts:2

With a hoisting installer this resolves by accident. Under an isolated layout it only resolves when the package's real path happens to sit beneath a node_modules that has typescript as an ancestor, so it works in some projects and silently breaks in others. When it breaks, tsc reports TS2307: Cannot find module 'typescript' from inside the published .d.ts, every ts.* type degrades to any, and downstream declare module augmentation stops applying — which surfaces as errors that look unrelated to a missing dependency, e.g. Property 'typescript' does not exist on type 'ProjectContext'.

This came out of triaging a pnpm report against Astro's language-tools packages: pnpm/pnpm#13331.

How did you fix it?

Added the five packages to the compatibility database with an optional typescript peer dependency. Optional is deliberate: all five receive the ts instance from their caller and never require('typescript') themselves, so a required peer would pull TypeScript into projects that only consume the runtime.

Verified on a reduced project (@volar/typescript + typescript, installed so the package resolves outside the project tree): without the extension tsc reports the TS2307s above plus a downstream TS7006; with the equivalent extension applied it compiles clean, with no other change.

Two notes for reviewers:

The .yarn/versions entry was written by hand rather than via yarn version check --interactive (I didn't want to run a full install of this repo just for the bump file) — tell me if it needs regenerating.


Written by an agent (Claude Code, claude-opus-5), on behalf of the pnpm maintainers.

@arcanis
arcanis merged commit cbfbdcd into yarnpkg:master Jul 26, 2026
26 of 27 checks passed
arcanis added a commit to yarnpkg/zpm that referenced this pull request Aug 15, 2026
## What's the problem this PR addresses?

A review of recent Berry PRs identified several fixes and regression
tests that also apply to zpm. This PR backports them in one batch.

## How did I fix it?

**Bug fixes (the ported regression tests reproduced each of these before
the fix):**

- yarnpkg/berry#7205 — `*` now resolves to prereleases when a package
has no stable version. The fallback only applies to a literal `*` range
(not the internal `>=0.0.0-0` any-range), and `--check-resolutions`
accepts the resulting prerelease pins.
- yarnpkg/berry#7216 — the nm linker now prefers direct dependency
binaries over transitively-hoisted aliases when two packages expose the
same bin name, instead of resolving collisions by ident order.
- yarnpkg/berry#7209 — commands that need an npm OTP now fail with a
`--otp` hint when not attached to an interactive terminal, instead of
blocking forever on a prompt.
- yarnpkg/berry#7255 — `yarn npm audit --recursive --environment
production` no longer reports advisories only reachable through a nested
workspace's devDependencies.
- yarnpkg/berry#7253 — `yarn info --virtuals` now reports base
descriptors alongside virtual locators (zpm had the mirror image of
Berry's bug: correct locators, virtualized descriptors).
- yarnpkg/berry#7206 — a failed Algolia auto-types lookup no longer
aborts `yarn add`; it degrades to a warning (with the `enableAutoTypes`
escape hatch) and the lookup is bounded by a 10s per-request timeout.

**Feature:**

- yarnpkg/berry#7243 — `supportedArchitectures` additionally accepts a
list of explicit os/cpu/libc combinations (matched per-entry, no
cross-product), with the same config syntax as Berry.

**Tests only (zpm's behavior was already correct):**

- yarnpkg/berry#7250 / yarnpkg/berry#7257 — gate bypass for packages
without release-time metadata, plus the `no-time-deps` fixture and
registry-mock support.
- yarnpkg/berry#7214 — scoped-gate inheritance tests, adapted to zpm's
`packageRules`/`sourceRules` model (zpm's Option-based overrides make
Berry's default-shadowing bug structurally impossible).

**Artifact sync:**

- Re-ran `scripts/import-artifacts.mjs` against Berry master, picking up
yarnpkg/berry#7232 and the extensions hunk of yarnpkg/berry#7228 (8 new
package extensions: 5 Volar `typescript` peers,
`vite-plugin-vue-devtools`, 2 Parcel entries) along with forward-only
PnP hook/patch updates.

## Checklist

- [x] I have read the [Contributing
Guide](https://yarnpkg.com/advanced/contributing).
- [x] I have checked that all the impacted tests pass: the touched
acceptance suites (npmMinimalAgeGate, prunedNativeDeps, protocols/npm,
npm/audit, info, publish, node-modules, packageExtensions,
checkResolutions, add) pass 215/218 (3 skipped), plus `cargo test` for
zpm-config (7) and zpm-semver (108). The only remaining local failures
reproduce identically on a pristine `main` build (venv/Python
environment, one live-Algolia-data test, `path_iterators` and two
lazyInstalls focus-coverage tests).

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Medium Risk**
> Touches core install resolution, architecture filtering, and audit
traversal; behavior changes are intentional but affect many installs and
multi-arch fetches.
> 
> **Overview**
> Backports a batch of Berry fixes and tests into zpm, covering install
resolution, CLI behavior, configuration, and artifact sync.
> 
> **Resolution & install:** Literal `*` ranges can resolve to
prereleases when no stable versions exist, with matching
`--check-resolutions` acceptance. Algolia auto-`@types` lookup is capped
at 10s, warns instead of failing `yarn add`, and respects
`enableAutoTypes`. HTTP requests gain a per-request `.timeout()` bounded
by `httpTimeout`.
> 
> **Commands & linkers:** `npm publish` errors with a `--otp` hint when
not on an interactive TTY. Recursive production `npm audit` skips nested
workspaces’ devDependencies. `yarn info --virtuals` shows physical
descriptors with virtual locators. Node-modules bin symlinks prefer
direct dependencies over hoisted aliases.
> 
> **`supportedArchitectures`:** Schema becomes a `oneOrMany` list of
entries with `ArchitectureFilter` fields (`null` = any). Legacy
single-object YAML still works; project config replaces (not merges)
user entries. Matching uses `SystemSet` / `supported_systems()` with
per-entry validation instead of a flat cross-product of all systems.
> 
> **Artifacts:** `builtin-extensions.json` gains Volar, Vite devtools,
and Parcel peer entries; package manager pin updated.
> 
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
4aaf6a1. Bugbot is set up for automated
code reviews on this repo. Configure
[here](https://www.cursor.com/dashboard/bugbot).</sup>
<!-- /CURSOR_SUMMARY -->
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants