@mt-gloss/ui 0.1.23 → 0.1.25

package/lib/primitives/TargetInput/TargetInput.d.ts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+export interface TargetInputProps {
+    /** Field label. Default: "Set a target". */
+    label?: string;
+    /** Unit suffix rendered next to the input ("$", "%", "units", ...). */
+    unit?: string;
+    /** Pre-fills the input for re-edit. */
+    currentValue?: number;
+    /** Fires on Confirm click or Enter key, with the parsed numeric value. */
+    onConfirm: (value: number) => void;
+    /** Fires on Skip click or Esc key. When undefined, Skip button is hidden. */
+    onSkip?: () => void;
+    /** Optional guidance rendered below the input. */
+    hint?: string;
+}
+export declare const TargetInput: React.FC<TargetInputProps>;

package/lib/primitives/TargetInput/index.d.ts

@@ -0,0 +1,2 @@
+export { TargetInput } from './TargetInput';
+export type { TargetInputProps } from './TargetInput';

package/lib/primitives/dashboard/LensChipGroup/LensChipGroup.d.ts

@@ -0,0 +1,19 @@
+/** GlossUI LensChipGroup type contracts. No context, BFF, or dashboard-specific imports. */
+export interface LensChipItem {
+    id: string;
+    label: string;
+    /** e.g. "BETA" rendered as 10px uppercase inline tag right of label */
+    badge?: string;
+    disabled?: boolean;
+}
+export interface LensChipGroupProps {
+    lenses: LensChipItem[];
+    /** selected lens id */
+    value: string;
+    onChange: (id: string) => void;
+    'aria-label'?: string;
+}
+export declare function LensChipGroup({ lenses, value, onChange, 'aria-label': ariaLabel, }: LensChipGroupProps): import("react/jsx-runtime").JSX.Element | null;
+export declare namespace LensChipGroup {
+    var displayName: string;
+}

package/lib/primitives/dashboard/LensChipGroup/index.d.ts

@@ -0,0 +1,2 @@
+export { LensChipGroup } from './LensChipGroup';
+export type { LensChipGroupProps, LensChipItem } from './LensChipGroup';

package/lib/primitives/dashboard/MetricCard/CardShell.d.ts

@@ -17,6 +17,6 @@ import { CardShellProps } from './types';
  * ```
  */
 export declare const CardShell: {
-    ({ contentSlot, children, colSpan, isStale, isRetrying, beta, disabled, style, accentRing, onGraph, onDetails, onCustomize, onRemove, onWhatsThis, onExpand, onShrink, onMove, onReplace, onNavigate, onRetry, onRefresh, enableQuickSettings, onUpdateTimeframe, instanceTimeframe, cardTitle, quickConfigSlot, onViewAsStack, onUnstack, isStackedGroup, onUpdateStackedTimeframes, instanceStackedTimeframes, isGraphActive, isTableActive, isGraphCard, canExpand, anchorX, extensionOverflow, cardRef: externalCardRef, hovered, forceHide, }: CardShellProps): import("react/jsx-runtime").JSX.Element;
+    ({ contentSlot, children, colSpan, isStale, isRetrying, beta, disabled, style, accentRing, onGraph, onDetails, onCustomize, onRemove, onWhatsThis, onExpand, onShrink, onMove, onReplace, onNavigate, onRetry, onRefresh, enableQuickSettings, onUpdateTimeframe, instanceTimeframe, cardTitle, quickConfigSlot, onViewAsStack, onUnstack, isStackedGroup, onUpdateStackedTimeframes, instanceStackedTimeframes, isGraphActive, isTableActive, isGraphCard, canExpand, anchorX, extensionOverflow, cardRef: externalCardRef, hovered, forceHide, isFlipped, onFlipChange, }: CardShellProps): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };

package/lib/primitives/dashboard/MetricCard/index.d.ts

@@ -30,6 +30,8 @@ export { formatValue } from './utils/formatValue';
 export { formatTrend } from './utils/formatTrend';
 export { computeGutterAnchorX } from './utils/computeGutterAnchorX';
 export type { GutterAnchorInput } from './utils/computeGutterAnchorX';
+export { evaluateTintCondition } from './tintCondition';
+export type { TintCondition, HighlightColorName } from './tintCondition';
 export { allVariantFixtures } from './fixtures/allVariants';
 export { loadingFixture, errorFixture, emptyFixture, staleFixture, staleSparklineFixture, staleDonutFixture, allStateFixtures, } from './fixtures/states';
 export { sparklineFixture, sparklineUpFixture } from './fixtures/sparklineCard';

package/lib/primitives/dashboard/MetricCard/tintCondition.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Rule-tint evaluator — Phase v3.0-01 Foundation (FOUND-CAT-07).
+ * Pure function, client-side only, called every render.
+ * Signature LOCKED — downstream phases (P3+) consume this API.
+ */
+export type HighlightColorName = 'positive' | 'negative' | 'warning' | 'neutral';
+export interface TintCondition {
+    operator: 'lt' | 'gt' | 'eq' | 'gte' | 'lte';
+    threshold: number;
+    result: HighlightColorName;
+    fallback?: HighlightColorName;
+}
+export declare function evaluateTintCondition(value: number | null | undefined, condition: TintCondition | undefined): HighlightColorName | undefined;

package/lib/primitives/dashboard/MetricCard/types.d.ts

@@ -1,4 +1,5 @@
 import { ReactNode, CSSProperties, RefObject } from 'react';
+import { TintCondition } from './tintCondition';
 /** Value formatting options. */
 export interface ValueFormat {
     prefix?: string;
@@ -71,7 +72,19 @@ export interface DonutVariant extends BaseMetricCardProps {
 }
 export interface HighlightVariant extends BaseMetricCardProps {
     variant: 'highlight';
+    /**
+     * Highlight tint. One of: 'positive' | 'negative' | 'warning' | 'neutral'
+     * (maps to HIGHLIGHT_COLORS in MetricCard.tsx + --highlight-* tokens).
+     * `'warning'` = the highlight-warn variant, completing the +/warn/− triad.
+     * Arbitrary hex is also accepted (legacy), but prefer the named values.
+     */
     highlightColor: string;
+    /**
+     * Optional rule-based tint. When set, overrides static `highlightColor`
+     * at render time via `evaluateTintCondition(value, tintCondition)`.
+     * Wired into MetricCard.tsx in Plan 01-04.
+     */
+    tintCondition?: TintCondition;
 }
 export interface ArrowVariant extends BaseMetricCardProps {
     variant: 'arrow';
@@ -172,6 +185,31 @@ export interface CardShellProps {
     onUpdateTimeframe?: (presetId: string) => void;
     instanceTimeframe?: string;
     cardTitle?: string;
+    /**
+     * Controlled flip state. When undefined (default), CardShell manages flip
+     * internally via useState (backward-compat — existing consumers unchanged).
+     *
+     * When provided, the parent owns the flip state. CardShell renders the
+     * derived `effectiveFlipped = isFlipped ?? internalFlipped` for both faces
+     * and does NOT mutate internal state; instead it delegates flip transitions
+     * to `onFlipChange`.
+     *
+     * Phase 4 (PaceCard): PacePlaceholder's "Set target" CTA needs a flip trigger
+     * path outside the overflow menu; controlled prop enables this without a
+     * CardShell API break for existing consumers (MetricCard, NameCard, etc.).
+     */
+    isFlipped?: boolean;
+    /**
+     * Fires on every flip transition request when `isFlipped` is controlled.
+     * Not called in uncontrolled mode (undefined isFlipped). The argument is the
+     * target flip state (`true` = back face requested, `false` = front face).
+     *
+     * When invoked from the back→front (handleFlipBack) path, the staged
+     * timeframe commit chain still fires before onFlipChange — consumers receive
+     * the updated timeframe via onUpdateTimeframe / onUpdateStackedTimeframes
+     * regardless of controlled or uncontrolled mode.
+     */
+    onFlipChange?: (flipped: boolean) => void;
     /**
      * Custom content rendered inside the flip-back face, replacing the default
      * <CardBack> timeframe preset grid. Use for consumer-specific quick-config

package/lib/primitives/dashboard/MoreInLensRail/MoreInLensRail.d.ts

@@ -0,0 +1,13 @@
+import { ReactNode } from 'react';
+/** GlossUI MoreInLensRail type contracts. No context, BFF, or dashboard-specific imports. */
+export interface MoreInLensRailProps {
+    /** e.g. "All metrics in this lens" */
+    heading: string;
+    children?: ReactNode;
+    /** Optional copy shown only when children is empty/null. Caller usually suppresses at caller level instead. */
+    emptyStateLabel?: string;
+}
+export declare function MoreInLensRail({ heading, children, emptyStateLabel }: MoreInLensRailProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace MoreInLensRail {
+    var displayName: string;
+}

package/lib/primitives/dashboard/MoreInLensRail/index.d.ts

@@ -0,0 +1,2 @@
+export { MoreInLensRail } from './MoreInLensRail';
+export type { MoreInLensRailProps } from './MoreInLensRail';

package/lib/primitives/dashboard/PaceCard/DualPaceBars/DualPaceBars.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+export type SeverityState = 'neutral' | 'good' | 'warn' | 'bad';
+export interface DualPaceBarsProps {
+    consumed: {
+        value: number;
+        label?: string;
+    };
+    elapsed: {
+        value: number;
+        label?: string;
+    };
+    /** Drives consumed bar color via BEM modifier. Defaults to 'neutral'. */
+    severity?: SeverityState;
+}
+export declare const DualPaceBars: React.FC<DualPaceBarsProps>;

package/lib/primitives/dashboard/PaceCard/DualPaceBars/index.d.ts

@@ -0,0 +1,2 @@
+export { DualPaceBars } from './DualPaceBars';
+export type { DualPaceBarsProps, SeverityState } from './DualPaceBars';

package/lib/primitives/dashboard/PaceCard/GapReadout/GapReadout.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+export type GapSeverity = 'neutral' | 'good' | 'warn' | 'bad';
+export interface GapReadoutProps {
+    label: string;
+    /** Pre-formatted value string, rendered verbatim (e.g., "+18% ahead", "−$8K over"). */
+    value: string;
+    severity: GapSeverity;
+}
+export declare const GapReadout: React.FC<GapReadoutProps>;

package/lib/primitives/dashboard/PaceCard/GapReadout/index.d.ts

@@ -0,0 +1,2 @@
+export { GapReadout } from './GapReadout';
+export type { GapReadoutProps, GapSeverity } from './GapReadout';

package/lib/primitives/dashboard/PaceCard/PaceCard.d.ts

@@ -0,0 +1,24 @@
+import { default as React } from 'react';
+export interface PaceCardProps {
+    label: string;
+    consumed: {
+        value: number;
+        label?: string;
+    };
+    elapsed: {
+        value: number;
+        label?: string;
+    };
+    target?: {
+        value?: number;
+    };
+    severity: 'neutral' | 'good' | 'warn' | 'bad';
+    /** Pre-formatted gap string from formatPaceGap (e.g. "+18% ahead"). */
+    gapLabel: string;
+    /** Unit suffix passed through to TargetInput ("%" or "$"). Default: "pct" → "%". */
+    paceGapUnit?: 'pct' | 'usd';
+    onTargetChange: (value: number) => void;
+    onTargetSkip?: () => void;
+    isStale?: boolean;
+}
+export declare const PaceCard: React.FC<PaceCardProps>;

package/lib/primitives/dashboard/PaceCard/PacePlaceholder.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+interface PacePlaceholderProps {
+    label: string;
+    onSetTarget: () => void;
+}
+export declare const PacePlaceholder: React.FC<PacePlaceholderProps>;
+export {};

package/lib/primitives/dashboard/PaceCard/PaceTilePreview.d.ts

@@ -0,0 +1,2 @@
+import { default as React } from 'react';
+export declare const PaceTilePreview: React.FC;

package/lib/primitives/dashboard/StarterRail/StarterRail.d.ts

@@ -0,0 +1,11 @@
+import { ReactNode } from 'react';
+/** GlossUI StarterRail type contracts. No context, BFF, or dashboard-specific imports. */
+export interface StarterRailProps {
+    /** D-13 pattern: "Starter set · {lens.question}" — e.g. "Starter set · Am I overbought?" */
+    heading: string;
+    children?: ReactNode;
+}
+export declare function StarterRail({ heading, children }: StarterRailProps): import("react/jsx-runtime").JSX.Element | null;
+export declare namespace StarterRail {
+    var displayName: string;
+}

package/lib/primitives/dashboard/StarterRail/index.d.ts

@@ -0,0 +1,2 @@
+export { StarterRail } from './StarterRail';
+export type { StarterRailProps } from './StarterRail';

package/lib/primitives/dashboard/index.d.ts

@@ -21,4 +21,14 @@ export * from './DragGhost';
 export * from './SnapOutline';
 export * from './CascadePreview';
 export * from './SwingReveal';
+export { PaceCard } from './PaceCard/PaceCard';
+export type { PaceCardProps } from './PaceCard/PaceCard';
+export { PaceTilePreview } from './PaceCard/PaceTilePreview';
+export { DualPaceBars } from './PaceCard/DualPaceBars';
+export type { DualPaceBarsProps, SeverityState } from './PaceCard/DualPaceBars';
+export { GapReadout } from './PaceCard/GapReadout';
+export type { GapReadoutProps, GapSeverity } from './PaceCard/GapReadout';
+export * from './LensChipGroup';
+export * from './StarterRail';
+export * from './MoreInLensRail';
 export * from './gridMotionPrimitives';

package/lib/primitives/dashboard/rows/EntityRow.d.ts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+export interface EntityRowProps {
+    lead?: React.ReactNode;
+    name: string;
+    secondary?: React.ReactNode;
+    value: React.ReactNode;
+    trail?: React.ReactNode;
+    variant?: 'leaderboard' | 'exception' | 'default';
+    onClick?: () => void;
+    className?: string;
+    /** Consumers set style={{ ['--i' as string]: rowIndex }} for stagger animation */
+    style?: React.CSSProperties;
+}
+export declare function EntityRow({ lead, name, secondary, value, trail, variant, onClick, className, style, }: EntityRowProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace EntityRow {
+    var displayName: string;
+}

package/lib/primitives/dashboard/rows/MagnitudeBar.d.ts

@@ -0,0 +1,10 @@
+export interface MagnitudeBarProps {
+    /** Fill percentage, 0-100 (clamped) */
+    fill: number;
+    variant?: 'default' | 'bottom' | 'neutral';
+    className?: string;
+}
+export declare function MagnitudeBar({ fill, variant, className }: MagnitudeBarProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace MagnitudeBar {
+    var displayName: string;
+}

package/lib/primitives/dashboard/rows/RankBadge.d.ts

@@ -0,0 +1,5 @@
+import * as React from 'react';
+export interface RankBadgeProps {
+    rank: number;
+}
+export declare const RankBadge: React.FC<RankBadgeProps>;

package/lib/primitives/dashboard/rows/RankDelta.d.ts

@@ -0,0 +1,10 @@
+export interface RankDeltaProps {
+    delta: number | 'new';
+    direction?: 'up' | 'down' | 'flat';
+    /** REQUIRED — TS-enforced */
+    'aria-label': string;
+}
+export declare function RankDelta({ delta, direction, 'aria-label': ariaLabel, }: RankDeltaProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace RankDelta {
+    var displayName: string;
+}

package/lib/primitives/dashboard/rows/SeverityDot.d.ts

@@ -0,0 +1,9 @@
+export interface SeverityDotProps {
+    severity: 'info' | 'warn' | 'critical';
+    /** REQUIRED — TS-enforced; missing prop fails tsc */
+    'aria-label': string;
+}
+export declare function SeverityDot({ severity, 'aria-label': ariaLabel }: SeverityDotProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace SeverityDot {
+    var displayName: string;
+}

package/lib/primitives/dashboard/rows/index.d.ts

@@ -0,0 +1,10 @@
+export { EntityRow } from './EntityRow';
+export type { EntityRowProps } from './EntityRow';
+export { RankBadge } from './RankBadge';
+export type { RankBadgeProps } from './RankBadge';
+export { SeverityDot } from './SeverityDot';
+export type { SeverityDotProps } from './SeverityDot';
+export { RankDelta } from './RankDelta';
+export type { RankDeltaProps } from './RankDelta';
+export { MagnitudeBar } from './MagnitudeBar';
+export type { MagnitudeBarProps } from './MagnitudeBar';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mt-gloss/ui",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "type": "module",
   "publishConfig": {
     "access": "restricted"