npm - @assistant-ui/mcp-docs-server - Versions diffs - 0.2.3 → 0.3.1 - Mend

@assistant-ui/mcp-docs-server 0.2.3 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (452) hide show

package/README.md +16 -43
package/dist/index.d.ts +2 -3
package/dist/index.d.ts.map +1 -1
package/dist/index.js +3 -91
package/dist/index.js.map +1 -1
package/dist/proxy.d.ts +9 -0
package/dist/proxy.d.ts.map +1 -0
package/dist/proxy.js +91 -0
package/dist/proxy.js.map +1 -0
package/package.json +8 -12
package/src/index.ts +3 -115
package/src/proxy.test.ts +385 -0
package/src/proxy.ts +126 -0
package/.docs/organized/code-examples/waterfall.md +0 -807
package/.docs/organized/code-examples/with-a2a.md +0 -675
package/.docs/organized/code-examples/with-ag-ui.md +0 -553
package/.docs/organized/code-examples/with-ai-sdk-v7.md +0 -466
package/.docs/organized/code-examples/with-artifacts.md +0 -815
package/.docs/organized/code-examples/with-assistant-transport.md +0 -576
package/.docs/organized/code-examples/with-browser-extension.md +0 -371
package/.docs/organized/code-examples/with-chain-of-thought.md +0 -962
package/.docs/organized/code-examples/with-cloud-standalone.md +0 -681
package/.docs/organized/code-examples/with-cloud.md +0 -439
package/.docs/organized/code-examples/with-custom-thread-list.md +0 -569
package/.docs/organized/code-examples/with-elevenlabs-conversational.md +0 -527
package/.docs/organized/code-examples/with-elevenlabs-scribe.md +0 -697
package/.docs/organized/code-examples/with-eve.md +0 -405
package/.docs/organized/code-examples/with-expo.md +0 -2246
package/.docs/organized/code-examples/with-external-store.md +0 -421
package/.docs/organized/code-examples/with-ffmpeg.md +0 -829
package/.docs/organized/code-examples/with-generative-ui.md +0 -1810
package/.docs/organized/code-examples/with-google-adk.md +0 -368
package/.docs/organized/code-examples/with-heat-graph.md +0 -304
package/.docs/organized/code-examples/with-image-generation.md +0 -463
package/.docs/organized/code-examples/with-interactables.md +0 -733
package/.docs/organized/code-examples/with-langchain.md +0 -446
package/.docs/organized/code-examples/with-langgraph.md +0 -855
package/.docs/organized/code-examples/with-livekit.md +0 -643
package/.docs/organized/code-examples/with-mcp.md +0 -782
package/.docs/organized/code-examples/with-nuxt.md +0 -2428
package/.docs/organized/code-examples/with-opencode.md +0 -1974
package/.docs/organized/code-examples/with-openui.md +0 -450
package/.docs/organized/code-examples/with-pi.md +0 -2084
package/.docs/organized/code-examples/with-react-hook-form.md +0 -727
package/.docs/organized/code-examples/with-react-ink-web.md +0 -740
package/.docs/organized/code-examples/with-react-ink.md +0 -473
package/.docs/organized/code-examples/with-react-router.md +0 -936
package/.docs/organized/code-examples/with-resumable-stream.md +0 -668
package/.docs/organized/code-examples/with-store.md +0 -679
package/.docs/organized/code-examples/with-svelte.md +0 -415
package/.docs/organized/code-examples/with-sveltekit.md +0 -1061
package/.docs/organized/code-examples/with-tanstack.md +0 -812
package/.docs/organized/code-examples/with-tap-runtime.md +0 -813
package/.docs/organized/code-examples/with-virtualized-thread.md +0 -681
package/.docs/organized/code-examples/with-vue.md +0 -408
package/.docs/raw/docs/(getting-started)/architecture.mdx +0 -146
package/.docs/raw/docs/(getting-started)/base-ui.mdx +0 -39
package/.docs/raw/docs/(getting-started)/cli.mdx +0 -542
package/.docs/raw/docs/(getting-started)/devtools.mdx +0 -79
package/.docs/raw/docs/(getting-started)/index.mdx +0 -23
package/.docs/raw/docs/(getting-started)/installation.mdx +0 -483
package/.docs/raw/docs/(getting-started)/llm.mdx +0 -211
package/.docs/raw/docs/(getting-started)/rtl.mdx +0 -78
package/.docs/raw/docs/(reference)/api-reference/adapters/attachments.mdx +0 -36
package/.docs/raw/docs/(reference)/api-reference/adapters/feedback.mdx +0 -20
package/.docs/raw/docs/(reference)/api-reference/adapters/index.mdx +0 -34
package/.docs/raw/docs/(reference)/api-reference/adapters/model.mdx +0 -44
package/.docs/raw/docs/(reference)/api-reference/adapters/persistence.mdx +0 -59
package/.docs/raw/docs/(reference)/api-reference/adapters/runtime.mdx +0 -20
package/.docs/raw/docs/(reference)/api-reference/adapters/suggestions.mdx +0 -26
package/.docs/raw/docs/(reference)/api-reference/context-providers/assistant-runtime-provider.mdx +0 -84
package/.docs/raw/docs/(reference)/api-reference/context-providers/index.mdx +0 -22
package/.docs/raw/docs/(reference)/api-reference/context-providers/scoped-providers.mdx +0 -64
package/.docs/raw/docs/(reference)/api-reference/external-store/index.mdx +0 -22
package/.docs/raw/docs/(reference)/api-reference/external-store/message-conversion.mdx +0 -57
package/.docs/raw/docs/(reference)/api-reference/external-store/runtime.mdx +0 -49
package/.docs/raw/docs/(reference)/api-reference/generative-ui/a2ui.mdx +0 -40
package/.docs/raw/docs/(reference)/api-reference/generative-ui/actions.mdx +0 -56
package/.docs/raw/docs/(reference)/api-reference/generative-ui/components.mdx +0 -86
package/.docs/raw/docs/(reference)/api-reference/generative-ui/index.mdx +0 -39
package/.docs/raw/docs/(reference)/api-reference/generative-ui/json-generative-ui.mdx +0 -42
package/.docs/raw/docs/(reference)/api-reference/generative-ui/rendering.mdx +0 -84
package/.docs/raw/docs/(reference)/api-reference/generative-ui/slack.mdx +0 -85
package/.docs/raw/docs/(reference)/api-reference/generative-ui/spec.mdx +0 -45
package/.docs/raw/docs/(reference)/api-reference/generative-ui/teams.mdx +0 -93
package/.docs/raw/docs/(reference)/api-reference/generative-ui/tokens.mdx +0 -62
package/.docs/raw/docs/(reference)/api-reference/hooks/composer-triggers.mdx +0 -129
package/.docs/raw/docs/(reference)/api-reference/hooks/index.mdx +0 -31
package/.docs/raw/docs/(reference)/api-reference/hooks/model-context.mdx +0 -34
package/.docs/raw/docs/(reference)/api-reference/hooks/primitives.mdx +0 -350
package/.docs/raw/docs/(reference)/api-reference/hooks/runtimes.mdx +0 -28
package/.docs/raw/docs/(reference)/api-reference/hooks/state.mdx +0 -97
package/.docs/raw/docs/(reference)/api-reference/integrations/ai-sdk.mdx +0 -200
package/.docs/raw/docs/(reference)/api-reference/integrations/cloud-ai-sdk.mdx +0 -24
package/.docs/raw/docs/(reference)/api-reference/integrations/eve.mdx +0 -118
package/.docs/raw/docs/(reference)/api-reference/integrations/index.mdx +0 -28
package/.docs/raw/docs/(reference)/api-reference/integrations/react-data-stream.mdx +0 -37
package/.docs/raw/docs/(reference)/api-reference/model-context/context.mdx +0 -50
package/.docs/raw/docs/(reference)/api-reference/model-context/index.mdx +0 -22
package/.docs/raw/docs/(reference)/api-reference/model-context/registry.mdx +0 -20
package/.docs/raw/docs/(reference)/api-reference/overview.mdx +0 -566
package/.docs/raw/docs/(reference)/api-reference/primitives/action-bar-more.mdx +0 -152
package/.docs/raw/docs/(reference)/api-reference/primitives/action-bar.mdx +0 -239
package/.docs/raw/docs/(reference)/api-reference/primitives/assistant-if.mdx +0 -208
package/.docs/raw/docs/(reference)/api-reference/primitives/assistant-modal.mdx +0 -108
package/.docs/raw/docs/(reference)/api-reference/primitives/attachment.mdx +0 -99
package/.docs/raw/docs/(reference)/api-reference/primitives/branch-picker.mdx +0 -145
package/.docs/raw/docs/(reference)/api-reference/primitives/chain-of-thought.mdx +0 -82
package/.docs/raw/docs/(reference)/api-reference/primitives/composer.mdx +0 -637
package/.docs/raw/docs/(reference)/api-reference/primitives/composition.mdx +0 -22
package/.docs/raw/docs/(reference)/api-reference/primitives/error.mdx +0 -65
package/.docs/raw/docs/(reference)/api-reference/primitives/index.mdx +0 -73
package/.docs/raw/docs/(reference)/api-reference/primitives/message-part.mdx +0 -117
package/.docs/raw/docs/(reference)/api-reference/primitives/message.mdx +0 -339
package/.docs/raw/docs/(reference)/api-reference/primitives/queue-item.mdx +0 -77
package/.docs/raw/docs/(reference)/api-reference/primitives/selection-toolbar.mdx +0 -88
package/.docs/raw/docs/(reference)/api-reference/primitives/suggestion.mdx +0 -81
package/.docs/raw/docs/(reference)/api-reference/primitives/thread-list-item-more.mdx +0 -129
package/.docs/raw/docs/(reference)/api-reference/primitives/thread-list-item.mdx +0 -138
package/.docs/raw/docs/(reference)/api-reference/primitives/thread-list.mdx +0 -122
package/.docs/raw/docs/(reference)/api-reference/primitives/thread.mdx +0 -289
package/.docs/raw/docs/(reference)/api-reference/runtimes/assistant-runtime.mdx +0 -20
package/.docs/raw/docs/(reference)/api-reference/runtimes/attachment-runtime.mdx +0 -24
package/.docs/raw/docs/(reference)/api-reference/runtimes/composer-runtime.mdx +0 -32
package/.docs/raw/docs/(reference)/api-reference/runtimes/index.mdx +0 -43
package/.docs/raw/docs/(reference)/api-reference/runtimes/message-part-runtime.mdx +0 -43
package/.docs/raw/docs/(reference)/api-reference/runtimes/message-runtime.mdx +0 -24
package/.docs/raw/docs/(reference)/api-reference/runtimes/queue-state.mdx +0 -20
package/.docs/raw/docs/(reference)/api-reference/runtimes/thread-list-item-runtime.mdx +0 -24
package/.docs/raw/docs/(reference)/api-reference/runtimes/thread-list-runtime.mdx +0 -24
package/.docs/raw/docs/(reference)/api-reference/runtimes/thread-runtime.mdx +0 -36
package/.docs/raw/docs/(reference)/api-reference/tools/component-tools.mdx +0 -85
package/.docs/raw/docs/(reference)/api-reference/tools/index.mdx +0 -45
package/.docs/raw/docs/(reference)/api-reference/tools/interactables-legacy.mdx +0 -55
package/.docs/raw/docs/(reference)/api-reference/tools/interactables.mdx +0 -151
package/.docs/raw/docs/(reference)/api-reference/tools/rendering.mdx +0 -106
package/.docs/raw/docs/(reference)/api-reference/tools/status.mdx +0 -62
package/.docs/raw/docs/(reference)/api-reference/tools/toolkits.mdx +0 -178
package/.docs/raw/docs/(reference)/api-reference/transport/assistant-transport.mdx +0 -48
package/.docs/raw/docs/(reference)/api-reference/transport/frame.mdx +0 -62
package/.docs/raw/docs/(reference)/api-reference/transport/index.mdx +0 -22
package/.docs/raw/docs/(reference)/api-reference/utilities/index.mdx +0 -19
package/.docs/raw/docs/(reference)/api-reference/utilities/miscellaneous.mdx +0 -152
package/.docs/raw/docs/(reference)/api-reference/voice/index.mdx +0 -22
package/.docs/raw/docs/(reference)/api-reference/voice/session.mdx +0 -54
package/.docs/raw/docs/(reference)/api-reference/voice/speech-dictation.mdx +0 -36
package/.docs/raw/docs/cloud/ai-sdk-assistant-ui.mdx +0 -527
package/.docs/raw/docs/cloud/ai-sdk.mdx +0 -604
package/.docs/raw/docs/cloud/authorization.mdx +0 -252
package/.docs/raw/docs/cloud/index.mdx +0 -46
package/.docs/raw/docs/cloud/langgraph.mdx +0 -554
package/.docs/raw/docs/copilots/assistant-frame.mdx +0 -411
package/.docs/raw/docs/copilots/make-assistant-visible.mdx +0 -82
package/.docs/raw/docs/copilots/model-context.mdx +0 -156
package/.docs/raw/docs/copilots/motivation.mdx +0 -202
package/.docs/raw/docs/copilots/use-assistant-instructions.mdx +0 -64
package/.docs/raw/docs/guides/attachments.mdx +0 -619
package/.docs/raw/docs/guides/branching.mdx +0 -76
package/.docs/raw/docs/guides/chain-of-thought.mdx +0 -164
package/.docs/raw/docs/guides/chatgpt-subscription.mdx +0 -108
package/.docs/raw/docs/guides/context-api.mdx +0 -619
package/.docs/raw/docs/guides/dictation.mdx +0 -298
package/.docs/raw/docs/guides/editing.mdx +0 -102
package/.docs/raw/docs/guides/electron.mdx +0 -369
package/.docs/raw/docs/guides/headless-composer-input.mdx +0 -113
package/.docs/raw/docs/guides/image-generation.mdx +0 -74
package/.docs/raw/docs/guides/index.mdx +0 -117
package/.docs/raw/docs/guides/input-history.mdx +0 -55
package/.docs/raw/docs/guides/latex.mdx +0 -158
package/.docs/raw/docs/guides/mentions.mdx +0 -575
package/.docs/raw/docs/guides/message-timing.mdx +0 -215
package/.docs/raw/docs/guides/quoting.mdx +0 -169
package/.docs/raw/docs/guides/resumable-stream-deployment.mdx +0 -212
package/.docs/raw/docs/guides/resumable-stream-stores.mdx +0 -152
package/.docs/raw/docs/guides/resumable-streams.mdx +0 -292
package/.docs/raw/docs/guides/slash-commands.mdx +0 -358
package/.docs/raw/docs/guides/speech.mdx +0 -172
package/.docs/raw/docs/guides/suggestions.mdx +0 -384
package/.docs/raw/docs/guides/virtualization.mdx +0 -133
package/.docs/raw/docs/guides/voice.mdx +0 -310
package/.docs/raw/docs/ink/adapters.mdx +0 -99
package/.docs/raw/docs/ink/custom-backend.mdx +0 -254
package/.docs/raw/docs/ink/hooks.mdx +0 -469
package/.docs/raw/docs/ink/index.mdx +0 -237
package/.docs/raw/docs/ink/migration.mdx +0 -138
package/.docs/raw/docs/ink/primitives.mdx +0 -1259
package/.docs/raw/docs/integrations/attachments/custom-adapter.mdx +0 -528
package/.docs/raw/docs/integrations/auth/better-auth.mdx +0 -188
package/.docs/raw/docs/integrations/auth/clerk.mdx +0 -166
package/.docs/raw/docs/integrations/auth/next-auth.mdx +0 -191
package/.docs/raw/docs/integrations/frameworks/ai-sdk.mdx +0 -88
package/.docs/raw/docs/integrations/frameworks/cloudflare-agents.mdx +0 -283
package/.docs/raw/docs/integrations/frameworks/mastra/full-stack.mdx +0 -188
package/.docs/raw/docs/integrations/frameworks/mastra/overview.mdx +0 -57
package/.docs/raw/docs/integrations/frameworks/mastra/separate-server.mdx +0 -201
package/.docs/raw/docs/integrations/gateways/index.mdx +0 -162
package/.docs/raw/docs/integrations/index.mdx +0 -178
package/.docs/raw/docs/integrations/observability/helicone.mdx +0 -129
package/.docs/raw/docs/integrations/observability/langfuse.mdx +0 -161
package/.docs/raw/docs/integrations/observability/langsmith.mdx +0 -151
package/.docs/raw/docs/integrations/persistence/custom-adapter.mdx +0 -773
package/.docs/raw/docs/migrations/deprecation-policy.mdx +0 -42
package/.docs/raw/docs/migrations/index.mdx +0 -50
package/.docs/raw/docs/migrations/react-compatibility.mdx +0 -74
package/.docs/raw/docs/migrations/react-langgraph-v0-7.mdx +0 -328
package/.docs/raw/docs/migrations/toolkit-tools.mdx +0 -236
package/.docs/raw/docs/migrations/v0-11.mdx +0 -172
package/.docs/raw/docs/migrations/v0-12.mdx +0 -302
package/.docs/raw/docs/migrations/v0-14.mdx +0 -297
package/.docs/raw/docs/migrations/v0-15.mdx +0 -270
package/.docs/raw/docs/primitives/action-bar.mdx +0 -352
package/.docs/raw/docs/primitives/assistant-modal.mdx +0 -216
package/.docs/raw/docs/primitives/attachment.mdx +0 -217
package/.docs/raw/docs/primitives/branch-picker.mdx +0 -222
package/.docs/raw/docs/primitives/chain-of-thought.mdx +0 -315
package/.docs/raw/docs/primitives/composer.mdx +0 -659
package/.docs/raw/docs/primitives/error.mdx +0 -142
package/.docs/raw/docs/primitives/index.mdx +0 -99
package/.docs/raw/docs/primitives/message.mdx +0 -618
package/.docs/raw/docs/primitives/selection-toolbar.mdx +0 -191
package/.docs/raw/docs/primitives/suggestion.mdx +0 -254
package/.docs/raw/docs/primitives/thread-list.mdx +0 -467
package/.docs/raw/docs/primitives/thread.mdx +0 -509
package/.docs/raw/docs/react-native/adapters.mdx +0 -94
package/.docs/raw/docs/react-native/custom-backend.mdx +0 -207
package/.docs/raw/docs/react-native/hooks.mdx +0 -339
package/.docs/raw/docs/react-native/index.mdx +0 -289
package/.docs/raw/docs/react-native/migration.mdx +0 -142
package/.docs/raw/docs/react-native/primitives.mdx +0 -976
package/.docs/raw/docs/runtimes/a2a/client-and-hooks.mdx +0 -399
package/.docs/raw/docs/runtimes/a2a/overview.mdx +0 -60
package/.docs/raw/docs/runtimes/a2a/quickstart.mdx +0 -216
package/.docs/raw/docs/runtimes/ag-ui/agent-state.mdx +0 -124
package/.docs/raw/docs/runtimes/ag-ui/overview.mdx +0 -70
package/.docs/raw/docs/runtimes/ag-ui/quickstart.mdx +0 -243
package/.docs/raw/docs/runtimes/ag-ui/runtime-options.mdx +0 -267
package/.docs/raw/docs/runtimes/ai-sdk/overview.mdx +0 -61
package/.docs/raw/docs/runtimes/ai-sdk/v4-legacy.mdx +0 -122
package/.docs/raw/docs/runtimes/ai-sdk/v5-legacy.mdx +0 -135
package/.docs/raw/docs/runtimes/ai-sdk/v6-legacy.mdx +0 -636
package/.docs/raw/docs/runtimes/ai-sdk/v7.mdx +0 -731
package/.docs/raw/docs/runtimes/claude-managed-agents.mdx +0 -118
package/.docs/raw/docs/runtimes/concepts/adapters.mdx +0 -265
package/.docs/raw/docs/runtimes/concepts/architecture.mdx +0 -167
package/.docs/raw/docs/runtimes/concepts/stability.mdx +0 -68
package/.docs/raw/docs/runtimes/concepts/threads.mdx +0 -513
package/.docs/raw/docs/runtimes/custom/assistant-transport.mdx +0 -763
package/.docs/raw/docs/runtimes/custom/data-stream.mdx +0 -339
package/.docs/raw/docs/runtimes/custom/external-store.mdx +0 -957
package/.docs/raw/docs/runtimes/custom/local-runtime.mdx +0 -902
package/.docs/raw/docs/runtimes/custom/overview.mdx +0 -71
package/.docs/raw/docs/runtimes/eve/overview.mdx +0 -151
package/.docs/raw/docs/runtimes/eve/quickstart.mdx +0 -192
package/.docs/raw/docs/runtimes/google-adk/api.mdx +0 -256
package/.docs/raw/docs/runtimes/google-adk/hooks.mdx +0 -784
package/.docs/raw/docs/runtimes/google-adk/overview.mdx +0 -69
package/.docs/raw/docs/runtimes/google-adk/quickstart.mdx +0 -229
package/.docs/raw/docs/runtimes/langchain.mdx +0 -901
package/.docs/raw/docs/runtimes/langgraph/agent-state.mdx +0 -181
package/.docs/raw/docs/runtimes/langgraph/generative-ui.mdx +0 -305
package/.docs/raw/docs/runtimes/langgraph/interrupts.mdx +0 -104
package/.docs/raw/docs/runtimes/langgraph/overview.mdx +0 -84
package/.docs/raw/docs/runtimes/langgraph/quickstart.mdx +0 -496
package/.docs/raw/docs/runtimes/langgraph/streaming.mdx +0 -144
package/.docs/raw/docs/runtimes/langgraph/threads.mdx +0 -113
package/.docs/raw/docs/runtimes/langgraph/tutorial/introduction.mdx +0 -29
package/.docs/raw/docs/runtimes/langgraph/tutorial/part-1.mdx +0 -93
package/.docs/raw/docs/runtimes/langgraph/tutorial/part-2.mdx +0 -347
package/.docs/raw/docs/runtimes/langgraph/tutorial/part-3.mdx +0 -393
package/.docs/raw/docs/runtimes/opencode/hooks.mdx +0 -194
package/.docs/raw/docs/runtimes/opencode/overview.mdx +0 -58
package/.docs/raw/docs/runtimes/opencode/quickstart.mdx +0 -119
package/.docs/raw/docs/runtimes/pick-a-runtime.mdx +0 -133
package/.docs/raw/docs/tools/a2ui.mdx +0 -107
package/.docs/raw/docs/tools/backend.mdx +0 -147
package/.docs/raw/docs/tools/defining-tools.mdx +0 -574
package/.docs/raw/docs/tools/dynamic-tools.mdx +0 -112
package/.docs/raw/docs/tools/generative-ui-primitive.mdx +0 -180
package/.docs/raw/docs/tools/generative-ui-slack.mdx +0 -167
package/.docs/raw/docs/tools/generative-ui-teams.mdx +0 -160
package/.docs/raw/docs/tools/generative-ui.mdx +0 -322
package/.docs/raw/docs/tools/index.mdx +0 -72
package/.docs/raw/docs/tools/interactables.mdx +0 -1084
package/.docs/raw/docs/tools/mcp-apps.mdx +0 -363
package/.docs/raw/docs/tools/mcp.mdx +0 -466
package/.docs/raw/docs/tools/multi-agent.mdx +0 -237
package/.docs/raw/docs/tools/openui.mdx +0 -175
package/.docs/raw/docs/tools/tool-ui.mdx +0 -1020
package/.docs/raw/docs/tools/user-managed-mcp.mdx +0 -428
package/.docs/raw/docs/ui/assistant-modal.mdx +0 -166
package/.docs/raw/docs/ui/assistant-sidebar.mdx +0 -89
package/.docs/raw/docs/ui/attachment.mdx +0 -279
package/.docs/raw/docs/ui/composer-trigger-popover.mdx +0 -247
package/.docs/raw/docs/ui/context-display.mdx +0 -148
package/.docs/raw/docs/ui/directive-text.mdx +0 -114
package/.docs/raw/docs/ui/file.mdx +0 -159
package/.docs/raw/docs/ui/follow-up-suggestions.mdx +0 -82
package/.docs/raw/docs/ui/image.mdx +0 -102
package/.docs/raw/docs/ui/markdown.mdx +0 -103
package/.docs/raw/docs/ui/mcp-config.mdx +0 -107
package/.docs/raw/docs/ui/mermaid.mdx +0 -92
package/.docs/raw/docs/ui/message-timing.mdx +0 -93
package/.docs/raw/docs/ui/model-selector.mdx +0 -455
package/.docs/raw/docs/ui/part-grouping.mdx +0 -614
package/.docs/raw/docs/ui/quote.mdx +0 -211
package/.docs/raw/docs/ui/reasoning.mdx +0 -214
package/.docs/raw/docs/ui/scrollbar.mdx +0 -77
package/.docs/raw/docs/ui/sources.mdx +0 -186
package/.docs/raw/docs/ui/streamdown.mdx +0 -392
package/.docs/raw/docs/ui/syntax-highlighting.mdx +0 -205
package/.docs/raw/docs/ui/thread-list.mdx +0 -411
package/.docs/raw/docs/ui/thread.mdx +0 -559
package/.docs/raw/docs/ui/tool-fallback.mdx +0 -141
package/.docs/raw/docs/ui/tool-group.mdx +0 -240
package/.docs/raw/docs/ui/voice.mdx +0 -173
package/.docs/raw/docs/utilities/heat-graph.mdx +0 -237
package/.docs/raw/docs/utilities/react-o11y.mdx +0 -362
package/.docs/raw/docs/utilities/tw-shimmer.mdx +0 -212
package/dist/constants.d.ts +0 -14
package/dist/constants.d.ts.map +0 -1
package/dist/constants.js +0 -19
package/dist/constants.js.map +0 -1
package/dist/prepare-docs/code-examples.d.ts +0 -5
package/dist/prepare-docs/code-examples.d.ts.map +0 -1
package/dist/prepare-docs/code-examples.js +0 -117
package/dist/prepare-docs/code-examples.js.map +0 -1
package/dist/prepare-docs/copy-raw.d.ts +0 -5
package/dist/prepare-docs/copy-raw.d.ts.map +0 -1
package/dist/prepare-docs/copy-raw.js +0 -49
package/dist/prepare-docs/copy-raw.js.map +0 -1
package/dist/prepare-docs/prepare.d.ts +0 -1
package/dist/prepare-docs/prepare.js +0 -22
package/dist/prepare-docs/prepare.js.map +0 -1
package/dist/prompts/xulux-playground.d.ts +0 -12
package/dist/prompts/xulux-playground.d.ts.map +0 -1
package/dist/prompts/xulux-playground.js +0 -33
package/dist/prompts/xulux-playground.js.map +0 -1
package/dist/tools/docs.d.ts +0 -22
package/dist/tools/docs.d.ts.map +0 -1
package/dist/tools/docs.js +0 -177
package/dist/tools/docs.js.map +0 -1
package/dist/tools/examples.d.ts +0 -24
package/dist/tools/examples.d.ts.map +0 -1
package/dist/tools/examples.js +0 -87
package/dist/tools/examples.js.map +0 -1
package/dist/tools/resources.d.ts +0 -6
package/dist/tools/resources.d.ts.map +0 -1
package/dist/tools/resources.js +0 -75
package/dist/tools/resources.js.map +0 -1
package/dist/tools/search.d.ts +0 -24
package/dist/tools/search.d.ts.map +0 -1
package/dist/tools/search.js +0 -39
package/dist/tools/search.js.map +0 -1
package/dist/tools/tests/mcp-test-client.d.ts +0 -15
package/dist/tools/tests/mcp-test-client.d.ts.map +0 -1
package/dist/tools/tests/mcp-test-client.js +0 -68
package/dist/tools/tests/mcp-test-client.js.map +0 -1
package/dist/tools/tests/test-setup.d.ts +0 -7
package/dist/tools/tests/test-setup.d.ts.map +0 -1
package/dist/tools/tests/test-setup.js +0 -36
package/dist/tools/tests/test-setup.js.map +0 -1
package/dist/tools/xulux-templates.d.ts +0 -58
package/dist/tools/xulux-templates.d.ts.map +0 -1
package/dist/tools/xulux-templates.js +0 -84
package/dist/tools/xulux-templates.js.map +0 -1
package/dist/utils/cache.d.ts +0 -5
package/dist/utils/cache.d.ts.map +0 -1
package/dist/utils/cache.js +0 -18
package/dist/utils/cache.js.map +0 -1
package/dist/utils/logger.d.ts +0 -10
package/dist/utils/logger.d.ts.map +0 -1
package/dist/utils/logger.js +0 -20
package/dist/utils/logger.js.map +0 -1
package/dist/utils/mcp-format.d.ts +0 -11
package/dist/utils/mcp-format.d.ts.map +0 -1
package/dist/utils/mcp-format.js +0 -14
package/dist/utils/mcp-format.js.map +0 -1
package/dist/utils/mdx.d.ts +0 -12
package/dist/utils/mdx.d.ts.map +0 -1
package/dist/utils/mdx.js +0 -45
package/dist/utils/mdx.js.map +0 -1
package/dist/utils/paths.d.ts +0 -12
package/dist/utils/paths.d.ts.map +0 -1
package/dist/utils/paths.js +0 -93
package/dist/utils/paths.js.map +0 -1
package/dist/utils/search.d.ts +0 -10
package/dist/utils/search.d.ts.map +0 -1
package/dist/utils/search.js +0 -97
package/dist/utils/search.js.map +0 -1
package/dist/utils/security.d.ts +0 -5
package/dist/utils/security.d.ts.map +0 -1
package/dist/utils/security.js +0 -22
package/dist/utils/security.js.map +0 -1
package/dist/xulux/catalog-client.d.ts +0 -14
package/dist/xulux/catalog-client.d.ts.map +0 -1
package/dist/xulux/catalog-client.js +0 -112
package/dist/xulux/catalog-client.js.map +0 -1
package/dist/xulux/fallback-catalog.d.ts +0 -7
package/dist/xulux/fallback-catalog.d.ts.map +0 -1
package/dist/xulux/fallback-catalog.js +0 -47
package/dist/xulux/fallback-catalog.js.map +0 -1
package/dist/xulux/fetch-sandbox.d.ts +0 -5
package/dist/xulux/fetch-sandbox.d.ts.map +0 -1
package/dist/xulux/fetch-sandbox.js +0 -40
package/dist/xulux/fetch-sandbox.js.map +0 -1
package/dist/xulux/template-service.d.ts +0 -84
package/dist/xulux/template-service.d.ts.map +0 -1
package/dist/xulux/template-service.js +0 -223
package/dist/xulux/template-service.js.map +0 -1
package/dist/xulux/types.d.ts +0 -55
package/dist/xulux/types.d.ts.map +0 -1
package/dist/xulux/types.js +0 -6
package/dist/xulux/types.js.map +0 -1
package/src/constants.ts +0 -24
package/src/prepare-docs/code-examples.ts +0 -158
package/src/prepare-docs/copy-raw.ts +0 -50
package/src/prepare-docs/prepare.ts +0 -24
package/src/prompts/xulux-playground.ts +0 -36
package/src/tools/docs.ts +0 -255
package/src/tools/examples.ts +0 -114
package/src/tools/resources.ts +0 -111
package/src/tools/search.ts +0 -46
package/src/tools/tests/completions.test.ts +0 -60
package/src/tools/tests/directory-size-cap.test.ts +0 -50
package/src/tools/tests/docs.test.ts +0 -147
package/src/tools/tests/examples.test.ts +0 -94
package/src/tools/tests/integration.test.ts +0 -45
package/src/tools/tests/json-parsing.test.ts +0 -23
package/src/tools/tests/listings-cache.test.ts +0 -19
package/src/tools/tests/mcp-protocol.test.ts +0 -216
package/src/tools/tests/mcp-test-client.ts +0 -111
package/src/tools/tests/path-traversal.test.ts +0 -84
package/src/tools/tests/resources.test.ts +0 -133
package/src/tools/tests/search.test.ts +0 -37
package/src/tools/tests/test-setup.ts +0 -50
package/src/tools/tests/xulux-templates.test.ts +0 -325
package/src/tools/xulux-templates.ts +0 -141
package/src/utils/cache.ts +0 -20
package/src/utils/logger.ts +0 -20
package/src/utils/mcp-format.ts +0 -14
package/src/utils/mdx.ts +0 -59
package/src/utils/paths.ts +0 -139
package/src/utils/search.ts +0 -131
package/src/utils/security.ts +0 -52
package/src/utils/tests/cache.test.ts +0 -51
package/src/utils/tests/mcp-format.test.ts +0 -22
package/src/utils/tests/security.test.ts +0 -119
package/src/xulux/catalog-client.ts +0 -150
package/src/xulux/fallback-catalog.ts +0 -63
package/src/xulux/fetch-sandbox.ts +0 -56
package/src/xulux/template-service.ts +0 -406
package/src/xulux/types.ts +0 -64

package/.docs/organized/code-examples/waterfall.md DELETED Viewed

@@ -1,807 +0,0 @@
-# Example: waterfall
-## app/globals.css
-```css
-@import "tailwindcss";
-:root {
-  --background: #ffffff;
-  --foreground: #171717;
-  --muted-foreground: #737373;
-  --border: #e5e5e5;
-  --accent: #f5f5f5;
-}
-@theme inline {
-  --color-background: var(--background);
-  --color-foreground: var(--foreground);
-  --color-muted-foreground: var(--muted-foreground);
-  --color-border: var(--border);
-  --color-accent: var(--accent);
-  --font-sans: var(--font-geist-sans);
-  --font-mono: var(--font-geist-mono);
-}
-@media (prefers-color-scheme: dark) {
-  :root {
-    --background: #0a0a0a;
-    --foreground: #ededed;
-    --muted-foreground: #a3a3a3;
-    --border: #2e2e2e;
-    --accent: #1a1a1a;
-  }
-}
-body {
-  background: var(--background);
-  color: var(--foreground);
-  font-family: Arial, Helvetica, sans-serif;
-}
-```
-## app/layout.tsx
-```tsx
-import type { Metadata } from "next";
-import { Geist, Geist_Mono } from "next/font/google";
-import "./globals.css";
-const geistSans = Geist({
-  variable: "--font-geist-sans",
-  subsets: ["latin"],
-});
-const geistMono = Geist_Mono({
-  variable: "--font-geist-mono",
-  subsets: ["latin"],
-});
-export const metadata: Metadata = {
-  title: "Waterfall Example",
-  description: "Span waterfall visualization with @assistant-ui/react-o11y",
-};
-export default function RootLayout({
-  children,
-}: Readonly<{
-  children: React.ReactNode;
-}>) {
-  return (
-    <html lang="en">
-      <body
-        className={`${geistSans.variable} ${geistMono.variable} antialiased`}
-      >
-        {children}
-      </body>
-    </html>
-  );
-}
-```
-## app/page.tsx
-```tsx
-import { WaterfallPage } from "@/lib/waterfall-page";
-export default function Home() {
-  return (
-    <div className="bg-background min-h-screen p-8">
-      <div className="mx-auto max-w-6xl">
-        <div className="mb-8">
-          <h1 className="text-foreground mb-2 text-4xl font-bold">
-            Waterfall Timeline
-          </h1>
-          <p className="text-muted-foreground text-lg">
-            Span visualization powered by @assistant-ui/react-o11y
-          </p>
-        </div>
-        <WaterfallPage />
-      </div>
-    </div>
-  );
-}
-```
-## lib/mock-data.ts
-```typescript
-import type { SpanData } from "@assistant-ui/react-o11y";
-const BASE = Date.now() - 5000;
-export const mockSpans: SpanData[] = [
-  {
-    id: "span-1",
-    parentSpanId: null,
-    name: "POST /api/chat",
-    type: "api",
-    status: "completed",
-    startedAt: BASE,
-    endedAt: BASE + 4200,
-    latencyMs: 4200,
-  },
-  {
-    id: "span-2",
-    parentSpanId: "span-1",
-    name: "authenticate",
-    type: "action",
-    status: "completed",
-    startedAt: BASE + 50,
-    endedAt: BASE + 200,
-    latencyMs: 150,
-  },
-  {
-    id: "span-3",
-    parentSpanId: "span-1",
-    name: "agent-pipeline",
-    type: "pipeline",
-    status: "completed",
-    startedAt: BASE + 220,
-    endedAt: BASE + 4100,
-    latencyMs: 3880,
-  },
-  {
-    id: "span-4",
-    parentSpanId: "span-3",
-    name: "retrieve-context",
-    type: "tool",
-    status: "completed",
-    startedAt: BASE + 250,
-    endedAt: BASE + 900,
-    latencyMs: 650,
-  },
-  {
-    id: "span-5",
-    parentSpanId: "span-3",
-    name: "llm-generate",
-    type: "action",
-    status: "completed",
-    startedAt: BASE + 920,
-    endedAt: BASE + 2800,
-    latencyMs: 1880,
-  },
-  {
-    id: "span-6",
-    parentSpanId: "span-3",
-    name: "web-search",
-    type: "tool",
-    status: "completed",
-    startedAt: BASE + 2850,
-    endedAt: BASE + 3500,
-    latencyMs: 650,
-  },
-  {
-    id: "span-7",
-    parentSpanId: "span-3",
-    name: "llm-summarize",
-    type: "action",
-    status: "completed",
-    startedAt: BASE + 3520,
-    endedAt: BASE + 4050,
-    latencyMs: 530,
-  },
-  {
-    id: "span-8",
-    parentSpanId: "span-1",
-    name: "log-response",
-    type: "action",
-    status: "completed",
-    startedAt: BASE + 4110,
-    endedAt: BASE + 4180,
-    latencyMs: 70,
-  },
-  {
-    id: "span-9",
-    parentSpanId: null,
-    name: "POST /api/feedback",
-    type: "api",
-    status: "completed",
-    startedAt: BASE + 4500,
-    endedAt: BASE + 4700,
-    latencyMs: 200,
-  },
-  {
-    id: "span-10",
-    parentSpanId: "span-9",
-    name: "validate-input",
-    type: "action",
-    status: "completed",
-    startedAt: BASE + 4520,
-    endedAt: BASE + 4560,
-    latencyMs: 40,
-  },
-  {
-    id: "span-11",
-    parentSpanId: "span-9",
-    name: "store-feedback",
-    type: "action",
-    status: "failed",
-    startedAt: BASE + 4570,
-    endedAt: BASE + 4680,
-    latencyMs: 110,
-  },
-  {
-    id: "span-12",
-    parentSpanId: null,
-    name: "GET /api/status",
-    type: "api",
-    status: "running",
-    startedAt: BASE + 4800,
-    endedAt: null,
-    latencyMs: null,
-  },
-  {
-    id: "span-13",
-    parentSpanId: "span-12",
-    name: "health-check",
-    type: "flow",
-    status: "running",
-    startedAt: BASE + 4830,
-    endedAt: null,
-    latencyMs: null,
-  },
-  {
-    id: "span-14",
-    parentSpanId: "span-4",
-    name: "vector-search",
-    type: "tool",
-    status: "completed",
-    startedAt: BASE + 280,
-    endedAt: BASE + 700,
-    latencyMs: 420,
-  },
-  {
-    id: "span-15",
-    parentSpanId: "span-4",
-    name: "rerank",
-    type: "action",
-    status: "completed",
-    startedAt: BASE + 710,
-    endedAt: BASE + 880,
-    latencyMs: 170,
-  },
-];
-```
-## lib/waterfall-bar.tsx
-```tsx
-"use client";
-import { useCallback, useEffect, useRef } from "react";
-import { useAuiState } from "@assistant-ui/store";
-import type { SpanItemState } from "@assistant-ui/react-o11y";
-import { useWaterfallLayout } from "./waterfall-timeline";
-const TYPE_COLORS: Record<string, string> = {
-  action: "hsl(221 83% 53%)",
-  api: "hsl(262 83% 58%)",
-  tool: "hsl(142 71% 45%)",
-  flow: "hsl(25 95% 53%)",
-  pipeline: "hsl(340 75% 55%)",
-};
-const FALLBACK_COLOR = "hsl(220 9% 46%)";
-const STATUS_OPACITY: Record<SpanItemState["status"], number> = {
-  running: 0.7,
-  completed: 1,
-  failed: 1,
-  skipped: 0.5,
-};
-export function WaterfallBar() {
-  const { barWidth, timeRange, barHeight } = useWaterfallLayout();
-  const startedAt = useAuiState((s) => s.span.startedAt);
-  const endedAt = useAuiState((s) => s.span.endedAt) as number | null;
-  const status = useAuiState((s) => s.span.status) as SpanItemState["status"];
-  const type = useAuiState((s) => s.span.type);
-  const barRef = useRef<SVGRectElement>(null);
-  const scale = useCallback(
-    (t: number) => {
-      const range = timeRange.max - timeRange.min || 1;
-      return ((t - timeRange.min) / range) * barWidth;
-    },
-    [timeRange, barWidth],
-  );
-  const x = scale(startedAt);
-  useEffect(() => {
-    if (status !== "running") return;
-    let frameId: number;
-    const tick = () => {
-      const width = scale(Date.now()) - x;
-      barRef.current?.setAttribute("width", String(Math.max(0, width)));
-      frameId = requestAnimationFrame(tick);
-    };
-    frameId = requestAnimationFrame(tick);
-    return () => cancelAnimationFrame(frameId);
-  }, [status, x, scale]);
-  const rawWidth = endedAt ? scale(endedAt) - x : 0;
-  const width = Math.max(rawWidth, 4);
-  const fill = TYPE_COLORS[type] ?? FALLBACK_COLOR;
-  const opacity = STATUS_OPACITY[status];
-  return (
-    <g>
-      <rect
-        ref={barRef}
-        x={x}
-        y={4}
-        width={width}
-        height={barHeight - 8}
-        rx={3}
-        fill={fill}
-        opacity={opacity}
-        className={status === "running" ? "animate-pulse" : ""}
-      />
-      {status === "failed" && (
-        <rect
-          x={x}
-          y={4}
-          width={width}
-          height={barHeight - 8}
-          rx={3}
-          fill="none"
-          stroke="hsl(0 84% 60%)"
-          strokeWidth={2}
-        />
-      )}
-    </g>
-  );
-}
-```
-## lib/waterfall-page.tsx
-```tsx
-"use client";
-import { AuiProvider, AuiConfig } from "@assistant-ui/store";
-import { SpanResource } from "@assistant-ui/react-o11y";
-import { mockSpans } from "./mock-data";
-import { WaterfallTimeline } from "./waterfall-timeline";
-const config = AuiConfig({
-  span: SpanResource({ spans: mockSpans }),
-});
-export function WaterfallPage() {
-  return (
-    <AuiProvider config={config}>
-      <WaterfallTimeline />
-    </AuiProvider>
-  );
-}
-```
-## lib/waterfall-row.tsx
-```tsx
-"use client";
-import { SpanPrimitive } from "@assistant-ui/react-o11y";
-import { AuiIf } from "@assistant-ui/store";
-import { WaterfallBar } from "./waterfall-bar";
-import { useWaterfallLayout } from "./waterfall-timeline";
-const LABEL_WIDTH = 200;
-export function WaterfallRow() {
-  const { barWidth, contentWidth, barHeight } = useWaterfallLayout();
-  return (
-    <SpanPrimitive.Root
-      className="group flex cursor-pointer items-center"
-      style={{ width: contentWidth, height: barHeight }}
-    >
-      <SpanPrimitive.Indent
-        baseIndent={8}
-        indentPerLevel={12}
-        className="border-border bg-background group-hover:bg-accent/50 sticky left-0 z-10 flex shrink-0 items-center gap-1 overflow-hidden border-r px-2"
-        style={{ width: LABEL_WIDTH, height: barHeight }}
-      >
-        <AuiIf condition={(s) => s.span.hasChildren}>
-          <SpanPrimitive.CollapseToggle className="text-muted-foreground hover:text-foreground flex shrink-0 items-center justify-center rounded p-0.5">
-            <svg
-              aria-hidden="true"
-              className="size-3.5 transition-transform group-data-[collapsed=true]:-rotate-90"
-              viewBox="0 0 16 16"
-              fill="currentColor"
-            >
-              <path d="M4 6l4 4 4-4H4z" />
-            </svg>
-          </SpanPrimitive.CollapseToggle>
-        </AuiIf>
-        <AuiIf condition={(s) => !s.span.hasChildren}>
-          <span className="w-4.5 shrink-0" />
-        </AuiIf>
-        <SpanPrimitive.StatusIndicator className="size-1.5 shrink-0 rounded-full bg-current" />
-        <SpanPrimitive.TypeBadge className="border-border text-muted-foreground shrink-0 rounded border px-1 text-[10px]" />
-        <SpanPrimitive.Name className="truncate text-sm" />
-      </SpanPrimitive.Indent>
-      {/* Timeline bar */}
-      <div
-        className="group-hover:bg-accent/30"
-        style={{ width: barWidth, height: barHeight }}
-      >
-        <svg aria-hidden="true" width={barWidth} height={barHeight}>
-          <WaterfallBar />
-        </svg>
-      </div>
-    </SpanPrimitive.Root>
-  );
-}
-```
-## lib/waterfall-timeline.tsx
-```tsx
-"use client";
-import {
-  createContext,
-  useContext,
-  useEffect,
-  useLayoutEffect,
-  useMemo,
-  useRef,
-  useState,
-} from "react";
-import { useAuiState } from "@assistant-ui/store";
-import { SpanPrimitive, type SpanState } from "@assistant-ui/react-o11y";
-import { WaterfallRow } from "./waterfall-row";
-const LABEL_WIDTH = 200;
-const MAX_LIST_HEIGHT = 400;
-const MIN_ZOOM = 1;
-const MAX_ZOOM = 20;
-const RIGHT_PADDING_RATIO = 0.08;
-export type WaterfallLayoutContextValue = {
-  barWidth: number;
-  timeRange: { min: number; max: number };
-  barHeight: number;
-  contentWidth: number;
-  selectedSpanId: string | null;
-  onSelectSpan: (spanId: string) => void;
-};
-export const WaterfallLayoutContext =
-  createContext<WaterfallLayoutContextValue | null>(null);
-export function useWaterfallLayout(): WaterfallLayoutContextValue {
-  const ctx = useContext(WaterfallLayoutContext);
-  if (!ctx) {
-    throw new Error(
-      "useWaterfallLayout must be used within WaterfallLayoutContext",
-    );
-  }
-  return ctx;
-}
-function formatTime(ms: number): string {
-  if (ms < 1000) return `${Math.round(ms)} ms`;
-  return `${(ms / 1000).toFixed(1)} s`;
-}
-function TimeAxisTicks({
-  timeRange,
-  barWidth,
-}: {
-  timeRange: { min: number; max: number };
-  barWidth: number;
-}) {
-  const duration = timeRange.max - timeRange.min;
-  const tickCount = Math.min(5, Math.max(2, Math.floor(barWidth / 100)));
-  const ticks = Array.from({ length: tickCount + 1 }, (_, i) => {
-    const t = (i / tickCount) * duration;
-    const x = (i / tickCount) * barWidth;
-    return { t, x };
-  });
-  return (
-    <svg
-      aria-hidden="true"
-      width={barWidth}
-      height={28}
-      className="overflow-visible"
-    >
-      {ticks.map(({ t, x }) => (
-        <g key={x}>
-          <line
-            x1={x}
-            y1={20}
-            x2={x}
-            y2={28}
-            stroke="currentColor"
-            className="text-border"
-          />
-          <text
-            x={x}
-            y={14}
-            textAnchor="middle"
-            className="fill-muted-foreground text-[10px]"
-          >
-            {formatTime(t)}
-          </text>
-        </g>
-      ))}
-    </svg>
-  );
-}
-export function WaterfallTimeline() {
-  const outerRef = useRef<HTMLDivElement>(null);
-  const scrollRef = useRef<HTMLDivElement>(null);
-  const [baseBarWidth, setBaseBarWidth] = useState(400);
-  const [zoom, setZoom] = useState(1);
-  const zoomRef = useRef(1);
-  const baseBarWidthRef = useRef(400);
-  const scrollAdjustRef = useRef<{
-    mouseX: number;
-    ratio: number;
-  } | null>(null);
-  const [selectedSpanId, setSelectedSpanId] = useState<string | null>(null);
-  const barWidth = Math.max(200, Math.round(baseBarWidth * zoom));
-  const hasSpans = useAuiState((s) => s.span.hasChildren);
-  const timeRange = useAuiState(
-    (s) => s.span.timeRange,
-  ) as SpanState["timeRange"];
-  // Measure outer container width — re-attach when scroll container mounts
-  useEffect(() => {
-    const el = outerRef.current;
-    if (!el) return;
-    const observer = new ResizeObserver((entries) => {
-      const entry = entries[0];
-      if (entry) {
-        const w = Math.max(200, entry.contentRect.width - LABEL_WIDTH);
-        baseBarWidthRef.current = w;
-        setBaseBarWidth(w);
-      }
-    });
-    observer.observe(el);
-    return () => observer.disconnect();
-  }, [hasSpans]);
-  // Cmd + scroll wheel zoom — re-attach when scroll container mounts
-  useEffect(() => {
-    const el = scrollRef.current;
-    if (!el) return;
-    const handleWheel = (e: WheelEvent) => {
-      if (!e.metaKey) return;
-      e.preventDefault();
-      const rect = el.getBoundingClientRect();
-      const mouseXInView = e.clientX - rect.left - LABEL_WIDTH;
-      const mouseXInContent = el.scrollLeft + mouseXInView;
-      const currentBarWidth = baseBarWidthRef.current * zoomRef.current;
-      const ratio = currentBarWidth > 0 ? mouseXInContent / currentBarWidth : 0;
-      const newZoom = Math.max(
-        MIN_ZOOM,
-        Math.min(MAX_ZOOM, zoomRef.current * 2 ** (-e.deltaY * 0.003)),
-      );
-      scrollAdjustRef.current = { mouseX: mouseXInView, ratio };
-      zoomRef.current = newZoom;
-      setZoom(newZoom);
-    };
-    el.addEventListener("wheel", handleWheel, { passive: false });
-    return () => el.removeEventListener("wheel", handleWheel);
-  }, [hasSpans]);
-  // Adjust scroll after zoom
-  useLayoutEffect(() => {
-    const adj = scrollAdjustRef.current;
-    const el = scrollRef.current;
-    if (!adj || !el) return;
-    scrollAdjustRef.current = null;
-    const newBarX = adj.ratio * barWidth;
-    el.scrollLeft = newBarX - adj.mouseX;
-  }, [barWidth]);
-  const renderTimeRange = useMemo(() => {
-    const duration = timeRange.max - timeRange.min;
-    return {
-      min: timeRange.min,
-      max: timeRange.max + duration * RIGHT_PADDING_RATIO,
-    };
-  }, [timeRange]);
-  const contentWidth = LABEL_WIDTH + barWidth;
-  const scrollMaxHeight = MAX_LIST_HEIGHT + 28;
-  const layoutValue = useMemo(
-    () => ({
-      barWidth,
-      timeRange: renderTimeRange,
-      barHeight: 32,
-      contentWidth,
-      selectedSpanId,
-      onSelectSpan: setSelectedSpanId,
-    }),
-    [barWidth, renderTimeRange, contentWidth, selectedSpanId],
-  );
-  if (!hasSpans) {
-    return (
-      <div className="border-border text-muted-foreground rounded-lg border py-12 text-center text-sm">
-        No spans recorded.
-      </div>
-    );
-  }
-  return (
-    <div ref={outerRef} className="border-border rounded-lg border">
-      <div
-        ref={scrollRef}
-        className="overflow-auto"
-        style={{ maxHeight: scrollMaxHeight }}
-      >
-        {/* Time axis */}
-        <div
-          className="border-border bg-background sticky top-0 z-20 flex border-b"
-          style={{ width: contentWidth }}
-        >
-          <div
-            className="border-border bg-background text-muted-foreground sticky left-0 z-30 shrink-0 border-r px-2 py-1.5 text-xs"
-            style={{ width: LABEL_WIDTH }}
-          >
-            Span
-          </div>
-          <div style={{ width: barWidth, height: 28 }}>
-            <TimeAxisTicks timeRange={renderTimeRange} barWidth={barWidth} />
-          </div>
-        </div>
-        {/* Span rows */}
-        <WaterfallLayoutContext.Provider value={layoutValue}>
-          <div
-            style={{ width: contentWidth }}
-            onClick={(e) => {
-              const target = e.target as HTMLElement;
-              const el = target.closest("[data-span-id]") as HTMLElement | null;
-              if (el?.dataset.spanId) {
-                setSelectedSpanId(el.dataset.spanId);
-              }
-            }}
-          >
-            <SpanPrimitive.Children>
-              {() => <WaterfallRow />}
-            </SpanPrimitive.Children>
-          </div>
-        </WaterfallLayoutContext.Provider>
-      </div>
-      {/* Legend */}
-      <div className="border-border text-muted-foreground flex items-center gap-4 border-t px-3 py-2 text-xs">
-        <div className="flex items-center gap-1.5">
-          <span
-            className="size-2.5 rounded-sm"
-            style={{ background: "hsl(221 83% 53%)" }}
-          />
-          <span>action</span>
-        </div>
-        <div className="flex items-center gap-1.5">
-          <span
-            className="size-2.5 rounded-sm"
-            style={{ background: "hsl(262 83% 58%)" }}
-          />
-          <span>api</span>
-        </div>
-        <div className="flex items-center gap-1.5">
-          <span
-            className="size-2.5 rounded-sm"
-            style={{ background: "hsl(142 71% 45%)" }}
-          />
-          <span>tool</span>
-        </div>
-        <div className="flex items-center gap-1.5">
-          <span
-            className="size-2.5 rounded-sm"
-            style={{ background: "hsl(25 95% 53%)" }}
-          />
-          <span>flow</span>
-        </div>
-        <div className="flex items-center gap-1.5">
-          <span
-            className="size-2.5 rounded-sm"
-            style={{ background: "hsl(340 75% 55%)" }}
-          />
-          <span>pipeline</span>
-        </div>
-      </div>
-    </div>
-  );
-}
-```
-## next.config.ts
-```typescript
-import { withAui } from "@assistant-ui/next";
-import type { NextConfig } from "next";
-const nextConfig: NextConfig = {/* config options here */};
-export default withAui(nextConfig);
-```
-## package.json
-```json
-{
-  "name": "waterfall",
-  "version": "0.0.0",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "dev": "next dev",
-    "build": "next build",
-    "start": "next start"
-  },
-  "dependencies": {
-    "@assistant-ui/react-o11y": "workspace:*",
-    "@assistant-ui/store": "workspace:*",
-    "@assistant-ui/tap": "workspace:*",
-    "next": "^16.3.2",
-    "react": "^19.2.8",
-    "react-dom": "^19.2.8"
-  },
-  "devDependencies": {
-    "@assistant-ui/next": "workspace:*",
-    "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.3.3",
-    "@types/node": "^26.2.0",
-    "@types/react": "^19.2.18",
-    "@types/react-dom": "^19.2.5",
-    "postcss": "^8.5.26",
-    "tailwindcss": "^4.3.3",
-    "typescript": "^7.0.2"
-  }
-}
-```
-## tsconfig.json
-```json
-{
-  "extends": "@assistant-ui/x-buildutils/ts/next",
-  "compilerOptions": {
-    "paths": { "@/*": ["./*"] }
-  },
-  "include": ["**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
-  "exclude": ["node_modules"]
-}
-```