Skip to content

feat!: raise the VS Code floor to 1.136 - #62

Merged
kkdev92 merged 1 commit into
mainfrom
feat/vscode-1.136-floor
Sep 7, 2026
Merged

feat!: raise the VS Code floor to 1.136#62
kkdev92 merged 1 commit into
mainfrom
feat/vscode-1.136-floor

Conversation

@kkdev92

@kkdev92 kkdev92 commented Sep 7, 2026

Copy link
Copy Markdown
Owner

Releases 5.0.0. engines.vscode moves from ^1.134.0 to ^1.136.0; nothing
else about the package changes.

Why

@types/vscode published 1.136.0. This package's floor tracks it, because the
types decide the newest API the source may name, and vsce refuses to package
an extension whose @types/vscode outruns its engines.vscode. Raising only
the types would let code compile against an API the declared floor does not
have, so the two move together.

Extensions built on this package inherit the floor and must declare at least
^1.136.0 themselves. That inheritance is what makes this a major rather than a
minor.

The API did not change

dist/, src/ and bin/ are byte-for-byte what 4.1.1 shipped. This was
measured rather than asserted: the published 4.1.1 tarball was downloaded and
unpacked, a fresh npm pack was taken of this tree, and the two were compared
directory by directory. Only package.json, README.md and CHANGELOG.md
differ.

One sentence reworded rather than renumbered

The requirements section said the floor was 1.134.0 "because that is the newest
@types/vscode there is". That was true when written and false the day 1.136.0
shipped, and nothing failed in between. Renumbering it would buy until the next
types release. It now states the rule the floor follows, so there is no fact
about the registry left to go stale.

Verification

  • npm run quality — format, five typecheck projects, lint, 1087 tests with
    coverage, knip, TypeDoc
  • npm run verify:package — every subpath imports, require() is refused, the
    README samples typecheck against the packed types, the CLI runs from the
    installed package
  • Both real-host contract lanes at the new floor. The Extension Host and web
    fixtures each report VS Code 1.136.1, so the floor was exercised against a
    host that actually has it rather than only against fakes

🤖 Generated with Claude Code

`@types/vscode` published 1.136.0, and this package's floor tracks it: the types
decide the newest API the source may name, and `vsce` refuses to package an
extension whose `@types/vscode` outruns its `engines.vscode`. Raising only the
types would let code compile against an API the declared floor does not have, so
`engines.vscode` moves with them, from `^1.134.0` to `^1.136.0`.

That is the whole of the breaking change. Every extension built on this package
inherits the floor and must declare at least `^1.136.0` itself, which is why this
is a major rather than a minor -- the API is byte-for-byte what 4.1.1 exposed.
Verified by unpacking the published 4.1.1 tarball and diffing it against a fresh
pack of this tree: `dist/`, `src/` and `bin/` are identical, and only
`package.json`, `README.md` and `CHANGELOG.md` differ.

The prose that named the floor is reworded rather than renumbered. It said
1.134.0 "is the newest `@types/vscode` there is" -- true when written, false the
day 1.136.0 shipped, and nothing failed in between. It now states the rule the
floor follows instead of a fact about the registry, so it has nothing left to go
stale.

Verified: `npm run quality` (format, five typecheck projects, lint, 1087 tests
with coverage, knip, TypeDoc), `verify:package`, and both real-host contract
lanes -- the Extension Host and web fixtures each report VS Code 1.136.1, so the
new floor was exercised against a host that actually has it.

BREAKING CHANGE: `engines.vscode` is now `^1.136.0`. An extension on an older
VS Code cannot install this version; it keeps 4.x, which is unaffected.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017Uf34bXf9dd7BURuBCh7Wx
@kkdev92
kkdev92 merged commit aeda34f into main Sep 7, 2026
10 checks passed
@kkdev92
kkdev92 deleted the feat/vscode-1.136-floor branch September 7, 2026 08:08
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.

1 participant