@usetheo/ui 0.7.0-next.0 → 0.9.0-next.0

package/llms.txt

@@ -0,0 +1,269 @@
+# @usetheo/ui — Theo UI (Violet Forge)
+
+> React component library for AI-agent surfaces and cloud (PaaS) dashboards. 114 components (87 primitives + 27 composites), framework-agnostic (React peer-dep only), ESM-only, Apache-2.0. Built on Radix UI + CVA + lucide-react + Tailwind v4. Same Radix foundation as shadcn — the wedge is the agent/PaaS-specific components built on top.
+
+This file follows the [llms.txt convention](https://llmstxt.org/) and gives an LLM the **factual ground truth** of the project: package name, import paths, component inventory, locked conventions, anti-patterns, and links to the canonical documentation. Treat the bullets below as non-negotiable contracts unless the source files contradict them — in which case the source files win and this file is stale.
+
+## Project metadata
+
+- **npm package:** `@usetheo/ui`
+- **Current version:** `0.8.0-next.0` (npm dist-tag `next`; latest release line)
+- **License:** Apache-2.0
+- **Repository:** `https://github.com/usetheodev/theo-ui`
+- **Docs site:** `https://docs.usetheo.dev/theoui`
+- **Registry (shadcn CLI):** `https://usetheodev.github.io/theo-ui/r/{slug}.json`
+- **Design-system codename:** Violet Forge
+- **Module format:** ESM only (no CJS). `"type": "module"`. Side-effects on `**/*.css`.
+- **React peer range:** `>=18.2.0 <20` (works with 18.x and 19.x)
+- **Distribution:** npm package install OR copy-paste source via shadcn CLI (registry). Both paths are first-class.
+
+## Install
+
+```bash
+# Full package (recommended for new projects)
+pnpm add @usetheo/ui@next
+
+# Per-component copy (shadcn-style)
+npx shadcn@latest add https://usetheodev.github.io/theo-ui/r/copy-button.json
+```
+
+## Import path canonical form
+
+```ts
+// All components ship via the single barrel.
+import { Button, Table, ConfirmDialog, CopyButton } from "@usetheo/ui";
+
+// Themes + provider:
+import { ThemeProvider, violetForge, classicPaper, auroraTerminal } from "@usetheo/ui";
+
+// Pure utility (no React):
+import { cn } from "@usetheo/ui";
+
+// Engines ship under subpaths (separate bundles, opt-in peer-deps):
+import { Whiteboard } from "@usetheo/ui/whiteboard";
+import { Slide } from "@usetheo/ui/slide";
+import { SlideDeck } from "@usetheo/ui/slide-deck";
+import { Mermaid } from "@usetheo/ui/slide/plugins/mermaid";
+import { Math } from "@usetheo/ui/slide/plugins/math";
+import { Shiki } from "@usetheo/ui/slide/plugins/shiki";
+import { Emoji } from "@usetheo/ui/slide/plugins/emoji";
+import { theoUIVitePlugin } from "@usetheo/ui/vite-plugin";
+import "@usetheo/ui/preset";       // Tailwind v4 preset (zero-config)
+```
+
+There are **131 subpath exports** in `package.json#exports` — one per component plus engine entry points. Per-component subpath imports (`@usetheo/ui/button`) exist but are **not the canonical form**; prefer the barrel for tree-shakeable production builds (`sideEffects: ["**/*.css"]` is honored).
+
+## Peer dependencies (required vs optional)
+
+**Required for the main barrel:**
+- `react >=18.2.0 <20`
+- `react-dom >=18.2.0 <20`
+- `tailwindcss ^4.0.0`
+
+**Optional (only required if you use the matching engine subpath):**
+- `@tailwindcss/vite ^4.0.0`, `vite ^6 || ^7` — for `@usetheo/ui/vite-plugin`
+- `roughjs ^4.6`, `perfect-freehand ^1.2` — for `@usetheo/ui/whiteboard`
+- `mdast-util-from-markdown`, `mdast-util-gfm`, `mdast-util-to-hast`, `hast-util-sanitize`, `hast-util-to-jsx-runtime`, `micromark-extension-gfm`, `unist-util-visit`, `unist-util-visit-parents`, `yaml` — for `@usetheo/ui/slide`
+- `shiki ^1.0` — for `@usetheo/ui/slide/plugins/shiki`
+- `katex ^0.16`, `mdast-util-math`, `micromark-extension-math` — for `@usetheo/ui/slide/plugins/math`
+- `mermaid ^11.0` — for `@usetheo/ui/slide/plugins/mermaid`
+- `hast-util-from-html` — for `@usetheo/ui/slide/plugins/emoji`
+
+**Already bundled (do NOT install separately):** `@radix-ui/*`, `class-variance-authority`, `clsx`, `cmdk`, `lucide-react`, `tailwind-merge`. These are `dependencies`, not peer.
+
+## Taxonomy (mechanical rule, gate-enforced)
+
+- **Primitive** = a component that imports **zero** other `@usetheo/ui` components. Lives in `src/components/primitives/`.
+- **Composite** = a component that imports **one or more** primitives via their barrel `index.js`. Lives in `src/components/composites/`.
+- The gate `scripts/validate-quality-gates.ts` is **hard-fail** if either rule is violated. A primitive that grows to need a sibling primitive must be **promoted to composite** by moving the folder + renaming via PR with rationale.
+- Composites import siblings via barrel: `import { Button } from "../../primitives/button/index.js"` — NOT via the raw `.tsx` file (also gate-enforced).
+- Sub-component pattern (e.g., `Table.Header`, `Sidebar.Item`, `DangerZone.Action`) is implemented via `Object.assign(Root, { SubA, SubB })` — Sidebar-style. Single import surface, attached as static properties on the root.
+
+## Theme system
+
+- **Provider:** `<ThemeProvider initial="violet-forge">{...}</ThemeProvider>`. Wrap once at the app root.
+- **Built-in themes (10):** `violetForge` (default), `classicPaper`, `auroraTerminal`, `vercelMono`, `githubDark`, `dracula`, `oneDark`, `anthropicStyle`, `openaiStyle`, `linearGlass`.
+- **Custom themes:** `defineTheme({ name, mode, fonts, palette })` — returns a `Theme` object you pass into `<ThemeProvider extra={[myTheme]} />`.
+- **Color helpers:** `hex("#7c5cff")`, `rgb(124, 92, 255)` — both return CSS-ready strings.
+- **Density:** `useDensity()` hook returns `"compact" | "comfortable" | "cozy"`. Cascading via `<DensityProvider>`.
+- **Fonts (locked):** Geist Sans (display + body) + Geist Mono (mono). Loaded via CDN by default (`dist/fonts-cdn.css`) or locally (`dist/fonts.css`).
+- **Tailwind v4:** CSS-first config via `@usetheo/ui/preset` (zero JS config). v3 legacy preset available at `@usetheo/ui/preset-v3-legacy`.
+
+## Component catalog — primitives (87)
+
+Located in `src/components/primitives/{slug}/`. Each ships `.tsx` + `.test.tsx` + `.stories.tsx` + `index.ts` + a `registry/{slug}.json` descriptor.
+
+`agent-error-card`, `agent-event`, `agent-handoff`, `agent-profile`, `agent-starting-state`, `agent-streaming`, `artifact-preview`, `attachment-chip`, `audit-log-entry`, `auto-compact-notice`, `avatar`, `badge`, `browser-controls`, `build-log-stream`, `button`, `capability-indicator`, `card`, `chat-thread`, `checkbox`, `context-card`, `context-window-bar`, **`copy-button`** (NEW 0.8), `cost-meter`, `created-files-card`, `cron-job-card`, **`danger-zone`** (NEW 0.8), `dialog`, `diff-viewer`, `empty-state`, `folder-context-card`, `folder-selector`, `form-field`, `hook-config`, `hook-event-log`, `input`, `intent-selector`, `label`, `lane-board`, `login-split`, `mcp-server-card`, `memory-editor`, `mention-menu`, `metrics-panel`, `model-card`, `model-selector`, `permission-matrix`, **`plan-badge`** (0.7), **`progress`** (0.7), `progress-checklist`, `project-switcher`, `quick-action-chips`, `radio-group`, `recent-folders-list`, `rule-card`, `running-tasks-panel`, `run-stats`, `scroll-area`, `select`, `session-list-item`, `session-timeline`, `sheet`, `sidebar`, `skeleton`, `skill-card`, `slide`, `social-auth-row`, **`stat-tile`** (NEW 0.8), **`status-dot`** (NEW 0.8), `steps-rail`, `sub-agent-dispatch`, `switch`, `system-prompt-editor`, **`table`** (NEW 0.8), `tabs`, `task-plan`, `terminal-panel`, `textarea`, **`timestamp`** (NEW 0.8), `toast`, `token-usage-chart`, `tool-call`, `tool-call-card`, `tool-result`, `tools-list`, `tooltip`, `topnav`, `whiteboard`.
+
+## Component catalog — composites (27)
+
+Located in `src/components/composites/{slug}/`.
+
+**`account-menu`** (0.7), `agent-composer`, `agent-editor`, `agent-stream`, `agent-timeline`, `approval-card`, `chat-composer`, `chat-message`, **`code-block`** (NEW 0.8), `command-palette`, **`confirm-dialog`** (NEW 0.8), `cron-jobs-list`, `deployment-row`, `domain-config`, `env-var-editor`, `mcp-server-list`, `permission-modal`, `preview-env-card`, `preview-panel`, `project-card`, `rollback-ui`, `rule-editor`, `skill-editor`, `skills-list`, `slide-deck`, `task-header`, **`usage-meter`** (0.7).
+
+## Recent deliveries (PaaS shape)
+
+- **0.8.0-next.0 (Brief #2 — cross-cutting, 8 components):** `Table` (sub-components + sortable headers), `StatusDot` (5 kinds + auto-pulse), `CopyButton` (clipboard + `aria-live` + SSR-safe), `Timestamp` (`Intl.RelativeTimeFormat`, native `title` tooltip, Unix ms only), `StatTile` (dual button/div mode), `DangerZone` (`.Action` sub-component), `ConfirmDialog` (typed-phrase guard + async loading + Enter-to-confirm), `CodeBlock` (terminal prefix + caption + raw-code copy). Consumer: TheoCloud dashboard. Zero new peer-deps; bundle +5.4% (rebaselined).
+- **0.7.0-next.0 (Brief #1 — PaaS-shape, 4 components):** `UsageMeter` (multi-metric, over-quota warning + clamping), `Progress` (4 intents + indeterminate + motion-reduce aware), `PlanBadge` (5 canonical tiers), `AccountMenu` (avatar + name + plan + secondary, dual button/div).
+
+## Component conventions (do this)
+
+Every component file MUST:
+
+1. Use `forwardRef<HTMLElementType, Props>` and set `displayName`. Example: `MyComponent.displayName = "MyComponent";`.
+2. Compose classes via `cn(...)` from `lib/cn.js` (`tailwind-merge` + `clsx` underneath).
+3. Use **design tokens** only — never raw hex/rgb. Approved tokens: `bg-card`, `bg-muted`, `bg-muted/40`, `bg-primary`, `bg-primary/10`, `bg-success`, `bg-warning`, `bg-destructive`, `bg-destructive/[0.02]`, `text-foreground`, `text-muted-foreground`, `text-success`, `text-warning`, `text-destructive`, `border-border/40`, `border-border/60`, `border-destructive/30`, `text-card-foreground`, `text-primary-foreground`, `ring-ring`, etc.
+4. Use **typography scale**: `text-display-md`, `text-title-sm`, `text-body-sm`, `text-label`, `text-label-caps`, `font-display`, `font-sans`, `font-mono` — never raw `text-xl`/`text-base`/`text-sm`.
+5. Use `lucide-react` for icons. Never inline SVG. Icons rendered as components (`<Copy aria-hidden="true" className="size-3.5" />`).
+6. Use CVA (`class-variance-authority`) for variant APIs that have ≥3 options (Button, Badge, Progress intent, etc.).
+7. Pass `aria-label` for icon-only triggers. Use `<span className="sr-only" aria-live="polite">` for state announcements (CopyButton pattern).
+8. Tests use `vitest` + `@testing-library/react` + `vitest-axe`. Every interactive primitive ships `expect(await axe(container)).toHaveNoViolations()`. Async assertions use `findBy*` with `{ timeout: 5000 }` headroom for parallel vitest pool.
+9. Stories ship in Ladle (`.stories.tsx`). Title pattern: `"Primitives / {Category} / {Name}"` or `"Composites / {Category} / {Name}"`.
+10. Registry descriptor in `registry/{slug}.json` with shadcn schema. Each entry declares `dependencies` (npm) + `registryDependencies` (other registry items in this project).
+
+## Anti-patterns (do NOT)
+
+- **Do NOT** add raw hex/rgb. Always use tokens. The design-audit gate fails the build if it finds them.
+- **Do NOT** install Radix / CVA / lucide-react separately — they're bundled `dependencies`.
+- **Do NOT** import a sibling primitive into another primitive (taxonomy gate hard-fails). Either inline the dep or promote to composite.
+- **Do NOT** import via `../../primitives/foo/foo.js` from a composite — use `../../primitives/foo/index.js` (gate hard-fails).
+- **Do NOT** wrap dropdown/dialog/select in your own Portal. Radix manages portals correctly.
+- **Do NOT** disable a quality gate or add `eslint-disable`/`biome-ignore` to silence one — fix the root cause. Acceptable biome-ignore comments must include a `WAI-ARIA …` or equivalent justification.
+- **Do NOT** roll your own clipboard, focus-trap, accessible dialog, color parser, markdown renderer, syntax highlighter, or relative-time formatter — use `<CopyButton>`, Radix Dialog, `Intl.RelativeTimeFormat`, etc.
+- **Do NOT** ship CJS (`require()`). ESM only. The TypeScript output is `.js` with `.d.ts` siblings.
+- **Do NOT** rename the locked names (see below) without a strategic review.
+- **Do NOT** use emojis in code, README, JSDoc, or CHANGELOG. (User-facing copy in docs is OK if explicitly requested.)
+- **Do NOT** invent integration that doesn't exist. As of 2026-05-23, `@usetheo/ui` has **no** import from `@usetheo/sdk`, `theokit`, or `theo-code`. Verify with `grep` before claiming wiring.
+
+## Locked names (immutable without strategic review)
+
+| Item | Value |
+|---|---|
+| npm package | `@usetheo/ui` |
+| Codename | Violet Forge |
+| Default theme | `violet-forge` |
+| Built-in themes (3 originals) | `violet-forge`, `classic-paper`, `aurora-terminal` |
+| ThemeProvider component | `<ThemeProvider />` |
+| Registry endpoint (planned canonical) | `ui.usetheo.dev/r/*.json` |
+| Module format | ESM only |
+| Quality-gate command | `pnpm quality:gates` |
+| Test framework | Vitest |
+| Stories framework | Ladle |
+| Linter / formatter | Biome (`biome check`, `biome format`) |
+| Component taxonomy | `primitive` (no internal deps) vs `composite` (≥1 internal dep) |
+| Fonts | Geist Sans + Geist Mono (CDN by default) |
+
+## Engines (subpath-isolated, opt-in)
+
+These ship under their own subpath because they require heavy peer-deps. **Do NOT** include in the main barrel.
+
+| Engine | Subpath | Required peer-deps |
+|---|---|---|
+| Whiteboard (Excalidraw-style view) | `@usetheo/ui/whiteboard` | `roughjs`, `perfect-freehand` |
+| Slide (Marp-style view) | `@usetheo/ui/slide` | `mdast-util-*`, `hast-util-*`, `micromark-extension-gfm`, `unist-util-visit*`, `yaml` |
+| SlideDeck | `@usetheo/ui/slide-deck` | inherits from Slide |
+| Slide plugin — Shiki | `@usetheo/ui/slide/plugins/shiki` | `shiki` |
+| Slide plugin — Math (KaTeX) | `@usetheo/ui/slide/plugins/math` | `katex`, `mdast-util-math`, `micromark-extension-math` |
+| Slide plugin — Mermaid | `@usetheo/ui/slide/plugins/mermaid` | `mermaid` |
+| Slide plugin — Emoji | `@usetheo/ui/slide/plugins/emoji` | `hast-util-from-html` |
+| Vite plugin | `@usetheo/ui/vite-plugin` | `vite ^6 || ^7`, `@tailwindcss/vite` |
+
+All engines documented under RFC 0001 / 0002 / 0003 / 0004 in `docs/rfcs/`. View-only (no editing) by design.
+
+## Quality gates (run via `pnpm quality:gates`)
+
+The full chain runs in CI and must be 100% green for any PR to merge:
+
+1. `format:check` — Biome formatter
+2. `lint:ci` — Biome linter (strict)
+3. `typecheck` — `tsc --noEmit` (strict TS)
+4. `test` — Vitest run (1532+ tests including `vitest-axe` a11y)
+5. `build` — tsup (ESM + d.ts + CSS)
+6. `registry:build` + `registry:validate` — shadcn descriptors
+7. `quality:structure` — taxonomy + readme drift + design-audit + test/story coverage
+8. `quality:bundle` — `dist/index.js` size delta within ±5% baseline (rebaseline explicit via `--update`)
+9. `quality:a11y` — every interactive Ladle story axe-validated (~226 tests)
+10. `ladle:build` — verify Ladle compiles
+11. `dogfood:*` — end-to-end smoke against each engine
+
+## Test conventions
+
+- Framework: **Vitest** (NOT Jest). Use `vi.fn()`, `vi.spyOn()`, `vi.useFakeTimers()`.
+- Renderer: `@testing-library/react`. Always `render(<C ... />)`, never manual `ReactDOM.render`.
+- A11y: `import { axe } from "vitest-axe"; expect(await axe(container)).toHaveNoViolations();`
+- Async assertions: `await screen.findByText(...)` (not `getByText` then `waitFor`). For tests under parallel vitest pool stress, add `{ timeout: 5000 }`.
+- Radix dialog tests: use `baseElement` (not `container`) for portal-rendered content. Disable `aria-hidden-focus` rule on axe runs over Dialog content — it's a false positive on Radix's focus-guard spans.
+- Clipboard tests: `vi.stubGlobal("navigator", { clipboard: { writeText: vi.fn() } });`.
+- Time/Date tests: `vi.useFakeTimers(); vi.setSystemTime(new Date("2026-05-23T12:00:00Z"));`.
+
+## Stories convention (Ladle)
+
+```tsx
+import type { Story } from "@ladle/react";
+import { MyComponent } from "./my-component.js";
+
+export default { title: "Primitives / Category / MyComponent" };
+
+export const Default: Story = () => <MyComponent prop="value" />;
+```
+
+Run dev server: `pnpm dev` (Ladle on `http://localhost:61000`). Build static: `pnpm ladle:build`. Title pattern is enforced for sidebar grouping.
+
+## Documentation URLs (canonical)
+
+- **Site:** `https://docs.usetheo.dev/theoui`
+- **Per-component MDX pages (curated, not auto-gen):**
+  - Primitives: `https://docs.usetheo.dev/theoui/primitives/{slug}`
+  - Composites: most live under their domain dir — `infra/`, `code/`, `agent/`, `auth/`, `tools/`, `models/`, `tasks/`. Examples:
+    - `https://docs.usetheo.dev/theoui/infra/account-menu` (PaaS surface)
+    - `https://docs.usetheo.dev/theoui/infra/usage-meter`
+    - `https://docs.usetheo.dev/theoui/code/code-block`
+    - `https://docs.usetheo.dev/theoui/primitives/table`
+    - `https://docs.usetheo.dev/theoui/primitives/confirm-dialog`
+- **Theming guide:** `https://docs.usetheo.dev/theoui/theming`
+- **Engines:** `https://docs.usetheo.dev/theoui/engines/{whiteboard,slide,slide-deck}`
+- **CHANGELOG:** `https://github.com/usetheodev/theo-ui/blob/main/CHANGELOG.md`
+
+## Source-of-truth files (read these before claiming anything)
+
+1. `/CLAUDE.md` — project contract (locked names, taxonomy gate, voice/tone scope, inviolable rules)
+2. `/README.md` — public catalog + quality gates + dev scripts (auto-synced from filesystem by `pnpm sync:readme`)
+3. `/CHANGELOG.md` — every release entry, including [Unreleased] section
+4. `/package.json#exports` — the authoritative list of subpath imports (auto-synced by `pnpm sync:exports`)
+5. `/src/index.ts` — the barrel; every public component appears here
+6. `/docs/architecture.md` — folder layout + module boundaries
+7. `/docs/design-system.md` — tokens, fonts, type scale (Geist + Vercel scale, locked)
+8. `/docs/rfcs/*.md` — engine RFCs (whiteboard 0001, slide 0002, slide-deck 0003, slide-rich-content 0004, themes 0007, integration 0008, chat-message 0009)
+9. `/scripts/validate-quality-gates.ts` — the taxonomy + structure gate
+10. `/.claude/knowledge-base/plans/*.md` — every change of ≥3 phases has a written plan; the most recent is `dashboard-paas-primitives-2-plan.md` (Brief #2)
+
+## How to add a new component (the rote checklist)
+
+1. Decide taxonomy: does it import another `@usetheo/ui` component? If yes → composite. If no → primitive.
+2. Create folder: `src/components/{primitives,composites}/{kebab-name}/`
+3. Create 4 files: `{slug}.tsx`, `{slug}.test.tsx`, `{slug}.stories.tsx`, `index.ts`
+4. Implement with `forwardRef` + `displayName` + `cn()` + lucide icons + design tokens + typography scale
+5. Tests: ≥6 unit tests including 1 `vitest-axe` assertion
+6. Stories: ≥3 Ladle stories (variants/sizes/states)
+7. Add registry descriptor: `registry/{slug}.json` with `$schema`, `name`, `type: "registry:ui"`, `title`, `description`, `dependencies`, `registryDependencies`, `files`
+8. Add export to `src/index.ts` (the barrel)
+9. Run `pnpm sync:exports && pnpm sync:readme` to regenerate `package.json#exports` + README + architecture catalog + Ladle stats
+10. Add CHANGELOG entry under `## [Unreleased]` → `### Added` with one bullet per component
+11. Run `pnpm quality:gates` — must be 100% green
+12. If shipping to consumers, also write a curated MDX page in `theo-opendocs` (NEVER use auto-gen `/components/` dir — that's broken legacy)
+
+## Cross-project positioning
+
+`@usetheo/ui` is the **UI pillar** of the `usetheo` ecosystem. Other pillars:
+
+- **Harness** — `@usetheo/sdk` (Claude Agent SDK consumer). No current import from `@usetheo/ui`.
+- **Skills** — `theokit` (agent framework). No current import.
+- **Runtime** — Theo PaaS (cloud platform, pre-release). No current import; `<DeploymentRow>`, `<BuildLogStream>`, `<RollbackUI>`, `<EnvVarEditor>`, `<DomainConfig>`, `<PreviewEnvCard>`, `<ProjectCard>`, `<MetricsPanel>`, and the new Brief #1 + #2 components are designed for it but currently unused.
+
+`@usetheo/ui` is **community auxiliary**: Apache-2.0, usable standalone, no commitment to the rest of the stack. The integration story above is aspirational; verify with `grep` before claiming wiring exists in any consumer.
+
+## When this file is stale
+
+The code, the README, and the `package.json#exports` map are **authoritative**. If `llms.txt` disagrees with them, the code wins — update this file via PR with a one-line rationale. Locked names (Section "Locked names") and voice/narrative rules require a strategic review at the monorepo level before being weakened or repealed.
+
+— Generated 2026-05-23 from filesystem inventory + `CLAUDE.md` + `README.md`. Regenerate by inspecting `src/components/{primitives,composites}/*/` directories and updating the catalog sections above.

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "@usetheo/ui",
-  "version": "0.7.0-next.0",
+  "version": "0.9.0-next.0",
   "description": "Theo UI — framework-agnostic React component library with the Violet Forge design system. Focused on AI-agent interfaces, cloud dashboards, and developer-tooling surfaces.",
   "license": "Apache-2.0",
   "type": "module",
-  "sideEffects": ["**/*.css"],
+  "sideEffects": [
+    "**/*.css"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -65,6 +67,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./alert": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
     "./approval-card": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
@@ -129,10 +135,18 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./code-block": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
     "./command-palette": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./confirm-dialog": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
     "./context-card": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
@@ -141,6 +155,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./copy-button": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
     "./cost-meter": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
@@ -157,6 +175,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./danger-zone": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
     "./deployment-row": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
@@ -249,6 +271,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./pagination": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
     "./permission-matrix": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
@@ -361,6 +387,14 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./stat-tile": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./status-dot": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
     "./steps-rail": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
@@ -377,6 +411,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./table": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
     "./tabs": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
@@ -397,6 +435,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./timestamp": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
     "./toast": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
@@ -470,44 +512,15 @@
       "import": "./dist/preset-v3-legacy.js"
     }
   },
-  "files": ["dist", "registry/r", "registry/index.json", "LICENSE", "NOTICE", "CHANGELOG.md"],
-  "scripts": {
-    "build": "tsup",
-    "dev": "ladle serve",
-    "ladle:build": "ladle build",
-    "ladle:preview": "ladle preview",
-    "playground": "vite --config playground/vite.config.ts",
-    "playground:build": "vite build --config playground/vite.config.ts",
-    "playground:preview": "vite preview --config playground/vite.config.ts",
-    "typecheck": "tsc --noEmit",
-    "lint": "biome check src",
-    "lint:ci": "biome ci src scripts .ladle playground",
-    "lint:fix": "biome check --write src",
-    "format": "biome format --write src scripts .ladle package.json tsconfig.json tailwind.config.ts vitest.config.ts tsup.config.ts biome.json",
-    "format:check": "biome format src scripts .ladle package.json tsconfig.json tailwind.config.ts vitest.config.ts tsup.config.ts biome.json",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:ui": "vitest --ui",
-    "registry:build": "tsx scripts/build-registry.ts",
-    "registry:validate": "tsx scripts/validate-registry.ts",
-    "sync:readme": "tsx scripts/sync-readme.ts",
-    "sync:exports": "tsx scripts/sync-exports.ts",
-    "test:registry": "tsx scripts/test-registry-install.ts",
-    "test:coverage": "vitest run --coverage",
-    "quality:structure": "tsx scripts/validate-quality-gates.ts",
-    "quality:bundle": "tsx scripts/validate-bundle-size.ts",
-    "quality:bundle:update": "tsx scripts/validate-bundle-size.ts --update",
-    "quality:a11y": "vitest run src/test/ladle-axe.test.tsx",
-    "dogfood:whiteboard": "tsx scripts/dogfood-whiteboard.ts",
-    "dogfood:slide": "tsx scripts/dogfood-slide.ts",
-    "dogfood:slide-deck": "tsx scripts/dogfood-slide-deck.ts",
-    "dogfood:slide-rich": "tsx scripts/dogfood-slide-rich.ts",
-    "dogfood:v4-zero-config": "tsx scripts/dogfood-v4-zero-config.ts",
-    "dogfood:v4-real-build": "bash scripts/dogfood-v4-real-build.sh",
-    "dogfood:precompiled-utilities": "tsx scripts/dogfood-precompiled-utilities.ts",
-    "quality:gates": "pnpm format:check && pnpm lint:ci && pnpm typecheck && pnpm test && pnpm build && pnpm registry:build && pnpm registry:validate && pnpm quality:structure && pnpm quality:bundle && pnpm quality:a11y && pnpm ladle:build && pnpm dogfood:whiteboard && pnpm dogfood:slide && pnpm dogfood:slide-deck && pnpm dogfood:slide-rich && pnpm dogfood:v4-zero-config && pnpm dogfood:precompiled-utilities",
-    "quality:gates:fast": "pnpm format:check && pnpm lint:ci && pnpm typecheck && pnpm registry:build && pnpm registry:validate && pnpm quality:structure"
-  },
+  "files": [
+    "dist",
+    "registry/r",
+    "registry/index.json",
+    "LICENSE",
+    "NOTICE",
+    "CHANGELOG.md",
+    "llms.txt"
+  ],
   "peerDependencies": {
     "@tailwindcss/vite": "^4.0.0",
     "hast-util-from-html": "^2.0.0",
@@ -660,12 +673,6 @@
   "engines": {
     "node": ">=20"
   },
-  "pnpm": {
-    "onlyBuiltDependencies": ["@biomejs/biome", "@swc/core", "esbuild"],
-    "overrides": {
-      "postcss": ">=8.5.10"
-    }
-  },
   "keywords": [
     "react",
     "components",
@@ -681,5 +688,41 @@
   "publishConfig": {
     "access": "public"
   },
-  "packageManager": "pnpm@10.32.1+sha512.a706938f0e89ac1456b6563eab4edf1d1faf3368d1191fc5c59790e96dc918e4456ab2e67d613de1043d2e8c81f87303e6b40d4ffeca9df15ef1ad567348f2be"
-}
+  "scripts": {
+    "build": "tsup",
+    "dev": "ladle serve",
+    "ladle:build": "ladle build",
+    "ladle:preview": "ladle preview",
+    "playground": "vite --config playground/vite.config.ts",
+    "playground:build": "vite build --config playground/vite.config.ts",
+    "playground:preview": "vite preview --config playground/vite.config.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src",
+    "lint:ci": "biome ci src scripts .ladle playground",
+    "lint:fix": "biome check --write src",
+    "format": "biome format --write src scripts .ladle package.json tsconfig.json tailwind.config.ts vitest.config.ts tsup.config.ts biome.json",
+    "format:check": "biome format src scripts .ladle package.json tsconfig.json tailwind.config.ts vitest.config.ts tsup.config.ts biome.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "registry:build": "tsx scripts/build-registry.ts",
+    "registry:validate": "tsx scripts/validate-registry.ts",
+    "sync:readme": "tsx scripts/sync-readme.ts",
+    "sync:exports": "tsx scripts/sync-exports.ts",
+    "test:registry": "tsx scripts/test-registry-install.ts",
+    "test:coverage": "vitest run --coverage",
+    "quality:structure": "tsx scripts/validate-quality-gates.ts",
+    "quality:bundle": "tsx scripts/validate-bundle-size.ts",
+    "quality:bundle:update": "tsx scripts/validate-bundle-size.ts --update",
+    "quality:a11y": "vitest run src/test/ladle-axe.test.tsx",
+    "dogfood:whiteboard": "tsx scripts/dogfood-whiteboard.ts",
+    "dogfood:slide": "tsx scripts/dogfood-slide.ts",
+    "dogfood:slide-deck": "tsx scripts/dogfood-slide-deck.ts",
+    "dogfood:slide-rich": "tsx scripts/dogfood-slide-rich.ts",
+    "dogfood:v4-zero-config": "tsx scripts/dogfood-v4-zero-config.ts",
+    "dogfood:v4-real-build": "bash scripts/dogfood-v4-real-build.sh",
+    "dogfood:precompiled-utilities": "tsx scripts/dogfood-precompiled-utilities.ts",
+    "quality:gates": "pnpm format:check && pnpm lint:ci && pnpm typecheck && pnpm test && pnpm build && pnpm registry:build && pnpm registry:validate && pnpm quality:structure && pnpm quality:bundle && pnpm quality:a11y && pnpm ladle:build && pnpm dogfood:whiteboard && pnpm dogfood:slide && pnpm dogfood:slide-deck && pnpm dogfood:slide-rich && pnpm dogfood:v4-zero-config && pnpm dogfood:precompiled-utilities",
+    "quality:gates:fast": "pnpm format:check && pnpm lint:ci && pnpm typecheck && pnpm registry:build && pnpm registry:validate && pnpm quality:structure"
+  }
+}

package/registry/index.json

@@ -16,7 +16,7 @@
       "name": "account-menu",
       "type": "registry:ui",
       "title": "AccountMenu",
-      "description": "Sidebar header for PaaS surfaces. Avatar + name + (optional) PlanBadge + (optional) secondary line, with dual mode: with onClick renders as a <button> with trailing chevron (account picker affordance); without, renders as a static <div>. PaaS-shape sibling of ProjectSwitcher."
+      "description": "Sidebar header for PaaS surfaces. Avatar + name + (optional) PlanBadge + (optional) secondary line, with dual mode: with onClick renders as a `button` with trailing chevron (account picker affordance); without, renders as a static `div`. PaaS-shape sibling of ProjectSwitcher."
     },
     {
       "name": "agent-composer",
@@ -84,6 +84,12 @@
       "title": "Theo UI agent types",
       "description": "Shared TypeScript types for the agent timeline, events, and statuses."
     },
+    {
+      "name": "alert",
+      "type": "registry:ui",
+      "title": "Alert",
+      "description": "Persistent inline notice primitive. Four intents (info / success / warning / destructive) with mapped lucide icons (Info / CheckCircle2 / TriangleAlert / AlertCircle) and design tokens. Optional title, description, action slot, and onDismiss handler. destructive intent renders role=alert (assertive); other intents render role=status (polite). Distinct from Toast (transient, auto-dismiss) and EmptyState (centered card)."
+    },
     {
       "name": "approval-card",
       "type": "registry:block",
@@ -192,12 +198,24 @@
       "title": "cn (Tailwind class merger)",
       "description": "Merge Tailwind classes with conflict resolution."
     },
+    {
+      "name": "code-block",
+      "type": "registry:ui",
+      "title": "CodeBlock",
+      "description": "Terminal / code-snippet surface. Renders code inside a <pre> with optional 'terminal' prefix per line ('$ '), optional caption (file name), and optional inline CopyButton in top-right. Copy uses the raw code (without the visual prefix). language prop is forward-compat for future syntax highlighting."
+    },
     {
       "name": "command-palette",
       "type": "registry:ui",
       "title": "CommandPalette",
       "description": "Cmd+K-style global launcher with arrow-key navigation, fuzzy ranking, and Enter/Escape behavior — built on cmdk + Theo Dialog."
     },
+    {
+      "name": "confirm-dialog",
+      "type": "registry:ui",
+      "title": "ConfirmDialog",
+      "description": "Controlled confirmation modal built on Dialog. Auto-focuses Cancel on open (deliberate — NOT the destructive button). Optional intent=destructive switches the confirm button to destructive variant. Optional confirmationPhrase enables typed-confirmation guard (case-sensitive, empty string = no phrase). Async onConfirm shows Loader2 spinner; resolve closes the dialog; reject keeps it open so consumers can surface their own error. Enter in the phrase input triggers confirm when matched."
+    },
     {
       "name": "context-card",
       "type": "registry:ui",
@@ -210,6 +228,12 @@
       "title": "ContextWindowBar",
       "description": "Shows how much of the model's context window has been"
     },
+    {
+      "name": "copy-button",
+      "type": "registry:ui",
+      "title": "CopyButton",
+      "description": "Click-to-copy button primitive. Wraps navigator.clipboard.writeText with icon swap (Copy → Check on success, Copy → X on failure), aria-live announcement for screen readers, optional label, ghost/outline variants, and SSR-safe rendering. Auto-cleans the revert timer on unmount and debounces double-clicks."
+    },
     {
       "name": "cost-meter",
       "type": "registry:ui",
@@ -234,6 +258,12 @@
       "title": "CronJobsList",
       "description": "Grid of CronJobCards with a sticky \"new job\" action."
     },
+    {
+      "name": "danger-zone",
+      "type": "registry:ui",
+      "title": "DangerZone",
+      "description": "Destructive-actions section primitive with sub-component DangerZone.Action. Red-bordered container with title bar (default 'Danger Zone') and action rows. Each row carries title + description + consumer-provided action slot (typically a destructive Button). Rows separated by hairline dividers; last row drops the bottom border via last:border-b-0."
+    },
     {
       "name": "deployment-row",
       "type": "registry:block",
@@ -384,6 +414,12 @@
       "title": "ModelSelector",
       "description": "Chip dropdown for picking the active LLM."
     },
+    {
+      "name": "pagination",
+      "type": "registry:ui",
+      "title": "Pagination",
+      "description": "Accessible page-number navigation primitive. Renders <nav aria-label=Pagination> with first/prev/numbers/next/last buttons and visual ellipses when totalPages exceeds the visible range. Active page carries aria-current=page. Keyboard nav: ArrowLeft / ArrowRight / Home / End. Configurable siblingCount + optional jump buttons. Returns null when totalPages <= 1. Exports a pure computePageRange helper for unit testing the range logic in isolation."
+    },
     {
       "name": "permission-matrix",
       "type": "registry:ui",
@@ -606,6 +642,18 @@
       "title": "SocialAuthRow",
       "description": "Row of OAuth provider buttons."
     },
+    {
+      "name": "stat-tile",
+      "type": "registry:ui",
+      "title": "StatTile",
+      "description": "Big-number stat tile primitive for dashboard summaries. Renders value + label + optional icon + optional delta (trend up/down/flat with TrendingUp/TrendingDown/Minus icons and success/destructive/muted color). Dual mode: with onClick renders as button with hover state + trailing ArrowUpRight chevron; without, renders as static div. Value uses font-display tabular-nums whitespace-nowrap."
+    },
+    {
+      "name": "status-dot",
+      "type": "registry:ui",
+      "title": "StatusDot",
+      "description": "Semantic status indicator (small colored circle + optional label). Five status kinds: live (success), building (warning, auto-pulses), failed (destructive), idle (muted), warning (warning, static). Three sizes (xs 6px / sm 8px default / md 10px). When neither label nor aria-label is provided, auto-applies aria-label=status and emits a dev warning."
+    },
     {
       "name": "steps-rail",
       "type": "registry:ui",
@@ -630,6 +678,12 @@
       "title": "SystemPromptEditor",
       "description": "Surface the agent's system prompt with a clear"
     },
+    {
+      "name": "table",
+      "type": "registry:ui",
+      "title": "Table",
+      "description": "Semantic data-table primitive with sub-components (Table.Header, Table.Body, Table.Row, Table.Cell, Table.HeaderCell). Supports density (default | compact via Context), per-cell align (left | center | right), numeric cells (font-mono tabular-nums), and sortable header cells (onSort + sortDirection with ChevronUp/ChevronDown affordance + aria-sort)."
+    },
     {
       "name": "tabs",
       "type": "registry:ui",
@@ -690,6 +744,12 @@
       "title": "TheoUIProvider",
       "description": "Primary entry-point provider — composes ThemeProvider + Toaster with sensible defaults. Use as the single root wrapper in consumer apps."
     },
+    {
+      "name": "timestamp",
+      "type": "registry:ui",
+      "title": "Timestamp",
+      "description": "Accessible <time> primitive with relative/absolute/both formats, auto-refresh interval (default 60s, 0 disables), native title tooltip with absolute time, and aria-label that always carries the full date. Built on Intl.RelativeTimeFormat (zero deps). value accepts ISO string, Date, or Unix ms (NOT seconds). Invalid date renders empty element; invalid locale falls back to default with dev warning."
+    },
     {
       "name": "toast",
       "type": "registry:ui",

package/registry/r/account-menu.json

@@ -3,7 +3,7 @@
   "name": "account-menu",
   "type": "registry:ui",
   "title": "AccountMenu",
-  "description": "Sidebar header for PaaS surfaces. Avatar + name + (optional) PlanBadge + (optional) secondary line, with dual mode: with onClick renders as a <button> with trailing chevron (account picker affordance); without, renders as a static <div>. PaaS-shape sibling of ProjectSwitcher.",
+  "description": "Sidebar header for PaaS surfaces. Avatar + name + (optional) PlanBadge + (optional) secondary line, with dual mode: with onClick renders as a `button` with trailing chevron (account picker affordance); without, renders as a static `div`. PaaS-shape sibling of ProjectSwitcher.",
   "dependencies": [
     "lucide-react"
   ],