@mt-gloss/ui 0.0.20 → 0.0.21

package/lib/composites/controls/ThresholdRamp/ThresholdRamp.d.ts

@@ -11,6 +11,15 @@ export interface ThresholdRampProps {
     onChange: (stops: ThresholdStop[]) => void;
     min?: number;
     max?: number;
+    /**
+     * Snap granularity for both drag and keyboard interactions. Values are
+     * rounded to `Math.round(raw / step) * step`. Default `0.01` matches the
+     * historical 2-decimal behavior. Pass `1` for integer snap, `0.0001` for
+     * 4-decimal snap, etc. Matches the `step` prop on `<Slider>` / `<RangeSlider>`.
+     * Must be a positive finite number; invalid values fall back to 0.01 with
+     * a dev-mode warning.
+     */
+    step?: number;
     disabled?: boolean;
 }
 /**
@@ -18,7 +27,7 @@ export interface ThresholdRampProps {
  * Renders a token-driven gradient strip with draggable stop handles.
  * Generic — no reptime domain strings. D-01, D-10, D-11 compliant.
  */
-export declare function ThresholdRamp({ stops, onChange, min, max, disabled, }: ThresholdRampProps): import("react/jsx-runtime").JSX.Element;
+export declare function ThresholdRamp({ stops, onChange, min, max, step, disabled, }: ThresholdRampProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace ThresholdRamp {
     var displayName: string;
 }

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

@@ -38,6 +38,29 @@ export interface GutterActionsProps {
     onConfigSave?: () => void;
     /** Called when Cancel pill is clicked in config variant. */
     onConfigCancel?: () => void;
+    /**
+     * Cluster C (quick-260417-ago) — Singleton overflow-menu identifier.
+     *
+     * When provided, this GutterActions instance cooperates with
+     * `overflowMenuRegistry` so only one overflow menu across the whole
+     * dashboard may be open at a time. Opening menu N sets the registry's
+     * activeId to N; any OTHER instance sees active !== its own id and closes
+     * its menu automatically via onMenuToggle(false).
+     *
+     * If omitted, a useId() fallback is used so each instance still gets a
+     * unique registry key — the singleton behavior still works across cards.
+     */
+    menuId?: string;
+    /**
+     * Cluster D (quick-260417-ago) — Horizontal anchor offset in px from the
+     * card's left edge. When provided, overrides the pill's default
+     * `left: 50%` centered position; drives the per-slot gutter-slide
+     * choreography (180ms ease-out) for stack cards whose hovered slot moves
+     * horizontally.
+     *
+     * Undefined (default) preserves the pre-existing centered layout.
+     */
+    anchorX?: number;
 }
 /**
  * GutterActions - Pill + overflow menu interaction system.
@@ -61,6 +84,6 @@ export interface GutterActionsProps {
  * ```
  */
 export declare const GutterActions: {
-    ({ visible, menuOpen, onMenuToggle, onGraph, onDetails, onCustomize, onRemove, onWhatsThis, onExpand, onShrink, onMove, onReplace, onNavigate, onRetry, onRefresh, onQuickSettings, onFlipBack, isFlipped, onViewAsStack, onUnstack, canExpand, isGraphCard, colSpan, isGraphActive, isTableActive, graphLabel, detailsLabel, variant, onConfigSave, onConfigCancel, }: GutterActionsProps): import("react/jsx-runtime").JSX.Element;
+    ({ visible, menuOpen, onMenuToggle, onGraph, onDetails, onCustomize, onRemove, onWhatsThis, onExpand, onShrink, onMove, onReplace, onNavigate, onRetry, onRefresh, onQuickSettings, onFlipBack, isFlipped, onViewAsStack, onUnstack, canExpand, isGraphCard, colSpan, isGraphActive, isTableActive, graphLabel, detailsLabel, variant, onConfigSave, onConfigCancel, menuId, anchorX, }: GutterActionsProps): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };

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

@@ -25,6 +25,25 @@ export interface StackedGroupCardProps {
      * Default: undefined (fall back to measured capacity; backward compatible).
      */
     colSpan?: 1 | 2 | 3;
+    /**
+     * Cluster D (quick-260417-ago, item 3) — fired when the pointer enters
+     * slot `idx` with its `timeframe`. Consumer uses this to drive the
+     * gutter-actions horizontal anchor (anchorX) and inject metric-scoped
+     * action handlers (e.g. Transmitted → open transmitted-orders tab).
+     * Optional; no-op if omitted (back-compat).
+     */
+    onSlotHoverStart?: (idx: number, timeframe: string) => void;
+    /** Cluster D — fired when the pointer leaves the currently hovered slot. */
+    onSlotHoverEnd?: () => void;
+    /**
+     * Cluster D (item 15) — sparkline edge behavior.
+     *   'padded' (default, back-compat): current behavior; SparklineBg sits
+     *     within the CardShell's inner padding.
+     *   'bleed': SparklineBg is wrapped in a negative-margin container so it
+     *     extends to the card's LEFT, TOP, and BOTTOM edges. Right edge keeps
+     *     padding so trend text on the right does not collide with the stroke.
+     */
+    sparklineInset?: 'padded' | 'bleed';
 }
 /**
  * StackedGroupCard -- Renders 3 mini metric values horizontally within a 2-col card.
@@ -47,6 +66,6 @@ export interface StackedGroupCardProps {
  * ```
  */
 export declare const StackedGroupCard: {
-    ({ title, prefix, suffix, values, timeframes, sparklineData, accentColor, pinnedTimeframe, onPinTimeframe, isStale, colSpan, }: StackedGroupCardProps): import("react/jsx-runtime").JSX.Element;
+    ({ title, prefix, suffix, values, timeframes, sparklineData, accentColor, pinnedTimeframe, onPinTimeframe, isStale, colSpan, onSlotHoverStart, onSlotHoverEnd, sparklineInset, }: StackedGroupCardProps): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };

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

@@ -0,0 +1,25 @@
+/**
+ * overflowMenuRegistry — Module-scoped singleton tracker for MetricCard overflow menus.
+ *
+ * quick-260417-ago Cluster C (item 14): only one overflow menu may be open at a time.
+ * When menu B opens, menu A receives a notification via its useSyncExternalStore
+ * subscription and closes itself.
+ *
+ * Uses a plain module-level `activeId` + Set<listener> — no new dep (Zustand is
+ * over-engineering for one state field; Context would require hoisting the
+ * provider higher than the card tree, which complicates flag-off paths).
+ *
+ * React 19's useSyncExternalStore consumes `subscribe` / `getSnapshot` and keeps
+ * components in sync without triggering tearing under concurrent rendering.
+ *
+ * Exports:
+ *   - subscribe(fn): listen to activeId changes; returns unsubscribe
+ *   - getActive(): current activeId (or null)
+ *   - setActive(id | null): declare which menu is open; notifies all subscribers
+ *   - resetForTests(): clears state between vitest runs
+ */
+export declare function subscribe(listener: () => void): () => void;
+export declare function getActive(): string | null;
+export declare function setActive(next: string | null): void;
+/** Test-only: resets internal state. Not exported from the public barrel. */
+export declare function resetForTests(): void;

package/package.json

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