@titan-design/react-ui 0.4.0 → 0.5.0

package/src/test/stories-smoke.test.tsx

@@ -0,0 +1,50 @@
+import { describe, it, expect } from 'vitest'
+import { render } from '@testing-library/react'
+import { composeStories } from '@storybook/react'
+
+/**
+ * Storybook → render-test bridge (TD-04.11 / VW-20).
+ *
+ * The design system has a complete `*.stories.tsx` set but no test consumed it.
+ * This uses Storybook's portable-stories `composeStories` to mount EVERY story
+ * (with its args/decorators applied) through the same react-native-web + jsdom
+ * pipeline the unit tests use, asserting each renders without throwing and emits
+ * output. It's broad, near-free coverage that catches "this organism/variant
+ * crashes on render" regressions across the whole component set — the long tail
+ * the hand-written per-organism tests don't enumerate.
+ *
+ * Project annotations (the preview's theme decorator) are intentionally NOT
+ * applied: a smoke test only needs to prove each story renders, and skipping
+ * them avoids importing global.css / addon-themes into the test env.
+ */
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type StoryModule = Record<string, any>
+
+const storyModules = import.meta.glob<StoryModule>('../components/**/*.stories.tsx', {
+  eager: true,
+})
+
+describe('storybook stories render (composeStories smoke)', () => {
+  const entries = Object.entries(storyModules)
+
+  it('discovers a non-trivial number of story modules', () => {
+    expect(entries.length).toBeGreaterThan(10)
+  })
+
+  for (const [file, mod] of entries) {
+    const label = file.replace('../components/', '')
+    const composed = composeStories(mod)
+    for (const [name, Story] of Object.entries(composed)) {
+      it(`${label} › ${name} renders`, () => {
+        // Smoke level: every story must MOUNT without throwing. `firstChild` is
+        // not asserted — portal/modal organisms (PrHistoryModal) render into
+        // document.body, and empty-state stories legitimately render null; the
+        // hand-written per-organism tests own the detailed output assertions.
+        const result = render(<Story />)
+        expect(result.unmount).toBeTypeOf('function')
+        result.unmount()
+      })
+    }
+  }
+})

package/src/theme/barrel.ts

@@ -0,0 +1,53 @@
+// Theme surface WITHOUT the ThemeProvider value (dep hygiene, titan 0.5.0).
+//
+// `ThemeProvider` imports `nativewind` (`vars()`). Re-exporting it from the root
+// barrel dragged the whole nativewind import chain into every consumer of
+// `@titan-design/react-ui` — the web SPA paid for a native-only provider. This
+// file is the nativewind-free theme surface: the root barrel re-exports THIS,
+// and the `/theme` subpath (`./index.ts`) layers the `ThemeProvider` value on
+// top for the native consumers that deliberately import it.
+export * from './tokens'
+export * from './config'
+export * from './shadows'
+export * from './elevation'
+export * from './manifest'
+export { resolveColor } from './resolve-color'
+
+// ThemeProvider TYPES may stay on the root (erased at build — no nativewind
+// pull). Only the ThemeProvider VALUE moves to the `/theme` subpath.
+export type { ThemeProviderProps, ThemeProviderMode } from './ThemeProvider'
+
+// Re-export commonly used items
+export { getSemanticColors, type ThemeMode } from './tokens/semantic'
+export { getThemeCSSVars, gluestackConfig } from './config'
+export {
+  neumorphicShadows,
+  // Color math utilities (HSV-based)
+  lighten,
+  darken,
+  getHoverColors,
+  isDark,
+  hexToRgb,
+  rgbToHsv,
+  // Shadow creation functions
+  createRaisedShadow,
+  createRaisedHoverShadow,
+  createPressedShadow,
+  createPressedHoverShadow,
+  createFlatShadow,
+  shadowColors,
+  type ShadowIntensity,
+  type ShadowSurface,
+} from './shadows'
+export {
+  getElevationConfig,
+  getElevationSurface,
+  getElevationShadow,
+  getBaseSurfaceColor,
+  getValidatedElevation,
+  componentElevationRanges,
+  type ElevationLevel,
+  type ElevationConfig,
+  type ComponentType,
+} from './elevation'
+export * from './presets'

package/src/theme/index.ts

@@ -1,43 +1,8 @@
-// Theme exports
-export * from './tokens'
-export * from './config'
-export * from './shadows'
-export * from './elevation'
-export * from './manifest'
-export { ThemeProvider, type ThemeProviderProps, type ThemeProviderMode } from './ThemeProvider'
-export { resolveColor } from './resolve-color'
-
-// Re-export commonly used items
-export { getSemanticColors, type ThemeMode } from './tokens/semantic'
-export { getThemeCSSVars, gluestackConfig } from './config'
-export {
-  neumorphicShadows,
-  // Color math utilities (HSV-based)
-  lighten,
-  darken,
-  getHoverColors,
-  isDark,
-  hexToRgb,
-  rgbToHsv,
-  // Shadow creation functions
-  createRaisedShadow,
-  createRaisedHoverShadow,
-  createPressedShadow,
-  createPressedHoverShadow,
-  createFlatShadow,
-  shadowColors,
-  type ShadowIntensity,
-  type ShadowSurface,
-} from './shadows'
-export {
-  getElevationConfig,
-  getElevationSurface,
-  getElevationShadow,
-  getBaseSurfaceColor,
-  getValidatedElevation,
-  componentElevationRanges,
-  type ElevationLevel,
-  type ElevationConfig,
-  type ComponentType,
-} from './elevation'
-export * from './presets'
+// Theme subpath entry: @titan-design/react-ui/theme
+//
+// The full theme surface. This is the nativewind-free `./barrel` PLUS the
+// `ThemeProvider` value — which imports `nativewind` and therefore does NOT
+// belong on the root barrel (that split happened in titan 0.5.0). Native
+// consumers wrap their app root in `<ThemeProvider>` and import it from HERE.
+export * from './barrel'
+export { ThemeProvider } from './ThemeProvider'

package/src/theme/native-theming-guard.test.ts

@@ -0,0 +1,117 @@
+import { describe, it, expect } from 'vitest'
+import { createRequire } from 'node:module'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { darkThemeCSSVars, lightThemeCSSVars } from './config'
+import { getSemanticColors } from './tokens/semantic'
+
+/**
+ * Native-theming guard (TD-04.11 / VW-20).
+ *
+ * On native, titan resolves colors two ways, and BOTH can silently render black
+ * if a token is undefined:
+ *   1. `className` (e.g. `text-text-secondary`) → tailwind config → a
+ *      `var(--color-*)` custom property that `ThemeProvider` registers at runtime
+ *      via nativewind `vars(darkThemeCSSVars)`. A tailwind color pointing at a var
+ *      the theme maps don't define is unset on native → black text/fill.
+ *   2. `resolveColor(token)` → `getSemanticColors(mode)[token]` hex on native /
+ *      `var(--color-${token})` on web. A token missing a hex value, or whose
+ *      `--color-<token>` var is undefined, renders black (native) or unset (web).
+ *
+ * This is the exact class of bug that shipped in the 09.33a swap and was only
+ * caught on-device. `config.completeness.test.ts` proves the theme maps mirror
+ * global.css (the definition side); this guard covers the USAGE side — every
+ * color token the design system references must resolve to a defined token in
+ * both modes. Static (no render), so it runs in the fast project.
+ */
+
+const require = createRequire(import.meta.url)
+const uiRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..')
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const tailwindConfig = require(path.join(uiRoot, 'tailwind.config.js')) as any
+const colorTree = tailwindConfig.theme?.extend?.colors ?? {}
+
+// Flatten the nested tailwind color tree into `class-suffix -> leaf value`.
+// `DEFAULT` collapses onto its parent (tailwind's `brand.primary.DEFAULT` -> the
+// `brand-primary` class).
+function flattenColors(
+  node: Record<string, unknown>,
+  prefix: string[] = [],
+): Record<string, string> {
+  const out: Record<string, string> = {}
+  for (const [key, value] of Object.entries(node)) {
+    const nextPrefix = key === 'DEFAULT' ? prefix : [...prefix, key]
+    if (value && typeof value === 'object') {
+      Object.assign(out, flattenColors(value as Record<string, unknown>, nextPrefix))
+    } else if (typeof value === 'string') {
+      out[nextPrefix.join('-')] = value
+    }
+  }
+  return out
+}
+
+const colorLeaves = flattenColors(colorTree)
+const definedDark = new Set(Object.keys(darkThemeCSSVars))
+const definedLight = new Set(Object.keys(lightThemeCSSVars))
+
+function varReference(value: string): string | null {
+  const match = value.match(/var\((--color-[a-z0-9-]+)\)/)
+  return match ? match[1] : null
+}
+
+// Accept hex, rgb/rgba, and hsl/hsla; reject empty/undefined. (No token should be
+// literally "#000"/"black" in these maps, but that's a design choice, not a
+// resolution bug, so we only assert a *valid, present* color here.)
+const VALID_COLOR = /^(#[0-9a-f]{3,8}|rgba?\([^)]+\)|hsla?\([^)]+\))$/i
+
+describe('native theming guard (no color token renders black on native)', () => {
+  it('sanity: tailwind colors and theme maps flattened to non-trivial sets', () => {
+    expect(Object.keys(colorLeaves).length).toBeGreaterThan(50)
+    expect(definedDark.size).toBeGreaterThan(90)
+    expect(definedLight.size).toBe(definedDark.size)
+  })
+
+  it('every tailwind color className resolves to a var defined in BOTH native vars maps', () => {
+    const undefinedDark: string[] = []
+    const undefinedLight: string[] = []
+    for (const [suffix, value] of Object.entries(colorLeaves)) {
+      const ref = varReference(value)
+      if (!ref) continue // literal color (nativewind preset default) — always resolves
+      if (!definedDark.has(ref)) undefinedDark.push(`${suffix} -> ${value}`)
+      if (!definedLight.has(ref)) undefinedLight.push(`${suffix} -> ${value}`)
+    }
+    expect(
+      undefinedDark,
+      'tailwind colors point at vars missing from darkThemeCSSVars (className renders black on native dark)',
+    ).toEqual([])
+    expect(
+      undefinedLight,
+      'tailwind colors point at vars missing from lightThemeCSSVars (className renders black on native light)',
+    ).toEqual([])
+  })
+
+  it('every resolveColor/getSemanticColors token has a valid hex AND a matching --color-<token> var', () => {
+    for (const mode of ['dark', 'light'] as const) {
+      const colors = getSemanticColors(mode)
+      const defined = mode === 'dark' ? definedDark : definedLight
+      const invalidValues: string[] = []
+      const missingVars: string[] = []
+      for (const [token, value] of Object.entries(colors)) {
+        if (typeof value !== 'string' || !VALID_COLOR.test(value)) {
+          invalidValues.push(`${token} = ${JSON.stringify(value)}`)
+        }
+        // resolveColor's web path returns `var(--color-${token})`; that var must exist.
+        if (!defined.has(`--color-${token}`)) missingVars.push(token)
+      }
+      expect(
+        invalidValues,
+        `getSemanticColors('${mode}') has tokens with no valid color (renders black/unset on native)`,
+      ).toEqual([])
+      expect(
+        missingVars,
+        `resolveColor tokens missing a --color-<token> in ${mode} vars (renders unset on web)`,
+      ).toEqual([])
+    }
+  })
+})

package/dist/bodymap-BhG55xHM.d.mts

@@ -1,318 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ViewProps } from 'react-native';
-
-type MesoStatusBadgeVariant = 'success' | 'warning' | 'error';
-interface MesoStatusBadge {
-    /** Short status label, e.g. "On Track". */
-    label: string;
-    /** Color treatment for the badge. */
-    variant: MesoStatusBadgeVariant;
-}
-interface MesoStatusMetric {
-    /** Cell label, e.g. "Prescribed". */
-    label: string;
-    /** Cell value, e.g. "3×8 @ RPE 8". */
-    value: string;
-}
-interface MesoStatusGauge {
-    /** Gauge label, e.g. "Intensity". */
-    label: string;
-    /** Fill position 0-1; the 14px marker sits at this level. */
-    level: number;
-    /** Optional right-aligned sublabel, e.g. "Prescribed". */
-    sublabel?: string;
-}
-interface MesoStatusCoaching {
-    /** Coaching recommendation copy. */
-    text: string;
-    /** Substrings within `text` to render in bold. */
-    highlights?: string[];
-}
-interface MesoStatusNextTarget {
-    /** Leading glyph/emoji, e.g. "→" or "🎯". */
-    icon: string;
-    /** Next-session target copy. */
-    text: string;
-}
-interface MesoStatusCardProps extends ViewProps {
-    /** Mesocycle name, e.g. "Hypertrophy Block". */
-    mesoName: string;
-    /** Context line, e.g. "Week 6 of 8 · Upper/Lower". */
-    mesoSubtitle: string;
-    /** Status pill in the header. */
-    statusBadge: MesoStatusBadge;
-    /** Prescription-vs-actual metrics rendered as a 2x2 grid. */
-    metrics: MesoStatusMetric[];
-    /** Intensity / volume gauges stacked vertically. */
-    gauges: MesoStatusGauge[];
-    /** Optional coaching recommendation box. */
-    coaching?: MesoStatusCoaching;
-    /** Optional next-session target box. */
-    nextTarget?: MesoStatusNextTarget;
-    className?: string;
-}
-/**
- * Mesocycle context card for a specific exercise: prescription vs actual
- * metrics, intensity/volume gauges, and coaching guidance. Composes the titan
- * `Card` plus the Workout `StatusDot`, and renders the §25 gauge (8px track,
- * 50% center line, 14px marker) inline since that visual differs from the
- * IntensityBar/DeviationBar primitives.
- *
- * @example
- * <MesoStatusCard
- *   mesoName="Hypertrophy Block"
- *   mesoSubtitle="Week 6 of 8 · Upper/Lower"
- *   statusBadge={{ label: 'On Track', variant: 'success' }}
- *   metrics={[
- *     { label: 'Prescribed', value: '3×8 @ RPE 8' },
- *     { label: 'Actual', value: '3×8 @ 185 lbs' },
- *   ]}
- *   gauges={[{ label: 'Intensity', level: 0.7, sublabel: 'Actual' }]}
- *   coaching={{ text: 'Add load next session.', highlights: ['Add load'] }}
- *   nextTarget={{ icon: '→', text: '190 lbs × 8' }}
- * />
- */
-declare function MesoStatusCard({ mesoName, mesoSubtitle, statusBadge, metrics, gauges, coaching, nextTarget, className, ...props }: MesoStatusCardProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Full muscle group taxonomy for volume tracking and exercise mapping.
- * 15 groups — the primary unit for volume accounting.
- */
-declare enum MuscleGroup {
-    CHEST = "chest",
-    FRONT_DELTS = "front_delts",
-    SIDE_DELTS = "side_delts",
-    TRICEPS = "triceps",
-    LATS = "lats",
-    UPPER_BACK = "upper_back",
-    REAR_DELTS = "rear_delts",
-    BICEPS = "biceps",
-    FOREARMS = "forearms",
-    QUADS = "quads",
-    HAMSTRINGS = "hamstrings",
-    GLUTES = "glutes",
-    CALVES = "calves",
-    ABS = "abs",
-    OBLIQUES = "obliques"
-}
-/**
- * Simplified muscle group view for beginners. Maps to one or more MuscleGroup.
- */
-declare enum SimpleMuscleGroup {
-    CHEST = "chest",
-    BACK = "back",
-    SHOULDERS = "shoulders",
-    BICEPS = "biceps",
-    TRICEPS = "triceps",
-    LEGS = "legs",
-    CORE = "core",
-    FOREARMS = "forearms"
-}
-/** Mapping from simplified groups to the full taxonomy. */
-declare const SIMPLE_TO_DETAILED: Record<SimpleMuscleGroup, MuscleGroup[]>;
-/** Reverse map: detailed MuscleGroup -> its SimpleMuscleGroup. */
-declare const DETAILED_TO_SIMPLE: Record<MuscleGroup, SimpleMuscleGroup>;
-/** Movement category for training split organization. */
-type MovementCategory = 'push' | 'pull' | 'legs' | 'core';
-declare const MUSCLE_TO_CATEGORY: Record<MuscleGroup, MovementCategory>;
-/**
- * react-native-body-highlighter slug(s) per muscle group. Phase 1 uses the
- * closest available slug; deltoids share one path and lats/upper-back share
- * `upper-back` (see doc Level 4 "Recommended approach").
- */
-declare const MUSCLE_TO_SVG_SLUGS: Record<MuscleGroup, string[]>;
-/** Human-readable name per muscle group (used in a11y labels). */
-declare const MUSCLE_DISPLAY_NAMES: Record<MuscleGroup, string>;
-/** Human-readable name per simple group. */
-declare const SIMPLE_DISPLAY_NAMES: Record<SimpleMuscleGroup, string>;
-/** Volume landmarks per muscle group (weekly working sets). */
-interface VolumeLandmarks {
-    mev: number;
-    mav: number;
-    mrv: number;
-}
-declare const DEFAULT_VOLUME_LANDMARKS: Record<MuscleGroup, VolumeLandmarks>;
-/** Weekly-volume status relative to MEV/MAV/MRV landmarks. */
-type VolumeStatus = 'under' | 'maintenance' | 'productive' | 'over';
-/** Readable label per status for a11y descriptions. */
-declare const VOLUME_STATUS_LABELS: Record<VolumeStatus, string>;
-/**
- * Maps a volume status (and intensity, 0-1) to a heatmap fill color. The
- * `approaching` token is used when a productive muscle nears its MRV.
- */
-declare function getHeatmapColor(status: VolumeStatus | null | undefined, intensity?: number): string;
-
-interface BodyMapData {
-    muscleGroup: MuscleGroup;
-    /** Intensity 0-1 for heatmap color. */
-    intensity: number;
-    /** Volume status for tooltip / heatmap token. */
-    volumeStatus: VolumeStatus;
-    /** Weekly effective sets. */
-    weeklySets: number;
-}
-interface BodyMapProps extends ViewProps {
-    /** Muscle group intensity data. */
-    data: BodyMapData[];
-    /** Which view to show. */
-    view: 'front' | 'back';
-    /** Toggle between front/back. */
-    onViewChange?: (view: 'front' | 'back') => void;
-    /** Called when a muscle group is tapped. */
-    onMusclePress?: (muscleGroup: MuscleGroup) => void;
-    /** Currently highlighted muscle (from external selection). */
-    highlightedMuscle?: MuscleGroup | null;
-    /** Show simplified (8 groups) or detailed (15 groups). */
-    mode?: 'simple' | 'detailed';
-    className?: string;
-}
-/**
- * Interactive SVG body map with tappable muscle groups and a volume heatmap.
- * Renders the front or back view (toggle via onViewChange), colors each muscle
- * by its weekly-volume status, and exposes an accessible muscle legend wired to
- * onMusclePress. Phase 1 uses react-native-body-highlighter's combined slugs
- * (deltoids as one path, lats/upper-back shared); swipe between views and the
- * delt/lat SVG split are follow-ups.
- *
- * @example
- * <BodyMap
- *   data={[{ muscleGroup: MuscleGroup.CHEST, intensity: 0.7, volumeStatus: 'productive', weeklySets: 12 }]}
- *   view="front"
- *   onViewChange={setView}
- *   onMusclePress={setSelected}
- *   highlightedMuscle={selected}
- * />
- */
-declare function BodyMap({ data, view, onViewChange, onMusclePress, highlightedMuscle, mode, className, ...props }: BodyMapProps): react_jsx_runtime.JSX.Element;
-
-interface ContributingExercise {
-    /** Exercise name. */
-    name: string;
-    /** Working sets contributed this week. */
-    sets: number;
-    /** Effective-set multiplier toward this muscle (0-1). */
-    contributionWeight: number;
-}
-interface UpcomingExercise {
-    /** Exercise name. */
-    name: string;
-    /** Workout the exercise belongs to. */
-    workoutName: string;
-    /** Planned sets. */
-    sets: number;
-}
-interface BodyMapDetailPanelProps extends ViewProps {
-    /** Muscle group whose volume detail is shown. */
-    muscleGroup: MuscleGroup;
-    /** Human-readable muscle name for the title and a11y label. */
-    displayName: string;
-    /** Weekly effective sets logged for this muscle. */
-    weeklySets: number;
-    /** Volume landmarks (weekly working sets). */
-    landmarks: VolumeLandmarks;
-    /** Weekly-volume status relative to the landmarks. */
-    volumeStatus: VolumeStatus;
-    /** Last trained label, e.g. "2 days ago". */
-    lastTrained?: string;
-    /** Volume sparkline data (last 4-8 weeks). */
-    weeklyHistory?: number[];
-    /** Exercises contributing to this muscle's volume. */
-    contributingExercises?: ContributingExercise[];
-    /** Upcoming exercises targeting this muscle. */
-    upcomingExercises?: UpcomingExercise[];
-    /** Whether the bottom sheet is visible. */
-    isOpen?: boolean;
-    /** Alias for `isOpen` (spec wording: "isOpen/visible"). `isOpen` wins when both are set. */
-    visible?: boolean;
-    /** Dismiss the panel (backdrop, handle, or close button). */
-    onClose: () => void;
-    /** Navigate to a filtered exercise list. */
-    onViewExercises?: () => void;
-}
-/**
- * Slide-up bottom-sheet panel with detailed weekly-volume info for a tapped
- * muscle group: a MEV|current|MRV gradient progress bar, the big weekly set
- * count against MRV, an optional volume sparkline, and the contributing /
- * upcoming exercise lists. Composes the titan `Badge` and Workout `Sparkline`.
- *
- * Controlled via `isOpen` (or the `visible` alias); renders nothing when closed
- * and animates in on open — sheet translateY 400->0 (400ms ease-out) and a
- * backdrop fade 0->0.4 (RN Animated, useNativeDriver:false). Backdrop, handle,
- * and the header close button all call `onClose`.
- *
- * @example
- * <BodyMapDetailPanel
- *   muscleGroup={MuscleGroup.CHEST}
- *   displayName="Chest"
- *   weeklySets={14}
- *   landmarks={{ mev: 8, mav: 14, mrv: 20 }}
- *   volumeStatus="productive"
- *   lastTrained="2 days ago"
- *   weeklyHistory={[8, 10, 12, 14]}
- *   isOpen={open}
- *   onClose={() => setOpen(false)}
- * />
- */
-declare function BodyMapDetailPanel({ muscleGroup, displayName, weeklySets, landmarks, volumeStatus, lastTrained, weeklyHistory, contributingExercises, upcomingExercises, isOpen, visible, onClose, onViewExercises, ...props }: BodyMapDetailPanelProps): react_jsx_runtime.JSX.Element | null;
-
-/** One muscle's full volume picture — feeds the body maps and the detail panel. */
-interface TrainingStatusMuscle {
-    /** Detailed muscle group (drives the SVG heatmap + panel identity). */
-    muscleGroup: MuscleGroup;
-    /** Human-readable name for the legend, summary, and panel title. */
-    displayName: string;
-    /** Which body-map view the muscle belongs to. */
-    side: 'front' | 'back';
-    /** Heatmap intensity 0-1. */
-    intensity: number;
-    /** Weekly-volume status relative to the landmarks. */
-    volumeStatus: VolumeStatus;
-    /** Weekly effective sets logged. */
-    weeklySets: number;
-    /** Volume landmarks (weekly working sets). */
-    landmarks: VolumeLandmarks;
-    /** Last trained label, e.g. "2 days ago". */
-    lastTrained?: string;
-    /** Weekly volume history for the panel sparkline. */
-    weeklyHistory?: number[];
-    /** Exercises contributing to this muscle's volume. */
-    contributingExercises?: ContributingExercise[];
-    /** Upcoming exercises targeting this muscle. */
-    upcomingExercises?: UpcomingExercise[];
-}
-/** Derived, page-level roll-up of the tracked muscles. */
-interface TrainingStatusSummary {
-    /** Total weekly effective sets across all tracked muscles. */
-    totalWeeklySets: number;
-    /** Number of muscles being tracked. */
-    trackedMuscles: number;
-    /** Count of muscles per volume status. */
-    statusCounts: Record<VolumeStatus, number>;
-}
-interface TrainingStatusPageProps extends ViewProps {
-    /** Page heading. */
-    title?: string;
-    /** Mesocycle context banner shown at the top. */
-    meso: MesoStatusCardProps;
-    /** Muscles tracked this week. */
-    muscles: TrainingStatusMuscle[];
-    className?: string;
-}
-/** Roll up per-muscle rows into the page summary (pure, testable). */
-declare function deriveTrainingSummary(muscles: TrainingStatusMuscle[]): TrainingStatusSummary;
-/** Project the muscle rows for one side into `BodyMap` heatmap data. */
-declare function toBodyMapData(muscles: TrainingStatusMuscle[], side: 'front' | 'back'): BodyMapData[];
-/**
- * TrainingStatusPage — a body-map training dashboard that composes the
- * mesocycle context banner (`MesoStatusCard`), side-by-side front/back
- * `BodyMap`s with a shared heatmap legend, per-status summary cards, and a
- * tap-to-detail `BodyMapDetailPanel`. Tapping any muscle (SVG or legend chip)
- * opens the slide-up panel for that group; the summary is derived from the
- * supplied muscle rows.
- *
- * @example
- * <TrainingStatusPage meso={meso} muscles={muscles} />
- */
-declare function TrainingStatusPage({ title, meso, muscles, className, ...props }: TrainingStatusPageProps): react_jsx_runtime.JSX.Element;
-
-export { type BodyMapData as B, type ContributingExercise as C, DEFAULT_VOLUME_LANDMARKS as D, type MesoStatusCardProps as M, SimpleMuscleGroup as S, type TrainingStatusMuscle as T, type UpcomingExercise as U, type VolumeLandmarks as V, type BodyMapDetailPanelProps as a, type BodyMapProps as b, type MesoStatusBadge as c, type MesoStatusBadgeVariant as d, MesoStatusCard as e, type MesoStatusCoaching as f, type MesoStatusGauge as g, type MesoStatusMetric as h, type MesoStatusNextTarget as i, type MovementCategory as j, MuscleGroup as k, type TrainingStatusPageProps as l, type TrainingStatusSummary as m, BodyMap as n, BodyMapDetailPanel as o, DETAILED_TO_SIMPLE as p, MUSCLE_DISPLAY_NAMES as q, MUSCLE_TO_CATEGORY as r, MUSCLE_TO_SVG_SLUGS as s, SIMPLE_DISPLAY_NAMES as t, SIMPLE_TO_DETAILED as u, TrainingStatusPage as v, VOLUME_STATUS_LABELS as w, deriveTrainingSummary as x, getHeatmapColor as y, toBodyMapData as z };