docs: fix grok video snippets failing kiira; publish @tanstack/ai-angular by AlemTuzlak · Pull Request #826 · TanStack/ai

AlemTuzlak · 2026-06-24T11:53:57Z

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.

The grok video-generation snippets in docs/adapters/grok.md and docs/media/video-generation.md referenced generateVideo/grokVideo without importing them, failing the test:kiira gate on main and aborting every release run before changeset publish. Make each standalone fence self-contained with its own imports, and add a changeset to cut a clean @tanstack/ai-angular release (npm 0.0.1 shipped unresolved workspace: specifiers from a manual publish).

github-actions · 2026-06-24T11:55:00Z

🚀 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 · 2026-06-24T11:55:08Z

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 · 2026-06-24T11:55:46Z

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 · 2026-06-24T11:55:53Z

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

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

AlemTuzlak merged commit da0feb1 into main Jun 24, 2026
10 checks passed

AlemTuzlak deleted the fix/kiira-grok-video-docs branch June 24, 2026 12:07

github-actions Bot mentioned this pull request Jun 24, 2026

ci: Version Packages #827

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

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

docs: fix grok video snippets failing kiira; publish @tanstack/ai-angular#826
AlemTuzlak merged 1 commit into
mainfrom
fix/kiira-grok-video-docs

AlemTuzlak commented Jun 24, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

github-actions Bot commented Jun 24, 2026

Uh oh!

nx-cloud Bot commented Jun 24, 2026 •

edited

Loading

Uh oh!

pkg-pr-new Bot commented Jun 24, 2026

Uh oh!

coderabbitai Bot commented Jun 24, 2026 •

edited

Loading

Walkthrough

Changes

Estimated code review effort

Poem

❌ Failed checks (1 warning)

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Uh oh!

Conversation

AlemTuzlak commented Jun 24, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Why

The kiira failure

Publishing ai-angular

Summary by CodeRabbit

Uh oh!

github-actions Bot commented Jun 24, 2026

🚀 Changeset Version Preview

🟨 Minor bumps

🟩 Patch bumps

Uh oh!

nx-cloud Bot commented Jun 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pkg-pr-new Bot commented Jun 24, 2026

Uh oh!

coderabbitai Bot commented Jun 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Estimated code review effort

Poem

❌ Failed checks (1 warning)

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

AlemTuzlak commented Jun 24, 2026 •

edited by coderabbitai Bot

Loading

nx-cloud Bot commented Jun 24, 2026 •

edited

Loading

coderabbitai Bot commented Jun 24, 2026 •

edited

Loading