@titan-design/react-ui 0.9.3 → 0.11.0

package/dist/{pages-DyEx-lBf.d.ts → pages-B1hqnGIC.d.ts}

@@ -18,6 +18,22 @@ interface WorkoutPillProps extends ViewProps {
 }
 declare function WorkoutPill({ name, status, pulse, onPress, highlighted, className, ...props }: WorkoutPillProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * One drawn cell of the chart. `rep` carries a `value` and draws a value-height bar;
+ * `todo` / `variable` / `continue` are the set-type window stubs (planned remainder, the
+ * range floor..max window, the AMRAP/myo open tail); `empty` is a rep COLUMN a side didn't
+ * log — a faint constant-contrast placeholder that keeps the two diverging wings index-locked
+ * (a lagging side's missing rep sits at the SAME column index as the other side's rep).
+ * `leadingGap` adds spacing BEFORE the cell beyond the uniform inter-bar gap — the WIDE
+ * chunk-notch that splits drop sub-loads / myo clusters / cluster intra-rests. Absent
+ * `leadingGap` = the ordinary rep gap.
+ */
+interface SetSlot {
+    kind: 'rep' | 'todo' | 'variable' | 'continue' | 'empty';
+    value?: number;
+    leadingGap?: number;
+}
+
 /**
  * Structural velocity-zone band accepted from an upstream analytics source
  * (e.g. workout-analytics' `VelocityZones.bands`).
@@ -68,10 +84,63 @@ interface VelocityStripProps extends ViewProps {
      */
     zones?: readonly VelocityZoneBandProp[];
     /**
-     * Live mode: index of the most-recently-completed rep. That bar animates in
-     * with a "pop"; if it is also the current set peak (a new best), it "bounces"
-     * instead. Only the latest bar animates. Honors `prefers-reduced-motion`.
-     * Framed `expanded` chart only (interactive tap-to-expand use).
+     * Bar-fill coloring mode. `loss` (DEFAULT) — color each performed bar by its
+     * velocity LOSS from the set's OWN best (see {@link getVelocityLossColor}), so a
+     * fatiguing set reads green→red by loss regardless of its absolute speed; ignores
+     * {@link zones} (it is a wholly separate scale). `zone` — color from the absolute
+     * velocity-zone scale ({@link zones} when provided, else the built-in
+     * ≥1.0/≥0.75/≥0.5 default). `todo`/`variable`/`continue` slots are unaffected either way.
+     */
+    barColor?: 'zone' | 'loss';
+    /**
+     * `hero` only: draw the VL20 / VL30 velocity-loss decision bands behind the bars
+     * (see {@link VelocityLossBands}). Defaults to on when {@link barColor} is `loss`
+     * (the default), off for `zone` — the bands and the loss bar-fill are the two
+     * halves of the same loss-relative language.
+     */
+    showLossBands?: boolean;
+    /**
+     * `hero` only: `up` (default) grows bars UP from a bottom baseline; `down` mirrors
+     * the whole plot (bars grow DOWN from a top baseline, text upright). The diverging
+     * dual is just an `up` hero over a `down` hero sharing one axis — so any hero
+     * improvement reaches the dual for free.
+     */
+    orientation?: 'up' | 'down';
+    /**
+     * `hero` only: OVERRIDE the height-scaling denominator with `scaleMax * headroom` instead of
+     * this strip's own `peak`/`fixed` scale. Affects BAR HEIGHT ONLY — velocity-LOSS coloring and
+     * the running-best reference line still measure off THIS strip's own velocities. The diverging
+     * dual passes the pair's shared max here so a stronger arm's bars read TALLER against one common
+     * scale while each arm still colors by its own loss.
+     */
+    scaleMax?: number;
+    /**
+     * `hero` only (internal): suppress this strip's own 2px baseline border. The diverging dual sets
+     * it on BOTH composed wings and draws ONE shared centre axis where they meet, so the axis is a
+     * single crisp line rather than two abutting baselines reading as a double-thick rule.
+     */
+    hideBaseline?: boolean;
+    /**
+     * `hero` only (internal): the EXACT rendered column structure, overriding this strip's own
+     * slot-building. The diverging dual builds ONE index-locked structure shared by both wings (same
+     * rep indices, same WIDE-gap positions, same column count; a column a side didn't log renders
+     * `empty`) and passes it here so bars line up column-for-column across the centre axis. Bar
+     * height / color / the running-best reference still read this strip's own `velocities`.
+     */
+    columnSlots?: SetSlot[];
+    /**
+     * `hero` only: an optional stream / slot NAME (e.g. "Left Arm"), rendered as a rotated vertical
+     * edge label down the chart's left gutter — the same treatment the diverging dual gives each wing,
+     * so a single hero and a dual read consistently. Omitted → no gutter.
+     */
+    label?: string;
+    /**
+     * Live mode: index of the most-recently-completed rep. That bar GROWS UP FROM
+     * THE BASELINE to its full height as it enters, tracking the rep as it lands;
+     * if it is also the current set peak (a new best) the growth slightly
+     * overshoots then settles, reading as a small bounce. Only the latest bar
+     * animates. Honors `prefers-reduced-motion`. Framed `expanded` chart and
+     * `hero` only (interactive tap-to-expand use).
      */
     liveRepIndex?: number;
     /**
@@ -83,16 +152,17 @@ interface VelocityStripProps extends ViewProps {
     onToggle?: () => void;
     onRepPress?: (index: number, velocity: number) => void;
     /**
-     * `mini` — a flat 3px static strip (set-type aware). `expanded` — the velocity-
-     * HEIGHT bar chart (rounded tops), whose chrome is prop-driven: with
-     * {@link showNumbers} or {@link showInfo} on it's the framed chart (raised surface,
-     * padding, per-bar m/s labels, mean/loss info row, interactive collapse); with both
-     * off it's a bare strip — the active-set "spotlight" of {@link ExerciseCard}. `hero`
-     * — the across-the-room, single-set wall treatment: tall bars, a per-bar m/s value
-     * label, a dashed running-best reference line, and dashed placeholders for the reps
-     * still to come (see {@link targetReps}). Reuses the zone scale and the live-rep pop.
+     * `compact` — the flat resting strip: {@link SetBarChart} in FLAT mode (uniform short bars, no
+     * value labels), sharing hero's exact geometry (colors, paper, spacing, chunk-notch, slots, gutter).
+     * `expanded` — the velocity-HEIGHT bar chart (rounded tops), whose chrome is prop-driven: with
+     * {@link showNumbers} or {@link showInfo} on it's the framed chart (raised surface, padding, per-bar
+     * m/s labels, mean/loss info row, interactive collapse); with both off it's a bare strip — the
+     * active-set "spotlight" of {@link ExerciseCard}. `hero` — the across-the-room, single-set wall
+     * treatment: tall bars, a per-bar m/s value label, a dashed running-best reference line, and dashed
+     * placeholders for the reps still to come (see {@link targetReps}). All three share SetBarChart, so
+     * bars align across compact / expanded / hero.
      */
-    variant?: 'mini' | 'expanded' | 'hero';
+    variant?: 'compact' | 'expanded' | 'hero';
     /** `expanded` / `hero` plot height in px (bars scale to this). Default 60 (`expanded`) / 220 (`hero`). */
     height?: number;
     /**
@@ -167,7 +237,71 @@ type VelocitySet =
     groupSize: number;
     planned?: number;
 };
-declare function VelocityStrip({ velocities, set, zones, liveRepIndex, expanded, onToggle, onRepPress, variant, height, targetReps, scale, showNumbers, showInfo, className, ...props }: VelocityStripProps): react_jsx_runtime.JSX.Element | null;
+/** One voltra's velocity stream — the SAME shape VelocityStrip accepts (one of these). */
+interface DualVelocityStream {
+    /** Per-rep MEAN concentric velocity (m/s) for this side. */
+    velocities?: number[];
+    /** A structured set descriptor for this side (drives the typed slot vocabulary). */
+    set?: VelocitySet;
+    /**
+     * The side's SLOT NAME (e.g. "Left Arm"), rendered as the vertical edge label. This is
+     * the slot's identity supplied by data — there is no hardcoded LEFT/RIGHT fallback. When
+     * absent or empty, that side renders no label.
+     */
+    label?: string;
+}
+interface DualVelocityStripProps extends ViewProps {
+    /** The up-wing stream — drawn growing UP from the centre axis; its edge name comes from `left.label`. */
+    left: DualVelocityStream;
+    /** The down-wing stream — drawn growing DOWN from the centre axis; its edge name comes from `right.label`. */
+    right: DualVelocityStream;
+    /**
+     * Optional velocity-zone bands (shape-compatible with WA's `VelocityZones.bands`),
+     * shared with {@link VelocityStrip}. Colors the reps by zone on BOTH sides; side is
+     * never encoded by hue. When omitted the built-in default scale is used.
+     */
+    zones?: readonly VelocityZoneBandProp[];
+    /**
+     * Bar-fill coloring mode, matching {@link VelocityStrip}. `loss` (DEFAULT) — each
+     * wing colors by its velocity LOSS from THAT arm's own best (per-wing, since arms
+     * fatigue independently). `zone` — the shared absolute zone scale. Side is never
+     * encoded by hue either way.
+     */
+    barColor?: 'zone' | 'loss';
+    /**
+     * Planned rep count. Reps beyond a side's performed count draw as mirrored dashed
+     * todo stubs (same "3 of 8 done" read as the single hero), on both wings.
+     */
+    targetReps?: number;
+    /** Index of the most-recently-completed rep; that mirrored pair animates in (hero only). */
+    liveRepIndex?: number;
+    /**
+     * `hero` — the across-the-room wall scale: tall wings, per-rep m/s value labels, and a dashed
+     * running-best reference line per side. `compact` — the flat resting form: dual-hero but flat +
+     * no labels (both wings are the `compact` VelocityStrip variant), same aligned structure + shared
+     * gutter + axis. `rail` — the compact rail-expanded lean renderer, no labels / reference lines.
+     */
+    variant?: 'hero' | 'compact' | 'rail';
+    /**
+     * Bar-height scaling, shared across BOTH wings so the L/R asymmetry reads as bar
+     * length against one scale. `peak` (default) = the pair's max +headroom; `fixed` =
+     * a fixed velocity ceiling.
+     */
+    scale?: 'peak' | 'fixed';
+    /** Total plot height (px), split evenly into the up (L) and down (R) wings. */
+    height?: number;
+    className?: string;
+}
+/**
+ * The dual-voltra (bilateral) DIVERGING per-rep velocity chart. The up-wing stream grows UP, the
+ * down-wing stream grows DOWN from one shared centre axis. The `hero` variant COMPOSES two single
+ * {@link VelocityStrip} heroes (see {@link DualVelocityHero}) so any hero improvement reaches the
+ * dual for free; `rail` uses a lean value-height renderer ({@link DualVelocityRail}); `compact` folds
+ * the pair into one 8px strip ({@link DualVelocityCompactStrip}). Single-voltra sets keep using
+ * {@link VelocityStrip} (`variant="hero"`) — unchanged.
+ */
+declare function DualVelocityStrip({ left, right, zones, barColor, targetReps, liveRepIndex, variant, scale, height, className, ...props }: DualVelocityStripProps): react_jsx_runtime.JSX.Element;
+declare function VelocityStrip({ velocities, set, zones, barColor, showLossBands, orientation, scaleMax, hideBaseline, columnSlots, label, liveRepIndex, expanded, onToggle, onRepPress, variant, height, targetReps, scale, showNumbers, showInfo, className, ...props }: VelocityStripProps): react_jsx_runtime.JSX.Element | null;
 
 type SetRowUnit = 'lbs' | 'kg';
 /** A set's lifecycle: logged (`done`), being performed now (`live`), or planned (`todo`). */
@@ -1020,4 +1154,4 @@ declare function groupExercises(exercises: ActiveWorkoutExercise[], supersets: A
  */
 declare function ActiveWorkoutPage({ title, subtitle, exercises, supersets, input, rest, initialResting, className, ...props }: ActiveWorkoutPageProps): react_jsx_runtime.JSX.Element;
 
-export { VelocityStrip as $, type ActiveExerciseStatus as A, type PlanWeek as B, CapacityBandChart as C, type PlanWorkout as D, type ExerciseIndicatorKind as E, type ProgramBreadcrumb as F, type ProgramNavLevel as G, type ProgramPlanningPageProps as H, INDICATOR_PRECEDENCE as I, type ProgramSelection as J, SET_STRIP_VARIABLE_COLOR as K, SET_STRIP_ZONES as L, type Meso as M, SetBar as N, type SetBarProps as O, type PlanMeso as P, SetRow as Q, type SetRowProps as R, type SetStripSet as S, type SetRowState as T, type SetRowUnit as U, StrengthTrendChart as V, type StrengthTrendChartMesoBoundary as W, type StrengthTrendChartProps as X, type StrengthTrendDataPoint as Y, type VbtSummary as Z, type VelocitySet as _, type ActiveWorkoutExercise as a, type VelocityStripProps as a0, type VelocityZoneBandProp as a1, WeekRow as a2, type WeekRowProps as a3, type WeekRowWorkout as a4, WorkoutCard as a5, type WorkoutCardProps as a6, type WorkoutDot as a7, type WorkoutDotStatus as a8, type WorkoutGroup as a9, groupExercises as aA, isUpcomingExercise as aB, summarizeVbt as aC, toActiveCardProps as aD, toExerciseCardProps as aE, toProgressBarMesos as aF, type WorkoutMuscleGroup as aa, type WorkoutMuscleVolumeStatus as ab, WorkoutPill as ac, type WorkoutPillProps as ad, type WorkoutPillStatus as ae, type WorkoutProgress as af, type WorkoutStatus as ag, calculateMeanVelocity as ah, calculateVelocityLoss as ai, getVelocityZoneColor as aj, getVelocityZoneName as ak, resolveIndicator as al, velocityZoneColor as am, ActiveWorkoutPage as an, EXERCISE_DETAIL_TABS as ao, ExerciseDetailPage as ap, ProgramPlanningPage as aq, buildBreadcrumbs as ar, countCompletedSets as as, deriveExerciseStats as at, deriveNavLevel as au, deriveWorkoutProgress as av, findActiveExercise as aw, findMeso as ax, findWeek as ay, findWorkout as az, type ActiveWorkoutInput as b, type ActiveWorkoutPageProps as c, type ActiveWorkoutRest as d, type ActiveWorkoutSuperset as e, type CapacityBandChartProps as f, type CapacityBandDataPoint as g, type CapacityBandProjection as h, ExerciseCard as i, type ExerciseCardProps as j, type ExerciseDetailEntry as k, type ExerciseDetailHeader as l, type ExerciseDetailPageProps as m, type ExerciseDetailStats as n, type ExerciseDetailTab as o, ExerciseIndicator as p, type ExerciseIndicatorProps as q, type ExerciseTrend as r, type ExerciseVbt as s, type ExerciseVbtSet as t, MesoCard as u, type MesoCardProps as v, MesoProgressBar as w, type MesoProgressBarProps as x, type MesoStatus as y, type MesoVolumeHeatmapEntry as z };
+export { type StrengthTrendDataPoint as $, type ActiveExerciseStatus as A, type MesoProgressBarProps as B, CapacityBandChart as C, type DualVelocityStream as D, type ExerciseIndicatorKind as E, type MesoStatus as F, type MesoVolumeHeatmapEntry as G, type PlanWeek as H, INDICATOR_PRECEDENCE as I, type PlanWorkout as J, type ProgramBreadcrumb as K, type ProgramNavLevel as L, type Meso as M, type ProgramPlanningPageProps as N, type ProgramSelection as O, type PlanMeso as P, SET_STRIP_VARIABLE_COLOR as Q, SET_STRIP_ZONES as R, type SetStripSet as S, SetBar as T, type SetBarProps as U, SetRow as V, type SetRowState as W, type SetRowUnit as X, StrengthTrendChart as Y, type StrengthTrendChartMesoBoundary as Z, type StrengthTrendChartProps as _, type SetRowProps as a, type VbtSummary as a0, type VelocitySet as a1, VelocityStrip as a2, type VelocityStripProps as a3, type VelocityZoneBandProp as a4, WeekRow as a5, type WeekRowProps as a6, type WeekRowWorkout as a7, WorkoutCard as a8, type WorkoutCardProps as a9, findMeso as aA, findWeek as aB, findWorkout as aC, groupExercises as aD, isUpcomingExercise as aE, summarizeVbt as aF, toActiveCardProps as aG, toExerciseCardProps as aH, toProgressBarMesos as aI, type WorkoutDot as aa, type WorkoutDotStatus as ab, type WorkoutGroup as ac, type WorkoutMuscleGroup as ad, type WorkoutMuscleVolumeStatus as ae, WorkoutPill as af, type WorkoutPillProps as ag, type WorkoutPillStatus as ah, type WorkoutProgress as ai, type WorkoutStatus as aj, calculateMeanVelocity as ak, calculateVelocityLoss as al, getVelocityZoneColor as am, getVelocityZoneName as an, resolveIndicator as ao, velocityZoneColor as ap, ActiveWorkoutPage as aq, EXERCISE_DETAIL_TABS as ar, ExerciseDetailPage as as, ProgramPlanningPage as at, buildBreadcrumbs as au, countCompletedSets as av, deriveExerciseStats as aw, deriveNavLevel as ax, deriveWorkoutProgress as ay, findActiveExercise as az, type ActiveWorkoutExercise as b, type ActiveWorkoutInput as c, type ActiveWorkoutPageProps as d, type ActiveWorkoutRest as e, type ActiveWorkoutSuperset as f, type CapacityBandChartProps as g, type CapacityBandDataPoint as h, type CapacityBandProjection as i, DualVelocityStrip as j, type DualVelocityStripProps as k, ExerciseCard as l, type ExerciseCardProps as m, type ExerciseDetailEntry as n, type ExerciseDetailHeader as o, type ExerciseDetailPageProps as p, type ExerciseDetailStats as q, type ExerciseDetailTab as r, ExerciseIndicator as s, type ExerciseIndicatorProps as t, type ExerciseTrend as u, type ExerciseVbt as v, type ExerciseVbtSet as w, MesoCard as x, type MesoCardProps as y, MesoProgressBar as z };

package/dist/{pages-D7hOD4Vj.d.mts → pages-CvsFqNtx.d.mts}

@@ -18,6 +18,22 @@ interface WorkoutPillProps extends ViewProps {
 }
 declare function WorkoutPill({ name, status, pulse, onPress, highlighted, className, ...props }: WorkoutPillProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * One drawn cell of the chart. `rep` carries a `value` and draws a value-height bar;
+ * `todo` / `variable` / `continue` are the set-type window stubs (planned remainder, the
+ * range floor..max window, the AMRAP/myo open tail); `empty` is a rep COLUMN a side didn't
+ * log — a faint constant-contrast placeholder that keeps the two diverging wings index-locked
+ * (a lagging side's missing rep sits at the SAME column index as the other side's rep).
+ * `leadingGap` adds spacing BEFORE the cell beyond the uniform inter-bar gap — the WIDE
+ * chunk-notch that splits drop sub-loads / myo clusters / cluster intra-rests. Absent
+ * `leadingGap` = the ordinary rep gap.
+ */
+interface SetSlot {
+    kind: 'rep' | 'todo' | 'variable' | 'continue' | 'empty';
+    value?: number;
+    leadingGap?: number;
+}
+
 /**
  * Structural velocity-zone band accepted from an upstream analytics source
  * (e.g. workout-analytics' `VelocityZones.bands`).
@@ -68,10 +84,63 @@ interface VelocityStripProps extends ViewProps {
      */
     zones?: readonly VelocityZoneBandProp[];
     /**
-     * Live mode: index of the most-recently-completed rep. That bar animates in
-     * with a "pop"; if it is also the current set peak (a new best), it "bounces"
-     * instead. Only the latest bar animates. Honors `prefers-reduced-motion`.
-     * Framed `expanded` chart only (interactive tap-to-expand use).
+     * Bar-fill coloring mode. `loss` (DEFAULT) — color each performed bar by its
+     * velocity LOSS from the set's OWN best (see {@link getVelocityLossColor}), so a
+     * fatiguing set reads green→red by loss regardless of its absolute speed; ignores
+     * {@link zones} (it is a wholly separate scale). `zone` — color from the absolute
+     * velocity-zone scale ({@link zones} when provided, else the built-in
+     * ≥1.0/≥0.75/≥0.5 default). `todo`/`variable`/`continue` slots are unaffected either way.
+     */
+    barColor?: 'zone' | 'loss';
+    /**
+     * `hero` only: draw the VL20 / VL30 velocity-loss decision bands behind the bars
+     * (see {@link VelocityLossBands}). Defaults to on when {@link barColor} is `loss`
+     * (the default), off for `zone` — the bands and the loss bar-fill are the two
+     * halves of the same loss-relative language.
+     */
+    showLossBands?: boolean;
+    /**
+     * `hero` only: `up` (default) grows bars UP from a bottom baseline; `down` mirrors
+     * the whole plot (bars grow DOWN from a top baseline, text upright). The diverging
+     * dual is just an `up` hero over a `down` hero sharing one axis — so any hero
+     * improvement reaches the dual for free.
+     */
+    orientation?: 'up' | 'down';
+    /**
+     * `hero` only: OVERRIDE the height-scaling denominator with `scaleMax * headroom` instead of
+     * this strip's own `peak`/`fixed` scale. Affects BAR HEIGHT ONLY — velocity-LOSS coloring and
+     * the running-best reference line still measure off THIS strip's own velocities. The diverging
+     * dual passes the pair's shared max here so a stronger arm's bars read TALLER against one common
+     * scale while each arm still colors by its own loss.
+     */
+    scaleMax?: number;
+    /**
+     * `hero` only (internal): suppress this strip's own 2px baseline border. The diverging dual sets
+     * it on BOTH composed wings and draws ONE shared centre axis where they meet, so the axis is a
+     * single crisp line rather than two abutting baselines reading as a double-thick rule.
+     */
+    hideBaseline?: boolean;
+    /**
+     * `hero` only (internal): the EXACT rendered column structure, overriding this strip's own
+     * slot-building. The diverging dual builds ONE index-locked structure shared by both wings (same
+     * rep indices, same WIDE-gap positions, same column count; a column a side didn't log renders
+     * `empty`) and passes it here so bars line up column-for-column across the centre axis. Bar
+     * height / color / the running-best reference still read this strip's own `velocities`.
+     */
+    columnSlots?: SetSlot[];
+    /**
+     * `hero` only: an optional stream / slot NAME (e.g. "Left Arm"), rendered as a rotated vertical
+     * edge label down the chart's left gutter — the same treatment the diverging dual gives each wing,
+     * so a single hero and a dual read consistently. Omitted → no gutter.
+     */
+    label?: string;
+    /**
+     * Live mode: index of the most-recently-completed rep. That bar GROWS UP FROM
+     * THE BASELINE to its full height as it enters, tracking the rep as it lands;
+     * if it is also the current set peak (a new best) the growth slightly
+     * overshoots then settles, reading as a small bounce. Only the latest bar
+     * animates. Honors `prefers-reduced-motion`. Framed `expanded` chart and
+     * `hero` only (interactive tap-to-expand use).
      */
     liveRepIndex?: number;
     /**
@@ -83,16 +152,17 @@ interface VelocityStripProps extends ViewProps {
     onToggle?: () => void;
     onRepPress?: (index: number, velocity: number) => void;
     /**
-     * `mini` — a flat 3px static strip (set-type aware). `expanded` — the velocity-
-     * HEIGHT bar chart (rounded tops), whose chrome is prop-driven: with
-     * {@link showNumbers} or {@link showInfo} on it's the framed chart (raised surface,
-     * padding, per-bar m/s labels, mean/loss info row, interactive collapse); with both
-     * off it's a bare strip — the active-set "spotlight" of {@link ExerciseCard}. `hero`
-     * — the across-the-room, single-set wall treatment: tall bars, a per-bar m/s value
-     * label, a dashed running-best reference line, and dashed placeholders for the reps
-     * still to come (see {@link targetReps}). Reuses the zone scale and the live-rep pop.
+     * `compact` — the flat resting strip: {@link SetBarChart} in FLAT mode (uniform short bars, no
+     * value labels), sharing hero's exact geometry (colors, paper, spacing, chunk-notch, slots, gutter).
+     * `expanded` — the velocity-HEIGHT bar chart (rounded tops), whose chrome is prop-driven: with
+     * {@link showNumbers} or {@link showInfo} on it's the framed chart (raised surface, padding, per-bar
+     * m/s labels, mean/loss info row, interactive collapse); with both off it's a bare strip — the
+     * active-set "spotlight" of {@link ExerciseCard}. `hero` — the across-the-room, single-set wall
+     * treatment: tall bars, a per-bar m/s value label, a dashed running-best reference line, and dashed
+     * placeholders for the reps still to come (see {@link targetReps}). All three share SetBarChart, so
+     * bars align across compact / expanded / hero.
      */
-    variant?: 'mini' | 'expanded' | 'hero';
+    variant?: 'compact' | 'expanded' | 'hero';
     /** `expanded` / `hero` plot height in px (bars scale to this). Default 60 (`expanded`) / 220 (`hero`). */
     height?: number;
     /**
@@ -167,7 +237,71 @@ type VelocitySet =
     groupSize: number;
     planned?: number;
 };
-declare function VelocityStrip({ velocities, set, zones, liveRepIndex, expanded, onToggle, onRepPress, variant, height, targetReps, scale, showNumbers, showInfo, className, ...props }: VelocityStripProps): react_jsx_runtime.JSX.Element | null;
+/** One voltra's velocity stream — the SAME shape VelocityStrip accepts (one of these). */
+interface DualVelocityStream {
+    /** Per-rep MEAN concentric velocity (m/s) for this side. */
+    velocities?: number[];
+    /** A structured set descriptor for this side (drives the typed slot vocabulary). */
+    set?: VelocitySet;
+    /**
+     * The side's SLOT NAME (e.g. "Left Arm"), rendered as the vertical edge label. This is
+     * the slot's identity supplied by data — there is no hardcoded LEFT/RIGHT fallback. When
+     * absent or empty, that side renders no label.
+     */
+    label?: string;
+}
+interface DualVelocityStripProps extends ViewProps {
+    /** The up-wing stream — drawn growing UP from the centre axis; its edge name comes from `left.label`. */
+    left: DualVelocityStream;
+    /** The down-wing stream — drawn growing DOWN from the centre axis; its edge name comes from `right.label`. */
+    right: DualVelocityStream;
+    /**
+     * Optional velocity-zone bands (shape-compatible with WA's `VelocityZones.bands`),
+     * shared with {@link VelocityStrip}. Colors the reps by zone on BOTH sides; side is
+     * never encoded by hue. When omitted the built-in default scale is used.
+     */
+    zones?: readonly VelocityZoneBandProp[];
+    /**
+     * Bar-fill coloring mode, matching {@link VelocityStrip}. `loss` (DEFAULT) — each
+     * wing colors by its velocity LOSS from THAT arm's own best (per-wing, since arms
+     * fatigue independently). `zone` — the shared absolute zone scale. Side is never
+     * encoded by hue either way.
+     */
+    barColor?: 'zone' | 'loss';
+    /**
+     * Planned rep count. Reps beyond a side's performed count draw as mirrored dashed
+     * todo stubs (same "3 of 8 done" read as the single hero), on both wings.
+     */
+    targetReps?: number;
+    /** Index of the most-recently-completed rep; that mirrored pair animates in (hero only). */
+    liveRepIndex?: number;
+    /**
+     * `hero` — the across-the-room wall scale: tall wings, per-rep m/s value labels, and a dashed
+     * running-best reference line per side. `compact` — the flat resting form: dual-hero but flat +
+     * no labels (both wings are the `compact` VelocityStrip variant), same aligned structure + shared
+     * gutter + axis. `rail` — the compact rail-expanded lean renderer, no labels / reference lines.
+     */
+    variant?: 'hero' | 'compact' | 'rail';
+    /**
+     * Bar-height scaling, shared across BOTH wings so the L/R asymmetry reads as bar
+     * length against one scale. `peak` (default) = the pair's max +headroom; `fixed` =
+     * a fixed velocity ceiling.
+     */
+    scale?: 'peak' | 'fixed';
+    /** Total plot height (px), split evenly into the up (L) and down (R) wings. */
+    height?: number;
+    className?: string;
+}
+/**
+ * The dual-voltra (bilateral) DIVERGING per-rep velocity chart. The up-wing stream grows UP, the
+ * down-wing stream grows DOWN from one shared centre axis. The `hero` variant COMPOSES two single
+ * {@link VelocityStrip} heroes (see {@link DualVelocityHero}) so any hero improvement reaches the
+ * dual for free; `rail` uses a lean value-height renderer ({@link DualVelocityRail}); `compact` folds
+ * the pair into one 8px strip ({@link DualVelocityCompactStrip}). Single-voltra sets keep using
+ * {@link VelocityStrip} (`variant="hero"`) — unchanged.
+ */
+declare function DualVelocityStrip({ left, right, zones, barColor, targetReps, liveRepIndex, variant, scale, height, className, ...props }: DualVelocityStripProps): react_jsx_runtime.JSX.Element;
+declare function VelocityStrip({ velocities, set, zones, barColor, showLossBands, orientation, scaleMax, hideBaseline, columnSlots, label, liveRepIndex, expanded, onToggle, onRepPress, variant, height, targetReps, scale, showNumbers, showInfo, className, ...props }: VelocityStripProps): react_jsx_runtime.JSX.Element | null;
 
 type SetRowUnit = 'lbs' | 'kg';
 /** A set's lifecycle: logged (`done`), being performed now (`live`), or planned (`todo`). */
@@ -1020,4 +1154,4 @@ declare function groupExercises(exercises: ActiveWorkoutExercise[], supersets: A
  */
 declare function ActiveWorkoutPage({ title, subtitle, exercises, supersets, input, rest, initialResting, className, ...props }: ActiveWorkoutPageProps): react_jsx_runtime.JSX.Element;
 
-export { VelocityStrip as $, type ActiveExerciseStatus as A, type PlanWeek as B, CapacityBandChart as C, type PlanWorkout as D, type ExerciseIndicatorKind as E, type ProgramBreadcrumb as F, type ProgramNavLevel as G, type ProgramPlanningPageProps as H, INDICATOR_PRECEDENCE as I, type ProgramSelection as J, SET_STRIP_VARIABLE_COLOR as K, SET_STRIP_ZONES as L, type Meso as M, SetBar as N, type SetBarProps as O, type PlanMeso as P, SetRow as Q, type SetRowProps as R, type SetStripSet as S, type SetRowState as T, type SetRowUnit as U, StrengthTrendChart as V, type StrengthTrendChartMesoBoundary as W, type StrengthTrendChartProps as X, type StrengthTrendDataPoint as Y, type VbtSummary as Z, type VelocitySet as _, type ActiveWorkoutExercise as a, type VelocityStripProps as a0, type VelocityZoneBandProp as a1, WeekRow as a2, type WeekRowProps as a3, type WeekRowWorkout as a4, WorkoutCard as a5, type WorkoutCardProps as a6, type WorkoutDot as a7, type WorkoutDotStatus as a8, type WorkoutGroup as a9, groupExercises as aA, isUpcomingExercise as aB, summarizeVbt as aC, toActiveCardProps as aD, toExerciseCardProps as aE, toProgressBarMesos as aF, type WorkoutMuscleGroup as aa, type WorkoutMuscleVolumeStatus as ab, WorkoutPill as ac, type WorkoutPillProps as ad, type WorkoutPillStatus as ae, type WorkoutProgress as af, type WorkoutStatus as ag, calculateMeanVelocity as ah, calculateVelocityLoss as ai, getVelocityZoneColor as aj, getVelocityZoneName as ak, resolveIndicator as al, velocityZoneColor as am, ActiveWorkoutPage as an, EXERCISE_DETAIL_TABS as ao, ExerciseDetailPage as ap, ProgramPlanningPage as aq, buildBreadcrumbs as ar, countCompletedSets as as, deriveExerciseStats as at, deriveNavLevel as au, deriveWorkoutProgress as av, findActiveExercise as aw, findMeso as ax, findWeek as ay, findWorkout as az, type ActiveWorkoutInput as b, type ActiveWorkoutPageProps as c, type ActiveWorkoutRest as d, type ActiveWorkoutSuperset as e, type CapacityBandChartProps as f, type CapacityBandDataPoint as g, type CapacityBandProjection as h, ExerciseCard as i, type ExerciseCardProps as j, type ExerciseDetailEntry as k, type ExerciseDetailHeader as l, type ExerciseDetailPageProps as m, type ExerciseDetailStats as n, type ExerciseDetailTab as o, ExerciseIndicator as p, type ExerciseIndicatorProps as q, type ExerciseTrend as r, type ExerciseVbt as s, type ExerciseVbtSet as t, MesoCard as u, type MesoCardProps as v, MesoProgressBar as w, type MesoProgressBarProps as x, type MesoStatus as y, type MesoVolumeHeatmapEntry as z };
+export { type StrengthTrendDataPoint as $, type ActiveExerciseStatus as A, type MesoProgressBarProps as B, CapacityBandChart as C, type DualVelocityStream as D, type ExerciseIndicatorKind as E, type MesoStatus as F, type MesoVolumeHeatmapEntry as G, type PlanWeek as H, INDICATOR_PRECEDENCE as I, type PlanWorkout as J, type ProgramBreadcrumb as K, type ProgramNavLevel as L, type Meso as M, type ProgramPlanningPageProps as N, type ProgramSelection as O, type PlanMeso as P, SET_STRIP_VARIABLE_COLOR as Q, SET_STRIP_ZONES as R, type SetStripSet as S, SetBar as T, type SetBarProps as U, SetRow as V, type SetRowState as W, type SetRowUnit as X, StrengthTrendChart as Y, type StrengthTrendChartMesoBoundary as Z, type StrengthTrendChartProps as _, type SetRowProps as a, type VbtSummary as a0, type VelocitySet as a1, VelocityStrip as a2, type VelocityStripProps as a3, type VelocityZoneBandProp as a4, WeekRow as a5, type WeekRowProps as a6, type WeekRowWorkout as a7, WorkoutCard as a8, type WorkoutCardProps as a9, findMeso as aA, findWeek as aB, findWorkout as aC, groupExercises as aD, isUpcomingExercise as aE, summarizeVbt as aF, toActiveCardProps as aG, toExerciseCardProps as aH, toProgressBarMesos as aI, type WorkoutDot as aa, type WorkoutDotStatus as ab, type WorkoutGroup as ac, type WorkoutMuscleGroup as ad, type WorkoutMuscleVolumeStatus as ae, WorkoutPill as af, type WorkoutPillProps as ag, type WorkoutPillStatus as ah, type WorkoutProgress as ai, type WorkoutStatus as aj, calculateMeanVelocity as ak, calculateVelocityLoss as al, getVelocityZoneColor as am, getVelocityZoneName as an, resolveIndicator as ao, velocityZoneColor as ap, ActiveWorkoutPage as aq, EXERCISE_DETAIL_TABS as ar, ExerciseDetailPage as as, ProgramPlanningPage as at, buildBreadcrumbs as au, countCompletedSets as av, deriveExerciseStats as aw, deriveNavLevel as ax, deriveWorkoutProgress as ay, findActiveExercise as az, type ActiveWorkoutExercise as b, type ActiveWorkoutInput as c, type ActiveWorkoutPageProps as d, type ActiveWorkoutRest as e, type ActiveWorkoutSuperset as f, type CapacityBandChartProps as g, type CapacityBandDataPoint as h, type CapacityBandProjection as i, DualVelocityStrip as j, type DualVelocityStripProps as k, ExerciseCard as l, type ExerciseCardProps as m, type ExerciseDetailEntry as n, type ExerciseDetailHeader as o, type ExerciseDetailPageProps as p, type ExerciseDetailStats as q, type ExerciseDetailTab as r, ExerciseIndicator as s, type ExerciseIndicatorProps as t, type ExerciseTrend as u, type ExerciseVbt as v, type ExerciseVbtSet as w, MesoCard as x, type MesoCardProps as y, MesoProgressBar as z };

package/dist/pages.d.mts

@@ -1,4 +1,4 @@
-export { A as ActiveExerciseStatus, a as ActiveWorkoutExercise, b as ActiveWorkoutInput, an as ActiveWorkoutPage, c as ActiveWorkoutPageProps, d as ActiveWorkoutRest, e as ActiveWorkoutSuperset, ao as EXERCISE_DETAIL_TABS, k as ExerciseDetailEntry, l as ExerciseDetailHeader, ap as ExerciseDetailPage, m as ExerciseDetailPageProps, n as ExerciseDetailStats, o as ExerciseDetailTab, r as ExerciseTrend, s as ExerciseVbt, t as ExerciseVbtSet, P as PlanMeso, B as PlanWeek, D as PlanWorkout, F as ProgramBreadcrumb, G as ProgramNavLevel, aq as ProgramPlanningPage, H as ProgramPlanningPageProps, J as ProgramSelection, Z as VbtSummary, a9 as WorkoutGroup, af as WorkoutProgress, ar as buildBreadcrumbs, as as countCompletedSets, at as deriveExerciseStats, au as deriveNavLevel, av as deriveWorkoutProgress, aw as findActiveExercise, ax as findMeso, ay as findWeek, az as findWorkout, aA as groupExercises, aB as isUpcomingExercise, aC as summarizeVbt, aD as toActiveCardProps, aE as toExerciseCardProps, aF as toProgressBarMesos } from './pages-D7hOD4Vj.mjs';
+export { A as ActiveExerciseStatus, b as ActiveWorkoutExercise, c as ActiveWorkoutInput, aq as ActiveWorkoutPage, d as ActiveWorkoutPageProps, e as ActiveWorkoutRest, f as ActiveWorkoutSuperset, ar as EXERCISE_DETAIL_TABS, n as ExerciseDetailEntry, o as ExerciseDetailHeader, as as ExerciseDetailPage, p as ExerciseDetailPageProps, q as ExerciseDetailStats, r as ExerciseDetailTab, u as ExerciseTrend, v as ExerciseVbt, w as ExerciseVbtSet, P as PlanMeso, H as PlanWeek, J as PlanWorkout, K as ProgramBreadcrumb, L as ProgramNavLevel, at as ProgramPlanningPage, N as ProgramPlanningPageProps, O as ProgramSelection, a0 as VbtSummary, ac as WorkoutGroup, ai as WorkoutProgress, au as buildBreadcrumbs, av as countCompletedSets, aw as deriveExerciseStats, ax as deriveNavLevel, ay as deriveWorkoutProgress, az as findActiveExercise, aA as findMeso, aB as findWeek, aC as findWorkout, aD as groupExercises, aE as isUpcomingExercise, aF as summarizeVbt, aG as toActiveCardProps, aH as toExerciseCardProps, aI as toProgressBarMesos } from './pages-CvsFqNtx.mjs';
 import 'react/jsx-runtime';
 import 'react-native';
 import './MesoStatusCard-CQk71hSi.mjs';

package/dist/pages.d.ts

@@ -1,4 +1,4 @@
-export { A as ActiveExerciseStatus, a as ActiveWorkoutExercise, b as ActiveWorkoutInput, an as ActiveWorkoutPage, c as ActiveWorkoutPageProps, d as ActiveWorkoutRest, e as ActiveWorkoutSuperset, ao as EXERCISE_DETAIL_TABS, k as ExerciseDetailEntry, l as ExerciseDetailHeader, ap as ExerciseDetailPage, m as ExerciseDetailPageProps, n as ExerciseDetailStats, o as ExerciseDetailTab, r as ExerciseTrend, s as ExerciseVbt, t as ExerciseVbtSet, P as PlanMeso, B as PlanWeek, D as PlanWorkout, F as ProgramBreadcrumb, G as ProgramNavLevel, aq as ProgramPlanningPage, H as ProgramPlanningPageProps, J as ProgramSelection, Z as VbtSummary, a9 as WorkoutGroup, af as WorkoutProgress, ar as buildBreadcrumbs, as as countCompletedSets, at as deriveExerciseStats, au as deriveNavLevel, av as deriveWorkoutProgress, aw as findActiveExercise, ax as findMeso, ay as findWeek, az as findWorkout, aA as groupExercises, aB as isUpcomingExercise, aC as summarizeVbt, aD as toActiveCardProps, aE as toExerciseCardProps, aF as toProgressBarMesos } from './pages-DyEx-lBf.js';
+export { A as ActiveExerciseStatus, b as ActiveWorkoutExercise, c as ActiveWorkoutInput, aq as ActiveWorkoutPage, d as ActiveWorkoutPageProps, e as ActiveWorkoutRest, f as ActiveWorkoutSuperset, ar as EXERCISE_DETAIL_TABS, n as ExerciseDetailEntry, o as ExerciseDetailHeader, as as ExerciseDetailPage, p as ExerciseDetailPageProps, q as ExerciseDetailStats, r as ExerciseDetailTab, u as ExerciseTrend, v as ExerciseVbt, w as ExerciseVbtSet, P as PlanMeso, H as PlanWeek, J as PlanWorkout, K as ProgramBreadcrumb, L as ProgramNavLevel, at as ProgramPlanningPage, N as ProgramPlanningPageProps, O as ProgramSelection, a0 as VbtSummary, ac as WorkoutGroup, ai as WorkoutProgress, au as buildBreadcrumbs, av as countCompletedSets, aw as deriveExerciseStats, ax as deriveNavLevel, ay as deriveWorkoutProgress, az as findActiveExercise, aA as findMeso, aB as findWeek, aC as findWorkout, aD as groupExercises, aE as isUpcomingExercise, aF as summarizeVbt, aG as toActiveCardProps, aH as toExerciseCardProps, aI as toProgressBarMesos } from './pages-B1hqnGIC.js';
 import 'react/jsx-runtime';
 import 'react-native';
 import './MesoStatusCard-CQk71hSi.js';