Skip to content

ci(dependabot): ignore typescript major bumps for docs/site - #22763

Closed
bloxster wants to merge 1 commit into
mainfrom
ci/dependabot-ignore-typescript-major
Closed

bloxster wants to merge 1 commit into
mainfrom
ci/dependabot-ignore-typescript-major

Conversation

@bloxster

Copy link
Copy Markdown
Contributor

Why

PR #22395 (typescript 6.0.3 → 7.0.2) was closed because TypeScript 7 removed baseUrl (TS5102), which @docusaurus/tsconfig still sets as of 3.10.2:

docs/site/tsconfig.json: error TS5102: Option 'baseUrl' has been removed.
                                       Please remove it from your configuration.

An inherited compilerOption cannot be unset by the extending config, and docs/site/tsconfig.json's "ignoreDeprecations": "6.0" only silences TS 6's TS5101 deprecation — TS 7 rejects the option itself. Since docs-site-build.yml gates npm run typecheck, a TS 7 bump turns docs CI red.

What

Closing a Dependabot PR suppresses only that exact version, so 7.0.3 and every later 7.x would re-propose it. This encodes the decision instead. Minor and patch TypeScript updates keep flowing.

No behaviour change — Dependabot config only.

If we want TS 7 later

It requires inlining @docusaurus/tsconfig's options minus baseUrl. Note that deleting our local baseUrl: "." alone would not work — it would just inherit theirs. That fix is already proven in erigontech/cocoon#36 and erigontech/zilkworm-docs#13.

Aside: our local baseUrl: "." is also why @site/* resolves correctly here. In both sibling repos the option was purely inherited, which made it resolve to node_modules/@docusaurus/tsconfig and silently broke the alias.

🤖 Generated with Claude Code

PR #22395 (typescript 6.0.3 -> 7.0.2) was closed because TypeScript 7 removed
`baseUrl` (TS5102), which @docusaurus/tsconfig still sets as of 3.10.2. An
inherited compilerOption cannot be unset by the extending config, and
docs/site/tsconfig.json's `ignoreDeprecations: "6.0"` only silences TS 6's
TS5101 deprecation — TS 7 rejects the option itself. Since docs-site-build.yml
gates `npm run typecheck`, a TS 7 bump turns docs CI red.

Closing a Dependabot PR only suppresses that exact version, so 7.0.3 and every
later 7.x would re-propose it. Encode the decision instead. Minor and patch
TypeScript updates keep flowing.

Taking TS 7 later means inlining @docusaurus/tsconfig's options minus baseUrl
(deleting our local baseUrl alone would just inherit theirs). That fix is
already proven in erigontech/cocoon#36 and erigontech/zilkworm-docs#13 if we
want it here.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@bloxster

Copy link
Copy Markdown
Contributor Author

Superseded by #22764, which removes the need for this deferral: it drops baseUrl from docs/site/tsconfig.json so TypeScript 7 passes npm run typecheck instead of being held back from it. Closing in favour of taking the upgrade.

If we ever want to pin back to TypeScript 6, this rule is the way to do it — the rationale is preserved in the commit on ci/dependabot-ignore-typescript-major.

@bloxster bloxster closed this Jul 27, 2026
@bloxster
bloxster deleted the ci/dependabot-ignore-typescript-major branch July 27, 2026 11:38
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