@usetheo/ui 0.13.0 → 0.13.2

package/dist/components/primitives/slide/slide.d.ts

@@ -0,0 +1,53 @@
+import { type FC } from "react";
+import type { SlidePlugin } from "./plugin.js";
+import type { SlideValidationError } from "./schema.js";
+import type { SlideTheme } from "./themes/index.js";
+export type { SlideTheme } from "./themes/index.js";
+export type { SlideValidationError, SlideValidationErrorCode, } from "./schema.js";
+export type { SlidePlugin } from "./plugin.js";
+export interface SlideAspectRatio {
+    width: number;
+    height: number;
+}
+export interface SlideProps {
+    /**
+     * Slide markdown. CommonMark + GFM + optional YAML frontmatter delimited
+     * by `---`. Top-level horizontal rules (`---` on their own line outside
+     * frontmatter) imply a deck split and trigger `MULTIPLE_SLIDES`; only the
+     * first slide is rendered.
+     *
+     * Note: `<figure>`/`<figcaption>` tags are stripped by the default
+     * sanitize schema (D8). Use `<img>` directly for captionless images.
+     */
+    markdown: string;
+    /** Theme name. Defaults to `"default"`. */
+    theme?: SlideTheme;
+    /**
+     * Aspect ratio of the logical canvas. Default `"16:9"` → 1280×720.
+     * Custom `{ width, height }` accepted; zero/negative/NaN fallback to 16:9.
+     */
+    aspectRatio?: "16:9" | "4:3" | SlideAspectRatio;
+    /** Lower clamp for container-fit scale. Default 0.1. */
+    minScale?: number;
+    /** Upper clamp for container-fit scale. Default 4. */
+    maxScale?: number;
+    /** Best-effort callback invoked in useEffect when validation/sanitize emits errors. */
+    onValidationError?: (errors: SlideValidationError[]) => void;
+    /** Override individual element renderers (passed to hast-util-to-jsx-runtime). */
+    components?: Record<string, FC<any>>;
+    /**
+     * Rich-content plugins (Tier 2). Each plugin transforms the mdast/hast tree
+     * or adds React component overrides. Pass MEMOIZED arrays to avoid re-parses
+     * on every render (D15).
+     *
+     * @example
+     *   const plugins = useMemo(() => [emojiPlugin(), shikiPlugin()], []);
+     *   <Slide markdown={md} plugins={plugins} />
+     */
+    plugins?: SlidePlugin[];
+    /** Accessible label for the slide. Defaults to `"Slide"`. */
+    "aria-label"?: string;
+    /** Optional class applied to the outer host element (sizing/positioning hook). */
+    className?: string;
+}
+export declare const Slide: FC<SlideProps>;

package/dist/components/primitives/slide/themes/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Theme registry for the Slide primitive. Built-in themes that ship with the
+ * `@theokit/ui/slide` subpath. Custom themes are NOT registered through this
+ * module in v0.1 — consumers override CSS variables on `.theo-slide` directly.
+ */
+export declare const slideThemes: readonly ["default", "violet-forge"];
+export type SlideTheme = (typeof slideThemes)[number];
+/** Returns true if `value` is a recognized built-in theme. */
+export declare function isSlideTheme(value: unknown): value is SlideTheme;

package/dist/components/primitives/slide/use-slide-fit.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Container-fit hook for the Slide primitive.
+ *
+ * Observes the host element via `ResizeObserver` and computes a CSS scale
+ * factor that fits the fixed logical canvas (default 1280×720) inside it,
+ * preserving aspect ratio. Clamped to `[minScale, maxScale]`.
+ *
+ * Algorithm: `scale = clamp(min(W / canvasW, H / canvasH), min, max)`.
+ *
+ * Adapted from Reveal.js `transformSlides` (see reference doc §4.5 / §14.2).
+ *
+ * Cleanup: disconnects the observer on unmount or when deps change.
+ */
+import { type RefObject } from "react";
+export interface UseSlideFitOptions {
+    /** Lower clamp for scale. Default 0.1. */
+    minScale?: number;
+    /** Upper clamp for scale. Default 4. */
+    maxScale?: number;
+}
+export declare function useSlideFit(ref: RefObject<HTMLElement | null>, canvasW: number, canvasH: number, opts?: UseSlideFitOptions): number;

package/dist/components/primitives/slide/validate.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Async validator for slide markdown input.
+ *
+ * Returns `Promise<ValidationResult>` (ADR D11 — sync impossible because
+ * `yaml` and `mdast-util-from-markdown` are lazy-imported peer-deps).
+ *
+ * Pipeline:
+ *   1. Strip BOM + extract frontmatter (`frontmatter.ts`).
+ *   2. Reject `FRONTMATTER_TOO_LARGE` early if raw > 10 KB (ADR D14).
+ *   3. Parse YAML in safe mode → validate against `slideFrontmatter` (Zod).
+ *   4. Validate body length → emit `CONTENT_TOO_LARGE` if > 50 KB.
+ *   5. Detect multi-slide via mdast `thematicBreak` walk (ADR D12) — not
+ *      a regex, so `---` inside fenced code blocks does not false-positive.
+ *   6. Return `{ ok, input, errors[] }`.
+ *
+ * Errors are structured so an LLM can self-correct from the callback.
+ */
+import { type SlideInput, type SlideValidationError } from "./schema.js";
+export type ValidationResult = {
+    ok: true;
+    input: SlideInput;
+    errors: SlideValidationError[];
+} | {
+    ok: false;
+    errors: SlideValidationError[];
+};
+/**
+ * Validate the markdown input. Returns errors structured for LLM self-correction.
+ *
+ * Async because frontmatter YAML parsing and mdast multi-slide detection both
+ * use lazy-imported peer-deps (yaml + mdast-util-from-markdown).
+ */
+export declare function validateSlide(markdown: string): Promise<ValidationResult>;

package/dist/components/primitives/social-auth-row/index.d.ts

@@ -0,0 +1 @@
+export { SocialAuthRow, type SocialProvider } from "./social-auth-row.js";

package/dist/components/primitives/social-auth-row/social-auth-row.d.ts

@@ -0,0 +1,24 @@
+import type { HTMLAttributes, ReactNode } from "react";
+import type { IconComponent } from "../../../lib/types.js";
+export interface SocialProvider {
+    id: string;
+    label: ReactNode;
+    /** Icon component (e.g. brand-specific SVG). */
+    icon: IconComponent;
+}
+interface SocialAuthRowProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSelect"> {
+    providers: SocialProvider[];
+    onSelect?: (id: string) => void;
+    /**
+     * Stack vertically instead of horizontally (single-column flow).
+     */
+    vertical?: boolean;
+}
+/**
+ * SocialAuthRow — row of OAuth provider buttons.
+ *
+ * Stateless; caller wires the redirect on `onSelect`. Buttons share Theo button
+ * styling but with provider icon prominently on the left.
+ */
+declare const SocialAuthRow: import("react").ForwardRefExoticComponent<SocialAuthRowProps & import("react").RefAttributes<HTMLDivElement>>;
+export { SocialAuthRow };

package/dist/components/primitives/stat-tile/index.d.ts

@@ -0,0 +1 @@
+export { StatTile, type StatTileProps } from "./stat-tile.js";

package/dist/components/primitives/stat-tile/stat-tile.d.ts

@@ -0,0 +1,28 @@
+import type { ButtonHTMLAttributes, ElementType, ReactNode } from "react";
+/**
+ * StatTile — big number + label + optional delta + optional icon.
+ *
+ * Dual mode based on `onClick`:
+ *   - With onClick → renders as `<button>` with hover state + trailing
+ *     ArrowUpRight chevron (navigation affordance).
+ *   - Without onClick → renders as static `<div>`.
+ *
+ * Delta trend drives icon + color: up=success/TrendingUp, down=destructive/
+ * TrendingDown, flat=muted/Minus. Big value uses font-display + tabular-nums.
+ *
+ * @example
+ *   <StatTile value="42" label="Projects" />
+ *   <StatTile value="$1,234" label="MRR" icon={DollarSign}
+ *             delta={{ value: "+12%", trend: "up" }} onClick={openBilling} />
+ */
+export interface StatTileProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "type" | "value"> {
+    value: ReactNode;
+    label: ReactNode;
+    icon?: ElementType;
+    delta?: {
+        value: ReactNode;
+        trend: "up" | "down" | "flat";
+    };
+}
+declare const StatTile: import("react").ForwardRefExoticComponent<StatTileProps & import("react").RefAttributes<HTMLElement>>;
+export { StatTile };

package/dist/components/primitives/status-dot/index.d.ts

@@ -0,0 +1 @@
+export { StatusDot, type StatusDotProps, type StatusKind } from "./status-dot.js";

package/dist/components/primitives/status-dot/status-dot.d.ts

@@ -0,0 +1,31 @@
+import type { HTMLAttributes, ReactNode } from "react";
+/**
+ * StatusDot — semantic status indicator (colored circle + optional label).
+ *
+ * Five status kinds:
+ *   - `live`     — deployed / verified / healthy (success)
+ *   - `building` — in-progress / queued (warning, auto-pulses)
+ *   - `failed`   — error / down / rejected (destructive)
+ *   - `idle`     — pending / offline (muted)
+ *   - `warning`  — degraded but functional (warning, static)
+ *
+ * Three sizes (xs 6px, sm 8px default, md 10px). `pulse` defaults to
+ * `true` for `building` and `false` otherwise; passing `pulse` explicitly
+ * overrides the auto behavior. When no visible `label` AND no `aria-label`
+ * are provided, the component auto-applies `aria-label={status}` and
+ * emits a dev-mode warning (a status communicated only by color is
+ * invisible to screen readers).
+ *
+ * @example
+ *   <StatusDot status="live" label="Production" />
+ *   <StatusDot status="building" />            // auto-pulses + auto-aria-label
+ */
+export type StatusKind = "live" | "building" | "failed" | "idle" | "warning";
+export interface StatusDotProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children"> {
+    status: StatusKind;
+    label?: ReactNode;
+    size?: "xs" | "sm" | "md";
+    pulse?: boolean;
+}
+declare const StatusDot: import("react").ForwardRefExoticComponent<StatusDotProps & import("react").RefAttributes<HTMLSpanElement>>;
+export { StatusDot };

package/dist/components/primitives/steps-rail/index.d.ts

@@ -0,0 +1 @@
+export { StepsRail, type RailStep } from "./steps-rail.js";

package/dist/components/primitives/steps-rail/steps-rail.d.ts

@@ -0,0 +1,24 @@
+import type { HTMLAttributes, ReactNode } from "react";
+export interface RailStep {
+    id: string | number;
+    label?: ReactNode;
+    /**
+     * Visual state: "complete", "current", "pending".
+     */
+    state?: "complete" | "current" | "pending";
+}
+interface StepsRailProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    steps: RailStep[];
+    /**
+     * Optional label rendered at the top of the rail (e.g. "STEPS").
+     */
+    title?: ReactNode;
+}
+/**
+ * StepsRail — vertical numbered rail with connecting line.
+ *
+ * Mirrors the file-organisation wiremock right rail: 5 numbered dots, current
+ * highlighted, line connecting them.
+ */
+declare const StepsRail: import("react").ForwardRefExoticComponent<StepsRailProps & import("react").RefAttributes<HTMLElement>>;
+export { StepsRail };

package/dist/components/primitives/sub-agent-dispatch/index.d.ts

@@ -0,0 +1 @@
+export { SubAgentDispatch, type SubAgentRun, type SubAgentState, } from "./sub-agent-dispatch.js";

package/dist/components/primitives/sub-agent-dispatch/sub-agent-dispatch.d.ts

@@ -0,0 +1,30 @@
+import type { HTMLAttributes, ReactNode } from "react";
+export type SubAgentState = "spawning" | "running" | "completed" | "failed" | "cancelled";
+export interface SubAgentRun {
+    id: string;
+    /** Profile name (matches AgentProfile.name). */
+    agent: string;
+    /** Short task description given to the sub-agent. */
+    task: string;
+    state: SubAgentState;
+    /** Optional duration label. */
+    duration?: string;
+    /** Optional last status line (preview of the latest event). */
+    lastEvent?: string;
+    /** Optional result summary (one-liner). */
+    result?: ReactNode;
+}
+interface SubAgentDispatchProps extends HTMLAttributes<HTMLElement> {
+    run: SubAgentRun;
+    /** When provided, renders a cancel button while the run is in flight. */
+    onCancel?: (id: string) => void;
+}
+/**
+ * SubAgentDispatch — visualization for a Task() / sub-agent invocation.
+ *
+ * Shows the agent name, the task summary, current state, an inline event
+ * preview, and an optional result. Use inside the agent timeline to make
+ * delegation visible.
+ */
+declare const SubAgentDispatch: import("react").ForwardRefExoticComponent<SubAgentDispatchProps & import("react").RefAttributes<HTMLElement>>;
+export { SubAgentDispatch };

package/dist/components/primitives/switch/index.d.ts

@@ -0,0 +1 @@
+export { Switch } from "./switch.js";

package/dist/components/primitives/switch/switch.d.ts

@@ -0,0 +1,20 @@
+import * as SwitchPrimitive from "@radix-ui/react-switch";
+import { type VariantProps } from "class-variance-authority";
+import type { ComponentPropsWithoutRef } from "react";
+/**
+ * Switch — built on Radix Switch. Used for binary toggles (autoaccept,
+ * dark mode preview, feature flags).
+ *
+ * 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 switchVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+interface SwitchProps extends ComponentPropsWithoutRef<typeof SwitchPrimitive.Root>, VariantProps<typeof switchVariants> {
+}
+declare const Switch: import("react").ForwardRefExoticComponent<SwitchProps & import("react").RefAttributes<HTMLButtonElement>>;
+export { Switch, switchVariants };

package/dist/components/primitives/system-prompt-editor/index.d.ts

@@ -0,0 +1 @@
+export { SystemPromptEditor } from "./system-prompt-editor.js";

package/dist/components/primitives/system-prompt-editor/system-prompt-editor.d.ts

@@ -0,0 +1,25 @@
+import type { HTMLAttributes, ReactNode } from "react";
+interface SystemPromptEditorProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    /** Vendor / default system prompt (read-only). */
+    defaultPrompt: string;
+    /** Current override; pass empty string for "use default". */
+    override: string;
+    onOverrideChange: (next: string) => void;
+    /** Approximate token count for the active prompt. */
+    tokenEstimate?: number;
+    title?: ReactNode;
+}
+/**
+ * SystemPromptEditor — surface the agent's system prompt with a clear
+ * "vendor default" vs "user override" toggle.
+ *
+ * Behavior:
+ *   - When override is empty, the textarea shows the default (greyed out,
+ *     editable starts blank).
+ *   - When user types, override takes effect.
+ *   - "Reset to default" wipes the override.
+ *
+ * Critical for transparency: a user must be able to see and edit the prompt.
+ */
+declare const SystemPromptEditor: import("react").ForwardRefExoticComponent<SystemPromptEditorProps & import("react").RefAttributes<HTMLDivElement>>;
+export { SystemPromptEditor };

package/dist/components/primitives/table/index.d.ts

@@ -0,0 +1 @@
+export { Table, type TableProps, type TableCellProps, type TableHeaderCellProps, } from "./table.js";

package/dist/components/primitives/table/table.d.ts

@@ -0,0 +1,61 @@
+import type { HTMLAttributes, TdHTMLAttributes, ThHTMLAttributes } from "react";
+/**
+ * Table — semantic data table primitive with sub-components.
+ *
+ * Composition:
+ *   <Table density="default">
+ *     <Table.Header>
+ *       <Table.Row>
+ *         <Table.HeaderCell>Date</Table.HeaderCell>
+ *         <Table.HeaderCell align="right">Amount</Table.HeaderCell>
+ *       </Table.Row>
+ *     </Table.Header>
+ *     <Table.Body>
+ *       <Table.Row>
+ *         <Table.Cell>2026-05-23</Table.Cell>
+ *         <Table.Cell align="right" numeric>$ 42.00</Table.Cell>
+ *       </Table.Row>
+ *     </Table.Body>
+ *   </Table>
+ *
+ * density propagates via Context so Cells pick up vertical padding without
+ * prop drilling. Sub-components are attached as static properties on the
+ * root (`Table.Header`, etc.) — single import surface.
+ *
+ * Sortable header: pass `onSort` + `sortDirection`. The HeaderCell renders
+ * the sort affordance (ChevronUp/ChevronDown) and triggers the consumer
+ * callback. `sortDirection` without `onSort` is a no-op (header stays
+ * static); `sortDirection="none"` with `onSort` shows a dimmed affordance.
+ */
+type TableDensity = "default" | "compact";
+type AlignKind = "left" | "center" | "right";
+type SortDirection = "asc" | "desc" | "none";
+export interface TableProps extends HTMLAttributes<HTMLTableElement> {
+    density?: TableDensity;
+}
+declare const Root: import("react").ForwardRefExoticComponent<TableProps & import("react").RefAttributes<HTMLTableElement>>;
+declare const Header: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLTableSectionElement> & import("react").RefAttributes<HTMLTableSectionElement>>;
+declare const Body: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLTableSectionElement> & import("react").RefAttributes<HTMLTableSectionElement>>;
+declare const Row: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLTableRowElement> & import("react").RefAttributes<HTMLTableRowElement>>;
+export interface TableCellProps extends TdHTMLAttributes<HTMLTableCellElement> {
+    align?: AlignKind;
+    numeric?: boolean;
+}
+declare const Cell: import("react").ForwardRefExoticComponent<TableCellProps & import("react").RefAttributes<HTMLTableCellElement>>;
+export interface TableHeaderCellProps extends ThHTMLAttributes<HTMLTableCellElement> {
+    align?: AlignKind;
+    /** When provided, header becomes a sort trigger. */
+    onSort?: () => void;
+    /** Current sort state for this column. */
+    sortDirection?: SortDirection;
+}
+declare const HeaderCell: import("react").ForwardRefExoticComponent<TableHeaderCellProps & import("react").RefAttributes<HTMLTableCellElement>>;
+type TableRoot = typeof Root & {
+    Header: typeof Header;
+    Body: typeof Body;
+    Row: typeof Row;
+    Cell: typeof Cell;
+    HeaderCell: typeof HeaderCell;
+};
+declare const Table: TableRoot;
+export { Table };

package/dist/components/primitives/tabs/index.d.ts

@@ -0,0 +1 @@
+export { Tabs } from "./tabs.js";

package/dist/components/primitives/tabs/tabs.d.ts

@@ -0,0 +1,7 @@
+import * as TabsPrimitive from "@radix-ui/react-tabs";
+declare const Tabs: import("react").ForwardRefExoticComponent<TabsPrimitive.TabsProps & import("react").RefAttributes<HTMLDivElement>> & {
+    List: import("react").ForwardRefExoticComponent<Omit<TabsPrimitive.TabsListProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+    Trigger: import("react").ForwardRefExoticComponent<Omit<TabsPrimitive.TabsTriggerProps & import("react").RefAttributes<HTMLButtonElement>, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
+    Content: import("react").ForwardRefExoticComponent<Omit<TabsPrimitive.TabsContentProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+};
+export { Tabs };

package/dist/components/primitives/task-plan/index.d.ts

@@ -0,0 +1 @@
+export { TaskNode, TaskPlan, type PlanNode, type PlanNodeStatus } from "./task-plan.js";

package/dist/components/primitives/task-plan/task-plan.d.ts

@@ -0,0 +1,36 @@
+import type { HTMLAttributes, ReactNode } from "react";
+export type PlanNodeStatus = "pending" | "running" | "done" | "skipped" | "failed";
+export interface PlanNode {
+    id: string;
+    label: string;
+    status: PlanNodeStatus;
+    /** Optional details / sub-explanation. */
+    detail?: string;
+    /** Sub-nodes (rendered indented). */
+    children?: PlanNode[];
+}
+interface TaskNodeProps extends HTMLAttributes<HTMLLIElement> {
+    node: PlanNode;
+    depth?: number;
+}
+/**
+ * TaskNode — single row in a task plan. Renders its own children recursively
+ * with increasing indentation.
+ */
+declare const TaskNode: import("react").ForwardRefExoticComponent<TaskNodeProps & import("react").RefAttributes<HTMLLIElement>>;
+interface TaskPlanProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    nodes: PlanNode[];
+    /** Header title. */
+    title?: ReactNode;
+    /** Summary line shown next to the title (e.g. "3 of 7 done"). */
+    summary?: ReactNode;
+}
+/**
+ * TaskPlan — hierarchical task plan, à la Claude "plan mode".
+ *
+ * The agent emits a structured plan; the user sees each step progress from
+ * pending → running → done (or failed/skipped). Children render with one
+ * extra indent level and a left border to suggest hierarchy.
+ */
+declare const TaskPlan: import("react").ForwardRefExoticComponent<TaskPlanProps & import("react").RefAttributes<HTMLElement>>;
+export { TaskNode, TaskPlan };

package/dist/components/primitives/terminal-panel/index.d.ts

@@ -0,0 +1 @@
+export { TerminalPanel, type TerminalLine } from "./terminal-panel.js";

package/dist/components/primitives/terminal-panel/terminal-panel.d.ts

@@ -0,0 +1,32 @@
+import type { HTMLAttributes, ReactNode } from "react";
+export interface TerminalLine {
+    id: string;
+    /**
+     * Visual kind: command (prompted), stdout, stderr, ok (success), prompt (active line).
+     */
+    kind?: "command" | "stdout" | "stderr" | "ok" | "prompt";
+    content: ReactNode;
+}
+interface TerminalPanelProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    title?: ReactNode;
+    lines: TerminalLine[];
+    /**
+     * Optional prompt prefix for commands, defaults to "$".
+     */
+    promptPrefix?: string;
+    /**
+     * Live-region politeness for screen readers. Use `"polite"` when streaming
+     * fresh output so assistive tech announces new lines without interrupting.
+     * Default `"off"` for static / historical views.
+     */
+    live?: "off" | "polite";
+}
+/**
+ * TerminalPanel — minimal terminal output viewer.
+ *
+ * Visual: dark card with mono font, "$ " prefix on command lines, color-coded
+ * stdout/stderr/success. No interactivity (read-only) — pair with your own
+ * pty/xterm for live shells if needed.
+ */
+declare const TerminalPanel: import("react").ForwardRefExoticComponent<TerminalPanelProps & import("react").RefAttributes<HTMLDivElement>>;
+export { TerminalPanel };

package/dist/components/primitives/textarea/index.d.ts

@@ -0,0 +1 @@
+export { Textarea, type TextareaProps } from "./textarea.js";

package/dist/components/primitives/textarea/textarea.d.ts

@@ -0,0 +1,20 @@
+import { type VariantProps } from "class-variance-authority";
+import type { TextareaHTMLAttributes } from "react";
+/**
+ * Textarea — multi-line input mirror of Input.
+ *
+ * Matches Input visuals (violet focus ring, --input border, --card bg).
+ * 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;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElement>, VariantProps<typeof textareaVariants> {
+}
+declare const Textarea: import("react").ForwardRefExoticComponent<TextareaProps & import("react").RefAttributes<HTMLTextAreaElement>>;
+export { Textarea, textareaVariants };

package/dist/components/primitives/thinking-level-selector/index.d.ts

@@ -0,0 +1 @@
+export { ThinkingLevelSelector, type ThinkingLevel, type ThinkingLevelOrInherited, type ThinkingLevelSelectorProps, } from "./thinking-level-selector.js";

package/dist/components/primitives/thinking-level-selector/thinking-level-selector.d.ts

@@ -0,0 +1,24 @@
+/**
+ * ThinkingLevelSelector — multi-state combobox for LLM reasoning budget.
+ *
+ * Mirrors the OpenClaw Control UI thinking selector. Values follow the SDK's
+ * `Agent.thinking` parameter ("minimal" | "low" | "medium" | "high" | "xhigh")
+ * plus a sentinel "off" and the special "inherited" mode that means "use the
+ * value resolved by the parent agent/session".
+ *
+ * Pure UI primitive. No backend dependency. Consumer wires `value` from agent
+ * state and persists `onChange` selections wherever it pleases.
+ *
+ * Phase 1 of `theokit-ui-parity-plan.md` (T1.1).
+ */
+export type ThinkingLevel = "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
+export type ThinkingLevelOrInherited = ThinkingLevel | "inherited";
+export interface ThinkingLevelSelectorProps {
+    value: ThinkingLevelOrInherited;
+    inheritedValue?: ThinkingLevel;
+    onChange: (value: ThinkingLevelOrInherited) => void;
+    disabled?: boolean;
+    className?: string;
+    "data-testid"?: string;
+}
+export declare const ThinkingLevelSelector: import("react").ForwardRefExoticComponent<ThinkingLevelSelectorProps & import("react").RefAttributes<HTMLSelectElement>>;

package/dist/components/primitives/timestamp/index.d.ts

@@ -0,0 +1 @@
+export { Timestamp, type TimestampProps } from "./timestamp.js";

package/dist/components/primitives/timestamp/timestamp.d.ts

@@ -0,0 +1,34 @@
+import type { TimeHTMLAttributes } from "react";
+/**
+ * Timestamp — accessible relative/absolute time primitive.
+ *
+ * Renders a semantic `<time datetime>` element. Format modes:
+ *   - `relative` (default) — "just now", "5 minutes ago", "2 hours ago",
+ *     "Dec 5" (>7d), "Dec 5, 2024" (different year)
+ *   - `absolute` — full localized date+time
+ *   - `both` — "Dec 5, 2026 (2 hours ago)"
+ *
+ * Uses zero-dep `Intl.RelativeTimeFormat`. The tooltip on hover is the
+ * HTML `title` attribute (not the `<Tooltip>` component) — keeps this
+ * file a true primitive without sibling-primitive imports.
+ *
+ * Auto-refreshes via `setInterval` (default 60_000ms); pass
+ * `refreshInterval={0}` to disable. `aria-label` always carries the
+ * absolute time so screen readers read "May 23, 2026 14:32 — posted
+ * 2 hours ago".
+ *
+ * @param value Source date — ISO string, Date object, or **Unix ms**
+ *              (NOT seconds). Passing seconds renders ~1970.
+ */
+export interface TimestampProps extends Omit<TimeHTMLAttributes<HTMLTimeElement>, "children"> {
+    value: string | Date | number;
+    format?: "relative" | "absolute" | "both";
+    /** Auto-refresh interval when format=relative. Default 60000. 0 disables. */
+    refreshInterval?: number;
+    /** Locale for absolute formatting + Intl.RelativeTimeFormat. Default browser locale. */
+    locale?: string;
+    /** When true, omit the `title` tooltip. */
+    noTooltip?: boolean;
+}
+declare const Timestamp: import("react").ForwardRefExoticComponent<TimestampProps & import("react").RefAttributes<HTMLTimeElement>>;
+export { Timestamp };

package/dist/components/primitives/toast/index.d.ts

@@ -0,0 +1,2 @@
+export { Toast, type ToastVariant } from "./toast.js";
+export { Toaster, useToast } from "./toaster.js";

package/dist/components/primitives/toast/toast.d.ts

@@ -0,0 +1,34 @@
+import * as ToastPrimitive from "@radix-ui/react-toast";
+import { type VariantProps } from "class-variance-authority";
+import type { ComponentPropsWithoutRef } from "react";
+/**
+ * Toast — transient notification built on Radix Toast.
+ *
+ * Composition: app mounts <Toaster /> once. Components call `toast(...)` via
+ * the `useToast()` hook (see toaster.tsx). The look is theme-aware: status
+ * icon coloured by --primary/--success/--warning/--destructive; the body
+ * card uses --popover surface.
+ *
+ * Variants:
+ *   - default (neutral)
+ *   - info (primary tint)
+ *   - success (deploy ok, action completed)
+ *   - warning (queued, permission requested)
+ *   - destructive (failed, fatal)
+ */
+declare const toastVariants: (props?: ({
+    variant?: "success" | "warning" | "destructive" | "info" | "default" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+type ToastVariant = NonNullable<VariantProps<typeof toastVariants>["variant"]>;
+interface ToastProps extends ComponentPropsWithoutRef<typeof ToastPrimitive.Root>, VariantProps<typeof toastVariants> {
+}
+declare const Toast: import("react").ForwardRefExoticComponent<ToastProps & import("react").RefAttributes<HTMLLIElement>> & {
+    Title: import("react").ForwardRefExoticComponent<Omit<ToastPrimitive.ToastTitleProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+    Description: import("react").ForwardRefExoticComponent<Omit<ToastPrimitive.ToastDescriptionProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+    Close: import("react").ForwardRefExoticComponent<Omit<ToastPrimitive.ToastCloseProps & import("react").RefAttributes<HTMLButtonElement>, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
+    Action: import("react").ForwardRefExoticComponent<Omit<ToastPrimitive.ToastActionProps & import("react").RefAttributes<HTMLButtonElement>, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
+    Provider: import("react").FC<ToastPrimitive.ToastProviderProps>;
+    Viewport: import("react").ForwardRefExoticComponent<ToastPrimitive.ToastViewportProps & import("react").RefAttributes<HTMLOListElement>>;
+};
+export { Toast, toastVariants, type ToastVariant };