fix: run TypeDoc 0.28.20 against the TS6 shim

[AlemTuzlak]

Changes

pnpm generate-docs crashed on TypeScript 7:

TypeError: Cannot read properties of undefined (reading ''PropertyDeclaration'')

TypeDoc reads ts.SyntaxKind when the module loads. TypeScript 7 dropped that API.

This PR:

• Bumps @tanstack/typedoc-config from 0.3.1 to 0.3.4 (TypeDoc 0.28.20).
• Gives TypeDoc the same @typescript/typescript6 shim that knip, svelte-check, and vue-tsc already use.

Latest TypeDoc still supports TypeScript 5–6 only (TypeStrong/typedoc#3098). A TypeDoc-only bump is not enough. A pnpm override is not used.

This is the leftover fix from #1097. That PR merged before this commit was pushed.

Checklist

• I have followed the steps in the Contributing guide.
• I have tested this code locally with pnpm generate-docs (the failing command).

Release Impact

• This change affects published code, and I have generated a changeset.
• This change is docs/CI/dev-only (no release).

Summary by CodeRabbit

• Documentation

  • Updated TypeScript tooling guidance, including compatibility notes for TypeScript 6 and TypeScript 7.

• Chores

  • Updated the TypeDoc configuration package.
  • Improved workspace compatibility for TypeDoc tooling with TypeScript 6.

[coderabbitai]

📝 Walkthrough

Walkthrough

The PR updates Typedoc tooling to use the TypeScript 6.0.2 shim, updates @tanstack/typedoc-config, and revises compatibility guidance for Angular and kiira.

Changes

TypeScript tooling compatibility

Layer / File(s)	Summary
Tooling dependency and compatibility updates pnpm-workspace.yaml, package.json, CLAUDE.md	Typedoc packages receive the TypeScript 6.0.2 shim. @tanstack/typedoc-config updates to 0.3.4. The guidance documents Angular on TypeScript 5.9.3 and kiira on TypeScript 7.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Suggested reviewers: tombeckenham, jherr, sheraff

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly describes the main change: running TypeDoc 0.28.20 against the TypeScript 6 shim.
Description check	✅ Passed	The description explains the crash, implementation, testing, checklist, and development-only release impact.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/typedoc-ts6-shim

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

ESLint install failed. For unrecoverable errors, disable the tool in CodeRabbit configuration.

---

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.}

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	npm/​@​tanstack/​typedoc-config@​0.3.4

View full report

[nx-cloud]

🤖 Nx Cloud AI Fix Eligible

An automatically generated fix could have helped fix failing tasks for this run, but Self-healing CI is disabled for this workspace. Visit workspace settings to enable it and get automatic fixes in future runs.

_{To disable these notifications, a workspace admin can disable them in workspace settings.}

---

View your CI Pipeline Execution ↗ for commit 1538ffb

Command	Status	Duration	Result
nx run-many --targets=build --exclude=examples/...	❌ Failed	1m 39s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-08-12 16:51:50 UTC

[nx-cloud]

🤖 Nx Cloud AI Fix Eligible

An automatically generated fix could have helped fix failing tasks for this run, but Self-healing CI is disabled for this workspace. Visit workspace settings to enable it and get automatic fixes in future runs.

_{To disable these notifications, a workspace admin can disable them in workspace settings.}

---

View your CI Pipeline Execution ↗ for commit 1538ffb

Command	Status	Duration	Result
nx run-many --targets=build --exclude=examples/...	❌ Failed	1m 39s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-08-12 16:51:51 UTC

[coderabbitai]

🧹 Nitpick comments (1)

CLAUDE.md (1)

15-18: 📐 Maintainability & Code Quality | 🔵 Trivial

Run the documentation link check before pushing.

Run pnpm test:docs in addition to pnpm generate-docs before pushing this documentation-tooling change.

Based on learnings: “Run pnpm test:docs (link verification) before pushing changes to documentation.”

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@CLAUDE.md` around lines 15 - 18, Update the documentation-tooling guidance in
CLAUDE.md to instruct contributors to run pnpm test:docs alongside pnpm
generate-docs before pushing. Keep the existing TypeScript shim and package
compatibility details unchanged.

Source: Learnings

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@CLAUDE.md`:
- Around line 15-18: Update the documentation-tooling guidance in CLAUDE.md to
instruct contributors to run pnpm test:docs alongside pnpm generate-docs before
pushing. Keep the existing TypeScript shim and package compatibility details
unchanged.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 616a1475-d922-4bdb-8e31-a993c8d7e2b3

📥 Commits

Reviewing files that changed from the base of the PR and between 053333d and 1538ffb.

⛔ Files ignored due to path filters (1)

• pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml

📒 Files selected for processing (3)

• CLAUDE.md
• package.json
• pnpm-workspace.yaml