@mt-gloss/ui 0.1.48 → 0.1.50

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/CascadePreview/CascadePreview.d.ts

@@ -16,6 +16,20 @@ export interface CascadePreviewItem {
     /** Static layout in CSS px. NOT MotionValue — Phase 10 does not animate dimensions (Track C/Phase 11). Consumer formula: width = (cell.colSpan ?? 1) * colWidth, height = (cell.rowSpan ?? 1) * rowHeight. */
     width: number;
     height: number;
+    /**
+     * Static base position of the card's anchor cell in the grid, in CSS px.
+     * Applied as `left`/`top` on the `position: absolute` wrapper so that the
+     * MotionValue `x`/`y` carry only the displacement delta (not an absolute
+     * coordinate). Formula: left = cell.col * (colWidth + gap), top = cell.row *
+     * (rowHeight + gap).
+     *
+     * Bug fix (drag-insert-ghost-clone-row1): without a base position the
+     * motion.div anchors at (0,0) — the top-left of the grid — and the delta MV
+     * translates it by only one column width, making the displaced card appear in
+     * row 1 regardless of its real row.
+     */
+    left: number;
+    top: number;
 }
 export interface CascadePreviewProps {
     items: CascadePreviewItem[];
@@ -46,6 +60,8 @@ export interface CascadePreviewProps {
  *   - `key={item.cardId}` — React reconciliation stability (DRAG-09)
  *   - `data-card-id={item.cardId}` — test hook + attribute-selector targeting
  *   - `style.x = item.x`, `style.y = item.y` — framer-motion reads MVs directly
+ *   - `style.left = item.left`, `style.top = item.top` — static base position
+ *     of the card's anchor cell; the MotionValue x/y carry displacement delta only
  *   - `aria-hidden="true"` — displaced cards are visually cloned during preview;
  *     the semantic source card retains focus/aria surface
  *   - `pointer-events: none` + `will-change: transform` via SCSS

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.50",
   "type": "module",
   "publishConfig": {
     "access": "restricted"