@mt-gloss/ui 0.1.48 → 0.1.49

package/lib/composites/dashboard/BottomToolbar/SectionDots.d.ts

@@ -18,7 +18,10 @@
  */
 export interface SectionDotsProps {
     count: number;
-    currentIndex: number;
+    /**
+     * @deprecated Phase 12 D-09 — prefer `currentSection`. Kept optional for v2.0 back-compat callers.
+     */
+    currentIndex?: number;
     onSelect: (index: number) => void;
     'aria-label'?: string;
     /** Phase 4 D-09 — index of the unconfirmed ("provisional") section, if any. */
@@ -32,5 +35,4 @@ export interface SectionDotsProps {
     /** Phase 12 D-09 — how many sections fit in viewport at once. Default 1 (preserves v2.0 model). */
     sectionsPerView?: number;
 }
-export declare function SectionDots({ count, currentIndex, onSelect, 'aria-label': ariaLabel, provisionalIndex, pulseIndex, pulseNonce, currentSection, // D-08 back-compat shim
-sectionsPerView, }: SectionDotsProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function SectionDots({ count, currentIndex, onSelect, 'aria-label': ariaLabel, provisionalIndex, pulseIndex, pulseNonce, currentSection, sectionsPerView, }: SectionDotsProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,57 @@
+import { UseEdgeHoverResizeReturn } from './useEdgeHoverResize';
+import { CellTintVariant } from '../CellTintOverlay';
+type Cell = {
+    section: 0 | 1 | 2 | 3;
+    col: 0 | 1 | 2;
+    row: 0 | 1 | 2;
+};
+export interface UseResizeChoreographyArgs {
+    /** Pass-through of useEdgeHoverResize return — never mutated. D-03. */
+    edgeHover: UseEdgeHoverResizeReturn & {
+        /** D-04 — locked lifecycle states. The base hook today exposes the legacy
+         *  ResizeState union; consumer-side adapters can also pass the canonical
+         *  4-state lifecycle. The hook treats {idle, settling, cancelled} as
+         *  null-output and {arming, dwelling, handle-visible, dragging, active}
+         *  as channel-emitting states. */
+        state: string;
+        /** Live preview colSpan as a float OR integer. Required for ramp lerp;
+         *  numbers between integers drive the ramp toward commit. */
+        previewColSpan: number;
+        /** Hysteresis-snapped target colSpan (D-07). Drives outline / tints / shrink. */
+        hysteresisTargetColSpan: 1 | 2 | 3;
+        /** Card's current colSpan (pre-resize baseline). */
+        currentColSpan: 1 | 2 | 3;
+        /** Direction discriminator. */
+        direction: string;
+    };
+    sourceCell: Cell;
+    activeSection: 0 | 1 | 2 | 3;
+    /** Cascade result for current preview colSpan — passed in from reptime reducer
+     *  state. Hook is reducer-agnostic per D-03 + RESEARCH §Open Question 2. */
+    cascadeResult: {
+        result: 'ok' | 'rejected';
+        reason?: 'spans-sections' | 'section-full' | 'spillover-blocked' | 'occupied-target' | string;
+    } | null;
+    colWidth: number;
+    rowHeight: number;
+    gap: number;
+}
+export interface UseResizeChoreographyReturn {
+    trackingOutline: {
+        cell: Cell;
+        colSpan: 1 | 2 | 3;
+        pattern: 'solid' | 'dashed-retreated';
+    } | null;
+    cellTints: Array<{
+        cell: Cell;
+        variant: CellTintVariant;
+        rampColor?: string;
+    }>;
+    refusePulse: {
+        cell: Cell;
+        fireKey: number;
+    } | null;
+    shrinkFreedCells: Cell[];
+}
+export declare function useResizeChoreography(args: UseResizeChoreographyArgs): UseResizeChoreographyReturn;
+export {};

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

@@ -44,3 +44,4 @@ export * from './TrackingOutline';
 export * from './CellTintOverlay';
 export * from './RefusePulse';
 export { ResizeTrackingOutline, type ResizeTrackingOutlineProps, } from './ResizeTrackingOutline';
+export { useResizeChoreography, type UseResizeChoreographyArgs, type UseResizeChoreographyReturn, } from './MetricCard/useResizeChoreography';

package/package.json

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