@titan-design/react-ui 0.5.0 → 0.6.0

package/dist/index.d.mts

@@ -2,12 +2,48 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
 import { ViewProps, PressableProps, View, TextInputProps, TextInput, ImageSourcePropType, ModalProps as ModalProps$1, TextProps } from 'react-native';
 import { ElevationLevel, GlowIntensity } from './theme/index.mjs';
-export { ComponentType, CssPropertyEntry, CssPropertyManifest, ElevationConfig, ManifestValidationResult, ShadowIntensity, ShadowSurface, ThemeConfig, ThemeMode, ThemePreset, ThemePresetColors, ThemePresetFonts, ThemePresetRadii, ThemePresetShadows, ThemeProviderMode, ThemeProviderProps, VariantAxes, VariantOverride, applyThemePreset, audiobookPreset, buttonSizes, componentElevationRanges, createFlatShadow, createPressedHoverShadow, createPressedShadow, createRaisedHoverShadow, createRaisedShadow, darkThemeCSSVars, darken, defaultPreset, discreteRainbow, elevationSystem, getBaseSurfaceColor, getDiscreteRainbowColor, getElevationConfig, getElevationShadow, getElevationSurface, getGlowShadow, getHoverColors, getSemanticColors, getThemeCSSVars, getValidatedElevation, gluestackConfig, hexToRgb, hsvToRgb, isCssPropertyManifest, isDark, lightThemeCSSVars, lighten, neumorphicShadows, primitiveBorderRadius, primitiveBreakpoints, primitiveColors, primitiveShadows, primitiveSpacing, primitiveTypography, primitiveZIndex, resolveColor, rgbToHex, rgbToHsv, semanticColorsDark, semanticColorsLight, semanticTypography, shadowColors, validateCssPropertyManifest } from './theme/index.mjs';
+export { CATEGORICAL_CVD_SAFE_MAX, CategoricalVariant, ComponentType, CssPropertyEntry, CssPropertyManifest, ElevationConfig, GradientStyle, ManifestValidationResult, ShadowIntensity, ShadowSurface, ThemeConfig, ThemeMode, ThemePreset, ThemePresetColors, ThemePresetFonts, ThemePresetRadii, ThemePresetShadows, ThemeProviderMode, ThemeProviderProps, VariantAxes, VariantOverride, applyThemePreset, audiobookPreset, bestTextColor, buttonSizes, categoricalPalette, componentElevationRanges, createFlatShadow, createPressedHoverShadow, createPressedShadow, createRaisedHoverShadow, createRaisedShadow, darkThemeCSSVars, darken, defaultPreset, discreteRainbow, divergingScale, elevationSystem, getBaseSurfaceColor, getCategoricalColor, getDiscreteRainbowColor, getElevationConfig, getElevationShadow, getElevationSurface, getGlowShadow, getHoverColors, getSemanticColors, getThemeCSSVars, getValidatedElevation, gluestackConfig, hexToRgb, hsvToRgb, isCssPropertyManifest, isDark, lightThemeCSSVars, lighten, linearGradient, neumorphicShadows, primitiveBorderRadius, primitiveBreakpoints, primitiveColors, primitiveRamps, primitiveShadows, primitiveSpacing, primitiveTypography, primitiveZIndex, resolveColor, rgbToHex, rgbToHsv, semanticColorsDark, semanticColorsLight, semanticTypography, sequentialEffort, shadowColors, surfaceGradient, validateCssPropertyManifest } from './theme/index.mjs';
 export { A as ActiveExerciseStatus, a as ActiveWorkoutExercise, b as ActiveWorkoutInput, c as ActiveWorkoutPageProps, d as ActiveWorkoutRest, e as ActiveWorkoutSuperset, C as CapacityBandChart, f as CapacityBandChartProps, g as CapacityBandDataPoint, h as CapacityBandProjection, E as ExerciseCard, i as ExerciseCardProps, j as ExerciseCardState, k as ExerciseDetailEntry, l as ExerciseDetailHeader, m as ExerciseDetailPageProps, n as ExerciseDetailStats, o as ExerciseDetailTab, p as ExerciseTrend, q as ExerciseVbt, r as ExerciseVbtSet, M as Meso, s as MesoCard, t as MesoCardProps, u as MesoProgressBar, v as MesoProgressBarProps, w as MesoStatus, x as MesoVolumeHeatmapEntry, P as PRType, y as PlanMeso, z as PlanWeek, B as PlanWorkout, D as PrBadge, F as PrBadgeProps, G as ProgramBreadcrumb, H as ProgramNavLevel, I as ProgramPlanningPageProps, J as ProgramSelection, S as SetRow, K as SetRowMode, L as SetRowProps, N as StrengthTrendChart, O as StrengthTrendChartMesoBoundary, Q as StrengthTrendChartProps, R as StrengthTrendDataPoint, V as VbtSummary, T as VelocityStrip, U as VelocityStripProps, W as VelocityZoneBandProp, X as WeekRow, Y as WeekRowProps, Z as WeekRowWorkout, _ as WorkoutCard, $ as WorkoutCardProps, a0 as WorkoutDot, a1 as WorkoutDotStatus, a2 as WorkoutGroup, a3 as WorkoutMuscleGroup, a4 as WorkoutMuscleVolumeStatus, a5 as WorkoutPill, a6 as WorkoutPillProps, a7 as WorkoutPillStatus, a8 as WorkoutProgress, a9 as WorkoutStatus, aa as calculateMeanVelocity, ab as calculateVelocityLoss, ac as getVelocityZoneColor, ad as getVelocityZoneName } from './pages-MO0JCySL.mjs';
 export { M as MesoStatusBadge, a as MesoStatusBadgeVariant, b as MesoStatusCard, c as MesoStatusCardProps, d as MesoStatusCoaching, e as MesoStatusGauge, f as MesoStatusMetric, g as MesoStatusNextTarget } from './MesoStatusCard-CQk71hSi.mjs';
 export { BodyMapData, BodyMapDetailPanelProps, BodyMapProps, ContributingExercise, MovementCategory, MuscleGroup, SimpleMuscleGroup, TrainingStatusMuscle, TrainingStatusPageProps, TrainingStatusSummary, UpcomingExercise, VolumeLandmarks } from './bodymap.mjs';
 import { ClassValue } from 'clsx';
 
+interface IconProps {
+    /** Rendered width/height in px (viewBox is fixed 24×24). */
+    size?: number;
+    /** Stroke color (or fill, for solid icons). Defaults to `currentColor` so a wrapper's text token drives it. */
+    color?: string;
+    /** Stroke width for outline icons. */
+    strokeWidth?: number;
+    /** Fill color; defaults to `none` (outline). */
+    fill?: string;
+    /** Accessible title — sets `role="img"` + `<title>`. Omit for a decorative icon (hidden from AT). */
+    title?: string;
+}
+interface SvgIconProps extends IconProps {
+    children: ReactNode;
+}
+/**
+ * Base SVG wrapper for the titan icon set — a 24×24 web-`<svg>` with the shared
+ * accessibility contract (titled → `role="img"` + `<title>`; untitled →
+ * `aria-hidden`) and `currentColor` inheritance. Icons pass their paths as
+ * children plus their stroke/fill defaults.
+ */
+declare function SvgIcon({ size, color, strokeWidth, fill, title, children, }: SvgIconProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Voltras brand mark — the ◇ diamond (outline). Pass `fill` for a solid mark.
+ */
+declare function VoltrasMark({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+/**
+ * Bluetooth glyph (stroked) — e.g. device-connection state (color via `currentColor`).
+ */
+declare function BluetoothIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+/** Dumbbell glyph (mirrors lucide-react `Dumbbell`). Outline-only by default. */
+declare function DumbbellIcon(props: IconProps): react_jsx_runtime.JSX.Element;
+/** Star glyph (mirrors lucide-react `Star`). Pass `fill` for a solid star. */
+declare function StarIcon(props: IconProps): react_jsx_runtime.JSX.Element;
+
 type AlertStatus = 'success' | 'info' | 'warning' | 'error';
 type AlertVariant = 'subtle' | 'outline' | 'solid';
 interface AlertProps extends ViewProps {
@@ -315,7 +351,9 @@ interface CardSkeletonProps {
 declare function CardSkeleton({ hasHeader, hasFooter, contentLines, className, }: CardSkeletonProps): react_jsx_runtime.JSX.Element;
 
 type IndicatorSize = 'xs' | 'sm' | 'md' | 'lg';
-type IndicatorColor = 'default' | 'primary' | 'success' | 'error' | 'warning' | 'info';
+type IndicatorColor = 'default' | 'primary' | 'success' | 'error' | 'warning' | 'info' | 'error-vivid';
+/** How a pulsing indicator animates: a subtle opacity fade, or an expanding ring. */
+type IndicatorPulse = 'opacity' | 'ping';
 interface IndicatorProps extends ViewProps {
     /** Dot size */
     size?: IndicatorSize;
@@ -327,10 +365,12 @@ interface IndicatorProps extends ViewProps {
     glow?: boolean;
     /** Add a ring border */
     ring?: boolean;
+    /** Animate for live/active status. `true` = opacity fade; `'ping'` = expanding ring. */
+    pulse?: boolean | IndicatorPulse;
     /** Additional className */
     className?: string;
 }
-declare function Indicator({ size, color, customColor, glow, ring, className, style, ...props }: IndicatorProps): react_jsx_runtime.JSX.Element;
+declare function Indicator({ size, color, customColor, glow, ring, pulse, className, style, ...props }: IndicatorProps): react_jsx_runtime.JSX.Element;
 
 type BadgeVariant = 'solid' | 'subtle' | 'outline';
 type BadgeColor = 'default' | 'primary' | 'secondary' | 'success' | 'error' | 'warning' | 'info';
@@ -1986,7 +2026,7 @@ interface PillProps extends ViewProps {
 }
 declare function Pill({ children, variant, color, size, rounded, leftElement, onPress, className, ...props }: PillProps): react_jsx_runtime.JSX.Element;
 
-type TypographyVariant = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'body1' | 'body2' | 'subtitle1' | 'subtitle2' | 'caption' | 'overline' | 'button';
+type TypographyVariant = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'body1' | 'body2' | 'subtitle1' | 'subtitle2' | 'caption' | 'overline' | 'button' | 'mono' | 'monoLabel';
 type TypographyColor = 'primary' | 'secondary' | 'tertiary' | 'disabled' | 'inverse' | 'success' | 'error' | 'warning' | 'info' | 'inherit';
 type TypographyAlign = 'left' | 'center' | 'right' | 'justify';
 type TypographyMarginBottom = 'none' | 'sm' | 'md' | 'lg';
@@ -2447,14 +2487,24 @@ declare function StepContent({ status, className, children }: StepContentProps):
 
 type DateTimeFormat = 'date' | 'time' | 'datetime' | 'relative' | 'short' | 'medium' | 'long' | 'full';
 interface DateTimeProps extends TextProps {
-    /** Date value (timestamp in ms, Date object, or ISO string) */
-    value: number | Date | string | null | undefined;
+    /** Date value (timestamp in ms, Date object, or ISO string). Optional when `live`. */
+    value?: number | Date | string | null | undefined;
     /** Display format */
     format?: DateTimeFormat;
     /** Custom format string (overrides format) */
     customFormat?: string;
     /** Whether to show in UTC */
     isUTC?: boolean;
+    /** Force 12h (true) or 24h (false) for time/datetime formats; locale default when omitted. */
+    hour12?: boolean;
+    /** Include seconds in time/datetime formats. */
+    seconds?: boolean;
+    /** Render through Typography with this variant (e.g. 'mono'); plain inheriting Text when omitted. */
+    variant?: TypographyVariant;
+    /** Track the current time and re-render on an interval (ignores `value`). For clocks / relative time. */
+    live?: boolean;
+    /** Refresh interval in ms when `live` (default 1000). */
+    refreshMs?: number;
     /** Fallback text when value is null/undefined */
     fallback?: string;
     /** Text color */
@@ -2478,7 +2528,7 @@ interface DateTimeProps extends TextProps {
  * // UTC time
  * <DateTime value={timestamp} format="datetime" isUTC />
  */
-declare function DateTime({ value, format, customFormat, isUTC, fallback, color, className, ...props }: DateTimeProps): react_jsx_runtime.JSX.Element;
+declare function DateTime({ value, format, customFormat, isUTC, hour12, seconds, variant, live, refreshMs, fallback, color, className, ...props }: DateTimeProps): react_jsx_runtime.JSX.Element;
 /**
  * Utility function to format dates outside of React components.
  */
@@ -2935,6 +2985,112 @@ interface GaugeProps extends Omit<ViewProps, 'children'> {
  */
 declare function Gauge({ value, min, max, size, label, unit, thresholds, color, className, ...props }: GaugeProps): react_jsx_runtime.JSX.Element;
 
+interface BrandLockupProps extends ViewProps {
+    /** The "/ subtitle" that follows the wordmark. Default "wall dashboard". */
+    subtitle?: string;
+    /** Show the subtitle. Hidden at tablet width and below (S1-Q4 responsive). */
+    showSubtitle?: boolean;
+    className?: string;
+}
+/**
+ * Product identity lockup for the top bar: ◇ mark + VOLTRAS wordmark + optional
+ * subtitle. Composes the VoltrasMark icon + Typography. S1 · BrandLockup.
+ */
+declare function BrandLockup({ subtitle, showSubtitle, className, ...props }: BrandLockupProps): react_jsx_runtime.JSX.Element;
+
+type SessionState = 'live' | 'rest' | 'idle';
+interface SessionStatePillProps extends ViewProps {
+    /** Session state → dot color + pulse + label. */
+    state: SessionState;
+    /** Override the default label (LIVE / REST / IDLE). */
+    label?: string;
+    className?: string;
+}
+/**
+ * The global session-state readout (dot + label). Shared: the top bar's status
+ * and the Live-view header both use it (this is the ledger's "StatusPill",
+ * Family C — built once). S1 · SessionStatePill.
+ */
+declare function SessionStatePill({ state, label, className, ...props }: SessionStatePillProps): react_jsx_runtime.JSX.Element;
+
+type DeviceConnState = 'connected' | 'degraded' | 'lost';
+interface DeviceIndicatorProps extends ViewProps {
+    /** Aggregate connection state (worst-of the bound devices) → glyph color. */
+    status?: DeviceConnState;
+    /** Tap handler. When omitted the glyph is non-interactive (e.g. inside a PopoverTrigger). */
+    onPress?: () => void;
+    /** Accessible label (names the glyph / the wrapping trigger button). */
+    label?: string;
+    className?: string;
+}
+/**
+ * The device/BLE connection glyph — a color-coded bluetooth mark, no label.
+ * Opens the DeviceMenu when tapped. S1 · DeviceIndicator.
+ */
+declare function DeviceIndicator({ status, onPress, label, className, ...props }: DeviceIndicatorProps): react_jsx_runtime.JSX.Element;
+
+type DeviceRowState = 'connected' | 'available' | 'degraded' | 'lost';
+interface Device {
+    /** Stable device id (e.g. "Voltra-A3F2"). */
+    id: string;
+    /** User-assigned slot/device name (e.g. "Left Cable"). */
+    nickname: string;
+    /** Bound slot, or null when unbound/available (used for the menu's bound/available tally). */
+    slot?: 'L' | 'R' | null;
+    /** Connection/availability state → the status dot color. */
+    state: DeviceRowState;
+}
+interface DeviceRowProps extends ViewProps {
+    device: Device;
+    onPress?: () => void;
+    className?: string;
+}
+/**
+ * One device in the DeviceMenu: status dot · name · Bluetooth id. The dot color
+ * carries the connection state (no redundant status text); the name is the one
+ * slot label (no duplicate slot badge). S1 · DeviceRow.
+ */
+declare function DeviceRow({ device, onPress, className, ...props }: DeviceRowProps): react_jsx_runtime.JSX.Element;
+
+interface DeviceMenuProps {
+    devices: Device[];
+    /** Controlled open state (optional — uncontrolled otherwise). */
+    isOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    onSelectDevice?: (device: Device) => void;
+    className?: string;
+}
+/**
+ * The device glyph + its dropdown of individual devices (availability, slot
+ * binding, id, connection state). Composes Popover + DeviceIndicator +
+ * DeviceRow. S1 · DeviceMenu.
+ */
+declare function DeviceMenu({ devices, isOpen, onOpenChange, onSelectDevice, className, }: DeviceMenuProps): react_jsx_runtime.JSX.Element;
+
+interface TopBarProps {
+    /** Global session state → the status pill. */
+    state: SessionState;
+    /** Devices for the connection glyph + dropdown. */
+    devices: Device[];
+    /** The moment to display in the clock (Date/timestamp). Omit for a live ticking clock. */
+    time?: number | Date;
+    /** Brand subtitle. Default "wall dashboard". */
+    subtitle?: string;
+    /** Force the subtitle on/off; defaults to container-responsive (hidden below ~1024px). */
+    showSubtitle?: boolean;
+    /** Force the clock on/off; defaults to container-responsive (hidden below ~720px). */
+    showClock?: boolean;
+    onSelectDevice?: (device: Device) => void;
+    className?: string;
+}
+/**
+ * S1 · TopBar — the persistent shell chrome band. Brand (left) + a right cluster
+ * of session state · device glyph · clock (clock edge-pinned so spacing stays
+ * stable as the state text changes). Collapses subtitle then clock as its
+ * container narrows.
+ */
+declare function TopBar({ state, devices, time, subtitle, showSubtitle, showClock, onSelectDevice, className, }: TopBarProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Utility function to merge Tailwind CSS classes with proper conflict resolution.
  * Combines clsx for conditional classes with tailwind-merge for deduplication.
@@ -3143,4 +3299,4 @@ interface PrescriptionInput {
  */
 declare function formatPrescription(p: PrescriptionInput | null | undefined): string | null;
 
-export { Accordion, AccordionButton, type AccordionButtonProps, AccordionItem, type AccordionItemProps, AccordionPanel, type AccordionPanelProps, type AccordionProps, Alert, AlertDescription, type AlertDescriptionProps, type AlertProps, type AlertStatus, AlertTitle, type AlertTitleProps, type AlertVariant, Autocomplete, type AutocompleteOption, type AutocompleteProps, Avatar, AvatarBadge, type AvatarBadgeProps, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarSize, Badge, type BadgeColor, type BadgeProps, type BadgeSize, BadgeText, type BadgeTextProps, type BadgeVariant, BaseBadge, type BaseBadgeProps, type BaseBadgeSize, type BaseBadgeVariant, BreadcrumbItem, type BreadcrumbItemProps, Breadcrumbs, type BreadcrumbsProps, Button, type ButtonColor, ButtonIcon, type ButtonIconProps, type ButtonProps, type ButtonSize, ButtonSpinner, type ButtonSpinnerProps, ButtonText, type ButtonTextProps, type ButtonVariant, Caption, type CaptionProps, Card, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, type CardElevation, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardSkeleton, type CardSkeletonProps, CardTitle, type CardTitleProps, type CardVariant, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, Chip, type ChipColor, type ChipProps, type ChipSize, type ChipVariant, CircularProgress, type CircularProgressProps, Collapse, CollapseButton, type CollapseButtonProps, CollapseContent, type CollapseContentProps, type CollapseProps, DataRow, type DataRowProps, DateTime, type DateTimeFormat, type DateTimeProps, DeviationBar, type DeviationBarProps, Divider, type DividerOrientation, type DividerProps, Drawer, DrawerBody, type DrawerBodyProps, DrawerFooter, type DrawerFooterProps, DrawerHeader, type DrawerHeaderProps, type DrawerPlacement, type DrawerProps, type DrawerSize, ElevationLevel, EmptyState, type EmptyStateProps, type FieldState, type FieldWrapperProps, FormActions, type FormActionsProps, type FormErrors, FormField, type FormFieldProps, FormRow, type FormRowProps, FormSection, type FormSectionProps, type FormTouched, type FormValues, Gauge, type GaugeProps, type GaugeThreshold, GlowIntensity, HStack, Heading, type HeadingProps, HelpTip, type HelpTipIcon, type HelpTipPlacement, type HelpTipProps, type HelpTipSize, IconBox, type IconBoxProps, Indicator, type IndicatorColor, type IndicatorProps, type IndicatorSize, Input, InputBar, type InputBarProps, InputGroup, type InputGroupProps, type InputProps, type InputSize, type InputVariant, IntensityBar, type IntensityBarProps, Label, type LabelProps, LabelWithHelp, type LabelWithHelpProps, Link, type LinkColor, type LinkProps, type LinkUnderline, ListItem, ListItemContent, type ListItemContentProps, ListItemDivider, type ListItemDividerProps, ListItemIcon, type ListItemIconProps, type ListItemProps, ListItemTrailing, type ListItemTrailingProps, Menu, MenuDivider, type MenuDividerProps, MenuGroup, type MenuGroupProps, MenuItem, type MenuItemProps, MenuList, type MenuListProps, type MenuProps, MenuTrigger, type MenuTriggerProps, Metric, MetricGroup, type MetricGroupProps, type MetricProps, type MetricTrend, Modal, ModalBody, type ModalBodyProps, ModalCloseButton, type ModalCloseButtonProps, ModalContent, type ModalContentProps, ModalFooter, type ModalFooterProps, ModalHeader, type ModalHeaderProps, type ModalProps, type ModalSize, ModalTitle, type ModalTitleProps, MuscleGroupChip, type MuscleGroupChipProps, Overline, type OverlineProps, Paragraph, type ParagraphProps, PasswordInput, type PasswordInputProps, Pill, type PillColor, type PillProps, type PillSize, type PillVariant, PlaceholderStrip, type PlaceholderStripProps, Popover, PopoverCloseButton, type PopoverCloseButtonProps, PopoverContent, type PopoverContentProps, type PopoverPlacement, type PopoverProps, PopoverTrigger, type PopoverTriggerProps, PrHistoryModal, type PrHistoryModalProps, type PrRecord, type PrRecordType, type PrescriptionInput, Progress, type ProgressColor, type ProgressProps, type ProgressSize, ProgressSteps, type ProgressStepsProps, type ProgressVariant, Radio, type RadioColor, RadioGroup, type RadioGroupProps, type RadioProps, type RadioSize, ReadinessCheck, type ReadinessCheckProps, type ReadinessFactor, RestTimer, type RestTimerProps, type ResultType, Scatter, type ScatterAxis, type ScatterDatum, type ScatterProps, Section, SectionContent, type SectionContentProps, SectionHeader, type SectionHeaderProps, type SectionProps, Select, type SelectOption, type SelectProps, Sidebar, SidebarContent, type SidebarContentProps, SidebarDivider, type SidebarDividerProps, SidebarFooter, type SidebarFooterProps, SidebarHeader, type SidebarHeaderProps, SidebarItem, type SidebarItemProps, type SidebarProps, SidebarSection, type SidebarSectionProps, Skeleton, type SkeletonAnimation, SkeletonCard, type SkeletonCardProps, SkeletonCircle, type SkeletonCircleProps, SkeletonListItem, type SkeletonListItemProps, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SkeletonVariant, type SortDirection, Sparkline, type SparklineProps, Spinner, type SpinnerColor, type SpinnerProps, type SpinnerSize, Stack, type StackProps, StatusDot, type StatusDotProps, type StatusDotVariant, type StatusType, StepContent, type StepContentProps, StepIndicator, type StepIndicatorProps, StepLabel, type StepLabelProps, type StepStatus, Stepper, type StepperOrientation, type StepperProps, Step as StepperStep, type StepProps as StepperStepProps, SupersetWrapper, type SupersetWrapperProps, Surface, type SurfaceProps, Switch, type SwitchProps, type SwitchSize, TEMPO_PACING, Tab, TabList, type TabListProps, TabPanel, type TabPanelProps, TabPanels, type TabPanelsProps, type TabProps, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHeader, TableHeaderCell, type TableHeaderCellProps, type TableHeaderProps, TablePagination, type TablePaginationProps, type TableProps, TableRow, type TableRowProps, Tabs, type TabsOrientation, type TabsProps, type TabsVariant, TempoBar, type TempoBarProps, TempoDisplay, type TempoDisplayProps, type TempoLivePhase, type TempoLiveState, type TempoPacingState, type TempoPhaseKey, Toast, type ToastConfig, type ToastPosition, type ToastProps, ToastProvider, type ToastProviderProps, type ToastStatus, ToolbarButton, ToolbarButtonGroup, type ToolbarButtonGroupProps, type ToolbarButtonProps, type ToolbarButtonSize, type ToolbarButtonVariant, Tooltip, type TooltipPlacement, type TooltipProps, Treemap, type TreemapDatum, type TreemapProps, type TreemapScale, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, type UseTableOptions, type UseTableReturn, VStack, type VolumeStatus, type WarmUpStatus, type WarmUpValidation, WeightBadge, type WeightBadgeProps, type WeightBadgeSize, alpha, cn, composeValidators, createFieldId, formatDateTime, formatPrescription, formatSignedPct, formatVelocity, getContrastText, getFieldAriaProps, getFieldValidationProps, getLuminance, getResultColor, getStatusColor, getTempoFillPct, getTempoPacingState, hasMaxLength, hasMinLength, isEmpty, isValidEmail, roundRpe, roundTempo, roundWeight, rpeColor, useTable, useToast, useToolbarButton, validationRules };
+export { Accordion, AccordionButton, type AccordionButtonProps, AccordionItem, type AccordionItemProps, AccordionPanel, type AccordionPanelProps, type AccordionProps, Alert, AlertDescription, type AlertDescriptionProps, type AlertProps, type AlertStatus, AlertTitle, type AlertTitleProps, type AlertVariant, Autocomplete, type AutocompleteOption, type AutocompleteProps, Avatar, AvatarBadge, type AvatarBadgeProps, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarSize, Badge, type BadgeColor, type BadgeProps, type BadgeSize, BadgeText, type BadgeTextProps, type BadgeVariant, BaseBadge, type BaseBadgeProps, type BaseBadgeSize, type BaseBadgeVariant, BluetoothIcon, BrandLockup, type BrandLockupProps, BreadcrumbItem, type BreadcrumbItemProps, Breadcrumbs, type BreadcrumbsProps, Button, type ButtonColor, ButtonIcon, type ButtonIconProps, type ButtonProps, type ButtonSize, ButtonSpinner, type ButtonSpinnerProps, ButtonText, type ButtonTextProps, type ButtonVariant, Caption, type CaptionProps, Card, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, type CardElevation, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardSkeleton, type CardSkeletonProps, CardTitle, type CardTitleProps, type CardVariant, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, Chip, type ChipColor, type ChipProps, type ChipSize, type ChipVariant, CircularProgress, type CircularProgressProps, Collapse, CollapseButton, type CollapseButtonProps, CollapseContent, type CollapseContentProps, type CollapseProps, DataRow, type DataRowProps, DateTime, type DateTimeFormat, type DateTimeProps, DeviationBar, type DeviationBarProps, type Device, type DeviceConnState, DeviceIndicator, type DeviceIndicatorProps, DeviceMenu, type DeviceMenuProps, DeviceRow, type DeviceRowProps, type DeviceRowState, Divider, type DividerOrientation, type DividerProps, Drawer, DrawerBody, type DrawerBodyProps, DrawerFooter, type DrawerFooterProps, DrawerHeader, type DrawerHeaderProps, type DrawerPlacement, type DrawerProps, type DrawerSize, DumbbellIcon, ElevationLevel, EmptyState, type EmptyStateProps, type FieldState, type FieldWrapperProps, FormActions, type FormActionsProps, type FormErrors, FormField, type FormFieldProps, FormRow, type FormRowProps, FormSection, type FormSectionProps, type FormTouched, type FormValues, Gauge, type GaugeProps, type GaugeThreshold, GlowIntensity, HStack, Heading, type HeadingProps, HelpTip, type HelpTipIcon, type HelpTipPlacement, type HelpTipProps, type HelpTipSize, IconBox, type IconBoxProps, type IconProps, Indicator, type IndicatorColor, type IndicatorProps, type IndicatorPulse, type IndicatorSize, Input, InputBar, type InputBarProps, InputGroup, type InputGroupProps, type InputProps, type InputSize, type InputVariant, IntensityBar, type IntensityBarProps, Label, type LabelProps, LabelWithHelp, type LabelWithHelpProps, Link, type LinkColor, type LinkProps, type LinkUnderline, ListItem, ListItemContent, type ListItemContentProps, ListItemDivider, type ListItemDividerProps, ListItemIcon, type ListItemIconProps, type ListItemProps, ListItemTrailing, type ListItemTrailingProps, Menu, MenuDivider, type MenuDividerProps, MenuGroup, type MenuGroupProps, MenuItem, type MenuItemProps, MenuList, type MenuListProps, type MenuProps, MenuTrigger, type MenuTriggerProps, Metric, MetricGroup, type MetricGroupProps, type MetricProps, type MetricTrend, Modal, ModalBody, type ModalBodyProps, ModalCloseButton, type ModalCloseButtonProps, ModalContent, type ModalContentProps, ModalFooter, type ModalFooterProps, ModalHeader, type ModalHeaderProps, type ModalProps, type ModalSize, ModalTitle, type ModalTitleProps, MuscleGroupChip, type MuscleGroupChipProps, Overline, type OverlineProps, Paragraph, type ParagraphProps, PasswordInput, type PasswordInputProps, Pill, type PillColor, type PillProps, type PillSize, type PillVariant, PlaceholderStrip, type PlaceholderStripProps, Popover, PopoverCloseButton, type PopoverCloseButtonProps, PopoverContent, type PopoverContentProps, type PopoverPlacement, type PopoverProps, PopoverTrigger, type PopoverTriggerProps, PrHistoryModal, type PrHistoryModalProps, type PrRecord, type PrRecordType, type PrescriptionInput, Progress, type ProgressColor, type ProgressProps, type ProgressSize, ProgressSteps, type ProgressStepsProps, type ProgressVariant, Radio, type RadioColor, RadioGroup, type RadioGroupProps, type RadioProps, type RadioSize, ReadinessCheck, type ReadinessCheckProps, type ReadinessFactor, RestTimer, type RestTimerProps, type ResultType, Scatter, type ScatterAxis, type ScatterDatum, type ScatterProps, Section, SectionContent, type SectionContentProps, SectionHeader, type SectionHeaderProps, type SectionProps, Select, type SelectOption, type SelectProps, type SessionState, SessionStatePill, type SessionStatePillProps, Sidebar, SidebarContent, type SidebarContentProps, SidebarDivider, type SidebarDividerProps, SidebarFooter, type SidebarFooterProps, SidebarHeader, type SidebarHeaderProps, SidebarItem, type SidebarItemProps, type SidebarProps, SidebarSection, type SidebarSectionProps, Skeleton, type SkeletonAnimation, SkeletonCard, type SkeletonCardProps, SkeletonCircle, type SkeletonCircleProps, SkeletonListItem, type SkeletonListItemProps, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SkeletonVariant, type SortDirection, Sparkline, type SparklineProps, Spinner, type SpinnerColor, type SpinnerProps, type SpinnerSize, Stack, type StackProps, StarIcon, StatusDot, type StatusDotProps, type StatusDotVariant, type StatusType, StepContent, type StepContentProps, StepIndicator, type StepIndicatorProps, StepLabel, type StepLabelProps, type StepStatus, Stepper, type StepperOrientation, type StepperProps, Step as StepperStep, type StepProps as StepperStepProps, SupersetWrapper, type SupersetWrapperProps, Surface, type SurfaceProps, SvgIcon, type SvgIconProps, Switch, type SwitchProps, type SwitchSize, TEMPO_PACING, Tab, TabList, type TabListProps, TabPanel, type TabPanelProps, TabPanels, type TabPanelsProps, type TabProps, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHeader, TableHeaderCell, type TableHeaderCellProps, type TableHeaderProps, TablePagination, type TablePaginationProps, type TableProps, TableRow, type TableRowProps, Tabs, type TabsOrientation, type TabsProps, type TabsVariant, TempoBar, type TempoBarProps, TempoDisplay, type TempoDisplayProps, type TempoLivePhase, type TempoLiveState, type TempoPacingState, type TempoPhaseKey, Toast, type ToastConfig, type ToastPosition, type ToastProps, ToastProvider, type ToastProviderProps, type ToastStatus, ToolbarButton, ToolbarButtonGroup, type ToolbarButtonGroupProps, type ToolbarButtonProps, type ToolbarButtonSize, type ToolbarButtonVariant, Tooltip, type TooltipPlacement, type TooltipProps, TopBar, type TopBarProps, Treemap, type TreemapDatum, type TreemapProps, type TreemapScale, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, type UseTableOptions, type UseTableReturn, VStack, VoltrasMark, type VolumeStatus, type WarmUpStatus, type WarmUpValidation, WeightBadge, type WeightBadgeProps, type WeightBadgeSize, alpha, cn, composeValidators, createFieldId, formatDateTime, formatPrescription, formatSignedPct, formatVelocity, getContrastText, getFieldAriaProps, getFieldValidationProps, getLuminance, getResultColor, getStatusColor, getTempoFillPct, getTempoPacingState, hasMaxLength, hasMinLength, isEmpty, isValidEmail, roundRpe, roundTempo, roundWeight, rpeColor, useTable, useToast, useToolbarButton, validationRules };

package/dist/index.d.ts

@@ -2,12 +2,48 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
 import { ViewProps, PressableProps, View, TextInputProps, TextInput, ImageSourcePropType, ModalProps as ModalProps$1, TextProps } from 'react-native';
 import { ElevationLevel, GlowIntensity } from './theme/index.js';
-export { ComponentType, CssPropertyEntry, CssPropertyManifest, ElevationConfig, ManifestValidationResult, ShadowIntensity, ShadowSurface, ThemeConfig, ThemeMode, ThemePreset, ThemePresetColors, ThemePresetFonts, ThemePresetRadii, ThemePresetShadows, ThemeProviderMode, ThemeProviderProps, VariantAxes, VariantOverride, applyThemePreset, audiobookPreset, buttonSizes, componentElevationRanges, createFlatShadow, createPressedHoverShadow, createPressedShadow, createRaisedHoverShadow, createRaisedShadow, darkThemeCSSVars, darken, defaultPreset, discreteRainbow, elevationSystem, getBaseSurfaceColor, getDiscreteRainbowColor, getElevationConfig, getElevationShadow, getElevationSurface, getGlowShadow, getHoverColors, getSemanticColors, getThemeCSSVars, getValidatedElevation, gluestackConfig, hexToRgb, hsvToRgb, isCssPropertyManifest, isDark, lightThemeCSSVars, lighten, neumorphicShadows, primitiveBorderRadius, primitiveBreakpoints, primitiveColors, primitiveShadows, primitiveSpacing, primitiveTypography, primitiveZIndex, resolveColor, rgbToHex, rgbToHsv, semanticColorsDark, semanticColorsLight, semanticTypography, shadowColors, validateCssPropertyManifest } from './theme/index.js';
+export { CATEGORICAL_CVD_SAFE_MAX, CategoricalVariant, ComponentType, CssPropertyEntry, CssPropertyManifest, ElevationConfig, GradientStyle, ManifestValidationResult, ShadowIntensity, ShadowSurface, ThemeConfig, ThemeMode, ThemePreset, ThemePresetColors, ThemePresetFonts, ThemePresetRadii, ThemePresetShadows, ThemeProviderMode, ThemeProviderProps, VariantAxes, VariantOverride, applyThemePreset, audiobookPreset, bestTextColor, buttonSizes, categoricalPalette, componentElevationRanges, createFlatShadow, createPressedHoverShadow, createPressedShadow, createRaisedHoverShadow, createRaisedShadow, darkThemeCSSVars, darken, defaultPreset, discreteRainbow, divergingScale, elevationSystem, getBaseSurfaceColor, getCategoricalColor, getDiscreteRainbowColor, getElevationConfig, getElevationShadow, getElevationSurface, getGlowShadow, getHoverColors, getSemanticColors, getThemeCSSVars, getValidatedElevation, gluestackConfig, hexToRgb, hsvToRgb, isCssPropertyManifest, isDark, lightThemeCSSVars, lighten, linearGradient, neumorphicShadows, primitiveBorderRadius, primitiveBreakpoints, primitiveColors, primitiveRamps, primitiveShadows, primitiveSpacing, primitiveTypography, primitiveZIndex, resolveColor, rgbToHex, rgbToHsv, semanticColorsDark, semanticColorsLight, semanticTypography, sequentialEffort, shadowColors, surfaceGradient, validateCssPropertyManifest } from './theme/index.js';
 export { A as ActiveExerciseStatus, a as ActiveWorkoutExercise, b as ActiveWorkoutInput, c as ActiveWorkoutPageProps, d as ActiveWorkoutRest, e as ActiveWorkoutSuperset, C as CapacityBandChart, f as CapacityBandChartProps, g as CapacityBandDataPoint, h as CapacityBandProjection, E as ExerciseCard, i as ExerciseCardProps, j as ExerciseCardState, k as ExerciseDetailEntry, l as ExerciseDetailHeader, m as ExerciseDetailPageProps, n as ExerciseDetailStats, o as ExerciseDetailTab, p as ExerciseTrend, q as ExerciseVbt, r as ExerciseVbtSet, M as Meso, s as MesoCard, t as MesoCardProps, u as MesoProgressBar, v as MesoProgressBarProps, w as MesoStatus, x as MesoVolumeHeatmapEntry, P as PRType, y as PlanMeso, z as PlanWeek, B as PlanWorkout, D as PrBadge, F as PrBadgeProps, G as ProgramBreadcrumb, H as ProgramNavLevel, I as ProgramPlanningPageProps, J as ProgramSelection, S as SetRow, K as SetRowMode, L as SetRowProps, N as StrengthTrendChart, O as StrengthTrendChartMesoBoundary, Q as StrengthTrendChartProps, R as StrengthTrendDataPoint, V as VbtSummary, T as VelocityStrip, U as VelocityStripProps, W as VelocityZoneBandProp, X as WeekRow, Y as WeekRowProps, Z as WeekRowWorkout, _ as WorkoutCard, $ as WorkoutCardProps, a0 as WorkoutDot, a1 as WorkoutDotStatus, a2 as WorkoutGroup, a3 as WorkoutMuscleGroup, a4 as WorkoutMuscleVolumeStatus, a5 as WorkoutPill, a6 as WorkoutPillProps, a7 as WorkoutPillStatus, a8 as WorkoutProgress, a9 as WorkoutStatus, aa as calculateMeanVelocity, ab as calculateVelocityLoss, ac as getVelocityZoneColor, ad as getVelocityZoneName } from './pages-D7Jlssvp.js';
 export { M as MesoStatusBadge, a as MesoStatusBadgeVariant, b as MesoStatusCard, c as MesoStatusCardProps, d as MesoStatusCoaching, e as MesoStatusGauge, f as MesoStatusMetric, g as MesoStatusNextTarget } from './MesoStatusCard-CQk71hSi.js';
 export { BodyMapData, BodyMapDetailPanelProps, BodyMapProps, ContributingExercise, MovementCategory, MuscleGroup, SimpleMuscleGroup, TrainingStatusMuscle, TrainingStatusPageProps, TrainingStatusSummary, UpcomingExercise, VolumeLandmarks } from './bodymap.js';
 import { ClassValue } from 'clsx';
 
+interface IconProps {
+    /** Rendered width/height in px (viewBox is fixed 24×24). */
+    size?: number;
+    /** Stroke color (or fill, for solid icons). Defaults to `currentColor` so a wrapper's text token drives it. */
+    color?: string;
+    /** Stroke width for outline icons. */
+    strokeWidth?: number;
+    /** Fill color; defaults to `none` (outline). */
+    fill?: string;
+    /** Accessible title — sets `role="img"` + `<title>`. Omit for a decorative icon (hidden from AT). */
+    title?: string;
+}
+interface SvgIconProps extends IconProps {
+    children: ReactNode;
+}
+/**
+ * Base SVG wrapper for the titan icon set — a 24×24 web-`<svg>` with the shared
+ * accessibility contract (titled → `role="img"` + `<title>`; untitled →
+ * `aria-hidden`) and `currentColor` inheritance. Icons pass their paths as
+ * children plus their stroke/fill defaults.
+ */
+declare function SvgIcon({ size, color, strokeWidth, fill, title, children, }: SvgIconProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Voltras brand mark — the ◇ diamond (outline). Pass `fill` for a solid mark.
+ */
+declare function VoltrasMark({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+/**
+ * Bluetooth glyph (stroked) — e.g. device-connection state (color via `currentColor`).
+ */
+declare function BluetoothIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+/** Dumbbell glyph (mirrors lucide-react `Dumbbell`). Outline-only by default. */
+declare function DumbbellIcon(props: IconProps): react_jsx_runtime.JSX.Element;
+/** Star glyph (mirrors lucide-react `Star`). Pass `fill` for a solid star. */
+declare function StarIcon(props: IconProps): react_jsx_runtime.JSX.Element;
+
 type AlertStatus = 'success' | 'info' | 'warning' | 'error';
 type AlertVariant = 'subtle' | 'outline' | 'solid';
 interface AlertProps extends ViewProps {
@@ -315,7 +351,9 @@ interface CardSkeletonProps {
 declare function CardSkeleton({ hasHeader, hasFooter, contentLines, className, }: CardSkeletonProps): react_jsx_runtime.JSX.Element;
 
 type IndicatorSize = 'xs' | 'sm' | 'md' | 'lg';
-type IndicatorColor = 'default' | 'primary' | 'success' | 'error' | 'warning' | 'info';
+type IndicatorColor = 'default' | 'primary' | 'success' | 'error' | 'warning' | 'info' | 'error-vivid';
+/** How a pulsing indicator animates: a subtle opacity fade, or an expanding ring. */
+type IndicatorPulse = 'opacity' | 'ping';
 interface IndicatorProps extends ViewProps {
     /** Dot size */
     size?: IndicatorSize;
@@ -327,10 +365,12 @@ interface IndicatorProps extends ViewProps {
     glow?: boolean;
     /** Add a ring border */
     ring?: boolean;
+    /** Animate for live/active status. `true` = opacity fade; `'ping'` = expanding ring. */
+    pulse?: boolean | IndicatorPulse;
     /** Additional className */
     className?: string;
 }
-declare function Indicator({ size, color, customColor, glow, ring, className, style, ...props }: IndicatorProps): react_jsx_runtime.JSX.Element;
+declare function Indicator({ size, color, customColor, glow, ring, pulse, className, style, ...props }: IndicatorProps): react_jsx_runtime.JSX.Element;
 
 type BadgeVariant = 'solid' | 'subtle' | 'outline';
 type BadgeColor = 'default' | 'primary' | 'secondary' | 'success' | 'error' | 'warning' | 'info';
@@ -1986,7 +2026,7 @@ interface PillProps extends ViewProps {
 }
 declare function Pill({ children, variant, color, size, rounded, leftElement, onPress, className, ...props }: PillProps): react_jsx_runtime.JSX.Element;
 
-type TypographyVariant = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'body1' | 'body2' | 'subtitle1' | 'subtitle2' | 'caption' | 'overline' | 'button';
+type TypographyVariant = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'body1' | 'body2' | 'subtitle1' | 'subtitle2' | 'caption' | 'overline' | 'button' | 'mono' | 'monoLabel';
 type TypographyColor = 'primary' | 'secondary' | 'tertiary' | 'disabled' | 'inverse' | 'success' | 'error' | 'warning' | 'info' | 'inherit';
 type TypographyAlign = 'left' | 'center' | 'right' | 'justify';
 type TypographyMarginBottom = 'none' | 'sm' | 'md' | 'lg';
@@ -2447,14 +2487,24 @@ declare function StepContent({ status, className, children }: StepContentProps):
 
 type DateTimeFormat = 'date' | 'time' | 'datetime' | 'relative' | 'short' | 'medium' | 'long' | 'full';
 interface DateTimeProps extends TextProps {
-    /** Date value (timestamp in ms, Date object, or ISO string) */
-    value: number | Date | string | null | undefined;
+    /** Date value (timestamp in ms, Date object, or ISO string). Optional when `live`. */
+    value?: number | Date | string | null | undefined;
     /** Display format */
     format?: DateTimeFormat;
     /** Custom format string (overrides format) */
     customFormat?: string;
     /** Whether to show in UTC */
     isUTC?: boolean;
+    /** Force 12h (true) or 24h (false) for time/datetime formats; locale default when omitted. */
+    hour12?: boolean;
+    /** Include seconds in time/datetime formats. */
+    seconds?: boolean;
+    /** Render through Typography with this variant (e.g. 'mono'); plain inheriting Text when omitted. */
+    variant?: TypographyVariant;
+    /** Track the current time and re-render on an interval (ignores `value`). For clocks / relative time. */
+    live?: boolean;
+    /** Refresh interval in ms when `live` (default 1000). */
+    refreshMs?: number;
     /** Fallback text when value is null/undefined */
     fallback?: string;
     /** Text color */
@@ -2478,7 +2528,7 @@ interface DateTimeProps extends TextProps {
  * // UTC time
  * <DateTime value={timestamp} format="datetime" isUTC />
  */
-declare function DateTime({ value, format, customFormat, isUTC, fallback, color, className, ...props }: DateTimeProps): react_jsx_runtime.JSX.Element;
+declare function DateTime({ value, format, customFormat, isUTC, hour12, seconds, variant, live, refreshMs, fallback, color, className, ...props }: DateTimeProps): react_jsx_runtime.JSX.Element;
 /**
  * Utility function to format dates outside of React components.
  */
@@ -2935,6 +2985,112 @@ interface GaugeProps extends Omit<ViewProps, 'children'> {
  */
 declare function Gauge({ value, min, max, size, label, unit, thresholds, color, className, ...props }: GaugeProps): react_jsx_runtime.JSX.Element;
 
+interface BrandLockupProps extends ViewProps {
+    /** The "/ subtitle" that follows the wordmark. Default "wall dashboard". */
+    subtitle?: string;
+    /** Show the subtitle. Hidden at tablet width and below (S1-Q4 responsive). */
+    showSubtitle?: boolean;
+    className?: string;
+}
+/**
+ * Product identity lockup for the top bar: ◇ mark + VOLTRAS wordmark + optional
+ * subtitle. Composes the VoltrasMark icon + Typography. S1 · BrandLockup.
+ */
+declare function BrandLockup({ subtitle, showSubtitle, className, ...props }: BrandLockupProps): react_jsx_runtime.JSX.Element;
+
+type SessionState = 'live' | 'rest' | 'idle';
+interface SessionStatePillProps extends ViewProps {
+    /** Session state → dot color + pulse + label. */
+    state: SessionState;
+    /** Override the default label (LIVE / REST / IDLE). */
+    label?: string;
+    className?: string;
+}
+/**
+ * The global session-state readout (dot + label). Shared: the top bar's status
+ * and the Live-view header both use it (this is the ledger's "StatusPill",
+ * Family C — built once). S1 · SessionStatePill.
+ */
+declare function SessionStatePill({ state, label, className, ...props }: SessionStatePillProps): react_jsx_runtime.JSX.Element;
+
+type DeviceConnState = 'connected' | 'degraded' | 'lost';
+interface DeviceIndicatorProps extends ViewProps {
+    /** Aggregate connection state (worst-of the bound devices) → glyph color. */
+    status?: DeviceConnState;
+    /** Tap handler. When omitted the glyph is non-interactive (e.g. inside a PopoverTrigger). */
+    onPress?: () => void;
+    /** Accessible label (names the glyph / the wrapping trigger button). */
+    label?: string;
+    className?: string;
+}
+/**
+ * The device/BLE connection glyph — a color-coded bluetooth mark, no label.
+ * Opens the DeviceMenu when tapped. S1 · DeviceIndicator.
+ */
+declare function DeviceIndicator({ status, onPress, label, className, ...props }: DeviceIndicatorProps): react_jsx_runtime.JSX.Element;
+
+type DeviceRowState = 'connected' | 'available' | 'degraded' | 'lost';
+interface Device {
+    /** Stable device id (e.g. "Voltra-A3F2"). */
+    id: string;
+    /** User-assigned slot/device name (e.g. "Left Cable"). */
+    nickname: string;
+    /** Bound slot, or null when unbound/available (used for the menu's bound/available tally). */
+    slot?: 'L' | 'R' | null;
+    /** Connection/availability state → the status dot color. */
+    state: DeviceRowState;
+}
+interface DeviceRowProps extends ViewProps {
+    device: Device;
+    onPress?: () => void;
+    className?: string;
+}
+/**
+ * One device in the DeviceMenu: status dot · name · Bluetooth id. The dot color
+ * carries the connection state (no redundant status text); the name is the one
+ * slot label (no duplicate slot badge). S1 · DeviceRow.
+ */
+declare function DeviceRow({ device, onPress, className, ...props }: DeviceRowProps): react_jsx_runtime.JSX.Element;
+
+interface DeviceMenuProps {
+    devices: Device[];
+    /** Controlled open state (optional — uncontrolled otherwise). */
+    isOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    onSelectDevice?: (device: Device) => void;
+    className?: string;
+}
+/**
+ * The device glyph + its dropdown of individual devices (availability, slot
+ * binding, id, connection state). Composes Popover + DeviceIndicator +
+ * DeviceRow. S1 · DeviceMenu.
+ */
+declare function DeviceMenu({ devices, isOpen, onOpenChange, onSelectDevice, className, }: DeviceMenuProps): react_jsx_runtime.JSX.Element;
+
+interface TopBarProps {
+    /** Global session state → the status pill. */
+    state: SessionState;
+    /** Devices for the connection glyph + dropdown. */
+    devices: Device[];
+    /** The moment to display in the clock (Date/timestamp). Omit for a live ticking clock. */
+    time?: number | Date;
+    /** Brand subtitle. Default "wall dashboard". */
+    subtitle?: string;
+    /** Force the subtitle on/off; defaults to container-responsive (hidden below ~1024px). */
+    showSubtitle?: boolean;
+    /** Force the clock on/off; defaults to container-responsive (hidden below ~720px). */
+    showClock?: boolean;
+    onSelectDevice?: (device: Device) => void;
+    className?: string;
+}
+/**
+ * S1 · TopBar — the persistent shell chrome band. Brand (left) + a right cluster
+ * of session state · device glyph · clock (clock edge-pinned so spacing stays
+ * stable as the state text changes). Collapses subtitle then clock as its
+ * container narrows.
+ */
+declare function TopBar({ state, devices, time, subtitle, showSubtitle, showClock, onSelectDevice, className, }: TopBarProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Utility function to merge Tailwind CSS classes with proper conflict resolution.
  * Combines clsx for conditional classes with tailwind-merge for deduplication.
@@ -3143,4 +3299,4 @@ interface PrescriptionInput {
  */
 declare function formatPrescription(p: PrescriptionInput | null | undefined): string | null;
 
-export { Accordion, AccordionButton, type AccordionButtonProps, AccordionItem, type AccordionItemProps, AccordionPanel, type AccordionPanelProps, type AccordionProps, Alert, AlertDescription, type AlertDescriptionProps, type AlertProps, type AlertStatus, AlertTitle, type AlertTitleProps, type AlertVariant, Autocomplete, type AutocompleteOption, type AutocompleteProps, Avatar, AvatarBadge, type AvatarBadgeProps, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarSize, Badge, type BadgeColor, type BadgeProps, type BadgeSize, BadgeText, type BadgeTextProps, type BadgeVariant, BaseBadge, type BaseBadgeProps, type BaseBadgeSize, type BaseBadgeVariant, BreadcrumbItem, type BreadcrumbItemProps, Breadcrumbs, type BreadcrumbsProps, Button, type ButtonColor, ButtonIcon, type ButtonIconProps, type ButtonProps, type ButtonSize, ButtonSpinner, type ButtonSpinnerProps, ButtonText, type ButtonTextProps, type ButtonVariant, Caption, type CaptionProps, Card, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, type CardElevation, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardSkeleton, type CardSkeletonProps, CardTitle, type CardTitleProps, type CardVariant, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, Chip, type ChipColor, type ChipProps, type ChipSize, type ChipVariant, CircularProgress, type CircularProgressProps, Collapse, CollapseButton, type CollapseButtonProps, CollapseContent, type CollapseContentProps, type CollapseProps, DataRow, type DataRowProps, DateTime, type DateTimeFormat, type DateTimeProps, DeviationBar, type DeviationBarProps, Divider, type DividerOrientation, type DividerProps, Drawer, DrawerBody, type DrawerBodyProps, DrawerFooter, type DrawerFooterProps, DrawerHeader, type DrawerHeaderProps, type DrawerPlacement, type DrawerProps, type DrawerSize, ElevationLevel, EmptyState, type EmptyStateProps, type FieldState, type FieldWrapperProps, FormActions, type FormActionsProps, type FormErrors, FormField, type FormFieldProps, FormRow, type FormRowProps, FormSection, type FormSectionProps, type FormTouched, type FormValues, Gauge, type GaugeProps, type GaugeThreshold, GlowIntensity, HStack, Heading, type HeadingProps, HelpTip, type HelpTipIcon, type HelpTipPlacement, type HelpTipProps, type HelpTipSize, IconBox, type IconBoxProps, Indicator, type IndicatorColor, type IndicatorProps, type IndicatorSize, Input, InputBar, type InputBarProps, InputGroup, type InputGroupProps, type InputProps, type InputSize, type InputVariant, IntensityBar, type IntensityBarProps, Label, type LabelProps, LabelWithHelp, type LabelWithHelpProps, Link, type LinkColor, type LinkProps, type LinkUnderline, ListItem, ListItemContent, type ListItemContentProps, ListItemDivider, type ListItemDividerProps, ListItemIcon, type ListItemIconProps, type ListItemProps, ListItemTrailing, type ListItemTrailingProps, Menu, MenuDivider, type MenuDividerProps, MenuGroup, type MenuGroupProps, MenuItem, type MenuItemProps, MenuList, type MenuListProps, type MenuProps, MenuTrigger, type MenuTriggerProps, Metric, MetricGroup, type MetricGroupProps, type MetricProps, type MetricTrend, Modal, ModalBody, type ModalBodyProps, ModalCloseButton, type ModalCloseButtonProps, ModalContent, type ModalContentProps, ModalFooter, type ModalFooterProps, ModalHeader, type ModalHeaderProps, type ModalProps, type ModalSize, ModalTitle, type ModalTitleProps, MuscleGroupChip, type MuscleGroupChipProps, Overline, type OverlineProps, Paragraph, type ParagraphProps, PasswordInput, type PasswordInputProps, Pill, type PillColor, type PillProps, type PillSize, type PillVariant, PlaceholderStrip, type PlaceholderStripProps, Popover, PopoverCloseButton, type PopoverCloseButtonProps, PopoverContent, type PopoverContentProps, type PopoverPlacement, type PopoverProps, PopoverTrigger, type PopoverTriggerProps, PrHistoryModal, type PrHistoryModalProps, type PrRecord, type PrRecordType, type PrescriptionInput, Progress, type ProgressColor, type ProgressProps, type ProgressSize, ProgressSteps, type ProgressStepsProps, type ProgressVariant, Radio, type RadioColor, RadioGroup, type RadioGroupProps, type RadioProps, type RadioSize, ReadinessCheck, type ReadinessCheckProps, type ReadinessFactor, RestTimer, type RestTimerProps, type ResultType, Scatter, type ScatterAxis, type ScatterDatum, type ScatterProps, Section, SectionContent, type SectionContentProps, SectionHeader, type SectionHeaderProps, type SectionProps, Select, type SelectOption, type SelectProps, Sidebar, SidebarContent, type SidebarContentProps, SidebarDivider, type SidebarDividerProps, SidebarFooter, type SidebarFooterProps, SidebarHeader, type SidebarHeaderProps, SidebarItem, type SidebarItemProps, type SidebarProps, SidebarSection, type SidebarSectionProps, Skeleton, type SkeletonAnimation, SkeletonCard, type SkeletonCardProps, SkeletonCircle, type SkeletonCircleProps, SkeletonListItem, type SkeletonListItemProps, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SkeletonVariant, type SortDirection, Sparkline, type SparklineProps, Spinner, type SpinnerColor, type SpinnerProps, type SpinnerSize, Stack, type StackProps, StatusDot, type StatusDotProps, type StatusDotVariant, type StatusType, StepContent, type StepContentProps, StepIndicator, type StepIndicatorProps, StepLabel, type StepLabelProps, type StepStatus, Stepper, type StepperOrientation, type StepperProps, Step as StepperStep, type StepProps as StepperStepProps, SupersetWrapper, type SupersetWrapperProps, Surface, type SurfaceProps, Switch, type SwitchProps, type SwitchSize, TEMPO_PACING, Tab, TabList, type TabListProps, TabPanel, type TabPanelProps, TabPanels, type TabPanelsProps, type TabProps, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHeader, TableHeaderCell, type TableHeaderCellProps, type TableHeaderProps, TablePagination, type TablePaginationProps, type TableProps, TableRow, type TableRowProps, Tabs, type TabsOrientation, type TabsProps, type TabsVariant, TempoBar, type TempoBarProps, TempoDisplay, type TempoDisplayProps, type TempoLivePhase, type TempoLiveState, type TempoPacingState, type TempoPhaseKey, Toast, type ToastConfig, type ToastPosition, type ToastProps, ToastProvider, type ToastProviderProps, type ToastStatus, ToolbarButton, ToolbarButtonGroup, type ToolbarButtonGroupProps, type ToolbarButtonProps, type ToolbarButtonSize, type ToolbarButtonVariant, Tooltip, type TooltipPlacement, type TooltipProps, Treemap, type TreemapDatum, type TreemapProps, type TreemapScale, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, type UseTableOptions, type UseTableReturn, VStack, type VolumeStatus, type WarmUpStatus, type WarmUpValidation, WeightBadge, type WeightBadgeProps, type WeightBadgeSize, alpha, cn, composeValidators, createFieldId, formatDateTime, formatPrescription, formatSignedPct, formatVelocity, getContrastText, getFieldAriaProps, getFieldValidationProps, getLuminance, getResultColor, getStatusColor, getTempoFillPct, getTempoPacingState, hasMaxLength, hasMinLength, isEmpty, isValidEmail, roundRpe, roundTempo, roundWeight, rpeColor, useTable, useToast, useToolbarButton, validationRules };
+export { Accordion, AccordionButton, type AccordionButtonProps, AccordionItem, type AccordionItemProps, AccordionPanel, type AccordionPanelProps, type AccordionProps, Alert, AlertDescription, type AlertDescriptionProps, type AlertProps, type AlertStatus, AlertTitle, type AlertTitleProps, type AlertVariant, Autocomplete, type AutocompleteOption, type AutocompleteProps, Avatar, AvatarBadge, type AvatarBadgeProps, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarSize, Badge, type BadgeColor, type BadgeProps, type BadgeSize, BadgeText, type BadgeTextProps, type BadgeVariant, BaseBadge, type BaseBadgeProps, type BaseBadgeSize, type BaseBadgeVariant, BluetoothIcon, BrandLockup, type BrandLockupProps, BreadcrumbItem, type BreadcrumbItemProps, Breadcrumbs, type BreadcrumbsProps, Button, type ButtonColor, ButtonIcon, type ButtonIconProps, type ButtonProps, type ButtonSize, ButtonSpinner, type ButtonSpinnerProps, ButtonText, type ButtonTextProps, type ButtonVariant, Caption, type CaptionProps, Card, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, type CardElevation, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardSkeleton, type CardSkeletonProps, CardTitle, type CardTitleProps, type CardVariant, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, Chip, type ChipColor, type ChipProps, type ChipSize, type ChipVariant, CircularProgress, type CircularProgressProps, Collapse, CollapseButton, type CollapseButtonProps, CollapseContent, type CollapseContentProps, type CollapseProps, DataRow, type DataRowProps, DateTime, type DateTimeFormat, type DateTimeProps, DeviationBar, type DeviationBarProps, type Device, type DeviceConnState, DeviceIndicator, type DeviceIndicatorProps, DeviceMenu, type DeviceMenuProps, DeviceRow, type DeviceRowProps, type DeviceRowState, Divider, type DividerOrientation, type DividerProps, Drawer, DrawerBody, type DrawerBodyProps, DrawerFooter, type DrawerFooterProps, DrawerHeader, type DrawerHeaderProps, type DrawerPlacement, type DrawerProps, type DrawerSize, DumbbellIcon, ElevationLevel, EmptyState, type EmptyStateProps, type FieldState, type FieldWrapperProps, FormActions, type FormActionsProps, type FormErrors, FormField, type FormFieldProps, FormRow, type FormRowProps, FormSection, type FormSectionProps, type FormTouched, type FormValues, Gauge, type GaugeProps, type GaugeThreshold, GlowIntensity, HStack, Heading, type HeadingProps, HelpTip, type HelpTipIcon, type HelpTipPlacement, type HelpTipProps, type HelpTipSize, IconBox, type IconBoxProps, type IconProps, Indicator, type IndicatorColor, type IndicatorProps, type IndicatorPulse, type IndicatorSize, Input, InputBar, type InputBarProps, InputGroup, type InputGroupProps, type InputProps, type InputSize, type InputVariant, IntensityBar, type IntensityBarProps, Label, type LabelProps, LabelWithHelp, type LabelWithHelpProps, Link, type LinkColor, type LinkProps, type LinkUnderline, ListItem, ListItemContent, type ListItemContentProps, ListItemDivider, type ListItemDividerProps, ListItemIcon, type ListItemIconProps, type ListItemProps, ListItemTrailing, type ListItemTrailingProps, Menu, MenuDivider, type MenuDividerProps, MenuGroup, type MenuGroupProps, MenuItem, type MenuItemProps, MenuList, type MenuListProps, type MenuProps, MenuTrigger, type MenuTriggerProps, Metric, MetricGroup, type MetricGroupProps, type MetricProps, type MetricTrend, Modal, ModalBody, type ModalBodyProps, ModalCloseButton, type ModalCloseButtonProps, ModalContent, type ModalContentProps, ModalFooter, type ModalFooterProps, ModalHeader, type ModalHeaderProps, type ModalProps, type ModalSize, ModalTitle, type ModalTitleProps, MuscleGroupChip, type MuscleGroupChipProps, Overline, type OverlineProps, Paragraph, type ParagraphProps, PasswordInput, type PasswordInputProps, Pill, type PillColor, type PillProps, type PillSize, type PillVariant, PlaceholderStrip, type PlaceholderStripProps, Popover, PopoverCloseButton, type PopoverCloseButtonProps, PopoverContent, type PopoverContentProps, type PopoverPlacement, type PopoverProps, PopoverTrigger, type PopoverTriggerProps, PrHistoryModal, type PrHistoryModalProps, type PrRecord, type PrRecordType, type PrescriptionInput, Progress, type ProgressColor, type ProgressProps, type ProgressSize, ProgressSteps, type ProgressStepsProps, type ProgressVariant, Radio, type RadioColor, RadioGroup, type RadioGroupProps, type RadioProps, type RadioSize, ReadinessCheck, type ReadinessCheckProps, type ReadinessFactor, RestTimer, type RestTimerProps, type ResultType, Scatter, type ScatterAxis, type ScatterDatum, type ScatterProps, Section, SectionContent, type SectionContentProps, SectionHeader, type SectionHeaderProps, type SectionProps, Select, type SelectOption, type SelectProps, type SessionState, SessionStatePill, type SessionStatePillProps, Sidebar, SidebarContent, type SidebarContentProps, SidebarDivider, type SidebarDividerProps, SidebarFooter, type SidebarFooterProps, SidebarHeader, type SidebarHeaderProps, SidebarItem, type SidebarItemProps, type SidebarProps, SidebarSection, type SidebarSectionProps, Skeleton, type SkeletonAnimation, SkeletonCard, type SkeletonCardProps, SkeletonCircle, type SkeletonCircleProps, SkeletonListItem, type SkeletonListItemProps, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SkeletonVariant, type SortDirection, Sparkline, type SparklineProps, Spinner, type SpinnerColor, type SpinnerProps, type SpinnerSize, Stack, type StackProps, StarIcon, StatusDot, type StatusDotProps, type StatusDotVariant, type StatusType, StepContent, type StepContentProps, StepIndicator, type StepIndicatorProps, StepLabel, type StepLabelProps, type StepStatus, Stepper, type StepperOrientation, type StepperProps, Step as StepperStep, type StepProps as StepperStepProps, SupersetWrapper, type SupersetWrapperProps, Surface, type SurfaceProps, SvgIcon, type SvgIconProps, Switch, type SwitchProps, type SwitchSize, TEMPO_PACING, Tab, TabList, type TabListProps, TabPanel, type TabPanelProps, TabPanels, type TabPanelsProps, type TabProps, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHeader, TableHeaderCell, type TableHeaderCellProps, type TableHeaderProps, TablePagination, type TablePaginationProps, type TableProps, TableRow, type TableRowProps, Tabs, type TabsOrientation, type TabsProps, type TabsVariant, TempoBar, type TempoBarProps, TempoDisplay, type TempoDisplayProps, type TempoLivePhase, type TempoLiveState, type TempoPacingState, type TempoPhaseKey, Toast, type ToastConfig, type ToastPosition, type ToastProps, ToastProvider, type ToastProviderProps, type ToastStatus, ToolbarButton, ToolbarButtonGroup, type ToolbarButtonGroupProps, type ToolbarButtonProps, type ToolbarButtonSize, type ToolbarButtonVariant, Tooltip, type TooltipPlacement, type TooltipProps, TopBar, type TopBarProps, Treemap, type TreemapDatum, type TreemapProps, type TreemapScale, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, type UseTableOptions, type UseTableReturn, VStack, VoltrasMark, type VolumeStatus, type WarmUpStatus, type WarmUpValidation, WeightBadge, type WeightBadgeProps, type WeightBadgeSize, alpha, cn, composeValidators, createFieldId, formatDateTime, formatPrescription, formatSignedPct, formatVelocity, getContrastText, getFieldAriaProps, getFieldValidationProps, getLuminance, getResultColor, getStatusColor, getTempoFillPct, getTempoPacingState, hasMaxLength, hasMinLength, isEmpty, isValidEmail, roundRpe, roundTempo, roundWeight, rpeColor, useTable, useToast, useToolbarButton, validationRules };