docs: fix grok video snippets failing kiira; publish @tanstack/ai-angular

[AlemTuzlak]

Why

The test:kiira gate (doc code-sample type-checker, added in #805) has been red on main since the grok video-generation adapter docs landed (#742). The Release workflow runs pnpm run test:ci (which includes test:kiira) before changeset publish, so a red gate aborts the job before anything publishes — which is why no package has been published since 2026-06-23 and why @tanstack/ai-angular is stuck (see #811).

The kiira failure

Two grok video snippets used generateVideo / grokVideo in standalone code fences without importing them:

• docs/adapters/grok.md — image-to-video example
• docs/media/video-generation.md — image-to-video + duration-inspection examples

✖ Kiira found 5 errors  (TS2304 Cannot find name 'generateVideo' / 'grokVideo')

Each fence is now self-contained with its own imports (no group=/rename hacks). Local run:

✓ Kiira found no errors in 83 files.
Checked 665 snippets. Passed 665. Failed 0.

Publishing ai-angular

Adds a patch changeset for @tanstack/ai-angular. The only version on npm (0.0.1) was seeded by a manual npm publish and shipped unresolved workspace: specifiers (EUNSUPPORTEDPROTOCOL, #811). Now that trusted publishing is configured for the package and the kiira gate is green again, releasing through the changesets pipeline rewrites those specifiers to concrete versions and ships a clean build.

Closes #811.

Summary by CodeRabbit

• Bug Fixes

  • Published a patch update to ensure the Angular package installs correctly from npm without broken dependency references.

• Documentation

  • Updated video-generation examples to include the required imports in code snippets.
  • Fixed the Grok adapter documentation so the TypeScript examples are ready to copy and run.

[github-actions]

🚀 Changeset Version Preview

2 package(s) bumped directly, 0 bumped as dependents.

🟨 Minor bumps

Package	Version	Reason
@tanstack/ai-grok	0.13.0 → 0.14.0	Changeset

🟩 Patch bumps

Package	Version	Reason
@tanstack/ai-angular	0.1.7 → 0.1.8	Changeset

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 1493991

Command	Status	Duration	Result
nx affected --targets=test:sherif,test:knip,tes...	✅ Succeeded	1m 22s	View ↗
nx run-many --targets=build --exclude=examples/...	✅ Succeeded	2s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-06-24 11:56:50 UTC

[pkg-pr-new]

Open in StackBlitz

@tanstack/ai

npm i https://pkg.pr.new/@tanstack/ai@826

@tanstack/ai-angular

npm i https://pkg.pr.new/@tanstack/ai-angular@826

@tanstack/ai-anthropic

npm i https://pkg.pr.new/@tanstack/ai-anthropic@826

@tanstack/ai-client

npm i https://pkg.pr.new/@tanstack/ai-client@826

@tanstack/ai-code-mode

npm i https://pkg.pr.new/@tanstack/ai-code-mode@826

@tanstack/ai-code-mode-skills

npm i https://pkg.pr.new/@tanstack/ai-code-mode-skills@826

@tanstack/ai-devtools-core

npm i https://pkg.pr.new/@tanstack/ai-devtools-core@826

@tanstack/ai-elevenlabs

npm i https://pkg.pr.new/@tanstack/ai-elevenlabs@826

@tanstack/ai-event-client

npm i https://pkg.pr.new/@tanstack/ai-event-client@826

@tanstack/ai-fal

npm i https://pkg.pr.new/@tanstack/ai-fal@826

@tanstack/ai-gemini

npm i https://pkg.pr.new/@tanstack/ai-gemini@826

@tanstack/ai-grok

npm i https://pkg.pr.new/@tanstack/ai-grok@826

@tanstack/ai-groq

npm i https://pkg.pr.new/@tanstack/ai-groq@826

@tanstack/ai-isolate-cloudflare

npm i https://pkg.pr.new/@tanstack/ai-isolate-cloudflare@826

@tanstack/ai-isolate-node

npm i https://pkg.pr.new/@tanstack/ai-isolate-node@826

@tanstack/ai-isolate-quickjs

npm i https://pkg.pr.new/@tanstack/ai-isolate-quickjs@826

@tanstack/ai-mcp

npm i https://pkg.pr.new/@tanstack/ai-mcp@826

@tanstack/ai-ollama

npm i https://pkg.pr.new/@tanstack/ai-ollama@826

@tanstack/ai-openai

npm i https://pkg.pr.new/@tanstack/ai-openai@826

@tanstack/ai-openrouter

npm i https://pkg.pr.new/@tanstack/ai-openrouter@826

@tanstack/ai-preact

npm i https://pkg.pr.new/@tanstack/ai-preact@826

@tanstack/ai-react

npm i https://pkg.pr.new/@tanstack/ai-react@826

@tanstack/ai-react-ui

npm i https://pkg.pr.new/@tanstack/ai-react-ui@826

@tanstack/ai-solid

npm i https://pkg.pr.new/@tanstack/ai-solid@826

@tanstack/ai-solid-ui

npm i https://pkg.pr.new/@tanstack/ai-solid-ui@826

@tanstack/ai-svelte

npm i https://pkg.pr.new/@tanstack/ai-svelte@826

@tanstack/ai-utils

npm i https://pkg.pr.new/@tanstack/ai-utils@826

@tanstack/ai-vue

npm i https://pkg.pr.new/@tanstack/ai-vue@826

@tanstack/ai-vue-ui

npm i https://pkg.pr.new/@tanstack/ai-vue-ui@826

@tanstack/openai-base

npm i https://pkg.pr.new/@tanstack/openai-base@826

@tanstack/preact-ai-devtools

npm i https://pkg.pr.new/@tanstack/preact-ai-devtools@826

@tanstack/react-ai-devtools

npm i https://pkg.pr.new/@tanstack/react-ai-devtools@826

@tanstack/solid-ai-devtools

npm i https://pkg.pr.new/@tanstack/solid-ai-devtools@826

commit: 1493991

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: df7d1c8e-27c5-46dc-9f91-cf85fc5ff846

📥 Commits

Reviewing files that changed from the base of the PR and between 83d8097 and 1493991.

📒 Files selected for processing (3)

• .changeset/publish-ai-angular.md
• docs/adapters/grok.md
• docs/media/video-generation.md

---

📝 Walkthrough

Walkthrough

Adds a Changesets patch entry to trigger a new @tanstack/ai-angular npm publish so that workspace: dependency specifiers are rewritten to concrete versions. Also adds missing generateVideo and grokVideo import lines to Grok video generation code examples in two documentation files.

Changes

ai-angular patch release and doc import fixes

Layer / File(s)	Summary
@tanstack/ai-angular patch changeset .changeset/publish-ai-angular.md	Declares a patch release for @tanstack/ai-angular so the Changesets pipeline rewrites workspace: specifiers in dependencies and peerDependencies to concrete versions before publishing to npm.
Grok video generation import fixes docs/adapters/grok.md, docs/media/video-generation.md	Adds missing generateVideo (from @tanstack/ai) and grokVideo (from @tanstack/ai-grok) import statements to the grok-imagine-video-1.5 image-to-video example and the availableDurations()/snapDuration() example.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐇 A workspace colon slipped through the gate,
npm cried out — the package won't install, it's too late!
A changeset patch hops in to save the day,
rewriting workspace:* from the tarball away.
Missing imports in the docs? Fixed with a flick!
The bunny ships clean code — hop hop, double quick! 🌟

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Out of Scope Changes check	⚠️ Warning	The Grok documentation snippet fixes are unrelated to linked issue #811, which only asks for the ai-angular publish remediation.	Split the Grok documentation fixes into a separate PR, or add the relevant issue if those docs changes are intentionally in scope.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly names both the Grok doc fix and the ai-angular publish fix, which are the PR's two main changes.
Description check	✅ Passed	The description covers the change, testing context, and release impact, though it doesn't follow the template headings exactly.
Linked Issues check	✅ Passed	The changeset addresses #811 by republishing @tanstack/ai-angular through Changesets so workspace deps rewrite to publishable versions.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/kiira-grok-video-docs

---

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