The Open Standard for Generative UI
Update GitHub demo components and add token comparison feature. (#438)
Aditya-thesys003f39fa26e1
diff --git a/docs/app/(home)/sections/HeroSection/HeroSection.module.css b/docs/app/(home)/sections/HeroSection/HeroSection.module.cssindex 84cb169f2..9aef3122b 100644--- a/docs/app/(home)/sections/HeroSection/HeroSection.module.css+++ b/docs/app/(home)/sections/HeroSection/HeroSection.module.css@@ -112,7 +112,9 @@background: var(--openui-foreground);box-shadow: var(--openui-shadow-l);cursor: pointer;- transition: transform 0.2s ease, box-shadow 0.2s ease;+ transition:+ transform 0.2s ease,+ box-shadow 0.2s ease;}.npmButton:hover {@@ -440,8 +442,12 @@/* ── Animation ── */@keyframes npmTickerScroll {- 0% { transform: translateX(0); }- 100% { transform: translateX(-50%); }+ 0% {+ transform: translateX(0);+ }+ 100% {+ transform: translateX(-50%);+ }}/* ── Responsive: subtitle no-wrap on wider phones ── */diff --git a/docs/app/(home)/sections/HeroSection/HeroSection.tsx b/docs/app/(home)/sections/HeroSection/HeroSection.tsxindex 8103b4990..4acac1b62 100644--- a/docs/app/(home)/sections/HeroSection/HeroSection.tsx+++ b/docs/app/(home)/sections/HeroSection/HeroSection.tsx@@ -88,7 +88,11 @@ function AnnouncementBanner({ className = "" }: { className?: string }) {<span>We're introducing OpenUI Lang v0.5</span></span><div className={styles.heroBannerActions}>- <Link href="/demo/github" target="_blank" className={`${styles.heroBannerButton} ${styles.heroBannerButtonPrimary}`}>+ <Link+ href="/demo/github"+ target="_blank"+ className={`${styles.heroBannerButton} ${styles.heroBannerButtonPrimary}`}+ ><span>Try</span></Link><Link href={architectureHref} className={styles.heroBannerButton}>@@ -96,7 +100,10 @@ function AnnouncementBanner({ className = "" }: { className?: string }) {</Link></div></div>- <Link href={architectureHref} className={`${styles.heroBanner} ${styles.heroBannerMobile} ${className}`.trim()}>+ <Link+ href={architectureHref}+ className={`${styles.heroBanner} ${styles.heroBannerMobile} ${className}`.trim()}+ ><span className={styles.heroBannerLabel}><span className={styles.heroBannerBadge}>New</span><span>Introducing OpenUI Lang v0.5</span>@@ -136,9 +143,7 @@ function DesktopHero() {<div className={styles.desktopHeroLockup}><AnnouncementBanner /><h1 className={styles.desktopTitle}>OpenUI</h1>- <p className={styles.desktopSubtitle}>- The Open Standard for Generative UI- </p>+ <p className={styles.desktopSubtitle}>The Open Standard for Generative UI</p></div><div className={styles.desktopCtaStack}>@@ -168,9 +173,7 @@ function MobileHero({ theme }: { theme: HeroTheme }) {</div>{/* Subtitle */}- <p className={styles.mobileSubtitle}>- The Open Standard for Generative UI- </p>+ <p className={styles.mobileSubtitle}>The Open Standard for Generative UI</p></div></div>diff --git a/docs/app/(home)/sections/PossibilitiesSection/PossibilitiesSection.tsx b/docs/app/(home)/sections/PossibilitiesSection/PossibilitiesSection.tsxindex 0c9f20b1e..53b7e2254 100644--- a/docs/app/(home)/sections/PossibilitiesSection/PossibilitiesSection.tsx+++ b/docs/app/(home)/sections/PossibilitiesSection/PossibilitiesSection.tsx@@ -156,24 +156,14 @@ export function PossibilitiesSection() {<div className={styles.mobileCarouselViewport}><div ref={mobileTrackRef} className={styles.mobileCarouselTrack}>{MOBILE_CAROUSEL_CARDS.map((card) => (- <Card- key={card.key}- title={card.title}- image={card.lightImage}- href={card.href}- />+ <Card key={card.key} title={card.title} image={card.lightImage} href={card.href} />))}</div></div><div className={styles.cardsGrid}>{CARDS.map((card) => (- <Card- key={card.title}- title={card.title}- image={card.lightImage}- href={card.href}- />+ <Card key={card.title} title={card.title} image={card.lightImage} href={card.href} />))}</div></div>diff --git a/docs/app/api/demo/github/stream/route.ts b/docs/app/api/demo/github/stream/route.tsindex ac4ca6092..fd3648177 100644--- a/docs/app/api/demo/github/stream/route.ts+++ b/docs/app/api/demo/github/stream/route.ts@@ -3,6 +3,7 @@ import { generatePrompt, type PromptSpec } from "@openuidev/lang-core";import { readFileSync } from "fs";import { type NextRequest } from "next/server";import { join } from "path";+import { GITHUB_DEMO_MODEL } from "../../../../demo/github/constants";import {GITHUB_ADDITIONAL_RULES,GITHUB_PREAMBLE,@@ -10,8 +11,6 @@ import {} from "../../../../demo/github/github/prompt-config";import { GITHUB_TOOL_SPECS } from "../../../../demo/github/github/types";-const MODEL = "openai/gpt-5.4-mini";-// ── Component spec from generated JSON ────────────────────────────────────const componentSpec = JSON.parse(@@ -74,7 +73,7 @@ export async function POST(req: NextRequest) {"X-Title": "OpenUI GitHub Demo",},body: JSON.stringify({- model: MODEL,+ model: GITHUB_DEMO_MODEL,stream: true,messages: chatMessages,}),diff --git a/docs/app/components/blocks/charts/line/page.tsx b/docs/app/components/blocks/charts/line/page.tsxindex 165424a20..3c56d8c08 100644--- a/docs/app/components/blocks/charts/line/page.tsx+++ b/docs/app/components/blocks/charts/line/page.tsx@@ -2,7 +2,7 @@import ClientOnly from "@components/blocks/_components/ClientOnly";import { BlockVariantPreview, PreviewPage, PreviewSection } from "@components/components/preview";-import { LineChartCondensed, LineChart } from "@openuidev/react-ui";+import { LineChart, LineChartCondensed } from "@openuidev/react-ui";const lineData = [{ month: "Jan", desktop: 150, mobile: 90 },diff --git a/docs/app/demo/github/components/ConversationPanel/ConversationPanel.css b/docs/app/demo/github/components/ConversationPanel/ConversationPanel.cssindex ec411e06f..a44b19d14 100644--- a/docs/app/demo/github/components/ConversationPanel/ConversationPanel.css+++ b/docs/app/demo/github/components/ConversationPanel/ConversationPanel.css@@ -125,71 +125,6 @@font-family: var(--openui-font-body);}-/* Tool call badges */-.conv-tools-badge {- padding: var(--openui-space-xs) var(--openui-space-s-m);- border-radius: var(--openui-radius-m);- margin-bottom: var(--openui-space-xs);- font-size: 11px;- font-family: var(--openui-font-body);-}--.conv-tools-runtime {- background: var(--openui-success-background);- border: 1px solid var(--openui-border-success);-}--.conv-tools-live {- background: var(--openui-highlight-subtle);- border: 1px solid var(--openui-border-default);-}--.conv-tools-label {- color: var(--openui-text-success-primary);- font-weight: 600;- margin-bottom: 3px;- display: flex;- align-items: center;- gap: var(--openui-space-2xs);-}--.conv-tools-label-text {- color: var(--openui-text-neutral-secondary);- font-weight: 600;- text-transform: uppercase;- letter-spacing: 0.5px;- font-size: 10px;-}--.conv-tools-list {- display: flex;- flex-wrap: wrap;- gap: 3px;- align-items: center;-}--.conv-tool-chip {- padding: 1px var(--openui-space-xs);- border-radius: var(--openui-radius-xs);- font-size: 10px;- font-family: var(--openui-font-code);-}--.conv-tool-done {- background: var(--openui-success-background);- color: var(--openui-text-success-primary);-}--.conv-tool-pending {- background: var(--openui-alert-background);- color: var(--openui-text-alert-primary);-}--.conv-tool-error {- background: var(--openui-danger-background);- color: var(--openui-text-danger-primary);-}-/* Code badge */.conv-code-badge {display: inline-flex;diff --git a/docs/app/demo/github/components/ConversationPanel/ConversationPanel.tsx b/docs/app/demo/github/components/ConversationPanel/ConversationPanel.tsxindex bc9578b40..75bba0f88 100644--- a/docs/app/demo/github/components/ConversationPanel/ConversationPanel.tsx+++ b/docs/app/demo/github/components/ConversationPanel/ConversationPanel.tsx@@ -3,7 +3,7 @@import { IconButton } from "@openuidev/react-ui";import { ChevronRight, MessageSquare, Send, Square } from "lucide-react";import { useEffect, useRef, useState } from "react";-import type { ChatMessage, ToolCallEntry } from "../../constants";+import type { ChatMessage } from "../../constants";import "./ConversationPanel.css";type ConversationPanelProps = {@@ -11,7 +11,6 @@ type ConversationPanelProps = {streamingText: string;isStreaming: boolean;elapsed: number | null;- toolCalls: ToolCallEntry[];onSend: (text: string) => void;onStop: () => void;hasDashboard: boolean;@@ -23,7 +22,6 @@ export function ConversationPanel({streamingText,isStreaming,elapsed,- toolCalls,onSend,onStop,hasDashboard,@@ -50,8 +48,6 @@ export function ConversationPanel({setInput("");};- const pendingTools = toolCalls.filter((t) => t.status === "pending");-if (collapsed) {return (<div className="conv-collapsed">@@ -83,23 +79,6 @@ export function ConversationPanel({<div className="conv-user-bubble">{msg.content}</div>) : (<div className="conv-assistant">- {/* Runtime tool call badges */}- {msg.runtimeTools && msg.runtimeTools.length > 0 && (- <div className="conv-tools-badge conv-tools-runtime">- <div className="conv-tools-label">- <span>⚡</span> Live data fetched- </div>- <div className="conv-tools-list">- {msg.runtimeTools.map((tc, j) => (- <span key={j} className={`conv-tool-chip conv-tool-${tc.status}`}>- {tc.status === "done" ? "✓" : tc.status === "error" ? "✗" : "⏳"}{" "}- {tc.tool}- </span>- ))}- </div>- </div>- )}-{/* Text response */}{msg.text && <div className="conv-assistant-bubble">{msg.text}</div>}@@ -107,9 +86,7 @@ export function ConversationPanel({{msg.hasCode && <span className="conv-code-badge">✓ dashboard updated</span>}{/* Empty response */}- {!msg.text && !msg.hasCode && !msg.runtimeTools?.length && (- <div className="conv-empty">(empty response)</div>- )}+ {!msg.text && !msg.hasCode && <div className="conv-empty">(empty response)</div>}</div>)}</div>@@ -119,29 +96,13 @@ export function ConversationPanel({{isStreaming && (<div className="conv-msg"><div className="conv-assistant">- {/* Live runtime tool calls */}- {toolCalls.length > 0 && (- <div className="conv-tools-badge conv-tools-live">- <div className="conv-tools-list">- <span className="conv-tools-label-text">- {pendingTools.length > 0 ? "Fetching" : "Loaded"}- </span>- {toolCalls.map((tc, j) => (- <span key={j} className={`conv-tool-chip conv-tool-${tc.status}`}>- {tc.status === "pending" ? "⏳" : "✓"} {tc.tool}- </span>- ))}- </div>- </div>- )}-{/* Streaming text or thinking indicator */}{streamingText ? (<div className="conv-assistant-bubble">{streamingText}</div>) : (<div className="conv-thinking">{elapsed- ? `${(elapsed / 1000).toFixed(1)}s — ${responseHasCode ? "writing code..." : "thinking..."}`+ ? `${(elapsed / 1000).toFixed(1)}s — ${responseHasCode ? "writing openui-lang..." : "thinking..."}`: "thinking..."}</div>)}diff --git a/docs/app/demo/github/components/GitHubConnect/GitHubConnect.css b/docs/app/demo/github/components/GitHubConnect/GitHubConnect.cssindex a768658dc..635378e7b 100644--- a/docs/app/demo/github/components/GitHubConnect/GitHubConnect.css+++ b/docs/app/demo/github/components/GitHubConnect/GitHubConnect.css@@ -128,7 +128,9 @@color: var(--openui-text-neutral-secondary);cursor: pointer;opacity: 0;- transition: opacity 0.15s ease, color 0.15s ease;+ transition:+ opacity 0.15s ease,+ color 0.15s ease;}.gh-inputWrap:hover .gh-inputClear,@@ -267,13 +269,20 @@box-shadow: var(--openui-shadow-s);cursor: pointer;text-align: left;- transition: transform 0.2s ease, border-color 0.2s ease, background-color 0.2s ease;+ transition:+ transform 0.2s ease,+ border-color 0.2s ease,+ background-color 0.2s ease;}.gh-choiceOption:hover,.gh-choiceOption-selected {transform: translateY(-1px);- border-color: color-mix(in srgb, var(--gh-tone-fill) 36%, var(--openui-border-interactive-emphasis));+ border-color: color-mix(+ in srgb,+ var(--gh-tone-fill) 36%,+ var(--openui-border-interactive-emphasis)+ );background: color-mix(in srgb, var(--gh-tone-bg) 54%, var(--openui-foreground));}@@ -408,19 +417,22 @@/* ── Tone tokens ── */-.gh-tone-green, .gh-tone-mint {+.gh-tone-green,+.gh-tone-mint {--gh-tone-fill: var(--openui-text-success-primary);--gh-tone-bg: var(--openui-success-background);--gh-tone-border: var(--openui-border-success);}-.gh-tone-purple, .gh-tone-violet {+.gh-tone-purple,+.gh-tone-violet {--gh-tone-fill: var(--openui-text-purple-primary);--gh-tone-bg: var(--openui-purple-background);--gh-tone-border: var(--openui-border-accent);}-.gh-tone-red, .gh-tone-rose {+.gh-tone-red,+.gh-tone-rose {--gh-tone-fill: var(--openui-text-danger-primary);--gh-tone-bg: var(--openui-danger-background);--gh-tone-border: var(--openui-border-danger);@@ -432,7 +444,8 @@--gh-tone-border: var(--openui-border-info);}-.gh-tone-amber, .gh-tone-peach {+.gh-tone-amber,+.gh-tone-peach {--gh-tone-fill: var(--openui-text-alert-primary);--gh-tone-bg: var(--openui-alert-background);--gh-tone-border: var(--openui-border-alert);@@ -441,7 +454,11 @@.gh-tone-pink {--gh-tone-fill: var(--openui-text-pink-primary);--gh-tone-bg: var(--openui-pink-background);- --gh-tone-border: color-mix(in srgb, var(--openui-text-pink-primary) 24%, var(--openui-border-default));+ --gh-tone-border: color-mix(+ in srgb,+ var(--openui-text-pink-primary) 24%,+ var(--openui-border-default)+ );}/* ── Visually hidden ── */@@ -461,8 +478,14 @@/* ── Animation ── */@keyframes gh-step-fade-in {- from { opacity: 0; transform: translateY(8px); }- to { opacity: 1; transform: translateY(0); }+ from {+ opacity: 0;+ transform: translateY(8px);+ }+ to {+ opacity: 1;+ transform: translateY(0);+ }}.gh-step-appear {@@ -503,7 +526,7 @@}.gh-actions {- margin-top:32px;+ margin-top: 32px;flex-wrap: wrap;align-items: flex-start;gap: var(--openui-space-l);diff --git a/docs/app/demo/github/components/GitHubConnect/GitHubConnect.tsx b/docs/app/demo/github/components/GitHubConnect/GitHubConnect.tsxindex b85b11ecd..6e891fa05 100644--- a/docs/app/demo/github/components/GitHubConnect/GitHubConnect.tsx+++ b/docs/app/demo/github/components/GitHubConnect/GitHubConnect.tsx@@ -48,8 +48,9 @@ const STARTER_ICON_MAP: Record<GitHubStarterIconKey, LucideIcon> = {const DEMO_USERS = [{ username: "torvalds", tone: "peach" },{ username: "yyx990803", tone: "mint" },- { username: "sindresorhus", tone: "violet" },+ { username: "rauchg", tone: "violet" },{ username: "gaearon", tone: "rose" },+ { username: "ctate", tone: "mint" },] as const satisfies ReadonlyArray<{ username: string; tone: DeveloperTone }>;const DEVELOPER_OPTIONS: PickerOption[] = DEMO_USERS.map((user) => ({@@ -184,9 +185,18 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {const validate = useCallback((name: string): boolean => {const trimmed = name.trim();- if (!trimmed) { setError("Enter a GitHub username"); return false; }- if (!/^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(trimmed)) { setError("Invalid username format"); return false; }- if (trimmed.length > 39) { setError("Username too long"); return false; }+ if (!trimmed) {+ setError("Enter a GitHub username");+ return false;+ }+ if (!/^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(trimmed)) {+ setError("Invalid username format");+ return false;+ }+ if (trimmed.length > 39) {+ setError("Username too long");+ return false;+ }setError("");return true;}, []);@@ -199,21 +209,42 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {}, []);const handleClearIdentity = useCallback(() => handleReset(), [handleReset]);- const handleClearSelectedFocus = useCallback(() => { setSelectedGithubPrompt(null); setError(""); }, []);- const handleClearTypedUsername = useCallback(() => { setUsername(""); setAvatarUrl(null); setError(""); focusInput(); }, [focusInput]);+ const handleClearSelectedFocus = useCallback(() => {+ setSelectedGithubPrompt(null);+ setError("");+ }, []);+ const handleClearTypedUsername = useCallback(() => {+ setUsername("");+ setAvatarUrl(null);+ setError("");+ focusInput();+ }, [focusInput]);const trimmedUsername = username.trim();const effectiveUsername = trimmedUsername || selectedDeveloperUsername || "";- const selectedDeveloperOption = DEVELOPER_OPTIONS.find((o) => o.value === selectedDeveloperUsername) ?? null;- const selectedFocusOption = FOCUS_AREA_OPTIONS.find((o) => o.value === selectedGithubPrompt) ?? null;- const selectedDeveloperLeading = selectedDeveloperOption ? renderOptionLeading(selectedDeveloperOption) : null;- const selectedFocusLeading = selectedFocusOption ? renderOptionLeading(selectedFocusOption) : null;- const hasValidUsername = effectiveUsername.length > 0 && effectiveUsername.length <= 39 && /^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(effectiveUsername);+ const selectedDeveloperOption =+ DEVELOPER_OPTIONS.find((o) => o.value === selectedDeveloperUsername) ?? null;+ const selectedFocusOption =+ FOCUS_AREA_OPTIONS.find((o) => o.value === selectedGithubPrompt) ?? null;+ const selectedDeveloperLeading = selectedDeveloperOption+ ? renderOptionLeading(selectedDeveloperOption)+ : null;+ const selectedFocusLeading = selectedFocusOption+ ? renderOptionLeading(selectedFocusOption)+ : null;+ const hasValidUsername =+ effectiveUsername.length > 0 &&+ effectiveUsername.length <= 39 &&+ /^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(effectiveUsername);const hasIdentitySelection = Boolean(effectiveUsername);- const isTypedIdentityLocked = Boolean(trimmedUsername && selectedGithubPrompt && hasValidUsername);+ const isTypedIdentityLocked = Boolean(+ trimmedUsername && selectedGithubPrompt && hasValidUsername,+ );const showDeveloperPicker = !selectedDeveloperOption && !trimmedUsername;const canStart = Boolean(selectedGithubPrompt) && hasValidUsername;- const canReset = Boolean(trimmedUsername || selectedDeveloperUsername || error || selectedGithubPrompt);+ const canReset = Boolean(+ trimmedUsername || selectedDeveloperUsername || error || selectedGithubPrompt,+ );const handleStartGenerating = async () => {if (!selectedGithubPrompt) return;@@ -221,9 +252,15 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {setValidating(true);try {const res = await fetch(`https://api.github.com/users/${effectiveUsername}`);- if (!res.ok) { setError("GitHub user not found"); setValidating(false); return; }+ if (!res.ok) {+ setError("GitHub user not found");+ setValidating(false);+ return;+ }} catch {- setError("Could not verify username"); setValidating(false); return;+ setError("Could not verify username");+ setValidating(false);+ return;}setValidating(false);onConnectAndPrompt(effectiveUsername, selectedGithubPrompt);@@ -238,9 +275,16 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {if (selectedDeveloperOption) {return (<span className={`gh-chip gh-tone-${selectedDeveloperOption.tone}`}>- {selectedDeveloperLeading && <span className="gh-chipLeading">{selectedDeveloperLeading}</span>}+ {selectedDeveloperLeading && (+ <span className="gh-chipLeading">{selectedDeveloperLeading}</span>+ )}<span className="gh-chipLabel">{selectedDeveloperOption.label}</span>- <button type="button" className="gh-chipClear" aria-label="Clear selected developer" onClick={handleClearIdentity}>+ <button+ type="button"+ className="gh-chipClear"+ aria-label="Clear selected developer"+ onClick={handleClearIdentity}+ ><X size={14} /></button></span>@@ -250,10 +294,19 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {return (<span className="gh-chip gh-chip-neutral"><span className="gh-chipLeading">- {avatarUrl ? <img src={avatarUrl} alt="" className="gh-chipAvatar" /> : <span className="gh-chipMonogram">@</span>}+ {avatarUrl ? (+ <img src={avatarUrl} alt="" className="gh-chipAvatar" />+ ) : (+ <span className="gh-chipMonogram">@</span>+ )}</span><span className="gh-chipLabel">@{effectiveUsername}</span>- <button type="button" className="gh-chipClear" aria-label="Clear username" onClick={handleClearIdentity}>+ <button+ type="button"+ className="gh-chipClear"+ aria-label="Clear username"+ onClick={handleClearIdentity}+ ><X size={14} /></button></span>@@ -270,14 +323,24 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {ref={inputRef}className="gh-inputField"value={username}- onChange={(e) => { setSelectedDeveloperUsername(null); setUsername(e.target.value); setAvatarUrl(null); setError(""); }}+ onChange={(e) => {+ setSelectedDeveloperUsername(null);+ setUsername(e.target.value);+ setAvatarUrl(null);+ setError("");+ }}placeholder="username"autoComplete="off"spellCheck={false}/></span>{trimmedUsername && (- <button type="button" className="gh-inputClear" aria-label="Clear" onClick={handleClearTypedUsername}>+ <button+ type="button"+ className="gh-inputClear"+ aria-label="Clear"+ onClick={handleClearTypedUsername}+ ><X size={14} /></button>)}@@ -289,7 +352,9 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {<div className="gh-connect"><form className="gh-builder" onSubmit={handleSubmit}><div className="gh-brand">- <span className="gh-brandIcon"><GitHubIcon /></span>+ <span className="gh-brandIcon">+ <GitHubIcon />+ </span><span className="gh-brandLabel">GitPulse</span></div>@@ -302,9 +367,16 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {that focuses on{" "}{selectedFocusOption ? (<span className={`gh-chip gh-chip-focus gh-tone-${selectedFocusOption.tone}`}>- {selectedFocusLeading && <span className="gh-chipLeading">{selectedFocusLeading}</span>}+ {selectedFocusLeading && (+ <span className="gh-chipLeading">{selectedFocusLeading}</span>+ )}<span className="gh-chipLabel">{selectedFocusOption.label}</span>- <button type="button" className="gh-chipClear" aria-label="Clear topic" onClick={handleClearSelectedFocus}>+ <button+ type="button"+ className="gh-chipClear"+ aria-label="Clear topic"+ onClick={handleClearSelectedFocus}+ ><X size={14} /></button></span>@@ -335,7 +407,10 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {ariaLabel="Select a focus area"options={FOCUS_AREA_OPTIONS}value={selectedGithubPrompt}- onChange={(v) => { setSelectedGithubPrompt(v); setError(""); }}+ onChange={(v) => {+ setSelectedGithubPrompt(v);+ setError("");+ }}className="gh-choiceList-focus"/></div>@@ -345,10 +420,20 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {{hasIdentitySelection && selectedGithubPrompt && (<div className="gh-actions gh-step-appear">- <Button className="gh-cta" size="large" type="submit" disabled={!canStart || validating}>+ <Button+ className="gh-cta"+ size="large"+ type="submit"+ disabled={!canStart || validating}+ >{validating ? "Verifying..." : "Let's go"}</Button>- <button type="button" className="gh-startOver" onClick={handleReset} disabled={!canReset}>+ <button+ type="button"+ className="gh-startOver"+ onClick={handleReset}+ disabled={!canReset}+ >Start over</button></div>diff --git a/docs/app/demo/github/constants.ts b/docs/app/demo/github/constants.tsindex 12a992833..be314962b 100644--- a/docs/app/demo/github/constants.ts+++ b/docs/app/demo/github/constants.ts@@ -1,6 +1,9 @@export type Theme = "system" | "light" | "dark";export type Status = "idle" | "streaming" | "done" | "error";+export const GITHUB_DEMO_MODEL = "openai/gpt-5.4-mini";+export const GITHUB_DEMO_MODEL_LABEL = "GPT-5.4 Mini";+export type GitHubStarterIconKey =| "commit-activity"| "pull-requests"@@ -75,5 +78,4 @@ export interface ChatMessage {content: string;text?: string;hasCode: boolean;- runtimeTools?: ToolCallEntry[];}diff --git a/docs/app/demo/github/github/prompt-config.ts b/docs/app/demo/github/github/prompt-config.tsindex d30f3b988..d943323be 100644--- a/docs/app/demo/github/github/prompt-config.ts+++ b/docs/app/demo/github/github/prompt-config.ts@@ -82,4 +82,5 @@ export const GITHUB_ADDITIONAL_RULES: string[] = ["Use PieChart for language breakdowns (donut variant), BarChart for comparisons, LineChart for trends over time","Rate limit: 60 req/hr per visitor. Prefer get_repos (1 API call) over per-repo endpoints (get_commit_activity, get_star_history, get_contributors)","Per-repo tools (get_commit_activity, get_star_history, get_contributors) are expensive — only use when the user specifically asks about a specific repo",+ "NEVER use Image() or ImageBlock() components — no external image URLs are available. Use TextContent, Tag, or emoji for visual accents instead.",];diff --git a/docs/app/demo/github/github/tools.ts b/docs/app/demo/github/github/tools.tsindex 009859a62..e22485261 100644--- a/docs/app/demo/github/github/tools.ts+++ b/docs/app/demo/github/github/tools.ts@@ -37,6 +37,46 @@ export function clearCache() {cache.clear();}+/**+ * Prefetch core GitHub data and return a compact summary for LLM context.+ * Also warms the cache so Query() nodes resolve instantly on first render.+ */+export async function prefetchAndSummarize(+ tools: Record<string, (args: Record<string, unknown>) => Promise<unknown>>,+): Promise<string> {+ const [profile, repos, languages, events] = await Promise.all([+ tools.get_profile({}),+ tools.get_repos({ sort: "stars" }),+ tools.get_languages({}),+ tools.get_events({}),+ ]);++ const p = profile as Record<string, unknown>;+ const repoRows = ((repos as Record<string, unknown>).rows ?? []) as Array<+ Record<string, unknown>+ >;+ const langRows = ((languages as Record<string, unknown>).rows ?? []) as Array<+ Record<string, unknown>+ >;+ const ev = ((events as Record<string, unknown>).summary ?? {}) as Record<string, number>;++ const topRepos = repoRows+ .slice(0, 8)+ .map((r) => `${r.name} (${r.stars}★, ${r.language || "unknown"})`)+ .join(", ");+ const topLangs = langRows+ .slice(0, 6)+ .map((l) => l.language)+ .join(", ");++ return `<github-data>+Profile: ${p.name || p.login}, ${p.public_repos} public repos, ${p.followers} followers, joined ${p.created_at}+Top repos by stars: ${topRepos || "none found"}+Languages: ${topLangs || "none detected"}+Recent activity (last 90 days): ${ev.total || 0} events (${ev.push || 0} pushes, ${ev.pr || 0} PRs, ${ev.issues || 0} issues, ${ev.reviews || 0} reviews)+</github-data>`;+}+// ── Rate limit tracking ────────────────────────────────────────────────────let rateLimitRemaining = 60;diff --git a/docs/app/demo/github/layout.css b/docs/app/demo/github/layout.cssindex f6e452c03..07362f805 100644--- a/docs/app/demo/github/layout.css+++ b/docs/app/demo/github/layout.css@@ -431,6 +431,17 @@align-items: center;}+.dashboard-model-label {+ padding: 2px var(--openui-space-s);+ border-radius: var(--openui-radius-full);+ background: var(--openui-highlight-subtle);+ border: 1px solid var(--openui-border-default);+ font-size: 11px;+ font-weight: 500;+ font-family: var(--openui-font-code);+ color: var(--openui-text-neutral-secondary);+}+.dashboard-elapsed {font-family: var(--openui-font-code);}@@ -459,21 +470,179 @@color: var(--openui-text-neutral-primary);}-.dashboard-source {- background: var(--playground-code-background);- color: var(--playground-code-foreground);- padding: var(--openui-space-m);+/* Token saving badge */+.dashboard-token-saving {+ display: inline-flex;+ align-items: center;+ gap: 3px;+ padding: 2px var(--openui-space-s);+ border-radius: var(--openui-radius-full);+ background: var(--openui-success-background);+ color: var(--openui-text-success-primary);+ font-size: 11px;+ font-weight: 600;+ font-family: var(--openui-font-body);+}++/* Source panel with tabs */+.dashboard-source-panel {+ margin-bottom: var(--openui-space-m);border: 1px solid var(--openui-border-default);border-radius: var(--openui-radius-m);+ overflow: hidden;+}++.dashboard-source-header {+ display: flex;+ align-items: center;+ justify-content: space-between;+ background: var(--openui-highlight-subtle);+ border-bottom: 1px solid var(--openui-border-default);+ padding-right: var(--openui-space-s);+}++.dashboard-source-tabs {+ display: flex;+ gap: 0;+}++.dashboard-source-tab {+ display: flex;+ align-items: center;+ gap: var(--openui-space-xs);+ padding: var(--openui-space-s) var(--openui-space-m);+ background: transparent;+ border: none;+ border-bottom: 2px solid transparent;+ color: var(--openui-text-neutral-tertiary);+ font-size: 11px;+ font-weight: 600;+ font-family: var(--openui-font-body);+ cursor: pointer;+ transition:+ color 0.15s,+ border-color 0.15s;+}++.dashboard-source-tab:hover {+ color: var(--openui-text-neutral-secondary);+}++.dashboard-source-tab-active {+ color: var(--openui-text-neutral-primary);+ border-bottom-color: var(--openui-border-accent-emphasis);+}++.dashboard-source-token-count {+ padding: 1px 6px;+ border-radius: var(--openui-radius-full);+ background: var(--openui-highlight);+ color: var(--openui-text-neutral-secondary);+ font-size: 10px;+ font-weight: 600;+ font-family: var(--openui-font-code);+}++.dashboard-source-copy {+ display: flex;+ align-items: center;+ justify-content: center;+ width: 28px;+ height: 28px;+ background: transparent;+ border: none;+ border-radius: var(--openui-radius-s);+ color: var(--openui-text-neutral-tertiary);+ cursor: pointer;+ transition:+ background-color 0.15s,+ color 0.15s;+ flex-shrink: 0;+}++.dashboard-source-copy:hover {+ background: var(--openui-highlight);+ color: var(--openui-text-neutral-primary);+}++.dashboard-source-panel .dashboard-source {+ border: none;+ border-radius: 0;+ margin-bottom: 0;+}++.dashboard-source {+ background: var(--openui-sunk);+ padding: var(--openui-space-m);font-size: 11px;font-family: var(--openui-font-code);overflow: auto;white-space: pre-wrap;max-height: 250px;- line-height: 1.4;+ line-height: 1.6;margin-bottom: var(--openui-space-m);}+/* Live data indicator strip */+.dashboard-data-strip {+ display: flex;+ align-items: center;+ gap: var(--openui-space-s);+ padding: var(--openui-space-xs) var(--openui-space-m);+ margin-bottom: var(--openui-space-s);+ border: 1px solid var(--openui-border-success);+ border-radius: var(--openui-radius-m);+ background: var(--openui-success-background);+ font-size: 11px;+ font-family: var(--openui-font-body);+ transition:+ border-color 0.2s,+ background-color 0.2s;+}++.dashboard-data-strip-loading {+ border-color: var(--openui-border-alert);+ background: var(--openui-alert-background);+}++.dashboard-data-label {+ color: var(--openui-text-success-primary);+ font-weight: 600;+ white-space: nowrap;+}++.dashboard-data-strip-loading .dashboard-data-label {+ color: var(--openui-text-alert-primary);+}++.dashboard-data-chips {+ display: flex;+ flex-wrap: wrap;+ gap: 3px;+}++.dashboard-data-chip {+ padding: 1px var(--openui-space-xs);+ border-radius: var(--openui-radius-xs);+ font-size: 10px;+ font-family: var(--openui-font-code);+}++.dashboard-data-chip-done {+ background: var(--openui-success-background);+ color: var(--openui-text-success-primary);+}++.dashboard-data-chip-pending {+ background: var(--openui-alert-background);+ color: var(--openui-text-alert-primary);+}++.dashboard-data-chip-error {+ background: var(--openui-danger-background);+ color: var(--openui-text-danger-primary);+}+.dashboard-loading {display: flex;flex-direction: column;diff --git a/docs/app/demo/github/page.tsx b/docs/app/demo/github/page.tsxindex a6ed51f82..58268affa 100644--- a/docs/app/demo/github/page.tsx+++ b/docs/app/demo/github/page.tsx@@ -2,22 +2,28 @@import { mergeStatements } from "@openuidev/react-lang";import { Button } from "@openuidev/react-ui";+import { encode } from "gpt-tokenizer";import {Activity,+ Check,CircleDot,Code2,+ Copy,GitPullRequest,Hexagon,Search,+ Zap,type LucideIcon,} from "lucide-react";import { useTheme } from "next-themes";+import { Highlight, themes } from "prism-react-renderer";import { useCallback, useEffect, useMemo, useRef, useState } from "react";import { ConversationPanel } from "./components/ConversationPanel/ConversationPanel";import { GitHubConnect } from "./components/GitHubConnect/GitHubConnect";import { Header } from "./components/Header/Header";import { PreviewPanel } from "./components/PreviewPanel/PreviewPanel";import {+ GITHUB_DEMO_MODEL_LABEL,GITHUB_STARTERS,type ChatMessage,type GitHubStarterIconKey,@@ -25,7 +31,7 @@ import {type Theme,type ToolCallEntry,} from "./constants";-import { clearCache, createGitHubToolProvider } from "./github/tools";+import { clearCache, createGitHubToolProvider, prefetchAndSummarize } from "./github/tools";// ── Helpers ─────────────────────────────────────────────────────────────────@@ -90,8 +96,11 @@ type ToolCallListener = (calls: ToolCallEntry[]) => void;function wrapToolProvider(inner: Record<string, (args: Record<string, unknown>) => Promise<unknown>>,listener: ToolCallListener,-): Record<string, (args: Record<string, unknown>) => Promise<unknown>> {- const activeCalls: ToolCallEntry[] = [];+): {+ tools: Record<string, (args: Record<string, unknown>) => Promise<unknown>>;+ resetCalls: () => void;+} {+ let activeCalls: ToolCallEntry[] = [];const wrapped: Record<string, (args: Record<string, unknown>) => Promise<unknown>> = {};for (const [name, fn] of Object.entries(inner)) {@@ -112,7 +121,12 @@ function wrapToolProvider(};}- return wrapped;+ return {+ tools: wrapped,+ resetCalls: () => {+ activeCalls = [];+ },+ };}// ── SSE streaming ────────────────────────────────────────────────────────@@ -193,7 +207,9 @@ export default function GitHubDemoPage() {// Dashboard stateconst [dashboardCode, setDashboardCode] = useState<string | null>(null);const [showSource, setShowSource] = useState(false);+ const [sourceTab, setSourceTab] = useState<"raw" | "json">("raw");const [parsedJson, setParsedJson] = useState<string | null>(null);+ const [codeCopied, setCodeCopied] = useState(false);// Conversationconst [conversation, setConversation] = useState<ChatMessage[]>([]);@@ -216,6 +232,17 @@ export default function GitHubDemoPage() {const isGitHub = githubUsername !== null;const isHomeState = !isGitHub && !hasDashboard && conversation.length === 0;+ // Token comparison+ const rawTokens = useMemo(+ () => (dashboardCode ? encode(dashboardCode).length : 0),+ [dashboardCode],+ );+ const jsonTokens = useMemo(() => (parsedJson ? encode(parsedJson).length : 0), [parsedJson]);+ const tokenSavingPct =+ status === "done" && rawTokens > 0 && jsonTokens > 0 && rawTokens < jsonTokens+ ? Math.round(((jsonTokens - rawTokens) / jsonTokens) * 100)+ : null;+// Themeconst currentTheme = useMemo<Theme>(() => {if (theme === "light" || theme === "dark" || theme === "system") {@@ -238,17 +265,19 @@ export default function GitHubDemoPage() {// ── GitHub connect ───────────────────────────────────────────────────+ const rawToolsRef = useRef<Record<+ string,+ (args: Record<string, unknown>) => Promise<unknown>+ > | null>(null);+ const resetToolCallsRef = useRef<(() => void) | null>(null);+const handleConnect = useCallback((username: string) => {const rawTools = createGitHubToolProvider(username);- const wrapped = wrapToolProvider(rawTools, (calls) => {+ rawToolsRef.current = rawTools;+ const { tools: wrapped, resetCalls } = wrapToolProvider(rawTools, (calls) => {setToolCalls([...calls]);- setConversation((prev) => {- if (prev.length === 0) return prev;- const last = prev[prev.length - 1];- if (last.role !== "assistant") return prev;- return [...prev.slice(0, -1), { ...last, runtimeTools: [...calls] }];- });});+ resetToolCallsRef.current = resetCalls;setGithubUsername(username);setToolProvider(wrapped);}, []);@@ -285,6 +314,7 @@ export default function GitHubDemoPage() {responseRef.current = "";setStreamingText("");setToolCalls([]);+ resetToolCallsRef.current?.();setStreamResponseHasCode(false);let streamStartTime: number | null = null;@@ -308,13 +338,24 @@ export default function GitHubDemoPage() {return { role: m.role, content: m.content };});+ // Prefetch GitHub data on first message to warm cache + give LLM context+ // Use raw (unwrapped) tools to avoid triggering tool-call tracking side effects+ let githubContext = "";+ if (conversation.length === 0 && rawToolsRef.current) {+ try {+ githubContext = await prefetchAndSummarize(rawToolsRef.current);+ } catch {+ // Non-critical — LLM just won't have data context+ }+ }+const controller = new AbortController();abortRef.current = controller;try {await streamChat({- prompt: trimmed,+ prompt: githubContext ? `${githubContext}\n\n${trimmed}` : trimmed,messages: apiMessages.slice(0, -1),},(chunk) => {@@ -345,7 +386,6 @@ export default function GitHubDemoPage() {content: raw,text,hasCode,- runtimeTools: toolCalls.length > 0 ? [...toolCalls] : undefined,};setConversation((prev) => [...prev, assistantMsg]);@@ -374,7 +414,7 @@ export default function GitHubDemoPage() {setStatus("error");}},- [isStreaming, conversation, dashboardCode, toolCalls],+ [isStreaming, conversation, dashboardCode],);// Process pending prompt after GitHub connect@@ -425,26 +465,6 @@ export default function GitHubDemoPage() {<div className="artifact-layout">{/* Left: Dashboard */}<div className="dashboard-area">- {/* Connected user bar */}- {isGitHub && (hasDashboard || conversation.length > 0) && (- <div className="gh-connected-bar">- <img- src={`https://github.com/${githubUsername}.png?size=32`}- alt=""- className="gh-connected-avatar"- />- <span>@{githubUsername}</span>- <Button- className="gh-connected-change"- variant="tertiary"- size="extra-small"- onClick={handleDisconnect}- >- Change- </Button>- </div>- )}-{/* GitHub starters (before first generation) */}{isGitHub && !hasDashboard && conversation.length === 0 && (<div className="gh-starters-welcome">@@ -468,7 +488,9 @@ export default function GitHubDemoPage() {onClick={() => send(s.prompt)}disabled={isStreaming}>- <span className={`gh-starter-icon gh-tone-${s.tone}`}>{renderStarterIcon(s.icon)}</span>+ <span className={`gh-starter-icon gh-tone-${s.tone}`}>+ {renderStarterIcon(s.icon)}+ </span><div className="gh-starter-label">{s.label}</div><div className="gh-starter-desc">{s.prompt.length > 60 ? s.prompt.slice(0, 60) + "..." : s.prompt}@@ -479,12 +501,19 @@ export default function GitHubDemoPage() {</div>)}- {/* Meta + source toggle */}+ {/* Meta + source toggle + token comparison */}{hasDashboard && !isStreaming && (<div className="dashboard-meta">+ <span className="dashboard-model-label">{GITHUB_DEMO_MODEL_LABEL}</span>{elapsed && (<span className="dashboard-elapsed">{(elapsed / 1000).toFixed(1)}s</span>)}+ {tokenSavingPct !== null && (+ <span className="dashboard-token-saving">+ <Zap size={10} />+ {tokenSavingPct}% fewer tokens+ </span>+ )}<ButtonclassName="dashboard-source-toggle"variant="tertiary"@@ -497,9 +526,130 @@ export default function GitHubDemoPage() {</div>)}- {/* Source code view */}- {hasDashboard && showSource && (- <pre className="dashboard-source">{dashboardCode}</pre>+ {/* Source code view with tabs */}+ {hasDashboard &&+ showSource &&+ (() => {+ const activeSource =+ sourceTab === "raw"+ ? (dashboardCode ?? "")+ : (parsedJson ?? "Waiting for parse...");+ const handleCopy = async () => {+ await navigator.clipboard.writeText(activeSource);+ setCodeCopied(true);+ setTimeout(() => setCodeCopied(false), 2000);+ };+ return (+ <div className="dashboard-source-panel">+ <div className="dashboard-source-header">+ <div className="dashboard-source-tabs">+ <button+ className={`dashboard-source-tab ${sourceTab === "raw" ? "dashboard-source-tab-active" : ""}`}+ onClick={() => {+ setSourceTab("raw");+ setCodeCopied(false);+ }}+ >+ openui-lang+ {rawTokens > 0 && (+ <span className="dashboard-source-token-count">+ {rawTokens.toLocaleString()}+ </span>+ )}+ </button>+ <button+ className={`dashboard-source-tab ${sourceTab === "json" ? "dashboard-source-tab-active" : ""}`}+ onClick={() => {+ setSourceTab("json");+ setCodeCopied(false);+ }}+ >+ Parsed JSON+ {jsonTokens > 0 && (+ <span className="dashboard-source-token-count">+ {jsonTokens.toLocaleString()}+ </span>+ )}+ </button>+ </div>+ <button+ className="dashboard-source-copy"+ onClick={handleCopy}+ title="Copy code"+ >+ {codeCopied ? <Check size={14} /> : <Copy size={14} />}+ </button>+ </div>+ <div className="dashboard-source">+ <Highlight+ theme={resolvedMode === "dark" ? themes.oneDark : themes.oneLight}+ code={activeSource.trim()}+ language={sourceTab === "json" ? "json" : "javascript"}+ >+ {({ className, style, tokens, getLineProps, getTokenProps }) => (+ <pre+ className={className}+ style={{ ...style, margin: 0, background: "transparent" }}+ >+ <code>+ {tokens.map((line, i) => (+ <div key={i} {...getLineProps({ line })}>+ {line.map((token, j) => (+ <span key={j} {...getTokenProps({ token })} />+ ))}+ </div>+ ))}+ </code>+ </pre>+ )}+ </Highlight>+ </div>+ </div>+ );+ })()}++ {/* Connected user bar */}+ {isGitHub && (hasDashboard || conversation.length > 0) && (+ <div className="gh-connected-bar">+ <img+ src={`https://github.com/${githubUsername}.png?size=32`}+ alt=""+ className="gh-connected-avatar"+ />+ <span>@{githubUsername}</span>+ <Button+ className="gh-connected-change"+ variant="tertiary"+ size="extra-small"+ onClick={handleDisconnect}+ >+ Change+ </Button>+ </div>+ )}++ {/* Live data indicator */}+ {hasDashboard && toolCalls.length > 0 && (+ <div+ className={`dashboard-data-strip ${toolCalls.some((t) => t.status === "pending") ? "dashboard-data-strip-loading" : ""}`}+ >+ <span className="dashboard-data-label">+ {toolCalls.some((t) => t.status === "pending")+ ? "Fetching live data..."+ : "Live data from GitHub"}+ </span>+ <div className="dashboard-data-chips">+ {toolCalls.map((tc, i) => (+ <span+ key={i}+ className={`dashboard-data-chip dashboard-data-chip-${tc.status}`}+ >+ {tc.status === "done" ? "✓" : tc.status === "error" ? "✗" : "⏳"}{" "}+ {tc.tool.replace("get_", "")}+ </span>+ ))}+ </div>+ </div>)}{/* Dashboard renderer */}@@ -542,7 +692,6 @@ export default function GitHubDemoPage() {streamingText={streamingText}isStreaming={isStreaming}elapsed={elapsed}- toolCalls={toolCalls}onSend={send}onStop={handleStop}hasDashboard={hasDashboard}diff --git a/docs/app/playground/layout.css b/docs/app/playground/layout.cssindex f4e298d8b..21927ee20 100644--- a/docs/app/playground/layout.css+++ b/docs/app/playground/layout.css@@ -58,7 +58,11 @@--scrollbar-thumb: var(--openui-text-neutral-tertiary);--font-sans: var(--openui-font-body);--font-mono: var(--openui-font-code);- --playground-focus-ring: color-mix(in srgb, var(--openui-border-accent-emphasis) 24%, transparent);+ --playground-focus-ring: color-mix(+ in srgb,+ var(--openui-border-accent-emphasis) 24%,+ transparent+ );--playground-success-tint: color-mix(in srgb, var(--openui-success-background) 16%, transparent);--playground-success-border: color-mix(in srgb,diff --git a/docs/components/site-marketing-header.tsx b/docs/components/site-marketing-header.tsxindex 665ad2a51..e873b338a 100644--- a/docs/components/site-marketing-header.tsx+++ b/docs/components/site-marketing-header.tsx@@ -3,9 +3,9 @@import {GitHubIcon,GitHubStarButton,- type LogoVariant,StarCountBadge,useGitHubStarCount,+ type LogoVariant,} from "@/components/brand-logo";import { SiteHeaderFrame } from "@/components/site-header";import { PRIMARY_SITE_NAV_ITEMS, SitePrimaryNav } from "@/components/site-primary-nav";diff --git a/docs/content/docs/openui-lang/renderer.mdx b/docs/content/docs/openui-lang/renderer.mdxindex 28fa0b439..2942b8cfe 100644--- a/docs/content/docs/openui-lang/renderer.mdx+++ b/docs/content/docs/openui-lang/renderer.mdx@@ -89,18 +89,18 @@ These examples are simplified for demonstration. In production, you'll need to hError codes:-| Code | Source | Description |-| :------------------ | :------------- | :----------------------------------------------------------------------- |-| `unknown-component` | parser | Component name not in the library |-| `missing-required` | parser | Required prop not provided |-| `null-required` | parser | Required prop explicitly null |-| `excess-args` | parser | More positional args than schema params (extras dropped, still renders) |-| `inline-reserved` | parser | Query/Mutation used inline instead of top-level |-| `parse-failed` | parser | Response produced no renderable root |-| `parse-exception` | parser | Parser crashed on malformed input |-| `tool-not-found` | query/mutation | Tool name not found in toolProvider |-| `runtime-error` | runtime | Expression evaluation failed on a prop |-| `render-error` | runtime | React component threw during render |+| Code | Source | Description |+| :------------------ | :------------- | :---------------------------------------------------------------------- |+| `unknown-component` | parser | Component name not in the library |+| `missing-required` | parser | Required prop not provided |+| `null-required` | parser | Required prop explicitly null |+| `excess-args` | parser | More positional args than schema params (extras dropped, still renders) |+| `inline-reserved` | parser | Query/Mutation used inline instead of top-level |+| `parse-failed` | parser | Response produced no renderable root |+| `parse-exception` | parser | Parser crashed on malformed input |+| `tool-not-found` | query/mutation | Tool name not found in toolProvider |+| `runtime-error` | runtime | Expression evaluation failed on a prop |+| `render-error` | runtime | React component threw during render |If no `onError` callback is provided, errors are logged to `console.warn` instead of being silently swallowed.diff --git a/docs/content/docs/openui-lang/system-prompts.mdx b/docs/content/docs/openui-lang/system-prompts.mdxindex 757612738..e2253eb3b 100644--- a/docs/content/docs/openui-lang/system-prompts.mdx+++ b/docs/content/docs/openui-lang/system-prompts.mdx@@ -66,8 +66,8 @@ const systemPrompt = generatePrompt({| Flag | What it enables | Default || ------------ | ----------------------------------------------------------------------------- | ----------------------------- |-| `toolCalls` | `Query()`, `Mutation()`, `@Run`, built-in functions, tool workflow rules | `true` if `tools` provided |-| `bindings` | `$variables`, `@Set`, `@Reset`, built-in functions, reactive filters | `true` if `toolCalls` is true |+| `toolCalls` | `Query()`, `Mutation()`, `@Run`, built-in functions, tool workflow rules | `true` if `tools` provided |+| `bindings` | `$variables`, `@Set`, `@Reset`, built-in functions, reactive filters | `true` if `toolCalls` is true || `editMode` | Incremental editing - LLM outputs only changed statements | `false` || `inlineMode` | Text + fenced code responses - LLM can answer questions without generating UI | `false` |diff --git a/docs/generated/chat-system-prompt.txt b/docs/generated/chat-system-prompt.txtindex 1cff93aac..af8c67770 100644--- a/docs/generated/chat-system-prompt.txt+++ b/docs/generated/chat-system-prompt.txt@@ -117,34 +117,6 @@ Tag(text: string, icon?: string, size?: "sm" | "md" | "lg", variant?: "neutral"### OtherCard(children: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | Steps | ListBlock | FollowUpBlock | SectionBlock | Tabs | Carousel)[]) — Vertical container for all content in a chat response. Children stack top to bottom automatically.-## Built-in Functions--Data functions prefixed with `@` to distinguish from components. These are the ONLY functions available — do NOT invent new ones.-Use @-prefixed built-in functions (@Count, @Sum, @Avg, @Min, @Max, @Round) on Query results — do NOT hardcode computed values.--@Count(array) → number — Returns array length-@First(array) → element — Returns first element of array-@Last(array) → element — Returns last element of array-@Sum(numbers[]) → number — Sum of numeric array-@Avg(numbers[]) → number — Average of numeric array-@Min(numbers[]) → number — Minimum value in array-@Max(numbers[]) → number — Maximum value in array-@Sort(array, field, direction?) → sorted array — Sort array by field. Direction: "asc" (default) or "desc"-@Filter(array, field, operator: "==" | "!=" | ">" | "<" | ">=" | "<=" | "contains", value) → filtered array — Filter array by field value-@Round(number, decimals?) → number — Round to N decimal places (default 0)-@Abs(number) → number — Absolute value-@Floor(number) → number — Round down to nearest integer-@Ceil(number) → number — Round up to nearest integer-@Each(array, varName, template) — Evaluate template for each element. varName is the loop variable — use it ONLY inside the template expression (inline). Do NOT create a separate statement for the template.--Builtins compose — output of one is input to the next:-`@Count(@Filter(data.rows, "field", "==", "val"))` for KPIs/chart values, `@Round(@Avg(data.rows.score), 1)`, `@Each(data.rows, "item", Comp(item.field))` for per-item rendering.-Array pluck: `data.rows.field` extracts a field from every row → use with @Sum, @Avg, charts, tables.--IMPORTANT @Each rule: The loop variable (e.g. "item") is ONLY available inside the @Each template expression. Always inline the template — do NOT extract it to a separate statement.-CORRECT: `Col("Actions", @Each(rows, "t", Button("Edit", Action([@Set($id, t.id)]))))`-WRONG: `myBtn = Button("Edit", Action([@Set($id, t.id)]))` then `Col("Actions", @Each(rows, "t", myBtn))` — t is undefined in myBtn.-## Action — Button BehaviorAction([@steps...]) wires button clicks to operations. Steps are @-prefixed built-in actions. Steps execute in order.@@ -169,10 +141,8 @@ During streaming, the output is re-parsed on every chunk. Undefined references a**Recommended statement order for optimal streaming:**1. `root = Card(...)` — UI shell appears immediately-2. $variable declarations — state ready for bindings-3. Query statements — defaults resolve immediately so components render with data-4. Component definitions — fill in with data already available-5. Data values — leaf content last+2. Component definitions — fill in as they stream+3. Data values — leaf content lastAlways write the root = Card(...) statement first so the UI shell appears immediately, even before child data has streamed in.diff --git a/docs/generated/playground-component-spec.json b/docs/generated/playground-component-spec.jsonindex c10423427..d36586a0b 100644--- a/docs/generated/playground-component-spec.json+++ b/docs/generated/playground-component-spec.json@@ -265,10 +265,7 @@},{"name": "Tables",- "components": [- "Table",- "Col"- ],+ "components": ["Table", "Col"],"notes": ["- Table is COLUMN-oriented: Table([Col(\"Label\", dataArray), Col(\"Count\", countArray, \"number\")]). Use array pluck for data: data.rows.fieldName","- Col data can be component arrays for styled cells: Col(\"Status\", @Each(data.rows, \"item\", Tag(item.status, null, \"sm\", item.status == \"open\" ? \"success\" : \"danger\")))",@@ -298,12 +295,7 @@},{"name": "Charts (1D)",- "components": [- "PieChart",- "RadialChart",- "SingleStackedBarChart",- "Slice"- ],+ "components": ["PieChart", "RadialChart", "SingleStackedBarChart", "Slice"],"notes": ["- PieChart and BarChart need NUMBERS, not objects. For list data, use @Count(@Filter(...)) to aggregate:","- PieChart from list: `PieChart([\"Low\", \"Med\", \"High\"], [@Count(@Filter(data.rows, \"priority\", \"==\", \"low\")), @Count(@Filter(data.rows, \"priority\", \"==\", \"medium\")), @Count(@Filter(data.rows, \"priority\", \"==\", \"high\"))], \"donut\")`",@@ -312,11 +304,7 @@},{"name": "Charts (Scatter)",- "components": [- "ScatterChart",- "ScatterSeries",- "Point"- ]+ "components": ["ScatterChart", "ScatterSeries", "Point"]},{"name": "Forms",@@ -350,20 +338,14 @@},{"name": "Buttons",- "components": [- "Button",- "Buttons"- ],+ "components": ["Button", "Buttons"],"notes": ["- Toggle in @Each: @Each(rows, \"t\", Button(t.status == \"open\" ? \"Close\" : \"Reopen\", Action([...])))"]},{"name": "Data Display",- "components": [- "TagBlock",- "Tag"- ],+ "components": ["TagBlock", "Tag"],"notes": ["- Color-mapped Tag: Tag(value, null, \"sm\", value == \"high\" ? \"danger\" : value == \"medium\" ? \"warning\" : \"neutral\")"]diff --git a/docs/generated/playground-system-prompt.txt b/docs/generated/playground-system-prompt.txtindex 2e87a5674..ba91045c0 100644--- a/docs/generated/playground-system-prompt.txt+++ b/docs/generated/playground-system-prompt.txt@@ -123,34 +123,6 @@ TagBlock(tags: string[]) — tags is an array of stringsTag(text: string, icon?: string, size?: "sm" | "md" | "lg", variant?: "neutral" | "info" | "success" | "warning" | "danger") — Styled tag/badge with optional icon and variant- Color-mapped Tag: Tag(value, null, "sm", value == "high" ? "danger" : value == "medium" ? "warning" : "neutral")-## Built-in Functions--Data functions prefixed with `@` to distinguish from components. These are the ONLY functions available — do NOT invent new ones.-Use @-prefixed built-in functions (@Count, @Sum, @Avg, @Min, @Max, @Round) on Query results — do NOT hardcode computed values.--@Count(array) → number — Returns array length-@First(array) → element — Returns first element of array-@Last(array) → element — Returns last element of array-@Sum(numbers[]) → number — Sum of numeric array-@Avg(numbers[]) → number — Average of numeric array-@Min(numbers[]) → number — Minimum value in array-@Max(numbers[]) → number — Maximum value in array-@Sort(array, field, direction?) → sorted array — Sort array by field. Direction: "asc" (default) or "desc"-@Filter(array, field, operator: "==" | "!=" | ">" | "<" | ">=" | "<=" | "contains", value) → filtered array — Filter array by field value-@Round(number, decimals?) → number — Round to N decimal places (default 0)-@Abs(number) → number — Absolute value-@Floor(number) → number — Round down to nearest integer-@Ceil(number) → number — Round up to nearest integer-@Each(array, varName, template) — Evaluate template for each element. varName is the loop variable — use it ONLY inside the template expression (inline). Do NOT create a separate statement for the template.--Builtins compose — output of one is input to the next:-`@Count(@Filter(data.rows, "field", "==", "val"))` for KPIs/chart values, `@Round(@Avg(data.rows.score), 1)`, `@Each(data.rows, "item", Comp(item.field))` for per-item rendering.-Array pluck: `data.rows.field` extracts a field from every row → use with @Sum, @Avg, charts, tables.--IMPORTANT @Each rule: The loop variable (e.g. "item") is ONLY available inside the @Each template expression. Always inline the template — do NOT extract it to a separate statement.-CORRECT: `Col("Actions", @Each(rows, "t", Button("Edit", Action([@Set($id, t.id)]))))`-WRONG: `myBtn = Button("Edit", Action([@Set($id, t.id)]))` then `Col("Actions", @Each(rows, "t", myBtn))` — t is undefined in myBtn.-## Action — Button BehaviorAction([@steps...]) wires button clicks to operations. Steps are @-prefixed built-in actions. Steps execute in order.@@ -175,10 +147,8 @@ During streaming, the output is re-parsed on every chunk. Undefined references a**Recommended statement order for optimal streaming:**1. `root = Stack(...)` — UI shell appears immediately-2. $variable declarations — state ready for bindings-3. Query statements — defaults resolve immediately so components render with data-4. Component definitions — fill in with data already available-5. Data values — leaf content last+2. Component definitions — fill in as they stream+3. Data values — leaf content lastAlways write the root = Stack(...) statement first so the UI shell appears immediately, even before child data has streamed in.