@mt-gloss/ui 0.1.22 → 0.1.24

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

@@ -20,6 +20,15 @@ export interface EdgeHoverHandleProps {
     edge?: 'right';
     /** D-16 — keyboard step handler (ArrowLeft → 'shrink', ArrowRight → 'grow'). */
     onKeyboardStep?: (direction: ResizeDirection) => void;
+    /**
+     * Quick 260422-gfr — fires when the browser implicitly releases pointer
+     * capture from the <button> (window blur / Alt-Tab / modal focus steal /
+     * touchcancel). Consumers wire this to the hook's `cancel()` so the gesture
+     * deterministically exits `'dragging'` on capture loss. Companion to the
+     * window-level blur / visibilitychange / pointercancel listeners installed
+     * inside useEdgeHoverResize. See .planning/debug/resize-state-leak-cross-card.md.
+     */
+    onLostPointerCapture?: (e: React.PointerEvent) => void;
     ariaLabel?: 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';

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

@@ -25,6 +25,17 @@ export declare class VelocityBuffer {
     private readonly capacity;
     push(sample: VelocitySample): void;
     clear(): void;
+    /**
+     * Quick 260422-gfr — last-known-position accessor for the window-level
+     * terminateDrag fallback in useEdgeHoverResize. When pointer capture is
+     * silently lost (Alt-Tab / blur / visibilitychange hidden), the React
+     * onPointerUp does not fire, so the window-level fallback needs the last
+     * pointer x-coordinate to compute `dx` for commitSpring. The most recent
+     * sample is the authoritative answer (pointermove pushes on every event).
+     *
+     * Returns `null` when the buffer is empty (no drag ever started).
+     */
+    tail(): VelocitySample | null;
     /**
      * D-09 — weighted-average velocity (px/sec).
      *

package/package.json

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