@pcoi/components 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,667 @@
+import { default as default_2 } from 'react';
+
+/**
+ * PCOI Badge — Small label for status indicators, categories, and counts
+ * Tokens: surface/accent-dim, text/accent, text/success, text/error,
+ *         text/warning, text/info, radius-full, font-family/mono
+ */
+export declare const Badge: default_2.ForwardRefExoticComponent<BadgeProps & default_2.RefAttributes<HTMLSpanElement>>;
+
+export declare interface BadgeProps extends default_2.HTMLAttributes<HTMLSpanElement> {
+    /** Badge content */
+    children: default_2.ReactNode;
+    /** Color variant */
+    variant?: BadgeVariant;
+}
+
+export declare type BadgeVariant = "default" | "success" | "error" | "warning" | "info";
+
+/**
+ * PCOI Button Component
+ *
+ * Variants:
+ *   - primary: Gold accent bg, dark text. Hero CTA, form submit.
+ *   - ghost: Transparent bg, subtle border. Secondary actions.
+ *   - nav-cta: Compact primary for navigation bar.
+ *
+ * Tokens consumed:
+ *   - action/primary-bg, action/primary-bg-hover, action/primary-text
+ *   - action/ghost-bg, action/ghost-border, action/ghost-text
+ *   - radius-sm, transition/fast
+ *   - shadow/btn-primary-hover, transform/hover-lift
+ */
+export declare const Button: default_2.ForwardRefExoticComponent<ButtonProps & default_2.RefAttributes<HTMLButtonElement>>;
+
+export declare interface ButtonProps extends default_2.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Visual variant */
+    variant?: ButtonVariant;
+    /** Size preset */
+    size?: ButtonSize;
+    /** Content */
+    children: default_2.ReactNode;
+}
+
+export declare type ButtonSize = "default" | "large";
+
+export declare type ButtonVariant = "primary" | "ghost" | "nav-cta";
+
+/**
+ * PCOI Callout / Blockquote
+ * Tokens: spacing-40 (padding), text/secondary, text/accent (link)
+ */
+export declare const Callout: default_2.ForwardRefExoticComponent<CalloutProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface CalloutProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Quote text */
+    quote: string;
+    /** Attribution name */
+    attribution?: string;
+    /** Attribution title/context */
+    attributionTitle?: string;
+    /** Link URL */
+    sourceUrl?: string;
+    /** Link label */
+    sourceLabel?: string;
+}
+
+/**
+ * PCOI Card Component
+ *
+ * Three variants extracted from pcoi.ai:
+ *   - problem: bg-card, icon box + title + description (Problem section)
+ *   - who: surface bg, accent title (Who It's For section)
+ *   - principle: bg-card, roman numeral + title + description (Principles section)
+ *
+ * Tokens consumed:
+ *   - bg/card, bg/surface, border/default, border/hover
+ *   - radius-md, spacing-36 (padding), spacing-20 (icon margin)
+ *   - text/primary, text/secondary, text/accent
+ *   - transition/medium, transform/hover-lift
+ */
+export declare const Card: default_2.ForwardRefExoticComponent<CardProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface CardProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Card visual variant */
+    variant?: CardVariant;
+    /** Card title */
+    title: string;
+    /** Card body text */
+    description: string;
+    /** Icon element (for problem cards) */
+    icon?: default_2.ReactNode;
+    /** Roman numeral or number (for principle cards) */
+    number?: string;
+    /** Heading level for the title (default: "h3") */
+    headingLevel?: HeadingLevel;
+}
+
+export declare type CardVariant = "problem" | "who" | "principle";
+
+/**
+ * PCOI ChatInterface — Top-level chat composition
+ * Empty state: suggestions + prompt. Active state: messages + prompt.
+ * Tokens: bg/default, container/narrow, spacing-16/24
+ */
+export declare const ChatInterface: default_2.ForwardRefExoticComponent<ChatInterfaceProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface ChatInterfaceMessage {
+    id: string;
+    role: ChatMessageRole;
+    content: default_2.ReactNode;
+    citations?: Citation[];
+    timestamp?: string;
+}
+
+export declare interface ChatInterfaceProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Conversation messages */
+    messages: ChatInterfaceMessage[];
+    /** Suggestion prompts for the empty state */
+    suggestions?: Suggestion[];
+    /** Current prompt textarea value */
+    promptValue: string;
+    /** Called when the prompt textarea changes */
+    onPromptChange: (value: string) => void;
+    /** Called when the user submits a prompt */
+    onPromptSubmit: (value: string) => void;
+    /** Called when a suggestion card is clicked */
+    onSuggestionSelect?: (suggestion: Suggestion) => void;
+    /** Called when a citation is clicked */
+    onCitationClick?: (citation: Citation) => void;
+    /** Textarea placeholder */
+    placeholder?: string;
+    /** Disable input while loading */
+    loading?: boolean;
+}
+
+/**
+ * PCOI ChatMessage — User or assistant message bubble
+ * Tokens: surface/elevated (user), bg/card (assistant), border/card,
+ *         radius-md, text/primary, text/muted, type/body-size
+ */
+export declare const ChatMessage: default_2.ForwardRefExoticComponent<ChatMessageProps & default_2.RefAttributes<HTMLDivElement>>;
+
+/**
+ * PCOI ChatMessageList — Scrollable container that auto-scrolls to newest message
+ * Tokens: spacing-16/20 (gap), spacing-16/24 (padding)
+ */
+export declare const ChatMessageList: default_2.ForwardRefExoticComponent<ChatMessageListProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface ChatMessageListProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** ChatMessage elements */
+    children: default_2.ReactNode;
+}
+
+export declare interface ChatMessageProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Message sender role */
+    role: ChatMessageRole;
+    /** Message body content */
+    children: default_2.ReactNode;
+    /** Citations referenced in the message */
+    citations?: Citation[];
+    /** Displayed below the message body */
+    timestamp?: string;
+    /** Called when a citation marker or source link is clicked */
+    onCitationClick?: (citation: Citation) => void;
+}
+
+/** Chat message sender role */
+export declare type ChatMessageRole = "user" | "assistant";
+
+/**
+ * PCOI Checkbox — Custom styled checkbox with label
+ * Tokens: bg/default, border/default, border/error, focus/border, focus/glow,
+ *         action/primary-bg, action/primary-text, text/primary, text/error, radius-sm
+ */
+export declare const Checkbox: default_2.ForwardRefExoticComponent<CheckboxProps & default_2.RefAttributes<HTMLInputElement>>;
+
+export declare interface CheckboxProps extends Omit<default_2.InputHTMLAttributes<HTMLInputElement>, "type" | "size"> {
+    /** Visible label text */
+    label: string;
+    /** Unique field name, also used to generate id */
+    name: string;
+    /** Error message — when truthy, field enters error state */
+    error?: string;
+}
+
+/** Citation reference from an assistant response */
+export declare interface Citation {
+    /** Unique citation index (1-based) */
+    index: number;
+    /** Short excerpt from the source document */
+    excerpt: string;
+    /** Source document title */
+    sourceTitle: string;
+    /** Source document identifier (e.g. URL or document ID) */
+    sourceId: string;
+}
+
+/**
+ * PCOI CitedExcerpt — Blockquote with excerpt text above, clickable index + source below
+ * Tokens: surface/accent-dim, border/accent-dim, accent-border-w,
+ *         radius-sm, text/secondary, text/accent, type/body-compact-size
+ */
+export declare const CitedExcerpt: default_2.ForwardRefExoticComponent<CitedExcerptProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface CitedExcerptProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** 1-based citation index */
+    index: number;
+    /** Short excerpt from the source document */
+    excerpt: string;
+    /** Source document title */
+    sourceTitle: string;
+    /** Called when the source link is clicked */
+    onSourceClick?: () => void;
+}
+
+export declare interface ComparisonRow {
+    label: string;
+    competitor: string;
+    pcoi: string;
+}
+
+/**
+ * PCOI Comparison Table
+ * Semantic <table> with 3 columns: label | competitor | PCOI (highlighted)
+ * Tokens: radius-md, border/default, bg/alt, surface/accent-dim, text/accent
+ */
+export declare const ComparisonTable: default_2.ForwardRefExoticComponent<ComparisonTableProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface ComparisonTableProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    competitorName?: string;
+    pcoiName?: string;
+    rows: ComparisonRow[];
+}
+
+/**
+ * PCOI Contact Form
+ * Composes: FormField (atom), Button (atom)
+ * Tokens: bg/surface, border/default, radius-lg, spacing-40 (padding), spacing-20 (gap)
+ */
+export declare const ContactForm: default_2.ForwardRefExoticComponent<ContactFormProps & default_2.RefAttributes<HTMLFormElement>>;
+
+export declare interface ContactFormProps extends default_2.FormHTMLAttributes<HTMLFormElement> {
+    onSubmit?: (data: Record<string, string>) => void;
+}
+
+/**
+ * PCOI DataTable — Presentational data table for dashboards
+ * Tokens: bg/card-hover, border/default, text/primary, text/secondary,
+ *         font-size/caption/body-default, spacing-12/16
+ */
+export declare const DataTable: default_2.ForwardRefExoticComponent<DataTableProps<Record<string, unknown>> & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface DataTableColumn<T = Record<string, unknown>> {
+    /** Unique key matching a property on the row data */
+    key: string;
+    /** Column header text */
+    header: string;
+    /** Text alignment (default: "left") */
+    align?: "left" | "center" | "right";
+    /** Custom cell renderer */
+    render?: (value: unknown, row: T) => default_2.ReactNode;
+}
+
+export declare interface DataTableProps<T = Record<string, unknown>> extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Column definitions */
+    columns: DataTableColumn<T>[];
+    /** Row data */
+    rows: T[];
+    /** Key extractor for row identity */
+    rowKey?: keyof T | ((row: T, index: number) => string);
+    /** Empty state message */
+    emptyText?: string;
+    /** Accessible label for the table (describes its content for screen readers) */
+    ariaLabel?: string;
+}
+
+/**
+ * PCOI DocumentOverlay — Wide modal for viewing source documents with highlighted citations
+ * Composes Modal (size="wide") + Badge
+ * Tokens: surface/highlight, border/accent-subtle, container/document
+ */
+export declare const DocumentOverlay: default_2.ForwardRefExoticComponent<DocumentOverlayProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface DocumentOverlayProps extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "title"> {
+    /** Whether the overlay is visible */
+    open: boolean;
+    /** Called when the overlay should close */
+    onClose: () => void;
+    /** Document title shown in the header */
+    title: string;
+    /** Optional source label shown as a badge */
+    sourceLabel?: string;
+    /** Document body content */
+    children: default_2.ReactNode;
+    /** Element ID to scroll to and highlight on open */
+    highlightId?: string;
+    /** Citation index to display beside the highlighted element */
+    highlightIndex?: number;
+}
+
+/**
+ * PCOI Footer
+ * Tokens: border/default, spacing-60/40/24, text/secondary, text/muted
+ */
+export declare const Footer: default_2.ForwardRefExoticComponent<FooterProps & default_2.RefAttributes<HTMLElement>>;
+
+/** @deprecated Use `LinkItem` from `@pcoi/components` instead */
+export declare type FooterLink = LinkItem;
+
+export declare interface FooterProps extends default_2.HTMLAttributes<HTMLElement> {
+    links?: LinkItem[];
+    tagline?: string;
+    copyright?: string;
+}
+
+/**
+ * PCOI FormField — Label + input/textarea atom
+ * Tokens: bg/default, border/default, border/error, focus/border, focus/glow,
+ *         text/primary, text/secondary, text/muted, text/error,
+ *         radius-sm, spacing-6/12/14, font-size/caption/body-default
+ */
+export declare const FormField: default_2.ForwardRefExoticComponent<FormFieldProps & default_2.RefAttributes<HTMLInputElement | HTMLTextAreaElement>>;
+
+export declare interface FormFieldProps extends Omit<default_2.InputHTMLAttributes<HTMLInputElement | HTMLTextAreaElement>, "size"> {
+    /** Visible label text */
+    label: string;
+    /** Unique field name, also used to generate id */
+    name: string;
+    /** Render as textarea instead of input */
+    multiline?: boolean;
+    /** Number of visible text rows when multiline (default 3) */
+    rows?: number;
+    /** Error message — when truthy, field enters error state */
+    error?: string;
+}
+
+/** Semantic heading level for document outline (h1–h6) */
+export declare type HeadingLevel = "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+
+/**
+ * PCOI How-It-Works Step
+ * Tokens: spacing-32 (gap), spacing-40 (padding-y), border/default, radius-full (number circle)
+ */
+export declare const HowStep: default_2.ForwardRefExoticComponent<HowStepProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface HowStepProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Step number displayed in circle (e.g., "01") */
+    number: string;
+    /** Step title */
+    title: string;
+    /** Step description */
+    description: string;
+    /** Whether this is the last step (no bottom border) */
+    isLast?: boolean;
+    /** Heading level for the title (default: "h3") */
+    headingLevel?: HeadingLevel;
+}
+
+/** Navigation link used by Nav, Footer, and any link-list component */
+export declare interface LinkItem {
+    label: string;
+    href: string;
+    /** Optional tracking identifier rendered as data-track-id on the anchor */
+    trackingId?: string;
+}
+
+/**
+ * PCOI Logo Mark — Atom
+ *
+ * Renders the brand mark: accent-colored "P" + "COI" text wrapped in an anchor.
+ * Single-sourced so Nav, Footer, and any future component share one implementation.
+ *
+ * Tokens consumed:
+ *   - font-family/sans, font-size/logo, letterSpacing/logo
+ *   - text/primary, text/accent
+ */
+export declare const LogoMark: default_2.ForwardRefExoticComponent<LogoMarkProps & default_2.RefAttributes<HTMLAnchorElement>>;
+
+export declare interface LogoMarkProps extends default_2.AnchorHTMLAttributes<HTMLAnchorElement> {
+}
+
+/**
+ * PCOI Modal — Dialog overlay with focus trap
+ * Tokens: bg/overlay, surface/elevated, border/default, shadow/elevated,
+ *         zIndex/modal, radius-lg, text/primary, text/secondary
+ */
+export declare const Modal: default_2.FC<ModalProps>;
+
+export declare interface ModalProps extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "title"> {
+    /** Whether the modal is visible */
+    open: boolean;
+    /** Called when the modal should close */
+    onClose: () => void;
+    /** Modal title */
+    title?: string;
+    /** Heading level for the title (default: "h2") */
+    headingLevel?: HeadingLevel;
+    /** Dialog width: "default" (520px) or "wide" (900px) */
+    size?: "default" | "wide";
+    /** Modal body content */
+    children: default_2.ReactNode;
+    /** Footer content (e.g. action buttons) */
+    footer?: default_2.ReactNode;
+}
+
+/**
+ * PCOI Navigation Bar
+ *
+ * Fixed navbar with scroll-triggered backdrop, responsive hamburger menu.
+ * Tokens: bg/nav-scrolled, blur/nav-backdrop, border/nav, spacing-72 (height)
+ */
+export declare const Nav: default_2.ForwardRefExoticComponent<NavProps & default_2.RefAttributes<HTMLElement>>;
+
+/** @deprecated Use `LinkItem` from `@pcoi/components` instead */
+export declare type NavLink = LinkItem;
+
+export declare interface NavProps extends default_2.HTMLAttributes<HTMLElement> {
+    links?: LinkItem[];
+    ctaLabel?: string;
+    ctaHref?: string;
+    onCtaClick?: () => void;
+}
+
+/** Option item used by Select, RadioGroup */
+export declare interface OptionItem {
+    label: string;
+    value: string;
+    disabled?: boolean;
+}
+
+/**
+ * PCOI Panel — Dashboard section container with optional header
+ * Tokens: bg/card, border/default, radius-md, spacing-16/24, text/primary
+ */
+export declare const Panel: default_2.ForwardRefExoticComponent<PanelProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface PanelProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Panel title rendered in a header bar */
+    title?: string;
+    /** Heading level for the title (default: "h3") */
+    headingLevel?: HeadingLevel;
+    /** Action slot in the header (e.g. a Button or filter) */
+    action?: default_2.ReactNode;
+    /** Panel body content */
+    children: default_2.ReactNode;
+    /** Remove default body padding (for tables/charts that need edge-to-edge content) */
+    flush?: boolean;
+}
+
+/**
+ * PCOI PromptBar — Textarea + send button for chat input
+ * Tokens: bg/card, border/default, focus-border, radius-md,
+ *         text/primary, text/muted, transition-fast
+ */
+export declare const PromptBar: default_2.ForwardRefExoticComponent<PromptBarProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface PromptBarProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Current textarea value */
+    value: string;
+    /** Called when the textarea value changes */
+    onChange: (value: string) => void;
+    /** Called when the user submits (Enter or send button) */
+    onSubmit: (value: string) => void;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Disable input and send */
+    disabled?: boolean;
+    /** Show loading state on send button */
+    loading?: boolean;
+}
+
+/**
+ * PCOI RadioGroup — Accessible radio button group using fieldset/legend
+ * Tokens: bg/default, border/default, border/error, focus/border, focus/glow,
+ *         action/primary-bg, text/primary, text/secondary, text/error, radius-full
+ */
+export declare const RadioGroup: default_2.ForwardRefExoticComponent<RadioGroupProps & default_2.RefAttributes<HTMLFieldSetElement>>;
+
+export declare interface RadioGroupProps extends Omit<default_2.FieldsetHTMLAttributes<HTMLFieldSetElement>, "onChange"> {
+    /** Group label rendered as a fieldset legend */
+    label: string;
+    /** Shared name for all radio inputs */
+    name: string;
+    /** List of radio options */
+    options: OptionItem[];
+    /** Pre-selected value */
+    defaultValue?: string;
+    /** Error message — when truthy, group enters error state */
+    error?: string;
+    /** Marks the group as required */
+    required?: boolean;
+    /** Disables all radio inputs */
+    disabled?: boolean;
+    /** Called with the selected value when it changes */
+    onChange?: (value: string) => void;
+}
+
+/**
+ * PCOI Section Header
+ *
+ * Centered header pattern used across all major sections.
+ * Label + H2 + optional description, max-width 800px.
+ *
+ * Tokens consumed:
+ *   - text/accent (label), text/primary (h2), text/secondary (desc)
+ *   - font-mono (label), font-sans (h2, desc)
+ *   - spacing-16 (label mb, h2 mb), spacing-64 (section mb)
+ *   - container-narrow (800px max-width)
+ */
+export declare const SectionHeader: default_2.ForwardRefExoticComponent<SectionHeaderProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface SectionHeaderProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Section label (mono, uppercase, accent) e.g. "The Problem" */
+    label: string;
+    /** Main heading */
+    title: string;
+    /** Emphasized portion of title (renders in accent color) */
+    titleEmphasis?: string;
+    /** Optional subtitle/description */
+    description?: string;
+    /** Heading level for the title (default: "h2") */
+    headingLevel?: HeadingLevel;
+}
+
+/**
+ * PCOI Select — Native dropdown with custom styling
+ * Tokens: bg/default, border/default, border/error, focus/border, focus/glow,
+ *         text/primary, text/secondary, text/muted, text/error, radius-sm
+ */
+export declare const Select: default_2.ForwardRefExoticComponent<SelectProps & default_2.RefAttributes<HTMLSelectElement>>;
+
+export declare interface SelectProps extends Omit<default_2.SelectHTMLAttributes<HTMLSelectElement>, "size"> {
+    /** Visible label text */
+    label: string;
+    /** Unique field name, also used to generate id */
+    name: string;
+    /** List of options */
+    options: OptionItem[];
+    /** Placeholder text shown as first disabled option */
+    placeholder?: string;
+    /** Error message — when truthy, field enters error state */
+    error?: string;
+}
+
+/**
+ * PCOI Signals Panel — "You'll know this is for you if:" section
+ * Tokens: bg/surface, border/default, radius-md, spacing-40/48, text/accent
+ */
+export declare const SignalsPanel: default_2.ForwardRefExoticComponent<SignalsPanelProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface SignalsPanelProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    title?: string;
+    signals: string[];
+    /** Heading level for the title (default: "h3") */
+    headingLevel?: HeadingLevel;
+}
+
+/** Suggestion prompt for the chat empty state */
+export declare interface Suggestion {
+    /** Unique identifier */
+    id: string;
+    /** Display text */
+    label: string;
+    /** Optional icon rendered before the label */
+    icon?: React.ReactNode;
+}
+
+/**
+ * PCOI SuggestionCard — Clickable FAQ card for chat empty state
+ * Tokens: bg/card, bg/card-hover, border/card, border/card-hover,
+ *         text/secondary, text/accent, radius-md, transition-medium,
+ *         transform/hover-lift-sm, transform/press-scale, shadow/focus-ring
+ */
+export declare const SuggestionCard: default_2.ForwardRefExoticComponent<SuggestionCardProps & default_2.RefAttributes<HTMLButtonElement>>;
+
+export declare interface SuggestionCardProps extends default_2.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Display text */
+    label: string;
+    /** Optional icon rendered before the label */
+    icon?: default_2.ReactNode;
+}
+
+/**
+ * PCOI SuggestionCards — 3-column grid of suggestion cards for chat empty state
+ * Tokens: spacing-16 (gap), grid/suggestions
+ */
+export declare const SuggestionCards: default_2.ForwardRefExoticComponent<SuggestionCardsProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface SuggestionCardsProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Array of suggestion prompts */
+    suggestions: Suggestion[];
+    /** Called when a suggestion card is clicked */
+    onSelect: (suggestion: Suggestion) => void;
+}
+
+/**
+ * PCOI Toast — Non-blocking notification
+ * Tokens: surface/elevated, border/success|error|warning|info,
+ *         text/primary, text/success|error|warning|info,
+ *         shadow/elevated, zIndex/toast, radius-md
+ */
+export declare const Toast: default_2.FC<ToastProps>;
+
+export declare interface ToastProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Toast message */
+    message: string;
+    /** Visual variant determining color */
+    variant?: ToastVariant;
+    /** Whether the toast is visible */
+    open: boolean;
+    /** Called when the toast should dismiss */
+    onClose?: () => void;
+    /** Auto-dismiss duration in ms (default 5000, 0 = no auto-dismiss) */
+    duration?: number;
+}
+
+export declare type ToastVariant = "success" | "error" | "warning" | "info";
+
+/**
+ * PCOI Toggle — Switch-style boolean control
+ * Tokens: action/toggle-bg, action/toggle-bg-on, action/toggle-thumb,
+ *         focus/border, focus/glow, text/primary, text/error, radius-full
+ */
+export declare const Toggle: default_2.ForwardRefExoticComponent<ToggleProps & default_2.RefAttributes<HTMLInputElement>>;
+
+export declare interface ToggleProps extends Omit<default_2.InputHTMLAttributes<HTMLInputElement>, "type" | "size"> {
+    /** Visible label text */
+    label: string;
+    /** Unique field name, also used to generate id */
+    name: string;
+    /** Error message — when truthy, field enters error state */
+    error?: string;
+}
+
+/**
+ * Standard data-track-* attributes for analytics integration.
+ * Supported on all components via HTML attribute pass-through.
+ * Exported for documentation and IDE discoverability.
+ *
+ * @example
+ * <Button data-track-id="hero-cta" data-track-action="click" data-track-category="engagement">
+ *   Get Started
+ * </Button>
+ */
+export declare interface TrackingProps {
+    /** Unique identifier for the tracked element */
+    "data-track-id"?: string;
+    /** Action type (e.g. "click", "submit", "view", "toggle") */
+    "data-track-action"?: string;
+    /** Category grouping (e.g. "navigation", "form", "engagement") */
+    "data-track-category"?: string;
+    /** Human-readable label for analytics dashboards */
+    "data-track-label"?: string;
+}
+
+/**
+ * PCOI TypingIndicator — Three bouncing dots indicating the assistant is composing a response
+ * Tokens: bg/card, border/card, radius-md, text/accent
+ */
+export declare const TypingIndicator: default_2.ForwardRefExoticComponent<TypingIndicatorProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface TypingIndicatorProps extends default_2.HTMLAttributes<HTMLDivElement> {
+    /** Label shown in the badge (default: "PCOI") */
+    label?: string;
+}
+
+export { }