build(shared): drop redundant tsc declarations build

[jacekradko]

shared builds its declarations with tsdown (dts: true) and every exports entry resolves to dist/runtime/dist/types. Release only runs turbo build, so the separate tsc -p tsconfig.declarations.json step was emitting unreferenced top-level dist/*.d.ts that never shipped. Removing it (plus its tsconfig.declarations.json and shared's slot in the root build:declarations filter) leaves the published tarball byte-identical, hence the empty changeset.

The part worth a look is break-check coverage. It snapshots shared's tsdown dist/runtime, and @clerk/shared#build still runs as a dependency of the other filtered packages, so the now-absent build:declarations task just no-ops (turbo marks it <NONEXISTENT>, not an error). attw (node16) and publint stay green on a tsdown-only build; the api-changes run on this PR is the real confirmation.

Independent follow-up to #8717.

[changeset-bot]

🦋 Changeset detected

Latest commit: 103ea6e

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Jun 1, 2026 10:47pm

[pkg-pr-new]

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@8719

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@8719

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@8719

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@8719

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@8719

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@8719

@clerk/express

npm i https://pkg.pr.new/@clerk/express@8719

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@8719

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@8719

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@8719

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@8719

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@8719

@clerk/react

npm i https://pkg.pr.new/@clerk/react@8719

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@8719

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@8719

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@8719

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@8719

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@8719

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@8719

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@8719

commit: 103ea6e

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro

Run ID: 7be601d4-7c16-4746-9aca-1e844c0596de

📥 Commits

Reviewing files that changed from the base of the PR and between da93ece and 103ea6e.

📒 Files selected for processing (4)

• .changeset/shared-drop-redundant-tsc-declarations.md
• package.json
• packages/shared/package.json
• packages/shared/tsconfig.declarations.json

💤 Files with no reviewable changes (2)

• packages/shared/package.json
• packages/shared/tsconfig.declarations.json

---

📝 Walkthrough

Walkthrough

This PR removes TypeScript declaration build configuration from the @clerk/shared package. The root build:declarations npm script was updated to remove the --filter=@clerk/shared`` argument from the turbo build:declarations command. The `build:declarations` script entry was removed from `packages/shared/package.json`, and the `packages/shared/tsconfig.declarations.json` file was deleted. A changeset file documents this cleanup.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• clerk/javascript#8623: Inverse operation that adds packages/shared/tsconfig.declarations.json and wires the declarations tsconfig into the build pipeline.
• clerk/javascript#8627: Complements this cleanup by adding tsc-based build:declarations task and tsconfig.declarations.json for @clerk/ui.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately summarizes the main change: removing a redundant TypeScript declaration build step from the shared package.
Description check	✅ Passed	The description is directly related to the changeset, providing detailed context about why the redundant tsc declarations build is being removed and its 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.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

API Changes Report

Generated by Break Check on 2026-06-01T22:51:46.134Z

Summary

Metric	Count
Packages analyzed	19
Packages with changes	1
🔴 Breaking changes	0
🟡 Non-breaking changes	1
🟢 Additions	0

🤖 This report was reviewed by claude-sonnet-4-6.

Note
Break Check could not snapshot 3 subpaths; the diff below excludes them.

• @clerk/astro ./env: Internal Error: Unable to determine module for: /home/runner/_work/javascript/javascript/packages/astro/env.d.ts You have encountered a software defect. Please consider reporting the issue to the maintainers of this application.
• @clerk/shared ./cookie: Internal Error: Unable to follow symbol for "Cookies" You have encountered a software defect. Please consider reporting the issue to the maintainers of this application.
• @clerk/testing ./cypress: Symbol not found for identifier: Cypress

---

@clerk/shared

Current version: 4.14.0
Recommended bump: MINOR → 4.15.0

Subpath ./apiUrlFromPublishableKey

🟡 Non-breaking Changes (1)

Modified: apiUrlFromPublishableKey

- apiUrlFromPublishableKey: (publishableKey: string) => "https://api.clerk.com" | "https://api.lclclerk.com" | "https://api.clerkstage.dev"+ apiUrlFromPublishableKey: (publishableKey: string) => "https://api.lclclerk.com" | "https://api.clerkstage.dev" | "https://api.clerk.com"

Static analyzer: Breaking change in function apiUrlFromPublishableKey: Return type changed: "https://api.clerk.com"|"https://api.lclclerk.com"|"https://api.clerkstage.dev" → "https://api.lclclerk.com"|"https://api.clerkstage.dev"|"https://api.clerk.com"

🤖 AI review (reclassified as non-breaking) (99%): The return type is a union of the exact same three string literal values — only their order in the union has changed. TypeScript union types are order-independent structurally, so any well-typed consumer code that accepted or narrowed on the original union will continue to compile and behave identically with the reordered union.

---

Report generated by Break Check