@usetheo/ui 0.13.1 → 0.14.0

package/registry/r/tabs.json

@@ -1,22 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
-  "name": "tabs",
-  "type": "registry:ui",
-  "title": "Tabs",
-  "description": "Built on Radix Tabs with active-underline styling and focus-visible ring.",
-  "dependencies": [
-    "@radix-ui/react-tabs"
-  ],
-  "registryDependencies": [
-    "https://usetheodev.github.io/theo-ui/r/cn.json",
-    "https://usetheodev.github.io/theo-ui/r/tailwind-preset.json"
-  ],
-  "files": [
-    {
-      "path": "components/primitives/tabs/tabs.tsx",
-      "type": "registry:ui",
-      "target": "components/ui/tabs.tsx",
-      "content": "import * as TabsPrimitive from \"@radix-ui/react-tabs\";\nimport { forwardRef } from \"react\";\nimport type { ComponentPropsWithoutRef, ElementRef } from \"react\";\nimport { cn } from \"@/lib/cn\";\n\n/**\n * Tabs — built on Radix Tabs.\n *\n * Visual: underlined active tab in primary (violet), inactive in muted-foreground.\n * Used in project views (Overview / Deployments / Logs / Settings).\n */\n\nconst List = forwardRef<\n  ElementRef<typeof TabsPrimitive.List>,\n  ComponentPropsWithoutRef<typeof TabsPrimitive.List>\n>(({ className, ...props }, ref) => (\n  <TabsPrimitive.List\n    data-slot=\"tabs-list\"\n    ref={ref}\n    className={cn(\n      \"inline-flex h-10 items-center border-border/40 border-b text-muted-foreground\",\n      className,\n    )}\n    {...props}\n  />\n));\nList.displayName = \"Tabs.List\";\n\nconst Trigger = forwardRef<\n  ElementRef<typeof TabsPrimitive.Trigger>,\n  ComponentPropsWithoutRef<typeof TabsPrimitive.Trigger>\n>(({ className, ...props }, ref) => (\n  <TabsPrimitive.Trigger\n    data-slot=\"tabs-trigger\"\n    ref={ref}\n    className={cn(\n      \"relative inline-flex h-10 items-center justify-center whitespace-nowrap px-4\",\n      \"font-medium font-sans text-body-sm text-muted-foreground\",\n      \"transition-colors duration-base ease-out-soft\",\n      \"hover:text-foreground\",\n      \"focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background\",\n      \"disabled:pointer-events-none disabled:opacity-50\",\n      \"data-[state=active]:text-foreground\",\n      // Active underline using a pseudo-element via shadow\n      \"data-[state=active]:shadow-[inset_0_-2px_0_0_hsl(var(--primary))]\",\n      className,\n    )}\n    {...props}\n  />\n));\nTrigger.displayName = \"Tabs.Trigger\";\n\nconst Content = forwardRef<\n  ElementRef<typeof TabsPrimitive.Content>,\n  ComponentPropsWithoutRef<typeof TabsPrimitive.Content>\n>(({ className, ...props }, ref) => (\n  <TabsPrimitive.Content\n    data-slot=\"tabs-content\"\n    ref={ref}\n    className={cn(\n      \"mt-4 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\",\n      className,\n    )}\n    {...props}\n  />\n));\nContent.displayName = \"Tabs.Content\";\n\nconst Tabs = /*#__PURE__*/ Object.assign(TabsPrimitive.Root, {\n  List,\n  Trigger,\n  Content,\n});\n\nexport { Tabs };\n"
-    }
-  ]
-}

package/registry/r/tailwind-preset.json

@@ -1,19 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
-  "name": "tailwind-preset",
-  "type": "registry:lib",
-  "title": "Theo UI Tailwind preset",
-  "description": "Type scale, fontFamily, colors and motion tokens consumed by every Theo UI component. Add to tailwind.config.ts#presets before installing any other component.",
-  "dependencies": [
-    "tailwindcss",
-    "tailwindcss-animate"
-  ],
-  "files": [
-    {
-      "path": "styles/tailwind-preset.ts",
-      "type": "registry:lib",
-      "target": "styles/tailwind-preset.ts",
-      "content": "/**\n * Theo UI Tailwind preset — Violet Forge identity.\n *\n * Single source of truth for the design system's utility-level tokens:\n *   - colors mapped to CSS variables (HSL split via `hsl(var(--x) / <alpha>)`)\n *   - Geist-inspired typescale (display / title / body / label / code tiers)\n *   - radii, shadows, motion timing & duration, keyframes\n *   - tailwindcss-animate plugin\n *\n * Consumed by:\n *   - `tailwind.config.ts` (this repo) via `presets: [theoUIPreset]`\n *   - registry/r/tailwind-preset.json (shipped to consumers via shadcn CLI)\n *\n * Consumers integrate as:\n *\n *   import type { Config } from \"tailwindcss\";\n *   import { theoUIPreset } from \"./styles/tailwind-preset\";\n *\n *   export default {\n *     darkMode: \"class\",\n *     content: [\"./src/**\\/*.{ts,tsx}\"],\n *     presets: [theoUIPreset],\n *   } satisfies Config;\n *\n * Note: `darkMode` and `content` are NOT in the preset — they are consumer\n * decisions. The preset only contains `theme.extend.*` and `plugins`.\n */\n\nimport type { Config } from \"tailwindcss\";\nimport animate from \"tailwindcss-animate\";\n\n// Post-T2.4 (ADR-0005): tokens are OKLCH. The previous `hsl(var(--x) / <alpha>)`\n// pattern resolves to `hsl(oklch(...))` which is invalid CSS — utilities\n// silently fall back to transparent. OKLCH relative-color syntax preserves\n// Tailwind's `<alpha-value>` slot for opacity modifiers (e.g. `bg-primary/50`).\nconst hsl = (token: string) => `oklch(from var(${token}) l c h / <alpha-value>)`;\n\nexport const theoUIPreset: Partial<Config> = {\n  theme: {\n    container: {\n      center: true,\n      padding: \"1rem\",\n      screens: {\n        \"2xl\": \"1280px\",\n      },\n    },\n    extend: {\n      colors: {\n        background: hsl(\"--background\"),\n        foreground: hsl(\"--foreground\"),\n        card: {\n          DEFAULT: hsl(\"--card\"),\n          foreground: hsl(\"--card-foreground\"),\n        },\n        popover: {\n          DEFAULT: hsl(\"--popover\"),\n          foreground: hsl(\"--popover-foreground\"),\n        },\n        primary: {\n          DEFAULT: hsl(\"--primary\"),\n          deep: hsl(\"--primary-deep\"),\n          glow: hsl(\"--primary-glow\"),\n          foreground: hsl(\"--primary-foreground\"),\n        },\n        secondary: {\n          DEFAULT: hsl(\"--secondary\"),\n          foreground: hsl(\"--secondary-foreground\"),\n        },\n        accent: {\n          DEFAULT: hsl(\"--accent\"),\n          deep: hsl(\"--accent-deep\"),\n          foreground: hsl(\"--accent-foreground\"),\n        },\n        muted: {\n          DEFAULT: hsl(\"--muted\"),\n          foreground: hsl(\"--muted-foreground\"),\n        },\n        success: {\n          DEFAULT: hsl(\"--success\"),\n          foreground: hsl(\"--success-foreground\"),\n        },\n        warning: {\n          DEFAULT: hsl(\"--warning\"),\n          foreground: hsl(\"--warning-foreground\"),\n        },\n        destructive: {\n          DEFAULT: hsl(\"--destructive\"),\n          foreground: hsl(\"--destructive-foreground\"),\n        },\n        info: {\n          DEFAULT: hsl(\"--info\"),\n          foreground: hsl(\"--info-foreground\"),\n        },\n        // Status palette (online/offline/degraded/info) consumed by\n        // StatusIndicator via `bg-status-*`. The `--status-*` tokens already\n        // live in tokens.css; this block was missing from the v3 preset (only\n        // the v4 `@theme` declared `--color-status-*`), so `bg-status-online`\n        // resolved to nothing in the v3/Ladle build — transparent dots.\n        status: {\n          online: {\n            DEFAULT: hsl(\"--status-online\"),\n            foreground: hsl(\"--status-online-foreground\"),\n          },\n          offline: {\n            DEFAULT: hsl(\"--status-offline\"),\n            foreground: hsl(\"--status-offline-foreground\"),\n          },\n          degraded: {\n            DEFAULT: hsl(\"--status-degraded\"),\n            foreground: hsl(\"--status-degraded-foreground\"),\n          },\n          info: { DEFAULT: hsl(\"--status-info\"), foreground: hsl(\"--status-info-foreground\") },\n        },\n        border: hsl(\"--border\"),\n        input: hsl(\"--input\"),\n        ring: hsl(\"--ring\"),\n      },\n      fontFamily: {\n        display: \"var(--font-display)\",\n        sans: \"var(--font-body)\",\n        mono: \"var(--font-mono)\",\n      },\n      /* Geist-inspired Violet Forge typescale.\n       *\n       * Three strict weights: 400 (body), 500 (UI), 600 (display/headings).\n       * Letter-spacing scales with size — aggressive negative on display.\n       * Mirrors the Vercel/Geist vocabulary while keeping Theo's identity.\n       */\n      fontSize: {\n        // Display tier — aggressive compression, content-led headlines\n        \"display-2xl\": [\"64px\", { lineHeight: \"1\", letterSpacing: \"-0.0464em\", fontWeight: \"600\" }],\n        \"display-xl\": [\"48px\", { lineHeight: \"1.05\", letterSpacing: \"-0.05em\", fontWeight: \"600\" }],\n        \"display-lg\": [\"40px\", { lineHeight: \"1.1\", letterSpacing: \"-0.05em\", fontWeight: \"600\" }],\n        \"display-md\": [\"32px\", { lineHeight: \"1.2\", letterSpacing: \"-0.04em\", fontWeight: \"600\" }],\n        headline: [\"28px\", { lineHeight: \"1.25\", letterSpacing: \"-0.035em\", fontWeight: \"600\" }],\n        // Title tier — section / card heads\n        \"title-lg\": [\"24px\", { lineHeight: \"1.33\", letterSpacing: \"-0.04em\", fontWeight: \"600\" }],\n        \"title-md\": [\"20px\", { lineHeight: \"1.4\", letterSpacing: \"-0.03em\", fontWeight: \"600\" }],\n        // Body tier — FAANG-density realignment 2026-05-22: body-md is the\n        // industry-standard 14px (shadcn / Vercel Geist / Linear / Stripe /\n        // Mantine). The previous 15px was idiosyncratic. body-sm (14px label\n        // weight) remains separate via its line-height / weight signature.\n        \"body-lg\": [\"18px\", { lineHeight: \"1.56\", letterSpacing: \"-0.01em\", fontWeight: \"400\" }],\n        \"body-md\": [\"14px\", { lineHeight: \"1.43\", letterSpacing: \"0\", fontWeight: \"400\" }],\n        \"body-sm\": [\"13px\", { lineHeight: \"1.46\", fontWeight: \"400\" }],\n        // Label tier — used on buttons, nav, secondary actions\n        label: [\"14px\", { lineHeight: \"1.43\", fontWeight: \"500\" }],\n        \"label-caps\": [\"12px\", { lineHeight: \"1.33\", letterSpacing: \"0.04em\", fontWeight: \"500\" }],\n        // Mono — code surfaces, technical labels\n        \"code-md\": [\"14px\", { lineHeight: \"1.5\", fontWeight: \"400\" }],\n        \"code-sm\": [\"13px\", { lineHeight: \"1.54\", fontWeight: \"500\" }],\n      },\n      borderRadius: {\n        none: \"var(--radius-none)\",\n        sm: \"var(--radius-sm)\",\n        md: \"var(--radius-md)\",\n        lg: \"var(--radius-lg)\",\n        xl: \"var(--radius-xl)\",\n        \"2xl\": \"var(--radius-2xl)\",\n        full: \"var(--radius-full)\",\n      },\n      boxShadow: {\n        sm: \"var(--shadow-sm)\",\n        md: \"var(--shadow-md)\",\n        lg: \"var(--shadow-lg)\",\n        glow: \"var(--shadow-glow)\",\n        \"glow-strong\": \"var(--shadow-glow-strong)\",\n      },\n      transitionTimingFunction: {\n        \"out-soft\": \"var(--ease-out-soft)\",\n        snap: \"var(--ease-snap)\",\n      },\n      transitionDuration: {\n        fast: \"var(--duration-fast)\",\n        base: \"var(--duration-base)\",\n        slow: \"var(--duration-slow)\",\n      },\n      keyframes: {\n        \"fade-in-up\": {\n          \"0%\": { opacity: \"0\", transform: \"translateY(8px)\" },\n          \"100%\": { opacity: \"1\", transform: \"translateY(0)\" },\n        },\n        \"pulse-glow\": {\n          \"0%, 100%\": { boxShadow: \"0 0 0 0 hsl(var(--primary) / 0.5)\" },\n          \"50%\": { boxShadow: \"0 0 0 8px hsl(var(--primary) / 0)\" },\n        },\n      },\n      animation: {\n        \"fade-in-up\": \"fade-in-up var(--duration-base) var(--ease-out-soft) both\",\n        \"pulse-glow\": \"pulse-glow 1.5s var(--ease-in-out) infinite\",\n      },\n    },\n  },\n  plugins: [animate],\n};\n"
-    }
-  ]
-}

package/registry/r/task-header.json

@@ -1,24 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
-  "name": "task-header",
-  "type": "registry:ui",
-  "title": "TaskHeader",
-  "description": "Title bar for a task pane — composite combining heading, status badge, and chevron menu.",
-  "dependencies": [
-    "lucide-react"
-  ],
-  "registryDependencies": [
-    "https://usetheodev.github.io/theo-ui/r/badge.json",
-    "https://usetheodev.github.io/theo-ui/r/cn.json",
-    "https://usetheodev.github.io/theo-ui/r/tailwind-preset.json",
-    "https://usetheodev.github.io/theo-ui/r/task-types.json"
-  ],
-  "files": [
-    {
-      "path": "components/composites/task-header/task-header.tsx",
-      "type": "registry:ui",
-      "target": "components/ui/task-header.tsx",
-      "content": "import { ChevronDown } from \"lucide-react\";\nimport { forwardRef } from \"react\";\nimport type { HTMLAttributes, ReactNode } from \"react\";\nimport { cn } from \"@/lib/cn\";\nimport type { TaskStatus } from \"@/types/task\";\nimport { Badge } from \"@/components/ui/badge\";\n\nconst statusVariant: Record<\n  TaskStatus,\n  \"default\" | \"primary\" | \"warning\" | \"success\" | \"destructive\"\n> = {\n  idle: \"default\",\n  permission_required: \"warning\",\n  starting: \"primary\",\n  running: \"primary\",\n  verifying: \"primary\",\n  completed: \"success\",\n  failed: \"destructive\",\n};\nconst statusDot: Record<TaskStatus, \"primary\" | \"success\" | \"warning\" | \"destructive\" | \"muted\"> = {\n  idle: \"muted\",\n  permission_required: \"warning\",\n  starting: \"primary\",\n  running: \"primary\",\n  verifying: \"primary\",\n  completed: \"success\",\n  failed: \"destructive\",\n};\nconst statusLabel: Record<TaskStatus, string> = {\n  idle: \"Idle\",\n  permission_required: \"Permission required\",\n  starting: \"Starting up\",\n  running: \"Running\",\n  verifying: \"Verifying\",\n  completed: \"Completed\",\n  failed: \"Failed\",\n};\n\ninterface TaskHeaderProps extends Omit<HTMLAttributes<HTMLElement>, \"title\"> {\n  title: ReactNode;\n  status?: TaskStatus;\n  /**\n   * If provided, a chevron is shown next to the title and clicking it fires this callback.\n   * Used as the \"expand task metadata\" affordance in the Infra shell.\n   */\n  onToggle?: () => void;\n  /** Right-side actions (e.g. cancel task, close panel). */\n  actions?: ReactNode;\n}\n\n/**\n * TaskHeader — title bar for a task pane.\n *\n * Visual: display-md title with chevron + optional status badge with pulse + actions slot.\n */\nconst TaskHeader = forwardRef<HTMLElement, TaskHeaderProps>(\n  ({ className, title, status, onToggle, actions, ...props }, ref) => (\n    <header\n      data-slot=\"task-header\"\n      ref={ref}\n      className={cn(\n        \"flex items-center justify-between gap-3 rounded-xl border border-border/40 bg-card px-4 py-3\",\n        className,\n      )}\n      {...props}\n    >\n      <div className=\"flex min-w-0 items-center gap-2\">\n        <h2 className=\"truncate font-display text-title-lg tracking-tight\">{title}</h2>\n        {onToggle ? (\n          <button\n            type=\"button\"\n            onClick={onToggle}\n            aria-label=\"Toggle task details\"\n            className=\"rounded-md p-1 text-muted-foreground hover:bg-muted hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n          >\n            <ChevronDown className=\"size-4\" />\n          </button>\n        ) : null}\n      </div>\n      <div className=\"flex items-center gap-2\">\n        {status ? (\n          <Badge variant={statusVariant[status]}>\n            <Badge.Dot\n              tone={statusDot[status]}\n              pulse={status === \"running\" || status === \"starting\" || status === \"verifying\"}\n            />\n            {statusLabel[status]}\n          </Badge>\n        ) : null}\n        {actions}\n      </div>\n    </header>\n  ),\n);\nTaskHeader.displayName = \"TaskHeader\";\n\nexport { TaskHeader };\n"
-    }
-  ]
-}

package/registry/r/task-plan.json

@@ -1,22 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
-  "name": "task-plan",
-  "type": "registry:ui",
-  "title": "TaskPlan",
-  "description": "Hierarchical task plan, à la Claude \"plan mode\".",
-  "dependencies": [
-    "lucide-react"
-  ],
-  "registryDependencies": [
-    "https://usetheodev.github.io/theo-ui/r/cn.json",
-    "https://usetheodev.github.io/theo-ui/r/tailwind-preset.json"
-  ],
-  "files": [
-    {
-      "path": "components/primitives/task-plan/task-plan.tsx",
-      "type": "registry:ui",
-      "target": "components/ui/task-plan.tsx",
-      "content": "import { CheckCircle2, Circle, CircleDashed, CircleX, Loader2 } from \"lucide-react\";\nimport { forwardRef } from \"react\";\nimport type { HTMLAttributes, ReactNode } from \"react\";\nimport { cn } from \"@/lib/cn\";\n\nexport type PlanNodeStatus = \"pending\" | \"running\" | \"done\" | \"skipped\" | \"failed\";\n\nexport interface PlanNode {\n  id: string;\n  label: string;\n  status: PlanNodeStatus;\n  /** Optional details / sub-explanation. */\n  detail?: string;\n  /** Sub-nodes (rendered indented). */\n  children?: PlanNode[];\n}\n\nconst STATUS_ICON = {\n  pending: CircleDashed,\n  running: Loader2,\n  done: CheckCircle2,\n  skipped: Circle,\n  failed: CircleX,\n} as const;\n\nconst STATUS_COLOR: Record<PlanNodeStatus, string> = {\n  pending: \"text-muted-foreground\",\n  running: \"text-primary\",\n  done: \"text-success\",\n  skipped: \"text-muted-foreground/60\",\n  failed: \"text-destructive\",\n};\n\nconst LABEL_STYLE: Record<PlanNodeStatus, string> = {\n  pending: \"text-foreground\",\n  running: \"text-foreground\",\n  done: \"text-foreground line-through decoration-muted-foreground/40\",\n  skipped: \"text-muted-foreground line-through\",\n  failed: \"text-destructive\",\n};\n\ninterface TaskNodeProps extends HTMLAttributes<HTMLLIElement> {\n  node: PlanNode;\n  depth?: number;\n}\n\n/**\n * TaskNode — single row in a task plan. Renders its own children recursively\n * with increasing indentation.\n */\nconst TaskNode = forwardRef<HTMLLIElement, TaskNodeProps>(\n  ({ className, node, depth = 0, ...props }, ref) => {\n    const Icon = STATUS_ICON[node.status];\n    return (\n      <li\n        data-slot=\"task-node\"\n        ref={ref}\n        className={cn(\"grid gap-1\", className)}\n        style={{ marginLeft: `${depth * 1.25}rem` }}\n        {...props}\n      >\n        <div className=\"grid grid-cols-[auto_1fr] items-baseline gap-2\">\n          <Icon\n            aria-hidden=\"true\"\n            className={cn(\n              \"mt-0.5 size-3.5 shrink-0\",\n              STATUS_COLOR[node.status],\n              node.status === \"running\" && \"animate-spin\",\n            )}\n          />\n          <div className=\"min-w-0\">\n            <p className={cn(\"text-body-sm\", LABEL_STYLE[node.status])}>{node.label}</p>\n            {node.detail ? (\n              <p className=\"text-body-sm text-muted-foreground\">{node.detail}</p>\n            ) : null}\n          </div>\n        </div>\n        {node.children && node.children.length > 0 ? (\n          <ul className=\"grid gap-1 border-border/30 border-l pl-2\">\n            {node.children.map((child) => (\n              <TaskNode key={child.id} node={child} depth={depth + 1} />\n            ))}\n          </ul>\n        ) : null}\n      </li>\n    );\n  },\n);\nTaskNode.displayName = \"TaskNode\";\n\ninterface TaskPlanProps extends Omit<HTMLAttributes<HTMLElement>, \"title\"> {\n  nodes: PlanNode[];\n  /** Header title. */\n  title?: ReactNode;\n  /** Summary line shown next to the title (e.g. \"3 of 7 done\"). */\n  summary?: ReactNode;\n}\n\n/**\n * TaskPlan — hierarchical task plan, à la Claude \"plan mode\".\n *\n * The agent emits a structured plan; the user sees each step progress from\n * pending → running → done (or failed/skipped). Children render with one\n * extra indent level and a left border to suggest hierarchy.\n */\nconst TaskPlan = forwardRef<HTMLElement, TaskPlanProps>(\n  ({ className, nodes, title = \"Plan\", summary, ...props }, ref) => {\n    const auto = nodes.length;\n    const done = nodes.filter((n) => n.status === \"done\").length;\n    const computedSummary = summary ?? (auto > 0 ? `${done} of ${auto} done` : \"no steps\");\n    return (\n      <section\n        data-slot=\"task-plan\"\n        ref={ref}\n        className={cn(\"rounded-xl border bg-card p-4\", className)}\n        {...props}\n      >\n        <header className=\"mb-3 flex items-baseline justify-between gap-3\">\n          {title ? (\n            <h3 className=\"font-display text-title-md tracking-tight\">{title}</h3>\n          ) : (\n            <span />\n          )}\n          <span className=\"font-mono text-label text-muted-foreground tabular-nums\">\n            {computedSummary}\n          </span>\n        </header>\n        <ul className=\"grid gap-1.5\">\n          {nodes.map((node) => (\n            <TaskNode key={node.id} node={node} />\n          ))}\n        </ul>\n      </section>\n    );\n  },\n);\nTaskPlan.displayName = \"TaskPlan\";\n\nexport { TaskNode, TaskPlan };\n"
-    }
-  ]
-}

package/registry/r/task-types.json

@@ -1,15 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
-  "name": "task-types",
-  "type": "registry:lib",
-  "title": "Theo UI task types",
-  "description": "Shared TypeScript types for task plans, steps, and progress state.",
-  "files": [
-    {
-      "path": "types/task.ts",
-      "type": "registry:lib",
-      "target": "types/task.ts",
-      "content": "export type TaskStatus =\n  | \"idle\"\n  | \"permission_required\"\n  | \"starting\"\n  | \"running\"\n  | \"verifying\"\n  | \"completed\"\n  | \"failed\";\n\nexport type TaskStepStatus = \"pending\" | \"running\" | \"done\" | \"skipped\";\n\nexport interface TaskStep {\n  id: string;\n  label: string;\n  status: TaskStepStatus;\n  /** 0..1 progress for in-flight steps. */\n  progress?: number;\n}\n"
-    }
-  ]
-}

package/registry/r/terminal-panel.json

@@ -1,22 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
-  "name": "terminal-panel",
-  "type": "registry:ui",
-  "title": "TerminalPanel",
-  "description": "Minimal terminal output viewer.",
-  "dependencies": [
-    "lucide-react"
-  ],
-  "registryDependencies": [
-    "https://usetheodev.github.io/theo-ui/r/cn.json",
-    "https://usetheodev.github.io/theo-ui/r/tailwind-preset.json"
-  ],
-  "files": [
-    {
-      "path": "components/primitives/terminal-panel/terminal-panel.tsx",
-      "type": "registry:ui",
-      "target": "components/ui/terminal-panel.tsx",
-      "content": "import { Terminal as TerminalIcon } from \"lucide-react\";\nimport { forwardRef } from \"react\";\nimport type { HTMLAttributes, ReactNode } from \"react\";\nimport { cn } from \"@/lib/cn\";\nimport { useInLiveRegion } from \"@/lib/live-region-context\";\n\nexport interface TerminalLine {\n  id: string;\n  /**\n   * Visual kind: command (prompted), stdout, stderr, ok (success), prompt (active line).\n   */\n  kind?: \"command\" | \"stdout\" | \"stderr\" | \"ok\" | \"prompt\";\n  content: ReactNode;\n}\n\ninterface TerminalPanelProps extends Omit<HTMLAttributes<HTMLDivElement>, \"title\"> {\n  title?: ReactNode;\n  lines: TerminalLine[];\n  /**\n   * Optional prompt prefix for commands, defaults to \"$\".\n   */\n  promptPrefix?: string;\n  /**\n   * Live-region politeness for screen readers. Use `\"polite\"` when streaming\n   * fresh output so assistive tech announces new lines without interrupting.\n   * Default `\"off\"` for static / historical views.\n   */\n  live?: \"off\" | \"polite\";\n}\n\nconst kindColor: Record<NonNullable<TerminalLine[\"kind\"]>, string> = {\n  command: \"text-foreground\",\n  stdout: \"text-muted-foreground\",\n  stderr: \"text-destructive\",\n  ok: \"text-success\",\n  prompt: \"text-primary\",\n};\n\n/**\n * TerminalPanel — minimal terminal output viewer.\n *\n * Visual: dark card with mono font, \"$ \" prefix on command lines, color-coded\n * stdout/stderr/success. No interactivity (read-only) — pair with your own\n * pty/xterm for live shells if needed.\n */\nconst TerminalPanel = forwardRef<HTMLDivElement, TerminalPanelProps>(\n  ({ className, title = \"Terminal\", lines, promptPrefix = \"$\", live = \"off\", ...props }, ref) => {\n    // T4.1 (MF-4): suppress own aria-live when nested in container live region.\n    const inLiveRegion = useInLiveRegion();\n    const effectiveLive = inLiveRegion ? \"off\" : live;\n    return (\n      <div\n        data-slot=\"terminal-panel\"\n        ref={ref}\n        className={cn(\"overflow-hidden rounded-xl border bg-card\", className)}\n        {...props}\n      >\n        <header className=\"flex items-center gap-2 border-border/40 border-b px-3 py-2\">\n          <TerminalIcon className=\"size-3.5 text-muted-foreground\" aria-hidden=\"true\" />\n          <span className=\"font-sans text-label-caps text-muted-foreground uppercase tracking-wider\">\n            {title}\n          </span>\n        </header>\n        <ol\n          className=\"grid gap-0.5 px-3 py-2 font-mono text-code-sm\"\n          aria-live={effectiveLive}\n          aria-atomic=\"false\"\n        >\n          {lines.map((line) => {\n            const kind = line.kind ?? \"stdout\";\n            return (\n              <li key={line.id} className={cn(\"whitespace-pre-wrap\", kindColor[kind])}>\n                {kind === \"command\" ? (\n                  <>\n                    <span className=\"select-none text-primary\">{promptPrefix} </span>\n                    {line.content}\n                  </>\n                ) : kind === \"prompt\" ? (\n                  <span className=\"motion-safe:animate-pulse\">{line.content}</span>\n                ) : (\n                  line.content\n                )}\n              </li>\n            );\n          })}\n        </ol>\n      </div>\n    );\n  },\n);\nTerminalPanel.displayName = \"TerminalPanel\";\n\nexport { TerminalPanel };\n"
-    }
-  ]
-}

package/registry/r/text-prompt.json

@@ -1,24 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
-  "name": "text-prompt",
-  "type": "registry:block",
-  "title": "TextPrompt",
-  "description": "Free-text ask-the-user card with single-line or multi-line input and an optional required gate.",
-  "registryDependencies": [
-    "https://usetheodev.github.io/theo-ui/r/badge.json",
-    "https://usetheodev.github.io/theo-ui/r/button.json",
-    "https://usetheodev.github.io/theo-ui/r/cn.json",
-    "https://usetheodev.github.io/theo-ui/r/input.json",
-    "https://usetheodev.github.io/theo-ui/r/label.json",
-    "https://usetheodev.github.io/theo-ui/r/tailwind-preset.json",
-    "https://usetheodev.github.io/theo-ui/r/textarea.json"
-  ],
-  "files": [
-    {
-      "path": "components/composites/text-prompt/text-prompt.tsx",
-      "type": "registry:block",
-      "target": "components/blocks/text-prompt.tsx",
-      "content": "\"use client\";\n\nimport { forwardRef, useId, useState } from \"react\";\nimport type { HTMLAttributes, ReactNode } from \"react\";\nimport { cn } from \"@/lib/cn\";\nimport { Badge } from \"@/components/ui/badge\";\nimport { Button } from \"@/components/ui/button\";\nimport { Input } from \"@/components/ui/input\";\nimport { Label } from \"@/components/ui/label\";\nimport { Textarea } from \"@/components/ui/textarea\";\n\n/**\n * TextPrompt — free-text \"ask the user\" card for agent surfaces.\n *\n * The open-ended sibling of `ChoicePrompt`: a question with an optional header\n * chip and a single-line (`Input`) or multi-line (`Textarea`) field. Equivalent\n * to the \"Other\" affordance promoted to a question of its own.\n *\n * Renders one question at a time — sequencing is the consumer's responsibility.\n * Controlled (`value` + `onValueChange`) or uncontrolled (`defaultValue`).\n */\n\n/** Payload handed to `onConfirm`. */\nexport interface TextPromptResult {\n  /** The typed text. */\n  text: string;\n}\n\nexport interface TextPromptProps extends Omit<HTMLAttributes<HTMLElement>, \"onSelect\"> {\n  /** The question being asked. */\n  question: ReactNode;\n  /** Optional secondary line under the question. */\n  description?: ReactNode;\n  /** Optional short header chip (rendered as a Badge). */\n  badge?: ReactNode;\n  /** Controlled text value. */\n  value?: string;\n  /** Initial text when uncontrolled. */\n  defaultValue?: string;\n  /** Fired with the text on every keystroke. */\n  onValueChange?: (text: string) => void;\n  /** Field placeholder. */\n  placeholder?: string;\n  /** Render a multi-line Textarea instead of a single-line Input. */\n  multiline?: boolean;\n  /** Rows for the Textarea when `multiline`. Default 3. */\n  rows?: number;\n  /** Require non-empty text before Confirm enables. */\n  required?: boolean;\n  /** Confirm button label. Defaults to \"Confirm\". Omit `onConfirm` to hide it. */\n  confirmLabel?: ReactNode;\n  /** Cancel button label. Defaults to \"Cancel\". Omit `onCancel` to hide it. */\n  cancelLabel?: ReactNode;\n  /** Pressing Confirm. Receives the typed text. */\n  onConfirm?: (result: TextPromptResult) => void;\n  /** Pressing Cancel. */\n  onCancel?: () => void;\n}\n\nconst TextPrompt = forwardRef<HTMLElement, TextPromptProps>(\n  (\n    {\n      className,\n      question,\n      description,\n      badge,\n      value,\n      defaultValue,\n      onValueChange,\n      placeholder,\n      multiline = false,\n      rows = 3,\n      required = false,\n      confirmLabel = \"Confirm\",\n      cancelLabel = \"Cancel\",\n      onConfirm,\n      onCancel,\n      ...props\n    },\n    ref,\n  ) => {\n    const baseId = useId();\n    const questionId = `${baseId}-question`;\n    const fieldId = `${baseId}-field`;\n\n    const [internalValue, setInternalValue] = useState(defaultValue ?? \"\");\n    const text = value !== undefined ? value : internalValue;\n\n    const setText = (next: string): void => {\n      if (value === undefined) setInternalValue(next);\n      onValueChange?.(next);\n    };\n\n    const confirmDisabled = required && text.trim().length === 0;\n\n    const confirm = (): void => {\n      if (confirmDisabled) return;\n      onConfirm?.({ text });\n    };\n\n    return (\n      <section\n        data-slot=\"text-prompt\"\n        ref={ref}\n        aria-labelledby={questionId}\n        className={cn(\n          \"grid w-full gap-4 rounded-xl border bg-card p-5 text-card-foreground shadow-md\",\n          \"transition-shadow duration-base ease-out-soft\",\n          className,\n        )}\n        {...props}\n      >\n        <header className=\"flex items-start justify-between gap-3\">\n          <Label\n            htmlFor={fieldId}\n            id={questionId}\n            required={required}\n            className=\"font-display text-foreground text-title-md tracking-tight\"\n          >\n            {question}\n          </Label>\n          {badge != null ? (\n            <Badge variant=\"primary\" size=\"sm\" className=\"shrink-0\">\n              {badge}\n            </Badge>\n          ) : null}\n        </header>\n        {description != null ? (\n          <p className=\"text-body-sm text-muted-foreground\">{description}</p>\n        ) : null}\n\n        {multiline ? (\n          <Textarea\n            id={fieldId}\n            rows={rows}\n            placeholder={placeholder}\n            value={text}\n            onChange={(event) => setText(event.target.value)}\n          />\n        ) : (\n          <Input\n            id={fieldId}\n            placeholder={placeholder}\n            value={text}\n            onChange={(event) => setText(event.target.value)}\n          />\n        )}\n\n        {onConfirm || onCancel ? (\n          <footer className=\"flex items-center justify-end gap-2\">\n            {onCancel ? (\n              <Button size=\"sm\" variant=\"secondary\" onClick={onCancel}>\n                {cancelLabel}\n              </Button>\n            ) : null}\n            {onConfirm ? (\n              <Button size=\"sm\" variant=\"primary\" disabled={confirmDisabled} onClick={confirm}>\n                {confirmLabel}\n              </Button>\n            ) : null}\n          </footer>\n        ) : null}\n      </section>\n    );\n  },\n);\nTextPrompt.displayName = \"TextPrompt\";\n\nexport { TextPrompt };\n"
-    }
-  ]
-}

package/registry/r/textarea.json

@@ -1,22 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
-  "name": "textarea",
-  "type": "registry:ui",
-  "title": "Textarea",
-  "description": "Multi-line input mirror of Input.",
-  "registryDependencies": [
-    "https://usetheodev.github.io/theo-ui/r/cn.json",
-    "https://usetheodev.github.io/theo-ui/r/tailwind-preset.json"
-  ],
-  "files": [
-    {
-      "path": "components/primitives/textarea/textarea.tsx",
-      "type": "registry:ui",
-      "target": "components/ui/textarea.tsx",
-      "content": "import { type VariantProps, cva } from \"class-variance-authority\";\nimport { forwardRef } from \"react\";\nimport type { TextareaHTMLAttributes } from \"react\";\nimport { cn } from \"@/lib/cn\";\n\n/**\n * Textarea — multi-line input mirror of Input.\n *\n * Matches Input visuals (violet focus ring, --input border, --card bg).\n * The `size` prop accepts `\"sm\" | \"md\" | \"lg\"`. Default `md` preserves the\n * 80px (5rem) min-height + body-md text from before this prop existed.\n *\n * Note: `TextareaHTMLAttributes<HTMLTextAreaElement>` does NOT declare a\n * native `size` attribute (textareas use `rows` / `cols`), so no Omit is\n * needed — contrast with `<Input>` which had EC-1 collision.\n */\nconst textareaVariants = cva(\n  [\n    \"flex w-full resize-y rounded-md border border-input bg-card\",\n    \"text-foreground placeholder:text-muted-foreground\",\n    \"transition-[box-shadow,border-color] duration-base ease-out-soft\",\n    \"focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background\",\n    \"focus-visible:border-primary\",\n    \"disabled:cursor-not-allowed disabled:opacity-50\",\n  ],\n  {\n    variants: {\n      size: {\n        sm: \"min-h-[64px] px-2.5 py-1.5 text-body-sm\",\n        // md: text scale + padding tighten to body-sm per FAANG density.\n        // min-h stays 96px because multiline has its own height rationale.\n        md: \"min-h-[6rem] px-[var(--theo-control-px,0.875rem)] py-1.5 text-body-sm\",\n        lg: \"min-h-[128px] px-4 py-2.5 text-body-md\",\n      },\n    },\n    defaultVariants: { size: \"md\" },\n  },\n);\n\nexport interface TextareaProps\n  extends TextareaHTMLAttributes<HTMLTextAreaElement>,\n    VariantProps<typeof textareaVariants> {}\n\nconst Textarea = forwardRef<HTMLTextAreaElement, TextareaProps>(\n  ({ className, rows = 3, size, ...props }, ref) => (\n    <textarea\n      data-slot=\"textarea\"\n      data-size={size}\n      ref={ref}\n      rows={rows}\n      className={cn(textareaVariants({ size }), className)}\n      {...props}\n    />\n  ),\n);\nTextarea.displayName = \"Textarea\";\n\nexport { Textarea, textareaVariants };\n"
-    }
-  ],
-  "dependencies": [
-    "class-variance-authority"
-  ]
-}

package/registry/r/theme-provider.json

@@ -1,60 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
-  "name": "theme-provider",
-  "type": "registry:lib",
-  "title": "ThemeProvider",
-  "description": "Theme + dark mode provider with built-in Violet Forge, Classic Paper, and Aurora Terminal themes.",
-  "dependencies": [
-    "@radix-ui/react-dropdown-menu",
-    "lucide-react"
-  ],
-  "registryDependencies": [
-    "https://usetheodev.github.io/theo-ui/r/cn.json",
-    "https://usetheodev.github.io/theo-ui/r/env.json",
-    "https://usetheodev.github.io/theo-ui/r/tokens.json"
-  ],
-  "files": [
-    {
-      "path": "themes/types.ts",
-      "type": "registry:lib",
-      "target": "themes/types.ts",
-      "content": "/**\n * Theo UI — Theme types.\n *\n * A Theme is a frozen bundle of CSS-var values that the runtime can swap by\n * setting `data-theme=\"<name>\"` on `<html>`. The structure mirrors what lives\n * in tokens.css so themes can be merged without ambiguity.\n */\n\nexport type ThemeMode = \"light\" | \"dark\";\n\nexport interface ColorScale {\n  background: string;\n  foreground: string;\n  card: string;\n  \"card-foreground\": string;\n  popover: string;\n  \"popover-foreground\": string;\n  primary: string;\n  /**\n   * Tonal scale variants of `primary`. Optional since T3.2 (ADR-0006).\n   * When omitted, derived in CSS from `--primary` via `oklch(from ...)`.\n   * Override per-theme by providing an explicit string.\n   */\n  \"primary-deep\"?: string;\n  \"primary-glow\"?: string;\n  \"primary-foreground\": string;\n  secondary: string;\n  \"secondary-foreground\": string;\n  accent: string;\n  /**\n   * Tonal scale variant of `accent`. Optional since T3.2 — derived in CSS\n   * when omitted. Override per-theme by providing an explicit string.\n   */\n  \"accent-deep\"?: string;\n  \"accent-foreground\": string;\n  muted: string;\n  \"muted-foreground\": string;\n  border: string;\n  input: string;\n  ring: string;\n  success: string;\n  \"success-foreground\": string;\n  warning: string;\n  \"warning-foreground\": string;\n  destructive: string;\n  \"destructive-foreground\": string;\n  info: string;\n  \"info-foreground\": string;\n  /**\n   * Status semantic group (D4 ADR — community-best-practices plan).\n   *\n   * Operational state colors (gateway connected/disconnected/slow/info-flag)\n   * separated from action-result semantics (success/destructive/warning/info).\n   * Defaults in built-in themes mirror their semantic counterparts; consumers\n   * may override for visually-distinct status surfaces. `defineTheme(partial)`\n   * auto-populates from semantic group when omitted.\n   */\n  \"status-online\": string;\n  \"status-online-foreground\": string;\n  \"status-offline\": string;\n  \"status-offline-foreground\": string;\n  \"status-degraded\": string;\n  \"status-degraded-foreground\": string;\n  \"status-info\": string;\n  \"status-info-foreground\": string;\n}\n\nexport interface ThemeFonts {\n  /** Display headlines (h1-h3, hero text). */\n  display: string;\n  /** Body / UI text. */\n  body: string;\n  /** Code, mono, paths, timestamps. */\n  mono: string;\n}\n\nexport interface Theme {\n  /** Stable id, used in `data-theme`. */\n  name: string;\n  /** Human-readable label for theme switchers. */\n  label: string;\n  /** Optional short description shown in switchers. */\n  description?: string;\n  fonts: ThemeFonts;\n  light: ColorScale;\n  dark: ColorScale;\n  /**\n   * Optional URL(s) to fetch before applying. The provider injects a `<link>`\n   * tag once per URL to load remote fonts. Already-injected URLs are deduped.\n   */\n  fontUrls?: string[];\n}\n"
-    },
-    {
-      "path": "themes/violet-forge.ts",
-      "type": "registry:lib",
-      "target": "themes/violet-forge.ts",
-      "content": "import type { Theme } from \"@/themes/types\";\n\n/**\n * Violet Forge — the default Theo theme.\n *\n * Identity: Theo violet electric primary (#A855F7, unified 2026-06-09),\n * burnt sienna accent (#C96442), Vercel-style neutral surfaces\n * (pure white light / charcoal dark), Geist Sans + Geist Mono throughout.\n *\n * Source of truth for `data-theme` overrides. Values mirror\n * src/styles/tokens.css for the default `:root`.\n */\nexport const violetForge: Theme = {\n  name: \"violet-forge\",\n  label: \"Violet Forge\",\n  description: \"Theo default — violet primary, burnt sienna accent, Geist Sans + Geist Mono.\",\n  fonts: {\n    display: '\"Geist\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif',\n    body: '\"Geist\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif',\n    mono: '\"Geist Mono\", ui-monospace, SFMono-Regular, Menlo, monospace',\n  },\n  fontUrls: [\n    \"https://fonts.googleapis.com/css2?family=Geist:wght@100..900&family=Geist+Mono:wght@100..900&display=swap\",\n  ],\n  light: {\n    background: \"oklch(1 0 0)\",\n    foreground: \"oklch(0.146 0 0)\",\n    card: \"oklch(1 0 0)\",\n    \"card-foreground\": \"oklch(0.146 0 0)\",\n    popover: \"oklch(1 0 0)\",\n    \"popover-foreground\": \"oklch(0.146 0 0)\",\n    primary: \"oklch(0.628 0.225 296)\",\n    \"primary-foreground\": \"oklch(1 0 0)\",\n    secondary: \"oklch(0.97 0 0)\",\n    \"secondary-foreground\": \"oklch(0.146 0 0)\",\n    accent: \"oklch(0.621 0.132 39)\",\n    \"accent-foreground\": \"oklch(1 0 0)\",\n    muted: \"oklch(0.97 0 0)\",\n    \"muted-foreground\": \"oklch(0.555 0 0)\",\n    border: \"oklch(0.931 0 0)\",\n    input: \"oklch(0.931 0 0)\",\n    ring: \"oklch(0.628 0.225 296)\",\n    success: \"oklch(0.611 0.161 149.7)\",\n    \"success-foreground\": \"oklch(1 0 0)\",\n    warning: \"oklch(0.67 0.154 60.6)\",\n    \"warning-foreground\": \"oklch(1 0 0)\",\n    destructive: \"oklch(0.579 0.214 27.2)\",\n    \"destructive-foreground\": \"oklch(1 0 0)\",\n    info: \"oklch(0.626 0.186 259.6)\",\n    \"info-foreground\": \"oklch(1 0 0)\",\n    \"status-online\": \"oklch(0.611 0.161 149.7)\",\n    \"status-online-foreground\": \"oklch(1 0 0)\",\n    \"status-offline\": \"oklch(0.579 0.214 27.2)\",\n    \"status-offline-foreground\": \"oklch(1 0 0)\",\n    \"status-degraded\": \"oklch(0.67 0.154 60.6)\",\n    \"status-degraded-foreground\": \"oklch(1 0 0)\",\n    \"status-info\": \"oklch(0.626 0.186 259.6)\",\n    \"status-info-foreground\": \"oklch(1 0 0)\",\n  },\n  dark: {\n    background: \"oklch(0.146 0 0)\",\n    foreground: \"oklch(0.97 0 0)\",\n    card: \"oklch(0.182 0 0)\",\n    \"card-foreground\": \"oklch(0.97 0 0)\",\n    popover: \"oklch(0.204 0 0)\",\n    \"popover-foreground\": \"oklch(0.97 0 0)\",\n    primary: \"oklch(0.628 0.225 296)\",\n    \"primary-foreground\": \"oklch(1 0 0)\",\n    secondary: \"oklch(0.227 0 0)\",\n    \"secondary-foreground\": \"oklch(0.97 0 0)\",\n    accent: \"oklch(0.621 0.132 39)\",\n    \"accent-foreground\": \"oklch(1 0 0)\",\n    muted: \"oklch(0.227 0 0)\",\n    \"muted-foreground\": \"oklch(0.683 0 0)\",\n    border: \"oklch(0.28 0 0)\",\n    input: \"oklch(0.227 0 0)\",\n    ring: \"oklch(0.628 0.225 296)\",\n    success: \"oklch(0.814 0.192 155.7)\",\n    \"success-foreground\": \"oklch(0.146 0 0)\",\n    warning: \"oklch(0.77 0.165 70.6)\",\n    \"warning-foreground\": \"oklch(0.146 0 0)\",\n    destructive: \"oklch(0.677 0.213 15.6)\",\n    \"destructive-foreground\": \"oklch(0.146 0 0)\",\n    info: \"oklch(0.732 0.142 254.4)\",\n    \"info-foreground\": \"oklch(0.146 0 0)\",\n    \"status-online\": \"oklch(0.814 0.192 155.7)\",\n    \"status-online-foreground\": \"oklch(0.146 0 0)\",\n    \"status-offline\": \"oklch(0.677 0.213 15.6)\",\n    \"status-offline-foreground\": \"oklch(0.146 0 0)\",\n    \"status-degraded\": \"oklch(0.77 0.165 70.6)\",\n    \"status-degraded-foreground\": \"oklch(0.146 0 0)\",\n    \"status-info\": \"oklch(0.732 0.142 254.4)\",\n    \"status-info-foreground\": \"oklch(0.146 0 0)\",\n  },\n};\n"
-    },
-    {
-      "path": "themes/classic-paper.ts",
-      "type": "registry:lib",
-      "target": "themes/classic-paper.ts",
-      "content": "import type { Theme } from \"@/themes/types\";\n\n/**\n * Classic Paper — visibly warm cream surface; Inter + JetBrains Mono.\n *\n * Identity: cream paper background with sepia warmth (calibrated against the\n * Vintage Paper / Anthropic Claude UI references), deep navy foreground,\n * indigo primary. Optimized for long agent/chat sessions where pure-white\n * surfaces cause vision fatigue (per IxDF 2026 + ACM 2025 light-mode studies).\n *\n * Token calibration (light mode):\n *   - background L=0.95 chroma=0.025 hue=80 — visibly cream paper\n *   - card L=0.97 chroma=0.012 hue=80 — sub-paper layer (cards stand out)\n *   - foreground unchanged (deep navy, AAA contrast >12:1 vs background)\n *\n * Dark mirror unchanged.\n */\nexport const classicPaper: Theme = {\n  name: \"classic-paper\",\n  label: \"Classic Paper\",\n  description: \"Inter + paper background. Maximum legibility, conservative.\",\n  fonts: {\n    display: '\"Inter\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif',\n    body: '\"Inter\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif',\n    mono: '\"JetBrains Mono\", ui-monospace, SFMono-Regular, Menlo, monospace',\n  },\n  fontUrls: [\n    \"https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;500;700&display=swap\",\n  ],\n  light: {\n    background: \"oklch(0.95 0.025 80)\",\n    foreground: \"oklch(0.206 0.039 265.5)\",\n    card: \"oklch(0.97 0.012 80)\",\n    \"card-foreground\": \"oklch(0.206 0.039 265.5)\",\n    popover: \"oklch(0.98 0.008 80)\",\n    \"popover-foreground\": \"oklch(0.206 0.039 265.5)\",\n    primary: \"oklch(0.545 0.215 262.7)\",\n    \"primary-foreground\": \"oklch(1 0 0)\",\n    secondary: \"oklch(0.93 0.02 80)\",\n    \"secondary-foreground\": \"oklch(0.206 0.039 265.5)\",\n    accent: \"oklch(0.647 0.139 69)\",\n    \"accent-foreground\": \"oklch(1 0 0)\",\n    muted: \"oklch(0.93 0.02 80)\",\n    \"muted-foreground\": \"oklch(0.45 0.03 80)\",\n    border: \"oklch(0.88 0.025 80)\",\n    input: \"oklch(0.92 0.02 80)\",\n    ring: \"oklch(0.545 0.215 262.7)\",\n    success: \"oklch(0.611 0.161 149.7)\",\n    \"success-foreground\": \"oklch(1 0 0)\",\n    warning: \"oklch(0.67 0.154 60.6)\",\n    \"warning-foreground\": \"oklch(1 0 0)\",\n    destructive: \"oklch(0.579 0.214 27.2)\",\n    \"destructive-foreground\": \"oklch(1 0 0)\",\n    info: \"oklch(0.626 0.186 259.6)\",\n    \"info-foreground\": \"oklch(1 0 0)\",\n    \"status-online\": \"oklch(0.611 0.161 149.7)\",\n    \"status-online-foreground\": \"oklch(1 0 0)\",\n    \"status-offline\": \"oklch(0.579 0.214 27.2)\",\n    \"status-offline-foreground\": \"oklch(1 0 0)\",\n    \"status-degraded\": \"oklch(0.67 0.154 60.6)\",\n    \"status-degraded-foreground\": \"oklch(1 0 0)\",\n    \"status-info\": \"oklch(0.626 0.186 259.6)\",\n    \"status-info-foreground\": \"oklch(1 0 0)\",\n  },\n  // Dark mirror — mainly the same hues with inverted lightness so the theme\n  // still feels coherent if a consumer toggles `.dark`.\n  dark: {\n    background: \"oklch(0.177 0.029 265.8)\",\n    foreground: \"oklch(0.984 0.003 247.9)\",\n    card: \"oklch(0.206 0.039 265.5)\",\n    \"card-foreground\": \"oklch(0.984 0.003 247.9)\",\n    popover: \"oklch(0.206 0.039 265.5)\",\n    \"popover-foreground\": \"oklch(0.984 0.003 247.9)\",\n    primary: \"oklch(0.626 0.186 259.6)\",\n    \"primary-foreground\": \"oklch(0.206 0.039 265.5)\",\n    secondary: \"oklch(0.291 0.022 259.9)\",\n    \"secondary-foreground\": \"oklch(0.984 0.003 247.9)\",\n    accent: \"oklch(0.803 0.15 74.7)\",\n    \"accent-foreground\": \"oklch(0.206 0.039 265.5)\",\n    muted: \"oklch(0.291 0.022 259.9)\",\n    \"muted-foreground\": \"oklch(0.71 0.035 256.8)\",\n    border: \"oklch(0.329 0.026 259.9)\",\n    input: \"oklch(0.291 0.022 259.9)\",\n    ring: \"oklch(0.626 0.186 259.6)\",\n    success: \"oklch(0.814 0.192 155.7)\",\n    \"success-foreground\": \"oklch(0.206 0.039 265.5)\",\n    warning: \"oklch(0.77 0.165 70.6)\",\n    \"warning-foreground\": \"oklch(0.206 0.039 265.5)\",\n    destructive: \"oklch(0.677 0.213 15.6)\",\n    \"destructive-foreground\": \"oklch(0.206 0.039 265.5)\",\n    info: \"oklch(0.732 0.142 254.4)\",\n    \"info-foreground\": \"oklch(0.206 0.039 265.5)\",\n    \"status-online\": \"oklch(0.814 0.192 155.7)\",\n    \"status-online-foreground\": \"oklch(0.206 0.039 265.5)\",\n    \"status-offline\": \"oklch(0.677 0.213 15.6)\",\n    \"status-offline-foreground\": \"oklch(0.206 0.039 265.5)\",\n    \"status-degraded\": \"oklch(0.77 0.165 70.6)\",\n    \"status-degraded-foreground\": \"oklch(0.206 0.039 265.5)\",\n    \"status-info\": \"oklch(0.732 0.142 254.4)\",\n    \"status-info-foreground\": \"oklch(0.206 0.039 265.5)\",\n  },\n};\n"
-    },
-    {
-      "path": "themes/aurora-terminal.ts",
-      "type": "registry:lib",
-      "target": "themes/aurora-terminal.ts",
-      "content": "import type { Theme } from \"@/themes/types\";\n\n/**\n * Aurora Terminal — dark-first, cyan-aurora primary, Geist Mono everywhere.\n *\n * Identity: deep oceanic background, cyan-aurora primary, aurora-pink accent.\n * Headers use Geist with heavier tracking; body uses Geist Mono for full\n * \"developer console\" feel. Suits CLI/devtools showcase.\n */\nexport const auroraTerminal: Theme = {\n  name: \"aurora-terminal\",\n  label: \"Aurora Terminal\",\n  description: \"Dark sci-fi developer console — cyan-aurora + Geist Mono body.\",\n  fonts: {\n    display: '\"Geist\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif',\n    body: '\"Geist\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif',\n    mono: '\"Geist Mono\", ui-monospace, SFMono-Regular, Menlo, monospace',\n  },\n  fontUrls: [\n    \"https://fonts.googleapis.com/css2?family=Geist:wght@100..900&family=Geist+Mono:wght@100..900&display=swap\",\n  ],\n  light: {\n    background: \"oklch(0.966 0.006 264.5)\",\n    foreground: \"oklch(0.206 0.039 265.5)\",\n    card: \"oklch(1 0 0)\",\n    \"card-foreground\": \"oklch(0.206 0.039 265.5)\",\n    popover: \"oklch(1 0 0)\",\n    \"popover-foreground\": \"oklch(0.206 0.039 265.5)\",\n    primary: \"oklch(0.714 0.12 191)\",\n    \"primary-foreground\": \"oklch(0.206 0.039 265.5)\",\n    secondary: \"oklch(0.968 0.007 247.9)\",\n    \"secondary-foreground\": \"oklch(0.206 0.039 265.5)\",\n    accent: \"oklch(0.646 0.206 4.9)\",\n    \"accent-foreground\": \"oklch(1 0 0)\",\n    muted: \"oklch(0.926 0.013 255)\",\n    \"muted-foreground\": \"oklch(0.556 0.04 256.8)\",\n    border: \"oklch(0.926 0.013 255)\",\n    input: \"oklch(0.926 0.013 255)\",\n    ring: \"oklch(0.714 0.12 191)\",\n    success: \"oklch(0.711 0.171 155.2)\",\n    \"success-foreground\": \"oklch(1 0 0)\",\n    warning: \"oklch(0.67 0.154 60.6)\",\n    \"warning-foreground\": \"oklch(1 0 0)\",\n    destructive: \"oklch(0.579 0.214 27.2)\",\n    \"destructive-foreground\": \"oklch(1 0 0)\",\n    info: \"oklch(0.626 0.186 259.6)\",\n    \"info-foreground\": \"oklch(1 0 0)\",\n    \"status-online\": \"oklch(0.711 0.171 155.2)\",\n    \"status-online-foreground\": \"oklch(1 0 0)\",\n    \"status-offline\": \"oklch(0.579 0.214 27.2)\",\n    \"status-offline-foreground\": \"oklch(1 0 0)\",\n    \"status-degraded\": \"oklch(0.67 0.154 60.6)\",\n    \"status-degraded-foreground\": \"oklch(1 0 0)\",\n    \"status-info\": \"oklch(0.626 0.186 259.6)\",\n    \"status-info-foreground\": \"oklch(1 0 0)\",\n  },\n  dark: {\n    background: \"oklch(0.169 0.021 268.7)\",\n    foreground: \"oklch(0.966 0.006 264.5)\",\n    card: \"oklch(0.199 0.027 268.5)\",\n    \"card-foreground\": \"oklch(0.966 0.006 264.5)\",\n    popover: \"oklch(0.199 0.027 268.5)\",\n    \"popover-foreground\": \"oklch(0.966 0.006 264.5)\",\n    primary: \"oklch(0.834 0.122 191.9)\",\n    \"primary-foreground\": \"oklch(0.169 0.021 268.7)\",\n    secondary: \"oklch(0.242 0.03 266.3)\",\n    \"secondary-foreground\": \"oklch(0.966 0.006 264.5)\",\n    accent: \"oklch(0.68 0.2 3.6)\",\n    \"accent-foreground\": \"oklch(0.169 0.021 268.7)\",\n    muted: \"oklch(0.242 0.03 266.3)\",\n    \"muted-foreground\": \"oklch(0.71 0.035 256.8)\",\n    border: \"oklch(0.281 0.035 266.3)\",\n    input: \"oklch(0.242 0.03 266.3)\",\n    ring: \"oklch(0.834 0.122 191.9)\",\n    success: \"oklch(0.814 0.192 155.7)\",\n    \"success-foreground\": \"oklch(0.169 0.021 268.7)\",\n    warning: \"oklch(0.77 0.165 70.6)\",\n    \"warning-foreground\": \"oklch(0.169 0.021 268.7)\",\n    destructive: \"oklch(0.677 0.213 15.6)\",\n    \"destructive-foreground\": \"oklch(0.169 0.021 268.7)\",\n    info: \"oklch(0.732 0.142 254.4)\",\n    \"info-foreground\": \"oklch(0.169 0.021 268.7)\",\n    \"status-online\": \"oklch(0.814 0.192 155.7)\",\n    \"status-online-foreground\": \"oklch(0.169 0.021 268.7)\",\n    \"status-offline\": \"oklch(0.677 0.213 15.6)\",\n    \"status-offline-foreground\": \"oklch(0.169 0.021 268.7)\",\n    \"status-degraded\": \"oklch(0.77 0.165 70.6)\",\n    \"status-degraded-foreground\": \"oklch(0.169 0.021 268.7)\",\n    \"status-info\": \"oklch(0.732 0.142 254.4)\",\n    \"status-info-foreground\": \"oklch(0.169 0.021 268.7)\",\n  },\n};\n"
-    },
-    {
-      "path": "themes/theme-provider.tsx",
-      "type": "registry:lib",
-      "target": "themes/theme-provider.tsx",
-      "content": "import {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport type { JSX, ReactNode } from \"react\";\nimport { isDev } from \"@/lib/env\";\nimport { safeHref } from \"@/lib/safe-href\";\nimport { COLOR_VALUE_PATTERN } from \"./color-value-pattern\";\nimport { type Density, DensityContext, injectDensityCss } from \"./density\";\nimport { formatThemeIssues, validateTheme } from \"./schema\";\nimport type { ColorScale, Theme, ThemeMode } from \"@/themes/types\";\n\ninterface ThemeContextValue {\n  /** Active theme (full descriptor). */\n  theme: Theme;\n  /** Active mode: light or dark. */\n  mode: ThemeMode;\n  /** All available themes. */\n  themes: Theme[];\n  /** Swap the active theme by name. */\n  setTheme: (name: string) => void;\n  /** Set light/dark explicitly. */\n  setMode: (mode: ThemeMode) => void;\n  /** Toggle light <> dark. */\n  toggleMode: () => void;\n  /** Register an additional theme at runtime. */\n  registerTheme: (theme: Theme) => void;\n}\n\nconst ThemeContext = createContext<ThemeContextValue | undefined>(undefined);\n\nconst STYLE_ELEMENT_ID = \"theo-ui-theme-vars\";\n\n// T3.2 (SEC-001): allowlist validators for theme values. injectThemeCss\n// interpolates theme name + color values + font families into a <style>\n// textContent. Without validation, a theme object from an untrusted source\n// (e.g., a feature-flag service, a CMS) could inject arbitrary CSS via\n// closing the declaration with `}` or smuggling `url(...)` for exfiltration.\n// We reject rather than escape: themes are code, not user input. Invalid\n// values cause a dev-time throw (caller sees the problem); production\n// silently substitutes a safe fallback so a misconfigured theme can't\n// crash the app.\n\n// COLOR_VALUE_PATTERN was inlined here pre-T2.5. Now extracted to\n// `color-value-pattern.ts` so the regex is reusable by the Valibot schema (T2.7)\n// and so the OKLCH relative-color syntax (`oklch(from var(--x) calc(l - 0.16) c h)`,\n// required by T3.1 tonal derivations) is supported without expanding the inline\n// regex monolith. See EC-5 in the edge-case review.\n\n// Font family: word chars, spaces, commas, hyphens, dots, quotes. Excludes\n// parens (blocks `url(...)`) and semicolons (blocks declaration breakouts).\nconst FONT_FAMILY_PATTERN = /^[\\w\\s,\"'\\-.]+$/;\n\n// Theme name: kebab-case identifier. Excludes anything that could break out\n// of an attribute selector or inject additional rules.\nconst THEME_NAME_PATTERN = /^[a-z][a-z0-9-]*$/;\n\nconst IS_DEV = isDev();\n\nfunction rejectOrFallback(scope: string, value: string, fallback: string): string {\n  if (IS_DEV) {\n    throw new Error(\n      `[@theokit/ui] invalid ${scope} value: ${JSON.stringify(value)}. Theme values must match the allowlist (see src/themes/theme-provider.tsx). Refusing to inject potentially unsafe CSS.`,\n    );\n  }\n  return fallback;\n}\n\nfunction validatedColor(token: string, value: string): string {\n  if (COLOR_VALUE_PATTERN.test(value)) return value;\n  return rejectOrFallback(`color \"${token}\"`, value, \"transparent\");\n}\n\nfunction validatedFontFamily(slot: string, value: string): string {\n  if (FONT_FAMILY_PATTERN.test(value)) return value;\n  return rejectOrFallback(`fontFamily \"${slot}\"`, value, \"inherit\");\n}\n\nfunction validatedThemeName(value: string): string {\n  if (THEME_NAME_PATTERN.test(value)) return value;\n  return rejectOrFallback(\"theme.name\", value, \"invalid-theme\");\n}\n\nfunction colorScaleToCss(name: string, mode: ThemeMode, colors: ColorScale): string {\n  const safeName = validatedThemeName(name);\n  const selector =\n    mode === \"light\"\n      ? `[data-theme=\"${safeName}\"]`\n      : `[data-theme=\"${safeName}\"].dark, [data-theme=\"${safeName}\"][data-mode=\"dark\"]`;\n  const decls = Object.entries(colors)\n    .map(([token, value]) => `  --${token}: ${validatedColor(token, value)};`)\n    .join(\"\\n\");\n  return `${selector} {\\n${decls}\\n}`;\n}\n\nfunction fontsToCss(name: string, fonts: Theme[\"fonts\"]): string {\n  const safeName = validatedThemeName(name);\n  const display = validatedFontFamily(\"display\", fonts.display);\n  const body = validatedFontFamily(\"body\", fonts.body);\n  const mono = validatedFontFamily(\"mono\", fonts.mono);\n  return `[data-theme=\"${safeName}\"] {\\n  --font-display: ${display};\\n  --font-body: ${body};\\n  --font-mono: ${mono};\\n}`;\n}\n\nfunction injectThemeCss(themes: Theme[]): void {\n  if (typeof document === \"undefined\") return;\n  let style = document.getElementById(STYLE_ELEMENT_ID) as HTMLStyleElement | null;\n  if (!style) {\n    style = document.createElement(\"style\");\n    style.id = STYLE_ELEMENT_ID;\n    document.head.appendChild(style);\n  }\n  const blocks: string[] = [];\n  for (const theme of themes) {\n    blocks.push(fontsToCss(theme.name, theme.fonts));\n    blocks.push(colorScaleToCss(theme.name, \"light\", theme.light));\n    blocks.push(colorScaleToCss(theme.name, \"dark\", theme.dark));\n  }\n  style.textContent = blocks.join(\"\\n\\n\");\n}\n\n/**\n * loadThemeFonts — idempotently inject `<link rel=\"stylesheet\">` for each\n * font URL declared by the theme.\n *\n * T4.2: the previous implementation kept a module-level `Set` to track\n * already-injected URLs. That singleton broke test isolation (state\n * leaked across renders) and silently skipped injection in micro-frontend\n * setups with multiple `<ThemeProvider>` mounts. Replaced with a DOM\n * check: we query `document.head` for an existing link with the same\n * `href` before appending a new one. The DOM is the single source of\n * truth; no shared state across instances.\n */\nfunction loadThemeFonts(theme: Theme): void {\n  if (typeof document === \"undefined\") return;\n  if (!theme.fontUrls) return;\n  for (const url of theme.fontUrls) {\n    // Re-audit NEW-001 (SSRF, LOW): defang dangerous protocols on\n    // consumer-provided font URLs. Built-in themes use\n    // fonts.googleapis.com/gstatic.com — safe. registerTheme accepts\n    // arbitrary objects at runtime; a malicious theme could try to inject\n    // javascript:/data:text/html via fontUrls. safeHref returns undefined\n    // for dangerous protocols, which we skip silently.\n    const safe = safeHref(url);\n    if (!safe) continue;\n    if (document.head.querySelector(`link[rel=\"stylesheet\"][href=\"${CSS.escape(safe)}\"]`)) {\n      continue;\n    }\n    const link = document.createElement(\"link\");\n    link.rel = \"stylesheet\";\n    link.href = safe;\n    document.head.appendChild(link);\n  }\n}\n\ninterface ThemeProviderProps {\n  children: ReactNode;\n  /**\n   * Theme to start with. Must match the `name` of an entry in `themes`.\n   * Defaults to `\"violet-forge\"` for backward compat — if you don't pass\n   * `violet-forge` in `themes`, set this prop explicitly.\n   */\n  defaultTheme?: string;\n  /** Mode to start with. Defaults to `\"dark\"` (library is dark-first). */\n  defaultMode?: ThemeMode;\n  /**\n   * Available themes. **Required**: ThemeProvider does not auto-include any\n   * built-in theme since v0.1.0-next.0 — pass `builtinThemes` for all three\n   * Violet Forge defaults, or your own array for a slimmer bundle.\n   *\n   * Migration: consumers previously calling `<ThemeProvider>` without this\n   * prop now must pass `themes={builtinThemes}` (or use `<TheoUIProvider>`\n   * which defaults to `builtinThemes` for you).\n   */\n  themes: Theme[];\n  /**\n   * Persist selection in localStorage under this key. Pass `null` to disable.\n   * Default: \"theo-ui:theme\".\n   */\n  storageKey?: string | null;\n  /**\n   * Initial density. Drives `data-density` on `<html>` and the `--theo-control-h`\n   * / `--theo-control-px` CSS vars consumed by form-control `md` variants.\n   * Defaults to `\"comfortable\"` (36px controls — FAANG-tier modern density).\n   * Plan: faang-density-tightening (D3).\n   */\n  defaultDensity?: Density;\n  /**\n   * Respect the consumer's OS `prefers-color-scheme` preference on initial\n   * mount (D6 / T5.1). When `true` (default) and no theme-mode is stored in\n   * `localStorage[storageKey]`, the provider reads\n   * `matchMedia('(prefers-color-scheme: dark)')` and subscribes to changes.\n   * User-driven `setMode()` overrides the system signal — subsequent OS\n   * changes are ignored after the user fixes a preference.\n   *\n   * Pass `false` to force `defaultMode` regardless of the system preference.\n   * EC-12: matchMedia listener is cleaned up on unmount.\n   */\n  respectSystemMode?: boolean;\n}\n\n/**\n * Storage failure diagnostic — dev-only one-line warn so engineers see\n * something when localStorage throws (Safari private mode, blocked\n * third-party cookies, sandboxed iframes). In production we stay silent;\n * runtime behavior is fail-safe (state still lives in memory).\n *\n * Per HIGH-006: silent catches diverge from the \"fail loud\" principle\n * declared in the global CLAUDE.md. We accept silence in prod because the\n * fallback is correct, but we surface a single warn per call site in dev.\n */\nfunction warnStorageFailure(scope: string, err: unknown): void {\n  if (!isDev()) return;\n  // biome-ignore lint/suspicious/noConsole: dev-only diagnostic for storage failures (HIGH-006)\n  console.warn(`[@theokit/ui] theme storage failure (${scope}):`, err);\n}\n\n// T2.7: production-mode diagnostic for invalid themes that fall through\n// dev-time throw. Single console.warn so engineer sees something instead of\n// total silence; theme is kept in the array but per-value regex fallback\n// substitutes `transparent` for unsafe values downstream.\nfunction warnInvalidTheme(message: string): void {\n  // biome-ignore lint/suspicious/noConsole: dev/prod diagnostic for invalid theme (T2.7/D5)\n  console.warn(message);\n}\n\n/**\n * ThemeProvider — central registry + runtime switcher for Theo themes.\n *\n * Behavior:\n *   1. On mount, injects a `<style id=\"theo-ui-theme-vars\">` element with\n *      one CSS block per theme (`[data-theme=\"<name>\"] { --token: ... }`).\n *   2. Sets `data-theme` and `data-mode` on `<html>` so any element nested\n *      below inherits the right tokens (the Tailwind config consumes them).\n *   3. Lazy-loads theme font URLs by injecting `<link rel=\"stylesheet\">`.\n *   4. Optionally persists choice in localStorage.\n */\nfunction ThemeProvider({\n  children,\n  defaultTheme = \"violet-forge\",\n  defaultMode = \"dark\",\n  themes: themesProp,\n  storageKey = \"theo-ui:theme\",\n  defaultDensity = \"comfortable\",\n  respectSystemMode = true,\n}: ThemeProviderProps): JSX.Element {\n  // Themes prop is required since v0.1.0-next.0 — see migration note in\n  // the JSDoc on ThemeProviderProps. Pass `builtinThemes` for the legacy\n  // default behavior (violet-forge + classic-paper + aurora-terminal), or\n  // an array of your own. Empty array is rejected: ThemeProvider has no\n  // valid state without at least one registered theme.\n  if (!themesProp || themesProp.length === 0) {\n    throw new Error(\n      \"<ThemeProvider> requires the `themes` prop with at least one Theme. \" +\n        \"Pass `themes={builtinThemes}` for the Violet Forge defaults (importable \" +\n        \"via the package barrel), or use <TheoUIProvider> which sets this for you.\",\n    );\n  }\n\n  // T3.2 (SEC-001): eager validation. Calling validatedColor/FontFamily/\n  // ThemeName here ensures CSS-injection attempts throw at construction\n  // time rather than inside the deferred useEffect that injects the\n  // <style>. Production-mode fallbacks keep the app rendering even if a\n  // theme has bad values.\n  //\n  // Re-audit NEW-3: wrapped in useMemo so the validation cost (O(themes *\n  // tokens), ~60 ops per built-in theme) only runs when themesProp's\n  // reference changes — not on every parent re-render. Consumers passing\n  // inline array literals (`themes={[violetForge, classicPaper]}`) would\n  // otherwise pay this on every parent update.\n  const mergedThemes = useMemo<Theme[]>(() => {\n    // T2.7 (D5): valibot shape validation runs FIRST — catches missing keys,\n    // wrong types, malformed font URLs. Existing per-value regex validation\n    // below stays as the second defense layer against CSS injection.\n    for (const t of themesProp) {\n      const result = validateTheme(t);\n      if (!result.success) {\n        const message = formatThemeIssues(\n          (t as { name?: string }).name ?? \"(unnamed)\",\n          result.issues ?? [],\n        );\n        if (IS_DEV) throw new Error(message);\n        warnInvalidTheme(message);\n        // In production we keep the theme array intact; the per-value regex\n        // fallbacks below will substitute `transparent` for any value that\n        // still fails the second layer, so the app continues rendering.\n      }\n    }\n    for (const t of themesProp) {\n      validatedThemeName(t.name);\n      validatedFontFamily(\"display\", t.fonts.display);\n      validatedFontFamily(\"body\", t.fonts.body);\n      validatedFontFamily(\"mono\", t.fonts.mono);\n      for (const [token, value] of Object.entries(t.light)) {\n        validatedColor(token, value);\n      }\n      for (const [token, value] of Object.entries(t.dark)) {\n        validatedColor(token, value);\n      }\n    }\n    // Dedup by theme name; last writer wins (allows registerTheme override).\n    const map = new Map<string, Theme>();\n    for (const t of themesProp) map.set(t.name, t);\n    return Array.from(map.values());\n  }, [themesProp]);\n\n  const [themes, setThemes] = useState<Theme[]>(mergedThemes);\n\n  // Re-sync state when the `themes` prop changes between renders. Avoids the\n  // common pitfall where the user passes a different array later and the\n  // initial-state-only seed silently ignores the change.\n  useEffect(() => {\n    setThemes(mergedThemes);\n  }, [mergedThemes]);\n\n  // SSR-safe initialization (0.6.3-next.0 hydration-mismatch fix).\n  //\n  // Previously: `useState(() => localStorage.getItem(…))`. The initializer\n  // ran on BOTH server (no `window`, returned default) AND client at\n  // hydration time (with `window`, returned the stored value). The two\n  // results disagreed → React threw a hydration error on every page load\n  // for any user who had previously changed themes, and re-rendered the\n  // entire tree from scratch — defeating SSR.\n  //\n  // Fix: initialize with the SSR default ALWAYS. Promote to the stored\n  // value in a post-mount `useEffect` below. The 1-frame visual flicker\n  // is mitigated by the optional `<ThemeScript>` component, which sets\n  // `data-theme` / `data-mode` / `data-density` on `<html>` before React\n  // hydrates — see `theme-script.tsx`.\n  //\n  // The `hydratedRef` flag below guards the persist effect so that\n  // first-mount writes (with the SSR default values) don't clobber the\n  // user's stored preference in the brief window between mount and the\n  // post-mount hydration effect.\n  const [themeName, setThemeName] = useState<string>(defaultTheme);\n  const [mode, setModeState] = useState<ThemeMode>(defaultMode);\n  const [density, setDensityState] = useState<Density>(defaultDensity);\n\n  // T5.1 / D6: track whether the user has explicitly fixed the mode via\n  // setMode / toggleMode. Once true, OS prefers-color-scheme changes do\n  // NOT override the user's choice.\n  const userOverrodeModeRef = useRef(false);\n\n  // First-run guard for the persist effect below. On initial mount the\n  // state is the SSR-safe default; we MUST NOT clobber the user's stored\n  // preference with that default before the post-mount hydration effect\n  // can promote it. After the first persist-effect call returns early,\n  // every subsequent change (post-hydration setState OR user-driven)\n  // persists normally.\n  const skipFirstPersistRef = useRef(true);\n\n  // Post-mount hydration: read localStorage and promote stored values to\n  // state. Runs ONCE on mount. If `storageKey` is null or no value is\n  // stored, this is a no-op — state stays at the SSR defaults.\n  useEffect(() => {\n    if (typeof window === \"undefined\" || !storageKey) return;\n    try {\n      const storedName = window.localStorage.getItem(`${storageKey}:name`);\n      const storedMode = window.localStorage.getItem(`${storageKey}:mode`);\n      const storedDensity = window.localStorage.getItem(`${storageKey}:density`);\n      if (storedName) setThemeName(storedName);\n      if (storedMode === \"dark\" || storedMode === \"light\") {\n        setModeState(storedMode);\n        // Stored value implies user fixed a preference at some point.\n        userOverrodeModeRef.current = true;\n      }\n      if (\n        storedDensity === \"compact\" ||\n        storedDensity === \"comfortable\" ||\n        storedDensity === \"spacious\"\n      ) {\n        setDensityState(storedDensity);\n      }\n    } catch (err) {\n      warnStorageFailure(\"read theme + mode + density\", err);\n    }\n  }, [storageKey]);\n\n  // T5.1 / D6 / EC-12: subscribe to OS prefers-color-scheme when\n  // respectSystemMode is true. On mount, if user has NOT overridden the\n  // mode (no stored preference), align with the OS signal. Re-aligns on\n  // OS changes UNLESS user explicitly fixed a preference. Cleanup on\n  // unmount via removeEventListener (EC-12) to avoid listener leaks in\n  // micro-frontend scenarios.\n  useEffect(() => {\n    if (!respectSystemMode) return;\n    if (typeof window === \"undefined\" || typeof window.matchMedia !== \"function\") return;\n    const mql = window.matchMedia(\"(prefers-color-scheme: dark)\");\n    // Align on first run if user hasn't overridden.\n    if (!userOverrodeModeRef.current) {\n      setModeState(mql.matches ? \"dark\" : \"light\");\n    }\n    const onChange = (event: MediaQueryListEvent): void => {\n      if (!userOverrodeModeRef.current) {\n        setModeState(event.matches ? \"dark\" : \"light\");\n      }\n    };\n    mql.addEventListener(\"change\", onChange);\n    return () => {\n      mql.removeEventListener(\"change\", onChange);\n    };\n  }, [respectSystemMode]);\n\n  // Inject CSS vars whenever the themes list changes.\n  useEffect(() => {\n    injectThemeCss(themes);\n  }, [themes]);\n\n  // Apply data-theme + data-mode + data-density to <html>, load fonts,\n  // inject density CSS vars.\n  useEffect(() => {\n    if (typeof document === \"undefined\") return;\n    const active = themes.find((t) => t.name === themeName) ?? themes[0];\n    if (!active) return;\n    document.documentElement.setAttribute(\"data-theme\", active.name);\n    document.documentElement.setAttribute(\"data-mode\", mode);\n    document.documentElement.setAttribute(\"data-density\", density);\n    document.documentElement.classList.toggle(\"dark\", mode === \"dark\");\n    loadThemeFonts(active);\n    injectDensityCss();\n  }, [themeName, mode, density, themes]);\n\n  // Persist on change.\n  //\n  // The first run is SKIPPED via `skipFirstPersistRef`: state at mount\n  // is the SSR-safe default. If we wrote it to storage immediately,\n  // we'd clobber the user's stored preference between mount and the\n  // post-mount hydration effect that promotes the stored value. After\n  // the first call, every subsequent run persists — whether the change\n  // came from the hydration effect (no-op write back of the stored\n  // value) or a user-driven `setTheme` / `toggleMode` / `setDensity`.\n  useEffect(() => {\n    if (skipFirstPersistRef.current) {\n      skipFirstPersistRef.current = false;\n      return;\n    }\n    if (typeof window === \"undefined\" || !storageKey) return;\n    try {\n      window.localStorage.setItem(`${storageKey}:name`, themeName);\n      window.localStorage.setItem(`${storageKey}:mode`, mode);\n      window.localStorage.setItem(`${storageKey}:density`, density);\n    } catch (err) {\n      // Storage may fail in private mode; behavior remains correct (state\n      // lives in memory). Per HIGH-006 we surface a one-time dev warning so\n      // the engineer sees something instead of complete silence.\n      warnStorageFailure(\"persist theme + mode + density\", err);\n    }\n  }, [themeName, mode, density, storageKey]);\n\n  const setTheme = useCallback((name: string) => setThemeName(name), []);\n  const setMode = useCallback((next: ThemeMode) => {\n    // T5.1 / D6: fix the user preference; subsequent system changes no longer override.\n    userOverrodeModeRef.current = true;\n    setModeState(next);\n  }, []);\n  const toggleMode = useCallback(() => {\n    userOverrodeModeRef.current = true;\n    setModeState((cur) => (cur === \"light\" ? \"dark\" : \"light\"));\n  }, []);\n  const setDensity = useCallback((next: Density) => setDensityState(next), []);\n  const registerTheme = useCallback((theme: Theme) => {\n    setThemes((cur) => {\n      const idx = cur.findIndex((t) => t.name === theme.name);\n      if (idx >= 0) {\n        const next = cur.slice();\n        next[idx] = theme;\n        return next;\n      }\n      return [...cur, theme];\n    });\n  }, []);\n\n  // themes[0] is guaranteed non-undefined by the constructor-time check\n  // above (themesProp is non-empty); the non-null assert encodes that\n  // invariant for TypeScript, which can't trace it through useState.\n  // biome-ignore lint/style/noNonNullAssertion: T2.5 runtime invariant — themesProp non-empty validated at top of function\n  const active = themes.find((t) => t.name === themeName) ?? themes[0]!;\n\n  const value = useMemo<ThemeContextValue>(\n    () => ({\n      theme: active,\n      mode,\n      themes,\n      setTheme,\n      setMode,\n      toggleMode,\n      registerTheme,\n    }),\n    [active, mode, themes, setTheme, setMode, toggleMode, registerTheme],\n  );\n\n  const densityValue = useMemo(() => ({ density, setDensity }), [density, setDensity]);\n\n  return (\n    <ThemeContext.Provider value={value}>\n      <DensityContext.Provider value={densityValue}>{children}</DensityContext.Provider>\n    </ThemeContext.Provider>\n  );\n}\n\n/**\n * useTheme — access theme state from any component inside <ThemeProvider>.\n * Throws if used outside the provider — fail-fast.\n */\nfunction useTheme(): ThemeContextValue {\n  const ctx = useContext(ThemeContext);\n  if (!ctx) {\n    throw new Error(\"useTheme must be used inside <ThemeProvider>.\");\n  }\n  return ctx;\n}\n\nexport { ThemeProvider, useTheme };\n"
-    },
-    {
-      "path": "themes/theme-switcher.tsx",
-      "type": "registry:lib",
-      "target": "themes/theme-switcher.tsx",
-      "content": "import * as DropdownMenu from \"@radix-ui/react-dropdown-menu\";\nimport { Check, Moon, Palette, Sun } from \"lucide-react\";\nimport type { JSX } from \"react\";\nimport { cn } from \"@/lib/cn\";\nimport { useTheme } from \"@/themes/theme-provider\";\n\ninterface ThemeSwitcherProps {\n  className?: string;\n  /** If true, renders mode toggle inline next to the theme menu. */\n  showModeToggle?: boolean;\n}\n\n/**\n * ThemeSwitcher — drop-in theme + mode picker.\n *\n * Two affordances:\n *   - Palette dropdown lists all registered themes with the active marked.\n *   - Optional sun/moon button toggles light/dark.\n *\n * Stateless wrt itself — pulls state from `useTheme()`.\n */\nfunction ThemeSwitcher({ className, showModeToggle = true }: ThemeSwitcherProps): JSX.Element {\n  const { theme, themes, setTheme, mode, toggleMode } = useTheme();\n\n  return (\n    <div className={cn(\"inline-flex items-center gap-1\", className)}>\n      {/* LOW-006: announce theme + mode changes to assistive tech. The\n       * Provider applies tokens via `data-theme`/`data-mode` (visual cue),\n       * but screen-reader users get no feedback without this aria-live\n       * region. Polite so it doesn't interrupt the user's flow. */}\n      <span aria-live=\"polite\" aria-atomic=\"true\" className=\"sr-only\">\n        Theme: {theme.label}, mode: {mode}\n      </span>\n      <DropdownMenu.Root>\n        <DropdownMenu.Trigger asChild>\n          <button\n            type=\"button\"\n            aria-label={`Theme: ${theme.label}`}\n            className={cn(\n              \"inline-flex h-9 items-center gap-2 rounded-lg border border-border/60 bg-card px-3\",\n              \"font-medium font-sans text-body-sm text-foreground\",\n              \"transition-colors hover:bg-muted\",\n              \"focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background\",\n            )}\n          >\n            <Palette className=\"size-4 text-primary\" aria-hidden=\"true\" />\n            <span>{theme.label}</span>\n          </button>\n        </DropdownMenu.Trigger>\n        <DropdownMenu.Portal>\n          <DropdownMenu.Content\n            align=\"end\"\n            sideOffset={6}\n            className={cn(\n              \"z-50 min-w-[16rem] overflow-hidden rounded-lg border bg-popover p-1 text-popover-foreground shadow-md\",\n              \"data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95 data-[state=open]:animate-in\",\n              \"data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[state=closed]:animate-out\",\n            )}\n          >\n            {themes.map((t) => (\n              <DropdownMenu.Item\n                key={t.name}\n                onSelect={() => setTheme(t.name)}\n                className={cn(\n                  \"flex cursor-pointer items-start justify-between gap-3 rounded-md px-2 py-2\",\n                  \"focus:bg-muted focus:outline-none data-[highlighted]:bg-muted\",\n                )}\n              >\n                <span className=\"flex min-w-0 flex-col\">\n                  <span className=\"font-medium text-body-sm\">{t.label}</span>\n                  {t.description ? (\n                    <span className=\"text-body-sm text-muted-foreground\">{t.description}</span>\n                  ) : null}\n                </span>\n                {t.name === theme.name ? (\n                  <Check className=\"mt-1 size-4 shrink-0 text-primary\" aria-hidden=\"true\" />\n                ) : null}\n              </DropdownMenu.Item>\n            ))}\n          </DropdownMenu.Content>\n        </DropdownMenu.Portal>\n      </DropdownMenu.Root>\n\n      {showModeToggle ? (\n        <button\n          type=\"button\"\n          onClick={toggleMode}\n          aria-label={`Switch to ${mode === \"light\" ? \"dark\" : \"light\"} mode`}\n          className={cn(\n            \"inline-flex size-9 items-center justify-center rounded-lg border border-border/60 bg-card\",\n            \"text-foreground transition-colors hover:bg-muted\",\n            \"focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background\",\n          )}\n        >\n          {mode === \"light\" ? <Moon className=\"size-4\" /> : <Sun className=\"size-4\" />}\n        </button>\n      ) : null}\n    </div>\n  );\n}\n\nexport { ThemeSwitcher };\n"
-    },
-    {
-      "path": "themes/index.ts",
-      "type": "registry:lib",
-      "target": "themes/index.ts",
-      "content": "export type { ColorScale, Theme, ThemeFonts, ThemeMode } from \"@/themes/types\";\nexport { ThemeProvider, useTheme } from \"@/themes/theme-provider\";\nexport { ThemeScript } from \"@/themes/theme-script\";\nexport { ThemeSwitcher } from \"@/themes/theme-switcher\";\nexport { violetForge } from \"@/themes/violet-forge\";\nexport { classicPaper } from \"@/themes/classic-paper\";\nexport { auroraTerminal } from \"@/themes/aurora-terminal\";\nexport { defineTheme, type DefineThemeInput } from \"./define\";\nexport { hex, hexToHsl, rgb, rgbToHslLegacy } from \"./color\";\nexport { useDensity, type Density, type DensityContextValue } from \"./density\";\n// Seven new themes — RFC 0007, plan: seven-themes (2026-05-22).\n// Trademark-safe slugs (D1.1) — `*-style` / `*-mono` / `*-glass` suffixes,\n// description includes \"Inspired by, not affiliated with [X]\".\nexport { vercelMono } from \"./vercel-mono\";\nexport { githubDark } from \"./github-dark\";\nexport { dracula } from \"./dracula\";\nexport { oneDark } from \"./one-dark\";\nexport { anthropicStyle } from \"./anthropic-style\";\nexport { openaiStyle } from \"./openai-style\";\nexport { linearGlass } from \"./linear-glass\";\n\nimport { anthropicStyle } from \"./anthropic-style\";\nimport { auroraTerminal } from \"@/themes/aurora-terminal\";\nimport { classicPaper } from \"@/themes/classic-paper\";\nimport { dracula } from \"./dracula\";\nimport { githubDark } from \"./github-dark\";\nimport { linearGlass } from \"./linear-glass\";\nimport { oneDark } from \"./one-dark\";\nimport { openaiStyle } from \"./openai-style\";\nimport { vercelMono } from \"./vercel-mono\";\nimport { violetForge } from \"@/themes/violet-forge\";\n\n/**\n * All themes bundled with Theo UI. Pass to `<ThemeProvider themes={builtinThemes}>`\n * if you want all 10 available out of the box.\n *\n * EC-4 note: passing the full 10-entry list triggers ~60 KB CSS injection in\n * `<style id=\"theo-ui-theme-vars\">`. For apps focused on 1-2 themes, prefer\n * `themes={[violetForge, dracula]}` to keep the payload at ~12 KB.\n */\nexport const builtinThemes = [\n  violetForge,\n  classicPaper,\n  auroraTerminal,\n  vercelMono,\n  githubDark,\n  dracula,\n  oneDark,\n  anthropicStyle,\n  openaiStyle,\n  linearGlass,\n];\n"
-    }
-  ]
-}

package/registry/r/theme-script.json

@@ -1,18 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
-  "name": "theme-script",
-  "type": "registry:lib",
-  "title": "ThemeScript",
-  "description": "Inline script for SSR-safe theme initialization in Next.js / Astro / Remix. Place in <head> to read persisted theme + mode from localStorage BEFORE React hydrates, eliminating FOUC and hydration mismatch.",
-  "registryDependencies": [
-    "https://usetheodev.github.io/theo-ui/r/theme-provider.json"
-  ],
-  "files": [
-    {
-      "path": "themes/theme-script.tsx",
-      "type": "registry:lib",
-      "target": "themes/theme-script.tsx",
-      "content": "/**\n * ThemeScript — inline `<script>` for SSR-safe theme initialization.\n *\n * Renders a synchronous script that runs BEFORE React hydration. It reads the\n * persisted theme + mode from localStorage (or falls back to the defaults) and\n * sets `data-theme` / `data-mode` on `<html>`, plus the `.dark` class when\n * mode is dark. This eliminates FOUC and avoids hydration mismatch warnings\n * when the user's persisted choice differs from the SSR defaults.\n *\n * Place this in `<head>` ABOVE `<body>`. The component does not need to live\n * inside `<ThemeProvider>`.\n *\n * Security: every interpolated value is passed through `safe()`, which both\n * `JSON.stringify`s the value AND escapes `<` to `<`. The `<` escape is\n * REQUIRED because `JSON.stringify` alone does NOT escape `/`, so a payload\n * like `\"</script><script>alert(1)</script>\"` would otherwise break out of\n * the inline `<script>` tag even though it stays inside a JS string literal.\n * (The browser tokenizes `</script>` at the HTML layer before JS parses.)\n *\n * Example (Next.js App Router): see docs/design-system.md → SSR section.\n * Pass `defaultTheme` and `defaultMode` to align with the consumer's\n * preferred initial state. Always wrap the root in `<html\n * suppressHydrationWarning>` to silence the expected one-render diff.\n */\nimport type { JSX } from \"react\";\nimport type { ThemeMode } from \"@/themes/types\";\n\ninterface ThemeScriptProps {\n  /** Theme name to apply when no persisted value exists. Default `\"violet-forge\"`. */\n  defaultTheme?: string;\n  /** Mode to apply when no persisted value exists. Default `\"dark\"`. */\n  defaultMode?: ThemeMode;\n  /**\n   * Density to apply when no persisted value exists. Default `\"comfortable\"`.\n   * Mirrors `ThemeProvider`'s `defaultDensity` so the inline-script and\n   * the React provider agree on the SSR-default density (and the\n   * `data-density` attribute set by this script matches what\n   * `ThemeProvider` promotes via its post-mount hydration effect).\n   */\n  defaultDensity?: \"compact\" | \"comfortable\" | \"spacious\";\n  /**\n   * localStorage namespace. Must match the `storageKey` passed to\n   * `<ThemeProvider>`. Default `\"theo-ui:theme\"`. Pass `null` to disable\n   * persistence reads (the script will always apply defaults).\n   */\n  storageKey?: string | null;\n}\n\n/**\n * Encode a value for safe embedding inside an inline `<script>` block.\n *\n * `JSON.stringify` does NOT escape `/` by default, so `\"</script>\"` survives\n * as the literal three-character sequence inside the resulting string. When\n * that string is then rendered inside `<script>...</script>`, the browser's\n * HTML tokenizer sees `</script>` and ends the script tag — regardless of\n * whether the JS parser would have kept it inside a string. Escaping `<` to\n * its Unicode escape `<` preserves JS semantics (the JS parser still\n * resolves the escape to `<`) while making the HTML tokenizer happy.\n *\n * Reference: OWASP \"JSON-in-script\" guidance; React's own server-renderer\n * applies the same escape for inline JSON.\n */\nfunction safe(value: unknown): string {\n  return JSON.stringify(value).replace(/</g, \"\\\\u003c\");\n}\n\nfunction buildScript(\n  defaultTheme: string,\n  defaultMode: ThemeMode,\n  defaultDensity: \"compact\" | \"comfortable\" | \"spacious\",\n  storageKey: string | null,\n): string {\n  const k = safe(storageKey);\n  const t = safe(defaultTheme);\n  const m = safe(defaultMode);\n  const dn = safe(defaultDensity);\n  return `(function(){try{var k=${k};var d=document.documentElement;var t=null;var m=null;var dn=null;if(k){t=localStorage.getItem(k+\":name\");m=localStorage.getItem(k+\":mode\");dn=localStorage.getItem(k+\":density\");}d.setAttribute(\"data-theme\",t||${t});d.setAttribute(\"data-mode\",m||${m});d.setAttribute(\"data-density\",dn||${dn});if((m||${m})===\"dark\"){d.classList.add(\"dark\");}}catch(e){}})();`;\n}\n\nfunction ThemeScript({\n  defaultTheme = \"violet-forge\",\n  defaultMode = \"dark\",\n  defaultDensity = \"comfortable\",\n  storageKey = \"theo-ui:theme\",\n}: ThemeScriptProps): JSX.Element {\n  const code = buildScript(defaultTheme, defaultMode, defaultDensity, storageKey);\n  // biome-ignore lint/security/noDangerouslySetInnerHtml: payload is JSON.stringify-encoded literals (no user input); intentional for SSR theme bootstrap before React hydrates\n  return <script suppressHydrationWarning dangerouslySetInnerHTML={{ __html: code }} />;\n}\n\nexport { ThemeScript };\n"
-    }
-  ]
-}

package/registry/r/theo-ui-provider.json

@@ -1,20 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
-  "name": "theo-ui-provider",
-  "type": "registry:lib",
-  "title": "TheoUIProvider",
-  "description": "Primary entry-point provider — composes ThemeProvider + Toaster with sensible defaults. Use as the single root wrapper in consumer apps.",
-  "dependencies": [],
-  "registryDependencies": [
-    "https://usetheodev.github.io/theo-ui/r/theme-provider.json",
-    "https://usetheodev.github.io/theo-ui/r/toast.json"
-  ],
-  "files": [
-    {
-      "path": "theo-ui-provider.tsx",
-      "type": "registry:lib",
-      "target": "theo-ui-provider.tsx",
-      "content": "\"use client\";\n\nimport type { ComponentProps, JSX, ReactNode } from \"react\";\nimport { Toaster } from \"@/components/ui/toaster\";\nimport { builtinThemes } from \"@/themes/index\";\nimport { ThemeProvider } from \"@/themes/theme-provider\";\n\n/**\n * TheoUIProvider — primary entry point composing `<ThemeProvider>` and\n * `<Toaster>` in the correct order with sensible defaults.\n *\n * Recommended for consumer apps to avoid hand-wiring the provider stack.\n * Equivalent to:\n *\n *   <ThemeProvider themes={builtinThemes} {...theme}>\n *     <Toaster {...toaster}>{children}</Toaster>\n *   </ThemeProvider>\n *\n * Notes:\n *   - Since v0.1.0-next.0, `<ThemeProvider>` requires the `themes` prop\n *     (T2.5 decoupling). `<TheoUIProvider>` defaults it to `builtinThemes`\n *     to preserve \"works out of the box\" DX. Pass `theme.themes` to override.\n *   - The `\"use client\"` directive is required for Next.js App Router (RSC)\n *     because `<ThemeProvider>` uses React state and effects internally.\n *   - `<Tooltip>` provider stays per-instance (Radix recommendation) — this\n *     wrapper does NOT introduce a global tooltip context.\n *   - `<ThemeProvider>` and `<Toaster>` remain independently exported for\n *     consumers who want bespoke control.\n *\n * SSR:\n *   - Place `<ThemeScript>` in `<head>` to avoid FOUC + hydration mismatch.\n *   - Wrap `<html lang=\"en\" suppressHydrationWarning>`.\n *\n * @example\n *   import { TheoUIProvider } from \"@theokit/ui\";\n *\n *   export default function App({ children }) {\n *     return <TheoUIProvider>{children}</TheoUIProvider>;\n *   }\n */\nexport interface TheoUIProviderProps {\n  children: ReactNode;\n  /** Pass-through props for the inner `<ThemeProvider>`. Optional. */\n  theme?: Omit<ComponentProps<typeof ThemeProvider>, \"children\" | \"themes\"> & {\n    /** Override the default theme set (defaults to `builtinThemes`). */\n    themes?: ComponentProps<typeof ThemeProvider>[\"themes\"];\n  };\n  /** Pass-through props for the inner `<Toaster>`. */\n  toaster?: Omit<ComponentProps<typeof Toaster>, \"children\">;\n}\n\nexport function TheoUIProvider({ children, theme, toaster }: TheoUIProviderProps): JSX.Element {\n  const { themes, ...restTheme } = theme ?? {};\n  return (\n    <ThemeProvider themes={themes ?? builtinThemes} {...restTheme}>\n      <Toaster {...toaster}>{children}</Toaster>\n    </ThemeProvider>\n  );\n}\n\nTheoUIProvider.displayName = \"TheoUIProvider\";\n"
-    }
-  ]
-}

package/registry/r/timestamp.json

@@ -1,21 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
-  "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.",
-  "dependencies": [],
-  "registryDependencies": [
-    "https://usetheodev.github.io/theo-ui/r/cn.json",
-    "https://usetheodev.github.io/theo-ui/r/env.json",
-    "https://usetheodev.github.io/theo-ui/r/tailwind-preset.json"
-  ],
-  "files": [
-    {
-      "path": "components/primitives/timestamp/timestamp.tsx",
-      "type": "registry:ui",
-      "target": "components/ui/timestamp.tsx",
-      "content": "\"use client\";\n\nimport { forwardRef, useEffect, useState } from \"react\";\nimport type { TimeHTMLAttributes } from \"react\";\nimport { cn } from \"@/lib/cn\";\nimport { isDev } from \"@/lib/env\";\n\n/**\n * Timestamp — accessible relative/absolute time primitive.\n *\n * Renders a semantic `<time datetime>` element. Format modes:\n *   - `relative` (default) — \"just now\", \"5 minutes ago\", \"2 hours ago\",\n *     \"Dec 5\" (>7d), \"Dec 5, 2024\" (different year)\n *   - `absolute` — full localized date+time\n *   - `both` — \"Dec 5, 2026 (2 hours ago)\"\n *\n * Uses zero-dep `Intl.RelativeTimeFormat`. The tooltip on hover is the\n * HTML `title` attribute (not the `<Tooltip>` component) — keeps this\n * file a true primitive without sibling-primitive imports.\n *\n * Auto-refreshes via `setInterval` (default 60_000ms); pass\n * `refreshInterval={0}` to disable. `aria-label` always carries the\n * absolute time so screen readers read \"May 23, 2026 14:32 — posted\n * 2 hours ago\".\n *\n * @param value Source date — ISO string, Date object, or **Unix ms**\n *              (NOT seconds). Passing seconds renders ~1970.\n */\nexport interface TimestampProps extends Omit<TimeHTMLAttributes<HTMLTimeElement>, \"children\"> {\n  value: string | Date | number;\n  format?: \"relative\" | \"absolute\" | \"both\";\n  /** Auto-refresh interval when format=relative. Default 60000. 0 disables. */\n  refreshInterval?: number;\n  /** Locale for absolute formatting + Intl.RelativeTimeFormat. Default browser locale. */\n  locale?: string;\n  /** When true, omit the `title` tooltip. */\n  noTooltip?: boolean;\n}\n\nfunction toDate(value: string | Date | number): Date | null {\n  const d = value instanceof Date ? value : new Date(value);\n  return Number.isNaN(d.getTime()) ? null : d;\n}\n\nconst SEVEN_DAYS_MS = 7 * 24 * 60 * 60 * 1000;\nconst UNITS: Array<{ unit: Intl.RelativeTimeFormatUnit; ms: number }> = [\n  { unit: \"year\", ms: 365 * 24 * 60 * 60 * 1000 },\n  { unit: \"month\", ms: 30 * 24 * 60 * 60 * 1000 },\n  { unit: \"day\", ms: 24 * 60 * 60 * 1000 },\n  { unit: \"hour\", ms: 60 * 60 * 1000 },\n  { unit: \"minute\", ms: 60 * 1000 },\n];\n\nfunction safeRelativeFormatter(locale: string | undefined): Intl.RelativeTimeFormat | null {\n  try {\n    return new Intl.RelativeTimeFormat(locale, { numeric: \"auto\" });\n  } catch {\n    // EC-8: invalid locale tag — fall back to default locale.\n    if (isDev()) {\n      // biome-ignore lint/suspicious/noConsole: dev-only diagnostic.\n      console.warn(`<Timestamp locale=\"${locale}\">: invalid locale tag, falling back to default.`);\n    }\n    try {\n      return new Intl.RelativeTimeFormat(undefined, { numeric: \"auto\" });\n    } catch {\n      return null;\n    }\n  }\n}\n\nfunction safeAbsoluteFormat(date: Date, locale: string | undefined, withYear: boolean): string {\n  try {\n    return date.toLocaleDateString(locale, {\n      month: \"short\",\n      day: \"numeric\",\n      ...(withYear ? { year: \"numeric\" } : {}),\n    });\n  } catch {\n    return date.toLocaleDateString(undefined, {\n      month: \"short\",\n      day: \"numeric\",\n      ...(withYear ? { year: \"numeric\" } : {}),\n    });\n  }\n}\n\nfunction formatRelative(date: Date, now: Date, locale: string | undefined): string {\n  const diffMs = date.getTime() - now.getTime();\n  const absMs = Math.abs(diffMs);\n\n  if (absMs < 60_000) return \"just now\";\n\n  if (diffMs < 0 && absMs > SEVEN_DAYS_MS) {\n    const sameYear = date.getFullYear() === now.getFullYear();\n    return safeAbsoluteFormat(date, locale, !sameYear);\n  }\n\n  const rtf = safeRelativeFormatter(locale);\n  if (rtf === null) {\n    return safeAbsoluteFormat(date, locale, date.getFullYear() !== now.getFullYear());\n  }\n\n  for (const { unit, ms } of UNITS) {\n    if (absMs >= ms) {\n      return rtf.format(Math.round(diffMs / ms), unit);\n    }\n  }\n  return \"just now\";\n}\n\nfunction formatAbsolute(date: Date, locale: string | undefined): string {\n  try {\n    return date.toLocaleString(locale, {\n      year: \"numeric\",\n      month: \"short\",\n      day: \"numeric\",\n      hour: \"2-digit\",\n      minute: \"2-digit\",\n    });\n  } catch {\n    return date.toLocaleString(undefined, {\n      year: \"numeric\",\n      month: \"short\",\n      day: \"numeric\",\n      hour: \"2-digit\",\n      minute: \"2-digit\",\n    });\n  }\n}\n\nconst Timestamp = forwardRef<HTMLTimeElement, TimestampProps>(\n  (\n    {\n      className,\n      value,\n      format = \"relative\",\n      refreshInterval = 60_000,\n      locale,\n      noTooltip,\n      ...props\n    },\n    ref,\n  ) => {\n    const date = toDate(value);\n    const [now, setNow] = useState<Date>(() => new Date());\n\n    useEffect(() => {\n      if (format !== \"relative\" || refreshInterval === 0 || date === null) return;\n      const id = setInterval(() => setNow(new Date()), refreshInterval);\n      return () => clearInterval(id);\n    }, [format, refreshInterval, date]);\n\n    if (date === null) {\n      return (\n        <time\n          data-slot=\"timestamp\"\n          ref={ref}\n          className={cn(className)}\n          suppressHydrationWarning\n          {...props}\n        />\n      );\n    }\n\n    const iso = date.toISOString();\n    const absolute = formatAbsolute(date, locale);\n    const relative = formatRelative(date, now, locale);\n    const visibleText =\n      format === \"absolute\" ? absolute : format === \"both\" ? `${absolute} (${relative})` : relative;\n\n    return (\n      <time\n        data-slot=\"timestamp\"\n        ref={ref}\n        dateTime={iso}\n        title={noTooltip ? undefined : absolute}\n        aria-label={absolute}\n        suppressHydrationWarning\n        className={cn(className)}\n        {...props}\n      >\n        {visibleText}\n      </time>\n    );\n  },\n);\nTimestamp.displayName = \"Timestamp\";\n\nexport { Timestamp };\n"
-    }
-  ]
-}

package/registry/r/toast.json

@@ -1,30 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
-  "name": "toast",
-  "type": "registry:ui",
-  "title": "Toast",
-  "description": "Transient notification built on Radix Toast.",
-  "dependencies": [
-    "@radix-ui/react-toast",
-    "class-variance-authority",
-    "lucide-react"
-  ],
-  "registryDependencies": [
-    "https://usetheodev.github.io/theo-ui/r/cn.json",
-    "https://usetheodev.github.io/theo-ui/r/tailwind-preset.json"
-  ],
-  "files": [
-    {
-      "path": "components/primitives/toast/toast.tsx",
-      "type": "registry:ui",
-      "target": "components/ui/toast.tsx",
-      "content": "import * as ToastPrimitive from \"@radix-ui/react-toast\";\nimport { type VariantProps, cva } from \"class-variance-authority\";\nimport { AlertCircle, CheckCircle2, Info, TriangleAlert, X } from \"lucide-react\";\nimport { forwardRef } from \"react\";\nimport type { ComponentPropsWithoutRef, ElementRef, ReactNode } from \"react\";\nimport { cn } from \"@/lib/cn\";\n\n/**\n * Toast — transient notification built on Radix Toast.\n *\n * Composition: app mounts <Toaster /> once. Components call `toast(...)` via\n * the `useToast()` hook (see toaster.tsx). The look is theme-aware: status\n * icon coloured by --primary/--success/--warning/--destructive; the body\n * card uses --popover surface.\n *\n * Variants:\n *   - default (neutral)\n *   - info (primary tint)\n *   - success (deploy ok, action completed)\n *   - warning (queued, permission requested)\n *   - destructive (failed, fatal)\n */\n\nconst toastVariants = cva(\n  [\n    \"group pointer-events-auto relative flex w-full items-start gap-3 overflow-hidden rounded-lg border pr-10 shadow-md\",\n    \"data-[state=open]:slide-in-from-top-full data-[state=open]:fade-in-0 data-[state=open]:animate-in\",\n    \"data-[state=closed]:fade-out-80 data-[state=closed]:slide-out-to-right-full data-[state=closed]:animate-out\",\n    \"data-[swipe=cancel]:translate-x-0 data-[swipe=end]:translate-x-[var(--radix-toast-swipe-end-x)] data-[swipe=move]:translate-x-[var(--radix-toast-swipe-move-x)]\",\n    \"data-[swipe=end]:animate-out data-[swipe=cancel]:transition-[transform_var(--duration-base)] data-[swipe=move]:transition-none\",\n  ],\n  {\n    variants: {\n      variant: {\n        default: \"border-border/40 bg-popover text-popover-foreground\",\n        info: \"border-primary/40 bg-popover text-popover-foreground\",\n        success: \"border-success/40 bg-popover text-popover-foreground\",\n        warning: \"border-warning/40 bg-popover text-popover-foreground\",\n        destructive: \"border-destructive/50 bg-popover text-popover-foreground\",\n      },\n      size: {\n        sm: \"p-3 text-body-sm\",\n        md: \"p-4 text-body-md\",\n        lg: \"p-5 text-body-lg\",\n      },\n    },\n    defaultVariants: { variant: \"default\", size: \"md\" },\n  },\n);\n\nconst iconForVariant: Record<NonNullable<ToastVariant>, ReactNode> = {\n  default: <Info className=\"size-4 shrink-0 text-muted-foreground\" aria-hidden=\"true\" />,\n  info: <Info className=\"size-4 shrink-0 text-primary\" aria-hidden=\"true\" />,\n  success: <CheckCircle2 className=\"size-4 shrink-0 text-success\" aria-hidden=\"true\" />,\n  warning: <TriangleAlert className=\"size-4 shrink-0 text-warning\" aria-hidden=\"true\" />,\n  destructive: <AlertCircle className=\"size-4 shrink-0 text-destructive\" aria-hidden=\"true\" />,\n};\n\ntype ToastVariant = NonNullable<VariantProps<typeof toastVariants>[\"variant\"]>;\n\ninterface ToastProps\n  extends ComponentPropsWithoutRef<typeof ToastPrimitive.Root>,\n    VariantProps<typeof toastVariants> {}\n\nconst ToastRoot = forwardRef<ElementRef<typeof ToastPrimitive.Root>, ToastProps>(\n  ({ className, variant = \"default\", size, children, ...props }, ref) => (\n    <ToastPrimitive.Root\n      data-slot=\"toast\"\n      data-variant={variant}\n      data-size={size}\n      ref={ref}\n      className={cn(toastVariants({ variant, size }), className)}\n      {...props}\n    >\n      <span aria-hidden=\"true\">{iconForVariant[variant as ToastVariant]}</span>\n      <div className=\"min-w-0 flex-1\">{children}</div>\n    </ToastPrimitive.Root>\n  ),\n);\nToastRoot.displayName = \"Toast\";\n\nconst ToastTitle = forwardRef<\n  ElementRef<typeof ToastPrimitive.Title>,\n  ComponentPropsWithoutRef<typeof ToastPrimitive.Title>\n>(({ className, ...props }, ref) => (\n  <ToastPrimitive.Title\n    data-slot=\"toast-title\"\n    ref={ref}\n    className={cn(\"font-medium text-body-sm text-foreground\", className)}\n    {...props}\n  />\n));\nToastTitle.displayName = \"Toast.Title\";\n\nconst ToastDescription = forwardRef<\n  ElementRef<typeof ToastPrimitive.Description>,\n  ComponentPropsWithoutRef<typeof ToastPrimitive.Description>\n>(({ className, ...props }, ref) => (\n  <ToastPrimitive.Description\n    data-slot=\"toast-description\"\n    ref={ref}\n    className={cn(\"mt-0.5 text-body-sm text-muted-foreground\", className)}\n    {...props}\n  />\n));\nToastDescription.displayName = \"Toast.Description\";\n\nconst ToastClose = forwardRef<\n  ElementRef<typeof ToastPrimitive.Close>,\n  ComponentPropsWithoutRef<typeof ToastPrimitive.Close>\n>(({ className, ...props }, ref) => (\n  <ToastPrimitive.Close\n    data-slot=\"toast-close\"\n    ref={ref}\n    className={cn(\n      \"absolute top-2 right-2 rounded-md p-1 text-muted-foreground opacity-70 transition-opacity hover:opacity-100\",\n      \"focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\",\n      className,\n    )}\n    toast-close=\"\"\n    {...props}\n  >\n    <X className=\"size-3.5\" />\n    <span className=\"sr-only\">Close</span>\n  </ToastPrimitive.Close>\n));\nToastClose.displayName = \"Toast.Close\";\n\nconst ToastAction = forwardRef<\n  ElementRef<typeof ToastPrimitive.Action>,\n  ComponentPropsWithoutRef<typeof ToastPrimitive.Action>\n>(({ className, ...props }, ref) => (\n  <ToastPrimitive.Action\n    data-slot=\"toast-action\"\n    ref={ref}\n    className={cn(\n      \"mt-2 inline-flex h-7 items-center rounded-md border border-border/60 bg-card px-2 font-sans text-foreground text-label\",\n      \"transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\",\n      className,\n    )}\n    {...props}\n  />\n));\nToastAction.displayName = \"Toast.Action\";\n\nconst Toast = /*#__PURE__*/ Object.assign(ToastRoot, {\n  Title: ToastTitle,\n  Description: ToastDescription,\n  Close: ToastClose,\n  Action: ToastAction,\n  Provider: ToastPrimitive.Provider,\n  Viewport: ToastPrimitive.Viewport,\n});\n\nexport { Toast, toastVariants, type ToastVariant };\n"
-    },
-    {
-      "path": "components/primitives/toast/toaster.tsx",
-      "type": "registry:ui",
-      "target": "components/ui/toaster.tsx",
-      "content": "\"use client\";\n\nimport { createContext, useCallback, useContext, useMemo, useState } from \"react\";\nimport type { JSX, ReactNode } from \"react\";\nimport { cn } from \"@/lib/cn\";\nimport { Toast, type ToastVariant } from \"@/components/ui/toast\";\n\ninterface ToastDescriptor {\n  id: string;\n  title?: ReactNode;\n  description?: ReactNode;\n  variant?: ToastVariant;\n  /** Auto-dismiss in ms. Default 5000. Pass `null` for sticky. */\n  duration?: number | null;\n  action?: { label: ReactNode; onClick: () => void };\n}\n\ninterface ToastContextValue {\n  toast: (descriptor: Omit<ToastDescriptor, \"id\">) => string;\n  dismiss: (id: string) => void;\n}\n\nconst ToastContext = createContext<ToastContextValue | undefined>(undefined);\n\ninterface ToasterProps {\n  children: ReactNode;\n  /** Toast viewport position. Default bottom-right. */\n  position?: \"top-right\" | \"top-left\" | \"bottom-right\" | \"bottom-left\";\n  className?: string;\n}\n\nconst POSITION_CLASS: Record<NonNullable<ToasterProps[\"position\"]>, string> = {\n  \"top-right\": \"top-4 right-4\",\n  \"top-left\": \"top-4 left-4\",\n  \"bottom-right\": \"bottom-4 right-4\",\n  \"bottom-left\": \"bottom-4 left-4\",\n};\n\n/**\n * Toaster — mount once at the app root. Wraps children in a Radix Toast\n * Provider + Viewport and exposes the `useToast()` hook for descendants.\n */\nfunction Toaster({ children, position = \"bottom-right\", className }: ToasterProps): JSX.Element {\n  const [toasts, setToasts] = useState<ToastDescriptor[]>([]);\n\n  const dismiss = useCallback((id: string) => {\n    setToasts((cur) => cur.filter((t) => t.id !== id));\n  }, []);\n\n  const toast = useCallback((descriptor: Omit<ToastDescriptor, \"id\">) => {\n    const id = `t-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n    setToasts((cur) => [...cur, { id, ...descriptor }]);\n    return id;\n  }, []);\n\n  const value = useMemo(() => ({ toast, dismiss }), [toast, dismiss]);\n\n  return (\n    <ToastContext.Provider data-slot=\"toaster\" value={value}>\n      <Toast.Provider swipeDirection=\"right\" duration={5000}>\n        {children}\n        {toasts.map((t) => (\n          <Toast\n            key={t.id}\n            variant={t.variant ?? \"default\"}\n            duration={t.duration === null ? Number.POSITIVE_INFINITY : (t.duration ?? 5000)}\n            onOpenChange={(open) => {\n              if (!open) dismiss(t.id);\n            }}\n          >\n            {t.title ? <Toast.Title>{t.title}</Toast.Title> : null}\n            {t.description ? <Toast.Description>{t.description}</Toast.Description> : null}\n            {t.action ? (\n              <Toast.Action altText={String(t.action.label)} onClick={t.action.onClick}>\n                {t.action.label}\n              </Toast.Action>\n            ) : null}\n            <Toast.Close />\n          </Toast>\n        ))}\n        <Toast.Viewport\n          className={cn(\n            \"fixed z-50 flex max-h-screen w-full max-w-sm flex-col gap-2 outline-none\",\n            POSITION_CLASS[position],\n            className,\n          )}\n        />\n      </Toast.Provider>\n    </ToastContext.Provider>\n  );\n}\n\n/**\n * useToast — fire toasts from anywhere inside <Toaster>.\n *\n * Example:\n *   const { toast } = useToast();\n *   toast({ title: \"Deployed\", variant: \"success\" });\n */\nfunction useToast(): ToastContextValue {\n  const ctx = useContext(ToastContext);\n  if (!ctx) throw new Error(\"useToast must be used inside <Toaster>.\");\n  return ctx;\n}\n\nexport { Toaster, useToast };\n"
-    }
-  ]
-}