@mt-gloss/ui 0.1.71 → 0.1.72

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

@@ -0,0 +1,134 @@
+import { ReactNode, CSSProperties, RefObject } from 'react';
+/** Props for the CardShell wrapper component. */
+export interface CardShellProps {
+    /** Preferred slot for card content. Use this instead of children. */
+    contentSlot?: ReactNode;
+    /** @deprecated Use contentSlot instead. */
+    children?: ReactNode;
+    colSpan?: 1 | 2 | 3;
+    isStale?: boolean;
+    isRetrying?: boolean;
+    beta?: boolean;
+    disabled?: boolean;
+    style?: CSSProperties;
+    /**
+     * Optional controlled hover state (Phase 19.2 D-02 / D-03 / D-08).
+     *
+     * When provided, CardShell DOES NOT track hover internally. Grid-authoritative
+     * consumers (e.g. `MetricCardGrid` in reptime-cloud) derive hover from a
+     * single container-level `pointerover`/`pointerleave` listener and thread
+     * `hovered={id === hoveredCardId}` to each slot (D-15).
+     *
+     * When undefined (default; backward-compat), falls back to internal
+     * `useState` driven by `onMouseEnter`/`onMouseLeave`, with the legacy 180ms
+     * leave-delay REMOVED (D-08 — CSS animation handles the fade).
+     *
+     * @default undefined (uncontrolled)
+     */
+    hovered?: boolean;
+    /**
+     * When true, renders a 2px accent ring around the card shell using box-shadow
+     * (NOT border, to avoid reflow). Used to indicate config mode is active (D-09).
+     */
+    accentRing?: boolean;
+    onGraph?: () => void;
+    onDetails?: () => void;
+    onCustomize?: ((ref: RefObject<HTMLDivElement | null>) => void) | (() => void);
+    onRemove?: () => void;
+    onExpand?: () => void;
+    onShrink?: () => void;
+    onMove?: () => void;
+    onReplace?: () => void;
+    onNavigate?: () => void;
+    onRetry?: () => void;
+    onRefresh?: () => void;
+    onWhatsThis?: () => void;
+    enableQuickSettings?: boolean;
+    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
+     * panels (e.g. sparkline/status-mode toggles). When provided, fully replaces
+     * the default CardBack render. Flip mechanics (isFlipped, handleFlip,
+     * onQuickSettings wiring) are unchanged.
+     *
+     * Added FG-1 / D-01, D-02 (Phase 10.5 UAT defect sweep): eliminates
+     * sibling-peer QuickConfig mount that broke drag-ghost layout.
+     */
+    quickConfigSlot?: ReactNode;
+    onViewAsStack?: () => void;
+    onUnstack?: () => void;
+    isStackedGroup?: boolean;
+    onUpdateStackedTimeframes?: (timeframes: string[]) => void;
+    instanceStackedTimeframes?: string[];
+    isGraphActive?: boolean;
+    isTableActive?: boolean;
+    isGraphCard?: boolean;
+    canExpand?: boolean;
+    /**
+     * Horizontal anchor (px from card's left edge) forwarded to ActionStrip.
+     *
+     * When provided, overrides ActionStrip's default `left: 50%` centered pill
+     * position. Drives the per-slot gutter-slide choreography for stack cards
+     * (Cluster W quick-260417-d5z item 3 / gutter hover slide). Undefined
+     * preserves the pre-existing centered layout.
+     *
+     * @see ActionStripProps.anchorX
+     */
+    anchorX?: number;
+    /**
+     * Consumer-supplied overflow menu entries that CardShell concatenates into
+     * the ActionStrip `overflow` prop after the default set (settings / remove
+     * / replace / refresh) and before the footer `whats-this`.
+     *
+     * Per D-04 (variant ownership), gloss primitives stay reptime-agnostic:
+     * extensions like Move / Customize are constructed at the reptime
+     * consumer and passed in via this prop (usually sourced from
+     * `CARD_MENU_EXTENSIONS.getExtensions(cardType, baseOrder)` per AP-09).
+     *
+     * Phase 16 plan 16-06 Task 3 adds this prop; reptime adopts it for
+     * cardType-specific Move / Customize opt-in.
+     */
+    extensionOverflow?: import('../../../overlays/ActionStrip').OverflowAction[];
+    cardRef?: RefObject<HTMLDivElement | null>;
+    /**
+     * Quick 260422-e7e — When true, forces the action strip (gutter) to be hidden
+     * using its normal exit animation. Used by the grid to hide the strip the moment
+     * a resize gesture starts, without requiring hover state changes.
+     *
+     * Does not affect card data, content, or security boundaries — purely visual.
+     * @default false
+     */
+    forceHide?: boolean;
+    /** Phase 11.2 — resize choreography phase. Drives data-resize-phase on front-face BaseBox for B-path overlay. */
+    resizePhase?: import('../useResizeChoreography').ChoreographyPhase;
+    /** Phase 11.2 — outgoing composition snapshot (B-path). Rendered above live content during 'outgoing'; fades out on 'incoming'. */
+    outgoingSnapshot?: ReactNode;
+}

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

@@ -0,0 +1,3 @@
+export * from './shared';
+export * from './variantProps';
+export * from './cardShellProps';

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

@@ -0,0 +1,58 @@
+/** Value formatting options. */
+export interface ValueFormat {
+    prefix?: string;
+    suffix?: string;
+    abbreviated?: boolean;
+}
+/** Trend indicator data for Zone C display. */
+export interface TrendData {
+    value: number;
+    direction: 'up' | 'down' | 'flat';
+    label?: string;
+}
+/** A single segment entry for donut/segmented cards. */
+export interface SegmentEntry {
+    value: number;
+    color: string;
+    label?: string;
+}
+/** Versus comparison data for side-by-side period cards. */
+export interface VersusData {
+    current: number | string;
+    prior: number | string;
+    currentLabel?: string;
+    priorLabel?: string;
+}
+/** Card display mode — default 'time-period' is back-compat with all existing variants. */
+export type MetricCardMode = 'time-period' | 'status';
+/** Slot capacity for Status Mode width-driven rendering (Plan 02). */
+export type SlotCapacity = 1 | 3 | 5;
+/** Base props shared by all MetricCard variants. */
+export interface BaseMetricCardProps {
+    label: string;
+    value?: number | string | null;
+    valueFormat?: ValueFormat;
+    trend?: TrendData | null;
+    subtitle?: string;
+    colSpan?: 1 | 2 | 3;
+    isStale?: boolean;
+    isLoading?: boolean;
+    isError?: boolean;
+    isEmpty?: boolean;
+    /** Display mode — undefined is equivalent to 'time-period' for back-compat. */
+    mode?: MetricCardMode;
+    /**
+     * Phase 15 — threshold visual breach treatment (D-06).
+     * 'warn'     → amber border tint + WarningIcon (NEVER color-only, D-28)
+     * 'critical' → red border tint + CriticalIcon + pulse animation
+     * 'none'     → no treatment (default)
+     */
+    thresholdBreach?: 'none' | 'warn' | 'critical';
+}
+/** A single status slot entry for Status Mode cards (Phase 10). */
+export interface StatusEntry {
+    id: string;
+    label: string;
+    value: number | string;
+    accentColor?: string;
+}

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

@@ -0,0 +1,81 @@
+import { TintCondition } from '../tintCondition';
+import { BaseMetricCardProps, SlotCapacity, StatusEntry, VersusData, SegmentEntry } from './shared';
+export interface StandardVariant extends BaseMetricCardProps {
+    variant: 'standard';
+}
+export interface SparklineVariant extends BaseMetricCardProps {
+    variant: 'sparkline';
+    sparklineData: number[];
+    accentColor?: string;
+}
+export interface BarsVariant extends BaseMetricCardProps {
+    variant: 'bars';
+    barData: number[];
+    accentColor?: string;
+}
+export interface DonutVariant extends BaseMetricCardProps {
+    variant: 'donut';
+    donutValue: number;
+    donutMax?: number;
+    accentColor?: string;
+}
+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';
+    arrowDirection: 'up' | 'down';
+    arrowShape?: 'chevron' | 'triple' | 'bars';
+}
+export interface ObjectArrowVariant extends BaseMetricCardProps {
+    variant: 'object-arrow';
+    objectArrowValue: number;
+    objectArrowMax: number;
+}
+export interface VersusVariant extends BaseMetricCardProps {
+    variant: 'versus';
+    versusData: VersusData;
+}
+export interface SegmentedVariant extends BaseMetricCardProps {
+    variant: 'segmented';
+    segments: SegmentEntry[];
+}
+/** Status Mode variant — flag-gated; renders status slots instead of time-period value. */
+export interface StatusModeVariant extends BaseMetricCardProps {
+    variant: 'status-mode';
+    statuses: ReadonlyArray<StatusEntry>;
+    activeStatusId?: string;
+    /** Per-status sparkline data keyed by status.id (Plan 02). */
+    sparklinePerStatus?: Record<string, ReadonlyArray<number>>;
+    /** Override computed slot capacity — test hook / opt-out (Plan 02). */
+    maxSlots?: SlotCapacity;
+    /**
+     * Called when a status slot is clicked (Plan 04 — chip-menu wiring).
+     * statusId: the clicked slot's status id.
+     * anchorEl: the slot DOM element — used to anchor the chip menu.
+     */
+    onStatusSlotClick?: (statusId: string, anchorEl: HTMLElement) => void;
+}
+/** Discriminated union of all MetricCard variant props. */
+export type MetricCardProps = StandardVariant | SparklineVariant | BarsVariant | DonutVariant | HighlightVariant | ArrowVariant | ObjectArrowVariant | VersusVariant | SegmentedVariant | StatusModeVariant;
+/**
+ * All card type identifiers for type-guard compatibility.
+ * The 9 renderable variants (standard through segmented) map to MetricCardProps discriminated union.
+ * The 4 additional types (name, ratio, action, stacked-group) are handled by separate
+ * dashboard-specific components (NameCard, RatioCard, ErrorCard, StackedGroupCard).
+ * INTEG-10: 'action' variant rendering is intentionally out of scope -- ErrorCard handles it.
+ */
+export type MetricCardType = 'standard' | 'sparkline' | 'bars' | 'donut' | 'highlight' | 'arrow' | 'object-arrow' | 'versus' | 'segmented' | 'name' | 'ratio' | 'action' | 'stacked-group';

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

@@ -1,272 +1,8 @@
-import { ReactNode, CSSProperties, RefObject } from 'react';
-import { TintCondition } from './tintCondition';
-/** Value formatting options. */
-export interface ValueFormat {
-    prefix?: string;
-    suffix?: string;
-    abbreviated?: boolean;
-}
-/** Trend indicator data for Zone C display. */
-export interface TrendData {
-    value: number;
-    direction: 'up' | 'down' | 'flat';
-    label?: string;
-}
-/** A single segment entry for donut/segmented cards. */
-export interface SegmentEntry {
-    value: number;
-    color: string;
-    label?: string;
-}
-/** Versus comparison data for side-by-side period cards. */
-export interface VersusData {
-    current: number | string;
-    prior: number | string;
-    currentLabel?: string;
-    priorLabel?: string;
-}
-/** Card display mode — default 'time-period' is back-compat with all existing variants. */
-export type MetricCardMode = 'time-period' | 'status';
-/** Slot capacity for Status Mode width-driven rendering (Plan 02). */
-export type SlotCapacity = 1 | 3 | 5;
-/** Base props shared by all MetricCard variants. */
-export interface BaseMetricCardProps {
-    label: string;
-    value?: number | string | null;
-    valueFormat?: ValueFormat;
-    trend?: TrendData | null;
-    subtitle?: string;
-    colSpan?: 1 | 2 | 3;
-    isStale?: boolean;
-    isLoading?: boolean;
-    isError?: boolean;
-    isEmpty?: boolean;
-    /** Display mode — undefined is equivalent to 'time-period' for back-compat. */
-    mode?: MetricCardMode;
-    /**
-     * Phase 15 — threshold visual breach treatment (D-06).
-     * 'warn'     → amber border tint + WarningIcon (NEVER color-only, D-28)
-     * 'critical' → red border tint + CriticalIcon + pulse animation
-     * 'none'     → no treatment (default)
-     */
-    thresholdBreach?: 'none' | 'warn' | 'critical';
-}
-export interface StandardVariant extends BaseMetricCardProps {
-    variant: 'standard';
-}
-export interface SparklineVariant extends BaseMetricCardProps {
-    variant: 'sparkline';
-    sparklineData: number[];
-    accentColor?: string;
-}
-export interface BarsVariant extends BaseMetricCardProps {
-    variant: 'bars';
-    barData: number[];
-    accentColor?: string;
-}
-export interface DonutVariant extends BaseMetricCardProps {
-    variant: 'donut';
-    donutValue: number;
-    donutMax?: number;
-    accentColor?: string;
-}
-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';
-    arrowDirection: 'up' | 'down';
-    arrowShape?: 'chevron' | 'triple' | 'bars';
-}
-export interface ObjectArrowVariant extends BaseMetricCardProps {
-    variant: 'object-arrow';
-    objectArrowValue: number;
-    objectArrowMax: number;
-}
-export interface VersusVariant extends BaseMetricCardProps {
-    variant: 'versus';
-    versusData: VersusData;
-}
-export interface SegmentedVariant extends BaseMetricCardProps {
-    variant: 'segmented';
-    segments: SegmentEntry[];
-}
-/** A single status slot entry for Status Mode cards (Phase 10). */
-export interface StatusEntry {
-    id: string;
-    label: string;
-    value: number | string;
-    accentColor?: string;
-}
-/** Status Mode variant — flag-gated; renders status slots instead of time-period value. */
-export interface StatusModeVariant extends BaseMetricCardProps {
-    variant: 'status-mode';
-    statuses: ReadonlyArray<StatusEntry>;
-    activeStatusId?: string;
-    /** Per-status sparkline data keyed by status.id (Plan 02). */
-    sparklinePerStatus?: Record<string, ReadonlyArray<number>>;
-    /** Override computed slot capacity — test hook / opt-out (Plan 02). */
-    maxSlots?: SlotCapacity;
-    /**
-     * Called when a status slot is clicked (Plan 04 — chip-menu wiring).
-     * statusId: the clicked slot's status id.
-     * anchorEl: the slot DOM element — used to anchor the chip menu.
-     */
-    onStatusSlotClick?: (statusId: string, anchorEl: HTMLElement) => void;
-}
-/** Discriminated union of all MetricCard variant props. */
-export type MetricCardProps = StandardVariant | SparklineVariant | BarsVariant | DonutVariant | HighlightVariant | ArrowVariant | ObjectArrowVariant | VersusVariant | SegmentedVariant | StatusModeVariant;
 /**
- * All card type identifiers for type-guard compatibility.
- * The 9 renderable variants (standard through segmented) map to MetricCardProps discriminated union.
- * The 4 additional types (name, ratio, action, stacked-group) are handled by separate
- * dashboard-specific components (NameCard, RatioCard, ErrorCard, StackedGroupCard).
- * INTEG-10: 'action' variant rendering is intentionally out of scope -- ErrorCard handles it.
+ * GlossUI MetricCard type contracts.
+ *
+ * Split into domain files under types/ — this file is a barrel for back-compat.
+ * Import from './types/shared', './types/variantProps', or './types/cardShellProps' directly
+ * when you only need one domain.
  */
-export type MetricCardType = 'standard' | 'sparkline' | 'bars' | 'donut' | 'highlight' | 'arrow' | 'object-arrow' | 'versus' | 'segmented' | 'name' | 'ratio' | 'action' | 'stacked-group';
-/** Props for the CardShell wrapper component. */
-export interface CardShellProps {
-    /** Preferred slot for card content. Use this instead of children. */
-    contentSlot?: ReactNode;
-    /** @deprecated Use contentSlot instead. */
-    children?: ReactNode;
-    colSpan?: 1 | 2 | 3;
-    isStale?: boolean;
-    isRetrying?: boolean;
-    beta?: boolean;
-    disabled?: boolean;
-    style?: CSSProperties;
-    /**
-     * Optional controlled hover state (Phase 19.2 D-02 / D-03 / D-08).
-     *
-     * When provided, CardShell DOES NOT track hover internally. Grid-authoritative
-     * consumers (e.g. `MetricCardGrid` in reptime-cloud) derive hover from a
-     * single container-level `pointerover`/`pointerleave` listener and thread
-     * `hovered={id === hoveredCardId}` to each slot (D-15).
-     *
-     * When undefined (default; backward-compat), falls back to internal
-     * `useState` driven by `onMouseEnter`/`onMouseLeave`, with the legacy 180ms
-     * leave-delay REMOVED (D-08 — CSS animation handles the fade).
-     *
-     * @default undefined (uncontrolled)
-     */
-    hovered?: boolean;
-    /**
-     * When true, renders a 2px accent ring around the card shell using box-shadow
-     * (NOT border, to avoid reflow). Used to indicate config mode is active (D-09).
-     */
-    accentRing?: boolean;
-    onGraph?: () => void;
-    onDetails?: () => void;
-    onCustomize?: ((ref: RefObject<HTMLDivElement | null>) => void) | (() => void);
-    onRemove?: () => void;
-    onExpand?: () => void;
-    onShrink?: () => void;
-    onMove?: () => void;
-    onReplace?: () => void;
-    onNavigate?: () => void;
-    onRetry?: () => void;
-    onRefresh?: () => void;
-    onWhatsThis?: () => void;
-    enableQuickSettings?: boolean;
-    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
-     * panels (e.g. sparkline/status-mode toggles). When provided, fully replaces
-     * the default CardBack render. Flip mechanics (isFlipped, handleFlip,
-     * onQuickSettings wiring) are unchanged.
-     *
-     * Added FG-1 / D-01, D-02 (Phase 10.5 UAT defect sweep): eliminates
-     * sibling-peer QuickConfig mount that broke drag-ghost layout.
-     */
-    quickConfigSlot?: ReactNode;
-    onViewAsStack?: () => void;
-    onUnstack?: () => void;
-    isStackedGroup?: boolean;
-    onUpdateStackedTimeframes?: (timeframes: string[]) => void;
-    instanceStackedTimeframes?: string[];
-    isGraphActive?: boolean;
-    isTableActive?: boolean;
-    isGraphCard?: boolean;
-    canExpand?: boolean;
-    /**
-     * Horizontal anchor (px from card's left edge) forwarded to ActionStrip.
-     *
-     * When provided, overrides ActionStrip's default `left: 50%` centered pill
-     * position. Drives the per-slot gutter-slide choreography for stack cards
-     * (Cluster W quick-260417-d5z item 3 / gutter hover slide). Undefined
-     * preserves the pre-existing centered layout.
-     *
-     * @see ActionStripProps.anchorX
-     */
-    anchorX?: number;
-    /**
-     * Consumer-supplied overflow menu entries that CardShell concatenates into
-     * the ActionStrip `overflow` prop after the default set (settings / remove
-     * / replace / refresh) and before the footer `whats-this`.
-     *
-     * Per D-04 (variant ownership), gloss primitives stay reptime-agnostic:
-     * extensions like Move / Customize are constructed at the reptime
-     * consumer and passed in via this prop (usually sourced from
-     * `CARD_MENU_EXTENSIONS.getExtensions(cardType, baseOrder)` per AP-09).
-     *
-     * Phase 16 plan 16-06 Task 3 adds this prop; reptime adopts it for
-     * cardType-specific Move / Customize opt-in.
-     */
-    extensionOverflow?: import('../../overlays/ActionStrip').OverflowAction[];
-    cardRef?: RefObject<HTMLDivElement | null>;
-    /**
-     * Quick 260422-e7e — When true, forces the action strip (gutter) to be hidden
-     * using its normal exit animation. Used by the grid to hide the strip the moment
-     * a resize gesture starts, without requiring hover state changes.
-     *
-     * Does not affect card data, content, or security boundaries — purely visual.
-     * @default false
-     */
-    forceHide?: boolean;
-    /** Phase 11.2 — resize choreography phase. Drives data-resize-phase on front-face BaseBox for B-path overlay. */
-    resizePhase?: import('./useResizeChoreography').ChoreographyPhase;
-    /** Phase 11.2 — outgoing composition snapshot (B-path). Rendered above live content during 'outgoing'; fades out on 'incoming'. */
-    outgoingSnapshot?: React.ReactNode;
-}
+export * from './types/index';

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

@@ -50,20 +50,6 @@ export interface UseEdgeHoverResizeArgs {
      * section boundary.
      */
     maxColSpan?: 1 | 2 | 3;
-    /**
-     * @deprecated since Phase 19.2 — superseded by `forceIdle`; retained for
-     * consumer-side compat until Phase 19.2 cutover ships. The window-level
-     * pointermove self-heal ("Polish Fix #7") that used this ref has been
-     * removed (D-04 ¶2). New code should pass `forceIdle` instead.
-     *
-     * Historical note: When provided, the hook installed a window-level
-     * pointermove listener during 'dwelling' and 'handle-visible' states to
-     * detect the cursor leaving `containerRef.current`. This was fragile under
-     * cross-card sweeps — grid-driven `forceIdle` is the correct pattern.
-     */
-    containerRef?: React.RefObject<Element | null> | {
-        current: Element | null;
-    };
     /**
      * Phase 19.2 D-04 — grid-driven synchronous idle reset.
      *
@@ -141,4 +127,4 @@ export interface UseEdgeHoverResizeReturn {
  *  - Bug E handle pointerenter keeps zone alive on sentinel→handle crossover
  *  - Dwell timer cleanup on unmount
  */
-export declare function useEdgeHoverResize({ currentColSpan, stackable, onResize, onCancel, step, gap, tuning, dwellMs, graceExitMs, enterMs, exitMs, maxColSpan, containerRef, forceIdle, }: UseEdgeHoverResizeArgs): UseEdgeHoverResizeReturn;
+export declare function useEdgeHoverResize({ currentColSpan, stackable, onResize, onCancel, step, gap, tuning, dwellMs, graceExitMs, enterMs, exitMs, maxColSpan, forceIdle, }: UseEdgeHoverResizeArgs): UseEdgeHoverResizeReturn;

package/package.json

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