fix(release): build packages before publish so dist is included in tarballs (#844)

* fix(release): build packages in CI before publish so dist is included

The release job runs Checkout -> Setup -> changesets with no build, so
dist/ is absent when changeset publish packs tarballs. files: ["dist"]
silently includes nothing when dist/ is missing, so releases 0.33.0-0.36.0
shipped src-only and resolved every export to a missing file.

Add a fresh, cache-bypassing build step to the release job before
changesets (a cached build can report success without materializing dist/),
and add a changeset republishing every package with compiled output
(ai -> 0.37.0).

* fix(docs): skip generated reference/ links in verify-links

docs/reference/** is TypeDoc-generated at build and not committed, so the
link checker resolved ../reference/classes/StreamProcessor to a missing
file and failed. The check normally passed only via Nx cache; a cache-miss
re-run surfaced the latent failure. Treat reference/ targets as valid
routes and skip them.

Author: AlemTuzlak

.changeset/republish-dist-artifacts.md

@@ -0,0 +1,49 @@
+---
+'@tanstack/ai': minor
+'@tanstack/ai-angular': patch
+'@tanstack/ai-anthropic': patch
+'@tanstack/ai-client': patch
+'@tanstack/ai-code-mode': patch
+'@tanstack/ai-code-mode-skills': patch
+'@tanstack/ai-devtools-core': patch
+'@tanstack/ai-elevenlabs': patch
+'@tanstack/ai-event-client': patch
+'@tanstack/ai-fal': patch
+'@tanstack/ai-gemini': patch
+'@tanstack/ai-grok': patch
+'@tanstack/ai-groq': patch
+'@tanstack/ai-isolate-cloudflare': patch
+'@tanstack/ai-isolate-node': patch
+'@tanstack/ai-isolate-quickjs': patch
+'@tanstack/ai-mcp': patch
+'@tanstack/ai-ollama': patch
+'@tanstack/ai-openai': patch
+'@tanstack/ai-openrouter': patch
+'@tanstack/ai-preact': patch
+'@tanstack/ai-react': patch
+'@tanstack/ai-react-ui': patch
+'@tanstack/ai-solid': patch
+'@tanstack/ai-solid-ui': patch
+'@tanstack/ai-svelte': patch
+'@tanstack/ai-utils': patch
+'@tanstack/ai-vue': patch
+'@tanstack/ai-vue-ui': patch
+'@tanstack/openai-base': patch
+'@tanstack/preact-ai-devtools': patch
+'@tanstack/react-ai-devtools': patch
+'@tanstack/solid-ai-devtools': patch
+---
+
+Republish all packages with their compiled `dist/` output.
+
+Releases `0.33.0`–`0.36.0` were published without a `dist/` directory: the
+release workflow relied on an Nx-cached `build` whose outputs were not
+materialized to disk before `changeset publish` packed the tarballs, and
+`files: ["dist"]` silently includes nothing when `dist/` is absent. The
+published packages therefore contained only `src/`, so every export
+(`./dist/esm/*.js`) resolved to a missing file and the packages were
+uninstallable.
+
+The publish step now runs a fresh, cache-bypassing build of all packages
+immediately before publishing, guaranteeing compiled artifacts are present in
+every tarball.

.github/workflows/release.yml

@@ -47,6 +47,11 @@ jobs:
           persist-credentials: true
       - name: Setup Tools
         uses: TanStack/config/.github/setup@190f659075ff0845850e330883eb26d7ffd0671f # main
+      - name: Build packages
+        # Fresh, cache-bypassing build so dist/ is on disk when changeset
+        # publish packs tarballs. A cached build can report success without
+        # materializing dist/, shipping src-only packages (see 0.33.0-0.36.0).
+        run: pnpm exec nx run-many --targets=build --exclude=examples/**,testing/** --skip-nx-cache
       - name: Run Changesets (version or publish)
         id: changesets
         uses: changesets/action@6a0a831ff30acef54f2c6aa1cbbc1096b066edaf # v1.7.0

scripts/verify-links.ts

@@ -53,6 +53,13 @@ function relativeLinkExists(link: string, file: string): boolean {
     return false
   }
 
+  // The API reference (docs/reference/**) is TypeDoc-generated at build time
+  // and not committed, so its targets can't be resolved here. These are valid
+  // routes on the built site; skip them rather than flagging false positives.
+  if (absPath.startsWith(resolve(docsRoot, 'reference'))) {
+    return true
+  }
+
   // Check if this is an example path
   const isExample = absPath.includes('/examples/')