@usetheo/ui 0.1.0-next.1 → 0.4.0-next.0

package/CHANGELOG.md

@@ -7,6 +7,65 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0-next.0] - 2026-05-22
+
+Minor bump — public API gains 7 new theme exports. Zero visual break for
+consumers in 0.3.x (default theme remains `violet-forge`).
+
+### Added
+
+- **7 new built-in themes (2026-05-22, RFC 0007)** — `vercelMono`, `githubDark`, `dracula`, `oneDark`, `anthropicStyle`, `openaiStyle`, `linearGlass`. `builtinThemes` grows from 3 to 10 entries. Each ships light + dark mode. Derivative slugs from brand names use suffixes (`-mono`, `-style`, `-glass`) and descriptions include "Inspired by, not affiliated with [Company]" per D1.1 ADR (trademark protection / no false-affiliation). Canonical OSS themes (Dracula, One Dark, GitHub Dark) keep their reusable names. Bundle delta: ~60 KB CSS injection if consumer passes `builtinThemes` (alternative: `themes={[violetForge, dracula]}` for ~12 KB). (#TBD)
+- **`validateThemeContrast` quality gate (2026-05-22)** — Pure-JS WCAG 2.1 contrast validator in `scripts/lib/wcag-contrast.ts` + gate in `validate-quality-gates.ts`. Iterates 10 themes × 2 modes × 4 high-stakes pairs, enforces 4.5:1 (body) and 3:1 (large/button) thresholds. Runs <50ms. Caught 14 pre-existing AA failures in `violet-forge`, `classic-paper`, `aurora-terminal` accent contrast; `classic-paper` accent darkened from `37 92% 50%` → `37 92% 40%` and `openai-style` dark primary darkened from `155 78% 43%` → `155 78% 30%` to satisfy the gate. (#TBD)
+- **`scripts/lib/wcag-contrast.ts` + `.test.ts` (NEW)** — Pure functions `parseHsl`, `hslToLuminance`, `contrastRatio`. 9 tests cover edge cases (achromatic, hue overflow, percent stripping — EC-3). (#TBD)
+
+## [0.3.0-next.0] - 2026-05-22
+
+Minor bump — visual defaults realigned to FAANG-modern density baseline
+(shadcn / Linear / Vercel / Stripe). Public API unchanged; no type/prop
+signatures touched. Every consumer in 0.2.x will see tighter form controls,
+smaller body text, and a less-padded Card after upgrading.
+
+### Migration from 0.2.x
+
+If you depended on the prior visual defaults (Button 40px, Card 24px
+padding, body-md 15px), you have two options:
+
+1. **Per-component** — pass explicit `size="lg"` to Button/Input/Select/
+   Textarea/Card. These render the prior dimensions.
+2. **Global override** — set `<ThemeProvider defaultDensity="spacious">`
+   at the app root. All form controls bump to 44px globally.
+
+No code change required if you accept the new defaults. Type-only
+exports added: `Density`, `DensityContextValue`.
+
+### Added
+
+- **`useDensity()` hook + `data-density` attribute (2026-05-22, RFC 0006)** — Global density override without rewriting `size` props per call site. Three tiers: `compact` (32px), `comfortable` (36px, default), `spacious` (44px). `<ThemeProvider defaultDensity="compact">` at the app root flips the entire surface. Persisted to localStorage. **EC-1 fix**: density implemented via CSS variables on `:root` (`--theo-control-h`, `--theo-control-px`) injected by ThemeProvider, not Tailwind class modifiers. Only the `md` cva variant reads the var; `sm` and `lg` stay hardcoded so explicit `size` prop always overrides density. (#TBD)
+- **`docs/design-system.md > Density policy` section** — declares default heights per component + WCAG 2.5.8 AA tap-target policy + density override patterns. Closes the style-guide gap (previously implicit in source). (#TBD)
+- **`playground/density-demo.tsx`** — live preview with 3-way density toggle. Mount via `?view=density` in the Vite playground. (#TBD)
+
+### Changed (BREAKING visual default, not API)
+
+- **Form-control `md` defaults: 40px → 36px** (FAANG-tier modern density). Affects `Button`, `Input`, `Select.Trigger`, `Textarea`. `sm` stays 32px, `lg` recalibrated to 44px. (#TBD)
+- **`body-md` typescale: 15px → 14px** (shadcn / Vercel Geist / Linear standard). `body-sm` recalibrated 14px → 13px to preserve a distinct tier. `validateDesignSystemFidelity` gate updated atomically with `tailwind-preset.ts`. (#TBD)
+- **Card `md` padding: 24px → 20px** (`p-6` → `p-5`). `sm` unchanged (`p-3`); `lg` recalibrated 28px → 24px (`p-7` → `p-6`). (#TBD)
+- **Bundle baseline rebased** for the new defaults (~+700 bytes total — CSS-var class strings + Density type union). Engines (whiteboard / slide / slide-deck) untouched. (#TBD)
+
+## [0.2.0-next.0] - 2026-05-20
+
+Minor bump (not patch) because public API surface grew: new `defineTheme` /
+`hex` / `rgb` exports plus `size` prop standardized across 9 primitives.
+All additions are backwards-compatible — `defaultVariants.size = "md"`
+preserves rendered markup for callers that don't pass `size`.
+
+### Added
+- **`defineTheme(partial)` + `hex()` / `rgb()` helpers (2026-05-20, theming-and-sizes plan, Phase 2)** — Reduzem o atrito de criar tema customizado de "58 cor keys obrigatórias" para "só sobrescreva o que mudar". `defineTheme({ name, light: { primary: hex('#FF5722') } })` merja partial overrides em `violetForge` e retorna um `Theme` completo. `hex('#7C3AED')` e `rgb(124, 58, 237)` retornam HSL string-tuple (`"262 83% 58%"`) drop-in compatível com `ColorScale`. Suporta short hex (#abc), 8-char alpha (alpha descartado), case-insensitive. **EC-3** (last-writer-wins): passar `defineTheme({ name: 'violet-forge', ... })` sobrescreve o built-in, comportamento documentado em teste. **EC-4** (case-insensitive) e **EC-5** (4-char alpha) cobertos por testes. **EC-7** (override só light/dark): nota em JSDoc lembra o consumer que se omitir um modo, ele herda violetForge — pode gerar inconsistência visual intencional. Drop-in: `<ThemeProvider themes={[defineTheme({ name: 'corp' })]}>` funciona sem mudança no provider. (#TBD)
+- **9 primitives expose `size` prop (2026-05-20, theming-and-sizes plan, Phase 1)** — `Input`, `Badge`, `Toast`, `Checkbox`, `Switch`, `Card`, `FormField`, `Textarea`, `Select.Trigger` agora aceitam `size?: 'sm' | 'md' | 'lg'` (default `md`, backwards-compat preservada). Compounds `Card` e `FormField` propagam size via React Context para os subparts. **EC-1**: `Input` usa `Omit<InputHTMLAttributes<HTMLInputElement>, 'size'>` no extends para evitar conflict com o HTML attribute nativo (`size: number` = text-input columns); type-test garantido via `@ts-expect-error`. **EC-2**: `Select.Trigger` confirmado Radix-button (sem `SelectHTMLAttributes` conflict). Subparts de Card/FormField não aceitam `size` próprio — use `className` para per-subpart tweaks (EC-8 documentado em JSDoc). (#TBD)
+- **`cn()` ensina tailwind-merge sobre o Violet Forge typescale (2026-05-20)** — `src/lib/cn.ts` substitui `twMerge` direto por `extendTailwindMerge` declarando o `font-size` classGroup com as 16 typescale tokens (`display-2xl`/`display-xl`/`headline`/`title-lg`/`body-md`/`label-caps`/`code-md`/etc.). Sem essa extensão, classes como `text-label` (font-size) e `text-accent` (color) colapsavam ambas no mesmo `text-*` group, e o último vencia — quebrando size+color em CVA variants. (#TBD)
+- **Registry descriptors for the engine surface (2026-05-19)** — Seven new shadcn-compatible registry items so `docs.usetheo.dev/theoui` and the `npx shadcn add` flow can deliver the engines as copy-paste components: `whiteboard` (14 files under `components/ui/whiteboard/`), `slide` (16 files under `components/ui/slide/`, including 3 CSS theme files), `slide-deck` (19 files under `components/blocks/slide-deck/`), and four Tier 2 plugins — `slide-plugin-shiki`, `slide-plugin-math`, `slide-plugin-mermaid`, `slide-plugin-emoji` — each shipping its own subpath under `components/ui/slide/plugins/<name>/`. Cross-item references resolved via `registryDependencies` (each plugin + slide-deck depend on `slide`). Honest install: dependencies arrays list every static or dynamic peer-dep a copy-paste consumer needs (`roughjs`, `perfect-freehand`, `zod` for whiteboard; the full markdown / mdast / hast stack for slide; `shiki` / `katex` / `mermaid` per plugin). Total: 121 registry items (was 114). (#TBD)
+- **`scripts/build-registry.ts` strips source ESM extensions on external imports** — `rewriteRegistryImports` now drops `.js` / `.jsx` / `.ts` / `.tsx` from non-relative specifiers (e.g. `roughjs/bin/generator.js` → `roughjs/bin/generator`). Previously only relative imports were normalized; engines that import third-party submodules with the explicit ESM extension (whiteboard does this for `roughjs/bin/*`) would fail `validate-registry`'s `consumer-unsafe extension` gate. Limited to known source extensions so basenames that happen to end in `.js` inside URLs are untouched. (#TBD)
+- **`scripts/validate-quality-gates.ts > validateRegistryStoriesAndTests` is entry-aware** — When a descriptor lists multiple files (engines like whiteboard / slide / slide-deck), the gate now only checks `<descriptor.name>.test.tsx` / `.stories.tsx` next to the entry file (`<name>.tsx` or `<name>.ts`), not every internal module. Internal helpers carry their own focused tests but don't need a story sibling. Single-file registry items are unaffected. (#TBD)
+
 ## [0.1.0-next.1] - 2026-05-19
 
 ### Added

package/dist/index.d.ts

@@ -86,6 +86,17 @@ interface Theme {
     fontUrls?: string[];
 }
 
+type Density = "compact" | "comfortable" | "spacious";
+interface DensityContextValue {
+    density: Density;
+    setDensity: (next: Density) => void;
+}
+/**
+ * Read the current density from the active ThemeProvider context. Throws
+ * outside the provider so misuse fails loud — analogous to `useTheme`.
+ */
+declare function useDensity(): DensityContextValue;
+
 interface ThemeContextValue {
     /** Active theme (full descriptor). */
     theme: Theme;
@@ -127,6 +138,13 @@ interface ThemeProviderProps {
      * Default: "theo-ui:theme".
      */
     storageKey?: string | null;
+    /**
+     * Initial density. Drives `data-density` on `<html>` and the `--theo-control-h`
+     * / `--theo-control-px` CSS vars consumed by form-control `md` variants.
+     * Defaults to `"comfortable"` (36px controls — FAANG-tier modern density).
+     * Plan: faang-density-tightening (D3).
+     */
+    defaultDensity?: Density;
 }
 /**
  * ThemeProvider — central registry + runtime switcher for Theo themes.
@@ -139,7 +157,7 @@ interface ThemeProviderProps {
  *   3. Lazy-loads theme font URLs by injecting `<link rel="stylesheet">`.
  *   4. Optionally persists choice in localStorage.
  */
-declare function ThemeProvider({ children, defaultTheme, defaultMode, themes: themesProp, storageKey, }: ThemeProviderProps): JSX.Element;
+declare function ThemeProvider({ children, defaultTheme, defaultMode, themes: themesProp, storageKey, defaultDensity, }: ThemeProviderProps): JSX.Element;
 /**
  * useTheme — access theme state from any component inside <ThemeProvider>.
  * Throws if used outside the provider — fail-fast.
@@ -234,9 +252,202 @@ declare const classicPaper: Theme;
  */
 declare const auroraTerminal: Theme;
 
+/**
+ * `defineTheme(input)` — build a `Theme` from a partial override.
+ *
+ * Reduces the boilerplate of authoring a custom theme from 58 colour
+ * keys (`light` × 29 + `dark` × 29) to "just what you want to change".
+ * The merge always uses `violetForge` as the base — this is a pure,
+ * deterministic helper that does not depend on whatever theme is active
+ * at the call site.
+ *
+ * The `Theme` object it returns is drop-in compatible with
+ * `<ThemeProvider themes={[...]}>` — same shape as `violetForge`,
+ * `classicPaper`, and `auroraTerminal`.
+ *
+ * Honest caveat: if you override `light.primary` but NOT `dark.primary`,
+ * the two modes will use different colours — your override in light,
+ * Violet Forge's default in dark. That's intentional. Pass both sides
+ * to keep them in sync.
+ *
+ * @example
+ *   import { defineTheme, hex } from "@usetheo/ui";
+ *   export const corp = defineTheme({
+ *     name: "corp",
+ *     light: { primary: hex("#0EA5E9") },
+ *     dark: { primary: hex("#38BDF8") },
+ *   });
+ *
+ * Plan: `.claude/knowledge-base/plans/theming-and-sizes-plan.md` T2.1.
+ */
+
+interface DefineThemeInput {
+    /**
+     * Stable id used in `data-theme="<name>"` on the root element. Must
+     * match `/^[a-z][a-z0-9-]*$/i` (CSS-identifier-safe). Required.
+     */
+    name: string;
+    /**
+     * Human-readable label for theme switchers. Defaults to the
+     * capitalized version of `name` (e.g. "corp" → "Corp").
+     */
+    label?: string;
+    /** Optional one-line description shown in switchers. */
+    description?: string;
+    /**
+     * Override light-mode colours. Any key omitted is inherited from
+     * `violetForge.light`. See `ColorScale` for the full list.
+     */
+    light?: Partial<ColorScale>;
+    /**
+     * Override dark-mode colours. Any key omitted is inherited from
+     * `violetForge.dark`.
+     */
+    dark?: Partial<ColorScale>;
+    /**
+     * Override fonts (`display`, `body`, `mono`). Any key omitted is
+     * inherited from `violetForge.fonts`.
+     */
+    fonts?: Partial<ThemeFonts>;
+    /**
+     * Replace the default remote font URLs. Pass an empty array to skip
+     * font fetching entirely. Defaults to `violetForge.fontUrls` when
+     * omitted (so consumers that don't care still get Geist preloaded).
+     */
+    fontUrls?: string[];
+}
+declare function defineTheme(input: DefineThemeInput): Theme;
+
+/**
+ * Color helpers that return values in the HSL string-tuple format the
+ * `ColorScale` shape expects (e.g. `"262 83% 58%"`).
+ *
+ * Why this format: matches the shadcn / Violet Forge convention where
+ * CSS variables hold the H S% L% components and consumers write
+ * `hsl(var(--primary))` (allowing alpha overlays via
+ * `hsl(var(--primary) / 0.5)`). Returning an object would force callers
+ * to write `${theme.light.primary.h} ${theme.light.primary.s}% …` —
+ * exactly the friction `hex()` is meant to remove.
+ *
+ * No external dependency: vanilla algorithm from CSS Color spec.
+ * Alpha channels are intentionally discarded — `ColorScale` is opaque;
+ * use `hsl(var(--primary) / 0.5)` in CSS for transparency.
+ *
+ * Plan: `.claude/knowledge-base/plans/theming-and-sizes-plan.md` T2.2.
+ */
+/**
+ * Convert a hex color string to the HSL string-tuple format used by
+ * `ColorScale` ("`H S% L%`", e.g. `"262 83% 58%"`).
+ *
+ * Accepts `#rgb`, `#rgba`, `#rrggbb`, `#rrggbbaa`. Case-insensitive.
+ * Alpha bytes are silently dropped — use `hsl(var(--primary) / 0.5)`
+ * in CSS for transparency.
+ *
+ * @throws if the input is malformed.
+ *
+ * @example
+ *   hex("#7C3AED")   // "262 83% 58%"
+ *   hex("#7c3aed")   // "262 83% 58%"  (same)
+ *   hex("#abc")      // expanded to "#aabbcc"
+ */
+declare function hex(input: string): string;
+/**
+ * Convert an RGB triplet (each in `[0, 255]`) to the HSL string-tuple
+ * format used by `ColorScale`.
+ *
+ * @throws if any channel is out of `[0, 255]`.
+ *
+ * @example
+ *   rgb(124, 58, 237)  // "262 83% 58%"
+ */
+declare function rgb(r: number, g: number, b: number): string;
+
+/**
+ * Vercel Mono — razor-sharp monochrome + signature blue.
+ *
+ * Inspired by, not affiliated with Vercel. Based on Geist Design tokens
+ * (https://github.com/vercel/geist). Light = pure white + black ink + blue
+ * accent (#0070F3); dark = near-black canvas + white text + same blue.
+ *
+ * Plan: .claude/knowledge-base/plans/seven-themes-plan.md T2.1
+ */
+declare const vercelMono: Theme;
+
+/**
+ * GitHub Dark — GitHub's default dark theme.
+ *
+ * Based on the canonical Primer Primitives tokens
+ * (https://github.com/primer/primitives, MIT). Light fallback uses GitHub's
+ * "light-default" Primer scale.
+ *
+ * Plan: .claude/knowledge-base/plans/seven-themes-plan.md T3.1
+ */
+declare const githubDark: Theme;
+
+/**
+ * Dracula — the cult OSS dark theme (https://draculatheme.com, MIT).
+ *
+ * Dark mode = canonical Dracula spec (background #282A36, signature pink
+ * #FF79C6, purple #BD93F9, etc.).
+ *
+ * Note: "light" mode is a Theo-original adaptation — Dracula upstream
+ * spec is dark-only. We darken the signature pink/purple to pass WCAG AA
+ * against light backgrounds, sacrificing palette purity for accessibility.
+ *
+ * Plan: .claude/knowledge-base/plans/seven-themes-plan.md T4.1
+ */
+declare const dracula: Theme;
+
+/**
+ * One Dark / One Light — Atom's iconic syntax theme.
+ *
+ * Sources:
+ *   - atom/one-dark-syntax (MIT) — dark mode canonical
+ *   - atom/one-light-syntax (MIT) — light mode canonical
+ *
+ * Plan: .claude/knowledge-base/plans/seven-themes-plan.md T5.1
+ */
+declare const oneDark: Theme;
+
+/**
+ * Anthropic-style — claude.ai-inspired editorial calm.
+ *
+ * Inspired by, not affiliated with Anthropic. Visually informed by claude.ai's
+ * warm cream canvas + burnt sienna primary + ink-on-paper feel. No proprietary
+ * assets reproduced (font is Geist, colors are independent measurements).
+ *
+ * Plan: .claude/knowledge-base/plans/seven-themes-plan.md T6.1
+ */
+declare const anthropicStyle: Theme;
+
+/**
+ * OpenAI-style — chatgpt.com-inspired minimal tech-utility.
+ *
+ * Inspired by, not affiliated with OpenAI. Pure white / charcoal canvas +
+ * signature ChatGPT green (#10A37F). Minimal saturation, high contrast.
+ *
+ * Plan: .claude/knowledge-base/plans/seven-themes-plan.md T7.1
+ */
+declare const openaiStyle: Theme;
+
+/**
+ * Linear Glass — linear.app-inspired glassy indigo.
+ *
+ * Inspired by, not affiliated with Linear. Refined indigo-violet primary
+ * (#5E6AD2) on near-black canvas in dark, pure white in light. Subtle
+ * glassmorphic surface temperature.
+ *
+ * Plan: .claude/knowledge-base/plans/seven-themes-plan.md T8.1
+ */
+declare const linearGlass: Theme;
+
 /**
  * All themes bundled with Theo UI. Pass to `<ThemeProvider themes={builtinThemes}>`
- * if you want all of them available out of the box.
+ * if you want all 10 available out of the box.
+ *
+ * EC-4 note: passing the full 10-entry list triggers ~60 KB CSS injection in
+ * `<style id="theo-ui-theme-vars">`. For apps focused on 1-2 themes, prefer
+ * `themes={[violetForge, dracula]}` to keep the payload at ~12 KB.
  */
 declare const builtinThemes: Theme[];
 
@@ -257,6 +468,7 @@ declare const builtinThemes: Theme[];
  */
 declare const toastVariants: (props?: ({
     variant?: "success" | "warning" | "destructive" | "info" | "default" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type ToastVariant = NonNullable<VariantProps<typeof toastVariants>["variant"]>;
 interface ToastProps extends ComponentPropsWithoutRef<typeof ToastPrimitive.Root>, VariantProps<typeof toastVariants> {
@@ -428,7 +640,7 @@ interface TaskStep {
  * `asChild` swaps the root for the consumer's element (Radix Slot pattern).
  */
 declare const buttonVariants: (props?: ({
-    variant?: "primary" | "secondary" | "accent" | "destructive" | "link" | "ghost" | null | undefined;
+    variant?: "accent" | "link" | "primary" | "secondary" | "destructive" | "ghost" | null | undefined;
     size?: "sm" | "md" | "lg" | "icon" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
@@ -452,7 +664,8 @@ declare const Button: react.ForwardRefExoticComponent<ButtonProps & react.RefAtt
  * "Running", "Failed" rows in deployment lists.
  */
 declare const badgeVariants: (props?: ({
-    variant?: "primary" | "accent" | "success" | "warning" | "destructive" | "default" | "outline" | null | undefined;
+    variant?: "accent" | "primary" | "success" | "warning" | "destructive" | "default" | "outline" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface BadgeProps extends HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {
 }
@@ -466,6 +679,29 @@ declare const BadgeWithDot: typeof Badge & {
     Dot: typeof Dot;
 };
 
+/**
+ * Card — surface container for grouping related content.
+ *
+ * Composition pattern (shadcn-style):
+ *   <Card>
+ *     <Card.Header>
+ *       <Card.Title>…</Card.Title>
+ *       <Card.Description>…</Card.Description>
+ *     </Card.Header>
+ *     <Card.Body>…</Card.Body>
+ *     <Card.Footer>…</Card.Footer>
+ *   </Card>
+ *
+ * The `size` prop on the root propagates to subparts via Context, so a
+ * single declaration controls padding + heading scale across the compound.
+ * Subparts used in isolation default to `md`. Subparts do NOT accept a `size`
+ * prop of their own — use `className` for granular per-subpart tweaks.
+ * (EC-8, edge-case review 2026-05-20.)
+ */
+type CardSize = "sm" | "md" | "lg";
+interface CardRootProps extends HTMLAttributes<HTMLDivElement> {
+    size?: CardSize;
+}
 interface TitleProps extends HTMLAttributes<HTMLHeadingElement> {
     /**
      * When true, renders the child element with the Card.Title styles applied
@@ -474,7 +710,7 @@ interface TitleProps extends HTMLAttributes<HTMLHeadingElement> {
      */
     asChild?: boolean;
 }
-declare const Card: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>> & {
+declare const Card: react.ForwardRefExoticComponent<CardRootProps & react.RefAttributes<HTMLDivElement>> & {
     Header: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
     Title: react.ForwardRefExoticComponent<TitleProps & react.RefAttributes<HTMLHeadingElement>>;
     Description: react.ForwardRefExoticComponent<HTMLAttributes<HTMLParagraphElement> & react.RefAttributes<HTMLParagraphElement>>;
@@ -482,8 +718,9 @@ declare const Card: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElemen
     Footer: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
 };
 
-interface InputProps extends InputHTMLAttributes<HTMLInputElement> {
-}
+declare const inputVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
 /**
  * Input — text input primitive.
  *
@@ -492,7 +729,15 @@ interface InputProps extends InputHTMLAttributes<HTMLInputElement> {
  *   - rounded-md (6px) — slightly less than buttons to differentiate.
  *   - focus uses violet ring (--ring).
  *   - placeholder uses --muted-foreground.
+ *
+ * The `size` prop accepts `"sm" | "md" | "lg"`. Default `md` preserves the
+ * 40px tall input from before this prop existed. EC-1 (edge-case review):
+ * this overrides the native HTML `size` attribute (text-input columns) —
+ * use `{...{ size: 20 } as any}` if you genuinely need the HTML attribute,
+ * which is exceedingly rare.
  */
+interface InputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size">, VariantProps<typeof inputVariants> {
+}
 declare const Input: react.ForwardRefExoticComponent<InputProps & react.RefAttributes<HTMLInputElement>>;
 
 interface ContentProps$1 extends ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
@@ -628,7 +873,7 @@ declare const Skeleton: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivEl
  */
 declare const avatarVariants: (props?: ({
     size?: "sm" | "md" | "lg" | "xs" | "xl" | null | undefined;
-    tone?: "primary" | "accent" | "muted" | null | undefined;
+    tone?: "accent" | "primary" | "muted" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface AvatarProps extends ComponentPropsWithoutRef<typeof AvatarPrimitive.Root>, VariantProps<typeof avatarVariants> {
 }
@@ -650,11 +895,37 @@ interface LabelProps extends ComponentPropsWithoutRef<typeof LabelPrimitive.Root
 }
 declare const Label: react.ForwardRefExoticComponent<LabelProps & react.RefAttributes<HTMLLabelElement>>;
 
+/**
+ * FormField — composition wrapper for accessible form rows.
+ *
+ * Provides context with a generated `id`, so children (Label, Input, Hint,
+ * Error) wire themselves via `htmlFor` / `id` / `aria-describedby` without
+ * the consumer having to thread IDs manually.
+ *
+ * Composition:
+ *   <FormField>
+ *     <FormField.Label required>Email</FormField.Label>
+ *     <FormField.Control>
+ *       <Input type="email" placeholder="…" />
+ *     </FormField.Control>
+ *     <FormField.Hint>We never share your email.</FormField.Hint>
+ *     <FormField.Error>{error}</FormField.Error>
+ *   </FormField>
+ *
+ * Errors take precedence over hints (only one of them shows at once).
+ */
+type FormFieldSize = "sm" | "md" | "lg";
 interface FormFieldProps extends HTMLAttributes<HTMLDivElement> {
     /** Optional explicit id override. */
     id?: string;
     /** Marks the field as invalid; switches Hint → Error and toggles aria. */
     invalid?: boolean;
+    /**
+     * Size scale propagated to Label / Hint / Error subparts via Context.
+     * Default `md` preserves prior behavior. Subparts do NOT accept a `size`
+     * prop of their own — use `className` for granular tweaks (EC-8).
+     */
+    size?: FormFieldSize;
 }
 interface FormFieldLabelProps extends ComponentPropsWithoutRef<typeof LabelPrimitive.Root> {
     required?: boolean;
@@ -696,6 +967,17 @@ interface EmptyStateProps extends Omit<HTMLAttributes<HTMLDivElement>, "title">
  */
 declare const EmptyState: react.ForwardRefExoticComponent<EmptyStateProps & react.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Trigger size variant (theming-and-sizes plan T1.9).
+ * Items inside Select.Content stay md-equivalent regardless — the floating
+ * menu is isolated from the trigger context (documented decision).
+ *
+ * EC-2 guard: `<Select.Trigger>` is a Radix `<button>` — no SelectHTMLAttributes
+ * conflict to Omit. Verified before implementation.
+ */
+declare const selectTriggerVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
 /**
  * Select — styled wrapper around Radix Select.
  *
@@ -715,7 +997,9 @@ declare const EmptyState: react.ForwardRefExoticComponent<EmptyStateProps & reac
  * Trigger matches Input height + violet focus ring. Content uses popover
  * surface with check on the selected item.
  */
-declare const SelectTrigger: react.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectTriggerProps & react.RefAttributes<HTMLButtonElement>, "ref"> & react.RefAttributes<HTMLButtonElement>>;
+interface SelectTriggerProps extends ComponentPropsWithoutRef<typeof SelectPrimitive.Trigger>, VariantProps<typeof selectTriggerVariants> {
+}
+declare const SelectTrigger: react.ForwardRefExoticComponent<SelectTriggerProps & react.RefAttributes<HTMLButtonElement>>;
 declare const SelectContent: react.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectContentProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
 declare const SelectLabel: react.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectLabelProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
 declare const SelectItem: react.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectItemProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
@@ -735,8 +1019,17 @@ declare const Select: typeof SelectPrimitive.Root & {
  *
  * Supports tri-state via `checked="indeterminate"`. Violet fill when on,
  * border-only when off. Themed via tokens (--primary, --background).
+ *
+ * The `size` prop accepts `"sm" | "md" | "lg"`. Default `md` preserves the
+ * 16px box from before this prop existed. The `sm` size keeps a >=24px
+ * effective tap target via an invisible expanded hit area (WCAG 2.5.5).
  */
-declare const Checkbox: react.ForwardRefExoticComponent<Omit<CheckboxPrimitive.CheckboxProps & react.RefAttributes<HTMLButtonElement>, "ref"> & react.RefAttributes<HTMLButtonElement>>;
+declare const checkboxVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface CheckboxProps extends ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root>, VariantProps<typeof checkboxVariants> {
+}
+declare const Checkbox: react.ForwardRefExoticComponent<CheckboxProps & react.RefAttributes<HTMLButtonElement>>;
 
 declare const RadioGroup: react.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>> & {
     Item: react.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupItemProps & react.RefAttributes<HTMLButtonElement>, "ref"> & react.RefAttributes<HTMLButtonElement>>;
@@ -748,17 +1041,33 @@ declare const RadioGroup: react.ForwardRefExoticComponent<Omit<RadioGroupPrimiti
  *
  * Off-state uses --muted, on-state uses --primary with a subtle glow shadow
  * to mark "this is active" in the violet brand language.
+ *
+ * The `size` prop accepts `"sm" | "md" | "lg"`. Default `md` preserves the
+ * 20×36 track from before this prop existed.
  */
-declare const Switch: react.ForwardRefExoticComponent<Omit<SwitchPrimitive.SwitchProps & react.RefAttributes<HTMLButtonElement>, "ref"> & react.RefAttributes<HTMLButtonElement>>;
-
-interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> {
+declare const switchVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface SwitchProps extends ComponentPropsWithoutRef<typeof SwitchPrimitive.Root>, VariantProps<typeof switchVariants> {
 }
+declare const Switch: react.ForwardRefExoticComponent<SwitchProps & react.RefAttributes<HTMLButtonElement>>;
+
 /**
  * Textarea — multi-line input mirror of Input.
  *
  * Matches Input visuals (violet focus ring, --input border, --card bg).
- * Default minimum height of 96px; consumer can override via className.
+ * The `size` prop accepts `"sm" | "md" | "lg"`. Default `md` preserves the
+ * 80px (5rem) min-height + body-md text from before this prop existed.
+ *
+ * Note: `TextareaHTMLAttributes<HTMLTextAreaElement>` does NOT declare a
+ * native `size` attribute (textareas use `rows` / `cols`), so no Omit is
+ * needed — contrast with `<Input>` which had EC-1 collision.
  */
+declare const textareaVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElement>, VariantProps<typeof textareaVariants> {
+}
 declare const Textarea: react.ForwardRefExoticComponent<TextareaProps & react.RefAttributes<HTMLTextAreaElement>>;
 
 interface ContextWindowBarProps extends HTMLAttributes<HTMLDivElement> {
@@ -1635,7 +1944,7 @@ declare const TopNav: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement
  */
 declare const Overlay: react.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
 declare const sheetVariants: (props?: ({
-    side?: "right" | "left" | "top" | "bottom" | null | undefined;
+    side?: "bottom" | "left" | "right" | "top" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface ContentProps extends ComponentPropsWithoutRef<typeof DialogPrimitive.Content>, VariantProps<typeof sheetVariants> {
     hideCloseButton?: boolean;
@@ -3060,4 +3369,4 @@ interface CommandPaletteProps {
  */
 declare function CommandPalette({ open, onOpenChange, items, onSelect, placeholder, emptyMessage, filter, }: CommandPaletteProps): react_jsx_runtime.JSX.Element;
 
-export { ALL_MODES, AgentComposer, type AgentDraft, AgentEditor, AgentErrorCard, type AgentErrorKind, AgentEvent, type AgentEvent$1 as AgentEventModel, type AgentEventStatus, type AgentEventType, AgentHandoff, AgentProfile, type AgentProfileDescriptor, AgentStartingState, AgentStream, type AgentStreamItem, AgentStreaming, AgentTimeline, ApprovalCard, type ApprovalSeverity, ArtifactPreview, type Attachment, AttachmentChip, type AuditActorKind, type AuditEntry, AuditLogEntry, type AuditSeverity, AutoCompactNotice, Avatar, BadgeWithDot as Badge, type BadgeProps, BrowserControls, BuildLogStream, Button, type ButtonProps, type Capability, CapabilityIndicator, type CapabilityState, Card, ChatComposer, ChatMessage, ChatThread, Checkbox, type ColorScale, type CommandItem, CommandPalette, type ComposerMode, ContextCard, ContextWindowBar, CostMeter, type CreatedFile, CreatedFilesCard, type CronJob, CronJobCard, type CronJobStatus, CronJobsList, type Deployment, DeploymentRow, type DeploymentStatus, Dialog, type DiffHunk, type DiffLine, type DiffLineKind, DiffViewer, type Domain, DomainConfig, type DomainStatus, EmptyState, type EnvScope, type EnvVar, EnvVarEditor, FolderContextCard, type FolderEntry, FolderSelector, FormField, HOOK_EVENTS, type HandoffParty, HookConfig, type HookEntry, type HookEvent, type HookEventEntry, HookEventLog, type HookEventResult, Input, type InputProps, type IntentOption, IntentSelector, Label, type Lane, LaneBoard, type LaneCard, type LaneState, type LogLevel, type LogLine, LoginSplit, type MCPServer, MCPServerCard, MCPServerList, type MCPServerStatus, MODE_LABEL, MemoryEditor, type MemoryLayer, type MemoryScope, type MentionItem, MentionMenu, type MentionTrigger, type Message, type MessageRole, type Metric, MetricsPanel, type Mode, type ModelCapabilityFlag, ModelCard, type ModelInfo, type ModelOption, ModelSelector, type PermissionDecision, type PermissionDecisionKind, PermissionMatrix, PermissionModal, type PermissionOperation, type PermissionRequest, type PermissionRule, type PlanNode, type PlanNodeStatus, type PreviewEnv, PreviewEnvCard, PreviewPanel, type PreviewService, ProgressChecklist, type Project, ProjectCard, type ProjectStatus, ProjectSwitcher, type QuickAction, QuickActionChips, RadioGroup, type RailStep, type RecentFolder, RecentFoldersList, type RollbackTarget, RollbackUI, type Rule, RuleCard, RuleEditor, type RuleScope, type RuleState, RunStats, type RunningTaskItem, type RunningTaskStatus, RunningTasksPanel, ScrollArea, Select, SessionListItem, type SessionMode, type SessionRunStatus, type SessionStatus, type SessionSummary, SessionTimeline, Sheet, Sidebar, Skeleton, type Skill, SkillCard, SkillEditor, type SkillSource, type SkillState, SkillsList, SocialAuthRow, type SocialProvider, StepsRail, SubAgentDispatch, type SubAgentRun, type SubAgentState, Switch, SystemPromptEditor, Tabs, TaskHeader, TaskNode, TaskPlan, type TaskSource, type TaskStatus, type TaskStep, type TaskStepStatus, type TerminalLine, TerminalPanel, Textarea, type TextareaProps, type Theme, type ThemeFonts, type ThemeMode, ThemeProvider, ThemeScript, ThemeSwitcher, TheoUIProvider, type TheoUIProviderProps, Toast, type ToastVariant, Toaster, TokenUsageChart, type TokenUsagePoint, ToolCall, ToolCallCard, type ToolCallStatus, type ToolEnablement, type ToolEntry, ToolResult, ToolsList, TooltipWithStatics as Tooltip, TopNav, auroraTerminal, avatarVariants, badgeVariants, builtinThemes, buttonVariants, capabilityPresets, classicPaper, cn, modelCapabilityPresets, sheetVariants, useTheme, useToast, violetForge };
+export { ALL_MODES, AgentComposer, type AgentDraft, AgentEditor, AgentErrorCard, type AgentErrorKind, AgentEvent, type AgentEvent$1 as AgentEventModel, type AgentEventStatus, type AgentEventType, AgentHandoff, AgentProfile, type AgentProfileDescriptor, AgentStartingState, AgentStream, type AgentStreamItem, AgentStreaming, AgentTimeline, ApprovalCard, type ApprovalSeverity, ArtifactPreview, type Attachment, AttachmentChip, type AuditActorKind, type AuditEntry, AuditLogEntry, type AuditSeverity, AutoCompactNotice, Avatar, BadgeWithDot as Badge, type BadgeProps, BrowserControls, BuildLogStream, Button, type ButtonProps, type Capability, CapabilityIndicator, type CapabilityState, Card, ChatComposer, ChatMessage, ChatThread, Checkbox, type ColorScale, type CommandItem, CommandPalette, type ComposerMode, ContextCard, ContextWindowBar, CostMeter, type CreatedFile, CreatedFilesCard, type CronJob, CronJobCard, type CronJobStatus, CronJobsList, type DefineThemeInput, type Density, type DensityContextValue, type Deployment, DeploymentRow, type DeploymentStatus, Dialog, type DiffHunk, type DiffLine, type DiffLineKind, DiffViewer, type Domain, DomainConfig, type DomainStatus, EmptyState, type EnvScope, type EnvVar, EnvVarEditor, FolderContextCard, type FolderEntry, FolderSelector, FormField, HOOK_EVENTS, type HandoffParty, HookConfig, type HookEntry, type HookEvent, type HookEventEntry, HookEventLog, type HookEventResult, Input, type InputProps, type IntentOption, IntentSelector, Label, type Lane, LaneBoard, type LaneCard, type LaneState, type LogLevel, type LogLine, LoginSplit, type MCPServer, MCPServerCard, MCPServerList, type MCPServerStatus, MODE_LABEL, MemoryEditor, type MemoryLayer, type MemoryScope, type MentionItem, MentionMenu, type MentionTrigger, type Message, type MessageRole, type Metric, MetricsPanel, type Mode, type ModelCapabilityFlag, ModelCard, type ModelInfo, type ModelOption, ModelSelector, type PermissionDecision, type PermissionDecisionKind, PermissionMatrix, PermissionModal, type PermissionOperation, type PermissionRequest, type PermissionRule, type PlanNode, type PlanNodeStatus, type PreviewEnv, PreviewEnvCard, PreviewPanel, type PreviewService, ProgressChecklist, type Project, ProjectCard, type ProjectStatus, ProjectSwitcher, type QuickAction, QuickActionChips, RadioGroup, type RailStep, type RecentFolder, RecentFoldersList, type RollbackTarget, RollbackUI, type Rule, RuleCard, RuleEditor, type RuleScope, type RuleState, RunStats, type RunningTaskItem, type RunningTaskStatus, RunningTasksPanel, ScrollArea, Select, SessionListItem, type SessionMode, type SessionRunStatus, type SessionStatus, type SessionSummary, SessionTimeline, Sheet, Sidebar, Skeleton, type Skill, SkillCard, SkillEditor, type SkillSource, type SkillState, SkillsList, SocialAuthRow, type SocialProvider, StepsRail, SubAgentDispatch, type SubAgentRun, type SubAgentState, Switch, SystemPromptEditor, Tabs, TaskHeader, TaskNode, TaskPlan, type TaskSource, type TaskStatus, type TaskStep, type TaskStepStatus, type TerminalLine, TerminalPanel, Textarea, type TextareaProps, type Theme, type ThemeFonts, type ThemeMode, ThemeProvider, ThemeScript, ThemeSwitcher, TheoUIProvider, type TheoUIProviderProps, Toast, type ToastVariant, Toaster, TokenUsageChart, type TokenUsagePoint, ToolCall, ToolCallCard, type ToolCallStatus, type ToolEnablement, type ToolEntry, ToolResult, ToolsList, TooltipWithStatics as Tooltip, TopNav, anthropicStyle, auroraTerminal, avatarVariants, badgeVariants, builtinThemes, buttonVariants, capabilityPresets, classicPaper, cn, defineTheme, dracula, githubDark, hex, linearGlass, modelCapabilityPresets, oneDark, openaiStyle, rgb, sheetVariants, useDensity, useTheme, useToast, vercelMono, violetForge };